Manpages

名 前

guestfs-erlang - Erlang か ら libguestfs を 使 用 す る 方 法

書 式

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

説 明

This manual page documents how to call libguestfs from the Erlang programming language. This page just documents the differences from the C API and gives some examples. If you are not familiar with using libguestfs, you also need to read guestfs(3). ハ ン ド ル の オ ー プ ン 方 法 お よ び ク ロ ー ズ 方 法
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" は 未 知 の 引 数 の 名 前 で す 。

例 1: デ ィ ス ク イ メ ー ジ の 作 成

@EXAMPLE1@

例 2: 仮 想 マ シ ン の デ ィ ス ク イ メ ー ジ の 検 査

@EXAMPLE2@

関 連 項 目

guestfs(3), guestfs-examples(3), guestfs-gobject(3), guestfs-golang(3), guestfs-java(3), guestfs-lua(3), guestfs-ocaml(3), guestfs-perl(3), guestfs-python(3), guestfs-recipes(1), guestfs-ruby(3), http://www.erlang.org/. http://libguestfs.org/.

著 者

Richard W.M. Jones ("rjones at redhat dot com")

COPYRIGHT

Copyright (C) 2011-2012 Red Hat Inc.

LICENSE

BUGS

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply: