Initial commit

rd.1

@@ -0,0 +1,60 @@
+.\" 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)