SHMCTL(2)

NOM
shmctl - Controler la memoire partagee.

SYNOPSIS
#include <sys/ipc.h>

#include <sys/shm.h>

int shmctl(int shmid, int cmd, struct shmid_ds *buf);

DESCRIPTION
shmctl() permet a l'utilisateur d'obtenir des informations concernant un segment de memoire partagee, ainsi que de fixer le proprietaire le groupe et les permissions d'acces a ce segment. Cette fonction permet egalement de detruire un segment. Les informations concernant le segment identifie par shmid sont renvoyees dans une structure shmid_ds :

struct shmid_ds {
  struct          ipc_perm shm_perm; /* Permissions d'acces       */
  int             shm_segsz;         /* Taille segment en octets  */
  time_t          shm_atime;         /* Heure dernier attachement */
  time_t          shm_dtime;         /* Heure dernier detachement */
  time_t          shm_ctime;         /* Heure dernier changement  */
  unsigned short  shm_cpid;          /* PID du createur           */
  unsigned short  shm_lpid;          /* PID du dernier operateur  */
  short           shm_nattch;        /* Nombre d'attachements     */
  /* ------------- Les champs suivants sont prives -------------- */
  unsigned short  shm_npages;        /* Taille segment en pages   */
  unsigned long   *shm_pages;        /* Taille d'une page (?)     */
  struct shm_desc *attaches;         /* Descript. attachements    */
};

Le champ shm_perm a la forme suivante :

struct ipc_perm
{
  key_t  key;
  ushort uid;   /* UID et GID effectifs du proprietaire    */
  ushort gid;
  ushort cuid;  /* UID et GID effectif du createur         */
  ushort cgid;
  ushort mode;  /* Mode d'acces sur 9 bits de poids faible */
  ushort seq;   /* numero de sequence                      */
};

Les commandes cmd suivantes sont disponibles :

IPC_STAT
    permet de recuperer dans le buffer buf les informations concernant le segment de memoire partagee. L'apellant doit avoir la permission d'acces en lecture sur le segment.

IPC_SET
    sert a appliquer les changements que l'utilisateur a apportes dans les champs uid, gid,ou mode de la structure shm_perms. Seuls les 9 bits de poids faibles sont utilises dans mode. Le membre shm_ctime est aussi mis a jour. L'appelant doit etre le createur du segment, son proprietaire, ou le Super-User.

IPC_RMID
    permet de considerer un segment comme detruit. Il sera detruit effectivement apres le dernier detachement (quand le membre shm_nattch de la structure shmid_ds associee vaudra zero.) L'appelant doit etre le createur du segment, son proprietaire, ou le Super-User.

Attention, meme apres le dernier detachement, le contenu du segment n'est pas efface par le systeme. Un processus realisant a nouveau un attachement recuperera son contenu. Il est a la charge du processus l'utilisateur d'ecraser le contenu du segment s'il ne veut pas qu'il persiste.

De plus le Super-User peut autoriser ou interdire le swapping d'un segment avec les commandes suivantes (specifique Linux) :

SHM_LOCK
    empeche le swapping d'un segment de memoire partagee. L'appelant doit consulter chaque page concernee apres avoir effectue le verrouillage pour s'assurer qu'elle soit bien presente en memoire.

SHM_UNLOCK
    reautorise le swapping d'un segment.

Les appels systemes IPC_INFO, IPC_STAT et IPC_RMID sont utilises par le programme ipcs(8) afin d'obtenir des informations sur les ressources allouees.

AUTRES APPELS SYSTEMES

fork()
    Apres un fork() le fils herite des segments de memoire partagee.

exec()
    Apres un exec() tous les segments de memoire partagee sont detaches (pas detruits).

exit()
    Lors d'un exit() tous les segments de memoire partagee sont detaches (pas detruits).

VALEUR RENVOYEE
shmctl renvoie 0 s'il reussit et -1 s'il echoue, auquel cas errno contient le code d'erreur.

ERREURS

EACCES
    on demande IPC_STAT mais shm_perm.modes ne permet pas la lecture du segment shmid.

EFAULT
    cmd a la valeur IPC_SET ou IPC_STAT mais buf pointe en-dehors de l'espace d'adressage accessible.

EINVAL
    shmid n'est pas un identificateur de segment valide, ou cmd n'est pas une commande reconnue.

EIDRM
    shmid pointe sur un segment detruit.

EPERM
    On reclame IPC_SET ou IPC_RMID mais l'appelant n'est ni le proprietaire du segment, ni son createur, ni le Super-User.

CONFORMITE
SVr4, SVID. SVr4 mentionne des conditions d'erreur supplementaires ENOENT, ENOSPC, ENOMEM, EEXIST. Ni SVr4, ni SVID ne documentent la condition d'erreur EIDRM.

VOIR AUSSI
shmget(2), shmop(2)