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)