tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
fork atom

dmaengine: Make an order in struct dma_device definition

Make an order in struct dma_device:
- added missing kernel doc descriptions
- put descriptions in the order of appearance in the code
- updated indentation where it makes sense

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Link: https://lore.kernel.org/r/20230130110503.52250-1-andriy.shevchenko@linux.intel.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>

authored by

Andy Shevchenko and committed by
Vinod Koul 8b544310 837b2faf

+7 -6
+7 -6
include/linux/dmaengine.h
··· 773 773 774 774 /** 775 775 * struct dma_device - info on the entity supplying DMA services 776 + * @ref: reference is taken and put every time a channel is allocated or freed 776 777 * @chancnt: how many DMA channels are supported 777 778 * @privatecnt: how many DMA channels are requested by dma_request_channel 778 779 * @channels: the list of struct dma_chan ··· 790 789 * @dev_id: unique device ID 791 790 * @dev: struct device reference for dma mapping api 792 791 * @owner: owner module (automatically set based on the provided dev) 792 + * @chan_ida: unique channel ID 793 793 * @src_addr_widths: bit mask of src addr widths the device supports 794 794 * Width is specified in bytes, e.g. for a device supporting 795 795 * a width of 4 the mask should have BIT(4) set. ··· 804 802 * @max_sg_burst: max number of SG list entries executed in a single burst 805 803 * DMA tansaction with no software intervention for reinitialization. 806 804 * Zero value means unlimited number of entries. 805 + * @descriptor_reuse: a submitted transfer can be resubmitted after completion 807 806 * @residue_granularity: granularity of the transfer residue reported 808 807 * by tx_status 809 808 * @device_alloc_chan_resources: allocate resources and return the ··· 842 839 * struct with auxiliary transfer status information, otherwise the call 843 840 * will just return a simple status code 844 841 * @device_issue_pending: push pending transactions to hardware 845 - * @descriptor_reuse: a submitted transfer can be resubmitted after completion 846 842 * @device_release: called sometime atfer dma_async_device_unregister() is 847 843 * called and there are no further references to this structure. This 848 844 * must be implemented to free resources however many existing drivers ··· 849 847 * @dbg_summary_show: optional routine to show contents in debugfs; default code 850 848 * will be used when this is omitted, but custom code can show extra, 851 849 * controller specific information. 850 + * @dbg_dev_root: the root folder in debugfs for this device 852 851 */ 853 852 struct dma_device { 854 853 struct kref ref; ··· 858 855 struct list_head channels; 859 856 struct list_head global_node; 860 857 struct dma_filter filter; 861 - dma_cap_mask_t cap_mask; 858 + dma_cap_mask_t cap_mask; 862 859 enum dma_desc_metadata_mode desc_metadata_modes; 863 860 unsigned short max_xor; 864 861 unsigned short max_pq; ··· 927 924 struct dma_chan *chan, dma_addr_t dst, u64 data, 928 925 unsigned long flags); 929 926 930 - void (*device_caps)(struct dma_chan *chan, 931 - struct dma_slave_caps *caps); 932 - int (*device_config)(struct dma_chan *chan, 933 - struct dma_slave_config *config); 927 + void (*device_caps)(struct dma_chan *chan, struct dma_slave_caps *caps); 928 + int (*device_config)(struct dma_chan *chan, struct dma_slave_config *config); 934 929 int (*device_pause)(struct dma_chan *chan); 935 930 int (*device_resume)(struct dma_chan *chan); 936 931 int (*device_terminate_all)(struct dma_chan *chan);