summaryrefslogtreecommitdiff
path: root/docs/sudo_plugin_python.man.in
diff options
context:
space:
mode:
authorTodd C. Miller <Todd.Miller@sudo.ws>2022-01-19 18:41:23 -0700
committerTodd C. Miller <Todd.Miller@sudo.ws>2022-01-19 18:41:23 -0700
commit624440a3a69aa95df57429a8a50dbc172f56ff51 (patch)
tree7e66722da559fbb7b77ae4e4d4f3e7b41ecfc2f0 /docs/sudo_plugin_python.man.in
parentec13d8ea8909beca6611b7e1fb9e51fd36d48652 (diff)
downloadsudo-624440a3a69aa95df57429a8a50dbc172f56ff51.tar.gz
Use the Oxford comma consistently, it is helpful in technical documents.
Diffstat (limited to 'docs/sudo_plugin_python.man.in')
-rw-r--r--docs/sudo_plugin_python.man.in13
1 files changed, 7 insertions, 6 deletions
diff --git a/docs/sudo_plugin_python.man.in b/docs/sudo_plugin_python.man.in
index 91cc35e84..1b6e7c9f5 100644
--- a/docs/sudo_plugin_python.man.in
+++ b/docs/sudo_plugin_python.man.in
@@ -3,6 +3,7 @@
.\" SPDX-License-Identifier: ISC
.\"
.\" Copyright (c) 2019-2021 Robert Manner <robert.manner@oneidentity.com>
+.\" Copyright (c) 2019-2022 Todd C. Miller <Todd.Miller@sudo.ws>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
@@ -16,7 +17,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.TH "SUDO_PLUGIN_PYTHON" "5" "September 17, 2021" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO_PLUGIN_PYTHON" "5" "January 19, 2022" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
.nh
.if n .ad l
.SH "NAME"
@@ -97,7 +98,7 @@ The actual methods required depent on the type of the plugin,
but most return an
\(lqint\(rq
result code, as documented in
-sudo_plugin(@mansctsu@),
+sudo_plugin(@mansectsu@),
that indicates whether or not the method was successful.
The Python sudo module defines the following constants to improve readability:
.RS 4n
@@ -327,7 +328,7 @@ strings.
.sp
To accept a command, at the very minimum the plugin must set in the
\fIcommand\fR,
-\fIrunas_uid\fR
+\fIrunas_uid\fR,
and
\fIrunas_gid\fR
keys.
@@ -709,7 +710,7 @@ log_stderr(self, buf: str) -> int
.RS 6n
.sp
Receive the user input or output of the terminal device and
-application standard input / output / error.
+application standard input, standard output, or standard error.
See the matching calls in
sudo_plugin(@mansectform@).
.sp
@@ -1022,7 +1023,7 @@ front-end.
plugin_type
The type of plugin that accepted the command, currently either
\fRsudo.PLUGIN_TYPE.POLICY\fR,
-\fRsudo.PLUGIN_TYPE.APPROVAL\fR
+\fRsudo.PLUGIN_TYPE.APPROVAL\fR,
or
\fRsudo.PLUGIN_TYPE.SUDO\fR.
The
@@ -1082,7 +1083,7 @@ The name of the plugin that rejected the command.
plugin_type
The type of plugin that rejected the command, currently either
\fRsudo.PLUGIN_TYPE.POLICY\fR,
-\fRsudo.PLUGIN_TYPE.APPROVAL\fR
+\fRsudo.PLUGIN_TYPE.APPROVAL\fR,
or
\fRsudo.PLUGIN_TYPE.IO\fR.
.sp