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