Document ttydev and bump plugin version to 1.22

This commit is contained in:
Todd C. Miller
2023-11-25 18:38:36 -07:00
parent a85494b5c4
commit 61dbfe0924
3 changed files with 37 additions and 11 deletions

View File

@@ -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@),

View File

@@ -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@ ,

View File

@@ -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)