GitLab

Missing commit from merge request !145.

Add a function to create a layout from an existing one. We call it
duplicate to avoid the confusion with dma copies.

- ownership consistent with destroy operator: underlying layouts are
  also copied
- data is copied by the implementation, and the generic code takes care of
  the ops pointer.

target_dims is not the same size as the dimensions of this layout.

Refactor destroy API for layouts so that we can solve a long standing
ownership issue with complex layouts. Putting the destroy operator
inside the implementation-specific ops allows us to call a generic
destroyer on embedded layouts.

Note that this introduce a ownership policy for pad & reshape layouts
that take ownership of the targeted layout at creation time.

Related to #55.

Add a generic API function to print the internal metadata of a layout,
not its contents.

The printing format is somewhat simple, one field per line, except for
arrays that are printed one row at a time. We print them in user-order.

The generic API follows the fprintf argument style, somewhat, while the
internal code follows the AML conventions.

In most application use cases, AML will need to pass a pointer to the
layout buffer for it to be handled by application kernel. That is to
say, we don't expect applications' inner code to use layout_deref in
tight loops. Thus, it should be possible to retrieve the underlying
buffer with the minimum amount of overhead.

Add an operator to retrieve this buffer, in the most straightforward way
possible.

See #61.

layout checkpatch

Layout are a bit more complex as they contain extra arrays at the end
of the struct, so new macros are required.

Nicolas Denoyelle authored Aug 06, 2019 and Swann Perarnau committed Aug 06, 2019

Add new building block describing how data
is organized in memory.