NAME

dl − Common Environment download utility

SYNOPSIS

dl [-options] [file] dst_cpu

DESCRIPTION

dl performs the download and/or execution of object code to a remote CPU executing the Common Environment.  The remote CPU is indicated by dst_cpu.  The COFF/ELF format object file read during the download is indicated by file.  The default object file format is COFF.  The following options direct  the action of dl:

-l Directs dl only to download the object code from file to the remote Common Environment. 

-x section
Directs dl to exclude the section section from the download.  This option may be repeated for each section to be excluded.  Section is the name of the section to be excluded.  This option is applicable only to COFF format files. 

-E Specifies that the object file format is ELF. 

-e Directs dl only to perform the execution of the object code at the address contained in the entry_point field of file. 

-a address,argument
Directs dl to perform execution of the object code at the address given by address.  The execution is performed as a function call from the Common Environment. Argument is supplied as an unsigned long integer to the function.  Argument must be an integer in octal, decimal or hexadecimal. 

-s symbol,argument
Directs dl to perform execution of the object code at the address of symbol found in file.  The execution is performed as a function call from the Common Environment and argument is supplied as an unsigned long integer to the function.  Argument must be an integer in octal, decimal or hexadecimal. 

If no options are supplied to dl, then file must be supplied and dl downloads the object code and performs execution at the entry_point found in file. 

EXAMPLES

dl a.out 2
Download and execute the file a.out.

dl -l a.out 2
Download the object from a.out without executing. 

dl -e a.out 2
Execute the object at the entry_point in a.out. 

dl -a 0xfff09000,1 2
Execute object at the address 0xfff09000 as a function call with the argument of 1.

dl -x.bss a.out 2
Download all sections from a.out except the .bss section and then execute at the entrypoint in a.out. 

dl -s set_pr,0 a.out 2
Execute object at the address of the "set_pr" function as a function call with the argument of 0.  Set_pr’s address is found in a.out.