cmsg(3): Clarify guarantees about CMSG_SPACE/LEN constancy.

Add some line breaks while here to break up walls of text so it's
easier to compare the two paragraphs and see how CMSG_SPACE is meant
for struct msghdr::msg_controllen and CMSG_LEN is meant for struct
cmsghdr::cmsg_len.

PR lib/59054: cmsg(3) uses malloc(3) unnecessarily

cmsg(3): Handle as many descriptors as the sender sends in example.

Due to a quirk of alignment, sizing the control buffer for
CMSG_SPACE(sizeof(int)) does not guarantee at most one file
descriptor fits in the buffer -- so if there is a chance the sender
may send more than one descriptor, the receiver has to loop over all
of them to avoid leaks.

Prompted by:

PR lib/59054: cmsg(3) uses malloc(3) unnecessarily

cmsg(3): Don't use malloc in example.

Since CMSG_SPACE (and CMSG_LEN) is required to expand to an integer
constant expression by POSIX, and it does in NetBSD as of 2012, there
is no reason to use malloc here -- we can just allocate the buffer on
the stack without tripping over variable-length arrays.

PR lib/59054: cmsg(3) uses malloc(3) unnecessarily

branches: 1.3.28;
correct CMSG_DATA documentation

branches: 1.2.2;
and adjust it to our liking.

steal the OpenBSD man page.

Add man page for container_of

libc: New C11 functions mbrtoc16, mbrtoc32, c16rtomb, c32rtomb.

The mbrtoc16/32 functions read mulitbyte strings according to the
current locale into UTF-16/32 code unit sequences; the c16/32rtomb
functions write UTF-16/32 code unit sequences into multibyte strings
according to the current locale. The `r' means restartable: they
work incrementally and pick up where they left off.

NOTE: This bumps the libc minor version, since it adds new symbols.

PR lib/52374: <uchar.h> missing

branches: 1.92.2;
Add _dlauxinfo

branches: 1.91.2;
Add __MASK(3)

__MASK(n): first n bits all set, where __MASK(4) == 0b1111.

Document dlinfo(3)

Man-page taken from FreeBSD.

Document __FPTRCAST
XXX: more macros need documentation (__CAST etc.)

branches: 1.88.26;
fix typo

and a few more.

forgot one

Sync queue man pages with queue.h.

remove CIRCLEQ pages.

Add man mage links for __debugused(3) and __diagused(3).

describe the __USE macro

add __BITMAP_TYPE

add documentation for the bitmap macros

branches: 1.79.2; 1.79.8;
Add a summary page for <limits.h>.

Retire varargs.h support. Move machine/stdarg.h logic into MI
sys/stdarg.h and expect compiler to provide proper builtins, defaulting
to the GCC interface. lint still has a special fallback.
Reduce abuse of _BSD_VA_LIST_ by defining __va_list by default and
derive va_list as required by standards.

PR/45015: ld.elf_so: support ELF symbol versioning
Applied latest patch.

Add a cmsg.3 man page symlink, since I can never remember its name.

ok wiz

Add a small summary parge for struct tm from <time.h>. Cf. timeval(3).

Add a small summary page for <unistd.h>.

Add also a small summary page for <sys/bitops.h>.

Briefly summarize <sys/param.h>.

Briefly document <paths.h>.

Briefly document __predict_true() and __predict_false().

Document the __builtin_prefetch() GNU extension.

Document the __builtin_types_compatible_p() GNU/GCC extension.

Document __builtin_constant_p().

Document the __builtin_return_address() GNU extension. Again this is well
justified due to the wide use of these non-standard extensions in the tree.

Document the __alignof__ GNU extension.

There is no harm to add a manual page for the GNU typeof()-construct, given
that it has already crawled into the source tree.

Briefly describe __read_mostly and __cachline_aligned.

Add __insn_barrier(3). XXX: Someone more knowledgeable may want to check this.

Document __dead, __pure, __constfunc, __noinline, __unused, and __used.

Now that <sys/cdefs.h> is mostly documented, include a small summary page
for it, cdefs(3).

Start to document the GNU C attributes. For now, only __packed, __aligned,
and __section are documented, but I will keep extending this.

Add a manual page for the makedev(), major(), and minor() macros.

Taken from FreeBSD. Written by Ed Schouten.

Catch-up with code changes.

Implement dl_iterate_phdr.

Somewhat taken from FreeBSD. Manual page from OpenBSD.

Document ilog2() from <sys/bitops.h>.

Add sigevent(3), a manual page that describes the struct sigevent used by
the POSIX real time functions and timers.

XXX: (a) Needs to be modified once real time signals are supported.
(b) Could use an example.

Describe also the timespec() family of macros in timeradd(3).

Add a manual page that describes the basic structures in <sys/time.h>.

As was done with the man-page for <sys/types.h>, move dir(5) to dirent(3).
Add a table describing the stat <-> dirent types. Note IFTODT() and DTTOIF().

Document ffs32(), ffs64(), fls32(), and fls64() from <sys/bitops.h>.

Rewrite types(5) as per perry@'s suggestion from few years back ("XXX this
document is rather musty. It needs a general update."). Also move it to the
right section from section 5. Ok wiz@.

To minimize maintenance costs, the content is mostly jargon around The
Standard. Only few NetBSD-specific types are mentioned as an example.

Document __STRING(x) and __CONCAT(x, y) from <sys/cdefs.h>.

Hook rb(3) to the build.

Document <stdlib.h>.

Written with minimum maintenance costs in mind; only the defined types and
macros are described.

Document the weird <iso646.h>.

Document <inttypes.h>.

While at it, add also stddef(3).

As we have added stdint(3) and tgmath(3), we may as well add stdbool(3).

Add a manual page for <stdint.h>. From FreeBSD, by Mike Barcroft.

Add man page for fast_divide32.

Add tgmath(3). From FreeBSD.

XXX: Needs proofreading, Matt?

Document __arraycount.

Document __UNCONST and __UNVOLATILE.

XXX: If there is anything to add or correct, please do so!

Add offsetof(3) man page. From Thomas Pfaff via OpenBSD.

Do not link timeradd.3 to itself.

Add timeradd(3).

add missing MLINKS for bitstring.3

branches: 1.32.2; 1.32.4;
steal the OpenBSD man page.

branches: 1.31.6; 1.31.10;
Add table which summarizes operations supported by each queue type.

from Stathis Kamperis in PR misc/36857

branches: 1.30.2;
Replace to Matthew Orgass's slhci(4).
http://mail-index.netbsd.org/tech-kern/2007/06/26/0001.html

Per discussion on tech-kern and tech-userlevel, move the bit-twiddling
macros, __BIT, __BITS, SHIFTIN, SHIFTOUT, and __arraycount() from
lib/libkern/libkern.h to sys/cdefs.h. Add a __-prefix to SHIFTIN
and SHIFTOUT, and add a manual page for the bit-twiddling macros,
bits(3).

Make the __BIT and __BITS macros "widthless," as best I can, by
changing their type to uintmax_t from uint32_t. XXX The manual
page lags this change by a bit.

Define __PRIxBIT and __PRIxBITS printf(3) format strings.

document CIRCLEQ_LOOP

Add sysexits.3

Add MLINKS for:
CIRCLEQ_FOREACH(3) CIRCLEQ_FOREACH_REVERSE(3)
LIST_FOREACH(3)
SIMPLEQ_FOREACH(3)
SLIST_EMPTY(3) SLIST_ENTRY(3) SLIST_FIRST(3) SLIST_FOREACH(3)
SLIST_HEAD(3) SLIST_HEAD_INITIALIZER(3) SLIST_INIT(3)
SLIST_INSERT_AFTER(3) SLIST_INSERT_HEAD(3) SLIST_NEXT(3)
SLIST_REMOVE(3) SLIST_REMOVE_HEAD(3)
STAILQ_EMPTY(3) STAILQ_ENTRY(3) STAILQ_FIRST(3) STAILQ_FOREACH(3)
STAILQ_HEAD(3) STAILQ_HEAD_INITIALIZER(3) STAILQ_INIT(3)
STAILQ_INSERT_AFTER(3) STAILQ_INSERT_HEAD(3) STAILQ_INSERT_TAIL(3)
STAILQ_NEXT(3) STAILQ_REMOVE(3) STAILQ_REMOVE_HEAD(3)
TAILQ_FOREACH(3) TAILQ_FOREACH_REVERSE(3) TAILQ_LAST(3) TAILQ_PREV(3)

tree(3) manpage from OpenBSD.

SIMPLEQ rototill:
- implement SIMPLEQ_REMOVE(head, elm, type, field). whilst it's O(n),
this mirrors the functionality of SLIST_REMOVE() (the other
singly-linked list type) and FreeBSD's STAILQ_REMOVE()
- remove the unnecessary elm arg from SIMPLEQ_REMOVE_HEAD().
this mirrors the functionality of SLIST_REMOVE_HEAD() (the other
singly-linked list type) and FreeBSD's STAILQ_REMOVE_HEAD()
- remove notes about SIMPLEQ not supporting arbitrary element removal
- use SIMPLEQ_FOREACH() instead of home-grown for loops
- use SIMPLEQ_EMPTY() appropriately
- use SIMPLEQ_*() instead of accessing sqh_first,sqh_last,sqe_next directly
- reorder manual page; be consistent about how the types are listed
- other minor cleanups

Add a separate varargs(3) manual page, reusing stdarg(3) contents, and
remove the name `varargs' from stdarg(3); inspired by conversation with
Charles Hannum.

install all the macro links to queue.3 using the correct UPPER_CASE name

add manual page for _DIAGASSERT(3)

PCVT is dead. From NAKAJIMA Yoshihiro <nakayosh@kcn.ne.jp>.

branches: 1.19.2;
Document *_EMPTY().

branches: 1.18.2;
Document va_copy.

Add missing link for dladdr.3

Oops; missed one.

Add missing links for queue.3.

Use bsd.man.mk and bsd.subdir.mk as appropriate.

PR/4126: Luke Mewburn: queue(3) doesn't document SIMPLEQ_*

SUBDIR must be set *before* including bsd.*.mk

move man pages into share/man.

Fix typo: dclose.3 -> dlclose.3

Install dlfcn.3 and links.

specify man pages the new way.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

Add more links for queue.h.

queue.h from 4.4, from Bostic

Add links for va_arg.3, va_end.3, va_start.3, per G.Wollman's suggestion.

Add RCS indentifiers.

Once more, don't make `all' depend on man page; bsd.prog.mk does this.

branches: 1.1.1;
Initial revision

Convert TNF licenses to new 2 clause variant

branches: 1.7.10; 1.7.12;
Add additional cross-references (from Slava Semushin).

The actual environment variable is `LIBC_DIAGASSERT' not `LIBC_DIAGNOSTIC'.
Spotted by Nathan Williams < nathanw @ >.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Typo/whitespace fix.

remove unnecessary duplication

add manual page for _DIAGASSERT(3)

Remove trailing whitespace.

add non-portability caveat.

branches: 1.6.6; 1.6.12;
Xref cdefs(3).

\\ -> \e

Reorder prologue

Fix an xref and change word order slightly so it sounds better to me.

Fix a roff warning.

Document __STRING(x) and __CONCAT(x, y) from <sys/cdefs.h>.

branches: 1.2.4;
Make a sentence easier to read, and fix some nits.

Document __FPTRCAST
XXX: more macros need documentation (__CAST etc.)

Remove trailing whitespace.

add non-portability caveat.

branches: 1.5.6; 1.5.12;
Xref cdefs(3).

Reorder prologue

As per suggestions from mrg@, improve the lead paragraph and stress that
these macros are not recommended. Also remove the example as it feels a
little frivolous and takes too much space.

Sort SEE ALSO. Remove unnecessary Pp.

Document __UNCONST and __UNVOLATILE.

XXX: If there is anything to add or correct, please do so!

branches: 1.2.4; 1.2.8;
- DPRINTF(("val is %d\n", val)); -> DPRINTF(("val is %d\n", var));
- mdoclint:
- .Nd should not end with period
- remove trailing spaces

describe the __USE macro

No need to use \*[q], use plain double quotes instead.

A small clarification in the example.

Uppercase Dt argument, use \e for backslashes.

A small fix.

Document the __alignof__ GNU extension.

Remove workaround for ancient HTML generation code.

branches: 1.6.38;
Xref cdefs(3).

Reorder prologue

Speak about typical instead of possible usage in the example.

Uppercase Dt, make HTML-ready.

Use buf[BUFSIZE] instead of *buf[BUFSIZE] in the example.

Document __arraycount.

Fix xref.

Document __builtin_constant_p().

man: convert some URLs to https

branches: 1.3.58;
Fix Fn arguments.

Fix URL of the paper.

Document the __builtin_prefetch() GNU extension.

Document the __builtin_return_address() GNU extension. Again this is well
justified due to the wide use of these non-standard extensions in the tree.

Remove superfluous Pp.

Document the __builtin_types_compatible_p() GNU/GCC extension.

Remove Tn.

Replace xref mb(9) by xref membar_ops(3).

Xref __insn_barrier(3) and mb(9) with each other.

Add __insn_barrier(3). XXX: Someone more knowledgeable may want to check this.

Fix AT&T version reference. From PR misc/49519

Sort SEE ALSO.

Add additional cross-references (from Slava Semushin).

Kill an unnecessary argument to Nm.

Use St -isoC-9X instead of St -isoC9X, to be in sync with groff.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

C99: Print the name of the function enclosing the assertion, if possible.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

Use -DNDEBUG, not -NDEBUG to disable assertions.

Add RCS indentifiers.

Make assert macro ansi complient.

branches: 1.1.1;
Initial revision

PR/53608: Ian Bruene: document __{printf,syslog}like.

__dead functions can not return, which is different from not returning a
value.

branches: 1.16.22; 1.16.24;
Fix note on __predict_true: predicts nonzero, not 1 specifically.

branches: 1.15.2;
Whitespace; better macro.

Use markup in the descriptions of __diagused and __debugused.

Document __diagused and __debugused

Try to make this more compiler-neutral, and give both GCC and LLVM/Clang
as examples.

branches: 1.11.2; 1.11.4; 1.11.8;
typo: prefict -> predict

Briefly document __predict_true() and __predict_false().

Document the __alignof__ GNU extension.

Note that the previous are available only for the kernel.

Briefly describe __read_mostly and __cachline_aligned.

Reference __builtin_object_size(3) and attribute(3) with each other.

Document __dead, __pure, __constfunc, __noinline, __unused, and __used.

Paraphrase slightly.

Xref cdefs(3).

Remove extra .Pp before wizd(8) beats me.

Start to document the GNU C attributes. For now, only __packed, __aligned,
and __section are documented, but I will keep extending this.

Bump date for previous.

__BITMAP_ZERO() only takes the pointer to the bitmap as an argument

branches: 1.10.4;
Remove workaround for ancient HTML generation code.

branches: 1.9.18;
Merge riastradh-drm2 to HEAD.

Use <major>.<minor> for NetBSD version.

branches: 1.7.2; 1.7.4; 1.7.6;
add __BITMAP_TYPE

Whitespace.

more xref and info

Move the bitmap(3) test to the "right" place. Note it in bitops(3). Xrefs.

Whitespace, comma nit, uppercase Dt argument.

fix bug

add documentation for the bitmap macros

Sort the list. Minor markup and wording tweaks.

branches: 1.5.14;
Fix sentence.

branches: 1.4.12;
Move the bitmap(3) test to the "right" place. Note it in bitops(3). Xrefs.

branches: 1.3.4; 1.3.10;
And finally, fix a typo.

Clarify a little; ilog2(3) is a macro.

Add also a small summary page for <sys/bitops.h>.

New sentence, new line.

Add __MASK(3)

__MASK(n): first n bits all set, where __MASK(4) == 0b1111.

Add return type of the __SHIFT* macros. Bump date.

"looks right to me" from mrg@

Pp before Bl

Remove workaround for ancient HTML generation code.

branches: 1.17.6;
These have been able to handle uintmax-width masks since creation.

XXX pullup-6
XXX pullup-7

branches: 1.16.4; 1.16.8; 1.16.10;
Merge riastradh-drm2 to HEAD.

Use Mt for email addresses.

branches: 1.14.2;
Change to uintmax_t again.

Return value of __BIT() and __BITS() is not uint32_t but uint64_t.

branches: 1.12.4; 1.12.6; 1.12.10;
Small typo fix.

Xref bitops(3).

Xref cdefs(3).

Replace the example with something more generic and perceptual.

Apparently, you have to #include <sys/param.h>, too, for MAX().

Add a missing word introduced in the previous commit. Thanks, snj@.

Small changes to wording and markup.

Remove some /* comments */ in the example so that it will nicely fit into 80
columns.

Drop 3rd and 4th clauses from David Young's license.
Reviewed and approved by dyoung@ (copyright holder).

branches: 1.3.2;
PR/39381 - Taylor R Campbell -- missing line break causing funny formatting

branches: 1.2.2; 1.2.12; 1.2.16; 1.2.20;
Sort sections. Remove unnecessary quotes. Use macros for <>
for HTML output. Some nits.

Per discussion on tech-kern and tech-userlevel, move the bit-twiddling
macros, __BIT, __BITS, SHIFTIN, SHIFTOUT, and __arraycount() from
lib/libkern/libkern.h to sys/cdefs.h. Add a __-prefix to SHIFTIN
and SHIFTOUT, and add a manual page for the bit-twiddling macros,
bits(3).

Make the __BIT and __BITS macros "widthless," as best I can, by
changing their type to uintmax_t from uint32_t. XXX The manual
page lags this change by a bit.

Define __PRIxBIT and __PRIxBITS printf(3) format strings.

Remove workaround for ancient HTML generation code.

branches: 1.17.6;
bitstring.h does not provide size_t; include sys/types.h for that.
Bump date.

branches: 1.16.2;
reflect reality.

more xref and info

Move the bitmap(3) test to the "right" place. Note it in bitops(3). Xrefs.

branches: 1.13.50; 1.13.56;
Quote dot at beginning of line, otherwise it will be interpreted
as the start of a macro. From jmc@openbsd.

Add bit_ffc to NAME; sort functions in SYNOPSIS; from Sergey Svishchev.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Punctuation nit.

Use standard section headers.

First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

macroize BSD, NetBSD, FreeBSD and misc cleanup

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

description of return val for bit_test was reversed.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Document __FPTRCAST
XXX: more macros need documentation (__CAST etc.)

branches: 1.4.26;
refer to __USE(3)

branches: 1.3.4; 1.3.10;
Xref param(3).

Add __insn_barrier(3). XXX: Someone more knowledgeable may want to check this.

Now that <sys/cdefs.h> is mostly documented, include a small summary page
for it, cdefs(3).

branches: 1.2.4;
container_of(3): fix return type, don't indent example

There's no text around example so the indentation doesn't serve any
useful purpose and just wastes horizontal space. It's not too nice
given a lengthy line in the example.

Add man page for container_of

s/directry/directory/

I missread a diff before making the change for the previous commit.
Drop the reference to v7 and the direct struct.
https://www.bell-labs.com/usr/dmr/www/man51.pdf

dir(5) was what appeared in v7, the struct was called direct.
Fix history for dirent.

via Ingo Schwarze <schwarze@OpenBSD>

branches: 1.4.44;
Remove superfluous Pp.

Fix RCSID

Fix the SYNOPSIS.

As was done with the man-page for <sys/types.h>, move dir(5) to dirent(3).
Add a table describing the stat <-> dirent types. Note IFTODT() and DTTOIF().

branches: 1.2.10;
Use .In.

Implement dl_iterate_phdr.

Somewhat taken from FreeBSD. Manual page from OpenBSD.

dlfcn.3: remove duplicated dlopen() entry

dlfcn(3): touch up markup

Add _dlauxinfo

Oops. Restore the dot lost in -width ".Dv ..."

Fix -width in the tagged list of special "handle" values.

Minor tweaks.

Use same -indent for lists of values that are OR'ed as one argument.
Use consistent markup for dli_* member names.
Untabify Dl_info definition so that it lines up in PS output.

Clean up dash use. Remove superfluous Pp.

Bump date in dlfcn(3)

Cross-Link from dlfcn(3) to dlinfo(3)

branches: 1.33.42;
Bump date for previous.

PR/45015: ld.elf_so: support ELF symbol versioning
Applied latest patch.

Explain "Cannot dlopen non-loadable /usr/lib/libpthread.so.1".
Bump date.

branches: 1.30.2;
Fix xref and pasto.

Bump date.

Add support for DF_1_BIND_NOW, DF_1_NODELETE and DF_1_NOOPEN marked
objects, and the RTLD_NODELETE and RTLD_NOLOAD flags to dlopen(3).

Mark libpthread as DF_1_NOOPEN and use it to test the functionality.

Somewhat taken from FreeBSD.

Fixes PR 42029.

OK from christos and joerg.

Remove one unnecessary Ns. (Rest still ugly.)

Avoid using .Sm on/.Sm off if that results in the latter getting an
additional argument.

Use Dv for defined values.

Various improvements to bring closer to reality. Mostly from OpenBSD.

More improvements possible / probable.

.Ud doesn't take arguments.

Remove use of .Xo/.Xc to workaround ancient macro argument limit.

branches: 1.21.6;
Convert TNF licenses to new 2 clause variant

branches: 1.20.2; 1.20.4;
Portable code should use RTLD_LAZY, not DL_LAZY.

Add restrict qualifiers to dlsym() (XSI) and dladdr() arguments.

branches: 1.18.2;
Fix typo.

Add dladdr to NAME; fix type of dli_saddr; from Sergey Svishchev.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Fix typo in macro.

Typo/whitespace fix.

Spell occurred correctly.

document dlopen(NULL, ...)

branches: 1.10.6;
Note that the dl*() functions are not in a library per se but are
available in every dynamically linked program automatically.

Assign my copyrights to TNF.

Add information to dlerror() regarding its behaviour in absence of an error
condition.

Document `dladdr()'.

fix bad .Xr references

Sync with <dlfcn.h>: const'ify some arguments.

Fix bogons (missing commas) in the synopsis section

Note search mechanism.

Install dlfcn.3 and links.

Man page for dlfcn.h

s/sarch/search/ in commented part.

branches: 1.6.4;
Fix a typo

Correct the authorship note of dlinfo(3)

Miscellaneous fixes.

No space after asterisk in "type *arg".
There's no "-width indent", use something relevant instead.
Do not document the structure tag of the Link_map typedef.
Give the Link_map members a paragraph of their own for readability.
Give them a bit more breathing space in the tagged list.
Spell pooka's name correctly.

TODO: The text is pleonastic in several places ("Do foo. On success
does foo." etc) and could use some copy editing.

Add missing El. Fix grammar.

Bump date in dlinfo(3)

Document dlinfo(3)

Man-page taken from FreeBSD.

New sentence, new line.

In the wake of C99 (which dropped the implicit int), add a type specifier
to the declarations to keep them warning-free; also add some clarifying
words that the globals are _located at_ those addresses.

Inspired by a conversation with Takayoshi Kochi.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Close 2831, which noted that the man page is confusing. I have edited
it slightly differently than Mike originally suggested after
consulting with him and others.

the values of end, etext and edata are not set by brk(2)

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

Fix typo: It's etext, not extext.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

man: convert some URLs to https

branches: 1.9.18;
Remove workaround for ancient HTML generation code.

branches: 1.8.36;
Xref div(3) and remainder(3).

Xref bitops(3).

Back and forth: gcc(1) -> GCC.

EXAMPLE -> EXAMPLES, GCC -> gcc(1), and minor markup changes.

Do not use .pp with %P, as noted by joerg@.

Serial comma; prepare for HTML-output.

Add the (ACM) journal where this appeared. Fix URL.

Add man page for fast_divide32.

Sort SEE ALSO.

Xref bitops(3).

Fix prologue

Two small grammar fixes.

Fix typo in XXX-comment.

Document ffs32(), ffs64(), fls32(), and fls64() from <sys/bitops.h>.

Remove workaround for ancient HTML generation code.

branches: 1.3.38;
Drop trailing whitespace. Sort SEE ALSO. Make HTML-ready. Fix Dt argument case.

Fix a few spelling errors.

Replace to Matthew Orgass's slhci(4).
http://mail-index.netbsd.org/tech-kern/2007/06/26/0001.html

Rework ilog2(3) man page.

- Tweak title.
- Clarify semantics -- round down, not any other way.
- xref ffs(3)
- Fix return type: int.
- Fix language about input type.
. Any unsigned type is fine.
. Types smaller than uint32_t will be safely converted to uint32_t.
- Note that it is a constant expression if x is constant.

Xref ilogb(3).

Xref bitops(3).

Sort prologue

Put also powerof2(9) to SEE ALSO.

Document ilog2() from <sys/bitops.h>.

intro(3): g/c reference to non-existent -lhesiod

PR lib/59676

intro(3): g/c spurious .Tn

branches: 1.36.6; 1.36.10;
OpenSSL man pages have moved

intro.3: add a few

branches: 1.34.4;
Pass through mandoc -Tlint, drop Pp before Bl.
Remove reference to libkadm, it is no longer present in NetBSD.
Direct reader to kadm5_pwcheck(3) for libkadm5srv.

branches: 1.33.8;
Remove some vestiges of MKCRYPTO_IDEA/MKCRYPTO_MDC2.

Remove MKCRYPTO_RC5. Unconditionally include RC5 in libcrypto.so.

This option existed only because RC5 is covered by patents that, twenty
years ago, we had reason to suspect the patent holder, RSA, Inc., might
litigate. The two US patents in question are 5,724,428 and 5,835,600.

According to the USPTO Patent Term Calculator web site at
<https://www.uspto.gov/patent/laws-and-regulations/patent-term-calculator#heading-5>
(retrieved 2017-05-21), patents filed after 1995-06-07 expire twenty
years after the filing date.

number filing date
5,724,428 1995-11-01
5,835,600 1997-04-21

Thus, these patents appear to be expired.

As proposed on tech-crypto and tech-security:

https://mail-index.netbsd.org/tech-crypto/2017/05/05/msg000718.html
https://mail-index.netbsd.org/tech-security/2017/05/05/msg000927.html

Bump date for previous.

+libpanel: Z-order for curses windows

Finish previous.

Reference libusbhid instead of usb(3) (which was the predecessor for libusbhid).
Bump date.

add reference to usb(3) and zlib(3).

Add capfile(5) to describe the termcap format.
Adjust various man pages and other documentation to point to capfile(5)
instead of termcap(5).
Remove getcap(3) as curses hasn't been building it for a long time.
Punt wrterm.c as tset no longer uses it.

branches: 1.25.4;
New sentence, new line. Bump date for previous.

Initial import of libdm and dmctl to tree. libdm library can be used
to access, manage and manipulate device-mapper driver. Which opens us bunch
of new possibilities like

dm-multipath device target
dm-crypt device target
dm-ccd compatibility layer

With this import I'm bringing in dmctl tool for working with dm driver ,too.
I plan to replace gpl2 licensed dmsetup command with our dmctl tool in near
feature. It can also by placed to /rescue where we was not able to put
dmsetup because of licensing problems.

With libdm in tree we can now write RUMP atf test suite for dm driver to
ensure LVM subsystem stability as time goes.

Reviewed by: blymn@ and rmind@
Oked: by no objections on tech-userlevel@

branches: 1.23.2;
Remove reference to Curses development kit (CDK) which do not exists
anymore.

Remove use of .Xo/.Xc to workaround ancient macro argument limit.

branches: 1.21.36;
Fix typo, and comment out link to non-existing usb(3); from Sergey Svishchev.

Fix two trailing xrefs and kill an unnecessary argument to Nm.

Err, nevermind.

Correct usb Xref.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

General cleanup; xref kafs(3)

- Xr cdk(3), for what is worth
- describe libposix with xrefs

Xref util.3

xref com_err(3)

- cross-reference skey(3)
- relegate FILES section to library pages

Reference krb5(3) and add description for libcom_err.

Rework to describe the plethora of libraries that arrived with the
introduction of crypto/Kerberos into the base system.

Doesn't have a hope of being complete since there is little (no?)
documentation available on what the libraries actually do, much
less how to use the functions included within them. It's questionable
whether some of the libraries should exist in the first place.

Does NOT address lib/11191, lib/11171 + others I haven't found yet.

Boring whitespace fixes.

First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

In SEE ALSO list, use comma to separate elements and don't use to terminate.

fix bad .Xr references

Commented out inappropriate sections and cross references

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

tiny cleanup

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Fix prologue. \\ -> \e

Document <inttypes.h>.

Remove workaround for ancient HTML generation code.

branches: 1.5.38;
Darn - can't tytpe today!

Get this right (don't need to \ escape the [Ba]) and update the date

Fix typo - or_eq is "|=" and not "!="

Fix prologue

Document the weird <iso646.h>.

Fix prologue macros order.

Add a summary page for <limits.h>.

Xref MAKEDEV(8).

Add a manual page for the makedev(), major(), and minor() macros.

Taken from FreeBSD. Written by Ed Schouten.

No need to use \*[q], use plain double quotes instead.

Add example.

Document the __alignof__ GNU extension.

Reference stddef(3).

Add offsetof(3) man page. From Thomas Pfaff via OpenBSD.

Xref unistd(3).

Xref bitops(3).

Remove leftover .Ed.

Briefly summarize <sys/param.h>.

Use bullets in the list.

Fix prologue macros order.

Briefly document <paths.h>.

Remove the CIRCLEQ API from queue(3)

It was marked deprecated in NetBSD 7 and already removed from
FreeBSD in 2000 and OpenBSD in 2015.

Proposed on tech-kern@.

queue.3: deduplicate deduplicate a a word word

branches: 1.59.2;
Update for new signature for LIST_MOVE()

s/tail queue/simple queue/ in SIMPLE QUEUES section.

Remove workaround for ancient HTML generation code.

branches: 1.56.4;
Use Fn instead of Nm to refer the macros in the body of the man page.

Thanks to wiz@ for reviewing.

Remove comma after the last Nm entry.

fix tyop

branches: 1.53.2;
Remove trailing whitespace.

Correct list of operations to note that SLISTs and SIMPLEQs cannot insert
entries before existing entries. This can only be done for LISTs and
TAILQs.

Fixes PR kern/50845

Fix layout for comments. Bump date.

Fix some grammar and punctuation issues. Remove a pasto.

branches: 1.49.2;
Whitespace and punctuation.

Rename LIST_CONCAT() to LIST_MOVE() as that is what it actually does (and
there is no point to implement LIST_CONCAT() which would iterate). Update
the queue(3) manpage.

branches: 1.47.2;
Very slightly more consistency in ordering in SYNOPSIS.
Fix a few typos. Remove superfluous Pp.

Sync queue man pages with queue.h.

Remove extra comma.

remove documentation for CIRCLEQ to discourage its use.

Remove a tab character in non-literal context.
While here, replace all sp macros with Pp.

branches: 1.42.6; 1.42.12;
Add queue macros SLIST_FOREACH_SAFE, STAILQ_FOREACH_SAFE, STAILQ_LAST,
SIMPLEQ_CONCAT, and SIMPLEQ_LAST.

Remove seperate definitions outside of queue.h.

Do not mark up "and". Bump date for previous.

add a SIMPLEQ_FOREACH_SAFE() macro.

document it, and the TAILQ versions.

branches: 1.39.4;
Add a NOTE saying that invalid usage leads to undefined behaviour.
Inspired by PR 39684.

Move TNF licenses to 2 clause form

branches: 1.37.6; 1.37.8;
Add TAILQ_CONCAT() and STAILQ_CONCAT(), from FreeBSD.

Note that CIRCLEQ_LOOP first appeared in NetBSD 4.0.

bump date

Wrath of wizd avoided because of quick tip from Juan RP.

Add table which summarizes operations supported by each queue type.

from Stathis Kamperis in PR misc/36857

branches: 1.33.6; 1.33.8; 1.33.12;
document CIRCLEQ_LOOP

* CICRLEQ -> CIRCLEQ in some places (it's much easier to pronounce)
* be more explicit that CIRCLEQ_FOREACH{,_REVERSE) traverse the queue
exactly once

Fix CIRCLEQ example bug, from Peter A Jonsson.

Reorder macros within a queue type to match queue.h definition order.
Document STAILQ_* as compatibility macros for SIMPLEQ_*.
Document TAILQ_LAST and TAILQ_PREV.

Bump date for pooka.

Note that SLISTs came from FreeBSD to give people an idea that
they're not necessarily a part of 4.4BSD derived implementations.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Grammar fix, from jmc@openbsd.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

SIMPLEQ rototill:
- implement SIMPLEQ_REMOVE(head, elm, type, field). whilst it's O(n),
this mirrors the functionality of SLIST_REMOVE() (the other
singly-linked list type) and FreeBSD's STAILQ_REMOVE()
- remove the unnecessary elm arg from SIMPLEQ_REMOVE_HEAD().
this mirrors the functionality of SLIST_REMOVE_HEAD() (the other
singly-linked list type) and FreeBSD's STAILQ_REMOVE_HEAD()
- remove notes about SIMPLEQ not supporting arbitrary element removal
- use SIMPLEQ_FOREACH() instead of home-grown for loops
- use SIMPLEQ_EMPTY() appropriately
- use SIMPLEQ_*() instead of accessing sqh_first,sqh_last,sqe_next directly
- reorder manual page; be consistent about how the types are listed
- other minor cleanups

correct descriptions of SLIST_REMOVE_HEAD() and SIMPLEQ_REMOVE_HEAD()

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

s/All four/All five/

Drop unneeded empty line.

Typo/whitespace fix.

Fix description of simple queue. misc/12917 by Witold J. Wnuk with an
additional 'of '.

Subst head.cqh_first with CIRCLEQ_FIRST(&head) instead of CIRCLEQ_HEAD.
Pointed out by Tim on icb sometimes ago (iirc).

document the singly-linked list macros brought in last year. also
document FOREACH_*{,_REVERSE}, to be added to queue.h shortly.

random cleanups and clarifications, mostly from the freebsd queue.3

One more formatting nit. *sigh*

Update the date.

Fix formatting error.

Document *_EMPTY().

branches: 1.11.2;
Don't pass so many args to .Nd macro. It just overflows.

branches: 1.10.6;
First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

macroize BSD, NetBSD, FreeBSD and misc cleanup

Document new queue access methods.

PR/4126: Luke Mewburn: queue(3) doesn't document SIMPLEQ_*

Fix broken uses of Dd. Both the mdoc and mdoc.samples pages agree:
.Dd is supposed to be invoked like:
.Dd month day, year
e.g. ".Dd January 25, 1989", rather than:
.Dd "month day, year"
which is what these pages did.

add and document *_HEAD_INITIALIZER macros, which provide structure
initializers which can be used to initialize list/queue heads at
compile time.

Document {LIST,TAILQ}_INSERT_BEFORE().

Document {LIST,TAILQ}_INSERT_BEFORE().

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

branches: 1.1.1;
queue.h from 4.4, from Bostic

Catch-up with code changes.

Add missing .El directive.

Sort SEE ALSO. New sentence, new line.

Some cosmetic modifications, including removal of white space.

First draft of a manual page for Matt Thomas' red-black trees. Please
review for correctness.

rbtree: Rename rb.c to rbtree.c to match it's header rbtree.h

While here rename RBTEST to RBLOCAL to give a better meaning as we
want to include the local rbtest.h rather than the system one.

Also allow to compile outside of NetBSD source tree by guarding some
things we would otherwise expect to be defined.

rbtree(3): Implement _FOREACH_SAFE macros

And _NEXT and _PREV as well.

branches: 1.12.14;
Use only "function" for the comparison functions, not both that and
"operator". Noted by riastradh.

Clarify the usage, so hopefully nobody else makes the set of wrong
assumptions I just did.

Merge riastradh-drm2 to HEAD.

Use Mt for email addresses.

branches: 1.8.4;
Fix documentation of rbtree(3) iteration.

. Fix sense of rb_tree_iterate(rbt, NULL, ...).
. Document RB_TREE_MIN/RB_TREE_MAX to avoid relying on that sense.
. Document RB_TREE_FOREACH and RB_TREE_FOREACH_REVERSE to simplify
iteration.

Addresses PR lib/46034 and PR lib/47144. It would have been nice to
make `x = NULL; while ((x = rb_tree_iterate(t, NULL, ...)) != NULL)'
DTRT to traverse t, but it's too much late for that now.

We probably ought to have an RB_TREE_FOREACH{,_REVERSE}_SAFE too.

ok christos

branches: 1.7.2;
Add more function argument names to the man page, trying to address
PR 46814 by Lloyd Parkes. Bump date.

sync with code
(remove const quals)

branches: 1.5.4; 1.5.6; 1.5.8;
Fix manpage wrt reversed compare functions.

Remove boiler plate paragraph in the CODE REFERENCES section.

Fix typo in previous commit.

- Add library section.
- Fix function signatures.
- Describe added member to an ops structure.
- Describe rb_tree_remove_node.

Catch-up with code changes.

Couple of grammar fixes.

Sort SEE ALSO.

Fix xref: timer_create(3) -> timer_create(2).

Xref mq(3).

Add a bold-faced note that the interface is not fully functional, but the
opposite.

Continue the discussion w.r.t. SIGEV_THREAD by nothing that pthread_join(3)
should be out of the question and that thread stack cannot be recovered.

Sort sections.

Add sigevent(3), a manual page that describes the struct sigevent used by
the POSIX real time functions and timers.

XXX: (a) Needs to be modified once real time signals are supported.
(b) Could use an example.

Catch up with <varargs.h> removal.

Sort sections.

Use .In instead of .Aq Pa for header files.

Use St -isoC-9X instead of St -isoC9X, to be in sync with groff.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

mention argument promotion and change example
as well.
from OpenBSD.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

KNF example code snippet.

Add a separate varargs(3) manual page, reusing stdarg(3) contents, and
remove the name `varargs' from stdarg(3); inspired by conversation with
Charles Hannum.

While va_{start,arg,end} conform to ISO C90, they were certainly not
introduced in there but ANSI C; pointed out by Charles.

Punctuation fix.

Boring whitespace fixes.

Make standards/portability description more granular.

Typoe in previous.

Document va_copy.

Minor KNF nit.

add missing .Nm calls and MLINKS. from spz@serpens.swb.de

branches: 1.3.4;
Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Fix prologue

As we have added stdint(3) and tgmath(3), we may as well add stdbool(3).

Xref unistd(3).

Fix prologue

Document <stdlib.h>.

Written with minimum maintenance costs in mind; only the defined types and
macros are described.

Mark up NULL with Dv, as usual.

Note that some definitions, such as NULL, were already in v4 UNIX.

Remove superfluous Pp.

Note that some of these were already in ANSI C.

XXX: Maybe someone with insight adds a word or two about the history?

While at it, add also stddef(3).

Xref limits(3).

Xref unistd(3).

Document <inttypes.h>.

Reference stdbool(3).

Remove quotes around Nd argument, they are not needed.

Add a manual page for <stdint.h>. From FreeBSD, by Mike Barcroft.

Xref unistd(3).

Fix prologue

Document <stdlib.h>.

Written with minimum maintenance costs in mind; only the defined types and
macros are described.

Use .In for headers.

Do not Xr yourself.

Document <stdlib.h>.

Written with minimum maintenance costs in mind; only the defined types and
macros are described.

Fix preamble to match order set out by mdoc(7). Discussed with wiz.

branches: 1.2.30;
Use Dv instead of Sy for macros.
Do not Xr to ourselves, use .Nm instead.

Add a manual page for <sysexists.h>, from FreeBSD with a minor
adjustments (removed reference to the style(9) man page added NetBSD
to the HISTORY section) by me.

Merge riastradh-drm2 to HEAD.

Use Mt for email addresses.

branches: 1.7.4; 1.7.10; 1.7.14;
Add missing Ta macro.

branches: 1.6.2;
Remove functions/macros that are not in <tgmath.h> in NetBSD.
Use .Xr instead of .Fn for those functions/macros that have a manual page.

Fix prologue. Drop size of last column as it doesn't exist in all cases
and implicit last column handling will do TRT.

Back and forth: gcc(1) -> GCC.

GCC -> gcc(1).

Serial comma.

Add tgmath(3). From FreeBSD.

XXX: Needs proofreading, Matt?

timeradd.3: declare timespeccmp parameters as const

Comparison is implemented as a read-only operation.

Fix timespeccmp declaration.

From Kouichi Hashikawa in PR 56010.

Add a missing word.

Slight wording improvement.

Macros, not functions.

Fix .Nd.

Describe also the timespec() family of macros in timeradd(3).

Reference timeval(3).

Add the missing $Id$ tag.

Add timeradd(3) from FreeBSD. Needs proofreading.

ok wiz@

Move some of the discussion from the messy ctime(3) to tm(3).

Xref bintime_add(9).

Note clock_gettime(2) in the example.

microtime(9) stores struct timeval. bintime(9) stores struct bintime.

Fix a typo.

Add an introductory example.

Note that struct bintime is described in timecounter(9). Improve wording.

Due previous, remove STANDARDS.

Briefly describe and note also struct bintime.

Remove trailing comma.

Fix .Dt.

Add a manual page that describes the basic structures in <sys/time.h>.

tm(3): Fix type of tm_zone again, and describe it as const.

It is `char *', not `char'. But it's also not supposed to be written
to, as kre@ noted, so just document it as `const' even though it's
technically not declared that way, presumably for expedience of
managing it with malloc/free internally.

PR lib/58651: tm(3): wrong type in man page for tm_gmtoff

tm(3): Fix types in man page.

PR lib/58651: tm(3): wrong type in man page for tm_gmtoff

branches: 1.5.2; 1.5.4;
correct tm_sec range to be [0-60]

The previous range introduced in time.h rev1.14 was supposed to account
for a mystical "double leap second", which ultimately never could exist
and was a mistaken interpretation from an early ISO C standard whereby
the possibility of two leap seconds within a year was erroneously
interpreted to mean that two leap seconds could occur at once.

branches: 1.4.46;
Improve as per discussion on source-changes.

Put asctime(3) explicitly to SEE ALSO.

Move some of the discussion from the messy ctime(3) to tm(3).

Add a small summary parge for struct tm from <time.h>. Cf. timeval(3).

Remove empty line.

Add rbtree(3) to SEE ALSO

branches: 1.12.6;
Remove workaround for ancient HTML generation code.

branches: 1.11.20;
fix merge conflicts

Fix date and conflict; use Dv for NULL.

sync with OpenBSD.

Minor typo

branches: 1.7.6; 1.7.12;
Fix xref: rb(3) -> rbtree(3).

Add a note that rb(3) is preferred for new code.

Document that the element argument of RB_REMOVE must be present in the
tree. Minor adjoining grammar fix. PR 39684.
Bump date.

branches: 1.4.2; 1.4.4;
Add a NOTE saying that invalid usage leads to undefined behaviour.
Inspired by PR 39684.

Rather than using RB_EMPTY() for checking if a splay tree is empty,
suggest using it for checking if a red-black tree is empty.

Nd argument needs no quotes; use .In instead of .Fd ...; mark up
NULL as Dv instead of Va (it's not really variable, is it? :) ).
Replace & with \*[Am].

tree(3) manpage from OpenBSD.

Document the __alignof__ GNU extension.

There is no harm to add a manual page for the GNU typeof()-construct, given
that it has already crawled into the source tree.

Pp before Bl

Xref unistd(3).

Xref param(3).

A small correction. Typos.

Get rid of some unnecessary whitespace.
Add backslash before a dash to get a minus.

One small correction: .Ss instead of .Sh.

Rewrite types(5) as per perry@'s suggestion from few years back ("XXX this
document is rather musty. It needs a general update."). Also move it to the
right section from section 5. Ok wiz@.

To minimize maintenance costs, the content is mostly jargon around The
Standard. Only few NetBSD-specific types are mentioned as an example.

branches: 1.2.2; 1.2.6;
libc: New functions c8rtomb(3) and mbrtoc8(3).

New in C23, for converting from UTF-8 to locale-dependent multibyte
sequences (c8rtomb) or vice versa (mbrtoc8), along with the new type
char8_t.

Conditional on either:
- _NETBSD_SOURCE
- _ISOC23_SOURCE
- __STDC_VERSION__ >= 202311L

(Riding the libc minor bump from this morning for the UTF-16/UTF-32
versions from C11.)

PR standards/58601: uchar.h C23 compliance: char8_t, mbrtoc8, c8rtomb

libc: New C11 functions mbrtoc16, mbrtoc32, c16rtomb, c32rtomb.

The mbrtoc16/32 functions read mulitbyte strings according to the
current locale into UTF-16/32 code unit sequences; the c16/32rtomb
functions write UTF-16/32 code unit sequences into multibyte strings
according to the current locale. The `r' means restartable: they
work incrementally and pick up where they left off.

NOTE: This bumps the libc minor version, since it adds new symbols.

PR lib/52374: <uchar.h> missing

Xref limits(3).

Small rewording.

Fix some xrefs.

Add a small summary page for <unistd.h>.

Retire varargs.h support. Move machine/stdarg.h logic into MI
sys/stdarg.h and expect compiler to provide proper builtins, defaulting
to the GCC interface. lint still has a special fallback.
Reduce abuse of _BSD_VA_LIST_ by defining __va_list by default and
derive va_list as required by standards.

Sort sections.

Use .In instead of .Aq Pa for header files.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Use .In instead of .Fd.

preceeding->preceding, from Igor Sobrado PR misc/19814

Drop some trailing whitespace.

KNF example code snippet.

Add a separate varargs(3) manual page, reusing stdarg(3) contents, and
remove the name `varargs' from stdarg(3); inspired by conversation with
Charles Hannum.