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
|
=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-2023 Red Hat Inc.
|
