docs: Clarify error handler example.

This commit is contained in:
Richard W.M. Jones
2011-08-06 15:49:55 +01:00
parent 4bd1a5060b
commit 1bf3941b9c

View File

@@ -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