1
0
mirror of https://git.FreeBSD.org/src.git synced 2025-01-22 15:47:37 +00:00

mdoc(7) police: Er macro usage cleanup.

This commit is contained in:
Ruslan Ermilov 2000-11-22 16:11:48 +00:00
parent c23155a43a
commit b92a189eb9
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=69052
21 changed files with 71 additions and 63 deletions

View File

@ -197,13 +197,13 @@ Protocol wrong type for socket.
Protocol not available. Protocol not available.
.It Bq Er EPROTONOSUPPORT .It Bq Er EPROTONOSUPPORT
Protocol not supported. Protocol not supported.
.It Bq Er ESOCKNOTSUPORT .It Bq Er ESOCKTNOSUPPORT
Socket type not supported. Socket type not supported.
.It Bq Er EOPNOTSUPP .It Bq Er EOPNOTSUPP
Operation not supported. Operation not supported.
.It Bq Er EPFNOSUPPORT .It Bq Er EPFNOSUPPORT
Protocol family not supported. Protocol family not supported.
.It Bq Er EAFNNOSUPPORT .It Bq Er EAFNOSUPPORT
Address family not supported by protocol family. Address family not supported by protocol family.
.It Bq Er EADDRINUSE .It Bq Er EADDRINUSE
Address already in use. Address already in use.

View File

@ -86,7 +86,7 @@ devices, but cannot be accessed since the corresponding device node is
still missing. In the first case, any attempt to reference the device still missing. In the first case, any attempt to reference the device
through the device node will result in an error, returned by the upper through the device node will result in an error, returned by the upper
layers of the kernel, usually layers of the kernel, usually
.Ql ENXIO . .Er ENXIO .
In the second case, the device node needs to be created before the In the second case, the device node needs to be created before the
driver and its device will be usable. driver and its device will be usable.
.Pp .Pp

View File

@ -115,7 +115,7 @@ If -1 is specified, the kernel will use a default value.
If a value of 0 to 255 is specified, the packet will have the specified If a value of 0 to 255 is specified, the packet will have the specified
value as hoplimit. value as hoplimit.
Other values are considered invalid, and Other values are considered invalid, and
.Dv EINVAL .Er EINVAL
will be returned. will be returned.
For example: For example:
.Bd -literal -offset indent .Bd -literal -offset indent

View File

@ -148,7 +148,7 @@ fails to execute the entry point.
.Pp .Pp
.Xr kldload 8 .Xr kldload 8
returns the cryptic message returns the cryptic message
.Sq ENOEXEC Po Exec format error Pc .Sq Li "ENOEXEC (Exec format error)"
for any error encountered while loading a module. for any error encountered while loading a module.
.Pp .Pp
When system internal interfaces change, old modules often cannot When system internal interfaces change, old modules often cannot

View File

@ -147,7 +147,8 @@ Set resolution value from selector switch.
The driver must be in an The driver must be in an
open though untouched state otherwise the request will fail and open though untouched state otherwise the request will fail and
.Xr errno 2 .Xr errno 2
is set to EBUSY. is set to
.Er EBUSY .
.It GSC_SWIDTH int .It GSC_SWIDTH int
Set the Set the
.Em width .Em width
@ -213,12 +214,14 @@ Since the buffer
size limit is (currently) 0x3000 bytes the maximum number of lines size limit is (currently) 0x3000 bytes the maximum number of lines
allowed will vary with the width of each line. allowed will vary with the width of each line.
This upper limit is This upper limit is
checked before it overwrites the current value and pases an ENOMEM in checked before it overwrites the current value and pases an
the .Er ENOMEM
in the
.Xr errno 2 .Xr errno 2
variable. variable.
However, since the bitmap width can change However, since the bitmap width can change
after a buffer length was selected a read request may fail with ENOMEM after a buffer length was selected a read request may fail with
.Er ENOMEM
if the buffer length turns out too high. if the buffer length turns out too high.
It is generally wise to It is generally wise to
choose long buffers rather than go save in order to obtain better choose long buffers rather than go save in order to obtain better
@ -232,7 +235,8 @@ handy scanner is a human/computer interface timeout values are usually
higher than those of a flat scanner. higher than those of a flat scanner.
Default is 15 seconds. Default is 15 seconds.
After After
timeout is reached the read operation will fail with EBUSY. timeout is reached the read operation will fail with
.Er EBUSY .
Note that Note that
the timeout timer starts anew for each buffer to be read and thus does the timeout timer starts anew for each buffer to be read and thus does
not cause you to scan faster for longer images. not cause you to scan faster for longer images.

View File

@ -80,7 +80,7 @@ gets all of the table of contents
begins audio playing at location specified begins audio playing at location specified
.It CDIOCPLAYBLOCKS .It CDIOCPLAYBLOCKS
fails with error fails with error
.Dv EINVAL .Er EINVAL
.It CDIOCPLAYMSF .It CDIOCPLAYMSF
begins audio playing at location specified begins audio playing at location specified
.It CDIOCRESUME .It CDIOCRESUME

View File

@ -531,11 +531,11 @@ the existing buffer is used.
If METEORSETGEO fails the ioctl() will return a value of -1 and the If METEORSETGEO fails the ioctl() will return a value of -1 and the
external variable errno will be set to: external variable errno will be set to:
.Pp .Pp
.Bl -tag -width EINVAL .Bl -tag -width Er
.It Dv EINVAL .It Bq Er EINVAL
invalid meteor_geomet structure pointer, rows, columns, invalid meteor_geomet structure pointer, rows, columns,
frames were invalid. frames were invalid.
.It Dv ENOMEM .It Bq Er ENOMEM
could not allocate the contiguous block. could not allocate the contiguous block.
.El .El
.in -0.5i .in -0.5i
@ -658,13 +658,13 @@ capture
If METEORCAPTUR fails the ioctl() will return a value of -1 and the If METEORCAPTUR fails the ioctl() will return a value of -1 and the
external variable errno will be set to: external variable errno will be set to:
.Pp .Pp
.Bl -tag -width EINVAL .Bl -tag -width Er
.It Dv EINVAL .It Bq Er EINVAL
invalid capture command value invalid capture command value
.It Dv ENXIO .It Bq Er ENXIO
there is not internal buffer to hold the frame. there is not internal buffer to hold the frame.
this indicates the previous set geometry ioctl failed. this indicates the previous set geometry ioctl failed.
.It Dv EIO .It Bq Er EIO
card is already capturing. card is already capturing.
.El .El
.in -0.5i .in -0.5i
@ -707,13 +707,13 @@ is lower than lowat.
If METEORCAPFRM fails the ioctl() will return a value of -1 and the If METEORCAPFRM fails the ioctl() will return a value of -1 and the
external variable errno will be set to: external variable errno will be set to:
.Pp .Pp
.Bl -tag -width EINVAL .Bl -tag -width Er
.It Dv EINVAL .It Bq Er EINVAL
invalid meteor_geomet structure pointer or bad command. invalid meteor_geomet structure pointer or bad command.
.It Dv ENXIO .It Bq Er ENXIO
there is not internal buffer to hold the frame. there is not internal buffer to hold the frame.
this indicates the previous set geometry ioctl failed. this indicates the previous set geometry ioctl failed.
.It Dv EIO .It Bq Er EIO
card is already capturing. card is already capturing.
.El .El
.in -0.5i .in -0.5i
@ -727,9 +727,8 @@ gain control and effects the UV output amplitude.
If METEORSCHCV or METEORGCHCV fails the ioctl() will return a value If METEORSCHCV or METEORGCHCV fails the ioctl() will return a value
of -1 and the external variable errno will be set to: of -1 and the external variable errno will be set to:
.Pp .Pp
.Bl -tag -width EINVAL .Bl -tag -width Er
.It Dv EINVAL .It Bq Er EINVAL
EINVAL
invalid unsigned char pointer. invalid unsigned char pointer.
.El .El
.in -0.5i .in -0.5i
@ -745,8 +744,8 @@ signed character has legal values are from +127 which represent
If METEORGHUE or METEORSHUE fails the ioctl() will return a value of If METEORGHUE or METEORSHUE fails the ioctl() will return a value of
-1 and the external variable errno will be set to: -1 and the external variable errno will be set to:
.Pp .Pp
.Bl -tag -width EINVAL .Bl -tag -width Er
.It Dv EINVAL .It Bq Er EINVAL
invalid signed char pointer. invalid signed char pointer.
.El .El
.in -0.5i .in -0.5i
@ -773,8 +772,8 @@ number of FIFO errors since device was opened.
.Pp .Pp
If METEORSCOUNT or METEORGCOUNT fails the ioctl() will return a value If METEORSCOUNT or METEORGCOUNT fails the ioctl() will return a value
of -1 and the external variable errno will be set to: of -1 and the external variable errno will be set to:
.Bl -tag -width EINVAL .Bl -tag -width Er
.It Dv EINVAL .It Bq Er EINVAL
invalid meteor_counts structure pointer. invalid meteor_counts structure pointer.
.El .El
.in -0.5i .in -0.5i

View File

@ -154,24 +154,24 @@ should be set to MEMRANGE_SET_UPDATE to update an existing
or establish a new range, or to MEMRANGE_SET_REMOVE to remove a range. or establish a new range, or to MEMRANGE_SET_REMOVE to remove a range.
.Pp .Pp
.Sh RETURN VALUES .Sh RETURN VALUES
.Bl -tag -width 10 .Bl -tag -width Er
.It EOPNOTSUPP .It Bq Er EOPNOTSUPP
Memory range operations are not supported on this architecture. Memory range operations are not supported on this architecture.
.It ENXIO .It Bq Er ENXIO
No memory range descriptors are available (eg. firmware has not enabled No memory range descriptors are available (eg. firmware has not enabled
any). any).
.It EINVAL .It Bq Er EINVAL
The memory range supplied as an argument is invalid or overlaps another The memory range supplied as an argument is invalid or overlaps another
range in a fashion not supported by this architecture. range in a fashion not supported by this architecture.
.It EBUSY .It Bq Er EBUSY
An attempt to remove or update a range failed because the range is busy. An attempt to remove or update a range failed because the range is busy.
.It ENOSPC .It Bq Er ENOSPC
An attempt to create a new range failed due to a shortage of hardware An attempt to create a new range failed due to a shortage of hardware
resources (eg. descriptor slots). resources (eg. descriptor slots).
.It ENOENT .It Bq Er ENOENT
An attempt to remove a range failed because no range matches the descriptor An attempt to remove a range failed because no range matches the descriptor
base/length supplued. base/length supplued.
.It EPERM .It Bq Er EPERM
An attempt to remove a range failed because the range is permanently An attempt to remove a range failed because the range is permanently
enabled. enabled.
.El .El

View File

@ -567,10 +567,10 @@ or a value of 132.
Note that setting the number of columns to 132 is only supported on Note that setting the number of columns to 132 is only supported on
some VGA adaptors. some VGA adaptors.
Any unsupported numbers cause the ioctl to fail with Any unsupported numbers cause the ioctl to fail with
.Em errno .Va errno
.Pq see Xr intro 2 .Pq see Xr intro 2
being set to being set to
.Em EINVAL . .Er EINVAL .
.Pp .Pp
.Em VGA color palette interface .Em VGA color palette interface
.Pp .Pp

View File

@ -141,14 +141,14 @@ by filling in the
.Ar rtm_errno .Ar rtm_errno
field. field.
The routing code returns The routing code returns
.Dv EEXIST .Er EEXIST
if if
requested to duplicate an existing entry, requested to duplicate an existing entry,
.Dv ESRCH .Er ESRCH
if if
requested to delete a non-existent entry, requested to delete a non-existent entry,
or or
.Dv ENOBUFS .Er ENOBUFS
if insufficient resources were available if insufficient resources were available
to install a new route. to install a new route.
In the current implementation, all routing processes run locally, In the current implementation, all routing processes run locally,

View File

@ -174,7 +174,7 @@ process is orphaned, the
.Xr read 2 .Xr read 2
returns -1 with returns -1 with
.Va errno set to .Va errno set to
.Er Dv EIO .Er EIO
and no and no
signal is sent. The default action of the signal is sent. The default action of the
.Dv SIGTTIN .Dv SIGTTIN
@ -205,7 +205,7 @@ the
.Xr write 2 .Xr write 2
returns -1 with returns -1 with
errno set to errno set to
.Er Dv EIO .Er EIO
and no signal is sent. and no signal is sent.
.Pp .Pp
Certain calls that set terminal parameters are treated in the same Certain calls that set terminal parameters are treated in the same

View File

@ -43,8 +43,9 @@
.Sh DESCRIPTION .Sh DESCRIPTION
.Pp .Pp
This device method should probe to see if the device is present. This device method should probe to see if the device is present.
It should return 0 if the device exists, ENXIO if it cannot be It should return 0 if the device exists,
found. .Er ENXIO
if it cannot be found.
If some other error happens during the probe (such as a memory If some other error happens during the probe (such as a memory
allocation failure), an appropriate error code should be returned. allocation failure), an appropriate error code should be returned.
For For

View File

@ -61,7 +61,7 @@ implement the
nfs call. nfs call.
.Pp .Pp
If the filesystem does not support this call, then it should return If the filesystem does not support this call, then it should return
.Dv EOPNOTSUPP . .Er EOPNOTSUPP .
.Sh SEE ALSO .Sh SEE ALSO
.Xr VFS 9 , .Xr VFS 9 ,
.Xr vnode 9 .Xr vnode 9

View File

@ -108,9 +108,9 @@ notfound:
.Bd -filled -offset indent .Bd -filled -offset indent
If creating or renaming and at end of pathname, If creating or renaming and at end of pathname,
return return
.Dv EJUSTRETURN , .Er EJUSTRETURN ,
leaving info on available slots else return leaving info on available slots else return
.Dv ENOENT . .Er ENOENT .
.Ed .Ed
.Pp .Pp
found: found:
@ -126,7 +126,7 @@ The directory,
.Fa dvp .Fa dvp
should be locked on entry. should be locked on entry.
If an error (note: the return value If an error (note: the return value
.Dv EJUSTRETURN .Er EJUSTRETURN
is not considered an error) is not considered an error)
is detected, it will be returned locked. is detected, it will be returned locked.
Otherwise, it will be unlocked unless both Otherwise, it will be unlocked unless both
@ -153,7 +153,7 @@ or
the flag the flag
.Dv ISLASTCN .Dv ISLASTCN
is specified and the operation would succeed, the special return value is specified and the operation would succeed, the special return value
.Dv EJUSTRETURN .Er EJUSTRETURN
is returned. is returned.
Otherwise, an appropriate error code is returned. Otherwise, an appropriate error code is returned.
.Sh PSEUDOCODE .Sh PSEUDOCODE

View File

@ -79,7 +79,7 @@ If
is recognized, is recognized,
.Fa *retval .Fa *retval
is set to the specified value and zero is returned, otherwise is set to the specified value and zero is returned, otherwise
.Dv EINVAL .Er EINVAL
is returned. is returned.
.Sh SEE ALSO .Sh SEE ALSO
.Xr pathconf 2 , .Xr pathconf 2 ,

View File

@ -49,7 +49,7 @@ for busses
.Sh DESCRIPTION .Sh DESCRIPTION
.Pp .Pp
These functions simply return These functions simply return
.Dv ENOENT . .Er ENOENT .
.Sh SEE ALSO .Sh SEE ALSO
.Xr device 9 , .Xr device 9 ,
.Xr driver 9 .Xr driver 9

View File

@ -116,7 +116,9 @@ NUL, is returned in
.Sh RETURN VALUES .Sh RETURN VALUES
The The
.Nm .Nm
functions return 0 on success or EFAULT if a bad address is encountered. functions return 0 on success or
.Er EFAULT
if a bad address is encountered.
In addition, the In addition, the
.Fn copystr , .Fn copystr ,
and and
@ -124,7 +126,9 @@ and
.\" .Fn copyinstr , .\" .Fn copyinstr ,
.\" and .\" and
.\" .Fn copyoutstr .\" .Fn copyoutstr
functions return ENAMETOOLONG if the string is longer than functions return
.Er ENAMETOOLONG
if the string is longer than
.Pa len .Pa len
bytes. bytes.
.Sh SEE ALSO .Sh SEE ALSO

View File

@ -100,16 +100,16 @@ includes the
.Dv PCATCH .Dv PCATCH
flag, signals are checked before and after sleeping, else signals are flag, signals are checked before and after sleeping, else signals are
not checked. Returns 0 if awakened, not checked. Returns 0 if awakened,
.Dv EWOULDBLOCK .Er EWOULDBLOCK
if the timeout expires. If if the timeout expires. If
.Dv PCATCH .Dv PCATCH
is set and a signal needs to be delivered, is set and a signal needs to be delivered,
.Dv ERESTART .Er ERESTART
is returned if the current system call should be restarted if is returned if the current system call should be restarted if
possible, and possible, and
.Dv EINTR .Er EINTR
is returned if the system call should be interrupted by the signal is returned if the system call should be interrupted by the signal
.Pq return Dv EINTR . .Pq return Er EINTR .
.Pp .Pp
.Nm Msleep .Nm Msleep
is a variation on tsleep. The parameter is a variation on tsleep. The parameter

View File

@ -98,7 +98,7 @@ The
and and
.Nm suser_xxx .Nm suser_xxx
functions return 0 if the user has superuser powers and functions return 0 if the user has superuser powers and
.Dv EPERM .Er EPERM
otherwise. otherwise.
This is the This is the
.Em reverse logic .Em reverse logic

View File

@ -116,7 +116,7 @@ value or at the end of the list if no tasks have a lower priority.
Enqueueing a task does not perform any memory allocation which makes Enqueueing a task does not perform any memory allocation which makes
it suitable for calling from an interrupt handler. it suitable for calling from an interrupt handler.
This function will return This function will return
.Dv EPIPE .Er EPIPE
if the queue is being freed. if the queue is being freed.
.Pp .Pp
To execute all the tasks on a queue, To execute all the tasks on a queue,

View File

@ -61,9 +61,9 @@ the host is considered to be down for a short period (normally 20 seconds),
allowing an error to be returned to transmission attempts during this allowing an error to be returned to transmission attempts during this
interval. interval.
The error is The error is
.Li EHOSTDOWN .Er EHOSTDOWN
for a non-responding destination host, and for a non-responding destination host, and
.Li EHOSTUNREACH .Er EHOSTUNREACH
for a non-responding router. for a non-responding router.
.Pp .Pp
The ARP cache is stored in the system routing table as The ARP cache is stored in the system routing table as