rootsh.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.012.
.TH rootsh "1" "July 2004" "rootsh" "Gerhard Lausser"
.SH NAME
rootsh \- a logging wrapper for shells
.SH SYNOPSIS
.B rootsh
[\fIOPTION\fR]... [\fI\-\-\fR] [\fICOMMANDS\fR]
.SH DESCRIPTION
.PP
.\" Add any additional description here
.PP
Start a shell with logging of input/output.
Rootsh must be started via sudo if you want to become root.
It does not raise your privileges on it's own.
You can run rootsh as a standalone application if you only want to log your own user's session.
If you call rootsh with additional commands, these will be passed to the shell.
.TP
\fB\-i\fR, \fB\-\-login\fR
Make the shell a login shell
.TP
\fB\-u\fR, \fB\-\-user\fR=\fIUSER\fR
Run the shell as a non-root user
.TP
\fB\-f\fR, \fB\-\-logfile=\fIFILE\fR
Name of the file you want to write the logs
(standalone only)
.TP
\fB\-d\fR, \fB\-\-logdir=\fIDIR\fR
Directory where you want your logfile written
(standalone only)
.TP
\fB\-\-no\-logfile\fR
Switch off logging to a file
(standalone only)
.TP
\fB\-\-no\-syslog\fR
Switch off logging to syslog
(standalone only)
.TP
\fB\-h\fR, \fB\-\-help\fR
Display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
Output version and capability information and exit
.TP
\fB\-\-\fR\fR
Stop scanning for command line options. Everything found after \-\- will be passed to the shell with -c
.PP
No parameters mean start a rootshell
.SH EXAMPLES
.TP
\fBsudo rootsh\fR
Start a logged root shell
.TP
\fBsudo rootsh -u oracle\fR
Start a logged shell in the context of user oracle.
.TP
\fBrootsh -f mysession.log --no-syslog\fR
Start a new shell for your user id, write protocol into mysession.log, do not send anything to syslog.
This is identical to "script -f mysession.log"
.TP
\fBrootsh -i -u oracle lsnrctl stop\fR
Run command "lsnrctl stop" as user oracle. (this will call sh -c "lsnrctl stop")
.TP
\fBrootsh -i -u oracle -- ls -l\fR
Run command "ls -l" as user oracle. (this will call sh -c "ls -l")
.SH "REPORTING BUGS"
Report bugs to Corey Henderson <corman@cormander.com>
.SH "SEE ALSO"
The full documentation for
.B rootsh
can be found at http://www.sourceforge.net/projects/rootsh
.SH COPYRIGHT
Copyright \(co 2007 Free Software Foundation, Inc.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.