diff options
author | Olav Vitters <olav@vitters.nl> | 2020-07-26 21:46:44 +0200 |
---|---|---|
committer | Olav Vitters <olav@vitters.nl> | 2020-07-26 21:46:44 +0200 |
commit | 244c9a00ae9a0dc62156aeb8781c2b22da0ad96e (patch) | |
tree | c0d76ed490862837a8a37bb61ed8e653e5cc2558 /man | |
parent | d0d18c6de12efeba25eb41d7cf207037027e4964 (diff) | |
parent | 6ca701a23c74b245f35750149a22f7d21805a8e0 (diff) | |
download | initscripts-244c9a00ae9a0dc62156aeb8781c2b22da0ad96e.tar initscripts-244c9a00ae9a0dc62156aeb8781c2b22da0ad96e.tar.gz initscripts-244c9a00ae9a0dc62156aeb8781c2b22da0ad96e.tar.bz2 initscripts-244c9a00ae9a0dc62156aeb8781c2b22da0ad96e.tar.xz initscripts-244c9a00ae9a0dc62156aeb8781c2b22da0ad96e.zip |
Merge tag '10.04' into distro/mga
10.04 release
Diffstat (limited to 'man')
-rw-r--r-- | man/consoletype.1 | 44 | ||||
-rw-r--r-- | man/genhostid.1 | 12 | ||||
-rw-r--r-- | man/ifup.8 | 36 | ||||
-rw-r--r-- | man/service.8 | 91 | ||||
-rw-r--r-- | man/usernetctl.8 | 43 | ||||
-rw-r--r-- | man/usleep.1 | 30 |
6 files changed, 256 insertions, 0 deletions
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-<configuration> + +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-<configuration>\fR +The file defining an interface. + +.SH "SEE ALSO" +/usr/share/doc/initscripts-*/sysconfig.txt diff --git a/man/service.8 b/man/service.8 new file mode 100644 index 00000000..ca9e833c --- /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 <mitr@redhat.com> +.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 +\fBPATH\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/usernetctl.8 b/man/usernetctl.8 new file mode 100644 index 00000000..ebf86e1a --- /dev/null +++ b/man/usernetctl.8 @@ -0,0 +1,43 @@ +.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 FILES +.IR /etc/sysconfig/network-scripts/ifcfg-* + +.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 <djb@redhat.com> +.br +Erik Troan <ewt@redhat.com> +.SH SEE ALSO +sleep(1) |