This is not a v2, since the original patch was already merged. Also my patches change the same lines, so need to rebase this after those are merged.
-Petri > -----Original Message----- > From: lng-odp [mailto:lng-odp-boun...@lists.linaro.org] On Behalf Of ext > Bill Fischofer > Sent: Thursday, April 23, 2015 11:37 PM > To: lng-odp@lists.linaro.org > Subject: [lng-odp] [API-NEXT PATCHv2] api: pktio: Clarify doc on default > pool usage on odp_pktio_open > > Signed-off-by: Bill Fischofer <bill.fischo...@linaro.org> > --- > > Changes for v2: Correct grammatical ambiguities throughout doc for > odp_pktio_open(). > > include/odp/api/packet_io.h | 22 +++++++++++++++------- > 1 file changed, 15 insertions(+), 7 deletions(-) > > diff --git a/include/odp/api/packet_io.h b/include/odp/api/packet_io.h > index 6d31aeb..89356a6 100644 > --- a/include/odp/api/packet_io.h > +++ b/include/odp/api/packet_io.h > @@ -47,20 +47,28 @@ extern "C" { > /** > * Open an ODP packet IO instance > * > - * Packet IO handles are single instance per device, attempts to open an > already > - * open device will fail, returning ODP_PKTIO_INVALID with errno set. > - * odp_pktio_lookup() may be used to obtain a handle to an already open > device. > + * Packet IO handles are a single instance per device. Attempts to open > an > + * already open device will fail, returning ODP_PKTIO_INVALID with errno > set. > + * odp_pktio_lookup() may be used to obtain a handle to an already open > + * device. > * > * @param dev Packet IO device name > - * @param pool Pool from which to allocate buffers for storing packets > + * @param pool Default pool from which to allocate buffers for storing > packets > * received over this packet IO > * > * @return ODP packet IO handle > * @retval ODP_PKTIO_INVALID on failure > * > - * @note dev name loop is specially pktio reserved name for > - * device used for testing. Usually it's loop back > - * interface. > + * @note The device name "loop" is a reserved name for a loopback device > used > + * for testing purposes. > + * > + * @note Packets arriving via this interface assigned to a CoS by the > + * classifier are received into the pool associated with that CoS. > This > + * will occur either becuase this pktio is assigned a default CoS via > + * the odp_pktio_default_cos_set() routine, or because a matching PMR > + * assigned the packet to a specific CoS. The default pool specified > + * here is applicable only for those packets that are not assigned to > a > + * more specific CoS. > */ > odp_pktio_t odp_pktio_open(const char *dev, odp_pool_t pool); > > -- > 2.1.0 > > _______________________________________________ > lng-odp mailing list > lng-odp@lists.linaro.org > https://lists.linaro.org/mailman/listinfo/lng-odp _______________________________________________ lng-odp mailing list lng-odp@lists.linaro.org https://lists.linaro.org/mailman/listinfo/lng-odp
