mir/sudo
2
0
Fork 0
mirror of https://github.com/sudo-project/sudo.git synced 2025-08-30 13:58:05 +00:00
Code Issues Releases Wiki Activity

Document the remote_host setting (-h host)

Browse Source
This commit is contained in:
Todd C. Miller 2013-07-16 16:21:14 -06:00
parent ba615bd58f
commit 1d20a0ab63
3 changed files with 201 additions and 175 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
doc/sudo_plugin.cat
View File

@ -193,16 +193,25 @@ DDEESSCCRRIIPPTTIIOONN
The prompt to use when requesting a password, if
specified via the --pp flag.
remote_host=string
The name of the remote host to run the command on, if
specified via the --hh option. Support for running the
command on a remote host is meant to be implemented via
a helper program that is executed in place of the user-
specified command. The ssuuddoo front end is only capable
of executing commands on the local host. Only
available starting with API version 1.4.
run_shell=bool
Set to true if the user specified the --ss flag,
indicating that the user wishes to run a shell.
runas_group=string
The group name or gid to to run the command as, if
The group name or gid to run the command as, if
specified via the --gg flag.
runas_user=string
The user name or uid to to run the command as, if
The user name or uid to run the command as, if
specified via the --uu flag.
selinux_role=string
@ -271,11 +280,11 @@ DDEESSCCRRIIPPTTIIOONN
pgid=int
The ID of the process group that the running ssuuddoo
process is a member of. Only available starting with
API version 1.2
API version 1.2.
pid=int
The process ID of the running ssuuddoo process. Only
available starting with API version 1.2
available starting with API version 1.2.
plugin_options
Any (non-comment) strings immediately after the plugin
@ -293,18 +302,18 @@ DDEESSCCRRIIPPTTIIOONN
ppid=int
The parent process ID of the running ssuuddoo process.
Only available starting with API version 1.2
Only available starting with API version 1.2.
sid=int
The session ID of the running ssuuddoo process or 0 if ssuuddoo
is not part of a POSIX job control session. Only
available starting with API version 1.2
available starting with API version 1.2.
tcpgid=int
The ID of the foreground process group associated with
the terminal device associated with the ssuuddoo process or
-1 if there is no terminal present. Only available
starting with API version 1.2
starting with API version 1.2.
tty=string
The path to the user's terminal device. If the user
@ -1393,6 +1402,9 @@ PPLLUUGGIINN AAPPII CCHHAANNGGEELLOOGG
The ssuuddoo front end now installs default signal handlers to trap
common signals while the plugin functions are run.
Version 1.4 (sudo 1.8.8)
The _r_e_m_o_t_e___h_o_s_t entry was added to the settings list.
SSEEEE AALLSSOO
sudo.conf(4), sudoers(4), sudo(1m)
@ -1412,4 +1424,4 @@ DDIISSCCLLAAIIMMEERR
file distributed with ssuuddoo or http://www.sudo.ws/sudo/license.html for
complete details.
Sudo 1.8.7 March 5, 2013 Sudo 1.8.7
Sudo 1.8.8 July 16, 2013 Sudo 1.8.8

312
doc/sudo_plugin.man.in
View File

File diff suppressed because it is too large Load Diff

36
doc/sudo_plugin.mdoc.in
View File

@ -14,7 +14,7 @@
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd March 5, 2013
.Dd July 16, 2013
.Dt SUDO_PLUGIN @mansectform@
.Os Sudo @PACKAGE_VERSION@
.Sh NAME
@ -292,18 +292,28 @@ The prompt to use when requesting a password, if specified via
the
.Fl p
flag.
.It remote_host=string
The name of the remote host to run the command on, if specified via
the
.Fl h
option.
Support for running the command on a remote host is meant to be implemented
via a helper program that is executed in place of the user-specified command.
The
.Nm sudo
front end is only capable of executing commands on the local host.
Only available starting with API version 1.4.
.It run_shell=bool
Set to true if the user specified the
.Fl s
flag, indicating that
the user wishes to run a shell.
flag, indicating that the user wishes to run a shell.
.It runas_group=string
The group name or gid to to run the command as, if specified via
The group name or gid to run the command as, if specified via
the
.Fl g
flag.
.It runas_user=string
The user name or uid to to run the command as, if specified via the
The user name or uid to run the command as, if specified via the
.Fl u
flag.
.It selinux_role=string
@ -392,12 +402,12 @@ no terminal device available, a default value of 24 is used.
The ID of the process group that the running
.Nm sudo
process is a member of.
Only available starting with API version 1.2
Only available starting with API version 1.2.
.It pid=int
The process ID of the running
.Nm sudo
process.
Only available starting with API version 1.2
Only available starting with API version 1.2.
.It plugin_options
Any (non-comment) strings immediately after the plugin path are
passed as arguments to the plugin.
@ -428,21 +438,21 @@ Failure to do so may result in a crash.
The parent process ID of the running
.Nm sudo
process.
Only available starting with API version 1.2
Only available starting with API version 1.2.
.It sid=int
The session ID of the running
.Nm sudo
process or 0 if
.Nm sudo
is not part of a POSIX job control session.
Only available starting with API version 1.2
Only available starting with API version 1.2.
.It tcpgid=int
The ID of the foreground process group associated with the terminal
device associated with the
.Nm sudo
process or \-1 if there is no
terminal present.
Only available starting with API version 1.2
Only available starting with API version 1.2.
.It tty=string
The path to the user's terminal device.
If the user has no terminal device associated with the session,
@ -2180,6 +2190,12 @@ The
.Nm sudo
front end now installs default signal handlers to trap common signals
while the plugin functions are run.
.It Version 1.4 (sudo 1.8.8)
The
.Em remote_host
entry was added to the
.Li settings
list.
.El
.Sh SEE ALSO
.Xr sudo.conf @mansectform@ ,