Version 1.5.23.

[libguestfs.git] / TODO

diff --git a/TODO b/TODO
index 2b5821a..e9716f2 100644 (file)
--- a/TODO
+++ b/TODO
@@ -29,6 +29,11 @@ Haskell bindings
 
 Complete the Haskell bindings (see discussion on haskell-cafe).
 
 
 Complete the Haskell bindings (see discussion on haskell-cafe).
 

+PHP bindings
+------------
+
+Add bindtests to PHP bindings.
+

 Complete bind tests
 -------------------
 
 Complete bind tests
 -------------------
 


@@ -85,11 +90,6 @@ This is mainly useful from live CDs, ie. virt-p2v.
 Should we bother having the daemon at all and just link the guestfsd
 code directly into libguestfs?
 
 Should we bother having the daemon at all and just link the guestfsd
 code directly into libguestfs?
 

-Supermin appliance to febootstrap
----------------------------------
-
-Supermin appliance functionality should be moved into febootstrap.
-

 Ideas for extra commands
 ------------------------
 
 Ideas for extra commands
 ------------------------
 


@@ -276,19 +276,132 @@ http://sourceforge.net/projects/aide/
 http://osiris.shmoo.com/
 http://sourceforge.net/projects/tripwire/
 
 http://osiris.shmoo.com/
 http://sourceforge.net/projects/tripwire/
 

-Resizing, shrinking, specifying sizes in guestfish
---------------------------------------------------
+-N option should be generated
+-----------------------------
+
+'-N' option should generate documentation in guestfish(1) manpage.
+
+Fix 'file'
+----------
+
+https://www.redhat.com/archives/libguestfs/2010-June/msg00053.html
+https://www.redhat.com/archives/libguestfs/2010-June/msg00079.html
+
+Regression test on virt-inspector
+---------------------------------
+
+Occasionally we break virt-inspector through some change.  We should
+add a regression test for it.  However this is hard because we'd need
+to avoid having to carry huge images.
+
+Update: I managed to fit a real-but-minimal Fedora 13 image into 6.2 MB.
+See: http://rwmj.wordpress.com/2010/09/07/tip-pack-files-into-a-new-disk-image/#content
+
+Freeze/thaw filesystems
+-----------------------
+
+Access to these ioctls:
+http://git.kernel.org/linus/fcccf502540e3d7
+
+Tips for new users in guestfish
+-------------------------------
+
+$ guestfish
+Tip: You need to 'add disk.img' or 'alloc disk.img nn' to make a new image.
+Type 'notips' to disable tips permanently.
+><fs> add mydisk
+Tip: You need to type 'run' before you can see into the disk image.
+><fs> run
+Tip: Use 'list-filesystems' to see what filesystems are available.
+><fs> list-filesystems
+/dev/vda1
+Tip: Use 'mount fs /' to mount a filesystem.
+><fs> mount /dev/vda1 /
+Tip: Use 'll /' to view the filesystem or ...
+><fs> ll /
+
+New guestfish commands
+----------------------
+
+'list-filesystems' => list mountable filesystems
+
+We could implement this as a new API call, replacing a number of areas
+of the current code where this is done already (in virt-inspector and
+elsewhere).  What we normally do to find out if a partition contains a
+mountable filesystem is to just blindly mount it, and see if that
+succeeds.  However the kernel won't let us do this if the filesystem
+is already mounted somewhere, so a naive implementation of this in the
+daemon won't work.  We would have to check if the partition was
+already mounted.
+
+Could we make guestfish interactive if commands are used without params?
+------------------------------------------------------------------------
+
+><fs> sparse
+[[Prints man page]]
+Image name? disk.img
+Size of image? 10M
+
+Common problems
+---------------
+
+How can we solve these common user problems?
+
+[space for common problems here]

 
 

-Owing to an oversight we don't really supporting shrinking
-filesystems.  See:
+Better support for encrypted devices
+------------------------------------
+
+Currently LUKS support only works if the device contains volume
+groups.  If it contains, eg., partitions, you cannot access them.
+We would like to add:
+
+  - An easier way to use this from guestfish.
+  - Direct access to the /dev/mapper device (eg. if it contains
+    anything apart from VGs).
+
+Display image as PS
+-------------------
+
+Display the structure of an image file as a PS.
+
+Greater use of blkid / libblkid
+-------------------------------
+
+guestfs_zero should use wipefs.  See wipefs(8).
+
+There are various useful functions in libblkid for listing partitions,
+devices etc which we are essentially duplicating in the daemon.  It
+would make more sense to just use libblkid for this.
+
+There are some places where we call out to the 'blkid' program.  This
+might be replaced by direct use of the library (if this is easier).
+
+Remove repo from appliance name
+-------------------------------
+
+There's no need to have the appliance name contain the repository name
+(ie initramfs.x86_64.img instead of initramfs.fedora-13.x86_64.img).
+
+Visualization
+-------------
+
+Eric Sandeen pointed out the blktrace tool which is a better way of
+capturing traces than using patched qemu (see
+contrib/visualize-alignment).  We would still use the same
+visualization tools in conjunction with blktrace traces.
+
+Virt-df UUID
+------------
+
+Virt-df and any other tools with --csv output should be able to print
+UUID of domain.  This allows you to track the real domain across
+renames etc.
+
+Add-domain command
+------------------

 
 

-https://bugzilla.redhat.com/show_bug.cgi?id=585221
-https://bugzilla.redhat.com/show_bug.cgi?id=585222
-https://bugzilla.redhat.com/show_bug.cgi?id=585223
+guestfs_add_domain (g, "libvirt-dom");

 
 

-But a related problem is how to specify sizes to guestfish, ie. "100M"
-or "1G".  Currently the specific alloc and sparse functions contain
-code to parse these size strings, but that cannot be used anywhere
-else that would take a byte count.  This is awkward because some
-commands take units of megabytes (lvresize, sfdiskM) or sectors
-(part-add), with no unifying theme.
+However this would need to not depend on libvirt, eg. loading it
+on demand.