Commit Graph

109 Commits

Author SHA1 Message Date
Richard W.M. Jones
6ea7c08c99 recipes: Add sections about hexdumping, hexediting sectors.
(cherry picked from commit 5d9f10c312)
2012-11-22 09:58:26 +00:00
Richard W.M. Jones
c8b3ea823e recipes: Add recipe for diffing two guests.
(cherry picked from commit fd81d3f9b2)
2012-11-22 09:58:26 +00:00
Richard W.M. Jones
a74afff884 examples: Copy-editing instructions printed by the mount-local program.
(cherry picked from commit 692701f382)
2012-11-20 22:03:01 +00:00
Richard W.M. Jones
204d87098a guestfs-testing: Use L<> around links.
(cherry picked from commit dd09744432)
2012-10-30 17:14:24 +00:00
Richard W.M. Jones
fbc517feee FAQ: Document debug* and internal* functions in the FAQ.
(cherry picked from commit 9bd3d5bc6d)
2012-10-30 16:41:41 +00:00
Richard W.M. Jones
ff610469fb inspection: Fix calls to case_sensitive_path (RHBZ#858126).
Don't assume that if guestfs_case_sensitive_path returns NULL, that it
means the file does not exist.

The (previously undefined) behaviour of case_sensitive_path was that a
NULL return meant "either the file doesn't exist or some other error".
However in commit 973581780d this was
changed so that if the last element of the path didn't exist, it was
assumed to be a new file and the (non-NULL) path of the new file is
returned.

This change breaks code (including in libguestfs) which tries to use
case_sensitive_path as a dual-purpose call to fix-up a path for
Windows and test if the file exists.  Such code should be rewritten so
that it explicitly tests for file existence after calling
case_sensitive_path.

I examined all the calls to case_sensitive_path in libguestfs and
modified them where necessary.

Cherry picked from commit 9ea6e97014.
2012-10-01 14:53:36 +01:00
Richard W.M. Jones
f487298ed4 recipes: Add a section about diagnosing hanging guests.
(cherry picked from commit f7e138835a)
2012-10-01 14:51:25 +01:00
Richard W.M. Jones
7d674f2fbf guestfs-testing(1): Start by running libguestfs-test-tool.
(cherry picked from commit 9b7813c5bd)
2012-10-01 14:51:02 +01:00
Richard W.M. Jones
9064f486b0 FAQ: Miscellaneous cleanups.
- Use S<...> for non-breaking spaces.
- Arrange the builds section better.
- Add a section on enabling sVirt.
- Other small fixes.
(cherry picked from commit 19b29c3637)
2012-10-01 14:50:45 +01:00
Richard W.M. Jones
53c4ec871d recipes: Add section about uploading raw filesystem content.
(cherry picked from commit 8aa8eb205b)
2012-10-01 14:43:43 +01:00
Richard W.M. Jones
2cc403d920 syntax: Remove trailing whitespace.
Found by 'make syntax-check'.
(cherry picked from commit 2cac8d490e)
2012-09-19 12:08:09 +01:00
Richard W.M. Jones
65077723fe faq: Make the legal section less unnecessarily legalistic.
(cherry picked from commit 244e9a2ac4)
2012-09-19 00:02:16 +01:00
Richard W.M. Jones
21b62524ca faq: Tidy up headings.
(cherry picked from commit 19da851610)
2012-09-19 00:02:11 +01:00
Richard W.M. Jones
396b5ba49f faq: Add more answers about read-only disks.
(cherry picked from commit 2c59af7754)
2012-09-19 00:02:07 +01:00
Richard W.M. Jones
e0f3153612 recipes: Checksum file/device. Download to stdout.
(cherry picked from commit b799bc58a8)
2012-09-18 23:47:27 +01:00
Richard W.M. Jones
38b9b399c2 FAQ: Remove link to old RHEL 6.3 preview repo.
(cherry picked from commit 8af32b9d5f)
2012-08-30 22:37:52 +01:00
Richard W.M. Jones
d37ccaacb3 podwrapper: Add --license parameter, which is required.
This adds standard LICENSE and BUGS sections to all of the man pages
that are processed by podwrapper.

Modify all the calls to $(PODWRAPPER) to add the right --license
parameter according to the content.  Note that this relaxes the
license on some code example pages, making them effectively BSD-style
licensed.

(cherry picked from commit 2f97bf873b)
2012-08-30 22:04:55 +01:00
Richard W.M. Jones
ebf3342f5a man pages: Ensure consistent copyright/author sections, remove license
section.

Ensure each man page contains consistent COPYRIGHT and AUTHOR
sections.

Remove the LICENSE section.  We will add that back in podwrapper in a
later commit.

(cherry picked from commit f1d98bbc79)
2012-08-30 22:04:55 +01:00
Richard W.M. Jones
ef2f91dda0 FAQ: Re-add #backup anchor for section on backups.
(cherry picked from commit 984044043d)
2012-08-30 22:04:54 +01:00
Richard W.M. Jones
be07ddaae9 recipes: Update dumping filesystem content to mention that we now support MD/RAID.
(cherry picked from commit 52e38c7bdc)
2012-08-30 22:04:54 +01:00
Richard W.M. Jones
6b01c9ce52 recipes: Refer to virt-format, virt-make-fs for creating disk images.
(cherry picked from commit 1e4c6e36a6)
2012-08-30 22:04:54 +01:00
Richard W.M. Jones
d0cdaa16b4 recipes: Cloning Windows: plans for virt-sysprep.
(cherry picked from commit 5f234548ed)
2012-08-30 22:04:54 +01:00
Richard W.M. Jones
4b17eabb1d recipes: For auditing for setuid files, point to virt-ls examples.
(cherry picked from commit 9fd4d16819)
2012-08-30 22:04:54 +01:00
Richard W.M. Jones
000b1e6b1e recipes: For sparsifying guests, point to virt-sparsify.
(cherry picked from commit 0d2e70b1c7)
2012-08-30 22:04:53 +01:00
Richard W.M. Jones
0f9ca6b22e recipes: For listing files, point to virt-ls.
(cherry picked from commit d944a491ac)
2012-08-30 22:04:53 +01:00
Richard W.M. Jones
024bd07241 recipes: Most guests now use grub2, so change the example.
(cherry picked from commit 87cf749cde)
2012-08-30 22:04:53 +01:00
Richard W.M. Jones
71697b85da recipes: Add a section on deleting a file and other common file operations.
(cherry picked from commit 10d48bef30)
2012-08-30 22:04:53 +01:00
Richard W.M. Jones
b9d1727ca4 recipes: Update cloning section.
(cherry picked from commit 1454751b73)
2012-08-30 22:04:53 +01:00
Richard W.M. Jones
b8bc94a6f5 FAQ: virt-sparsify and raw sparse output.
(cherry picked from commit cd1627e804)
2012-08-30 22:04:53 +01:00
Richard W.M. Jones
98161a6138 docs: Add a section describing how to use gdb + qemu wrappers to debug the appliance.
(cherry picked from commit 84c897c93a)
2012-08-30 21:24:52 +01:00
Richard W.M. Jones
244bac5411 docs: Show how to use 'annotate-output' command to collect timings.
(cherry picked from commit 22da2cb0ae)
2012-08-30 21:24:46 +01:00
Richard W.M. Jones
858ce379b5 lib: Initialize libvirt and libxml2 once when the library loads.
(cherry picked from commit 941ec968b8)
2012-08-05 21:38:56 +01:00
Richard W.M. Jones
eb694a0a0a docs: Use L<...> for links.
Instead of working around bugs, podwrapper has been fixed so that
links work in all output formats.
(cherry picked from commit 4bc110e2bc)
2012-08-05 21:15:47 +01:00
Richard W.M. Jones
7634bae8e5 build: Change calls to podwrapper.sh to use $(PODWRAPPER).
This will allow us to easily change the location of this
script in future.
(cherry picked from commit f2ea617e22)
2012-08-05 21:12:22 +01:00
Richard W.M. Jones
a659f2c316 New API: guestfs_shutdown: Cleanly shutdown the backend.
The new API splits orderly close into a two-step process:

  if (guestfs_shutdown (g) == -1) {
    /* handle the error, eg. qemu error */
  }
  guestfs_close (g);

Note that the explicit shutdown step is only necessary in the case
where you have made changes to the disk image and want to handle write
errors.  Read the documentation for further information.

This change also:

 - deprecates guestfs_kill_subprocess

 - turns guestfs_kill_subprocess into the same as guestfs_shutdown

 - changes guestfish and other tools to call shutdown + close
   where necessary (not for read-only tools)

 - updates documentation

 - updates examples

(cherry picked from commit ffbf1475f7)
2012-07-06 17:36:30 +01:00
Richard W.M. Jones
352219c718 examples: In create_disk example, don't call set_autosync.
This is now set by default in all supported versions of libguestfs.
It's just confusing if the examples refer to it.
(cherry picked from commit 917550a117)
2012-07-06 17:36:30 +01:00
Richard W.M. Jones
e88351c70a FAQ: Add Gentoo (thanks Agostino Sarubbo).
(cherry picked from commit 8d88b06277)
2012-06-28 09:39:22 +01:00
Richard W.M. Jones
161dc6c4b4 FAQ: Mention update-guestfs-appliance (thanks Steven Dake).
(cherry picked from commit 6352953ea9)
2012-06-21 12:52:25 +01:00
Richard W.M. Jones
44955ce4b2 doc: Add documentation covering use of utf8 option when mounting vfat (RHBZ#823887).
(cherry picked from commit 6445bc5952)
2012-06-01 19:26:07 +01:00
Richard W.M. Jones
32ec9e6526 FAQ: Add section about using libguestfs in closed source programs.
(cherry picked from commit b8b5ed65c2)
2012-06-01 19:24:48 +01:00
Richard W.M. Jones
2903e8609a FAQ: Add a note about "child process died unexpectedly".
This is a common search term on the main website, and there is no good
information provided by Google at present.
(cherry picked from commit 144d7cd988)
2012-06-01 19:24:44 +01:00
Richard W.M. Jones
b5146ac2ec FAQ: Update Ubuntu instructions.
(cherry picked from commit c7d3aa9cd6)
2012-06-01 19:24:41 +01:00
Richard W.M. Jones
b42dcb05dc examples: Further fixes to mount-local example program.
* Set PS1 prompt properly for bash shells.
* Touch a file into the root directory of the new filesystem.

This fixes commit 46b6766156.
2012-05-14 12:19:31 +01:00
Richard W.M. Jones
2c50a5da46 example: Various fixes to mount-local example program.
* Move MOUNT_OPTIONS to #define at top.
* Move SIZE_MB to #define at top.
* Set PS1 in subshell (doesn't work - why?).
* Hide libguestfs errors from guestfs_mount_local_run.

This fixes commit 46b6766156.
2012-05-14 10:49:16 +01:00
Richard W.M. Jones
a219fede92 debian: examples: Don't break when O_CLOEXEC is not defined.
This affected Debian 6.

This fixes commit 46b6766156.
2012-05-14 10:24:53 +01:00
Richard W.M. Jones
034733e981 examples: Add mount options "acl,user_xattr" to mount-local example.
This fixes commit 46b6766156.
2012-05-13 23:01:15 +01:00
Richard W.M. Jones
46b6766156 examples: Add an example of using the mount-local API from C. 2012-05-13 22:53:01 +01:00
Richard W.M. Jones
7201a48d18 examples: Add if HAVE_HIVEX ... endif around virt_dhcp_address example. 2012-05-13 22:20:32 +01:00
Richard W.M. Jones
042a0b063b FAQ: Fix typo in download (thanks badnews@IRC) 2012-05-10 23:00:31 +01:00
Richard W.M. Jones
e6bfb55f65 Turn libguestfs FAQ into a man page: guestfs-faq(1). 2012-05-01 13:55:53 +01:00