Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Studio 12.3: Debugging a Program With dbx Oracle Solaris Studio 12.3 Information Library |
4. Viewing and Navigating To Code
5. Controlling Program Execution
6. Setting Breakpoints and Traces
8. Evaluating and Displaying Data
11. Debugging Multithreaded Applications
16. Debugging Fortran Using dbx
17. Debugging a Java Application With dbx
18. Debugging at the Machine-Instruction Level
19. Using dbx With the Korn Shell
20. Debugging Shared Libraries
The pathmap command maps one path name to another for finding source files and such. The mapping is applied to source paths, object file paths, and the current working directory (if you specify -c). During macro skimming, it is also applied to include directory paths (see Using the pathmap Command To Improve Skimming). The pathmap command has identical syntax and identical functionality in native mode and in Java mode.
The pathmap command is useful for dealing with automounted and explicit NFS mounted filesystems with different paths on differing hosts. Specify -c when you are trying to correct problems arising due to the automounter since CWDs are inaccurate on automounted filesystems as well. The pathmap command is also useful if source or build trees are moved.
pathmap /tmp_mnt / exists by default.
The pathmap command is used to find load objects for core files when the dbx environment variable core_lo_pathmap is set to on. Other than this case, the pathmap command has no effect on finding load objects (shared libraries). See Debugging a Mismatched Core File.
Establish a new mapping from from to to.
Map all paths to to.
List all existing path mappings (by index).
The same, but the output can be read by dbx.
Delete the given mappings by path.
Delete the given mappings by index.
where:
from and to are filepath prefixes. from refers to the filepath compiled into the executable or object file and to refers to the filepath at debug time.
from1 is filepath of the first mapping to be deleted.
from2 is filepath of the last mapping to be deleted.
index specifies the index with which the mapping is to be inserted in the list. If you do not specify an index, the mapping is added to the end of the list.
index1 is the index of the first mapping to be deleted.
index2 is the index of the last mapping to be deleted.
If you specify -c, the mapping is applied to the current working directory as well.
If you specify -s, the existing mappings are listed in an output format that dbx can read.
If you specify -d, the specified mappings are deleted.
(dbx) pathmap /export/home/work1 /net/mmm/export/home/work2 # maps /export/home/work1/abc/test.c to /net/mmm/export/home/work2/abc/test.c (dbx) pathmap /export/home/newproject # maps /export/home/work1/abc/test.c to /export/home/newproject/test.c (dbx) pathmap (1) -c /tmp_mnt / (2) /export/home/work1 /net/mmm/export/home/work2 (3) /export/home/newproject