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 sections 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 peripheral 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 complete list).

Can't open a.out filename for reading!

The error may be that there is no such file or the permissions 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 peripheral 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).