Go to file
Zack Weinberg aeacb9f912 getopt: merge from gnulib: alloca avoidance
In one place, glibc's getopt uses alloca to construct a linked list of
possibilities for an "ambiguous" long option.  In gnulib, malloc
should be used instead.  Providing for both cases complicates things a
fair bit.  Instead of merging straight across, therefore, I have
chosen to rewrite it using a boolean vector instead of a linked list.
There is then only one allocation that might need freeing; in glibc it
can honor __libc_use_alloca as usual, and in gnulib we define
__libc_use_alloca to always be false, so we don't need ifdefs in the
middle of the function.  This should also be slightly more efficient
in the normal case of long options being fully spelled out -- I think
most people aren't even aware they _can_ sometimes abbreviate long
options.

One interesting consequence is that the list of possibilities is now
printed in exactly the order they appear in the list of long options,
instead of the first possibility being shuffled to the end.  This
shouldn't be a big deal but it did break one test that relied on the
exact text of this error message.

(The reason the previous patch was "in aid of" merging from gnulib is
I didn't want to have to make this change in two places.)

(The patch looks bigger than it really is because there's a fair bit
of reindentation and code rearrangement.)

	* posix/getopt.c: When used standalone, define __libc_use_alloca
	as always false and alloca to abort if called.
	(process_long_option): Rewrite handling of ambiguous long options
	to use a single boolean vector, not a linked list; use
	__libc_use_alloca to decide whether to allocate this using alloca.

	* posix/tst-getopt_long1.c: Adjust text of expected error message.
2017-04-07 07:51:52 -04:00
argp Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
assert Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
benchtests Change TEST_NAME to memcpy to fix IFUNC testing of multiple versions. 2017-03-28 09:07:03 -07:00
bits Refer to <signal.h> instead of <pthread.h> in <bits/sigthread.h> 2017-02-28 10:34:15 +01:00
catgets Update copyright dates not handled by scripts/update-copyrights. 2017-01-01 00:26:24 +00:00
conform conformtest: Add x32 XFAILs for mq_attr element types (bug 21279). 2017-03-20 21:30:28 +00:00
crypt Add missing header files throughout the testsuite. 2017-02-16 17:33:18 -05:00
csu getopt: remove USE_NONOPTION_FLAGS 2017-04-07 07:45:53 -04:00
ctype Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
debug Update string tests to use the support test driver. 2017-03-23 11:32:29 -03:00
dirent Add missing header files throughout the testsuite. 2017-02-16 17:33:18 -05:00
dlfcn Miscellaneous low-risk changes preparing for _ISOMAC testsuite. 2017-03-01 20:32:50 -05:00
elf Define TEST_FUNCTION_ARGV in elf/tst-dlopen-aout.c 2017-04-05 14:09:38 -07:00
gmon Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
gnulib Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
grp Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
gshadow Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
hesiod Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
hurd As a minor cleanup remove the (r)index defines from include/string.h as 2017-02-06 18:15:18 +00:00
iconv Narrowing the visibility of libc-internal.h even further. 2017-03-01 20:33:46 -05:00
iconvdata Document and fix --enable-bind-now [BZ #21015] 2017-03-02 14:44:28 +01:00
include getopt: clean up error reporting 2017-04-07 07:48:57 -04:00
inet Remove the str(n)dup inlines from string/bits/string2.h. Although inlining 2017-03-13 18:45:42 +00:00
intl Remove the str(n)dup inlines from string/bits/string2.h. Although inlining 2017-03-13 18:45:42 +00:00
io fts: Fix symbol redirect for fts_set [BZ #21289] 2017-03-31 09:11:16 +02:00
libidn Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
libio Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
locale Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
localedata localedata: hu_HU: fix multiple sorting bugs (bug 18934) 2017-03-28 10:35:58 -04:00
login Update copyright dates not handled by scripts/update-copyrights. 2017-01-01 00:26:24 +00:00
mach Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
malloc Call the right helper function when setting mallopt M_ARENA_MAX (BZ #21338) 2017-04-01 12:39:10 +05:30
manual getopt: remove USE_NONOPTION_FLAGS 2017-04-07 07:45:53 -04:00
math Fix condition for inclusion of math-finite.h for long double 2017-03-31 14:50:00 -03:00
mathvec Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
misc Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
nis Deprecate libnsl by default (only shared library will be 2017-03-21 15:14:27 +01:00
nptl Remove CALL_THREAD_FCT macro 2017-04-04 18:03:35 -03:00
nptl_db Narrowing the visibility of libc-internal.h even further. 2017-03-01 20:33:46 -05:00
nscd Narrowing the visibility of libc-internal.h even further. 2017-03-01 20:33:46 -05:00
nss Fix build with --enable-static-nss [BZ #21088] 2017-03-15 13:32:23 -07:00
po Add target to incorporate translations from translations.org 2017-01-20 12:32:46 +05:30
posix getopt: merge from gnulib: alloca avoidance 2017-04-07 07:51:52 -04:00
pwd Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
resolv resolv: Remove IQUERY support 2017-04-07 13:01:21 +02:00
resource Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
rt One more obvious missing #include in the testsuite. 2017-02-19 10:29:34 -05:00
scripts Update old tunables framework document/script. 2017-03-24 11:08:28 +05:30
setjmp Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
shadow Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
signal Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
socket Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
soft-fp Narrowing the visibility of libc-internal.h even further. 2017-03-01 20:33:46 -05:00
stdio-common getopt: clean up error reporting 2017-04-07 07:48:57 -04:00
stdlib Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
streams Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
string Add page tests to string/test-strnlen. 2017-04-05 10:28:41 -03:00
sunrpc Remove the str(n)dup inlines from string/bits/string2.h. Although inlining 2017-03-13 18:45:42 +00:00
support Another round of inclusion fixes for _ISOMAC testsuite. 2017-03-22 08:44:32 -04:00
sysdeps getopt: remove USE_NONOPTION_FLAGS 2017-04-07 07:45:53 -04:00
sysvipc Fix test-sysvsem on some platforms 2017-01-02 18:53:50 -02:00
termios Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
time Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
timezone Add missing header files throughout the testsuite. 2017-02-16 17:33:18 -05:00
wcsmbs Update wcsmbs tests to use the support test driver 2017-04-04 18:05:20 -03:00
wctype Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +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
BUGS [BZ #5222] 2007-10-28 08:24:07 +00:00
CONFORMANCE Move __STDC_* predefined macros from features.h to stdc-predef.h. 2012-02-22 12:53:04 +00:00
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
ChangeLog getopt: merge from gnulib: alloca avoidance 2017-04-07 07:51:52 -04:00
ChangeLog.1 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.2 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.3 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.4 * Makefile (distribute): Add ChangeLog.[0-9]. 1995-04-14 03:52:54 +00:00
ChangeLog.5 * sysdeps/posix/getaddrinfo.c: Implement configuration file 2006-05-04 06:38:07 +00:00
ChangeLog.6 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.7 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.8 ChangeLog: change Winblowz to Windows 2016-08-10 00:49:28 +08:00
ChangeLog.9 Update. 2000-04-28 06:14:43 +00:00
ChangeLog.10 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.11 ChangeLog: change Winblowz to Windows 2016-08-10 00:49:28 +08:00
ChangeLog.12 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.13 Update. 2002-10-03 16:37:04 +00:00
ChangeLog.14 Revert "ChangeLogs: convert to utf-8" 2016-02-12 16:35:27 -05:00
ChangeLog.15 Split out ChangeLog.15 at 2.3 branch point 2005-02-16 07:34:17 +00:00
ChangeLog.16 Fix typo in name 2012-06-21 16:45:27 +02:00
ChangeLog.17 Revert "Sun agreed to a change of the license for the RPC code to a BSD-like license." 2010-06-27 19:34:03 -07:00
ChangeLog.old-ports Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-aarch64 Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-aix Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-alpha ChangeLog: fix BZ style to be consistent and match majority of existing code 2017-04-03 15:18:07 -04:00
ChangeLog.old-ports-am33 Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-arm Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-cris Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-hppa ChangeLog: fix BZ style to be consistent and match majority of existing code 2017-04-03 15:18:07 -04:00
ChangeLog.old-ports-ia64 Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-linux-generic Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-m68k Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-microblaze Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-mips ChangeLog: fix BZ style to be consistent and match majority of existing code 2017-04-03 15:18:07 -04:00
ChangeLog.old-ports-powerpc Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
ChangeLog.old-ports-tile Move ports/ChangeLog* files to ChangeLog.old-ports*, remove ports/ directory. 2014-04-30 10:40:29 -07:00
INSTALL Regenerate INSTALL. 2017-03-21 16:40:16 +00:00
LICENSES Expand LICENSES file. 2012-12-05 21:56:15 +00:00
Makeconfig Document and fix --enable-bind-now [BZ #21015] 2017-03-02 14:44:28 +01:00
Makefile Remove C++ namespace handling from glibc headers. 2017-03-16 13:31:57 +00:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Document and fix --enable-bind-now [BZ #21015] 2017-03-02 14:44:28 +01:00
NAMESPACE Add and update many more entries. 2000-03-20 00:42:58 +00:00
NEWS resolv: Remove IQUERY support 2017-04-07 13:01:21 +02:00
README Require Linux 3.2 except on x86 / x86_64, 3.2 headers everywhere. 2016-02-24 17:15:12 +00:00
README.pretty-printers Fix mutex pretty printer test and pretty printer output. 2017-01-20 14:56:39 +01:00
README.tunables Update old tunables framework document/script. 2017-03-24 11:08:28 +05:30
Rules Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
WUR-REPORT * posix/unistd.h (setuid, setreuid, seteuid, setresuid): 2012-08-01 18:12:58 +02:00
abi-tags Add arm-nacl port. 2015-04-17 09:02:19 -07:00
aclocal.m4 Work even with compilers which enable -fstack-protector by default [BZ #7065] 2016-12-26 10:10:58 +01:00
config.h.in getopt: remove USE_NONOPTION_FLAGS 2017-04-07 07:45:53 -04:00
config.make.in Deprecate libnsl by default (only shared library will be 2017-03-21 15:14:27 +01:00
configure Deprecate libnsl by default (only shared library will be 2017-03-21 15:14:27 +01:00
configure.ac Deprecate libnsl by default (only shared library will be 2017-03-21 15:14:27 +01:00
cppflags-iterator.mk 2004-03-11 Jeroen Dekkers <jeroen@dekkers.cx> 2004-03-14 19:13:17 +00:00
extra-lib.mk support: Introduce new subdirectory for test infrastructure 2016-12-09 08:18:27 +01:00
extra-modules.mk Remove NOT_IN_libc 2014-11-24 15:03:45 +05:30
gen-locales.mk Split locale generation snippet into a separate file 2015-05-13 13:05:28 +05:30
libc-abis A few more archs have IFUNC support. 2010-03-17 02:43:12 -07: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
shlib-versions This is update for configure, build and install of vector math library. 2015-05-14 18:07:06 +03:00
test-skeleton.c Update copyright dates with scripts/update-copyrights. 2017-01-01 00:14:16 +00:00
version.h Open master for development 2017-02-05 21:27:52 +05:30

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 on all architectures except
i[4567]86 and x86_64, where Linux kernel version 2.6.32 or later
suffices.

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.