drvinstall(1M)    MISC. REFERENCE MANUAL PAGES     drvinstall(1M)



NAME
     drvinstall - install/uninstall a driver

SYNOPSIS
     /usr/sbin/drvinstall [ -m master ] [ -d object ] [ -s system
     ]
     [ -o directory ] [ -c minor ] -v version [ -ufbnx ]

DESCRIPTION
     The drvinstall command accepts an object file,  master  file
     and  system  file  as  inputs, and creates the corresponding
     specially formatted file for use in the configuration  of  a
     new  bootable operating system.  In addition, the master and
     system files may be modified.  The -u  option  is  used  for
     uninstalling  a driver.  Pathnames specified for the options
     below can be either relative or absolute pathnames.

     -m master
          specifies the path name of the master directory  to  be
          used.   One  or  both  of  the -m or -d options must be
          specified, and at least one must specify a file name as
          the  last  component of the path name.  If this flag is
          omitted, the /etc/master.d directory is used.

     -d object
          specifies the path name of the input  object  directory
          to  be  used.  One or both of the -m or -d options must
          be specified, and at least one must specify a file name
          as  the  last component of the path name.  If this flag
          is omitted, the /boot directory is used.

     -s system
          specifies the path name of the system file to be  used.
          If  this  flag  is  omitted,  the /stand/system file is
          used.

     -o directory
          specifies the path name of the  output  bootable  file.
          If this flag is omitted, the /boot directory is used.

     -c minor
          specifies the minor number to be inserted at the end of
          an  INCLUDE  statement  for  the  driver.   The INCLUDE
          statement is inserted in the  system  file.   Minor  is
          optional  in  an  INCLUDE  and  specifies  the quantity
          (default of 1) of minor devices to be controlled by the
          driver.   If  the  driver  is  a hardware driver, -c is
          ignored.

     -v version
          specifies the version number of the drvinstall  command
          compatible  with  the  master  file being used.  The -v



                Last change: Essential Utilities                1

drvinstall(1M)    MISC. REFERENCE MANUAL PAGES     drvinstall(1M)



          option is required on the command  line  and  currently
          supports "1.0".

     -u   specifies that the named driver is to  be  uninstalled.
          A  driver  dependency check is made and if a dependency
          is found, a warning message is issued and  the  command
          is aborted.  If no dependency is found, then drvinstall
          will:

           ⊕   Remove the bootable object file.

           ⊕   Replace the major number with a "-" in the  master
               file if the driver is a software driver.

           ⊕   Delete the INCLUDE statement from the system  file
               if the driver is not a hardware driver.

           ⊕   Print the major number if the driver is a software
               driver.

     -f   when used with the -u option, disables  the  dependency
          check.   This  results  in the driver being uninstalled
          regardless of dependencies.

     -b   inhibits generation of the object file.  This option is
          ignored for uninstall.

     -n   Inhibits any edit of the system file.

     -x   Enables debugging output.  For  any  driver  installed,
          drvinstall  calls the mkboot command to produce a boot-
          able object file.  The resultant output file is  placed
          into  the  directory determined by the -o argument.  If
          the driver to be installed is a software driver, drvin-
          stall will:

     ⊕   Assign a major number to that driver if there is  a  "-"
         entry in the major number field of the associated master
         file entry.  The drvinstall command expects  any  unused
         field of the master file to be filled with a "-".

         The major numbers available for software drivers on AT&T
         3B2  Computers are 30-71 inclusive.  The remaining major
         numbers are  reserved  for  hardware  devices,  used  by
         integral  drivers,  or  reserved  for SCSI devices.  The
         drvinstall  command  determines  the   available   major
         numbers  by scanning all existing files in /etc/master.d
         for major numbers;  it then  assigns  the  first  unused
         number  in  the  above  range  (note  that the directory
         specified by master on the command line is not  searched
         for major numbers).  This value replaces the correspond-
         ing "-" value in the major number field  of  the  master



                Last change: Essential Utilities                2

drvinstall(1M)    MISC. REFERENCE MANUAL PAGES     drvinstall(1M)



         file.

     ⊕   Print the major number found or assigned in  the  master
         file.

     If the driver to be installed is not a hardware  driver  (it
     is,  e.g.,  a software driver or a loadable type of module),
     drvinstall will insert an INCLUDE statement for  the  driver
     in the system file.

SEE ALSO
     cunix(1M), mkboot(1M).
     master(4), system(4) in the Programmer's Reference Manual.

DIAGNOSTICS
     The major number assigned or found for a software driver  is
     printed  on  stdout.   A  zero is returned for success and a
     non-zero is returned for failures.





































                Last change: Essential Utilities                3