On Wed, Jun 23, 2021 at 7:50 PM Bruce Richardson
[off-list ref] wrote:

On Wed, Jun 23, 2021 at 05:10:22PM +0530, Jerin Jacob wrote:

quoted

On Wed, Jun 23, 2021 at 3:07 PM Bruce Richardson
[off-list ref] wrote:

quoted

On Wed, Jun 23, 2021 at 12:51:07PM +0530, Jerin Jacob wrote:

quoted

On Wed, Jun 23, 2021 at 9:00 AM fengchengwen [off-list ref] wrote:

quoted

quoted

quoted

quoted

Currently, it is hard to define generic dma descriptor, I think the well-defined
APIs is feasible.

I would like to understand why not feasible? if we move the
preparation to the slow path.

i.e

struct rte_dmadev_desc defines all the "attributes" of all DMA devices available
using capability. I believe with the scheme, we can scale and
incorporate all features of
all DMA HW without any performance impact.

something like:

struct rte_dmadev_desc {
  /* Attributes all DMA transfer available for all HW under capability. */
  channel or port;
  ops ; // copy, fill etc..
 /* impemention opqueue memory as zero length array,
rte_dmadev_desc_prep() update this memory with HW specific information
*/
  uint8_t impl_opq[];
}

// allocate the memory for dma decriptor
struct rte_dmadev_desc *rte_dmadev_desc_alloc(devid);
// Convert DPDK specific descriptors to HW specific descriptors in slowpath */
rte_dmadev_desc_prep(devid, struct rte_dmadev_desc *desc);
// Free dma descriptor memory
rte_dmadev_desc_free(devid, struct rte_dmadev_desc *desc )

The above calls in slow path.

Only below call in fastpath.
// Here desc can be NULL(in case you don't need any specific attribute
attached to transfer, if needed, it can be an object which is gone
through rte_dmadev_desc_prep())
rte_dmadev_enq(devid, struct rte_dmadev_desc *desc, void *src, void
*dest, unsigned int len, cookie)

The trouble here is the performance penalty due to building up and tearing
down structures and passing those structures into functions via function
pointer. With the APIs for enqueue/dequeue that have been discussed here,
all parameters will be passed in registers, and then each driver can do a
write of the actual hardware descriptor straight to cache/memory from
registers. With the scheme you propose above, the register contains a
pointer to the data which must then be loaded into the CPU before being
written out again. This increases our offload cost.

See below.

quoted

However, assuming that the desc_prep call is just for slowpath or
initialization time, I'd be ok to have the functions take an extra
hw-specific parameter for each call prepared with tx_prep. It would still
allow all other parameters to be passed in registers. How much data are you
looking to store in this desc struct? It can't all be represented as flags,
for example?

There is around 128bit of metadata for octeontx2. New HW may
completely different metata
http://code.dpdk.org/dpdk/v21.05/source/drivers/raw/octeontx2_dma/otx2_dpi_rawdev.h#L149

I see following issue with flags scheme:

- We need to start populate in fastpath, Since it based on capabality,
application needs to have
different versions of fastpath code
- Not future proof, Not easy add other stuff as needed when new HW
comes with new
transfer attributes.

Understood. Would the "tx_prep" (or perhaps op_prep)  function you proposed
solve that problem, if it were passed (along with flags) to the
enqueue_copy function? i.e. would the below work for you, and if so, what
parameters would you see passed to the prep function?

Below prototype loooks good to me. But we need make sure we need to
encode the items the "flags"
needs to supported by all PMDs aka it should be generic. I.e
application should not have the capability check
 in fastpath for flags.

metad = rte_dma_op_prep(dev_id, ....)

rte_dma_enqueue_copy(dev_id, src, dst, len, flags, metad)

quoted

quoted

As for the individual APIs, we could do a generic "enqueue" API, which
takes the op as a parameter, I prefer having each operation as a separate
function, in order to increase the readability of the code and to reduce

Only issue I see, all application needs have two path for doing the stuff,
one with _prep() and separate function() and drivers need to support both.

If prep is not called per-op, we could always mandate it be called before
the actual enqueue functions, even if some drivers ignore the argument.

Thats works.

quoted

quoted

the number of parameters needed per function i.e. thereby saving registers
needing to be used and potentially making the function calls and offload

My worry is, struct rte_dmadev can hold only function pointers for <=
8 fastpath functions for 64B cache line.
When you say new op, say fill, need a new function, What will be the
change wrt HW
driver point of view? Is it updating HW descriptor with op as _fill_
vs _copy_? something beyond that?

Well, from a user view-point each operation takes different parameters, so
for a fill operation, you have a destination address, but instead of a
source address for copy you have pattern for fill.

OK.

Internally, for those two ops, the only different in input and descriptor
writing is indeed in the op flag, and no additional context or metadata is
needed for a copy other than source, address and length (+ plus maybe some
flags e.g. for caching behaviour or the like), so having the extra prep
function adds no value for us, and loading data from a prebuilt structure
just adds more IO overhead. Therefore, I'd ok to add it for enabling other
hardware, but only in such a way as it doesn't impact the offload cost.

If we want to in future look at adding more advanced or complex
capabilities, I'm ok for adding a general "enqueue_op" function which takes
multiple op types, but for very simple ops like copy, where we need to keep
the offload cost down to a minimum, having fastpath specific copy functions
makes a lot of sense to me.

OK.

quoted

If it is about, HW descriptor update, then _prep() can do all work,
just driver need to copy desc to
to HW.

I believe upto to 6 arguments passed over registers in x86(it is 8 in
arm64). if so,
the desc pointer(already populated in HW descriptor format by _prep())
is in register, and
would  be simple 64bit/128bit copy from desc pointer to HW memory on
driver enq(). I dont see
any overhead on that, On other side, we if keep adding arguments, it
will spill out
to stack.

For a copy operation, we should never need more than 6 arguments - see
proposal above which has 6 including a set of flags and arbitrary void *
pointer for extensibility. If anything more complex than that is needed,
the generic "enqueue_op" function can be used instead. Let's fast-path the
common, simple case, since that what is most likely to be used most!

OK.

/Bruce