<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Transitional//EN">
<HTML>
<HEAD>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

      For third-party license citations, please see the bottom of this file.
    *************************************************************************************
  -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="TEMPLATEBASE" content="DocCD Manual Pages 1.4">
<meta name="LASTUPDATED" content="06/13/05 11:54:54">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxdump.fm">
     
<title>vxdump</title>

</HEAD>

<BODY bgcolor="#FFFFFF" link="#000066" vlink="#0000ff" marginheight="0" topmargin="0">
<basefont=1>

<a name="433610"></a>

<div align="left">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
   <td height="2" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#000000">
   </td>
 </tr>
 <tr>
   <td height="15" width="50%" border="0" cellspacing="0" cellpadding="0" bgcolor="#cccccc">
    <img src="images/vxsymbol.gif" height="20" width="31" border="0" cellspacing="0" cellpadding="0" align="left">
     
     
   </td>
   <td align="right" width="50%" bgcolor="#cccccc">

<!-- Header Breadcrumbs -->
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="newfs_vxfs_vxfs_manpages31_429421.html" title="Previous - newfs_vxfs">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxenablef_vxfs_manpages33_427121.html" title="Next - vxenablef">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
   </td>
 </tr>

 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxfs_manpages_splashpage_docCD_vxfs_manpages1_103036.vxhd" title="File System Manual Pages for Storage Foundation title page ">File System Manual Pages for Storage Foundation</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>
 <tr>
  <td bgcolor="#CCCCCC" colspan="2" height="15" align="right">
  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxfs_manpages8_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>
  &nbsp;&nbsp;
  </font>
  </td>
 </tr>


</table>
</div>

<div align="left">
 <table border="0" width="100%" bgcolor="#FFFFFF">
  <tr>
   <td width="100%" valign="top" bgcolor="#FFFFFF">

<!-- Start Main Topic Content -->
        <a name="startcontent"></a>
	
<h2><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="3" color="#000000"><a name="429893"></a>vxdump</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429916"></a> NAME</font>
</h3>
<p>
<a name="429921"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxdump - incremental file system dump </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429924"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="429929"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-cnouwW </b></font>] [ <em>-number </em>] [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b </b></font><em>blocking_factor </em>] [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-B </b></font><em>records </em>] <br>[ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d </b></font><em>density </em>] [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f </b></font><em>filename </em>] [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>size </em>] [ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>tracks </em>] <br>[ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T </b></font><em>time </em>] <em>filenames</em> 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="430091"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> <em>option</em> [ <em>argument </em>&quot;...]&quot; <em>filenames </em>
</font>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430125"></a> AVAILABILITY</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430130"></a>VRTSvxfs </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430133"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430138"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>copies to magnetic tape all files specified in <em>filenames</em> in a VxFS file system that changed after a particular date. This information is derived from the files <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/fstab</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430205"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> supports both the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>getopt</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dump</b></font> command line invocations. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dump</b></font> command line style is supported for compatibility with previous versions of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> and the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dump</b></font> program used for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ufs</b></font> file systems. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430331"></a>On most devices, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> detects end-of-media and prompts you to change the media if there is insufficient space, so it is not necessary to specify the size of the device. However, if the dump requires multiple tapes and the tapes are to be read using an older version of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore</b></font>, or if the tape device handles end-of-media in a way that <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> does not recognize, then you must specify the size of the device using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-B </b></font>option or combining the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> options. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430512"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430517"></a>Perform dumps with the file system unmounted or the system in single-user environment (see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font>(1M) manual page) to ensure a consistent dump. With snapshot capabilities enabled, the dump can be performed in the multi-user environment using a snapshot file system with the online backup facility: the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>snapof= </b></font><em>filesystem </em>option of the VxFS-specific <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount </b></font>command. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430631"></a>Up to 32 read errors on the file system are ignored. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430634"></a>Each reel requires a new process; parent processes for reels already written remain until the entire tape is written. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430646"></a>Neither <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>nor <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore </b></font>work with Storage Checkpoints. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430685"></a> CLUSTER FILE SYSTEM ISSUES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430690"></a>No cluster issues; command operates the same on cluster file systems. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430702"></a> OPTIONS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430707"></a>If no options are specified, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> assumes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-9u</b></font>, and dumps a default file system to the default device. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/rmt/0m</b></font> is the default tape device. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430767"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>- </b></font><em>number</em></font>
</p>
<p>
<a name="433867"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><em>number</em> is a single digit in the range [0-9] and indicates the dump level. All files modified since the last date stored in the file <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates</b></font> for the same file system at a lesser dump level are dumped. So the option <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-0 </b></font>dumps the entire file system. If the specified level does not determine a date, the beginning of (UNIX) time is assumed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430873"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>blocking_factor&quot;</b></font></font>
</p>
<p>
<a name="433902"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>command writes in units of logical record size times <em>blocking_factor</em>. The logical record size is 1024 bytes. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>command uses a blocking factor of 10 for tapes with densities less than 6250 BPI, 32 for tapes with densities of 6250 BPI or greater, and 63 for cartridge tapes by default. This can be overridden by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-b </b></font>option. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore </b></font>command dynamically determines the blocking factor up to the default maximum of 63. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431040"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-B </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>records&quot;</b></font></font>
</p>
<p>
<a name="433933"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The number of logical records per volume. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> logical record size is 1024 bytes. <em>records</em> can also be specified with a suffix to indicate a unit of measure other than 1024 bytes. You can append a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>k</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>m</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>g</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>t </b></font>to the number to indicate that the value is in kilobytes, megabytes, gigabytes, or terabytes, respectively. This option overrides the calculation of tape size based on length and density. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431219"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font></font>
</p>
<p>
<a name="433948"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Cartridge. Specifies using a cartridge instead of the standard half-inch reel. This sets the density to 1000 BPI and the blocking factor to 63. The length is set to 425 feet. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-c</b></font> is incompatible with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> option, unless you specify a density of 1000 BPI with that option. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431325"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>density&quot;</b></font></font>
</p>
<p>
<a name="433963"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The density of the tape (expressed in BPI) used to calculate the amount of tape used per tape reel. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font> is specified, a default density value of 1600 is assumed for a reel tape. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431386"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-f </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>filename&quot;</b></font></font>
</p>
<p>
<a name="433986"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Places the dump on the file <em>filename</em> instead of the tape. If the name of the file is <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>- (dash)</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>writes to the standard output. This option can be of the form <em>machine </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>: </b></font><em>device </em>to specify a tape device on a remote machine. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431483"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font></font>
</p>
<p>
<a name="434005"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Whenever <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> requires operator attention, notifies all users in group <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>operator</b></font> in similar fashion to that described in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>wall</b></font>(1) manual page. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431562"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o</b></font></font>
</p>
<p>
<a name="434028"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vxdumpdates</b></font> as the dump record file instead of the VxFS default file <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates</b></font>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431612"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size&quot;</b></font></font>
</p>
<p>
<a name="434043"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The size of the dump tape in feet. When the specified size is reached, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> waits for reels to be changed. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> is specified, a default size value of 2300 is assumed for a reel tape. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431692"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>tracks&quot;</b></font></font>
</p>
<p>
<a name="434058"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Specifies the number of tracks for a cartridge tape. The default is nine tracks. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-t</b></font> is not compatible with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font> option. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431762"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T </b></font><em>&quot; </em><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>date&quot;</b></font></font>
</p>
<p>
<a name="434077"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Uses the specified date as the starting time for the dump instead of the time determined by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates</b></font> file. The format of <em>date</em> is the same as that described in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctime</b></font>(3C) manual page. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> is useful for automated dump scripts to perform dumps over a specific period of time. </font>
</p>
<p>
<ul type="disc"><p>
<ul type="disc"><p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425258"></a>You can specify <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> only for incremental dumps; using <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> for a level 0  dump returns an error. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425266"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> is mutually exclusive with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-u</b></font> option. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425272"></a>If you enter an improperly formatted date, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-T</b></font> returns an error message and terminates the dump. </font>
</li>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432022"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-u</b></font></font>
</p>
<p>
<a name="434108"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the dump completes successfully, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-u</b></font> writes the date when the dump started to the file <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates</b></font>. This file records a separate date for each file system and each dump level. The format of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates </b></font>is user-readable and consists of one free format record per line: file system name, increment level and dump date in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctime </b></font>format. The file <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates </b></font>can be edited to change any of the fields if necessary. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-u</b></font> option is ignored for partial dumps. Partial dumps are equivalent to level 0 dumps for the specified files, and all specified files and directories, for a partial dump must be on the same local file system. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432218"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-w</b></font></font>
</p>
<p>
<a name="434127"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Operates like <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>W</b></font>, but prints only file systems that need to be dumped. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432250"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-W</b></font></font>
</p>
<p>
<a name="434154"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">For each file system in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates</b></font>, prints the most recent dump date and level, indicating which file systems should be dumped. If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-W </b></font>option is specified, all other options are ignored and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>exits immediately. </font>
</p>
</ul>
</p>
</ul>
</p>
</ul>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432335"></a> OPERATOR INTERACTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432340"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> requires operator intervention for any of the following conditions: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425322"></a>end of tape </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425325"></a>end of dump </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425328"></a>tape-write error </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425331"></a>tape-open error </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425334"></a>disk-read error (if errors exceed threshold of 32) </font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432433"></a>In addition to alerting all operators implied by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-n</b></font> option, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>interacts with the control terminal operator by posing questions requiring <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>yes</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>no</b></font> answers when it cannot proceed or if there is a serious problem. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432520"></a>Because making a full dump typically requires considerable time, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> establishes a checkpoint at the start of each tape volume. If for any reason writing that volume fails, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font>, with operator permission, restarts from the checkpoint after the old tape is rewound and removed and a new tape is mounted. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432596"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> periodically reports information to the operator, including estimates (typically low) of the number of blocks to write, the number of tapes it requires, time required to complete, and the time remaining until tape change. The output is verbose to inform other users that the terminal controlling <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> is busy and will be for a long period of time. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432682"></a> COMPATIBILITY</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432687"></a>In most cases, the dump tape format is independent of the VxFS disk layout. A dump of a file system may even be restored on a file system of another file system type. There are some exceptions: </font>
</p>

<p>
<a name="434181"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Files larger than 2 GB cannot be restored by earlier versions of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore</b></font>. If a file larger than 2 GB is encountered, an older <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore</b></font> skips the file and returns the message: </font>
</p>
<p>
<a name="425384"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"> <font face="Courier New, Courier, sansserif, sans serif" size="2">Resync&nbsp;restore,&nbsp;skipped</font> <em>num</em> <font face="Courier New, Courier, sansserif, sans serif" size="2">blocks&nbsp;</font> </font>
</p>
<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425391"></a>Files larger than 2 GB cannot be restored on a file system that does not support large files (see <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount_vxfs</b></font>(1M)). </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425397"></a>A file with a large (greater than 65535) user ID or group ID cannot be restored correctly on a file system that does not support large IDs. Instead, the owner and group of the invoking <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore </b></font>is substituted. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425409"></a>Files with VxFS extent attributes (see the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>setext</b></font>(1M) manual page) cannot be restored on a file system of a type that does not support extent attributes. </font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433017"></a>If you use <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump </b></font>to produce a dump intended for an earlier version of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore</b></font>, and if the dump requires multiple tapes, use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-s</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-d</b></font>, or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-B </b></font>option. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433122"></a>Dumps produced by older versions of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> can be read by the current version of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore</b></font>. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433162"></a> EXAMPLES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433167"></a>In the following example, assume that the file system <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/mnt</b></font> is usually attached to the file tree under the root ( <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/ </b></font>) directory. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433209"></a>In this example, the entire file system ( <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/mnt </b></font>) is dumped on <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/rmt/0m</b></font> and the size of the tape is two gigabytes. </font>
</p>

<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425448"></a> <font face="Courier New, Courier, sansserif, sans serif" size="2">vxdump&nbsp;-0&nbsp;-B&nbsp;2g&nbsp;-f&nbsp;/dev/rmt/0m&nbsp;/mnt&nbsp;</font> </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433285"></a>Specifying the tape size in logical records: </font>
</p>

<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425454"></a> <font face="Courier New, Courier, sansserif, sans serif" size="2">vxdump&nbsp;0Bf&nbsp;2097152&nbsp;/dev/rmt/0m&nbsp;/mnt&nbsp;</font> </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433323"></a>The option argument <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>2097152</b></font> goes with the option letter <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>B</b></font> as it is the first option letter that requires an option argument. The option argument <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/rmt/0m</b></font> goes with the option <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>f</b></font> as it is the second option letter that requires an option argument. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433413"></a> AUTHOR</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433418"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxdump</b></font> is based on the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dump</b></font> program from the 4.4 Berkeley Software Distribution, developed by the University of California, Berkeley, and its contributors. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433468"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/rmt/0m</b></font></font>
</p>
<p>
<a name="434256"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Default tape unit to dump to. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433488"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates</b></font></font>
</p>
<p>
<a name="434271"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">New format-dump-date record. This is the default file for VxFS. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433511"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/vxdumpdates</b></font></font>
</p>
<p>
<a name="434290"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Alternate format-dump-date record. Can be substituted for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/dumpdates</b></font> by using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>-o </b></font>option. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433571"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/fstab</b></font></font>
</p>
<p>
<a name="434309"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Contains static information about file systems. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433584"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/mnttab</b></font></font>
</p>
<p>
<a name="434328"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Table of mounted file systems. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433597"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/etc/group</b></font></font>
</p>
<p>
<a name="434343"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">List of group operators. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="433610"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433615"></a><a href="setext_vxfs_manpages7_428437.html#427240"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>setext </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>dump</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>init</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount</b></font>(1M), <a href="mount_vxfs_vxfs_manpages29_446047.html#434359"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mount_vxfs </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>rmt</b></font>(1M) <a href="vxrestore_vxfs_manpages37_435936.html#431209"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxrestore </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>wall</b></font>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>close</b></font>(2), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>open</b></font>(2), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ctime</b></font>(3C), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>getopt</b></font>(3C), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fstab</b></font>(4), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>mnttab</b></font>(4) </font>
</blockquote>

<!-- End Main Topic Content -->

   </td>
  </tr>
 </table>
</div>

<div>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
 <tr>
  <td height="18" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
  </td>
 </tr>
  <td align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&nbsp;&#94;&nbsp;<a href="vxdump_vxfs_manpages32_433610.html" title="vxdump">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="newfs_vxfs_vxfs_manpages31_429421.html" title="Previous - newfs_vxfs">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxenablef_vxfs_manpages33_427121.html" title="Next - vxenablef">Next</a>
&nbsp;&gt;&nbsp;&nbsp;</font>
  </td>
 <tr>
   <td height="9" border="0" cellspacing="0" cellpadding="0" colspan="2" bgcolor="#FFFFFF">
   </td>
 </tr>

<!-- Footer Breadcrumbs -->
<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Product:  
<a href="vxfs_manpages_splashpage_docCD_vxfs_manpages1_103036.vxhd" title="File System Manual Pages for Storage Foundation title page ">File System Manual Pages for Storage Foundation</a>&nbsp;&nbsp;</font></td>
</tr>

<tr>
<td bgcolor="#FFFFFF" colspan="2" height="15" align="right">
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">Manual:  
<a href="man1m_titlepage_docCD_vxfs_manpages8_73700.vxhd" title="Maintenance Commands (1m) title page ">Maintenance Commands (1m)</a>&nbsp;&nbsp;</font></td>
</tr>


 <tr>
  <td colspan="2" align="left"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" color="#000000" align="right" size="-2">
<em>VERITAS Software Corporation
</em></font><br>

<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">www.veritas.com</font><br>
  </td>
 </tr>
</table>
</div>

</BODY>
  <!--
    *************************************************************************************
    * Copyright (c) 2005 VERITAS Software Corporation. All rights reserved. *

    VERITAS, VERITAS SOFTWARE, the VERITAS Logo, and VERITAS Software Documentation 
    are trademarks or registered trademarks of VERITAS Software Corporation 
    or its affiliates in the U.S. and other countries. Other names may be 
    trademarks of their respective owners. 

    Apache Jakarta Lucene:
    Apache Software License
    Version 1.1

    Copyright (c) 2000 The Apache Software Foundation. All rights reserved.

    Redistribution and use in source and binary forms, with or without modification, 
    are permitted provided that the following conditions are met:

    1. Redistributions of source code must retain the above copyright notice, this 
    list of conditions and the following disclaimer.

    2. Redistributions in binary form must reproduce the above copyright notice, this 
    list of conditions and the following disclaimer in the documentation and/or other 
    materials provided with the distribution.

    3. The end-user documentation included with the redistribution, if any, must include 
    the following acknowledgment: "This product includes software developed by the Apache 
    Software Foundation (http://www.apache.org/)." Alternately, this acknowledgment may 
    appear in the software itself, if and wherever such third-party acknowledgments 
    normally appear.

    4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or 
    promote products derived from this software without prior written permission. For 
    written permission, please contact apache@apache.org.

    5. Products derived from this software may not be called "Apache", nor may "Apache" 
    appear in their name, without prior written permission of the Apache Software Foundation.

    THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, 
    BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
    PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION 
    OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, 
    OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 
    OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 
    ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
    NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
    ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    This software consists of voluntary contributions made by many individuals on behalf 
    of the Apache Software Foundation. For more information on the Apache Software Foundation, 
    please see <http://www.apache.org/>. Portions of this software are based upon public domain 
    software originally written at the National Center for Supercomputing Applications, University 
    of Illinois, Urbana-Champaign.
    
    This product includes WebWindow Software developed by Horst Heistermann.
    *************************************************************************************
  -->
</HTML>
