RMT
Section: GNU TAR マニュアル (8)
Updated: 2018/03/24
Index
JM Home Page
roff page
名前
rmt - リモートの磁気テープサーバー
書式
rmt
説明
Rmt は、tar(1), cpio(1)
などのバックアップユーティリティーを利用したファイルやデバイスの処理を、リモートからアクセスする機能を提供します。 普通リモートマシンに対しては
rsh(1) または ssh(1) を利用して実現します。 ログイン名を指定して別ユーザーを用いることもできます。
呼び出しを行うプログラムが rmt とやり取りをする際には、標準入力に対してリクエストを送信し、その結果を標準出力から読み取ります。
送信する要求は、要求を表す英字の次に (必要があれば) 引数が続き、最後に改行文字により構成されます。
追加データがある場合は、その改行文字の次に送信されます。 処理が成功すると rmt は以下を返します。
Anumber\n
上の number は 10 進数のリターンコードを ASCII 表現したものです。 追加の情報はこの行の次に返されます。
エラー発生時には、以下のレスポンスが返されます。
Eerrno\nerror-message\n
ここで errno はシステムエラーコードを表すもので、 errno(3) に説明されています。 error-message
はエラー内容を 1 行にわかりやすく示したもので、 perror(3) を用いて出力されています。
利用できるコマンドとレスポンスの種類については、後述するセクションにおいて説明しています。
コマンド
- Odevice\nflags\n
-
指定された flags を使って device
をオープンします。デバイスがすでにオープンされていた場合は、一度クローズしてから新たにオープンされます。
引数
-
- device
-
オープンするデバイス名。
- flags
-
open(2) に対するフラグ。 10 進数値、または fcntl.h に定義された O_* 定数 (先頭の O_
は省略される場合があります)。 またビット表現や (| を利用して) 以下のようにこれらを合わせた数値指定もできます。
576
64|512
CREAT|TRUNC
-
さらに指定を組み合わせることもできます。 たとえば 10 進数によるモードに、そのシンボリックな表現を付け加えるような場合です。
その場合は、シンボリック表現が優先されます。
返信 (reply)
-
成功時には A0\n を返します。
拡張
-
BSD バージョンでは flags に 10 進数のみ指定可能です。
- C[device]\n
-
現在オープンしているデバイスをクロースします。
-
- 引数
-
引数はすべて無視されます。
- 返信 (reply)
-
成功時には A0\n を返します。
- Lwhence\noffset\n
-
-
指定されたパラメーターを使って、現在オープンしているデバイスに対して lseek(2) を実行します。
- 引数
-
-
- whence
-
オフセットをどこからにするか。 指定可能な値は以下です:
0, SET, SEEK_SET ファイル先頭からシーク
1, CUR, SEEK_CUR 現在位置からシーク
2, END, SEEK_END ファイル終端からシーク
- 返信 (reply)
-
成功時には Aoffset\n を返します。 offset は新たなオフセット値になります。
- 拡張
-
BSD バージョンは whence に対して 0,1,2 のみ指定可能です。
- Rcount\n
-
現在のデバイスから count バイト分のデータを読み込みます。
-
- 引数
-
-
- count
-
読み込みを行うバイト数。
- 返信 (reply)
-
成功時には以下を返します。
Ardcount\n
この後ろに、デバイスから読み取った rdcount バイト分のデータが続きます。
- Wcount\n
-
現在のデバイスにデータを書き込みます。 このコマンドの後ろに、count バイト分の入力データを続けます。
-
- 引数
-
-
- count
-
書き込みを行うバイト数。
- 返信 (reply)
-
成功時には Awrcount\n を返します。 ここで wrcount は、実際に書き込みを行ったバイト数です。
- Iopcode\ncount\n
-
指定されたパラメーターを用いて MTIOCOP ioctl(2) コマンドを実行します。
-
- 引数
-
-
- opcode
-
MTIOCOP オペレーションコード。
- count
-
mt_count
- 返信 (reply)
-
成功時には A0\n を返します。
- S\n
-
現在オープンしているデバイスのステータスを返します。 これは MTIOCGET ioctl(2) を呼び出して得ています。
-
- 引数
-
なし。
- 返信 (reply)
-
成功時は Acount\n と、その後に count バイト分のデータが続きます。
関連項目
tar(1)
バグ
このユーティリティーを汎用目的のリモートファイルアクセスツールとして利用することはお勧めしません。
バグ報告
バグ報告は <bug-tar@gnu.org> までお願いします。
開発経緯
rmt コマンドは 4.2BSD において登場しました。 GNU rmt は BSD の仕様に基づいて一から書き起こされました。
著作権
Copyright © 2013, 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later
<http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is
NO WARRANTY, to the extent permitted by law.
Index
- 名前
-
- 書式
-
- 説明
-
- コマンド
-
- 関連項目
-
- バグ
-
- バグ報告
-
- 開発経緯
-
- 著作権
-
This document was created by
man2html,
using the manual pages.
Time: 16:46:40 GMT, November 24, 2023