1/*****************************************************************************
2* pppoe.h - PPP Over Ethernet implementation for lwIP.
3*
4* Copyright (c) 2006 by Marc Boucher, Services Informatiques (MBSI) inc.
5*
6* The authors hereby grant permission to use, copy, modify, distribute,
7* and license this software and its documentation for any purpose, provided
8* that existing copyright notices are retained in all copies and that this
9* notice and the following disclaimer are included verbatim in any
10* distributions. No written agreement, license, or royalty fee is required
11* for any of the authorized uses.
12*
13* THIS SOFTWARE IS PROVIDED BY THE CONTRIBUTORS *AS IS* AND ANY EXPRESS OR
14* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
15* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
16* IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
17* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
18* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
19* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
20* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
22* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23*
24******************************************************************************
25* REVISION HISTORY
26*
27* 06-01-01 Marc Boucher <marc@mbsi.ca>
28*   Ported to lwIP.
29*****************************************************************************/
30
31
32
33/* based on NetBSD: if_pppoe.c,v 1.64 2006/01/31 23:50:15 martin Exp */
34
35/*-
36 * Copyright (c) 2002 The NetBSD Foundation, Inc.
37 * All rights reserved.
38 *
39 * This code is derived from software contributed to The NetBSD Foundation
40 * by Martin Husemann <martin@NetBSD.org>.
41 *
42 * Redistribution and use in source and binary forms, with or without
43 * modification, are permitted provided that the following conditions
44 * are met:
45 * 1. Redistributions of source code must retain the above copyright
46 *    notice, this list of conditions and the following disclaimer.
47 * 2. Redistributions in binary form must reproduce the above copyright
48 *    notice, this list of conditions and the following disclaimer in the
49 *    documentation and/or other materials provided with the distribution.
50 * 3. All advertising materials mentioning features or use of this software
51 *    must display the following acknowledgement:
52 *        This product includes software developed by the NetBSD
53 *        Foundation, Inc. and its contributors.
54 * 4. Neither the name of The NetBSD Foundation nor the names of its
55 *    contributors may be used to endorse or promote products derived
56 *    from this software without specific prior written permission.
57 *
58 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
59 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
60 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
61 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
62 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
63 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
64 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
65 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
66 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
67 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
68 * POSSIBILITY OF SUCH DAMAGE.
69 */
70#include "netif/ppp/ppp_opts.h"
71#if PPP_SUPPORT && PPPOE_SUPPORT /* don't build if not configured for use in lwipopts.h */
72
73#ifndef PPP_OE_H
74#define PPP_OE_H
75
76#include "ppp.h"
77#include "lwip/etharp.h"
78
79#ifdef PACK_STRUCT_USE_INCLUDES
80#  include "arch/bpstruct.h"
81#endif
82PACK_STRUCT_BEGIN
83struct pppoehdr {
84  PACK_STRUCT_FLD_8(u8_t vertype);
85  PACK_STRUCT_FLD_8(u8_t code);
86  PACK_STRUCT_FIELD(u16_t session);
87  PACK_STRUCT_FIELD(u16_t plen);
88} PACK_STRUCT_STRUCT;
89PACK_STRUCT_END
90#ifdef PACK_STRUCT_USE_INCLUDES
91#  include "arch/epstruct.h"
92#endif
93
94#ifdef PACK_STRUCT_USE_INCLUDES
95#  include "arch/bpstruct.h"
96#endif
97PACK_STRUCT_BEGIN
98struct pppoetag {
99  PACK_STRUCT_FIELD(u16_t tag);
100  PACK_STRUCT_FIELD(u16_t len);
101} PACK_STRUCT_STRUCT;
102PACK_STRUCT_END
103#ifdef PACK_STRUCT_USE_INCLUDES
104#  include "arch/epstruct.h"
105#endif
106
107
108#define PPPOE_STATE_INITIAL   0
109#define PPPOE_STATE_PADI_SENT 1
110#define PPPOE_STATE_PADR_SENT 2
111#define PPPOE_STATE_SESSION   3
112/* passive */
113#define PPPOE_STATE_PADO_SENT 1
114
115#define PPPOE_HEADERLEN       sizeof(struct pppoehdr)
116#define PPPOE_VERTYPE         0x11    /* VER=1, TYPE = 1 */
117
118#define PPPOE_TAG_EOL         0x0000  /* end of list */
119#define PPPOE_TAG_SNAME       0x0101  /* service name */
120#define PPPOE_TAG_ACNAME      0x0102  /* access concentrator name */
121#define PPPOE_TAG_HUNIQUE     0x0103  /* host unique */
122#define PPPOE_TAG_ACCOOKIE    0x0104  /* AC cookie */
123#define PPPOE_TAG_VENDOR      0x0105  /* vendor specific */
124#define PPPOE_TAG_RELAYSID    0x0110  /* relay session id */
125#define PPPOE_TAG_SNAME_ERR   0x0201  /* service name error */
126#define PPPOE_TAG_ACSYS_ERR   0x0202  /* AC system error */
127#define PPPOE_TAG_GENERIC_ERR 0x0203  /* gerneric error */
128
129#define PPPOE_CODE_PADI       0x09    /* Active Discovery Initiation */
130#define PPPOE_CODE_PADO       0x07    /* Active Discovery Offer */
131#define PPPOE_CODE_PADR       0x19    /* Active Discovery Request */
132#define PPPOE_CODE_PADS       0x65    /* Active Discovery Session confirmation */
133#define PPPOE_CODE_PADT       0xA7    /* Active Discovery Terminate */
134
135#ifndef PPPOE_MAX_AC_COOKIE_LEN
136#define PPPOE_MAX_AC_COOKIE_LEN   64
137#endif
138
139struct pppoe_softc {
140  struct pppoe_softc *next;
141  struct netif *sc_ethif;      /* ethernet interface we are using */
142  ppp_pcb *pcb;                /* PPP PCB */
143
144  struct eth_addr sc_dest;     /* hardware address of concentrator */
145  u16_t sc_session;            /* PPPoE session id */
146  u8_t sc_state;               /* discovery phase or session connected */
147
148#ifdef PPPOE_TODO
149  u8_t *sc_service_name;       /* if != NULL: requested name of service */
150  u8_t *sc_concentrator_name;  /* if != NULL: requested concentrator id */
151#endif /* PPPOE_TODO */
152  u8_t sc_ac_cookie[PPPOE_MAX_AC_COOKIE_LEN]; /* content of AC cookie we must echo back */
153  u8_t sc_ac_cookie_len;       /* length of cookie data */
154#ifdef PPPOE_SERVER
155  u8_t *sc_hunique;            /* content of host unique we must echo back */
156  u8_t sc_hunique_len;         /* length of host unique */
157#endif
158  u8_t sc_padi_retried;        /* number of PADI retries already done */
159  u8_t sc_padr_retried;        /* number of PADR retries already done */
160};
161
162
163#define pppoe_init() /* compatibility define, no initialization needed */
164
165ppp_pcb *pppoe_create(struct netif *pppif,
166       struct netif *ethif,
167       const char *service_name, const char *concentrator_name,
168       ppp_link_status_cb_fn link_status_cb, void *ctx_cb);
169
170/*
171 * Functions called from lwIP
172 * DO NOT CALL FROM lwIP USER APPLICATION.
173 */
174void pppoe_disc_input(struct netif *netif, struct pbuf *p);
175void pppoe_data_input(struct netif *netif, struct pbuf *p);
176
177#endif /* PPP_OE_H */
178
179#endif /* PPP_SUPPORT && PPPOE_SUPPORT */
180