xmodemrecv
2021/05/15 17:38
xmodemrecv 機能
[通信コマンド]XMODEM プロトコルでファイルを受信します。
コマンドライン
xmodemrecv <file name> <binary flag> <option>
機能説明
<file name>
XMODEM プロトコルでファイル <file name> を受信します。受信が終わるまで次のコマンドは実行されません。
<binary flag>
ファイルがバイナリファイルの場合は、<binary flag> は 0 以外でなければなりません。テキストファイルの場合は、<binary flag> は 0 でなければなりません。
<binary flag> | タイプ |
---|---|
0 | テキストファイル |
1 | バイナリファイル |
<option>
<option> によって、XMODEM のオプション(エラー検出の種類)を指定します。パケットサイズ (1K) は送信側でのみ指定できます。(バージョン 4.90 以降)
<option> | バージョン 4.89 以前 | バージョン 4.90 以降 |
---|---|---|
1 | Checksum | Checksum |
2 | CRC | CRC |
3 | 1K | CRC |
それ以外 | Checksum | Checksum |
パラメータの説明
指定するパラメータは以下の通りです。パラメータ | 型 | パラメータ説明 |
---|---|---|
<file name> | 文字列 | 受信するファイル名を指定します。 |
<binary flag> | 整数 | ファイルタイプ(バイナリかテキストか)を指定します。 |
<option> | 整数 | XMODEM のオプション(エラー検出の種類)を指定します。 |
対象バージョン
一部機能は、全てのバージョンで利用可能です。バージョン 4.90 より変更された機能があります。
戻り値
戻り値として以下の変数が定義されます。変数名 | 値 | 意味 |
---|---|---|
result | 0 | ファイルが正しく転送されなかった |
1 | ファイルが正しく転送された |
関連コマンド
種別:通信 | Ver | 機能の簡易説明 |
---|---|---|
0106 | XMODEM プロトコルでファイルを送信する。 | |
4.90以降 | エラー検出の種類(Checksum/CRC)指定の仕様変更。 |
使用方法
使用例
・XMODEM プロトコルでテキストファイル 'readme.txt' を受信し、CRC でエラー検出する場合; XMODEM receive, text file, CRC xmodemrecv 'readme.txt' 0 2