From patchwork Mon Jan 6 16:26:08 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arjun Shankar X-Patchwork-Id: 104190 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 924773858C56 for ; Mon, 6 Jan 2025 16:39:08 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 924773858C56 Authentication-Results: sourceware.org; dkim=pass (1024-bit key, unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=VirgDp1g X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTP id 4ADD43858D35 for ; Mon, 6 Jan 2025 16:33:12 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 4ADD43858D35 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 4ADD43858D35 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=170.10.133.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1736181192; cv=none; b=NtZDn/TiM7necVKFA3buHILrImvpbLY0lB+pTcXzui690z8/YjXOUQUYjY4UCC7p6zTawJHX9ClYFdC3ElfdDSyjnW6geKow3Koz9akV2uRev9ApdVGjjDzWOknWj5VrN8zjFW+D7+PC7zEggYLIKc04r/n+hmHdcCmaSl07+bk= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1736181192; c=relaxed/simple; bh=IHRLFjOe0wqjwJLI8X6Iboz58rhKJhaerjEuBB9abfM=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=S3lBgQht8WJUMLbegkKXcalM+ovS+QG2vV2rAnN1BhL+k3CWp69iT8eiHcupPnB4+uRgNA7mpjo9Z0femFUxkNz0r8FvvdoP30v7nZ0RQ+q+bagM4v/G00G3G32LHeLKjdEX7opQLaxlK2nQ4mvf9x6Es3/AkuZa8QmLV+BL2wc= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4ADD43858D35 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1736181192; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=RjukfSGyPv6jMllj8mNYK5UAarhxpxR0ZV+SUFNNOzg=; b=VirgDp1gMuw9+ZW/sKzbUGcDEZA7LARDB9Xkk7pRSuZWVcAfkbaubbNkXrtsMMBQs7bUkE BuDkPaCI4gORwoS5iTujXeQmUeMDSDir4OJUCwtTiJzZAb0Aeb+qhNeW3yJo+/7CXXlxsq Uh7FlLby4yMx6kQ0v6pGhw1GIInkOQI= Received: from mail-qv1-f72.google.com (mail-qv1-f72.google.com [209.85.219.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-114-k7vthyTaOFO7xx6UeOsKcA-1; Mon, 06 Jan 2025 11:33:10 -0500 X-MC-Unique: k7vthyTaOFO7xx6UeOsKcA-1 X-Mimecast-MFC-AGG-ID: k7vthyTaOFO7xx6UeOsKcA Received: by mail-qv1-f72.google.com with SMTP id 6a1803df08f44-6dd43b16631so151241946d6.2 for ; Mon, 06 Jan 2025 08:33:10 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1736181190; x=1736785990; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=RjukfSGyPv6jMllj8mNYK5UAarhxpxR0ZV+SUFNNOzg=; b=UCQIPpqyOLmA+0pWo7ZQm7AJwM4o43bCt74EQouGJ4fkYpNjGeqLqz54PmQz+jSRsB h7gjRCFahlLz98yd/x91FlRbcYczNnrDAQ6To9DBitaNZfFxe63W6scwdGWuOfxlgXc8 CMVxyNdyVNLVdWFUc75xANLi/1EjOiC5gSKCbWcK8iCru9z1RFydGOmMqADi6fnAU96j mUvNwu6w67nsIeL0CM72aB7CsQBU/vlxo7VSv9wgAjF+ozp7x00pARA5aNCDUXUZxY5y 2Q+exEp1Zl953gQVcagQrEEDveH/D71UXTdHyaV7xAWUcfak5MH03+awLNoegTyR5egF XvBg== X-Gm-Message-State: AOJu0Yzj9nXCbKLNbNfZRChonldVzOqLLbYDjokSsqIHSGSXlGWF4ajR BjzKKaV/2c+U/Mn0732wegdPJ0hsk1/sYFAD78glJ92/rzxO0pv4t1EQDL/ZXQkL2OrgrCy+f4E RvHZYV0V6xUOXL+49AgdBWmlqX6pSYzOzarVx4YfsEHeRgR/BW0NlX//br+XZ+BzNI/18roBjyJ BRQvFytozT9+KoINwmAlky03vjFzs6PBoElQD0dg== X-Gm-Gg: ASbGncsl8tnEdB3AcaoM0yhVsTKRLksGkPOuY3bb3B0AkiaIpiiKwqY6ecuBzPvmw69 kmXFth7PFCSLDfKHY+iVy5wXTYuNZrfiZq5UhigHGnDpjXWEnIX3wCf7kuq8qM+9Hvq1q9SmOBC p7eATJ0dfeMSZQrZBFjHM55GAGMZbiZTIRwn9P1Iv6Z9pjqKtwTm/EGl2y5uiQRzsHfiA/57Bbo nY+HxPOPAH/OigCgF/kXdbFFI8oMHZcWdtnke4YRje1OydGJTB1JKCj/mdTdHNPcGwMMj5NW1oz mAaKHPqyTBAXCS7IMeHtlsEz X-Received: by 2002:ac8:7f4b:0:b0:466:89f5:c21e with SMTP id d75a77b69052e-46a4a8b6c69mr838153001cf.5.1736181189868; Mon, 06 Jan 2025 08:33:09 -0800 (PST) X-Google-Smtp-Source: AGHT+IHEwIhCjeGQUMSZdd1/JTtUyL4F5/Bm6jsX8659pLzAFryU/jbJvlPLR24DAXAcIkED9DK/cw== X-Received: by 2002:ac8:7f4b:0:b0:466:89f5:c21e with SMTP id d75a77b69052e-46a4a8b6c69mr838152611cf.5.1736181189498; Mon, 06 Jan 2025 08:33:09 -0800 (PST) Received: from x1carbon9g.redhat.com (ip-94-112-226-240.bb.vodafone.cz. [94.112.226.240]) by smtp.gmail.com with ESMTPSA id d75a77b69052e-46a3e67e361sm176664841cf.31.2025.01.06.08.33.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Jan 2025 08:33:08 -0800 (PST) From: Arjun Shankar To: libc-alpha@sourceware.org Cc: Arjun Shankar Subject: [PATCH v2 3/5] manual: Document renameat Date: Mon, 6 Jan 2025 17:26:08 +0100 Message-ID: <20250106163257.705106-4-arjun@redhat.com> X-Mailer: git-send-email 2.47.1 In-Reply-To: <20250106163257.705106-1-arjun@redhat.com> References: <20250106163257.705106-1-arjun@redhat.com> MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: eLSk1mApJ8IkVR3cRrtt9NPfpJMzZ9SZtRz0lzpqx0A_1736181190 X-Mimecast-Originator: redhat.com content-type: text/plain; charset="US-ASCII"; x-default=true X-Spam-Status: No, score=-11.4 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_BARRACUDACENTRAL, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libc-alpha-bounces~patchwork=sourceware.org@sourceware.org --- manual/filesys.texi | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/manual/filesys.texi b/manual/filesys.texi index e92730209c..776b98fe7f 100644 --- a/manual/filesys.texi +++ b/manual/filesys.texi @@ -1826,6 +1826,28 @@ file systems. @end table @end deftypefun +@deftypefun int renameat (int @var{oldfiledes}, const char *@var{oldname}, int @var{newfiledes}, const char *@var{newname}) +@standards{POSIX.1-2008, stdio.h} +@comment Unaudited and therefore marked AC-Unsafe and AS-Unsafe by default +@safety{@mtsafe{}@asunsafe{@asucorrupt{}}@acunsafe{@acucorrupt{}}} +This function is a descriptor-relative version of the @code{rename} +function above. @xref{Descriptor-Relative Access}. + +Compared to @code{rename}, the following additional error conditions can +occur: + +@table @code +@item EBADF +The @var{oldfiledes} and/or @var{newfiledes} arguments are not valid file +descriptors. + +@item ENOTDIR +The descriptor @var{oldfiledes} is not associated with a directory, and +@var{oldname} is a relative file name, or correspondingly similar condition +for @var{newfiledes} and @var{newname}. +@end table +@end deftypefun + @node Creating Directories @section Creating Directories @cindex creating a directory @@ -3830,7 +3852,6 @@ The @code{mkdtemp} function comes from OpenBSD. @c openat @c open_by_handle_at @c readlinkat -@c renameat @c renameat2 @c scandirat @c symlinkat