НАЗВА

guestfs-golang — як використовувати libguestfs з Go

КОРОТКИЙ ОПИС

 import "libguestfs.org/guestfs"
 
 g, errno := guestfs.Create ()
 if errno != nil {
     panic (fmt.Sprintf ("could not create handle: %s", errno))
 }
 defer g.Close ()
 if err := g.Add_drive ("test.img"); err != nil {
     panic (err)
 }
 if err := g.Launch (); err != nil {
     panic (err)
 }
 if err := g.Shutdown (); err != nil {
     panic (err)
 }

ОПИС

На цій сторінці підручника наведено документацію щодо викликів libguestfs з коду мовою програмування Go. На сторінці задокументовано відмінності від програмного інтерфейсу C та подано декілька прикладів. Якщо ви не дуже знайомі із користуванням libguestfs, вам також слід прочитати підручник з guestfs(3).

ІМПОРТУВАННЯ МОДУЛЯ

Модуль називається "guestfs". Повна назва пакунка для імпортування — "libguestfs.org/guestfs".

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

Скористайтеся "guestfs.Create" або "guestfs.Create_flags" для створення дескриптора. Дескриптор буде закрито неявним чином під час збирання сміття. Втім, ймовірно, непогано було б закривати його явним чином шляхом виклику "g.Close ()" або відклавши ту саму команду.

ПОМИЛКИ

"guestfs.Create" і "guestfs.Create_flags" повертають простий *error, який насправді є простим "errno" з C, загорнутим у відповідну структуру golang.
Усі інші виклики повертають *GuestfsError, яка є (якщо вона непорожня) ширшою структурою, яка містить рядок помилки від libguestfs, номер помилки (якщо доступний) та дані щодо дії, яка призвела до помилки. Ці дані також можна перетворити на рядок для показу.

ОБМЕЖЕННЯ

•
Немає підтримки подій (див. "ПОДІЇ" in guestfs(3)).
•
UUID не повертаються у структурах.

ПРИКЛАД 1. СТВОРЕННЯ ОБРАЗУ ДИСКА

@EXAMPLE1@

ПРИКЛАД 2. ПЕРЕВІРКА ОБРАЗУ ДИСКА ВІРТУАЛЬНОЇ МАШИНИ

@EXAMPLE2@

ТАКОЖ ПЕРЕГЛЯНЬТЕ

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

АВТОРИ

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

АВТОРСЬКІ ПРАВА

© Red Hat Inc., 2013

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.