WYWOŁANIE SYSTEMOWE: semget()

W celu utworzenia nowego zestawu semaforów, lub dostępu do istniejącego, używamy wywołania systemowego semget().

    WYWOŁANIE SYSTEMOWE: semget();                                                          
  
    PROTOTYP: int semget ( key_t key, int nsems, int semflg );                                             
      ZWRACA: indentyfikator IPC zestawu, jeżeli sukces
               -1 - błąd: errno = EACCESS ( brak prawa dostępu )
                                  EEXIST ( zestaw istnieje, nie można utworzyć (IPC_EXCL) )
                                  EIDRM ( zestaw zaznaczony do usunięcia )
                                  ENOENT ( zestaw nie istnieje, nie podano IPC_CREAT )
                                  ENOMEM ( brak pamięci do utworzenia zestawu )
                                  ENOSPC ( limit ilości zestawów przekroczony )
    UWAGI:
  

Pierwszym argumentem dla semget() jest wartość klucza ( w naszym przypadku zwrócona przez ftok()). Wartość ta porównywana jest do istniejących kluczy. Teraz operacje otworzenia lub dostępu zależą od zawartości argumentu semflg:

IPC_CREAT

Utwórz zestaw semaforów jeżeli jeszcze nie istnieje w jądrze.

IPC_EXCL

Użyte z IPC_CREAT zwraca błąd jeżeli zestaw już isnieje.

Jeżeli używamy samego IPC_CREAT semget() zwraca identyfikator zestawu, który został utworzony lub identyfikator już istniejącego, który posiada podaną wartość klucza. Jeżeli podano również IPC_EXCL zostanie utworzony nowy zestaw lub wywołanie zwróci -1. Podanie tylko IPC_EXCL jest bezużyteczne, jednak w połączeniu z IPC_CREAT gwarantuje nam, iż nie używamy istniejącego semaforu.

Tak jak dla każdej innej formy IPC Systemu V możemy podać ósemkowe prawa dostępu, które zostaną z'OR'owane z umaską aby utworzyć prawa dostępu dla zestawu.

Argument nsems określa liczbę semaforów, które zostaną utworzone dla nowego zestawu. Reprezentuje to liczbę drukarek w naszym przykładzie. Maxymalna liczba semaforów jest zdefiniowana w linux/sem.h:

          #define SEMMSL  32      /* <=512 maxymalna liczba semaforów dla id */
  

Zauważ, iż arument nsems jest ignorowany gdy otwieramy już instniejący zestaw.

Stwórzmy szkielet funkcji otwierającej lub tworzącej zestaw semaforów:

  int open_semaphore_set( key_t keyval, int numsems )
  {
          int     sid;
  
          if ( ! numsems )
                  return(-1);
          
          if((sid = semget( mykey, numsems, IPC_CREAT | 0660 )) == -1)
          {
                  return(-1);
          }
          
          return(sid);
  }
  

Zauważ, że używamy praw dostępu 0660. Nasza prosta funkcja zwraca identyfikator zestawu (int) lub -1, jeżeli coś nie poszło. Musimy jej podać wartość klucza, oraz liczbę semaforów, dla których mamy zająć miejsce, pod warunkiem, że tworzymy zestaw. W przykładzie zaprezentowanym pod koniec rozdziału używamy również flagę IPC_EXCL w celu sprawdzenia czy semafor istnieje.