From: Michael Albinus <michael.albinus@gmx.de>
Date: Mon, 22 Aug 2016 13:17:55 +0000 (+0200)
Subject: Explain gdb warning on remote hosts
X-Git-Tag: emacs-26.0.90~1711
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=8bb999a98abd8fb0f25fd16cd3e0281503728ab6;p=emacs.git

Explain gdb warning on remote hosts

* doc/misc/tramp.texi (Remote processes): Explain gdb warning
on remote hosts.  (Bug#4604, Bug#6360, Bug#622569)
---

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 8a144a5d023..4dc5e750bc5 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2604,10 +2604,18 @@ with a remote file name:
 @example
 @group
 @kbd{M-x gdb @key{RET}}
-@b{Run gdb (like this):} gdb --annotate=3 @trampfn{ssh,host,~/myprog} @key{RET}
+@b{Run gdb (like this):} gdb -i=mi @trampfn{ssh,host,~/myprog} @key{RET}
 @end group
 @end example
 
+Since the remote @code{gdb} and @code{gdb-inferior} processes do not
+belong to the same process group on the remote host, there will be a
+warning, which can be ignored:
+
+@example
+&"warning: GDB: Failed to set controlling terminal: Operation not permitted\n"
+@end example
+
 Relative file names are based on the remote default directory.  When
 @file{myprog.pl} exists in @file{@trampfn{ssh,host,/home/user}}, valid
 calls include: