CONSOLIDATE(8)                                     CONSOLIDATE(8)



NAME
       consolidate  -  capture  and log output from a terminal or
       program, and allow users to connect to and  interact  with
       it.

SYNOPSIS
       consolidate [options] (tty | command) logfile [socket]

DESCRIPTION
       Consolidate is a console server. It connects to a terminal
       (which is presumably connected to some device  which  will
       generate  output,  such  as  another  computer,  a network
       switch or whatever), or runs a program (which might  be  a
       user-mode  Linux  kernel or similar) and captures its out-
       put. It saves the output in the named logfile,  prepending
       to  each  line of output the date and time at which it was
       read. If specified, socket is the path of a  UNIX  socket;
       consolidate  will  accept  connections to this socket from
       the related conclient(1) program; output read from the tty
       or  command is copied to the connected users, and anything
       they type is copied to the tty or to the input of the com-
       mand.

       When  consolidate  reads from a tty, connected clients may
       change the settings of the terminal. Any such changes  are
       logged.

OPTIONS
       -h     Print a summary of usage.

       -s baud-rate,parity,data-bits
              Configure  the  tty  with  the  given settings; the
              default is whatever is saved in ~/.consolidate,  or
              otherwise `9600,n,8'.

       -S ... Like -s, but don't override saved settings.

       -f (none|hw|sw)
              Configure  flow  control  on the tty to be `hw' for
              hardware (RTS/CTS), `sq' for  software  (XON/XOFF),
              or `none' for no flow control. The default is what-
              ever is  stored  in  ~/.consolidate,  or  otherwise
              `hw'.

       -F ... Like -f, but don't override saved settings.

       -P     If  running  a command, don't run it inside a pseu-
              doterminal, but instead use a socket pair.

       -P     Don't lock the tty using a UUCP lock file.

       -l size
              Rotate logfile whenever it grows to be larger  than
              size bytes.

       -d     Do not detach from the controlling terminal.

       -e     Log errors to standard error, as well as the system
              log.

FILES
       ~/.consolidate (though the location of the  settings  file
       may  be altered using the CONSOLIDATE_DEFAULTS environment
       variable).

BUGS
       Probably many.

SEE ALSO
       conclient(1), tty(5), minicom(1), socketpair(2).

AUTHOR
       Chris Lightfoot <chris@ex-parrot.com>

VERSION
       Consolidate, version 0.3.
       $Id: consolidate.8,v 1.5 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)