todo: Add comment about progress of long-running operations.
[libguestfs.git] / TODO
diff --git a/TODO b/TODO
index 2209619..fc6b3fd 100644 (file)
--- a/TODO
+++ b/TODO
@@ -110,6 +110,7 @@ Ideas for extra commands
     findfs
     logsave
     mklost+found
+    ext2undelete
 
   SELinux:
     chcat
@@ -275,19 +276,83 @@ http://sourceforge.net/projects/aide/
 http://osiris.shmoo.com/
 http://sourceforge.net/projects/tripwire/
 
-Resizing, shrinking, specifying sizes in guestfish
---------------------------------------------------
+-N option should be generated
+-----------------------------
 
-Owing to an oversight we don't really supporting shrinking
-filesystems.  See:
+'-N' option should be generated code, and should generate
+documentation in guestfish(1) manpage.
 
-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
+Fix 'file'
+----------
 
-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.
+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.
+
+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?
+
+- http://lists.fedoraproject.org/pipermail/users/2010-June/374931.html
+  In guestfish, specified -m non-existent filesystem.  We could suggest
+  a list of filesystems, or suggest they run the virt-list-filesystems
+  command.
+
+Progress of long-running operations
+-----------------------------------
+
+For example, copying in virt-resize.  How can we display the progress
+of these operations?  This is a basic usability requirement, and
+frequently requested.