File: guestfsd.pod

package info (click to toggle)
libguestfs 1%3A1.44.0-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 118,932 kB
  • sloc: ansic: 458,017; ml: 51,424; sh: 13,191; java: 9,578; makefile: 7,931; cs: 6,328; haskell: 5,674; python: 3,871; perl: 3,528; erlang: 2,446; xml: 1,347; ruby: 350; pascal: 257; javascript: 157; lex: 135; yacc: 128; cpp: 10
file content (157 lines) | stat: -rw-r--r-- 6,587 bytes parent folder | download
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.