| 1 |
.\" Copyright 1994-1995, Daniel Quinlan <[email protected]> |
| 2 |
.\" Copyright 2002-2017, Michael Kerrisk <[email protected]> |
| 3 |
.\" Copyright, the authors of the Linux man-pages project |
| 4 |
.\" |
| 5 |
.\" SPDX-License-Identifier: GPL-3.0-or-later |
| 6 |
.\" |
| 7 |
.TH proc_tid_children 5 2026-02-08 "Linux man-pages 6.18" |
| 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) |