pump(1M) MISC. REFERENCE MANUAL PAGES pump(1M)
NAME
pump - Download B16 or X86 a.out file to a peripheral board
SYNOPSIS
/sbin/pump /dev/devname file
DESCRIPTION
The pump command will read a B16 or X86 a.out file's sec-
tions into a buffer according to the physical address of the
section. The command can be used only by the super-user.
pump expects a section in the a.out file called .start.
Once it has found this section, pump will inform the peri-
pheral to start executing at the address that it found in
.start after it has downloaded the a.out file.
There are four phases of the pump operation:
reset This phase will cause a hardware reset on the
peripheral.
download This phase will download the a.out file to
the peripheral.
force call to function
This phase will inform the peripheral to
start executing at the address found in the
.start section.
sysgen This phase will sysgen the peripheral. It
allows normal functioning of the peripheral
to occur.
Error Messages
pump error: UNIX_error_number - Can't get status of
/dev/devname
There may be no /dev/devname.
pump Error: error_number - ioctl call
The ioctl call failed. The error_number returned can be a
UNIX system error number or, in the case of the NI, an error
number of 208. Error number 208 is a timeout message. The
peripheral board did not respond in time to the request made
of it (this is not the only error, see intro(2) for a com-
plete list).
Last change: Essential Utilities 1
pump(1M) MISC. REFERENCE MANUAL PAGES pump(1M)
Can't open a.out filename for reading!
The error may be that there is no such file or the permis-
sions are such that the file cannot be read [see chmod(1)].
Error: Object file is not in b16 or x86 common object format
The file to be downloaded to the peripheral is not a B16 or
X86 a.out file.
Section size is too big for the buffer
The a.out file may be greater that the 32K bytes that is the
limit of RAM on the peripheral.
Error: No section name called .start
pump needs .start for the starting address that the peri-
pheral needs to execute the downloaded code.
pump: /dev/devname returned a CIO FAULT during phase
The peripheral encountered a hardware fault during one of
the phases of the pump.
pump: /dev/devname returned a CIO Invalid Queue Entry during
phase
The peripheral did not understand the command phase that was
issued by pump.
pump: /dev/devname did not respond during phase
The UNIX system driver called may not have understood the
command.
pump: A timeout has occurred on /dev/devname during phase
The peripheral did not respond to one of the commands given.
pump: There was no return code for /dev/devname during phase
The return code that was given may have been corrupted.
SEE ALSO
intro(2), a.out(4).
Last change: Essential Utilities 2