blob: 18bea6eedd355d3188e1cf95f48d97e9bfce2b6f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Administrative Methods</title>
<link rel="stylesheet" href="gettingStarted.css" type="text/css" />
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
<link rel="start" href="index.html" title="Getting Started with Berkeley DB" />
<link rel="up" href="databases.html" title="Chapter 2. Databases" />
<link rel="prev" href="DBOpenFlags.html" title="Database Open Flags" />
<link rel="next" href="dbErrorReporting.html" title="Error Reporting Functions" />
</head>
<body>
<div xmlns="" class="navheader">
<div class="libver">
<p>Library Version 12.1.6.1</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Administrative Methods</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="DBOpenFlags.html">Prev</a> </td>
<th width="60%" align="center">Chapter 2. Databases</th>
<td width="20%" align="right"> <a accesskey="n" href="dbErrorReporting.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="CoreDBAdmin"></a>Administrative Methods</h2>
</div>
</div>
</div>
<p>
The following
<code class="classname">DB</code>
methods may be useful to you when managing DB databases:
</p>
<div class="itemizedlist">
<ul type="disc">
<li>
<p>
<code class="methodname">DB->get_open_flags()</code>
</p>
<p>
Returns the current open flags. It is an error to use this method on
an unopened database.
</p>
<a id="c_db5"></a>
<pre class="programlisting">#include <db.h>
...
DB *dbp;
u_int32_t open_flags;
/* Database open and subsequent operations omitted for clarity */
dbp->get_open_flags(dbp, &open_flags); </pre>
</li>
<li>
<p>
<code class="methodname">DB->remove()</code>
</p>
<p>
Removes the specified database. If no value is given for the
<em class="parameter"><code>database</code></em> parameter, then the entire file
referenced by this method is removed.
</p>
<p>
Never remove a database that has handles opened for it. Never remove a file that
contains databases with opened handles.
</p>
<a id="c_db6"></a>
<pre class="programlisting">#include <db.h>
...
DB *dbp;
/* Database handle creation omitted for clarity */
dbp->remove(dbp, /* Database pointer */
"mydb.db", /* Database file to remove */
NULL, /* Database to remove. This is
* NULL so the entire file is
* removed. */
0); /* Flags. None used. */</pre>
</li>
<li>
<p>
<code class="methodname">DB->rename()</code>
</p>
<p>
Renames the specified database. If no value is given for the
<em class="parameter"><code>database</code></em> parameter, then the entire file
referenced by this method is renamed.
</p>
<p>
Never rename a database that has handles opened for it. Never rename a file that
contains databases with opened handles.
</p>
<a id="c_db7"></a>
<pre class="programlisting">#include <db.h>
...
DB *dbp;
/* Database handle creation omitted for clarity */
dbp->rename(dbp, /* Database pointer */
"mydb.db", /* Database file to rename */
NULL, /* Database to rename. This is
* NULL so the entire file is
* renamed. */
"newdb.db", /* New database file name */
0); /* Flags. None used. */</pre>
</li>
</ul>
</div>
<span>
</span>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="DBOpenFlags.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="databases.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="dbErrorReporting.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Database Open Flags </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Error Reporting Functions</td>
</tr>
</table>
</div>
</body>
</html>
|
