.\" @(#)console.1 01/06/91 OSU CIS; Thomas A. Fine
.TH CONSOLE 1 "6 January 1991" "OSU/CIS"
.SH NAME
console \- console server client program
.SH SYNOPSIS
.B console
[ -a | -f | -s | -w ]
.I server
[escape characters]
.br
.B console who
.SH DESCRIPTION
.B Console
is used to manipulate the server console terminals remotely.  The server
name you specify can be any abbreviation of the full server name, as long
as it uniquely identifies the server.
.B Console
will request a password,
except when using the -w option (who).  It will accept either the root password,
or the operator password.
Options for
.B console
are:
.TP
.B \-a
Requests a two-way connection to the specified console (default).
.TP
.B \-f
Same as
.I -a
except it will force any existing connection into spy mode.
.TP
.B \-s
Requests a read-only (spying) connection.
.TP
.B \-w
Displays a list of connections for the specified console.
.PP
If the -a, -f, or -s option is specified with a capital letter instead of
lower case,
.B console
will display the last twenty lines of the log file after making the connection.
If no option is given or the -a option is used, you will be connected in spy
mode if someone else is attached or if the operator password was used.
.PP
If their are two additional arguments, they will be evaluated as decimal
numbers.  If they are both non-zero, the equivalent ascii characters will
be used to reset the escape sequence.
.PP
.B Console who
will display a list of connections to all consoles.
.SH "ESCAPE SEQUENCES"
The connection can be controlled by a two character escape sequence, followed
by a command.  The default escape sequence is control-underscore escape
(octal 037 033).  Commands are:
.TP
.B a
switch to attach mode.
.TP
.B s
switch to spy mode.
.TP
.B f
force a switch to attach mode.
.TP
.B w
who is using this console.
.TP
.B \.,^C,^D
disconnect.
.TP
.B e,r,k
change the escape sequence to the next two characters.
.TP
.B l1
send a serial line break (halt Sun server).
.TP
.B c,^S
toggle control flow (normally ON)
.TP
.B h,?
display list of commands.
.TP
.B <CR>
continue, but send the escape sequence.
.TP
.B spc
continue, and ignore the escape sequence.
.br
.sp
.PP
If any other character is hit after the escape sequence, all three characters
will be passed on to the console terminal.  Note that the server can only be
halted from a full two-way attachment.  The console server will request you
to enter a reason when a machine is halted.
.SH "SEE ALSO"
constab(5), conserver(8)
.SH BUGS
There is currently no way to background the connection.
.br
It is possible to create a loop of console connections, with ugly results.
.br
In the case of multiple console servers, an abbreviation may match more
than one console name, if the names are on different servers.  In other
words, the check for uniqueness is local to each console server.
.SH AUTHOR
Thomas A. Fine, Ohio State Computer Science.