← Back to branch summary

~ubuntu-branches/ubuntu/maverick/evolution-data-server/maverick-proposed

« back to all changes in this revision

Viewing changes to libdb/docs/api_c/db_create.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
https://launchpad.net/bugs/42199
https://launchpad.net/bugs/229669
https://launchpad.net/bugs/173703
https://launchpad.net/bugs/360344
https://launchpad.net/bugs/508494
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
libdb/docs/api_c/db_create.html
1
 
<!--$Id$-->
2
 
<!--Copyright 1997-2002 by Sleepycat Software, Inc.-->
3
 
<!--All rights reserved.-->
4
 
<!--See the file LICENSE for redistribution information.-->
5
 
<html>
6
 
<head>
7
 
<title>Berkeley DB: db_create</title>
8
 
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
9
 
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
10
 
</head>
11
 
<body bgcolor=white>
12
 
<a name="2"><!--meow--></a>
13
 
<table width="100%"><tr valign=top>
14
 
<td>
15
 
<h1>db_create</h1>
16
 
</td>
17
 
<td align=right>
18
 
<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>
19
 
</td></tr></table>
20
 
<hr size=1 noshade>
21
 
<tt>
22
 
<h3><pre>
23
 
#include &lt;db.h&gt;
24
 
<p>
25
 
int
26
 
db_create(DB **dbp, DB_ENV *dbenv, u_int32_t flags);
27
 
</pre></h3>
28
 
<h1>Description</h1>
29
 
<p>The db_create method creates a <a href="../api_c/db_class.html">DB</a> structure that is the
30
 
handle for a Berkeley DB database.  A pointer to this structure is returned
31
 
in the memory to which <b>db</b> refers.  Calling the
32
 
<a href="../api_c/db_close.html">DB-&gt;close</a>, <a href="../api_c/db_remove.html">DB-&gt;remove</a> or <a href="../api_c/db_rename.html">DB-&gt;rename</a> methods will
33
 
discard the returned handle.
34
 
<p>If the <b>dbenv</b> argument is NULL, the database is standalone; that
35
 
is, it is not part of any Berkeley DB environment.
36
 
<p>If the <b>dbenv</b> argument is not NULL, the database is created
37
 
within the specified Berkeley DB environment.  The database access methods
38
 
automatically make calls to the other subsystems in Berkeley DB, based on the
39
 
enclosing environment.  For example, if the environment has been
40
 
configured to use locking, the access methods will automatically acquire
41
 
the correct locks when reading and writing pages of the database.
42
 
<p>The <b>flags</b> value must be set to 0 or
43
 
the following value:
44
 
<p><dl compact>
45
 
<p><dt><a name="DB_XA_CREATE">DB_XA_CREATE</a><dd>Instead of creating a standalone database, create a database intended
46
 
to be accessed via applications running under an X/Open conformant
47
 
Transaction Manager.  The database will be opened in the environment
48
 
specified by the OPENINFO parameter of the GROUPS section of the
49
 
ubbconfig file.  See the <a href="../ref/xa/xa_intro.html">XA
50
 
Introduction</a> section in the Berkeley DB Reference Guide for more information.
51
 
</dl>
52
 
<p>The <a href="../api_c/db_class.html">DB</a> handle contains a special field, "app_private", which
53
 
is declared as type "void *".  This field is provided for the use of
54
 
the application program.  It is initialized to NULL and is not further
55
 
used by Berkeley DB in any way.
56
 
<p>The db_create method returns a non-zero error value on failure and 0 on success.
57
 
<h1>Errors</h1>
58
 
<p>The db_create method may fail and return a non-zero error for errors specified for other Berkeley DB and C library or system functions.
59
 
If a catastrophic error has occurred, the db_create method may fail and
60
 
return <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>,
61
 
in which case all subsequent Berkeley DB calls will fail in the same way.
62
 
<h1>Class</h1>
63
 
<a href="../api_c/db_class.html">DB</a>
64
 
<h1>See Also</h1>
65
 
<a href="../api_c/db_list.html">Databases and Related Methods</a>
66
 
</tt>
67
 
<table width="100%"><tr><td><br></td><td align=right>
68
 
<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>
69
 
</td></tr></table>
70
 
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
71
 
</body>
72
 
</html>