How to use it?

A sample P4 program can be found in the examples directory. To generate the 'spec' file:

p4c-dpdk --arch psa vxlan.p4 -o vxlan.spec

To load the 'spec' file in dpdk follow the instructions in the Pipeline Application User Guide.

Known issues

Unsupported Language Features

Subparsers
Parser Value Sets

Unsupported PSA externs and features

egress parser, control, and deparser are not implemented, only ingress parser, control, and deparser. There is no packet replication engine or packet buffer (the combination of which is sometimes called a traffic manager).
Packet Digest
Random
Hash
Timestamp
Direct Meter
Direct Counter
Basic Checksum
Packet Cloning/Recirculation/Resubmission

DPDK target limitations

Currently, programs written for DPDK target should limit the functionality in Ingress blocks, in case non empty Egress blocks are present it will be ignored by default unless Hidden temporary option --enableEgress used. When egress block support gets added to the DPDK target, and compiler can generate separate spec file for non empty ingress and egress blocks then option --enableEgress will be removed.
DPDK architecture assumes the following signatures for programmable block of PSA. P4C-DPDK converts the input program to this form.

 4
parser IngressParser (packet_in buffer, out H parsed_hdr, inout M user_meta);
 
control Ingress (inout H hdr, inout M user_meta);
 
control IngressDeparser (packet_out buffer, inout H hdr, in M meta);
 
parser EgressParser (packet_in buffer, out H parsed_hdr, inout M user_meta);
 
control Egress (inout H hdr, inout M user_meta);
 
control EgressDeparser (packet_out buffer, inout H hdr, in M meta);

Size of all structure fields to be multiple of 8 bits and should not be greater than 64-bit. (This limitation is planned to be removed by grouping fields into fields which are multiple of 8-bits)
Combination of header and metadata as table key is not allowed. (This limitation is removed by P4C by copying the differing match key fields to metadata)
Extract instruction in DPDK target with 2 arguments expects the second argument to be the number of bytes to be extracted into the varbit field of the header. In P4 the second argument of the extract method is the number of bits. Compiler generates instructions which compute the size in bytes from the value in bits. If the value in bits is not a multiple of 8, the value is rounded down to the lower multiple of 8 bits.
Currently dpdk target does not support standard count and execute methods for Counter and Meter externs as defined in PSA and PNA specifications. It requires packet length as parameter in count and execute methods.
PNA_MeterColor_t dpdk_execute(in S index, in PNA_MeterColor_t color, in bit<32> pkt_len);

void count(in S index, in bit<32> pkt_len);

Contacts

Han Wang han2..nosp@m.wang.nosp@m.@inte.nosp@m.l.co.nosp@m.m

Cristian Dumitrescu crist.nosp@m.ian..nosp@m.dumit.nosp@m.resc.nosp@m.u@int.nosp@m.el.c.nosp@m.om