mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
man: Use CR for constant width font
With version 1.23 groff/troff disabled the non-portable font CW and started to complain about a missing CW font when previewing some of the man pages, with messages like $ man --warnings cpumf/man/pai.8 > /dev/null troff:<standard input>:244: warning: cannot select font 'CW' Use CR to replace CW. Closes: https://github.com/ibm-s390-linux/s390-tools/pull/187 [hoeppner@linux.ibm.com: Adapt commit message] Signed-off-by: Dan Horák <dan@danny.cz> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
This commit is contained in:
@@ -66,7 +66,7 @@ terminal application
|
||||
To connect to the first z/VM IUCV HVC terminal device on the z/VM guest virtual
|
||||
machine "LNX1234", run:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvconn LNX1234 lnxhvc0
|
||||
@@ -215,7 +215,7 @@ For each HVC terminal device, a \fBgetty\fP program must be started.
|
||||
To configure and start \fBgetty\fP on a HVC terminal, open
|
||||
.BR /etc/inittab (5),
|
||||
and add a new entry similar to this one:
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
|
||||
@@ -261,7 +261,7 @@ IUCV HVC terminal:
|
||||
.IP "1." 4
|
||||
To display the current terminal name, issue the command:
|
||||
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
user@host:~$ echo $TERM
|
||||
@@ -275,7 +275,7 @@ To connect to a z/VM IUCV HVC terminal, run
|
||||
.BR iucvconn (1)
|
||||
and log in as usual:
|
||||
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
user@host:~$ iucvconn MYLNX01 lnxhvc0
|
||||
@@ -289,7 +289,7 @@ user@MYLNX01:~$
|
||||
To assign the terminal name from step 1. to the terminal environment variable,
|
||||
issue the following command:
|
||||
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
user@MYLNX01:~$ export TERM=xterm
|
||||
@@ -304,7 +304,7 @@ environment variable.
|
||||
.PP
|
||||
For getty programs, a sample terminal environment configuration might look like:
|
||||
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
h0:2345:respawn:/sbin/agetty -L 9600 hvc0 linux
|
||||
|
||||
@@ -123,7 +123,7 @@ the characters to the connected terminal.
|
||||
To access the "lnxterm" terminal on the Linux instance in
|
||||
z/VM guest virtual machine LNXSYS01:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvconn LNXSYS01 lnxterm
|
||||
@@ -134,7 +134,7 @@ iucvconn LNXSYS01 lnxterm
|
||||
To access the first z/VM IUCV HVC terminal on the Linux instance in
|
||||
z/VM guest virtual machine LNXSYS02:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvconn LNXSYS02 lnxhvc0
|
||||
@@ -145,7 +145,7 @@ iucvconn LNXSYS02 lnxhvc0
|
||||
To create a transcript of the terminal session to the Linux instance in
|
||||
z/VM guest virtual machine LNXSYS99:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvconn -s ~/transcripts/lnxsys99 LNXSYS99 lnxhvc0
|
||||
|
||||
@@ -94,7 +94,7 @@ additional options.
|
||||
.SH EXAMPLES
|
||||
To allow remote logins using the terminal identifier "lnxterm":
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvtty lnxterm
|
||||
@@ -104,7 +104,7 @@ iucvtty lnxterm
|
||||
|
||||
To only allow users from LNXSYS01 to connect to terminal "lnxterm":
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvtty -a LNXSYS01 lnxterm
|
||||
@@ -115,7 +115,7 @@ iucvtty -a LNXSYS01 lnxterm
|
||||
To only allow users from LNXSYS10 through LNXSYS19 to connect to terminal
|
||||
"lnxterm":
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvtty -a "LNXSYS1[0-9]" lnxterm
|
||||
@@ -125,7 +125,7 @@ iucvtty -a "LNXSYS1[0-9]" lnxterm
|
||||
|
||||
To use \fB/sbin/sulogin\fP instead of \fB/bin/login\fP for terminal "suterm":
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
iucvtty suterm -- /sbin/sulogin
|
||||
@@ -136,7 +136,7 @@ iucvtty suterm -- /sbin/sulogin
|
||||
An entry in \fB/etc/inittab\fP to facilitate user logins on terminal "lnxterm"
|
||||
with \fB/bin/login\fP could be:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
t1:2345:respawn:/usr/bin/iucvtty lnxterm
|
||||
@@ -147,7 +147,7 @@ t1:2345:respawn:/usr/bin/iucvtty lnxterm
|
||||
An entry in \fB/etc/inittab\fP to facilitate user logins on terminal "suterm"
|
||||
with \fB/sbin/sulogin\fP in single user mode could be:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
s1:S:respawn:/usr/bin/iucvtty suterm -- /sbin/sulogin
|
||||
|
||||
@@ -79,7 +79,7 @@ users".
|
||||
|
||||
The output for "list" authorization is a list of z/VM guest virtual machines,
|
||||
for example:
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25i
|
||||
.nf
|
||||
|
||||
@@ -94,7 +94,7 @@ guest5
|
||||
.ft
|
||||
The output for "regex" authorization is a list of one or more
|
||||
regular expressions, for example:
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25i
|
||||
.nf
|
||||
|
||||
@@ -109,7 +109,7 @@ Regular expressions for your authorization:
|
||||
If \fBts-shell\fP is configured to connect to particular z/VM guest virtual
|
||||
machines only, the output for "regex" authorization is followed by a list of
|
||||
the user IDs that match at least one of the regular expressions:
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25i
|
||||
.nf
|
||||
|
||||
@@ -139,7 +139,7 @@ To change the default terminal identifier, use the \fBterminal\fP command.
|
||||
|
||||
In the following example, a user opens a terminal connection to the Linux
|
||||
instance in z/VM guest virtual machine LNXSYS01:
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25i
|
||||
.nf
|
||||
|
||||
@@ -164,7 +164,7 @@ If \fBterminal\fP is called with the \fIidentifier\fP being specified,
|
||||
If \fIidentifier\fP is not specified, the current default terminal identifier
|
||||
is displayed:
|
||||
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25i
|
||||
.nf
|
||||
user@ts-shell> terminal
|
||||
@@ -212,7 +212,7 @@ guest virtual machines.
|
||||
A typical \fBIUCV\fP authorization statement in the z/VM directory entry of the
|
||||
terminal server z/VM guest virtual machine might be:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
IUCV ANY
|
||||
@@ -301,7 +301,7 @@ instance.
|
||||
|
||||
For example, to create a list of all z/VM guest virtual machines with names that
|
||||
start with "LINUX" and are followed by digits, use:
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
|
||||
@@ -373,7 +373,7 @@ group name and prefixed with "@".
|
||||
|
||||
Here is an example of a Linux user and group authorization:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
alice = list:guest01,guest02
|
||||
@@ -395,7 +395,7 @@ name on a separate line.
|
||||
.PP
|
||||
The following example shows the usage of the \fIfile:\fP prefix:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
@testgrp = file:/etc/iucvterm/auth/test-systems.list
|
||||
@@ -427,7 +427,7 @@ To authorize user bob for all z/VM guest virtual machines with names that
|
||||
start with "lnx" and are followed with at least three but not more than five
|
||||
alphanumeric characters, use:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
bob = regex:lnx\\w{3,5}
|
||||
@@ -441,7 +441,7 @@ test or production environment: authorize all users in the "testgrp" group for
|
||||
all systems in the test environment; and respectively, authorize all users in
|
||||
the "prodgrp" group for all systems in the production environment:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
@testgrp = regex:test\\w+
|
||||
@@ -461,7 +461,7 @@ of the other type are ignored.
|
||||
|
||||
Example:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
@users = list:guest01,guest03,guest05
|
||||
@@ -484,7 +484,7 @@ To use the \fBts-shell\fP as the login shell for Linux users, follow these steps
|
||||
Add the path of the \fBts-shell\fP program to the \fI/etc/shells\fP file that
|
||||
contains the list of valid login shells:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
echo $(which ts-shell) >> /etc/shells
|
||||
@@ -498,7 +498,7 @@ Change the login shell of a particular Linux user using the
|
||||
.BR chsh (1)
|
||||
program:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
chsh -s $(which ts-shell) alice
|
||||
|
||||
@@ -116,7 +116,7 @@ specifies an exit status in this range.
|
||||
.SS inittab
|
||||
To start \fB/sbin/agetty\fP on terminal device "hvc1", specify:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
h1:2345:respawn:/sbin/\*s hvc1 /sbin/agetty -L 9600 %t linux
|
||||
@@ -128,7 +128,7 @@ h1:2345:respawn:/sbin/\*s hvc1 /sbin/agetty -L 9600 %t linux
|
||||
To start \fB/sbin/agetty\fP on terminal device "hvc1", add the following
|
||||
settings to the job file:
|
||||
.PP
|
||||
.ft CW
|
||||
.ft CR
|
||||
.in +0.25in
|
||||
.nf
|
||||
respawn
|
||||
|
||||
Reference in New Issue
Block a user