|
|
1.1 root 1: .TH "AUTH_GETFIRSTAUTH" 3 "29-Dec-86" "Xerox (WRC)"
2: .\" $Header: authlookup.n,v 1.1 87/01/15 16:48:08 ed Exp $
3: .SH NAME
4: Auth_GetFirstAuth
5: \- Locate an Authentication service.
6: .SH SYNOPSIS
7: .PP
8: .nf
9: .B "#include <sys/types.h> /* used by ns.h */"
10: .B "#include <netns/ns.h> /* for sockaddr_ns */"
11: .B "#include <xnscourier/courier.h>"
12: .B "#include <xnscourier/courierconnection.h>"
13: .PP
14: .B "CourierConnection *Auth_GetFirstAuth()"
15: .f
16: .PP
17: Link with
18: .IR "-lcourier" .
19: .SH DESCRIPTION
20: The routine
21: .I Auth_GetFirstAuth
22: returns an XNS Courier connection to a nearby Authentication service, useful
23: for Authentication remote procedure calls.
24: .I Xnsbfs
25: is used to perform a broadcast for Authentication servers, the results of
26: which are then used to open a Courier connection. If no Authentication servers
27: respond to the broadcast or a connection cannot be established to a service,
28: NULL is returned.
29: .SH NOTES
30: A CourierConnection is an anonymous data structure used by the
31: runtimes. Users should not dereference pointers to CourierConnection
32: themselves.
33: .SH FILES
34: /usr/local/lib/libcourier.a -lcourier library.
35: .SH SEE ALSO
36: xnsbfs(1N)
37: .br
38: ``XNS Courier Under Unix''
39: .br
40: Authentication Protocol, \s8XSIS\s0 098404 (April 1984).
41: .SH AUTHOR
42: Ed Flint
43:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.