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)