pdiconfig(1M)                                          pdiconfig(1M)


       NAME
             pdiconfig - determine which PDI disk, tape, and SCSI
             controllers are present

       SYNOPSIS
             /etc/scsi/pdiconfig [-R ROOT] [-f driver name,...] [filename]

       DESCRIPTION
             pdiconfig(1M) queries the Portable Device Interface (PDI)
             subsystem to determine which disk, tape, and SCSI controllers
             are present.  pdiconfig reads the Equipped Device Table (EDT)
             built by the PDI drivers to determine which disk, tape, and
             SCSI controllers are present.  This information is output in a
             format suitable for piping directly to diskcfg.

          Options
             pdiconfig accepts the following options:

             -R ROOT
                   Uses this value instead of / for the root of a kernel
                   source tree.

             -f driver name,...
                   Force the named driver to be turned on in the current
                   PDI configuration.  driver name is the short name of the
                   driver. This option is repeatable.

             filename
                   Directs output to filename instead of to standard
                   output.

          Output
             The output includes all of the information needed by diskcfg
             to reconfigure the System files so that a kernel can be built
             containing only those drivers needed for devices actually
             present on the system.

             The format of the output for pdiconfig is:

                   driver name
                   long driver name
                   driver type
                   configure flag
                   unit number
                   dma channel 1
                   dma channel 2


                           Copyright 1994 Novell, Inc.               Page 1

      pdiconfig(1M)                                          pdiconfig(1M)


                  ipl level
                  interrupt vector
                  interrupt sharing flag
                  starting I/O address
                  ending I/O address
                  starting memory address
                  ending memory address
                  cpu binding

            Each field has a value present and is tab separated.  If an
            error occurs while trying to retrieve the EDT or configuration
            information, or if no devices are found in the EDT, pdiconfig
            will terminate with a non-zero return value.

            Note that pdiconfig does not use the shell variable ROOT from
            the user's environment as its starting path.  You can specify
            a value for ROOT by using the -R option.  The -R option should
            not be used except for the special case of kernel development
            in a non-root source tree.

         Return Values
            On success, pdiconfig exits with a return code of 0 On
            failure, it returns a non-zero code.

      USAGE
            pdiconfig is an administrative command and must be run in
            single user mode.  See init(1M) for information on switching
            the machine to single user mode.

            Any loadable target drivers, such as st01(7), sc01(7), or
            sw01(7), that deal with PDI devices, must be demand loaded
            before executing pdiconfig.  See modadmin(1M) for information
            on loading loadable drivers.

      REFERENCES
            disk.cfg(4), diskcfg(1M), init(1M), pdiadd(1M), pdirm(1M)












                          Copyright 1994 Novell, Inc.               Page 2