Richard W.M. Jones 330fbea5b2 Clarify the error message when unavailable functions are called (RHBZ#679737). ...

Callers are supposed to use the availability API to check for
functions that may not be available in particular builds of
libguestfs.  If they don't do this, currently they tend to get obscure
error messages, eg:

  libguestfs: error: zerofree: /dev/vda1: zerofree: No such file or directory

This commit changes the error message to explain what callers ought to
be doing instead:

  libguestfs: error: zerofree: feature 'zerofree' is not available in this
  build of libguestfs.  Read 'AVAILABILITY' in the guestfs(3) man page for
  how to check for the availability of features.

This patch makes the stubs check for availability.  The stub code
changes to:

  static void
  zerofree_stub (XDR *xdr_in)
  {
  [...]

    /* The caller should have checked before calling this. */
    if (! optgroup_zerofree_available ()) {
      reply_with_error ("feature '%s' is not available in this\n"
                        "build of libguestfs.  Read 'AVAILABILITY' in the guestfs(3) man page for\n"
                        "how to check for the availability of features.",
                        "zerofree");
      goto done;
    }
  [...]

2012-02-01 15:09:09 +00:00

..

9p.c

Update FSF address.

2011-11-08 14:43:07 +00:00

augeas.c

Clarify the error message when unavailable functions are called (RHBZ#679737).

2012-02-01 15:09:09 +00:00

available.c

Update FSF address.

2011-11-08 14:43:07 +00:00

base64.c

Update FSF address.

2011-11-08 14:43:07 +00:00

blkid.c

daemon: Fix leak of strings in blkid (found by valgrind).

2012-01-24 17:00:32 +00:00

blockdev.c

Update FSF address.

2011-11-08 14:43:07 +00:00

btrfs.c

daemon: Define safe ADD_ARG macro for constructing arg lists on the stack.

2011-11-11 10:48:16 +00:00

checksum.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

cmp.c

Update FSF address.

2011-11-08 14:43:07 +00:00

command.c

Update FSF address.

2011-11-08 14:43:07 +00:00

compress.c

Update FSF address.

2011-11-08 14:43:07 +00:00

copy.c

Update FSF address.

2011-11-08 14:43:07 +00:00

COPYING

Build environment set up for libguestfs.

2009-03-03 08:58:37 +00:00

cpmv.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

daemon.h

Clarify the error message when unavailable functions are called (RHBZ#679737).

2012-02-01 15:09:09 +00:00

dd.c

Update FSF address.

2011-11-08 14:43:07 +00:00

debug.c

daemon: debug segv correct use of dereferencing NULL.

2012-01-09 16:55:49 +00:00

devsparts.c

Update FSF address.

2011-11-08 14:43:07 +00:00

df.c

Update FSF address.

2011-11-08 14:43:07 +00:00

dir.c

Update FSF address.

2011-11-08 14:43:07 +00:00

dmesg.c

Update FSF address.

2011-11-08 14:43:07 +00:00

dropcaches.c

Update FSF address.

2011-11-08 14:43:07 +00:00

du.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

echo_daemon.c

Update FSF address.

2011-11-08 14:43:07 +00:00

ext2.c

resize2fs-M: fix double-free along error path (thanks Matthew Booth).

2012-01-16 10:15:02 +00:00

fallocate.c

Update FSF address.

2011-11-08 14:43:07 +00:00

file.c

daemon: Run udev_settle after pwrite-device finishes.

2012-01-19 15:47:19 +00:00

fill.c

Update FSF address.

2011-11-08 14:43:07 +00:00

find.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

findfs.c

Update FSF address.

2011-11-08 14:43:07 +00:00

fsck.c

Update FSF address.

2011-11-08 14:43:07 +00:00

glob.c

Update FSF address.

2011-11-08 14:43:07 +00:00

grep.c

Update FSF address.

2011-11-08 14:43:07 +00:00

grub.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

guestfsd.c

daemon: Return value from write syscall is ssize_t, not int.

2012-01-24 15:56:19 +00:00

headtail.c

Update FSF address.

2011-11-08 14:43:07 +00:00

hexdump.c

Update FSF address.

2011-11-08 14:43:07 +00:00

htonl.c

daemon/Win32: provide htonl, htons, ntohl, ntohs functions.

2009-11-26 11:52:44 +00:00

initrd.c

daemon: Fix memory leak in 'initrd-cat' (found by valgrind).

2012-01-24 15:56:19 +00:00

inotify.c

Clarify the error message when unavailable functions are called (RHBZ#679737).

2012-02-01 15:09:09 +00:00

internal.c

daemon: Move internal-autosync function to new file internal.c.

2012-01-21 21:31:50 +00:00

is.c

Update FSF address.

2011-11-08 14:43:07 +00:00

link.c

Update FSF address.

2011-11-08 14:43:07 +00:00

ls.c

Update FSF address.

2011-11-08 14:43:07 +00:00

luks.c

daemon: Define safe ADD_ARG macro for constructing arg lists on the stack.

2011-11-11 10:48:16 +00:00

lvm-filter.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

lvm.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

Makefile.am

daemon: Move internal-autosync function to new file internal.c.

2012-01-21 21:31:50 +00:00

md.c

daemon: Fix leaking error message (found by valgrind).

2012-01-24 17:00:37 +00:00

mkfs.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

mknod.c

Clarify the error message when unavailable functions are called (RHBZ#679737).

2012-02-01 15:09:09 +00:00

modprobe.c

Update FSF address.

2011-11-08 14:43:07 +00:00

mount.c

Update FSF address.

2011-11-08 14:43:07 +00:00

ntfs.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

parted.c

daemon: Run udev_settle after pwrite-device finishes.

2012-01-19 15:47:19 +00:00

pingdaemon.c

Update FSF address.

2011-11-08 14:43:07 +00:00

proto.c

daemon: Length of message is a 32 bit unsigned quantity.

2012-01-24 15:56:19 +00:00

readdir.c

Update FSF address.

2011-11-08 14:43:07 +00:00

realpath.c

Clarify the error message when unavailable functions are called (RHBZ#679737).

2012-02-01 15:09:09 +00:00

scrub.c

Update FSF address.

2011-11-08 14:43:07 +00:00

selinux.c

Clarify the error message when unavailable functions are called (RHBZ#679737).

2012-02-01 15:09:09 +00:00

sfdisk.c

Update FSF address.

2011-11-08 14:43:07 +00:00

sleep.c

Update FSF address.

2011-11-08 14:43:07 +00:00

stat.c

Update FSF address.

2011-11-08 14:43:07 +00:00

statvfs.c

Update FSF address.

2011-11-08 14:43:07 +00:00

strings.c

Update FSF address.

2011-11-08 14:43:07 +00:00

swap.c

Update FSF address.

2011-11-08 14:43:07 +00:00

sync.c

daemon: Move internal-autosync function to new file internal.c.

2012-01-21 21:31:50 +00:00

tar.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

truncate.c

Update FSF address.

2011-11-08 14:43:07 +00:00

umask.c

Update FSF address.

2011-11-08 14:43:07 +00:00

upload.c

Update FSF address.

2011-11-08 14:43:07 +00:00

utimens.c

daemon: Fix utimens so it doesn't hang on named pipes (RHBZ#761460).

2011-12-08 11:39:58 +00:00

wc.c

Update FSF address.

2011-11-08 14:43:07 +00:00

xattr.c

Clarify the error message when unavailable functions are called (RHBZ#679737).

2012-02-01 15:09:09 +00:00

zero.c

Tempus fugit.

2012-01-18 22:05:02 +00:00

zerofree.c

Update FSF address.

2011-11-08 14:43:07 +00:00