Remove trailing whitespace per mdoc lint warning
Disussed with: gavin No objection from: doc Approved by: joel MFC after: 3 days
This commit is contained in:
eadler
parent
0b58621565
commit
1ef5fe44d3
@ -46,7 +46,7 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
utility will wait until each of the given processes has terminated.
|
||||
utility will wait until each of the given processes has terminated.
|
||||
.Pp
|
||||
The following option is available:
|
||||
.Bl -tag -width indent
|
||||
|
||||
@ -295,7 +295,7 @@ The ACL qualifier field describes the user or group associated with
|
||||
the ACL entry.
|
||||
It may consist of one of the following: uid or
|
||||
user name, or gid or group name. In entries whose tag type is
|
||||
one of
|
||||
one of
|
||||
.Dq Li owner@ ,
|
||||
.Dq Li group@ ,
|
||||
or
|
||||
|
||||
@ -1631,7 +1631,7 @@ All values are of type
|
||||
.It Constants
|
||||
Decimal, octal (starting with
|
||||
.Li 0 )
|
||||
and hexadecimal (starting with
|
||||
and hexadecimal (starting with
|
||||
.Li 0x )
|
||||
integer constants.
|
||||
.It Variables
|
||||
|
||||
@ -35,7 +35,7 @@
|
||||
.Nm pom
|
||||
.Nd display the phase of the moon
|
||||
.Sh SYNOPSIS
|
||||
.Nm
|
||||
.Nm
|
||||
.Op Fl p
|
||||
.Op Fl d Ar yyyy.mm.dd
|
||||
.Op Fl t Ar hh:mm:ss
|
||||
|
||||
@ -511,7 +511,7 @@ The function returns 0 on success, or -1 if an error occurred.
|
||||
.Pp
|
||||
The
|
||||
.Fn bt_devfilter_pkt_set ,
|
||||
.Fn bt_devfilter_pkt_clr
|
||||
.Fn bt_devfilter_pkt_clr
|
||||
and
|
||||
.Fn bt_devfilter_pkt_tst
|
||||
functions can be used to modify and test the
|
||||
@ -526,7 +526,7 @@ packet type.
|
||||
.Pp
|
||||
The
|
||||
.Fn bt_devfilter_evt_set ,
|
||||
.Fn bt_devfilter_evt_clr
|
||||
.Fn bt_devfilter_evt_clr
|
||||
and
|
||||
.Fn bt_devfilter_evt_tst
|
||||
functions can be used to modify and test the
|
||||
|
||||
@ -802,12 +802,12 @@ principally to provide for alternative interfaces to the
|
||||
.Nm
|
||||
functionality using different data structures.
|
||||
.Sh BUGS
|
||||
The
|
||||
The
|
||||
.Fn fts_open
|
||||
function will automatically set the
|
||||
.Dv FTS_NOCHDIR
|
||||
option if the
|
||||
option if the
|
||||
.Dv FTS_LOGICAL
|
||||
option is provided, or if it cannot
|
||||
option is provided, or if it cannot
|
||||
.Xr open 2
|
||||
the current directory.
|
||||
|
||||
@ -56,7 +56,7 @@ array referenced by
|
||||
These page sizes are expressed in bytes.
|
||||
In this case,
|
||||
.Fn getpagesizes
|
||||
returns the number of such page sizes that it assigned to the array.
|
||||
returns the number of such page sizes that it assigned to the array.
|
||||
.Sh RETURN VALUES
|
||||
If successful, the
|
||||
.Fn getpagesizes
|
||||
|
||||
@ -211,7 +211,7 @@ Maximum number of functions that may be registered with
|
||||
.It Li _SC_XOPEN_VERSION
|
||||
An integer value greater than or equal to 4,
|
||||
indicating the version of the X/Open Portability Guide to which this
|
||||
system conforms.
|
||||
system conforms.
|
||||
.It Li _SC_XOPEN_XCU_VERSION
|
||||
An integer value indicating the version of the XCU Specification to which
|
||||
this system conforms.
|
||||
|
||||
@ -55,7 +55,7 @@
|
||||
.Nm toascii ,
|
||||
.Nm tolower ,
|
||||
.Nm toupper
|
||||
.Nd character classification functions
|
||||
.Nd character classification functions
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
|
||||
@ -102,11 +102,11 @@
|
||||
.Fn toupper_l "int c" "locale_t loc"
|
||||
.Sh DESCRIPTION
|
||||
The above functions perform character tests and conversions on the integer
|
||||
.Fa c
|
||||
.Fa c
|
||||
in the locale
|
||||
.Fa loc .
|
||||
They behave in the same way as the versions without the _l suffix, but use the
|
||||
specified locale rather than the global or per-thread locale.
|
||||
specified locale rather than the global or per-thread locale.
|
||||
.In ctype.h ,
|
||||
or as true functions in the C library.
|
||||
See the specific manual pages for more information.
|
||||
|
||||
@ -49,7 +49,7 @@ function converts a numeric character to its corresponding integer value.
|
||||
The character can be any decimal digit or hexadecimal digit.
|
||||
With hexadecimal characters, the case of the values does not matter.
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fn digittoint_l
|
||||
function takes an explicit locale argument, whereas the
|
||||
.Fn digittoint
|
||||
|
||||
@ -77,7 +77,7 @@ In the ASCII character set, this includes the following characters
|
||||
.It "\&171\ ``y'' \t172\ ``z''"
|
||||
.El
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fn isalnum_l
|
||||
function takes an explicit locale argument, whereas the
|
||||
.Fn isalnum
|
||||
|
||||
@ -74,7 +74,7 @@ In the ASCII character set, this includes the following characters
|
||||
.It "\&164\ ``t'' \t165\ ``u'' \t166\ ``v'' \t167\ ``w'' \t170\ ``x''"
|
||||
.It "\&171\ ``y'' \t172\ ``z''"
|
||||
.El
|
||||
The
|
||||
The
|
||||
.Fn isalpha_l
|
||||
function takes an explicit locale argument, whereas the
|
||||
.Fn isalpha
|
||||
|
||||
@ -59,7 +59,7 @@ The value of the argument must be representable as an
|
||||
or the value of
|
||||
.Dv EOF .
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fn isblank_l
|
||||
function takes an explicit locale argument, whereas the
|
||||
.Fn isblank
|
||||
|
||||
@ -67,7 +67,7 @@ In the ASCII character set, this includes the following characters
|
||||
.It "\&036\ RS \t037\ US \t177\ DEL"
|
||||
.El
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fn iscntrl_l
|
||||
function takes an explicit locale argument, whereas the
|
||||
.Fn iscntrl
|
||||
|
||||
@ -55,7 +55,7 @@ This allows a user to bind a subset of
|
||||
addresses.
|
||||
The
|
||||
.Fn sctp_bindx
|
||||
call operates similarly to
|
||||
call operates similarly to
|
||||
.Fn bind
|
||||
but allows a list of addresses and also allows a bind or an
|
||||
unbind.
|
||||
@ -98,7 +98,7 @@ This value is returned if the
|
||||
field is not one of the allowed values (see above).
|
||||
.It Bq Er ENOMEM
|
||||
This value is returned if the number of addresses
|
||||
being added causes a memory allocation failure in
|
||||
being added causes a memory allocation failure in
|
||||
the call.
|
||||
.It Bq Er EBADF
|
||||
The argument
|
||||
|
||||
@ -58,18 +58,18 @@ This allows a fault tolerant method
|
||||
of initiating an association.
|
||||
When one of the peers addresses
|
||||
is unreachable, the subsequent listed addresses will also be used
|
||||
to set up the association with the peer.
|
||||
to set up the association with the peer.
|
||||
.Pp
|
||||
The user also needs to consider that any address listed in an
|
||||
The user also needs to consider that any address listed in an
|
||||
.Fn sctp_connectx
|
||||
call is also considered "confirmed".
|
||||
A confirmed address is one in
|
||||
which the SCTP transport will trust is a part of the association
|
||||
and it will not send a confirmation heartbeat to it with
|
||||
a random nonce.
|
||||
a random nonce.
|
||||
.Pp
|
||||
If the peer SCTP stack does not list one or more of
|
||||
the provided addresses in its response message then
|
||||
the provided addresses in its response message then
|
||||
the extra addresses sent in the
|
||||
.Fn sctp_connectx
|
||||
call will be silently discarded from the association.
|
||||
|
||||
@ -46,9 +46,9 @@
|
||||
.In sys/socket.h
|
||||
.In netinet/sctp.h
|
||||
.Ft void
|
||||
.Fn sctp_freepaddrs "struct sockaddr *"
|
||||
.Fn sctp_freepaddrs "struct sockaddr *"
|
||||
.Ft void
|
||||
.Fn sctp_freeladdrs "struct sockaddr *"
|
||||
.Fn sctp_freeladdrs "struct sockaddr *"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn sctp_freepaddrs
|
||||
|
||||
@ -62,7 +62,7 @@ system calls.
|
||||
If for some reason a SCTP socket cannot
|
||||
be created or the
|
||||
.Fn getsockopt
|
||||
call fails, an error will be returned
|
||||
call fails, an error will be returned
|
||||
with
|
||||
.Va errno
|
||||
set as specified in the
|
||||
|
||||
@ -50,7 +50,7 @@ The
|
||||
.Fn sctp_getassocid
|
||||
call attempts to look up the specified socket address
|
||||
.Fa addr
|
||||
and find the respective association identification.
|
||||
and find the respective association identification.
|
||||
.Sh RETURN VALUES
|
||||
The call returns the association id upon success and
|
||||
0 is returned upon failure.
|
||||
|
||||
@ -53,7 +53,7 @@
|
||||
The
|
||||
.Fn sctp_getpaddrs
|
||||
function is used to get the list of the peers addresses.
|
||||
The
|
||||
The
|
||||
.Fn sctp_getladdrs
|
||||
function is used to get the list of the local addresses.
|
||||
The association of interest is identified by the
|
||||
|
||||
@ -50,7 +50,7 @@
|
||||
The
|
||||
.Fn sctp_opt_info
|
||||
call provides a multi-os compatible method for getting
|
||||
specific
|
||||
specific
|
||||
.Fn getsockopt
|
||||
data where an association identification needs to be passed
|
||||
into the operating system.
|
||||
@ -70,7 +70,7 @@ who wish to write portable code amongst multiple operating systems
|
||||
this call should be used for the following SCTP
|
||||
socket options.
|
||||
.Pp
|
||||
.Dv SCTP_RTOINFO
|
||||
.Dv SCTP_RTOINFO
|
||||
.Pp
|
||||
.Dv SCTP_ASSOCINFO
|
||||
.Pp
|
||||
|
||||
@ -56,11 +56,11 @@ is used to receive a message from another SCTP endpoint.
|
||||
The
|
||||
.Fn sctp_recvmsg
|
||||
call is used by one-to-one (SOCK_STREAM) type sockets after a
|
||||
successful
|
||||
successful
|
||||
.Fn connect
|
||||
call or after the application has performed a
|
||||
.Fn listen
|
||||
followed by a successful
|
||||
call or after the application has performed a
|
||||
.Fn listen
|
||||
followed by a successful
|
||||
.Fn accept .
|
||||
For a one-to-many (SOCK_SEQPACKET) type socket, an endpoint may call
|
||||
.Fn sctp_recvmsg
|
||||
@ -77,7 +77,7 @@ with a positive backlog to enable the reception of new associations.
|
||||
.Pp
|
||||
The address of the sender is held in the
|
||||
.Fa from
|
||||
argument with
|
||||
argument with
|
||||
.Fa fromlen
|
||||
specifying its size.
|
||||
At the completion of a successful
|
||||
@ -88,16 +88,16 @@ will hold the address of the peer and
|
||||
.Fa fromlen
|
||||
will hold the length of that address.
|
||||
Note that
|
||||
the address is bounded by the initial value of
|
||||
the address is bounded by the initial value of
|
||||
.Fa fromlen
|
||||
which is used as an in/out variable.
|
||||
.Pp
|
||||
The length of the message
|
||||
The length of the message
|
||||
.Fa msg
|
||||
to be received is bounded by
|
||||
.Fa len .
|
||||
If the message is too long to fit in the users
|
||||
receive buffer, then the
|
||||
receive buffer, then the
|
||||
.Fa flags
|
||||
argument will
|
||||
.Em not
|
||||
@ -105,16 +105,16 @@ have the
|
||||
.Dv MSG_EOF
|
||||
flag applied.
|
||||
If the message is a complete message then
|
||||
the
|
||||
the
|
||||
.Fa flags
|
||||
argument will have
|
||||
.Dv MSG_EOF
|
||||
set.
|
||||
Locally detected errors are
|
||||
Locally detected errors are
|
||||
indicated by a return value of -1 with
|
||||
.Va errno
|
||||
set accordingly.
|
||||
The
|
||||
The
|
||||
.Fa flags
|
||||
argument may also hold the value
|
||||
.Dv MSG_NOTIFICATION .
|
||||
@ -141,7 +141,7 @@ The
|
||||
system call may be used to determine when it is possible to
|
||||
receive a message.
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fa sinfo
|
||||
argument is defined as follows.
|
||||
.Bd -literal
|
||||
@ -161,7 +161,7 @@ struct sctp_sndrcvinfo {
|
||||
The
|
||||
.Fa sinfo->sinfo_ppid
|
||||
field is an opaque 32 bit value that is passed transparently
|
||||
through the stack from the peer endpoint.
|
||||
through the stack from the peer endpoint.
|
||||
Note that the stack passes this value without regard to byte
|
||||
order.
|
||||
.Pp
|
||||
@ -182,7 +182,7 @@ was delivered in order within the stream it was received.
|
||||
.Pp
|
||||
The
|
||||
.Fa sinfo->sinfo_stream
|
||||
field is the SCTP stream that the message was received on.
|
||||
field is the SCTP stream that the message was received on.
|
||||
Streams in SCTP are reliable (or partially reliable) flows of ordered
|
||||
messages.
|
||||
.Pp
|
||||
@ -194,7 +194,7 @@ context with the
|
||||
socket option.
|
||||
Optionally a user process can use this value to index some application
|
||||
specific data structure for all data coming from a specific
|
||||
association.
|
||||
association.
|
||||
.Pp
|
||||
The
|
||||
.Fa sinfo->sinfo_ssn
|
||||
@ -230,12 +230,12 @@ sockets this value can be used to send data to the peer without
|
||||
the use of an address field.
|
||||
It is also quite useful in
|
||||
setting various socket options on the specific association
|
||||
(see
|
||||
(see
|
||||
.Xr sctp 4 ) .
|
||||
.Pp
|
||||
The
|
||||
.Fa sinfo->info_timetolive
|
||||
field is not used by
|
||||
field is not used by
|
||||
.Fn sctp_recvmsg .
|
||||
.Sh RETURN VALUES
|
||||
The call returns the number of bytes received, or -1
|
||||
|
||||
@ -62,14 +62,14 @@ is used to transmit a message to another SCTP endpoint.
|
||||
.Fn sctp_send
|
||||
may be used to send data to an existing association for both
|
||||
one-to-many (SOCK_SEQPACKET) and one-to-one (SOCK_STREAM) socket types.
|
||||
The length of the message
|
||||
The length of the message
|
||||
.Fa msg
|
||||
is given by
|
||||
.Fa len .
|
||||
If the message is too long to pass atomically through the
|
||||
underlying protocol,
|
||||
.Va errno
|
||||
is set to
|
||||
is set to
|
||||
.Er EMSGSIZE ,
|
||||
-1 is returned, and
|
||||
the message is not transmitted.
|
||||
@ -88,7 +88,7 @@ The
|
||||
system call may be used to determine when it is possible to
|
||||
send more data on one-to-one type (SOCK_STREAM) sockets.
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fa sinfo
|
||||
structure is used to control various SCTP features
|
||||
and has the following format:
|
||||
@ -106,7 +106,7 @@ struct sctp_sndrcvinfo {
|
||||
};
|
||||
.Ed
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fa sinfo->sinfo_ppid
|
||||
argument is an opaque 32 bit value that is passed transparently
|
||||
through the stack to the peer endpoint. It will be available on
|
||||
@ -131,7 +131,7 @@ argument may include one or more of the following:
|
||||
#define SCTP_PR_SCTP_RTX 0x0003 /* Number of retransmissions based PR-SCTP */
|
||||
.Ed
|
||||
.Pp
|
||||
The flag
|
||||
The flag
|
||||
.Dv SCTP_EOF
|
||||
is used to instruct the SCTP stack to queue this message
|
||||
and then start a graceful shutdown of the association.
|
||||
@ -158,7 +158,7 @@ is used to specify that a specific address should be used.
|
||||
Normally
|
||||
SCTP will use only one of a multi-homed peers addresses as the primary
|
||||
address to send to.
|
||||
By default, no matter what the
|
||||
By default, no matter what the
|
||||
.Fa to
|
||||
argument is, this primary address is used to send data.
|
||||
By specifying
|
||||
@ -193,14 +193,14 @@ skipped and no longer transmitted.
|
||||
Note that this policy does
|
||||
not even assure that the data will ever be sent.
|
||||
In times of a congestion
|
||||
with large amounts of data being queued, the
|
||||
with large amounts of data being queued, the
|
||||
.Fa sinfo->sinfo_timetolive
|
||||
may expire before the first transmission is ever made.
|
||||
.Pp
|
||||
The
|
||||
.Dv SCTP_PR_SCTP_BUF
|
||||
based policy transforms the
|
||||
.Fa sinfo->sinfo_timetolive
|
||||
.Fa sinfo->sinfo_timetolive
|
||||
field into a total number of bytes allowed on the outbound
|
||||
send queue.
|
||||
If that number or more bytes are in queue, then
|
||||
@ -208,19 +208,19 @@ other buffer-based sends are looked to be removed and
|
||||
skipped.
|
||||
Note that this policy may also result in the data
|
||||
never being sent if no buffer based sends are in queue and
|
||||
the maximum specified by
|
||||
.Fa timetolive
|
||||
the maximum specified by
|
||||
.Fa timetolive
|
||||
bytes is in queue.
|
||||
.Pp
|
||||
The
|
||||
.Dv SCTP_PR_SCTP_RTX
|
||||
policy transforms the
|
||||
.Fa sinfo->sinfo_timetolive
|
||||
.Fa sinfo->sinfo_timetolive
|
||||
into a number of retransmissions to allow.
|
||||
This policy
|
||||
always assures that at a minimum one send attempt is
|
||||
made of the data.
|
||||
After which no more than
|
||||
After which no more than
|
||||
.Fa sinfo->sinfo_timetolive
|
||||
retransmissions will be made before the data is skipped.
|
||||
.Pp
|
||||
@ -228,11 +228,11 @@ retransmissions will be made before the data is skipped.
|
||||
is the SCTP stream that you wish to send the
|
||||
message on.
|
||||
Streams in SCTP are reliable (or partially reliable) flows of ordered
|
||||
messages.
|
||||
messages.
|
||||
.Pp
|
||||
The
|
||||
.Fa sinfo->sinfo_assoc_id
|
||||
field is used to
|
||||
field is used to
|
||||
select the association to send to on a one-to-many socket.
|
||||
For a one-to-one socket, this field is ignored.
|
||||
.Pp
|
||||
@ -256,16 +256,16 @@ The fields
|
||||
.Fa sinfo->sinfo_ssn ,
|
||||
.Fa sinfo->sinfo_tsn ,
|
||||
and
|
||||
.Fa sinfo->sinfo_cumtsn
|
||||
.Fa sinfo->sinfo_cumtsn
|
||||
are used only when receiving messages and are thus ignored by
|
||||
.Fn sctp_send .
|
||||
The function
|
||||
.Fn sctp_sendx
|
||||
has the same properties as
|
||||
.Fn sctp_sendx
|
||||
has the same properties as
|
||||
.Fn sctp_send
|
||||
with the additional arguments of an array of sockaddr structures
|
||||
passed in.
|
||||
With the
|
||||
With the
|
||||
.Fa addrs
|
||||
argument being given as an array of addresses to be sent to and
|
||||
the
|
||||
@ -277,7 +277,7 @@ when an implicit association is being set up.
|
||||
This allows the
|
||||
user the equivalent behavior as doing a
|
||||
.Fn sctp_connectx
|
||||
followed by a
|
||||
followed by a
|
||||
.Fn sctp_send
|
||||
to the association.
|
||||
Note that if the
|
||||
|
||||
@ -72,10 +72,10 @@ Data sent in such an instance will result in
|
||||
the data being sent on the third leg of the SCTP four-way handshake.
|
||||
Note that if
|
||||
the socket is a one-to-one type (SOCK_STREAM) socket then an association must
|
||||
be in existence (by use of the
|
||||
be in existence (by use of the
|
||||
.Xr connect 2
|
||||
system call).
|
||||
Calling
|
||||
Calling
|
||||
.Fn sctp_sendmsg
|
||||
or
|
||||
.Fn sctp_sendmsgx
|
||||
@ -90,14 +90,14 @@ The address of the target is given by
|
||||
with
|
||||
.Fa tolen
|
||||
specifying its size.
|
||||
The length of the message
|
||||
The length of the message
|
||||
.Fa msg
|
||||
is given by
|
||||
.Fa len .
|
||||
If the message is too long to pass atomically through the
|
||||
underlying protocol,
|
||||
.Va errno
|
||||
is set to
|
||||
is set to
|
||||
.Er EMSGSIZE ,
|
||||
-1 is returned, and
|
||||
the message is not transmitted.
|
||||
@ -117,7 +117,7 @@ The
|
||||
system call may be used to determine when it is possible to
|
||||
send more data on one-to-one type (SOCK_STREAM) sockets.
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Fa ppid
|
||||
argument is an opaque 32 bit value that is passed transparently
|
||||
through the stack to the peer endpoint.
|
||||
@ -143,7 +143,7 @@ argument may include one or more of the following:
|
||||
#define SCTP_PR_SCTP_RTX 0x0003 /* Number of retransmissions based PR-SCTP */
|
||||
.Ed
|
||||
.Pp
|
||||
The flag
|
||||
The flag
|
||||
.Dv SCTP_EOF
|
||||
is used to instruct the SCTP stack to queue this message
|
||||
and then start a graceful shutdown of the association.
|
||||
@ -170,7 +170,7 @@ is used to specify that an specific address should be used.
|
||||
Normally
|
||||
SCTP will use only one of a multi-homed peers addresses as the primary
|
||||
address to send to.
|
||||
By default, no matter what the
|
||||
By default, no matter what the
|
||||
.Fa to
|
||||
argument is, this primary address is used to send data.
|
||||
By specifying
|
||||
@ -205,14 +205,14 @@ skipped and no longer transmitted.
|
||||
Note that this policy does
|
||||
not even assure that the data will ever be sent.
|
||||
In times of a congestion
|
||||
with large amounts of data being queued, the
|
||||
with large amounts of data being queued, the
|
||||
.Fa timetolive
|
||||
may expire before the first transmission is ever made.
|
||||
.Pp
|
||||
The
|
||||
.Dv SCTP_PR_SCTP_BUF
|
||||
based policy transforms the
|
||||
.Fa timetolive
|
||||
.Fa timetolive
|
||||
field into a total number of bytes allowed on the outbound
|
||||
send queue.
|
||||
If that number or more bytes are in queue, then
|
||||
@ -220,19 +220,19 @@ other buffer based sends are looked to be removed and
|
||||
skipped.
|
||||
Note that this policy may also result in the data
|
||||
never being sent if no buffer based sends are in queue and
|
||||
the maximum specified by
|
||||
.Fa timetolive
|
||||
the maximum specified by
|
||||
.Fa timetolive
|
||||
bytes is in queue.
|
||||
.Pp
|
||||
The
|
||||
.Dv SCTP_PR_SCTP_RTX
|
||||
policy transforms the
|
||||
.Fa timetolive
|
||||
.Fa timetolive
|
||||
into a number of retransmissions to allow.
|
||||
This policy
|
||||
always assures that at a minimum one send attempt is
|
||||
made of the data.
|
||||
After which no more than
|
||||
After which no more than
|
||||
.Fa timetolive
|
||||
retransmissions will be made before the data is skipped.
|
||||
.Pp
|
||||
@ -241,7 +241,7 @@ is the SCTP stream that you wish to send the
|
||||
message on.
|
||||
Streams in SCTP are reliable (or partially reliable) flows of ordered
|
||||
messages.
|
||||
The
|
||||
The
|
||||
.Fa context
|
||||
field is used only in the event the message cannot be sent.
|
||||
This is an opaque
|
||||
@ -251,7 +251,7 @@ is given if that notification is enabled (see
|
||||
Normally a user process can use this value to index some application
|
||||
specific data structure when a send cannot be fulfilled.
|
||||
.Fn sctp_sendmsgx
|
||||
is identical to
|
||||
is identical to
|
||||
.Fn sctp_sendmsg
|
||||
with the exception that it takes an array of sockaddr structures in the
|
||||
argument
|
||||
@ -262,7 +262,7 @@ which specifies how many addresses are in the array.
|
||||
This allows a
|
||||
caller to implicitly set up an association passing multiple addresses
|
||||
as if
|
||||
.Fn sctp_connectx
|
||||
.Fn sctp_connectx
|
||||
had been called to set up the association.
|
||||
.Sh RETURN VALUES
|
||||
The call returns the number of characters sent, or -1
|
||||
@ -325,7 +325,7 @@ is not connected and is a one-to-one style socket.
|
||||
.Xr sctp 4
|
||||
.Sh BUGS
|
||||
Because in the one-to-many style socket
|
||||
.Fn sctp_sendmsg
|
||||
.Fn sctp_sendmsg
|
||||
or
|
||||
.Fn sctp_sendmsgx
|
||||
may have multiple associations under one endpoint, a
|
||||
|
||||
@ -220,7 +220,7 @@ operation.
|
||||
.Sh SEE ALSO
|
||||
.Xr ip 4 ,
|
||||
.Xr ip6 4 ,
|
||||
.Xr multicast 4,
|
||||
.Xr multicast 4,
|
||||
.Xr ifmcstat 8
|
||||
.Rs
|
||||
.%A D. Thaler
|
||||
|
||||
@ -30,7 +30,7 @@
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm acl_add_flag_np
|
||||
.Nd add flags to a flagset
|
||||
.Nd add flags to a flagset
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
|
||||
@ -39,7 +39,7 @@
|
||||
.In sys/acl.h
|
||||
.Ft int
|
||||
.Fn acl_create_entry "acl_t *acl_p" "acl_entry_t *entry_p"
|
||||
.Ft int
|
||||
.Ft int
|
||||
.Fn acl_create_entry_np "acl_t *acl_p" "acl_entry_t *entry_p" "int index"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
|
||||
@ -78,7 +78,7 @@ and
|
||||
.Fn getline
|
||||
functions return the number of characters written, excluding the
|
||||
terminating
|
||||
.Dv NUL
|
||||
.Dv NUL
|
||||
character.
|
||||
The value \-1 is returned if an error occurs, or if end-of-file is reached.
|
||||
.Sh EXAMPLES
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
.\" Copyright (c) 2011 David Chisnall
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
@ -9,7 +9,7 @@
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\"
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
@ -21,7 +21,7 @@
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd December 7, 2011
|
||||
@ -40,16 +40,16 @@
|
||||
The
|
||||
.Fn at_quick_exit
|
||||
function registers a cleanup function to be called when the program exits as a
|
||||
result of calling
|
||||
result of calling
|
||||
.Xr quick_exit 3 .
|
||||
The cleanup functions are called in the reverse order and will not be called if
|
||||
the program exits by calling
|
||||
the program exits by calling
|
||||
.Xr exit 3 ,
|
||||
.Xr _Exit 3 ,
|
||||
or
|
||||
.Xr abort 3 .
|
||||
.Sh RETURN VALUES
|
||||
The
|
||||
The
|
||||
.Fn at_quick_exit
|
||||
function returns the value 0 if successful and a non-zero value on failure.
|
||||
.Sh SEE ALSO
|
||||
|
||||
@ -201,7 +201,7 @@ function appeared in
|
||||
Until
|
||||
.Fx 7.0 ,
|
||||
.Fn putenv
|
||||
would make a copy of
|
||||
would make a copy of
|
||||
.Fa string
|
||||
and insert it into the environment using
|
||||
.Fn setenv .
|
||||
|
||||
@ -94,7 +94,7 @@ conforms to
|
||||
.St -isoC .
|
||||
.Pp
|
||||
The
|
||||
.Fn memrchr
|
||||
.Fn memrchr
|
||||
function is a GNU extension and conforms to no standard.
|
||||
.Sh HISTORY
|
||||
The
|
||||
|
||||
@ -464,7 +464,7 @@ Support for capabilities and capabilities mode was developed as part of the
|
||||
Project.
|
||||
.Sh AUTHORS
|
||||
These functions and the capability facility were created by
|
||||
.An "Robert N. M. Watson"
|
||||
.An "Robert N. M. Watson"
|
||||
at the University of Cambridge Computer Laboratory with support from a grant
|
||||
from Google, Inc.
|
||||
.Sh BUGS
|
||||
|
||||
@ -77,7 +77,7 @@ while application developers will manipulate anonymous sets using
|
||||
To select the correct set a value of type
|
||||
.Ft cpulevel_t
|
||||
is used.
|
||||
The following values for
|
||||
The following values for
|
||||
.Fa level
|
||||
are supported:
|
||||
.Bl -column CPU_LEVEL_CPUSET -offset indent
|
||||
@ -137,7 +137,7 @@ Children inherit this set after a call to
|
||||
.Xr fork 2 .
|
||||
.Pp
|
||||
.Fn cpuset_setid
|
||||
attempts to set the id of the object specified by the
|
||||
attempts to set the id of the object specified by the
|
||||
.Fa which
|
||||
argument.
|
||||
Currently
|
||||
@ -149,12 +149,12 @@ Upon successful completion all of the threads in the target process will
|
||||
be running on CPUs permitted by the set.
|
||||
.Pp
|
||||
.Fn cpuset_getid
|
||||
retrieves a set id from the object indicated by
|
||||
retrieves a set id from the object indicated by
|
||||
.Fa which
|
||||
and stores it in the space pointed to by
|
||||
.Fa setid .
|
||||
The retrieved id may be that of either the root or assigned set
|
||||
depending on the value of
|
||||
depending on the value of
|
||||
.Fa level .
|
||||
.Fa level
|
||||
should be
|
||||
|
||||
@ -45,7 +45,7 @@
|
||||
.Fn cpuset_getaffinity
|
||||
and
|
||||
.Fn cpuset_setaffinity
|
||||
allow the manipulation of sets of CPUs available to processes, threads,
|
||||
allow the manipulation of sets of CPUs available to processes, threads,
|
||||
interrupts, jails and other resources.
|
||||
These functions may manipulate sets of CPUs that contain many processes
|
||||
or per-object anonymous masks that effect only a single object.
|
||||
|
||||
@ -334,7 +334,7 @@ flag is not set.
|
||||
The jail referred to by a
|
||||
.Va jid
|
||||
is not accessible by the process, because the process is in a different
|
||||
jail.
|
||||
jail.
|
||||
.It Bq Er EEXIST
|
||||
The jail referred to by a
|
||||
.Va jid
|
||||
@ -382,7 +382,7 @@ parameter does not exist.
|
||||
The jail referred to by a
|
||||
.Va jid
|
||||
is not accessible by the process, because the process is in a different
|
||||
jail.
|
||||
jail.
|
||||
.It Bq Er ENOENT
|
||||
The
|
||||
.Va lastjid
|
||||
|
||||
@ -203,7 +203,7 @@ will not return it.
|
||||
The filter itself is not disabled.
|
||||
.It EV_DISPATCH
|
||||
Disable the event source immediately after delivery of an event.
|
||||
See
|
||||
See
|
||||
.Dv EV_DISABLE
|
||||
above.
|
||||
.It EV_DELETE
|
||||
@ -217,7 +217,7 @@ any pending events.
|
||||
When passed as input, it forces
|
||||
.Dv EV_ERROR
|
||||
to always be returned.
|
||||
When a filter is successfully added the
|
||||
When a filter is successfully added the
|
||||
.Va data
|
||||
field will be zero.
|
||||
.It EV_ONESHOT
|
||||
@ -449,10 +449,10 @@ Establishes a user event identified by
|
||||
.Va ident
|
||||
which is not associated with any kernel mechanism but is triggered by
|
||||
user level code.
|
||||
The lower 24 bits of the
|
||||
The lower 24 bits of the
|
||||
.Va fflags
|
||||
may be used for user defined flags and manipulated using the following:
|
||||
.Bl -tag -width XXNOTE_FFLAGSMASK
|
||||
.Bl -tag -width XXNOTE_FFLAGSMASK
|
||||
.It Dv NOTE_FFNOP
|
||||
Ignore the input
|
||||
.Va fflags .
|
||||
|
||||
@ -173,7 +173,7 @@ return a positive number that represents the minimum hole size returned in
|
||||
bytes.
|
||||
The offsets of holes returned will be aligned to this same value.
|
||||
A special value of 1 is returned if the file system does not specify the minimum
|
||||
hole size but still reports holes.
|
||||
hole size but still reports holes.
|
||||
.El
|
||||
.Sh RETURN VALUES
|
||||
If the call to
|
||||
|
||||
@ -441,7 +441,7 @@ This request is used to iterate over the entries of the VM map of the traced
|
||||
process.
|
||||
The
|
||||
.Fa addr
|
||||
argument specifies a pointer to a
|
||||
argument specifies a pointer to a
|
||||
.Vt "struct ptrace_vm_entry" ,
|
||||
which is defined as follows:
|
||||
.Bd -literal
|
||||
|
||||
@ -113,7 +113,7 @@ Only the super-user may turn quotas off.
|
||||
.It Dv Q_GETQUOTASIZE
|
||||
Get the wordsize used to represent the quotas for the user or group
|
||||
(as determined by the command type).
|
||||
Possible values are 32 for the old-style quota file
|
||||
Possible values are 32 for the old-style quota file
|
||||
and 64 for the new-style quota file.
|
||||
The
|
||||
.Fa addr
|
||||
@ -199,7 +199,7 @@ The
|
||||
.Fa id
|
||||
argument to
|
||||
.Dv Q_GETQUOTA ,
|
||||
.Dv Q_SETQUOTA
|
||||
.Dv Q_SETQUOTA
|
||||
or
|
||||
.Dv Q_SETUSE
|
||||
is a negative value.
|
||||
|
||||
@ -54,7 +54,7 @@ and
|
||||
.Fn sctp_generic_sendmsg_iov
|
||||
are the true system calls used by the
|
||||
.Xr sctp_sendmsg 3
|
||||
and
|
||||
and
|
||||
.Xr sctp_send 3
|
||||
function calls.
|
||||
These are more efficient since they are
|
||||
@ -68,7 +68,7 @@ For detailed usage please see either the
|
||||
.Xr sctp_send 3
|
||||
or
|
||||
.Xr sctp_sendmsg 3
|
||||
function calls.
|
||||
function calls.
|
||||
.Sh RETURN VALUES
|
||||
The call returns the number of bytes written on success and -1 upon failure.
|
||||
.Sh ERRORS
|
||||
|
||||
@ -60,7 +60,7 @@ The
|
||||
system call can return the following errors:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er ENOTCONN
|
||||
The
|
||||
The
|
||||
.Fa id
|
||||
given to the call does not map to a valid
|
||||
association.
|
||||
|
||||
@ -222,6 +222,6 @@ Thus, it is unwise to assume that the timeout value will be unmodified
|
||||
by the
|
||||
.Fn select
|
||||
system call.
|
||||
.Fx
|
||||
.Fx
|
||||
does not modify the return value, which can cause problems for applications
|
||||
ported from other systems.
|
||||
|
||||
@ -104,7 +104,7 @@ variable pointed to by
|
||||
The
|
||||
.Fa flags
|
||||
argument is a bitmap of these values:
|
||||
.Bl -item -offset indent
|
||||
.Bl -item -offset indent
|
||||
.It
|
||||
.Dv SF_NODISKIO .
|
||||
This flag causes any
|
||||
|
||||
@ -523,7 +523,7 @@ flag on an ELF descriptor using
|
||||
.Xr elf_flagelf 3 ,
|
||||
following which the library will use the data offsets and alignments
|
||||
specified by the application when laying out the file.
|
||||
Application control of file layout is described further in the
|
||||
Application control of file layout is described further in the
|
||||
.Xr elf_update 3
|
||||
manual page.
|
||||
.Pp
|
||||
|
||||
@ -174,7 +174,7 @@ These functions return a valid pointer to a data descriptor if successful, or
|
||||
NULL if an error occurs.
|
||||
.Sh ERRORS
|
||||
These functions may fail with the following errors:
|
||||
.Bl -tag -width "[ELF_E_RESOURCE]"
|
||||
.Bl -tag -width "[ELF_E_RESOURCE]"
|
||||
.It Bq Er ELF_E_ARGUMENT
|
||||
Arguments
|
||||
.Ar scn
|
||||
|
||||
@ -375,7 +375,7 @@ If the
|
||||
(if-modified-since) flag is specified, and
|
||||
the
|
||||
.Va ims_time
|
||||
field is set in
|
||||
field is set in
|
||||
.Vt "struct url" ,
|
||||
then
|
||||
.Fn fetchXGetHTTP
|
||||
|
||||
@ -53,7 +53,7 @@ field in the descriptor to
|
||||
.Dv NULL .
|
||||
Any buffer object returned by a GSS-API routine may be passed to
|
||||
.Fn gss_release_buffer
|
||||
(even if there is no storage associated with the buffer).
|
||||
(even if there is no storage associated with the buffer).
|
||||
.Sh PARAMETERS
|
||||
.Bl -tag
|
||||
.It minor_status
|
||||
|
||||
@ -53,7 +53,7 @@ and the gss_OID_set_desc itself.
|
||||
.Pp
|
||||
Implementations are encouraged to set the gss_OID_set parameter to
|
||||
.Dv GSS_C_NO_OID_SET
|
||||
on successful completion of this routine.
|
||||
on successful completion of this routine.
|
||||
.Sh PARAMETERS
|
||||
.Bl -tag
|
||||
.It minor_status
|
||||
|
||||
@ -62,10 +62,10 @@ This mechanism will be used by
|
||||
.Xr gss_init_sec_context 3
|
||||
if the user doesn't specify a specific mechanism.
|
||||
.Pp
|
||||
The
|
||||
The
|
||||
.Pa "/etc/gss/qop"
|
||||
file contains a list of Quality of Protection values for use with
|
||||
GSS-API.
|
||||
GSS-API.
|
||||
Each line of the file either contains a comment if the first character
|
||||
is '#' or it contains three fields with the following meanings:
|
||||
.Bl -tag
|
||||
|
||||
@ -48,7 +48,7 @@ parameter, this is the
|
||||
feature.
|
||||
.Ss NoLogin Account Management Module
|
||||
The NoLogin account management component,
|
||||
.Fn pam_sm_acct_mgmt ,
|
||||
.Fn pam_sm_acct_mgmt ,
|
||||
verifies whether logins are administratively disabled via
|
||||
.Xr nologin 5 .
|
||||
It returns success if the user's login class has an "ignorenologin"
|
||||
|
||||
@ -180,7 +180,7 @@ The default is
|
||||
The following event names are case insensitive.
|
||||
Whitespace, hyphens and underscore characters in these names are
|
||||
ignored.
|
||||
.Pp
|
||||
.Pp
|
||||
Core PMCs support the following events:
|
||||
.Bl -tag -width indent
|
||||
.It Li BAClears
|
||||
@ -193,7 +193,7 @@ produce a prediction.
|
||||
.It Li Br_BAC_Missp_Exec
|
||||
.Pq Event 8AH , Umask 00H
|
||||
The number of branch instructions executed that were mispredicted at
|
||||
the front end.
|
||||
the front end.
|
||||
.It Li Br_Bogus
|
||||
.Pq Event E4H , Umask 00H
|
||||
The number of bogus branches.
|
||||
|
||||
@ -45,7 +45,7 @@ have 4 counters.
|
||||
Third generation cores also have an increased number of PMC events.
|
||||
.Pp
|
||||
.Tn Intel XScale
|
||||
PMCs are documented in
|
||||
PMCs are documented in
|
||||
.Rs
|
||||
.%B "3rd Generation Intel XScale Microarchitecture Developer's Manual"
|
||||
.%D May 2007
|
||||
@ -117,7 +117,7 @@ Self initiated address bus transaction.
|
||||
.It Li DATA_BUS_TRANS
|
||||
Data bus transaction.
|
||||
.El
|
||||
.Ss Event Name Aliases
|
||||
.Ss Event Name Aliases
|
||||
The following table shows the mapping between the PMC-independent
|
||||
aliases supported by
|
||||
.Lb libpmc
|
||||
|
||||
@ -51,7 +51,7 @@
|
||||
.Ft int
|
||||
.Fn pmc_width "pmc_id_t pmc" "uint32_t *width"
|
||||
.Sh DESCRIPTION
|
||||
These functions retrieve information about performance monitoring
|
||||
These functions retrieve information about performance monitoring
|
||||
hardware.
|
||||
.Pp
|
||||
Function
|
||||
|
||||
@ -70,7 +70,7 @@ The default - typically the same as
|
||||
RPC headers only are integrity protected by a checksum.
|
||||
.It rpc_gss_svc_integrity
|
||||
RPC headers and data are integrity protected by a checksum.
|
||||
.It rpc_gss_svc_privacy
|
||||
.It rpc_gss_svc_privacy
|
||||
RPC headers are integrity protected by a checksum and data is encrypted.
|
||||
.El
|
||||
.It qop
|
||||
|
||||
@ -380,7 +380,7 @@ the request, and waits for a reply.
|
||||
On failure,
|
||||
.Fn tac_send_acct
|
||||
returns \-1.
|
||||
Otherwise, it returns the TACACS+ status code
|
||||
Otherwise, it returns the TACACS+ status code
|
||||
Possible status codes, defined in
|
||||
.In taclib.h ,
|
||||
include:
|
||||
|
||||
@ -85,7 +85,7 @@ descriptor passed to the login functions.
|
||||
.Pp
|
||||
The
|
||||
.Fa pty
|
||||
arguments of
|
||||
arguments of
|
||||
.Fn addToUtmp
|
||||
and
|
||||
.Fn removeLineFromUtmp
|
||||
|
||||
@ -542,7 +542,7 @@ returns a zero terminated string describing the backend used.
|
||||
.Pp
|
||||
.
|
||||
.Fn libusb20_dev_get_info
|
||||
retrieves the BSD specific usb_device_info structure into the memory location given by
|
||||
retrieves the BSD specific usb_device_info structure into the memory location given by
|
||||
.Fa pinfo .
|
||||
The USB device given by
|
||||
.Fa pdev
|
||||
|
||||
@ -509,7 +509,7 @@ applies these to determine the authorisation style that best suites
|
||||
these rules.
|
||||
.Bl -bullet
|
||||
.It
|
||||
If
|
||||
If
|
||||
.Fa auth
|
||||
is neither
|
||||
.Dv NULL
|
||||
@ -524,7 +524,7 @@ default to
|
||||
.Ql passwd
|
||||
as the authorisation list.
|
||||
.It
|
||||
If
|
||||
If
|
||||
.Fa style
|
||||
is not
|
||||
.Dv NULL
|
||||
|
||||
@ -242,7 +242,7 @@ limit and usage values written to the quota file will be clipped to 32 bits.
|
||||
.Sh RETURN VALUES
|
||||
If the filesystem has quotas associated with it,
|
||||
.Fn quota_open
|
||||
returns a pointer to a
|
||||
returns a pointer to a
|
||||
.Vt quotafile
|
||||
structure used in subsequent quota access calls.
|
||||
If the filesystem has no quotas, or access permission is denied
|
||||
@ -285,6 +285,6 @@ functions first appeared in
|
||||
The
|
||||
.Nm quotafile
|
||||
functions and this manual page were written by
|
||||
.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org
|
||||
.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org
|
||||
and
|
||||
.An Marshall Kirk McKusick Aq mckusick@mckusick.com .
|
||||
|
||||
@ -161,9 +161,9 @@ which is specified.
|
||||
.Pp
|
||||
If
|
||||
.Ar value
|
||||
is specified, then the debug level is set to
|
||||
is specified, then the debug level is set to
|
||||
.Ar value .
|
||||
The debug level is a bitmask implemented in
|
||||
The debug level is a bitmask implemented in
|
||||
.Pa src/libexec/tftpd/tftp-utils.h .
|
||||
Valid values are 0 (DEBUG_NONE), 1 (DEBUG_PACKETS), 2, (DEBUG_SIMPLE),
|
||||
4 (DEBUG_OPTIONS), and 8 (DEBUG_ACCESS). Multiple debug values can be combined
|
||||
@ -262,7 +262,7 @@ TFTP options are mentioned here:
|
||||
.Rs
|
||||
.%T Extending TFTP
|
||||
.%U http://www.compuphase.com/tftp.htm
|
||||
.Re
|
||||
.Re
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm
|
||||
|
||||
@ -599,7 +599,7 @@ If the format is
|
||||
11 result registers will be written to standard output in hex.
|
||||
.El
|
||||
.It Ic smpcmd
|
||||
Allows the user to send an arbitrary Serial
|
||||
Allows the user to send an arbitrary Serial
|
||||
Management Protocol (SMP) command to a device.
|
||||
The
|
||||
.Ic smpcmd
|
||||
@ -660,7 +660,7 @@ argument is required to specify the PHY to operate on.
|
||||
.Bl -tag -width 17n
|
||||
.It Fl p Ar phy
|
||||
Specify the PHY to operate on.
|
||||
This argument is required.
|
||||
This argument is required.
|
||||
.It Fl l
|
||||
Request the long request/response format.
|
||||
Not all SMP targets support the long response format.
|
||||
|
||||
@ -247,8 +247,8 @@ configuration file.
|
||||
Local
|
||||
.Nm
|
||||
configuration file. Rulesets in here override those in
|
||||
.Pa /etc/defaults/devfs.rules
|
||||
with the same ruleset number, otherwise the two files are effectively merged.
|
||||
.Pa /etc/defaults/devfs.rules
|
||||
with the same ruleset number, otherwise the two files are effectively merged.
|
||||
.It Pa /etc/devfs.conf
|
||||
Boot-time
|
||||
.Nm
|
||||
|
||||
@ -42,7 +42,7 @@
|
||||
.Bl -tag -width indent
|
||||
.It Ic attach Ar plex volume Op Cm rename
|
||||
.It Ic attach Ar subdisk plex Oo Ar offset Oc Op Cm rename
|
||||
Attach a plex to a volume, or a subdisk to a plex.
|
||||
Attach a plex to a volume, or a subdisk to a plex.
|
||||
If offset is specified, the subdisk will be attached to the given offset within
|
||||
the plex.
|
||||
If rename is specified, the subdisk or plex will change name according to the
|
||||
@ -103,10 +103,10 @@ and
|
||||
.Fl V
|
||||
flags provide progressively more detailed output.
|
||||
.It Ic mirror Oo Fl fsv Oc Oo Fl n Ar name Oc Ar drives
|
||||
Create a mirrored volume from the specified drives.
|
||||
Create a mirrored volume from the specified drives.
|
||||
It requires at least a multiple of 2 drives.
|
||||
If no name is specified, a unique name will be set by gvinum.
|
||||
If the
|
||||
If the
|
||||
.Fl s
|
||||
flag is specified, a striped mirror will be created, and thus requires a
|
||||
multiple of 4 drives.
|
||||
@ -149,7 +149,7 @@ EOF character.
|
||||
.It Ic raid5 Oo Fl fv Oc Oo Fl s Ar stripesize Oc Oo Fl n Ar name Oc Ar drives
|
||||
Create a RAID-5 volume from the specified drives.
|
||||
If no name is specified,a unique name will be set by
|
||||
.Ic gvinum.
|
||||
.Ic gvinum.
|
||||
This organization requires at least three drives.
|
||||
.It Ic rename Oo Fl r Oc Ar drive | subdisk | plex | volume newname
|
||||
Change the name of the specified object.
|
||||
@ -282,7 +282,7 @@ unmount and then stop Ic gvinum:
|
||||
.Pp
|
||||
.Dl "gvinum mirror /dev/ad1 /dev/ad2"
|
||||
.Dl "newfs /dev/gvinum/gvinumvolume0"
|
||||
.Dl "mount /dev/gvinum/gvinumvolume0 /mnt"
|
||||
.Dl "mount /dev/gvinum/gvinumvolume0 /mnt"
|
||||
.Dl "..."
|
||||
.Dl "unmount /mnt"
|
||||
.Dl "gvinum stop"
|
||||
|
||||
@ -675,7 +675,7 @@ and DAD will be performed when this flag is cleared.
|
||||
.It Cm -ifdisabled
|
||||
Clear a flag
|
||||
.Cm ifdisabled .
|
||||
When this flag is cleared and
|
||||
When this flag is cleared and
|
||||
.Cm auto_linklocal
|
||||
flag is enabled, automatic configuration of a link-local address is
|
||||
performed.
|
||||
@ -706,7 +706,7 @@ Specify the operating mode for this cloned device.
|
||||
.Ar mode
|
||||
is one of
|
||||
.Cm sta ,
|
||||
.Cm ahdemo
|
||||
.Cm ahdemo
|
||||
(or
|
||||
.Cm adhoc-demo ),
|
||||
.Cm ibss ,
|
||||
@ -744,7 +744,7 @@ the device (if supported).
|
||||
Mark a
|
||||
.Cm wds
|
||||
device as operating in ``legacy mode''.
|
||||
Legacy
|
||||
Legacy
|
||||
.Cm wds
|
||||
devices have a fixed peer relationship and do not, for example, roam
|
||||
if their peer stops communicating.
|
||||
@ -760,9 +760,9 @@ Mark the cloned interface as depending on hardware support to
|
||||
track received beacons.
|
||||
To have beacons tracked in software use
|
||||
.Fl beacons .
|
||||
For
|
||||
For
|
||||
.Cm hostap
|
||||
mode
|
||||
mode
|
||||
.Fl beacons
|
||||
can also be used to indicate no beacons should
|
||||
be transmitted; this can be useful when creating a WDS configuration but
|
||||
@ -897,7 +897,7 @@ The
|
||||
.Ar interval
|
||||
parameter is specified in seconds.
|
||||
By default a background scan is considered every 300 seconds (5 minutes).
|
||||
The
|
||||
The
|
||||
.Ar interval
|
||||
may not be set to less than 15 seconds.
|
||||
.It Cm bintval Ar interval
|
||||
@ -998,19 +998,19 @@ and
|
||||
.Cm t
|
||||
(Atheros Dynamic Turbo mode, or appended to ``st'' and ``dt'').
|
||||
The full set of channel widths following a '/' are:
|
||||
.Cm 5
|
||||
.Cm 5
|
||||
(5MHz aka quarter-rate channel),
|
||||
.Cm 10
|
||||
.Cm 10
|
||||
(10MHz aka half-rate channel),
|
||||
.Cm 20
|
||||
.Cm 20
|
||||
(20MHz mostly for use in specifying ht20),
|
||||
and
|
||||
.Cm 40
|
||||
.Cm 40
|
||||
(40MHz mostly for use in specifying ht40).
|
||||
In addition,
|
||||
a 40MHz HT channel specification may include the location
|
||||
of the extension channel by appending ``+'' or ``-'' for above and below,
|
||||
respectively; e.g. ``2437:ht/40+'' specifies 40MHz wide HT operation
|
||||
respectively; e.g. ``2437:ht/40+'' specifies 40MHz wide HT operation
|
||||
with the center channel at frequency 2437 and the extension channel above.
|
||||
.It Cm country Ar name
|
||||
Set the country code to use in calculating the regulatory constraints
|
||||
@ -2021,7 +2021,7 @@ Nodes on the mesh without a path to this root mesh station with try to
|
||||
discover a path to us.
|
||||
.El
|
||||
By default
|
||||
.Cm hwmprootmode
|
||||
.Cm hwmprootmode
|
||||
is set to
|
||||
.Ar DISABLED .
|
||||
.It Cm hwmpmaxhops Ar cnt
|
||||
@ -2569,7 +2569,7 @@ For example, the values of 802.11 WEP keys and
|
||||
passphrases will be printed, if accessible to the current user.
|
||||
This information is not printed by default, as it may be considered
|
||||
sensitive.
|
||||
.Pp
|
||||
.Pp
|
||||
If the network interface driver is not present in the kernel then
|
||||
.Nm
|
||||
will attempt to load it.
|
||||
|
||||
104
sbin/ipfw/ipfw.8
104
sbin/ipfw/ipfw.8
@ -560,7 +560,7 @@ is set to 0 (default), one can use
|
||||
.Xr bpf 4
|
||||
attached to the
|
||||
.Li ipfw0
|
||||
pseudo interface. There is no overhead if no
|
||||
pseudo interface. There is no overhead if no
|
||||
.Xr bpf 4
|
||||
is attached to the pseudo interface.
|
||||
.Pp
|
||||
@ -808,13 +808,13 @@ Skip all subsequent rules numbered less than
|
||||
The search continues with the first rule numbered
|
||||
.Ar number
|
||||
or higher.
|
||||
It is possible to use the
|
||||
It is possible to use the
|
||||
.Cm tablearg
|
||||
keyword with a skipto for a
|
||||
keyword with a skipto for a
|
||||
.Em computed
|
||||
skipto, but care should be used, as no destination caching
|
||||
is possible in this case so the rules are always walked to find it,
|
||||
starting from the
|
||||
starting from the
|
||||
.Cm skipto .
|
||||
.It Cm call Ar number | tablearg
|
||||
The current rule number is saved in the internal stack and
|
||||
@ -943,7 +943,7 @@ in any subsequent forwarding decisions.
|
||||
Initially this is limited to the values 0 through 15, see
|
||||
.Xr setfib 1 .
|
||||
Processing continues at the next rule.
|
||||
It is possible to use the
|
||||
It is possible to use the
|
||||
.Cm tablearg
|
||||
keyword with a setfib. If tablearg value is not within compiled FIB range packet fib is set to 0.
|
||||
.It Cm reass
|
||||
@ -964,7 +964,7 @@ the maximum number of fragments per packet (default: 16).
|
||||
NOTA BENE: since fragments do not contain port numbers, they should be avoided with the
|
||||
.Nm reass
|
||||
rule.
|
||||
Alternatively, direction-based (like
|
||||
Alternatively, direction-based (like
|
||||
.Nm in
|
||||
/
|
||||
.Nm out
|
||||
@ -1799,7 +1799,7 @@ When used with the
|
||||
.Cm skipto
|
||||
action, the user should be aware that the code will walk the ruleset
|
||||
up to a rule equal to, or past, the given number, and should therefore try keep the
|
||||
ruleset compact between the skipto and the target rules.
|
||||
ruleset compact between the skipto and the target rules.
|
||||
.Sh SETS OF RULES
|
||||
Each rule belongs to one of 32 different
|
||||
.Em sets
|
||||
@ -2471,9 +2471,9 @@ support in-kernel NAT using the kernel version of
|
||||
The nat configuration command is the following:
|
||||
.Bd -ragged -offset indent
|
||||
.Bk -words
|
||||
.Cm nat
|
||||
.Ar nat_number
|
||||
.Cm config
|
||||
.Cm nat
|
||||
.Ar nat_number
|
||||
.Cm config
|
||||
.Ar nat-configuration
|
||||
.Ek
|
||||
.Ed
|
||||
@ -2525,7 +2525,7 @@ section below for more information on lookup tables.
|
||||
.El
|
||||
.Pp
|
||||
To let the packet continue after being (de)aliased, set the sysctl variable
|
||||
.Va net.inet.ip.fw.one_pass
|
||||
.Va net.inet.ip.fw.one_pass
|
||||
to 0.
|
||||
For more information about aliasing modes, refer to
|
||||
.Xr libalias 3 .
|
||||
@ -2534,7 +2534,7 @@ See Section
|
||||
for some examples about nat usage.
|
||||
.Ss REDIRECT AND LSNAT SUPPORT IN IPFW
|
||||
Redirect and LSNAT support follow closely the syntax used in
|
||||
.Xr natd 8 .
|
||||
.Xr natd 8 .
|
||||
See Section
|
||||
.Sx EXAMPLES
|
||||
for some examples on how to do redirect and lsnat.
|
||||
@ -2542,16 +2542,16 @@ for some examples on how to do redirect and lsnat.
|
||||
SCTP nat can be configured in a similar manner to TCP through the
|
||||
.Nm
|
||||
command line tool.
|
||||
The main difference is that
|
||||
.Nm sctp nat
|
||||
The main difference is that
|
||||
.Nm sctp nat
|
||||
does not do port translation.
|
||||
Since the local and global side ports will be the same,
|
||||
there is no need to specify both.
|
||||
Ports are redirected as follows:
|
||||
.Bd -ragged -offset indent
|
||||
.Bk -words
|
||||
.Cm nat
|
||||
.Ar nat_number
|
||||
.Cm nat
|
||||
.Ar nat_number
|
||||
.Cm config if
|
||||
.Ar nic
|
||||
.Cm redirect_port sctp
|
||||
@ -2569,9 +2569,9 @@ change for new
|
||||
.Nm nat
|
||||
instances.
|
||||
See
|
||||
.Sx SYSCTL VARIABLES
|
||||
.Sx SYSCTL VARIABLES
|
||||
for more info.
|
||||
.Sh LOADER TUNABLES
|
||||
.Sh LOADER TUNABLES
|
||||
Tunables can be set in
|
||||
.Xr loader 8
|
||||
prompt,
|
||||
@ -2599,15 +2599,15 @@ These are shown below together with their default value
|
||||
command what value is actually in use) and meaning:
|
||||
.Bl -tag -width indent
|
||||
.It Va net.inet.ip.alias.sctp.accept_global_ootb_addip: No 0
|
||||
Defines how the
|
||||
.Nm nat
|
||||
Defines how the
|
||||
.Nm nat
|
||||
responds to receipt of global OOTB ASCONF-AddIP:
|
||||
.Bl -tag -width indent
|
||||
.It Cm 0
|
||||
No response (unless a partially matching association exists -
|
||||
ports and vtags match but global address does not)
|
||||
.It Cm 1
|
||||
.Nm nat
|
||||
.Nm nat
|
||||
will accept and process all OOTB global AddIP messages.
|
||||
.El
|
||||
.Pp
|
||||
@ -2617,18 +2617,18 @@ establish multiple fake associations by sending AddIP messages.
|
||||
.It Va net.inet.ip.alias.sctp.chunk_proc_limit: No 5
|
||||
Defines the maximum number of chunks in an SCTP packet that will be parsed for a
|
||||
packet that matches an existing association.
|
||||
This value is enforced to be greater or equal than
|
||||
.Cm net.inet.ip.alias.sctp.initialising_chunk_proc_limit .
|
||||
This value is enforced to be greater or equal than
|
||||
.Cm net.inet.ip.alias.sctp.initialising_chunk_proc_limit .
|
||||
A high value is
|
||||
a DoS risk yet setting too low a value may result in important control chunks in
|
||||
the packet not being located and parsed.
|
||||
.It Va net.inet.ip.alias.sctp.error_on_ootb: No 1
|
||||
Defines when the
|
||||
.Nm nat
|
||||
.Nm nat
|
||||
responds to any Out-of-the-Blue (OOTB) packets with ErrorM packets.
|
||||
An OOTB packet is a packet that arrives with no existing association
|
||||
registered in the
|
||||
.Nm nat
|
||||
.Nm nat
|
||||
and is not an INIT or ASCONF-AddIP packet:
|
||||
.Bl -tag -width indent
|
||||
.It Cm 0
|
||||
@ -2638,8 +2638,8 @@ ErrorM is only sent to OOTB packets received on the local side.
|
||||
.It Cm 2
|
||||
ErrorM is sent to the local side and on the global side ONLY if there is a
|
||||
partial match (ports and vtags match but the source global IP does not).
|
||||
This value is only useful if the
|
||||
.Nm nat
|
||||
This value is only useful if the
|
||||
.Nm nat
|
||||
is tracking global IP addresses.
|
||||
.It Cm 3
|
||||
ErrorM is sent in response to all OOTB packets on both the local and global side
|
||||
@ -2650,24 +2650,24 @@ At the moment the default is 0, since the ErrorM packet is not yet
|
||||
supported by most SCTP stacks.
|
||||
When it is supported, and if not tracking
|
||||
global addresses, we recommend setting this value to 1 to allow
|
||||
multi-homed local hosts to function with the
|
||||
multi-homed local hosts to function with the
|
||||
.Nm nat .
|
||||
To track global addresses, we recommend setting this value to 2 to
|
||||
allow global hosts to be informed when they need to (re)send an
|
||||
ASCONF-AddIP.
|
||||
Value 3 should never be chosen (except for debugging) as the
|
||||
.Nm nat
|
||||
.Nm nat
|
||||
will respond to all OOTB global packets (a DoS risk).
|
||||
.It Va net.inet.ip.alias.sctp.hashtable_size: No 2003
|
||||
Size of hash tables used for
|
||||
.Nm nat
|
||||
lookups (100 < prime_number > 1000001).
|
||||
This value sets the
|
||||
.Nm hash table
|
||||
size for any future created
|
||||
Size of hash tables used for
|
||||
.Nm nat
|
||||
lookups (100 < prime_number > 1000001).
|
||||
This value sets the
|
||||
.Nm hash table
|
||||
size for any future created
|
||||
.Nm nat
|
||||
instance and therefore must be set prior to creating a
|
||||
.Nm nat
|
||||
instance and therefore must be set prior to creating a
|
||||
.Nm nat
|
||||
instance.
|
||||
The table sizes may be changed to suit specific needs.
|
||||
If there will be few
|
||||
@ -2696,7 +2696,7 @@ risk as malformed packets can consume processing resources.
|
||||
Defines the maximum number of parameters within a chunk that will be parsed in a
|
||||
packet.
|
||||
As for other similar sysctl variables, larger values pose a DoS risk.
|
||||
.It Va net.inet.ip.alias.sctp.log_level: No 0
|
||||
.It Va net.inet.ip.alias.sctp.log_level: No 0
|
||||
Level of detail in the system log messages (0 \- minimal, 1 \- event,
|
||||
2 \- info, 3 \- detail, 4 \- debug, 5 \- max debug). May be a good
|
||||
option in high loss environments.
|
||||
@ -2704,8 +2704,8 @@ option in high loss environments.
|
||||
Timeout value while waiting for SHUTDOWN-COMPLETE.
|
||||
This value cannot be 0.
|
||||
.It Va net.inet.ip.alias.sctp.track_global_addresses: No 0
|
||||
Enables/disables global IP address tracking within the
|
||||
.Nm nat
|
||||
Enables/disables global IP address tracking within the
|
||||
.Nm nat
|
||||
and places an
|
||||
upper limit on the number of addresses tracked for each association:
|
||||
.Bl -tag -width indent
|
||||
@ -2718,16 +2718,16 @@ association is limited to this value
|
||||
.Pp
|
||||
This variable is fully dynamic, the new value will be adopted for all newly
|
||||
arriving associations, existing associations are treated as they were previously.
|
||||
Global tracking will decrease the number of collisions within the
|
||||
.Nm nat
|
||||
Global tracking will decrease the number of collisions within the
|
||||
.Nm nat
|
||||
at a cost
|
||||
of increased processing load, memory usage, complexity, and possible
|
||||
.Nm nat
|
||||
of increased processing load, memory usage, complexity, and possible
|
||||
.Nm nat
|
||||
state
|
||||
problems in complex networks with multiple
|
||||
.Nm nats .
|
||||
problems in complex networks with multiple
|
||||
.Nm nats .
|
||||
We recommend not tracking
|
||||
global IP addresses, this will still result in a fully functional
|
||||
global IP addresses, this will still result in a fully functional
|
||||
.Nm nat .
|
||||
.It Va net.inet.ip.alias.sctp.up_timer: No 300
|
||||
Timeout value to keep an association up with no traffic.
|
||||
@ -3173,7 +3173,7 @@ First redirect all the traffic to nat instance 123:
|
||||
.Pp
|
||||
Then to configure nat instance 123 to alias all the outgoing traffic with ip
|
||||
192.168.0.123, blocking all incoming connections, trying to keep
|
||||
same ports on both sides, clearing aliasing table on address change
|
||||
same ports on both sides, clearing aliasing table on address change
|
||||
and keeping a log of traffic/link statistics:
|
||||
.Pp
|
||||
.Dl "ipfw nat 123 config ip 192.168.0.123 log deny_in reset same_ports"
|
||||
@ -3202,7 +3202,7 @@ Or a redirect rule with mixed modes could looks like:
|
||||
.Dl " redirect_proto udp 192.168.1.43 192.168.1.1"
|
||||
.Dl " redirect_addr 192.168.0.10,192.168.0.11"
|
||||
.Dl " 10.0.0.100 # LSNAT"
|
||||
.Dl " redirect_port tcp 192.168.0.1:80,192.168.0.10:22"
|
||||
.Dl " redirect_port tcp 192.168.0.1:80,192.168.0.10:22"
|
||||
.Dl " 500 # LSNAT"
|
||||
.Pp
|
||||
or it could be split in:
|
||||
@ -3210,7 +3210,7 @@ or it could be split in:
|
||||
.Dl "ipfw nat 1 config redirect_addr 10.0.0.1 10.0.0.66"
|
||||
.Dl "ipfw nat 2 config redirect_port tcp 192.168.0.1:80 500"
|
||||
.Dl "ipfw nat 3 config redirect_proto udp 192.168.1.43 192.168.1.1"
|
||||
.Dl "ipfw nat 4 config redirect_addr 192.168.0.10,192.168.0.11,192.168.0.12"
|
||||
.Dl "ipfw nat 4 config redirect_addr 192.168.0.10,192.168.0.11,192.168.0.12"
|
||||
.Dl " 10.0.0.100"
|
||||
.Dl "ipfw nat 5 config redirect_port tcp"
|
||||
.Dl " 192.168.0.1:80,192.168.0.10:22,192.168.0.20:25 500"
|
||||
@ -3330,8 +3330,8 @@ Rule syntax is subject to the command line environment and some patterns
|
||||
may need to be escaped with the backslash character
|
||||
or quoted appropriately.
|
||||
.Pp
|
||||
Due to the architecture of
|
||||
.Xr libalias 3 ,
|
||||
Due to the architecture of
|
||||
.Xr libalias 3 ,
|
||||
ipfw nat is not compatible with the TCP segmentation offloading (TSO).
|
||||
Thus, to reliably nat your network traffic, please disable TSO
|
||||
on your NICs using
|
||||
|
||||
@ -40,7 +40,7 @@ driver
|
||||
.Op Fl a Ar maxcontig
|
||||
.Op Fl b Ar block-size
|
||||
.Op Fl c Ar blocks-per-cylinder-group
|
||||
.Op Fl d Ar max-extent-size
|
||||
.Op Fl d Ar max-extent-size
|
||||
.Op Fl E Ar path-mdconfig
|
||||
.Op Fl e Ar maxbpg
|
||||
.Op Fl F Ar file
|
||||
@ -75,8 +75,8 @@ was specified) using
|
||||
.Xr newfs 8 ,
|
||||
and mounts it using
|
||||
.Xr mount 8 .
|
||||
It can handle
|
||||
.Xr geom_uzip 4
|
||||
It can handle
|
||||
.Xr geom_uzip 4
|
||||
compressed disk images, as long as the kernel supports this GEOM class.
|
||||
All the command line options are passed to the appropriate program
|
||||
at the appropriate stage in order to achieve the desired effect.
|
||||
@ -318,7 +318,7 @@ do not use soft-updates on it and mount it
|
||||
.Pp
|
||||
.Dl "mdmfs -M -S -o async -s 16m md1 /tmp"
|
||||
.Pp
|
||||
Create and mount a
|
||||
Create and mount a
|
||||
.Xr geom_uzip 4
|
||||
based compressed disk image:
|
||||
.Pp
|
||||
|
||||
@ -366,7 +366,7 @@ there is no way that delete and rename operations on lower layer
|
||||
objects can be done.
|
||||
.Er EOPNOTSUPP
|
||||
is returned for this kind of operations as generated by VOP_WHITEOUT()
|
||||
along with any others which would make modifications to the lower
|
||||
along with any others which would make modifications to the lower
|
||||
layer, such as
|
||||
.Xr chmod 1 .
|
||||
.Pp
|
||||
|
||||
@ -428,8 +428,8 @@ The
|
||||
.Nm
|
||||
utility returns 0 on success (the host is alive),
|
||||
2 if the transmission was successful but no responses were received,
|
||||
any other non-zero value if the arguments are incorrect or
|
||||
another error has occurred.
|
||||
any other non-zero value if the arguments are incorrect or
|
||||
another error has occurred.
|
||||
.Sh EXAMPLES
|
||||
Normally,
|
||||
.Nm
|
||||
|
||||
@ -158,7 +158,7 @@ with the variable
|
||||
.Ar enable_quotas
|
||||
in
|
||||
.Pa /etc/rc.conf .
|
||||
The kernel must also be built with
|
||||
The kernel must also be built with
|
||||
.Cd "options QUOTA" .
|
||||
.Pp
|
||||
The
|
||||
|
||||
@ -181,7 +181,7 @@ if your script has a
|
||||
.Dq Li REQUIRE
|
||||
on
|
||||
.Dq Li named ,
|
||||
it means the script must be placed after the
|
||||
it means the script must be placed after the
|
||||
.Dq Li named
|
||||
script in the dependency ordering,
|
||||
not necessarily that it requires
|
||||
|
||||
@ -119,7 +119,7 @@ or the attribute specified by it is
|
||||
.It Bq Er EINVAL
|
||||
The
|
||||
.Fa cpusetp
|
||||
specified a CPU that was outside the set supported by the kernel.
|
||||
specified a CPU that was outside the set supported by the kernel.
|
||||
.It Bq Er ERANGE
|
||||
The
|
||||
.Fa cpusetsize
|
||||
|
||||
@ -83,8 +83,8 @@ is invalid.
|
||||
The system time has reached or exceeded the time specified in
|
||||
.Fa abstime .
|
||||
.It Bq Er EPERM
|
||||
The specified
|
||||
.Fa mutex
|
||||
The specified
|
||||
.Fa mutex
|
||||
was not locked by the calling thread.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
|
||||
@ -72,8 +72,8 @@ or the value specified by
|
||||
.Fa mutex
|
||||
is invalid.
|
||||
.It Bq Er EPERM
|
||||
The specified
|
||||
.Fa mutex
|
||||
The specified
|
||||
.Fa mutex
|
||||
was not locked by the calling thread.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
|
||||
@ -93,7 +93,7 @@ WWAN on air status changed to 1 (on air)
|
||||
.El
|
||||
.Ss Xr devfs 8 Ss Device
|
||||
You can read /dev/hpcmi to see your current BIOS settings.
|
||||
The detail level can be adjusted by setting the sysctl
|
||||
The detail level can be adjusted by setting the sysctl
|
||||
.Va cmi_detail
|
||||
as described below.
|
||||
.Sh SYSCTL VARIABLES
|
||||
@ -101,7 +101,7 @@ The following sysctls are currently implemented:
|
||||
.Ss WLAN:
|
||||
.Bl -tag -width indent
|
||||
.It Va dev.acpi_hp.0.wlan_enabled
|
||||
Toggle WLAN chip activity.
|
||||
Toggle WLAN chip activity.
|
||||
.It Va dev.acpi_hp.0.wlan_radio
|
||||
(read-only)
|
||||
WLAN radio status (controlled by hardware switch)
|
||||
@ -116,7 +116,7 @@ If set to 1, the WLAN chip will be disabled if the radio is turned off
|
||||
.Ss Bluetooth:
|
||||
.Bl -tag -width indent
|
||||
.It Va dev.acpi_hp.0.bt_enabled
|
||||
Toggle Bluetooth chip activity.
|
||||
Toggle Bluetooth chip activity.
|
||||
.It Va dev.acpi_hp.0.bt_radio
|
||||
(read-only)
|
||||
Bluetooth radio status (controlled by hardware switch)
|
||||
@ -131,7 +131,7 @@ If set to 1, the Bluetooth chip will be disabled if the radio is turned off
|
||||
.Ss WWAN:
|
||||
.Bl -tag -width indent
|
||||
.It Va dev.acpi_hp.0.wwan_enabled
|
||||
Toggle WWAN chip activity.
|
||||
Toggle WWAN chip activity.
|
||||
.It Va dev.acpi_hp.0.wwan_radio
|
||||
(read-only)
|
||||
WWAN radio status (controlled by hardware switch)
|
||||
@ -229,14 +229,14 @@ Get BIOS settings:
|
||||
.Bd -literal -offset indent
|
||||
cat /dev/hpcmi
|
||||
|
||||
Serial Port Disable
|
||||
Infrared Port Enable
|
||||
Parallel Port Disable
|
||||
Flash Media Reader Disable
|
||||
USB Ports including Express Card slot Enable
|
||||
1394 Port Enable
|
||||
Cardbus Slot Disable
|
||||
Express Card Slot Disable
|
||||
Serial Port Disable
|
||||
Infrared Port Enable
|
||||
Parallel Port Disable
|
||||
Flash Media Reader Disable
|
||||
USB Ports including Express Card slot Enable
|
||||
1394 Port Enable
|
||||
Cardbus Slot Disable
|
||||
Express Card Slot Disable
|
||||
(...)
|
||||
.Ed
|
||||
.Pp
|
||||
|
||||
@ -47,7 +47,7 @@ acpi_wmi_load="YES"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Nm
|
||||
driver provides an interface for vendor specific WMI implementations
|
||||
driver provides an interface for vendor specific WMI implementations
|
||||
(e.g. HP and Acer laptops).
|
||||
It creates /dev/wmistat%d, which can be read to get
|
||||
information about GUIDs found in the system.
|
||||
|
||||
@ -121,7 +121,7 @@ seconds.
|
||||
.It Va kern.cam.ada.spindown_shutdown
|
||||
.Pp
|
||||
This variable determines whether to spin-down disks when shutting down.
|
||||
Set to 1 to enable spin-down, 0 to disable.
|
||||
Set to 1 to enable spin-down, 0 to disable.
|
||||
The default is currently enabled.
|
||||
.It Va kern.cam.ada.write_cache
|
||||
.It Va kern.cam.ada. Ns Ar X Ns Va .write_cache
|
||||
|
||||
@ -90,15 +90,15 @@ dev.aibs.0.fan.0: 878 600 7200
|
||||
dev.aibs.0.fan.1: 0 700 7200
|
||||
.Pp
|
||||
> sysctl -d dev.aibs.0.{volt,temp,fan}
|
||||
dev.aibs.0.volt:
|
||||
dev.aibs.0.volt:
|
||||
dev.aibs.0.volt.0: Vcore Voltage
|
||||
dev.aibs.0.volt.1: +3.3 Voltage
|
||||
dev.aibs.0.volt.2: +5 Voltage
|
||||
dev.aibs.0.volt.3: +12 Voltage
|
||||
dev.aibs.0.temp:
|
||||
dev.aibs.0.temp:
|
||||
dev.aibs.0.temp.0: CPU Temperature
|
||||
dev.aibs.0.temp.1: MB Temperature
|
||||
dev.aibs.0.fan:
|
||||
dev.aibs.0.fan:
|
||||
dev.aibs.0.fan.0: CPU FAN Speed
|
||||
dev.aibs.0.fan.1: CHASSIS FAN Speed
|
||||
.Ed
|
||||
|
||||
@ -129,14 +129,14 @@ use on cards that use a 5212 part.
|
||||
When multiple interfaces are configured each may have a separate
|
||||
mac address that is formed by setting the U/L bits in the mac
|
||||
address assigned to the underlying device.
|
||||
Any number of
|
||||
Any number of
|
||||
.Cm wds
|
||||
virtual interfaces may be configured together with
|
||||
.Cm hostap
|
||||
interfaces.
|
||||
Multiple
|
||||
.Cm station
|
||||
interfaces may be operated together with
|
||||
interfaces may be operated together with
|
||||
.Cm hostap
|
||||
interfaces to construct a wireless repeater device.
|
||||
The driver also support
|
||||
@ -191,7 +191,7 @@ the fxp0 (wired) device:
|
||||
.Bd -literal -offset indent
|
||||
ifconfig wlan0 create wlandev ath0 wlanmode hostap \e
|
||||
ssid paying-customers wepmode on wepkey 0x1234567890 \e
|
||||
mode 11a up
|
||||
mode 11a up
|
||||
ifconfig wlan1 create wlandev ath0 wlanmode hostap bssid \e
|
||||
ssid freeloaders up
|
||||
ifconfig bridge0 create addm wlan0 addm wlan1 addm fxp0 up
|
||||
@ -202,7 +202,7 @@ Create a master node in a two slot TDMA BSS configured to use
|
||||
.Bd -literal -offset indent
|
||||
ifconfig wlan0 create wlandev ath0 wlanmode tdma \e
|
||||
ssid tdma-test tmdaslot 0 tdmaslotlen 2500 \e
|
||||
channel 36 up
|
||||
channel 36 up
|
||||
.Ed
|
||||
.Sh DIAGNOSTICS
|
||||
.Bl -diag
|
||||
|
||||
@ -98,7 +98,7 @@ Core2 Duo MacBook3,1 (IDs: 0x0229, 0x022a, 0x022b)
|
||||
.El
|
||||
.Pp
|
||||
To discover the product\-id of a touchpad, search for 'Trackpad' in the
|
||||
output of
|
||||
output of
|
||||
.Xr lshal 1
|
||||
and look up the property
|
||||
.Nm usb_device.product_id .
|
||||
@ -108,7 +108,7 @@ creates a blocking pseudo\-device file,
|
||||
.Pa /dev/atp0 ,
|
||||
which presents the mouse as a
|
||||
.Ar sysmouse
|
||||
or
|
||||
or
|
||||
.Ar mousesystems
|
||||
type device\-\-see
|
||||
.Xr moused 8
|
||||
@ -117,7 +117,7 @@ types.
|
||||
.Xr moused 8
|
||||
can be configured to read touchpad data from
|
||||
.Pa /dev/atp0
|
||||
and pass it along to the
|
||||
and pass it along to the
|
||||
.Xr sysmouse 4
|
||||
driver so that any process wanting to utilize mouse operation (such as
|
||||
an X server) may fetch it from
|
||||
|
||||
@ -187,7 +187,7 @@ Subsystem specifies vhid and name of interface, where event occurred.
|
||||
Type of the message displays new state of vhid.
|
||||
Please see
|
||||
.Xr devd.conf 5
|
||||
and
|
||||
and
|
||||
.Sx EXAMPLES
|
||||
section for more information.
|
||||
.Sh EXAMPLES
|
||||
|
||||
@ -28,7 +28,7 @@
|
||||
.Dt CODA 4
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm coda
|
||||
.Nm coda
|
||||
.Nd Coda Distributed File System
|
||||
.Sh SYNOPSIS
|
||||
To compile this driver into the kernel,
|
||||
|
||||
@ -103,7 +103,7 @@ support on top of it.
|
||||
.Xr bpf 4 ,
|
||||
.Xr if_bridge 4 ,
|
||||
.Xr vlan 4 ,
|
||||
.Xr loader.conf 5 ,
|
||||
.Xr loader.conf 5 ,
|
||||
.Xr rc.conf 5 ,
|
||||
.Xr ifconfig 8
|
||||
.Sh HISTORY
|
||||
|
||||
@ -53,13 +53,13 @@ The
|
||||
driver provides support for the GMAC Ethernet hardware found mostly in
|
||||
the last Apple PowerBooks G3s and most G4-based Apple hardware, as
|
||||
well as Sun UltraSPARC machines.
|
||||
.Pp
|
||||
All controllers supported by the
|
||||
.Nm
|
||||
driver have TCP checksum offload capability for both receive and transmit,
|
||||
support for the reception and transmission of extended frames for
|
||||
.Xr vlan 4
|
||||
and a 512-bit multicast hash filter.
|
||||
.Pp
|
||||
All controllers supported by the
|
||||
.Nm
|
||||
driver have TCP checksum offload capability for both receive and transmit,
|
||||
support for the reception and transmission of extended frames for
|
||||
.Xr vlan 4
|
||||
and a 512-bit multicast hash filter.
|
||||
.Sh HARDWARE
|
||||
Chips supported by the
|
||||
.Nm
|
||||
|
||||
@ -337,4 +337,4 @@ Incoming packets with a different key or without a key will be treated as if the
|
||||
would belong to this interface.
|
||||
.Pp
|
||||
RFC1701 is not fully supported, however all unsupported features have been
|
||||
deprecated in RFC2784.
|
||||
deprecated in RFC2784.
|
||||
|
||||
@ -63,7 +63,7 @@ If the
|
||||
.Ar port
|
||||
and
|
||||
.Ar spacing
|
||||
are not specified the interface type default will be used. Only specify
|
||||
are not specified the interface type default will be used. Only specify
|
||||
either the
|
||||
.Ar port
|
||||
for I/O access or
|
||||
|
||||
@ -127,7 +127,7 @@ This should not happen.
|
||||
The driver failed to load the firmware image using the
|
||||
.Xr firmware 9
|
||||
subsystem.
|
||||
Verify the
|
||||
Verify the
|
||||
.Xr ipwfw 4
|
||||
firmware module is installed and the license agreement
|
||||
.Xr loader 8
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
.\"
|
||||
.\"
|
||||
.\" Copyright (c) 2012 Intel Corporation
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
@ -13,7 +13,7 @@
|
||||
.\" ("Disclaimer") and any redistribution must be conditioned upon
|
||||
.\" including a substantially similar Disclaimer requirement for further
|
||||
.\" binary redistribution.
|
||||
.\"
|
||||
.\"
|
||||
.\" NO WARRANTY
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||||
.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||
@ -26,7 +26,7 @@
|
||||
.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
||||
.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
.\" POSSIBILITY OF SUCH DAMAGES.
|
||||
.\"
|
||||
.\"
|
||||
.\" isci driver man page.
|
||||
.\"
|
||||
.\" Author: Jim Harris <jimharris@FreeBSD.org>
|
||||
@ -86,7 +86,7 @@ These can be enabled by adding
|
||||
options ISCI_LOGGING
|
||||
.Ed
|
||||
.Pp
|
||||
to the kernel configuration file.
|
||||
to the kernel configuration file.
|
||||
.Sh SEE ALSO
|
||||
.Xr cd 4 ,
|
||||
.Xr ch 4 ,
|
||||
|
||||
@ -79,7 +79,7 @@ the IP address of the target of session
|
||||
statistics for session
|
||||
.Em n
|
||||
.It Va net.iscsi.n.pid
|
||||
the
|
||||
the
|
||||
.Em "process id"
|
||||
of the userland side of session
|
||||
.Em n ,
|
||||
@ -87,7 +87,7 @@ see
|
||||
.Xr iscontrol 8 .
|
||||
.El
|
||||
.Sh FILES
|
||||
The
|
||||
The
|
||||
.Nm
|
||||
driver creates the following:
|
||||
.Pp
|
||||
|
||||
@ -127,7 +127,7 @@ This should not happen.
|
||||
The driver failed to load the firmware image using the
|
||||
.Xr firmware 9
|
||||
subsystem.
|
||||
Verify the
|
||||
Verify the
|
||||
.Xr iwifw 4
|
||||
firmware module is installed and the license agreement
|
||||
.Xr loader 8
|
||||
|
||||
@ -151,7 +151,7 @@ This should not happen.
|
||||
The driver failed to load the firmware image using the
|
||||
.Xr firmware 9
|
||||
subsystem.
|
||||
Verify the
|
||||
Verify the
|
||||
.Xr iwnfw 4
|
||||
firmware module is present.
|
||||
.It "iwn%d: could not load boot firmware"
|
||||
|
||||
@ -65,7 +65,7 @@ iwn6050fw_load="YES"
|
||||
.Ed
|
||||
.Sh DESCRIPTION
|
||||
This module provides access to firmware sets for the
|
||||
Intel Wireless WiFi Link 4965, 1000, 5000 and 6000 series of
|
||||
Intel Wireless WiFi Link 4965, 1000, 5000 and 6000 series of
|
||||
IEEE 802.11n adapters.
|
||||
It may be
|
||||
statically linked into the kernel, or loaded as a module.
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
.\" Copyright (c) 2001-2008, Intel Corporation
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions are met:
|
||||
.\"
|
||||
@ -79,13 +79,13 @@ driver supports the following cards:
|
||||
.Pp
|
||||
.Bl -bullet -compact
|
||||
.It
|
||||
Intel(R) 10 Gigabit XF SR/AF Dual Port Server Adapter
|
||||
Intel(R) 10 Gigabit XF SR/AF Dual Port Server Adapter
|
||||
.It
|
||||
Intel(R) 10 Gigabit XF SR/LR Server Adapter
|
||||
.It
|
||||
Intel(R) 82598EB 10 Gigabit AF Network Connection
|
||||
.It
|
||||
Intel(R) 82598EB 10 Gigabit AT CX4 Network Connection
|
||||
Intel(R) 82598EB 10 Gigabit AT CX4 Network Connection
|
||||
.El
|
||||
.Sh DIAGNOSTICS
|
||||
.Bl -diag
|
||||
|
||||
@ -42,15 +42,15 @@
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Pa /dev/ksyms
|
||||
character device provides a read-only interface to a snapshot of the kernel
|
||||
character device provides a read-only interface to a snapshot of the kernel
|
||||
symbol table. The in-kernel symbol manager is designed to be able to handle
|
||||
many types of symbols tables, however, only
|
||||
many types of symbols tables, however, only
|
||||
.Xr elf 5
|
||||
symbol tables are supported by this device. The ELF format image contains two
|
||||
sections: a symbol table and a corresponding string table.
|
||||
sections: a symbol table and a corresponding string table.
|
||||
.Bl -tag -width indent -offset indent
|
||||
.It Dv Symbol Table
|
||||
The SYMTAB section contains the symbol table entries present in the current
|
||||
The SYMTAB section contains the symbol table entries present in the current
|
||||
running kernel, including the symbol table entries of any loaded modules. The
|
||||
symbols are ordered by the kernel module load time starting with kernel file
|
||||
symbols first, followed by the first loaded module's symbols and so on.
|
||||
@ -65,10 +65,10 @@ file represents the state of the kernel at the time when the device is opened.
|
||||
Since
|
||||
.Pa /dev/ksyms
|
||||
has no text or data, most of the fields are initialized to NULL.
|
||||
The
|
||||
.Nm
|
||||
The
|
||||
.Nm
|
||||
driver does not block the loading or unloading of modules into the kernel
|
||||
while the
|
||||
while the
|
||||
.Pa /dev/ksyms
|
||||
file is open but may contain stale data.
|
||||
.Sh IOCTLS
|
||||
@ -87,29 +87,29 @@ This can be used when allocating a buffer to make a copy of
|
||||
the kernel symbol table.
|
||||
.It Dv KIOCGADDR (void *)
|
||||
Returns the address of the kernel symbol table mapped in
|
||||
the process memory.
|
||||
the process memory.
|
||||
.El
|
||||
.Sh FILES
|
||||
.Bl -tag -width /dev/ksymsX
|
||||
.It Pa /dev/ksyms
|
||||
.El
|
||||
.Sh ERRORS
|
||||
An
|
||||
An
|
||||
.Xr open 2
|
||||
of
|
||||
.Pa /dev/ksyms
|
||||
will fail if:
|
||||
will fail if:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EBUSY
|
||||
The device is already open. A process must close
|
||||
The device is already open. A process must close
|
||||
.Pa /dev/ksyms
|
||||
before it can be opened again.
|
||||
before it can be opened again.
|
||||
.It Bq Er ENOMEM
|
||||
There is a resource shortage in the kernel.
|
||||
.It Bq Er ENXIO
|
||||
The driver was unsuccessful in creating a snapshot of the kernel symbol
|
||||
table. This may occur if the kernel was in the process of loading or
|
||||
unloading a module.
|
||||
unloading a module.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr ioctl 2 ,
|
||||
@ -128,7 +128,7 @@ The
|
||||
.Nm
|
||||
driver first appeared in
|
||||
.Fx 8.0
|
||||
to support
|
||||
to support
|
||||
.Xr lockstat 1 .
|
||||
.Sh AUTHORS
|
||||
The
|
||||
@ -137,7 +137,7 @@ driver was written by
|
||||
.An Stacey Son
|
||||
.Aq sson@FreeBSD.org .
|
||||
.Sh BUGS
|
||||
Because files can be dynamically linked into the kernel at any time the symbol
|
||||
Because files can be dynamically linked into the kernel at any time the symbol
|
||||
information can vary. When you open the
|
||||
.Pa /dev/ksyms
|
||||
file, you have access to an ELF image which represents a snapshot of the state of the kernel symbol information at that instant in time. Keeping the device open does not block the loading or unloading of kernel modules. To get a new snapshot you must close and re-open the device.
|
||||
@ -147,12 +147,12 @@ A process is only allowed to open the
|
||||
file once at a time. The process must close the
|
||||
.Pa /dev/ksyms
|
||||
before it is allowed to open it again.
|
||||
.Pp
|
||||
.Pp
|
||||
The
|
||||
.Nm
|
||||
driver uses the calling process' memory address space to store the snapshot.
|
||||
driver uses the calling process' memory address space to store the snapshot.
|
||||
.Xr ioctl 2
|
||||
can be used to get the memory address where the symbol table is stored to
|
||||
save kernel memory.
|
||||
save kernel memory.
|
||||
.Xr mmap 2
|
||||
may also be used but it will map it to another address.
|
||||
may also be used but it will map it to another address.
|
||||
|
||||
@ -171,7 +171,7 @@ the next invocation.
|
||||
enables logging of
|
||||
.Nm
|
||||
entries to disk if it is set to one.
|
||||
Setting this to 0 will terminate logging to disk and revert to
|
||||
Setting this to 0 will terminate logging to disk and revert to
|
||||
logging to the normal ktr ring buffer.
|
||||
Data is not sent to the ring buffer while logging to disk.
|
||||
.It Va debug.ktr.alq_max
|
||||
|
||||
@ -66,7 +66,7 @@ framework will fail to open the crypto session on the device if the AES
|
||||
key's length is != 128 bits.
|
||||
This prevents the use of the
|
||||
.Nm
|
||||
device driver with AES keys of length != 128 bits.
|
||||
device driver with AES keys of length != 128 bits.
|
||||
.Sh SEE ALSO
|
||||
.Xr crypto 4 ,
|
||||
.Xr intro 4 ,
|
||||
|
||||
@ -60,7 +60,7 @@ The
|
||||
.Nm
|
||||
driver sends events to
|
||||
.Xr devd 8
|
||||
for the following events under the
|
||||
for the following events under the
|
||||
.Cd PMU
|
||||
system, and
|
||||
.Cd keys
|
||||
|
||||
@ -63,15 +63,15 @@ The
|
||||
.Nm
|
||||
driver sends events to
|
||||
.Xr devd 8
|
||||
for the following events under the
|
||||
for the following events under the
|
||||
.Cd PMU
|
||||
system:
|
||||
.Pp
|
||||
.Bl -bullet -compact
|
||||
.It
|
||||
Power button -
|
||||
Power button -
|
||||
.Cd "Button"
|
||||
subsystem,
|
||||
subsystem,
|
||||
.Cd "pressed"
|
||||
type.
|
||||
.El
|
||||
@ -81,7 +81,7 @@ The
|
||||
driver supports the following sysctl variable for configuring the Fn keys:
|
||||
.Bl -tag -width indent
|
||||
.It Va dev.akbd.%d.fn_keys_function_as_primary
|
||||
Set the Fn keys to be their F-key type as default. A value of 0 causes the
|
||||
Set the Fn keys to be their F-key type as default. A value of 0 causes the
|
||||
F-keys keys to work as special keys by default (
|
||||
.Xr abtn 4 )
|
||||
and a value of 1 sets them to behave as F-keys by default.
|
||||
|
||||
@ -50,8 +50,8 @@ if_bm_load="YES"
|
||||
The
|
||||
.Nm
|
||||
driver provides support for the BMac ethernet hardware found mostly in
|
||||
G3-based Apple hardware.
|
||||
It is a close relative of the Sun HME controller found in contemporary
|
||||
G3-based Apple hardware.
|
||||
It is a close relative of the Sun HME controller found in contemporary
|
||||
Sun workstations.
|
||||
.Sh HARDWARE
|
||||
Chips supported by the
|
||||
|
||||
@ -46,7 +46,7 @@ driver provides support for the CUDA VIA (Versatile Interface Attachment)
|
||||
chip found in pre-Core99 Apple hardware, such as the Power Macintosh G3.
|
||||
.Pp
|
||||
The Apple CUDA controller is a multi-purpose ASIC that provides power
|
||||
control and an
|
||||
control and an
|
||||
.Xr adb 4
|
||||
interface.
|
||||
.Sh HARDWARE
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user