psmshell(1) [debian man page]
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)
Check Out this Related Man Page
SMLISTSH(1) ICI executables SMLISTSH(1) NAME
smlistsh - shared-memory linked list test shell SYNOPSIS
smlistsh partition_size DESCRIPTION
smlistsh attaches to a region of system memory (allocating it if necessary, and placing it under PSM management as necessary) and offers the user an interactive "shell" for testing various shared-memory linked list management functions. smlistsh 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 following commands are supported: h The help command. Causes smlistsh to print a summary of available commands. Same effect as the ? command. ? Another help command. Causes smlistsh to print a summary of available commands. Same effect as the h command. k The key command. Computes and prints an unused shared-memory key, for possible use in attaching to a shared-memory region. + key_value size The attach command. Attaches smlistsh to a region of shared memory. key_value identifies an existing shared-memory region, in the event that you want to attach to an existing shared-memory region (possibly created by another smlistsh process running on the same computer). To create and attach to a new shared-memory region that other processes can attach to, use a key_value as returned by the key command and supply the size of the new region. If you want to create and attach to a new shared-memory region that is for strictly private use, use -1 as key and supply the size of the new region. - The detach command. Detaches smlistsh from the region of shared memory it is currently using, but does not free any memory. n The new command. Creates a new shared-memory list to operate on, within the currently attached shared-memory region. Prints the address of the list. s list_address The share command. Selects an existing shared-memory list to operate on, within the currently attached shared-memory region. a element_value The append command. Appends a new list element, containing element_value, to the list on which smlistsh is currently operating. p element_value The prepend command. Prepends a new list element, containing element_value, to the list on which smlistsh is currently operating. w The walk command. Prints the addresses and contents of all elements of the list on which smlistsh is currently operating. f element_value The find command. Finds the list element that contains element_value, within the list on which smlistsh is currently operating, and prints the address of that list element. d element_address The delete command. Deletes the list element located at element_address. r The report command. Prints a partition usage report, as per psm_report(3). q The quit command. Detaches smlistsh from the region of shared memory it is currently using (without freeing any memory) and terminates smlistsh. EXIT STATUS
0 smlistsh has terminated. FILES
No configuration files are needed. ENVIRONMENT
No environment variables apply. DIAGNOSTICS
No diagnostics apply. BUGS
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu> SEE ALSO
smlist(3) perl v5.14.2 2012-05-25 SMLISTSH(1)