From nobody Tue Mar 10 11:43:44 2026 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 4fVX8K1Yhtz6VWKY for ; Tue, 10 Mar 2026 11:43:45 +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" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4fVX8J5s9sz49rg for ; Tue, 10 Mar 2026 11:43:44 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1773143024; 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=+qWjF/Bs93dyGHSYJXz3TQa0sShNKA4OOU7ahQ7YOq4=; b=EDad+ocO+7Cr+tzgmvpxYJHzXCdqrkRI922lADJ7uUnvaa+mIyvTC7nCwM4tWoZrQIBcEa pIetcQmGOzjvB9BIyHdylRS1c1Z4O1QKx2554Z2SLNP80nE+nShZ2L6yb+q2vtTV5VzBOw h/SimYkGuEiGpFf1R7bUiMBNetGa0irgeD39yCPcSzrlMeA7z0tQCNHjhXyJsBpq3lxYMe r8eTgR9xy8RvZQHGXtzGVZBHIbyzE9oN6QPGYf9ThEZudq4tWGjWEWGdto/Ar8L43TbFmL et3rSY/D36bd/e5eyuMZTNva6NcWYWG3Qr4YmnOn3iK+38NEoAjNKuklHlr0SQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1773143024; a=rsa-sha256; cv=none; b=OPnP4l8O0xOpcnaBPlWZfKWg7HO8VkSCRtaD2BQagI8jevQ8F90QBTOyn4D7PXkXxobZdI LrVf//hcQlSX/PMUv4ZeHwEe1LWk5qC7YTvXgxuMu7RsIqn1ZUJmreHR6ZIRaSfpj0ZLtP K+nu5Nq68A9uzBE8b6DWtzdDGMgdW5+ySBW1vDUMBOiqKq7/eumTjyZDWzGpBtq+nox0Zn qK/ZmM7yHIcb9niW2E5m73+r/VrxqwN+c6tEmj9aOIGNKDqfKbRbTQEHVIti0+g7/z2iLG ZPtO4uxJ5ijtAudOeanUbfbSouGodtFccuMFl8BRx4PcOX0fJgRdz7uILVgpCw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1773143024; 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=+qWjF/Bs93dyGHSYJXz3TQa0sShNKA4OOU7ahQ7YOq4=; b=n41OMbrCMT7z9092LbaQQ5OK4CUn8yrv7tOwwylGqCdgvjhlq6kUS7Ty+FvBEzUfUXbrI4 xxyzJT/8FYlj7KNDjIlhnLkwZlwwvnO3olsz0XKhJ81vWd/4ANkI3G3lSRk8QR6FWcJQrE 2cpf/mJ2LwKMFN6SBlhxgC5DPePMAlM5zJ8ApY+BLxfBMutCFimHPHlX/eQHaPKwnbuqhu /71t7VDL9aDKq+sUD4xDeT/vPCl9Kd2h1QHfLwb8siJuEOMC3WiTPaxXRSvQrWVlTH9UfP Ps4sp18b2P0pp2T24McvpW9Q5WAY4a5fD7yKBqcYtoSyIutYKPRVSSAdBqlAkw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fVX8J5Nhwz195Q for ; Tue, 10 Mar 2026 11:43:44 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 1cf18 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Tue, 10 Mar 2026 11:43:44 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Konstantin Belousov Subject: git: 3ccc39d38ed8 - stable/15 - renameat2(2): document 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: kib X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 3ccc39d38ed8c805383f261d67fe18a6b7eb29e6 Auto-Submitted: auto-generated Date: Tue, 10 Mar 2026 11:43:44 +0000 Message-Id: <69b003f0.1cf18.3af4cd8d@gitrepo.freebsd.org> The branch stable/15 has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=3ccc39d38ed8c805383f261d67fe18a6b7eb29e6 commit 3ccc39d38ed8c805383f261d67fe18a6b7eb29e6 Author: Konstantin Belousov AuthorDate: 2026-02-27 00:10:36 +0000 Commit: Konstantin Belousov CommitDate: 2026-03-10 11:41:32 +0000 renameat2(2): document (cherry picked from commit 619e49b2ba58e1ffd2ab111fef6d1e87d77e7391) --- lib/libsys/Makefile.sys | 3 ++- lib/libsys/rename.2 | 65 +++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 67 insertions(+), 1 deletion(-) diff --git a/lib/libsys/Makefile.sys b/lib/libsys/Makefile.sys index 4ad1ad4db7e9..fc948ae9c5c7 100644 --- a/lib/libsys/Makefile.sys +++ b/lib/libsys/Makefile.sys @@ -510,7 +510,8 @@ MLINKS+=readlink.2 readlinkat.2 MLINKS+=recv.2 recvfrom.2 \ recv.2 recvmmsg.2 \ recv.2 recvmsg.2 -MLINKS+=rename.2 renameat.2 +MLINKS+=rename.2 renameat.2 \ + rename.2 renameat2.2 MLINKS+=rtprio.2 rtprio_thread.2 MLINKS+=sched_get_priority_max.2 sched_get_priority_min.2 \ sched_get_priority_max.2 sched_rr_get_interval.2 diff --git a/lib/libsys/rename.2 b/lib/libsys/rename.2 index 1806321245ec..dbad50edb9a9 100644 --- a/lib/libsys/rename.2 +++ b/lib/libsys/rename.2 @@ -39,6 +39,16 @@ .Fn rename "const char *from" "const char *to" .Ft int .Fn renameat "int fromfd" "const char *from" "int tofd" "const char *to" +.In sys/fcntl.h +.In stdio.h +.Ft int +.Fo renameat2 +.Fa "int fromfd" +.Fa "const char *from" +.Fa "int tofd" +.Fa "const char *to" +.Fa "unsigned int flags" +.Fc .Sh DESCRIPTION The .Fn rename @@ -112,6 +122,28 @@ or .Fa tofd parameter, the current working directory is used in the determination of the file for the respective path parameter. +.Pp +The +.Fn renameat2 +system call takes an additional +.Fa flags +argument. +If +.Fa flags +is zero, the +.Fn renameat2 +call operates identically to +.Fn renameat . +Additionally, the following flags can be specified: +.Bl -tag -width AT_RENAME_NOREPLACE +.It Dv AT_RENAME_NOREPLACE +If the path specified by +.Fa tofd +and +.Fa to +exists, the request fails with the error +.Er EEXIST . +.El .Sh RETURN VALUES .Rv -std rename .Sh ERRORS @@ -298,6 +330,35 @@ file descriptor lacks the .Dv CAP_RENAMEAT_TARGET right. .El +.Pp +In addition to the errors returned by the +.Fn renameat +system call, the +.Fn renameat2 +system call may fail if: +.Bl -tag -width Er +.It Bq Er EEXIST +The +.Dv AT_RENAME_NOREPLACE +flag was provided, and a file exists at the path specified by +.Fa to . +.It Bq Er EOPNOTSUPP +One of the +.Fa flags +specified is not supported by the filesystem where the to-be +renamed file is located. +.El +.Sh CAVEATS +If the filesystem which owns the file to be renamed does not +implement the +.Dv AT_RENAME_NOREPLACE +flag, it is possible that due to race with target file creation, +the error returned by the +.Fn renameat2 +system call would be non-deterministically either +.Er EEXIST +or +.Er EOPNOTSUPP . .Sh SEE ALSO .Xr chflags 2 , .Xr open 2 , @@ -315,3 +376,7 @@ The .Fn renameat system call appeared in .Fx 8.0 . +The +.Fn renameat2 +system call appeared in +.Fx 16.0 .