dload
Loads debugging information
Format
dload [ -g gid ] [ -r hname ]
[ { -np | -procs | -tasks } num ]
[ -nodes num ]
[ -replay | -no_replay ]
[ -mpi starter ]
[ -starter_args argument ]
[ -env variable=value ] ...
[ -e executable]
[ -parallel_attach_subset subset_specification ]
Arguments
-g gid
Sets the control group for the process being added to the group ID specified by gid. This group must already exist. (The CLI GROUPS variable contains a list of all groups.)
-r hname
The host on which the process will run. The CLI launches a TotalView Debugger Server on the host machine if one is not already running there. (See
“Setting Up Remote Debugging Sessions” in the
TotalView for HPC User Guide for information on the server launch commands.)
{ -np | -procs | -tasks } num
Indicates the number of processes or tasks that the starter program creates.
-nodes num
Indicates the number of nodes upon which your program will execute.
-replay | -no_replay
These options enable and disable the ReplayEngine the next time the program is restarted. To enable, the feature must be supported and licensed on the current platform.
-starter_args argument
Indicates additional arguments to be passed to the starter program.
-env variable=value
Sets a variable that is added to the program’s environment.
Adds, changes, or removes an environment variable in the target process. A target process inherits its environment from its parent process, but this option allows you to modify the environment passed to target processes created by the debugger. If the variable does not exist in the inherited environment, it is inserted with the given value. If the variable already exists in the inherited environment, it is replaced with the given value. In either case, value can be an empty string. If the string contains no equal sign, then variable is removed from the inherited environment.
Multiple -env options may be specified.
-e
Indicates that the next argument is an executable file name. You need to use -e if the executable name begins with a dash (-) or consists of only numeric characters. Otherwise, just provide the executable file name.
executable
A fully or partially qualified file name for the file corresponding to the program.
-parallel_attach_subset subset_specification
Defines a list of MPI ranks to attach to when an MPI job is created or attached to. The list is space-separated; each element can have one of three forms:
rank: specifies that rank only
rank1-rank2: specifies all ranks between rank1 and rank2, inclusive
rank1-rank2:stride: specifies every strideth rank between rank1 and rank2
A rank must be either a positive decimal integer or max (the last rank in the MPI job).
A subset_specification that is the empty string ("") is equivalent to 0-max.
For example:
dload -parallel_attach_subset {1 2 4-6 7-max:2} mpirun
will attach to ranks 1, 2, 4, 5, 6, 7, 9, 11, 13,...
Description
The dload command creates a new TotalView process object for the executable file and returns its TotalView ID.
NOTE >> Your license limits the number of processes that you can run at the same time. For example, the maximum number of processes for TotalView Individual is 16. As some systems and run time environments create threads to manage a process, you may not be able to get this many processes running at the same time. (Only TotalView Individual counts threads against your license. TotalView Enterprise and Team allows an unlimited number of threads to run at the same time.)
Command alias
Alias | Definition | Description |
lo | dload | Loads debugging information |
Examples
dload do_this
Loads the debugging information for the do_this executable into the CLI. After this command completes, the process does not yet exist and no address space or memory is allocated to it.
dload -mpi POE -starter_args "hfile=~/my_hosts" \
-np 2 -nodes
Loads an MPI job using the POE configuration. Two processes will be used across nodes. The hfiles starter argument is used.
lo -g 3 -r other_computer do_this
Loads the debugging information for the do_this executable that is executing on the other_computer machine into the CLI. This process is placed into group 3.
f g3 lo -r other_computer do_this
Does not do what you would expect it to do because the dload command ignores the focus command. Instead, this does exactly the same thing as the previous example.
dload -g $CGROUP(2) -r slowhost foo
Loads another process based on image foo on machine slowhost. The CLI places this process in the same group as process 2.
dload -env DISPLAY=aurora:0.0
-env STARTER=~/starter myprog
Sets up two environment variables $DISPLAY and $STARTER for the program myprog and loads myprog's debugging information.
Related Topics