src/world/bin/su/man/su.1

57 lines
970 B
Groff

.Dd 2020-10-06
.Dt SU 1
.Os HitchHiker linux
.Sh NAME
.Nm su
.Nd run a command with a substitute user and group ID
.Sh DESCRIPTION
.Nm
allows commands to be run with a substitute user and group ID. When called without
arguments,
.Nm
defaults to running and interactive shell as root.
.Sh OPTIONS
\fB\-l\fP, \fB\-\-login\fP
.RS 4
Starts the shell as a login shell with an environment similar to a real login
.RE
.sp
\fB\-p\fP, \fB\-\-preserve\fP
.RS 4
Preserves the whole environment
.RE
.sp
\fB\-c\fP, \fB\-\-command\fP=\fIcommand\fP
.RS 4
Pass \fIcommand\fP to the shell
.RE
.sp
\fB\-s\fP, \fB\-\-shell\fP=\fIshell\fP
.RS 4
Run the specified shell instead of the default.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Print help
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Print version
.RE
.sp
.Sh EXIT STATUS
.Ex -std su
.Sh AUTHOR
Written by Nathan Fisher for HitchHiker Linux.
.Sh SEE ALSO
.Xr login 1
.Xr passwd 5
.Xr jah 1
.Sh HISTORY
The
.Nm
utility appeared in
.At v1