guestfsd(8)

НАЗВА
guestfsd — фонова служба guestfs

КОРОТКИЙ ОПИС
 guestfsd [-r] [-v|--verbose]

ОПИС
"guestfsd" є фоновою службою libguestfs. У звичайних користувачів ніколи не виникатиме потреби у явному запуску цієї програми. На цій сторінці підручника обговорено, що саме "guestfsd" робить у базовій системі libguestfs і коли libguestfs використовується «наживо».

  БАЗОВА СИСТЕМА LIBGUESTFS
Архітектуру базової системи libguestfs описано у розділі "АРХІТЕКТУРА" in guestfs(3).

Після завантаження базової системи скрипт /init у базовій системі запускає "guestfsd" без аргументів. "guestfsd" відкриває послідовний порт virtio за відомим шляхом (див. "ФАЙЛИ"). Він ініціює протокол (див. "ПРОТОКОЛ ОБМІНУ ДАНИМИ" in guestfs(3)) і обробляє запити один за одним з бібліотеки, аж доки базову систему не буде знищено.

Файлові системи монтуються до каталогу /sysroot, а усі дії із файловими системами здійснюються відносно цього каталогу.

  LIBGUESTFS LIVE
У випадку libguestfs, "guestfsd -r" запускається зі скриптів rc, systemd тощо.

Параметр "-r" наказує фоновій службі працювати з кореневою файловою системою, а не з /sysroot.

У поточній версії (через обмеження у virtio-serial) одночасно із фоновою службою може бути з'єднано лише один клієнт, а після від'єднання кожного з клієнтів "guestfsd" має бути перезапущено. Якщо libguestfs live буде перемкнуто на використання іншого каналу передавання даних, зокрема TCP/IP, це обмеження буде знято.

ПАРАМЕТРИ

-?
--help
    Показати коротку довідку.

-c КАНАЛ
--channel КАНАЛ
--channel дф:N
    Передати назву послідовного каналу virtio, послідовного порту тощо, яким guestfsd обмінюватиметься даними із бібліотекою. Якщо цей параметр не вказано, буде використано внутрішній типовий порт.

    Формат "дф:N" спричиняє використання у guestfsd дескриптора файла "N" безпосередньо.

-l
--listen
    Замість відкриття "guestfs_channel" і, таким чином, сподівання на його існування, створити канал як сокет домену Unix, очікувати на дані на ньому і прийняти одинарне з'єднання. В основному, це використовується для тестування фонової служби.

-n
--network
    Увімкнути мережеві можливості у фоновій службі.

-r  Встановити кореневу файлову систему / (замість типової, якою є /sysroot). Крім того, не демонтувати файлові системи, якщо існує фонова служба.

    Цей параметр використовується для вмикання libguestfs live.

-v
--verbose
    Увімкнути докладний показ повідомлень з метою діагностики.

    Прапорець докладних повідомлень також встановлюється, якщо у командному рядку Linux міститься підрядок "guestfs_verbose=1".

СТАН ВИХОДУ
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.

ФАЙЛИ

/dev/virtio-ports/org.libguestfs.channel.0
    Послідовний порт virtio, з яким встановлює з’єднання "guestfsd".

/proc/cmdline
    Командний рядок Linux буде оброблено з метою виявлення прапорців "guestfs_*". Розпізнаються такі прапорці:

    guestfs_verbose=1
        Увімкнути докладні повідомлення. Цей прапорець передається бібліотекою libguestfs до базової системи з метою зробити повідомлення фонової служби докладнішими (працює як прапорець -v у командному рядку). Незалежно від самої фонової служби, спричиняє виведення скриптом ініціалізації базової системи набагато ширшого обсягу інформації.

    guestfs_channel=ШЛЯХ
        Встановити якийсь нетиповий шлях до послідовного каналу virtio (типовим є шлях /dev/virtio-ports/org.libguestfs.channel.0). Використовується модулем режиму користувача Linux для використання звичайного емульованого послідовного порту замість послідовного порту virtio.

    guestfs_network=1
        Встановлюється, якщо увімкнено мережу у базовій системі (див. "guestfs_set_network").

ТАКОЖ ПЕРЕГЛЯНЬТЕ
guestfs(3), http://libguestfs.org/.

АВТОР
Richard W.M. Jones http://people.redhat.com/~rjones/

АВТОРСЬКІ ПРАВА
Copyright (C) 2009-2025 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:

•   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.