.\" Copyright (c) 1990, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	@(#)mpool.3	8.1 (Berkeley) 6/4/93
.\"
.\" Translated into Spanish on Tue Apr 12 1999 by
.\"	Juan Piernas Cnovas <piernas@ditec.um.es>
.\"
.TH MPOOL 3 "4 Junio 1993"
.UC 7
.SH NOMBRE
mpool \- depsito de buffers de memoria compartida
.SH SINOPSIS
.nf
.ft B
#include <db.h>
#include <mpool.h>

MPOOL *
mpool_open (DBT *key, int fd, pgno_t pagesize, pgno_t maxcache);

void
mpool_filter (MPOOL *mp, void (*pgin)(void *, pgno_t, void *),
.ti +5
void (*pgout)(void *, pgno_t, void *), void *pgcookie);

void *
mpool_new (MPOOL *mp, pgno_t *pgnoaddr);

void *
mpool_get (MPOOL *mp, pgno_t pgno, u_int flags);

int
mpool_put (MPOOL *mp, void *pgaddr, u_int flags);

int
mpool_sync (MPOOL *mp);

int
mpool_close (MPOOL *mp);
.ft R
.fi
.SH DESCRIPCIN
.IR Mpool
es la interfaz de biblioteca destinada a proporcionar un manejo de buffers
de fichero orientado a pginas.
Los buffers pueden ser compartidos entre procesos.
.PP
La funcin
.I mpool_open
inicializa un depsito de memoria.
El argumento
.I key
es la cadena de bytes usada para negociar entre varios procesos que desean
compartir buffers.
Si los buffers de fichero se asocian a memoria compartida, todos los
procesos que usen la misma clave compartirn los buffers.
Si
.I key
es NULL, los buffers se asocian a una memoria privada.
El argumento
.I fd
es un descriptor de fichero para el fichero subyacente, que debe soportar el
posicionamiento del puntero de lectura/escritura (es decir, las bsquedas).
Si
.I key
no es NULL y coincide con un fichero que ya est asociado, el argumento
.I fd
se ignorar.
.PP
El argumento
.I pagesize
es el tamao, en bytes, de las pginas en las que se descompone el fichero.
El argumento
.I maxcache
es el nmero mximo de pginas del fichero subyacente a colocar en cache en
todo momento.
Esta valor no es relativo al nmero de procesos que comparten los buffers de
un fichero, pero ser el mayor valor especificado por cualquiera de los
procesos que compartan el fichero.
.PP
La funcin
.I mpool_filter
est destinada a hacer transparente el procesamiento de la entrada y la
salida de las posibles pginas.
Si se especifica la funcin
.IR pgin ,
se llamar cada vez que se lea un buffer al depsito de memoria procedente del
fichero de respaldo.
Si se especifica la funcin
.IR pgout ,
se llamar cada vez que un buffer se escriba en el fichero de respaldo.
Ambas funciones se llaman con el puntero
.IR pgcookie ,
el nmero de pgina y un puntero a la pgina a leer o escribir.
.PP
La funcin
.I mpool_new
toma un puntero MPOOL y una direccin como argumentos.
Si se puede asignar una nueva pgina, se devolver un puntero a la pgina y
el nmero de pgina se almacenar en la direccin
.IR pgnoaddr .
En caso contrario, se devolver NULL y se asignar un valor a errno.
.PP
La funcin
.I mpool_get
toma un puntero MPOOL y un nmero de pgina como argumentos.
Si la pgina existe, devolver un puntero a la pgina.
En caso contrario, devolver NULL y se asignar un valor a errno.
El parmetro de opcin no se usa actualmente.
.PP
La funcin
.I mpool_put
desprende la pgina referenciada por
.IR pgaddr .
.I Pgaddr
debe ser una direccin devuelta previamente por
.I mpool_get
o
.IR mpool_new .
El valor de opcin se especifica haciendo una operacin
.IR O -lgica
con cualquiera de los siguientes valores:
.TP
MPOOL_DIRTY
La pgina ha sido modificada y necesita ser escrita en el fichero de
respaldo.
.PP
.I Mpool_put
devuelve 0 en caso de xito y -1 si se produce un error.
.PP
La funcin
.I mpool_sync
escribe en el fichero de respaldo todas las pginas modificadas asociadas
con el puntero MPOOL.
.I Mpool_sync
devuelve 0 en caso de xito y -1 si se produce un error.
.PP
La funcin
.I mpool_close
libera cualquier memoria reservada asociada con el depsito de
memoria.
Las pginas modificadas
.B no
se escribirn en el fichero de respaldo.
.I Mpool_close
devuelve 0 en caso de xito y -1 si se produce un error.
.SH ERRORES
La funcin
.I mpool_open
puede fallar y asignar a
.I errno
cualquiera de los errores especificados para la rutina de biblioteca
.IR malloc (3).
.PP
La funcin
.I mpool_get
puede fallar y asignar a
.I errno
uno de los siguiente valores:
.TP 15
[EINVAL]
El registro solicitado no exite.
.PP
Las funciones
.I mpool_new
y
.I mpool_get
pueden fallar y asignar a
.I errno
cualquiera de los errores especificados para las rutinas de biblioteca
.IR read (2) ,
.IR write (2)
y
.IR malloc (3).
.PP
La funcin
.I mpool_sync
puede fallar y asignar a
.I errno
cualquiera de los errores especificados para la rutina de biblioteca
.IR write (2).
.PP
La funcin
.I mpool_close
puede fallar y asignar a
.I errno
cualquiera de los errores especificados para la rutina de biblioteca
.IR free (3).
.SH "VASE TAMBIN"
.IR dbopen (3),
.IR btree (3),
.IR hash (3),
.IR recno (3)