Add 2 struct member descriptions and convert #define macro constants comments to kernel-doc comments to eliminate all kernel-doc warnings: Warning: include/uapi/drm/tegra_drm.h:353 struct member 'cmdbuf' not described in 'drm_tegra_reloc' Warning: include/uapi/drm/tegra_drm.h:353 struct member 'target' not described in 'drm_tegra_reloc' Warning: include/uapi/drm/tegra_drm.h:780 This comment starts with '/**', but isn't a kernel-doc comment. * Specify that bit 39 of the patched-in address should be set to switch Warning: include/uapi/drm/tegra_drm.h:832 This comment starts with '/**', but isn't a kernel-doc comment. * Execute `words` words of Host1x opcodes specified in the `gather_data_ptr` Warning: include/uapi/drm/tegra_drm.h:837 This comment starts with '/**', but isn't a kernel-doc comment. * Wait for a syncpoint to reach a value before continuing with further Warning: include/uapi/drm/tegra_drm.h:842 This comment starts with '/**', but isn't a kernel-doc comment. * Wait for a syncpoint to reach a value before continuing with further
Showing the changes to include/uapi (1 of 1 file). Show all
Unified · Split
| @@ -304,6 +304,7 @@ struct drm_tegra_cmdbuf { · 303 unmodified lines | ||
| 304 | 304 | * struct drm_tegra_reloc - GEM object relocation structure |
| 305 | 305 | */ |
| 306 | 306 | struct drm_tegra_reloc { |
| 307 | + /** @cmdbuf: cmd information */ | |
| 307 | 308 | struct { |
| 308 | 309 | /** |
| 309 | 310 | * @cmdbuf.handle: |
| @@ -321,6 +322,7 @@ struct drm_tegra_reloc { · 11 unmodified lines | ||
| 321 | 322 | */ |
| 322 | 323 | __u32 offset; |
| 323 | 324 | } cmdbuf; |
| 325 | + /** @target: relocate target information */ | |
| 324 | 326 | struct { |
| 325 | 327 | /** |
| 326 | 328 | * @target.handle: |
| @@ -778,6 +780,9 @@ struct drm_tegra_channel_unmap { · 451 unmodified lines | ||
| 778 | 780 | /* Submission */ |
| 779 | 781 | |
| 780 | 782 | /** |
| 783 | + * define DRM_TEGRA_SUBMIT_RELOC_SECTOR_LAYOUT - \ | |
| 784 | + * Select sector layout swizzling for in-memory buffers. | |
| 785 | + * | |
| 781 | 786 | * Specify that bit 39 of the patched-in address should be set to switch |
| 782 | 787 | * swizzling between Tegra and non-Tegra sector layout on systems that store |
| 783 | 788 | * surfaces in system memory in non-Tegra sector layout. |
| @@ -830,16 +835,27 @@ struct drm_tegra_submit_buf { · 46 unmodified lines | ||
| 830 | 835 | }; |
| 831 | 836 | |
| 832 | 837 | /** |
| 838 | + * define DRM_TEGRA_SUBMIT_CMD_GATHER_UPTR - \ | |
| 839 | + * Execute Host1x opcodes from user pointer. | |
| 840 | + * | |
| 833 | 841 | * Execute `words` words of Host1x opcodes specified in the `gather_data_ptr` |
| 834 | 842 | * buffer. Each GATHER_UPTR command uses successive words from the buffer. |
| 835 | 843 | */ |
| 836 | 844 | #define DRM_TEGRA_SUBMIT_CMD_GATHER_UPTR 0 |
| 845 | + | |
| 837 | 846 | /** |
| 847 | + * define DRM_TEGRA_SUBMIT_CMD_WAIT_SYNCPT - \ | |
| 848 | + * Wait for syncpoint (absolute). | |
| 849 | + * | |
| 838 | 850 | * Wait for a syncpoint to reach a value before continuing with further |
| 839 | 851 | * commands. |
| 840 | 852 | */ |
| 841 | 853 | #define DRM_TEGRA_SUBMIT_CMD_WAIT_SYNCPT 1 |
| 854 | + | |
| 842 | 855 | /** |
| 856 | + * define DRM_TEGRA_SUBMIT_CMD_WAIT_SYNCPT_RELATIVE - \ | |
| 857 | + * Wait for syncpoint (relative). | |
| 858 | + * | |
| 843 | 859 | * Wait for a syncpoint to reach a value before continuing with further |
| 844 | 860 | * commands. The threshold is calculated relative to the start of the job. |
| 845 | 861 | */ |