HomeFreeBSD

Introduce the concept of busdma tag templates. A template can be allocated

Description

Introduce the concept of busdma tag templates. A template can be allocated
off the stack, initialized to default values, and then filled in with
driver-specific values, all without having to worry about the numerous
other fields in the tag. The resulting template is then passed into
busdma and the normal opaque tag object created. See the man page for
details on how to initialize a template.

Templates do not support tag filters. Filters have been broken for many
years, and only existed for an ancient make/model of hardware that had a
quirky DMA engine. Instead of breaking the ABI/API and changing the
arugment signature of bus_dma_tag_create() to remove the filter arguments,
templates allow us to ignore them, and also significantly reduce the
complexity of creating and managing tags.

Reviewed by: imp, kib
Differential Revision: https://reviews.freebsd.org/D22906

Details

Provenance
scottlAuthored on
Reviewer
imp
Differential Revision
D22906: Simplify busdma tag creation
Parents
rS356049: kern_synch: Fix some UB
Branches
Unknown
Tags
Unknown