Commit Graph

214 Commits

Author SHA1 Message Date
Richard W.M. Jones
533901409e pod: Use F<> for filenames instead of C<>.
Done using a sequence of regular expressions like this:

  perl -pi.bak -e 's{C</}{F</}g' `git ls-files \*.pod` generator/actions.ml
  perl -pi.bak -e 's{C<C:\\}{F<C:\\}g' `git ls-files \*.pod` generator/actions.ml
  [etc]

and then tediously checking every change by hand.
2015-06-15 15:42:46 +01:00
Richard W.M. Jones
47e9a3d739 FAQ: Add sections about libguestfs NTFS & XFS support.
Both popular questions.
2015-06-14 16:35:52 +01:00
Richard W.M. Jones
2dc88ba8cb FAQ: Document using libguestfs to access live guest disk images.
Gets asked on the mailing list several times a year.
2015-06-01 11:58:22 +01:00
Richard W.M. Jones
5bf7f770b6 When calling getline first time, initialize length to zero.
The man page for getline says:

   ssize_t getline(char **lineptr, size_t *n, FILE *stream);
 [...]
   If  *lineptr  is set to NULL and *n is set 0 before the call, then get‐
   line() will allocate a buffer for storing the line.  This buffer should
   be freed by the user program even if getline() failed.

which seems to indicate that we must initialize both line and len to 0
before the first call to getline.

In several places we were not initializing len.  The program still
worked fine, but it seems better to initialize the length anyway.
2015-05-14 13:22:00 +01:00
Richard W.M. Jones
e86df90e52 guestfs-performance: Suggest using 'ts' instead of annotate.
'ts' allows incremental timings which is a lot more useful.
2015-03-28 17:53:35 +00:00
Richard W.M. Jones
5a445c2e40 docs: You normally need to set SUPERMIN_KERNEL_VERSION as well. 2015-03-23 12:14:59 +00:00
Richard W.M. Jones
ce56c7d30e FAQ: Don't refer to RHEL 7 in future tense.
Thanks: orc_emacs on IRC.
2015-03-09 17:51:36 +00:00
Richard W.M. Jones
bfbcc01403 Change guestfs___* to guestfs_int_*
libguestfs has used double and triple underscores in identifiers.
These aren't valid for global names in C++.

The first step is to replace all guestfs___* (3 underscores) with
guestfs_int_*.  We've used guestfs_int_* elsewhere already as a prefix
for internal identifiers.

This is an entirely mechanical change done using:
  git ls-files | xargs perl -pi.bak -e 's/guestfs___/guestfs_int_/g'

Reference: http://stackoverflow.com/a/228797
2015-02-14 18:46:04 +00:00
Richard W.M. Jones
c5800dc97d Update copyright dates for 2015. 2015-01-17 09:08:15 +00:00
Richard W.M. Jones
ccb1f2a4a0 recipes: Tidy up section about hex-dumping and hex-editing sectors. 2014-12-13 14:49:50 +00:00
Richard W.M. Jones
7893a2cfb1 FAQ: Add a section on debugging libvirtd. 2014-10-10 11:47:26 +01:00
Richard W.M. Jones
f796435628 FAQ: Need to set SUPERMIN_KERNEL_VERSION in recent supermin. 2014-10-07 10:17:33 +01:00
Richard W.M. Jones
bced8f5289 FAQ: Note that update-guestfs-appliance is not needed with libguestfs >= 1.26. 2014-09-17 16:33:55 +01:00
Richard W.M. Jones
334dee64a2 FAQ: Repeat advice to use ./run.
The two adjacent sections can be read separately, and the second
section doesn't mention not using make install / using ./run, so
repeat it a second time.
2014-09-09 20:27:33 +01:00
Richard W.M. Jones
c435053b34 Improve diagrams on various manual pages using Unicode box drawing characters. 2014-09-01 21:29:13 +01:00
Richard W.M. Jones
4dc42693f2 guestfs-recipes: Fix language. 2014-05-04 20:57:41 +01:00
Richard W.M. Jones
b176bde942 FAQ: Describe better how to compile libguestfs from source using alternate qemu/supermin/kernel. 2014-04-22 13:32:49 +01:00
Richard W.M. Jones
ffffe71c16 build: Remove code coverage and code profiling options.
This reverts commit 5a2e320ec9.
2014-04-09 14:51:59 +01:00
Richard W.M. Jones
7173883154 recipes: Update the section on installing packages.
Libguestfs >= 1.26 makes this easy.
2014-04-03 20:27:43 +01:00
Richard W.M. Jones
4099880643 examples: Check return value from guestfs_list_filesystems.
Found by Coverity.
2014-03-26 20:25:05 +00:00
Richard W.M. Jones
c4dc70f8c4 podwrapper: Remove =encoding from input files and add it back in podwrapper.
This changes podwrapper so that the input (POD) files should not
contain an =encoding directive.  However they must be UTF-8.
Podwrapper then adds the '=encoding utf8' directive back during final
generation.

This in particular avoids problems with nested =encoding directives in
fragments.  These break POD, and are undesirable anyway.
2014-03-20 13:47:19 +00:00
Richard W.M. Jones
a13109c260 FAQ: Make issues which will be fixed in libguestfs >= 1.26 / supermin >= 5. 2014-03-13 10:38:41 +00:00
Richard W.M. Jones
8df1c47269 FAQ: Remove section that only applied to obsolete Fedora & RHEL releases.
Since this is fixed in all currently supported versions of Fedora
& RHEL, there's no need to document the problem in the FAQ.
2014-03-13 10:38:40 +00:00
Richard W.M. Jones
80d77e934f FAQ: Document virt-sparsify >= 1.26 can do in-place sparsification. 2014-03-13 10:38:40 +00:00
Richard W.M. Jones
b13c22668d appliance: Use supermin >= 5.
This requires the new version of supermin (5.1.0).
2014-02-26 15:21:08 +00:00
Richard W.M. Jones
b987be513a FAQ: Remove obsolete entry about libguestfs <= 1.13 and slow writes.
Long since not a problem.
2014-02-16 19:20:40 +00:00
Richard W.M. Jones
728ba9b33f FAQ: Add several common problems with opening disk images. 2014-02-16 19:15:49 +00:00
Richard W.M. Jones
c16d5d3de4 FAQ: Create new section about problems opening disk images.
Move the stuff about encoding problems here, because these are not
really common problems.
2014-02-16 19:15:49 +00:00
Richard W.M. Jones
6594e88d80 FAQ: Remove old RHEL 6.5 section. 2014-02-16 19:15:49 +00:00
Richard W.M. Jones
82a4a8f02c FAQ: Another common problem is permission denied errors when running as root. 2014-02-12 09:32:08 +00:00
Richard W.M. Jones
37aead588e FAQ: Add another common Ubuntu appliance problem. 2014-02-12 09:31:57 +00:00
Richard W.M. Jones
d60e6a23a6 examples: Update various examples to use new disk-create API. 2014-01-28 21:02:11 +00:00
Richard W.M. Jones
6c971faecf Update copyright dates for 2014. 2014-01-02 16:53:34 +00:00
Richard W.M. Jones
1ee879f3e5 New tool: virt-diff.
This tool can be used to show the differences between two
disk images.
2013-12-18 15:15:53 +00:00
Richard W.M. Jones
7775c121f7 recipes: Use new style -a/-d options in virt-edit example. 2013-12-11 19:22:12 +00:00
Richard W.M. Jones
5c76af3a95 recipes: Add a recipe for masking a systemd service. 2013-12-06 18:58:17 +00:00
Richard W.M. Jones
2d9f69db61 FAQ: "execl: /init: Permission denied" error also caused by /init not being executable.
This updates commit 98cd329323.
2013-11-19 17:50:04 +00:00
Richard W.M. Jones
98cd329323 FAQ: Attempt to explain "execl: /init: Permission denied" error. 2013-11-19 16:59:34 +00:00
Richard W.M. Jones
fb41ce252f Change supermin man pages section 8 to section 1.
Corresponding change in upstream supermin:
cb3f9e8bba
2013-11-12 08:49:45 +00:00
Richard W.M. Jones
fc733cf943 FAQ: useradd -> usermod.
This fixes commit dd554d94ad.
2013-10-16 10:48:07 +01:00
Richard W.M. Jones
dd554d94ad FAQ: Clearer instructions for Debian and Ubuntu users. 2013-10-14 12:32:04 +01:00
Richard W.M. Jones
ff76d1abdb recipes: More recipes for virt-builder, syslinux, Xen partitionless guest conversion. 2013-10-12 12:58:49 +01:00
Richard W.M. Jones
92e1864913 events: Add a warning event and direct all warning messages through it.
This also causes warnings to be printed even in non-verbose mode,
which is useful.
2013-10-11 15:34:23 +01:00
Richard W.M. Jones
abc59d776a FAQ: Replace the debugging section (again) with a checklist of information we need to start to fix bugs. 2013-08-16 13:38:04 +01:00
Richard W.M. Jones
0a484e868f FAQ: Move #debug anchor back to the right place.
This was accidentally moved by this commit:

  commit b8b5ed65c2
  Author: Richard W.M. Jones <rjones@redhat.com>
  Date:   Wed May 23 11:46:23 2012 +0100

    FAQ: Add section about using libguestfs in closed source programs.
2013-08-16 13:24:19 +01:00
Richard W.M. Jones
937a9a3532 FAQ: Delete section about Ubuntu 10.04.
The link was broken, and we don't support Ubuntu 10.04 (maybe the
'oldlinux' branch does).
2013-08-16 12:00:06 +01:00
Richard W.M. Jones
55ee0329c5 guestfs-performance: Add a section on the performance of UML. 2013-08-14 18:52:01 +01:00
Richard W.M. Jones
78dbd08dd2 Rename 'qemu' as 'hv', 'LIBGUESTFS_QEMU' as 'LIBGUESTFS_HV'. 2013-08-14 17:25:34 +01:00
Richard W.M. Jones
0c512a52bd FAQ: Tips about using direct backend and fixed appliance on Fedora/RHEL. 2013-08-03 09:20:41 +01:00
Richard W.M. Jones
9268f14879 FAQ: Common problem with Debian is not running update-guestfs-appliance. 2013-08-03 09:19:57 +01:00