cdefs.h: Add warning about defining __BSD_VISIBLE and friends

Undefined things happen if users define these macros, be more explicit
about documenting that.

Sponsored by: Netflix

cdefs.9: Note only one programming environment at a time

Only one programming environment at a time can be defined at a
time. Posix states that when defining _POSIX_C_SOURCE, the system
headers must

cdefs.9: Note only one programming environment at a time

Only one programming environment at a time can be defined at a
time. Posix states that when defining _POSIX_C_SOURCE, the system
headers must define only the macros, variables, and functions that a
given standard level defines. Selecting a different macro along with
this is fundamentally incompatible with that.

Sponsored by: Netflix

show more ...

cdefs: Add __deprecated1 which accepts a message as an argument

This message will be included in any warning issued by the compiler
for use of the deprecated function.

Reviewed by: imp
Differential

cdefs: Add __deprecated1 which accepts a message as an argument

This message will be included in any warning issued by the compiler
for use of the deprecated function.

Reviewed by: imp
Differential Revision: https://reviews.freebsd.org/D47701

show more ...

cdefs: Document what we do when _XOPEN_SOURCE is an empty string

X/Open originally had _XOPEN_SOURCE defined to signify conformance with
the Single Unix Specification, starting with its third iterat

cdefs: Document what we do when _XOPEN_SOURCE is an empty string

X/Open originally had _XOPEN_SOURCE defined to signify conformance with
the Single Unix Specification, starting with its third iteration. There
it defined _XOPEN_SOURCE being defined as the same thing as
_POSIC_C_SOURCE=2, though the different versions of the spec had slight
variances as to what's defined and wheter or not _XOPEN_SOURCE_EXTENSION
needed to be defined. Document that we don't do anything in this case.
It turns out that enabling the proper strict environment breaks at least
some old software, so for the moment it's a nop until that can be sorted
out (though that is a very low proprity task).

Sponsored by: Netflix

show more ...

cdefs.h: Fix bad version

It's -isoC-2024 not -isoC2023. Fix it

Noticed by: gperciva@tarsnap.com
Sponsored by: Netflix

cdefs: update for C23 and POSIX24

Also tweak a few placs where we can now use macros for C23 and POSIX24.

Sponsored by: Netflix
Differential Revision: https://reviews.freebsd.org/D47580

cdefs: Add __deprecated

Add __deprecated decorator. This is for a deprecated interface. copystr
is tagged with this today in copy(9), but don't actually provide it or
use it. copystr is a #define so

cdefs: Add __deprecated

Add __deprecated decorator. This is for a deprecated interface. copystr
is tagged with this today in copy(9), but don't actually provide it or
use it. copystr is a #define so adding it will have to wait.

LinuxKPI was defining this away completely in compiler.h. Since this is
shared between Linux KPI consumers and OpenZFS, if it's already defined,
use the FreeBSD sys/cdefs.h version, otherwise define it away. For
OpenZFS this will retain it, while for Linux KPI it will tend to drop it
(I think always, but I didn't look at everything).

Sponsored by: Netflix
Reviewed by: jhb, emaste
Differential Revision: https://reviews.freebsd.org/D46137

show more ...

manuals: Misc syntax fixes

These were reported by `mandoc -T lint ...` as errors.

The rendered output (in ascii and html) is not affected by this commit.

Signed-off-by: Graham Percival <gperciva@t

manuals: Misc syntax fixes

These were reported by `mandoc -T lint ...` as errors.

The rendered output (in ascii and html) is not affected by this commit.

Signed-off-by: Graham Percival <gperciva@tarsnap.com>
Reviewed by: mhorne
MFC after: 3 days
Sponsored by: Tarsnap Backup Inc.
Pull Request: https://github.com/freebsd/freebsd-src/pull/1459

show more ...

manuals: Fix "missing end of block" errors

These were reported by `mandoc -T lint ...` as errors.

The rendered output (in ascii and html) is not affected by this commit.

Signed-off-by: Graham Perc

manuals: Fix "missing end of block" errors

These were reported by `mandoc -T lint ...` as errors.

The rendered output (in ascii and html) is not affected by this commit.

Signed-off-by: Graham Percival <gperciva@tarsnap.com>
Reviewed by: mhorne, Alexander Ziaee <concussious.bugzilla@runbox.com>
MFC after: 3 days
Sponsored by: Tarsnap Backup Inc.
Pull Request: https://github.com/freebsd/freebsd-src/pull/1454

show more ...

manuals: Misc syntax fixes

These were reported by `mandoc -T lint ...` as errors.

Signed-off-by: Graham Percival <gperciva@tarsnap.com>
Reviewed by: mhorne
MFC after: 3 days
Sponsored by: Tarsnap B

manuals: Misc syntax fixes

These were reported by `mandoc -T lint ...` as errors.

Signed-off-by: Graham Percival <gperciva@tarsnap.com>
Reviewed by: mhorne
MFC after: 3 days
Sponsored by: Tarsnap Backup Inc.
Pull Request: https://github.com/freebsd/freebsd-src/pull/1453

show more ...

cdefs.9: Update for C++ environments

We support all the C++ standards to some degree. However, pre C++11
standard support has been disappearing upstream, so also add a note
about -pedantic-errors mi

cdefs.9: Update for C++ environments

We support all the C++ standards to some degree. However, pre C++11
standard support has been disappearing upstream, so also add a note
about -pedantic-errors might not work for earlier standards. Add note
about __cplusplus values.

Sponsored by: Netflix

show more ...

cdefs.9: Fix clang version, and gcc version

There's no clang 19 that we support, so remove that from the list.
Also, jhb will soon commit gcc 14 support, so add it while I'm here so I
don't forget l

cdefs.9: Fix clang version, and gcc version

There's no clang 19 that we support, so remove that from the list.
Also, jhb will soon commit gcc 14 support, so add it while I'm here so I
don't forget later.

Submited by: jhb
Sponsored by: Netflix

show more ...

cdefs(9): Start to document what sys/cdefs.h does

Start to document all the macros and such used to implment our
portability layer. It also describes what compilation environments
we support, what c

cdefs(9): Start to document what sys/cdefs.h does

Start to document all the macros and such used to implment our
portability layer. It also describes what compilation environments
we support, what compilers we support and some of the details.

This is round one. All the macros, etc are in here, but some need
descriptions.

These macros, while FreeBSD internal only, do need documentation
on when/where to use them.

This man page likely needs better organization. While better
than sys/cdefs.h, the underlying chaos in that file was hard
to leave completely behind. Suggestions welcome.

Feedback by: mhorne, Graham Perrin, Alexander Ziaee
Sponsored by: Netflix
Pull Request: https://github.com/freebsd/freebsd-src/pull/1313

show more ...