aboutsummaryrefslogtreecommitdiff
path: root/gdb/inflow.c
diff options
context:
space:
mode:
authorDoug Evans <dje@google.com>2014-07-31 11:48:24 -0700
committerDoug Evans <dje@google.com>2014-07-31 11:48:24 -0700
commit4d4ca2a15d2e3008d14bf7cda9b353f7fcc11bdc (patch)
tree15710133b7cdcadd4ea34994b3a98723a66868e3 /gdb/inflow.c
parent462f517e5020a464e84d2b8535b1b68d39329dc2 (diff)
downloadgdb-4d4ca2a15d2e3008d14bf7cda9b353f7fcc11bdc.zip
gdb-4d4ca2a15d2e3008d14bf7cda9b353f7fcc11bdc.tar.gz
gdb-4d4ca2a15d2e3008d14bf7cda9b353f7fcc11bdc.tar.bz2
* inflow.c (child_terminal_inferior): Add comment.
(child_terminal_ours_for_output): Add comment. (child_terminal_ours): Add comment. * linux-nat.c (linux_nat_terminal_inferior): Add comment. (linux_nat_terminal_ours): Add comment.
Diffstat (limited to 'gdb/inflow.c')
-rw-r--r--gdb/inflow.c17
1 files changed, 14 insertions, 3 deletions
diff --git a/gdb/inflow.c b/gdb/inflow.c
index 5f81de2..f13efea 100644
--- a/gdb/inflow.c
+++ b/gdb/inflow.c
@@ -267,7 +267,11 @@ child_terminal_init (struct target_ops *self)
}
/* Put the inferior's terminal settings into effect.
- This is preparation for starting or resuming the inferior. */
+ This is preparation for starting or resuming the inferior.
+
+ N.B. Targets that want to use this with async support must build that
+ support on top of this (e.g., the caller still needs to remove stdin
+ from the event loop). E.g., see linux_nat_terminal_inferior. */
void
child_terminal_inferior (struct target_ops *self)
@@ -348,7 +352,10 @@ child_terminal_inferior (struct target_ops *self)
so that no input is discarded.
After doing this, either terminal_ours or terminal_inferior
- should be called to get back to a normal state of affairs. */
+ should be called to get back to a normal state of affairs.
+
+ N.B. The implementation is (currently) no different than
+ child_terminal_ours. See child_terminal_ours_1. */
void
child_terminal_ours_for_output (struct target_ops *self)
@@ -358,7 +365,11 @@ child_terminal_ours_for_output (struct target_ops *self)
/* Put our terminal settings into effect.
First record the inferior's terminal settings
- so they can be restored properly later. */
+ so they can be restored properly later.
+
+ N.B. Targets that want to use this with async support must build that
+ support on top of this (e.g., the caller still needs to add stdin to the
+ event loop). E.g., see linux_nat_terminal_ours. */
void
child_terminal_ours (struct target_ops *self)