목차
dbm.
dbm and
ndbm.
dbm files to gdbm format.
dbm 소개
dbm, ndbm과 호환성
dbm 파일을 gdbm 형식으로 변환하기
This library is free; this means that everyone is free to use it and
free to redistribute it on a free basis. GNU dbm
(gdbm) is not in the public domain; it is copyrighted and there are
restrictions on its distribution, but these restrictions are designed to permit
everything that a good cooperating citizen would want to do. What is not allowed
is to try to prevent others from further sharing any version of
gdbm that they might get from you.
Specifically, we want to make sure that you have the right to give away
copies 이 라이브러리는 자유롭다. 이는 아무나 사용할 수 있고, 이 조건하에서 자유롭게 배포할 수 있다는 뜻이다. GNU
당신에게 gdbm, that you receive source code or else can get it if you
want it, that you can change these functions or use pieces of them in new free
programs, and that you know you can do these things.
dbm (gdbm)는 퍼블릭 도메인(public domain)에 있지 않다. (즉, 이를 상업적인
목적으로 배타적으로 사용할 수 없다.) 이는 저작권으로 보호되고 배포하는데 제한이 있다. 그러나 이 제한은 협동하는 좋은 네티즌이 하려는 모든
것을 허용하기 위해 의도됬다. 허용되지 않는 것은 다른 사람들과 더 이상 gdbm을 공유하지 않으려 하는 것이다.
gdbm을 배포할 권리와 원한다면 소스코드 등을 얻을 권리가 있음을 명확히 한다. 그래서 기능을 수정하거나
새로운 자유 소프트웨어에서 코드의 일부를 사용할 수 있다는 점을 알아야 한다.
To make sure that everyone has such rights, we have to forbid you to deprive
anyone else of these rights. For example, if you distribute copies
gdbm, you must give the recipients all the rights that you have.
You must make sure that they, too, receive or can get the source code. And you
must tell them their rights.
Also, for our own protection, we must make certain that everyone finds out
that there is no warranty for anything in the 모두에게 이런 권리가 있기 때문에 우리는 당신이 그들에게서 이 권리를 빼았는 것을 금지한다. 예를 들어 당신이
또한 우리는 gdbm distribution. If
these functions are modified by someone else and passed on, we want their
recipients to know that what they have is not what we distributed, so that any
problems introduced by others will not reflect on our reputation.
gdbm을 배포한다면 당신이 가진 권리도 줘야한다. 또 그들이 소스코드를 얻을 수 있다는 것도 알려야한다. 그들에게
그들의 권리를 말해줘야 한다.
gdbm 배포를 보장하지 않는다는 점도 확실히 한다. 어떤 사람이 기능을 수정하였다면 우리가 원래
배포한 것이 아님을 알려서, 다른 사람이 만든 문제로 우리 명성에 영향이 없어야 한다.
gdbm is currently distributed under the terms of the GNU General
Public License, Version 2. (NOT under the GNU General Library Public
License.) A copy the GNU General Public License is included with the
distribution of gdbm.
gdbm은 현재 (GNU General Library Public License가 아니라) GNU General
Public License, Version 2로 배포된다. GNU General Public License의 복사본은
gdbm에 포함되있다. (역주; 즉, 상업적 목적의 소프트웨어에서 gdbm을 사용할 수 없다.)
GNU
dbm 소개
GNU dbm (gdbm)is a library of database functions
that use extendible hashing and works similar to the standard UNIX
dbm functions. These routines are provided to a programmer needing
to create and manipulate a hashed database. (gdbm is NOT a
complete database package for an end user.)
The basic use of gdbm is to store key/data pairs in a data file.
Each key must be unique and each key is paired with only one data item. The keys
can not be directly accessed in sorted order. The basic unit of data in
gdbm is the structure:
typedef struct {
char *dptr;
int dsize;
} datum;
GNU dbm(gdbm)은 확장가능한 해쉬를 사용한 데이터베이스 함수 라이브러리로, 표준
유닉스 dbm 함수와 비슷하게 동작한다. 이 함수들로 해쉬된 데이터베이스를 만들고 다룰 수 있다.
(dbm은 일반 사용자를 위한 완전한 데이테베이스가 아니다.)
gdbm은 기본적으로 자료 파일에 키와 자료의 쌍을 저장한다. 각 키는 중복되면 안되고, 오직 하나의 자료를
가진다. 키는 정렬된 순서로 직접 접근할 수 없다. gdbm의 (키와 자료의) 기본 자료구조는 다음과 같다.
typedef struct {
char *dptr;
int dsize;
} datum;
This structure allows for arbitrary sized keys and data items.
The key/data pairs are stored in a 이 구조체는 어떤 크기의 키와 자료도 담을 수 있다.
키와 자료 쌍은 gdbm disk file, called a
gdbm database. An application must open a gdbm
database to be able manipulate the keys and data contained in the database.
gdbm allows an application to have multiple databases open at the
same time. When an application opens a gdbm database, it is
designated as a reader or a writer. A
gdbm database opened by at most one writer at a time. However, many
readers may open the database open simultaneously. Readers and writers can not
open the gdbm database at the same time.
gdbm 데이터베이스라고 부르는 gdbm 자료 파일에 저장된다. 프로그램은
데이터베이스에 저장된 키와 자료를 다루기 위해서 gdbm 데이터베이스를 열어야 한다. gdbm에서
프로그램은 동시에 여러 데이터베이스를 열 수 있다. 프로그램이 gdbm 데이터베이스를 열면,
독자(reader)나 필자(writer)로 행동한다. gdbm
데이터베이스는 동시에 최대 한 필자만이 열 수 있지만, 독자의 경우 여러 독자가 동시에 한 데이터베이스를 열 수 있다. 독자와 필자는 동시에
gdbm 데이터베이스를 열 수 없다.
함수 목록
The following is a quick list of the functions contained in the
gdbm library. The include file gdbm.h, that can be
included by the user, contains a definition of these functions.
#include <gdbm.h> GDBM_FILE gdbm_open(name, block_size, flags, mode, fatal_func); void gdbm_close(dbf); int gdbm_store(dbf, key, content, flag); datum gdbm_fetch(dbf, key); int gdbm_delete(dbf, key); datum gdbm_firstkey(dbf); datum gdbm_nextkey(dbf, key); int gdbm_reorganize(dbf); void gdbm_sync(dbf); int gdbm_exists(dbf, key); char *gdbm_strerror(errno); int gdbm_setopt(dbf, option, value, size); int gdbm_fdesc(dbf);
다음은 gdbm 라이브러리에 포함된 함수들이다. 헤더 파일 gdbm.h에 이 함수들이
선언되있다.
#include <gdbm.h> GDBM_FILE gdbm_open(name, block_size, flags, mode, fatal_func); void gdbm_close(dbf); int gdbm_store(dbf, key, content, flag); datum gdbm_fetch(dbf, key); int gdbm_delete(dbf, key); datum gdbm_firstkey(dbf); datum gdbm_nextkey(dbf, key); int gdbm_reorganize(dbf); void gdbm_sync(dbf); int gdbm_exists(dbf, key); char *gdbm_strerror(errno); int gdbm_setopt(dbf, option, value, size); int gdbm_fdesc(dbf);
The gdbm.h include file is often in the
`/usr/local/include' directory. (The actual location of
gdbm.h depends on your local installation of gdbm.)
헤더 파일 gdbm.h는 보통
`/usr/local/include'에 있다. (gdbm.h의 실제 위치는
gdbm을 구성한 방법에 따라 다르다.)
데이터베이스 열기
Initialize gdbm system. If the file has a size of zero bytes, a
file initialization procedure is performed, setting up the initial structure in
the file.
The procedure for opening a gdbm file is:
GDBM_FILE dbf; dbf = gdbm_open(name, block_size, flags, mode, fatal_func);
gdbm 시스템을 초기화한다. 파일의 크기가 0이라면 파일에 초기 구조를 만드는 파일 초기화 과정이 수행된다.
gdbm 파일을 여는 함수는,
GDBM_FILE dbf; dbf = gdbm_open(name, block_size, flags, mode, fatal_func);
The parameters are: 파라미터는 다음과 같다.
gdbm does not append
any characters to this name). gdbm은 이 이름에 어떤 문자도 추가하지 않는다.)
block_size is used. flags is set to GDBM_READER, the user wants to just read
the database and any call to gdbm_store or
gdbm_delete will fail. Many readers can access the database at
the same time. If flags is set to GDBM_WRITER, the user wants
both read and write access to the database and requires exclusive access. If
flags is set to GDBM_WRCREAT, the user wants both read and write
access to the database and if the database does not exist, create a new one.
If flags is set to GDBM_NEWDB, the user want a new database
created, regardless of whether one existed, and wants read and write access to
the new database. The following may also be logically or'd into the database
flags: GDBM_SYNC, which causes all database operations to be synchronized to
the disk, and GDBM_NOLOCK, which prevents the library from performing any
locking on the database file. The option GDBM_FAST is now obsolete, since
gdbm defaults to no-sync mode. Any error detected will cause a
return value of NULL and an appropriate value will be in
gdbm_errno (see Variables). If no errors occur, a pointer to the
gdbm file descriptor will be returned. flags가 GDBM_READER라면 사용자는 데이터베이스를 읽기만 한다.
gdbm_store나 gdbm_delete 함수는 실패한다. 동시에 많은 독자가 데이테베이스에
접근할 수 있다. flags가 GDBM_WRITER라면 사용자는 데이터베이스를 읽고 쓸 수 있다. 그러면 다른 것들은
데이터베이스에 접근할 수 없게 된다. flags가 GDBM_WRCREAT이면 사용자는 데이터베이스를 읽고 쓸 수
있고, 만약 데이터베이스가 없다면 새로 만든다. flags가 GDBM_NEWDB라면 사용자는 이미 있더라도 새롭게
데이터베이스를 만들고, 데이터베이스를 읽고 쓸 수 있다. 다음은 위의 값들과 논리합(OR)을 할 수 있다. GDBM_SYNC는 모든
데이터베이스 작업을 디스크과 동기화한다. GDBM_NOLOCK은 라이브러리가 데이터베이스 파일을 잠그지 않게 한다. GDBM_FAST는
동기화하지 않는 것이 기본 행동이기 때문에 지금은 사용되지 않는다. 어떤 오류가 발생하면 NULL을 반환하고, 적절한 값이
gdbm_errno에 저장된다. ("두 유용한 변수" 참고) 오류가 없다면 gdbm
파일기술자의 포인터가 반환된다.
gdbm to call if it detects a fatal error. The
only parameter of this function is a string. If the value of NULL is provided,
gdbm will use a default function. The return value, dbf, is the pointer needed by all other
functions to access that gdbm file. If the return is the NULL
pointer, gdbm_open was not successful. The errors can be found in
gdbm_errno for gdbm errors and in errno
for file system errors (for error codes, see gdbm.h).
In all of the following calls, the parameter 반환값 다음 모든 함수에서 파라미터 dbf refers to the
pointer returned from gdbm_open.
dbf는 gdbm 파일을 접근하는 다른 모든 함수들이 필요로하는 포인터이다. NULL
포인터를 반환하면, gdbm_open은 성공하지 못한 것이다. gdbm 오류는
gdbm_errno, 파일시스템 오류는 errno에서 찾을 수 있다. (오류 코드는
gdbm.h를 참고하라.)
dbf는 gdbm_open이 반환한 포인터이다.
데이터베이스 닫기
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:
gdbm_close(dbf);
한번 열었던 파일을 닫는 것은 중요하다. 닫기는 파일에 변경된 독자와 필자 수를 반영하기 위해 필요하다. 닫기는 다음 함수로 한다.
gdbm_close(dbf);
The parameter is: 파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터. Closes the gdbm file and frees all memory associated with the
file dbf.
이 함수는 gdbm 파일을 닫고,
dbf 파일과 연관된 모든 메모리를 반환한다.
데이터베이스에서 레코드 추가/대체
The function gdbm_store inserts or replaces records in the
database.
ret = gdbm_store(dbf, key, content, flag);
함수 gdbm_store는 데이터베이스에서 레코드를 추가하거나 대체한다.
ret = gdbm_store(dbf, key, content, flag);
The parameters are:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터.
key data. gdbm.h) asks that the old data be
replaced by the new content. The value GDBM_INSERT asks that an
error be returned and no action taken if the key already exists.
gdbm.h에
정의된) GDBM_REPLACE를 사용하면 새로운 content로 전의 자료를 대체한다. GDBM_INSERT를
사용하면 이미 key가 있는 경우 오류를 발생하고 아무 일도 하지 않는다. The values returned in ret are:
반환값
ret는,
key or content have a NULL
dptr field. Both key and content must have the dptr
field be a non-NULL value. Since a NULL dptr field is used by other functions
to indicate an error, a NULL field cannot be valid data. key나 content 구조체의
dptr 멤버가 NULL이기 때문에 데이터베이스에 저장할 수 없다. key와 content
구조체의 dptr 멤버는 NULL이 아닌 값을 가져야한다. dptr 값이 NULL인 것은 다른 함수에서 오류를 의미하기 때문에 사용할 수
없다.
flag was
GDBM_INSERT and the key was already in the database. flag가 GDBM_INSERT이고 key가 이미 데이터베이스에 있기
때문에 베이터베이스에 저장할 수 없다.
content is keyed by key. The file on
disk is updated to reflect the structure of the new database before returning
from this function. key를 키로 하여
content가 저장되었다. 이 함수가 반환하기 전에, 디스크의 파일은 새로운 데이터베이스 구조를 반영하기 위해
갱신된다. 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.
The size in 이미 있는 gdbm is not restricted like dbm or
ndbm. Your data can be as large as you want.
key로 자료를 저장하려할 때, GDBM_REPLACE를 사용한 경우 새로운 자료로 기존의 자료를
대체한다. 이 경우 같은 key에 두 자료가 저장되지 않고, 문제없이 실행된다.
gdbm에서 크기는 dbm나 ndbm과 같이 제한되지 않는다. 자료는
원하는 만큼 커질 수 있다.
데이터베이스에서 레코드 찾기
Looks up a given key and returns the information associated with
that key. The pointer in the structure that is returned is a pointer to
dynamically allocated memory block. To search for some data:
content = gdbm_fetch(dbf, key);
주어진 key를 찾고, 그 키와 연결된 자료를 반환한다. 반환되는 구조체의 포인터는 동적으로 할당된 메모리를
가리킨다. 자료를 찾기 위해서 다음 함수를 사용한다.
content = gdbm_fetch(dbf, key);
The parameters are:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터.
key data. The datum returned in content is a pointer to the data found. If
the dptr is NULL, no data was found. If dptr is not NULL, then it points to data
allocated by malloc. gdbm does not automatically free this data.
The user must free this storage when done using it. This eliminates the need to
copy the result to save it for later use (you just save the pointer).
content로 반환된 자료는 찾은 자료의 포인터이다. dptr이 NULL이라면 자료를 찾지 못한 것이다.
dptr이 NULL이 아니라면 malloc으로 할당한 공간의 포인터이다. gdbm는 자동으로 이 공간를 반환하지 않는다.
사용자는 사용한 후 이 공간을 반환해야 한다. 이런 방식은 (dbm이나 ndbm과 달리) 나중에
사용하기 위해 결과를 저장할 필요를 없게한다. (단지 포인터만 저장하면 된다.) (역주; datum 구조체의 포인터가 반환되지 않음을 주의하라.
gdbm_fetch는 단지 dptr을 위한 메모리만을 동적으로 할당한다. 만약 키와 연결된 자료가 크기가 없다면
dsize 멤버는 0이지만, dptr은 NULL이 아니기 위해서 크기가 1로 할당된 메모리를 가리킨다. 반대로
gdbm_store의 경우에도 크기가 0인 자료를 키나 자료로 사용할 수 있다. datum.dsize
= 0; datum.dptr = "";과 같이 하면 된다.)
You may also search for a particular key without retrieving it, using:
ret = gdbm_exists(dbf, key);
또한 다음 함수를 사용하여 자료를 가져오지 않고 특정 키의 유무만을 알아볼 수도 있다.
ret = gdbm_exists(dbf, key);
The parameters are:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터.
key data. Unlike gdbm_fetch, this routine does not allocate any memory,
and simply returns true or false, depending on whether the key
exists, or not. gdbm_fetch와 달리 이 함수는 메모리를 할당하지
않고, 단지 key의 존재 유무만을 알려준다.
데이터베이스에서 레코드 삭제하기
To remove some data from the database:
ret = gdbm_delete(dbf, key);
ret = gdbm_delete(dbf, key);
The parameters are:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터.
key data. The ret value is -1 if the item is not present or the requester is a reader. The ret value is 0 if there was a successful delete.
자료가 없거나 독자가 함수를 부른 경우 -1이 반환된다. 성공적으로 삭제하였다면 0을 반환한다.
gdbm_delete removes the keyed item and the key from
the database dbf. The file on disk is updated to reflect the
structure of the new database before returning from this function.
gdbm_delete는 데이터베이스 dbf에서 key와, 연결된
자료를 삭제한다. 이 함수가 반환하기 전에, 디스크의 파일은 새로운 데이터베이스 구조를 반영하기 위해 갱신된다.
레코드를 순차적으로 접근하기
The next two functions 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.
gdbm_firstkey starts the visit of all keys in the database.
gdbm_nextkey finds and reads the next entry in the hash structure
for dbf.
key = gdbm_firstkey(dbf); nextkey = gdbm_nextkey(dbf, key);
다음 두 함수는 데이터베이스의 모든 키를 접근할 때 사용한다. 이는 key를 순차적으로 접근하지는 않지만,
데이터베이스의 모든 key를 한번씩 접근하는 것을 보장한다. 접근 순서는 헤쉬값과 관련이 있다.
gdbm_firstkey는 데이터베이스의 모든 키의 접근을 시작한다. gdbm_nextkey는
dbf의 해쉬 구조에서 다음 레코드를 찾아서 반환한다.
key = gdbm_firstkey(dbf); nextkey = gdbm_nextkey(dbf, key);
The parameters are:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터.
key
key data. The return values are both datum. If key.dptr or nextkey.dptr is
NULL, there is no first key or next key. Again notice
that dptr points to data allocated by malloc and gdbm will not free
it for you.
These functions were intended to visit the database in read-only algorithms,
for instance, to validate the database or similar operations. 반환된 값은 모두 datum 구조체이다. 이 함수들은 데이터베이스 확인 등의 작업을 위해 읽기전용으로 데이터베이스를 접근함을 가정한다.
key.dptr나 nextkey.dptr이 NULL이라면 첫
key나 다음 key가 없는 것이다. 다시 dptr 포인터는 malloc으로 할당한 공간을
가리키며, gdbm는 이를 알아서 반환하지 않는 점을 주의하라.
File visiting is based on a hash table.
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:
key = gdbm_firstkey ( dbf );
while ( key.dptr ) {
nextkey = gdbm_nextkey ( dbf, key );
if ( some condition ) {
gdbm_delete ( dbf, key );
free ( key.dptr );
}
key = nextkey;
}
방문하는 파일은 해쉬테이블을 기반으로 한다. gdbm_delete는
테이블의 어떤 불일치가 자료를 찾을 수 없게 만들지 않게하기 위해서 해쉬테이블을 재정렬한다. 원래 키 순서가 그대로
유지된다고 보장하지 못한다. 다음과 같은 (데이터베이스를 수정하는) 반복문에서 어떤 키는 접근하지 못할 수도 있다.
key = gdbm_firstkey ( dbf );
while ( key.dptr ) {
nextkey = gdbm_nextkey ( dbf, key );
if ( some condition ) {
gdbm_delete ( dbf, key );
free ( key.dptr );
}
key = nextkey;
}
The following function should be used very seldom.
ret = gdbm_reorganize(dbf);
다음 함수는 매우 드물게 사용해야 한다.
ret = gdbm_reorganize(dbf);
The parameter is:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터. If you have had a lot of deletions and would like to shrink the space used by
the gdbm file, this function will reorganize the database.
gdbm will not shorten the length of a gdbm file
(deleted file space will be reused) except by using this reorganization.
This reorganization requires creating a new file and inserting all the
elements in the old file 매우 많이 삭제한 후 재구성은 새로 파일을 만들고 기존의 dbf into the new file. The new file is
then renamed to the same name as the old file and dbf is updated to
contain all the correct information about the new file. If an error is detected,
the return value is negative. The value zero is returned after a successful
reorganization.
gdbm 파일이 사용하는 공간을 줄이고 싶을 때, 이 함수로 데이터베이스를 재구성한다.
gdbm는 이 재구성 외의 경우에는 gdbm 파일 크기를 줄이지 않는다. (삭제한 후 남은 파일
공간은 재사용된다.)
dbf 파일의 모든 자료를 새 파일에 집어넣는다. 그후 새 파일은 처음 파일과
같은 이름으로 변경되고, dbf는 새 파일에 대한 정보로 갱신된다. 오류가 발생하면 반환값은 음수이다. 성공적으로
재구성을 마쳤다면 0을 반환한다.
데이터베이스 동기화
Unless your database was opened with the GDBM_SYNC flag, gdbm
does not wait for writes to be flushed to the disk before continuing. This
allows faster writing of databases at the risk of having a corrupted database if
the application terminates in an abnormal fashion. The following function allows
the programmer to make sure the disk version of the database has been completely
updated with all changes to the current time.
gdbm_sync(dbf);
데이터베이스를 GDBM_SYNC 플래그로 열지 않았다면, gdbm은 자료가 디스크에 쓰여지는 것을 기다리지 않는다.
그래서 빨리 데이테베이스에 쓸 수 있지만, 프로그램이 비정상적으로 종료하는 경우 데이터베이스를 망가트릴 수 있다. 다음 함수는 현재까지 모든
변화가 디스크에 완전히 기록되었음을 보장한다.
gdbm_sync(dbf);
The parameter is:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터. This would usually be called after a complete set of changes have been made
to the database and before some long waiting time. gdbm_close
automatically calls the equivalent of gdbm_sync so no call is
needed if the database is to be closed immediately after the set of changes have
been made.
이 함수는 보통 데이터베이스에 일련의 변화를 준 후, 오래동안 쉬기 전에 사용한다.
gdbm_close는 자동으로 gdbm_sync와 비슷한 작업을 하기 때문에 변화후 즉시
데이터베이스를 닫는다면 이 함수를 사용할 필요는 없다.
오류 문자열
To convert a gdbm error code into English text, use this
routine:
ret = gdbm_strerror(errno)
gdbm 오류 코드를 영어 문장으로 바꾼다. ret = gdbm_strerror(errno)
The parameter is:
파라미터는 다음과 같다.
gdbm error code, usually gdbm_errno.
gdbm 오류 코드, 보통 gdbm_errno.
The appropiate phrase for reading by humans is returned. 사람이 알아볼 수 있는 문구가 반환된다.
옵션 설정하기
Gdbm supports the ability to set certain options on an already
open database.
ret = gdbm_setopt(dbf, option, value, size);
ret = gdbm_setopt(dbf, option, value, size);
The parameters are:
gdbm_open. gdbm_open이 반환한 포인터.
option will be set. option 값으로 사용할 자료의 포인터.
value. value 포인터가 가리키는 자료의 크기. The valid options are:
가능한 옵션은 다음과 같다.
GDBM_CACHESIZE - Set the size of the internal bucket cache. This option may
only be set once on each GDBM_FILE descriptor, and is set automatically to 100
upon the first access to the database.
GDBM_CACHESIZE - 내부
버킷(bucket) 캐쉬의 크기를 설정한다. 이 옵션은 각 GDBM_FILE 기술자에 한번만 사용할 수 있고, 데이터베이스에 처음 접근할 때
자동으로 100으로 설정된다.
GDBM_FASTMODE - Set fast mode to either on or off. This allows fast mode to
be toggled on an already open and active database. value (see below) should be
set to either TRUE or FALSE. This option is now obsolete.
GDBM_FASTMODE - 빠른 모드를 키고 끈다. 이 옵션은 이미 열려진 데이터베이스의 빠른 모드를 키고 끈다. 값은
TRUE나 FALSE만이 가능하다. (아래 참고) 이 옵션은 현재 사용되지 않는다.
GDBM_SYNCMODE - Turn on or off file system synchronization operations. This
setting defaults to off; value (see below) should be set to either TRUE or
FALSE.
GDBM_SYNCMODE - 파일시스템 동기화를 키고 끈다. 기본값은 꺼져있다. 값은
TRUE나 FALSE만이 가능하다. (아래 참고)
GDBM_CENTFREE - Set central free block pool to either on or off. The default
is off, which is how previous versions of Gdbm handled free blocks.
If set, this option causes all subsequent free blocks to be placed in the
global pool, allowing (in theory) more file space to be reused more
quickly. value (see below) should be set to either TRUE or FALSE. NOTICE:
This feature is still under study.
GDBM_CENTFREE - 중앙
프리블럭 풀(free block pool)을 키고 끈다. 기본값은 꺼져있다. 이는 과거 gdbm이 프리블럭을 다루는
방법이었다. 이 옵션을 키면 이후 모든 프리블럭을 전역 풀에 두어서 (이론적으로) 더 많은 파일공간이 빨리 재사용되게 한다.
값은 TRUE나 FALSE만이 가능하다. (아래 참고) 주의: 이 기능은 현재 연구중이다.
GDBM_COALESCEBLKS - Set free block merging to either on or off. The default
is off, which is how previous versions of Gdbm handled free blocks.
If set, this option causes adjacent free blocks to be merged. This can become a
CPU expensive process with time, though, especially if used in conjunction with
GDBM_CENTFREE. value (see below) should be set to either TRUE or FALSE.
NOTICE: This feature is still under study.
GDBM_COALESCEBLKS - 프리블럭 합치기를 키고 끈다. 기본값은 꺼져있다. 이는 과거
gdbm이 프리블럭을 다루는 방법이었다. 이 옵션을 키면 이웃한 프리블럭들을 합친다. 그러나 이 작업은 (특히
GDBM_CENTFREE와 함께 사용하면) CPU 자원을 많이 차지한다. 값은 TRUE나 FALSE만이 가능하다. (아래 참고)
The return value will be -1 upon failure, or 0 upon success. The global
variable gdbm_errno will be set upon failure.
For instance, to set a database to use a cache of 10, after opening it with
gdbm_open, but prior to accessing it in any way, the following code
could be used:
int value = 10; ret = gdbm_setopt(dbf, GDBM_CACHESIZE, &value, sizeof(int));
실패하면 -1, 성공하면 0이 반환된다. 실패시 전역변수 gdbm_errno가 설정된다.
예를 들어 gdbm_open으로 데이터베이스를 연 후 실제로 접근하기 전에 다음과 같이 데이터베이스의 캐쉬를
10으로 설정할 수 있다.
int value = 10; ret = gdbm_setopt(dbf, GDBM_CACHESIZE, &value, sizeof(int));
(역주; 위에서 TRUE나 FALSE만이 가능하다고 했는데, 이 두 값은 헤더파일에서 정의되었으므로 int value = TRUE;와 같이 사용하면 된다.)
With locking disabled (if gdbm_open was called with
GDBM_NOLOCK), the user may want to perform their own file locking on the
database file in order to prevent multiple writers operating on the same file
simultaneously.
In order to support this, the gdbm_fdesc routine is provided.
ret = gdbm_fdesc(dbf);
(gdbm_open에서 GDBM_NOLOCK을 사용하여) 잠그기를 안한다면 같은 파일에 동시에 여러 필자가 접근하는
것을 막기위해 직접 데이터베이스 파일을 잠글 필요가 있다.
이를 지원하기 위해 gdbm_fdesc 함수가 제공된다.
ret = gdbm_fdesc(dbf);
The single valid parameter is:
파라미터는 다음과 같다.
gdbm_open. gdbm_open이 반환한 포인터. The return value will be the file descriptor of the database.
데이터베이스의 파일기술자가 반환된다.
두 유용한 변수
The following two variables are variables that may need to be used: 다음 두 변수가 필요할 수 있다.
gdbm errors
(gdbm.h has the definitions of the error values). gdbm 오류에 대한 정보를 저장하는 변수. (오류값의 정의는
gdbm.h에 있다.)
dbm, ndbm과 호환성GNU dbm files are not sparse. You can copy them
with the UNIX cp command and they will not expand in the copying
process.
There is a compatibility mode for use with programs that already use UNIX
dbm and UNIX ndbm.
GNU GNU 이미 유닉스 GNU dbm has compatibility functions for dbm. For
dbm compatibility functions, you need the include file
dbm.h.
dbm 파일은 중간이 비어있지(sparse) 않다. 그래서 유닉스
cp 명령으로 복사해도 크기가 커지지 않는다.
dbm이나 ndbm을 사용하는 프로그램을 위한 호환 모드가 있다.
dbm은 dbm과 호환을 위한 함수를 제공한다. dbm 호환
함수는 헤더파일 dbm.h에 선언되있다.
In this compatibility mode, no gdbm file pointer is required by
the user, and Only one file may be opened at a time. All users in compatibility
mode are assumed to be writers. If the 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 gdbm WILL free.
They should be treated as static pointers (as standard UNIX dbm
does). The compatibility function names are the same as the UNIX
dbm function names. Their definitions follow:
int dbminit(name); int store(key, content); datum fetch(key); int delete(key); datum firstkey(); datum nextkey(key); int dbmclose();
호환 모드에서 gdbm 파일포인터는 사용하지 않고, 오직 한 파일만 동시에 열 수 있다. 호환 모드에서는 모든
사용자를 필자로 가정한다. gdbm 파일이 읽기전용이라면 필자이기 때문에 실패할 것이다. 그러나 독자로 파일을 열 수
있다. 반환된 datum 자료구조의 포인터는 gdbm이 알아서 반환한다. 포인터를 (표준 유닉스
dbm처럼) 정적포인터로 취급해야 한다. 호환 함수이름은 유닉스 dbm과 같다. 함수 정의는
다음과 같다.
int dbminit(name); int store(key, content); datum fetch(key); int delete(key); datum firstkey(); datum nextkey(key); int dbmclose();
Standard UNIX dbm and GNU dbm do not have the same
data format in the file. You cannot access a standard UNIX dbm file
with GNU dbm! If you want to use an old database with GNU
dbm, you must use the conv2gdbm program.
Also, GNU 표준 유닉스 GNU dbm has compatibility functions for ndbm.
For ndbm compatibility functions, you need the include file
ndbm.h.
dbm과 GNU dbm은 같은 형식으로 파일에 자료를 저장하지 않는다. GNU
dbm으로 표준 유닉스 dbm 파일을 접근할 수 없다! GNU dbm으로
기존의 데이터베이스를 사용하려면 conv2gdbm 프로그램을 사용하여 변환해야 한다.
dbm은 ndbm과 호환을 위한 함수도 제공한다. ndbm
호환 함수는 헤더파일 ndbm.h에 선언되있다.
Again, just like ndbm, any returned datum can be assumed to be
static storage. You do not have to free that memory, the ndbm
compatibility functions will do it for you.
The functions are:
DBM *dbm_open(name, flags, mode);
void dbm_close(file);
datum dbm_fetch(file, key);
int dbm_store(file, key, content, flags);
int dbm_delete(file, key);
datum dbm_firstkey(file);
datum dbm_nextkey(file);
int dbm_error(file);
int dbm_clearerr(file);
int dbm_dirfno(file);
int dbm_pagfno(file);
int dbm_rdonly(file);
ndbm과 같이 반환된 datum은 정적 메모리에 있다고 가정한다. 그 메모리를 반환하면 안된다.
ndbm 호환 함수가 대신 반환한다.
함수는 다음과 같다.
DBM *dbm_open(name, flags, mode);
void dbm_close(file);
datum dbm_fetch(file, key);
int dbm_store(file, key, content, flags);
int dbm_delete(file, key);
datum dbm_firstkey(file);
datum dbm_nextkey(file);
int dbm_error(file);
int dbm_clearerr(file);
int dbm_dirfno(file);
int dbm_pagfno(file);
int dbm_rdonly(file);
If you want to compile an old C program that used UNIX dbm or
ndbm and want to use gdbm files, execute the following
cc command:
cc ... -L /usr/local/lib -lgdbm
유닉스 dbm이나 ndbm을 사용하는 오래된 C 프로그램을 컴파일 할 때, 다음
cc 명령어를 실행하여 gdbm을 이용한다.
cc ... -L /usr/local/lib -lgdbm
dbm 파일을 gdbm 형식으로 변환하기The program conv2gdbm has been provided to help you convert from
dbm databases to gdbm. The usage is:
conv2gdbm [-q] [-b block_size] dbm_file [gdbm_file]
conv2gdbm은 dbm 데이터베이스를
gdbm 형식으로 변환하기 위해서 제공된다. 사용법은 다음과 같다. conv2gdbm [-q] [-b block_size] dbm_file [gdbm_file]
The options are:
옵션은 다음과 같다.
conv2gdbm to work quietly. conv2gdbm이 진행과정을 화면에 출력을 하지않는다.
gdbm_open. gdbm_open에서와 같다.
dbm file without the .pag or
.dir extensions. .pag나
.dir 확장자를 제외한 dbm 파일명.
gdbm file
name is the same as the dbm file name without any extensions.
That is conv2gdbm dbmfile converts the files
dbmfile.pag and dbmfile.dir into a gdbm
file called dbmfile. gdbm 파일명은 dbm 파일명에서 확장자를 뺀 것과 같다. 즉,
conv2gdbm dbmfile은 파일 dbmfile.pag과
dbmfile.dir을 dbmfile라는 gdbm 파일로 변환한다.
If you have problems with GNU dbm or think you've found a bug,
please report it. Before reporting a bug, make sure you've actually found a real
bug. Carefully reread the documentation and see if it really says you can do
what you're trying to do. If it's not clear whether you should be able to do
something or not, report that too; it's a bug in the documentation!
Before reporting a bug or trying to fix it yourself, try to isolate it to the
smallest possible input file that reproduces the problem. Then send us the input
file and the exact results GNU 버그를 알리거나 직접 고치려하기 전에 문제를 만들 수 있는 가능한 최소의 입력 파일을 만들어봐라. 그후 입력파일과
gdbm gave you. Also say what you
expected to occur; this will help us decide whether the problem was really in
the documentation.
dbm에 문제가 있거나 버그를 발견했다고 생각되면 알려줘라. 버그를 알리기 전에 실제로 버그를 발견했는지
확인하라. 문서를 주의있게 다시읽고 의도한 일을 실제로 할 수 있는지 알아봐라. 할 수 있는지 명확하지 않다면 그것도 알려라. 이는 문서의
버그이다!
gdbm의 결과를 그대로 우리에게 보내라. 또한 무슨 일이 일어나기를 바랬는지도 알려줘라. 그러면 우리가 문서에 문제가
있는지를 아는데 도움이 된다.
Once you've got a precise problem, send e-mail to:
Internet: `bug-gnu-utils@prep.ai.mit.edu'. UUCP: `mit-eddie!prep.ai.mit.edu!bug-gnu-utils'.
문제를 발견하면 아래로 메일을 보내라.
인터넷: `bug-gnu-utils@prep.ai.mit.edu'. UUCP: `mit-eddie!prep.ai.mit.edu!bug-gnu-utils'.
Please include the version number of GNU dbm you are using. You
can get this information by printing the variable gdbm_version (see
Variables).
Non-bug suggestions are always welcome as well. If you have questions about
things that are unclear in the documentation or are just obscure features,
please report them too. 사용하는 GNU 버그 외에 제안도 환영한다. 문서에 불분명한 내용이나 애매한 기능이 있다면 이것도 우리에게 알려주길 바란다.
dbm 버전도 같이 알려줘라. 버전은 변수 gdbm_version을 출력하면
알 수 있다. ("두 유용한 변수" 참고)
You may contact the author by:
e-mail: phil@cs.wwu.edu
us-mail: Philip A. Nelson
Computer Science Department
Western Washington University
Bellingham, WA 98226
아래 주소로 저자와 연락할 수 있다.
e-mail: phil@cs.wwu.edu
us-mail: Philip A. Nelson
Computer Science Department
Western Washington University
Bellingham, WA 98226
You may contact the current maintainer by:
e-mail: downsj@downsj.com
아래 주소로 현재 메인테이너와 연락할 수 있다.
e-mail: downsj@downsj.com
This document was generated on 26 August 2001 using texi2html 1.56k.