From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 4 May 2018 14:43:29 +0000 (+0300)
Subject: A minor addition to etc/DEBUG
X-Git-Tag: emacs-26.1~45
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=58f9e15a49efc3148359ad4c889b8105183d27bc;p=emacs.git

A minor addition to etc/DEBUG

* etc/DEBUG: Add a note for macOS users who get error messages
when trying to run GDB.
---

diff --git a/etc/DEBUG b/etc/DEBUG
index ac95c7c8dc6..bd6ea74fa72 100644
--- a/etc/DEBUG
+++ b/etc/DEBUG
@@ -78,6 +78,14 @@ described in the node "Auto-loading safe path" in the GDB user manual.
 If nothing else helps, type "source /path/to/.gdbinit RET" at the GDB
 prompt, to unconditionally load the GDB init file.
 
+Running GDB on macOS sometimes brings an error message like this:
+
+  Unable to find Mach task port for process-id NNN: (os/kern) failure (0x5).
+
+To overcome this, search the Internet for the phrase "Unable to find
+Mach task port for process-id", and you will find detailed
+instructions to follow.
+
 *** Use the Emacs GDB UI front-end
 
 We recommend using the GUI front-end for GDB provided by Emacs.  With