pdirm(1M)                                                  pdirm(1M)


       NAME
             pdirm - remove existing mass-storage devices from the UNIX
             System configuration

       SYNOPSIS
             /sbin/pdirm -h [-n] disk number

       DESCRIPTION
             This script, pdirm, removes support for an existing mass-
             storage device from the UNIX System configuration, allowing
             the device to be removed from the SCSI bus and taken out of
             service.  This is the converse function to pdiadd -h which
             allows the hot insertion of supported mass-storage devices.

          Options
             pdirm takes the following options:

             -h disk node|device alias|disk number
                   Inform the system that a device will be removed. When
                   the -h argument is used, pdirm must be run from the
                   console (unless the -n option is used). It takes one
                   argument that can be either the device node, device
                   alias, or disk number. The disk number can be of the
                   following forms: cWbXtYlZ, cWbXtY, cWtYlZ, cWtY.  In the
                   disk number, the W, X, Y, and Z specify the controller,
                   bus, target, and lun.  If the bus is not specified, then
                   it assumed to be zero. If the lun is not specified, then
                   all luns associated with the device are removed. If the
                   device has multiple luns, then pdirm must be run on each
                   of the device nodes or the second form may be used and
                   the lun left unspecified.

             -n    Allow the user to override the system's temporarily
                   halting when pdirm quiets the SCSI bus.  This option
                   also removes the requirement that pdirm be run from the
                   console.

          Return Values
             Because pdirm calls other system commands to perform the
             system reconfiguration, it reports all errors encountered by
             those commands, then cleans up intermediate files created in
             the process.

       USAGE
             Hot insertion/removal is the ability to add and remove SCSI
             devices from a running system.  This feature works with all


                           Copyright 1994 Novell, Inc.               Page 1

      pdirm(1M)                                                  pdirm(1M)


            packages that access the HBA driver, including, but not
            limited to, mounted file systems, the Veritas Volume Manager,
            and raw device access through /dev/rdsk.

            To use this feature,  the HBA and target drivers must support
            hot insertion/removal.

            The system administrator does the following to remove a device
            from the system:

            1.  Ensure that removing the device will not alter the SCSI
            bus termination.  The device cannot be removed if the SCSI bus
            termination will be altered.

            2.  Execute /sbin/pdirm with the -h option and the device node
            as arguments.  If the command fails because either the target
            or HBA driver doesn't support hot insertion/removal, then the
            device cannot be removed. If the command fails because the
            device is open, then the system administrator must correct
            this before the command can be re-executed. pdirm will quiet
            the SCSI bus and notify the user when it is safe to remove the
            device from the system.

            3.  Remove the device from the SCSI bus.

            4.  Press the RETURN key to inform pdirm that the device has
            been removed and normal SCSI bus operation may resume.

      REFERENCES
            diskadd(1M), pdiadd(1M)


















                          Copyright 1994 Novell, Inc.               Page 2