ハンドルのオープン方法およびクローズ方法¶

The Erlang bindings are implemented using an external program called "erl-guestfs". This program must be on the current PATH, or else you should specify the full path to the program:

 {ok, G} = guestfs:create().
 {ok, G} = guestfs:create("/path/to/erl-guestfs").

"G" は他の関数に渡す libguestfs ハンドルです。

ハンドルを閉じるには:

 ok = guestfs:close(G).

オプション引数を用いた機能¶

For functions that take optional arguments, the first arguments are the non-optional ones. The last argument is a list of tuples supplying the remaining optional arguments.

 ok = guestfs:add_drive_opts(G, Disk,
                             [{format, "raw"}, {readonly, true}]).

最後の引数が空の一覧ならば、それを省略できます:

 ok = guestfs:add_drive_opts(G, Disk).

返り値およびエラー¶

On success, most functions return a "Result" term (which could be a list, string, tuple etc.). If there is nothing for the function to return, then the atom "ok" is returned.

エラーが発生すると、以下の組のどれかが表示されます:

"{error, Msg, Errno}"

これは関数からの通常のエラーを意味します。

"Msg" はエラーメッセージ（文字列）です。"Errno" は Unix エラー（整数）です。

"Errno" は 0 の可能性があります。 "guestfs_last_errno" in guestfs(3) 参照。

"{unknown, Function}"

This indicates that the function you called is not known. Generally this means you are mixing "erl-guestfs" from another version of libguestfs, which you should not do.

"Function" は未知の関数の名前です。

"{unknownarg, Arg}"

This indicates that you called a function with optional arguments, with an unknown argument name.

"Arg" は未知の引数の名前です。