# gfimport_text

## Name

gfimport_text -- テキスト・ファイルをフラグメントに分けて取り込む

## Synopsis

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

## DESCRIPTION

引数に指定したテキスト・ファイルを、一行を複数のフラグメントに分割す ることのないように分割して Gfarm ファイルシステムに取り込む サンプル・プログラムです。

## OPTIONS

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

  フラグメントを配置するホスト名のリストを記載したファイル名を指定します。 ホスト名は、各行に一ホストずつ記述します。 入力ファイルはそれぞれのフラグメントサイズがほぼ均等となるように 分割されます。

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

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

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

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

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

`-o` `gfarm-URL`

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

`-?`

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

## EXAMPLES

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

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

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

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

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

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

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

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

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

## SEE ALSO

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