From nobody Fri Jan 24 20:17:05 2025 X-Original-To: dev-commits-src-all@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 4Yfpxs3x8wz5ls20; Fri, 24 Jan 2025 20:17:05 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Yfpxs3J39z3Ytr; Fri, 24 Jan 2025 20:17:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1737749825; 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=WBgAxX5xw8tSQ/YN0O+Trn0lNrZyp5HJJ120Vl7FV8E=; b=UBvM2+uwVy+oyeFcQ5ke9IzlyFau4LDB9qz5ldvHo+aK1xvbckZTGyPbXQxPBAlRDKd4yY KRfGIVeu1EL2P+f2qzfSiaNPf5jennlVkykUeuKzeo1TCighehEON1fAgLcHE9eyTqfDFT QwL/etO6Cb+cnQF0TLatuWx/27zPEjHrOImSRvsHx0HOZ+eFYajxKvRblTmLDFc9SVgjWx f/yXQGLFctmqSjRodLfr/NOh+zKySDh/H1f2HAsj258uIUw78d/oaQVntTCHhD0uPF5ynA /Ym0l3TJcMqTa5QTYrfZR9Wm3AyurnV7JnaauAJ/jCmdWdsaiOg3IU9N4Qewcw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1737749825; 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=WBgAxX5xw8tSQ/YN0O+Trn0lNrZyp5HJJ120Vl7FV8E=; b=atMjLlHxHvoFV57VdvlWOgY73EO6efrHfLLxq5DPLJnDJ+WOQqT341znIaOzQlN1kAx5Ly hnqA4/FaR1eEhICA553QG2zVQ6CPO7DQhUsDV/+pOGGAcgnoz6XLGdgxi1QZurbuaYxyKx UEdbhaQxG0YKinoU47kINSW1msYICOACPlqPAeVt9W9J9xeXAOPeIRnwNKC8/RbEnTgzF4 6vsoapY+CPNeAwdeugIQMNncsUl5kg0/VdCY5wLq+W0muronR8hJSppT/3YO5/FHFNtRLL 2yAV/6/HSPpMD1w6I5v0MQZTPSnGU1dE43McUiu/d9Qs1wrvric3UNKlB876MQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1737749825; a=rsa-sha256; cv=none; b=gtvoZmQFpGT+s8sKTtwB2XIWGqUdm0C2Zfg4DRWNRQtZazpno7HqiAG488TkDlKeVavUBq Adb6MmxuKyu3VWE3dvfMi4WIrKgQVuwt8hro2UTPmT1/WEvqfY5nIOaW098KnJSQjfBRze Az7CfMNeT9ylILuCTcfuLfTPqBwCWRgtswdP9a73yiWxKWEEUGzYEw1TTtkfklzTAPkDxf SFLlaVhiLPaORHQLCyG5wa5asaFHXHD7v/nMq4TRxJhAdZd7CjGxjUlEK8E50jhI4S8WIZ JIxxCQcZnJ9Ywm77TnTFAEiwvFokxgqkA4MW707j6ONyf6FLs0KvRUh59wX+oA== 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 4Yfpxs2hlMzgqD; Fri, 24 Jan 2025 20:17:05 +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 50OKH5ll044489; Fri, 24 Jan 2025 20:17:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 50OKH5ui044486; Fri, 24 Jan 2025 20:17:05 GMT (envelope-from git) Date: Fri, 24 Jan 2025 20:17:05 GMT Message-Id: <202501242017.50OKH5ui044486@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mark Johnston Subject: git: c81417289606 - main - open.2: update description for O_PATH List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: markj X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c81417289606ca9c808417672c603b5e233856de Auto-Submitted: auto-generated The branch main has been updated by markj: URL: https://cgit.FreeBSD.org/src/commit/?id=c81417289606ca9c808417672c603b5e233856de commit c81417289606ca9c808417672c603b5e233856de Author: CismonX AuthorDate: 2025-01-03 10:52:34 +0000 Commit: Mark Johnston CommitDate: 2025-01-24 20:15:09 +0000 open.2: update description for O_PATH - Add fstatfs(), fchdir(), fchroot(), extattr_*_fd(), cap_*_get(), cap_*_limit() to the list of syscalls that can take an O_PATH fd. - Remove readlinkat() from the list, since it is already discussed in the first few lines of the paragraph. It was originally added to the list when readlinkat() adds support for non-dir fd with an empty relative path (as if with AT_EMPTY_PATH), however, such use case is also discussed in the next paragraph. - Add funlinkat() to the list, since it accepts an extra fd (of the file to be unlinked), which is worth extra mentioning. - Fix a syntax issue which causes a bogus space to be rendered before a closing parentheses. Signed-off-by: CismonX Reviewed by: markj, jhb MFC after: 2 weeks Pull Request: https://github.com/freebsd/freebsd-src/pull/1564 --- lib/libsys/open.2 | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/lib/libsys/open.2 b/lib/libsys/open.2 index fe1ad757b5b0..9ad5440bf239 100644 --- a/lib/libsys/open.2 +++ b/lib/libsys/open.2 @@ -393,7 +393,12 @@ but advisory locking is not allowed .It Xr dup 2 .It Xr close 2 .It Xr fstat 2 +.It Xr fstatfs 2 +.It Xr fchdir 2 +.It Xr fchroot 2 .It Xr fexecve 2 +.It Xr funlinkat 2 +can be passed as the third argument .It Dv SCM_RIGHTS can be passed over a .Xr unix 4 @@ -403,16 +408,23 @@ message .It Xr kqueue 2 only with .Dv EVFILT_VNODE -.It Xr readlinkat 2 .It Xr __acl_get_fd 2 .It Xr __acl_aclcheck_fd 2 +.It Xr extattr 2 +.It Xr capsicum 4 +can be passed to +.Fn cap_*_limit +and +.Fn cap_*_get +system calls (such as +.Xr cap_rights_limit 2 ) . .El .Pp Other operations like .Xr read 2 , .Xr ftruncate 2 , and any other that operate on file and not on file descriptor (except -.Xr fstat 2 ), +.Xr fstat 2 ) , are not allowed. .Pp A file descriptor created with the