(Backtrace): Document that free-standing environments do not need

to have a `main' function.
This commit is contained in:
Eli Zaretskii 2005-06-18 13:12:04 +00:00
parent 76d17f347a
commit d416eeec97
2 changed files with 7 additions and 1 deletions

View file

@ -11,6 +11,8 @@
--with-sysroot.
(Machine Code): Document possible problems with locations in
shared libraries.
(Backtrace): Document that free-standing environments do not need
to have a `main' function.
2005-06-18 Nick Roberts <nickrob@snap.net.nz>

View file

@ -4300,7 +4300,11 @@ you are interested in, or recompile without optimizations.
@cindex startup code, and backtrace
Most programs have a standard user entry point---a place where system
libraries and startup code transition into user code. For C this is
@code{main}. When @value{GDBN} finds the entry function in a backtrace
@code{main}@footnote{
Note that embedded programs (the so-called ``free-standing''
environment) are not required to have a @code{main} function as the
entry point. They could even have multiple entry points.}.
When @value{GDBN} finds the entry function in a backtrace
it will terminate the backtrace, to avoid tracing into highly
system-specific (and generally uninteresting) code.