[Intel-gfx] [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
kbuild test robot
fengguang.wu at intel.com
Tue Nov 15 17:04:41 UTC 2016
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 at ffwll.ch>
:::::: CC: Daniel Vetter <daniel.vetter at ffwll.ch>
---
0-DAY kernel test infrastructure Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all Intel Corporation
-------------- next part --------------
A non-text attachment was scrubbed...
Name: .config.gz
Type: application/gzip
Size: 6425 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/intel-gfx/attachments/20161116/c9ca145f/attachment-0001.gz>
More information about the Intel-gfx
mailing list