From patchwork Mon Jan 6 16:26:07 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arjun Shankar X-Patchwork-Id: 104187 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 682BC3858D35 for ; Mon, 6 Jan 2025 16:35:31 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 682BC3858D35 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=MEQwD9Oq 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 C3C5D3858D29 for ; Mon, 6 Jan 2025 16:33:09 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org C3C5D3858D29 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 C3C5D3858D29 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=1736181189; cv=none; b=pQejO2BW0RNKSM8yAAw/US7vtXCADRDqjhupmAOi+xk0D6CfeaZCxUG94xKZX5q7p1XtuQvoQWwyuCN3e+nyvJbY3eUOSDWdh/9KH9ENais+nJbtMlsnDl85xzCz9ZvkLrn7oyTXpzHPDLD6ttMchS5QihoLW842QlZQyekW5ds= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1736181189; c=relaxed/simple; bh=/EJMiXqjkcBp5NSezly0VzOgIU2hnVJZEJgFG0gaJlc=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=AYortNjZYOAMlrdozE1gFhHtcixL6u8/dtHCxfVKdct1cx9iMtB06/QiBu8wUtRjCicRXqGYpDYxKHt2iCToIulJ3nt3+twHYjf1ZuaGHuQsbi4X5iibl/ZycH5nBAXJbYDzTNFuKsJLPumQwa8EGCoANF8E3OQ0soRTjl6HRvU= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C3C5D3858D29 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1736181189; 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=Bc7wbjvLJdt9FkE46Tgtq1va/KDYzzJNdfZz6q8EdS0=; b=MEQwD9OqjTT6n71kRXx0fxM9Dr31Tf2uRwc4sByRKeZ/2y70oewif1FXohqz8OTYK6ueDr dxY+wy/rh9SVTZ+pTBYfaoqEsHaqKXlm/pHEkHO3PpmnNRUsBgieeptqCYdrmz6q8VlFUf aUY124AIKYlhq5jG1c55C7lBiubFy8Y= Received: from mail-qv1-f69.google.com (mail-qv1-f69.google.com [209.85.219.69]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-630-uzEimukGOr-l6gmdQsOuzA-1; Mon, 06 Jan 2025 11:33:08 -0500 X-MC-Unique: uzEimukGOr-l6gmdQsOuzA-1 X-Mimecast-MFC-AGG-ID: uzEimukGOr-l6gmdQsOuzA Received: by mail-qv1-f69.google.com with SMTP id 6a1803df08f44-6d8edb40083so287917496d6.0 for ; Mon, 06 Jan 2025 08:33:08 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1736181188; x=1736785988; 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=Bc7wbjvLJdt9FkE46Tgtq1va/KDYzzJNdfZz6q8EdS0=; b=JACKjAV5ztLWtqLtnpLRlrQUt9WJXadBRV66SeZoh0h/1ldgq7wn4Lb5SdQ0GQ5TUr WyWk11RPRDi9dbbv3tlwkR3R/ktWBjeULoeYSnBa/hPzTpmNA7DHR+n4+Qkz+StIY2E3 sGfEhgYZgbvlzWtWA8dC4c3US4N2eKVvK6jcwgbN4gQVIDSJZH90fb9L5qqtiEQFtNo2 CUY+mxfW7FHBcUlUzlAfMJCYgtNcCPk4tYTkRybr54g0T6i864elkN5MymkTHaQc5Fm1 ZwCdijjhnEEQ3KhKI8SWQTjRJ41b9zG8IyABhOKZvMvxya3ozdb7nSOq48vlnFHR8ZMg CiiA== X-Gm-Message-State: AOJu0YypGOvLhZG1c+6h0IikbO+2AjoJKZc5VfJ1KFUhx/p3/Ne3l++M d0yIx7RRozeEZ2UuDHQHvi6GZBtmtAwl2qz+nCfIYndKVo/gmxUwgH+JHfIqIghrXXSyT8rl5cB jS/1+aoATQa33Pprz46Q6KMaEmtTKFQJoGoSbUJqcNr7vPvv3rvlumKz+UKqQ+hyoKL1emzp0Sf YDtyyxgp8ksx8XymGjbUC++bJPk/cpdXPzt/lHqA== X-Gm-Gg: ASbGncsBzZ1sjAjbbwOWSaN/tEHF1bNdTtYPbisxRFMZr5HQplyREfeBb0/Xlxdnj41 j01DdXHdmBtSV+tCHdw7m2MBp+0FfnDavO0X0eZ45r3mD1OLcPFQEqqiYPvZXu+evR0xQ5ZTnIq jacGthrBtMLwxc2SmOD4Y5aK02uuuauAxh8/dwulk5HHuP3MXV3SShiPsmEbB6wyJv9i1pOschb H1fYIC4tqpYbpN612fw6VrUIHNs5L7/0qhcKNyYt778spUU1BBe5dlypvRD9HJhdOQdzgt/nKmH DqeXntZZ+Y+B6sLNkYeTSYjD X-Received: by 2002:ac8:7c4c:0:b0:467:64eb:f2f2 with SMTP id d75a77b69052e-46a4b1120famr1031782131cf.9.1736181187951; Mon, 06 Jan 2025 08:33:07 -0800 (PST) X-Google-Smtp-Source: AGHT+IGjlYJWAh8xrttPcAeo9R1WJDZnahWfpGrIY+c39AZiY6Scm29zYwxZDoKe6ZKxm90sN7YlWw== X-Received: by 2002:ac8:7c4c:0:b0:467:64eb:f2f2 with SMTP id d75a77b69052e-46a4b1120famr1031781671cf.9.1736181187560; Mon, 06 Jan 2025 08:33:07 -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.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Jan 2025 08:33:06 -0800 (PST) From: Arjun Shankar To: libc-alpha@sourceware.org Cc: Arjun Shankar Subject: [PATCH v2 2/5] manual: Document mkdirat Date: Mon, 6 Jan 2025 17:26:07 +0100 Message-ID: <20250106163257.705106-3-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: x7oTEGganmgdr3Q4Y2UCX_Xel8jx4LV-byevJReUAXc_1736181188 X-Mimecast-Originator: redhat.com content-type: text/plain; charset="US-ASCII"; x-default=true X-Spam-Status: No, score=-11.5 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 | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/manual/filesys.texi b/manual/filesys.texi index 407c26bd76..e92730209c 100644 --- a/manual/filesys.texi +++ b/manual/filesys.texi @@ -1880,6 +1880,26 @@ To use this function, your program should include the header file @pindex sys/stat.h @end deftypefun +@deftypefun int mkdirat (int @var{filedes}, const char *@var{filename}, mode_t @var{mode}) +@standards{POSIX.1-2008, sys/stat.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{mkdir} +function above. @xref{Descriptor-Relative Access}. + +Compared to @code{mkdir}, the following additional error conditions can +occur: + +@table @code +@item EBADF +The @var{filedes} argument is not a valid file descriptor. + +@item ENOTDIR +The descriptor @var{filedes} is not associated with a directory, and +@var{filename} is a relative file name. +@end table +@end deftypefun + @node File Attributes @section File Attributes @@ -3805,7 +3825,6 @@ The @code{mkdtemp} function comes from OpenBSD. @c futimesat @c fstatat (there's a commented-out safety assessment for this one) @c statx -@c mkdirat @c mkfifoat @c name_to_handle_at @c openat