.\" Process this file with
.\" groff -man -Tascii sudosh.1
.\"

.TH SUDOSH 1 "June 16th 2005" 1.8.2 "User Manuals"
.SH NAME
sudosh \- works like a VCR and records shell sessions.
.SH SYNOPSIS
.B sudosh [OPTION]...
.SH DESCRIPTION
.B sudosh
can be used as a default login shell or as a filter.  sudosh takes advantage of pty devices in order to sit between the user's keyboard and a program, in this case a shell.  It was designed specifically to be used in conjunction with
.BR sudo (8)
and allows execution of a shell with logging.  It is basically a VCR and will record shell sessions and also has the ability to play back the sessions as they were originally recorded.  It records all input/output, keyboard input, and timing information so that the session acn be played back in the original format.
.SH OPTIONS
.IP -h
display help synopsis and exit.
.IP -i
initialize LOGDIR
.IP -v
show version information and exit.
.SH ENVIRONMENT
.IP SHELL
.RS
This shell will be used with sudosh is executed.  The shell must be listed in /etc/shells.  If the shell specified isn't listed in /etc/shells the invoking user's login shell from /etc/passwd will be used instead.

AIX is different.  The SHELL is set and executed by setpenv() which reads the user's attributes from /etc/passwd.
.SH BUGS
sudosh is difficult to pronounce.
.SH EXAMPLES
Initialize the logging directory which will create LOGDIR if it doesn't exist and set the correct, secure permissions.

.RS
$ sudo sudosh -i

.RE
Record your own session as yourself.

.RS
$ sudosh
.RE

Obtain a root shell and record it.

.RS
$ sudo sudosh

.RE
Login as oracle and record the session.

.RS
$ sudo -u oracle sudosh
.RE

View recorded sessions.  See also
.BR sudosh-replay (8)

.RS
# sudosh-replay
.RE
.SH AUTHOR
Douglas Richard Hanks, Jr. <dhanks@gmail.com>
.SH "SEE ALSO"
.BR sudosh.conf (5)
.BR sudosh-replay (8),
.BR sudo (8)