manual/GNU_tar/release/man8/rmt.8

   1 .\" This file is part of GNU tar. -*- nroff -*-
   2 .\" Copyright 2013, 2018 Free Software Foundation, Inc.
   3 .\"
   4 .\" GNU tar is free software; you can redistribute it and/or modify
   5 .\" it under the terms of the GNU General Public License as published by
   6 .\" the Free Software Foundation; either version 3 of the License, or
   7 .\" (at your option) any later version.
   8 .\"
   9 .\" GNU tar is distributed in the hope that it will be useful,
  10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 .\" GNU General Public License for more details.
  13 .\"
  14 .\" You should have received a copy of the GNU General Public License
  15 .\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16 .\"*******************************************************************
  17 .\"
  18 .\" This file was generated with po4a. Translate the source file.
  19 .\"
  20 .\"*******************************************************************
  21 .\"
  22 .\" translated for 1.34, 2022-05-12
  23 .\"
  24 .TH RMT 8 2018/03/24 RMT "GNU TAR マニュアル"
  25 .SH 名前
  26 rmt \- リモートの磁気テープサーバー
  27 .SH 書式
  28 \fBrmt\fP
  29 .SH 説明
  30 \fBRmt\fP は、\fBtar\fP(1), \fBcpio\fP(1)
  31 などのバックアップユーティリティーを利用したファイルやデバイスの処理を、リモートからアクセスする機能を提供します。 普通リモートマシンに対しては
  32 \fBrsh\fP(1) または \fBssh\fP(1) を利用して実現します。 ログイン名を指定して別ユーザーを用いることもできます。
  33 .PP
  34 呼び出しを行うプログラムが \fBrmt\fP とやり取りをする際には、標準入力に対してリクエストを送信し、その結果を標準出力から読み取ります。
  35 送信する要求は、要求を表す英字の次に (必要があれば) 引数が続き、最後に改行文字により構成されます。
  36 追加データがある場合は、その改行文字の次に送信されます。 処理が成功すると \fBrmt\fP は以下を返します。
  37 .PP
  38 .in +4
  39 \fBA\fP\fInumber\fP\fB\en\fP
  40 .PP
  41 上の \fInumber\fP は 10 進数のリターンコードを ASCII 表現したものです。 追加の情報はこの行の次に返されます。
  42 エラー発生時には、以下のレスポンスが返されます。
  43 .PP
  44 .in +4
  45 \fBE\fP\fIerrno\fP\fB\en\fP\fIerror\-message\fP\fB\en\fP
  46 .PP
  47 ここで \fIerrno\fP はシステムエラーコードを表すもので、 \fBerrno\fP(3) に説明されています。  \fIerror\-message\fP
  48 はエラー内容を 1 行にわかりやすく示したもので、 \fBperror\fP(3) を用いて出力されています。
  49 .PP
  50 利用できるコマンドとレスポンスの種類については、後述するセクションにおいて説明しています。
  51 .SH コマンド
  52 .TP
  53 \fBO\fP\fIdevice\fP\fB\en\fP\fIflags\fP\fB\en\fP
  54 指定された \fIflags\fP を使って \fIdevice\fP
  55 をオープンします。デバイスがすでにオープンされていた場合は、一度クローズしてから新たにオープンされます。
  56 .sp
  57 \fB引数\fP
  58 .RS
  59 .TP
  60 \fIdevice\fP
  61 オープンするデバイス名。
  62 .TP
  63 \fIflags\fP
  64 \fBopen\fP(2) に対するフラグ。 10 進数値、または \fBfcntl.h\fP に定義された \fBO_*\fP 定数 (先頭の \fBO_\fP
  65 は省略される場合があります)。 またビット表現や (\fB|\fP を利用して) 以下のようにこれらを合わせた数値指定もできます。
  66 .in +4
  67 .EX
  68 576
  69 64|512
  70 CREAT|TRUNC
  71 .EE
  72 .RS
  73 さらに指定を組み合わせることもできます。 たとえば 10 進数によるモードに、そのシンボリックな表現を付け加えるような場合です。
  74 その場合は、シンボリック表現が優先されます。
  75 .RE
  76 .sp
  77 \fB返信 (reply)\fP
  78 .RS
  79 成功時には \fBA0\en\fP を返します。
  80 .RE
  81 .sp
  82 \fB拡張\fP
  83 .RS
  84 BSD バージョンでは \fIflags\fP に 10 進数のみ指定可能です。
  85 .RE 1
  86 .TP
  87 \fBC\fP[\fIdevice\fP]\fB\en\fP
  88 現在オープンしているデバイスをクロースします。
  89 .RS
  90 .TP
  91 \fB引数\fP
  92 .br
  93 引数はすべて無視されます。
  94 .TP
  95 \fB返信 (reply)\fP
  96 .br
  97 成功時には \fBA0\en\fP を返します。
  98 .RE
  99 .TP
 100 \fBL\fP\fIwhence\fP\fB\en\fP\fIoffset\fP\fB\en\fP
 101 .RS
 102 指定されたパラメーターを使って、現在オープンしているデバイスに対して \fBlseek\fP(2) を実行します。
 103 .TP
 104 \fB引数\fP
 105 .RS
 106 .TP
 107 \fIwhence\fP
 108 オフセットをどこからにするか。 指定可能な値は以下です：
 109 .sp
 110 .nf
 111 .ta 1n 20n
 112         0, SET, SEEK_SET        ファイル先頭からシーク
 113         1, CUR, SEEK_CUR        現在位置からシーク
 114         2, END, SEEK_END        ファイル終端からシーク
 115 .fi
 116 .RE
 117 .TP
 118 \fB返信 (reply)\fP
 119 .br
 120 成功時には \fBA\fP\fIoffset\fP\fB\en\fP を返します。 \fIoffset\fP は新たなオフセット値になります。
 121 .TP
 122 \fB拡張\fP
 123 BSD バージョンは \fIwhence\fP に対して 0,1,2 のみ指定可能です。
 124 .RE
 125 .TP
 126 \fBR\fP\fIcount\fP\fB\en\fP
 127 .br
 128 現在のデバイスから \fIcount\fP バイト分のデータを読み込みます。
 129 .RS
 130 .TP
 131 \fB引数\fP
 132 .RS
 133 .TP
 134 \fIcount\fP
 135 読み込みを行うバイト数。
 136 .RE
 137 .TP
 138 \fB返信 (reply)\fP
 139 .br
 140 成功時には以下を返します。
 141 .sp
 142 .in +4
 143 \fBA\fP\fIrdcount\fP\fB\en\fP
 144 .in
 145 .sp
 146 この後ろに、デバイスから読み取った \fIrdcount\fP バイト分のデータが続きます。
 147 .RE
 148 .TP
 149 \fBW\fP\fIcount\fP\fB\en\fP
 150 現在のデバイスにデータを書き込みます。 このコマンドの後ろに、\fIcount\fP バイト分の入力データを続けます。
 151 .RS
 152 .TP
 153 \fB引数\fP
 154 .RS
 155 .TP
 156 \fIcount\fP
 157 書き込みを行うバイト数。
 158 .RE
 159 .TP
 160 \fB返信 (reply)\fP
 161 .br
 162 成功時には \fBA\fP\fIwrcount\fP\fB\en\fP を返します。 ここで \fIwrcount\fP は、実際に書き込みを行ったバイト数です。
 163 .RE
 164 .TP
 165 \fBI\fP\fIopcode\fP\fB\en\fP\fIcount\fP\fB\en\fP
 166 指定されたパラメーターを用いて \fBMTIOCOP\fP \fBioctl\fP(2) コマンドを実行します。
 167 .RS
 168 .TP
 169 \fB引数\fP
 170 .RS
 171 .TP
 172 \fIopcode\fP
 173 \fBMTIOCOP\fP オペレーションコード。
 174 .TP
 175 \fIcount\fP
 176 mt_count
 177 .RE
 178 .TP
 179 \fB返信 (reply)\fP
 180 .br
 181 成功時には \fBA0\en\fP を返します。
 182 .RE
 183 .TP
 184 \fBS\en\fP
 185 現在オープンしているデバイスのステータスを返します。 これは \fBMTIOCGET\fP \fBioctl\fP(2) を呼び出して得ています。
 186 .RS
 187 .TP
 188 \fB引数\fP
 189 .br
 190 なし。
 191 .TP
 192 \fB返信 (reply)\fP
 193 .br
 194 成功時は \fBA\fP\fIcount\fP\fB\en\fP と、その後に \fIcount\fP バイト分のデータが続きます。
 195 .RE
 196 .SH 関連項目
 197 \fBtar\fP(1)
 198 .SH バグ
 199 このユーティリティーを汎用目的のリモートファイルアクセスツールとして利用することはお勧めしません。
 200 .SH バグ報告
 201 バグ報告は <bug\-tar@gnu.org> までお願いします。
 202 .SH 開発経緯
 203 \fBrmt\fP コマンドは 4.2BSD において登場しました。 GNU \fBrmt\fP は BSD の仕様に基づいて一から書き起こされました。
 204 .SH 著作権
 205 Copyright \(co 2013, 2018 Free Software Foundation, Inc.
 206 .br
 207 .na
 208 License GPLv3+: GNU GPL version 3 or later
 209 <http://gnu.org/licenses/gpl.html>
 210 .br
 211 .ad
 212 This is free software: you are free to change and redistribute it.  There is
 213 NO WARRANTY, to the extent permitted by law.
 214 .\" Local variables:
 215 .\" eval: (add-hook 'write-file-hooks 'time-stamp)
 216 .\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\-]* [0-9] \""
 217 .\" time-stamp-format: "%:B %:d, %:y"
 218 .\" time-stamp-end: "\""
 219 .\" time-stamp-line-limit: 20
 220 .\" end: