Index: phpdoc/fr/functions/sem.xml diff -u phpdoc/fr/functions/sem.xml:1.1 phpdoc/fr/functions/sem.xml:1.2 --- phpdoc/fr/functions/sem.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/sem.xml Tue Nov 14 01:45:32 2000 @@ -1,289 +1,388 @@ - - Sémaphores et gestion de la mémoire partagée - Sémaphore - - - Ce module fourni un système de sémaphore. Ce système utilise les sémaphores System V. - les sémaphores peuvent être utilisés pour fournir un accès exclusif à certaines - ressources de la machine, ou pour limiter le nombre de processus qui utilisent en - même temps une ressource. - - - Ce module fournit aussi un système de mémoire partagée, qui utilise la mémoire - partagée System V. Cette mémoire partagée permet d'accéder à des variables globales. - Les différents démons httpd et mêmes d'autres programmes (tels que Perl, C, ...) - permettent un tel échange de données global. N'oubliez pas que la mémoire partagée - n'est pas protégées contre l'accès simultané. Il vous faudra utiliser les - sémaphores pour assurer la synchronisation. - -

- Limites de la mémoire partagée sous Unix OS - - - - SHMMAX - Taille maximale de mémoire partagée, par défaut, 131072 octets. - - - SHMMIN - Taille minimale de mémoire partagée, par défaut, 1 octet. - - - SHMMNI - Nombre maximal de segment de mémoire partagé, par défaut 100. - - - SHMSEG - Taille maximale de mémoire partagée par processus, par défaut 6. - - - -
- - - - - - sem_get - Retourne un identifiant de sémaphore. - - - Description - - int sem_get - int key - int max_acquire - - int perm - - - - Retourne un identifiant positif de sémaphore en cas de succès, et FALSE en cas - d'erreur. - - - sem_get retourne un identifiant qui pourra être utilisé pour - accéder à un sémaphore System V. Le sémaphore est créé, si nécessaire, en utilisant - les bits de permission (par défaut, 0666). Le nombre de processus qui peuvent - réserver simultanément le sémaphore est précisé dans max_acquire (par défaut à 1). - Actuellement, cette valeur n'est affectée que si le processus est le seul - processus actuellement attaché au sémaphore. - - - Un deuxième appel à sem_get avec la même clé retournera un - identifiant différent, mais les deux identifiants permettront d'accéder au même - sémaphore. - - - Voir aussi : sem_acquire et sem_release. - - - - - - - sem_acquire - Réserve un sémaphore. - - - Description - - int sem_acquire - int sem_identifier - - - Retourne TRUE en cas de succès, et FALSE sinon. - - - sem_acquire se bloque (si nécessaire) jusqu'à ce que le - sémaphore puisse être réservé. Un processus qui tente de réserver un sémaphore - qu'il a déjà reservé restera en attente indéfinie, si cette acquisition excède - le nombre max_acquire de réservation simultanée. - - - A la fin d'un script, tous les sémaphores réservés mais non explicitement libérés - seront libérés automatiquement, et une alerte sera générée. - - - Voir aussi : sem_get et sem_release. - - - - - - - sem_release - Libère un sémaphore. - - - Description - - int sem_release - int sem_identifier - - - Retourne TRUE en cas de succès, FALSE en cas d'erreur. - - - sem_release libère le sémaphore s'il a été réservé par le - processus courant. Sinon, génère une erreur. - - - Après libération du sémaphore, sem_acquire peut être appelé - pour le réserver à nouveau. - - - Voir aussi : sem_get et sem_acquire. - - - - - - - shm_attach - Crée ou ouvre un segment de mémoire partagée. - - - Description - - int shm_attach - int key - int - memsize - int - perm - - - shm_attach retourne un identifiant qui permettra d'accéder - au System V de mémoire partagée. Au premier appel, la mémoire sera créée, avec la - taille mem_size (par défaut: sysvshm.init_mem dans php3.ini, sinon 10000 octets) - et avec les permissions perm(par défaut : 666). - - - Aux appels suivants avec la même clé key, - shm_attach retournera un nouvel identifiant, mais cet - identifiant accédera toujours à la même portion de mémoire partagée. Dans ce cas, - memsize et permseront ignorés. - - - - - - - shm_detach - Relāche un segment de mémoire partagée. - - - Description - - int shm_detach - int - - - shm_detach relāche le segment de mémoire partagée identifié - par shm_identifier et créé par - sem_get. - N'oubliez pas que cette mémoire partagée existe toujours sous Unix, et que les - données sont toujours accessibles. - - - - - - - shm_remove - Supprime un segment de mémoire partagée sous Unix. - - - Description - - int shm_remove - int shm_identifier - - - Supprime un segment de mémoire partagée sous Unix. Toutes les données seront - supprimées. - - - - - - - shm_put_var - Insère ou modifie une variable de la mémoire partagée. - - - Description - - int shm_put_var - int shm_identifier - int variable_key - mixed variable - - - Insère ou modifie la variable variable avec la clé - variable_key. Tous les types de variables (double, int, - string, array) sont supportés. - - - - - - - shm_get_var - Lit une variable dans la mémoire partagée. - - - - Description - - mixed shm_get_var - int id - int variable_key - - - shm_get_var retourne la variable repérée par - variable_key. La variable est toujours présente en mémoire - partagée. - - - - - - - shm_remove_var - Efface une variable de la mémoire partagée. - - - - Description - - int shm_remove_var - int id - int variable_key - - - shm_remove_var efface la variable - variable_key de la mémoire partagée et libère la mémoire. - - - - - - - + + Sémaphores et gestion de la mémoire partagée + Sémaphore + + + Ce module fourni un système de sémaphore. Ce système + utilise les sémaphores System V. Les sémaphores peuvent + être utilisés pour fournir un accès exclusif + à certaines ressources de la machine, ou pour limiter le + nombre de processus qui utilisent en même temps une ressource. + + + Ce module fournit aussi un système de mémoire + partagée, qui utilise la mémoire partagée + System V. Cette mémoire partagée permet + d'accéder à des variables globales. Les + différents démons httpd et mêmes + d'autres programmes (tels que Perl, C, ...) permettent + un tel échange de données global. N'oubliez + pas que la mémoire partagée n'est pas + protégées contre l'accès simultané. + Il vous faudra utiliser les sémaphores pour assurer la synchronisation. + + Limites de la mémoire partagée sous Unix OS + + + + SHMMAX + + Taille maximale de mémoire partagée, + par défaut, 131072 octets. + + + + SHMMIN + + Taille minimale de mémoire partagée, + par défaut, 1 octet. + + + + SHMMNI + + Nombre maximal de segment de mémoire partagé, + par défaut 100. + + + + SHMSEG + + Taille maximale de mémoire partagée par processus, + par défaut 6. + + + + +
+ + + + + + sem_get + Retourne un identifiant de sémaphore. + + + Description + + + int sem_get + int key + int + max_acquire + + int + perm + + + + + Retourne un identifiant positif de sémaphore en cas de + succès, et FALSE en cas d'erreur. + + + sem_get retourne un identifiant qui pourra + être utilisé pour accéder à un + sémaphore System V. Le sémaphore est créé, + si nécessaire, en utilisant les bits de permission (par + défaut, 0666). Le nombre de processus qui peuvent + réserver simultanément le sémaphore + est précisé dans max_acquire (par défaut + à 1). Actuellement, cette valeur n'est affectée + que si le processus est le seul processus actuellement + attaché au sémaphore. + + + Un deuxième appel à sem_get + avec la même clé retournera un identifiant + différent, mais les deux identifiants permettront + d'accéder au même sémaphore. + + + Voir aussi : sem_acquire et + sem_release. + + + + Cette fonction n'est pas disponibles sous Windows. + + + + + + + + sem_acquire + Réserve un sémaphore. + + + Description + + + int sem_acquire + int sem_identifier + + + + Retourne TRUE en cas de succès, et FALSE sinon. + + + sem_acquire se bloque (si nécessaire) + jusqu'à ce que le sémaphore puisse être + réservé. Un processus qui tente de réserver + un sémaphore qu'il a déjà reservé + restera en attente indéfinie, si cette acquisition excède + le nombre max_acquire de réservation simultanée. + + + A la fin d'un script, tous les sémaphores réservés + mais non explicitement libérés seront libérés + automatiquement, et une alerte sera générée. + + + Voir aussi : sem_get et sem_release. + + + + + + + sem_release + Libère un sémaphore. + + + Description + + + int sem_release + int sem_identifier + + + + Retourne TRUE en cas de succès, FALSE en cas d'erreur. + + + sem_release libère le sémaphore + s'il a été réservé par le + processus courant. Sinon, génère une erreur. + + + Après libération du sémaphore, + sem_acquire peut être appelé + pour le réserver à nouveau. + + + Voir aussi : sem_get et sem_acquire. + + + + Cette fonction n'est pas disponibles sous Windows. + + + + + + + + shm_attach + + Crée ou ouvre un segment de mémoire partagée. + + + + Description + + + int shm_attach + int key + int + memsize + + int + perm + + + + + shm_attach retourne un identifiant qui + permettra d'accéder au System V de mémoire + partagée. Au premier appel, la mémoire sera + créée, avec la taille mem_size (par défaut: + sysvshm.init_mem dans php3.ini, sinon 10000 octets) + et avec les permissions perm(par défaut : 666). + + + Aux appels suivants avec la même clé + key, shm_attach + retournera un nouvel identifiant, mais cet identifiant + accédera toujours à la même portion de + mémoire partagée. Dans ce cas, memsize + et permseront ignorés. + + + + Cette fonction n'est pas disponibles sous Windows. + + + + + + + + shm_detach + Relāche un segment de mémoire partagée. + + + Description + + + int shm_detach + int shm_identifier + + + + shm_detach relāche le segment de + mémoire partagée identifié par + shm_identifier et créé par + sem_get. N'oubliez pas que cette mémoire + partagée existe toujours sous Unix, et que les + données sont toujours accessibles. + + + + + + + shm_remove + + Supprime un segment de mémoire partagée sous Unix. + + + + Description + + + int shm_remove + int shm_identifier + + + + Supprime un segment de mémoire partagée sous Unix. + Toutes les données seront supprimées. + + + + Cette fonction n'est pas disponibles sous Windows. + + + + + + + + shm_put_var + + Insère ou modifie une variable de la mémoire partagée. + + + + Description + + + int shm_put_var + int shm_identifier + int variable_key + mixed variable + + + + Insère ou modifie la variable variable avec + la clé variable_key. Tous les types de + variables (double, int, string, array) sont supportés. + + + + Cette fonction n'est pas disponibles sous Windows. + + + + + + + + shm_get_var + + Lit une variable dans la mémoire partagée. + + + + Description + + + mixed shm_get_var + int id + int variable_key + + + + shm_get_var retourne la variable + repérée par variable_key. + La variable est toujours présente en mémoire + partagée. + + + + Cette fonction n'est pas disponibles sous Windows. + + + + + + + + shm_remove_var + + Efface une variable de la mémoire partagée. + + + + Description + + + int shm_remove_var + int id + int variable_key + + + + shm_remove_var efface la variable + variable_key de la mémoire + partagée et libère la mémoire. + + + + Cette fonction n'est pas disponibles sous Windows. + + + + + + + +