head 1.2; access; symbols RPM_4_2_1:1.1.1.5 RPM_4_2:1.1.1.5 RPM_4_1_1:1.1.1.5 RPM_4_1:1.1.1.4 RPM_4_0_5:1.1.1.3 RPM_4_0_4:1.1.1.2 RPM_4_0_3:1.1.1.1 RPM:1.1.1; locks; strict; comment @# @; 1.2 date 2008.01.02.09.52.52; author rse; state dead; branches; next 1.1; commitid z4cpSiAhOCXk5PLs; 1.1 date 2001.07.23.20.45.36; author rse; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2001.07.23.20.45.36; author rse; state Exp; branches; next 1.1.1.2; 1.1.1.2 date 2002.01.08.00.30.08; author rse; state Exp; branches; next 1.1.1.3; 1.1.1.3 date 2003.01.18.13.48.55; author rse; state Exp; branches; next 1.1.1.4; 1.1.1.4 date 2001.12.06.00.08.00; author rse; state Exp; branches; next 1.1.1.5; 1.1.1.5 date 2003.01.18.14.04.56; author rse; state Exp; branches; next ; desc @@ 1.2 log @remove the ancient RPM 4.2.1 source tree copy @ text @ Berkeley DB: DB_ENV->err

DB_ENV->err

 APIRef 

#include <db.h>


void
DB_ENV->err(DB_ENV *dbenv, int error, const char *fmt, ...);


void
DB_ENV->errx(DB_ENV *dbenv, const char *fmt, ...);

Description

The DB_ENV->err, DB_ENV->errx, DB->err and DB->errx functions provide error-messaging functionality for applications written using the Berkeley DB library.

The DB_ENV->err function constructs an error message consisting of the following elements:

An optional prefix string
If no error callback function has been set using the DB_ENV->set_errcall function, any prefix string specified using the DB_ENV->set_errpfx function, followed by two separating characters: a colon and a <space> character.

An optional printf-style message
The supplied message fmt, if non-NULL, in which the ANSI C X3.159-1989 (ANSI C) printf function specifies how subsequent arguments are converted for output.

A separator
Two separating characters: a colon and a <space> character.

A standard error string
The standard system or Berkeley DB library error string associated with the error value, as returned by the db_strerror function.

This constructed error message is then handled as follows:

If an error callback function has been set (see DB->set_errcall and DB_ENV->set_errcall), that function is called with two arguments: any prefix string specified (see DB->set_errpfx and DB_ENV->set_errpfx) and the error message.

If a C library FILE * has been set (see DB->set_errfile and DB_ENV->set_errfile), the error message is written to that output stream.

If none of these output options has been configured, the error message is written to stderr, the standard error output stream.

The DB_ENV->errx and DB->errx functions perform identically to the DB_ENV->err and DB->err functions, except that they do not append the final separator characters and standard error string to the error message.

See Also

db_env_create, DB_ENV->close, DB_ENV->err, DB_ENV->errx DB_ENV->open, DB_ENV->remove, DB_ENV->set_alloc, DB_ENV->set_cachesize, DB_ENV->set_data_dir, DB_ENV->set_errcall, DB_ENV->set_errfile, DB_ENV->set_errpfx, DB_ENV->set_feedback, DB_ENV->set_flags, DB_ENV->set_mutexlocks, db_env_set_pageyield, DB_ENV->set_paniccall, db_env_set_panicstate, DB_ENV->set_recovery_init, DB_ENV->set_rpc_server, db_env_set_region_init, DB_ENV->set_shm_key, db_env_set_tas_spins, DB_ENV->set_tmp_dir, DB_ENV->set_verbose, db_strerror and db_version.

APIRef

Copyright Sleepycat Software @ 1.1 log @Initial revision @ text @d1 1 a1 1 @ 1.1.1.1 log @Import: RPM 4.0.3 @ text @@ 1.1.1.2 log @Import: RPM 4.0.4 @ text @d1 1 a1 1 d78 2 d81 1 d84 1 d86 1 a86 1 DB_ENV->set_tas_spins, a87 1 DB_ENV->set_timeout, @ 1.1.1.3 log @Import: RPM 4.0.5 @ text @d1 2 a2 2 a3 1 d32 1 a32 1 DB->errx methods provide error-messaging functionality for d34 1 a34 1

The DB_ENV->err method constructs an error message consisting of the d38 2 a39 2 DB_ENV->set_errcall method, any prefix string specified using the DB_ENV->set_errpfx method, followed by two separating characters: a colon d46 1 a46 1 error value, as returned by the db_strerror method. d59 3 a61 4 is written to stderr, the standard error output stream.

The DB_ENV->errx and DB->errx methods perform identically to the DB_ENV->err and DB->err methods, except that they do not append a63 2

Class

DB_ENV d65 24 a88 1 Database Environments and Related Methods @ 1.1.1.4 log @Import: RPM 4.1 @ text @d1 2 a2 2 d4 1 d33 1 a33 1 DB->errx functions provide error-messaging functionality for d35 1 a35 1

The DB_ENV->err function constructs an error message consisting of the d39 2 a40 2 DB_ENV->set_errcall function, any prefix string specified using the DB_ENV->set_errpfx function, followed by two separating characters: a colon d47 1 a47 1 error value, as returned by the db_strerror function. d60 4 a63 3 is written to stderr, the standard error output stream.

The DB_ENV->errx and DB->errx functions perform identically to the DB_ENV->err and DB->err functions, except that they do not append d66 2 d69 1 a69 24 db_env_create, DB_ENV->close, DB_ENV->err, DB_ENV->errx DB_ENV->open, DB_ENV->remove, DB_ENV->set_alloc, DB_ENV->set_cachesize, DB_ENV->set_data_dir, DB_ENV->set_errcall, DB_ENV->set_errfile, DB_ENV->set_errpfx, DB_ENV->set_feedback, DB_ENV->set_flags, DB_ENV->set_paniccall, DB_ENV->set_recovery_init, DB_ENV->set_rpc_server, DB_ENV->set_shm_key, DB_ENV->set_tas_spins, DB_ENV->set_tmp_dir, DB_ENV->set_timeout, DB_ENV->set_verbose, db_strerror and db_version. @ 1.1.1.5 log @Import: RPM 4.1.1 @ text @d1 2 a2 2 a3 1 d32 1 a32 1 DB->errx methods provide error-messaging functionality for d34 1 a34 1

The DB_ENV->err method constructs an error message consisting of the d38 2 a39 2 DB_ENV->set_errcall method, any prefix string specified using the DB_ENV->set_errpfx method, followed by two separating characters: a colon d46 1 a46 1 error value, as returned by the db_strerror method. d59 3 a61 4 is written to stderr, the standard error output stream.

The DB_ENV->errx and DB->errx methods perform identically to the DB_ENV->err and DB->err methods, except that they do not append a63 2

Class

DB_ENV d65 24 a88 1 Database Environments and Related Methods @