24.05.2014 Views

XL Fortran Enterprise Edition for AIX : User's Guide - IBM

XL Fortran Enterprise Edition for AIX : User's Guide - IBM

XL Fortran Enterprise Edition for AIX : User's Guide - IBM

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

-qtbtable Option<br />

Syntax<br />

-qtbtable={none | small | full}<br />

Limits the amount of debugging traceback in<strong>for</strong>mation in object files, which<br />

reduces the size of the program.<br />

You can use this option to make your program smaller, at the cost of making it<br />

harder to debug. When you reach the production stage and want to produce a<br />

program that is as compact as possible, you can specify -qtbtable=none.<br />

Otherwise, the usual defaults apply: code compiled with -g or without -O has full<br />

traceback in<strong>for</strong>mation (-qtbtable=full), and code compiled with -O contains less<br />

(-qtbtable=small).<br />

Arguments<br />

none The object code contains no traceback in<strong>for</strong>mation at all. You cannot debug<br />

the program, because a debugger or other code-examination tool cannot<br />

unwind the program’s stack at run time. If the program stops because of a<br />

run-time exception, it does not explain where the exception occurred.<br />

small The object code contains traceback in<strong>for</strong>mation but not the names of<br />

procedures or in<strong>for</strong>mation about procedure parameters. You can debug the<br />

program, but some non-essential in<strong>for</strong>mation is unavailable to the<br />

debugger. If the program stops because of a run-time exception, it explains<br />

where the exception occurred but reports machine addresses rather than<br />

procedure names.<br />

full The object code contains full traceback in<strong>for</strong>mation. The program is<br />

debuggable, and if it stops because of a run-time exception, it produces a<br />

traceback listing that includes the names of all procedures in the call chain.<br />

Background In<strong>for</strong>mation<br />

This option is most suitable <strong>for</strong> programs that contain many long procedure<br />

names, such as the internal names constructed <strong>for</strong> module procedures. You may<br />

find it more applicable to C++ programs than to <strong>Fortran</strong> programs.<br />

Restrictions<br />

To use the per<strong>for</strong>mance tools, such as tprof, in the <strong>AIX</strong> Per<strong>for</strong>mance Toolbox, you<br />

must compile the <strong>Fortran</strong> programs with -qtbtable=full.<br />

Related In<strong>for</strong>mation<br />

See “-g Option” on page 108, “-O Option” on page 114, “Debugging Optimized<br />

Code” on page 321, and “-qcompact Option” on page 142.<br />

<strong>XL</strong> <strong>Fortran</strong> Compiler-Option Reference 249

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!