CONSOLIDATE(8) CONSOLIDATE(8)
NAME
consolidatemgrd - daemon to manage several consolidate
processes
SYNOPSIS
consolidatemgrd [options]
DESCRIPTION
This daemon is used to manage a number of consolidate(8)
processes described by a configuration file, by default
/etc/consolidatemgrd.conf. It keeps a consolidate process
running for each port or command specified in the configu-
ration file.
OPTIONS
-h Print a summary of usage.
-d Do not detach from the controlling terminal.
-f file
Read configuration from file, rather than the
default, /etc/consolidatemgrd.conf.
-p pidfile
Save the daemon's PID in pidfile. Use of this
option is recommended, as it will prevent you from
accidentally running two copies of the daemon.
-c path
Gives the path of the consolidate(8) executable.
CONFIGURATION FILE
The daemon is controlled by a configuration file which
describes the individual ports or processes for which con-
solidate(8) processes should be run. This file consists of
a number of statements separated by newlines, with com-
ments introduced by `#'. Whitespace is not significant.
These statements are grouped into one or more stanzas
introduced by a statement of the form,
port device-file
for a connection to a serial port, or,
command program [argument ...]
to run a program. Each such statement is followed by a
number of optional directives, including,
name string
Descriptive name for this port/command. Used in log
messages.
user (name|UID)
group (name|GID)
Set the user and group under whose credentials this
consolidate(8) process should run.
logfile path [size]
Gives the location of the console log file and,
optionally, the largest size (in bytes) to which
the file may grow before it is rotated. If not
specified, /dev/null is assumed.
socket path
Gives the path of a UNIX socket which may be passed
as an argument to conclient(1) to interact with the
port/command.
settings baud-rate,parity,data-bits flow-control [over-
ride]
Specify the configuration of a serial port. `Over-
ride', if given, means that any saved settings for
the port will be ignored when a new consolidate(8)
process is started (equivalent to using -S and -F
rather than -s and -f as arguments to consoli-
date(8)).
settingsfile path
For a port, gives the name of a file in which con-
solidate(8) will save settings information.
no-pty For a command, don't create a pseudoterminal in
which to run it.
(Most of these directives correspond directly to command-
line options to consolidate(8).)
SIGNALS
SIGTERM, SIGINT
Shut down the daemon.
SIGHUP Restart the daemon with the same options, so that
it rereads its configuration files. This will dis-
connect all users connected to individual consoli-
date(8) processes.
FILES
/etc/consolidatemgrd.conf
BUGS
Probably many. Also, this program is written in perl.
SEE ALSO
consolidate(8), conclient(1).
AUTHOR
Chris Lightfoot <chris@ex-parrot.com>
VERSION
Consolidate, version 0.3.
$Id: consolidatemgrd.8,v 1.1 2004/08/15 18:47:57 chris Exp
$
COPYING
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
02139, USA.
CONSOLIDATE(8)