dslinux/user/perl/ext/ODBM_File Makefile.PL ODBM_File.pm ODBM_File.xs typemap
cayenne
dslinux_cayenne at user.in-berlin.de
Mon Dec 4 17:59:36 CET 2006
Update of /cvsroot/dslinux/dslinux/user/perl/ext/ODBM_File
In directory antilope:/tmp/cvs-serv17422/ext/ODBM_File
Added Files:
Makefile.PL ODBM_File.pm ODBM_File.xs typemap
Log Message:
Adding fresh perl source to HEAD to branch from
--- NEW FILE: ODBM_File.xs ---
#include "EXTERN.h"
#include "perl.h"
#include "XSUB.h"
#ifdef I_DBM
# include <dbm.h>
#else
# ifdef I_RPCSVC_DBM
# include <rpcsvc/dbm.h>
# endif
#endif
#ifndef HAS_DBMINIT_PROTO
int dbminit(char* filename);
int dbmclose(void);
datum fetch(datum key);
int store(datum key, datum dat);
int delete(datum key);
datum firstkey(void);
datum nextkey(datum key);
#endif
#ifdef DBM_BUG_DUPLICATE_FREE
/*
* DBM on at least Ultrix and HPUX call dbmclose() from dbminit(),
* resulting in duplicate free() because dbmclose() does *not*
* check if it has already been called for this DBM.
* If some malloc/free calls have been done between dbmclose() and
* the next dbminit(), the memory might be used for something else when
* it is freed.
* Verified to work on ultrix4.3. Probably will work on HP/UX.
* Set DBM_BUG_DUPLICATE_FREE in the extension hint file.
*/
/* Close the previous dbm, and fail to open a new dbm */
#define dbmclose() ((void) dbminit("/non/exist/ent"))
#endif
#include <fcntl.h>
typedef struct {
void * dbp ;
SV * filter_fetch_key ;
SV * filter_store_key ;
SV * filter_fetch_value ;
SV * filter_store_value ;
int filtering ;
} ODBM_File_type;
typedef ODBM_File_type * ODBM_File ;
typedef datum datum_key ;
typedef datum datum_key_copy ;
typedef datum datum_value ;
#define odbm_FETCH(db,key) fetch(key)
#define odbm_STORE(db,key,value,flags) store(key,value)
#define odbm_DELETE(db,key) delete(key)
#define odbm_FIRSTKEY(db) firstkey()
#define odbm_NEXTKEY(db,key) nextkey(key)
#define MY_CXT_KEY "ODBM_File::_guts" XS_VERSION
typedef struct {
int x_dbmrefcnt;
} my_cxt_t;
START_MY_CXT
#define dbmrefcnt (MY_CXT.x_dbmrefcnt)
#ifndef DBM_REPLACE
#define DBM_REPLACE 0
#endif
MODULE = ODBM_File PACKAGE = ODBM_File PREFIX = odbm_
BOOT:
{
MY_CXT_INIT;
}
ODBM_File
odbm_TIEHASH(dbtype, filename, flags, mode)
char * dbtype
char * filename
int flags
int mode
CODE:
{
char *tmpbuf;
void * dbp ;
dMY_CXT;
if (dbmrefcnt++)
croak("Old dbm can only open one database");
Newx(tmpbuf, strlen(filename) + 5, char);
SAVEFREEPV(tmpbuf);
sprintf(tmpbuf,"%s.dir",filename);
if (stat(tmpbuf, &PL_statbuf) < 0) {
if (flags & O_CREAT) {
if (mode < 0 || close(creat(tmpbuf,mode)) < 0)
croak("ODBM_File: Can't create %s", filename);
sprintf(tmpbuf,"%s.pag",filename);
if (close(creat(tmpbuf,mode)) < 0)
croak("ODBM_File: Can't create %s", filename);
}
else
croak("ODBM_FILE: Can't open %s", filename);
}
dbp = (void*)(dbminit(filename) >= 0 ? &dbmrefcnt : 0);
RETVAL = (ODBM_File)safemalloc(sizeof(ODBM_File_type)) ;
Zero(RETVAL, 1, ODBM_File_type) ;
RETVAL->dbp = dbp ;
ST(0) = sv_mortalcopy(&PL_sv_undef);
sv_setptrobj(ST(0), RETVAL, dbtype);
}
void
DESTROY(db)
ODBM_File db
PREINIT:
dMY_CXT;
CODE:
dbmrefcnt--;
dbmclose();
safefree(db);
datum_value
odbm_FETCH(db, key)
ODBM_File db
datum_key_copy key
int
odbm_STORE(db, key, value, flags = DBM_REPLACE)
ODBM_File db
datum_key key
datum_value value
int flags
CLEANUP:
if (RETVAL) {
if (RETVAL < 0 && errno == EPERM)
croak("No write permission to odbm file");
croak("odbm store returned %d, errno %d, key \"%s\"",
RETVAL,errno,key.dptr);
}
int
odbm_DELETE(db, key)
ODBM_File db
datum_key key
datum_key
odbm_FIRSTKEY(db)
ODBM_File db
datum_key
odbm_NEXTKEY(db, key)
ODBM_File db
datum_key key
#define setFilter(type) \
{ \
if (db->type) \
RETVAL = sv_mortalcopy(db->type) ; \
ST(0) = RETVAL ; \
if (db->type && (code == &PL_sv_undef)) { \
SvREFCNT_dec(db->type) ; \
db->type = Nullsv ; \
} \
else if (code) { \
if (db->type) \
sv_setsv(db->type, code) ; \
else \
db->type = newSVsv(code) ; \
} \
}
SV *
filter_fetch_key(db, code)
ODBM_File db
SV * code
SV * RETVAL = &PL_sv_undef ;
CODE:
DBM_setFilter(db->filter_fetch_key, code) ;
SV *
filter_store_key(db, code)
ODBM_File db
SV * code
SV * RETVAL = &PL_sv_undef ;
CODE:
DBM_setFilter(db->filter_store_key, code) ;
SV *
filter_fetch_value(db, code)
ODBM_File db
SV * code
SV * RETVAL = &PL_sv_undef ;
CODE:
DBM_setFilter(db->filter_fetch_value, code) ;
SV *
filter_store_value(db, code)
ODBM_File db
SV * code
SV * RETVAL = &PL_sv_undef ;
CODE:
DBM_setFilter(db->filter_store_value, code) ;
--- NEW FILE: typemap ---
#
#################################### DBM SECTION
#
datum_key T_DATUM_K
datum_key_copy T_DATUM_K_C
datum_value T_DATUM_V
gdatum T_GDATUM
NDBM_File T_PTROBJ
GDBM_File T_PTROBJ
SDBM_File T_PTROBJ
ODBM_File T_PTROBJ
DB_File T_PTROBJ
DBZ_File T_PTROBJ
FATALFUNC T_OPAQUEPTR
INPUT
T_DATUM_K
DBM_ckFilter($arg, filter_store_key, \"filter_store_key\");
$var.dptr = SvPVbyte($arg, PL_na);
$var.dsize = (int)PL_na;
T_DATUM_K_C
{
SV * tmpSV ;
if (db->filter_store_key){
tmpSV = sv_2mortal(newSVsv($arg));
DBM_ckFilter(tmpSV, filter_store_key, \"filter_store_key\");
}
else
tmpSV = $arg;
$var.dptr = SvPVbyte(tmpSV, PL_na);
$var.dsize = (int)PL_na;
}
T_DATUM_V
DBM_ckFilter($arg, filter_store_value, \"filter_store_value\");
if (SvOK($arg)) {
$var.dptr = SvPVbyte($arg, PL_na);
$var.dsize = (int)PL_na;
}
else {
$var.dptr = \"\";
$var.dsize = 0;
}
T_GDATUM
UNIMPLEMENTED
OUTPUT
T_DATUM_K
sv_setpvn($arg, $var.dptr, $var.dsize);
DBM_ckFilter($arg, filter_fetch_key,\"filter_fetch_key\");
T_DATUM_V
sv_setpvn($arg, $var.dptr, $var.dsize);
DBM_ckFilter($arg, filter_fetch_value,\"filter_fetch_value\");
T_GDATUM
sv_usepvn($arg, $var.dptr, $var.dsize);
--- NEW FILE: ODBM_File.pm ---
package ODBM_File;
use strict;
use warnings;
require Tie::Hash;
use XSLoader ();
our @ISA = qw(Tie::Hash);
our $VERSION = "1.06";
XSLoader::load 'ODBM_File', $VERSION;
1;
__END__
=head1 NAME
ODBM_File - Tied access to odbm files
=head1 SYNOPSIS
use Fcntl; # For O_RDWR, O_CREAT, etc.
use ODBM_File;
# Now read and change the hash
$h{newkey} = newvalue;
print $h{oldkey};
...
untie %h;
=head1 DESCRIPTION
C<ODBM_File> establishes a connection between a Perl hash variable and
a file in ODBM_File format;. You can manipulate the data in the file
just as if it were in a Perl hash, but when your program exits, the
data will remain in the file, to be used the next time your program
runs.
Use C<ODBM_File> with the Perl built-in C<tie> function to establish
the connection between the variable and the file. The arguments to
C<tie> should be:
=over 4
=item 1.
The hash variable you want to tie.
=item 2.
The string C<"ODBM_File">. (Ths tells Perl to use the C<ODBM_File>
package to perform the functions of the hash.)
=item 3.
The name of the file you want to tie to the hash.
=item 4.
Flags. Use one of:
=over 2
=item C<O_RDONLY>
Read-only access to the data in the file.
=item C<O_WRONLY>
Write-only access to the data in the file.
=item C<O_RDWR>
Both read and write access.
=back
If you want to create the file if it does not exist, add C<O_CREAT> to
any of these, as in the example. If you omit C<O_CREAT> and the file
does not already exist, the C<tie> call will fail.
=item 5.
The default permissions to use if a new file is created. The actual
permissions will be modified by the user's umask, so you should
probably use 0666 here. (See L<perlfunc/umask>.)
=back
=head1 DIAGNOSTICS
On failure, the C<tie> call returns an undefined value and probably
sets C<$!> to contain the reason the file could not be tied.
=head2 C<odbm store returned -1, errno 22, key "..." at ...>
This warning is emitted when you try to store a key or a value that
is too long. It means that the change was not recorded in the
database. See BUGS AND WARNINGS below.
=head1 BUGS AND WARNINGS
There are a number of limits on the size of the data that you can
store in the ODBM file. The most important is that the length of a
key, plus the length of its associated value, may not exceed 1008
bytes.
See L<perlfunc/tie>, L<perldbmfilter>, L<Fcntl>
=cut
--- NEW FILE: Makefile.PL ---
use ExtUtils::MakeMaker;
WriteMakefile(
NAME => 'ODBM_File',
LIBS => ["-ldbm -lucb"],
MAN3PODS => {}, # Pods will be built by installman.
XSPROTOARG => '-noprototypes', # XXX remove later?
VERSION_FROM => 'ODBM_File.pm',
);
More information about the dslinux-commit
mailing list