auth_des.h revision 331722
1/*	@(#)auth_des.h	2.2 88/07/29 4.0 RPCSRC; from 1.3 88/02/08 SMI */
2/*	$FreeBSD: stable/11/include/rpc/auth_des.h 331722 2018-03-29 02:50:57Z eadler $ */
3/*-
4 * Copyright (c) 2009, Sun Microsystems, Inc.
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions are met:
9 * - Redistributions of source code must retain the above copyright notice,
10 *   this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright notice,
12 *   this list of conditions and the following disclaimer in the documentation
13 *   and/or other materials provided with the distribution.
14 * - Neither the name of Sun Microsystems, Inc. nor the names of its
15 *   contributors may be used to endorse or promote products derived
16 *   from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28 * POSSIBILITY OF SUCH DAMAGE.
29 *
30 *	from: @(#)auth_des.h 2.2 88/07/29 4.0 RPCSRC
31 *	from: @(#)auth_des.h 1.14    94/04/25 SMI
32 */
33
34/*
35 * Copyright (c) 1986 - 1991 by Sun Microsystems, Inc.
36 */
37
38/*
39 * auth_des.h, Protocol for DES style authentication for RPC
40 */
41
42#ifndef _AUTH_DES_
43#define _AUTH_DES_
44
45/*
46 * There are two kinds of "names": fullnames and nicknames
47 */
48enum authdes_namekind {
49	ADN_FULLNAME,
50	ADN_NICKNAME
51};
52
53/*
54 * A fullname contains the network name of the client,
55 * a conversation key and the window
56 */
57struct authdes_fullname {
58	char *name;		/* network name of client, up to MAXNETNAMELEN */
59	des_block key;		/* conversation key */
60	u_long window;		/* associated window */
61};
62
63
64/*
65 * A credential
66 */
67struct authdes_cred {
68	enum authdes_namekind adc_namekind;
69	struct authdes_fullname adc_fullname;
70	u_long adc_nickname;
71};
72
73
74
75/*
76 * A des authentication verifier
77 */
78struct authdes_verf {
79	union {
80		struct timeval adv_ctime;	/* clear time */
81		des_block adv_xtime;		/* crypt time */
82	} adv_time_u;
83	u_long adv_int_u;
84};
85
86/*
87 * des authentication verifier: client variety
88 *
89 * adv_timestamp is the current time.
90 * adv_winverf is the credential window + 1.
91 * Both are encrypted using the conversation key.
92 */
93#define adv_timestamp	adv_time_u.adv_ctime
94#define adv_xtimestamp	adv_time_u.adv_xtime
95#define adv_winverf	adv_int_u
96
97/*
98 * des authentication verifier: server variety
99 *
100 * adv_timeverf is the client's timestamp + client's window
101 * adv_nickname is the server's nickname for the client.
102 * adv_timeverf is encrypted using the conversation key.
103 */
104#define adv_timeverf	adv_time_u.adv_ctime
105#define adv_xtimeverf	adv_time_u.adv_xtime
106#define adv_nickname	adv_int_u
107
108/*
109 * Map a des credential into a unix cred.
110 *
111 */
112__BEGIN_DECLS
113extern int authdes_getucred( struct authdes_cred *, uid_t *, gid_t *, int *, gid_t * );
114__END_DECLS
115
116__BEGIN_DECLS
117extern bool_t	xdr_authdes_cred(XDR *, struct authdes_cred *);
118extern bool_t	xdr_authdes_verf(XDR *, struct authdes_verf *);
119extern int	rtime(dev_t, struct netbuf *, int, struct timeval *,
120		    struct timeval *);
121extern void	kgetnetname(char *);
122extern enum auth_stat _svcauth_des(struct svc_req *, struct rpc_msg *);
123__END_DECLS
124
125#endif /* ndef _AUTH_DES_ */
126