2 * Copyright (c) 2015 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 * ethernet_format.c: ethernet formatting/parsing.
18 * Copyright (c) 2008 Eliot Dresselhaus
20 * Permission is hereby granted, free of charge, to any person obtaining
21 * a copy of this software and associated documentation files (the
22 * "Software"), to deal in the Software without restriction, including
23 * without limitation the rights to use, copy, modify, merge, publish,
24 * distribute, sublicense, and/or sell copies of the Software, and to
25 * permit persons to whom the Software is furnished to do so, subject to
26 * the following conditions:
28 * The above copyright notice and this permission notice shall be
29 * included in all copies or substantial portions of the Software.
31 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
32 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
34 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
35 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
36 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
37 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
40 #include <vlib/vlib.h>
41 #include <vnet/ethernet/ethernet.h>
44 format_ethernet_address (u8 * s, va_list * args)
46 ethernet_main_t *em = ðernet_main;
47 u8 *a = va_arg (*args, u8 *);
49 if (em->format_ethernet_address_16bit)
50 return format (s, "%02x%02x.%02x%02x.%02x%02x",
51 a[0], a[1], a[2], a[3], a[4], a[5]);
53 return format (s, "%02x:%02x:%02x:%02x:%02x:%02x",
54 a[0], a[1], a[2], a[3], a[4], a[5]);
58 format_ethernet_type (u8 * s, va_list * args)
60 ethernet_type_t type = va_arg (*args, u32);
61 ethernet_main_t *em = ðernet_main;
62 ethernet_type_info_t *t = ethernet_get_type_info (em, type);
65 s = format (s, "%s", t->name);
67 s = format (s, "0x%04x", type);
73 format_ethernet_vlan_tci (u8 * s, va_list * va)
75 u32 vlan_tci = va_arg (*va, u32);
77 u32 vid = (vlan_tci & 0xfff);
78 u32 cfi = (vlan_tci >> 12) & 1;
79 u32 pri = (vlan_tci >> 13);
81 s = format (s, "%d", vid);
83 s = format (s, " priority %d", pri);
85 s = format (s, " cfi");
91 format_ethernet_pbb (u8 * s, va_list * va)
93 u32 b_tag = va_arg (*va, u32);
94 u32 i_tag = va_arg (*va, u32);
95 u32 vid = (b_tag & 0xfff);
96 u32 bdei = (b_tag >> 12) & 1;
97 u32 bpcp = (b_tag >> 13);
98 u32 sid = (i_tag & 0xffffff);
99 u8 ires = (i_tag >> 24) & 3;
100 u8 iuca = (i_tag >> 27) & 1;
101 u8 idei = (i_tag >> 28) & 1;
102 u8 ipcp = (i_tag >> 29);
105 format (s, "B_tag %04X (vid %d, dei %d, pcp %d), ", b_tag, vid, bdei,
108 format (s, "I_tag %08X (sid %d, res %d, dei %d, pcp %d)", i_tag, sid,
109 ires, iuca, idei, ipcp);
115 format_ethernet_header_with_length (u8 * s, va_list * args)
117 ethernet_pbb_header_packed_t *ph =
118 va_arg (*args, ethernet_pbb_header_packed_t *);
119 ethernet_max_header_t *m = (ethernet_max_header_t *) ph;
120 u32 max_header_bytes = va_arg (*args, u32);
121 ethernet_main_t *em = ðernet_main;
122 ethernet_header_t *e = &m->ethernet;
123 ethernet_vlan_header_t *v;
124 ethernet_type_t type = clib_net_to_host_u16 (e->type);
125 ethernet_type_t vlan_type[ARRAY_LEN (m->vlan)];
126 u32 n_vlan = 0, i, header_bytes;
129 while ((type == ETHERNET_TYPE_VLAN || type == ETHERNET_TYPE_DOT1AD
130 || type == ETHERNET_TYPE_DOT1AH) && n_vlan < ARRAY_LEN (m->vlan))
132 vlan_type[n_vlan] = type;
133 if (type != ETHERNET_TYPE_DOT1AH)
135 v = m->vlan + n_vlan;
136 type = clib_net_to_host_u16 (v->type);
141 header_bytes = sizeof (e[0]) + n_vlan * sizeof (v[0]);
142 if (max_header_bytes != 0 && header_bytes > max_header_bytes)
143 return format (s, "ethernet header truncated");
145 indent = format_get_indent (s);
147 s = format (s, "%U: %U -> %U",
148 format_ethernet_type, type,
149 format_ethernet_address, e->src_address,
150 format_ethernet_address, e->dst_address);
152 if (type != ETHERNET_TYPE_DOT1AH)
154 for (i = 0; i < n_vlan; i++)
156 u32 v = clib_net_to_host_u16 (m->vlan[i].priority_cfi_and_id);
157 if (*vlan_type == ETHERNET_TYPE_VLAN)
158 s = format (s, " 802.1q vlan %U", format_ethernet_vlan_tci, v);
160 s = format (s, " 802.1ad vlan %U", format_ethernet_vlan_tci, v);
163 if (max_header_bytes != 0 && header_bytes < max_header_bytes)
165 ethernet_type_info_t *ti;
166 vlib_node_t *node = 0;
168 ti = ethernet_get_type_info (em, type);
169 if (ti && ti->node_index != ~0)
170 node = vlib_get_node (em->vlib_main, ti->node_index);
171 if (node && node->format_buffer)
172 s = format (s, "\n%U%U",
173 format_white_space, indent,
174 node->format_buffer, (void *) m + header_bytes,
175 max_header_bytes - header_bytes);
180 s = format (s, "\n%UPBB header : %U", format_white_space, indent,
182 clib_net_to_host_u16 (ph->priority_dei_id),
183 clib_net_to_host_u32 (ph->priority_dei_uca_res_sid));
190 format_ethernet_header (u8 * s, va_list * args)
192 ethernet_max_header_t *m = va_arg (*args, ethernet_max_header_t *);
193 return format (s, "%U", format_ethernet_header_with_length, m, 0);
196 /* Parse X:X:X:X:X:X unix style ethernet address. */
198 unformat_ethernet_address_unix (unformat_input_t * input, va_list * args)
200 u8 *result = va_arg (*args, u8 *);
203 if (!unformat (input, "%_%x:%x:%x:%x:%x:%x%_",
204 &a[0], &a[1], &a[2], &a[3], &a[4], &a[5]))
208 for (i = 0; i < ARRAY_LEN (a); i++)
209 if (a[i] >= (1 << 8))
212 for (i = 0; i < ARRAY_LEN (a); i++)
218 /* Parse X.X.X cisco style ethernet address. */
220 unformat_ethernet_address_cisco (unformat_input_t * input, va_list * args)
222 u8 *result = va_arg (*args, u8 *);
225 if (!unformat (input, "%_%x.%x.%x%_", &a[0], &a[1], &a[2]))
229 for (i = 0; i < ARRAY_LEN (a); i++)
230 if (a[i] >= (1 << 16))
233 result[0] = (a[0] >> 8) & 0xff;
234 result[1] = (a[0] >> 0) & 0xff;
235 result[2] = (a[1] >> 8) & 0xff;
236 result[3] = (a[1] >> 0) & 0xff;
237 result[4] = (a[2] >> 8) & 0xff;
238 result[5] = (a[2] >> 0) & 0xff;
243 /* Parse ethernet address; accept either unix or style addresses. */
245 unformat_ethernet_address (unformat_input_t * input, va_list * args)
247 u8 *result = va_arg (*args, u8 *);
248 return (unformat_user (input, unformat_ethernet_address_unix, result)
249 || unformat_user (input, unformat_ethernet_address_cisco, result));
252 /* Returns ethernet type as an int in host byte order. */
254 unformat_ethernet_type_host_byte_order (unformat_input_t * input,
257 u16 *result = va_arg (*args, u16 *);
258 ethernet_main_t *em = ðernet_main;
262 if (unformat (input, "0x%x", &type) || unformat (input, "%d", &type))
264 if (type >= (1 << 16))
271 if (unformat_user (input, unformat_vlib_number_by_name,
272 em->type_info_by_name, &i))
274 ethernet_type_info_t *ti = vec_elt_at_index (em->type_infos, i);
283 unformat_ethernet_type_net_byte_order (unformat_input_t * input,
286 u16 *result = va_arg (*args, u16 *);
287 if (!unformat_user (input, unformat_ethernet_type_host_byte_order, result))
290 *result = clib_host_to_net_u16 ((u16) * result);
295 unformat_ethernet_header (unformat_input_t * input, va_list * args)
297 u8 **result = va_arg (*args, u8 **);
298 ethernet_max_header_t _m, *m = &_m;
299 ethernet_header_t *e = &m->ethernet;
303 if (!unformat (input, "%U: %U -> %U",
304 unformat_ethernet_type_host_byte_order, &type,
305 unformat_ethernet_address, &e->src_address,
306 unformat_ethernet_address, &e->dst_address))
310 while (unformat (input, "vlan"))
314 if (!unformat_user (input, unformat_vlib_number, &id)
315 || id >= ETHERNET_N_VLAN)
318 if (unformat (input, "priority %d", &priority))
322 id |= priority << 13;
325 if (unformat (input, "cfi"))
328 /* Too many vlans given. */
329 if (n_vlan >= ARRAY_LEN (m->vlan))
332 m->vlan[n_vlan].priority_cfi_and_id = clib_host_to_net_u16 (id);
337 e->type = clib_host_to_net_u16 (type);
342 e->type = clib_host_to_net_u16 (ETHERNET_TYPE_VLAN);
343 for (i = 0; i < n_vlan - 1; i++)
344 m->vlan[i].type = clib_host_to_net_u16 (ETHERNET_TYPE_VLAN);
345 m->vlan[n_vlan - 1].type = clib_host_to_net_u16 (type);
348 /* Add header to result. */
351 u32 n_bytes = sizeof (e[0]) + n_vlan * sizeof (m->vlan[0]);
353 vec_add2 (*result, p, n_bytes);
354 clib_memcpy (p, m, n_bytes);
361 * fd.io coding-style-patch-verification: ON
364 * eval: (c-set-style "gnu")