# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2012-06-02 02:24+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: ds ve
#: original/man3/gdbm.3:1
#, no-wrap
msgid "1.8.3"
msgstr ""

#. type: TH
#: original/man3/gdbm.3:2
#, no-wrap
msgid "GDBM"
msgstr ""

#. type: TH
#: original/man3/gdbm.3:2
#, no-wrap
msgid "10/15/2002"
msgstr ""

#. type: SH
#: original/man3/gdbm.3:3
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:6
msgid ""
"GDBM - The GNU database manager.  Includes B<dbm> and B<ndbm> "
"compatability. (Version \\*(ve.)"
msgstr ""

#. type: SH
#: original/man3/gdbm.3:6
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:8
msgid "B<#include E<lt>gdbm.hE<gt>>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:11
msgid "E<.SM> B<extern gdbm_error>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:13
msgid "B<gdbm_errno>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:15
msgid "B<extern char>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:17
msgid "B<*gdbm_version>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:19
msgid "B<GDBM_FILE>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:21
msgid "B<gdbm_open (name, block_size, read_write, mode, fatal_func)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:23
msgid "B<char * name;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:25
msgid "B<int block_size, read_write, mode;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:27
msgid "B<void (*fatal_func) ();>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:29 original/man3/gdbm.3:81 original/man3/gdbm.3:177
msgid "B<void>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:31
msgid "B<gdbm_close (dbf)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:33 original/man3/gdbm.3:39 original/man3/gdbm.3:49 original/man3/gdbm.3:57 original/man3/gdbm.3:65 original/man3/gdbm.3:71 original/man3/gdbm.3:79 original/man3/gdbm.3:85 original/man3/gdbm.3:91 original/man3/gdbm.3:105 original/man3/gdbm.3:117
msgid "B<GDBM_FILE dbf;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:35 original/man3/gdbm.3:53 original/man3/gdbm.3:75 original/man3/gdbm.3:87 original/man3/gdbm.3:101 original/man3/gdbm.3:113 original/man3/gdbm.3:131 original/man3/gdbm.3:143 original/man3/gdbm.3:159 original/man3/gdbm.3:191 original/man3/gdbm.3:201 original/man3/gdbm.3:221 original/man3/gdbm.3:227 original/man3/gdbm.3:233 original/man3/gdbm.3:239 original/man3/gdbm.3:245
msgid "B<int>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:37
msgid "B<gdbm_store (dbf, key, content, flag)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:41 original/man3/gdbm.3:135 original/man3/gdbm.3:197
msgid "B<datum key, content;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:43
msgid "B<int flag;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:45 original/man3/gdbm.3:61 original/man3/gdbm.3:67 original/man3/gdbm.3:137 original/man3/gdbm.3:149 original/man3/gdbm.3:153 original/man3/gdbm.3:183 original/man3/gdbm.3:209 original/man3/gdbm.3:215
msgid "B<datum>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:47
msgid "B<gdbm_fetch (dbf, key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:51 original/man3/gdbm.3:59 original/man3/gdbm.3:73 original/man3/gdbm.3:93 original/man3/gdbm.3:141 original/man3/gdbm.3:147 original/man3/gdbm.3:157 original/man3/gdbm.3:189 original/man3/gdbm.3:207
msgid "B<datum key;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:55
msgid "B<gdbm_delete (dbf, key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:63
msgid "B<gdbm_firstkey (dbf)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:69
msgid "B<gdbm_nextkey (dbf, key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:77
msgid "B<gdbm_reorganize (dbf)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:83
msgid "B<gdbm_sync (dbf)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:89
msgid "B<gdbm_exists (dbf, key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:95
msgid "B<char *>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:97
msgid "B<gdbm_strerror (errno)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:99
msgid "B<gdbm_error errno;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:103
msgid "B<gdbm_setopt (dbf, option, value, size)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:107
msgid "B<int option;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:109
msgid "B<int *value;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:111
msgid "B<int size;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:115
msgid "B<gdbm_fdesc (dbf)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:120
msgid "B<DBM Compatability routines:>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:122
msgid "B<#include E<lt>dbm.hE<gt>>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:125
msgid "E<.SM> B<int>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:127
msgid "B<dbminit (name)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:129 original/man3/gdbm.3:173
msgid "B<char *name;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:133
msgid "B<store (key, content)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:139
msgid "B<fetch (key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:145
msgid "B<delete (key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:151
msgid "B<firstkey ()>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:155
msgid "B<nextkey (key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:161
msgid "B<dbmclose ()>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:164
msgid "B<NDBM Compatability routines:>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:166
msgid "B<#include E<lt>ndbm.hE<gt>>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:169
msgid "E<.SM> B<DBM>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:171
msgid "B<*dbm_open (name, flags, mode)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:175
msgid "B<int flags, mode;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:179
msgid "B<dbm_close (file)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:181 original/man3/gdbm.3:187 original/man3/gdbm.3:195 original/man3/gdbm.3:205 original/man3/gdbm.3:213 original/man3/gdbm.3:219 original/man3/gdbm.3:225 original/man3/gdbm.3:231 original/man3/gdbm.3:237 original/man3/gdbm.3:243 original/man3/gdbm.3:249
msgid "B<DBM *file;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:185
msgid "B<dbm_fetch (file, key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:193
msgid "B<dbm_store (file, key, content, flags)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:199
msgid "B<int flags;>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:203
msgid "B<dbm_delete (file, key)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:211
msgid "B<dbm_firstkey (file)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:217
msgid "B<dbm_nextkey (file)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:223
msgid "B<dbm_error (file)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:229
msgid "B<dbm_clearerr (file)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:235
msgid "B<dbm_pagfno (file)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:241
msgid "B<dbm_dirfno (file)>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:247
msgid "B<dbm_rdonly (file)>"
msgstr ""

#. type: SH
#: original/man3/gdbm.3:251
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:257
msgid ""
"GNU dbm is a library of routines that manages data files that contain "
"key/data pairs.  The access provided is that of storing, retrieval, and "
"deletion by key and a non-sorted traversal of all keys.  A process is "
"allowed to use multiple data files at the same time."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:262
msgid ""
"A process that opens a gdbm file is designated as a \"reader\" or a "
"\"writer\".  Only one writer may open a gdbm file and many readers may open "
"the file.  Readers and writers can not open the gdbm file at the same "
"time. The procedure for opening a gdbm file is:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:264
#, no-wrap
msgid "  GDBM_FILE dbf;\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:266
#, no-wrap
msgid "  dbf = gdbm_open ( name, block_size, read_write, mode, fatal_func )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:273
msgid ""
"I<Name> is the name of the file (the complete name, gdbm does not append any "
"characters to this name).  I<Block_size> is the size of a single transfer "
"from disk to memory. This parameter is ignored unless the file is a new "
"file.  The minimum size is 512.  If it is less than 512, dbm will use the "
"stat block size for the file system.  I<Read_write> can have one of the "
"following values:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:276
msgid "B<GDBM_READER> reader"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:279
msgid "B<GDBM_WRITER> writer"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:282
msgid "B<GDBM_WRCREAT> writer - if database does not exist create new one"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:285
msgid "B<GDBM_NEWDB> writer - create new database regardless if one exists"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:295
msgid ""
"For the last three (writers of the database) the following may be added "
"added to I<read_write> by bitwise or: B<GDBM_SYNC,> which causes all "
"database operations to be synchronized to the disk, and B<GDBM_NOLOCK,> "
"which prevents the library from performing any locking on the database "
"file.  The option B<GDBM_FAST> is now obsolete, since gdbm defaults to "
"no-sync mode."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:300
msgid ""
"I<Mode> is the file mode (see B<chmod(2)> and B<open(2)>) if the file is "
"created. I<(*Fatal_func) ()> is a function for dbm to call if it detects a "
"fatal error. The only parameter of this function is a string.  If the value "
"of 0 is provided, gdbm will use a default function."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:306
msgid ""
"The return value I<dbf> is the pointer needed by all other routines to "
"access that gdbm file.  If the return is the NULL pointer, B<gdbm_open> was "
"not successful.  The errors can be found in I<gdbm_errno> for gdbm errors "
"and in I<errno> for system errors.  (For error codes, see gdbmerrno.h.)"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:309
msgid ""
"In all of the following calls, the parameter I<dbf> refers to the pointer "
"returned from B<gdbm_open>."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:312
msgid ""
"It is important that every file opened is also closed.  This is needed to "
"update the reader/writer count on the file.  This is done by:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:314
#, no-wrap
msgid "  gdbm_close (dbf);\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:318
msgid ""
"The database is used by 3 primary routines.  The first stores data in the "
"database."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:320
#, no-wrap
msgid "  ret = gdbm_store ( dbf, key, content, flag )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:324
msgid ""
"I<Dbf> is the pointer returned by B<gdbm_open>.  I<Key> is the key data.  "
"I<Content> is the data to be associated with the I<key>.  I<Flag> can have "
"one of the following values:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:327
msgid "B<GDBM_INSERT> insert only, generate an error if key exists"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:330
msgid "B<GDBM_REPLACE> replace contents if key exists."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:334
msgid ""
"If a reader calls B<gdbm_store>, the return value will be -1.  If called "
"with GDBM_INSERT and I<key> is in the database, the return value will be 1.  "
"Otherwise, the return value is 0."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:339
msgid ""
"I<NOTICE: If you store data for a key that is already in the data base, gdbm "
"replaces the old data with the new data if called with GDBM_REPLACE.  You do "
"not get two data items for the same key and you do not get an error from "
"gdbm_store.>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:342
msgid ""
"I<NOTICE: The size in gdbm is not restricted like dbm or ndbm.  Your data "
"can be as large as you want.>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:345
msgid "To search for some data:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:347
#, no-wrap
msgid "  content = gdbm_fetch ( dbf, key )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:350 original/man3/gdbm.3:379
msgid "I<Dbf> is the pointer returned by B<gdbm_open>.  I<Key> is the key data."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:358
msgid ""
"If the I<dptr> element of the return value is NULL, no data was found.  "
"Otherwise the return value is a pointer to the found data.  The storage "
"space for the I<dptr> element is allocated using B<malloc(3C)>.  B<Gdbm>I< "
"does not automatically free this data.  It is the programmer's "
"responsibility to free this storage when it is no longer needed.>"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:361
msgid "To search for some data, without retrieving it:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:363
#, no-wrap
msgid "  ret = gdbm_exists ( dbf, key )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:366
msgid ""
"I<Dbf> is the pointer returned by B<gdbm_open>.  I<Key> is the key data to "
"search for."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:371
msgid ""
"If the I<key> is found within the database, the return value I<ret> will be "
"true.  If nothing appropiate is found, I<ret> will be false.  This routine "
"is useful for checking for the existance of a record, without performing the "
"memory allocation done by B<gdbm_fetch>."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:374
msgid "To remove some data from the database:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:376
#, no-wrap
msgid "  ret = gdbm_delete ( dbf, key )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:382
msgid ""
"The return value is -1 if the item is not present or the requester is a "
"reader.  The return value is 0 if there was a successful delete."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:387
msgid ""
"The next two routines allow for accessing all items in the database.  This "
"access is not key sequential, but it is guaranteed to visit every key in the "
"database once.  (The order has to do with the hash values.)"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:389
#, no-wrap
msgid "  key = gdbm_firstkey ( dbf )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:391
#, no-wrap
msgid "  nextkey = gdbm_nextkey ( dbf, key )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:394
msgid "I<Dbf> is the pointer returned by B<gdbm_open>. I<Key> is the key data."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:399
msgid ""
"The return values are both of type B<datum>.  If the I<dptr> element of the "
"return value is NULL, there is no first key or next key.  Again notice that "
"I<dptr> points to data allocated by B<malloc(3C)> and B<gdbm> will not free "
"it for you."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:402
msgid ""
"These functions were intended to visit the database in read-only algorithms, "
"for instance, to validate the database or similar operations."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:408
msgid ""
"File `visiting' is based on a `hash table'.  I<gdbm_delete> re-arranges the "
"hash table to make sure that any collisions in the table do not leave some "
"item `un-findable'.  The original key order is NOT guaranteed to remain "
"unchanged in ALL instances.  It is possible that some key will not be "
"visited if a loop like the following is executed:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:418
#, no-wrap
msgid ""
"   key = gdbm_firstkey ( dbf );\n"
"   while ( key.dptr ) {\n"
"      nextkey = gdbm_nextkey ( dbf, key );\n"
"      if ( some condition ) {\n"
"         gdbm_delete ( dbf, key );\n"
"         free ( key.dptr );\n"
"      }\n"
"      key = nextkey;\n"
"   }\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:421
msgid "The following routine should be used very infrequently."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:423
#, no-wrap
msgid "  ret = gdbm_reorganize ( dbf )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:428
msgid ""
"If you have had a lot of deletions and would like to shrink the space used "
"by the B<gdbm> file, this routine will reorganize the database.  B<Gdbm> "
"will not shorten the length of a B<gdbm> file except by using this "
"reorganization.  (Deleted file space will be reused.)"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:434
msgid ""
"Unless your database was opened with the GDBM_SYNC flag, gdbm does not wait "
"for writes to be flushed to the disk before continuing.  The following "
"routine can be used to guarantee that the database is physically written to "
"the disk file."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:436
#, no-wrap
msgid "  gdbm_sync ( dbf )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:439
msgid ""
"It will not return until the disk file state is syncronized with the "
"in-memory state of the database."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:442
msgid "To convert a B<gdbm> error code into English text, use this routine:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:444
#, no-wrap
msgid "  ret = gdbm_strerror ( errno )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:447
msgid ""
"Where I<errno> is of type I<gdbm_error>, usually the global variable "
"I<gdbm_errno>.  The appropiate phrase is returned."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:451
msgid ""
"B<Gdbm> now supports the ability to set certain options on an already open "
"database."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:453
#, no-wrap
msgid "  ret = gdbm_setopt ( dbf, option, value, size )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:457
msgid ""
"Where I<dbf> is the return value from a previous call to B<gdbm_open>, and "
"I<option> specifies which option to set.  The valid options are currently:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:462
#, no-wrap
msgid ""
"  B<GDBM_CACHESIZE> - Set the size of the internal bucket\n"
"  cache. This option may only be set once on each I<GDBM_FILE>\n"
"  descriptor, and is set automatically to 100 upon the first\n"
"  access to the database.\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:467
#, no-wrap
msgid ""
"  B<GDBM_FASTMODE> - Set B<fast mode> to either on or off.  This\n"
"  allows B<fast mode> to be toggled on an already open and\n"
"  active database. I<value> (see below) should be set to either\n"
"  TRUE or FALSE.  I<This option is now obsolete.>\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:471
#, no-wrap
msgid ""
"  B<GDBM_SYNCMODE> - Turn on or off file system synchronization "
"operations.\n"
"  This setting defaults to off; I<value> (see below) should be set to "
"either\n"
"  TRUE or FALSE.\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:479
#, no-wrap
msgid ""
"  B<GDBM_CENTFREE> - Set B<central free block pool> to either on or off.\n"
"  The default is off, which is how previous versions of B<Gdbm>\n"
"  handled free blocks. If set, this option causes all subsequent free\n"
"  blocks to be placed in the B<global> pool, allowing (in thoery)\n"
"  more file space to be reused more quickly. I<value> (see below) should\n"
"  be set to either TRUE or FALSE.\n"
"  I<NOTICE: This feature is still under study.>\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:487
#, no-wrap
msgid ""
"  B<GDBM_COALESCEBLKS> - Set B<free block merging> to either on or off.\n"
"  The default is off, which is how previous versions of B<Gdbm>\n"
"  handled free blocks. If set, this option causes adjacent free blocks\n"
"  to be merged. This can become a CPU expensive process with time, though,\n"
"  especially if used in conjunction with B<GDBM_CENTFREE>. I<value>\n"
"  (see below) should be set to either TRUE or FALSE.\n"
"  I<NOTICE: This feature is still under study.>\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:492
msgid ""
"I<value> is the value to set I<option> to, specified as an integer pointer.  "
"I<size> is the size of the data pointed to by I<value>.  The return value "
"will be -1 upon failure, or 0 upon success.  The global variable "
"I<gdbm_errno> will be set upon failure."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:496
msgid ""
"For instance, to set a database to use a cache of 10, after opening it with "
"B<gdbm_open>, but prior to accessing it in any way, the following code could "
"be used:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:498
#, no-wrap
msgid "  int value = 10;\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:500
#, no-wrap
msgid "  ret = gdbm_setopt( dbf, GDBM_CACHESIZE, &value, sizeof(int));\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:505
msgid ""
"If the database was opened with the B<GDBM_NOLOCK> flag, the user may wish "
"to perform their own file locking on the database file in order to prevent "
"multiple writers operating on the same file simultaneously."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:507
msgid "In order to support this, the I<gdbm_fdesc> routine is provided."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:509
#, no-wrap
msgid "  ret = gdbm_fdesc ( dbf )\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:512
msgid ""
"Where I<dbf> is the return value from a previous call to B<gdbm_open>.  The "
"return value will be the file descriptor of the database."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:514
msgid "The following two external variables may be useful:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:518
msgid ""
"I<gdbm_errno> is the variable that contains more information about gdbm "
"errors.  (gdbm.h has the definitions of the error values and defines "
"gdbm_errno as an external variable.)"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:520
msgid "I<gdbm_version> is the string containing the version information."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:533
msgid ""
"There are a few more things of interest.  First, B<gdbm> files are not "
"\"sparse\".  You can copy them with the UNIX B<cp(1)> command and they will "
"not expand in the copying process.  Also, there is a compatibility mode for "
"use with programs that already use UNIX B<dbm>.  In this compatibility mode, "
"no gdbm file pointer is required by the programmer, and only one file may be "
"opened at a time.  All users in compatibility mode are assumed to be "
"writers.  If the B<gdbm> file is a read only, it will fail as a writer, but "
"will also try to open it as a reader.  All returned pointers in datum "
"structures point to data that B<gdbm> WILL free.  They should be treated as "
"static pointers (as standard UNIX B<dbm> does)."
msgstr ""

#. type: SH
#: original/man3/gdbm.3:535
#, no-wrap
msgid "LINKING"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:538
msgid ""
"This library is accessed by specifying I<-lgdbm> as the last parameter to "
"the compile line, e.g.:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:540
msgid "  gcc -o prog prog.c -lgdbm"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:543
msgid ""
"If you wish to use the B<dbm> or B<ndbm> compatibility routines, you must "
"link in the I<gdbm_compat> library as well.  For example:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:545
msgid "  gcc -o prog proc.c -lgdbm -lgdbm_compat"
msgstr ""

#. type: SH
#: original/man3/gdbm.3:546
#, no-wrap
msgid "BUGS"
msgstr ""

#. type: SH
#: original/man3/gdbm.3:548
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:550
msgid "dbm, ndbm"
msgstr ""

#. type: SH
#: original/man3/gdbm.3:551
#, no-wrap
msgid "AUTHOR"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:554
msgid ""
"by Philip A. Nelson and Jason Downs.  Copyright (C) 1990 - 1999 Free "
"Software Foundation, Inc."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:559
msgid ""
"GDBM is free software; you can redistribute it and/or modify it under the "
"terms of the GNU General Public License as published by the Free Software "
"Foundation; either version 1, or (at your option)  any later version."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:564
msgid ""
"GDBM is distributed in the hope that it will be useful, but WITHOUT ANY "
"WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS "
"FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more "
"details."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:568
msgid ""
"You should have received a copy of the GNU General Public License along with "
"GDBM; see the file COPYING.  If not, write to the Free Software Foundation, "
"675 Mass Ave, Cambridge, MA 02139, USA."
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:570
msgid "You may contact the original author by:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:572
#, no-wrap
msgid "   e-mail:  phil@cs.wwu.edu\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:574
#, no-wrap
msgid "  us-mail:  Philip A. Nelson\n"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:576
msgid "Computer Science Department"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:578
msgid "Western Washington University"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:580
msgid "Bellingham, WA 98226"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:582
msgid "You may contact the current maintainer by:"
msgstr ""

#. type: Plain text
#: original/man3/gdbm.3:584
#, no-wrap
msgid "   e-mail:  downsj@downsj.com\n"
msgstr ""
