61 lines
1.5 KiB
Groff
61 lines
1.5 KiB
Groff
.\" rd - privilege elevator
|
|
.\" Copyright (C) 2022-2023 Olive <hello@grasswren.net>
|
|
.\" see LICENCE file for licensing information
|
|
.TH RD 1 rd\-VERSION
|
|
.SH NAME
|
|
rd \- privilege elevator
|
|
.SH SYNOPSIS
|
|
.SY rd
|
|
.OP \-c
|
|
.OP \-u user
|
|
.I command
|
|
.RI [ args... ]
|
|
.YS
|
|
.SH DESCRIPTION
|
|
.BR rd (1)
|
|
is a simple privilege elevation tool.
|
|
.BR rd (1)
|
|
only allows users in the
|
|
.I GROUP
|
|
group to execute commands as different users. After verifying authorisation,
|
|
some critical environment variables are reset and
|
|
.I command
|
|
is run.
|
|
.BR rd (1)
|
|
saves the latest successful command execution time and grants password-less
|
|
authorisation if commands are executed within a certain period of time.
|
|
.BR rd (1)
|
|
accesses the controlling terminal directly rather than using stdin, allowing
|
|
.I command
|
|
to read stdin from a pipe.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-c
|
|
Clear all environment variables before resetting critical variables.
|
|
.TP
|
|
.BI \-u\ user
|
|
Execute commands as the specified
|
|
.IR user .
|
|
Defaults to
|
|
.BR root .
|
|
.SH FILES
|
|
.TP
|
|
.I /etc/rd
|
|
Latest modification time is read for password-less authorisation.
|
|
.SH EXIT STATUS
|
|
.BR rd (1)
|
|
returns with the exit status of
|
|
.I command
|
|
on success or with 127 on failure.
|
|
.SH BUGS
|
|
.BR rd (1)
|
|
will not reset the terminal settings if interrupted during password entry and
|
|
characters will not display after being typed. To fix this, run
|
|
.BR reset (1).
|
|
The correct way to exit with failure is to enter an incorrect password.
|
|
.SH AUTHOR
|
|
Written by Olive.
|
|
.SH SEE ALSO
|
|
.BR sudo (1),\ su (1),\ doas (1),\ crypt (3),\ passwd (3),\ shadow (3),
|
|
.BR passwd (5),\ shadow (5),\ proc (5)
|