mirror of
https://github.com/MariaDB/server.git
synced 2025-01-22 14:54:20 +01:00
56 lines
1.9 KiB
Groff
56 lines
1.9 KiB
Groff
|
.\" Process this file with
|
||
|
|
.\" groff -man -Tascii foo.1
|
||
|
|
.\"
|
||
|
|
.\" Copyright (c) 2007 Tokutek. All Rights Reserved.
|
||
|
|
.TH db_env_create 3 "November 2007" Tokutek "TokuDB Programmer's Manual"
|
||
|
|
.SH NAME
|
||
|
|
db_env_create
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.LP
|
||
|
|
\fB #include <db.h>
|
||
|
|
.br
|
||
|
|
.sp
|
||
|
|
.HP 13
|
||
|
|
.BI "int db_env_create(DB_ENV **" dbenvp ", u_int32_t " flags ");"
|
||
|
|
.SH DESCRIPTION
|
||
|
|
\fBdb_env_create\fR creates a DB_ENV handle, allocating memory and initializing its contents.
|
||
|
|
.LP
|
||
|
|
After creating the handle, you open a database using \fBdb_create\fR and then \fBDB->open()\fR.
|
||
|
|
|
||
|
|
To free the memory associated with the handle call \fB*\fIdbenvp\fB->close()\fR
|
||
|
|
(or \fBremove\fR when that is ready.)
|
||
|
|
|
||
|
|
The handle contains a field called \fBapp_private\fR which is declared
|
||
|
|
as type \fBvoid*\fR. This field is provided for the use of the
|
||
|
|
application and is not further used by TokuDB.
|
||
|
|
|
||
|
|
.SH PARAMETERS
|
||
|
|
.IP \fIdbenvp
|
||
|
|
A pointer to a \fBDB_ENV\fR variable. The \fBdb_env_create\fR function does something like \fB*\fIdbenvp\fB=malloc(...)\fR.
|
||
|
|
|
||
|
|
.IP \fIflags
|
||
|
|
The \fIflags\fR parameter must be set to 0.
|
||
|
|
|
||
|
|
.SH RETURN VALUE
|
||
|
|
.LP
|
||
|
|
Returns zero on success. The following non-zero errors can be returned:
|
||
|
|
.IP \fBEINVAL
|
||
|
|
You passed invalid parameters to this operation. In many cases
|
||
|
|
\fBEINVAL\fR
|
||
|
|
is not a very helpful error code, indicating only that you did something wrong.
|
||
|
|
|
||
|
|
.SH CONFORMING TO
|
||
|
|
The TokuDB embedded database provides a subset of the functionality of
|
||
|
|
the Berkeley DB. Programs that work with TokuDB probably work with
|
||
|
|
with most versions of Berkeley DB with only recompilation or
|
||
|
|
relinking. The database files are incompatible, however, so to
|
||
|
|
convert from one library to the other you would need to dump the
|
||
|
|
database with one library's tool and load it with the other's.
|
||
|
|
.SH RESTRICTIONS
|
||
|
|
.LP
|
||
|
|
Restrictions: At most a few thousand databases per file.
|
||
|
|
.SH AUTHOR
|
||
|
|
Tokutek, Inc.
|
||
|
|
.SH COPYRIGHT
|
||
|
|
Copyright (c) 2007 Tokutek. All Rights Reserved.
|