dvhtool(8) [debian man page]

DVHTOOL(8)						      System Manager's Manual							DVHTOOL(8)

NAME

       dvhtool - Disk volume header manipulation tool

SYNOPSIS

       dvhtool --device devicename [ option ]

       dvhtool -d devicename [ option ]

DESCRIPTION

       dvhtool	is  a  utility for displaying SGI disk partition and volume header information as well as for copying files to and from the volume
       header.

       It is similar to the IRIX(tm) utility of the same name, however the options and usage are quite different.  Also, the IRIX  utility  cannot
       display partition and boot file information.

       The disk volume header includes the disk partition table and the volume directory.  The volume directory is an index to the files stored in
       the volume header part of the disk.  These files can be anything but are usually standalone programs (like sash, the SGI standalone shell).
       The  space  available for files is usually limited to one, two or a few megabytes, this can only be changed by repartitioning the disk with
       fx, the SGI disk formatting and partitioning tool or fdisk.

       You must be root to invoke dvhtool.  The device name can be /dev/sda for the first disk, /dev/sdb for the second, and so on.

       dvhtool will also work on a file image of a disk volume header.

       OPTIONS -d,  --device devicename Specify the volume header device name (or file image)

       --print-volume-header
	      Show volume header data only

       --print-volume-directory
	      Show volume table of contents

       --print-partitions
	      Show partition data

       --print-all
	      Equivalent to all three above options

       --vh-remove name
	      Remove volhdr file name.

       --vh-to-unix name file
	      Copy volhdr file name to Unix file file

       --unix-to-vh file name
	      Copy Unix file file to volhdr as name

       --help Show usage information

SEE ALSO

       fdisk(8)

       IRIX tools: fx(1M), prtvtoc(1M), vh(7M).

AUTHORS

       dvhtool was written by Ralf Baechle <ralf@oss.sgi.com>, Keith M. Wesolowski <wesolows@foobazco.org>, Tor Arntsen  <tor@spacetec.no>,  Guido
       Guenther <agx@debian.org>.

4th Berkeley Distribution					     July 2000								DVHTOOL(8)

rmvol(8)						      System Manager's Manual							  rmvol(8)

NAME

       rmvol - Removes a volume from an existing file domain

SYNOPSIS

       /usr/sbin/rmvol [-f] [-v] special domain

OPTIONS

       Forces  the  removal  of  a volume that contains one or more stripe segments without first requesting confirmation.  Displays messages that
       describe which files are moved off the specified volume. Using this option slows the rmvol process.

OPERANDS

       Specifies the block device special file name, such as /dev/disk/dsk2c, of the volume that you are removing from the file domain.  Specifies
       the name of the file domain.

DESCRIPTION

       The  rmvol  utility  enables you to decrease the number of volumes within an existing file domain. When you attempt to remove a volume, the
       file system automatically migrates the contents of that volume to another volume in the file domain.

       The logical structure of the filesets in a file domain is unaffected when you remove a volume. If you  remove  a  volume  that  contains  a
       stripe segment, the rmvol utility moves the segment to another volume that does not already contain a stripe segment of the same file. If a
       file is striped across all volumes in the file domain, the utility requests confirmation before placing a second stripe segment on a volume
       that has one.

       Before  you  can remove a volume from a file domain, all filesets in the file domain must be mounted. If you try to remove a volume from an
       active file domain that includes unmounted filesets, the system displays an error message indicating that a fileset is unmounted. This mes-
       sage is repeated until you mount all filesets in the file domain.

       If  you	attempt  to  remove  a volume from an inactive file domain, the system returns the ENO_SUCH_DOMAIN error message. A file domain is
       inactive when none of its filesets is mounted. In this case, the rmvol command does not remove the volume.

       If there is not enough free space on other volumes in the file domain to accept the offloaded files from the departing  volume,	the  rmvol
       utility	moves as many files as possible to free space on other volumes. Then a message is sent to the console indicating that there is not
       enough space to complete the procedure. The files that were not yet moved remain on the original volume.

       You can interrupt the rmvol process without damaging your file domain. AdvFS will stop  removing  files	from  the  volume.  Files  already
       removed from the volume will remain in their new location. Interrupting an rmvol operation with the kill command can leave the volume in an
       inaccessible state. If a volume does not allow new allocations after an rmvol operation, use the chvol command with the -A option to  reac-
       tivate the volume.

RESTRICTIONS

       You cannot run the rmvol utility while the defragment, balance, rmfset, or rmvol utility is running on the same domain.

       You must be the root user to use this utility.

EXAMPLES

       The  following  example	removes  a  volume  from  an  active  file  domain  called  accounts_dmn.  The	file  domain contains two volumes,
       /dev/disk/dsk1c and /dev/disk/dsk2c.   This  example  removes  volume  /dev/disk/dsk1c  from  the  file	domain:  #  rmvol  /dev/disk/dsk1c
       accounts_dmn

	      The  /etc/fdmns/accounts_dmn  subdirectory now has only one entry, the entry for /dev/disk/dsk2c.  The following example removes one
	      volume from a three-volume file domain. Each volume in the accounts_dmn file domain contains one segment of /usr/myfile, which is  a
	      three-way striped file: # rmvol /dev/disk/dsk3c accounts_dmn

	      rmvol: Removing volume '/dev/disk/dsk3c' from domain 'accounts_dmn'

	      This  volume  contains one stripe segment of /usr/myfile, which will be moved to another volume in the file domain that already con-
	      tains a stripe segment of /usr/myfile.

	      Do you want to continue? (y/n):y

	      One volume in the accounts_dmn file domain now contains two stripe segments of myfile, which is no longer an optimally striped file.

FILES

       Specifies the command path.  Contains file domain names and devices.

SEE ALSO

       addvol(8), advfs(4), advscan(8), fdmns(4), mkfdmn(8), stripe(8)

																	  rmvol(8)