Todo: RUN_ONLY_FOR
[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     wc
121     head, tail
122     chgrp
123     grep (do it locally using pipe?)
124     dd (?)
125     du
126     ln / ln -s
127     mknod
128     readlink
129     utime / utimes / futimes / futimens / l..
130     mkfifo
131     more mk*temp calls
132     readdir / readdir-and-stat
133     some sort of alloc/fallocate/posix_fallocate call to create empty space
134     realpath
135     trunc[ate??]
136
137   ext2 properties:
138     chattr
139     lsattr
140     badblocks
141     blkid
142     debugfs
143     dumpe2fs
144     e2image
145     e2undo
146     filefrag
147     findfs
148     logsave
149     mklost+found
150
151   SELinux:
152     chcat
153     restorecon
154     ch???
155
156   Oddball:
157     pivot_root
158     fts(3) / ftw(3)
159
160   guestfish only:
161     more/less (like cat, but pipes it through $PAGER)
162     cmd | pipe
163     cat file | pipe-cmd should have a generic form? like
164       'file | less' or 'file | sort'?
165
166 ----------------------------------------------------------------------
167
168 Allow swap space from the guest to be used.  Is it a good idea?
169
170 ----------------------------------------------------------------------
171
172 In capitests, RUN_ONLY_FOR="testname testname"