summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2011-08-06 15:49:55 +0100
committerRichard W.M. Jones <rjones@redhat.com>2011-08-06 15:49:55 +0100
commit1bf3941b9ccabef122cc6479004d18ddcb935eef (patch)
tree669c84c554a17e90de93441c678c2598d1c75a39
parent4bd1a5060bc95d8d933efa52f8d4aa26ecc118f5 (diff)
downloadlibguestfs-1bf3941b9ccabef122cc6479004d18ddcb935eef.tar.gz
libguestfs-1bf3941b9ccabef122cc6479004d18ddcb935eef.tar.xz
libguestfs-1bf3941b9ccabef122cc6479004d18ddcb935eef.zip
docs: Clarify error handler example.
-rw-r--r--src/guestfs.pod9
1 files changed, 5 insertions, 4 deletions
diff --git a/src/guestfs.pod b/src/guestfs.pod
index 76570a71..a1831c0d 100644
--- a/src/guestfs.pod
+++ b/src/guestfs.pod
@@ -1344,8 +1344,6 @@ been printed to C<stderr> before the program exits.
For other programs the caller will almost certainly want to install an
alternate error handler or do error handling in-line like this:
- g = guestfs_create ();
-
/* This disables the default behaviour of printing errors
on stderr. */
guestfs_set_error_handler (g, NULL, NULL);
@@ -1354,9 +1352,12 @@ alternate error handler or do error handling in-line like this:
/* Examine the error message and print it etc. */
char *msg = guestfs_last_error (g);
int errnum = guestfs_last_errno (g);
- fprintf (stderr, "%s\n", msg);
+ fprintf (stderr, "%s", msg);
+ if (errnum != 0)
+ fprintf (stderr, ": %s", strerror (errnum));
+ fprintf (stderr, "\n");
/* ... */
- }
+ }
Out of memory errors are handled differently. The default action is
to call L<abort(3)>. If this is undesirable, then you can set a