# gfimport_fixed

## Name

gfimport_fixed -- 固定長データをフラグメントに分けて取り込む

## Synopsis

gfimport_fixed [`オプション`] `入力ファイル`

## DESCRIPTION

引数に指定した固定長データからなるファイルを、フラグメントに分けて Gfarm ファイルシステムに取り込むサンプル・プログラムです。

## OPTIONS

`-H` `ホスト指定ファイル`

  フラグメントを配置するホスト名のリストを記載したファイル名を指定します。 ホスト名は、各行に一ホストずつ記述します。 -l オプションを省略した場合は、入力ファイルは、このオプションで 指定したホストに、等分割したフラグメントとして配置されます。

  ファイル名として ``-'' を指定した場合、標準入力からホスト名のリストを 読み込みます。

`-f` `フラグメント構成ファイル`

  各フラグメントのおおよそのサイズと、配置するホストを記載したファイ ル名を指定します。

  構成ファイルは、各行が、空白で区切られたサイズとホスト名からなる形式です。

  ファイル名として ``-'' を指定した場合、標準入力からフラグメント構成を 読み込みます。

`-l` `レコード長`

  固定長データのレコード長をバイト数で指定します。フラグメント分割は、 このレコード長の整数倍の位置でのみ、行われます。省略時のレコード長 は 1 バイトです。

`-o` `gfarm-URL`

  出力 Gfarm ファイルの URL を指定します。

`-?`

  引数オプションを表示します。

## EXAMPLES

Example 1. 指定した個数に分割して取り込む

以下は、ファイルを8個のフラグメントに分割し、 ファイル `gfarm:file` として取り込む例です。

    gfsched -N 8 | gfimport_fixed -H - -o gfarm:file source_file

Example 2. 処理するプログラムを指定し、特定の個数に分割して取り込む

以下は、ファイルを8個のフラグメントに分割し、 指定したプログラム `gfarm:prog` を実行可能なホストに、 ファイル `gfarm:file` として取り込む例です。

    gfsched -N 8 -p gfarm:prog | gfimport_fixed -H - -o gfarm:file source_file

Example 3. 既存の gfarm ファイルと同じ配置で取り込む

以下は、既存の gfarm ファイル `gfarm:template` と 同じ個数のフラグメントに分割し、 `gfarm:template` が存在するのと同じホストに、 ファイル `gfarm:file` として取り込む例です。

    gfsched gfarm:template | gfimport_fixed -H - -o gfarm:file source_file

## SEE ALSO

gfimport_text(1), gfsched(1), gfarm.conf(5)