stdio.h: remove outdated comment for vscanf

When these functions where added to stdio.h 1.72 on 2008-08-04, the
conditional included _NETBSD_SOURCE.

The additional condition was removed in stdio.h 1.99 from 2020-03-20,
but the comment was not updated.

stdio.h: sync comment for struct __sFILE with reality

In stdio.h 1.1 from 1993-03-21, the struct had a member named _ub for
the ungetc buffer. That member was repurposed in stdio.h 1.42 from
2001-12-07 in order to support wide characters.

Remove the reference to the 'WARNING above' since there is no such
warning and even when this comment was added in stdio.h 1.20 from
1998-02-02, there was none.

stdio.h: remove outdated comment about fpos_t

The 'fairly grotesque' from 1994-04-03 referred to the conditional
definition of the type fpos_t, using two different integer types that
both happened to be 64-bit.

When stdio was changed on 2012-01-22 to keep track of the mbstate, the
conditional type definition was removed and the comment no longer made
sense.

stdio.h: fix typo in comment

stdio.h: fix typo in comment

Fix visibility of various C99 features, esp. for C++11.

move P_tmpdir from "/var/tmp/" to "/tmp/".

the main effect of this is to make GCC and other libiberty using
tools use /tmp instead of /var/tmp for compiler temp files,
which can be a bottleneck on larger systems.

a survey of other platforms shows only OSX also uses /var/tmp,
everyone else has switched to /tmp long ago.


cons: some smaller systems may have a smaller /tmp than /var/tmp,
and this may cause builds to fail with out of space earlier.
point the build to /var/tmp using TMPDIR in this case.

one can argue that setting TMPDIR would work around this, but we
want to have the effect for all users without having special setup.

branches: 1.97.8; 1.97.16; 1.97.18;
gcc 5, my patience is waning.

Put fseeko, ftello, pread, and pwrite in the POSIX 2001 namespace.
Ok christos, apb, martin

One vscanf_l is ample.

PR/49715: Henning Petersen: Missing _*_DECLS in stdio.h around popenve.

add popenve().

add open_{,w}memstream

branches: 1.91.2;
cast to LHS type and minor KNF.

Fix use of getline and friends in C++ code.

Move declarations of getdelim() and getline() from the (incorrect) ANSI C
section to POSIX-2008. From Jarmo Jaakkola in PR standards/48788.

branches: 1.88.4;
add the signal safe prototypes

Don't pollute the name space with the various stdio macros for C++.

Add missing __BEGIN_DECLS/__END_DECLS.

Add scanf_l and wscanf_l families.

Add explicit locale versions for the printf family. Replace asprintf,
snprintf and sprintf with simple wrappers around the corresponding
va_list functions to reduce code duplication.

White space

branches: 1.82.2;
specify size of the array to help -fmudflap

funopen2()

branches: 1.80.2;
From tnozaki@: make fpos_t a complex object that keeps track of the parse
state of the stream. Change argument of the seek function to funopen() from
fpos_t to off_t. Make f{g,s}etpos() use the new fpos_t struct, while providing
backwards compatible entry points. Approved by releng@

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

add fmemopen(3) derrived from POSIX:2008.
libc minor bump.

Add dprintf and vdprintf. XXX: Might ifdef it if too many things break.

Consistently use __printflike and __scanflike.

branches: 1.75.2;
Use a proper char */size_t pair in __sfileext to keep track of the line
buffer for fgetln and fgetwln. Simplifies code by dropping the INT_MAX
related logic. Drop conditionals around FREELB, free(NULL) is valid.

Add implementations for getdelim(3) and getline(3).

branches: 1.73.6;
add missing attributes to the remaining calls, even the ones that gcc has
builtin attributes for (for symmetry and consistency). In the future this
might change to use compiler-neutral macros. On the other hand I don't
know of any other compiler that provides other macros with similar
functionality, so why bother?

Add _POSIX_HOST_NAME_MAX and _POSIX_SYMLOOP_MAX to <limits.h> and add some
references to them in <sys/param.h>
in <stdio.h> also export v*scanf when _ISOC99_SOURCE is defined

From andy dot shevchenko at gmail dot com.

branches: 1.71.4;
Since _file is a short, check that the fd fits in it, otherwise bail with
EMFILE. We treat _file as an unsigned short to double our range, with a
special case for -1 (closed). Make a note of what we should do about stdio
if we ever bump libc. We could change _file in the future compatibly to an
int by putting it in the extension space but for now we don't bother.

branches: 1.70.2; 1.70.6; 1.70.8;
Do not include SSP files unless _FORTIFY_SOURCE > 0.

Match usage of FORTIFY_SOURCE on other platforms by not requiring special
include path: the normal header files now include the "SSP" ones (which one
should note are not really named right: SSP and FORTIFY_SOURCE are independent
features).

Disable USE_SSP on targets where the compiler doesn't support it at all
(mips, alpha) or it's known broken (sh3). But enable FORTIFY_SOURCE,
without SSP, on those platforms -- tested on mipsel.

remove __SAFE

defined(_NETBSD_SOURCE) is equivalent to (!defined(_ANSI_SOURCE) &&
!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)), so there's no
need to check both of them.

branches: 1.66.2;
Don't expose _ss functions for 4.0. Requested by core.

- flags should be unsigned short instead of short.
- add __SAFE flag, to indicate that we want async-signal-safe functionality
only.
- add snprintf_ss, and vsnprintf_ss; these are undocumented on purpose.

add __BEGIN_DECLS/__END_DECLS around snprintf() & vsnprintf() prototypes.

inline -> __inline for selected things (specifically, the header
file is POSIX visible and the usage isn't #ifdef _KERNEL)

Discussed with core. I may need to go farther than this but for now
compilations done with gcc -ansi (i.e. firefox) will be okay.

Remove leading __ from __(const|inline|signed|volatile) -- it is obsolete.

Include <sys/ansi.h> after <sys/cdefs.h>; from Neil Booth in PR lib/30072.

Belatedly move snprintf() and vnsnprintf() into the XPG4.2/C99 section.

Add restrict qualifiers to fopen()/freopen() arguments.

branches: 1.58.2;
A little libc namespace housekeeping exercise:
* Make vfprintf_unlocked() an internal function, c.f. __svfscanf_unlocked().
* Add internal names for arc4random(), endnetpath(), fhstatvfs(),
fstatvfs(), mkstemp(), shquote(), statvfs(), taddr2uaddr(), uaddr2taddr(),
uuid_create_nil(), uuid_is_nil(), and wcwidth().
* Include namespace.h where supposed to.

de-__P -- the hack is long since useless. Discussed with christos,
matt, kleink, others. Approved by christos.

Tidy up the namespace: lint -> __lint__.

remove fgetstr() from public sight

add fgetstr

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

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

P_tmpdir isn't in POSIX, so only define it for _XOPEN_SOURCE and
_NETBSD_SOURCE.

Add a new feature-test macro, _NETBSD_SOURCE. If this is defined
by the application, all NetBSD interfaces are made visible, even
if some other feature-test macro (like _POSIX_C_SOURCE) is defined.
<sys/featuretest.h> defined _NETBSD_SOURCE if none of _ANSI_SOURCE,
_POSIX_C_SOURCE and _XOPEN_SOURCE is defined, so as to preserve
existing behaviour.

This has two major advantages:
+ Programs that require non-POSIX facilities but define _POSIX_C_SOURCE
can trivially be overruled by putting -D_NETBSD_SOURCE in their CFLAGS.
+ It makes most of the #ifs simpler, in that they're all now ORs of the
various macros, rather than having checks for (!defined(_ANSI_SOURCE) ||
!defined(_POSIX_C_SOURCE) || !defined(_XOPEN_SOURCE)) all over the place.

I've tried not to change the semantics of the headers in any case where
_NETBSD_SOURCE wasn't defined, but there were some places where the
current semantics were clearly mad, and retaining them was harder than
correcting them. In particular, I've mostly normalised things so that
_ANSI_SOURCE gets you the smallest set of stuff, then _POSIX_C_SOURCE,
_XOPEN_SOURCE and _NETBSD_SOURCE in that order.

Tested by building for vax, encouraged by thorpej, and uncontested in
tech-userlevel for a week.

As with _REENTRANT, don't provide simple non-locking macro versions of
several functions when _PTHREADS is defined (usually via cc -pthread).

avoid TMP_MAX redefinition

Merge the nathanw_sa branch.

Spelling police. "__resitrct" was not spelled cirectly enough.

- 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).

* Move the prototype of __svfscanf from <stdio.h> to libc/stdio/local.h.
* Add prototype for vfscanf to <stdio.h>.
* Remove #define of vfscanf to __svfscanf from <stdio.h>.
* Include local.h in libc files which need __svfscanf.
* Add vfscanf weak alias to __svfscanf.

Fixes standards/16997.

NOTE: libc minor not bumped -- ride on the bump to 12.84 made by
itojun today.

Parameterize the vfscanf macro's arguments. Without them, 3rd party
software can become greatly confused.

This fixes 4 GCC 3.2 testsuite failures.

This is a stop-gap measure which can be easily applied to the 1.6
release branch. A different fix for the trunk is forthcoming.

Add a scanf format attribute to __svfscanf().

branches: 1.42.2;
- make FILE structure extensible without breaking binary-compatibility.
- add fputwc, fgetwc, fwide and related functions.
- add hooks needed to maintain the orientation of file stream.

branches: 1.41.2;
Sprinkle some __restrict into stdio.

protect against multiple declarations.

Move fmtcheck() prototype to stdio.h. It makes more sense to declare it
with the formatting functions with which it is meant to be used. Thanks
to Klaus Klein for "encouraging" me to make this change.

Avoid recursion with traditional cpp.

This is a HACK so that libc can compile with -ansi.

- Fix couple of typos.
- Protect some func. decls. added recently with __{BEGIN,END}_DECLS.

fix obvious typo

XCU5: Add fseeko() and ftello() functions which provide the functionality of
fseek() and ftell(), respectively, but operate on file offsets of type off_t.

Get rid of the inclusion of <sys/types.h> and define fpos_t using __off_t.

Move <null.h> to <sys/null.h> for the purpose of avoiding conflicts due to
std C headers including it, and a kernel module written in C++ would benfit
as well.

For the benefit of G++'s null pointer constant implementation, #define NULL
as __null with egcs 1.0 (GCC 2.90) and above. As several headers are affected
by this change, move the definition into a new header file, <null.h>, to ease
maintenance.

* Bring *_unlocked() declarations in scope if _REENTRANT is defined, too; add
similar protection for the definitions of the macro versions.
* Don't define a macro version of fileno() in a _REENTRANT environment.

Move 1003.1c-1995 declarations inside the appropriate name space protection
wrapper, and make sure we won't use these decl's as such with C++ linkage(!).
Also, make _XOPEN_SOURCE protection of popen()/pclose() decl's a bit more
restrictive.

Use __format__, __printf__ for consistency

add asprintf and vasprintf, originally written by Todd Miller for OpenBSD

__Namespace__ __protection__.

Nuke tmpnam() as well.

If __AUDIT__ is defined, remove some traditional interfaces: gets, sprintf,
vsprintf, tempnam, mktemp, getwd.

add missing backslash

Reorganize name space protection.

If standards-compliance is requested by defining the preprocessor symbols
_POSIX_SOURCE or _XOPEN_SOURCE at compile time, use __RENAME() to call
__posix_rename() instead of rename() in order to remove the requirement of
linking against libposix.

merge lite-2

Added function declarations for flockfile(), ftrylockfile(), funlockfile(),
getc_unlocked(), getchar_unlocked(), putc_unlocked(), & putchar_unlocked().
Added macro definitions for the latter four functions.

Changed so that getc(), putc(), clearerr(), feof() and ferror() macros
are not defined if _REENTRANT is defined so that thread-safe function
versions will be used instead.

Fix typo, __STRICT_ANSI_ -> __STRICT_ANSI__

Removed declarations for sys_nerr & sys_errlist (moved to errno.h)

change second arg of fgets() from size_t to int

Removed const qualifier from ftell's FILE * argument. It's not ANSI,
and the recent change to flush output causes it to be changed.

new RCS ID format.

_VA_LIST_ -> _BSD_VA_LIST_

add _BSD's to ansi types

fpos_t is now a 64-bit quantity

rename fgetline() and sharpen axe for bostic...

Add `const's to sys_errlist decl to match 4.4.

Use GCC's format attribute (for bug detection with -Wformat).

Restore define for L_cuserid and add cuserid prototype.
It was provided, but not documented.

cuserid() was removed by 1990's revision of 1003.1, and we never provided it
so don't define the L_cuserid constant.

fread and fwrite both return size_t, not int.

sscanf takes a const char * as the first arg; the man page was (already)
correct.

Add RCS identifiers.

`inline' is not present in gcc when -ansi is given; use __inline instead.

branches: 1.1.1;
Initial revision

stdio.h: fix typo in comment

Fix visibility of various C99 features, esp. for C++11.

move P_tmpdir from "/var/tmp/" to "/tmp/".

the main effect of this is to make GCC and other libiberty using
tools use /tmp instead of /var/tmp for compiler temp files,
which can be a bottleneck on larger systems.

a survey of other platforms shows only OSX also uses /var/tmp,
everyone else has switched to /tmp long ago.


cons: some smaller systems may have a smaller /tmp than /var/tmp,
and this may cause builds to fail with out of space earlier.
point the build to /var/tmp using TMPDIR in this case.

one can argue that setting TMPDIR would work around this, but we
want to have the effect for all users without having special setup.

branches: 1.97.8; 1.97.16; 1.97.18;
gcc 5, my patience is waning.

Put fseeko, ftello, pread, and pwrite in the POSIX 2001 namespace.
Ok christos, apb, martin

One vscanf_l is ample.

PR/49715: Henning Petersen: Missing _*_DECLS in stdio.h around popenve.

add popenve().

add open_{,w}memstream

branches: 1.91.2;
cast to LHS type and minor KNF.

Fix use of getline and friends in C++ code.

Move declarations of getdelim() and getline() from the (incorrect) ANSI C
section to POSIX-2008. From Jarmo Jaakkola in PR standards/48788.

branches: 1.88.4;
add the signal safe prototypes

Don't pollute the name space with the various stdio macros for C++.

Add missing __BEGIN_DECLS/__END_DECLS.

Add scanf_l and wscanf_l families.

Add explicit locale versions for the printf family. Replace asprintf,
snprintf and sprintf with simple wrappers around the corresponding
va_list functions to reduce code duplication.

White space

branches: 1.82.2;
specify size of the array to help -fmudflap

funopen2()

branches: 1.80.2;
From tnozaki@: make fpos_t a complex object that keeps track of the parse
state of the stream. Change argument of the seek function to funopen() from
fpos_t to off_t. Make f{g,s}etpos() use the new fpos_t struct, while providing
backwards compatible entry points. Approved by releng@

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

add fmemopen(3) derrived from POSIX:2008.
libc minor bump.

Add dprintf and vdprintf. XXX: Might ifdef it if too many things break.

Consistently use __printflike and __scanflike.

branches: 1.75.2;
Use a proper char */size_t pair in __sfileext to keep track of the line
buffer for fgetln and fgetwln. Simplifies code by dropping the INT_MAX
related logic. Drop conditionals around FREELB, free(NULL) is valid.

Add implementations for getdelim(3) and getline(3).

branches: 1.73.6;
add missing attributes to the remaining calls, even the ones that gcc has
builtin attributes for (for symmetry and consistency). In the future this
might change to use compiler-neutral macros. On the other hand I don't
know of any other compiler that provides other macros with similar
functionality, so why bother?

Add _POSIX_HOST_NAME_MAX and _POSIX_SYMLOOP_MAX to <limits.h> and add some
references to them in <sys/param.h>
in <stdio.h> also export v*scanf when _ISOC99_SOURCE is defined

From andy dot shevchenko at gmail dot com.

branches: 1.71.4;
Since _file is a short, check that the fd fits in it, otherwise bail with
EMFILE. We treat _file as an unsigned short to double our range, with a
special case for -1 (closed). Make a note of what we should do about stdio
if we ever bump libc. We could change _file in the future compatibly to an
int by putting it in the extension space but for now we don't bother.

branches: 1.70.2; 1.70.6; 1.70.8;
Do not include SSP files unless _FORTIFY_SOURCE > 0.

Match usage of FORTIFY_SOURCE on other platforms by not requiring special
include path: the normal header files now include the "SSP" ones (which one
should note are not really named right: SSP and FORTIFY_SOURCE are independent
features).

Disable USE_SSP on targets where the compiler doesn't support it at all
(mips, alpha) or it's known broken (sh3). But enable FORTIFY_SOURCE,
without SSP, on those platforms -- tested on mipsel.

remove __SAFE

defined(_NETBSD_SOURCE) is equivalent to (!defined(_ANSI_SOURCE) &&
!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)), so there's no
need to check both of them.

branches: 1.66.2;
Don't expose _ss functions for 4.0. Requested by core.

- flags should be unsigned short instead of short.
- add __SAFE flag, to indicate that we want async-signal-safe functionality
only.
- add snprintf_ss, and vsnprintf_ss; these are undocumented on purpose.

add __BEGIN_DECLS/__END_DECLS around snprintf() & vsnprintf() prototypes.

inline -> __inline for selected things (specifically, the header
file is POSIX visible and the usage isn't #ifdef _KERNEL)

Discussed with core. I may need to go farther than this but for now
compilations done with gcc -ansi (i.e. firefox) will be okay.

Remove leading __ from __(const|inline|signed|volatile) -- it is obsolete.

Include <sys/ansi.h> after <sys/cdefs.h>; from Neil Booth in PR lib/30072.

Belatedly move snprintf() and vnsnprintf() into the XPG4.2/C99 section.

Add restrict qualifiers to fopen()/freopen() arguments.

branches: 1.58.2;
A little libc namespace housekeeping exercise:
* Make vfprintf_unlocked() an internal function, c.f. __svfscanf_unlocked().
* Add internal names for arc4random(), endnetpath(), fhstatvfs(),
fstatvfs(), mkstemp(), shquote(), statvfs(), taddr2uaddr(), uaddr2taddr(),
uuid_create_nil(), uuid_is_nil(), and wcwidth().
* Include namespace.h where supposed to.

de-__P -- the hack is long since useless. Discussed with christos,
matt, kleink, others. Approved by christos.

Tidy up the namespace: lint -> __lint__.

remove fgetstr() from public sight

add fgetstr

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

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

P_tmpdir isn't in POSIX, so only define it for _XOPEN_SOURCE and
_NETBSD_SOURCE.

Add a new feature-test macro, _NETBSD_SOURCE. If this is defined
by the application, all NetBSD interfaces are made visible, even
if some other feature-test macro (like _POSIX_C_SOURCE) is defined.
<sys/featuretest.h> defined _NETBSD_SOURCE if none of _ANSI_SOURCE,
_POSIX_C_SOURCE and _XOPEN_SOURCE is defined, so as to preserve
existing behaviour.

This has two major advantages:
+ Programs that require non-POSIX facilities but define _POSIX_C_SOURCE
can trivially be overruled by putting -D_NETBSD_SOURCE in their CFLAGS.
+ It makes most of the #ifs simpler, in that they're all now ORs of the
various macros, rather than having checks for (!defined(_ANSI_SOURCE) ||
!defined(_POSIX_C_SOURCE) || !defined(_XOPEN_SOURCE)) all over the place.

I've tried not to change the semantics of the headers in any case where
_NETBSD_SOURCE wasn't defined, but there were some places where the
current semantics were clearly mad, and retaining them was harder than
correcting them. In particular, I've mostly normalised things so that
_ANSI_SOURCE gets you the smallest set of stuff, then _POSIX_C_SOURCE,
_XOPEN_SOURCE and _NETBSD_SOURCE in that order.

Tested by building for vax, encouraged by thorpej, and uncontested in
tech-userlevel for a week.

As with _REENTRANT, don't provide simple non-locking macro versions of
several functions when _PTHREADS is defined (usually via cc -pthread).

avoid TMP_MAX redefinition

Merge the nathanw_sa branch.

Spelling police. "__resitrct" was not spelled cirectly enough.

- 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).

* Move the prototype of __svfscanf from <stdio.h> to libc/stdio/local.h.
* Add prototype for vfscanf to <stdio.h>.
* Remove #define of vfscanf to __svfscanf from <stdio.h>.
* Include local.h in libc files which need __svfscanf.
* Add vfscanf weak alias to __svfscanf.

Fixes standards/16997.

NOTE: libc minor not bumped -- ride on the bump to 12.84 made by
itojun today.

Parameterize the vfscanf macro's arguments. Without them, 3rd party
software can become greatly confused.

This fixes 4 GCC 3.2 testsuite failures.

This is a stop-gap measure which can be easily applied to the 1.6
release branch. A different fix for the trunk is forthcoming.

Add a scanf format attribute to __svfscanf().

branches: 1.42.2;
- make FILE structure extensible without breaking binary-compatibility.
- add fputwc, fgetwc, fwide and related functions.
- add hooks needed to maintain the orientation of file stream.

branches: 1.41.2;
Sprinkle some __restrict into stdio.

protect against multiple declarations.

Move fmtcheck() prototype to stdio.h. It makes more sense to declare it
with the formatting functions with which it is meant to be used. Thanks
to Klaus Klein for "encouraging" me to make this change.

Avoid recursion with traditional cpp.

This is a HACK so that libc can compile with -ansi.

- Fix couple of typos.
- Protect some func. decls. added recently with __{BEGIN,END}_DECLS.

fix obvious typo

XCU5: Add fseeko() and ftello() functions which provide the functionality of
fseek() and ftell(), respectively, but operate on file offsets of type off_t.

Get rid of the inclusion of <sys/types.h> and define fpos_t using __off_t.

Move <null.h> to <sys/null.h> for the purpose of avoiding conflicts due to
std C headers including it, and a kernel module written in C++ would benfit
as well.

For the benefit of G++'s null pointer constant implementation, #define NULL
as __null with egcs 1.0 (GCC 2.90) and above. As several headers are affected
by this change, move the definition into a new header file, <null.h>, to ease
maintenance.

* Bring *_unlocked() declarations in scope if _REENTRANT is defined, too; add
similar protection for the definitions of the macro versions.
* Don't define a macro version of fileno() in a _REENTRANT environment.

Move 1003.1c-1995 declarations inside the appropriate name space protection
wrapper, and make sure we won't use these decl's as such with C++ linkage(!).
Also, make _XOPEN_SOURCE protection of popen()/pclose() decl's a bit more
restrictive.

Use __format__, __printf__ for consistency

add asprintf and vasprintf, originally written by Todd Miller for OpenBSD

__Namespace__ __protection__.

Nuke tmpnam() as well.

If __AUDIT__ is defined, remove some traditional interfaces: gets, sprintf,
vsprintf, tempnam, mktemp, getwd.

add missing backslash

Reorganize name space protection.

If standards-compliance is requested by defining the preprocessor symbols
_POSIX_SOURCE or _XOPEN_SOURCE at compile time, use __RENAME() to call
__posix_rename() instead of rename() in order to remove the requirement of
linking against libposix.

merge lite-2

Added function declarations for flockfile(), ftrylockfile(), funlockfile(),
getc_unlocked(), getchar_unlocked(), putc_unlocked(), & putchar_unlocked().
Added macro definitions for the latter four functions.

Changed so that getc(), putc(), clearerr(), feof() and ferror() macros
are not defined if _REENTRANT is defined so that thread-safe function
versions will be used instead.

Fix typo, __STRICT_ANSI_ -> __STRICT_ANSI__

Removed declarations for sys_nerr & sys_errlist (moved to errno.h)

change second arg of fgets() from size_t to int

Removed const qualifier from ftell's FILE * argument. It's not ANSI,
and the recent change to flush output causes it to be changed.

new RCS ID format.

_VA_LIST_ -> _BSD_VA_LIST_

add _BSD's to ansi types

fpos_t is now a 64-bit quantity

rename fgetline() and sharpen axe for bostic...

Add `const's to sys_errlist decl to match 4.4.

Use GCC's format attribute (for bug detection with -Wformat).

Restore define for L_cuserid and add cuserid prototype.
It was provided, but not documented.

cuserid() was removed by 1990's revision of 1003.1, and we never provided it
so don't define the L_cuserid constant.

fread and fwrite both return size_t, not int.

sscanf takes a const char * as the first arg; the man page was (already)
correct.

Add RCS identifiers.

`inline' is not present in gcc when -ansi is given; use __inline instead.

branches: 1.1.1;
Initial revision

Fix visibility of various C99 features, esp. for C++11.

move P_tmpdir from "/var/tmp/" to "/tmp/".

the main effect of this is to make GCC and other libiberty using
tools use /tmp instead of /var/tmp for compiler temp files,
which can be a bottleneck on larger systems.

a survey of other platforms shows only OSX also uses /var/tmp,
everyone else has switched to /tmp long ago.


cons: some smaller systems may have a smaller /tmp than /var/tmp,
and this may cause builds to fail with out of space earlier.
point the build to /var/tmp using TMPDIR in this case.

one can argue that setting TMPDIR would work around this, but we
want to have the effect for all users without having special setup.

gcc 5, my patience is waning.

Put fseeko, ftello, pread, and pwrite in the POSIX 2001 namespace.
Ok christos, apb, martin

One vscanf_l is ample.

PR/49715: Henning Petersen: Missing _*_DECLS in stdio.h around popenve.

add popenve().

add open_{,w}memstream

branches: 1.91.2;
cast to LHS type and minor KNF.

Fix use of getline and friends in C++ code.

Move declarations of getdelim() and getline() from the (incorrect) ANSI C
section to POSIX-2008. From Jarmo Jaakkola in PR standards/48788.

branches: 1.88.4;
add the signal safe prototypes

Don't pollute the name space with the various stdio macros for C++.

Add missing __BEGIN_DECLS/__END_DECLS.

Add scanf_l and wscanf_l families.

Add explicit locale versions for the printf family. Replace asprintf,
snprintf and sprintf with simple wrappers around the corresponding
va_list functions to reduce code duplication.

White space

branches: 1.82.2;
specify size of the array to help -fmudflap

funopen2()

branches: 1.80.2;
From tnozaki@: make fpos_t a complex object that keeps track of the parse
state of the stream. Change argument of the seek function to funopen() from
fpos_t to off_t. Make f{g,s}etpos() use the new fpos_t struct, while providing
backwards compatible entry points. Approved by releng@

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

add fmemopen(3) derrived from POSIX:2008.
libc minor bump.

Add dprintf and vdprintf. XXX: Might ifdef it if too many things break.

Consistently use __printflike and __scanflike.

branches: 1.75.2;
Use a proper char */size_t pair in __sfileext to keep track of the line
buffer for fgetln and fgetwln. Simplifies code by dropping the INT_MAX
related logic. Drop conditionals around FREELB, free(NULL) is valid.

Add implementations for getdelim(3) and getline(3).

branches: 1.73.6;
add missing attributes to the remaining calls, even the ones that gcc has
builtin attributes for (for symmetry and consistency). In the future this
might change to use compiler-neutral macros. On the other hand I don't
know of any other compiler that provides other macros with similar
functionality, so why bother?

Add _POSIX_HOST_NAME_MAX and _POSIX_SYMLOOP_MAX to <limits.h> and add some
references to them in <sys/param.h>
in <stdio.h> also export v*scanf when _ISOC99_SOURCE is defined

From andy dot shevchenko at gmail dot com.

branches: 1.71.4;
Since _file is a short, check that the fd fits in it, otherwise bail with
EMFILE. We treat _file as an unsigned short to double our range, with a
special case for -1 (closed). Make a note of what we should do about stdio
if we ever bump libc. We could change _file in the future compatibly to an
int by putting it in the extension space but for now we don't bother.

branches: 1.70.2; 1.70.6; 1.70.8;
Do not include SSP files unless _FORTIFY_SOURCE > 0.

Match usage of FORTIFY_SOURCE on other platforms by not requiring special
include path: the normal header files now include the "SSP" ones (which one
should note are not really named right: SSP and FORTIFY_SOURCE are independent
features).

Disable USE_SSP on targets where the compiler doesn't support it at all
(mips, alpha) or it's known broken (sh3). But enable FORTIFY_SOURCE,
without SSP, on those platforms -- tested on mipsel.

remove __SAFE

defined(_NETBSD_SOURCE) is equivalent to (!defined(_ANSI_SOURCE) &&
!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)), so there's no
need to check both of them.

branches: 1.66.2;
Don't expose _ss functions for 4.0. Requested by core.

- flags should be unsigned short instead of short.
- add __SAFE flag, to indicate that we want async-signal-safe functionality
only.
- add snprintf_ss, and vsnprintf_ss; these are undocumented on purpose.

add __BEGIN_DECLS/__END_DECLS around snprintf() & vsnprintf() prototypes.

inline -> __inline for selected things (specifically, the header
file is POSIX visible and the usage isn't #ifdef _KERNEL)

Discussed with core. I may need to go farther than this but for now
compilations done with gcc -ansi (i.e. firefox) will be okay.

Remove leading __ from __(const|inline|signed|volatile) -- it is obsolete.

Include <sys/ansi.h> after <sys/cdefs.h>; from Neil Booth in PR lib/30072.

Belatedly move snprintf() and vnsnprintf() into the XPG4.2/C99 section.

Add restrict qualifiers to fopen()/freopen() arguments.

branches: 1.58.2;
A little libc namespace housekeeping exercise:
* Make vfprintf_unlocked() an internal function, c.f. __svfscanf_unlocked().
* Add internal names for arc4random(), endnetpath(), fhstatvfs(),
fstatvfs(), mkstemp(), shquote(), statvfs(), taddr2uaddr(), uaddr2taddr(),
uuid_create_nil(), uuid_is_nil(), and wcwidth().
* Include namespace.h where supposed to.

de-__P -- the hack is long since useless. Discussed with christos,
matt, kleink, others. Approved by christos.

Tidy up the namespace: lint -> __lint__.

remove fgetstr() from public sight

add fgetstr

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

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

P_tmpdir isn't in POSIX, so only define it for _XOPEN_SOURCE and
_NETBSD_SOURCE.

Add a new feature-test macro, _NETBSD_SOURCE. If this is defined
by the application, all NetBSD interfaces are made visible, even
if some other feature-test macro (like _POSIX_C_SOURCE) is defined.
<sys/featuretest.h> defined _NETBSD_SOURCE if none of _ANSI_SOURCE,
_POSIX_C_SOURCE and _XOPEN_SOURCE is defined, so as to preserve
existing behaviour.

This has two major advantages:
+ Programs that require non-POSIX facilities but define _POSIX_C_SOURCE
can trivially be overruled by putting -D_NETBSD_SOURCE in their CFLAGS.
+ It makes most of the #ifs simpler, in that they're all now ORs of the
various macros, rather than having checks for (!defined(_ANSI_SOURCE) ||
!defined(_POSIX_C_SOURCE) || !defined(_XOPEN_SOURCE)) all over the place.

I've tried not to change the semantics of the headers in any case where
_NETBSD_SOURCE wasn't defined, but there were some places where the
current semantics were clearly mad, and retaining them was harder than
correcting them. In particular, I've mostly normalised things so that
_ANSI_SOURCE gets you the smallest set of stuff, then _POSIX_C_SOURCE,
_XOPEN_SOURCE and _NETBSD_SOURCE in that order.

Tested by building for vax, encouraged by thorpej, and uncontested in
tech-userlevel for a week.

As with _REENTRANT, don't provide simple non-locking macro versions of
several functions when _PTHREADS is defined (usually via cc -pthread).

avoid TMP_MAX redefinition

Merge the nathanw_sa branch.

Spelling police. "__resitrct" was not spelled cirectly enough.

- 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).

* Move the prototype of __svfscanf from <stdio.h> to libc/stdio/local.h.
* Add prototype for vfscanf to <stdio.h>.
* Remove #define of vfscanf to __svfscanf from <stdio.h>.
* Include local.h in libc files which need __svfscanf.
* Add vfscanf weak alias to __svfscanf.

Fixes standards/16997.

NOTE: libc minor not bumped -- ride on the bump to 12.84 made by
itojun today.

Parameterize the vfscanf macro's arguments. Without them, 3rd party
software can become greatly confused.

This fixes 4 GCC 3.2 testsuite failures.

This is a stop-gap measure which can be easily applied to the 1.6
release branch. A different fix for the trunk is forthcoming.

Add a scanf format attribute to __svfscanf().

branches: 1.42.2;
- make FILE structure extensible without breaking binary-compatibility.
- add fputwc, fgetwc, fwide and related functions.
- add hooks needed to maintain the orientation of file stream.

branches: 1.41.2;
Sprinkle some __restrict into stdio.

protect against multiple declarations.

Move fmtcheck() prototype to stdio.h. It makes more sense to declare it
with the formatting functions with which it is meant to be used. Thanks
to Klaus Klein for "encouraging" me to make this change.

Avoid recursion with traditional cpp.

This is a HACK so that libc can compile with -ansi.

- Fix couple of typos.
- Protect some func. decls. added recently with __{BEGIN,END}_DECLS.

fix obvious typo

XCU5: Add fseeko() and ftello() functions which provide the functionality of
fseek() and ftell(), respectively, but operate on file offsets of type off_t.

Get rid of the inclusion of <sys/types.h> and define fpos_t using __off_t.

Move <null.h> to <sys/null.h> for the purpose of avoiding conflicts due to
std C headers including it, and a kernel module written in C++ would benfit
as well.

For the benefit of G++'s null pointer constant implementation, #define NULL
as __null with egcs 1.0 (GCC 2.90) and above. As several headers are affected
by this change, move the definition into a new header file, <null.h>, to ease
maintenance.

* Bring *_unlocked() declarations in scope if _REENTRANT is defined, too; add
similar protection for the definitions of the macro versions.
* Don't define a macro version of fileno() in a _REENTRANT environment.

Move 1003.1c-1995 declarations inside the appropriate name space protection
wrapper, and make sure we won't use these decl's as such with C++ linkage(!).
Also, make _XOPEN_SOURCE protection of popen()/pclose() decl's a bit more
restrictive.

Use __format__, __printf__ for consistency

add asprintf and vasprintf, originally written by Todd Miller for OpenBSD

__Namespace__ __protection__.

Nuke tmpnam() as well.

If __AUDIT__ is defined, remove some traditional interfaces: gets, sprintf,
vsprintf, tempnam, mktemp, getwd.

add missing backslash

Reorganize name space protection.

If standards-compliance is requested by defining the preprocessor symbols
_POSIX_SOURCE or _XOPEN_SOURCE at compile time, use __RENAME() to call
__posix_rename() instead of rename() in order to remove the requirement of
linking against libposix.

merge lite-2

Added function declarations for flockfile(), ftrylockfile(), funlockfile(),
getc_unlocked(), getchar_unlocked(), putc_unlocked(), & putchar_unlocked().
Added macro definitions for the latter four functions.

Changed so that getc(), putc(), clearerr(), feof() and ferror() macros
are not defined if _REENTRANT is defined so that thread-safe function
versions will be used instead.

Fix typo, __STRICT_ANSI_ -> __STRICT_ANSI__

Removed declarations for sys_nerr & sys_errlist (moved to errno.h)

change second arg of fgets() from size_t to int

Removed const qualifier from ftell's FILE * argument. It's not ANSI,
and the recent change to flush output causes it to be changed.

new RCS ID format.

_VA_LIST_ -> _BSD_VA_LIST_

add _BSD's to ansi types

fpos_t is now a 64-bit quantity

rename fgetline() and sharpen axe for bostic...

Add `const's to sys_errlist decl to match 4.4.

Use GCC's format attribute (for bug detection with -Wformat).

Restore define for L_cuserid and add cuserid prototype.
It was provided, but not documented.

cuserid() was removed by 1990's revision of 1003.1, and we never provided it
so don't define the L_cuserid constant.

fread and fwrite both return size_t, not int.

sscanf takes a const char * as the first arg; the man page was (already)
correct.

Add RCS identifiers.

`inline' is not present in gcc when -ansi is given; use __inline instead.

branches: 1.1.1;
Initial revision

move P_tmpdir from "/var/tmp/" to "/tmp/".

the main effect of this is to make GCC and other libiberty using
tools use /tmp instead of /var/tmp for compiler temp files,
which can be a bottleneck on larger systems.

a survey of other platforms shows only OSX also uses /var/tmp,
everyone else has switched to /tmp long ago.


cons: some smaller systems may have a smaller /tmp than /var/tmp,
and this may cause builds to fail with out of space earlier.
point the build to /var/tmp using TMPDIR in this case.

one can argue that setting TMPDIR would work around this, but we
want to have the effect for all users without having special setup.

gcc 5, my patience is waning.

Put fseeko, ftello, pread, and pwrite in the POSIX 2001 namespace.
Ok christos, apb, martin

One vscanf_l is ample.

PR/49715: Henning Petersen: Missing _*_DECLS in stdio.h around popenve.

add popenve().

add open_{,w}memstream

branches: 1.91.2;
cast to LHS type and minor KNF.

Fix use of getline and friends in C++ code.

Move declarations of getdelim() and getline() from the (incorrect) ANSI C
section to POSIX-2008. From Jarmo Jaakkola in PR standards/48788.

branches: 1.88.4;
add the signal safe prototypes

Don't pollute the name space with the various stdio macros for C++.

Add missing __BEGIN_DECLS/__END_DECLS.

Add scanf_l and wscanf_l families.

Add explicit locale versions for the printf family. Replace asprintf,
snprintf and sprintf with simple wrappers around the corresponding
va_list functions to reduce code duplication.

White space

branches: 1.82.2;
specify size of the array to help -fmudflap

funopen2()

branches: 1.80.2;
From tnozaki@: make fpos_t a complex object that keeps track of the parse
state of the stream. Change argument of the seek function to funopen() from
fpos_t to off_t. Make f{g,s}etpos() use the new fpos_t struct, while providing
backwards compatible entry points. Approved by releng@

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

add fmemopen(3) derrived from POSIX:2008.
libc minor bump.

Add dprintf and vdprintf. XXX: Might ifdef it if too many things break.

Consistently use __printflike and __scanflike.

branches: 1.75.2;
Use a proper char */size_t pair in __sfileext to keep track of the line
buffer for fgetln and fgetwln. Simplifies code by dropping the INT_MAX
related logic. Drop conditionals around FREELB, free(NULL) is valid.

Add implementations for getdelim(3) and getline(3).

branches: 1.73.6;
add missing attributes to the remaining calls, even the ones that gcc has
builtin attributes for (for symmetry and consistency). In the future this
might change to use compiler-neutral macros. On the other hand I don't
know of any other compiler that provides other macros with similar
functionality, so why bother?

Add _POSIX_HOST_NAME_MAX and _POSIX_SYMLOOP_MAX to <limits.h> and add some
references to them in <sys/param.h>
in <stdio.h> also export v*scanf when _ISOC99_SOURCE is defined

From andy dot shevchenko at gmail dot com.

branches: 1.71.4;
Since _file is a short, check that the fd fits in it, otherwise bail with
EMFILE. We treat _file as an unsigned short to double our range, with a
special case for -1 (closed). Make a note of what we should do about stdio
if we ever bump libc. We could change _file in the future compatibly to an
int by putting it in the extension space but for now we don't bother.

branches: 1.70.2; 1.70.6; 1.70.8;
Do not include SSP files unless _FORTIFY_SOURCE > 0.

Match usage of FORTIFY_SOURCE on other platforms by not requiring special
include path: the normal header files now include the "SSP" ones (which one
should note are not really named right: SSP and FORTIFY_SOURCE are independent
features).

Disable USE_SSP on targets where the compiler doesn't support it at all
(mips, alpha) or it's known broken (sh3). But enable FORTIFY_SOURCE,
without SSP, on those platforms -- tested on mipsel.

remove __SAFE

defined(_NETBSD_SOURCE) is equivalent to (!defined(_ANSI_SOURCE) &&
!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)), so there's no
need to check both of them.

branches: 1.66.2;
Don't expose _ss functions for 4.0. Requested by core.

- flags should be unsigned short instead of short.
- add __SAFE flag, to indicate that we want async-signal-safe functionality
only.
- add snprintf_ss, and vsnprintf_ss; these are undocumented on purpose.

add __BEGIN_DECLS/__END_DECLS around snprintf() & vsnprintf() prototypes.

inline -> __inline for selected things (specifically, the header
file is POSIX visible and the usage isn't #ifdef _KERNEL)

Discussed with core. I may need to go farther than this but for now
compilations done with gcc -ansi (i.e. firefox) will be okay.

Remove leading __ from __(const|inline|signed|volatile) -- it is obsolete.

Include <sys/ansi.h> after <sys/cdefs.h>; from Neil Booth in PR lib/30072.

Belatedly move snprintf() and vnsnprintf() into the XPG4.2/C99 section.

Add restrict qualifiers to fopen()/freopen() arguments.

branches: 1.58.2;
A little libc namespace housekeeping exercise:
* Make vfprintf_unlocked() an internal function, c.f. __svfscanf_unlocked().
* Add internal names for arc4random(), endnetpath(), fhstatvfs(),
fstatvfs(), mkstemp(), shquote(), statvfs(), taddr2uaddr(), uaddr2taddr(),
uuid_create_nil(), uuid_is_nil(), and wcwidth().
* Include namespace.h where supposed to.

de-__P -- the hack is long since useless. Discussed with christos,
matt, kleink, others. Approved by christos.

Tidy up the namespace: lint -> __lint__.

remove fgetstr() from public sight

add fgetstr

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

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

P_tmpdir isn't in POSIX, so only define it for _XOPEN_SOURCE and
_NETBSD_SOURCE.

Add a new feature-test macro, _NETBSD_SOURCE. If this is defined
by the application, all NetBSD interfaces are made visible, even
if some other feature-test macro (like _POSIX_C_SOURCE) is defined.
<sys/featuretest.h> defined _NETBSD_SOURCE if none of _ANSI_SOURCE,
_POSIX_C_SOURCE and _XOPEN_SOURCE is defined, so as to preserve
existing behaviour.

This has two major advantages:
+ Programs that require non-POSIX facilities but define _POSIX_C_SOURCE
can trivially be overruled by putting -D_NETBSD_SOURCE in their CFLAGS.
+ It makes most of the #ifs simpler, in that they're all now ORs of the
various macros, rather than having checks for (!defined(_ANSI_SOURCE) ||
!defined(_POSIX_C_SOURCE) || !defined(_XOPEN_SOURCE)) all over the place.

I've tried not to change the semantics of the headers in any case where
_NETBSD_SOURCE wasn't defined, but there were some places where the
current semantics were clearly mad, and retaining them was harder than
correcting them. In particular, I've mostly normalised things so that
_ANSI_SOURCE gets you the smallest set of stuff, then _POSIX_C_SOURCE,
_XOPEN_SOURCE and _NETBSD_SOURCE in that order.

Tested by building for vax, encouraged by thorpej, and uncontested in
tech-userlevel for a week.

As with _REENTRANT, don't provide simple non-locking macro versions of
several functions when _PTHREADS is defined (usually via cc -pthread).

avoid TMP_MAX redefinition

Merge the nathanw_sa branch.

Spelling police. "__resitrct" was not spelled cirectly enough.

- 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).

* Move the prototype of __svfscanf from <stdio.h> to libc/stdio/local.h.
* Add prototype for vfscanf to <stdio.h>.
* Remove #define of vfscanf to __svfscanf from <stdio.h>.
* Include local.h in libc files which need __svfscanf.
* Add vfscanf weak alias to __svfscanf.

Fixes standards/16997.

NOTE: libc minor not bumped -- ride on the bump to 12.84 made by
itojun today.

Parameterize the vfscanf macro's arguments. Without them, 3rd party
software can become greatly confused.

This fixes 4 GCC 3.2 testsuite failures.

This is a stop-gap measure which can be easily applied to the 1.6
release branch. A different fix for the trunk is forthcoming.

Add a scanf format attribute to __svfscanf().

branches: 1.42.2;
- make FILE structure extensible without breaking binary-compatibility.
- add fputwc, fgetwc, fwide and related functions.
- add hooks needed to maintain the orientation of file stream.

branches: 1.41.2;
Sprinkle some __restrict into stdio.

protect against multiple declarations.

Move fmtcheck() prototype to stdio.h. It makes more sense to declare it
with the formatting functions with which it is meant to be used. Thanks
to Klaus Klein for "encouraging" me to make this change.

Avoid recursion with traditional cpp.

This is a HACK so that libc can compile with -ansi.

- Fix couple of typos.
- Protect some func. decls. added recently with __{BEGIN,END}_DECLS.

fix obvious typo

XCU5: Add fseeko() and ftello() functions which provide the functionality of
fseek() and ftell(), respectively, but operate on file offsets of type off_t.

Get rid of the inclusion of <sys/types.h> and define fpos_t using __off_t.

Move <null.h> to <sys/null.h> for the purpose of avoiding conflicts due to
std C headers including it, and a kernel module written in C++ would benfit
as well.

For the benefit of G++'s null pointer constant implementation, #define NULL
as __null with egcs 1.0 (GCC 2.90) and above. As several headers are affected
by this change, move the definition into a new header file, <null.h>, to ease
maintenance.

* Bring *_unlocked() declarations in scope if _REENTRANT is defined, too; add
similar protection for the definitions of the macro versions.
* Don't define a macro version of fileno() in a _REENTRANT environment.

Move 1003.1c-1995 declarations inside the appropriate name space protection
wrapper, and make sure we won't use these decl's as such with C++ linkage(!).
Also, make _XOPEN_SOURCE protection of popen()/pclose() decl's a bit more
restrictive.

Use __format__, __printf__ for consistency

add asprintf and vasprintf, originally written by Todd Miller for OpenBSD

__Namespace__ __protection__.

Nuke tmpnam() as well.

If __AUDIT__ is defined, remove some traditional interfaces: gets, sprintf,
vsprintf, tempnam, mktemp, getwd.

add missing backslash

Reorganize name space protection.

If standards-compliance is requested by defining the preprocessor symbols
_POSIX_SOURCE or _XOPEN_SOURCE at compile time, use __RENAME() to call
__posix_rename() instead of rename() in order to remove the requirement of
linking against libposix.

merge lite-2

Added function declarations for flockfile(), ftrylockfile(), funlockfile(),
getc_unlocked(), getchar_unlocked(), putc_unlocked(), & putchar_unlocked().
Added macro definitions for the latter four functions.

Changed so that getc(), putc(), clearerr(), feof() and ferror() macros
are not defined if _REENTRANT is defined so that thread-safe function
versions will be used instead.

Fix typo, __STRICT_ANSI_ -> __STRICT_ANSI__

Removed declarations for sys_nerr & sys_errlist (moved to errno.h)

change second arg of fgets() from size_t to int

Removed const qualifier from ftell's FILE * argument. It's not ANSI,
and the recent change to flush output causes it to be changed.

new RCS ID format.

_VA_LIST_ -> _BSD_VA_LIST_

add _BSD's to ansi types

fpos_t is now a 64-bit quantity

rename fgetline() and sharpen axe for bostic...

Add `const's to sys_errlist decl to match 4.4.

Use GCC's format attribute (for bug detection with -Wformat).

Restore define for L_cuserid and add cuserid prototype.
It was provided, but not documented.

cuserid() was removed by 1990's revision of 1003.1, and we never provided it
so don't define the L_cuserid constant.

fread and fwrite both return size_t, not int.

sscanf takes a const char * as the first arg; the man page was (already)
correct.

Add RCS identifiers.

`inline' is not present in gcc when -ansi is given; use __inline instead.

branches: 1.1.1;
Initial revision

gcc 5, my patience is waning.

Put fseeko, ftello, pread, and pwrite in the POSIX 2001 namespace.
Ok christos, apb, martin

One vscanf_l is ample.

PR/49715: Henning Petersen: Missing _*_DECLS in stdio.h around popenve.

add popenve().

add open_{,w}memstream

branches: 1.91.2;
cast to LHS type and minor KNF.

Fix use of getline and friends in C++ code.

Move declarations of getdelim() and getline() from the (incorrect) ANSI C
section to POSIX-2008. From Jarmo Jaakkola in PR standards/48788.

branches: 1.88.4;
add the signal safe prototypes

Don't pollute the name space with the various stdio macros for C++.

Add missing __BEGIN_DECLS/__END_DECLS.

Add scanf_l and wscanf_l families.

Add explicit locale versions for the printf family. Replace asprintf,
snprintf and sprintf with simple wrappers around the corresponding
va_list functions to reduce code duplication.

White space

branches: 1.82.2;
specify size of the array to help -fmudflap

funopen2()

branches: 1.80.2;
From tnozaki@: make fpos_t a complex object that keeps track of the parse
state of the stream. Change argument of the seek function to funopen() from
fpos_t to off_t. Make f{g,s}etpos() use the new fpos_t struct, while providing
backwards compatible entry points. Approved by releng@

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

add fmemopen(3) derrived from POSIX:2008.
libc minor bump.

Add dprintf and vdprintf. XXX: Might ifdef it if too many things break.

Consistently use __printflike and __scanflike.

branches: 1.75.2;
Use a proper char */size_t pair in __sfileext to keep track of the line
buffer for fgetln and fgetwln. Simplifies code by dropping the INT_MAX
related logic. Drop conditionals around FREELB, free(NULL) is valid.

Add implementations for getdelim(3) and getline(3).

branches: 1.73.6;
add missing attributes to the remaining calls, even the ones that gcc has
builtin attributes for (for symmetry and consistency). In the future this
might change to use compiler-neutral macros. On the other hand I don't
know of any other compiler that provides other macros with similar
functionality, so why bother?

Add _POSIX_HOST_NAME_MAX and _POSIX_SYMLOOP_MAX to <limits.h> and add some
references to them in <sys/param.h>
in <stdio.h> also export v*scanf when _ISOC99_SOURCE is defined

From andy dot shevchenko at gmail dot com.

branches: 1.71.4;
Since _file is a short, check that the fd fits in it, otherwise bail with
EMFILE. We treat _file as an unsigned short to double our range, with a
special case for -1 (closed). Make a note of what we should do about stdio
if we ever bump libc. We could change _file in the future compatibly to an
int by putting it in the extension space but for now we don't bother.

branches: 1.70.2; 1.70.6; 1.70.8;
Do not include SSP files unless _FORTIFY_SOURCE > 0.

Match usage of FORTIFY_SOURCE on other platforms by not requiring special
include path: the normal header files now include the "SSP" ones (which one
should note are not really named right: SSP and FORTIFY_SOURCE are independent
features).

Disable USE_SSP on targets where the compiler doesn't support it at all
(mips, alpha) or it's known broken (sh3). But enable FORTIFY_SOURCE,
without SSP, on those platforms -- tested on mipsel.

remove __SAFE

defined(_NETBSD_SOURCE) is equivalent to (!defined(_ANSI_SOURCE) &&
!defined(_POSIX_C_SOURCE) && !defined(_XOPEN_SOURCE)), so there's no
need to check both of them.

branches: 1.66.2;
Don't expose _ss functions for 4.0. Requested by core.

- flags should be unsigned short instead of short.
- add __SAFE flag, to indicate that we want async-signal-safe functionality
only.
- add snprintf_ss, and vsnprintf_ss; these are undocumented on purpose.

add __BEGIN_DECLS/__END_DECLS around snprintf() & vsnprintf() prototypes.

inline -> __inline for selected things (specifically, the header
file is POSIX visible and the usage isn't #ifdef _KERNEL)

Discussed with core. I may need to go farther than this but for now
compilations done with gcc -ansi (i.e. firefox) will be okay.

Remove leading __ from __(const|inline|signed|volatile) -- it is obsolete.

Include <sys/ansi.h> after <sys/cdefs.h>; from Neil Booth in PR lib/30072.

Belatedly move snprintf() and vnsnprintf() into the XPG4.2/C99 section.

Add restrict qualifiers to fopen()/freopen() arguments.

branches: 1.58.2;
A little libc namespace housekeeping exercise:
* Make vfprintf_unlocked() an internal function, c.f. __svfscanf_unlocked().
* Add internal names for arc4random(), endnetpath(), fhstatvfs(),
fstatvfs(), mkstemp(), shquote(), statvfs(), taddr2uaddr(), uaddr2taddr(),
uuid_create_nil(), uuid_is_nil(), and wcwidth().
* Include namespace.h where supposed to.

de-__P -- the hack is long since useless. Discussed with christos,
matt, kleink, others. Approved by christos.

Tidy up the namespace: lint -> __lint__.

remove fgetstr() from public sight

add fgetstr

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

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

P_tmpdir isn't in POSIX, so only define it for _XOPEN_SOURCE and
_NETBSD_SOURCE.

Add a new feature-test macro, _NETBSD_SOURCE. If this is defined
by the application, all NetBSD interfaces are made visible, even
if some other feature-test macro (like _POSIX_C_SOURCE) is defined.
<sys/featuretest.h> defined _NETBSD_SOURCE if none of _ANSI_SOURCE,
_POSIX_C_SOURCE and _XOPEN_SOURCE is defined, so as to preserve
existing behaviour.

This has two major advantages:
+ Programs that require non-POSIX facilities but define _POSIX_C_SOURCE
can trivially be overruled by putting -D_NETBSD_SOURCE in their CFLAGS.
+ It makes most of the #ifs simpler, in that they're all now ORs of the
various macros, rather than having checks for (!defined(_ANSI_SOURCE) ||
!defined(_POSIX_C_SOURCE) || !defined(_XOPEN_SOURCE)) all over the place.

I've tried not to change the semantics of the headers in any case where
_NETBSD_SOURCE wasn't defined, but there were some places where the
current semantics were clearly mad, and retaining them was harder than
correcting them. In particular, I've mostly normalised things so that
_ANSI_SOURCE gets you the smallest set of stuff, then _POSIX_C_SOURCE,
_XOPEN_SOURCE and _NETBSD_SOURCE in that order.

Tested by building for vax, encouraged by thorpej, and uncontested in
tech-userlevel for a week.