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/dri-devel/attachments/20161116/c9ca145f/attachment-0001.gz>
