aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2023-08-15 15:15:35 +0200
committerAlejandro Colomar <alx@kernel.org>2023-08-15 23:13:46 +0200
commit4608c79b50c38393429836f9d6aada1982bd6cd0 (patch)
treef009c6a89f6ec1341089f7b0be8ba36db07fd27d
parentbc9d53da8c684d44fb0c1e20cf813eaad6b9629d (diff)
downloadman-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.525
-rw-r--r--man5/proc_tid_children.537
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)