mdoc(7) police: Er macro usage cleanup.
This commit is contained in:
parent
b4f0f4aa81
commit
c23155a43a
@ -61,7 +61,7 @@ signals are to be blocked.
|
||||
always terminates by being interrupted, returning -1 with
|
||||
.Va errno
|
||||
set to
|
||||
.Dv EINTR
|
||||
.Er EINTR
|
||||
.Sh SEE ALSO
|
||||
.Xr kill 2 ,
|
||||
.Xr sigaction 2 ,
|
||||
|
@ -204,7 +204,7 @@ of the signal are ignored and discarded.
|
||||
If a signal is caught during the system calls listed below,
|
||||
the call is normally restarted.
|
||||
The call can be forced to terminate prematurely with an
|
||||
.Dv EINTR
|
||||
.Er EINTR
|
||||
error return by setting the
|
||||
.Dv SV_INTERRUPT
|
||||
bit in
|
||||
|
@ -281,9 +281,9 @@ is not a directory, resulting in a
|
||||
call to
|
||||
.Fa errfunc .
|
||||
The error routine can suppress this action by testing for
|
||||
.Dv ENOENT
|
||||
.Er ENOENT
|
||||
and
|
||||
.Dv ENOTDIR ;
|
||||
.Er ENOTDIR ;
|
||||
however, the
|
||||
.Dv GLOB_ERR
|
||||
flag will still cause an immediate
|
||||
|
@ -81,5 +81,7 @@ if called while there are threads blocked on
|
||||
.Fa sem ,
|
||||
but this implementation is guaranteed to return -1 and set
|
||||
.Va errno
|
||||
to EBUSY if there are threads blocked on
|
||||
to
|
||||
.Er EBUSY
|
||||
if there are threads blocked on
|
||||
.Fa sem .
|
||||
|
@ -95,7 +95,9 @@ Std 1003.1 1996 Edition.
|
||||
This implementation does not support shared semaphores, and reports this fact
|
||||
by setting
|
||||
.Va errno
|
||||
to EPERM. This is perhaps a stretch of the intention of POSIX, but is
|
||||
to
|
||||
.Er EPERM .
|
||||
This is perhaps a stretch of the intention of POSIX, but is
|
||||
compliant, with the caveat that
|
||||
.Fn sem_init
|
||||
always reports a permissions error when an attempt to create a shared semaphore
|
||||
|
@ -67,7 +67,7 @@ and no data has been transferred,
|
||||
the system call will return \-1 with the global variable
|
||||
.Va errno
|
||||
set to
|
||||
.Dv EINTR .
|
||||
.Er EINTR .
|
||||
Interrupted system calls that have started transferring
|
||||
data will return the amount of data actually transferred.
|
||||
System call interrupt is the signal behavior found on
|
||||
|
@ -91,11 +91,13 @@ The size of the buffer is given by the location specified by
|
||||
.Fa oldlenp
|
||||
before the call,
|
||||
and that location gives the amount of data copied after a successful call
|
||||
and after a call that returns with the error code ENOMEM.
|
||||
and after a call that returns with the error code
|
||||
.Er ENOMEM .
|
||||
If the amount of data available is greater
|
||||
than the size of the buffer supplied,
|
||||
the call supplies as much data as fits in the buffer provided
|
||||
and returns with the error code ENOMEM.
|
||||
and returns with the error code
|
||||
.Er ENOMEM .
|
||||
If the old value is not desired,
|
||||
.Fa oldp
|
||||
and
|
||||
@ -391,7 +393,8 @@ It is also possible for a process to set its own process title this way.
|
||||
Return profiling information about the kernel.
|
||||
If the kernel is not compiled for profiling,
|
||||
attempts to retrieve any of the KERN_PROF values will
|
||||
fail with EOPNOTSUPP.
|
||||
fail with
|
||||
.Er EOPNOTSUPP .
|
||||
The third level names for the string and integer profiling information
|
||||
is detailed below.
|
||||
The changeable column shows whether a process with appropriate
|
||||
|
@ -214,18 +214,18 @@ The
|
||||
.Fn setrunelocale
|
||||
function returns one of the following values:
|
||||
.Bl -tag -width Er
|
||||
.It Dv 0
|
||||
.It Er 0
|
||||
.Fn setrunelocale
|
||||
was successful.
|
||||
.It Er EFAULT
|
||||
.It Bq Er EFAULT
|
||||
.Fa locale
|
||||
was
|
||||
.Dv NULL .
|
||||
.It Er ENOENT
|
||||
.It Bq Er ENOENT
|
||||
The locale could not be found.
|
||||
.It Er EFTYPE
|
||||
.It Bq Er EFTYPE
|
||||
The file found was not a valid file.
|
||||
.It Er EINVAL
|
||||
.It Bq Er EINVAL
|
||||
The encoding indicated by the locale was unknown.
|
||||
.El
|
||||
.Pp
|
||||
|
@ -258,7 +258,7 @@ It returns -1 on error with the global value
|
||||
.Va errno
|
||||
set according to the reason for failure.
|
||||
The error code
|
||||
.Dv EAGAIN
|
||||
.Er EAGAIN
|
||||
is overloaded to mean ``All network ports in use.''
|
||||
.Sh SEE ALSO
|
||||
.Xr rlogin 1 ,
|
||||
|
@ -70,7 +70,7 @@ function shall return -1 and set
|
||||
.Ar errno
|
||||
to the corresponding value:
|
||||
.Bl -tag -width Er
|
||||
.It Bq er EINVAL
|
||||
.It Bq Er EINVAL
|
||||
At least one of the values of
|
||||
.Ar cap_p ,
|
||||
.Ar ncap ,
|
||||
|
@ -119,5 +119,5 @@ and development continues.
|
||||
uses a bounded size (1024 byte) buffer in which to assemble the resulting
|
||||
text string.
|
||||
If the string requires more space than that buffer provides,
|
||||
.Va ENOMEM
|
||||
.Er ENOMEM
|
||||
will be returned.
|
||||
|
@ -90,12 +90,12 @@ is stored in the location referenced by
|
||||
If the correct value would cause overflow, plus or minus
|
||||
.Dv HUGE_VAL
|
||||
is returned (according to the sign of the value), and
|
||||
.Dv ERANGE
|
||||
.Er ERANGE
|
||||
is stored in
|
||||
.Va errno .
|
||||
If the correct value would cause underflow, zero is
|
||||
returned and
|
||||
.Dv ERANGE
|
||||
.Er ERANGE
|
||||
is stored in
|
||||
.Va errno .
|
||||
.Sh ERRORS
|
||||
|
@ -48,7 +48,7 @@ is specified, only that specific asynchronous I/O request is cancelled.
|
||||
.Pp
|
||||
Normal asynchronous notification occurs for cancelled requests. Requests
|
||||
complete with an error result of
|
||||
.Dv ECANCELED .
|
||||
.Er ECANCELED .
|
||||
.Sh RESTRICTIONS
|
||||
The
|
||||
.Fn aio_cancel
|
||||
|
@ -46,7 +46,7 @@ associated with the structure pointed to by
|
||||
If the asynchronous I/O request has completed successfully,
|
||||
.Fn aio_error
|
||||
returns 0. If the request has not yet completed,
|
||||
.Dv EINPROGRESS
|
||||
.Er EINPROGRESS
|
||||
is returned. If the request has completed unsuccessfully the error
|
||||
status is returned as described in
|
||||
.Xr read 2 ,
|
||||
|
@ -48,7 +48,7 @@ should only be called once, to obtain the final status of an asynchronous
|
||||
I/O operation once
|
||||
.Xr aio_error 2
|
||||
returns something other than
|
||||
.Dv EINPROGRESS .
|
||||
.Er EINPROGRESS .
|
||||
.Sh RETURN VALUES
|
||||
If the asynchronous I/O request has completed, the status is returned
|
||||
as described in
|
||||
|
@ -213,7 +213,10 @@ The
|
||||
.Fn chmod
|
||||
function call is expected to conform to
|
||||
.St -p1003.1-90 ,
|
||||
except for the return of EFTYPE and the use of S_ISTXT.
|
||||
except for the return of
|
||||
.Er EFTYPE
|
||||
and the use of
|
||||
.Dv S_ISTXT .
|
||||
.Sh HISTORY
|
||||
A
|
||||
.Fn chmod
|
||||
|
@ -75,13 +75,17 @@ If
|
||||
.Ql kern.chroot_allow_open_directories
|
||||
is set to zero,
|
||||
.Fn chroot
|
||||
will always fail with EPERM if there are any directories open.
|
||||
will always fail with
|
||||
.Er EPERM
|
||||
if there are any directories open.
|
||||
.Pp
|
||||
If
|
||||
.Ql kern.chroot_allow_open_directories
|
||||
is set to one (the default),
|
||||
.Fn chroot
|
||||
will fail with EPERM if there are any directories open and the
|
||||
will fail with
|
||||
.Er EPERM
|
||||
if there are any directories open and the
|
||||
process is already subject to a
|
||||
.Fn chroot
|
||||
call.
|
||||
|
@ -146,7 +146,7 @@ has not yet been completed.
|
||||
.Pp
|
||||
The following errors are specific to connecting names in the UNIX domain.
|
||||
These errors may not apply in future versions of the UNIX IPC domain.
|
||||
.Bl -tag -width EADDRNOTAVAILABB
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ENOTDIR
|
||||
A component of the path prefix is not a directory.
|
||||
.It Bq Er ENAMETOOLONG
|
||||
|
@ -60,31 +60,31 @@ is set to indicate the error.
|
||||
.Fn Getfh
|
||||
fails if one or more of the following are true:
|
||||
.Bl -tag -width Er
|
||||
.It Bq ENOTDIR
|
||||
.It Bq Er ENOTDIR
|
||||
A component of the path prefix of
|
||||
.Fa path
|
||||
is not a directory.
|
||||
.It Bq ENAMETOOLONG
|
||||
.It Bq Er ENAMETOOLONG
|
||||
The length of a component of
|
||||
.Fa path
|
||||
exceeds 255 characters,
|
||||
or the length of
|
||||
.Fa path
|
||||
exceeds 1023 characters.
|
||||
.It Bq ENOENT
|
||||
.It Bq Er ENOENT
|
||||
The file referred to by
|
||||
.Fa path
|
||||
does not exist.
|
||||
.It Bq EACCES
|
||||
.It Bq Er EACCES
|
||||
Search permission is denied for a component of the path prefix of
|
||||
.Fa path .
|
||||
.It Bq ELOOP
|
||||
.It Bq Er ELOOP
|
||||
Too many symbolic links were encountered in translating
|
||||
.Fa path .
|
||||
.It Bq EFAULT
|
||||
.It Bq Er EFAULT
|
||||
.Fa Fhp
|
||||
points to an invalid address.
|
||||
.It Bq EIO
|
||||
.It Bq Er EIO
|
||||
An
|
||||
.Tn I/O
|
||||
error occurred while reading from or writing to the file system.
|
||||
|
@ -155,10 +155,10 @@ is set to indicate the error.
|
||||
.Fn Getfsstat
|
||||
fails if one or more of the following are true:
|
||||
.Bl -tag -width Er
|
||||
.It EFAULT
|
||||
.It Bq Er EFAULT
|
||||
.Fa Buf
|
||||
points to an invalid address.
|
||||
.It EIO
|
||||
.It Bq Er EIO
|
||||
An
|
||||
.Tn I/O
|
||||
error occurred while reading from or writing to the filesystem.
|
||||
|
@ -55,7 +55,9 @@ is set to indicate the error.
|
||||
.Sh ERRORS
|
||||
The only error set by
|
||||
.Fn kldnext
|
||||
is ENOENT, which is set when
|
||||
is
|
||||
.Er ENOENT ,
|
||||
which is set when
|
||||
.Va fileid
|
||||
refers to a kld file that does not exist (isn't loaded).
|
||||
.Sh SEE ALSO
|
||||
|
@ -390,7 +390,7 @@ The
|
||||
.Fn kevent
|
||||
function fails if:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EACCESS
|
||||
.It Bq Er EACCES
|
||||
The process does not have permission to register a filter.
|
||||
.It Bq Er EFAULT
|
||||
There was an error reading or writing the
|
||||
|
@ -67,7 +67,7 @@ indicates an error, and an error code is stored in
|
||||
.Fn Mkfifo
|
||||
will fail and no fifo will be created if:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ENOTSUPP
|
||||
.It Bq Er ENOTSUP
|
||||
The kernel has not been configured to support fifo's.
|
||||
.It Bq Er ENOTDIR
|
||||
A component of the path prefix is not a directory.
|
||||
|
@ -65,7 +65,9 @@ is set to indicate the error.
|
||||
.Sh ERRORS
|
||||
The only error set by
|
||||
.Fn modnext
|
||||
is ENOENT, which is set when
|
||||
is
|
||||
.Er ENOENT ,
|
||||
which is set when
|
||||
.Va modid
|
||||
refers to a kernel module that does not exist (isn't loaded).
|
||||
.Sh SEE ALSO
|
||||
|
@ -216,7 +216,7 @@ points outside the process's allocated address space.
|
||||
The following errors can occur for a
|
||||
.Em ufs
|
||||
filesystem mount:
|
||||
.Bl -tag -width [ENOTBLK]
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ENODEV
|
||||
A component of ufs_args
|
||||
.Ar fspec
|
||||
@ -251,7 +251,7 @@ points outside the process's allocated address space.
|
||||
The following errors can occur for a
|
||||
.Em nfs
|
||||
filesystem mount:
|
||||
.Bl -tag -width [ENOTBLK]
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ETIMEDOUT
|
||||
.Em Nfs
|
||||
timed out trying to contact the server.
|
||||
@ -263,7 +263,7 @@ points outside the process's allocated address space.
|
||||
The following errors can occur for a
|
||||
.Em mfs
|
||||
filesystem mount:
|
||||
.Bl -tag -width [ENOTBLK]
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EMFILE
|
||||
No space remains in the mount table.
|
||||
.It Bq Er EINVAL
|
||||
@ -283,7 +283,7 @@ points outside the process's allocated address space.
|
||||
The
|
||||
.Fn unmount
|
||||
function may fail with one of the following errors:
|
||||
.Bl -tag -width [ENOTBLK]
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EPERM
|
||||
The caller is not the super-user.
|
||||
.It Bq Er ENOTDIR
|
||||
|
@ -108,7 +108,11 @@ If the mount point is using Kerberos, then the
|
||||
.Xr mount_nfs 8
|
||||
daemon will return from
|
||||
.Fn nfssvc
|
||||
with errno == ENEEDAUTH whenever the client side requires an ``rcmd''
|
||||
with
|
||||
.Va errno
|
||||
==
|
||||
.Er ENEEDAUTH
|
||||
whenever the client side requires an ``rcmd''
|
||||
authentication ticket for the user.
|
||||
.Xr Mount_nfs 8
|
||||
will attempt to get the Kerberos ticket, and if successful will call
|
||||
@ -161,7 +165,10 @@ Whenever an
|
||||
.Xr nfsd 8
|
||||
daemon receives a Kerberos authentication ticket, it will return from
|
||||
.Fn nfssvc
|
||||
with errno == ENEEDAUTH.
|
||||
with
|
||||
.Va errno
|
||||
==
|
||||
.Er ENEEDAUTH .
|
||||
The
|
||||
.Xr nfsd 8
|
||||
will attempt to authenticate the ticket and generate a set of credentials
|
||||
@ -246,7 +253,7 @@ system call is designed specifically for the
|
||||
support daemons and as such is specific to their requirements.
|
||||
It should really return values to indicate the need for authentication
|
||||
support, since
|
||||
.Dv ENEEDAUTH
|
||||
.Er ENEEDAUTH
|
||||
is not really an error.
|
||||
Several fields of the argument structures are assumed to be valid and
|
||||
sometimes to be unchanged from a previous call, such that
|
||||
|
@ -129,9 +129,10 @@ argument is invalid.
|
||||
The implementation does not support an association of the variable
|
||||
name with the associated file.
|
||||
.El
|
||||
.Pp
|
||||
.Fn Pathconf
|
||||
will fail if:
|
||||
.Bl -tag -width ENAMETOOLONGAA
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ENOTDIR
|
||||
A component of the path prefix is not a directory.
|
||||
.It Bq Er ENAMETOOLONG
|
||||
@ -147,7 +148,7 @@ Too many symbolic links were encountered in translating the pathname.
|
||||
An I/O error occurred while reading from or writing to the file system.
|
||||
.El
|
||||
.Pp
|
||||
.Bl -tag -width [EFAULT]
|
||||
.Bl -tag -width Er
|
||||
.Fn Fpathconf
|
||||
will fail if:
|
||||
.It Bq Er EBADF
|
||||
|
@ -118,14 +118,16 @@ value, one of the following happens:
|
||||
.It
|
||||
If IPC_NOWAIT was specified, then
|
||||
.Fn semop
|
||||
returns immediately with a return value of EAGAIN.
|
||||
returns immediately with a return value of
|
||||
.Er EAGAIN .
|
||||
.It
|
||||
If some other process has removed the semaphore with the IPC_RMID
|
||||
option of
|
||||
.Fn semctl ,
|
||||
then
|
||||
.Fn semop
|
||||
returns immediately with a return value of EINVAL.
|
||||
returns immediately with a return value of
|
||||
.Er EINVAL .
|
||||
.It
|
||||
Otherwise, the calling process is put to sleep until the semaphore's
|
||||
value is greater than or equal to the absolute value of
|
||||
|
@ -59,7 +59,7 @@ and the global variable
|
||||
is set to indicate the error.
|
||||
.Sh ERRORS
|
||||
.Bl -tag -width Er
|
||||
.It Er EPERM
|
||||
.It Bq Er EPERM
|
||||
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
|
||||
|
@ -192,7 +192,7 @@ a
|
||||
.Xr wait 2
|
||||
(or equivalent), it blocks until all of the calling process's child
|
||||
processes terminate, and then returns a value of -1 with errno set to
|
||||
.Dv ECHILD .
|
||||
.Er ECHILD .
|
||||
.It Dv SA_ONSTACK
|
||||
If this bit is set, the system will deliver the signal to the process
|
||||
on a
|
||||
@ -220,7 +220,7 @@ or
|
||||
If a signal is caught during the system calls listed below,
|
||||
the call may be forced to terminate
|
||||
with the error
|
||||
.Dv EINTR ,
|
||||
.Er EINTR ,
|
||||
the call may return with a data transfer shorter than requested,
|
||||
or the call may be restarted.
|
||||
Restart of pending calls is requested
|
||||
|
@ -85,7 +85,7 @@ Trying to disable an active stack will cause
|
||||
to return -1 with
|
||||
.Va errno
|
||||
set to
|
||||
.Dv EINVAL .
|
||||
.Er EINVAL .
|
||||
A disabled stack will cause all signals to be
|
||||
taken on the regular user stack.
|
||||
If the stack is later re-enabled then all signals that were specified
|
||||
|
@ -70,7 +70,7 @@ function
|
||||
always terminates by being interrupted, returning -1 with
|
||||
.Va errno
|
||||
set to
|
||||
.Dv EINTR .
|
||||
.Er EINTR .
|
||||
.Sh SEE ALSO
|
||||
.Xr sigaction 2 ,
|
||||
.Xr sigprocmask 2 ,
|
||||
|
@ -188,7 +188,7 @@ within a reasonable length of time, then
|
||||
the connection is considered broken and calls
|
||||
will indicate an error with
|
||||
-1 returns and with
|
||||
.Dv ETIMEDOUT
|
||||
.Er ETIMEDOUT
|
||||
as the specific code
|
||||
in the global variable
|
||||
.Va errno .
|
||||
|
@ -72,7 +72,7 @@ Too many descriptors are in use by this process.
|
||||
The specified address family is not supported on this machine.
|
||||
.It Bq Er EPROTONOSUPPORT
|
||||
The specified protocol is not supported on this machine.
|
||||
.It Bq Er EOPNOSUPPORT
|
||||
.It Bq Er EOPNOTSUPP
|
||||
The specified protocol does not support creation of socket pairs.
|
||||
.It Bq Er EFAULT
|
||||
The address
|
||||
|
@ -233,7 +233,7 @@ Search permission is denied for a component of the path prefix.
|
||||
.It Bq Er ELOOP
|
||||
Too many symbolic links were encountered in translating the pathname.
|
||||
.It Bq Er EFAULT
|
||||
.Fa Sb
|
||||
.Fa sb
|
||||
or
|
||||
.Em name
|
||||
points to an invalid address.
|
||||
@ -241,14 +241,14 @@ points to an invalid address.
|
||||
An I/O error occurred while reading from or writing to the file system.
|
||||
.El
|
||||
.Pp
|
||||
.Bl -tag -width [EFAULT]
|
||||
.Bl -tag -width Er
|
||||
.Fn Fstat
|
||||
will fail if:
|
||||
.It Bq Er EBADF
|
||||
.Fa fd
|
||||
is not a valid open file descriptor.
|
||||
.It Bq Er EFAULT
|
||||
.Fa Sb
|
||||
.Fa sb
|
||||
points to an invalid address.
|
||||
.It Bq Er EIO
|
||||
An I/O error occurred while reading from or writing to the file system.
|
||||
|
@ -166,7 +166,7 @@ error occurred while reading from or writing to the file system.
|
||||
.Pp
|
||||
.Fn Fstatfs
|
||||
fails if one or more of the following are true:
|
||||
.Bl -tag -width ENAMETOOLONGA
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EBADF
|
||||
.Fa Fd
|
||||
is not a valid open file descriptor.
|
||||
|
@ -101,7 +101,7 @@ points outside the process's allocated address space.
|
||||
.Pp
|
||||
.Fn Ftruncate
|
||||
succeeds unless:
|
||||
.Bl -tag -width [ENOTDIR]
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EBADF
|
||||
The
|
||||
.Fa fd
|
||||
|
@ -242,7 +242,7 @@ If there are no children not previously awaited,
|
||||
-1 is returned with
|
||||
.Va errno
|
||||
set to
|
||||
.Bq Er ECHILD .
|
||||
.Er ECHILD .
|
||||
Otherwise, if
|
||||
.Dv WNOHANG
|
||||
is specified and there are
|
||||
|
@ -81,5 +81,7 @@ if called while there are threads blocked on
|
||||
.Fa sem ,
|
||||
but this implementation is guaranteed to return -1 and set
|
||||
.Va errno
|
||||
to EBUSY if there are threads blocked on
|
||||
to
|
||||
.Er EBUSY
|
||||
if there are threads blocked on
|
||||
.Fa sem .
|
||||
|
@ -95,7 +95,9 @@ Std 1003.1 1996 Edition.
|
||||
This implementation does not support shared semaphores, and reports this fact
|
||||
by setting
|
||||
.Va errno
|
||||
to EPERM. This is perhaps a stretch of the intention of POSIX, but is
|
||||
to
|
||||
.Er EPERM .
|
||||
This is perhaps a stretch of the intention of POSIX, but is
|
||||
compliant, with the caveat that
|
||||
.Fn sem_init
|
||||
always reports a permissions error when an attempt to create a shared semaphore
|
||||
|
@ -71,7 +71,7 @@ if:
|
||||
sets the global variable
|
||||
.Va errno
|
||||
to
|
||||
.Dv EDOM
|
||||
.Er EDOM
|
||||
and a reserved operand fault is generated.
|
||||
.Sh SEE ALSO
|
||||
.Xr asin 3 ,
|
||||
|
@ -192,7 +192,7 @@ would overflow on a
|
||||
it generates a reserved operand fault and sets the global variable
|
||||
.Va errno
|
||||
to
|
||||
.Dv ERANGE .
|
||||
.Er ERANGE .
|
||||
.Sh SEE ALSO
|
||||
.Xr floor 3 ,
|
||||
.Xr infnan 3 ,
|
||||
@ -211,7 +211,7 @@ on a
|
||||
.Tn VAX
|
||||
signal invalidity
|
||||
by setting
|
||||
.Va errno No = Dv EDOM ?
|
||||
.Va errno No = Er EDOM ?
|
||||
Should
|
||||
.Fn logb 0
|
||||
return \-1.7e38?
|
||||
|
@ -129,17 +129,18 @@ to return. And a C program to
|
||||
implement that suggestion follows.
|
||||
.sp 0.5
|
||||
.Bd -filled -offset indent
|
||||
.Bl -column "IEEE Signal" "IEEE Default" XXERANGE ERANGEXXorXXEDOM
|
||||
.Bl -column "IEEE Signal" "IEEE Default" XXERANGE ERANGEXXorXXEDOM XXXXXX
|
||||
.It IEEE Signal IEEE Default Ta
|
||||
.Fa iarg Ta
|
||||
.Va errno Ta
|
||||
.Fn infnan
|
||||
.It Invalid \*(Na Ta
|
||||
.Dv EDOM EDOM 0
|
||||
.Er EDOM EDOM 0
|
||||
.It Overflow \(+-\*(If Ta
|
||||
.Dv ERANGE ERANGE HUGE
|
||||
.Er ERANGE ERANGE Ta
|
||||
.Dv HUGE
|
||||
.It Div\-by\-0 \(+-Infinity Ta
|
||||
.Dv \(+-ERANGE ERANGE or EDOM \(+-HUGE
|
||||
.Er \(+-ERANGE ERANGE or EDOM \(+-HUGE
|
||||
.It ( Ns Dv HUGE No "= 1.7e38 ... nearly 2.0**127)"
|
||||
.El
|
||||
.Ed
|
||||
@ -165,17 +166,17 @@ int iarg ;
|
||||
.Xr math 3 ,
|
||||
.Xr signal 3 .
|
||||
.Pp
|
||||
.Dv ERANGE
|
||||
.Er ERANGE
|
||||
and
|
||||
.Dv EDOM
|
||||
.Er EDOM
|
||||
are defined in
|
||||
.Aq Pa errno.h .
|
||||
(See
|
||||
.Xr intro 2
|
||||
for explanation of
|
||||
.Dv EDOM
|
||||
.Er EDOM
|
||||
and
|
||||
.Dv ERANGE . )
|
||||
.Er ERANGE . )
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn infnan
|
||||
|
@ -103,7 +103,7 @@ the reserved operator is returned,
|
||||
and
|
||||
.Va errno
|
||||
is set to
|
||||
.Er ERANGE
|
||||
.Er ERANGE .
|
||||
For large non-integer negative values,
|
||||
.Fn gamma
|
||||
will underflow.
|
||||
|
@ -78,7 +78,7 @@ causes an error; in this event,
|
||||
the global variable
|
||||
.Va errno
|
||||
is set to
|
||||
.Dv EDOM
|
||||
.Er EDOM
|
||||
and a reserved operand fault is generated.
|
||||
.Sh ERROR (due to Roundoff etc.)
|
||||
The
|
||||
|
@ -70,7 +70,7 @@ function shall return -1 and set
|
||||
.Ar errno
|
||||
to the corresponding value:
|
||||
.Bl -tag -width Er
|
||||
.It Bq er EINVAL
|
||||
.It Bq Er EINVAL
|
||||
At least one of the values of
|
||||
.Ar cap_p ,
|
||||
.Ar ncap ,
|
||||
|
@ -119,5 +119,5 @@ and development continues.
|
||||
uses a bounded size (1024 byte) buffer in which to assemble the resulting
|
||||
text string.
|
||||
If the string requires more space than that buffer provides,
|
||||
.Va ENOMEM
|
||||
.Er ENOMEM
|
||||
will be returned.
|
||||
|
@ -81,5 +81,7 @@ if called while there are threads blocked on
|
||||
.Fa sem ,
|
||||
but this implementation is guaranteed to return -1 and set
|
||||
.Va errno
|
||||
to EBUSY if there are threads blocked on
|
||||
to
|
||||
.Er EBUSY
|
||||
if there are threads blocked on
|
||||
.Fa sem .
|
||||
|
@ -95,7 +95,9 @@ Std 1003.1 1996 Edition.
|
||||
This implementation does not support shared semaphores, and reports this fact
|
||||
by setting
|
||||
.Va errno
|
||||
to EPERM. This is perhaps a stretch of the intention of POSIX, but is
|
||||
to
|
||||
.Er EPERM .
|
||||
This is perhaps a stretch of the intention of POSIX, but is
|
||||
compliant, with the caveat that
|
||||
.Fn sem_init
|
||||
always reports a permissions error when an attempt to create a shared semaphore
|
||||
|
@ -143,7 +143,7 @@ In addition
|
||||
may set
|
||||
.Va errno
|
||||
to
|
||||
.Bq Er ENOMEM
|
||||
.Er ENOMEM
|
||||
and return
|
||||
.Dv NULL
|
||||
if it runs out of memory.
|
||||
|
@ -76,7 +76,7 @@ if:
|
||||
sets the global variable
|
||||
.Va errno
|
||||
to
|
||||
.Dv EDOM
|
||||
.Er EDOM
|
||||
and a reserved operand fault is generated.
|
||||
.Sh SEE ALSO
|
||||
.Xr asin 3 ,
|
||||
|
@ -117,7 +117,7 @@ the reserved operator is returned,
|
||||
and
|
||||
.Va errno
|
||||
is set to
|
||||
.Er ERANGE
|
||||
.Er ERANGE .
|
||||
For large non-integer negative values,
|
||||
.Fn gamma
|
||||
will underflow.
|
||||
|
@ -90,7 +90,7 @@ causes an error; in this event,
|
||||
the global variable
|
||||
.Va errno
|
||||
is set to
|
||||
.Dv EDOM
|
||||
.Er EDOM
|
||||
and a reserved operand fault is generated.
|
||||
.Sh ERROR (due to Roundoff etc.)
|
||||
The
|
||||
|
@ -127,7 +127,7 @@ Similarly, an attempt to truncate a lower layer file to zero length
|
||||
causes an empty file to be created in the upper layer.
|
||||
Any other operation which would ultimately require modification to
|
||||
the lower layer fails with
|
||||
.Dv EROFS .
|
||||
.Er EROFS .
|
||||
.Pp
|
||||
The union filesystem manipulates the namespace, rather than
|
||||
individual filesystems.
|
||||
@ -183,19 +183,20 @@ accessible via
|
||||
.Xr mount 8 ,
|
||||
.Xr mount_null 8
|
||||
.Sh BUGS
|
||||
|
||||
THIS FILESYSTEM TYPE IS NOT YET FULLY SUPPORTED (READ: IT DOESN'T WORK)
|
||||
AND USING IT MAY, IN FACT, DESTROY DATA ON YOUR SYSTEM. USE AT YOUR
|
||||
OWN RISK. BEWARE OF DOG. SLIPPERY WHEN WET.
|
||||
|
||||
.Pp
|
||||
This code also needs an owner in order to be less dangerous - serious
|
||||
hackers can apply by sending mail to hackers@freebsd.org and announcing
|
||||
hackers can apply by sending mail to
|
||||
.Aq hackers@FreeBSD.org
|
||||
and announcing
|
||||
their intent to take it over.
|
||||
|
||||
.Pp
|
||||
Without whiteout support from the filesystem backing the upper layer,
|
||||
there is no way that delete and rename operations on lower layer
|
||||
objects can be done.
|
||||
.Dv EROFS
|
||||
.Er EROFS
|
||||
is returned for this kind of operations along with any others
|
||||
which would make modifications to the lower layer, such as
|
||||
.Xr chmod 1 .
|
||||
|
@ -127,7 +127,7 @@ Similarly, an attempt to truncate a lower layer file to zero length
|
||||
causes an empty file to be created in the upper layer.
|
||||
Any other operation which would ultimately require modification to
|
||||
the lower layer fails with
|
||||
.Dv EROFS .
|
||||
.Er EROFS .
|
||||
.Pp
|
||||
The union filesystem manipulates the namespace, rather than
|
||||
individual filesystems.
|
||||
@ -183,19 +183,20 @@ accessible via
|
||||
.Xr mount 8 ,
|
||||
.Xr mount_null 8
|
||||
.Sh BUGS
|
||||
|
||||
THIS FILESYSTEM TYPE IS NOT YET FULLY SUPPORTED (READ: IT DOESN'T WORK)
|
||||
AND USING IT MAY, IN FACT, DESTROY DATA ON YOUR SYSTEM. USE AT YOUR
|
||||
OWN RISK. BEWARE OF DOG. SLIPPERY WHEN WET.
|
||||
|
||||
.Pp
|
||||
This code also needs an owner in order to be less dangerous - serious
|
||||
hackers can apply by sending mail to hackers@freebsd.org and announcing
|
||||
hackers can apply by sending mail to
|
||||
.Aq hackers@FreeBSD.org
|
||||
and announcing
|
||||
their intent to take it over.
|
||||
|
||||
.Pp
|
||||
Without whiteout support from the filesystem backing the upper layer,
|
||||
there is no way that delete and rename operations on lower layer
|
||||
objects can be done.
|
||||
.Dv EROFS
|
||||
.Er EROFS
|
||||
is returned for this kind of operations along with any others
|
||||
which would make modifications to the lower layer, such as
|
||||
.Xr chmod 1 .
|
||||
|
Loading…
x
Reference in New Issue
Block a user