.\" @(#)conserver.8 01/06/91 OSU CIS; Thomas A. Fine
.\" $Id: conserver.man,v 8.9 2012/07/06 20:59:55 ksb Exp $
.\" $Compile: Display%h
.\" $Display: ${groff:-groff} -tbl -Tascii -man %f |${PAGER:-less}
.\" $Display(*): ${groff:-groff} -tbl -T%s -man %f
.\" $Install: %b -mDeinstall %o %f && cp %f $DESTDIR/usr/local/man/man8/conserver.8
.\" $Deinstall: ${rm-rm} -f $DESTDIR/usr/local/man/[cm]a[nt][18]/conserver.8*
.TH CONSERVER 8 LOCAL
.SH NAME
conserver - console server daemon
.SH SYNOPSIS
.ds PN "conserver
\fI\*(PN\fP [\fB\-dnsv\fP] [\fB\-a\fP\~\fItype\fP] [\fB\-C\fP\~\fIconfig\fP] [\fIlines\fP]
.br
\fI\*(PN\fP \fB\-h\fP
.br
\fI\*(PN\fP \fB\-V\fP

.SH DESCRIPTION
\fIConserver\fP is the daemon for the \fBconsole\fP(1l) program.
It provides remote access to the server consoles,
and logs all console data.
Slave hosts which have no current connection might produce important
error messages, these unloved errors are each labeled with a machine name
on stdout.
.PP
When started, it forks a child for each group in /usr/local/etc/conserver.cf,
and assigns each process a port number to listen on.
The \fBconsole\fP client program knows how to request port numbers and
forwards to find the various slave \fIlines\fP.
.PP
.B Conserver
completely controls any connection to a controlled host.
The server handles all escape sequences, except the suspend sequence, which is
sent as an out-of-band command to the client.
.PP
The
.B conserver
parent process automatically respawns any child process that dies.
If the parent process receives a SIGTERM, it will propogate the signal
to its children.

.SH OPTIONS
.TP
.BI \-a type
The default client access permission is set to \fItype\fP.
Valid \fItype\fP selections are \fBtrusted\fP, \fBallowed\fP, and
\fBdeny\fP (only the first letter is actually examined).
Any use of \fBtrusted\fP shows a lack of "reasonable care".
.TP
.BI \-C config
With this option the invoker may specify an alternate confguration.
The default \fIconfig\fP is /usr/local/lib/conserver.cf.
.TP
.B \-d
Various debug messages may (or may not) be enabled.  Depends on
compile time switches and the phase of the moon.
.TP
.B \-h
Output a brief help message.
.TP
.B \-n
The \fI\*(PN\fP will \fBnot\fP output unloved console output to
stdout.
.TP
.B \-s
Enables soft carrier on all ports.  Most useful for installation
debugging.
.TP
.B \-v
Echo the configuration as it is being read (be verbose).
Also display usage (login/logout) messages to stdout.
.TP
.B \-V
Output the version of the console server (only) and exit.

.SH EXAMPLES
conserver: expert: login ksb
.br
tyro: panic: my brain hurts
.br
conserver: ksb shifts from expert to tyro
.br
conserver: tyro: logout ksb
.br
\...

.SH FILES
.TS
l l.
/usr/local/lib/conserver.cf	description of console terminal lines
/var/log/consoles/\fIhost\fP	log files for \fIhost\fP's console
/dev/tty??	terminal line device files
\fIstdout\fP	summary of unloved console errors
.TE

.SH AUTHORS
Kevin S Braunsdorf, Purdue University Computing Center, conserver at
ksb dot npcguild.org
.br
Thomas A. Fine, Ohio State Computer Science

.SH "SEE ALSO"
.hlm 0
console(1l), conserver.cf(5l), autologin(8l)