From 38c0bdd7ad376f53bb4013bb68a437fc84fb7142 Mon Sep 17 00:00:00 2001 From: "Todd C. Miller" Date: Wed, 26 Feb 2025 19:11:25 -0700 Subject: [PATCH] Sync sudo.DEBUG descriptions with comments in sudo_debug.h. --- docs/sudo_plugin_python.man.in | 20 ++++++++++---------- docs/sudo_plugin_python.mdoc.in | 20 ++++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/sudo_plugin_python.man.in b/docs/sudo_plugin_python.man.in index 625c1318f..7e1db174e 100644 --- a/docs/sudo_plugin_python.man.in +++ b/docs/sudo_plugin_python.man.in @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: ISC .\" .\" Copyright (c) 2019-2021 Robert Manner -.\" Copyright (c) 2019-2023 Todd C. Miller +.\" Copyright (c) 2019-2025 Todd C. Miller .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above @@ -17,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" "January 16, 2023" "Sudo @PACKAGE_VERSION@" "File Formats Manual" +.TH "SUDO_PLUGIN_PYTHON" "5" "February 26, 2025" "Sudo @PACKAGE_VERSION@" "File Formats Manual" .nh .if n .ad l .SH "NAME" @@ -1735,21 +1735,21 @@ l l l. .PP \fBsudo.conf name\fR \fBPython constant\fR \fBdescription\fR .PP -crit \fRsudo.DEBUG.CRIT\fR only critical messages +crit \fRsudo.DEBUG.CRIT\fR critical errors .PP -err \fRsudo.DEBUG.ERROR\fR +err \fRsudo.DEBUG.ERROR\fR non-critical errors .PP -warn \fRsudo.DEBUG.WARN\fR +warn \fRsudo.DEBUG.WARN\fR non-fatal warnings .PP -notice \fRsudo.DEBUG.NOTICE\fR +notice \fRsudo.DEBUG.NOTICE\fR non-error condition notices .PP -diag \fRsudo.DEBUG.DIAG\fR +diag \fRsudo.DEBUG.DIAG\fR diagnostic messages .PP -info \fRsudo.DEBUG.INFO\fR +info \fRsudo.DEBUG.INFO\fR informational message .PP -trace \fRsudo.DEBUG.TRACE\fR +trace \fRsudo.DEBUG.TRACE\fR log function enter/exit .PP -debug \fRsudo.DEBUG.DEBUG\fR very extreme verbose debugging +debug \fRsudo.DEBUG.DEBUG\fR very verbose debugging .TE .PP \fIUsing the logging module\fR diff --git a/docs/sudo_plugin_python.mdoc.in b/docs/sudo_plugin_python.mdoc.in index 5a1e73f3d..ba7cbc50f 100644 --- a/docs/sudo_plugin_python.mdoc.in +++ b/docs/sudo_plugin_python.mdoc.in @@ -2,7 +2,7 @@ .\" SPDX-License-Identifier: ISC .\" .\" Copyright (c) 2019-2021 Robert Manner -.\" Copyright (c) 2019-2023 Todd C. Miller +.\" Copyright (c) 2019-2025 Todd C. Miller .\" .\" 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 +16,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd January 16, 2023 +.Dd February 26, 2025 .Dt SUDO_PLUGIN_PYTHON @mansectform@ .Os Sudo @PACKAGE_VERSION@ .Sh NAME @@ -1403,14 +1403,14 @@ one or more messages to log .Em Available log levels: .Bl -column "name in sudo.conf" "Python constant" "only critical messages" .It Sy sudo.conf name Ta Sy Python constant Ta Sy description -.It crit Ta Dv sudo.DEBUG.CRIT Ta only critical messages -.It err Ta Dv sudo.DEBUG.ERROR Ta -.It warn Ta Dv sudo.DEBUG.WARN Ta -.It notice Ta Dv sudo.DEBUG.NOTICE Ta -.It diag Ta Dv sudo.DEBUG.DIAG Ta -.It info Ta Dv sudo.DEBUG.INFO Ta -.It trace Ta Dv sudo.DEBUG.TRACE Ta -.It debug Ta Dv sudo.DEBUG.DEBUG Ta very extreme verbose debugging +.It crit Ta Dv sudo.DEBUG.CRIT Ta critical errors +.It err Ta Dv sudo.DEBUG.ERROR Ta non-critical errors +.It warn Ta Dv sudo.DEBUG.WARN Ta non-fatal warnings +.It notice Ta Dv sudo.DEBUG.NOTICE Ta non-error condition notices +.It diag Ta Dv sudo.DEBUG.DIAG Ta diagnostic messages +.It info Ta Dv sudo.DEBUG.INFO Ta informational message +.It trace Ta Dv sudo.DEBUG.TRACE Ta log function enter/exit +.It debug Ta Dv sudo.DEBUG.DEBUG Ta very verbose debugging .El .Pp .Em Using the logging module