PSMSHELL(1)							  ICI executables						       PSMSHELL(1)

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)

perl v5.14.2							    2012-05-25							       PSMSHELL(1)