isdclient [-d] [-k] [-u] [-h hostname] [-c command] [servicename]
isdclient is a generic TTY interface for sending commands to isectd workers that accept ASCII input. isdclient buffers lines from its standard input until receiving a "go" on a line by itself. It sends the buffered data to isectd as input to the OPerator service. The message that's returned is written to standard output.
All switches and arguments to isdclient are optional. Its default behavior is to connect to isectd in a way that allows it to send the daemon commands, not any of its workers. This is how isectd is configured (but more in that later).
-d turns on some primitive debugging in the client--NOT a worker
-k sets the "more" option of the header packet indicating to the
worker that more messages are likely to come. Even so, isdclient
will wait for a response from the worker. In this manner, isdclient
can "converse" with a single worker. Usually, without -k, after a
worker replies to a client isectd marks it as being available for
another request.
-u indicates input lines should be un-escaped by the WWW library.
This option only works if the WWW library was available at "configure"
time.
-h hostname designates a host to look for the isectd daemon on.
The default behavior is to connect to the host aliased as "isectd" in
/etc/hosts, or the local DNS maps.
-c command is a shorthand way to issue simple commands without
having to get into then out of isdclient. For example, one way to
stop all workers would be:
# isdclient stop all go ^D
A quicker way, if all you want to do is execute a single command from the shell would be:
# isdclient -c "stop all"
If the command has multiple words like the example above they must
be quoted to sneak them past the shell as a single argument to -c.
servicename identifies a service the client wishes to send messages
to. In the demo directory a single service is created called echo.
To start isdclient with all messages directed to workers accepting "echo"
requests:
# isdclient echo
Go to the first, previous, next, last section, table of contents.