On 2018-05-30 08:42 PM, Leo Liu wrote: > There are four ioctls in this files, and DOC gives details of > data structures for each of ioctls, and their functionalities. > > Signed-off-by: Leo Liu <leo.liu at amd.com> > --- > drivers/gpu/drm/amd/amdgpu/amdgpu_cs.c | 142 +++++++++++++++++++++++++ > 1 file changed, 142 insertions(+) > > diff --git a/drivers/gpu/drm/amd/amdgpu/amdgpu_cs.c b/drivers/gpu/drm/amd/amdgpu/amdgpu_cs.c > index 12f0d18c6ee8..343ff115cff1 100644 > --- a/drivers/gpu/drm/amd/amdgpu/amdgpu_cs.c > +++ b/drivers/gpu/drm/amd/amdgpu/amdgpu_cs.c > @@ -1217,6 +1217,49 @@ static int amdgpu_cs_submit(struct amdgpu_cs_parser *p, > return 0; > } > > +/** > + * DOC: amdgpu_cs_ioctl > + * > + * This ioctl processes user space command submission chunks, > + * return a fence sequence number associated to a amdgpu fence. > + * > + * In data structure: > + * > + * __u32 ctx_id: > + * Integer ID, created via DRM_AMDGPU_CTX ioctl call when user space > + * command submission context created. It will be used as ID for later > + * command submission context. > + * > + * __u32 bo_list_handle: > + * Handle of resources list associated with this CS, created via > + * DRM_AMDGPU_BO_LIST ioctl call before command submission, and > + * the BOs in the list will be validated. > + * > + * __u32 num_chunks: > + * Number of chunks, their types include: > + * AMDGPU_CHUNK_ID_IB > + * The data will be filled into IB buffer, and mappped to a HW ring. > + * > + * AMDGPU_CHUNK_ID_FENCE > + * The data will be used to find user fence BO and its offset. > + * > + * AMDGPU_CHUNK_ID_DEPENDENCIES > + * AMDGPU_CHUNK_ID_SYNCOBJ_IN > + * AMDGPU_CHUNK_ID_SYNCOBJ_OUT > + * These will be parsed as fence dependencies in given requirement, > + * and will be remembered and to be synced later. > + * > + * __u32 _pad: > + * > + * __u64 chunks: > + * Point to the CS chunks. BTW, this kind of formatting isn't preserved in the generated documentation, so it probably won't look as intended. -- Earthling Michel Dänzer | http://www.amd.com Libre software enthusiast | Mesa and X developer
