ltrace(1) General Commands Manual ltrace(1)
NAME
ltrace - trace inter-module procedure calls
SYNOPSIS
logfile] executable argument]
Remarks
is not available on PA-RISC systems. Currently is available only for 32-bit applications on Integrity systems.
DESCRIPTION
is a call tracing tool that traces procedure calls across different load modules in an application (the executable on the command line).
logs trace messages to a file.
By default, logs messages to a file named which is created in the current working directory. Trace messages can be logged to a specified
file using the option. Subsequent invocations of append the trace messages to the existing logfile even if the application is different.
To log messages in different files, use the option by specifying a different filename at each invocation.
shows the arguments in the procedure call if the load module is built in debug mode. In addition, arguments of some commonly used routines
are shown even if the debug version of is not available.
Options
recognizes the following options:
By default creates a file named to log the trace messages. Use this option to specify a different log file name for logging
trace messages. See
Subsequent invocations of append the trace messages to the existing logfile even if the application is different. To
log messages in different files, specify a different filename at each invocation of the command.
Specify the argument(s) to be passed to the application.
Multiple arguments should be given within quotes. See
EXTERNAL INFLUENCES
Environment Variables
uses the following environment variables to locate shared libraries.
These environment variables can be used to specify the directories
to be searched for library files at runtime. The value is a colon-separated list of paths of such directories. For
more information, see in dld.so(5) or the option in ld(1).
The following internationalization variables affect the execution of
Determines the locale category for native language, local customs,
and coded character set in the absence of and other environment variables. If is not specified or is set to an empty
string, a default of is used instead of (see lang(5)).
Determines the values for all locale categories and has
precedence over and other environment variables.
Determines the locale that should be used to affect the format
and contents of diagnostic messages written to standard error.
Determines the locale category for numeric formatting.
Determines the locale category for character handling functions.
Determines the location of message catalogs for the processing of
If any internationalization variable contains an invalid setting, behaves as if all internationalization variables are set to See envi-
ron(5) for more information about environment variables.
RETURN VALUE
returns zero on success. A non-zero value is returned in case of failure.
EXAMPLES
In the following example, creates a file named in the current working directory, traces procedure calls to all libraries used by the appli-
cation, and logs the messages in
The file contains the following trace messages:
The following invocation creates a logfile named to log the trace messages:
The following invocation shows how to pass the argument to the command being traced:
The following invocation shows how to pass multiple arguments:
AUTHOR
was developed by the Hewlett-Packard Company.
FILES
32-bit Integrity system dynamic loader
64-bit Integrity system dynamic loader
message catalog
ALSO SEE
System Tools
ldd(1) Lists dynamic dependencies of executable files and shared libraries.
Miscellaneous
a.out(4) assembler, compiler, and linker output.
dld.so(5) dynamic loader.
Texts and Tutorials
Integrity Systems Only ltrace(1)