isa/sudo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document lines/cols in user_info

Browse Source
This commit is contained in:
Todd C. Miller
2010-03-17 10:44:16 -04:00
parent 96a98bed4b
commit 81949e89d1
3 changed files with 66 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

94
doc/sudo_plugin.cat
View File

@@ -61,7 +61,7 @@ SSuuddoo PPlluuggiinn AAPPII
1.8.0a1 March 11, 2010 1 1.8.0a1 March 17, 2010 1
@@ -127,7 +127,7 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
1.8.0a1 March 11, 2010 2 1.8.0a1 March 17, 2010 2
@@ -193,7 +193,7 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
1.8.0a1 March 11, 2010 3 1.8.0a1 March 17, 2010 3
@@ -247,19 +247,19 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
The local machine's hostname as returned by the The local machine's hostname as returned by the
gethostname() system call. gethostname() system call.
user_env lines=int
The user's environment in the form of a NULL-terminated vector The number of lines the user's terminal supports. If there
of "name=value" strings. is no terminal device available, a default value of 24 is
used.
When parsing _u_s_e_r___e_n_v, the plugin should split on the ffiirrsstt cols=int
equal sign ('=') since the _n_a_m_e field will never include one The number of columns the user's terminal supports. If
itself but the _v_a_l_u_e might. there is no terminal device available, a default value of
80 is used.
1.8.0a1 March 17, 2010 4
1.8.0a1 March 11, 2010 4
@@ -268,6 +268,14 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
user_env
The user's environment in the form of a NULL-terminated vector
of "name=value" strings.
When parsing _u_s_e_r___e_n_v, the plugin should split on the ffiirrsstt
equal sign ('=') since the _n_a_m_e field will never include one
itself but the _v_a_l_u_e might.
close close
void (*close)(int exit_status, int error); void (*close)(int exit_status, int error);
@@ -315,17 +323,9 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
The number of elements in _a_r_g_v, not counting the final NULL The number of elements in _a_r_g_v, not counting the final NULL
pointer. pointer.
argv
The argument vector describing the command the user wishes to
run, in the same form as what would be passed to the _e_x_e_c_v_e_(_)
system call. The vector is terminated by a NULL pointer.
env_add
Additional environment variables specified by the user on the
1.8.0a1 March 17, 2010 5
1.8.0a1 March 11, 2010 5
@@ -334,6 +334,13 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
argv
The argument vector describing the command the user wishes to
run, in the same form as what would be passed to the _e_x_e_c_v_e_(_)
system call. The vector is terminated by a NULL pointer.
env_add
Additional environment variables specified by the user on the
command line in the form of a NULL-terminated vector of command line in the form of a NULL-terminated vector of
"name=value" strings. The plugin may reject the command if one "name=value" strings. The plugin may reject the command if one
or more variables are not allowed to be set, or it may silently or more variables are not allowed to be set, or it may silently
@@ -382,16 +389,9 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
If set, ssuuddoo will preserve the user's group vector instead If set, ssuuddoo will preserve the user's group vector instead
of initializing the group vector based on runas_user. of initializing the group vector based on runas_user.
cwd=string
The current working directory to change to when executing
the command.
noexec=bool
If set, prevent the command from executing other programs.
1.8.0a1 March 17, 2010 6
1.8.0a1 March 11, 2010 6
@@ -400,6 +400,13 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
cwd=string
The current working directory to change to when executing
the command.
noexec=bool
If set, prevent the command from executing other programs.
chroot=string chroot=string
The root directory to use when running the command. The root directory to use when running the command.
@@ -448,16 +455,9 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
verbose verbose
Flag indicating whether to list in verbose mode or not. Flag indicating whether to list in verbose mode or not.
list_user
The name of a different user to list privileges for if the
policy allows it. If NULL, the plugin should list the
privileges of the invoking user.
1.8.0a1 March 17, 2010 7
1.8.0a1 March 11, 2010 7
@@ -466,6 +466,11 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
list_user
The name of a different user to list privileges for if the
policy allows it. If NULL, the plugin should list the
privileges of the invoking user.
argc argc
The number of elements in _a_r_g_v, not counting the final NULL The number of elements in _a_r_g_v, not counting the final NULL
pointer. pointer.
@@ -518,12 +523,7 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
1.8.0a1 March 17, 2010 8
1.8.0a1 March 11, 2010 8
@@ -589,7 +589,7 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
1.8.0a1 March 11, 2010 9 1.8.0a1 March 17, 2010 9
@@ -655,7 +655,7 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
1.8.0a1 March 11, 2010 10 1.8.0a1 March 17, 2010 10
@@ -721,7 +721,7 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
1.8.0a1 March 11, 2010 11 1.8.0a1 March 17, 2010 11
@@ -787,6 +787,6 @@ SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
1.8.0a1 March 11, 2010 12 1.8.0a1 March 17, 2010 12

10
doc/sudo_plugin.man.in
View File

@@ -139,7 +139,7 @@
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "SUDO_PLUGIN @mansectsu@" .IX Title "SUDO_PLUGIN @mansectsu@"
.TH SUDO_PLUGIN @mansectsu@ "March 11, 2010" "1.8.0a1" "MAINTENANCE COMMANDS" .TH SUDO_PLUGIN @mansectsu@ "March 17, 2010" "1.8.0a1" "MAINTENANCE COMMANDS"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l
@@ -361,6 +361,14 @@ device associated with the session, the value will be empty, as in
.IX Item "host=string" .IX Item "host=string"
The local machine's hostname as returned by the \f(CW\*(C`gethostname()\*(C'\fR The local machine's hostname as returned by the \f(CW\*(C`gethostname()\*(C'\fR
system call. system call.
.IP "lines=int" 4
.IX Item "lines=int"
The number of lines the user's terminal supports. If there is
no terminal device available, a default value of 24 is used.
.IP "cols=int" 4
.IX Item "cols=int"
The number of columns the user's terminal supports. If there is
no terminal device available, a default value of 80 is used.
.RE .RE
.RS 4 .RS 4
.RE .RE

10
doc/sudo_plugin.pod
View File

@@ -260,6 +260,16 @@ C<tty=>.
The local machine's hostname as returned by the C<gethostname()> The local machine's hostname as returned by the C<gethostname()>
system call. system call.
=item lines=int
The number of lines the user's terminal supports. If there is
no terminal device available, a default value of 24 is used.
=item cols=int
The number of columns the user's terminal supports. If there is
no terminal device available, a default value of 80 is used.
=back =back
=item user_env =item user_env