From 780b92ada9afcf1d58085a83a0b9e6bc982203d1 Mon Sep 17 00:00:00 2001 From: Lorry Tar Creator Date: Tue, 17 Feb 2015 17:25:57 +0000 Subject: Imported from /home/lorry/working-area/delta_berkeleydb/db-6.1.23.tar.gz. --- docs/programmer_reference/am_misc_error.html | 66 ++++++++++++++++++---------- 1 file changed, 43 insertions(+), 23 deletions(-) (limited to 'docs/programmer_reference/am_misc_error.html') diff --git a/docs/programmer_reference/am_misc_error.html b/docs/programmer_reference/am_misc_error.html index 1739d9a0..df4e5149 100644 --- a/docs/programmer_reference/am_misc_error.html +++ b/docs/programmer_reference/am_misc_error.html @@ -14,7 +14,7 @@

Library Version 11.2.5.3

Library Version 12.1.6.1

@@ -22,9 +22,7 @@ - +

Prev	Chapter 4. - Access Method Wrapup -	Chapter 4. Access Method Wrapup	Next

@@ -38,12 +36,20 @@

Berkeley DB offers programmatic support for displaying error return values.

The db_strerror() function returns a pointer to the error -message corresponding to any Berkeley DB error return, similar to the ANSI C -strerror function, but is able to handle both system error returns and -Berkeley DB specific return values.

For example:

+ Berkeley DB offers programmatic support for displaying error + return values. +

+ The db_strerror() function returns a pointer to the error + message corresponding to any Berkeley DB error return, similar + to the ANSI C strerror function, but is able to handle both + system error returns and Berkeley DB specific return + values. +

+ For example: +

int ret;
 ...
@@ -51,17 +57,28 @@ if ((ret = dbp->put(dbp, NULL, &key, &data, 0)) != 0) {
     fprintf(stderr, "put failed: %s\n", db_strerror(ret));
     return (1);
 }

There are also two additional error methods, DB->err() and -DB->errx(). These methods work like the ANSI C X3.159-1989 (ANSI C) printf -function, taking a printf-style format string and argument list, and -writing a message constructed from the format string and arguments.

The DB->err() method appends the standard error string to the -constructed message; the DB->errx() method does not. These methods -provide simpler ways of displaying Berkeley DB error messages. For example, -if your application tracks session IDs in a variable called session_id, -it can include that information in its error messages:

Error messages can additionally be configured to always include a prefix -(for example, the program name) using the DB->set_errpfx() method.

+ There are also two additional error methods, DB->err() and + DB->errx(). These methods work + like the ANSI C X3.159-1989 (ANSI C) printf function, taking a + printf-style format string and argument list, and writing a + message constructed from the format string and + arguments. +

+ The DB->err() method appends the standard error string to the + constructed message; the + DB->errx() method does not. + These methods provide simpler ways of displaying Berkeley DB + error messages. For example, if your application tracks + session IDs in a variable called session_id, it can include + that information in its error messages: +

+ Error messages can additionally be configured to always + include a prefix (for example, the program name) using the + DB->set_errpfx() method. +

#define DATABASE "access.db"
 
@@ -77,8 +94,11 @@ if ((ret = dbp->open(dbp,
             session_id);
     return (1);
 }

For example, if the program were called my_app and the open call returned -an EACCESS system error, the error messages shown would appear as follows:

+ For example, if the program were called my_app and the open + call returned an EACCESS system error, the error messages + shown would appear as follows: +

my_app: access.db: Permission denied.
 my_app: contact your system administrator: session ID was 14

-- cgit v1.2.1