gensyms Command
Purpose
Gathers all the necessary information to run the curt, splat, and tprof commands in offline mode.
Syntax
gensyms [-o ] [ -f ] [ -F ] [ -h ] [ -s ] [ -g ] [ I ] [ -N ] [ -k kernel] [-i file] [-b binary[,binary[,...]]] [ -P pid[,pid[,...]]] [-S path]
Description
The gensyms command gathers name to address mapping information necessary for
the curt, splat, and tprof commands to work
in offline mode. The information that is gathered includes the following items:
- The list of all the loaded kernel extension.
- The list of all the loaded shared libraries.
- The list of all the loaded processes.
- For /unix, all kernel extensions, libraries, and all object files corresponding to processes, the output of the stripnm command is collected.
Flags
| Item | Description |
|---|---|
| -b binary | Specifies an optional list of binaries for which to find symbols. |
| -f | Suppresses printing of source file names. |
| -F | Collects the device information for physical and logical volumes. |
| -g | Decodes symbol names. |
| -h | Prints help message. |
| -i file | Reads symbols from specified file. |
| -I | Prints binary instructions of symbols. |
| -k kernel | Specifies the name of the kernel image (default /unix). |
| -N | Prints the source line number of symbols. |
| -o | Prints offset instead of addresses |
| -P pid[,pid[,...]] | Prints the symbols of dependent modules that are loaded by the specified processes. This flag is optional. |
| -s | Finds symbols only for files specified by the -k and -b flags. |
| -S path | Specifies the search path list; it is used to find binaries. |
Security
Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged
operations. For more information about authorizations and privileges, see Privileged Command
Database in Security. For a list of privileges and the
authorizations associated with this command, see the lssecattr command or the
getcmdattr subcommand.
Examples
- To collect information that is required for the tprof command in offline mode
with the profiling of user program test, enter the following command:
gensyms > test.syms - To collect information about the specified process ID and its dependent
processes, enter the following
command:
gensyms -P pid > test.syms