Differences

This shows you the differences between two versions of the page.

Link to this comparison view

en:navody:ssh:dmfind [24.04.2013 17:17] – external edit 127.0.0.1en:navody:ssh:dmfind [23.03.2021 12:06] (current) – removed danecek_cesnet.cz
Line 1: Line 1:
-<html> 
-<style> td {text-align:left; } </style> 
  
-<h1 align=center>DMFIND</h1> 
-<a href="#NAME">NAME</a><br> 
-<a href="#SYNOPSIS">SYNOPSIS</a><br> 
-<a href="#IMPLEMENTATION">IMPLEMENTATION</a><br> 
-<a href="#DESCRIPTION">DESCRIPTION</a><br> 
-<a href="#OPTIONS">OPTIONS</a><br> 
-<a href="#EXIT STATUS">EXIT STATUS</a><br> 
-<a href="#BUGS">BUGS</a><br> 
-<a href="#EXAMPLES">EXAMPLES</a><br> 
-<a href="#FILES">FILES</a><br> 
-<a href="#NOTES">NOTES</a><br> 
-<a href="#COPYRIGHT">COPYRIGHT</a><br> 
-<a href="#SEE ALSO">SEE ALSO</a><br> 
- 
-<hr> 
-<a name="NAME"></a> 
-<h2>NAME</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p><b>dmfind</b> &minus; Searches for files in a directory 
-hierarchy</p> 
-</td> 
-</table> 
-<a name="SYNOPSIS"></a> 
-<h2>SYNOPSIS</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p><b>dmfind</b> [-H] [-L] [-P] [<i>path-name-list...</i>] 
-[<i>expression</i>]</p> 
-</td> 
-</table> 
-<a name="IMPLEMENTATION"></a> 
-<h2>IMPLEMENTATION</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>SGI systems licensed for the Data Migration Facility 
-(DMF) and systems functioning as DMF clients.</p> 
-</td> 
-</table> 
-<a name="DESCRIPTION"></a> 
-<h2>DESCRIPTION</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>The <b>dmfind</b> command recursively descends the 
-directory hierarchy for each path name in the 
-<i>path-name-list</i> (that is, one or more path names) 
-seeking files that match a boolean expression written in the 
-<i>expression</i>. If the <i>expression</i> does not contain 
-at least one of <b>-print</b>, <b>-ok</b>, <b>-exec</b>, or 
-<b>-execdir</b>, including the case of a null expression, a 
-<b>-print</b> is implicit.</p> 
-</td> 
-</table> 
-<a name="OPTIONS"></a> 
-<h2>OPTIONS</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>The &lsquo;-H&rsquo;, &lsquo;-L&rsquo; and 
-&lsquo;-P&rsquo; command line options control the treatment 
-of symbolic links. If specified, the command line options 
-&lsquo;-H&rsquo;, &lsquo;-L&rsquo; and &lsquo;-P&rsquo; must 
-appear before the first path name.</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="2%"> 
- 
-<p><b>-H</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="77%"> 
- 
-<p>Do not follow symbolic links, except while processing 
-the command line arguments. When <b>dmfind</b> examines or 
-prints information about files, the information used shall 
-be taken from the properties of the symbolic link 
-itself.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="2%"> 
- 
-<p><b>-L</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="77%"> 
- 
-<p>Follow symbolic links. When <b>dmfind</b> examines or 
-prints information about files, the information used shall 
-be taken from the properties of the file to which the link 
-points, not from the link itself (unless it is a broken 
-symbolic link or <b>dmfind</b> is unable to examine the file 
-to which the link points).</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="2%"> 
- 
-<p><b>-P</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="77%"> 
- 
-<p>Never follow symbolic links. This is the default 
-behaviour.</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="4%"></td> 
-<td width="95%"> 
-<p><b>Expressions</b></p></td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>The <i>expression</i> is made up of options, tests, and 
-actions, all of which can be separated by operators.</p> 
-<!-- INDENTATION --> 
-<p>Options differ from the other expressions in that they 
-have an effect on overall operation of the command rather 
-than the processing of a specific file; they always return a 
-true value. Tests process files and return a true or false 
-value. Actions have side effects and return a true or false 
-value. A logical <b>AND</b> is assumed if the operator is 
-omitted.</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="4%"></td> 
-<td width="95%"> 
-<p><b>Options</b></p></td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>All options always return true. This means that they 
-always take effect, rather than being processed only when 
-their place in the expression is reached. Therefore, for 
-clarity, most people place them at the beginning of the 
-expression.</p> 
-<!-- INDENTATION --> 
-<p><b>dmfind</b> accepts the following Option 
-expressions:</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>Option expressions</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p><b>Description</b></p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-depth</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Processes the contents of each directory before the 
-directory itself. This can be useful when <b>dmfind</b> is 
-used with <b>cpio</b>(1) to transfer files that are 
-contained in directories without write permission.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-follow</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Causes the underlying file of a symbolic link to be 
-checked rather than the symbolic link itself.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-xdev</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Specifies that <b>dmfind</b> should restrict its search 
-to the file system containing the <i>path-name-list</i>. 
-Don&rsquo;t descend directories on other filesystems.</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="4%"></td> 
-<td width="95%"> 
-<p><b>Tests</b></p></td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>Tests are expressions that limit what the <b>dmfind</b> 
-command returns. For example, the following command prints a 
-list of files in the current (working) directory that were 
-accessed within the last hour:</p> 
-<!-- INDENTATION --> 
-<pre><b>     dmfind . -atime 1 
-</b></pre> 
-<!-- INDENTATION --> 
-<p>All numeric arguments can be specified as 
-follows:</p></td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="5" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="19%"></td> 
-<td width="2%"> 
- 
-<p><b>+</b><i>n</i></p> 
-</td> 
-<td width="13%"></td> 
-<td width="17%"> 
- 
-<p>More than <i>n</i></p> 
-</td> 
-<td width="46%"> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="19%"></td> 
-<td width="2%"> 
- 
-<p><i>n</i></p> 
-</td> 
-<td width="13%"></td> 
-<td width="17%"> 
- 
-<p>Exactly <i>n</i></p> 
-</td> 
-<td width="46%"> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="19%"></td> 
-<td width="2%"> 
- 
-<p><b>-</b><i>n</i></p> 
-</td> 
-<td width="13%"></td> 
-<td width="17%"> 
- 
-<p>Less than <i>n</i></p> 
-</td> 
-<td width="46%"> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>The <b>dmfind</b> command accepts the following Test 
-expressions:</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>Test expression</b></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p><b>Description</b></p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-amin</b> [<b>+-</b>]<i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>File was last accessed <i>n</i> minutes ago. See 
-<b>stat</b>(2) for a description of which file operations 
-change the access time of a file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-anewer</b> <i>file</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the <i>path-name-list</i> was last 
-accessed more recently than <i>file</i> was modified. See 
-<b>stat</b>(2) for a description of which file operations 
-change the access time of a file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-atime</b> [<b>+-</b>]<i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file was last accessed <i>n</i> days 
-ago. The definition of <i>n</i> days ago is any time within 
-the interval beginning exactly <i>n</i>*24 hours ago and 
-ending exactly (<i>n</i>-1)*24 hours ago. The <b>+</b> and 
-<b>-</b> prefixes signify more or less than <i>n</i> days 
-ago, respectively. This means that <b>+</b><i>n</i> is more 
-than <i>n</i>*24 hours ago, and <b>-</b><i>n</i> is less 
-than <i>n</i>*24 hours ago. See <b>stat</b>(2) for a 
-description of which file operations change the access time 
-of a file. The access time of directories in 
-<i>path-name-list</i> is changed by <b>dmfind</b> 
-itself.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-bfid</b> <i>bfid</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Specifies that <b>dmfind</b> should find the file with 
-the specified bit file identifier (<i>bfid</i>) attached to 
-it in the DMF migration process. See <b>dmattr</b>(1) for a 
-description of bit file identifiers.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-cmin</b> [<b>+-</b>]<i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>The file&rsquo;s status was last changed <i>n</i> 
-minutes ago. See <b>stat</b>(2) for a description of which 
-file operations change the change time of a file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-cnewer</b> <i>file</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the <i>path-name-list</i> was last 
-changed more recently than <i>file</i> was modified. See 
-<b>stat</b>(2) for a description of which file operations 
-change the change time of a file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-ctime</b> [<b>+-</b>]<i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the status of the file was last changed 
-<i>n</i>*24 hours ago. See <b>-atime</b> for a complete 
-description of the definition of &quot;24 hours 
-ago&quot;.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-empty</b></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>File or directory is empty.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-fhandle</b> <i>dmapi_file_handle</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Specifies that <b>dmfind</b> should find the file with 
-the specified Data Management API (DMAPI) fhandle. The 
-fhandle is the DMF representation of the DMAPI name for the 
-file in the file system.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-fstype</b> <i>type</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file is on a file system of type 
-<i>type</i>.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-group</b> <i>gname</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file belongs to group <i>gname</i>. 
-If <i>gname</i> is numeric and does not appear in the 
-<b>/etc/group</b> file, it is taken as a group ID.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-iname</b> <i>pattern</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Like -name, but the match is case insensitive. For 
-example, the patterns &lsquo;fo*&rsquo; and 
-&lsquo;F??&rsquo; match the file names &lsquo;Foo&rsquo;, 
-&lsquo;FOO&rsquo;, &lsquo;foo&rsquo;, &lsquo;fOo&rsquo;, 
-etc. Unlike filename expansion by the shell, an initial 
-&rsquo;.&rsquo; can be matched by a &rsquo;*&rsquo; in the 
-<i>pattern</i>. For example, <b>find -name *bar</b> will 
-match the file &lsquo;.foobar&rsquo;. Please note that you 
-should quote patterns as a matter of course, otherwise the 
-shell will expand any wildcard characters contained in the 
-<i>pattern</i>.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-inum</b> <i>inode</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that <i>inode</i> is the inode number of the 
-file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-links</b> <i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file has <i>n</i> links.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-maxdepth</b> <i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>True if the current search depth is less than or equal 
-to <i>n</i>.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-mindepth</b> <i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>True if the current search depth is greater than or 
-equal to <i>n</i>.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-mmin</b> [<b>+-</b>]<i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>File&rsquo;s data was last modified <i>n</i> minutes 
-ago. See <b>stat</b>(2) for a description of which file 
-operations change the modification time of a file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-mtime</b> [<b>+-</b>]<i>n</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the data in the file was last modified 
-<i>n</i>*24 hours ago. See <b>-atime</b> for a complete 
-description of the definition of &quot;24 hours 
-ago&quot;.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-name</b> <i>pattern</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that <i>pattern</i> matches the current file 
-name. Normal shell argument syntax must be escaped. The 
-metacharacters (<b>*</b>, <b>?</b>, and <b>[]</b>) do not 
-match a <b>.</b> at the start of the file name.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-newer</b> <i>file</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the <i>path-name-list</i> was last 
-modified more recently than <i>file</i> was modified. See 
-<b>stat</b>(2) for a description of which file operations 
-change the modification time of a file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-nogroup</b></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file belongs to a group not in the 
-<b>/etc/group</b> file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-nouser</b></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file belongs to a user not in the 
-<b>/etc/passwd</b> file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="38%"> 
- 
-<p><b>-path</b> <i>pattern</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="47%"> 
- 
-<p>File name matches shell pattern <i>pattern</i>. The 
-metacharacters do not treat &lsquo;/&rsquo; or 
-&lsquo;.&rsquo; specially. For example,</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="52%"></td> 
-<td width="47%"> 
-<pre><b>         find . -path &rsquo;./sr*sc&rsquo; 
-</b></pre> 
-<!-- INDENTATION --> 
-<p>will print an entry for a directory called 
-&rsquo;./src/misc&rsquo; (if one exists). To ignore a whole 
-directory tree, use -prune rather than checking every file 
-in the tree. For example, to skip the directory 
-&lsquo;src/emacs&rsquo; and all files and directories under 
-it, and print the names of the other files found, do 
-something like this:</p> 
-<!-- INDENTATION --> 
-<pre><b>         find . -path &rsquo;./src/emacs&rsquo; -prune -o -print 
-</b></pre> 
-</td> 
-</table> 
-<!-- TABS --> 
- 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="20%"> 
- 
-<p><b>-perm</b> <i>mode</i></p> 
-</td> 
-<td width="20%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file&rsquo;s permission bits are 
-exactly <i>mode</i>, which can be an octal number or a 
-symbolic expression of the form used in <b>chmod</b>(1).</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="20%"> 
- 
-<p><b>-perm -</b><i>mode</i></p> 
-</td> 
-<td width="20%"></td> 
-<td width="47%"> 
- 
-<p>All of the permission bits in <i>mode</i> are set for 
-the file. <i>mode</i> can be an octal number or a symbolic 
-expression of the form used in <b>chmod</b>(1).</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="20%"> 
- 
-<p><b>-perm +</b><i>mode</i></p> 
-</td> 
-<td width="20%"></td> 
-<td width="47%"> 
- 
-<p>Any of the permission bits in <i>mode</i> are set for 
-the file. <i>mode</i> can be an octal number or a symbolic 
-expression of the form used in <b>chmod</b>(1).</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="20%"> 
- 
-<p><b>-size [+-</b>]<i>n</i>[<b>c</b>]</p> 
-</td> 
-<td width="20%"></td> 
-<td width="47%"> 
- 
-<p>Indicates that the file uses <i>n</i> blocks of space. 
-There are 512 bytes per block. If <i>n</i> is followed by a 
-<b>c</b>, the size is in characters.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="20%"> 
- 
-<p><b>-state</b> <i>state</i></p> 
-</td> 
-<td width="20%"></td> 
-<td width="47%"> 
- 
-<p>Specifies that <b>dmfind</b> should find all files of 
-the specified valid DMF <i>state</i>. Possible values for 
-<i>state</i> follow (values can be abbreviated and are 
-case-insensitive):</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>Value</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p><b>Description</b></p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>REG</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>File not managed by DMF</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>MIG</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Migrating file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>ARC</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Archiving file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>DUL</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Dual-state file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>OFL</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Offline file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>UNM</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Unmigrating file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>NMG</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Nonmigratable file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>PAR</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Partial-state file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>INV</b></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>DMF cannot determine the file&rsquo;s state</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="45%"> 
- 
-<p><b>-tag [+-</b>]<i>n</i></p> 
-</td> 
-<td width="7%"></td> 
-<td width="35%"> 
- 
-<p>Indicates that the file on a</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>DMF managed filesystem has sitetag <i>n</i>. See 
-<b>dmtag</b>(1) for more information on DMF sitetags.</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="20%"> 
- 
-<p><b>-type</b> <i>filetype</i></p> 
-</td> 
-<td width="20%"></td> 
-<td width="47%"> 
- 
-<p>Locates files of the specified <i>filetype</i>. The 
-<i>filetype</i> is specified by one of the following 
-letters:</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>b</b></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>Block (buffered) special file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>c</b></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>Character (unbuffered) special file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>d</b></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>Directory</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>f</b></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>Regular file</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>l</b></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>Symbolic link</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>p</b></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>FIFO or named pipe</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>s</b></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>Sockets</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="42%"> 
- 
-<p><b>-user</b> <i>uname</i></p> 
-</td> 
-<td width="5%"></td> 
-<td width="39%"> 
- 
-<p>Indicates that the file is</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>owned by user <i>uname</i>. If <i>uname</i> is numeric 
-and does not appear as a login name in the 
-<b>/etc/passwd</b> file, it is taken as a user ID.</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="4%"></td> 
-<td width="95%"> 
-<p><b>Actions</b></p></td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>Actions are expressions that act on files. They allow you 
-to execute commands from within a <b>dmfind</b> command 
-line. The <b>dmfind</b> command accepts the following Action 
-expressions:</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>Action expression</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p><b>Description</b></p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-exec</b> <i>command</i> <b>;</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Execute <i>command</i> True if the executed 
-<i>command</i> returns a zero value as exit status. The end 
-of <i>command</i> must be punctuated by an escaped 
-semicolon. A command argument <b>{}</b> is replaced by the 
-current path name. To escape constructions, you can use a 
-backslash (<b>\</b>) or quotation marks 
-(<b>&quot;&quot;</b>) to protect them from expansion by the 
-shell.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-execdir</b> <i>command</i> <b>;</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Like <b>-exec</b> except that the command is executed 
-from the directory containing the file.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-ls</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>True; list current file in &lsquo;ls -dils&rsquo; format 
-to standard output.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-ok</b> <i>command</i> <b>;</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Like <b>-exec</b> except that the generated command line 
-is printed with a question mark first, and is executed only 
-if the user responds by typing <b>y</b>.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-print</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Prints command output to standard output. This is 
-assumed if neither <b>-ok</b> nor <b>-exec</b> are 
-specified.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-print0</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>True; print the full file name to standard output, 
-followed by a null character (instead of the newline 
-character that &lsquo;-print&rsquo; uses). This allows file 
-names that contain newlines or other types of white space to 
-be correctly interpreted by programs that process the 
-<b>dmfind</b> output. This option corresponds to the 
-&lsquo;-0&rsquo; option of <b>xargs</b>.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="26%"> 
- 
-<p><b>-prune</b></p> 
-</td> 
-<td width="14%"></td> 
-<td width="47%"> 
- 
-<p>Specifies that <b>dmfind</b> should not examine any 
-directories or files in the directory structure below the 
-pattern just matched. If the current path name is a 
-directory, <b>dmfind</b> does not descend into that 
-directory, provided <b>-depth</b> is not also used.</p> 
-</td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="4%"></td> 
-<td width="95%"> 
-<p><b>Operators</b></p></td> 
-</table> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>The operators are as follows, listed in order of 
-decreasing precedence:</p> 
-</td> 
-</table> 
-<!-- TABS --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="4" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><b>Operator</b></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p><b>Description</b></p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><b>(</b> <i>expression</i> <b>)</b></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p>True if the <i>expression</i> is true. Parentheses are 
-special to the shell and must be escaped.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><b>!</b> <i>expression</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p>True if <i>expression</i> is false.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><i>expr1 expr2</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p>AND (implied); <i>expr2</i> is not evaluated if 
-<i>expr1</i> is false.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><i>expr1</i> <b>-a</b> <i>expr2</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p>Another form of the AND operator.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><i>expr1</i> <b>-and</b> <i>expr2</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p>Another form of the AND operator.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><i>expr1</i> <b>-o</b> <i>expr2</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p>OR; <i>expr2</i> is not evaluated if <i>expr1</i> is 
-true.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="23%"> 
- 
-<p><i>expr1</i> <b>-or</b> <i>expr2</i></p> 
-</td> 
-<td width="2%"></td> 
-<td width="61%"> 
- 
-<p>Another form of the OR operator.</p> 
-</td> 
-</table> 
-<a name="EXIT STATUS"></a> 
-<h2>EXIT STATUS</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>An exit status of 0 (zero) indicates that all 
-<i>path-name-list</i> operands were traversed successfully. 
-An exit status greater than zero indicates that an error 
-occurred.</p> 
-</td> 
-</table> 
-<a name="BUGS"></a> 
-<h2>BUGS</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>The command <b>dmfind / -depth</b> always fails with the 
-following message:</p> 
-<!-- INDENTATION --> 
-<pre><b>     dmfind:  stat failed:  : No such file or directory 
-</b></pre> 
-<!-- INDENTATION --> 
-<p>The <b>dmfind</b> command relies on a completely correct 
-directory hierarchy for its search. In particular, if a 
-directory&rsquo;s <b>..</b> is missing or incorrect, 
-<b>dmfind</b> fails at that point and issues some number 
-<b>stat failed:</b> messages.</p> 
-<!-- INDENTATION --> 
-<p><b>-depth</b> and <b>-prune</b> do not work together 
-well.</p> 
-</td> 
-</table> 
-<a name="EXAMPLES"></a> 
-<h2>EXAMPLES</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>Example 1: To remove all files named <b>a.out</b> or 
-<b>*.o</b> that have not been accessed for a week, use the 
-following command:</p> 
-<!-- INDENTATION --> 
-<pre><b>  dmfind / \( -name a.out -o -name &rsquo;*.o&rsquo; \) -atime +7 -exec rm {} \ ; 
-</b></pre> 
-<!-- INDENTATION --> 
-<p>Example 2: To display all character special devices on 
-the root file system except those under any <b>dev</b> 
-directory:</p> 
-<!-- INDENTATION --> 
-<pre><b>  dmfind / -xdev \( -type d -name dev -prune \) -o -type c -print 
-</b></pre> 
-<!-- INDENTATION --> 
-<p>Example 3: To recall all offline files in a directory 
-tree:</p> 
-<!-- INDENTATION --> 
-<pre><b>  dmfind . -state OFL | dmget 
-</b>Note that piping the pathnames directly into dmget is much more efficient 
-than the use of the <b>-exec</b> option or the <b>xargs</b> command. 
-<b>dmattr</b>, <b>dmput</b> and <b>dmtag</b> also accept pathnames on their 
-standard input file. 
-</pre> 
-</td> 
-</table> 
-<a name="FILES"></a> 
-<h2>FILES</h2> 
-<!-- TABS --> 
- 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="5" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="16%"> 
- 
-<p><b>/etc/passwd</b></p> 
-</td> 
-<td width="23%"></td> 
-<td width="36%"> 
- 
-<p>Supplies UID information</p> 
-</td> 
-<td width="11%"> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="16%"> 
- 
-<p><b>/etc/group</b></p> 
-</td> 
-<td width="23%"></td> 
-<td width="36%"> 
- 
-<p>Supplies GID information</p> 
-</td> 
-<td width="11%"> 
-</td> 
-</table> 
-<a name="NOTES"></a> 
-<h2>NOTES</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>The <b>dmfind</b> command was rewritten in DMF 3.7.0. As 
-a result of the rewrite, the following <b>dmfind</b> options 
-were removed : d, f, h, X, x, help, verbose. The following 
-expressions were removed: cpio, flags, mount, ncpio, noproj, 
-proj, label, xlabel, dominates, dominated. On IRIX and SGI 
-ProPack on SGI Altix ia64 systems, please see the 
-<b>sgi_dmfind</b>(1) man page for more information about 
-these options.</p> 
-</td> 
-</table> 
-<a name="COPYRIGHT"></a> 
-<h2>COPYRIGHT</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p>Copyright (c) 2007 SGI. All rights reserved.</p> 
-<!-- INDENTATION --> 
-<p>Copyright (c) 1990, 1993 The Regents of the University of 
-California. All rights reserved.</p> 
-</td> 
-</table> 
-<a name="SEE ALSO"></a> 
-<h2>SEE ALSO</h2> 
-<!-- INDENTATION --> 
-<table width="100%" border=0 rules="none" frame="void" 
-       cols="2" cellspacing="0" cellpadding="0"> 
-<tr valign="top" align="left"> 
-<td width="10%"></td> 
-<td width="89%"> 
-<p><b>dmattr</b>(1) and <b>dmls</b>(1) for other methods of 
-obtaining the DMF state of files</p> 
-<!-- INDENTATION --> 
-<p><b>chmod</b>(1) for more information on file permission 
-flags<b><br> 
-cpio</b>(1) for more information on transferring files 
-located with <b>find<br> 
-rm</b>(1) for more information on deleting files and 
-directories<b><br> 
-sh</b>(1) for more information on quoting and parameter 
-substitution<b><br> 
-test</b>(1) for more information on testing conditions</p> 
-<!-- INDENTATION --> 
-<p><b>stat</b>(2) for file system information<b><br> 
-sysfs</b>(2) for file system type information<b><br> 
-umask</b>(2) for information on setting and getting file 
-creation masks</p> 
-<!-- INDENTATION --> 
-<p><b>xfs</b>(4) for the information about the XFS file 
-system</p> 
-<!-- INDENTATION --> 
-<p><b>cpio</b>(5) for the format of <b>cpio</b> files</p> 
-</td> 
-</table> 
-<hr> 
- 
-</html>