ukeyset_ismember, Subroutine

Online bearbeiten

Zweck

Testet, ob ein Schlüssel in einem Benutzerschlüsselsatz vorhanden ist

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <sys/ukeys.h>

int ukeyset_ismember (uset, ukey, flags)
ukeyset_t * uset;
ukey_t ukey;
unsigned int flags;

Beschreibung

Die Subroutine ukeyset_ismember testet, ob der Lese-oder Schreibzugriff, der durch den Parameter Flags für einen mit dem Parameter UKey angegebenen Benutzerschlüssel angegeben wird, in dem Benutzerschlüsselsatz enthalten ist, auf den der Parameter USet verweist.

Parameter

Element Beschreibung
USet Verweist auf den Benutzerschlüsselsatz.
UKey Benutzerschlüssel, dessen Zugehörigkeit zum Schlüsselsatz getestet werden soll
Flags Muss auf einen der folgenden Werte gesetzt werden:
  • UK_READ (UK) -Testet den Lesezugriff.
  • UK_WRITE -Tests auf Schreibzugriff
  • UK_W -Tests auf Lese-und Schreibzugriff

Rückgabewerte

Nach erfolgreicher Beendigung gibt die Subroutine ukeyset_ismember den Wert 1 zurück, wenn der Benutzerschlüssel UKey mit dem angegebenen Zugriff Flags im angegebenen Schlüsselsatz USetvorhanden ist. Andernfalls wird der Wert 0 zurückgegeben. Ist dies nicht der Fall, gibt das Unterprogramm den Wert -1 zurück, und die globale Variable errno wird gesetzt, um den Fehler anzuzeigen.

Fehlercodes

Die Subroutine ukeyset_ismember schlägt fehl, wenn Folgendes zutrifft:

Element Beschreibung
EINVAL Ungültiger Parameter Flags oder ungültiger Parameter UKey oder ungültiger Schlüsselsatzparameter.
ENOSYS Der Prozess ist kein Prozess, der für Benutzerschlüssel aktiviert ist.