Sistemi operativi - Syscall shmctl

Shmctl

The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

Name

Shmctl - shared memory control operations

Synopsis

#include <sys/shm.h>
int shmctl(int shmid, int cmd, struct shmid_ds *buf);

Description

La funzione shmctl() fornisce una varietà di operazioni di controllo della memoria condivisa come specificato da cmd. I seguenti valori per cmd sono disponibili:

• IPC_STAT
  Posiziona il valore corrente di ciascun membro della struttura dati associato a shmid_ds shmid nella struttura puntata da buf. I contenuti della struttura sono definiti in <sys/shm.h>.
• IPC_SET
  Imposta il valore dei seguenti membri della struttura dati associati a shmid_ds shmid al valore corrispondente trovato nella struttura puntata da buf: shm_perm.uid, shm_perm.gid, shm_perm.mode (nove bit a basso ordine).
  IPC_SET può essere eseguito solo da un processo che ha un ID utente effettivo uguale a quello di un processo con privilegi adeguati o al valore di shm_perm.cuid nella struttura dati associata a shmid.
• IPC_RMID
  Rimuove l'identificatore di memoria condivisa specificato da shmid dal sistema e distrugge il segmento di memoria condivisa e la struttura dati associata.

IPC_RMID può essere eseguito solo da un processo che ha un ID utente effettivo uguale a quello di un processo con privilegi adeguati o al valore di shm_perm.cuid o shm_perm.uid nella struttura dati associata a shmid.

Return value

Al completamento con successo, shmctl() restituisce 0. Altrimenti, restituisce -1 ed errno verrà impostato per indicare l'errore.

Errors

La funzione shmctl() fallirà se:

• [EACCES] L'argomento cmd è uguale a IPC_STAT e il processo chiamante non ha il permesso di lettura.