NAME

       psmshell - PSM memory management test shell

SYNOPSIS

       psmshell partition_size

DESCRIPTION

       psmshell allocates a region of partition_size bytes of system memory, places it under PSM management, and
       offers the user an interactive "shell" for testing various PSM management functions.

       psmshell prints a prompt string (": ") to stdout, accepts a command from stdin, executes the command
       (possibly printing a diagnostic message), then prints another prompt string and so on.

       The locations of objects allocated from the PSM-managed region of memory are referred to as "cells" in
       psmshell operations.  That is, when an object is to be allocated, a cell number in the range 0-99 must be
       specified as the notional "handle" for that object, for use in future commands.

       The following commands are supported:

       h   The help command.  Causes psmshell to print a summary of available commands.  Same effect as the ?
           command.

       ?   Another help command.  Causes psmshell to print a summary of available commands.  Same effect as the
           h command.

       m cell_nbr size
           The malloc command.  Allocates a large-pool object of the indicated size and associates that object
           with cell_nbr.

       z cell_nbr size
           The zalloc command.  Allocates a small-pool object of the indicated size and associates that object
           with cell_nbr.

       p cell_nbr
           The print command.  Prints the address (i.e., the offset within the managed block of memory) of the
           object associated with cell_nbr.

       f cell_nbr
           The free command.  Frees the object associated with cell_nbr, returning the space formerly occupied
           by that object to the appropriate free block list.

       u   The usage command.  Prints a partition usage report, as per psm_report(3).

       q   The quit command.  Frees the allocated system memory in the managed block and terminates psmshell.

EXIT STATUS

       "0" psmshell has terminated.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       IPC initialization failed.
           ION system error.  Investigate, correct problem, and try again.

       psmshell: can't allocate space; quitting.
           Insufficient available system memory for selected partition size.

       psmshell: can't allocate test variables; quitting.
           Insufficient available system memory for selected partition size.

BUGS

       Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

SEE ALSO

       psm(3)