1
<!--$Id: log_register.so,v 10.29 2001/04/02 20:10:06 bostic Exp $-->
2
<!--Copyright 1997-2001 by Sleepycat Software, Inc.-->
3
<!--All rights reserved.-->
6
<title>Berkeley DB: log_register</title>
7
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
8
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
11
<a name="2"><!--meow--></a>
12
<table width="100%"><tr valign=top>
17
<a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a>
25
log_register(DB_ENV *env, DB *dbp, const char *name);
28
<p>The log_register function registers a filename with the specified Berkeley DB
29
environment's log manager. The log manager records all filename mappings
30
at each checkpoint so that a recovery process can identify the file to
31
which a record in the log refers.
32
<p>The <b>dbp</b> argument should be a reference to the DB structure being
33
registered. The <b>name</b> argument should be a filename appropriate
34
for opening the file in the environment during recovery.
35
<p>The log_register function returns a non-zero error value on failure and 0 on success.
37
<p>The log_register function may fail and return a non-zero error for the following conditions:
39
<p><dt>EINVAL<dd>An invalid flag value or parameter was specified.
41
<p>The log_register function may fail and return a non-zero error for errors specified for other Berkeley DB and C library or system functions.
42
If a catastrophic error has occurred, the log_register function may fail and return
43
<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>, in which case all subsequent Berkeley DB calls will fail
46
<a href="../api_c/env_set_lg_bsize.html">DB_ENV->set_lg_bsize</a>,
47
<a href="../api_c/env_set_lg_dir.html">DB_ENV->set_lg_dir</a>,
48
<a href="../api_c/env_set_lg_max.html">DB_ENV->set_lg_max</a>,
49
<a href="../api_c/env_set_lg_regionmax.html">DB_ENV->set_lg_regionmax</a>,
50
<a href="../api_c/log_archive.html">log_archive</a>,
51
<a href="../api_c/log_compare.html">log_compare</a>,
52
<a href="../api_c/log_file.html">log_file</a>,
53
<a href="../api_c/log_flush.html">log_flush</a>,
54
<a href="../api_c/log_get.html">log_get</a>,
55
<a href="../api_c/log_put.html">log_put</a>,
56
<a href="../api_c/log_register.html">log_register</a>,
57
<a href="../api_c/log_stat.html">log_stat</a>,
59
<a href="../api_c/log_unregister.html">log_unregister</a>.
61
<table width="100%"><tr><td><br></td><td align=right>
62
<a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a>
64
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>