AnonymousFox

//usr/share/doc/db4-devel-4.7.25/api_c/env_lsn_reset.html

<html>
<head>
<title>Berkeley DB: DB_ENV-&gt;lsn_reset</title>
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
</head>
<body bgcolor=white>
<table width="100%"><tr valign=top>
<td>
DB_ENV-&gt;lsn_reset
</td>
<td align=right>
<a href="../../db4-devel-4.7.25/api_c/api_core.html"><img src="../../db4-devel-4.7.25/images/api.gif" alt="API"></a>
<a href="../../db4-devel-4.7.25/ref/toc.html"><img src="../../db4-devel-4.7.25/images/ref.gif" alt="Ref"></a></td>
</tr></table>
<hr size=1 noshade>
<tt>
<pre>
#include &lt;db.h&gt;

int
DB_ENV-&gt;lsn_reset(DB_ENV *dbenv, const char *file, u_int32_t flags);
</pre>
<hr size=1 noshade>
Description: DB_ENV-&gt;lsn_reset
The DB_ENV-&gt;lsn_reset method allows database files to be moved from one
transactional database environment to another.
Database pages in transactional database environments contain references
to the environment's log files (that is, log sequence numbers, or LSNs).
Copying or moving a database file from one database environment to
another, and then modifying it, can result in data corruption if the
LSNs are not first cleared.
Note that LSNs should be reset before moving or copying the database
file into a new database environment, rather than moving or copying the
database file and then resetting the LSNs. Berkeley DB has consistency checks
that may be triggered if an application calls DB_ENV-&gt;lsn_reset
on a database in a new environment when the database LSNs still reflect
the old environment.
The DB_ENV-&gt;lsn_reset method modifies the physical file, in-place.
Applications should not reset LSNs in files that are currently in use.
The DB_ENV-&gt;lsn_reset method may be called at any time during the life of the
application.
The DB_ENV-&gt;lsn_reset method
returns a non-zero error value on failure
and 0 on success.

Parameters 
 file<ul compact><li>The name of the physical file in which the LSNs are to be cleared.</ul>
 flags<ul compact><li>The flags parameter must be set to 0 or
the following value:
 
DB_ENCRYPT<ul compact><li>The file contains encrypted databases.</ul>
 </ul>
 
 Errors
The DB_ENV-&gt;lsn_reset method
may fail and return one of the following non-zero errors:
 
EINVAL<ul compact><li>An
invalid flag value or parameter was specified.</ul>
 
<hr size=1 noshade>
 Class
<a href="../../db4-devel-4.7.25/api_c/env_class.html">DB_ENV</a>
 See Also
<a href="../../db4-devel-4.7.25/api_c/env_list.html">Database Environments and Related Methods</a>
</tt>
<table width="100%"><tr><td> </td><td align=right>
<a href="../../db4-devel-4.7.25/api_c/api_core.html"><img src="../../db4-devel-4.7.25/images/api.gif" alt="API"></a><a href="../../db4-devel-4.7.25/ref/toc.html"><img src="../../db4-devel-4.7.25/images/ref.gif" alt="Ref"></a>
</td></tr></table>
Copyright (c) 1996,2008 Oracle. All rights reserved.
</body>
</html>