pump(1M)                                                           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 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)].


   7/91                                                                 Page 1

   pump(1M)                                                           pump(1M)


         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).














   Page 2                                                                 7/91