mir/sudo
2
0
Fork 0
mirror of https://github.com/sudo-project/sudo.git synced 2025-08-31 14:25:15 +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
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 The prompt to use when requesting a password, if
specified via the --pp flag. 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 run_shell=bool
Set to true if the user specified the --ss flag, Set to true if the user specified the --ss flag,
indicating that the user wishes to run a shell. indicating that the user wishes to run a shell.
runas_group=string 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. specified via the --gg flag.
runas_user=string 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. specified via the --uu flag.
selinux_role=string selinux_role=string
@@ -271,11 +280,11 @@ DDEESSCCRRIIPPTTIIOONN
pgid=int pgid=int
The ID of the process group that the running ssuuddoo The ID of the process group that the running ssuuddoo
process is a member of. Only available starting with process is a member of. Only available starting with
API version 1.2 API version 1.2.
pid=int pid=int
The process ID of the running ssuuddoo process. Only 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 plugin_options
Any (non-comment) strings immediately after the plugin Any (non-comment) strings immediately after the plugin
@@ -293,18 +302,18 @@ DDEESSCCRRIIPPTTIIOONN
ppid=int ppid=int
The parent process ID of the running ssuuddoo process. 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 sid=int
The session ID of the running ssuuddoo process or 0 if ssuuddoo The session ID of the running ssuuddoo process or 0 if ssuuddoo
is not part of a POSIX job control session. Only 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 tcpgid=int
The ID of the foreground process group associated with The ID of the foreground process group associated with
the terminal device associated with the ssuuddoo process or the terminal device associated with the ssuuddoo process or
-1 if there is no terminal present. Only available -1 if there is no terminal present. Only available
starting with API version 1.2 starting with API version 1.2.
tty=string tty=string
The path to the user's terminal device. If the user 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 The ssuuddoo front end now installs default signal handlers to trap
common signals while the plugin functions are run. 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 SSEEEE AALLSSOO
sudo.conf(4), sudoers(4), sudo(1m) 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 file distributed with ssuuddoo or http://www.sudo.ws/sudo/license.html for
complete details. 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. .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd March 5, 2013 .Dd July 16, 2013
.Dt SUDO_PLUGIN @mansectform@ .Dt SUDO_PLUGIN @mansectform@
.Os Sudo @PACKAGE_VERSION@ .Os Sudo @PACKAGE_VERSION@
.Sh NAME .Sh NAME
@@ -292,18 +292,28 @@ The prompt to use when requesting a password, if specified via
the the
.Fl p .Fl p
flag. 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 .It run_shell=bool
Set to true if the user specified the Set to true if the user specified the
.Fl s .Fl s
flag, indicating that flag, indicating that the user wishes to run a shell.
the user wishes to run a shell.
.It runas_group=string .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 the
.Fl g .Fl g
flag. flag.
.It runas_user=string .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 .Fl u
flag. flag.
.It selinux_role=string .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 The ID of the process group that the running
.Nm sudo .Nm sudo
process is a member of. process is a member of.
Only available starting with API version 1.2 Only available starting with API version 1.2.
.It pid=int .It pid=int
The process ID of the running The process ID of the running
.Nm sudo .Nm sudo
process. process.
Only available starting with API version 1.2 Only available starting with API version 1.2.
.It plugin_options .It plugin_options
Any (non-comment) strings immediately after the plugin path are Any (non-comment) strings immediately after the plugin path are
passed as arguments to the plugin. 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 The parent process ID of the running
.Nm sudo .Nm sudo
process. process.
Only available starting with API version 1.2 Only available starting with API version 1.2.
.It sid=int .It sid=int
The session ID of the running The session ID of the running
.Nm sudo .Nm sudo
process or 0 if process or 0 if
.Nm sudo .Nm sudo
is not part of a POSIX job control session. 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 .It tcpgid=int
The ID of the foreground process group associated with the terminal The ID of the foreground process group associated with the terminal
device associated with the device associated with the
.Nm sudo .Nm sudo
process or \-1 if there is no process or \-1 if there is no
terminal present. terminal present.
Only available starting with API version 1.2 Only available starting with API version 1.2.
.It tty=string .It tty=string
The path to the user's terminal device. The path to the user's terminal device.
If the user has no terminal device associated with the session, If the user has no terminal device associated with the session,
@@ -2180,6 +2190,12 @@ The
.Nm sudo .Nm sudo
front end now installs default signal handlers to trap common signals front end now installs default signal handlers to trap common signals
while the plugin functions are run. 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 .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr sudo.conf @mansectform@ , .Xr sudo.conf @mansectform@ ,