[PATCH 1/2] man/man2/chroot.2: Document that chroot is AS-safe

[Trevor Gross <tg@trevorgross.com>]

As discussed at [1], this is an async-signal-safe syscall wrapper.

Link: https://lore.kernel.org/linux-man/5db76d666377410fc105b9d527cbcd9f9ef3b332.camel@posteo.net/T/#t [1]
Signed-off-by: Trevor Gross <tg@trevorgross.com>
---
 man/man2/chroot.2        |  4 ++++
 man/man7/signal-safety.7 | 10 ++++++++++
 2 files changed, 14 insertions(+)

diff --git a/man/man2/chroot.2 b/man/man2/chroot.2
index fa579eb83..4372ab9c7 100644
--- a/man/man2/chroot.2
+++ b/man/man2/chroot.2
@@ -150,6 +150,10 @@ inherits its parent's root directory.
 The root directory is left unchanged by
 .BR execve (2).
 .P
+.BR chroot()
+is async-signal-safe:
+it may be safely called within a signal handler.
+.P
 The magic symbolic link,
 .IR /proc/ pid /root ,
 can be used to discover a process's root directory;
diff --git a/man/man7/signal-safety.7 b/man/man7/signal-safety.7
index f63d37f75..73d716751 100644
--- a/man/man7/signal-safety.7
+++ b/man/man7/signal-safety.7
@@ -280,6 +280,16 @@ T}
 \f[B]write\f[](2)
 .TE
 .P
+Functions listed in the following table are not required to be
+async-signal-safe by POSIX, but are safe on Linux:
+.P
+.TS
+lb
+lw(24n) l.
+Function
+\f[B]chroot\f[](2)
+.TE
+.P
 Notes:
 .IP \[bu] 3
 POSIX.1-2001 and POSIX.1-2001 TC2 required the functions
-- 
2.50.1 (Apple Git-155)