[thirdparty/man-pages.git] / man5 / proc_tid_children.5

.\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
.\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
.\"
.\" SPDX-License-Identifier: GPL-3.0-or-later
.\"
.TH proc_tid_children 5 (date) "Linux man-pages (unreleased)"
.SH NAME
/proc/tid/children \- child tasks
.SH DESCRIPTION
.TP
.IR /proc/ tid /children " (since Linux 3.5)"
.\" commit 818411616baf46ceba0cff6f05af3a9b294734f7
A space-separated list of child tasks of this task.
Each child task is represented by its TID.
.IP
.\" see comments in get_children_pid() in fs/proc/array.c
This option is intended for use by the checkpoint-restore (CRIU) system,
and reliably provides a list of children only if all of the child processes
are stopped or frozen.
It does not work properly if children of the target task exit while
the file is being read!
Exiting children may cause non-exiting children to be omitted from the list.
This makes this interface even more unreliable than classic PID-based
approaches if the inspected task and its children aren't frozen,
and most code should probably not use this interface.
.IP
Until Linux 4.2, the presence of this file was governed by the
.B CONFIG_CHECKPOINT_RESTORE
kernel configuration option.
Since Linux 4.2,
.\" commit 2e13ba54a2682eea24918b87ad3edf70c2cf085b
it is governed by the
.B CONFIG_PROC_CHILDREN
option.
.SH SEE ALSO
.BR proc (5)
Commit	Line	Data
4608c79b AC	1	.\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
	2	.\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
	3	.\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
	4	.\"
	5	.\" SPDX-License-Identifier: GPL-3.0-or-later
	6	.\"
	7	.TH proc_tid_children 5 (date) "Linux man-pages (unreleased)"
	8	.SH NAME
	9	/proc/tid/children \- child tasks
	10	.SH DESCRIPTION
	11	.TP
	12	.IR /proc/ tid /children " (since Linux 3.5)"
	13	.\" commit 818411616baf46ceba0cff6f05af3a9b294734f7
	14	A space-separated list of child tasks of this task.
	15	Each child task is represented by its TID.
	16	.IP
	17	.\" see comments in get_children_pid() in fs/proc/array.c
	18	This option is intended for use by the checkpoint-restore (CRIU) system,
	19	and reliably provides a list of children only if all of the child processes
	20	are stopped or frozen.
	21	It does not work properly if children of the target task exit while
	22	the file is being read!
	23	Exiting children may cause non-exiting children to be omitted from the list.
	24	This makes this interface even more unreliable than classic PID-based
	25	approaches if the inspected task and its children aren't frozen,
	26	and most code should probably not use this interface.
	27	.IP
	28	Until Linux 4.2, the presence of this file was governed by the
	29	.B CONFIG_CHECKPOINT_RESTORE
	30	kernel configuration option.
	31	Since Linux 4.2,
	32	.\" commit 2e13ba54a2682eea24918b87ad3edf70c2cf085b
	33	it is governed by the
	34	.B CONFIG_PROC_CHILDREN
	35	option.
	36	.SH SEE ALSO
	37	.BR proc (5)