mpool(3)                   Library Functions Manual                   mpool(3)

NUME
       mpool - grup de memorie tampon partajata

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #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 *),
                         void (*pgout)(void *, pgno_t, void *),
                         void *pgcookie);

       void *mpool_new(MPOOL *mp, pgno_t *pgnoaddr);
       void *mpool_get(MPOOL *mp, pgno_t pgno, unsigned int flags);
       int mpool_put(MPOOL *mp, void *pgaddr, unsigned int flags);

       int mpool_sync(MPOOL *mp);
       int mpool_close(MPOOL *mp);

DESCRIERE
       Noteaza bine: Aceasta pagina documenteaza interfe<?>ele furnizate pana
       la glibc 2.1. Incepand cu glibc 2.2, glibc nu mai furnizeaza aceste
       interfe<?>e. Probabil ca, in schimb, cauta<?>i API-urile furnizate de
       biblioteca libdbb.

       mpool este interfa<?>a de biblioteca destinata sa asigure gestionarea
       memoriei tampon orientata spre pagina a fi<?>ierelor. Memoriile tampon
       pot fi partajate intre procese.

       Func<?>ia mpool_open() ini<?>ializeaza un grup de memorie. Argumentul
       key este <?>irul de octe<?>i utilizat pentru a negocia intre mai multe
       procese care doresc sa imparta memorii tampon. In cazul in care
       memoriile tampon ale fi<?>ierelor sunt alocate in memoria partajata,
       toate procesele care utilizeaza aceea<?>i cheie vor partaja memoriile
       tampon. Daca key este NULL, tampoanele sunt alocate in memoria privata.
       Argumentul fd este un descriptor de fi<?>ier pentru fi<?>ierul de baza,
       care trebuie sa poata fi cautat. In cazul in care key nu este NULL <?>i
       corespunde unui fi<?>ier care este deja alocat, argumentul fd este
       ignorat.

       Argumentul pagesize este dimensiunea, in octe<?>i, a paginilor in care
       este impar<?>it fi<?>ierul. Argumentul maxcache este numarul maxim de
       pagini din fi<?>ierul de baza care trebuie sa fie stocate in memoria
       cache la un moment dat. Aceasta valoare nu este relativa la numarul de
       procese care impart memoriile tampon ale unui fi<?>ier, ci va fi cea
       mai mare valoare specificata de oricare dintre procesele care
       partajeaza fi<?>ierul.

       Func<?>ia mpool_filter() este menita sa faca posibila prelucrarea
       transparenta a paginilor la intrare <?>i la ie<?>ire. In cazul in care
       este specificata func<?>ia pgin, aceasta este apelata de fiecare data
       cand o memorie tampon este citita in grupul de memorie din fi<?>ierul
       de suport (backing). In cazul in care este specificata func<?>ia pgout,
       aceasta este apelata de fiecare data cand o memorie tampon este scrisa
       in fi<?>ierul de suport. Ambele func<?>ii sunt apelate cu indicatorul
       pgcookie, numarul paginii <?>i un indicator la pagina care urmeaza sa
       fie citita sau scrisa.

       Func<?>ia mpool_new() prime<?>te ca argumente un indicator MPOOL <?>i o
       adresa. Daca se poate aloca o pagina noua, se returneaza un indicator
       la pagina respectiva, iar numarul paginii este stocat in adresa
       pgnoaddr. In caz contrar, se returneaza NULL <?>i se configureaza
       errno.

       Func<?>ia mpool_get() prime<?>te ca argumente un indicator MPOOL <?>i
       un numar de pagina. In cazul in care pagina exista, se returneaza un
       indicator la pagina respectiva. In caz contrar, se returneaza NULL <?>i
       se configureaza errno. Argumentul flags nu este utilizat in prezent.

       Func<?>ia mpool_put() deta<?>eaza pagina la care face referire pgaddr.
       pgaddr trebuie sa fie o adresa returnata anterior de mpool_get() sau
       mpool_new(). Valoarea indicatorului este specificata prin combinarea
       prin OR a oricareia dintre urmatoarele valori:

       MPOOL_DIRTY
              Pagina a fost modificata <?>i trebuie sa fie scrisa in
              fi<?>ierul de rezerva.

       mpool_put() returneaza 0 in caz de succes <?>i -1 daca apare o eroare.

       Func<?>ia mpool_sync() scrie toate paginile modificate asociate cu
       indicatorul MPOOL in fi<?>ierul de suport.  mpool_sync() returneaza 0
       in caz de succes <?>i -1 in caz de eroare.

       Func<?>ia mpool_close() elibereaza orice memorie alocata asociata cu
       modulul cookie al grupului de memorie.  Paginile modificate nu sunt
       scrise in fi<?>ierul de suport.  mpool_close() returneaza 0 in caz de
       succes <?>i -1 daca apare o eroare.

ERORI-IE<?>IRE
       Func<?>ia mpool_open() poate e<?>ua <?>i configura errno pentru oricare
       dintre erorile specificate pentru rutina de biblioteca malloc(3).

       Func<?>ia mpool_get() poate e<?>ua <?>i configura errno pentru
       urmatoarele situa<?>ii:

       EINVAL         Inregistrarea solicitata nu exista.

       Func<?>iile mpool_new() <?>i mpool_get() pot e<?>ua <?>i pot configura
       errno pentru oricare dintre erorile specificate pentru rutinele de
       biblioteca read(2), write(2) <?>i malloc(3).

       Func<?>ia mpool_sync() poate e<?>ua <?>i configura errno pentru oricare
       dintre erorile specificate pentru rutina de biblioteca write(2).

       Func<?>ia mpool_close() poate e<?>ua <?>i configura errno pentru
       oricare dintre erorile specificate pentru rutina de biblioteca free(3).

STANDARDE
       BSD.

CONSULTA<?>I <?>I
       btree(3), dbopen(3), hash(3), recno(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

4.4 Berkeley Distribution         2 mai 2024                          mpool(3)