aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorOlav Vitters <olav@vitters.nl>2020-07-26 21:46:44 +0200
committerOlav Vitters <olav@vitters.nl>2020-07-26 21:46:44 +0200
commit244c9a00ae9a0dc62156aeb8781c2b22da0ad96e (patch)
treec0d76ed490862837a8a37bb61ed8e653e5cc2558 /man
parentd0d18c6de12efeba25eb41d7cf207037027e4964 (diff)
parent6ca701a23c74b245f35750149a22f7d21805a8e0 (diff)
downloadinitscripts-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.144
-rw-r--r--man/genhostid.112
-rw-r--r--man/ifup.836
-rw-r--r--man/service.891
-rw-r--r--man/usernetctl.843
-rw-r--r--man/usleep.130
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)