rpc_clnt_auth(3N)                                         rpc_clnt_auth(3N)

NAME
     rpcclntauth: authdestroy, authnonecreate, authsyscreate,
     authsyscreatedefault - Bibliotheksroutinen für RPC-Identifikation
     von Clients

BESCHREIBUNG
     Diese Routinen sind Teil der RPC-Bibliothek. Sie erlauben C-
     Programmen, Prozeduraufrufe auf anderen Maschinen über ein Netzwerk
     mit der gewünschten Identifikation durchzuführen. Zuerst ruft der
     Client eine Prozedur auf, um ein Datenpaket an den Server zu senden.
     Bei Empfang des Pakets ruft der Server eine Verteilerfunktion auf, um
     den geforderten Dienst durchzuführen, und sendet eine Antwort zurück.

     Diese Routinen werden normalerweise nach der Erzeugung des Client-
     Handle aufgerufen. Die Identifikation des Clients wird mit jedem RPC-
     Aufruf an den Server übergeben.

     Wenn Sie eine der rpc-Funktionen verwenden, müssen Sie bei der Über-
     setzung die Bibliothek libnsl dazubinden (cc -lnsl).

   Routinen

     Die folgenden Routinen erfordern das Einbinden der Include-Datei rpc.h
     (siehe rpc(3N) für die Definition der Datenstruktur AUTH).

     #include <rpc/rpc.h>

     void
     authdestroy(AUTH *auth);

          Dies ist ein Funktionsmakro, der die Identifikation löscht, auf
          die auth verweist. Das Löschen schließt normalerweise auch die
          Speicherfreigabe privater Datenstrukturen mit ein. Die Verwendung
          von auth ist nach einem Aufruf von authdestroy nicht definiert.

     AUTH *
     authnonecreate(void);

          Erzeugt ein RPC-Identifikations-Handle und liefert es zurück. Ein
          so erzeugtes Identifikations-Handle enthält keine Identifikati-
          onsinformation. Diese "Null"-Identifikation wird von RPC als
          Standard verwendet.













Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

rpc_clnt_auth(3N)                                         rpc_clnt_auth(3N)

     AUTH *
     authsyscreate(const char *host, const uidt uid, const gidt gid,
                            const int len, const gidt *aupgids);

          Erzeugt ein RPC-Identifikations-Handle, das AUTHSYS-
          Identifikationsinformationen enthält, und gibt das Handle zurück.
          Der Parameter host ist der Name des Rechners, auf dem die Infor-
          mation erzeugt wurde. uid ist die Benutzerkennung (uid) und gid
          ist die  aktuelle Gruppenkennung des Benutzers. len und aupgids
          beziehen sich auf ein mit Zähler versehenes Array, das weitere
          Gruppen enthält, zu denen der Benutzer gehört.

     AUTH *
     authsyscreatedefault(void);

          Ruft authsyscreate mit den entsprechenden Parametern für den
          aufrufenden Benutzer auf.

SIEHE AUCH
     rpc(3N), rpcclntcreate(3N), rpcclntcalls(3N).


































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98