Return to authlookup.n CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / xns / man

Initial revision

.TH "AUTH_GETFIRSTAUTH" 3 "29-Dec-86" "Xerox (WRC)"
.\" $Header: /var/lib/cvsd/repos/CSRG/43BSDTahoe/new/xns/man/authlookup.n,v 1.1 2018/04/24 16:12:58 root Exp $
.SH NAME
Auth_GetFirstAuth
\- Locate an Authentication service.
.SH SYNOPSIS
.PP
.nf
.B "#include <sys/types.h>		/* used by ns.h */"
.B "#include <netns/ns.h>		/* for sockaddr_ns */"
.B "#include <xnscourier/courier.h>"
.B "#include <xnscourier/courierconnection.h>"
.PP
.B "CourierConnection *Auth_GetFirstAuth()"
.f
.PP
Link with
.IR "-lcourier" .
.SH DESCRIPTION
The routine
.I Auth_GetFirstAuth
returns an XNS Courier connection to a nearby Authentication service, useful
for Authentication remote procedure calls.
.I Xnsbfs 
is used to perform a broadcast for Authentication servers, the results of
which are then used to open a Courier connection. If no Authentication servers
respond to the broadcast or a connection cannot be established to a service,
NULL is returned.
.SH NOTES
A CourierConnection is an anonymous data structure used by the
runtimes.  Users should not dereference pointers to CourierConnection
themselves.
.SH FILES
/usr/local/lib/libcourier.a		-lcourier library.
.SH SEE ALSO
xnsbfs(1N)
.br
``XNS Courier Under Unix''
.br
Authentication Protocol, \s8XSIS\s0 098404 (April 1984).
.SH AUTHOR
Ed Flint

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.