bsd.own.mk: rename GCC_NO_* to CC_WNO_*

Rename compiler-warning-disable variables from
GCC_NO_warning
to
CC_WNO_warning
where warning is the full warning name as used by the compiler.

GCC_NO_IMPLICIT_FALLTHRU is CC_WNO_IMPLICIT_FALLTHROUGH

Using the convention CC_compilerflag, where compilerflag
is based on the full compiler flag name.

lint: warn about extern declarations outside headers

https://mail-index.netbsd.org/tech-userlevel/2023/03/15/msg013727.html

introduce some common variables for use in GCC warning disables:

GCC_NO_FORMAT_TRUNCATION -Wno-format-truncation (GCC 7/8)
GCC_NO_STRINGOP_TRUNCATION -Wno-stringop-truncation (GCC 8)
GCC_NO_STRINGOP_OVERFLOW -Wno-stringop-overflow (GCC 8)
GCC_NO_CAST_FUNCTION_TYPE -Wno-cast-function-type (GCC 8)

use these to turn off warnings for most GCC-8 complaints. many
of these are false positives, most of the real bugs are already
commited, or are yet to come.


we plan to introduce versions of (some?) of these that use the
"-Wno-error=" form, which still displays the warnings but does
not make it an error, and all of the above will be re-considered
as either being "fix me" (warning still displayed) or "warning
is wrong."

-Wstringop-truncation is only gcc.

Ignore strncpy(foo, bar, sizeof(foo)) for the wtmp fields where we don't
want NUL termination. We can't use pragma's because the old gcc complains
about the new warnings it does not understand.

branches: 1.82.2;

Document opendisk1() - it has been around long enough.
(pity about the name...)

XXX pullup-8

branches: 1.81.10;
Add man page links for:
EV_SET to kqueue(2)
getmntoptstr, getmntoptnum, freemntopts to getmntopts(3)

Reviewed by wiz@

branches: 1.80.2;
Make this portable to other OSs

branches: 1.79.2;
Implement pidfile_lock, pidfile_read and pidfile_clean.

Discussed on tech-net@, ok core@.

Add kinfo_getvmmap from FreeBSD

Add ereallocarr(3) to libutil

ereallocarr(3) wraps reallocarr(3) and embeds return status validation.

Older version reviewed by <riastradh> and <christos>

add estro{i,u} (Kamil Rytarowski)

document login_getpwclass(3)

Add getbyteorder() call.

branches: 1.73.2;
- add getdiskrawname.
- exit on error for lint.

add getfsspecname

These directories default to WARNS?=5

- add strspct
- be explicit about string not being NUL terminated if bufsiz == 0

add manual page

branches: 1.68.2;
Add proc_compare

Don't use = to assing SRCS, but += so that we can remove snprintb.c,
which was added elsewhere.

Add getlabelusesmbr(), as proposed in
http://mail-index.netbsd.org/tech-userlevel/2011/08/25/msg005404.html
This is used by disk tools such as disklabel(8) to dynamically decide is
the undelyling platform uses a disklabel-in-mbr-partition or not
(instead of using a compile-time list of ports).
getlabelusesmbr() reads the sysctl kern.labelusesmbr, takes its value from the
machdep #define LABELUSESMBR.
For evbmips, make LABELUSESMBR 1 if the platform uses pmon
as bootloader, and 0 (the previous value) otherwise.

Build libutil(3) as a link to util(3).

add strpct, requested by joerg

retire pw_policy(3) -- it is not found useful, there are other
(more common) ways to enforce a password strength policy
approved by elad

add a link to pw_copyx; from anon ymous

Implement snprintb_m(3) to provide multi-line bit/bit-field decode.
Discussed on tech-kern.

branches: 1.60.2;
WARNS=4

merge christos-time_t

branches: 1.58.2;
document pw_getpwconf.

move snprintb to common

Add raise_default_signal(3) -- raise the default signal handler.
Can be used by applications that have their own SIGINT (et al)
handlers and want to exit in a manner that correctly
signals to the parent that the process was terminated by a signal.
See http://www.cons.org/cracauer/sigint.html for more info.
Discussed on tech-userlevel@.

branches: 1.55.4;
add estrndup()

moved string_to_flags and flags_to_string from ls to libutil.

rename getdate to parsedate to avoid conflict with posix function

add getdate.

include ecalloc() from our anonymous user.

Add efun(3)

Add pw_policy.3.
From Hisashi T Fujinaka, thanks!

Introduce pw_policy(3), an easily extendable way of defining password
policies and enforcing them in programs.

Man-page written with much help and tips from David Maxwell, Hubert
Feyrer, and Thomas Klausner.

This bumps libutil minor to 7.

XXX: Need default policy to go in /etc/passwd.conf, and integration
into local/yp/PAM password changing code.

PR/10206.

WARNS=3; fix cast-qual issues.

Add a manual page.

Add sockaddr_snprintf; XXX: Needs a man page.

Add if_media.c, functions for converting media to/from strings.
(from ifconfig.c)

branches: 1.43.4;
move getmntopts(3) to libutil, build and install also it's manpage
bump libutil minor
adjust individual mount_*/Makefile to use libutil getmntopts(3)

Add getlabelsector() and getlabeloffset() as wrappers around the
KERN_LABELSECTOR and KERN_LABELOFFSET sysctls.

- Migrate fparseln(3) from libutil to libc, where it should have been in
the first place...
- Bump libutil major (to 7.0) and libc minor (to 12.91).

Added two functions disklabel_dkcksum() and disklabel_scan() to libutil
so that they can be shared by disklabel(8) and cgdconfig(8).

put utmpx/wtmpx routines to separate files, so that programs overriding the
utmp/wtmp routines could still be linked static
fixes e.g. static build of ftpd

Add documentation for utmpx and some related functions.
Thanks for some explanations to christos, and for some STANDARDS hints
to Klaus Klein.

Add snprintb(3) inspired from bitmask_snprintf(9), but made to look like
more like snprintf(3). Discussed with thorpej.

Move humanize_number(3) from libutil to libc as per discussion on tech-misc
Revert minor number bump on libutil (with note to skip it next update), and
bump libc.

Explicitly move setting of NOxxx and USE_SHLIBDIR to the top of the
Makefile (before including <bsd.own.mk>)

Use ${NETBSDSRCDIR}/some/path instead of ${.CURDIR}/../../some/path (etc).
(Reduces make output by ~ 20%)

Add humanize_number.3 from Tomas Svensson in PR lib/15508.
Bump version of libutil

branches: 1.32.2;
* Add user-controlled mk.conf variables
- SHLIBDIR Location to install shared libraries if ${USE_SHLIBDIR}
is "yes". Defaults to "/usr/lib".

- USE_SHLIBDIR If "yes", install shared libraries in ${SHLIBDIR}
instead of ${LIBDIR}. Defaults to "no".
Sets ${_LIBSODIR} to the appropriate value.
This may be set by individual Makefiles as well.

- SHLINKDIR Location of shared linker. Defaults to "/usr/libexec".
If != "/usr/libexec", change the dynamic-linker
encoded in shared programs

* Set USE_SHLIBDIR for libraries used by /bin and /sbin:
libc libcrypt libcrypto libedit libipsec libkvm libm libmi387
libtermcap libutil libz

* If ${_LIBSODIR} != ${LIBDIR}, add symlinks from ${LIBDIR}/${LIB}.so*
to ${_LIBSODIR}/${LIB}.so* for compatibility.

* Always install /sbin/init statically (for now)


The net effect of these changes depends on how the variables are set:

1.) If nothing is set or changed, there is no change from the
current behaviour:
- Static /bin, /sbin, and bits of /usr/*
- Dynamic rest
- Shared linker is /usr/libexec/ld*so

2.) If the following make variables are set:
LDSTATIC=
SHLINKDIR=/lib
SHLIBDIR=/lib
Then the behaviour becomes:
- Dynamic tools
- .so libraries used by /bin and /sbin are installed to /lib,
with symlinks from /usr/lib/lib*so to -> /lib/lib*so
where appropriate
- Shared linker is /lib/ld*so

3.) As per 2.), but add the following variable:
USE_SHLIBDIR=yes
This forces all .so's to be instaleld in /lib (with compat
symlinks), not just those tagged by their Makefiles to be.
Again, compat symlinks are installed

Add a catch-all man page for libutil.

Rename secure_path(3) source file from securepath.c to secure_path.c.

Add getbootfile(3) to libutil, and a man page.
Bump libutil version to 5.5.

Add two new passwd file update functions:
- The pw_setprefix() function defines the root directory used for passwd
file updates. If the prefix is set to /newroot pw_lock() will operate on
/newroot/etc/ptmp afterwards. The default prefix is an empty string.
- The pw_getprefix() function returns the root directory which is currently
used for passwd file updates.

rename securepath.3 into secure_path.3, as the function is named secure_path().
it is too hard to guess...

Documentation for pw_getconf(). From OpenBSD.

branches: 1.25.4;
Correct typos which prevent man pages from being installed.
Fixes PR/10104 by Greg Woods.

Add necessary support routines for login.conf.

More trailing white space.

Add pidfile(3), which write a pid file in /var/run, and arranges for it
to be removed on normal exit.

Move the bswap functions from libutil to libc (this bups the
minor of libc and the major of libutil). For little-endian architectures
merge the bnswap() assembly versions with nto* and hton* using symbols
aliasing. Use symbol renaming for the bswap function in this case to avoid
namespace pollution.
Declare bswap* in machine/bswap.h, not machine/endian.h. For little-endian
machines, common code for inline macros go in machine/byte_swap.h
Sync libkern with libc.
Adjust #include in kernel sources for machine/bswap.h.

Kill __LIBUTIL_BUILD in favor of the newly added _LIBC indicator completely;
suggested by Jason Thorpe.

Put pw_scan() back into libutil and pretent that libutil.so.5.0 never
existed.

Add bswap{16,32,64} functions to libutil. Because of this, bump minor.

PR/4475: Jason R. Thorpe: there is no common function to parse a continued
line.

use CPPFLAGS instead of CFLAGS, remove -Wall et al (WARNS=1 already does this)

branches: 1.15.2;
Add pidlock, ttylock, ttyunlock functions.

- define WARNS?=1 in the top-level Makefile.inc, and don't define
anywhere else.
- for now, override WARNS=0 in librpcsvc and libwrap, until they're
cleaned up
- rcsid police

lib is now clean (except for librpcsvc and libwrap) on the i386, and
this should motivate the other ports to fix any other minor problems
that their compilers pick up that the i386 version doesn't.

WARNSify

implement opendisk(3), as discussed with Jason Thorpe

Add ttymsg.3 to the man pages.

- RCSID police
- Add ttymsg.3

Add ttyaction.3 and ttyaction.c

Add two functions to libutil:

- getmaxpartitions: get the value of MAXPARTITIONS for the
currently running system

- getrawpartition: get the value of RAW_PART for the
currently running system

These functions are necessary since the value of MAXPARTITIONS might
be different across platforms which are binary compatible (e.g. amiga
and sun3).

Minor reorganization of libutil, including the addition of passward
locking and editing functions.
From Greg Hudson <ghudson@MIT.EDU>

minor cleanup; kill unnecessary casts

get rid of stuff that doesn't belong here

Add getbsize() from Berkeley, somewhat modified.

Add RCS identifiers.

Don't need -I/sys any more.

branches: 1.1.1;
Initial revision

branches: 1.1.2;
file Version.map was initially added on branch agc-symver.

Move the bswap functions from libutil to libc (this bups the
minor of libc and the major of libutil). For little-endian architectures
merge the bnswap() assembly versions with nto* and hton* using symbols
aliasing. Use symbol renaming for the bswap function in this case to avoid
namespace pollution.
Declare bswap* in machine/bswap.h, not machine/endian.h. For little-endian
machines, common code for inline macros go in machine/byte_swap.h
Sync libkern with libc.
Adjust #include in kernel sources for machine/bswap.h.

Fix function return value and arguments in SYNOPSIS.

Add bswap{16,32,64} functions to libutil. Because of this, bump minor.

Move the bswap functions from libutil to libc (this bups the
minor of libc and the major of libutil). For little-endian architectures
merge the bnswap() assembly versions with nto* and hton* using symbols
aliasing. Use symbol renaming for the bswap function in this case to avoid
namespace pollution.
Declare bswap* in machine/bswap.h, not machine/endian.h. For little-endian
machines, common code for inline macros go in machine/byte_swap.h
Sync libkern with libc.
Adjust #include in kernel sources for machine/bswap.h.

Delint

Add bswap{16,32,64} functions to libutil. Because of this, bump minor.

Clean up deleted files.

Return a well-known constant after becoming a daemon.

Add RCS identifiers.

branches: 1.1.1;
Initial revision

Use .Fn instead of .Nm.

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

branches: 1.6.18;
Fix capso in Dd argument.

u_short -> uint16_t

branches: 1.4.2; 1.4.8;
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.

The next release will be 2.0, not 1.7.

Spell out month name in .Dd. Use .Fn instead of .Fo/.Fc and .Fa's.

Added two functions disklabel_dkcksum() and disklabel_scan() to libutil
so that they can be shared by disklabel(8) and cgdconfig(8).

u_short -> uint16_t

branches: 1.3.6;
delint pointer casts.

branches: 1.2.2;
Move UCB-licensed code from 4-clause to 3-clause licence.

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

Added two functions disklabel_dkcksum() and disklabel_scan() to libutil
so that they can be shared by disklabel(8) and cgdconfig(8).

Use .Fn instead of .Nm.

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

branches: 1.4.2; 1.4.32;
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.

The next release will be 2.0, not 1.7.

Spell out month name in .Dd. Use .Fn instead of .Fo/.Fc and .Fa's.

Added two functions disklabel_dkcksum() and disklabel_scan() to libutil
so that they can be shared by disklabel(8) and cgdconfig(8).

fix -Wsign-compare issues

branches: 1.2.8;
Remove clause 3 and 4 from TNF licenses

branches: 1.1.2; 1.1.32;
Added two functions disklabel_dkcksum() and disklabel_scan() to libutil
so that they can be shared by disklabel(8) and cgdconfig(8).

Bump date for recent changes

Sync parameter name with efun.c

This change is non-functional.

Add ereallocarr(3) to libutil

ereallocarr(3) wraps reallocarr(3) and embeds return status validation.

Older version reviewed by <riastradh> and <christos>

add estro{i,u} (Kamil Rytarowski)

.Nm -> .Fn, and one .Pp.

Sort SEE ALSO.

branches: 1.8.8; 1.8.10;
Convert TNF licenses to new 2 clause variant

branches: 1.7.2;
Add the missing 'n' to 'correspoding'.

branches: 1.6.4;
The e* functions don't call the error handler in every case, just in
case of an error.

Mentioned the error conditions for the various functions.

branches: 1.5.4;
add estrndup()

typo from our anonymous user.

add util.h to SYNOPSIS

Slight wording improvement, sort SEE ALSO, remove trailing dot in SEE ALSO.

Efun source.

annotate __dead

provide a default error function instead of trying to cast exit(3).

branches: 1.10.16;
Add ereallocarr(3) to libutil

ereallocarr(3) wraps reallocarr(3) and embeds return status validation.

Older version reviewed by <riastradh> and <christos>

add estro{i,u} (Kamil Rytarowski)

Fix failure message for ecalloc.

If malloc, calloc, or realloc returns NULL when a size of 0 was
requested, which is allowed by pertinent standards, honor it instead
of bombing.

Do not do this for calloc(x, y) where x != 0 && y != 0 but x*y == 0;
in that case bomb.

branches: 1.6.4; 1.6.8; 1.6.28;
Remove clause 3 and 4 from TNF licenses

branches: 1.5.10;
add estrndup()

Coverity CID 4159: Don't memset() needlessly.

make this compilable as a tool.

Only use __RCSID if we have it.

Efun source.

- Migrate fparseln(3) from libutil to libc, where it should have been in
the first place...
- Bump libutil major (to 7.0) and libc minor (to 12.91).

dynamically with two l.

New sentence, new line. From Robert Elz.

Generate <>& symbolically.

precede, not preceed.

More trailing white space.

Dv vs. Va police.

add LIBRARY section to man page

* add extra arg to fparseln() - int flags - which is a bitmask.
current flags allow the `un-escaping' of escaped arguments (i.e,
don't prefix an escaped argument with the escape char)
* other minor cleanups

fix .Nx usage (use 1.0 instead of 0.9a, etc), and other minor cleanups

better describe delim[], use ".Nx 1.3a" instead of "1.3A", other minor stuff

PR/4475: Jason R. Thorpe: there is no common function to parse a continued
line.

- Migrate fparseln(3) from libutil to libc, where it should have been in
the first place...
- Bump libutil major (to 7.0) and libc minor (to 12.91).

Add hooks for reachover builds from src/tools/compat.

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

back out the #ifdef _DIAGNOSTIC argument checks; too many people complained.
_DIAGASSERT() is still retained.

* use _DIAGASSERT() to check pointer arguments against NULL and file
descriptors against -1 (as appropriate).
* add actual checks which to detect stuff that would trigger_DIAGASSERT(),
and attempt to return a sane error condition.
* knf some code
* remove some `register' decls.

the first two items result in the addition of code similar to the
following in various functions:

_DIAGASSERT(path != NULL)
#ifdef _DIAGNOSTIC
if (path == NULL) {
errno = EFAULT;
return (-1);
}
#endif

More trailing white space.

Delint

* add extra arg to fparseln() - int flags - which is a bitmask.
current flags allow the `un-escaping' of escaped arguments (i.e,
don't prefix an escaped argument with the escape char)
* other minor cleanups

* return on empty lines (with len = 0, and a pointer to an empty string),
rather than parsing until non-blank lines. some callers may want to
know when a blank line occurs. fix confirmed with christos.
* enhance test code (which is commented out by default) to use len and
lineno parameters

Fix typo; update `buf' by return value from realloc(3).

tyop

PR/4475: Jason R. Thorpe: there is no common function to parse a continued
line.

Use .Fn instead of .Nm.

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

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

branches: 1.6.30;
Aq Pa instead of Pa Aq.

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.

New sentence, new line. From Robert Elz.

Generate <>& symbolically.

Add a note this appeared in NetBSD 1.6. Pointed out on current-users@
by Geoff Wing.

Add getbootfile(3) to libutil, and a man page.
Bump libutil version to 5.5.

prefer <sys/cpu.h> instead of <machine/cpu.h>

branches: 1.5.8;
Remove clause 3 and 4 from TNF licenses

branches: 1.4.30;
The last argument to sysctl is a size_t, not a pointer; don't pass NULL.

strcmp needs string.h.

Don't bother calling secure_path() is kernel == _PATH_UNIX. If you are going
to default to it and use it anyway, why do the security check?

Add getbootfile(3) to libutil, and a man page.
Bump libutil version to 5.5.

Clean up deleted files.

kill force.

kill the 'prog' arg to getbsize(); it's unneeded. minor rev bump.

Add getbsize() from Berkeley, somewhat modified.

branches: 1.4.4;
Merge riastradh-drm2 to HEAD.

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

branches: 1.2.2; 1.2.4;
Use more markup.

Add getbyteorder() call.

branches: 1.1.2; 1.1.8;
Add getbyteorder() call.

rename getdate to parsedate to avoid conflict with posix function

add getdate.

rename getdate to parsedate to avoid conflict with posix function

constify

add getdate.

s/ the the / the /

branches: 1.3.12;
Add getdiskcookedname to the NAME section
Fix couple of typos.

branches: 1.2.2; 1.2.16; 1.2.20;
End sentence with dot.

- add getdiskrawname.
- exit on error for lint.

Teach getdiskrawname and getdiskcookedname about zvols.

Reviewed by Christos

branches: 1.5.16; 1.5.18;
KNF, sign cast.

use the passed parameter instead of PATH_MAX. Change signedness
of nlen.

- use a private buffer to resolve symlinks, the previous code was broken
- factored out symlink handling
- handle relative symlinks now
- handle device paths that do not contain a '/'.

branches: 1.2.4;
Resolve symlinks and cook the targets instead of the symlink names.

branches: 1.1.2; 1.1.4;
- add getdiskrawname.
- exit on error for lint.

Document "ROOT." syntax before documenting a generic .

If fs_spec starts with the special string "ROOT.", replace it with a device
path derived from the value of the kern.root_device sysctl.

branches: 1.5.14; 1.5.16;
grammar patrol

fix param name

branches: 1.3.2;
fix typo

Remove trailing whitespace, add dot.

add getfsspecname

No need to quadruple a buffer because strunvis(3) doesn't expand.

use the right type.

If fs_spec starts with the special string "ROOT.", replace it with a device
path derived from the value of the kern.root_device sysctl.

branches: 1.5.22; 1.5.24;
In COMPAT_DKWEDGE, attempt to open the label as specified in the NAME= entry.
This works for BSD disklabels, providing full compatibility. Merge some
duplicated code. This means that at least for BSD labels, we can handle
both pre and post- autodiscover kernels with the same fstab.

branches: 1.4.6;
Don't rely on something including sys/ioctl.h for us.

branches: 1.3.2; 1.3.4;
Fix compat code, so if we failed to make raw, return the regular path.

Add and enable COMPAT_DKWEDGE which let's us autoconfigure wedges and boot
with a non-wedge aware fstab.

add getfsspecname

s/partitition/partition/.

branches: 1.3.4; 1.3.44; 1.3.52; 1.3.54;
remove clauses 3 and 4

Remove trailing dot; slightly improve wording.

add manual page

Kill empty Dv macro.

Fix typo.

Add getlabelusesmbr(), as proposed in
http://mail-index.netbsd.org/tech-userlevel/2011/08/25/msg005404.html
This is used by disk tools such as disklabel(8) to dynamically decide is
the undelyling platform uses a disklabel-in-mbr-partition or not
(instead of using a compile-time list of ports).
getlabelusesmbr() reads the sysctl kern.labelusesmbr, takes its value from the
machdep #define LABELUSESMBR.
For evbmips, make LABELUSESMBR 1 if the platform uses pmon
as bootloader, and 0 (the previous value) otherwise.

correct spelling error.

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.

The next release will be 2.0, not 1.7.

Misc fixes.

Add getlabelsector() and getlabeloffset() as wrappers around the
KERN_LABELSECTOR and KERN_LABELOFFSET sysctls.

getlabelusesmbr: initialize 'oldlenp' parameter to sysctlbyname

Add getlabelusesmbr(), as proposed in
http://mail-index.netbsd.org/tech-userlevel/2011/08/25/msg005404.html
This is used by disk tools such as disklabel(8) to dynamically decide is
the undelyling platform uses a disklabel-in-mbr-partition or not
(instead of using a compile-time list of ports).
getlabelusesmbr() reads the sysctl kern.labelusesmbr, takes its value from the
machdep #define LABELUSESMBR.
For evbmips, make LABELUSESMBR 1 if the platform uses pmon
as bootloader, and 0 (the previous value) otherwise.

Lint warnings.

Bump daddr_t to 64 bits. Replace it with int32_t in all places where
it was used on-disk, so that on-disk formats remain the same.
Remove ufs_daddr_t and ufs_lbn_t for the time being.

Add getlabelsector() and getlabeloffset() as wrappers around the
KERN_LABELSECTOR and KERN_LABELOFFSET sysctls.

Clean up deleted files.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Clean up deleted files.

Add RCS identifiers.

branches: 1.1.1;
Initial revision

Use .Fn instead of .Nm.

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

branches: 1.8.18;
mention error return value, like getrawpartition(3)

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.

Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

first pass at fixing up capitalization of function names and
arguments; ensure that each is correct with respect to the
implementation, rather than being correct as per english.

add LIBRARY section to man page

Fix files using old TNF copyright notice

Add two functions to libutil:

- getmaxpartitions: get the value of MAXPARTITIONS for the
currently running system

- getrawpartition: get the value of RAW_PART for the
currently running system

These functions are necessary since the value of MAXPARTITIONS might
be different across platforms which are binary compatible (e.g. amiga
and sun3).

branches: 1.6.8;
Remove clause 3 and 4 from TNF licenses

branches: 1.5.18;
Lint warnings.

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

Fix files using old TNF copyright notice

- RCSID police
- Add ttymsg.3

Add two functions to libutil:

- getmaxpartitions: get the value of MAXPARTITIONS for the
currently running system

- getrawpartition: get the value of RAW_PART for the
currently running system

These functions are necessary since the value of MAXPARTITIONS might
be different across platforms which are binary compatible (e.g. amiga
and sun3).

Sections 2 and 3 have RETURN VALUES, not DIAGNOSTICS

Remove workaround for ancient HTML generation code.

Add getmntoptstr, getmntoptnum, and freemntopts to the NAME section
Fix couple of sentences

getmntoptstr, getmntoptnum, and freemntopts need to be linked to the getmntopts(3)
man page as well. Will do in a later commit after doing a relase build test.

branches: 1.12.28; 1.12.32;
PR/43795: Guy Harris: describe return values and error handling.

Rework the example a little.

Fix markup.

Sort sections.

branches: 1.8.18;
* clarify error behaviour for getmntopts()
* invert getmnt_silent description (a.k.a. "fix it")

occured -> occurred. From Peter Postma.

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

Patches provided by Joel Baker in PR 22280, 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.

Mostly mdoc improvements, some typos.

add functions to retrieve option values.

Try to get some consistency in the used macros; other minor fixes.

move getmntopts(3) to libutil, build and install also it's manpage
bump libutil minor
adjust individual mount_*/Makefile to use libutil getmntopts(3)

Emulate behaviour described in man page and return NULL if an error occurs.

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

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

add functions to retrieve option values.

move getmntopts(3) to libutil, build and install also it's manpage
bump libutil minor
adjust individual mount_*/Makefile to use libutil getmntopts(3)

getrawpartition(3): reword to clarify return value, use .Pq

"'a' == 0" is, stricly speaking false, and since 'a' is an int, it's
not immediately clear if it's 'a' or 0 that is returned. Try to
clarify this.

Use .Fn instead of .Nm.

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

branches: 1.9.18;
\- is a minus.

Document that this can fail.

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.

Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

first pass at fixing up capitalization of function names and
arguments; ensure that each is correct with respect to the
implementation, rather than being correct as per english.

add LIBRARY section to man page

Fix files using old TNF copyright notice

Add two functions to libutil:

- getmaxpartitions: get the value of MAXPARTITIONS for the
currently running system

- getrawpartition: get the value of RAW_PART for the
currently running system

These functions are necessary since the value of MAXPARTITIONS might
be different across platforms which are binary compatible (e.g. amiga
and sun3).

Update old-style definitions to ANSI, remove a couple of register
definitions along the way. Fixed gcc 4.1 build (thank you vax)

branches: 1.6.4; 1.6.8;
Remove clause 3 and 4 from TNF licenses

branches: 1.5.18;
Lint warnings.

More trailing white space.

Fix files using old TNF copyright notice

- RCSID police
- Add ttymsg.3

Add two functions to libutil:

- getmaxpartitions: get the value of MAXPARTITIONS for the
currently running system

- getrawpartition: get the value of RAW_PART for the
currently running system

These functions are necessary since the value of MAXPARTITIONS might
be different across platforms which are binary compatible (e.g. amiga
and sun3).

Move humanize_number(3) from libutil to libc as per discussion on tech-misc
Revert minor number bump on libutil (with note to skip it next update), and
bump libc.

Minor cleanup, correct HISTORY.

Add humanize_number.3 from Tomas Svensson in PR lib/15508.
Bump version of libutil

Move humanize_number(3) from libutil to libc as per discussion on tech-misc
Revert minor number bump on libutil (with note to skip it next update), and
bump libc.

Cosmetic changes.

Do not assume int64_t is printable with %qd - on 64 bit ports it isn't.
Use %lld instead and cast the args to (long long) explicitly.

I'm not sure about our policy vs. the C99 format string macros in
basesrc - should we use those here?

Add humanize_number.3 from Tomas Svensson in PR lib/15508.
Bump version of libutil

branches: 1.2.8;
Remove clause 3 and 4 from TNF licenses

branches: 1.1.4; 1.1.26;
Add if_media.c, functions for converting media to/from strings.
(from ifconfig.c)

Add kinfo_getvmmap from FreeBSD

Stop including <sys/user.h> in userland libraries

This header in this context is freebsdism.

need uvm_param.h now.

Hello lint.

Add kinfo_getvmmap from FreeBSD

Clean up deleted files.

get rid of the awful RSS hack

P[GD]_SHIFT --> P[GD]SHIFT

look for m68k, rather than hp300 or amiga

Forgot to initialize `cp' in setsyserr().

Remove code for old VM system. Don't use page tables in kvm_procread().
Change `#if DEBUG' to `#ifdef DEBUG'. Read some symbols from the kernel
only once.

Last change was almost correct, but we have to check that the pager actually
has the page. If not, we go up the shadow chain.

Fix an off-by-one error when scanning the vm map for a page. Also, if the
page is not in core, don't recurse into shadow objects if we've already found
a pager.

Fix a bug in virtual to physical address translation on hp300s, and add support
for Amigas.

line 860: use CLSHIFT rather than PGSHIFT.
line 927: fix bogus indentation
also make sure first chars of buffers are null char, just in
case nothing rational is read...

implement kvm_procread for the hp300. now things mostly work on
the hp300, in terms of kvm. still minor strangeness re: sendmail...

#include <machine/pte.h>, not <hp300/hp300/pte.h>. Also, make it at least
compile for non-i386 architectures, but exit with an error message (for now).

Add RCS identifiers.

branches: 1.11.2;
Read swap in CLBYTES blocks.

kernel string read function takes much less time. could be optimized further,
by making block reads kernel page aligned. (cgd will make the next optimization
in this file)

misc minor changes

update kvm.c for the new way of doing things:
(1) add support for new stack format/PS_STRINGS
(2) add support for kvm_getenv
the HP300 support in kvm_procread needs to be looked at/filled in,
from example code in kvm_getu, plus hacks

don't inlude select.h, but keep header cleanups

fix new select stuff

fix problem where kvm_getprocs(), ..., kvm_freeprocs(), kvm_getprocs()
would get no processes.

Fix memory leak.

From: pk@cs.few.eur.nl (Paul Kranenburg)

patch which allows ps(1) and w(1) to lay
their hands on process command line arguments.

after 0.2.2 "stable" patches applied

branches: 1.1.1;
Initial revision

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

Patches provided by Joel Baker in PR 22280, 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.

add LIBRARY section to man page

RCS Id Police.

Minor reorganization of libutil, including the addition of passward
locking and editing functions.
From Greg Hudson <ghudson@MIT.EDU>

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

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

put utmpx/wtmpx routines to separate files, so that programs overriding the
utmp/wtmp routines could still be linked static
fixes e.g. static build of ftpd

add utmpx/wtmpx processing routines.

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

back out the #ifdef _DIAGNOSTIC argument checks; too many people complained.
_DIAGASSERT() is still retained.

* use _DIAGASSERT() to check pointer arguments against NULL and file
descriptors against -1 (as appropriate).
* add actual checks which to detect stuff that would trigger_DIAGASSERT(),
and attempt to return a sane error condition.
* knf some code
* remove some `register' decls.

the first two items result in the addition of code similar to the
following in various functions:

_DIAGASSERT(path != NULL)
#ifdef _DIAGNOSTIC
if (path == NULL) {
errno = EFAULT;
return (-1);
}
#endif

const poisoning.

unregisterify

Lseek(2) usage cleanup: the use of L_SET/L_INCR/L_XTND is deprecated,
use SEEK_SET/SEEK_CUR/SEEK_END instead.

- RCSID police
- Add ttymsg.3

Minor reorganization of libutil, including the addition of passward
locking and editing functions.
From Greg Hudson <ghudson@MIT.EDU>

Prototypes (PR#1100).

minor cleanup; kill unnecessary casts

off_t

Add RCS identifiers.

branches: 1.1.1;
Initial revision

login_cap(3): Markup fixes

unsigned -> unsigned int

Update synopses to match u_int/u_long/etc. changes. Do not bump date as
it's not a substantive change.

Put code example on its own line, using Dl.
Ok christos

Punctuation nit.
(Shouldn't the whole line be .Dl or .Bl -literal instead?)

document login_getpwclass(3)

branches: 1.18.6; 1.18.12;
Mark up NULL with Dv.

Bump date for previous.

split LOGIN_SETGROUP -> LOGIN_SETGID|LOGIN_SETGROUPS

branches: 1.15.16;
Mmm, API changes without date bumps... bump date for constification.

Constify; the api was completely broken before.

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.

New sentence, new line. From Robert Elz.

import CAVEATS sections from OpenBSD.
with little tweak by me.

Generate <>& symbolically.

Fix typo

Fix date, whitespace and punctuation.

fix up various .Nm abuses:
- keep the case consistent between the actual name and what's referenced.
e.g, if it's `foo', don't use '.Nm Foo' at the start of a sentence.
- remove unnecessary `.Nm foo' after the first occurrence (except for
using `.Nm ""' if there's stuff following, or for the 2nd and so on
occurrences in a SYNOPSIS
- use Sx, Ic, Li, Em, Sq, and Xr as appropriate

login_cap.h requires sys/types.h (or should it pull sys/types.h in?)

Use .{B,Bs,F,N,O}x and fix miscellaneous errors.

branches: 1.4.4;
Added details about origin of code (BSD/OS) in history section.
Closes PR/9410 by Peter Seebach.

Mention the LOGIN_SETENV flag for setusercontext()

Add a history section.

Add necessary support routines for login.conf.

Correct typos in comments

Pointed out by Edgar Fuss and J. Lewis Muir.

Clean-up resources (sys/sys/resource.h) usage

Add vmemoryuse to login_cap(3)
Document vmemoryuse in login.conf(5)
Document proc.pid.rlimit.vmemoryuse and proc.pid.rlimit.maxlwp in sysctl(7)
Document SBSIZE, AS, VMEM and NTHR in share/doc/psd/05.sysman/1.6.t

Reviewed by <riastradh>
Approved by <pgoyette>

Tested by Dominik Bialy

Closes PR xsrc/49912

branches: 1.31.6;
add "maxthread" tunable to login.conf to adjust RLIMIT_NTHR.
PR/47626
ok'ed by christos

branches: 1.30.2;
- pass correct types.
- use sizeof(var) instead of sizeof(type)

branches: 1.29.30; 1.29.32;
Implement a new magic string for magic symlinks, @ruid, which exapnds to the
real user id of the process and use this magic string for per-user tmp.
This should fix PR/35687

Kernel parts reviewed by wrstuden@

split LOGIN_SETGROUP -> LOGIN_SETGID|LOGIN_SETGROUPS

branches: 1.27.4;
Add support for per-user /tmp.

Enabled via per_user_tmp in /etc/rc.conf (default off).

See security(8) and rc.conf(5) for more details.

Lots of input from thorpej@ & christos@, thanks!

From Anon Ymous:
- add __unused
- remove __GNUC__ hack

- Instead of wondering if to syslog an error, do so, but in the called
function.
- use snprintf instead of sprintf.

Allow escaping of the separators using a double backslash

make setuserenv and setuserpath take an environment setting function and
an environment pointer and expose them.
bump version.

Lint warnings.

Allow for a login.conf file without an explicite "default" class
definition.
The login.conf(5) manpage states that the "default" class is used
*if it exists*.

Unbreak setuserpath(); from Nick Hudson.

Constify; the api was completely broken before.

sbsize should be parsed as R_CSIZE so that suffixes work correctly.
Fix from Christian Biere in PR [lib/25504].

(XXX: the R_CSIZE parsing should be changed to using strsuftollx(3))

sprinkle const

Add sbsize login capability.

delint pointer casts.

Don't use NULL to compare against an int.

initialize 'res' to NULL

plug possible memory leak. from openbsd

seperate -> separate

sprinkle in _DIAGASSERT() as appropriate

/etc/login.conf is optional, so don't return NULL even if
there's none found. addresses part of PR 11150. sync with openbsd.

cosmetic; indentation

- Pull in <util.h> to get secure_path() declared.
- Resolve preprocessor symbol clash.

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

branches: 1.5.4;
Add a missing free() of a temporary buffer.
Add "unlimited" as synonym for "inf" and "infinity" for the
benefit of FreeBSD users.
Factor out the comparison w/ "infinity" in a isinfinite() function.

Add login_getpwclass to libutil as convenience function for
programs originally for FreeBSD.
Add parsing of "setenv" parameter which can be used to set
up an initial environment on login.

Make setusercontext() resilient against missing login.conf too.

Make login_cap routines resilient to non-existant conf file, and
secure_path() less noisy.

Add necessary support routines for login.conf.

NULL does not need a cast, here

Use STDIN_FILENO and friends instead of magic constants 0/1/2.
Suggested by the patches in PR bin/36551 from Greg A. Woods.

branches: 1.11.22;
Move UCB-licensed code from 4-clause to 3-clause licence.

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

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

back out the #ifdef _DIAGNOSTIC argument checks; too many people complained.
_DIAGASSERT() is still retained.

* use _DIAGASSERT() to check pointer arguments against NULL and file
descriptors against -1 (as appropriate).
* add actual checks which to detect stuff that would trigger_DIAGASSERT(),
and attempt to return a sane error condition.
* knf some code
* remove some `register' decls.

the first two items result in the addition of code similar to the
following in various functions:

_DIAGASSERT(path != NULL)
#ifdef _DIAGNOSTIC
if (path == NULL) {
errno = EFAULT;
return (-1);
}
#endif

2 -> STDERR_FILENO

- RCSID police
- Add ttymsg.3

Minor reorganization of libutil, including the addition of passward
locking and editing functions.
From Greg Hudson <ghudson@MIT.EDU>

Prototypes (PR#1100).

minor cleanup; kill unnecessary casts

Add RCS identifiers.

branches: 1.1.1;
Initial revision

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

branches: 1.2.30;
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.

Add documentation for utmpx and some related functions.
Thanks for some explanations to christos, and for some STANDARDS hints
to Klaus Klein.

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

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

put utmpx/wtmpx routines to separate files, so that programs overriding the
utmp/wtmp routines could still be linked static
fixes e.g. static build of ftpd

Lint warnings.

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

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

put utmpx/wtmpx routines to separate files, so that programs overriding the
utmp/wtmp routines could still be linked static
fixes e.g. static build of ftpd

add utmpx/wtmpx processing routines.

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

back out the #ifdef _DIAGNOSTIC argument checks; too many people complained.
_DIAGASSERT() is still retained.

* use _DIAGASSERT() to check pointer arguments against NULL and file
descriptors against -1 (as appropriate).
* add actual checks which to detect stuff that would trigger_DIAGASSERT(),
and attempt to return a sane error condition.
* knf some code
* remove some `register' decls.

the first two items result in the addition of code similar to the
following in various functions:

_DIAGASSERT(path != NULL)
#ifdef _DIAGNOSTIC
if (path == NULL) {
errno = EFAULT;
return (-1);
}
#endif

bzero->memset, bcopy->memcpy, bcmp->memcmp

Need <time.h> for time() prototype.

Lseek(2) usage cleanup: the use of L_SET/L_INCR/L_XTND is deprecated,
use SEEK_SET/SEEK_CUR/SEEK_END instead.

- RCSID police
- Add ttymsg.3

Minor reorganization of libutil, including the addition of passward
locking and editing functions.
From Greg Hudson <ghudson@MIT.EDU>

minor cleanup; kill unnecessary casts

off_t

Add RCS identifiers.

branches: 1.1.1;
Initial revision

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

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

put utmpx/wtmpx routines to separate files, so that programs overriding the
utmp/wtmp routines could still be linked static
fixes e.g. static build of ftpd

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

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

put utmpx/wtmpx routines to separate files, so that programs overriding the
utmp/wtmp routines could still be linked static
fixes e.g. static build of ftpd

add utmpx/wtmpx processing routines.

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

back out the #ifdef _DIAGNOSTIC argument checks; too many people complained.
_DIAGASSERT() is still retained.

* use _DIAGASSERT() to check pointer arguments against NULL and file
descriptors against -1 (as appropriate).
* add actual checks which to detect stuff that would trigger_DIAGASSERT(),
and attempt to return a sane error condition.
* knf some code
* remove some `register' decls.

the first two items result in the addition of code similar to the
following in various functions:

_DIAGASSERT(path != NULL)
#ifdef _DIAGNOSTIC
if (path == NULL) {
errno = EFAULT;
return (-1);
}
#endif

Delint

Need <time.h> for time() prototype.

- RCSID police
- Add ttymsg.3

Minor reorganization of libutil, including the addition of passward
locking and editing functions.
From Greg Hudson <ghudson@MIT.EDU>

Prototypes (PR#1100).

minor cleanup; kill unnecessary casts

Add RCS identifiers.

branches: 1.1.1;
Initial revision

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

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

put utmpx/wtmpx routines to separate files, so that programs overriding the
utmp/wtmp routines could still be linked static
fixes e.g. static build of ftpd

lib: sync some manual pages with reality

branches: 1.16.14;
Use mdoc macros.

Document opendisk1() - it has been around long enough.
(pity about the name...)

XXX pullup-8

branches: 1.14.10;
new lookup order will be in 7.1 before 8.0

branches: 1.13.2; 1.13.4;
Fix typo. Sort errors.

PR/51216: Instead of trying to open files in the current working
directory first for paths that don't contain "/", first try the
/dev paths to avoid confusion with files in the working directory
that happen to match disk names.

branches: 1.11.8; 1.11.42; 1.11.46;
Convert TNF licenses to new 2 clause variant

branches: 1.10.30;
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.

remove referenced to raw (block) and cooked (character) devices, since
opendisk(3) doesn't care. the iscooked parameter just changes which
paths in /dev are tried if the supplied one doesn't work.

revert previous.
it appears that i misread the intent of the iscooked parameter when
originally designing this feature with jason, and changing it broke
some programs.

Enforce is iscooked arg;
if zero, a matching path must be of type S_IFCHR, and
if non-zero, a matching path must be of type S_IFBLK.

path variations don't occur if there's a / in the path

More trailing white space.

Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

add LIBRARY section to man page

implement opendisk(3), as discussed with Jason Thorpe

PR/51216: Instead of trying to open files in the current working
directory first for paths that don't contain "/", first try the
/dev paths to avoid confusion with files in the working directory
that happen to match disk names.

toolify opendisk

branches: 1.12.24; 1.12.28;
In a furious blaze of *facepalm* / "what was i thinking?", fix the
open routine function pointer prototype of opendisk1() to match
the prototype of open().

Add opendisk1(), which functions like opendisk(), but takes a function
pointer to the routine to be used for open().

branches: 1.10.6; 1.10.8; 1.10.14;
Remove clause 3 and 4 from TNF licenses

branches: 1.9.32;
revert previous.
it appears that i misread the intent of the iscooked parameter when
originally designing this feature with jason, and changing it broke
some programs.

Enforce is iscooked arg;
if zero, a matching path must be of type S_IFCHR, and
if non-zero, a matching path must be of type S_IFBLK.

- __RCSID() police.
- ANSIfy.
- Miscellaneous style changes.
- Shutup lint(1) in one or two cases.

back out the #ifdef _DIAGNOSTIC argument checks; too many people complained.
_DIAGASSERT() is still retained.

* use _DIAGASSERT() to check pointer arguments against NULL and file
descriptors against -1 (as appropriate).
* add actual checks which to detect stuff that would trigger_DIAGASSERT(),
and attempt to return a sane error condition.
* knf some code
* remove some `register' decls.

the first two items result in the addition of code similar to the
following in various functions:

_DIAGASSERT(path != NULL)
#ifdef _DIAGNOSTIC
if (path == NULL) {
errno = EFAULT;
return (-1);
}
#endif

Back out my dumb change.

Add a prototype for opendisk so it will compile. (Should we have
a libutil.h for collecting all these prototypes?)

reorder some checks so that buf is initialised as early as possible
(just after the check for buf != NULL)

implement opendisk(3), as discussed with Jason Thorpe

mention PATH_MAX instead of 16.

Remove trailing whitespace.

Mention how big the name can be.

branches: 1.14.2; 1.14.10;
Clarify that the "amaster" argument of forkpty() is only defined upon
return in the parent process, but the tty name is available to both
the parent and child. Bump date.

Don't allow openpty to succeed if the caller is non-superuser.
XXX: we cross-reference ptm 4 which does not exist (yet)

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

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

Minor grammatical correction.

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.

New sentence, new line. From Robert Elz.

Correct the list of pseudo-terminals in the FILES section.

branches: 1.7.2;
Sort sections.

Generate <>& symbolically.

PCVT hack is gone.

branches: 1.4.10;
add LIBRARY section to man page

RCS Id Police.

- fix retval of openpty()
- correct two .Fn references to forkpty()
- describe retval of forkpty(); it can return PID as well
- add xref to fork(2)

Minor reorganization of libutil, including the addition of passward
locking and editing functions.
From Greg Hudson <ghudson@MIT.EDU>

parsedate.3: resolve contradictory values for 'next'

PR bin/56042

Fix typos (2nd acst should have been acdt), 0550 for ist should be 0530
(5.5 hours is not 5 hours and 50 minutes...).

Comment out the zp4 zp5 and zp6 zone names. They are supposedly supported
by the source (they're in the table) but cannot work, as the parsedate
lexer doesn't allow a "word" to start with an alpha and also contain
digits. Maybe (just maybe) that could be fixed sometime, but since these
have never worked, and no-one has ever seemed to miss them, and they're the
only words which are of that form, for now, just stop pretending they work.

branches: 1.25.2;
Catch the parsedate man page up with recent updates, ans also include
some general improvements I've had kicking around for a long time, but
never got around to committing.

parsedate.y: meaningless KNF of a comment (no code changes)
parsedate.3: add an item in BUGS noting the weirdness of "next"

The real purpose of this commit is to supply the following message
which should be used for the immediately previous commit, replacing
its commit message (the two are similar, but definitely not the
same). With thanks to gdt@ for pointing out one of the (many) errors
in the previous message (and noting others I had already seen).

----

Make parsedate handle "12 noon" and "12 midnight" (including when the
time given is "12:00" or "12:00:00") - but only for exactly 12 o'clock.
"12:00:01" is am or pm, not noon or midnight.

"12 am" remains as an alias for "12 midnight", and "12 pm" for noon,
though both are strictly (pedanticly) invalid (and meaningless.)

Note that "12 midnight" (or "12 am") means 00:00:00 (ie: midnight at
the start of the day, not at the end.)

Make parsedate handle "12 noon" and "12 midnight" (including when
the time is "12:00" or "12:00:00) - but only for exactly 12 o'clock.
"12:00:01" is am or pm, not noon or midnight.

"12 am" remains as an alias for "12 midnight", and "12 pm" for midnight,
though both are strictly invalid (and meaningless.)

Note that "12 pm" means 00:00:00 (ie: midnight at the start of the
day, not at the end.)

branches: 1.22.2;
Complete a sentence
and replace full stop with a comma at one place as the sentence wasn't finished

branches: 1.21.2;

Remove dawn/sunup/sunset/sundown (sunrise was never there...)
If 06:00 or 18:00 are wanted, just say "06:00" (etc). If these
are ever added back, they really should determine location, and
calculate actual sunrise/sunset times for the location and date.
That's not likely to happen...

Markup improvements.

more changes I forgot to commit

- Add support for "midnight" "noon", dawn etc.
- Add validation to date/time strings by checking that mktime did not change
the fields of struct tm from the ones requested
- Allow the format "year monthname day".
From kre

Sort sections. Mark up NULL. End Bl with El.

Fix documentation inconsistencies, and add some clarifications (from kre)

Drop trailing whitespace.

The tzoff argument is in minutes (behind/west of UTC), not seconds.

While here, also say that time = NULL and tzoff = NULL are independent.
The code doesn't yet implement that, but it will soon.

Document that years in ISO 8601 dates are taken literally.
"69-09-10" is in the year 69, not 2069.

branches: 1.12.8;
Document that errno may be used to distinguish between a
non-error result of -1 and an error.

branches: 1.11.2;
Fix capitalization and typo, from Bug Hunting.

branches: 1.10.6; 1.10.8;
Remove trailing whitespace.

- document limitations
- add extra number name parsing

Fix Dd argument, sort sections.

Mention recent enhancement and not that this function is neither
re-entrant nor thread-safe.

Use .Fn instead of .Nm.

Specify width for tag list

branches: 1.4.6; 1.4.8; 1.4.10;
Convert TNF licenses to new 2 clause variant

branches: 1.3.10;
Quote - when used as minus; uppercase Dt argument; remove dot at end
of SEE ALSO; new sentence, new line.

Remove trailing whitespace.

rename getdate to parsedate to avoid conflict with posix function

revert previous.

next should increement by 1 not 2.

parsedate.y: remove outdated comment

The number of shift/reduce conflicts has grown to 16.

fix date -d 12/01/2022, found by Anon Ymous

PR lib/46542

Add checks to detect overflow, and also detect other invalid
(out of range) inputs for parsedate().

There could be more, and some of what is being added is not
perfect, but many calculation overflows will be detected now
(and cause an error return) and some of the most bizarre
inputs that were previously accepted no longer will be.

Check the year field of a tentative ISO-8601 date format for overflow
before committing to it being an 8601 format date, rather than after
(or the fall back grammar parser doesn't start with a clean slate).

This isn't likely to ever bother anyone, the chances of encountering
something that looks just like an 8601 format date, but with a year
field so large it overflows a long are kind of slim. If it did happen
the chances that the string could be correctly parsed (into something
different) by the grammar are even slimmer. But better to do it properly.

For touch -d (which uses parsedate()) POSIX specifies that the
ISO-8601 format yyyy-mm-ddTHH:MM:SS[radix_and+frac][Z]
be accepted.

We didn't handle that, as in parsedate(), 'T' represents the
military timezone designator, not a padding separator between
date & time as POSIX specified it.

The way parsedate() is written, fixing this in the grammar/lexer
would be hard without deleting support for T as a zone indicator
(it is *my* timezone!).

So, instead of doing that, parse an ISO-8901 string which occurs
right at the start of the input (not even any preceding white space)
by hand, before invoking the grammar, and so not involving the lexer.
This is sufficient to make touch -d conform.

After doing that, we still need to allow earlier valid inputs,
where an ISO-8601 format (using space as the separator, but without
the 'Z' (Zulu, or UTC) suffix) followed by an arbitrary timezone
designation, and other modifiers (eg: "+5 minutes" work. So we
call the grammar on whatever is left of the input after the 8601
string has been consumed. This all "just works" with one exception,
a format like "yyyy-mm-dd hh:mm:ss +0700" would have the grammar parse
just "+0700" which by itself would be meaningless, and so wasn't
handled. Add a grammar rule & processing to Handle it.

Also note that while POSIX specifies "at least 4" digits in the YYYY
field, we implement "at least one" so years from 0-999 continue to be
parsed as they always have (nb: these were, and continue to be, treated
as absolute year numbers, year 10 is year 10, not 2010). Years > 2 billion
(give or take) cannot be represented in the tm_year field of a struct tm,
so there's a limit on the max number of digits as well.

POSIX requires that when converting 2 digit year representations to
actual specific years, values from 69-99 be treated as 20th century,
and values from 0-68 be treated as 21st century. This allows for those
unfortunate enough to reside in a timezone west of Greenwich to convert
the epoch (or a time very close to it) to text, write that with just two
digits, and correctly convert it back to a time near the epoch, rather
than to something in 2069.

We used to split things so 0-69 were 21st century, and 70-99 were 20th.
Change that (this requires a change in the parsedate ATF tests which
test this specific boundary).

While here, add support for another POSIX requirement, that the radix
char before fractional seconds can be either a ',' or a '.'. We used
to allow only '.', add support for ','. This is something of a meaningless
change, as parsedate() returns a time_t in which there is no way to
represent fractional seconds, so there's little point in ever specifying
them regardless of what char is used for the "decimal point" - they will
be ignored anyway. But at least fractional seconds using a ',' as the
radix char will no longer cause the conversion to fail (or do something else
bizarre).

parsedate.y: meaningless KNF of a comment (no code changes)
parsedate.3: add an item in BUGS noting the weirdness of "next"

The real purpose of this commit is to supply the following message
which should be used for the immediately previous commit, replacing
its commit message (the two are similar, but definitely not the
same). With thanks to gdt@ for pointing out one of the (many) errors
in the previous message (and noting others I had already seen).

----

Make parsedate handle "12 noon" and "12 midnight" (including when the
time given is "12:00" or "12:00:00") - but only for exactly 12 o'clock.
"12:00:01" is am or pm, not noon or midnight.

"12 am" remains as an alias for "12 midnight", and "12 pm" for noon,
though both are strictly (pedanticly) invalid (and meaningless.)

Note that "12 midnight" (or "12 am") means 00:00:00 (ie: midnight at
the start of the day, not at the end.)

Make parsedate handle "12 noon" and "12 midnight" (including when
the time is "12:00" or "12:00:00) - but only for exactly 12 o'clock.
"12:00:01" is am or pm, not noon or midnight.

"12 am" remains as an alias for "12 midnight", and "12 pm" for midnight,
though both are strictly invalid (and meaningless.)

Note that "12 pm" means 00:00:00 (ie: midnight at the start of the
day, not at the end.)

Fix PR lib/52101 -- 12:30 am is 00:30:00 and 12:30 pm is 12:30:00

branches: 1.29.2; 1.29.4;

Remove dawn/sunup/sunset/sundown (sunrise was never there...)
If 06:00 or 18:00 are wanted, just say "06:00" (etc). If these
are ever added back, they really should determine location, and
calculate actual sunrise/sunset times for the location and date.
That's not likely to happen...

Make relative date changes ("+ 2 months") etc, work a little more sanely.

OK christos@

When computing relative months, use mktime() directly and don't call
our Convert(). And check it for failure. This fixes three sets of
problems:

(1) depending on the passed-in value of Timezone it might
disassemble the time in one timezone and reassemble it in
another, causing mysterious offsets of a few hours;

(2) with the previous set of changes to this file, Convert() fails
if it ends up normalizing a date, so e.g. going three months
forward from March 31 would fail;

(3) previously if Convert() failed we passed -1 on to DSTcorrect(),
which made a mess.

PR 50574.

Always use localtime_r; I don't think any of this code is tripping
itself up, but it's still good practice for library functions to not
trash static libc state. Might be relevant to PR 50574.

Reformat grammar part according to my standards for yacc grammars.

preserve a copy of the tm so we can check later.

- Add support for "midnight" "noon", dawn etc.
- Add validation to date/time strings by checking that mktime did not change
the fields of struct tm from the ones requested
- Allow the format "year monthname day".
From kre

Fix west australia offset, from kre

Patch from kre:
- fix missing/inconsistent abbreviations
- set dst only if we are using localtime.
- properly check for errors where there were missing checks
- handle errno properly including saving and restoring.

Improved handling of local times.

* A magic value USE_LOCAL_TIME (defined as 99999) may be passed as the
Timezone to Convert(), instructing it to use mktime() to work
in the local time zone, instead of using mktime_z to work in UTC
(and then adding the specified timezone offset).
* Some old code is removed now that there's no need to find the local
timezone offset.
* Allow either one or both of the now and zone arguments to
parsedate() to be NULL, treating them independently. Previously,
if either one was NULL, the other was ignored.
* If the zone argument is specified, then the current date is calculated
in the specified zone, not in local time.

Also add some disabled debug code.

This should fix PR lib/47916.

Add a new non-terminal "time_numericzone" for a time with
a numeric timezone. Move some productions from "time" to "time_numericzone".
Increment yyHaveZone when encountering one of these.

Previously, input of the form "HH:MM:SS +ZZZZ" would not have set the
yyhaveZone flag.

A time like HH:MM:SS.sss says nothing about whether DST is on or off.

Some years don't need the "maybe add 1900 or 2000" adjustment
that was designed for handling two-digit abbreviated years.
For example, "1/2/70" still refers to the year 1970, as before,
but "70-01-02" now refers to the year 70.

* Add a new yyHaveFullYear member to struct dateinfo, to record whether
or not the year needs to be adjusted.
* Code that parses years sets yyHaveFullYear=1 if they know that the
year should not be adjusted (as is the case for ISO 8601 dates), or if
they perform their own adjustment (as is the case for CVS timestamps).
* Move the year adjustment code into a new function, AdjustYear,
instead of inline in Convert().
* Make Convert() assume the year doesn't need to be adjusted,
and make Convert's callers first call AdjustYear() if appropriate.

branches: 1.16.6;
fix timezone bugs in rev.1.11 and rev.1.13. PR/47916.

add rcsid

Distinguish between a non-error result of (time_t)-1 and an error result.
Modernise the test code inside #ifdef TEST.

mktime(3) works in local time, and trying to trick it by
setting tm_gmtoff doesn't work. Instead, call mktime_z(3)
with a null timezone (so it works in UTC) and adjust the
result afterwards. Now "date -d @0" correctly
prints the local equivalent of 1970-01-01 00:00:00 UTC.

Don't use const foo const as type, one const is enough.

branches: 1.11.2; 1.11.6; 1.11.8;
Use mktime(3) instead of hand-coded equivalent.
Don't treat negative results as errors (we should be able
to handle years before 1970).

XXX: This still fails on 1969-12-31 23:59:59.

branches: 1.10.6;
restore lost overlow check fix.

make this thread-safe. We could use localtime_tz and make it even better,
but not now.

fix incorrect overflow check from Nicholas Joly

- fix off by one in comparison with 69 (it should be 70)
- add aliases for 1 (one), 2 (two), etc.
- allow parsing of HH:MM:SS.sss as the man page mentions, and ignore sss