summaryrefslogtreecommitdiff
path: root/term-utils
diff options
context:
space:
mode:
authorMario Blättermann <mario.blaettermann@gmail.com>2022-02-13 19:26:07 +0100
committerMario Blättermann <mario.blaettermann@gmail.com>2022-02-13 19:26:07 +0100
commitbd67ca4480465487c4b94d9175ea1b84ac21be85 (patch)
tree15c2f98fee7ce74c4ea3009e7c625c79f688152e /term-utils
parent037cf48e80a08a0c04220898e6eb4dd4b326d591 (diff)
downloadutil-linux-bd67ca4480465487c4b94d9175ea1b84ac21be85.tar.gz
Fix several adoc files as reported by Helge Kreutzmann
Diffstat (limited to 'term-utils')
-rw-r--r--term-utils/agetty.8.adoc12
-rw-r--r--term-utils/script.1.adoc4
-rw-r--r--term-utils/scriptreplay.1.adoc4
3 files changed, 10 insertions, 10 deletions
diff --git a/term-utils/agetty.8.adoc b/term-utils/agetty.8.adoc
index 9274b1020..123134e09 100644
--- a/term-utils/agetty.8.adoc
+++ b/term-utils/agetty.8.adoc
@@ -76,10 +76,10 @@ If the *--nohostname* option is given, then an *-H* option is added to the */bin
See *--login-options*.
*-f*, *--issue-file* _path_::
-Specifies a ":" delimited list of files and directories to be displayed instead of _/etc/issue_ (or other). All specified files and directories are displayed, missing or empty files are silently ignored. If the specified path is a directory then display all files with .issue file extension in version-sort order from the directory. This allows custom messages to be displayed on different terminals. The *--noissue* option will override this option.
+Specifies a ":" delimited list of files and directories to be displayed instead of _/etc/issue_ (or other). All specified files and directories are displayed, missing or empty files are silently ignored. If the specified path is a directory then display all files with __.issue__ file extension in version-sort order from the directory. This allows custom messages to be displayed on different terminals. The *--noissue* option will override this option.
*--show-issue*::
-Display the current issue file (or other) on the current terminal and exit. Use this option to review the current setting, it is not designed for any other purpose. Note that output may use some default or incomplete information as proper output depends on terminal and agetty command line.
+Display the current issue file (or other) on the current terminal and exit. Use this option to review the current setting, it is not designed for any other purpose. Note that output may use some default or incomplete information as proper output depends on terminal and *agetty* command line.
*-h, --flow-control*::
Enable hardware (RTS/CTS) flow control. It is left up to the application to disable software (XON/XOFF) flow protocol where appropriate.
@@ -100,7 +100,7 @@ Do not clear the screen before prompting for the login name. By default the scre
Invoke the specified _login_program_ instead of /bin/login. This allows the use of a non-standard login program. Such a program could, for example, ask for a dial-up password or use a different password file. See *--login-options*.
*-L*, *--local-line*[=__mode__]::
-Control the CLOCAL line flag. The optional _mode_ argument is 'auto', 'always' or 'never'. If the _mode_ argument is omitted, then the default is 'always'. If the *--local-line* option is not given at all, then the default is 'auto'.
+Control the CLOCAL line flag. The optional _mode_ argument is *auto*, *always* or *never*. If the _mode_ argument is omitted, then the default is *always*. If the *--local-line* option is not given at all, then the default is *auto*.
_always_;;
Forces the line to be a local line with no need for carrier detect. This can be useful when you have a locally attached terminal where the serial line does not set the carrier-detect signal.
@@ -178,7 +178,7 @@ Sleep seconds before open tty.
Run login with this priority.
*--reload*::
-Ask all running agetty instances to reload and update their displayed prompts, if the user has not yet commenced logging in. After doing so the command will exit. This feature might be unsupported on systems without Linux *inotify*(7).
+Ask all running *agetty* instances to reload and update their displayed prompts, if the user has not yet commenced logging in. After doing so the command will exit. This feature might be unsupported on systems without Linux *inotify*(7).
include::man-common/help-version.adoc[]
@@ -212,7 +212,7 @@ ____
== SECURITY NOTICE
-If you use the *--login-program* and *--login-options* options, be aware that a malicious user may try to enter lognames with embedded options, which then get passed to the used login program. Agetty does check for a leading "-" and makes sure the logname gets passed as one parameter (so embedded spaces will not create yet another parameter), but depending on how the login binary parses the command line that might not be sufficient. Check that the used login program cannot be abused this way.
+If you use the *--login-program* and *--login-options* options, be aware that a malicious user may try to enter lognames with embedded options, which then get passed to the used login program. *agetty* does check for a leading "-" and makes sure the logname gets passed as one parameter (so embedded spaces will not create yet another parameter), but depending on how the login binary parses the command line that might not be sufficient. Check that the used login program cannot be abused this way.
Some programs use "--" to indicate that the rest of the command line should not be interpreted as options. Use this feature if available by passing "--" before the username gets passed by \u.
@@ -231,7 +231,7 @@ It is possible to review the current issue file by *agetty --show-issue* on the
The issue files may contain certain escape codes to display the system name, date, time et cetera. All escape codes consist of a backslash (\) immediately followed by one of the characters listed below.
4 or 4{_interface_}::
-Insert the IPv4 address of the specified network interface (for example: \4\{eth0}). If the _interface_ argument is not specified, then select the first fully configured (UP, non-LOCALBACK, RUNNING) interface. If not any configured interface is found, fall back to the IP address of the machine's hostname.
+Insert the IPv4 address of the specified network interface (for example: \4\{eth0}). If the _interface_ argument is not specified, then select the first fully configured (UP, non-LOCALBACK, RUNNING) interface. If no configured interface is found, fall back to the IP address of the machine's hostname.
6 or 6{_interface_}::
The same as \4 but for IPv6.
diff --git a/term-utils/script.1.adoc b/term-utils/script.1.adoc
index 957cc29c7..792136150 100644
--- a/term-utils/script.1.adoc
+++ b/term-utils/script.1.adoc
@@ -53,7 +53,7 @@ script - make typescript of terminal session
*script* makes a typescript of everything on your terminal session. The terminal data are stored in raw form to the log file and information about timing to another (optional) structured log file. The timing log file is necessary to replay the session later by *scriptreplay*(1) and to store additional information about the session.
-Since version 2.35, *script* supports multiple streams and allows the logging of input and output to separate files or all the one file. This version also supports new timing file which records additional information. The command *scriptreplay --summary* then provides all the information.
+Since version 2.35, *script* supports multiple streams and allows the logging of input and output to separate files or all the one file. This version also supports a new timing file which records additional information. The command *scriptreplay --summary* then provides all the information.
If the argument _file_ or option *--log-out* _file_ is given, *script* saves the dialogue in this _file_. If no filename is given, the dialogue is saved in the file _typescript_.
@@ -81,7 +81,7 @@ Return the exit status of the child process. Uses the same format as bash termin
//TRANSLATORS: Keep {plus} untranslated.
*-f*, *--flush*::
-Flush output after each write. This is nice for telecooperation: one person does *mkfifo foo; script -f foo*, and another can supervise in real-time what is being done using *cat foo*. Note that flush has an impact on performance; it's possible to use *SIGUSR1* to flush logs on demand.
+Flush output after each write. This is nice for telecooperation: one person does *mkfifo* _foo_; *script -f* _foo_, and another can supervise in real-time what is being done using *cat* _foo_. Note that flush has an impact on performance; it's possible to use *SIGUSR1* to flush logs on demand.
*--force*::
Allow the default output file _typescript_ to be a hard or symbolic link. The command will follow a symbolic link.
diff --git a/term-utils/scriptreplay.1.adoc b/term-utils/scriptreplay.1.adoc
index 4b3d448e3..2f4df0c53 100644
--- a/term-utils/scriptreplay.1.adoc
+++ b/term-utils/scriptreplay.1.adoc
@@ -25,7 +25,7 @@ The timing information is what *script*(1) outputs to file specified by *--log-t
By default, the typescript to display is assumed to be named _typescript_, but other filenames may be specified, as the second parameter or with option *--log-out*.
-If the third parameter or *--divisor* is specified, it is used as a speed-up multiplier. For example, a speed-up of 2 makes *scriptreplay* go twice as fast, and a speed-up of 0.1 makes it go ten times slower than the original session.
+If the third parameter or *--divisor* is specified, it is used as a speed-up multiplier. For example, a speed-up of 2 makes *scriptreplay* go twice as fast, and a speed-down of 0.1 makes it go ten times slower than the original session.
== OPTIONS
@@ -57,7 +57,7 @@ Speed up the replay displaying this _number_ of times. The argument is a floatin
Set the maximum delay between updates to _number_ of seconds. The argument is a floating-point number. This can be used to avoid long pauses in the typescript replay.
*--summary*::
-Display details about the session recorded in the specified timing file and exit. The session has to be recorded using _advanced_ format (see *script*(1)) option *--logging-format* for more details).
+Display details about the session recorded in the specified timing file and exit. The session has to be recorded using _advanced_ format (see *script*(1) option *--logging-format* for more details).
*-x*, *--stream* _type_::
Forces *scriptreplay* to print only the specified stream. The supported stream types are _in_, _out_, _signal_, or _info_. This option is recommended for multi-stream logs (e.g., *--log-io*) in order to print only specified data.