guestfs-erlang(3) | Virtualization Support | guestfs-erlang(3) |
НАЗВА¶
guestfs-erlang — як користуватися libguestfs з програми мовою Erlang
КОРОТКИЙ ОПИС¶
{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).
ОПИС¶
На цій сторінці підручника наведено документацію щодо викликів libguestfs з коду мовою програмування Erlang. На сторінці задокументовано відмінності від програмного інтерфейсу C та подано декілька прикладів. Якщо ви не дуже знайомі із користуванням libguestfs, вам також слід прочитати підручник з guestfs(3).
ВІДКРИТТЯ І ЗАКРИТТЯ ДЕСКРИПТОРА¶
Прив'язки до Erlang реалізовано за допомогою зовнішньої програми із назвою "erl-guestfs". Ця програма має зберігатися у одному з каталогів PATH, інакше вам доведеться вказати повний шлях до програми:
{ok, G} = guestfs:create(). {ok, G} = guestfs:create("/шлях/до/erl-guestfs").
"G" є дескриптором libguestfs, який вам слід передавати іншим функціям.
Закриття обробника:
ok = guestfs:close(G).
ФУНКЦІЇ І НЕОБОВ'ЯЗКОВІ ПАРАМЕТРИ¶
Якщо функція приймає необов'язкові аргументи, першими слід вказувати обов'язкові. Останнім аргументом є список кортежів, яким надається список решти необов'язкових аргументів.
ok = guestfs:add_drive_opts(G, Disk, [{format, "raw"}, {readonly, true}]).
Якщо останнім аргументом має бути порожній список, ви також можете його пропустити:
ok = guestfs:add_drive_opts(G, Disk).
ЗНАЧЕННЯ, ЩО ПОВЕРТАЮТЬСЯ, І ПОМИЛКИ¶
Якщо дію виконано успішно, більшість функцій повертають значення "Result" (ним може бути список, рядок, кортеж тощо). Якщо у функції немає чого повернути, буде повернуто атом "ok".
Якщо станеться помилка, ви маєте побачити один із таких кортежів:
- "{помилка, повідомлення, номер_помилки}"
- Позначає
звичайну
помилку у
функції.
"Повідомлення" — повідомлення про помилку (рядок), а "номер_помилки" — номер помилки Unix (ціле число).
"Errno" може бути нульовим. Див. "guestfs_last_errno" in guestfs(3).
- "{unknown, Функція}"
- Це означає,
що
викликана
вами
функція є
невідомою.
Загалом,
таке
трапляється,
якщо ви
використовуєте
"erl-guestfs" з
іншої
версії libguestfs.
Не слід так
робити.
"Функція" — назва невідомої функції.
- "{unknownarg, Аргумент}"
- Це означає,
що ви
викликали
функцію із
необов'язковими
аргументами,
використавши
невідому
назву
аргументу.
"Аргумент" — назва невідомого аргументу.
ПРИКЛАД 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")
АВТОРСЬКІ ПРАВА¶
© Red Hat Inc., 2011–2012
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:
- The version of libguestfs.
- Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
- Describe the bug accurately and give a way to reproduce it.
- Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
2020-03-09 | libguestfs-1.42.0 |