diff --git a/docs/sudo_plugin.man.in b/docs/sudo_plugin.man.in index c36fe0014..e61c142e1 100644 --- a/docs/sudo_plugin.man.in +++ b/docs/sudo_plugin.man.in @@ -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. .\" -.TH "SUDO_PLUGIN" "5" "July 10, 2023" "Sudo @PACKAGE_VERSION@" "File Formats Manual" +.TH "SUDO_PLUGIN" "5" "November 25, 2023" "Sudo @PACKAGE_VERSION@" "File Formats Manual" .nh .if n .ad l .SH "NAME" @@ -674,10 +674,17 @@ process or 0 if there is no terminal present. Only available starting with API version 1.2. .TP 6n tty=string -The path to the user's terminal device. -If the user has no terminal device associated with the session, -the value will be empty, as in -\(oqtty=\(cq. +The path to the user's terminal device, if one exists. +This entry is only present if the user has a terminal device +associated with the session. +.TP 6n +ttydev=dev_t +The number of the user's terminal device, if one exists, +in the form of a +\fIdev_t\fR. +This entry is only present if the user has a terminal device +associated with the session. +Only available starting with API version 1.22. .TP 6n uid=uid_t The real user-ID of the user invoking @@ -5474,6 +5481,13 @@ The entry was added to the \fIcommand_info\fR list. +.TP 6n +Version 1.22 (sudo 1.9.16) +The +\fIttydev\fR +entry was added to the +\fIuser_info\fR +list. .SH "SEE ALSO" sudo.conf(@mansectform@), sudoers(@mansectform@), diff --git a/docs/sudo_plugin.mdoc.in b/docs/sudo_plugin.mdoc.in index b604dbe00..a8cd1c776 100644 --- a/docs/sudo_plugin.mdoc.in +++ b/docs/sudo_plugin.mdoc.in @@ -15,7 +15,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd July 10, 2023 +.Dd November 25, 2023 .Dt SUDO_PLUGIN @mansectform@ .Os Sudo @PACKAGE_VERSION@ .Sh NAME @@ -600,10 +600,16 @@ device associated with the process or 0 if there is no terminal present. Only available starting with API version 1.2. .It tty=string -The path to the user's terminal device. -If the user has no terminal device associated with the session, -the value will be empty, as in -.Ql tty= . +The path to the user's terminal device, if one exists. +This entry is only present if the user has a terminal device +associated with the session. +.It ttydev=dev_t +The number of the user's terminal device, if one exists, +in the form of a +.Vt dev_t . +This entry is only present if the user has a terminal device +associated with the session. +Only available starting with API version 1.22. .It uid=uid_t The real user-ID of the user invoking .Nm sudo . @@ -4857,6 +4863,12 @@ The entry was added to the .Fa command_info list. +.It Version 1.22 (sudo 1.9.16) +The +.Em ttydev +entry was added to the +.Fa user_info +list. .El .Sh SEE ALSO .Xr sudo.conf @mansectform@ , diff --git a/include/sudo_plugin.h b/include/sudo_plugin.h index 81a68aaf0..4a68f4692 100644 --- a/include/sudo_plugin.h +++ b/include/sudo_plugin.h @@ -21,7 +21,7 @@ /* API version major/minor */ #define SUDO_API_VERSION_MAJOR 1 -#define SUDO_API_VERSION_MINOR 21 +#define SUDO_API_VERSION_MINOR 22 #define SUDO_API_MKVERSION(x, y) (((x) << 16) | (y)) #define SUDO_API_VERSION SUDO_API_MKVERSION(SUDO_API_VERSION_MAJOR, SUDO_API_VERSION_MINOR)