Differences

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

Link to this comparison view

en:navody:ssh:dmput [24.04.2013 17:17] – external edit 127.0.0.1en:navody:ssh:dmput [23.03.2021 12:06] (current) – removed danecek_cesnet.cz
Line 1: Line 1:
-<html> 
-<style> td {text-align:left; } </style> 
-<h1 align=center>DMPUT</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="#NOTES">NOTES</a><br> 
-<a href="#EXAMPLES">EXAMPLES</a><br> 
-<a href="#FILES">FILES</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>dmput</b> &minus; Migrates online files to offline 
-media</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>dmput</b> [<b>-h</b>] [<b>-n</b>] [<b>-r</b> 
-[<b>-F</b> byterange-list]] [<b>-v</b>] [<b>-w</b>] [<b>-V 
-mspvglist</b>] [<i>list</i>]<b><br> 
-dmput</b> [<b>-h</b>] [<b>-n</b>] [<b>-r</b> [<b>-K</b> 
-byterange-list]] [<b>-v</b>] [<b>-w</b>] [<b>-V 
-mspvglist</b>] [<i>list</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>dmput</b> command migrates an online file to an 
-offline medium. You can use this command to migrate files 
-that you own; the system administrator can use this command 
-to migrate any files. You must be <b>root</b> to migrate 
-files you do not own.</p> 
-<!-- INDENTATION --> 
-<p>The <b>dmput</b> command accepts the following 
-options:</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="17%"> 
- 
-<p><b>Option</b></p> 
-</td> 
-<td width="4%"></td> 
-<td width="66%"> 
- 
-<p><b>Description</b></p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="17%"> 
- 
-<p><b>-h</b></p> 
-</td> 
-<td width="4%"></td> 
-<td width="66%"> 
- 
-<p>Causes the <i>list</i> to be treated as a list of Data 
-Management API (DMAPI) fhandles rather than file paths. 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="17%"> 
- 
-<p><b>-n</b></p> 
-</td> 
-<td width="4%"></td> 
-<td width="66%"> 
- 
-<p>Directs the <b>dmput</b> command to abort if the DMF 
-daemon is not responding or if the daemon stops responding 
-while the request is being processed. The default is to wait 
-until the request has finished processing.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="17%"> 
- 
-<p><b>-r</b></p> 
-</td> 
-<td width="4%"></td> 
-<td width="66%"> 
- 
-<p>Releases the disk data blocks associated with this file 
-after the offline copies are made. If this option is not 
-specified, the disk data blocks are not released until 
-automated space management determines a need for the disk 
-blocks.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="17%"> 
- 
-<p><b>-v</b></p> 
-</td> 
-<td width="4%"></td> 
-<td width="66%"> 
- 
-<p>Specifies verbose mode. This option is useful for 
-administrators when trying to determine the cause of 
-operational problems between DMF client commands and the 
-server host machine. This option might cause the command to 
-display more information regarding the cause of an error 
-than the command does without the option, if such 
-information is available. The option is not useful in cases 
-of normal client/server operation.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="17%"> 
- 
-<p><b>-w</b></p> 
-</td> 
-<td width="4%"></td> 
-<td width="66%"> 
- 
-<p>Waits until all offline copies are completed before 
-terminating.</p> 
-</td> 
-<tr valign="top" align="left"> 
-<td width="11%"></td> 
-<td width="17%"> 
- 
-<p><b>-V mspvglist</b></p> 
-</td> 
-<td width="4%"></td> 
-<td width="66%"> 
- 
-<p>Specifies a list of MSPs, VGs or Migrate Groups to which 
-the file should be migrated. The values in the list may be 
-comma-separated, with no white space. Alternatively, the 
-list may be enclosed in quotes, and the values may be 
-separated by white space. This option only affects the 
-initial migration of a file. If the <b>-V</b> option is not 
-specified, the policies in the <b>dmf.conf</b> file 
-determine the MSPs or VGs to which the file should be 
-migrated. If this option is specified, the <b>mspvglist</b> 
-is used, and the policies in the <b>dmf.conf</b> file are 
-ignored, only when <b>dmput</b> is issued by the root user 
-on the DMF server; otherwise the command behaves as if this 
-option had not been entered. If your site is using the 
-Customizable Policy feature, the default behavior may be 
-overridden. Please check with your administrator for any 
-behavior differences due to Customizable Policies.</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><b>-F byterange-list</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="33%"></td> 
-<td width="66%"> 
-<p>Specifies a list of byteranges to be made offline 
-(freed); the rest of the file is kept online. Requires 
-<b>-r</b> and must not be used with <b>-K</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><b>-K byterange-list</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="33%"></td> 
-<td width="66%"> 
-<p>Specifies a list of byteranges to be kept online; the 
-rest of the file is made offline. Requires <b>-r</b> and 
-must not be used with <b>-F</b>.</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="5%"> 
- 
-<p><i>list</i></p> 
-</td> 
-<td width="16%"></td> 
-<td width="66%"> 
- 
-<p>Specifies a list of file paths or fhandles to process. 
-If you do not specify <i>list</i>, <b>dmput</b> processes 
-file paths or fhandles read from standard input.</p> 
-</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 system administrator sets the migration medium used 
-in the DMF configuration file. The files that you migrate 
-must comply with the settings in the configuration file.</p> 
-<!-- INDENTATION --> 
-<p>Unless you specify the <b>-r</b> option, the <b>dmput</b> 
-command does not automatically release the disk space 
-occupied by the file specified (by path or fhandle) in 
-<i>list</i>. Although it is possible that the disk space 
-will eventually be released if the file resides on a file 
-system that is managed by automated space management, it is 
-preferable to always specify the <b>-r</b> option rather 
-than trying to determine whether and when the file space 
-will be released.</p> 
-<!-- INDENTATION --> 
-<p>A <b>byterange-list</b> is one or more <b>byteranges</b> 
-separated by commas.</p> 
-<!-- INDENTATION --> 
-<p>A <b>byterange</b> is of the form &quot;mmmm:nnnn&quot; 
-where &quot;mmmm&quot; specifies the first byte in the range 
-and &quot;nnnn&quot; specifies the last byte in it. Each of 
-&quot;mmmm&quot; and &quot;nnnn&quot; counts from the 
-beginning of the file if unsigned, and backwards from the 
-end if preceded by &quot;-&quot;. The first byte in the file 
-is byte &quot;0&quot;, &quot;BOF&quot;, or &quot;bof&quot;, 
-and the last one is byte &quot;-0&quot;, &quot;EOF&quot;, or 
-&quot;eof&quot;, so &quot;bof:eof&quot;, 
-&quot;BOF:EOF&quot;, and &quot;0:-0&quot; all define a range 
-covering the entire file.</p> 
-<!-- INDENTATION --> 
-<p>A <b>byterange</b> may also of the form 
-&quot;mmmm+llll&quot; where &quot;mmmm&quot; is a byte 
-position as above, and &quot;llll&quot; is the number of 
-bytes in the range, starting at &quot;mmmm&quot;. If 
-&quot;llll&quot; starts with a minus sign, it specifies a 
-range of &quot;llll&quot; bytes ending at 
-&quot;mmmm&quot;.</p> 
-<!-- INDENTATION --> 
-<p>A single number &quot;llll&quot; (without a colon or plus 
-symbol) is also acceptable as a <b>byterange</b>, being 
-interpreted as &quot;EOF+llll&quot; if &quot;llll&quot; 
-starts with a &quot;-&quot;, or &quot;BOF+llll&quot; if it 
-doesn&rsquo;t.</p> 
-<!-- INDENTATION --> 
-<p>Each number can be either a hexadecimal number of the 
-form &quot;0xnnnn&quot;, a based number of the form 
-&quot;base#nnnn&quot;, or a decimal number with an optional 
-trailing scaling character. The decimal number may include a 
-&quot;.&quot; and exponent. The trailing scaling character 
-may be <i>k, K, m, M, g, G, t, T, p,</i> or <i>P,</i> all of 
-which are powers of 1000, not 1024.</p> 
-<!-- INDENTATION --> 
-<p>Byteranges are rounded to disk block boundaries. DMF may 
-decide to join nearby ranges together if necessary, or 
-adjust them to match the size of the file.</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>The following example migrates the <b>report1</b> and 
-<b>report2</b> files. <b>dmput</b> will release the disk 
-space occupied by <b>report1</b> and <b>report2</b>, and 
-will wait until all offline copies are completed before 
-terminating:</p> 
-<!-- INDENTATION --> 
-<pre><b>     dmput -r -w report1 report2 
- 
-</b>The following example finds all unmigrated files in a directory and 
-migrates them: 
- 
-<b>    dmfind . -state REG | dmput 
-</b>Note that piping the pathnames directly into dmput is much more efficient 
-than the use of the <b>-exec</b> option or the <b>xargs</b> command. 
-<b>dmattr</b>, <b>dmget</b> and <b>dmtag</b> also accept pathnames on their 
-standard input file. 
- 
-In the following example, if file <b>partialfile</b> is 14000 bytes long, 
-then both of the following commands will migrate the file, keeping 
-the first 4000 bytes (rounded to a disk block boundary) online and 
-freeing the remainder. 
- 
-<b>    dmput -r -K 0:4000 partialfile 
-     dmput -r -F -10000:-0 partialfile 
- 
-</b></pre> 
-</td> 
-</table> 
-<a name="FILES"></a> 
-<h2>FILES</h2> 
-<!-- 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="25%"> 
- 
-<p><b>/etc/dmf/dmf.conf</b></p> 
-</td> 
-<td width="19%"></td> 
-<td width="44%"> 
- 
-<p>DMF configuration file</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><tt><b>dmget</b></tt>(1) for information about recalling 
-previously migrated files</p> 
-</td> 
-</table> 
-<hr> 
-</html>