aqdev — Apollo

10.0;aqdev (acquire_device), revision 1.0, 87/10/20
aqdev (acquire_device) -- Acquire control of a PBU device.
usage:  aqdev pathname [-db]



DESCRIPTION
     aqdev acquires control of a peripheral bus unit (PBU) device. aqdev
     creates a new shell level in which the PBU device driver runs.  Release
     the device by closing this shell level (i.e., type CTRL/Z).

NOTE
     This command is valid only if our General Purpose Input/Output (GPIO)
     software package is installed on your network.  See the Writing Device
     Drivers with GPIO Calls for details.

ARGUMENTS
     pathname (required) Specify the Device Descriptor File (DDF) for the PBU
                         unit device to be acquired.  You can create a DDF by
                         using the crddf (create ddf) command.

OPTIONS
     -d[b]               Specify debug mode.  Display addresses of the mapped
                         DDF, library, etc., along with any errors.

     -c[program arg1 arg2 ...]
                         Specifies a program to run after acquiring the
                         device. This program is run instead of the shell.
                         aqdev releases the device after the program returns.
                         This option also allows you to use aqdev in a shell
                         script.

EXAMPLES
     $ aqdev /dev/my_dev
     Device 0 acquired.
     $ (Run your program using the device.)
     $ CTRL/Z
     *** EOF ***
     Device 0 released.
     $


     $ aqdev /dev/my_dev -c driver_application
     Device 0 acquired.
     (driver_application runs using the device.)
     Device 0 released.
     >>>>  $
Museum
