dload

Loads debugging information

MiniContents:

Arguments
Description
Command alias
Examples

Format:

dload [ -g gid ] [ -r hname ] [ -e ] executable

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 will launch a TotalView Debugger Server on the host machine if one is not already running there. See Chapter 5, "Setting Up Parallel Debugging Sessions" of the TotalView Users Guide for information on the server launch commands.

-e

Tells the CLI that the next argument is a file name. You need to use this argument if the file name begins with a dash or only uses numeric characters.

executable

A fully or partially qualified file name for the file corresponding to the program.

Description:

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

Command alias:

You may find the following alias useful:

Alias	Definition	Meaning
lo	{dload}	Loads debugging information

Examples:

dload do_this

Loads the debugging information for executable do_this into the CLI. After this command completes, the process does not yet exist and no address space or memory is allocated to it.

lo -g 3 -r other_computer do_this

Loads the debugging information for executable do_this 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.

dload -g $CGROUP(2) -r slowhost foo

Loads another process based on image foo on machine slowhost. TotalView places this process in the same group as process 2.