]> granicus.if.org Git - sudo/commitdiff
Use the term pseudo-terminal more consistently.
authorTodd C. Miller <Todd.Miller@sudo.ws>
Thu, 20 Jun 2019 22:52:49 +0000 (16:52 -0600)
committerTodd C. Miller <Todd.Miller@sudo.ws>
Thu, 20 Jun 2019 22:52:49 +0000 (16:52 -0600)
doc/sudo.conf.man.in
doc/sudo.conf.mdoc.in
doc/sudo_plugin.man.in
doc/sudo_plugin.mdoc.in
doc/sudoers.man.in
doc/sudoers.mdoc.in

index a8b3eb59ca45389eef898b4a0cb5a26a8571f769..51fde957897c19dc6c5e2dab1cb8d7b9afdd2863 100644 (file)
@@ -2,7 +2,7 @@
 .\"
 .\" SPDX-License-Identifier: ISC
 .\"
-.\" Copyright (c) 2010-2018 Todd C. Miller <Todd.Miller@sudo.ws>
+.\" Copyright (c) 2010-2019 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 +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.CONF" "@mansectform@" "October 7, 2018" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO.CONF" "@mansectform@" "June 20, 2019" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -615,7 +615,7 @@ communication with the plugin
 plugin configuration
 .TP 12n
 \fIpty\fR
-pseudo-tty related code
+pseudo-terminal related code
 .TP 12n
 \fIselinux\fR
 SELinux-specific handling
index 5416046c37342df88b26c620911d31b1850de10e..fca4bceb83f06099f5045f3dc07b08e7885400af 100644 (file)
@@ -1,7 +1,7 @@
 .\"
 .\" SPDX-License-Identifier: ISC
 .\"
-.\" Copyright (c) 2010-2018 Todd C. Miller <Todd.Miller@sudo.ws>
+.\" Copyright (c) 2010-2019 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
@@ -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 October 7, 2018
+.Dd June 20, 2019
 .Dt SUDO.CONF @mansectform@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -554,7 +554,7 @@ communication with the plugin
 .It Em plugin
 plugin configuration
 .It Em pty
-pseudo-tty related code
+pseudo-terminal related code
 .It Em selinux
 SELinux-specific handling
 .It Em util
index d9f5a91037c613ae1fc0a787440c0b99b1bd7128..f95669f4a6270a1e71e0dd26b0972b06642a10af 100644 (file)
@@ -845,8 +845,8 @@ runs a command as the foreground process as long as
 itself is running in the foreground.
 When
 \fIexec_background\fR
-is enabled and the command is being run in a pty (due to I/O logging
-or the
+is enabled and the command is being run in a pseudo-terminal
+(due to I/O logging or the
 \fIuse_pty\fR
 setting), the command will be run as a background process.
 Attempts to read from the controlling terminal (or to change terminal
@@ -867,7 +867,7 @@ has required it or not (the kernel buffers terminals so it is not possible
 to tell whether the command really wants the input).
 This is different from historic
 \fIsudo\fR
-behavior or when the command is not being run in a pty.
+behavior or when the command is not being run in a pseudo-terminal.
 .sp
 For this to work seamlessly, the operating system must support the
 automatic restarting of system calls.
@@ -1022,7 +1022,7 @@ selinux_type=string
 SELinux type to use when executing the command.
 .TP 6n
 set_utmp=bool
-Create a utmp (or utmpx) entry when a pseudo-tty is allocated.
+Create a utmp (or utmpx) entry when a pseudo-terminal is allocated.
 By default, the new entry will be a copy of the user's existing utmp
 entry (if any), with the tty, time, type and pid fields updated.
 .TP 6n
@@ -1081,12 +1081,12 @@ umask=octal
 The file creation mask to use when executing the command.
 .TP 6n
 use_pty=bool
-Allocate a pseudo-tty to run the command in, regardless of whether
+Allocate a pseudo-terminal to run the command in, regardless of whether
 or not I/O logging is in use.
 By default,
 \fBsudo\fR
 will only run
-the command in a pty when an I/O log plugin is loaded.
+the command in a pseudo-terminal when an I/O log plugin is loaded.
 .TP 6n
 utmp_user=string
 User name to use when constructing a new utmp (or utmpx) entry when
@@ -1487,7 +1487,7 @@ struct io_plugin {
 .PP
 When an I/O plugin is loaded,
 \fBsudo\fR
-runs the command in a pseudo-tty.
+runs the command in a pseudo-terminal.
 This makes it possible to log the input and output from the user's
 session.
 If any of the standard input, standard output or standard error do not
@@ -1499,7 +1499,7 @@ the I/O for logging before passing it on.
 The log_ttyin function receives the raw user input from the terminal
 device (note that this will include input even when echo is disabled,
 such as when a password is read).
-The log_ttyout function receives output from the pseudo-tty that is
+The log_ttyout function receives output from the pseudo-terminal that is
 suitable for replaying the user's session at a later time.
 The
 \fBlog_stdin\fR(),
index 74730818111f5191eb66241026f4d273b498af0c..ed91d42f572ac6d68b9660498d551158bf50fc7b 100644 (file)
@@ -748,8 +748,8 @@ runs a command as the foreground process as long as
 itself is running in the foreground.
 When
 .Em exec_background
-is enabled and the command is being run in a pty (due to I/O logging
-or the
+is enabled and the command is being run in a pseudo-terminal
+(due to I/O logging or the
 .Em use_pty
 setting), the command will be run as a background process.
 Attempts to read from the controlling terminal (or to change terminal
@@ -770,7 +770,7 @@ has required it or not (the kernel buffers terminals so it is not possible
 to tell whether the command really wants the input).
 This is different from historic
 .Em sudo
-behavior or when the command is not being run in a pty.
+behavior or when the command is not being run in a pseudo-terminal.
 .Pp
 For this to work seamlessly, the operating system must support the
 automatic restarting of system calls.
@@ -901,7 +901,7 @@ SELinux role to use when executing the command.
 .It selinux_type=string
 SELinux type to use when executing the command.
 .It set_utmp=bool
-Create a utmp (or utmpx) entry when a pseudo-tty is allocated.
+Create a utmp (or utmpx) entry when a pseudo-terminal is allocated.
 By default, the new entry will be a copy of the user's existing utmp
 entry (if any), with the tty, time, type and pid fields updated.
 .It sudoedit=bool
@@ -954,12 +954,12 @@ If non-zero then when the timeout expires the command will be killed.
 .It umask=octal
 The file creation mask to use when executing the command.
 .It use_pty=bool
-Allocate a pseudo-tty to run the command in, regardless of whether
+Allocate a pseudo-terminal to run the command in, regardless of whether
 or not I/O logging is in use.
 By default,
 .Nm sudo
 will only run
-the command in a pty when an I/O log plugin is loaded.
+the command in a pseudo-terminal when an I/O log plugin is loaded.
 .It utmp_user=string
 User name to use when constructing a new utmp (or utmpx) entry when
 .Em set_utmp
@@ -1315,7 +1315,7 @@ struct io_plugin {
 .Pp
 When an I/O plugin is loaded,
 .Nm sudo
-runs the command in a pseudo-tty.
+runs the command in a pseudo-terminal.
 This makes it possible to log the input and output from the user's
 session.
 If any of the standard input, standard output or standard error do not
@@ -1327,7 +1327,7 @@ the I/O for logging before passing it on.
 The log_ttyin function receives the raw user input from the terminal
 device (note that this will include input even when echo is disabled,
 such as when a password is read).
-The log_ttyout function receives output from the pseudo-tty that is
+The log_ttyout function receives output from the pseudo-terminal that is
 suitable for replaying the user's session at a later time.
 The
 .Fn log_stdin ,
index 9ce52bcc33658a77bb6451d730d84e99446b0008..d8be52feb9179defed7582381a6c82d670b3ca08 100644 (file)
@@ -261,7 +261,7 @@ See
 for a description of the log file format.
 .PP
 \fBsudoers\fR
-is also capable of running a command in a pseudo-tty and logging all
+is also capable of running a command in a pseudo-terminal and logging all
 input and/or output.
 The standard input, standard output and standard error can be logged
 even when not associated with a terminal.
@@ -2166,8 +2166,8 @@ runs a command as the foreground process as long as
 itself is running in the foreground.
 When the
 \fIexec_background\fR
-flag is enabled and the command is being run in a pty (due to I/O logging
-or the
+flag is enabled and the command is being run in a pseudo-terminal
+(due to I/O logging or the
 \fIuse_pty\fR
 flag), the command will be run as a background process.
 Attempts to read from the controlling terminal (or to change terminal
@@ -2188,7 +2188,7 @@ has required it or not (the kernel buffers terminals so it is not possible
 to tell whether the command really wants the input).
 This is different from historic
 \fIsudo\fR
-behavior or when the command is not being run in a pty.
+behavior or when the command is not being run in a pseudo-terminal.
 .sp
 For this to work seamlessly, the operating system must support the
 automatic restarting of system calls.
@@ -2525,7 +2525,7 @@ by default.
 log_input
 If set,
 \fBsudo\fR
-will run the command in a pseudo-tty and log all user input.
+will run the command in a pseudo-terminal and log all user input.
 If the standard input is not connected to the user's tty, due to
 I/O redirection or because the command is part of a pipeline, that
 input is also captured and stored in a separate log file.
@@ -2546,7 +2546,7 @@ by default.
 log_output
 If set,
 \fBsudo\fR
-will run the command in a pseudo-tty and log all output that is sent
+will run the command in a pseudo-terminal and log all output that is sent
 to the screen, similar to the
 script(1)
 command.
@@ -2975,16 +2975,16 @@ by default.
 set_utmp
 When enabled,
 \fBsudo\fR
-will create an entry in the utmp (or utmpx) file when a pseudo-tty
+will create an entry in the utmp (or utmpx) file when a pseudo-terminal
 is allocated.
-A pseudo-tty is allocated by
+A pseudo-terminal is allocated by
 \fBsudo\fR
-when the
+when it is running in a terminal and one or more of the
 \fIlog_input\fR,
 \fIlog_output\fR
 or
 \fIuse_pty\fR
-flags are enabled.
+flags is enabled.
 By default, the new entry will be a copy of the user's existing utmp
 entry (if any), with the tty, time, type and pid fields updated.
 This flag is
@@ -3182,7 +3182,7 @@ by default.
 use_pty
 If set, and
 \fBsudo\fR
-is running in a terminal, the command will be run in a pseudo-pty
+is running in a terminal, the command will be run in a pseudo-terminal
 (even if no I/O logging is being done).
 If the
 \fBsudo\fR
@@ -3196,7 +3196,7 @@ may be capable of injecting commands into the user's
 terminal or running a background process that retains access to the
 user's terminal device even after the main program has finished
 executing.
-By running the command in a separate pseudo-pty, this attack is
+By running the command in a separate pseudo-terminal, this attack is
 no longer possible.
 This flag is
 \fIoff\fR
@@ -4802,7 +4802,7 @@ word wrap will be disabled.
 .SH "I/O LOG FILES"
 When I/O logging is enabled,
 \fBsudo\fR
-will run the command in a pseudo-tty and log all user input and/or output,
+will run the command in a pseudo-terminal and log all user input and/or output,
 depending on which options are enabled.
 I/O is logged to the directory specified by the
 \fIiolog_dir\fR
@@ -4842,7 +4842,7 @@ input from the user's tty (what the user types)
 input from a pipe or file
 .TP 10n
 \fIttyout\fR
-output from the pseudo-tty (what the command writes to the screen)
+output from the pseudo-terminal (what the command writes to the screen)
 .TP 10n
 \fIstdout\fR
 standard output to a pipe or redirected to a file
@@ -5774,7 +5774,7 @@ The equivalent of
 for the plugin.
 .TP 10n
 \fIpty\fR
-pseudo-tty related code
+pseudo-terminal related code
 .TP 10n
 \fIrbtree\fR
 redblack tree internals
index 2df6fd27620499d4da047552408a3ebe3dc29cd2..add04fdb9225d4e72c16b6c549a0c700f225bae0 100644 (file)
@@ -251,7 +251,7 @@ See
 for a description of the log file format.
 .Pp
 .Nm sudoers
-is also capable of running a command in a pseudo-tty and logging all
+is also capable of running a command in a pseudo-terminal and logging all
 input and/or output.
 The standard input, standard output and standard error can be logged
 even when not associated with a terminal.
@@ -2032,8 +2032,8 @@ runs a command as the foreground process as long as
 itself is running in the foreground.
 When the
 .Em exec_background
-flag is enabled and the command is being run in a pty (due to I/O logging
-or the
+flag is enabled and the command is being run in a pseudo-terminal
+(due to I/O logging or the
 .Em use_pty
 flag), the command will be run as a background process.
 Attempts to read from the controlling terminal (or to change terminal
@@ -2054,7 +2054,7 @@ has required it or not (the kernel buffers terminals so it is not possible
 to tell whether the command really wants the input).
 This is different from historic
 .Em sudo
-behavior or when the command is not being run in a pty.
+behavior or when the command is not being run in a pseudo-terminal.
 .Pp
 For this to work seamlessly, the operating system must support the
 automatic restarting of system calls.
@@ -2376,7 +2376,7 @@ by default.
 .It log_input
 If set,
 .Nm sudo
-will run the command in a pseudo-tty and log all user input.
+will run the command in a pseudo-terminal and log all user input.
 If the standard input is not connected to the user's tty, due to
 I/O redirection or because the command is part of a pipeline, that
 input is also captured and stored in a separate log file.
@@ -2396,7 +2396,7 @@ by default.
 .It log_output
 If set,
 .Nm sudo
-will run the command in a pseudo-tty and log all output that is sent
+will run the command in a pseudo-terminal and log all output that is sent
 to the screen, similar to the
 .Xr script 1
 command.
@@ -2800,16 +2800,16 @@ by default.
 .It set_utmp
 When enabled,
 .Nm sudo
-will create an entry in the utmp (or utmpx) file when a pseudo-tty
+will create an entry in the utmp (or utmpx) file when a pseudo-terminal
 is allocated.
-A pseudo-tty is allocated by
+A pseudo-terminal is allocated by
 .Nm sudo
-when the
+when it is running in a terminal and one or more of the
 .Em log_input ,
 .Em log_output
 or
 .Em use_pty
-flags are enabled.
+flags is enabled.
 By default, the new entry will be a copy of the user's existing utmp
 entry (if any), with the tty, time, type and pid fields updated.
 This flag is
@@ -2994,7 +2994,7 @@ by default.
 .It use_pty
 If set, and
 .Nm sudo
-is running in a terminal, the command will be run in a pseudo-pty
+is running in a terminal, the command will be run in a pseudo-terminal
 (even if no I/O logging is being done).
 If the
 .Nm sudo
@@ -3008,7 +3008,7 @@ may be capable of injecting commands into the user's
 terminal or running a background process that retains access to the
 user's terminal device even after the main program has finished
 executing.
-By running the command in a separate pseudo-pty, this attack is
+By running the command in a separate pseudo-terminal, this attack is
 no longer possible.
 This flag is
 .Em off
@@ -4474,7 +4474,7 @@ word wrap will be disabled.
 .Sh I/O LOG FILES
 When I/O logging is enabled,
 .Nm sudo
-will run the command in a pseudo-tty and log all user input and/or output,
+will run the command in a pseudo-terminal and log all user input and/or output,
 depending on which options are enabled.
 I/O is logged to the directory specified by the
 .Em iolog_dir
@@ -4512,7 +4512,7 @@ input from the user's tty (what the user types)
 .It Pa stdin
 input from a pipe or file
 .It Pa ttyout
-output from the pseudo-tty (what the command writes to the screen)
+output from the pseudo-terminal (what the command writes to the screen)
 .It Pa stdout
 standard output to a pipe or redirected to a file
 .It Pa stderr
@@ -5349,7 +5349,7 @@ The equivalent of
 .Em main
 for the plugin.
 .It Em pty
-pseudo-tty related code
+pseudo-terminal related code
 .It Em rbtree
 redblack tree internals
 .It Em sssd