dload

Loads debugging information

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 of the TotalView User 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.