.\" Automatically generated by Podwrapper::Man 1.32.7 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "virt-ls 1"
.TH virt-ls 1 "2016-08-08" "libguestfs-1.32.7" "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "НАЗВА"
.IX Header "НАЗВА"
virt-ls — програма для показу списку файлів у віртуальній машині
.SH "КОРОТКИЙ ОПИС"
.IX Header "КОРОТКИЙ ОПИС"
.Vb 1
\& virt\-ls [\-\-параметри] \-d назва_домену каталог [каталог ...]
\&
\& virt\-ls [\-\-параметри] \-a диск.img [\-a диск.img ...] каталог [каталог ...]
.Ve
.PP
Старий стиль:
.PP
.Vb 1
\& virt\-ls [\-\-параметри] назва_домену каталог
\&
\& virt\-ls [\-\-параметри] диск.img [диск.img ...] каталог
.Ve
.SH "ОПИС"
.IX Header "ОПИС"
\&\f(CW\*(C`virt\-ls\*(C'\fR lists filenames, file sizes, checksums, extended attributes and
more from a virtual machine or disk image.
.PP
Multiple directory names can be given, in which case the output from each is
concatenated.
.PP
To list directories from a libvirt guest use the \fI\-d\fR option to specify the
name of the guest.  For a disk image, use the \fI\-a\fR option.
.PP
\&\f(CW\*(C`virt\-ls\*(C'\fR can do many simple file listings.  For more complicated cases you
may need to use \fIguestfish\fR\|(1), or write a program directly to the
\&\fIguestfs\fR\|(3) \s-1API.\s0
.SH "ПРИКЛАДИ"
.IX Header "ПРИКЛАДИ"
Отримати список всіх файлів і каталогів у віртуальній машині:
.PP
.Vb 1
\& virt\-ls \-R \-d guest /
.Ve
.PP
Показати список всіх програм з setuid або setgid у віртуальній машині Linux:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest / | grep \*(Aq^\- [42]\*(Aq
.Ve
.PP
Показати список всіх каталогів з відкритим для всіх доступом на запис у
віртуальній машині Linux:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest / | grep \*(Aq^d ...7\*(Aq
.Ve
.PP
Показати список всіх сокетів доменів Unix у віртуальній машині Linux:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest / | grep \*(Aq^s\*(Aq
.Ve
.PP
Показати список всіх звичайних файлів, назви яких завершуються на «.png»:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest / | grep \-i \*(Aq^\-.*\e.png$\*(Aq
.Ve
.PP
Щоб переглянути список файлів у домашніх каталогах, розмір яких перевищує 10
МБ:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest /home | awk \*(Aq$3 > 10*1024*1024\*(Aq
.Ve
.PP
Знайти всі об’єкти, які було змінено протягом попередніх 7 днів:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest \-\-time\-days / | awk \*(Aq$6 <= 7\*(Aq
.Ve
.PP
Знайти звичайні файли, зміни до яких було внесено протягом попередніх 24
годин:
.PP
.Vb 1
\& virt\-ls \-lR \-d guest \-\-time\-days / | grep \*(Aq^\-\*(Aq | awk \*(Aq$6 < 1\*(Aq
.Ve
.SS "\s-1DIFFERENCES IN SNAPSHOTS AND BACKING FILES\s0"
.IX Subsection "DIFFERENCES IN SNAPSHOTS AND BACKING FILES"
Although it is possible to use virt-ls to look for differences, since
libguestfs ≥ 1.26 a new tool is available called \fIvirt\-diff\fR\|(1).
.SH "РЕЖИМИ ВИВЕДЕННЯ ДАНИХ"
.IX Header "РЕЖИМИ ВИВЕДЕННЯ ДАНИХ"
\&\f(CW\*(C`virt\-ls\*(C'\fR has four output modes, controlled by different combinations of
the \fI\-l\fR and \fI\-R\fR options.
.SS "ПРОСТИЙ СПИСОК"
.IX Subsection "ПРОСТИЙ СПИСОК"
Простий список, подібний до списку звичайної команди \fIls\fR\|(1):
.PP
.Vb 4
\& $ virt\-ls \-d guest /
\& bin
\& boot
\& [тощо]
.Ve
.SS "ДОВГИЙ СПИСОК"
.IX Subsection "ДОВГИЙ СПИСОК"
With the \fI\-l\fR (\fI\-\-long\fR) option, the output is like the \f(CW\*(C`ls \-l\*(C'\fR command
(more specifically, like the \f(CW\*(C`guestfs_ll\*(C'\fR function).
.PP
.Vb 5
\& $ virt\-ls \-l \-d guest /
\& total 204
\& dr\-xr\-xr\-x.   2 root root   4096 2009\-08\-25 19:06 bin
\& dr\-xr\-xr\-x.   5 root root   3072 2009\-08\-25 19:06 boot
\& [тощо]
.Ve
.PP
Note that while this is useful for displaying a directory, do not try
parsing this output in another program.  Use \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0
instead.
.SS "РЕКУРСИВНИЙ СПИСОК"
.IX Subsection "РЕКУРСИВНИЙ СПИСОК"
With the \fI\-R\fR (\fI\-\-recursive\fR) option, \f(CW\*(C`virt\-ls\*(C'\fR lists the names of files
and directories recursively:
.PP
.Vb 4
\& $ virt\-ls \-R \-d guest /tmp
\& foo
\& foo/bar
\& [тощо]
.Ve
.PP
To generate this output, \f(CW\*(C`virt\-ls\*(C'\fR runs the \f(CW\*(C`guestfs_find0\*(C'\fR function and
converts \f(CW\*(C`\e0\*(C'\fR characters to \f(CW\*(C`\en\*(C'\fR.
.SS "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК"
.IX Subsection "РЕКУРСИВНИЙ ДОВГИЙ СПИСОК"
Using \fI\-lR\fR options together changes the output to display directories
recursively, with file stats, and optionally other features such as
checksums and extended attributes.
.PP
Most of the interesting features of \f(CW\*(C`virt\-ls\*(C'\fR are only available when using
\&\fI\-lR\fR mode.
.PP
The fields are normally space-separated.  Filenames are \fBnot\fR quoted, so
you cannot use the output in another program (because filenames can contain
spaces and other unsafe characters).  If the guest was untrusted and someone
knew you were using \f(CW\*(C`virt\-ls\*(C'\fR to analyze the guest, they could play tricks
on you by creating filenames with embedded newline characters.  To \fBsafely\fR
parse the output in another program, use the \fI\-\-csv\fR (Comma-Separated
Values) option.
.PP
Note that this output format is completely unrelated to the \f(CW\*(C`ls \-lR\*(C'\fR
command.
.PP
.Vb 8
\& $ virt\-ls \-lR \-d guest /bin
\& d 0555       4096 /bin
\& \- 0755        123 /bin/alsaunmute
\& \- 0755      28328 /bin/arch
\& l 0777          4 /bin/awk \-> gawk
\& \- 0755      27216 /bin/basename
\& \- 0755     943360 /bin/bash
\& [тощо]
.Ve
.PP
Ці основні поля буде показано завжди:
.IP "тип" 4
.IX Item "тип"
The file type, one of: \f(CW\*(C`\-\*(C'\fR (regular file), \f(CW\*(C`d\*(C'\fR (directory), \f(CW\*(C`c\*(C'\fR
(character device), \f(CW\*(C`b\*(C'\fR (block device), \f(CW\*(C`p\*(C'\fR (named pipe), \f(CW\*(C`l\*(C'\fR (symbolic
link), \f(CW\*(C`s\*(C'\fR (socket) or \f(CW\*(C`u\*(C'\fR (unknown).
.IP "права доступу" 4
.IX Item "права доступу"
The Unix permissions, displayed as a 4 digit octal number.
.IP "розмір" 4
.IX Item "розмір"
The size of the file.  This is shown in bytes unless \fI\-h\fR or
\&\fI\-\-human\-readable\fR option is given, in which case this is shown as a
human-readable number.
.IP "шлях" 4
.IX Item "шлях"
Шлях до файла або каталогу повністю.
.IP "посилання" 4
.IX Item "посилання"
Лише для символічних посилань, призначення посилання.
.PP
In \fI\-lR\fR mode, additional command line options enable the display of more
fields.
.PP
With the \fI\-\-uids\fR flag, these additional fields are displayed before the
path:
.IP "uid" 4
.IX Item "uid"
.PD 0
.IP "gid" 4
.IX Item "gid"
.PD
The \s-1UID\s0 and \s-1GID\s0 of the owner of the file (displayed numerically).  Note
these only make sense in the context of a Unix-like guest.
.PP
With the \fI\-\-times\fR flag, these additional fields are displayed:
.IP "atime" 4
.IX Item "atime"
Час останнього доступу.
.IP "mtime" 4
.IX Item "mtime"
Час останнього внесення змін.
.IP "ctime" 4
.IX Item "ctime"
Час останньої зміни стану.
.PP
The time fields are displayed as string dates and times, unless one of the
\&\fI\-\-time\-t\fR, \fI\-\-time\-relative\fR or \fI\-\-time\-days\fR flags is given.
.PP
With the \fI\-\-extra\-stats\fR flag, these additional fields are displayed:
.IP "пристрій" 4
.IX Item "пристрій"
The device containing the file (displayed as major:minor).  This may not
match devices as known to the guest.
.IP "inode" 4
.IX Item "inode"
Номер inode.
.IP "nlink" 4
.IX Item "nlink"
Кількість жорстких посилань.
.IP "rdev" 4
.IX Item "rdev"
For block and char special files, the device (displayed as major:minor).
.IP "блоки" 4
.IX Item "блоки"
Кількість 512\-байтових блоків, виділених під файл.
.PP
With the \fI\-\-checksum\fR flag, the checksum of the file contents is shown
(only for regular files).  Computing file checksums can take a considerable
amount of time.
.SH "ПАРАМЕТРИ"
.IX Header "ПАРАМЕТРИ"
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
Показати коротку довідку.
.IP "\fB\-a\fR файл" 4
.IX Item "-a файл"
.PD 0
.IP "\fB\-\-add\fR файл" 4
.IX Item "--add файл"
.PD
Add \fIfile\fR which should be a disk image from a virtual machine.  If the
virtual machine has multiple block devices, you must supply all of them with
separate \fI\-a\fR options.
.Sp
Формат образу диска визначається автоматично. Щоб перевизначити його і
примусово використати певний формат, скористайтеся параметром
\&\fI\-\-format=..\fR.
.IP "\fB\-a адреса\fR" 4
.IX Item "-a адреса"
.PD 0
.IP "\fB\-\-add адреса\fR" 4
.IX Item "--add адреса"
.PD
Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fIguestfish\fR\|(1).
.IP "\fB\-\-checksum\fR" 4
.IX Item "--checksum"
.PD 0
.IP "\fB\-\-checksum=crc|md5|sha1|sha224|sha256|sha384|sha512\fR" 4
.IX Item "--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512"
.PD
Display checksum over file contents for regular files.  With no argument,
this defaults to using \fImd5\fR.  Using an argument, you can select the
checksum type to use.
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-c\fR адреса" 4
.IX Item "-c адреса"
.PD 0
.IP "\fB\-\-connect\fR адреса" 4
.IX Item "--connect адреса"
.PD
Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо
пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.
.Sp
Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR),
libvirt не буде використовуватися взагалі.
.IP "\fB\-\-csv\fR" 4
.IX Item "--csv"
Write out the results in \s-1CSV\s0 format (comma-separated values).  This format
can be imported easily into databases and spreadsheets, but read \*(L"\s-1NOTE
ABOUT CSV FORMAT\*(R"\s0 below.
.IP "\fB\-d\fR гість" 4
.IX Item "-d гість"
.PD 0
.IP "\fB\-\-domain\fR гість" 4
.IX Item "--domain гість"
.PD
Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна
використовувати замість назв.
.IP "\fB\-\-echo\-keys\fR" 4
.IX Item "--echo-keys"
When prompting for keys and passphrases, virt-ls normally turns echoing off
so you cannot see what you are typing.  If you are not worried about Tempest
attacks and there is no one else in the room you can specify this flag to
see what you are typing.
.IP "\fB\-\-extra\-stats\fR" 4
.IX Item "--extra-stats"
Показати додаткові дані.
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-\-format=raw|qcow2|..\fR" 4
.IX Item "--format=raw|qcow2|.."
.PD 0
.IP "\fB\-\-format\fR" 4
.IX Item "--format"
.PD
Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату
образу диска. Використання цього параметра примусово визначає значення
параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання
параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного
визначення у наступних параметрах \fI\-a\fR.
.Sp
Приклад:
.Sp
.Vb 1
\& virt\-ls \-\-format=raw \-a диск.img /каталог
.Ve
.Sp
примусове встановлення формату без обробки (без автоматичного визначення)
для \fIdisk.img\fR.
.Sp
.Vb 1
\& virt\-ls \-\-format=raw \-a диск.img \-\-format \-a інший_диск.img /каталог
.Ve
.Sp
примусове встановлення формату без обробки (без автоматичного визначення)
для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR.
.Sp
Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому
форматі, вам слід скористатися цим параметром для визначення формату
диска. Таким чином можна уникнути можливих проблем з захистом для
сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0).
.IP "\fB\-h\fR" 4
.IX Item "-h"
.PD 0
.IP "\fB\-\-human\-readable\fR" 4
.IX Item "--human-readable"
.PD
Показати розміри файлів у зручному для читання форматі.
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-\-keys\-from\-stdin\fR" 4
.IX Item "--keys-from-stdin"
Read key or passphrase parameters from stdin.  The default is to try to read
passphrases from the user by opening \fI/dev/tty\fR.
.IP "\fB\-m пристрій[:точка_монтування[:параметри[:тип_файлової_системи]]]\fR" 4
.IX Item "-m пристрій[:точка_монтування[:параметри[:тип_файлової_системи]]]"
.PD 0
.IP "\fB\-\-mount пристрій[:точка_монтування[:параметри[:тип_файлової_системи]]]\fR" 4
.IX Item "--mount пристрій[:точка_монтування[:параметри[:тип_файлової_системи]]]"
.PD
Змонтувати названий розділ або логічний том до вказаної точки монтування.
.Sp
If the mountpoint is omitted, it defaults to \fI/\fR.
.Sp
Specifying any mountpoint disables the inspection of the guest and the mount
of its root and all of its mountpoints, so make sure to mount all the
mountpoints needed to work with the filenames given as arguments.
.Sp
If you don't know what filesystems a disk image contains, you can either run
guestfish without this option, then list the partitions, filesystems and LVs
available (see \*(L"list-partitions\*(R", \*(L"list-filesystems\*(R" and \*(L"lvs\*(R"
commands), or you can use the \fIvirt\-filesystems\fR\|(1) program.
.Sp
The third (and rarely used) part of the mount parameter is the list of mount
options used to mount the underlying filesystem.  If this is not given, then
the mount options are either the empty string or \f(CW\*(C`ro\*(C'\fR (the latter if the
\&\fI\-\-ro\fR flag is used).  By specifying the mount options, you override this
default choice.  Probably the only time you would use this is to enable ACLs
and/or extended attributes if the filesystem can support them:
.Sp
.Vb 1
\& \-m /dev/sda1:/:acl,user_xattr
.Ve
.Sp
Using this flag is equivalent to using the \f(CW\*(C`mount\-options\*(C'\fR command.
.Sp
The fourth part of the parameter is the filesystem driver to use, such as
\&\f(CW\*(C`ext3\*(C'\fR or \f(CW\*(C`ntfs\*(C'\fR. This is rarely needed, but can be useful if multiple
drivers are valid for a filesystem (eg: \f(CW\*(C`ext2\*(C'\fR and \f(CW\*(C`ext3\*(C'\fR), or if
libguestfs misidentifies a filesystem.
.IP "\fB\-l\fR" 4
.IX Item "-l"
.PD 0
.IP "\fB\-\-long\fR" 4
.IX Item "--long"
.IP "\fB\-R\fR" 4
.IX Item "-R"
.IP "\fB\-\-recursive\fR" 4
.IX Item "--recursive"
.PD
Select the mode.  With neither of these options, \f(CW\*(C`virt\-ls\*(C'\fR produces a
simple, flat list of the files in the named directory.  See \*(L"\s-1SIMPLE
LISTING\*(R"\s0.
.Sp
\&\f(CW\*(C`virt\-ls \-l\*(C'\fR produces a \*(L"long listing\*(R", which shows more detail.  See
\&\*(L"\s-1LONG LISTING\*(R"\s0.
.Sp
\&\f(CW\*(C`virt\-ls \-R\*(C'\fR produces a recursive list of files starting at the named
directory.  See \*(L"\s-1RECURSIVE LISTING\*(R"\s0.
.Sp
\&\f(CW\*(C`virt\-ls \-lR\*(C'\fR produces a recursive long listing which can be more easily
parsed.  See \*(L"\s-1RECURSIVE LONG LISTING\*(R"\s0.
.IP "\fB\-\-times\fR" 4
.IX Item "--times"
Показати поля часу.
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-\-time\-days\fR" 4
.IX Item "--time-days"
Display time fields as days before now (negative if in the future).
.Sp
Note that \f(CW0\fR in output means \*(L"up to 1 day before now\*(R", or that the age of
the file is between 0 and 86399 seconds.
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-\-time\-relative\fR" 4
.IX Item "--time-relative"
Display time fields as seconds before now (negative if in the future).
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-\-time\-t\fR" 4
.IX Item "--time-t"
Display time fields as seconds since the Unix epoch.
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-\-uids\fR" 4
.IX Item "--uids"
Показати поля \s-1UID\s0 і \s-1GID.\s0
.Sp
This option only has effect in \fI\-lR\fR output mode.  See \*(L"\s-1RECURSIVE LONG
LISTING\*(R"\s0 above.
.IP "\fB\-v\fR" 4
.IX Item "-v"
.PD 0
.IP "\fB\-\-verbose\fR" 4
.IX Item "--verbose"
.PD
Увімкнути докладний показ повідомлень з метою діагностики.
.IP "\fB\-V\fR" 4
.IX Item "-V"
.PD 0
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
.PD
Показати дані щодо версії і завершити роботу.
.IP "\fB\-x\fR" 4
.IX Item "-x"
Увімкнути трасування викликів програмного інтерфейсу libguestfs.
.SH "ПАРАМЕТРИ КОМАНДНОГО РЯДКА У ФОРМАТІ ПОПЕРЕДНІХ ВЕРСІЙ"
.IX Header "ПАРАМЕТРИ КОМАНДНОГО РЯДКА У ФОРМАТІ ПОПЕРЕДНІХ ВЕРСІЙ"
У попередніх версіях virt-ls можна було використовувати або
.PP
.Vb 1
\& virt\-ls диск.img [диск.img ...] /каталог
.Ve
.PP
або
.PP
.Vb 1
\& virt\-ls назва_гостьової_системи /каталог
.Ve
.PP
whereas in this version you should use \fI\-a\fR or \fI\-d\fR respectively to avoid
the confusing case where a disk image might have the same name as a guest.
.PP
З міркувань зворотної сумісності передбачено підтримку запису параметрів у
застарілому форматі.
.SH "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
.IX Header "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV"
Comma-separated values (\s-1CSV\s0) is a deceptive format.  It \fIseems\fR like it
should be easy to parse, but it is definitely not easy to parse.
.PP
Myth: Just split fields at commas.  Reality: This does \fInot\fR work
reliably.  This example has two columns:
.PP
.Vb 1
\& "foo,bar",baz
.Ve
.PP
Myth: Read the file one line at a time.  Reality: This does \fInot\fR work
reliably.  This example has one row:
.PP
.Vb 2
\& "foo
\& bar",baz
.Ve
.PP
For shell scripts, use \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv
also packaged in major Linux distributions).
.PP
For other languages, use a \s-1CSV\s0 processing library (eg. \f(CW\*(C`Text::CSV\*(C'\fR for Perl
or Python's built-in csv library).
.PP
Most spreadsheets and databases can import \s-1CSV\s0 directly.
.SH "СТАН ВИХОДУ"
.IX Header "СТАН ВИХОДУ"
Ця програма повертає значення 0 у разі успішного завершення і ненульове
значення, якщо сталася помилка.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
\&\fIguestfs\fR\|(3), \fIguestfish\fR\|(1), \fIvirt\-cat\fR\|(1), \fIvirt\-copy\-out\fR\|(1),
\&\fIvirt\-diff\fR\|(1), \fIvirt\-tar\-out\fR\|(1), http://libguestfs.org/.
.SH "АВТОР"
.IX Header "АВТОР"
Richard W.M. Jones http://people.redhat.com/~rjones/
.SH "АВТОРСЬКІ ПРАВА"
.IX Header "АВТОРСЬКІ ПРАВА"
Copyright (C) 2009\-2016 Red Hat Inc.
.SH "LICENSE"
.IX Header "LICENSE"
.SH "BUGS"
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
.IP "\(bu" 4
The version of libguestfs.
.IP "\(bu" 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
.IP "\(bu" 4
Describe the bug accurately and give a way to reproduce it.
.IP "\(bu" 4
Run \fIlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.