[drm-intel:topic/drm-misc 33/40] htmldocs: include/drm/drm_drv.h:295: warning: Incorrect use of kernel-doc format: * Hook for allocating the GEM object struct, for use by core

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



tree:   git://anongit.freedesktop.org/drm-intel topic/drm-misc
head:   edd420eaffb3a618ddc8740683abc039ad97237f
commit: 6c4789edc55d5a0acefc85380d7a3f7c4f21c7cd [33/40] drm: Clean up kerneldoc for struct drm_driver
reproduce: make htmldocs; make DOCBOOKS='' pdfdocs

All warnings (new ones prefixed by >>):

   make[3]: warning: jobserver unavailable: using -j1.  Add '+' to parent make rule.
   include/linux/init.h:1: warning: no structured comments found
   include/linux/workqueue.h:392: warning: No description found for parameter '...'
   include/linux/workqueue.h:392: warning: Excess function parameter 'args' description in 'alloc_workqueue'
   include/linux/workqueue.h:413: warning: No description found for parameter '...'
   include/linux/workqueue.h:413: warning: Excess function parameter 'args' description in 'alloc_ordered_workqueue'
   include/linux/kthread.h:26: warning: No description found for parameter '...'
   kernel/sys.c:1: warning: no structured comments found
   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   include/sound/core.h:324: warning: No description found for parameter '...'
   include/sound/core.h:335: warning: No description found for parameter '...'
   include/sound/core.h:388: warning: No description found for parameter '...'
>> include/drm/drm_drv.h:295: warning: Incorrect use of kernel-doc format: 	 * Hook for allocating the GEM object struct, for use by core
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'load'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'firstopen'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'open'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'preclose'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'postclose'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'lastclose'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'unload'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'dma_ioctl'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'dma_quiescent'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'context_dtor'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'set_busid'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'irq_handler'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'irq_preinstall'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'irq_postinstall'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'irq_uninstall'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'debugfs_init'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'debugfs_cleanup'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'gem_open_object'
>> include/drm/drm_drv.h:361: warning: No description found for parameter 'gem_close_object'

vim +295 include/drm/drm_drv.h

85e634bc Daniel Vetter 2016-11-14  289  
85e634bc Daniel Vetter 2016-11-14  290  	int (*gem_open_object) (struct drm_gem_object *, struct drm_file *);
85e634bc Daniel Vetter 2016-11-14  291  	void (*gem_close_object) (struct drm_gem_object *, struct drm_file *);
85e634bc Daniel Vetter 2016-11-14  292  
85e634bc Daniel Vetter 2016-11-14  293  	/**
85e634bc Daniel Vetter 2016-11-14  294  	 * Hook for allocating the GEM object struct, for use by core
85e634bc Daniel Vetter 2016-11-14 @295  	 * helpers.
85e634bc Daniel Vetter 2016-11-14  296  	 */
85e634bc Daniel Vetter 2016-11-14  297  	struct drm_gem_object *(*gem_create_object)(struct drm_device *dev,
85e634bc Daniel Vetter 2016-11-14  298  						    size_t size);
85e634bc Daniel Vetter 2016-11-14  299  
85e634bc Daniel Vetter 2016-11-14  300  	/* prime: */
85e634bc Daniel Vetter 2016-11-14  301  	/* export handle -> fd (see drm_gem_prime_handle_to_fd() helper) */
85e634bc Daniel Vetter 2016-11-14  302  	int (*prime_handle_to_fd)(struct drm_device *dev, struct drm_file *file_priv,
85e634bc Daniel Vetter 2016-11-14  303  				uint32_t handle, uint32_t flags, int *prime_fd);
85e634bc Daniel Vetter 2016-11-14  304  	/* import fd -> handle (see drm_gem_prime_fd_to_handle() helper) */
85e634bc Daniel Vetter 2016-11-14  305  	int (*prime_fd_to_handle)(struct drm_device *dev, struct drm_file *file_priv,
85e634bc Daniel Vetter 2016-11-14  306  				int prime_fd, uint32_t *handle);
85e634bc Daniel Vetter 2016-11-14  307  	/* export GEM -> dmabuf */
85e634bc Daniel Vetter 2016-11-14  308  	struct dma_buf * (*gem_prime_export)(struct drm_device *dev,
85e634bc Daniel Vetter 2016-11-14  309  				struct drm_gem_object *obj, int flags);
85e634bc Daniel Vetter 2016-11-14  310  	/* import dmabuf -> GEM */
85e634bc Daniel Vetter 2016-11-14  311  	struct drm_gem_object * (*gem_prime_import)(struct drm_device *dev,
85e634bc Daniel Vetter 2016-11-14  312  				struct dma_buf *dma_buf);
85e634bc Daniel Vetter 2016-11-14  313  	/* low-level interface used by drm_gem_prime_{import,export} */
85e634bc Daniel Vetter 2016-11-14  314  	int (*gem_prime_pin)(struct drm_gem_object *obj);
85e634bc Daniel Vetter 2016-11-14  315  	void (*gem_prime_unpin)(struct drm_gem_object *obj);
85e634bc Daniel Vetter 2016-11-14  316  	struct reservation_object * (*gem_prime_res_obj)(
85e634bc Daniel Vetter 2016-11-14  317  				struct drm_gem_object *obj);
85e634bc Daniel Vetter 2016-11-14  318  	struct sg_table *(*gem_prime_get_sg_table)(struct drm_gem_object *obj);
85e634bc Daniel Vetter 2016-11-14  319  	struct drm_gem_object *(*gem_prime_import_sg_table)(
85e634bc Daniel Vetter 2016-11-14  320  				struct drm_device *dev,
85e634bc Daniel Vetter 2016-11-14  321  				struct dma_buf_attachment *attach,
85e634bc Daniel Vetter 2016-11-14  322  				struct sg_table *sgt);
85e634bc Daniel Vetter 2016-11-14  323  	void *(*gem_prime_vmap)(struct drm_gem_object *obj);
85e634bc Daniel Vetter 2016-11-14  324  	void (*gem_prime_vunmap)(struct drm_gem_object *obj, void *vaddr);
85e634bc Daniel Vetter 2016-11-14  325  	int (*gem_prime_mmap)(struct drm_gem_object *obj,
85e634bc Daniel Vetter 2016-11-14  326  				struct vm_area_struct *vma);
85e634bc Daniel Vetter 2016-11-14  327  
85e634bc Daniel Vetter 2016-11-14  328  	/* vga arb irq handler */
85e634bc Daniel Vetter 2016-11-14  329  	void (*vgaarb_irq)(struct drm_device *dev, bool state);
85e634bc Daniel Vetter 2016-11-14  330  
85e634bc Daniel Vetter 2016-11-14  331  	/* dumb alloc support */
85e634bc Daniel Vetter 2016-11-14  332  	int (*dumb_create)(struct drm_file *file_priv,
85e634bc Daniel Vetter 2016-11-14  333  			   struct drm_device *dev,
85e634bc Daniel Vetter 2016-11-14  334  			   struct drm_mode_create_dumb *args);
85e634bc Daniel Vetter 2016-11-14  335  	int (*dumb_map_offset)(struct drm_file *file_priv,
85e634bc Daniel Vetter 2016-11-14  336  			       struct drm_device *dev, uint32_t handle,
85e634bc Daniel Vetter 2016-11-14  337  			       uint64_t *offset);
85e634bc Daniel Vetter 2016-11-14  338  	int (*dumb_destroy)(struct drm_file *file_priv,
85e634bc Daniel Vetter 2016-11-14  339  			    struct drm_device *dev,
85e634bc Daniel Vetter 2016-11-14  340  			    uint32_t handle);
85e634bc Daniel Vetter 2016-11-14  341  
85e634bc Daniel Vetter 2016-11-14  342  	/* Driver private ops for this object */
85e634bc Daniel Vetter 2016-11-14  343  	const struct vm_operations_struct *gem_vm_ops;
85e634bc Daniel Vetter 2016-11-14  344  
85e634bc Daniel Vetter 2016-11-14  345  	int major;
85e634bc Daniel Vetter 2016-11-14  346  	int minor;
85e634bc Daniel Vetter 2016-11-14  347  	int patchlevel;
85e634bc Daniel Vetter 2016-11-14  348  	char *name;
85e634bc Daniel Vetter 2016-11-14  349  	char *desc;
85e634bc Daniel Vetter 2016-11-14  350  	char *date;
85e634bc Daniel Vetter 2016-11-14  351  
85e634bc Daniel Vetter 2016-11-14  352  	u32 driver_features;
85e634bc Daniel Vetter 2016-11-14  353  	int dev_priv_size;
85e634bc Daniel Vetter 2016-11-14  354  	const struct drm_ioctl_desc *ioctls;
85e634bc Daniel Vetter 2016-11-14  355  	int num_ioctls;
85e634bc Daniel Vetter 2016-11-14  356  	const struct file_operations *fops;
85e634bc Daniel Vetter 2016-11-14  357  
85e634bc Daniel Vetter 2016-11-14  358  	/* List of devices hanging off this driver with stealth attach. */
85e634bc Daniel Vetter 2016-11-14  359  	struct list_head legacy_dev_list;
85e634bc Daniel Vetter 2016-11-14  360  };
85e634bc Daniel Vetter 2016-11-14 @361  
85e634bc Daniel Vetter 2016-11-14  362  extern __printf(6, 7)
85e634bc Daniel Vetter 2016-11-14  363  void drm_dev_printk(const struct device *dev, const char *level,
85e634bc Daniel Vetter 2016-11-14  364  		    unsigned int category, const char *function_name,

:::::: The code at line 295 was first introduced by commit
:::::: 85e634bce01af582a0fa549c904154b0e3c56db5 drm: Extract drm_drv.h

:::::: TO: Daniel Vetter <daniel.vetter@xxxxxxxx>
:::::: CC: Daniel Vetter <daniel.vetter@xxxxxxxx>

---
0-DAY kernel test infrastructure                Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all                   Intel Corporation

Attachment: .config.gz
Description: application/gzip

_______________________________________________
Intel-gfx mailing list
Intel-gfx@xxxxxxxxxxxxxxxxxxxxx
https://lists.freedesktop.org/mailman/listinfo/intel-gfx

[Index of Archives]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]
  Powered by Linux