<!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:20">
<meta name="PRODUCTNAME" content="VERITAS Software Documentation">
<meta name="FILENAME" content="vxio.fm">
     
<title>vxio</title>

</HEAD>

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

<a name="432321"></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="vxinfo_vxvm_manpages96_428408.html" title="Previous - vxinfo">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxiod_vxvm_manpages98_427949.html" title="Next - vxiod">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="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager 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="man7_titlepage_docCD_vxvm_manpages92_73700.vxhd" title="Miscellaneous (7) title page ">Miscellaneous (7)</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="429109"></a>vxio</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429132"></a> NAME</font>
</h3>
<p>
<a name="429137"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxio - VERITAS Volume Manager virtual disk devices </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429140"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429145"></a>Volume devices are the virtual disk devices in VERITAS Volume Manager (VxVM). The volume devices support a virtual disk access method with disk mirroring and disk striping.  A volume is a logical entity composed of one or more plexes.  A read can be satisfied from any plex, while a write is directed to all plexes.  The virtual disk devices have a wide variety of behaviors, which are programmable through the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/config</b></font> device.  For volume devices, both block- and character-special devices are implemented. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429211"></a>Each plex in the volume is a copy of the volume address space.  The plex has subdisks associated with it.  These subdisks provide backup storage for the volume address space. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429232"></a>It is possible to create a sparse plex, which is a plex without backup storage for some of the volume address space.  The areas of a sparse plex that do not have a backing subdisk are called <em>holes</em>.  An attempt to read a hole in a sparse plex fails.  If there are other plexes that have backup storage for the read, then one of those plexes is read.  Otherwise, the read fails.  A write to a hole in a sparse plex is considered a success even though the data can't be read back. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429289"></a>In addition, a plex may be designated as a logging plex.  This means that a log of blocks that are in transition will be kept, which enables fast recovery after a system failure.  This feature is known as \s-1DRL\s0, or <em>dirty region logging</em>.  The log for each plex consists of a specially designated subdisk that is not part of the normal plex address space. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429337"></a> IOCTLS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429342"></a>The ioctl commands supported by the volume virtual disk device interface are discussed later in this section. The format for calling each ioctl command is: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429377"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#include&nbsp;&lt;sys/types.h&gt;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429382"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">#include&nbsp;&lt;sys/volclient.h&gt;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429387"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">struct&nbsp;tag&nbsp;arg;</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429392"></a>int&nbsp;ioctl&nbsp;(int&nbsp;fd,&nbsp;int&nbsp;cmd,&nbsp;struct&nbsp;tag&nbsp;*arg);
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429397"></a>The value of <em>cmd</em> is the ioctl command code and <em>arg</em> is usually a pointer to a structure containing the arguments that need to be passed to the kernel. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429418"></a>The return value for all these ioctls, with some exceptions, is zero if the command was successful, and -1 if it was rejected.  If the return value is -1, then <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is set to indicate the cause of the error. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429448"></a>The following ioctl commands are supported: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429452"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GET_DAEMON</b></font></font>
</p>
<p>
<a name="432432"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This ioctl returns the pid of the process with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/config</b></font> device open, or 0 if it is closed. The value of <em>arg </em>is undefined and should be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NULL. </b></font></font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429502"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GET_VOLINFO</b></font></font>
</p>
<p>
<a name="432463"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command accepts a pointer to a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volinfo</b></font> structure as an argument.  It fills in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volinfo</b></font> structure with the corresponding values from the kernel.  The members of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>volinfo </b></font>structure are: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429552"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;version;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*kernel&nbsp;version&nbsp;number*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429557"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;max_volprivmem;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;size&nbsp;of&nbsp;volprivmem&nbsp;area*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429562"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>major_t&nbsp;volbmajor;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*volume&nbsp;blk&nbsp;dev&nbsp;major&nbsp;number*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429567"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>major_t&nbsp;volcmajor;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*volume&nbsp;char&nbsp;dev&nbsp;major&nbsp;number*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429572"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>major_t&nbsp;plexmajor;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*plex&nbsp;device&nbsp;major&nbsp;number*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429577"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;maxvol;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;#&nbsp;of&nbsp;volumes&nbsp;supported*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429582"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;maxplex;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;#&nbsp;of&nbsp;associated&nbsp;plexes*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429587"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;plexnum;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;plexes&nbsp;per&nbsp;volume*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429592"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;sdnum;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;subdisks&nbsp;per&nbsp;plex*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429597"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;max_ioctl;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;size&nbsp;of&nbsp;ioctl&nbsp;data*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429602"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;max_specio;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;size&nbsp;of&nbsp;ioctl&nbsp;I/O&nbsp;op*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429607"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;max_io;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;size&nbsp;of&nbsp;I/O&nbsp;operation*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429612"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;vol_maxkiocount;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;#&nbsp;top&nbsp;level&nbsp;I/Os&nbsp;allowed*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429617"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;dflt_iodelay;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*default&nbsp;I/O&nbsp;delay&nbsp;for&nbsp;utils*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429622"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;max_parallelio;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;#&nbsp;voldios&nbsp;allowed*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429627"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;voldrl_min_regionsz;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*min&nbsp;DRL&nbsp;region&nbsp;size*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429632"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;voldrl_max_drtregs;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;#&nbsp;of&nbsp;DRL&nbsp;dirty&nbsp;regions*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429637"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;vol_is_root;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*if&nbsp;set,&nbsp;root&nbsp;is&nbsp;volume*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429642"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;mvrmaxround;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;round-robin&nbsp;region&nbsp;size*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429647"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;prom_version;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*PROM&nbsp;version&nbsp;of&nbsp;the&nbsp;system*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429652"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;vol_maxstablebufsize;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;size&nbsp;of&nbsp;copy&nbsp;buffer*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429657"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;voliot_iobuf_limit;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;total&nbsp;I/O&nbsp;trace&nbsp;buf&nbsp;spc*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429662"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;voliot_iobuf_max;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;size&nbsp;of&nbsp;I/O&nbsp;trace&nbsp;buffer*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;voliot_iobuf_default;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*default&nbsp;I/O&nbsp;trace&nbsp;buf&nbsp;size*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429672"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;voliot_errbuf_default;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*default&nbsp;error&nbsp;trace&nbsp;buf&nbsp;size*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429677"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;voliot_max_open;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;#&nbsp;of&nbsp;trace&nbsp;channels*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429682"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;vol_checkpt_default;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*default&nbsp;checkpoint&nbsp;size*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429687"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>long&nbsp;volraid_rsrtransmax;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*max&nbsp;#&nbsp;of&nbsp;transient&nbsp;RSRs*/</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429693"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PLEX_DETACH</b></font></font>
</p>
<p>
<a name="432594"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command is used to force a plex to be detached from a volume.  The name of the plex is passed in as an argument.  The volume is the volume device against which the ioctl is being performed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429724"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOL_LOG_WRITE</b></font></font>
</p>
<p>
<a name="432617"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command forces a dirty region log to be flushed to disk.  This is used by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfigd</b></font> process to flush an initial log to disk before starting the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429755"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOL_READ, VOL_WRITE</b></font></font>
</p>
<p>
<a name="432636"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">These commands provide a mechanism by which I/O can be issued to volumes larger than 2 gigabytes in length.  Current UNIX read and write system calls on 32-bit processors limit sizes to 2 gigabytes because of the signed byte-offset value used to perform the I/O. These ioctl commands provide a method of providing sector offsets to an I/O and raise the limit to one sector less than 1024 gigabytes. </font>
</p>
<p>
<a name="425111"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The required I/O is identified to the command by the use of a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_rdwr </b></font>structure containing the following: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429848"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ulong_t&nbsp;vrw_flags;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*flags*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429853"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voff_t&nbsp;vrw_off;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*offset&nbsp;in&nbsp;volume&nbsp;(sectors)*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429858"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;vrw_size;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*number&nbsp;of&nbsp;sectors&nbsp;to&nbsp;Xfer*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429863"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>caddr_t&nbsp;vrw_addr;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*user&nbsp;address&nbsp;for&nbsp;Xfer*/</font>
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425124"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vrw_flags</b></font> field is currently unused; other fields are explained in the comments. </font>
</blockquote>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="429893"></a> VOLUME-SPECIAL IOCTLS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="429898"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">ATOMIC_COPY,</font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VERIFY_READ,</font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VERIFY_WRITE</font> ioctls perform special I/O operations against the volume. They use the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_io</b></font> structure to initiate I/O requests and receive the status information back.  The members of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_io</b></font> structure are: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429988"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>voff_t&nbsp;vi_offset;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*0x00&nbsp;offset&nbsp;on&nbsp;plex*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="429993"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;vi_len;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*0x04&nbsp;amount&nbsp;of&nbsp;data&nbsp;to&nbsp;read/write*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430001"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>caddr_t&nbsp;vi_buf;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*0x08&nbsp;ptr&nbsp;to&nbsp;buffer*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430009"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;vi_nsrcplex;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*0x0c&nbsp;number&nbsp;of&nbsp;source&nbsp;plexes*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430017"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>size_t&nbsp;vi_ndestplex;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*0x10&nbsp;number&nbsp;of&nbsp;destination&nbsp;plexes*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430025"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>struct&nbsp;plx_ent&nbsp;*vi_plexptr;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*0x14&nbsp;ptr&nbsp;to&nbsp;array&nbsp;of&nbsp;plex&nbsp;entries*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430033"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ulong_t&nbsp;vi_flag;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*0x18&nbsp;flags&nbsp;associated&nbsp;with&nbsp;op*/</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430041"></a>The members of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plx_ent</b></font> structure are: </font>
</p>

<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430058"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>char&nbsp;pe_name[NAME_SZ];</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*name&nbsp;of&nbsp;plex*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="430066"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>int&nbsp;pe_errno;</b></font><font face="Courier New, Courier, sansserif, sans serif" size="2">&nbsp;&nbsp;&nbsp;&nbsp;/*error&nbsp;number&nbsp;against&nbsp;plex*/</font>
</font>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430074"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_offset</b></font> value specifies the sector offset of the I/O within the volume.  It must be within the address range of the volume. Also, the entire range of the I/O from <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_offset</b></font> to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_offset</b></font> \+ <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_len</b></font> must be within the address range of the volume. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430128"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_len</b></font> field specifies the length of the I/O in sectors. It must be a between 0 and 120 sectors (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOL_MAXSPECIALIO</b></font>). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430158"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_buf</b></font> field is a pointer to a buffer of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_len</b></font> sectors. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_WRITE </b></font>ioctl writes the data stored in this buffer. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430200"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_nsrcplex</b></font> field is the number of source plexes available for the operation and the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_ndestplex</b></font> field is the number of destination plexes available for the operation.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_nsrcplex </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_ndestplex</b></font> values must be between 0 and 8 (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PLEX_NUM</b></font>). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430254"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_plexptr</b></font> is a pointer to an array of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plx_ent </b></font>structures.  The first <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_nsrcplex</b></font> entries in the array are source plexes.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_name</b></font> contains the name of the plex.  If the name of the first source entry is the null string, then the kernel selects all plexes available for reading as part of the volume and fills in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_name</b></font> fields. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430320"></a>After the source plexes, the next <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_ndestplex</b></font> entries are the destination plexes.  If the name of the first destination entry is the null string, then the kernel selects all plexes available for writing as part of the volume and fills in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_name</b></font> fields. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430362"></a>After the I/O operations are performed, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plx_ent</b></font> structures are copied back to the user.  If the kernel selected the plexes, the names of the selected plexes are in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_name</b></font> fields.  The status of the operations on each plex are stored in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> field of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plx_ent</b></font> structure for that plex. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430416"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> field is 0 if the operation succeeded against the plex.  If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> isn't 0, then the error code indicates what happened to the plex.  The possible values for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430460"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EACCES</b></font></font>
</p>
<p>
<a name="432842"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The specified plex is in the disabled state, so no I/O can be performed against it. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430491"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EFAULT</b></font></font>
</p>
<p>
<a name="432861"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A source plex is sparse and doesn't have blocks that map the entire I/O request. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430522"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EIO</b></font></font>
</p>
<p>
<a name="432880"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A read I/O error was returned against a source plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430541"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENOENT</b></font></font>
</p>
<p>
<a name="432899"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The specified plex isn't associated with the volume the ioctl was issued against. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430572"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENXIO</b></font></font>
</p>
<p>
<a name="432934"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An error was detected in the operation, so no I/O operation was attempted to the plex.  If one <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plx_ent</b></font> structure in a list contains a bad name, then no I/O is done.  All <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>plx_ent </b></font>structures with a valid name have their <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENXIO </b></font>to indicate no I/O was attempted. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430639"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EROFS</b></font></font>
</p>
<p>
<a name="432953"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A write I/O error was returned against a destination plex. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430658"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ESRCH</b></font></font>
</p>
<p>
<a name="432984"></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>VERIFY_READ </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_WRITE </b></font>operations compare the data from different plexes against each other to verify the consistency.  If the comparison detects an error, the plex that was read first is considered correct.  An <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ESRCH </b></font>error is returned against the plex that was read second to indicate it contains bad data. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430772"></a>For the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_READ</b></font>, and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_WRITE </b></font>ioctls, if the entire operation is a success, then a 0 is returned. If there is a fatal error, a -1 is returned and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> indicates the reason for failure.  If a 1 is returned, there was some sort of failure and the net results must be determined by examining the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> fields of all the plexes. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430850"></a>The ioctls that do volume-special I/O are: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="430857"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font></font>
</p>
<p>
<a name="433051"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This ioctl takes a pointer to a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_io</b></font> structure as an argument. It reads <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_len</b></font> sectors of data, at offset <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_offset</b></font>, from one of the plexes specified by the first <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_nsrcplex</b></font> plex entries into a buffer.  Then it writes the contents of the buffer onto all the plexes specified by the next <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_ndestplex</b></font> plex entries at the same offset.  This entire operation is atomic with respect to the I/O stream of the volume.  The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_buf</b></font> field is unused and should be <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NULL</b></font>. </font>
</p>
<p>
<a name="425260"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the first source plex entry has a null string for the name, the kernel selects from any plex of the volume that is enabled for read access.  The names of any selected plexes are copied into the appropriate plex entries. </font>
</p>
<p>
<a name="425265"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the first destination plex entry has a null string for the name, the kernel will write to all plexes of the volume that are enabled for write access.  The names of selected plexes are copied into the appropriate plex entries. </font>
</p>
<p>
<a name="425270"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">When the list of source plexes has been compiled, the kernel tries to read each plex in order.  A plex can't be read if it doesn't have backup storage covering the entire operation.  Once a plex has been successfully read, all the destination plexes are written.  The writes can succeed even if the destination plex is sparse and doesn't have backup storage to cover the entire write. </font>
</p>
<p>
<a name="425277"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the ioctl returns a value of -1, then some error has occurred which prevented the  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY </b></font>from working.  If the return value is 0, then everything worked fine.  If the return value is 1, then the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> field must be examined to determine the errors on each individual plex.  The status of the overall operation depends on these individual errors. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431240"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_READ</b></font></font>
</p>
<p>
<a name="433118"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command accepts a pointer to a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_io</b></font> structure as an argument.  It reads <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_len</b></font> sectors, from offset <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_offset</b></font>, on the first <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_nsrcplex</b></font> plexes specified by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_plexptr</b></font> array of plex entries.  It compares the data from each plex. If any plex is different from the previous plexes read, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> value for that plex is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ESRCH</b></font>. This entire operation is atomic with respect to the I/O stream of the volume. </font>
</p>
<p>
<a name="425296"></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>vi_ndestplex</b></font> field must be 0.  If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_buf</b></font> field is not  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>NULL</b></font>, then the data read from the plexes not marked with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ESRCH </b></font>is copied into the buffer specified by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_buf</b></font>. </font>
</p>
<p>
<a name="425301"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">As each plex is read, any data that has already been read is compared against the previous reads.  If all the data for the plex passes, then any data that was read for the first time is copied into the comparison buffer.  This allows  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_READ </b></font>operations to work if the volume contains sparse plexes.  The data not represented by backup storage is not compared against anything. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431501"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_WRITE</b></font></font>
</p>
<p>
<a name="433199"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command accepts a pointer to a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_io</b></font> structure as an argument.  It writes <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_len</b></font> sectors to offset <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_offset</b></font> on the first <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_ndestplex</b></font> plexes specified by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_plexptr</b></font> array of plex entries.  The data to be written is stored in the buffer pointed to by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_buf</b></font>.  Then, the data is read back from each plex that was successfully written and is compared against the data written.  If the data from any plex doesn't match the data written, the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>pe_errno</b></font> value for the plex is set to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ESRCH</b></font>. This entire operation is atomic with respect to the I/O stream of the volume. </font>
</p>
<p>
<a name="425321"></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>vi_nsrcplex</b></font> field must be 0. </font>
</p>
<p>
<a name="425323"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">As each plex is read, any data that doesn't have backup storage on that plex is filled in from the write buffer.  This allows <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_WRITE </b></font>operations to work if the volume contains sparse plexes.  The data not represented by backup storage will always succeed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431714"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VOL_LOG_WRITE</b></font></font>
</p>
<p>
<a name="433232"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command takes no argument, and causes the log for a volume to be written to disk immediately. This command is useful for making sure that the on-disk images of the log have been written. </font>
</p>
<p>
<a name="425334"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command returns -1 with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno </b></font>set to  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EINVAL </b></font>if the specified volume does not have logging enabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431812"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>PLEX_DETACH</b></font></font>
</p>
<p>
<a name="433262"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">This command allows an enabled plex to be detached. The argument is the name of the plex to detach. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431842"></a> DIAGNOSTICS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431847"></a>The following errors are returned by volume virtual disk device interfaces: </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431866"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EAGAIN</b></font></font>
</p>
<p>
<a name="433281"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A needed kernel resource couldn't be obtained. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431885"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EBADF</b></font></font>
</p>
<p>
<a name="433300"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An attempt was made to write a volume that wasn't opened for writing or read a volume that wasn't open for reading. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431916"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EFAULT</b></font></font>
</p>
<p>
<a name="433319"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A pointer passed to the kernel was invalid, causing a bad memory reference. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431947"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EINVAL</b></font></font>
</p>
<p>
<a name="433342"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Invalid data was passed to the kernel.  Some field in a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vol_io</b></font> structure failed a sanity check. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431978"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EIO</b></font></font>
</p>
<p>
<a name="433361"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A physical I/O error occurred during an operation.  If this error is returned, the driver tried an I/O and it failed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432009"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMFILE</b></font></font>
</p>
<p>
<a name="433396"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The kernel was asked to supply a list of destination plexes for an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_WRITE</b></font> ioctl.  If more than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_ndestplex</b></font> enabled plexes available in write mode are found, an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EMFILE</b></font> error is returned. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432064"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENFILE</b></font></font>
</p>
<p>
<a name="433431"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The kernel was asked to supply a list of source plexes for an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_READ</b></font> ioctl.  If more than <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_nsrcplex</b></font> enabled plexes available in read mode are found, an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENFILE</b></font> error is returned. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432119"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENOENT</b></font></font>
</p>
<p>
<a name="433454"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An object named in  <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>GET_VOL_STATS</b></font> ioctl was not associated with the volume. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432150"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENOENT</b></font></font>
</p>
<p>
<a name="433485"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The kernel was asked to supply a list of destination plexes for an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_WRITE</b></font> ioctl.  If no enabled plexes available in write mode are found, an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENOENT</b></font> error is returned. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432205"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENXIO</b></font></font>
</p>
<p>
<a name="433504"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">A validation error occurred during an I/O operation.  If this error is returned, the driver attempted no I/O. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432236"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ESRCH</b></font></font>
</p>
<p>
<a name="433535"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The kernel was asked to supply a list of source plexes for an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ATOMIC_COPY</b></font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VERIFY_READ</b></font> ioctl.  If no enabled plexes available in read mode are found, an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ESRCH</b></font> error is returned. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432278"></a> FILES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432284"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/dsk/*</b></font>...</font>
</p>
<p>
<a name="433554"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Volume block device files. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432303"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>/dev/vx/rdsk/*</b></font>...</font>
</p>
<p>
<a name="433573"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Volume character (raw) device files. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="432321"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432326"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ioctl</b></font>(2), <a href="vxconfig_vxvm_manpages94_426402.html#426260"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxconfig </b></font></font></a>(7), <a href="vxiod_vxvm_manpages98_427949.html#427443"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxiod </b></font></font></a>(7), <a href="vxtrace_vxvm_manpages99_427612.html#426876"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtrace </b></font></font></a>(7) </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="vxio_vxvm_manpages97_432321.html" title="vxio">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="vxinfo_vxvm_manpages96_428408.html" title="Previous - vxinfo">Previous</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="vxiod_vxvm_manpages98_427949.html" title="Next - vxiod">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="vxvm_manpages_splashpage_docCD_vxvm_manpages1_103036.vxhd" title="Volume Manager Manual Pages for Storage Foundation title page ">Volume Manager 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="man7_titlepage_docCD_vxvm_manpages92_73700.vxhd" title="Miscellaneous (7) title page ">Miscellaneous (7)</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>
