X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=TODO;h=6579629f9bd9e05bcd6be0cf876d244d15927aff;hp=2209619a47bad3b52f106b95e0fe7f8db693ceb1;hb=87fb6d852db04d0d707e6587d4579d1cf2bd05ef;hpb=bda6cf75f259992bcba23c3c4c2339c50552f491 diff --git a/TODO b/TODO index 2209619..6579629 100644 --- a/TODO +++ b/TODO @@ -17,18 +17,16 @@ IDs and the host. It's not easy to automate this because you need extra details about the guest itself in order to get to its UID->username map (eg. /etc/passwd from the guest). -febootstrap / debootstrap inside appliance ------------------------------------------- - -This was originally proposed as a way to install new operating systems -in the appliance. However no one has come up with a workable -solution. - Haskell bindings ---------------- Complete the Haskell bindings (see discussion on haskell-cafe). +PHP bindings +------------ + +Add bindtests to PHP bindings. + Complete bind tests ------------------- @@ -85,11 +83,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? -Supermin appliance to febootstrap ---------------------------------- - -Supermin appliance functionality should be moved into febootstrap. - Ideas for extra commands ------------------------ @@ -180,7 +173,6 @@ To mount read-only, add C 1> like this: which is equivalent to the following sequence of calls: $h = Sys::Guestfs->new (); - $h->set_autosync (1); $h->add_drive_ro ($filename); $h->launch (); $h->mount_ro (\"/dev/sda1\", \"/\"); @@ -197,12 +189,6 @@ autogenerated module which creates a Sys::Guestfs handle singleton How would editing files work? -ntfsclone ---------- - -Useful imaging tool: -http://man.linux-ntfs.org/ntfsclone.8.html - virt-rescue pty --------------- @@ -213,6 +199,10 @@ http://www.perlmonks.org/index.pl?node_id=582185 Note that pty requires cooperation inside the C code too (there are two sides to a pty, and one has to be handled after the fork). +[I tried to implement this in the new C virt-rescue, but it doesn't +work. qemu is implementing its own ptys, and they are broken. Need +to fix qemu.] + Windows-based daemon/appliance ------------------------------ @@ -241,17 +231,7 @@ However this won't work easily for VM disk images in the disk image. One would have to download those to the host and launch another libguestfs instance. -List, mount filesystems by UUID and label ------------------------------------------ - -[See related: -http://www.redhat.com/archives/libguestfs/2009-August/msg00031.html] - -List filesystems by UUID or label. - -Mount filesystems by UUID or label. (I'm not really sure if we can do -this at the moment but we ought to be able to do it, and perhaps make -it easier by having a direct command). +[Not sure this is such a good idea. See also live CD inspection idea below.] Map filesystems to disk blocks ------------------------------ @@ -263,6 +243,8 @@ And vice versa. Is it even possible? +See also contribs/visualize-alignment/ + Integration with host intrusion systems --------------------------------------- @@ -275,19 +257,213 @@ http://sourceforge.net/projects/aide/ http://osiris.shmoo.com/ http://sourceforge.net/projects/tripwire/ -Resizing, shrinking, specifying sizes in guestfish --------------------------------------------------- +Fix 'file' +---------- + +https://www.redhat.com/archives/libguestfs/2010-June/msg00053.html +https://www.redhat.com/archives/libguestfs/2010-June/msg00079.html + +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. +> add mydisk +Tip: You need to type 'run' before you can see into the disk image. +> run +Tip: Use 'list-filesystems' to see what filesystems are available. +> list-filesystems +/dev/vda1 +Tip: Use 'mount fs /' to mount a filesystem. +> mount /dev/vda1 / +Tip: Use 'll /' to view the filesystem or ... +> ll / + +Could we make guestfish interactive if commands are used without params? +------------------------------------------------------------------------ + +> 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] + +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: + + - 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). + +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. + +guestfish parsing +----------------- + +At the moment guestfish uses an ad hoc parser which has many +shortcomings. We should change to using a lex/yacc-based scanner and +parser (there are better parsers out there, but yacc is sufficient and +very widely available). + +The scanner must deal with the case of parsing a whole command string, +eg. for a command that the user types in: + + > add-drive-opts "/tmp/foo" readonly:true + +and also with parsing single words from the command line: + + guestfish add-drive-opts /tmp/foo readonly:true + +Note the quotes are for scanning and don't indicate types. + +We should also allow variables and expressions as part of this new +parsing code, eg: + + set roots inspect-os + set product inspect-get-product-name %{roots[0]} + +% is better than $ because of shell escaping and confusion with shell +variables. + +Can we combine this with ability to set and read environment +variables? Currently guestfish uses many environment variables like +$EDITOR without any corresponding ability to set them. + + set EDITOR /usr/bin/emacs + echo $EDITOR # or %{EDITOR} + edit /etc/resolv.conf + +live CD inspection for Windows 7 +-------------------------------- + +Windows 7 install CDs are quite different and pretty impenetrable. +There are no obvious files to parse. + +More ntfs tools +--------------- + +ntfsprogs actually has a lot more useful tools than we currently +use. Interesting ones are: + +ntfslabel: display or change filesystem label (we should unify all + set*label APIs into a single set_vfs_label which can deal with any + filesystem) + +ntfsclone: clone, image, restore, rescue NTFS + +ntfsinfo: print various information about NTFS volume and files + +ntfs streams: extract alternate streams from NTFS files + +ntfsck: checker for NTFS filesystems + +Undelete files +-------------- + +Two useful tools: + + - ext2undelete + - ntfsundelete + +More mkfs_opts options +---------------------- + +Useful options to offer: + - Set label. + - Set UUID. + +Use /proc/self/mountinfo +------------------------ + +This file contains lots of interesting information about +what is mounted and where. eg: + + 16 21 0:3 / /proc rw,relatime - proc /proc rw + 17 21 0:16 / /sys rw,relatime - sysfs /sys rw,seclabel + 18 23 0:5 / /dev rw,relatime - devtmpfs udev rw,seclabel,size=1906740k,nr_inodes=476685,mode=755 + 26 21 253:3 / /home rw,relatime - ext4 /dev/mapper/vg-lv_home rw,seclabel,barrier=1,data=ordered + +This could be used instead of current hairy code to parse the output +of the 'mount' command. We could add new APIs to return kernel mount +options, type of filesystem at a mountpoint etc. + +guestfish drive letters +----------------------- + +There should be an option to mount all Windows drives as separate +paths, like C: => /c/, D: => /d/ etc. + +More inspection features +------------------------ + +- last shutdown time +- DHCP address +- last time the software was updated +- last user who logged in +- lastlog, last, who + +Get the guest icon +------------------ + +- For Linux guests, use /etc/favicon.png if available, else get it in + a distro-specific manner. +- For Windows guests, parse it out of c:\windows\explorer.exe + +Integrate event log parsing more closely +---------------------------------------- + +https://rwmj.wordpress.com/2011/04/17/decoding-the-windows-event-log-using-guestfish/ + +We should at least make sure the tools are packaged up for Fedora. We +could document formally how to do event log parsing. Also the above +only works for Windows Vista and later (since the log format changed), +so we could extend this to work for earlier versions. -Owing to an oversight we don't really supporting shrinking -filesystems. See: +Integrate virt-inspector with CMDBs +----------------------------------- -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 +Either integrate virt-inspector with Configuration Management +Databases (CMDBs) or at least check that virt-inspector produces the +right range of data so that integration would be possible. The +standards for CMDBs come from the DMTF, see eg: -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. +http://dmtf.org/news/pr/2009/7/dmtf-releases-cmdbf-standard-federating-configuration-management-data