Isect Middleware How-To - isdclient

Go to the first, previous, next, last section, table of contents.

## isdclient

    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.