-.\" $OpenBSD: frexp.3,v 1.13 2013/06/05 03:39:22 tedu Exp $
+.\" $OpenBSD: frexp.3,v 1.14 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 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: June 5 2013 $
+.Dd $Mdocdate: September 11 2022 $
.Dt FREXP 3
.Os
.Sh NAME
function breaks a floating-point number into a normalized
fraction and an integral power of 2.
It stores the integer in the
-.Li int
+.Vt int
object pointed to by
.Fa exp .
The
such that
.Li x
is a
-.Li double
+.Vt double
with magnitude in the interval [1/2,\ 1) or zero, and
.Fa value
equals
-.\" $OpenBSD: getgrent.3,v 1.25 2022/08/02 16:47:16 deraadt Exp $
+.\" $OpenBSD: getgrent.3,v 1.26 2022/09/11 06:38:10 jmc 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: August 2 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETGRENT 3
.Os
.Sh NAME
in
.Xr group 5 .
Each line of the database is defined by the structure
-.Li struct group
+.Vt struct group
found in the include
file
.In grp.h :
-.\" $OpenBSD: getpwent.3,v 1.32 2018/08/21 20:20:04 millert Exp $
+.\" $OpenBSD: getpwent.3,v 1.33 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1988, 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 21 2018 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETPWENT 3
.Os
.Sh NAME
These functions operate on the password database file which is described in
.Xr passwd 5 .
Each entry in the database is defined by the structure
-.Li struct passwd
+.Vt struct passwd
found in the include file
.In pwd.h :
.Bd -literal -offset indent
-.\" $OpenBSD: getpwnam.3,v 1.13 2018/08/21 20:20:04 millert Exp $
+.\" $OpenBSD: getpwnam.3,v 1.14 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1988, 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 21 2018 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETPWNAM 3
.Os
.Sh NAME
These functions operate on the password database file which is described in
.Xr passwd 5 .
Each entry in the database is defined by the structure
-.Li struct passwd
+.Vt struct passwd
found in the include file
.In pwd.h :
.Bd -literal -offset indent
-.\" $OpenBSD: glob.3,v 1.38 2022/07/29 17:34:07 schwarze Exp $
+.\" $OpenBSD: glob.3,v 1.39 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993, 1994
.\" 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: July 29 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GLOB 3
.Os
.Sh NAME
The include file
.In glob.h
defines the structure type
-.Li glob_t ,
+.Vt glob_t ,
which contains at least the following fields:
.Bd -literal
typedef struct {
-.\" $OpenBSD: isalnum.3,v 1.12 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isalnum.3,v 1.13 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISALNUM 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isalpha.3,v 1.13 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isalpha.3,v 1.14 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISALPHA 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isblank.3,v 1.13 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isblank.3,v 1.14 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISBLANK 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: iscntrl.3,v 1.13 2017/10/04 18:19:25 schwarze Exp $
+.\" $OpenBSD: iscntrl.3,v 1.14 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: October 4 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISCNTRL 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isdigit.3,v 1.12 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isdigit.3,v 1.13 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISDIGIT 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isgraph.3,v 1.12 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isgraph.3,v 1.13 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISGRAPH 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: islower.3,v 1.13 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: islower.3,v 1.14 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISLOWER 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isprint.3,v 1.12 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isprint.3,v 1.13 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISPRINT 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: ispunct.3,v 1.12 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: ispunct.3,v 1.13 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISPUNCT 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isspace.3,v 1.14 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isspace.3,v 1.15 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISSPACE 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isupper.3,v 1.14 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isupper.3,v 1.15 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISUPPER 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: isxdigit.3,v 1.11 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: isxdigit.3,v 1.12 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ISXDIGIT 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: lockf.3,v 1.13 2013/06/05 03:39:22 tedu Exp $
+.\" $OpenBSD: lockf.3,v 1.14 2022/09/11 06:38:10 jmc Exp $
.\" $NetBSD: lockf.3,v 1.1 1997/12/20 20:23:17 kleink 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: June 5 2013 $
+.Dd $Mdocdate: September 11 2022 $
.Dt LOCKF 3
.Os
.Sh NAME
.Fa size
is non-zero and the offset of the last byte of
the requested section is the maximum value for an object of type
-.Li off_t ,
+.Vt off_t ,
when the process has an existing lock in which size is 0 and
which includes the last byte of the requested section, will be treated
as a request to unlock from the start of the requested section with a
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: login_cap.3,v 1.22 2022/03/23 14:52:25 millert Exp $
+.\" $OpenBSD: login_cap.3,v 1.23 2022/09/11 06:38:10 jmc Exp $
.\" BSDI $From: login_cap.3,v 1.4 1997/11/07 16:22:27 jch Exp $
.\"
-.Dd $Mdocdate: March 23 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt LOGIN_GETCLASS 3
.Os
.Sh NAME
(see
.Xr login.conf 5 ) .
If the entry is found, a
-.Li login_cap_t
+.Vt login_cap_t
pointer is returned.
.Dv NULL
is returned if the user class is not found.
When the
-.Li login_cap_t
+.Vt login_cap_t
structure is no longer needed, it should be freed by the
.Fn login_close
function.
-.\" $OpenBSD: modf.3,v 1.12 2013/06/05 03:39:22 tedu Exp $
+.\" $OpenBSD: modf.3,v 1.13 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 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: June 5 2013 $
+.Dd $Mdocdate: September 11 2022 $
.Dt MODF 3
.Os
.Sh NAME
into integral and fractional parts, each of which has the
same sign as the argument.
It stores the integral part as a
-.Li double
+.Vt double
in the object pointed to by
.Fa iptr .
The
-.\" $OpenBSD: opendir.3,v 1.1 2019/09/02 21:18:41 deraadt Exp $
+.\" $OpenBSD: opendir.3,v 1.2 2022/09/11 06:38:10 jmc 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: September 2 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt OPENDIR 3
.Os
.Sh NAME
function (much like
.Fn readdir )
initializes the
-.Li dirent
+.Vt dirent
structure referenced by
.Fa entry
to represent the next directory entry in the named directory stream
-.\" $OpenBSD: setjmp.3,v 1.25 2016/05/23 00:18:56 guenther Exp $
+.\" $OpenBSD: setjmp.3,v 1.26 2022/09/11 06:38:10 jmc 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: May 23 2016 $
+.Dd $Mdocdate: September 11 2022 $
.Dt SETJMP 3
.Os
.Sh NAME
.Fn longjmp
routine was called, except that the values of objects of automatic storage
invocation duration that do not have the
-.Li volatile
+.Vt volatile
type and have been changed between the
.Fn setjmp
invocation and
-.\" $OpenBSD: times.3,v 1.15 2018/03/02 16:35:58 cheloha Exp $
+.\" $OpenBSD: times.3,v 1.16 2022/09/11 06:38:10 jmc 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: March 2 2018 $
+.Dd $Mdocdate: September 11 2022 $
.Dt TIMES 3
.Os
.Sh NAME
with time-accounting information.
.Pp
The
-.Li tms
+.Vt tms
structure is defined as follows:
.Bd -literal -offset indent
struct tms {
-.\" $OpenBSD: tolower.3,v 1.14 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: tolower.3,v 1.15 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1989, 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt TOLOWER 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: toupper.3,v 1.16 2017/09/05 03:16:13 schwarze Exp $
+.\" $OpenBSD: toupper.3,v 1.17 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1989, 1991 The Regents of the University of California.
.\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org>
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: September 5 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt TOUPPER 3
.Os
.Sh NAME
must be
.Dv EOF
or representable as an
-.Li unsigned char ;
+.Vt unsigned char ;
otherwise, the result is undefined.
-.\" $OpenBSD: uname.3,v 1.17 2022/07/25 02:25:55 jsg Exp $
+.\" $OpenBSD: uname.3,v 1.18 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1994
.\" 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: July 25 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt UNAME 3
.Os
.Sh NAME
.Fa name .
.Pp
The
-.Li utsname
+.Vt utsname
structure is defined in the
.In sys/utsname.h
header file, and contains the following members:
-.\" $OpenBSD: utime.3,v 1.22 2015/01/29 01:46:30 schwarze Exp $
+.\" $OpenBSD: utime.3,v 1.23 2022/09/11 06:38:10 jmc 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: January 29 2015 $
+.Dd $Mdocdate: September 11 2022 $
.Dt UTIME 3
.Os
.Sh NAME
If
.Fa timep
is non-null, it specifies a pointer to a
-.Li utimbuf
+.Vt utimbuf
structure, as defined in
.In utime.h :
.Bd -literal -offset indent
-.\" $OpenBSD: localeconv.3,v 1.3 2022/08/04 06:20:24 jsg Exp $
+.\" $OpenBSD: localeconv.3,v 1.4 2022/09/11 06:38:10 jmc Exp $
.\" $NetBSD: setlocale.3,v 1.3 1997/07/14 23:19:47 kleink Exp $
.\"
.\" Copyright (c) 1993
.\"
.\" @(#)setlocale.3 8.1 (Berkeley) 6/9/93
.\"
-.Dd $Mdocdate: August 4 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt LOCALECONV 3
.Os
.Sh NAME
.It Fa grouping
The sizes of the groups of digits, except for currency values.
This is a pointer to a vector of integers, each of size
-.Li char ,
+.Vt char ,
representing group size from low order digit groups
to high order (right to left).
The list may be terminated with 0 or
-.\" $OpenBSD: ether_aton.3,v 1.2 2022/03/29 18:15:52 naddy Exp $
+.\" $OpenBSD: ether_aton.3,v 1.3 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Written by roland@frob.com. Public domain.
.\"
-.Dd $Mdocdate: March 29 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ETHER_ATON 3
.Os
.Sh NAME
function parses a line from the
.Pa /etc/ethers
file and fills in the passed
-.Li struct ether_addr
+.Vt struct ether_addr
and character buffer with the Ethernet address and host name on the line.
It returns zero if the line was successfully parsed and \-1 if not.
The character buffer should be
-.\" $OpenBSD: getaddrinfo.3,v 1.60 2022/03/31 17:27:16 naddy Exp $
+.\" $OpenBSD: getaddrinfo.3,v 1.61 2022/09/11 06:38:10 jmc 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: March 31 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETADDRINFO 3
.Os
.Sh NAME
.Pp
.Fa hints
is an optional pointer to a
-.Li struct addrinfo ,
+.Vt struct addrinfo ,
as defined by
.In netdb.h :
.Bd -literal
of the specified host name in the
.Fa ai_canonname
element of the first
-.Li addrinfo
+.Vt addrinfo
structure returned.
.It Dv AI_FQDN
If the
of the specified host name in the
.Fa ai_canonname
element of the first
-.Li addrinfo
+.Vt addrinfo
structure returned.
.Pp
This is different from the
.El
.Pp
All other elements of the
-.Li addrinfo
+.Vt addrinfo
structure passed via
.Fa hints
must be zero or the null pointer.
is the null pointer,
.Fn getaddrinfo
behaves as if the caller provided a
-.Li struct addrinfo
+.Vt struct addrinfo
with
.Fa ai_family
set to
.Fn getaddrinfo ,
.Fa *res
is a pointer to a linked list of one or more
-.Li addrinfo
+.Vt addrinfo
structures.
The list can be traversed by following the
.Fa ai_next
pointer in each
-.Li addrinfo
+.Vt addrinfo
structure until a null pointer is encountered.
The three members
.Fa ai_family ,
and
.Fa ai_protocol
in each returned
-.Li addrinfo
+.Vt addrinfo
structure are suitable for a call to
.Xr socket 2 .
For each
-.Li addrinfo
+.Vt addrinfo
structure in the list, the
.Fa ai_addr
member points to a filled-in socket address structure of length
All of the information returned by
.Fn getaddrinfo
is dynamically allocated: the
-.Li addrinfo
+.Vt addrinfo
structures themselves as well as the socket address structures and
the canonical host name strings included in the
-.Li addrinfo
+.Vt addrinfo
structures.
.Pp
Memory allocated for the dynamically allocated structures created by
The
.Fa ai
pointer should be an
-.Li addrinfo
+.Vt addrinfo
structure created by a call to
.Fn getaddrinfo .
.Sh RETURN VALUES
If an error occurs, no memory is allocated by
.Fn getaddrinfo ,
therefore it is not necessary to release the
-.Li addrinfo
+.Vt addrinfo
structure(s).
.Sh EXAMPLES
The following code tries to connect to
-.\" $OpenBSD: getnameinfo.3,v 1.48 2019/08/30 20:20:51 jmc Exp $
+.\" $OpenBSD: getnameinfo.3,v 1.49 2022/09/11 06:38:10 jmc Exp $
.\" $KAME: getnameinfo.3,v 1.37 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: September 11 2022 $
.Dt GETNAMEINFO 3
.Os
.Sh NAME
The
.Fn getnameinfo
function is used to convert a
-.Li sockaddr
+.Vt sockaddr
structure to a pair of host name and service strings.
It is a replacement for and provides more flexibility than the
.Xr gethostbyaddr 3
function.
.Pp
The
-.Li sockaddr
+.Vt sockaddr
structure
.Fa sa
should point to either a
-.Li sockaddr_in
+.Vt sockaddr_in
or
-.Li sockaddr_in6
+.Vt sockaddr_in6
structure (for IPv4 or IPv6 respectively) that is
.Fa salen
bytes long.
-.\" $OpenBSD: getpeereid.3,v 1.3 2013/06/05 03:39:23 tedu Exp $
+.\" $OpenBSD: getpeereid.3,v 1.4 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
-.Dd $Mdocdate: June 5 2013 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETPEEREID 3
.Os
.Sh NAME
.It
.Fa euid
points to a
-.Li uid_t
+.Vt uid_t
variable into which the effective user ID for the connected peer will
be stored.
.It
.Fa egid
points to a
-.Li gid_t
+.Vt gid_t
variable into which the effective group ID for the connected peer will
be stored.
.El
-.\" $OpenBSD: getrrsetbyname.3,v 1.21 2019/08/30 20:20:51 jmc Exp $
+.\" $OpenBSD: getrrsetbyname.3,v 1.22 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (C) 2000, 2001 Internet Software Consortium.
.\"
.\" 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: September 11 2022 $
.Dt GETRRSETBYNAME 3
.Os
.Sh NAME
.Fn getrrsetbyname ,
.Fa *res
is a pointer to an
-.Li rrsetinfo
+.Vt rrsetinfo
structure, containing a list of one or more
-.Li rdatainfo
+.Vt rdatainfo
structures containing resource records and potentially another list of
-.Li rdatainfo
+.Vt rdatainfo
structures containing SIG resource records associated with those records.
The members
.Li rri_rdclass
All of the information returned by
.Fn getrrsetbyname
is dynamically allocated: the
-.Li rrsetinfo
+.Vt rrsetinfo
and
-.Li rdatainfo
+.Vt rdatainfo
structures,
and the canonical host name strings pointed to by the
-.Li rrsetinfo
+.Vt rrsetinfo
structure.
Memory allocated for the dynamically allocated structures created by
a successful call to
.Fn freerrset .
.Li rrset
is a pointer to a
-.Li struct rrsetinfo
+.Vt struct rrsetinfo
created by a call to
.Fn getrrsetbyname .
.\" .Pp
-.\" $OpenBSD: htonl.3,v 1.5 2019/02/13 07:02:09 jmc Exp $
+.\" $OpenBSD: htonl.3,v 1.6 2022/09/11 06:38:10 jmc 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: February 13 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt HTONL 3
.Os
.Sh NAME
.Sq l )
is a mnemonic
for the traditional names for such quantities,
-.Li short
-and
-.Li long ,
-respectively.
+short and long, respectively.
Today, the C concept of
-.Li short
+.Vt short
and
-.Li long
+.Vt long
integers need not coincide with this traditional misunderstanding.
On machines which have a byte order which is the same as the network
order, routines are defined as null macros.
-.\" $OpenBSD: inet_addr.3,v 1.5 2019/08/30 20:06:07 jmc Exp $
+.\" $OpenBSD: inet_addr.3,v 1.6 2022/09/11 06:38:10 jmc Exp $
.\" $NetBSD: inet.3,v 1.7 1997/06/18 02:25:24 lukem Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\"
.\" @(#)inet.3 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: August 30 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt INET_ADDR 3
.Os
.Sh NAME
Also,
.Fn inet_addr
should have been designed to return a
-.Li struct in_addr .
+.Vt struct in_addr .
The newer
.Fn inet_aton
function does not share these problems, and almost all existing code
-.\" $OpenBSD: inet_net_ntop.3,v 1.3 2022/03/31 17:27:16 naddy Exp $
+.\" $OpenBSD: inet_net_ntop.3,v 1.4 2022/09/11 06:38:10 jmc 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: March 31 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt INET_NET_NTOP 3
.Os
.Sh NAME
The
.Fn inet_net_ntop
function converts an Internet network number from network format (usually a
-.Li struct in_addr
+.Vt struct in_addr
or some other binary form, in network byte order) to CIDR presentation format
(suitable for external display purposes).
.Fa bits
.Fn inet_net_pton
function converts a presentation format Internet network number (that is,
printable form as held in a character string) to network format (usually a
-.Li struct in_addr
+.Vt struct in_addr
or some other internal binary representation, in network byte order).
It returns the number of bits (either computed based on the class, or
specified with /CIDR), or \-1 if a failure occurred
-.\" $OpenBSD: inet_ntop.3,v 1.5 2021/09/01 15:59:22 claudio Exp $
+.\" $OpenBSD: inet_ntop.3,v 1.6 2022/09/11 06:38:10 jmc Exp $
.\" $NetBSD: inet.3,v 1.7 1997/06/18 02:25:24 lukem Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\"
.\" @(#)inet.3 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: September 1 2021 $
+.Dd $Mdocdate: September 11 2022 $
.Dt INET_NTOP 3
.Os
.Sh NAME
.Fn inet_pton
function converts a presentation format address (that is, printable form
as held in a character string) to network format (usually a
-.Li struct in_addr
+.Vt struct in_addr
or some other internal binary representation, in network byte order).
It returns 1 if the address was valid for the specified address family;
0 if the address wasn't parseable in the specified address family; or \-1
-.\" $OpenBSD: regex.3,v 1.29 2022/08/06 19:04:49 schwarze Exp $
+.\" $OpenBSD: regex.3,v 1.30 2022/09/11 06:38:10 jmc Exp $
.\"
.\" Copyright (c) 1997, Phillip F Knaack. All rights reserved.
.\"
.\"
.\" @(#)regex.3 8.4 (Berkeley) 3/20/94
.\"
-.Dd $Mdocdate: August 6 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt REGEXEC 3
.Os
.Sh NAME
The header
.In regex.h
declares two structure types,
-.Li regex_t
+.Vt regex_t
and
-.Li regmatch_t ,
+.Vt regmatch_t ,
the former for compiled internal forms and the latter for match reporting.
It also declares the four functions,
a type
-.Li regoff_t ,
+.Vt regoff_t ,
and a number of constants with names starting with
.Dv REG_ .
.Pp
subject to the flags in
.Fa cflags ,
and places the results in the
-.Li regex_t
+.Vt regex_t
structure pointed to by
.Fa preg .
The
points to an array of
.Fa nmatch
structures of type
-.Li regmatch_t .
+.Vt regmatch_t .
Such a structure has at least the members
.Fa rm_so
and
both of type
.Fa regoff_t
(a signed arithmetic type at least as large as an
-.Li off_t
+.Vt off_t
and a
-.Li ssize_t ) ,
+.Vt ssize_t ) ,
containing respectively the offset of the first character of a substring
and the offset of the first character after the end of the substring.
Offsets are measured from the beginning of the
is specified,
.Fa pmatch
must point to at least one
-.Li regmatch_t
+.Vt regmatch_t
(even if
.Fa nmatch
is 0 or
is non-NULL,
the error code should have arisen from use of
the
-.Li regex_t
+.Vt regex_t
pointed to by
.Fa preg ,
and if the error code came from
it should have been the result from the most recent
.Fn regcomp
using that
-.Li regex_t .
+.Vt regex_t .
.Pf ( Fn regerror
may be able to supply a more detailed message using information
from the
-.Li regex_t . )
+.Vt regex_t . )
.Fn regerror
places the NUL-terminated message into the buffer pointed to by
.Fa errbuf ,
pointed to by
.Fa preg .
The remaining
-.Li regex_t
+.Vt regex_t
is no longer a valid compiled RE
and the effect of supplying it to
.Fn regexec
-.\" $OpenBSD: xdr.3,v 1.27 2017/06/10 13:24:03 schwarze Exp $
+.\" $OpenBSD: xdr.3,v 1.28 2022/09/11 06:38:11 jmc Exp $
.\" Mostly converted to mandoc by Theo de Raadt, Tue Feb 24 04:04:46 MST 1998
.\"
.\" Copyright (c) 2010, Oracle America, Inc.
.\" 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 10 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt XDR_ARRAY 3
.Os
.Sh NAME
.Pp
.Fn xdr_double
is a filter primitive that translates between C
-.Li double
+.Vt double
precision numbers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_enum
is a filter primitive that translates between the C
-.Li enum
+.Vt enum
type (actually an integer) and its external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_float
is a filter primitive that translates between the C
-.Li float
+.Vt float
type and its external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fa len
is the byte length of the desired buffer.
Note: pointer is cast to
-.Li long * .
+.Vt long * .
Warning:
.Fn xdr_inline
may return
.Pp
.Fn xdr_long
is a filter primitive that translates between C
-.Li long
+.Vt long
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_int64_t
is a filter primitive that translates between C
-.Li int64_t
+.Vt int64_t
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Pp
.Fn xdr_short
is a filter primitive that translates between C
-.Li short
+.Vt short
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Pp
.Fn xdr_u_char
is a filter primitive that translates between
-.Li unsigned
+.Vt unsigned
C characters and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_u_int
is a filter primitive that translates between C
-.Li unsigned
+.Vt unsigned
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_u_long
is a filter primitive that translates between C
-.Li unsigned long
+.Vt unsigned long
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_u_int64_t
is a filter primitive that translates between C
-.Li u_int64_t
+.Vt u_int64_t
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_u_short
is a filter primitive that translates between C
-.Li unsigned short
+.Vt unsigned short
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.Pp
.Fn xdr_union
is a filter primitive that translates between a discriminated C
-.Li union
+.Vt union
and its corresponding external representation.
It first translates the discriminant of the union located at
.Fa dscmp .
This discriminant is always an
-.Li enum_t .
+.Vt enum_t .
Next the union located at
.Fa unp
is translated.
The parameter
.Fa choices
is a pointer to an array of
-.Li struct xdr_discrim
+.Vt struct xdr_discrim
structures, containing the two members
.Fa value
and
.Fa proc
is called to translate the union.
The end of the
-.Li struct xdr_discrim
+.Vt struct xdr_discrim
structure array is denoted by a routine of value
.Dv NULL .
If the discriminant is not found in the
-.\" $OpenBSD: fseek.3,v 1.18 2016/03/26 22:32:29 tb Exp $
+.\" $OpenBSD: fseek.3,v 1.19 2022/09/11 06:38:11 jmc 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: March 26 2016 $
+.Dd $Mdocdate: September 11 2022 $
.Dt FSEEK 3
.Os
.Sh NAME
function is identical to
.Fn fseek
except that it takes an
-.Li off_t
+.Vt off_t
as its
.Fa offset .
.Pp
function is identical to
.Fn ftell
except that its return value is of type
-.Li off_t .
+.Vt off_t .
.Pp
The
.Fn rewind
-.\" $OpenBSD: getc.3,v 1.15 2017/12/01 11:18:40 schwarze Exp $
+.\" $OpenBSD: getc.3,v 1.16 2022/09/11 06:38:11 jmc 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: December 1 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETC 3
.Os
.Sh NAME
The
.Fn getw
function obtains the next
-.Li int
+.Vt int
(if present)
from the stream pointed at by
.Fa stream .
-.\" $OpenBSD: putc.3,v 1.13 2017/12/01 11:18:40 schwarze Exp $
+.\" $OpenBSD: putc.3,v 1.14 2022/09/11 06:38:11 jmc 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: December 1 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt PUTC 3
.Os
.Sh NAME
function writes the character
.Fa c
(converted to an
-.Li unsigned char )
+.Vt unsigned char )
to the output stream pointed to by
.Fa stream .
.Pp
The
.Fn putw
function writes the specified
-.Li int
+.Vt int
.Fa w
to the named output
.Fa stream .
.At v7 .
.Sh BUGS
Since the size and byte order of an
-.Li int
+.Vt int
may vary from one machine to another,
.Fn putw
is not recommended for portable applications.
-.\" $OpenBSD: ungetc.3,v 1.10 2017/12/01 11:18:40 schwarze Exp $
+.\" $OpenBSD: ungetc.3,v 1.11 2022/09/11 06:38:11 jmc 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: December 1 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt UNGETC 3
.Os
.Sh NAME
function pushes the character
.Fa c
(converted to an
-.Li unsigned char )
+.Vt unsigned char )
back onto the input stream pointed to by
.Fa stream .
The pushed-backed characters will be returned by subsequent reads on the
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: atof.3,v 1.9 2019/01/16 12:55:49 schwarze Exp $
+.\" $OpenBSD: atof.3,v 1.10 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: January 16 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ATOF 3
.Os
.Sh NAME
function converts the initial portion of the string pointed to by
.Fa nptr
to
-.Li double
+.Vt double
representation.
.Pp
It is equivalent to:
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: atoi.3,v 1.12 2015/09/10 15:16:43 schwarze Exp $
+.\" $OpenBSD: atoi.3,v 1.13 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ATOI 3
.Os
.Sh NAME
function converts the initial portion of the string pointed to by
.Fa nptr
to
-.Li integer
+.Vt integer
representation.
.Pp
It is equivalent to:
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: atol.3,v 1.10 2015/09/10 15:16:43 schwarze Exp $
+.\" $OpenBSD: atol.3,v 1.11 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ATOL 3
.Os
.Sh NAME
function converts the initial portion of the string pointed to by
.Fa nptr
to
-.Li long integer
+.Vt long integer
representation.
.Pp
It is equivalent to:
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: atoll.3,v 1.8 2015/09/10 15:16:43 schwarze Exp $
+.\" $OpenBSD: atoll.3,v 1.9 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ATOLL 3
.Os
.Sh NAME
function converts the initial portion of the string pointed to by
.Fa nptr
to
-.Li long long integer
+.Vt long long integer
representation.
.Pp
It is equivalent to:
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: div.3,v 1.12 2016/08/14 23:18:03 guenther Exp $
+.\" $OpenBSD: div.3,v 1.13 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: August 14 2016 $
+.Dd $Mdocdate: September 11 2022 $
.Dt DIV 3
.Os
.Sh NAME
and returns the quotient and remainder in a structure named
.Fa div_t
that contains two
-.Li int
+.Vt int
members named
.Fa quot
and
-.\" $OpenBSD: getopt_long.3,v 1.24 2022/01/06 18:58:24 jmc Exp $
+.\" $OpenBSD: getopt_long.3,v 1.25 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: getopt_long.3,v 1.11 2002/10/02 10:54:19 wiz Exp $
.\"
.\" Copyright (c) 1988, 1991, 1993
.\"
.\" @(#)getopt.3 8.5 (Berkeley) 4/27/95
.\"
-.Dd $Mdocdate: January 6 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETOPT_LONG 3
.Os
.Sh NAME
If the
.Fa flag
field in
-.Li struct option
+.Vt struct option
is
.Dv NULL ,
.Fn getopt_long
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: imaxdiv.3,v 1.7 2016/08/14 23:18:03 guenther Exp $
+.\" $OpenBSD: imaxdiv.3,v 1.8 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: August 14 2016 $
+.Dd $Mdocdate: September 11 2022 $
.Dt IMAXDIV 3
.Os
.Sh NAME
function computes the value
.Fa num Ns / Ns Fa denom
and returns the quotient and remainder in a structure named
-.Li imaxdiv_t
+.Vt imaxdiv_t
that contains two
-.Li intmax_t
+.Vt intmax_t
members named
.Fa quot
and
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: ldiv.3,v 1.13 2016/08/14 23:18:03 guenther Exp $
+.\" $OpenBSD: ldiv.3,v 1.14 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: August 14 2016 $
+.Dd $Mdocdate: September 11 2022 $
.Dt LDIV 3
.Os
.Sh NAME
function computes the value
.Fa num Ns / Ns Fa denom
and returns the quotient and remainder in a structure named
-.Li ldiv_t
+.Vt ldiv_t
that contains two
-.Li long integer
+.Vt long integer
members named
.Fa quot
and
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: lldiv.3,v 1.8 2017/08/01 14:57:02 schwarze Exp $
+.\" $OpenBSD: lldiv.3,v 1.9 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: August 1 2017 $
+.Dd $Mdocdate: September 11 2022 $
.Dt LLDIV 3
.Os
.Sh NAME
function computes the value
.Fa num Ns / Ns Fa denom
and returns the quotient and remainder in a structure named
-.Li lldiv_t
+.Vt lldiv_t
that contains two
-.Li long long integer
+.Vt long long integer
members named
.Fa quot
and
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: strtod.3,v 1.22 2019/01/16 12:55:49 schwarze Exp $
+.\" $OpenBSD: strtod.3,v 1.23 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: January 16 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt STRTOD 3
.Os
.Sh NAME
function converts the initial portion of the string pointed to by
.Fa nptr
to
-.Li double
+.Vt double
representation.
The
.Fn strtof
function converts the initial portion of the string pointed to by
.Fa nptr
to
-.Li float
+.Vt float
representation.
The
.Fn strtold
function converts the initial portion of the string pointed to by
.Fa nptr
to
-.Li long double
+.Vt long double
representation.
.Pp
The expected form of the string is an optional plus
-.\" $OpenBSD: strtonum.3,v 1.18 2016/02/07 20:50:24 mmcc Exp $
+.\" $OpenBSD: strtonum.3,v 1.19 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 2004 Ted Unangst
.\"
.\" 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 7 2016 $
+.Dd $Mdocdate: September 11 2022 $
.Dt STRTONUM 3
.Os
.Sh NAME
function converts the string in
.Fa nptr
to a
-.Li long long
+.Vt long long
value.
The
.Fn strtonum
sign.
.Pp
The remainder of the string is converted to a
-.Li long long
+.Vt long long
value according to base 10.
.Pp
The value obtained is then checked against the provided
-.\" $OpenBSD: memccpy.3,v 1.12 2013/09/25 21:49:30 millert Exp $
+.\" $OpenBSD: memccpy.3,v 1.13 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" @(#)memccpy.3 8.1 (Berkeley) 6/9/93
.\"
-.Dd $Mdocdate: September 25 2013 $
+.Dd $Mdocdate: September 11 2022 $
.Dt MEMCCPY 3
.Os
.Sh NAME
If the character
.Fa c
(as converted to an
-.Li unsigned char )
+.Vt unsigned char )
occurs in the string
.Fa src ,
the copy stops and a pointer to the byte after the copy of
-.\" $OpenBSD: memchr.3,v 1.12 2014/04/07 17:57:56 schwarze Exp $
+.\" $OpenBSD: memchr.3,v 1.13 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 1990, 1991 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: April 7 2014 $
+.Dd $Mdocdate: September 11 2022 $
.Dt MEMCHR 3
.Os
.Sh NAME
function locates the first occurrence of
.Fa c
(converted to an
-.Li unsigned char )
+.Vt unsigned char )
in string
.Fa b .
.Pp
-.\" $OpenBSD: memcmp.3,v 1.9 2014/06/13 02:12:17 matthew Exp $
+.\" $OpenBSD: memcmp.3,v 1.10 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 1990, 1991 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: June 13 2014 $
+.Dd $Mdocdate: September 11 2022 $
.Dt MEMCMP 3
.Os
.Sh NAME
function returns zero if the two strings are identical,
otherwise returns the difference between the first two differing bytes
(treated as
-.Li unsigned char
+.Vt unsigned char
values, so that
.Sq Li \e200
is greater than
-.\" $OpenBSD: memset.3,v 1.8 2013/06/05 03:39:23 tedu Exp $
+.\" $OpenBSD: memset.3,v 1.9 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 1990, 1991 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: June 5 2013 $
+.Dd $Mdocdate: September 11 2022 $
.Dt MEMSET 3
.Os
.Sh NAME
bytes of value
.Fa c
(converted to an
-.Li unsigned char )
+.Vt unsigned char )
to the string
.Fa b .
.Sh RETURN VALUES
-.\" $OpenBSD: accept.2,v 1.29 2019/05/26 09:47:28 krw Exp $
+.\" $OpenBSD: accept.2,v 1.30 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: accept.2,v 1.7 1996/01/31 20:14:42 mycroft Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\"
.\" @(#)accept.2 8.2 (Berkeley) 12/11/93
.\"
-.Dd $Mdocdate: May 26 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt ACCEPT 2
.Os
.Sh NAME
parameter is determined by the domain in which the communication
is occurring.
The structure
-.Li sockaddr_storage
+.Vt sockaddr_storage
exists for greater portability.
It is large enough to hold any of the types that may be returned in the
.Fa addr
is set to indicate the error.
.Sh EXAMPLES
The following code uses struct
-.Li sockaddr_storage
+.Vt sockaddr_storage
to allocate enough space for the returned address:
.Bd -literal -offset indent
#include <sys/types.h>
-.\" $OpenBSD: fcntl.2,v 1.34 2022/03/29 18:15:52 naddy Exp $
+.\" $OpenBSD: fcntl.2,v 1.35 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: fcntl.2,v 1.6 1995/02/27 12:32:29 cgd Exp $
.\"
.\" Copyright (c) 1983, 1993
.\"
.\" @(#)fcntl.2 8.2 (Berkeley) 1/12/94
.\"
-.Dd $Mdocdate: March 29 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt FCNTL 2
.Os
.Sh NAME
and is technically a pointer to
.Fa void ,
but is interpreted as an
-.Li int
+.Vt int
by some commands, a pointer to a
-.Li struct flock
+.Vt struct flock
by others (see below), and ignored by the rest.
.Pp
The commands are:
Lowest numbered available descriptor greater than or equal to
.Fa arg
(interpreted as an
-.Li int ) .
+.Vt int ) .
.It
Same object references as the original descriptor.
.It
where
.Fa arg
(interpreted as an
-.Li int )
+.Vt int )
is either 0 or
.Dv FD_CLOEXEC ,
as described above.
to
.Fa arg
(interpreted as an
-.Li int ) .
+.Vt int ) .
.It Dv F_GETOWN
Get the process ID or process group
currently receiving
process groups are specified by supplying
.Fa arg
(interpreted as an
-.Li int )
+.Vt int )
as negative, otherwise
.Fa arg
is taken as a process ID.
-.\" $OpenBSD: getpeername.2,v 1.26 2015/09/10 17:55:21 schwarze Exp $
+.\" $OpenBSD: getpeername.2,v 1.27 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: getpeername.2,v 1.6 1995/10/12 15:40:56 jtc Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\"
.\" @(#)getpeername.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETPEERNAME 2
.Os
.Sh NAME
.Pp
.Fa name
points to a
-.Li sockaddr
+.Vt sockaddr
structure that will hold the address information for the connected peer.
Normal use requires one to use a structure
specific to the protocol family in use, such as
-.Li sockaddr_in
+.Vt sockaddr_in
(IPv4) or
-.Li sockaddr_in6
+.Vt sockaddr_in6
(IPv6), cast to a (struct sockaddr *).
.Pp
For greater portability, especially with the newer protocol families, the new
-.Li struct sockaddr_storage
+.Vt struct sockaddr_storage
should be used.
-.Li sockaddr_storage
+.Vt sockaddr_storage
is large enough to hold any of the other sockaddr_* variants.
On return, it can be cast to the correct sockaddr type,
based on the protocol family contained in its ss_family field.
-.\" $OpenBSD: getrlimit.2,v 1.28 2018/01/12 04:36:44 deraadt Exp $
+.\" $OpenBSD: getrlimit.2,v 1.29 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: getrlimit.2,v 1.8 1995/10/12 15:40:58 jtc Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\"
.\" @(#)getrlimit.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: January 12 2018 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETRLIMIT 2
.Os
.Sh NAME
respectively by
.Fn getrlimit
if the value for the current or maximum resource limit cannot be stored in an
-.Li rlim_t .
+.Vt rlim_t .
The values
.Dv RLIM_SAVED_CUR
and
-.\" $OpenBSD: getsockname.2,v 1.31 2022/03/31 17:27:16 naddy Exp $
+.\" $OpenBSD: getsockname.2,v 1.32 2022/09/11 06:38:11 jmc 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: March 31 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETSOCKNAME 2
.Os
.Sh NAME
.Pp
.Fa name
points to a
-.Li sockaddr
+.Vt sockaddr
structure which will hold the resulting address information.
Normal use requires one to use a structure
specific to the protocol family in use, such as
-.Li sockaddr_in
+.Vt sockaddr_in
(IPv4) or
-.Li sockaddr_in6
+.Vt sockaddr_in6
(IPv6), cast to a (struct sockaddr *).
.Pp
For greater portability (such as newer protocol families) the new
structure sockaddr_storage exists.
-.Li sockaddr_storage
+.Vt sockaddr_storage
is large enough to hold any of the other sockaddr_* variants.
On return, it should be cast to the correct sockaddr type,
according to the current protocol family.
-.\" $OpenBSD: getsockopt.2,v 1.59 2022/03/31 17:27:16 naddy Exp $
+.\" $OpenBSD: getsockopt.2,v 1.60 2022/09/11 06:38:11 jmc 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: March 31 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt GETSOCKOPT 2
.Os
.Sh NAME
consult the appropriate entries in section 4 of the manual.
.Pp
Most socket-level options utilize an
-.Li int
+.Vt int
parameter for
.Fa optval .
For
or zero if the option is to be disabled.
.Dv SO_LINGER
uses a
-.Li struct linger
+.Vt struct linger
parameter, defined in
.In sys/socket.h ,
which specifies the desired state of the option and the
and
.Dv SO_RCVTIMEO
use a
-.Li struct timeval
+.Vt struct timeval
parameter, defined in
.In sys/time.h .
.Pp
.Dv SO_SNDTIMEO
is an option to set a timeout value for output operations.
It accepts a
-.Li struct timeval
+.Vt struct timeval
parameter with the number of seconds and microseconds
used to limit waits for output operations to complete.
If a send operation has blocked for this much time,
.Dv SO_RCVTIMEO
is an option to set a timeout value for input operations.
It accepts a
-.Li struct timeval
+.Vt struct timeval
parameter with the number of seconds and microseconds
used to limit waits for input operations to complete.
In the current implementation, this timer is restarted each time additional
-.\" $OpenBSD: ioctl.2,v 1.19 2019/08/11 15:48:08 deraadt Exp $
+.\" $OpenBSD: ioctl.2,v 1.20 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: ioctl.2,v 1.5 1995/02/27 12:33:47 cgd Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\"
.\" @(#)ioctl.2 8.2 (Berkeley) 12/11/93
.\"
-.Dd $Mdocdate: August 11 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt IOCTL 2
.Os
.Sh NAME
to perform the requested function.
.Fa arg
is either an
-.Li int
+.Vt int
or a pointer to a device-specific data structure, depending upon
the given
.Fa request .
-.\" $OpenBSD: ptrace.2,v 1.42 2022/03/31 17:27:16 naddy Exp $
+.\" $OpenBSD: ptrace.2,v 1.43 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: ptrace.2,v 1.3 1996/02/23 01:39:41 jtc Exp $
.\"
.\" This file is in the public domain.
-.Dd $Mdocdate: March 31 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt PTRACE 2
.Os
.Sh NAME
be ignored.
.It Dv PT_READ_I , Dv PT_READ_D
These requests read a single
-.Li int
+.Vt int
of data from the traced process' address space.
Traditionally,
.Fn ptrace
This request reads the traced process'
.Sq window cookie
into the
-.Li int
+.Vt int
pointed to by
.Fa addr .
The window cookie needs to be
-.\" $OpenBSD: quotactl.2,v 1.15 2015/01/19 15:54:11 millert Exp $
+.\" $OpenBSD: quotactl.2,v 1.16 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: quotactl.2,v 1.8 1995/02/27 12:35:43 cgd Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\"
.\" @(#)quotactl.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: January 19 2015 $
+.Dd $Mdocdate: September 11 2022 $
.Dt QUOTACTL 2
.Os
.Sh NAME
.Fa id .
.Fa addr
is a pointer to a
-.Li struct dqblk
+.Vt struct dqblk
structure.
.It Dv Q_SETQUOTA
Set disk quota limits for the user or group
.Fa id .
.Fa addr
is a pointer to a
-.Li struct dqblk
+.Vt struct dqblk
structure.
The usage fields of
-.Li struct dqblk
+.Vt struct dqblk
structure are ignored.
This call is restricted to the superuser.
.It Dv Q_SETUSE
.Fa id .
.Fa addr
is a pointer to a
-.Li struct dqblk
+.Vt struct dqblk
structure.
Only the usage fields are used.
This call is restricted to the superuser.
-.\" $OpenBSD: tcsetattr.3,v 1.17 2014/01/21 03:15:45 schwarze Exp $
+.\" $OpenBSD: tcsetattr.3,v 1.18 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 1991 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 21 2014 $
+.Dd $Mdocdate: September 11 2022 $
.Dt TCSETATTR 3
.Os
.Sh NAME
and
.Fn tcsetattr
functions are provided for getting and setting the
-.Li termios
+.Vt termios
structure.
.Pp
The
.Fn cfsetspeed
functions are provided for getting and setting the baud rate values in
the
-.Li termios
+.Vt termios
structure.
The effects of the functions on the terminal as described below
do not become effective, nor are all errors detected, until the
.Fn tcsetattr
function is called.
Certain values for baud rates set in the
-.Li termios
+.Vt termios
structure and passed to
.Fn tcsetattr
have special meanings.
function.
.Sh GETTING AND SETTING THE BAUD RATE
The input and output baud rates are found in the
-.Li termios
+.Vt termios
structure.
The unsigned integer
-.Li speed_t
+.Vt speed_t
is typedef'd in the include file
.In termios.h .
On
The
.Fn cfgetispeed
function returns the input baud rate in the
-.Li termios
+.Vt termios
structure referenced by
.Fa tp .
.Pp
The
.Fn cfsetispeed
function sets the input baud rate in the
-.Li termios
+.Vt termios
structure referenced by
.Fa tp
to
The
.Fn cfgetospeed
function returns the output baud rate in the
-.Li termios
+.Vt termios
structure referenced by
.Fa tp .
.Pp
The
.Fn cfsetospeed
function sets the output baud rate in the
-.Li termios
+.Vt termios
structure referenced by
.Fa tp
to
The
.Fn cfsetspeed
function sets both the input and output baud rate in the
-.Li termios
+.Vt termios
structure referenced by
.Fa tp
to
The
.Fn cfmakeraw
function sets the flags stored in the
-.Li termios
+.Vt termios
structure to a state disabling
all input and output processing, giving a
.Dq raw I/O path .
by
.Fa fd
in the
-.Li termios
+.Vt termios
structure referenced by
.Fa tp .
This function is allowed from a background process, although the terminal
The
.Fn tcsetattr
function sets the parameters associated with the terminal from the
-.Li termios
+.Vt termios
structure referenced by
.Fa tp .
The
.Fn tcsetattr
function was not valid, or an attempt was made to change an attribute
represented in the
-.Li termios
+.Vt termios
structure to an unsupported value.
.It Bq Er ENOTTY
The file associated with the
-.\" $OpenBSD: ctime.3,v 1.46 2020/04/30 18:36:12 schwarze Exp $
+.\" $OpenBSD: ctime.3,v 1.47 2022/09/11 06:38:11 jmc Exp $
.\"
.\"
-.Dd $Mdocdate: April 30 2020 $
+.Dd $Mdocdate: September 11 2022 $
.Dt CTIME 3
.Os
.Sh NAME
The
.Fn ctime
function converts a
-.Li time_t ,
+.Vt time_t ,
pointed to by
.Fa clock ,
representing the time in seconds since
and
.Fn gmtime
functions return pointers to
-.Li tm
+.Vt tm
structures, described below.
.Fn localtime
corrects for the time zone and any time zone adjustments
(such as Daylight Saving Time in the United States).
After filling in the
-.Li tm
+.Vt tm
structure,
.Fn localtime
sets the
.Pp
.Fn asctime
converts a time value contained in a
-.Li tm
+.Vt tm
structure to a string,
as shown in the above example,
and returns a pointer to the string.
expressed in seconds.
.Pp
Declarations of all the functions and externals, and the
-.Li tm
+.Vt tm
structure, are in the
.In time.h
header file.
The structure (of type)
-.Li struct tm
+.Vt struct tm
includes the following fields:
.Bd -literal -offset indent
int tm_sec; /* seconds (0 \- 60) */
The
.Fa tm_zone
field of a returned
-.Li struct tm
+.Vt struct tm
points to a static array of characters, which
will also be overwritten at the next call
(and by calls to
-.\" $OpenBSD: radius_new_request_packet.3,v 1.5 2016/08/05 08:10:51 jmc Exp $
+.\" $OpenBSD: radius_new_request_packet.3,v 1.6 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 2009 Internet Initiative Japan Inc.
.\" All rights reserved.
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd $Mdocdate: August 5 2016 $
+.Dd $Mdocdate: September 11 2022 $
.Dt RADIUS_NEW_REQUEST_PACKET 3
.Os
.Sh NAME
To make code simple, there are many typed attribute accessors.
.Nm radius
provides typed accessors for
-.Li uint16_t ,
-.Li uint32_t ,
-.Li uint64_t ,
-.Li struct in_addr
+.Vt uint16_t ,
+.Vt uint32_t ,
+.Vt uint64_t ,
+.Vt struct in_addr
and
-.Li struct in6_addr .
+.Vt struct in6_addr .
Byte endian may be appropriately swapped for
-.Li uint16_t ,
-.Li uint32_t
+.Vt uint16_t ,
+.Vt uint32_t
and
-.Li uint64_t .
+.Vt uint64_t .
.Pp
These typed accessors do not requires
.Fa length
-.\" $OpenBSD: bit_alloc.3,v 1.2 2022/08/04 06:20:24 jsg Exp $
+.\" $OpenBSD: bit_alloc.3,v 1.3 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: bitstring.3,v 1.4 1994/11/30 15:24:31 jtc Exp $
.\"
.\" Copyright (c) 1989, 1991, 1993
.\"
.\" @(#)bitstring.3 8.1 (Berkeley) 7/19/93
.\"
-.Dd $Mdocdate: August 4 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt BIT_ALLOC 3
.Os
.Sh NAME
The
.Fn bit_alloc
macro returns a pointer of type
-.Li "bitstr_t *"
+.Vt bitstr_t *
to sufficient space to store
.Fa nbits
bits, or
The
.Fn bitstr_size
macro returns the number of elements of type
-.Li bitstr_t
+.Vt bitstr_t
necessary to store
.Fa nbits
bits.
-.\" $OpenBSD: dl_iterate_phdr.3,v 1.5 2018/08/24 13:14:14 edd Exp $
+.\" $OpenBSD: dl_iterate_phdr.3,v 1.6 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 2005 Mark Kettenis
.\"
.\" 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 24 2018 $
+.Dd $Mdocdate: September 11 2022 $
.Dt DL_ITERATE_PHDR 3
.Os
.Sh NAME
.Ed
.Pp
The members of
-.Li struct dl_phdr_info
+.Vt struct dl_phdr_info
have the following meaning:
.Bl -tag -width XXXdlpi_phdr
.It Fa dlpi_addr
-.\" $OpenBSD: bpf.4,v 1.43 2020/09/30 19:25:40 tb Exp $
+.\" $OpenBSD: bpf.4,v 1.44 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: bpf.4,v 1.7 1995/09/27 18:31:50 thorpej Exp $
.\"
.\" Copyright (c) 1990 The Regents of the University of California.
.\" This document is derived in part from the enet man page (enet.4)
.\" distributed with 4.3BSD Unix.
.\"
-.Dd $Mdocdate: September 30 2020 $
+.Dd $Mdocdate: September 11 2022 $
.Dt BPF 4
.Os
.Sh NAME
The name is returned in the
.Fa ifr_name
field of the
-.Li struct ifreq .
+.Vt struct ifreq .
All other fields are undefined.
.Pp
.It Dv BIOCSETIF Fa "struct ifreq *"
The device is indicated by name using the
.Fa ifr_name
field of the
-.Li struct ifreq .
+.Vt struct ifreq .
Additionally, performs the actions of
.Dv BIOCFLUSH .
.Pp
The filter program is pointed to by the
.Fa bf_insns
field, while its length in units of
-.Li struct bpf_insn
+.Vt struct bpf_insn
is given by the
.Fa bf_len
field.
Suitable precautions must be taken when accessing the link layer protocol
fields on alignment restricted machines.
(This isn't a problem on an Ethernet, since the type field is a
-.Li short
+.Vt short
falling on an even offset, and the addresses are probably accessed in a
bytewise fashion).
.Pp
-.\" $OpenBSD: ddb.4,v 1.103 2022/07/29 17:47:11 semarie Exp $
+.\" $OpenBSD: ddb.4,v 1.104 2022/09/11 06:38:11 jmc 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: July 29 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt DDB 4
.Os
.Sh NAME
.Ar addr
.Xc
Prints the
-.Li struct buf
+.Vt struct buf
at
.Ar addr .
If the
.\" --------------------
.It Ic show mbuf Ar addr
Prints the
-.Li struct mbuf
+.Vt struct mbuf
header at
.Ar addr .
Depending on the mbuf flags
-.Li struct pkthdr
+.Vt struct pkthdr
and
-.Li struct m_ext
+.Vt struct m_ext
are printed as well.
.\" --------------------
.It Xo
.Ar addr
.Xc
Prints the
-.Li struct mount
+.Vt struct mount
at
.Ar addr .
If the
.Ar addr
.Xc
Prints the
-.Li struct nfsnode
+.Vt struct nfsnode
at
.Ar addr .
If the
.Ar addr
.Xc
Prints the
-.Li struct nfsreq
+.Vt struct nfsreq
at
.Ar addr .
If the
.\" --------------------
.It Ic show proc Op Ar addr
Prints the
-.Li struct proc
+.Vt struct proc
at
.Ar addr .
If an optional address is not specified,
.\" --------------------
.It Ic show route Ar addr
Prints the
-.Li struct rtentry
+.Vt struct rtentry
at
.Ar addr .
.\" --------------------
.It Ic show socket Ar addr
Prints the
-.Li struct socket
+.Vt struct socket
at
.Ar addr .
If the socket is spliced, the
-.Li struct sosplice
+.Vt struct sosplice
associated with the socket is printed as well.
.\" --------------------
.It Xo
.Ar addr
.Xc
Prints the
-.Li struct tdb
+.Vt struct tdb
at
.Ar addr .
If the
.Ar addr
.Xc
Prints the
-.Li struct vnode
+.Vt struct vnode
at
.Ar addr .
If the
-.\" $OpenBSD: openprom.4,v 1.1 2019/04/25 16:47:56 denis Exp $
+.\" $OpenBSD: openprom.4,v 1.2 2022/09/11 06:38:11 jmc Exp $
.\" Copyright (c) 1992, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\"
.\" from: @(#)openprom.4 8.1 (Berkeley) 6/5/93
.\"
-.Dd $Mdocdate: April 25 2019 $
+.Dd $Mdocdate: September 11 2022 $
.Dt OPENPROM 4
.Os
.Sh NAME
.Pp
The calls that take and/or return a node
use a pointer to an
-.Li int
+.Vt int
variable for this purpose;
others use a pointer to a
-.Li struct opiocdesc
+.Vt struct opiocdesc
descriptor,
which contains a node and two counted strings.
The first string is comprised of the fields
.Li op_namelen
(an
-.Li int )
+.Vt int )
and
.Li op_name
(a
-.Li "char *" ) ,
+.Vt char * ) ,
giving the name of a field.
The second string is comprised of the fields
.Li op_buflen
-.\" $OpenBSD: options.4,v 1.268 2022/03/01 14:39:30 krw Exp $
+.\" $OpenBSD: options.4,v 1.269 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: options.4,v 1.21 1997/06/25 03:13:00 thorpej Exp $
.\"
.\" Copyright (c) 1998 Theo de Raadt
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\"
-.Dd $Mdocdate: March 1 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt OPTIONS 4
.Os
.Sh NAME
like the "behavior on errors" are not implemented.
This file system
can't be used with
-.Li uid_t
+.Vt uid_t
or
-.Li gid_t
+.Vt gid_t
values greater than 65535.
Also, the filesystem will not function correctly on architectures with
differing byte-orders.
-.\" $OpenBSD: speaker.4,v 1.10 2020/07/05 07:54:37 jmc Exp $
+.\" $OpenBSD: speaker.4,v 1.11 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: speaker.4,v 1.9 1998/08/18 08:16:56 augustss Exp $
.\"
.\" Copyright (c) 1993 Christopher G. Demetriou
.\" (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 5 2020 $
+.Dd $Mdocdate: September 11 2022 $
.Dt SPKR 4
.Os
.Sh NAME
interface are in
.In dev/isa/spkrio.h .
The
-.Li tone_t
+.Vt tone_t
structure used in these calls has two fields,
specifying a frequency (in Hz) and a duration (in 1/100ths of a second).
A frequency of zero is interpreted as a rest.
-.\" $OpenBSD: ranlib.5,v 1.2 2015/09/10 17:55:21 schwarze Exp $
+.\" $OpenBSD: ranlib.5,v 1.3 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" from: @(#)ranlib.5.5 5.2 (Berkeley) 5/10/91
.\"
-.Dd $Mdocdate: September 10 2015 $
+.Dd $Mdocdate: September 11 2022 $
.Dt RANLIB 5
.Os
.Sh NAME
.Dq __.SYMDEF .
.Pp
The second part is a
-.Li long
+.Vt long
followed by a list of ranlib structures.
The long is the size, in bytes, of the list of ranlib structures.
Each of the ranlib structures consists of a zero based offset into the
of an individual ranlib structure.
.Pp
The third part is a
-.Li long
+.Vt long
followed by a string table.
The long is the size, in bytes, of the string table.
.Sh SEE ALSO
-.\" $OpenBSD: crash.8,v 1.36 2022/03/31 17:27:23 naddy Exp $
+.\" $OpenBSD: crash.8,v 1.37 2022/09/11 06:38:11 jmc 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: March 31 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt CRASH 8
.Os
.Sh NAME
The
.Fl O Ar paddr
option prints each process'
-.Li struct proc
+.Vt struct proc
address.
This is very useful information if you are analyzing process contexts in
.Xr gdb 1 .
.Pp
It is possible to inspect processes that entered the kernel by
specifying a process'
-.Li struct proc
+.Vt struct proc
address to the
.Ic kvm proc
command:
-.\" $OpenBSD: printf.9,v 1.25 2021/04/04 15:25:11 kn Exp $
+.\" $OpenBSD: printf.9,v 1.26 2022/09/11 06:38:11 jmc Exp $
.\" $NetBSD: kprintf.9,v 1.6 1999/03/16 00:40:47 garbled 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 4 2021 $
+.Dd $Mdocdate: September 11 2022 $
.Dt PRINTF 9
.Os
.Sh NAME
.Bl -tag -width 5n
.It Li %hh
Argument of
-.Li char
+.Vt char
type.
This format specifier is accepted by the kernel but will be handled as
.Li %h .
.It Li %j
Argument of
-.Li intmax_t
+.Vt intmax_t
or
-.Li uintmax_t
+.Vt uintmax_t
type.
.It Li %t
Argument of
-.Li ptrdiff_t
+.Vt ptrdiff_t
type.
.El
.Pp
It requires two arguments from the argument vector, the first argument being
the bit field to be decoded
(of type
-.Li int ,
+.Vt int ,
unless a width modifier has been specified)
and the second being a decoding directive string.
.Pp
-.\" $OpenBSD: socreate.9,v 1.10 2018/07/30 12:22:14 mpi Exp $
+.\" $OpenBSD: socreate.9,v 1.11 2022/09/11 06:38:11 jmc Exp $
.\"
.\" Copyright (c) 2006 Robert N. M. Watson
.\" All rights reserved.
.\"
.\" $FreeBSD: src/share/man/man9/socket.9,v 1.2 2006/12/16 10:32:10 rwatson Exp $
.\"
-.Dd $Mdocdate: July 30 2018 $
+.Dd $Mdocdate: September 11 2022 $
.Dt SOCREATE 9
.Os
.Sh NAME
other network-aware kernel services.
While the user API operates on file descriptors, the kernel interfaces
operate directly on
-.Vt "struct socket"
+.Vt struct socket
pointers.
.Pp
Except where otherwise indicated,
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: style.9,v 1.78 2022/03/31 17:27:23 naddy Exp $
+.\" $OpenBSD: style.9,v 1.79 2022/09/11 06:38:11 jmc Exp $
.\"
-.Dd $Mdocdate: March 31 2022 $
+.Dd $Mdocdate: September 11 2022 $
.Dt STYLE 9
.Os
.Sh NAME
.Ed
.Pp
Routines returning
-.Li void *
+.Vt void *
should not have their return values cast to any pointer type.
.Pp
Use the
.\" (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.320 2022/08/11 01:56:51 djm Exp $
-.Dd $Mdocdate: August 11 2022 $
+.\" $OpenBSD: sshd.8,v 1.321 2022/09/11 06:38:11 jmc Exp $
+.Dd $Mdocdate: September 11 2022 $
.Dt SSHD 8
.Os
.Sh NAME
.It Fl u Ar len
This option is used to specify the size of the field
in the
-.Li utmp
+.Vt utmp
structure that holds the remote host name.
If the resolved host name is longer than
.Ar len ,
-.\" $OpenBSD: zdump.8,v 1.2 2020/01/16 16:46:47 schwarze Exp $
-.Dd $Mdocdate: January 16 2020 $
+.\" $OpenBSD: zdump.8,v 1.3 2022/09/11 06:38:12 jmc Exp $
+.Dd $Mdocdate: September 11 2022 $
.Dt ZDUMP 8
.Os
.Sh NAME
The
.Fl v
option may not be used on systems with floating-point
-.Li time_t
+.Vt time_t
values that are neither float nor double.
.Pp
Time discontinuities are found by sampling the results returned by localtime
projects / openbsd / commitdiff