please.1

.\" Man page generated from reStructuredText.
.
.TH PLEASE 1 "" "" ""
.SH NAME
please \- execute a command as root
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.nf
\fBplease\fP <command>
\fBplease\fP \-
.fi
.sp
.SH DESCRIPTION
.sp
\fBPlease\fP aims to be little sudo without bells and whistles.
Only pam authentication and executing command.
.sp
Name \fBplease\fP fits into unix naming conventions.
Where we have daemon instead of background process.
We are killing processes, not closing processes.
Now we can please to run privileged process.
.SH EXIT VALUE
.sp
Upon successful execution of a program, the exit status will be
the exit status of the program that was executed.
.sp
Otherwise, \fBplease\fP exits with non\-zero value.
.SH FILES
.sp
/etc/pam.d/please or /usr/local/etc/pam.d/please    PAM configuration for please.
.SH EXAMPLES
.nf
Reboot system by unprivileged user:

.in +2
$ please reboot

.in -2
To get a file listing of an unreadable directory:

.in +2
$ please ls /usr/local/protected

.in -2
Run a root shell:

.in +2
$ please \-
.in -2
.fi
.sp
.\" Generated by docutils manpage writer.
.