Go to file
H.J. Lu 126adc89d8 Document that --enable-static-pie implies PIE
To build static PIE, all .o files are compiled with -fPIE.  Since
--enable-static-pie is designed to provide additional security hardening
benefits, it also implies that glibc programs and tests are created as
dynamic position independent executables (PIE) by default for better
security hardening.

Reviewed-by: Jonathan Nieder <jrnieder@gmail.com>

	* manual/install.texi: Document that --enable-static-pie
	implies PIE.
	* INSTALL: Regenerated.
2017-12-19 13:51:16 -08:00
ChangeLog.old Add missing reference to bug 21654 2017-10-07 13:14:36 +02:00
argp Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
assert Fix position of tests-unsupported definition in assert/Makefile. 2017-08-22 00:30:51 +00:00
benchtests Convert strcmp benchmark output to json format 2017-12-15 02:31:41 +05:30
bits Linux/x86: Update cancel_jmp_buf to match __jmp_buf_tag [BZ #22563] 2017-12-19 02:44:04 -08:00
catgets Don't compile non-lib modules as lib modules [BZ #21864] 2017-08-21 05:34:54 -07:00
conform Fix mcontext_t sigcontext namespace (bug 21457). 2017-08-30 22:02:04 +00:00
crypt Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
csu Add --enable-static-pie configure option to build static PIE [BZ #19574] 2017-12-15 17:12:14 -08:00
ctype Use locale_t, not __locale_t, throughout glibc 2017-06-20 20:30:06 -04:00
debug Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
dev Rename xlocale.h to bits/types/__locale_t.h. 2017-06-20 20:28:11 -04:00
dirent Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
dlfcn ld.so: Examine GLRO to detect inactive loader [BZ #20204] 2017-12-18 20:04:13 +01:00
elf ld.so: Examine GLRO to detect inactive loader [BZ #20204] 2017-12-18 20:04:13 +01:00
gmon Add --enable-static-pie configure option to build static PIE [BZ #19574] 2017-12-15 17:12:14 -08:00
gnulib Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
grp Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
gshadow Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
hesiod Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
hurd hurd: fix gethostname(NULL, 0) 2017-09-07 00:51:17 +02:00
iconv Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
iconvdata Add new codepage charmaps/IBM858 [BZ #21084] 2017-09-14 15:50:57 +02:00
include Properly compute offsets of note descriptor and next note [BZ #22370] 2017-11-28 09:57:00 -08:00
inet Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
intl Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
io Fix testing with read-only source directory. 2017-12-15 22:37:17 +00:00
libidn Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
libio ld.so: Examine GLRO to detect inactive loader [BZ #20204] 2017-12-18 20:04:13 +01:00
locale Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
localedata lt_LT locale: Base collation on copy "iso14651_t1" [BZ #22524] 2017-12-07 15:38:11 +01:00
login Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
mach hurd: Remove duplicate symbol version 2017-08-28 14:19:55 +02:00
malloc Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
manual Document that --enable-static-pie implies PIE 2017-12-19 13:51:16 -08:00
math Revert exp reimplementation (causes test failures). 2017-12-19 18:11:37 +00:00
mathvec Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
misc Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
nis nss: Export nscd hash function as __nss_hash [BZ #22459] 2017-11-23 14:08:11 +01:00
nptl Linux/x86: Update cancel_jmp_buf to match __jmp_buf_tag [BZ #22563] 2017-12-19 02:44:04 -08:00
nptl_db Move all old ChangeLogs to a top-level ChangeLog.old directory. 2017-09-01 09:31:43 -04:00
nscd Fix nscd readlink argument aliasing (bug 22446). 2017-12-18 18:50:40 +00:00
nss nss: Export nscd hash function as __nss_hash [BZ #22459] 2017-11-23 14:08:11 +01:00
po Do not build .mo files in source directory (bug 14121). 2017-12-15 14:27:20 +00:00
posix glob: Silence warning about void pointer arithmetic 2017-12-19 15:52:12 -02:00
pwd Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
resolv Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
resource Hide internal __setrlimit function [BZ #18822] 2017-10-01 17:46:54 -07:00
rt Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
scripts Add --enable-static-pie variants to x86_64, x32 and i686 2017-12-18 18:11:47 -08:00
setjmp x86: Make a space in jmpbuf for shadow stack pointer 2017-11-30 04:58:01 -08:00
shadow Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
signal Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
socket __opensock: Remove internal_function attribute 2017-08-17 10:18:15 +02:00
soft-fp Add sysdeps/ieee754/soft-fp. 2017-12-12 23:35:21 +00:00
stdio-common Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
stdlib Fix testing with read-only source directory. 2017-12-15 22:37:17 +00:00
streams Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
string Disable strncat test array-bounds warnings for GCC 8. 2017-12-18 22:52:41 +00:00
sunrpc Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
support support: Simplify compiling most of support/ outside of glibc 2017-12-14 13:48:56 +01:00
sysdeps Avoid signed shift overflow in pow (bug 21309). 2017-12-19 18:41:01 +00:00
sysvipc Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
termios Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
time Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
timezone Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
wcsmbs Replace = with += in CFLAGS-xxx.c/CPPFLAGS-xxx.c 2017-12-11 13:11:33 -08:00
wctype Use locale_t, not __locale_t, throughout glibc 2017-06-20 20:30:06 -04: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
COPYING
COPYING.LIB
ChangeLog Document that --enable-static-pie implies PIE 2017-12-19 13:51:16 -08:00
INSTALL Document that --enable-static-pie implies PIE 2017-12-19 13:51:16 -08:00
LICENSES
MAINTAINERS Add MAINTAINERS 2017-05-11 13:38:30 -04:00
Makeconfig Pass -no-pie to GCC only if GCC defaults to PIE [BZ #22614] 2017-12-18 12:24:38 -08:00
Makefile Remove add-ons mechanism. 2017-10-05 15:58:13 +00:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Use newly built crt*.o files to build shared objects [BZ #22362] 2017-11-06 08:29:57 -08:00
NEWS Update NEWS with aarch64 static pie support 2017-12-18 16:57:07 +00:00
README Require Linux kernel 3.2 or later on x86 / x86_64. 2017-05-08 10:45:20 +00:00
Rules Suppress internal declarations for most of the testsuite. 2017-05-11 19:27:59 -04:00
abi-tags Remove the bulk of the NaCl port. 2017-05-20 08:09:10 -04:00
aclocal.m4 gmon: Add test for basic mcount/gprof functionality 2017-08-15 15:49:45 +02:00
config.h.in Add --enable-static-pie configure option to build static PIE [BZ #19574] 2017-12-15 17:12:14 -08:00
config.make.in Pass -no-pie to GCC only if GCC defaults to PIE [BZ #22614] 2017-12-18 12:24:38 -08:00
configure Pass -no-pie to GCC only if GCC defaults to PIE [BZ #22614] 2017-12-18 12:24:38 -08:00
configure.ac Pass -no-pie to GCC only if GCC defaults to PIE [BZ #22614] 2017-12-18 12:24:38 -08: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
libc-abis
libof-iterator.mk Rename cppflags-iterator.mk to libof-iterator.mk, remove extra-modules.mk. 2017-05-09 07:06:29 -04:00
o-iterator.mk
shlib-versions Extend NSS test suite 2017-07-17 15:52:44 -04:00
test-skeleton.c Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
version.h version.h: Switch to ".9000" as the suffix for the development version 2017-10-16 21:39:18 +02:00

README

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.  The current
GNU/Hurd support requires out-of-tree patches that will eventually be
incorporated into an official GNU C Library release.

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
	arm-*-linux-gnueabi
	hppa-*-linux-gnu	Not currently functional without patches.
	i[4567]86-*-linux-gnu
	x86_64-*-linux-gnu	Can build either x86_64 or x32
	ia64-*-linux-gnu
	m68k-*-linux-gnu
	microblaze*-*-linux-gnu
	mips-*-linux-gnu
	mips64-*-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
	sh[34]-*-linux-gnu
	sparc*-*-linux-gnu
	sparc64*-*-linux-gnu
	tilegx-*-linux-gnu
	tilepro-*-linux-gnu

If you are interested in doing a port, please contact the glibc
maintainers; see http://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 http://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 http://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.