Zen

Translation

English type: verbatim
total length (header + arguments,
but not including the length word itself,
and not including the chunks)
struct guestfs_message_header (encoded as XDR)
struct guestfs_<foo>_args (encoded as XDR)
sequence of chunks for FileIn param #0
sequence of chunks for FileIn param #1 etc.

319/2970 · 297

Sign in to save the translation.

English Ukrainian Actions
For ordinary functions, the request message is:
Повідомлення запиту для звичайних функцій:
total length (header + arguments,
but not including the length word itself)
struct guestfs_message_header (encoded as XDR)
struct guestfs_<foo>_args (encoded as XDR)
загальна довжина (заголовок + аргументи,
але без включення самого слова length)
struct guestfs_message_header (у кодуванні XDR)
struct guestfs_<щось>_args (у кодуванні XDR)
The total length field allows the daemon to allocate a fixed size buffer into which it slurps the rest of the message. As a result, the total length is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the effective size of any request is limited to somewhere under this size.
Поле загальної довжини надає змогу фоновій службі отримувати фіксований буфер у пам'яті, до якого вона записуватиме решту повідомлення. Отже, загальну довжину обмежено до C<GUESTFS_MESSAGE_MAX> байтів (у поточній версії, 4 МБ), що означає, що ефективний розмір будь-якого запису обмежено цим обсягом пам'яті.
Note also that many functions don’t take any arguments, in which case the C<guestfs_I<foo>_args> is completely omitted.
Зауважте, що багато функцій не приймають жодних аргументів. Для таких функцій C<guestfs_I<щось>_args> взагалі не вказують.
The header contains the procedure number (C<guestfs_proc>) which is how the receiver knows what type of args structure to expect, or none at all.
У заголовку міститься номер процедури (C<guestfs_proc>), за допомогою якого функція-отримувач визначає тип структури аргументів, який слід очікувати, або дізнається про те, що аргументів не буде.
For functions that take optional arguments, the optional arguments are encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary arguments. A bitmask in the header indicates which optional arguments are meaningful. The bitmask is also checked to see if it contains bits set which the daemon does not know about (eg. if more optional arguments were added in a later version of the library), and this causes the call to be rejected.
Для функцій, які приймають необов'язкові аргументи, додаткові аргументи кодуються у структуру C<guestfs_I<foo>_args> у той самий спосіб, що і звичайні аргументи. Бітова маска у заголовку позначає, які додаткові аргументи мають значення. Виконується також перевірка бітової маски на вміст бітів, про які не знає фонова служба (наприклад, якщо у новішій версії бібліотеки додано додаткові аргументи). Виклики із такими бітами відкидаються.
The reply message for ordinary functions is:
Повідомлення відповіді для звичайних функцій:
total length (header + ret,
but not including the length word itself)
struct guestfs_message_header (encoded as XDR)
struct guestfs_<foo>_ret (encoded as XDR)
загальна довжина (заголовок + повернуте значення,
але без включення самого слова length)
struct guestfs_message_header (у кодуванні XDR)
struct guestfs_<щось>_ret (у кодуванні XDR)
As above the C<guestfs_I<foo>_ret> structure may be completely omitted for functions that return no formal return values.
Як і вище, структуру C<guestfs_I<щось>_ret> може бути повністю пропущено, якщо функція формально не повертає значень.
As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>.
Як і вище, значення загальної довжини відповіді обмежується значенням C<GUESTFS_MESSAGE_MAX>.
In the case of an error, a flag is set in the header, and the reply message is slightly changed:
Якщо станеться помилка, у заголовку буде встановлено прапорець, а саме повідомлення відповіді буде дещо змінено:
total length (header + error,
but not including the length word itself)
struct guestfs_message_header (encoded as XDR)
struct guestfs_message_error (encoded as XDR)
загальна довжина (заголовок + помилка,
але без включення самого слова length)
struct guestfs_message_header (у кодуванні XDR)
struct guestfs_<щось>_message_error (у кодуванні XDR)
The C<guestfs_message_error> structure contains the error message as a string.
Структура C<guestfs_message_error> містить повідомлення про помилку у форматі рядка.
FUNCTIONS THAT HAVE FILEIN PARAMETERS
ФУНКЦІЇ З ПАРАМЕТРАМИ FILEIN
A C<FileIn> parameter indicates that we transfer a file I<into> the guest. The normal request message is sent (see above). However this is followed by a sequence of file chunks.
Параметр C<FileIn> позначає, що ми передаємо файл I<до> гостьової системи. Надсилається звичайне повідомлення запиту (див. вище). Втім, за ним слідує послідовність фрагментів файла.
total length (header + arguments,
but not including the length word itself,
and not including the chunks)
struct guestfs_message_header (encoded as XDR)
struct guestfs_<foo>_args (encoded as XDR)
sequence of chunks for FileIn param #0
sequence of chunks for FileIn param #1 etc.
загальна довжина (заголовок + аргументи,
але без включення самого слова length,
і без включення фрагментів)
struct guestfs_message_header (у кодуванні XDR)
struct guestfs_<щось>_args (у кодуванні XDR)
послідовність фрагментів для параметра 0 FileIn
послідовність фрагментів для параметра 1 FileIn тощо
The "sequence of chunks" is:
«Послідовність фрагментів» це:
length of chunk (not including length word itself)
struct guestfs_chunk (encoded as XDR)
length of chunk
struct guestfs_chunk (encoded as XDR)
...
length of chunk
struct guestfs_chunk (with data.data_len == 0)
довжина фрагмента (без самого слова length)
struct guestfs_chunk (у кодуванні XDR)
довжина фрагмента
struct guestfs_chunk (у кодуванні XDR)
...
довжина фрагмента
struct guestfs_chunk (із data.data_len == 0)
The final chunk has the C<data_len> field set to zero. Additionally a flag is set in the final chunk to indicate either successful completion or early cancellation.
Значення C<data_len> останнього фрагмента дорівнює нулю. Крім того, у останньому фрагментів встановлено прапорець, який позначає успішне завершення або передчасне переривання.
At time of writing there are no functions that have more than one FileIn parameter. However this is (theoretically) supported, by sending the sequence of chunks for each FileIn parameter one after another (from left to right).
На момент написання цього підручника не існувало жодної функції, яка б приймала більше одного параметра FileIn. Втім, теоретично, підтримку багатьох таких параметрів передбачено. Адже передбачено можливість надсилати послідовність фрагментів для кожного параметра FileIn один фрагмент за одним (зліва праворуч).
Both the library (sender) I<and> the daemon (receiver) may cancel the transfer. The library does this by sending a chunk with a special flag set to indicate cancellation. When the daemon sees this, it cancels the whole RPC, does I<not> send any reply, and goes back to reading the next request.
Передавання даних може бути скасовано як бібліотекою (відправником), I<так і> фоновою службою (отримувачем). Бібліотека скасовує передавання надсиланням фрагмента із спеціальним прапорцем, який позначає скасовування. Коли фонова служба отримує такий фрагмент, вона скасовує увесь RPC, I<не> надсилає жодної відповіді і повертається до читання наступного запиту.
The daemon may also cancel. It does this by writing a special word C<GUESTFS_CANCEL_FLAG> to the socket. The library listens for this during the transfer, and if it gets it, it will cancel the transfer (it sends a cancel chunk). The special word is chosen so that even if cancellation happens right at the end of the transfer (after the library has finished writing and has started listening for the reply), the "spurious" cancel flag will not be confused with the reply message.
Фонова служба також може скасувати передавання даних. Зробити це вона можна записуванням до сокета спеціального слова C<GUESTFS_CANCEL_FLAG>. Бібліотека очікує на цьому сокеті на дані під час передавання. Якщо буде отримано спеціальне слово, бібліотека скасує передавання (надішле фрагмент скасовування). Спеціальне слово вибрано так, щоб навіть якщо скасовування станеться безпосередньо наприкінці передавання (після того, як бібліотека завершить запис і розпочне очікувати на відповідь), «неоднозначний» прапорець скасовування не буде переплутано із повідомленням відповіді.
This protocol allows the transfer of arbitrary sized files (no 32 bit limit), and also files where the size is not known in advance (eg. from pipes or sockets). However the chunks are rather small (C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need to keep much in memory.
Цей протокол уможливлює передавання файлів довільного розміру (без обмеження у 32 біти), а також файлів, розмір яких невідомий наперед (наприклад з каналів обробки даних або сокетів). Втім, фрагменти є доволі малими (C<GUESTFS_MAX_CHUNK_SIZE>), отже, ні бібліотеці, ні фоновій службі не потрібно для передавання багато оперативної пам'яті.
FUNCTIONS THAT HAVE FILEOUT PARAMETERS
FФУНКЦІЇ З ПАРАМЕТРАМИ FILEOUT
The protocol for FileOut parameters is exactly the same as for FileIn parameters, but with the roles of daemon and library reversed.
Протокол для параметрів FileOut є тим самим, що і для параметрів FileIn, але у ньому фонова служба і бібліотека міняються місцями.
total length (header + ret,
but not including the length word itself,
and not including the chunks)
struct guestfs_message_header (encoded as XDR)
struct guestfs_<foo>_ret (encoded as XDR)
sequence of chunks for FileOut param #0
sequence of chunks for FileOut param #1 etc.
загальна довжина (заголовок + повернуте значення,
але без включення самого слова length,
і без включення фрагментів)
struct guestfs_message_header (у кодуванні XDR)
struct guestfs_<щось>_ret (у кодуванні XDR)
послідовність фрагментів для параметра 0 FileOut
послідовність фрагментів для параметра 1 FileOut тощо
INITIAL MESSAGE
ПОЧАТКОВЕ ПОВІДОМЛЕННЯ
When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) which indicates that the guest and daemon is alive. This is what L<guestfs(3)/guestfs_launch> waits for.
Під час запуску фонова служба надсилає початкове слово (C<GUESTFS_LAUNCH_FLAG>), яке означає, що гостьова система і фонова служба працюють. Саме на це очікує L<guestfs(3)/guestfs_launch>.
PROGRESS NOTIFICATION MESSAGES
ПОВІДОМЛЕННЯ ЩОДО ПОСТУПУ
The daemon may send progress notification messages at any time. These are distinguished by the normal length word being replaced by C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message.
Фонова служба може будь-коли надсилати сповіщення щодо поступу. Ці сповіщення відрізняються від інших тим, що звичайне слово length замінюється на C<GUESTFS_PROGRESS_FLAG>, а за ним слідує повідомлення щодо поступу фіксованого розміру.
The library turns them into progress callbacks (see L<guestfs(3)/GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them if not.
Бібліотека перетворює їх на зворотні виклики щодо поступу (див. L<guestfs(3)/GUESTFS_EVENT_PROGRESS>), якщо зареєстровано зворотний виклик; або відкидає їх, якщо виклик не зареєстровано.

Loading…

No matching activity found.
Browse all string changes

Things to check

Mismatching line breaks

Number of new lines in translation does not match source

Reset

Glossary

English Ukrainian
No related strings found in the glossary.

String information

Source string description
type: verbatim
Flags
no-wrap
Source string location
../docs/guestfs-internals.pod:282
String age
3 years ago
Last updated
a year ago
Source string age
3 years ago
Translation file
po-docs/uk.po, string 2715