Mention in the conversation function section that a newline is

not implicit.
This commit is contained in:
Todd C. Miller
2010-03-11 17:02:23 -05:00
parent af62ffe6f1
commit f0f803e337
3 changed files with 33 additions and 29 deletions

View File

@@ -1,7 +1,7 @@
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
SSuuddoo PPlluuggiinn AAPPII SSuuddoo PPlluuggiinn AAPPII
@@ -61,13 +61,13 @@ SSuuddoo PPlluuggiinn AAPPII
1.8.0a1 February 24, 2010 1 1.8.0a1 March 11, 2010 1
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
struct policy_plugin { struct policy_plugin {
@@ -127,13 +127,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 2 1.8.0a1 March 11, 2010 2
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
when running ssuuddoo. As such, they will only be present when the when running ssuuddoo. As such, they will only be present when the
@@ -193,13 +193,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 3 1.8.0a1 March 11, 2010 3
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
selinux_type=string selinux_type=string
@@ -259,13 +259,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 4 1.8.0a1 March 11, 2010 4
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
close close
@@ -325,13 +325,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 5 1.8.0a1 March 11, 2010 5
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
command line in the form of a NULL-terminated vector of command line in the form of a NULL-terminated vector of
@@ -391,13 +391,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 6 1.8.0a1 March 11, 2010 6
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
chroot=string chroot=string
@@ -457,13 +457,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 7 1.8.0a1 March 11, 2010 7
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
argc argc
@@ -510,7 +510,8 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
If the plugin needs to interact with the user or display informational If the plugin needs to interact with the user or display informational
or error messages, it may do so via the conversation function. A or error messages, it may do so via the conversation function. A
plugin should not attempt to read directly from the standard input or plugin should not attempt to read directly from the standard input or
the user's tty. the user's tty (neither of which are guaranteed to exist). The caller
must include a trailing newline in msg if they want one to be printed.
@@ -522,14 +523,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 March 11, 2010 8
1.8.0a1 February 24, 2010 8
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
struct sudo_conv_message { struct sudo_conv_message {
@@ -589,13 +589,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 9 1.8.0a1 March 11, 2010 9
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
version version
@@ -655,13 +655,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 10 1.8.0a1 March 11, 2010 10
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
user_env user_env
@@ -721,13 +721,13 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 11 1.8.0a1 March 11, 2010 11
SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8) SUDO_PLUGIN(1m) MAINTENANCE COMMANDS SUDO_PLUGIN(1m)
The _l_o_g___o_u_t_p_u_t function is called whenever data can be read from The _l_o_g___o_u_t_p_u_t function is called whenever data can be read from
@@ -787,6 +787,6 @@ SUDO_PLUGIN(8) MAINTENANCE COMMANDS SUDO_PLUGIN(8)
1.8.0a1 February 24, 2010 12 1.8.0a1 March 11, 2010 12

View File

@@ -139,7 +139,7 @@
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "SUDO_PLUGIN @mansectsu@" .IX Title "SUDO_PLUGIN @mansectsu@"
.TH SUDO_PLUGIN @mansectsu@ "February 24, 2010" "1.8.0a1" "MAINTENANCE COMMANDS" .TH SUDO_PLUGIN @mansectsu@ "March 11, 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
@@ -607,7 +607,9 @@ support credential caching.
If the plugin needs to interact with the user or display informational If the plugin needs to interact with the user or display informational
or error messages, it may do so via the conversation function. A or error messages, it may do so via the conversation function. A
plugin should not attempt to read directly from the standard input plugin should not attempt to read directly from the standard input
or the user's tty. or the user's tty (neither of which are guaranteed to exist). The
caller must include a trailing newline in \f(CW\*(C`msg\*(C'\fR if they want one
to be printed.
.PP .PP
.Vb 9 .Vb 9
\& struct sudo_conv_message { \& struct sudo_conv_message {

View File

@@ -527,7 +527,9 @@ support credential caching.
If the plugin needs to interact with the user or display informational If the plugin needs to interact with the user or display informational
or error messages, it may do so via the conversation function. A or error messages, it may do so via the conversation function. A
plugin should not attempt to read directly from the standard input plugin should not attempt to read directly from the standard input
or the user's tty. or the user's tty (neither of which are guaranteed to exist). The
caller must include a trailing newline in C<msg> if they want one
to be printed.
struct sudo_conv_message { struct sudo_conv_message {
#define SUDO_CONV_PROMPT_ECHO_OFF 1 #define SUDO_CONV_PROMPT_ECHO_OFF 1