Subversion Repositories HelenOS

Rev

Rev 4075 | Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
3992 mejdrech 1 
/*
2 
 * Copyright (c) 2009 Lukas Mejdrech
3 
 * All rights reserved.
4 
 *
5 
 * Redistribution and use in source and binary forms, with or without
6 
 * modification, are permitted provided that the following conditions
7 
 * are met:
8 
 *
9 
 * - Redistributions of source code must retain the above copyright
10 
 *   notice, this list of conditions and the following disclaimer.
11 
 * - Redistributions in binary form must reproduce the above copyright
12 
 *   notice, this list of conditions and the following disclaimer in the
13 
 *   documentation and/or other materials provided with the distribution.
14 
 * - The name of the author may not be used to endorse or promote products
15 
 *   derived from this software without specific prior written permission.
16 
 *
17 
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 
 */
28 
 
29 
/** @addtogroup eth
30 
 *  @{
31 
 */
32 
 
33 
/** @file
34 
 *  Ethernet protocol header definitions.
35 
 *  Names according to the linux src/include/linux/ip.h header file.
36 
 */
37 
 
38 
#ifndef __NET_ETH_HEADER_H__
39 
#define __NET_ETH_HEADER_H__
40 
 
41 
#include <sys/types.h>
42 
 
43 
#define ETH_ADDR        6
44 
 
45 
#define ETH_PREAMBLE    0x55
46 
 
47 
#define ETH_SFD         0xF5
48 
 
49 
#define ETH_LSAP_SNAP   0xAA
50 
 
51 
#define ETH_RAW         0xFF
52 
 
53 
/** Type definition of the Ethernet header with all the extensions.
54 
 *  @see eth_header_ex
55 
 */
56 
typedef struct eth_header_ex    eth_header_ex_t;
57 
 
58 
/** Type definition of the Ethernet header with all the extensions pointer.
59 
 *  @see eth_header
60 
 */
61 
typedef eth_header_ex_t *       eth_header_ex_ref;
62 
 
63 
/** Type definition of the Ethernet header LSAP extension.
64 
 *  @see eth_header_lsap
65 
 */
66 
typedef struct eth_header_lsap  eth_header_lsap_t;
67 
 
68 
/** Type definition of the Ethernet header LSAP extension pointer.
69 
 *  @see eth_header_lsap
70 
 */
71 
typedef eth_header_lsap_t *     eth_header_lsap_ref;
72 
 
73 
/** Type definition of the Ethernet header SNAP extension.
74 
 *  @see eth_header_snap
75 
 */
76 
typedef struct eth_header_snap  eth_header_snap_t;
77 
 
78 
/** Type definition of the Ethernet header SNAP extension pointer.
79 
 *  @see eth_header_snap
80 
 */
81 
typedef eth_header_snap_t *     eth_header_snap_ref;
82 
 
83 
/** Type definition of the Ethernet header.
84 
 *  @see eth_header
85 
 */
86 
typedef struct eth_header   eth_header_t;
87 
 
88 
/** Type definition of the Ethernet header pointer.
89 
 *  @see eth_header
90 
 */
91 
typedef eth_header_t *      eth_header_ref;
92 
 
93 
/** Ethernet header Link Service Access Point extension.
94 
 */
95 
struct eth_header_lsap{
96 
    /** Destination Service Access Point identifier.
97 
     *  The possible values are assigned by an IEEE committee.
98 
     */
99 
    uint8_t     dsap;
100 
    /** Source Service Access Point identifier.
101 
     *  The possible values are assigned by an IEEE committee.
102 
     */
103 
    uint8_t     ssap;
104 
    /** Control parameter.
105 
     *  The possible values are assigned by an IEEE committee.
106 
     */
107 
    uint8_t     ctrl;
108 
};
109 
 
110 
/** Ethernet header SNAP extension.
111 
 */
112 
struct eth_header_snap{
113 
    /** Protocol identifier or organization code.
114 
     */
115 
    uint8_t     proto[ 3 ];
116 
    /** Ethernet protocol identifier in the network byte order (big endian).
117 
     *  @see ethernet_protocols.h
118 
     */
119 
    uint16_t    ethertype;
120 
};
121 
 
122 
/** Ethernet header.
123 
 */
124 
struct eth_header{
125 
    /** Controlling preamble used for the frame transmission synchronization.
126 
     *  All should be set to ETH_PREAMBLE.
127 
     */
128 
    uint8_t     preamble[ 7 ];
129 
    /** Start of Frame Delimiter used for the frame transmission synchronization.
130 
     *  Should be set to ETH_SFD.
131 
     */
132 
    uint8_t     sfd;
133 
    /** Destination host Ethernet address (MAC address).
134 
     */
135 
    uint8_t     dest[ ETH_ADDR ];
136 
    /** Source host Ethernet address (MAC address).
137 
     */
138 
    uint8_t     src[ ETH_ADDR ];
139 
    /** Ethernet protocol identifier in the network byte order (big endian).
140 
     *  @see ethernet_protocols.h
141 
     */
142 
    uint16_t    ethertype;
143 
};
144 
 
145 
/** Ethernet header with all the extensions.
146 
 */
147 
struct eth_header_ex{
148 
    /** Ethernet header.
149 
     */
150 
    eth_header_t        header;
151 
    /** LSAP extension.
152 
     *  If DSAP and SSAP are set to ETH_LSAP_SNAP the SNAP extension is being used.
153 
     *  If DSAP and SSAP fields are equal to ETH_RAW the raw Ethernet packet without any extensions is being used and the frame content starts rigth after the two fields.
154 
     */
155 
    eth_header_lsap_t   lsap;
156 
    /** SNAP extension.
157 
     */
158 
    eth_header_snap_t   snap;
159 
};
160 
 
161 
#endif
162 
 
163 
/** @}
164 
 */