aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorDavid Kaspar [Dee'Kej] <dkaspar@redhat.com>2018-05-25 20:01:54 +0200
committerDee'Kej <deekej@linuxmail.org>2018-05-30 12:32:22 +0200
commita145ddda284570e57413e37f025c3657205e17d8 (patch)
treea371338da02e38d8745964f75239c8ee62cc459b /man
parentdb1ca2fadd20d0a4fb5a0fe18adcd8c960db9cf3 (diff)
downloadinitscripts-a145ddda284570e57413e37f025c3657205e17d8.tar
initscripts-a145ddda284570e57413e37f025c3657205e17d8.tar.gz
initscripts-a145ddda284570e57413e37f025c3657205e17d8.tar.bz2
initscripts-a145ddda284570e57413e37f025c3657205e17d8.tar.xz
initscripts-a145ddda284570e57413e37f025c3657205e17d8.zip
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.
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/netreport.122
-rw-r--r--man/service.891
-rw-r--r--man/sushell.816
-rw-r--r--man/sys-unconfig.829
-rw-r--r--man/usernetctl.839
-rw-r--r--man/usleep.130
9 files changed, 319 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/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 <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
+\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 <hjl@valinux.com>
+.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 <djb@redhat.com>
+.br
+Erik Troan <ewt@redhat.com>
+.SH SEE ALSO
+sleep(1)