Prepare for mdoc(7)NG.
This commit is contained in:
parent
030f23696c
commit
4263595653
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=70481
@ -138,13 +138,13 @@ The following is a list of all signals
|
||||
with names as in the include file
|
||||
.Aq Pa signal.h :
|
||||
.Bl -column SIGVTALARMXX "create core imagexxx"
|
||||
.It Sy " NAME " " Default Action " " Description"
|
||||
.It Sy "NAME Default Action Description"
|
||||
.It Dv SIGHUP No " terminate process" " terminal line hangup"
|
||||
.It Dv SIGINT No " terminate process" " interrupt program"
|
||||
.It Dv SIGQUIT No " create core image" " quit program"
|
||||
.It Dv SIGILL No " create core image" " illegal instruction"
|
||||
.It Dv SIGTRAP No " create core image" " trace trap"
|
||||
.It Dv SIGABRT No " create core image" Xr abort 3
|
||||
.It Dv SIGABRT No " create core image" Ta Xr abort 3
|
||||
call (formerly
|
||||
.Dv SIGIOT )
|
||||
.It Dv SIGEMT No " create core image" " emulate instruction executed"
|
||||
|
@ -79,7 +79,7 @@ The copied value is always null terminated.
|
||||
.Pp
|
||||
The available values are as follows:
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.Pp
|
||||
.It Li _CS_PATH
|
||||
Return a value for the
|
||||
@ -119,6 +119,7 @@ In addition, the following errors may be reported:
|
||||
The value of the
|
||||
.Fa name
|
||||
argument is invalid.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr sysctl 3
|
||||
.Sh HISTORY
|
||||
|
@ -283,4 +283,3 @@ retrieved via a call to
|
||||
.Xr ld 1 ,
|
||||
.Xr rtld 1 ,
|
||||
.Xr link 5
|
||||
|
||||
|
@ -164,9 +164,9 @@ This is an error return, and the
|
||||
field will be set to indicate what caused the error.
|
||||
.It Dv FTS_DOT
|
||||
A file named
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
or
|
||||
.Ql ..
|
||||
.Ql ..\&
|
||||
which was not specified as a file name to
|
||||
.Fn fts_open
|
||||
(see
|
||||
@ -441,9 +441,9 @@ function.
|
||||
By default, unless they are specified as path arguments to
|
||||
.Fn fts_open ,
|
||||
any files named
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
or
|
||||
.Ql ..
|
||||
.Ql ..\&
|
||||
encountered in the file hierarchy are ignored.
|
||||
This option causes the
|
||||
.Nm
|
||||
|
@ -430,6 +430,7 @@ does not exist
|
||||
.It Em name No \&=@ Ta "the string capability"
|
||||
.Em name
|
||||
does not exist
|
||||
.Sm on
|
||||
.El
|
||||
.Pp
|
||||
Numeric capability values may be given in one of three numeric bases.
|
||||
@ -526,7 +527,7 @@ No memory to allocate.
|
||||
Colons (`:') can't be used in names, types, or values.
|
||||
.Pp
|
||||
There are no checks for
|
||||
.Ic tc= name
|
||||
.Ic tc Ns = Ns Ic name
|
||||
loops in
|
||||
.Fn cgetent .
|
||||
.Pp
|
||||
|
@ -112,11 +112,13 @@ If the environment variable
|
||||
is set, it overrides the default object file format.
|
||||
.Ev OBJFORMAT takes precedence over
|
||||
.Pa /etc/objformat .
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width /etc/objformat -compact
|
||||
.It Pa /etc/objformat
|
||||
If present, specifies the object file format to use. Syntax is
|
||||
.Ql OBJFORMAT=xxx .
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr objformat 1
|
||||
.Sh HISTORY
|
||||
|
@ -83,6 +83,7 @@ pointer contains an invalid address.
|
||||
The
|
||||
.Fa name
|
||||
specifies a filesystem that is unknown or not configured in the kernel.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr mount 2 ,
|
||||
.Xr sysctl 3 ,
|
||||
|
@ -86,7 +86,7 @@ and read permission on each directory of any filename component of
|
||||
.Fa pattern
|
||||
that contains any of the special characters
|
||||
.Ql * ,
|
||||
.Ql ?
|
||||
.Ql ?\&
|
||||
or
|
||||
.Ql [ .
|
||||
.Pp
|
||||
|
@ -247,6 +247,7 @@ or
|
||||
.Dv F_TLOCK ,
|
||||
and satisfying the lock or unlock request would result in the number
|
||||
of locked regions in the system exceeding a system-imposed limit.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr fcntl 2 ,
|
||||
.Xr flock 2
|
||||
|
@ -51,7 +51,7 @@ The
|
||||
system call performs some control operations on the message queue specified
|
||||
by
|
||||
.Fa msqid .
|
||||
|
||||
.Pp
|
||||
Each message queue has a data structure associated with it, parts of which
|
||||
may be altered by
|
||||
.Fn msgctl
|
||||
@ -139,7 +139,6 @@ Values for
|
||||
that exceed the system limit (MSGMNB from
|
||||
.Aq Pa sys/msg.h )
|
||||
are silently truncated to that limit.
|
||||
|
||||
.It Dv IPC_RMID
|
||||
Remove the message queue specified by
|
||||
.Fa msqid
|
||||
@ -151,7 +150,7 @@ or
|
||||
.Va msg_perm.uid
|
||||
values in the data structure associated with the queue can do this.
|
||||
.El
|
||||
|
||||
.Pp
|
||||
The permission to read from or write to a message queue (see
|
||||
.Xr msgsnd 3
|
||||
and
|
||||
@ -188,7 +187,7 @@ the effective uid match either the
|
||||
or
|
||||
.Va msg_perm.cuid
|
||||
fields of the data structure associated with the message queue.
|
||||
|
||||
.Pp
|
||||
An attempt is made to increase the value of
|
||||
.Va msg_qbytes
|
||||
through IPC_SET
|
||||
@ -199,7 +198,7 @@ and the caller has no read permission for this message queue.
|
||||
.It Bq Er EINVAL
|
||||
.Fa msqid
|
||||
is not a valid message queue identifier.
|
||||
|
||||
.Pp
|
||||
.Va cmd
|
||||
is not a valid command.
|
||||
.It Bq Er EFAULT
|
||||
|
@ -147,6 +147,7 @@ is set to the current time.
|
||||
.It
|
||||
.Va msg_qnum
|
||||
is decremented by 1.
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
Upon successful completion,
|
||||
.Fn msgrcv
|
||||
@ -191,6 +192,7 @@ and
|
||||
.Dv IPC_NOWAIT
|
||||
is set in
|
||||
.Fa msgflg .
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr msgctl 3 ,
|
||||
.Xr msgget 3 ,
|
||||
|
@ -1,4 +1,4 @@
|
||||
\" Copyright (c) 1993 Martin Birgmeier
|
||||
.\" Copyright (c) 1993 Martin Birgmeier
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" You may redistribute unmodified or modified versions of this source
|
||||
|
@ -91,7 +91,7 @@ an interrupt.
|
||||
These signals are defined in the file
|
||||
.Aq Pa signal.h :
|
||||
.Bl -column SIGVTALARMXX "create core imagexxx"
|
||||
.It Sy Name Default Action Description
|
||||
.It Sy "Name Default Action Description"
|
||||
.It Dv SIGHUP Ta "terminate process" Ta "terminal line hangup"
|
||||
.It Dv SIGINT Ta "terminate process" Ta "interrupt program"
|
||||
.It Dv SIGQUIT Ta "create core image" Ta "quit program"
|
||||
@ -218,6 +218,7 @@ An attempt is made to ignore or supply a handler for
|
||||
.Dv SIGKILL
|
||||
or
|
||||
.Ev SIGSTOP .
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kill 1 ,
|
||||
.Xr kill 2 ,
|
||||
|
@ -63,7 +63,7 @@ Symbolic constants for each name value are found in the include file
|
||||
.Pp
|
||||
The available values are as follows:
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.Pp
|
||||
.It Li _SC_ARG_MAX
|
||||
The maximum bytes of argument to
|
||||
@ -170,6 +170,7 @@ In addition, the following error may be reported:
|
||||
The value of the
|
||||
.Fa name
|
||||
argument is invalid.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr sysctl 3
|
||||
.Sh BUGS
|
||||
|
@ -133,15 +133,15 @@ The next and subsequent levels down are found in the include files
|
||||
listed here, and described in separate sections below.
|
||||
.Pp
|
||||
.Bl -column CTLXMACHDEPXXX "Next level namesXXXXXX" -offset indent
|
||||
.It Sy Pa Name Next level names Description
|
||||
.It CTL\_DEBUG sys/sysctl.h Debugging
|
||||
.It CTL\_VFS sys/mount.h Filesystem
|
||||
.It CTL\_HW sys/sysctl.h Generic CPU, I/O
|
||||
.It CTL\_KERN sys/sysctl.h High kernel limits
|
||||
.It CTL\_MACHDEP sys/sysctl.h Machine dependent
|
||||
.It CTL\_NET sys/socket.h Networking
|
||||
.It CTL\_USER sys/sysctl.h User-level
|
||||
.It CTL\_VM vm/vm_param.h Virtual memory
|
||||
.It Sy Pa "Name Next level names Description"
|
||||
.It "CTL\_DEBUG sys/sysctl.h Debugging"
|
||||
.It "CTL\_VFS sys/mount.h Filesystem"
|
||||
.It "CTL\_HW sys/sysctl.h Generic CPU, I/O"
|
||||
.It "CTL\_KERN sys/sysctl.h High kernel limits"
|
||||
.It "CTL\_MACHDEP sys/sysctl.h Machine dependent"
|
||||
.It "CTL\_NET sys/socket.h Networking"
|
||||
.It "CTL\_USER sys/sysctl.h User-level"
|
||||
.It "CTL\_VM vm/vm_param.h Virtual memory"
|
||||
.El
|
||||
.Pp
|
||||
For example, the following retrieves the maximum number of processes allowed
|
||||
@ -219,21 +219,21 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "Second level nameXXXXXX" integerXXX -offset indent
|
||||
.It Sy Pa Second level name Type Changeable
|
||||
.It HW\_MACHINE string no
|
||||
.It HW\_MODEL string no
|
||||
.It HW\_NCPU integer no
|
||||
.It HW\_BYTEORDER integer no
|
||||
.It HW\_PHYSMEM integer no
|
||||
.It HW\_USERMEM integer no
|
||||
.It HW\_PAGESIZE integer no
|
||||
.It HW\_FLOATINGPOINT integer no
|
||||
.It HW\_MACHINE\_ARCH string no
|
||||
.\".It HW\_DISKNAMES integer no
|
||||
.\".It HW\_DISKSTATS integer no
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It "HW\_MACHINE string no"
|
||||
.It "HW\_MODEL string no"
|
||||
.It "HW\_NCPU integer no"
|
||||
.It "HW\_BYTEORDER integer no"
|
||||
.It "HW\_PHYSMEM integer no"
|
||||
.It "HW\_USERMEM integer no"
|
||||
.It "HW\_PAGESIZE integer no"
|
||||
.It "HW\_FLOATINGPOINT integer no"
|
||||
.It "HW\_MACHINE\_ARCH string no"
|
||||
.\".It "HW\_DISKNAMES integer no"
|
||||
.\".It "HW\_DISKSTATS integer no"
|
||||
.El
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.It Li HW_MACHINE
|
||||
The machine class.
|
||||
.It Li HW_MODEL
|
||||
@ -265,38 +265,38 @@ system vnodes, the open file entries, routing table entries,
|
||||
virtual memory statistics, load average history, and clock rate
|
||||
information.
|
||||
.Bl -column "KERNXMAXFILESPERPROCXXX" "struct clockrateXXX" -offset indent
|
||||
.It Sy Pa Second level name Type Changeable
|
||||
.It KERN\_ARGMAX integer no
|
||||
.It KERN\_BOOTFILE string yes
|
||||
.It KERN\_BOOTTIME struct timeval no
|
||||
.It KERN\_CLOCKRATE struct clockinfo no
|
||||
.It KERN\_FILE struct file no
|
||||
.It KERN\_HOSTID integer yes
|
||||
.It KERN\_HOSTNAME string yes
|
||||
.It KERN\_JOB\_CONTROL integer no
|
||||
.It KERN\_MAXFILES integer yes
|
||||
.It KERN\_MAXFILESPERPROC integer yes
|
||||
.It KERN\_MAXPROC integer no
|
||||
.It KERN\_MAXPROCPERUID integer yes
|
||||
.It KERN\_MAXVNODES integer yes
|
||||
.It KERN\_NGROUPS integer no
|
||||
.It KERN\_NISDOMAINNAME string yes
|
||||
.It KERN\_OSRELDATE integer no
|
||||
.It KERN\_OSRELEASE string no
|
||||
.It KERN\_OSREV integer no
|
||||
.It KERN\_OSTYPE string no
|
||||
.It KERN\_POSIX1 integer no
|
||||
.It KERN\_PROC struct proc no
|
||||
.It KERN\_PROF node not applicable
|
||||
.It KERN\_QUANTUM integer yes
|
||||
.It KERN\_SAVED\_IDS integer no
|
||||
.It KERN\_SECURELVL integer raise only
|
||||
.It KERN\_UPDATEINTERVAL integer no
|
||||
.It KERN\_VERSION string no
|
||||
.It KERN\_VNODE struct vnode no
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It "KERN\_ARGMAX integer no"
|
||||
.It "KERN\_BOOTFILE string yes"
|
||||
.It "KERN\_BOOTTIME struct timeval no"
|
||||
.It "KERN\_CLOCKRATE struct clockinfo no"
|
||||
.It "KERN\_FILE struct file no"
|
||||
.It "KERN\_HOSTID integer yes"
|
||||
.It "KERN\_HOSTNAME string yes"
|
||||
.It "KERN\_JOB\_CONTROL integer no"
|
||||
.It "KERN\_MAXFILES integer yes"
|
||||
.It "KERN\_MAXFILESPERPROC integer yes"
|
||||
.It "KERN\_MAXPROC integer no"
|
||||
.It "KERN\_MAXPROCPERUID integer yes"
|
||||
.It "KERN\_MAXVNODES integer yes"
|
||||
.It "KERN\_NGROUPS integer no"
|
||||
.It "KERN\_NISDOMAINNAME string yes"
|
||||
.It "KERN\_OSRELDATE integer no"
|
||||
.It "KERN\_OSRELEASE string no"
|
||||
.It "KERN\_OSREV integer no"
|
||||
.It "KERN\_OSTYPE string no"
|
||||
.It "KERN\_POSIX1 integer no"
|
||||
.It "KERN\_PROC struct proc no"
|
||||
.It "KERN\_PROF node not applicable"
|
||||
.It "KERN\_QUANTUM integer yes"
|
||||
.It "KERN\_SAVED\_IDS integer no"
|
||||
.It "KERN\_SECURELVL integer raise only"
|
||||
.It "KERN\_UPDATEINTERVAL integer no"
|
||||
.It "KERN\_VERSION string no"
|
||||
.It "KERN\_VNODE struct vnode no"
|
||||
.El
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.It Li KERN_ARGMAX
|
||||
The maximum bytes of argument to
|
||||
.Xr execve 2 .
|
||||
@ -371,13 +371,13 @@ structures is returned,
|
||||
whose size depends on the current number of such objects in the system.
|
||||
The third and fourth level names are as follows:
|
||||
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
|
||||
.It Pa Third level name Fourth level is:
|
||||
.It KERN\_PROC\_ALL None
|
||||
.It KERN\_PROC\_PID A process ID
|
||||
.It KERN\_PROC\_PGRP A process group
|
||||
.It KERN\_PROC\_TTY A tty device
|
||||
.It KERN\_PROC\_UID A user ID
|
||||
.It KERN\_PROC\_RUID A real user ID
|
||||
.It Pa "Third level name Fourth level is:"
|
||||
.It "KERN\_PROC\_ALL None"
|
||||
.It "KERN\_PROC\_PID A process ID"
|
||||
.It "KERN\_PROC\_PGRP A process group"
|
||||
.It "KERN\_PROC\_TTY A tty device"
|
||||
.It "KERN\_PROC\_UID A user ID"
|
||||
.It "KERN\_PROC\_RUID A real user ID"
|
||||
.El
|
||||
.Pp
|
||||
If the third level name is KERN_PROC_ARGS then the command line argument
|
||||
@ -386,8 +386,8 @@ follow each other.
|
||||
The total size of array is returned.
|
||||
It is also possible for a process to set its own process title this way.
|
||||
.Bl -column "Third level nameXXXXXX" "Fourth level is:XXXXXX" -offset indent
|
||||
.It Pa Third level name Fourth level is:
|
||||
.It KERN\_PROC\_ARGS A process ID
|
||||
.It Pa "Third level name Fourth level is:"
|
||||
.It "KERN\_PROC\_ARGS A process ID"
|
||||
.El
|
||||
.It Li KERN_PROF
|
||||
Return profiling information about the kernel.
|
||||
@ -400,16 +400,16 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "GPROFXGMONPARAMXXX" "struct gmonparamXXX" -offset indent
|
||||
.It Sy Pa Third level name Type Changeable
|
||||
.It GPROF\_STATE integer yes
|
||||
.It GPROF\_COUNT u_short[\|] yes
|
||||
.It GPROF\_FROMS u_short[\|] yes
|
||||
.It GPROF\_TOS struct tostruct yes
|
||||
.It GPROF\_GMONPARAM struct gmonparam no
|
||||
.It Sy Pa "Third level name Type Changeable"
|
||||
.It "GPROF\_STATE integer yes"
|
||||
.It "GPROF\_COUNT u_short[\|] yes"
|
||||
.It "GPROF\_FROMS u_short[\|] yes"
|
||||
.It "GPROF\_TOS struct tostruct yes"
|
||||
.It "GPROF\_GMONPARAM struct gmonparam no"
|
||||
.El
|
||||
.Pp
|
||||
The variables are as follows:
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.It Li GPROF_STATE
|
||||
Returns GMON_PROF_ON or GMON_PROF_OFF to show that profiling
|
||||
is running or stopped.
|
||||
@ -450,12 +450,12 @@ followed by the vnode itself
|
||||
The set of variables defined is architecture dependent.
|
||||
The following variables are defined for the i386 architecture.
|
||||
.Bl -column "CONSOLE_DEVICEXXX" "struct bootinfoXXX" -offset indent
|
||||
.It Sy Pa Second level name Type Changeable
|
||||
.It Li CPU_CONSDEV dev_t no
|
||||
.It Li CPU_ADJKERNTZ int yes
|
||||
.It Li CPU_DISRTCSET int yes
|
||||
.It Li CPU_BOOTINFO struct bootinfo no
|
||||
.It Li CPU_WALLCLOCK int yes
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It Li "CPU_CONSDEV dev_t no"
|
||||
.It Li "CPU_ADJKERNTZ int yes"
|
||||
.It Li "CPU_DISRTCSET int yes"
|
||||
.It Li "CPU_BOOTINFO struct bootinfo no"
|
||||
.It Li "CPU_WALLCLOCK int yes"
|
||||
.El
|
||||
.Ss CTL_NET
|
||||
The string and integer information available for the CTL_NET level
|
||||
@ -463,13 +463,13 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "Second level nameXXXXXX" "routing messagesXXX" -offset indent
|
||||
.It Sy Pa Second level name Type Changeable
|
||||
.It PF\_ROUTE routing messages no
|
||||
.It PF\_INET IPv4 values yes
|
||||
.It PF\_INET6 IPv6 values yes
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It "PF\_ROUTE routing messages no"
|
||||
.It "PF\_INET IPv4 values yes"
|
||||
.It "PF\_INET6 IPv6 values yes"
|
||||
.El
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.It Li PF_ROUTE
|
||||
Return the entire routing table or a subset of it.
|
||||
The data is returned as a sequence of routing messages (see
|
||||
@ -482,10 +482,10 @@ The fourth level name is an address family, which may be set to 0 to
|
||||
select all address families.
|
||||
The fifth and sixth level names are as follows:
|
||||
.Bl -column "Fifth level nameXXXXXX" "Sixth level is:XXX" -offset indent
|
||||
.It Pa Fifth level name Sixth level is:
|
||||
.It NET\_RT\_FLAGS rtflags
|
||||
.It NET\_RT\_DUMP None
|
||||
.It NET\_RT\_IFLIST None
|
||||
.It Pa "Fifth level name Sixth level is:"
|
||||
.It "NET\_RT\_FLAGS rtflags"
|
||||
.It "NET\_RT\_DUMP None"
|
||||
.It "NET\_RT\_IFLIST None"
|
||||
.El
|
||||
.It Li PF_INET
|
||||
Get or set various global information about the IPv4
|
||||
@ -494,17 +494,17 @@ The third level name is the protocol.
|
||||
The fourth level name is the variable name.
|
||||
The currently defined protocols and names are:
|
||||
.Bl -column ProtocolXX VariableXX TypeXX ChangeableXX
|
||||
.It Pa Protocol Variable Type Changeable
|
||||
.It icmp bmcastecho integer yes
|
||||
.It icmp maskrepl integer yes
|
||||
.It ip forwarding integer yes
|
||||
.It ip redirect integer yes
|
||||
.It ip ttl integer yes
|
||||
.It udp checksum integer yes
|
||||
.It Pa "Protocol Variable Type Changeable"
|
||||
.It "icmp bmcastecho integer yes"
|
||||
.It "icmp maskrepl integer yes"
|
||||
.It "ip forwarding integer yes"
|
||||
.It "ip redirect integer yes"
|
||||
.It "ip ttl integer yes"
|
||||
.It "udp checksum integer yes"
|
||||
.El
|
||||
.Pp
|
||||
The variables are as follows:
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.It Li icmp.bmcastecho
|
||||
Returns 1 if an ICMP echo request to a broadcast or multicast address is
|
||||
to be answered.
|
||||
@ -545,29 +545,29 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "USER_COLL_WEIGHTS_MAXXXX" "integerXXX" -offset indent
|
||||
.It Sy Pa Second level name Type Changeable
|
||||
.It USER\_BC\_BASE\_MAX integer no
|
||||
.It USER\_BC\_DIM\_MAX integer no
|
||||
.It USER\_BC\_SCALE\_MAX integer no
|
||||
.It USER\_BC\_STRING\_MAX integer no
|
||||
.It USER\_COLL\_WEIGHTS\_MAX integer no
|
||||
.It USER\_CS\_PATH string no
|
||||
.It USER\_EXPR\_NEST\_MAX integer no
|
||||
.It USER\_LINE\_MAX integer no
|
||||
.It USER\_POSIX2\_CHAR\_TERM integer no
|
||||
.It USER\_POSIX2\_C\_BIND integer no
|
||||
.It USER\_POSIX2\_C\_DEV integer no
|
||||
.It USER\_POSIX2\_FORT\_DEV integer no
|
||||
.It USER\_POSIX2\_FORT\_RUN integer no
|
||||
.It USER\_POSIX2\_LOCALEDEF integer no
|
||||
.It USER\_POSIX2\_SW\_DEV integer no
|
||||
.It USER\_POSIX2\_UPE integer no
|
||||
.It USER\_POSIX2\_VERSION integer no
|
||||
.It USER\_RE\_DUP\_MAX integer no
|
||||
.It USER\_STREAM\_MAX integer no
|
||||
.It USER\_TZNAME\_MAX integer no
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It "USER\_BC\_BASE\_MAX integer no"
|
||||
.It "USER\_BC\_DIM\_MAX integer no"
|
||||
.It "USER\_BC\_SCALE\_MAX integer no"
|
||||
.It "USER\_BC\_STRING\_MAX integer no"
|
||||
.It "USER\_COLL\_WEIGHTS\_MAX integer no"
|
||||
.It "USER\_CS\_PATH string no"
|
||||
.It "USER\_EXPR\_NEST\_MAX integer no"
|
||||
.It "USER\_LINE\_MAX integer no"
|
||||
.It "USER\_POSIX2\_CHAR\_TERM integer no"
|
||||
.It "USER\_POSIX2\_C\_BIND integer no"
|
||||
.It "USER\_POSIX2\_C\_DEV integer no"
|
||||
.It "USER\_POSIX2\_FORT\_DEV integer no"
|
||||
.It "USER\_POSIX2\_FORT\_RUN integer no"
|
||||
.It "USER\_POSIX2\_LOCALEDEF integer no"
|
||||
.It "USER\_POSIX2\_SW\_DEV integer no"
|
||||
.It "USER\_POSIX2\_UPE integer no"
|
||||
.It "USER\_POSIX2\_VERSION integer no"
|
||||
.It "USER\_RE\_DUP\_MAX integer no"
|
||||
.It "USER\_STREAM\_MAX integer no"
|
||||
.It "USER\_TZNAME\_MAX integer no"
|
||||
.El
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.Pp
|
||||
.It Li USER_BC_BASE_MAX
|
||||
The maximum ibase/obase values in the
|
||||
@ -641,21 +641,21 @@ is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
privilege may change the value.
|
||||
.Bl -column "Second level nameXXXXXX" "struct loadavgXXX" -offset indent
|
||||
.It Sy Pa Second level name Type Changeable
|
||||
.It VM\_LOADAVG struct loadavg no
|
||||
.It VM\_METER struct vmtotal no
|
||||
.It VM\_PAGEOUT\_ALGORITHM integer yes
|
||||
.It VM\_SWAPPING\_ENABLED integer maybe
|
||||
.It VM\_V\_CACHE\_MAX integer yes
|
||||
.It VM\_V\_CACHE\_MIN integer yes
|
||||
.It VM\_V\_FREE\_MIN integer yes
|
||||
.It VM\_V\_FREE\_RESERVED integer yes
|
||||
.It VM\_V\_FREE\_TARGET integer yes
|
||||
.It VM\_V\_INACTIVE\_TARGET integer yes
|
||||
.It VM\_V\_PAGEOUT\_FREE\_MIN integer yes
|
||||
.It Sy Pa "Second level name Type Changeable"
|
||||
.It "VM\_LOADAVG struct loadavg no"
|
||||
.It "VM\_METER struct vmtotal no"
|
||||
.It "VM\_PAGEOUT\_ALGORITHM integer yes"
|
||||
.It "VM\_SWAPPING\_ENABLED integer maybe"
|
||||
.It "VM\_V\_CACHE\_MAX integer yes"
|
||||
.It "VM\_V\_CACHE\_MIN integer yes"
|
||||
.It "VM\_V\_FREE\_MIN integer yes"
|
||||
.It "VM\_V\_FREE\_RESERVED integer yes"
|
||||
.It "VM\_V\_FREE\_TARGET integer yes"
|
||||
.It "VM\_V\_INACTIVE\_TARGET integer yes"
|
||||
.It "VM\_V\_PAGEOUT\_FREE\_MIN integer yes"
|
||||
.El
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.It Li VM_LOADAVG
|
||||
Return the load average history.
|
||||
The returned data consists of a
|
||||
|
@ -78,6 +78,7 @@ The following error codes may be set in
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EFAULT
|
||||
An argument address referenced invalid memory.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr gettimeofday 2 ,
|
||||
.Xr ctime 3
|
||||
|
@ -79,7 +79,7 @@ is used (without leap second correction).
|
||||
If
|
||||
.Ev TZ
|
||||
appears in the environment and its value begins with a colon
|
||||
.Pq Ql \: ,
|
||||
.Pq Ql \&: ,
|
||||
the rest of its value is used as a pathname of a
|
||||
.Xr tzfile 5 Ns -format
|
||||
file from which to read the time conversion information.
|
||||
@ -140,7 +140,7 @@ is required; if
|
||||
is missing, then summer time does not apply in this locale.
|
||||
Upper and lowercase letters are explicitly allowed. Any characters
|
||||
except a leading colon
|
||||
.Pq Ql \: ,
|
||||
.Pq Ql \&: ,
|
||||
digits, comma
|
||||
.Pq Ql \&, ,
|
||||
minus
|
||||
@ -287,7 +287,7 @@ values in
|
||||
.El
|
||||
.Pp
|
||||
For compatibility with System V Release 3.1, a semicolon
|
||||
.Pq Ql \;
|
||||
.Pq Ql \&;
|
||||
may be used to separate the
|
||||
.Em rule
|
||||
from the rest of the specification.
|
||||
@ -301,7 +301,8 @@ time zone directory
|
||||
rules for
|
||||
.Tn POSIX Ns -style
|
||||
.Tn TZ Ns 's
|
||||
.It Pa /usr/share/zoneinfo/GMT for
|
||||
.It Pa /usr/share/zoneinfo/GMT
|
||||
for
|
||||
.Tn UTC
|
||||
leap seconds
|
||||
.El
|
||||
|
@ -173,7 +173,7 @@ again:
|
||||
(void) putchar(out);
|
||||
goto again;
|
||||
case UNVIS_SYNBAD:
|
||||
(void)fprintf(stderr, "bad sequence!\n");
|
||||
(void)fprintf(stderr, "bad sequence!\en");
|
||||
exit(1);
|
||||
}
|
||||
}
|
||||
|
@ -73,6 +73,7 @@ will fail if:
|
||||
.It Bq Er EINTR
|
||||
A signal was delivered to the process and its
|
||||
action was to invoke a signal-catching function.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr nanosleep 2 ,
|
||||
.Xr sleep 3
|
||||
|
@ -275,4 +275,3 @@ ambiguous and non-invertible.
|
||||
.Sh HISTORY
|
||||
These functions first appeared in
|
||||
.Bx 4.4 .
|
||||
|
||||
|
@ -98,8 +98,9 @@ have their execution time measured.
|
||||
Profiling begins on return from
|
||||
.Fn monstartup .
|
||||
.Sh FILES
|
||||
.Bl -tag -width Pa -compact
|
||||
.It Pa progname.gmon execution data file
|
||||
.Bl -tag -width progname.gmon -compact
|
||||
.It Pa progname.gmon
|
||||
execution data file
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr cc 1 ,
|
||||
|
@ -93,6 +93,7 @@ will fail if:
|
||||
The kernel does not have vm86 support, or an invalid function was specified.
|
||||
.It Bq Er ENOMEM
|
||||
There is not enough memory to initialize the kernel data structures.
|
||||
.El
|
||||
.Sh AUTHORS
|
||||
This man page was written by
|
||||
.An Jonathan Lemon .
|
||||
|
@ -69,19 +69,19 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''
|
||||
.It \&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''
|
||||
.It \&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''
|
||||
.It \&106\ ``F'' \t107\ ``G'' \t110\ ``H'' \t111\ ``I'' \t112\ ``J''
|
||||
.It \&113\ ``K'' \t114\ ``L'' \t115\ ``M'' \t116\ ``N'' \t117\ ``O''
|
||||
.It \&120\ ``P'' \t121\ ``Q'' \t122\ ``R'' \t123\ ``S'' \t124\ ``T''
|
||||
.It \&125\ ``U'' \t126\ ``V'' \t127\ ``W'' \t130\ ``X'' \t131\ ``Y''
|
||||
.It \&132\ ``Z'' \t141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d''
|
||||
.It \&145\ ``e'' \t146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i''
|
||||
.It \&152\ ``j'' \t153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n''
|
||||
.It \&157\ ``o'' \t160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s''
|
||||
.It \&164\ ``t'' \t165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x''
|
||||
.It \&171\ ``y'' \t172\ ``z''
|
||||
.It "\&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''"
|
||||
.It "\&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''"
|
||||
.It "\&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''"
|
||||
.It "\&106\ ``F'' \t107\ ``G'' \t110\ ``H'' \t111\ ``I'' \t112\ ``J''"
|
||||
.It "\&113\ ``K'' \t114\ ``L'' \t115\ ``M'' \t116\ ``N'' \t117\ ``O''"
|
||||
.It "\&120\ ``P'' \t121\ ``Q'' \t122\ ``R'' \t123\ ``S'' \t124\ ``T''"
|
||||
.It "\&125\ ``U'' \t126\ ``V'' \t127\ ``W'' \t130\ ``X'' \t131\ ``Y''"
|
||||
.It "\&132\ ``Z'' \t141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d''"
|
||||
.It "\&145\ ``e'' \t146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i''"
|
||||
.It "\&152\ ``j'' \t153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n''"
|
||||
.It "\&157\ ``o'' \t160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s''"
|
||||
.It "\&164\ ``t'' \t165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x''"
|
||||
.It "\&171\ ``y'' \t172\ ``z''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -69,17 +69,17 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''
|
||||
.It \&106\ ``F'' \t107\ ``G'' \t110\ ``H'' \t111\ ``I'' \t112\ ``J''
|
||||
.It \&113\ ``K'' \t114\ ``L'' \t115\ ``M'' \t116\ ``N'' \t117\ ``O''
|
||||
.It \&120\ ``P'' \t121\ ``Q'' \t122\ ``R'' \t123\ ``S'' \t124\ ``T''
|
||||
.It \&125\ ``U'' \t126\ ``V'' \t127\ ``W'' \t130\ ``X'' \t131\ ``Y''
|
||||
.It \&132\ ``Z'' \t141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d''
|
||||
.It \&145\ ``e'' \t146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i''
|
||||
.It \&152\ ``j'' \t153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n''
|
||||
.It \&157\ ``o'' \t160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s''
|
||||
.It \&164\ ``t'' \t165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x''
|
||||
.It \&171\ ``y'' \t172\ ``z''
|
||||
.It "\&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''"
|
||||
.It "\&106\ ``F'' \t107\ ``G'' \t110\ ``H'' \t111\ ``I'' \t112\ ``J''"
|
||||
.It "\&113\ ``K'' \t114\ ``L'' \t115\ ``M'' \t116\ ``N'' \t117\ ``O''"
|
||||
.It "\&120\ ``P'' \t121\ ``Q'' \t122\ ``R'' \t123\ ``S'' \t124\ ``T''"
|
||||
.It "\&125\ ``U'' \t126\ ``V'' \t127\ ``W'' \t130\ ``X'' \t131\ ``Y''"
|
||||
.It "\&132\ ``Z'' \t141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d''"
|
||||
.It "\&145\ ``e'' \t146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i''"
|
||||
.It "\&152\ ``j'' \t153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n''"
|
||||
.It "\&157\ ``o'' \t160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s''"
|
||||
.It "\&164\ ``t'' \t165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x''"
|
||||
.It "\&171\ ``y'' \t172\ ``z''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,13 +65,13 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&000\ nul \t001\ soh \t002\ stx \t003\ etx \t004\ eot
|
||||
.It \&005\ enq \t006\ ack \t007\ bel \t010\ bs \t011\ ht
|
||||
.It \&012\ nl \t013\ vt \t014\ np \t015\ cr \t016\ so
|
||||
.It \&017\ si \t020\ dle \t021\ dc1 \t022\ dc2 \t023\ dc3
|
||||
.It \&024\ dc4 \t025\ nak \t026\ syn \t027\ etb \t030\ can
|
||||
.It \&031\ em \t032\ sub \t033\ esc \t034\ fs \t035\ gs
|
||||
.It \&036\ rs \t037\ us \t177\ del
|
||||
.It "\&000\ nul \t001\ soh \t002\ stx \t003\ etx \t004\ eot"
|
||||
.It "\&005\ enq \t006\ ack \t007\ bel \t010\ bs \t011\ ht"
|
||||
.It "\&012\ nl \t013\ vt \t014\ np \t015\ cr \t016\ so"
|
||||
.It "\&017\ si \t020\ dle \t021\ dc1 \t022\ dc2 \t023\ dc3"
|
||||
.It "\&024\ dc4 \t025\ nak \t026\ syn \t027\ etb \t030\ can"
|
||||
.It "\&031\ em \t032\ sub \t033\ esc \t034\ fs \t035\ gs"
|
||||
.It "\&036\ rs \t037\ us \t177\ del"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,8 +65,8 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''
|
||||
.It \&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''
|
||||
.It "\&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''"
|
||||
.It "\&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,25 +65,25 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&041\ ``!'' \t042\ ``"'' \t043\ ``#'' \t044\ ``$'' \t045\ ``%''
|
||||
.It \&046\ ``&'' \t047\ ``''' \t050\ ``('' \t051\ ``)'' \t052\ ``*''
|
||||
.It \&053\ ``+'' \t054\ ``,'' \t055\ ``-'' \t056\ ``.'' \t057\ ``/''
|
||||
.It \&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''
|
||||
.It \&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''
|
||||
.It \&072\ ``:'' \t073\ ``;'' \t074\ ``<'' \t075\ ``='' \t076\ ``>''
|
||||
.It \&077\ ``?'' \t100\ ``@'' \t101\ ``A'' \t102\ ``B'' \t103\ ``C''
|
||||
.It \&104\ ``D'' \t105\ ``E'' \t106\ ``F'' \t107\ ``G'' \t110\ ``H''
|
||||
.It \&111\ ``I'' \t112\ ``J'' \t113\ ``K'' \t114\ ``L'' \t115\ ``M''
|
||||
.It \&116\ ``N'' \t117\ ``O'' \t120\ ``P'' \t121\ ``Q'' \t122\ ``R''
|
||||
.It \&123\ ``S'' \t124\ ``T'' \t125\ ``U'' \t126\ ``V'' \t127\ ``W''
|
||||
.It \&130\ ``X'' \t131\ ``Y'' \t132\ ``Z'' \t133\ ``['' \t134\ ``\e\|''
|
||||
.It \&135\ ``]'' \t136\ ``^'' \t137\ ``_'' \t140\ ```'' \t141\ ``a''
|
||||
.It \&142\ ``b'' \t143\ ``c'' \t144\ ``d'' \t145\ ``e'' \t146\ ``f''
|
||||
.It \&147\ ``g'' \t150\ ``h'' \t151\ ``i'' \t152\ ``j'' \t153\ ``k''
|
||||
.It \&154\ ``l'' \t155\ ``m'' \t156\ ``n'' \t157\ ``o'' \t160\ ``p''
|
||||
.It \&161\ ``q'' \t162\ ``r'' \t163\ ``s'' \t164\ ``t'' \t165\ ``u''
|
||||
.It \&166\ ``v'' \t167\ ``w'' \t170\ ``x'' \t171\ ``y'' \t172\ ``z''
|
||||
.It \&173\ ``{'' \t174\ ``|'' \t175\ ``}'' \t176\ ``~''
|
||||
.It "\&041\ ``!'' \t042\ ``""'' \t043\ ``#'' \t044\ ``$'' \t045\ ``%''"
|
||||
.It "\&046\ ``&'' \t047\ ``''' \t050\ ``('' \t051\ ``)'' \t052\ ``*''"
|
||||
.It "\&053\ ``+'' \t054\ ``,'' \t055\ ``-'' \t056\ ``.'' \t057\ ``/''"
|
||||
.It "\&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''"
|
||||
.It "\&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''"
|
||||
.It "\&072\ ``:'' \t073\ ``;'' \t074\ ``<'' \t075\ ``='' \t076\ ``>''"
|
||||
.It "\&077\ ``?'' \t100\ ``@'' \t101\ ``A'' \t102\ ``B'' \t103\ ``C''"
|
||||
.It "\&104\ ``D'' \t105\ ``E'' \t106\ ``F'' \t107\ ``G'' \t110\ ``H''"
|
||||
.It "\&111\ ``I'' \t112\ ``J'' \t113\ ``K'' \t114\ ``L'' \t115\ ``M''"
|
||||
.It "\&116\ ``N'' \t117\ ``O'' \t120\ ``P'' \t121\ ``Q'' \t122\ ``R''"
|
||||
.It "\&123\ ``S'' \t124\ ``T'' \t125\ ``U'' \t126\ ``V'' \t127\ ``W''"
|
||||
.It "\&130\ ``X'' \t131\ ``Y'' \t132\ ``Z'' \t133\ ``['' \t134\ ``\e\|''"
|
||||
.It "\&135\ ``]'' \t136\ ``^'' \t137\ ``_'' \t140\ ```'' \t141\ ``a''"
|
||||
.It "\&142\ ``b'' \t143\ ``c'' \t144\ ``d'' \t145\ ``e'' \t146\ ``f''"
|
||||
.It "\&147\ ``g'' \t150\ ``h'' \t151\ ``i'' \t152\ ``j'' \t153\ ``k''"
|
||||
.It "\&154\ ``l'' \t155\ ``m'' \t156\ ``n'' \t157\ ``o'' \t160\ ``p''"
|
||||
.It "\&161\ ``q'' \t162\ ``r'' \t163\ ``s'' \t164\ ``t'' \t165\ ``u''"
|
||||
.It "\&166\ ``v'' \t167\ ``w'' \t170\ ``x'' \t171\ ``y'' \t172\ ``z''"
|
||||
.It "\&173\ ``{'' \t174\ ``|'' \t175\ ``}'' \t176\ ``~''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,12 +65,12 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d'' \t145\ ``e''
|
||||
.It \&146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i'' \t152\ ``j''
|
||||
.It \&153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n'' \t157\ ``o''
|
||||
.It \&160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s'' \t164\ ``t''
|
||||
.It \&165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x'' \t171\ ``y''
|
||||
.It \&172\ ``z''
|
||||
.It "\&141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d'' \t145\ ``e''"
|
||||
.It "\&146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i'' \t152\ ``j''"
|
||||
.It "\&153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n'' \t157\ ``o''"
|
||||
.It "\&160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s'' \t164\ ``t''"
|
||||
.It "\&165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x'' \t171\ ``y''"
|
||||
.It "\&172\ ``z''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,25 +65,25 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&040\ sp \t041\ ``!'' \t042\ ``"'' \t043\ ``#'' \t044\ ``$''
|
||||
.It \&045\ ``%'' \t046\ ``&'' \t047\ ``''' \t050\ ``('' \t051\ ``)''
|
||||
.It \&052\ ``*'' \t053\ ``+'' \t054\ ``,'' \t055\ ``-'' \t056\ ``.''
|
||||
.It \&057\ ``/'' \t060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3''
|
||||
.It \&064\ ``4'' \t065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8''
|
||||
.It \&071\ ``9'' \t072\ ``:'' \t073\ ``;'' \t074\ ``<'' \t075\ ``=''
|
||||
.It \&076\ ``>'' \t077\ ``?'' \t100\ ``@'' \t101\ ``A'' \t102\ ``B''
|
||||
.It \&103\ ``C'' \t104\ ``D'' \t105\ ``E'' \t106\ ``F'' \t107\ ``G''
|
||||
.It \&110\ ``H'' \t111\ ``I'' \t112\ ``J'' \t113\ ``K'' \t114\ ``L''
|
||||
.It \&115\ ``M'' \t116\ ``N'' \t117\ ``O'' \t120\ ``P'' \t121\ ``Q''
|
||||
.It \&122\ ``R'' \t123\ ``S'' \t124\ ``T'' \t125\ ``U'' \t126\ ``V''
|
||||
.It \&127\ ``W'' \t130\ ``X'' \t131\ ``Y'' \t132\ ``Z'' \t133\ ``[''
|
||||
.It \&134\ ``\e\|'' \t135\ ``]'' \t136\ ``^'' \t137\ ``_'' \t140\ ```''
|
||||
.It \&141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d'' \t145\ ``e''
|
||||
.It \&146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i'' \t152\ ``j''
|
||||
.It \&153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n'' \t157\ ``o''
|
||||
.It \&160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s'' \t164\ ``t''
|
||||
.It \&165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x'' \t171\ ``y''
|
||||
.It \&172\ ``z'' \t173\ ``{'' \t174\ ``|'' \t175\ ``}'' \t176\ ``~''
|
||||
.It "\&040\ sp \t041\ ``!'' \t042\ ``""'' \t043\ ``#'' \t044\ ``$''"
|
||||
.It "\&045\ ``%'' \t046\ ``&'' \t047\ ``''' \t050\ ``('' \t051\ ``)''"
|
||||
.It "\&052\ ``*'' \t053\ ``+'' \t054\ ``,'' \t055\ ``-'' \t056\ ``.''"
|
||||
.It "\&057\ ``/'' \t060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3''"
|
||||
.It "\&064\ ``4'' \t065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8''"
|
||||
.It "\&071\ ``9'' \t072\ ``:'' \t073\ ``;'' \t074\ ``<'' \t075\ ``=''"
|
||||
.It "\&076\ ``>'' \t077\ ``?'' \t100\ ``@'' \t101\ ``A'' \t102\ ``B''"
|
||||
.It "\&103\ ``C'' \t104\ ``D'' \t105\ ``E'' \t106\ ``F'' \t107\ ``G''"
|
||||
.It "\&110\ ``H'' \t111\ ``I'' \t112\ ``J'' \t113\ ``K'' \t114\ ``L''"
|
||||
.It "\&115\ ``M'' \t116\ ``N'' \t117\ ``O'' \t120\ ``P'' \t121\ ``Q''"
|
||||
.It "\&122\ ``R'' \t123\ ``S'' \t124\ ``T'' \t125\ ``U'' \t126\ ``V''"
|
||||
.It "\&127\ ``W'' \t130\ ``X'' \t131\ ``Y'' \t132\ ``Z'' \t133\ ``[''"
|
||||
.It "\&134\ ``\e\|'' \t135\ ``]'' \t136\ ``^'' \t137\ ``_'' \t140\ ```''"
|
||||
.It "\&141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d'' \t145\ ``e''"
|
||||
.It "\&146\ ``f'' \t147\ ``g'' \t150\ ``h'' \t151\ ``i'' \t152\ ``j''"
|
||||
.It "\&153\ ``k'' \t154\ ``l'' \t155\ ``m'' \t156\ ``n'' \t157\ ``o''"
|
||||
.It "\&160\ ``p'' \t161\ ``q'' \t162\ ``r'' \t163\ ``s'' \t164\ ``t''"
|
||||
.It "\&165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x'' \t171\ ``y''"
|
||||
.It "\&172\ ``z'' \t173\ ``{'' \t174\ ``|'' \t175\ ``}'' \t176\ ``~''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -68,13 +68,13 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&041\ ``!'' \t042\ ``"'' \t043\ ``#'' \t044\ ``$'' \t045\ ``%''
|
||||
.It \&046\ ``&'' \t047\ ``''' \t050\ ``('' \t051\ ``)'' \t052\ ``*''
|
||||
.It \&053\ ``+'' \t054\ ``,'' \t055\ ``-'' \t056\ ``.'' \t057\ ``/''
|
||||
.It \&072\ ``:'' \t073\ ``;'' \t074\ ``<'' \t075\ ``='' \t076\ ``>''
|
||||
.It \&077\ ``?'' \t100\ ``@'' \t133\ ``['' \t134\ ``\e\|'' \t135\ ``]''
|
||||
.It \&136\ ``^'' \t137\ ``_'' \t140\ ```'' \t173\ ``{'' \t174\ ``|''
|
||||
.It \&175\ ``}'' \t176\ ``~''
|
||||
.It "\&041\ ``!'' \t042\ ``""'' \t043\ ``#'' \t044\ ``$'' \t045\ ``%''"
|
||||
.It "\&046\ ``&'' \t047\ ``''' \t050\ ``('' \t051\ ``)'' \t052\ ``*''"
|
||||
.It "\&053\ ``+'' \t054\ ``,'' \t055\ ``-'' \t056\ ``.'' \t057\ ``/''"
|
||||
.It "\&072\ ``:'' \t073\ ``;'' \t074\ ``<'' \t075\ ``='' \t076\ ``>''"
|
||||
.It "\&077\ ``?'' \t100\ ``@'' \t133\ ``['' \t134\ ``\e\|'' \t135\ ``]''"
|
||||
.It "\&136\ ``^'' \t137\ ``_'' \t140\ ```'' \t173\ ``{'' \t174\ ``|''"
|
||||
.It "\&175\ ``}'' \t176\ ``~''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,8 +65,8 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&011\ ht \t012\ nl \t013\ vt \t014\ np \t015\ cr
|
||||
.It \&040\ sp
|
||||
.It "\&011\ ht \t012\ nl \t013\ vt \t014\ np \t015\ cr"
|
||||
.It "\&040\ sp"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,12 +65,12 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''
|
||||
.It \&106\ ``F'' \t107\ ``G'' \t110\ ``H'' \t111\ ``I'' \t112\ ``J''
|
||||
.It \&113\ ``K'' \t114\ ``L'' \t115\ ``M'' \t116\ ``N'' \t117\ ``O''
|
||||
.It \&120\ ``P'' \t121\ ``Q'' \t122\ ``R'' \t123\ ``S'' \t124\ ``T''
|
||||
.It \&125\ ``U'' \t126\ ``V'' \t127\ ``W'' \t130\ ``X'' \t131\ ``Y''
|
||||
.It \&132\ ``Z''
|
||||
.It "\&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''"
|
||||
.It "\&106\ ``F'' \t107\ ``G'' \t110\ ``H'' \t111\ ``I'' \t112\ ``J''"
|
||||
.It "\&113\ ``K'' \t114\ ``L'' \t115\ ``M'' \t116\ ``N'' \t117\ ``O''"
|
||||
.It "\&120\ ``P'' \t121\ ``Q'' \t122\ ``R'' \t123\ ``S'' \t124\ ``T''"
|
||||
.It "\&125\ ``U'' \t126\ ``V'' \t127\ ``W'' \t130\ ``X'' \t131\ ``Y''"
|
||||
.It "\&132\ ``Z''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -65,11 +65,11 @@ In the ASCII character set, this includes the following characters
|
||||
(with their numeric values shown in octal):
|
||||
.Pp
|
||||
.Bl -column \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__ \&000_``0''__
|
||||
.It \&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''
|
||||
.It \&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''
|
||||
.It \&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''
|
||||
.It \&106\ ``F'' \t141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d''
|
||||
.It \&145\ ``e'' \t146\ ``f''
|
||||
.It "\&060\ ``0'' \t061\ ``1'' \t062\ ``2'' \t063\ ``3'' \t064\ ``4''"
|
||||
.It "\&065\ ``5'' \t066\ ``6'' \t067\ ``7'' \t070\ ``8'' \t071\ ``9''"
|
||||
.It "\&101\ ``A'' \t102\ ``B'' \t103\ ``C'' \t104\ ``D'' \t105\ ``E''"
|
||||
.It "\&106\ ``F'' \t141\ ``a'' \t142\ ``b'' \t143\ ``c'' \t144\ ``d''"
|
||||
.It "\&145\ ``e'' \t146\ ``f''"
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
|
@ -79,7 +79,7 @@ and
|
||||
.Fn inet_network
|
||||
interpret character strings representing
|
||||
numbers expressed in the Internet standard
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
notation.
|
||||
.Pp
|
||||
The
|
||||
@ -131,7 +131,7 @@ The routine
|
||||
takes an Internet address and returns an
|
||||
.Tn ASCII
|
||||
string representing the address in
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
notation. The routine
|
||||
.Fn inet_makeaddr
|
||||
takes an Internet network number and a local
|
||||
@ -150,7 +150,7 @@ All network numbers and local address parts are
|
||||
returned as machine format integer values.
|
||||
.Sh INTERNET ADDRESSES
|
||||
Values specified using the
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
notation take one
|
||||
of the following forms:
|
||||
.Bd -literal -offset indent
|
||||
@ -195,7 +195,7 @@ rearrangement.
|
||||
All numbers supplied as
|
||||
.Dq parts
|
||||
in a
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
notation
|
||||
may be decimal, octal, or hexadecimal, as specified
|
||||
in the C language (i.e., a leading 0x or 0X implies
|
||||
|
@ -154,7 +154,7 @@ exists which contains a single default entry for
|
||||
for use by callers which don't require complicated default rules.
|
||||
.Ed
|
||||
.Pp
|
||||
.Va Sq ...
|
||||
.Va Sq ...\&
|
||||
are optional extra arguments, which
|
||||
are passed to the appropriate callback function as a variable argument
|
||||
list of the type
|
||||
@ -163,11 +163,11 @@ list of the type
|
||||
Whilst there is support for arbitrary sources, the following
|
||||
#defines for commonly implementated sources are available:
|
||||
.Bl -column NS_COMPAT COMPAT -offset indent
|
||||
.Sy #define value
|
||||
.It NSSRC_FILES "files"
|
||||
.It NSSRC_DNS "dns"
|
||||
.It NSSRC_NIS "nis"
|
||||
.It NSSRC_COMPAT "compat"
|
||||
.It Sy "#define value"
|
||||
.It "NSSRC_FILES ""files"""
|
||||
.It "NSSRC_DNS ""dns"""
|
||||
.It "NSSRC_NIS ""nis"""
|
||||
.It "NSSRC_COMPAT ""compat"""
|
||||
.El
|
||||
.Pp
|
||||
Refer to
|
||||
@ -178,11 +178,11 @@ for a complete description of what each source type is.
|
||||
The callback functions should return one of the following values
|
||||
depending upon status of the lookup:
|
||||
.Bl -column NS_NOTFOUND -offset indent
|
||||
.Sy "Return value" Status code
|
||||
.It NS_SUCCESS success
|
||||
.It NS_NOTFOUND notfound
|
||||
.It NS_UNAVAIL unavail
|
||||
.It NS_TRYAGAIN tryagain
|
||||
.It Sy "Return value Status code"
|
||||
.It "NS_SUCCESS success"
|
||||
.It "NS_NOTFOUND notfound"
|
||||
.It "NS_UNAVAIL unavail"
|
||||
.It "NS_TRYAGAIN tryagain"
|
||||
.El
|
||||
.Pp
|
||||
Refer to
|
||||
|
@ -327,9 +327,9 @@ which is of size
|
||||
.Fa length .
|
||||
The size of compressed name is returned or \-1 if there was an error.
|
||||
.Sh FILES
|
||||
.Bl -tag -width Pa
|
||||
/etc/resolv.conf
|
||||
The configuration file
|
||||
.Bl -tag -width /etc/resolv.conf
|
||||
.It Pa /etc/resolv.conf
|
||||
The configuration file,
|
||||
see
|
||||
.Xr resolver 5 .
|
||||
.El
|
||||
|
@ -67,4 +67,3 @@ The
|
||||
.Fn catclose
|
||||
function conforms to
|
||||
.St -xpg4 .
|
||||
|
||||
|
@ -50,7 +50,7 @@ extensions defined that allow for alternative ACL semantics than the
|
||||
POSIX.1e semantics, such as AFS, NTFS, Coda, and NWFS semantics. Where
|
||||
routines are non-standard, they are suffixed with _np to indicate that
|
||||
they are not portable.
|
||||
|
||||
.Pp
|
||||
POSIX.1e describes a set of ACL manipulation routines to manage the
|
||||
contents of ACLs, as well as their relationships with files. This
|
||||
manipulation library is not currently implemented in
|
||||
@ -68,73 +68,73 @@ and
|
||||
.Fn acl_to_text ,
|
||||
passed directly to and from the management routines. In this manner,
|
||||
an application can remain safely unaware of the contents of ACLs.
|
||||
|
||||
.Pp
|
||||
Available functions, sorted by behavior, include:
|
||||
|
||||
.Pp
|
||||
.Fn acl_delete_def_file ,
|
||||
.Fn acl_delete_file_np ,
|
||||
.Fn acl_delete_fd_np
|
||||
|
||||
.Fn acl_delete_fd_np
|
||||
.Pp
|
||||
These functions are described in
|
||||
.Xr acl_delete 3 ,
|
||||
and may be used to delete ACLs from file system objects.
|
||||
|
||||
.Pp
|
||||
.Fn acl_free
|
||||
|
||||
.Pp
|
||||
This function is described in
|
||||
.Xr acl_free 3 ,
|
||||
and may be used to free userland working ACL storage.
|
||||
|
||||
.Pp
|
||||
.Fn acl_from_text
|
||||
|
||||
.Pp
|
||||
This function is described in
|
||||
.Xr acl_from_text 3 ,
|
||||
and may be used to convert a text-form ACL into working ACL state, if
|
||||
the ACL has POSIX.1e semantics.
|
||||
|
||||
.Pp
|
||||
.Fn acl_get_file ,
|
||||
.Fn acl_get_fd ,
|
||||
.Fn acl_get_fd_np
|
||||
|
||||
.Pp
|
||||
These functions are described in
|
||||
.Xr acl_get 3 ,
|
||||
and may be used to retrieve ACLs from file system objects.
|
||||
|
||||
.Pp
|
||||
.Fn acl_init
|
||||
|
||||
.Pp
|
||||
This function is described in
|
||||
.Xr acl_init 3 ,
|
||||
and may be used to allocate a fresh (empty) ACL structure.
|
||||
|
||||
.Pp
|
||||
.Fn acl_dup
|
||||
|
||||
.Pp
|
||||
This function is described in
|
||||
.Xr acl_dup 3 ,
|
||||
and may be used to duplicate an ACL structure.
|
||||
|
||||
.Pp
|
||||
.Fn acl_set_file ,
|
||||
.Fn acl_set_fd ,
|
||||
.Fn acl_set_fd_np
|
||||
|
||||
.Pp
|
||||
These functions are described in
|
||||
.Xr acl_set 3 ,
|
||||
and may be used to assign an ACL to a file system object.
|
||||
|
||||
.Pp
|
||||
.Fn acl_to_text
|
||||
|
||||
.Pp
|
||||
This function is described in
|
||||
.Xr acl_to_text 3 ,
|
||||
and may be used to generate a text-form of a POSIX.1e semantics ACL.
|
||||
|
||||
.Pp
|
||||
.Fn acl_valid ,
|
||||
.Fn acl_valid_file_np ,
|
||||
.Fn acl_valid_fd_np
|
||||
|
||||
.Pp
|
||||
Thee functions are described in
|
||||
.Xr acl_valid 3 ,
|
||||
and may be used to validate an ACL as correct POSIX.1e-semantics, or
|
||||
as appropriate for a particular file system object regardless of semantics.
|
||||
|
||||
.Pp
|
||||
Documentation of the internal kernel interfaces backing these calls may
|
||||
be found in
|
||||
.Xr acl 9 .
|
||||
|
@ -91,7 +91,7 @@ argument points to an empty string.
|
||||
Insufficient memory available to fulfill request.
|
||||
.It Bq Er ENOTDIR
|
||||
A component of the path prefix is not a directory.
|
||||
|
||||
.Pp
|
||||
Argument
|
||||
.Va path_p
|
||||
must be a directory, and is not.
|
||||
|
@ -43,14 +43,14 @@ The
|
||||
.Fn acl_dup
|
||||
function returns a pointer to a copy of the ACL pointed to by the argument
|
||||
.Va acl .
|
||||
|
||||
.Pp
|
||||
This function may cause memory to be allocated. The caller should free any
|
||||
releasable memory, when the new ACL is no longer required, by calling
|
||||
.Xr acl_free 3
|
||||
with the
|
||||
.Va (void*)acl_t
|
||||
as an argument.
|
||||
|
||||
.Pp
|
||||
Any existing ACL pointers that refer to the ACL referred to by
|
||||
.Va acl
|
||||
shall continue to refer to the ACL.
|
||||
|
@ -45,7 +45,7 @@ function converts the text form of an ACL referred to by
|
||||
.Va buf_p
|
||||
into the internal working structure for ACLs, appropriate for applying to
|
||||
files or manipulating.
|
||||
|
||||
.Pp
|
||||
This function may cause memory to be allocated. The caller should free any
|
||||
releasable memory, when the new ACL is no longer required, by calling
|
||||
.Xr acl_free 3
|
||||
|
@ -62,14 +62,14 @@ from a file descriptor.
|
||||
is a non-portable form of
|
||||
.Fn acl_get_fd
|
||||
that allows the retrieval of any type of ACL from a file descriptor.
|
||||
|
||||
.Pp
|
||||
This function may cause memory to be allocated. The caller should free
|
||||
any releasable memory, when the new ACL is no longer required, by calling
|
||||
.Xr acl_free 3
|
||||
with the
|
||||
.Va (void *)acl_t
|
||||
as an argument.
|
||||
|
||||
.Pp
|
||||
The ACL in the working storage is an independent copy of the ACL associated
|
||||
with the object referred to by
|
||||
.Va fd .
|
||||
|
@ -49,7 +49,7 @@ storage allocated to contain the ACL is freed by a call to
|
||||
.Xr acl_free 3 .
|
||||
When the area is first allocated, it shall contain an an ACL that contains
|
||||
no ACL entries.
|
||||
|
||||
.Pp
|
||||
This function may cause memory to be allocated. The caller should free any
|
||||
releasable memory, when the new ACL is no longer required, by calling
|
||||
.Xr acl_free 3
|
||||
|
@ -51,7 +51,7 @@ including the NULL terminator) in the location pointed to by
|
||||
The format of the text string returned by
|
||||
.Fn acl_to_text
|
||||
shall be the POSIX.1e long ACL form.
|
||||
|
||||
.Pp
|
||||
This function allocates any memory necessary to contain the string and
|
||||
returns a pointer to the string. The caller should free any releasable
|
||||
memory, when the new string is no longer required, by calling
|
||||
@ -83,7 +83,7 @@ to the corresponding value:
|
||||
Argument
|
||||
.Va acl
|
||||
does not point to a valid ACL.
|
||||
|
||||
.Pp
|
||||
The ACL denoted by
|
||||
.Va acl
|
||||
contains one or more improperly formed ACL entries, or for some other
|
||||
@ -112,7 +112,7 @@ and development continues.
|
||||
.An Robert N M Watson
|
||||
.Sh BUGS
|
||||
These features are not yet fully implemented.
|
||||
|
||||
.Pp
|
||||
.Fn acl_from_text
|
||||
and
|
||||
.Fn acl_to_text
|
||||
|
@ -58,7 +58,7 @@ allow an ACL to be checked in the context of a specific acl type,
|
||||
.Va type ,
|
||||
and file system object. In environments where additional ACL types are
|
||||
supported than just POSIX.1e, this makes more sense.
|
||||
|
||||
.Pp
|
||||
For POSIX.1e semantics, the checks include:
|
||||
.Bd -literal -offset indent
|
||||
The three required entries (ACL_USER_OBJ, ACL_GROUP_OBJ,
|
||||
@ -67,14 +67,14 @@ the ACL contains any ACL_USER, ACL_GROUP, or any other
|
||||
implementation-defined entries in the file group class
|
||||
then one ACL_MASK entry shall also be required. The ACL
|
||||
shall contain at most on ACL_MASK entry.
|
||||
|
||||
.Pp
|
||||
The qualifier field shall be unique among all entries of
|
||||
the same POSIX.1e ACL facility defined tag type. The
|
||||
tag type field shall contain valid values including any
|
||||
implementation-defined values. Validation of the values
|
||||
of the qualifier field is implementation-defined.
|
||||
.Ed
|
||||
|
||||
.Pp
|
||||
The POSIX.1e
|
||||
.Fn acl_valid
|
||||
function may reorder the ACL for the purposes of verification; the
|
||||
@ -105,12 +105,12 @@ argument is not a valid file descriptor.
|
||||
Argument
|
||||
.Va acl
|
||||
does not point to a valid ACL.
|
||||
|
||||
.Pp
|
||||
One or more of the required ACL entries is not present in
|
||||
.Va acl .
|
||||
|
||||
.Pp
|
||||
The ACL contains entries that are not unique.
|
||||
|
||||
.Pp
|
||||
The file system rejects the ACL based on fs-specific semantics issues.
|
||||
.It Bq Er ENAMETOOLONG
|
||||
A component of a pathname exceeded 255 characters, or an
|
||||
|
@ -52,7 +52,7 @@ the other in any way.
|
||||
This function may cause memory to be allocated.
|
||||
The caller should free any releasable memory, when the capability state in
|
||||
working storage is no longer required, by calling
|
||||
.Vn cap_free
|
||||
.Fn cap_free
|
||||
with the cap_t as an argument.
|
||||
.Sh IMPLEMENTATION NOTES
|
||||
FreeBSD's support for POSIX.1e interfaces and features is still under
|
||||
|
@ -32,7 +32,7 @@
|
||||
.Os FreeBSD
|
||||
.Sh NAME
|
||||
.Nm cap_free
|
||||
.Nd Release Memory Allocated to a Capability State in Working Storage
|
||||
.Nd "Release Memory Allocated to a Capability State in Working Storage"
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <sys/types.h>
|
||||
.Fd #include <sys/capability.h>
|
||||
|
@ -49,7 +49,7 @@ implementation shall be cleared.
|
||||
This function may cause memory to be allocated.
|
||||
The caller should free any releasable memory, when the capability state in
|
||||
working storage is no longer required, by calling
|
||||
.Vn cap_free
|
||||
.Fn cap_free
|
||||
with the cap_t as an argument.
|
||||
.Sh IMPLEMENTATION NOTES
|
||||
FreeBSD's support for POSIX.1e interfaces and features is still under
|
||||
|
@ -56,7 +56,7 @@ null terminator) in the location pointed to by
|
||||
The capability state in working storage idenfied by
|
||||
.Va cap_p
|
||||
shall be completely represented in the returned string.
|
||||
|
||||
.Pp
|
||||
This function may cause memory to be allocated.
|
||||
The caller should free any releasable memory, when the capability state
|
||||
in working memory is no longer required, by calling
|
||||
|
@ -44,7 +44,7 @@ it describes are now widely used despite inherent limitations. Currently,
|
||||
only a few of the interfaces and features are implemented in
|
||||
.Fx ,
|
||||
although efforts are underway to complete the integration at this time.
|
||||
|
||||
.Pp
|
||||
POSIX.1e describes five security extensions to the base POSIX.1 API:
|
||||
Access Control Lists (ACLs), Auditing, Capabilities, Mandatory Access
|
||||
Control, and Information Flow Labels. Of these, the ACL interfaces are
|
||||
@ -53,7 +53,7 @@ currently included with
|
||||
Auditing, Capabilities, and Mandatory
|
||||
Access Control are in the wings, and Information Flow Labels are not on
|
||||
the calendar.
|
||||
|
||||
.Pp
|
||||
POSIX.1e defines both syntax and semantics for these features, but fairly
|
||||
substantial changes are required to implement these features in the
|
||||
operating system. As shipped,
|
||||
@ -64,18 +64,17 @@ access to and manipulation of these ACLs, but support for ACLs is not
|
||||
provided by any file systems shipped in the base operating system.
|
||||
Available API calls relating to ACLs are described in detail in
|
||||
.Xr acl 3 .
|
||||
|
||||
.Pp
|
||||
.Fx
|
||||
currently provides documentation and APIs for fine-grained capability
|
||||
support, but implementation is currently not included in the base
|
||||
system. Documentation of these API calls is provided in
|
||||
.Xr cap 3 .
|
||||
|
||||
.Pp
|
||||
Additional patches supporting POSIX.1e features are provided by the
|
||||
TrustedBSD project:
|
||||
|
||||
.Pp
|
||||
http://www.trustedbsd.org
|
||||
|
||||
.Sh IMPLEMENTATION NOTES
|
||||
.Fx Ns 's
|
||||
support for POSIX.1e interfaces and features is still under
|
||||
|
@ -94,7 +94,7 @@ An atom followed by
|
||||
.Ql \&+
|
||||
matches a sequence of 1 or more matches of the atom.
|
||||
An atom followed by
|
||||
.Ql \&?
|
||||
.Ql ?\&
|
||||
matches a sequence of 0 or 1 matches of the atom.
|
||||
.Pp
|
||||
A
|
||||
@ -146,7 +146,7 @@ an empty set of
|
||||
a
|
||||
.Em bracket expression
|
||||
(see below),
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
(matching any single character),
|
||||
.Ql \&^
|
||||
(matching the null string at the beginning of a line),
|
||||
@ -210,9 +210,9 @@ To use a literal
|
||||
.Ql \&-
|
||||
as the first endpoint of a range,
|
||||
enclose it in
|
||||
.Ql [.
|
||||
.Ql [.\&
|
||||
and
|
||||
.Ql .]
|
||||
.Ql .]\&
|
||||
to make it a collating element (see below).
|
||||
With the exception of these and some combinations using
|
||||
.Ql \&[
|
||||
@ -224,9 +224,9 @@ Within a bracket expression, a collating element (a character,
|
||||
a multi-character sequence that collates as if it were a single character,
|
||||
or a collating-sequence name for either)
|
||||
enclosed in
|
||||
.Ql [.
|
||||
.Ql [.\&
|
||||
and
|
||||
.Ql .]
|
||||
.Ql .]\&
|
||||
stands for the
|
||||
sequence of characters of that collating element.
|
||||
The sequence is a single element of the bracket expression's list.
|
||||
@ -249,7 +249,7 @@ is an equivalence class, standing for the sequences of characters
|
||||
of all collating elements equivalent to that one, including itself.
|
||||
(If there are no other equivalent collating elements,
|
||||
the treatment is as if the enclosing delimiters were
|
||||
.Ql [.
|
||||
.Ql [.\&
|
||||
and
|
||||
.Ql .] . )
|
||||
For example, if
|
||||
@ -277,10 +277,10 @@ class.
|
||||
Standard character class names are:
|
||||
.Pp
|
||||
.Bl -column "alnum" "digit" "xdigit" -offset indent
|
||||
.It Em alnum digit punct
|
||||
.It Em alpha graph space
|
||||
.It Em blank lower upper
|
||||
.It Em cntrl print xdigit
|
||||
.It Em "alnum digit punct"
|
||||
.It Em "alpha graph space"
|
||||
.It Em "blank lower upper"
|
||||
.It Em "cntrl print xdigit"
|
||||
.El
|
||||
.Pp
|
||||
These stand for the character classes defined in
|
||||
@ -330,7 +330,7 @@ matches the three middle characters of
|
||||
matches all ten characters of
|
||||
.Ql weeknights ,
|
||||
when
|
||||
.Ql (.*).*
|
||||
.Ql (.*).*\&
|
||||
is matched against
|
||||
.Ql abc
|
||||
the parenthesized subexpression
|
||||
@ -375,7 +375,7 @@ is an ordinary character and there is no equivalent
|
||||
for its functionality.
|
||||
.Ql \&+
|
||||
and
|
||||
.Ql \&?
|
||||
.Ql ?\&
|
||||
are ordinary characters, and their functionality
|
||||
can be expressed using bounds
|
||||
.No ( Ql {1,}
|
||||
|
@ -30,7 +30,7 @@ A ``#'' indicates the beginning of a comment; characters up to the end of
|
||||
the line are not interpreted by routines which search the file.
|
||||
.Sh FILES
|
||||
.Bl -tag -compact -width /etc/rpc
|
||||
.Pa /etc/rpc
|
||||
.It Pa /etc/rpc
|
||||
.El
|
||||
.Sh "SEE ALSO"
|
||||
.Xr getrpcent 3
|
||||
|
@ -296,7 +296,7 @@ flag has been given) to fill out
|
||||
the field width.
|
||||
.It
|
||||
An optional precision, in the form of a period
|
||||
.Sq Cm \&.
|
||||
.Sq Cm .\&
|
||||
followed by an
|
||||
optional digit string. If the digit string is omitted, the precision
|
||||
is taken as zero. This gives the minimum number of digits to appear for
|
||||
|
@ -228,70 +228,70 @@ library conforms to
|
||||
.St -ansiC .
|
||||
.Sh LIST OF FUNCTIONS
|
||||
.Bl -column "Description"
|
||||
.Sy Function Description
|
||||
asprintf formatted output conversion
|
||||
clearerr check and reset stream status
|
||||
fclose close a stream
|
||||
fdopen stream open functions
|
||||
feof check and reset stream status
|
||||
ferror check and reset stream status
|
||||
fflush flush a stream
|
||||
fgetc get next character or word from input stream
|
||||
fgetln get a line from a stream
|
||||
fgetpos reposition a stream
|
||||
fgets get a line from a stream
|
||||
fileno check and reset stream status
|
||||
fopen stream open functions
|
||||
fprintf formatted output conversion
|
||||
fpurge flush a stream
|
||||
fputc output a character or word to a stream
|
||||
fputs output a line to a stream
|
||||
fread binary stream input/output
|
||||
freopen stream open functions
|
||||
fropen open a stream
|
||||
fscanf input format conversion
|
||||
fseek reposition a stream
|
||||
fsetpos reposition a stream
|
||||
ftell reposition a stream
|
||||
funopen open a stream
|
||||
fwopen open a stream
|
||||
fwrite binary stream input/output
|
||||
getc get next character or word from input stream
|
||||
getchar get next character or word from input stream
|
||||
gets get a line from a stream
|
||||
getw get next character or word from input stream
|
||||
mkdtemp create unique temporary file
|
||||
mkstemp create unique temporary file
|
||||
mktemp create unique temporary file
|
||||
perror system error messages
|
||||
printf formatted output conversion
|
||||
putc output a character or word to a stream
|
||||
putchar output a character or word to a stream
|
||||
puts output a line to a stream
|
||||
putw output a character or word to a stream
|
||||
remove remove directory entry
|
||||
rewind reposition a stream
|
||||
scanf input format conversion
|
||||
setbuf stream buffering operations
|
||||
setbuffer stream buffering operations
|
||||
setlinebuf stream buffering operations
|
||||
setvbuf stream buffering operations
|
||||
snprintf formatted output conversion
|
||||
sprintf formatted output conversion
|
||||
sscanf input format conversion
|
||||
strerror system error messages
|
||||
sys_errlist system error messages
|
||||
sys_nerr system error messages
|
||||
tempnam temporary file routines
|
||||
tmpfile temporary file routines
|
||||
tmpnam temporary file routines
|
||||
ungetc un-get character from input stream
|
||||
vasprintf formatted output conversion
|
||||
vfprintf formatted output conversion
|
||||
vfscanf input format conversion
|
||||
vprintf formatted output conversion
|
||||
vscanf input format conversion
|
||||
vsnprintf formatted output conversion
|
||||
vsprintf formatted output conversion
|
||||
vsscanf input format conversion
|
||||
.It Sy "Function Description"
|
||||
.It "asprintf formatted output conversion"
|
||||
.It "clearerr check and reset stream status"
|
||||
.It "fclose close a stream"
|
||||
.It "fdopen stream open functions"
|
||||
.It "feof check and reset stream status"
|
||||
.It "ferror check and reset stream status"
|
||||
.It "fflush flush a stream"
|
||||
.It "fgetc get next character or word from input stream"
|
||||
.It "fgetln get a line from a stream"
|
||||
.It "fgetpos reposition a stream"
|
||||
.It "fgets get a line from a stream"
|
||||
.It "fileno check and reset stream status"
|
||||
.It "fopen stream open functions"
|
||||
.It "fprintf formatted output conversion"
|
||||
.It "fpurge flush a stream"
|
||||
.It "fputc output a character or word to a stream"
|
||||
.It "fputs output a line to a stream"
|
||||
.It "fread binary stream input/output"
|
||||
.It "freopen stream open functions"
|
||||
.It "fropen open a stream"
|
||||
.It "fscanf input format conversion"
|
||||
.It "fseek reposition a stream"
|
||||
.It "fsetpos reposition a stream"
|
||||
.It "ftell reposition a stream"
|
||||
.It "funopen open a stream"
|
||||
.It "fwopen open a stream"
|
||||
.It "fwrite binary stream input/output"
|
||||
.It "getc get next character or word from input stream"
|
||||
.It "getchar get next character or word from input stream"
|
||||
.It "gets get a line from a stream"
|
||||
.It "getw get next character or word from input stream"
|
||||
.It "mkdtemp create unique temporary file"
|
||||
.It "mkstemp create unique temporary file"
|
||||
.It "mktemp create unique temporary file"
|
||||
.It "perror system error messages"
|
||||
.It "printf formatted output conversion"
|
||||
.It "putc output a character or word to a stream"
|
||||
.It "putchar output a character or word to a stream"
|
||||
.It "puts output a line to a stream"
|
||||
.It "putw output a character or word to a stream"
|
||||
.It "remove remove directory entry"
|
||||
.It "rewind reposition a stream"
|
||||
.It "scanf input format conversion"
|
||||
.It "setbuf stream buffering operations"
|
||||
.It "setbuffer stream buffering operations"
|
||||
.It "setlinebuf stream buffering operations"
|
||||
.It "setvbuf stream buffering operations"
|
||||
.It "snprintf formatted output conversion"
|
||||
.It "sprintf formatted output conversion"
|
||||
.It "sscanf input format conversion"
|
||||
.It "strerror system error messages"
|
||||
.It "sys_errlist system error messages"
|
||||
.It "sys_nerr system error messages"
|
||||
.It "tempnam temporary file routines"
|
||||
.It "tmpfile temporary file routines"
|
||||
.It "tmpnam temporary file routines"
|
||||
.It "ungetc un-get character from input stream"
|
||||
.It "vasprintf formatted output conversion"
|
||||
.It "vfprintf formatted output conversion"
|
||||
.It "vfscanf input format conversion"
|
||||
.It "vprintf formatted output conversion"
|
||||
.It "vscanf input format conversion"
|
||||
.It "vsnprintf formatted output conversion"
|
||||
.It "vsprintf formatted output conversion"
|
||||
.It "vsscanf input format conversion"
|
||||
.El
|
||||
|
@ -125,7 +125,7 @@ The
|
||||
function
|
||||
returns \-1
|
||||
when the argument list is exhausted, or
|
||||
.Ql ?
|
||||
.Ql ?\&
|
||||
if a non-recognized
|
||||
option is encountered.
|
||||
The interpretation of options in the argument list may be cancelled
|
||||
@ -147,7 +147,7 @@ or detects
|
||||
a missing option argument it writes an error message to the
|
||||
.Em stderr
|
||||
and returns
|
||||
.Ql ? .
|
||||
.Ql ?\& .
|
||||
Setting
|
||||
.Va opterr
|
||||
to a zero will disable these error messages.
|
||||
|
@ -261,6 +261,7 @@ If the environment variable
|
||||
.Ev MALLOC_OPTIONS
|
||||
is set, the characters it contains will be interpreted as flags to the
|
||||
allocation functions.
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
.Fn malloc
|
||||
@ -428,6 +429,7 @@ An unknown option was specified.
|
||||
Even with the
|
||||
.Dq A
|
||||
option set, this warning is still only a warning.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr brk 2 ,
|
||||
.Xr alloca 3 ,
|
||||
|
@ -102,6 +102,7 @@ is stored in
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ERANGE
|
||||
Overflow or underflow occurred.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr atof 3 ,
|
||||
.Xr atoi 3 ,
|
||||
|
@ -49,7 +49,6 @@
|
||||
.Fd #include <limits.h>
|
||||
.Ft long
|
||||
.Fn strtol "const char *nptr" "char **endptr" "int base"
|
||||
|
||||
.Fd #include <sys/types.h>
|
||||
.Fd #include <stdlib.h>
|
||||
.Fd #include <limits.h>
|
||||
|
@ -49,7 +49,6 @@
|
||||
.Fd #include <limits.h>
|
||||
.Ft unsigned long
|
||||
.Fn strtoul "const char *nptr" "char **endptr" "int base"
|
||||
|
||||
.Fd #include <sys/types.h>
|
||||
.Fd #include <stdlib.h>
|
||||
.Fd #include <limits.h>
|
||||
|
@ -235,7 +235,7 @@ conforms to
|
||||
.St -ansiC
|
||||
with a lot of extensions including
|
||||
.Ql %C ,
|
||||
.Ql %D ,
|
||||
.Ql \&%D ,
|
||||
.Ql %E* ,
|
||||
.Ql %e ,
|
||||
.Ql %G ,
|
||||
@ -254,13 +254,12 @@ with a lot of extensions including
|
||||
.Ql \&%V ,
|
||||
.Ql %z ,
|
||||
.Ql %+ .
|
||||
|
||||
.Pp
|
||||
The peculiar week number and year in the replacements of
|
||||
.Ql %G ,
|
||||
.Ql %g
|
||||
and
|
||||
.Ql \&%V
|
||||
are defined in ISO 8601: 1988.
|
||||
|
||||
.Sh BUGS
|
||||
There is no conversion specification for the phase of the moon.
|
||||
|
@ -63,7 +63,7 @@ All conversion specifications are identical to those described in
|
||||
Two-digit year values, including formats
|
||||
.Fa %y
|
||||
and
|
||||
.Fa %D ,
|
||||
.Fa \&%D ,
|
||||
are now interpreted as beginning at 1969 per POSIX requirements.
|
||||
Years 69-00 are interpreted in the 20th century (1969-2000), years
|
||||
01-68 in the 21st century (2001-2068).
|
||||
|
@ -88,19 +88,19 @@ and back from,
|
||||
the POSIX representation over the leap second inserted at the end of June,
|
||||
1993.
|
||||
.Bl -column "93/06/30" "23:59:59" "A+0" "X=time2posix(T)"
|
||||
.It Sy DATE TIME T X=time2posix(T) posix2time(X)
|
||||
.It 93/06/30 23:59:59 A+0 B+0 A+0
|
||||
.It 93/06/30 23:59:60 A+1 B+1 A+1 or A+2
|
||||
.It 93/07/01 00:00:00 A+2 B+1 A+1 or A+2
|
||||
.It 93/07/01 00:00:01 A+3 B+2 A+3
|
||||
.It Sy "DATE TIME T X=time2posix(T) posix2time(X)"
|
||||
.It "93/06/30 23:59:59 A+0 B+0 A+0"
|
||||
.It "93/06/30 23:59:60 A+1 B+1 A+1 or A+2"
|
||||
.It "93/07/01 00:00:00 A+2 B+1 A+1 or A+2"
|
||||
.It "93/07/01 00:00:01 A+3 B+2 A+3"
|
||||
.El
|
||||
.Pp
|
||||
A leap second deletion would look like...
|
||||
.Bl -column "??/06/30" "23:59:58" "A+0" "X=time2posix(T)"
|
||||
.It Sy DATE TIME T X=time2posix(T) posix2time(X)
|
||||
.It ??/06/30 23:59:58 A+0 B+0 A+0
|
||||
.It ??/07/01 00:00:00 A+1 B+2 A+1
|
||||
.It ??/07/01 00:00:01 A+2 B+3 A+2
|
||||
.It Sy "DATE TIME T X=time2posix(T) posix2time(X)"
|
||||
.It "??/06/30 23:59:58 A+0 B+0 A+0"
|
||||
.It "??/07/01 00:00:00 A+1 B+2 A+1"
|
||||
.It "??/07/01 00:00:01 A+2 B+3 A+2"
|
||||
.El
|
||||
.Pp
|
||||
.D1 No "[Note: posix2time(B+1) => A+0 or A+1]"
|
||||
|
@ -105,7 +105,7 @@ The following code fragment illustrates the simple case:
|
||||
.Bd -literal -offset indent
|
||||
char *s, *p, buf[BUFSIZ];
|
||||
|
||||
.Li ...
|
||||
\&...
|
||||
|
||||
(void)strlcpy(buf, s, sizeof(buf));
|
||||
(void)strlcat(buf, p, sizeof(buf));
|
||||
@ -116,7 +116,7 @@ like the following might be used:
|
||||
.Bd -literal -offset indent
|
||||
char *dir, *file, pname[MAXPATHLEN];
|
||||
|
||||
.Li ...
|
||||
\&...
|
||||
|
||||
if (strlcpy(pname, dir, sizeof(pname)) >= sizeof(pname))
|
||||
goto toolong;
|
||||
@ -130,7 +130,7 @@ speed things up a bit by using a copy instead on an append:
|
||||
char *dir, *file, pname[MAXPATHNAMELEN];
|
||||
size_t n;
|
||||
|
||||
.Li ...
|
||||
\&...
|
||||
|
||||
n = strlcpy(pname, dir, sizeof(pname));
|
||||
if (n >= sizeof(pname))
|
||||
|
@ -98,9 +98,9 @@ beyond the
|
||||
.Em rlim_max
|
||||
value returned from a call to
|
||||
.Xr getrlimit 2 ,
|
||||
e.g.
|
||||
e.g.\&
|
||||
.Dq etext + rlp\(->rlim_max.
|
||||
(see
|
||||
(See
|
||||
.Xr end 3
|
||||
for the definition of
|
||||
.Em etext ) .
|
||||
|
@ -144,7 +144,7 @@ will fail if:
|
||||
.It Bq Er EBADF
|
||||
The descriptor is not valid.
|
||||
.It Bq Er EINVAL
|
||||
.Fa Fd
|
||||
.Fa fd
|
||||
refers to a socket, not to a file.
|
||||
.It Bq Er EPERM
|
||||
The effective user ID does not match the owner of the file and
|
||||
|
@ -195,7 +195,7 @@ will fail if:
|
||||
.It Bq Er EBADF
|
||||
The descriptor is not valid.
|
||||
.It Bq Er EINVAL
|
||||
.Fa Fd
|
||||
.Fa fd
|
||||
refers to a socket, not to a file.
|
||||
.It Bq Er EROFS
|
||||
The file resides on a read-only file system.
|
||||
|
@ -127,10 +127,10 @@ An I/O error occurred while reading from or writing to the file system.
|
||||
will fail if:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EBADF
|
||||
.Fa Fd
|
||||
.Fa fd
|
||||
does not refer to a valid descriptor.
|
||||
.It Bq Er EINVAL
|
||||
.Fa Fd
|
||||
.Fa fd
|
||||
refers to a socket, not a file.
|
||||
.It Bq Er EPERM
|
||||
The effective user ID is not the super-user.
|
||||
|
@ -42,10 +42,10 @@
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <sys/file.h>
|
||||
.Fd #define LOCK_SH 0x01 /* shared file lock */
|
||||
.Fd #define LOCK_EX 0x02 /* exclusive file lock */
|
||||
.Fd #define LOCK_NB 0x04 /* don't block when locking */
|
||||
.Fd #define LOCK_UN 0x08 /* unlock file */
|
||||
.Fd "#define LOCK_SH 0x01 /* shared file lock */"
|
||||
.Fd "#define LOCK_EX 0x02 /* exclusive file lock */"
|
||||
.Fd "#define LOCK_NB 0x04 /* don't block when locking */"
|
||||
.Fd "#define LOCK_UN 0x08 /* unlock file */"
|
||||
.Ft int
|
||||
.Fn flock "int fd" "int operation"
|
||||
.Sh DESCRIPTION
|
||||
|
@ -87,10 +87,10 @@ The
|
||||
fails if:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EBADF
|
||||
.Fa Fd
|
||||
.Fa fd
|
||||
is not a valid descriptor.
|
||||
.It Bq Er EINVAL
|
||||
.Fa Fd
|
||||
.Fa fd
|
||||
refers to a socket, not to a file.
|
||||
.It Bq Er EIO
|
||||
An I/O error occurred while reading from or writing to the file system.
|
||||
|
@ -43,9 +43,9 @@
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <sys/time.h>
|
||||
.Fd #define ITIMER_REAL 0
|
||||
.Fd #define ITIMER_VIRTUAL 1
|
||||
.Fd #define ITIMER_PROF 2
|
||||
.Fd "#define ITIMER_REAL 0"
|
||||
.Fd "#define ITIMER_VIRTUAL 1"
|
||||
.Fd "#define ITIMER_PROF 2"
|
||||
.Ft int
|
||||
.Fn getitimer "int which" "struct itimerval *value"
|
||||
.Ft int
|
||||
|
@ -44,8 +44,8 @@
|
||||
.Fd #include <sys/types.h>
|
||||
.Fd #include <sys/time.h>
|
||||
.Fd #include <sys/resource.h>
|
||||
.Fd #define RUSAGE_SELF 0
|
||||
.Fd #define RUSAGE_CHILDREN -1
|
||||
.Fd "#define RUSAGE_SELF 0"
|
||||
.Fd "#define RUSAGE_CHILDREN -1"
|
||||
.Ft int
|
||||
.Fn getrusage "int who" "struct rusage *rusage"
|
||||
.Sh DESCRIPTION
|
||||
@ -93,7 +93,9 @@ of the process(es).
|
||||
.It Fa ru_maxrss
|
||||
the maximum resident set size utilized (in kilobytes).
|
||||
.It Fa ru_ixrss
|
||||
an \*(lqintegral\*(rq value indicating the amount of memory used
|
||||
an
|
||||
.Dq integral
|
||||
value indicating the amount of memory used
|
||||
by the text segment
|
||||
that was also shared among other processes. This value is expressed
|
||||
in units of kilobytes * ticks-of-execution.
|
||||
@ -111,12 +113,16 @@ stack segment of a process (expressed in units of
|
||||
kilobytes * ticks-of-execution).
|
||||
.It Fa ru_minflt
|
||||
the number of page faults serviced without any I/O activity; here
|
||||
I/O activity is avoided by \*(lqreclaiming\*(rq a page frame from
|
||||
I/O activity is avoided by
|
||||
.Dq reclaiming
|
||||
a page frame from
|
||||
the list of pages awaiting reallocation.
|
||||
.It Fa ru_majflt
|
||||
the number of page faults serviced that required I/O activity.
|
||||
.It Fa ru_nswap
|
||||
the number of times a process was \*(lqswapped\*(rq out of main
|
||||
the number of times a process was
|
||||
.Dq swapped
|
||||
out of main
|
||||
memory.
|
||||
.It Fa ru_inblock
|
||||
the number of times the file system had to perform input.
|
||||
|
@ -375,9 +375,9 @@ A socket operation failed because the destination host was down.
|
||||
A socket operation was attempted to an unreachable host.
|
||||
.It Er 66 ENOTEMPTY Em "Directory not empty" .
|
||||
A directory with entries other than
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
and
|
||||
.Ql \&..
|
||||
.Ql ..\&
|
||||
was supplied to a remove directory or rename call.
|
||||
.It Er 67 EPROCLIM Em "Too many processes" .
|
||||
.It Er 68 EUSERS Em "Too many users" .
|
||||
@ -451,6 +451,7 @@ The scheduled operation was canceled.
|
||||
While decoding a multibyte character the function came along an
|
||||
invalid or an incomplete sequence of bytes or the given wide
|
||||
character is invalid.
|
||||
.El
|
||||
.Sh DEFINITIONS
|
||||
.Bl -tag -width Ds
|
||||
.It Process ID .
|
||||
@ -632,7 +633,7 @@ A directory is a special type of file that contains entries
|
||||
that are references to other files.
|
||||
Directory entries are called links. By convention, a directory
|
||||
contains at least two links,
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
and
|
||||
.Ql \&.. ,
|
||||
referred to as
|
||||
@ -692,7 +693,6 @@ but the permissions for ``other users'' allow access.
|
||||
.Pp
|
||||
Otherwise, permission is denied.
|
||||
.It Sockets and Address Families
|
||||
.Pp
|
||||
A socket is an endpoint for communication between processes.
|
||||
Each socket has queues for sending and receiving data.
|
||||
.Pp
|
||||
@ -712,6 +712,7 @@ communications protocols. Each protocol set supports addresses
|
||||
of a certain format. An Address Family is the set of addresses
|
||||
for a specific group of protocols. Each socket has an address
|
||||
chosen from the address family in which the socket was created.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr intro 3 ,
|
||||
.Xr perror 3
|
||||
|
@ -52,7 +52,7 @@ from the inside of the prison.
|
||||
The
|
||||
.Dq Li ip_number
|
||||
can be set to the IP number assigned to the prison.
|
||||
.Sh PRISON ?
|
||||
.Sh PRISON\ ?
|
||||
Once a process has been put in a prison, it and its decendants cannot escape
|
||||
the prison. It is not possible to add a process to a preexisting prison.
|
||||
.Pp
|
||||
|
@ -62,6 +62,7 @@ fails:
|
||||
The data required for this operation could not be read from the kernel space.
|
||||
.It Bq Er ENOENT
|
||||
The file specified is not loaded in the kernel.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kldfirstmod 2 ,
|
||||
.Xr kldload 2 ,
|
||||
|
@ -55,6 +55,7 @@ or 0 if there are no references.
|
||||
The kld file referenced by
|
||||
.Fa fileid
|
||||
was not found.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kldfind 2 ,
|
||||
.Xr kldload 2 ,
|
||||
|
@ -69,6 +69,7 @@ The file was not found.
|
||||
The file format of
|
||||
.Fa file
|
||||
was unrecognized.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kldfind 2 ,
|
||||
.Xr kldfirstmod 2 ,
|
||||
|
@ -77,6 +77,7 @@ The id of the file specified in
|
||||
The load address of the kld file.
|
||||
.It size
|
||||
The size of the file.
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
The function
|
||||
.Fn kldstat
|
||||
@ -107,6 +108,7 @@ There was a problem copying one, some, or all of the fields into
|
||||
in the
|
||||
.Fn copyout
|
||||
function.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kldfind 2 ,
|
||||
.Xr kldfirstmod 2 ,
|
||||
|
@ -64,6 +64,7 @@ You don't have access to unlink the file from the kernel.
|
||||
The file was not found.
|
||||
.It Bq Er EBUSY
|
||||
You attempted to unload a file linked by the kernel.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kldfind 2 ,
|
||||
.Xr kldfirstmod 2 ,
|
||||
|
@ -192,13 +192,13 @@ Arguments may be passed to and from the filter via the
|
||||
and
|
||||
.Va data
|
||||
fields in the kevent structure.
|
||||
.Bl -tag
|
||||
.Bl -tag -width EVFILT_SIGNAL
|
||||
.It EVFILT_READ
|
||||
Takes a descriptor as the identifier, and returns whenever
|
||||
there is data available to read.
|
||||
The behavior of the filter is slightly different depending
|
||||
on the descriptor type.
|
||||
.Bl -tag
|
||||
.Bl -tag -width 2n
|
||||
.It Sockets
|
||||
Sockets which have previously been passed to
|
||||
.Fn listen
|
||||
@ -216,16 +216,12 @@ also sets EV_EOF in
|
||||
.Va flags .
|
||||
It is possible for EOF to be returned (indicating the connection is gone)
|
||||
while there is still data pending in the socket buffer.
|
||||
.El
|
||||
.Bl -tag
|
||||
.It Vnodes
|
||||
Returns when the file pointer is not at the end of file.
|
||||
.Va data
|
||||
contains the offset from current position to end of file,
|
||||
and may be negative.
|
||||
.El
|
||||
.Bl -tag
|
||||
.It Fifos, Pipes
|
||||
.It "Fifos, Pipes"
|
||||
Returns when the there is data to read;
|
||||
.Va data
|
||||
contains the number of bytes available.
|
||||
@ -236,8 +232,6 @@ This may be cleared by passing in EV_CLEAR, at which point the
|
||||
filter will resume waiting for data to become available before
|
||||
returning.
|
||||
.El
|
||||
.El
|
||||
.Bl -tag
|
||||
.It EVFILT_WRITE
|
||||
Takes a descriptor as the identifier, and returns whenever
|
||||
it is possible to write to the descriptor. For sockets, pipes
|
||||
@ -247,8 +241,6 @@ will contain the amount of space remaining in the write buffer.
|
||||
The filter will set EV_EOF when the reader disconnects, and for
|
||||
the fifo case, this may be cleared by use of EV_CLEAR.
|
||||
Note that this filter is not supported for vnodes.
|
||||
.El
|
||||
.Bl -tag
|
||||
.It EVFILT_AIO
|
||||
A kevent structure is initialized, with
|
||||
.Va ident
|
||||
@ -264,8 +256,6 @@ returned by the aio_* function.
|
||||
The filter returns under the same conditions as aio_error.
|
||||
.Pp
|
||||
NOTE: this interface is unstable and subject to change.
|
||||
.El
|
||||
.Bl -tag
|
||||
.It EVFILT_VNODE
|
||||
Takes a file descriptor as the identifier and the events to watch for in
|
||||
.Va fflags ,
|
||||
@ -290,8 +280,6 @@ The file referenced by the descriptor was renamed.
|
||||
On return,
|
||||
.Va fflags
|
||||
contains the events which triggered the filter.
|
||||
.El
|
||||
.Bl -tag
|
||||
.It EVFILT_PROC
|
||||
Takes the process ID to monitor as the identifier and the events to watch for
|
||||
in
|
||||
|
@ -70,10 +70,12 @@ The
|
||||
parameter specifies the requested ktrace operation.
|
||||
The defined operations are:
|
||||
.Bl -column KTRFLAG_DESCENDXXX -offset indent
|
||||
.It KTROP_SET Enable trace points specified in Fa trpoints .
|
||||
.It KTROP_CLEAR Disable trace points specified in Fa trpoints .
|
||||
.It KTROP_CLEARFILE Stop all tracing.
|
||||
.It KTRFLAG_DESCEND The tracing change should apply to the
|
||||
.It "KTROP_SET Enable trace points specified in"
|
||||
.Fa trpoints .
|
||||
.It "KTROP_CLEAR Disable trace points specified in
|
||||
.Fa trpoints .
|
||||
.It "KTROP_CLEARFILE Stop all tracing."
|
||||
.It "KTRFLAG_DESCEND The tracing change should apply to the"
|
||||
specified process and all its current children.
|
||||
.El
|
||||
.Pp
|
||||
@ -82,14 +84,14 @@ The
|
||||
parameter specifies the trace points of interest.
|
||||
The defined trace points are:
|
||||
.Bl -column KTRFAC_SYSCALLXXX -offset indent
|
||||
.It KTRFAC_SYSCALL Trace system calls.
|
||||
.It KTRFAC_SYSRET Trace return values from system calls.
|
||||
.It KTRFAC_NAMEI Trace name lookup operations.
|
||||
.It KTRFAC_GENIO Trace all I/O (note that this option can
|
||||
.It "KTRFAC_SYSCALL Trace system calls."
|
||||
.It "KTRFAC_SYSRET Trace return values from system calls."
|
||||
.It "KTRFAC_NAMEI Trace name lookup operations."
|
||||
.It "KTRFAC_GENIO Trace all I/O (note that this option can"
|
||||
generate much output).
|
||||
.It KTRFAC_PSIG Trace posted signals.
|
||||
.It KTRFAC_CSW Trace context switch points.
|
||||
.It KTRFAC_INHERIT Inherit tracing to future children.
|
||||
.It "KTRFAC_PSIG Trace posted signals."
|
||||
.It "KTRFAC_CSW Trace context switch points."
|
||||
.It "KTRFAC_INHERIT Inherit tracing to future children."
|
||||
.El
|
||||
.Pp
|
||||
Each tracing event outputs a record composed of a generic header
|
||||
|
@ -261,7 +261,7 @@ parameters and
|
||||
.Fa fd
|
||||
was not open for writing.
|
||||
.It Bq Er EBADF
|
||||
.Fa Fd
|
||||
.Fa fd
|
||||
is not a valid open file descriptor.
|
||||
.It Bq Er EINVAL
|
||||
.Dv MAP_FIXED
|
||||
@ -293,6 +293,7 @@ parameter wasn't available, or the system has reached the per-process mmap
|
||||
limit specified in the vm.max_proc_mmap sysctl.
|
||||
.Dv MAP_ANON
|
||||
was specified and insufficient memory was available.
|
||||
.El
|
||||
.Sh "SEE ALSO"
|
||||
.Xr madvise 2 ,
|
||||
.Xr mincore 2 ,
|
||||
|
@ -62,6 +62,7 @@ fails:
|
||||
The data required for this operation could not be read from the kernel space.
|
||||
.It Bq Er ENOENT
|
||||
The file specified is not loaded in the kernel.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kldfirstmod 2 ,
|
||||
.Xr kldload 2 ,
|
||||
|
@ -80,6 +80,7 @@ The id of the module specified in
|
||||
.Fa modid .
|
||||
.It data
|
||||
Module specific data.
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
.Fn modstat
|
||||
seems to always return 0.
|
||||
@ -106,6 +107,7 @@ There was a problem copying one, some, or all of the fields into
|
||||
in the
|
||||
.Fn copyout
|
||||
function.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kldfind 2 ,
|
||||
.Xr kldfirstmod 2 ,
|
||||
|
@ -91,6 +91,7 @@ was both MS_ASYNC and MS_INVALIDATE.
|
||||
Only one of these flags is allowed.
|
||||
.It Bq Er EIO
|
||||
An I/O error occurred while writing to the file system.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr madvise 2 ,
|
||||
.Xr mincore 2 ,
|
||||
|
@ -71,6 +71,7 @@ parameter was not page aligned, the
|
||||
parameter was negative, or
|
||||
some part of the region being unmapped is outside the
|
||||
valid address range for a process.
|
||||
.El
|
||||
.Sh "SEE ALSO"
|
||||
.Xr madvise 2 ,
|
||||
.Xr mincore 2 ,
|
||||
|
@ -75,7 +75,7 @@ Symbolic constants for each name value are found in the include file
|
||||
.Pp
|
||||
The available values are as follows:
|
||||
.Pp
|
||||
.Bl -tag -width "123456"
|
||||
.Bl -tag -width 6n
|
||||
.Pp
|
||||
.It Li _PC_LINK_MAX
|
||||
The maximum file link count.
|
||||
|
@ -309,6 +309,7 @@ on a process in violation of the requirements listed under
|
||||
.Dv PT_ATTACH
|
||||
above.
|
||||
.El
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr execve 2 ,
|
||||
.Xr sigaction 2 ,
|
||||
|
@ -184,7 +184,7 @@ points outside the process's allocated address space.
|
||||
is a parent directory of
|
||||
.Fa to ,
|
||||
or an attempt is made to rename
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
or
|
||||
.Ql \&.. .
|
||||
.It Bq Er ENOTEMPTY
|
||||
|
@ -51,7 +51,7 @@ whose name is given by
|
||||
.Fa path .
|
||||
The directory must not have any entries other
|
||||
than
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
and
|
||||
.Ql \&.. .
|
||||
.Sh RETURN VALUES
|
||||
@ -72,9 +72,9 @@ The named directory does not exist.
|
||||
Too many symbolic links were encountered in translating the pathname.
|
||||
.It Bq Er ENOTEMPTY
|
||||
The named directory contains files other than
|
||||
.Ql \&.
|
||||
.Ql .\&
|
||||
and
|
||||
.Ql \&..
|
||||
.Ql ..\&
|
||||
in it.
|
||||
.It Bq Er EACCES
|
||||
Search permission is denied for a component of the path prefix.
|
||||
|
@ -102,6 +102,7 @@ root is allowed to change the realtime priority of any process, and non-root
|
||||
may only change the idle priority of the current process.
|
||||
.It Bq Er ESRCH
|
||||
The specified process was not found.
|
||||
.El
|
||||
.Sh AUTHORS
|
||||
.An -nosplit
|
||||
The original author was
|
||||
|
@ -54,6 +54,7 @@ will be set to the corresponding value:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ENOSYS
|
||||
The system is not configured to support this functionality.
|
||||
.El
|
||||
.Sh STANDARDS
|
||||
The
|
||||
.Fn sched_yield
|
||||
|
@ -174,6 +174,7 @@ the semaphore set's owner or creator.
|
||||
.It Bq Er EACCES
|
||||
Permission denied due to mismatch between operation and mode of
|
||||
semaphore set.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr semget 2 ,
|
||||
.Xr semop 2
|
||||
|
@ -134,6 +134,7 @@ The kernel could not allocate a
|
||||
No semaphore set was found corresponding to
|
||||
.Fa key ,
|
||||
and IPC_CREAT was not specified.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr semctl 2 ,
|
||||
.Xr semop 2 ,
|
||||
|
@ -191,6 +191,7 @@ Too many operations were specified.
|
||||
.\"
|
||||
.Fa sem_num
|
||||
was not in the range of valid semaphores for the set.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr semctl 2 ,
|
||||
.Xr semget 2
|
||||
|
@ -64,6 +64,7 @@ The calling process was not privileged
|
||||
and tried to change one or more IDs to a value
|
||||
which was not the current real ID, the current effective ID
|
||||
nor the current saved ID.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr getegid 2 ,
|
||||
.Xr geteuid 2 ,
|
||||
|
@ -108,6 +108,7 @@ will fail if:
|
||||
.It Bq Er EINVAL
|
||||
.Fa addr
|
||||
does not point to a shared memory segment.
|
||||
.El
|
||||
.Sh "SEE ALSO"
|
||||
.Xr shmctl 2 ,
|
||||
.Xr shmget 2
|
||||
|
@ -132,6 +132,7 @@ the shared memory segment's owner or creator.
|
||||
.It Bq Er EACCES
|
||||
Permission denied due to mismatch between operation and mode of
|
||||
shared memory segment.
|
||||
.El
|
||||
.Sh "SEE ALSO"
|
||||
.Xr shmat 2 ,
|
||||
.Xr shmdt 2 ,
|
||||
|
@ -133,7 +133,7 @@ IPC_CREAT and IPC_EXCL were specified, and a shared memory segment
|
||||
corresponding to
|
||||
.Fa key
|
||||
already exists.
|
||||
.Pp
|
||||
.El
|
||||
.Sh "SEE ALSO"
|
||||
.Xr shmat 2 ,
|
||||
.Xr shmctl 2 ,
|
||||
|
@ -265,13 +265,13 @@ The following is a list of all signals
|
||||
with names as in the include file
|
||||
.Aq Pa signal.h :
|
||||
.Bl -column SIGVTALARMXX "create core imagexxx"
|
||||
.It Sy " NAME " " Default Action " " Description"
|
||||
.It Sy "NAME Default Action Description"
|
||||
.It Dv SIGHUP No " terminate process" " terminal line hangup"
|
||||
.It Dv SIGINT No " terminate process" " interrupt program"
|
||||
.It Dv SIGQUIT No " create core image" " quit program"
|
||||
.It Dv SIGILL No " create core image" " illegal instruction"
|
||||
.It Dv SIGTRAP No " create core image" " trace trap"
|
||||
.It Dv SIGABRT No " create core image" Xr abort 3
|
||||
.It Dv SIGABRT No " create core image" Ta Xr abort 3
|
||||
call (formerly
|
||||
.Dv SIGIOT )
|
||||
.It Dv SIGEMT No " create core image" " emulate instruction executed"
|
||||
@ -428,14 +428,14 @@ is set to indicated the reason.
|
||||
There are three possible prototypes the handler may match:
|
||||
.Bl -tag -offset indent -width short
|
||||
.It ANSI C:
|
||||
.Fd
|
||||
void handler(int);
|
||||
.Ft void
|
||||
.Fn handler int ;
|
||||
.It Traditional BSD style:
|
||||
.Fd
|
||||
void handler(int, int code, struct sigcontext *scp);
|
||||
.Ft void
|
||||
.Fn handler int "int code" "struct sigcontext *scp" ;
|
||||
.It POSIX SA_SIGINFO:
|
||||
.Fd
|
||||
void handler(int, siginfo_t *info, void *context);
|
||||
.Ft void
|
||||
.Fn handler int "siginfo_t *info" "void *context" ;
|
||||
.El
|
||||
.Pp
|
||||
The handler function should match the SA_SIGINFO prototype if the
|
||||
|
@ -109,6 +109,7 @@ of the following occurs:
|
||||
.It Bq Er EINVAL
|
||||
.Fa how
|
||||
has a value other than those listed here.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr kill 2 ,
|
||||
.Xr sigaction 2 ,
|
||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user