Home | History | Annotate | Line # | Download | only in net
      1 /*	$NetBSD: if_spppvar.h,v 1.49 2026/06/22 04:03:50 yamaguchi 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 (at) 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 struct sppp;
     32 
     33 struct sppp_work {
     34 	struct work	 work;
     35 	void		*arg;
     36 	void		(*func)(struct sppp *, void *);
     37 	unsigned int	 state;
     38 #define SPPP_WK_FREE	0
     39 #define SPPP_WK_BUSY	1
     40 #define SPPP_WK_UNAVAIL	2
     41 };
     42 
     43 #define IDX_LCP 0		/* idx into state table */
     44 
     45 struct slcp {
     46 	u_long	opts;		/* LCP options to send (bitfield) */
     47 	u_long  magic;          /* local magic number */
     48 	u_long	mru;		/* our max receive unit */
     49 	u_long	their_mru;	/* their max receive unit */
     50 	u_long	protos;		/* bitmask of protos that are started */
     51 	u_char  echoid;         /* id of last keepalive echo request */
     52 	/* restart max values, see RFC 1661 */
     53 	int	timeout;
     54 	int	max_terminate;
     55 	int	max_configure;
     56 	int	max_failure;
     57 	/* multilink variables */
     58 	u_long	mrru;		/* our   max received reconstructed unit */
     59 	u_long	their_mrru;	/* their max receive dreconstructed unit */
     60 	bool	lower_running;	/* Whether the lower layer is running */
     61 };
     62 
     63 #define IDX_IPCP 1		/* idx into state table */
     64 #define IDX_IPV6CP 2		/* idx into state table */
     65 
     66 struct sipcp {
     67 	u_long	opts;		/* IPCP options to send (bitfield) */
     68 	u_int	flags;
     69 #define IPCP_HISADDR_SEEN 1	/* have seen his address already */
     70 #define IPCP_MYADDR_SEEN  2	/* have a local address assigned already */
     71 #define IPCP_MYADDR_DYN   4	/* my address is dynamically assigned */
     72 #define	IPCP_HISADDR_DYN  8	/* his address is dynamically assigned */
     73 #ifdef notdef
     74 #define IPV6CP_MYIFID_DYN   2	/* my ifid is dynamically assigned */
     75 #endif
     76 #define IPV6CP_MYIFID_SEEN  4	/* have seen his ifid already */
     77 	uint32_t saved_hisaddr;/* if hisaddr (IPv4) is dynamic, save original one here, in network byte order */
     78 	uint32_t req_hisaddr;	/* remote address requested */
     79 	uint32_t req_myaddr;	/* local address requested */
     80 
     81 	uint8_t my_ifid[8];	/* IPv6CP my ifid*/
     82 	uint8_t his_ifid[8];	/* IPv6CP his ifid*/
     83 };
     84 
     85 struct sauth {
     86 	u_short	proto;			/* authentication protocol to use */
     87 	u_short	flags;
     88 	char	*name;			/* system identification name */
     89 	char	*secret;		/* secret password */
     90 	u_char	name_len;		/* no need to have a bigger size */
     91 	u_char	secret_len;		/* because proto gives size in a byte */
     92 };
     93 
     94 struct schap {
     95 	char	 challenge[16];		/* random challenge
     96 					   [don't change size! it's really hardcoded!] */
     97 	char	 digest[16];
     98 	u_char	 digest_len;
     99 	bool	 rechallenging;		/* sent challenge after open */
    100 	bool	 response_rcvd;		/* receive response, stop sending challenge */
    101 
    102 	struct sppp_work	 work_challenge_rcvd;
    103 };
    104 
    105 #define IDX_PAP		3
    106 #define IDX_CHAP	4
    107 
    108 #define IDX_COUNT (IDX_CHAP + 1) /* bump this when adding cp's! */
    109 
    110 struct sppp_cp {
    111 	u_long		 seq;		/* local sequence number */
    112 	u_long		 rseq;		/* remote sequence number */
    113 	int		 state;		/* state machine */
    114 	u_char		 confid;	/* local id of last configuration request */
    115 	u_char		 rconfid;	/* remote id of last configuration request */
    116 	int		 rst_counter;	/* restart counter */
    117 	int		 fail_counter;	/* negotiation failure counter */
    118 	struct callout	 ch;		/* per-proto and if callouts */
    119 	u_char		 rcr_type;	/* parsing result of conf-req */
    120 	struct mbuf	*mbuf_confreq;	/* received conf-req */
    121 	struct mbuf	*mbuf_confnak;	/* received conf-nak or conf-rej */
    122 
    123 	struct sppp_work	 work_up;
    124 	struct sppp_work	 work_down;
    125 	struct sppp_work	 work_open;
    126 	struct sppp_work	 work_close;
    127 	struct sppp_work	 work_to;
    128 	struct sppp_work	 work_rcr;
    129 	struct sppp_work	 work_rca;
    130 	struct sppp_work	 work_rcn;
    131 	struct sppp_work	 work_rtr;
    132 	struct sppp_work	 work_rta;
    133 	struct sppp_work	 work_rxj;
    134 };
    135 
    136 struct sppp {
    137 	/* NB: pp_if _must_ be first */
    138 	struct  ifnet pp_if;    /* network interface data */
    139 	struct  ifqueue pp_fastq; /* fast output queue */
    140 	struct	ifqueue pp_cpq;	/* PPP control protocol queue */
    141 	struct  sppp *pp_next;  /* next interface in keepalive list */
    142 	struct  sysctllog *pp_sysctl_log;
    143 
    144 #define PP_DEVF_KEEPALIVE	__BIT(0)	/* use keepalive protocol */
    145 #define PP_DEVF_NOFRAMING	__BIT(1)	/* do not add/expect encapsulation
    146 						   around PPP frames (i.e. the serial
    147 						   HDLC like encapsulation, RFC1662) */
    148 	uint32_t	pp_dev_flags; /* immutable device flags after attach*/
    149 	size_t		pp_framebytes; /* number of bytes added by (hardware) framing */
    150 
    151 	u_int   pp_flags;       /* use Cisco protocol instead of PPP */
    152 	u_int	pp_ncpflags;	/* enable or disable each NCP */
    153 	u_int   pp_alivecnt;    /* keepalive packets counter */
    154 	u_int	pp_alive_interval;	/* keepalive interval */
    155 	u_int   pp_loopcnt;     /* loopback detection counter */
    156 	u_int	pp_maxalive;	/* number or echo req. w/o reply */
    157 	uint64_t	pp_saved_mtu;	/* saved MTU value */
    158 	time_t	pp_last_receive;	/* peer's last "sign of life" */
    159 	time_t	pp_max_noreceive;	/* seconds since last receive before
    160 					   we start to worry and send echo
    161 					   requests */
    162 	time_t	pp_last_activity;	/* second of last payload data s/r */
    163 	time_t	pp_idle_timeout;	/* idle seconds before auto-disconnect,
    164 					 * 0 = disabled */
    165 	int	pp_auth_failures;	/* authorization failures */
    166 	int	pp_max_auth_fail;	/* max. allowed authorization failures */
    167 	int	pp_phase;	/* phase we're currently in */
    168 	krwlock_t	pp_lock;	/* lock for sppp structure */
    169 	int	query_dns;	/* 1 if we want to know the dns addresses */
    170 	uint32_t	dns_addrs[2];
    171 #if defined(__FreeBSD__) && __FreeBSD__ >= 3
    172 	struct callout_handle ch[IDX_COUNT]; /* per-proto and if callouts */
    173 	struct callout_handle pap_my_to_ch; /* PAP needs one more... */
    174 #endif
    175 	struct workqueue *wq_cp;
    176 	struct sppp_work work_ifdown;
    177 	struct sppp_cp scp[IDX_COUNT];
    178 	struct slcp lcp;		/* LCP params */
    179 	struct sipcp ipcp;		/* IPCP params */
    180 	struct sipcp ipv6cp;		/* IPv6CP params */
    181 	struct sauth myauth;		/* auth params, i'm peer */
    182 	struct sauth hisauth;		/* auth params, i'm authenticator */
    183 	struct schap chap;		/* CHAP params */
    184 	/*
    185 	 * These functions are filled in by sppp_attach(), and are
    186 	 * expected to be used by the lower layer (hardware) drivers
    187 	 * in order to communicate the (un)availability of the
    188 	 * communication link.  Lower layer drivers that are always
    189 	 * ready to communicate (like hardware HDLC) can shortcut
    190 	 * pp_up from pp_tls, and pp_down from pp_tlf.
    191 	 */
    192 	void	(*pp_up)(struct sppp *);
    193 	void	(*pp_down)(struct sppp *);
    194 	/*
    195 	 * These functions need to be filled in by the lower layer
    196 	 * (hardware) drivers if they request notification from the
    197 	 * PPP layer whether the link is actually required.  They
    198 	 * correspond to the tls and tlf actions.
    199 	 */
    200 	void	(*pp_tls)(struct sppp *);
    201 	void	(*pp_tlf)(struct sppp *);
    202 };
    203 
    204 #define PP_IFDOWN	0x01	/* if_down() when no ECHO_REPLY received
    205 				   or loopback detected */
    206 				/* 0x02 was PP_CISCO */
    207 				/* 0x04 was PP_TIMO */
    208 #define PP_CALLIN	0x08	/* we are being called */
    209 #define PP_NEEDAUTH	0x10	/* remote requested authentication */
    210 
    211 #define PP_MTU          1500    /* default/minimal MRU */
    212 #define PP_MAX_MRU	2048	/* maximal MRU we want to negotiate */
    213 
    214 #ifdef _KERNEL
    215 void sppp_attach (struct ifnet *);
    216 void sppp_detach (struct ifnet *);
    217 void sppp_input (struct ifnet *, struct mbuf *);
    218 int sppp_ioctl(struct ifnet *, u_long, void *);
    219 struct mbuf *sppp_dequeue (struct ifnet *);
    220 int sppp_isempty (struct ifnet *);
    221 void sppp_flush (struct ifnet *);
    222 #endif
    223 
    224 /*
    225  * Locking notes:
    226  * + spppq is protected by spppq_lock (an adaptive mutex)
    227  *     spppq is a list of all struct sppps, and it is used for
    228  *     sending keepalive packets.
    229  * + struct sppp is protected by sppp->pp_lock (an rwlock)
    230  *     sppp holds configuration parameters for line,
    231  *     authentication and addresses. It also has pointers
    232  *     of functions to notify events to lower layer.
    233  *     When notify events, sppp->pp_lock must be released.
    234  *     Because the event handler implemented in a lower
    235  *     layer often call functions implemented in
    236  *     if_spppsubr.c.
    237  *
    238  * Locking order:
    239  *    - IFNET_LOCK => spppq_lock => struct sppp->pp_lock
    240  *
    241  * NOTICE
    242  * - Lower layers must not acquire sppp->pp_lock
    243  */
    244 #endif /* !_NET_IF_SPPPVAR_H_ */
    245