aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOlivier Certner <olce@FreeBSD.org>2025-09-01 09:31:23 +0000
committerOlivier Certner <olce@FreeBSD.org>2025-09-15 09:29:44 +0000
commitef2f36be8fce8cf7a62ce7d33ab1c4a181fac3e2 (patch)
tree98d2c291dd10d0898df37179b75d0e111cdfdac6
parent7780766b403dd00b04cc597b44b6358010986616 (diff)
jail.2: Mention EPERM is returned on open directories
The manual page does not directly mention this reason for getting EPERM, instead referring the reader to chroot(2). We have had some questions about it recently, in part due to a bug (fixed), and this case is not an obvious permission/problem, so let's be more explicit. PR: 280809 Reviewed by: jamie MFC after: 3 days Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D52319
-rw-r--r--lib/libsys/jail.25
1 files changed, 4 insertions, 1 deletions
diff --git a/lib/libsys/jail.2 b/lib/libsys/jail.2
index d3f871608c1d..ee4e5b03d38e 100644
--- a/lib/libsys/jail.2
+++ b/lib/libsys/jail.2
@@ -23,7 +23,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd September 9, 2025
+.Dd September 15, 2025
.Dt JAIL 2
.Os
.Sh NAME
@@ -555,6 +555,9 @@ and
call
.Xr chroot 2
internally, so they can fail for all the same reasons.
+In particular, they return the
+.Bq Er EPERM
+error when the process to join a jail has open directories.
Please consult the
.Xr chroot 2
manual page for details.