pci: explain how empty strings are rejected in DBDF
authorGaetan Rivet <grive@u256.net>
Wed, 13 May 2020 10:47:51 +0000 (12:47 +0200)
committerDavid Marchand <david.marchand@redhat.com>
Tue, 19 May 2020 09:18:38 +0000 (11:18 +0200)
commit8354e681e347f72a0102f3443e3c154b0984295d
tree246ca58993d3f1a52b40ebbec490fe688c7ae305
parent21a61fae51804cfdf7c6f7e6189c63f02025de89
pci: explain how empty strings are rejected in DBDF

Empty strings are forbidden as input to rte_pci_addr_parse().
It is explicitly enforced in BDF parsing as parsing the bus
field will immediately fail. The related check is commented.

It is implicitly enforced in DBDF parsing, as the domain would be
parsed to 0 without error, but the check `end[0] != ':'` afterward
will return -EINVAL.

Enforcing consistency between parsers by reading the code is not helped
by this property being implicit. Add a comment to explain.

Signed-off-by: Gaetan Rivet <grive@u256.net>
Acked-by: Darek Stojaczyk <dariusz.stojaczyk@intel.com>
lib/librte_pci/rte_pci.c