seclib_passwd(3C)                                         seclib_passwd(3C)

NAME
     seclibpasswd - Bei Bedarf ein neues Benutzerpaßwort setzen

SYNTAX
     cc ... -lseclib

     #include <seclib.h>

     enum seclibreturnval
     seclibpasswd(enum secpassoptions, struct logincontext *);

BESCHREIBUNG
     Mit Hilfe der Gruppe für das Setzen des Paßworts kann der Benutzer ein
     neues Paßwort eingeben, wenn sein altes abgelaufen ist oder kein Paß-
     wort definiert wurde. Die Funktion seclibpasswd() prüft folgendes:

     -  SECPEXPIRED

        Das Paßwort des Benutzers wird geändert, wenn es zu alt, jedoch
        nicht "viel" zu alt ist. Die Anmeldung wird verweigert, wenn das
        Paßwort des Benutzers "viel" zu alt ist.

     -  SECPPASSREQ

        Das Paßwort des Benutzers wird gesetzt, wenn es NULL ist.

     -  SECPWARNEXPIRE

        Der Benutzer wird gewarnt, wenn sein Paßwort in Kürze abläuft.

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

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

RÜCKGABEWERT
     Die Funktionen geben 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.




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

seclib_passwd(3C)                                         seclib_passwd(3C)

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

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

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









































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98