The ipcserver program
Usage
where opts is a series of getopt-style options, path is a filename to use as the address of
the the local-domain socket, and prog is one or more arguments specifying a program to run
for each accepted connection.
ipcserver listens for connections from local-domain clients. For each connection, it runs
prog, with descriptor 0 reading from the network and descriptor 1 writing to the network.
Before running prog, ipcserver sets certain environment variables.
ipcserver exits when it receives SIGTERM.
Description
General Options:
- -q: Quiet. Do not print error messages.
- -Q: (Default.) Print error messages.
- -v: Verbose. Print error messages and status messages.
Connection options:
- -c n: Do not handle more than n simultaneous connections. If there are n
simultaneous connections copies of prog running, defer acceptance of a new
connection until one copy finishes. n must be a positive integer. The default value
is 40.
- -x cdb: Follow the rules compiled into cdb by ipcrules. These rules may
specify setting environment variables or rejecting connections from bad sources.
You can rerun ipcrules to change the rules while ipcserver is running.
- -X: With -x cdb, allow connections even if cdb does not exist. Normally
ipcserver will drop the connection if cdb does not exist.
- -B banner: Write banner to the network immediately after each connection
is made.
- -g gid: Switch group ID to gid after preparing to receive connections. gid
must be a positive integer.
- -u uid: Switch user ID to uid after preparing to receive connections. uid
must be a positive integer.
- -U: Same as -g $GID -u $UID. Typically, $GID and $UID are set by
envuidgid.
- -b n: Allow a backlog of approximately n pending connections.
- -d: (Default.) Delete path before binding it to a socket.
- -D: No not delete path before binding it to a socket.
Data-gathering options:
- -l localpath: Do not look up the path bound to the local socket; use
localpath for the environment variable $IPCLOCALPATH.
- -p: (Default.) Look up the peer’s effective user and group IDs. Put the results in
the environment variables $IPCREMOTEEUID and $IPCREMOTEEGID.
- -P: Do not look up the peer’s effective user and group IDs. Unset the
environment variables $IPCREMOTEEUID and $IPCREMOTEEGID.
Copyright © 2009 by SuperScript Technology, Inc. All rights reserved.