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

</HEAD>

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

<a name="436668"></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="man7_titlepage_docCD_vxfs_manpages97_73700.vxhd" title="Previous - Miscellaneous (7)">Previous</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">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="man7_titlepage_docCD_vxfs_manpages97_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="430964"></a>vxfsio</font>
</h2>

        

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430987"></a> NAME</font>
</h3>
<p>
<a name="430992"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">vxfsio - VxFS file system control functions </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="430995"></a> SYNOPSIS</font>
</h3>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="431000"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>cc -I /opt/VRTS/include -L /opt/VRTS/lib <br>-l vxfsutil -ldld </b></font>
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="431006"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>#include</b></font> &lt;<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sys/types.h</b></font>&gt; <br><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>#include</b></font> &lt;<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sys/fs/vx_ioctl.h</b></font>&gt; 
</font>
<br>
<font face="Courier, Courier New, sansserif, sans serif" size="2"><a name="431012"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>int ioctl</b></font> (<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>int </b></font><em>fildes</em>, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>int</b></font> <em>cmd</em>, <em>arg</em>); 
</font>

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


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="431061"></a> DESCRIPTION</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431066"></a>The VxFS <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ioctl</b></font>(2) enhancements provide extended control for open files. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431087"></a>The requirements for direct I/O are as follows: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425002"></a>The starting file offset must be aligned to a 512-byte boundary. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425005"></a>The ending file offset must be aligned to a 512-byte boundary, or the length must be a multiple of 512 bytes. </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425009"></a>The memory buffer must start on an 8-byte boundary. </font>
</li>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431147"></a>If the I/O is performed using the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>readv</b></font>(2) and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>writev</b></font>(2) system calls, these restrictions apply to each element of the array of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>struct iovec</b></font>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431177"></a>The requirements to perform direct I/O on a given platform and operating system release may be less restrictive than above, but these requirements are met, then direct I/O will work on any platform. In particular, Solaris and HP-UX do not require any alignment of the memory buffer. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431225"></a>Also note that on HP-UX, direct I/O will be the most efficient if the starting and ending file offsets are aligned on file system block boundaries, as reported in the field <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>f_frsize </b></font>of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>statvfs</b></font>(2). </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431282"></a>The argument <em>fildes</em> is an open file descriptor. The data type and value of <em>arg</em> are specific to the type of command specified by <em>cmd</em>. </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431303"></a>The symbolic names for commands and file status flags are defined by the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sys/fs/vx_ioctl.h </b></font>header file. The available VxFS ioctls are: </font>
</p>

<p>
<ul type="disc"><li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425043"></a>VX_FREEZE </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425046"></a>VX_FREEZE_ALL </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425049"></a>VX_THAW </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425052"></a>VX_GETCACHE </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425055"></a>VX_SETCACHE </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425058"></a>VX_GETEXT </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425061"></a>VX_SETEXT </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425064"></a>VX_GETFSOPT </font>
</li>
<li><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425067"></a>VX_GET_IOPARAMETERS </font>
</li>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431478"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FREEZE</b></font></font>
</p>
<p>
<a name="436889"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sync then freeze the file system. After it is frozen, all operations on the file system are blocked until a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_THAW</font> operation is received. The argument <em>arg</em> is a timeout value expressed in seconds. If a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_THAW</font> operation is not received within the specified timeout interval, the file system performs a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_THAW</font> operation automatically. </font>
</p>
<p>
<a name="425087"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Only privileged users can run this command on the root directory of the file system. </font>
</p>
<p>
<a name="425090"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_FREEZE</font> ioctl returns a zero if the file system is successfully frozen. If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC.</font> </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431704"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FREEZE_ALL</b></font></font>
</p>
<p>
<a name="436922"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sync then freeze multiple file systems.  This ioctl is identical to <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FREEZE </b></font>except that multiple file systems can be specified. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431735"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_THAW</b></font></font>
</p>
<p>
<a name="436941"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Unblocks a file system that was frozen by a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_FREEZE</font> operation. The process that is to issue a <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_THAW</font> operation must have the root directory of the file system open, and must ensure that it does not access the file system after the file system is frozen so that the process itself does not block. </font>
</p>
<p>
<a name="425114"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Only privileged users can run this command, on the root directory of the file system. </font>
</p>
<p>
<a name="425117"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_THAW</font> ioctl returns a zero if the file system is successfully thawed. If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC</font> or one of diagnostics listed in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTICS</font> section. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="431951"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_GETCACHE</b></font></font>
</p>
<p>
<a name="436970"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Gets caching advisories in effect for the file. The argument <em>arg</em> is a pointer to an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>int</b></font>. </font>
</p>
<p>
<a name="425136"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_GETCACHE</font> ioctl returns a zero if the caching advisories are successfully obtained and the advisories are returned in <em>arg</em>. If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC.</font> </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432097"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_SETCACHE</b></font></font>
</p>
<p>
<a name="437000"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets caching advisories. These advisories allow an application to indicate to the file system which forms of caching are most advantageous. </font>
</p>
<p>
<a name="425151"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The values for <em>arg</em> are such that multiple advisories may be set by combining values with bitwise <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">OR</font> operations. The possible values for <em>arg</em> are VX_DIRECT, VX_DSYNC, VX_NOREUSE, VX_RANDOM, VX_SEQ, and VX_UNBUFFERED: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432245"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_DIRECT</b></font></font>
</p>
<p>
<a name="437030"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that data associated with read and write operations is transferred directly to or from the user supplied buffer without being cached. When this option is enabled, all I/O operations must begin on block boundaries and must be a multiple of the block size in length. The buffer supplied with the I/O operations must be aligned to a 4-byte word boundary. </font>
</p>
<p>
<a name="425173"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If an I/O request fails to meet alignment criteria, or the file is currently being accessed for mapped I/O, the I/O request is performed as a data synchronous I/O operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432346"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_DSYNC</b></font></font>
</p>
<p>
<a name="437052"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates data synchronous I/O mode. In data synchronous I/O mode, a write operation returns to the caller after the data is transferred to external media, but the inode is not updated synchronously if only the times in the inode need to be updated. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432395"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_NOREUSE</b></font></font>
</p>
<p>
<a name="437071"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that buffered data does not need to be retained for further use by the application. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432417"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_RANDOM</b></font></font>
</p>
<p>
<a name="437090"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that the file is being accessed randomly. Read-ahead is not performed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432439"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_SEQ</b></font></font>
</p>
<p>
<a name="437109"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that the file is being accessed sequentially. Maximum read ahead is performed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432470"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_UNBUFFERED</b></font></font>
</p>
<p>
<a name="437128"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that data associated with read and write operations is transferred directly to or from the user supplied buffer, without being cached. The alignment constraints are identical to those associated with the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DIRECT</font> caching advisory. </font>
</p>
<p>
<a name="425205"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">If the file is extended or space is allocated to the file and the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_UNBUFFERED</font> advisory is set, the inode is not written synchronously to disk before the write returns. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432573"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_RANDOM</font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_SEQ</font> caching advisories are mutually exclusive. Similarly, only one of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DIRECT,</font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DSYNC,</font> or <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_UNBUFFERED</font> caching advisories may be set. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432665"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_RANDOM,</font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_SEQ,</font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_NOREUSE</font> caching advisories are maintained on a per-file basis. Changes made to these advisories by a process affect I/O operations by all processes currently accessing the file. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432735"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DIRECT,</font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DSYNC,</font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_UNBUFFERED</font> caching advisories are maintained on a per-open instance of a file, so changes made to these advisories by a process do not affect the setting of these advisories, and therefore I/O operations, by another process. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432814"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_SETCACHE</font> ioctl returns a zero if the caching advisories are successfully set. If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC.</font> </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="432886"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_GETEXT</b></font></font>
</p>
<p>
<a name="437162"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Gets extent information. Returns the extent information associated with <em>fildes</em>. The argument <em>arg</em> points to a structure of type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vx_ext</b></font> as defined in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sys/fs/vx_ioctl.h</b></font>. Only persistent extent attributes are visible. </font>
</p>
<p>
<a name="425259"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_GETEXT</font> ioctl returns a zero if the extent information is successfully obtained. If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC.</font> </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433028"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_SETEXT</b></font></font>
</p>
<p>
<a name="437188"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Sets extent information. </font>
</p>
<hr noshade size="2" width="100%" color="#000000">
<img src="images/note.gif" alt="Note " height="16" width="16">&nbsp;
<font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="425271"></a><b>Note  &nbsp;&nbsp;</b>
</font>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2" color="#000000"> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_SETEXT</font> is available only with VERITAS Editions products. 
</font>
<hr noshade size="2" width="100%" color="#000000">
<p>
<a name="425275"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The extent information is set according to the parameters specified by <em>arg</em>. The argument <em>arg</em> points to a structure of type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vx_ext</b></font> defined in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sys/fs/vx_ioctl.h</b></font>.  This structure contains the following members: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433142"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">off_t&nbsp;&nbsp;ext_size;&nbsp;&nbsp;/*&nbsp;Extent&nbsp;size&nbsp;in&nbsp;fs&nbsp;blocks&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433147"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">off_t&nbsp;&nbsp;reserve;&nbsp;&nbsp;&nbsp;/*&nbsp;Space&nbsp;reservation&nbsp;in&nbsp;fs&nbsp;blocks&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="433155"></a>int&nbsp;&nbsp;&nbsp;&nbsp;a_flags;&nbsp;&nbsp;&nbsp;/*&nbsp;Allocation&nbsp;flags&nbsp;*/&nbsp;
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425290"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ext_size</b></font> element requests a fixed extent size, in blocks, for the file. If a fixed extent size is not required, use zero to allow the default allocation policy to be used. Changes to the fixed extent size made after the file contains indirect blocks have no effect unless all current indirect blocks are freed via file truncation and/or reservation deallocation. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425299"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reserve</b></font> element sets the amount of space preallocated to the file (in blocks). If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reserve</b></font> amount is greater than the current reservation, the allocation for the file is increased to match the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reserve</b></font> amount. If the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>reserve</b></font> amount is less than the current reservation, the allocation is decreased. The allocation is not reduced to less than the current file size. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425309"></a>File reservation cannot be increased beyond the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ulimit</b></font>(2) of the requesting process. However, an existing reservation will not be trimmed to the requesting process's <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ulimit</b></font>(2). Reservation of space for existing sparse files only allocates blocks at the end of the file, not to fill holes. Thus, it is possible to have a larger reservation for a file than blocks in the file. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425319"></a>The reservation amount is independent of file size since reservation is used to preallocate space for a file. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425322"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>a_flags</b></font> element is used to indicate the type of reservation required. The possible values for <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>a_flags </b></font>are VX_ALIGN, VX_CHGSIZE, VX_CONTIGUOUS, VX_NOEXTEND, VX_NORESERVE, and VX_TRIM: </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433667"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_ALIGN</b></font></font>
</p>
<p>
<a name="437280"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Aligns all new extents on an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ext_size</b></font> boundary relative to the starting block of an allocation unit. If <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_CONTIGUOUS</font> is also set, the single extent allocated during this invocation is not subject to the alignment restriction. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433756"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_CHGSIZE</b></font></font>
</p>
<p>
<a name="437299"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The reservation is immediately incorporated into the file. The file's on-disk inode is updated with the size and block count information that is increased to include the reserved space. This operation is restricted to users with appropriate privileges. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433811"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_CONTIGUOUS</b></font></font>
</p>
<p>
<a name="437322"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The reservation is allocated contiguously (as a single extent). <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ext_size </b></font>becomes the fixed extent size for subsequent allocations, but has no affect on this allocation. The reservation fails if the file has gone into indirect extents unless the amount of space requested is the same as the indirect extent size. If the contiguous allocation request is done on an empty file, this does not happen. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="433938"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_NOEXTEND</b></font></font>
</p>
<p>
<a name="437341"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The file is not extended after the current reservation is exceeded. The reservation may be increased, if necessary, by another invocation of the ioctl, but the file is not automatically extended. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434005"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_NORESERVE</b></font></font>
</p>
<p>
<a name="437360"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The reservation is a non-persistent allocation to the file. The on-disk inode is not updated with the reservation information, so the reservation cannot survive a system crash. The reservation is associated with the file until the close of the file. The reservation is trimmed to the current file size on close. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434072"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_TRIM</b></font></font>
</p>
<p>
<a name="437379"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The reservation for the file is trimmed to the current file size upon last close by all processes that have the file open. </font>
</p>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425381"></a>Write permission to a file is required to set extent information, but any process that can open the file can get the extent information. Extent information only applies to regular files. Only one set of extent information is kept per file. Only the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_ALIGN</font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_NOEXTEND</font> allocation flags are persistent attributes of the file. Other allocation flags may have persistent effects, but are not visible as allocation flags. <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_ALIGN,</font> <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_NOEXTEND,</font> and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_TRIM</font> are the only flags visible through the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_GETEXT</font> ioctl. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425401"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_SETEXT</font> ioctl returns a zero if the extent information is successfully set. If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC.</font> </font>
</blockquote>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434413"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_GETFSOPT</b></font></font>
</p>
<p>
<a name="437414"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Gets file system options. The argument <em>arg</em> is a pointer to an <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>int</b></font>. This command may be used by any user who can open the root inode on the file system. The options returned in <em>arg</em> are: </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434492"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_BLKCLEAR</b></font></font>
</p>
<p>
<a name="437433"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that all newly allocated blocks are guaranteed to contain all zeros. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434523"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_CACHE_CLOSESYNC</b></font></font>
</p>
<p>
<a name="437452"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any non-logged changes to the inode or data are flushed to disk when the file is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434554"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_CACHE_DIRECT</b></font></font>
</p>
<p>
<a name="437471"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any non-synchronous I/O is handled as if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DIRECT</font> cache advisory is set on the file. Also, any non-logged changes to the inode or data are flushed to disk when the file is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434619"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_CACHE_DSYNC</b></font></font>
</p>
<p>
<a name="437490"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any writes that do not have either <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> or the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DIRECT</font> advisory set are handled as if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DSYNC</font> advisory is set on the file. Also, any non-logged changes to the inode or data are flushed to disk when the file is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434730"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_CACHE_TMPCACHE</b></font></font>
</p>
<p>
<a name="437513"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that delayed extending writes are disabled. Non-logged changes to the inode or data are <em>not </em>flushed to disk when the file is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434775"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_CACHE_UNBUFFERED</b></font></font>
</p>
<p>
<a name="437532"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any non-synchronous I/O is handled as if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_UNBUFFERED</font> cache advisory is set on the file. Also, any non-logged changes to the inode or data is flushed to disk when the file is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434853"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_DELAYLOG</b></font></font>
</p>
<p>
<a name="437551"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that some system calls may return before the intent log is written. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434885"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_NODATAINLOG</b></font></font>
</p>
<p>
<a name="437570"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that intent logging of user data for synchronous writes is disabled. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434916"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_OSYNC_CLOSESYNC</b></font></font>
</p>
<p>
<a name="437589"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any non-logged changes to the inode or data is flushed to disk when a file accessed with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="434969"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_OSYNC_DELAY</b></font> </font>
</p>
<p>
<a name="437608"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> writes are delayed instead of taking effect immediately. No special action is taken when a file is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435047"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_OSYNC_DIRECT</b></font> </font>
</p>
<p>
<a name="437627"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> I/O is handled as if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DIRECT</font> cache advisory is set on the file instead. Also, any non-logged changes to the inode or data is flushed to disk when a file accessed with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435171"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_OSYNC_DSYNC</b></font> </font>
</p>
<p>
<a name="437646"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> writes are handled as if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_DSYNC</font> cache advisory is set on the file instead. Also, any non-logged changes to the inode or data are flushed to disk when a file accessed with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435295"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_OSYNC_UNBUFFERED</b></font></font>
</p>
<p>
<a name="437665"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that any <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> I/O is handled as if the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_UNBUFFERED</font> cache advisory was set on the file. Also, any non-logged changes to the inode or data are flushed to disk when a file accessed with <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">O_SYNC</font> is closed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435404"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_SNAPPED</b></font> </font>
</p>
<p>
<a name="437684"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that a snapshot backup is in progress on the file system. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435435"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_SNAPSHOT</b></font> </font>
</p>
<p>
<a name="437703"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that this file system is a snapshot backup of another file system. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435466"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_TMPLOG</b></font></font>
</p>
<p>
<a name="437722"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that the intent log is almost always delayed. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435485"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_FSO_VJFS</b></font> </font>
</p>
<p>
<a name="437741"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Indicates that this is not the full feature VxFS available with the VERITAS Editions product. </font>
</p>
</ul>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435515"></a>The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_GETFSOPT</font> ioctl returns a zero if the file system options are successfully obtained. If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC.</font> </font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="435592"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>VX_GET_IOPARAMETERS</b></font></font>
</p>
<p>
<a name="437788"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Gets the I/O parameters for optimized application I/O. The argument <em>arg</em> points to a structure of type <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vx_ioparameters </b></font>as defined in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>sys/fs/vxio.h</b></font>. The optimal I/O request sizes for applications using direct or discovered direct I/O are returned in this structure. Applications using buffered I/O must use a multiple of the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>st_blksize</b></font> value returned by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>stat </b></font>for their I/O requests. The <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">VX_GET_IOPARAMETERS</font> ioctl returns a zero if the parameters are successfully obtained.  If the operation fails, the return value is -1 and the external variable <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno</b></font> is a general <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="1">DIAGNOSTIC.</font> </font>
</p>
<p>
<a name="425555"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The fields in the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vx_ioparameters</b></font> structure are: </font>
</p>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435810"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_read_preferred_io;&nbsp;/*&nbsp;preferred&nbsp;read&nbsp;size&nbsp;in&nbsp;bytes&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435818"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_read_nstream;&nbsp;&nbsp;&nbsp;/*&nbsp;num&nbsp;of&nbsp;preferred&nbsp;reads&nbsp;to&nbsp;stream&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435826"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_read_unit_io;&nbsp;&nbsp;&nbsp;/*&nbsp;less&nbsp;preferred&nbsp;read&nbsp;size&nbsp;in&nbsp;bytes&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435834"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_write_preferred_io;&nbsp;/*&nbsp;preferred&nbsp;write&nbsp;size&nbsp;in&nbsp;bytes&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435842"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_write_nstream;&nbsp;&nbsp;/*&nbsp;num&nbsp;of&nbsp;preferred&nbsp;writes&nbsp;to&nbsp;stream&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435850"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_write_unit_io;&nbsp;&nbsp;/*&nbsp;less&nbsp;preferred&nbsp;write&nbsp;size&nbsp;in&nbsp;bytes&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435858"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_pref_strength;&nbsp;&nbsp;/*&nbsp;strength&nbsp;of&nbsp;preferences&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435866"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_breakup_size;&nbsp;&nbsp;&nbsp;/*&nbsp;I/O&nbsp;breakup&nbsp;size&nbsp;in&nbsp;bytes&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435874"></a><font face="Courier New, Courier, sansserif, sans serif" size="2">unsigned&nbsp;&nbsp;vi_align_offset;&nbsp;&nbsp;&nbsp;/*&nbsp;adj&nbsp;for&nbsp;alignment&nbsp;calculations&nbsp;*/</font>
</font>
<br>
<font face="Courier New, Courier, sansserif, sans serif" size="2"><a name="435882"></a>dev_t&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;vi_block_device;&nbsp;&nbsp;&nbsp;/*&nbsp;bdev&nbsp;number&nbsp;for&nbsp;this&nbsp;cdev&nbsp;*/&nbsp;
</font>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425573"></a>For an application to do the most efficient direct I/O or discovered direct I/O, read requests should be equal to the product of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_read_nstream </b></font>multiplied by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_read_preferred_io</b></font>. In general, any multiple or factor of <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_read_nstream </b></font>multiplied by <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_read_preferred_io</b></font> is a size for good performance. For writing, the same formula applies to the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_write_preferred_io </b></font>and <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vi_write_nstream </b></font>parameters. </font>
</blockquote>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="425592"></a>If an application is doing sequential I/O to large files, it issues a request larger than the discovered direct I/O size for the file system. This causes the I/O requests to be performed as discovered direct I/O requests (which are unbuffered like direct I/O but do not require synchronous inode updates when extending the file). If the file is larger than can fit in the cache, using unbuffered I/O avoids CPU overhead and removing useful data from the cache. See the <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtunefs</b></font>(1M) manual page for more information on discovered direct I/O. </font>
</blockquote>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="436262"></a> DIAGNOSTICS</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436267"></a>Operation failures can return any of the following values in <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>errno : </b></font></font>
</p>

<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436299"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EACCESS</b></font></font>
</p>
<p>
<a name="437854"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The calling process does not have write access to the file specified by <em>fildes</em>. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436330"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EAGAIN</b></font></font>
</p>
<p>
<a name="437873"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The file system is not currently frozen. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436349"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EBADF</b></font></font>
</p>
<p>
<a name="437896"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The <em>fildes </em>argument is not a valid file descriptor open for writing. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436392"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EFAULT</b></font></font>
</p>
<p>
<a name="437915"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An address specified by an argument is invalid. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436411"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EFBIG</b></font></font>
</p>
<p>
<a name="437934"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An attempt was made to reserve space larger than the maximum file size limit for this process. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436455"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EINVAL</b></font></font>
</p>
<p>
<a name="437953"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The command or argument is invalid. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436474"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EIO</b></font></font>
</p>
<p>
<a name="437972"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">An I/O error occurred while attempting to perform the operation. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436493"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENODEV</b></font></font>
</p>
<p>
<a name="437995"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The file specified by <em>fildes</em> is not the root directory of a VxFS file system. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436524"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ENOSPC</b></font></font>
</p>
<p>
<a name="438014"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">Requested space could not be obtained. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436543"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EPERM</b></font></font>
</p>
<p>
<a name="438033"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The process does not have appropriate privilege. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436562"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>EROFS</b></font></font>
</p>
<p>
<a name="438052"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The file system is mounted read-only. </font>
</p>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436581"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ETIMEDOUT</b></font></font>
</p>
<p>
<a name="438071"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2">The VX_FREEZE timeout expired before this call. </font>
</p>

<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="436599"></a> NOTES</font>
</h3>
<p>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436604"></a>In some cases, <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsadm</b></font> may reorganize the extent map of a file in such a way as to make it less contiguous. However, it does not change the geometry of a file that has a fixed extent size. </font>
</p>


<h3><font face="Arial, Helvetica, Geneva, sansserif, sans serif, Verdana" size="2" color="#000000">
<a name="436668"></a> SEE ALSO</font>
</h3>
<blockquote>
<font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><a name="436673"></a><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ulimit</b></font>(1), <a href="fsadm_vxfs_vxfs_manpages12_440823.html#433586"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fsadm_vxfs </b></font></font></a>(1M), <a href="vxtunefs_vxfs_manpages38_435201.html#430432"><font color="#0000ff"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>vxtunefs </b></font></font></a>(1M), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>fcntl</b></font>(2), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>getrlimit</b></font>(2), <font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="2"><b>ioctl</b></font>(2) </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="vxfsio_vxfs_manpages98_436668.html" title="vxfsio">Return to Top</a></font>

  </td>
  <td align="right"><font face="Verdana, Arial, Helvetica, Geneva, sansserif, sans serif" size="-2">&lt;&nbsp;<a href="man7_titlepage_docCD_vxfs_manpages97_73700.vxhd" title="Previous - Miscellaneous (7)">Previous</a>&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="man7_titlepage_docCD_vxfs_manpages97_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>
