varyoff

PURPOSE

     Removes an external disk  drive from the operating system
     configuration.

SYNOPSIS
     varyoff [-v] -d hdisk[num] [ hdisk[num] ... ][-c][-r]

     varyoff [-v] -m hd[num] [ hd[num] ... ][-c]

     varyoff [-v] -p directory [ directory ... ][-c][-r]

DESCRIPTION

     The varyoff  command removes  an external disk  drive and
     any minidisks residing on the  disk from the existing AIX
     Operating  System hardware  and minidisk  configurations.
     File systems residing on minidisks are unmounted and file
     system consistency checks are performed.

FLAGS

     -c                   Does  not  perform file  consistency
                          checking.
     -d hdisknum . . .    Specifies the system device name for
                          an external disk drive, where num is
                          an integer from  0 to 33, inclusive.
                          The  corresponding   drive  and  the
                          minidisks residing on that drive are
                          removed   from  the   AIX  Operating
                          System.  unmount  and fsck  are per-
                          formed on  each file  system defined
                          on the disk.
     -p  directory . . .  Removes  the  disk drive  associated
                          with   each   specified   directory.
                          unmount  and fsck  are performed  on
                          each  file  system  defined  on  the
                          disk.
     -r                   Removes information  about all mini-
                          disks  on  the external  disk  drive
                          from   the  files   /etc/system  and
                          /etc/filesystems.

EXAMPLES

     1.  To remove a disk from  the AIX Operating System using
         its name:

           varyoff  -d hdisk7

         This command unmounts and  performs fsck functions on
         each  file system  defined  on the  disk drive  named
         "hdisk7".   "hdisk7" and  all  of  its minidisks  are
         removed from the operating system.
     2.  To remove more than one disk:

           varyoff  -d  hdisk9 hdisk7 hdisk12

         This command removes  disk drives "hdisk9", "hdisk7",
         and "hdisk12" from the operating system.
     3.  To remove a disk using its mount directory path name:

           varyoff  -p  /usr/lib

         This command causes the  appropriate disk and each of
         its  minidisks  to  be  removed  from  the  operating
         system.
     4.  To remove several disks by specifying mount directory
         path names:

           varyoff  -p  /usr/lib  /job/lib

     5.  To  remove  information  about all  minidisks  on  an
         external  disk drive  from  the system  configuration
         files:

           varyoff -r -d hdisk10

         This command removes  information about all minidisks
         on the  external disk drive "hdisk10"  from the files
         /etc/system and /etc/filesystems.
     6.  To avoid fsck functions when removing a disk:

           varyoff  -c -d hdisk7

FILES

     /etc/filesystems    Descriptions   of    mountable   file
                         systems.
     /etc/system         Default system file.
     /etc/system.vary.bk System backup of /etc/system.
     /etc/varyoff.out    Default error output file.

RELATED INFORMATION

     The   following  commands:    "fsck,  dfsck,"    "umount,
     unmount," "varyon," and  "vrmconfig."

     The  discussion of  external drives  in Managing  the AIX
     Operating System.

     The system and filesystems  files in AIX Operating System
     Technical Reference.