Ignore old-style initrd which is a compressed ext2 filesystem.
[libguestfs.git] / TODO
1 Ideas for the Python bindings:
2 https://www.redhat.com/archives/fedora-virt/2009-April/msg00114.html
3
4 ----------------------------------------------------------------------
5
6 We badly need to actually implement the FTP server mentioned in the
7 documentation.
8
9 Or: Implement a FUSE-based filesystem.  See the FUSE mountlo
10 project which does something similar, albeit only to single
11 filesystems:
12
13 http://sourceforge.net/project/showfiles.php?group_id=121684&package_id=150116
14
15 ----------------------------------------------------------------------
16
17 BufferIn and BufferOut should turn into <char *, int> and simple
18 strings in other languages that can handle 8 bit clean strings.
19 Limit on transfers would still be 2MB for these types.
20  - then implement write-file properly
21  - and implement read-file
22
23 ----------------------------------------------------------------------
24
25 Implement febootstrap command.
26
27 ----------------------------------------------------------------------
28
29 Complete the Haskell bindings (see discussion on haskell-cafe).
30
31 ----------------------------------------------------------------------
32
33 Complete the bindings tests - must test the return values and
34 error cases.
35
36 ----------------------------------------------------------------------
37
38 For virt-inspector:
39
40  - Make a libvirt XML config
41
42  - Test over available OSes
43
44  - Add 'reged' / NT registry support.
45
46 ----------------------------------------------------------------------
47
48 Use virtio_blk by default.  It's faster and more natural.
49 Unfortunately it seems like this will rename all devices - see next
50 item.
51
52 Note: virtio_blk *IS* supported by all our minimum platforms,
53 ie. CentOS 5.3, Fedora 11, Debian.
54
55 ----------------------------------------------------------------------
56
57 "Standalone/local mode"
58
59 Instead of running guestfsd (the daemon) inside qemu, there should be
60 an option to just run guestfsd directly.
61
62 The architecture in this mode would look like:
63
64      +------------------+
65      | main program     |
66      |------------------|
67      | libguestfs       |
68      +--------^---------+
69           |   | reply
70       cmd |   |
71      +----v-------------+
72      | guestfsd         |
73      +------------------+
74
75 Notes:
76
77 (1) This only makes sense if we are running as root.
78
79 (2) There is no console / kernel messages in this configuration, but
80 we might consider capturing stderr from the daemon.
81
82 (3) guestfs_config and guestfs_add_drive become no-ops.
83
84 Obviously in this configuration, commands are run directly on the
85 local machine's disks.  You could just run the commands themselves
86 directly, but libguestfs provides a convenient API and language
87 bindings.  Also deals with tricky stuff like parsing the output of the
88 LVM commands.  Also we get to leverage other code such as
89 virt-inspector.
90
91 This is mainly useful from live CDs, ie. virt-p2v.
92
93 Should we bother having the daemon at all and just link the guestfsd
94 code directly into libguestfs?
95
96 ----------------------------------------------------------------------
97
98 PPC problems:
99
100   ppc (32 bit) works with qemu from git, however there is no serial console
101
102   ppc64 requires extra parameters:
103     -M mac99 -cpu ppc64
104   however it still fails:
105     invalid/unsupported opcode: 01 - 01 - 1a (06301e83) 00000000018c2738 1
106     invalid bits: 00400000 for opcode: 0b - 19 - 15 (2d746572) 0000000000009230
107
108   no serial console in ppc or ppc64 because no one can tell us what
109   console=ttyXX option to use
110
111 ----------------------------------------------------------------------
112
113 Supermin appliance should be moved into febootstrap.
114
115 ----------------------------------------------------------------------
116
117 Extra commands / functionality:
118
119   General glibc / core programs:
120     chgrp
121     grep (do it locally using pipe?)
122     dd (?)
123     ln / ln -s
124     readlink
125     utime / utimes / futimes / futimens / l..
126     more mk*temp calls
127     some sort of alloc/fallocate/posix_fallocate call to create empty space
128     realpath
129     trunc[ate??]
130     getfattr (also useful because gives us access to NTFS datastreams)
131     setfattr
132
133   ext2 properties:
134     chattr
135     lsattr
136     badblocks
137     blkid
138     debugfs
139     dumpe2fs
140     e2image
141     e2undo
142     filefrag
143     findfs
144     logsave
145     mklost+found
146
147   SELinux:
148     chcat
149     restorecon
150     ch???
151
152   Oddball:
153     pivot_root
154     fts(3) / ftw(3)
155
156 ----------------------------------------------------------------------
157
158 Allow swap space from the guest to be used.  Is it a good idea?
159
160 ----------------------------------------------------------------------
161
162 Need a way to query a binary or library file for its architecture.
163 Using objdump or readelf?
164 What about non-ELF files (eg. Windows, BSD).
165
166 To do this properly requires some serious logic, eg. to cover Linux
167 and Windows we'd need objdump and i686-pc-mingw32-objdump, and more to
168 cover a.out, COFF and 64 bit Windows.  Therefore this cannot be done
169 inside the daemon, and should be done by a separate, external program
170 similar to virt-inspector.
171
172 Probably we should go all the way and have virt-inspector able to
173 determine kernel and userspace architectures of guests.
174
175 ----------------------------------------------------------------------
176
177 Other initrd-* commands, such as:
178
179 initrd-extract
180 initrd-replace
181
182 ----------------------------------------------------------------------
183
184 Control guestfish from a pipe.
185
186 For shell scripts - they can start up a long-running guestfish process
187 and intermittently send it commands.  Avoids the start-up overhead,
188 but how do we reliably signal errors?