ltrace.1 (2010 09)

l
ltrace(1)
Integrity Systems Only
ltrace(1)
NAME
ltrace - trace inter-module procedure calls
SYNOPSIS
ltrace [-f logfile] executable [
-a argument ]
Remarks
ltrace is not available on PA-RISC systems. Currently
ltrace is available only for 32-bit applications
on Integrity systems.
DESCRIPTION
ltrace is a call tracing tool that traces procedure calls across different load modules in an application
(the executable on the ltrace command line).
ltrace logs trace messages to a file.
By default,
ltrace logs messages to a file named
logfile.txt which is created in the current work-
ing directory. Trace messages can be logged to a specified file using the
-f option. Subsequent invoca-
tions of
ltrace append the trace messages to the existing logfile even if the application is different. To
log messages in different files, use the
-f option by specifying a different filename at each invocation.
ltrace shows the arguments in the procedure call if the load module is built in debug mode. In addi-
tion, arguments of some commonly used libc
routines are shown even if the debug version of libc is
not available.
Options
ltrace recognizes the following options:
-f logfile By default ltrace creates a file named logfile.txt to log the trace messages.
Use this option to specify a different log file name for logging trace messages. See
EXAMPLES.
Subsequent invocations of
ltrace 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 ltrace command.
-a argument
-a "arguments"
Specify the argument(s) to be passed to the application. Multiple arguments should
be given within quotes. See EXAMPLES.
EXTERNAL INFLUENCES
Environment Variables
ltrace uses the following environment variables to locate shared libraries.
LD_LIBRARY_PATH
SHLIB_PATH 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 Dynamic Path List in dld.so (5) or the +s
option in ld (1).
The following internationalization variables affect the execution of
ltrace:
LANG Determines the locale category for native language, local customs, and coded char-
acter set in the absence of LC_ALL and other LC_* environment variables. If
LANG is not specified or is set to an empty string, a default of C is used instead of
LANG (see lang (5)).
LC_ALL Determines the values for all locale categories and has precedence over LANG and
other LC_* environment variables.
LC_MESSAGES
Determines the locale that should be used to affect the format and contents of diag-
nostic messages written to standard error.
LC_NUMERIC Determines the locale category for numeric formatting.
LC_CTYPE Determines the locale category for character handling functions.
NLSPATH Determines the location of message catalogs for the processing of LC_MESSAGES.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1