diff options
| author | Alejandro Colomar <alx@kernel.org> | 2023-08-15 15:15:35 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2023-08-15 23:13:46 +0200 |
| commit | 4608c79b50c38393429836f9d6aada1982bd6cd0 (patch) | |
| tree | f009c6a89f6ec1341089f7b0be8ba36db07fd27d | |
| parent | bc9d53da8c684d44fb0c1e20cf813eaad6b9629d (diff) | |
| download | man-pages-4608c79b50c38393429836f9d6aada1982bd6cd0.tar.gz | |
proc.5, proc_tid_children.5: Split /proc/TID/children from proc(5)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
| -rw-r--r-- | man5/proc.5 | 25 | ||||
| -rw-r--r-- | man5/proc_tid_children.5 | 37 |
2 files changed, 37 insertions, 25 deletions
diff --git a/man5/proc.5 b/man5/proc.5 index 05543fb600..5fc805eb88 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -231,31 +231,6 @@ hierarchy. .\" Added in Linux 2.6.9 .\" CONFIG_SCHEDSTATS .TP -.IR /proc/ pid /task/ 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. -.TP .I /proc/apm Advanced power management version and battery information when .B CONFIG_APM diff --git a/man5/proc_tid_children.5 b/man5/proc_tid_children.5 new file mode 100644 index 0000000000..5c5466e027 --- /dev/null +++ b/man5/proc_tid_children.5 @@ -0,0 +1,37 @@ +.\" 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) |
