Fix a few mandoc issues

- skipping paragraph macro: Pp after Sh
- sections out of conventional order: Sh EXAMPLES
- whitespace at end of input line
- normalizing date format
This commit is contained in:
Gordon Bergling 2020-10-09 19:12:44 +00:00
parent eb88fed446
commit 3d265fce43
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=366583
48 changed files with 160 additions and 151 deletions

View file

@ -239,7 +239,7 @@ The functions
.Fn cap_rights_is_set , .Fn cap_rights_is_set ,
.Fn cap_rights_is_valid , .Fn cap_rights_is_valid ,
.Fn cap_rights_merge , .Fn cap_rights_merge ,
.Fn cap_rights_remove .Fn cap_rights_remove
and and
.Fn cap_rights_contains .Fn cap_rights_contains
first appeared in first appeared in

View file

@ -149,7 +149,7 @@ was either preposterously large or smaller than the kernel set size.
The calling process did not have the credentials required to complete the The calling process did not have the credentials required to complete the
operation. operation.
.It Bq Er ECAPMODE .It Bq Er ECAPMODE
The calling process attempted to act on a process other than itself, while The calling process attempted to act on a process other than itself, while
in capability mode. in capability mode.
See See
.Xr capsicum 4 . .Xr capsicum 4 .

View file

@ -119,7 +119,8 @@ Memory is allocated on a round-robin basis by cycling through each domain in
.Fa mask . .Fa mask .
.It Dv DOMAINSET_POLICY_FIRSTTOUCH .It Dv DOMAINSET_POLICY_FIRSTTOUCH
Memory is allocated on the domain local to the CPU the requesting thread is Memory is allocated on the domain local to the CPU the requesting thread is
running on. Failure to allocate from this domain will fallback to round-robin. running on.
Failure to allocate from this domain will fallback to round-robin.
.It Dv DOMAINSET_POLICY_PREFER .It Dv DOMAINSET_POLICY_PREFER
Memory is allocated preferentially from the single domain specified in the mask. Memory is allocated preferentially from the single domain specified in the mask.
If memory is unavailable the domains listed in the parent cpuset will be If memory is unavailable the domains listed in the parent cpuset will be
@ -167,7 +168,7 @@ was either preposterously large or smaller than the kernel set size.
The calling process did not have the credentials required to complete the The calling process did not have the credentials required to complete the
operation. operation.
.It Bq Er ECAPMODE .It Bq Er ECAPMODE
The calling process attempted to act on a process other than itself, while The calling process attempted to act on a process other than itself, while
in capability mode. in capability mode.
See See
.Xr capsicum 4 . .Xr capsicum 4 .

View file

@ -178,7 +178,7 @@ The link count of the file pointed at by
.Fa fhp .Fa fhp
would exceed 32767. would exceed 32767.
.It Bq Er EACCES .It Bq Er EACCES
A component of A component of
.Fa to .Fa to
prefix denies search permission. prefix denies search permission.
.It Bq Er EACCES .It Bq Er EACCES

View file

@ -28,7 +28,7 @@
.\" @(#)getitimer.2 8.3 (Berkeley) 5/16/95 .\" @(#)getitimer.2 8.3 (Berkeley) 5/16/95
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd May 1, 2020 .Dd May 1, 2020
.Dt GETITIMER 2 .Dt GETITIMER 2
.Os .Os
.Sh NAME .Sh NAME

View file

@ -28,7 +28,7 @@
.\" @(#)getsockopt.2 8.4 (Berkeley) 5/2/95 .\" @(#)getsockopt.2 8.4 (Berkeley) 5/2/95
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd June 03, 2020 .Dd June 3, 2020
.Dt GETSOCKOPT 2 .Dt GETSOCKOPT 2
.Os .Os
.Sh NAME .Sh NAME
@ -219,7 +219,8 @@ if they all set
before binding the port. before binding the port.
Incoming TCP and UDP connections are distributed among the sharing Incoming TCP and UDP connections are distributed among the sharing
processes based on a hash function of local port number, foreign IP processes based on a hash function of local port number, foreign IP
address and port number. A maximum of 256 processes can share one socket. address and port number.
A maximum of 256 processes can share one socket.
.Pp .Pp
.Dv SO_KEEPALIVE .Dv SO_KEEPALIVE
enables the enables the

View file

@ -52,8 +52,9 @@
.Fa "gss_cred_id_t *delegated_cred_handle" .Fa "gss_cred_id_t *delegated_cred_handle"
.Fc .Fc
.Sh DESCRIPTION .Sh DESCRIPTION
Allows a remotely initiated security context between the application Allows a remotely initiated security context between the application and a remote
and a remote peer to be established. The routine may return a peer to be established.
The routine may return a
.Fa output_token .Fa output_token
which should be transferred to the peer application, which should be transferred to the peer application,
where the peer application will present it to where the peer application will present it to
@ -78,7 +79,8 @@ parameters.
.Pp .Pp
Portable applications should be constructed to use the token length Portable applications should be constructed to use the token length
and return status to determine whether a token needs to be sent or and return status to determine whether a token needs to be sent or
waited for. Thus a typical portable caller should always invoke waited for.
Thus a typical portable caller should always invoke
.Fn gss_accept_sec_context .Fn gss_accept_sec_context
within a loop: within a loop:
.Bd -literal .Bd -literal
@ -166,10 +168,9 @@ returned to a caller
(i.e. when accompanied by a (i.e. when accompanied by a
.Dv GSS_S_COMPLETE .Dv GSS_S_COMPLETE
status code), applications status code), applications
should not rely on this behavior as the flag was not defined in should not rely on this behavior as the flag was not defined in Version 1 of the GSS-API.
Version 1 of the GSS-API. Instead, applications should be prepared to Instead, applications should be prepared to use per-message services after a
use per-message services after a successful context establishment, successful context establishment, according to the
according to the
.Dv GSS_C_INTEG_FLAG .Dv GSS_C_INTEG_FLAG
and and
.Dv GSS_C_CONF_FLAG values. .Dv GSS_C_CONF_FLAG values.
@ -190,9 +191,10 @@ fails, the
implementation should not create a context object, and should leave implementation should not create a context object, and should leave
the value of the context_handle parameter set to the value of the context_handle parameter set to
.Dv GSS_C_NO_CONTEXT to .Dv GSS_C_NO_CONTEXT to
indicate this. In the event of a failure on a subsequent call, the indicate this.
implementation is permitted to delete the "half-built" security In the event of a failure on a subsequent call, the implementation is
context (in which case it should set the permitted to delete the "half-built" security context (in which case it
should set the
.Fa context_handle .Fa context_handle
parameter to parameter to
.Dv GSS_C_NO_CONTEXT ), but the preferred behavior is to leave the .Dv GSS_C_NO_CONTEXT ), but the preferred behavior is to leave the

View file

@ -157,7 +157,7 @@ The
.Fn MDXFile .Fn MDXFile
and and
.Fn MDXFileChunk .Fn MDXFileChunk
may return NULL when underlying may return NULL when underlying
.Xr open 2 , .Xr open 2 ,
.Xr fstat 2 , .Xr fstat 2 ,
.Xr lseek 2 , .Xr lseek 2 ,

View file

@ -137,7 +137,7 @@ The
.Fn RIPEMD160_File .Fn RIPEMD160_File
and and
.Fn RIPEMD160_FileChunk .Fn RIPEMD160_FileChunk
may return NULL when underlying may return NULL when underlying
.Xr open 2 , .Xr open 2 ,
.Xr fstat 2 , .Xr fstat 2 ,
.Xr lseek 2 , .Xr lseek 2 ,

View file

@ -168,7 +168,7 @@ The
.Fn SHA1_File .Fn SHA1_File
and and
.Fn SHA1_FileChunk .Fn SHA1_FileChunk
may return NULL when underlying may return NULL when underlying
.Xr open 2 , .Xr open 2 ,
.Xr fstat 2 , .Xr fstat 2 ,
.Xr lseek 2 , .Xr lseek 2 ,

View file

@ -159,7 +159,7 @@ The
.Fn SHA256_File .Fn SHA256_File
and and
.Fn SHA256_FileChunk .Fn SHA256_FileChunk
may return NULL when underlying may return NULL when underlying
.Xr open 2 , .Xr open 2 ,
.Xr fstat 2 , .Xr fstat 2 ,
.Xr lseek 2 , .Xr lseek 2 ,

View file

@ -203,7 +203,7 @@ The
.Fn SHA512_File .Fn SHA512_File
and and
.Fn SHA512_FileChunk .Fn SHA512_FileChunk
may return NULL when underlying may return NULL when underlying
.Xr open 2 , .Xr open 2 ,
.Xr fstat 2 , .Xr fstat 2 ,
.Xr lseek 2 , .Xr lseek 2 ,

View file

@ -201,7 +201,7 @@ The
.Fn SKEIN256_File .Fn SKEIN256_File
and and
.Fn SKEIN256_FileChunk .Fn SKEIN256_FileChunk
may return NULL when underlying may return NULL when underlying
.Xr open 2 , .Xr open 2 ,
.Xr fstat 2 , .Xr fstat 2 ,
.Xr lseek 2 , .Xr lseek 2 ,
@ -220,15 +220,15 @@ These functions appeared in
.Fx 11.0 . .Fx 11.0 .
.Sh AUTHORS .Sh AUTHORS
.An -nosplit .An -nosplit
The core hash routines were imported from version 1.3 of the optimized The core hash routines were imported from version 1.3 of the optimized
Skein reference implementation written by Skein reference implementation written by
.An Doug Whiting .An Doug Whiting
as submitted to the NSA SHA-3 contest. as submitted to the NSA SHA-3 contest.
The algorithms were developed by The algorithms were developed by
.An Niels Ferguson , .An Niels Ferguson ,
.An Stefan Lucks , .An Stefan Lucks ,
.An Bruce Schneier , .An Bruce Schneier ,
.An Doug Whiting , .An Doug Whiting ,
.An Mihir Bellare , .An Mihir Bellare ,
.An Tadayoshi Kohno , .An Tadayoshi Kohno ,
.An Jon Callas, .An Jon Callas,

View file

@ -1,7 +1,7 @@
.\" .\"
.\" Copyright (c) 2013, 2015 Spectra Logic Corporation .\" Copyright (c) 2013, 2015 Spectra Logic Corporation
.\" All rights reserved. .\" All rights reserved.
.\" .\"
.\" Redistribution and use in source and binary forms, with or without .\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions .\" modification, are permitted provided that the following conditions
.\" are met: .\" are met:
@ -13,7 +13,7 @@
.\" ("Disclaimer") and any redistribution must be conditioned upon .\" ("Disclaimer") and any redistribution must be conditioned upon
.\" including a substantially similar Disclaimer requirement for further .\" including a substantially similar Disclaimer requirement for further
.\" binary redistribution. .\" binary redistribution.
.\" .\"
.\" NO WARRANTY .\" NO WARRANTY
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
@ -26,9 +26,9 @@
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGES. .\" POSSIBILITY OF SUCH DAMAGES.
.\" .\"
.\" Authors: Ken Merry (Spectra Logic Corporation) .\" Authors: Ken Merry (Spectra Logic Corporation)
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd February 13, 2015 .Dd February 13, 2015
@ -177,7 +177,7 @@ driver returns some status data as XML-formatted strings, and
the primary purpose of this library is to make it easier for the the primary purpose of this library is to make it easier for the
software developer to parse those strings and extract the status values. software developer to parse those strings and extract the status values.
.Pp .Pp
The The
.Fn mt_start_element , .Fn mt_start_element ,
.Fn mt_end_element , .Fn mt_end_element ,
and and
@ -310,7 +310,7 @@ except that it prints the results to standard output instead of an sbuf.
.Pp .Pp
.Fn mt_param_entry_sbuf .Fn mt_param_entry_sbuf
prints the prints the
.Ar entry .Ar entry
to the given sbuf to the given sbuf
.Ar sb . .Ar sb .
The argument The argument
@ -361,7 +361,7 @@ See below for notes on the return values.
Returns the bits per inch or bits per mm values for a given density entry Returns the bits per inch or bits per mm values for a given density entry
specified by the specified by the
.Ar density_num . .Ar density_num .
If the If the
.Ar bpi .Ar bpi
argument is non-zero, the bits per inch value is returned. argument is non-zero, the bits per inch value is returned.
Otherwise, the bits per mm value is returned. Otherwise, the bits per mm value is returned.
@ -375,8 +375,8 @@ to the supplied density name.
gets the current XML status / parameter string from the sa(4) driver gets the current XML status / parameter string from the sa(4) driver
instance referenced by the open file descriptor instance referenced by the open file descriptor
.Ar mtfd . .Ar mtfd .
The The
.Xr mtio 4 .Xr mtio 4
.Xr ioctl 2 .Xr ioctl 2
to be used is supplied as the to be used is supplied as the
.Ar cmd .Ar cmd
@ -425,7 +425,7 @@ If the density is not known,
will return "UNKNOWN". will return "UNKNOWN".
.Pp .Pp
.Fn mt_density_bp .Fn mt_density_bp
returns the bits per inch value for the given density (if the returns the bits per inch value for the given density (if the
.Ar bpi .Ar bpi
field is non-zero), the bits per mm value otherwise, or 0 if the supplied field is non-zero), the bits per mm value otherwise, or 0 if the supplied
.Ar density_num .Ar density_num

View file

@ -119,8 +119,8 @@ yields:
path == "../../../sys/kern" /* It's correct but ... */ path == "../../../sys/kern" /* It's correct but ... */
That is correct, but a little redundant. If you wish get the simple That is correct, but a little redundant.
answer 'kern', do the following. If you wish get the simple answer 'kern', do the following.
path = abs2rel(realpath("/sys/kern", r1), realpath("/sys", r2), path = abs2rel(realpath("/sys/kern", r1), realpath("/sys", r2),
result, MAXPATHLEN); result, MAXPATHLEN);

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org> .\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org>
.\" All rights reserved. .\" All rights reserved.
.\" .\"
.\" Redistribution and use in source and binary forms, with or without .\" Redistribution and use in source and binary forms, with or without

View file

@ -1,4 +1,4 @@
.\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org> .\" Copyright (c) 2012 Davide Italiano <davide@FreeBSD.org>
.\" All rights reserved. .\" All rights reserved.
.\" .\"
.\" Redistribution and use in source and binary forms, with or without .\" Redistribution and use in source and binary forms, with or without

View file

@ -485,7 +485,8 @@ To free the resources used by the RADIUS library, call
.Fn rad_close . .Fn rad_close .
.Ss Server operation .Ss Server operation
Server mode operates much alike to client mode, except packet send and receive Server mode operates much alike to client mode, except packet send and receive
steps are swapped. To operate as server you should obtain server context with steps are swapped.
To operate as server you should obtain server context with
.Fn rad_server_open .Fn rad_server_open
function, passing opened and bound UDP socket file descriptor as argument. function, passing opened and bound UDP socket file descriptor as argument.
You should define allowed clients and their secrets using You should define allowed clients and their secrets using
@ -493,9 +494,9 @@ You should define allowed clients and their secrets using
function. port, timeout and max_tries arguments are ignored in server mode. function. port, timeout and max_tries arguments are ignored in server mode.
You should call You should call
.Fn rad_receive_request .Fn rad_receive_request
function to receive request from client. If you do not want to block on socket function to receive request from client.
read, you are free to use any poll(), select() or non-blocking sockets for If you do not want to block on socket read, you are free to use any
the socket. poll(), select() or non-blocking sockets for the socket.
Received request can be parsed with same parsing functions as for client. Received request can be parsed with same parsing functions as for client.
To respond to the request you should call To respond to the request you should call
.Fn rad_create_response .Fn rad_create_response

View file

@ -74,7 +74,8 @@ GSS-API delegated credentials (if any)
.It gss_context .It gss_context
The GSS-API context The GSS-API context
.It lock .It lock
A structure used to enforce a particular QOP and service. Set A structure used to enforce a particular QOP and service.
Set
.Fa lock->locked .Fa lock->locked
to to
.Dv TRUE .Dv TRUE

View file

@ -194,17 +194,17 @@ and
.Xr fcntl 2 .Xr fcntl 2
commands. commands.
.It Fn sysdecode_sctp_nxt_flags .It Fn sysdecode_sctp_nxt_flags
The The
.Fa nxt_flags .Fa nxt_flags
member of a member of a
.Vt struct sctp_nxtinfo . .Vt struct sctp_nxtinfo .
.It Fn sysdecode_sctp_rcv_flags .It Fn sysdecode_sctp_rcv_flags
The The
.Fa rcv_flags .Fa rcv_flags
member of a member of a
.Vt struct sctp_rcvinfo . .Vt struct sctp_rcvinfo .
.It Fn sysdecode_sctp_snd_flags .It Fn sysdecode_sctp_snd_flags
The The
.Fa snd_flags .Fa snd_flags
member of a member of a
.Vt struct sctp_sndinfo . .Vt struct sctp_sndinfo .

View file

@ -314,15 +314,16 @@ This function returns NULL in case of failure.
. .
.Fn libusb20_tr_get_time_complete .Fn libusb20_tr_get_time_complete
will return the completion time of an USB transfer in will return the completion time of an USB transfer in
millisecond units. This function is most useful for isochronous USB millisecond units.
transfers when doing echo cancelling. This function is most useful for isochronous USB transfers when doing echo
cancelling.
. .
.Pp .Pp
. .
.Fn libusb20_tr_get_actual_frames .Fn libusb20_tr_get_actual_frames
will return the actual number of USB frames after an USB will return the actual number of USB frames after an USB
transfer completed. A value of zero means that no data was transferred. transfer completed.
. A value of zero means that no data was transferred.
.Pp .Pp
. .
.Fn libusb20_tr_get_actual_length .Fn libusb20_tr_get_actual_length
@ -691,9 +692,11 @@ Before this call will succeed the USB device must be opened.
.Fa setup .Fa setup
is a pointer to a decoded and host endian SETUP packet. is a pointer to a decoded and host endian SETUP packet.
.Fa data .Fa data
is a pointer to a data transfer buffer associated with the control transaction. This argument can be NULL. is a pointer to a data transfer buffer associated with the control transaction.
This argument can be NULL.
.Fa pactlen .Fa pactlen
is a pointer to a variable that will hold the actual transfer length after the control transaction is complete. is a pointer to a variable that will hold the actual transfer length after the
control transaction is complete.
.Fa timeout .Fa timeout
is the transaction timeout given in milliseconds. is the transaction timeout given in milliseconds.
A timeout of zero means no timeout. A timeout of zero means no timeout.
@ -792,10 +795,11 @@ The USB device need not be opened when calling this function.
.Pp .Pp
. .
.Fn libusb20_dev_alloc_config .Fn libusb20_dev_alloc_config
will read out and decode the USB config descriptor for will read out and decode the USB config descriptor for the given USB device
the given USB device and config index. This function returns a pointer and config index.
to the decoded configuration which must eventually be passed to This function returns a pointer to the decoded configuration which must eventually
free(). NULL is returned in case of failure. be passed to free().
NULL is returned in case of failure.
. .
.Pp .Pp
. .
@ -902,8 +906,8 @@ will set the global USB device side mode template to
The new template is not activated until after the next USB The new template is not activated until after the next USB
enumeration. enumeration.
The template number decides how the USB device will present itself to The template number decides how the USB device will present itself to
the USB Host, like Mass Storage Device, USB Ethernet Device. Also see the USB Host, like Mass Storage Device, USB Ethernet Device.
the Also see the
.Xr usb2_template 4 .Xr usb2_template 4
module. module.
This function returns zero on success else a LIBUSB20_ERROR value is This function returns zero on success else a LIBUSB20_ERROR value is
@ -966,10 +970,9 @@ returned.
.Fn libusb20_be_alloc_default .Fn libusb20_be_alloc_default
.Fn libusb20_be_alloc_freebsd .Fn libusb20_be_alloc_freebsd
.Fn libusb20_be_alloc_linux .Fn libusb20_be_alloc_linux
These functions are used to allocate a specific USB backend or the These functions are used to allocate a specific USB backend or the operating system
operating system default USB backend. Allocating a backend is a way to default USB backend.
scan for currently present USB devices. Allocating a backend is a way to scan for currently present USB devices.
.
.Pp .Pp
. .
.Fn libusb20_be_device_foreach .Fn libusb20_be_device_foreach

View file

@ -19,7 +19,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd May 10, 2020 .Dd May 10, 2020
.Dt LOGIN_OK 3 .Dt LOGIN_OK 3
.Os .Os
.Sh NAME .Sh NAME

View file

@ -50,33 +50,33 @@ and
functions compute the sine and cosine of functions compute the sine and cosine of
.Fa x . .Fa x .
Using these functions allows argument reduction to occur only Using these functions allows argument reduction to occur only
once instead of twice with individual invocations of once instead of twice with individual invocations of
.Fn sin .Fn sin
and and
.Fn cos . .Fn cos .
Like Like
.Fn sin .Fn sin
and and
.Fn cos , .Fn cos ,
a large magnitude argument may yield a result with little a large magnitude argument may yield a result with little
or no significance. or no significance.
.Sh RETURN VALUES .Sh RETURN VALUES
Upon returning from Upon returning from
.Fn sincos , .Fn sincos ,
.Fn sincosf , .Fn sincosf ,
and and
.Fn sincosl , .Fn sincosl ,
the memory pointed to by the memory pointed to by
.Ar "*s" .Ar "*s"
and and
.Ar "*c" .Ar "*c"
are assigned the values of sine and cosine, respectively. are assigned the values of sine and cosine, respectively.
.Sh SEE ALSO .Sh SEE ALSO
.Xr cos 3 , .Xr cos 3 ,
.Xr sin 3 , .Xr sin 3 ,
.Sh HISTORY .Sh HISTORY
These functions were added to These functions were added to
.Fx 9.0 .Fx 9.0
to aid in writing various complex function contained in to aid in writing various complex function contained in
.St -isoC-99 . .St -isoC-99 .

View file

@ -33,10 +33,9 @@
.Sh SYNOPSIS .Sh SYNOPSIS
.Cd "device fdt_pinctrl" .Cd "device fdt_pinctrl"
.Sh DESCRIPTION .Sh DESCRIPTION
.Pp
Pin multiplexing is a technology used to re-purpose a single Pin multiplexing is a technology used to re-purpose a single
physical connection (depending on chip packaging it may be physical connection (depending on chip packaging it may be
pin, ball, or pad) by routing its signal to any one of several pin, ball, or pad) by routing its signal to any one of several
different SoC internal devices. different SoC internal devices.
For example, based on the actual device design, a single SoC chip For example, based on the actual device design, a single SoC chip
pin might perform any of these roles: SPI clock, I2C pin might perform any of these roles: SPI clock, I2C

View file

@ -71,7 +71,7 @@ device with the same unit number.
.An -nosplit .An -nosplit
The The
.Nm .Nm
driver was written for driver was written for
.Dx .Dx
by by
.An Matthew Dillon .An Matthew Dillon

View file

@ -9,7 +9,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright .\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the .\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution. .\" documentation and/or other materials provided with the distribution.
.\" .\"
.\" THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

View file

@ -10,7 +10,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright .\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the .\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution. .\" documentation and/or other materials provided with the distribution.
.\" .\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

View file

@ -34,7 +34,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd Mar 13, 2019 .Dd March 13, 2019
.Dt MRSAS 4 .Dt MRSAS 4
.Os .Os
.Sh NAME .Sh NAME

View file

@ -110,9 +110,9 @@ using the
.Qq Li [AC-Name\\][Host-Uniq|]Service-Name .Qq Li [AC-Name\\][Host-Uniq|]Service-Name
syntax. syntax.
To set a binary Host-Uniq, it must be encoded as a hexadecimal lowercase To set a binary Host-Uniq, it must be encoded as a hexadecimal lowercase
string and prefixed with string and prefixed with
.Qq Li 0x , .Qq Li 0x ,
for example for example
.Qq Li 0x6d792d746167 .Qq Li 0x6d792d746167
is equivalent to is equivalent to
.Qq Li my-tag . .Qq Li my-tag .

View file

@ -53,7 +53,7 @@ TCP and UDP checksum offload for both IPv4 and IPv6,
Large Segment Offload for both IPv4 and IPv6, Large Segment Offload for both IPv4 and IPv6,
Jumbo frames, VLAN Tag, and Jumbo frames, VLAN Tag, and
Receive Side scaling, ability to select either HW or Software LRO, Receive Side scaling, ability to select either HW or Software LRO,
when LRO is enabled (default HW LRO). when LRO is enabled (default HW LRO).
For further hardware information, see For further hardware information, see
.Pa http://www.qlogic.com/ . .Pa http://www.qlogic.com/ .
.Sh HARDWARE .Sh HARDWARE

View file

@ -150,9 +150,9 @@ prompt before booting the kernel or stored in
.It Va dev.rtwn.%d.hwcrypto .It Va dev.rtwn.%d.hwcrypto
This tunable controls how key slots are assigned: This tunable controls how key slots are assigned:
.br .br
0 - disable h/w crypto support. Features that require access 0 - disable h/w crypto support.
to frame contents (e.g., TCP/UDP/IP Rx checksum validation) Features that require access to frame contents (e.g., TCP/UDP/IP Rx
will not work; checksum validation) will not work;
.br .br
1 - use h/w crypto support for pairwise keys only; 1 - use h/w crypto support for pairwise keys only;
.br .br

View file

@ -251,7 +251,7 @@ The user can query parameters using
(which uses the (which uses the
.Dv MTIOCPARAMGET .Dv MTIOCPARAMGET
ioctl) and the user can set parameters using ioctl) and the user can set parameters using
.Dq mt param -s .Dq mt param -s
(which uses the (which uses the
.Dv MTIOCPARAMSET .Dv MTIOCPARAMSET
ioctl). ioctl).
@ -281,13 +281,13 @@ driver reports entering Programmable Early Warning, Early Warning and End
of Media conditions by returning a write with 0 bytes written, and of Media conditions by returning a write with 0 bytes written, and
.Dv errno .Dv errno
set to 0. set to 0.
If If
.Va eot_warn .Va eot_warn
is set to 1, the is set to 1, the
.Nm .Nm
driver will set driver will set
.Dv errno .Dv errno
to to
.Dv ENOSPC .Dv ENOSPC
when it enters any of the out of space conditions. when it enters any of the out of space conditions.
.It protection.protection_supported .It protection.protection_supported
@ -353,10 +353,10 @@ In addition, when EOM is injected, the tape position status will be updated
to temporarily show Beyond of the Programmable Early Warning (BPEW) status. to temporarily show Beyond of the Programmable Early Warning (BPEW) status.
To see BPEW status, use the To see BPEW status, use the
.Dv MTIOCEXTGET .Dv MTIOCEXTGET
ioctl, which is used by the ioctl, which is used by the
.Dq mt status .Dq mt status
command. command.
To inject an EOM notification, set the To inject an EOM notification, set the
.Pp .Pp
.Va kern.cam.sa.%d.inject_eom .Va kern.cam.sa.%d.inject_eom
.Pp .Pp

View file

@ -71,7 +71,7 @@ driver include:
.It .It
HPE Gen10 Smart Array Controller Family HPE Gen10 Smart Array Controller Family
.It .It
OEM Controllers based on the Microsemi Chipset OEM Controllers based on the Microsemi Chipset
.El .El
.Sh FILES .Sh FILES
.Bl -tag -width /boot/kernel/aac.ko -compact .Bl -tag -width /boot/kernel/aac.ko -compact

View file

@ -58,7 +58,7 @@ line on the bus, and all I/O performed through that instance is done
with that chip-select line asserted. with that chip-select line asserted.
.Pp .Pp
SPI data transfers are inherently bi-directional; there are not separate SPI data transfers are inherently bi-directional; there are not separate
read and write operations. read and write operations.
When commands and data are sent to a device, data also comes back from When commands and data are sent to a device, data also comes back from
the device, although in some cases the data may not be useful (or even the device, although in some cases the data may not be useful (or even
documented or predictable for some devices). documented or predictable for some devices).
@ -129,7 +129,7 @@ The setting remains in effect for subsequent transfers; it
is not necessary to reset this before each transfer. is not necessary to reset this before each transfer.
.El .El
.Sh HINTS CONFIGURATION .Sh HINTS CONFIGURATION
On a On a
.Xr device.hints 5 .Xr device.hints 5
based system, such as based system, such as
.Li MIPS , .Li MIPS ,

View file

@ -422,7 +422,7 @@ These options remove the
.Qq dumb , .Qq dumb ,
.Qq sc , .Qq sc ,
and and
.Qq scteken .Qq scteken
terminal emulators, respectively. terminal emulators, respectively.
.El .El
.Ss Driver Flags .Ss Driver Flags

View file

@ -118,7 +118,7 @@ has been expressly designed to follow its specification.
.Xr ngctl 8 .Xr ngctl 8
.\" .\"
.Rs .Rs
.%B Universal Serial Bus: Communications Class Subclass Specification for Ethernet Emulation Model Devices .%B Universal Serial Bus: Communications Class Subclass Specification for Ethernet Emulation Model Devices
.%N Revision 1.0 .%N Revision 1.0
.%D February 2, 2005 .%D February 2, 2005
.%I USB Implementers Forum, Inc. .%I USB Implementers Forum, Inc.
@ -136,8 +136,8 @@ makes them unsuitable as a "drop-in" replacement for an Ethernet LAN;
for a USB 3.0 SuperSpeed cable, latency is comparable to 100BaseTX Ethernet for a USB 3.0 SuperSpeed cable, latency is comparable to 100BaseTX Ethernet
(but often worse), with throughput comparable to 2.5GBASE-T. (but often worse), with throughput comparable to 2.5GBASE-T.
.Pp .Pp
However, their energy efficiency makes them attractive for embedded However, their energy efficiency makes them attractive for embedded applications.
applications. A Plugable PL27A1 cable claims 24mA of USB3 bus power, A Plugable PL27A1 cable claims 24mA of USB3 bus power,
as compared to 150mA for a typical USB 3.0 to Gigabit Ethernet interface. as compared to 150mA for a typical USB 3.0 to Gigabit Ethernet interface.
.Sh HISTORY .Sh HISTORY
The The
@ -160,6 +160,6 @@ and
.An Nick Hibma Aq Mt n_hibma@FreeBSD.org . .An Nick Hibma Aq Mt n_hibma@FreeBSD.org .
.Pp .Pp
This manual page was written by This manual page was written by
.An Nick Hibma Aq Mt n_hibma@FreeBSD.org .An Nick Hibma Aq Mt n_hibma@FreeBSD.org
and updated by and updated by
.An Bruce Simpson Aq Mt bms@FreeBSD.org . .An Bruce Simpson Aq Mt bms@FreeBSD.org .

View file

@ -37,23 +37,10 @@
.Ft phandle_t .Ft phandle_t
.Fn OF_finddevice "const char *path" .Fn OF_finddevice "const char *path"
.Sh DESCRIPTION .Sh DESCRIPTION
.Pp
.Fn OF_finddevice .Fn OF_finddevice
returns the phandle for the node specified by the returns the phandle for the node specified by the
.Fa path . .Fa path .
Returns -1 if the path cannot be found in the tree. Returns -1 if the path cannot be found in the tree.
.Sh CAVEATS
The return value should only be checked with equality
operators (equal to, not equal to) and not relational comparison
(less than, greater than ).
There is a discrepancy between IEEE 1275 standard and
.Fx Ns 's
internal representation of a phandle: IEEE 1275
requires the return value of this function to be -1 if the path
is not found.
But phandle_t is an unsigned type, so it cannot
be relationally compared with -1 or 0, this comparison
is always true or always false.
.Sh EXAMPLES .Sh EXAMPLES
.Bd -literal .Bd -literal
phandle_t root, i2c; phandle_t root, i2c;
@ -72,3 +59,15 @@ is always true or always false.
.An -nosplit .An -nosplit
This manual page was written by This manual page was written by
.An Oleksandr Tymoshenko Aq Mt gonzo@FreeBSD.org . .An Oleksandr Tymoshenko Aq Mt gonzo@FreeBSD.org .
.Sh CAVEATS
The return value should only be checked with equality
operators (equal to, not equal to) and not relational comparison
(less than, greater than ).
There is a discrepancy between IEEE 1275 standard and
.Fx Ns 's
internal representation of a phandle: IEEE 1275
requires the return value of this function to be -1 if the path
is not found.
But phandle_t is an unsigned type, so it cannot
be relationally compared with -1 or 0, this comparison
is always true or always false.

View file

@ -22,7 +22,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd October 02, 2020 .Dd October 2, 2020
.Dt BACKLIGHT 9 .Dt BACKLIGHT 9
.Os .Os
.Sh NAME .Sh NAME

View file

@ -39,7 +39,6 @@
.Cd "options VNET_DEBUG" .Cd "options VNET_DEBUG"
.Pp .Pp
.In sys/vnet.h .In sys/vnet.h
.Pp
.\"------------------------------------------------------------ .\"------------------------------------------------------------
.Ss "Constants and Global Variables" .Ss "Constants and Global Variables"
.\" .\"

View file

@ -144,7 +144,8 @@ Prevent visually distracting initialization/exit routines for scripts running
.Xr dialog 1 .Xr dialog 1
several times. several times.
.It Fl l .It Fl l
Line mode. Read lines from input instead of bytes. Line mode.
Read lines from input instead of bytes.
.It Fl L Ar size .It Fl L Ar size
Label size. Label size.
If negative, shrink to longest label width. If negative, shrink to longest label width.

View file

@ -122,7 +122,8 @@ is named
.Sq Pa /blah/blah/file , .Sq Pa /blah/blah/file ,
the backup file is named the backup file is named
.Sq Pa file.BAK .Sq Pa file.BAK
by default. The extension used for the backup file may be overridden using the by default.
The extension used for the backup file may be overridden using the
.Ev SIMPLE_BACKUP_SUFFIX .Ev SIMPLE_BACKUP_SUFFIX
environment variable. environment variable.
.Pp .Pp

View file

@ -124,9 +124,9 @@ See
.Sx NOTES . .Sx NOTES .
.It Fl U .It Fl U
Ignore the presence of character symbols that have no matching character Ignore the presence of character symbols that have no matching character
definition. This facilitates the use of a common locale definition file definition.
to be used across multiple encodings, even when some symbols are not This facilitates the use of a common locale definition file to be used across multiple
present in a given encoding. encodings, even when some symbols are not present in a given encoding.
.It Fl v .It Fl v
Emit verbose debugging output on standard output. Emit verbose debugging output on standard output.
.It Fl w Ar widthfile .It Fl w Ar widthfile

View file

@ -223,8 +223,8 @@ The preferred file extension is ".qcow" and ".qcow2" for QCOW and QCOW2
(resp.), but ".qcow" is sometimes used for version 2 files as well. (resp.), but ".qcow" is sometimes used for version 2 files as well.
.Ss RAW file format .Ss RAW file format
This file format is a sector by sector representation of an actual disk. This file format is a sector by sector representation of an actual disk.
There is no extra information that describes or relates to the format There is no extra information that describes or relates to the format itself.
itself. The size of the file is the size of the (virtual) disk. The size of the file is the size of the (virtual) disk.
This file format is suitable for being copyied onto a disk with utilities This file format is suitable for being copyied onto a disk with utilities
like like
.Nm dd . .Nm dd .

View file

@ -148,7 +148,8 @@ Information (SMIv2).
The context to query with SNMPv3 PDUs. The context to query with SNMPv3 PDUs.
.Bl -tag -width \& .Bl -tag -width \&
.It Cm context=name .It Cm context=name
The context name. Default is "" (empty). The context name.
Default is "" (empty).
.It Cm context-engine=engine-id .It Cm context-engine=engine-id
The SNMP Engine ID of the context to query with SNMPv3 PDUs, represented as The SNMP Engine ID of the context to query with SNMPv3 PDUs, represented as
binary octet string. binary octet string.

View file

@ -1,7 +1,7 @@
.\" .\"
.\" Copyright (c) 2015 Spectra Logic Corporation .\" Copyright (c) 2015 Spectra Logic Corporation
.\" All rights reserved. .\" All rights reserved.
.\" .\"
.\" Redistribution and use in source and binary forms, with or without .\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions .\" modification, are permitted provided that the following conditions
.\" are met: .\" are met:
@ -13,7 +13,7 @@
.\" ("Disclaimer") and any redistribution must be conditioned upon .\" ("Disclaimer") and any redistribution must be conditioned upon
.\" including a substantially similar Disclaimer requirement for further .\" including a substantially similar Disclaimer requirement for further
.\" binary redistribution. .\" binary redistribution.
.\" .\"
.\" NO WARRANTY .\" NO WARRANTY
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
@ -26,11 +26,11 @@
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGES. .\" POSSIBILITY OF SUCH DAMAGES.
.\"
.\" Authors: Ken Merry (Spectra Logic Corporation)
.\"
.\" $FreeBSD$
.\" .\"
.\" Authors: Ken Merry (Spectra Logic Corporation)
.\"
.\" $FreeBSD$
.\
.Dd November 11, 2015 .Dd November 11, 2015
.Dt CAMDD 8 .Dt CAMDD 8
.Os .Os
@ -70,7 +70,7 @@ The following options are available:
.Bl -tag -width 12n .Bl -tag -width 12n
.It Fl i | o Ar args .It Fl i | o Ar args
Specify the input and output device or file. Specify the input and output device or file.
Both Both
.Fl i .Fl i
and and
.Fl o .Fl o
@ -96,7 +96,7 @@ name and unit number, for instance
or a regular peripheral driver name and unit number, for instance or a regular peripheral driver name and unit number, for instance
.Dq da5 . .Dq da5 .
It can also be the path of a It can also be the path of a
.Xr pass 4 .Xr pass 4
or other disk device, like or other disk device, like
.Dq /dev/da5 . .Dq /dev/da5 .
It may also be a bus:target:lun, for example: It may also be a bus:target:lun, for example:
@ -127,7 +127,7 @@ It does support probing disk sector size and capacity information, and tape
blocksize and maximum transfer size information. blocksize and maximum transfer size information.
The file interface supports standard files, disks, tape drives, special The file interface supports standard files, disks, tape drives, special
devices, pipes and standard input and output. devices, pipes and standard input and output.
If the file is specified as a If the file is specified as a
.Dq - , .Dq - ,
standard input or standard output are used. standard input or standard output are used.
For tape devices, the specified blocksize will be the size that For tape devices, the specified blocksize will be the size that
@ -138,7 +138,7 @@ size.
So, that means So, that means
.Nm .Nm
will not write anything smaller than the sector size. will not write anything smaller than the sector size.
At the end of a transfer, if there isn't sufficient data from the reader At the end of a transfer, if there isn't sufficient data from the reader
to yield a full block, to yield a full block,
.Nm .Nm
will add zeros on the end of the data from the reader to make up a full will add zeros on the end of the data from the reader to make up a full
@ -171,7 +171,7 @@ Specify a desired queue depth for the input or output path.
will attempt to keep the requested number of requests of the specified will attempt to keep the requested number of requests of the specified
blocksize queued to the input or output device. blocksize queued to the input or output device.
Queue depths greater than 1 are only supported for the asynchronous Queue depths greater than 1 are only supported for the asynchronous
.Xr pass 4 .Xr pass 4
output method. output method.
The queue depth is maintained on a best effort basis, and may not be The queue depth is maintained on a best effort basis, and may not be
possible to maintain for especially fast devices. possible to maintain for especially fast devices.
@ -261,7 +261,7 @@ Stop the transfer after 100MB has been written.
Copy disk da8 using a 1MB blocksize and desired queue depth of 3 to the Copy disk da8 using a 1MB blocksize and desired queue depth of 3 to the
file disk.img. file disk.img.
.Pp .Pp
.Dl camdd -i file=/etc/rc -o file=- .Dl camdd -i file=/etc/rc -o file=-
.Pp .Pp
Read the file /etc/rc and write it to standard output. Read the file /etc/rc and write it to standard output.
.Pp .Pp

View file

@ -10,7 +10,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright .\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the .\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution. .\" documentation and/or other materials provided with the distribution.
.\" .\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

View file

@ -266,7 +266,7 @@ Note that the <mounted-on-path-of-DS> must be the exact mounted-on path
string used when the DS was mounted on the MDS. string used when the DS was mounted on the MDS.
.Pp .Pp
Once the mirrored DS has been disabled, the pNFS service should continue to Once the mirrored DS has been disabled, the pNFS service should continue to
function, but file updates will only happen on the DS(s) function, but file updates will only happen on the DS(s)
that have not been disabled. Assuming two way mirroring, that implies that have not been disabled. Assuming two way mirroring, that implies
the one DS of the pair stored in the the one DS of the pair stored in the
.Dq pnfsd.dsfile .Dq pnfsd.dsfile

View file

@ -1,7 +1,7 @@
.\" .\"
.\" Copyright (c) 2015 Spectra Logic Corporation .\" Copyright (c) 2015 Spectra Logic Corporation
.\" All rights reserved. .\" All rights reserved.
.\" .\"
.\" Redistribution and use in source and binary forms, with or without .\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions .\" modification, are permitted provided that the following conditions
.\" are met: .\" are met:
@ -13,7 +13,7 @@
.\" ("Disclaimer") and any redistribution must be conditioned upon .\" ("Disclaimer") and any redistribution must be conditioned upon
.\" including a substantially similar Disclaimer requirement for further .\" including a substantially similar Disclaimer requirement for further
.\" binary redistribution. .\" binary redistribution.
.\" .\"
.\" NO WARRANTY .\" NO WARRANTY
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
@ -26,11 +26,11 @@
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGES. .\" POSSIBILITY OF SUCH DAMAGES.
.\"
.\" Authors: Ken Merry (Spectra Logic Corporation)
.\"
.\" $FreeBSD$
.\" .\"
.\" Authors: Ken Merry (Spectra Logic Corporation)
.\"
.\" $FreeBSD$
.\
.Dd May 18, 2016 .Dd May 18, 2016
.Dt ZONECTL 8 .Dt ZONECTL 8
.Os .Os
@ -188,8 +188,8 @@ The summary and column headings are printed, fields are separated by spaces
and the fields themselves may contain spaces. and the fields themselves may contain spaces.
.It summary .It summary
Just print the summary: the number of zones, the maximum LBA (LBA of the Just print the summary: the number of zones, the maximum LBA (LBA of the
last logical block on the drive), and the value of the last logical block on the drive), and the value of the
.Dq same .Dq same
field. field.
The The
.Dq same .Dq same