seclib_misc(3C)                                             seclib_misc(3C)

NAME
     seclibmisc - Sonstige Funktionen der Sicherheitsbibliothek

SYNTAX
     cc ... -lseclib

     #include <seclib.h>

     enum seclibreturnval
     seclibgetflag(enum seclibflag flag, void (*value));

     enum seclibreturnval
     seclibsetdefaultfile(char *filename);

     int
     seclibiscspinstalled(void);

     char *
     seclibgeterror(struct logincontext *context);

     enum seclibreturnval
     seclibduplastlog(const struct lastlog *orig,
     struct lastlog **copy);

     enum seclibreturnval
     seclibfreelastlog(struct lastlog *freeme);

     enum seclibreturnval
     seclibreadlastlog(struct logincontext *);

     enum seclibreturnval
     seclibwritelastlog(struct logincontext *);

     int
     seclibrwlastlog(uidt uid, int writeflag, struct lastlog *ll);

     enum seclibreturnval
     seclibduppass(const struct passwd *orig, struct passwd **copy);

     enum seclibreturnval
     seclibdupshad(const struct spwd *orig, struct spwd **copy);

     enum seclibreturnval
     seclibdupgroup(const struct group *orig, struct group **copy);

     enum seclibreturnval
     seclibfreepass(struct passwd *freeme);

     enum seclibreturnval
     seclibfreeshad(struct spwd *freeme);





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

seclib_misc(3C)                                             seclib_misc(3C)

     enum seclibreturnval
     seclibfreegroup(struct group *freeme);

BESCHREIBUNG
     Die Gruppe für sonstige Paßwortfunktionen stellt die folgenden Funk-
     tionen zur Verfügung:

     -  Bequemer Zugriff auf Flag-Werte aus der Datei /etc/default/login

     -  Duplizierung und Freigabe verschiedener Datenstrukturen

     -  Zugriff auf die Datei /var/adm/lastlog

     -  Erstellung von Fehlermeldungen aus den Kontextursachencodes

     -  Feststellung, ob das CSP-Produkt installiert ist

     seclibgetflag
          Liest einen Flag-Wert aus /etc/default/login.

     seclibsetdefaultfile
          Gibt eine alternative Datei für die Funktion seclibgetflag() an.

     seclibiscspinstalled
          Gibt den Wert TRUE (1) zurück, wenn das CSP-Produkt installiert
          ist, und andernfalls den Wert FALSE.

     seclibgeterror
          Gibt eine zugeordnete Zeichenkette mit einer Textmeldung zurück,
          die die Ursachen für den Erfolg bzw. das Fehlschlagen im Anmelde-
          kontext beschreibt.

     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.

     enum seclibflag flag
          Der Wert in /etc/default/login, der abgerufen und zurückgegeben
          werden soll.

     void (*value)
          Ein Zeiger, in den der Wert des Flag (aus /etc/default/login)
          gestellt werden soll. Wenn der Zeiger einen Wert NULL hat, wird
          er ignoriert.

     char *filename
          Eine alternative Datei, die für seclibgetflag() verwendet werden
          soll. Wenn NULL übergeben wird, wird /etc/default/login verwen-
          det.



Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98

seclib_misc(3C)                                             seclib_misc(3C)

     struct lastlog *freeme
     struct passwd *freeme
     struct group *freeme
     struct spwd *freeme
          Zeiger auf die (angegebene) Strukur, die freigegeben werden soll.

     struct lastlog *orig
     struct passwd *orig
     struct group *orig
     struct spwd *orig
          Zeiger auf die (angegebene) Struktur, die kopiert werden soll.

     struct lastlog **copy
     struct passwd **copy
     struct group **copy
     struct spwd **copy
          Zeiger auf die (angegebenen) Strukturzeiger. Die Adresse der
          zugeordneten neuen Strukturkopie wird in den Zeiger gestellt.

     struct lastlog *ll
          Ein Zeiger auf eine Struktur lastlog.

     uidt uid
          Die Benutzer-ID, für die eine Struktur lastlog gelesen oder
          geschrieben werden soll.

     int writeflag
          Ein Flag, das angibt, ob die Struktur lastlog gelesen oder
          geschrieben wird (1==Schreibzugriff, 0==Lesezugriff).

RÜCKGABEWERT
     Die meisten Funktionen geben die folgende Aufzählung seclibreturnval
     zurück:

     SECROK
          Die Funktion beendete die Verarbeitung, ohne daß ein Systemfehler
          auftrat. SECROK wird auch von seclibgetflag zurückgegeben, wenn
          ein boolescher Wert "yes" für ein Flag gelesen wird.

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

     SECRFALSE
          Die Funktion seclibgetflag gibt SECRFALSE zurück, wenn ein boo-
          lescher Wert "no" für das Flag gelesen wird.

     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).



Seite 3                      Reliant UNIX 5.44               Gedruckt 11/98

seclib_misc(3C)                                             seclib_misc(3C)

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

DATEIEN
     /var/adm/lastlog

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












































Seite 4                      Reliant UNIX 5.44               Gedruckt 11/98