summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>1999-10-25 18:02:33 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>1999-10-25 18:02:33 +0000
commit9ec462aa509c5c8f750334af9d12bda8cd0d807d (patch)
tree3be668e895c5bc2045819bed3b284e159fc11df5 /doc
parentAdded descriptions of the mount table entry elements. (diff)
downloadrtems-9ec462aa509c5c8f750334af9d12bda8cd0d807d.tar.bz2
Fixing many lines that are too long to format cleanly.
Diffstat (limited to '')
-rw-r--r--doc/porting/taskcontext.t3
-rw-r--r--doc/rgdb_specs/daemon.t53
-rw-r--r--doc/rgdb_specs/gdbinternals.t25
-rw-r--r--doc/supplements/hppa1_1/cputable.t3
-rw-r--r--doc/supplements/powerpc/cputable.t5
5 files changed, 56 insertions, 33 deletions
diff --git a/doc/porting/taskcontext.t b/doc/porting/taskcontext.t
index cf0f750995..56d48b8464 100644
--- a/doc/porting/taskcontext.t
+++ b/doc/porting/taskcontext.t
@@ -428,7 +428,8 @@ how to accomplish this:
@example
#define _CPU_Context_Initialize_fp( _destination ) \
@{ \
- *((Context_Control_fp *) *((void **) _destination)) = _CPU_Null_fp_context; \
+ *((Context_Control_fp *) *((void **) _destination)) = \
+ _CPU_Null_fp_context; \
@}
@end example
diff --git a/doc/rgdb_specs/daemon.t b/doc/rgdb_specs/daemon.t
index 630b5ebed5..8c2b148360 100644
--- a/doc/rgdb_specs/daemon.t
+++ b/doc/rgdb_specs/daemon.t
@@ -108,7 +108,7 @@ These events will be treated by the debugger because they are the
primary event used when debugging a software for instruction stepping. In both
cases, the DEBUG EXCEPTION handler code is executed. Please note that the execution
context of the exception handler is the supervisor stack of the task that generated
-the exception . This implies :
+the exception. This implies:
@itemize @bullet
@item We may sleep in this context,
@@ -163,6 +163,7 @@ before to signal a debug event to GDB. The command task shall be able to preempt
this task for emergency command such as DEL, or REBOOT,
@item Applications tasks (task we are able to debug),
@end enumerate
+
Using theses priorities eliminates the need for adding more synchronization
objects in the next section. My belief is that symmetric MP support will require
more important change in the RTEMS than RGDBSD itself like multiple scheduler
@@ -339,14 +340,18 @@ specific stop condition can be found as macros in the GDB source tree.
@section Output of a Debug Session with the Prototype
+This is a sample session with the remote debugging prototype. Note that
+some lines have been broken so they would print properly when printed.
+
@example
GNU gdb 4.17
Copyright 1998 Free Software Foundation, Inc.
-GDB is free software, covered by the GNU General Public License, and you are
-welcome to change it and/or distribute copies of it under certain conditions.
-Type "show copying" to see the conditions.
-There is absolutely no warranty for GDB. Type "show warranty" for details.
-This GDB was configured as --host=i686-pc-linux-gnu --target=i386-rtems".
+GDB is free software, covered by the GNU General Public License,
+and you are welcome to change it and/or distribute copies of it
+under certain conditions. Type "show copying" to see the conditions.
+There is absolutely no warranty for GDB.
+Type "show warranty" for details.
+This GDB was configured as --host=i686-pc-linux-gnu --target=i386-rtems.
Attaching remote machine across net...
Connected to net-test.
Now the "run" command will start a remote process.
@@ -374,45 +379,57 @@ _Thread_Dispatch () at /rtems/c/src/exec/score/src/thread.c:315
134283266 ntwk No No
_Thread_Dispatch () at /rtems/c/src/exec/score/src/thread.c:315
(gdb) b init.c:89
-Breakpoint 1 at 0x200180: file /rtems/c/src/tests/samples/debug/init.c, line 89.
+Breakpoint 1 at 0x200180: file \
+ /rtems/c/src/tests/samples/debug/init.c, line 89.
(gdb) c
Continuing.
Thread 134283273 (Rini) has been deleted.
-[Switching to Rtems thread 134283271 (Not suspended) ( <= current target thread )]
-Breakpoint 1, example2 (argument=4) at /rtems/c/src/tests/samples/debug/init.c:89
+[Switching to Rtems thread 134283271 (Not suspended) \
+ ( <= current target thread )]
+Breakpoint 1, example2 (argument=4) at \
+ /rtems/c/src/tests/samples/debug/init.c:89
89 tuto += tuti;
(gdb) s
90 if (print_enable2)
(gdb) c
Continuing.
-Breakpoint 1, example2 (argument=4) at /rtems/c/src/tests/samples/debug/init.c:89
+Breakpoint 1, example2 (argument=4) at \
+ /rtems/c/src/tests/samples/debug/init.c:89
89 tuto += tuti;
(gdb) b init.c:66
-Breakpoint 2 at 0x200128: file /rtems/c/src/tests/samples/debug/init.c, line 66.
+Breakpoint 2 at 0x200128: file \
+ /rtems/c/src/tests/samples/debug/init.c, line 66.
(gdb) c
Continuing.
-Switching to Rtems thread 134283270 (Not suspended) ( <= current target thread )]
-Breakpoint 2, example1 (argument=4) at /rtems/c/src/tests/samples/debug/init.c:66
+Switching to Rtems thread 134283270 (Not suspended) \
+ ( <= current target thread )]
+Breakpoint 2, example1 (argument=4) at \
+ /rtems/c/src/tests/samples/debug/init.c:66
66 toto += titi;
(gdb) c
Continuing.
-[Switching to Rtems thread 134283271 (Not suspended) ( <= current target thread )]
-Breakpoint 1, example2 (argument=4) at /rtems/c/src/tests/samples/debug/init.c:89
+[Switching to Rtems thread 134283271 (Not suspended) \
+ ( <= current target thread )]
+Breakpoint 1, example2 (argument=4) at \
+ /rtems/c/src/tests/samples/debug/init.c:89
89 tuto += tuti;
(gdb) bt
#0 example2 (argument=4)
at /rtems/c/src/tests/samples/debug/init.c:89
#1 0xf0009bd0 in ?? ()
(gdb) thread target 134283270
-thread 134283270 [SPE1], _Thread_Dispatch () at /rtems/c/src/exec/score/src/thread.c:315
+thread 134283270 [SPE1], _Thread_Dispatch () at \
+ /rtems/c/src/exec/score/src/thread.c:315
315 executing = _Thread_Executing;
(gdb) c
Continuing.
-Breakpoint 2, example1 (argument=4) at /rtems/c/src/tests/samples/debug/init.c:66
+Breakpoint 2, example1 (argument=4) at \
+ /rtems/c/src/tests/samples/debug/init.c:66
66 toto += titi;
(gdb) detach
Detaching program: /build-rtems/pc386/tests/debug.exe pid 1
-Warning: the next command will be done localy! If you want to restart another remote
+Warning: the next command will be done localy! \
+ If you want to restart another remote
program, reuse the target command
(gdb)
@end example
diff --git a/doc/rgdb_specs/gdbinternals.t b/doc/rgdb_specs/gdbinternals.t
index d989cfe8e9..947130155a 100644
--- a/doc/rgdb_specs/gdbinternals.t
+++ b/doc/rgdb_specs/gdbinternals.t
@@ -34,9 +34,10 @@ struct target_ops
@{
char *to_shortname; /* Name this target type */
char *to_longname; /* Name for printing */
- char *to_doc; /* Documentation. Does not include trailing
- newline, and starts with a one-line descrip-
- tion (probably similar to to_longname). */
+ char *to_doc; /* Documentation. Does not include trailing
+ newline, and starts with a one-line
+ description (probably similar to
+ to_longname). */
void (*to_open) PARAMS ((char *, int));
void (*to_close) PARAMS ((int));
void (*to_attach) PARAMS ((char *, int));
@@ -48,14 +49,15 @@ struct target_ops
void (*to_prepare_to_store) PARAMS ((void));
/* Transfer LEN bytes of memory between GDB address MYADDR and
- target address MEMADDR. If WRITE, transfer them to the target, else
- transfer them from the target. TARGET is the target from which we
- get this function.
+ target address MEMADDR. If WRITE, transfer them to the target,
+ else transfer them from the target. TARGET is the target from
+ which we get this function.
Return value, N, is one of the following:
- 0 means that we can't handle this. If errno has been set, it is the
- error which prevented us from doing it (FIXME: What about bfd_error?).
+ 0 means that we can't handle this. If errno has been set,
+ it is the error which prevented us from doing it (FIXME:
+ What about bfd_error?).
positive (call it N) means that we have transferred N bytes
starting at MEMADDR. We might be able to handle more bytes
@@ -65,9 +67,10 @@ struct target_ops
transfer right at MEMADDR, but we could transfer at least
something at MEMADDR + N. */
- int (*to_xfer_memory) PARAMS ((CORE_ADDR memaddr, char *myaddr,
- int len, int write,
- struct target_ops * target));
+ int (*to_xfer_memory)
+ PARAMS ((CORE_ADDR memaddr, char *myaddr,
+ int len, int write,
+ struct target_ops * target));
void (*to_files_info) PARAMS ((struct target_ops *));
int (*to_insert_breakpoint) PARAMS ((CORE_ADDR, char *));
diff --git a/doc/supplements/hppa1_1/cputable.t b/doc/supplements/hppa1_1/cputable.t
index 3758fb61a6..af741307dd 100644
--- a/doc/supplements/hppa1_1/cputable.t
+++ b/doc/supplements/hppa1_1/cputable.t
@@ -41,7 +41,8 @@ typedef struct @{
hppa_rtems_isr_entry spurious_handler;
- unsigned32 itimer_clicks_per_microsecond; /* for use by Clock driver */
+ /* itimer_clicks_per_microsecond is for the Clock driver */
+ unsigned32 itimer_clicks_per_microsecond;
@} rtems_cpu_table;
@end example
diff --git a/doc/supplements/powerpc/cputable.t b/doc/supplements/powerpc/cputable.t
index 73bd11a29b..86907dcefb 100644
--- a/doc/supplements/powerpc/cputable.t
+++ b/doc/supplements/powerpc/cputable.t
@@ -37,7 +37,8 @@ typedef struct @{
/* end of fields required on all CPUs */
unsigned32 clicks_per_usec; /* Timer clicks per microsecond */
- void (*spurious_handler)(unsigned32 vector, CPU_Interrupt_frame *);
+ void (*spurious_handler)(
+ unsigned32 vector, CPU_Interrupt_frame *);
boolean exceptions_in_RAM; /* TRUE if in RAM */
#if defined(ppc403)
@@ -47,7 +48,7 @@ typedef struct @{
boolean serial_cts_rts;
unsigned32 serial_rate;
unsigned32 timer_average_overhead; /* in ticks */
- unsigned32 timer_least_valid; /* Least valid number from timer */
+ unsigned32 timer_least_valid; /* Least valid number from timer */
#endif
@};
@end example