xenial (1) smlistsh.1.gz

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)