From nobody Mon Sep 15 09:30:21 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4cQKWf1t54z68KbL; Mon, 15 Sep 2025 09:30:22 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cQKWf1312z3gB8; Mon, 15 Sep 2025 09:30:22 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1757928622; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=buL/w5ofoNu2fnKMD3M6s8Qun1+XwtwmdmjpzGB2icw=; b=tFkcmuY4+yXYLqsWCxDHcSenqG3ofRAOQ7lMjzcrniNKhXwsAY/dIkcNav30+yIzYWx9k2 dO4R6VUMPySCAEhLqfJiVmJwrTOYIMwVRzoaVFn+WQJ8RUOXNBEtLlFKhZXOB3Hp12Uns+ TUZ3uXpCA5YUjUn4vHvKj/JgAud/N68WYmkBzcBZ2P3j5mEgFFkeEL5uWP92gC1MrbrpWQ KRW5GURClTjnHKqH11JPuMQ4Sr+J0O1RQ9wbxb8AUyaP6ejgu075D8eTCm8IZsE/WDPO2J vgbcQAR1XI5cGWv2uAdn6lxND7zbebLyOteEv/Yknrkt/YwVdAswfU+ZiKjQhw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1757928622; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=buL/w5ofoNu2fnKMD3M6s8Qun1+XwtwmdmjpzGB2icw=; b=snsZM66WD3Dc+zdxZPrUjKNXZF567lXSy8zvUEXVUS2k/aq2QwmfVuA59GUZtTui2aUWtI pKgavtUYmLdfa3z6a+yg9AY0DtLwk6Yun1As3qAz7iHOq47uvDVCRyubyeY+AtrK0RvnXR L6kWvF1foAvKbScG8spdfeAsab+2GGyMj28Y+bBv3b+dsoWE3UAoVZkpt/bQvkLIxftRur /OcEbv4/ffxzdVHdqQOkf6ZInfipLX+o6WIwmlz0v74EP6+YRsz5/zrdxStpLO8q/R6Ok9 EVjwU65FqdpwO9ULv67SQ0HUl3sCLHWlo+lQu4vJLRpvoqKJhPs4elZp/c1aMg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1757928622; a=rsa-sha256; cv=none; b=O4Zbc1jTTPC37p0UTU2sI53pswmwJWK2zBYXdtucSh7/9GDb+sk7gH+LlS10Xah9GQ06NX G5o+pMdyDrVBrUzWIqKB60yfUVuEG6JMSbxdFcKK5sz9r1uj/UFgXajYjJokkzfuFknbE5 TC29sesDah873WGiWPPmw86Ra6yg0Nr8pi/wOUuynPzour6cbLuXGWlDWcpKRLyfYBCizO LFSyNkgjqzwR2eL5gdBkzWLzgf32TTIuFCsM8fXl1goQY9W6v1kxbrq3Y25pFueSc2QF2K Fg2/yyomgH+MQN3ePzFc07WqsnSFuQujbcTlRP0nfjvHrkT0pJE6dyACn23mqA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cQKWf02SMzprN; Mon, 15 Sep 2025 09:30:22 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 58F9ULst055230; Mon, 15 Sep 2025 09:30:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 58F9ULsG055227; Mon, 15 Sep 2025 09:30:21 GMT (envelope-from git) Date: Mon, 15 Sep 2025 09:30:21 GMT Message-Id: <202509150930.58F9ULsG055227@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Olivier Certner Subject: git: ef2f36be8fce - main - jail.2: Mention EPERM is returned on open directories List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: olce X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ef2f36be8fce8cf7a62ce7d33ab1c4a181fac3e2 Auto-Submitted: auto-generated The branch main has been updated by olce: URL: https://cgit.FreeBSD.org/src/commit/?id=ef2f36be8fce8cf7a62ce7d33ab1c4a181fac3e2 commit ef2f36be8fce8cf7a62ce7d33ab1c4a181fac3e2 Author: Olivier Certner AuthorDate: 2025-09-01 09:31:23 +0000 Commit: Olivier Certner CommitDate: 2025-09-15 09:29:44 +0000 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 --- lib/libsys/jail.2 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) 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.