Go to file
Adhemerval Zanella 342cc934a3 posix: Add terminal control setting support for posix_spawn
Currently there is no proper way to set the controlling terminal through
posix_spawn in race free manner [1].  This forces shell implementations
to keep using fork+exec when launching background process groups,
even when using posix_spawn yields better performance.

This patch adds a new GNU extension so the creating process can
configure the created process terminal group.  This is done with a new
flag, POSIX_SPAWN_TCSETPGROUP, along with two new attribute functions:
posix_spawnattr_tcsetpgrp_np, and posix_spawnattr_tcgetpgrp_np.
The function sets a new attribute, spawn-tcgroupfd, that references to
the controlling terminal.

The controlling terminal is set after the spawn-pgroup attribute, and
uses the spawn-tcgroupfd along with current creating process group
(so it is composable with POSIX_SPAWN_SETPGROUP).

To create a process and set the controlling terminal, one can use the
following sequence:

    posix_spawnattr_t attr;
    posix_spawnattr_init (&attr);
    posix_spawnattr_setflags (&attr, POSIX_SPAWN_TCSETPGROUP);
    posix_spawnattr_tcsetpgrp_np (&attr, tcfd);

If the idea is also to create a new process groups:

    posix_spawnattr_t attr;
    posix_spawnattr_init (&attr);
    posix_spawnattr_setflags (&attr, POSIX_SPAWN_TCSETPGROUP
				     | POSIX_SPAWN_SETPGROUP);
    posix_spawnattr_tcsetpgrp_np (&attr, tcfd);
    posix_spawnattr_setpgroup (&attr, 0);

The controlling terminal file descriptor is ignored if the new flag is
not set.

This interface is slight different than the one provided by QNX [2],
which only provides the POSIX_SPAWN_TCSETPGROUP flag.  The QNX
documentation does not specify how the controlling terminal is obtained
nor how it iteracts with POSIX_SPAWN_SETPGROUP.  Since a glibc
implementation is library based, it is more straightforward and avoid
requires additional file descriptor operations to request the caller
to setup the controlling terminal file descriptor (and it also allows
a bit less error handling by posix_spawn).

Checked on x86_64-linux-gnu and i686-linux-gnu.

[1] https://github.com/ksh93/ksh/issues/79
[2] https://www.qnx.com/developers/docs/7.0.0/index.html#com.qnx.doc.neutrino.lib_ref/topic/p/posix_spawn.html

Reviewed-by: Carlos O'Donell <carlos@redhat.com>
Tested-by: Carlos O'Donell <carlos@redhat.com>
2022-01-25 14:07:53 -03:00
ChangeLog.old Update ChangeLog.old/ChangeLog.23. 2021-08-01 21:33:43 -04:00
argp Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
assert Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
benchtests Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
bits Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
catgets Update copyright dates not handled by scripts/update-copyrights. 2022-01-01 11:42:26 -08:00
conform hurd: drop SA_SIGINFO availability xfail 2022-01-15 17:43:07 +01:00
crypt Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
csu Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
ctype Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
debug debug: Synchronize feature guards in fortified functions [BZ #28746] 2022-01-12 23:34:48 +05:30
dirent Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
dlfcn Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
elf elf: Add a test for PT_LOAD segments with invalid p_align [BZ #28688] 2022-01-24 06:37:36 -08:00
gmon Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
gnulib Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
grp Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
gshadow Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
hesiod Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
htl htl: Fix cleaning the reply port 2022-01-22 02:17:19 +01:00
hurd hurd: Make RPC input array parameters const 2022-01-16 18:48:08 +00:00
iconv Update copyright dates not handled by scripts/update-copyrights. 2022-01-01 11:42:26 -08:00
iconvdata Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
include posix: Add terminal control setting support for posix_spawn 2022-01-25 14:07:53 -03:00
inet Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
intl Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
io Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
libio Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
locale Update automatically-generated copyright dates 2022-01-01 11:42:26 -08:00
localedata Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
login Update copyright dates not handled by scripts/update-copyrights. 2022-01-01 11:42:26 -08:00
mach Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
malloc Update copyright dates not handled by scripts/update-copyrights. 2022-01-01 11:42:26 -08:00
manual x86_64: Document libmvec vector functions accuracy [BZ #28766] 2022-01-19 07:57:11 -08:00
math math: Add more inputs to atan2 accuracy tests [BZ #28765] 2022-01-14 06:00:06 -08:00
mathvec Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
misc Enable _FORTIFY_SOURCE=3 for gcc 12 and above 2022-01-12 18:46:28 +05:30
nis Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
nptl nptl: Effectively skip CAS in spinlock loop 2022-01-20 05:05:09 -08:00
nptl_db Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
nscd Update copyright dates not handled by scripts/update-copyrights. 2022-01-01 11:42:26 -08:00
nss Update copyright dates not handled by scripts/update-copyrights. 2022-01-01 11:42:26 -08:00
po Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
posix posix: Add terminal control setting support for posix_spawn 2022-01-25 14:07:53 -03:00
pwd Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
resolv Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
resource Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
rt rt/tst-mqueue*: Return UNSUPPORTED when mq_open fails with ENOSYS 2022-01-17 19:17:41 +01:00
scripts Disable debuginfod in printer tests [BZ #28757] 2022-01-14 05:07:29 -08:00
setjmp Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
shadow Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
signal Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
socket socket: Add the __sockaddr_un_set function 2022-01-17 10:21:53 +01:00
soft-fp Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
stdio-common Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
stdlib realpath: Avoid overwriting preexisting error (CVE-2021-3998) 2022-01-24 21:40:00 +05:30
string debug: Synchronize feature guards in fortified functions [BZ #28746] 2022-01-12 23:34:48 +05:30
sunrpc CVE-2022-23218: Buffer overflow in sunrpc svcunix_create (bug 28768) 2022-01-17 10:47:58 +01:00
support support: Add helpers to create paths longer than PATH_MAX 2022-01-21 23:01:27 +05:30
sysdeps posix: Add terminal control setting support for posix_spawn 2022-01-25 14:07:53 -03:00
sysvipc Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
termios posix: Add terminal control setting support for posix_spawn 2022-01-25 14:07:53 -03:00
time Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
timezone timezone: Fix tst-bz28707 Makefile rule 2022-01-12 10:30:10 -03:00
wcsmbs debug: Synchronize feature guards in fortified functions [BZ #28746] 2022-01-12 23:34:48 +05:30
wctype Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08: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
CONTRIBUTED-BY Remove "Contributed by" lines 2021-09-03 22:06:44 +05:30
COPYING
COPYING.LIB
INSTALL Add --with-rtld-early-cflags configure option 2022-01-14 20:17:15 +01:00
LICENSES Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
MAINTAINERS Add MAINTAINERS 2017-05-11 13:38:30 -04:00
Makeconfig Add and use link-test-modules-rpath-link [BZ #28455] 2022-01-24 05:11:36 -08:00
Makefile Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
Makefile.help Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
Makefile.in New make target to only build benchmark binaries 2016-04-20 10:23:28 +05:30
Makerules Add and use link-test-modules-rpath-link [BZ #28455] 2022-01-24 05:11:36 -08:00
NEWS posix: Add terminal control setting support for posix_spawn 2022-01-25 14:07:53 -03:00
README Documentation for OpenRISC port 2022-01-05 06:40:06 +09:00
Rules Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
SHARED-FILES Mention today's regex merge in SHARED-FILES 2021-09-21 18:00:10 -07:00
abi-tags Remove the bulk of the NaCl port. 2017-05-20 08:09:10 -04:00
aclocal.m4 Properly check linker option in LIBC_LINKER_FEATURE [BZ #28738] 2022-01-03 05:12:34 -08:00
config.h.in i386: Remove broken CAN_USE_REGISTER_ASM_EBP (bug 28771) 2022-01-13 14:59:44 +01:00
config.make.in Add --with-rtld-early-cflags configure option 2022-01-14 20:17:15 +01:00
configure Properly handle --disable-default-pie [BZ #28780] 2022-01-17 07:27:25 -08:00
configure.ac Properly handle --disable-default-pie [BZ #28780] 2022-01-17 07:27:25 -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 Improve gen-locales.mk and gen-locale.sh to make test files with @ options work 2018-02-27 17:01:57 +01: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
o-iterator.mk
shlib-versions Move malloc hooks into a compat DSO 2021-07-22 18:37:59 +05:30
test-skeleton.c Update copyright dates with scripts/update-copyrights 2022-01-01 11:40:24 -08:00
version.h Open master branch for glibc 2.35 development 2021-08-01 21:54:40 -04: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.

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