-.\" $OpenBSD: csh.1,v 1.85 2021/03/08 02:47:25 jsg Exp $
+.\" $OpenBSD: csh.1,v 1.86 2022/03/31 17:27:13 naddy Exp $
.\" $NetBSD: csh.1,v 1.10 1995/03/21 09:02:35 cgd Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\"
.\" @(#)csh.1 8.2 (Berkeley) 1/21/94
.\"
-.Dd $Mdocdate: March 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CSH 1
.Os
.Sh NAME
This sequence of words is placed on the command history list and parsed.
Finally each command in the current line is executed.
.Pp
-When a login shell terminates it executes commands from the files
+When a login shell terminates, it executes commands from the files
.Pa .logout
in the user's home directory and
.Pa /etc/csh.logout .
.El
.Pp
Unless preceded by a
-.Ql g
+.Ql g ,
the change is applied only to the first
modifiable word.
With substitutions, it is an error for no word to be applicable.
separated by blanks.
When the
.Ql :q
-modifier is applied to a substitution
+modifier is applied to a substitution,
the variable will expand to multiple words with each word separated
by a blank and quoted to prevent later command or filename substitution.
.Pp
.Ql \- .
The first word of a variable's value is numbered
.Ql 1 .
-If the first number of a range is omitted it defaults to
+If the first number of a range is omitted, it defaults to
.Ql 1 .
-If the last number of a range is omitted it defaults to
+If the last number of a range is omitted, it defaults to
.Ql $#name .
The selector
.Ql *
prompting with
.Ql \&?
before any statements in the loop are executed.
-If you make a mistake typing in a loop at the terminal you can rub it out.
+If you make a mistake typing in a loop at the terminal, you can rub it out.
.Pp
.It Ic glob Ar wordlist
Like
.It Ic time Ar command
With no argument, a summary of time used by this shell and its children
is printed.
-If arguments are given
+If arguments are given,
the specified simple command is timed and a time summary
as described under the
.Ic time
.Dq Pa ~
refers to this variable.
.It Ic ignoreeof
-If set the shell ignores
+If set, the shell ignores
end-of-file from input devices which are terminals.
This prevents shells from accidentally being killed by control-Ds.
.It Ic mail
an interactive terminal input.
If a
.Ql \&!
-appears in the string it will be replaced by the current event number
+appears in the string, it will be replaced by the current event number
unless a preceding
.Ql \e
is given.
after history substitution.
.El
.Ss Non-built-in command execution
-When a command to be executed is found to not be a built-in command
+When a command to be executed is found to not be a built-in command,
the shell attempts to execute the command via
.Xr execve 2 .
Each word in the variable
-.\" $OpenBSD: ksh.1,v 1.215 2021/05/04 21:03:30 naddy Exp $
+.\" $OpenBSD: ksh.1,v 1.216 2022/03/31 17:27:14 naddy Exp $
.\"
.\" Public Domain
.\"
-.Dd $Mdocdate: May 4 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt KSH 1
.Os
.Sh NAME
.Pp
If the
.Fl p
-option is given the output is slightly longer:
+option is given, the output is slightly longer:
.Bd -literal -offset indent
real 0.00
user 0.00
-.\" $OpenBSD: sh.1,v 1.153 2021/05/04 21:03:31 naddy Exp $
+.\" $OpenBSD: sh.1,v 1.154 2022/03/31 17:27:14 naddy Exp $
.\"
.\" Copyright (c) 2015 Jason McIntyre <jmc@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: May 4 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SH 1
.Os
.Sh NAME
.Ic 0 , ^ , $ ,
and
.Ic c .
-If the motion moves towards the beginning of the line
+If the motion moves towards the beginning of the line,
the character under the cursor is not deleted;
-if it moves towards the end of the line
+if it moves towards the end of the line,
it is deleted.
.It Ic C
Delete the characters between the cursor and the line end,
A special motion command,
.Ic d ,
may be used to delete the entire line.
-If the motion moves towards the beginning of the line
+If the motion moves towards the beginning of the line,
the character under the cursor is not deleted.
.It Oo Ar count Oc Ns Ic D
Delete the characters between the cursor and the line end,
A special motion command,
.Ic y ,
may be used to yank the entire line.
-If the motion moves towards the beginning of the line
+If the motion moves towards the beginning of the line,
the character under the cursor is not yanked.
.It Oo Ar count Oc Ns Ic Y
Yank (copy) the characters between the cursor and the line end,
-.\" $OpenBSD: pax.1,v 1.75 2020/01/16 16:46:46 schwarze Exp $
+.\" $OpenBSD: pax.1,v 1.76 2022/03/31 17:27:14 naddy Exp $
.\" $NetBSD: pax.1,v 1.3 1995/03/21 09:07:37 cgd Exp $
.\"
.\" Copyright (c) 1992 Keith Muller.
.\"
.\" @(#)pax.1 8.4 (Berkeley) 4/18/94
.\"
-.Dd $Mdocdate: January 16 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PAX 1
.Os
.Sh NAME
the standard input.
When a
.Ar file
-operand is also a directory the entire file
+operand is also a directory, the entire file
hierarchy rooted at that directory will be included.
The effect of the
.Em copy
-.\" $OpenBSD: tar.1,v 1.63 2020/10/05 05:52:19 jmc Exp $
+.\" $OpenBSD: tar.1,v 1.64 2022/03/31 17:27:14 naddy Exp $
.\"
.\" Copyright (c) 1996 SigmaSoft, Th. Lockert
.\" All rights reserved.
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 5 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TAR 1
.Os
.Sh NAME
Default tape device to use instead of
.Pa /dev/rst0 .
If set to hyphen
-.Pq Sq -
+.Pq Sq - ,
standard output is used.
.El
.Sh FILES
-.\" $OpenBSD: ps.1,v 1.124 2022/02/15 23:16:00 rob Exp $
+.\" $OpenBSD: ps.1,v 1.125 2022/03/31 17:27:14 naddy Exp $
.\" $NetBSD: ps.1,v 1.16 1996/03/21 01:36:28 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1991, 1993, 1994
.\"
.\" @(#)ps.1 8.3 (Berkeley) 4/18/94
.\"
-.Dd $Mdocdate: February 15 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PS 1
.Os
.Sh NAME
The CPU utilization of the process; this is a decaying average over up to
a minute of previous (real) time.
Since the time base over which this is computed varies (since processes may
-be very young) it is possible for the sum of all
+be very young), it is possible for the sum of all
.Cm %cpu
fields to exceed 100%.
.It Cm %mem
-.\" $OpenBSD: stty.1,v 1.48 2020/01/16 16:46:46 schwarze Exp $
+.\" $OpenBSD: stty.1,v 1.49 2022/03/31 17:27:14 naddy Exp $
.\" $NetBSD: stty.1,v 1.10 1995/09/07 06:57:14 jtc Exp $
.\"
.\" Copyright (c) 1990, 1993, 1994
.\"
.\" @(#)stty.1 8.5 (Berkeley) 6/1/94
.\"
-.Dd $Mdocdate: January 16 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt STTY 1
.Os
.Sh NAME
two character sequence
.Ql ^-
or the string
-.Dq undef
+.Dq undef ,
the control character
is disabled (i.e. set to
.Brq Dv _POSIX_VDISABLE ) .
-.\" $OpenBSD: boggle.6,v 1.21 2015/09/12 16:10:25 schwarze Exp $
+.\" $OpenBSD: boggle.6,v 1.22 2022/03/31 17:27:14 naddy Exp $
.\" $NetBSD: boggle.6,v 1.2 1995/03/21 12:14:35 cgd Exp $
.\"
.\" Copyright (c) 1997, Jason Downs. All rights reserved.
.\"
.\" @(#)boggle.6 8.1 (Berkeley) 6/11/93
.\"
-.Dd $Mdocdate: September 12 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BOGGLE 6
.Os
.Sh NAME
.Cm +
or
.Cm ++
-options the display of words found in the board doesn't clearly indicate
+options, the display of words found in the board doesn't clearly indicate
reused cubes.
-.\" $OpenBSD: canfield.6,v 1.12 2022/02/18 23:17:13 jsg Exp $
+.\" $OpenBSD: canfield.6,v 1.13 2022/03/31 17:27:14 naddy Exp $
.\" $NetBSD: canfield.6,v 1.4 1995/03/21 15:08:30 cgd Exp $
.\"
.\" Copyright (c) 1983, 1993
.\"
.\" @(#)canfield.6 8.1 (Berkeley) 5/31/93
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CANFIELD 6
.Os
.Sh NAME
.Nm canfield
to maintain card counting statistics
on the bottom of the screen.
-When properly used this can greatly increase one's chances of
+When properly used, this can greatly increase one's chances of
winning.
.Pp
The rules for betting are somewhat less strict than
-.\" $OpenBSD: fortune.6,v 1.16 2021/01/03 01:41:51 schwarze Exp $
+.\" $OpenBSD: fortune.6,v 1.17 2022/03/31 17:27:14 naddy Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)fortune.6 8.3 (Berkeley) 4/19/94
.\"
-.Dd $Mdocdate: January 3 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FORTUNE 6
.Os
.Sh NAME
.Sh DESCRIPTION
When
.Nm
-is run with no arguments it prints out a random epigram.
+is run with no arguments, it prints out a random epigram.
Epigrams are divided into several categories, where each category
is subdivided into those which are potentially offensive and those
which are not.
-.\" $OpenBSD: phantasia.6tbl,v 1.11 2022/02/18 23:17:14 jsg Exp $
+.\" $OpenBSD: phantasia.6tbl,v 1.12 2022/03/31 17:27:15 naddy Exp $
.\" $NetBSD: phantasia.6,v 1.9 2002/09/26 18:32:03 wiz Exp $
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PHANTASIA 6
.Os
.Sh NAME
.br
Used while combating monsters.
Has a 25% chance of working.
-If it works it hits the monster just enough to kill it.
+If it works, it hits the monster just enough to kill it.
If it fails, it doesn't hit the monster, and doubles the monster's
.Em quickness
and
.Em brains ,
and the monster's
.Em experience .
-If it fails the player is transported instead.
+If it fails, the player is transported instead.
60% of the time, the monster will drop any treasure it was carrying.
.It Ic paralyze
.Em magic level necessary :
-.\" $OpenBSD: worms.6,v 1.15 2012/05/27 16:57:14 jmc Exp $
+.\" $OpenBSD: worms.6,v 1.16 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1989, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)worms.6 8.1 (Berkeley) 5/31/93
.\"
-.Dd $Mdocdate: May 27 2012 $
+.Dd $Mdocdate: March 31 2022 $
.Dt WORMS 6
.Os
.Sh NAME
This is useful for fast terminals.
Reasonable values are around 20\(en200.
The default is based on the terminal speed.
-If the terminal is 9600 baud or slower no delay is used.
+If the terminal is 9600 baud or slower, no delay is used.
Otherwise, the delay is computed via the following formula:
.Pp
.Dl delay = speed / 9600 \- 1
-.\" $OpenBSD: agentx.3,v 1.7 2021/03/12 05:18:00 jsg Exp $
+.\" $OpenBSD: agentx.3,v 1.8 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 2020 Martijn van Duren <martijn@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 12 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt AGENTX 3
.Os
.Sh NAME
.Fn agentx
or when
.Fa sa
-detects that there is no connection to the agentx master it calls out to
+detects that there is no connection to the agentx master, it calls out to
.Fa nofd
with itself,
.Fa cookie
as arguments.
If
.Fa close
-is not set
+is not set,
.Fn nofd
is expected to set up a new
.Fa fd
.Fn nofd .
Once
.Fn agentx_connect
-has been called the application is responsible for retrieving data when available
+has been called, the application is responsible for retrieving data when available
on
.Fa fd
by calling
.Fn agentx_read .
-If nonblocking writes are desirable the
+If nonblocking writes are desirable, the
.Fn agentx_wantwrite
pointer can be set to an application function and will be called as soon as
there's data available to be written out.
Once
.Fa fd
-is ready for write the function
+is ready for a write, the function
.Fn agentx_write
should be called.
.Pp
can be freed via
.Fn agentx_free .
It will close all active sessions and free all derived objects.
-Once freed no new objects can be derived from the freed objects.
-Once all sessions are closed it will call out to
+Once freed, no new objects can be derived from the freed objects.
+Once all sessions are closed, it will call out to
.Fn nofd
with
.Fa close
.Fa timeout
argument specifies the maximum time in seconds the master should wait for a
reply before determining we're gone.
-If set to 0 the agentx master determines the timeout.
+If set to 0, the agentx master determines the timeout.
The
.Fa oid
and
is the SNMPv3 context in which the objects operate and is built on top of
agentx_session
.Fa sas .
-If the default context is requested
+If the default context is requested,
.Fa name
must be NULL.
.Pp
capabilities of the subagent.
.Fa descr
should be a textual description of the capabilities.
-If no AGENT-CAPABILITIES object is defined this function can be omitted.
+If no AGENT-CAPABILITIES object is defined, this function can be omitted.
.Pp
A
.Vt agentx_region
indicates a region inside the object-tree for which get- and set-requests will
be queried.
-If the OID has already been claimed by another subagent it will try to claim it
+If the OID has already been claimed by another subagent, it will try to claim it
on a lower priority.
The
.Fa timeout
and
.Fn agentx_index_integer_value
tries to register a specific value.
-If the registration of an index fails an error will be logged and all objects
+If the registration of an index fails, an error will be logged and all objects
using it will remain disabled.
The OID where the index should be registered is documented by the MIB.
These registered indices are usually used for tables where multiple subagents
.Dv AGENTX_OID_INDEX_MAX_LEN .
If
.Fa implied
-is set the final index must be of type OID or string and will omit the leading
+is set, the final index must be of type OID or string and will omit the leading
length indicator.
This value must only be set if specified in the MIB.
.Fn getcb
.It Fn agentx_varbind_counter64
Set the return value to an uint64_t of type counter64.
.It Fn agentx_varbind_notfound
-When the request is of type GET return a nosuchinstance error.
-When the request is of type GETNEXT or GETBULK return an endofmibview error.
+When the request is of type GET, return a nosuchinstance error.
+When the request is of type GETNEXT or GETBULK, return an endofmibview error.
On endofmibview the next object is queried.
This function can only be called on objects that contain one or more *_dynamic
indices.
returned.
If
.Fa inclusive
-is set the object returned may also exactly match
+is set, the object returned may also exactly match
.Fa oid .
.It Fn agentx_context_uptime
Returns the sysuptime in seconds for
-.\" $OpenBSD: asr_run.3,v 1.4 2019/10/24 05:57:41 otto Exp $
+.\" $OpenBSD: asr_run.3,v 1.5 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 2012-2014, Eric Faurot <eric@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: October 24 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ASR_RUN 3
.Os
.Sh NAME
contains the code returned by the server in the DNS response packet, and
.Fa ar_count
contains the number of answers in the packet.
-If a response is received it is placed in a newly allocated buffer
+If a response is received, it is placed in a newly allocated buffer
and returned as
.Fa ar_data
member.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: sigvec.3,v 1.35 2017/05/29 11:10:29 jmc Exp $
+.\" $OpenBSD: sigvec.3,v 1.36 2022/03/31 17:27:15 naddy Exp $
.\"
-.Dd $Mdocdate: May 29 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SIGVEC 3
.Os
.Sh NAME
If the process wishes to resume in a different context, then it
must arrange to restore the previous context itself.
.Pp
-When a signal is delivered to a process a new signal mask is
+When a signal is delivered to a process, a new signal mask is
installed for the duration of the process' signal handler
(or until a
.Xr sigblock 3
-.\" $OpenBSD: btree.3,v 1.24 2019/04/23 18:13:11 schwarze Exp $
+.\" $OpenBSD: btree.3,v 1.25 2022/03/31 17:27:15 naddy Exp $
.\" $NetBSD: btree.3,v 1.6 1996/05/03 21:26:48 cgd Exp $
.\"
.\" Copyright (c) 1997, Phillip F Knaack. All rights reserved.
.\"
.\" @(#)btree.3 8.4 (Berkeley) 8/18/94
.\"
-.Dd $Mdocdate: April 23 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BTREE 3
.Os
.Sh NAME
corruption or lost data if the system crashes while a tree is being modified.
If
.Fa cachesize
-is 0 (no size is specified) a default cache is used.
+is 0 (no size is specified), a default cache is used.
.It Fa maxkeypage
The maximum number of keys which will be stored on any single page.
Not currently implemented.
of in the page itself.
If
.Fa minkeypage
-is 0 (no minimum number of keys is specified) a value of 2 is used.
+is 0 (no minimum number of keys is specified), a value of 2 is used.
.It Fa psize
Page size is the size (in bytes) of the pages used for nodes in the tree.
The minimum page size is 512 bytes and the maximum page size is 64K.
If
.Fa psize
-is 0 (no page size is specified) a page size is chosen based on the
+is 0 (no page size is specified), a page size is chosen based on the
underlying file system I/O block size.
.It Fa compare
Compare is the key comparison function.
big endian order would be the number 4,321.
If
.Fa lorder
-is 0 (no order is specified) the current host order is used.
+is 0 (no order is specified), the current host order is used.
.El
.Pp
If the file already exists (and the
-.\" $OpenBSD: hash.3,v 1.20 2016/05/09 11:13:10 naddy Exp $
+.\" $OpenBSD: hash.3,v 1.21 2022/03/31 17:27:15 naddy Exp $
.\" $NetBSD: hash.3,v 1.6 1996/05/03 21:26:50 cgd Exp $
.\"
.\" Copyright (c) 1997, Phillip F Knaack. All rights reserved.
.\"
.\" @(#)hash.3 8.6 (Berkeley) 8/18/94
.\"
-.Dd $Mdocdate: May 9 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt HASH 3
.Os
.Sh NAME
big endian order would be the number 4,321.
If
.Fa lorder
-is 0 (no order is specified) the current host order is used.
+is 0 (no order is specified), the current host order is used.
If the file already exists, the specified value is ignored and the
value specified when the tree was created is used.
.El
-.\" $OpenBSD: recno.3,v 1.20 2015/09/10 10:20:55 jmc Exp $
+.\" $OpenBSD: recno.3,v 1.21 2022/03/31 17:27:15 naddy Exp $
.\" $NetBSD: recno.3,v 1.6 1996/05/03 21:26:51 cgd Exp $
.\"
.\" Copyright (c) 1997, Phillip F Knaack. All rights reserved.
.\"
.\" @(#)recno.3 8.5 (Berkeley) 8/18/94
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RECNO 3
.Os
.Sh NAME
advisory, and the access method will allocate more memory rather than fail.
If
.Fa cachesize
-is 0 (no size is specified) a default cache is used.
+is 0 (no size is specified), a default cache is used.
.It Fa psize
The recno access method stores the in-memory copies of its records
in a btree.
This value is the size (in bytes) of the pages used for nodes in that tree.
If
.Fa psize
-is 0 (no page size is specified) a page size is chosen based on the
+is 0 (no page size is specified), a page size is chosen based on the
underlying file system I/O block size.
See
.Xr btree 3
big endian order would be the number 4,321.
If
.Fa lorder
-is 0 (no order is specified) the current host order is used.
+is 0 (no order is specified), the current host order is used.
.It Fa reclen
The length of a fixed-length record.
.It Fa bval
-.\" $OpenBSD: auth_subr.3,v 1.25 2021/05/31 19:54:04 millert Exp $
+.\" $OpenBSD: auth_subr.3,v 1.26 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved.
.\"
.\" SUCH DAMAGE.
.\"
.\" BSDI $From: auth_subr.3,v 2.5 2000/03/30 19:11:27 polk Exp $
-.Dd $Mdocdate: May 31 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt AUTH_OPEN 3
.Os
.Sh NAME
.It Dv AUTH_INTERACTIVE
If set to any value, then the session is tagged as interactive.
If not set, the session is not interactive.
-When the value is requested it is always either
+When the value is requested, it is always either
.Dv NULL
or
.Dq True .
When a new login script is run
(by the
.Fn auth_call
-function)
+function),
the values from the previous login script are lost.
(See
.Xr login.conf 5
or implicitly via
.Fn auth_check_expire
or
-.Fn auth_check_change )
+.Fn auth_check_change ) ,
it returns
.Dv NULL .
Note that the memory containing the password file entry is freed by
-.\" $OpenBSD: authenticate.3,v 1.18 2016/03/30 06:58:06 jmc Exp $
+.\" $OpenBSD: authenticate.3,v 1.19 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved.
.\"
.\" SUCH DAMAGE.
.\"
.\" BSDI $From: authenticate.3,v 2.7 1998/09/03 20:27:20 prb Exp $
-.Dd $Mdocdate: March 30 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt AUTH_APPROVAL 3
.Os
.Sh NAME
.Dq ignorenologin
and the file
.Pa /etc/nologin
-exists its contents will be copied to standard output and
+exists, its contents will be copied to standard output and
.Xr exit 3
will be called with a value of 1.
.Pp
-.\" $OpenBSD: cgetent.3,v 1.2 2021/02/02 07:33:29 jmc Exp $
+.\" $OpenBSD: cgetent.3,v 1.3 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1992, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 2 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CGETENT 3
.Os
.Sh NAME
If the number starts with either
.Ql 0x
or
-.Ql 0X
+.Ql 0X ,
it is interpreted as a hexadecimal number (both upper and lower case a-f
may be used to denote the extended hexadecimal digits).
Otherwise, if the number starts with a
-.\" $OpenBSD: getdomainname.3,v 1.26 2018/01/12 04:36:44 deraadt Exp $
+.\" $OpenBSD: getdomainname.3,v 1.27 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 12 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt GETDOMAINNAME 3
.Os
.Sh NAME
This call is restricted to the superuser and
is normally used only when the system is bootstrapped.
.Sh RETURN VALUES
-If the call succeeds a value of 0 is returned.
+If the call succeeds, a value of 0 is returned.
If the call fails, a value of \-1 is returned and an error code is
placed in the global variable
.Va errno .
-.\" $OpenBSD: gethostname.3,v 1.28 2018/01/12 04:36:44 deraadt Exp $
+.\" $OpenBSD: gethostname.3,v 1.29 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 12 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt GETHOSTNAME 3
.Os
.Sh NAME
This call is restricted to the superuser and
is normally used only when the system is bootstrapped.
.Sh RETURN VALUES
-If the call succeeds a value of 0 is returned.
+If the call succeeds, a value of 0 is returned.
If the call fails, a value of \-1 is returned and an error code is
placed in the global variable
.Va errno .
-.\" $OpenBSD: sleep.3,v 1.17 2021/12/07 03:16:08 cheloha Exp $
+.\" $OpenBSD: sleep.3,v 1.18 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1986, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 7 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SLEEP 3
.Os
.Sh NAME
If
.Fn sleep
sleeps for the full count of
-.Fa seconds
+.Fa seconds ,
it returns 0.
Otherwise,
.Fn sleep
-.\" $OpenBSD: syslog.3,v 1.36 2020/02/05 12:35:19 schwarze Exp $
+.\" $OpenBSD: syslog.3,v 1.37 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 5 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SYSLOG 3
.Os
.Sh NAME
If
.Fn syslog
cannot pass the message to
-.Xr syslogd 8
+.Xr syslogd 8 ,
it will attempt to write the message to the console
.Pq Pa /dev/console .
.It Dv LOG_NDELAY
.\" If we meet some day, and you think this stuff is worth it, you
.\" can buy me a beer in return. Poul-Henning Kamp
.\"
-.\" $OpenBSD: MD5Init.3,v 1.2 2019/12/05 21:45:05 jmc Exp $
+.\" $OpenBSD: MD5Init.3,v 1.3 2022/03/31 17:27:15 naddy Exp $
.\"
-.Dd $Mdocdate: December 5 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MD5INIT 3
.Os
.Sh NAME
after use.
If the
.Ar buf
-argument is non-null it must point to at least MD5_DIGEST_STRING_LENGTH
+argument is non-null, it must point to at least MD5_DIGEST_STRING_LENGTH
characters of buffer space.
.Sh SEE ALSO
.Xr cksum 1 ,
-.\" $OpenBSD: RMD160Init.3,v 1.2 2019/12/05 21:45:05 jmc Exp $
+.\" $OpenBSD: RMD160Init.3,v 1.3 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1997, 2004 Todd C. Miller <millert@openbsd.org>
.\"
.\" See http://www.esat.kuleuven.ac.be/~bosselae/ripemd160.html
.\" for detailed information about RIPEMD-160.
.\"
-.Dd $Mdocdate: December 5 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RMD160INIT 3
.Os
.Sh NAME
.Fn RMD160End .
If
.Fn RMD160File
-is unable to open the file a NULL pointer is returned.
+is unable to open the file, a NULL pointer is returned.
.Pp
.Fn RMD160FileChunk
behaves like
-.\" $OpenBSD: SHA1Init.3,v 1.2 2019/12/05 21:45:05 jmc Exp $
+.\" $OpenBSD: SHA1Init.3,v 1.3 2022/03/31 17:27:15 naddy Exp $
.\"
.\" Copyright (c) 1997, 2004 Todd C. Miller <millert@openbsd.org>
.\"
.\" See http://csrc.nist.gov/publications/fips/fips180-1/fip180-1.txt
.\" for the detailed standard
.\"
-.Dd $Mdocdate: December 5 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SHA1INIT 3
.Os
.Sh NAME
.Fn SHA1End .
If
.Fn SHA1File
-is unable to open the file a
+is unable to open the file, a
.Dv NULL
pointer is returned.
.Pp
-.\" $OpenBSD: getaddrinfo.3,v 1.59 2019/08/30 20:20:50 jmc Exp $
+.\" $OpenBSD: getaddrinfo.3,v 1.60 2022/03/31 17:27:16 naddy Exp $
.\" $KAME: getaddrinfo.3,v 1.36 2005/01/05 03:23:05 itojun Exp $
.\"
.\" Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: August 30 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt GETADDRINFO 3
.Os
.Sh NAME
.Dv SOCK_RAW .
When
.Fa ai_socktype
-is zero the caller will accept any socket type.
+is zero, the caller will accept any socket type.
.It Fa ai_protocol
Indicates which transport protocol is desired,
.Dv IPPROTO_UDP
.Dv IPPROTO_TCP .
If
.Fa ai_protocol
-is zero the caller will accept any protocol.
+is zero, the caller will accept any protocol.
.It Fa ai_flags
.Fa ai_flags
is formed by
.It Dv AI_PASSIVE
If the
.Dv AI_PASSIVE
-bit is set it indicates that the returned socket address structure
+bit is set, it indicates that the returned socket address structure
is intended for use in a call to
.Xr bind 2 .
In this case, if the
-.\" $OpenBSD: inet6_opt_init.3,v 1.7 2022/03/29 18:15:52 naddy Exp $
+.\" $OpenBSD: inet6_opt_init.3,v 1.8 2022/03/31 17:27:16 naddy Exp $
.\" $KAME: inet6_opt_init.3,v 1.7 2004/12/27 05:08:23 itojun Exp $
.\"
.\" Copyright (C) 2004 WIDE Project.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 29 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INET6_OPT_INIT 3
.Os
.\"
function can perform different jobs.
When a valid
.Fa extbuf
-argument is supplied it appends an option to the extension buffer and
+argument is supplied, it appends an option to the extension buffer and
returns the updated total length as well as a pointer to the newly
created option in
.Fa databufp .
When
.Fa extbuf
is not
-.Dv NULL
+.Dv NULL ,
the function also sets up the appropriate padding bytes by inserting a
Pad1 or PadN option of the proper length.
.Pp
point to the 8-bit option type, the 8-bit option length and the option
data respectively.
This function does not return any PAD1 or PADN options.
-When an error occurs or there are no more options the return
+When an error occurs or there are no more options, the return
value is \-1.
.\"
.Ss inet6_opt_find
-.\" $OpenBSD: inet6_rth_space.3,v 1.7 2014/06/11 16:59:47 chrisz Exp $
+.\" $OpenBSD: inet6_rth_space.3,v 1.8 2022/03/31 17:27:16 naddy Exp $
.\" $KAME: inet6_rth_space.3,v 1.7 2005/01/05 03:00:44 itojun Exp $
.\"
.\" Copyright (C) 2004 WIDE Project.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 11 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INET6_RTH_SPACE 3
.Os
.\"
.Fa segments
argument.
When the type is
-.Dv IPV6_RTHDR_TYPE_0
+.Dv IPV6_RTHDR_TYPE_0 ,
the number of segments must be from 0 through 127.
The return value from this function is the number of bytes required to
store the routing header.
-.\" $OpenBSD: inet_net_ntop.3,v 1.2 2021/09/01 15:59:22 claudio Exp $
+.\" $OpenBSD: inet_net_ntop.3,v 1.3 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: inet_net.3,v 1.1 1997/06/18 02:25:27 lukem Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 1 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INET_NET_NTOP 3
.Os
.Sh NAME
and is used to explicitly specify the number of bits in the network address.
When
.Dq Li /bits
-is not specified the number of bits in the network address is calculated
+is not specified, the number of bits in the network address is calculated
as the larger of the number of bits in the class to which the address
belongs and the number of bits provided rounded up modulo 8.
Examples:
and is used to explicitly specify the number of bits in the network address.
When
.Dq Li /bits
-is not specified 128 is used.
+is not specified, 128 is used.
Note that when the number of bits is specified using
.Dq Li /bits
notation, the value of the address still includes all bits supplied
-.\" $OpenBSD: mktemp.3,v 1.54 2014/10/26 12:54:18 millert Exp $
+.\" $OpenBSD: mktemp.3,v 1.55 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 26 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MKTEMP 3
.Os
.Sh NAME
described above.
Because
.Fn mktemp
-does not actually create the temporary file there is a window of
+does not actually create the temporary file, there is a window of
opportunity during which another process can open the file instead.
Because of this race condition,
.Fn mktemp
-.\" $OpenBSD: scanf.3,v 1.25 2019/08/30 20:27:25 jmc Exp $
+.\" $OpenBSD: scanf.3,v 1.26 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 30 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SCANF 3
.Os
.Sh NAME
.Cm sc[ .
.Pp
If the conversion is one of
-.Cm sc[
+.Cm sc[ ,
the expected conversion input is a multibyte character sequence.
Each multibyte character in the sequence is converted with a call to the
.Fn mbrtowc
-.\" $OpenBSD: wprintf.3,v 1.9 2021/09/02 09:50:38 deraadt Exp $
+.\" $OpenBSD: wprintf.3,v 1.10 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)printf.3 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: September 2 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt WPRINTF 3
.Os
.Sh NAME
Arguments are numbered starting at
.Cm 1 .
If unaccessed arguments in the format string are interspersed with ones that
-are accessed the results will be indeterminate.
+are accessed, the results will be indeterminate.
.It
Zero or more of the following flags:
.Bl -tag -width "'0' (space)"
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: malloc.3,v 1.128 2021/04/09 06:04:15 otto Exp $
+.\" $OpenBSD: malloc.3,v 1.129 2022/03/31 17:27:16 naddy Exp $
.\"
-.Dd $Mdocdate: April 9 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MALLOC 3
.Os
.Sh NAME
.Fa oldnmemb
and
.Fa size
-results in integer overflow
+results in integer overflow,
.Fn recallocarray
returns
.Dv NULL
.It Dq out of memory
If the
.Cm X
-option is specified it is an error for the allocation functions
+option is specified, it is an error for the allocation functions
to return
.Dv NULL .
.It Dq bogus pointer (double free?)
-.\" $OpenBSD: tsearch.3,v 1.21 2019/01/25 00:19:25 millert Exp $
+.\" $OpenBSD: tsearch.3,v 1.22 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 1997 Todd C. Miller <millert@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 25 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TSEARCH 3
.Os
.Sh NAME
is inserted into the tree and a pointer to it is returned.
If
.Fa rootp
-points to a null value a new binary search tree is created.
+points to a null value, a new binary search tree is created.
.Pp
.Fn tdelete
deletes a node from the specified binary search tree and returns
-.\" $OpenBSD: bind.2,v 1.22 2021/01/03 18:10:27 rob Exp $
+.\" $OpenBSD: bind.2,v 1.23 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: bind.2,v 1.8 1995/10/12 15:40:46 jtc Exp $
.\"
.\" Copyright (c) 1983, 1993
.\"
.\" @(#)bind.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: January 3 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIND 2
.Os
.Sh NAME
.Fn bind
assigns a name to an unnamed socket.
When a socket is created with
-.Xr socket 2
+.Xr socket 2 ,
it exists in a name space (address family) but has no name assigned.
.Fn bind
requests that
-.\" $OpenBSD: chroot.2,v 1.23 2021/01/03 18:10:27 rob Exp $
+.\" $OpenBSD: chroot.2,v 1.24 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: chroot.2,v 1.7 1995/02/27 12:32:12 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)chroot.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: January 3 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CHROOT 2
.Os
.Sh NAME
searches of pathnames beginning with
.Ql / .
.Pp
-In order for a directory to become the root directory
+In order for a directory to become the root directory,
a process must have execute (search) access for that directory.
.Pp
If the program is not currently running with an altered root directory,
-.\" $OpenBSD: clock_gettime.2,v 1.31 2020/10/25 00:54:51 cheloha Exp $
+.\" $OpenBSD: clock_gettime.2,v 1.32 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 25 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CLOCK_GETTIME 2
.Os
.Sh NAME
clock may be set and only the superuser may set it.
If the system
.Xr securelevel 7
-is 2 or greater the time may only be advanced.
+is 2 or greater, the time may only be advanced.
This limitation is imposed to prevent a malicious superuser
from setting arbitrary timestamps on files.
.Pp
-.\" $OpenBSD: execve.2,v 1.55 2021/06/30 18:46:49 schwarze Exp $
+.\" $OpenBSD: execve.2,v 1.56 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: execve.2,v 1.9 1995/02/27 12:32:25 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\"
.\" @(#)execve.2 8.3 (Berkeley) 1/24/94
.\"
-.Dd $Mdocdate: June 30 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EXECVE 2
.Os
.Sh NAME
.Ed
.Pp
When an interpreter file is passed to
-.Fn execve
+.Fn execve ,
the system instead calls
.Fn execve
with the specified
As the
.Fn execve
function overlays the current process image
-with a new process image the successful call
+with a new process image, the successful call
has no process to return to.
If
.Fn execve
-does return to the calling process an error has occurred; the
+does return to the calling process, an error has occurred; the
return value will be \-1 and the global variable
.Va errno
is set to indicate the error.
-.\" $OpenBSD: getsockname.2,v 1.30 2015/09/10 17:55:21 schwarze Exp $
+.\" $OpenBSD: getsockname.2,v 1.31 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: getsockname.2,v 1.6 1995/10/12 15:41:00 jtc Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)getsockname.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt GETSOCKNAME 2
.Os
.Sh NAME
When
.Xr bind 2
is called with a port number of 0 (indicating the kernel should pick
-an ephemeral port)
+an ephemeral port),
.Fn getsockname
is used to retrieve the kernel-assigned port number.
.It
-.\" $OpenBSD: getsockopt.2,v 1.58 2021/10/08 14:12:58 jmc Exp $
+.\" $OpenBSD: getsockopt.2,v 1.59 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: getsockopt.2,v 1.7 1995/02/27 12:33:29 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)getsockopt.2 8.3 (Berkeley) 4/19/94
.\"
-.Dd $Mdocdate: October 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt GETSOCKOPT 2
.Os
.Sh NAME
.Dq socket
level.
.Pp
-When manipulating socket options the level at which the
+When manipulating socket options, the level at which the
option resides and the name of the option must be specified.
To manipulate options at the socket level,
.Fa level
-.\" $OpenBSD: gettimeofday.2,v 1.32 2021/12/06 02:48:55 cheloha Exp $
+.\" $OpenBSD: gettimeofday.2,v 1.33 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)gettimeofday.2 8.2 (Berkeley) 5/26/95
.\"
-.Dd $Mdocdate: December 6 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt GETTIMEOFDAY 2
.Os
.Sh NAME
Only the superuser may set the clock.
If the system
.Xr securelevel 7
-is 2 or greater the clock may only be advanced.
+is 2 or greater, the clock may only be advanced.
This limitation prevents a malicious superuser
from setting arbitrary timestamps on files.
Setting the clock cancels any ongoing
-.\" $OpenBSD: kqueue.2,v 1.45 2021/11/21 23:44:55 jan Exp $
+.\" $OpenBSD: kqueue.2,v 1.46 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 2000 Jonathan Lemon
.\" All rights reserved.
.\"
.\" $FreeBSD: src/lib/libc/sys/kqueue.2,v 1.18 2001/02/14 08:48:35 guido Exp $
.\"
-.Dd $Mdocdate: November 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt KQUEUE 2
.Os
.Sh NAME
to return with
.Dv EV_ERROR
set without draining any pending events after updating events in the kqueue.
-When a filter is successfully added the
+When a filter is successfully added, the
.Fa data
field will be zero.
This flag is useful for making bulk changes to a kqueue.
-.\" $OpenBSD: mmap.2,v 1.67 2021/06/30 18:46:49 schwarze Exp $
+.\" $OpenBSD: mmap.2,v 1.68 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: mmap.2,v 1.5 1995/06/24 10:48:59 cgd Exp $
.\"
.\" Copyright (c) 1991, 1993
.\"
.\" @(#)mmap.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: June 30 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MMAP 2
.Os
.Sh NAME
If
.Fa addr
is
-.Dv NULL
+.Dv NULL ,
the system can pick any address.
Except for
.Dv MAP_FIXED
-.\" $OpenBSD: mquery.2,v 1.12 2021/01/20 19:44:48 otto Exp $
+.\" $OpenBSD: mquery.2,v 1.13 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 2003 Artur Grabowski <art@openbsd.org>
.\" All rights reserved.
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 20 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MQUERY 2
.Os
.Sh NAME
.Fa flags
argument.
If set to
-.Dv MAP_FIXED
+.Dv MAP_FIXED ,
the pointer
.Fa addr
is used as a fixed hint and
.Fa size
bytes free after that address.
Otherwise it will return the hint addr.
-If no flags are set
+If no flags are set,
.Fn mquery
will use
.Fa addr
and
.Fa off
arguments.
-When no such area can be found
+When no such area can be found,
.Fn mquery
will return
.Dv MAP_FAILED
.Va errno
to indicate the error.
.Sh RETURN VALUES
-When a memory range satisfying the request is found
+When a memory range satisfying the request is found,
.Fn mquery
returns the available address.
Otherwise,
-.\" $OpenBSD: nanosleep.2,v 1.18 2021/07/25 15:47:26 cheloha Exp $
+.\" $OpenBSD: nanosleep.2,v 1.19 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: nanosleep.2,v 1.1 1997/04/17 18:12:02 jtc Exp $
.\"
.\" Copyright (c) 1986, 1991, 1993
.\"
.\" @(#)sleep.3 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: July 25 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt NANOSLEEP 2
.Os
.Sh NAME
.Fn nanosleep
sleeps the full
.Fa timeout
-without interruption it returns 0.
+without interruption, it returns 0.
Unless
.Fa remainder
is
.Pp
If
.Fn nanosleep
-is interrupted by a signal it returns \-1 and the global variable
+is interrupted by a signal, it returns \-1 and the global variable
.Va errno
is set to
.Dv EINTR .
-.\" $OpenBSD: open.2,v 1.50 2021/01/03 18:10:27 rob Exp $
+.\" $OpenBSD: open.2,v 1.51 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: open.2,v 1.8 1995/02/27 12:35:14 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\"
.\" @(#)open.2 8.2 (Berkeley) 11/16/93
.\"
-.Dd $Mdocdate: January 3 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OPEN 2
.Os
.Sh NAME
is successful, the file pointer used to mark the current position within
the file is set to the beginning of the file.
.Pp
-When a new file is created it is given the group of the directory
+When a new file is created, it is given the group of the directory
which contains it.
.Pp
The new descriptor is set to remain open across
-.\" $OpenBSD: ptrace.2,v 1.41 2021/11/21 23:44:55 jan Exp $
+.\" $OpenBSD: ptrace.2,v 1.42 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: ptrace.2,v 1.3 1996/02/23 01:39:41 jtc Exp $
.\"
.\" This file is in the public domain.
-.Dd $Mdocdate: November 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PTRACE 2
.Os
.Sh NAME
.Fa piod_len
field in the descriptor will be updated with the actual number of bytes
transferred.
-If the requested I/O couldn't be successfully performed
+If the requested I/O could not be successfully performed,
.Fn ptrace
will return
.Li -1
-.\" $OpenBSD: sigaction.2,v 1.75 2018/02/27 03:29:50 schwarze Exp $
+.\" $OpenBSD: sigaction.2,v 1.76 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\"
.\" @(#)sigaction.2 8.2 (Berkeley) 4/3/94
.\"
-.Dd $Mdocdate: February 27 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SIGACTION 2
.Os
.Sh NAME
If the process wishes to resume in a different context, then it
must arrange to restore the previous context itself.
.Pp
-When a signal is delivered to a process a new signal mask is
+When a signal is delivered to a process, a new signal mask is
installed for the duration of the process' signal handler
(or until a
.Xr sigprocmask 2
-.\" $OpenBSD: sigaltstack.2,v 1.24 2021/11/21 23:44:55 jan Exp $
+.\" $OpenBSD: sigaltstack.2,v 1.25 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: sigaltstack.2,v 1.3 1995/02/27 10:41:52 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1992, 1993
.\"
.\" @(#)sigaltstack.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: November 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SIGALTSTACK 2
.Os
.Sh NAME
are not
.Dq grown
automatically as is done for the normal stack.
-If the stack overflows and this space is not protected
+If the stack overflows and this space is not protected,
unpredictable results may occur.
.Sh RETURN VALUES
.Rv -std
-.\" $OpenBSD: socket.2,v 1.43 2019/05/26 09:47:28 krw Exp $
+.\" $OpenBSD: socket.2,v 1.44 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: socket.2,v 1.5 1995/02/27 12:37:53 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)socket.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: May 26 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SOCKET 2
.Os
.Sh NAME
and
.Xr recv 2
calls.
-When a session has been completed a
+When a session has been completed, a
.Xr close 2
may be performed.
Out-of-band data may also be transmitted as described in
-.\" $OpenBSD: sync.2,v 1.16 2016/01/09 21:27:28 mmcc Exp $
+.\" $OpenBSD: sync.2,v 1.17 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: sync.2,v 1.4 1995/02/27 12:38:41 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\"
.\" @(#)sync.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: January 9 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SYNC 2
.Os
.Sh NAME
in the block buffer cache out to disk.
The kernel keeps this information in core to reduce
the number of disk I/O transfers required by the system.
-As information in the cache is lost after a system crash a
+As information in the cache is lost after a system crash, a
.Fn sync
call is issued frequently by the in-kernel process update
(about every 30 seconds).
-.\" $OpenBSD: sysctl.2,v 1.47 2022/02/19 09:12:09 jsg Exp $
+.\" $OpenBSD: sysctl.2,v 1.48 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 19 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SYSCTL 2
.Os
.Sh NAME
Set or get the default TTL value which is used for MPLS (Shim) Header.
The default is 255.
.It Dv MPLSCTL_MAPTTL_IP Pq Va net.mpls.mapttl_ip
-If set to 1 the TTL field is synchronized between the IP header and the
+If set to 1, the TTL field is synchronized between the IP header and the
MPLS label stack.
-If set to 0 the IP header TTL is not modified while passing through MPLS
+If set to 0, the IP header TTL is not modified while passing through MPLS
and the MPLS label stack is initialized with the
.Dv MPLSCTL_DEFTTL .
The default is 1.
.It Dv MPLSCTL_MAPTTL_IP6 Pq Va net.mpls.mapttl_ip6
-If set to 1 the TTL field is synchronized between the IPv6 header and the
+If set to 1, the TTL field is synchronized between the IPv6 header and the
MPLS label stack.
-If set to 0 the IPv6 header TTL is not modified while passing through MPLS
+If set to 0, the IPv6 header TTL is not modified while passing through MPLS
and the MPLS label stack is initialized with the
.Dv MPLSCTL_DEFTTL .
The default is 0.
-.\" $OpenBSD: write.2,v 1.43 2021/11/21 23:44:55 jan Exp $
+.\" $OpenBSD: write.2,v 1.44 2022/03/31 17:27:16 naddy Exp $
.\" $NetBSD: write.2,v 1.6 1995/02/27 12:39:43 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\"
.\" @(#)write.2 8.5 (Berkeley) 4/2/94
.\"
-.Dd $Mdocdate: November 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt WRITE 2
.Os
.Sh NAME
.Pp
If
.Fn write
-succeeds it will update the st_ctime and st_mtime fields of the file's
+succeeds, it will update the st_ctime and st_mtime fields of the file's
meta-data (see
.Xr stat 2 ) .
.Pp
-.\" $OpenBSD: ACCESS_DESCRIPTION_new.3,v 1.5 2019/06/06 01:06:58 schwarze Exp $
+.\" $OpenBSD: ACCESS_DESCRIPTION_new.3,v 1.6 2022/03/31 17:27:16 naddy Exp $
.\"
.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: June 6 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ACCESS_DESCRIPTION_NEW 3
.Os
.Sh NAME
and represents an ASN.1
.Vt AuthorityInfoAccessSyntax
structure defined in RFC 5280 section 4.2.2.1.
-If can be used for the authority information access extension of
+It can be used for the authority information access extension of
certificates and certificate revocation lists and for the subject
information access extension of certificates.
.Fn AUTHORITY_INFO_ACCESS_free
-.\" $OpenBSD: ASN1_TIME_set.3,v 1.16 2021/11/21 17:35:53 schwarze Exp $
+.\" $OpenBSD: ASN1_TIME_set.3,v 1.17 2022/03/31 17:27:16 naddy Exp $
.\" full merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +0100
.\" selective merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ASN1_TIME_SET 3
.Os
.Sh NAME
.Pf * Fa pday
and
.Pf * Fa psec
-are nonzero they will always have the same sign.
+are nonzero, they will always have the same sign.
The value of
.Pf * Fa psec
will always be less than the number of seconds in a day.
-.\" $OpenBSD: BIO_f_buffer.3,v 1.10 2018/05/01 17:05:05 schwarze Exp $
+.\" $OpenBSD: BIO_f_buffer.3,v 1.11 2022/03/31 17:27:16 naddy Exp $
.\" OpenSSL 9b86974e Mar 19 12:32:14 2016 -0400
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 1 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIO_F_BUFFER 3
.Os
.Sh NAME
.Fa buf .
If
.Fa num
-is larger than the current buffer size the buffer is expanded.
+is larger than the current buffer size, the buffer is expanded.
.Pp
Except
.Fn BIO_f_buffer ,
-.\" $OpenBSD: BIO_s_accept.3,v 1.11 2018/05/12 20:12:17 schwarze Exp $
+.\" $OpenBSD: BIO_s_accept.3,v 1.12 2022/03/31 17:27:16 naddy Exp $
.\" OpenSSL c03726ca Thu Aug 27 12:28:08 2015 -0400
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 12 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIO_S_ACCEPT 3
.Os
.Sh NAME
When an accept BIO is not at then end of a chain,
it passes I/O calls to the next BIO in the chain.
.Pp
-When a connection is established a new socket BIO is created
+When a connection is established, a new socket BIO is created
for the connection and appended to the chain.
That is the chain is now accept->socket.
This effectively means that attempting I/O on an initial accept
-.\" $OpenBSD: BIO_s_bio.3,v 1.13 2018/05/01 17:05:05 schwarze Exp $
+.\" $OpenBSD: BIO_s_bio.3,v 1.14 2022/03/31 17:27:16 naddy Exp $
.\" OpenSSL c03726ca Aug 27 12:28:08 2015 -0400
.\"
.\" This file was written by
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 1 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIO_S_BIO 3
.Os
.Sh NAME
.Fa b
to
.Fa size .
-If the size is not initialized a default value is used.
+If the size is not initialized, a default value is used.
This is currently 17K, sufficient for a maximum size TLS record.
.Pp
.Fn BIO_get_write_buf_size
.Xr SSL_free 3
call, the other half still needs to be freed.
.Pp
-When used in bidirectional applications (such as TLS/SSL)
+When used in bidirectional applications (such as TLS/SSL),
care should be taken to flush any data in the write buffer.
This can be done by calling
.Xr BIO_pending 3
-.\" $OpenBSD: BIO_s_connect.3,v 1.11 2018/05/12 20:12:17 schwarze Exp $
+.\" $OpenBSD: BIO_s_connect.3,v 1.12 2022/03/31 17:27:16 naddy Exp $
.\" OpenSSL 186bb907 Apr 13 11:05:13 2015 -0700
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 12 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIO_S_CONNECT 3
.Os
.Sh NAME
If
.Fa c
is not
-.Dv NULL
+.Dv NULL ,
it should be of type
.Vt "int *" .
.Pp
-.\" $OpenBSD: CMS_get0_RecipientInfos.3,v 1.7 2019/11/02 15:39:46 schwarze Exp $
+.\" $OpenBSD: CMS_get0_RecipientInfos.3,v 1.8 2022/03/31 17:27:16 naddy Exp $
.\" full merge up to: OpenSSL e9b77246 Jan 20 19:58:49 2017 +0100
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 2 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CMS_GET0_RECIPIENTINFOS 3
.Os
.Sh NAME
structure can be ignored or its key identifier data retrieved using
an appropriate function.
If the corresponding secret or private key can be obtained by any
-appropriate means it can then be associated with the structure and
+appropriate means, it can then be associated with the structure and
.Fn CMS_RecipientInfo_decrypt
called.
If successful,
-.\" $OpenBSD: CRYPTO_set_ex_data.3,v 1.12 2019/08/16 12:16:22 schwarze Exp $
+.\" $OpenBSD: CRYPTO_set_ex_data.3,v 1.13 2022/03/31 17:27:16 naddy Exp $
.\" full merge up to:
.\" OpenSSL CRYPTO_get_ex_new_index 9e183d22 Mar 11 08:56:44 2017 -0500
.\" selective merge up to: 72a7a702 Feb 26 14:05:09 2019 +0000
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 16 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CRYPTO_SET_EX_DATA 3
.Os
.Sh NAME
.Pp
The API described here is used by OpenSSL to manipulate exdata for
specific structures.
-Since the application data can be anything at all it is passed and
+Since the application data can be anything at all, it is passed and
retrieved as a
.Vt void *
type.
-.\" $OpenBSD: DES_set_key.3,v 1.14 2019/06/06 01:06:58 schwarze Exp $
+.\" $OpenBSD: DES_set_key.3,v 1.15 2022/03/31 17:27:16 naddy Exp $
.\" full merge up to:
.\" OpenSSL man3/DES_random_key 521738e9 Oct 5 14:58:30 2018 -0400
.\"
.\" copied and put under another distribution licence
.\" [including the GNU Public Licence.]
.\"
-.Dd $Mdocdate: June 6 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DES_SET_KEY 3
.Os
.Sh NAME
.Dv DES_PCBC_MODE
(the default), DES_pcbc_encrypt is used.
If set to
-.Dv DES_CBC_MODE
+.Dv DES_CBC_MODE ,
DES_cbc_encrypt is used.
.Sh RETURN VALUES
.Fn DES_set_key ,
-.\" $OpenBSD: EC_GROUP_new.3,v 1.13 2021/05/11 04:22:32 tb Exp $
+.\" $OpenBSD: EC_GROUP_new.3,v 1.14 2022/03/31 17:27:16 naddy Exp $
.\" OpenSSL 6328d367 Sat Jul 4 21:58:30 2020 +0200
.\"
.\" This file was written by Matt Caswell <matt@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 11 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EC_GROUP_NEW 3
.Os
.Sh NAME
.Pq Fa nid
and a human readable comment string describing the curve.
.Pp
-In order to construct a builtin curve use the function
+In order to construct a builtin curve, use the function
.Fn EC_GROUP_new_by_curve_name
and provide the
.Fa nid
-.\" $OpenBSD: ERR_put_error.3,v 1.9 2018/03/27 17:35:50 schwarze Exp $
+.\" $OpenBSD: ERR_put_error.3,v 1.10 2022/03/31 17:27:16 naddy Exp $
.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
.\"
.\" This file was written by Ulf Moeller <ulf@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 27 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ERR_PUT_ERROR 3
.Os
.Sh NAME
numbers and underscores only.
The error file generation script translates function codes into function
names by looking in the header files for an appropriate function name.
-If none is found it just uses the capitalized form such as "SSL23_READ"
+If none is found, it just uses the capitalized form such as "SSL23_READ"
in the above example.
.Pp
The trailing section of a reason code (after the "_R_") is translated
-.\" $OpenBSD: EVP_DigestInit.3,v 1.22 2022/01/15 09:08:51 tb Exp $
+.\" $OpenBSD: EVP_DigestInit.3,v 1.23 2022/03/31 17:27:16 naddy Exp $
.\" full merge up to: OpenSSL 7f572e95 Dec 2 13:57:04 2015 +0000
.\" selective merge up to: OpenSSL a95d7574 Jul 2 12:16:38 2017 -0400
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 15 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EVP_DIGESTINIT 3
.Os
.Sh NAME
.Fn EVP_sha1
is associated with RSA so this will return
.Dv NID_sha1WithRSAEncryption .
-Since digests and signature algorithms are no longer linked this
+Since digests and signature algorithms are no longer linked, this
function is only retained for compatibility reasons.
.Pp
.Fn EVP_md5 ,
-.\" $OpenBSD: EVP_EncryptInit.3,v 1.42 2021/10/14 00:45:02 tb Exp $
+.\" $OpenBSD: EVP_EncryptInit.3,v 1.43 2022/03/31 17:27:16 naddy Exp $
.\" full merge up to: OpenSSL 5211e094 Nov 11 14:39:11 2014 -0800
.\" EVP_bf_cbc.pod EVP_cast5_cbc.pod EVP_idea_cbc.pod EVP_rc2_cbc.pod
.\" 7c6d372a Nov 20 13:20:01 2018 +0000
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 14 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EVP_ENCRYPTINIT 3
.Os
.Sh NAME
which should have sufficient space for one cipher block.
The number of bytes written is placed in
.Fa outl .
-After this function is called the encryption operation is finished and
+After this function is called, the encryption operation is finished and
no further calls to
.Fn EVP_EncryptUpdate
should be made.
ignores the cipher parameters and 40-bit RC2 and 128-bit RC2 have the
same NID.
If the cipher does not have an object identifier or does not
-have ASN.1 support this function will return
+have ASN.1 support, this function will return
.Dv NID_undef .
.Pp
.Fn EVP_CIPHER_CTX_cipher
For example if the block size is 8 and 11 bytes are to be encrypted then
5 padding bytes of value 5 will be added.
.Pp
-When decrypting the final block is checked to see if it has the correct
+When decrypting, the final block is checked to see if it has the correct
form.
.Pp
Although the decryption operation can produce an error if padding is
and
.Dv EVP_MAX_IV_LENGTH
only refer to the internal ciphers with default key lengths.
-If custom ciphers exceed these values the results are unpredictable.
+If custom ciphers exceed these values, the results are unpredictable.
This is because it has become standard practice to define a generic key
as a fixed unsigned char array containing
.Dv EVP_MAX_KEY_LENGTH
-.\" $OpenBSD: EVP_PKEY_decrypt.3,v 1.7 2018/03/23 04:34:23 schwarze Exp $
+.\" $OpenBSD: EVP_PKEY_decrypt.3,v 1.8 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL 48e5119a Jan 19 10:49:22 2018 +0100
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 23 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EVP_PKEY_DECRYPT 3
.Os
.Sh NAME
parameter should contain the length of the
.Fa out
buffer.
-If the call is successful the decrypted data is written to
+If the call is successful, the decrypted data is written to
.Fa out
and the amount of data written to
.Fa outlen .
-.\" $OpenBSD: EVP_PKEY_encrypt.3,v 1.6 2018/03/23 04:34:23 schwarze Exp $
+.\" $OpenBSD: EVP_PKEY_encrypt.3,v 1.7 2022/03/31 17:27:17 naddy Exp $
.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 23 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EVP_PKEY_ENCRYPT 3
.Os
.Sh NAME
parameter should contain the length of the
.Fa out
buffer.
-If the call is successful the encrypted data is written to
+If the call is successful, the encrypted data is written to
.Fa out
and the amount of data written to
.Fa outlen .
-.\" $OpenBSD: EVP_PKEY_sign.3,v 1.7 2018/03/23 04:34:23 schwarze Exp $
+.\" $OpenBSD: EVP_PKEY_sign.3,v 1.8 2022/03/31 17:27:17 naddy Exp $
.\" OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 23 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EVP_PKEY_SIGN 3
.Os
.Sh NAME
parameter should contain the length of the
.Fa sig
buffer.
-If the call is successful the signature is written to
+If the call is successful, the signature is written to
.Fa sig
and the amount of data written to
.Fa siglen .
-.\" $OpenBSD: EVP_SignInit.3,v 1.14 2019/06/10 14:58:48 schwarze Exp $
+.\" $OpenBSD: EVP_SignInit.3,v 1.15 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
.\" selective merge up to: OpenSSL 79b49fb0 Mar 20 10:03:10 2018 +1000
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 10 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EVP_SIGNINIT 3
.Os
.Sh NAME
.Fn EVP_SignFinal .
.Pp
Since the private key is passed in the call to
-.Fn EVP_SignFinal
+.Fn EVP_SignFinal ,
any error relating to the private key (for example an unsuitable key and
digest combination) will not be indicated until after potentially large
amounts of data have been passed through
-.\" $OpenBSD: OBJ_nid2obj.3,v 1.18 2021/12/18 17:47:45 schwarze Exp $
+.\" $OpenBSD: OBJ_nid2obj.3,v 1.19 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL c264592d May 14 11:28:00 2006 +0000
.\" selective merge up to: OpenSSL 35fd9953 May 28 14:49:38 2019 +0200
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 18 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OBJ_NID2OBJ 3
.Os
.Sh NAME
numerical forms.
If
.Fa no_name
-is 1 only the numerical form is acceptable.
+is 1, only the numerical form is acceptable.
.Pp
.Fn OBJ_obj2txt
converts the
-.\" $OpenBSD: OCSP_cert_to_id.3,v 1.11 2021/08/06 21:45:55 schwarze Exp $
+.\" $OpenBSD: OCSP_cert_to_id.3,v 1.12 2022/03/31 17:27:17 naddy Exp $
.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
.\"
.\" This file is a derived work.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 6 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OCSP_CERT_TO_ID 3
.Os
.Sh NAME
returns the issuer name hash, hash OID, issuer key hash and serial
number contained in
.Fa cid .
-If any of the values are not required the corresponding parameter can be
+If any of the values are not required, the corresponding parameter can be
set to
.Dv NULL .
The values returned by
-.\" $OpenBSD: OCSP_resp_find_status.3,v 1.10 2019/08/27 10:00:41 schwarze Exp $
+.\" $OpenBSD: OCSP_resp_find_status.3,v 1.11 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL c952780c Jun 21 07:03:34 2016 -0400
.\" selective merge up to: OpenSSL 1212818e Sep 11 13:22:14 2018 +0100
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 27 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OCSP_RESP_FIND_STATUS 3
.Os
.Sh NAME
.Fn OCSP_single_get0_status .
If
.Fa sec
-is non-zero it indicates how many seconds leeway should be allowed in
+is non-zero, it indicates how many seconds leeway should be allowed in
the check.
If
.Fa maxsec
-is positive it indicates the maximum age of
+is positive, it indicates the maximum age of
.Fa thisupd
in seconds.
.Pp
-.\" $OpenBSD: OCSP_sendreq_new.3,v 1.9 2019/08/27 10:48:41 schwarze Exp $
+.\" $OpenBSD: OCSP_sendreq_new.3,v 1.10 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
.\"
.\" This file is a derived work.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 27 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OCSP_SENDREQ_NEW 3
.Os
.Sh NAME
.Fn OCSP_sendreq_nbio
performs non-blocking I/O on the OCSP request context
.Fa rctx .
-When the operation is complete it returns the response in
+When the operation is complete, it returns the response in
.Pf * Fa presp .
If
.Fn OCSP_sendreq_nbio
-.\" $OpenBSD: PKCS12_create.3,v 1.11 2021/10/22 15:50:19 schwarze Exp $
+.\" $OpenBSD: PKCS12_create.3,v 1.12 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL 05ea606a May 20 20:52:46 2016 -0400
.\" selective merge up to: OpenSSL 61f805c1 Jan 16 01:01:46 2018 +0800
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 22 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PKCS12_CREATE 3
.Os
.Sh NAME
adds a flag to the store private key.
This is a non-standard extension that is only currently interpreted by
MSIE.
-If set to zero the flag is omitted; if set to
-.Dv KEY_SIG
+If set to zero, the flag is omitted; if set to
+.Dv KEY_SIG ,
the key can be used for signing only; and if set to
-.Dv KEY_EX
+.Dv KEY_EX ,
it can be used for signing and encryption.
This option was useful for old export grade software which could use
signing only keys of arbitrary size but had restrictions on the
-.\" $OpenBSD: PKCS7_verify.3,v 1.10 2022/01/19 20:28:06 tb Exp $
+.\" $OpenBSD: PKCS7_verify.3,v 1.11 2022/03/31 17:27:17 naddy Exp $
.\" OpenSSL a528d4f0 Oct 27 13:40:11 2015 -0400
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 19 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PKCS7_VERIFY 3
.Os
.Sh NAME
and then looking in any certificates contained in the
.Fa p7
structure itself.
-If any signer's certificates cannot be located the operation fails.
+If any signer's certificates cannot be located, the operation fails.
.Pp
Each signer's certificate is chain verified using the
.Sy smimesign
purpose and the supplied trusted certificate store.
Any internal certificates in the message are used as untrusted CAs.
-If any chain verify fails an error code is returned.
+If any chain verify fails, an error code is returned.
.Pp
Finally, the signed content is read (and written to
.Fa out
-.\" $OpenBSD: RSA_get_ex_new_index.3,v 1.10 2018/03/23 23:18:17 schwarze Exp $
+.\" $OpenBSD: RSA_get_ex_new_index.3,v 1.11 2022/03/31 17:27:17 naddy Exp $
.\" OpenSSL 35cb565a Nov 19 15:49:30 2015 -0500
.\"
.\" This file was written by Ulf Moeller <ulf@openssl.org> and
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 23 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RSA_GET_EX_NEW_INDEX 3
.Os
.Sh NAME
some additional data (for example a handle to the data in an external
library).
.Pp
-Since the application data can be anything at all it is passed and
+Since the application data can be anything at all, it is passed and
retrieved as a
.Vt void *
type.
-.\" $OpenBSD: X509_NAME_add_entry_by_txt.3,v 1.15 2021/12/09 19:01:52 schwarze Exp $
+.\" $OpenBSD: X509_NAME_add_entry_by_txt.3,v 1.16 2022/03/31 17:27:17 naddy Exp $
.\" OpenSSL aebb9aac Jul 19 09:27:53 2016 -0400
.\"
.\" This file was written by Dr. Stephen Henson <steve@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 9 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt X509_NAME_ADD_ENTRY_BY_TXT 3
.Os
.Sh NAME
.Pp
.Fa set
determines how the new type is added.
-If it is zero a new RDN is created.
+If it is zero, a new RDN is created.
.Pp
If
.Fa set
-is -1 or 1 it is added to the previous or next RDN structure
+is -1 or 1, it is added to the previous or next RDN structure
respectively.
This will then be a multivalued RDN: since multivalue RDNs are very
seldom used,
-.\" $OpenBSD: X509_VERIFY_PARAM_set_flags.3,v 1.24 2022/03/29 14:27:59 naddy Exp $
+.\" $OpenBSD: X509_VERIFY_PARAM_set_flags.3,v 1.25 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL d33def66 Feb 9 14:17:13 2016 -0500
.\" selective merge up to: OpenSSL 24a535ea Sep 22 13:14:20 2020 +0100
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 29 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt X509_VERIFY_PARAM_SET_FLAGS 3
.Os
.Sh NAME
disables critical extension checking.
By default any unhandled critical extensions in certificates or (if
checked) CRLs results in a fatal error.
-If this flag is set unhandled critical extensions are ignored.
+If this flag is set, unhandled critical extensions are ignored.
.Sy WARNING :
setting this option for anything other than debugging purposes can be a
security risk.
signed by different keys are disabled.
If
.Dv X509_V_FLAG_EXTENDED_CRL_SUPPORT
-is set they are enabled.
+is set, they are enabled.
.Pp
If
.Dv X509_V_FLAG_USE_DELTAS
-.\" $OpenBSD: X509_get_pubkey.3,v 1.12 2021/10/26 18:05:07 tb Exp $
+.\" $OpenBSD: X509_get_pubkey.3,v 1.13 2022/03/31 17:27:17 naddy Exp $
.\" selective merge up to: OpenSSL 99d63d46 Oct 26 13:56:48 2016 -0400
.\"
.\" This file is a derived work.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 26 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt X509_GET_PUBKEY 3
.Os
.Sh NAME
.Fn X509_get_pubkey
attempts to decode the public key for certificate
.Fa x .
-If successful it returns the public key as an
+If successful, it returns the public key as an
.Vt EVP_PKEY
pointer with its reference count incremented: this means the returned
key must be freed up after use.
-.\" $OpenBSD: lh_new.3,v 1.8 2021/12/17 16:32:07 schwarze Exp $
+.\" $OpenBSD: lh_new.3,v 1.9 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to:
.\" OpenSSL doc/crypto/lhash.pod 1bc74519 May 20 08:11:46 2016 -0400
.\" selective merge up to:
.\" copied and put under another distribution licence
.\" [including the GNU Public Licence.]
.\"
-.Dd $Mdocdate: December 17 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt LH_NEW 3
.Os
.Sh NAME
the hash table.
The default values are as follows.
If (hash->up_load < load) => expand.
-if (hash->down_load > load) => contract.
+If (hash->down_load > load) => contract.
The
.Fa up_load
has a default value of 1 and
The 'load' is kept in a form which is multiplied by 256.
So hash->up_load=8*256 will cause a load of 8 to be set.
.Pp
-If you are interested in performance the field to watch is
+If you are interested in performance, the field to watch is
.Fa num_comp_calls .
The hash library keeps track of the 'hash' value for each item so when a
lookup is done, the 'hashes' are compared, if there is a match, then a
full compare is done, and hash->num_comp_calls is incremented.
-If num_comp_calls is not equal to num_delete plus num_retrieve it means
+If num_comp_calls is not equal to num_delete plus num_retrieve, it means
that your hash function is generating hashes that are the same for
different values.
It is probably worth changing your hash function if this is the case
-.\" $OpenBSD: openssl.cnf.5,v 1.7 2020/02/17 12:52:42 inoguchi Exp $
+.\" $OpenBSD: openssl.cnf.5,v 1.8 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to: OpenSSL man5/config b53338cb Feb 28 12:30:28 2017 +0100
.\" selective merge up to: OpenSSL a8c5ed81 Jul 18 13:57:25 2017 -0400
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 17 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OPENSSL.CNF 5
.Os
.Sh NAME
The command
.Ic engine_id
is used to give the ENGINE name.
-If used this command must be first.
+If used, this command must be first.
For example:
.Bd -literal -offset indent
[engine_section]
sets the default algorithms an ENGINE will supply using the functions
.Xr ENGINE_set_default_string 3 .
.Pp
-If the name matches none of the above command names it is assumed
+If the name matches none of the above command names, it is assumed
to be a ctrl command which is sent to the ENGINE.
The value of the command is the argument to the ctrl command.
If the value is the string
-.\" $OpenBSD: x509v3.cnf.5,v 1.7 2020/06/11 18:03:19 jmc Exp $
+.\" $OpenBSD: x509v3.cnf.5,v 1.8 2022/03/31 17:27:17 naddy Exp $
.\" full merge up to:
.\" OpenSSL man5/x509v3_config a41815f0 Mar 17 18:43:53 2017 -0700
.\" selective merge up to: OpenSSL 36cf10cf Oct 4 02:11:08 2017 -0400
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 11 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt X509V3.CNF 5
.Os
.Sh NAME
this one in a chain.
So if you have a CA with a
.Ic pathlen
-of zero it can only be used to sign end user certificates and not
+of zero, it can only be used to sign end user certificates and not
further CAs.
.Ss Key usage
Key usage is a multi-valued extension consisting of a list of names of
-.\" $OpenBSD: editline.3,v 1.48 2021/08/14 11:30:12 schwarze Exp $
+.\" $OpenBSD: editline.3,v 1.49 2022/03/31 17:27:17 naddy Exp $
.\" $NetBSD: editline.3,v 1.88 2016/02/25 14:59:22 wiz Exp $
.\"
.\" Copyright (c) 1997-2003 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 14 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EDITLINE 3
.Os
.Sh NAME
.Fa name
is a valid
.Xr termcap 5
-capability set
+capability, set
.Fa value
to the current value of that capability.
.It Dv EL_SIGNAL , Fa "int *s"
has been called with a non-zero argument, the element
will not be entered into the history if its contents match
the ones of the current history element.
-If the element is entered
+If the element is entered,
.Fn history
-returns 1; if it is ignored as a duplicate returns 0.
+returns 1; if it is ignored as a duplicate, returns 0.
Finally
.Fn history
returns \-1 if an error occurred.
.\" out of the use of this software, even if advised of the possibility of
.\" such damage.
.\"
-.\" $Id: gelf_newehdr.3,v 1.3 2020/05/18 06:46:23 jsg Exp $
+.\" $Id: gelf_newehdr.3,v 1.4 2022/03/31 17:27:17 naddy Exp $
.\"
.Dd June 12, 2019
.Dt GELF_NEWEHDR 3
When argument
.Ar elfclass
has value
-.Dv ELFCLASS64
+.Dv ELFCLASS64 ,
it returns the value returned by
.Fn elf64_newehdr "elf" .
.Pp
-.\" $OpenBSD: event.3,v 1.55 2018/09/23 08:56:19 anton Exp $
+.\" $OpenBSD: event.3,v 1.56 2022/03/31 17:27:17 naddy Exp $
.\"
.\" Copyright (c) 2000 Artur Grabowski <art@openbsd.org>
.\" All rights reserved.
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 23 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EVENT_INIT 3
.Os
.Sh NAME
.Fn event_del
will cancel the event in the argument
.Fa ev .
-If the event has already executed or has never been added
+If the event has already executed or has never been added,
the call will have no effect.
.Pp
The functions
.Va EV_READ
and
.Va EV_WRITE .
-When read enabled the bufferevent will try to read from the file
+When read enabled, the bufferevent will try to read from the file
descriptor and call the read callback.
The write callback is executed
whenever the output buffer is drained below the write low watermark,
-.\" $OpenBSD: fuse_chan_fd.3,v 1.2 2018/07/08 06:17:10 jmc Exp $
+.\" $OpenBSD: fuse_chan_fd.3,v 1.3 2022/03/31 17:27:17 naddy Exp $
.\"
.\" Copyright (c) 2018 Helg Bredow <helg.bredow@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: July 8 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FUSE_CHAN_FD 3
.Os
.Sh NAME
returns a non-negative integer, termed a file descriptor.
If
.Fa ch
-is NULL a value of -1 is returned.
+is NULL, a value of -1 is returned.
.Sh SEE ALSO
.Xr fuse_mount 3 ,
.Xr open 3 ,
-.\" $OpenBSD: fuse_new.3,v 1.6 2021/03/12 05:18:01 jsg Exp $
+.\" $OpenBSD: fuse_new.3,v 1.7 2022/03/31 17:27:17 naddy Exp $
.\"
.\" Copyright (c) 2013 Sylvestre Gallon <ccna.syl@gmail.com>
.\" Copyright (c) 2018 Helg Bredow <helg@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 12 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FUSE_NEW 3
.Os
.Sh NAME
By default, FUSE will return an internal inode number for getattr and
readdir and this will be different every time the file system is
mounted.
-If this is set the file system's own inode number will be
+If this is set, the file system's own inode number will be
reported instead.
Useful only for file system that have inode numbers.
.El
-.\" $OpenBSD: keynote.4,v 1.39 2022/02/18 10:24:32 jsg Exp $
+.\" $OpenBSD: keynote.4,v 1.40 2022/03/31 17:27:17 naddy Exp $
.\"
.\" The author of this code is Angelos D. Keromytis (angelos@dsl.cis.upenn.edu)
.\"
.\" MERCHANTABILITY OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR
.\" PURPOSE.
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt KEYNOTE 4
.\" .TH KeyNote 4 local
.Os
by any number of alphanumerics and underscores.
Attribute names are case sensitive.
.Pp
-If an action attribute is not defined its value is considered to be
+If an action attribute is not defined, its value is considered to be
the empty string.
.Pp
Attribute names beginning with the
-.\" $OpenBSD: pthread_attr_setguardsize.3,v 1.2 2013/06/05 03:44:50 tedu Exp $
+.\" $OpenBSD: pthread_attr_setguardsize.3,v 1.3 2022/03/31 17:27:17 naddy Exp $
.\" Manual page derived from TOG's XPG6 documentation.
.\"
.\" David Leonard, 2000. Public Domain.
.\"
-.Dd $Mdocdate: June 5 2013 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PTHREAD_ATTR_SETGUARDSIZE 3
.Os
.Sh NAME
If a thread's stack is created with guard protection,
the implementation allocates extra memory at the overflow end of
the stack as a buffer against stack overflow of the stack pointer.
-If an application overflows into this buffer an error shall result
+If an application overflows into this buffer, an error shall result
(possibly in a SIGSEGV signal being delivered to the thread).
.Sh RETURN VALUES
Upon successful completion,
-.\" $OpenBSD: pthread_barrier_init.3,v 1.4 2020/04/06 00:01:08 pirofti Exp $
+.\" $OpenBSD: pthread_barrier_init.3,v 1.5 2022/03/31 17:27:17 naddy Exp $
.\"
.\" Copyright (c) 2012 Paul Irofti <paul@irofti.net>
.\"
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.\"
-.Dd $Mdocdate: April 6 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PTHREAD_BARRIER_INIT 3
.Os
.Sh NAME
If
.Fa attr
is
-.Dv NULL
+.Dv NULL ,
the default attributes are used.
The
.Fa count
-.\" $OpenBSD: pthread_cond_init.3,v 1.11 2013/06/05 03:44:50 tedu Exp $
+.\" $OpenBSD: pthread_cond_init.3,v 1.12 2022/03/31 17:27:17 naddy Exp $
.\"
.\" Copyright (c) 1997 Brian Cully <shmit@kublai.com>
.\" All rights reserved.
.\"
.\" $FreeBSD: pthread_cond_init.3,v 1.6 1999/08/28 00:03:03 peter Exp $
.\"
-.Dd $Mdocdate: June 5 2013 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PTHREAD_COND_INIT 3
.Os
.Sh NAME
If
.Fa attr
is
-.Dv NULL
+.Dv NULL ,
the default attributes are used.
.Sh RETURN VALUES
If successful, the
-.\" $OpenBSD: sio_open.3,v 1.52 2020/11/29 08:02:42 ratchov Exp $
+.\" $OpenBSD: sio_open.3,v 1.53 2022/03/31 17:27:18 naddy Exp $
.\"
.\" Copyright (c) 2007 Alexandre Ratchov <alex@caoua.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 29 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SIO_OPEN 3
.Os
.Sh NAME
The exact playback
latency can be obtained by subtracting the current position
from the number of frames written.
-Once playback is actually started (first sample audible)
+Once playback is actually started (first sample audible),
the latency will never exceed the
.Fa bufsz
parameter (see the sections above).
-.\" $OpenBSD: BIO_f_ssl.3,v 1.11 2019/06/12 09:36:30 schwarze Exp $
+.\" $OpenBSD: BIO_f_ssl.3,v 1.12 2022/03/31 17:27:18 naddy Exp $
.\" full merge up to: OpenSSL f672aee4 Feb 9 11:52:40 2016 -0500
.\" selective merge up to: OpenSSL 61f805c1 Jan 16 01:01:46 2018 +0800
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 12 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIO_F_SSL 3
.Os
.Sh NAME
.Vt SSL
.Vt BIO
using
-.Xr BIO_push 3
+.Xr BIO_push 3 ,
it is automatically used as the
.Vt SSL
.Vt BIO Ns 's read and write
.Fn BIO_set_ssl_renegotiate_bytes
sets the renegotiate byte count to
.Fa num .
-When set after every
+When set, after every
.Fa num
bytes of I/O (read and write) the SSL session is automatically renegotiated.
.Fa num
.Fn BIO_set_ssl_renegotiate_timeout
sets the renegotiate timeout to
.Fa seconds .
-When the renegotiate timeout elapses the session is automatically renegotiated.
+When the renegotiate timeout elapses, the session is automatically renegotiated.
.Pp
.Fn BIO_get_num_renegotiates
returns the total number of session renegotiations due to I/O or timeout.
should be used for non blocking connect
.Vt BIO Ns s
to determine if the call should be retried.
-If an SSL connection has already been established this call has no effect.
+If an SSL connection has already been established, this call has no effect.
.Pp
.Vt SSL
.Vt BIO Ns s
Since unknown
.Xr BIO_ctrl 3
operations are sent through filter
-.Vt BIO Ns s
+.Vt BIO Ns s ,
the server name and port can be set using
.Xr BIO_set_conn_hostname 3
and
-.\" $OpenBSD: SSL_CTX_set_options.3,v 1.15 2021/06/12 11:02:20 tb Exp $
+.\" $OpenBSD: SSL_CTX_set_options.3,v 1.16 2022/03/31 17:27:18 naddy Exp $
.\" full merge up to: OpenSSL 7946ab33 Dec 6 17:56:41 2015 +0100
.\" selective merge up to: OpenSSL edb79c3a Mar 29 10:07:14 2017 +1000
.\"
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 12 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSL_CTX_SET_OPTIONS 3
.Os
.Sh NAME
transparently make use of
RFC 5077 tickets for stateless session resumption.
.Pp
-If this option is set this functionality is disabled and tickets will not be
+If this option is set, this functionality is disabled and tickets will not be
used by clients or servers.
.It Dv SSL_OP_NO_TLSv1
Do not use the TLSv1.0 protocol.
.Em no_renegotiation
warning alert.
.Pp
-If the patched OpenSSL server attempts to renegotiate a fatal
+If the patched OpenSSL server attempts to renegotiate, a fatal
.Em handshake_failure
alert is sent.
This is because the server code may be unaware of the unpatched nature of the
Renegotiation is permitted because this does not add any additional security
issues: during an attack clients do not see any renegotiations anyway.
.Pp
-As more servers become patched the option
+As more servers become patched, the option
.Dv SSL_OP_LEGACY_SERVER_CONNECT
will
.Em not
-.\" $OpenBSD: SSL_CTX_set_tmp_dh_callback.3,v 1.9 2022/02/18 23:17:15 jsg Exp $
+.\" $OpenBSD: SSL_CTX_set_tmp_dh_callback.3,v 1.10 2022/03/31 17:27:18 naddy Exp $
.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
.\"
.\" This file was written by Lutz Jaenicke <jaenicke@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSL_CTX_SET_TMP_DH_CALLBACK 3
.Os
.Sh NAME
past sessions, even if they get hold of the normal (certified) key,
as this key was only used for signing.
.Pp
-In order to perform a DH key exchange the server must use a DH group
+In order to perform a DH key exchange, the server must use a DH group
(DH parameters) and generate a DH key.
The server will always generate a new DH key during the negotiation.
.Pp
-.\" $OpenBSD: SSL_get_session.3,v 1.7 2018/03/27 17:35:50 schwarze Exp $
+.\" $OpenBSD: SSL_get_session.3,v 1.8 2022/03/31 17:27:18 naddy Exp $
.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
.\"
.\" This file was written by Lutz Jaenicke <jaenicke@openssl.org>.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
.\" OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 27 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSL_GET_SESSION 3
.Os
.Sh NAME
.Fn SSL_get1_session
will increment the reference count, so that the session will not be implicitly
removed by other operations but stays in memory.
-In order to remove the session
+In order to remove the session,
.Xr SSL_SESSION_free 3
must be explicitly called once to decrement the reference count again.
.Pp
-.\" $OpenBSD: usbhid.3,v 1.22 2021/05/30 19:54:52 jcs Exp $
+.\" $OpenBSD: usbhid.3,v 1.23 2022/03/31 17:27:18 naddy Exp $
.\" $NetBSD: usbhid.3,v 1.5 2002/02/07 07:00:52 ross Exp $
.\"
.\" Copyright (c) 1999, 2001 Lennart Augustsson <augustss@netbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 30 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt USBHID 3
.Os
.Sh NAME
.Fn hid_use_report_desc .
The data is copied into an internal structure which can be accessed with
.Fn hid_get_report_desc_data .
-When the report descriptor is no longer needed it should be freed by calling
+When the report descriptor is no longer needed, it should be freed by calling
.Fn hid_dispose_report_desc .
The type
.Fa report_desc_t
To iterate through all the items in the report descriptor,
.Fn hid_get_item
should be called while it returns a value greater than 0.
-When the report descriptor ends it will return 0; a syntax
+When the report descriptor ends, it will return 0; a syntax
error within the report descriptor will cause a return value less
than 0.
The struct pointed to by
The size of a report (of a certain kind) can be computed by the
.Fn hid_report_size
function.
-If the report is prefixed by an ID byte it is given by
+If the report is prefixed by an ID byte, it is given by
.Fa id .
.Pp
To locate a single item the
-.\" $OpenBSD: isduid.3,v 1.3 2015/07/15 15:16:59 sobrado Exp $
+.\" $OpenBSD: isduid.3,v 1.4 2022/03/31 17:27:18 naddy Exp $
.\"
.\" * Copyright (c) Joel Sing <jsing@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: July 15 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ISDUID 3
.Os
.Sh NAME
.Xr opendev 3 .
.Pp
If the OPENDEV_PART flag is included in
-.Fa dflags
+.Fa dflags ,
the disklabel UID must consist of a 16-character hexadecimal string.
Otherwise the disklabel UID must consist of a 16-character hexadecimal string
followed by a
-.\" $OpenBSD: fingerd.8,v 1.21 2015/01/15 19:06:32 schwarze Exp $
+.\" $OpenBSD: fingerd.8,v 1.22 2022/03/31 17:27:18 naddy Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" SUCH DAMAGE.
.\"
.\" from: @(#)fingerd.8 8.1 (Berkeley) 6/4/93
-.\" $Id: fingerd.8,v 1.21 2015/01/15 19:06:32 schwarze Exp $
+.\" $Id: fingerd.8,v 1.22 2022/03/31 17:27:18 naddy Exp $
.\"
-.Dd $Mdocdate: January 15 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FINGERD 8
.Os
.Sh NAME
is started by
.Xr inetd 8 ,
which listens for TCP requests at port 79.
-Once connected it reads a single command line
+Once connected, it reads a single command line
terminated by a
.Aq CRLF
which is passed to
-.\" $OpenBSD: ftpd.8,v 1.76 2019/05/08 23:56:48 tedu Exp $
+.\" $OpenBSD: ftpd.8,v 1.77 2022/03/31 17:27:18 naddy Exp $
.\" $NetBSD: ftpd.8,v 1.8 1996/01/14 20:55:23 thorpej Exp $
.\"
.\" Copyright (c) 1985, 1988, 1991, 1993
.\"
.\" @(#)ftpd.8 8.2 (Berkeley) 4/19/94
.\"
-.Dd $Mdocdate: May 8 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FTPD 8
.Os
.Sh NAME
the user should be used as the password).
.El
.Pp
-Once a user is authenticated the user must be approved by any approval
+Once a user is authenticated, the user must be approved by any approval
script defined (see
.Xr login.conf 5 ) .
If a valid approval script (by either :approve=...: or :approve-ftp=...:
-.\" $OpenBSD: getty.8,v 1.16 2020/02/08 01:09:57 jsg Exp $
+.\" $OpenBSD: getty.8,v 1.17 2022/03/31 17:27:18 naddy Exp $
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\"
.\" from: @(#)getty.8 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: February 8 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt GETTY 8
.Os
.Sh NAME
.Em default
table is used.
If there is no
-.Pa /etc/gettytab
+.Pa /etc/gettytab ,
a set of system defaults is used.
If indicated by the table located,
.Nm
-.\" $OpenBSD: login_ldap.8,v 1.2 2020/09/12 17:14:23 martijn Exp $
+.\" $OpenBSD: login_ldap.8,v 1.3 2022/03/31 17:27:18 naddy Exp $
.\" Copyright (c) 2002 Institute for Open Systems Technology Australia (IFOST)
.\" Copyright (c) 2007 Michael Erdely <merdely@openbsd.org>
.\" Copyright (c) 2019 Martijn van Duren <martijn@openbsd.org>
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 12 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt LOGIN_LDAP 8
.Os
.Sh NAME
are supported.
The challenge service is not supported, but it is not an error to specify
this service.
-If this happens
+If this happens,
.Nm
will request the response service.
.It Fl v
searches for the
.Ar user
on the LDAP server based on the filter parameters in the configuration file.
-If the user is found it will try to bind to it using the supplied password.
+If the user is found, it will try to bind to it using the supplied password.
.Pp
.Nm
uses the
variable to determine the location of the configuration file.
If no
.Ar ldap-conffile
-can be found it will fall back to
+can be found, it will fall back to
.Pa /etc/login_ldap.conf .
The configuration file must be owned by root with group auth and permissions
0640.
DN used by
.Nm
to bind to the LDAP server.
-If no basedn is set this is used to bind directly to the user and uses the user
+If no basedn is set, this is used to bind directly to the user and uses the user
supplied password.
Use FORMAT FILTERS to specify the username in this case.
.Pp
-If basedn is set it's used together with bindpw to bind to the LDAP server and
+If basedn is set, it is used together with bindpw to bind to the LDAP server and
search for the user entry based on filter and scope.
If
.Ar binddn
-is omitted and basedn is set an anonymous bind is used to search for the user
+is omitted and basedn is set, an anonymous bind is used to search for the user
entry.
.El
.Pp
-.\" $OpenBSD: login_radius.8,v 1.15 2022/01/04 13:43:14 jmc Exp $
+.\" $OpenBSD: login_radius.8,v 1.16 2022/03/31 17:27:18 naddy Exp $
.\"
.\" Copyright (c) 1996 Berkeley Software Design, Inc. All rights reserved.
.\"
.\"
.\" BSDI $From: login_radius.8,v 1.2 1996/11/11 18:42:02 prb Exp $
.\"
-.Dd $Mdocdate: January 4 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt LOGIN_RADIUS 8
.Os
.Sh NAME
.It radius-challenge-styles
Comma-separated list of authentication styles that the RADIUS server
knows about.
-If the user's authentication style is in this list the challenge will
+If the user's authentication style is in this list, the challenge will
be provided by the RADIUS server.
If not,
.Nm
-.\" $OpenBSD: mail.local.8,v 1.32 2020/05/27 03:12:06 millert Exp $
+.\" $OpenBSD: mail.local.8,v 1.33 2022/03/31 17:27:19 naddy Exp $
.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\"
.\" from: @(#)mail.local.8 6.8 (Berkeley) 4/27/91
.\"
-.Dd $Mdocdate: May 27 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MAIL.LOCAL 8
.Os
.Sh NAME
If you are running
.Xr sendmail 8
and have disk quotas on
-.Pa /var/mail
+.Pa /var/mail ,
it is imperative that you unset the
.Dq m
mailer flag for the
-.\" $OpenBSD: atactl.8,v 1.47 2020/04/23 21:28:08 jmc Exp $
+.\" $OpenBSD: atactl.8,v 1.48 2022/03/31 17:27:19 naddy Exp $
.\" $NetBSD: atactl.8,v 1.5 1999/02/24 18:49:14 jwise Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: April 23 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ATACTL 8
.Os
.Sh NAME
code value which is displayed in the
.Li identify
command output if supported.
-After value 0x0001 is reached the next value will be 0xfffe.
+After value 0x0001 is reached, the next value will be 0xfffe.
The security level determines device behavior when the master password is used
to unlock the device.
-When the security level is set to high the device requires the
+When the security level is set to high, the device requires the
.Li secunlock
command if the master password is used to unlock.
-When the security level is set to maximum the device requires a
+When the security level is set to maximum, the device requires a
.Li secerase
command if the master password is used to unlock it.
Execution of the
-.\" $OpenBSD: badsect.8,v 1.17 2007/08/06 19:16:05 sobrado Exp $
+.\" $OpenBSD: badsect.8,v 1.18 2022/03/31 17:27:19 naddy Exp $
.\" $NetBSD: badsect.8,v 1.8 1995/03/18 14:54:27 cgd Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\"
.\" @(#)badsect.8 8.1 (Berkeley) 6/5/93
.\"
-.Dd $Mdocdate: August 6 2007 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BADSECT 8
.Os
.Sh NAME
creating an illegal file whose first block address is the block containing
the bad sector, and whose name is the bad sector number.
When it is discovered by
-.Em fsck
+.Em fsck ,
it will ask
.Dq Li "HOLD BAD BLOCK?"
A positive response will cause
-.\" $OpenBSD: dhclient.8,v 1.48 2021/08/24 13:53:21 jmc Exp $
+.\" $OpenBSD: dhclient.8,v 1.49 2022/03/31 17:27:19 naddy Exp $
.\"
.\" Copyright (c) 1997 The Internet Software Consortium.
.\" All rights reserved.
.\" Enterprises. To learn more about the Internet Software Consortium,
.\" see ``http://www.isc.org/isc''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
-.Dd $Mdocdate: August 24 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCLIENT 8
.Os
.Sh NAME
will look for the network interface currently in the interface group
.Dq egress
and configure it with DHCP.
-If there is more than one network interface in the egress group
+If there is more than one network interface in the egress group,
.Nm
will exit with an error.
.Pp
-.\" $OpenBSD: dhclient.conf.5,v 1.51 2020/07/17 22:21:18 krw Exp $
+.\" $OpenBSD: dhclient.conf.5,v 1.52 2022/03/31 17:27:19 naddy Exp $
.\"
.\" Copyright (c) 1997 The Internet Software Consortium.
.\" All rights reserved.
.\" see ``http://www.isc.org/isc''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
.\"
-.Dd $Mdocdate: July 17 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCLIENT.CONF 5
.Os
.Sh NAME
the first acceptable lease received.
.It Ic timeout Ar seconds ;
Sets the number of seconds to wait for a lease.
-If no lease is received the first valid lease in
+If no lease is received, the first valid lease in
.Xr dhclient.leases 5
will be used.
The default is 30 seconds.
.It Ic default Ar option option-value ;
If no value for
.Ar option
-is present in the lease use
+is present in the lease, use
.Ar option-value .
Each
.Ic default
statements are cumulative.
If no
.Ar option
-is specified all lease option values will be used unmodified.
+is specified, all lease option values will be used unmodified.
.Ic uselease
for
.Ar option
Discard leases from the specified address.
If more than one
.Ic reject
-is present all leases from any of the
+is present, all leases from any of the
addresses will be discarded.
.It Ic next-server Ar ip-address ;
Use
-.\" $OpenBSD: dhcpleased.conf.5,v 1.9 2022/01/04 06:20:37 florian Exp $
+.\" $OpenBSD: dhcpleased.conf.5,v 1.10 2022/03/31 17:27:19 naddy Exp $
.\"
.\" Copyright (c) 2018, 2021 Florian Obser <florian@openbsd.org>
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 4 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCPLEASED.CONF 5
.Os
.Sh NAME
.Pp
When
.Ar client-id
-is not a hardware address it is supposed to be sent as hardware type 0 but
+is not a hardware address, it is supposed to be sent as hardware type 0 but
the majority of DHCP clients and servers do not implement this and neither
does
.Nm .
-.\" $OpenBSD: disklabel.8,v 1.145 2022/02/19 22:08:27 krw Exp $
+.\" $OpenBSD: disklabel.8,v 1.146 2022/03/31 17:27:19 naddy Exp $
.\" $NetBSD: disklabel.8,v 1.9 1995/03/18 14:54:38 cgd Exp $
.\"
.\" Copyright (c) 1987, 1988, 1991, 1993
.\"
.\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94
.\"
-.Dd $Mdocdate: February 19 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DISKLABEL 8
.Os
.Sh NAME
is given, the size and offsets are displayed in terms of the
specified unit.
If the unit is
-.Sq *
+.Sq * ,
it is automatically determined by the size of the smallest
partition.
.It Cm q
-.\" $OpenBSD: fdisk.8,v 1.111 2022/03/13 12:57:29 krw Exp $
+.\" $OpenBSD: fdisk.8,v 1.112 2022/03/31 17:27:19 naddy Exp $
.\"
.\"
.\" Copyright (c) 1997 Tobias Weingartner
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 13 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FDISK 8
.Os
.Sh NAME
If the preserved
.Sq EFI system
partition has fewer blocks than the number requested with
-.Fl b
+.Fl b ,
the modification of the GPT is aborted.
.It Fl b Ar blocks Ns Op @ Ns Ar offset Ns Op : Ns Ar type
Configures a special boot partition of the specified number of blocks, offset
.Pp
If
.Ar disk
-does not contain a valid GPT the contents of the MBR are displayed.
+does not contain a valid GPT, the contents of the MBR are displayed.
For example:
.Bd -literal -offset 1n
# fdisk sd0
Number identifying each partition table entry.
.It Em "type"
The partition type identifier.
-If the type is recognized the name of the type is displayed.
+If the type is recognized, the name of the type is displayed.
Otherwise the type GUID is displayed.
.It Em "start"
The sector the partition starts on.
By default an MBR is initialized.
If
.Cm gpt
-is specified a protective MBR and a GPT are initialized.
+is specified, a protective MBR and a GPT are initialized.
.It Cm edit Ar #
Edit a given table entry in the memory copy of
the current boot block.
-.\" $OpenBSD: fsck_ext2fs.8,v 1.18 2015/10/14 14:33:45 deraadt Exp $
+.\" $OpenBSD: fsck_ext2fs.8,v 1.19 2022/03/31 17:27:19 naddy Exp $
.\" $NetBSD: fsck_ext2fs.8,v 1.1 1997/06/11 11:21:48 bouyer Exp $
.\"
.\" Copyright (c) 1997 Manuel Bouyer.
.\"
.\" @(#)fsck.8 8.3 (Berkeley) 11/29/94
.\"
-.Dd $Mdocdate: October 14 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FSCK_EXT2FS 8
.Os
.Sh NAME
If the
.Pa lost+found
directory does not exist, it is created.
-If there is insufficient space its size is increased.
+If there is insufficient space, its size is increased.
.Pp
Because of inconsistencies between the block device and the buffer cache,
the raw device should always be used.
-.\" $OpenBSD: fsck_ffs.8,v 1.27 2021/03/08 02:47:26 jsg Exp $
+.\" $OpenBSD: fsck_ffs.8,v 1.28 2022/03/31 17:27:19 naddy Exp $
.\" $NetBSD: fsck_ffs.8,v 1.12 1996/09/23 16:18:34 christos Exp $
.\"
.\" Copyright (c) 1980, 1989, 1991, 1993
.\"
.\" @(#)fsck.8 8.3 (Berkeley) 11/29/94
.\"
-.Dd $Mdocdate: March 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FSCK_FFS 8
.Os
.Sh NAME
.Ar block#
specified as
the super block for the file system.
-If the primary superblock is corrupted
+If the primary superblock is corrupted,
.Nm
tries to find a valid alternate superblock based on the
information in the disklabel.
If the
.Pa lost+found
directory does not exist, it is created.
-If there is insufficient space its size is increased.
+If there is insufficient space, its size is increased.
.Pp
Because of inconsistencies between the block device and the buffer cache,
the raw device should always be used.
-.\" $OpenBSD: isakmpd.conf.5,v 1.137 2022/02/06 00:29:02 jsg Exp $
+.\" $OpenBSD: isakmpd.conf.5,v 1.138 2022/03/31 17:27:20 naddy Exp $
.\" $EOM: isakmpd.conf.5,v 1.57 2000/12/21 14:43:17 ho Exp $
.\"
.\" Copyright (c) 1998, 1999, 2000 Niklas Hallqvist. All rights reserved.
.\"
.\" Manual page, using -mandoc macros
.\"
-.Dd $Mdocdate: February 6 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ISAKMPD.CONF 5
.Os
.Sh NAME
keyword uses the interface associated with the default route.
In the case of IPv6, link-local addresses will be skipped if
addresses which are not link-local exist.
-If the address on the interface changes
+If the address on the interface changes,
.Xr isakmpd 8
will not track the change.
The configuration must be reloaded to learn the new address.
-.\" $OpenBSD: newfs_ext2fs.8,v 1.10 2020/01/16 16:46:47 schwarze Exp $
+.\" $OpenBSD: newfs_ext2fs.8,v 1.11 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: newfs_ext2fs.8,v 1.7 2009/12/01 08:47:25 pooka Exp $
.\"
.\" Copyright (c) 1983, 1987, 1991, 1993, 1994
.\"
.\" @(#)newfs.8 8.6 (Berkeley) 5/3/95
.\"
-.Dd $Mdocdate: January 16 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt NEWFS_EXT2FS 8
.Os
.Sh NAME
.Nm
is used to initialize and clear ext2 file systems before first use.
Before running
-.Nm
+.Nm ,
the disk must be labeled using
.Xr disklabel 8 .
.Nm
.Pp
If
.Ar size
-is negative the specified size is subtracted from the default size
+is negative, the specified size is subtracted from the default size
(reserving space at the end of the partition).
.It Fl V Ar verbose
This controls the amount of information written to stdout:
The default is 4.
If
.Fl N
-is specified
+is specified,
.Nm
stops before outputting the progress bar.
.It Fl v Ar volname
-.\" $OpenBSD: restore.8,v 1.40 2015/11/21 19:43:50 jmc Exp $
+.\" $OpenBSD: restore.8,v 1.41 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: restore.8,v 1.15 1997/07/01 05:37:53 lukem Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\"
.\" @(#)restore.8 8.3 (Berkeley) 6/1/94
.\"
-.Dd $Mdocdate: November 21 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RESTORE 8
.Os
.Sh NAME
Always try to skip over the bad block(s) and continue.
.El
.Sh ENVIRONMENT
-If the following environment variable exists it will be utilized by
+If the following environment variable exists, it will be utilized by
.Nm restore :
.Bl -tag -width "TMPDIR"
.It Ev TMPDIR
-.\" $OpenBSD: route.8,v 1.102 2021/10/26 15:48:25 kn Exp $
+.\" $OpenBSD: route.8,v 1.103 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: route.8,v 1.6 1995/03/18 15:00:13 cgd Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)route.8 8.3 (Berkeley) 3/19/94
.\"
-.Dd $Mdocdate: October 26 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ROUTE 8
.Os
.Sh NAME
in the delineated family will be shown.
If the
.Fl iface
-modifier is used only interface specific messages (link state changes)
+modifier is used, only interface specific messages (link state changes)
are shown.
If a routing table is supplied with
.Fl T ,
.Tg
.Fl priority
qualifier.
-If no priority is specified the kernel will set a priority depending on the
+If no priority is specified, the kernel will set a priority depending on the
.Dv RTF_STATIC
flag to either
.Dv RTP_STATIC
-.\" $OpenBSD: shutdown.8,v 1.40 2015/01/21 19:29:52 naddy Exp $
+.\" $OpenBSD: shutdown.8,v 1.41 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: shutdown.8,v 1.6 1995/03/18 15:01:07 cgd Exp $
.\"
.\" Copyright (c) 1988, 1991, 1993
.\"
.\" @(#)shutdown.8 8.1 (Berkeley) 6/5/93
.\"
-.Dd $Mdocdate: January 21 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SHUTDOWN 8
.Os
.Sh NAME
would otherwise not bother with such niceties.
When the
.Nm
-command is issued without options the system is placed in single
+command is issued without options, the system is placed in single
user mode at the indicated time after shutting down all system
services.
.Pp
-.\" $OpenBSD: unwind.conf.5,v 1.31 2021/10/24 15:57:17 kn Exp $
+.\" $OpenBSD: unwind.conf.5,v 1.32 2022/03/31 17:27:20 naddy Exp $
.\"
.\" Copyright (c) 2018 Florian Obser <florian@openbsd.org>
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: October 24 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt UNWIND.CONF 5
.Os
.Sh NAME
.Bl -tag -width Ds
.It Ic block list Ar file Op Cm log
A file containing domains to block, one per line.
-If a domain from this list is queried
+If a domain from this list is queried,
.Nm unwind
answers with a return code of
.Dv REFUSED .
.Ar type .
If
.Cm accept bogus
-is specified validation is not enforced.
+is specified, validation is not enforced.
.El
.Sh FILES
.Bl -tag -width "/etc/unwind.conf" -compact
-.\" $OpenBSD: audio.4,v 1.86 2020/11/01 21:32:03 jmc Exp $
+.\" $OpenBSD: audio.4,v 1.87 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: audio.4,v 1.20 1998/05/28 17:27:15 augustss Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 1 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt AUDIO 4
.Os
.Sh NAME
If a writing process does not call
.Xr write 2
frequently enough to provide samples at the pace the hardware
-consumes them silence is inserted.
+consumes them, silence is inserted.
If a reading process does not call
.Xr read 2
frequently enough, it will simply miss samples.
otherwise they are unsigned.
.It Va le
If set then the byte order is little endian;
-if not it is big endian.
+if not, it is big endian.
It is meaningful only if
.Va bps
> 1.
-.\" $OpenBSD: bridge.4,v 1.82 2021/11/11 17:33:10 jmc Exp $
+.\" $OpenBSD: bridge.4,v 1.83 2022/03/31 17:27:20 naddy Exp $
.\"
.\" Copyright (c) 1999-2001 Jason L. Wright (jason@thought.net)
.\" All rights reserved.
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 11 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BRIDGE 4
.Os
.Sh NAME
.Xr pf 4
filters once as input on the receiving interface and once
as output on all interfaces on which they are forwarded.
-In order to pass through the bridge packets must pass
+In order to pass through the bridge, packets must pass
any
.Ar in
rules on the input and any
-.\" $OpenBSD: cac.4,v 1.25 2015/04/18 12:04:59 jmc Exp $
+.\" $OpenBSD: cac.4,v 1.26 2022/03/31 17:27:20 naddy Exp $
.\"
.\" Michael Shalayeff, 2000. Public Domain.
.\"
-.Dd $Mdocdate: April 18 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CAC 4
.Os
.Sh NAME
.Pp
All the RAID set volume management is done via the card BIOS.
.Pp
-Although the controllers are actual RAID controllers the driver makes them
+Although the controllers are actual RAID controllers, the driver makes them
look just like SCSI controllers.
All RAID configuration is done through the controllers' BIOSes.
.Pp
-.\" $OpenBSD: carp.4,v 1.41 2022/02/06 00:29:02 jsg Exp $
+.\" $OpenBSD: carp.4,v 1.42 2022/03/31 17:27:20 naddy Exp $
.\"
.\" Copyright (c) 2003, Ryan McBride. All rights reserved.
.\"
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 6 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CARP 4
.Os
.Sh NAME
balancing ip
.Ed
.Pp
-If a different mode of load balancing is desired the
+If a different mode of load balancing is desired, the
.Cm balancing
mode can be adjusted accordingly.
.Sh SEE ALSO
-.\" $OpenBSD: ddb.4,v 1.100 2021/11/16 13:53:14 bluhm Exp $
+.\" $OpenBSD: ddb.4,v 1.101 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: ddb.4,v 1.5 1994/11/30 16:22:09 jtc Exp $
.\"
.\" Mach Operating System
.\" any improvements or extensions that they make and grant Carnegie Mellon
.\" the rights to redistribute these changes.
.\"
-.Dd $Mdocdate: November 16 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DDB 4
.Os
.Sh NAME
.Ar addr .
If the
.Cm /f
-modifier is specified the complete map is printed.
+modifier is specified, the complete map is printed.
.\" --------------------
.It Ic show mbuf Ar addr
Prints the
.Ar addr .
If the
.Cm /f
-modifier is specified prints out all
+modifier is specified, prints out all
.Li vnodes
(see also
.Cm show vnode )
.Ar addr .
If the
.Cm /f
-modifier is specified prints out additional
+modifier is specified, prints out additional
information as well.
.\" --------------------
.It Xo
.Ar addr .
If the
.Cm /f
-modifier is specified prints out additional
+modifier is specified, prints out additional
information as well.
.\" --------------------
.It Xo
.Ar addr .
If the
.Cm /f
-modifier is specified the complete object is printed.
+modifier is specified, the complete object is printed.
.\" --------------------
.It Xo
.Ic show page
.Ar addr .
If the
.Cm /f
-modifier is specified the complete page is printed.
+modifier is specified, the complete page is printed.
.\" --------------------
.It Ic show panic
Prints the panic string.
.Li struct proc
at
.Ar addr .
-If an optional address is not specified
+If an optional address is not specified,
.Li curproc
is assumed.
.\" --------------------
.Ar addr .
If the
.Cm /f
-modifier is specified prints out all fields of this IPsec SA.
+modifier is specified, prints out all fields of this IPsec SA.
.\" --------------------
.It Ic show uvmexp
Displays a selection of uvm counters and statistics.
.Ar addr .
If the
.Cm /f
-modifier is specified prints out all
+modifier is specified, prints out all
.Li bufs
(see also
.Cm show buf )
-.\" $OpenBSD: divert.4,v 1.18 2017/10/06 21:14:55 bluhm Exp $
+.\" $OpenBSD: divert.4,v 1.19 2022/03/31 17:27:20 naddy Exp $
.\"
.\" Copyright (c) 2009 Michele Marchetto <michele@openbsd.org>
.\" Copyright (c) 2012-2014 Lawrence Teo <lteo@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: October 6 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DIVERT 4
.Os
.Sh NAME
parameter
(see
.Xr pf.conf 5
-for details) it is sent to the divert socket listening on the
+for details), it is sent to the divert socket listening on the
divert port specified in the rule.
Note that
.Ar divert-packet
-.\" $OpenBSD: ess.4,v 1.11 2008/06/26 05:42:06 ray Exp $
+.\" $OpenBSD: ess.4,v 1.12 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: ess.4,v 1.6 1999/04/13 20:25:29 augustss Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 26 2008 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ESS 4
.Os
.Sh NAME
The first DRQ channel must be selected from 0, 1, 3.
The second DRQ channel (used for playback by the full-duplex 1888/1887, ignored
by the 1788) can additionally be set to 5.
-If both DRQ channels are used they must be different.
+If both DRQ channels are used, they must be different.
.Pp
The joystick interface (if enabled) is handled by the
.Xr joy 4
-.\" $OpenBSD: ifmedia.4,v 1.28 2021/01/21 11:05:38 kevlo Exp $
+.\" $OpenBSD: ifmedia.4,v 1.29 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: ifmedia.4,v 1.14 2001/06/30 17:57:56 bjh21 Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt IFMEDIA 4
.Os
.Sh NAME
.El
.Pp
The channels do overlap; the bandwidth required for each channel is about 20MHz.
-When using multiple channels in close proximity it is suggested
+When using multiple channels in close proximity, it is suggested
that channels be separated by at least 25MHz.
In the US, this means that only channels 1, 6, and 11 may be used
simultaneously without interference.
-.\" $OpenBSD: ip.4,v 1.43 2021/01/08 23:33:12 jmc Exp $
+.\" $OpenBSD: ip.4,v 1.44 2022/03/31 17:27:20 naddy Exp $
.\" $NetBSD: ip.4,v 1.3 1994/11/30 16:22:19 jtc Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)ip.4 8.2 (Berkeley) 11/30/93
.\"
-.Dd $Mdocdate: January 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt IP 4
.Os
.Sh NAME
structure followed by flow information in 32-bit network byte order.
When this information is passed to a
.Xr sendmsg 2
-call the ID of the incoming SA will be used for looking up the
+call, the ID of the incoming SA will be used for looking up the
outgoing SA for the
.Tn UDP
datagram.
-.\" $OpenBSD: ipsec.4,v 1.87 2022/02/18 23:17:15 jsg Exp $
+.\" $OpenBSD: ipsec.4,v 1.88 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de>
.\" All rights reserved.
.\"
.\" Manual page, using -mandoc macros
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt IPSEC 4
.Os
.Sh NAME
.It Integrity
\- Guarantee that the data does not get changed
in transit.
-If you are on a line carrying invoicing data you
+If you are on a line carrying invoicing data, you
probably want to know that the amounts and account numbers
are correct and have not been modified by a third party.
.It Authenticity
and for IKEv2 in
.Xr iked.conf 5 .
.Ss Security Parameter Indexes (SPIs)
-In order to identify an SA we need to have a unique name for it.
+In order to identify an SA, we need to have a unique name for it.
This name is a triplet, consisting of the destination address, security
parameter index (aka SPI) and the security protocol (ESP or AH).
Since the destination address is part of the name, an SA is necessarily a
This level is necessary for the key management daemon,
.Xr isakmpd 8 .
.It IPSEC_LEVEL_AVAIL
-If a Security Association is available it will be used for sending packets
+If a Security Association is available, it will be used for sending packets
by that socket.
.It IPSEC_LEVEL_USE
Use IP Security for sending packets but still accept packets which are not
-.\" $OpenBSD: ksyms.4,v 1.14 2019/01/25 00:19:26 millert Exp $
+.\" $OpenBSD: ksyms.4,v 1.15 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 1998 Todd C. Miller <millert@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 25 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt KSYMS 4
.Os
.Sh NAME
.Pa /dev/ksyms
device is used to look up the symbol table name list from the running
kernel.
-Because it represents the running kernel it is guaranteed
+Because it represents the running kernel, it is guaranteed
to always be up to date even if the kernel file has been changed (or
is even non-existent).
It is most useful when used in conjunction with
-.\" $OpenBSD: intro.4,v 1.45 2014/09/19 12:24:37 schwarze Exp $
+.\" $OpenBSD: intro.4,v 1.46 2022/03/31 17:27:21 naddy Exp $
.\" $NetBSD: intro.4,v 1.10 2003/05/06 07:44:54 wiz Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 19 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 alpha
.Os
.Sh NAME
the system probe for the device and, if found, enable the software support
for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: apm.4,v 1.8 2019/01/23 22:33:43 jsg Exp $
+.\" $OpenBSD: apm.4,v 1.9 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 1998 Marco S. Hyman
.\"
.\" LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
.\" FOR A PARTICULAR PURPOSE.
.\"
-.Dd $Mdocdate: January 23 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt APM 4 amd64
.Os
.Sh NAME
.Dv APM_NEVENTS
events.
This was defined as 16 at the time this documentation was written.
-If the event list is full when a new event is detected the new event is lost.
+If the event list is full when a new event is detected, the new event is lost.
.Dv APM_IOC_NEXTEVENT
ioctl returns the next event on the list or
.Er EAGAIN
-.\" $OpenBSD: intro.4,v 1.37 2014/12/10 07:33:20 jmc Exp $
+.\" $OpenBSD: intro.4,v 1.38 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 10 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 amd64
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: apm.4,v 1.4 2021/03/20 19:41:44 kn Exp $
+.\" $OpenBSD: apm.4,v 1.5 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 1998 Marco S. Hyman
.\"
.\" LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
.\" FOR A PARTICULAR PURPOSE.
.\"
-.Dd $Mdocdate: March 20 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt APM 4 arm64
.Os
.Sh NAME
.Dv APM_NEVENTS
events.
This was defined as 16 at the time this documentation was written.
-If the event list is full when a new event is detected the new event is lost.
+If the event list is full when a new event is detected, the new event is lost.
.Dv APM_IOC_NEXTEVENT
ioctl returns the next event on the list or
.Er EAGAIN
-.\" $OpenBSD: intro.4,v 1.1 2018/04/04 14:21:26 jsg Exp $
+.\" $OpenBSD: intro.4,v 1.2 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2014 Sylvestre Gallon <syl@openbsd.org>
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: April 4 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 arm64
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: intro.4,v 1.4 2018/07/10 03:23:11 jsg Exp $
+.\" $OpenBSD: intro.4,v 1.5 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2014 Sylvestre Gallon <syl@openbsd.org>
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: July 10 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 armv7
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: intro.4,v 1.24 2020/12/22 10:33:34 tobias Exp $
+.\" $OpenBSD: intro.4,v 1.25 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2002,2003 Paul Weissmann
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 22 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 hppa
.Os
.Sh NAME
in the system probe for the device and, if found,
enable the software support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure, the system must be rebooted.
.Pp
The autoconfiguration system is described in
-.\" $OpenBSD: pdc.4,v 1.11 2020/12/22 10:33:34 tobias Exp $
+.\" $OpenBSD: pdc.4,v 1.12 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2004 Michael Shalayeff
.\" All rights reserved.
.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
.\" THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 22 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PDC 4 hppa
.Os
.Sh NAME
will contain the resulting masks as returned
by the PDC_MODEL_GETBOOTOPTS function.
If an attempt is made to enable and disable the same test in one
-call a PDC_ERR_INVAL will be returned.
+call, a PDC_ERR_INVAL will be returned.
.It Fn pdc "PDC_NVM" "PDC_NVM_READ" "offset" "ptr" "count"
Read contents of the NVM at
.Ar offset
-.\" $OpenBSD: apm.4,v 1.34 2019/01/23 22:33:43 jsg Exp $
+.\" $OpenBSD: apm.4,v 1.35 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 1998 Marco S. Hyman
.\"
.\" LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
.\" FOR A PARTICULAR PURPOSE.
.\"
-.Dd $Mdocdate: January 23 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt APM 4 i386
.Os
.Sh NAME
.Dv APM_NEVENTS
events.
This was defined as 16 at the time this documentation was written.
-If the event list is full when a new event is detected the new event is lost.
+If the event list is full when a new event is detected, the new event is lost.
.Dv APM_IOC_NEXTEVENT
ioctl returns the next event on the list or
.Er EAGAIN
-.\" $OpenBSD: intro.4,v 1.84 2014/09/19 12:24:37 schwarze Exp $
+.\" $OpenBSD: intro.4,v 1.85 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 19 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 i386
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: pcibios.4,v 1.24 2022/02/06 00:29:02 jsg Exp $
+.\" $OpenBSD: pcibios.4,v 1.25 2022/03/31 17:27:21 naddy Exp $
.\" $NetBSD: pcibios.4,v 1.7 2000/08/03 13:32:39 soda Exp $
.\"
.\" Copyright (c) 2000 Michael Shalayeff, All rights reserved.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 6 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PCIBIOS 4 i386
.Os
.Sh NAME
the PCI Interrupt Configuration Register and the PCI Interrupt Routing table.
In such cases, the PCI Interrupt Configuration Register takes precedence
by default.
-If this flag is specified the PCI Interrupt Routing table takes precedence.
+If this flag is specified, the PCI Interrupt Routing table takes precedence.
.El
.\" .It Nm PCIBIOS_IRQS_HINT
.\" hint for IRQ use.
-.\" $OpenBSD: intro.4,v 1.7 2014/09/19 12:24:37 schwarze Exp $
+.\" $OpenBSD: intro.4,v 1.8 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 19 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 landisk
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: apm.4,v 1.6 2019/01/23 22:33:43 jsg Exp $
+.\" $OpenBSD: apm.4,v 1.7 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1999 Jason L. Wright (jason@thought.net)
.\" All rights reserved.
.\" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT
.\" LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
.\" FOR A PARTICULAR PURPOSE.
-.Dd $Mdocdate: January 23 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt APM 4 loongson
.Os
.Sh NAME
.\" .Dv APM_NEVENTS
.\" events.
.\" This was defined as 16 at the time this documentation was written.
-.\" If the event list is full when a new event is detected the new event is lost.
+.\" If the event list is full when a new event is detected, the new event is lost.
.\" .Dv APM_IOC_NEXTEVENT
.\" ioctl returns the next event on the list or
.\" .Er EAGAIN
-.\" $OpenBSD: intro.4,v 1.4 2014/09/19 12:24:37 schwarze Exp $
+.\" $OpenBSD: intro.4,v 1.5 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" from: @(#)intro.4 5.2 (Berkeley) 3/27/91
.\"
-.Dd $Mdocdate: September 19 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 loongson
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: intro.4,v 1.9 2014/09/19 12:24:38 schwarze Exp $
+.\" $OpenBSD: intro.4,v 1.10 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" from: @(#)intro.4 5.2 (Berkeley) 3/27/91
.\"
-.Dd $Mdocdate: September 19 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 luna88k
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: apm.4,v 1.15 2021/03/20 19:36:29 kn Exp $
+.\" $OpenBSD: apm.4,v 1.16 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1998 Marco S. Hyman
.\"
.\" LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
.\" FOR A PARTICULAR PURPOSE.
.\"
-.Dd $Mdocdate: March 20 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt APM 4 macppc
.Os
.Sh NAME
.Dv APM_NEVENTS
events.
This was defined as 16 at the time this documentation was written.
-If the event list is full when a new event is detected the new event is lost.
+If the event list is full when a new event is detected, the new event is lost.
.Dv APM_IOC_NEXTEVENT
ioctl returns the next event on the list or
.Er EAGAIN
-.\" $OpenBSD: intro.4,v 1.52 2014/09/19 12:24:38 schwarze Exp $
+.\" $OpenBSD: intro.4,v 1.53 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 19 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 macppc
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: xlights.4,v 1.3 2007/05/31 19:19:55 jmc Exp $
+.\" $OpenBSD: xlights.4,v 1.4 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 2007 Gordon Willem Klok <gwk@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: March 31 2022 $
.Dt XLIGHTS 4 macppc
.Os
.Sh NAME
The lights provide an indication of system load and health.
System load is indicated by three dots travelling in a ring around the sixteen
LEDs found on the front panel.
-When the system is lightly loaded these dots travel quickly and slow down
+When the system is lightly loaded, these dots travel quickly and slow down
as system load increases.
System health is indicated by the absence of the dots which
means a hung machine or one that is in
-.\" $OpenBSD: intro.4,v 1.1 2021/08/06 06:35:13 jsg Exp $
+.\" $OpenBSD: intro.4,v 1.2 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 6 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 octeon
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: intro.4,v 1.2 2021/05/20 00:58:53 jsg Exp $
+.\" $OpenBSD: intro.4,v 1.3 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 2014 Sylvestre Gallon <syl@openbsd.org>
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 20 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 powerpc64
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: intro.4,v 1.1 2021/08/06 06:35:13 jsg Exp $
+.\" $OpenBSD: intro.4,v 1.2 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 6 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 riscv64
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: intro.4,v 1.62 2014/09/19 12:24:38 schwarze Exp $
+.\" $OpenBSD: intro.4,v 1.63 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 1983, 1986, 1991 Regents of the University of California.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 19 2014 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INTRO 4 sparc64
.Os
.Sh NAME
in the system probe for the device and, if found, enable the software
support for it.
If a device does not respond at autoconfiguration
-time it is not accessible at any time afterwards.
+time, it is not accessible at any time afterwards.
To enable a device which did not autoconfigure,
the system will have to be rebooted.
.Pp
-.\" $OpenBSD: midi.4,v 1.29 2016/08/31 13:54:58 jmc Exp $
+.\" $OpenBSD: midi.4,v 1.30 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2006 Alexandre Ratchov <alex@caoua.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: August 31 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MIDI 4
.Os
.Sh NAME
.Nm
device at a given time, although file descriptors may be shared
between processes once the first open completes.
-If it is opened read-only (write-only) only the input (output)
+If it is opened read-only (write-only), only the input (output)
MIDI port is available.
.Ss Writing to the device
A process can send raw MIDI data to the output port by using the
-.\" $OpenBSD: rdomain.4,v 1.17 2020/09/24 11:05:32 kn Exp $
+.\" $OpenBSD: rdomain.4,v 1.18 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2015 Peter Hessler <phessler@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: September 24 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RDOMAIN 4
.Os
.Sh NAME
.Nm rdomain .
.Pp
When an interface is assigned to a non-existent
-.Nm rdomain
+.Nm rdomain ,
it gets created automatically.
At the same time an
.Nm rtable
-.\" $OpenBSD: rtw.4,v 1.47 2022/02/18 10:24:32 jsg Exp $
+.\" $OpenBSD: rtw.4,v 1.48 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2004 Jonathan Gray <jsg@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RTW 4
.Os
.Sh NAME
.Sh CAVEATS
GCT refuse to release any documentation on their GRF5101 RF transceiver.
.Pp
-While PCI devices will attach most of them are not able to transmit.
+While PCI devices will attach, most of them are not able to transmit.
.Pp
Host AP mode doesn't support power saving.
Clients attempting to use power saving mode may experience significant
-.\" $OpenBSD: st.4,v 1.20 2016/09/04 14:42:58 naddy Exp $
+.\" $OpenBSD: st.4,v 1.21 2022/03/31 17:27:21 naddy Exp $
.\" $NetBSD: st.4,v 1.2 1996/10/20 23:15:24 explorer Exp $
.\"
.\" Copyright (c) 1996
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 4 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ST 4
.Os
.Sh NAME
Rewind the device to the beginning of the media.
.It Dv MTOFFL
Rewind the media (and, if possible, eject).
-Even if the device cannot eject the media it will often no longer respond
+Even if the device cannot eject the media, it will often no longer respond
to normal requests.
.It Dv MTNOP
No-op; set status only.
-.\" $OpenBSD: tcp.4,v 1.24 2018/05/11 12:02:28 zhuk Exp $
+.\" $OpenBSD: tcp.4,v 1.25 2022/03/31 17:27:21 naddy Exp $
.\" $NetBSD: tcp.4,v 1.3 1994/11/30 16:22:35 jtc Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)tcp.4 8.1 (Berkeley) 6/5/93
.\"
-.Dd $Mdocdate: May 11 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TCP 4
.Os
.Sh NAME
.Tn TCP
port may still be specified
at this time; if the port is not specified the system will assign one.
-Once a connection has been established the socket's address is
+Once a connection has been established, the socket's address is
fixed by the peer entity's location.
The address assigned to the socket is the address associated with
the network interface through which packets are being transmitted
-.\" $OpenBSD: ugen.4,v 1.18 2021/01/27 17:28:19 mglocker Exp $
+.\" $OpenBSD: ugen.4,v 1.19 2022/03/31 17:27:21 naddy Exp $
.\" $NetBSD: ugen.4,v 1.7 1999/07/30 01:32:05 augustss Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 27 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt UGEN 4
.Os
.Sh NAME
endpoint the device accesses and the rest of the bits determine which
USB device.
.Pp
-If an endpoint address is used both for input and output the device
+If an endpoint address is used both for input and output, the device
can be opened for both read or write.
.Pp
To find out what endpoints exist there are a series of
.\" and
.\" .Xr write 2
.\" should be used.
-.\" Before any I/O operations can take place the transfer rate in
+.\" Before any I/O operations can take place, the transfer rate in
.\" bytes/second has to be set. This is done with
.\" .Xr ioctl 2
.\" .Dv USB_SET_ISO_RATE .
-.\" $OpenBSD: video.4,v 1.19 2020/12/29 12:28:23 mglocker Exp $
+.\" $OpenBSD: video.4,v 1.20 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2008 Marcus Glocker <mglocker@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: December 29 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt VIDEO 4
.Os
.Sh NAME
.It
Process video data and start over again with step 2.
.It
-When finished stop the video stream via the
+When finished, stop the video stream via the
.Xr close 2
system call.
.El
Dequeue one buffer via the
.Dv VIDIOC_DQBUF
ioctl command.
-If the queue is empty
+If the queue is empty,
the ioctl will block until a buffer gets queued or an error occurs
(e.g. a timeout).
.It
.Dv VIDIOC_QBUF
ioctl command and start over again with step 6.
.It
-When finished stop the video stream via the
+When finished, stop the video stream via the
.Dv VIDIOC_STREAMOFF
ioctl command.
.El
-.\" $OpenBSD: vlan.4,v 1.51 2020/10/04 12:44:49 kn Exp $
+.\" $OpenBSD: vlan.4,v 1.52 2022/03/31 17:27:21 naddy Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 4 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt VLAN 4
.Os
.Sh NAME
will use 0 in their protocols tag field.
.It Dv SIOCSIFLLADDR Fa "struct ifreq *"
Configure a custom MAC address on the virtual interface.
-When the virtual interface is using a custom MAC address the parent
+When the virtual interface is using a custom MAC address, the parent
interface will be configured to promiscuously receive packets.
-When operating without a custom MAC address the virtual interface
+When operating without a custom MAC address, the virtual interface
will inherit the parent interfaces MAC address.
Configuring 00:00:00:00:00:00 as the MAC address will clear the
custom MAC address configuration and resume operation with the
-.\" $OpenBSD: wsdisplay.4,v 1.56 2020/09/18 18:06:06 jmc Exp $
+.\" $OpenBSD: wsdisplay.4,v 1.57 2022/03/31 17:27:21 naddy Exp $
.\" $NetBSD: wsdisplay.4,v 1.5 2000/05/13 15:22:19 mycroft Exp $
.\"
.\" Copyright (c) 2005, Miodrag Vallat.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 18 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt WSDISPLAY 4
.Os
.Sh NAME
locator in the configuration line refers to the
.Xr wsmux 4
that will be used to get keyboard events.
-If this locator is -1 no mux will be used.
+If this locator is -1, no mux will be used.
.Pp
The logical unit of an independent contents displayed on a display
(sometimes referred to as
-.\" $OpenBSD: wsmux.4,v 1.14 2008/06/26 05:42:07 ray Exp $
+.\" $OpenBSD: wsmux.4,v 1.15 2022/03/31 17:27:21 naddy Exp $
.\" $NetBSD: wsmux.4,v 1.2 1999/11/03 22:01:40 castor Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 26 2008 $
+.Dd $Mdocdate: March 31 2022 $
.Dt WSMUX 4
.Os
.Sh NAME
A device will send its events to the mux indicated by the
.Va mux
locator.
-If none is given the device will not use a multiplexor.
+If none is given, the device will not use a multiplexor.
The keyboard multiplexor should be connected to the display, using
the
.Xr wsconscfg 8
-.\" $OpenBSD: bsd.regress.mk.5,v 1.23 2022/01/01 03:57:20 jsg Exp $
+.\" $OpenBSD: bsd.regress.mk.5,v 1.24 2022/03/31 17:27:22 naddy Exp $
.\"
.\" Copyright (c) 2002 Anil Madhavapeddy
.\" Copyright (c) 2000 Marc Espie
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: January 1 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BSD.REGRESS.MK 5
.Os
.Sh NAME
.Ev MALLOC_OPTIONS
unless it is testing specific behaviour that depends on a particular
flag or combination of flags.
-When running tests the appropriate sysctl
+When running tests, the appropriate sysctl
.Pq vm.malloc_conf
could be used instead.
.Sh SEE ALSO
-.\" $OpenBSD: elf.5,v 1.41 2022/02/14 08:14:19 kevlo Exp $
+.\" $OpenBSD: elf.5,v 1.42 2022/03/31 17:27:22 naddy Exp $
.\"Copyright (c) 1999 Jeroen Ruigrok van der Werven
.\"All rights reserved.
.\"
.\"
.\" $FreeBSD: src/share/man/man5/elf.5,v 1.21 2001/10/01 16:09:23 ru Exp $
.\"
-.Dd $Mdocdate: February 14 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ELF 5
.Os
.Sh NAME
.It Dv e_shoff
This member holds the section header table's file offset in bytes.
If the
-file has no section header table this member holds zero.
+file has no section header table, this member holds zero.
.It Dv e_flags
This member holds processor-specific flags associated with the file.
Flag names take the form EF_`machine_flag'.
.It .fini
This section holds executable instructions that contribute to the process
termination code.
-When a program exits normally the system arranges to
+When a program exits normally, the system arranges to
execute the code in this section.
This section is of type
.Dv SHT_PROGBITS .
.It .init
This section holds executable instructions that contribute to the process
initialization code.
-When a program starts to run the system arranges to
+When a program starts to run, the system arranges to
execute the code in this section before calling the main program entry point.
This section is of type
.Dv SHT_PROGBITS .
-.\" $OpenBSD: fstab.5,v 1.53 2015/09/10 17:55:21 schwarze Exp $
+.\" $OpenBSD: fstab.5,v 1.54 2022/03/31 17:27:22 naddy Exp $
.\" $NetBSD: fstab.5,v 1.5.2.1 1995/11/16 20:11:11 pk Exp $
.\"
.\" Copyright (c) 1980, 1989, 1991, 1993
.\"
.\" @(#)fstab.5 8.1 (Berkeley) 6/5/93
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FSTAB 5
.Os
.Sh NAME
If
.Fa fs_type
is specified as
-.Dq xx
+.Dq xx ,
the entry is ignored.
This is useful to show disk partitions which are currently unused.
.Pp
-.\" $OpenBSD: hosts.5,v 1.25 2019/05/28 14:17:56 brynet Exp $
+.\" $OpenBSD: hosts.5,v 1.26 2022/03/31 17:27:23 naddy Exp $
.\" $NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)hosts.5 8.2 (Berkeley) 12/11/93
.\"
-.Dd $Mdocdate: May 28 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt HOSTS 5
.Os
.Sh NAME
.Nm hosts
database.
.Pp
-When using a name server
+When using a name server,
this file provides a backup when the name server is not running.
For the name server, it is suggested that only a few addresses
be included in this file.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: login.conf.5,v 1.69 2022/03/01 01:22:11 tedu Exp $
+.\" $OpenBSD: login.conf.5,v 1.70 2022/03/31 17:27:23 naddy Exp $
.\" BSDI $From: login.conf.5,v 2.20 2000/06/26 14:50:38 prb Exp $
.\"
-.Dd $Mdocdate: March 1 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt LOGIN.CONF 5
.Os
.Sh NAME
.\"
.Pp
.It nologin Ta file Ta "" Ta
-If the file exists it will be displayed
+If the file exists, it will be displayed
and the login session will be terminated.
.\"
.Pp
.It passwordtime Ta time Ta "" Ta
The lifetime of a password in seconds, reset every time a user
changes their password.
-When this value is exceeded the user will no longer be able to
+When this value is exceeded, the user will no longer be able to
login unless the
.Li password-dead
option has been specified.
.Li auth
is used as the list of available authentication styles.
.Pp
-If the user did not specify an authentication style the first style
+If the user did not specify an authentication style, the first style
in the list of available styles is used.
If the user did specify an authentication style and the style is in the
list of available styles it will be used, otherwise the request is
.Pp
An authentication program must not assume it will be called as root,
nor must it assume it will not be called as root.
-If it needs special permissions to access files it should be setuid or
+If it needs special permissions to access files, it should be setuid or
setgid to the appropriate user/group.
See
.Xr chmod 1 .
.Li challenge
it should do one of three things:
.Pp
-If this style of authentication supports challenge response
+If this style of authentication supports challenge response,
it should set the internal variable
.Li challenge
to be the appropriate challenge for the user.
-.\" $OpenBSD: pf.conf.5,v 1.592 2022/02/23 13:37:06 dlg Exp $
+.\" $OpenBSD: pf.conf.5,v 1.593 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2002, Daniel Hartmeier
.\" Copyright (c) 2003 - 2013 Henning Brauer <henning@openbsd.org>
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 23 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PF.CONF 5
.Os
.Sh NAME
It is possible to embed a complete IPv4 address into an IPv6 address
using a network prefix of /96 or smaller.
.Pp
-When a destination address is not specified it is assumed that the host
+When a destination address is not specified, it is assumed that the host
part is 32-bit long.
For IPv6 to IPv4 translation this would mean using only the lower 32
bits of the original IPv6 destination address.
In that case, no separate loading of rules into the anchor
is required.
Brace delimited blocks may contain rules or other brace-delimited blocks.
-When an anchor is populated this way the anchor name becomes optional.
+When an anchor is populated this way, the anchor name becomes optional.
Since the parser specification for anchor names is a string,
double quote characters
.Pq Sq \&"
-.\" $OpenBSD: port-modules.5,v 1.258 2022/03/18 09:04:05 sthen Exp $
+.\" $OpenBSD: port-modules.5,v 1.259 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2008 Marc Espie
.\"
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PORT-MODULES 5
.Os
.Sh NAME
is set in combination with
.Ev V
or
-.Ev VERSION
+.Ev VERSION ,
it sets
.Ev PKGNAME .
.Ev TYPEFACE
.Ev MODLUA_DEFAULT_VERSION
by default.
Ports can be built with several lua versions.
-If no FLAVOR is set it defaults to MODLUA_DEFAULT_VERSION.
+If no FLAVOR is set, it defaults to MODLUA_DEFAULT_VERSION.
Otherwise the FULLPKGNAME is adjusted, if MODLUA_SA is not set.
In order to set a build, run or test dependency on a lua port,
use the following, which will propagate the currently used flavor:
-.\" $OpenBSD: python-module.5,v 1.3 2021/07/27 13:21:50 espie Exp $
+.\" $OpenBSD: python-module.5,v 1.4 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2008 Marc Espie
.\"
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: July 27 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PYTHON-MODULE 5
.Os
.Sh NAME
If
.Ev MODPY_PI
is set to
-.Sq Yes
+.Sq Yes ,
the module will provide a default for
.Ev HOMEPAGE
and set
-.\" $OpenBSD: packages-specs.7,v 1.28 2021/11/17 12:53:05 espie Exp $
+.\" $OpenBSD: packages-specs.7,v 1.29 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2001 Marc Espie
.\"
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 17 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PACKAGES-SPECS 7
.Os
.Sh NAME
Comparison checks each part in turn, the first part that differs yields
a comparison result.
.It
-If parts are numbers they are compared numerically.
+If parts are numbers, they are compared numerically.
.It
Parts can also be numbers with an optional letter appended.
The numbers are compared numerically, and in case of equality, the letter
-.\" $OpenBSD: crash.8,v 1.35 2016/11/29 13:57:34 mpi Exp $
+.\" $OpenBSD: crash.8,v 1.36 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 1980, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" from: @(#)crash.8 6.5 (Berkeley) 4/20/91
.\"
-.Dd $Mdocdate: November 29 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CRASH 8
.Os
.Sh NAME
invokes the automatic reboot procedure as
described in
.Xr reboot 8 .
-If auto-reboot is disabled (in a machine dependent way) the system
+If auto-reboot is disabled (in a machine dependent way), the system
will simply halt at this point.
.Pp
Upon rebooting, and
-.\" $OpenBSD: starttls.8,v 1.27 2019/08/12 19:49:14 tedu Exp $
+.\" $OpenBSD: starttls.8,v 1.28 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2001 Jose Nazario <jose@monkey.org>
.\" All rights reserved.
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 12 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt STARTTLS 8
.Os
.Sh NAME
.Fl days
parameter (one year in this example).
.Pp
-After having installed the certificates
+After having installed the certificates,
the mail server needs to be configured to accept TLS sessions
and use the key and certificate.
For
.Ed
.Pp
After typing
-.Em EHLO localhost
+.Em EHLO localhost ,
you should receive something like the following back.
.Bd -literal -offset indent
250-localhost Hello localhost [127.0.0.1], pleased to meet you
-.\" $OpenBSD: audio.9,v 1.30 2022/03/30 19:03:20 miod Exp $
+.\" $OpenBSD: audio.9,v 1.31 2022/03/31 17:27:23 naddy Exp $
.\" $NetBSD: audio.9,v 1.14 2000/02/11 22:56:15 kleink Exp $
.\"
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 30 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt AUDIO 9
.Os
.Sh NAME
to the audio hardware.
The call returns when the data transfer
has been initiated (normally with DMA).
-When the hardware is ready to accept more samples the function
+When the hardware is ready to accept more samples, the function
.Fa intr
will be called with the argument
.Fa intrarg .
from the audio hardware.
The call returns when the data transfer
has been initiated (normally with DMA).
-When the hardware is ready to deliver more samples the function
+When the hardware is ready to deliver more samples, the function
.Fa intr
will be called with the argument
.Fa intrarg .
.El
.Pp
If the audio hardware is capable of input from more
-than one source it should define
+than one source, it should define
.Dv AudioNsource
in class
.Dv AudioCrecord .
.Dv AudioCinputs .
.Pp
If the audio hardware is capable of output to more than
-one destination it should define
+one destination, it should define
.Dv AudioNoutput
in class
.Dv AudioCmonitor .
-.\" $OpenBSD: bemtoh32.9,v 1.7 2019/08/30 18:33:17 deraadt Exp $
+.\" $OpenBSD: bemtoh32.9,v 1.8 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2014 David Gwynne <dlg@openbsd.org>
.\" All rights reserved.
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: August 30 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BEMTOH32 9
.Os
.Sh NAME
.Sh DESCRIPTION
This API provides a way to take advantage of an architecture's ability
to load and store words in memory of different endians.
-If an architecture has no specialised support for these operations
+If an architecture has no specialised support for these operations,
they will be implemented as a wrapper around the
.Xr htobe64 3
API.
-.\" $OpenBSD: bpf_mtap.9,v 1.16 2019/09/30 01:55:26 dlg Exp $
+.\" $OpenBSD: bpf_mtap.9,v 1.17 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2016 David Gwynne <dlg@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: September 30 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BPF_MTAP 9
.Os
.Sh NAME
against an Ethernet packet in the mbuf
.Fa m .
If the mbuf is flagged with
-.Dv M_VLANTAG
+.Dv M_VLANTAG ,
an Ethernet VLAN header is constructed using
m->m_pkthdr.ether_vtag
and
-.\" $OpenBSD: disklabel.9,v 1.17 2013/06/04 19:27:04 schwarze Exp $
+.\" $OpenBSD: disklabel.9,v 1.18 2022/03/31 17:27:23 naddy Exp $
.\" $NetBSD: disklabel.9,v 1.7 1999/03/06 22:09:29 mycroft Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 4 2013 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DISKLABEL 9
.Os
.Sh NAME
or
.Fa spoofonly
argument is a true value,
-If a disk label is found or can be constructed a value of 0 is returned.
+If a disk label is found or can be constructed, a value of 0 is returned.
Otherwise the value of the I/O errno encountered is returned.
.Pp
.Fn writedisklabel
-.\" $OpenBSD: dma_alloc.9,v 1.7 2016/09/15 06:11:14 jmc Exp $
+.\" $OpenBSD: dma_alloc.9,v 1.8 2022/03/31 17:27:23 naddy Exp $
.\" $NetBSD: pool.9,v 1.18 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 2011 Theo de Raadt
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: September 15 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DMA_ALLOC 9
.Os
.Sh NAME
interface.
It is safe to call in most contexts and is
typically used for temporary buffers up to 65536 bytes.
-When buffers are used many times it may be better to consider
+When buffers are used many times, it may be better to consider
using other DMA-safe allocators.
.Pp
Interrupt protection is set to
-.\" $OpenBSD: ifiq_input.9,v 1.3 2020/06/05 05:33:58 jmc Exp $
+.\" $OpenBSD: ifiq_input.9,v 1.4 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2020 David Gwynne <dlg@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: June 5 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt IFIQ_INPUT 9
.Os
.Sh NAME
on the
.Fa ifiq
interface input queue and notify the network stack to process them.
-If the queue rejects the packets they will be freed
+If the queue rejects the packets, they will be freed
and counted as drops.
.It Fn ifiq_enqueue "struct ifiqueue *ifq" "struct mbuf *m"
Enqueue the mbuf
-.\" $OpenBSD: ifq_enqueue.9,v 1.12 2021/03/20 21:02:56 sthen Exp $
+.\" $OpenBSD: ifq_enqueue.9,v 1.13 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2015 David Gwynne <dlg@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 20 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt IFQ_ENQUEUE 9
.Os
.Sh NAME
on the
.Fa ifq
interface send queue.
-If the queue rejects the packet it will be freed with
+If the queue rejects the packet, it will be freed with
.Xr m_freem 9
and counted as a drop.
.It Fn ifq_dequeue "struct ifqueue *ifq"
-.\" $OpenBSD: mbuf.9,v 1.123 2021/03/08 02:47:26 jsg Exp $
+.\" $OpenBSD: mbuf.9,v 1.124 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2001 Jean-Jacques Bernard-Gundol <jjbg@openbsd.org>
.\" All rights reserved.
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MGET 9
.Os
.Sh NAME
the header is copied.
If
.Fa len
-is M_COPYALL
+is M_COPYALL,
the whole mbuf is copied.
The
.Fa wait
.Fa plen
to the mbuf pointed to by
.Fa m .
-If necessary allocate a new mbuf and prepend it to the mbuf chain pointed to by
+If necessary, allocate a new mbuf and prepend it to the mbuf chain pointed to by
.Fa m .
If
.Fa m
-.\" $OpenBSD: psignal.9,v 1.7 2018/12/17 14:51:57 visa Exp $
+.\" $OpenBSD: psignal.9,v 1.8 2022/03/31 17:27:23 naddy Exp $
.\" $NetBSD: psignal.9,v 1.5 1999/03/16 00:40:47 garbled Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: December 17 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PSIGNAL 9
.Os
.Sh NAME
If
.Fa pgrp
is
-.Dv NULL
+.Dv NULL ,
no action is taken.
.Pp
The
-.\" $OpenBSD: srp_enter.9,v 1.15 2017/01/18 13:18:07 dlg Exp $
+.\" $OpenBSD: srp_enter.9,v 1.16 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2015 David Gwynne <dlg@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 18 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SRP_ENTER 9
.Os
.Sh NAME
.Fa p
with the data referenced by
.Fa v .
-When the original data is no longer in use it will be destroyed by the garbage
+When the original data is no longer in use, it will be destroyed by the garbage
collector
.Fa gc .
.Fn srp_update
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: style.9,v 1.77 2021/01/22 14:13:57 millert Exp $
+.\" $OpenBSD: style.9,v 1.78 2022/03/31 17:27:23 naddy Exp $
.\"
-.Dd $Mdocdate: January 22 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt STYLE 9
.Os
.Sh NAME
enum enumtype { ONE, TWO } et;
.Ed
.Pp
-When defining unsigned integers use
+When defining unsigned integers, use
.Dq "unsigned int"
rather than just
.Dq "unsigned" ;
volatile char *foo;
.Ed
.Pp
-If both the pointer and the thing pointed to are volatile use
+If both the pointer and the thing pointed to are volatile, use
.Bd -literal -offset indent
volatile char *volatile foo;
.Ed
-.\" $OpenBSD: timeout.9,v 1.53 2021/05/11 13:29:25 cheloha Exp $
+.\" $OpenBSD: timeout.9,v 1.54 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 2000 Artur Grabowski <art@openbsd.org>
.\" All rights reserved.
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 11 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TIMEOUT_SET 9
.Os
.Sh NAME
.Fn timeout_del
will cancel the timeout in the argument
.Fa to .
-If the timeout has already executed or has never been added
+If the timeout has already executed or has never been added,
the call will have no effect.
.Pp
.Fn timeout_del_barrier
-.\" $OpenBSD: tsleep.9,v 1.15 2020/03/20 03:37:09 cheloha Exp $
+.\" $OpenBSD: tsleep.9,v 1.16 2022/03/31 17:27:23 naddy Exp $
.\" $NetBSD: sleep.9,v 1.11 1999/03/24 06:15:12 mycroft Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 20 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TSLEEP 9
.Os
.Sh NAME
If the flag
.Dv PCATCH
is OR'ed into
-.Fa priority
+.Fa priority ,
the process checks for posted signals before and after sleeping.
.It Fa wmesg
A pointer to a character string indicating the reason a process is sleeping.
-.\" $OpenBSD: termcap.5,v 1.30 2016/12/28 22:47:11 schwarze Exp $
+.\" $OpenBSD: termcap.5,v 1.31 2022/03/31 17:27:23 naddy Exp $
.\"
.\" Copyright (c) 1985, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" from: @(#)termcap.5 6.11 (Berkeley) 3/6/93
.\"
-.Dd $Mdocdate: December 28 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TERMCAP 5
.Os
.Sh NAME
.Sy \&\e\e .
If it is necessary to place a
.Sy \&:
-in a capability it must be escaped in octal as
+in a capability, it must be escaped in octal as
.Sy \&\e072 .
If it is necessary to place a
.Dv NUL
-character in a string capability it must be encoded as
+character in a string capability, it must be encoded as
.Sy \&\e200 .
(The routines that deal with
.Nm
-.\" $OpenBSD: biosboot.8,v 1.12 2015/09/10 15:16:43 schwarze Exp $
+.\" $OpenBSD: biosboot.8,v 1.13 2022/03/31 17:27:24 naddy Exp $
.\"
.\" Copyright (c) 2003 Tom Cosgrove <tom.cosgrove@arches-consulting.com>
.\" Copyright (c) 1997 Michael Shalayeff
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIOSBOOT 8 amd64
.Os
.Sh NAME
When
.Nm
receives control from either the BIOS or the
-master boot record (MBR) it will print the message:
+master boot record (MBR), it will print the message:
.Pp
.Dl Loading
.Pp
-.\" $OpenBSD: biosboot.8,v 1.26 2015/09/10 15:16:43 schwarze Exp $
+.\" $OpenBSD: biosboot.8,v 1.27 2022/03/31 17:27:24 naddy Exp $
.\"
.\" Copyright (c) 2003 Tom Cosgrove <tom.cosgrove@arches-consulting.com>
.\" Copyright (c) 1997 Michael Shalayeff
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BIOSBOOT 8 i386
.Os
.Sh NAME
When
.Nm
receives control from either the BIOS or the
-master boot record (MBR) it will print the message:
+master boot record (MBR), it will print the message:
.Pp
.Dl Loading
.Pp
-.\" $OpenBSD: xxboot.8,v 1.5 2017/07/06 17:24:49 schwarze Exp $
+.\" $OpenBSD: xxboot.8,v 1.6 2022/03/31 17:27:24 naddy Exp $
.\"
.\" Copyright (c) 2006 Michael Shalayeff
.\" All rights reserved.
.\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: July 6 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt XXBOOT 8 landisk
.Os
.Sh NAME
.Pp
When
.Nm
-receives control from the master boot record (MBR) it will print a banner:
+receives control from the master boot record (MBR), it will print a banner:
.Pp
.Dl OpenBSD MBR
.Pp
-.\" $OpenBSD: cal.1,v 1.31 2016/11/27 10:37:22 jmc Exp $
+.\" $OpenBSD: cal.1,v 1.32 2022/03/31 17:27:24 naddy Exp $
.\" $NetBSD: cal.1,v 1.6 1995/09/02 05:34:20 jtc Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
.\"
.\" @(#)cal.1 8.2 (Berkeley) 4/28/95
.\"
-.Dd $Mdocdate: November 27 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CAL 1
.Os
.Sh NAME
Display week numbers in the month display.
If
.Fl m
-is specified the ISO week format is assumed.
+is specified, the ISO week format is assumed.
The options
.Fl j
and
-.\" $OpenBSD: cdio.1,v 1.66 2020/06/26 19:51:14 naddy Exp $
+.\" $OpenBSD: cdio.1,v 1.67 2022/03/31 17:27:24 naddy Exp $
.\"
.\" Copyright (c) 1995 Serge V. Vakulenko
.\" All rights reserved.
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 26 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CDIO 1
.Os
.Sh NAME
instead it rips tracks from disk and outputs audio data to
the default audio device.
Both individual tracks and track ranges may be specified.
-If range is specified in descending order tracks will be played in descending order.
+If range is specified in descending order, tracks will be played in descending order.
If the first value in the range is omitted, tracks from first track on disk to the specified one will be played.
If the last value in the range is omitted, tracks from the specified track to the last track on disk will be played.
.It Ic cdrip Op Ar track1-trackN ...
-.\" $OpenBSD: chpass.1,v 1.42 2019/04/23 17:52:12 schwarze Exp $
+.\" $OpenBSD: chpass.1,v 1.43 2022/03/31 17:27:24 naddy Exp $
.\" $NetBSD: chpass.1,v 1.7 1996/05/15 21:50:40 jtc Exp $
.\"
.\" Copyright (c) 1988, 1990, 1993
.\"
.\" @(#)chpass.1 8.2 (Berkeley) 12/30/93
.\"
-.Dd $Mdocdate: April 23 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CHPASS 1
.Os
.Sh NAME
the user hits the interrupt character (control-C by default).
If
.Nm
-is interrupted while trying to gain the lock any changes made will be lost.
+is interrupted while trying to gain the lock, any changes made will be lost.
.Pp
-If the process holding the lock was prematurely terminated the lock
+If the process holding the lock was prematurely terminated, the lock
file may be stale and
.Nm
will wait forever trying to lock the password file.
-.\" $OpenBSD: host.1,v 1.3 2022/02/17 14:08:11 jsg Exp $
+.\" $OpenBSD: host.1,v 1.4 2022/03/31 17:27:24 naddy Exp $
.\"
.\" Copyright (C) 2000-2002, 2004, 2005, 2007-2009, 2014-2018 Internet Systems Consortium, Inc. ("ISC")
.\"
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: February 17 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt HOST 1
.Os
.Sh NAME
.Pp
If a query type of
.Cm IXFR
-is chosen the starting serial number can be specified by appending an equal
+is chosen, the starting serial number can be specified by appending an equal
followed by the starting serial number (like
.Fl t Cm IXFR= Ns Ar 12345678 ) .
.It Fl V
-.\" $OpenBSD: find.1,v 1.100 2021/03/07 15:25:15 jsg Exp $
+.\" $OpenBSD: find.1,v 1.101 2022/03/31 17:27:24 naddy Exp $
.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\"
.\" from: @(#)find.1 8.1 (Berkeley) 6/6/93
.\"
-.Dd $Mdocdate: March 7 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FIND 1
.Os
.Sh NAME
If the string
.Qq {}
appears anywhere in the utility name or the
-arguments it is replaced by the pathname of the current file.
+arguments, it is replaced by the pathname of the current file.
.Pp
If terminated by a plus sign,
the pathnames for which the
by printing
a message to the terminal and reading a response.
If the response is other than
-.Sq y
+.Sq y ,
the command is not executed and the
value of the
.Ic ok
.It Ar expression Cm -and Ar expression
.It Ar expression expression
The logical AND operator.
-As it is implied by the juxtaposition of two expressions it does not
+As it is implied by the juxtaposition of two expressions, it does not
have to be specified.
The expression evaluates to true if both expressions are true.
The second expression is not evaluated if the first expression is false.
-.\" $OpenBSD: hexdump.1,v 1.27 2020/01/16 16:46:47 schwarze Exp $
+.\" $OpenBSD: hexdump.1,v 1.28 2022/03/31 17:27:25 naddy Exp $
.\" $NetBSD: hexdump.1,v 1.14 2001/12/07 14:46:24 bjh21 Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
.\"
.\" from: @(#)hexdump.1 8.2 (Berkeley) 4/18/94
.\"
-.Dd $Mdocdate: January 16 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt HEXDUMP 1
.Os
.Sh NAME
Each format is applied iteration count times.
.Pp
The byte count is an optional positive integer.
-If specified it defines the number of bytes to be interpreted by
+If specified, it defines the number of bytes to be interpreted by
each iteration of the format.
.Pp
If an iteration count and/or a byte count is specified, a single slash
-.\" $OpenBSD: htpasswd.1,v 1.8 2017/07/07 16:30:06 schwarze Exp $
+.\" $OpenBSD: htpasswd.1,v 1.9 2022/03/31 17:27:25 naddy Exp $
.\"
.\" Copyright (c) 2014 Florian Obser <florian@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: July 7 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt HTPASSWD 1
.Os
.Sh NAME
or one argument if the
.Fl I
flag is used
-.Pc
+.Pc ,
user authentication
.Ar file
is updated.
-.\" $OpenBSD: indent.1,v 1.23 2013/06/24 16:01:05 jmc Exp $
+.\" $OpenBSD: indent.1,v 1.24 2022/03/31 17:27:25 naddy Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\" The Regents of the University of California.
.\"
.\" from: @(#)indent.1 8.1 (Berkeley) 7/1/93
.\"
-.Dd $Mdocdate: June 24 2013 $
+.Dd $Mdocdate: March 31 2022 $
.Dt INDENT 1
.Os
.Sh NAME
.Pp
If no
.Ar input-file
-is specified
+is specified,
input is read from stdin and the formatted file is written to stdout.
.Pp
The options listed below control the formatting style imposed by
to be ignored.
.It Fl pcs , npcs
If true
-.Pq Fl pcs
+.Pq Fl pcs ,
all procedure calls will have a space inserted between
the name and the
.Ql \&( .
.Fl npcs .
.It Fl psl , npsl
If true
-.Pq Fl psl
+.Pq Fl psl ,
the names of procedures being defined are placed in
column 1 \- their types, if any, will be left on the previous lines.
The default is
-.\" @(#) $OpenBSD: m4.1,v 1.65 2021/03/08 02:47:28 jsg Exp $
+.\" @(#) $OpenBSD: m4.1,v 1.66 2022/03/31 17:27:25 naddy Exp $
.\"
.\" Copyright (c) 1989, 1993
.\" The Regents of the University of California. All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: March 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt M4 1
.Os
.Sh NAME
parenthesis
.Pq Sq \&( .
If the macro name is not followed by an open
-parenthesis it is processed with no arguments.
+parenthesis, it is processed with no arguments.
.Pp
Macro names consist of a leading alphabetic or underscore
possibly followed by alphanumeric or underscore characters, e.g.,
.Ic index(the quick brown fox jumped, fox)
returns 16).
If the second
-argument is not found index returns \-1.
+argument is not found, index returns \-1.
.It Fn indir macro arg1 ...
Indirectly calls the macro whose name is passed as the first argument,
with the remaining arguments passed as first, ... arguments.
.It Fn substr string offset length
Returns a substring of the first argument starting at the offset specified
by the second argument and the length specified by the third argument.
-If no third argument is present it returns the rest of the string.
+If no third argument is present, it returns the rest of the string.
.It Fn syscmd cmd
Passes the first argument to the shell.
Nothing is returned.
-.\" $OpenBSD: mail.1,v 1.82 2022/02/18 23:17:15 jsg Exp $
+.\" $OpenBSD: mail.1,v 1.83 2022/03/31 17:27:25 naddy Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)mail.1 8.8 (Berkeley) 4/28/95
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MAIL 1
.Os
.Sh NAME
to shift forwards and backwards, or simply enter a message number to move
directly.
.Ss Disposing of mail
-After examining a message you can
+After examining a message, you can
.Ic delete
.Pq Ic d
or
-.\" $OpenBSD: make.1,v 1.134 2021/11/11 20:42:54 jmc Exp $
+.\" $OpenBSD: make.1,v 1.135 2022/03/31 17:27:25 naddy Exp $
.\" $NetBSD: make.1,v 1.18 1997/03/10 21:19:53 christos Exp $
.\"
.\" Copyright (c) 1990, 1993
.\"
.\" from: @(#)make.1 8.4 (Berkeley) 3/19/94
.\"
-.Dd $Mdocdate: November 11 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MAKE 1
.Os
.Sh NAME
.Dq make
expression is applied.
.Pp
-If the conditional evaluates to true the parsing of the makefile continues
+If the conditional evaluates to true, the parsing of the makefile continues
as before.
If it evaluates to false, the following lines are skipped.
In both cases this continues until a
-.\" $OpenBSD: mg.1,v 1.125 2021/05/02 14:13:17 lum Exp $
+.\" $OpenBSD: mg.1,v 1.126 2022/03/31 17:27:25 naddy Exp $
.\" This file is in the public domain.
.\"
-.Dd $Mdocdate: May 2 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MG 1
.Os
.Sh NAME
by the position of the cursor in the dired buffer.
.It dired-find-file
Open the file on the current line of the dired buffer.
-If the cursor is on a directory it will be opened in dired mode.
+If the cursor is on a directory, it will be opened in dired mode.
.It dired-flag-file-deletion
Flag the file listed on the current line for deletion.
This is indicated in the buffer by putting a D at the left margin.
-.\" $OpenBSD: mktemp.1,v 1.30 2019/01/25 00:19:26 millert Exp $
+.\" $OpenBSD: mktemp.1,v 1.31 2022/03/31 17:27:25 naddy Exp $
.\"
.\" Copyright (c) 1996, 2000, 2001, 2003, 2010, 2013
.\" Todd C. Miller <millert@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 25 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MKTEMP 1
.Os
.Sh NAME
.Pa /tmp/tfile.XXXXXXXXXX .
If no
.Ar template
-is specified a default of
+is specified, a default of
.Pa tmp.XXXXXXXXXX
is used and the
.Fl t
-.\" $OpenBSD: netstat.1,v 1.92 2021/01/02 16:50:33 schwarze Exp $
+.\" $OpenBSD: netstat.1,v 1.93 2022/03/31 17:27:26 naddy Exp $
.\" $NetBSD: netstat.1,v 1.11 1995/10/03 21:42:43 thorpej Exp $
.\"
.\" Copyright (c) 1983, 1990, 1992, 1993
.\"
.\" from: @(#)netstat.1 8.8 (Berkeley) 4/18/94
.\"
-.Dd $Mdocdate: January 2 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt NETSTAT 1
.Os
.Sh NAME
flag.
When used with the
.Fl r
-flag it shows the internal addresses of the routing table.
+flag, it shows the internal addresses of the routing table.
Only the super-user can see these addresses;
unprivileged users will see them as 0x0.
.It Fl a
-.\" $OpenBSD: nfsstat.1,v 1.16 2018/01/12 04:36:45 deraadt Exp $
+.\" $OpenBSD: nfsstat.1,v 1.17 2022/03/31 17:27:26 naddy Exp $
.\" $NetBSD: nfsstat.1,v 1.8 1996/03/03 17:21:28 thorpej Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
.\"
.\" from: @(#)nfsstat.1 8.1 (Berkeley) 6/6/93
.\"
-.Dd $Mdocdate: January 12 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt NFSSTAT 1
.Os
.Sh NAME
.Fl M
nor
.Fl N
-option was specified statistics will be obtained from the running system
+option was specified, statistics will be obtained from the running system
by calling
.Xr sysctl 2 .
Otherwise the specified core and system will be used to fetch
-.\" $OpenBSD: size.1,v 1.7 2020/02/08 01:09:58 jsg Exp $
+.\" $OpenBSD: size.1,v 1.8 2022/03/31 17:27:26 naddy Exp $
.\" $NetBSD: size.1,v 1.6 1996/01/14 23:07:11 pk Exp $
.\"
.\" Copyright (c) 1990, 1993, 1994
.\"
.\" @(#)size.1 8.2 (Berkeley) 4/18/94
.\"
-.Dd $Mdocdate: February 8 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SIZE 1
.Os
.Sh NAME
displays the segment sizes for each object archive member.
If no
.Ar file
-is specified
+is specified,
.Nm
attempts to report on the file
.Pa a.out .
-.\" $OpenBSD: openssl.1,v 1.136 2022/02/18 10:24:32 jsg Exp $
+.\" $OpenBSD: openssl.1,v 1.137 2022/03/31 17:27:26 naddy Exp $
.\" ====================================================================
.\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
.\"
.\" copied and put under another distribution licence
.\" [including the GNU Public Licence.]
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OPENSSL 1
.Os
.Sh NAME
.Pq object identifier
is not part of
.Nm openssl Ns 's
-internal table it will be represented in
+internal table, it will be represented in
numerical form
.Pq for example 1.2.3.4 .
.Pp
One or more certificates of message recipients: used when encrypting a message.
.It Fl certfile Ar file
Allows additional certificates to be specified.
-When signing these will be included with the message.
-When verifying these will be searched for the signer's certificates.
+When signing, these will be included with the message.
+When verifying, these will be searched for the signer's certificates.
The certificates should be in PEM format.
.It Fl certsout Ar file
A file that any certificates contained in the message are written to.
.It Fl econtent_type Ar type
Set the encapsulated content type, used with
.Fl sign .
-If not supplied the Data type is used.
+If not supplied, the Data type is used.
The type argument can be any valid OID name in either text or numerical format.
.It Fl in Ar file
The input message to be encrypted or signed or the message to be decrypted or
or
.Fl signer
file.
-When signing this option can be used multiple times to specify successive keys.
+When signing, this option can be used multiple times to specify successive keys.
.It Fl keyform Cm der | pem
Input private key format.
The default is
.Fl certfile
option for example).
.It Fl nodetach
-When signing a message use opaque signing.
+When signing a message, use opaque signing.
This form is more resistant to translation by mail relays but it cannot be
read by mail agents that do not support S/MIME.
Without this option cleartext signing with the MIME type multipart/signed is
Only the certificates specified in the
.Fl certfile
option are used.
-When verifying a message normally certificates (if any) included in the
+When verifying a message, normally certificates (if any) included in the
message are searched for the signing certificate.
The supplied certificates can still be used as untrusted CAs however.
.It Fl nooldmime
Add an explicit email address where signed receipts should be sent to.
This option must be supplied if a signed receipt is requested.
.It Fl recip Ar file
-When decrypting a message this specifies the recipient's certificate.
+When decrypting a message, this specifies the recipient's certificate.
The certificate must match one of the recipients of the message or an
error occurs.
-When encrypting a message this option may be used multiple times to
+When encrypting a message, this option may be used multiple times to
specify each recipient.
This form must be used if customised parameters are required (for example to
specify RSA-OAEP).
When used with
.Fl encrypt
or
-.Fl decrypt
+.Fl decrypt ,
the supplied key is used to wrap or unwrap the content encryption key
using an AES key in the KEKRecipientInfo type.
.It Fl secretkeyid Ar id
.It Fl text
Add plain text (text/plain) MIME headers to the supplied message if
encrypting or signing.
-If decrypting or verifying it strips off text headers: if the decrypted
+If decrypting or verifying, it strips off text headers: if the decrypted
or verified message is not of MIME type text/plain then an error occurs.
.It Fl verify_retcode
Set verification error code to exit code to indicate what verification error
this must be represented as a string comprised only of hex digits.
.It Fl salt
Use a salt in the key derivation routines (the default).
-When the salt is being used
+When the salt is being used,
the first eight bytes of the encrypted data are reserved for the salt:
it is randomly generated when encrypting a file and read from the
encrypted file when it is decrypted.
.It Fl paramfile Ar file
Some public key algorithms generate a private key based on a set of parameters,
which can be supplied using this option.
-If this option is used the public key
+If this option is used, the public key
algorithm used is determined by the parameters.
This option must precede any
.Fl pkeyopt
.Fl cert
and
.Fl serial
-options)
+options),
a nonce is automatically added; specifying
.Fl no_nonce
overrides this.
have the same password as the keys and certificates it could also be attacked.
By default, both MAC and encryption iteration counts are set to 2048;
using these options the MAC and encryption iteration counts can be set to 1.
-Since this reduces the file security you should not use these options
+Since this reduces the file security, you should not use these options
unless you really have to.
Most software supports both MAC and key iteration counts.
.It Fl out Ar file
in size.
If
.Ar nbits
-is omitted
+is omitted,
the default key size is used.
.Pp
.No dsa : Ns Ar file
Do not do chain verification of signers' certificates: that is,
don't use the certificates in the signed message as untrusted CAs.
.It Fl nodetach
-When signing a message use opaque signing: this form is more resistant
+When signing a message, use opaque signing: this form is more resistant
to translation by mail relays but it cannot be read by mail agents that
do not support S/MIME.
Without this option cleartext signing with the MIME type
it is useful, for example,
to examine the content of a response or token
or to extract the time stamp token from a response.
-If the input is a token and the output is a time stamp response a default
+If the input is a token and the output is a time stamp response, a default
.Qq granted
status info is added to the token.
.It Fl inkey Ar private.pem
The default policy to use for the response.
Either dotted OID notation or OID names defined
in the config file can be used.
-If no policy is requested the TSA uses its own default policy.
+If no policy is requested, the TSA uses its own default policy.
.It Fl queryfile Ar request.tsq
The file containing a DER-encoded time stamp request.
.It Fl section Ar tsa_section
The file containing the hexadecimal serial number of the
last time stamp response created.
This number is incremented by 1 for each response.
-If the file does not exist at the time of response generation
+If the file does not exist at the time of response generation,
a new file is created with serial number 1.
This parameter is mandatory.
.It Cm signer_cert
-.\" $OpenBSD: passwd.1,v 1.47 2021/04/14 13:59:59 millert Exp $
+.\" $OpenBSD: passwd.1,v 1.48 2022/03/31 17:27:26 naddy Exp $
.\"
.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" from: @(#)passwd.1 6.11 (Berkeley) 7/24/91
.\"
-.Dd $Mdocdate: April 14 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PASSWD 1
.Os
.Sh NAME
you hit the interrupt character (control-C by default).
If
.Nm
-is interrupted while trying to gain the lock the password change will
+is interrupted while trying to gain the lock, the password change will
be lost.
.Pp
-If the process holding the lock was prematurely terminated the lock
+If the process holding the lock was prematurely terminated, the lock
file may be stale and
.Nm
will wait forever trying to lock the password file.
-.\" $OpenBSD: patch.1,v 1.35 2022/02/18 23:17:15 jsg Exp $
+.\" $OpenBSD: patch.1,v 1.36 2022/03/31 17:27:26 naddy Exp $
.\" Copyright 1986, Larry Wall
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PATCH 1
.Os
.Sh NAME
An error occurred.
.El
.Pp
-When applying a set of patches in a loop it behooves you to check this
+When applying a set of patches in a loop, it behooves you to check this
exit status so you don't apply a later patch to a partially patched file.
.Sh DIAGNOSTICS
Too many to list here, but generally indicative that
-.\" $OpenBSD: pkg-config.1,v 1.36 2021/12/26 02:53:17 kn Exp $
+.\" $OpenBSD: pkg-config.1,v 1.37 2022/03/31 17:27:26 naddy Exp $
.\"
.\" Copyright (c) 2006 Chris Kuethe <ckuethe@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: December 26 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PKG-CONFIG 1
.Os
.Sh NAME
the output of include paths set with
.Fl I .
.It Ev PKG_CONFIG_TOP_BUILD_DIR
-If set
+If set,
.Nm
uses the specified value for
.Em pc_top_builddir
-.\" $OpenBSD: pr.1,v 1.28 2020/12/13 15:36:36 jmc Exp $
+.\" $OpenBSD: pr.1,v 1.29 2022/03/31 17:27:26 naddy Exp $
.\"
.\" Copyright (c) 1991 Keith Muller.
.\" Copyright (c) 1993
.\"
.\" from: @(#)pr.1 8.1 (Berkeley) 6/6/93
.\"
-.Dd $Mdocdate: December 13 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PR 1
.Os
.Sh NAME
is an integer > 0.
If
.Ar gap
-is zero or is omitted the default is 8.
+is zero or is omitted, the default is 8.
All
.Em <tab>
characters in the input are expanded into the appropriate
-.\" $OpenBSD: skey.1,v 1.36 2015/10/09 21:59:34 tim Exp $
+.\" $OpenBSD: skey.1,v 1.37 2022/03/31 17:27:27 naddy Exp $
.\" @(#)skey.1 1.1 10/28/93
.\"
-.Dd $Mdocdate: October 9 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SKEY 1
.Os
.Sh NAME
is RFC 2289 compliant.
.Pp
Before using
-.Nm skey
+.Nm skey ,
the system needs to be initialized using
.Xr skeyinit 1 ;
this will establish a secret passphrase.
-.\" $OpenBSD: skeyinit.1,v 1.42 2022/02/06 00:29:03 jsg Exp $
+.\" $OpenBSD: skeyinit.1,v 1.43 2022/03/31 17:27:27 naddy Exp $
.\" $NetBSD: skeyinit.1,v 1.4 1995/07/07 22:24:09 jtc Exp $
.\" @(#)skeyinit.1 1.1 10/28/93
.\"
-.Dd $Mdocdate: February 6 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SKEYINIT 1
.Os
.Sh NAME
to generate one-time passwords:
enter a phrase of several words in response.
After the S/Key database
-has been updated you can log in using either your regular password
+has been updated, you can log in using either your regular password
or using S/Key one-time passwords.
.Pp
.Nm
-.\" $OpenBSD: sndioctl.1,v 1.15 2020/11/21 14:34:33 kn Exp $
+.\" $OpenBSD: sndioctl.1,v 1.16 2022/03/31 17:27:27 naddy Exp $
.\"
.\" Copyright (c) 2014-2020 Alexandre Ratchov <alex@caoua.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 21 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SNDIOCTL 1
.Os
.Sh NAME
control to hide details that are not essential.
.El
.Pp
-If no commands are specified all valid controls are displayed on
+If no commands are specified, all valid controls are displayed on
.Em stdout .
Unless
.Fl d ,
-.\" $OpenBSD: snmp.1,v 1.21 2022/03/10 01:56:02 jsg Exp $
+.\" $OpenBSD: snmp.1,v 1.22 2022/03/31 17:27:27 naddy Exp $
.\"
.\" Copyright (c) 2019 Martijn van Duren <martijn@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 10 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SNMP 1
.Os
.Sh NAME
subcommand internally and requests a single varbind at a time.
If no
.Ar oid
-is specified it defaults to mib-2
+is specified, it defaults to mib-2
.Pq .1.3.6.1.2.1 .
.It Xo
.Nm snmp
An SNMP based version of the
.Xr df 1
command.
-If no size suffix is shown the sizes are in kilobytes.
+If no size suffix is shown, the sizes are in kilobytes.
.It Nm Cm mibtree Oo Fl O Ar fnS Oc Op Ar oid ...
Dump the tree of compiled-in MIB objects.
If
Sets the username.
If
.Fl v Cm 3
-is used this option is required.
+is used, this option is required.
This option is only used by
.Fl v Cm 3 .
.It Fl v Ar version
-.\" $OpenBSD: sort.1,v 1.64 2021/09/04 19:21:39 schwarze Exp $
+.\" $OpenBSD: sort.1,v 1.65 2022/03/31 17:27:27 naddy Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)sort.1 8.1 (Berkeley) 6/6/93
.\"
-.Dd $Mdocdate: September 4 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SORT 1
.Os
.Sh NAME
which correspond to the options discussed above.
When
.Cm b
-is specified it applies only to
+is specified, it applies only to
.Ar field1
or
.Ar field2
-.\" $OpenBSD: sftp.1,v 1.139 2022/03/31 03:07:03 djm Exp $
+.\" $OpenBSD: sftp.1,v 1.140 2022/03/31 17:27:27 naddy Exp $
.\"
.\" Copyright (c) 2001 Damien Miller. All rights reserved.
.\"
.Ar batchfile
instead of
.Em stdin .
-Since it lacks user interaction it should be used in conjunction with
+Since it lacks user interaction, it should be used in conjunction with
non-interactive authentication to obviate the need to enter a password
at connection time (see
.Xr sshd 8
-.\" $OpenBSD: ssh-agent.1,v 1.72 2020/06/22 05:52:05 djm Exp $
+.\" $OpenBSD: ssh-agent.1,v 1.73 2022/03/31 17:27:27 naddy Exp $
.\"
.\" Author: Tatu Ylonen <ylo@cs.hut.fi>
.\" Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 22 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSH-AGENT 1
.Os
.Sh NAME
looks like it's a csh style of shell.
.It Fl D
Foreground mode.
-When this option is specified
+When this option is specified,
.Nm
will not fork.
.It Fl d
Debug mode.
-When this option is specified
+When this option is specified,
.Nm
will not fork and will write debug information to standard error.
.It Fl E Ar fingerprint_hash
-.\" $OpenBSD: ssh-keysign.8,v 1.16 2019/11/30 07:07:59 jmc Exp $
+.\" $OpenBSD: ssh-keysign.8,v 1.17 2022/03/31 17:27:27 naddy Exp $
.\"
.\" Copyright (c) 2002 Markus Friedl. All rights reserved.
.\"
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 30 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSH-KEYSIGN 8
.Os
.Sh NAME
.It Pa /etc/ssh/ssh_host_ecdsa_key-cert.pub
.It Pa /etc/ssh/ssh_host_ed25519_key-cert.pub
.It Pa /etc/ssh/ssh_host_rsa_key-cert.pub
-If these files exist they are assumed to contain public certificate
+If these files exist, they are assumed to contain public certificate
information corresponding with the private keys above.
.El
.Sh SEE ALSO
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $OpenBSD: ssh.1,v 1.429 2022/02/06 00:29:03 jsg Exp $
-.Dd $Mdocdate: February 6 2022 $
+.\" $OpenBSD: ssh.1,v 1.430 2022/03/31 17:27:27 naddy Exp $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSH 1
.Os
.Sh NAME
the listen port will be dynamically allocated on the server and reported
to the client at run time.
When used together with
-.Ic -O forward
+.Ic -O forward ,
the allocated port will be printed to the standard output.
.Pp
.It Fl S Ar ctl_path
All communication with
the remote command or shell will be automatically encrypted.
.Pp
-If an interactive session is requested
+If an interactive session is requested,
.Nm
by default will only request a pseudo-terminal (pty) for interactive
sessions when the client has one.
.Fl t
can be used to override this behaviour.
.Pp
-If a pseudo-terminal has been allocated the
+If a pseudo-terminal has been allocated, the
user may use the escape characters noted below.
.Pp
If no pseudo-terminal has been allocated,
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $OpenBSD: ssh_config.5,v 1.369 2022/02/15 05:13:36 djm Exp $
-.Dd $Mdocdate: February 15 2022 $
+.\" $OpenBSD: ssh_config.5,v 1.370 2022/03/31 17:27:27 naddy Exp $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSH_CONFIG 5
.Os
.Sh NAME
authentication.
.It Cm CheckHostIP
If set to
-.Cm yes
+.Cm yes ,
.Xr ssh 1
will additionally check the host IP address in the
.Pa known_hosts
or a Unix domain socket path,
otherwise if no destination argument is specified then the remote forwarding
will be established as a SOCKS proxy.
-When acting as a SOCKS proxy the destination of the connection can be
+When acting as a SOCKS proxy, the destination of the connection can be
restricted by
.Cm PermitRemoteOpen .
.Pp
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $OpenBSD: sshd.8,v 1.317 2021/09/10 11:38:38 dtucker Exp $
-.Dd $Mdocdate: September 10 2021 $
+.\" $OpenBSD: sshd.8,v 1.318 2022/03/31 17:27:27 naddy Exp $
+.Dd $Mdocdate: March 31 2022 $
.Dt SSHD 8
.Os
.Sh NAME
as well as disabling PTY allocation
and execution of
.Pa ~/.ssh/rc .
-If any future restriction capabilities are added to authorized_keys files
+If any future restriction capabilities are added to authorized_keys files,
they will be included in this set.
.It Cm tunnel="n"
Force a
-.\" $OpenBSD: tmux.1,v 1.885 2022/03/24 09:05:57 nicm Exp $
+.\" $OpenBSD: tmux.1,v 1.886 2022/03/31 17:27:27 naddy Exp $
.\"
.\" Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
.\"
.\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
.\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 24 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TMUX 1
.Os
.Sh NAME
.Pp
When
.Nm
-is started it creates a new
+is started, it creates a new
.Em session
with a single
.Em window
sets the type of border line for the popup.
When
.Fl B
-is specified the
+is specified, the
.Fl b
option is ignored.
See
For input,
.Nm
always runs with a UTF-8 locale.
-If en_US.UTF-8 is provided by the operating system it is used and
+If en_US.UTF-8 is provided by the operating system, it is used and
.Ev LC_CTYPE
is ignored for input.
Otherwise,
-.\" $OpenBSD: top.1,v 1.80 2022/02/18 23:17:16 jsg Exp $
+.\" $OpenBSD: top.1,v 1.81 2022/03/31 17:27:28 naddy Exp $
.\"
.\" Copyright (c) 1997, Jason Downs. All rights reserved.
.\"
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TOP 1
.Os
.Sh NAME
.It Fl 1
Display combined CPU statistics for all processors on a single line
instead of one line per CPU.
-If there are more than 8 CPUs detected in the system this option
+If there are more than 8 CPUs detected in the system, this option
is automatically enabled.
.It Fl b
Use
-.\" $OpenBSD: tput.1,v 1.23 2016/12/28 22:47:11 schwarze Exp $
+.\" $OpenBSD: tput.1,v 1.24 2022/03/31 17:27:28 naddy Exp $
.\" $NetBSD: tput.1,v 1.4 1994/12/07 08:49:10 jtc Exp $
.\"
.\" Copyright (c) 1989, 1990, 1993
.\"
.\" @(#)tput.1 8.2 (Berkeley) 3/19/94
.\"
-.Dd $Mdocdate: December 28 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TPUT 1
.Os
.Sh NAME
utility makes terminal-dependent information available to users or shell
applications.
When invoked as
-.Nm clear
+.Nm clear ,
it provides the same functionality as
.Nm tput Cm clear .
.Pp
The exit value of
.Nm
is based on the last attribute specified.
-If the attribute is of type string or of type integer the exit
+If the attribute is of type string or of type integer, the exit
value is as follows:
.Pp
.Bl -tag -offset indent -width Ds -compact
-.\" $OpenBSD: tset.1,v 1.22 2015/12/03 11:32:34 nicm Exp $
+.\" $OpenBSD: tset.1,v 1.23 2022/03/31 17:27:28 naddy Exp $
.\"
.\" Copyright (c) 1985, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)tset.1 8.1 (Berkeley) 6/9/93
.\"
-.Dd $Mdocdate: December 3 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TSET 1
.Os
.Sh NAME
.Pa .login
for
.Xr csh 1
-users) it is often desirable to provide information about the type of
+users), it is often desirable to provide information about the type of
terminal used on such ports.
.Pp
The purpose of the
-.\" $OpenBSD: usbhidaction.1,v 1.15 2020/06/24 19:19:03 jmc Exp $
+.\" $OpenBSD: usbhidaction.1,v 1.16 2022/03/31 17:27:28 naddy Exp $
.\" $NetBSD: usbhidaction.1,v 1.6 2002/01/18 14:38:59 augustss Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 24 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt USBHIDACTION 1
.Os
.Sh NAME
can be used to execute commands when certain values appear on HID controls.
The normal operation for this program is to read the configuration file
and then become a daemon and execute commands as the HID items specify.
-If a read from the HID device fails the program dies; this will make it
+If a read from the HID device fails, the program dies; this will make it
die when the USB device is unplugged.
.Pp
The options are as follows:
but each part must be prefixed by its page name.
.Pp
The value is simply a numeric value.
-When the item reports this value the action will be performed.
-If the value is `*' it will match any value.
+When the item reports this value, the action will be performed.
+If the value is `*', it will match any value.
.Pp
The action is a normal command that is executed by using
.Xr fork 2 .
-.\" $OpenBSD: usbhidctl.1,v 1.15 2021/05/31 18:30:11 jcs Exp $
+.\" $OpenBSD: usbhidctl.1,v 1.16 2022/03/31 17:27:28 naddy Exp $
.\" $NetBSD: usbhidctl.1,v 1.14 2001/12/28 17:49:32 augustss Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: May 31 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt USBHIDCTL 1
.Os
.Sh NAME
prints the current value of those items for the specified device.
If the
.Fl w
-flag is specified
+flag is specified,
.Nm
attempts to set the specified items to the given values.
.Pp
-.\" $OpenBSD: vacation.1,v 1.25 2021/01/21 13:19:58 jmc Exp $
+.\" $OpenBSD: vacation.1,v 1.26 2022/03/31 17:27:28 naddy Exp $
.\" $NetBSD: vacation.1,v 1.5 1995/08/31 21:57:08 jtc Exp $
.\"
.\" Copyright (c) 1985, 1987, 1990, 1991, 1993
.\"
.\" @(#)vacation.1 8.2 (Berkeley) 4/28/95
.\"
-.Dd $Mdocdate: January 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt VACATION 1
.Os
.Sh NAME
line or a
.Dq Return-Path
header to determine the sender.
-If both are present the sender from the
+If both are present, the sender from the
.Dq Return-Path
header is used.
.Pp
-.\" $OpenBSD: vi.1,v 1.79 2021/03/08 02:47:29 jsg Exp $
+.\" $OpenBSD: vi.1,v 1.80 2022/03/31 17:27:28 naddy Exp $
.\"
.\" Copyright (c) 1994
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)vi.1 8.51 (Berkeley) 10/10/96
.\"
-.Dd $Mdocdate: March 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt VI 1
.Os
.Sh NAME
commands.
.It Cm secure
Turns off all access to external programs.
-Once set this option can't be disabled.
+Once set, this option can't be disabled.
.It Cm shell , sh Bq "environment variable SHELL, or /bin/sh"
Select the shell used by the editor.
.It Cm shellmeta Bq ~{[*?$`'\&"\e
-.\" $OpenBSD: what.1,v 1.20 2019/01/20 14:03:19 schwarze Exp $
+.\" $OpenBSD: what.1,v 1.21 2022/03/31 17:27:28 naddy Exp $
.\" $NetBSD: what.1,v 1.3 1994/11/17 06:59:38 jtc Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\"
.\" @(#)what.1 8.1 (Berkeley) 6/6/93
.\"
-.Dd $Mdocdate: January 20 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt WHAT 1
.Os
.Sh NAME
.Pp
When
.Sq $
-followed by the system name is encountered
+followed by the system name is encountered,
.Nm
prints the remainder of the string up to a
.Sq $
-.\" $OpenBSD: amd.8,v 1.25 2021/03/08 02:47:29 jsg Exp $
+.\" $OpenBSD: amd.8,v 1.26 2022/03/31 17:27:28 naddy Exp $
.\"
.\" Copyright (c) 1989 Jan-Simon Pendry
.\" Copyright (c) 1989 Imperial College of Science, Technology & Medicine
.\"
.\" from: @(#)amd.8 5.10 (Berkeley) 4/19/94
.\"
-.Dd $Mdocdate: March 8 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt AMD 8
.Os
.Sh NAME
and a fuller description is available in the program source.
.It Fl d Ar domain
Specify the local domain name.
-If this option is not given the domain name is determined from the hostname.
+If this option is not given, the domain name is determined from the hostname.
.It Fl k Ar kernel-arch
Specifies the kernel architecture.
This is used solely to set the ${karch} selector.
-.\" $OpenBSD: apmd.8,v 1.53 2021/11/03 19:54:28 jmc Exp $
+.\" $OpenBSD: apmd.8,v 1.54 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 1995 John T. Kohl
.\" All rights reserved.
.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 3 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt APMD 8
.Os
.Sh NAME
runs the appropriate configuration program (if one exists).
.Pp
When the power status changes
-(battery is connected or disconnected)
+(battery is connected or disconnected),
.Nm
fetches the current status and reports it via
.Xr syslog 3
-.\" $OpenBSD: bgpd.8,v 1.71 2021/09/03 07:58:07 claudio Exp $
+.\" $OpenBSD: bgpd.8,v 1.72 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: September 3 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BGPD 8
.Os
.Sh NAME
wins.
If the
.Em ORIGINATOR_ID
-attribute is present that value will be used in the comparison instead.
+attribute is present, that value will be used in the comparison instead.
.It
The path with the shortest
.Em CLUSTER_LIST
-.\" $OpenBSD: bgpd.conf.5,v 1.218 2022/03/10 01:45:30 jsg Exp $
+.\" $OpenBSD: bgpd.conf.5,v 1.219 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 2004 Claudio Jeker <claudio@openbsd.org>
.\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 10 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BGPD.CONF 5
.Os
.Sh NAME
.Pq Ic default Ns | Ns Ic all
.Xc
If set to
-.Ar all
+.Ar all ,
keep evaluating alternative paths in case the selected path is filtered
out.
By default if a path is filtered by the output filters then no alternative
.Ar path .
If
.Ic restricted
-is specified a restricted control socket will be created.
+is specified, a restricted control socket will be created.
By default
.Pa /var/run/bgpd.sock.<rdomain>
is used where
Specify the TCP destination port for the
.Em rtr
session.
-If not specified the default
+If not specified, the default
.Ic port
is
.Em 323 .
.Ed
.Pp
Keys must be given in hexadecimal format.
-After changing settings a session needs to be reset to use the new keys.
+After changing settings, a session needs to be reset to use the new keys.
The
.Ic ipsec
flows only work with session using the default port 179.
and
.Xr bgpd 8
daemons on both sides, the session should be established.
-After changing settings a session needs to be reset to use the new keys.
+After changing settings, a session needs to be reset to use the new keys.
The
.Ic ipsec
flows only work with session using the default port 179.
.Pq Ic default Ns | Ns Ic all
.Xc
If set to
-.Ar all
+.Ar all ,
keep evaluating alternative paths in case the selected path is filtered
out.
By default if a path is filtered by the output filters then no alternative
tcp md5sig password mekmitasdigoat
tcp md5sig key deadbeef
.Ed
-After changing keys a session needs to be reset to use the new keys.
+After changing keys, a session needs to be reset to use the new keys.
.Pp
.It Xo
.Ic transparent-as
which is expanded to the locally assigned AS number.
.Pp
When specifying an
-.Ic as-set Ar name
+.Ic as-set Ar name ,
the AS path will instead be matched against all the AS numbers in the set.
.Pp
The
-.\" $OpenBSD: bt.5,v 1.13 2021/11/12 16:57:24 claudio Exp $
+.\" $OpenBSD: bt.5,v 1.14 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 2019 Martin Pieuchot <mpi@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 12 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BT 5
.Os
.Sh NAME
which formats them using the corresponding
.Ar action .
If a recorded event doesn't match the optional
-.Ar filter
+.Ar filter ,
it will be silently ignored.
.Pp
A valid
-.\" $OpenBSD: dhcp-options.5,v 1.31 2019/05/08 22:00:55 krw Exp $
+.\" $OpenBSD: dhcp-options.5,v 1.32 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 1995, 1996, 1997, 1998 The Internet Software Consortium.
.\" All rights reserved.
.\" see ``http://www.isc.org/isc''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
.\"
-.Dd $Mdocdate: May 8 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCP-OPTIONS 5
.Os
.Sh NAME
When
.Xr dhclient 8
constructs
-.Xr resolv.conf 5
+.Xr resolv.conf 5 ,
it will use this list of domains in preference to any information
provided by the
.Ic domain-name
-.\" $OpenBSD: dhcpd.8,v 1.29 2017/08/29 08:20:18 jmc Exp $
+.\" $OpenBSD: dhcpd.8,v 1.30 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 1995, 1996 The Internet Software Consortium.
.\" All rights reserved.
.\" see ``http://www.isc.org/''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
.\"
-.Dd $Mdocdate: August 29 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCPD 8
.Os
.Sh NAME
An alias for
.Fl d .
.It Fl L Ar leased_ip_table
-When an address is leased
+When an address is leased,
.Nm
will insert it into the
.Xr pf 4
-.\" $OpenBSD: dhcpd.conf.5,v 1.26 2020/05/16 16:58:11 jmc Exp $
+.\" $OpenBSD: dhcpd.conf.5,v 1.27 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 1995, 1996, 1997, 1998, 1998, 1999
.\" The Internet Software Consortium. All rights reserved.
.\" see ``http://www.isc.org/isc''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
.\"
-.Dd $Mdocdate: May 16 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCPD.CONF 5
.Os
.Sh NAME
.Pp
When
.Ic echo-client-id
-is true
+is true ,
.Xr dhcpd 8
copies option dhcp-client-identifier (code 61)
from
-.\" $OpenBSD: dhcrelay.8,v 1.16 2017/02/15 19:36:24 krw Exp $
+.\" $OpenBSD: dhcrelay.8,v 1.17 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 1997 The Internet Software Consortium.
.\" All rights reserved.
.\" see ``http://www.isc.org/isc''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
.\"
-.Dd $Mdocdate: February 15 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCRELAY 8
.Os
.Sh NAME
relay agent information sub-option value that
.Nm
should append on relayed packets.
-If this option is not specified it will use the interface number by default.
+If this option is not specified, it will use the interface number by default.
.It Fl d
Do not daemonize.
If this option is specified,
relay agent information sub-option value that
.Nm
should append on relayed packets.
-If this option is not specified it will use the destination address by default.
+If this option is not specified, it will use the destination address by default.
.It Fl r
Replace incoming Relay Agent Information with the one configured.
.El
-.\" $OpenBSD: dhcrelay6.8,v 1.2 2017/03/17 16:45:27 jmc Exp $
+.\" $OpenBSD: dhcrelay6.8,v 1.3 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 1997 The Internet Software Consortium.
.\" All rights reserved.
.\" see ``http://www.isc.org/isc''. To learn more about Vixie
.\" Enterprises, see ``http://www.vix.com''.
.\"
-.Dd $Mdocdate: March 17 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt DHCRELAY6 8
.Os
.Sh NAME
.Ar destination
might be an address followed by a `%' and an interface name,
or just an interface name (e.g. "2001:db8::1%em0" or "em1").
-When no address is specified
+When no address is specified,
.Nm
will use multicast on the specified interface.
.Pp
relay agent information option value that
.Nm
should use on relayed packets.
-If this option is not specified it will use the interface name by
+If this option is not specified, it will use the interface name by
default.
.Pp
Avoid using this option when using Lightweight DHCPv6 Relay Mode
-.\" $OpenBSD: edquota.8,v 1.12 2016/03/17 18:50:48 mmcc Exp $
+.\" $OpenBSD: edquota.8,v 1.13 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 1983, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\" SUCH DAMAGE.
.\"
.\" from: @(#)edquota.8 8.1 (Berkeley) 6/6/93
-.\" $Id: edquota.8,v 1.12 2016/03/17 18:50:48 mmcc Exp $
+.\" $Id: edquota.8,v 1.13 2022/03/31 17:27:29 naddy Exp $
.\"
-.Dd $Mdocdate: March 17 2016 $
+.Dd $Mdocdate: March 31 2022 $
.Dt EDQUOTA 8
.Os
.Sh NAME
.Pa /etc/fstab .
When invoked with the
.Fl g
-flag the grace period is
+flag, the grace period is
set for all the filesystems with group quotas specified in
.Pa /etc/fstab .
The grace period may be specified in days, hours, minutes, or seconds.
-.\" $OpenBSD: ftp-proxy.8,v 1.24 2020/02/12 14:46:36 schwarze Exp $
+.\" $OpenBSD: ftp-proxy.8,v 1.25 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 2004, 2005 Camiel Dobbelaar, <cd@sentia.nl>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: February 12 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt FTP-PROXY 8
.Os
.Sh NAME
.Pp
Since
.Nm
-acts as a man-in-the-middle it breaks explicit FTP TLS connections (RFC 4217).
+acts as a man-in-the-middle, it breaks explicit FTP TLS connections (RFC 4217).
-.\" $OpenBSD: hostapd.8,v 1.22 2022/02/18 02:20:33 jsg Exp $
+.\" $OpenBSD: hostapd.8,v 1.23 2022/03/31 17:27:29 naddy Exp $
.\"
.\" Copyright (c) 2004, 2005 Reyk Floeter <reyk@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: February 18 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt HOSTAPD 8
.Os
.Sh NAME
IAPP message when a new station is associated to the Host AP.
When
.Nm
-receives an ADD.notify message it tells the Host AP
+receives an ADD.notify message, it tells the Host AP
to remove the specified station.
.Pp
.Nm
-.\" $OpenBSD: ikectl.8,v 1.27 2020/04/25 18:38:21 tobhe Exp $
+.\" $OpenBSD: ikectl.8,v 1.28 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2007-2013 Reyk Floeter <reyk@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: April 25 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt IKECTL 8
.Os
.Sh NAME
argument.
If the
.Ic ocsp
-argument is specified the extended key usage will be set for OCSP signing.
+argument is specified, the extended key usage will be set for OCSP signing.
.It Xo
.Cm ca Ar name Cm certificate Ar host
.Cm delete
-.\" $OpenBSD: iscsi.conf.5,v 1.4 2020/04/23 21:28:09 jmc Exp $
+.\" $OpenBSD: iscsi.conf.5,v 1.5 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2012 Claudio Jeker <claudio@openbsd.org>
.\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: April 23 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt ISCSI.CONF 5
.Os
.Sh NAME
The
.Ic initiatorname
can be used to restrict access to a target.
-If not given
+If not given,
.Xr iscsid 8
will use
.Em iqn.1995-11.org.openbsd.iscsid
-.\" $OpenBSD: ldom.conf.5,v 1.16 2021/11/17 15:13:36 kn Exp $
+.\" $OpenBSD: ldom.conf.5,v 1.17 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2012 Mark Kettenis <kettenis@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 17 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt LDOM.CONF 5 sparc64
.Os
.Sh NAME
.Ar name
.Dq primary
configures resources for the primary domain.
-If no configuration for the primary domain exists it is assigned
+If no configuration for the primary domain exists, it is assigned
all CPU and memory resources not used by any guest domains.
.It Ic vcpu Ar number Ns Op : Ns Ar stride
Declare the number of virtual CPUs assigned to a domain.
-.\" $OpenBSD: mopd.8,v 1.18 2013/10/20 07:40:43 jmc Exp $
+.\" $OpenBSD: mopd.8,v 1.19 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 1993-96 Mats O Jansson. All rights reserved.
.\"
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" @(#) $OpenBSD: mopd.8,v 1.18 2013/10/20 07:40:43 jmc Exp $
+.\" @(#) $OpenBSD: mopd.8,v 1.19 2022/03/31 17:27:30 naddy Exp $
.\"
-.Dd $Mdocdate: October 20 2013 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MOPD 8
.Os
.Sh NAME
.Nm
a filename can be given.
This is the normal case for, e.g., terminal servers.
-If a filename isn't given
+If a filename isn't given,
.Nm
must know what image to load.
.Pp
-.\" $OpenBSD: mopprobe.1,v 1.16 2017/07/06 16:50:58 schwarze Exp $
+.\" $OpenBSD: mopprobe.1,v 1.17 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 1996 Mats O Jansson. All rights reserved.
.\"
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: July 6 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MOPPROBE 1
.Os
.Sh NAME
.Fl a
is given.
If
-.Fl o
+.Fl o ,
inhibits all messages but the first from a node.
With
.Fl v
-.\" $OpenBSD: netgroup_mkdb.8,v 1.9 2018/06/07 11:37:21 jmc Exp $
+.\" $OpenBSD: netgroup_mkdb.8,v 1.10 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 1994 Christos Zoulas
.\" All rights reserved.
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: June 7 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt NETGROUP_MKDB 8
.Os
.Sh NAME
.Sh BUGS
Because
.Nm netgroup_mkdb
-guarantees not to install a partial destination file it must
+guarantees not to install a partial destination file, it must
build a temporary file in the same file system and if successful use
.Xr rename 2
to install over the destination file.
.Pp
If
.Nm netgroup_mkdb
-fails it will leave the previous version of the destination file intact.
+fails, it will leave the previous version of the destination file intact.
-.\" $OpenBSD: npppd.conf.5,v 1.29 2022/03/10 03:09:55 jsg Exp $
+.\" $OpenBSD: npppd.conf.5,v 1.30 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2012 YASUOKA Masahiko <yasuoka@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: March 10 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt NPPPD.CONF 5
.Os
.Sh NAME
.It Ic pppoe-accept-any-service Ar yes | no
If
.Dq yes
-is specified
+is specified,
.Xr npppd 8
accepts requests from clients that are accepting any service names.
The default value is
-.\" $OpenBSD: ntpd.conf.5,v 1.47 2021/01/06 13:03:13 jmc Exp $
+.\" $OpenBSD: ntpd.conf.5,v 1.48 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org>
.\"
.\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 6 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt NTPD.CONF 5
.Os
.Sh NAME
.It Ic constraint from Ar url [ip...]
Specify the URL, IP address or the hostname of an HTTPS server to
provide a constraint.
-If the url is followed by one or more addresses the url and addresses will be
+If the url is followed by one or more addresses, the url and addresses will be
tried until a working one is found.
The url path and expected certificate name is always taken from the
url specified.
-.\" $OpenBSD: ospf6d.8,v 1.19 2019/11/10 20:51:53 landry Exp $
+.\" $OpenBSD: ospf6d.8,v 1.20 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2004, 2005, 2007 Esben Norby <norby@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 10 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OSPF6D 8
.Os
.Sh NAME
All routers in an OSPF network spend most of their time keeping each others'
LSDBs in sync.
All routers must have the same information in the LSDB at all times.
-Every time the LSDB is updated the RIB is updated; if needed the FIB is
+Every time the LSDB is updated, the RIB is updated; if needed, the FIB is
also updated.
.Pp
In a multi-access network such as Ethernet, it is unfeasible for all routers
routers but the DR and BDR.
Routers with 2-WAY adjacency recognize that they know each other,
but do not exchange information about their LSDBs.
-If a DR or BDR fails another router is elected DR or BDR
+If a DR or BDR fails, another router is elected DR or BDR
and all routers form FULL adjacencies with the newly elected DR or BDR.
.Pp
When routers are connected via point-to-point links, DR and BDR
-.\" $OpenBSD: ospf6d.conf.5,v 1.24 2020/05/16 16:58:12 jmc Exp $
+.\" $OpenBSD: ospf6d.conf.5,v 1.25 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
.\" Copyright (c) 2004 Claudio Jeker <claudio@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: May 16 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OSPF6D.CONF 5
.Os
.Sh NAME
Set the router dead time, a.k.a. neighbor inactivity timer.
The default value is 40 seconds; valid range is 2\-65535 seconds.
When a neighbor has been
-inactive for router-dead-time its state is set to DOWN.
+inactive for router-dead-time, its state is set to DOWN.
Neighbors
that have been inactive for more than 24 hours are completely removed.
.It Ic router-priority Ar priority
Set the router priority.
The default value is 1; valid range is 0\-255.
If set
-to 0 the router is not eligible as a Designated Router or Backup Designated
+to 0, the router is not eligible as a Designated Router or Backup Designated
Router.
.It Ic transmit-delay Ar seconds
Set the transmit delay.
-.\" $OpenBSD: ospfd.8,v 1.32 2019/11/10 20:51:53 landry Exp $
+.\" $OpenBSD: ospfd.8,v 1.33 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2004, 2005, 2007 Esben Norby <norby@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: November 10 2019 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OSPFD 8
.Os
.Sh NAME
All routers in an OSPF network spend most of their time keeping each others'
LSDBs in sync.
All routers must have the same information in the LSDB at all times.
-Every time the LSDB is updated the RIB is updated; if needed the FIB is
+Every time the LSDB is updated, the RIB is updated; if needed, the FIB is
also updated.
.Pp
In a multi-access network such as Ethernet, it is unfeasible for all routers
routers but the DR and BDR.
Routers with 2-WAY adjacency recognize that they know each other,
but do not exchange information about their LSDBs.
-If a DR or BDR fails another router is elected DR or BDR
+If a DR or BDR fails, another router is elected DR or BDR
and all routers form FULL adjacencies with the newly elected DR or BDR.
.Pp
When routers are connected via point-to-point links, DR and BDR
-.\" $OpenBSD: ospfd.conf.5,v 1.62 2020/05/16 16:58:12 jmc Exp $
+.\" $OpenBSD: ospfd.conf.5,v 1.63 2022/03/31 17:27:30 naddy Exp $
.\"
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
.\" Copyright (c) 2004 Claudio Jeker <claudio@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: May 16 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt OSPFD.CONF 5
.Os
.Sh NAME
Each interface can have several parameters configured individually, otherwise
they are inherited.
An interface is specified by its name.
-If multiple networks are configured an additional IP address can be supplied.
+If multiple networks are configured, an additional IP address can be supplied.
By default the first IP address is used.
.Bd -literal -offset indent
interface em0 {
specified by
.Ic fast-hello-interval .
When a neighbor has been
-inactive for router-dead-time its state is set to DOWN.
+inactive for router-dead-time, its state is set to DOWN.
Neighbors
that have been inactive for more than 24 hours are completely removed.
.It Ic router-priority Ar priority
Set the router priority.
The default value is 1; valid range is 0\-255.
If set
-to 0 the router is not eligible as a Designated Router or Backup Designated
+to 0, the router is not eligible as a Designated Router or Backup Designated
Router.
.It Ic transmit-delay Ar seconds
Set the transmit delay.
-.\" $OpenBSD: chat.8,v 1.19 2011/07/25 18:33:19 jmc Exp $
+.\" $OpenBSD: chat.8,v 1.20 2022/03/31 17:27:31 naddy Exp $
.\" Id: chat.8,v 1.7 1998/02/04 01:35:49 paulus Exp $
.\" manual page [] for chat 1.8
-.Dd $Mdocdate: July 25 2011 $
+.Dd $Mdocdate: March 31 2022 $
.Dt CHAT 8
.Os
.Sh NAME
.Em CONNECT .
If the string
.Em CONNECT
-is received the remainder of the script is executed.
+is received, the remainder of the script is executed.
However, should the modem find a busy telephone, it will send the string
.Em BUSY .
This will cause the string to match the abort character sequence.
.Em CONNECT .
If the string
.Em CONNECT
-is received the remainder of the script is executed.
+is received, the remainder of the script is executed.
In addition the program will write to the expect-file the string
.Dq CONNECT
plus any characters which follow it such as the connection rate.
-.\" $OpenBSD: pppd.8,v 1.47 2020/12/03 22:47:22 jmc Exp $
+.\" $OpenBSD: pppd.8,v 1.48 2022/03/31 17:27:31 naddy Exp $
.\" Id: pppd.8,v 1.27 1998/03/31 04:31:08 paulus Exp $
.\"
.\" Copyright (c) 1993-2003 Paul Mackerras <paulus@samba.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: December 3 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PPPD 8
.Os
.Sh NAME
.Xr cua 4
device (as opposed to a
.Xr tty 4
-device)
+device),
you should set this option.
You should not use this option with a dialback setup as it will cause
the chat script to exit when carrier drops.
-.\" $OpenBSD: pwd_mkdb.8,v 1.28 2017/09/10 16:24:43 schwarze Exp $
+.\" $OpenBSD: pwd_mkdb.8,v 1.29 2022/03/31 17:27:31 naddy Exp $
.\"
.\" Copyright (c) 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" from: @(#)pwd_mkdb.8 8.1 (Berkeley) 6/6/93
.\"
-.Dd $Mdocdate: September 10 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt PWD_MKDB 8
.Os
.Sh NAME
This is most commonly used in conjunction with the
.Fl u
flag during a password change.
-Because the insecure database doesn't contain the password there
+Because the insecure database doesn't contain the password, there
is no reason to update it if the only change is in the password field.
Cannot be used in conjunction with the
.Fl p
-.\" $OpenBSD: relayd.conf.5,v 1.204 2022/02/06 00:29:03 jsg Exp $
+.\" $OpenBSD: relayd.conf.5,v 1.205 2022/03/31 17:27:31 naddy Exp $
.\"
.\" Copyright (c) 2006 - 2016 Reyk Floeter <reyk@openbsd.org>
.\" Copyright (c) 2006, 2007 Pierre-Yves Ritschard <pyr@openbsd.org>
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: February 6 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RELAYD.CONF 5
.Os
.Sh NAME
.Pq enterprises.30155.3 .
If
.Ar path
-is omitted it will default to
+is omitted, it will default to
.Pa /var/agentx/master .
.Ar Context
is the SNMPv3 context and can usually be omitted.
-.\" $OpenBSD: bootparams.5,v 1.12 2017/07/13 19:16:33 jmc Exp $
+.\" $OpenBSD: bootparams.5,v 1.13 2022/03/31 17:27:31 naddy Exp $
.\"
.\" Copyright (c) 1994 Gordon W. Ross
.\" All rights reserved.
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: July 13 2017 $
+.Dd $Mdocdate: March 31 2022 $
.Dt BOOTPARAMS 5
.Os
.Sh NAME
.Ed
.Pp
When the client named "client" requests the pathname for
-its logical "root" it will be given the server name "server"
+its logical "root", it will be given the server name "server"
and the pathname
.Pa /export/client/root
as the response to its
-.\" $OpenBSD: rpki-client.8,v 1.56 2022/01/26 14:42:39 claudio Exp $
+.\" $OpenBSD: rpki-client.8,v 1.57 2022/03/31 17:27:31 naddy Exp $
.\"
.\" Copyright (c) 2019 Kristaps Dzonsons <kristaps@bsd.lv>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: January 26 2022 $
+.Dd $Mdocdate: March 31 2022 $
.Dt RPKI-CLIENT 8
.Os
.Sh NAME
and print human-readable information about the object.
If
.Ar file
-is an rsync:// URI the corresponding file from the cache will be used.
+is an rsync:// URI, the corresponding file from the cache will be used.
This option implies
.Fl n .
.It Fl j
-.\" $OpenBSD: smtpd-filters.7,v 1.8 2021/11/21 06:48:15 jmc Exp $
+.\" $OpenBSD: smtpd-filters.7,v 1.9 2022/03/31 17:27:31 naddy Exp $
.\"
.\" Copyright (c) 2008 Janne Johansson <jj@openbsd.org>
.\" Copyright (c) 2009 Jacek Masiulaniec <jacekm@dobremiasto.net>
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.\"
-.Dd $Mdocdate: November 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SMTPD-FILTERS 7
.Os
.Sh NAME
.Pp
When
.Xr smtpd 8
-has sent all configuration keys it emits the following line:
+has sent all configuration keys, it emits the following line:
.Bd -literal -offset indent
config|ready
.Ed
-.\" $OpenBSD: smtpd.conf.5,v 1.262 2021/11/21 06:48:15 jmc Exp $
+.\" $OpenBSD: smtpd.conf.5,v 1.263 2022/03/31 17:27:31 naddy Exp $
.\"
.\" Copyright (c) 2008 Janne Johansson <jj@openbsd.org>
.\" Copyright (c) 2009 Jacek Masiulaniec <jacekm@dobremiasto.net>
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.\"
-.Dd $Mdocdate: November 21 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SMTPD.CONF 5
.Os
.Sh NAME
The Administrative Management Domain this mail server belongs to.
The authservid will be forwarded to filters using it to identify or mark
authentication-results headers.
-If omitted it defaults to the server name.
+If omitted, it defaults to the server name.
.It Ic bounce Cm warn-interval Ar delay Op , Ar delay ...
Send warning messages to the envelope sender when temporary delivery
failures cause a message to remain in the queue for longer than
-.\" $OpenBSD: snmpd.conf.5,v 1.58 2021/09/02 05:41:02 martijn Exp $
+.\" $OpenBSD: snmpd.conf.5,v 1.59 2022/03/31 17:27:31 naddy Exp $
.\"
.\" Copyright (c) 2007, 2008, 2012 Reyk Floeter <reyk@openbsd.org>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: September 2 2021 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SNMPD.CONF 5
.Os
.Sh NAME
when
.Ar port
is 162.
-If no subsystem flags are specified it defaults to
+If no subsystem flags are specified, it defaults to
.Ic snmpv3 .
.Pp
Having
.Ic user .
If
.Ic seclevel
-is not defined it defaults to the global
+is not defined, it defaults to the global
.Ic seclevel
option.
The IPv4 or IPv6 source address of the traps can be enforced using
.Ic hmac-sha384 ,
or
.Ic hmac-sha512 .
-If omitted the default is
+If omitted, the default is
.Ic hmac-sha1 .
.Pp
With
-.\" $OpenBSD: syslogc.8,v 1.10 2015/11/05 09:48:05 jmc Exp $
+.\" $OpenBSD: syslogc.8,v 1.11 2022/03/31 17:27:32 naddy Exp $
.\"
.\" Copyright (c) 2004 Damien Miller
.\"
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.Dd $Mdocdate: November 5 2015 $
+.Dd $Mdocdate: March 31 2022 $
.Dt SYSLOGC 8
.Os
.Sh NAME
and the exit status will be set to 1.
.It Fl q
Request a list of available logs.
-If a log has overflowed an asterisk
+If a log has overflowed, an asterisk
.Pq Ql *
will be appended to its name.
.It Fl s Ar reporting_socket
-.\" $OpenBSD: tftp-proxy.8,v 1.9 2018/11/05 07:03:08 jmc Exp $
+.\" $OpenBSD: tftp-proxy.8,v 1.10 2022/03/31 17:27:32 naddy Exp $
.\"
.\" Copyright (c) 2005 joshua stein <jcs@openbsd.org>
.\"
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 5 2018 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TFTP-PROXY 8
.Os
.Sh NAME
seconds, the states are assumed to have been established and the
.Xr pf 4
rules are deleted and the program exits.
-Once the transfer between the client and the server is completed the
+Once the transfer between the client and the server is completed, the
states will naturally expire.
.Pp
The options are as follows:
-.\" $OpenBSD: tokenadm.8,v 1.6 2007/05/31 19:20:30 jmc Exp $
+.\" $OpenBSD: tokenadm.8,v 1.7 2022/03/31 17:27:32 naddy Exp $
.\"
.\" Copyright (c) 1996 Berkeley Software Design, Inc. All rights reserved.
.\"
.\"
.\" BSDI $From: tokenadm.8,v 1.3 1996/09/06 00:44:07 prb Exp $
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: March 31 2022 $
.Dt TOKENADM 8
.Os
.Sh NAME
or
.Fl e
flags.
-Whenever reduced-input mode is set the reduced-input state is reset.
+Whenever reduced-input mode is set, the reduced-input state is reset.
This should be done if a paper copy of challenge/responses had been
produced and then misplaced.
.It Fl R
-.\" $OpenBSD: mkalias.8,v 1.12 2020/11/01 21:32:04 jmc Exp $
+.\" $OpenBSD: mkalias.8,v 1.13 2022/03/31 17:27:32 naddy Exp $
.\"
.\" Copyright (c) 1997 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 1 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt MKALIAS 8
.Os
.Sh NAME
.Nm
on SunOS 4.1.x seems to have a
.Fl s .
-Since I don't know what it is supposed to do I haven't implemented it.
+Since I don't know what it is supposed to do, I haven't implemented it.
But it is accepted by the program.
-.\" $OpenBSD: ypserv.acl.5,v 1.26 2020/11/01 21:32:04 jmc Exp $
+.\" $OpenBSD: ypserv.acl.5,v 1.27 2022/03/31 17:27:32 naddy Exp $
.\"
.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: November 1 2020 $
+.Dd $Mdocdate: March 31 2022 $
.Dt YPSERV.ACL 5
.Os
.Sh NAME
server reads the configuration file and builds a list in memory.
This list is processed from the beginning for every incoming request.
As soon as a
-match is found in the list the search terminates and it returns success
+match is found in the list, the search terminates and it returns success
or failure depending on which of
.Ic allow
or
was specified.
If no match was found in the list, success is returned.
.Pp
-If access is denied every call will cause a
+If access is denied, every call will cause a
.Dq no such domain
error for the caller.
.Pp
-.\" $OpenBSD: zic.8,v 1.4 2020/10/07 22:36:14 millert Exp $
-.Dd $Mdocdate: October 7 2020 $
+.\" $OpenBSD: zic.8,v 1.5 2022/03/31 17:27:32 naddy Exp $
+.Dd $Mdocdate: March 31 2022 $
.Dt ZIC 8
.Os
.Sh NAME
.Dq EDT )
of time zone abbreviations to be used when this rule is in effect.
If this field is
-.Dq Fl
+.Dq \- ,
the variable part is null.
.El
.Pp
projects / openbsd / commitdiff