This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
en:navody:ssh:dmget [24.04.2013 17:17] 127.0.0.1 external edit |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | <html> | ||
| - | <style> td {text-align:left; } </style> | ||
| - | <h1 align=center>DMGET</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="#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>dmget</b> − Recalls previously migrated | ||
| - | files</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>dmget</b> [<b>-h</b> | <b>-a</b>] [<b>-n</b>] | ||
| - | [<b>-q</b>] [<b>-v</b>] [<b>-B</b> byterange-list] | ||
| - | [<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>dmget</b> command recalls previously migrated | ||
| - | files. You can use this command to retrieve migrated files | ||
| - | for which you have read permission; the system administrator | ||
| - | can use this command to retrieve any migrated files. Only | ||
| - | <b>root</b> users can use this command to recall files for | ||
| - | which they do not have read permission.</p> | ||
| - | <!-- INDENTATION --> | ||
| - | <p>The <b>dmget</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="8%"> | ||
| - | |||
| - | <p><b>Option</b></p> | ||
| - | </td> | ||
| - | <td width="5%"></td> | ||
| - | <td width="73%"> | ||
| - | |||
| - | <p><b>Description</b></p> | ||
| - | </td> | ||
| - | <tr valign="top" align="left"> | ||
| - | <td width="11%"></td> | ||
| - | <td width="8%"> | ||
| - | |||
| - | <p><b>-h</b></p> | ||
| - | </td> | ||
| - | <td width="5%"></td> | ||
| - | <td width="73%"> | ||
| - | |||
| - | <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. This option requires <b>root</b> | ||
| - | privileges.</p> | ||
| - | </td> | ||
| - | <tr valign="top" align="left"> | ||
| - | <td width="11%"></td> | ||
| - | <td width="8%"> | ||
| - | |||
| - | <p><b>-a</b></p> | ||
| - | </td> | ||
| - | <td width="5%"></td> | ||
| - | <td width="73%"> | ||
| - | |||
| - | <p>Update the access time of the file. This option cannot | ||
| - | be specified when <b>-h</b> is used.</p> | ||
| - | </td> | ||
| - | <tr valign="top" align="left"> | ||
| - | <td width="11%"></td> | ||
| - | <td width="8%"> | ||
| - | |||
| - | <p><b>-n</b></p> | ||
| - | </td> | ||
| - | <td width="5%"></td> | ||
| - | <td width="73%"> | ||
| - | |||
| - | <p>Directs the <b>dmget</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="8%"> | ||
| - | |||
| - | <p><b>-q</b></p> | ||
| - | </td> | ||
| - | <td width="5%"></td> | ||
| - | <td width="73%"> | ||
| - | |||
| - | <p>Directs the <b>dmget</b> command to exit as soon as all | ||
| - | recall requests have been sent to and acknowledged as | ||
| - | received by the DMF daemon. The command will not wait for | ||
| - | verification that the recall has completed, successfully or | ||
| - | otherwise. It is then up to the caller to determine when and | ||
| - | if the recall succeeds.</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="24%"></td> | ||
| - | <td width="75%"> | ||
| - | <p><b>Note</b>: If the DMF daemon is stopped or otherwise | ||
| - | exits before the recall request is complete, the regions of | ||
| - | the file being recalled will be returned to the offline | ||
| - | state when the DMF daemon is restarted. In this case the | ||
| - | recall request will never be observed as complete and the | ||
| - | request must be re-issued. If the <b>dmget</b> command is | ||
| - | executed without the <b>-q</b> option, the command will | ||
| - | persist across DMF daemon restarts to complete the | ||
| - | recall.</p> | ||
| - | <!-- INDENTATION --> | ||
| - | <p>Also note that the <b>-q</b> option does not change the | ||
| - | <b>dmget</b> command’s behavior in regards to the | ||
| - | presence or absence of the <b>-n</b> option. That is, if the | ||
| - | <b>-n</b> option is not present and the DMF daemon is not | ||
| - | running, the <b>dmget</b> command with the <b>-q</b> option | ||
| - | will wait until the DMF daemon has been started and the | ||
| - | command has received acknowledgment that the requests were | ||
| - | received before exiting.</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>-v</b></p> | ||
| - | </td> | ||
| - | <td width="11%"></td> | ||
| - | <td width="73%"> | ||
| - | |||
| - | <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> | ||
| - | </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>-B 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="26%"></td> | ||
| - | <td width="73%"> | ||
| - | <p>Specifies that only a part of the file should be recalled | ||
| - | to disk; the other parts may or may not be offline. 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 "mmmm:nnnn" | ||
| - | where "mmmm" specifies the first byte in the range | ||
| - | and "nnnn" specifies the last byte in it. Each of | ||
| - | "mmmm" and "nnnn" counts from the | ||
| - | beginning of the file if unsigned, and backwards from the | ||
| - | end if preceded by "-". The first byte in the file | ||
| - | is byte "0", "BOF", or "bof", | ||
| - | and the last one is byte "-0", "EOF", or | ||
| - | "eof", so "bof:eof", | ||
| - | "BOF:EOF", and "0:-0" all define a range | ||
| - | covering the entire file.</p> | ||
| - | <!-- INDENTATION --> | ||
| - | <p>A <b>byterange</b> may also of the form | ||
| - | "mmmm+llll" where "mmmm" is a byte | ||
| - | position as above, and "llll" is the number of | ||
| - | bytes in the range, starting at "mmmm". If | ||
| - | "llll" starts with a minus sign, it specifies a | ||
| - | range of "llll" bytes ending at | ||
| - | "mmmm".</p> | ||
| - | <!-- INDENTATION --> | ||
| - | <p>A single number "llll" (without a colon or plus | ||
| - | symbol) is also acceptable as a <b>byterange</b>, being | ||
| - | interpreted as "EOF+llll" if "llll" | ||
| - | starts with a "-", or "BOF+llll" if it | ||
| - | doesn’t.</p> | ||
| - | <!-- INDENTATION --> | ||
| - | <p>Each number can be either a hexadecimal number of the | ||
| - | form "0xnnnn", a based number of the form | ||
| - | "base#nnnn", or a decimal number with an optional | ||
| - | trailing scaling character. The decimal number may include a | ||
| - | "." 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> | ||
| - | <!-- 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="8%"></td> | ||
| - | <td width="73%"> | ||
| - | |||
| - | <p>Specifies a list of file paths or fhandles to recall. If | ||
| - | you do not specify <i>list</i>, <b>dmget</b> reads the list | ||
| - | of file paths or fhandles from standard input. The | ||
| - | <b>dmget</b> command is synchronous. Therefore, you cannot | ||
| - | initiate another process until all of the file paths or | ||
| - | fhandles in <i>list</i> are recalled. If the offline medium | ||
| - | is tape, this could result in a delay while waiting for tape | ||
| - | resources.</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>Only files residing on file systems configured for use | ||
| - | with DMF may be recalled.</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>To efficiently recall all files in a directory named | ||
| - | <b>mydir</b> and its subdirectories, use the following | ||
| - | command:</p> | ||
| - | <!-- INDENTATION --> | ||
| - | <pre><b> dmfind mydir -state MIG -o -state OFL -o -state PAR | 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. | ||
| - | |||
| - | The following command recalls the first 4000 bytes (rounded to a disk | ||
| - | block boundary) of <b>partfile</b> back to disk: | ||
| - | |||
| - | <b> dmget -B 0:4000 partfile | ||
| - | |||
| - | </b></pre> | ||
| - | </td> | ||
| - | </table> | ||
| - | <a name="FILES"></a> | ||
| - | <h2>FILES</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>/etc/dmf/dmf.conf</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="26%"></td> | ||
| - | <td width="73%"> | ||
| - | <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>dmfind</b></tt>(1) for information about finding | ||
| - | files<tt><b><br> | ||
| - | dmput</b></tt>(1) for information about migrating online | ||
| - | files to offline media<tt><b><br> | ||
| - | dmfsmon</b></tt>(8) for information about selecting files | ||
| - | for migration</p> | ||
| - | </td> | ||
| - | </table> | ||
| - | <hr> | ||
| - | </html> | ||
CESNET, z. s. p. o.
Generála Píky 26
16000 Prague 6
Tel: +420 234 680 222
Fax: +420 224 320 269
info@cesnet.cz
Tel: +420 234 680 222
GSM: +420 602 252 531
Fax: +420 224 313 211
support@cesnet.cz