man5/proc_tid_children.5

   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)