[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [RFR] templates://libguestfs/{libguestfs0.templates}



Christian PERRIER wrote:
>  Type: boolean
>  Default: false
>  _Description: Create or update supermin appliance now?
> + A "supermin appliance" is mandatory for libguestfs.
> + It contains lists of files and directories. These will be
> + copied into an ad-hoc file system whenever libguestfs starts
> + a virtual machine.
>   .
> + To generate or update a supermin appliance, network access to a
> + package repository is needed.
> + .
> + This can be done later by using the update-guestfs-appliance(8) utility.
> 
> Here, I tried to bring an answer to "what the heck is a supermin appliance"..:-)

Thankyou!  My only remaining quibble with the template is: does the
repository access need to be via a network?  (I can see how the answer
might be "yes", I'm just checking.)

> Boilerplate rewrite proposal:

> +Description: guest disk images manipulation library - development headers
                                ^
Nouns in this sort of stack don't generally inflect for number:

   Description: guest disk image manipulation library - development headers

Or to save a couple more characters for the sake of the long ones like
libguestfs-ocaml-dev we could use:

   Description: guest disk image management system - development headers

But the bulletpoint approach looks okay.

>   .
> - It uses Linux kernel and qemu code, and can access any type of guest
> - filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
> + It uses the Linux kernel and qemu code, and can access any type of guest
> + file system that Linux and qemu can, including but not limited to: ext2/3/4,
>   btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
>   vmdk.
> 
> Adding "the" before "Linux kernel"

Without the article I was assuming it meant "It uses Linux kernel code
and qemu code", which is a perfectly possible interpretation; though
if that was the intended meaning it should probably say "It uses code
from qemu and the Linux kernel" to avoid the ambiguity.

>   .
> + The library provides ways to enumerate guest storage (eg. partitions, LVs, what
>   filesystem is in each LV, etc.). It can also run commands in the context of 
> + the guest. It allows uploading and downloading files and directories.

Too many "also" sentences which could be knocked through into a single
list; and "eg." should be "e.g." or (preferably) "such as".

    The library provides ways to enumerate guest storage (such as partitions, LVs,
    what file system is in each LV, etc.); to run commands in the context of the
    guest; and to upload and download files and directories.

>  Package: guestfish
[...]
>   Guestfish is a shell and command-line tool for examining and modifying
> + virtual machine file systems. It uses libguestfs and exposes all of the
>   functionality of the guestfs API, see guestfs(3).
                                    ^
"Comma splice"; upgrade it to semicolon.

> Package: libguestfs0
[...]
> + .

Trailing empty paragraph.

>  Package: guestmount
[...]
> +Description: guest disk images manipulation library - guest file system mount

I'm not convinced by "guest file system mount"; after all, what
besides file systems might you mount, and how many times do we need to
use the word "guest"?  I'd suggest:

   Description: guest disk image management system - FUSE mount utility

[...]
>   The guestmount program can be used to mount virtual machine filesystems
>   and other disk images on the host.  It uses libguestfs for access to
>   the guest filesystem, and FUSE (the "filesystem in userspace") to make
>   it appear as a mountable device.

For consistency, extra space in FS and not between sentences.  Oh, and
I'd drop the article in the expansion of FUSE... in other words:

    The guestmount utility can be used to mount virtual machine file systems and
    other disk images on the host. It uses libguestfs for access to the guest
    file system, and FUSE ("File system in USErspace") to make it appear as a
    mountable device.

>  Package: libguestfs-tools
[...]
> +Description: guest disk images manipulation library - virt tools

Virt, the municipality on the Danube?  Given that this version already
explains what libguestfs is before the dash I'd just say "tools" here.

> - This package contains virt tools including virt-cat, virt-df, virt-edit,
> - virt-filesystems, virt-inspector, virt-ls, virt-make-fs, virt-rescue,
> - virt-resize, virt-tar and virt-win-reg.
> + This package contains these utilities.

Er, hang on, you've dropped some bits.  Say:

    This package contains virtualization tools, including virt-cat, virt-df,
    virt-edit, virt-filesystems, virt-inspector, virt-ls, virt-make-fs,
    virt-rescue, virt-resize, virt-tar, and virt-win-reg.

Though that does make me wonder whether I should be saying:

    This package contains virtualization tools, including virt-cat, -df, -edit,
    -filesystems, -inspector, -ls, -make-fs, -rescue, -resize, -tar, and -win-reg.
  
[...]
> Package: libguestfs-ocaml
[...]
>   This package include the OCaml shared runtime stub libraries.
                        ^s
[...]
> Package: libguestfs-ocaml-dev
[...]
>   This package contains all the files needed to develop OCaml programs
>   wich use OCaml bindings to libguestfs.
     ^h

That sounds redundant (could OCaml programs use Lisp bindings to
libguestfs?), but never mind, I'll just fix the spelling.
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
diff -ru old/control new/control
--- old/control	2011-08-12 11:07:48.709961131 +0100
+++ new/control	2011-08-22 11:34:28.642294271 +0100
@@ -26,31 +26,53 @@
 Section: admin
 Architecture: i386 amd64
 Depends: libguestfs0 (= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends}
-Description: libguestfs filesystem interactive shell
+Description: guest disk image management system - file system shell
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
+ btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
+ vmdk.
+ .
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
+ .
  Guestfish is a shell and command-line tool for examining and modifying
- virtual machine filesystems.  It uses libguestfs and exposes all of the
- functionality of the guestfs API, see guestfs(3).
+ virtual machine file systems. It uses libguestfs and exposes all of the
+ functionality of the guestfs API; see guestfs(3).
 
 Package: libguestfs-dev
 Section: libdevel
 Architecture: i386 amd64
 Depends: libguestfs0 (= ${binary:Version}), ${misc:Depends}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - development headers
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the development headers.
 
@@ -95,32 +117,54 @@
   strace,
   xfsprogs,
   zerofree
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - shared library
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
 
 Package: guestmount
 Section: admin
 Architecture: i386 amd64
 Depends: libguestfs0 (= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends}
-Description: mount guest filesystem using libguestfs and FUSE
- The guestmount program can be used to mount virtual machine filesystems
- and other disk images on the host.  It uses libguestfs for access to
- the guest filesystem, and FUSE (the "filesystem in userspace") to make
- it appear as a mountable device.
+Description: guest disk image management system - FUSE mount utility
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
+ btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
+ vmdk.
+ .
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
+ .
+ The guestmount utility can be used to mount virtual machine file systems and
+ other disk images on the host. It uses libguestfs for access to the guest
+ file system, and FUSE ("File system in USErspace") to make it appear as a
+ mountable device.
 
 Package: libguestfs-tools
 Section: admin
@@ -129,31 +173,53 @@
  libsys-virt-perl, libguestfs-perl (= ${binary:Version}),
  libwin-hivex-perl,
  libintl-perl, libstring-shellquote-perl
-Description: libguestfs virt tools
- This package contains virt tools including virt-cat, virt-df, virt-edit,
- virt-filesystems, virt-inspector, virt-ls, virt-make-fs, virt-rescue,
- virt-resize, virt-tar and virt-win-reg.
+Description: guest disk image management system - tools
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
+ btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
+ vmdk.
+ .
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
+ .
+ This package contains virtualization tools, including virt-cat, virt-df,
+ virt-edit, virt-filesystems, virt-inspector, virt-ls, virt-make-fs,
+ virt-rescue, virt-resize, virt-tar, and virt-win-reg.
 
 Package: libguestfs0-dbg
 Section: debug
 Architecture: i386 amd64
 Depends: ${shlibs:Depends}, ${misc:Depends}, libguestfs0 (= ${binary:Version})
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - debug symbols
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the debugging symbols.
 
@@ -161,22 +227,25 @@
 Section: doc
 Architecture: all
 Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - documentation
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the documentation.
 
@@ -186,22 +255,25 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, libguestfs0 (= ${binary:Version})
 Provides: python-libguestfs
 Conflicts: python-libguestfs
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - Python bindings
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the Python bindings.
  
@@ -213,22 +285,25 @@
  libxml-xpath-perl,
  libwin-hivex-perl,
  libsys-virt-perl
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - Perl bindings
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains the Perl bindings.
  
@@ -238,24 +313,27 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, libguestfs0 (= ${binary:Version}),
  ${ocaml:Depends}
 Provides: ${ocaml:Provides}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
+Description: guest disk image management system - Ocaml bindings
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
  .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
- This package include the OCaml shared runtime stub libraries.
+ This package includes the OCaml shared runtime stub libraries.
  
 Package: libguestfs-ocaml-dev
 Section: ocaml
@@ -265,22 +343,25 @@
  libguestfs-dev (= ${binary:Version}), 
  ${ocaml:Depends}
 Provides: ${ocaml:Provides}
-Description: library for accessing and modifying guest disk images
- libguestfs is a library for accessing and modifying guest disk images. Amongst
- the things this is good for: making batch configuration changes to guests,
- viewing and editing files inside guests, getting disk used/free statistics,
- migrating between virtualization systems, performing partial backups,
- performing partial guest clones, cloning guests and changing
- registry/UUID/hostname info, and much else besides.
- .
- It uses Linux kernel and qemu code, and can access any type of guest
- filesystem that Linux and qemu can, including but not limited to: ext2/3/4,
+Description: guest disk image management system - Ocaml development files
+ The libguestfs library allows accessing and modifying guest disk
+ images. It offers the following features, among many others:
+  * making batch configuration changes to guests;
+  * viewing and editing files inside guests;
+  * getting disk used/free statistics;
+  * migrating between virtualization systems;
+  * performing partial backups;
+  * performing partial guest clones;
+  * cloning guests and changing registry/UUID/hostname info.
+ .
+ It uses the Linux kernel and qemu code, and can access any type of guest
+ file system that Linux and qemu can, including but not limited to: ext2/3/4,
  btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
  vmdk.
  .
- libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what
- filesystem is in each LV, etc.). It can also run commands in the context of 
- the guest. Also you can upload and download files and directories.
+ The library provides ways to enumerate guest storage (such as partitions, LVs,
+ what file system is in each LV, etc.); to run commands in the context of the
+ guest; and to upload and download files and directories.
  .
  This package contains all the files needed to develop OCaml programs
- wich use OCaml bindings to libguestfs.
+ which use OCaml bindings to libguestfs.
diff -ru old/libguestfs0.templates new/libguestfs0.templates
--- old/libguestfs0.templates	2011-08-12 11:07:01.017960729 +0100
+++ new/libguestfs0.templates	2011-08-22 10:12:15.662294337 +0100
@@ -2,9 +2,12 @@
 Type: boolean
 Default: false
 _Description: Create or update supermin appliance now?
- libguestfs needs a supermin appliance to perform its work. To
- generate or update it, network access to a package repository is
- needed.
+ A "supermin appliance" is mandatory for libguestfs.
+ It contains lists of files and directories. These will be
+ copied into an ad-hoc file system whenever libguestfs starts
+ a virtual machine.
  .
- update-guestfs-appliance(8) can also be used at a later time to
- create or update the supermin appliance.
+ To generate or update a supermin appliance, network access to a
+ package repository is needed.
+ .
+ This can be done later by using the update-guestfs-appliance(8) utility.
Source: libguestfs
Section: libs
Priority: extra
Maintainer: Debian Libvirt Maintainers <pkg-libvirt-maintainers@lists.alioth.debian.org>
Uploaders: Richard Jones <rjones@redhat.com>, Guido Günther <agx@sigxcpu.org>, Hilko Bengen <bengen@debian.org>
Build-Depends: debhelper (>= 7.0.50~), autotools-dev, aptitude,
  po-debconf,
  febootstrap (>= 3.2),
  libreadline-dev, libaugeas-dev, libhivex-dev, libvirt-dev,
  libmagic-dev, libncurses5-dev, libpcre3-dev, libxml2-dev,
  libconfig-dev,
  automake, autoconf, libtool,
  gperf,
  qemu-kvm (>= 0.13),
  genisoimage, pkg-config,
  dh-ocaml, ocaml, ocaml-findlib, libpcre-ocaml-dev,
  python (>= 2.6.7-2), python-all-dev (>= 2.6.6-3~),
  libtest-pod-coverage-perl, libextutils-command-perl, libintl-perl, libtest-pod-perl,
  libstring-shellquote-perl,
  libsys-virt-perl, libwin-hivex-perl,
  libfuse-dev, fuse-utils 
Homepage: http://libguestfs.org
Standards-Version: 3.9.2

Package: guestfish
Section: admin
Architecture: i386 amd64
Depends: libguestfs0 (= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends}
Description: guest disk image management system - file system shell
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 Guestfish is a shell and command-line tool for examining and modifying
 virtual machine file systems. It uses libguestfs and exposes all of the
 functionality of the guestfs API; see guestfs(3).

Package: libguestfs-dev
Section: libdevel
Architecture: i386 amd64
Depends: libguestfs0 (= ${binary:Version}), ${misc:Depends}
Description: guest disk image management system - development headers
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package contains the development headers.

Package: libguestfs0
Section: libs
Architecture: i386 amd64
Depends: ${shlibs:Depends}, ${misc:Depends},
  febootstrap (>= 3.2),
  qemu-kvm (>= 0.13),
  linux-image-2.6-amd64 (>= 2.6.36) [amd64], 
  linux-image-2.6-686 (>= 2.6.36) [i386], 
  bsdmainutils,
  btrfs-tools,
  cryptsetup,
  diffutils,
# gfs-tools,
# gfs2-tools,
  grub-pc,
# hfsplus,
  iproute,
  libaugeas0,
# nilfs2-tools,
  ntfs-3g,
  ntfsprogs,
  reiserfsprogs,
  udev,
  vim-tiny,
  xz-utils,
  zfs-fuse,
  binutils,
  cpio,
  dosfstools,
  file,
  jfsutils,
  lsof,
  lvm2,
  module-init-tools,
  net-tools,
  parted,
  procps,
  scrub,
  strace,
  xfsprogs,
  zerofree
Description: guest disk image management system - shared library
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.

Package: guestmount
Section: admin
Architecture: i386 amd64
Depends: libguestfs0 (= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends}
Description: guest disk image management system - FUSE mount utility
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 The guestmount utility can be used to mount virtual machine file systems and
 other disk images on the host. It uses libguestfs for access to the guest
 file system, and FUSE ("File system in USErspace") to make it appear as a
 mountable device.

Package: libguestfs-tools
Section: admin
Architecture: i386 amd64
Depends: libguestfs0 (= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends},
 libsys-virt-perl, libguestfs-perl (= ${binary:Version}),
 libwin-hivex-perl,
 libintl-perl, libstring-shellquote-perl
Description: guest disk image management system - tools
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package contains virtualization tools, including virt-cat, virt-df,
 virt-edit, virt-filesystems, virt-inspector, virt-ls, virt-make-fs,
 virt-rescue, virt-resize, virt-tar, and virt-win-reg.

Package: libguestfs0-dbg
Section: debug
Architecture: i386 amd64
Depends: ${shlibs:Depends}, ${misc:Depends}, libguestfs0 (= ${binary:Version})
Description: guest disk image management system - debug symbols
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package contains the debugging symbols.

Package: libguestfs-doc
Section: doc
Architecture: all
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: guest disk image management system - documentation
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package contains the documentation.

Package: python-guestfs
Section: python
Architecture: i386 amd64
Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, libguestfs0 (= ${binary:Version})
Provides: python-libguestfs
Conflicts: python-libguestfs
Description: guest disk image management system - Python bindings
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package contains the Python bindings.
 
Package: libguestfs-perl
Section: perl
Architecture: i386 amd64
Depends: ${shlibs:Depends}, ${misc:Depends}, libguestfs0 (= ${binary:Version}),
 ${perl:Depends},
 libxml-xpath-perl,
 libwin-hivex-perl,
 libsys-virt-perl
Description: guest disk image management system - Perl bindings
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package contains the Perl bindings.
 
Package: libguestfs-ocaml
Section: ocaml
Architecture: i386 amd64
Depends: ${shlibs:Depends}, ${misc:Depends}, libguestfs0 (= ${binary:Version}),
 ${ocaml:Depends}
Provides: ${ocaml:Provides}
Description: guest disk image management system - Ocaml bindings
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package includes the OCaml shared runtime stub libraries.
 
Package: libguestfs-ocaml-dev
Section: ocaml
Architecture: i386 amd64
Depends: ${shlibs:Depends}, ${misc:Depends},
 libguestfs0 (= ${binary:Version}),
 libguestfs-dev (= ${binary:Version}), 
 ${ocaml:Depends}
Provides: ${ocaml:Provides}
Description: guest disk image management system - Ocaml development files
 The libguestfs library allows accessing and modifying guest disk
 images. It offers the following features, among many others:
  * making batch configuration changes to guests;
  * viewing and editing files inside guests;
  * getting disk used/free statistics;
  * migrating between virtualization systems;
  * performing partial backups;
  * performing partial guest clones;
  * cloning guests and changing registry/UUID/hostname info.
 .
 It uses the Linux kernel and qemu code, and can access any type of guest
 file system that Linux and qemu can, including but not limited to: ext2/3/4,
 btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2,
 vmdk.
 .
 The library provides ways to enumerate guest storage (such as partitions, LVs,
 what file system is in each LV, etc.); to run commands in the context of the
 guest; and to upload and download files and directories.
 .
 This package contains all the files needed to develop OCaml programs
 which use OCaml bindings to libguestfs.
Template: libguestfs/update-appliance
Type: boolean
Default: false
_Description: Create or update supermin appliance now?
 A "supermin appliance" is mandatory for libguestfs.
 It contains lists of files and directories. These will be
 copied into an ad-hoc file system whenever libguestfs starts
 a virtual machine.
 .
 To generate or update a supermin appliance, network access to a
 package repository is needed.
 .
 This can be done later by using the update-guestfs-appliance(8) utility.

Reply to: