From a145ddda284570e57413e37f025c3657205e17d8 Mon Sep 17 00:00:00 2001 From: "David Kaspar [Dee'Kej]" Date: Fri, 25 May 2018 20:01:54 +0200 Subject: Repository scheme updated to new layout NOTE: This commit just moves files around, without actually fixing the Makefiles and specfile. See follow up commits which resolve this. --- man/consoletype.1 | 44 ++++++++++++++++++++++++++ man/genhostid.1 | 12 +++++++ man/ifup.8 | 36 +++++++++++++++++++++ man/netreport.1 | 22 +++++++++++++ man/service.8 | 91 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ man/sushell.8 | 16 ++++++++++ man/sys-unconfig.8 | 29 +++++++++++++++++ man/usernetctl.8 | 39 +++++++++++++++++++++++ man/usleep.1 | 30 ++++++++++++++++++ 9 files changed, 319 insertions(+) create mode 100644 man/consoletype.1 create mode 100644 man/genhostid.1 create mode 100644 man/ifup.8 create mode 100644 man/netreport.1 create mode 100644 man/service.8 create mode 100644 man/sushell.8 create mode 100644 man/sys-unconfig.8 create mode 100644 man/usernetctl.8 create mode 100644 man/usleep.1 (limited to 'man') diff --git a/man/consoletype.1 b/man/consoletype.1 new file mode 100644 index 00000000..ebd1d88c --- /dev/null +++ b/man/consoletype.1 @@ -0,0 +1,44 @@ +.TH CONSOLETYPE 1 "Red Hat, Inc" "RH" \" -*- nroff -*- +.SH NAME +\fBconsoletype +\- print type of the console connected to standard input +.SH SYNOPSIS +\fBconsoletype [\fIstdout\fR] [\fIfg\fR] +.SH DESCRIPTION +\fBconsoletype +prints the type of console connected to standard input, and checks +whether the console connected to standard input is the current +foreground virtual console. With no arguments, it prints +\fIvt\fR +if console is a virtual terminal (/dev/tty* or /dev/console device if not on +a serial console), +\fIserial\fR +if standard input is a serial console (/dev/console or /dev/ttyS*) and +\fIpty\fR +if standard input is a pseudo terminal. +.SH RETURN VALUE +\fBconsoletype +when passed no arguments returns +.TP +\fI0 +if on virtual terminal +.TP +\fI1 +if on serial console +.TP +\fI2 +if on a pseudo terminal. +.TP +When passed the \fIstdout\fR argument, \fBconsoletype\fR returns +.TP +\fI0 +in all cases, and prints the console type to stdout. +.TP +When passed the \fIfg\fR argument, \fBconsoletype\fR returns +.TP +\fI0 +if the console connected to standard input is the current virtual +terminal +.TP +\fI1 +otherwise. diff --git a/man/genhostid.1 b/man/genhostid.1 new file mode 100644 index 00000000..436d9537 --- /dev/null +++ b/man/genhostid.1 @@ -0,0 +1,12 @@ +.TH GENHOSTID 1 +.SH NAME +genhostid \- generate and set a hostid for the current host +.SH SYNOPSIS +.B genhostid + +.SH DESCRIPTION +\fBgenhostid\fR generates a random hostid and stores it in /etc/hostid, +if /etc/hostid does not already exist. + +.SH "SEE ALSO" +hostid(1), gethostid(2), sethostid(2) diff --git a/man/ifup.8 b/man/ifup.8 new file mode 100644 index 00000000..1cf1fcd8 --- /dev/null +++ b/man/ifup.8 @@ -0,0 +1,36 @@ +.\" Copyright 2009 Petr Lautrbach (plautrba@redhat.com) +.TH ifup 8 2009-10-27 "" "System Administration tools and Daemons" +.SH NAME +ifup - bring a network interface up + +ifdown - take a network interface down +.SH SYNOPSIS +.B ifup CONFIG [boot] + +.B ifdown CONFIG + +.SH DESCRIPTION +The +.B ifup +and +.B ifdown +commands may be used to configure (or, respec- +tively, deconfigure) network interfaces based on interface definitions +in the files /etc/sysconfig/network and /etc/sysconfig/network-scripts/ifcfg- + +These scripts take one argument normally: the name of the configuration +(e.g. eth0). They are called with a second argument of "boot" +during the boot sequence so that devices that are not meant to +be brought up on boot (ONBOOT=no, see below) can be ignored at +that time. + +.SH FILES +.TP +\fB/etc/sysconfig/network\fR + +.TP +\fB/etc/sysconfig/network-scripts/ifcfg-\fR +The file defining an interface. + +.SH "SEE ALSO" +/usr/share/doc/initscripts-*/sysconfig.txt diff --git a/man/netreport.1 b/man/netreport.1 new file mode 100644 index 00000000..75ed0747 --- /dev/null +++ b/man/netreport.1 @@ -0,0 +1,22 @@ +.TH NETREPORT 1 "Red Hat, Inc." "RH" \" -*- nroff -*- +.SH NAME +netreport \- request notification of network interface changes +.SH SYNOPSIS +.B netreport +\fI[\fP-r\fI]\fP +.SH DESCRIPTION +.B netreport +tells the network management scripts to send a SIGIO signal +to the process which called netreport when any network interface +status changes occur. +.SH OPTIONS +.TP +.B -r +Remove the current request (if any) for the calling process. +.PP +.SH NOTES +If a program does not call netreport with the +.B -r +option before it exits, and another process is created with the +same PID before any changes take place in interface status, it +is possible that the new process will receive a spurious SIGIO. diff --git a/man/service.8 b/man/service.8 new file mode 100644 index 00000000..2cd0c039 --- /dev/null +++ b/man/service.8 @@ -0,0 +1,91 @@ +.\" A man page for service(8). -*- nroff -*- +.\" +.\" Copyright (C) 2006 Red Hat, Inc. All rights reserved. +.\" +.\" This copyrighted material is made available to anyone wishing to use, +.\" modify, copy, or redistribute it subject to the terms and conditions of the +.\" GNU General Public License v.2. +.\" +.\" This program is distributed in the hope that it will be useful, but WITHOUT +.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for +.\" more details. +.\" +.\" You should have received a copy of the GNU General Public License along +.\" with this program; if not, write to the Free Software Foundation, Inc., +.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. +.\" +.\" Author: Miloslav Trmac +.TH service 8 "Jan 2006" + +.SH NAME +service \- run a System V init script + +.SH SYNOPSIS +\fBservice\fR \fISCRIPT\fR \fICOMMAND\fR [\fIOPTIONS\fR] + +\fBservice \-\-status\-all\fR + +\fBservice\fR \fB\-\-help\fR | \fB\-h\fR | \fB\-\-version\fR + +.SH DESCRIPTION +.B service +runs a System V init script in as predictable environment as possible, +removing most environment variables +and with current working directory set to \fB/\fR. + +The +.I SCRIPT +parameter specifies a System V init script, +located in \fB/etc/init.d/\fISCRIPT\fR. +The supported values of +.I COMMAND +depend on the invoked script, +.B service +passes +.I COMMAND +and +.I OPTIONS +it to the init script unmodified. +All scripts should support at least the +.B start +and +.B stop +commands. +As a special case, if +.I COMMAND +is \fB\-\-full-restart\fR, the script is run twice, first with the +.B stop +command, then with the +.B start +command. + +.B service \-\-status\-all +runs all init scripts, in alphabetical order, with the +.B status +command. + +If the init script file does not exist, the script tries to use +.B legacy actions. +If there is no suitable legacy action found and +.I COMMAND +is one of actions specified in LSB Core Specification, input is redirected to the +.B systemctl. +Otherwise the command fails with return code 2. + +.SH FILES +.TP +\fB/etc/init.d\fR +The directory containing System V init scripts. + +.SH ENVIRONMENT +.TP +\fBLANG\fR, \fBTERM\fR +The only environment variables passed to the init scripts. + +.SH SEE ALSO +.BR chkconfig (8), +.BR ntsysv(8), +.BR systemd (1), +.BR systemctl (8), +.BR systemd.service (5) diff --git a/man/sushell.8 b/man/sushell.8 new file mode 100644 index 00000000..9832a732 --- /dev/null +++ b/man/sushell.8 @@ -0,0 +1,16 @@ +.TH SUSHELL 8 "Red Hat, Inc" \" -*- nroff -*- +.SH NAME +sushell \- execute the single-user shell +.SH SYNOPSIS +.B sushell +.SH DESCRIPTION +.B sushell +executes the single-user shell. By default, this is +\fI/bin/bash\fP +This can be configured via the +.B SUSHELL +environment variable. +.SH NOTES +.B sushell +is an implementation detail, required for proper SELinux +usage. It is not intended to be run regularly. diff --git a/man/sys-unconfig.8 b/man/sys-unconfig.8 new file mode 100644 index 00000000..9edc1068 --- /dev/null +++ b/man/sys-unconfig.8 @@ -0,0 +1,29 @@ +.TH SYS-UNCONFIG 8 "Wed Jul 28 1999" +.SH NAME +sys-unconfig \- shell script to reconfigure the system upon next boot +.SH SYNOPSIS +\fBsys-unconfig\fR +.SH DESCRIPTION +\fBsys-unconfig\fR provides a simple method of reconfiguring a system +in a new environment. Upon executing sys-unconfig will poweroff your +system, and run firstboot at next boot. + +.SH FILES +.PD 0 +.TP 20 +\fI/.unconfigured\fR +The presence of this file will trigger firsboot. + +.SH NOTES +.PD +This utility should not be used for creating cloud or virtual machine images. +For that use please see \fBvirt-sysprep\fP. + +.PD +.SH "SEE ALSO" +.BR virt-sysprep(1) + +.SH AUTHORS +.nf +H.J. Lu +.fi diff --git a/man/usernetctl.8 b/man/usernetctl.8 new file mode 100644 index 00000000..2fb84da1 --- /dev/null +++ b/man/usernetctl.8 @@ -0,0 +1,39 @@ +.TH USERNETCTL 8 "Red Hat, Inc." "RHS" \" -*- nroff -*- +.SH NAME +usernetctl \- allow a user to manipulate a network interface if permitted +.SH SYNOPSIS +.B usernetctl +\fIinterface-name\fP up\fI|\fPdown\fI|\fPreport +.SH DESCRIPTION +.B usernetctl +checks to see if users are allowed to manipulate the network interface +specified by \fIinterface-name\fP, and then tries to bring the network +interface up or down, if up or down was specified on the command line, +or returns true or false status (respectively) if the report option was +specified. + +.B usernetctl +is not really meant to be called directly by users, though it currently +works fine that way. It is used as a wrapper by the ifup and ifdown +scripts, so that users can do exactly the same thing as root: +.nf +ifup \fIinterface-name\fP +ifdown \fIinterface-name\fP +.fi +and \fBifup\fP and \fBifdown\fP will call usernetctl automatically to +allow the interface status change. +.SH OPTIONS +.TP +.I "\fIinterface-name" +The name of the network interface to check; for example, "ppp0". For +backwards compatibility, "ifcfg-ppp0" and +"/etc/sysconfig/network-scripts/ifcfg-ppp0" are also supported. +.TP +up\fI|\fPdown +Attempt to bring the interface up or down. +.TP +report +Report on whether users can bring the interface up or down. +.SH NOTES +Alternate device configurations may inherit the default configuration's +permissions. diff --git a/man/usleep.1 b/man/usleep.1 new file mode 100644 index 00000000..30db2bad --- /dev/null +++ b/man/usleep.1 @@ -0,0 +1,30 @@ +.TH USLEEP 1 "Red Hat, Inc" \" -*- nroff -*- +.SH NAME +usleep \- sleep some number of microseconds +.SH SYNOPSIS +.B usleep +[\fInumber\fP] +.SH DESCRIPTION +.B usleep +sleeps some number of microseconds. The default is 1. +.SH WARNING +.B usleep +has been deprecated, and will be removed in near future. Use sleep(1) instead. +.SH OPTIONS +\fI--usage\fP +Show short usage message. +.TP +\fI--help, -?\fP +Print help information. +.TP +\fI-v, --version\fP +Print version information. +.SH BUGS +Probably not accurate on many machines down to the microsecond. Count +on precision only to -4 or maybe -5. +.SH AUTHOR +Donald Barnes +.br +Erik Troan +.SH SEE ALSO +sleep(1) -- cgit v1.2.1 From 1d59acacb69f33688843779a396a6c6ff25380d3 Mon Sep 17 00:00:00 2001 From: "David Kaspar [Dee'Kej]" Date: Thu, 17 May 2018 16:22:41 +0200 Subject: sys-unconfig removed This script has been obsoleted by other concepts in Fedora, and using it can be quite dangerous nowadays... --- man/sys-unconfig.8 | 29 ----------------------------- 1 file changed, 29 deletions(-) delete mode 100644 man/sys-unconfig.8 (limited to 'man') diff --git a/man/sys-unconfig.8 b/man/sys-unconfig.8 deleted file mode 100644 index 9edc1068..00000000 --- a/man/sys-unconfig.8 +++ /dev/null @@ -1,29 +0,0 @@ -.TH SYS-UNCONFIG 8 "Wed Jul 28 1999" -.SH NAME -sys-unconfig \- shell script to reconfigure the system upon next boot -.SH SYNOPSIS -\fBsys-unconfig\fR -.SH DESCRIPTION -\fBsys-unconfig\fR provides a simple method of reconfiguring a system -in a new environment. Upon executing sys-unconfig will poweroff your -system, and run firstboot at next boot. - -.SH FILES -.PD 0 -.TP 20 -\fI/.unconfigured\fR -The presence of this file will trigger firsboot. - -.SH NOTES -.PD -This utility should not be used for creating cloud or virtual machine images. -For that use please see \fBvirt-sysprep\fP. - -.PD -.SH "SEE ALSO" -.BR virt-sysprep(1) - -.SH AUTHORS -.nf -H.J. Lu -.fi -- cgit v1.2.1 From dd0ded99ccc12aebe1372e04771711bf993182b9 Mon Sep 17 00:00:00 2001 From: "David Kaspar [Dee'Kej]" Date: Fri, 18 May 2018 17:27:54 +0200 Subject: src/sushell moved into 'policycoreutils' package It has been agreed that maintainers of 'policycoreutils' will either accept the pull-request, or they will close it if the sushell is no longer needed... --- man/sushell.8 | 16 ---------------- 1 file changed, 16 deletions(-) delete mode 100644 man/sushell.8 (limited to 'man') diff --git a/man/sushell.8 b/man/sushell.8 deleted file mode 100644 index 9832a732..00000000 --- a/man/sushell.8 +++ /dev/null @@ -1,16 +0,0 @@ -.TH SUSHELL 8 "Red Hat, Inc" \" -*- nroff -*- -.SH NAME -sushell \- execute the single-user shell -.SH SYNOPSIS -.B sushell -.SH DESCRIPTION -.B sushell -executes the single-user shell. By default, this is -\fI/bin/bash\fP -This can be configured via the -.B SUSHELL -environment variable. -.SH NOTES -.B sushell -is an implementation detail, required for proper SELinux -usage. It is not intended to be run regularly. -- cgit v1.2.1 From 9b2dbe00100d4e1077404b9d781f35adad979467 Mon Sep 17 00:00:00 2001 From: "David Kaspar [Dee'Kej]" Date: Thu, 24 May 2018 16:06:03 +0200 Subject: netreport functionality dropped This concept is quite outdated, and not sane to use at all. --- man/netreport.1 | 22 ---------------------- 1 file changed, 22 deletions(-) delete mode 100644 man/netreport.1 (limited to 'man') diff --git a/man/netreport.1 b/man/netreport.1 deleted file mode 100644 index 75ed0747..00000000 --- a/man/netreport.1 +++ /dev/null @@ -1,22 +0,0 @@ -.TH NETREPORT 1 "Red Hat, Inc." "RH" \" -*- nroff -*- -.SH NAME -netreport \- request notification of network interface changes -.SH SYNOPSIS -.B netreport -\fI[\fP-r\fI]\fP -.SH DESCRIPTION -.B netreport -tells the network management scripts to send a SIGIO signal -to the process which called netreport when any network interface -status changes occur. -.SH OPTIONS -.TP -.B -r -Remove the current request (if any) for the calling process. -.PP -.SH NOTES -If a program does not call netreport with the -.B -r -option before it exits, and another process is created with the -same PID before any changes take place in interface status, it -is possible that the new process will receive a spurious SIGIO. -- cgit v1.2.1 From 1fcae34d2fadb0ec46bd26b086b82ebefe033f65 Mon Sep 17 00:00:00 2001 From: Jan Macku Date: Wed, 21 Aug 2019 10:45:06 +0200 Subject: Fix bug in service(8) --- man/service.8 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'man') diff --git a/man/service.8 b/man/service.8 index 2cd0c039..ca9e833c 100644 --- a/man/service.8 +++ b/man/service.8 @@ -80,7 +80,7 @@ The directory containing System V init scripts. .SH ENVIRONMENT .TP -\fBLANG\fR, \fBTERM\fR +\fBPATH\fR, \fBTERM\fR The only environment variables passed to the init scripts. .SH SEE ALSO -- cgit v1.2.1