Go to file
Siddhesh Poyarekar 3d3a2911ba Add _FORTIFY_SOURCE implementation documentation [BZ #28998]
There have been multiple requests to provide more detail on how the
_FORTIFY_SOURCE macro works, so this patch adds a new node in the
Library Maintenance section that does this.  A lot of the description is
implementation detail, which is why I put this in the appendix and not
in the main documentation.

Resolves: BZ #28998.
Signed-off-by: Siddhesh Poyarekar <siddhesh@sourceware.org>
Reviewed-by: Florian Weimer <fweimer@redhat.com>
2023-01-10 10:22:38 -05:00
argp Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
assert Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
benchtests Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
bits Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
catgets Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
ChangeLog.old Create ChangeLog.old/ChangeLog.25. 2022-07-29 18:03:09 -04:00
conform Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
crypt Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
csu Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
ctype Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
debug Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
dirent Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
dlfcn Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
elf Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
gmon Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
gnulib Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
grp Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
gshadow Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
hesiod Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
htl Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
hurd Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
iconv Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
iconvdata Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
include Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
inet Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
intl Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
io Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
libio Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
locale Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
localedata Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
login Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
mach Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
malloc Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
manual Add _FORTIFY_SOURCE implementation documentation [BZ #28998] 2023-01-10 10:22:38 -05:00
math Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
mathvec Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
misc Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
nis Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
nptl Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
nptl_db Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
nscd Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
nss Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
po Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
posix Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
pwd Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
resolv Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
resource Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
rt Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
scripts Update copyright dates not handled by scripts/update-copyrights 2023-01-06 21:45:36 +00:00
setjmp Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
shadow Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
signal Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
socket Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
soft-fp Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
stdio-common Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
stdlib Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
string Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
sunrpc Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
support Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
sysdeps Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
sysvipc Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
termios Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
time Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
timezone Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
wcsmbs Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
wctype Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
.clang-format Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
.gitattributes Assume __NR_openat is always defined 2016-03-23 23:35:08 +01:00
.gitignore Add *.pyc to .gitignore 2015-05-18 15:26:26 +05:30
abi-tags Remove the bulk of the NaCl port. 2017-05-20 08:09:10 -04:00
aclocal.m4 configure: Remove AS check 2022-12-06 09:40:19 -03:00
config.h.in LoongArch: Add LoongArch entries to config.h.in 2022-07-26 12:35:12 -03:00
config.make.in Revert "Detect ld.so and libc.so version inconsistency during startup" 2022-08-25 18:46:43 +02:00
configure configure: Remove AS check 2022-12-06 09:40:19 -03:00
configure.ac configure: Remove AS check 2022-12-06 09:40:19 -03:00
CONTRIBUTED-BY Remove "Contributed by" lines 2021-09-03 22:06:44 +05:30
COPYING Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
COPYING.LIB Update to latest versions of GPL-2.0 and LGPL-2.1 2013-09-09 12:52:48 +10:00
extra-lib.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
gen-locales.mk Improve gen-locales.mk and gen-locale.sh to make test files with @ options work 2018-02-27 17:01:57 +01:00
INSTALL Revert "Detect ld.so and libc.so version inconsistency during startup" 2022-08-25 18:46:43 +02:00
libc-abis riscv: support GNU indirect function 2021-01-10 21:25:13 -05:00
libof-iterator.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
LICENSES arc4random: simplify design for better safety 2022-07-27 08:58:27 -03:00
MAINTAINERS Add MAINTAINERS 2017-05-11 13:38:30 -04:00
Makeconfig Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
Makefile Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
Makefile.help Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
NEWS Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
o-iterator.mk Fri Mar 17 12:58:37 1995 Roland McGrath <roland@churchy.gnu.ai.mit.edu> 1995-03-17 18:42:51 +00:00
README LoongArch: Update NEWS and README for the LoongArch port. 2022-07-26 12:35:12 -03:00
Rules Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
SHARED-FILES Mention today's regex merge in SHARED-FILES 2021-09-21 18:00:10 -07:00
shlib-versions nss: Do not mention NSS test modules in <gnu/lib-names.h> 2022-03-11 08:24:04 +01:00
test-skeleton.c Update copyright dates with scripts/update-copyrights 2023-01-06 21:14:39 +00:00
version.h Open master branch for glibc 2.37 development 2022-07-30 15:34:51 -04:00

This directory contains the sources of the GNU C Library.
See the file "version.h" for what release version you have.

The GNU C Library is the standard system C library for all GNU systems,
and is an important part of what makes up a GNU system.  It provides the
system API for all programs written in C and C-compatible languages such
as C++ and Objective C; the runtime facilities of other programming
languages use the C library to access the underlying operating system.

In GNU/Linux systems, the C library works with the Linux kernel to
implement the operating system behavior seen by user applications.
In GNU/Hurd systems, it works with a microkernel and Hurd servers.

The GNU C Library implements much of the POSIX.1 functionality in the
GNU/Hurd system, using configurations i[4567]86-*-gnu.

When working with Linux kernels, this version of the GNU C Library
requires Linux kernel version 3.2 or later.

Also note that the shared version of the libgcc_s library must be
installed for the pthread library to work correctly.

The GNU C Library supports these configurations for using Linux kernels:

	aarch64*-*-linux-gnu
	alpha*-*-linux-gnu
	arc*-*-linux-gnu
	arm-*-linux-gnueabi
	csky-*-linux-gnuabiv2
	hppa-*-linux-gnu
	i[4567]86-*-linux-gnu
	x86_64-*-linux-gnu	Can build either x86_64 or x32
	ia64-*-linux-gnu
	loongarch64-*-linux-gnu Hardware floating point, LE only.
	m68k-*-linux-gnu
	microblaze*-*-linux-gnu
	mips-*-linux-gnu
	mips64-*-linux-gnu
	or1k-*-linux-gnu
	powerpc-*-linux-gnu	Hardware or software floating point, BE only.
	powerpc64*-*-linux-gnu	Big-endian and little-endian.
	s390-*-linux-gnu
	s390x-*-linux-gnu
	riscv32-*-linux-gnu
	riscv64-*-linux-gnu
	sh[34]-*-linux-gnu
	sparc*-*-linux-gnu
	sparc64*-*-linux-gnu

If you are interested in doing a port, please contact the glibc
maintainers; see https://www.gnu.org/software/libc/ for more
information.

See the file INSTALL to find out how to configure, build, and install
the GNU C Library.  You might also consider reading the WWW pages for
the C library at https://www.gnu.org/software/libc/.

The GNU C Library is (almost) completely documented by the Texinfo manual
found in the `manual/' subdirectory.  The manual is still being updated
and contains some known errors and omissions; we regret that we do not
have the resources to work on the manual as much as we would like.  For
corrections to the manual, please file a bug in the `manual' component,
following the bug-reporting instructions below.  Please be sure to check
the manual in the current development sources to see if your problem has
already been corrected.

Please see https://www.gnu.org/software/libc/bugs.html for bug reporting
information.  We are now using the Bugzilla system to track all bug reports.
This web page gives detailed information on how to report bugs properly.

The GNU C Library is free software.  See the file COPYING.LIB for copying
conditions, and LICENSES for notices about a few contributions that require
these additional notices to be distributed.  License copyright years may be
listed using range notation, e.g., 1996-2015, indicating that every year in
the range, inclusive, is a copyrightable year that would otherwise be listed
individually.