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)
