xref: /freebsd/sys/rpc/svc_auth.h (revision a9148abd9da5db2f1c682fb17bed791845fc41c9)
1dfdcada3SDoug Rabson /*	$NetBSD: svc_auth.h,v 1.8 2000/06/02 22:57:57 fvdl Exp $	*/
2dfdcada3SDoug Rabson 
3dfdcada3SDoug Rabson /*
4dfdcada3SDoug Rabson  * Sun RPC is a product of Sun Microsystems, Inc. and is provided for
5dfdcada3SDoug Rabson  * unrestricted use provided that this legend is included on all tape
6dfdcada3SDoug Rabson  * media and as a part of the software program in whole or part.  Users
7dfdcada3SDoug Rabson  * may copy or modify Sun RPC without charge, but are not authorized
8dfdcada3SDoug Rabson  * to license or distribute it to anyone else except as part of a product or
9dfdcada3SDoug Rabson  * program developed by the user.
10dfdcada3SDoug Rabson  *
11dfdcada3SDoug Rabson  * SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
12dfdcada3SDoug Rabson  * WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
13dfdcada3SDoug Rabson  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
14dfdcada3SDoug Rabson  *
15dfdcada3SDoug Rabson  * Sun RPC is provided with no support and without any obligation on the
16dfdcada3SDoug Rabson  * part of Sun Microsystems, Inc. to assist in its use, correction,
17dfdcada3SDoug Rabson  * modification or enhancement.
18dfdcada3SDoug Rabson  *
19dfdcada3SDoug Rabson  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
20dfdcada3SDoug Rabson  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
21dfdcada3SDoug Rabson  * OR ANY PART THEREOF.
22dfdcada3SDoug Rabson  *
23dfdcada3SDoug Rabson  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
24dfdcada3SDoug Rabson  * or profits or other special, indirect and consequential damages, even if
25dfdcada3SDoug Rabson  * Sun has been advised of the possibility of such damages.
26dfdcada3SDoug Rabson  *
27dfdcada3SDoug Rabson  * Sun Microsystems, Inc.
28dfdcada3SDoug Rabson  * 2550 Garcia Avenue
29dfdcada3SDoug Rabson  * Mountain View, California  94043
30dfdcada3SDoug Rabson  *
31dfdcada3SDoug Rabson  *	from: @(#)svc_auth.h 1.6 86/07/16 SMI
32dfdcada3SDoug Rabson  *	@(#)svc_auth.h	2.1 88/07/29 4.0 RPCSRC
33dfdcada3SDoug Rabson  * $FreeBSD$
34dfdcada3SDoug Rabson  */
35dfdcada3SDoug Rabson 
36dfdcada3SDoug Rabson /*
37dfdcada3SDoug Rabson  * svc_auth.h, Service side of rpc authentication.
38dfdcada3SDoug Rabson  *
39dfdcada3SDoug Rabson  * Copyright (C) 1984, Sun Microsystems, Inc.
40dfdcada3SDoug Rabson  */
41dfdcada3SDoug Rabson 
42dfdcada3SDoug Rabson #ifndef _RPC_SVC_AUTH_H
43dfdcada3SDoug Rabson #define _RPC_SVC_AUTH_H
44dfdcada3SDoug Rabson 
45dfdcada3SDoug Rabson /*
46dfdcada3SDoug Rabson  * Server side authenticator
47dfdcada3SDoug Rabson  */
48dfdcada3SDoug Rabson __BEGIN_DECLS
49dfdcada3SDoug Rabson extern enum auth_stat _authenticate(struct svc_req *, struct rpc_msg *);
50a9148abdSDoug Rabson #ifdef _KERNEL
51a9148abdSDoug Rabson extern int svc_auth_reg(int,
52a9148abdSDoug Rabson     enum auth_stat (*)(struct svc_req *, struct rpc_msg *),
53a9148abdSDoug Rabson     int (*)(struct svc_req *, struct ucred **, int *));
54a9148abdSDoug Rabson #else
55a9148abdSDoug Rabson extern int svc_auth_reg(int, enum auth_stat (*)(struct svc_req *,
56a9148abdSDoug Rabson                           struct rpc_msg *));
57a9148abdSDoug Rabson #endif
58dfdcada3SDoug Rabson 
59a9148abdSDoug Rabson 
60a9148abdSDoug Rabson extern int svc_getcred(struct svc_req *, struct ucred **, int *);
61dfdcada3SDoug Rabson /*
62dfdcada3SDoug Rabson  * struct svc_req *req;                 -- RPC request
63a9148abdSDoug Rabson  * struct ucred **crp			-- Kernel cred to modify
64dfdcada3SDoug Rabson  * int *flavorp				-- Return RPC auth flavor
65dfdcada3SDoug Rabson  *
66dfdcada3SDoug Rabson  * Retrieve unix creds corresponding to an RPC request, if
67dfdcada3SDoug Rabson  * possible. The auth flavor (AUTH_NONE or AUTH_UNIX) is returned in
68a9148abdSDoug Rabson  * *flavorp. If the flavor is AUTH_UNIX the caller's ucred pointer
69a9148abdSDoug Rabson  * will be modified to point at a ucred structure which reflects the
70a9148abdSDoug Rabson  * values from the request. The caller should call crfree on this
71a9148abdSDoug Rabson  * pointer.
72a9148abdSDoug Rabson  *
73a9148abdSDoug Rabson  * Return's non-zero if credentials were retrieved from the request,
74a9148abdSDoug Rabson  * otherwise zero.
75dfdcada3SDoug Rabson  */
76dfdcada3SDoug Rabson 
77dfdcada3SDoug Rabson __END_DECLS
78dfdcada3SDoug Rabson 
79dfdcada3SDoug Rabson #endif /* !_RPC_SVC_AUTH_H */
80