Module Apache mod_slotmem_shm

Sommaire

mod_slotmem_shm est un fournisseur de m�moire qui permet la cr�ation et l'acc�s � un segment de m�moire partag�e dans lequel les ensembles de donn�es sont organis�s en "slots".

L'ensemble de la m�moire partag�e est effac� � chaque red�marrage, que ce dernier soit graceful ou non. Les donn�es sont stock�es et restitu�es dans et � partir d'un fichier d�fini par le param�tre name des appels create et attach. Si son chemin absolu n'est pas sp�cifi�, le chemin du fichier sera relatif au chemin d�fini par la directive DefaultRuntimeDir.

mod_slotmem_shm fournit les fonctions d'API 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 pour 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 taille d'objet est item_size. name est utilis� pour g�n�rer le nom du fichier permettant de stocker/restaurer le contenu de la m�moire partag�e si la configuration le sp�cifie. Les valeurs possibles sont :

"none"

M�moire partag�e anonyme et pas de stockage persistant

"file-name"

[DefaultRuntimeDir]/file-name

Absolute file name

$absolute-file-name

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)

attache � un slot de m�moire existant. Voir create pour la description du param�tre name.

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

obtient 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 ou s'approprie 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'attribution 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