ВІДКРИТТЯ І ЗАКРИТТЯ ДЕСКРИПТОРА¶

Прив'язки до 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, Аргумент}"

Це означає, що ви викликали функцію із необов'язковими аргументами, використавши невідому назву аргументу.

"Аргумент" — назва невідомого аргументу.