1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157
|
=head1 НАЗВА
guestfsd — фонова служба guestfs
=head1 КОРОТКИЙ ОПИС
guestfsd [-r] [-v|--verbose]
=head1 ОПИС
C<guestfsd> є фоновою службою libguestfs. У звичайних користувачів ніколи не
виникатиме потреби у явному запуску цієї програми. На цій сторінці
підручника обговорено, що саме C<guestfsd> робить у базовій системі
libguestfs і коли libguestfs використовується «наживо».
=head2 БАЗОВА СИСТЕМА LIBGUESTFS
Архітектуру базової системи libguestfs описано у розділі
L<guestfs(3)/АРХІТЕКТУРА>.
Після завантаження базової системи скрипт F</init> у базовій системі
запускає C<guestfsd> без аргументів. C<guestfsd> відкриває послідовний порт
virtio за відомим шляхом (див. L</ФАЙЛИ>). Він ініціює протокол
(див. L<guestfs(3)/ПРОТОКОЛ ОБМІНУ ДАНИМИ>) і обробляє запити один за одним
з бібліотеки, аж доки базову систему не буде знищено.
Файлові системи монтуються до каталогу F</sysroot>, а усі дії із файловими
системами здійснюються відносно цього каталогу.
=head2 LIBGUESTFS LIVE
У випадку libguestfs, C<guestfsd -r> запускається зі скриптів rc, systemd
тощо.
Параметр C<-r> наказує фоновій службі працювати з кореневою файловою
системою, а не з F</sysroot>.
У поточній версії (через обмеження у virtio-serial) одночасно із фоновою
службою може бути з'єднано лише один клієнт, а після від'єднання кожного з
клієнтів C<guestfsd> має бути перезапущено. Якщо libguestfs live буде
перемкнуто на використання іншого каналу передавання даних, зокрема TCP/IP,
це обмеження буде знято.
=head1 ПАРАМЕТРИ
=over 4
=item B<-?>
=item B<--help>
Показати коротку довідку.
=item B<-c> КАНАЛ
=item B<--channel> КАНАЛ
=item B<--channel> дф:N
Передати назву послідовного каналу virtio, послідовного порту тощо, яким
guestfsd обмінюватиметься даними із бібліотекою. Якщо цей параметр не
вказано, буде використано внутрішній типовий порт.
Формат C<дф:N> спричиняє використання у guestfsd дескриптора файла C<N>
безпосередньо.
=item B<-l>
=item B<--listen>
Замість відкриття C<guestfs_channel> і, таким чином, сподівання на його
існування, створити канал як сокет домену Unix, очікувати на дані на ньому і
прийняти одинарне з'єднання. В основному, це використовується для тестування
фонової служби.
=item B<-n>
=item B<--network>
Увімкнути мережеві можливості у фоновій службі.
=item B<-r>
Встановити кореневу файлову систему F</> (замість типової, якою є
F</sysroot>). Крім того, не демонтувати файлові системи, якщо існує фонова
служба.
Цей параметр використовується для вмикання libguestfs live.
=item B<-v>
=item B<--verbose>
Увімкнути докладний показ повідомлень з метою діагностики.
Прапорець докладних повідомлень також встановлюється, якщо у командному
рядку Linux міститься підрядок C<guestfs_verbose=1>.
=back
=head1 СТАН ВИХОДУ
Ця програма повертає значення 0 у разі успішного завершення і ненульове
значення, якщо сталася помилка.
=head1 ФАЙЛИ
=over 4
=item F</dev/virtio-ports/org.libguestfs.channel.0>
Послідовний порт virtio, з яким встановлює з’єднання C<guestfsd>.
=item F</proc/cmdline>
Командний рядок Linux буде оброблено з метою виявлення прапорців
C<guestfs_*>. Розпізнаються такі прапорці:
=over 4
=item B<guestfs_verbose=1>
Увімкнути докладні повідомлення. Цей прапорець передається бібліотекою
libguestfs до базової системи з метою зробити повідомлення фонової служби
докладнішими (працює як прапорець I<-v> у командному рядку). Незалежно від
самої фонової служби, спричиняє виведення скриптом ініціалізації базової
системи набагато ширшого обсягу інформації.
=item B<guestfs_channel=ШЛЯХ>
Встановити якийсь нетиповий шлях до послідовного каналу virtio (типовим є
шлях F</dev/virtio-ports/org.libguestfs.channel.0>). Використовується
модулем режиму користувача Linux для використання звичайного емульованого
послідовного порту замість послідовного порту virtio.
=item B<guestfs_network=1>
Встановлюється, якщо увімкнено мережу у базовій системі
(див. C<guestfs_set_network>).
=back
=back
=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ
L<guestfs(3)>, L<http://libguestfs.org/>.
=head1 АВТОР
Richard W.M. Jones L<http://people.redhat.com/~rjones/>
=head1 АВТОРСЬКІ ПРАВА
Copyright (C) 2009-2020 Red Hat Inc.
|