xref: /netbsd-src/sys/net/if_spppvar.h (revision a8c74629f602faa0ccf8a463757d7baf858bbf3a)
1 /*	$NetBSD: if_spppvar.h,v 1.24 2020/10/05 16:11:25 roy Exp $	*/
2 
3 #ifndef _NET_IF_SPPPVAR_H_
4 #define _NET_IF_SPPPVAR_H_
5 
6 /*
7  * Defines for synchronous PPP/Cisco link level subroutines.
8  *
9  * Copyright (C) 1994 Cronyx Ltd.
10  * Author: Serge Vakulenko, <vak@cronyx.ru>
11  *
12  * Heavily revamped to conform to RFC 1661.
13  * Copyright (C) 1997, Joerg Wunsch.
14  *
15  * This software is distributed with NO WARRANTIES, not even the implied
16  * warranties for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
17  *
18  * Authors grant any other persons or organizations permission to use
19  * or modify this software as long as this message is kept with the software,
20  * all derivative works or modified versions.
21  *
22  * From: Version 2.0, Fri Oct  6 20:39:21 MSK 1995
23  *
24  * From: if_sppp.h,v 1.8 1997/10/11 11:25:20 joerg Exp
25  *
26  * From: Id: if_sppp.h,v 1.7 1998/12/01 20:20:19 hm Exp
27  */
28 
29 #include <sys/workqueue.h>
30 #include <sys/pcq.h>
31 
32 #define IDX_LCP 0		/* idx into state table */
33 
34 struct slcp {
35 	u_long	opts;		/* LCP options to send (bitfield) */
36 	u_long  magic;          /* local magic number */
37 	u_long	mru;		/* our max receive unit */
38 	u_long	their_mru;	/* their max receive unit */
39 	u_long	protos;		/* bitmask of protos that are started */
40 	u_char  echoid;         /* id of last keepalive echo request */
41 	/* restart max values, see RFC 1661 */
42 	int	timeout;
43 	int	max_terminate;
44 	int	max_configure;
45 	int	max_failure;
46 	/* multilink variables */
47 	u_long	mrru;		/* our   max received reconstructed unit */
48 	u_long	their_mrru;	/* their max receive dreconstructed unit */
49 };
50 
51 #define IDX_IPCP 1		/* idx into state table */
52 #define IDX_IPV6CP 2		/* idx into state table */
53 
54 struct sipcp {
55 	u_long	opts;		/* IPCP options to send (bitfield) */
56 	u_int	flags;
57 #define IPCP_HISADDR_SEEN 1	/* have seen his address already */
58 #define IPCP_MYADDR_SEEN  2	/* have a local address assigned already */
59 #define IPCP_MYADDR_DYN   4	/* my address is dynamically assigned */
60 #define	IPCP_HISADDR_DYN  8	/* his address is dynamically assigned */
61 #ifdef notdef
62 #define IPV6CP_MYIFID_DYN   2	/* my ifid is dynamically assigned */
63 #endif
64 #define IPV6CP_MYIFID_SEEN  4	/* have seen his ifid already */
65 	uint32_t saved_hisaddr;/* if hisaddr (IPv4) is dynamic, save original one here, in network byte order */
66 	uint32_t req_hisaddr;	/* remote address requested */
67 	uint32_t req_myaddr;	/* local address requested */
68 
69 	struct workqueue *update_addrs_wq;
70 	struct work update_addrs_wk;
71 	u_int update_addrs_enqueued;
72 	pcq_t *update_addrs_q;
73 };
74 
75 struct sauth {
76 	u_short	proto;			/* authentication protocol to use */
77 	u_short	flags;
78 	char	*name;			/* system identification name */
79 	char	*secret;		/* secret password */
80 	u_char	name_len;		/* no need to have a bigger size */
81 	u_char	secret_len;		/* because proto gives size in a byte */
82 	char	challenge[16];		/* random challenge [don't change size! it's really hardcoded!] */
83 };
84 
85 #define IDX_PAP		3
86 #define IDX_CHAP	4
87 
88 #define IDX_COUNT (IDX_CHAP + 1) /* bump this when adding cp's! */
89 
90 struct sppp {
91 	/* NB: pp_if _must_ be first */
92 	struct  ifnet pp_if;    /* network interface data */
93 	struct  ifqueue pp_fastq; /* fast output queue */
94 	struct	ifqueue pp_cpq;	/* PPP control protocol queue */
95 	struct  sppp *pp_next;  /* next interface in keepalive list */
96 	u_int   pp_flags;       /* use Cisco protocol instead of PPP */
97 	u_int	pp_framebytes;	/* number of bytes added by (hardware) framing */
98 	u_int   pp_alivecnt;    /* keepalive packets counter */
99 	u_int   pp_loopcnt;     /* loopback detection counter */
100 	u_int	pp_maxalive;	/* number or echo req. w/o reply */
101 	u_long  pp_seq[IDX_COUNT];	/* local sequence number */
102 	u_long  pp_rseq[IDX_COUNT];	/* remote sequence number */
103 	uint64_t	pp_saved_mtu;	/* saved MTU value */
104 	time_t	pp_last_receive;	/* peer's last "sign of life" */
105 	time_t	pp_max_noreceive;	/* seconds since last receive before
106 					   we start to worry and send echo
107 					   requests */
108 	time_t	pp_last_activity;	/* second of last payload data s/r */
109 	time_t	pp_idle_timeout;	/* idle seconds before auto-disconnect,
110 					 * 0 = disabled */
111 	int	pp_auth_failures;	/* authorization failures */
112 	int	pp_max_auth_fail;	/* max. allowed authorization failures */
113 	int	pp_phase;	/* phase we're currently in */
114 	krwlock_t	pp_lock;	/* lock for sppp structure */
115 	int	query_dns;	/* 1 if we want to know the dns addresses */
116 	uint32_t	dns_addrs[2];
117 	int	state[IDX_COUNT];	/* state machine */
118 	u_char  confid[IDX_COUNT];	/* id of last configuration request */
119 	int	rst_counter[IDX_COUNT];	/* restart counter */
120 	int	fail_counter[IDX_COUNT]; /* negotiation failure counter */
121 #if defined(__NetBSD__)
122 	struct	callout ch[IDX_COUNT];	/* per-proto and if callouts */
123 	struct	callout pap_my_to_ch;	/* PAP needs one more... */
124 #endif
125 #if defined(__FreeBSD__) && __FreeBSD__ >= 3
126 	struct callout_handle ch[IDX_COUNT]; /* per-proto and if callouts */
127 	struct callout_handle pap_my_to_ch; /* PAP needs one more... */
128 #endif
129 	struct slcp lcp;		/* LCP params */
130 	struct sipcp ipcp;		/* IPCP params */
131 	struct sipcp ipv6cp;		/* IPv6CP params */
132 	struct sauth myauth;		/* auth params, i'm peer */
133 	struct sauth hisauth;		/* auth params, i'm authenticator */
134 	/*
135 	 * These functions are filled in by sppp_attach(), and are
136 	 * expected to be used by the lower layer (hardware) drivers
137 	 * in order to communicate the (un)availability of the
138 	 * communication link.  Lower layer drivers that are always
139 	 * ready to communicate (like hardware HDLC) can shortcut
140 	 * pp_up from pp_tls, and pp_down from pp_tlf.
141 	 */
142 	void	(*pp_up)(struct sppp *);
143 	void	(*pp_down)(struct sppp *);
144 	/*
145 	 * These functions need to be filled in by the lower layer
146 	 * (hardware) drivers if they request notification from the
147 	 * PPP layer whether the link is actually required.  They
148 	 * correspond to the tls and tlf actions.
149 	 */
150 	void	(*pp_tls)(struct sppp *);
151 	void	(*pp_tlf)(struct sppp *);
152 	/*
153 	 * These (optional) functions may be filled by the hardware
154 	 * driver if any notification of established connections
155 	 * (currently: IPCP up) is desired (pp_con) or any internal
156 	 * state change of the interface state machine should be
157 	 * signaled for monitoring purposes (pp_chg).
158 	 */
159 	void	(*pp_con)(struct sppp *);
160 	void	(*pp_chg)(struct sppp *, int);
161 };
162 
163 #define PP_KEEPALIVE    0x01    /* use keepalive protocol */
164 #define PP_CISCO        0x02    /* use Cisco protocol instead of PPP */
165 				/* 0x04 was PP_TIMO */
166 #define PP_CALLIN	0x08	/* we are being called */
167 #define PP_NEEDAUTH	0x10	/* remote requested authentication */
168 #define	PP_NOFRAMING	0x20	/* do not add/expect encapsulation
169 				   around PPP frames (i.e. the serial
170 				   HDLC like encapsulation, RFC1662) */
171 
172 
173 #define PP_MTU          1500    /* default/minimal MRU */
174 #define PP_MAX_MRU	2048	/* maximal MRU we want to negotiate */
175 
176 #ifdef _KERNEL
177 void sppp_attach (struct ifnet *);
178 void sppp_detach (struct ifnet *);
179 void sppp_input (struct ifnet *, struct mbuf *);
180 int sppp_ioctl(struct ifnet *, u_long, void *);
181 struct mbuf *sppp_dequeue (struct ifnet *);
182 int sppp_isempty (struct ifnet *);
183 void sppp_flush (struct ifnet *);
184 #endif
185 
186 /*
187  * Locking notes:
188  * + spppq is protected by spppq_lock (an adaptive mutex)
189  *     spppq is a list of all struct sppps, and it is used for
190  *     sending keepalive packets.
191  * + struct sppp is protected by sppp->pp_lock (an rwlock)
192  *     sppp holds configuration parameters for line,
193  *     authentication and addresses. It also has pointers
194  *     of functions to notify events to lower layer.
195  *     When notify events, sppp->pp_lock must be released.
196  *     Because the event handler implemented in a lower
197  *     layer often call functions implemented in
198  *     if_spppsubr.c.
199  *
200  * Locking order:
201  *    - spppq_lock => struct sppp->pp_lock
202  *
203  * NOTICE
204  * - Lower layers must not acquire sppp->pp_lock
205  */
206 #endif /* !_NET_IF_SPPPVAR_H_ */
207