Module Apache mod_slotmem_plain

Sommaire

mod_slotmem_plain est un fournisseur de m�moire qui permet la cr�ation et l'utilisation d'un segment de m�moire contigu dans lequel les ensembles de donn�es sont organis�s en "slots".

Si la m�moire doit �tre partag�e entre des threads et des processus, il est pr�f�rable d'utiliser le fournisseur mod_slotmem_shm.

mod_slotmem_plain fournit une API comprenant les fonctions suivantes :

apr_status_t doall(ap_slotmem_instance_t *s, ap_slotmem_callback_fn_t *func, void *data, apr_pool_t *pool)

appelle le callback sur tous les slots actifs

apr_status_t create(ap_slotmem_instance_t **new, const char *name, apr_size_t item_size, unsigned int item_num, ap_slotmem_type_t type, apr_pool_t *pool)

cr�e un nouveau slot de m�moire dont chaque objet aura une taille de item_size.

apr_status_t attach(ap_slotmem_instance_t **new, const char *name, apr_size_t *item_size, unsigned int *item_num, apr_pool_t *pool)

rattache � un slot de m�moire existant.

apr_status_t dptr(ap_slotmem_instance_t *s, unsigned int item_id, void**mem)

indique la m�moire associ�e � ce slot actif.

apr_status_t get(ap_slotmem_instance_t *s, unsigned int item_id, unsigned char *dest, apr_size_t dest_len)

lit la m�moire depuis ce slot et la transf�re vers dest

apr_status_t put(ap_slotmem_instance_t *slot, unsigned int item_id, unsigned char *src, apr_size_t src_len)

�crit dans ce slot la m�moire en provenance de src

unsigned int num_slots(ap_slotmem_instance_t *s)

renvoie le nombre total de slots contenus dans ce segment

apr_size_t slot_size(ap_slotmem_instance_t *s)

renvoie la taille totale des donn�es, en octets, contenues dans un slot de ce segment

apr_status_t grab(ap_slotmem_instance_t *s, unsigned int *item_id);

alloue le premier slot disponible et le marque comme utilis� (n'effectue aucune copie de donn�es)

apr_status_t fgrab(ap_slotmem_instance_t *s, unsigned int item_id);

force l'allocation ou l'appropriation du slot sp�cifi� et le marque comme utilis� (n'effectue aucune copie de donn�es)

apr_status_t release(ap_slotmem_instance_t *s, unsigned int item_id);

lib�re un slot et le marque comme non utilis� (n'effectue aucune copie de donn�es)

Directives

Ce module ne fournit aucune directive.

• Commentaires