mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-26 11:47:31 +00:00
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.
This commit is contained in:
Mike Pritchard
parent
b5cfb15fad
commit
edf0e5b3f8
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=15135
@ -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
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
.\"
|
||||
.\" Email: Wolfram Schneider <wosch@cs.tu-berlin.de>
|
||||
.\"
|
||||
.\" $Id: makewhatis.1,v 1.1 1995/02/15 22:52:51 joerg Exp $
|
||||
.\" $Id: makewhatis.1,v 1.2 1995/03/31 04:00:51 joerg Exp $
|
||||
.\"
|
||||
|
||||
.Dd Jan, 12, 1995
|
||||
@ -108,8 +108,7 @@ Create whatis database for all directories in your
|
||||
.Ic makewhatis -outfile /tmp/mywhatis /usr/local/man $HOME/man
|
||||
.Pp
|
||||
Create whatis database
|
||||
.Pa /tmp/mywhatis
|
||||
\&.
|
||||
.Pa /tmp/mywhatis .
|
||||
Traverse directories
|
||||
.Pa /usr/local/man
|
||||
and
|
||||
|
||||
@ -223,8 +223,8 @@ strings like
|
||||
.Xr csh 1 .
|
||||
The pattern
|
||||
.Ql {}
|
||||
is left unexpanded for historical reasons
|
||||
.Xr (Csh 1
|
||||
is left unexpanded for historical reasons (and
|
||||
.Xr csh 1
|
||||
does the same thing to
|
||||
ease typing
|
||||
of
|
||||
|
||||
@ -46,8 +46,8 @@ The
|
||||
.Fn nlist
|
||||
function
|
||||
retrieves name list entries from the symbol table of an
|
||||
executable file. (See
|
||||
.Xr a.out 5 . )
|
||||
executable file (see
|
||||
.Xr a.out 5 ) .
|
||||
The argument
|
||||
.Fa \&nl
|
||||
is set to reference the
|
||||
|
||||
@ -101,7 +101,7 @@ has no return value.
|
||||
(See
|
||||
.Sx BUGS . )
|
||||
.Sh SEE ALSO
|
||||
.Xr iso 4 ,
|
||||
.Xr iso 4
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn link_addr
|
||||
|
||||
@ -149,8 +149,7 @@ process id
|
||||
.Xr kill 1 ,
|
||||
.Xr socket 2 ,
|
||||
.Xr signal 3 ,
|
||||
.Xr syslog 3 ,
|
||||
.Xr rmp 4
|
||||
.Xr syslog 3
|
||||
.Sh BUGS
|
||||
If multiple servers are started on the same interface, each will receive
|
||||
and respond to the same boot packets.
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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
|
||||
|
||||
@ -23,7 +23,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$
|
||||
.\" $Id: sysexits.3,v 1.1 1996/03/31 22:33:54 joerg Exp $
|
||||
.\"
|
||||
.\" "
|
||||
.Dd March 31, 1996
|
||||
@ -87,7 +87,7 @@ does not exist in the passwd file.
|
||||
.It Sy EX_OSFILE Pq 72
|
||||
Some system file (e.g.,
|
||||
.Pa /etc/passwd ,
|
||||
.Pa /etc/utmp ,
|
||||
.Pa /var/run/utmp ,
|
||||
etc.) does not exist, cannot be opened, or has some sort of error
|
||||
(e.g., syntax error).
|
||||
.It Sy EX_CANTCREAT Pq 73
|
||||
|
||||
@ -62,9 +62,9 @@ is obtained from
|
||||
.Tn ICMP
|
||||
sockets are connectionless,
|
||||
and are normally used with the
|
||||
.Xr sendto
|
||||
.Xr sendto 2
|
||||
and
|
||||
.Xr recvfrom
|
||||
.Xr recvfrom 2
|
||||
calls, though the
|
||||
.Xr connect 2
|
||||
call may also be used to fix the destination for future
|
||||
|
||||
@ -63,7 +63,8 @@ special-purpose applications.
|
||||
.Pp
|
||||
There are several
|
||||
.Tn IP-level
|
||||
.Xr setsockopt 2 / Ns
|
||||
.Xr setsockopt 2
|
||||
and
|
||||
.Xr getsockopt 2
|
||||
options.
|
||||
.Dv IP_OPTIONS
|
||||
@ -115,7 +116,7 @@ option is enabled on a
|
||||
.Dv SOCK_DGRAM
|
||||
socket,
|
||||
the
|
||||
.Xr recvmsg
|
||||
.Xr recvmsg 2
|
||||
call will return the destination
|
||||
.Tn IP
|
||||
address for a
|
||||
@ -296,9 +297,9 @@ Raw
|
||||
.Tn IP
|
||||
sockets are connectionless,
|
||||
and are normally used with the
|
||||
.Xr sendto
|
||||
.Xr sendto 2
|
||||
and
|
||||
.Xr recvfrom
|
||||
.Xr recvfrom 2
|
||||
calls, though the
|
||||
.Xr connect 2
|
||||
call may also be used to fix the destination for future
|
||||
|
||||
@ -174,10 +174,10 @@ certain interfaces such as the loopback interface,
|
||||
do not.
|
||||
.Pp
|
||||
The following
|
||||
.Xr ioctl
|
||||
.Xr ioctl 2
|
||||
calls may be used to manipulate network interfaces.
|
||||
The
|
||||
.Xr ioctl
|
||||
.Fn ioctl
|
||||
is made on a socket (typically of type
|
||||
.Dv SOCK_DGRAM )
|
||||
in the desired domain.
|
||||
@ -218,7 +218,7 @@ Set point to point address for protocol family and interface.
|
||||
Set broadcast address for protocol family and interface.
|
||||
.El
|
||||
.Pp
|
||||
.Xr Ioctl
|
||||
.Fn Ioctl
|
||||
requests to obtain addresses and requests both to set and
|
||||
retrieve other data are still fully supported
|
||||
and use the
|
||||
@ -263,9 +263,9 @@ to each family (replacing each sockaddr by one
|
||||
of the family-specific type).
|
||||
Where the sockaddr itself is larger than the
|
||||
default size, one needs to modify the
|
||||
.Xr ioctl
|
||||
.Fn ioctl
|
||||
identifier itself to include the total size, as described in
|
||||
.Xr ioctl .
|
||||
.Fn ioctl .
|
||||
.It Dv SIOCDIFADDR
|
||||
This requests deletes the specified address from the list
|
||||
associated with an interface. It also uses the
|
||||
|
||||
@ -42,7 +42,7 @@
|
||||
.Op Ar count
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Xr pty
|
||||
.Nm pty
|
||||
driver provides support for a device-pair termed a
|
||||
.Em pseudo terminal .
|
||||
A pseudo terminal is a pair of character devices, a
|
||||
@ -92,7 +92,7 @@ mode. Packet mode is enabled by specifying (by reference)
|
||||
a nonzero parameter and disabled by specifying (by reference)
|
||||
a zero parameter. When applied to the master side of a pseudo
|
||||
terminal, each subsequent
|
||||
.Xr read
|
||||
.Xr read 2
|
||||
from the terminal will return data written on the slave part of
|
||||
the pseudo terminal preceded by a zero byte (symbolically
|
||||
defined as
|
||||
@ -140,7 +140,7 @@ used by other similar programs.
|
||||
.El
|
||||
.It Dv TIOCUCNTL
|
||||
Enable/disable a mode that allows a small number of simple user
|
||||
.Xr ioctl
|
||||
.Xr ioctl 2
|
||||
commands to be passed through the pseudo-terminal,
|
||||
using a protocol similar to that of
|
||||
.Dv TIOCPKT .
|
||||
@ -154,12 +154,12 @@ by specifying (by reference)
|
||||
a nonzero parameter and disabled by specifying (by reference)
|
||||
a zero parameter.
|
||||
Each subsequent
|
||||
.Xr read
|
||||
.Xr read 2
|
||||
from the master side will return data written on the slave part of
|
||||
the pseudo terminal preceded by a zero byte,
|
||||
or a single byte reflecting a user control operation on the slave side.
|
||||
A user control command consists of a special
|
||||
.Xr ioctl
|
||||
.Xr ioctl 2
|
||||
operation with no data; the command is given as
|
||||
.Dv UIOCCMD Ns (n) ,
|
||||
where
|
||||
@ -168,17 +168,17 @@ is a number in the range 1-255.
|
||||
The operation value
|
||||
.Ar n
|
||||
will be received as a single byte on the next
|
||||
.Xr read
|
||||
.Xr read 2
|
||||
from the master side.
|
||||
The
|
||||
.Xr ioctl
|
||||
.Xr ioctl 2
|
||||
.Dv UIOCCMD Ns (0)
|
||||
is a no-op that may be used to probe for
|
||||
the existence of this facility.
|
||||
As with
|
||||
.Dv TIOCPKT
|
||||
mode, command operations may be detected with a
|
||||
.Xr select
|
||||
.Xr select 2
|
||||
for exceptional conditions.
|
||||
.It Dv TIOCREMOTE
|
||||
A mode for the master half of a pseudo terminal, independent
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
.Nm device-driver su
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Xr su
|
||||
.Nm su
|
||||
driver provides support for a
|
||||
process to address arbitrary locations on the scsi bus. Minor
|
||||
numbers are mapped 1:1 to bus:target:lun. The lowest three bits being LUN
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" From: @(#)tcp.4 8.1 (Berkeley) 6/5/93
|
||||
.\" $Id: tcp.4,v 1.3 1995/02/15 03:30:54 wollman Exp $
|
||||
.\" $Id: tcp.4,v 1.4 1995/02/15 22:07:27 wollman Exp $
|
||||
.\"
|
||||
.Dd February 14, 1995
|
||||
.Dt TCP 4
|
||||
@ -150,9 +150,9 @@ will set the
|
||||
.Dq push
|
||||
bit and begin transmission immediately (if permitted) at the end of
|
||||
every user call to
|
||||
.Xr write
|
||||
.Xr write 2
|
||||
or
|
||||
.Xr writev .
|
||||
.Xr writev 2 .
|
||||
The
|
||||
.Dv TCP_NOPUSH
|
||||
option is provided to allow servers to easily make use of Transaction
|
||||
@ -165,7 +165,7 @@ or the internal send buffer is filled.
|
||||
.El
|
||||
.Pp
|
||||
The option level for the
|
||||
.Xr setsockopt
|
||||
.Xr setsockopt 2
|
||||
call is the protocol number for
|
||||
.Tn TCP ,
|
||||
available from
|
||||
|
||||
@ -85,6 +85,7 @@ is created when a user logs in, and the login terminal is setup
|
||||
to be the controlling terminal; all processes spawned from that
|
||||
login shell are in the same session, and inherit the controlling
|
||||
terminal.
|
||||
.Pp
|
||||
A job control shell
|
||||
operating interactively (that is, reading commands from a terminal)
|
||||
normally groups related processes together by placing them into the
|
||||
@ -199,7 +200,7 @@ the writing process is orphaned, and the writing process is not ignoring
|
||||
or blocking
|
||||
.Dv SIGTTOU ,
|
||||
the
|
||||
.Xr write
|
||||
.Xr write 2
|
||||
returns -1 with
|
||||
errno set to
|
||||
.Er Dv EIO
|
||||
@ -252,9 +253,9 @@ canonical or noncanonical mode.
|
||||
Another dependency is whether the
|
||||
.Dv O_NONBLOCK
|
||||
flag is set by
|
||||
.Xr open()
|
||||
.Xr open 2
|
||||
or
|
||||
.Xr fcntl() .
|
||||
.Xr fcntl 2 .
|
||||
If the
|
||||
.Dv O_NONBLOCK
|
||||
flag is clear, then the read request is
|
||||
@ -355,7 +356,7 @@ process the bytes received.
|
||||
.Dv MIN
|
||||
represents the minimum number of bytes that should be received when
|
||||
the
|
||||
.Xr read
|
||||
.Xr read 2
|
||||
function successfully returns.
|
||||
.Dv TIME
|
||||
is a timer of 0.1 second
|
||||
@ -402,8 +403,11 @@ and
|
||||
.Dv TIME
|
||||
mechanisms are
|
||||
activated by the receipt of the first byte, or a signal is received. If
|
||||
data is in the buffer at the time of the read(), the result is as
|
||||
if data had been received immediately after the read().
|
||||
data is in the buffer at the time of the
|
||||
.Fn read ,
|
||||
the result is as
|
||||
if data had been received immediately after the
|
||||
.Fn read .
|
||||
.Ss "Case B: MIN > 0, TIME = 0"
|
||||
In this case, since the value of
|
||||
.Dv TIME
|
||||
@ -451,7 +455,8 @@ field (see the
|
||||
.Sx "Output Modes
|
||||
section). The
|
||||
implementation may provide a buffering mechanism; as such, when a call to
|
||||
write() completes, all of the bytes written have been scheduled for
|
||||
.Fn write
|
||||
completes, all of the bytes written have been scheduled for
|
||||
transmission to the device, but the transmission will not necessarily
|
||||
have been completed.
|
||||
.\" See also .Sx "6.4.2" for the effects of
|
||||
@ -532,7 +537,8 @@ is discarded. Thus, if there are no bytes waiting (that
|
||||
is, the
|
||||
.Dv EOF
|
||||
occurred at the beginning of a line), a byte
|
||||
count of zero is returned from the read(),
|
||||
count of zero is returned from the
|
||||
.Fn read ,
|
||||
representing an end-of-file indication. If
|
||||
.Dv ICANON
|
||||
is
|
||||
@ -653,7 +659,9 @@ character, except that
|
||||
the
|
||||
.Dv SIGTSTP
|
||||
signal is delivered when one of the processes
|
||||
in the foreground process group issues a read() to the
|
||||
in the foreground process group issues a
|
||||
.Fn read
|
||||
to the
|
||||
controlling terminal.
|
||||
.It Dv LNEXT
|
||||
Special character on input and is recognized if the
|
||||
@ -712,7 +720,9 @@ the terminal, the
|
||||
signal is sent to the controlling
|
||||
process associated with the terminal. Unless other arrangements have
|
||||
been made, this causes the controlling process to terminate.
|
||||
Any subsequent call to the read() function returns the value zero,
|
||||
Any subsequent call to the
|
||||
.Fn read
|
||||
function returns the value zero,
|
||||
indicating end of file. Thus, processes that read a terminal
|
||||
file and test for end-of-file can terminate appropriately after a
|
||||
disconnect.
|
||||
@ -726,7 +736,9 @@ disconnect.
|
||||
.\" .Pf [ Dv EIO
|
||||
.\" ] is returned.
|
||||
Any
|
||||
subsequent write() to the terminal device returns -1, with
|
||||
subsequent
|
||||
.Fn write
|
||||
to the terminal device returns -1, with
|
||||
.Va errno
|
||||
set to
|
||||
.Er EIO ,
|
||||
@ -958,7 +970,9 @@ is set and the input queue is full, subsequent input shall cause an
|
||||
character to be transmitted to the
|
||||
the output queue.
|
||||
.Pp
|
||||
The initial input control value after open() is implementation defined.
|
||||
The initial input control value after
|
||||
.Fn open
|
||||
is implementation defined.
|
||||
.Ss Output Modes
|
||||
Values of the
|
||||
.Fa c_oflag
|
||||
@ -1098,13 +1112,17 @@ status lines. If
|
||||
is clear, the modem status lines are
|
||||
monitored.
|
||||
.Pp
|
||||
Under normal circumstances, a call to the open() function waits for
|
||||
Under normal circumstances, a call to the
|
||||
.Fn open
|
||||
function waits for
|
||||
the modem connection to complete. However, if the
|
||||
.Dv O_NONBLOCK
|
||||
flag is set
|
||||
or if
|
||||
.Dv CLOCAL
|
||||
has been set, the open() function returns
|
||||
has been set, the
|
||||
.Fn open
|
||||
function returns
|
||||
immediately without waiting for the connection.
|
||||
.Pp
|
||||
The
|
||||
@ -1406,6 +1424,8 @@ entries of the
|
||||
array.
|
||||
.Pp
|
||||
The initial values of the flags and control characters
|
||||
after open() is set according to
|
||||
after
|
||||
.Fn open
|
||||
is set according to
|
||||
the values in the header
|
||||
.Aq Pa sys/ttydefaults.h .
|
||||
|
||||
@ -52,9 +52,9 @@ protocol family.
|
||||
.Tn UDP
|
||||
sockets are connectionless, and are
|
||||
normally used with the
|
||||
.Xr sendto
|
||||
.Xr sendto 2
|
||||
and
|
||||
.Xr recvfrom
|
||||
.Xr recvfrom 2
|
||||
calls, though the
|
||||
.Xr connect 2
|
||||
call may also be used to fix the destination for future
|
||||
|
||||
@ -8,7 +8,7 @@
|
||||
.Nm device uk
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Xr uk
|
||||
.Nm uk
|
||||
driver provides support for a
|
||||
process to address devices on the scsi bus for which there is no configured
|
||||
driver.
|
||||
|
||||
@ -32,7 +32,7 @@
|
||||
.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
|
||||
.\" DAMAGE.
|
||||
.\"
|
||||
.\" $Id: worm.4,v 1.2 1996/01/27 17:55:54 joerg Exp $
|
||||
.\" $Id: worm.4,v 1.3 1996/01/30 13:51:19 mpp Exp $
|
||||
.\"
|
||||
.Dd January 27, 1996
|
||||
.Dt WORM 4
|
||||
@ -45,7 +45,7 @@
|
||||
.Cd disk worm0 target 5 lun 0
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Xr worm
|
||||
.Nm worm
|
||||
driver provides support for a
|
||||
.Em SCSI
|
||||
write-once device, in particular for a CD-R recording device. The
|
||||
|
||||
@ -26,7 +26,7 @@
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" from: @(#)yp.8 1.0 (deraadt) 4/26/93
|
||||
.\" $Id: yp.4,v 1.4 1995/09/02 04:20:01 wpaul Exp $
|
||||
.\" $Id: yp.4,v 1.5 1996/01/30 13:51:21 mpp Exp $
|
||||
.\"
|
||||
.Dd April 5, 1993
|
||||
.Dt YP 4
|
||||
@ -51,7 +51,7 @@ entries through the functions
|
||||
and
|
||||
.Xr ethers 3 .
|
||||
The
|
||||
.Nm bootparamd
|
||||
.Xr bootparamd 8
|
||||
daemon makes direct NIS library calls since there are no
|
||||
functions in the standard C library for reading bootparams. NIS
|
||||
support for the hosts, services and rpc databases is enabled by
|
||||
@ -69,7 +69,7 @@ subsystem is started automatically in
|
||||
if it has been initialized in
|
||||
.Pa /etc/sysconfig
|
||||
and if the directory
|
||||
.Nm /var/yp
|
||||
.Pa /var/yp
|
||||
exists (which it does in the default distribution). The default
|
||||
NIS domain must also be set with the
|
||||
.Xr domainname 1
|
||||
@ -140,7 +140,7 @@ updated by the master.
|
||||
.El
|
||||
.Pp
|
||||
An NIS client establishes what is called a
|
||||
.Nm binding
|
||||
.Em binding
|
||||
to a particular NIS server using the
|
||||
.Xr ypbind 8
|
||||
daemon.
|
||||
@ -180,38 +180,41 @@ is designed to handle, most of which are implemented as functions
|
||||
within the standard C library:
|
||||
.Bl -bullet -offset indent
|
||||
.It
|
||||
.Nm yp_order()
|
||||
.Fn yp_order
|
||||
-- check the creation date of a particular map
|
||||
.It
|
||||
.Nm yp_master()
|
||||
.Fn yp_master
|
||||
-- obtain the name of the NIS master server for a given
|
||||
map/domain
|
||||
.It
|
||||
.Nm yp_match()
|
||||
.Fn yp_match
|
||||
-- lookup the data corresponding to a given in key in a particular
|
||||
map/domain
|
||||
.It
|
||||
.Nm yp_first()
|
||||
.Fn yp_first
|
||||
-- obtain the first key/data pair in a particular map/domain
|
||||
.It
|
||||
.Nm yp_next()
|
||||
.Fn yp_next
|
||||
-- pass
|
||||
.Xr ypserv 8
|
||||
a key in a particular map/domain and have it return the
|
||||
key/data pair immediately following it (yp_first() and yp_next()
|
||||
key/data pair immediately following it (the functions
|
||||
.Fn yp_first
|
||||
and
|
||||
.Fn yp_next
|
||||
can be used to do a sequential search of an NIS map)
|
||||
.It
|
||||
.Nm yp_all()
|
||||
.Fn yp_all
|
||||
-- retrieve the entire contents of a map
|
||||
.El
|
||||
.Pp
|
||||
There are a few other requests which
|
||||
.Xr ypserv
|
||||
.Xr ypserv 8
|
||||
is capable of handling (i.e. acknowledge whether or not you can handle
|
||||
a particular domain (YPPROC_DOMAIN), or acknowledge only if you can
|
||||
handle the domain and be silent otherwise (YPPROC_DOMAIN_NONACK)) but
|
||||
these requests are usually generated only by
|
||||
.Xr ypbind
|
||||
.Xr ypbind 8
|
||||
and are not meant to be used by standard utilities.
|
||||
.Pp
|
||||
On networks with a large number of hosts, it is often a good idea to
|
||||
@ -268,7 +271,7 @@ is specially designed to provided enhanced security (compared to
|
||||
other NIS implementations) when used exclusively with FreeBSD client
|
||||
systems. The FreeBSD password database system (which is derived directly
|
||||
form 4.4BSD) includes support for
|
||||
.Nm shadow passwords .
|
||||
.Em "shadow passwords" .
|
||||
The standard password database does not contain users' encrypted
|
||||
passwords: these are instead stored (along with other information)
|
||||
is a separate database which is accessible only by the super-user.
|
||||
@ -355,7 +358,8 @@ and
|
||||
functions do not yet have NIS support. Fortunately, these files
|
||||
don't need to be updated that often.
|
||||
.Pp
|
||||
Many more manual pages should be written, especially ypclnt(3).
|
||||
Many more manual pages should be written, especially
|
||||
.Xr ypclnt 3 .
|
||||
For the time being, seek out a local Sun machine and read the
|
||||
manuals for there.
|
||||
.Pp
|
||||
|
||||
@ -292,7 +292,7 @@ These blocks are read in from
|
||||
in addition to the super-block.
|
||||
.Pp
|
||||
.Sy N.B.:
|
||||
.Xr sizeof Pq Fa struct csum
|
||||
.Fn sizeof "struct csum"
|
||||
must be a power of two in order for
|
||||
the
|
||||
.Fn fs_cs
|
||||
|
||||
@ -166,7 +166,7 @@ is used for these filesystems by the
|
||||
.Xr dump 8
|
||||
command to determine which filesystems need to be dumped.
|
||||
If the fifth field is not present, a value of zero is returned and
|
||||
.Xr dump
|
||||
.Nm dump
|
||||
will assume that the filesystem does not need to be dumped.
|
||||
.Pp
|
||||
The sixth field,
|
||||
@ -185,7 +185,7 @@ but filesystems on different drives will be checked at the
|
||||
same time to utilize parallelism available in the hardware.
|
||||
If the sixth field is not present or zero,
|
||||
a value of zero is returned and
|
||||
.Xr fsck
|
||||
.Xr fsck 8
|
||||
will assume that the filesystem does not need to be checked.
|
||||
.Bd -literal
|
||||
#define FSTAB_RW "rw" /* read-write device */
|
||||
|
||||
@ -26,7 +26,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: link.5,v 1.3 1996/01/20 07:29:06 mpp Exp $
|
||||
.\" $Id: link.5,v 1.4 1996/01/30 13:51:35 mpp Exp $
|
||||
.\"
|
||||
.Dd October 23, 1993
|
||||
.Dt LINK 5
|
||||
@ -56,7 +56,7 @@ The collection of data structures described here will be referred to as the
|
||||
.Em Run-time Relocation Section (RRS)
|
||||
and is embedded in the standard text and data segments of the dynamically
|
||||
linked program or shared object image as the existing
|
||||
.Xr a.out
|
||||
.Xr a.out 5
|
||||
format offers no room for it elsewhere.
|
||||
.Pp
|
||||
Several utilities cooperate to ensure that the task of getting a program
|
||||
@ -118,7 +118,11 @@ struct _dynamic {
|
||||
.Bl -tag -width d_version
|
||||
.It Fa d_version
|
||||
This field provides for different versions of the dynamic linking
|
||||
implementation. The current version numbers understood by ld and ld.so are
|
||||
implementation. The current version numbers understood by
|
||||
.Xr ld 1
|
||||
and
|
||||
.Xr ld.so 1
|
||||
are
|
||||
.Em LD_VERSION_SUN (3),
|
||||
which is used by the SunOS 4.x releases, and
|
||||
.Em LD_VERSION_BSD (8),
|
||||
@ -160,7 +164,7 @@ struct section_dispatch_table {
|
||||
.Bl -tag -width sdt_filler1
|
||||
.It Fa sdt_loaded
|
||||
A pointer to the first link map loaded (see below). This field is set by
|
||||
.Xr ld.so.
|
||||
.Nm ld.so
|
||||
.It Fa sdt_sods
|
||||
The start of a (linked) list of shared object descriptors needed by
|
||||
.Em this
|
||||
@ -231,7 +235,9 @@ The offset in the text segment of a string describing this link object.
|
||||
.It Fa sod_library
|
||||
If set,
|
||||
.Fa sod_name
|
||||
specifies a library that is to be searched for by ld.so. The path name
|
||||
specifies a library that is to be searched for by
|
||||
.Nm ld.so .
|
||||
The path name
|
||||
is obtained by searching a set of directories
|
||||
.Po
|
||||
see also
|
||||
@ -316,7 +322,7 @@ struct nzlist {
|
||||
.It Fa nlist
|
||||
.Po
|
||||
see
|
||||
.Xr nlist 5
|
||||
.Xr nlist 3
|
||||
.Pc .
|
||||
.It Fa nz_size
|
||||
The size of the data represented by this symbol.
|
||||
@ -372,7 +378,8 @@ The symbol description.
|
||||
.It Fa rt_next
|
||||
Virtual address of next rt_symbol.
|
||||
.It Fa rt_link
|
||||
Next in hash bucket. Used by internally by ld.so.
|
||||
Next in hash bucket. Used by internally by
|
||||
.Nm ld.so .
|
||||
.It Fa rt_srcaddr
|
||||
Location of the source of initialized data within a shared object.
|
||||
.It Fa rt_smp
|
||||
@ -429,9 +436,11 @@ may be interested in.
|
||||
.Pp
|
||||
The
|
||||
.Em ld_entry
|
||||
structure defines a set of service routines within ld.so. See
|
||||
.Xr libdl.a
|
||||
for more information.
|
||||
structure defines a set of service routines within
|
||||
.Nm ld.so .
|
||||
.\" See
|
||||
.\" .Xr libdl.a
|
||||
.\" for more information.
|
||||
.Bd -literal -offset indent
|
||||
struct ld_entry {
|
||||
void *(*dlopen)(char *, int);
|
||||
@ -443,7 +452,8 @@ struct ld_entry {
|
||||
|
||||
The
|
||||
.Fa crt_ldso
|
||||
structure defines the interface between the start-up code in crt0 and ld.so.
|
||||
structure defines the interface between the start-up code in crt0 and
|
||||
.Nm ld.so .
|
||||
.Bd -literal -offset indent
|
||||
struct crt_ldso {
|
||||
int crt_ba;
|
||||
@ -463,13 +473,16 @@ struct crt_ldso {
|
||||
.Ed
|
||||
.Bl -tag -width crt_dzfd
|
||||
.It Fa crt_ba
|
||||
The virtual address at which ld.so was loaded by crt0.
|
||||
The virtual address at which
|
||||
.Nm ld.so
|
||||
was loaded by crt0.
|
||||
.It Fa crt_dzfd
|
||||
On SunOS systems, this field contains an open file descriptor to
|
||||
.Dq /dev/zero
|
||||
.Dq Pa /dev/zero
|
||||
used to get demand paged zeroed pages. On FreeBSD systems it contains -1.
|
||||
.It Fa crt_ldfd
|
||||
Contains an open file descriptor that was used by crt0 to load ld.so.
|
||||
Contains an open file descriptor that was used by crt0 to load
|
||||
.Nm ld.so .
|
||||
.It Fa crt_dp
|
||||
A pointer to main's
|
||||
.Fa _dynamic
|
||||
@ -492,8 +505,10 @@ The
|
||||
and
|
||||
.Fa hints_bucket
|
||||
structures define the layout of the library hints, normally found in
|
||||
.Dq /var/run/ld.so.hints,
|
||||
which is used by ld.so to quickly locate the shared object images in the
|
||||
.Dq Pa /var/run/ld.so.hints ,
|
||||
which is used by
|
||||
.Nm ld.so
|
||||
to quickly locate the shared object images in the
|
||||
filesystem.
|
||||
The organization of the hints file is not unlike that of an
|
||||
.Dq a.out
|
||||
|
||||
@ -39,7 +39,7 @@
|
||||
.Nd network name data base
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Xr networks
|
||||
.Nm networks
|
||||
file contains information regarding
|
||||
the known networks which comprise the
|
||||
.Tn DARPA
|
||||
|
||||
@ -52,7 +52,7 @@ file every time it is used, allowing dynamic
|
||||
addition and deletion of printers. Each entry in the data base
|
||||
is used to describe one printer. This data base may not be
|
||||
substituted for, as is possible for
|
||||
.Xr termcap ,
|
||||
.Xr termcap 5 ,
|
||||
because it may allow accounting to be bypassed.
|
||||
.Pp
|
||||
The default printer is normally
|
||||
@ -167,7 +167,7 @@ flag is passed only if the
|
||||
.Fl l
|
||||
flag (pass control characters literally)
|
||||
is specified to
|
||||
.Xr lpr .
|
||||
.Xr lpr 1 .
|
||||
The
|
||||
.Ar Width
|
||||
function
|
||||
@ -249,8 +249,8 @@ and must not ignore
|
||||
.Sh LOGGING
|
||||
Error messages generated by the line printer programs themselves
|
||||
(that is, the
|
||||
.Xr lp Ns *
|
||||
programs)
|
||||
.Xr lpd 8
|
||||
and related programs)
|
||||
are logged by
|
||||
.Xr syslog 3
|
||||
using the
|
||||
@ -263,7 +263,7 @@ are sent to the corresponding
|
||||
.Cm lf
|
||||
file.
|
||||
The filters may, of course, use
|
||||
.Xr syslog
|
||||
.Xr syslog 8
|
||||
themselves.
|
||||
.Pp
|
||||
Error messages sent to the console have a carriage return and a line
|
||||
|
||||
@ -46,7 +46,7 @@ file which
|
||||
is structured somewhat like the
|
||||
.Xr termcap 5
|
||||
file. Each line in the file provides a description for a single
|
||||
.Xr system .
|
||||
.Em system .
|
||||
Fields are separated by a colon (``:'').
|
||||
Lines ending in a \e character with an immediately following newline are
|
||||
continued on the next line.
|
||||
@ -59,17 +59,17 @@ name followed by a `#' sign indicates a following numeric value.
|
||||
.Pp
|
||||
Entries named ``tip*'' and ``cu*''
|
||||
are used as default entries by
|
||||
.Xr tip ,
|
||||
.Xr tip 1 ,
|
||||
and the
|
||||
.Xr cu
|
||||
.Xr cu 1
|
||||
interface to
|
||||
.Xr tip ,
|
||||
.Nm tip ,
|
||||
as follows. When
|
||||
.Xr tip
|
||||
.Nm tip
|
||||
is invoked with only a phone number, it looks for an entry
|
||||
of the form ``tip300'', where 300 is the baud rate with
|
||||
which the connection is to be made. When the
|
||||
.Xr cu
|
||||
.Nm cu
|
||||
interface is used, entries of the form ``cu300'' are used.
|
||||
.Sh CAPABILITIES
|
||||
Capabilities are either strings (str), numbers (num), or boolean
|
||||
@ -122,7 +122,7 @@ The default is
|
||||
.Dv NULL .
|
||||
`~' escapes are only
|
||||
recognized by
|
||||
.Xr tip
|
||||
.Nm tip
|
||||
after one of the characters in `el',
|
||||
or after a carriage-return.
|
||||
.It Cm \&fs
|
||||
@ -145,7 +145,7 @@ Output end-of-file string.
|
||||
The default is
|
||||
.Dv NULL .
|
||||
When
|
||||
.Xr tip
|
||||
.Nm tip
|
||||
is transferring a file, this
|
||||
string is sent at end-of-file.
|
||||
.It Cm \&pa
|
||||
@ -160,7 +160,7 @@ is even parity.
|
||||
Telephone number(s) for this host.
|
||||
If the telephone number field contains
|
||||
an @ sign,
|
||||
.Xr tip
|
||||
.Nm tip
|
||||
searches the file
|
||||
.Pa /etc/phones
|
||||
file for a list of telephone numbers;
|
||||
|
||||
@ -90,7 +90,7 @@ struct utmp {
|
||||
.Ed
|
||||
.Pp
|
||||
Each time a user logs in, the
|
||||
.Xr login
|
||||
.Xr login 1
|
||||
program looks up the user's
|
||||
.Tn UID
|
||||
in the file
|
||||
@ -102,7 +102,7 @@ are written to the standard output. (Providing the login is not
|
||||
see
|
||||
.Xr login 1 . )
|
||||
The
|
||||
.Xr login
|
||||
.Nm login
|
||||
program then records the new login time in the file
|
||||
.Nm lastlog .
|
||||
.Pp
|
||||
|
||||
@ -25,7 +25,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: clocks.7,v 1.1 1996/04/05 08:51:22 joerg Exp $
|
||||
.\" $Id: clocks.7,v 1.2 1996/04/07 21:12:10 mpp Exp $
|
||||
.\" "
|
||||
.Dd April 1, 1996
|
||||
.Os
|
||||
@ -52,8 +52,11 @@ happens to be 128. It isn't directly available to applications.
|
||||
The clock reported by
|
||||
.Xr clock 3 .
|
||||
This is a virtual clock with a frequency that happens to be 128. It's
|
||||
actual frequency is given by the macro CLOCKS_PER_SEC. Note that
|
||||
CLOCKS_PER_SEC may be floating point. Don't use
|
||||
actual frequency is given by the macro
|
||||
.Dv CLOCKS_PER_SEC .
|
||||
Note that
|
||||
.Dv CLOCKS_PER_SEC
|
||||
may be floating point. Don't use
|
||||
.Fn clock
|
||||
in new programs under FreeBSD. It is feeble compared with
|
||||
.Xr getrusage 2 .
|
||||
@ -64,13 +67,15 @@ and throwing away information and resolution.
|
||||
The clock reported by
|
||||
.Xr times 3 .
|
||||
This is a virtual clock with a frequency that happens to be 128. It's
|
||||
actual frequency is given by the macro CLK_TCK (deprecated; don't use)
|
||||
and by
|
||||
actual frequency is given by the macro
|
||||
.Dv CLK_TCK
|
||||
(deprecated; don't use) and by
|
||||
.Fn sysconf SC_CLK_TCK
|
||||
and by
|
||||
.Xr sysctl 3 .
|
||||
Note that its frequency may be different from CLOCKS_PER_SEC. Don't
|
||||
use
|
||||
Note that its frequency may be different from
|
||||
.Dv CLOCKS_PER_SEC .
|
||||
Don't use
|
||||
.Xr times 3
|
||||
in new programs under FreeBSD. It is feeble compared with
|
||||
.Xr gettimeofday 2
|
||||
|
||||
@ -54,7 +54,8 @@ The size of the block units used by several commands, most notably
|
||||
.Xr du 1
|
||||
and
|
||||
.Xr ls 1 .
|
||||
BLOCKSIZE may be specified in units of a byte by specifying a number,
|
||||
.Ev BLOCKSIZE
|
||||
may be specified in units of a byte by specifying a number,
|
||||
in units of a kilobyte by specifying a number followed by ``K'' or
|
||||
``k'', in units of a megabyte by specifying a number followed by ``M''
|
||||
or ``m'' and in units of a gigabyte by specifying a number followed
|
||||
@ -72,9 +73,9 @@ A user's login directory, set by
|
||||
from the password file
|
||||
.Xr passwd 5 .
|
||||
.It Ev LANG
|
||||
This variable configure all programs which use
|
||||
This variable configures all programs which use
|
||||
.Xr setlocale 3
|
||||
to specified locale.
|
||||
to use the specified locale.
|
||||
.It Ev PATH
|
||||
The sequence of directories, separated by colons, searched by
|
||||
.Xr csh 1 ,
|
||||
@ -82,7 +83,8 @@ The sequence of directories, separated by colons, searched by
|
||||
.Xr system 3 ,
|
||||
.Xr execvp 3 ,
|
||||
etc, when looking for an executable file.
|
||||
PATH is set to ``/usr/bin:/bin'' initially by
|
||||
.Ev PATH
|
||||
is set to ``/usr/bin:/bin'' initially by
|
||||
.Xr login 1 .
|
||||
.It Ev PRINTER
|
||||
The name of the default printer to be used by
|
||||
@ -103,7 +105,9 @@ which may exploit special terminal capabilities. See
|
||||
.Pq Xr termcap 5
|
||||
for a list of terminal types.
|
||||
.It Ev TERMCAP
|
||||
The string describing the terminal in TERM, or, if
|
||||
The string describing the terminal in
|
||||
.Ev TERM ,
|
||||
or, if
|
||||
it begins with a '/', the name of the termcap file.
|
||||
See
|
||||
.Ev TERMPATH
|
||||
@ -134,7 +138,7 @@ Setting this variable will make them use another directory.
|
||||
.It Ev TZ
|
||||
The timezone to use when displaying dates.
|
||||
The normal format is a pathname relative to
|
||||
.Dq /usr/share/zoneinfo .
|
||||
.Dq Pa /usr/share/zoneinfo .
|
||||
For example, the command
|
||||
.Dq env TZ=US/Pacific date
|
||||
displays the current time in California.
|
||||
|
||||
@ -76,7 +76,7 @@ see
|
||||
.It Li mtree/
|
||||
mtree configuration files;
|
||||
see
|
||||
.Xr mtree 1
|
||||
.Xr mtree 8
|
||||
.It Li namedb/
|
||||
named configuration files;
|
||||
see
|
||||
|
||||
@ -76,7 +76,7 @@ and clears the scratch directory
|
||||
.Pp
|
||||
.Nm Rc.local
|
||||
is executed immediately before any other commands after a successful
|
||||
.Xr fsck .
|
||||
.Nm fsck .
|
||||
Normally, the first commands placed in the
|
||||
.Nm rc.local
|
||||
file define the machine's name, using
|
||||
|
||||
@ -26,7 +26,7 @@
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" from: @(#)yp.8 1.0 (deraadt) 4/26/93
|
||||
.\" $Id: yp.4,v 1.4 1995/09/02 04:20:01 wpaul Exp $
|
||||
.\" $Id: yp.4,v 1.5 1996/01/30 13:51:21 mpp Exp $
|
||||
.\"
|
||||
.Dd April 5, 1993
|
||||
.Dt YP 4
|
||||
@ -51,7 +51,7 @@ entries through the functions
|
||||
and
|
||||
.Xr ethers 3 .
|
||||
The
|
||||
.Nm bootparamd
|
||||
.Xr bootparamd 8
|
||||
daemon makes direct NIS library calls since there are no
|
||||
functions in the standard C library for reading bootparams. NIS
|
||||
support for the hosts, services and rpc databases is enabled by
|
||||
@ -69,7 +69,7 @@ subsystem is started automatically in
|
||||
if it has been initialized in
|
||||
.Pa /etc/sysconfig
|
||||
and if the directory
|
||||
.Nm /var/yp
|
||||
.Pa /var/yp
|
||||
exists (which it does in the default distribution). The default
|
||||
NIS domain must also be set with the
|
||||
.Xr domainname 1
|
||||
@ -140,7 +140,7 @@ updated by the master.
|
||||
.El
|
||||
.Pp
|
||||
An NIS client establishes what is called a
|
||||
.Nm binding
|
||||
.Em binding
|
||||
to a particular NIS server using the
|
||||
.Xr ypbind 8
|
||||
daemon.
|
||||
@ -180,38 +180,41 @@ is designed to handle, most of which are implemented as functions
|
||||
within the standard C library:
|
||||
.Bl -bullet -offset indent
|
||||
.It
|
||||
.Nm yp_order()
|
||||
.Fn yp_order
|
||||
-- check the creation date of a particular map
|
||||
.It
|
||||
.Nm yp_master()
|
||||
.Fn yp_master
|
||||
-- obtain the name of the NIS master server for a given
|
||||
map/domain
|
||||
.It
|
||||
.Nm yp_match()
|
||||
.Fn yp_match
|
||||
-- lookup the data corresponding to a given in key in a particular
|
||||
map/domain
|
||||
.It
|
||||
.Nm yp_first()
|
||||
.Fn yp_first
|
||||
-- obtain the first key/data pair in a particular map/domain
|
||||
.It
|
||||
.Nm yp_next()
|
||||
.Fn yp_next
|
||||
-- pass
|
||||
.Xr ypserv 8
|
||||
a key in a particular map/domain and have it return the
|
||||
key/data pair immediately following it (yp_first() and yp_next()
|
||||
key/data pair immediately following it (the functions
|
||||
.Fn yp_first
|
||||
and
|
||||
.Fn yp_next
|
||||
can be used to do a sequential search of an NIS map)
|
||||
.It
|
||||
.Nm yp_all()
|
||||
.Fn yp_all
|
||||
-- retrieve the entire contents of a map
|
||||
.El
|
||||
.Pp
|
||||
There are a few other requests which
|
||||
.Xr ypserv
|
||||
.Xr ypserv 8
|
||||
is capable of handling (i.e. acknowledge whether or not you can handle
|
||||
a particular domain (YPPROC_DOMAIN), or acknowledge only if you can
|
||||
handle the domain and be silent otherwise (YPPROC_DOMAIN_NONACK)) but
|
||||
these requests are usually generated only by
|
||||
.Xr ypbind
|
||||
.Xr ypbind 8
|
||||
and are not meant to be used by standard utilities.
|
||||
.Pp
|
||||
On networks with a large number of hosts, it is often a good idea to
|
||||
@ -268,7 +271,7 @@ is specially designed to provided enhanced security (compared to
|
||||
other NIS implementations) when used exclusively with FreeBSD client
|
||||
systems. The FreeBSD password database system (which is derived directly
|
||||
form 4.4BSD) includes support for
|
||||
.Nm shadow passwords .
|
||||
.Em "shadow passwords" .
|
||||
The standard password database does not contain users' encrypted
|
||||
passwords: these are instead stored (along with other information)
|
||||
is a separate database which is accessible only by the super-user.
|
||||
@ -355,7 +358,8 @@ and
|
||||
functions do not yet have NIS support. Fortunately, these files
|
||||
don't need to be updated that often.
|
||||
.Pp
|
||||
Many more manual pages should be written, especially ypclnt(3).
|
||||
Many more manual pages should be written, especially
|
||||
.Xr ypclnt 3 .
|
||||
For the time being, seek out a local Sun machine and read the
|
||||
manuals for there.
|
||||
.Pp
|
||||
|
||||
@ -126,8 +126,8 @@ The fields are the object name (14 characters), the file last modification
|
||||
time (type long), the user and group id's (each type char), the file mode
|
||||
(type int) and the file size (type long).
|
||||
Files were padded to an even number of bytes.
|
||||
For more information on converting from this format see
|
||||
.Xr arcv 8 .
|
||||
.\" For more information on converting from this format see
|
||||
.\" .Xr arcv 8 .
|
||||
.Pp
|
||||
The current archive format (without support for long character names and
|
||||
names with embedded spaces) was introduced in
|
||||
|
||||
@ -41,7 +41,7 @@ The default is one.
|
||||
.SH SEE ALSO
|
||||
.BR skey(1),
|
||||
.BR keyinit(1),
|
||||
.BR keysu(1),
|
||||
.\" .BR keysu(1),
|
||||
.BR keyinfo(1)
|
||||
.SH AUTHOR
|
||||
Command by Phil Karn, Neil M. Haller, John S. Walden
|
||||
|
||||
@ -46,7 +46,7 @@ file which
|
||||
is structured somewhat like the
|
||||
.Xr termcap 5
|
||||
file. Each line in the file provides a description for a single
|
||||
.Xr modem .
|
||||
.Em modem .
|
||||
Fields are separated by a colon (``:'').
|
||||
Lines ending in a \e character with an immediately following newline are
|
||||
continued on the next line.
|
||||
@ -58,16 +58,16 @@ field name followed by an `=' sign indicates a string value follows. A field
|
||||
name followed by a `#' sign indicates a following numeric value.
|
||||
.Pp
|
||||
When
|
||||
.Xr tip
|
||||
.Xr tip 1
|
||||
is invoked, an entry for a remote system is looked up in the
|
||||
.Pa /etc/remote database.
|
||||
If the entry includes an "ACU" type capability (abbreviated at),
|
||||
.Xr tip
|
||||
.Xr tip 1
|
||||
looks up the specified modem in
|
||||
.Pa /etc/modems.
|
||||
If a modem entry is found,
|
||||
the corresponding capabilities determine how
|
||||
.Xr tip
|
||||
.Xr tip 1
|
||||
programs the modem when connecting to and disconnecting from the
|
||||
remote system.
|
||||
.Sh CAPABILITIES
|
||||
|
||||
@ -89,15 +89,16 @@ specified in
|
||||
or as set during the login process by the user in their
|
||||
.Pa login
|
||||
file (see
|
||||
.Xr setenv 1 ) .
|
||||
.Xr environ 7 ) .
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr man 1 ,
|
||||
.Xr nroff 1 ,
|
||||
.Xr colcrt 1
|
||||
.Sh BUGS
|
||||
.Xr Nroff
|
||||
usually outputs a series of backspaces and underlines intermixed
|
||||
The
|
||||
.Xr nroff 1
|
||||
command usually outputs a series of backspaces and underlines intermixed
|
||||
with the text to indicate underlining. No attempt is made to optimize
|
||||
the backward motion.
|
||||
.Sh HISTORY
|
||||
|
||||
@ -37,7 +37,7 @@
|
||||
.\"
|
||||
.\" @(#)amq.8 8.3 (Berkeley) 4/18/94
|
||||
.\"
|
||||
.\" $Id: amq.8,v 1.1.1.1 1994/05/26 05:22:04 rgrimes Exp $
|
||||
.\" $Id: amq.8,v 1.2 1996/01/20 07:28:37 mpp Exp $
|
||||
.\"
|
||||
.Dd March 16, 1991
|
||||
.Dt AMQ 8
|
||||
@ -94,12 +94,12 @@ Request the automounter to unmount the named filesystems
|
||||
instead of providing information about them. Unmounts are requested,
|
||||
not forced. They merely cause the mounted filesystem to timeout,
|
||||
which will be picked up by
|
||||
.Xr amd Ns \'s
|
||||
.Nm amd Ns \'s
|
||||
main scheduler thus causing the normal timeout action to be taken.
|
||||
.It Fl v
|
||||
Request the automounter to provide version information. This is a subset
|
||||
of the information provided by
|
||||
.Xr amd Ns \'s Fl v
|
||||
.Nm amd Ns \'s Fl v
|
||||
option.
|
||||
.It Fl M
|
||||
Request automounter to add the given map entry to the root map and then
|
||||
|
||||
@ -85,7 +85,7 @@ or, if no argument is given, a list of the recognized commands.
|
||||
.It Ic abort No {\ all\ |\ printer\ }
|
||||
Terminate an active spooling daemon on the local host immediately and
|
||||
then disable printing (preventing new daemons from being started by
|
||||
.Xr lpr )
|
||||
.Xr lpr 1 )
|
||||
for the specified printers.
|
||||
.Pp
|
||||
.It Ic clean No {\ all\ |\ printer\ }
|
||||
@ -96,7 +96,7 @@ from the specified printer queue(s) on the local machine.
|
||||
.It Ic disable No {\ all\ |\ printer\ }
|
||||
Turn the specified printer queues off. This prevents new
|
||||
printer jobs from being entered into the queue by
|
||||
.Xr lpr .
|
||||
.Xr lpr 1 .
|
||||
.Pp
|
||||
.It Ic down No {\ all\ |\ printer\ } message ...
|
||||
Turn the specified printer queue off, disable printing and put
|
||||
@ -122,7 +122,7 @@ Exit from lpc.
|
||||
Attempt to start a new printer daemon.
|
||||
This is useful when some abnormal condition causes the daemon to
|
||||
die unexpectedly, leaving jobs in the queue.
|
||||
.Xr Lpq
|
||||
.Xr Lpq 1
|
||||
will report that there is no daemon present when this condition occurs.
|
||||
If the user is the super-user,
|
||||
try to abort the current daemon first (i.e., kill and restart a stuck daemon).
|
||||
|
||||
@ -88,8 +88,7 @@ The files are assumed to contain data from
|
||||
.It Fl p
|
||||
Use
|
||||
.Xr pr 1
|
||||
to format the files (equivalent to
|
||||
.Xr print ) .
|
||||
to format the files.
|
||||
.It Fl t
|
||||
The files are assumed to contain data from
|
||||
.Xr troff 1
|
||||
|
||||
@ -52,7 +52,7 @@ file every time it is used, allowing dynamic
|
||||
addition and deletion of printers. Each entry in the data base
|
||||
is used to describe one printer. This data base may not be
|
||||
substituted for, as is possible for
|
||||
.Xr termcap ,
|
||||
.Xr termcap 5 ,
|
||||
because it may allow accounting to be bypassed.
|
||||
.Pp
|
||||
The default printer is normally
|
||||
@ -167,7 +167,7 @@ flag is passed only if the
|
||||
.Fl l
|
||||
flag (pass control characters literally)
|
||||
is specified to
|
||||
.Xr lpr .
|
||||
.Xr lpr 1 .
|
||||
The
|
||||
.Ar Width
|
||||
function
|
||||
@ -249,8 +249,8 @@ and must not ignore
|
||||
.Sh LOGGING
|
||||
Error messages generated by the line printer programs themselves
|
||||
(that is, the
|
||||
.Xr lp Ns *
|
||||
programs)
|
||||
.Xr lpd 8
|
||||
and related programs)
|
||||
are logged by
|
||||
.Xr syslog 3
|
||||
using the
|
||||
@ -263,7 +263,7 @@ are sent to the corresponding
|
||||
.Cm lf
|
||||
file.
|
||||
The filters may, of course, use
|
||||
.Xr syslog
|
||||
.Xr syslog 8
|
||||
themselves.
|
||||
.Pp
|
||||
Error messages sent to the console have a carriage return and a line
|
||||
|
||||
@ -11,7 +11,7 @@
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\"
|
||||
.\"
|
||||
.\" $Id: lptcontrol.1,v 1.3 1994/05/22 12:31:54 csgr Exp $
|
||||
.\" $Id: lptcontrol.8,v 1.2 1994/09/03 22:46:49 csgr Exp $
|
||||
.Dd September 3, 1994
|
||||
.Dt LPTCONTROL 8
|
||||
.Os FreeBSD 2
|
||||
@ -60,12 +60,12 @@ must be specified.
|
||||
.Bl -tag -width indent -compact
|
||||
.It Pa /dev/lpt? - printer devices
|
||||
.It Pa /dev/lpctl? - printer control devices
|
||||
.It Pa /sys/i386/conf/GENERIC - kernel configuration file
|
||||
.El
|
||||
.Sh BUGS
|
||||
Sure to be some.
|
||||
.Sh "SEE ALSO"
|
||||
.Xr lpt 4
|
||||
.Xr /sys/i386/conf/GENERICAH
|
||||
.Sh AUTHOR
|
||||
Geoffrey M. Rehmet
|
||||
.Sh HISTORY
|
||||
|
||||
@ -343,6 +343,6 @@ and the link names are extracted with a single
|
||||
command (not split between
|
||||
invocations due to exec argument-space limitations--this depends on the
|
||||
value returned by
|
||||
.Xr sysconf _SC_ARG_MAX ).
|
||||
.Fn sysconf _SC_ARG_MAX ) .
|
||||
.Pp
|
||||
Sure to be others.
|
||||
|
||||
@ -15,7 +15,7 @@
|
||||
.\"
|
||||
.\"
|
||||
.\" @(#)pkg_create.1
|
||||
.\" $Id: pkg_create.1,v 1.14 1995/04/22 00:03:12 jkh Exp $
|
||||
.\" $Id: pkg_create.1,v 1.15 1996/02/12 04:56:38 mpp Exp $
|
||||
.\"
|
||||
.\" hacked up by John Kohl for NetBSD--fixed a few bugs, extended keywords,
|
||||
.\" added dependency tracking, etc.
|
||||
@ -376,6 +376,6 @@ extracted. They additionally must not end up being split between
|
||||
.Cm tar
|
||||
invocations due to exec argument-space limitations (this depends on the
|
||||
value returned by
|
||||
.Xr sysconf _SC_ARG_MAX ).
|
||||
.Fn sysconf _SC_ARG_MAX ) .
|
||||
.Pp
|
||||
Sure to be others.
|
||||
|
||||
@ -28,7 +28,7 @@
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" $Id: rpc.yppasswdd.8,v 1.5 1996/02/24 21:41:47 wpaul Exp $
|
||||
.\" $Id: rpc.yppasswdd.8,v 1.2 1996/02/24 22:10:38 wpaul Exp $
|
||||
.\"
|
||||
.Dd February 8, 1996
|
||||
.Dt RPC.YPPASSWDD 8
|
||||
@ -105,7 +105,7 @@ script to rebuild the NIS maps. (This script has two arguments passed
|
||||
to it: the absolute pathname of the password template that was modified
|
||||
and the name of the domain that is to be updated. These in turn are
|
||||
passed to
|
||||
.Pa /var/yp/Makefile.)
|
||||
.Pa /var/yp/Makefile ) .
|
||||
.Pp
|
||||
The FreeBSD version of
|
||||
.Nm rpc.yppasswdd
|
||||
|
||||
Loading…
Reference in New Issue
Block a user