Edit File - File Manager

Edit File: env_fileid_reset.html

<html>
<head>
<title>Berkeley DB: DbEnv::fileid_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>
DbEnv::fileid_reset
</td>
<td align=right>
<a href="../../db4-devel-4.7.25/api_cxx/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_cxx.h&gt;

int
DbEnv::fileid_reset(const char *file, u_int32_t flags);
</pre>
<hr size=1 noshade>
Description: DbEnv::fileid_reset
The DbEnv::fileid_reset method allows database files to be copied, and
then the copy used in the same database environment as the original.
All databases contain an ID string used to identify the database in the
database environment cache. If a physical database file is copied, and
used in the same environment as another file with the same ID strings,
corruption can occur. The DbEnv::fileid_reset method creates new ID
strings for all of the databases in the physical file.
The DbEnv::fileid_reset method modifies the physical file, in-place.
Applications should not reset IDs in files that are currently in use.
The DbEnv::fileid_reset method may be called at any time during the life of the
application.
The DbEnv::fileid_reset method
either returns a non-zero error value
or throws an exception that encapsulates a non-zero error value on
failure, and returns 0 on success.

Parameters 
 file<ul compact><li>The name of the physical file in which new file IDs are to be created.</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 DbEnv::fileid_reset method
may fail and throw
<a href="../../db4-devel-4.7.25/api_cxx/except_class.html">DbException</a>,
encapsulating one of the following non-zero errors, or 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_cxx/env_class.html">DbEnv</a>
 See Also
<a href="../../db4-devel-4.7.25/api_cxx/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_cxx/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>

Back to File Manager