cs:navody:ssh:dmget

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

cs:navody:ssh:dmget [26.10.2012 02:57] (aktuální)
Řádek 1: Řádek 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>​ &minus; 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&​rsquo;​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 &​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>​
 +<!-- 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>​
  
Poslední úprava: 26.10.2012 02:57