bionic (1) virt-make-fs.1.gz

Provided by: libguestfs-tools_1.36.13-1ubuntu3.3_amd64 bug

名前

       virt-make-fs - tar アーカイブまたはファイルからファイルシステムの作成

書式

        virt-make-fs [--options] input.tar output.img

        virt-make-fs [--options] input.tar.gz output.img

        virt-make-fs [--options] directory output.img

説明

       Virt-make-fs is a command line tool for creating a filesystem from a tar archive or some files in a
       directory.  It is similar to tools like mkisofs(1), genisoimage(1) and mksquashfs(1).  Unlike those
       tools, it can create common filesystem types like ext2/3 or NTFS, which can be useful if you want to
       attach these filesystems to existing virtual machines (eg. to import large amounts of read-only data to a
       VM).

       To create blank disks, use virt-format(1).  To create complex layouts, use guestfish(1).

       基本的な使用法は次のとおりです:

        virt-make-fs input output.img

       where "input" is either a directory containing files that you want to add, or a tar archive (either
       uncompressed tar or gzip-compressed tar); and output.img is a disk image.  The input type is detected
       automatically.  The output disk image defaults to a raw ext2 sparse image unless you specify extra flags
       (see "OPTIONS" below).

   ファイルシステム形式
       The default filesystem type is "ext2".  Just about any filesystem type that libguestfs supports can be
       used (but not read-only formats like ISO9660).  Here are some of the more common choices:

       ext3
           Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If you are not going to use
           the filesystem in a way that requires the journal, then this is just wasted overhead.

       ntfs または vfat
           Useful if exporting data to a Windows guest.

       minix
           Lower overhead than "ext2", but certain limitations on filename length and total filesystem size.

       

        virt-make-fs --type=minix input minixfs.img

   TO PARTITION OR NOT TO PARTITION
       Optionally virt-make-fs can add a partition table to the output disk.

       Adding a partition can make the disk image more compatible with certain virtualized operating systems
       which don't expect to see a filesystem directly located on a block device (Linux doesn't care and will
       happily handle both types).

       On the other hand, if you have a partition table then the output image is no longer a straight
       filesystem.  For example you cannot run fsck(8) directly on a partitioned disk image.  (However
       libguestfs tools such as guestfish(1) and virt-resize(1) can still be used).

       

       MBR パーティションを追加します:

        virt-make-fs --partition -- input disk.img

       If the output disk image could be terabyte-sized or larger, it's better to use an EFI/GPT-compatible
       partition table:

        virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img

   EXTRA SPACE
       Unlike formats such as tar and squashfs, a filesystem does not "just fit" the files that it contains, but
       might have extra space.  Depending on how you are going to use the output, you might think this extra
       space is wasted and want to minimize it, or you might want to leave space so that more files can be added
       later.  Virt-make-fs defaults to minimizing the extra space, but you can use the --size flag to leave
       space in the filesystem if you want it.

       An alternative way to leave extra space but not make the output image any bigger is to use an alternative
       disk image format (instead of the default "raw" format).  Using --format=qcow2 will use the native
       qemu/KVM qcow2 image format (check your hypervisor supports this before using it).  This allows you to
       choose a large --size but the extra space won't actually be allocated in the image until you try to store
       something in it.

       Don't forget that you can also use local commands including resize2fs(8) and virt-resize(1) to resize
       existing filesystems, or rerun virt-make-fs to build another image from scratch.

       

        virt-make-fs --format=qcow2 --size=+200M input output.img

オプション

       --help
           簡単なヘルプを表示します。

       --floppy
           仮想フロッピーディスクを作成します。

           今のところ、容量 (1440K)、パーティション形式 (MBR) およびファイルシステム形式 (VFAT) が事前に選択され
           ています。将来的に、ジオメトリーを選択できるようになる可能性があります。

       --size=N
       --size=+N
       -s N
       -s +N
           Use the --size (or -s) option to choose the size of the output image.

           If this option is not given, then the output image will be just large enough to contain all the
           files, with not much wasted space.

           To choose a fixed size output disk, specify an absolute number followed by b/K/M/G/T/P/E to mean
           bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or Exabytes.  This must be large enough
           to contain all the input files, else you will get an error.

           To leave extra space, specify "+" (plus sign) and a number followed by b/K/M/G/T/P/E to mean bytes,
           Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or Exabytes.  For example: --size=+200M means
           enough space for the input files, and (approximately) an extra 200 MB free space.

           Note that virt-make-fs estimates free space, and therefore will not produce filesystems containing
           precisely the free space requested.  (It is much more expensive and time-consuming to produce a
           filesystem which has precisely the desired free space).

       --format=FMT
       -F FMT
           出力するディスクイメージ形式を選択します。

           デフォルトは "raw" です (スパースな raw 形式のディスクイメージ)。

       --type=FS
       -t FS
           出力ファイルシステム形式を選択します。

           デフォルトは "ext2" です。

           Any filesystem which is supported read-write by libguestfs can be used here.

       --label=LABEL
           Set the filesystem label.

       --partition
       --partition=PARTTYPE
           このフラグが指定されていると、出力ディスクイメージに MBR パーティションテーブルを追加します。

           You can change the partition table type, eg. --partition=gpt for large disks.

           For MBR, virt-make-fs sets the partition type byte automatically.

       -v
       --verbose
           デバッグ情報を有効にします。

       -V
       --version
           バージョン番号を表示して、終了します。

       -x  Enable libguestfs trace.

関連項目

       guestfish(1), virt-format(1), virt-resize(1), virt-tar-in(1), mkisofs(1), genisoimage(1), mksquashfs(1),
       mke2fs(8), resize2fs(8), guestfs(3), http://libguestfs.org/.

著者

       Richard W.M. Jones http://people.redhat.com/~rjones/

       Copyright (C) 2010-2017 Red Hat Inc.

LICENSE

BUGS

       To get a list of bugs against libguestfs, use this link:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       To report a new bug against libguestfs, use this link:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       When reporting a bug, please supply:

       •   The version of libguestfs.

       •   Where you got libguestfs (eg. which Linux distro, compiled from source, etc)

       •   Describe the bug accurately and give a way to reproduce it.

       •   Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.