seclib_twindows(3C)                                     seclib_twindows(3C)

NAME
     seclibtwindows - Der Benutzer kann sich nur an Terminals und zu Zei-
     ten anmelden, für die er berechtigt ist

SYNTAX
     cc ... -lseclib

     #include <seclib.h>

     enum seclibreturnval
     seclibtwindows(enum secwinoptions, struct logincontext *);

     char **
     dupprivlist(char **list);

     void
     freeprivlist(char **list);

BESCHREIBUNG
     Die Gruppe für Terminals und Zeiten stellt sicher, daß sich der Benut-
     zer nur an Terminals und nur zu Zeiten anmeldet, für die er berechtigt
     ist.

     seclibtwindows umfaßt folgendes:

     -  SECWCKAUTH (CSP-Funktion)

        Stellt mit den Funktionen getauth() und ptime() fest, ob die aktu-
        elle Zeit und das tty für den Benutzer gültig sind.

     -  SECWADDPRIV (CSP-Funktion)

        Die zusätzlichen Gruppen, die für den Benutzer in der Datei
        /etc/auth angegeben wurden, werden der Gruppenliste in der Kontext-
        struktur hinzugefügt.

     -  SECWKILLTIME (CSP-Funktion)

        Die Zeit, zu der die Sitzung (aus der Datei /etc/twindows) abge-
        brochen wird, wird in die Kontextstruktur gestellt.

     dupprivlist und freeprivlist bewirken folgendes:

     -  Kopieren und Freigeben eines Arrays von Zeichenketten. Sowohl die
        Zeichenketten als auch das Array selbst werden kopiert (freigege-
        ben).









Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

seclib_twindows(3C)                                     seclib_twindows(3C)

ARGUMENTE
     secentryoptions
             Eine Bitmaske, die die Funktion anweist, bestimmte Funktionen
             zu aktivieren. Die vollständige Liste der Werte in der Bit-
             maske befindet sich im Vorspann von seclib.h.

     logincontext
             Ein Wert wie von secliblogincontext() zurückgegeben. Die
             Struktur, auf die dieser Zeiger verweist, enthält alle Sit-
             zungsinformationen, die für die Berechtigungsprüfung eines
             Benutzers über die Sicherheitsbibliothek erforderlich sind.

     list    Ein Array von Zeichenketten.

RÜCKGABEWERT
     seclibtwindows gibt die folgende Aufzählung seclibreturnval zurück:

     SECROK
          Die Funktion beendete die Verarbeitung, ohne daß ein Systemfehler
          auftrat.

          HINWEIS: Die Funktion gibt SECROK zurück, auch wenn sie
          context->reason auf einen Fehlerwert setzt.

     SECRCALLFAILED
          Der Funktionsaufruf schlug fehl. Dieser Fall tritt normalerweise
          ein, weil ein Systemaufruf fehlgeschlagen ist (z. B. wenn
          malloc() fehlschlägt, wenn ein Aufruf brk() mit einem Fehler
          zurückgegeben wird).

     SECRBADOPTION
          Die Funktion wurde mit einem ungültigen Argument aufgerufen.

     Die Funktion dupprivlist() gibt einen Zeiger auf eine neu zugeord-
     nete Kopie ihres Arguments zurück. Sie gibt bei einem Fehlschlag NULL
     zurück.

SIEHE AUCH
     seclib(3C), secliblogincontext(3C), seclibmisc(3C),
     seclibpassentry(3C), seclibpassqual(3C), seclibpasswd(3C),
     seclibruserok(3C), seclibsecterm(3C).













Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98