mirror of
https://gitlab.freedesktop.org/libbsd/libbsd.git
synced 2025-08-24 17:35:21 +02:00
Compare commits
201 Commits
Author | SHA1 | Date | |
---|---|---|---|
![]() |
22fddb16f8 | ||
![]() |
abe3c8c332 | ||
![]() |
1d711a2ced | ||
![]() |
aff40cae08 | ||
![]() |
04a24db27a | ||
![]() |
b62f36f305 | ||
![]() |
2a3d521318 | ||
![]() |
149aafe198 | ||
![]() |
435825784f | ||
![]() |
31e9396bf2 | ||
![]() |
3b8416acab | ||
![]() |
94d0fb3c53 | ||
![]() |
e848f5aa29 | ||
![]() |
ee63bca525 | ||
![]() |
9cbd935d92 | ||
![]() |
70f49a7028 | ||
![]() |
b6ccd03201 | ||
![]() |
08188f3c13 | ||
![]() |
644062da40 | ||
![]() |
32d18dcf47 | ||
![]() |
605614d642 | ||
![]() |
ec7f5ee984 | ||
![]() |
5392f0c1a4 | ||
![]() |
be4aced4c5 | ||
![]() |
27503a1066 | ||
![]() |
99739877be | ||
![]() |
0bdbc0787e | ||
![]() |
de124dcafa | ||
![]() |
1d28729514 | ||
![]() |
a81d0b7113 | ||
![]() |
c8e5338a7c | ||
![]() |
b6d6da4cd4 | ||
![]() |
f8cb9d8b28 | ||
![]() |
154624ab45 | ||
![]() |
9fab225f26 | ||
![]() |
461f10ac57 | ||
![]() |
f050160976 | ||
![]() |
19e06407eb | ||
![]() |
10920c3084 | ||
![]() |
97b0fe84b8 | ||
![]() |
e87ae3be19 | ||
![]() |
9275d134e5 | ||
![]() |
304a1f831c | ||
![]() |
edddd806df | ||
![]() |
dd0bdb58e0 | ||
![]() |
0813f3786f | ||
![]() |
df116b5597 | ||
![]() |
ecb44e1655 | ||
![]() |
459b7f7d24 | ||
![]() |
a44f885cd4 | ||
![]() |
3f5ca0aae4 | ||
![]() |
9d3e59a01d | ||
![]() |
f02562d64a | ||
![]() |
b7367c9ced | ||
![]() |
6777eb62b8 | ||
![]() |
d4e0cdc916 | ||
![]() |
f41d6c12aa | ||
![]() |
30b48ed9ea | ||
![]() |
d0d8d0197f | ||
![]() |
cf61ebb845 | ||
![]() |
73b25a8f87 | ||
![]() |
5434ba169b | ||
![]() |
dc1bd1a2cb | ||
![]() |
edc746ea7b | ||
![]() |
8f998d1d20 | ||
![]() |
d08163b4fe | ||
![]() |
1186cf8822 | ||
![]() |
6385ccc977 | ||
![]() |
c12068179c | ||
![]() |
9fa06763a1 | ||
![]() |
92337b15a2 | ||
![]() |
90b7f3aeba | ||
![]() |
426bf45278 | ||
![]() |
21d12b0211 | ||
![]() |
bc65806ce2 | ||
![]() |
8b7a4d9d3b | ||
![]() |
ccbfd1c241 | ||
![]() |
e0976d7e90 | ||
![]() |
49c7dd1ca4 | ||
![]() |
8622767a8a | ||
![]() |
8f61036467 | ||
![]() |
ae7942ba6d | ||
![]() |
a5faf17090 | ||
![]() |
06e8a1b29b | ||
![]() |
44824aca3c | ||
![]() |
1fb6c3f4ce | ||
![]() |
fe16f3863e | ||
![]() |
7c652a94ea | ||
![]() |
ed2eb31da9 | ||
![]() |
0f8bcdfd92 | ||
![]() |
07192b31e3 | ||
![]() |
ca3db5e134 | ||
![]() |
ff46386fcb | ||
![]() |
4c6da577a1 | ||
![]() |
830dd88a98 | ||
![]() |
257800a03c | ||
![]() |
536a7d42fd | ||
![]() |
7ed5de0158 | ||
![]() |
05a802a2c1 | ||
![]() |
5962e03c2d | ||
![]() |
59a21c7fb8 | ||
![]() |
7b4ebd6521 | ||
![]() |
0dfbe7699e | ||
![]() |
dec783dce5 | ||
![]() |
fe21244b05 | ||
![]() |
ec88b7bbbc | ||
![]() |
23377191e8 | ||
![]() |
5dea9da38d | ||
![]() |
b9bf42ddc3 | ||
![]() |
e57c07875c | ||
![]() |
80f1927dcd | ||
![]() |
b7a8bc22c9 | ||
![]() |
e50896286c | ||
![]() |
00b538ffa3 | ||
![]() |
5cfa39e5cd | ||
![]() |
084911ce87 | ||
![]() |
3538d38fe7 | ||
![]() |
03fccd1505 | ||
![]() |
6b6e686b23 | ||
![]() |
da1f45ac71 | ||
![]() |
2f9eddc277 | ||
![]() |
28298ac037 | ||
![]() |
ef981f930b | ||
![]() |
6928d7895e | ||
![]() |
d5865759f8 | ||
![]() |
be327c6ebe | ||
![]() |
a14612d968 | ||
![]() |
f4baceb82c | ||
![]() |
f35c545847 | ||
![]() |
b466b14afb | ||
![]() |
1f6a48b209 | ||
![]() |
873639ebb5 | ||
![]() |
c9c78fdfd0 | ||
![]() |
5f21307570 | ||
![]() |
84acf21568 | ||
![]() |
15200ec7ac | ||
![]() |
f7465b93ec | ||
![]() |
e5ed5fdd62 | ||
![]() |
abb1a6b1a7 | ||
![]() |
c9ff83687c | ||
![]() |
62e67bb49e | ||
![]() |
87b1307040 | ||
![]() |
ba3c46b30f | ||
![]() |
091097e062 | ||
![]() |
5f9608c775 | ||
![]() |
eef07993c9 | ||
![]() |
c6d589bc71 | ||
![]() |
2975d809a0 | ||
![]() |
f11ab67223 | ||
![]() |
54796231c7 | ||
![]() |
7aed0edf73 | ||
![]() |
fafcc397ac | ||
![]() |
48107fc8c4 | ||
![]() |
e7cf8c5785 | ||
![]() |
25d35625eb | ||
![]() |
500b3080a2 | ||
![]() |
1eba406021 | ||
![]() |
8ad7570c20 | ||
![]() |
43a8270317 | ||
![]() |
6a71b24b63 | ||
![]() |
7389fe8d24 | ||
![]() |
2716dfd0b7 | ||
![]() |
54f8745657 | ||
![]() |
428be9e030 | ||
![]() |
c7a5d780ae | ||
![]() |
1808d64b77 | ||
![]() |
beafad2657 | ||
![]() |
6145b56178 | ||
![]() |
731b0a7739 | ||
![]() |
50b50a4330 | ||
![]() |
25e88f6479 | ||
![]() |
04a8fb2469 | ||
![]() |
4f68a88f55 | ||
![]() |
8f59221c4f | ||
![]() |
72a82ee262 | ||
![]() |
3c305f2873 | ||
![]() |
25278891d8 | ||
![]() |
e35d9141dc | ||
![]() |
4feda87049 | ||
![]() |
d563a17430 | ||
![]() |
785cf9d1e9 | ||
![]() |
15bd284b29 | ||
![]() |
a9fc285988 | ||
![]() |
c0d86a6412 | ||
![]() |
1fb25b7dca | ||
![]() |
31f034e386 | ||
![]() |
2374f409de | ||
![]() |
a4e0db2b97 | ||
![]() |
43d34c9d3b | ||
![]() |
1c3ff61699 | ||
![]() |
edea268ce9 | ||
![]() |
e832b7687e | ||
![]() |
c4fca5bb4f | ||
![]() |
a1f79978e8 | ||
![]() |
4676026286 | ||
![]() |
25f9b30678 | ||
![]() |
18ebabf223 | ||
![]() |
4ab11c7f48 | ||
![]() |
766c883e30 | ||
![]() |
a4de4d95a6 | ||
![]() |
233cab9d64 |
7
.gitignore
vendored
7
.gitignore
vendored
@ -1,4 +1,5 @@
|
|||||||
ChangeLog
|
ChangeLog
|
||||||
|
*~
|
||||||
*.pc
|
*.pc
|
||||||
*.la
|
*.la
|
||||||
*.lo
|
*.lo
|
||||||
@ -7,6 +8,10 @@ ChangeLog
|
|||||||
*.a
|
*.a
|
||||||
*.log
|
*.log
|
||||||
*.trs
|
*.trs
|
||||||
|
*.gcda
|
||||||
|
*.gcno
|
||||||
|
*.sym
|
||||||
|
*.map
|
||||||
.dirstamp
|
.dirstamp
|
||||||
.deps/
|
.deps/
|
||||||
.libs/
|
.libs/
|
||||||
@ -17,6 +22,6 @@ autom4te.cache/
|
|||||||
build-aux/
|
build-aux/
|
||||||
configure
|
configure
|
||||||
config.*
|
config.*
|
||||||
|
format.ld
|
||||||
libtool
|
libtool
|
||||||
m4/
|
|
||||||
stamp-h1
|
stamp-h1
|
||||||
|
@ -1,9 +1,54 @@
|
|||||||
image: debian:stretch
|
.vpath-tests:
|
||||||
|
script:
|
||||||
|
- ./autogen
|
||||||
|
- mkdir -p build-tree
|
||||||
|
- cd build-tree
|
||||||
|
- ../configure
|
||||||
|
- make check
|
||||||
|
|
||||||
test:
|
.unit-tests:
|
||||||
before_script:
|
|
||||||
- apt update -qq
|
|
||||||
- apt install -qq -y --no-install-recommends git gcc make autoconf automake libtool
|
|
||||||
script:
|
script:
|
||||||
- ./autogen && ./configure
|
- ./autogen && ./configure
|
||||||
- make check
|
- make check
|
||||||
|
|
||||||
|
.unit-tests-asan:
|
||||||
|
script:
|
||||||
|
- ./autogen && ./configure --enable-sanitize
|
||||||
|
- make check
|
||||||
|
|
||||||
|
.coverage:
|
||||||
|
script:
|
||||||
|
- ./autogen && ./configure --disable-static
|
||||||
|
- make check CFLAGS="--coverage -O0 -ggdb" LDFLAGS="--coverage -O0 -ggdb"
|
||||||
|
- gcovr -s -e test/
|
||||||
|
coverage: /^TOTAL.*\s+(\d+\%)$/
|
||||||
|
|
||||||
|
.debian:
|
||||||
|
image: debian:latest
|
||||||
|
stage: test
|
||||||
|
before_script:
|
||||||
|
- apt-get update -qq
|
||||||
|
- apt-get install -qq -y --no-install-recommends
|
||||||
|
git gcc make autoconf automake libtool libmd-dev gcovr
|
||||||
|
|
||||||
|
.alpine:
|
||||||
|
image: alpine:latest
|
||||||
|
stage: test
|
||||||
|
before_script:
|
||||||
|
- apk add --no-cache git gcc make autoconf automake libtool
|
||||||
|
bsd-compat-headers linux-headers libmd-dev musl-dev gcovr
|
||||||
|
|
||||||
|
vpath-tests:debian:
|
||||||
|
extends: [.debian, .vpath-tests]
|
||||||
|
|
||||||
|
unit-tests:debian:
|
||||||
|
extends: [.debian, .unit-tests-asan]
|
||||||
|
|
||||||
|
coverage:debian:
|
||||||
|
extends: [.debian, .coverage]
|
||||||
|
|
||||||
|
unit-tests:alpine:
|
||||||
|
extends: [.alpine, .unit-tests]
|
||||||
|
|
||||||
|
coverage:alpine:
|
||||||
|
extends: [.alpine, .coverage]
|
||||||
|
83
COPYING
83
COPYING
@ -3,74 +3,9 @@ Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
|
|||||||
Files:
|
Files:
|
||||||
*
|
*
|
||||||
Copyright:
|
Copyright:
|
||||||
Copyright © 2004-2006, 2008-2021 Guillem Jover <guillem@hadrons.org>
|
Copyright © 2004-2024 Guillem Jover <guillem@hadrons.org>
|
||||||
License: BSD-3-clause
|
License: BSD-3-clause
|
||||||
|
|
||||||
Files:
|
|
||||||
man/arc4random.3bsd
|
|
||||||
man/tree.3bsd
|
|
||||||
Copyright:
|
|
||||||
Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de>
|
|
||||||
All rights reserved.
|
|
||||||
License: BSD-4-clause-Niels-Provos
|
|
||||||
Redistribution and use in source and binary forms, with or without
|
|
||||||
modification, are permitted provided that the following conditions
|
|
||||||
are met:
|
|
||||||
1. Redistributions of source code must retain the above copyright
|
|
||||||
notice, this list of conditions and the following disclaimer.
|
|
||||||
2. Redistributions in binary form must reproduce the above copyright
|
|
||||||
notice, this list of conditions and the following disclaimer in the
|
|
||||||
documentation and/or other materials provided with the distribution.
|
|
||||||
3. All advertising materials mentioning features or use of this software
|
|
||||||
must display the following acknowledgement:
|
|
||||||
This product includes software developed by Niels Provos.
|
|
||||||
4. The name of the author may not be used to endorse or promote products
|
|
||||||
derived from this software without specific prior written permission.
|
|
||||||
.
|
|
||||||
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
||||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
||||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
||||||
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
||||||
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
||||||
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
||||||
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
||||||
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
||||||
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
|
|
||||||
Files:
|
|
||||||
man/getprogname.3bsd
|
|
||||||
Copyright:
|
|
||||||
Copyright © 2001 Christopher G. Demetriou
|
|
||||||
All rights reserved.
|
|
||||||
License: BSD-4-clause-Christopher-G-Demetriou
|
|
||||||
Redistribution and use in source and binary forms, with or without
|
|
||||||
modification, are permitted provided that the following conditions
|
|
||||||
are met:
|
|
||||||
1. Redistributions of source code must retain the above copyright
|
|
||||||
notice, this list of conditions and the following disclaimer.
|
|
||||||
2. Redistributions in binary form must reproduce the above copyright
|
|
||||||
notice, this list of conditions and the following disclaimer in the
|
|
||||||
documentation and/or other materials provided with the distribution.
|
|
||||||
3. All advertising materials mentioning features or use of this software
|
|
||||||
must display the following acknowledgement:
|
|
||||||
This product includes software developed for the
|
|
||||||
NetBSD Project. See http://www.netbsd.org/ for
|
|
||||||
information about NetBSD.
|
|
||||||
4. The name of the author may not be used to endorse or promote products
|
|
||||||
derived from this software without specific prior written permission.
|
|
||||||
.
|
|
||||||
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
||||||
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
||||||
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
||||||
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
||||||
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
||||||
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
||||||
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
||||||
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
||||||
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
|
|
||||||
Files:
|
Files:
|
||||||
include/bsd/err.h
|
include/bsd/err.h
|
||||||
include/bsd/stdlib.h
|
include/bsd/stdlib.h
|
||||||
@ -236,6 +171,7 @@ License: BSD-5-clause-Peter-Wemm
|
|||||||
|
|
||||||
Files:
|
Files:
|
||||||
include/bsd/stringlist.h
|
include/bsd/stringlist.h
|
||||||
|
man/arc4random.3bsd
|
||||||
man/fmtcheck.3bsd
|
man/fmtcheck.3bsd
|
||||||
man/humanize_number.3bsd
|
man/humanize_number.3bsd
|
||||||
man/stringlist.3bsd
|
man/stringlist.3bsd
|
||||||
@ -250,6 +186,12 @@ Copyright:
|
|||||||
Copyright © 2013 John-Mark Gurney <jmg@FreeBSD.org>
|
Copyright © 2013 John-Mark Gurney <jmg@FreeBSD.org>
|
||||||
All rights reserved.
|
All rights reserved.
|
||||||
.
|
.
|
||||||
|
Copyright © 2014 The NetBSD Foundation, Inc.
|
||||||
|
All rights reserved.
|
||||||
|
.
|
||||||
|
Some code was derived from software contributed to The NetBSD Foundation
|
||||||
|
by Taylor R. Campbell.
|
||||||
|
.
|
||||||
Some code was contributed to The NetBSD Foundation by Allen Briggs.
|
Some code was contributed to The NetBSD Foundation by Allen Briggs.
|
||||||
.
|
.
|
||||||
Some code was contributed to The NetBSD Foundation by Luke Mewburn.
|
Some code was contributed to The NetBSD Foundation by Luke Mewburn.
|
||||||
@ -311,7 +253,6 @@ Copyright:
|
|||||||
All rights reserved.
|
All rights reserved.
|
||||||
.
|
.
|
||||||
Copyright © 2009 Advanced Computing Technologies LLC
|
Copyright © 2009 Advanced Computing Technologies LLC
|
||||||
Written by: John H. Baldwin <jhb@FreeBSD.org>
|
|
||||||
All rights reserved.
|
All rights reserved.
|
||||||
.
|
.
|
||||||
Copyright © 2011 Guillem Jover <guillem@hadrons.org>
|
Copyright © 2011 Guillem Jover <guillem@hadrons.org>
|
||||||
@ -348,6 +289,7 @@ License: BSD-2-clause-verbatim
|
|||||||
Files:
|
Files:
|
||||||
include/bsd/sys/tree.h
|
include/bsd/sys/tree.h
|
||||||
man/fparseln.3bsd
|
man/fparseln.3bsd
|
||||||
|
man/tree.3bsd
|
||||||
src/fparseln.c
|
src/fparseln.c
|
||||||
Copyright:
|
Copyright:
|
||||||
Copyright © 1997 Christos Zoulas.
|
Copyright © 1997 Christos Zoulas.
|
||||||
@ -364,7 +306,6 @@ Files:
|
|||||||
man/strtonum.3bsd
|
man/strtonum.3bsd
|
||||||
src/arc4random.c
|
src/arc4random.c
|
||||||
src/arc4random_linux.h
|
src/arc4random_linux.h
|
||||||
src/arc4random_openbsd.h
|
|
||||||
src/arc4random_uniform.c
|
src/arc4random_uniform.c
|
||||||
src/arc4random_unix.h
|
src/arc4random_unix.h
|
||||||
src/arc4random_win.h
|
src/arc4random_win.h
|
||||||
@ -383,6 +324,8 @@ Files:
|
|||||||
src/recallocarray.c
|
src/recallocarray.c
|
||||||
src/strlcat.c
|
src/strlcat.c
|
||||||
src/strlcpy.c
|
src/strlcpy.c
|
||||||
|
test/explicit_bzero.c
|
||||||
|
test/strtonum.c
|
||||||
Copyright:
|
Copyright:
|
||||||
Copyright © 2004 Ted Unangst and Todd Miller
|
Copyright © 2004 Ted Unangst and Todd Miller
|
||||||
All rights reserved.
|
All rights reserved.
|
||||||
@ -391,6 +334,7 @@ Copyright:
|
|||||||
Copyright © 1998, 2000-2002, 2004-2005, 2007, 2010, 2012-2015
|
Copyright © 1998, 2000-2002, 2004-2005, 2007, 2010, 2012-2015
|
||||||
Todd C. Miller <Todd.Miller@courtesan.com>
|
Todd C. Miller <Todd.Miller@courtesan.com>
|
||||||
Copyright © 2004 Ted Unangst
|
Copyright © 2004 Ted Unangst
|
||||||
|
Copyright © 2004 Otto Moerbeek <otto@drijf.net>
|
||||||
Copyright © 2008 Damien Miller <djm@openbsd.org>
|
Copyright © 2008 Damien Miller <djm@openbsd.org>
|
||||||
Copyright © 2008, 2010-2011, 2016-2017 Otto Moerbeek <otto@drijf.net>
|
Copyright © 2008, 2010-2011, 2016-2017 Otto Moerbeek <otto@drijf.net>
|
||||||
Copyright © 2013 Markus Friedl <markus@openbsd.org>
|
Copyright © 2013 Markus Friedl <markus@openbsd.org>
|
||||||
@ -398,8 +342,9 @@ Copyright:
|
|||||||
Copyright © 2014 Brent Cook <bcook@openbsd.org>
|
Copyright © 2014 Brent Cook <bcook@openbsd.org>
|
||||||
Copyright © 2014 Pawel Jakub Dawidek <pjd@FreeBSD.org>
|
Copyright © 2014 Pawel Jakub Dawidek <pjd@FreeBSD.org>
|
||||||
Copyright © 2014 Theo de Raadt <deraadt@openbsd.org>
|
Copyright © 2014 Theo de Raadt <deraadt@openbsd.org>
|
||||||
|
Copyright © 2014 Google Inc.
|
||||||
Copyright © 2015 Michael Felt <aixtools@gmail.com>
|
Copyright © 2015 Michael Felt <aixtools@gmail.com>
|
||||||
Copyright © 2015 Guillem Jover <guillem@hadrons.org>
|
Copyright © 2015, 2022 Guillem Jover <guillem@hadrons.org>
|
||||||
License: ISC
|
License: ISC
|
||||||
Permission to use, copy, modify, and distribute this software for any
|
Permission to use, copy, modify, and distribute this software for any
|
||||||
purpose with or without fee is hereby granted, provided that the above
|
purpose with or without fee is hereby granted, provided that the above
|
||||||
|
@ -1,13 +1,18 @@
|
|||||||
## Process this file with automake to produce Makefile.in
|
## Process this file with automake to produce Makefile.in
|
||||||
|
|
||||||
SUBDIRS = include man src test
|
SUBDIRS = \
|
||||||
|
include \
|
||||||
|
man \
|
||||||
|
src \
|
||||||
|
test \
|
||||||
|
# EOL
|
||||||
|
|
||||||
ACLOCAL_AMFLAGS = -I m4
|
ACLOCAL_AMFLAGS = -I m4
|
||||||
|
|
||||||
EXTRA_DIST = \
|
EXTRA_DIST = \
|
||||||
autogen \
|
autogen \
|
||||||
get-version \
|
get-version \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
dist-hook:
|
dist-hook:
|
||||||
echo $(VERSION) >$(distdir)/.dist-version
|
echo $(VERSION) >$(distdir)/.dist-version
|
||||||
|
41
README
41
README
@ -9,6 +9,7 @@ A BSD compatible message-digest library is required, on systems where
|
|||||||
this is not provided by its libc or libmd libraries, the canonical
|
this is not provided by its libc or libmd libraries, the canonical
|
||||||
implementation to use is <https://www.hadrons.org/software/libmd/>.
|
implementation to use is <https://www.hadrons.org/software/libmd/>.
|
||||||
|
|
||||||
|
|
||||||
Releases
|
Releases
|
||||||
--------
|
--------
|
||||||
|
|
||||||
@ -30,10 +31,44 @@ The mail address is:
|
|||||||
Source Repository
|
Source Repository
|
||||||
-----------------
|
-----------------
|
||||||
|
|
||||||
The master repository can be browsed at:
|
The primary repository can be browsed at:
|
||||||
|
|
||||||
<https://cgit.freedesktop.org/libbsd>
|
<https://gitlab.freedesktop.org/libbsd/libbsd>
|
||||||
|
|
||||||
and cloned from:
|
and cloned from:
|
||||||
|
|
||||||
<https://anongit.freedesktop.org/git/libbsd>
|
<https://gitlab.freedesktop.org/libbsd/libbsd.git>
|
||||||
|
|
||||||
|
|
||||||
|
Building from git source
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
To prepare the libbsd source tree from git before starting the build process
|
||||||
|
some required software needs to be installed:
|
||||||
|
|
||||||
|
GNU autoconf >= 2.67
|
||||||
|
GNU automake >= 1.9
|
||||||
|
GNU libtool >= 2.0
|
||||||
|
|
||||||
|
After installing the needed software, and running the following command on
|
||||||
|
the git tree:
|
||||||
|
|
||||||
|
$ ./autogen
|
||||||
|
|
||||||
|
the source should be roughly equivalent to the distributed tar source.
|
||||||
|
|
||||||
|
|
||||||
|
Building from tar source
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
The minimum software required to configure and build dpkg from a tarball is:
|
||||||
|
|
||||||
|
C89 compiler
|
||||||
|
make
|
||||||
|
|
||||||
|
The following software might be required depending on the system:
|
||||||
|
|
||||||
|
libmd (whenever the libc does not provide the needed digest functions)
|
||||||
|
|
||||||
|
The build process is done by running the usual «./configure; make». To
|
||||||
|
see all available configuration options please run «./configure --help».
|
||||||
|
693
configure.ac
693
configure.ac
@ -6,17 +6,22 @@ AC_CONFIG_SRCDIR([src/strlcpy.c])
|
|||||||
AC_CONFIG_AUX_DIR([build-aux])
|
AC_CONFIG_AUX_DIR([build-aux])
|
||||||
AC_CONFIG_MACRO_DIR([m4])
|
AC_CONFIG_MACRO_DIR([m4])
|
||||||
|
|
||||||
AM_INIT_AUTOMAKE([1.9 foreign nostdinc subdir-objects no-dist-gzip dist-xz])
|
AM_INIT_AUTOMAKE(
|
||||||
|
[1.11]
|
||||||
|
[-Wall]
|
||||||
|
[foreign]
|
||||||
|
[nostdinc]
|
||||||
|
[subdir-objects]
|
||||||
|
[no-dist-gzip dist-xz]
|
||||||
|
)
|
||||||
|
AM_SILENT_RULES([yes])
|
||||||
|
|
||||||
m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])],
|
SOVERSION_MAJOR=0
|
||||||
[AC_SUBST([AM_DEFAULT_VERBOSITY], [1])])
|
SOVERSION_MINOR=12
|
||||||
|
SOVERSION_PATCH=2
|
||||||
|
|
||||||
LIBBSD_ABI_MAJOR=0
|
SOVERSION="$SOVERSION_MAJOR:$SOVERSION_MINOR:$SOVERSION_PATCH"
|
||||||
LIBBSD_ABI_MINOR=11
|
AC_SUBST([SOVERSION])
|
||||||
LIBBSD_ABI_PATCH=0
|
|
||||||
|
|
||||||
LIBBSD_ABI="$LIBBSD_ABI_MAJOR:$LIBBSD_ABI_MINOR:$LIBBSD_ABI_PATCH"
|
|
||||||
AC_SUBST([LIBBSD_ABI])
|
|
||||||
|
|
||||||
# Check and store if we got user supplied variables
|
# Check and store if we got user supplied variables
|
||||||
user_CFLAGS=${CFLAGS-unset}
|
user_CFLAGS=${CFLAGS-unset}
|
||||||
@ -24,81 +29,480 @@ user_CFLAGS=${CFLAGS-unset}
|
|||||||
# Checks for operating system services and capabilities.
|
# Checks for operating system services and capabilities.
|
||||||
AC_USE_SYSTEM_EXTENSIONS
|
AC_USE_SYSTEM_EXTENSIONS
|
||||||
AC_SYS_LARGEFILE
|
AC_SYS_LARGEFILE
|
||||||
|
LIBBSD_SYS_TIME64
|
||||||
|
|
||||||
|
AM_PROG_AR
|
||||||
LT_INIT
|
LT_INIT
|
||||||
|
LIBBSD_LINKER_VERSION_SCRIPT
|
||||||
|
|
||||||
AC_CACHE_CHECK([if ld supports --version-script flag],
|
## Select library ABI to expose.
|
||||||
[libbsd_cv_version_script], [
|
#
|
||||||
echo "{ global: symbol; local: *; };" >conftest.map
|
# The systems have DROP comments for interfaces that could be dropped on
|
||||||
save_LDFLAGS=$LDFLAGS
|
# the next SOVERSION bump.
|
||||||
LDFLAGS="$LDFLAGS -Wl,--version-script=conftest.map"
|
|
||||||
AC_LINK_IFELSE([
|
is_windows=no
|
||||||
AC_LANG_PROGRAM([], [])
|
|
||||||
], [
|
api_time_macros=unknown
|
||||||
libbsd_cv_version_script=yes
|
|
||||||
], [
|
abi_accmode=unknown
|
||||||
libbsd_cv_version_script=no
|
abi_arc4random=unknown
|
||||||
])
|
abi_arc4random_stir=unknown
|
||||||
LDFLAGS="$save_LDFLAGS"
|
abi_asprintf=unknown
|
||||||
rm -f conftest.map
|
abi_bsd_getopt=unknown
|
||||||
]
|
abi_closefrom=unknown
|
||||||
|
abi_err=unknown
|
||||||
|
abi_errc=unknown
|
||||||
|
abi_expand_number=unknown
|
||||||
|
abi_explicit_bzero=unknown
|
||||||
|
abi_fgetln=unknown
|
||||||
|
abi_flopen=unknown
|
||||||
|
abi_fmtcheck=unknown
|
||||||
|
abi_fpurge=unknown
|
||||||
|
abi_freezero=unknown
|
||||||
|
abi_funopen=unknown
|
||||||
|
abi_getbsize=unknown
|
||||||
|
abi_getpeereid=unknown
|
||||||
|
abi_humanize_number=unknown
|
||||||
|
abi_id_from_name=unknown
|
||||||
|
abi_inet_net_pton=unknown
|
||||||
|
abi_md5=unknown
|
||||||
|
abi_name_from_id=unknown
|
||||||
|
abi_nlist=unknown
|
||||||
|
abi_pidfile=unknown
|
||||||
|
abi_proctitle=unknown
|
||||||
|
abi_progname=unknown
|
||||||
|
abi_readpassphrase=unknown
|
||||||
|
abi_reallocarray=unknown
|
||||||
|
abi_reallocf=unknown
|
||||||
|
abi_recallocarray=unknown
|
||||||
|
abi_stringlist=unknown
|
||||||
|
abi_sort=unknown
|
||||||
|
abi_strl=unknown
|
||||||
|
abi_strmode=unknown
|
||||||
|
abi_strnstr=unknown
|
||||||
|
abi_strtonum=unknown
|
||||||
|
abi_strtox=unknown
|
||||||
|
abi_timeconv=unknown
|
||||||
|
abi_vis=unknown
|
||||||
|
abi_wcsl=unknown
|
||||||
|
|
||||||
|
AS_CASE([$host_os],
|
||||||
|
[*-gnu* | gnu*], [
|
||||||
|
api_time_macros=no
|
||||||
|
|
||||||
|
abi_accmode=yes
|
||||||
|
# DROP: On glibc >= 2.36.
|
||||||
|
#abi_arc4random=no
|
||||||
|
abi_arc4random=yes
|
||||||
|
abi_arc4random_stir=yes
|
||||||
|
abi_asprintf=no
|
||||||
|
abi_bsd_getopt=yes
|
||||||
|
# DROP: On glibc >= 2.34.
|
||||||
|
#abi_closefrom=no
|
||||||
|
abi_closefrom=yes
|
||||||
|
abi_err=no
|
||||||
|
abi_errc=yes
|
||||||
|
abi_expand_number=yes
|
||||||
|
# DROP: On glibc >= 2.25.
|
||||||
|
#abi_explicit_bzero=no
|
||||||
|
abi_explicit_bzero=yes
|
||||||
|
abi_fgetln=yes
|
||||||
|
abi_flopen=yes
|
||||||
|
abi_fmtcheck=yes
|
||||||
|
abi_fpurge=yes
|
||||||
|
abi_freezero=yes
|
||||||
|
abi_funopen=yes
|
||||||
|
abi_getbsize=yes
|
||||||
|
abi_getpeereid=yes
|
||||||
|
abi_humanize_number=yes
|
||||||
|
abi_id_from_name=yes
|
||||||
|
# DROP: On glibc.
|
||||||
|
#abi_inet_net_pton=no
|
||||||
|
abi_inet_net_pton=yes
|
||||||
|
# DROP: On libmd.
|
||||||
|
#abi_md5=no
|
||||||
|
abi_md5=yes
|
||||||
|
abi_name_from_id=yes
|
||||||
|
abi_nlist=yes
|
||||||
|
abi_pidfile=yes
|
||||||
|
abi_proctitle=yes
|
||||||
|
abi_progname=yes
|
||||||
|
abi_readpassphrase=yes
|
||||||
|
# DROP: On glibc >= 2.26.
|
||||||
|
#abi_reallocarray=no
|
||||||
|
abi_reallocarray=yes
|
||||||
|
abi_reallocf=yes
|
||||||
|
abi_recallocarray=yes
|
||||||
|
abi_stringlist=yes
|
||||||
|
abi_sort=yes
|
||||||
|
# DROP: On glibc >= 2.38.
|
||||||
|
#abi_strl=no
|
||||||
|
abi_strl=yes
|
||||||
|
abi_strmode=yes
|
||||||
|
abi_strnstr=yes
|
||||||
|
abi_strtonum=yes
|
||||||
|
abi_strtox=yes
|
||||||
|
abi_timeconv=yes
|
||||||
|
# DROP: On libmd.
|
||||||
|
abi_transparent_libmd=yes
|
||||||
|
abi_vis=yes
|
||||||
|
abi_wcsl=yes
|
||||||
|
],
|
||||||
|
[*-musl*], [
|
||||||
|
api_time_macros=no
|
||||||
|
|
||||||
|
abi_accmode=yes
|
||||||
|
abi_arc4random=yes
|
||||||
|
abi_arc4random_stir=yes
|
||||||
|
abi_asprintf=no
|
||||||
|
# DROP: On musl >= 0.9.7, optreset got implemented.
|
||||||
|
#abi_bsd_getopt=no
|
||||||
|
abi_bsd_getopt=yes
|
||||||
|
abi_closefrom=yes
|
||||||
|
abi_err=no
|
||||||
|
abi_errc=yes
|
||||||
|
abi_expand_number=yes
|
||||||
|
# DROP: On musl >= 1.1.20.
|
||||||
|
#abi_explicit_bzero=no
|
||||||
|
abi_explicit_bzero=yes
|
||||||
|
# DROP: On musl >= 0.9.4.
|
||||||
|
#abi_fgetln=no
|
||||||
|
abi_fgetln=yes
|
||||||
|
abi_flopen=yes
|
||||||
|
abi_fmtcheck=yes
|
||||||
|
abi_fpurge=yes
|
||||||
|
abi_freezero=yes
|
||||||
|
# On musl >= 1.1.19, fopencookie() got implemented, and because we were
|
||||||
|
# checking for its presence to decide whether to build funopen(), it got
|
||||||
|
# included in builds even when previously it had not been included, which
|
||||||
|
# is partially an ABI issue, but given that disabling it now would be
|
||||||
|
# worse, we'll ignore this as this is only a problem with downgrades. And
|
||||||
|
# enable it explicitly
|
||||||
|
#abi_funopen=no
|
||||||
|
abi_funopen=yes
|
||||||
|
abi_getbsize=yes
|
||||||
|
abi_getpeereid=yes
|
||||||
|
abi_humanize_number=yes
|
||||||
|
abi_id_from_name=yes
|
||||||
|
abi_inet_net_pton=yes
|
||||||
|
# DROP: On libmd.
|
||||||
|
#abi_md5=no
|
||||||
|
abi_md5=yes
|
||||||
|
abi_name_from_id=yes
|
||||||
|
abi_nlist=yes
|
||||||
|
abi_pidfile=yes
|
||||||
|
abi_proctitle=yes
|
||||||
|
abi_progname=yes
|
||||||
|
abi_readpassphrase=yes
|
||||||
|
# DROP: On musl >= 1.2.2.
|
||||||
|
#abi_reallocarray=no
|
||||||
|
abi_reallocarray=yes
|
||||||
|
abi_reallocf=ues
|
||||||
|
abi_recallocarray=yes
|
||||||
|
abi_stringlist=yes
|
||||||
|
abi_sort=yes
|
||||||
|
# DROP: On musl >= 0.5.0, strlcpy() and strlcat() were already implemented.
|
||||||
|
#abi_strl=no
|
||||||
|
abi_strl=yes
|
||||||
|
abi_strmode=yes
|
||||||
|
abi_strnstr=yes
|
||||||
|
abi_strtonum=yes
|
||||||
|
abi_strtox=yes
|
||||||
|
abi_timeconv=yes
|
||||||
|
# DROP: On libmd.
|
||||||
|
abi_transparent_libmd=yes
|
||||||
|
abi_vis=yes
|
||||||
|
abi_wcsl=yes
|
||||||
|
],
|
||||||
|
[darwin*], [
|
||||||
|
api_time_macros=no
|
||||||
|
|
||||||
|
abi_accmode=no
|
||||||
|
abi_arc4random=no
|
||||||
|
abi_arc4random_stir=no
|
||||||
|
abi_asprintf=no
|
||||||
|
abi_bsd_getopt=no
|
||||||
|
abi_closefrom=yes
|
||||||
|
abi_err=no
|
||||||
|
abi_errc=no
|
||||||
|
abi_expand_number=yes
|
||||||
|
abi_explicit_bzero=yes
|
||||||
|
abi_fgetln=no
|
||||||
|
abi_flopen=yes
|
||||||
|
abi_fmtcheck=no
|
||||||
|
abi_fpurge=no
|
||||||
|
abi_freezero=yes
|
||||||
|
abi_funopen=no
|
||||||
|
abi_getbsize=yes
|
||||||
|
abi_getpeereid=no
|
||||||
|
abi_humanize_number=yes
|
||||||
|
abi_id_from_name=yes
|
||||||
|
abi_inet_net_pton=no
|
||||||
|
# On libmd.
|
||||||
|
abi_md5=no
|
||||||
|
abi_name_from_id=no
|
||||||
|
abi_nlist=no
|
||||||
|
abi_pidfile=yes
|
||||||
|
abi_proctitle=yes
|
||||||
|
abi_progname=no
|
||||||
|
abi_readpassphrase=no
|
||||||
|
abi_reallocarray=yes
|
||||||
|
abi_reallocf=no
|
||||||
|
abi_recallocarray=yes
|
||||||
|
abi_stringlist=no
|
||||||
|
abi_sort=no
|
||||||
|
abi_strl=no
|
||||||
|
abi_strmode=no
|
||||||
|
abi_strnstr=no
|
||||||
|
abi_strtonum=no
|
||||||
|
abi_strtox=yes
|
||||||
|
abi_timeconv=no
|
||||||
|
# On libmd.
|
||||||
|
abi_transparent_libmd=no
|
||||||
|
abi_vis=no
|
||||||
|
abi_wcsl=no
|
||||||
|
],
|
||||||
|
[solaris2*], [
|
||||||
|
api_time_macros=yes
|
||||||
|
|
||||||
|
abi_accmode=yes
|
||||||
|
abi_arc4random=no
|
||||||
|
abi_arc4random_stir=no
|
||||||
|
abi_asprintf=no
|
||||||
|
abi_bsd_getopt=yes
|
||||||
|
abi_closefrom=no
|
||||||
|
abi_err=no
|
||||||
|
abi_errc=yes
|
||||||
|
abi_expand_number=yes
|
||||||
|
abi_explicit_bzero=yes
|
||||||
|
abi_fgetln=yes
|
||||||
|
abi_flopen=yes
|
||||||
|
abi_fmtcheck=no
|
||||||
|
abi_fpurge=yes
|
||||||
|
abi_freezero=yes
|
||||||
|
abi_funopen=no
|
||||||
|
abi_getbsize=yes
|
||||||
|
abi_getpeereid=yes
|
||||||
|
abi_humanize_number=yes
|
||||||
|
abi_id_from_name=yes
|
||||||
|
abi_inet_net_pton=yes
|
||||||
|
# On libmd.
|
||||||
|
abi_md5=no
|
||||||
|
abi_name_from_id=yes
|
||||||
|
abi_nlist=no
|
||||||
|
abi_pidfile=yes
|
||||||
|
abi_proctitle=yes
|
||||||
|
abi_progname=no
|
||||||
|
abi_readpassphrase=yes
|
||||||
|
abi_reallocarray=yes
|
||||||
|
abi_reallocf=no
|
||||||
|
abi_recallocarray=yes
|
||||||
|
abi_stringlist=yes
|
||||||
|
abi_sort=yes
|
||||||
|
abi_strl=no
|
||||||
|
abi_strmode=yes
|
||||||
|
abi_strnstr=no
|
||||||
|
abi_strtonum=no
|
||||||
|
abi_strtox=yes
|
||||||
|
abi_timeconv=yes
|
||||||
|
# On libmd.
|
||||||
|
abi_transparent_libmd=no
|
||||||
|
abi_vis=yes
|
||||||
|
abi_wcsl=yes
|
||||||
|
],
|
||||||
|
[aix*], [
|
||||||
|
api_time_macros=yes
|
||||||
|
|
||||||
|
abi_accmode=yes
|
||||||
|
abi_arc4random=yes
|
||||||
|
abi_arc4random_stir=yes
|
||||||
|
abi_asprintf=yes
|
||||||
|
abi_bsd_getopt=yes
|
||||||
|
abi_closefrom=yes
|
||||||
|
abi_err=yes
|
||||||
|
abi_errc=yes
|
||||||
|
abi_expand_number=yes
|
||||||
|
abi_explicit_bzero=yes
|
||||||
|
abi_fgetln=yes
|
||||||
|
abi_flopen=yes
|
||||||
|
abi_fmtcheck=yes
|
||||||
|
abi_fpurge=no
|
||||||
|
abi_freezero=yes
|
||||||
|
abi_funopen=no
|
||||||
|
abi_getbsize=yes
|
||||||
|
abi_getpeereid=yes
|
||||||
|
abi_humanize_number=yes
|
||||||
|
abi_id_from_name=yes
|
||||||
|
abi_inet_net_pton=no
|
||||||
|
# On libmd.
|
||||||
|
abi_md5=no
|
||||||
|
abi_name_from_id=yes
|
||||||
|
abi_nlist=no
|
||||||
|
abi_pidfile=yes
|
||||||
|
abi_proctitle=yes
|
||||||
|
abi_progname=yes
|
||||||
|
abi_readpassphrase=yes
|
||||||
|
abi_reallocarray=yes
|
||||||
|
abi_reallocf=yes
|
||||||
|
abi_recallocarray=yes
|
||||||
|
abi_stringlist=yes
|
||||||
|
abi_sort=yes
|
||||||
|
abi_strl=yes
|
||||||
|
abi_strmode=yes
|
||||||
|
abi_strnstr=yes
|
||||||
|
abi_strtonum=yes
|
||||||
|
abi_strtox=yes
|
||||||
|
abi_timeconv=yes
|
||||||
|
# On libmd.
|
||||||
|
abi_transparent_libmd=no
|
||||||
|
abi_vis=yes
|
||||||
|
abi_wcsl=yes
|
||||||
|
],
|
||||||
|
[mingw*], [
|
||||||
|
is_windows=yes
|
||||||
|
],
|
||||||
)
|
)
|
||||||
AM_CONDITIONAL([HAVE_LINKER_VERSION_SCRIPT],
|
|
||||||
[test "x$libbsd_cv_version_script" = "xyes"])
|
# Handle artificial ABI selections that are combinations of others.
|
||||||
|
AS_IF([test "$abi_name_from_id" = "yes" || test "$abi_id_from_name" = "yes"], [
|
||||||
|
abi_pwcache=yes
|
||||||
|
], [
|
||||||
|
abi_pwcache=no
|
||||||
|
])
|
||||||
|
AS_IF([test "$abi_err" = "yes" || test "$abi_errc" = "yes"], [
|
||||||
|
abi_err_h=yes
|
||||||
|
], [
|
||||||
|
abi_err_h=no
|
||||||
|
])
|
||||||
|
|
||||||
|
AM_CONDITIONAL([OS_WINDOWS], [test "x$is_windows" = "xyes"])
|
||||||
|
|
||||||
# Checks for programs.
|
# Checks for programs.
|
||||||
|
AC_CHECK_TOOL([OBJDUMP], [objdump])
|
||||||
AC_PROG_CC
|
AC_PROG_CC
|
||||||
|
AC_PROG_SED
|
||||||
AC_PROG_INSTALL
|
AC_PROG_INSTALL
|
||||||
AC_PROG_LN_S
|
AC_PROG_LN_S
|
||||||
|
|
||||||
# Set default compiler variables
|
# Set default compiler variables
|
||||||
if test "$user_CFLAGS" = unset && test "$GCC" = yes; then
|
AS_IF([test "$user_CFLAGS" = unset], [
|
||||||
CFLAGS="$CFLAGS -Wall -Wextra -Wno-unused-variable -Wno-unused-parameter"
|
LIBBSD_CHECK_COMPILER_FLAG([-Wall])
|
||||||
fi
|
LIBBSD_CHECK_COMPILER_FLAG([-Wextra])
|
||||||
|
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wbad-function-cast])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wc99-c11-compat])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wcast-align])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wdeclaration-after-statement])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wdocumentation])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wduplicated-branches])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wduplicated-cond])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wformat -Wformat-security])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wformat=2])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Winit-self])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wlogical-not-parentheses])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wlogical-op])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wmissing-declarations])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wmissing-format-attribute])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wmissing-prototypes])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wnested-externs])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wno-missing-field-initializers])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wno-nonnull-compare])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wno-tautological-constant-out-of-range-compare])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wno-unused-parameter])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wnull-dereference])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wold-style-definition])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wpointer-arith])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wregister])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wrestrict])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wshadow])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wshift-negative-value])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wsizeof-array-argument])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wstrict-prototypes])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wswitch-bool])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wvla])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-Wwrite-strings])
|
||||||
|
|
||||||
|
CFLAGS="$CFLAGS $LIBBSD_COMPILER_FLAGS"
|
||||||
|
|
||||||
|
AC_ARG_ENABLE([sanitize],
|
||||||
|
[AS_HELP_STRING([--enable-sanitize], [enable compiler sanitizer support])],
|
||||||
|
[
|
||||||
|
LIBBSD_COMPILER_FLAGS=''
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-fsanitize=address])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-fsanitize=leak])
|
||||||
|
LIBBSD_CHECK_COMPILER_FLAG([-fsanitize=undefined])
|
||||||
|
|
||||||
|
CFLAGS="$CFLAGS $LIBBSD_COMPILER_FLAGS"
|
||||||
|
LDFLAGS="$LDFLAGS $LIBBSD_COMPILER_FLAGS"
|
||||||
|
])
|
||||||
|
])
|
||||||
|
|
||||||
# Checks for libraries.
|
# Checks for libraries.
|
||||||
AC_CHECK_LIB([testu01], [unif01_CreateExternGenBits],
|
AC_CHECK_LIB([testu01], [unif01_CreateExternGenBits],
|
||||||
[TESTU01_LIBS="-ltestu01"])
|
[TESTU01_LIBS="-ltestu01"])
|
||||||
AC_SUBST([TESTU01_LIBS])
|
AC_SUBST([TESTU01_LIBS])
|
||||||
AM_CONDITIONAL([HAVE_LIBTESTU01],
|
AM_CONDITIONAL([HAVE_LIBTESTU01],
|
||||||
[test "x$ac_cv_lib_testu01_unif01_CreateExternGenBits" = "xyes"])
|
[test "x$ac_cv_lib_testu01_unif01_CreateExternGenBits" = "xyes"])
|
||||||
|
|
||||||
saved_LIBS="$LIBS"
|
saved_LIBS="$LIBS"
|
||||||
AC_SEARCH_LIBS([MD5Update], [md], [
|
AS_IF([test "$abi_md5" = "yes"], [
|
||||||
AC_SEARCH_LIBS([SHA512Update], [md], [
|
AC_SEARCH_LIBS([MD5Update], [md], [
|
||||||
MD_LIBS="-lmd"
|
AS_IF([test "x$ac_cv_search_MD5Update" != "xnone required"], [
|
||||||
|
MD5_LIBS="$MD5_LIBS $ac_cv_search_MD5Update"
|
||||||
|
abi_transparent_libmd=yes
|
||||||
|
])
|
||||||
|
], [
|
||||||
|
AC_MSG_ERROR([cannot find required MD5 functions in libc or libmd])
|
||||||
|
])
|
||||||
|
])
|
||||||
|
AS_IF([test "$abi_arc4random" = "yes"], [
|
||||||
|
AC_CHECK_FUNCS([getentropy])
|
||||||
|
|
||||||
|
AS_IF([test "$ac_cv_func_getentropy" != "yes"], [
|
||||||
|
AC_SEARCH_LIBS([SHA512Update], [md], [
|
||||||
|
AS_IF([test "x$ac_cv_search_SHA512Update" != "xnone required"], [
|
||||||
|
LIBBSD_LIBS="$SHA512_LIBS $ac_cv_search_SHA512Update"
|
||||||
|
])
|
||||||
|
], [
|
||||||
|
AC_MSG_ERROR([cannot find required SHA-2 functions in libc or libmd])
|
||||||
|
])
|
||||||
])
|
])
|
||||||
], [
|
|
||||||
AC_MSG_ERROR([cannot find required message digest functions in libc or libmd])
|
|
||||||
])
|
])
|
||||||
AC_SUBST([MD_LIBS])
|
|
||||||
LIBS="$saved_LIBS"
|
LIBS="$saved_LIBS"
|
||||||
|
|
||||||
is_windows=no
|
|
||||||
AS_CASE([$host_os],
|
AS_CASE([$host_os],
|
||||||
[*-gnu*], [
|
[*-gnu*], [
|
||||||
# In old glibc versions (< 2.17) clock_gettime() is in librt.
|
# In old glibc versions (< 2.17) clock_gettime() is in librt.
|
||||||
saved_LIBS="$LIBS"
|
saved_LIBS="$LIBS"
|
||||||
AC_SEARCH_LIBS([clock_gettime], [rt], [
|
AC_SEARCH_LIBS([clock_gettime], [rt], [
|
||||||
AS_IF([test "x$ac_cv_search_clock_gettime" != "xnone required"], [
|
AS_IF([test "x$ac_cv_search_clock_gettime" != "xnone required"], [
|
||||||
CLOCK_GETTIME_LIBS="$ac_cv_search_clock_gettime"
|
LIBBSD_LIBS="$LIBBSD_LIBS $ac_cv_search_clock_gettime"
|
||||||
])
|
])
|
||||||
])
|
])
|
||||||
AC_SUBST([CLOCK_GETTIME_LIBS])
|
|
||||||
LIBS="$saved_LIBS"
|
LIBS="$saved_LIBS"
|
||||||
],
|
],
|
||||||
[*-musl*], [
|
[aix*], [
|
||||||
# Upstream refuses to define this, we will do it ourselves then.
|
saved_LIBS="$LIBS"
|
||||||
AC_DEFINE([__MUSL__], [1], [Define to 1 if we are building for musl])
|
AC_SEARCH_LIBS([perfstat_cpu_total], [perfstat], [
|
||||||
],
|
AS_IF([test "x$ac_cv_search_perfstat_cpu_total" != "xnone required"], [
|
||||||
[mingw*], [
|
LIBBSD_LIBS="$LIBBSD_LIBS $ac_cv_search_perfstat_cpu_total"
|
||||||
is_windows=yes
|
])
|
||||||
|
])
|
||||||
|
LIBS="$saved_LIBS"
|
||||||
],
|
],
|
||||||
)
|
)
|
||||||
AM_CONDITIONAL([OS_WINDOWS], [test "x$is_windows" = "xyes"])
|
|
||||||
|
|
||||||
# Checks for header files.
|
# Checks for header files.
|
||||||
AC_CHECK_HEADERS([sys/ndir.h sys/dir.h ndir.h dirent.h pwd.h grp.h])
|
AC_CHECK_HEADERS([\
|
||||||
|
sys/ndir.h \
|
||||||
|
sys/dir.h \
|
||||||
|
ndir.h \
|
||||||
|
dirent.h \
|
||||||
|
pwd.h \
|
||||||
|
grp.h \
|
||||||
|
stdio_ext.h \
|
||||||
|
procinfo.h \
|
||||||
|
])
|
||||||
|
|
||||||
# Checks for typedefs, structures, and compiler characteristics.
|
# Checks for typedefs, structures, and compiler characteristics.
|
||||||
AC_C_INLINE
|
AC_C_INLINE
|
||||||
@ -111,106 +515,115 @@ AC_TYPE_UID_T
|
|||||||
AC_TYPE_SIZE_T
|
AC_TYPE_SIZE_T
|
||||||
AC_TYPE_SSIZE_T
|
AC_TYPE_SSIZE_T
|
||||||
|
|
||||||
AC_CHECK_DECL([F_CLOSEM],
|
AC_CHECK_DECL([F_CLOSEM], [
|
||||||
[AC_DEFINE([HAVE_FCNTL_CLOSEM], [1],
|
AC_DEFINE([HAVE_FCNTL_CLOSEM], [1],
|
||||||
[Define to 1 if you have fcntl(F_CLOSEM)])],
|
[Define to 1 if you have fcntl(F_CLOSEM)])
|
||||||
[],
|
], [], [[
|
||||||
[#include <limits.h>
|
#include <limits.h>
|
||||||
#include <fcntl.h>])
|
#include <fcntl.h>
|
||||||
|
]])
|
||||||
|
|
||||||
AC_CACHE_CHECK(
|
AC_CHECK_DECLS([environ], [], [], [[
|
||||||
[for GNU .init_array section support],
|
#include <unistd.h>
|
||||||
[libbsd_cv_gnu_init_array_support],
|
]])
|
||||||
[AC_RUN_IFELSE(
|
|
||||||
[AC_LANG_SOURCE(
|
LIBBSD_HAS_GNU_INIT_ARRAY
|
||||||
[[
|
|
||||||
static int rc = 1;
|
|
||||||
static void init(int argc) { if (argc == 1) rc = 0; }
|
|
||||||
void (*init_func)(int argc) __attribute__((__section__(".init_array"))) = init;
|
|
||||||
int main() { return rc; }
|
|
||||||
]]
|
|
||||||
)],
|
|
||||||
[libbsd_cv_gnu_init_array_support=yes],
|
|
||||||
[libbsd_cv_gnu_init_array_support=no],
|
|
||||||
[AC_PREPROC_IFELSE(
|
|
||||||
[AC_LANG_SOURCE(
|
|
||||||
[[
|
|
||||||
/* Look for a known libc that supports .init_array with the GNU extension
|
|
||||||
* to pass main() arguments to the init functions. */
|
|
||||||
#include <stdlib.h>
|
|
||||||
#if defined __GLIBC_PREREQ
|
|
||||||
# if __GLIBC_PREREQ(2, 4)
|
|
||||||
/* glibc supports GNU .init_array since 2.4. */
|
|
||||||
# else
|
|
||||||
# error glibc does not support GNU .init_array
|
|
||||||
# endif
|
|
||||||
#else
|
|
||||||
/*
|
|
||||||
* Basic SysV ABI .init_array support, init functions do not get arguments:
|
|
||||||
* - Bionic since its inception.
|
|
||||||
* - uClibc since 0.9.29.
|
|
||||||
*/
|
|
||||||
# error unknown whether libc supports GNU .init_array
|
|
||||||
#endif
|
|
||||||
]]
|
|
||||||
)],
|
|
||||||
[libbsd_cv_gnu_init_array_support=yes],
|
|
||||||
[libbsd_cv_gnu_init_array_support=no])
|
|
||||||
]
|
|
||||||
)]
|
|
||||||
)
|
|
||||||
AM_CONDITIONAL([BUILD_LIBBSD_CTOR],
|
|
||||||
[test "$libbsd_cv_gnu_init_array_support" = yes])
|
|
||||||
|
|
||||||
# Checks for library functions.
|
# Checks for library functions.
|
||||||
AC_MSG_CHECKING([for program_invocation_short_name])
|
LIBBSD_CHECK_PROGNAME
|
||||||
AC_LINK_IFELSE(
|
LIBBSD_CHECK_REGISTER_ATFORK
|
||||||
[AC_LANG_PROGRAM([[#include <errno.h>]],
|
|
||||||
[[const char *p = program_invocation_short_name;]])],
|
|
||||||
[AC_DEFINE([HAVE_PROGRAM_INVOCATION_SHORT_NAME], [1],
|
|
||||||
[Define to 1 if you have program_invocation_short_name])
|
|
||||||
AC_MSG_RESULT([yes])],
|
|
||||||
[AC_MSG_RESULT([no])])
|
|
||||||
|
|
||||||
AC_MSG_CHECKING([for __progname])
|
AC_CHECK_FUNCS([\
|
||||||
AC_LINK_IFELSE(
|
vasprintf \
|
||||||
[AC_LANG_PROGRAM([[extern char *__progname;]],
|
asprintf \
|
||||||
[[printf("%s", __progname);]])],
|
clearenv \
|
||||||
[AC_DEFINE([HAVE___PROGNAME], [1], [Define to 1 if you have __progname])
|
dirfd \
|
||||||
AC_MSG_RESULT([yes])],
|
flock \
|
||||||
[AC_MSG_RESULT([no])])
|
fopencookie \
|
||||||
|
__fpurge \
|
||||||
|
funopen \
|
||||||
|
getauxval \
|
||||||
|
getentropy \
|
||||||
|
getexecname \
|
||||||
|
getline \
|
||||||
|
open_memstream \
|
||||||
|
pstat_getproc \
|
||||||
|
sysconf \
|
||||||
|
uid_from_user \
|
||||||
|
gid_from_group \
|
||||||
|
user_from_uid \
|
||||||
|
group_from_gid \
|
||||||
|
])
|
||||||
|
|
||||||
AC_MSG_CHECKING([for __register_atfork])
|
AM_CONDITIONAL([HAVE_GETENTROPY], [test "x$ac_cv_func_getentropy" = "xyes"])
|
||||||
AC_LINK_IFELSE(
|
|
||||||
[AC_LANG_PROGRAM([[
|
|
||||||
#include <stddef.h>
|
|
||||||
extern void *__dso_handle;
|
|
||||||
extern int __register_atfork(void (*)(void), void(*)(void), void (*)(void), void *);
|
|
||||||
]], [[
|
|
||||||
__register_atfork(NULL, NULL, NULL, __dso_handle);
|
|
||||||
]])],
|
|
||||||
[AC_DEFINE([HAVE___REGISTER_ATFORK], [1],
|
|
||||||
[Define to 1 if you have __register_atfork])
|
|
||||||
AC_MSG_RESULT([yes])],
|
|
||||||
[ARC4RANDOM_ATFORK_LIBS="-pthread"
|
|
||||||
AC_SUBST([ARC4RANDOM_ATFORK_LIBS])
|
|
||||||
AC_MSG_RESULT([no])
|
|
||||||
])
|
|
||||||
|
|
||||||
AC_CHECK_FUNCS([clearenv dirfd fopencookie __fpurge \
|
# API selection
|
||||||
getauxval getentropy getexecname getline \
|
LIBBSD_SELECT_API([time_macros], [time struct conversion macros])
|
||||||
pstat_getproc sysconf])
|
|
||||||
AM_CONDITIONAL([HAVE_GETENTROPY], [test "x$ac_cv_func_getentropy" = "xtrue"])
|
# ABI selection
|
||||||
|
LIBBSD_SELECT_ABI([accmode], [setmode()/getmode()])
|
||||||
|
LIBBSD_SELECT_ABI([arc4random], [arc4random() API])
|
||||||
|
LIBBSD_SELECT_ABI([arc4random_stir], [arc4random_stir()/arc4random_addrandom()])
|
||||||
|
LIBBSD_SELECT_ABI([asprintf], [vasprintf()/asprintf()])
|
||||||
|
LIBBSD_SELECT_ABI([bsd_getopt], [BSD getopt()])
|
||||||
|
LIBBSD_SELECT_ABI([closefrom], [closefrom()])
|
||||||
|
LIBBSD_SELECT_ABI([err_h], [err.h header])
|
||||||
|
LIBBSD_SELECT_ABI([err], [err API])
|
||||||
|
LIBBSD_SELECT_ABI([errc], [errc API])
|
||||||
|
LIBBSD_SELECT_ABI([expand_number], [expand_number()])
|
||||||
|
LIBBSD_SELECT_ABI([explicit_bzero], [explicit_bzero()])
|
||||||
|
LIBBSD_SELECT_ABI([fgetln], [fgetln/fgetwln()])
|
||||||
|
LIBBSD_SELECT_ABI([flopen], [flopen()/flopenat()])
|
||||||
|
LIBBSD_SELECT_ABI([fmtcheck], [fmtcheck()])
|
||||||
|
LIBBSD_SELECT_ABI([fpurge], [fpurge()])
|
||||||
|
LIBBSD_SELECT_ABI([freezero], [freezero()])
|
||||||
|
LIBBSD_SELECT_ABI([funopen], [funopen()])
|
||||||
|
LIBBSD_SELECT_ABI([getbsize], [getbsize()])
|
||||||
|
LIBBSD_SELECT_ABI([getpeereid], [getpeereid()])
|
||||||
|
LIBBSD_SELECT_ABI([humanize_number], [humanize_number()/dehumanize_number()])
|
||||||
|
LIBBSD_SELECT_ABI([id_from_name], [uid_from_user()/gid_from_user()])
|
||||||
|
LIBBSD_SELECT_ABI([inet_net_pton], [inet_net_pton()])
|
||||||
|
LIBBSD_SELECT_ABI([md5], [MD5 digest functions])
|
||||||
|
LIBBSD_SELECT_ABI([name_from_id], [user_from_uid()/group_from_gid()])
|
||||||
|
LIBBSD_SELECT_ABI([nlist], [nlist()])
|
||||||
|
LIBBSD_SELECT_ABI([pidfile], [pidfile API])
|
||||||
|
LIBBSD_SELECT_ABI([proctitle], [setproctitle() API])
|
||||||
|
LIBBSD_SELECT_ABI([progname], [setprogname()/getprogname()])
|
||||||
|
LIBBSD_SELECT_ABI([pwcache], [password cache API])
|
||||||
|
LIBBSD_SELECT_ABI([readpassphrase], [readpassphrase()])
|
||||||
|
LIBBSD_SELECT_ABI([reallocarray], [reallocarray()])
|
||||||
|
LIBBSD_SELECT_ABI([reallocf], [reallocf()])
|
||||||
|
LIBBSD_SELECT_ABI([recallocarray], [recallocarray()])
|
||||||
|
LIBBSD_SELECT_ABI([stringlist], [stringlist sl_*() API])
|
||||||
|
LIBBSD_SELECT_ABI([sort], [BSD sort functions])
|
||||||
|
LIBBSD_SELECT_ABI([strl], [strlcpy()/strlcat()])
|
||||||
|
LIBBSD_SELECT_ABI([strmode], [strmode()])
|
||||||
|
LIBBSD_SELECT_ABI([strnstr], [strnstr()])
|
||||||
|
LIBBSD_SELECT_ABI([strtonum], [strtonum()])
|
||||||
|
LIBBSD_SELECT_ABI([strtox], [strtoi()/strtou()])
|
||||||
|
LIBBSD_SELECT_ABI([timeconv], [timeconv.h API])
|
||||||
|
LIBBSD_SELECT_ABI([transparent_libmd], [transparent libmd support])
|
||||||
|
LIBBSD_SELECT_ABI([vis], [vis API])
|
||||||
|
LIBBSD_SELECT_ABI([wcsl], [wcslcpy()/wcslcat()])
|
||||||
|
|
||||||
|
AS_IF([test "x$abi_funopen" = "xno" && \
|
||||||
|
test "x$ac_cv_func_funopen" != "xyes" && \
|
||||||
|
test "x$ac_cv_func_fopencookie" = "xyes"], [
|
||||||
|
AC_MSG_WARN([[can implement funopen() now based on newly added fopencooke(), report upstream]])
|
||||||
|
])
|
||||||
|
|
||||||
|
AC_SUBST([MD5_LIBS])
|
||||||
|
AC_SUBST([LIBBSD_LIBS])
|
||||||
|
|
||||||
AC_CONFIG_FILES([
|
AC_CONFIG_FILES([
|
||||||
Makefile
|
Makefile
|
||||||
include/Makefile
|
include/Makefile
|
||||||
man/Makefile
|
man/Makefile
|
||||||
src/Makefile
|
src/Makefile
|
||||||
src/libbsd.pc
|
src/libbsd.pc
|
||||||
src/libbsd-ctor.pc
|
src/libbsd-ctor.pc
|
||||||
src/libbsd-overlay.pc
|
src/libbsd-overlay.pc
|
||||||
test/Makefile
|
test/Makefile
|
||||||
])
|
])
|
||||||
AC_CONFIG_HEADERS([config.h])
|
AC_CONFIG_HEADERS([config.h])
|
||||||
AC_OUTPUT
|
AC_OUTPUT
|
||||||
|
@ -12,21 +12,77 @@ nobase_include_HEADERS = \
|
|||||||
bsd/netinet/ip_icmp.h \
|
bsd/netinet/ip_icmp.h \
|
||||||
bsd/bitstring.h \
|
bsd/bitstring.h \
|
||||||
bsd/bsd.h \
|
bsd/bsd.h \
|
||||||
bsd/err.h \
|
|
||||||
bsd/getopt.h \
|
|
||||||
bsd/grp.h \
|
|
||||||
bsd/inttypes.h \
|
bsd/inttypes.h \
|
||||||
bsd/libutil.h \
|
bsd/libutil.h \
|
||||||
bsd/md5.h \
|
|
||||||
bsd/nlist.h \
|
|
||||||
bsd/pwd.h \
|
|
||||||
bsd/readpassphrase.h \
|
|
||||||
bsd/stdio.h \
|
bsd/stdio.h \
|
||||||
bsd/stdlib.h \
|
bsd/stdlib.h \
|
||||||
bsd/string.h \
|
bsd/string.h \
|
||||||
bsd/stringlist.h \
|
|
||||||
bsd/timeconv.h \
|
|
||||||
bsd/unistd.h \
|
bsd/unistd.h \
|
||||||
bsd/vis.h \
|
|
||||||
bsd/wchar.h \
|
bsd/wchar.h \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
|
if ABI_ERR_H
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/err.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_BSD_GETOPT
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/getopt.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_MD5
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/md5.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_NLIST
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/nlist.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_READPASSPHRASE
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/readpassphrase.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PWCACHE
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/grp.h \
|
||||||
|
bsd/pwd.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRINGLIST
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/stringlist.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_TIMECONV
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/timeconv.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_VIS
|
||||||
|
nobase_include_HEADERS += \
|
||||||
|
bsd/vis.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
do_header_subst = $(AM_V_GEN) $(SED) \
|
||||||
|
-e 's:^//\(.define LIBBSD_SYS_TIME_BITS\).*:\1 $(LIBBSD_SYS_TIME_BITS):' \
|
||||||
|
-e 's:^//\(.define LIBBSD_SYS_HAS_TIME64\).*:\1 $(LIBBSD_SYS_HAS_TIME64):' \
|
||||||
|
# EOL
|
||||||
|
|
||||||
|
install-data-hook:
|
||||||
|
$(do_header_subst) <$(DESTDIR)$(includedir)/bsd/sys/cdefs.h \
|
||||||
|
>$(DESTDIR)$(includedir)/bsd/sys/cdefs.h.new
|
||||||
|
mv $(DESTDIR)$(includedir)/bsd/sys/cdefs.h.new \
|
||||||
|
$(DESTDIR)$(includedir)/bsd/sys/cdefs.h
|
||||||
|
@ -44,8 +44,10 @@
|
|||||||
__BEGIN_DECLS
|
__BEGIN_DECLS
|
||||||
int
|
int
|
||||||
gid_from_group(const char *, gid_t *);
|
gid_from_group(const char *, gid_t *);
|
||||||
|
#ifndef __APPLE__
|
||||||
const char *
|
const char *
|
||||||
group_from_gid(gid_t, int);
|
group_from_gid(gid_t, int);
|
||||||
|
#endif
|
||||||
__END_DECLS
|
__END_DECLS
|
||||||
|
|
||||||
#endif
|
#endif
|
||||||
|
@ -24,8 +24,10 @@
|
|||||||
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
#ifndef _AIX
|
||||||
#ifdef LIBBSD_OVERLAY
|
#ifdef LIBBSD_OVERLAY
|
||||||
#include_next <md5.h>
|
#include_next <md5.h>
|
||||||
#else
|
#else
|
||||||
#include <md5.h>
|
#include <md5.h>
|
||||||
#endif
|
#endif
|
||||||
|
#endif
|
||||||
|
@ -44,8 +44,10 @@
|
|||||||
__BEGIN_DECLS
|
__BEGIN_DECLS
|
||||||
int
|
int
|
||||||
uid_from_user(const char *, uid_t *);
|
uid_from_user(const char *, uid_t *);
|
||||||
|
#ifndef __APPLE__
|
||||||
const char *
|
const char *
|
||||||
user_from_uid(uid_t, int);
|
user_from_uid(uid_t, int);
|
||||||
|
#endif
|
||||||
__END_DECLS
|
__END_DECLS
|
||||||
|
|
||||||
#endif
|
#endif
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright © 2004-2005, 2009, 2011-2013 Guillem Jover <guillem@hadrons.org>
|
* Copyright © 2004-2024 Guillem Jover <guillem@hadrons.org>
|
||||||
*
|
*
|
||||||
* Redistribution and use in source and binary forms, with or without
|
* Redistribution and use in source and binary forms, with or without
|
||||||
* modification, are permitted provided that the following conditions
|
* modification, are permitted provided that the following conditions
|
||||||
@ -44,8 +44,18 @@
|
|||||||
#include <bsd/sys/cdefs.h>
|
#include <bsd/sys/cdefs.h>
|
||||||
#endif
|
#endif
|
||||||
#include <sys/types.h>
|
#include <sys/types.h>
|
||||||
|
#if defined(_AIX)
|
||||||
|
#include <stdarg.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
__BEGIN_DECLS
|
__BEGIN_DECLS
|
||||||
|
#if defined(_AIX)
|
||||||
|
int asprintf(char **strp, char const *fmt, ...)
|
||||||
|
__printflike(2, 3);
|
||||||
|
int vasprintf(char **strp, char const *fmt, va_list args)
|
||||||
|
__printflike(2, 0);
|
||||||
|
#endif
|
||||||
|
|
||||||
const char *fmtcheck(const char *, const char *);
|
const char *fmtcheck(const char *, const char *);
|
||||||
|
|
||||||
/* XXX: The function requires cooperation from the system libc to store the
|
/* XXX: The function requires cooperation from the system libc to store the
|
||||||
|
@ -51,16 +51,24 @@
|
|||||||
#include <stdint.h>
|
#include <stdint.h>
|
||||||
|
|
||||||
__BEGIN_DECLS
|
__BEGIN_DECLS
|
||||||
|
#if !defined(__APPLE__) && !defined(__sun)
|
||||||
|
#if !defined(__GLIBC__) || \
|
||||||
|
!__GLIBC_PREREQ(2, 36) || \
|
||||||
|
!defined(_DEFAULT_SOURCE)
|
||||||
uint32_t arc4random(void);
|
uint32_t arc4random(void);
|
||||||
void arc4random_stir(void);
|
|
||||||
void arc4random_addrandom(unsigned char *dat, int datlen);
|
|
||||||
void arc4random_buf(void *_buf, size_t n);
|
void arc4random_buf(void *_buf, size_t n);
|
||||||
uint32_t arc4random_uniform(uint32_t upper_bound);
|
uint32_t arc4random_uniform(uint32_t upper_bound);
|
||||||
|
#endif
|
||||||
|
void arc4random_stir(void);
|
||||||
|
void arc4random_addrandom(unsigned char *dat, int datlen);
|
||||||
|
#endif
|
||||||
|
|
||||||
int dehumanize_number(const char *str, int64_t *size);
|
int dehumanize_number(const char *str, int64_t *size);
|
||||||
|
|
||||||
|
#if !defined(__APPLE__)
|
||||||
const char *getprogname(void);
|
const char *getprogname(void);
|
||||||
void setprogname(const char *);
|
void setprogname(const char *);
|
||||||
|
#endif
|
||||||
|
|
||||||
int heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
|
int heapsort(void *, size_t, size_t, int (*)(const void *, const void *));
|
||||||
int mergesort(void *base, size_t nmemb, size_t size,
|
int mergesort(void *base, size_t nmemb, size_t size,
|
||||||
@ -72,7 +80,9 @@ int sradixsort(const unsigned char **base, int nmemb,
|
|||||||
|
|
||||||
void *reallocf(void *ptr, size_t size);
|
void *reallocf(void *ptr, size_t size);
|
||||||
#if !defined(__GLIBC__) || \
|
#if !defined(__GLIBC__) || \
|
||||||
(defined(__GLIBC__) && (!__GLIBC_PREREQ(2, 26) || !defined(_GNU_SOURCE)))
|
!__GLIBC_PREREQ(2, 26) || \
|
||||||
|
(__GLIBC_PREREQ(2, 26) && !__GLIBC_PREREQ(2, 29) && !defined(_GNU_SOURCE)) || \
|
||||||
|
(__GLIBC_PREREQ(2, 29) && !defined(_DEFAULT_SOURCE))
|
||||||
void *reallocarray(void *ptr, size_t nmemb, size_t size);
|
void *reallocarray(void *ptr, size_t nmemb, size_t size);
|
||||||
#endif
|
#endif
|
||||||
void *recallocarray(void *ptr, size_t oldnmemb, size_t nmemb, size_t size);
|
void *recallocarray(void *ptr, size_t oldnmemb, size_t nmemb, size_t size);
|
||||||
|
@ -41,13 +41,19 @@
|
|||||||
#include <sys/types.h>
|
#include <sys/types.h>
|
||||||
|
|
||||||
__BEGIN_DECLS
|
__BEGIN_DECLS
|
||||||
|
#if !defined(__APPLE__) && \
|
||||||
|
(!defined(__GLIBC__) || !__GLIBC_PREREQ(2, 38) || !defined(_DEFAULT_SOURCE))
|
||||||
size_t strlcpy(char *dst, const char *src, size_t siz);
|
size_t strlcpy(char *dst, const char *src, size_t siz);
|
||||||
size_t strlcat(char *dst, const char *src, size_t siz);
|
size_t strlcat(char *dst, const char *src, size_t siz);
|
||||||
|
#endif
|
||||||
char *strnstr(const char *str, const char *find, size_t str_len);
|
char *strnstr(const char *str, const char *find, size_t str_len);
|
||||||
|
#ifndef __APPLE__
|
||||||
void strmode(mode_t mode, char *str);
|
void strmode(mode_t mode, char *str);
|
||||||
|
#endif
|
||||||
|
|
||||||
#if !defined(__GLIBC__) || \
|
#if !defined(__GLIBC__) || \
|
||||||
(defined(__GLIBC__) && (!__GLIBC_PREREQ(2, 25) || !defined(_GNU_SOURCE)))
|
!__GLIBC_PREREQ(2, 25) || \
|
||||||
|
!defined(_DEFAULT_SOURCE)
|
||||||
void explicit_bzero(void *buf, size_t len);
|
void explicit_bzero(void *buf, size_t len);
|
||||||
#endif
|
#endif
|
||||||
__END_DECLS
|
__END_DECLS
|
||||||
|
@ -37,6 +37,9 @@
|
|||||||
#ifndef __is_identifier
|
#ifndef __is_identifier
|
||||||
#define __is_identifier(x) 1
|
#define __is_identifier(x) 1
|
||||||
#endif
|
#endif
|
||||||
|
#ifndef __has_builtin
|
||||||
|
#define __has_builtin(x) !__is_identifier(x)
|
||||||
|
#endif
|
||||||
|
|
||||||
#ifdef LIBBSD_OVERLAY
|
#ifdef LIBBSD_OVERLAY
|
||||||
/*
|
/*
|
||||||
@ -83,6 +86,10 @@
|
|||||||
#define _SYS_CDEFS_H
|
#define _SYS_CDEFS_H
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
|
/* Define the ABI for the current system. */
|
||||||
|
//#define LIBBSD_SYS_TIME_BITS 0
|
||||||
|
//#define LIBBSD_SYS_HAS_TIME64 0
|
||||||
|
|
||||||
#define LIBBSD_CONCAT(x, y) x ## y
|
#define LIBBSD_CONCAT(x, y) x ## y
|
||||||
#define LIBBSD_STRING(x) #x
|
#define LIBBSD_STRING(x) #x
|
||||||
|
|
||||||
@ -92,6 +99,12 @@
|
|||||||
#define LIBBSD_GCC_VERSION 0
|
#define LIBBSD_GCC_VERSION 0
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
|
#if LIBBSD_GCC_VERSION >= 0x0300 || __has_attribute(__unused__)
|
||||||
|
# define LIBBSD_UNUSED __attribute__((__unused__))
|
||||||
|
#else
|
||||||
|
# define LIBBSD_UNUSED
|
||||||
|
#endif
|
||||||
|
|
||||||
#if LIBBSD_GCC_VERSION >= 0x0405 || __has_attribute(__deprecated__)
|
#if LIBBSD_GCC_VERSION >= 0x0405 || __has_attribute(__deprecated__)
|
||||||
#define LIBBSD_DEPRECATED(x) __attribute__((__deprecated__(x)))
|
#define LIBBSD_DEPRECATED(x) __attribute__((__deprecated__(x)))
|
||||||
#elif LIBBSD_GCC_VERSION >= 0x0301
|
#elif LIBBSD_GCC_VERSION >= 0x0301
|
||||||
@ -143,11 +156,7 @@
|
|||||||
* Disable for now. */
|
* Disable for now. */
|
||||||
#if 0
|
#if 0
|
||||||
#ifndef __unused
|
#ifndef __unused
|
||||||
# if LIBBSD_GCC_VERSION >= 0x0300
|
# define __unused LIBBSD_UNUSED
|
||||||
# define __unused __attribute__((__unused__))
|
|
||||||
# else
|
|
||||||
# define __unused
|
|
||||||
# endif
|
|
||||||
#endif
|
#endif
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
@ -182,15 +191,15 @@
|
|||||||
* require it.
|
* require it.
|
||||||
*/
|
*/
|
||||||
#ifndef __offsetof
|
#ifndef __offsetof
|
||||||
# if LIBBSD_GCC_VERSION >= 0x0401 || !__is_identifier(__builtin_offsetof)
|
# if LIBBSD_GCC_VERSION >= 0x0401 || __has_builtin(__builtin_offsetof)
|
||||||
# define __offsetof(type, field) __builtin_offsetof(type, field)
|
# define __offsetof(type, field) __builtin_offsetof(type, field)
|
||||||
# else
|
# else
|
||||||
# ifndef __cplusplus
|
# ifndef __cplusplus
|
||||||
# define __offsetof(type, field) \
|
# define __offsetof(type, field) \
|
||||||
((__size_t)(__uintptr_t)((const volatile void *)&((type *)0)->field))
|
((size_t)(uintptr_t)((const volatile void *)&((type *)0)->field))
|
||||||
# else
|
# else
|
||||||
# define __offsetof(type, field) \
|
# define __offsetof(type, field) \
|
||||||
(__offsetof__ (reinterpret_cast <__size_t> \
|
(__offsetof__ (reinterpret_cast <size_t> \
|
||||||
(&reinterpret_cast <const volatile char &> \
|
(&reinterpret_cast <const volatile char &> \
|
||||||
(static_cast<type *> (0)->field))))
|
(static_cast<type *> (0)->field))))
|
||||||
# endif
|
# endif
|
||||||
@ -243,15 +252,15 @@
|
|||||||
#endif
|
#endif
|
||||||
|
|
||||||
#ifndef __DECONST
|
#ifndef __DECONST
|
||||||
#define __DECONST(type, var) ((type)(__uintptr_t)(const void *)(var))
|
#define __DECONST(type, var) ((type)(uintptr_t)(const void *)(var))
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
#ifndef __DEVOLATILE
|
#ifndef __DEVOLATILE
|
||||||
#define __DEVOLATILE(type, var) ((type)(__uintptr_t)(volatile void *)(var))
|
#define __DEVOLATILE(type, var) ((type)(uintptr_t)(volatile void *)(var))
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
#ifndef __DEQUALIFY
|
#ifndef __DEQUALIFY
|
||||||
#define __DEQUALIFY(type, var) ((type)(__uintptr_t)(const volatile void *)(var))
|
#define __DEQUALIFY(type, var) ((type)(uintptr_t)(const volatile void *)(var))
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
#endif
|
#endif
|
||||||
|
@ -1,4 +1,6 @@
|
|||||||
/*-
|
/*-
|
||||||
|
* SPDX-License-Identifier: BSD-3-Clause
|
||||||
|
*
|
||||||
* Copyright (c) 1991, 1993
|
* Copyright (c) 1991, 1993
|
||||||
* The Regents of the University of California. All rights reserved.
|
* The Regents of the University of California. All rights reserved.
|
||||||
*
|
*
|
||||||
@ -10,7 +12,7 @@
|
|||||||
* 2. Redistributions in binary form must reproduce the above copyright
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
* notice, this list of conditions and the following disclaimer in the
|
||||||
* documentation and/or other materials provided with the distribution.
|
* documentation and/or other materials provided with the distribution.
|
||||||
* 4. Neither the name of the University nor the names of its contributors
|
* 3. Neither the name of the University nor the names of its contributors
|
||||||
* may be used to endorse or promote products derived from this software
|
* may be used to endorse or promote products derived from this software
|
||||||
* without specific prior written permission.
|
* without specific prior written permission.
|
||||||
*
|
*
|
||||||
@ -80,17 +82,25 @@
|
|||||||
*
|
*
|
||||||
* For details on the use of these macros, see the queue(3) manual page.
|
* For details on the use of these macros, see the queue(3) manual page.
|
||||||
*
|
*
|
||||||
|
* Below is a summary of implemented functions where:
|
||||||
|
* + means the macro is available
|
||||||
|
* - means the macro is not available
|
||||||
|
* s means the macro is available but is slow (runs in O(n) time)
|
||||||
*
|
*
|
||||||
* SLIST LIST STAILQ TAILQ
|
* SLIST LIST STAILQ TAILQ
|
||||||
* _HEAD + + + +
|
* _HEAD + + + +
|
||||||
|
* _CLASS_HEAD + + + +
|
||||||
* _HEAD_INITIALIZER + + + +
|
* _HEAD_INITIALIZER + + + +
|
||||||
* _ENTRY + + + +
|
* _ENTRY + + + +
|
||||||
|
* _CLASS_ENTRY + + + +
|
||||||
* _INIT + + + +
|
* _INIT + + + +
|
||||||
* _EMPTY + + + +
|
* _EMPTY + + + +
|
||||||
|
* _END + + + +
|
||||||
* _FIRST + + + +
|
* _FIRST + + + +
|
||||||
* _NEXT + + + +
|
* _NEXT + + + +
|
||||||
* _PREV - + - +
|
* _PREV - + - +
|
||||||
* _LAST - - + +
|
* _LAST - - + +
|
||||||
|
* _LAST_FAST - - - +
|
||||||
* _FOREACH + + + +
|
* _FOREACH + + + +
|
||||||
* _FOREACH_FROM + + + +
|
* _FOREACH_FROM + + + +
|
||||||
* _FOREACH_SAFE + + + +
|
* _FOREACH_SAFE + + + +
|
||||||
@ -103,14 +113,20 @@
|
|||||||
* _INSERT_BEFORE - + - +
|
* _INSERT_BEFORE - + - +
|
||||||
* _INSERT_AFTER + + + +
|
* _INSERT_AFTER + + + +
|
||||||
* _INSERT_TAIL - - + +
|
* _INSERT_TAIL - - + +
|
||||||
* _CONCAT - - + +
|
* _CONCAT s s + +
|
||||||
* _REMOVE_AFTER + - + -
|
* _REMOVE_AFTER + - + -
|
||||||
* _REMOVE_HEAD + - + -
|
* _REMOVE_HEAD + - + -
|
||||||
* _REMOVE + + + +
|
* _REMOVE s + s +
|
||||||
* _SWAP + + + +
|
* _SWAP + + + +
|
||||||
*
|
*
|
||||||
*/
|
*/
|
||||||
#ifdef QUEUE_MACRO_DEBUG
|
#ifdef QUEUE_MACRO_DEBUG
|
||||||
|
#warn Use QUEUE_MACRO_DEBUG_TRACE and/or QUEUE_MACRO_DEBUG_TRASH
|
||||||
|
#define QUEUE_MACRO_DEBUG_TRACE
|
||||||
|
#define QUEUE_MACRO_DEBUG_TRASH
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef QUEUE_MACRO_DEBUG_TRACE
|
||||||
/* Store the last 2 places the queue element or head was altered */
|
/* Store the last 2 places the queue element or head was altered */
|
||||||
struct qm_trace {
|
struct qm_trace {
|
||||||
unsigned long lastline;
|
unsigned long lastline;
|
||||||
@ -120,9 +136,7 @@ struct qm_trace {
|
|||||||
};
|
};
|
||||||
|
|
||||||
#define TRACEBUF struct qm_trace trace;
|
#define TRACEBUF struct qm_trace trace;
|
||||||
#define TRACEBUF_INITIALIZER { __FILE__, __LINE__, NULL, 0 } ,
|
#define TRACEBUF_INITIALIZER { __LINE__, 0, __FILE__, NULL } ,
|
||||||
#define TRASHIT(x) do {(x) = (void *)-1;} while (0)
|
|
||||||
#define QMD_SAVELINK(name, link) void **name = (void *)&(link)
|
|
||||||
|
|
||||||
#define QMD_TRACE_HEAD(head) do { \
|
#define QMD_TRACE_HEAD(head) do { \
|
||||||
(head)->trace.prevline = (head)->trace.lastline; \
|
(head)->trace.prevline = (head)->trace.lastline; \
|
||||||
@ -138,14 +152,31 @@ struct qm_trace {
|
|||||||
(elem)->trace.lastfile = __FILE__; \
|
(elem)->trace.lastfile = __FILE__; \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
#else
|
#else /* !QUEUE_MACRO_DEBUG_TRACE */
|
||||||
#define QMD_TRACE_ELEM(elem)
|
#define QMD_TRACE_ELEM(elem)
|
||||||
#define QMD_TRACE_HEAD(head)
|
#define QMD_TRACE_HEAD(head)
|
||||||
#define QMD_SAVELINK(name, link)
|
|
||||||
#define TRACEBUF
|
#define TRACEBUF
|
||||||
#define TRACEBUF_INITIALIZER
|
#define TRACEBUF_INITIALIZER
|
||||||
|
#endif /* QUEUE_MACRO_DEBUG_TRACE */
|
||||||
|
|
||||||
|
#ifdef QUEUE_MACRO_DEBUG_TRASH
|
||||||
|
#define QMD_SAVELINK(name, link) void **name = (void *)&(link)
|
||||||
|
#define TRASHIT(x) do {(x) = (void *)-1;} while (0)
|
||||||
|
#define QMD_IS_TRASHED(x) ((x) == (void *)(intptr_t)-1)
|
||||||
|
#else /* !QUEUE_MACRO_DEBUG_TRASH */
|
||||||
|
#define QMD_SAVELINK(name, link)
|
||||||
#define TRASHIT(x)
|
#define TRASHIT(x)
|
||||||
#endif /* QUEUE_MACRO_DEBUG */
|
#define QMD_IS_TRASHED(x) 0
|
||||||
|
#endif /* QUEUE_MACRO_DEBUG_TRASH */
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
/*
|
||||||
|
* In C++ there can be structure lists and class lists:
|
||||||
|
*/
|
||||||
|
#define QUEUE_TYPEOF(type) type
|
||||||
|
#else
|
||||||
|
#define QUEUE_TYPEOF(type) struct type
|
||||||
|
#endif
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Singly-linked List declarations.
|
* Singly-linked List declarations.
|
||||||
@ -155,6 +186,11 @@ struct name { \
|
|||||||
struct type *slh_first; /* first element */ \
|
struct type *slh_first; /* first element */ \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define SLIST_CLASS_HEAD(name, type) \
|
||||||
|
struct name { \
|
||||||
|
class type *slh_first; /* first element */ \
|
||||||
|
}
|
||||||
|
|
||||||
#define SLIST_HEAD_INITIALIZER(head) \
|
#define SLIST_HEAD_INITIALIZER(head) \
|
||||||
{ NULL }
|
{ NULL }
|
||||||
|
|
||||||
@ -163,9 +199,37 @@ struct { \
|
|||||||
struct type *sle_next; /* next element */ \
|
struct type *sle_next; /* next element */ \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define SLIST_CLASS_ENTRY(type) \
|
||||||
|
struct { \
|
||||||
|
class type *sle_next; /* next element */ \
|
||||||
|
}
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Singly-linked List functions.
|
* Singly-linked List functions.
|
||||||
*/
|
*/
|
||||||
|
#if (defined(_KERNEL) && defined(INVARIANTS))
|
||||||
|
#define QMD_SLIST_CHECK_PREVPTR(prevp, elm) do { \
|
||||||
|
if (*(prevp) != (elm)) \
|
||||||
|
panic("Bad prevptr *(%p) == %p != %p", \
|
||||||
|
(prevp), *(prevp), (elm)); \
|
||||||
|
} while (0)
|
||||||
|
#else
|
||||||
|
#define QMD_SLIST_CHECK_PREVPTR(prevp, elm)
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#define SLIST_CONCAT(head1, head2, type, field) do { \
|
||||||
|
QUEUE_TYPEOF(type) *curelm = SLIST_FIRST(head1); \
|
||||||
|
if (curelm == NULL) { \
|
||||||
|
if ((SLIST_FIRST(head1) = SLIST_FIRST(head2)) != NULL) \
|
||||||
|
SLIST_INIT(head2); \
|
||||||
|
} else if (SLIST_FIRST(head2) != NULL) { \
|
||||||
|
while (SLIST_NEXT(curelm, field) != NULL) \
|
||||||
|
curelm = SLIST_NEXT(curelm, field); \
|
||||||
|
SLIST_NEXT(curelm, field) = SLIST_FIRST(head2); \
|
||||||
|
SLIST_INIT(head2); \
|
||||||
|
} \
|
||||||
|
} while (0)
|
||||||
|
|
||||||
#define SLIST_EMPTY(head) ((head)->slh_first == NULL)
|
#define SLIST_EMPTY(head) ((head)->slh_first == NULL)
|
||||||
|
|
||||||
#define SLIST_FIRST(head) ((head)->slh_first)
|
#define SLIST_FIRST(head) ((head)->slh_first)
|
||||||
@ -217,7 +281,7 @@ struct { \
|
|||||||
SLIST_REMOVE_HEAD((head), field); \
|
SLIST_REMOVE_HEAD((head), field); \
|
||||||
} \
|
} \
|
||||||
else { \
|
else { \
|
||||||
struct type *curelm = SLIST_FIRST((head)); \
|
QUEUE_TYPEOF(type) *curelm = SLIST_FIRST(head); \
|
||||||
while (SLIST_NEXT(curelm, field) != (elm)) \
|
while (SLIST_NEXT(curelm, field) != (elm)) \
|
||||||
curelm = SLIST_NEXT(curelm, field); \
|
curelm = SLIST_NEXT(curelm, field); \
|
||||||
SLIST_REMOVE_AFTER(curelm, field); \
|
SLIST_REMOVE_AFTER(curelm, field); \
|
||||||
@ -234,12 +298,20 @@ struct { \
|
|||||||
SLIST_FIRST((head)) = SLIST_NEXT(SLIST_FIRST((head)), field); \
|
SLIST_FIRST((head)) = SLIST_NEXT(SLIST_FIRST((head)), field); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
#define SLIST_REMOVE_PREVPTR(prevp, elm, field) do { \
|
||||||
|
QMD_SLIST_CHECK_PREVPTR(prevp, elm); \
|
||||||
|
*(prevp) = SLIST_NEXT(elm, field); \
|
||||||
|
TRASHIT((elm)->field.sle_next); \
|
||||||
|
} while (0)
|
||||||
|
|
||||||
#define SLIST_SWAP(head1, head2, type) do { \
|
#define SLIST_SWAP(head1, head2, type) do { \
|
||||||
struct type *swap_first = SLIST_FIRST(head1); \
|
QUEUE_TYPEOF(type) *swap_first = SLIST_FIRST(head1); \
|
||||||
SLIST_FIRST(head1) = SLIST_FIRST(head2); \
|
SLIST_FIRST(head1) = SLIST_FIRST(head2); \
|
||||||
SLIST_FIRST(head2) = swap_first; \
|
SLIST_FIRST(head2) = swap_first; \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
#define SLIST_END(head) NULL
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Singly-linked Tail queue declarations.
|
* Singly-linked Tail queue declarations.
|
||||||
*/
|
*/
|
||||||
@ -249,6 +321,12 @@ struct name { \
|
|||||||
struct type **stqh_last;/* addr of last next element */ \
|
struct type **stqh_last;/* addr of last next element */ \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define STAILQ_CLASS_HEAD(name, type) \
|
||||||
|
struct name { \
|
||||||
|
class type *stqh_first; /* first element */ \
|
||||||
|
class type **stqh_last; /* addr of last next element */ \
|
||||||
|
}
|
||||||
|
|
||||||
#define STAILQ_HEAD_INITIALIZER(head) \
|
#define STAILQ_HEAD_INITIALIZER(head) \
|
||||||
{ NULL, &(head).stqh_first }
|
{ NULL, &(head).stqh_first }
|
||||||
|
|
||||||
@ -257,6 +335,11 @@ struct { \
|
|||||||
struct type *stqe_next; /* next element */ \
|
struct type *stqe_next; /* next element */ \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define STAILQ_CLASS_ENTRY(type) \
|
||||||
|
struct { \
|
||||||
|
class type *stqe_next; /* next element */ \
|
||||||
|
}
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Singly-linked Tail queue functions.
|
* Singly-linked Tail queue functions.
|
||||||
*/
|
*/
|
||||||
@ -315,9 +398,10 @@ struct { \
|
|||||||
(head)->stqh_last = &STAILQ_NEXT((elm), field); \
|
(head)->stqh_last = &STAILQ_NEXT((elm), field); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
#define STAILQ_LAST(head, type, field) \
|
#define STAILQ_LAST(head, type, field) \
|
||||||
(STAILQ_EMPTY((head)) ? NULL : \
|
(STAILQ_EMPTY((head)) ? NULL : \
|
||||||
__containerof((head)->stqh_last, struct type, field.stqe_next))
|
__containerof((head)->stqh_last, \
|
||||||
|
QUEUE_TYPEOF(type), field.stqe_next))
|
||||||
|
|
||||||
#define STAILQ_NEXT(elm, field) ((elm)->field.stqe_next)
|
#define STAILQ_NEXT(elm, field) ((elm)->field.stqe_next)
|
||||||
|
|
||||||
@ -327,7 +411,7 @@ struct { \
|
|||||||
STAILQ_REMOVE_HEAD((head), field); \
|
STAILQ_REMOVE_HEAD((head), field); \
|
||||||
} \
|
} \
|
||||||
else { \
|
else { \
|
||||||
struct type *curelm = STAILQ_FIRST((head)); \
|
QUEUE_TYPEOF(type) *curelm = STAILQ_FIRST(head); \
|
||||||
while (STAILQ_NEXT(curelm, field) != (elm)) \
|
while (STAILQ_NEXT(curelm, field) != (elm)) \
|
||||||
curelm = STAILQ_NEXT(curelm, field); \
|
curelm = STAILQ_NEXT(curelm, field); \
|
||||||
STAILQ_REMOVE_AFTER(head, curelm, field); \
|
STAILQ_REMOVE_AFTER(head, curelm, field); \
|
||||||
@ -348,8 +432,8 @@ struct { \
|
|||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
#define STAILQ_SWAP(head1, head2, type) do { \
|
#define STAILQ_SWAP(head1, head2, type) do { \
|
||||||
struct type *swap_first = STAILQ_FIRST(head1); \
|
QUEUE_TYPEOF(type) *swap_first = STAILQ_FIRST(head1); \
|
||||||
struct type **swap_last = (head1)->stqh_last; \
|
QUEUE_TYPEOF(type) **swap_last = (head1)->stqh_last; \
|
||||||
STAILQ_FIRST(head1) = STAILQ_FIRST(head2); \
|
STAILQ_FIRST(head1) = STAILQ_FIRST(head2); \
|
||||||
(head1)->stqh_last = (head2)->stqh_last; \
|
(head1)->stqh_last = (head2)->stqh_last; \
|
||||||
STAILQ_FIRST(head2) = swap_first; \
|
STAILQ_FIRST(head2) = swap_first; \
|
||||||
@ -360,6 +444,8 @@ struct { \
|
|||||||
(head2)->stqh_last = &STAILQ_FIRST(head2); \
|
(head2)->stqh_last = &STAILQ_FIRST(head2); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
#define STAILQ_END(head) NULL
|
||||||
|
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* List declarations.
|
* List declarations.
|
||||||
@ -369,6 +455,11 @@ struct name { \
|
|||||||
struct type *lh_first; /* first element */ \
|
struct type *lh_first; /* first element */ \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define LIST_CLASS_HEAD(name, type) \
|
||||||
|
struct name { \
|
||||||
|
class type *lh_first; /* first element */ \
|
||||||
|
}
|
||||||
|
|
||||||
#define LIST_HEAD_INITIALIZER(head) \
|
#define LIST_HEAD_INITIALIZER(head) \
|
||||||
{ NULL }
|
{ NULL }
|
||||||
|
|
||||||
@ -378,11 +469,23 @@ struct { \
|
|||||||
struct type **le_prev; /* address of previous next element */ \
|
struct type **le_prev; /* address of previous next element */ \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define LIST_CLASS_ENTRY(type) \
|
||||||
|
struct { \
|
||||||
|
class type *le_next; /* next element */ \
|
||||||
|
class type **le_prev; /* address of previous next element */ \
|
||||||
|
}
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* List functions.
|
* List functions.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
#if (defined(_KERNEL) && defined(INVARIANTS))
|
#if (defined(_KERNEL) && defined(INVARIANTS))
|
||||||
|
/*
|
||||||
|
* QMD_LIST_CHECK_HEAD(LIST_HEAD *head, LIST_ENTRY NAME)
|
||||||
|
*
|
||||||
|
* If the list is non-empty, validates that the first element of the list
|
||||||
|
* points back at 'head.'
|
||||||
|
*/
|
||||||
#define QMD_LIST_CHECK_HEAD(head, field) do { \
|
#define QMD_LIST_CHECK_HEAD(head, field) do { \
|
||||||
if (LIST_FIRST((head)) != NULL && \
|
if (LIST_FIRST((head)) != NULL && \
|
||||||
LIST_FIRST((head))->field.le_prev != \
|
LIST_FIRST((head))->field.le_prev != \
|
||||||
@ -390,6 +493,12 @@ struct { \
|
|||||||
panic("Bad list head %p first->prev != head", (head)); \
|
panic("Bad list head %p first->prev != head", (head)); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
/*
|
||||||
|
* QMD_LIST_CHECK_NEXT(TYPE *elm, LIST_ENTRY NAME)
|
||||||
|
*
|
||||||
|
* If an element follows 'elm' in the list, validates that the next element
|
||||||
|
* points back at 'elm.'
|
||||||
|
*/
|
||||||
#define QMD_LIST_CHECK_NEXT(elm, field) do { \
|
#define QMD_LIST_CHECK_NEXT(elm, field) do { \
|
||||||
if (LIST_NEXT((elm), field) != NULL && \
|
if (LIST_NEXT((elm), field) != NULL && \
|
||||||
LIST_NEXT((elm), field)->field.le_prev != \
|
LIST_NEXT((elm), field)->field.le_prev != \
|
||||||
@ -397,6 +506,11 @@ struct { \
|
|||||||
panic("Bad link elm %p next->prev != elm", (elm)); \
|
panic("Bad link elm %p next->prev != elm", (elm)); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
/*
|
||||||
|
* QMD_LIST_CHECK_PREV(TYPE *elm, LIST_ENTRY NAME)
|
||||||
|
*
|
||||||
|
* Validates that the previous element (or head of the list) points to 'elm.'
|
||||||
|
*/
|
||||||
#define QMD_LIST_CHECK_PREV(elm, field) do { \
|
#define QMD_LIST_CHECK_PREV(elm, field) do { \
|
||||||
if (*(elm)->field.le_prev != (elm)) \
|
if (*(elm)->field.le_prev != (elm)) \
|
||||||
panic("Bad link elm %p prev->next != elm", (elm)); \
|
panic("Bad link elm %p prev->next != elm", (elm)); \
|
||||||
@ -407,6 +521,23 @@ struct { \
|
|||||||
#define QMD_LIST_CHECK_PREV(elm, field)
|
#define QMD_LIST_CHECK_PREV(elm, field)
|
||||||
#endif /* (_KERNEL && INVARIANTS) */
|
#endif /* (_KERNEL && INVARIANTS) */
|
||||||
|
|
||||||
|
#define LIST_CONCAT(head1, head2, type, field) do { \
|
||||||
|
QUEUE_TYPEOF(type) *curelm = LIST_FIRST(head1); \
|
||||||
|
if (curelm == NULL) { \
|
||||||
|
if ((LIST_FIRST(head1) = LIST_FIRST(head2)) != NULL) { \
|
||||||
|
LIST_FIRST(head2)->field.le_prev = \
|
||||||
|
&LIST_FIRST((head1)); \
|
||||||
|
LIST_INIT(head2); \
|
||||||
|
} \
|
||||||
|
} else if (LIST_FIRST(head2) != NULL) { \
|
||||||
|
while (LIST_NEXT(curelm, field) != NULL) \
|
||||||
|
curelm = LIST_NEXT(curelm, field); \
|
||||||
|
LIST_NEXT(curelm, field) = LIST_FIRST(head2); \
|
||||||
|
LIST_FIRST(head2)->field.le_prev = &LIST_NEXT(curelm, field); \
|
||||||
|
LIST_INIT(head2); \
|
||||||
|
} \
|
||||||
|
} while (0)
|
||||||
|
|
||||||
#define LIST_EMPTY(head) ((head)->lh_first == NULL)
|
#define LIST_EMPTY(head) ((head)->lh_first == NULL)
|
||||||
|
|
||||||
#define LIST_FIRST(head) ((head)->lh_first)
|
#define LIST_FIRST(head) ((head)->lh_first)
|
||||||
@ -462,9 +593,10 @@ struct { \
|
|||||||
|
|
||||||
#define LIST_NEXT(elm, field) ((elm)->field.le_next)
|
#define LIST_NEXT(elm, field) ((elm)->field.le_next)
|
||||||
|
|
||||||
#define LIST_PREV(elm, head, type, field) \
|
#define LIST_PREV(elm, head, type, field) \
|
||||||
((elm)->field.le_prev == &LIST_FIRST((head)) ? NULL : \
|
((elm)->field.le_prev == &LIST_FIRST((head)) ? NULL : \
|
||||||
__containerof((elm)->field.le_prev, struct type, field.le_next))
|
__containerof((elm)->field.le_prev, \
|
||||||
|
QUEUE_TYPEOF(type), field.le_next))
|
||||||
|
|
||||||
#define LIST_REMOVE(elm, field) do { \
|
#define LIST_REMOVE(elm, field) do { \
|
||||||
QMD_SAVELINK(oldnext, (elm)->field.le_next); \
|
QMD_SAVELINK(oldnext, (elm)->field.le_next); \
|
||||||
@ -480,7 +612,7 @@ struct { \
|
|||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
#define LIST_SWAP(head1, head2, type, field) do { \
|
#define LIST_SWAP(head1, head2, type, field) do { \
|
||||||
struct type *swap_tmp = LIST_FIRST((head1)); \
|
QUEUE_TYPEOF(type) *swap_tmp = LIST_FIRST(head1); \
|
||||||
LIST_FIRST((head1)) = LIST_FIRST((head2)); \
|
LIST_FIRST((head1)) = LIST_FIRST((head2)); \
|
||||||
LIST_FIRST((head2)) = swap_tmp; \
|
LIST_FIRST((head2)) = swap_tmp; \
|
||||||
if ((swap_tmp = LIST_FIRST((head1))) != NULL) \
|
if ((swap_tmp = LIST_FIRST((head1))) != NULL) \
|
||||||
@ -489,6 +621,8 @@ struct { \
|
|||||||
swap_tmp->field.le_prev = &LIST_FIRST((head2)); \
|
swap_tmp->field.le_prev = &LIST_FIRST((head2)); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
#define LIST_END(head) NULL
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Tail queue declarations.
|
* Tail queue declarations.
|
||||||
*/
|
*/
|
||||||
@ -499,6 +633,13 @@ struct name { \
|
|||||||
TRACEBUF \
|
TRACEBUF \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define TAILQ_CLASS_HEAD(name, type) \
|
||||||
|
struct name { \
|
||||||
|
class type *tqh_first; /* first element */ \
|
||||||
|
class type **tqh_last; /* addr of last next element */ \
|
||||||
|
TRACEBUF \
|
||||||
|
}
|
||||||
|
|
||||||
#define TAILQ_HEAD_INITIALIZER(head) \
|
#define TAILQ_HEAD_INITIALIZER(head) \
|
||||||
{ NULL, &(head).tqh_first, TRACEBUF_INITIALIZER }
|
{ NULL, &(head).tqh_first, TRACEBUF_INITIALIZER }
|
||||||
|
|
||||||
@ -509,10 +650,23 @@ struct { \
|
|||||||
TRACEBUF \
|
TRACEBUF \
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#define TAILQ_CLASS_ENTRY(type) \
|
||||||
|
struct { \
|
||||||
|
class type *tqe_next; /* next element */ \
|
||||||
|
class type **tqe_prev; /* address of previous next element */ \
|
||||||
|
TRACEBUF \
|
||||||
|
}
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Tail queue functions.
|
* Tail queue functions.
|
||||||
*/
|
*/
|
||||||
#if (defined(_KERNEL) && defined(INVARIANTS))
|
#if (defined(_KERNEL) && defined(INVARIANTS))
|
||||||
|
/*
|
||||||
|
* QMD_TAILQ_CHECK_HEAD(TAILQ_HEAD *head, TAILQ_ENTRY NAME)
|
||||||
|
*
|
||||||
|
* If the tailq is non-empty, validates that the first element of the tailq
|
||||||
|
* points back at 'head.'
|
||||||
|
*/
|
||||||
#define QMD_TAILQ_CHECK_HEAD(head, field) do { \
|
#define QMD_TAILQ_CHECK_HEAD(head, field) do { \
|
||||||
if (!TAILQ_EMPTY(head) && \
|
if (!TAILQ_EMPTY(head) && \
|
||||||
TAILQ_FIRST((head))->field.tqe_prev != \
|
TAILQ_FIRST((head))->field.tqe_prev != \
|
||||||
@ -520,11 +674,22 @@ struct { \
|
|||||||
panic("Bad tailq head %p first->prev != head", (head)); \
|
panic("Bad tailq head %p first->prev != head", (head)); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
/*
|
||||||
|
* QMD_TAILQ_CHECK_TAIL(TAILQ_HEAD *head, TAILQ_ENTRY NAME)
|
||||||
|
*
|
||||||
|
* Validates that the tail of the tailq is a pointer to pointer to NULL.
|
||||||
|
*/
|
||||||
#define QMD_TAILQ_CHECK_TAIL(head, field) do { \
|
#define QMD_TAILQ_CHECK_TAIL(head, field) do { \
|
||||||
if (*(head)->tqh_last != NULL) \
|
if (*(head)->tqh_last != NULL) \
|
||||||
panic("Bad tailq NEXT(%p->tqh_last) != NULL", (head)); \
|
panic("Bad tailq NEXT(%p->tqh_last) != NULL", (head)); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
/*
|
||||||
|
* QMD_TAILQ_CHECK_NEXT(TYPE *elm, TAILQ_ENTRY NAME)
|
||||||
|
*
|
||||||
|
* If an element follows 'elm' in the tailq, validates that the next element
|
||||||
|
* points back at 'elm.'
|
||||||
|
*/
|
||||||
#define QMD_TAILQ_CHECK_NEXT(elm, field) do { \
|
#define QMD_TAILQ_CHECK_NEXT(elm, field) do { \
|
||||||
if (TAILQ_NEXT((elm), field) != NULL && \
|
if (TAILQ_NEXT((elm), field) != NULL && \
|
||||||
TAILQ_NEXT((elm), field)->field.tqe_prev != \
|
TAILQ_NEXT((elm), field)->field.tqe_prev != \
|
||||||
@ -532,6 +697,11 @@ struct { \
|
|||||||
panic("Bad link elm %p next->prev != elm", (elm)); \
|
panic("Bad link elm %p next->prev != elm", (elm)); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
/*
|
||||||
|
* QMD_TAILQ_CHECK_PREV(TYPE *elm, TAILQ_ENTRY NAME)
|
||||||
|
*
|
||||||
|
* Validates that the previous element (or head of the tailq) points to 'elm.'
|
||||||
|
*/
|
||||||
#define QMD_TAILQ_CHECK_PREV(elm, field) do { \
|
#define QMD_TAILQ_CHECK_PREV(elm, field) do { \
|
||||||
if (*(elm)->field.tqe_prev != (elm)) \
|
if (*(elm)->field.tqe_prev != (elm)) \
|
||||||
panic("Bad link elm %p prev->next != elm", (elm)); \
|
panic("Bad link elm %p prev->next != elm", (elm)); \
|
||||||
@ -616,7 +786,7 @@ struct { \
|
|||||||
TAILQ_NEXT((listelm), field) = (elm); \
|
TAILQ_NEXT((listelm), field) = (elm); \
|
||||||
(elm)->field.tqe_prev = &TAILQ_NEXT((listelm), field); \
|
(elm)->field.tqe_prev = &TAILQ_NEXT((listelm), field); \
|
||||||
QMD_TRACE_ELEM(&(elm)->field); \
|
QMD_TRACE_ELEM(&(elm)->field); \
|
||||||
QMD_TRACE_ELEM(&listelm->field); \
|
QMD_TRACE_ELEM(&(listelm)->field); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
#define TAILQ_INSERT_BEFORE(listelm, elm, field) do { \
|
#define TAILQ_INSERT_BEFORE(listelm, elm, field) do { \
|
||||||
@ -626,7 +796,7 @@ struct { \
|
|||||||
*(listelm)->field.tqe_prev = (elm); \
|
*(listelm)->field.tqe_prev = (elm); \
|
||||||
(listelm)->field.tqe_prev = &TAILQ_NEXT((elm), field); \
|
(listelm)->field.tqe_prev = &TAILQ_NEXT((elm), field); \
|
||||||
QMD_TRACE_ELEM(&(elm)->field); \
|
QMD_TRACE_ELEM(&(elm)->field); \
|
||||||
QMD_TRACE_ELEM(&listelm->field); \
|
QMD_TRACE_ELEM(&(listelm)->field); \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
#define TAILQ_INSERT_HEAD(head, elm, field) do { \
|
#define TAILQ_INSERT_HEAD(head, elm, field) do { \
|
||||||
@ -655,11 +825,25 @@ struct { \
|
|||||||
#define TAILQ_LAST(head, headname) \
|
#define TAILQ_LAST(head, headname) \
|
||||||
(*(((struct headname *)((head)->tqh_last))->tqh_last))
|
(*(((struct headname *)((head)->tqh_last))->tqh_last))
|
||||||
|
|
||||||
|
/*
|
||||||
|
* The FAST function is fast in that it causes no data access other
|
||||||
|
* then the access to the head. The standard LAST function above
|
||||||
|
* will cause a data access of both the element you want and
|
||||||
|
* the previous element. FAST is very useful for instances when
|
||||||
|
* you may want to prefetch the last data element.
|
||||||
|
*/
|
||||||
|
#define TAILQ_LAST_FAST(head, type, field) \
|
||||||
|
(TAILQ_EMPTY(head) ? NULL : __containerof((head)->tqh_last, QUEUE_TYPEOF(type), field.tqe_next))
|
||||||
|
|
||||||
#define TAILQ_NEXT(elm, field) ((elm)->field.tqe_next)
|
#define TAILQ_NEXT(elm, field) ((elm)->field.tqe_next)
|
||||||
|
|
||||||
#define TAILQ_PREV(elm, headname, field) \
|
#define TAILQ_PREV(elm, headname, field) \
|
||||||
(*(((struct headname *)((elm)->field.tqe_prev))->tqh_last))
|
(*(((struct headname *)((elm)->field.tqe_prev))->tqh_last))
|
||||||
|
|
||||||
|
#define TAILQ_PREV_FAST(elm, head, type, field) \
|
||||||
|
((elm)->field.tqe_prev == &(head)->tqh_first ? NULL : \
|
||||||
|
__containerof((elm)->field.tqe_prev, QUEUE_TYPEOF(type), field.tqe_next))
|
||||||
|
|
||||||
#define TAILQ_REMOVE(head, elm, field) do { \
|
#define TAILQ_REMOVE(head, elm, field) do { \
|
||||||
QMD_SAVELINK(oldnext, (elm)->field.tqe_next); \
|
QMD_SAVELINK(oldnext, (elm)->field.tqe_next); \
|
||||||
QMD_SAVELINK(oldprev, (elm)->field.tqe_prev); \
|
QMD_SAVELINK(oldprev, (elm)->field.tqe_prev); \
|
||||||
@ -679,8 +863,8 @@ struct { \
|
|||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
#define TAILQ_SWAP(head1, head2, type, field) do { \
|
#define TAILQ_SWAP(head1, head2, type, field) do { \
|
||||||
struct type *swap_first = (head1)->tqh_first; \
|
QUEUE_TYPEOF(type) *swap_first = (head1)->tqh_first; \
|
||||||
struct type **swap_last = (head1)->tqh_last; \
|
QUEUE_TYPEOF(type) **swap_last = (head1)->tqh_last; \
|
||||||
(head1)->tqh_first = (head2)->tqh_first; \
|
(head1)->tqh_first = (head2)->tqh_first; \
|
||||||
(head1)->tqh_last = (head2)->tqh_last; \
|
(head1)->tqh_last = (head2)->tqh_last; \
|
||||||
(head2)->tqh_first = swap_first; \
|
(head2)->tqh_first = swap_first; \
|
||||||
@ -695,4 +879,6 @@ struct { \
|
|||||||
(head2)->tqh_last = &(head2)->tqh_first; \
|
(head2)->tqh_last = &(head2)->tqh_first; \
|
||||||
} while (0)
|
} while (0)
|
||||||
|
|
||||||
|
#define TAILQ_END(head) NULL
|
||||||
|
|
||||||
#endif /* !LIBBSD_SYS_QUEUE_H */
|
#endif /* !LIBBSD_SYS_QUEUE_H */
|
||||||
|
@ -385,7 +385,7 @@ struct { \
|
|||||||
#define RB_PROTOTYPE(name, type, field, cmp) \
|
#define RB_PROTOTYPE(name, type, field, cmp) \
|
||||||
RB_PROTOTYPE_INTERNAL(name, type, field, cmp,)
|
RB_PROTOTYPE_INTERNAL(name, type, field, cmp,)
|
||||||
#define RB_PROTOTYPE_STATIC(name, type, field, cmp) \
|
#define RB_PROTOTYPE_STATIC(name, type, field, cmp) \
|
||||||
RB_PROTOTYPE_INTERNAL(name, type, field, cmp, __unused static)
|
RB_PROTOTYPE_INTERNAL(name, type, field, cmp, LIBBSD_UNUSED static)
|
||||||
#define RB_PROTOTYPE_INTERNAL(name, type, field, cmp, attr) \
|
#define RB_PROTOTYPE_INTERNAL(name, type, field, cmp, attr) \
|
||||||
attr void name##_RB_INSERT_COLOR(struct name *, struct type *); \
|
attr void name##_RB_INSERT_COLOR(struct name *, struct type *); \
|
||||||
attr void name##_RB_REMOVE_COLOR(struct name *, struct type *, struct type *);\
|
attr void name##_RB_REMOVE_COLOR(struct name *, struct type *, struct type *);\
|
||||||
@ -404,7 +404,7 @@ attr struct type *name##_RB_MINMAX(struct name *, int); \
|
|||||||
#define RB_GENERATE(name, type, field, cmp) \
|
#define RB_GENERATE(name, type, field, cmp) \
|
||||||
RB_GENERATE_INTERNAL(name, type, field, cmp,)
|
RB_GENERATE_INTERNAL(name, type, field, cmp,)
|
||||||
#define RB_GENERATE_STATIC(name, type, field, cmp) \
|
#define RB_GENERATE_STATIC(name, type, field, cmp) \
|
||||||
RB_GENERATE_INTERNAL(name, type, field, cmp, __unused static)
|
RB_GENERATE_INTERNAL(name, type, field, cmp, LIBBSD_UNUSED static)
|
||||||
#define RB_GENERATE_INTERNAL(name, type, field, cmp, attr) \
|
#define RB_GENERATE_INTERNAL(name, type, field, cmp, attr) \
|
||||||
attr void \
|
attr void \
|
||||||
name##_RB_INSERT_COLOR(struct name *head, struct type *elm) \
|
name##_RB_INSERT_COLOR(struct name *head, struct type *elm) \
|
||||||
|
@ -58,4 +58,17 @@ time_t _long_to_time(long tlong);
|
|||||||
int _time_to_int(time_t t);
|
int _time_to_int(time_t t);
|
||||||
time_t _int_to_time(int tint);
|
time_t _int_to_time(int tint);
|
||||||
|
|
||||||
|
#if LIBBSD_SYS_TIME_BITS == 32 && LIBBSD_SYS_HAS_TIME64
|
||||||
|
#if defined _TIME_BITS && _TIME_BITS == 64
|
||||||
|
time_t LIBBSD_REDIRECT(_time32_to_time, (int32_t t32), _time32_to_time_time64);
|
||||||
|
int32_t LIBBSD_REDIRECT(_time_to_time32, (time_t t), _time_to_time32_time64);
|
||||||
|
time_t LIBBSD_REDIRECT(_time64_to_time, (int64_t t64), _time64_to_time_time64);
|
||||||
|
int64_t LIBBSD_REDIRECT(_time_to_time64, (time_t t), _time_to_time64_time64);
|
||||||
|
long LIBBSD_REDIRECT(_time_to_long, (time_t t), _time_to_long_time64);
|
||||||
|
time_t LIBBSD_REDIRECT(_long_to_time, (long tlong), _long_to_time_time64);
|
||||||
|
int LIBBSD_REDIRECT(_time_to_int, (time_t t), _time_to_int_time64);
|
||||||
|
time_t LIBBSD_REDIRECT(_int_to_time, (int tint), _int_to_time_time64);
|
||||||
|
#endif
|
||||||
|
#endif
|
||||||
|
|
||||||
#endif /* LIBBSD_TIMECONV_H */
|
#endif /* LIBBSD_TIMECONV_H */
|
||||||
|
@ -47,6 +47,7 @@
|
|||||||
#endif
|
#endif
|
||||||
|
|
||||||
__BEGIN_DECLS
|
__BEGIN_DECLS
|
||||||
|
#if !defined(__APPLE__)
|
||||||
extern int optreset;
|
extern int optreset;
|
||||||
|
|
||||||
#ifdef LIBBSD_OVERLAY
|
#ifdef LIBBSD_OVERLAY
|
||||||
@ -55,11 +56,16 @@ extern int optreset;
|
|||||||
#endif
|
#endif
|
||||||
|
|
||||||
int bsd_getopt(int argc, char * const argv[], const char *shortopts);
|
int bsd_getopt(int argc, char * const argv[], const char *shortopts);
|
||||||
|
#endif
|
||||||
|
|
||||||
mode_t getmode(const void *set, mode_t mode);
|
mode_t getmode(const void *set, mode_t mode);
|
||||||
void *setmode(const char *mode_str);
|
void *setmode(const char *mode_str);
|
||||||
|
|
||||||
|
#if !defined(__GLIBC__) || \
|
||||||
|
!__GLIBC_PREREQ(2, 34) || \
|
||||||
|
!defined(_DEFAULT_SOURCE)
|
||||||
void closefrom(int lowfd);
|
void closefrom(int lowfd);
|
||||||
|
#endif
|
||||||
|
|
||||||
/* Compatibility with sendmail implementations. */
|
/* Compatibility with sendmail implementations. */
|
||||||
#define initsetproctitle(c, a, e) setproctitle_init((c), (a), (e))
|
#define initsetproctitle(c, a, e) setproctitle_init((c), (a), (e))
|
||||||
|
@ -93,14 +93,17 @@
|
|||||||
* existing one in OpenBSD and Freedesktop's libbsd (the former having existed
|
* existing one in OpenBSD and Freedesktop's libbsd (the former having existed
|
||||||
* for over ten years). Despite this incompatibility being reported during
|
* for over ten years). Despite this incompatibility being reported during
|
||||||
* development (see http://gnats.netbsd.org/44977) they still shipped it.
|
* development (see http://gnats.netbsd.org/44977) they still shipped it.
|
||||||
* Even more unfortunately FreeBSD and later MacOS picked up this incompatible
|
* Even more unfortunately FreeBSD and later macOS picked up this incompatible
|
||||||
* implementation.
|
* implementation.
|
||||||
*
|
*
|
||||||
* Provide both implementations and default for now on the historical one to
|
* Provide both implementations and default for now on the historical one to
|
||||||
* avoid breakage, we will switch to the NetBSD one in libbsd 0.10.0 or so.
|
* avoid breakage, we will switch to the NetBSD one in libbsd 0.10.0 or so.
|
||||||
* Define LIBBSD_NETBSD_VIS to switch to the NetBSD one now.
|
* Define LIBBSD_NETBSD_VIS to switch to the NetBSD one now.
|
||||||
|
* Define LIBBSD_OPENBSD_VIS to keep using the OpenBSD one.
|
||||||
*/
|
*/
|
||||||
#ifndef LIBBSD_NETBSD_VIS
|
#if defined(LIBBSD_OPENBSD_VIS)
|
||||||
|
#undef LIBBSD_NETBSD_VIS
|
||||||
|
#elif !defined(LIBBSD_NETBSD_VIS)
|
||||||
#warning "NetBSD added incompatible strnvis() and strnunvis(), please see <bsd/vis.h> for more detils."
|
#warning "NetBSD added incompatible strnvis() and strnunvis(), please see <bsd/vis.h> for more detils."
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
|
@ -50,8 +50,10 @@
|
|||||||
__BEGIN_DECLS
|
__BEGIN_DECLS
|
||||||
wchar_t *fgetwln(FILE *stream, size_t *len);
|
wchar_t *fgetwln(FILE *stream, size_t *len);
|
||||||
|
|
||||||
|
#if !defined(__APPLE__)
|
||||||
size_t wcslcat(wchar_t *dst, const wchar_t *src, size_t size);
|
size_t wcslcat(wchar_t *dst, const wchar_t *src, size_t size);
|
||||||
size_t wcslcpy(wchar_t *dst, const wchar_t *src, size_t size);
|
size_t wcslcpy(wchar_t *dst, const wchar_t *src, size_t size);
|
||||||
|
#endif
|
||||||
__END_DECLS
|
__END_DECLS
|
||||||
|
|
||||||
#endif
|
#endif
|
||||||
|
2
m4/.gitignore
vendored
Normal file
2
m4/.gitignore
vendored
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
*.m4
|
||||||
|
!libbsd*.m4
|
104
m4/libbsd-compiler.m4
Normal file
104
m4/libbsd-compiler.m4
Normal file
@ -0,0 +1,104 @@
|
|||||||
|
# Copyright © 2021 Guillem Jover <guillem@hadrons.org>
|
||||||
|
|
||||||
|
# LIBBSD_CHECK_COMPILER_FLAG
|
||||||
|
# --------------------------
|
||||||
|
AC_DEFUN([LIBBSD_CHECK_COMPILER_FLAG], [
|
||||||
|
AS_VAR_PUSHDEF([libbsd_varname_cache], [libbsd_cv_cflags_$1])
|
||||||
|
AC_CACHE_CHECK([whether $CC accepts $1], [libbsd_varname_cache], [
|
||||||
|
m4_define([libbsd_check_flag], m4_bpatsubst([$1], [^-Wno-], [-W]))
|
||||||
|
AS_VAR_COPY([libbsd_save_CFLAGS], [CFLAGS])
|
||||||
|
AS_VAR_SET([CFLAGS], ["-Werror libbsd_check_flag"])
|
||||||
|
AC_COMPILE_IFELSE([
|
||||||
|
AC_LANG_SOURCE([[]])
|
||||||
|
], [
|
||||||
|
AS_VAR_SET([libbsd_varname_cache], [yes])
|
||||||
|
], [
|
||||||
|
AS_VAR_SET([libbsd_varname_cache], [no])
|
||||||
|
])
|
||||||
|
AS_VAR_COPY([CFLAGS], [libbsd_save_CFLAGS])
|
||||||
|
])
|
||||||
|
AS_VAR_IF([libbsd_varname_cache], [yes], [
|
||||||
|
AS_VAR_APPEND([LIBBSD_COMPILER_FLAGS], [" $1"])
|
||||||
|
])
|
||||||
|
AS_VAR_POPDEF([libbsd_varname_cache])
|
||||||
|
])
|
||||||
|
|
||||||
|
# LIBBSD_HAS_GNU_INIT_ARRAY
|
||||||
|
# -------------------------
|
||||||
|
AC_DEFUN([LIBBSD_HAS_GNU_INIT_ARRAY], [
|
||||||
|
AC_CACHE_CHECK([for GNU .init_array section support],
|
||||||
|
[libbsd_cv_gnu_init_array_support], [
|
||||||
|
AC_RUN_IFELSE([
|
||||||
|
AC_LANG_SOURCE([[
|
||||||
|
static int rc = 1;
|
||||||
|
static void init(int argc) { if (argc == 1) rc = 0; }
|
||||||
|
void (*init_func)(int argc) __attribute__((__section__(".init_array"), __used__)) = init;
|
||||||
|
int main() { return rc; }
|
||||||
|
]])
|
||||||
|
], [
|
||||||
|
libbsd_cv_gnu_init_array_support=yes
|
||||||
|
], [
|
||||||
|
libbsd_cv_gnu_init_array_support=no
|
||||||
|
], [
|
||||||
|
AC_PREPROC_IFELSE([
|
||||||
|
AC_LANG_SOURCE([[
|
||||||
|
/* Look for a known libc that supports .init_array with the GNU extension
|
||||||
|
* to pass main() arguments to the init functions. */
|
||||||
|
#include <stdlib.h>
|
||||||
|
#if defined __GLIBC_PREREQ
|
||||||
|
# if __GLIBC_PREREQ(2, 4)
|
||||||
|
/* glibc supports GNU .init_array since 2.4. */
|
||||||
|
# else
|
||||||
|
# error glibc does not support GNU .init_array
|
||||||
|
# endif
|
||||||
|
#else
|
||||||
|
/*
|
||||||
|
* Basic SysV ABI .init_array support, init functions do not get arguments:
|
||||||
|
* - Bionic since its inception.
|
||||||
|
* - uClibc since 0.9.29.
|
||||||
|
*/
|
||||||
|
# error unknown whether libc supports GNU .init_array
|
||||||
|
#endif
|
||||||
|
]])
|
||||||
|
], [
|
||||||
|
libbsd_cv_gnu_init_array_support=yes
|
||||||
|
], [
|
||||||
|
libbsd_cv_gnu_init_array_support=no
|
||||||
|
])
|
||||||
|
])
|
||||||
|
])
|
||||||
|
AM_CONDITIONAL([BUILD_LIBBSD_CTOR],
|
||||||
|
[test "$libbsd_cv_gnu_init_array_support" = yes])
|
||||||
|
])
|
||||||
|
|
||||||
|
# LIBBSD_SELECT_API(name, desc)
|
||||||
|
# -----------------
|
||||||
|
AC_DEFUN([LIBBSD_SELECT_API], [
|
||||||
|
AS_IF([test -z "$AS_TR_SH([api_$1])"], [
|
||||||
|
AC_MSG_ERROR([missing API selection for $1])
|
||||||
|
], [test "$AS_TR_SH([api_$1])" = "unknown"], [
|
||||||
|
AC_MSG_ERROR([unknown ABI selection for $1])
|
||||||
|
], [test "$AS_TR_SH([api_$1])" = "yes"], [
|
||||||
|
AC_DEFINE(AS_TR_CPP([LIBBSD_API_$1]), [1], [Provide API for $2])
|
||||||
|
], [
|
||||||
|
AC_DEFINE(AS_TR_CPP([LIBBSD_API_$1]), [0])
|
||||||
|
])
|
||||||
|
AM_CONDITIONAL(AS_TR_CPP([API_$1]),
|
||||||
|
[test "x$AS_TR_SH([api_$1])" = "xyes"])
|
||||||
|
])
|
||||||
|
|
||||||
|
# LIBBSD_SELECT_ABI(name, desc)
|
||||||
|
# -----------------
|
||||||
|
AC_DEFUN([LIBBSD_SELECT_ABI], [
|
||||||
|
AS_IF([test -z "$AS_TR_SH([abi_$1])"], [
|
||||||
|
AC_MSG_ERROR([missing ABI selection for $1])
|
||||||
|
], [test "$AS_TR_SH([abi_$1])" = "unknown"], [
|
||||||
|
AC_MSG_ERROR([unknown ABI selection for $1])
|
||||||
|
], [test "$AS_TR_SH([abi_$1])" = "yes"], [
|
||||||
|
AC_DEFINE(AS_TR_CPP([LIBBSD_ABI_$1]), [1], [Provide ABI for $2])
|
||||||
|
], [
|
||||||
|
AC_DEFINE(AS_TR_CPP([LIBBSD_ABI_$1]), [0])
|
||||||
|
])
|
||||||
|
AM_CONDITIONAL(AS_TR_CPP([ABI_$1]),
|
||||||
|
[test "x$AS_TR_SH([abi_$1])" = "xyes"])
|
||||||
|
])
|
57
m4/libbsd-funcs.m4
Normal file
57
m4/libbsd-funcs.m4
Normal file
@ -0,0 +1,57 @@
|
|||||||
|
# Copyright © 2011-2024 Guillem Jover <guillem@hadrons.org>
|
||||||
|
|
||||||
|
# LIBBSD_CHECK_PROGNAME
|
||||||
|
# ---------------------
|
||||||
|
AC_DEFUN([LIBBSD_CHECK_PROGNAME], [
|
||||||
|
AC_MSG_CHECKING([for program_invocation_short_name])
|
||||||
|
AC_LINK_IFELSE([
|
||||||
|
AC_LANG_PROGRAM([[
|
||||||
|
#include <errno.h>
|
||||||
|
]], [[
|
||||||
|
const char *p = program_invocation_short_name;
|
||||||
|
]])
|
||||||
|
], [
|
||||||
|
AC_DEFINE([HAVE_PROGRAM_INVOCATION_SHORT_NAME], [1],
|
||||||
|
[Define to 1 if you have program_invocation_short_name])
|
||||||
|
AC_MSG_RESULT([yes])
|
||||||
|
], [
|
||||||
|
AC_MSG_RESULT([no])
|
||||||
|
])
|
||||||
|
|
||||||
|
AC_MSG_CHECKING([for __progname])
|
||||||
|
AC_LINK_IFELSE([
|
||||||
|
AC_LANG_PROGRAM([[
|
||||||
|
#include <stdio.h>
|
||||||
|
extern char *__progname;
|
||||||
|
]], [[
|
||||||
|
printf("%s", __progname);
|
||||||
|
]])
|
||||||
|
], [
|
||||||
|
AC_DEFINE([HAVE___PROGNAME], [1], [Define to 1 if you have __progname])
|
||||||
|
AC_MSG_RESULT([yes])
|
||||||
|
], [
|
||||||
|
AC_MSG_RESULT([no])
|
||||||
|
])
|
||||||
|
])
|
||||||
|
|
||||||
|
# LIBBSD_CHECK_REGISTER_ATFORK
|
||||||
|
# ----------------------------
|
||||||
|
AC_DEFUN([LIBBSD_CHECK_REGISTER_ATFORK], [
|
||||||
|
AC_MSG_CHECKING([for __register_atfork])
|
||||||
|
AC_LINK_IFELSE([
|
||||||
|
AC_LANG_PROGRAM([[
|
||||||
|
#include <stddef.h>
|
||||||
|
extern void *__dso_handle;
|
||||||
|
extern int __register_atfork(void (*)(void), void(*)(void), void (*)(void), void *);
|
||||||
|
]], [[
|
||||||
|
__register_atfork(NULL, NULL, NULL, __dso_handle);
|
||||||
|
]])
|
||||||
|
], [
|
||||||
|
AC_DEFINE([HAVE___REGISTER_ATFORK], [1],
|
||||||
|
[Define to 1 if you have __register_atfork])
|
||||||
|
AC_MSG_RESULT([yes])
|
||||||
|
], [
|
||||||
|
LIBBSD_LIBS="$LIBBSD_LIBS -pthread"
|
||||||
|
AC_MSG_RESULT([no])
|
||||||
|
])
|
||||||
|
])
|
61
m4/libbsd-large.m4
Normal file
61
m4/libbsd-large.m4
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
# Copyright © 2024 Guillem Jover <guillem@hadrons.org>
|
||||||
|
|
||||||
|
# LIBBSD_SYS_TIME64
|
||||||
|
# -----------------
|
||||||
|
# Check for availability of time64 support.
|
||||||
|
AC_DEFUN([LIBBSD_SYS_TIME64], [
|
||||||
|
# Check the default time_t size.
|
||||||
|
AC_CHECK_SIZEOF([time_t], [], [[
|
||||||
|
#undef _TIME_BITS
|
||||||
|
#include <time.h>
|
||||||
|
]])
|
||||||
|
AS_IF([test $ac_cv_sizeof_time_t -eq 8], [
|
||||||
|
libbsd_sys_time_bits=64
|
||||||
|
], [
|
||||||
|
libbsd_sys_time_bits=32
|
||||||
|
])
|
||||||
|
AC_DEFINE_UNQUOTED([LIBBSD_SYS_TIME_BITS], [$libbsd_sys_time_bits],
|
||||||
|
[The number of bits for the default system time_t ABI])
|
||||||
|
AC_SUBST([LIBBSD_SYS_TIME_BITS], [$libbsd_sys_time_bits])
|
||||||
|
AS_UNSET([ac_cv_sizeof_time_t])
|
||||||
|
AM_CONDITIONAL([LIBBSD_SYS_IS_TIME32], [test "$libbsd_sys_time_bits" -eq 32])
|
||||||
|
|
||||||
|
# Check the whether the system supports 64-bit time_t.
|
||||||
|
AC_CHECK_SIZEOF([time_t], [], [[
|
||||||
|
#define _FILE_OFFSET_BITS 64
|
||||||
|
#define _TIME_BITS 64
|
||||||
|
#include <time.h>
|
||||||
|
]])
|
||||||
|
AS_IF([test $ac_cv_sizeof_time_t -eq 8], [
|
||||||
|
libbsd_sys_has_time64=1
|
||||||
|
], [
|
||||||
|
libbsd_sys_has_time64=0
|
||||||
|
])
|
||||||
|
AC_DEFINE_UNQUOTED([LIBBSD_SYS_HAS_TIME64], [$libbsd_sys_has_time64],
|
||||||
|
[Enable if the system supports 64-bit time_t])
|
||||||
|
AC_SUBST([LIBBSD_SYS_HAS_TIME64], [$libbsd_sys_has_time64])
|
||||||
|
AM_CONDITIONAL([LIBBSD_SYS_HAS_TIME64], [test "$libbsd_sys_has_time64" -eq 1])
|
||||||
|
AS_IF([test "$libbsd_sys_time_bits" -eq 32 && \
|
||||||
|
test "$libbsd_sys_has_time64" -eq 1], [
|
||||||
|
abi_time64=yes
|
||||||
|
], [
|
||||||
|
abi_time64=no
|
||||||
|
])
|
||||||
|
LIBBSD_SELECT_ABI([time64], [explicit time64 time_t support])
|
||||||
|
|
||||||
|
AC_CHECK_SIZEOF([off_t], [], [[
|
||||||
|
#define _FILE_OFFSET_BITS 64
|
||||||
|
#include <sys/types.h>
|
||||||
|
]])
|
||||||
|
AS_IF([test $ac_cv_sizeof_off_t = 8], [
|
||||||
|
libbsd_sys_has_lfs=1
|
||||||
|
], [
|
||||||
|
libbsd_sys_has_lfs=0
|
||||||
|
])
|
||||||
|
|
||||||
|
AS_IF([test $libbsd_sys_has_lfs -eq 1 && \
|
||||||
|
test $libbsd_sys_time_bits -eq 32 && \
|
||||||
|
test $ac_cv_sizeof_time_t -eq 8], [
|
||||||
|
AC_DEFINE([_TIME_BITS], [64], [Enable 64-bit time_t support])
|
||||||
|
])
|
||||||
|
])
|
27
m4/libbsd-linker.m4
Normal file
27
m4/libbsd-linker.m4
Normal file
@ -0,0 +1,27 @@
|
|||||||
|
# Copyright © 2019, 2022 Guillem Jover <guillem@hadrons.org>
|
||||||
|
|
||||||
|
# LIBBSD_LINKER_VERSION_SCRIPT
|
||||||
|
# ----------------------------
|
||||||
|
AC_DEFUN([LIBBSD_LINKER_VERSION_SCRIPT], [
|
||||||
|
AC_CACHE_CHECK([if ld supports --version-script flag],
|
||||||
|
[libbsd_cv_version_script], [
|
||||||
|
echo "{ global: symbol; local: *; };" >conftest.map
|
||||||
|
save_LDFLAGS=$LDFLAGS
|
||||||
|
LDFLAGS="$LDFLAGS -Wl,--version-script=conftest.map"
|
||||||
|
AC_LINK_IFELSE([
|
||||||
|
AC_LANG_PROGRAM([[
|
||||||
|
extern int symbol(void);
|
||||||
|
int symbol(void) { return 0; }
|
||||||
|
]], [[
|
||||||
|
]])
|
||||||
|
], [
|
||||||
|
libbsd_cv_version_script=yes
|
||||||
|
], [
|
||||||
|
libbsd_cv_version_script=no
|
||||||
|
])
|
||||||
|
LDFLAGS="$save_LDFLAGS"
|
||||||
|
rm -f conftest.map
|
||||||
|
])
|
||||||
|
AM_CONDITIONAL([HAVE_LINKER_VERSION_SCRIPT],
|
||||||
|
[test "x$libbsd_cv_version_script" = "xyes"])
|
||||||
|
])
|
1
man/LIST_CLASS_ENTRY.3bsd
Normal file
1
man/LIST_CLASS_ENTRY.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
1
man/LIST_CLASS_HEAD.3bsd
Normal file
1
man/LIST_CLASS_HEAD.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
334
man/Makefile.am
334
man/Makefile.am
@ -2,18 +2,20 @@
|
|||||||
|
|
||||||
EXTRA_DIST = \
|
EXTRA_DIST = \
|
||||||
mdX.3bsd \
|
mdX.3bsd \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
CLEANFILES = \
|
CLEANFILES = \
|
||||||
md5.3bsd \
|
md5.3bsd \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
SED_MD5_SUBST = -e 's/mdX/md5/g' -e 's/mdY/md4/g' -e 's/MDX/MD5/g'
|
SED_MD5_SUBST = -e 's/mdX/md5/g' -e 's/mdY/md4/g' -e 's/MDX/MD5/g'
|
||||||
|
|
||||||
md5.3bsd: $(srcdir)/mdX.3bsd
|
md5.3bsd: $(srcdir)/mdX.3bsd
|
||||||
$(AM_V_GEN) sed $(SED_MD5_SUBST) $< > $@
|
$(AM_V_GEN) $(SED) $(SED_MD5_SUBST) $< >$@
|
||||||
|
|
||||||
dist_man_MANS = \
|
dist_man_MANS = \
|
||||||
|
LIST_CLASS_ENTRY.3bsd \
|
||||||
|
LIST_CLASS_HEAD.3bsd \
|
||||||
LIST_EMPTY.3bsd \
|
LIST_EMPTY.3bsd \
|
||||||
LIST_ENTRY.3bsd \
|
LIST_ENTRY.3bsd \
|
||||||
LIST_FIRST.3bsd \
|
LIST_FIRST.3bsd \
|
||||||
@ -54,6 +56,8 @@ dist_man_MANS = \
|
|||||||
RB_REMOVE.3bsd \
|
RB_REMOVE.3bsd \
|
||||||
RB_RIGHT.3bsd \
|
RB_RIGHT.3bsd \
|
||||||
RB_ROOT.3bsd \
|
RB_ROOT.3bsd \
|
||||||
|
SLIST_CLASS_ENTRY.3bsd \
|
||||||
|
SLIST_CLASS_HEAD.3bsd \
|
||||||
SLIST_EMPTY.3bsd \
|
SLIST_EMPTY.3bsd \
|
||||||
SLIST_ENTRY.3bsd \
|
SLIST_ENTRY.3bsd \
|
||||||
SLIST_FIRST.3bsd \
|
SLIST_FIRST.3bsd \
|
||||||
@ -70,6 +74,7 @@ dist_man_MANS = \
|
|||||||
SLIST_REMOVE.3bsd \
|
SLIST_REMOVE.3bsd \
|
||||||
SLIST_REMOVE_AFTER.3bsd \
|
SLIST_REMOVE_AFTER.3bsd \
|
||||||
SLIST_REMOVE_HEAD.3bsd \
|
SLIST_REMOVE_HEAD.3bsd \
|
||||||
|
SLIST_REMOVE_PREVPTR.3bsd \
|
||||||
SLIST_SWAP.3bsd \
|
SLIST_SWAP.3bsd \
|
||||||
SPLAY_EMPTY.3bsd \
|
SPLAY_EMPTY.3bsd \
|
||||||
SPLAY_ENTRY.3bsd \
|
SPLAY_ENTRY.3bsd \
|
||||||
@ -88,6 +93,8 @@ dist_man_MANS = \
|
|||||||
SPLAY_REMOVE.3bsd \
|
SPLAY_REMOVE.3bsd \
|
||||||
SPLAY_RIGHT.3bsd \
|
SPLAY_RIGHT.3bsd \
|
||||||
SPLAY_ROOT.3bsd \
|
SPLAY_ROOT.3bsd \
|
||||||
|
STAILQ_CLASS_ENTRY.3bsd \
|
||||||
|
STAILQ_CLASS_HEAD.3bsd \
|
||||||
STAILQ_CONCAT.3bsd \
|
STAILQ_CONCAT.3bsd \
|
||||||
STAILQ_EMPTY.3bsd \
|
STAILQ_EMPTY.3bsd \
|
||||||
STAILQ_ENTRY.3bsd \
|
STAILQ_ENTRY.3bsd \
|
||||||
@ -108,6 +115,8 @@ dist_man_MANS = \
|
|||||||
STAILQ_REMOVE_AFTER.3bsd \
|
STAILQ_REMOVE_AFTER.3bsd \
|
||||||
STAILQ_REMOVE_HEAD.3bsd \
|
STAILQ_REMOVE_HEAD.3bsd \
|
||||||
STAILQ_SWAP.3bsd \
|
STAILQ_SWAP.3bsd \
|
||||||
|
TAILQ_CLASS_ENTRY.3bsd \
|
||||||
|
TAILQ_CLASS_HEAD.3bsd \
|
||||||
TAILQ_CONCAT.3bsd \
|
TAILQ_CONCAT.3bsd \
|
||||||
TAILQ_EMPTY.3bsd \
|
TAILQ_EMPTY.3bsd \
|
||||||
TAILQ_ENTRY.3bsd \
|
TAILQ_ENTRY.3bsd \
|
||||||
@ -132,13 +141,6 @@ dist_man_MANS = \
|
|||||||
TAILQ_PREV.3bsd \
|
TAILQ_PREV.3bsd \
|
||||||
TAILQ_REMOVE.3bsd \
|
TAILQ_REMOVE.3bsd \
|
||||||
TAILQ_SWAP.3bsd \
|
TAILQ_SWAP.3bsd \
|
||||||
TIMESPEC_TO_TIMEVAL.3bsd \
|
|
||||||
TIMEVAL_TO_TIMESPEC.3bsd \
|
|
||||||
arc4random.3bsd \
|
|
||||||
arc4random_addrandom.3bsd \
|
|
||||||
arc4random_buf.3bsd \
|
|
||||||
arc4random_stir.3bsd \
|
|
||||||
arc4random_uniform.3bsd \
|
|
||||||
be16dec.3bsd \
|
be16dec.3bsd \
|
||||||
be16enc.3bsd \
|
be16enc.3bsd \
|
||||||
be32dec.3bsd \
|
be32dec.3bsd \
|
||||||
@ -157,27 +159,6 @@ dist_man_MANS = \
|
|||||||
bitstr_size.3bsd \
|
bitstr_size.3bsd \
|
||||||
bitstring.3bsd \
|
bitstring.3bsd \
|
||||||
byteorder.3bsd \
|
byteorder.3bsd \
|
||||||
closefrom.3bsd \
|
|
||||||
dehumanize_number.3bsd \
|
|
||||||
errc.3bsd \
|
|
||||||
expand_number.3bsd \
|
|
||||||
explicit_bzero.3bsd \
|
|
||||||
fgetln.3bsd \
|
|
||||||
fgetwln.3bsd \
|
|
||||||
flopen.3bsd \
|
|
||||||
freezero.3bsd \
|
|
||||||
fmtcheck.3bsd \
|
|
||||||
fparseln.3bsd \
|
|
||||||
fpurge.3bsd \
|
|
||||||
funopen.3bsd \
|
|
||||||
getbsize.3bsd \
|
|
||||||
getmode.3bsd \
|
|
||||||
getpeereid.3bsd \
|
|
||||||
getprogname.3bsd \
|
|
||||||
gid_from_group.3bsd \
|
|
||||||
group_from_gid.3bsd \
|
|
||||||
heapsort.3bsd \
|
|
||||||
humanize_number.3bsd \
|
|
||||||
le16dec.3bsd \
|
le16dec.3bsd \
|
||||||
le16enc.3bsd \
|
le16enc.3bsd \
|
||||||
le32dec.3bsd \
|
le32dec.3bsd \
|
||||||
@ -185,61 +166,270 @@ dist_man_MANS = \
|
|||||||
le64dec.3bsd \
|
le64dec.3bsd \
|
||||||
le64enc.3bsd \
|
le64enc.3bsd \
|
||||||
libbsd.7 \
|
libbsd.7 \
|
||||||
md5.3bsd \
|
|
||||||
mergesort.3bsd \
|
|
||||||
nlist.3bsd \
|
|
||||||
pidfile.3bsd \
|
|
||||||
pidfile_close.3bsd \
|
|
||||||
pidfile_open.3bsd \
|
|
||||||
pidfile_remove.3bsd \
|
|
||||||
pidfile_write.3bsd \
|
|
||||||
pwcache.3bsd \
|
|
||||||
queue.3bsd \
|
queue.3bsd \
|
||||||
radixsort.3bsd \
|
|
||||||
readpassphrase.3bsd \
|
|
||||||
reallocarray.3bsd \
|
|
||||||
reallocf.3bsd \
|
|
||||||
recallocarray.3bsd \
|
|
||||||
setmode.3bsd \
|
|
||||||
setproctitle.3bsd \
|
|
||||||
setproctitle_init.3bsd \
|
|
||||||
setprogname.3bsd \
|
|
||||||
sl_add.3bsd \
|
|
||||||
sl_delete.3bsd \
|
|
||||||
sl_find.3bsd \
|
|
||||||
sl_free.3bsd \
|
|
||||||
sl_init.3bsd \
|
|
||||||
sradixsort.3bsd \
|
|
||||||
stringlist.3bsd \
|
|
||||||
strlcat.3bsd \
|
|
||||||
strlcpy.3bsd \
|
|
||||||
strmode.3bsd \
|
|
||||||
strnstr.3bsd \
|
|
||||||
strnunvis.3bsd \
|
|
||||||
strnvis.3bsd \
|
|
||||||
strtoi.3bsd \
|
|
||||||
strtonum.3bsd \
|
|
||||||
strtou.3bsd \
|
|
||||||
strunvis.3bsd \
|
|
||||||
strvis.3bsd \
|
|
||||||
strvisx.3bsd \
|
|
||||||
timeradd.3bsd \
|
timeradd.3bsd \
|
||||||
timerclear.3bsd \
|
timerclear.3bsd \
|
||||||
timercmp.3bsd \
|
timercmp.3bsd \
|
||||||
timerisset.3bsd \
|
timerisset.3bsd \
|
||||||
timersub.3bsd \
|
timersub.3bsd \
|
||||||
timespec.3bsd \
|
|
||||||
timespecadd.3bsd \
|
timespecadd.3bsd \
|
||||||
timespecclear.3bsd \
|
timespecclear.3bsd \
|
||||||
timespeccmp.3bsd \
|
timespeccmp.3bsd \
|
||||||
timespecisset.3bsd \
|
timespecisset.3bsd \
|
||||||
timespecsub.3bsd \
|
timespecsub.3bsd \
|
||||||
timeval.3bsd \
|
|
||||||
tree.3bsd \
|
tree.3bsd \
|
||||||
|
# EOL
|
||||||
|
|
||||||
|
if API_TIME_MACROS
|
||||||
|
dist_man_MANS += \
|
||||||
|
TIMESPEC_TO_TIMEVAL.3bsd \
|
||||||
|
TIMEVAL_TO_TIMESPEC.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_ACCMODE
|
||||||
|
dist_man_MANS += \
|
||||||
|
getmode.3bsd \
|
||||||
|
setmode.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_ARC4RANDOM
|
||||||
|
dist_man_MANS += \
|
||||||
|
arc4random.3bsd \
|
||||||
|
arc4random_addrandom.3bsd \
|
||||||
|
arc4random_buf.3bsd \
|
||||||
|
arc4random_stir.3bsd \
|
||||||
|
arc4random_uniform.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_CLOSEFROM
|
||||||
|
dist_man_MANS += \
|
||||||
|
closefrom.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_ERRC
|
||||||
|
dist_man_MANS += \
|
||||||
|
errc.3bsd \
|
||||||
|
verrc.3bsd \
|
||||||
|
vwarnc.3bsd \
|
||||||
|
warnc.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_EXPAND_NUMBER
|
||||||
|
dist_man_MANS += \
|
||||||
|
expand_number.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_EXPLICIT_BZERO
|
||||||
|
dist_man_MANS += \
|
||||||
|
explicit_bzero.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FGETLN
|
||||||
|
dist_man_MANS += \
|
||||||
|
fgetln.3bsd \
|
||||||
|
fgetwln.3bsd \
|
||||||
|
fparseln.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FLOPEN
|
||||||
|
dist_man_MANS += \
|
||||||
|
flopen.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FMTCHECK
|
||||||
|
dist_man_MANS += \
|
||||||
|
fmtcheck.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FPURGE
|
||||||
|
dist_man_MANS += \
|
||||||
|
fpurge.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FREEZERO
|
||||||
|
dist_man_MANS += \
|
||||||
|
freezero.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FUNOPEN
|
||||||
|
dist_man_MANS += \
|
||||||
|
funopen.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_GETBSIZE
|
||||||
|
dist_man_MANS += \
|
||||||
|
getbsize.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_GETPEEREID
|
||||||
|
dist_man_MANS += \
|
||||||
|
getpeereid.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_HUMANIZE_NUMBER
|
||||||
|
dist_man_MANS += \
|
||||||
|
dehumanize_number.3bsd \
|
||||||
|
humanize_number.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_MD5
|
||||||
|
dist_man_MANS += \
|
||||||
|
md5.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_NLIST
|
||||||
|
dist_man_MANS += \
|
||||||
|
nlist.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PIDFILE
|
||||||
|
dist_man_MANS += \
|
||||||
|
pidfile.3bsd \
|
||||||
|
pidfile_close.3bsd \
|
||||||
|
pidfile_open.3bsd \
|
||||||
|
pidfile_remove.3bsd \
|
||||||
|
pidfile_write.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PROCTITLE
|
||||||
|
dist_man_MANS += \
|
||||||
|
setproctitle.3bsd \
|
||||||
|
setproctitle_init.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PROGNAME
|
||||||
|
dist_man_MANS += \
|
||||||
|
getprogname.3bsd \
|
||||||
|
setprogname.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PWCACHE
|
||||||
|
dist_man_MANS += \
|
||||||
|
pwcache.3bsd \
|
||||||
|
gid_from_group.3bsd \
|
||||||
uid_from_user.3bsd \
|
uid_from_user.3bsd \
|
||||||
unvis.3bsd \
|
# EOL
|
||||||
|
|
||||||
|
if ABI_NAME_FROM_ID
|
||||||
|
dist_man_MANS += \
|
||||||
|
group_from_gid.3bsd \
|
||||||
user_from_uid.3bsd \
|
user_from_uid.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_READPASSPHRASE
|
||||||
|
dist_man_MANS += \
|
||||||
|
readpassphrase.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_REALLOCARRAY
|
||||||
|
dist_man_MANS += \
|
||||||
|
reallocarray.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_REALLOCF
|
||||||
|
dist_man_MANS += \
|
||||||
|
reallocf.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_RECALLOCARRAY
|
||||||
|
dist_man_MANS += \
|
||||||
|
recallocarray.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_SORT
|
||||||
|
dist_man_MANS += \
|
||||||
|
heapsort.3bsd \
|
||||||
|
mergesort.3bsd \
|
||||||
|
radixsort.3bsd \
|
||||||
|
sradixsort.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRINGLIST
|
||||||
|
dist_man_MANS += \
|
||||||
|
sl_add.3bsd \
|
||||||
|
sl_delete.3bsd \
|
||||||
|
sl_find.3bsd \
|
||||||
|
sl_free.3bsd \
|
||||||
|
sl_init.3bsd \
|
||||||
|
stringlist.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRL
|
||||||
|
dist_man_MANS += \
|
||||||
|
strlcat.3bsd \
|
||||||
|
strlcpy.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRMODE
|
||||||
|
dist_man_MANS += \
|
||||||
|
strmode.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRNSTR
|
||||||
|
dist_man_MANS += \
|
||||||
|
strnstr.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRTOX
|
||||||
|
dist_man_MANS += \
|
||||||
|
strtoi.3bsd \
|
||||||
|
strtou.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRTONUM
|
||||||
|
dist_man_MANS += \
|
||||||
|
strtonum.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_VIS
|
||||||
|
dist_man_MANS += \
|
||||||
|
strnunvis.3bsd \
|
||||||
|
strnvis.3bsd \
|
||||||
|
strunvis.3bsd \
|
||||||
|
strvis.3bsd \
|
||||||
|
strvisx.3bsd \
|
||||||
|
unvis.3bsd \
|
||||||
vis.3bsd \
|
vis.3bsd \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_WCSL
|
||||||
|
dist_man_MANS += \
|
||||||
wcslcat.3bsd \
|
wcslcat.3bsd \
|
||||||
wcslcpy.3bsd \
|
wcslcpy.3bsd \
|
||||||
$(nil)
|
# EOL
|
||||||
|
endif
|
||||||
|
1
man/SLIST_CLASS_ENTRY.3bsd
Normal file
1
man/SLIST_CLASS_ENTRY.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
1
man/SLIST_CLASS_HEAD.3bsd
Normal file
1
man/SLIST_CLASS_HEAD.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
1
man/SLIST_REMOVE_PREVPTR.3bsd
Normal file
1
man/SLIST_REMOVE_PREVPTR.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
1
man/STAILQ_CLASS_ENTRY.3bsd
Normal file
1
man/STAILQ_CLASS_ENTRY.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
1
man/STAILQ_CLASS_HEAD.3bsd
Normal file
1
man/STAILQ_CLASS_HEAD.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
1
man/TAILQ_CLASS_ENTRY.3bsd
Normal file
1
man/TAILQ_CLASS_ENTRY.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
1
man/TAILQ_CLASS_HEAD.3bsd
Normal file
1
man/TAILQ_CLASS_HEAD.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/queue.3bsd
|
@ -1 +1,100 @@
|
|||||||
.so man3/timeval.3bsd
|
.\" $NetBSD: timeval.3,v 1.12 2011/04/12 08:39:26 jruoho Exp $
|
||||||
|
.\"
|
||||||
|
.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
|
||||||
|
.\" All rights reserved.
|
||||||
|
.\"
|
||||||
|
.\" This code is derived from software contributed to The NetBSD Foundation
|
||||||
|
.\" by Jukka Ruohonen.
|
||||||
|
.\"
|
||||||
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
|
.\" modification, are permitted provided that the following conditions
|
||||||
|
.\" are met:
|
||||||
|
.\" 1. Redistributions of source code must retain the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer.
|
||||||
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
.\" notice, this list of conditions and the following disclaimer in the
|
||||||
|
.\" documentation and/or other materials provided with the distribution.
|
||||||
|
.\"
|
||||||
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
||||||
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
||||||
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
||||||
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||||
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||||
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||||
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
.\"
|
||||||
|
.Dd April 12, 2011
|
||||||
|
.Dt TIMEVAL_TO_TIMESPEC 3bsd
|
||||||
|
.Os
|
||||||
|
.Sh NAME
|
||||||
|
.Nm TIMEVAL_TO_TIMESPEC ,
|
||||||
|
.Nm TIMESPEC_TO_TIMEVAL
|
||||||
|
.Nd time structures conversion macros
|
||||||
|
.Sh LIBRARY
|
||||||
|
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
||||||
|
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
||||||
|
.Lb libbsd
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.In sys/time.h
|
||||||
|
(See
|
||||||
|
.Xr libbsd 7
|
||||||
|
for include usage.)
|
||||||
|
.Ft void
|
||||||
|
.Fn TIMEVAL_TO_TIMESPEC "struct timeval *tv" "struct timespec *ts"
|
||||||
|
.Ft void
|
||||||
|
.Fn TIMESPEC_TO_TIMEVAL "struct timeval *tv" "struct timespec *ts"
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
The
|
||||||
|
.Va timeval
|
||||||
|
structure represents elapsed time, in whole seconds,
|
||||||
|
and the rest of the elapsed time in microseconds.
|
||||||
|
.Pp
|
||||||
|
The
|
||||||
|
.Va timespec
|
||||||
|
structure represents elapsed time, in whole seconds,
|
||||||
|
and the rest of the elapsed time in nanoseconds.
|
||||||
|
.Pp
|
||||||
|
A microsecond is equal to one millionth of a second,
|
||||||
|
1000 nanoseconds, or 1/1000 milliseconds.
|
||||||
|
To ease the conversions, the macros
|
||||||
|
.Fn TIMEVAL_TO_TIMESPEC
|
||||||
|
and
|
||||||
|
.Fn TIMESPEC_TO_TIMEVAL
|
||||||
|
can be used to convert between
|
||||||
|
.Em struct timeval
|
||||||
|
and
|
||||||
|
.Em struct timespec .
|
||||||
|
.Sh EXAMPLES
|
||||||
|
It can be stressed that the traditional
|
||||||
|
.Tn UNIX
|
||||||
|
.Va timeval
|
||||||
|
and
|
||||||
|
.Va timespec
|
||||||
|
structures represent elapsed time, measured by the system clock.
|
||||||
|
The following sketch implements a function suitable
|
||||||
|
for use in a context where the
|
||||||
|
.Va timespec
|
||||||
|
structure is required for a conditional timeout:
|
||||||
|
.Bd -literal -offset indent
|
||||||
|
static void
|
||||||
|
example(struct timespec *spec, time_t minutes)
|
||||||
|
{
|
||||||
|
struct timeval elapsed;
|
||||||
|
|
||||||
|
(void)gettimeofday(&elapsed, NULL);
|
||||||
|
|
||||||
|
TIMEVAL_TO_TIMESPEC(&elapsed, spec);
|
||||||
|
|
||||||
|
/* Add the offset for timeout in minutes. */
|
||||||
|
spec->tv_sec = spec->tv_sec + minutes * 60;
|
||||||
|
}
|
||||||
|
.Ed
|
||||||
|
.Pp
|
||||||
|
A better alternative would use the more precise
|
||||||
|
.Xr clock_gettime 2 .
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr timeradd 3bsd
|
||||||
|
@ -1 +1 @@
|
|||||||
.so man3/timeval.3bsd
|
.so man3/TIMESPEC_TO_TIMEVAL.3bsd
|
||||||
|
@ -1,8 +1,11 @@
|
|||||||
.\" $OpenBSD: arc4random.3,v 1.34 2014/07/19 16:11:16 naddy Exp $
|
.\" $NetBSD: arc4random.3,v 1.21 2016/07/15 21:19:19 wiz Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de>
|
.\" Copyright (c) 2014 The NetBSD Foundation, Inc.
|
||||||
.\" All rights reserved.
|
.\" All rights reserved.
|
||||||
.\"
|
.\"
|
||||||
|
.\" This code is derived from software contributed to The NetBSD Foundation
|
||||||
|
.\" by Taylor R. Campbell.
|
||||||
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
.\" modification, are permitted provided that the following conditions
|
.\" modification, are permitted provided that the following conditions
|
||||||
.\" are met:
|
.\" are met:
|
||||||
@ -11,35 +14,29 @@
|
|||||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||||
.\" notice, this list of conditions and the following disclaimer in the
|
.\" notice, this list of conditions and the following disclaimer in the
|
||||||
.\" documentation and/or other materials provided with the distribution.
|
.\" documentation and/or other materials provided with the distribution.
|
||||||
.\" 3. All advertising materials mentioning features or use of this software
|
|
||||||
.\" must display the following acknowledgement:
|
|
||||||
.\" This product includes software developed by Niels Provos.
|
|
||||||
.\" 4. The name of the author may not be used to endorse or promote products
|
|
||||||
.\" derived from this software without specific prior written permission.
|
|
||||||
.\"
|
.\"
|
||||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
||||||
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
||||||
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
||||||
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||||
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.\" Manual page, using -mandoc macros
|
.Dd November 16, 2014
|
||||||
.\"
|
.Dt arc4random 3bsd
|
||||||
.Dd $Mdocdate: July 19 2014 $
|
|
||||||
.Dt ARC4RANDOM 3bsd
|
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm arc4random ,
|
.Nm arc4random ,
|
||||||
.Nm arc4random_buf ,
|
|
||||||
.Nm arc4random_uniform ,
|
.Nm arc4random_uniform ,
|
||||||
|
.Nm arc4random_buf ,
|
||||||
.Nm arc4random_stir ,
|
.Nm arc4random_stir ,
|
||||||
.Nm arc4random_addrandom
|
.Nm arc4random_addrandom
|
||||||
.Nd arc4 random number generator
|
.Nd random number generator
|
||||||
.Sh LIBRARY
|
.Sh LIBRARY
|
||||||
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
||||||
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
||||||
@ -51,83 +48,208 @@
|
|||||||
for include usage.)
|
for include usage.)
|
||||||
.Ft uint32_t
|
.Ft uint32_t
|
||||||
.Fn arc4random "void"
|
.Fn arc4random "void"
|
||||||
.Ft void
|
|
||||||
.Fn arc4random_buf "void *buf" "size_t nbytes"
|
|
||||||
.Ft uint32_t
|
.Ft uint32_t
|
||||||
.Fn arc4random_uniform "uint32_t upper_bound"
|
.Fn arc4random_uniform "uint32_t bound"
|
||||||
|
.Ft void
|
||||||
|
.Fn arc4random_buf "void *buf" "size_t len"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn arc4random_stir "void"
|
.Fn arc4random_stir "void"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn arc4random_addrandom "unsigned char *dat" "int datlen"
|
.Fn arc4random_addrandom "unsigned char *buf" "int len"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
This family of functions provides higher quality data than those
|
The
|
||||||
described in
|
.Nm
|
||||||
.Xr rand 3 ,
|
family of functions provides a cryptographic pseudorandom number
|
||||||
|
generator automatically seeded from the system entropy pool and safe to
|
||||||
|
use from multiple threads.
|
||||||
|
.Nm
|
||||||
|
is designed to prevent an adversary from guessing outputs,
|
||||||
|
unlike
|
||||||
|
.Xr rand 3
|
||||||
|
and
|
||||||
.Xr random 3 ,
|
.Xr random 3 ,
|
||||||
and
|
and is faster and more convenient than reading from
|
||||||
.Xr rand48 3 .
|
.Pa /dev/urandom
|
||||||
|
directly.
|
||||||
.Pp
|
.Pp
|
||||||
Use of these functions is encouraged for almost all random number
|
|
||||||
consumption because the other interfaces are deficient in either
|
|
||||||
quality, portability, standardization, or availability.
|
|
||||||
These functions can be called in almost all coding environments,
|
|
||||||
including
|
|
||||||
.Xr pthreads 3
|
|
||||||
and
|
|
||||||
.Xr chroot 2 .
|
|
||||||
.Pp
|
|
||||||
High quality 32-bit pseudo-random numbers are generated very quickly.
|
|
||||||
On each call, a cryptographic pseudo-random number generator is used
|
|
||||||
to generate a new result.
|
|
||||||
One data pool is used for all consumers in a process, so that consumption
|
|
||||||
under program flow can act as additional stirring.
|
|
||||||
The subsystem is re-seeded from the kernel random number subsystem using
|
|
||||||
.Xr getentropy 2
|
|
||||||
on a regular basis, and also upon
|
|
||||||
.Xr fork 2 .
|
|
||||||
.Pp
|
|
||||||
The
|
|
||||||
.Fn arc4random
|
.Fn arc4random
|
||||||
function returns a single 32-bit value.
|
returns an integer in [0, 2^32) chosen independently with uniform
|
||||||
.Pp
|
distribution.
|
||||||
The
|
|
||||||
.Fn arc4random_buf
|
|
||||||
function fills the region
|
|
||||||
.Fa buf
|
|
||||||
of length
|
|
||||||
.Fa nbytes
|
|
||||||
with random data.
|
|
||||||
.Pp
|
.Pp
|
||||||
.Fn arc4random_uniform
|
.Fn arc4random_uniform
|
||||||
will return a single 32-bit value, uniformly distributed but less than
|
returns an integer in [0,
|
||||||
.Fa upper_bound .
|
.Fa bound )
|
||||||
This is recommended over constructions like
|
chosen independently with uniform distribution.
|
||||||
.Dq Li arc4random() % upper_bound
|
|
||||||
as it avoids "modulo bias" when the upper bound is not a power of two.
|
|
||||||
In the worst case, this function may consume multiple iterations
|
|
||||||
to ensure uniformity; see the source code to understand the problem
|
|
||||||
and solution.
|
|
||||||
.Pp
|
.Pp
|
||||||
|
.Fn arc4random_buf
|
||||||
|
stores
|
||||||
|
.Fa len
|
||||||
|
bytes into the memory pointed to by
|
||||||
|
.Fa buf ,
|
||||||
|
each byte chosen independently from [0, 256) with uniform
|
||||||
|
distribution.
|
||||||
|
.Pp
|
||||||
|
.Fn arc4random_stir
|
||||||
|
draws entropy from the operating system and incorporates it into the
|
||||||
|
library's PRNG state to influence future outputs.
|
||||||
|
.Pp
|
||||||
|
.Fn arc4random_addrandom
|
||||||
|
incorporates
|
||||||
|
.Fa len
|
||||||
|
bytes, which must be nonnegative, from the buffer
|
||||||
|
.Fa buf ,
|
||||||
|
into the library's PRNG state to influence future outputs.
|
||||||
|
.Pp
|
||||||
|
It is not necessary for an application to call
|
||||||
|
.Fn arc4random_stir
|
||||||
|
or
|
||||||
|
.Fn arc4random_addrandom
|
||||||
|
before calling other
|
||||||
|
.Nm
|
||||||
|
functions.
|
||||||
|
The first call to any
|
||||||
|
.Nm
|
||||||
|
function will initialize the PRNG state unpredictably from the system
|
||||||
|
entropy pool.
|
||||||
|
.Sh SECURITY MODEL
|
||||||
The
|
The
|
||||||
.Fn arc4random_stir
|
.Nm
|
||||||
function reads data from
|
functions provide the following security properties against three
|
||||||
.Xr getentropy 2
|
different classes of attackers, assuming enough entropy is provided by
|
||||||
and uses it to re-seed the subsystem via
|
the operating system:
|
||||||
.Fn arc4random_addrandom .
|
.Bl -enum -offset abcd
|
||||||
|
.It
|
||||||
|
An attacker who has seen some outputs of any of the
|
||||||
|
.Nm
|
||||||
|
functions cannot predict past or future unseen outputs.
|
||||||
|
.It
|
||||||
|
An attacker who has seen the library's PRNG state in memory cannot
|
||||||
|
predict past outputs.
|
||||||
|
.It
|
||||||
|
An attacker who has seen one process's PRNG state cannot predict past
|
||||||
|
or future outputs in other processes, particularly its parent or
|
||||||
|
siblings.
|
||||||
|
.El
|
||||||
|
.Pp
|
||||||
|
One
|
||||||
|
.Sq output
|
||||||
|
means the result of any single request to an
|
||||||
|
.Nm
|
||||||
|
function, no matter how short it is.
|
||||||
|
.Pp
|
||||||
|
The second property is sometimes called
|
||||||
|
.Sq forward secrecy ,
|
||||||
|
.Sq backtracking resistance ,
|
||||||
|
or
|
||||||
|
.Sq key erasure after each output .
|
||||||
|
.Sh IMPLEMENTATION NOTES
|
||||||
|
The
|
||||||
|
.Nm
|
||||||
|
functions are currently implemented using the ChaCha20 pseudorandom
|
||||||
|
function family.
|
||||||
|
For any 32-byte string
|
||||||
|
.Fa s ,
|
||||||
|
.Pf ChaCha20_ Fa s
|
||||||
|
is a function from 16-byte strings to 64-byte strings.
|
||||||
|
It is conjectured that if
|
||||||
|
.Fa s
|
||||||
|
is chosen with uniform distribution, then the distribution on
|
||||||
|
.Pf ChaCha20_ Fa s
|
||||||
|
is indistinguishable to a computationally bounded adversary from a
|
||||||
|
uniform distribution on all functions from 16-byte strings to 64-byte
|
||||||
|
strings.
|
||||||
|
.Pp
|
||||||
|
The PRNG state is a 32-byte ChaCha20 key
|
||||||
|
.Fa s .
|
||||||
|
Each request to
|
||||||
|
an
|
||||||
|
.Nm
|
||||||
|
function
|
||||||
|
.Bl -bullet -offset abcd -compact
|
||||||
|
.It
|
||||||
|
computes the 64-byte quantity
|
||||||
|
.Fa x
|
||||||
|
=
|
||||||
|
.Pf ChaCha20_ Fa s Ns Pq 0 ,
|
||||||
|
.It
|
||||||
|
splits
|
||||||
|
.Fa x
|
||||||
|
into two 32-byte quantities
|
||||||
|
.Fa s'
|
||||||
|
and
|
||||||
|
.Fa k ,
|
||||||
|
.It
|
||||||
|
replaces
|
||||||
|
.Fa s
|
||||||
|
by
|
||||||
|
.Fa s' ,
|
||||||
|
and
|
||||||
|
.It
|
||||||
|
uses
|
||||||
|
.Fa k
|
||||||
|
as output.
|
||||||
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
There is no need to call
|
|
||||||
.Fn arc4random_stir
|
|
||||||
before using
|
|
||||||
.Fn arc4random
|
.Fn arc4random
|
||||||
functions family, since
|
yields the first four bytes of
|
||||||
they automatically initialize themselves.
|
.Fa k
|
||||||
.Sh RETURN VALUES
|
as output directly.
|
||||||
These functions are always successful, and no return value is
|
.Fn arc4random_buf
|
||||||
reserved to indicate an error.
|
either yields up to 32 bytes of
|
||||||
|
.Fa k
|
||||||
|
as output directly, or, for longer
|
||||||
|
requests, uses
|
||||||
|
.Fa k
|
||||||
|
as a ChaCha20 key and yields the concatenation
|
||||||
|
.Pf ChaCha20_ Fa k Ns Pq 0
|
||||||
|
||
|
||||||
|
.Pf ChaCha20_ Fa k Ns Pq 1
|
||||||
|
|| ... as output.
|
||||||
|
.Fn arc4random_uniform
|
||||||
|
repeats
|
||||||
|
.Fn arc4random
|
||||||
|
until it obtains an integer in [2^32 %
|
||||||
|
.Fa bound ,
|
||||||
|
2^32), and reduces that modulo
|
||||||
|
.Fa bound .
|
||||||
|
.Pp
|
||||||
|
The PRNG state is per-thread, unless memory allocation fails inside the
|
||||||
|
library, in which case some threads may share global PRNG state with a
|
||||||
|
mutex.
|
||||||
|
The global PRNG state is zeroed on fork in the parent via
|
||||||
|
.Xr pthread_atfork 3 ,
|
||||||
|
and the per-thread PRNG state is zeroed on fork in the child via
|
||||||
|
.Xr minherit 2
|
||||||
|
with
|
||||||
|
.Dv MAP_INHERIT_ZERO ,
|
||||||
|
so that the child cannot reuse or see the parent's PRNG state.
|
||||||
|
The PRNG state is reseeded automatically from the system entropy pool
|
||||||
|
on the first use of an
|
||||||
|
.Nm
|
||||||
|
function after zeroing.
|
||||||
|
.Pp
|
||||||
|
The first use of an
|
||||||
|
.Nm
|
||||||
|
function may abort the process in the highly unlikely event that
|
||||||
|
library initialization necessary to implement the security model fails.
|
||||||
|
Additionally,
|
||||||
|
.Fn arc4random_stir
|
||||||
|
and
|
||||||
|
.Fn arc4random_addrandom
|
||||||
|
may abort the process in the highly unlikely event that the operating
|
||||||
|
system fails to provide entropy.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr rand 3 ,
|
.Xr rand 3 ,
|
||||||
.Xr rand48 3 ,
|
.Xr random 3 ,
|
||||||
.Xr random 3
|
.Xr rnd 4 ,
|
||||||
|
.Xr cprng 9
|
||||||
|
.Rs
|
||||||
|
.%A Daniel J. Bernstein
|
||||||
|
.%T ChaCha, a variant of Salsa20
|
||||||
|
.%D 2008-01-28
|
||||||
|
.%O Document ID: 4027b5256e17b9796842e6d0f68b0b5e
|
||||||
|
.%U http://cr.yp.to/papers.html#chacha
|
||||||
|
.Re
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
These functions first appeared in
|
These functions first appeared in
|
||||||
.Ox 2.1 ,
|
.Ox 2.1 ,
|
||||||
@ -135,12 +257,85 @@ These functions first appeared in
|
|||||||
.Nx 1.6 ,
|
.Nx 1.6 ,
|
||||||
and
|
and
|
||||||
.Dx 1.0 .
|
.Dx 1.0 .
|
||||||
|
The functions
|
||||||
|
.Fn arc4random ,
|
||||||
|
.Fn arc4random_buf
|
||||||
|
and
|
||||||
|
.Fn arc4random_uniform
|
||||||
|
appeared in glibc 2.36.
|
||||||
|
.Sh BUGS
|
||||||
|
There is no way to get deterministic, reproducible results out of
|
||||||
|
.Nm
|
||||||
|
for testing purposes.
|
||||||
.Pp
|
.Pp
|
||||||
The original version of this random number generator used the
|
The name
|
||||||
RC4 (also known as ARC4) algorithm.
|
.Sq arc4random
|
||||||
In
|
was chosen for hysterical raisins -- it was originally implemented
|
||||||
.Ox 5.5
|
using the RC4 stream cipher, which has been known since shortly after
|
||||||
it was replaced with the ChaCha20 cipher, and it may be replaced
|
it was published in 1994 to have observable biases in the output, and
|
||||||
again in the future as cryptographic techniques advance.
|
is now known to be broken badly enough to admit practical attacks in
|
||||||
A good mnemonic is
|
the real world.
|
||||||
.Dq A Replacement Call for Random .
|
.\" Bob Jenkins, sci.crypt post dated 1994-09-16, message-id
|
||||||
|
.\" <359qjg$55v$1@mhadg.production.compuserve.com>,
|
||||||
|
.\" https://groups.google.com/d/msg/sci.crypt/JsO3xEATGFA/-wO4ttv7BCYJ
|
||||||
|
.\"
|
||||||
|
.\" Andrew Roos, `A Class of Weak Keys in the RC4 Stream Cipher',
|
||||||
|
.\" sci.crypt posts dated 1995-09-22, message-ids
|
||||||
|
.\" <43u1eh$1j3@hermes.is.co.za> and <44ebge$llf@hermes.is.co.za>.
|
||||||
|
.\"
|
||||||
|
.\" Paul Crowley, `Small bias in RC4 experimentally verified', March
|
||||||
|
.\" 1998, http://www.ciphergoth.org/crypto/rc4/
|
||||||
|
Unfortunately, the library found widespread adoption and the name stuck
|
||||||
|
before anyone recognized that it was silly.
|
||||||
|
.Pp
|
||||||
|
The signature of
|
||||||
|
.Fn arc4random_addrandom
|
||||||
|
is silly.
|
||||||
|
There is no reason to require casts or accept negative lengths:
|
||||||
|
it should take a
|
||||||
|
.Vt void *
|
||||||
|
buffer and a
|
||||||
|
.Vt size_t
|
||||||
|
length.
|
||||||
|
But it's too late to change that now.
|
||||||
|
.Pp
|
||||||
|
.Fn arc4random_uniform
|
||||||
|
does not help to choose integers in [0,
|
||||||
|
.Fa n )
|
||||||
|
uniformly at random when
|
||||||
|
.Fa n
|
||||||
|
> 2^32.
|
||||||
|
.Pp
|
||||||
|
The security model of
|
||||||
|
.Nm
|
||||||
|
is stronger than many applications need, and stronger than other
|
||||||
|
operating systems provide.
|
||||||
|
For example, applications encrypting messages with random, but not
|
||||||
|
secret, initialization vectors need only prevent an adversary from
|
||||||
|
guessing future outputs, since past outputs will have been published
|
||||||
|
already.
|
||||||
|
.Pp
|
||||||
|
On the one hand,
|
||||||
|
.Nm
|
||||||
|
could be marginally faster if it were not necessary to prevent an
|
||||||
|
adversary who sees the state from predicting past outputs.
|
||||||
|
On the other hand, there are applications in the wild that use
|
||||||
|
.Nm
|
||||||
|
to generate key material, such as OpenSSH, so for the sake of
|
||||||
|
.Nx
|
||||||
|
users it would be imprudent to weaken the security model.
|
||||||
|
On the third hand, relying on the security model of
|
||||||
|
.Nm
|
||||||
|
in
|
||||||
|
.Nx
|
||||||
|
may lead you to an unpleasant surprise on another operating system
|
||||||
|
whose implementation of
|
||||||
|
.Nm
|
||||||
|
has a weaker security model.
|
||||||
|
.Pp
|
||||||
|
One may be tempted to create new APIs to accommodate different
|
||||||
|
security models and performance constraints without unpleasant
|
||||||
|
surprises on different operating systems.
|
||||||
|
This should not be done lightly, though, because there are already too
|
||||||
|
many different choices, and too many opportunities for programmers to
|
||||||
|
reach for one and pick the wrong one.
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd July 19, 1993
|
.Dd July 19, 1993
|
||||||
.Dt BITSTRING 3bsd
|
.Dt bitstring 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm bit_alloc ,
|
.Nm bit_alloc ,
|
||||||
|
@ -25,7 +25,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd April 29, 2002
|
.Dd April 29, 2002
|
||||||
.Dt BYTEORDER 3bsd
|
.Dt byteorder 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm be16enc , be16dec , be32enc , be32dec , be64enc , be64dec ,
|
.Nm be16enc , be16dec , be32enc , be32dec , be64enc , be64dec ,
|
||||||
|
@ -26,7 +26,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd June 12, 2009
|
.Dd June 12, 2009
|
||||||
.Dt CLOSEFROM 3bsd
|
.Dt closefrom 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm closefrom
|
.Nm closefrom
|
||||||
@ -51,8 +51,17 @@ from the per-process object reference table.
|
|||||||
Any errors encountered while closing file descriptors are ignored.
|
Any errors encountered while closing file descriptors are ignored.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr close 2
|
.Xr close 2
|
||||||
|
.Sh STANDARDS
|
||||||
|
.Fn closefrom
|
||||||
|
is a
|
||||||
|
.Bx
|
||||||
|
and Solaris extension.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
The
|
The
|
||||||
.Fn closefrom
|
.Fn closefrom
|
||||||
function first appeared in
|
function first appeared in Solaris 9,
|
||||||
.Fx 8.0 .
|
.Ox 3.5 ,
|
||||||
|
.Dx 1.2 ,
|
||||||
|
.Nx 3.0 ,
|
||||||
|
.Fx 8.0
|
||||||
|
and glibc 2.34.
|
||||||
|
@ -28,7 +28,7 @@
|
|||||||
.\" SUCH DAMAGE.
|
.\" SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd $Mdocdate: April 23 2014 $
|
.Dd $Mdocdate: April 23 2014 $
|
||||||
.Dt ERRC 3bsd
|
.Dt errc 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm errc ,
|
.Nm errc ,
|
||||||
|
@ -26,7 +26,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd August 15, 2010
|
.Dd August 15, 2010
|
||||||
.Dt EXPAND_NUMBER 3bsd
|
.Dt expand_number 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm expand_number
|
.Nm expand_number
|
||||||
|
@ -30,7 +30,7 @@
|
|||||||
.\" $OpenBSD: bzero.3,v 1.10 2014/01/22 21:06:45 tedu Exp $
|
.\" $OpenBSD: bzero.3,v 1.10 2014/01/22 21:06:45 tedu Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd $Mdocdate: January 22 2014 $
|
.Dd $Mdocdate: January 22 2014 $
|
||||||
.Dt EXPLICIT_BZERO 3bsd
|
.Dt explicit_bzero 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm explicit_bzero
|
.Nm explicit_bzero
|
||||||
|
@ -29,7 +29,7 @@
|
|||||||
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/stdio/fgetln.3,v 1.8 2004/07/16 06:07:12 tjr Exp $
|
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/stdio/fgetln.3,v 1.8 2004/07/16 06:07:12 tjr Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd April 19, 1994
|
.Dd April 19, 1994
|
||||||
.Dt FGETLN 3bsd
|
.Dt fgetln 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm fgetln
|
.Nm fgetln
|
||||||
|
@ -29,7 +29,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd July 16, 2004
|
.Dd July 16, 2004
|
||||||
.Dt FGETWLN 3bsd
|
.Dt fgetwln 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm fgetwln
|
.Nm fgetwln
|
||||||
|
@ -26,7 +26,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd July 28, 2017
|
.Dd July 28, 2017
|
||||||
.Dt FLOPEN 3bsd
|
.Dt flopen 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm flopen ,
|
.Nm flopen ,
|
||||||
|
@ -27,7 +27,7 @@
|
|||||||
.\" POSSIBILITY OF SUCH DAMAGE.
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd June 14, 2014
|
.Dd June 14, 2014
|
||||||
.Dt FMTCHECK 3bsd
|
.Dt fmtcheck 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm fmtcheck
|
.Nm fmtcheck
|
||||||
|
@ -23,7 +23,7 @@
|
|||||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd November 30, 2002
|
.Dd November 30, 2002
|
||||||
.Dt FPARSELN 3bsd
|
.Dt fparseln 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm fparseln
|
.Nm fparseln
|
||||||
@ -150,4 +150,6 @@ if it runs out of memory.
|
|||||||
The
|
The
|
||||||
.Fn fparseln
|
.Fn fparseln
|
||||||
function first appeared in
|
function first appeared in
|
||||||
.Nx 1.4 .
|
.Nx 1.4
|
||||||
|
and
|
||||||
|
.Fx 4.0 .
|
||||||
|
@ -32,7 +32,7 @@
|
|||||||
.\" SUCH DAMAGE.
|
.\" SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd $Mdocdate: November 4 2015 $
|
.Dd $Mdocdate: November 4 2015 $
|
||||||
.Dt FPURGE 3bsd
|
.Dt fpurge 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm fpurge
|
.Nm fpurge
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd March 19, 2004
|
.Dd March 19, 2004
|
||||||
.Dt FUNOPEN 3bsd
|
.Dt funopen 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm funopen ,
|
.Nm funopen ,
|
||||||
@ -168,9 +168,12 @@ functions first appeared in
|
|||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
The
|
The
|
||||||
.Fn funopen
|
.Fn funopen
|
||||||
function
|
function may not be portable to systems other than
|
||||||
may not be portable to systems other than
|
.Bx ,
|
||||||
.Bx .
|
glibc- and musl-based ones
|
||||||
|
(as the libbsd implementation is only provided when the system has
|
||||||
|
.Fn fopencookie
|
||||||
|
available).
|
||||||
.Pp
|
.Pp
|
||||||
On
|
On
|
||||||
.Fx ,
|
.Fx ,
|
||||||
|
@ -29,7 +29,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd November 16, 2012
|
.Dd November 16, 2012
|
||||||
.Dt GETBSIZE 3bsd
|
.Dt getbsize 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm getbsize
|
.Nm getbsize
|
||||||
|
@ -26,7 +26,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd July 15, 2001
|
.Dd July 15, 2001
|
||||||
.Dt GETPEEREID 3bsd
|
.Dt getpeereid 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm getpeereid
|
.Nm getpeereid
|
||||||
@ -139,4 +139,7 @@ or the kernel returned invalid data.
|
|||||||
The
|
The
|
||||||
.Fn getpeereid
|
.Fn getpeereid
|
||||||
function appeared in
|
function appeared in
|
||||||
.Fx 4.6 .
|
.Fx 4.6 ,
|
||||||
|
.Nx 5.0
|
||||||
|
and
|
||||||
|
.Ox 3.0 .
|
||||||
|
@ -1,6 +1,4 @@
|
|||||||
.\"
|
.\" Copyright (c) 2022 Guillem Jover <guillem@hadrons.org>
|
||||||
.\" Copyright (c) 2001 Christopher G. Demetriou
|
|
||||||
.\" All rights reserved.
|
|
||||||
.\"
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
.\" modification, are permitted provided that the following conditions
|
.\" modification, are permitted provided that the following conditions
|
||||||
@ -10,34 +8,27 @@
|
|||||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||||
.\" notice, this list of conditions and the following disclaimer in the
|
.\" notice, this list of conditions and the following disclaimer in the
|
||||||
.\" documentation and/or other materials provided with the distribution.
|
.\" documentation and/or other materials provided with the distribution.
|
||||||
.\" 3. All advertising materials mentioning features or use of this software
|
.\" 3. The name of the author may not be used to endorse or promote products
|
||||||
.\" must display the following acknowledgement:
|
|
||||||
.\" This product includes software developed for the
|
|
||||||
.\" NetBSD Project. See http://www.netbsd.org/ for
|
|
||||||
.\" information about NetBSD.
|
|
||||||
.\" 4. The name of the author may not be used to endorse or promote products
|
|
||||||
.\" derived from this software without specific prior written permission.
|
.\" derived from this software without specific prior written permission.
|
||||||
|
.\" .
|
||||||
|
.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
||||||
|
.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
||||||
|
.\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
||||||
|
.\" THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
||||||
|
.\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
||||||
|
.\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
||||||
|
.\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
||||||
|
.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
||||||
|
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
||||||
|
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
.Dd August 03, 2022
|
||||||
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
.Dt getprogname 3bsd
|
||||||
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
||||||
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
||||||
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
||||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
||||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
||||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
||||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
.\"
|
|
||||||
.\" $FreeBSD$
|
|
||||||
.\"
|
|
||||||
.Dd May 1, 2001
|
|
||||||
.Dt GETPROGNAME 3bsd
|
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm getprogname ,
|
.Nm getprogname ,
|
||||||
.Nm setprogname
|
.Nm setprogname
|
||||||
.Nd get or set the program name
|
.Nd get and set program name
|
||||||
.Sh LIBRARY
|
.Sh LIBRARY
|
||||||
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
||||||
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
||||||
@ -54,46 +45,39 @@ for include usage.)
|
|||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Fn getprogname
|
.Fn getprogname
|
||||||
and
|
returns a string with the current program name,
|
||||||
.Fn setprogname
|
excluding any directory component.
|
||||||
functions manipulate the name of the current program.
|
The function will return
|
||||||
They are used by error-reporting routines to produce
|
.Dv NULL
|
||||||
consistent output.
|
if it was unable to get the program name from any known source.
|
||||||
.Pp
|
|
||||||
The
|
|
||||||
.Fn getprogname
|
|
||||||
function returns the name of the program.
|
|
||||||
If the name has not been set yet, it will return
|
|
||||||
.Dv NULL .
|
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn setprogname
|
.Fn setprogname
|
||||||
function sets the name of the program to be the last component of the
|
function sets the current program name,
|
||||||
.Fa progname
|
stripping any directory component prefix.
|
||||||
argument.
|
The function will keep a reference to the passed string pointer,
|
||||||
Since a pointer to the given string is kept as the program name,
|
so it must not be freed or modified while these functions might
|
||||||
it should not be modified for the rest of the program's lifetime.
|
be called.
|
||||||
.Pp
|
.Pp
|
||||||
In
|
The implementations on most BSDs will try to initialize the program name
|
||||||
.Fx ,
|
at program startup time, and
|
||||||
the name of the program is set by the start-up code that is run before
|
.Nm libbsd
|
||||||
.Fn main ;
|
will try to infer it from various known sources depending on the
|
||||||
thus,
|
target system.
|
||||||
running
|
But it is not a portable assumption that the program name will be set
|
||||||
.Fn setprogname
|
without calling
|
||||||
is not necessary.
|
.Fn setprogname ,
|
||||||
Programs that desire maximum portability should still call it;
|
so portable programs should always call it after starting up.
|
||||||
on another operating system,
|
|
||||||
these functions may be implemented in a portability library.
|
|
||||||
Calling
|
|
||||||
.Fn setprogname
|
|
||||||
allows the aforementioned library to learn the program name without
|
|
||||||
modifications to the start-up code.
|
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr err 3 ,
|
.Xr setproctitle 3bsd .
|
||||||
.Xr setproctitle 3bsd
|
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
These functions first appeared in
|
The
|
||||||
|
.Fn setprogname
|
||||||
|
and
|
||||||
|
.Fn getprogname
|
||||||
|
functions first appeared in
|
||||||
.Nx 1.6 ,
|
.Nx 1.6 ,
|
||||||
and made their way into
|
.Fx 4.4 ,
|
||||||
.Fx 4.4 .
|
.Dx 2.1
|
||||||
|
and
|
||||||
|
.Ox 5.4 .
|
||||||
|
@ -33,7 +33,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd September 30, 2003
|
.Dd September 30, 2003
|
||||||
.Dt HEAPSORT 3bsd
|
.Dt heapsort 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm heapsort , mergesort
|
.Nm heapsort , mergesort
|
||||||
|
@ -28,7 +28,7 @@
|
|||||||
.\" POSSIBILITY OF SUCH DAMAGE.
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd February 9, 2008
|
.Dd February 9, 2008
|
||||||
.Dt HUMANIZE_NUMBER 3bsd
|
.Dt humanize_number 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm dehumanize_number ,
|
.Nm dehumanize_number ,
|
||||||
@ -166,7 +166,9 @@ represented a number that does not fit in
|
|||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
.Fn humanize_number
|
.Fn humanize_number
|
||||||
first appeared in
|
first appeared in
|
||||||
.Nx 2.0 .
|
.Nx 2.0
|
||||||
|
and
|
||||||
|
.Fx 5.3 .
|
||||||
.Pp
|
.Pp
|
||||||
.Fn dehumanize_number
|
.Fn dehumanize_number
|
||||||
first appeared in
|
first appeared in
|
||||||
|
129
man/libbsd.7
129
man/libbsd.7
@ -1,6 +1,6 @@
|
|||||||
.\" libbsd man page
|
.\" libbsd man page
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright © 2017-2018 Guillem Jover <guillem@hadrons.org>
|
.\" Copyright © 2017-2024 Guillem Jover <guillem@hadrons.org>
|
||||||
.\"
|
.\"
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" Redistribution and use in source and binary forms, with or without
|
||||||
.\" modification, are permitted provided that the following conditions
|
.\" modification, are permitted provided that the following conditions
|
||||||
@ -24,8 +24,8 @@
|
|||||||
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
||||||
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd May 21, 2018
|
.Dd January 8, 2024
|
||||||
.Dt LIBBSD 7
|
.Dt libbsd 7
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm libbsd
|
.Nm libbsd
|
||||||
@ -42,7 +42,7 @@ The library can be used in an overlay mode, which is the preferred way, so
|
|||||||
that the code is portable and requires no modification to the original BSD
|
that the code is portable and requires no modification to the original BSD
|
||||||
code.
|
code.
|
||||||
This can be done easily with the
|
This can be done easily with the
|
||||||
.Xr pkg-config 3
|
.Xr pkgconf 1
|
||||||
library named
|
library named
|
||||||
.Pa libbsd-overlay .
|
.Pa libbsd-overlay .
|
||||||
Or by adding the system-specific include directory with the
|
Or by adding the system-specific include directory with the
|
||||||
@ -59,12 +59,12 @@ The includes in this case should be the usual system ones, such as
|
|||||||
.In unistd.h .
|
.In unistd.h .
|
||||||
.Pp
|
.Pp
|
||||||
The other way to use the library is to use the namespaced headers,
|
The other way to use the library is to use the namespaced headers,
|
||||||
this is less portable as it makes using
|
which is a discouraged way, being less portable as it makes using
|
||||||
.Nm libbsd
|
.Nm libbsd
|
||||||
mandatory and it will not work on BSD-based systems, and requires
|
mandatory and it will not work on BSD-based systems, and requires
|
||||||
modifying original BSD code.
|
modifying original BSD code.
|
||||||
This can be done with the
|
This can be done with the
|
||||||
.Xr pkg-config 3
|
.Xr pkgconf 1
|
||||||
library named
|
library named
|
||||||
.Pa libbsd .
|
.Pa libbsd .
|
||||||
The includes in this case should be namespaced with
|
The includes in this case should be namespaced with
|
||||||
@ -73,13 +73,13 @@ such as
|
|||||||
.In bsd/unistd.h .
|
.In bsd/unistd.h .
|
||||||
.Pp
|
.Pp
|
||||||
The package also provides a
|
The package also provides a
|
||||||
.Pa bsd-ctor
|
.Nm libbsd-ctor
|
||||||
static library that can be used to inject automatic constructors into a
|
static library that can be used to inject automatic constructors into a
|
||||||
program so that the
|
program so that the
|
||||||
.Fn setproctitle_init 3
|
.Xr setproctitle_init 3bsd
|
||||||
function gets invoked automatically at startup time.
|
function gets invoked automatically at startup time.
|
||||||
This can be done with the
|
This can be done with the
|
||||||
.Xr pkg-config 3
|
.Xr pkgconf 1
|
||||||
library named
|
library named
|
||||||
.Pa libbsd-ctor .
|
.Pa libbsd-ctor .
|
||||||
.Sh HEADERS
|
.Sh HEADERS
|
||||||
@ -94,11 +94,13 @@ be prefixed with
|
|||||||
.It In bitstring.h
|
.It In bitstring.h
|
||||||
.It In err.h
|
.It In err.h
|
||||||
.It In getopt.h
|
.It In getopt.h
|
||||||
|
.It In grp.h
|
||||||
.It In inttypes.h
|
.It In inttypes.h
|
||||||
.It In libutil.h
|
.It In libutil.h
|
||||||
.It In md5.h
|
.It In md5.h
|
||||||
.It In netinet/ip_icmp.h
|
.It In netinet/ip_icmp.h
|
||||||
.It In nlist.h
|
.It In nlist.h
|
||||||
|
.It In pwd.h
|
||||||
.It In readpassphrase.h
|
.It In readpassphrase.h
|
||||||
.It In stdio.h
|
.It In stdio.h
|
||||||
.It In stdlib.h
|
.It In stdlib.h
|
||||||
@ -107,6 +109,7 @@ be prefixed with
|
|||||||
.It In sys/bitstring.h
|
.It In sys/bitstring.h
|
||||||
.It In sys/cdefs.h
|
.It In sys/cdefs.h
|
||||||
.It In sys/endian.h
|
.It In sys/endian.h
|
||||||
|
.It In sys/param.h
|
||||||
.It In sys/poll.h
|
.It In sys/poll.h
|
||||||
.It In sys/queue.h
|
.It In sys/queue.h
|
||||||
.It In sys/time.h
|
.It In sys/time.h
|
||||||
@ -125,6 +128,47 @@ It only works in non-overlay mode.
|
|||||||
.Bl -tag -width 4m -compact
|
.Bl -tag -width 4m -compact
|
||||||
.It In bsd/bsd.h
|
.It In bsd/bsd.h
|
||||||
.El
|
.El
|
||||||
|
.Sh VARIANTS
|
||||||
|
Some functions have different prototypes depending on the BSD where they
|
||||||
|
originated from, and these various implementations provided are selectable
|
||||||
|
at build-time.
|
||||||
|
.Pp
|
||||||
|
This is the list of functions that provide multiple implementations:
|
||||||
|
.Pp
|
||||||
|
.Bl -tag -width 4m -compact
|
||||||
|
.It Xr strnvis 3bsd
|
||||||
|
.It Xr strnunvis 3bsd
|
||||||
|
.Nx
|
||||||
|
added
|
||||||
|
.Xr strnvis 3bsd
|
||||||
|
and
|
||||||
|
.Xr strnunvis 3bsd
|
||||||
|
but unfortunately made it incompatible with the existing one in
|
||||||
|
.Ox
|
||||||
|
and Freedesktop's libbsd (the former having existed for over ten years).
|
||||||
|
Despite this incompatibility being reported during development (see
|
||||||
|
http://gnats.netbsd.org/44977) they still shipped it.
|
||||||
|
Even more unfortunately
|
||||||
|
.Fx
|
||||||
|
and later macOS picked up this incompatible implementation.
|
||||||
|
.Pp
|
||||||
|
Provide both implementations and default for now to the historical one to
|
||||||
|
avoid breakage, but we will switch to the
|
||||||
|
.Nx
|
||||||
|
one in a later release, which is internally consistent with the other
|
||||||
|
.Xr vis 3bsd
|
||||||
|
functions and is now more widespread.
|
||||||
|
Define
|
||||||
|
.Dv LIBBSD_NETBSD_VIS
|
||||||
|
to switch to the
|
||||||
|
.Nx
|
||||||
|
one now.
|
||||||
|
Define
|
||||||
|
.Dv LIBBSD_OPENBSD_VIS
|
||||||
|
to keep using the
|
||||||
|
.Ox
|
||||||
|
one.
|
||||||
|
.El
|
||||||
.Sh DEPRECATED
|
.Sh DEPRECATED
|
||||||
Some functions have been deprecated, they will emit warnings at compile time
|
Some functions have been deprecated, they will emit warnings at compile time
|
||||||
and possibly while being linked at run-time.
|
and possibly while being linked at run-time.
|
||||||
@ -134,30 +178,30 @@ or non-buggy way; or because there are better more portable replacements now.
|
|||||||
.Pp
|
.Pp
|
||||||
This is the list of currently deprecated macros and functions:
|
This is the list of currently deprecated macros and functions:
|
||||||
.Bl -tag -width 4m
|
.Bl -tag -width 4m
|
||||||
.It Fn fgetln 3
|
.It Xr fgetln 3bsd
|
||||||
Unportable, requires assistance from the stdio layer.
|
Unportable, requires assistance from the stdio layer.
|
||||||
An implementation has to choose between leaking buffers or being reentrant
|
An implementation has to choose between leaking buffers or being reentrant
|
||||||
for a limited amount of streams (this implementation chose the latter with
|
for a limited amount of streams (this implementation chose the latter with
|
||||||
a limit of 32).
|
a limit of 32).
|
||||||
Use
|
Use
|
||||||
.Fn getline 3
|
.Xr getline 3
|
||||||
instead, which is available in many systems and required by
|
instead, which is available in many systems and required by
|
||||||
.St -p1003.1-2008 .
|
.St -p1003.1-2008 .
|
||||||
.It Fn fgetwln 3
|
.It Xr fgetwln 3bsd
|
||||||
Unportable, requires assistance from the stdio layer.
|
Unportable, requires assistance from the stdio layer.
|
||||||
An implementation has to choose between leaking buffers or being reentrant
|
An implementation has to choose between leaking buffers or being reentrant
|
||||||
for a limited amount of streams (this implementation chose the latter with
|
for a limited amount of streams (this implementation chose the latter with
|
||||||
a limit of 32).
|
a limit of 32).
|
||||||
Use
|
Use
|
||||||
.Fn fgetwc 3
|
.Xr fgetwc 3
|
||||||
instead, which is available in many systems and required by
|
instead, which is available in many systems and required by
|
||||||
.St -isoC-99
|
.St -isoC-99
|
||||||
and
|
and
|
||||||
.St -p1003.1-2001 .
|
.St -p1003.1-2001 .
|
||||||
.It Fn funopen 3
|
.It Xr funopen 3bsd
|
||||||
Unportable, requires assistance from the stdio layer or some hook framework.
|
Unportable, requires assistance from the stdio layer or some hook framework.
|
||||||
On GNU systems the
|
On glibc- and musl-based systems the
|
||||||
.Fn fopencookie 3
|
.Xr fopencookie 3
|
||||||
function can be used.
|
function can be used.
|
||||||
Otherwise the code needs to be prepared for neither of these functions being
|
Otherwise the code needs to be prepared for neither of these functions being
|
||||||
available.
|
available.
|
||||||
@ -171,27 +215,53 @@ are present in all major
|
|||||||
for example.
|
for example.
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -width 4m -compact
|
.Bl -tag -width 4m -compact
|
||||||
.It Fn MD5Init 3
|
.It Xr MD5Init 3
|
||||||
.It Fn MD5Update 3
|
.It Xr MD5Update 3
|
||||||
.It Fn MD5Pad 3
|
.It Xr MD5Pad 3
|
||||||
.It Fn MD5Final 3
|
.It Xr MD5Final 3
|
||||||
.It Fn MD5Transform 3
|
.It Xr MD5Transform 3
|
||||||
.It Fn MD5End 3
|
.It Xr MD5End 3
|
||||||
.It Fn MD5File 3
|
.It Xr MD5File 3
|
||||||
.It Fn MD5FileChunk 3
|
.It Xr MD5FileChunk 3
|
||||||
.It Fn MD5Data 3
|
.It Xr MD5Data 3
|
||||||
The set of MD5 digest functions are now proxies for the implementations
|
The set of MD5 digest functions are now proxies for the implementations
|
||||||
provided by the
|
provided by the
|
||||||
.Nm libmd
|
.Nm libmd
|
||||||
companion library, so it is advised to switch to use that directly instead.
|
companion library, so it is advised to switch to use that directly instead.
|
||||||
.It Fn explicit_bzero 3
|
.It Xr explicit_bzero 3bsd
|
||||||
This function is provided by
|
This function is provided by
|
||||||
.Nm glibc
|
.Nm glibc
|
||||||
2.25.
|
2.25, and
|
||||||
.It Fn reallocarray 3
|
.Nm musl
|
||||||
|
1.1.20.
|
||||||
|
.It Xr reallocarray 3bsd
|
||||||
This function is provided by
|
This function is provided by
|
||||||
.Nm glibc
|
.Nm glibc
|
||||||
2.26.
|
2.26, and
|
||||||
|
.Nm musl
|
||||||
|
1.2.2.
|
||||||
|
.It Xr closefrom 3bsd
|
||||||
|
This function is provided by
|
||||||
|
.Nm glibc
|
||||||
|
2.34.
|
||||||
|
.It Xr arc4random 3bsd
|
||||||
|
.It Xr arc4random_buf 3bsd
|
||||||
|
.It Xr arc4random_uniform 3bsd
|
||||||
|
These functions are provided by
|
||||||
|
.Nm glibc
|
||||||
|
2.36.
|
||||||
|
Note that it does not provide the
|
||||||
|
.Xr arc4random_stir 3bsd
|
||||||
|
and
|
||||||
|
.Xr arc4random_addrandom 3bsd
|
||||||
|
functions.
|
||||||
|
.It Xr strlcpy 3bsd
|
||||||
|
.It Xr strlcat 3bsd
|
||||||
|
These functions are provided by
|
||||||
|
.Nm glibc
|
||||||
|
2.38, and
|
||||||
|
.Nm musl
|
||||||
|
0.5.0.
|
||||||
.El
|
.El
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr arc4random 3bsd ,
|
.Xr arc4random 3bsd ,
|
||||||
@ -216,6 +286,7 @@ This function is provided by
|
|||||||
.Xr md5 3bsd ,
|
.Xr md5 3bsd ,
|
||||||
.Xr nlist 3bsd ,
|
.Xr nlist 3bsd ,
|
||||||
.Xr pidfile 3bsd ,
|
.Xr pidfile 3bsd ,
|
||||||
|
.Xr pwcache 3bsd ,
|
||||||
.Xr queue 3bsd ,
|
.Xr queue 3bsd ,
|
||||||
.Xr radixsort 3bsd ,
|
.Xr radixsort 3bsd ,
|
||||||
.Xr readpassphrase 3bsd ,
|
.Xr readpassphrase 3bsd ,
|
||||||
|
@ -29,7 +29,7 @@
|
|||||||
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/gen/nlist.3,v 1.7 2001/10/01 16:08:51 ru Exp $
|
.\" $FreeBSD: /repoman/r/ncvs/src/lib/libc/gen/nlist.3,v 1.7 2001/10/01 16:08:51 ru Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd April 19, 1994
|
.Dd April 19, 1994
|
||||||
.Dt NLIST 3bsd
|
.Dt nlist 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm nlist
|
.Nm nlist
|
||||||
|
@ -25,7 +25,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd February 8, 2012
|
.Dd February 8, 2012
|
||||||
.Dt PIDFILE 3bsd
|
.Dt pidfile 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm pidfile_open ,
|
.Nm pidfile_open ,
|
||||||
@ -292,6 +292,20 @@ Probably called not from the process which used
|
|||||||
.Xr open 2 ,
|
.Xr open 2 ,
|
||||||
.Xr daemon 3 ,
|
.Xr daemon 3 ,
|
||||||
.Xr flopen 3bsd
|
.Xr flopen 3bsd
|
||||||
|
.Sh HISTORY
|
||||||
|
The functions
|
||||||
|
.Fn pidfile_open ,
|
||||||
|
.Fn pidfile_write ,
|
||||||
|
.Fn pidfile_close
|
||||||
|
and
|
||||||
|
.Fn pidfile_remove
|
||||||
|
first appeared in
|
||||||
|
.Fx 5.5 .
|
||||||
|
.Pp
|
||||||
|
The function
|
||||||
|
.Fn pidfile_fileno
|
||||||
|
first appeared in
|
||||||
|
.Fx 10.0 .
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
.An -nosplit
|
.An -nosplit
|
||||||
The
|
The
|
||||||
|
@ -28,7 +28,7 @@
|
|||||||
.\" SUCH DAMAGE.
|
.\" SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd $Mdocdate: September 13 2018 $
|
.Dd $Mdocdate: September 13 2018 $
|
||||||
.Dt USER_FROM_UID 3
|
.Dt user_from_uid 3
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm user_from_uid ,
|
.Nm user_from_uid ,
|
||||||
@ -137,7 +137,7 @@ The
|
|||||||
.Fn uid_from_user
|
.Fn uid_from_user
|
||||||
and
|
and
|
||||||
.Fn gid_from_group
|
.Fn gid_from_group
|
||||||
functions were ported from
|
functions first appeared in
|
||||||
.Nx
|
.Nx 1.4
|
||||||
and first appeared in
|
and
|
||||||
.Ox 6.4 .
|
.Ox 6.4 .
|
||||||
|
155
man/queue.3bsd
155
man/queue.3bsd
@ -28,35 +28,40 @@
|
|||||||
.\" @(#)queue.3 8.2 (Berkeley) 1/24/94
|
.\" @(#)queue.3 8.2 (Berkeley) 1/24/94
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd June 17, 2013
|
.Dd September 8, 2016
|
||||||
.Dt QUEUE 3bsd
|
.Dt queue 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
|
.Nm SLIST_CLASS_ENTRY ,
|
||||||
|
.Nm SLIST_CLASS_HEAD ,
|
||||||
|
.Nm SLIST_CONCAT ,
|
||||||
.Nm SLIST_EMPTY ,
|
.Nm SLIST_EMPTY ,
|
||||||
.Nm SLIST_ENTRY ,
|
.Nm SLIST_ENTRY ,
|
||||||
.Nm SLIST_FIRST ,
|
.Nm SLIST_FIRST ,
|
||||||
.Nm SLIST_FOREACH ,
|
.Nm SLIST_FOREACH ,
|
||||||
.Nm SLIST_FOREACH_FROM ,
|
.Nm SLIST_FOREACH_FROM ,
|
||||||
.Nm SLIST_FOREACH_SAFE ,
|
|
||||||
.Nm SLIST_FOREACH_FROM_SAFE ,
|
.Nm SLIST_FOREACH_FROM_SAFE ,
|
||||||
|
.Nm SLIST_FOREACH_SAFE ,
|
||||||
.Nm SLIST_HEAD ,
|
.Nm SLIST_HEAD ,
|
||||||
.Nm SLIST_HEAD_INITIALIZER ,
|
.Nm SLIST_HEAD_INITIALIZER ,
|
||||||
.Nm SLIST_INIT ,
|
.Nm SLIST_INIT ,
|
||||||
.Nm SLIST_INSERT_AFTER ,
|
.Nm SLIST_INSERT_AFTER ,
|
||||||
.Nm SLIST_INSERT_HEAD ,
|
.Nm SLIST_INSERT_HEAD ,
|
||||||
.Nm SLIST_NEXT ,
|
.Nm SLIST_NEXT ,
|
||||||
|
.Nm SLIST_REMOVE ,
|
||||||
.Nm SLIST_REMOVE_AFTER ,
|
.Nm SLIST_REMOVE_AFTER ,
|
||||||
.Nm SLIST_REMOVE_HEAD ,
|
.Nm SLIST_REMOVE_HEAD ,
|
||||||
.Nm SLIST_REMOVE ,
|
|
||||||
.Nm SLIST_SWAP ,
|
.Nm SLIST_SWAP ,
|
||||||
|
.Nm STAILQ_CLASS_ENTRY ,
|
||||||
|
.Nm STAILQ_CLASS_HEAD ,
|
||||||
.Nm STAILQ_CONCAT ,
|
.Nm STAILQ_CONCAT ,
|
||||||
.Nm STAILQ_EMPTY ,
|
.Nm STAILQ_EMPTY ,
|
||||||
.Nm STAILQ_ENTRY ,
|
.Nm STAILQ_ENTRY ,
|
||||||
.Nm STAILQ_FIRST ,
|
.Nm STAILQ_FIRST ,
|
||||||
.Nm STAILQ_FOREACH ,
|
.Nm STAILQ_FOREACH ,
|
||||||
.Nm STAILQ_FOREACH_FROM ,
|
.Nm STAILQ_FOREACH_FROM ,
|
||||||
.Nm STAILQ_FOREACH_SAFE ,
|
|
||||||
.Nm STAILQ_FOREACH_FROM_SAFE ,
|
.Nm STAILQ_FOREACH_FROM_SAFE ,
|
||||||
|
.Nm STAILQ_FOREACH_SAFE ,
|
||||||
.Nm STAILQ_HEAD ,
|
.Nm STAILQ_HEAD ,
|
||||||
.Nm STAILQ_HEAD_INITIALIZER ,
|
.Nm STAILQ_HEAD_INITIALIZER ,
|
||||||
.Nm STAILQ_INIT ,
|
.Nm STAILQ_INIT ,
|
||||||
@ -65,17 +70,20 @@
|
|||||||
.Nm STAILQ_INSERT_TAIL ,
|
.Nm STAILQ_INSERT_TAIL ,
|
||||||
.Nm STAILQ_LAST ,
|
.Nm STAILQ_LAST ,
|
||||||
.Nm STAILQ_NEXT ,
|
.Nm STAILQ_NEXT ,
|
||||||
|
.Nm STAILQ_REMOVE ,
|
||||||
.Nm STAILQ_REMOVE_AFTER ,
|
.Nm STAILQ_REMOVE_AFTER ,
|
||||||
.Nm STAILQ_REMOVE_HEAD ,
|
.Nm STAILQ_REMOVE_HEAD ,
|
||||||
.Nm STAILQ_REMOVE ,
|
|
||||||
.Nm STAILQ_SWAP ,
|
.Nm STAILQ_SWAP ,
|
||||||
|
.Nm LIST_CLASS_ENTRY ,
|
||||||
|
.Nm LIST_CLASS_HEAD ,
|
||||||
|
.Nm LIST_CONCAT ,
|
||||||
.Nm LIST_EMPTY ,
|
.Nm LIST_EMPTY ,
|
||||||
.Nm LIST_ENTRY ,
|
.Nm LIST_ENTRY ,
|
||||||
.Nm LIST_FIRST ,
|
.Nm LIST_FIRST ,
|
||||||
.Nm LIST_FOREACH ,
|
.Nm LIST_FOREACH ,
|
||||||
.Nm LIST_FOREACH_FROM ,
|
.Nm LIST_FOREACH_FROM ,
|
||||||
.Nm LIST_FOREACH_SAFE ,
|
|
||||||
.Nm LIST_FOREACH_FROM_SAFE ,
|
.Nm LIST_FOREACH_FROM_SAFE ,
|
||||||
|
.Nm LIST_FOREACH_SAFE ,
|
||||||
.Nm LIST_HEAD ,
|
.Nm LIST_HEAD ,
|
||||||
.Nm LIST_HEAD_INITIALIZER ,
|
.Nm LIST_HEAD_INITIALIZER ,
|
||||||
.Nm LIST_INIT ,
|
.Nm LIST_INIT ,
|
||||||
@ -86,18 +94,20 @@
|
|||||||
.Nm LIST_PREV ,
|
.Nm LIST_PREV ,
|
||||||
.Nm LIST_REMOVE ,
|
.Nm LIST_REMOVE ,
|
||||||
.Nm LIST_SWAP ,
|
.Nm LIST_SWAP ,
|
||||||
|
.Nm TAILQ_CLASS_ENTRY ,
|
||||||
|
.Nm TAILQ_CLASS_HEAD ,
|
||||||
.Nm TAILQ_CONCAT ,
|
.Nm TAILQ_CONCAT ,
|
||||||
.Nm TAILQ_EMPTY ,
|
.Nm TAILQ_EMPTY ,
|
||||||
.Nm TAILQ_ENTRY ,
|
.Nm TAILQ_ENTRY ,
|
||||||
.Nm TAILQ_FIRST ,
|
.Nm TAILQ_FIRST ,
|
||||||
.Nm TAILQ_FOREACH ,
|
.Nm TAILQ_FOREACH ,
|
||||||
.Nm TAILQ_FOREACH_FROM ,
|
.Nm TAILQ_FOREACH_FROM ,
|
||||||
.Nm TAILQ_FOREACH_SAFE ,
|
|
||||||
.Nm TAILQ_FOREACH_FROM_SAFE ,
|
.Nm TAILQ_FOREACH_FROM_SAFE ,
|
||||||
.Nm TAILQ_FOREACH_REVERSE ,
|
.Nm TAILQ_FOREACH_REVERSE ,
|
||||||
.Nm TAILQ_FOREACH_REVERSE_FROM ,
|
.Nm TAILQ_FOREACH_REVERSE_FROM ,
|
||||||
.Nm TAILQ_FOREACH_REVERSE_SAFE ,
|
|
||||||
.Nm TAILQ_FOREACH_REVERSE_FROM_SAFE ,
|
.Nm TAILQ_FOREACH_REVERSE_FROM_SAFE ,
|
||||||
|
.Nm TAILQ_FOREACH_REVERSE_SAFE ,
|
||||||
|
.Nm TAILQ_FOREACH_SAFE ,
|
||||||
.Nm TAILQ_HEAD ,
|
.Nm TAILQ_HEAD ,
|
||||||
.Nm TAILQ_HEAD_INITIALIZER ,
|
.Nm TAILQ_HEAD_INITIALIZER ,
|
||||||
.Nm TAILQ_INIT ,
|
.Nm TAILQ_INIT ,
|
||||||
@ -122,52 +132,60 @@ lists and tail queues
|
|||||||
.Xr libbsd 7
|
.Xr libbsd 7
|
||||||
for include usage.)
|
for include usage.)
|
||||||
.\"
|
.\"
|
||||||
|
.Fn SLIST_CLASS_ENTRY "CLASSTYPE"
|
||||||
|
.Fn SLIST_CLASS_HEAD "HEADNAME" "CLASSTYPE"
|
||||||
|
.Fn SLIST_CONCAT "SLIST_HEAD *head1" "SLIST_HEAD *head2" "TYPE" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_EMPTY "SLIST_HEAD *head"
|
.Fn SLIST_EMPTY "SLIST_HEAD *head"
|
||||||
.Fn SLIST_ENTRY "TYPE"
|
.Fn SLIST_ENTRY "TYPE"
|
||||||
.Fn SLIST_FIRST "SLIST_HEAD *head"
|
.Fn SLIST_FIRST "SLIST_HEAD *head"
|
||||||
.Fn SLIST_FOREACH "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME"
|
.Fn SLIST_FOREACH "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_FOREACH_FROM "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME"
|
.Fn SLIST_FOREACH_FROM "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_FOREACH_SAFE "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME" "TYPE *temp_var"
|
|
||||||
.Fn SLIST_FOREACH_FROM_SAFE "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME" "TYPE *temp_var"
|
.Fn SLIST_FOREACH_FROM_SAFE "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME" "TYPE *temp_var"
|
||||||
|
.Fn SLIST_FOREACH_SAFE "TYPE *var" "SLIST_HEAD *head" "SLIST_ENTRY NAME" "TYPE *temp_var"
|
||||||
.Fn SLIST_HEAD "HEADNAME" "TYPE"
|
.Fn SLIST_HEAD "HEADNAME" "TYPE"
|
||||||
.Fn SLIST_HEAD_INITIALIZER "SLIST_HEAD head"
|
.Fn SLIST_HEAD_INITIALIZER "SLIST_HEAD head"
|
||||||
.Fn SLIST_INIT "SLIST_HEAD *head"
|
.Fn SLIST_INIT "SLIST_HEAD *head"
|
||||||
.Fn SLIST_INSERT_AFTER "TYPE *listelm" "TYPE *elm" "SLIST_ENTRY NAME"
|
.Fn SLIST_INSERT_AFTER "TYPE *listelm" "TYPE *elm" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_INSERT_HEAD "SLIST_HEAD *head" "TYPE *elm" "SLIST_ENTRY NAME"
|
.Fn SLIST_INSERT_HEAD "SLIST_HEAD *head" "TYPE *elm" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_NEXT "TYPE *elm" "SLIST_ENTRY NAME"
|
.Fn SLIST_NEXT "TYPE *elm" "SLIST_ENTRY NAME"
|
||||||
|
.Fn SLIST_REMOVE "SLIST_HEAD *head" "TYPE *elm" "TYPE" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_REMOVE_AFTER "TYPE *elm" "SLIST_ENTRY NAME"
|
.Fn SLIST_REMOVE_AFTER "TYPE *elm" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_REMOVE_HEAD "SLIST_HEAD *head" "SLIST_ENTRY NAME"
|
.Fn SLIST_REMOVE_HEAD "SLIST_HEAD *head" "SLIST_ENTRY NAME"
|
||||||
.Fn SLIST_REMOVE "SLIST_HEAD *head" "TYPE *elm" "TYPE" "SLIST_ENTRY NAME"
|
.Fn SLIST_SWAP "SLIST_HEAD *head1" "SLIST_HEAD *head2" "TYPE"
|
||||||
.Fn SLIST_SWAP "SLIST_HEAD *head1" "SLIST_HEAD *head2" "SLIST_ENTRY NAME"
|
|
||||||
.\"
|
.\"
|
||||||
|
.Fn STAILQ_CLASS_ENTRY "CLASSTYPE"
|
||||||
|
.Fn STAILQ_CLASS_HEAD "HEADNAME" "CLASSTYPE"
|
||||||
.Fn STAILQ_CONCAT "STAILQ_HEAD *head1" "STAILQ_HEAD *head2"
|
.Fn STAILQ_CONCAT "STAILQ_HEAD *head1" "STAILQ_HEAD *head2"
|
||||||
.Fn STAILQ_EMPTY "STAILQ_HEAD *head"
|
.Fn STAILQ_EMPTY "STAILQ_HEAD *head"
|
||||||
.Fn STAILQ_ENTRY "TYPE"
|
.Fn STAILQ_ENTRY "TYPE"
|
||||||
.Fn STAILQ_FIRST "STAILQ_HEAD *head"
|
.Fn STAILQ_FIRST "STAILQ_HEAD *head"
|
||||||
.Fn STAILQ_FOREACH "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_FOREACH "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_FOREACH_FROM "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_FOREACH_FROM "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_FOREACH_SAFE "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME" "TYPE *temp_var"
|
|
||||||
.Fn STAILQ_FOREACH_FROM_SAFE "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME" "TYPE *temp_var"
|
.Fn STAILQ_FOREACH_FROM_SAFE "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME" "TYPE *temp_var"
|
||||||
|
.Fn STAILQ_FOREACH_SAFE "TYPE *var" "STAILQ_HEAD *head" "STAILQ_ENTRY NAME" "TYPE *temp_var"
|
||||||
.Fn STAILQ_HEAD "HEADNAME" "TYPE"
|
.Fn STAILQ_HEAD "HEADNAME" "TYPE"
|
||||||
.Fn STAILQ_HEAD_INITIALIZER "STAILQ_HEAD head"
|
.Fn STAILQ_HEAD_INITIALIZER "STAILQ_HEAD head"
|
||||||
.Fn STAILQ_INIT "STAILQ_HEAD *head"
|
.Fn STAILQ_INIT "STAILQ_HEAD *head"
|
||||||
.Fn STAILQ_INSERT_AFTER "STAILQ_HEAD *head" "TYPE *listelm" "TYPE *elm" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_INSERT_AFTER "STAILQ_HEAD *head" "TYPE *listelm" "TYPE *elm" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_INSERT_HEAD "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_INSERT_HEAD "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_INSERT_TAIL "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_INSERT_TAIL "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_LAST "STAILQ_HEAD *head" "TYPE" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_LAST "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_NEXT "TYPE *elm" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_NEXT "TYPE *elm" "STAILQ_ENTRY NAME"
|
||||||
|
.Fn STAILQ_REMOVE "STAILQ_HEAD *head" "TYPE *elm" "TYPE" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_REMOVE_AFTER "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_REMOVE_AFTER "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_REMOVE_HEAD "STAILQ_HEAD *head" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_REMOVE_HEAD "STAILQ_HEAD *head" "STAILQ_ENTRY NAME"
|
||||||
.Fn STAILQ_REMOVE "STAILQ_HEAD *head" "TYPE *elm" "TYPE" "STAILQ_ENTRY NAME"
|
.Fn STAILQ_SWAP "STAILQ_HEAD *head1" "STAILQ_HEAD *head2" "TYPE"
|
||||||
.Fn STAILQ_SWAP "STAILQ_HEAD *head1" "STAILQ_HEAD *head2" "STAILQ_ENTRY NAME"
|
|
||||||
.\"
|
.\"
|
||||||
|
.Fn LIST_CLASS_ENTRY "CLASSTYPE"
|
||||||
|
.Fn LIST_CLASS_HEAD "HEADNAME" "CLASSTYPE"
|
||||||
|
.Fn LIST_CONCAT "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME"
|
||||||
.Fn LIST_EMPTY "LIST_HEAD *head"
|
.Fn LIST_EMPTY "LIST_HEAD *head"
|
||||||
.Fn LIST_ENTRY "TYPE"
|
.Fn LIST_ENTRY "TYPE"
|
||||||
.Fn LIST_FIRST "LIST_HEAD *head"
|
.Fn LIST_FIRST "LIST_HEAD *head"
|
||||||
.Fn LIST_FOREACH "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME"
|
.Fn LIST_FOREACH "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME"
|
||||||
.Fn LIST_FOREACH_FROM "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME"
|
.Fn LIST_FOREACH_FROM "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME"
|
||||||
.Fn LIST_FOREACH_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var"
|
|
||||||
.Fn LIST_FOREACH_FROM_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var"
|
.Fn LIST_FOREACH_FROM_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var"
|
||||||
|
.Fn LIST_FOREACH_SAFE "TYPE *var" "LIST_HEAD *head" "LIST_ENTRY NAME" "TYPE *temp_var"
|
||||||
.Fn LIST_HEAD "HEADNAME" "TYPE"
|
.Fn LIST_HEAD "HEADNAME" "TYPE"
|
||||||
.Fn LIST_HEAD_INITIALIZER "LIST_HEAD head"
|
.Fn LIST_HEAD_INITIALIZER "LIST_HEAD head"
|
||||||
.Fn LIST_INIT "LIST_HEAD *head"
|
.Fn LIST_INIT "LIST_HEAD *head"
|
||||||
@ -179,18 +197,20 @@ for include usage.)
|
|||||||
.Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME"
|
.Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME"
|
||||||
.Fn LIST_SWAP "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME"
|
.Fn LIST_SWAP "LIST_HEAD *head1" "LIST_HEAD *head2" "TYPE" "LIST_ENTRY NAME"
|
||||||
.\"
|
.\"
|
||||||
|
.Fn TAILQ_CLASS_ENTRY "CLASSTYPE"
|
||||||
|
.Fn TAILQ_CLASS_HEAD "HEADNAME" "CLASSTYPE"
|
||||||
.Fn TAILQ_CONCAT "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TAILQ_ENTRY NAME"
|
.Fn TAILQ_CONCAT "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TAILQ_ENTRY NAME"
|
||||||
.Fn TAILQ_EMPTY "TAILQ_HEAD *head"
|
.Fn TAILQ_EMPTY "TAILQ_HEAD *head"
|
||||||
.Fn TAILQ_ENTRY "TYPE"
|
.Fn TAILQ_ENTRY "TYPE"
|
||||||
.Fn TAILQ_FIRST "TAILQ_HEAD *head"
|
.Fn TAILQ_FIRST "TAILQ_HEAD *head"
|
||||||
.Fn TAILQ_FOREACH "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME"
|
.Fn TAILQ_FOREACH "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME"
|
||||||
.Fn TAILQ_FOREACH_FROM "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME"
|
.Fn TAILQ_FOREACH_FROM "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME"
|
||||||
.Fn TAILQ_FOREACH_SAFE "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
|
||||||
.Fn TAILQ_FOREACH_FROM_SAFE "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
.Fn TAILQ_FOREACH_FROM_SAFE "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
||||||
.Fn TAILQ_FOREACH_REVERSE "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME"
|
.Fn TAILQ_FOREACH_REVERSE "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME"
|
||||||
.Fn TAILQ_FOREACH_REVERSE_FROM "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME"
|
.Fn TAILQ_FOREACH_REVERSE_FROM "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME"
|
||||||
.Fn TAILQ_FOREACH_REVERSE_SAFE "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
|
||||||
.Fn TAILQ_FOREACH_REVERSE_FROM_SAFE "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
.Fn TAILQ_FOREACH_REVERSE_FROM_SAFE "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
||||||
|
.Fn TAILQ_FOREACH_REVERSE_SAFE "TYPE *var" "TAILQ_HEAD *head" "HEADNAME" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
||||||
|
.Fn TAILQ_FOREACH_SAFE "TYPE *var" "TAILQ_HEAD *head" "TAILQ_ENTRY NAME" "TYPE *temp_var"
|
||||||
.Fn TAILQ_HEAD "HEADNAME" "TYPE"
|
.Fn TAILQ_HEAD "HEADNAME" "TYPE"
|
||||||
.Fn TAILQ_HEAD_INITIALIZER "TAILQ_HEAD head"
|
.Fn TAILQ_HEAD_INITIALIZER "TAILQ_HEAD head"
|
||||||
.Fn TAILQ_INIT "TAILQ_HEAD *head"
|
.Fn TAILQ_INIT "TAILQ_HEAD *head"
|
||||||
@ -205,8 +225,18 @@ for include usage.)
|
|||||||
.Fn TAILQ_SWAP "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TYPE" "TAILQ_ENTRY NAME"
|
.Fn TAILQ_SWAP "TAILQ_HEAD *head1" "TAILQ_HEAD *head2" "TYPE" "TAILQ_ENTRY NAME"
|
||||||
.\"
|
.\"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
These macros define and operate on four types of data structures:
|
These macros define and operate on four types of data structures which
|
||||||
singly-linked lists, singly-linked tail queues, lists, and tail queues.
|
can be used in both C and C++ source code:
|
||||||
|
.Bl -enum -compact -offset indent
|
||||||
|
.It
|
||||||
|
Lists
|
||||||
|
.It
|
||||||
|
Singly-linked lists
|
||||||
|
.It
|
||||||
|
Singly-linked tail queues
|
||||||
|
.It
|
||||||
|
Tail queues
|
||||||
|
.El
|
||||||
All four structures support the following functionality:
|
All four structures support the following functionality:
|
||||||
.Bl -enum -compact -offset indent
|
.Bl -enum -compact -offset indent
|
||||||
.It
|
.It
|
||||||
@ -230,6 +260,8 @@ Singly-linked lists add the following functionality:
|
|||||||
.Bl -enum -compact -offset indent
|
.Bl -enum -compact -offset indent
|
||||||
.It
|
.It
|
||||||
O(n) removal of any entry in the list.
|
O(n) removal of any entry in the list.
|
||||||
|
.It
|
||||||
|
O(n) concatenation of two lists.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Singly-linked tail queues add the following functionality:
|
Singly-linked tail queues add the following functionality:
|
||||||
@ -277,6 +309,8 @@ Linked lists are the simplest of the doubly linked data structures.
|
|||||||
They add the following functionality over the above:
|
They add the following functionality over the above:
|
||||||
.Bl -enum -compact -offset indent
|
.Bl -enum -compact -offset indent
|
||||||
.It
|
.It
|
||||||
|
O(n) concatenation of two lists.
|
||||||
|
.It
|
||||||
They may be traversed backwards.
|
They may be traversed backwards.
|
||||||
.El
|
.El
|
||||||
However:
|
However:
|
||||||
@ -308,24 +342,39 @@ than singly-linked lists.
|
|||||||
.Pp
|
.Pp
|
||||||
In the macro definitions,
|
In the macro definitions,
|
||||||
.Fa TYPE
|
.Fa TYPE
|
||||||
is the name of a user defined structure,
|
is the name of a user defined structure.
|
||||||
that must contain a field of type
|
The structure must contain a field called
|
||||||
|
.Fa NAME
|
||||||
|
which is of type
|
||||||
.Li SLIST_ENTRY ,
|
.Li SLIST_ENTRY ,
|
||||||
.Li STAILQ_ENTRY ,
|
.Li STAILQ_ENTRY ,
|
||||||
.Li LIST_ENTRY ,
|
.Li LIST_ENTRY ,
|
||||||
or
|
or
|
||||||
.Li TAILQ_ENTRY ,
|
.Li TAILQ_ENTRY .
|
||||||
named
|
In the macro definitions,
|
||||||
.Fa NAME .
|
.Fa CLASSTYPE
|
||||||
|
is the name of a user defined class.
|
||||||
|
The class must contain a field called
|
||||||
|
.Fa NAME
|
||||||
|
which is of type
|
||||||
|
.Li SLIST_CLASS_ENTRY ,
|
||||||
|
.Li STAILQ_CLASS_ENTRY ,
|
||||||
|
.Li LIST_CLASS_ENTRY ,
|
||||||
|
or
|
||||||
|
.Li TAILQ_CLASS_ENTRY .
|
||||||
The argument
|
The argument
|
||||||
.Fa HEADNAME
|
.Fa HEADNAME
|
||||||
is the name of a user defined structure that must be declared
|
is the name of a user defined structure that must be declared
|
||||||
using the macros
|
using the macros
|
||||||
.Li SLIST_HEAD ,
|
.Li SLIST_HEAD ,
|
||||||
|
.Li SLIST_CLASS_HEAD ,
|
||||||
.Li STAILQ_HEAD ,
|
.Li STAILQ_HEAD ,
|
||||||
|
.Li STAILQ_CLASS_HEAD ,
|
||||||
.Li LIST_HEAD ,
|
.Li LIST_HEAD ,
|
||||||
|
.Li LIST_CLASS_HEAD ,
|
||||||
|
.Li TAILQ_HEAD ,
|
||||||
or
|
or
|
||||||
.Li TAILQ_HEAD .
|
.Li TAILQ_CLASS_HEAD .
|
||||||
See the examples below for further explanation of how these
|
See the examples below for further explanation of how these
|
||||||
macros are used.
|
macros are used.
|
||||||
.Sh SINGLY-LINKED LISTS
|
.Sh SINGLY-LINKED LISTS
|
||||||
@ -367,6 +416,19 @@ evaluates to an initializer for the list
|
|||||||
.Fa head .
|
.Fa head .
|
||||||
.Pp
|
.Pp
|
||||||
The macro
|
The macro
|
||||||
|
.Nm SLIST_CONCAT
|
||||||
|
concatenates the list headed by
|
||||||
|
.Fa head2
|
||||||
|
onto the end of the one headed by
|
||||||
|
.Fa head1
|
||||||
|
removing all entries from the former.
|
||||||
|
Use of this macro should be avoided as it traverses the entirety of the
|
||||||
|
.Fa head1
|
||||||
|
list.
|
||||||
|
A singly-linked tail queue should be used if this macro is needed in
|
||||||
|
high-usage code paths or to operate on long lists.
|
||||||
|
.Pp
|
||||||
|
The macro
|
||||||
.Nm SLIST_EMPTY
|
.Nm SLIST_EMPTY
|
||||||
evaluates to true if there are no elements in the list.
|
evaluates to true if there are no elements in the list.
|
||||||
.Pp
|
.Pp
|
||||||
@ -474,6 +536,9 @@ The macro
|
|||||||
removes the element
|
removes the element
|
||||||
.Fa elm
|
.Fa elm
|
||||||
from the list.
|
from the list.
|
||||||
|
Use of this macro should be avoided as it traverses the entire list.
|
||||||
|
A doubly-linked list should be used if this macro is needed in
|
||||||
|
high-usage code paths or to operate on long lists.
|
||||||
.Pp
|
.Pp
|
||||||
The macro
|
The macro
|
||||||
.Nm SLIST_SWAP
|
.Nm SLIST_SWAP
|
||||||
@ -690,6 +755,9 @@ The macro
|
|||||||
removes the element
|
removes the element
|
||||||
.Fa elm
|
.Fa elm
|
||||||
from the tail queue.
|
from the tail queue.
|
||||||
|
Use of this macro should be avoided as it traverses the entire list.
|
||||||
|
A doubly-linked tail queue should be used if this macro is needed in
|
||||||
|
high-usage code paths or to operate on long tail queues.
|
||||||
.Pp
|
.Pp
|
||||||
The macro
|
The macro
|
||||||
.Nm STAILQ_SWAP
|
.Nm STAILQ_SWAP
|
||||||
@ -789,6 +857,19 @@ evaluates to an initializer for the list
|
|||||||
.Fa head .
|
.Fa head .
|
||||||
.Pp
|
.Pp
|
||||||
The macro
|
The macro
|
||||||
|
.Nm LIST_CONCAT
|
||||||
|
concatenates the list headed by
|
||||||
|
.Fa head2
|
||||||
|
onto the end of the one headed by
|
||||||
|
.Fa head1
|
||||||
|
removing all entries from the former.
|
||||||
|
Use of this macro should be avoided as it traverses the entirety of the
|
||||||
|
.Fa head1
|
||||||
|
list.
|
||||||
|
A tail queue should be used if this macro is needed in
|
||||||
|
high-usage code paths or to operate on long lists.
|
||||||
|
.Pp
|
||||||
|
The macro
|
||||||
.Nm LIST_EMPTY
|
.Nm LIST_EMPTY
|
||||||
evaluates to true if there are no elements in the list.
|
evaluates to true if there are no elements in the list.
|
||||||
.Pp
|
.Pp
|
||||||
@ -1210,6 +1291,26 @@ while (n1 != NULL) {
|
|||||||
}
|
}
|
||||||
TAILQ_INIT(&head);
|
TAILQ_INIT(&head);
|
||||||
.Ed
|
.Ed
|
||||||
|
.Sh DIAGNOSTICS
|
||||||
|
When debugging
|
||||||
|
.Nm queue(3) ,
|
||||||
|
it can be useful to trace queue changes.
|
||||||
|
To enable tracing, define the macro
|
||||||
|
.Va QUEUE_MACRO_DEBUG_TRACE
|
||||||
|
at compile time.
|
||||||
|
.Pp
|
||||||
|
It can also be useful to trash pointers that have been unlinked from a queue,
|
||||||
|
to detect use after removal.
|
||||||
|
To enable pointer trashing, define the macro
|
||||||
|
.Va QUEUE_MACRO_DEBUG_TRASH
|
||||||
|
at compile time.
|
||||||
|
The macro
|
||||||
|
.Fn QMD_IS_TRASHED "void *ptr"
|
||||||
|
returns true if
|
||||||
|
.Fa ptr
|
||||||
|
has been trashed by the
|
||||||
|
.Va QUEUE_MACRO_DEBUG_TRASH
|
||||||
|
option.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr tree 3bsd
|
.Xr tree 3bsd
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
|
@ -30,7 +30,7 @@
|
|||||||
.\" from: @(#)radixsort.3 8.2 (Berkeley) 1/27/94
|
.\" from: @(#)radixsort.3 8.2 (Berkeley) 1/27/94
|
||||||
.\"
|
.\"
|
||||||
.Dd January 27, 1994
|
.Dd January 27, 1994
|
||||||
.Dt RADIXSORT 3bsd
|
.Dt radixsort 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm radixsort ,
|
.Nm radixsort ,
|
||||||
|
@ -19,7 +19,7 @@
|
|||||||
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
|
.\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
|
||||||
.\"
|
.\"
|
||||||
.Dd $Mdocdate: March 6 2014 $
|
.Dd $Mdocdate: March 6 2014 $
|
||||||
.Dt READPASSPHRASE 3bsd
|
.Dt readpassphrase 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm readpassphrase
|
.Nm readpassphrase
|
||||||
@ -165,10 +165,12 @@ will reprint the prompt and the user may then enter a passphrase.
|
|||||||
The
|
The
|
||||||
.Fn readpassphrase
|
.Fn readpassphrase
|
||||||
function is an
|
function is an
|
||||||
.Ox
|
.Bx
|
||||||
extension and should not be used if portability is desired.
|
extension and should not be used if portability is desired.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
The
|
The
|
||||||
.Fn readpassphrase
|
.Fn readpassphrase
|
||||||
function first appeared in
|
function first appeared in
|
||||||
.Ox 2.9 .
|
.Ox 2.9
|
||||||
|
and
|
||||||
|
.Fx 4.6 .
|
||||||
|
@ -33,7 +33,7 @@
|
|||||||
.\" $OpenBSD: malloc.3,v 1.126 2019/09/14 13:16:50 otto Exp $
|
.\" $OpenBSD: malloc.3,v 1.126 2019/09/14 13:16:50 otto Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd $Mdocdate: September 14 2019 $
|
.Dd $Mdocdate: September 14 2019 $
|
||||||
.Dt REALLOCARRAY 3bsd
|
.Dt reallocarray 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm reallocarray ,
|
.Nm reallocarray ,
|
||||||
@ -283,12 +283,18 @@ The
|
|||||||
.Fn reallocarray
|
.Fn reallocarray
|
||||||
function appeared in
|
function appeared in
|
||||||
.Ox 5.6 ,
|
.Ox 5.6 ,
|
||||||
|
.Dx 5.5
|
||||||
and glibc 2.26.
|
and glibc 2.26.
|
||||||
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn recallocarray
|
.Fn recallocarray
|
||||||
function appeared in
|
function appeared in
|
||||||
.Ox 6.1 .
|
.Ox 6.1
|
||||||
|
and
|
||||||
|
.Dx 5.5 .
|
||||||
The
|
The
|
||||||
.Fn freezero
|
.Fn freezero
|
||||||
function appeared in
|
function appeared in
|
||||||
.Ox 6.2 .
|
.Ox 6.2
|
||||||
|
and
|
||||||
|
.Dx 5.5 .
|
||||||
|
@ -33,7 +33,7 @@
|
|||||||
.\" $FreeBSD: src/lib/libc/stdlib/malloc.3,v 1.80.2.2.2.1 2010/06/14 02:09:06 kensmith Exp $
|
.\" $FreeBSD: src/lib/libc/stdlib/malloc.3,v 1.80.2.2.2.1 2010/06/14 02:09:06 kensmith Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd September 26, 2009
|
.Dd September 26, 2009
|
||||||
.Dt REALLOCF 3bsd
|
.Dt reallocf 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm reallocf
|
.Nm reallocf
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
.\" $FreeBSD: src/lib/libc/gen/setmode.3,v 1.12 2007/01/09 00:27:55 imp Exp $
|
.\" $FreeBSD: src/lib/libc/gen/setmode.3,v 1.12 2007/01/09 00:27:55 imp Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd January 4, 2009
|
.Dd January 4, 2009
|
||||||
.Dt SETMODE 3bsd
|
.Dt setmode 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm getmode ,
|
.Nm getmode ,
|
||||||
|
@ -20,8 +20,8 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.\" The following requests are required for all man pages.
|
.\" The following requests are required for all man pages.
|
||||||
.Dd December 16, 1995
|
.Dd December 7, 2022
|
||||||
.Dt SETPROCTITLE 3bsd
|
.Dt setproctitle 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm setproctitle
|
.Nm setproctitle
|
||||||
@ -31,7 +31,6 @@
|
|||||||
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
||||||
.Lb libbsd
|
.Lb libbsd
|
||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.In sys/types.h
|
|
||||||
.In unistd.h
|
.In unistd.h
|
||||||
(See
|
(See
|
||||||
.Xr libbsd 7
|
.Xr libbsd 7
|
||||||
@ -54,7 +53,7 @@ library routine only needs to be called (before any call to
|
|||||||
and with
|
and with
|
||||||
.Fn main
|
.Fn main
|
||||||
arguments), if the automatic constructor support has not
|
arguments), if the automatic constructor support has not
|
||||||
been linked in through the libbsd-ctor pkg-config file.
|
been linked in through the libbsd-ctor pkgconf file.
|
||||||
.Pp
|
.Pp
|
||||||
The title is set from the executable's name, followed by the
|
The title is set from the executable's name, followed by the
|
||||||
result of a
|
result of a
|
||||||
@ -113,6 +112,8 @@ The
|
|||||||
.Fn setproctitle
|
.Fn setproctitle
|
||||||
function
|
function
|
||||||
first appeared in
|
first appeared in
|
||||||
|
.Nx 1.0
|
||||||
|
and
|
||||||
.Fx 2.2 .
|
.Fx 2.2 .
|
||||||
Other operating systems have
|
Other operating systems have
|
||||||
similar functions.
|
similar functions.
|
||||||
|
@ -27,7 +27,7 @@
|
|||||||
.\" POSSIBILITY OF SUCH DAMAGE.
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.Dd May 6, 2010
|
.Dd May 6, 2010
|
||||||
.Dt STRINGLIST 3bsd
|
.Dt stringlist 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm stringlist ,
|
.Nm stringlist ,
|
||||||
|
@ -14,8 +14,8 @@
|
|||||||
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
||||||
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
.\"
|
.\"
|
||||||
.Dd $Mdocdate: May 31 2007 $
|
.Dd $Mdocdate: January 7 2024 $
|
||||||
.Dt STRLCPY 3bsd
|
.Dt strlcpy 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm strlcpy ,
|
.Nm strlcpy ,
|
||||||
@ -192,4 +192,7 @@ and
|
|||||||
functions first appeared in
|
functions first appeared in
|
||||||
.Ox 2.4 ,
|
.Ox 2.4 ,
|
||||||
and made their appearance in
|
and made their appearance in
|
||||||
.Fx 3.3 .
|
.Nx 1.4.3 ,
|
||||||
|
.Fx 3.3
|
||||||
|
and
|
||||||
|
glibc 2.38.
|
||||||
|
@ -29,7 +29,7 @@
|
|||||||
.\" $FreeBSD: src/lib/libc/string/strmode.3,v 1.9 2003/07/01 15:28:05 maxim Exp $
|
.\" $FreeBSD: src/lib/libc/string/strmode.3,v 1.9 2003/07/01 15:28:05 maxim Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd July 28, 1994
|
.Dd July 28, 1994
|
||||||
.Dt STRMODE 3bsd
|
.Dt strmode 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm strmode
|
.Nm strmode
|
||||||
|
@ -34,7 +34,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd October 11, 2001
|
.Dd October 11, 2001
|
||||||
.Dt STRSTR 3bsd
|
.Dt strstr 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm strnstr
|
.Nm strnstr
|
||||||
@ -112,3 +112,8 @@ ptr = strnstr(largestring, smallstring, 4);
|
|||||||
.Xr strspn 3 ,
|
.Xr strspn 3 ,
|
||||||
.Xr strtok 3 ,
|
.Xr strtok 3 ,
|
||||||
.Xr wcsstr 3
|
.Xr wcsstr 3
|
||||||
|
.Sh HISTORY
|
||||||
|
The
|
||||||
|
.Fn strnstr
|
||||||
|
function originated in
|
||||||
|
.Fx .
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
.\" $NetBSD: strtoi.3,v 1.7 2017/07/03 21:32:50 wiz Exp $
|
.\" $NetBSD: strtoi.3,v 1.10 2024/02/10 18:43:51 andvar Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 1990, 1991, 1993
|
.\" Copyright (c) 1990, 1991, 1993
|
||||||
.\" The Regents of the University of California. All rights reserved.
|
.\" The Regents of the University of California. All rights reserved.
|
||||||
@ -36,12 +36,12 @@
|
|||||||
.\" Created by Kamil Rytarowski, based on ID:
|
.\" Created by Kamil Rytarowski, based on ID:
|
||||||
.\" NetBSD: strtol.3,v 1.31 2015/03/11 09:57:35 wiz Exp
|
.\" NetBSD: strtol.3,v 1.31 2015/03/11 09:57:35 wiz Exp
|
||||||
.\"
|
.\"
|
||||||
.Dd November 13, 2015
|
.Dd January 20, 2024
|
||||||
.Dt STRTOI 3bsd
|
.Dt strtoi 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm strtoi
|
.Nm strtoi
|
||||||
.Nd convert string value to an intmax_t integer
|
.Nd convert a string value to an intmax_t integer
|
||||||
.Sh LIBRARY
|
.Sh LIBRARY
|
||||||
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
||||||
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
||||||
@ -63,8 +63,7 @@ for include usage.)
|
|||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Fn strtoi
|
.Fn strtoi
|
||||||
function
|
function converts the string in
|
||||||
converts the string in
|
|
||||||
.Fa nptr
|
.Fa nptr
|
||||||
to an
|
to an
|
||||||
.Ft intmax_t
|
.Ft intmax_t
|
||||||
@ -77,7 +76,7 @@ and ensures that the result is always in the range [
|
|||||||
.Fa lo ..
|
.Fa lo ..
|
||||||
.Fa hi
|
.Fa hi
|
||||||
].
|
].
|
||||||
In adddition it always places
|
In addition it always places
|
||||||
.Dv 0
|
.Dv 0
|
||||||
on success or a conversion status in the
|
on success or a conversion status in the
|
||||||
.Fa rstatus
|
.Fa rstatus
|
||||||
@ -122,10 +121,11 @@ is taken as 10 (decimal) unless the next character is
|
|||||||
.Ql 0 ,
|
.Ql 0 ,
|
||||||
in which case it is taken as 8 (octal).
|
in which case it is taken as 8 (octal).
|
||||||
.Pp
|
.Pp
|
||||||
The remainder of the string is converted to a
|
The remainder of the string is converted to an
|
||||||
.Em intmax_t
|
.Em intmax_t
|
||||||
value in the obvious manner,
|
value in the obvious manner,
|
||||||
stopping at the first character which is not a valid digit
|
stopping at the end of the string
|
||||||
|
or at the first character which is not a valid digit
|
||||||
in the given base.
|
in the given base.
|
||||||
(In bases above 10, the letter
|
(In bases above 10, the letter
|
||||||
.Ql A
|
.Ql A
|
||||||
@ -206,6 +206,12 @@ or the range given was invalid, i.e.
|
|||||||
>
|
>
|
||||||
.Fa hi .
|
.Fa hi .
|
||||||
.El
|
.El
|
||||||
|
.Pp
|
||||||
|
The range check is more important than the unconverted characters check,
|
||||||
|
and it is performed first.
|
||||||
|
If a program needs to know if there were unconverted characters when an
|
||||||
|
out of range number has been provided, it needs to supply and test
|
||||||
|
.Fa endptr.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr atof 3 ,
|
.Xr atof 3 ,
|
||||||
.Xr atoi 3 ,
|
.Xr atoi 3 ,
|
||||||
@ -233,7 +239,7 @@ function first appeared in
|
|||||||
.Nx 7.0 .
|
.Nx 7.0 .
|
||||||
.Ox
|
.Ox
|
||||||
introduced the
|
introduced the
|
||||||
.Fn strtonum 3bsd
|
.Xr strtonum 3bsd
|
||||||
function for the same purpose, but the interface makes it impossible to
|
function for the same purpose, but the interface makes it impossible to
|
||||||
properly differentiate illegal returns.
|
properly differentiate illegal returns.
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
|
@ -16,7 +16,7 @@
|
|||||||
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
.\"
|
.\"
|
||||||
.Dd January 18, 2015
|
.Dd January 18, 2015
|
||||||
.Dt STRTONUM 3bsd
|
.Dt strtonum 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm strtonum
|
.Nm strtonum
|
||||||
@ -141,8 +141,8 @@ The string did not consist solely of digit characters.
|
|||||||
.Xr strtoull 3
|
.Xr strtoull 3
|
||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
.Fn strtonum
|
.Fn strtonum
|
||||||
is an
|
is a
|
||||||
.Ox
|
.Bx
|
||||||
extension.
|
extension.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
.ds doc-operating-system-NetBSD-8.0 8.0
|
.ds doc-operating-system-NetBSD-8.0 8.0
|
||||||
@ -154,9 +154,9 @@ function first appeared in
|
|||||||
was redesigned in
|
was redesigned in
|
||||||
.Nx 8.0
|
.Nx 8.0
|
||||||
as
|
as
|
||||||
.Fn strtoi 3bsd
|
.Xr strtoi 3bsd
|
||||||
and
|
and
|
||||||
.Fn strtou 3bsd .
|
.Xr strtou 3bsd .
|
||||||
.Sh CAVEATS
|
.Sh CAVEATS
|
||||||
The
|
The
|
||||||
.Fn strtonum
|
.Fn strtonum
|
||||||
@ -186,6 +186,6 @@ To overcome the shortcomings of
|
|||||||
.Fn strtonum
|
.Fn strtonum
|
||||||
.Nx
|
.Nx
|
||||||
provides
|
provides
|
||||||
.Fn strtou 3bsd
|
.Xr strtou 3bsd
|
||||||
and
|
and
|
||||||
.Fn strtoi 3bsd .
|
.Xr strtoi 3bsd .
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
.\" $NetBSD: strtou.3,v 1.7 2017/07/03 21:32:50 wiz Exp $
|
.\" $NetBSD: strtou.3,v 1.8 2024/01/20 16:13:39 christos Exp $
|
||||||
.\"
|
.\"
|
||||||
.\" Copyright (c) 1990, 1991, 1993
|
.\" Copyright (c) 1990, 1991, 1993
|
||||||
.\" The Regents of the University of California. All rights reserved.
|
.\" The Regents of the University of California. All rights reserved.
|
||||||
@ -36,12 +36,12 @@
|
|||||||
.\" Created by Kamil Rytarowski, based on ID:
|
.\" Created by Kamil Rytarowski, based on ID:
|
||||||
.\" NetBSD: strtoul.3,v 1.29 2015/03/10 13:00:58 christos Exp
|
.\" NetBSD: strtoul.3,v 1.29 2015/03/10 13:00:58 christos Exp
|
||||||
.\"
|
.\"
|
||||||
.Dd November 13, 2015
|
.Dd January 20, 2024
|
||||||
.Dt STRTOU 3bsd
|
.Dt strtou 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm strtou
|
.Nm strtou
|
||||||
.Nd convert a string to an uintmax_t integer
|
.Nd convert a string value to an uintmax_t integer
|
||||||
.Sh LIBRARY
|
.Sh LIBRARY
|
||||||
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
||||||
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
||||||
@ -76,7 +76,7 @@ and ensures that the result is always in the range [
|
|||||||
.Fa lo ..
|
.Fa lo ..
|
||||||
.Fa hi
|
.Fa hi
|
||||||
].
|
].
|
||||||
In adddition it always places
|
In addition it always places
|
||||||
.Dv 0
|
.Dv 0
|
||||||
on success or a conversion status in the
|
on success or a conversion status in the
|
||||||
.Fa rstatus
|
.Fa rstatus
|
||||||
@ -125,7 +125,7 @@ The remainder of the string is converted to an
|
|||||||
.Em uintmax_t
|
.Em uintmax_t
|
||||||
value in the obvious manner,
|
value in the obvious manner,
|
||||||
stopping at the end of the string
|
stopping at the end of the string
|
||||||
or at the first character that does not produce a valid digit
|
or at the first character which is not a valid digit
|
||||||
in the given base.
|
in the given base.
|
||||||
(In bases above 10, the letter
|
(In bases above 10, the letter
|
||||||
.Ql A
|
.Ql A
|
||||||
@ -200,12 +200,18 @@ In this case,
|
|||||||
.Fa endptr
|
.Fa endptr
|
||||||
points to the first unconverted character.
|
points to the first unconverted character.
|
||||||
.It Bq Er ERANGE
|
.It Bq Er ERANGE
|
||||||
The given string was out of range; the value converted has been clamped; or
|
The given string was out of range; the value converted has been clamped;
|
||||||
the range given was invalid, i.e.
|
or the range given was invalid, i.e.
|
||||||
.Fa lo
|
.Fa lo
|
||||||
>
|
>
|
||||||
.Fa hi .
|
.Fa hi .
|
||||||
.El
|
.El
|
||||||
|
.Pp
|
||||||
|
The range check is more important than the unconverted characters check,
|
||||||
|
and it is performed first.
|
||||||
|
If a program needs to know if there were unconverted characters when an
|
||||||
|
out of range number has been provided, it needs to supply and test
|
||||||
|
.Fa endptr.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr atof 3 ,
|
.Xr atof 3 ,
|
||||||
.Xr atoi 3 ,
|
.Xr atoi 3 ,
|
||||||
@ -220,20 +226,20 @@ the range given was invalid, i.e.
|
|||||||
.Xr strtoull 3 ,
|
.Xr strtoull 3 ,
|
||||||
.Xr strtoumax 3
|
.Xr strtoumax 3
|
||||||
.Sh STANDARDS
|
.Sh STANDARDS
|
||||||
.ds doc-operating-system-NetBSD-7.0 7.0
|
|
||||||
The
|
The
|
||||||
.Fn strtou
|
.Fn strtou
|
||||||
function is a
|
function is a
|
||||||
.Nx
|
.Nx
|
||||||
extension.
|
extension.
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
|
.ds doc-operating-system-NetBSD-7.0 7.0
|
||||||
The
|
The
|
||||||
.Fn strtou
|
.Fn strtou
|
||||||
function first appeared in
|
function first appeared in
|
||||||
.Nx 7.0 .
|
.Nx 7.0 .
|
||||||
.Ox
|
.Ox
|
||||||
introduced the
|
introduced the
|
||||||
.Fn strtonum 3bsd
|
.Xr strtonum 3bsd
|
||||||
function for the same purpose, but the interface makes it impossible to
|
function for the same purpose, but the interface makes it impossible to
|
||||||
properly differentiate illegal returns.
|
properly differentiate illegal returns.
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
|
@ -31,7 +31,7 @@
|
|||||||
.\" $FreeBSD: src/share/man/man3/timeradd.3,v 1.3 2003/09/08 19:57:19 ru Exp $
|
.\" $FreeBSD: src/share/man/man3/timeradd.3,v 1.3 2003/09/08 19:57:19 ru Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd June 7, 2010
|
.Dd June 7, 2010
|
||||||
.Dt TIMERADD 3bsd
|
.Dt timeradd 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm timeradd ,
|
.Nm timeradd ,
|
||||||
|
@ -1 +0,0 @@
|
|||||||
.so man3/timeval.3bsd
|
|
134
man/timeval.3bsd
134
man/timeval.3bsd
@ -1,134 +0,0 @@
|
|||||||
.\" $NetBSD: timeval.3,v 1.12 2011/04/12 08:39:26 jruoho Exp $
|
|
||||||
.\"
|
|
||||||
.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
|
|
||||||
.\" All rights reserved.
|
|
||||||
.\"
|
|
||||||
.\" This code is derived from software contributed to The NetBSD Foundation
|
|
||||||
.\" by Jukka Ruohonen.
|
|
||||||
.\"
|
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
|
||||||
.\" modification, are permitted provided that the following conditions
|
|
||||||
.\" are met:
|
|
||||||
.\" 1. Redistributions of source code must retain the above copyright
|
|
||||||
.\" notice, this list of conditions and the following disclaimer.
|
|
||||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
||||||
.\" notice, this list of conditions and the following disclaimer in the
|
|
||||||
.\" documentation and/or other materials provided with the distribution.
|
|
||||||
.\"
|
|
||||||
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
||||||
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
||||||
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
||||||
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
||||||
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
||||||
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
||||||
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
||||||
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
||||||
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
||||||
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
||||||
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
.\"
|
|
||||||
.Dd April 12, 2011
|
|
||||||
.Dt TIMEVAL 3bsd
|
|
||||||
.Os
|
|
||||||
.Sh NAME
|
|
||||||
.Nm timeval ,
|
|
||||||
.Nm timespec
|
|
||||||
.Nd time structures
|
|
||||||
.Sh LIBRARY
|
|
||||||
.ds str-Lb-libbsd Utility functions from BSD systems (libbsd, \-lbsd)
|
|
||||||
.ds doc-str-Lb-libbsd \*[str-Lb-libbsd]
|
|
||||||
.Lb libbsd
|
|
||||||
.Sh SYNOPSIS
|
|
||||||
.In sys/time.h
|
|
||||||
(See
|
|
||||||
.Xr libbsd 7
|
|
||||||
for include usage.)
|
|
||||||
.Ft void
|
|
||||||
.Fn TIMEVAL_TO_TIMESPEC "struct timeval *tv" "struct timespec *ts"
|
|
||||||
.Ft void
|
|
||||||
.Fn TIMESPEC_TO_TIMEVAL "struct timeval *tv" "struct timespec *ts"
|
|
||||||
.Sh DESCRIPTION
|
|
||||||
The
|
|
||||||
.In sys/time.h
|
|
||||||
header, included by
|
|
||||||
.In time.h ,
|
|
||||||
defines various structures related to time and timers.
|
|
||||||
.Bl -enum -offset 1n
|
|
||||||
.It
|
|
||||||
The following structure is used by
|
|
||||||
.Xr gettimeofday 2 ,
|
|
||||||
among others:
|
|
||||||
.Bd -literal -offset indent
|
|
||||||
struct timeval {
|
|
||||||
time_t tv_sec;
|
|
||||||
suseconds_t tv_usec;
|
|
||||||
};
|
|
||||||
.Ed
|
|
||||||
.Pp
|
|
||||||
The
|
|
||||||
.Va tv_sec
|
|
||||||
member represents the elapsed time, in whole seconds.
|
|
||||||
The
|
|
||||||
.Va tv_usec
|
|
||||||
member captures rest of the elapsed time,
|
|
||||||
represented as the number of microseconds.
|
|
||||||
.It
|
|
||||||
The following structure is used by
|
|
||||||
.Xr nanosleep 2 ,
|
|
||||||
among others:
|
|
||||||
.Bd -literal -offset indent
|
|
||||||
struct timespec {
|
|
||||||
time_t tv_sec;
|
|
||||||
long tv_nsec;
|
|
||||||
};
|
|
||||||
.Ed
|
|
||||||
.Pp
|
|
||||||
The
|
|
||||||
.Va tv_sec
|
|
||||||
member is again the elapsed time in whole seconds.
|
|
||||||
The
|
|
||||||
.Va tv_nsec
|
|
||||||
member represents the rest of the elapsed time in nanoseconds.
|
|
||||||
.Pp
|
|
||||||
A microsecond is equal to one millionth of a second,
|
|
||||||
1000 nanoseconds, or 1/1000 milliseconds.
|
|
||||||
To ease the conversions, the macros
|
|
||||||
.Fn TIMEVAL_TO_TIMESPEC
|
|
||||||
and
|
|
||||||
.Fn TIMESPEC_TO_TIMEVAL
|
|
||||||
can be used to convert between
|
|
||||||
.Em struct timeval
|
|
||||||
and
|
|
||||||
.Em struct timespec .
|
|
||||||
.El
|
|
||||||
.Sh EXAMPLES
|
|
||||||
It can be stressed that the traditional
|
|
||||||
.Tn UNIX
|
|
||||||
.Va timeval
|
|
||||||
and
|
|
||||||
.Va timespec
|
|
||||||
structures represent elapsed time, measured by the system clock.
|
|
||||||
The following sketch implements a function suitable
|
|
||||||
for use in a context where the
|
|
||||||
.Va timespec
|
|
||||||
structure is required for a conditional timeout:
|
|
||||||
.Bd -literal -offset indent
|
|
||||||
static void
|
|
||||||
example(struct timespec *spec, time_t minutes)
|
|
||||||
{
|
|
||||||
struct timeval elapsed;
|
|
||||||
|
|
||||||
(void)gettimeofday(&elapsed, NULL);
|
|
||||||
|
|
||||||
_DIAGASSERT(spec != NULL);
|
|
||||||
TIMEVAL_TO_TIMESPEC(&elapsed, spec);
|
|
||||||
|
|
||||||
/* Add the offset for timeout in minutes. */
|
|
||||||
spec->tv_sec = spec->tv_sec + minutes * 60;
|
|
||||||
}
|
|
||||||
.Ed
|
|
||||||
.Pp
|
|
||||||
A better alternative would use the more precise
|
|
||||||
.Xr clock_gettime 2 .
|
|
||||||
.Sh SEE ALSO
|
|
||||||
.Xr timeradd 3bsd
|
|
396
man/tree.3bsd
396
man/tree.3bsd
@ -1,37 +1,30 @@
|
|||||||
.\" $OpenBSD: tree.3,v 1.7 2002/06/12 01:09:20 provos Exp $
|
.\" $OpenBSD: tree.3,v 1.30 2019/05/10 13:13:14 florian Exp $
|
||||||
.\"
|
.\"/*
|
||||||
.\" Copyright 2002 Niels Provos <provos@citi.umich.edu>
|
.\" * Copyright 2002 Niels Provos <provos@citi.umich.edu>
|
||||||
.\" All rights reserved.
|
.\" * All rights reserved.
|
||||||
.\"
|
.\" *
|
||||||
.\" Redistribution and use in source and binary forms, with or without
|
.\" * Redistribution and use in source and binary forms, with or without
|
||||||
.\" modification, are permitted provided that the following conditions
|
.\" * modification, are permitted provided that the following conditions
|
||||||
.\" are met:
|
.\" * are met:
|
||||||
.\" 1. Redistributions of source code must retain the above copyright
|
.\" * 1. Redistributions of source code must retain the above copyright
|
||||||
.\" notice, this list of conditions and the following disclaimer.
|
.\" * notice, this list of conditions and the following disclaimer.
|
||||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
.\" * 2. Redistributions in binary form must reproduce the above copyright
|
||||||
.\" notice, this list of conditions and the following disclaimer in the
|
.\" * notice, this list of conditions and the following disclaimer in the
|
||||||
.\" documentation and/or other materials provided with the distribution.
|
.\" * documentation and/or other materials provided with the distribution.
|
||||||
.\" 3. All advertising materials mentioning features or use of this software
|
.\" *
|
||||||
.\" must display the following acknowledgement:
|
.\" * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
||||||
.\" This product includes software developed by Niels Provos.
|
.\" * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||||
.\" 4. The name of the author may not be used to endorse or promote products
|
.\" * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
||||||
.\" derived from this software without specific prior written permission.
|
.\" * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||||||
.\"
|
.\" * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
||||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
.\" * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
||||||
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
.\" * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
||||||
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
.\" * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||||
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
.\" * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
||||||
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
.\" * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
.\" */
|
||||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
.Dd May 10, 2019
|
||||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
.Dt tree 3bsd
|
||||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
||||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
.\"
|
|
||||||
.\" $FreeBSD$
|
|
||||||
.\"
|
|
||||||
.Dd December 27, 2007
|
|
||||||
.Dt TREE 3bsd
|
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm SPLAY_PROTOTYPE ,
|
.Nm SPLAY_PROTOTYPE ,
|
||||||
@ -70,7 +63,9 @@
|
|||||||
.Nm RB_RIGHT ,
|
.Nm RB_RIGHT ,
|
||||||
.Nm RB_PARENT ,
|
.Nm RB_PARENT ,
|
||||||
.Nm RB_FOREACH ,
|
.Nm RB_FOREACH ,
|
||||||
|
.Nm RB_FOREACH_SAFE ,
|
||||||
.Nm RB_FOREACH_REVERSE ,
|
.Nm RB_FOREACH_REVERSE ,
|
||||||
|
.Nm RB_FOREACH_REVERSE_SAFE ,
|
||||||
.Nm RB_INIT ,
|
.Nm RB_INIT ,
|
||||||
.Nm RB_INSERT ,
|
.Nm RB_INSERT ,
|
||||||
.Nm RB_REMOVE
|
.Nm RB_REMOVE
|
||||||
@ -84,88 +79,92 @@
|
|||||||
(See
|
(See
|
||||||
.Xr libbsd 7
|
.Xr libbsd 7
|
||||||
for include usage.)
|
for include usage.)
|
||||||
.Fn SPLAY_PROTOTYPE NAME TYPE FIELD CMP
|
.Pp
|
||||||
.Fn SPLAY_GENERATE NAME TYPE FIELD CMP
|
.Fn SPLAY_PROTOTYPE "NAME" "TYPE" "FIELD" "CMP"
|
||||||
.Fn SPLAY_ENTRY TYPE
|
.Fn SPLAY_GENERATE "NAME" "TYPE" "FIELD" "CMP"
|
||||||
.Fn SPLAY_HEAD HEADNAME TYPE
|
.Fn SPLAY_ENTRY "TYPE"
|
||||||
|
.Fn SPLAY_HEAD "HEADNAME" "TYPE"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_INITIALIZER "SPLAY_HEAD *head"
|
.Fn SPLAY_INITIALIZER "SPLAY_HEAD *head"
|
||||||
.Fn SPLAY_ROOT "SPLAY_HEAD *head"
|
.Fn SPLAY_ROOT "SPLAY_HEAD *head"
|
||||||
.Ft bool
|
.Ft "int"
|
||||||
.Fn SPLAY_EMPTY "SPLAY_HEAD *head"
|
.Fn SPLAY_EMPTY "SPLAY_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_NEXT NAME "SPLAY_HEAD *head" "struct TYPE *elm"
|
.Fn SPLAY_NEXT "NAME" "SPLAY_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_MIN NAME "SPLAY_HEAD *head"
|
.Fn SPLAY_MIN "NAME" "SPLAY_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_MAX NAME "SPLAY_HEAD *head"
|
.Fn SPLAY_MAX "NAME" "SPLAY_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_FIND NAME "SPLAY_HEAD *head" "struct TYPE *elm"
|
.Fn SPLAY_FIND "NAME" "SPLAY_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_LEFT "struct TYPE *elm" "SPLAY_ENTRY NAME"
|
.Fn SPLAY_LEFT "struct TYPE *elm" "SPLAY_ENTRY NAME"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_RIGHT "struct TYPE *elm" "SPLAY_ENTRY NAME"
|
.Fn SPLAY_RIGHT "struct TYPE *elm" "SPLAY_ENTRY NAME"
|
||||||
.Fn SPLAY_FOREACH VARNAME NAME "SPLAY_HEAD *head"
|
.Fn SPLAY_FOREACH "VARNAME" "NAME" "SPLAY_HEAD *head"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn SPLAY_INIT "SPLAY_HEAD *head"
|
.Fn SPLAY_INIT "SPLAY_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_INSERT NAME "SPLAY_HEAD *head" "struct TYPE *elm"
|
.Fn SPLAY_INSERT "NAME" "SPLAY_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn SPLAY_REMOVE NAME "SPLAY_HEAD *head" "struct TYPE *elm"
|
.Fn SPLAY_REMOVE "NAME" "SPLAY_HEAD *head" "struct TYPE *elm"
|
||||||
.Fn RB_PROTOTYPE NAME TYPE FIELD CMP
|
.Pp
|
||||||
.Fn RB_PROTOTYPE_STATIC NAME TYPE FIELD CMP
|
.Fn RB_PROTOTYPE "NAME" "TYPE" "FIELD" "CMP"
|
||||||
.Fn RB_GENERATE NAME TYPE FIELD CMP
|
.Fn RB_PROTOTYPE_STATIC "NAME" "TYPE" "FIELD" "CMP"
|
||||||
.Fn RB_GENERATE_STATIC NAME TYPE FIELD CMP
|
.Fn RB_GENERATE "NAME" "TYPE" "FIELD" "CMP"
|
||||||
.Fn RB_ENTRY TYPE
|
.Fn RB_GENERATE_STATIC "NAME" "TYPE" "FIELD" "CMP"
|
||||||
.Fn RB_HEAD HEADNAME TYPE
|
.Fn RB_ENTRY "TYPE"
|
||||||
|
.Fn RB_HEAD "HEADNAME" "TYPE"
|
||||||
.Fn RB_INITIALIZER "RB_HEAD *head"
|
.Fn RB_INITIALIZER "RB_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_ROOT "RB_HEAD *head"
|
.Fn RB_ROOT "RB_HEAD *head"
|
||||||
.Ft "bool"
|
.Ft "int"
|
||||||
.Fn RB_EMPTY "RB_HEAD *head"
|
.Fn RB_EMPTY "RB_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_NEXT NAME "RB_HEAD *head" "struct TYPE *elm"
|
.Fn RB_NEXT "NAME" "RB_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_PREV NAME "RB_HEAD *head" "struct TYPE *elm"
|
.Fn RB_PREV "NAME" "RB_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_MIN NAME "RB_HEAD *head"
|
.Fn RB_MIN "NAME" "RB_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_MAX NAME "RB_HEAD *head"
|
.Fn RB_MAX "NAME" "RB_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_FIND NAME "RB_HEAD *head" "struct TYPE *elm"
|
.Fn RB_FIND "NAME" "RB_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_NFIND NAME "RB_HEAD *head" "struct TYPE *elm"
|
.Fn RB_NFIND "NAME" "RB_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_LEFT "struct TYPE *elm" "RB_ENTRY NAME"
|
.Fn RB_LEFT "struct TYPE *elm" "RB_ENTRY NAME"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_RIGHT "struct TYPE *elm" "RB_ENTRY NAME"
|
.Fn RB_RIGHT "struct TYPE *elm" "RB_ENTRY NAME"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_PARENT "struct TYPE *elm" "RB_ENTRY NAME"
|
.Fn RB_PARENT "struct TYPE *elm" "RB_ENTRY NAME"
|
||||||
.Fn RB_FOREACH VARNAME NAME "RB_HEAD *head"
|
.Fn RB_FOREACH "VARNAME" "NAME" "RB_HEAD *head"
|
||||||
.Fn RB_FOREACH_REVERSE VARNAME NAME "RB_HEAD *head"
|
.Fn RB_FOREACH_SAFE "VARNAME" "NAME" "RB_HEAD *head" "TEMP_VARNAME"
|
||||||
|
.Fn RB_FOREACH_REVERSE "VARNAME" "NAME" "RB_HEAD *head"
|
||||||
|
.Fn RB_FOREACH_REVERSE_SAFE "VARNAME" "NAME" "RB_HEAD *head" "TEMP_VARNAME"
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn RB_INIT "RB_HEAD *head"
|
.Fn RB_INIT "RB_HEAD *head"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_INSERT NAME "RB_HEAD *head" "struct TYPE *elm"
|
.Fn RB_INSERT "NAME" "RB_HEAD *head" "struct TYPE *elm"
|
||||||
.Ft "struct TYPE *"
|
.Ft "struct TYPE *"
|
||||||
.Fn RB_REMOVE NAME "RB_HEAD *head" "struct TYPE *elm"
|
.Fn RB_REMOVE "NAME" "RB_HEAD *head" "struct TYPE *elm"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
These macros define data structures for different types of trees:
|
These macros define data structures for different types of trees:
|
||||||
splay trees and red-black trees.
|
splay trees and red-black trees.
|
||||||
.Pp
|
.Pp
|
||||||
In the macro definitions,
|
In the macro definitions,
|
||||||
.Fa TYPE
|
.Fa TYPE
|
||||||
is the name tag of a user defined structure that must contain a field of type
|
is the name tag of a user defined structure that must contain a field named
|
||||||
.Vt SPLAY_ENTRY ,
|
.Fa FIELD ,
|
||||||
|
of type
|
||||||
|
.Li SPLAY_ENTRY
|
||||||
or
|
or
|
||||||
.Vt RB_ENTRY ,
|
.Li RB_ENTRY .
|
||||||
named
|
|
||||||
.Fa ENTRYNAME .
|
|
||||||
The argument
|
The argument
|
||||||
.Fa HEADNAME
|
.Fa HEADNAME
|
||||||
is the name tag of a user defined structure that must be declared
|
is the name tag of a user defined structure that must be declared
|
||||||
using the macros
|
using the macros
|
||||||
.Fn SPLAY_HEAD ,
|
.Fn SPLAY_HEAD
|
||||||
or
|
or
|
||||||
.Fn RB_HEAD .
|
.Fn RB_HEAD .
|
||||||
The argument
|
The argument
|
||||||
@ -173,46 +172,38 @@ The argument
|
|||||||
has to be a unique name prefix for every tree that is defined.
|
has to be a unique name prefix for every tree that is defined.
|
||||||
.Pp
|
.Pp
|
||||||
The function prototypes are declared with
|
The function prototypes are declared with
|
||||||
.Fn SPLAY_PROTOTYPE ,
|
.Li SPLAY_PROTOTYPE ,
|
||||||
.Fn RB_PROTOTYPE ,
|
.Li RB_PROTOTYPE ,
|
||||||
or
|
or
|
||||||
.Fn RB_PROTOTYPE_STATIC .
|
.Li RB_PROTOTYPE_STATIC .
|
||||||
The function bodies are generated with
|
The function bodies are generated with
|
||||||
.Fn SPLAY_GENERATE ,
|
.Li SPLAY_GENERATE ,
|
||||||
.Fn RB_GENERATE ,
|
.Li RB_GENERATE ,
|
||||||
or
|
or
|
||||||
.Fn RB_GENERATE_STATIC .
|
.Li RB_GENERATE_STATIC .
|
||||||
See the examples below for further explanation of how these macros are used.
|
See the examples below for further explanation of how these macros are used.
|
||||||
.Sh SPLAY TREES
|
.Sh SPLAY TREES
|
||||||
A splay tree is a self-organizing data structure.
|
A splay tree is a self-organizing data structure.
|
||||||
Every operation on the tree causes a splay to happen.
|
Every operation on the tree causes a splay to happen.
|
||||||
The splay moves the requested
|
The splay moves the requested node to the root of the tree and partly
|
||||||
node to the root of the tree and partly rebalances it.
|
rebalances it.
|
||||||
.Pp
|
.Pp
|
||||||
This has the benefit that request locality causes faster lookups as
|
This has the benefit that request locality causes faster lookups as
|
||||||
the requested nodes move to the top of the tree.
|
the requested nodes move to the top of the tree.
|
||||||
On the other hand, every lookup causes memory writes.
|
On the other hand, every lookup causes memory writes.
|
||||||
.Pp
|
.Pp
|
||||||
The Balance Theorem bounds the total access time for
|
The Balance Theorem bounds the total access time for m operations
|
||||||
.Ar m
|
and n inserts on an initially empty tree as O((m + n)lg n).
|
||||||
operations and
|
The amortized cost for a sequence of m accesses to a splay tree is O(lg n).
|
||||||
.Ar n
|
|
||||||
inserts on an initially empty tree as
|
|
||||||
.Fn O "\*[lp]m + n\*[rp]lg n" .
|
|
||||||
The
|
|
||||||
amortized cost for a sequence of
|
|
||||||
.Ar m
|
|
||||||
accesses to a splay tree is
|
|
||||||
.Fn O "lg n" .
|
|
||||||
.Pp
|
.Pp
|
||||||
A splay tree is headed by a structure defined by the
|
A splay tree is headed by a structure defined by the
|
||||||
.Fn SPLAY_HEAD
|
.Fn SPLAY_HEAD
|
||||||
macro.
|
macro.
|
||||||
A
|
A
|
||||||
|
.Fa SPLAY_HEAD
|
||||||
structure is declared as follows:
|
structure is declared as follows:
|
||||||
.Bd -ragged -offset indent
|
.Bd -literal -offset indent
|
||||||
.Fn SPLAY_HEAD HEADNAME TYPE
|
SPLAY_HEAD(HEADNAME, TYPE) head;
|
||||||
.Va head ;
|
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
where
|
where
|
||||||
@ -251,16 +242,15 @@ macro, but should be used only once.
|
|||||||
Finally,
|
Finally,
|
||||||
the
|
the
|
||||||
.Fa CMP
|
.Fa CMP
|
||||||
argument is the name of a function used to compare tree nodes
|
argument is the name of a function used to compare trees' nodes
|
||||||
with each other.
|
with each other.
|
||||||
The function takes two arguments of type
|
The function takes two arguments of type
|
||||||
.Vt "struct TYPE *" .
|
.Fa "struct TYPE *" .
|
||||||
If the first argument is smaller than the second, the function returns a
|
If the first argument is smaller than the second, the function returns a
|
||||||
value smaller than zero.
|
value smaller than zero.
|
||||||
If they are equal, the function returns zero.
|
If they are equal, the function returns zero.
|
||||||
Otherwise, it should return a value greater than zero.
|
Otherwise, it should return a value greater than zero.
|
||||||
The compare
|
The compare function defines the order of the tree elements.
|
||||||
function defines the order of the tree elements.
|
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn SPLAY_INIT
|
.Fn SPLAY_INIT
|
||||||
@ -270,11 +260,8 @@ macro initializes the tree referenced by
|
|||||||
The splay tree can also be initialized statically by using the
|
The splay tree can also be initialized statically by using the
|
||||||
.Fn SPLAY_INITIALIZER
|
.Fn SPLAY_INITIALIZER
|
||||||
macro like this:
|
macro like this:
|
||||||
.Bd -ragged -offset indent
|
.Bd -literal -offset indent
|
||||||
.Fn SPLAY_HEAD HEADNAME TYPE
|
SPLAY_HEAD(HEADNAME, TYPE) head = SPLAY_INITIALIZER(&head);
|
||||||
.Va head
|
|
||||||
=
|
|
||||||
.Fn SPLAY_INITIALIZER &head ;
|
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -282,6 +269,11 @@ The
|
|||||||
macro inserts the new element
|
macro inserts the new element
|
||||||
.Fa elm
|
.Fa elm
|
||||||
into the tree.
|
into the tree.
|
||||||
|
Upon success,
|
||||||
|
.Va NULL
|
||||||
|
is returned.
|
||||||
|
If a matching element already exists in the tree, the insertion is
|
||||||
|
aborted, and a pointer to the existing element is returned.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn SPLAY_REMOVE
|
.Fn SPLAY_REMOVE
|
||||||
@ -289,6 +281,11 @@ macro removes the element
|
|||||||
.Fa elm
|
.Fa elm
|
||||||
from the tree pointed by
|
from the tree pointed by
|
||||||
.Fa head .
|
.Fa head .
|
||||||
|
Upon success, a pointer to the removed element is returned.
|
||||||
|
.Va NULL
|
||||||
|
is returned if
|
||||||
|
.Fa elm
|
||||||
|
is not present in the tree.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn SPLAY_FIND
|
.Fn SPLAY_FIND
|
||||||
@ -296,7 +293,7 @@ macro can be used to find a particular element in the tree.
|
|||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
struct TYPE find, *res;
|
struct TYPE find, *res;
|
||||||
find.key = 30;
|
find.key = 30;
|
||||||
res = SPLAY_FIND(NAME, head, &find);
|
res = SPLAY_FIND(NAME, &head, &find);
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -313,8 +310,8 @@ for (np = SPLAY_MIN(NAME, &head); np != NULL; np = SPLAY_NEXT(NAME, &head, np))
|
|||||||
Or, for simplicity, one can use the
|
Or, for simplicity, one can use the
|
||||||
.Fn SPLAY_FOREACH
|
.Fn SPLAY_FOREACH
|
||||||
macro:
|
macro:
|
||||||
.Bd -ragged -offset indent
|
.Bd -literal -offset indent
|
||||||
.Fn SPLAY_FOREACH np NAME head
|
SPLAY_FOREACH(np, NAME, &head)
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -324,29 +321,28 @@ macro should be used to check whether a splay tree is empty.
|
|||||||
A red-black tree is a binary search tree with the node color as an
|
A red-black tree is a binary search tree with the node color as an
|
||||||
extra attribute.
|
extra attribute.
|
||||||
It fulfills a set of conditions:
|
It fulfills a set of conditions:
|
||||||
.Bl -enum -offset indent
|
.Pp
|
||||||
|
.Bl -enum -compact -offset indent
|
||||||
.It
|
.It
|
||||||
Every search path from the root to a leaf consists of the same number of
|
every search path from the root to a leaf consists of the same number of
|
||||||
black nodes.
|
black nodes,
|
||||||
.It
|
.It
|
||||||
Each red node (except for the root) has a black parent.
|
each red node (except for the root) has a black parent,
|
||||||
.It
|
.It
|
||||||
Each leaf node is black.
|
each leaf node is black.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Every operation on a red-black tree is bounded as
|
Every operation on a red-black tree is bounded as O(lg n).
|
||||||
.Fn O "lg n" .
|
The maximum height of a red-black tree is 2lg (n+1).
|
||||||
The maximum height of a red-black tree is
|
|
||||||
.Fn 2lg "n + 1" .
|
|
||||||
.Pp
|
.Pp
|
||||||
A red-black tree is headed by a structure defined by the
|
A red-black tree is headed by a structure defined by the
|
||||||
.Fn RB_HEAD
|
.Fn RB_HEAD
|
||||||
macro.
|
macro.
|
||||||
A
|
A
|
||||||
|
.Fa RB_HEAD
|
||||||
structure is declared as follows:
|
structure is declared as follows:
|
||||||
.Bd -ragged -offset indent
|
.Bd -literal -offset indent
|
||||||
.Fn RB_HEAD HEADNAME TYPE
|
RB_HEAD(HEADNAME, TYPE) head;
|
||||||
.Va head ;
|
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
where
|
where
|
||||||
@ -364,7 +360,7 @@ their prototypes need to be declared with the
|
|||||||
.Fn RB_PROTOTYPE
|
.Fn RB_PROTOTYPE
|
||||||
or
|
or
|
||||||
.Fn RB_PROTOTYPE_STATIC
|
.Fn RB_PROTOTYPE_STATIC
|
||||||
macro,
|
macros,
|
||||||
where
|
where
|
||||||
.Fa NAME
|
.Fa NAME
|
||||||
is a unique identifier for this particular tree.
|
is a unique identifier for this particular tree.
|
||||||
@ -381,7 +377,7 @@ The function bodies are generated with the
|
|||||||
.Fn RB_GENERATE
|
.Fn RB_GENERATE
|
||||||
or
|
or
|
||||||
.Fn RB_GENERATE_STATIC
|
.Fn RB_GENERATE_STATIC
|
||||||
macro.
|
macros.
|
||||||
These macros take the same arguments as the
|
These macros take the same arguments as the
|
||||||
.Fn RB_PROTOTYPE
|
.Fn RB_PROTOTYPE
|
||||||
and
|
and
|
||||||
@ -391,16 +387,15 @@ macros, but should be used only once.
|
|||||||
Finally,
|
Finally,
|
||||||
the
|
the
|
||||||
.Fa CMP
|
.Fa CMP
|
||||||
argument is the name of a function used to compare tree nodes
|
argument is the name of a function used to compare trees' nodes
|
||||||
with each other.
|
with each other.
|
||||||
The function takes two arguments of type
|
The function takes two arguments of type
|
||||||
.Vt "struct TYPE *" .
|
.Fa "struct TYPE *" .
|
||||||
If the first argument is smaller than the second, the function returns a
|
If the first argument is smaller than the second, the function returns a
|
||||||
value smaller than zero.
|
value smaller than zero.
|
||||||
If they are equal, the function returns zero.
|
If they are equal, the function returns zero.
|
||||||
Otherwise, it should return a value greater than zero.
|
Otherwise, it should return a value greater than zero.
|
||||||
The compare
|
The compare function defines the order of the tree elements.
|
||||||
function defines the order of the tree elements.
|
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn RB_INIT
|
.Fn RB_INIT
|
||||||
@ -410,11 +405,8 @@ macro initializes the tree referenced by
|
|||||||
The red-black tree can also be initialized statically by using the
|
The red-black tree can also be initialized statically by using the
|
||||||
.Fn RB_INITIALIZER
|
.Fn RB_INITIALIZER
|
||||||
macro like this:
|
macro like this:
|
||||||
.Bd -ragged -offset indent
|
.Bd -literal -offset indent
|
||||||
.Fn RB_HEAD HEADNAME TYPE
|
RB_HEAD(HEADNAME, TYPE) head = RB_INITIALIZER(&head);
|
||||||
.Va head
|
|
||||||
=
|
|
||||||
.Fn RB_INITIALIZER &head ;
|
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -422,6 +414,11 @@ The
|
|||||||
macro inserts the new element
|
macro inserts the new element
|
||||||
.Fa elm
|
.Fa elm
|
||||||
into the tree.
|
into the tree.
|
||||||
|
Upon success,
|
||||||
|
.Va NULL
|
||||||
|
is returned.
|
||||||
|
If a matching element already exists in the tree, the insertion is
|
||||||
|
aborted, and a pointer to the existing element is returned.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn RB_REMOVE
|
.Fn RB_REMOVE
|
||||||
@ -429,16 +426,24 @@ macro removes the element
|
|||||||
.Fa elm
|
.Fa elm
|
||||||
from the tree pointed by
|
from the tree pointed by
|
||||||
.Fa head .
|
.Fa head .
|
||||||
|
.Fn RB_REMOVE
|
||||||
|
returns
|
||||||
|
.Fa elm .
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn RB_FIND
|
.Fn RB_FIND
|
||||||
and
|
and
|
||||||
.Fn RB_NFIND
|
.Fn RB_NFIND
|
||||||
macros can be used to find a particular element in the tree.
|
macros can be used to find a particular element in the tree.
|
||||||
|
.Fn RB_FIND
|
||||||
|
finds the node with the same key as
|
||||||
|
.Fa elm .
|
||||||
|
.Fn RB_NFIND
|
||||||
|
finds the first node greater than or equal to the search key.
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
struct TYPE find, *res;
|
struct TYPE find, *res;
|
||||||
find.key = 30;
|
find.key = 30;
|
||||||
res = RB_FIND(NAME, head, &find);
|
res = RB_FIND(NAME, &head, &find);
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -449,26 +454,122 @@ The
|
|||||||
and
|
and
|
||||||
.Fn RB_PREV
|
.Fn RB_PREV
|
||||||
macros can be used to traverse the tree:
|
macros can be used to traverse the tree:
|
||||||
.Pp
|
.Bd -literal -offset indent
|
||||||
.Dl "for (np = RB_MIN(NAME, &head); np != NULL; np = RB_NEXT(NAME, &head, np))"
|
for (np = RB_MIN(NAME, &head); np != NULL; np = RB_NEXT(NAME, &head, np))
|
||||||
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
Or, for simplicity, one can use the
|
Or, for simplicity, one can use the
|
||||||
.Fn RB_FOREACH
|
.Fn RB_FOREACH
|
||||||
or
|
or
|
||||||
.Fn RB_FOREACH_REVERSE
|
.Fn RB_FOREACH_REVERSE
|
||||||
macro:
|
macros:
|
||||||
.Bd -ragged -offset indent
|
.Bd -literal -offset indent
|
||||||
.Fn RB_FOREACH np NAME head
|
RB_FOREACH(np, NAME, &head)
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
|
The macros
|
||||||
|
.Fn RB_FOREACH_SAFE
|
||||||
|
and
|
||||||
|
.Fn RB_FOREACH_REVERSE_SAFE
|
||||||
|
traverse the tree referenced by head
|
||||||
|
in a forward or reverse direction respectively,
|
||||||
|
assigning each element in turn to np.
|
||||||
|
However, unlike their unsafe counterparts,
|
||||||
|
they permit both the removal of np
|
||||||
|
as well as freeing it from within the loop safely
|
||||||
|
without interfering with the traversal.
|
||||||
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn RB_EMPTY
|
.Fn RB_EMPTY
|
||||||
macro should be used to check whether a red-black tree is empty.
|
macro should be used to check whether a red-black tree is empty.
|
||||||
|
.Sh EXAMPLES
|
||||||
|
The following example demonstrates how to declare a red-black tree
|
||||||
|
holding integers.
|
||||||
|
Values are inserted into it and the contents of the tree are printed
|
||||||
|
in order.
|
||||||
|
Lastly, the internal structure of the tree is printed.
|
||||||
|
.Bd -literal -offset 3n
|
||||||
|
#include <sys/tree.h>
|
||||||
|
#include <err.h>
|
||||||
|
#include <stdio.h>
|
||||||
|
#include <stdlib.h>
|
||||||
|
|
||||||
|
struct node {
|
||||||
|
RB_ENTRY(node) entry;
|
||||||
|
int i;
|
||||||
|
};
|
||||||
|
|
||||||
|
int intcmp(struct node *, struct node *);
|
||||||
|
void print_tree(struct node *);
|
||||||
|
|
||||||
|
int
|
||||||
|
intcmp(struct node *e1, struct node *e2)
|
||||||
|
{
|
||||||
|
return (e1->i < e2->i ? -1 : e1->i > e2->i);
|
||||||
|
}
|
||||||
|
|
||||||
|
RB_HEAD(inttree, node) head = RB_INITIALIZER(&head);
|
||||||
|
RB_PROTOTYPE(inttree, node, entry, intcmp)
|
||||||
|
RB_GENERATE(inttree, node, entry, intcmp)
|
||||||
|
|
||||||
|
int testdata[] = {
|
||||||
|
20, 16, 17, 13, 3, 6, 1, 8, 2, 4, 10, 19, 5, 9, 12, 15, 18,
|
||||||
|
7, 11, 14
|
||||||
|
};
|
||||||
|
|
||||||
|
void
|
||||||
|
print_tree(struct node *n)
|
||||||
|
{
|
||||||
|
struct node *left, *right;
|
||||||
|
|
||||||
|
if (n == NULL) {
|
||||||
|
printf("nil");
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
left = RB_LEFT(n, entry);
|
||||||
|
right = RB_RIGHT(n, entry);
|
||||||
|
if (left == NULL && right == NULL)
|
||||||
|
printf("%d", n->i);
|
||||||
|
else {
|
||||||
|
printf("%d(", n->i);
|
||||||
|
print_tree(left);
|
||||||
|
printf(",");
|
||||||
|
print_tree(right);
|
||||||
|
printf(")");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
int
|
||||||
|
main(void)
|
||||||
|
{
|
||||||
|
int i;
|
||||||
|
struct node *n;
|
||||||
|
|
||||||
|
for (i = 0; i < sizeof(testdata) / sizeof(testdata[0]); i++) {
|
||||||
|
if ((n = malloc(sizeof(struct node))) == NULL)
|
||||||
|
err(1, NULL);
|
||||||
|
n->i = testdata[i];
|
||||||
|
RB_INSERT(inttree, &head, n);
|
||||||
|
}
|
||||||
|
|
||||||
|
RB_FOREACH(n, inttree, &head) {
|
||||||
|
printf("%d\en", n->i);
|
||||||
|
}
|
||||||
|
print_tree(RB_ROOT(&head));
|
||||||
|
printf("\en");
|
||||||
|
return (0);
|
||||||
|
}
|
||||||
|
.Ed
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr queue 3bsd
|
||||||
|
.Sh HISTORY
|
||||||
|
The tree macros first appeared in
|
||||||
|
.Fx 4.6 .
|
||||||
.Sh NOTES
|
.Sh NOTES
|
||||||
Trying to free a tree in the following way is a common error:
|
Trying to free a tree in the following way is a common error:
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
SPLAY_FOREACH(var, NAME, head) {
|
SPLAY_FOREACH(var, NAME, &head) {
|
||||||
SPLAY_REMOVE(NAME, head, var);
|
SPLAY_REMOVE(NAME, &head, var);
|
||||||
free(var);
|
free(var);
|
||||||
}
|
}
|
||||||
free(head);
|
free(head);
|
||||||
@ -476,36 +577,17 @@ free(head);
|
|||||||
.Pp
|
.Pp
|
||||||
Since
|
Since
|
||||||
.Va var
|
.Va var
|
||||||
is freed, the
|
is free'd, the
|
||||||
.Fn FOREACH
|
.Fn FOREACH
|
||||||
macro refers to a pointer that may have been reallocated already.
|
macro refers to a pointer that may have been reallocated already.
|
||||||
Proper code needs a second variable.
|
Proper code needs a second variable.
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
for (var = SPLAY_MIN(NAME, head); var != NULL; var = nxt) {
|
for (var = SPLAY_MIN(NAME, &head); var != NULL; var = nxt) {
|
||||||
nxt = SPLAY_NEXT(NAME, head, var);
|
nxt = SPLAY_NEXT(NAME, &head, var);
|
||||||
SPLAY_REMOVE(NAME, head, var);
|
SPLAY_REMOVE(NAME, &head, var);
|
||||||
free(var);
|
free(var);
|
||||||
}
|
}
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
|
||||||
Both
|
|
||||||
.Fn RB_INSERT
|
|
||||||
and
|
|
||||||
.Fn SPLAY_INSERT
|
|
||||||
return
|
|
||||||
.Dv NULL
|
|
||||||
if the element was inserted in the tree successfully, otherwise they
|
|
||||||
return a pointer to the element with the colliding key.
|
|
||||||
.Pp
|
|
||||||
Accordingly,
|
|
||||||
.Fn RB_REMOVE
|
|
||||||
and
|
|
||||||
.Fn SPLAY_REMOVE
|
|
||||||
return the pointer to the removed element otherwise they return
|
|
||||||
.Dv NULL
|
|
||||||
to indicate an error.
|
|
||||||
.Sh SEE ALSO
|
|
||||||
.Xr queue 3bsd
|
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
The author of the tree macros is
|
The author of the tree macros is
|
||||||
.An Niels Provos .
|
.An Niels Provos .
|
||||||
|
@ -30,7 +30,7 @@
|
|||||||
.\" @(#)unvis.3 8.2 (Berkeley) 12/11/93
|
.\" @(#)unvis.3 8.2 (Berkeley) 12/11/93
|
||||||
.\"
|
.\"
|
||||||
.Dd March 12, 2011
|
.Dd March 12, 2011
|
||||||
.Dt UNVIS 3bsd
|
.Dt unvis 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm unvis ,
|
.Nm unvis ,
|
||||||
|
1
man/verrc.3bsd
Normal file
1
man/verrc.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/errc.3bsd
|
@ -30,7 +30,7 @@
|
|||||||
.\" @(#)vis.3 8.1 (Berkeley) 6/9/93
|
.\" @(#)vis.3 8.1 (Berkeley) 6/9/93
|
||||||
.\"
|
.\"
|
||||||
.Dd April 22, 2017
|
.Dd April 22, 2017
|
||||||
.Dt VIS 3bsd
|
.Dt vis 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm vis ,
|
.Nm vis ,
|
||||||
|
1
man/vwarnc.3bsd
Normal file
1
man/vwarnc.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/errc.3bsd
|
1
man/warnc.3bsd
Normal file
1
man/warnc.3bsd
Normal file
@ -0,0 +1 @@
|
|||||||
|
.so man3/errc.3bsd
|
@ -36,7 +36,7 @@
|
|||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd March 4, 2009
|
.Dd March 4, 2009
|
||||||
.Dt WCSLCPY 3bsd
|
.Dt wcslcpy 3bsd
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
.Nm wcslcat ,
|
.Nm wcslcat ,
|
||||||
@ -69,3 +69,14 @@ counterpart, such as
|
|||||||
and
|
and
|
||||||
.Fn wcslcpy ,
|
.Fn wcslcpy ,
|
||||||
which are BSD extensions.
|
which are BSD extensions.
|
||||||
|
.Sh HISTORY
|
||||||
|
The
|
||||||
|
.Fn wcslcpy
|
||||||
|
and
|
||||||
|
.Fn wcslcat
|
||||||
|
functions first appeared in
|
||||||
|
.Ox 3.8 ,
|
||||||
|
.Nx 1.6 ,
|
||||||
|
.Fx 5.0
|
||||||
|
and
|
||||||
|
.Dx 2.1 .
|
||||||
|
397
src/Makefile.am
397
src/Makefile.am
@ -5,13 +5,14 @@ AM_CPPFLAGS = \
|
|||||||
-isystem $(top_srcdir)/include/bsd/ \
|
-isystem $(top_srcdir)/include/bsd/ \
|
||||||
-include $(top_builddir)/config.h \
|
-include $(top_builddir)/config.h \
|
||||||
-DLIBBSD_OVERLAY -DLIBBSD_DISABLE_DEPRECATED \
|
-DLIBBSD_OVERLAY -DLIBBSD_DISABLE_DEPRECATED \
|
||||||
-D__REENTRANT
|
-D__REENTRANT \
|
||||||
|
# EOL
|
||||||
|
|
||||||
if OS_WINDOWS
|
if OS_WINDOWS
|
||||||
AM_CPPFLAGS += \
|
AM_CPPFLAGS += \
|
||||||
-D_CRT_SECURE_NO_WARNINGS \
|
-D_CRT_SECURE_NO_WARNINGS \
|
||||||
-D_CRT_NONSTDC_NO_WARNINGS \
|
-D_CRT_NONSTDC_NO_WARNINGS \
|
||||||
$(nil)
|
# EOL
|
||||||
endif
|
endif
|
||||||
|
|
||||||
libbsd_la_included_sources = \
|
libbsd_la_included_sources = \
|
||||||
@ -23,21 +24,22 @@ libbsd_la_included_sources = \
|
|||||||
getentropy_osx.c \
|
getentropy_osx.c \
|
||||||
getentropy_solaris.c \
|
getentropy_solaris.c \
|
||||||
getentropy_win.c \
|
getentropy_win.c \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
|
CLEANFILES =
|
||||||
EXTRA_DIST = \
|
EXTRA_DIST = \
|
||||||
libbsd.map \
|
libbsd.map.in \
|
||||||
libbsd.pc.in \
|
libbsd.pc.in \
|
||||||
libbsd-ctor.pc.in \
|
libbsd-ctor.pc.in \
|
||||||
libbsd-overlay.pc.in \
|
libbsd-overlay.pc.in \
|
||||||
$(libbsd_la_included_sources) \
|
$(libbsd_la_included_sources) \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
pkgconfigdir = $(libdir)/pkgconfig
|
pkgconfigdir = $(libdir)/pkgconfig
|
||||||
pkgconfig_DATA = \
|
pkgconfig_DATA = \
|
||||||
libbsd.pc \
|
libbsd.pc \
|
||||||
libbsd-overlay.pc \
|
libbsd-overlay.pc \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
lib_LTLIBRARIES = libbsd.la
|
lib_LTLIBRARIES = libbsd.la
|
||||||
lib_LIBRARIES =
|
lib_LIBRARIES =
|
||||||
@ -48,100 +50,351 @@ pkgconfig_DATA += libbsd-ctor.pc
|
|||||||
lib_LIBRARIES += libbsd-ctor.a
|
lib_LIBRARIES += libbsd-ctor.a
|
||||||
endif
|
endif
|
||||||
|
|
||||||
libbsd_la_DEPENDENCIES = \
|
EXTRA_libbsd_la_DEPENDENCIES = \
|
||||||
$(libbsd_la_included_sources) \
|
$(libbsd_la_included_sources) \
|
||||||
libbsd.map
|
libbsd.map \
|
||||||
|
libbsd.map.in \
|
||||||
|
# EOL
|
||||||
libbsd_la_LIBADD = \
|
libbsd_la_LIBADD = \
|
||||||
$(MD_LIBS) \
|
$(MD5_LIBS) \
|
||||||
$(CLOCK_GETTIME_LIBS) \
|
$(LIBBSD_LIBS) \
|
||||||
$(ARC4RANDOM_ATFORK_LIBS) \
|
# EOL
|
||||||
$(nil)
|
|
||||||
libbsd_la_LDFLAGS = \
|
libbsd_la_LDFLAGS = \
|
||||||
-version-number $(LIBBSD_ABI)
|
-no-undefined \
|
||||||
|
-version-number $(SOVERSION) \
|
||||||
|
# EOL
|
||||||
if HAVE_LINKER_VERSION_SCRIPT
|
if HAVE_LINKER_VERSION_SCRIPT
|
||||||
libbsd_la_LDFLAGS += \
|
libbsd_la_LDFLAGS += \
|
||||||
-Wl,--version-script=$(srcdir)/libbsd.map
|
-Wl,--version-script=libbsd.map \
|
||||||
|
# EOL
|
||||||
|
else
|
||||||
|
libbsd_la_LDFLAGS += \
|
||||||
|
-export-symbols libbsd.sym \
|
||||||
|
# EOL
|
||||||
|
EXTRA_libbsd_la_DEPENDENCIES += \
|
||||||
|
libbsd.sym \
|
||||||
|
# EOL
|
||||||
endif
|
endif
|
||||||
libbsd_la_SOURCES = \
|
libbsd_la_SOURCES = \
|
||||||
arc4random.c \
|
|
||||||
arc4random.h \
|
|
||||||
arc4random_linux.h \
|
|
||||||
arc4random_openbsd.h \
|
|
||||||
arc4random_uniform.c \
|
|
||||||
arc4random_unix.h \
|
|
||||||
arc4random_win.h \
|
|
||||||
bsd_getopt.c \
|
|
||||||
chacha_private.h \
|
|
||||||
closefrom.c \
|
|
||||||
dehumanize_number.c \
|
|
||||||
err.c \
|
|
||||||
expand_number.c \
|
|
||||||
explicit_bzero.c \
|
|
||||||
fgetln.c \
|
|
||||||
freezero.c \
|
|
||||||
fgetwln.c \
|
|
||||||
flopen.c \
|
|
||||||
fmtcheck.c \
|
|
||||||
fparseln.c \
|
|
||||||
fpurge.c \
|
|
||||||
funopen.c \
|
|
||||||
getbsize.c \
|
|
||||||
getpeereid.c \
|
|
||||||
heapsort.c \
|
|
||||||
humanize_number.c \
|
|
||||||
inet_net_pton.c \
|
|
||||||
local-elf.h \
|
local-elf.h \
|
||||||
local-link.h \
|
local-link.h \
|
||||||
md5.c \
|
# EOL
|
||||||
merge.c \
|
|
||||||
nlist.c \
|
|
||||||
pidfile.c \
|
|
||||||
progname.c \
|
|
||||||
pwcache.c \
|
|
||||||
radixsort.c \
|
|
||||||
readpassphrase.c \
|
|
||||||
reallocarray.c \
|
|
||||||
reallocf.c \
|
|
||||||
recallocarray.c \
|
|
||||||
setmode.c \
|
|
||||||
setproctitle.c \
|
|
||||||
strlcat.c \
|
|
||||||
strlcpy.c \
|
|
||||||
stringlist.c \
|
|
||||||
strmode.c \
|
|
||||||
strnstr.c \
|
|
||||||
strtoi.c \
|
|
||||||
strtonum.c \
|
|
||||||
strtou.c \
|
|
||||||
timeconv.c \
|
|
||||||
unvis.c \
|
|
||||||
vis.c \
|
|
||||||
wcslcat.c \
|
|
||||||
wcslcpy.c \
|
|
||||||
$(nil)
|
|
||||||
|
|
||||||
|
if ABI_ACCMODE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
setmode.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_ARC4RANDOM
|
||||||
if !HAVE_GETENTROPY
|
if !HAVE_GETENTROPY
|
||||||
libbsd_la_SOURCES += \
|
libbsd_la_SOURCES += \
|
||||||
getentropy.c \
|
getentropy.c \
|
||||||
$(nil)
|
# EOL
|
||||||
endif
|
endif
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
arc4random.c \
|
||||||
|
arc4random.h \
|
||||||
|
arc4random_linux.h \
|
||||||
|
arc4random_uniform.c \
|
||||||
|
arc4random_unix.h \
|
||||||
|
arc4random_win.h \
|
||||||
|
chacha_private.h \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_ASPRINTF
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
asprintf.c \
|
||||||
|
vasprintf.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_BSD_GETOPT
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
bsd_getopt.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_CLOSEFROM
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
closefrom.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_ERR
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
err.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_ERRC
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
errc.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_EXPAND_NUMBER
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
expand_number.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_EXPLICIT_BZERO
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
explicit_bzero.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FGETLN
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
fgetln.c \
|
||||||
|
fgetwln.c \
|
||||||
|
fparseln.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FLOPEN
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
flopen.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FMTCHECK
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
fmtcheck.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FPURGE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
fpurge.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FREEZERO
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
freezero.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_FUNOPEN
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
funopen.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_GETBSIZE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
getbsize.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_GETPEEREID
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
getpeereid.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_HUMANIZE_NUMBER
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
dehumanize_number.c \
|
||||||
|
humanize_number.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_INET_NET_PTON
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
inet_net_pton.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_MD5
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
md5.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_NLIST
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
nlist.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PIDFILE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
pidfile.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PROCTITLE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
setproctitle.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PROGNAME
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
progname.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_PWCACHE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
pwcache.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_READPASSPHRASE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
readpassphrase.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_REALLOCARRAY
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
reallocarray.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_REALLOCF
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
reallocf.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_RECALLOCARRAY
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
recallocarray.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_SORT
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
heapsort.c \
|
||||||
|
merge.c \
|
||||||
|
radixsort.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRINGLIST
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
stringlist.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRL
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
strlcat.c \
|
||||||
|
strlcpy.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRMODE
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
strmode.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRNSTR
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
strnstr.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRTONUM
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
strtonum.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_STRTOX
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
strtoi.c \
|
||||||
|
strtou.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_TIMECONV
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
timeconv.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_VIS
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
unvis.c \
|
||||||
|
vis.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_WCSL
|
||||||
|
libbsd_la_SOURCES += \
|
||||||
|
wcslcat.c \
|
||||||
|
wcslcpy.c \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
if ABI_TRANSPARENT_LIBMD
|
||||||
|
CLEANFILES += \
|
||||||
|
format.ld \
|
||||||
|
# EOL
|
||||||
|
endif
|
||||||
|
|
||||||
|
DISTCLEANFILES = \
|
||||||
|
libbsd.sym \
|
||||||
|
libbsd.map \
|
||||||
|
# EOL
|
||||||
|
|
||||||
libbsd_ctor_a_SOURCES = \
|
libbsd_ctor_a_SOURCES = \
|
||||||
setproctitle_ctor.c \
|
setproctitle_ctor.c \
|
||||||
$(nil)
|
# EOL
|
||||||
|
|
||||||
|
# Generate the library map file with the pre-processor to selectively include
|
||||||
|
# symbols depending on the host system, otherwise some linkers might fail.
|
||||||
|
libbsd.map: libbsd.map.in
|
||||||
|
$(AM_V_GEN) $(CPP) $(AM_CPPFLAGS) $(CPPFLAGS) -P - <$(srcdir)/libbsd.map.in >$@
|
||||||
|
|
||||||
|
# Generate a simple libtool symbol export list to be used as a fallback if
|
||||||
|
# there is no version script support.
|
||||||
|
libbsd.sym: libbsd.map
|
||||||
|
$(AM_V_GEN) $(SED) -ne 's/^[[:space:]]\{1,\}\([A-Za-z0-9_]\{1,\}\);/\1/p' libbsd.map >$@
|
||||||
|
|
||||||
|
if ABI_TRANSPARENT_LIBMD
|
||||||
|
TRANSPARENT_LIBMD_DEPENDS = format.ld
|
||||||
|
|
||||||
|
format.ld:
|
||||||
|
$(CC) -shared -nostdlib -nostartfiles -x assembler /dev/null -o $@.so
|
||||||
|
$(OBJDUMP) -f $@.so | sed -n 's/.*file format \(.*\)/OUTPUT_FORMAT(\1)/;T;p' >$@
|
||||||
|
rm -f $@.so
|
||||||
|
endif
|
||||||
|
|
||||||
runtimelibdir = $(libdir)
|
runtimelibdir = $(libdir)
|
||||||
|
|
||||||
install-exec-hook:
|
install-exec-hook: $(TRANSPARENT_LIBMD_DEPENDS)
|
||||||
if [ "$(libdir)" != "$(runtimelibdir)" ]; then \
|
if [ "$(libdir)" != "$(runtimelibdir)" ]; then \
|
||||||
$(MKDIR_P) $(DESTDIR)$(runtimelibdir); \
|
$(MKDIR_P) $(DESTDIR)$(runtimelibdir); \
|
||||||
mv $(DESTDIR)$(libdir)/libbsd*.so.* \
|
mv $(DESTDIR)$(libdir)/libbsd*.so.* \
|
||||||
$(DESTDIR)$(runtimelibdir)/; \
|
$(DESTDIR)$(runtimelibdir)/; \
|
||||||
|
fi
|
||||||
|
if ABI_TRANSPARENT_LIBMD
|
||||||
|
# The "GNU ld script" magic is required so that GNU ldconfig does not complain
|
||||||
|
# about an unknown format file.
|
||||||
|
soname=`readlink $(DESTDIR)$(libdir)/libbsd.so`; \
|
||||||
|
$(RM) $(DESTDIR)$(libdir)/libbsd.so; \
|
||||||
|
(echo '/* GNU ld script'; \
|
||||||
|
echo ' * The MD5 functions are provided by the libmd library. */'; \
|
||||||
|
cat format.ld; \
|
||||||
|
echo "GROUP($(runtimelibdir)/$$soname AS_NEEDED($(MD5_LIBS)))"; \
|
||||||
|
)>$(DESTDIR)$(libdir)/libbsd.so
|
||||||
|
else
|
||||||
|
if [ "$(libdir)" != "$(runtimelibdir)" ]; then \
|
||||||
soname=`readlink $(DESTDIR)$(libdir)/libbsd.so`; \
|
soname=`readlink $(DESTDIR)$(libdir)/libbsd.so`; \
|
||||||
sorelprefix=`echo $(libdir) | sed -r -e 's:(^/)?[^/]+:..:g'`; \
|
sorelprefix=`echo $(libdir) | $(SED) -r -e 's:(^/)?[^/]+:..:g'`; \
|
||||||
ln -sf $$sorelprefix$(runtimelibdir)/$$soname \
|
ln -sf $$sorelprefix$(runtimelibdir)/$$soname \
|
||||||
$(DESTDIR)$(libdir)/libbsd.so; \
|
$(DESTDIR)$(libdir)/libbsd.so; \
|
||||||
fi
|
fi
|
||||||
|
endif
|
||||||
|
|
||||||
uninstall-hook:
|
uninstall-hook:
|
||||||
rm -f $(DESTDIR)$(runtimelibdir)/libbsd*.so*
|
rm -f $(DESTDIR)$(runtimelibdir)/libbsd*.so*
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
/* $OpenBSD: arc4random.c,v 1.53 2015/09/10 18:53:50 bcook Exp $ */
|
/* $OpenBSD: arc4random.c,v 1.58 2022/07/31 13:41:45 tb Exp $ */
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Copyright (c) 1996, David Mazieres <dm@uun.org>
|
* Copyright (c) 1996, David Mazieres <dm@uun.org>
|
||||||
@ -50,6 +50,8 @@
|
|||||||
#define BLOCKSZ 64
|
#define BLOCKSZ 64
|
||||||
#define RSBUFSZ (16*BLOCKSZ)
|
#define RSBUFSZ (16*BLOCKSZ)
|
||||||
|
|
||||||
|
#define REKEY_BASE (1024*1024) /* NB. should be a power of 2 */
|
||||||
|
|
||||||
/* Marked MAP_INHERIT_ZERO, so zero'd out in fork children. */
|
/* Marked MAP_INHERIT_ZERO, so zero'd out in fork children. */
|
||||||
static struct _rs {
|
static struct _rs {
|
||||||
size_t rs_have; /* valid bytes at end of rs_buf */
|
size_t rs_have; /* valid bytes at end of rs_buf */
|
||||||
@ -74,10 +76,10 @@ _rs_init(unsigned char *buf, size_t n)
|
|||||||
|
|
||||||
if (rs == NULL) {
|
if (rs == NULL) {
|
||||||
if (_rs_allocate(&rs, &rsx) == -1)
|
if (_rs_allocate(&rs, &rsx) == -1)
|
||||||
abort();
|
_exit(1);
|
||||||
}
|
}
|
||||||
|
|
||||||
chacha_keysetup(&rsx->rs_chacha, buf, KEYSZ * 8, 0);
|
chacha_keysetup(&rsx->rs_chacha, buf, KEYSZ * 8);
|
||||||
chacha_ivsetup(&rsx->rs_chacha, buf + KEYSZ);
|
chacha_ivsetup(&rsx->rs_chacha, buf + KEYSZ);
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -108,6 +110,7 @@ static void
|
|||||||
_rs_stir(void)
|
_rs_stir(void)
|
||||||
{
|
{
|
||||||
unsigned char rnd[KEYSZ + IVSZ];
|
unsigned char rnd[KEYSZ + IVSZ];
|
||||||
|
uint32_t rekey_fuzz = 0;
|
||||||
|
|
||||||
if (getentropy(rnd, sizeof rnd) == -1)
|
if (getentropy(rnd, sizeof rnd) == -1)
|
||||||
_getentropy_fail();
|
_getentropy_fail();
|
||||||
@ -122,7 +125,10 @@ _rs_stir(void)
|
|||||||
rs->rs_have = 0;
|
rs->rs_have = 0;
|
||||||
memset(rsx->rs_buf, 0, sizeof(rsx->rs_buf));
|
memset(rsx->rs_buf, 0, sizeof(rsx->rs_buf));
|
||||||
|
|
||||||
rs->rs_count = 1600000;
|
/* rekey interval should not be predictable */
|
||||||
|
chacha_encrypt_bytes(&rsx->rs_chacha, (uint8_t *)&rekey_fuzz,
|
||||||
|
(uint8_t *)&rekey_fuzz, sizeof(rekey_fuzz));
|
||||||
|
rs->rs_count = REKEY_BASE + (rekey_fuzz % REKEY_BASE);
|
||||||
}
|
}
|
||||||
|
|
||||||
static inline void
|
static inline void
|
||||||
|
@ -32,9 +32,7 @@
|
|||||||
int
|
int
|
||||||
getentropy(void *buf, size_t len);
|
getentropy(void *buf, size_t len);
|
||||||
|
|
||||||
#if defined(__OpenBSD__)
|
#if defined(__linux__)
|
||||||
#include "arc4random_openbsd.h"
|
|
||||||
#elif defined(__linux__)
|
|
||||||
#include "arc4random_linux.h"
|
#include "arc4random_linux.h"
|
||||||
#elif defined(_WIN32)
|
#elif defined(_WIN32)
|
||||||
#include "arc4random_win.h"
|
#include "arc4random_win.h"
|
||||||
|
@ -1,61 +0,0 @@
|
|||||||
/* $OpenBSD: arc4random.h,v 1.3 2014/07/20 20:51:13 bcook Exp $ */
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Copyright (c) 1996, David Mazieres <dm@uun.org>
|
|
||||||
* Copyright (c) 2008, Damien Miller <djm@openbsd.org>
|
|
||||||
* Copyright (c) 2013, Markus Friedl <markus@openbsd.org>
|
|
||||||
* Copyright (c) 2014, Theo de Raadt <deraadt@openbsd.org>
|
|
||||||
*
|
|
||||||
* Permission to use, copy, modify, and distribute this software for any
|
|
||||||
* purpose with or without fee is hereby granted, provided that the above
|
|
||||||
* copyright notice and this permission notice appear in all copies.
|
|
||||||
*
|
|
||||||
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
||||||
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
||||||
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
||||||
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
||||||
* 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.
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Stub functions for portability.
|
|
||||||
*/
|
|
||||||
#include <sys/mman.h>
|
|
||||||
|
|
||||||
#include <signal.h>
|
|
||||||
|
|
||||||
#include "thread_private.h"
|
|
||||||
|
|
||||||
static inline void
|
|
||||||
_getentropy_fail(void)
|
|
||||||
{
|
|
||||||
raise(SIGKILL);
|
|
||||||
}
|
|
||||||
|
|
||||||
static inline int
|
|
||||||
_rs_allocate(struct _rs **rsp, struct _rsx **rsxp)
|
|
||||||
{
|
|
||||||
struct {
|
|
||||||
struct _rs rs;
|
|
||||||
struct _rsx rsx;
|
|
||||||
} *p;
|
|
||||||
|
|
||||||
if ((p = mmap(NULL, sizeof(*p), PROT_READ|PROT_WRITE,
|
|
||||||
MAP_ANON|MAP_PRIVATE, -1, 0)) == MAP_FAILED)
|
|
||||||
return (-1);
|
|
||||||
if (minherit(p, sizeof(*p), MAP_INHERIT_ZERO) == -1) {
|
|
||||||
munmap(p, sizeof(*p));
|
|
||||||
return (-1);
|
|
||||||
}
|
|
||||||
|
|
||||||
*rsp = &p->rs;
|
|
||||||
*rsxp = &p->rsx;
|
|
||||||
return (0);
|
|
||||||
}
|
|
||||||
|
|
||||||
static inline void
|
|
||||||
_rs_forkdetect(void)
|
|
||||||
{
|
|
||||||
}
|
|
43
src/asprintf.c
Normal file
43
src/asprintf.c
Normal file
@ -0,0 +1,43 @@
|
|||||||
|
/*
|
||||||
|
* Copyright © 2010-2024 Guillem Jover <guillem@hadrons.org>
|
||||||
|
*
|
||||||
|
* Redistribution and use in source and binary forms, with or without
|
||||||
|
* modification, are permitted provided that the following conditions
|
||||||
|
* are met:
|
||||||
|
* 1. Redistributions of source code must retain the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer.
|
||||||
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer in the
|
||||||
|
* documentation and/or other materials provided with the distribution.
|
||||||
|
* 3. The name of the author may not be used to endorse or promote products
|
||||||
|
* derived from this software without specific prior written permission.
|
||||||
|
*
|
||||||
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
||||||
|
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
||||||
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
||||||
|
* THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
||||||
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
||||||
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
||||||
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
||||||
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
||||||
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
||||||
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include <config.h>
|
||||||
|
|
||||||
|
#include <stdarg.h>
|
||||||
|
#include <stdio.h>
|
||||||
|
|
||||||
|
int
|
||||||
|
asprintf(char **strp, char const *fmt, ...)
|
||||||
|
{
|
||||||
|
va_list args;
|
||||||
|
int n;
|
||||||
|
|
||||||
|
va_start(args, fmt);
|
||||||
|
n = vasprintf(strp, fmt, args);
|
||||||
|
va_end(args);
|
||||||
|
|
||||||
|
return n;
|
||||||
|
}
|
@ -4,7 +4,7 @@ D. J. Bernstein
|
|||||||
Public domain.
|
Public domain.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/* $OpenBSD: chacha_private.h,v 1.2 2013/10/04 07:02:27 djm Exp $ */
|
/* $OpenBSD: chacha_private.h,v 1.3 2022/02/28 21:56:29 dtucker Exp $ */
|
||||||
|
|
||||||
typedef unsigned char u8;
|
typedef unsigned char u8;
|
||||||
typedef unsigned int u32;
|
typedef unsigned int u32;
|
||||||
@ -48,11 +48,19 @@ typedef struct
|
|||||||
a = PLUS(a,b); d = ROTATE(XOR(d,a), 8); \
|
a = PLUS(a,b); d = ROTATE(XOR(d,a), 8); \
|
||||||
c = PLUS(c,d); b = ROTATE(XOR(b,c), 7);
|
c = PLUS(c,d); b = ROTATE(XOR(b,c), 7);
|
||||||
|
|
||||||
static const char sigma[16] = "expand 32-byte k";
|
#if defined(__has_attribute)
|
||||||
static const char tau[16] = "expand 16-byte k";
|
#if __has_attribute(__nonstring__)
|
||||||
|
#define ATTRIBUTE_NONSTRING __attribute__((__nonstring__))
|
||||||
|
#else
|
||||||
|
#define ATTRIBUTE_NONSTRING
|
||||||
|
#endif
|
||||||
|
#endif
|
||||||
|
|
||||||
|
static const char sigma[16] ATTRIBUTE_NONSTRING = "expand 32-byte k";
|
||||||
|
static const char tau[16] ATTRIBUTE_NONSTRING = "expand 16-byte k";
|
||||||
|
|
||||||
static void
|
static void
|
||||||
chacha_keysetup(chacha_ctx *x,const u8 *k,u32 kbits,u32 ivbits)
|
chacha_keysetup(chacha_ctx *x,const u8 *k,u32 kbits)
|
||||||
{
|
{
|
||||||
const char *constants;
|
const char *constants;
|
||||||
|
|
||||||
|
120
src/closefrom.c
120
src/closefrom.c
@ -1,6 +1,8 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright (c) 2004-2005, 2007, 2010, 2012-2014
|
* SPDX-License-Identifier: ISC
|
||||||
* Todd C. Miller <Todd.Miller@courtesan.com>
|
*
|
||||||
|
* Copyright (c) 2004-2005, 2007, 2010, 2012-2015, 2017-2018
|
||||||
|
* Todd C. Miller <Todd.Miller@sudo.ws>
|
||||||
*
|
*
|
||||||
* Permission to use, copy, modify, and distribute this software for any
|
* Permission to use, copy, modify, and distribute this software for any
|
||||||
* purpose with or without fee is hereby granted, provided that the above
|
* purpose with or without fee is hereby granted, provided that the above
|
||||||
@ -17,19 +19,17 @@
|
|||||||
|
|
||||||
#include <config.h>
|
#include <config.h>
|
||||||
|
|
||||||
#include <sys/types.h>
|
#ifdef __linux__
|
||||||
#include <unistd.h>
|
# include <sys/syscall.h>
|
||||||
#include <stdio.h>
|
# if defined(__NR_close_range) && !defined(SYS_close_range)
|
||||||
#ifdef STDC_HEADERS
|
# define SYS_close_range __NR_close_range
|
||||||
# include <stdlib.h>
|
|
||||||
# include <stddef.h>
|
|
||||||
#else
|
|
||||||
# ifdef HAVE_STDLIB_H
|
|
||||||
# include <stdlib.h>
|
|
||||||
# endif
|
# endif
|
||||||
#endif /* STDC_HEADERS */
|
#endif
|
||||||
|
#include <errno.h>
|
||||||
#include <fcntl.h>
|
#include <fcntl.h>
|
||||||
#include <limits.h>
|
#include <limits.h>
|
||||||
|
#include <stdlib.h>
|
||||||
|
#include <unistd.h>
|
||||||
#ifdef HAVE_PSTAT_GETPROC
|
#ifdef HAVE_PSTAT_GETPROC
|
||||||
# include <sys/param.h>
|
# include <sys/param.h>
|
||||||
# include <sys/pstat.h>
|
# include <sys/pstat.h>
|
||||||
@ -56,10 +56,6 @@
|
|||||||
# define OPEN_MAX 256
|
# define OPEN_MAX 256
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
#if defined(HAVE_FCNTL_CLOSEM) && !defined(HAVE_DIRFD)
|
|
||||||
# define closefrom closefrom_fallback
|
|
||||||
#endif
|
|
||||||
|
|
||||||
static inline void
|
static inline void
|
||||||
closefrom_close(int fd)
|
closefrom_close(int fd)
|
||||||
{
|
{
|
||||||
@ -71,56 +67,64 @@ closefrom_close(int fd)
|
|||||||
#endif
|
#endif
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#if defined(__linux__) && defined(SYS_close_range)
|
||||||
|
static inline int
|
||||||
|
sys_close_range(unsigned int fd, unsigned int max_fd, unsigned int flags)
|
||||||
|
{
|
||||||
|
return syscall(SYS_close_range, fd, max_fd, flags);
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Close all file descriptors greater than or equal to lowfd.
|
* Close all file descriptors greater than or equal to lowfd.
|
||||||
* This is the expensive (fallback) method.
|
* This is the expensive (fallback) method.
|
||||||
*/
|
*/
|
||||||
void
|
static void
|
||||||
closefrom_fallback(int lowfd)
|
closefrom_fallback(int lowfd)
|
||||||
{
|
{
|
||||||
long fd, maxfd;
|
long fd, maxfd;
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Fall back on sysconf() or getdtablesize(). We avoid checking
|
* Fall back on sysconf(_SC_OPEN_MAX) or getdtablesize(). This is
|
||||||
* resource limits since it is possible to open a file descriptor
|
* equivalent to checking the RLIMIT_NOFILE soft limit. It is
|
||||||
* and then drop the rlimit such that it is below the open fd.
|
* possible for there to be open file descriptors past this limit
|
||||||
|
* but there is not much we can do about that since the hard limit
|
||||||
|
* may be RLIM_INFINITY (LLONG_MAX or ULLONG_MAX on modern systems).
|
||||||
*/
|
*/
|
||||||
#ifdef HAVE_SYSCONF
|
#ifdef HAVE_SYSCONF
|
||||||
maxfd = sysconf(_SC_OPEN_MAX);
|
maxfd = sysconf(_SC_OPEN_MAX);
|
||||||
#else
|
#else
|
||||||
maxfd = getdtablesize();
|
maxfd = getdtablesize();
|
||||||
#endif /* HAVE_SYSCONF */
|
#endif /* HAVE_SYSCONF */
|
||||||
if (maxfd < 0)
|
if (maxfd < OPEN_MAX)
|
||||||
maxfd = OPEN_MAX;
|
maxfd = OPEN_MAX;
|
||||||
|
|
||||||
|
/* Make sure we did not get RLIM_INFINITY as the upper limit. */
|
||||||
|
if (maxfd > INT_MAX)
|
||||||
|
maxfd = INT_MAX;
|
||||||
|
|
||||||
for (fd = lowfd; fd < maxfd; fd++)
|
for (fd = lowfd; fd < maxfd; fd++)
|
||||||
closefrom_close(fd);
|
closefrom_close(fd);
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
#if defined(HAVE_PSTAT_GETPROC)
|
||||||
* Close all file descriptors greater than or equal to lowfd.
|
static int
|
||||||
* We try the fast way first, falling back on the slow method.
|
closefrom_pstat(int lowfd)
|
||||||
*/
|
|
||||||
#if defined(HAVE_FCNTL_CLOSEM)
|
|
||||||
void
|
|
||||||
closefrom(int lowfd)
|
|
||||||
{
|
{
|
||||||
if (fcntl(lowfd, F_CLOSEM, 0) == -1)
|
struct pst_status pst;
|
||||||
closefrom_fallback(lowfd);
|
|
||||||
}
|
|
||||||
#elif defined(HAVE_PSTAT_GETPROC)
|
|
||||||
void
|
|
||||||
closefrom(int lowfd)
|
|
||||||
{
|
|
||||||
struct pst_status pstat;
|
|
||||||
int fd;
|
int fd;
|
||||||
|
|
||||||
if (pstat_getproc(&pstat, sizeof(pstat), 0, getpid()) != -1) {
|
/*
|
||||||
for (fd = lowfd; fd <= pstat.pst_highestfd; fd++)
|
* EOVERFLOW is not a fatal error for the fields we use.
|
||||||
|
* See the "EOVERFLOW Error" section of pstat_getvminfo(3).
|
||||||
|
*/
|
||||||
|
if (pstat_getproc(&pst, sizeof(pst), 0, getpid()) != -1 ||
|
||||||
|
errno == EOVERFLOW) {
|
||||||
|
for (fd = lowfd; fd <= pst.pst_highestfd; fd++)
|
||||||
(void)close(fd);
|
(void)close(fd);
|
||||||
} else {
|
return 0;
|
||||||
closefrom_fallback(lowfd);
|
|
||||||
}
|
}
|
||||||
|
return -1;
|
||||||
}
|
}
|
||||||
#elif defined(HAVE_DIRFD)
|
#elif defined(HAVE_DIRFD)
|
||||||
static int
|
static int
|
||||||
@ -135,8 +139,8 @@ closefrom_procfs(int lowfd)
|
|||||||
int ret = 0;
|
int ret = 0;
|
||||||
int i;
|
int i;
|
||||||
|
|
||||||
/* Use /proc/self/fd (or /dev/fd on FreeBSD) if it exists. */
|
/* Use /proc/self/fd (or /dev/fd on macOS) if it exists. */
|
||||||
# if defined(__FreeBSD__) || defined(__FreeBSD_kernel__) || defined(__APPLE__)
|
# ifdef __APPLE__
|
||||||
path = "/dev/fd";
|
path = "/dev/fd";
|
||||||
# else
|
# else
|
||||||
path = "/proc/self/fd";
|
path = "/proc/self/fd";
|
||||||
@ -149,6 +153,9 @@ closefrom_procfs(int lowfd)
|
|||||||
const char *errstr;
|
const char *errstr;
|
||||||
int fd;
|
int fd;
|
||||||
|
|
||||||
|
if (dent->d_name[0] == '.')
|
||||||
|
continue;
|
||||||
|
|
||||||
fd = strtonum(dent->d_name, lowfd, INT_MAX, &errstr);
|
fd = strtonum(dent->d_name, lowfd, INT_MAX, &errstr);
|
||||||
if (errstr != NULL || fd == dirfd(dirp))
|
if (errstr != NULL || fd == dirfd(dirp))
|
||||||
continue;
|
continue;
|
||||||
@ -180,13 +187,36 @@ closefrom_procfs(int lowfd)
|
|||||||
|
|
||||||
return ret;
|
return ret;
|
||||||
}
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Close all file descriptors greater than or equal to lowfd.
|
||||||
|
* We try the fast way first, falling back on the slow method.
|
||||||
|
*/
|
||||||
void
|
void
|
||||||
closefrom(int lowfd)
|
closefrom(int lowfd)
|
||||||
{
|
{
|
||||||
if (closefrom_procfs(lowfd) == 0)
|
if (lowfd < 0)
|
||||||
return;
|
lowfd = 0;
|
||||||
|
|
||||||
|
/* Try the fast methods first, if possible. */
|
||||||
|
#if defined(HAVE_FCNTL_CLOSEM)
|
||||||
|
if (fcntl(lowfd, F_CLOSEM, 0) != -1)
|
||||||
|
return;
|
||||||
|
#endif /* HAVE_FCNTL_CLOSEM */
|
||||||
|
#if defined(__linux__) && defined(SYS_close_range)
|
||||||
|
if (sys_close_range(lowfd, UINT_MAX, 0) == 0)
|
||||||
|
return;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(HAVE_PSTAT_GETPROC)
|
||||||
|
if (closefrom_pstat(lowfd) != -1)
|
||||||
|
return;
|
||||||
|
#elif defined(HAVE_DIRFD)
|
||||||
|
if (closefrom_procfs(lowfd) != -1)
|
||||||
|
return;
|
||||||
|
#endif /* HAVE_DIRFD */
|
||||||
|
|
||||||
|
/* Do things the slow way. */
|
||||||
closefrom_fallback(lowfd);
|
closefrom_fallback(lowfd);
|
||||||
}
|
}
|
||||||
#endif /* HAVE_FCNTL_CLOSEM */
|
|
||||||
|
50
src/err.c
50
src/err.c
@ -1,6 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright © 2006 Robert Millan
|
* Copyright © 2019 Guillem Jover <guillem@hadrons.org>
|
||||||
* Copyright © 2011, 2019 Guillem Jover <guillem@hadrons.org>
|
|
||||||
*
|
*
|
||||||
* Redistribution and use in source and binary forms, with or without
|
* Redistribution and use in source and binary forms, with or without
|
||||||
* modification, are permitted provided that the following conditions
|
* modification, are permitted provided that the following conditions
|
||||||
@ -26,58 +25,12 @@
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
#include <err.h>
|
#include <err.h>
|
||||||
#ifdef LIBBSD_NEED_ERR_H_FUNCS
|
|
||||||
#include <errno.h>
|
#include <errno.h>
|
||||||
#endif
|
|
||||||
#include <string.h>
|
#include <string.h>
|
||||||
#include <stdarg.h>
|
#include <stdarg.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
|
|
||||||
void
|
|
||||||
vwarnc(int code, const char *format, va_list ap)
|
|
||||||
{
|
|
||||||
fprintf(stderr, "%s: ", getprogname());
|
|
||||||
if (format) {
|
|
||||||
vfprintf(stderr, format, ap);
|
|
||||||
fprintf(stderr, ": ");
|
|
||||||
}
|
|
||||||
fprintf(stderr, "%s\n", strerror(code));
|
|
||||||
}
|
|
||||||
|
|
||||||
void
|
|
||||||
warnc(int code, const char *format, ...)
|
|
||||||
{
|
|
||||||
va_list ap;
|
|
||||||
|
|
||||||
va_start(ap, format);
|
|
||||||
vwarnc(code, format, ap);
|
|
||||||
va_end(ap);
|
|
||||||
}
|
|
||||||
|
|
||||||
void
|
|
||||||
verrc(int status, int code, const char *format, va_list ap)
|
|
||||||
{
|
|
||||||
fprintf(stderr, "%s: ", getprogname());
|
|
||||||
if (format) {
|
|
||||||
vfprintf(stderr, format, ap);
|
|
||||||
fprintf(stderr, ": ");
|
|
||||||
}
|
|
||||||
fprintf(stderr, "%s\n", strerror(code));
|
|
||||||
exit(status);
|
|
||||||
}
|
|
||||||
|
|
||||||
void
|
|
||||||
errc(int status, int code, const char *format, ...)
|
|
||||||
{
|
|
||||||
va_list ap;
|
|
||||||
|
|
||||||
va_start(ap, format);
|
|
||||||
verrc(status, code, format, ap);
|
|
||||||
va_end(ap);
|
|
||||||
}
|
|
||||||
|
|
||||||
#ifdef LIBBSD_NEED_ERR_H_FUNCS
|
|
||||||
void
|
void
|
||||||
vwarn(const char *format, va_list ap)
|
vwarn(const char *format, va_list ap)
|
||||||
{
|
{
|
||||||
@ -148,4 +101,3 @@ errx(int eval, const char *format, ...)
|
|||||||
verrx(eval, format, ap);
|
verrx(eval, format, ap);
|
||||||
va_end(ap);
|
va_end(ap);
|
||||||
}
|
}
|
||||||
#endif
|
|
||||||
|
75
src/errc.c
Normal file
75
src/errc.c
Normal file
@ -0,0 +1,75 @@
|
|||||||
|
/*
|
||||||
|
* Copyright © 2006 Robert Millan
|
||||||
|
* Copyright © 2011, 2019 Guillem Jover <guillem@hadrons.org>
|
||||||
|
*
|
||||||
|
* Redistribution and use in source and binary forms, with or without
|
||||||
|
* modification, are permitted provided that the following conditions
|
||||||
|
* are met:
|
||||||
|
* 1. Redistributions of source code must retain the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer.
|
||||||
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer in the
|
||||||
|
* documentation and/or other materials provided with the distribution.
|
||||||
|
* 3. The name of the author may not be used to endorse or promote products
|
||||||
|
* derived from this software without specific prior written permission.
|
||||||
|
*
|
||||||
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
||||||
|
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
||||||
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
||||||
|
* THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
||||||
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
||||||
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
||||||
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
||||||
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
||||||
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
|
||||||
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include <err.h>
|
||||||
|
#include <string.h>
|
||||||
|
#include <stdarg.h>
|
||||||
|
#include <stdlib.h>
|
||||||
|
#include <stdio.h>
|
||||||
|
|
||||||
|
void
|
||||||
|
vwarnc(int code, const char *format, va_list ap)
|
||||||
|
{
|
||||||
|
fprintf(stderr, "%s: ", getprogname());
|
||||||
|
if (format) {
|
||||||
|
vfprintf(stderr, format, ap);
|
||||||
|
fprintf(stderr, ": ");
|
||||||
|
}
|
||||||
|
fprintf(stderr, "%s\n", strerror(code));
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
warnc(int code, const char *format, ...)
|
||||||
|
{
|
||||||
|
va_list ap;
|
||||||
|
|
||||||
|
va_start(ap, format);
|
||||||
|
vwarnc(code, format, ap);
|
||||||
|
va_end(ap);
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
verrc(int status, int code, const char *format, va_list ap)
|
||||||
|
{
|
||||||
|
fprintf(stderr, "%s: ", getprogname());
|
||||||
|
if (format) {
|
||||||
|
vfprintf(stderr, format, ap);
|
||||||
|
fprintf(stderr, ": ");
|
||||||
|
}
|
||||||
|
fprintf(stderr, "%s\n", strerror(code));
|
||||||
|
exit(status);
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
errc(int status, int code, const char *format, ...)
|
||||||
|
{
|
||||||
|
va_list ap;
|
||||||
|
|
||||||
|
va_start(ap, format);
|
||||||
|
verrc(status, code, format, ap);
|
||||||
|
va_end(ap);
|
||||||
|
}
|
@ -1,4 +1,4 @@
|
|||||||
/* $OpenBSD: explicit_bzero.c,v 1.3 2014/06/21 02:34:26 matthew Exp $ */
|
/* $OpenBSD: explicit_bzero.c,v 1.4 2015/08/31 02:53:57 guenther Exp $ */
|
||||||
/*
|
/*
|
||||||
* Public domain.
|
* Public domain.
|
||||||
* Written by Matthew Dempsky.
|
* Written by Matthew Dempsky.
|
||||||
@ -6,6 +6,9 @@
|
|||||||
|
|
||||||
#include <string.h>
|
#include <string.h>
|
||||||
|
|
||||||
|
__attribute__((__weak__)) void
|
||||||
|
__explicit_bzero_hook(void *, size_t);
|
||||||
|
|
||||||
__attribute__((__weak__)) void
|
__attribute__((__weak__)) void
|
||||||
__explicit_bzero_hook(void *buf, size_t len)
|
__explicit_bzero_hook(void *buf, size_t len)
|
||||||
{
|
{
|
||||||
|
@ -25,10 +25,11 @@
|
|||||||
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <sys/cdefs.h>
|
#include <sys/cdefs.h>
|
||||||
#include <sys/types.h>
|
#include <sys/types.h>
|
||||||
|
|
||||||
#include <string.h>
|
#include <string.h>
|
||||||
|
#include <stdio.h>
|
||||||
|
|
||||||
#include "local-link.h"
|
#include "local-link.h"
|
||||||
|
|
||||||
@ -76,8 +77,8 @@ fgetln(FILE *stream, size_t *len)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
libbsd_link_warning(fgetln,
|
libbsd_link_warning(fgetln,
|
||||||
"This function cannot be safely ported, use getline(3) "
|
"The fgetln() function cannot be safely ported, use getline(3) "
|
||||||
"instead, as it is supported by GNU and POSIX.1-2008.")
|
"instead, as it is supported by GNU and POSIX.1-2008.");
|
||||||
#else
|
#else
|
||||||
#error "Function fgetln() needs to be ported."
|
#error "Function fgetln() needs to be ported."
|
||||||
#endif
|
#endif
|
||||||
|
@ -87,6 +87,9 @@ fgetwln(FILE *stream, size_t *lenp)
|
|||||||
*lenp = wused;
|
*lenp = wused;
|
||||||
return wused ? fb->wbuf : NULL;
|
return wused ? fb->wbuf : NULL;
|
||||||
}
|
}
|
||||||
|
/* XXX: Ideally we'd recommend getwline(3), but unfortunately even though it
|
||||||
|
* was part of the ISO/IEC TR 24731-2:2010 draft, it did not make it into C11
|
||||||
|
* and is not widely implemented. */
|
||||||
libbsd_link_warning(fgetwln,
|
libbsd_link_warning(fgetwln,
|
||||||
"This function cannot be safely ported, use fgetwc(3) "
|
"The fgetwln() function cannot be safely ported, use fgetwc(3) "
|
||||||
"instead, as it is supported by C99 and POSIX.1-2001.")
|
"instead, as it is supported by C99 and POSIX.1-2001.");
|
||||||
|
29
src/flopen.c
29
src/flopen.c
@ -38,6 +38,27 @@
|
|||||||
|
|
||||||
#include <libutil.h>
|
#include <libutil.h>
|
||||||
|
|
||||||
|
static int
|
||||||
|
lock_file(int fd, int flags)
|
||||||
|
{
|
||||||
|
int operation;
|
||||||
|
|
||||||
|
#if HAVE_FLOCK
|
||||||
|
operation = LOCK_EX;
|
||||||
|
if (flags & O_NONBLOCK)
|
||||||
|
operation |= LOCK_NB;
|
||||||
|
|
||||||
|
return flock(fd, operation);
|
||||||
|
#else
|
||||||
|
if (flags & O_NONBLOCK)
|
||||||
|
operation = F_TLOCK;
|
||||||
|
else
|
||||||
|
operation = F_LOCK;
|
||||||
|
|
||||||
|
return lockf(fd, operation, 0);
|
||||||
|
#endif
|
||||||
|
}
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Reliably open and lock a file.
|
* Reliably open and lock a file.
|
||||||
*
|
*
|
||||||
@ -49,7 +70,7 @@
|
|||||||
static int
|
static int
|
||||||
vflopenat(int dirfd, const char *path, int flags, va_list ap)
|
vflopenat(int dirfd, const char *path, int flags, va_list ap)
|
||||||
{
|
{
|
||||||
int fd, operation, serrno, trunc;
|
int fd, serrno, trunc;
|
||||||
struct stat sb, fsb;
|
struct stat sb, fsb;
|
||||||
mode_t mode;
|
mode_t mode;
|
||||||
|
|
||||||
@ -62,10 +83,6 @@ vflopenat(int dirfd, const char *path, int flags, va_list ap)
|
|||||||
mode = (mode_t)va_arg(ap, int); /* mode_t promoted to int */
|
mode = (mode_t)va_arg(ap, int); /* mode_t promoted to int */
|
||||||
}
|
}
|
||||||
|
|
||||||
operation = LOCK_EX;
|
|
||||||
if (flags & O_NONBLOCK)
|
|
||||||
operation |= LOCK_NB;
|
|
||||||
|
|
||||||
trunc = (flags & O_TRUNC);
|
trunc = (flags & O_TRUNC);
|
||||||
flags &= ~O_TRUNC;
|
flags &= ~O_TRUNC;
|
||||||
|
|
||||||
@ -73,7 +90,7 @@ vflopenat(int dirfd, const char *path, int flags, va_list ap)
|
|||||||
if ((fd = openat(dirfd, path, flags, mode)) == -1)
|
if ((fd = openat(dirfd, path, flags, mode)) == -1)
|
||||||
/* non-existent or no access */
|
/* non-existent or no access */
|
||||||
return (-1);
|
return (-1);
|
||||||
if (flock(fd, operation) == -1) {
|
if (lock_file(fd, flags) == -1) {
|
||||||
/* unsupported or interrupted */
|
/* unsupported or interrupted */
|
||||||
serrno = errno;
|
serrno = errno;
|
||||||
(void)close(fd);
|
(void)close(fd);
|
||||||
|
@ -26,13 +26,15 @@
|
|||||||
|
|
||||||
#include <errno.h>
|
#include <errno.h>
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
|
#if HAVE_STDIO_EXT_H
|
||||||
#include <stdio_ext.h>
|
#include <stdio_ext.h>
|
||||||
|
#endif
|
||||||
|
|
||||||
#ifdef HAVE___FPURGE
|
#ifdef HAVE___FPURGE
|
||||||
int
|
int
|
||||||
fpurge(FILE *fp)
|
fpurge(FILE *fp)
|
||||||
{
|
{
|
||||||
if (fp == NULL || fileno(fp) < 0) {
|
if (fp == NULL) {
|
||||||
errno = EBADF;
|
errno = EBADF;
|
||||||
return EOF;
|
return EOF;
|
||||||
}
|
}
|
||||||
|
@ -65,7 +65,7 @@ funopen_write(void *cookie, const char *buf, size_t size)
|
|||||||
}
|
}
|
||||||
|
|
||||||
static int
|
static int
|
||||||
funopen_seek(void *cookie, off64_t *offset, int whence)
|
funopen_seek(void *cookie, off_t *offset, int whence)
|
||||||
{
|
{
|
||||||
struct funopen_cookie *cookiewrap = cookie;
|
struct funopen_cookie *cookiewrap = cookie;
|
||||||
off_t soff = *offset;
|
off_t soff = *offset;
|
||||||
@ -137,12 +137,6 @@ funopen(const void *cookie,
|
|||||||
|
|
||||||
return fopencookie(cookiewrap, mode, funcswrap);
|
return fopencookie(cookiewrap, mode, funcswrap);
|
||||||
}
|
}
|
||||||
#elif defined(__MUSL__)
|
|
||||||
/*
|
|
||||||
* This is unimplementable on musl based systems, and upstream has stated
|
|
||||||
* they will not add the needed support to implement it. Just ignore this
|
|
||||||
* interface there, as it has never been provided anyway.
|
|
||||||
*/
|
|
||||||
#else
|
#else
|
||||||
#error "Function funopen() needs to be ported or disabled."
|
#error "Function funopen() needs to be ported."
|
||||||
#endif
|
#endif
|
||||||
|
@ -26,6 +26,8 @@
|
|||||||
#include <errno.h>
|
#include <errno.h>
|
||||||
#include <stddef.h>
|
#include <stddef.h>
|
||||||
|
|
||||||
|
int getentropy(void *buf, size_t len);
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Derived from lib/libc/gen/arc4random.c from FreeBSD.
|
* Derived from lib/libc/gen/arc4random.c from FreeBSD.
|
||||||
*/
|
*/
|
||||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user