2 * Copyright (c) 2008, 2009, 2010 Nicira Networks.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
18 #include "ofp-print.h"
23 #include <netinet/in.h>
30 #include "dynamic-string.h"
33 #include "openflow/openflow.h"
34 #include "openflow/nicira-ext.h"
39 static void ofp_print_port_name(struct ds
*string
, uint16_t port
);
41 /* Returns a string that represents the contents of the Ethernet frame in the
42 * 'len' bytes starting at 'data' to 'stream' as output by tcpdump.
43 * 'total_len' specifies the full length of the Ethernet frame (of which 'len'
44 * bytes were captured).
46 * The caller must free the returned string.
48 * This starts and kills a tcpdump subprocess so it's quite expensive. */
50 ofp_packet_to_string(const void *data
, size_t len
, size_t total_len OVS_UNUSED
)
52 struct ds ds
= DS_EMPTY_INITIALIZER
;
61 buf
.data
= (void *) data
;
66 ovs_error(errno
, "tmpfile");
67 return xstrdup("<error>");
69 pcap_write_header(pcap
);
70 pcap_write(pcap
, &buf
);
73 ovs_error(errno
, "error writing temporary file");
77 snprintf(command
, sizeof command
, "/usr/sbin/tcpdump -e -n -r /dev/fd/%d 2>/dev/null",
79 tcpdump
= popen(command
, "r");
82 ovs_error(errno
, "exec(\"%s\")", command
);
83 return xstrdup("<error>");
86 while ((c
= getc(tcpdump
)) != EOF
) {
90 status
= pclose(tcpdump
);
91 if (WIFEXITED(status
)) {
92 if (WEXITSTATUS(status
))
93 ovs_error(0, "tcpdump exited with status %d", WEXITSTATUS(status
));
94 } else if (WIFSIGNALED(status
)) {
95 ovs_error(0, "tcpdump exited with signal %d", WTERMSIG(status
));
100 /* Pretty-print the OFPT_PACKET_IN packet of 'len' bytes at 'oh' to 'stream'
101 * at the given 'verbosity' level. */
103 ofp_packet_in(struct ds
*string
, const void *oh
, size_t len
, int verbosity
)
105 const struct ofp_packet_in
*op
= oh
;
108 ds_put_format(string
, " total_len=%"PRIu16
" in_port=",
109 ntohs(op
->total_len
));
110 ofp_print_port_name(string
, ntohs(op
->in_port
));
112 if (op
->reason
== OFPR_ACTION
)
113 ds_put_cstr(string
, " (via action)");
114 else if (op
->reason
!= OFPR_NO_MATCH
)
115 ds_put_format(string
, " (***reason %"PRIu8
"***)", op
->reason
);
117 data_len
= len
- offsetof(struct ofp_packet_in
, data
);
118 ds_put_format(string
, " data_len=%zu", data_len
);
119 if (htonl(op
->buffer_id
) == UINT32_MAX
) {
120 ds_put_format(string
, " (unbuffered)");
121 if (ntohs(op
->total_len
) != data_len
)
122 ds_put_format(string
, " (***total_len != data_len***)");
124 ds_put_format(string
, " buffer=0x%08"PRIx32
, ntohl(op
->buffer_id
));
125 if (ntohs(op
->total_len
) < data_len
)
126 ds_put_format(string
, " (***total_len < data_len***)");
128 ds_put_char(string
, '\n');
132 struct ofpbuf packet
;
133 struct ofp_match match
;
134 packet
.data
= (void *) op
->data
;
135 packet
.size
= data_len
;
136 flow_extract(&packet
, ntohs(op
->in_port
), &flow
);
137 flow_to_match(&flow
, 0, &match
);
138 ofp_print_match(string
, &match
, verbosity
);
139 ds_put_char(string
, '\n');
142 char *packet
= ofp_packet_to_string(op
->data
, data_len
,
143 ntohs(op
->total_len
));
144 ds_put_cstr(string
, packet
);
149 static void ofp_print_port_name(struct ds
*string
, uint16_t port
)
168 case OFPP_CONTROLLER
:
178 ds_put_format(string
, "%"PRIu16
, port
);
181 ds_put_cstr(string
, name
);
185 ofp_print_nx_action(struct ds
*string
, const struct nx_action_header
*nah
)
187 switch (ntohs(nah
->subtype
)) {
188 case NXAST_RESUBMIT
: {
189 const struct nx_action_resubmit
*nar
= (struct nx_action_resubmit
*)nah
;
190 ds_put_format(string
, "resubmit:");
191 ofp_print_port_name(string
, ntohs(nar
->in_port
));
196 ds_put_format(string
, "***unknown Nicira action:%d***\n",
197 ntohs(nah
->subtype
));
202 ofp_print_action(struct ds
*string
, const struct ofp_action_header
*ah
,
208 struct openflow_action
{
213 const struct openflow_action of_actions
[] = {
215 sizeof(struct ofp_action_output
),
216 sizeof(struct ofp_action_output
),
218 [OFPAT_SET_VLAN_VID
] = {
219 sizeof(struct ofp_action_vlan_vid
),
220 sizeof(struct ofp_action_vlan_vid
),
222 [OFPAT_SET_VLAN_PCP
] = {
223 sizeof(struct ofp_action_vlan_pcp
),
224 sizeof(struct ofp_action_vlan_pcp
),
226 [OFPAT_STRIP_VLAN
] = {
227 sizeof(struct ofp_action_header
),
228 sizeof(struct ofp_action_header
),
230 [OFPAT_SET_DL_SRC
] = {
231 sizeof(struct ofp_action_dl_addr
),
232 sizeof(struct ofp_action_dl_addr
),
234 [OFPAT_SET_DL_DST
] = {
235 sizeof(struct ofp_action_dl_addr
),
236 sizeof(struct ofp_action_dl_addr
),
238 [OFPAT_SET_NW_SRC
] = {
239 sizeof(struct ofp_action_nw_addr
),
240 sizeof(struct ofp_action_nw_addr
),
242 [OFPAT_SET_NW_DST
] = {
243 sizeof(struct ofp_action_nw_addr
),
244 sizeof(struct ofp_action_nw_addr
),
246 [OFPAT_SET_NW_TOS
] = {
247 sizeof(struct ofp_action_nw_tos
),
248 sizeof(struct ofp_action_nw_tos
),
250 [OFPAT_SET_TP_SRC
] = {
251 sizeof(struct ofp_action_tp_port
),
252 sizeof(struct ofp_action_tp_port
),
254 [OFPAT_SET_TP_DST
] = {
255 sizeof(struct ofp_action_tp_port
),
256 sizeof(struct ofp_action_tp_port
),
258 /* OFPAT_VENDOR is not here, since it would blow up the array size. */
261 if (actions_len
< sizeof *ah
) {
262 ds_put_format(string
, "***action array too short for next action***\n");
266 type
= ntohs(ah
->type
);
267 len
= ntohs(ah
->len
);
268 if (actions_len
< len
) {
269 ds_put_format(string
, "***truncated action %"PRIu16
"***\n", type
);
273 if ((len
% 8) != 0) {
274 ds_put_format(string
,
275 "***action %"PRIu16
" length not a multiple of 8***\n",
280 if (type
< ARRAY_SIZE(of_actions
)) {
281 const struct openflow_action
*act
= &of_actions
[type
];
282 if ((len
< act
->min_size
) || (len
> act
->max_size
)) {
283 ds_put_format(string
,
284 "***action %"PRIu16
" wrong length: %zu***\n", type
, len
);
291 struct ofp_action_output
*oa
= (struct ofp_action_output
*)ah
;
292 uint16_t port
= ntohs(oa
->port
);
293 if (port
< OFPP_MAX
) {
294 ds_put_format(string
, "output:%"PRIu16
, port
);
296 ofp_print_port_name(string
, port
);
297 if (port
== OFPP_CONTROLLER
) {
299 ds_put_format(string
, ":%"PRIu16
, ntohs(oa
->max_len
));
301 ds_put_cstr(string
, ":all");
308 case OFPAT_SET_VLAN_VID
: {
309 struct ofp_action_vlan_vid
*va
= (struct ofp_action_vlan_vid
*)ah
;
310 ds_put_format(string
, "mod_vlan_vid:%"PRIu16
, ntohs(va
->vlan_vid
));
314 case OFPAT_SET_VLAN_PCP
: {
315 struct ofp_action_vlan_pcp
*va
= (struct ofp_action_vlan_pcp
*)ah
;
316 ds_put_format(string
, "mod_vlan_pcp:%"PRIu8
, va
->vlan_pcp
);
320 case OFPAT_STRIP_VLAN
:
321 ds_put_cstr(string
, "strip_vlan");
324 case OFPAT_SET_DL_SRC
: {
325 struct ofp_action_dl_addr
*da
= (struct ofp_action_dl_addr
*)ah
;
326 ds_put_format(string
, "mod_dl_src:"ETH_ADDR_FMT
,
327 ETH_ADDR_ARGS(da
->dl_addr
));
331 case OFPAT_SET_DL_DST
: {
332 struct ofp_action_dl_addr
*da
= (struct ofp_action_dl_addr
*)ah
;
333 ds_put_format(string
, "mod_dl_dst:"ETH_ADDR_FMT
,
334 ETH_ADDR_ARGS(da
->dl_addr
));
338 case OFPAT_SET_NW_SRC
: {
339 struct ofp_action_nw_addr
*na
= (struct ofp_action_nw_addr
*)ah
;
340 ds_put_format(string
, "mod_nw_src:"IP_FMT
, IP_ARGS(&na
->nw_addr
));
344 case OFPAT_SET_NW_DST
: {
345 struct ofp_action_nw_addr
*na
= (struct ofp_action_nw_addr
*)ah
;
346 ds_put_format(string
, "mod_nw_dst:"IP_FMT
, IP_ARGS(&na
->nw_addr
));
350 case OFPAT_SET_NW_TOS
: {
351 struct ofp_action_nw_tos
*nt
= (struct ofp_action_nw_tos
*)ah
;
352 ds_put_format(string
, "mod_nw_tos:%d", nt
->nw_tos
);
356 case OFPAT_SET_TP_SRC
: {
357 struct ofp_action_tp_port
*ta
= (struct ofp_action_tp_port
*)ah
;
358 ds_put_format(string
, "mod_tp_src:%d", ntohs(ta
->tp_port
));
362 case OFPAT_SET_TP_DST
: {
363 struct ofp_action_tp_port
*ta
= (struct ofp_action_tp_port
*)ah
;
364 ds_put_format(string
, "mod_tp_dst:%d", ntohs(ta
->tp_port
));
369 struct ofp_action_vendor_header
*avh
370 = (struct ofp_action_vendor_header
*)ah
;
371 if (len
< sizeof *avh
) {
372 ds_put_format(string
, "***ofpat_vendor truncated***\n");
375 if (avh
->vendor
== htonl(NX_VENDOR_ID
)) {
376 ofp_print_nx_action(string
, (struct nx_action_header
*)avh
);
378 ds_put_format(string
, "vendor action:0x%x", ntohl(avh
->vendor
));
384 ds_put_format(string
, "(decoder %"PRIu16
" not implemented)", type
);
392 ofp_print_actions(struct ds
*string
, const struct ofp_action_header
*action
,
395 uint8_t *p
= (uint8_t *)action
;
398 ds_put_cstr(string
, "actions=");
400 ds_put_cstr(string
, "drop");
402 while (actions_len
> 0) {
404 ds_put_cstr(string
, ",");
406 len
= ofp_print_action(string
, (struct ofp_action_header
*)p
,
416 /* Pretty-print the OFPT_PACKET_OUT packet of 'len' bytes at 'oh' to 'string'
417 * at the given 'verbosity' level. */
418 static void ofp_packet_out(struct ds
*string
, const void *oh
, size_t len
,
421 const struct ofp_packet_out
*opo
= oh
;
422 size_t actions_len
= ntohs(opo
->actions_len
);
424 ds_put_cstr(string
, " in_port=");
425 ofp_print_port_name(string
, ntohs(opo
->in_port
));
427 ds_put_format(string
, " actions_len=%zu ", actions_len
);
428 if (actions_len
> (ntohs(opo
->header
.length
) - sizeof *opo
)) {
429 ds_put_format(string
, "***packet too short for action length***\n");
432 ofp_print_actions(string
, opo
->actions
, actions_len
);
434 if (ntohl(opo
->buffer_id
) == UINT32_MAX
) {
435 int data_len
= len
- sizeof *opo
- actions_len
;
436 ds_put_format(string
, " data_len=%d", data_len
);
437 if (verbosity
> 0 && len
> sizeof *opo
) {
438 char *packet
= ofp_packet_to_string(
439 (uint8_t *)opo
->actions
+ actions_len
, data_len
, data_len
);
440 ds_put_char(string
, '\n');
441 ds_put_cstr(string
, packet
);
445 ds_put_format(string
, " buffer=0x%08"PRIx32
, ntohl(opo
->buffer_id
));
447 ds_put_char(string
, '\n');
450 /* qsort comparison function. */
452 compare_ports(const void *a_
, const void *b_
)
454 const struct ofp_phy_port
*a
= a_
;
455 const struct ofp_phy_port
*b
= b_
;
456 uint16_t ap
= ntohs(a
->port_no
);
457 uint16_t bp
= ntohs(b
->port_no
);
459 return ap
< bp
? -1 : ap
> bp
;
462 static void ofp_print_port_features(struct ds
*string
, uint32_t features
)
465 ds_put_cstr(string
, "Unsupported\n");
468 if (features
& OFPPF_10MB_HD
) {
469 ds_put_cstr(string
, "10MB-HD ");
471 if (features
& OFPPF_10MB_FD
) {
472 ds_put_cstr(string
, "10MB-FD ");
474 if (features
& OFPPF_100MB_HD
) {
475 ds_put_cstr(string
, "100MB-HD ");
477 if (features
& OFPPF_100MB_FD
) {
478 ds_put_cstr(string
, "100MB-FD ");
480 if (features
& OFPPF_1GB_HD
) {
481 ds_put_cstr(string
, "1GB-HD ");
483 if (features
& OFPPF_1GB_FD
) {
484 ds_put_cstr(string
, "1GB-FD ");
486 if (features
& OFPPF_10GB_FD
) {
487 ds_put_cstr(string
, "10GB-FD ");
489 if (features
& OFPPF_COPPER
) {
490 ds_put_cstr(string
, "COPPER ");
492 if (features
& OFPPF_FIBER
) {
493 ds_put_cstr(string
, "FIBER ");
495 if (features
& OFPPF_AUTONEG
) {
496 ds_put_cstr(string
, "AUTO_NEG ");
498 if (features
& OFPPF_PAUSE
) {
499 ds_put_cstr(string
, "AUTO_PAUSE ");
501 if (features
& OFPPF_PAUSE_ASYM
) {
502 ds_put_cstr(string
, "AUTO_PAUSE_ASYM ");
504 ds_put_char(string
, '\n');
508 ofp_print_phy_port(struct ds
*string
, const struct ofp_phy_port
*port
)
510 uint8_t name
[OFP_MAX_PORT_NAME_LEN
];
513 memcpy(name
, port
->name
, sizeof name
);
514 for (j
= 0; j
< sizeof name
- 1; j
++) {
515 if (!isprint(name
[j
])) {
521 ds_put_char(string
, ' ');
522 ofp_print_port_name(string
, ntohs(port
->port_no
));
523 ds_put_format(string
, "(%s): addr:"ETH_ADDR_FMT
", config: %#x, state:%#x\n",
524 name
, ETH_ADDR_ARGS(port
->hw_addr
), ntohl(port
->config
),
527 ds_put_format(string
, " current: ");
528 ofp_print_port_features(string
, ntohl(port
->curr
));
530 if (port
->advertised
) {
531 ds_put_format(string
, " advertised: ");
532 ofp_print_port_features(string
, ntohl(port
->advertised
));
534 if (port
->supported
) {
535 ds_put_format(string
, " supported: ");
536 ofp_print_port_features(string
, ntohl(port
->supported
));
539 ds_put_format(string
, " peer: ");
540 ofp_print_port_features(string
, ntohl(port
->peer
));
544 /* Pretty-print the struct ofp_switch_features of 'len' bytes at 'oh' to
545 * 'string' at the given 'verbosity' level. */
547 ofp_print_switch_features(struct ds
*string
, const void *oh
, size_t len
,
548 int verbosity OVS_UNUSED
)
550 const struct ofp_switch_features
*osf
= oh
;
551 struct ofp_phy_port
*port_list
;
555 ds_put_format(string
, " ver:0x%x, dpid:%016"PRIx64
"\n",
556 osf
->header
.version
, ntohll(osf
->datapath_id
));
557 ds_put_format(string
, "n_tables:%d, n_buffers:%d\n", osf
->n_tables
,
558 ntohl(osf
->n_buffers
));
559 ds_put_format(string
, "features: capabilities:%#x, actions:%#x\n",
560 ntohl(osf
->capabilities
), ntohl(osf
->actions
));
562 if (ntohs(osf
->header
.length
) >= sizeof *osf
) {
563 len
= MIN(len
, ntohs(osf
->header
.length
));
565 n_ports
= (len
- sizeof *osf
) / sizeof *osf
->ports
;
567 port_list
= xmemdup(osf
->ports
, len
- sizeof *osf
);
568 qsort(port_list
, n_ports
, sizeof *port_list
, compare_ports
);
569 for (i
= 0; i
< n_ports
; i
++) {
570 ofp_print_phy_port(string
, &port_list
[i
]);
575 /* Pretty-print the struct ofp_switch_config of 'len' bytes at 'oh' to 'string'
576 * at the given 'verbosity' level. */
578 ofp_print_switch_config(struct ds
*string
, const void *oh
,
579 size_t len OVS_UNUSED
, int verbosity OVS_UNUSED
)
581 const struct ofp_switch_config
*osc
= oh
;
584 flags
= ntohs(osc
->flags
);
586 ds_put_format(string
, " ***unknown flags 0x%04"PRIx16
"***", flags
);
589 ds_put_format(string
, " miss_send_len=%"PRIu16
"\n", ntohs(osc
->miss_send_len
));
592 static void print_wild(struct ds
*string
, const char *leader
, int is_wild
,
593 int verbosity
, const char *format
, ...)
594 __attribute__((format(printf
, 5, 6)));
596 static void print_wild(struct ds
*string
, const char *leader
, int is_wild
,
597 int verbosity
, const char *format
, ...)
599 if (is_wild
&& verbosity
< 2) {
602 ds_put_cstr(string
, leader
);
606 va_start(args
, format
);
607 ds_put_format_valist(string
, format
, args
);
610 ds_put_char(string
, '*');
612 ds_put_char(string
, ',');
616 print_ip_netmask(struct ds
*string
, const char *leader
, uint32_t ip
,
617 uint32_t wild_bits
, int verbosity
)
619 if (wild_bits
>= 32 && verbosity
< 2) {
622 ds_put_cstr(string
, leader
);
623 if (wild_bits
< 32) {
624 ds_put_format(string
, IP_FMT
, IP_ARGS(&ip
));
626 ds_put_format(string
, "/%d", 32 - wild_bits
);
629 ds_put_char(string
, '*');
631 ds_put_char(string
, ',');
635 ofp_print_match(struct ds
*f
, const struct ofp_match
*om
, int verbosity
)
637 char *s
= ofp_match_to_string(om
, verbosity
);
643 ofp_match_to_string(const struct ofp_match
*om
, int verbosity
)
645 struct ds f
= DS_EMPTY_INITIALIZER
;
646 uint32_t w
= ntohl(om
->wildcards
);
647 bool skip_type
= false;
648 bool skip_proto
= false;
650 if (!(w
& OFPFW_DL_TYPE
)) {
652 if (om
->dl_type
== htons(ETH_TYPE_IP
)) {
653 if (!(w
& OFPFW_NW_PROTO
)) {
655 if (om
->nw_proto
== IP_TYPE_ICMP
) {
656 ds_put_cstr(&f
, "icmp,");
657 } else if (om
->nw_proto
== IP_TYPE_TCP
) {
658 ds_put_cstr(&f
, "tcp,");
659 } else if (om
->nw_proto
== IP_TYPE_UDP
) {
660 ds_put_cstr(&f
, "udp,");
662 ds_put_cstr(&f
, "ip,");
666 ds_put_cstr(&f
, "ip,");
668 } else if (om
->dl_type
== htons(ETH_TYPE_ARP
)) {
669 ds_put_cstr(&f
, "arp,");
674 print_wild(&f
, "in_port=", w
& OFPFW_IN_PORT
, verbosity
,
675 "%d", ntohs(om
->in_port
));
676 print_wild(&f
, "dl_vlan=", w
& OFPFW_DL_VLAN
, verbosity
,
677 "0x%04x", ntohs(om
->dl_vlan
));
678 print_wild(&f
, "dl_vlan_pcp=", w
& OFPFW_DL_VLAN_PCP
, verbosity
,
679 "%d", om
->dl_vlan_pcp
);
680 print_wild(&f
, "dl_src=", w
& OFPFW_DL_SRC
, verbosity
,
681 ETH_ADDR_FMT
, ETH_ADDR_ARGS(om
->dl_src
));
682 print_wild(&f
, "dl_dst=", w
& OFPFW_DL_DST
, verbosity
,
683 ETH_ADDR_FMT
, ETH_ADDR_ARGS(om
->dl_dst
));
685 print_wild(&f
, "dl_type=", w
& OFPFW_DL_TYPE
, verbosity
,
686 "0x%04x", ntohs(om
->dl_type
));
688 print_ip_netmask(&f
, "nw_src=", om
->nw_src
,
689 (w
& OFPFW_NW_SRC_MASK
) >> OFPFW_NW_SRC_SHIFT
, verbosity
);
690 print_ip_netmask(&f
, "nw_dst=", om
->nw_dst
,
691 (w
& OFPFW_NW_DST_MASK
) >> OFPFW_NW_DST_SHIFT
, verbosity
);
693 if (om
->dl_type
== htons(ETH_TYPE_ARP
)) {
694 print_wild(&f
, "opcode=", w
& OFPFW_NW_PROTO
, verbosity
,
697 print_wild(&f
, "nw_proto=", w
& OFPFW_NW_PROTO
, verbosity
,
699 print_wild(&f
, "nw_tos=", w
& OFPFW_NW_TOS
, verbosity
,
703 if (om
->nw_proto
== IP_TYPE_ICMP
) {
704 print_wild(&f
, "icmp_type=", w
& OFPFW_ICMP_TYPE
, verbosity
,
705 "%d", ntohs(om
->icmp_type
));
706 print_wild(&f
, "icmp_code=", w
& OFPFW_ICMP_CODE
, verbosity
,
707 "%d", ntohs(om
->icmp_code
));
709 print_wild(&f
, "tp_src=", w
& OFPFW_TP_SRC
, verbosity
,
710 "%d", ntohs(om
->tp_src
));
711 print_wild(&f
, "tp_dst=", w
& OFPFW_TP_DST
, verbosity
,
712 "%d", ntohs(om
->tp_dst
));
717 /* Pretty-print the OFPT_FLOW_MOD packet of 'len' bytes at 'oh' to 'string'
718 * at the given 'verbosity' level. */
720 ofp_print_flow_mod(struct ds
*string
, const void *oh
, size_t len
,
723 const struct ofp_flow_mod
*ofm
= oh
;
725 ofp_print_match(string
, &ofm
->match
, verbosity
);
726 switch (ntohs(ofm
->command
)) {
728 ds_put_cstr(string
, " ADD: ");
731 ds_put_cstr(string
, " MOD: ");
733 case OFPFC_MODIFY_STRICT
:
734 ds_put_cstr(string
, " MOD_STRICT: ");
737 ds_put_cstr(string
, " DEL: ");
739 case OFPFC_DELETE_STRICT
:
740 ds_put_cstr(string
, " DEL_STRICT: ");
743 ds_put_format(string
, " cmd:%d ", ntohs(ofm
->command
));
745 ds_put_format(string
, "cookie:%"PRIx64
" idle:%d hard:%d pri:%d "
746 "buf:%#x flags:%"PRIx16
" ", ntohll(ofm
->cookie
),
747 ntohs(ofm
->idle_timeout
), ntohs(ofm
->hard_timeout
),
748 ofm
->match
.wildcards
? ntohs(ofm
->priority
) : (uint16_t)-1,
749 ntohl(ofm
->buffer_id
), ntohs(ofm
->flags
));
750 ofp_print_actions(string
, ofm
->actions
,
751 len
- offsetof(struct ofp_flow_mod
, actions
));
752 ds_put_char(string
, '\n');
755 /* Pretty-print the OFPT_FLOW_REMOVED packet of 'len' bytes at 'oh' to 'string'
756 * at the given 'verbosity' level. */
758 ofp_print_flow_removed(struct ds
*string
, const void *oh
,
759 size_t len OVS_UNUSED
, int verbosity
)
761 const struct ofp_flow_removed
*ofr
= oh
;
763 ofp_print_match(string
, &ofr
->match
, verbosity
);
764 ds_put_cstr(string
, " reason=");
765 switch (ofr
->reason
) {
766 case OFPRR_IDLE_TIMEOUT
:
767 ds_put_cstr(string
, "idle");
769 case OFPRR_HARD_TIMEOUT
:
770 ds_put_cstr(string
, "hard");
773 ds_put_cstr(string
, "delete");
776 ds_put_format(string
, "**%"PRIu8
"**", ofr
->reason
);
779 ds_put_format(string
,
780 " cookie%"PRIx64
" pri%"PRIu16
" secs%"PRIu32
" nsecs%"PRIu32
781 " idle%"PRIu16
" pkts%"PRIu64
" bytes%"PRIu64
"\n",
783 ofr
->match
.wildcards
? ntohs(ofr
->priority
) : (uint16_t)-1,
784 ntohl(ofr
->duration_sec
), ntohl(ofr
->duration_nsec
),
785 ntohs(ofr
->idle_timeout
), ntohll(ofr
->packet_count
),
786 ntohll(ofr
->byte_count
));
790 ofp_print_port_mod(struct ds
*string
, const void *oh
, size_t len OVS_UNUSED
,
791 int verbosity OVS_UNUSED
)
793 const struct ofp_port_mod
*opm
= oh
;
795 ds_put_format(string
, "port: %d: addr:"ETH_ADDR_FMT
", config: %#x, mask:%#x\n",
796 ntohs(opm
->port_no
), ETH_ADDR_ARGS(opm
->hw_addr
),
797 ntohl(opm
->config
), ntohl(opm
->mask
));
798 ds_put_format(string
, " advertise: ");
799 if (opm
->advertise
) {
800 ofp_print_port_features(string
, ntohl(opm
->advertise
));
802 ds_put_format(string
, "UNCHANGED\n");
812 static const struct error_type error_types
[] = {
813 #define ERROR_TYPE(TYPE) {TYPE, -1, #TYPE}
814 #define ERROR_CODE(TYPE, CODE) {TYPE, CODE, #CODE}
815 ERROR_TYPE(OFPET_HELLO_FAILED
),
816 ERROR_CODE(OFPET_HELLO_FAILED
, OFPHFC_INCOMPATIBLE
),
817 ERROR_CODE(OFPET_HELLO_FAILED
, OFPHFC_EPERM
),
819 ERROR_TYPE(OFPET_BAD_REQUEST
),
820 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BAD_VERSION
),
821 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BAD_TYPE
),
822 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BAD_STAT
),
823 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BAD_VENDOR
),
824 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BAD_SUBTYPE
),
825 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_EPERM
),
826 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BAD_LEN
),
827 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BUFFER_EMPTY
),
828 ERROR_CODE(OFPET_BAD_REQUEST
, OFPBRC_BUFFER_UNKNOWN
),
830 ERROR_TYPE(OFPET_BAD_ACTION
),
831 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_BAD_TYPE
),
832 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_BAD_LEN
),
833 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_BAD_VENDOR
),
834 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_BAD_VENDOR_TYPE
),
835 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_BAD_OUT_PORT
),
836 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_BAD_ARGUMENT
),
837 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_EPERM
),
838 ERROR_CODE(OFPET_BAD_ACTION
, OFPBAC_TOO_MANY
),
840 ERROR_TYPE(OFPET_FLOW_MOD_FAILED
),
841 ERROR_CODE(OFPET_FLOW_MOD_FAILED
, OFPFMFC_ALL_TABLES_FULL
),
842 ERROR_CODE(OFPET_FLOW_MOD_FAILED
, OFPFMFC_OVERLAP
),
843 ERROR_CODE(OFPET_FLOW_MOD_FAILED
, OFPFMFC_EPERM
),
844 ERROR_CODE(OFPET_FLOW_MOD_FAILED
, OFPFMFC_BAD_EMERG_TIMEOUT
),
845 ERROR_CODE(OFPET_FLOW_MOD_FAILED
, OFPFMFC_BAD_COMMAND
),
847 ERROR_TYPE(OFPET_PORT_MOD_FAILED
),
848 ERROR_CODE(OFPET_PORT_MOD_FAILED
, OFPPMFC_BAD_PORT
),
849 ERROR_CODE(OFPET_PORT_MOD_FAILED
, OFPPMFC_BAD_HW_ADDR
)
851 #define N_ERROR_TYPES ARRAY_SIZE(error_types)
854 lookup_error_type(int type
)
856 const struct error_type
*t
;
858 for (t
= error_types
; t
< &error_types
[N_ERROR_TYPES
]; t
++) {
859 if (t
->type
== type
&& t
->code
== -1) {
867 lookup_error_code(int type
, int code
)
869 const struct error_type
*t
;
871 for (t
= error_types
; t
< &error_types
[N_ERROR_TYPES
]; t
++) {
872 if (t
->type
== type
&& t
->code
== code
) {
879 /* Pretty-print the OFPT_ERROR packet of 'len' bytes at 'oh' to 'string'
880 * at the given 'verbosity' level. */
882 ofp_print_error_msg(struct ds
*string
, const void *oh
, size_t len
,
883 int verbosity OVS_UNUSED
)
885 const struct ofp_error_msg
*oem
= oh
;
886 int type
= ntohs(oem
->type
);
887 int code
= ntohs(oem
->code
);
890 ds_put_format(string
, " type%d(%s) code%d(%s) payload:\n",
891 type
, lookup_error_type(type
),
892 code
, lookup_error_code(type
, code
));
895 case OFPET_HELLO_FAILED
:
896 ds_put_printable(string
, (char *) oem
->data
, len
- sizeof *oem
);
899 case OFPET_BAD_REQUEST
:
900 s
= ofp_to_string(oem
->data
, len
- sizeof *oem
, 1);
901 ds_put_cstr(string
, s
);
906 ds_put_hex_dump(string
, oem
->data
, len
- sizeof *oem
, 0, true);
911 /* Pretty-print the OFPT_PORT_STATUS packet of 'len' bytes at 'oh' to 'string'
912 * at the given 'verbosity' level. */
914 ofp_print_port_status(struct ds
*string
, const void *oh
, size_t len OVS_UNUSED
,
915 int verbosity OVS_UNUSED
)
917 const struct ofp_port_status
*ops
= oh
;
919 if (ops
->reason
== OFPPR_ADD
) {
920 ds_put_format(string
, " ADD:");
921 } else if (ops
->reason
== OFPPR_DELETE
) {
922 ds_put_format(string
, " DEL:");
923 } else if (ops
->reason
== OFPPR_MODIFY
) {
924 ds_put_format(string
, " MOD:");
927 ofp_print_phy_port(string
, &ops
->desc
);
931 ofp_desc_stats_reply(struct ds
*string
, const void *body
,
932 size_t len OVS_UNUSED
, int verbosity OVS_UNUSED
)
934 const struct ofp_desc_stats
*ods
= body
;
936 ds_put_format(string
, "Manufacturer: %s\n", ods
->mfr_desc
);
937 ds_put_format(string
, "Hardware: %s\n", ods
->hw_desc
);
938 ds_put_format(string
, "Software: %s\n", ods
->sw_desc
);
939 ds_put_format(string
, "Serial Num: %s\n", ods
->serial_num
);
940 ds_put_format(string
, "DP Description: %s\n", ods
->dp_desc
);
944 ofp_flow_stats_request(struct ds
*string
, const void *oh
,
945 size_t len OVS_UNUSED
, int verbosity
)
947 const struct ofp_flow_stats_request
*fsr
= oh
;
949 if (fsr
->table_id
== 0xff) {
950 ds_put_format(string
, " table_id=any, ");
952 ds_put_format(string
, " table_id=%"PRIu8
", ", fsr
->table_id
);
955 ofp_print_match(string
, &fsr
->match
, verbosity
);
959 ofp_flow_stats_reply(struct ds
*string
, const void *body_
, size_t len
,
962 const char *body
= body_
;
963 const char *pos
= body
;
965 const struct ofp_flow_stats
*fs
;
966 ptrdiff_t bytes_left
= body
+ len
- pos
;
969 if (bytes_left
< sizeof *fs
) {
970 if (bytes_left
!= 0) {
971 ds_put_format(string
, " ***%td leftover bytes at end***",
977 fs
= (const void *) pos
;
978 length
= ntohs(fs
->length
);
979 if (length
< sizeof *fs
) {
980 ds_put_format(string
, " ***length=%zu shorter than minimum %zu***",
983 } else if (length
> bytes_left
) {
984 ds_put_format(string
,
985 " ***length=%zu but only %td bytes left***",
988 } else if ((length
- sizeof *fs
) % sizeof fs
->actions
[0]) {
989 ds_put_format(string
,
990 " ***length=%zu has %zu bytes leftover in "
993 (length
- sizeof *fs
) % sizeof fs
->actions
[0]);
997 ds_put_format(string
, " cookie=%"PRIu64
"s, ", ntohll(fs
->cookie
));
998 ds_put_format(string
, "duration_sec=%"PRIu32
"s, ",
999 ntohl(fs
->duration_sec
));
1000 ds_put_format(string
, "duration_nsec=%"PRIu32
"s, ",
1001 ntohl(fs
->duration_nsec
));
1002 ds_put_format(string
, "table_id=%"PRIu8
", ", fs
->table_id
);
1003 ds_put_format(string
, "priority=%"PRIu16
", ",
1004 fs
->match
.wildcards
? ntohs(fs
->priority
) : (uint16_t)-1);
1005 ds_put_format(string
, "n_packets=%"PRIu64
", ",
1006 ntohll(fs
->packet_count
));
1007 ds_put_format(string
, "n_bytes=%"PRIu64
", ", ntohll(fs
->byte_count
));
1008 if (fs
->idle_timeout
!= htons(OFP_FLOW_PERMANENT
)) {
1009 ds_put_format(string
, "idle_timeout=%"PRIu16
",",
1010 ntohs(fs
->idle_timeout
));
1012 if (fs
->hard_timeout
!= htons(OFP_FLOW_PERMANENT
)) {
1013 ds_put_format(string
, "hard_timeout=%"PRIu16
",",
1014 ntohs(fs
->hard_timeout
));
1016 ofp_print_match(string
, &fs
->match
, verbosity
);
1017 ofp_print_actions(string
, fs
->actions
, length
- sizeof *fs
);
1018 ds_put_char(string
, '\n');
1025 ofp_aggregate_stats_request(struct ds
*string
, const void *oh
,
1026 size_t len OVS_UNUSED
, int verbosity
)
1028 const struct ofp_aggregate_stats_request
*asr
= oh
;
1030 if (asr
->table_id
== 0xff) {
1031 ds_put_format(string
, " table_id=any, ");
1033 ds_put_format(string
, " table_id=%"PRIu8
", ", asr
->table_id
);
1036 ofp_print_match(string
, &asr
->match
, verbosity
);
1040 ofp_aggregate_stats_reply(struct ds
*string
, const void *body_
,
1041 size_t len OVS_UNUSED
, int verbosity OVS_UNUSED
)
1043 const struct ofp_aggregate_stats_reply
*asr
= body_
;
1045 ds_put_format(string
, " packet_count=%"PRIu64
, ntohll(asr
->packet_count
));
1046 ds_put_format(string
, " byte_count=%"PRIu64
, ntohll(asr
->byte_count
));
1047 ds_put_format(string
, " flow_count=%"PRIu32
, ntohl(asr
->flow_count
));
1050 static void print_port_stat(struct ds
*string
, const char *leader
,
1051 uint64_t stat
, int more
)
1053 ds_put_cstr(string
, leader
);
1055 ds_put_format(string
, "%"PRIu64
, stat
);
1057 ds_put_char(string
, '?');
1060 ds_put_cstr(string
, ", ");
1062 ds_put_cstr(string
, "\n");
1067 ofp_port_stats_reply(struct ds
*string
, const void *body
, size_t len
,
1070 const struct ofp_port_stats
*ps
= body
;
1071 size_t n
= len
/ sizeof *ps
;
1072 ds_put_format(string
, " %zu ports\n", n
);
1073 if (verbosity
< 1) {
1078 ds_put_format(string
, " port %2"PRIu16
": ", ntohs(ps
->port_no
));
1080 ds_put_cstr(string
, "rx ");
1081 print_port_stat(string
, "pkts=", ntohll(ps
->rx_packets
), 1);
1082 print_port_stat(string
, "bytes=", ntohll(ps
->rx_bytes
), 1);
1083 print_port_stat(string
, "drop=", ntohll(ps
->rx_dropped
), 1);
1084 print_port_stat(string
, "errs=", ntohll(ps
->rx_errors
), 1);
1085 print_port_stat(string
, "frame=", ntohll(ps
->rx_frame_err
), 1);
1086 print_port_stat(string
, "over=", ntohll(ps
->rx_over_err
), 1);
1087 print_port_stat(string
, "crc=", ntohll(ps
->rx_crc_err
), 0);
1089 ds_put_cstr(string
, " tx ");
1090 print_port_stat(string
, "pkts=", ntohll(ps
->tx_packets
), 1);
1091 print_port_stat(string
, "bytes=", ntohll(ps
->tx_bytes
), 1);
1092 print_port_stat(string
, "drop=", ntohll(ps
->tx_dropped
), 1);
1093 print_port_stat(string
, "errs=", ntohll(ps
->tx_errors
), 1);
1094 print_port_stat(string
, "coll=", ntohll(ps
->collisions
), 0);
1099 ofp_table_stats_reply(struct ds
*string
, const void *body
, size_t len
,
1102 const struct ofp_table_stats
*ts
= body
;
1103 size_t n
= len
/ sizeof *ts
;
1104 ds_put_format(string
, " %zu tables\n", n
);
1105 if (verbosity
< 1) {
1110 char name
[OFP_MAX_TABLE_NAME_LEN
+ 1];
1111 strncpy(name
, ts
->name
, sizeof name
);
1112 name
[OFP_MAX_TABLE_NAME_LEN
] = '\0';
1114 ds_put_format(string
, " %d: %-8s: ", ts
->table_id
, name
);
1115 ds_put_format(string
, "wild=0x%05"PRIx32
", ", ntohl(ts
->wildcards
));
1116 ds_put_format(string
, "max=%6"PRIu32
", ", ntohl(ts
->max_entries
));
1117 ds_put_format(string
, "active=%"PRIu32
"\n", ntohl(ts
->active_count
));
1118 ds_put_cstr(string
, " ");
1119 ds_put_format(string
, "lookup=%"PRIu64
", ",
1120 ntohll(ts
->lookup_count
));
1121 ds_put_format(string
, "matched=%"PRIu64
"\n",
1122 ntohll(ts
->matched_count
));
1127 vendor_stat(struct ds
*string
, const void *body
, size_t len
,
1128 int verbosity OVS_UNUSED
)
1130 ds_put_format(string
, " vendor=%08"PRIx32
, ntohl(*(uint32_t *) body
));
1131 ds_put_format(string
, " %zu bytes additional data",
1132 len
- sizeof(uint32_t));
1135 enum stats_direction
{
1141 print_stats(struct ds
*string
, int type
, const void *body
, size_t body_len
,
1142 int verbosity
, enum stats_direction direction
)
1145 size_t min_body
, max_body
;
1146 void (*printer
)(struct ds
*, const void *, size_t len
, int verbosity
);
1152 struct stats_msg request
;
1153 struct stats_msg reply
;
1156 static const struct stats_type stats_types
[] = {
1161 { 0, SIZE_MAX
, ofp_desc_stats_reply
},
1166 { sizeof(struct ofp_flow_stats_request
),
1167 sizeof(struct ofp_flow_stats_request
),
1168 ofp_flow_stats_request
},
1169 { 0, SIZE_MAX
, ofp_flow_stats_reply
},
1174 { sizeof(struct ofp_aggregate_stats_request
),
1175 sizeof(struct ofp_aggregate_stats_request
),
1176 ofp_aggregate_stats_request
},
1177 { sizeof(struct ofp_aggregate_stats_reply
),
1178 sizeof(struct ofp_aggregate_stats_reply
),
1179 ofp_aggregate_stats_reply
},
1185 { 0, SIZE_MAX
, ofp_table_stats_reply
},
1191 { 0, SIZE_MAX
, ofp_port_stats_reply
},
1196 { sizeof(uint32_t), SIZE_MAX
, vendor_stat
},
1197 { sizeof(uint32_t), SIZE_MAX
, vendor_stat
},
1207 const struct stats_type
*s
;
1208 const struct stats_msg
*m
;
1210 if (type
>= ARRAY_SIZE(stats_types
) || !stats_types
[type
].name
) {
1211 ds_put_format(string
, " ***unknown type %d***", type
);
1214 for (s
= stats_types
; s
->type
>= 0; s
++) {
1215 if (s
->type
== type
) {
1219 ds_put_format(string
, " type=%d(%s)\n", type
, s
->name
);
1221 m
= direction
== REQUEST
? &s
->request
: &s
->reply
;
1222 if (body_len
< m
->min_body
|| body_len
> m
->max_body
) {
1223 ds_put_format(string
, " ***body_len=%zu not in %zu...%zu***",
1224 body_len
, m
->min_body
, m
->max_body
);
1228 m
->printer(string
, body
, body_len
, verbosity
);
1233 ofp_stats_request(struct ds
*string
, const void *oh
, size_t len
, int verbosity
)
1235 const struct ofp_stats_request
*srq
= oh
;
1238 ds_put_format(string
, " ***unknown flags 0x%04"PRIx16
"***",
1242 print_stats(string
, ntohs(srq
->type
), srq
->body
,
1243 len
- offsetof(struct ofp_stats_request
, body
),
1244 verbosity
, REQUEST
);
1248 ofp_stats_reply(struct ds
*string
, const void *oh
, size_t len
, int verbosity
)
1250 const struct ofp_stats_reply
*srp
= oh
;
1252 ds_put_cstr(string
, " flags=");
1254 ds_put_cstr(string
, "none");
1256 uint16_t flags
= ntohs(srp
->flags
);
1257 if (flags
& OFPSF_REPLY_MORE
) {
1258 ds_put_cstr(string
, "[more]");
1259 flags
&= ~OFPSF_REPLY_MORE
;
1262 ds_put_format(string
, "[***unknown flags 0x%04"PRIx16
"***]", flags
);
1266 print_stats(string
, ntohs(srp
->type
), srp
->body
,
1267 len
- offsetof(struct ofp_stats_reply
, body
),
1272 ofp_echo(struct ds
*string
, const void *oh
, size_t len
, int verbosity
)
1274 const struct ofp_header
*hdr
= oh
;
1276 ds_put_format(string
, " %zu bytes of payload\n", len
- sizeof *hdr
);
1277 if (verbosity
> 1) {
1278 ds_put_hex_dump(string
, hdr
, len
- sizeof *hdr
, 0, true);
1282 struct openflow_packet
{
1286 void (*printer
)(struct ds
*, const void *, size_t len
, int verbosity
);
1289 static const struct openflow_packet packets
[] = {
1293 sizeof (struct ofp_header
),
1297 OFPT_FEATURES_REQUEST
,
1299 sizeof (struct ofp_header
),
1303 OFPT_FEATURES_REPLY
,
1305 sizeof (struct ofp_switch_features
),
1306 ofp_print_switch_features
,
1309 OFPT_GET_CONFIG_REQUEST
,
1310 "get_config_request",
1311 sizeof (struct ofp_header
),
1315 OFPT_GET_CONFIG_REPLY
,
1317 sizeof (struct ofp_switch_config
),
1318 ofp_print_switch_config
,
1323 sizeof (struct ofp_switch_config
),
1324 ofp_print_switch_config
,
1329 offsetof(struct ofp_packet_in
, data
),
1335 sizeof (struct ofp_packet_out
),
1341 sizeof (struct ofp_flow_mod
),
1347 sizeof (struct ofp_flow_removed
),
1348 ofp_print_flow_removed
,
1353 sizeof (struct ofp_port_mod
),
1359 sizeof (struct ofp_port_status
),
1360 ofp_print_port_status
1365 sizeof (struct ofp_error_msg
),
1366 ofp_print_error_msg
,
1371 sizeof (struct ofp_stats_request
),
1377 sizeof (struct ofp_stats_reply
),
1383 sizeof (struct ofp_header
),
1389 sizeof (struct ofp_header
),
1395 sizeof (struct ofp_vendor_header
),
1399 OFPT_BARRIER_REQUEST
,
1401 sizeof (struct ofp_header
),
1407 sizeof (struct ofp_header
),
1412 /* Composes and returns a string representing the OpenFlow packet of 'len'
1413 * bytes at 'oh' at the given 'verbosity' level. 0 is a minimal amount of
1414 * verbosity and higher numbers increase verbosity. The caller is responsible
1415 * for freeing the string. */
1417 ofp_to_string(const void *oh_
, size_t len
, int verbosity
)
1419 struct ds string
= DS_EMPTY_INITIALIZER
;
1420 const struct ofp_header
*oh
= oh_
;
1421 const struct openflow_packet
*pkt
;
1423 if (len
< sizeof(struct ofp_header
)) {
1424 ds_put_cstr(&string
, "OpenFlow packet too short:\n");
1425 ds_put_hex_dump(&string
, oh
, len
, 0, true);
1426 return ds_cstr(&string
);
1427 } else if (oh
->version
!= OFP_VERSION
) {
1428 ds_put_format(&string
, "Bad OpenFlow version %"PRIu8
":\n", oh
->version
);
1429 ds_put_hex_dump(&string
, oh
, len
, 0, true);
1430 return ds_cstr(&string
);
1433 for (pkt
= packets
; ; pkt
++) {
1434 if (pkt
>= &packets
[ARRAY_SIZE(packets
)]) {
1435 ds_put_format(&string
, "Unknown OpenFlow packet type %"PRIu8
":\n",
1437 ds_put_hex_dump(&string
, oh
, len
, 0, true);
1438 return ds_cstr(&string
);
1439 } else if (oh
->type
== pkt
->type
) {
1444 ds_put_format(&string
, "%s (xid=0x%"PRIx32
"):", pkt
->name
, oh
->xid
);
1446 if (ntohs(oh
->length
) > len
)
1447 ds_put_format(&string
, " (***truncated to %zu bytes from %"PRIu16
"***)",
1448 len
, ntohs(oh
->length
));
1449 else if (ntohs(oh
->length
) < len
) {
1450 ds_put_format(&string
, " (***only uses %"PRIu16
" bytes out of %zu***)\n",
1451 ntohs(oh
->length
), len
);
1452 len
= ntohs(oh
->length
);
1455 if (len
< pkt
->min_size
) {
1456 ds_put_format(&string
, " (***length=%zu < min_size=%zu***)\n",
1457 len
, pkt
->min_size
);
1458 } else if (!pkt
->printer
) {
1459 if (len
> sizeof *oh
) {
1460 ds_put_format(&string
, " length=%"PRIu16
" (decoder not implemented)\n",
1464 pkt
->printer(&string
, oh
, len
, verbosity
);
1466 if (verbosity
>= 3) {
1467 ds_put_hex_dump(&string
, oh
, len
, 0, true);
1469 if (string
.string
[string
.length
- 1] != '\n') {
1470 ds_put_char(&string
, '\n');
1472 return ds_cstr(&string
);
1475 /* Returns the name for the specified OpenFlow message type as a string,
1476 * e.g. "OFPT_FEATURES_REPLY". If no name is known, the string returned is a
1477 * hex number, e.g. "0x55".
1479 * The caller must free the returned string when it is no longer needed. */
1481 ofp_message_type_to_string(uint8_t type
)
1483 struct ds s
= DS_EMPTY_INITIALIZER
;
1484 const struct openflow_packet
*pkt
;
1485 for (pkt
= packets
; ; pkt
++) {
1486 if (pkt
>= &packets
[ARRAY_SIZE(packets
)]) {
1487 ds_put_format(&s
, "0x%02"PRIx8
, type
);
1489 } else if (type
== pkt
->type
) {
1492 ds_put_cstr(&s
, "OFPT_");
1493 for (p
= pkt
->name
; *p
; p
++) {
1494 ds_put_char(&s
, toupper((unsigned char) *p
));
1503 print_and_free(FILE *stream
, char *string
)
1505 fputs(string
, stream
);
1509 /* Pretty-print the OpenFlow packet of 'len' bytes at 'oh' to 'stream' at the
1510 * given 'verbosity' level. 0 is a minimal amount of verbosity and higher
1511 * numbers increase verbosity. */
1513 ofp_print(FILE *stream
, const void *oh
, size_t len
, int verbosity
)
1515 print_and_free(stream
, ofp_to_string(oh
, len
, verbosity
));
1518 /* Dumps the contents of the Ethernet frame in the 'len' bytes starting at
1519 * 'data' to 'stream' using tcpdump. 'total_len' specifies the full length of
1520 * the Ethernet frame (of which 'len' bytes were captured).
1522 * This starts and kills a tcpdump subprocess so it's quite expensive. */
1524 ofp_print_packet(FILE *stream
, const void *data
, size_t len
, size_t total_len
)
1526 print_and_free(stream
, ofp_packet_to_string(data
, len
, total_len
));