# gfarm_import_fragment_size_alloc

## Name

gfarm_import_fragment_size_alloc -- フラグメントサイズの配列を割り当てる

## Synopsis

    #include <gfarm/gfarm.h>

```file_offset_t *gfarm_import_fragment_size_alloc``(file_offset_t `total_size`, int `n`);`

## DESCRIPTION

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

インポート処理には、ファイルを、どれくらいのサイズのフラグメントに 分割するかという情報が必要です。元ファイルのサイズを引数 `total_size` に、フラグメント数を引数 `n` に与えると、この関数は結果として、各フラグメントの分割サイズの目安を、 要素数 `n` の配列として返します。

この関数と gfarm_hostlist_read(3) 関数の結果を組み合わせることによって、 gfarm_import_fragment_config_read(3) 関数が返すフラグメント分割情報 と同じ形式の情報を得ることができます。

この関数で得た配列は free(3) を用いて解放する必要があります。

## RETURN VALUES

`NULL`

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

その他

  処理に成功した場合、 file_offset_t 型の配列の先頭要素へのポインタを返します。

## SEE ALSO

gfarm_hostlist_read(3), gfarm_import_fragment_config_read(3)