cs - connect stream control
cs [ options ] [ [ - ] host | path [ command ... ] ]
displays, initiates, and terminates connect stream services, and displays the contents of connect stream message files.
If no options are spcified then the connect stream for path
is opened. If the corresponding service is not running then it
is initiated and the connection is attempted again. If command
is specified then it is executed with the standard input,
standard output and standard error redirected to the path
connect stream. If command
is omitted then the /dev/
equivalent path for the connect stream is listed on the standard output.
- -a, --attribute=name
List the attribute name for each host. If name is - then all
attributes are listed. The hostname attribute is listed without a label, all other attributes are listed as label=value
- -c, --cat
Catenate messages in the named path operands. If path is omitted then the standard
input is read.
- -d, --debug=level
Set the debug trace level to level. Higher levels produce more output.
- -f, --continuous
Used with --cat to list messages on a path or standard input that is
- -h, --hostenvironment
Lists HOSTNAME=name HOSTTYPE=type on the standard output for
the named host operand or the local host if host is omitted. This is useful for .profile initialization.
- -i, --interactive
Open an interactive connection to the connect stream. The service is initiated if it is not
- -k, --kill=signal
Send signal to the server on the connect stream named by path. signal
may be a signal name or signal number.
- -l, --list
List the active connect stream services on the standard output.
- -m, --mount
List the active connect stream mount directories on the standard output.
- -p, --process
List the active connect stream process ids on the standard output.
- -q, --query
Open an interactive connection to the connect stream if a service is already running; fail
- -r, --raw
Raw mode --interactive connection.
- -s, --iservice
List details for each active connect stream service on the standard output. The output format
is similar to an ls(1) --long listing, except the size field is the tcp
or udp port number, and the service base name appears as a symbolic link to the network /proc path for the
- -t, --translate
host name operands are translated to IP address dot notation and listed on the standard
output. If host is omitted then the standard input is read for host names, one per line.
- -C, --call=call-list
Used with --cat to list only messages for the calls in call-list.
- -O, --open-flags=flags
Set optional csopen(3)
flags. Used by the cs(3) library to initiate remote connections.
- -T, --terse=call-list
Used with --cat to list terse messages for the calls in call-list
Static information for hosts in the local network is in the file ../share/lib/cs/local
. Each line in the local
file provides information for a single host. The syntax is: host-name
... ]. Attributes
for the host local
are inherited by all hosts. Locally administered attributes may be added. attribute
predefined semantics are:
- The host IP address in dot notation.
- The coshell(1) multiplies the host load by
bias to prioritize host availability. bias > 1 makes the host less likely to be chosen.
- coshell(1) jobs running on a host that has
remained busy for this amount of time are suspended until the host returns to idle status.
- The number of cpus on the host as reported by
- The minimum interactive user idle time before
coshell(1) will schedule a job on the host.
- The coshell(1) attempts to keep pool
host connections active.
The host rating as reported by
- The host type as reported by package(1).