guestfish - Интернет в облаке

ПРОГРАММА:

ИМЯ

guestfish - оболочка гостевой файловой системы

СИНТАКСИС

guestfish [--options] [команды]

рыба-гость

guestfish [--ro | --rw] -a disk.img

guestfish [--ro | --rw] -a disk.img -m dev [: точка монтирования]

guestfish -d libvirt-домен

guestfish [--ro | --rw] -a disk.img -i

guestfish -d libvirt-домен -i

ПРЕДУПРЕЖДЕНИЕ

Использование "guestfish" в режиме записи на живых виртуальных машинах или одновременно с другим диском
инструменты редактирования, могут быть опасными, потенциально вызывая повреждение диска. Виртуальная машина
необходимо выключить перед использованием этой команды, а образы дисков не должны редактироваться
одновременно.

Использовать --ро (только для чтения) возможность безопасного использования "guestfish", если образ диска или виртуальный
машина может быть живая. Вы можете увидеть странные или противоречивые результаты при запуске
одновременно с другими изменениями, но с этой опцией вы не рискуете повредить диск.

ОПИСАНИЕ

Guestfish - это оболочка и инструмент командной строки для изучения и изменения виртуальной машины.
файловые системы. Он использует libguestfs и предоставляет все функции API guestfs,
посмотреть гость(3).

Guestfish предоставляет вам структурированный доступ к API libguestfs из сценариев оболочки или
в командной строке или в интерактивном режиме. Если вы хотите спасти сломанный образ виртуальной машины, вы
следует посмотреть на спасение вирт(1) команда.

ПРИМЕРЫ

As an интерактивный оболочка
$ гостевая рыба

Добро пожаловать в guestfish, оболочку гостевой файловой системы для
редактирование файловых систем виртуальных машин.

Введите: 'help' для получения списка команд.
"человек", чтобы прочитать руководство
'quit', чтобы выйти из оболочки

> надстройка disk.img
> запустить
> список файловых систем
/ dev / sda1: ext4
/ dev / vg_guest / lv_root: ext4
/ dev / vg_guest / lv_swap: своп
> смонтировать / dev / vg_guest / lv_root /
> Кот / И т.д. / Fstab
# / И т.д. / Fstab
# Создано anaconda
[...]
> выход

от оболочка скрипты
Создать новый / etc / motd файл в гостевом образе или образе диска:

guestfish << _ EOF_
добавить disk.img
пробег
смонтировать / dev / vg_guest / lv_root /
напишите / etc / motd "Добро пожаловать, новые пользователи"
_EOF_

Перечислите логические тома LVM в образе диска:

guestfish -a disk.img --ro << _ EOF_
пробег
LVS
_EOF_

Перечислите все файловые системы в образе диска:

guestfish -a disk.img --ro << _ EOF_
пробег
список файловых систем
_EOF_

On one команду линия
Обновление ПО / Etc / resolv.conf в гостях:

гость \
добавить disk.img: запустить: mount / dev / vg_guest / lv_root /: \
записывать / Etc / resolv.conf "сервер имен 1.2.3.4"

Редактировать /boot/жратва/жратва.конф интерактивно:

guestfish --rw --добавить disk.img \
--mount / dev / vg_guest / lv_root \
--mount / dev / sda1:/ загрузки \
отредактируйте /boot/grub/grub.conf

гора диски автоматически
Использовать -i возможность автоматического монтирования дисков с виртуальной машины:

Guestfish --ro -a disk.img -i кот / etc / group

Guestfish --ro -d libvirt-domain -i кот / etc / group

Другой способ редактирования /boot/жратва/жратва.конф интерактивно это:

guestfish --rw -a disk.img -i редактировать /boot/grub/grub.conf

As a скрипт переводчик
Создайте диск размером 100 МБ, содержащий раздел в формате ext2:

#! / usr / bin / guestfish -f
разреженный test1.img 100M
пробег
часть-диск / dev / sda mbr
mkfs ext2 / dev / sda1

Start a подготовленный диск
Альтернативный способ создания диска емкостью 100 Мбайт называется test1.img содержащий один
Раздел в формате ext2:

гость-рыба -N fs

Чтобы перечислить, что доступно, сделайте:

guestfish -N help | меньше

Удаленный диски
Доступ к удаленному диску с помощью ssh:

guestfish -a ssh: //example.com/path/to/disk.img

Удаленный контроль
eval "` guestfish --listen` "
Guestfish --remote add-ro disk.img
guestfish - удаленный запуск
guestfish - удаленные уровни

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

--Помогите
Отображает общую справку по параметрам.

-h
--cmd-помощь
Перечисляет все доступные команды guestfish.

-h CMD
--cmd-помощь CMD
Отображает подробную справку по одной команде «cmd».

-a изображение
--Добавить изображение
Добавьте в оболочку блочное устройство или образ виртуальной машины.

Формат образа диска определяется автоматически. Чтобы преодолеть это и заставить
конкретный формат использовать --format = .. опцию.

Использование этого флага в основном эквивалентно использованию команды «добавить» с «readonly: true».
если --ро был задан флаг, и с "форматом: ...", если --format = ... был дан флаг.

-a URI
--Добавить URI
Добавьте удаленный диск. См. «ДОБАВЛЕНИЕ УДАЛЕННОГО ХРАНИЛИЩА».

-c URI
--соединять URI
При использовании вместе с -d Опция указывает используемый URI libvirt.
По умолчанию используется соединение libvirt по умолчанию.

--csh
При использовании --Слушать вариант и оболочку, подобную csh, используйте эту опцию. См. Раздел
«ПУЛЬТ ДИСТАНЦИОННОГО УПРАВЛЕНИЯ И CSH» ниже.

-d libvirt-домен
--домен libvirt-домен
Добавьте диски из указанного домена libvirt. Если --ро вариант тоже используется, то любой
Можно использовать домен libvirt. Однако в режиме записи только домены libvirt, которые
здесь можно назвать выключение.

Вместо имен можно использовать UUID домена.

Использование этого флага в основном эквивалентно использованию команды "add-domain" с
"readonly: true", если --ро был задан флаг, и с "форматом: ...", если --format = ...
был дан флаг.

- эхо-клавиши
При запросе ключей и парольных фраз guestfish обычно отключает эхо, чтобы вы
не видит, что вы набираете. Если вас не беспокоят атаки Бури и
в комнате больше никого нет, вы можете установить этот флаг, чтобы видеть, что вы набираете.

-f файл
--файл файл
Прочтите команды из «файла». Чтобы написать чистые скрипты guestfish, используйте:

#! / usr / bin / guestfish -f

--format = raw | qcow2 | ..
--формат
По умолчанию для -a опция - автоматическое определение формата образа диска. С использованием
это заставляет формат диска для -a параметры, которые следуют в командной строке. С использованием
--формат без аргумента переключается обратно на автоопределение для последующего -a настройки.

Например:

guestfish --format = raw -a disk.img

форсирует необработанный формат (без автоопределения) для диск.img.

guestfish --format = raw -a disk.img --format -a another.img

форсирует необработанный формат (без автоопределения) для диск.img и возвращается к автоопределению для
другой.имг.

Если у вас есть ненадежные образы гостевых дисков в необработанном формате, вы должны использовать эту опцию, чтобы
укажите формат диска. Это позволяет избежать возможных проблем безопасности с вредоносными
гости (CVE-2010-3851). См. Также «добавить».

-i
--инспектор
. вирт-инспектор(1) код, проверьте диски в поисках операционной системы и
монтировать файловые системы так, как если бы они были смонтированы на реальной виртуальной машине.

Типичное использование:

гость -d мой гость -i

(для неактивного домена libvirt с именем мой гость), или:

гость-рыба --ro -d мой гость -я

(для активных доменов только для чтения) или напрямую укажите блочное устройство:

guestfish --rw -a / dev / Гости / MyGuest -i

Обратите внимание, что синтаксис командной строки немного изменился по сравнению с более старыми версиями guestfish.
Вы все еще можете использовать старый синтаксис:

Guestfish [--ro] -i disk.img

guestfish [--ro] -i libvirt-домен

Использование этого флага в основном эквивалентно использованию команды "inspect-os" с последующим использованием
другие команды для монтирования найденных файловых систем.

--keys-из-stdin
Считайте параметры ключа или ключевой фразы из стандартного ввода. По умолчанию попытаться прочитать
парольные фразы от пользователя, открыв / dev / tty.

--Слушать
Погрузитесь в фоновый режим и прислушайтесь к удаленным командам. См. Раздел «ПУЛЬТ ДИСТАНЦИОННОГО УПРАВЛЕНИЯ.
ГОСТЬ НА РОЗЕТКЕ "ниже.

--жить
Подключитесь к живой виртуальной машине. (Экспериментальный, см. «ПРИКЛЮЧЕНИЕ К РАБОЧИМ ДЕЙМОНАМ»
in гость(3 г.)).

-m dev [: точка монтирования [: параметры [: fstype]]]
--устанавливать dev [: точка монтирования [: параметры [: fstype]]]
Смонтируйте именованный раздел или логический том в заданной точке монтирования.

Если точка монтирования опущена, по умолчанию используется /.

Вы должны что-то смонтировать / прежде, чем большинство команд будут работать.

Если -m or --устанавливать Приведены варианты, гость запускается автоматически.

Если вы не знаете, какие файловые системы содержит образ диска, вы можете запустить guestfish
без этой опции, затем перечислите доступные разделы, файловые системы и LV (см.
"list-partitions", "list-filesystems" и "lvs" команды), или вы можете использовать
виртуальные файловые системы(1) программа.

Третья (и редко используемая) часть параметра монтирования - это список параметров монтирования.
используется для монтирования базовой файловой системы. Если это не указано, то параметры монтирования
либо пустая строка, либо "ro" (последнее, если --ро используется флаг). К
указав параметры монтирования, вы отменяете этот выбор по умолчанию. Наверное, единственный
раз вы использовали бы это, чтобы включить ACL и / или расширенные атрибуты, если файловая система
может их поддержать:

-m / dev / sda1: /: acl, user_xattr

Использование этого флага эквивалентно использованию команды «mount-options».

Четвертая часть параметра - это используемый драйвер файловой системы, например ext3 или
"NTFS". Это редко требуется, но может быть полезно, если для одного
файловая система (например: «ext2» и «ext3»), или если libguestfs неверно идентифицирует файловую систему.

--сеть
Включите пользовательскую сеть QEMU в гостевой системе.

-N [filename =] тип
--новый [filename =] тип
-N помощь
Подготовьте новый образ диска, отформатированный как «тип». Это альтернатива -a
вариант: тогда как -a добавляет существующий диск, -N создает предварительно отформатированный диск с
файловая система и добавляет ее. См. «ПОДГОТОВЛЕННЫЕ ИЗОБРАЖЕНИЯ ДИСКА» ниже.

-n
--нет синхронизации
Отключите автосинхронизацию. По умолчанию это включено. См. Обсуждение автосинхронизации в
гость(3) справочная страница.

--no-dest-пути
Не заполняйте пути в гостевой файловой системе с помощью табуляции. Полезно уметь ударить
клавиша табуляции для завершения пути в гостевой файловой системе, но это вызывает дополнительные "скрытые"
guestfs вызовет, поэтому этот параметр позволяет отключить эту функцию.

--pipe-ошибка
Если не удается выполнить запись в команды конвейера (см. «ТРУБЫ» ниже), команда возвращает
ошибка.

По умолчанию (также по историческим причинам) такие ошибки игнорируются, чтобы:

> command_with_lots_of_output | голова

не выдает ошибки.

--прогресс-бары
Включите индикаторы выполнения, даже если guestfish используется не интерактивно.

Индикаторы выполнения включены по умолчанию, когда guestfish используется в качестве интерактивной оболочки.

--no-прогресс-бары
Отключить индикаторы выполнения.

--remote [= pid]
Отправляйте удаленные команды на $ GUESTFISH_PID или "pid". См. Раздел «ПУЛЬТ ДИСТАНЦИОННОГО УПРАВЛЕНИЯ.
ГОСТЬ НА РОЗЕТКЕ "ниже.

-r
--ро
Это меняет -a, -d и -m параметры, чтобы диски добавлялись и монтировались
только для чтения.

Опция должна использоваться всегда, если образ диска или виртуальная машина могут быть запущены,
и обычно рекомендуется в тех случаях, когда вам не нужен доступ для записи на диск.

Обратите внимание, что подготовленные образы дисков, созданные с помощью -N эта опция не влияет. Также
команды вроде "add" не затрагиваются - вы должны указать опцию "readonly: true"
явно, если вам это нужно.

См. Также «ОТКРЫТИЕ ДИСКОВ ДЛЯ ЧТЕНИЯ И ЗАПИСИ» ниже.

--селинукс
Включите поддержку SELinux для гостя. См. «SELINUX» в гость(3).

-v
--подробный
Включите очень подробные сообщения. Это особенно полезно, если вы обнаружите ошибку.

-V
--версия
Отобразите номер версии guestfish / libguestfs и выйдите.

-w
--rw
Это меняет -a, -d и -m параметры, чтобы диски добавлялись и монтировались
читай пиши.

См. «ОТКРЫТИЕ ДИСКОВ ДЛЯ ЧТЕНИЯ И ЗАПИСИ» ниже.

-x Повторяйте каждую команду перед ее выполнением.

КОМАНДЫ ON КОМАНДА ЛИНИЯ

Любые дополнительные (не опциональные) аргументы рассматриваются как команды для выполнения.

Команды для выполнения должны быть разделены двоеточием (":"), где двоеточие является отдельным
параметр. Таким образом:

guestfish cmd [аргументы ...]: cmd [аргументы ...]: cmd [аргументы ...] ...

Если дополнительных аргументов нет, то входим в оболочку, либо в интерактивную оболочку
с подсказкой (если ввод - терминал) или неинтерактивной оболочкой.

В режиме командной строки или в неинтерактивной оболочке первая команда, которая дает
ошибка приводит к завершению работы всей оболочки. В интерактивном режиме (с подсказкой), если команда
не удается, вы можете продолжать вводить команды.

С ПОМОЩЬЮ запуск (ИЛИ запустить)

Как и в случае гость(3), вы должны сначала настроить гостя, добавив диски, а затем запустить его,
затем смонтируйте необходимые диски и, наконец, выполните действия / команды. Итак, общий порядок
дня:

· Добавить или -a / - добавить

· Запуск (он же бег)

· Монтировать или -m / - монтировать

· Любые другие команды

«запустить» - синоним слова «запускать». Вы должны "запустить" (или "запустить") вашего гостя перед установкой
или выполнение любых других команд.

Единственным исключением является то, что если любой из -i, -m, --устанавливать, -N or --новый варианты были даны
тогда "запустить" выполняется автоматически, просто потому, что guestfish не может выполнить действие, которое вы
просил, не делая этого.

ОТКРЫТИЕ ДИСКИ Для ЧИТАТЬ И ПИШИТЕ

Рыба-гость, гостевая гора(1) и спасение вирт(1) варианты --ро и --rw влияет ли
другие параметры командной строки -a, -c, -d, -i и -m открывать образы дисков только для чтения или для
письмо.

В libguestfs ≤ 1.10 по умолчанию guestfish, guestmount и virt-rescue открывают диск
изображения, предоставленные в командной строке для записи. Чтобы открыть образ диска только для чтения, вам необходимо:
do -a изображение --ро.

Это имеет значение: если вы случайно откроете живой образ диска виртуальной машины, доступный для записи, вы вызовете
необратимое повреждение диска.

В будущем libguestfs мы намерены изменить значение по умолчанию другим способом. Образы дисков будут
открыт только для чтения. Вам нужно будет либо указать рыба-гость --rw, гостевая гора --rw, вирт-
спасать --rw, или измените файл конфигурации, чтобы получить доступ на запись для образов дисков
указанные в других параметрах командной строки.

Эта версия guestfish, guestmount и virt-rescue имеет --rw вариант, который ничего не делает
(это уже по умолчанию). Однако настоятельно рекомендуется использовать эту опцию для
укажите, что вам нужен доступ для записи, и подготовьте свои сценарии на тот день, когда эта опция
потребуется для записи.

Примечание: Это делает не влияют на команды, такие как "добавить" и "монтировать", или любые другие libguestfs
программа, кроме guestfish и guestmount.

ЦИТАТА

Вы можете заключать обычные параметры в одинарные или двойные кавычки. Например:

добавить "файл с пробелом .img"

rm '/ имя файла'

rm '/ "'

Некоторым командам требуется передать список строк. Для этого используйте пробел -
разделенный список, заключенный в кавычки. Строки, содержащие пробелы, которые нужно пропустить
должны быть заключены в одинарные кавычки. Буквальная одинарная кавычка должна быть экранирована
обратная косая черта.

vgcreate VG "/ dev / sda1 / dev / sdb1"
команда "/ bin / echo 'foo bar' "
команда "/ bin / echo \ 'фу \' "

УХОД ПОСЛЕДОВАТЕЛЬНОСТИ IN ДВОЙНОЙ ЦИТАТЫ АРГУМЕНТЫ
В аргументах, заключенных в двойные кавычки (только), используйте обратную косую черту для вставки специальных символов:

"\ а"
Предупреждающий (колокольчик) символ.

"\ b"
Символ Backspace.

"\ f"
Символ подачи формы.

"\ п"
Символ новой строки.

"\р"
Символ возврата каретки.

"\ t"
Горизонтальная табуляция.

"\ v"
Вертикальный символ табуляции.

"\" "
Буквальный символ двойной кавычки.

"\ ооо"
Символ с восьмеричным значением ооо. Должно быть ровно 3 восьмеричных цифры (в отличие от C).

"\ ххх"
Символ с шестнадцатеричным значением hh. Должно быть ровно 2 шестнадцатеричные цифры.

В текущей реализации "\ 000" и "\ x00" нельзя использовать в строках.

"\\"
Буквальный символ обратной косой черты.

ДОПОЛНИТЕЛЬНО АРГУМЕНТЫ

Некоторые команды принимают необязательные аргументы. Эти аргументы представлены в этой документации как
"[имя_аргумента: ..]". Вы можете использовать их, как в этих примерах:

добавить имя файла

добавить имя файла только для чтения: true

добавить формат имени файла: qcow2 только для чтения: false

Каждый необязательный аргумент может появляться не более одного раза. Все необязательные аргументы должны появляться после
необходимые.

ЦИФРЫ

Этот раздел применяется ко всем командам, которые могут принимать целые числа в качестве параметров.

РАЗМЕР СУФФИКС
Когда команда принимает параметр, измеряемый в байтах, вы можете использовать один из следующих
суффиксы для указания килобайт, мегабайт и более крупных размеров:

k or K or КБ
Размер в килобайтах (умноженный на 1024).

KB Размер в единицах СИ 1000 байт.

M or МиБ
Размер в мегабайтах (умноженный на 1048576).

MB Размер в единицах СИ 1000000 байт.

G or GiB
Размер в гигабайтах (умноженный на 2 ** 30).

GB Размер в СИ 10 ** 9-байтовых единиц.

T or ТиБ
Размер в терабайтах (умноженный на 2 ** 40).

TB Размер в СИ 10 ** 12-байтовых единиц.

P or ПиБ
Размер в петабайтах (умноженный на 2 ** 50).

PB Размер в СИ 10 ** 15-байтовых единиц.

E or ЕИБ
Размер в эксабайтах (умноженный на 2 ** 60).

EB Размер в СИ 10 ** 18-байтовых единиц.

Z or ZIB
Размер в зеттабайтах (умноженный на 2 ** 70).

ZB Размер в СИ 10 ** 21-байтовых единиц.

Y or ЙиБ
Размер в йоттабайтах (умноженный на 2 ** 80).

YB Размер в СИ 10 ** 24-байтовых единиц.

Например:

размер усечения / файл 1 ГБ

обрезал бы файл до 1 гигабайта.

Будьте осторожны, потому что некоторые команды принимают размер в килобайтах или мегабайтах (например, параметр
в "memsize" уже указано в мегабайтах). Добавление суффикса, вероятно, не подойдет
чего вы ожидаете.

Восьмеричный И ШЕСТИГРАННЫЙ ЦИФРЫ
Для указания системы счисления (основания) используйте соглашение C: 0 для префикса восьмеричного числа или "0x"
для префикса шестнадцатеричного числа. Например:

1234 десятичное число 1234
02322 восьмеричное число, эквивалентное десятичному 1234
0x4d2 шестнадцатеричное число, эквивалентное десятичному 1234

При использовании команды "chmod" вы почти всегда хотите указать восьмеричное число для
режим, и вы должны поставить перед ним 0 (в отличие от Unix CHMOD(1) программа):

chmod 0777 / общедоступный # ОК
chmod 777 / public # НЕПРАВИЛЬНО! Это режим 777 десятичный = 01411 восьмеричный.

Команды, возвращающие числа, обычно печатают их в десятичном формате, но некоторые команды печатают
числа в других основаниях (например, "umask" печатает режим в восьмеричном формате, которому предшествует 0).

ПОДСТАВНЫЕ КАРТЫ И ГЛОБАЛЬНЫЙ

Ни guestfish, ни базовый API-интерфейс guestfs не выполняют подстановку (подстановку) с помощью
дефолт. Так, например, следующее не будет делать того, чего вы ожидаете:

рм-рф /Главная/*

Предполагая, что у вас нет каталога, который буквально называется /Главная/* тогда приведенная выше команда будет
вернуть ошибку.

Чтобы выполнить раскрытие подстановочных знаков, используйте команду «glob».

глобус рм-рф /Главная/*

запускает "rm-rf" на каждом подходящем пути (т. е. потенциально запускает команду много раз),
эквивалентно:

rm-rf / home / джим
rm-rf / home / joe
rm-rf / home / mary

"glob" работает только с простыми гостевыми путями, но не с именами устройств.

Если у вас есть несколько параметров, каждый из которых содержит подстановочный знак, то glob выполнит
Декартово произведение.

КОММЕНТАРИИ

Любая строка, начинающаяся с # символ рассматривается как комментарий и игнорируется. В # может
необязательно предшествовать пробелу, но не по команде. Например:

# это комментарий
# это комментарий
foo # НЕ комментарий

Пустые строки также игнорируются.

БЕГ КОМАНДЫ ЛОКАЛЬНО

Любая строка, начинающаяся с ! символ рассматривается как команда, отправленная в локальную оболочку
(/ Бен / ш или что угодно система(3) использует). Например:

! mkdir местный
tgz-out / удаленный локальный / удаленный-data.tar.gz

создаст "локальный" каталог на хосте, а затем экспортирует содержимое /удаленный on
смонтированная файловая система в локальные / удаленные-данные.tar.gz. (См. «Tgz-out»).

Чтобы изменить локальный каталог, используйте команду «lcd». "! cd" не будет иметь эффекта из-за
способ работы подпроцессов в Unix.

LOCAL КОМАНДЫ В ЛИНИЮ ИСПОЛНЕНИЕ
Если строка начинается с <! затем выполняется команда оболочки (как для !), но впоследствии
любой вывод (stdout) команды оболочки анализируется и выполняется как команды guestfish.

Таким образом, вы можете использовать сценарий оболочки для создания произвольных команд guestfish, которые затем
разбирается с помощью guestfish.

Например, утомительно создавать последовательность файлов (например, /foo.1 через /foo.100)
используя только команды guestfish. Однако это просто, если мы используем сценарий оболочки для создания
Guestfish командует для нас:

<! для n в `seq 1 100`; сделать echo write /foo.$n $n; сделанный

или с такими именами, как /foo.001:

<! для n в `seq 1 100`; do printf "write /foo.%03d %d\n" $n $n; сделанный

При интерактивном использовании guestfish может быть полезно сначала просто запустить сценарий оболочки.
(т. е. удалите начальный символ "<", чтобы он оставался обычным ! локальная команда), посмотрите, что
Команда guestfish будет запущена, и когда вы будете довольны этим, добавьте "<"
персонаж, чтобы запускать команды guestfish по-настоящему.

ТРУБЫ

Используйте команду | команда "для конвейерной передачи вывода первой команды (guestfish
command) ко второй команде (любой команде хоста). Например:

кошка / И т.д. / пароль | awk -F: '$ 3 == 0 {печать}'

(где «cat» - это команда guestfish cat, а «awk» - это основная awk-программа). Над
команда выведет список всех учетных записей в гостевой файловой системе с UID 0, т.е. корень
учетные записи, включая бэкдоры. Другие примеры:

шестнадцатеричного / bin / ls | голова
список-устройств | хвост -1
tgz-выход/- | смола ztf -

Пробел перед символом трубы обязателен, любой пробел после символа трубы не обязателен.
Все, что находится после символа вертикальной черты, просто передается прямо в оболочку хоста, поэтому она может
содержат перенаправления, глобусы и все остальное, что имеет смысл на стороне хоста.

Чтобы использовать буквальный аргумент, который начинается с символа вертикальной черты, вы должны указать его в кавычках, например:

эхо "|"

ГЛАВНАЯ КАТАЛОГИ

Если параметр начинается с символа "~", тильда может быть расширена как начальная
путь к каталогу (либо "~" для домашнего каталога текущего пользователя, либо "~ user" для другого
Пользователь).

Обратите внимание, что расширение домашнего каталога происходит для пользователей, известных on домен кашельне в гостях
файловая система.

Чтобы использовать буквальный аргумент, начинающийся с тильды, вы должны его процитировать, например:

эхо "~"

ЗАШИФРОВАНО ДИСКИ

Libguestfs имеет некоторую поддержку для гостей Linux, зашифрованных в соответствии с Linux Unified Key.
Стандарт установки (LUKS), который включает почти все системы шифрования всего диска, используемые
современные гости Linux. В настоящее время поддерживается только LVM-on-LUKS.

Определите зашифрованные блочные устройства и разделы с помощью «vfs-type»:

> vfs-тип / dev / sda2
крипто_ЛУКС

Затем откройте эти устройства с помощью luks-open. Это создает устройство сопоставления устройств, называемое
/ dev / mapper / luksdev.

> luks-open / dev / sda2 luksdev
Введите ключ или кодовую фразу («ключ»):

Наконец, вы должны указать LVM сканировать группы томов на вновь созданном устройстве сопоставления:

vgscan
vg-активировать все правда

Логические тома теперь можно смонтировать обычным способом.

Перед закрытием устройства LUKS необходимо отключить на нем все логические тома и деактивировать
группы томов, вызывая "vg-activate false VG" на каждой из них. Затем вы можете закрыть
картографическое устройство:

vg-activate false / dev / VG
luks-close / dev / mapper / luksdev

WINDOWS ПУТИ

Если путь имеет префикс "win:", вы можете использовать буквы дисков и пути в стиле Windows.
(с некоторыми ограничениями). Следующие команды эквивалентны:

файл /WINDOWS/system32/config/system.LOG

файл win: \ windows \ system32 \ config \ system.log

файл WIN: C: \ Windows \ SYSTEM32 \ CONFIG \ SYSTEM.LOG

Параметр перезаписывается "за кадром" путем поиска позиции, в которой привод
монтируется, добавляя это к пути, меняя все символы обратной косой черты на вперед
косая черта, затем разрешив результат, используя "путь с учетом регистра". Например, если диск E:
был установлен на /e тогда параметр можно переписать так:

победа: e: \ foo \ bar => / e / FOO / bar

Это работает только в позициях аргумента, которые ожидают путь.

ЗАГРУЗКА И ЗАГРУЗКА FILES

Для таких команд, как «загрузка», «загрузка», «tar-in», «tar-out» и других, которые загружают
из или для загрузки в локальный файл, вы можете использовать специальное имя файла "-" для обозначения "из"
stdin "или" to stdout ". Например:

загрузить - / foo

читает стандартный ввод и создает из него файл / foo в образе диска и:

тар-аут / и т.д. - | смола тф -

записывает архив в стандартный вывод, а затем передает его внешней команде tar (см.
«ТРУБЫ»).

При использовании «-» для чтения из стандартного ввода, ввод читается до конца стандартного ввода. Вы также можете
используйте специальный синтаксис, подобный "heredoc", чтобы прочитать произвольный конечный маркер:

загрузить - <
строка ввода 1
строка ввода 2
строка ввода 3
END

Вместо «КОНЕЦ» можно использовать любую строку символов. Конечный маркер должен появиться на
отдельная строка, без каких-либо предшествующих или последующих символов (даже без пробелов).

Обратите внимание, что синтаксис «- <<» применяется только к параметрам, используемым для загрузки локальных файлов (поэтому-
называемые параметрами "FileIn" в генераторе).

ВЫХОД ON ОШИБКА ПОВЕДЕНИЕ

По умолчанию guestfish игнорирует любые ошибки в интерактивном режиме (т. Е. Принимает команды
от человека через tty) и выйдет при первой ошибке в неинтерактивном режиме
(скрипты, команды, заданные в командной строке).

Если вы поставите перед командой префикс - символ, то эта команда не приведет к тому, что guestfish будет
выйти, даже если эта (одна) команда вернет ошибку.

ДИСТАНЦИОННОГО КОНТРОЛЬ ГОСТЕВАЯ OVER A SOCKET

Guestfish можно дистанционно управлять через розетку. Это особенно полезно в оболочке
сценарии, в которых вы хотите внести несколько различных изменений в файловую систему, но не
хотите накладные расходы на запуск процесса guestfish каждый раз.

Запустите процесс сервера guestfish, используя:

eval "` guestfish --listen` "

а затем отправьте ему команды, выполнив:

Guestfish --remote cmd [...]

Чтобы заставить сервер выйти, отправьте ему команду выхода:

guestfish - удаленный выход

Обратите внимание, что сервер обычно завершает работу, если в команде есть ошибка. Ты можешь измениться
это обычным способом. См. Раздел «ВЫХОД ПРИ ОШИБКЕ ПОВЕДЕНИЯ».

УПРАВЛЕНИЕ НЕСКОЛЬКО ГОСТЕВАЯ ПРОЦЕССЫ
Оператор eval устанавливает переменную окружения $ GUESTFISH_PID, как
--дистанционный пульт option знает, куда отправлять команды. У вас может быть несколько слушателей guestfish
процессы, запущенные с использованием:

eval "` guestfish --listen` "
pid1 = $ GUESTFISH_PID
eval "` guestfish --listen` "
pid2 = $ GUESTFISH_PID
...
guestfish --remote = $ pid1 cmd
guestfish --remote = $ pid2 cmd

ДИСТАНЦИОННОГО КОНТРОЛЬ И CSH
При использовании csh-подобных оболочек (csh, tcsh и т. Д.) Вы должны добавить --csh опции:

eval "` guestfish --listen --csh` "

ДИСТАНЦИОННОГО КОНТРОЛЬ ПОДРОБНЕЕ
Удаленное управление происходит через сокет домена Unix, называемый /tmp/.guestfish-$UID/сокет-$PID,
где $ UID - это эффективный идентификатор пользователя процесса, а $ PID - это идентификатор процесса
сервера.

Версии клиента и сервера Guestfish должны точно совпадать.

Более старые версии guestfish были уязвимы для CVE-2013-4419 (см. «CVE-2013-4419» в
гость(3)). Это исправлено в текущей версии.

С ПОМОЩЬЮ ДИСТАНЦИОННОГО КОНТРОЛЬ НАДЕЖНО от SHELL СЦЕНАРИИ
Из Bash вы можете использовать следующий код, который правильно создает экземпляр guestfish
цитирует командную строку, обрабатывает сбой при запуске и очищает guestfish, когда сценарий
выходы:

#!/ bin / bash -

установить -е

guestfish [0] = "guestfish"
guestfish [1] = "- слушай"
guestfish [2] = "- ro"
guestfish [3] = "- а"
guestfish [4] = "disk.img"

GUESTFISH_PID =
eval $ ("$ {guestfish [@]}")
если [-z "$ GUESTFISH_PID"]; тогда
echo "ошибка: guestfish не запускается, см. сообщения об ошибках выше"
выйти из 1
fi

Cleanup_guestfish ()
{
guestfish --remote - exit> / dev / null 2> & 1 ||:
}
ловушка cleanup_guestfish EXIT ERR

guestfish --remote - запустить

#...

ДИСТАНЦИОННОГО КОНТРОЛЬ ДЕЛАЕТ НЕ РАБОТА -a ETC. ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ
Такие варианты, как -a, --Добавить, -N, --новый и т. д. не взаимодействуют должным образом с удаленной поддержкой.
Они обрабатываются локально и не отправляются удаленному гостевому серверу. Особенно
это не сделает того, чего вы ожидаете:

guestfish --remote --добавить disk.img

Не используйте эти варианты. Вместо этого используйте эквивалентные команды, например:

Guestfish --remote Add-Drive disk.img

или:

guestfish - удаленный
> добавить disk.img

ДИСТАНЦИОННОГО КОНТРОЛЬ БЕГ КОМАНДА подвешивание
При удаленном использовании команды "run" (или "launch") в контексте подстановки команды зависает,
т.е. не делайте (обратите внимание на обратные кавычки):

a = `guestfish --remote run`

Поскольку команда "run" не выводит на стандартный вывод, это в любом случае бесполезно. Для
дополнительную информацию см. https://bugzilla.redhat.com/show_bug.cgi?id=592910.

ГОТОВ ДИСК ИЗОБРАЖЕНИЙ

Использовать -N [filename =] тип or --новый [filename =] тип параметр для выбора одного из набора
предварительно отформатированные образы дисков, которые guestfish может сделать для вас, чтобы вы не набирали текст. Это
особенно полезно для целей тестирования. Эта опция используется вместо -a вариант,
и как -a может появляться несколько раз (и может смешиваться с -a).

Новый диск называется test1.img для первого -N, test2.img для второго и так далее.
Существующие файлы в текущем каталоге: перезаписаны. Вы можете использовать другое имя файла
указав "filename =" перед типом (см. примеры ниже).

Тип кратко описывает размер диска, его разбиение на разделы и файловые системы.
должны быть созданы, и как контент должен быть добавлен. По желанию тип может быть отслежен
дополнительными параметрами, разделенными символами ":" (двоеточие). Например, -N fs создает
по умолчанию 100 МБ, редко выделяемый диск, содержащий один раздел, с разделом
отформатирован как ext2. -N fs: ext4: 1 ГБ то же самое, но для файловой системы ext4 на диске 1 ГБ
.

Обратите внимание, что подготовленная файловая система не монтируется. Обычно вам придется использовать
команду "mount / dev / sda1 /" или добавьте -m / Dev / sda1 опцию.

Если -N or --новый указаны параметры, автоматически запускается программа libguestfs.

ПРИМЕРЫ
Создайте диск размером 100 МБ с разделом в формате ext4, который называется test1.img в течении
каталог:

guestfish -N fs: ext4

Создайте диск размером 32 МБ с разделом в формате VFAT и смонтируйте его:

guestfish -N фс: vfat: 32M -m / dev / sda1

Создайте пустой диск 200 МБ:

guestfish -N диск: 200M

Создайте пустой диск 200 МБ с именем пустой диск.img (вместо test1.img):

guestfish -N blankdisk.img = диск: 200M

-N диск - Создайте a пустой диск
"guestfish -N [имя файла =] диск [: размер] "

Создайте пустой диск размером 100 МБ (по умолчанию).

Размер по умолчанию можно изменить, указав необязательный параметр.

Необязательные параметры:

Имя Значение по умолчанию
size 100M размер образа диска

-N часть - Создайте a распределяли диск
"guestfish -N [имя файла =] часть [: размер [: раздел]] "

Создайте диск с одним разделом. По умолчанию размер диска составляет 100 МБ (
доступное пространство в разделе будет немного меньше), и таблица разделов будет
быть MBR (старый стиль DOS).

Эти значения по умолчанию можно изменить, указав дополнительные параметры.

Необязательные параметры:

Имя Значение по умолчанию
size 100M размер образа диска
partition mbr тип таблицы разделов

-N fs - Создайте a файловая система
"guestfish -N [filename =] fs [: файловая система [: размер [: раздел]]] "

Создайте диск с одним разделом, причем раздел содержит пустую файловую систему.
По умолчанию создается диск размером 100 МБ (доступное пространство в файловой системе будет
немного меньше) с таблицей разделов MBR (старый стиль DOS) и файловой системой ext2.

Эти значения по умолчанию можно изменить, указав дополнительные параметры.

Необязательные параметры:

Имя Значение по умолчанию
файловая система ext2 тип используемой файловой системы
size 100M размер образа диска
partition mbr тип таблицы разделов

-N lv - Создайте a диск логический объем
"guestfish -N [filename =] lv [: имя [: размер [: раздел]]] "

Создайте диск с одним разделом, настройте раздел как физический том LVM2,
и поместите туда группу томов и логический том. По умолчанию создается 100 МБ
диск с VG и LV называется "/ dev / VG / LV". Вы можете изменить название VG и LV с помощью
предоставление альтернативного имени в качестве первого необязательного параметра.

Обратите внимание, что это не создает файловую систему. Для этого используйте lvfs.

Необязательные параметры:

Имя Значение по умолчанию
name / dev / VG / LV имя VG и LV для использования
size 100M размер образа диска
partition mbr тип таблицы разделов

-N ЛВФС - Создайте a диск логический объем и файловая система
"guestfish -N [filename =] lvfs [: имя [: файловая система [: размер [: раздел]]]] "

Создайте диск с одним разделом, настройте раздел как физический том LVM2,
и поместите туда группу томов и логический том. Затем отформатируйте LV с помощью
файловая система. По умолчанию создается диск размером 100 МБ с именами VG и LV.
"/ dev / VG / LV", с файловой системой ext2.

Необязательные параметры:

Имя Значение по умолчанию
name / dev / VG / LV имя VG и LV для использования
файловая система ext2 тип используемой файловой системы
size 100M размер образа диска
partition mbr тип таблицы разделов

-N загрузочный корень - Создайте a лодка и корень файловая система
"guestfish -N [filename =] bootroot [: bootfs [: rootfs [: size [: bootsize [: раздел]]]]] "

Создайте диск с двумя разделами, для загрузочной и корневой файловой системы. Отформатируйте два
файловые системы независимо. Есть несколько дополнительных параметров, которые контролируют точную
макет и типы файловой системы.

Необязательные параметры:

Имя Значение по умолчанию
bootfs ext2 тип файловой системы для загрузки
rootfs ext2 тип файловой системы, используемой для root
size 100M размер образа диска
bootize 32M размер загрузочной файловой системы
partition mbr тип таблицы разделов

-N bootrootlv - Создайте a лодка и корень файловая система через LVM
"guestfish -N"
[filename =] bootrootlv [: имя [: bootfs [: rootfs [: размер [: bootrootlv [: раздел]]]]]] "

Это то же самое, что и "bootroot", но корневая файловая система (только) помещается в логический
том, по умолчанию названный "/ dev / VG / LV". Есть несколько необязательных параметров, которые
контролировать точный макет.

Необязательные параметры:

Имя Значение по умолчанию
name / dev / VG / LV имя VG и LV для root
bootfs ext2 тип файловой системы для загрузки
rootfs ext2 тип файловой системы, используемой для root
size 100M размер образа диска
bootize 32M размер загрузочной файловой системы
partition mbr тип таблицы разделов

ДОБАВЛЕНИЕ ДИСТАНЦИОННОГО ХРАНЕНИЕ

Что касается API-уровень документации on этой тема, посмотреть "guestfs_add_drive_opts" in гость(3) и
"УДАЛЕННЫЙ МЕСТО ХРАНЕНИЯ" in гость(3).

В командной строке вы можете использовать -a возможность добавления сетевых блочных устройств с использованием URI-
формат стиля, например:

guestfish -a ssh: //[электронная почта защищена]/диск.img

URI не могу использоваться с командой «добавить». Эквивалентная команда с использованием API напрямую
это:

> добавить протокол /disk.img: ssh server: tcp: example.com имя пользователя: root

Возможная -a URI форматы описаны ниже.

-a диск.img
-a файл: ///path/to/disk.img
Добавьте образ локального диска (или устройства) с именем диск.img.

-a ftp: // [пользователь @] example.com [: порт] /disk.img
-a ftps: // [пользователь @] example.com [: порт] /disk.img
-a http://[user@]example.com[:port]/disk.img
-a https://[user@]example.com[:port]/disk.img
-a tftp: // [пользователь @] example.com [: порт] /disk.img
Добавьте диск, расположенный на удаленном сервере FTP, HTTP или TFTP.

Эквивалентная команда API:

> добавить протокол /disk.img: (ftp | ...) server: tcp: example.com

-a gluster: //example.com [: порт] / имя тома / изображение
Добавьте образ диска, расположенный в хранилище GlusterFS.

Сервер - это тот, на котором запущен "glusterd", и может быть "localhost".

Эквивалентная команда API:

> добавить имя тома / протокол изображения: сервер gluster: tcp: example.com

-a iscsi: //example.com [: порт] / target-iqn-name [/ lun]
Добавьте диск, расположенный на сервере iSCSI.

Эквивалентная команда API:

> добавить target-iqn-name / lun protocol: iscsi server: tcp: example.com

-a nbd: //example.com [: порт]
-a nbd: //example.com [: порт] / имя экспорта
-a nbd: //? сокет = / сокет
-a nbd: /// имя экспорта? socket = / socket
Добавьте диск, расположенный в хранилище сетевых блочных устройств (nbd).

Ассоциация / exportname часть URI указывает имя экспорта NBD, но обычно остается пустым.

Необязательный ?разъем параметр может использоваться для указания сокета домена Unix, с которым мы говорим
сервер NBD закончился. Обратите внимание, что нельзя смешивать имя сервера (например, TCP / IP) и путь к сокету.

Эквивалентная команда API будет (без имени экспорта):

> добавить "" протокол: сервер nbd: [tcp: example.com | unix: / socket]

-a rbd: /// пул / диск
-a rbd: //example.com [: порт] / пул / диск
Добавьте образ диска, расположенный в томе хранения Ceph (RBD / librbd).

Хотя libguestfs и Ceph поддерживают несколько серверов, только один сервер может быть
указывается при использовании этого синтаксиса URI.

Эквивалентная команда API:

> добавить протокол пула / диска: rbd server: tcp: example.com: port

-a овчарка: // [example.com [: порт]] / объем / изображение
Добавьте образ диска, расположенный на томе Sheepdog.

Имя сервера указывать необязательно. Хотя libguestfs и Sheepdog поддерживают несколько серверов,
при использовании этого синтаксиса URI можно указать не более одного сервера.

Эквивалентная команда API:

> добавить протокол тома: овчарка [сервер: tcp: example.com]

-a ssh: // [пользователь @] example.com [: порт] /disk.img
Добавить образ диска, расположенный на удаленном сервере, доступ к которому осуществляется через SFTP Secure Shell (ssh)
протокол. SFTP сразу поддерживается всеми основными серверами SSH.

Эквивалентная команда API:

> добавить / диск протокол: ssh server: tcp: example.com [имя пользователя: пользователь]

ПРОГРЕСС БАРС

Некоторые (не все) долго выполняющиеся команды отправляют сообщения с уведомлением о ходе выполнения, как есть.
Бег. Guestfish превращает эти сообщения в индикаторы выполнения.

Когда команда, поддерживающая индикаторы выполнения, выполняется дольше двух секунд, и если
Индикаторы выполнения включены, затем вы увидите один, появляющийся под командой:

> размер копии / большой файл / другой файл 2048M
/ 10% [##### ----------------------------------------- ] 00:30

Счетчик на левой стороне перемещается один раз для каждого уведомления о прогрессе.
полученный от бэкэнда. Это (разумно) золотая гарантия того, что команда
"делать что-то", даже если индикатор выполнения не движется, потому что команда может
отправить уведомления о прогрессе. Когда полоса достигает 100% и команда завершается,
спиннер исчезает.

Индикаторы выполнения включены по умолчанию, когда guestfish используется в интерактивном режиме. Вы можете включить
их даже для неинтерактивных режимов, используя --прогресс-бары, и вы можете отключить их
полностью используя --no-прогресс-бары.

PROMPT

Вы можете изменить или добавить цвета к приглашению по умолчанию ("> "), установив
Переменная окружения "GUESTFISH_PS1". Печатается вторая строка («GUESTFISH_OUTPUT»).
после ввода команды и до вывода, что позволяет вам контролировать
цвет вывода. Третья строка («GUESTFISH_INIT») печатается перед приветствием.
сообщение, позволяющее контролировать цвет этого сообщения. Четвертая струна
("GUESTFISH_RESTORE") печатается перед выходом из guestfish.

Простую подсказку можно установить, установив "GUESTFISH_PS1" на альтернативную строку:

$ GUESTFISH_PS1 = '(введите команду)'
$ экспорт GUESTFISH_PS1
$ гостевая рыба
[...]
(введите команду) ▂

Вы также можете использовать специальные escape-последовательности, как описано в таблице ниже:

\\ Буквальный символ обратной косой черты.

\[
\] (Их следует использовать только в "GUESTFISH_PS1".)

Поместите непечатаемые символы (например, коды управления терминалом для цветов) между
"\ [... \]". Что это значит, чтобы рассказать Readline(3) библиотека, которую он должен лечить
эта подпоследовательность имеет нулевую ширину, чтобы работало повторное отображение, редактирование и т. д. из командной строки.

\ a Колокольчик.

\ e Символ ASCII ESC (escape).

\ n Новая строка.

\ r Возврат каретки.

\ NNN
Символ ASCII, код которого является восьмеричным значением NNN.

\ xNN
Символ ASCII, код которого является шестнадцатеричным значением NN.

ПРИМЕРЫ OF ПРЕДЛОЖЕНИЯ
Обратите внимание, что для этого требуется терминал, поддерживающий escape-коды ANSI.

·

GUESTFISH_PS1='\[\e[1;30m\]><fs>\[\e[0;30m\] '

Смелая черная версия обычной подсказки.

·

GUESTFISH_PS1='\[\e[1;32m\]><fs>\[\e[0;31m\] '
GUESTFISH_OUTPUT = '\ e [0 м'
GUESTFISH_RESTORE = "$ GUESTFISH_OUTPUT"
GUESTFISH_INIT = '\ e [1; 34 м'

Синий приветственный текст, зеленая подсказка, красные команды, черный вывод команды.

WINDOWS 8

«Быстрый запуск» Windows 8 может помешать guestfish монтировать разделы NTFS. Видеть
"ВЫКЛЮЧЕНИЕ WINDOWS И БЫСТРЫЙ ЗАПУСК WINDOWS 8" в гость(3).

ГОСТЕВАЯ КОМАНДЫ

Команды в этом разделе являются удобными командами guestfish, другими словами, они
не часть гость(3) API.

помощь
помощь
помощь cmd

Без каких-либо параметров это дает общую справку.

С параметром «cmd» отображается подробная справка по этой команде.

выход
выход
Это выходит из guestfish. Вы также можете использовать клавишу «^ D».

Alloc
выделять
выделить размер имени файла

Это создает пустой (обнуленный) файл заданного размера, а затем добавляет его, чтобы его можно было дальше
рассмотрены.

Для более продвинутого создания образа см. «Disk-create».

Размер можно указать с помощью стандартных суффиксов, например. «1М».

Чтобы создать разреженный файл, используйте вместо этого «разреженный». Чтобы создать подготовленный образ диска, см.
«ПОДГОТОВЛЕННЫЕ ОБРАЗЫ ДИСКОВ».

копия
копирование в локальный [местный ...] / удаленный

"copy-in" рекурсивно копирует локальные файлы или каталоги в образ диска, помещая их
в каталоге под названием / удаленный (который должен существовать). Эта мета-команда guestfish превращает
в последовательность tar-in и других команд по мере необходимости.

Можно указать несколько локальных файлов и каталогов, но всегда должен быть последний параметр.
быть удаленным каталогом. Подстановочные знаки использовать нельзя.

копия
копирование удаленного [удаленного ...] localdir

"copy-out" рекурсивно копирует удаленные файлы или каталоги из образа диска, помещая
их на главном диске в локальном каталоге с именем «localdir» (который должен существовать). Этот
Мета-команда guestfish превращается в последовательность команд "загрузка", "tar-out" и других.
по мере необходимости.

Можно указать несколько удаленных файлов и каталогов, но всегда должен быть последний параметр.
быть локальным каталогом. Для загрузки в текущий каталог используйте "." как в:

копия / Главная .

Подстановочные знаки нельзя использовать в обычной команде, но вы можете использовать их с помощью
"шарик" вот так:

глобальное копирование /Главная/*.

удалить-событие
имя удаления-события

Удалите обработчик событий, который ранее был зарегистрирован как «имя». Если несколько событий
обработчики были зарегистрированы с одинаковыми именами, все они удалены.

См. Также команды guestfish "event" и "list-events".

дисплей
отображаемое имя файла

Используйте «display» (программу графического отображения) для отображения файла изображения. Он загружает
файл и запускает на нем "отображение".

Чтобы использовать альтернативную программу, установите переменную среды «GUESTFISH_DISPLAY_IMAGE».
Например, чтобы использовать программу отображения GNOME:

экспорт GUESTFISH_DISPLAY_IMAGE = eog

Смотрите также дисплей(1).

эхо
эхо [параметры ...]

Это выводит параметры на терминал.

отредактировать
vi
Emacs
редактировать имя файла

Используется для редактирования файла. Он загружает файл, редактирует его локально с помощью вашего редактора,
затем загружает результат.

Редактор - $ EDITOR. Однако если вы воспользуетесь альтернативными командами «vi» или «emacs», вы
получите соответствующих редакторов.

мероприятие
имя события набор событий "сценарий оболочки ..."

Зарегистрируйте фрагмент сценария оболочки, который выполняется при возникновении события. Видеть
"guestfs_set_event_callback" в гость(3) для обсуждения API событий в
libguestfs.

Параметр «name» - это имя, которое вы даете этому обработчику событий. Это может быть любая строка
(даже пустая строка) и просто там, поэтому вы можете удалить обработчик с помощью
Команда guestfish "delete-event".

Параметр "набор событий" представляет собой список одного или нескольких событий, разделенных запятыми, например
«закрыть» или «закрыть, проследить». Специальное значение «*» означает все события.

Третий и последний параметр - это фрагмент сценария оболочки (или любая внешняя команда), который
выполняется, когда происходит любое из событий в наборе событий. Он выполняется с использованием "$ SHELL"
-c ", или если $ SHELL не установлен, тогда / Бен / ш -c.

Фрагмент сценария оболочки получает параметры обратного вызова в качестве аргументов $ 1, $ 2 и т. Д.
Фактическое событие, которое было вызвано, доступно в переменной окружения $ EVENT.

событие "закрыть" эхо закрыто "
устройство сообщений о событиях, библиотека, трассировка "echo $ @"
событие "" прогресс "эхо прогресс: $ 3 / $ 4"
событие "" * "echo $ EVENT $ @"

См. Также команды guestfish "delete-event" и "list-events".

земной шар
аргументы команды glob ...

Разверните подстановочные знаки в любых путях в списке аргументов и повторно выполните команду "command" для каждого
соответствующий путь.

См. «ДИСПЕТЧЕРСКИЕ КАРТЫ И ГЛОБЛИРОВАНИЕ».

гексагон
гексагон
гексагон
гексагон

Используйте hexedit (шестнадцатеричный редактор) для редактирования всего или части двоичного файла или блочного устройства.

Эта команда работает, потенциально скачивая весь файл или устройство, редактируя его.
локально, а затем загрузив его. Если файл или устройство большого размера, вы должны указать, какие
часть, которую вы хотите отредактировать, используя параметры «max» и / или «start» «max». "старт" и "макс"
указываются в байтах, с обычными разрешенными модификаторами, такими как «1M» (1 мегабайт).

Например, чтобы отредактировать первые несколько секторов диска, вы можете сделать:

hexedit / dev / sda 1 МБ

что позволит вам редактировать где угодно в пределах первого мегабайта диска.

Чтобы отредактировать суперблок файловой системы ext2 на / Dev / sda1, делать:

hexedit / dev / sda1 0x400 0x400

(при условии, что суперблок находится в стандартном месте).

Эта команда требует внешнего гексагон(1) программа. Вы можете указать другую программу для
используйте, установив переменную окружения "HEXEDITOR".

См. Также «hexdump».

ЖК
жк-каталог

Измените локальный каталог, т.е. текущий каталог самого guestfish.

Учтите, что "! Cd" не будет делать то, что вы ожидаете.

список событий
список событий

Перечислите обработчики событий, зарегистрированные с помощью команды "event" guestfish.

человек
руководство
человек

Открывает страницу руководства для guestfish.

БОЛЕЕ
Меньше
больше имя файла

меньше имени файла

Используется для просмотра файла.

Программа просмотра по умолчанию - $ PAGER. Однако если вы воспользуетесь альтернативной командой «меньше», вы
получите команду «меньше».

возобновить
возобновить

Закройте и снова откройте дескриптор libguestfs. Обычно использовать это не обязательно, потому что
ручка закрывается должным образом, когда гостевая рыба выходит. Однако иногда это полезно
для тестирования.

Setenv
setenv значение VAR

Установите для переменной среды «VAR» строку «значение».

Чтобы распечатать значение переменной среды, используйте команду оболочки, например:

! echo $ VAR

редкий
разреженный размер имени файла

Это создает пустой разреженный файл заданного размера, а затем добавляет его, чтобы его можно было дальше
рассмотрены.

Во всех отношениях она работает так же, как команда "alloc", за исключением того, что файл изображения
распределены редко, что означает, что блоки диска не назначаются файлу, пока они
необходимы. Разреженные файлы на диске используют пространство только при записи, но они медленнее и
существует опасность, что во время операции записи у вас закончится реальное дисковое пространство.

Для более продвинутого создания образа см. «Disk-create».

Размер можно указать с помощью стандартных суффиксов, например. «1М».

См. Также команду "scratch" в guestfish.

поддержал
поддержал

Эта команда возвращает список необязательных групп, известных демону, и указывает
какие из них поддерживаются этой сборкой устройства libguestfs.

См. Также «НАЛИЧИЕ» в гость(3).

время
аргументы команды времени ...

Выполните команду как обычно, но потом выведите прошедшее время. Это может быть полезно для
сравнительный анализ операций.

снят с охраны
не настроен VAR

Удалите «VAR» из окружающей среды.

КОМАНДЫ

acl-delete-def-файл
acl-delete-def-file каталог

Эта функция удаляет список управления доступом POSIX по умолчанию (ACL), прикрепленный к каталогу.
"реж".

acl-get-файл
путь к файлу acl-get-file

Эта функция возвращает список управления доступом POSIX (ACL), прикрепленный к «пути». ACL - это
возвращается в "длинной текстовой форме" (см. ACL(5 г.)).

Параметр acltype может быть:

"доступ"
Возвращает обычный ACL (доступ) для любого файла, каталога или другого объекта файловой системы.

"По умолчанию"
Вернуть ACL по умолчанию. Обычно это имеет смысл, только если «путь» - это каталог.

acl-set-файл
путь к файлу-set-acl тип_acl acl

Эта функция устанавливает список управления доступом POSIX (ACL), прикрепленный к «пути».

Параметр acltype может быть:

"доступ"
Установите обычный ACL (доступ) для любого файла, каталога или другого объекта файловой системы.

"По умолчанию"
Установите ACL по умолчанию. Обычно это имеет смысл, только если «путь» - это каталог.

Параметр «acl» - это новый ACL в «длинной текстовой форме» или «короткой текстовой форме» (см.
ACL(5)). Новый ACL полностью заменяет любой предыдущий ACL в файле. ACL должен
содержат полные разрешения Unix (например, "u :: rwx, g :: rx, o :: rx").

Если вы указываете отдельных пользователей или группы, то поле маски также является обязательным.
(например, «m :: rwx»), за которым следует «u:Я БЫ:..." и / или "g:Я БЫ:..." поле (я). Полная строка ACL
поэтому может выглядеть так:

u :: rwx, g :: rwx, o :: rwx, m :: rwx, u: 500: rwx, g: 500: rwx
\ Разрешения Unix / \ маска / \ ACL /

Вы должны использовать числовые идентификаторы UID и GID. Чтобы сопоставить имена пользователей и имена групп с правильными
числовой идентификатор в контексте гостя, используйте функции Augeas (см. «aug-init»).

добавить-cdrom
add-cdrom имя файла

Эта функция добавляет гостю образ виртуального CD-ROM.

Образ добавляется как диск только для чтения, поэтому эта функция эквивалентна «add-drive-ro».

Эта функция is устарело. В новом коде вместо этого используйте вызов «add-drive-ro».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

добавить домен
домен
add-domain dom [libvirturi: ..] [readonly: true | false] [iface: ..] [live: true | false] [allowuuid: true | false] [readonlydisk: ..] [cachemode: ..] [ discard: ..] [copyonread: true | false]

Эта функция добавляет диск (и), прикрепленный к названному домену libvirt "dom". Это работает
подключение к libvirt, запрос домена и XML домена у libvirt, его анализ
дисков и вызывая "add-drive-opts" на каждом из них.

Возвращается количество добавленных дисков. Эта операция атомарна: если возвращается ошибка,
то диски не добавляются.

Эта функция выполняет минимальные проверки, чтобы убедиться, что домен libvirt не запущен.
(если "только для чтения" не истинно). В будущей версии мы попытаемся получить блокировку libvirt.
на каждом диске.

Диски должны быть доступны локально. Это часто означает, что добавление дисков с удаленного
подключение libvirt (см. http://libvirt.org/remote.html) завершится ошибкой, если эти диски не
доступный через тот же путь к устройству локально.

Необязательный параметр libvirturi устанавливает URI libvirt (см.
http://libvirt.org/uri.html). Если он не установлен, мы подключаемся к libvirt по умолчанию.
URI (или один установленный через переменную среды, см. Документацию libvirt для полной
подробности).

Необязательный флаг "live" определяет, будет ли этот вызов пытаться подключиться к работающему
виртуальная машина "guestfsd", если видит подходящий элемент в libvirt
Определение XML. По умолчанию (если флаг опущен) никогда не пытаться. См. «ПРИСОЕДИНЕНИЕ
ЗАПУСК ДЕЙМОНОВ »в гость(3) для получения дополнительной информации.

Если флаг "allowuuid" - истина (по умолчанию - ложь), то UUID май проходить вместо
доменное имя. Строка "dom" сначала обрабатывается как UUID и выполняется поиск, и если это
поиск не выполняется, тогда мы, как обычно, рассматриваем "dom" как имя.

Необязательный параметр readonlydisk определяет, что мы делаем с дисками, которые отмечены
в libvirt XML. Возможные значения:

readonlydisk = "ошибка"
Если "только для чтения" ложно:

Весь вызов прерывается с ошибкой, если какой-либо диск с флаг
найдено.

Если "только для чтения" верно:

Диски с добавлены только для чтения.

readonlydisk = "читать"
Если "только для чтения" ложно:

Диски с добавлены только для чтения. Добавлены другие диски
читай пиши.

Если "только для чтения" верно:

Диски с добавлены только для чтения.

readonlydisk = "запись" (по умолчанию)
Если "только для чтения" ложно:

Диски с добавлены флага чтения / записи.

Если "только для чтения" верно:

Диски с добавлены только для чтения.

readonlydisk = "игнорировать"
Если "только для чтения" истинно или ложно:

Диски с флаг пропускаются.

Остальные необязательные параметры передаются напрямую в «add-drive-opts».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

надстройка
Добавить
добавить-диск-opts
add-drive имя_файла [только для чтения: истина | ложь] [формат: ..] [iface: ..] [имя: ..] [метка: ..] [протокол: ..] [сервер: ..] [имя пользователя: ..] [секрет: ..] [cachemode: ..] [сбросить: ..] [copyonread: true | false]

Эта функция добавляет образ диска с именем имя файла к ручке. имя файла может быть обычным
хост-файл или хост-устройство.

Когда эта функция вызывается перед "запуском" (обычный случай), то при первом вызове
этой функции диск отображается в API как / Dev / ПДД, второй раз как / DEV / SDBи
так далее.

В libguestfs ≥ 1.20 вы также можете вызывать эту функцию после запуска (с некоторыми
ограничения). Это называется «горячим подключением». При «горячем» подключении необходимо указать
«label», чтобы новый диск получил предсказуемое имя. Для получения дополнительной информации см.
«ГОРЯЧЕЕ ЗАГРУЗКА» в гость(3).

При использовании libguestfs необязательно быть пользователем root. Однако вы, очевидно, делаете
требуются достаточные разрешения для доступа к имени файла для любых операций, которые вы хотите
выполнить (т.е. доступ на чтение, если вы просто хотите прочитать изображение или доступ на запись, если вы хотите
изменить изображение).

Этот вызов проверяет, что имя файла существует.

имя файла может быть специальной строкой «/ dev / null». См. «НУЛЕВЫЕ ДИСКИ» в гость(3).

Необязательные аргументы:

"только для чтения"
Если true, то изображение обрабатывается как доступное только для чтения. Записи по-прежнему разрешены, но они
хранятся во временном оверлее моментального снимка, который в конце удаляется. Диск
то, что вы добавляете, не изменяется.

"формат"
Это заставляет формат изображения. Если вы опустите это (или используете "add-drive" или "add-drive-ro")
тогда формат определяется автоматически. Возможные форматы включают "сырые" и
"qcow2".

Автоматическое определение формата открывает перед вами потенциальную дыру в безопасности, когда
работа с ненадежными изображениями в необработанном формате. См. CVE-2010-3851 и RHBZ # 642934.
Указание формата закрывает эту дыру в безопасности.

"я лицо"
Этот редко используемый вариант позволяет имитировать поведение устаревшего "add-drive-
with-if "вызов (qv)

"название"
Имя диска в исходной гостевой системе, например / DEV / SDB. Это используется как подсказка
к процессу проверки гостя, если он доступен.

"метка"
Дайте диску метку. Метка должна быть уникальной короткой строкой с использованием только ASCII
символы "[a-zA-Z]". Как и его обычное имя в API (например, / Dev / ПДД)
диск также будет назван / dev / disk / guestfs / метка.

См. «ЭТИКЕТКИ ДИСКОВ» в гость(3).

"протокол"
Необязательный аргумент протокола может использоваться для выбора альтернативного исходного протокола.

См. Также: «УДАЛЕННОЕ ХРАНЕНИЕ» в гость(3).

"протокол =" файл ""
имя файла интерпретируется как локальный файл или устройство. Это значение по умолчанию, если
необязательный параметр протокола опущен.

"протокол =" ftp "|" ftps "|" http "|" https "|" tftp ""
Подключитесь к удаленному серверу FTP, HTTP или TFTP. Параметр "сервер" также должен быть
поставляется - см. ниже.

См. Также: «FTP, HTTP И TFTP» в гость(3)

"протокол =" блеск ""
Подключитесь к серверу GlusterFS. Также должен быть указан параметр «сервер» -
Смотри ниже.

См. Также: «GLUSTER» в гость(3)

"протокол =" iscsi ""
Подключитесь к серверу iSCSI. Также должен быть указан параметр «сервер» - см.
ниже. Может быть указан параметр «имя пользователя». См. ниже. Секрет"
параметр может быть предоставлен. См. ниже.

См. Также: «ISCSI» в гость(3).

"протокол =" nbd ""
Подключитесь к серверу сетевого блочного устройства. Параметр "сервер" также должен быть
поставляется - см. ниже.

См. Также: «УСТРОЙСТВО БЛОКИРОВКИ СЕТИ» в гость(3).

"протокол =" РБД ""
Подключитесь к серверу Ceph (librbd / RBD). Параметр "сервер" также должен быть
поставляется - см. ниже. Может быть указан параметр «имя пользователя». См. ниже. В
Может быть указан "секретный" параметр. См. ниже.

См. Также: «CEPH» в гость(3).

"протокол =" овчарка ""
Подключитесь к серверу Sheepdog. Также может быть указан параметр «сервер» - см.
внизу.

См. Также: «ОВЧАРКА» в гость(3).

"протокол =" SSH ""
Подключитесь к серверу Secure Shell (ssh).

Параметр «сервер» должен быть указан. Параметр "имя пользователя" может быть
поставляется. См. ниже.

См. Также: «SSH» в гость(3).

"сервер"
Для протоколов, требующих доступа к удаленному серверу, это список серверов.

Протокол Требуемое количество серверов
-------- --------------------------
Список файлов должен быть пустым или параметр вообще не используется
ftp | ftps | http | https | tftp Ровно один
gluster Ровно один
iscsi Ровно один
nbd Ровно один
rbd Ноль или больше
овчарка Ноль или больше
ssh Ровно один

Каждый элемент списка представляет собой строку, определяющую сервер. Строка должна быть в одном из
следующие форматы:

хоста
имя хоста: порт
tcp: имя хоста
tcp: имя хоста: порт
unix: / путь / к / сокету

Если номер порта опущен, то используется стандартный номер порта для протокола.
(См. / etc / services).

"имя пользователя"
Для протоколов ftp, ftps, http, https, iscsi, rbd, ssh и tftp:
это указывает удаленное имя пользователя.

Если не указан, то для ssh используется локальное имя пользователя, и аутентификация не выполняется.
попытался использовать ceph. Но учтите, что иногда это может давать неожиданные результаты, например
при использовании бэкэнда libvirt и если бэкэнд libvirt настроен на запуск
qemu в качестве специального пользователя, например "qemu.qemu". Если сомневаетесь, укажите пульт
имя пользователя, которое вы хотите.

«Секрет»
Только для протокола «rbd» здесь указывается «секрет», который будет использоваться при подключении к
удаленное устройство. Он должен быть в кодировке base64.

Если не указан, то секрет, соответствующий данному имени пользователя, будет найден в
расположение связки ключей по умолчанию, или, если имя пользователя не указано, аутентификация не будет
используемый.

"cachemode"
Выберите, будет ли libguestfs подчиняться операциям синхронизации (безопасно, но медленно) или нет
(небезопасно, но быстро). Возможные значения для этой строки:

"cachemode =" обратная запись ""
Это значение по умолчанию.

Операции записи в API не возвращаются до тех пор, пока записывать(2) звонок завершился через
хост [но обратите внимание, что это не означает, что что-либо записывается на диск].

Операции синхронизации в API, включая неявные синхронизации, вызванные файловой системой
ведение журнала, не вернется до тех пор, пока fdatasync(2) вызов завершен на хосте,
указывает на то, что данные были зафиксированы на диске.

"cachemode =" небезопасно ""
В этом режиме нет никаких гарантий. Libguestfs может кэшировать что угодно и игнорировать
запросы на синхронизацию. Это подходит только для временных или временных дисков.

"отказаться"
Включите или отключите поддержку сброса (или обрезки или отмены сопоставления) на этом диске. Если включено,
такие операции, как "fstrim", смогут отбрасывать / делать тонкие / пробивать отверстия в
базовый файл хоста или устройство.

Возможные параметры сброса:

"discard =" disable ""
Отключить поддержку отмены. Это значение по умолчанию.

"discard =" включить ""
Включить поддержку отмены. Неудача, если сброс невозможен.

"discard =" besteffort ""
Включите поддержку отмены, если возможно, но не выходите из строя, если она не поддерживается.

Поскольку не все серверные модули и не все базовые системы поддерживают удаление, это
хороший выбор, если вы хотите использовать сброс, если это возможно, но не возражайте, если это не так
Работа.

"copyonread"
Логический параметр copyonread включает поддержку копирования при чтении. Это влияет только на
форматы дисков, которые имеют файлы резервных копий, и заставляют читать, чтобы быть сохраненными в оверлее
слой, ускоряющий многократное чтение одной и той же области диска.

По умолчанию - false.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

добавить-драйв-ро
надстройка
add-drive-ro имя файла

Эта функция эквивалентна вызову add-drive-opts с необязательным параметром
"GUESTFS_ADD_DRIVE_OPTS_READONLY" установлено в 1, поэтому диск добавляется только для чтения, с
формат определяется автоматически.

добавить-диск-ро-с-если
добавить-диск-ро-с-если имя файла iface

Это то же самое, что "add-drive-ro", но позволяет указать интерфейс QEMU.
эмуляция для использования во время выполнения.

Эта функция is устарело. В новом коде вместо этого используйте вызов «add-drive».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

добавить-диск-царапина
поцарапать
добавить-диск-размер царапины [имя: ..] [ярлык: ..]

Эта команда добавляет к ручке временный рабочий диск. Параметр "размер" - это
виртуальный размер (в байтах). Изначально рабочий диск пуст (все чтения возвращают нули.
пока не начнешь писать в него). Привод удаляется при закрытии ручки.

Необязательные аргументы «имя» и «метка» передаются в «add-drive».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

добавить диск с если
добавить-диск с-если имя файла iface

Это то же самое, что и "add-drive", но позволяет указать эмуляцию интерфейса QEMU.
использовать во время выполнения.

Эта функция is устарело. В новом коде вместо этого используйте вызов «add-drive».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

авг-ясный
авг-очистить

Установите значение, связанное с «путем», на «NULL». Это то же самое, что и аугтул(1)
"очистить" команду.

конец августа
конец августа

Закройте текущий дескриптор Augeas и освободите все используемые им ресурсы. После этого вызова
вам нужно снова вызвать "aug-init", прежде чем вы сможете использовать какие-либо другие функции Augeas.

авг-defnode
aug-defnode имя expr val

Определяет переменную «имя», значение которой является результатом вычисления «expr».

Если "expr" оценивается как пустой набор узлов, создается узел, что эквивалентно вызову "aug-
set "" expr "," value "." name "будет набором узлов, содержащим этот единственный узел.

В случае успеха это возвращает пару, содержащую количество узлов в наборе узлов, и
логический флаг, если узел был создан.

авг-дефвар
aug-defvar имя expr

Определяет переменную Augeas «name», значение которой является результатом вычисления «expr». Если
«expr» равно NULL, тогда «name» не определено.

В случае успеха это возвращает количество узлов в "expr" или 0, если "expr" оценивается как
то, что не является набором узлов.

авг-получать
aug-получить augpath

Найдите значение, связанное с «путем». Если «путь» соответствует ровно одному узлу, «значение»
возвращается.

авг-иници
корневые флаги aug-init

Создайте новый дескриптор Augeas для редактирования файлов конфигурации. Если были какие-то предыдущие
Дескриптор Augeas, связанный с этим сеансом guestfs, затем закрывается.

Вы должны вызвать это перед использованием любых других команд «aug- *».

«root» - это корень файловой системы. "root" не должен быть NULL, используйте / .

Флаги такие же, как флаги, определенные в , логический or из следующих
целые числа:

"AUG_SAVE_BACKUP" = 1
Сохраните исходный файл с расширением «.augsave».

"AUG_SAVE_NEWFILE" = 2
Сохраняйте изменения в файл с расширением «.augnew» и не перезаписывайте оригинал.
Переопределяет "AUG_SAVE_BACKUP".

«AUG_TYPE_CHECK» = 4
Линзы Typecheck.

Эта опция полезна только при отладке объективов Augeas. Использование этой опции может
требуется дополнительная память для устройства libguestfs. Возможно, вам потребуется установить
Переменная среды "LIBGUESTFS_MEMSIZE" или вызовите "set-memsize".

«AUG_NO_STDINC» = 8
Не используйте стандартный путь загрузки для модулей.

"AUG_SAVE_NOOP" = 16
Сделайте сохранение без операции, просто запишите, что было бы изменено.

"AUG_NO_LOAD" = 32
Не загружайте дерево в "aug-init".

Чтобы закрыть ручку, вы можете вызвать «aug-close».

Чтобы узнать больше об Авгия, см. http://augeas.net/.

авг-вставка
aug-insert augpath label true | false

Создайте новую родственную «метку» для «пути», вставив ее в дерево до или после «пути».
(в зависимости от логического флага «до»).

«путь» должен точно соответствовать одному существующему узлу в дереве, а «метка» должна быть меткой, т.е.
не содержат /, «*» или заканчиваться индексом в квадратных скобках «[N]».

авг-лейбл
aug-метка

Метка (имя последнего элемента) выражения пути Augeas "augpath" возвращается.
«augpath» должен соответствовать ровно одному узлу, иначе эта функция вернет ошибку.

нагружать
нагружать

Загрузите файлы в дерево.

См. "Aug_load" в документации Augeas для получения полной информации о кровавых событиях.

авг-лс
Aug-LS Augpath

Это просто ярлык для перечисления "aug-match" "path / *" и сортировки результирующих узлов.
в алфавитном порядке.

августовский матч
авг-матч авгпат

Возвращает список путей, которые соответствуют выражению пути "path". Возвращенные пути
достаточно квалифицированы, чтобы соответствовать ровно одному узлу в текущем дереве.

авг-мв
авг-mv src dest

Переместите узел "src" в "dest". "src" должен соответствовать ровно одному узлу. "dest" перезаписывается
если он существует.

авг-рм
авг-рм авгпат

Удалите «путь» и всех его дочерних элементов.

В случае успеха возвращается количество удаленных записей.

авг-сохранить
авг-сохранить

Это записывает все ожидающие изменения на диск.

Флаги, переданные в "aug-init", влияют на то, как файлы сохраняются.

августейший набор
aug-set augpath val

Установите значение, связанное с "path", на "val".

В API Augeas можно очистить узел, установив значение NULL. Из-за
надзор в API libguestfs, вы не можете этого сделать с помощью этого вызова. Вместо этого вы должны использовать
звонок "ясное утро".

авг-сетм
базовое значение aug-setm

Измените несколько узлов Augeas за одну операцию. "база" - это выражение соответствия
несколько узлов. «sub» - это выражение пути относительно «base». Все узлы, соответствующие «базе»
найдены, а затем для каждого узла "sub" заменяется на "val". "sub" также может быть "NULL" в
в этом случае модифицируются «базовые» узлы.

Это возвращает количество измененных узлов.

доступен
доступные 'группы ...'

Эта команда используется для проверки наличия некоторых групп функций в
устройство, которое могут предоставить не все сборки устройства libguestfs.

Группы libguestfs и функции, которым они соответствуют, перечислены в
«НАЛИЧИЕ» в гость(3). Вы также можете получить этот список во время выполнения, позвонив
"доступные-все-группы".

Аргумент "группы" представляет собой список имен групп, например: "[" inotify "," augeas "]" будет проверять
на наличие функций Linux inotify и Augeas (файл конфигурации
редактирование) функции.

Команда не возвращает ошибки, если Найти запрошенные группы доступны.

Сбой с ошибкой, если одна или несколько запрошенных групп недоступны в
прибор.

Если в список групп входит неизвестное имя группы, то всегда возникает ошибка.
вернулся.

Ноты:

· «Feature-available» - то же самое, что и этот вызов, но с немного более простым в использовании API:
этот вызов возвращает логическое значение true / false вместо выдачи ошибки.

· Вы должны вызвать "запуск" перед вызовом этой функции.

Причина в том, что мы не знаем, какие группы поддерживаются устройством / демоном.
пока он не будет запущен и его можно будет запросить.

· Если группа функций доступна, это не обязательно означает, что они будут
Работа. Вам все равно придется проверять ошибки при вызове отдельных функций API, даже
если они есть.

· Обычно задачей разработчиков пакетов дистрибутивов является встраивание полной функциональности в
libguestfs приложение. Исходная версия libguestfs, если она собрана из исходников и соответствует всем требованиям.
доволен, все поддержу.

· Этот вызов был добавлен в версии 1.0.80. В предыдущих версиях libguestfs вы
можно было бы предположительно выполнить команду, чтобы узнать,
реализовал это. См. Также «версия».

См. Также «доступная файловая система».

доступные-все-группы
доступные-все-группы

Эта команда возвращает список всех необязательных групп, о которых знает этот демон. Примечание
это возвращает как поддерживаемые, так и неподдерживаемые группы. Чтобы узнать, какие из них может демон
на самом деле вы должны называть «доступный» / «доступный по функциям» для каждого члена
возвращенный список.

См. Также "доступные", "доступные функции" и "НАЛИЧИЕ" в гость(3).

base64-дюйм
base64-in (base64file | -) имя файла

Эта команда загружает данные в кодировке base64 из base64file в имя файла.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

base64-выход
base64-out имя файла (base64file | -)

Эта команда загружает содержимое имя файла, записывая его в локальный файл "base64file"
закодирован как base64.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

блокировать сброс
blkdiscard устройство

Это отбрасывает все блоки на блочном устройстве "устройство", возвращая свободное пространство обратно в
хост.

Эта операция требует поддержки в libguestfs, файловой системе хоста, qemu и хосте.
ядро. Если эта поддержка отсутствует, она может выдать ошибку или даже казаться запущенной, но работает.
ничего такого. Вы также должны установить атрибут «discard» на нижележащем диске (см. «Add-
привод-оптс »).

blkdiscardzeros
blkdiscardzeroes устройство

Этот вызов возвращает истину, если блоки на «устройстве» были отброшены вызовом
«blkdiscard» возвращаются как блоки нулевых байтов при следующем чтении.

Если он возвращает false, то, возможно, отброшенные блоки читаются как устаревшие или случайные.
поле.

Blkid
blkid устройство

Эта команда возвращает атрибуты блочного устройства для "устройства". Следующие поля являются
обычно присутствует в возвращаемом хэше. Могут присутствовать и другие поля.

"UUID"
UUID этого устройства.

"МЕТКА"
Этикетка этого устройства.

"ВЕРСИЯ"
Версия команды blkid.

"ТИП"
Тип файловой системы или RAID этого устройства.

"ИСПОЛЬЗОВАНИЕ"
Использование этого устройства, например «файловая система» или «рейд».

Blockdev-flushbufs
устройство blockdev-flushbufs

Это указывает ядру очистить внутренние буферы, связанные с «устройством».

Это использует Blockdev(8) команда.

блокдев-getbsz
устройство blockdev-getbsz

Это возвращает размер блока устройства.

Примечание: это отличается от обоих размер in Блоки и файловая система блок размер. Также это
настройка реально ничем не используется. Вам, вероятно, не следует использовать его ни для чего.
Файловые системы имеют собственное представление о том, какой размер блока выбрать.

Это использует Blockdev(8) команда.

блокдев-гетро
устройство blockdev-getro

Возвращает логическое значение, указывающее, доступно ли блочное устройство только для чтения (истина, если только для чтения, ложь, если
нет).

Это использует Blockdev(8) команда.

блокдев-getsize64
устройство blockdev-getsize64

Это возвращает размер устройства в байтах.

См. Также «blockdev-getsz».

Это использует Blockdev(8) команда.

Blockdev-Getss
устройство blockdev-getss

Это возвращает размер секторов на блочном устройстве. Обычно 512, но может быть больше для
современные устройства.

(Обратите внимание, это не размер в секторах, используйте для этого "blockdev-getsz").

Это использует Blockdev(8) команда.

Blockdev-Getz
устройство blockdev-getsz

Это возвращает размер устройства в единицах 512-байтовых секторов (даже если размер сектора
не 512 байт ... странно).

См. Также «blockdev-getss» для получения информации о реальном размере сектора устройства и «blockdev-getsize64».
для более полезного размер in байт.

Это использует Blockdev(8) команда.

Blockdev-rereadpt
устройство blockdev-rereadpt

Перечитайте таблицу разделов на "устройстве".

Это использует Blockdev(8) команда.

блокдев-setbsz
blockdev-setbsz размер блока устройства

Этот вызов ничего не делает и никогда ничего не делал из-за ошибки в blockdev. Do не
использование его.

Если вам нужно установить размер блока файловой системы, используйте параметр «размер блока» в «mkfs».

Эта функция is устарело. В новом коде используйте вместо этого вызов «mkfs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

Blockdev-Setra
секторы устройства blockdev-setra

Установить опережение чтения (в секторах размером 512 байт) для устройства.

Это использует Blockdev(8) команда.

Blockdev-Setro
устройство blockdev-setro

Устанавливает блочное устройство с именем "device" только для чтения.

Это использует Blockdev(8) команда.

блокдев-setrw
устройство blockdev-setrw

Устанавливает блочное устройство с именем "device" на чтение-запись.

Это использует Blockdev(8) команда.

btrfs-баланс-отмена
btrfs-balance-cancel путь

Отмените текущий баланс файловой системы btrfs.

btrfs-баланс-пауза
btrfs-balance-pause путь

Приостановите текущий баланс в файловой системе btrfs.

btrfs-баланс-резюме
btrfs-balance-resume путь

Возобновить приостановленный баланс в файловой системе btrfs.

btrfs-баланс-статус
btrfs-balance-status путь

Показать статус текущего или приостановленного баланса в файловой системе btrfs.

btrfs-устройство-добавить
btrfs-device-add 'устройства ...' fs

Добавьте список устройств в «devices» в файловую систему btrfs, смонтированную в «fs». Если
«устройства» - пустой список, ничего не делает.

btrfs-устройство-удалить
btrfs-device-delete 'устройства ...' fs

Удалите «устройства» из файловой системы btrfs, смонтированной в «fs». Если "устройства" пустое
list, это ничего не делает.

btrfs-файловая система-баланс
btrfs-баланс
btrfs-файловая система-баланс fs

Сбалансируйте фрагменты файловой системы btrfs, смонтированные в «fs», на базовых устройствах.

btrfs-файловая система-дефрагментация
btrfs-файловая система-путь дефрагментации [flush: true | false] [compress: ..]

Дефрагментируйте файл или каталог в файловой системе btrfs. compress - это один из zlib или lzo.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

btrfs-файловая система-изменение размера
btrfs-filesystem-resize точка монтирования [размер: N]

Эта команда изменяет размер файловой системы btrfs.

Обратите внимание, что в отличие от других вызовов изменения размера файловая система должна быть смонтирована, а параметр -
точка монтирования, а не устройство (это требование самой btrfs).

Необязательные параметры:

"размер"
Новый размер (в байтах) файловой системы. Если не указано, размер файловой системы изменяется на
максимальный размер.

Смотрите также Btrfs(8).

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

btrfs-файловая система-синхронизация
btrfs-файловая система-синхронизация fs

Принудительная синхронизация в файловой системе btrfs, смонтированной в "fs".

btrfs-fsck
устройство btrfs-fsck [суперблок: N] [ремонт: истина | ложь]

Используется для проверки файловой системы btrfs, "устройство" - это файл устройства, в котором находится файловая система.
хранится.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

btrfs-изображение
btrfs-image 'источник ...' изображение [уровень сжатия: N]

Это используется для создания образа файловой системы btrfs. Все данные будут обнулены, но
метаданные и тому подобное.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

btrfs-qgroup-назначить
btrfs-qgroup-assign src dst путь

Добавьте qgroup «src» к родительской qgroup «dst». Эта команда может сгруппировать несколько qgroups в одну
родительская qgroup разделяет общий предел.

btrfs-qgroup-создать
btrfs-qgroup-создать подтом qgroupid

Создайте группу квот (qgroup) для подтома в «подтоме».

btrfs-qgroup-уничтожить
btrfs-qgroup-destroy subvolume qgroupid

Уничтожить группу квот.

btrfs-qgroup-лимит
btrfs-qgroup-limit размер подтома

Ограничьте размер вложенного тома, путь которого - «подобъем». "размер" может иметь суффикс G, M,
или К.

btrfs-qgroup-удалить
btrfs-qgroup-remove src dst путь

Удалите qgroup «src» из родительской qgroup «dst».

btrfs-qgroup-шоу
btrfs-qgroup-показать путь

Показать все группы квот субтома в файловой системе btrfs, включая их использование.

btrfs-квота-включить
btrfs-quota-enable fs истина | ложь

Включение или отключение поддержки квот субтома для файловой системы, содержащей «путь».

btrfs-quota-пересканировать
btrfs-quota-пересканировать fs

Удалите все номера qgroup и снова просканируйте метаданные с текущей конфигурацией.

btrfs-заменить
btrfs-replace srcdev targetdev mntpoint

Заменить устройство файловой системы btrfs. В действующей файловой системе скопируйте данные в
целевое устройство, которое в настоящее время хранится на исходном устройстве. После завершения
операции исходное устройство стирается и удаляется из файловой системы.

"Targetdev" должен быть того же размера или больше, чем "srcdev". Устройства, которые
в настоящее время смонтированные никогда не могут использоваться в качестве "targetdev".

btrfs-rescue-chunk-recovery
btrfs-rescue-chunk-recovery устройство

Восстановите дерево фрагментов файловой системы btrfs, сканируя устройства одно за другим.

btrfs-спасение-супер-восстановление
btrfs-rescue-super-recovery устройство

Восстанавливайте плохие суперблоки из хороших копий.

btrfs-скраб-отмена
btrfs-scrub-cancel путь

Отмените текущую очистку файловой системы btrfs.

btrfs-скраб-резюме
btrfs-scrub-возобновить путь

Возобновить ранее отмененную или прерванную очистку файловой системы btrfs.

btrfs-скраб-старт
btrfs-scrub-start путь

Читает все данные и метаданные в файловой системе и использует контрольные суммы и дубликаты.
копии из хранилища RAID для выявления и восстановления любых поврежденных данных.

btrfs-скраб-статус
btrfs-scrub-status путь

Показать статус выполнения или завершения очистки файловой системы btrfs.

btrfs-set-посев
btrfs-set-seeding устройство истина | ложь

Включите или отключите функцию заполнения устройства, содержащего файловую систему btrfs.

btrfs-subvolume-создать
btrfs-subvolume-create-opts
btrfs-subvolume-create dest [qgroupid: ..]

Создайте подобтом btrfs. Аргумент "dest" - это целевой каталог и имя
подобъема, в виде / путь / к / назначению / имени. Необязательный параметр qgroupid
представляет qgroup, в которую будет добавлен вновь созданный подобъем.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

btrfs-subvolume-удалить
btrfs-subvolume-удалить подтом

Удалите названный подобъем или снимок btrfs.

btrfs-subvolume-получить-по умолчанию
btrfs-subvolume-get-default фс

Получите вложенный том по умолчанию или снимок файловой системы, смонтированной в «точке монтирования».

btrfs-subvolume-список
btrfs-subvolume-список fs

Перечислите снимки и подобтомы btrfs файловой системы btrfs, смонтированной в "fs".

btrfs-subvolume-set-по умолчанию
btrfs-subvolume-set-default идентификатор fs

Задайте подобъем файловой системы btrfs "fs", который будет монтироваться по умолчанию. Видеть
"btrfs-subvolume-list", чтобы получить список подобъемов.

btrfs-subvolume-шоу
btrfs-subvolume-показать субтом

Вернуть подробную информацию о подобтоме.

btrfs-subvolume-снимок
btrfs-subvolume-моментальный снимок-opts
btrfs-subvolume-snapshot source dest [ro: true | false] [qgroupid: ..]

Создайте снимок подтома btrfs "source". Аргумент "dest" - это пункт назначения
каталог и имя снимка в виде / путь / к / назначению / имени. По умолчанию
вновь созданный снимок доступен для записи, если значение необязательного параметра «ro» истинно, то
создается моментальный снимок, доступный только для чтения. Необязательный параметр «qgroupid» представляет группу qgroup.
к которому будет добавлен только что созданный снимок.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

btrfstune-включить-расширенный-индекс-ссылки
устройство btrfstune-enable-extended-inode-refs

Это позволит включить расширенные ссылки на индексные дескрипторы.

btrfstune-включить-тощие-метаданные-экстент-ссылки
btrfstune-enable-skinny-metadata-extension-refs устройство

Это включает краткие ссылки на экстенты метаданных.

btrfstun-seed
btrfstune-seeding device true | false

Включите заполнение устройства btrfs, это приведет к тому, что fs будет только для чтения, чтобы вы могли использовать его для
строить другие файловые системы.

c-указатель
c-указатель

В привязках языков, отличных от C, это позволяет вам получить базовый указатель C на
ручка (например, "h *"). Цель этого - позволить другим библиотекам взаимодействовать с
libguestfs.

каноническое-имя-устройства
canonical-device-name устройство

Эта служебная функция полезна при отображении пользователю имен устройств. Требуется
количество неправильных имен устройств и возвращает их в согласованном формате:

/ dev / hdX
/ dev / vdX
Они возвращаются как / DEV / SDx. Обратите внимание, что это работает для имен устройств и имен разделов.
Это примерно противоположно алгоритму, описанному в разделе «НАЗВАНИЕ БЛОКОВ УСТРОЙСТВА».
in гость(3).

/ dev / mapper / VG-LV
/ dev / dm-N
Старинная к / dev / VG / LV форма с использованием "lvm-canonical-lv-name".

Остальные строки возвращаются без изменений.

кепка-получить-файл
cap-get-file путь

Эта функция возвращает возможности Linux, привязанные к «пути». Набор возможностей
возвращается в текстовой форме (см. cap_to_text(3 г.)).

Если к файлу не прикреплены возможности, возвращается пустая строка.

cap-set-файл
cap-set-file путь кэп

Эта функция устанавливает возможности Linux, привязанные к «пути». Возможности набора "шапка"
следует передавать в текстовой форме (см. cap_from_text(3 г.)).

путь с учетом регистра
путь с учетом регистра

Это можно использовать для разрешения путей без учета регистра в файловой системе, что является регистром
чувствительный. Вариант использования - разрешить пути, которые вы прочитали из Windows.
файлы конфигурации или реестр Windows на истинный путь.

Команда обрабатывает особенность драйвера файловой системы Linux ntfs-3g (и, вероятно,
другие), то есть, хотя основная файловая система нечувствительна к регистру, драйвер
экспортирует файловую систему в Linux с учетом регистра.

Одним из следствий этого является то, что специальные каталоги, такие как C: \ Windows может появиться как
/ ОКНА or / окна (или другие вещи) в зависимости от точных деталей того, как они были
созданный. В самой Windows это не будет проблемой.

Ошибка или особенность? Вам решать: http://www.tuxera.com/community/ntfs-3g-faq/# posixfilenames1

"case-sensitive-path" пытается разрешить истинный регистр каждого элемента в пути. Это
вернет разрешенный путь, если существует либо полный путь, либо его родительский каталог. Если
родительский каталог существует, но отсутствует полный путь, случай родительского каталога будет
быть правильно решенным, а остальная часть добавлена ​​без изменений. Например, если файл
"/Windows/System32/netkvm.sys" существует:

"путь с учетом регистра" ("/windows/system32/netkvm.sys")
"Windows / System32 / netkvm.sys"

"путь с учетом регистра" ("/ windows / system32 / NoSuchFile")
"Windows / System32 / NoSuchFile"

"путь с учетом регистра" ("/windows/system33/netkvm.sys")
ОШИБКА

Внимание: Из-за вышеуказанного поведения "путь с учетом регистра" не может использоваться для проверки
наличие файла.

Внимание: Эта функция не обрабатывает имена дисков, обратную косую черту и т. Д.

См. Также «realpath».

кошка
кошачья тропа

Верните содержимое файла с именем «путь».

Поскольку в C эта функция возвращает символ "char *", нет возможности различать
символ "\ 0" в файле и конец строки. Для работы с двоичными файлами используйте "read-file"
или функции "загрузки".

контрольная сумма
контрольная сумма csumtype путь

Этот вызов вычисляет контрольную сумму MD5, SHAx или CRC файла с именем «путь».

Тип вычисляемой контрольной суммы задается параметром csumtype, который должен иметь один
следующих значений:

"crc"
Вычислите проверку циклическим избыточным кодом (CRC), указанную POSIX для команды «cksum».

"md5"
Вычислите хеш MD5 (используя программу "md5sum").

"sha1"
Вычислите хэш SHA1 (используя программу sha1sum).

"sha224"
Вычислите хэш SHA224 (используя программу sha224sum).

"sha256"
Вычислите хэш SHA256 (используя программу sha256sum).

"sha384"
Вычислите хэш SHA384 (используя программу sha384sum).

"sha512"
Вычислите хэш SHA512 (используя программу sha512sum).

Контрольная сумма возвращается в виде печатаемой строки.

Чтобы получить контрольную сумму для устройства, используйте «контрольную сумму-устройство».

Чтобы получить контрольные суммы для многих файлов, используйте «контрольную сумму на выходе».

контрольная сумма-устройство
контрольная сумма-устройство csumtype устройство

Этот вызов вычисляет контрольную сумму MD5, SHAx или CRC содержимого устройства с именем
"устройство". Информацию о поддерживаемых типах контрольных сумм см. В команде «контрольная сумма».

контрольные суммы
каталог csumtype контрольных сумм (sumsfile | -)

Эта команда вычисляет контрольные суммы всех обычных файлов в каталог а затем испускает
список этих контрольных сумм в локальный выходной файл "sumsfile".

Это можно использовать для проверки целостности виртуальной машины. Однако быть по-настоящему
secure вы должны обратить внимание на вывод команды контрольной суммы (она использует те,
из GNU coreutils). В частности, когда имя файла не печатается, coreutils использует
специальный синтаксис обратной косой черты. Для получения дополнительной информации см. Информационный файл GNU coreutils.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

CHMOD
путь к режиму chmod

Измените режим (разрешения) «путь» на «режим». Поддерживаются только числовые режимы.

Внимание: При использовании этой команды из guestfish "режим" по умолчанию будет десятичным, если только
вы ставите перед ним префикс 0, чтобы получить восьмеричное число, т.е. используйте 0700, а не 700.

Фактически установленный режим зависит от umask.

Чаун
путь группы владельцев chown

Измените владельца файла на «владелец», а группу - на «группу».

Поддерживаются только числовые uid и gid. Если вы хотите использовать имена, вам нужно будет найти
и самостоятельно проанализируйте файл паролей (поддержка Augeas делает это относительно легко).

четкая настройка бэкэнда
clear-backend-setting имя

Если есть строка настройки серверной части, соответствующая «name» или начинающаяся с «name =», то это
Строка удалена из настроек серверной части.

Этот вызов возвращает количество удаленных строк (может быть 0, 1 или больше.
чем 1).

См. «НАЗАД» в гость(3), «НАСТРОЙКИ ОБРАТНОЙ СТАВКИ» в гость(3).

команду
команда 'аргументы ...'

Этот вызов запускает команду из гостевой файловой системы. Файловая система должна быть смонтирована, и
должна содержать совместимую операционную систему (например, что-то Linux, с таким же или
совместимая архитектура процессора).

Единственный параметр - это список аргументов в стиле argv. Первый элемент - это имя
программа для запуска. Последующие элементы - это параметры. Список не должен быть пустым (т.е.
должен содержать название программы). Обратите внимание, что команда запускается напрямую и не вызывается через
оболочка (см. «ш»).

Возвращаемое значение - это все, что напечатано на стандартный вывод по команде.

Если команда возвращает ненулевой статус выхода, то эта функция возвращает ошибку.
сообщение. Строка сообщения об ошибке является содержимым STDERR из команды.

Переменная окружения $ PATH будет содержать как минимум / USR / бен и / бен. Если вам нужен
программы из другого места, вы должны указать полный путь в первом параметре.

Общие библиотеки и файлы данных, необходимые программе, должны быть доступны в файловых системах.
которые установлены в правильных местах. Ответственность за обеспечение всех
необходимые файловые системы монтируются в нужных местах.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

командные строки
аргументы командной строки ...

Это то же самое, что и «команда», но результат разбивается на список строк.

См. Также: «ш-линии»

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

компрессионное устройство
Compress-device-out ctype device (zdevice | -) [уровень: N]

Эта команда сжимает "устройство" и записывает его в локальный файл "zdevice".

Параметры «ctype» и необязательные параметры «level» имеют то же значение, что и в «compress-out».

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

сжатие
сжатый файл ctype (zfile | -) [уровень: N]

Эта команда сжимает файл и записывает в локальный файл Z-файл.

Используемая программа сжатия управляется параметром ctype. В настоящее время это
включает в себя: «compress», «gzip», «bzip2», «xz» или «lzop». Некоторые типы сжатия могут не поддерживаться
поддерживается определенными сборками libguestfs, и в этом случае вы получите сообщение об ошибке
содержащий подстроку «не поддерживается».

Необязательный параметр level управляет степенью сжатия. Значение и значение по умолчанию для
этот параметр зависит от используемой программы сжатия.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

конфиг
конфигурация hvparam hvvalue

Это можно использовать для добавления произвольных параметров гипервизора формы -парам ценностное .
На самом деле это не совсем произвольно - мы не позволяем вам устанавливать некоторые параметры, которые
будет мешать параметрам, которые мы используем.

Первым символом строки «hvparam» должен быть «-» (тире).

«hvvalue» может иметь значение NULL.

копировать атрибуты
copy-attributes src dest [все: истина | ложь] [режим: истина | ложь] [атрибуты x: истина | ложь] [владение: истина | ложь]

Скопируйте атрибуты пути (который может быть файлом или каталогом) на другой путь.

По умолчанию атрибут «no» копируется, поэтому обязательно укажите любой (или «все» для копирования
все).

Необязательные аргументы указывают, какие атрибуты можно копировать:

"Режим"
Скопируйте часть режима файла из «источника» в «место назначения». Только разрешения UNIX
и биты sticky / setuid / setgid могут быть скопированы.

"xattributes"
Скопируйте расширенные атрибуты Linux (xattrs) из «источника» в «место назначения». Этот флаг
ничего не делает, если linuxxattrs функция недоступна (см. «функция доступна»).

"право собственности"
Скопируйте uid владельца и gid группы "source" в "destination".

"все"
Копировать Найти атрибуты от «источника» до «назначения». Включение этого включает все
другие флаги, если они еще не указаны.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

копировать с устройства на устройство
копия-устройство-устройство src dest [srcoffset: N] [destoffset: N] [size: N] [sparse: true | false] [append: true | false]

Четыре вызова «копировать устройство на устройство», «копировать устройство в файл», «копировать файл на устройство» и
"копировать файл в файл" позволяет копировать из источника (устройство | файл) в место назначения
(устройство | файл).

Могут быть сделаны частичные копии, так как вы можете дополнительно указать исходное смещение, место назначения.
смещение и размер для копирования. Все эти значения указаны в байтах. Если не указано,
смещает оба значения по умолчанию на ноль, а размер по умолчанию - на максимальное копирование, пока
мы попали в конец источника.

Источник и место назначения могут быть одним и тем же объектом. Однако перекрывающиеся регионы не могут быть
скопировал правильно.

Если местом назначения является файл, он создается при необходимости. Если целевой файл не
Достаточно большой, он удлиненный.

Если местом назначения является файл и флаг "добавить" не установлен, то файл назначения
усечено. Если установлен флаг «добавить», то копия добавляется в целевой файл.
Флаг «добавить» в настоящее время не может быть установлен для устройств.

Если установлен флаг "разреженный", при вызове не записываются блоки, содержащие только нули,
что может помочь в некоторых ситуациях, когда резервный диск имеет тонкое предоставление. Обратите внимание, что
если цель уже не обнулена, использование этой опции приведет к некорректному копированию.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

копировать устройство в файл
копирование устройства в файл src dest [srcoffset: N] [destoffset: N] [размер: N] [sparse: true | false] [append: true | false]

См. «Копирование устройства на устройство» для общего обзора этого вызова.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

копировать файл на устройство
скопировать файл на устройство src dest [srcoffset: N] [destoffset: N] [size: N] [sparse: true | false] [append: true | false]

См. «Копирование устройства на устройство» для общего обзора этого вызова.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

копировать файл в файл
копия файла в файл src dest [srcoffset: N] [destoffset: N] [размер: N] [sparse: true | false] [append: true | false]

См. «Копирование устройства на устройство» для общего обзора этого вызова.

Это не функция, которую вы хотите для копирования файлов. Это для копирования блоков внутри
существующие файлы. См. «Cp», «cp-a» и «mv» для общих функций копирования и перемещения файлов.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

размер копии
размер копии исходный размер назначения

Эта команда копирует точно "size" байтов с одного исходного устройства или файла "src" на другое.
устройство назначения или файл "dest".

Обратите внимание, что это не удастся, если источник слишком короткий или если место назначения недостаточно велико.

Эта функция is устарело. В новом коде вместо этого используйте вызов «копирование с устройства на устройство».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

cp
cp src назначения

Это копирует файл из "src" в "dest", где "dest" - либо имя файла назначения, либо
целевой каталог.

ср-а
cp-a src назначения

Это рекурсивно копирует файл или каталог из "src" в "dest" с помощью "cp -a"
команда.

ср-р
cp-r источник назначения

Это рекурсивно копирует файл или каталог из "src" в "dest", используя "cp -rP"
команда.

Большинству пользователей следует вместо этого использовать "cp-a". Эта команда полезна, когда вы не хотите
сохранить разрешения, потому что целевая файловая система не поддерживает их (в первую очередь, когда
запись в файловые системы DOS FAT).

cpio-выход
каталог cpio-out (cpiofile | -) [формат: ..]

Эта команда упаковывает содержимое каталог и загружает его в локальный файл cpiofile.

Необязательный параметр «формат» может использоваться для выбора формата. Только следующие
форматы в настоящее время разрешены:

"новый"
Новый (SVR4) портативный формат. Этот формат совместим с cpio-подобным
формат, используемый ядром Linux для initramfs.

Это формат по умолчанию.

"crc"
Новый (SVR4) переносимый формат с контрольной суммой.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

dd
дд источник назначения

Эта команда копирует с одного исходного устройства или файла "src" на другое целевое устройство или
файл "dest". Обычно вы используете это для копирования на или с устройства или раздела, для
пример для дублирования файловой системы.

Если местом назначения является устройство, оно должно быть такого же размера или больше, чем исходный файл или
устройство, иначе копия не удастся. Эта команда не может делать частичные копии (см. «Копирование-
от устройства к устройству ").

Эта функция is устарело. В новом коде вместо этого используйте вызов «копирование с устройства на устройство».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

индекс устройства
устройство-индекс устройства

Эта функция принимает имя устройства (например, "/ dev / sdb") и возвращает индекс устройства в
список устройств.

Номера индексов начинаются с 0. Указанное устройство должно существовать, например, в виде возвращаемой строки.
из "списка-устройств".

См. Также «список устройств», «часть для разработки».

df
df

Эта команда запускает команду "df", чтобы сообщить об использованном дисковом пространстве.

Эта команда в основном полезна для интерактивных сеансов. это не имел в виду, что вы попробуете
для анализа выходной строки. Используйте "statvfs" из программ.

дф-ч
дф-ч

Эта команда запускает команду «df -h», чтобы сообщить об использованном дисковом пространстве в удобочитаемом формате.

Эта команда в основном полезна для интерактивных сеансов. это не имел в виду, что вы попробуете
для анализа выходной строки. Используйте "statvfs" из программ.

диск-создать
disk-create filename format size [backingfile: ..] [backingformat: ..] [preallocation: ..] [compat: ..] [clusterize: N]

Создайте пустой образ диска с именем имя файла (хост-файл) в формате "формат" (обычно
"сырой" или "qcow2"). Размер равен «размеру» байтов.

Если используется с необязательным параметром «backingfile», то снимок создается поверх
резервный файл. В этом случае «размер» должен быть передан как «-1». Размер снимка
совпадает с размером файла резервной копии, который определяется автоматически. Ты
рекомендуется также передавать «backingformat» для описания формата «backingfile».

If имя файла относится к блочному устройству, то устройство форматируется. "Размер" игнорируется.
поскольку блочные устройства имеют внутренний размер.

Другие необязательные параметры:

"предварительное размещение"
Если формат «необработанный», то он может быть либо «выключен» (или «разреженный»), либо «полный» для создания
разреженный или полностью выделенный файл соответственно. По умолчанию выключено.

Если формат «qcow2», то это может быть «выключено» (или «разрежено»), «метаданные» или «полное».
Предварительное выделение метаданных может быть быстрее при выполнении большого количества операций записи, но при этом требуется больше места.
По умолчанию выключено.

"совместимость"
Только "qcow2": передайте строку 1.1, чтобы использовать расширенный формат qcow2, поддерживаемый qemu ≥
1.1.

"размер кластера"
Только "qcow2": измените размер кластера qcow2. По умолчанию 65536 (байтов), и это
настройка может быть любой степенью двойки от 512 до 2097152.

Обратите внимание, что этот вызов не добавляет новый диск к дескриптору. Возможно, вам потребуется позвонить "add-
привод-оптс »отдельно.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

формат диска
имя файла в формате диска

Обнаружение и возврат формата образа диска, называемого имя файла. имя файла также может быть
хост-устройство и т. д. Если формат изображения определить не удалось, значит "неизвестно"
вернулся.

Обратите внимание, что определение формата диска может быть небезопасным при некоторых обстоятельствах. Видеть
"CVE-2010-3851" в гость(3).

См. Также: «ФОРМАТЫ ИЗОБРАЖЕНИЯ ДИСКОВ» в гость(3)

диск имеет резервный файл
disk-has-backing-file имя файла

Определить и вернуть ли образ диска имя файла есть резервный файл.

Обратите внимание, что при некоторых обстоятельствах обнаружение функций диска может быть небезопасным. Видеть
"CVE-2010-3851" в гость(3).

виртуальный размер диска
имя файла виртуального размера диска

Определить и вернуть виртуальный размер в байтах образа диска, называемого имя файла.

Обратите внимание, что при некоторых обстоятельствах обнаружение функций диска может быть небезопасным. Видеть
"CVE-2010-3851" в гость(3).

dmesg
dmesg

Это возвращает сообщения ядра (вывод "dmesg") от гостевого ядра. Это
иногда полезно для расширенной отладки проблем.

Другой способ получить ту же информацию - включить подробные сообщения с помощью "set-verbose"
или установив переменную среды «LIBGUESTFS_DEBUG = 1» перед запуском программы.

скачать
скачать имя удаленного файла (имя файла | -)

Скачать файл удаленное имя файла и сохраните как имя файла на локальной машине.

имя файла также может быть именованным каналом.

См. Также «загрузить», «кот».

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

загрузка-смещение
смещение загрузки удаленное имя файла (имя файла | -) размер смещения

Скачать файл удаленное имя файла и сохраните как имя файла на локальной машине.

удаленное имя файла считывается для байтов «размер», начиная со «смещения» (эта область должна быть в пределах
файл или устройство).

Обратите внимание, что нет ограничений на объем данных, которые можно загрузить с помощью этого вызова,
в отличие от «pread», и этот вызов всегда считывает полную сумму, если не возникает ошибки.

См. Также «скачать», «преад».

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

тайники
дроп-кеши

Это указывает гостевому ядру удалить свой кеш страниц и / или кеши dentries и inode.
Параметр "whattodrop" сообщает ядру, что именно отбрасывать, см.
http://linux-mm.org/Drop_Caches

Установка "whattodrop" на 3 должна отбросить все.

Это автоматически вызывает синхронизировать(2) перед операцией, так что максимальная гостевая память
освобожден.

du
ду путь

Эта команда запускает команду «du -s», чтобы оценить использование файлового пространства для «пути».

«путь» может быть файлом или каталогом. Если "путь" - это каталог, то оценка включает
содержимое каталога и всех подкаталогов (рекурсивно).

Результат - приблизительный размер в килобайт (т.е. блоки по 1024 байта).

e2fsck
устройство e2fsck [правильно: истина | ложь] [forceall: истина | ложь]

Это запускает проверку файловой системы ext2 / ext3 на "устройстве". Может потребоваться следующее
необязательные аргументы:

"верный"
Автоматическое восстановление файловой системы. Эта опция заставит e2fsck автоматически
исправить любые проблемы с файловой системой, которые можно безопасно исправить без вмешательства человека.

Этот параметр нельзя указывать одновременно с параметром forceall.

"forceall"
Предположим, что на все вопросы дан ответ «да»; позволяет использовать e2fsck без
интерактивно.

Этот вариант нельзя указывать одновременно с «правильным» вариантом.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

e2fsck-f
e2fsck-f устройство

Это запускает "e2fsck -p -f device", т.е. запускает проверку файловой системы ext2 / ext3 на "устройстве",
неинтерактивно (-p), даже если файловая система кажется чистой (-f).

Эта функция is устарело. В новом коде вместо этого используйте вызов «e2fsck».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

эхо-демон
echo-daemon 'слова ...'

Эта команда объединяет список переданных "слов" с одинарными пробелами между ними и
возвращает результирующую строку.

Вы можете использовать эту команду для проверки подключения к демону.

См. Также «ping-daemon».

задать расширенное
путь регулярного выражения egrep

Это вызывает внешнюю программу egrep и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

Эгрепи
путь регулярного выражения egrepi

Это вызывает внешнюю программу «egrep -i» и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

равный
равно файл1 файл2

Это сравнивает два файла file1 и file2 и возвращает истину, если их содержимое точно
равно или ложь в противном случае.

Внешний CMP(1) для сравнения используется программа.

существует
существует путь

Это возвращает "истину" тогда и только тогда, когда существует файл, каталог (или что-то еще) с данным
имя "путь".

См. Также "is-file", "is-dir", "stat".

экстлинукс
каталог extlinux

Установите загрузчик SYSLINUX на устройство, смонтированное на каталог. В отличие от "syslinux"
который требует файловой системы FAT, это можно использовать в файловой системе ext2 / 3/4 или btrfs.

Ассоциация каталог Параметр может быть либо точкой монтирования, либо каталогом внутри точки монтирования.

Вы также должны отметить раздел как «активный» («загрузочный с частичным набором компонентов») и как основной загрузочный.
Запись должна быть установлена ​​(например, с помощью "pwrite-device") на первый сектор всего
диск. Пакет SYSLINUX поставляется с некоторыми подходящими основными загрузочными записями. Увидеть
экстлинукс(1) справочная страница для получения дополнительной информации.

Дополнительная конфигурация может быть предоставлена ​​SYSLINUX, поместив файл с именем
extlinux.conf в файловой системе под каталог. Для получения дополнительной информации о
содержимое этого файла см. экстлинукс(1).

См. Также «syslinux».

сбиваться
путь лен

Эта команда предварительно выделяет файл (содержащий нулевые байты) с именем «path» размером «len» байтов.
Если файл уже существует, он перезаписывается.

Не путайте это с специфичной для guestfish командой "alloc", которая выделяет файл в
хост и присоединяет его как устройство.

Эта функция is устарело. В новом коде вместо этого используйте вызов fallocate64.

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

закрыть64
fallocate64 путь len

Эта команда предварительно выделяет файл (содержащий нулевые байты) с именем «path» размером «len» байтов.
Если файл уже существует, он перезаписывается.

Обратите внимание, что этот вызов выделяет дисковые блоки для файла. Чтобы создать разреженный файл, используйте
"truncate-size" вместо этого.

Устаревший вызов "fallocate" делает то же самое, но по недосмотру разрешен только
Необходимо указать длину 30 бит, эффективно ограничивая максимальный размер создаваемых файлов.
через этот звонок до 1 ГБ.

Не путайте это с специфичными для guestfish командами "alloc" и "sparse", которые создают
файл на хосте и прикрепите его как устройство.

функция доступна
функционально доступные 'группы ...'

Это то же самое, что и «доступно», но в отличие от этого вызова он возвращает просто истину / ложь.
логический результат вместо того, чтобы генерировать исключение, если функция не найдена. Для других
документацию см. "в наличии".

fgrep
путь к шаблону fgrep

Это вызывает внешнюю программу "fgrep" и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

фгрепи
Путь к шаблону fgrepi

Это вызывает внешнюю программу «fgrep -i» и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

файл
Путь файла

В этом вызове используется стандартный файл(1) команда для определения типа или содержимого файла.

Этот вызов также будет прозрачно заглядывать внутрь различных типов сжатых файлов.

Точная команда, которая выполняется, - это «путь к файлу -zb». Обратите внимание, в частности, что имя файла
не добавляется к выходу ( -b опция).

Вывод зависит от вывода базового файл(1) команда, и она может измениться в
будущее способами, не зависящими от нас. Другими словами, выход не гарантируется
АБИ.

См. также: файл(1), «vfs-type», «lstat», «is-file», «is-blockdev» (и т. Д.), «Is-zero».

файловая архитектура
файл-архитектура имя файла

Это определяет архитектуру двоичного файла имя файла, и возвращает его, если известно.

В настоящее время определены следующие архитектуры:

«i386»
Эта строка возвращается для всех 32-битных двоичных файлов i386, i486, i586, i686 независимо от
точные требования к процессору двоичного файла.

«x86_64»
64-битный x86-64.

"sparc"
32-битный SPARC.

"sparc64"
64-битный SPARC V9 и выше.

«ia64»
Интел Итаниум.

"ppc"
32-битный Power PC.

"ppc64"
64-битный Power PC.

"рука"
32-битная ARM.

"aarch64"
64-битная ARM.

В будущем Libguestfs может возвращать другие архитектурные строки.

Функция работает как минимум со следующими типами файлов:

· Многие типы двоичных файлов Un * x и Linux

· Множество типов разделяемых библиотек Un * x и Linux

· Двоичные файлы Windows Win32 и Win64

· Windows Win32 и Win64 DLL

Двоичные файлы Win32 и библиотеки DLL возвращают "i386".

Двоичные файлы Win64 и библиотеки DLL возвращают «x86_64».

· Модули ядра Linux

· Образы initrd в новом стиле для Linux

· Некоторые ядра vmlinuz Linux, отличные от x86

Что он не может делать в настоящее время:

· Статические библиотеки (libfoo.a)

· Linux в старом стиле initrd как сжатая файловая система ext2 (RHEL 3)

· Ядра x86 Linux vmlinuz

Образы x86 vmlinuz (формат bzImage) состоят из 16-, 32- и сжатого кода,
и их ужасно трудно распаковать. Если вы хотите узнать архитектуру ядра,
вместо этого используйте архитектуру связанного initrd или модуля (ов) ядра.

размер файла
файл

Эта команда возвращает размер файл в байтах.

Чтобы получить другую статистику о файле, используйте "stat", "lstat", "is-dir", "is-file" и т. Д.
размер блочных устройств, используйте "blockdev-getsize64".

доступная файловая система
файловая система, доступная для файловой системы

Проверьте, поддерживает ли libguestfs указанную файловую систему. Аргумент "файловая система" - это
имя файловой системы, например "ext3".

Вы должны вызвать "запуск" перед использованием этой команды.

В основном это полезно в качестве отрицательного теста. Если это вернет истину, это не значит, что
конкретная файловая система может быть создана или смонтирована, поскольку файловые системы могут давать сбой для других
такие причины, как более поздняя версия файловой системы или несовместимость
функции или отсутствие нужного mkfs.fs> инструмент.

См. Также "доступные", "доступные функции", "НАЛИЧИЕ" в гость(3).

заполнять
заполнить путь к лену

Эта команда создает новый файл с именем «путь». Первоначальное содержание файла - "len".
октеты «c», где «c» должно быть числом в диапазоне «[0..255]».

Чтобы заполнить файл нулевыми байтами (разреженно), гораздо эффективнее использовать "усечение-
size ". Чтобы создать файл с шаблоном повторяющихся байтов, используйте" fill-pattern ".

заполнить-директор
fill-dir номер каталога

Эта функция, полезная для тестирования файловых систем, создает пустые файлы "nr" в каталоге.
"dir" с именами от 00000000 до "nr-1" (т. е. каждое имя файла состоит из 8 цифр, дополненных
нули).

заливка
узор заливки len path

Эта функция похожа на "fill", за исключением того, что она создает новый файл длиной "len", содержащий
повторяющийся образец байтов в «шаблоне». При необходимости шаблон обрезается.
убедитесь, что длина файла составляет ровно "len" байтов.

найдите
найти каталог

Эта команда рекурсивно выводит список всех файлов и каталогов, начиная с каталог, Это
по сути эквивалентен запуску команды оболочки "find directory -print", но некоторые
постобработка происходит на выходе, как описано ниже.

Это возвращает список строк без любой префикс. Таким образом, если структура каталогов была:

/ tmp / a
/ tmp / b
/ tmp / c / d

затем возвращенный список из "найти" / Tmp будет 4 элемента:

a
b
c
компакт диск

If каталог не является каталогом, то эта команда возвращает ошибку.

Возвращенный список отсортирован.

find0
каталог find0 (файлы | -)

Эта команда рекурсивно выводит список всех файлов и каталогов, начиная с каталог,
размещение результирующего списка во внешнем файле с именем файлов.

Эта команда работает так же, как «найти», за следующими исключениями:

· Полученный список записывается во внешний файл.

· Элементы (имена файлов) в результате разделяются символами «\ 0». Видеть найдите(1) вариант
-print0.

· Список результатов не отсортирован.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

findfs-метка
метка findfs-label

Эта команда ищет файловые системы и возвращает ту, которая имеет заданную метку. An
ошибка возвращается, если такая файловая система не может быть найдена.

Чтобы найти метку файловой системы, используйте "vfs-label".

findfs-uuid
findfs-uuid UUID

Эта команда ищет файловые системы и возвращает ту, которая имеет данный UUID. An
ошибка возвращается, если такая файловая система не может быть найдена.

Чтобы найти UUID файловой системы, используйте "vfs-uuid".

Fsck
fsck fstype устройство

Это запускает проверку файловой системы (fsck) на "устройстве", которое должно иметь тип файловой системы.
"fstype".

Возвращенное целое число - это статус. Видеть Fsck(8) для списка кодов состояния от "fsck".

Ноты:

· Можно суммировать несколько кодов состояния.

· Ненулевой код возврата может означать "успех", например, если ошибки были исправлены.
в файловой системе.

· Проверка или восстановление томов NTFS не поддерживается (linux-ntfs).

Эта команда полностью эквивалентна запуску «fsck -a -t fstype device».

fstream
точка монтирования fstrim [смещение: N] [длина: N] [минимальный свободный объем: N]

Обрежьте свободное пространство в файловой системе, смонтированной на «точке монтирования». Файловая система должна быть
монтируется чтение-запись.

Содержимое файловой системы не изменяется, но любое свободное пространство в файловой системе не изменяется.
"обрезано", то есть передается обратно на хост-устройство, что делает образы дисков более разреженными,
позволяя повторно использовать неиспользуемое пространство в файлах qcow2 и т. д.

Эта операция требует поддержки в libguestfs, смонтированной файловой системе, хосте.
файловая система, qemu и ядро ​​хоста. Если такой поддержки нет, это может привести к ошибке.
или даже кажется, что бежит, но ничего не делает.

См. Также «нулевое свободное пространство». Это немного другая операция, которая превращает свободное пространство
в файловой системе на нули. Допустимо называть "fstrim" вместо или после
называя «нулевое свободное пространство».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

получить-добавить
получить-добавить

Вернуть дополнительные параметры ядра, добавленные в ядро ​​устройства libguestfs.
командная строка.

Если "NULL", то никакие параметры не добавляются.

get-attach-метод
get-attach-метод

Вернуть текущий бэкэнд.

См. "Set-backend" и "BACKEND" в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "get-backend".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

получить автосинхронизацию
получить автосинхронизацию

Получите флаг автосинхронизации.

возвращение
возвращение

Вернуть текущий бэкэнд.

Это свойство дескриптора ранее называлось «методом присоединения».

См. "Set-backend" и "BACKEND" в гость(3).

Get-Backend-установка
имя настройки get-backend

Найдите строку настройки серверной части, которая является либо «name», либо начинается с «name =». Если "имя",
это возвращает строку "1". Если "name =", возвращается часть после знака равенства.
(которая может быть пустой строкой).

Если такой параметр не найден, эта функция выдает ошибку. Ошибка (см. «Последняя ошибка»)
в этом случае будет "ESRCH".

См. «НАЗАД» в гость(3), «НАСТРОЙКИ ОБРАТНОЙ СТАВКИ» в гость(3).

получить-бэкэнд-настройки
получить-бэкэнд-настройки

Вернуть текущие настройки серверной части.

Этот вызов возвращает все строки настроек серверной части. Если вы хотите найти единственный бэкэнд
настройки, см. "get-backend-setting".

См. «НАЗАД» в гость(3), «НАСТРОЙКИ ОБРАТНОЙ СТАВКИ» в гость(3).

Get-cachedir
Get-cachedir

Получите каталог, используемый дескриптором для хранения кеша устройства.

получить прямой
получить прямой

Вернуть флаг прямого режима устройства.

получить-e2attrs
get-e2attrs файл

Это возвращает атрибуты файла, связанные с файл.

Атрибуты представляют собой набор битов, связанных с каждым индексным дескриптором, который влияет на поведение
файл. Атрибуты возвращаются в виде строки букв (описано ниже). В
Строка может быть пустой, что указывает на то, что для этого файла не установлены атрибуты файла.

Эти атрибуты присутствуют только в том случае, если файл находится в файловой системе ext2 / 3/4.
Использование этого вызова для других типов файловых систем приведет к ошибке.

Символы (атрибуты файла) в возвращаемой строке в настоящее время:

'A' При доступе к файлу его время не изменяется.

'a' Файл предназначен только для добавления.

'c' Файл сжат на диске.

'D' (Только каталоги). Изменения в этом каталоге синхронно записываются на диск.

'd' Файл не является кандидатом на резервное копирование (см. дамп(8 г.)).

'E' В файле есть ошибки сжатия.

'e' Файл использует экстенты.

'h' Файл хранит свои блоки в единицах размера блока файловой системы, а не в
сектора.

«I» (Только каталоги). В каталоге используются хешированные деревья.

'i' Файл неизменяемый. Его нельзя изменить, удалить или переименовать. Никакой ссылки не может быть
создан в этот файл.

'j' В файле ведется журнал данных.

's' При удалении файла все его блоки будут обнулены.

'S' Изменения в этом файле синхронно записываются на диск.

'T' (только каталоги). Это подсказка распределителю блоков, который подкаталоги
содержащиеся в этом каталоге должны быть распределены по блокам. Если нет, блок
распределитель попытается сгруппировать подкаталоги вместе.

't' Для файла отключает слияние хвостов. (Не используется восходящими реализациями
доб2.)

'u' При удалении файла его блоки будут сохранены, что позволит восстановить файл.

'X' Можно получить доступ к необработанному содержимому сжатого файла.

'Z' Сжатый файл грязный.

Позже в этот список могут быть добавлены другие атрибуты файлов. Не все атрибуты файла могут быть установлены
для всех типов файлов. Для получения подробной информации обратитесь к болтать(1) справочная страница.

См. Также «set-e2attrs».

Не путайте эти атрибуты с расширенными атрибутами (см. «Getxattr»).

получить-e2generation
get-e2generation файл

Это возвращает создание файла ext2 для файла. Поколение (которое раньше называлось
«версия») - это номер, связанный с индексным дескриптором. Чаще всего используется NFS.
сервера.

Генерация присутствует только тогда, когда файл находится в файловой системе ext2 / 3/4. С использованием
этот вызов для других типов файловых систем приведет к ошибке.

См. "Set-e2generation".

получить-e2label
устройство get-e2label

Это возвращает метку файловой системы ext2 / 3/4 файловой системы на "устройстве".

Эта функция is устарело. В новом коде вместо этого используйте вызов "vfs-label".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

получить-e2uuid
get-e2uuid устройство

Это возвращает UUID файловой системы ext2 / 3/4 файловой системы на "устройстве".

Эта функция is устарело. В новом коде вместо этого используйте вызов "vfs-uuid".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

Get-HV
Get-HV

Вернуть текущий двоичный файл гипервизора.

Это всегда не NULL. Если он еще не был установлен, это вернет qemu по умолчанию.
двоичное имя.

получить-идентификатор
получить-идентификатор

Получите идентификатор дескриптора. См. «Идентификатор-набора».

получить-libvirt-запрошенные учетные-вызов
индекс запроса get-libvirt-учетных данных

Получите запрос (предоставленный libvirt) для запрашиваемых учетных данных "index". Если
libvirt не вызывает проблем, возвращает пустую строку "".

См. «АУТЕНТИФИКАЦИЯ LIBVIRT» в гость(3) для документации и примеров кода.

получить-libvirt-запрошенные учетные данные defresult
get-libvirt-required-credential-defresult индекс

Получить результат по умолчанию (предоставленный libvirt) для запрашиваемых учетных данных "index". Если
libvirt не предоставил результат по умолчанию, он возвращает пустую строку "".

См. «АУТЕНТИФИКАЦИЯ LIBVIRT» в гость(3) для документации и примеров кода.

получить-libvirt-запрошенные учетные-подсказки
индекс запроса get-libvirt-credential-prompt

Получите приглашение (предоставляемое libvirt) для запрашиваемых учетных данных "index". Если libvirt
не предоставил подсказку, возвращается пустая строка "".

См. «АУТЕНТИФИКАЦИЯ LIBVIRT» в гость(3) для документации и примеров кода.

получить-libvirt-запрошенные учетные данные
получить-libvirt-запрошенные учетные данные

Его следует вызывать только во время обратного вызова события для событий типа
"GUESTFS_EVENT_LIBVIRT_AUTH".

Вернуть список учетных данных, запрошенных libvirt. Возможные значения - это подмножество
строки, предоставленные при вызове "set-libvirt-supported-credentials".

См. «АУТЕНТИФИКАЦИЯ LIBVIRT» в гость(3) для документации и примеров кода.

получить мем
получить мем

Это дает размер памяти в мегабайтах, выделенной для гипервизора.

Если "set-memsize" не был вызван для этого дескриптора и если "LIBGUESTFS_MEMSIZE" не было установлено,
тогда это возвращает скомпилированное значение по умолчанию для memsize.

Для получения дополнительной информации об архитектуре libguestfs см. гость(3).

Get-Network
Get-Network

Это возвращает флаг включения сети.

путь
путь

Вернуть текущий путь поиска.

Это всегда не NULL. Если он еще не был установлен, он вернет значение по умолчанию
дорожка.

получить-pgroup
получить-pgroup

Это возвращает флаг группы процессов.

пидор
ПИД-регулятор
пидор

Верните идентификатор процесса гипервизора. Если гипервизор не запущен, то это
вернет ошибку.

Это внутренний вызов, используемый для отладки и тестирования.

Get-программа
Get-программа

Получите название программы. См. «Set-программа».

Get-Qemu
Get-Qemu

Вернуть текущий двоичный файл гипервизора (обычно qemu).

Это всегда не NULL. Если он еще не был установлен, это вернет qemu по умолчанию.
двоичное имя.

Эта функция is устарело. В новом коде вместо этого используйте вызов "get-hv".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

получить-восстановление-процедура
получить-восстановление-процедура

Вернуть флаг включенного процесса восстановления.

Get-selinux
Get-selinux

Это возвращает текущую настройку флага selinux, который передается устройству в
время загрузки. См. "Set-selinux".

Для получения дополнительной информации об архитектуре libguestfs см. гость(3).

Get-smp
Get-smp

Это возвращает количество виртуальных процессоров, назначенных устройству.

получить-tmpdir
получить-tmpdir

Получить каталог, используемый дескриптором для хранения временных файлов.

получить трассировку
получить трассировку

Вернуть флаг трассировки команды.

Get-Umask
Get-Umask

Вернуть текущую маску. По умолчанию umask равен 022, если он не был установлен вызовом
"umask".

многословный
многословный

Это возвращает флаг подробных сообщений.

Getcon
Getcon

Это получает контекст безопасности SELinux демона.

См. Документацию по SELINUX в гость(3) и "setcon"

getxattr
getxattr имя пути

Получите единственный расширенный атрибут из файла «путь» с именем «имя». Этот призыв следует за
символические ссылки. Если вы хотите найти расширенный атрибут для самой символической ссылки, используйте
"lgetxattr".

Обычно лучше получить все расширенные атрибуты из файла за один раз, вызвав
"getxattrs". Однако некоторые реализации файловой системы Linux содержат ошибки и не предоставляют
способ перечислить атрибуты. Для этих файловых систем (особенно ntfs-3g) вы должны знать
имена расширенных атрибутов, которые вы хотите заранее, и вызовите эту функцию.

Значения расширенных атрибутов представляют собой капли двоичных данных. Если нет расширенного атрибута
с именем "name" возвращает ошибку.

См. Также: getxattrs, lgetxattr, Attr(5).

getxattrs
getxattrs путь

Этот вызов перечисляет расширенные атрибуты "пути" к файлу или каталогу.

На уровне системного вызова это комбинация списокxattr(2) и getxattr(2) звонки.

См. Также: «lgetxattrs», Attr(5).

глобус-расширить
шаблон расширения шара

Эта команда ищет все пути, соответствующие "шаблону", в соответствии с подстановочным знаком.
правила расширения, используемые оболочкой.

Если пути не совпадают, возвращается пустой список (примечание: это не ошибка).

Это просто оболочка вокруг C земной шар(3) функция с флагами «GLOB_MARK | GLOB_BRACE». Видеть
эта страница руководства для более подробной информации.

Обратите внимание, что нет эквивалентной команды для раскрытия имени устройства (например, / dev / sd *).
Вместо этого используйте функции "список-устройств", "список-разделов" и т. Д.

GREP
grep-opts
путь к регулярному выражению grep [расширенный: истина | ложь] [фиксированный: истина | ложь] [нечувствительный: истина | ложь] [сжатый: истина | ложь]

Это вызывает внешнюю программу «grep» и возвращает совпадающие строки.

Необязательные флаги:

"расширенный"
Используйте расширенные регулярные выражения. Это то же самое, что и использование -E флаг.

"фиксированный"
Фиксированное совпадение (не используйте регулярные выражения). Это то же самое, что и использование -F флаг.

"нечувствительный"
Учитывать регистр. Это то же самое, что и использование -i флаг.

"сжатый"
Используйте «zgrep» вместо «grep». Это позволяет сжимать или архивировать входные данные.
сжатый.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

грепи
путь к регулярному выражению grepi

Это вызывает внешнюю программу «grep -i» и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

установка grub
grub-install корневое устройство

Эта команда устанавливает GRUB 1 (загрузчик Grand Unified) на "устройство" с корневым
каталог является «корневым».

Ноты:

· В настоящее время в API нет возможности установить grub2, который используется большинством современных
Гости Linux. Можно запустить команду grub2 из гостя, хотя см.
предостережения в "РАБОЧИХ КОМАНДАХ" в гость(3).

· Это использует "grub-install" с хоста. К сожалению, grub не всегда совместим
с самим собой, поэтому это работает только в довольно узких обстоятельствах. Тщательное тестирование с
рекомендуется каждая гостевая версия.

· Если grub-install сообщает об ошибке «В созданном устройстве не найден подходящий диск.
map. "может оказаться, что вам нужно создать /загрузка/жратва/device.map файл сначала, что
содержит сопоставление между именами устройств grub и именами устройств Linux. Это обычно
достаточно для создания файла, содержащего:

(HD0) / dev / vda

заменив / dev / vda с названием установочного устройства.


главный путь

Эта команда возвращает до первых 10 строк файла в виде списка строк.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

голова-н
путь головы и nrlines

Если параметр "nrlines" является положительным числом, он возвращает первые строки "nrlines"
файл "путь".

Если параметр «nrlines» является отрицательным числом, он возвращает строки из файла «path»,
исключая последние строки "nrlines".

Если параметр «nrlines» равен нулю, возвращается пустой список.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

шестнадцатеричного
шестнадцатеричный путь

Это запускает "hexdump -C" по заданному "пути". Результат - понятный для человека, канонический
шестнадцатеричный дамп файла.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

улей-закрыть
улей-закрыть

Закройте текущий дескриптор улья.

Это обертка вокруг улей(3) одноименный звонок.

hivex-коммит
hivex-commit имя файла

Зафиксируйте (запишите) изменения в улье.

Если необязательный имя файла параметр равен нулю, то изменения записываются обратно в тот же
улей, который был открыт. Если это не ноль, то они записываются в альтернативное имя файла.
дается, и оригинальный улей остается нетронутым.

Это обертка вокруг улей(3) одноименный звонок.

hivex-узел-добавить-дочерний
имя родителя hivex-node-add-child

Добавьте дочерний узел к «родительскому» с именем «name».

Это обертка вокруг улей(3) одноименный звонок.

улей-узел-дети
hivex-node-дети nodeh

Вернуть список узлов, которые являются подключами «nodeh».

Это обертка вокруг улей(3) одноименный звонок.

hivex-узел-удалить-ребенка
hivex-узел-удалить-дочерний узел

Удалите «nodeh», при необходимости рекурсивно.

Это обертка вокруг улей(3) одноименный звонок.

hivex-узел-получить-ребенка
hivex-node-get-child имя узла

Верните дочерний элемент «nodeh» с именем «name», если он существует. Это может вернуть значение 0
имя не найдено.

Это обертка вокруг улей(3) одноименный звонок.

улей-узел-получить-значение
ключ узла hivex-node-get-value

Верните значение, прикрепленное к «nodeh», которое имеет имя «ключ», если оно существует. Это может
вернуть 0 означает, что ключ не был найден.

Это обертка вокруг улей(3) одноименный звонок.

имя-узла-улья
имя-узла-hivex nodeh

Верните имя «nodeh».

Это обертка вокруг улей(3) одноименный звонок.

улей-узел-родитель
узел-родитель-узел-улей nodeh

Верните родительский узел «nodeh».

Это обертка вокруг улей(3) одноименный звонок.

hivex-node-set-значение
hivex-node-set-value nodeh ключ t val

Установите или замените одно значение под узлом «nodeh». «Ключ» - это имя, «т» - это
тип, а «val» - это данные.

Это обертка вокруг улей(3) одноименный звонок.

значения узлов улья
значения узла hivex nodeh

Возвращает массив кортежей (ключ, тип данных, данные), прикрепленный к "nodeh".

Это обертка вокруг улей(3) одноименный звонок.

улей-открытый
hivex-open имя_файла [подробный: истина | ложь] [отладка: истина | ложь] [запись: истина | ложь]

Откройте файл куста реестра Windows с именем имя файла. Если был предыдущий улей
дескриптор, связанный с этим сеансом guestfs, затем он закрывается.

Это обертка вокруг улей(3) одноименный звонок.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

корень куста
корень куста

Верните корневой узел улья.

Это обертка вокруг улей(3) одноименный звонок.

ключ-значение-ульи
hivex-значение-ключ значениеh

Возвращает ключевое поле (имя) кортежа (ключ, тип данных, данные).

Это обертка вокруг улей(3) одноименный звонок.

улей-значение-тип
hivex-значение-тип значениеh

Вернуть поле типа данных из кортежа (ключ, тип данных, данные).

Это обертка вокруг улей(3) одноименный звонок.

значение hivex-utf8
hivex-значение-utf8 значениеh

Это вызывает "значение-значение-ульи" (которое возвращает поле данных из кортежа значений улья).
Затем он предполагает, что поле является строкой UTF-16LE, и преобразует результат в UTF-8 (или
если это невозможно, возвращается ошибка).

Это полезно для чтения строк из реестра Windows. Однако это не так
надежный, потому что реестр не является строго типизированным, а поля могут содержать произвольные или
неожиданные данные.

ценность улья
hivex-значение-значение значениеh

Возвращает поле данных кортежа (ключ, тип данных, данные).

Это обертка вокруг улей(3) одноименный звонок.

См. Также: «hivex-value-utf8».

initrd-кошка
initrd-cat initrdpath имя файла

Эта команда распаковывает файл имя файла из файла initrd под названием initrdpath,
имя файла должно быть указано без начальная / характер.

Например, в guestfish вы можете использовать следующую команду для проверки сценария загрузки
(обычно называется /в этом) содержащийся в образе Linux initrd или initramfs:

initrd-кошка / загрузка / initrd- .img init

См. Также "initrd-list".

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

initrd-список
путь к списку initrd

Эта команда выводит список файлов, содержащихся в initrd.

Файлы перечислены без начальных / персонаж. Файлы перечислены в порядке
они появляются (не обязательно в алфавитном порядке). Имена каталогов указаны как отдельные элементы.

Старые ядра Linux (2.4 и ранее) использовали сжатую файловую систему ext2 в качестве initrd. Мы только
поддерживает новый формат initramfs (сжатые файлы cpio).

inotify-добавить-смотреть
маска пути inotify-add-watch

Следите за «путем» для событий, перечисленных в «маске».

Обратите внимание, что если "путь" - это каталог, то отслеживаются события в этом каталоге, но это
приносит не происходят рекурсивно (в подкаталогах).

Примечание для вызывающих абонентов, не использующих C или Linux: события inotify определяются ядром Linux.
ABI и перечислены в /usr/include/sys/inotify.h.

inotify-закрыть
inotify-закрыть

Это закрывает дескриптор inotify, который ранее был открыт inotify_init. Он удаляет
все отслеживает, отбрасывает все ожидающие события и освобождает все ресурсы.

inotify-файлы
inotify-файлы

Эта функция является полезной оболочкой для "inotify-read", которая просто возвращает список
пути к объектам, которых коснулись. Возвращенные имена пути сортируются и
с дедупликацией.

inotify-init
inotify-init maxevents

Эта команда создает новый дескриптор inotify. Подсистема inotify может использоваться для уведомления
события, которые происходят с объектами в гостевой файловой системе.

"maxevents" - максимальное количество событий, которые будут поставлены в очередь между вызовами
"inotify-read" или "inotify-files". Если это передано как 0, тогда ядро ​​(или ранее
set) используется по умолчанию. Для Linux 2.6.29 по умолчанию было 16384 события. За пределами этого предела
ядро отбрасывает события, но записывает тот факт, что оно отбрасывает их, задавая
флаг «IN_Q_OVERFLOW» в возвращаемом списке структур (см. «inotify-read»).

Перед тем, как сгенерировать какие-либо события, вы должны добавить несколько часов во внутренний список наблюдения.
См. «Inotify-add-watch» и «inotify-rm-watch».

События в очереди следует периодически читать, вызывая "inotify-read" (или "inotify-files"
это просто полезная оболочка для "inotify-read"). Если вы не зачитываете события
достаточно часто, тогда вы рискуете переполнить внутреннюю очередь.

После использования дескриптор следует закрыть, вызвав «inotify-close». Это также удаляет любые
смотрит автоматически.

Смотрите также Inotify(7) для обзора интерфейса inotify, представленного в Linux.
Ядро, примерно то, что мы предоставляем через libguestfs. Обратите внимание, что есть один глобальный
Дескриптор inotify для каждого экземпляра libguestfs.

inotify-читать
inotify-читать

Вернуть полную очередь событий, произошедших с момента предыдущего вызова чтения.

Если никаких событий не произошло, возвращается пустой список.

Внимание: Чтобы убедиться, что все события были прочитаны, вы должны вызвать эту функцию
несколько раз, пока он не вернет пустой список. Причина в том, что звонок будет читать события
до максимального размера сообщения между устройством и хостом, а оставшиеся события оставьте в очереди.

inotify-rm-часы
inotify-RM-Watch WD

Удалите ранее определенные часы inotify. См. «Inotify-add-watch».

осмотреть-получить-арку
осмотреть-получить-корень

Это возвращает архитектуру проверенной операционной системы. Возможный возврат
значения перечислены в разделе «файловая архитектура».

Если архитектуру определить не удалось, возвращается строка «unknown».

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-дистрибутив
проверить-получить-корень дистрибутива

Это возвращает дистрибутив (раздачу) проверенной операционной системы.

В настоящее время определены следующие дистрибутивы:

"альпинелинукс"
Альпийский линукс.

"альтлинукс"
АЛЬТ Линукс.

"Archlinux"
Арх Линукс.

"строительный корень"
Дистрибутив, созданный на основе Buildroot, но не тот, который мы специально признаем.

"centos"
ЦенОС.

"циррос"
Чиррос.

"Coreos"
КореОС.

"дебиан"
Debian.

"федора"
Федора.

"freebsd"
FreeBSD.

"фридос"
Бесплатная DOS.

"скромное ПО"
Экономичное ПО.

"gentoo"
Генту.

"linuxmint"
Linux Mint.

"магия"
Магия.

"Мандрива"
Мандрива.

"мэго"
MeeGo.

"netbsd"
НетБСД.

"openbsd"
OpenBSD.

"opensuse"
OpenSUSE.

"oraclelinux"
Оракл линукс.

"пардус"
Пардус.

"pldlinux"
ПЛД Линукс.

"на основе redhat"
Некоторые дистрибутивы, производные от Red Hat.

"Рел"
Ред Хэт Энтерпрайз Линукс.

"научный линукс"
Научный Linux.

"Slackware"
Слэквар.

"sles"
SuSE Linux Enterprise Server или Desktop.

"на основе suse"
Некоторые дистрибутивы, производные от openSuSE.

"ttylinux"
ттайлинукс.

"убунту"
Ubuntu.

«Неизвестный»
Не удалось определить дистрибутив.

"окна"
Винда не имеет дистрибутивов. Эта строка возвращается, если тип ОС
Окон.

Будущие версии libguestfs могут возвращать здесь другие строки. Звонящий должен быть
готовы обрабатывать любую строку.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-диск-сопоставления
корень inspect-get-drive-mappings

Этот вызов полезен для Windows, в которой используется примитивная система назначения букв дисков.
(как C: \) в разделы. Этот API-интерфейс проверки проверяет реестр Windows, чтобы выяснить,
как диски / разделы сопоставляются с буквами дисков, и возвращает хеш-таблицу, как в
пример ниже:

С => / dev / vda2
E => / dev / vdb1
F => / dev / vdc1

Обратите внимание, что ключи - это буквы дисков. Для Windows ключ нечувствителен к регистру и просто
содержит букву диска без обычного разделителя двоеточия.

В будущем мы можем поддерживать другие операционные системы, которые также использовали буквы дисков, но
ключи для них могут быть нечувствительными к регистру и могут быть длиннее 1 символа. За
Например, в OS-9 жесткие диски назывались «h0», «h1» и т. д.

Для гостей Windows в настоящее время возвращаются только сопоставления жестких дисков. Съемные диски (напр.
DVD-ROM) игнорируются.

Для гостей, которые не используют сопоставления дисков, или если сопоставления дисков не могут быть
определено, это возвращает пустую хеш-таблицу.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации. См. Также "inspect-get-
точки монтирования "," проверить-получить-файловые системы ".

проверить-получить-файловые системы
инспектировать-получить-корень файловой системы

Это возвращает список всех файловых систем, которые, по нашему мнению, связаны с этим
Операционная система. Это включает в себя корневую файловую систему, другие обычные файловые системы и не-
смонтированные устройства, такие как разделы подкачки.

В случае виртуальной машины с несколькими загрузками возможно совместное использование файловой системы.
между операционными системами.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации. См. Также "inspect-get-
точки монтирования ".

проверить-получить-формат
корень inspect-get-format

Это возвращает формат проверенной операционной системы. Вы можете использовать его для обнаружения
установить образы, live CD и т.п.

В настоящее время определены следующие форматы:

"установлены"
Это установленная операционная система.

"установщик"
Исследуемый образ диска - это не установленная операционная система, а загрузочный
установочный диск, live CD или аналогичный.

«Неизвестный»
Формат этого образа диска неизвестен.

Будущие версии libguestfs могут возвращать здесь другие строки. Звонящий должен быть
готовы обрабатывать любую строку.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

осмотреть-получить-имя-хоста
осмотреть-получить-имя-хоста корень

Эта функция возвращает имя хоста операционной системы, найденное при проверке
файлы конфигурации гостя.

Если имя хоста не может быть определено, возвращается строка «unknown».

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

осмотреть-получить-значок
inspect-get-icon root [favicon: true | false] [высокое качество: true | false]

Эта функция возвращает значок, соответствующий проверенной операционной системе. Значок
возвращается как буфер, содержащий изображение PNG (при необходимости перекодированный в PNG).

Если получить значок не удалось, эта функция возвращает нулевую длину (не NULL)
буфера. Вызывающие должен проверка для этой случаев.

Libguestfs начнет поиск файла с именем /etc/favicon.png or C: \ etc \ favicon.png
и если он имеет правильный формат, будет возвращено содержимое этого файла. Ты сможешь
отключите значки, передав необязательное логическое значение "favicon" как false (по умолчанию - true).

Если найти фавикон не удается, то ищем в других местах гостя подходящий
значку.

Если необязательное логическое значение "highquality" истинно, то возвращаются только значки высокого качества,
что означает только значки высокого разрешения с альфа-каналом. По умолчанию (false) -
Вернуть любую иконку мы сможем, даже если она некачественная.

Ноты:

· В отличие от большинства других вызовов API проверки, гостевые диски должны быть подключены перед
вы вызываете это, поскольку ему нужно читать информацию из гостевой файловой системы во время
вызов.

· Безопасность: Данные значков поступают от ненадежного гостя и должны обрабатываться
осторожность. Известно, что файлы PNG содержат эксплойты. Убедитесь, что libpng (или другой
соответствующие библиотеки) полностью обновлены, прежде чем пытаться обработать или отобразить значок.

· Возвращаемое изображение PNG может быть любого размера. Возможно, это не квадрат. Libguestfs пытается
вернуть самый крупный значок самого высокого качества из доступных. Приложение должно масштабировать
иконку до нужного размера.

· Для извлечения значков из гостей Windows требуется внешняя программа "wrestool" из
пакет "icoutils" и несколько программ ("bmptopnm", "pnmtopng", "pamcut") из
Пакет "netpbm". Их нужно устанавливать отдельно.

· Значки операционной системы обычно являются товарными знаками. Перед использованием проконсультируйтесь с юристом
товарные знаки в приложениях.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

проверить-получить-основную-версию
инспектировать-получить-основную-версию корень

Это возвращает основной номер версии проверенной операционной системы.

Windows использует согласованную схему управления версиями, которая не отражено в популярной публике
имена, используемые операционной системой. Примечательно, что операционная система, известная как "Windows 7",
действительно версия 6.1 (т.е. основная = 6, второстепенная = 1). Вы можете узнать настоящие версии
соответствующих выпускам Windows, обратившись к Википедии или MSDN.

Если версию определить не удалось, возвращается 0.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-второстепенную-версию
осмотреть-получить-второстепенную-версию корень

Это возвращает дополнительный номер версии проверенной операционной системы.

Если версию определить не удалось, возвращается 0.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации. См. Также "inspect-get-major-
версия".

осмотреть-получить-точки монтирования
корень inspect-get-mountpoints

Это возвращает хэш того, где, по нашему мнению, файловые системы, связанные с этой операционной системой.
система должна быть смонтирована. Абоненты должны принять во внимание, что это в лучшем случае обоснованное предположение.
читая файлы конфигурации, такие как / И т.д. / Fstab. In особый в своих размышлениях что это может
возвращать файловые системы, которые не существуют или не монтируются, и вызывающие должны быть подготовлены
для обработки или игнорирования отказов, если они попытаются их смонтировать.

Каждый элемент в возвращаемой хеш-таблице имеет ключ, который является путем к точке монтирования (например,
/ загрузки) и значение, которое представляет собой файловую систему, которая будет там смонтирована (например,. / Dev / sda1).

Неустановленные устройства, такие как устройства подкачки, не вернулся в этот список.

Для операционных систем, таких как Windows, которые все еще используют буквы дисков, этот вызов будет только
вернуть запись для первого диска, "установленного на" /. Для получения информации о отображении
буквы дисков к разделам, см. "inspect-get-drive-mappings".

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации. См. Также "inspect-get-
файловые системы ".

проверить-получить-пакет-формат
корень inspect-get-package-format

Эта функция и "inspect-get-package-management" возвращают формат пакета и пакет
инструмент управления, используемый проверяемой операционной системой. Например, для Fedora эти
функции будут возвращать "rpm" (формат пакета) и "yum" или "dnf" (управление пакетами).

Это возвращает строку «unknown», если мы не смогли определить формат пакета. or если
Операционная система не имеет реальной системы упаковки (например, Windows).

Возможные строки: «rpm», «deb», «ebuild», «pisi», «pacman», «pkgsrc», «apk».
Будущие версии libguestfs могут возвращать другие строки.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-пакет-управление
инспектировать-получить-управление-пакетами корень

"inspect-get-package-format", и эта функция возвращает формат пакета и пакет
инструмент управления, используемый проверяемой операционной системой. Например, для Fedora эти
функции будут возвращать "rpm" (формат пакета) и "yum" или "dnf" (управление пакетами).

Это возвращает строку «unknown», если мы не смогли определить инструмент управления пакетами. or
если в операционной системе нет реальной системы упаковки (например, Windows).

Возможные строки: «yum», «dnf», «up2date», «apt» (для всех производных Debian),
"portage", "pisi", "pacman", "urpmi", "zypper", "apk". Будущие версии libguestfs могут
вернуть другие строки.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-имя-продукта
осмотреть-получить-имя-продукта корень

Это возвращает название продукта проверенной операционной системы. Название продукта
как правило, некоторая строка произвольной формы, которая может отображаться пользователю, но не должна
разобраны программами.

Если название продукта определить не удалось, возвращается строка «unknown».

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-продукт-вариант
проверить-получить-вариант-продукта корень

Это возвращает вариант продукта проверенной операционной системы.

Для гостей Windows это возвращает содержимое раздела реестра.
"HKLM \ Software \ Microsoft \ Windows NT \ CurrentVersion" "Тип установки", который обычно
строка, такая как «Клиент» или «Сервер» (возможны другие значения). Это можно использовать для
различать потребительские и корпоративные версии Windows с одинаковым номером версии
(например, Windows 7 и Windows 2008 Server имеют версию 6.1, но первая
«Клиент», а последний - «Сервер»).

Для корпоративных гостей Linux, в будущем мы намерены вернуть вариант продукта, такой
как «Рабочий стол», «Сервер» и так далее. Но в настоящее время это не реализовано.

Если вариант продукта определить не удалось, возвращается строка «неизвестно».

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации. См. Также "inspect-get-product-
имя "," проверить-получить-основную-версию ".

осмотреть-получить-укорениться
осмотреть-получить-укорениться

Эта функция - удобный способ получить список корневых устройств, возвращенный из
предыдущий вызов "inspect-os", но без повторения всего процесса проверки.

Это возвращает пустой список, если корневые устройства не были найдены или вызывающий абонент не обнаружил
называется «инспектировать-ос».

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-тип
корень типа inspect-get

Возвращает тип проверенной операционной системы. В настоящее время определены следующие типы:

"Linux"
Любая операционная система на базе Linux.

"окна"
Любая операционная система Microsoft Windows.

"freebsd"
FreeBSD.

"netbsd"
НетБСД.

"openbsd"
OpenBSD.

"препятствие"
GNU / Hurd.

"дос"
MS-DOS, FreeDOS и другие.

"миникс"
МИНИКС.

«Неизвестный»
Не удалось определить тип операционной системы.

Будущие версии libguestfs могут возвращать здесь другие строки. Звонящий должен быть
готовы обрабатывать любую строку.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-окна-текущий-контроль-набор
inspect-get-windows-current-control-set корень

Это возвращает Windows CurrentControlSet проверенного гостя. CurrentControlSet
- это имя раздела реестра, например «ControlSet001».

Этот вызов предполагает, что гость - это Windows и что реестр может быть проверен
осмотр. Если это не так, возвращается ошибка.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-получить-Windows-systemroot
проверить-получить-Windows-systemroot корень

Это возвращает системный корневой каталог Windows проверенного гостя. Systemroot - это каталог
путь, такой как / ОКНА.

Этот вызов предполагает, что гость - это Windows, и что системный корневой каталог может быть определен
осмотр. Если это не так, возвращается ошибка.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

инспектировать вживую
корень inspect-is-live

Если "inspect-get-format" возвращает "installer" (это установочный диск), то возвращается
Значение true, если на диске обнаружено живое изображение.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

инспектировать-является-составным
корень inspect-is-multipart

Если "inspect-get-format" возвращает "installer" (это установочный диск), то возвращается
истина, если диск является частью набора.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить-это-netinst
корень inspect-is-netinst

Если "inspect-get-format" возвращает "installer" (это установочный диск), то возвращается
истина, если на диске установлен сетевой установщик, т.е. не автономный установочный компакт-диск, а тот, который
скорее всего, для завершения установки потребуется доступ к сети.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

проверить список приложений
корень inspect-list-applications

Вернуть список приложений, установленных в операционной системе.

Примечание: Этот вызов работает иначе, чем другие части API проверки. Вы должны
вызовите "inspect-os", затем "inspect-get-mountpoints", затем подключите диски перед вызовом
это. Листинг приложений - значительно более сложная операция, требующая
доступ к полной файловой системе. Также обратите внимание, что в отличие от других вызовов "inspect-get- *"
которые просто возвращают данные, кэшированные в дескрипторе libguestfs, этот вызов фактически читает
части смонтированных файловых систем во время вызова.

Это возвращает пустой список, если код проверки не смог определить список
приложений.

Структура приложения содержит следующие поля:

"Имя приложения"
Название приложения. Для гостей Linux, производных от Red Hat и Debian,
это имя пакета.

"app_display_name"
Отображаемое имя приложения, иногда локализованное на язык установки
гостевая операционная система.

Если недоступен, возвращается как пустая строка "". Вызывающие абоненты должны отображать
что-то может вместо этого использовать "app_name".

"app_epoch"
Для менеджеров пакетов, которые используют эпохи, это содержит эпоху пакета (
целое число). Если недоступен, возвращается как 0.

"app_version"
Строка версии приложения или пакета. Если недоступен, возвращается как
пустая строка "".

"app_release"
Строка выпуска приложения или пакета для менеджеров пакетов, которые его используют.
Если недоступен, возвращается как пустая строка "".

"путь_установки_приложения"
Путь установки приложения (в операционных системах, таких как Windows,
используйте пути установки). Этот путь находится в формате, используемом гостевой операционной системой.
system, это не путь libguestfs.

Если недоступен, возвращается как пустая строка "".

"app_trans_path"
Путь установки переведен в путь libguestfs. Если недоступен, возвращается
как пустая строка "".

"app_publisher"
Имя издателя приложения для менеджеров пакетов, которые его используют. Если
недоступно возвращается как пустая строка "".

"app_url"
URL-адрес (например, исходный URL-адрес) приложения. Если недоступен, он возвращается как
пустой строки "".

"app_source_package"
Для систем упаковки, которые это поддерживают, имя исходного пакета. Если
недоступно возвращается как пустая строка "".

"app_summary"
Краткое (обычно однострочное) описание приложения или пакета. Если недоступен
это возвращается как пустая строка "".

"app_description"
Более подробное описание приложения или пакета. Если недоступен, возвращается
как пустая строка "".

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

Эта функция is устарело. В новом коде используйте вызов "inspect-list-applications2"
.

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

проверить список приложений2
инспектировать-список-приложений2 корень

Вернуть список приложений, установленных в операционной системе.

Примечание: Этот вызов работает иначе, чем другие части API проверки. Вы должны
вызовите "inspect-os", затем "inspect-get-mountpoints", затем подключите диски перед вызовом
это. Листинг приложений - значительно более сложная операция, требующая
доступ к полной файловой системе. Также обратите внимание, что в отличие от других вызовов "inspect-get- *"
которые просто возвращают данные, кэшированные в дескрипторе libguestfs, этот вызов фактически читает
части смонтированных файловых систем во время вызова.

Это возвращает пустой список, если код проверки не смог определить список
приложений.

Структура приложения содержит следующие поля:

"app2_name"
Название приложения. Для гостей Linux, производных от Red Hat и Debian,
это имя пакета.

"app2_display_name"
Отображаемое имя приложения, иногда локализованное на язык установки
гостевая операционная система.

Если недоступен, возвращается как пустая строка "". Вызывающие абоненты должны отображать
что-то может вместо этого использовать "app2_name".

"app2_epoch"
Для менеджеров пакетов, которые используют эпохи, это содержит эпоху пакета (
целое число). Если недоступен, возвращается как 0.

"app2_version"
Строка версии приложения или пакета. Если недоступен, возвращается как
пустая строка "".

"app2_release"
Строка выпуска приложения или пакета для менеджеров пакетов, которые его используют.
Если недоступен, возвращается как пустая строка "".

"app2_arch"
Строка архитектуры приложения или пакета для менеджеров пакетов, которые используют
это. Если недоступен, возвращается как пустая строка "".

"путь_установки_приложения"
Путь установки приложения (в операционных системах, таких как Windows,
используйте пути установки). Этот путь находится в формате, используемом гостевой операционной системой.
system, это не путь libguestfs.

Если недоступен, возвращается как пустая строка "".

"app2_trans_path"
Путь установки переведен в путь libguestfs. Если недоступен, возвращается
как пустая строка "".

"app2_publisher"
Имя издателя приложения для менеджеров пакетов, которые его используют. Если
недоступно возвращается как пустая строка "".

"app2_url"
URL-адрес (например, исходный URL-адрес) приложения. Если недоступен, он возвращается как
пустой строки "".

"app2_source_package"
Для систем упаковки, которые это поддерживают, имя исходного пакета. Если
недоступно возвращается как пустая строка "".

"app2_summary"
Краткое (обычно однострочное) описание приложения или пакета. Если недоступен
это возвращается как пустая строка "".

"app2_description"
Более подробное описание приложения или пакета. Если недоступен, возвращается
как пустая строка "".

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

осматривать
осматривать

Эта функция использует другие функции libguestfs и определенные эвристики для проверки
диск (ы) (обычно диски, принадлежащие виртуальной машине), поиск операционных систем.

Если операционная система не найдена, возвращаемый список будет пустым.

Если была найдена одна операционная система, то возвращается список с одним элементом, который
- это имя корневой файловой системы этой операционной системы. Также возможно для этого
функция для возврата списка, содержащего более одного элемента, что указывает на двойную загрузку или
мультизагрузочная виртуальная машина, каждый элемент которой является корневой файловой системой одного из
операционных систем.

Вы можете передать корневую строку (строки), возвращаемую другим функциям "inspect-get- *", чтобы
запросить дополнительную информацию о каждой операционной системе, такую ​​как название и версия.

Эта функция использует другие возможности libguestfs, такие как «mount-ro» и «umount-all» по порядку.
для монтирования и размонтирования файловых систем и просмотра содержимого. Это следует вызывать без
диски в настоящее время смонтированы. Функция также может использовать Augeas, поэтому любой существующий дескриптор Augeas
будет закрыто.

Эта функция не может расшифровать зашифрованные диски. Вызывающий должен сделать это в первую очередь (предоставив
необходимые ключи), если диск зашифрован.

Пожалуйста, прочтите «ПРОВЕРКА» в гость(3) для получения более подробной информации.

См. Также «список файловых систем».

is-blockdev
is-blockdev-opts
путь is-blockdev [followsymlinks: true | false]

Это возвращает «истину» тогда и только тогда, когда существует блочное устройство с заданным именем «путь».

Если необязательный флаг "followsymlinks" истинен, то символическая ссылка (или цепочка символических ссылок),
заканчивается блочным устройством, также заставляет функцию возвращать истину.

Этот вызов смотрит только на файлы в гостевой файловой системе. Разделы Libguestfs и
блочные устройства (например, / Dev / ПДД) не может использоваться как параметр "путь" этого вызова.

См. Также «stat».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

ис-чардев
is-chardev-opts
is-chardev путь [followsymlinks: true | false]

Это возвращает "истину" тогда и только тогда, когда существует символьное устройство с заданным именем "пути".

Если необязательный флаг "followsymlinks" истинен, то символическая ссылка (или цепочка символических ссылок),
заканчивается на chardev, также заставляет функцию возвращать истину.

См. Также «stat».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

is-config
is-config

Это возвращает истину, если этот дескриптор настраивается (в состоянии «КОНФИГУРАЦИЯ»).

Для получения дополнительной информации о состояниях см. гость(3).

is-реж.
is-dir-opts
is-dir путь [followsymlinks: true | false]

Это возвращает "истину" тогда и только тогда, когда существует каталог с заданным именем "пути". Примечание
что он возвращает false для других объектов, таких как файлы.

Если необязательный флаг "followsymlinks" истинен, то символическая ссылка (или цепочка символических ссылок),
заканчивается каталогом, также заставляет функцию возвращать истину.

См. Также «stat».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

is-fifo
is-fifo-opts
путь is-fifo [followsymlinks: true | false]

Это возвращает "истину" тогда и только тогда, когда существует FIFO (именованный канал) с заданным "путем".
имя.

Если необязательный флаг "followsymlinks" истинен, то символическая ссылка (или цепочка символических ссылок),
заканчивается FIFO, также заставляет функцию возвращать истину.

См. Также «stat».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

is-файл
is-file-opts
путь к is-файлу [followsymlinks: true | false]

Это возвращает «истину» тогда и только тогда, когда существует обычный файл с заданным именем «путь».
Обратите внимание, что он возвращает false для других объектов, таких как каталоги.

Если необязательный флаг "followsymlinks" истинен, то символическая ссылка (или цепочка символических ссылок),
заканчивается файлом, также заставляет функцию возвращать истину.

См. Также «stat».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

is-lv
is-lv устройство

Эта команда проверяет, является ли "устройство" логическим томом, и возвращает истину, если это
дело.

is-сокет
is-socket-opts
путь is-socket [followsymlinks: true | false]

Это возвращает "истину" тогда и только тогда, когда существует сокет домена Unix с заданным "путем".
имя.

Если необязательный флаг "followsymlinks" истинен, то символическая ссылка (или цепочка символических ссылок),
заканчивается сокетом, также заставляет функцию возвращать истину.

См. Также «stat».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

это символическая ссылка
путь is-symlink

Это возвращает "истину" тогда и только тогда, когда существует символическая ссылка с заданным именем "пути".

См. Также «stat».

это-целое-устройство
это устройство в целом

Это возвращает «истину» тогда и только тогда, когда «устройство» относится ко всему блочному устройству. То есть не
раздел или логическое устройство.

ноль
нулевой путь

Это возвращает истину, если файл существует и пуст или содержит все нулевые байты.

нулевое устройство
нулевое устройство

Это возвращает истину, если устройство существует и содержит все нулевые байты.

Обратите внимание, что для больших устройств это может занять много времени.

изоинфо
isoinfo изофайл

Это то же самое, что и "isoinfo-device", за исключением того, что он работает для файла ISO, расположенного внутри
какая-то другая смонтированная файловая система. Обратите внимание, что в общем случае, когда вы добавили ISO
файл как устройство libguestfs, вы должны не назовите это. Вместо этого вы бы назвали isoinfo-
устройство".

isoinfo-устройство
isoinfo-устройство устройство

«устройство» - это устройство ISO. Это возвращает структуру информации, считанную из первичного
дескриптор тома (эквивалент суперблока по ISO) устройства.

Обычно более эффективно использовать изоинфо(1) команда с -d опция на хосте
для анализа файлов ISO, а не через libguestfs.

Для получения информации о полях дескриптора основного тома см.
http://wiki.osdev.org/ISO_9660#The_Primary_Volume_Descriptor

журнал закрытый
журнал закрытый

Закройте ручку журнала.

журнал-получить
журнал-получить

Прочтите текущую запись в журнале. Это возвращает все поля в журнале в виде набора
Пары "(attrname, attrval)". "Attrname" - это имя поля (строка).

«Attrval» - это значение поля (двоичный blob, часто, но не всегда, строка). Пожалуйста
обратите внимание, что attrval - это байтовый массив, не Строка C с завершением \ 0.

Длина данных может быть усечена до порогового значения (см .: «набор-данных-журнала-
порог »,« порог получения-данных-журнала »).

Если вы установите порог данных на неограниченный (0), тогда этот вызов может читать запись журнала
любой размер, т.е. он не ограничен протоколом libguestfs.

журнал-получение-данных-порог
журнал-получение-данных-порог

Получите текущий порог данных для чтения записей журнала. Это подсказка к журналу
что он может обрезать поля данных до этого размера при их чтении (обратите внимание, что он не может
обрезать их). Если это возвращает 0, то порог не ограничен.

См. Также «порог-данных-набора-журнала».

журнал получить в реальном времени использоватьc
журнал получить в реальном времени использоватьc

Получите метку времени текущей записи журнала в реальном времени (настенные часы).

журнал-следующий
журнал-следующий

Перейти к следующей записи журнала. Вы должны вызвать это хотя бы один раз после открытия
обработать, прежде чем вы сможете читать данные.

Возвращенное логическое значение сообщает вам, есть ли еще записи журнала для чтения. "истинный"
означает, что вы можете прочитать следующую запись (например, используя "journal-get"), а "false" означает, что у вас есть
дошел до конца журнала.

журнал-открытый
журнал-открытый каталог

Откройте журнал systemd, расположенный в каталог. Любой ранее открытый дескриптор журнала
закрыты.

Содержание журнала можно прочитать с помощью "journal-next" и "journal-get".

После того, как вы закончили использовать журнал, вы должны закрыть дескриптор, вызвав
"журнал-закрытие".

порог набора данных журнала
порог порогового значения набора данных журнала

Установите порог данных для чтения записей журнала. Это намек для журнала, что он
может обрезать поля данных до этого размера при их чтении (обратите внимание, что он не может
обрезать их). Если вы установите значение 0, то порог не ограничен.

См. Также «journal-get-data-threshold».

журнал-пропуск
пропуск журнала пропустить

Переход вперед («пропуск ≥ 0») или назад («пропуск <0») в журнале.

Возвращается количество фактически пропущенных записей (обратите внимание: «rskip ≥ 0»). Если это не
то же, что и абсолютное значение параметра пропуска ("| skip |"), которое вы передали, тогда это означает
вы достигли конца или начала журнала.

kill-подпроцесс
kill-подпроцесс

Это убивает гипервизор.

Не называй это. См. Вместо этого: "выключение".

Эта функция is устарело. В новом коде используйте вместо этого вызов «выключение».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

запуск
пробег
запуск

Вы должны вызвать это после настройки дескриптора (например, добавления дисков), но перед
выполнение каких-либо действий.

Не вызывайте "запуск" дважды с одной и той же ручки. Хотя ошибки не выдаст (для
исторические причины), точное поведение, когда вы это делаете, точно не определено. Ручки
очень дешевы в изготовлении, поэтому создавайте новые при каждом запуске.

Ичаун
lchown путь к группе владельцев

Измените владельца файла на «владелец», а группу - на «группу». Это похоже на "chown", но если "path"
является символической ссылкой, тогда изменяется сама ссылка, а не цель.

Поддерживаются только числовые uid и gid. Если вы хотите использовать имена, вам нужно будет найти
и самостоятельно проанализируйте файл паролей (поддержка Augeas делает это относительно легко).

ldmtool-create-все
ldmtool-create-все

Эта функция сканирует все блочные устройства в поисках томов динамических дисков Windows и
разделы и создает устройства для любых найденных.

Вызовите «list-ldm-volume» и «list-ldm-partitions», чтобы вернуть все устройства.

Обратите внимание, что вы не обычно нужно вызывать это явно, так как это делается автоматически
во время «запуска». Однако вы можете вызвать эту функцию, если у вас есть горячее подключение.
диски или только что создали динамический диск Windows.

ldmtool-diskgroup-диски
ldmtool-diskgroup-disks дисковая группа

Верните диски в группу динамических дисков Windows. Параметр diskgroup должен быть
GUID группы дисков, один элемент из списка, возвращаемого ldmtool-scan.

ldmtool-diskgroup-имя
ldmtool-diskgroup-name дисковая группа

Возвращает имя группы динамических дисков Windows. Параметр diskgroup должен быть
GUID группы дисков, один элемент из списка, возвращаемого ldmtool-scan.

ldmtool-diskgroup-тома
ldmtool-diskgroup-volume diskgroup

Вернуть тома в группу динамических дисков Windows. Параметр diskgroup должен быть
GUID группы дисков, один элемент из списка, возвращаемого "ldmtool-scan".

ldmtool-удалить все
ldmtool-удалить все

По сути, это противоположность ldmtool-create-all. Удаляет устройство сопоставления
сопоставления для всех томов динамического диска Windows

ldmtool-сканирование
ldmtool-сканирование

Эта функция выполняет поиск динамических дисков Windows. Возвращает список идентификаторов (GUID)
для всех найденных групп дисков. Эти идентификаторы можно передать другим "ldmtool- *"
функции.

Эта функция сканирует все блочные устройства. Чтобы просканировать подмножество блочных устройств, вызовите ldmtool-
сканирующие устройства ".

ldmtool-scan-устройства
ldmtool-scan-devices 'устройства ...'

Эта функция выполняет поиск динамических дисков Windows. Возвращает список идентификаторов (GUID)
для всех найденных групп дисков. Эти идентификаторы можно передать другим "ldmtool- *"
функции.

Параметр «устройства» - это список сканируемых блочных устройств. Если этот список
пусто, сканируются все блочные устройства.

ldmtool-volume-подсказка
ldmtool-volume-hint том дисковой группы

Вернуть поле подсказки тома с именем «volume» в группе дисков с GUID.
"дисковая группа". Это не может быть определено, и в этом случае возвращается пустая строка. В
Поле подсказки часто, но не всегда, является именем диска Windows, например. «E:».

ldmtool-volume-разделы
ldmtool-volume-разделы diskgroup volume

Вернуть список разделов в томе с именем «volume» в группе дисков с GUID.
"дисковая группа".

ldmtool-тип тома
ldmtool-volume-type том дисковой группы

Вернуть тип тома с именем «volume» в группе дисков с идентификатором GUID «diskgroup».

Возможные типы томов, которые могут быть возвращены здесь, включают: «простой», «составной», «полосатый»,
"зеркальный", "raid5". Также могут быть возвращены другие типы.

lgetxattr
lgetxattr имя пути

Получите единственный расширенный атрибут из файла «путь» с именем «имя». Если "путь" является символической ссылкой,
тогда этот вызов возвращает расширенный атрибут из символической ссылки.

Обычно лучше получить все расширенные атрибуты из файла за один раз, вызвав
"getxattrs". Однако некоторые реализации файловой системы Linux содержат ошибки и не предоставляют
способ перечислить атрибуты. Для этих файловых систем (особенно ntfs-3g) вы должны знать
имена расширенных атрибутов, которые вы хотите заранее, и вызовите эту функцию.

Значения расширенных атрибутов представляют собой капли двоичных данных. Если нет расширенного атрибута
с именем "name" возвращает ошибку.

См. Также: «lgetxattrs», «getxattr», Attr(5).

lgetxattrs
lgetxattrs путь

Это то же самое, что и "getxattrs", но если "путь" является символической ссылкой, он возвращает
расширенные атрибуты самой ссылки.

лист-9п
лист-9п

Список всех файловых систем 9p, прикрепленных к гостевой системе. Возвращается список тегов монтирования.

список-устройств
список-устройств

Перечислите все блочные устройства.

Возвращаются полные имена блочных устройств, например. / Dev / ПДД.

См. Также «список файловых систем».

список-диск-метки
список-диск-метки

Если вы добавляете диски с помощью необязательного параметра «label» в «add-drive-opts», вы можете использовать
этот вызов для сопоставления меток дисков с именами необработанных блочных устройств и разделов (например,
/ Dev / ПДД и / Dev / sda1).

Это возвращает хеш-таблицу, где ключи - это метки диска (без домен / dev / disk / guestfs
префикс), а значения являются полными необработанными именами блочного устройства и разделов (например, / Dev / ПДД
и / Dev / sda1).

список-DM-устройств
список-DM-устройств

Список всех устройств сопоставления устройств.

Возвращенный список содержит / dev / mapper /* устройства, например. созданные предыдущим вызовом
"люкс-опен".

Устройства сопоставления устройств, соответствующие логическим томам, являются не вернулся в этот список.
Вызовите «lvs», если хотите вывести список логических томов.

список файловых систем
список файловых систем

Эта команда проверки ищет файловые системы в разделах, блочных устройствах и логических
тома, возвращая список «монтируемых файлов», содержащих файловые системы и их тип.

Возвращаемое значение - хэш, где ключи - это устройства, содержащие файловые системы, а
значения - это типы файловой системы. Например:

"/ dev / sda1" => "ntfs"
"/ dev / sda2" => "ext2"
"/ dev / vg_guest / lv_root" => "ext4"
"/ dev / vg_guest / lv_swap" => "своп"

Ключ не обязательно является блочным устройством. Это также может быть непрозрачная «монтируемая» строка.
который можно передать в «монтировать».

Значение может иметь специальное значение «неизвестно», что означает, что содержимое устройства
неопределенный или пустой. «swap» означает раздел подкачки Linux.

Эта команда запускает другие команды libguestfs, которые могут включать «mount» и «umount», а также
поэтому вы должны использовать это вскоре после запуска и только тогда, когда ничего не смонтировано.

Не все возвращенные файловые системы можно будет смонтировать. В частности, разделы подкачки
вернулся в список. Также эта команда не проверяет, что каждая найденная файловая система
действительный и монтируемый, а некоторые файловые системы могут быть монтируемыми, но требуют специальных параметров.
Не все файловые системы могут принадлежать одной логической операционной системе (используйте "inspect-os" для
ищи операционку).

список-ldm-разделов
список-ldm-разделов

Эта функция возвращает все разделы динамического диска Windows, обнаруженные во время запуска.
Он возвращает список имен устройств.

список-LDM-томов
список-LDM-томов

Эта функция возвращает все тома динамического диска Windows, обнаруженные во время запуска. Это
возвращает список имен устройств.

список-MD-устройств
список-MD-устройств

Список всех устройств Linux md.

список-разделы
список-разделы

Список всех разделов, обнаруженных на всех блочных устройствах.

Возвращаются полные имена устройств раздела, например. / Dev / sda1

Это не возвращает логические тома. Для этого вам нужно будет вызвать «lvs».

См. Также «список файловых систем».

ll
ll каталог

Перечислить файлы в каталог (относительно корневого каталога нет cwd) в
формат 'ls -la'.

Эта команда в основном полезна для интерактивных сеансов. это не имел в виду, что вы попробуете
для анализа выходной строки.

лз
Каталог llz

Перечислить файлы в каталог в формате ls -laZ.

Эта команда в основном полезна для интерактивных сеансов. это не имел в виду, что вы попробуете
для анализа выходной строки.

ln
ln имя целевой ссылки

Эта команда создает жесткую ссылку с помощью команды «ln».

пер-ф
ln-f имя целевой ссылки

Эта команда создает жесткую ссылку с помощью команды «ln -f». В -f опция удаляет
ссылка ("имя ссылки"), если она уже существует.

пер-с
имя целевой ссылки ln-s

Эта команда создает символическую ссылку с помощью команды «ln -s».

пер-сф
ln-sf имя целевой ссылки

Эта команда создает символическую ссылку с помощью команды "ln -sf", -f опция удаляет
ссылка ("имя ссылки"), если она уже существует.

lremovexattr
lremovexattr путь xattr

Это то же самое, что и removexattr, но если путь является символической ссылкой, он удаляет
расширенный атрибут самой ссылки.

ls
ls каталог

Перечислить файлы в каталог (относительно корневого каталога нет cwd). '.'
и «..» не возвращаются, но отображаются скрытые файлы.

ls0
ls0 dir (имена файлов | -)

Эта специализированная команда используется для получения списка имен файлов в каталоге "dir".
Список имен файлов записывается в локальный файл имена файлов (на хосте).

В выходном файле имена файлов разделяются символами «\ 0».

"." и ".." не возвращаются. Имена файлов не отсортированы.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

lsetxattr
lsetxattr xattr val vallen путь

Это то же самое, что и "setxattr", но если "путь" является символической ссылкой, он устанавливает расширенный
атрибут самой ссылки.

lstat
lstat путь

Возвращает информацию о файле для заданного «пути».

Это то же самое, что и "stat", за исключением того, что если "path" является символической ссылкой, то ссылка
stat-ed, а не файл, на который он ссылается.

Это так же, как lstat(2) системный вызов.

Эта функция is устарело. В новом коде используйте вместо этого вызов «lstatns».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

lstatlist
lstatlist путь 'имена ...'

Этот вызов позволяет выполнять операцию "lstat" для нескольких файлов, где все файлы
находятся в каталоге "путь". «имена» - это список файлов из этого каталога.

По возвращении вы получите список структур статистики с взаимно однозначным соответствием "именам".
список. Если какое-либо имя не существует или не может быть зафиксировано, тогда поле "st_ino" этого
структура установлена ​​в "-1".

Этот вызов предназначен для программ, которые хотят эффективно отображать содержимое каталога.
без множества обходов. См. Также «lxattrlist» для аналогичного эффективного вызова
получение расширенных атрибутов.

Эта функция is устарело. В новом коде используйте вместо этого вызов «lstatnslist».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

lstatns
lstatns путь

Возвращает информацию о файле для заданного «пути».

Это то же самое, что и "statns", за исключением того, что если "путь" является символической ссылкой, то ссылка
stat-ed, а не файл, на который он ссылается.

Это так же, как lstat(2) системный вызов.

lstatnslist
lstatnslist путь 'имена ...'

Этот вызов позволяет выполнять операцию "lstatns" для нескольких файлов, где все файлы
находятся в каталоге "путь". «имена» - это список файлов из этого каталога.

По возвращении вы получите список структур статистики с взаимно однозначным соответствием "именам".
список. Если какое-либо имя не существует или не может быть зафиксировано, тогда поле "st_ino" этого
структура установлена ​​в "-1".

Этот вызов предназначен для программ, которые хотят эффективно отображать содержимое каталога.
без множества обходов. См. Также «lxattrlist» для аналогичного эффективного вызова
получение расширенных атрибутов.

Luks-добавить ключ
luks-add-key слот для ключей устройства

Эта команда добавляет новый ключ на "устройство" устройства LUKS. "ключ" - это любой существующий ключ,
используется для доступа к устройству. "newkey" - это новый ключ, который нужно добавить. «слот для ключей» - это слот для ключей
что будет заменено.

Обратите внимание, что если «слот для ключей» уже содержит ключ, то эта команда завершится ошибкой. Вы должны
сначала используйте "luks-kill-slot", чтобы удалить этот ключ.

Эта команда имеет один или несколько параметров ключа или ключевой фразы. Guestfish запросит
эти отдельно.

люкс-близко
устройство luks-close

Это закрывает устройство LUKS, созданное ранее с помощью luks-open или luks-open-ro. В
Параметр "устройство" должен быть именем устройства отображения LUKS (т. е. / dev / mapper / имя карты)
и не имя нижележащего блочного устройства.

люкс-формат
слот для ключей устройства формата luks

Эта команда стирает существующие данные на "устройстве" и форматирует устройство как зашифрованное LUKS.
устройство. «ключ» - это начальный ключ, который добавляется к ключевому слоту «слот». (LUKS поддерживает 8
слоты для ключей, пронумерованные 0-7).

Эта команда имеет один или несколько параметров ключа или ключевой фразы. Guestfish запросит
эти отдельно.

люкс-формат-шифр
luks-format-cipher устройство keylot cipher

Эта команда аналогична "luks-format", но также позволяет вам установить используемый "шифр".

Эта команда имеет один или несколько параметров ключа или ключевой фразы. Guestfish запросит
эти отдельно.

Luks-kill-slot
luks-kill-slot устройство keylot

Эта команда удаляет ключ в ключевом слоте "keylot" с зашифрованного устройства LUKS.
"устройство". "ключ" должен быть одним из другие ключи.

Эта команда имеет один или несколько параметров ключа или ключевой фразы. Guestfish запросит
эти отдельно.

люкс-открытый
luks-open имя карты устройства

Эта команда открывает блочное устройство, зашифрованное согласно стандарту Linux Unified.
Настройка ключей (ЛУКС) стандартная.

«устройство» - это зашифрованное блочное устройство или раздел.

Вызывающий должен указать один из ключей, связанных с блочным устройством LUKS, в поле «key».
Параметр.

Это создает новое блочное устройство под названием / dev / mapper / имя карты. Читает и пишет в это
блочные устройства дешифруются и зашифровываются на нижележащее «устройство» соответственно.

Если это блочное устройство содержит группы томов LVM, то вызов «vgscan» с последующим «vg-
активировать все "сделает их видимыми.

Используйте «list-dm-devices», чтобы вывести список всех устройств сопоставления устройств.

Эта команда имеет один или несколько параметров ключа или ключевой фразы. Guestfish запросит
эти отдельно.

люкс-опен-ро
luks-open-ro имя карты устройства

Это то же самое, что и luks-open, за исключением того, что создается отображение только для чтения.

Эта команда имеет один или несколько параметров ключа или ключевой фразы. Guestfish запросит
эти отдельно.

lvcreate
lvcreate logvol volgroup мегабайты

Это создает логический том LVM под названием "logvol" в группе томов "volgroup" с
«размер» мегабайт.

lvcreate-бесплатно
lvcreate-free logvol volgroup проценты

Создайте логический том LVM с именем / dev / volgroup / logvol, используя приблизительно "процент"%
свободного пространства, оставшегося в группе томов. Наиболее полезно, когда "процент" равен 100.
это создаст максимально возможный LV.

lvm-каноническое-lv-имя
lvm-canonical-lv-name имя_lv

Это преобразует альтернативные схемы именования LV, которые вы можете найти, в канонические.
название. Например, / dev / mapper / VG-LV преобразуется в / dev / VG / LV.

Эта команда возвращает ошибку, если параметр "lvname" не относится к логическому
Объем.

См. Также «is-lv», «canonical-device-name».

lvm-очистить-фильтр
lvm-очистить-фильтр

Это отменяет эффект «lvm-set-filter». LVM сможет видеть каждое блочное устройство.

Эта команда также очищает кеш LVM и выполняет сканирование группы томов.

lvm-удалить все
lvm-удалить все

Эта команда удаляет все логические тома LVM, группы томов и физические тома.

lvm-набор-фильтр
lvm-set-filter 'устройства ...'

Это устанавливает фильтр устройств LVM, чтобы LVM мог "видеть" только блочные устройства.
в списке «устройства» и игнорирует все остальные подключенные блочные устройства.

Если образы дисков содержат повторяющиеся PV или VG, эта команда полезна для того, чтобы LVM
игнорируйте дубликаты, иначе LVM может запутаться. Обратите внимание: есть два типа
возможно дублирование: либо клонированные PV / VG с идентичными UUID; или VG, которые
не клонирован, а просто имеет то же имя. При нормальной работе вы не можете создавать
эта ситуация, но вы можете сделать это вне LVM, например. путем клонирования образов дисков или по битам
возится внутри метаданных LVM.

Эта команда также очищает кеш LVM и выполняет сканирование группы томов.

Вы можете фильтровать целые блочные устройства или отдельные разделы.

Вы не можете использовать это, если какой-либо VG в настоящее время используется (например, содержит смонтированную файловую систему),
даже если вы не фильтруете этот VG.

Удалить
lv удалить устройство

Удалите логический том LVM "устройство", где "устройство" - это путь к LV, например
/ dev / VG / LV.

Вы также можете удалить все LV в группе томов, указав имя VG, / dev / VG.

lvrename
lvrename logvol новыйlogvol

Переименуйте логический том «logvol» с новым именем «newlogvol».

lvresize
lvresize устройство в мегабайтах

Это изменяет размер (увеличивает или уменьшает) существующий логический том LVM до «мегабайт». Когда
при уменьшении, данные в сокращенной части теряются.

без размера
lvresize-free lv процент

Это расширяет существующий логический том "lv" так, что он заполняет "pc"% оставшегося свободного места.
пробел в группе томов. Обычно вы бы назвали это с помощью pc = 100, что расширяет
логический том, используя все оставшееся свободное пространство в группе томов.

LVS
LVS

Перечислите все обнаруженные логические тома. Это эквивалент LVS(8) команда.

Это возвращает список имен устройств логического тома (например. /dev/VolGroup00/LogVol00).

См. также «lvs-full», «list-filesystems».

lvs-полный
lvs-полный

Перечислите все обнаруженные логические тома. Это эквивалент LVS(8) команда. То
«полная» версия включает все поля.

лвууид
lvuid-устройство

Эта команда возвращает UUID «устройства» LVM LV.

lxattrlist
lxattrlist путь 'имена ...'

Этот вызов позволяет вам получить расширенные атрибуты нескольких файлов, где все файлы
в каталоге «путь». "names" - это список файлов из этого каталога.

По возвращении вы получаете плоский список структур xattr, которые должны интерпретироваться последовательно.
Первая структура xattr всегда имеет "attrname" нулевой длины. "attrval" в этой структуре
нулевая длина, чтобы указать, что при выполнении "lgetxattr" для этого файла произошла ошибка, or это C
строка, представляющая собой десятичное число (количество следующих атрибутов для этого файла, которые
может быть "0"). Затем после первой структуры xattr следует ноль или более атрибутов для
первый названный файл. Это повторяется для второго и последующих файлов.

Этот вызов предназначен для программ, которые хотят эффективно отображать содержимое каталога.
не совершая много обходов. См. также "lstatlist" для столь же эффективного вызова
получение стандартной статистики.

макс-диски
макс-диски

Возвращает максимальное количество дисков, которое может быть добавлено к дескриптору (например, с помощью «добавить-диск-опции»
и подобные звонки).

Эта функция была добавлена ​​в libguestfs 1.19.7. В предыдущих версиях libguestfs
предел был 25.

См. «МАКСИМАЛЬНОЕ КОЛИЧЕСТВО ДИСКОВ» в гость(3) для получения дополнительной информации по этой теме.

md-создать
md-create name 'devices...' [missingbitmap:N] [nrdevices:N] [запасной:N] [чанк:N] [уровень:..]

Создайте устройство Linux md (RAID) с именем «имя» на устройствах в списке «устройства».

Необязательные параметры:

"отсутствует битмап"
Растровое изображение отсутствующих устройств. Если бит установлен, это означает, что добавлено отсутствующее устройство.
к массиву. Младший значащий бит соответствует первому устройству в массиве.

В качестве примеров:

Если "devices = ["/dev/sda"]" и "missingbitmap = 0x1", то результирующий массив будет
быть "[ , "/dev/sda"]".

Если "devices = ["/dev/sda"]" и "missingbitmap = 0x2", то результирующий массив будет
быть "["/dev/sda", ]".

По умолчанию это значение равно 0 (нет пропавших устройств).

Длина "devices" + количество битов, установленных в "missingbitmap", должны равняться
"nrdevices" + "запасной".

"нрустройства"
Количество активных RAID-устройств.

Если не установлено, по умолчанию это длина «устройств» плюс количество битов, установленных в
"отсутствует битмап".

"запасной"
Количество запасных устройств.

Если не установлено, по умолчанию это значение равно 0.

"кусок"
Размер чанка в байтах.

«Уровень»
Уровень RAID, который может быть одним из: линейный, raid0, 0, полоса, raid1, 1, зеркало,
raid4, 4, raid5, 5, raid6, 6, raid10, 10. Некоторые из них являются синонимами, а некоторые
уровни могут быть добавлены в будущем.

Если не установлено, по умолчанию используется «raid1».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

md-деталь
мк-деталь мд

Эта команда предоставляет вывод 'mdadm -DY '. Следующие поля обычно
присутствует в возвращаемом хэше. Также могут присутствовать другие поля.

«Уровень»
Уровень рейда устройства MD.

"устройства"
Количество базовых устройств в устройстве MD.

"метаданные"
Используемая версия метаданных.

"уид"
UUID устройства MD.

"название"
Имя устройства MD.

мд-стат
мд-стат мд

Этот вызов возвращает список базовых устройств, составляющих единый программный RAID.
устройство массива "md".

Чтобы получить список программных RAID-устройств, вызовите «list-md-devices».

Каждая возвращаемая структура соответствует одному устройству вместе с дополнительным статусом.
информация:

"mdstat_device"
Имя базового устройства.

"mdstat_index"
Индекс этого устройства в массиве.

"mdstat_flags"
Флаги, связанные с этим устройством. Это строка, содержащая (в произвольном порядке)
ноль или более следующих флагов:

"W" пишут в основном

Устройство "F" неисправно

Устройство "S" является запасным для RAID

замена "Р"

md-стоп
мд-стоп мд

Эта команда деактивирует массив MD с именем «md». Устройство остановлено, но не
уничтожены или обнулены.

MkDir
mkdir путь

Создайте каталог с именем «путь».

mkdir-режим
режим пути mkdir-mode

Эта команда создает каталог, устанавливая начальные разрешения каталога на
"Режим".

Для распространенных файловых систем Linux установлен фактический режим «mode & ~umask &
01777". Файловые системы, отличные от Linux, могут интерпретировать этот режим по-другому.

См. также «mkdir», «umask»

mkdir-p
mkdir-p путь

Создайте каталог с именем «путь», при необходимости создав все родительские каталоги. Это
как команда оболочки «mkdir -p».

мкдтемп
mkdtemp тмпл

Эта команда создает временный каталог. Параметр "tmpl" должен быть полным
путь для имени временного каталога с последними шестью символами "XXXXXX".

Например: "/tmp/myprogXXXXXX" или "/Temp/myprogXXXXXX", второй вариант подходит
для файловых систем Windows.

Возвращается имя созданного временного каталога.

Временный каталог создается с режимом 0700 и принадлежит пользователю root.

Вызывающий отвечает за удаление временного каталога и его содержимого после использования.

См. также: мкдтемп(3)

жена2фс
Устройство mke2fs [счетчик блоков: N] [размер блока: N] [размер фрагмента: N] [группа блоков: N] [количество групп: N] [байтперинод:N] [размер индекса:N] [размер журнала:N] [количество индексов:N] [размер шага: N] [stripewidth:N] [maxonlineresize:N] [reservedblockspercentage:N] [mmpupdateinterval:N] [journaldevice:..] [label:..] [lastmounteddir:..] [creatoros:..] [fstype:. .] [usagetype:..] [uuid:..] [forcecreate:true|false] [writesbandgrouponly:true|false] [lazyitableinit:true|false] [lazyjournalinit:true|false] [testfs:true|false] [ discard:true|false] [quotatype:true|false] [extent:true|false] [filetype:true|false] [flexbg:true|false] [hasjournal:true|false] [journaldev:true|false] [largefile :true|false] [quota:true|false] [resizeinode:true|false] [sparsesuper:true|false] [uninitbg:true|false]

«mke2fs» используется для создания файловой системы ext2, ext3 или ext4 на «устройстве».

Необязательный параметр «blockscount» — это размер файловой системы в блоках. Если опустить это
по умолчанию соответствует размеру «устройство». Обратите внимание, если файловая система слишком мала, чтобы содержать
журнал, "mke2fs" вместо этого автоматически создаст файловую систему ext2.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

mke2fs-J
mke2fs-J журнал устройства блочного типа fstype

Это создает файловую систему ext2/3/4 на «устройстве» с внешним журналом на «журнале». Это
эквивалентно команде:

mke2fs -t fstype -b размер блока -J устройство=

См. также "mke2journal".

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mke2fs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mke2fs-JL
Метка устройства mke2fs-JL fstype blocksize

Это создает файловую систему ext2/3/4 на «устройстве» с внешним журналом в журнале.
с пометкой «этикетка».

См. также "mke2journal-L".

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mke2fs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mke2fs-JU
mke2fs-JU fstype тип блока uuid устройства

Это создает файловую систему ext2/3/4 на «устройстве» с внешним журналом в журнале.
с UUID "uuid".

См. также "mke2journal-U".

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mke2fs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mke2journal
mke2journal блочное устройство

Это создает внешний журнал ext2 на «устройстве». Это эквивалентно команде:

mke2fs -O journal_dev -b блочное устройство

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mke2fs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mke2journal-L
Устройство mke2journal-L для блочных этикеток

Это создает внешний журнал ext2 на «устройстве» с меткой «метка».

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mke2fs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mke2journal-U
mke2journal-U блочное устройство UUID

Это создает внешний журнал ext2 на «устройстве» с UUID «uuid».

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mke2fs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

мкфифо
путь режима mkfifo

Этот вызов создает FIFO (именованный канал) с именем «путь» с режимом «режим». это просто
удобная обертка вокруг "mknod".

В отличие от «mknod», «mode» должен содержат только биты разрешений.

Фактически установленный режим зависит от umask.

МКФС
mkfs-opts
mkfs fstype устройство [размер блока:N] [функции:..] [инод:N] [размер сектора:N] [метка:..]

Эта функция создает файловую систему на «устройстве». Тип файловой системы "fstype", для
пример "ext3".

Необязательные аргументы:

"размер блока"
Размер блока файловой системы. Поддерживаемые размеры блоков зависят от типа файловой системы, но
обычно это 1024, 2048 или 4096 для файловых систем Linux ext2/3.

Для VFAT и NTFS параметр «размер блока» рассматривается как запрошенный размер кластера.

Размеры блоков UFS см. mkfs.ufs(8).

"Особенности"
Это проходит -O параметра внешней программе mkfs.

Для определенных типов файловых систем это позволяет выбирать дополнительные функции файловой системы.
Читать жена2фс(8) и mkfs.ufs(8) для получения более подробной информации.

Вы не можете использовать этот необязательный параметр с файловой системой типа "gfs" или "gfs2".

"инод"
Это проходит -I параметр к внешнему жена2фс(8) программа, которая устанавливает индекс
размер (в настоящее время только для файловых систем ext2/3/4).

"размер сектора"
Это проходит -S параметр для внешнего mkfs.ufs(8) программа, устанавливающая размер сектора
для файловой системы ufs.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

мкфс-б
mkfs-b fstype блочное устройство

Этот вызов похож на "mkfs", но позволяет вам контролировать размер блока файла.
результирующая файловая система. Поддерживаемые размеры блоков зависят от типа файловой системы, но обычно
только 1024, 2048 или 4096.

Для VFAT и NTFS параметр «размер блока» рассматривается как запрошенный размер кластера.

Эта функция is устарело. В новом коде используйте вместо этого вызов «mkfs».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mkfs-btrfs
mkfs-btrfs 'устройства ...' [allocstart:N] [счетчик байтов:N] [тип данных:..] [размер листа:N] [метка:..] [метаданные:..] [размер узла:N] [размер сектора: Н]

Создайте файловую систему btrfs, позволяющую установить все настраиваемые параметры. Для получения дополнительной информации о
необязательные аргументы, см. mkfs.btrfs(8).

Поскольку файловые системы btrfs могут охватывать несколько устройств, для этого требуется непустой список устройств.

Для создания общих файловых систем используйте «mkfs».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

потерянный и найденный
mklost-and-found точка монтирования

Создайте каталог «потерянные + найденные», обычно в корневом каталоге файловой системы ext2/3/4.
"точка монтирования" - это каталог, в котором мы пытаемся создать каталог "потерянные+найденные".

mkmountpoint
путь освобождения mkmountpoint

«mkmountpoint» и «rmmountpoint» — это специализированные вызовы, которые можно использовать для создания дополнительных
точки монтирования перед монтированием первой файловой системы.

Эти звонки только необходимо в некоторых очень ограниченных обстоятельствах, в основном в случае, когда
вы хотите смонтировать вместе несколько несвязанных и/или доступных только для чтения файловых систем.

Например, живые компакт-диски часто содержат гнездо файловых систем «матрешки», внешний ISO-образ.
слой с изображением squashfs внутри, с изображением ext2/3 внутри него. Вы можете распаковать
это выглядит следующим образом в guestfish:

надстройка Fedora-11-i686-Live.iso
пробег
mkmountpoint/cd
mkmountpoint/sqsh
mkmountpoint /ext3fs
смонтировать /dev/sda /cd
цикл монтирования /cd/LiveOS/squashfs.img /sqsh
цикл монтирования /sqsh/LiveOS/ext3fs.img /ext3fs

Внутренняя файловая система теперь распакована под точкой монтирования /ext3fs.

«mkmountpoint» несовместим с «umount-all». Вы можете получить непредвиденные ошибки, если вы
попробуй смешать эти звонки. Безопаснее вручную размонтировать файловые системы и удалить
точки монтирования после использования.

«umount-all» размонтирует файловые системы, сначала сортируя самые длинные пути, чтобы это работало
для ручных точек монтирования вы должны убедиться, что самые внутренние точки монтирования имеют самую длинную
пути, как в приведенном выше примере кода.

Подробнее см. https://bugzilla.redhat.com/show_bug.cgi?id=599503.

Автосинхронизация [см. «set-autosync», это установлено по умолчанию для дескрипторов] может привести к тому, что «umount-all»
вызываться, когда дескриптор закрыт, что также может вызвать эти проблемы.

MKNOD
mknod режим devmajor devminor путь

Этот вызов создает блочные или символьные специальные устройства или именованные каналы (FIFO).

Параметр "mode" должен быть режимом, используя стандартные константы. "майор разработчиков" и
"devminor" - это старший и младший номера устройства, используемые только при создании блока и
характерные специальные устройства.

Обратите внимание, что так же, как MKNOD(2), режим должен быть побитовым ИЛИ с S_IFBLK, S_IFCHR,
S_IFIFO или S_IFSOCK (иначе этот вызов просто создает обычный файл). Эти константы
доступны в стандартных заголовочных файлах Linux, или вы можете использовать «mknod-b», «mknod-c» или
"mkfifo", которые являются обертками вокруг этой команды, которые побитовые ИЛИ в соответствующем
постоянная для вас.

Фактически установленный режим зависит от umask.

мкнод-б
mknod-b режим devmajor devminor path

Этот вызов создает узел блочного устройства с именем «путь» с режимом «режим» и устройством.
мажор/минор "devmajor" и "devminor". Это просто удобная оболочка вокруг "mknod".

В отличие от «mknod», «mode» должен содержат только биты разрешений.

Фактически установленный режим зависит от umask.

mknod-c
mknod-c режим devmajor devminor path

Этот вызов создает узел символьного устройства с именем «путь» с режимом «режим» и основным/младшим устройством.
"девмайор" и "девминор". Это просто удобная оболочка вокруг "mknod".

В отличие от «mknod», «mode» должен содержат только биты разрешений.

Фактически установленный режим зависит от umask.

mkswap
mkswap-opts
устройство mkswap [метка:..] [uuid:..]

Создайте раздел подкачки Linux на «устройстве».

Аргументы опции «label» и «uuid» позволяют вам установить метку и/или UUID нового
поменять раздел.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

mkswap-L
Устройство этикетирования mkswap-L

Создайте раздел подкачки на «устройстве» с меткой «метка».

Обратите внимание, что вы не можете прикрепить метку подкачки к блочному устройству (например. / Dev / ПДД), просто к
раздел. Похоже, это ограничение инструментов ядра или подкачки.

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mkswap».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mkswap-U
mkswap-U uuid-устройство

Создайте раздел подкачки на «устройстве» с UUID «uuid».

Эта функция is устарело. Вместо этого в новом коде используйте вызов «mkswap».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

mkswap-файл
mkswap-путь к файлу

Создайте файл подкачки.

Эта команда просто записывает подпись файла подкачки в существующий файл. Чтобы создать файл
сам, используйте что-то вроде «fallocate».

мктемп
mktemp tmpl [суффикс:..]

Эта команда создает временный файл. Параметр "tmpl" должен быть полным путем для
имя временного каталога с последними шестью символами "XXXXXX".

Например: "/tmp/myprogXXXXXX" или "/Temp/myprogXXXXXX", второй вариант подходит
для файловых систем Windows.

Возвращается имя созданного временного файла.

Временный файл создается в режиме 0600 и принадлежит пользователю root.

Вызывающий отвечает за удаление временного файла после использования.

Если задан необязательный параметр «суффикс», то суффикс (например, «.txt») добавляется к
временное название.

См. также: «mkdtemp».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

Modprobe
modprobe имя модуля

Это загружает модуль ядра в устройство.

монтировать
монтируемая точка монтирования

Смонтируйте гостевой диск в нужное место в файловой системе. Блочные устройства называются / Dev / ПДД,
/ DEV / SDB и так далее, по мере добавления в гостевую. Если эти блочные устройства содержат
разделы, они будут иметь обычные имена (например. / Dev / sda1). Также LVM / dev / VG / LVСтиль
могут использоваться имена или «монтируемые» строки, возвращаемые «list-filesystems» или «inspect-get-
точки монтирования ".

Правила такие же, как и для монтировать(2): Сначала файловая система должна быть смонтирована на / до
другие могут быть установлены. Другие файловые системы могут быть смонтированы только в каталогах, которые уже
существовать.

Смонтированная файловая система доступна для записи, если у нас есть достаточные разрешения на нижележащую
устройства.

До libguestfs 1.13.16 этот вызов неявно добавлял параметры «sync» и «noatime».
Параметр «синхронизация» сильно замедлял запись и вызывал множество проблем у пользователей. Если ваш
программе может потребоваться работа со старыми версиями libguestfs, вместо этого используйте «mount-options»
(используя пустую строку для первого параметра, если вам не нужны никакие параметры).

крепление-9п
mount-9p mounttag точка монтирования [опции:..]

Смонтируйте файловую систему virtio-9p с тегом «mounttag» в каталоге «точка монтирования».

При необходимости к параметрам будет автоматически добавлено значение «trans=virtio». Любые другие варианты
required может быть передан в необязательном параметре «options».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

локальное монтирование
mount-local localmountpoint [только для чтения: true|false] [параметры:..] [cachetimeout:N] [debugcalls:true|false]

Этот вызов экспортирует файловую систему, доступную для libguestfs, в локальную точку монтирования (каталог).
называется «локальная точка монтирования». Обычное чтение и запись в файлы и каталоги под
«localmountpoint» перенаправляются через libguestfs.

Если необязательный флаг «только для чтения» установлен в значение true, то запись в файловую систему возвращает ошибку
"ЭРОФС".

«options» — список параметров монтирования, разделенных запятыми. Видеть гостевая гора(1) для некоторых полезных
настройки.

«cachetimeout» устанавливает время ожидания (в секундах) для кэшированных записей каталога. По умолчанию
60 секунд. Видеть гостевая гора(1) для получения дополнительной информации.

Если для параметра "debugcalls" установлено значение true, то для
каждый вызов FUSE.

Когда «mount-local» возвращается, файловая система готова, но не обрабатывает запросы.
(доступ к нему будет заблокирован). Вы должны вызвать «mount-local-run», чтобы запустить основной цикл.

См. "MOUNT LOCAL" в гость(3) для полной документации.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

монтировать локальный запуск
монтировать локальный запуск

Запустите основной цикл, который переводит вызовы ядра в вызовы libguestfs.

Это следует вызывать только после успешного возврата "mount-local". Звонок не будет
return до тех пор, пока файловая система не будет размонтирована.

Внимание вы должны не делать параллельные вызовы libguestfs для одного и того же дескриптора из другого потока.

Вы можете вызвать это из другого потока, отличного от того, который называется "mount-local", тема
к обычным правилам для потоков и libguestfs (см. "НЕСКОЛЬКО ХРАНИТЕЛЕЙ И НЕСКОЛЬКИХ ПОТОКОВ"
in гость(3 г.)).

См. "MOUNT LOCAL" в гость(3) для полной документации.

крепление-петля
точка монтирования файла цикла монтирования

Эта команда позволяет вам монтировать файл (образ файловой системы в файле) на точке монтирования. это
полностью эквивалентен команде "mount -o точка монтирования файла цикла".

параметры монтирования
опции монтирования mountable mountpoint

Это то же самое, что и команда «mount», но она позволяет вам установить параметры монтирования, как для
домен монтировать(8) -o флаг.

Если параметр "options" является пустой строкой, то никакие опции не передаются (все опции
по умолчанию все, что использует файловая система).

Маунт-Ро
монтируемая точка монтирования mount-ro

Это то же самое, что и команда «mount», но она монтирует файловую систему с доступом только для чтения.
(-o ro) флаг.

монтирование-vfs
Параметры mount-vfs vfstype монтируемая точка монтирования

Это то же самое, что и команда «mount», но она позволяет вам установить оба параметра монтирования.
и vfstype как для монтировать(8) -o и -t флаги.

точки монтирования
точки монтирования

Этот призыв похож на «маунтов». Этот вызов возвращает список устройств. Этот возвращается
хеш-таблица (сопоставление) имени устройства с каталогом, в котором установлено устройство.

крепления
крепления

Это возвращает список смонтированных в данный момент файловых систем. Возвращает список устройств
(например. / Dev / sda1, / dev / VG / LV).

Некоторые внутренние крепления не показаны.

См. также: "точки монтирования"

mv
мв источник назначения

Это перемещает файл из «src» в «dest», где «dest» — либо имя файла назначения, либо
целевой каталог.

См. также: «переименовать».

nr-устройства
nr-устройства

Это возвращает количество добавленных целых блочных устройств. Это то же самое, что и
количество устройств, которые будут возвращены, если вы вызовете «list-devices».

Чтобы узнать максимальное количество устройств, которые можно добавить, позвоните по телефону «max-disks».

ntfs-3g-зонд
ntfs-3g-probe true|false устройство

Эта команда запускает ntfs-3g.probe(8) команда, которая проверяет «устройство» NTFS на наличие
возможность монтажа. (Не все тома NTFS можно смонтировать для чтения и записи, а некоторые нельзя смонтировать
вообще).

"rw" - логический флаг. Установите значение true, если вы хотите проверить, можно ли смонтировать том.
читай пиши. Установите для него значение false, если вы хотите проверить, можно ли смонтировать том только для чтения.

Возвращаемое значение представляет собой целое число, равное 0, если операция завершится успешно, или некоторое ненулевое значение.
стоимость, зафиксированная в ntfs-3g.probe(8) страница руководства.

ntfsclone-in
ntfsclone-in (backupfile|-) устройство

Восстановите «файл резервной копии» (из предыдущего вызова «ntfsclone-out») на «устройство»,
перезапись любого существующего содержимого этого устройства.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

ntfsclone-out
устройство ntfsclone-out (backupfile|-) [только метаданные:true|false] [rescue:true|false] [ignorefscheck:true|false] [preservetimestamps:true|false] [force:true|false]

Потоковая передача «устройства» файловой системы NTFS в локальный файл «backupfile». Формат, используемый для
файл резервной копии представляет собой специальный формат, используемый нтфсклон(8) инструмент.

Если необязательный флаг «только метаданные» установлен, то только метаданные сохраняются, теряя все
пользовательские данные (это полезно для диагностики некоторых проблем с файловой системой).

Необязательные флаги «rescue», «ignorefscheck», «preservetimestamps» и «force»
точные значения, подробно описанные в нтфсклон(8) справочная страница.

Используйте «ntfsclone-in», чтобы восстановить файл обратно на устройство libguestfs.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

нтфсфикс
устройство ntfsfix [clearbadsectors: true | false]

Эта команда исправляет некоторые фундаментальные несоответствия NTFS, сбрасывает файл журнала NTFS,
и планирует проверку согласованности NTFS для первой загрузки Windows.

Это не эквивалент Windows «chkdsk». Оно делает не просканировать файловую систему на наличие
несоответствия.

Необязательный флаг «clearbadsectors» очищает список поврежденных секторов. Это полезно после
клонирование диска с поврежденными секторами на новый диск.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

ntfsизменить размер
ntfsresize-opts
ntfsresize устройство [размер: N] [сила: true|false]

Эта команда изменяет размер файловой системы NTFS, расширяя или уменьшая ее до размера
базовое устройство.

Необязательные параметры:

"размер"
Новый размер (в байтах) файловой системы. Если не указано, размер файловой системы изменяется на
установите контейнер (например, перегородку).

"сила"
Если этот параметр установлен, принудительно изменить размер файловой системы, даже если файловая система
помечен как требующий проверки согласованности.

После операции изменения размера файловая система всегда помечается как требующая согласованности.
проверить (для безопасности). Вы должны загрузиться в Windows, чтобы выполнить эту проверку и очистить
это условие. если ты не поставить опцию "принудительно" тогда не возможно дозвониться
«ntfsresize» несколько раз в одной файловой системе без загрузки Windows
между каждым изменением размера.

Смотрите также ntfsизменить размер(8).

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

ntfsresize-размер
ntfsresize-size размер устройства

Эта команда аналогична «ntfsresize», за исключением того, что она позволяет указать новый размер
(в байтах) явно.

Эта функция is устарело. Вместо этого в новом коде используйте вызов «ntfsresize».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

синтаксический анализ
синтаксический анализ

Разобрать окружение программы и соответствующим образом установить флаги в дескрипторе. Например, если
«LIBGUESTFS_DEBUG=1», тогда в дескрипторе устанавливается флаг «подробный».

Большинство программы do не необходимость в призывают этой. Это делается неявно, когда вы вызываете «создать».

См. "ПЕРЕМЕННЫЕ ОКРУЖАЮЩЕЙ СРЕДЫ" в гость(3) для списка переменных окружения, которые могут
влияют на дескрипторы libguestfs. См. также «guestfs_create_flags» в гость(3) и "анализ-
список окружения».

список-синтаксического анализа
parse-environment-list 'среда...'

Разобрать список строк в аргументе «окружение» и установить флаги в дескрипторе
соответственно. Например, если "LIBGUESTFS_DEBUG=1" является строкой в ​​списке, то
В дескрипторе установлен флаг 'verbose'.

Это то же самое, что и "parse-environment", за исключением того, что он анализирует явный список строк.
вместо среды программы.

частичное добавление
часть добавить устройство prlogex startect endect

Эта команда добавляет раздел на «устройство». Если на устройстве нет таблицы разделов,
сначала вызовите "part-init".

Параметр «prlogex» — это тип раздела. Обычно вы должны передать "p" или
«основной» здесь, но таблицы разделов MBR также поддерживают «l» (или «логический») и «e» (или
«расширенный») типы разделов.

«startsect» и «endsect» — это начало и конец раздела в секторах. "конец"
может быть отрицательным, что означает обратный отсчет от конца диска ("-1" - это
последний сектор).

Создать раздел, охватывающий весь диск, не так-то просто. Используйте «part-disk», чтобы сделать
что.

неполный дел
part-del устройство partnum

Эта команда удаляет раздел с номером «partnum» на «устройстве».

Обратите внимание, что в случае разделения MBR при удалении расширенного раздела также удаляются все
содержащиеся в нем логические разделы.

неполный диск
частично дисковое устройство

Эта команда представляет собой просто комбинацию «part-init», за которой следует «part-add», для создания
один основной раздел, охватывающий весь диск.

«parttype» — это тип таблицы разделов, обычно «mbr» или «gpt», но другие возможные значения
описаны в "part-init".

частично загружаемый
часть-получить-загрузочное устройство partnum

Эта команда возвращает значение true, если раздел «partnum» на «устройстве» имеет загрузочный флаг.
комплект.

См. также «часть-набор-загрузочная».

часть-получить-gpt-руководство
part-get-gpt-guid устройство partnum

Возвращает GUID пронумерованного раздела GPT "partnum".

часть-получить-тип gpt
part-get-gpt-type устройство partnum

Возвращает тип GUID пронумерованного раздела GPT "partnum". Для разделов MBR возвращайте
соответствующий GUID, соответствующий типу MBR. Поведение не определено для другого раздела
типы.

часть-получить-MBR-идентификатор
part-get-mbr-id устройство partnum

Возвращает байт типа MBR (также известный как байт идентификатора) из пронумерованного раздела.
"партнум".

Обратите внимание, что только разделы MBR (старый стиль DOS) имеют байты типа. Вы получите неопределенность
результаты для других типов таблиц разделов (см. "part-get-parttype").

часть-получить-mbr-часть-типа
part-get-mbr-part-type устройство partnum

Это возвращает тип раздела раздела MBR с номером «partnum» на устройстве «device».

Он возвращает «основной», «логический» или «расширенный».

часть-получить-имя
part-get-name устройство partnum

Это получает имя раздела в разделе с номером «partnum» на устройстве «device». Примечание
что разделы нумеруются с 1.

Имя раздела можно прочитать только для определенных типов таблиц разделов. Это работает на
"gpt", но не на разделах "mbr".

часть-получить-частьтипа
устройство типа часть-получить-часть

Эта команда проверяет таблицу разделов на «устройстве» и возвращает тип таблицы разделов.
(формат) используется.

Общие возвращаемые значения включают: «msdos» (таблица разделов MBR в стиле DOS/Windows), «gpt» (
таблицу разделов в стиле GPT/EFI). Возможны и другие значения, хотя и необычные. См. «часть-
init" для полного списка.

часть инициализации
устройство part-init

Это создает пустую таблицу разделов на «устройстве» одного из перечисленных типов разделов.
ниже. Обычно «parttype» должен быть либо «msdos», либо «gpt» (для больших дисков).

Изначально разделов нет. После этого вы должны вызывать «part-add» для каждого
требуется раздел.

Возможные значения для «parttype»:

EFI
GPT Таблица разделов Intel EFI/GPT.

Это рекомендуется для >= 2 ТБ разделов, доступ к которым будет осуществляться из Linux и Intel.
на основе Mac OS X. Он также имеет ограниченную обратную совместимость с форматом «mbr».

MBR
MSDOS
Стандартный формат основной загрузочной записи ПК (MBR), используемый MS-DOS и Windows. Этот
тип раздела будет только работает для устройств размером до 2 ТБ. Для больших дисков мы
рекомендуем использовать "gpt".

Другие типы таблиц разделов, которые могут работать, но не поддерживаются, включают:

AIX Метки дисков AIX.

Amiga
RDB Формат Amiga "Rigid Disk Block".

BSD Метки дисков BSD.

DASD
DASD, используемый на мейнфреймах IBM.

DVH Тома MIPS/SGI.

макинтош Старый формат разделов Mac. Современные Mac используют «gpt».

pc98
Формат NEC PC-98, по-видимому, распространенный в Японии.

солнце Этикетки для солнечных дисков.

список запчастей
устройство с неполным списком

Эта команда анализирует таблицу разделов на «устройстве» и возвращает список разделов.
найдено.

Поля в возвращаемой структуре:

часть_номер
Номер раздела, считая от 1.

часть_начало
Начало раздела in байт. Чтобы получить секторы, вы должны разделить на устройство
размер сектора, см. «blockdev-getss».

часть_конец
Конец раздела в байтах.

часть_размер
Размер раздела в байтах.

часть набора-загрузочный
part-set-bootable устройство partnum true|false

Это устанавливает загрузочный флаг для раздела с номером «partnum» на устройстве «device». Обратите внимание, что
разделы нумеруются с 1.

Флаг загрузки используется некоторыми операционными системами (в частности, Windows), чтобы определить, какие
раздел для загрузки. Ни в коем случае не является общепризнанным.

часть-набор-gpt-руководство
part-set-gpt-guid устройство partnum guid

Установите для GUID пронумерованного раздела GPT «partnum» значение «guid». Возвращать ошибку, если
таблица разделов «устройство» не является GPT, или если «guid» не является допустимым идентификатором GUID.

часть-набор-gpt-тип
Номер детали устройства part-set-gpt-type

Установите для типа GUID пронумерованного раздела GPT «partnum» значение «guid». Возвращать ошибку, если
таблица разделов «устройство» не является GPT, или если «guid» не является допустимым идентификатором GUID.

Читать http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs для полезного
список типов GUID.

часть-набор-mbr-идентификатор
part-set-mbr-id идентификатор детали устройства

Устанавливает байт типа MBR (также известный как байт идентификатора) пронумерованного раздела "partnum" в
"идентификатор". Обратите внимание, что байты типа, указанные в большинстве документов, на самом деле являются шестнадцатеричными.
числа, но обычно документируются без ведущего «0x», что может сбивать с толку.

Обратите внимание, что только разделы MBR (старый стиль DOS) имеют байты типа. Вы получите неопределенность
результаты для других типов таблиц разделов (см. "part-get-parttype").

часть-имя-набора
part-set-name имя детали устройства

Это устанавливает имя раздела в разделе с номером «partnum» на устройстве «device». Примечание
что разделы нумеруются с 1.

Имя раздела можно задать только для определенных типов таблиц разделов. Это работает на
"gpt", но не на разделах "mbr".

часть для разработки
раздел part-to-dev

Эта функция берет имя раздела (например, "/dev/sdb1") и удаляет номер раздела,
возвращая имя устройства (например, "/dev/sdb").

Именованный раздел должен существовать, например, в виде строки, возвращенной из "list-partitions".

См. также «part-to-partnum», «device-index».

часть к части
раздел part-partnum

Эта функция принимает имя раздела (например, "/dev/sdb1") и возвращает номер раздела.
(например, 1).

Именованный раздел должен существовать, например, в виде строки, возвращенной из "list-partitions".

См. также «часть для разработки».

пинг-демон
пинг-демон

Это тестовая проверка демона guestfs, работающего внутри устройства libguestfs.
Вызов этой функции проверяет, отвечает ли демон на сообщение ping, без
воздействуя на демон или подключенные блочные устройства каким-либо другим образом.

преподавать
смещение счетчика пути pread

Эта команда позволяет прочитать часть файла. Он читает "количество" байтов файла, начиная
по «смещению», из файла «путь».

Это может прочитать меньше байтов, чем запрошено. Для получения дополнительной информации см. преподавать(2) система
вызов.

См. также «pwrite», «pread-device».

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

предварительное устройство
смещение счетчика устройств перед устройством

Эта команда позволяет прочитать часть блочного устройства. Он читает «количество» байтов «устройства»,
начиная со "смещения".

Это может прочитать меньше байтов, чем запрошено. Для получения дополнительной информации см. преподавать(2) система
вызов.

См. также «предварительно».

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

pvchange-uuid
устройство pvchange-uuid

Создайте новый случайный UUID для физического тома «устройство».

pvchange-uuid-все
pvchange-uuid-все

Создайте новые случайные UUID для всех физических томов.

ПВХсоздать
pvcreate устройство

Это создает физический том LVM на названном «устройстве», где «устройство» обычно должно
быть именем раздела, например / Dev / sda1.

pvremove
pvremove устройство

Это стирает «устройство» физического тома, чтобы LVM больше не распознавал его.

Реализация использует команду «pvremove», которая отказывается стирать физические тома,
содержат какие-либо группы томов, поэтому вы должны сначала удалить их.

изменить размер
изменить размер устройства

Это изменяет размер (расширяет или сжимает) существующий физический том LVM, чтобы он соответствовал новому размеру
базовое устройство.

pvresize-размер
размер устройства pvresize-size

Эта команда аналогична «pvresize», за исключением того, что она позволяет указать новый размер.
(в байтах) явно.

пвс
пвс

Перечислите все обнаруженные физические тома. Это эквивалент пвс(8) команда.

Это возвращает список только имен устройств, которые содержат PV (например, / Dev / sda2).

См. также «pvs-полный».

pvs-полный
pvs-полный

Перечислите все обнаруженные физические тома. Это эквивалент пвс(8) команда.
«Полная» версия включает все поля.

пвуид
pvuid-устройство

Эта команда возвращает UUID «устройства» LVM PV.

писать
смещение содержимого пути записи

Эта команда записывает в часть файла. Он записывает содержимое буфера данных в файл
«путь», начинающийся со смещения «смещение».

Эта команда реализует писать(2) системный вызов, и, как и этот системный вызов, он может не
напишите полные запрашиваемые данные. Возвращаемое значение — это количество байтов, которые были фактически
записывается в файл. Это может быть даже 0, хотя короткие записи маловероятны для обычных
файлы в обычных условиях.

См. также «предварительные», «pwrite-device».

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

pwrite-устройство
смещение содержимого устройства pwrite-device

Эта команда записывает в часть устройства. Он записывает буфер данных «содержимое» на «устройство».
начиная со смещения "смещение".

Эта команда реализует писать(2) системный вызов, и, как и этот системный вызов, он может не
записывать полные запрошенные данные (хотя короткие записи на дисковые устройства и разделы разрешены).
вероятно, невозможно со стандартными ядрами Linux).

См. также «pwrite».

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

файл для чтения
путь к файлу для чтения

Этот вызов возвращает содержимое файла «путь» в качестве буфера.

В отличие от «cat», эта функция может правильно обрабатывать файлы, содержащие встроенный код ASCII NUL.
символы.

строки чтения
путь строк чтения

Верните содержимое файла с именем «путь».

Содержимое файла возвращается в виде списка строк. Завершающий символ "LF" и "CRLF"
последовательности не вернулся.

Обратите внимание, что эта функция не может правильно обрабатывать двоичные файлы (в частности, файлы
содержащий символ «\0», который считается концом строки). Для тех, кому нужно использовать
функцию "read-file" и разбить буфер на строки самостоятельно.

Readdir
readdir директор

Это возвращает список записей каталога в каталоге «dir».

Возвращаются все записи в каталоге, включая "." и "..". Записи не
отсортированы, но возвращены в том же порядке, что и базовая файловая система.

Также этот вызов возвращает основную информацию о типе файла для каждого файла. Поле «ftyp» будет
содержать один из следующих символов:

'b' Специальный блок

'c' Особый символ

'd' Каталог

'f' FIFO (именованный канал)

'l' Символическая ссылка

'r' Обычный файл

сокет

'u' Неизвестный тип файла

'?' То Readdir(3) вызов вернул поле "d_type" с непредвиденным значением

Эта функция в первую очередь предназначена для использования программами. Чтобы получить простой список имен,
используйте "лс". Чтобы получить печатный каталог для потребления человеком, используйте «ll».

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

ссылка для чтения
путь для чтения

Эта команда считывает цель символической ссылки.

список ссылок для чтения
readlinklist путь 'имена ...'

Этот вызов позволяет вам выполнять операцию "ссылки на чтение" для нескольких файлов, где все файлы
в каталоге «путь». "names" - это список файлов из этого каталога.

По возвращении вы получаете список строк с однозначным соответствием списку «имен».
Каждая строка является значением символической ссылки.

Если же линия индикатора ссылка для чтения(2) операция не выполняется для любого имени, тогда соответствующая строка результата
пустая строка "". Однако вся операция завершена, даже если были
ссылка для чтения(2) ошибки, поэтому вы можете вызывать эту функцию с именами, о которых вы не знаете,
они уже являются символическими ссылками (хотя и немного менее эффективными).

Этот вызов предназначен для программ, которые хотят эффективно отображать содержимое каталога.
не совершая много обходов.

реальный путь
реальный путь

Вернуть канонизированный абсолютный путь «path». Возвращаемый путь не имеет «.», «..»
или элементы пути символической ссылки.

восстанавливать
перемонтировать точку монтирования [rw:true|false]

Этот вызов позволяет изменить флаг "rw" (только чтение/чтение-запись) на уже смонтированном
файловая система в «точке монтирования», преобразующая файловую систему только для чтения в доступную для чтения и записи или наоборот.
наоборот.

Обратите внимание, что на данный момент вы должны указать «необязательный» параметр «rw». В будущем мы можем
разрешить настройку других флагов.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

удалить диск
ярлык удаления диска

Эта функция концептуально противоположна «добавить параметры диска». Он удаляет диск, который
ранее был добавлен с меткой "label".

Обратите внимание, что для того, чтобы удалить диски, вы должны добавить к ним метки (см.
аргумент «label» для «add-drive-opts»). Если вы не использовали ярлык, то они не могут быть
удален.

Вы можете вызвать эту функцию до или после запуска дескриптора. Если вызывается после запуска,
если бэкэнд поддерживает это, мы пытаемся отключить диск в горячем режиме: см. «ГОРЯЧЕЕ ПОДКЛЮЧЕНИЕ» в
гость(3). Диск должен не быть в использовании (например, установлен), когда вы делаете это. Мы пытаемся обнаружить
если диск используется, и запретить вам это делать.

удалитьxattr
удалитьxattr путь xattr

Этот вызов удаляет расширенный атрибут с именем «xattr» из файла «путь».

См. также: "lremovexattr", Attr(5).

переименовать
переименовать старый путь новый путь

Переименуйте файл в новое место в той же файловой системе. Это то же самое, что линукс
переименовать(2) системный вызов. В большинстве случаев вместо этого лучше использовать «mv».

изменить размер2fs
устройство resize2fs

Это изменяет размер файловой системы ext2, ext3 или ext4, чтобы она соответствовала размеру базового устройства.

См. также «ОШИБКИ RESIZE2FS» в гость(3).

resize2fs-M
устройство resize2fs-M

Эта команда аналогична «resize2fs», но размер файловой системы изменяется до минимума.
размер. Это работает как -M параметр команды «resize2fs».

Чтобы получить результирующий размер файловой системы, вы должны вызвать «tune2fs-l» и прочитать
Значения «Размер блока» и «Количество блоков». Эти два числа, перемноженные вместе, дают
результирующий размер минимальной файловой системы в байтах.

См. также «ОШИБКИ RESIZE2FS» в гость(3).

resize2fs-размер
resize2fs-size размер устройства

Эта команда аналогична «resize2fs», за исключением того, что она позволяет указать новый размер.
(в байтах) явно.

См. также «ОШИБКИ RESIZE2FS» в гость(3).

rm
пм путь

Удалите один файл «путь».

пм-ф
rm-f путь

Удалите файл «путь».

Если файл не существует, эта ошибка игнорируется. (Другие ошибки, например, ошибки ввода-вывода или
пути, не игнорируются)

Этот вызов не может удалить каталоги. Используйте «rmdir» для удаления пустого каталога или «rm-rf»
для рекурсивного удаления каталогов.

рм-рф
rm-rf путь

Удалите файл или каталог «путь», рекурсивно удалив содержимое, если это каталог.
Это похоже на команду оболочки «rm -rf».

RmDir
rmdir путь

Удалите единственный каталог «путь».

rmmountpoint
путь освобождения rmmountpoint

Этот вызов удаляет точку монтирования, которая была ранее создана с помощью «mkmountpoint». Видеть
"mkmountpoint" для получения полной информации.

Rsync
rsync src dest [архив: true|false] [deletedest:true|false]

Этот вызов может использоваться для копирования или синхронизации двух каталогов в одной и той же libguestfs.
ручка. Это использует Rsync(1) программа, использующая быстрый алгоритм, избегающий копирования
файлы без надобности.

«src» и «dest» — это исходный и конечный каталоги. Файлы копируются из "src"
к «десту».

Необязательные аргументы:

"архив"
Включает режим архива. Это то же самое, что пройти --архив флаг "rsync".

"самый удаленный"
Удалите файлы в месте назначения, которых нет в источнике.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

rsync-вход
rsync-in удаленный пункт назначения [архив: true|false] [deletedest:true|false]

Этот вызов может использоваться для копирования или синхронизации файловой системы на хосте или на удаленном компьютере.
компьютер с файловой системой в libguestfs. Это использует Rsync(1) программа, которая использует
быстрый алгоритм, позволяющий избежать ненужного копирования файлов.

Этот вызов работает, только если сеть включена. См. "set-network" или --сеть вариант
к различным инструментам, таким как рыба-гость(1).

Файлы копируются с удаленного сервера и каталога, указанного «удаленным», на
каталог назначения "dest".

Формат строки удаленного сервера определяется Rsync(1). Обратите внимание, что нет способа
для предоставления пароля или парольной фразы, поэтому цель должна быть настроена так, чтобы она не требовалась.

Необязательные аргументы такие же, как у «rsync».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

rsync-выход
rsync-out src remote [архив: true|false] [deletedest:true|false]

Этот вызов может использоваться для копирования или синхронизации файловой системы в libguestfs с
файловая система на хосте или на удаленном компьютере. Это использует Rsync(1) программа, которая использует
быстрый алгоритм, позволяющий избежать ненужного копирования файлов.

Этот вызов работает, только если сеть включена. См. "set-network" или --сеть вариант
к различным инструментам, таким как рыба-гость(1).

Файлы копируются из исходного каталога "src" на удаленный сервер и в каталог
указывается "удаленный".

Формат строки удаленного сервера определяется Rsync(1). Обратите внимание, что нет способа
для предоставления пароля или парольной фразы, поэтому цель должна быть настроена так, чтобы она не требовалась.

Необязательные аргументы такие же, как у «rsync».

Подстановка не происходит для параметра "src". В программах, использующих API напрямую
вы должны самостоятельно расширять подстановочные знаки (см. «glob-expand»). В guestfish вы можете использовать
команда "glob" (см. "glob"), например:

> glob rsync-out /* rsync://remote/

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

скраб-устройство
скраб-устройство

Эта команда записывает шаблоны поверх «устройства», чтобы затруднить извлечение данных.

Это интерфейс к скраб(1) программа. См. эту страницу руководства для более подробной информации.

скраб-файл
файл файла очистки

Эта команда записывает шаблоны в файл, чтобы затруднить извлечение данных.

Файл удаленный после скрабирования.

Это интерфейс к скраб(1) программа. См. эту страницу руководства для более подробной информации.

скраб-свободное пространство
директор скраб-свободного пространства

Эта команда создает каталог «dir», а затем заполняет его файлами до тех пор, пока файловая система не
заполняется, и очищает файлы как "scrub-file", и удаляет их. Намерение состоит в том, чтобы
очистите все свободное пространство на разделе, содержащем «dir».

Это интерфейс к скраб(1) программа. См. эту страницу руководства для более подробной информации.

установить-добавить
добавлять
установить-добавить добавить

Эта функция используется для добавления дополнительных параметров в команду ядра устройства libguestfs.
линии.

Значение по умолчанию — «NULL», если оно не переопределено установкой среды «LIBGUESTFS_APPEND».
Переменная.

Установка "append" в "NULL" означает нет передаются дополнительные параметры (libguestfs всегда добавляет
несколько своих).

установить-прикрепить-метод
метод прикрепления
серверная часть set-attach-method

Установите метод, который libguestfs использует для подключения к серверному демону guestfsd.

См. «НАЗАД» в гость(3).

Эта функция is устарело. Вместо этого в новом коде используйте вызов set-backend.

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

установить автосинхронизацию
автосинхронизация
установить автосинхронизацию истина|ложь

Если «автосинхронизация» имеет значение true, это включает автосинхронизацию. Libguestfs приложит все усилия
сделать файловые системы согласованными и синхронизированными при закрытии дескриптора (также, если
программа завершается без закрытия дескрипторов).

Это включено по умолчанию (начиная с libguestfs 1.5.24, ранее оно было отключено
дефолт).

set-backend
бэкэнда
set-backend бэкэнд

Установите метод, который libguestfs использует для подключения к серверному демону guestfsd.

Это свойство дескриптора ранее называлось «методом присоединения».

См. «НАЗАД» в гость(3).

установка-бэкэнд-настройка
имя set-backend-setting val

Добавьте «имя=значение» к списку строк настроек серверной части. Однако, если строка уже
существует, совпадающее с "name" или начинающееся с "name=", то этот параметр заменяется.

См. «НАЗАД» в гость(3), «НАСТРОЙКИ ОБРАТНОЙ СТАВКИ» в гость(3).

set-backend-настройки
set-backend-settings 'настройки...'

Задайте список из нуля или более параметров, которые передаются текущему бэкенду. Каждый
Параметр представляет собой строку, которая интерпретируется специфическим для бэкенда способом или игнорируется, если нет.
понимается бэкендом.

Значение по умолчанию — пустой список, если только переменная среды
«LIBGUESTFS_BACKEND_SETTINGS» был установлен при создании дескриптора. Эта среда
содержит список настроек, разделенных двоеточием.

Этот вызов заменяет все внутренние настройки. Если вы хотите заменить одну внутреннюю настройку,
см. «set-backend-setting». Если вы хотите очистить одну внутреннюю настройку, см.
бэкэнд-настройка».

См. «НАЗАД» в гость(3), «НАСТРОЙКИ ОБРАТНОЙ СТАВКИ» в гость(3).

set-cachedir
кэш-дир
set-cachedir

Установите каталог, используемый дескриптором для хранения кеша устройства, при использовании супермина.
прибор. Устройство кэшируется и совместно используется всеми дескрипторами, имеющими одинаковые
эффективный идентификатор пользователя.

Переменные среды «LIBGUESTFS_CACHEDIR» и «TMPDIR» управляют значением по умолчанию: если
Установлено «LIBGUESTFS_CACHEDIR», то это значение по умолчанию. В противном случае, если установлено "TMPDIR", то
это значение по умолчанию. Еще / Вар / TMP по умолчанию.

прямой набор
направлять
set-direct true|false

Если включен флаг прямого режима устройства, то stdin и stdout передаются напрямую.
к устройству после его запуска.

Одним из следствий этого является то, что сообщения журнала не перехватываются библиотекой и не обрабатываются
«set-log-message-callback», но переходите прямо к стандартному выводу.

Вы, вероятно, не захотите использовать это, если не знаете, что делаете.

По умолчанию отключено.

set-e2attrs
set-e2attrs атрибуты файла [clear:true|false]

Это устанавливает или очищает атрибуты файла «attrs», связанные с индексным узлом. файл.

«attrs» — это строка символов, представляющая атрибуты файла. См. "get-e2attrs" для
список возможных атрибутов. Не все атрибуты можно изменить.

Если необязательное логическое значение «clear» отсутствует или ложно, то перечисленные «attrs» устанавливаются в
индекс.

Если «clear» равно true, то перечисленные «attrs» очищаются в индексном узле.

В обоих случаях другие атрибуты, отсутствующие в строке «attrs», остаются без изменений.

Эти атрибуты присутствуют только в том случае, если файл находится в файловой системе ext2 / 3/4.
Использование этого вызова для других типов файловых систем приведет к ошибке.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

set-e2generation
генерация файла set-e2generation

Это устанавливает генерацию файла ext2 файла.

См. «get-e2generation».

набор-e2label
метка устройства set-e2label

Это устанавливает метку файловой системы ext2/3/4 файловой системы на «устройстве» на «метку».
Метки файловой системы ограничены 16 символами.

Вы можете использовать либо «tune2fs-l», либо «get-e2label», чтобы вернуть существующую метку на
файловая система.

Эта функция is устарело. Вместо этого в новом коде используйте вызов set-label.

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

set-e2uuid
set-e2uuid UUID устройства

Это устанавливает UUID файловой системы ext2/3/4 файловой системы на «устройстве» в «uuid». То
формат UUID и альтернативы, такие как «очистить», «случайный» и «время», описаны в
домен Tune2fs(8) справочная страница.

Вы можете использовать «vfs-uuid», чтобы вернуть существующий UUID файловой системы.

Эта функция is устарело. Вместо этого в новом коде используйте вызов set-uuid.

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

набор-hv
hv
набор-hv hv

Установите бинарный файл гипервизора, который мы будем использовать. Гипервизор зависит от серверной части, но
обычно расположение гипервизора qemu/KVM. Для бэкэнда uml это местоположение
бинарного файла "linux" или "vmlinux".

Значение по умолчанию выбирается при компиляции библиотеки скриптом configure.

Вы также можете переопределить это, установив переменную среды «LIBGUESTFS_HV».

Обратите внимание, что эту функцию следует вызывать как можно раньше после создания дескриптора.
Это связано с тем, что некоторые операции перед запуском зависят от тестирования функций qemu (путем запуска
"кему-помощь"). Если двоичный файл qemu изменится, мы не будем повторно тестировать функции, поэтому вы можете увидеть
противоречивые результаты. Использование переменной среды «LIBGUESTFS_HV» безопаснее всего
поскольку это выбирает двоичный файл qemu одновременно с созданием дескриптора.

набор-идентификатор
идентификатор
идентификатор набора идентификаторов

Это информативная строка, которую вызывающая сторона может дополнительно установить в дескрипторе. это
печатается в разных местах, что позволяет идентифицировать текущий дескриптор при отладке
вывод.

Одно важное место — когда включена трассировка. Если строка идентификатора не является пустой
строка, то сообщения трассировки изменяются следующим образом:

libguestfs: трассировка: get_tmpdir
libguestfs: трассировка: get_tmpdir = "/ Tmp"

к этому:

libguestfs: трассировка: ID: get_tmpdir
libguestfs: трассировка: ID: get_tmpdir = "/ Tmp"

где "ID" - это строка идентификатора, установленная этим вызовом.

Идентификатор должен содержать только буквенно-цифровые символы ASCII, знак подчеркивания и минус.
По умолчанию используется пустая строка.

См. также "set-program", "set-trace", "get-identifier".

набор-метка
монтируемая этикетка set-label

Установите метку файловой системы на «mountable» на «label».

Только некоторые типы файловых систем поддерживают метки, а libguestfs поддерживает установку меток только для
подмножество из них.

доб2, доб3, доб4
Метки ограничены 16 байтами.

NTFS
Метки ограничены 128 символами Юникода.

XFS Метка ограничена 12 байтами. Файловая система не должна быть смонтирована при попытке
установить метку.

Btrfs
Метка ограничена 255 байтами, и некоторые символы не допускаются. Настройка
label на подтоме btrfs установит метку на его родительской файловой системе. То
файловая система не должна быть смонтирована при попытке установить метку.

fat Метка ограничена 11 байтами.

Если нет поддержки изменения метки для типа указанной файловой системы,
set_label завершится ошибкой и установит errno как ENOTSUP.

Чтобы прочитать метку в файловой системе, вызовите «vfs-label».

установить-libvirt-запрошенные учетные данные
индекс набора учетных данных set-libvirt-requested-credential

После запроса учетных данных «index» от пользователя вызовите эту функцию, чтобы передать
ответьте на libvirt.

См. «АУТЕНТИФИКАЦИЯ LIBVIRT» в гость(3) для документации и примеров кода.

набор-libvirt-поддерживаемые учетные данные
set-libvirt-supported-credentials 'creds...'

Вызовите эту функцию перед установкой обработчика событий для "GUESTFS_EVENT_LIBVIRT_AUTH", чтобы
предоставить список типов учетных данных, которые программа знает, как обрабатывать.

Список "creds" должен быть непустым списком строк. Возможные строки:

"имя пользователя"
"имя"
«Язык»
"сногсшибательный"
"парольная фраза"
"эхоподсказка"
"нетэхоподсказка"
"область"
«Внешний»

См. в документации libvirt значение этих типов учетных данных.

См. «АУТЕНТИФИКАЦИЯ LIBVIRT» в гость(3) для документации и примеров кода.

set-memsize
запомнить
установить-memsize

Это устанавливает размер памяти в мегабайтах, выделенный гипервизору. Только это имеет какое-либо
эффект, если вызывается перед "запуском".

Вы также можете изменить это, установив переменную среды «LIBGUESTFS_MEMSIZE» перед
ручка создана.

Для получения дополнительной информации об архитектуре libguestfs см. гость(3).

набор-сеть
сеть
установить-сеть true|false

Если «сеть» имеет значение true, то сеть включена в устройстве libguestfs. То
по умолчанию - ложь.

Это влияет на то, могут ли команды получить доступ к сети (см. «ЗАПУСК КОМАНД» в
гость(3 г.)).

Вы должны вызвать это перед вызовом «запуска», иначе это не будет иметь никакого эффекта.

заданный путь
путь
set-path путь поиска

Установите путь, по которому libguestfs ищет ядро ​​и initrd.img.

По умолчанию используется "$libdir/guestfs", если это не переопределено установкой "LIBGUESTFS_PATH".
переменная среды.

Установка для "path" значения "NULL" восстанавливает путь по умолчанию.

набор-pgroup
группа
set-pgroup истина | ложь

Если "pgroup" равно true, дочерние процессы помещаются в свою собственную группу процессов.

Практическим результатом этого является то, что такие сигналы, как «SIGINT» (от пользователей, нажимающих «^C»)
не будет получен дочерним процессом.

По умолчанию для этого флага установлено значение false, потому что обычно вы хотите, чтобы "^C" убивал подпроцесс.
Guestfish устанавливает этот флаг в значение true при интерактивном использовании, так что "^C" может отменить
корректное выполнение команд (см. «user-cancel»).

сет-программа
программа
заданная программа

Установите имя программы. Это информативная строка, которую основная программа может опционально
устанавливается в ручке.

Когда дескриптор создан, имя программы в дескрипторе устанавливается на базовое имя из
"аргв [0]". Если это невозможно, устанавливается пустая строка (но никогда не "NULL").

set-qemu
кему
set-qemu hv

Установите бинарный файл гипервизора (обычно qemu), который мы будем использовать.

Значение по умолчанию выбирается при компиляции библиотеки скриптом configure.

Вы также можете переопределить это, установив переменную среды «LIBGUESTFS_HV».

Установка «hv» в «NULL» восстанавливает двоичный файл qemu по умолчанию.

Обратите внимание, что эту функцию следует вызывать как можно раньше после создания дескриптора.
Это связано с тем, что некоторые операции перед запуском зависят от тестирования функций qemu (путем запуска
"кему-помощь"). Если двоичный файл qemu изменится, мы не будем повторно тестировать функции, поэтому вы можете увидеть
противоречивые результаты. Использование переменной среды «LIBGUESTFS_HV» безопаснее всего
поскольку это выбирает двоичный файл qemu одновременно с созданием дескриптора.

Эта функция is устарело. Вместо этого в новом коде используйте вызов set-hv.

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

установка-восстановление-процедура
процесс восстановления
set-recovery-proc true|false

Если это вызывается с параметром "false" то "запуск" не создает рекавери
обработать. Цель процесса восстановления — остановить запущенные процессы гипервизора в
случай, когда основная программа резко прерывается.

Это имеет какой-либо эффект только в том случае, если вызывается перед «запуском», и значение по умолчанию равно true.

Единственный раз, когда вы захотите отключить это, - это если основной процесс разветвится.
себя на задний план («демонизировать» себя). В этом случае процесс восстановления думает
что пропала основная программа и так убивает гипервизор, что не очень
полезно.

set-selinux
SELinux
set-selinux истина | ложь

Это устанавливает флаг selinux, который передается устройству во время загрузки. По умолчанию
"selinux=0" (отключено).

Обратите внимание, что если SELinux включен, он всегда находится в разрешительном режиме ("enforcing=0").

Для получения дополнительной информации об архитектуре libguestfs см. гость(3).

набор-smp
SMP
набор-smp smp

Измените количество виртуальных ЦП, назначенных устройству. По умолчанию 1.
Увеличение этого параметра может улучшить производительность, хотя часто это не имеет никакого эффекта.

Эта функция должна быть вызвана перед «запуском».

set-tmpdir
tmpdir
set-tmpdir tmpdir

Установите каталог, используемый дескриптором для хранения временных файлов.

Переменные среды «LIBGUESTFS_TMPDIR» и «TMPDIR» управляют значением по умолчанию: если
Установлено «LIBGUESTFS_TMPDIR», то это значение по умолчанию. В противном случае, если установлено "TMPDIR", то
по умолчанию. Еще / Tmp по умолчанию.

установить-след
прослеживать
установить трассировку true|false

Если для флага трассировки команд установлено значение 1, то вызовы, параметры и возвращаемые значения libguestfs
прослеживаются.

Если вы хотите отслеживать вызовы C API в libguestfs (и другие библиотеки), то, возможно,
лучший способ - использовать внешний трассировка(1) команда.

Трассировки команд отключены, если не определена переменная среды «LIBGUESTFS_TRACE».
и установить на 1.

Сообщения трассировки обычно отправляются на «stderr», если вы не зарегистрируете обратный вызов для их отправки.
где-то еще (см. "set-event-callback").

set-uuid
set-uuid устройство UUID

Установите UUID файловой системы на «устройство» на «uuid». Если это не удается и ошибка ENOTSUP,
означает, что нет поддержки изменения UUID для типа указанного
файловая система.

Только некоторые типы файловых систем поддерживают настройку UUID.

Чтобы прочитать UUID в файловой системе, вызовите «vfs-uuid».

набор-uuid-случайный
set-uuid-случайное устройство

Установите UUID файловой системы на «устройство» на случайный UUID. Если это не удается, и ошибка
ENOTSUP, означает, что нет поддержки для изменения UUID для типа
указанная файловая система.

Только некоторые типы файловых систем поддерживают настройку UUID.

Чтобы прочитать UUID в файловой системе, вызовите «vfs-uuid».

набор-подробный
подробный
set-verbose true|false

Если "verbose" равно true, включаются подробные сообщения.

Подробные сообщения отключены, если не задана переменная среды "LIBGUESTFS_DEBUG".
определено и установлено в 1.

Подробные сообщения обычно отправляются на «stderr», если вы не зарегистрируете обратный вызов для отправки.
их в другом месте (см. «set-event-callback»).

сеткон
setcon контекст

Это устанавливает контекст безопасности SELinux демона в строку «context».

См. Документацию по SELINUX в гость(3).

setxattr
setxattr xattr val vallen путь

Этот вызов устанавливает расширенный атрибут с именем «xattr» файла «путь» в значение «val».
(длины «валлен»). Значение представляет собой произвольные 8-битные данные.

См. также: "lsetxattr", Attr(5).

sfdisk
sfdisk устройство cyls заголовки секторов 'строки...'

Это прямой интерфейс к sfdisk(8) программа для создания разделов на блоке
устройств.

"устройство" должно быть блочным устройством, например / Dev / ПДД.

"cyls", "heads" и "sectors" - количество цилиндров, головок и секторов на
устройства, которые передаются непосредственно в sfdisk как -C, -H и -S параметры. Если вы пройдете
0 для любого из них, то соответствующий параметр опускается. Обычно для «больших»
дисков, вы можете просто передать для них 0, но для небольших (размером с дискету) дисков sfdisk (или
скорее ядро) не может отработать правильную геометрию и вам нужно будет ей подсказать.

«lines» — это список строк, которые мы передаем на «sfdisk». Для получения дополнительной информации см.
sfdisk(8) справочная страница.

Чтобы создать один раздел, занимающий весь диск, вы должны передать «строки» как один
список элементов, когда единственным элементом является строка "," (запятая).

См. также: «sfdisk-l», «sfdisk-N», «part-init».

Эта функция is устарело. Вместо этого в новом коде используйте вызов «part-add».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

sfdiskM
sfdiskM устройство "линии..."

Это упрощенный интерфейс для команды «sfdisk», где размеры разделов
указывается только в мегабайтах (с округлением до ближайшего цилиндра) и вам не нужно
укажите параметры cyls, head и секторов, которые в любом случае редко использовались, если вообще когда-либо использовались.

См. также: «sfdisk», sfdisk(8) справочная страница и «частичный диск»

Эта функция is устарело. Вместо этого в новом коде используйте вызов «part-add».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

sfdisk-N
sfdisk-N устройство partnum цилиндры головки секторы линия

Это работает sfdisk(8) возможность изменить только один раздел «n» (примечание: «n» отсчитывается от
1).

Другие параметры см. в разделе «sfdisk». Обычно вы должны передавать 0 для цилиндров/головок/секторов.
параметры.

Смотрите также: "частично добавить"

Эта функция is устарело. Вместо этого в новом коде используйте вызов «part-add».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

sfdisk-диск-геометрия
Устройство sfdisk-disk-геометрия

Это отображает геометрию диска «устройства», считанную из таблицы разделов. Особенно в
случае, когда базовое блочное устройство было изменено, это может отличаться от
представление ядра о геометрии (см. "sfdisk-kernel-geometry").

Результат находится в удобочитаемом формате и не предназначен для анализа.

sfdisk-kernel-геометрия
Устройство sfdisk-kernel-геометрия

Это отображает представление ядра о геометрии «устройства».

Результат находится в удобочитаемом формате и не предназначен для анализа.

sfdisk-l
sfdisk-l устройство

Это отображает таблицу разделов на «устройстве» в удобочитаемом виде
sfdisk(8) команда. Он не предназначен для разбора.

Смотрите также: "список частей"

Эта функция is устарело. Вместо этого в новом коде используйте вызов "part-list".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

sh
ш команда

Этот вызов запускает команду из гостевой файловой системы через гостевой / Бен / ш.

Это похоже на «команду», но передает команду:

/ Бен / ш -с "команда"

В зависимости от гостевой оболочки это обычно приводит к расширению подстановочных знаков, оболочке
интерполируемые выражения и т.д.

К этому вызову применимы все оговорки о «команде».

ш-линии
команда sh-линий

Это то же самое, что и "sh", но результат разбивается на список строк.

Смотрите также: "командные строки"

выключение
выключение

Это противоположно «запуску». Он выполняет упорядоченное отключение серверной части
процесс(ы). Если установлен флаг автосинхронизации (по умолчанию), то образ диска
синхронизировано.

Если подпроцесс завершится с ошибкой, то эта функция вернет ошибку, которая
должен не игнорировать (это может означать, что образ диска не может быть записан
должным образом).

Безопасно вызывать это несколько раз. Лишние вызовы игнорируются.

Этот звонок делает не закрыть или освободить ручку. Вам все еще нужно позвонить "закрыть"
в конце.

«close» вызовет это, если вы не сделаете это явно, но обратите внимание, что любые ошибки игнорируются
в таком случае.

спать
секунды сна

Сон на "secs" секунд.

состояние
статический путь

Возвращает информацию о файле для заданного «пути».

Это так же, как состояние(2) системный вызов.

Эта функция is устарело. Вместо этого в новом коде используйте вызов «statns».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

статы
Статический путь

Возвращает информацию о файле для заданного «пути».

Это так же, как состояние(2) системный вызов.

статвфс
statvfs путь

Возвращает статистику файловой системы для любой смонтированной файловой системы. "путь" должен быть файлом или
каталог в смонтированной файловой системе (обычно это сама точка монтирования, но
не должно быть).

Это так же, как статвфс(2) системный вызов.

струны
путь строк

Это запускает струны(1) команда для файла и возвращает список печатных строк
найдено.

В прошлом у команды «strings» были проблемы с анализом ненадежных файлов. Эти
смягчены в текущей версии libguestfs, но см. «CVE-2014-8484» в гость(3).

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

строки-е
путь кодирования strings-e

Это похоже на команду "strings", но позволяет указать кодировку строк, которые
ищутся в исходном файле "путь".

Допустимые кодировки:

s Одиночные 7-битные байтовые символы, такие как ASCII и совместимые с ASCII части ISO-8859-X.
(это то, что использует «строки»).

S Отдельные 8-битные байтовые символы.

b 16-битные строки с обратным порядком байтов, такие как закодированные в UTF-16BE или UCS-2BE.

л (строчная буква Л)
16-битный прямой порядок байтов, такой как UTF-16LE и UCS-2LE. Это полезно для изучения
исполняемые файлы в гостях Windows.

B 32-битный код с прямым порядком байтов, такой как UCS-4BE.

L 32-битный прямой порядок байтов, такой как UCS-4LE.

Возвращаемые строки перекодируются в UTF-8.

В прошлом у команды «strings» были проблемы с анализом ненадежных файлов. Эти
смягчены в текущей версии libguestfs, но см. «CVE-2014-8484» в гость(3).

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

swapoff-устройство
swapoff-устройство устройство

Эта команда отключает устройство подкачки устройства libguestfs или раздел с именем «устройство».
См. «устройство подкачки».

swapoff-файл
swapoff-файл файл

Эта команда отключает подкачку устройства libguestfs в файле.

swapoff-метка
метка swapoff-label

Эта команда отключает подкачку устройства libguestfs на помеченном разделе подкачки.

swapoff-uuid
swapoff-uuid uuid

Эта команда отключает раздел подкачки устройства libguestfs с заданным UUID.

swapon-устройство
swapon-устройство устройство

Эта команда позволяет устройству libguestfs использовать устройство подкачки или раздел с именем
"устройство". Увеличенная память доступна для всех команд, например, для запуска
используя «команду» или «ш».

Обратите внимание, что вы не должны переключаться на существующие гостевые разделы подкачки, если вы не знаете, что вы
делают. Они могут содержать информацию о переходе в спящий режим или другую информацию, которую гость
не хочет, чтобы ты мусорил. Вы также рискуете передать информацию о хосте гостю.
Сюда. Вместо этого подключите новое хост-устройство к гостю и переключитесь на него.

swapon-файл
файл swapon-файла

Эта команда включает своп в файл. Другие примечания см. в разделе «swapon-device».

swapon-этикетка
метка swapon-label

Эта команда включает своп на помеченный раздел подкачки. См. «swapon-device» для других
заметок.

swapon-uuid
swapon-uuid uuid

Эта команда включает своп на раздел подкачки с заданным UUID. См. «swapon-device»
для других заметок.

синхронизировать
синхронизировать

Это синхронизирует диск, так что любые записи сбрасываются на базовый образ диска.

Вы всегда должны вызывать это, если вы изменили образ диска, перед закрытием дескриптора.

SYSLINUX
устройство syslinux [каталог:..]

Установите загрузчик SYSLINUX на «устройство».

Параметр устройства должен быть либо целым диском, отформатированным как файловая система FAT, либо
раздел отформатирован как файловая система FAT. В последнем случае раздел должен быть
помечен как «активный» («part-set-bootable») и должна быть установлена ​​основная загрузочная запись (например,
используя "pwrite-device") в первом секторе всего диска. Пакет SYSLINUX поставляется
с некоторыми подходящими основными загрузочными записями. См. SYSLINUX(1) справочная страница для дальнейшего
Информация.

Необязательные аргументы:

каталог
Установите SYSLINUX в ​​указанный подкаталог, а не в корневой каталог
файловая система FAT.

Дополнительная конфигурация может быть предоставлена ​​SYSLINUX, поместив файл с именем syslinux.cfg
в файловой системе FAT либо в корневом каталоге, либо в каталог если это необязательно
используется аргумент. Дополнительные сведения о содержимом этого файла см.
SYSLINUX(1).

См. также «extlinux».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

хвост
хвостовой путь

Эта команда возвращает последние 10 строк файла в виде списка строк.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

хвост-н
путь tail-n nrlines

Если параметр "nrlines" является положительным числом, возвращаются последние строки "nrlines"
файл "путь".

Если параметр «nrlines» является отрицательным числом, он возвращает строки из файла «path»,
начиная с «-nrlines»-й строки.

Если параметр «nrlines» равен нулю, возвращается пустой список.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

смола
смола в опциях
tar-in (tarfile|-) каталог [сжать:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

Эта команда загружает и распаковывает локальный файл «tarfile» в каталог.

Необязательный флаг «compress» управляет сжатием. Если не указано, то ввод должен быть
несжатый файл tar. В противном случае для выбора может быть задана одна из следующих строк.
тип сжатия входного файла: "compress", "gzip", "bzip2", "xz", "lzop". (Примечание
что не все сборки libguestfs будут поддерживать все эти типы сжатия).

Другие необязательные аргументы:

"xattrs"
Если установлено значение true, расширенные атрибуты восстанавливаются из файла tar.

"селинукс"
Если установлено значение true, контексты SELinux восстанавливаются из файла tar.

"acls"
Если установлено значение true, списки контроля доступа POSIX восстанавливаются из tar-файла.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

тар-аут
tar-out-opts
каталог tar-out (tarfile|-) [сжать:..] [владелец-числом:true|false] [исключить:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

Эта команда упаковывает содержимое каталог и загружает его в локальный файл "tarfile".

Необязательный флаг «compress» управляет сжатием. Если не указано, то вывод будет
несжатый файл tar. В противном случае для выбора может быть задана одна из следующих строк.
тип сжатия выходного файла: "compress", "gzip", "bzip2", "xz", "lzop". (Примечание
что не все сборки libguestfs будут поддерживать все эти типы сжатия).

Другие необязательные аргументы:

"исключает"
Список подстановочных знаков. Файлы исключаются, если они соответствуют любому из подстановочных знаков.

"владелец числа"
Если установлено значение true, выходной tar-файл будет содержать номера UID/GID вместо пользователя/группы.
имена.

"xattrs"
Если установлено значение true, расширенные атрибуты сохраняются в выходной tar.

"селинукс"
Если установлено значение true, контексты SELinux сохраняются в выходной tar.

"acls"
Если установлено значение true, списки контроля доступа POSIX сохраняются в выходном файле tar.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

тгз-ин
каталог tgz-in (tarball|-)

Эта команда загружает и распаковывает локальный файл "tarball" (файл GZIP сжатый tar-файл) в
каталог.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

Эта функция is устарело. Вместо этого в новом коде используйте вызов "tar-in".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

тгз-аут
каталог tgz-out (tarball|-)

Эта команда упаковывает содержимое каталог и загружает его в локальный файл "tarball".

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

Эта функция is устарело. Вместо этого в новом коде используйте вызов "tar-out".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

трогать
сенсорный путь

Прикосновение действует как трогать(1) команда. Его можно использовать для обновления временных меток в файле,
или, если файл не существует, создать новый файл нулевой длины.

Эта команда работает только с обычными файлами и не работает с другими типами файлов, такими как
каталоги, символические ссылки, специальные блоки и т. д.

усекать
обрезать путь

Эта команда усекает «путь» к файлу нулевой длины. Файл должен уже существовать.

усеченный размер
усеченный размер пути

Эта команда усекает «путь» до размера «размер» байтов. Файл должен уже существовать.

Если текущий размер файла меньше «размера», то файл расширяется до требуемого размера.
размер с нулевыми байтами. Это создает разреженный файл (т.е. блоки диска не выделяются для
файл, пока вы не напишете в него). Чтобы создать неразреженный файл нулей, используйте «fallocate64».
.

Tune2fs
устройство tune2fs [force:true|false] [maxmountcount:N] [mountcount:N] [errorbehavior:..] [group:N] [intervalbetweenchecks:N] [reservedblockspercentage:N] [lastmounteddirectory:..] [reservedblockscount:N ] [пользователь:N]

Этот вызов позволяет настроить различные параметры файловой системы ext2/ext3/ext4.
файловая система под названием «устройство».

Необязательные параметры:

"сила"
Принудительно завершайте операцию tune2fs даже при наличии ошибок. Это тоже самое
как опция tune2fs "-f".

"максимальное количество"
Установите количество монтирований, после которых файловая система проверяется e2fsck(8). Если это
равно 0, то количество монтирований не учитывается. Это то же самое, что и tune2fs "-c"
опцию.

"скачок"
Установите количество раз, когда файловая система была смонтирована. Это то же самое, что и
Опция tune2fs "-C".

"ошибочное поведение"
Измените поведение кода ядра при обнаружении ошибок. Возможные значения
на данный момент есть: "продолжить", "перемонтировать-ро", "паника". На практике эти варианты не
действительно имеет значение, особенно для ошибок записи.

Это то же самое, что и опция tune2fs "-e".

"группа"
Установите группу, которая может использовать зарезервированные блоки файловой системы. Это то же самое, что и
опцию tune2fs «-g», за исключением того, что ее можно указать только в виде числа.

"интервал между проверками"
Настройте максимальное время между двумя проверками файловой системы (в секундах). Если вариант
передается как 0, тогда проверка в зависимости от времени отключена.

Это то же самое, что и опция tune2fs "-i".

"процент зарезервированных блоков"
Установите процент файловой системы, который может быть выделен только привилегированным
процессы. Это то же самое, что и опция tune2fs "-m".

"последний смонтированный каталог"
Установите последний смонтированный каталог. Это то же самое, что и опция tune2fs "-M".

"reservedblockscount" Установить количество зарезервированных блоков файловой системы. Это то же самое, что
опция tune2fs "-r".
«Пользователь»
Установите пользователя, который может использовать зарезервированные блоки файловой системы. Это то же самое, что и
опцию tune2fs "-u", за исключением того, что она может быть указана только как число.

Чтобы получить текущие значения параметров файловой системы, см. «tune2fs-l». Для точных деталей
о том, как работает tune2fs, см. Tune2fs(8) справочная страница.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

настроить2fs-l
устройство tune2fs-l

Это возвращает содержимое суперблока файловой системы ext2, ext3 или ext4 на «устройство».

Это то же самое, что запустить «tune2fs -l device». Видеть Tune2fs(8) справочная страница для более подробной информации.
Список возвращаемых полей четко не определен и зависит как от версии
«tune2fs», для которого была создана libguestfs, и сама файловая система.

txz-вход
каталог txz-in (tarball|-)

Эта команда загружает и распаковывает локальный файл "tarball" (файл xz сжатый tar-файл) в
каталог.

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

Эта функция is устарело. Вместо этого в новом коде используйте вызов "tar-in".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

txz-выход
каталог txz-out (tarball|-)

Эта команда упаковывает содержимое каталог и загружает его в локальный файл "tarball" (как
сжатый xz tar-архив).

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

Эта функция is устарело. Вместо этого в новом коде используйте вызов "tar-out".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

Umask
умаск маска

Эта функция устанавливает маску, используемую для создания новых файлов и узлов устройств, на «mask & 0777».

Типичными значениями umask будут 022, что создает новые файлы с такими разрешениями, как
"-rw-r--r--" или "-rwxr-xr-x" и 002, который создает новые файлы с такими разрешениями, как
"-rw-rw-r--" или "-rwxrwxr-x".

Маска по умолчанию — 022. Это важно, потому что это означает, что каталоги и устройства
узлы будут созданы с режимом 0644 или 0755, даже если вы укажете 0777.

См. также "get-umask", Umask(2), "мкнод", "мкдир".

Этот вызов возвращает предыдущую маску umask.

размонтировать
размонтировать
umount-opts
umount pathordevice [force:true|false] [lazyunmount:true|false]

Это размонтирует данную файловую систему. Файловая система может быть указана либо ее
точка монтирования (путь) или устройство, на котором находится файловая система.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

размонтировать все
размонтировать все
размонтировать все

Это размонтирует все смонтированные файловые системы.

Некоторые внутренние монтирования не размонтируются этим вызовом.

размонтировать-локальный
umount-local [повторить: true|false]

Если libguestfs экспортирует файловую систему в локальную точку монтирования, это размонтирует ее.

См. "MOUNT LOCAL" в гость(3) для полной документации.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

загружать
загрузить (имя файла|-) имя удаленного файла

Загрузить локальный файл имя файла в удаленное имя файла в файловой системе.

имя файла также может быть именованным каналом.

См. также «скачать».

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

выгрузка-смещение
смещение загрузки (имя файла|-) смещение удаленного файла

Загрузить локальный файл имя файла в удаленное имя файла в файловой системе.

удаленное имя файла перезаписывается, начиная с указанного байта "смещение". Намерение
перезаписывать части существующих файлов или устройств, даже если несуществующий файл
указано, то он создается с «отверстием» перед «смещением». Размер записываемых данных
подразумевается в размере источника имя файла.

Обратите внимание, что количество данных, которые можно загрузить с помощью этого вызова, не ограничено.
в отличие от "pwrite", этот вызов всегда записывает полную сумму, если не возникает ошибка.

См. также «загрузить», «записать».

Используйте «-» вместо имени файла для чтения / записи из stdin / stdout.

пользователь-отмена
пользователь-отмена

Эта функция отменяет текущую операцию загрузки или загрузки.

В отличие от большинства других вызовов libguestfs, эта функция безопасна для сигналов и потоков. Ты сможешь
вызовите его из обработчика сигнала или из другого потока без необходимости выполнять какую-либо блокировку.

Выполнявшаяся передача (если она есть) вскоре остановится и будет
вернуть ошибку. Для параметра errno (см. «guestfs_last_errno») установлено значение «EINTR», поэтому вы можете проверить
для этого, чтобы узнать, была ли операция отменена или не удалась из-за другой ошибки.

Очистка не выполняется: например, если файл загружался, то после отмены
может быть частично загруженный файл. Ответственность за уборку лежит на вызывающем абоненте, если
необходимо.

Есть два общих места, которые вы могли бы назвать «user-cancel»:

В интерактивной текстовой программе вы можете вызывать ее из обработчика сигнала "SIGINT", поэтому
что нажатие «^C» отменяет текущую операцию. (Также нужно позвонить
«guestfs_set_pgroup», чтобы дочерние процессы не получали сигнал «^C»).

В графической программе, когда основной поток отображает индикатор выполнения с отменой
кнопку, подключите кнопку отмены, чтобы вызвать эту функцию.

утименс
путь utimens atsecs atnsecs mtsecs mtnsecs

Эта команда устанавливает временные метки файла с точностью до наносекунды.

«atsecs, atnsecs» — время последнего доступа (atime) в секундах и наносекундах от эпохи.

"mtsecs, mtnsecs" - время последней модификации (mtime) в секундах и наносекундах от
эпоха.

Если поле *nsecs содержит специальное значение "-1", то соответствующая отметка времени
установить текущее время. (Поле *secs в этом случае игнорируется).

Если поле *nsecs содержит специальное значение "-2", то соответствующая отметка времени
оставлен без изменений. (Поле *secs в этом случае игнорируется).

утснаме
утснаме

Это возвращает версию ядра устройства, если она доступна. Этот
информация полезна только для отладки. Ничто в возвращаемой структуре не определяется
API.

версия
версия

Возвращает номер версии libguestfs, с которой связана программа.

Обратите внимание, что из-за динамической компоновки это не обязательно версия libguestfs.
против которого вы скомпилировали. Вы можете скомпилировать программу, а затем во время выполнения динамически
ссылка на совершенно другое libguestfs.so библиотека.

Этот вызов был добавлен в версии 1.0.58. В предыдущих версиях libguestfs не было
способ получить номер версии. Из кода C вы можете использовать функции динамического компоновщика, чтобы найти
out, если этот символ существует (если нет, то это более ранняя версия).

Вызов возвращает структуру с четырьмя элементами. Первые три («большие», «второстепенные» и
«выпуск») являются числами и соответствуют обычной тройке версий. Четвертый элемент
(«extra») — это строка, обычно пустая, но может использоваться для конкретных дистрибутивов.
Информация.

Чтобы создать исходную строку версии: "$major.$minor.$release$extra"

См. также: "НОМЕРА ВЕРСИЙ LIBGUESTFS" в гость(3).

Примечание: Не используйте этот вызов для проверки доступности функций. На предприятии
дистрибутивов мы переносим функции из более поздних версий в более ранние версии, что делает
ненадежный способ проверки функций. Вместо этого используйте «доступные» или «доступные функции».

vfs-метка
vfs-метка монтируемая

Это возвращает метку файловой системы на «mountable».

Если файловая система не помечена, возвращается пустая строка.

Чтобы найти файловую систему по метке, используйте «findfs-label».

vfs-минимальный размер
vfs-минимальный монтируемый размер

Получите минимальный размер файловой системы в байтах. Это минимально возможный размер для
файловая система сжимается.

Если получение минимального размера указанной файловой системы не поддерживается, произойдет сбой и будет установлено
ошибочно как ЭНОЦУП.

Смотрите также ntfsизменить размер(8) изменить размер2fs(8) Btrfs(8) xfs_info(8).

vfs-тип
монтируемый по типу vfs

Эта команда получает тип файловой системы, соответствующий файловой системе на "mountable".

Для большинства файловых систем результатом является имя используемого модуля Linux VFS.
для монтирования этой файловой системы, если вы монтировали ее без указания типа файловой системы. Для
например строка, такая как «ext3» или «ntfs».

vfs-uuid
получить-uuid
vfs-uuid монтируемый

Это возвращает UUID файловой системы файловой системы в «монтируемом».

Если файловая система не имеет UUID, возвращается пустая строка.

Чтобы найти файловую систему по UUID, используйте «findfs-uuid».

vg-активировать
vg-activate true|false 'volgroups...'

Эта команда активирует или (если «активировать» ложно) деактивирует все логические тома в
перечислены группы томов "volgroups".

Эта команда аналогична запуску "vgchange -ay|n volgroups..."

Обратите внимание, что если "volgroups" является пустым списком, то Найти группы громкости активированы или
деактивировано.

vg-активировать-все
vg-активировать-все правда|ложь

Эта команда активирует или (если «активировать» ложно) деактивирует все логические тома во всех
группы громкости.

Эта команда аналогична запуску «vgchange -ay|n».

vgchange-uuid
vgchange-uuid vg

Создайте новый случайный UUID для группы томов "vg".

vgchange-uuid-все
vgchange-uuid-все

Создайте новые случайные UUID для всех групп томов.

vgcreate
vgcreate volgroup 'физические тома...'

Это создает группу томов LVM под названием «volgroup» из непустого списка физических
тома "физволс".

vglvuuids
vglvuuids vgname

Учитывая VG с именем «vgname», она возвращает UUID всех логических томов, созданных в
эту группу томов.

Вы можете использовать это вместе с вызовами "lvs" и "lvuuid" для связывания логических томов и
группы громкости.

См. также "vgpvuids".

вгмета
vgmeta vgname

«vgname» — это группа томов LVM. Эта команда проверяет группу томов и возвращает ее
метаданные.

Обратите внимание, что метаданные — это внутренняя структура, используемая LVM, которая может быть изменена в любое время.
время и предоставляется только для информации.

vgpvuids
vgpvuuids vgname

Учитывая VG с именем "vgname", она возвращает UUID всех физических томов, которые
находится группа томов.

Вы можете использовать это вместе с вызовами "pvs" и "pvuuid" для связывания физических томов и
группы громкости.

См. также «vglvuuids».

vgremove
vgremove vgname

Удалите группу томов LVM "vgname" (например, "VG").

Это также принудительно удаляет все логические тома в группе томов (если они есть).

vgrename
vgrename volgroup новая volgroup

Переименуйте группу томов «volgroup» с новым именем «newvolgroup».

вгс
вгс

Перечислите все обнаруженные группы томов. Это эквивалент вгс(8) команда.

Это возвращает список только обнаруженных имен групп томов (например, «VolGroup00»).

См. также «vgs-полный».

vgs-полный
vgs-полный

Перечислите все обнаруженные группы томов. Это эквивалент вгс(8) команда. То
«полная» версия включает все поля.

vgscan
vgscan

Это повторно сканирует все блочные устройства и перестраивает список физических томов LVM, том
группы и логические тома.

vguuid
vguuid vgname

Эта команда возвращает UUID VG LVM с именем «vgname».

туалет-с
wc-c путь

Эта команда подсчитывает символы в файле с помощью внешней команды "wc -c".

туалет-л
wc-l путь

Эта команда подсчитывает строки в файле с помощью внешней команды "wc -l".

туалет-ш
wc-w путь

Эта команда подсчитывает количество слов в файле с помощью внешней команды "wc -w".

салфетки
вайфс устройство

Эта команда стирает сигнатуры файловой системы или RAID с указанного «устройства», чтобы сделать
файловая система невидима для libblkid.

Это не стирает ни саму файловую систему, ни какие-либо другие данные с «устройства».

Сравните с «нулем», который обнуляет первые несколько блоков устройства.

записывать
написать содержимое пути

Этот вызов создает файл с именем «путь». Содержимое файла представляет собой строку «content»
(который может содержать любые 8-битные данные).

См. также «запись-добавление».

запись-добавление
содержимое пути записи-добавления

Этот вызов добавляет «контент» в конец «пути» к файлу. Если "пути" не существует, то
создается новый файл.

См. также «написать».

файл записи
размер содержимого пути записи в файл

Этот вызов создает файл с именем «путь». Содержимое файла представляет собой строку «content»
(который может содержать любые 8-битные данные) с длиной «размер».

В особом случае, если "size" равен 0, длина вычисляется с использованием "strlen" (поэтому в этом
если содержимое не может содержать встроенные ASCII NUL).

NB. Из-за ошибки запись содержимого, содержащего символы ASCII NUL, не не работать, даже если
указана длина.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. Вместо этого в новом коде используйте вызов «запись».

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

xfs-админ
Устройство xfs-admin [extunwriting:true|false] [imgfile:true|false] [v2log:true|false] [projid32bit:true|false] [lazycounter:true|false] [метка:..] [uuid:.. ]

Измените параметры файловой системы XFS на «устройство».

Подключенные устройства не могут быть изменены. Администраторы должны размонтировать файловые системы
прежде чем этот вызов может изменить параметры.

Некоторые параметры смонтированной файловой системы можно проверить и изменить с помощью
Вызовы «xfs-info» и «xfs-growfs».

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

xfs-growfs
Путь xfs-growfs [datasec:true|false] [logsec:true|false] [rtsec:true|false] [datasize:N] [logsize:N] [rtsize:N] [rtextsize:N] [maxpct:N]

Увеличьте файловую систему XFS, смонтированную по пути.

Возвращенная структура содержит информацию о геометрии. Отсутствующие поля возвращаются как "-1"
(для числовых полей) или пустая строка.

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

xfs-информация
xfs-info путь к устройству

«pathordevice» — это смонтированная файловая система XFS или устройство, содержащее файловую систему XFS. Этот
Команда возвращает геометрию файловой системы.

Возвращенная структура содержит информацию о геометрии. Отсутствующие поля возвращаются как "-1"
(для числовых полей) или пустая строка.

xfs-ремонт
Устройство xfs-repair [forcelogzero:true|false] [nomodify:true|false] [noprefetch:true|false] [forcegeometry:true|false] [maxmem:N] [ihashsize:N] [bhashsize:N] [agstride: N] [logdev:..] [rtdev:..]

Восстановите поврежденную или поврежденную файловую систему XFS на «устройстве».

Файловая система указывается с использованием аргумента «устройство», которое должно быть именем устройства
раздел диска или том, содержащий файловую систему. Если дано имя блока
устройство, "xfs_repair" попытается найти необработанное устройство, связанное с указанным
заблокировать устройство и вместо этого будет использовать необработанное устройство.

В любом случае, восстанавливаемая файловая система должна быть размонтирована, иначе
файловая система может быть несовместимой или поврежденной.

Возвращаемый статус указывает, было ли обнаружено повреждение файловой системы (возвращает 1) или
не был обнаружен (возвращает 0).

У этой команды есть один или несколько необязательных аргументов. См. «ДОПОЛНИТЕЛЬНЫЕ АРГУМЕНТЫ».

зегреп
путь регулярного выражения zegrep

Это вызывает внешнюю программу "zegrep" и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

зегрепи
путь регулярного выражения Zegrepi

Это вызывает внешнюю программу "zegrep -i" и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

нуль
нулевое устройство

Эта команда записывает нули в первые несколько блоков «устройства».

Сколько блоков обнулено, не указано (но не достаточно, чтобы надежно стереть
устройство). Должно быть достаточно удалить любые таблицы разделов, суперблоки файловой системы
и так далее.

Если блоки уже нулевые, то эта команда избегает записи нулей. Это предотвращает
базовое устройство не становится неразреженным или необоснованно растет.

См. также: «нулевое устройство», «скраб-устройство», «нулевое устройство».

нулевое устройство
устройство с нулевым устройством

Эта команда записывает нули по всему «устройству». Сравните с «нулем», который просто
обнуляет первые несколько блоков устройства.

Если блоки уже нулевые, то эта команда избегает записи нулей. Это предотвращает
базовое устройство не становится неразреженным или необоснованно растет.

нулевое свободное пространство
каталог с нулевым свободным пространством

Обнуление свободного места в файловой системе, смонтированной на каталог. Файловая система должна быть
монтируется чтение-запись.

Содержимое файловой системы не затрагивается, но любое свободное место в файловой системе освобождается.

Свободное пространство не "обрезается". Вы можете вызвать "fstrim" как альтернативу
thisили после вызова this, в зависимости от ваших требований.

нулевой
нулевое устройство

Это запускает нулевой программа на "устройство". Эта программа претендует на отсутствие неиспользуемых инодов и
дисковые блоки в файловой системе ext2/3, что позволяет сжимать файловую систему
более эффективно.

Вы должны не запустите эту программу, если файловая система смонтирована.

Возможно, что использование этой программы может привести к повреждению файловой системы или данных на
файловая система.

zfgrep
путь шаблона zfgrep

Это вызывает внешнюю программу "zfgrep" и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

zfgrepi
путь шаблона zfgrepi

Это вызывает внешнюю программу «zfgrep -i» и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

Z-файл
zfile мета-путь

Эта команда работает файл после первой распаковки «пути» с использованием «метода».

«Метод» должен быть одним из «gzip», «compress» или «bzip2».

Начиная с версии 1.0.63 вместо этого используйте «файл», который теперь может обрабатывать сжатые файлы.

Эта функция is устарело. Вместо этого в новом коде используйте вызов "file".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

згреп
путь регулярного выражения zgrep

Это вызывает внешнюю программу «zgrep» и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

згрепи
путь регулярного выражения zgrepi

Это вызывает внешнюю программу «zgrep -i» и возвращает совпадающие строки.

Из-за протокола сообщений существует ограничение на передачу где-то между 2 МБ и
4 МБ. См. «ОГРАНИЧЕНИЯ ПРОТОКОЛА» в гость(3).

Эта функция is устарело. В новом коде вместо этого используйте вызов "grep".

Устаревшие функции не будут удалены из API, но тот факт, что они
deprecated указывает на наличие проблем с правильным использованием этих функций.

ВЫХОД статус

guestfish возвращает 0, если команды завершились без ошибок, или 1, если произошла ошибка.

ОКРУЖАЮЩАЯ СРЕДА ПЕРЕМЕННЫЕ

РЕДАКТОР
Команда "edit" использует $EDITOR в качестве редактора. Если не установлено, используется "vi".

GUESTFISH_DISPLAY_IMAGE
Команда display использует $GUESTFISH_DISPLAY_IMAGE для отображения изображений. Если не установлено, это
использования дисплей(1).

GUESTFISH_INIT
Печатается при запуске guestfish. См. «ПОДСКАЗКА».

GUESTFISH_OUTPUT
Печатается перед выводом guestfish. См. «ПОДСКАЗКА».

GUESTFISH_PID
Используется с --дистанционный пульт возможность указать удаленный процесс guestfish для управления. Видеть
раздел "ДИСТАНЦИОННОЕ УПРАВЛЕНИЕ ГОСТЕВОЙ НАД РОЗЕТКОЙ".

GUESTFISH_PS1
Установите командную строку. См. «ПОДСКАЗКА».

GUESTFISH_RESTORE
Печатается перед выходом guestfish. См. «ПОДСКАЗКА».

ГЕКСЕДИТОР
Команда "hexedit" использует $HEXEDITOR в качестве внешнего шестнадцатеричного редактора. Если не указано,
внешний гексагон(1) используется программа.

ГЛАВНАЯ
Если скомпилировано с поддержкой GNU readline, различные файлы в домашнем каталоге могут быть
использовал. См. "ФАЙЛЫ".

LIBGUESTFS_APPEND
Передайте дополнительные параметры гостевому ядру.

LIBGUESTFS_ATTACH_METHOD
Это старый способ установки "LIBGUESTFS_BACKEND".

LIBGUESTFS_BACKEND
Выберите способ по умолчанию для создания устройства. См. «guestfs_set_backend» в
гость(3).

LIBGUESTFS_BACKEND_SETTINGS
Разделенный двоеточием список настроек, специфичных для серверной части. См. "БЭКЭНД" в гость(3)
"НАСТРОЙКИ Бэкэнда" в гость(3).

LIBGUESTFS_CACHEDIR
Место, где libguestfs будет кэшировать свое устройство при использовании супермина
прибор. Устройство кэшируется и совместно используется всеми дескрипторами, имеющими одинаковые
эффективный идентификатор пользователя.

Если "LIBGUESTFS_CACHEDIR" не задано, используется "TMPDIR". Если "TMPDIR" не установлен,
тогда / Вар / TMP используется.

См. также «LIBGUESTFS_TMPDIR», «set-cachedir».

LIBGUESTFS_DEBUG
Установите "LIBGUESTFS_DEBUG=1", чтобы включить подробные сообщения. Это имеет тот же эффект, что и
используя -v опцию.

LIBGUESTFS_HV
Установите двоичный файл гипервизора по умолчанию (обычно qemu), который использует libguestfs. Если не установлено,
затем используется qemu, найденный во время компиляции скриптом configure.

LIBGUESTFS_MEMSIZE
Установите память, выделенную процессу qemu, в мегабайтах. Например:

LIBGUESTFS_MEMSIZE=700

LIBGUESTFS_PATH
Установите путь, который будет использоваться guestfish для поиска ядра и initrd.img. См.
обсуждение путей в гость(3).

LIBGUESTFS_QEMU
Это старый способ установки "LIBGUESTFS_HV".

LIBGUESTFS_TMPDIR
Место, где libguestfs будет хранить временные файлы, используемые каждым дескриптором.

Если "LIBGUESTFS_TMPDIR" не задано, используется "TMPDIR". Если "TMPDIR" не установлен,
тогда / Tmp используется.

См. также «LIBGUESTFS_CACHEDIR», «set-tmpdir».

LIBGUESTFS_TRACE
Установите «LIBGUESTFS_TRACE=1», чтобы включить трассировку команд.

ПЕЙДЖЕРА
Команда "больше" использует $PAGER в качестве пейджера. Если не установлено, используется «больше».

PATH
Libguestfs и guestfish могут запускать некоторые внешние программы и полагаться на установленный $PATH
до разумного значения. Если вы используете серверную часть libvirt, libvirt вообще не будет работать.
если только $PATH не содержит путь к qemu/KVM.

СУПЕРМИН_КЕРНЕЛЬ
SUPERMIN_KERNEL_VERSION
SUPERMIN_MODULES
Эти три переменные среды позволяют ядру, которое libguestfs использует в
прибор, который необходимо выбрать. Если $SUPERMIN_KERNEL не установлен, то самый последний хост
выбрано ядро. Дополнительные сведения о выборе ядра см. супермин(1).

TMPDIR
См. «LIBGUESTFS_CACHEDIR», «LIBGUESTFS_TMPDIR».

Используйте guestfish онлайн с помощью сервисов onworks.net