virt-ls(1)                  Virtualization Support                  virt-ls(1)


<?><?><?> (NAME)
       virt-ls - <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
        virt-ls [--options] -d domname directory [directory ...]

        virt-ls [--options] -a disk.img [-a disk.img ...] directory [directory ...]

       <?><?><?><?> <?><?><?><?><?>:

        virt-ls [--options] domname directory

        virt-ls [--options] disk.img [disk.img ...] directory
       "virt-ls" <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (checksums)<?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> (extended attributes) <?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> libvirt <?><?> <?><?><?><?><?> -d <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> -a <?><?><?><?><?><?><?> <?><?><?><?>.

       "virt-ls" <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> guestfish(1) <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> API guestfs(3) <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?>:

        virt-ls -R -d guest /

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> setuid
       <?><?> setgid <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>:

        virt-ls -lR -d guest / | grep '^- [42]'

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> (public-writable) <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>:

        virt-ls -lR -d guest / | grep '^d ...7'

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> (Unix domain sockets) <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

        virt-ls -lR -d guest / | grep '^s'

       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> `.png' <?><?><?>
       <?><?><?><?><?><?>:

        virt-ls -lR -d guest / | grep -i '^-.*\.png$'

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> 10MB <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> home:

        virt-ls -lR -d guest /home | awk '$3 > 10*1024*1024'

       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> 7 <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?>:

        virt-ls -lR -d guest --time-days / | awk '$6 <= 7'

       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> 24 <?><?><?><?> <?><?><?><?><?>:

        virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'

   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (DIFFERENCES IN
       SNAPSHOTS AND BACKING FILES)
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> virt-ls <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> libguestfs >= 1.26
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> virt-diff(1) <?><?>
       <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (OUTPUT MODES)
       "virt-ls" <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> -l <?> -R <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

   <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (SIMPLE LISTING)
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> ls(1) <?><?><?>:

        $ virt-ls -d guest /
        bin
        boot
        [etc.]
       <?><?> <?><?><?><?><?><?> -l (--long)<?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> "ls -l"
       <?><?><?><?><?> <?><?><?> (<?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> "guestfs_ll").

        $ 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
        [etc.]

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>. <?><?> <?><?><?> <?><?> <<<?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (RECURSIVE LONG LISTING)>>
       <?><?><?><?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (RECURSIVE LISTING)
       <?><?> <?><?><?><?><?><?> -R (--recursive)<?> <?><?><?><?><?> "virt-ls"
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

        $ virt-ls -R -d guest /tmp
        foo
        foo/bar
        [etc.]

       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> "virt-ls"
       <?><?><?><?> "guestfs_find0" <?><?> <?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> "\0" <?><?> <?><?> "\n" <?><?><?><?><?>
       <?><?><?><?><?><?>.

   <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       (RECURSIVE LONG LISTING)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> -lR <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (checksum)
       <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       (extended attributes) <?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       "virt-ls" <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> -lR <?><?> <?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?>). <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?> "virt-ls"
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> (newline)<?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> --csv (<?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?>) <?><?><?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       "ls -lR" <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?>.

        $ 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
        [etc.]

       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>:

       type
           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?>: "-" (<?><?><?><?> <?><?><?><?>)<?> "d"
           (<?><?><?><?><?><?><?><?><?>)<?> "c" (<?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?>)<?> "b" (<?><?><?><?><?><?>
           <?><?><?><?><?>)<?> "p" (<?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?>)<?> "l" (<?><?><?><?><?>
           <?><?><?><?><?><?>)<?> "s" (<?><?><?><?>) <?><?> "u"
           (<?><?><?><?><?><?><?><?>).

       permissions
           <?><?><?><?><?><?><?> Unix<?> <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?> <?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       size
           <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> -h <?><?>
           --human-readable <?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?>.

       path
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?>.

       link
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       <?><?> <?><?><?><?> -lR<?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?> <?><?><?><?> --uids<?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>:

       uid
       gid <?><?><?><?><?><?> UID <?> GID <?><?><?><?> <?><?><?><?>
           (<?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>).  <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?>.

       <?><?> <?><?><?><?> --times<?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>:

       atime
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       mtime
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       ctime
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?> --time-t<?> --time-relative
       <?><?> --time-days <?><?><?><?> <?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?> --extra-stats<?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>:

       device
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?>
           <?><?><?><?> (<?><?><?><?><?><?><?> major:minor <?><?><?><?><?>
           <?><?><?><?><?><?><?>).  <?><?><?> <?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?>.

       inode
           <?><?><?><?><?><?> inode.

       nlink
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> (hard links).

       rdev
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           (<?><?><?><?><?><?><?> major:minor <?><?><?><?><?>
           <?><?><?><?><?><?><?>).

       blocks
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>.

       <?><?> <?><?><?><?> --checksum<?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>).
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>..SH
       "<?><?><?><?><?><?><?><?> (OPTIONS)"

       --help
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.

       -a file
       --add file
           <?><?><?><?><?><?> file <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?><?><?><?><?><?> -a <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>.

           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> --format=.. <?><?><?><?><?><?><?> <?><?><?><?>.

       -a URI
       --add URI
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?> <<ADDING REMOTE STORAGE>> <?><?> <?><?> guestfish(1)
           <?><?><?><?><?><?>.

       --blocksize=512
       --blocksize=4096
       --blocksize
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?><?><?>
           <?><?> --blocksize <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?>
           <<guestfs_add_drive_opts>> <?><?> <?><?> guestfs(3)
           <?><?><?><?><?><?>.

       --checksum
       --checksum=crc|md5|sha1|sha224|sha256|sha384|sha512
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> md5 <?><?><?>. <?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?> <?><?><?><?>. <?><?><?> <<RECURSIVE
           LONG LISTING>> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -c URI
       --connect URI
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> libvirt<?> <?><?>
           URI <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
           <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> libvirt
           <?><?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> (-a)<?> <?><?><?><?><?><?> libvirt <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>.

       --csv
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> CSV
           (<?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>).
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?> <<NOTE ABOUT CSV FORMAT>> <?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       -d guest
       --domain guest
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> libvirt <?><?><?><?><?><?><?><?><?><?><?><?>.
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           UUID <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       --echo-keys
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
           <?><?><?><?><?><?> <?><?><?><?><?> virt-ls <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?> Tempest
           <?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.

       --extra-stats
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?> <?><?><?><?>. <?><?><?> <<RECURSIVE
           LONG LISTING>> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --format=raw|qcow2|..
       --format
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           -a <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> -a <?><?> <?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?> --format
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> -a <?><?>
           <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?>.

           <?><?><?><?> <?><?><?><?>:

            virt-ls --format=raw -a disk.img /dir

           <?><?><?><?> raw (<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>)
           <?><?> <?><?><?><?> disk.img <?><?><?><?><?> <?><?><?><?><?><?>.

            virt-ls --format=raw -a disk.img --format -a another.img /dir

           <?><?><?><?> raw (<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>)
           <?><?> <?><?><?><?> disk.img <?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?> another.img <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           raw <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.
           <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?> (CVE-2010-3851).

       -h
       --human-readable
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?> <?><?><?><?>. <?><?><?> <<RECURSIVE
           LONG LISTING>> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --key SELECTOR
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> LUKS<?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> LUKS
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           (inspection).

           --key NAME:key:KEY_STRING
           --key UUID:key:KEY_STRING
           --key all:key:KEY_STRING
               "NAME" <?><?><?> <?><?><?><?><?><?> <?><?> libguestfs <?><?><?>
               (<?><?><?><?><?> "/dev/sda1"). <?><?><?><?><?> "UUID"
               <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?>. <?><?><?><?><?> "all" <?><?> <?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.

               <?><?> "KEY_STRING" <?><?><?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

           --key NAME:file:FILENAME
           --key UUID:file:FILENAME
           --key all:file:FILENAME
               <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
               FILENAME.

           --key NAME:clevis
           --key UUID:clevis
           --key all:clevis
               <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?><?><?><?> Clevis. <?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?><?> <?><?> <?><?><?><?> (NBDE) <?><?> <?><?><?>
               <<ENCRYPTED DISKS>> <?><?> guestfs(3) <?><?><?><?><?><?>
               <?><?><?><?>.

               <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
               <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
               <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?><?><?> QEMU <?><?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?> <?><?><?><?> libguestfs <?><?><?><?>
               <?><?><?><?><?> <?><?>.

       --keys-from-stdin
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> stdin. <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?> /dev/tty <?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?><?> stdin <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?>
           <?><?><?><?>.

       -m dev[:mountpoint[:options[:fstype]]]
       --mount dev[:mountpoint[:options[:fstype]]]
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> (logical
           volume) <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> (mountpoint) <?><?><?><?><?><?><?><?> <?><?><?><?>
           (mount) <?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> / <?><?><?><?><?> <?><?><?>.

           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?> <?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> guestfish
           <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> LV<?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           (<?><?><?><?><?><?><?><?> "list-partitions"<?> "list-filesystems"
           <?> "lvs" <?><?> <?><?><?><?><?><?>)<?> <?><?> <?><?>
           <?><?><?><?><?><?><?> virt-filesystems(1) <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

           <?><?><?> <?><?><?> (<?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?>) <?><?> <?><?><?><?><?><?><?>
           mount<?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
           <?><?> "ro" <?><?><?><?><?><?> <?><?><?> (<?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> --ro
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>). <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> ACL<?><?> <?>/<?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> (extended attributes) <?><?>
           <?><?><?><?> <?><?><?><?>:

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

           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> "mount-options"
           <?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> "ext3" <?><?> "ntfs"
           <?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           (<?><?><?><?> <?><?><?><?><?>: "ext2" <?> "ext3")<?> <?><?>
           <?><?><?> libguestfs <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.
       -l
       --long
       -R
       --recursive
           <?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> "virt-ls" <?><?>
           <?><?><?><?><?> <?><?><?><?> <?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> "SIMPLE LISTING"
           <?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> "virt-ls -l" <?><?>
           <<<?><?><?><?><?><?><?><?><?><?> <?><?><?><?>>> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> "LONG LISTING"
           <?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> "virt-ls -R" <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?> "RECURSIVE LISTING" <?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?> "virt-ls -lR" <?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> (parse) <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?><?> "RECURSIVE LONG
           LISTING" <?><?> <?><?><?><?><?><?>.

       --times
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?><?><?> <?><?><?><?>. <?><?><?>
           "RECURSIVE LONG LISTING" <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?>.

       --time-days
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           (<?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?>).

           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> 0 <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <<<?><?><?><?><?><?> <?>
           <?><?><?> <?><?><?> <?><?> <?><?><?><?><?>>> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?><?><?> <?><?><?><?>. <?><?><?>
           "RECURSIVE LONG LISTING" <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?>.

       --time-relative
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?> (<?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?>).

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?><?><?> <?><?><?><?>. <?><?><?>
           "RECURSIVE LONG LISTING" <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?>.

       --time-t
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?> (Unix epoch).

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?><?><?> <?><?><?><?>. <?><?><?>
           "RECURSIVE LONG LISTING" <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?>.

       --uids
           <?><?><?><?><?> <?><?><?><?><?><?><?> UID <?> GID.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> -lR <?><?><?><?><?> <?><?><?><?>. <?><?><?>
           "RECURSIVE LONG LISTING" <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?>.

       -v
       --verbose
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           (verbose) <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.

       -V
       --version
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>.

       -x  <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (tracing)
           <?><?><?><?><?><?><?><?><?><?><?><?> API <?><?><?><?><?> <?><?>
           libguestfs..SH "<?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> (OLD-STYLE COMMAND
           LINE ARGUMENTS)" <?><?><?><?><?><?><?><?> <?><?><?><?><?> virt-ls
           <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?>:

        virt-ls disk.img [disk.img ...] /dir

       <?><?>

        virt-ls guestname /dir

       <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> -a <?><?> -d <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> CSV (NOTE ABOUT CSV
       FORMAT)
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> (CSV)
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>. <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?>: <?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?>: <?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>:

        "foo,bar",baz

       <?><?><?><?> <?><?><?>: <?><?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?>: <?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?>:

        "foo
        bar",baz

       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> "csvtool" <?><?><?><?><?><?><?> <?><?><?><?>
       (https://github.com/Chris00/ocaml-csv <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>).

       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> CSV <?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?><?><?><?> "Text::CSV" <?><?><?><?> Perl <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> csv <?><?> Python).

       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> CSV <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       0<?> <?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       guestfs(3), guestfish(1), virt-cat(1), virt-copy-out(1), virt-diff(1),
       virt-tar-out(1), http://libguestfs.org.

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Richard W.M. Jones http://people.redhat.com/~rjones

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       Copyright (C) 2009-2025 Red Hat Inc.

<?><?><?><?> (LICENSE)
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <<<?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>>> (GNU General Public License)
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?> <?><?><?><?>
       <?><?> (<?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?>
       <?><?><?><?> <?><?><?><?> <?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>: Free Software Foundation, Inc., 51 Franklin Street, Fifth
       Floor, Boston, MA 02110-1301 USA..SH "<?><?><?><?><?>
       <?><?><?><?><?><?> (BUGS)" <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       libguestfs<?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       libguestfs<?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>:

       o   <?><?><?><?><?> libguestfs.

       o   <?><?><?> <?><?><?><?><?><?> libguestfs (<?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?>
           <?><?><?><?>).

       o   <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?>.

       o   <?><?><?><?><?> libguestfs-test-tool(1) <?><?> <?><?><?><?>
           <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>.

guestfs-tools-1.56.0              2026-07-11                        virt-ls(1)