dl(1N) dl(1N)
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.
7/91 Page 1
dl(1N) dl(1N)
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 setpr,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.
Page 2 7/91