Stm-admin: Difference between revisions

From PMFLib Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 2: Line 2:
Navigation: [[Documentation]] / [[Utilities]] / [[stm-admin]]
Navigation: [[Documentation]] / [[Utilities]] / [[stm-admin]]
----
----
<div style="text-align: center">stm-admin: version 6.380.1d87074 (2021-07-26 16:36)</div>'''Name'''
<div style="text-align: center">stm-admin: version 6.1090.a7cf688 (2026-06-18 21:15)</div>'''Name'''


<span style="margin-left: 15px;">stm-admin</span>
<span style="margin-left: 15px;">stm-admin</span>
Line 18: Line 18:
{| style="margin-left: 2em; width: 95%;"
{| style="margin-left: 2em; width: 95%;"
|- style="vertical-align: top; background-color: #e6e6e6;"
|- style="vertical-align: top; background-color: #e6e6e6;"
| <span style="color: purple;">stm://server[:port]/command</span><br/><div style="margin-left: 30px;">It provides the action specification. The server is either the DNS name or IP address of the server or word 'serverkey' or 'key'. In the later case, the information about the server is read from the server key file. The port number, on which the server is listen, may be optionally provided. Finally, the command is administration task, which can be one of the following:<br />info                    = print information about registered clients<br />flush                  = save the accumulated STM path on the server side<br />get?file=output.path    = get the accumulated STM path and save it locally to the file output.path <br />release?id=bead_id      = unregister a client bound to the bead<br />terminate              = terminate server at the end of STM cycle<br />shutdown                = stop server execution<br />errors                  = prints errors from the server stack</div>
| <span style="color: purple;">stm://server[:port]/command</span><br/><div style="margin-left: 30px;">The server can be specified as either the DNS name, the IP address of the server, or the keyword 'serverkey' or 'key'. In the latter case, the server information is read from the server key file. The listening port number can be optionally provided. Finally, the command specifies an administrative task, which can be one of the following: <br />info                    = display information about registered clients<br />flush                  = save the accumulated STM path on the server side<br />get?file=output.path    = retrieve the accumulated STM path and save it locally to the file 'output.path'<br />release?id=bead_id      = unregister a client associated with the specified bead ID<br />terminate              = terminate the server at the end of the STM cycle<br />shutdown                = stop the server execution<br />errors                  = display errors from the server stack</div>
|}
|}



Latest revision as of 11:50, 19 June 2026

Navigation: Documentation / Utilities / stm-admin


stm-admin: version 6.1090.a7cf688 (2026-06-18 21:15)

Name

stm-admin

Synopsis

stm-admin [OPTIONS] [--] stm://server[:port]/command

Description

The utility that controls the behaviour and state of the server implementing the string method.

Arguments

stm://server[:port]/command
The server can be specified as either the DNS name, the IP address of the server, or the keyword 'serverkey' or 'key'. In the latter case, the server information is read from the server key file. The listening port number can be optionally provided. Finally, the command specifies an administrative task, which can be one of the following:
info = display information about registered clients
flush = save the accumulated STM path on the server side
get?file=output.path = retrieve the accumulated STM path and save it locally to the file 'output.path'
release?id=bead_id = unregister a client associated with the specified bead ID
terminate = terminate the server at the end of the STM cycle
shutdown = stop the server execution
errors = display errors from the server stack

Options

-s, --serverkey FILE
Name of file containing the server key. The server key contains the server name, port, and password. This option is mutually exclusive with 'password' option.
(Default: server.key)
-p, --password FILE
Name of file containing the server magic word. If the pasword is not provided via this option or via the server key then it is read interactively from the keyboard. This option is mutually exclusive with 'serverkey' option.
-v, --verbose
Increase output verbosity.
--version
Output version information and exit.
-h, --help
Display this help and exit.