From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id f/2EI8Se5mhUVCQAWB0awg (envelope-from ) for ; Wed, 08 Oct 2025 13:26:28 -0400 Authentication-Results: simark.ca; dkim=pass (2048-bit key; unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=EYsqAbgc; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 7EAD81E047; Wed, 08 Oct 2025 13:26:28 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,RCVD_IN_VALIDITY_CERTIFIED_BLOCKED, RCVD_IN_VALIDITY_RPBL_BLOCKED,RCVD_IN_VALIDITY_SAFE_BLOCKED autolearn=ham autolearn_force=no version=4.0.1 Received: from server2.sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 838D01E047 for ; Wed, 08 Oct 2025 13:26:27 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 1ABF23858D33 for ; Wed, 8 Oct 2025 17:26:27 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1ABF23858D33 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=gnu.org header.i=@gnu.org header.a=rsa-sha256 header.s=fencepost-gnu-org header.b=EYsqAbgc Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 31C5A3858D1E for ; Wed, 8 Oct 2025 17:25:56 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 31C5A3858D1E Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 31C5A3858D1E Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2001:470:142:3::10 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1759944356; cv=none; b=tRLChp+CUSQgpXBy9NEHcOr6DXo0inohsSOF/nabv2/cib1Fohd8VrfnAoYTaEWvO4DOL1pEmj1/NSyJSNA/OPyIgt0nLMOCwulBqR/BMqwA/mL2z64jXWAoWmftKnlmQ0ChbzDn1JK5QJkzORAn+B4hJhvYuMcyTfwI0AFdeMk= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1759944356; c=relaxed/simple; bh=XNqLPoFt0rOsR13RMSKnXzS/74ZelMUhtUgg0aMsZno=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=BvEO49vMZJ7WY6prFa0hfj/IGO01FYy1sTPZBRMqqzzUYGaxr/9OFxqssdVH0AR6wFvQs3QjhzqeidC/hXdMsMDBLs+wjSRJkwAOdBQ5FU8C5yf3ZZc7GD82QTNC8c0YhZyyuOTILHoXrchozjIw5RqsbbqIJrAYxZWHNamqooM= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 31C5A3858D1E Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v6Xv6-0002Ox-DQ; Wed, 08 Oct 2025 13:25:48 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=ZZGmgNS2hqX1MVhuFx3CUo25EpJDijOtxr4447lo0L0=; b=EYsqAbgcUjnW o8ZGbKMgHdlBX/Y54UGAk26Nmg+sFH5Qm4AbzPYQOORw5BGl6uUcjRjq2xh+gxoC+c6KP3reS5DsK iuSeIq3g/94KS0QlfFNzOSASBQt2Tg8fFqrUABEDtA7HGu+6u2xzBmSkgh/h3OfoS42a+gnf1gTNz AE0rxMzeN9B5Cv+QSNrMJWrEi/ee3Si1fGMJefXOrtIn6yWEPsP68ePdcF7kPEYjOEy10Fgul2Ycl dKPT2vKAcDZ6rTTHnoSApmo5sqpvNZPa+cE8EX8PGM7FEjwzHaopFa32EiNhIWsvVAtO+G0t3u5bB bNdDJpOGS129U/NsXYpEcQ==; Date: Wed, 08 Oct 2025 20:25:39 +0300 Message-Id: <861pndb90s.fsf@gnu.org> From: Eli Zaretskii To: Yodel Eldar Cc: gdb-patches@sourceware.org, simon.marchi@polymtl.ca In-Reply-To: <20251008163455.31446-1-yodel.eldar@yodel.dev> (message from Yodel Eldar on Wed, 8 Oct 2025 11:34:55 -0500) Subject: Re: [PATCH] doc/gdb.texinfo: Add EIO and ENOSYS errno values References: <20251008163455.31446-1-yodel.eldar@yodel.dev> X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces~public-inbox=simark.ca@sourceware.org > From: Yodel Eldar > Cc: simon.marchi@polymtl.ca, > Yodel Eldar > Date: Wed, 8 Oct 2025 11:34:55 -0500 > > This patch adds the EIO and ENOSYS errno values supported by GDB's > File-I/O to section E.14.9: Errno Values of the GDB manual [1] that were > presumably inadvertently omitted; both can be seen in the enum > fileio_error:gdbsupport/fileio.h and corresponding function > host_to_fileio_error:gdbsupport/fileio.cc as FILEIO_{EIO,ENOSYS}. > > FILEIO_SUCCESS remains excluded from the manual, because its stated > purpose (commit b872057a6) is to internally represent the absence of an > error value from the remote, and it's not actually an error number. > > [1] https://sourceware.org/gdb/current/onlinedocs/gdb.html/Errno-Values.html > --- > > Notes: > Simon, please let me know if my exclusion of FILEIO_SUCCESS is a mistake; > I assumed the doc page was geared towards stub authors, and that they > typically would check the retcode of a file-op function call before > converting the nonzero errno to GDB's internal protocol representation > of the error value as listed in the manual, but perhaps that's too > myopic; if so, I can resubmit with a "SUCCESS = 0" line added. As the > originator of the enum and member, I defer to your judgment. > > As a side note, I sent this email with my preferred email address that > is different from my previously used email address, > yodel.eldar(at)gmail.com. As attestation, I signed this email > with patatt and the same GPG key as before. > > Thanks, > Yodel > > gdb/doc/gdb.texinfo | 2 ++ > 1 file changed, 2 insertions(+) > > diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo > index a13d5c0388e..5b06d3dbcf8 100644 > --- a/gdb/doc/gdb.texinfo > +++ b/gdb/doc/gdb.texinfo > @@ -48348,6 +48348,7 @@ All values are given in decimal representation. > EPERM 1 > ENOENT 2 > EINTR 4 > + EIO 5 > EBADF 9 > EACCES 13 > EFAULT 14 > @@ -48363,6 +48364,7 @@ All values are given in decimal representation. > ENOSPC 28 > ESPIPE 29 > EROFS 30 > + ENOSYS 88 > ENAMETOOLONG 91 > EUNKNOWN 9999 > @end smallexample Thanks, the patch for the manual is fine by me (assuming the documentation of these errno values is okay, on which I have no opinion). Reviewed-By: Eli Zaretskii