summaryrefslogtreecommitdiffstats
path: root/share/man/man5
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man5')
-rw-r--r--share/man/man5/a.out.517
-rw-r--r--share/man/man5/acct.52
-rw-r--r--share/man/man5/elf.521
-rw-r--r--share/man/man5/forward.52
-rw-r--r--share/man/man5/fs.54
-rw-r--r--share/man/man5/link.516
-rw-r--r--share/man/man5/make.conf.52
-rw-r--r--share/man/man5/nsswitch.conf.5115
-rw-r--r--share/man/man5/passwd.52
-rw-r--r--share/man/man5/periodic.conf.52
-rw-r--r--share/man/man5/procfs.52
-rw-r--r--share/man/man5/utmp.54
12 files changed, 116 insertions, 73 deletions
diff --git a/share/man/man5/a.out.5 b/share/man/man5/a.out.5
index 1aa6e4c..a659ba7 100644
--- a/share/man/man5/a.out.5
+++ b/share/man/man5/a.out.5
@@ -103,14 +103,15 @@ The fields have the following functions:
.It Fa a_midmag
This field is stored in host byte-order.
It has a number of sub-components accessed by the macros
-.Dv N_GETFLAG() ,
-.Dv N_GETMID() , and
-.Dv N_GETMAGIC() ,
+.Fn N_GETFLAG ,
+.Fn N_GETMID ,
+and
+.Fn N_GETMAGIC ,
and set by the macro
-.Dv N_SETMAGIC().
+.Fn N_SETMAGIC .
.Pp
The macro
-.Dv N_GETFLAG()
+.Fn N_GETFLAG
returns a few flags:
.Bl -tag -width EX_DYNAMIC
.It Dv EX_DYNAMIC
@@ -132,11 +133,11 @@ executable image (eg. a shared library), which is to be loaded into the
process address space by the run-time link editor.
.Pp
The macro
-.Dv N_GETMID()
+.Fn N_GETMID
returns the machine-id.
This indicates which machine(s) the binary is intended to run on.
.Pp
-.Dv N_GETMAGIC()
+.Fn N_GETMAGIC
specifies the magic number, which uniquely identifies binary files
and distinguishes different loading conventions.
The field must contain one of the following values:
@@ -287,7 +288,7 @@ only occurs in shared objects.
.It Fa r_copy
If set, this relocation record identifies a symbol whose contents should
be copied to the location given in
-.Fa r_address.
+.Fa r_address .
The copying is done by the run-time link-editor from a suitable data
item in a shared object.
.El
diff --git a/share/man/man5/acct.5 b/share/man/man5/acct.5
index e2c3402..56cf727 100644
--- a/share/man/man5/acct.5
+++ b/share/man/man5/acct.5
@@ -92,7 +92,7 @@ the name of the executed file (at most ten characters of it)
is saved in the field
.Fa ac_comm
and its status is saved by setting one of more of the following flags in
-.Fa ac_flag:
+.Fa ac_flag :
.Dv AFORK ,
.Dv ASU ,
.Dv ACOMPAT ,
diff --git a/share/man/man5/elf.5 b/share/man/man5/elf.5
index 5502a81..36438bf 100644
--- a/share/man/man5/elf.5
+++ b/share/man/man5/elf.5
@@ -649,7 +649,7 @@ The
system reserves indices between
.Sy SHN_LORESERVE
and
-.Sy SHN_HIRESERVE,
+.Sy SHN_HIRESERVE ,
inclusive.
The section header table does not contain entries for the
reserved indices.
@@ -1191,18 +1191,25 @@ This value down to and including
are reserved for processor-specific semantics.
.Pp
There are macros for packing and unpacking the binding and type fields:
+.Pp
.Bl -tag -width "ELF32_ST_INFO(bind, type)" -compact
-.It Dv ELF32_ST_BIND(info)
+.It Xo
+.Fn ELF32_ST_BIND info
+.Xc
or
-.Sy ELF64_ST_BIND(info)
+.Fn ELF64_ST_BIND info
extract a binding from an st_info value.
-.It Dv ELF64_ST_TYPE(info)
+.It Xo
+.Fn ELF64_ST_TYPE info
+.Xc
or
-.Sy ELF32_ST_TYPE(info)
+.Fn ELF32_ST_TYPE info
extract a type from an st_info value.
-.It Dv ELF32_ST_INFO(bind, type)
+.It Xo
+.Fn ELF32_ST_INFO bind type
+.Xc
or
-.Sy ELF64_ST_INFO(bind, type)
+.Fn ELF64_ST_INFO bind type
convert a binding and a type into an st_info value.
.El
.El
diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5
index bb3dad6..28735b1 100644
--- a/share/man/man5/forward.5
+++ b/share/man/man5/forward.5
@@ -62,7 +62,7 @@ nobody@FreeBSD.org
.Ed
.Pp
Mail would be forwarded to
-.Ar nobody@FreeBSD.org
+.Aq nobody@FreeBSD.org
and to the program
.Pa /usr/bin/vacation
with the single argument
diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5
index b47c25b..5280da0 100644
--- a/share/man/man5/fs.5
+++ b/share/man/man5/fs.5
@@ -313,7 +313,7 @@ defines the amount of space allocated in
the super-block for this name.
The limit on the amount of summary information per file system
is defined by
-.Dv MAXCSBUFS.
+.Dv MAXCSBUFS .
For a 4096 byte block size, it is currently parameterized for a
maximum of two million cylinders.
.Pp
@@ -325,7 +325,7 @@ These blocks are read in from
.Fa fs_cssize )
in addition to the super-block.
.Pp
-.Sy N.B.:
+.Sy N.B. :
.Fn sizeof "struct csum"
must be a power of two in order for
the
diff --git a/share/man/man5/link.5 b/share/man/man5/link.5
index 2106230..48f9388 100644
--- a/share/man/man5/link.5
+++ b/share/man/man5/link.5
@@ -75,7 +75,7 @@ through the .size assembler directive.
PIC code differs from conventional code
in that it accesses data variables through an indirection table, the
Global Offset Table, by convention accessible by the reserved name
-.Em _GLOBAL_OFFSET_TABLE_.
+.Dv _GLOBAL_OFFSET_TABLE_ .
The exact mechanism used for this is machine dependent, usually a machine
register is reserved for the purpose.
The rational behind this construct
@@ -105,7 +105,7 @@ If this symbol is non-zero, it points at a data structure from
which the location of the necessary relocation- and symbol information can
be derived.
This is most notably used by the start-up module,
-.Em crt0.
+.Em crt0 .
The _DYNAMIC structure is conventionally located at the start of the data
segment of the image to which it pertains.
.Pp
@@ -138,11 +138,11 @@ The current version numbers understood by
and
.Xr ld.so 1
are
-.Em LD_VERSION_SUN (3),
+.Em LD_VERSION_SUN (3) ,
which is used by the
.Tn SunOS
4.x releases, and
-.Em LD_VERSION_BSD (8),
+.Em LD_VERSION_BSD (8) ,
which has been in use since
.Fx 1.1 .
.It Fa d_un
@@ -214,7 +214,7 @@ The number of buckets in
.Fa sdt_hash
.It Fa sdt_strings
The location of the symbol string table that goes with
-.Fa sdt_nzlist.
+.Fa sdt_nzlist .
.It Fa sdt_str_sz
The size of the string table.
.It Fa sdt_text_sz
@@ -262,7 +262,7 @@ see also
.Xr ldconfig 8
.Pc
for a shared object matching
-.Em lib\&<sod_name>\&.so.n.m.
+.Em lib\&<sod_name>\&.so.n.m .
If not set,
.Fa sod_name
should point at a full path name for the desired shared object.
@@ -325,7 +325,7 @@ An array of these lives in the shared object's
text segment and is addressed by the
.Fa sdt_nzlist
field of
-.Fa section_dispatch_table.
+.Fa section_dispatch_table .
.Bd -literal -offset indent
struct nzlist {
struct nlist nlist;
@@ -449,7 +449,7 @@ The address were a breakpoint will be set by the run-time linker to
divert control to the debugger.
This address is determined by the start-up
module,
-.Em crt0.o,
+.Pa crt0.o ,
to be some convenient place before the call to _main.
.It Fa dd_bpt_shadow
Contains the original instruction that was at
diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5
index 7f74526..978af0e 100644
--- a/share/man/man5/make.conf.5
+++ b/share/man/man5/make.conf.5
@@ -339,7 +339,7 @@ Set this to build KerberosIV (KTH eBones).
.It Va MAKE_KERBEROS5
.Vt ( bool )
Set this to build Kerberos5 (KTH Heimdal).
-.Em WARNING!
+.Em WARNING !
This is still experimental code.
If you need stable Kerberos5, use the
port(s).
diff --git a/share/man/man5/nsswitch.conf.5 b/share/man/man5/nsswitch.conf.5
index 1e7deff..4f48708 100644
--- a/share/man/man5/nsswitch.conf.5
+++ b/share/man/man5/nsswitch.conf.5
@@ -62,13 +62,17 @@ Each criterion consists of one or more status codes, and actions to
take if that status code occurs.
.Ss Sources
The following sources are implemented:
-.Bl -column "compat" -offset indent -compact
-.It Sy "Source Description
-.It "files Local files, such as"
+.Pp
+.Bl -tag -width Source -compact
+.It Sy Source
+.Sy Description
+.It files
+Local files, such as
.Pa /etc/hosts ,
and
.Pa /etc/passwd .
-.It "dns Internet Domain Name System."
+.It dns
+Internet Domain Name System.
.Dq hosts
and
.Sq networks
@@ -77,8 +81,10 @@ use
class entries, all other databases use
.Sy HS
class (Hesiod) entries.
-.It "nis NIS (formerly YP)"
-.It "compat support"
+.It nis
+NIS (formerly YP)
+.It compat
+support
.Sq +/-
in the
.Dq passwd
@@ -89,34 +95,46 @@ If this is present, it must be the only source for that entry.
.El
.Ss Databases
The following databases are used by the following C library functions:
-.Bl -column "networks" -offset indent -compact
-.It Sy "Database Used by"
-.It "group "
+.Pp
+.Bl -tag -width networks -compact
+.It Sy Database
+.Sy "Used by"
+.It group
.Xr getgrent 3
-.It "hosts "
+.It hosts
.Xr gethostbyname 3
-.It "networks "
+.It networks
.Xr getnetbyname 3
-.It "passwd "
+.It passwd
.Xr getpwent 3
-.It "shells "
+.It shells
.Xr getusershell 3
.El
.Ss Status codes
The following status codes are available:
-.Bl -column "tryagain" -offset indent -compact
-.It Sy "Status Description"
-.It "success The requested entry was found."
-.It "notfound The entry is not present at this source."
-.It "tryagain The source is busy, and may respond to retries."
-.It "unavail The source is not responding, or entry is corrupt."
+.Pp
+.Bl -tag -width tryagain -compact
+.It Sy Status
+.Sy Description
+.It success
+The requested entry was found.
+.It notfound
+The entry is not present at this source.
+.It tryagain
+The source is busy, and may respond to retries.
+.It unavail
+The source is not responding, or entry is corrupt.
.El
.Ss Actions
For each of the status codes, one of two actions is possible:
-.Bl -column "continue" -offset indent -compact
-.It Sy "Action Description"
-.It "continue Try the next source"
-.It "return Return with the current result"
+.Pp
+.Bl -tag -width continue -compact
+.It Sy Action
+.Sy Description
+.It continue
+Try the next source
+.It return
+Return with the current result
.El
.Ss Format of file
A
@@ -124,16 +142,22 @@ A
description of the syntax of
.Nm
is:
-.Bl -column "<criterion>" -offset indent
-.It "<entry> ::="
+.Pp
+.Bl -tag -width <criterion> -compact
+.It <entry>
+::=
<database> ":" [<source> [<criteria>]]*
-.It "<criteria> ::="
+.It <criteria>
+::=
"[" <criterion>+ "]"
-.It "<criterion> ::="
+.It <criterion>
+::=
<status> "=" <action>
-.It "<status> ::="
+.It <status>
+::=
"success" | "notfound" | "unavail" | "tryagain"
-.It "<action> ::="
+.It <action>
+::=
"return" | "continue"
.El
.Pp
@@ -206,13 +230,20 @@ will default to an entry of
.Dq files
for the requested database.
Exceptions are:
-.Bl -column passwd_compat "dns files" -offset indent
-.It Sy "Database Default source list"
-.It "group compat"
-.It "group_compat nis"
-.It "hosts dns files"
-.It "passwd compat"
-.It "passwd_compat nis"
+.Pp
+.Bl -tag -width passwd_compat -compact
+.It Sy Database
+.Sy "Default source list"
+.It group
+compat
+.It group_compat
+nis
+.It hosts
+dns files
+.It passwd
+compat
+.It passwd_compat
+nis
.El
.Sh FILES
.Bl -tag -width /etc/nsswitch.conf -compact
@@ -228,10 +259,14 @@ To lookup hosts in
and then from the DNS, and lookup user information from
.Tn NIS
then files, use:
-.Bl -column "passwd:" -offset indent
-.It "hosts: files dns"
-.It "passwd: nis [notfound=return] files"
-.It "group: nis [notfound=return] files"
+.Pp
+.Bl -tag -width passwd: -compact
+.It hosts:
+files dns
+.It passwd:
+nis [notfound=return] files
+.It group:
+nis [notfound=return] files
.El
.Pp
The criteria
diff --git a/share/man/man5/passwd.5 b/share/man/man5/passwd.5
index 7b49790..23037cb 100644
--- a/share/man/man5/passwd.5
+++ b/share/man/man5/passwd.5
@@ -281,7 +281,7 @@ fields, the specified numbers will override the information retrieved
from the Hesiod domain or the
.Tn NIS
maps. As well, if the
-.Ar gecos,
+.Ar gecos ,
.Ar dir
or
.Ar shell
diff --git a/share/man/man5/periodic.conf.5 b/share/man/man5/periodic.conf.5
index 74a3937..20ff45c 100644
--- a/share/man/man5/periodic.conf.5
+++ b/share/man/man5/periodic.conf.5
@@ -333,7 +333,7 @@ if
is set to
.Dq YES
in
-.Pa /etc/rc.conf ).
+.Pa /etc/rc.conf ) .
.It Ar daily_status_mailq_enable
(bool) Set to
.Dq YES
diff --git a/share/man/man5/procfs.5 b/share/man/man5/procfs.5
index 68fe968..a67703d 100644
--- a/share/man/man5/procfs.5
+++ b/share/man/man5/procfs.5
@@ -142,7 +142,7 @@ process group id
.It
session id
.It
-.Ar major,minor
+.Ar major , Ns Ar minor
of the controlling terminal, or
.Dv -1,-1
if there is no controlling terminal.
diff --git a/share/man/man5/utmp.5 b/share/man/man5/utmp.5
index ca0d4fd..2ef38ef 100644
--- a/share/man/man5/utmp.5
+++ b/share/man/man5/utmp.5
@@ -91,7 +91,7 @@ Each time a user logs in, the
program looks up the user's
.Tn UID
in the file
-.Nm lastlog.
+.Nm lastlog .
If it is found, the timestamp of the last time the user logged
in, the terminal line and the hostname
are written to the standard output (unless the login is
@@ -179,7 +179,7 @@ is recorded in the field
In the field
.Fa ut_line ,
the character
-.Ql \\*(Ba
+.Ql \&|
indicates the time prior to the change, and the character
.Ql \&{
indicates the new time.
OpenPOWER on IntegriCloud