Mirror of the gdb-patches mailing list
 help / color / mirror / Atom feed
From: Yodel Eldar <yodel.eldar@yodel.dev>
To: gdb-patches@sourceware.org
Cc: simon.marchi@polymtl.ca, Yodel Eldar <yodel.eldar@yodel.dev>
Subject: [PATCH] doc/gdb.texinfo: Add EIO and ENOSYS errno values
Date: Wed,  8 Oct 2025 11:34:55 -0500	[thread overview]
Message-ID: <20251008163455.31446-1-yodel.eldar@yodel.dev> (raw)

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
-- 
2.51.0


             reply	other threads:[~2025-10-08 16:38 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-10-08 16:34 Yodel Eldar [this message]
2025-10-08 17:25 ` Eli Zaretskii
2025-10-08 22:09   ` Simon Marchi
2025-10-09 15:21     ` Yodel Eldar
2025-10-09 15:28       ` Simon Marchi

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20251008163455.31446-1-yodel.eldar@yodel.dev \
    --to=yodel.eldar@yodel.dev \
    --cc=gdb-patches@sourceware.org \
    --cc=simon.marchi@polymtl.ca \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox