НАЗВА

       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.