# gfarm_hostlist_read

## Name

gfarm_hostlist_read -- ホスト構成ファイルを読み込む

## Synopsis

    #include <gfarm/gfarm.h>

```char *gfarm_hostlist_read``(char *`filename`, int *`np`, char ***`line_table_p`, int *`error_line_p`);`

## DESCRIPTION

Gfarmファイルをインポートするアプリケーション用の補助関数の一つです。

ホスト構成ファイル名を `filename` に指定すると、そのファイルから、 ホストの配列を `line_table_p` の指す先にに返します。 構成ファイルに構文エラーが生じた場合には、 `error_line_p` の指す先に、ファイルの行番号を返します。この値が -1 の場合には、構文以外のエラー原因です。

ここで得たホストの配列は gfarm_strings_free_deeply() を用いて解放 する必要があります。

## RETURN VALUES

`NULL`

  正常終了を示します。

`GFARM_ERR_NO_MEMORY`

  メモリ不足のため処理を中止しました。

その他

  上記以外のエラーが生じたことを示します。

## SEE ALSO

gfarm_import_fragment_config_read(3), gfarm_import_fragment_size_alloc(3)