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. See GROUPS for more information.)

-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 The tvdsvr Command and its Options for more information.

{ -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.

-mpi MPI_name

Names the starter configuration, either a configuration supplied by TotalView or one created and named using the TV::parallel_configs variable.

-mpi_style mpi_startup_style

Specifies the MPI startup style. The default is “native” for MPIs that support MPIR debugging interface. Alternatively, for all MPIs, “bootstrap” can be specified.

-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,...

-list_reverse_connect

Lists all the available reverse connect requests that are found. Each request is preceded by the reverse connect ID.

-reject_reverse_connect [ ID | all ]

Rejects a reverse connection.

If an ID is specified, then that specific request is rejected. The waiting back end initiating the request will be terminated. If "all" is specified, then all requests found will be rejected. If no ID is specified, the first request seen will be rejected.

-accept_reverse_connect [ ID ]

Accepts a reverse connection.

If an ID is specified, then that specific request is accepted. If no ID is specified, the first request seen will be accepted.

Description

The dload command creates a new TotalView process object for the executable file and returns its TotalView ID.

Command alias

Alias	Definition	Description
lo	dload	Loads debugging information
lo -list_rc	dload -list_reverse_connect	Lists any reverse connection requests found
lo -reject_rc	dload -reject_reverse_connect	Reject either all or one reverse connection requests
dload -accept_rc	dload -accept_reverse_connect	Accept either all or one reverse connection requests

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 –mpi_style native -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.

Sets up two environment variables $DISPLAY and $STARTER for the program myprog and loads myprog's debugging information.

Related Topics

Loading Programs Using the CLI

dattach

drun