summaryrefslogtreecommitdiffstats
path: root/sbin
diff options
context:
space:
mode:
authormpp <mpp@FreeBSD.org>1996-04-08 04:18:31 +0000
committermpp <mpp@FreeBSD.org>1996-04-08 04:18:31 +0000
commit3c57dc77537bfff8a25b061e147f5a1194613a28 (patch)
tree78fa3bb3a263f5518e1eaa6bea101b7b19200ce5 /sbin
parentcdc4afc0a8a13743387100d7e5e163b1dcd87323 (diff)
downloadFreeBSD-src-3c57dc77537bfff8a25b061e147f5a1194613a28.zip
FreeBSD-src-3c57dc77537bfff8a25b061e147f5a1194613a28.tar.gz
Correct some man page xrefs, and some other minor changes to bring some
man pages up to mdoc guidelines and fix some minor formatting glitches. Also fixed a number of man pages to not abuse the .Xr macro to display functions and path names and a lot of other junk.
Diffstat (limited to 'sbin')
-rw-r--r--sbin/init/init.834
-rw-r--r--sbin/ldconfig/ldconfig.824
2 files changed, 29 insertions, 29 deletions
diff --git a/sbin/init/init.8 b/sbin/init/init.8
index 50caf0c..7618468 100644
--- a/sbin/init/init.8
+++ b/sbin/init/init.8
@@ -133,14 +133,14 @@ processes for the terminal ports found in the file
reads this file, and executes the command found in the second field.
This command is usually
.Xr getty 8 ;
-.Xr getty
+.Nm getty
opens and initializes the tty line
and
executes the
-.Xr login
+.Xr login 1
program.
The
-.Xr login
+.Nm login
program, when a valid user logs in,
executes a shell for that user. When this shell
dies, either because the user logged out
@@ -151,18 +151,18 @@ program wakes up, deletes the user
from the
.Xr utmp 5
file of current users and records the logout in the
-.Xr wtmp
+.Xr wtmp 5
file.
The cycle is
then restarted by
.Nm init
executing a new
-.Xr getty
+.Nm getty
for the line.
.Pp
Line status (on, off, secure, getty, or window information)
may be changed in the
-.Xr ttys
+.Xr ttys 5
file without a reboot by sending the signal
.Dv SIGHUP
to
@@ -172,19 +172,19 @@ with the command
On receipt of this signal,
.Nm init
re-reads the
-.Xr ttys
+.Xr ttys 5
file.
When a line is turned off in
-.Xr ttys ,
+.Xr ttys 5 ,
.Nm init
will send a SIGHUP signal to the controlling process
for the session associated with the line.
For any lines that were previously turned off in the
-.Xr ttys
+.Xr ttys 5
file and are now on,
.Nm init
executes a new
-.Xr getty
+.Nm getty
to enable a new login.
If the getty or window field for a line is changed,
the change takes effect at the end of the current
@@ -192,14 +192,14 @@ login session (e.g., the next time
.Nm init
starts a process on the line).
If a line is commented out or deleted from
-.Xr ttys ,
+.Xr ttys 5 ,
.Nm init
will not do anything at all to that line.
However, it will complain that the relationship between lines
in the
-.Xr ttys
+.Xr ttys 5
file and records in the
-.Xr utmp
+.Xr utmp 5
file is out of sync,
so this practice is not recommended.
.Pp
@@ -211,13 +211,13 @@ signal, for example,
.Dq Li "kill \-TERM 1" .
If there are processes outstanding that are deadlocked (because of
hardware or software failure),
-.Xr init
+.Nm init
will not wait for them all to die (which might take forever), but
will time out after 30 seconds and print a warning message.
.Pp
.Nm Init
will cease creating new
-.Xr getty Ns 's
+.Nm getty Ns 's
and allow the system to slowly die away, if it is sent a terminal stop
.Pq Dv TSTP
signal, i.e.
@@ -243,7 +243,7 @@ The role of
is so critical that if it dies, the system will reboot itself
automatically.
If, at bootstrap time, the
-.Xr init
+.Nm init
process cannot be located, the system will panic with the message
``panic: "init died (signal %d, exit %d)''.
.Sh DIAGNOSTICS
@@ -268,7 +268,7 @@ a persistent device error condition.
System console device.
.It Pa /dev/tty*
Terminal ports found in
-.Xr ttys .
+.Xr ttys 5 .
.It Pa /var/run/utmp
Record of Current users on the system.
.It Pa /var/log/wtmp
diff --git a/sbin/ldconfig/ldconfig.8 b/sbin/ldconfig/ldconfig.8
index 9b83224..8f055c0 100644
--- a/sbin/ldconfig/ldconfig.8
+++ b/sbin/ldconfig/ldconfig.8
@@ -27,7 +27,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $Id: ldconfig.8,v 1.6 1994/12/23 22:31:21 nate Exp $
+.\" $Id: ldconfig.8,v 1.7 1995/06/24 10:08:43 asami Exp $
.\"
.Dd October 3, 1993
.Dt LDCONFIG 8
@@ -44,16 +44,16 @@
is used to prepare a set of
.Dq hints
for use by the run-time linker
-.Xr ld.so
+.Xr ld.so 1
to facilitate quick lookup of shared libraries available in multiple
directories. It scans a set of built-in system directories and any
.Ar directories
specified on the command line (in the given order) looking for shared
libraries and stores the results in the file
-.Xr /var/run/ld.so.hints
+.Pa /var/run/ld.so.hints
to forestall the overhead that would otherwise result from the
directory search operations
-.Xr ld.so
+.Xr ld.so 1
would have to perform to load the required shared libraries.
.Pp
The shared libraries so found will be automatically available for loading
@@ -69,12 +69,12 @@ directories where shared libraries might be found.
is a
.Sq \:
separated list of directory paths which are searched by
-.Xr ld.so
+.Xr ld.so 1
when it needs to load a shared library. It can be viewed as the run-time
equivalent of the
.Fl L
switch of
-.Xr ld.
+.Xr ld 1 .
.Pp
.Nm Ldconfig
is typically run as part of the boot sequence.
@@ -84,13 +84,13 @@ The following options recognized by
.Bl -tag -width indent
.It Fl m
Instead of replacing the contents of
-.Xr ld.so.hints
+.Pa ld.so.hints
with those found in the directories specified,
.Dq merge
in new entries.
.It Fl r
Lists the current contents of
-.Xr ld.so.hints
+.Pa ld.so.hints
on the standard output. The hints file will not be modified.
.It Fl s
Do not scan the built-in system directory
@@ -103,9 +103,9 @@ Special care must be taken when loading shared libraries into the address
space of
.Ev set-user-Id
programs. Whenever such a program is run,
-.Xr ld.so
+.Nm ld.so
will only load shared libraries from the
-.Ev ld.so.hints
+.Pa ld.so.hints
file. In particular, the
.Ev LD_LIBRARY_PATH
is not used to search for libraries. Thus, the role of ldconfig is dual. In
@@ -114,13 +114,13 @@ specify the trusted collection of directories from which shared objects can
be safely loaded. It is presumed that the set of directories specified to
.Nm ldconfig
are under control of the system's administrator.
-.Xr ld.so
+.Nm ld.so
further assists set-user-Id programs by erasing the
.Ev LD_LIBRARY_PATH
from the environment.
.Sh FILES
-.Xr /var/run/ld.so.hints
+.Pa /var/run/ld.so.hints
.Sh SEE ALSO
.Xr ld 1 ,
.Xr link 5
OpenPOWER on IntegriCloud