[driver-core:driver-core-testing 11/17] htmldocs: include/linux/device.h:1357: warning: Function parameter or member 'state_synced' not described in 'device'

* [driver-core:driver-core-testing 11/17] htmldocs: include/linux/device.h:1357: warning: Function parameter or member 'state_synced' not described in 'device'
@ 2019-07-31 19:05 kbuild test robot
  2019-07-31 19:05 ` kbuild test robot
  0 siblings, 1 reply; 2+ messages in thread
From: kbuild test robot @ 2019-07-31 19:05 UTC (permalink / raw)

tree:   https://kernel.googlesource.com/pub/scm/linux/kernel/git/gregkh/driver-core.git driver-core-testing
head:   90eb808c54acbacfb76b408036dc0fc287b46901
commit: 46c5ea62709238df9b033991882358fba099aa55 [11/17] driver core: Add sync_state driver/bus callback
reproduce: make htmldocs

If you fix the issue, kindly add following tag
Reported-by: kbuild test robot <lkp at intel.com>

All warnings (new ones prefixed by >>):

   Warning: The Sphinx 'sphinx_rtd_theme' HTML theme was not found. Make sure you have the theme installed to produce pretty HTML output. Falling back to the default theme.
   WARNING: dot(1) not found, for better output quality install graphviz from http://www.graphviz.org
   WARNING: convert(1) not found, for SVG to PDF conversion install ImageMagick (https://www.imagemagick.org)
   include/linux/w1.h:272: warning: Function parameter or member 'of_match_table' not described in 'w1_family'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'quotactl' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'quota_on' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'sb_free_mnt_opts' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'sb_eat_lsm_opts' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'sb_kern_mount' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'sb_show_options' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'sb_add_mnt_opt' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'd_instantiate' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'getprocattr' not described in 'security_list_options'
   include/linux/lsm_hooks.h:1811: warning: Function parameter or member 'setprocattr' not described in 'security_list_options'
   lib/genalloc.c:1: warning: 'gen_pool_add_virt' not found
   lib/genalloc.c:1: warning: 'gen_pool_alloc' not found
   lib/genalloc.c:1: warning: 'gen_pool_free' not found
   lib/genalloc.c:1: warning: 'gen_pool_alloc_algo' not found
   include/linux/i2c.h:337: warning: Function parameter or member 'init_irq' not described in 'i2c_client'
   include/linux/spi/spi.h:190: warning: Function parameter or member 'driver_override' not described in 'spi_device'
   drivers/usb/typec/bus.c:1: warning: 'typec_altmode_unregister_driver' not found
   drivers/usb/typec/bus.c:1: warning: 'typec_altmode_register_driver' not found
   drivers/usb/typec/class.c:1: warning: 'typec_altmode_unregister_notifier' not found
   drivers/usb/typec/class.c:1: warning: 'typec_altmode_register_notifier' not found
   include/linux/regulator/machine.h:196: warning: Function parameter or member 'max_uV_step' not described in 'regulation_constraints'
   include/linux/regulator/driver.h:223: warning: Function parameter or member 'resume' not described in 'regulator_ops'
   fs/direct-io.c:258: warning: Excess function parameter 'offset' description in 'dio_complete'
   fs/libfs.c:496: warning: Excess function parameter 'available' description in 'simple_write_end'
   fs/posix_acl.c:647: warning: Function parameter or member 'inode' not described in 'posix_acl_update_mode'
   fs/posix_acl.c:647: warning: Function parameter or member 'mode_p' not described in 'posix_acl_update_mode'
   fs/posix_acl.c:647: warning: Function parameter or member 'acl' not described in 'posix_acl_update_mode'
   include/linux/device.h:258: warning: Function parameter or member 'bus' not described in 'bus_find_next_device'
   include/linux/device.h:258: warning: Function parameter or member 'cur' not described in 'bus_find_next_device'
   include/linux/device.h:483: warning: Function parameter or member 'drv' not described in 'driver_find_device_by_name'
   include/linux/device.h:483: warning: Excess function parameter 'driver' description in 'driver_find_device_by_name'
   include/linux/device.h:496: warning: Function parameter or member 'drv' not described in 'driver_find_device_by_of_node'
   include/linux/device.h:496: warning: Excess function parameter 'driver' description in 'driver_find_device_by_of_node'
   include/linux/device.h:509: warning: Function parameter or member 'drv' not described in 'driver_find_device_by_fwnode'
   include/linux/device.h:509: warning: Excess function parameter 'driver' description in 'driver_find_device_by_fwnode'
   include/linux/device.h:521: warning: Function parameter or member 'drv' not described in 'driver_find_device_by_devt'
   include/linux/device.h:521: warning: Excess function parameter 'driver' description in 'driver_find_device_by_devt'
   include/linux/device.h:541: warning: Function parameter or member 'drv' not described in 'driver_find_device_by_acpi_dev'
   include/linux/device.h:541: warning: Excess function parameter 'driver' description in 'driver_find_device_by_acpi_dev'
   include/linux/device.h:1357: warning: Function parameter or member 'has_edit_links' not described in 'device'
>> include/linux/device.h:1357: warning: Function parameter or member 'state_synced' not described in 'device'
   include/linux/input/sparse-keymap.h:43: warning: Function parameter or member 'sw' not described in 'key_entry'
   include/linux/skbuff.h:893: warning: Function parameter or member 'dev_scratch' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'list' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'ip_defrag_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'skb_mstamp_ns' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member '__cloned_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'head_frag' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member '__pkt_type_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'encapsulation' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'encap_hdr_csum' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'csum_valid' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member '__pkt_vlan_present_offset' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'vlan_present' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'csum_complete_sw' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'csum_level' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'inner_protocol_type' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'remcsum_offload' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'sender_cpu' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'reserved_tailroom' not described in 'sk_buff'
   include/linux/skbuff.h:893: warning: Function parameter or member 'inner_ipproto' not described in 'sk_buff'
   include/net/sock.h:233: warning: Function parameter or member 'skc_addrpair' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_portpair' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_ipv6only' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_net_refcnt' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_v6_daddr' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_v6_rcv_saddr' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_cookie' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_listener' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_tw_dr' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_rcv_wnd' not described in 'sock_common'
   include/net/sock.h:233: warning: Function parameter or member 'skc_tw_rcv_nxt' not described in 'sock_common'
   include/net/sock.h:515: warning: Function parameter or member 'sk_rx_skb_cache' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'sk_wq_raw' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'tcp_rtx_queue' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'sk_tx_skb_cache' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'sk_route_forced_caps' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'sk_txtime_report_errors' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'sk_validate_xmit_skb' not described in 'sock'
   include/net/sock.h:515: warning: Function parameter or member 'sk_bpf_storage' not described in 'sock'
   include/net/sock.h:2439: warning: Function parameter or member 'tcp_rx_skb_cache_key' not described in 'DECLARE_STATIC_KEY_FALSE'
   include/net/sock.h:2439: warning: Excess function parameter 'sk' description in 'DECLARE_STATIC_KEY_FALSE'
   include/net/sock.h:2439: warning: Excess function parameter 'skb' description in 'DECLARE_STATIC_KEY_FALSE'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'gso_partial_features' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'l3mdev_ops' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'xfrmdev_ops' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'tlsdev_ops' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'name_assign_type' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'ieee802154_ptr' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'mpls_ptr' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'xdp_prog' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'gro_flush_timeout' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'nf_hooks_ingress' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member '____cacheline_aligned_in_smp' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'qdisc_hash' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'xps_cpus_map' not described in 'net_device'
   include/linux/netdevice.h:2040: warning: Function parameter or member 'xps_rxqs_map' not described in 'net_device'
   include/linux/phylink.h:56: warning: Function parameter or member '__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising' not described in 'phylink_link_state'
   include/linux/phylink.h:56: warning: Function parameter or member '__ETHTOOL_DECLARE_LINK_MODE_MASK(lp_advertising' not described in 'phylink_link_state'
   drivers/net/phy/phylink.c:593: warning: Function parameter or member 'config' not described in 'phylink_create'
   drivers/net/phy/phylink.c:593: warning: Excess function parameter 'ndev' description in 'phylink_create'
   include/net/mac80211.h:2006: warning: Function parameter or member 'txpwr' not described in 'ieee80211_sta'
   include/linux/mod_devicetable.h:822: warning: Function parameter or member 'context' not described in 'wmi_device_id'
   include/linux/device.h:482: warning: Excess function parameter 'driver' description in 'driver_find_device_by_name'
   include/linux/device.h:495: warning: Excess function parameter 'driver' description in 'driver_find_device_by_of_node'
   include/linux/device.h:508: warning: Excess function parameter 'driver' description in 'driver_find_device_by_fwnode'
   include/linux/device.h:520: warning: Excess function parameter 'driver' description in 'driver_find_device_by_devt'
   include/linux/device.h:540: warning: Excess function parameter 'driver' description in 'driver_find_device_by_acpi_dev'
   include/linux/clk.h:381: warning: Function parameter or member 'num_clks' not described in 'devm_clk_bulk_get_optional'
   mm/util.c:1: warning: 'get_user_pages_fast' not found
   mm/slab.c:4215: warning: Function parameter or member 'objp' not described in '__ksize'
   include/net/cfg80211.h:1092: warning: Function parameter or member 'txpwr' not described in 'station_parameters'
   include/net/mac80211.h:4043: warning: Function parameter or member 'sta_set_txpwr' not described in 'ieee80211_ops'
   drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c:142: warning: Function parameter or member 'blockable' not described in 'amdgpu_mn_read_lock'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:347: warning: cannot understand function prototype: 'struct amdgpu_vm_pt_cursor '
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:348: warning: cannot understand function prototype: 'struct amdgpu_vm_pt_cursor '
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:494: warning: Function parameter or member 'start' not described in 'amdgpu_vm_pt_first_dfs'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'adev' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'vm' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'start' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'cursor' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:546: warning: Function parameter or member 'entry' not described in 'for_each_amdgpu_vm_pt_dfs_safe'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:823: warning: Function parameter or member 'level' not described in 'amdgpu_vm_bo_param'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'params' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'bo' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'level' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'pe' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'addr' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'count' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'incr' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:1285: warning: Function parameter or member 'flags' not described in 'amdgpu_vm_update_flags'
   drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c:2822: warning: Function parameter or member 'pasid' not described in 'amdgpu_vm_make_compute'
   drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c:378: warning: Excess function parameter 'entry' description in 'amdgpu_irq_dispatch'
   drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c:379: warning: Function parameter or member 'ih' not described in 'amdgpu_irq_dispatch'
   drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c:379: warning: Excess function parameter 'entry' description in 'amdgpu_irq_dispatch'
   drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c:1: warning: no structured comments found
   drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c:1: warning: no structured comments found
   drivers/gpu/drm/amd/amdgpu/amdgpu_pm.c:1: warning: 'pp_dpm_sclk pp_dpm_mclk pp_dpm_pcie' not found
   drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:131: warning: Incorrect use of kernel-doc format:          * @atomic_obj
   drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:237: warning: Incorrect use of kernel-doc format:          * gpu_info FW provided soc bounding box struct or 0 if not
   drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h:242: warning: Function parameter or member 'atomic_obj' not described in 'amdgpu_display_manager'

vim +1357 include/linux/device.h

^1da177e4c3f415 Linus Torvalds         2005-04-16 @1357  
a4232963757e62b Lars-Peter Clausen     2012-07-03  1358  static inline struct device *kobj_to_dev(struct kobject *kobj)
a4232963757e62b Lars-Peter Clausen     2012-07-03  1359  {
a4232963757e62b Lars-Peter Clausen     2012-07-03  1360  	return container_of(kobj, struct device, kobj);
a4232963757e62b Lars-Peter Clausen     2012-07-03  1361  }
a4232963757e62b Lars-Peter Clausen     2012-07-03  1362  
dbba197edf32209 Joerg Roedel           2018-11-30  1363  /**
dbba197edf32209 Joerg Roedel           2018-11-30  1364   * device_iommu_mapped - Returns true when the device DMA is translated
dbba197edf32209 Joerg Roedel           2018-11-30  1365   *			 by an IOMMU
dbba197edf32209 Joerg Roedel           2018-11-30  1366   * @dev: Device to perform the check on
dbba197edf32209 Joerg Roedel           2018-11-30  1367   */
dbba197edf32209 Joerg Roedel           2018-11-30  1368  static inline bool device_iommu_mapped(struct device *dev)
dbba197edf32209 Joerg Roedel           2018-11-30  1369  {
dbba197edf32209 Joerg Roedel           2018-11-30  1370  	return (dev->iommu_group != NULL);
dbba197edf32209 Joerg Roedel           2018-11-30  1371  }
dbba197edf32209 Joerg Roedel           2018-11-30  1372  
9a3df1f7de0ecaf Alan Stern             2008-03-19  1373  /* Get the wakeup routines, which depend on struct device */
9a3df1f7de0ecaf Alan Stern             2008-03-19  1374  #include <linux/pm_wakeup.h>
9a3df1f7de0ecaf Alan Stern             2008-03-19  1375  
bf9ca69fc8d19d4 Jean Delvare           2008-07-30  1376  static inline const char *dev_name(const struct device *dev)
06916639e2fed9e Kay Sievers            2008-05-02  1377  {
a636ee7fb35b731 Paul Mundt             2010-03-09  1378  	/* Use the init name until the kobject becomes available */
a636ee7fb35b731 Paul Mundt             2010-03-09  1379  	if (dev->init_name)
a636ee7fb35b731 Paul Mundt             2010-03-09  1380  		return dev->init_name;
a636ee7fb35b731 Paul Mundt             2010-03-09  1381  
1fa5ae857bb14f6 Kay Sievers            2009-01-25  1382  	return kobject_name(&dev->kobj);
06916639e2fed9e Kay Sievers            2008-05-02  1383  }
06916639e2fed9e Kay Sievers            2008-05-02  1384  
b9075fa968a0a43 Joe Perches            2011-10-31  1385  extern __printf(2, 3)
b9075fa968a0a43 Joe Perches            2011-10-31  1386  int dev_set_name(struct device *dev, const char *name, ...);
413c239fad68258 Stephen Rothwell       2008-05-30  1387  
873481367edb18a Christoph Hellwig      2006-12-06  1388  #ifdef CONFIG_NUMA
873481367edb18a Christoph Hellwig      2006-12-06  1389  static inline int dev_to_node(struct device *dev)
873481367edb18a Christoph Hellwig      2006-12-06  1390  {
873481367edb18a Christoph Hellwig      2006-12-06  1391  	return dev->numa_node;
873481367edb18a Christoph Hellwig      2006-12-06  1392  }
873481367edb18a Christoph Hellwig      2006-12-06  1393  static inline void set_dev_node(struct device *dev, int node)
873481367edb18a Christoph Hellwig      2006-12-06  1394  {
873481367edb18a Christoph Hellwig      2006-12-06  1395  	dev->numa_node = node;
873481367edb18a Christoph Hellwig      2006-12-06  1396  }
873481367edb18a Christoph Hellwig      2006-12-06  1397  #else
873481367edb18a Christoph Hellwig      2006-12-06  1398  static inline int dev_to_node(struct device *dev)
873481367edb18a Christoph Hellwig      2006-12-06  1399  {
98fa15f34cb3798 Anshuman Khandual      2019-03-05  1400  	return NUMA_NO_NODE;
873481367edb18a Christoph Hellwig      2006-12-06  1401  }
873481367edb18a Christoph Hellwig      2006-12-06  1402  static inline void set_dev_node(struct device *dev, int node)
873481367edb18a Christoph Hellwig      2006-12-06  1403  {
873481367edb18a Christoph Hellwig      2006-12-06  1404  }
873481367edb18a Christoph Hellwig      2006-12-06  1405  #endif
873481367edb18a Christoph Hellwig      2006-12-06  1406  
f1421db8ca4c110 Marc Zyngier           2015-07-28  1407  static inline struct irq_domain *dev_get_msi_domain(const struct device *dev)
f1421db8ca4c110 Marc Zyngier           2015-07-28  1408  {
f1421db8ca4c110 Marc Zyngier           2015-07-28  1409  #ifdef CONFIG_GENERIC_MSI_IRQ_DOMAIN
f1421db8ca4c110 Marc Zyngier           2015-07-28  1410  	return dev->msi_domain;
f1421db8ca4c110 Marc Zyngier           2015-07-28  1411  #else
f1421db8ca4c110 Marc Zyngier           2015-07-28  1412  	return NULL;
f1421db8ca4c110 Marc Zyngier           2015-07-28  1413  #endif
f1421db8ca4c110 Marc Zyngier           2015-07-28  1414  }
f1421db8ca4c110 Marc Zyngier           2015-07-28  1415  
f1421db8ca4c110 Marc Zyngier           2015-07-28  1416  static inline void dev_set_msi_domain(struct device *dev, struct irq_domain *d)
f1421db8ca4c110 Marc Zyngier           2015-07-28  1417  {
f1421db8ca4c110 Marc Zyngier           2015-07-28  1418  #ifdef CONFIG_GENERIC_MSI_IRQ_DOMAIN
f1421db8ca4c110 Marc Zyngier           2015-07-28  1419  	dev->msi_domain = d;
f1421db8ca4c110 Marc Zyngier           2015-07-28  1420  #endif
f1421db8ca4c110 Marc Zyngier           2015-07-28  1421  }
f1421db8ca4c110 Marc Zyngier           2015-07-28  1422  
a996d010b648788 Jean Delvare           2014-04-14  1423  static inline void *dev_get_drvdata(const struct device *dev)
a996d010b648788 Jean Delvare           2014-04-14  1424  {
a996d010b648788 Jean Delvare           2014-04-14  1425  	return dev->driver_data;
a996d010b648788 Jean Delvare           2014-04-14  1426  }
a996d010b648788 Jean Delvare           2014-04-14  1427  
a996d010b648788 Jean Delvare           2014-04-14  1428  static inline void dev_set_drvdata(struct device *dev, void *data)
a996d010b648788 Jean Delvare           2014-04-14  1429  {
a996d010b648788 Jean Delvare           2014-04-14  1430  	dev->driver_data = data;
a996d010b648788 Jean Delvare           2014-04-14  1431  }
a996d010b648788 Jean Delvare           2014-04-14  1432  
5c095a0e0d600d5 Rafael J. Wysocki      2011-08-25  1433  static inline struct pm_subsys_data *dev_to_psd(struct device *dev)
5c095a0e0d600d5 Rafael J. Wysocki      2011-08-25  1434  {
5c095a0e0d600d5 Rafael J. Wysocki      2011-08-25  1435  	return dev ? dev->power.subsys_data : NULL;
5c095a0e0d600d5 Rafael J. Wysocki      2011-08-25  1436  }
5c095a0e0d600d5 Rafael J. Wysocki      2011-08-25  1437  
f67f129e519fa87 Ming Lei               2009-03-01  1438  static inline unsigned int dev_get_uevent_suppress(const struct device *dev)
f67f129e519fa87 Ming Lei               2009-03-01  1439  {
f67f129e519fa87 Ming Lei               2009-03-01  1440  	return dev->kobj.uevent_suppress;
f67f129e519fa87 Ming Lei               2009-03-01  1441  }
f67f129e519fa87 Ming Lei               2009-03-01  1442  
f67f129e519fa87 Ming Lei               2009-03-01  1443  static inline void dev_set_uevent_suppress(struct device *dev, int val)
f67f129e519fa87 Ming Lei               2009-03-01  1444  {
f67f129e519fa87 Ming Lei               2009-03-01  1445  	dev->kobj.uevent_suppress = val;
f67f129e519fa87 Ming Lei               2009-03-01  1446  }
f67f129e519fa87 Ming Lei               2009-03-01  1447  
d305ef5d2a4e77b Daniel Ritz            2005-09-22  1448  static inline int device_is_registered(struct device *dev)
d305ef5d2a4e77b Daniel Ritz            2005-09-22  1449  {
3f62e5700b2a679 Greg Kroah-Hartman     2008-03-13  1450  	return dev->kobj.state_in_sysfs;
d305ef5d2a4e77b Daniel Ritz            2005-09-22  1451  }
d305ef5d2a4e77b Daniel Ritz            2005-09-22  1452  
5af84b82701a96b Rafael J. Wysocki      2010-01-23  1453  static inline void device_enable_async_suspend(struct device *dev)
5af84b82701a96b Rafael J. Wysocki      2010-01-23  1454  {
f76b168b6f117a4 Alan Stern             2011-06-18  1455  	if (!dev->power.is_prepared)
5af84b82701a96b Rafael J. Wysocki      2010-01-23  1456  		dev->power.async_suspend = true;
5af84b82701a96b Rafael J. Wysocki      2010-01-23  1457  }
5af84b82701a96b Rafael J. Wysocki      2010-01-23  1458  
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1459  static inline void device_disable_async_suspend(struct device *dev)
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1460  {
f76b168b6f117a4 Alan Stern             2011-06-18  1461  	if (!dev->power.is_prepared)
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1462  		dev->power.async_suspend = false;
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1463  }
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1464  
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1465  static inline bool device_async_suspend_enabled(struct device *dev)
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1466  {
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1467  	return !!dev->power.async_suspend;
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1468  }
5a2eb8585f3b38e Rafael J. Wysocki      2010-01-23  1469  
85945c28b5a8880 Sudeep Holla           2019-02-14  1470  static inline bool device_pm_not_required(struct device *dev)
85945c28b5a8880 Sudeep Holla           2019-02-14  1471  {
85945c28b5a8880 Sudeep Holla           2019-02-14  1472  	return dev->power.no_pm;
85945c28b5a8880 Sudeep Holla           2019-02-14  1473  }
85945c28b5a8880 Sudeep Holla           2019-02-14  1474  
85945c28b5a8880 Sudeep Holla           2019-02-14  1475  static inline void device_set_pm_not_required(struct device *dev)
85945c28b5a8880 Sudeep Holla           2019-02-14  1476  {
85945c28b5a8880 Sudeep Holla           2019-02-14  1477  	dev->power.no_pm = true;
85945c28b5a8880 Sudeep Holla           2019-02-14  1478  }
85945c28b5a8880 Sudeep Holla           2019-02-14  1479  
feb70af0e3ac681 Rafael J. Wysocki      2012-08-13  1480  static inline void dev_pm_syscore_device(struct device *dev, bool val)
feb70af0e3ac681 Rafael J. Wysocki      2012-08-13  1481  {
feb70af0e3ac681 Rafael J. Wysocki      2012-08-13  1482  #ifdef CONFIG_PM_SLEEP
feb70af0e3ac681 Rafael J. Wysocki      2012-08-13  1483  	dev->power.syscore = val;
feb70af0e3ac681 Rafael J. Wysocki      2012-08-13  1484  #endif
feb70af0e3ac681 Rafael J. Wysocki      2012-08-13  1485  }
feb70af0e3ac681 Rafael J. Wysocki      2012-08-13  1486  
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1487  static inline void dev_pm_set_driver_flags(struct device *dev, u32 flags)
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1488  {
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1489  	dev->power.driver_flags = flags;
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1490  }
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1491  
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1492  static inline bool dev_pm_test_driver_flags(struct device *dev, u32 flags)
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1493  {
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1494  	return !!(dev->power.driver_flags & flags);
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1495  }
08810a4119aaebf Rafael J. Wysocki      2017-10-25  1496  
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1497  static inline void device_lock(struct device *dev)
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1498  {
3142788b7967ccf Thomas Gleixner        2010-01-29  1499  	mutex_lock(&dev->mutex);
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1500  }
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1501  
7dd9cba5bb90ffa Oliver Neukum          2016-01-21  1502  static inline int device_lock_interruptible(struct device *dev)
7dd9cba5bb90ffa Oliver Neukum          2016-01-21  1503  {
7dd9cba5bb90ffa Oliver Neukum          2016-01-21  1504  	return mutex_lock_interruptible(&dev->mutex);
7dd9cba5bb90ffa Oliver Neukum          2016-01-21  1505  }
7dd9cba5bb90ffa Oliver Neukum          2016-01-21  1506  
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1507  static inline int device_trylock(struct device *dev)
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1508  {
3142788b7967ccf Thomas Gleixner        2010-01-29  1509  	return mutex_trylock(&dev->mutex);
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1510  }
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1511  
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1512  static inline void device_unlock(struct device *dev)
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1513  {
3142788b7967ccf Thomas Gleixner        2010-01-29  1514  	mutex_unlock(&dev->mutex);
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1515  }
8e9394ce2412254 Greg Kroah-Hartman     2010-02-17  1516  
ac8010221d3fa86 Konrad Rzeszutek Wilk  2014-12-03  1517  static inline void device_lock_assert(struct device *dev)
ac8010221d3fa86 Konrad Rzeszutek Wilk  2014-12-03  1518  {
ac8010221d3fa86 Konrad Rzeszutek Wilk  2014-12-03  1519  	lockdep_assert_held(&dev->mutex);
ac8010221d3fa86 Konrad Rzeszutek Wilk  2014-12-03  1520  }
ac8010221d3fa86 Konrad Rzeszutek Wilk  2014-12-03  1521  
e8a51e1b51ee573 Benjamin Herrenschmidt 2015-02-17  1522  static inline struct device_node *dev_of_node(struct device *dev)
e8a51e1b51ee573 Benjamin Herrenschmidt 2015-02-17  1523  {
1b833924e5b3cea Stephen Boyd           2019-04-12  1524  	if (!IS_ENABLED(CONFIG_OF) || !dev)
e8a51e1b51ee573 Benjamin Herrenschmidt 2015-02-17  1525  		return NULL;
e8a51e1b51ee573 Benjamin Herrenschmidt 2015-02-17  1526  	return dev->of_node;
e8a51e1b51ee573 Benjamin Herrenschmidt 2015-02-17  1527  }
e8a51e1b51ee573 Benjamin Herrenschmidt 2015-02-17  1528  
1f21782e63da81f Adrian Bunk            2006-12-19  1529  void driver_init(void);
1f21782e63da81f Adrian Bunk            2006-12-19  1530  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1531  /*
^1da177e4c3f415 Linus Torvalds         2005-04-16  1532   * High level routines for use by the bus drivers
^1da177e4c3f415 Linus Torvalds         2005-04-16  1533   */
4a7fb6363f2d1a6 Andrew Morton          2006-08-14  1534  extern int __must_check device_register(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1535  extern void device_unregister(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1536  extern void device_initialize(struct device *dev);
4a7fb6363f2d1a6 Andrew Morton          2006-08-14  1537  extern int __must_check device_add(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1538  extern void device_del(struct device *dev);
d462943afee8bff Greg Kroah-Hartman     2008-01-24  1539  extern int device_for_each_child(struct device *dev, void *data,
d462943afee8bff Greg Kroah-Hartman     2008-01-24  1540  		     int (*fn)(struct device *dev, void *data));
3d060aeb72113cd Andy Shevchenko        2015-07-27  1541  extern int device_for_each_child_reverse(struct device *dev, void *data,
3d060aeb72113cd Andy Shevchenko        2015-07-27  1542  		     int (*fn)(struct device *dev, void *data));
d462943afee8bff Greg Kroah-Hartman     2008-01-24  1543  extern struct device *device_find_child(struct device *dev, void *data,
d462943afee8bff Greg Kroah-Hartman     2008-01-24  1544  				int (*match)(struct device *dev, void *data));
dad9bb017865ae7 Heikki Krogerus        2019-05-31  1545  extern struct device *device_find_child_by_name(struct device *parent,
dad9bb017865ae7 Heikki Krogerus        2019-05-31  1546  						const char *name);
6937e8f8c0135f2 Johannes Berg          2010-08-05  1547  extern int device_rename(struct device *dev, const char *new_name);
ffa6a7054d172a2 Cornelia Huck          2009-03-04  1548  extern int device_move(struct device *dev, struct device *new_parent,
ffa6a7054d172a2 Cornelia Huck          2009-03-04  1549  		       enum dpm_order dpm_order);
e454cea20bdcff1 Kay Sievers            2009-09-18  1550  extern const char *device_get_devnode(struct device *dev,
4e4098a3e08783c Greg Kroah-Hartman     2013-04-11  1551  				      umode_t *mode, kuid_t *uid, kgid_t *gid,
3c2670e6515cf58 Kay Sievers            2013-04-06  1552  				      const char **tmp);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1553  
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1554  static inline bool device_supports_offline(struct device *dev)
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1555  {
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1556  	return dev->bus && dev->bus->offline && dev->bus->online;
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1557  }
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1558  
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1559  extern void lock_device_hotplug(void);
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1560  extern void unlock_device_hotplug(void);
5e33bc4165f3edd Rafael J. Wysocki      2013-08-28  1561  extern int lock_device_hotplug_sysfs(void);
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1562  extern int device_offline(struct device *dev);
4f3549d72d1b5c9 Rafael J. Wysocki      2013-05-02  1563  extern int device_online(struct device *dev);
97badf873ab60e8 Rafael J. Wysocki      2015-04-03  1564  extern void set_primary_fwnode(struct device *dev, struct fwnode_handle *fwnode);
97badf873ab60e8 Rafael J. Wysocki      2015-04-03  1565  extern void set_secondary_fwnode(struct device *dev, struct fwnode_handle *fwnode);
4e75e1d7dac9d7c Johan Hovold           2017-06-06  1566  void device_set_of_node_from_dev(struct device *dev, const struct device *dev2);
97badf873ab60e8 Rafael J. Wysocki      2015-04-03  1567  
9af15c38254d81c Phil Sutter            2017-01-18  1568  static inline int dev_num_vf(struct device *dev)
9af15c38254d81c Phil Sutter            2017-01-18  1569  {
9af15c38254d81c Phil Sutter            2017-01-18  1570  	if (dev->bus && dev->bus->num_vf)
9af15c38254d81c Phil Sutter            2017-01-18  1571  		return dev->bus->num_vf(dev);
9af15c38254d81c Phil Sutter            2017-01-18  1572  	return 0;
9af15c38254d81c Phil Sutter            2017-01-18  1573  }
9af15c38254d81c Phil Sutter            2017-01-18  1574  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1575  /*
0aa0dc41bfd9934 Mark McLoughlin        2008-12-15  1576   * Root device objects for grouping under /sys/devices
0aa0dc41bfd9934 Mark McLoughlin        2008-12-15  1577   */
0aa0dc41bfd9934 Mark McLoughlin        2008-12-15  1578  extern struct device *__root_device_register(const char *name,
0aa0dc41bfd9934 Mark McLoughlin        2008-12-15  1579  					     struct module *owner);
eb5589a8f0dab7e Paul Gortmaker         2011-05-27  1580  
33ac1257ff0dee2 Tejun Heo              2014-01-10  1581  /* This is a macro to avoid include problems with THIS_MODULE */
eb5589a8f0dab7e Paul Gortmaker         2011-05-27  1582  #define root_device_register(name) \
eb5589a8f0dab7e Paul Gortmaker         2011-05-27  1583  	__root_device_register(name, THIS_MODULE)
eb5589a8f0dab7e Paul Gortmaker         2011-05-27  1584  
0aa0dc41bfd9934 Mark McLoughlin        2008-12-15  1585  extern void root_device_unregister(struct device *root);
0aa0dc41bfd9934 Mark McLoughlin        2008-12-15  1586  
a5b8b1ada6dd765 Mark Brown             2009-07-17  1587  static inline void *dev_get_platdata(const struct device *dev)
a5b8b1ada6dd765 Mark Brown             2009-07-17  1588  {
a5b8b1ada6dd765 Mark Brown             2009-07-17  1589  	return dev->platform_data;
a5b8b1ada6dd765 Mark Brown             2009-07-17  1590  }
a5b8b1ada6dd765 Mark Brown             2009-07-17  1591  
0aa0dc41bfd9934 Mark McLoughlin        2008-12-15  1592  /*
^1da177e4c3f415 Linus Torvalds         2005-04-16  1593   * Manual binding of a device to driver. See drivers/base/bus.c
^1da177e4c3f415 Linus Torvalds         2005-04-16  1594   * for information on use.
^1da177e4c3f415 Linus Torvalds         2005-04-16  1595   */
f86db396ff455ed Andrew Morton          2006-08-14  1596  extern int __must_check device_bind_driver(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1597  extern void device_release_driver(struct device *dev);
4a7fb6363f2d1a6 Andrew Morton          2006-08-14  1598  extern int  __must_check device_attach(struct device *dev);
f86db396ff455ed Andrew Morton          2006-08-14  1599  extern int __must_check driver_attach(struct device_driver *drv);
765230b5f084863 Dmitry Torokhov        2015-03-30  1600  extern void device_initial_probe(struct device *dev);
f86db396ff455ed Andrew Morton          2006-08-14  1601  extern int __must_check device_reprobe(struct device *dev);
d4d28915bc4a5db Saravana Kannan        2019-07-29  1602  extern int driver_edit_links(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1603  
6b9cb42752dafba Tomeu Vizoso           2016-01-07  1604  extern bool device_is_bound(struct device *dev);
6b9cb42752dafba Tomeu Vizoso           2016-01-07  1605  
23681e479129854 Greg Kroah-Hartman     2006-06-14  1606  /*
23681e479129854 Greg Kroah-Hartman     2006-06-14  1607   * Easy functions for dynamically creating devices on the fly
23681e479129854 Greg Kroah-Hartman     2006-06-14  1608   */
8db1486065141e6 Nicolas Iooss          2015-07-17  1609  extern __printf(5, 0)
8db1486065141e6 Nicolas Iooss          2015-07-17  1610  struct device *device_create_vargs(struct class *cls, struct device *parent,
8db1486065141e6 Nicolas Iooss          2015-07-17  1611  				   dev_t devt, void *drvdata,
8db1486065141e6 Nicolas Iooss          2015-07-17  1612  				   const char *fmt, va_list vargs);
b9075fa968a0a43 Joe Perches            2011-10-31  1613  extern __printf(5, 6)
b9075fa968a0a43 Joe Perches            2011-10-31  1614  struct device *device_create(struct class *cls, struct device *parent,
4e10673944a5c38 Greg Kroah-Hartman     2008-07-21  1615  			     dev_t devt, void *drvdata,
b9075fa968a0a43 Joe Perches            2011-10-31  1616  			     const char *fmt, ...);
39ef311204941dd Guenter Roeck          2013-07-14  1617  extern __printf(6, 7)
39ef311204941dd Guenter Roeck          2013-07-14  1618  struct device *device_create_with_groups(struct class *cls,
39ef311204941dd Guenter Roeck          2013-07-14  1619  			     struct device *parent, dev_t devt, void *drvdata,
39ef311204941dd Guenter Roeck          2013-07-14  1620  			     const struct attribute_group **groups,
39ef311204941dd Guenter Roeck          2013-07-14  1621  			     const char *fmt, ...);
23681e479129854 Greg Kroah-Hartman     2006-06-14  1622  extern void device_destroy(struct class *cls, dev_t devt);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1623  
a7670d425b75f9e Dmitry Torokhov        2017-07-19  1624  extern int __must_check device_add_groups(struct device *dev,
a7670d425b75f9e Dmitry Torokhov        2017-07-19  1625  					const struct attribute_group **groups);
a7670d425b75f9e Dmitry Torokhov        2017-07-19  1626  extern void device_remove_groups(struct device *dev,
a7670d425b75f9e Dmitry Torokhov        2017-07-19  1627  				 const struct attribute_group **groups);
a7670d425b75f9e Dmitry Torokhov        2017-07-19  1628  
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1629  static inline int __must_check device_add_group(struct device *dev,
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1630  					const struct attribute_group *grp)
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1631  {
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1632  	const struct attribute_group *groups[] = { grp, NULL };
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1633  
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1634  	return device_add_groups(dev, groups);
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1635  }
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1636  
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1637  static inline void device_remove_group(struct device *dev,
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1638  				       const struct attribute_group *grp)
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1639  {
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1640  	const struct attribute_group *groups[] = { grp, NULL };
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1641  
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1642  	return device_remove_groups(dev, groups);
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1643  }
e323b2dddc1ce7e Dmitry Torokhov        2017-07-19  1644  
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1645  extern int __must_check devm_device_add_groups(struct device *dev,
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1646  					const struct attribute_group **groups);
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1647  extern void devm_device_remove_groups(struct device *dev,
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1648  				      const struct attribute_group **groups);
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1649  extern int __must_check devm_device_add_group(struct device *dev,
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1650  					const struct attribute_group *grp);
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1651  extern void devm_device_remove_group(struct device *dev,
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1652  				     const struct attribute_group *grp);
57b8ff070f9897b Dmitry Torokhov        2017-07-19  1653  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1654  /*
^1da177e4c3f415 Linus Torvalds         2005-04-16  1655   * Platform "fixup" functions - allow the platform to have their say
^1da177e4c3f415 Linus Torvalds         2005-04-16  1656   * about devices and actions that the general device layer doesn't
^1da177e4c3f415 Linus Torvalds         2005-04-16  1657   * know about.
^1da177e4c3f415 Linus Torvalds         2005-04-16  1658   */
^1da177e4c3f415 Linus Torvalds         2005-04-16  1659  /* Notify platform of device discovery */
^1da177e4c3f415 Linus Torvalds         2005-04-16  1660  extern int (*platform_notify)(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1661  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1662  extern int (*platform_notify_remove)(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1663  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1664  
880ffb5c6c5c8c8 Wanlong Gao            2011-05-05  1665  /*
^1da177e4c3f415 Linus Torvalds         2005-04-16  1666   * get_device - atomically increment the reference count for the device.
^1da177e4c3f415 Linus Torvalds         2005-04-16  1667   *
^1da177e4c3f415 Linus Torvalds         2005-04-16  1668   */
^1da177e4c3f415 Linus Torvalds         2005-04-16  1669  extern struct device *get_device(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1670  extern void put_device(struct device *dev);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1671  
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1672  #ifdef CONFIG_DEVTMPFS
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1673  extern int devtmpfs_create_node(struct device *dev);
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1674  extern int devtmpfs_delete_node(struct device *dev);
073120cc28ad9f6 Kay Sievers            2009-10-28  1675  extern int devtmpfs_mount(const char *mntdir);
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1676  #else
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1677  static inline int devtmpfs_create_node(struct device *dev) { return 0; }
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1678  static inline int devtmpfs_delete_node(struct device *dev) { return 0; }
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1679  static inline int devtmpfs_mount(const char *mountpoint) { return 0; }
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1680  #endif
2b2af54a5bb6f7e Kay Sievers            2009-04-30  1681  
116f232b3794a8b Rytchkov Alexey        2006-03-22  1682  /* drivers/base/power/shutdown.c */
^1da177e4c3f415 Linus Torvalds         2005-04-16  1683  extern void device_shutdown(void);
^1da177e4c3f415 Linus Torvalds         2005-04-16  1684  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1685  /* debugging and troubleshooting/diagnostic helpers. */
bf9ca69fc8d19d4 Jean Delvare           2008-07-30  1686  extern const char *dev_driver_string(const struct device *dev);
99bcf217183e02e Joe Perches            2010-06-27  1687  
9ed9895370aedd6 Rafael J. Wysocki      2016-10-30  1688  /* Device links interface. */
9ed9895370aedd6 Rafael J. Wysocki      2016-10-30  1689  struct device_link *device_link_add(struct device *consumer,
9ed9895370aedd6 Rafael J. Wysocki      2016-10-30  1690  				    struct device *supplier, u32 flags);
9ed9895370aedd6 Rafael J. Wysocki      2016-10-30  1691  void device_link_del(struct device_link *link);
d8842211b6f63d3 pascal paillet         2018-07-05  1692  void device_link_remove(void *consumer, struct device *supplier);
d4d28915bc4a5db Saravana Kannan        2019-07-29  1693  void device_link_remove_from_wfs(struct device *consumer);
46c5ea62709238d Saravana Kannan        2019-07-29  1694  void device_links_supplier_sync_state_pause(void);
46c5ea62709238d Saravana Kannan        2019-07-29  1695  void device_links_supplier_sync_state_resume(void);
99bcf217183e02e Joe Perches            2010-06-27  1696  
663336ee2628096 Joe Perches            2018-05-09  1697  #ifndef dev_fmt
663336ee2628096 Joe Perches            2018-05-09  1698  #define dev_fmt(fmt) fmt
663336ee2628096 Joe Perches            2018-05-09  1699  #endif
663336ee2628096 Joe Perches            2018-05-09  1700  
99bcf217183e02e Joe Perches            2010-06-27  1701  #ifdef CONFIG_PRINTK
99bcf217183e02e Joe Perches            2010-06-27  1702  
79a4e91d1bb2a41 Joe Perches            2019-02-02  1703  __printf(3, 0) __cold
0a18b05043acc01 Joe Perches            2012-09-25  1704  int dev_vprintk_emit(int level, const struct device *dev,
05e4e5b87aab74f Joe Perches            2012-09-12  1705  		     const char *fmt, va_list args);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1706  __printf(3, 4) __cold
05e4e5b87aab74f Joe Perches            2012-09-12  1707  int dev_printk_emit(int level, const struct device *dev, const char *fmt, ...);
798efc60e427682 Joe Perches            2012-09-12  1708  
79a4e91d1bb2a41 Joe Perches            2019-02-02  1709  __printf(3, 4) __cold
d1f1052c5204524 Joe Perches            2014-12-25  1710  void dev_printk(const char *level, const struct device *dev,
798efc60e427682 Joe Perches            2012-09-12  1711  		const char *fmt, ...);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1712  __printf(2, 3) __cold
663336ee2628096 Joe Perches            2018-05-09  1713  void _dev_emerg(const struct device *dev, const char *fmt, ...);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1714  __printf(2, 3) __cold
663336ee2628096 Joe Perches            2018-05-09  1715  void _dev_alert(const struct device *dev, const char *fmt, ...);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1716  __printf(2, 3) __cold
663336ee2628096 Joe Perches            2018-05-09  1717  void _dev_crit(const struct device *dev, const char *fmt, ...);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1718  __printf(2, 3) __cold
663336ee2628096 Joe Perches            2018-05-09  1719  void _dev_err(const struct device *dev, const char *fmt, ...);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1720  __printf(2, 3) __cold
663336ee2628096 Joe Perches            2018-05-09  1721  void _dev_warn(const struct device *dev, const char *fmt, ...);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1722  __printf(2, 3) __cold
663336ee2628096 Joe Perches            2018-05-09  1723  void _dev_notice(const struct device *dev, const char *fmt, ...);
79a4e91d1bb2a41 Joe Perches            2019-02-02  1724  __printf(2, 3) __cold
d1f1052c5204524 Joe Perches            2014-12-25  1725  void _dev_info(const struct device *dev, const char *fmt, ...);
99bcf217183e02e Joe Perches            2010-06-27  1726  
99bcf217183e02e Joe Perches            2010-06-27  1727  #else
99bcf217183e02e Joe Perches            2010-06-27  1728  
0a18b05043acc01 Joe Perches            2012-09-25  1729  static inline __printf(3, 0)
0a18b05043acc01 Joe Perches            2012-09-25  1730  int dev_vprintk_emit(int level, const struct device *dev,
05e4e5b87aab74f Joe Perches            2012-09-12  1731  		     const char *fmt, va_list args)
05e4e5b87aab74f Joe Perches            2012-09-12  1732  { return 0; }
05e4e5b87aab74f Joe Perches            2012-09-12  1733  static inline __printf(3, 4)
05e4e5b87aab74f Joe Perches            2012-09-12  1734  int dev_printk_emit(int level, const struct device *dev, const char *fmt, ...)
05e4e5b87aab74f Joe Perches            2012-09-12  1735  { return 0; }
05e4e5b87aab74f Joe Perches            2012-09-12  1736  
d1f1052c5204524 Joe Perches            2014-12-25  1737  static inline void __dev_printk(const char *level, const struct device *dev,
cbc4663552ee476 Joe Perches            2011-08-11  1738  				struct va_format *vaf)
d1f1052c5204524 Joe Perches            2014-12-25  1739  {}
b9075fa968a0a43 Joe Perches            2011-10-31  1740  static inline __printf(3, 4)
d1f1052c5204524 Joe Perches            2014-12-25  1741  void dev_printk(const char *level, const struct device *dev,
99bcf217183e02e Joe Perches            2010-06-27  1742  		 const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1743  {}
99bcf217183e02e Joe Perches            2010-06-27  1744  
b9075fa968a0a43 Joe Perches            2011-10-31  1745  static inline __printf(2, 3)
663336ee2628096 Joe Perches            2018-05-09  1746  void _dev_emerg(const struct device *dev, const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1747  {}
b9075fa968a0a43 Joe Perches            2011-10-31  1748  static inline __printf(2, 3)
663336ee2628096 Joe Perches            2018-05-09  1749  void _dev_crit(const struct device *dev, const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1750  {}
b9075fa968a0a43 Joe Perches            2011-10-31  1751  static inline __printf(2, 3)
663336ee2628096 Joe Perches            2018-05-09  1752  void _dev_alert(const struct device *dev, const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1753  {}
b9075fa968a0a43 Joe Perches            2011-10-31  1754  static inline __printf(2, 3)
663336ee2628096 Joe Perches            2018-05-09  1755  void _dev_err(const struct device *dev, const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1756  {}
b9075fa968a0a43 Joe Perches            2011-10-31  1757  static inline __printf(2, 3)
663336ee2628096 Joe Perches            2018-05-09  1758  void _dev_warn(const struct device *dev, const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1759  {}
b9075fa968a0a43 Joe Perches            2011-10-31  1760  static inline __printf(2, 3)
663336ee2628096 Joe Perches            2018-05-09  1761  void _dev_notice(const struct device *dev, const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1762  {}
b9075fa968a0a43 Joe Perches            2011-10-31  1763  static inline __printf(2, 3)
d1f1052c5204524 Joe Perches            2014-12-25  1764  void _dev_info(const struct device *dev, const char *fmt, ...)
d1f1052c5204524 Joe Perches            2014-12-25  1765  {}
99bcf217183e02e Joe Perches            2010-06-27  1766  
99bcf217183e02e Joe Perches            2010-06-27  1767  #endif
99bcf217183e02e Joe Perches            2010-06-27  1768  
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1769  /*
663336ee2628096 Joe Perches            2018-05-09  1770   * #defines for all the dev_<level> macros to prefix with whatever
663336ee2628096 Joe Perches            2018-05-09  1771   * possible use of #define dev_fmt(fmt) ...
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1772   */
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1773  
663336ee2628096 Joe Perches            2018-05-09  1774  #define dev_emerg(dev, fmt, ...)					\
663336ee2628096 Joe Perches            2018-05-09  1775  	_dev_emerg(dev, dev_fmt(fmt), ##__VA_ARGS__)
663336ee2628096 Joe Perches            2018-05-09  1776  #define dev_crit(dev, fmt, ...)						\
663336ee2628096 Joe Perches            2018-05-09  1777  	_dev_crit(dev, dev_fmt(fmt), ##__VA_ARGS__)
663336ee2628096 Joe Perches            2018-05-09  1778  #define dev_alert(dev, fmt, ...)					\
663336ee2628096 Joe Perches            2018-05-09  1779  	_dev_alert(dev, dev_fmt(fmt), ##__VA_ARGS__)
663336ee2628096 Joe Perches            2018-05-09  1780  #define dev_err(dev, fmt, ...)						\
663336ee2628096 Joe Perches            2018-05-09  1781  	_dev_err(dev, dev_fmt(fmt), ##__VA_ARGS__)
663336ee2628096 Joe Perches            2018-05-09  1782  #define dev_warn(dev, fmt, ...)						\
663336ee2628096 Joe Perches            2018-05-09  1783  	_dev_warn(dev, dev_fmt(fmt), ##__VA_ARGS__)
663336ee2628096 Joe Perches            2018-05-09  1784  #define dev_notice(dev, fmt, ...)					\
663336ee2628096 Joe Perches            2018-05-09  1785  	_dev_notice(dev, dev_fmt(fmt), ##__VA_ARGS__)
663336ee2628096 Joe Perches            2018-05-09  1786  #define dev_info(dev, fmt, ...)						\
663336ee2628096 Joe Perches            2018-05-09  1787  	_dev_info(dev, dev_fmt(fmt), ##__VA_ARGS__)
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1788  
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1789  #if defined(CONFIG_DYNAMIC_DEBUG)
663336ee2628096 Joe Perches            2018-05-09  1790  #define dev_dbg(dev, fmt, ...)						\
663336ee2628096 Joe Perches            2018-05-09  1791  	dynamic_dev_dbg(dev, dev_fmt(fmt), ##__VA_ARGS__)
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1792  #elif defined(DEBUG)
663336ee2628096 Joe Perches            2018-05-09  1793  #define dev_dbg(dev, fmt, ...)						\
663336ee2628096 Joe Perches            2018-05-09  1794  	dev_printk(KERN_DEBUG, dev, dev_fmt(fmt), ##__VA_ARGS__)
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1795  #else
663336ee2628096 Joe Perches            2018-05-09  1796  #define dev_dbg(dev, fmt, ...)						\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1797  ({									\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1798  	if (0)								\
663336ee2628096 Joe Perches            2018-05-09  1799  		dev_printk(KERN_DEBUG, dev, dev_fmt(fmt), ##__VA_ARGS__); \
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1800  })
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1801  #endif
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1802  
e135303bd5bebcd Joe Perches            2014-11-17  1803  #ifdef CONFIG_PRINTK
e135303bd5bebcd Joe Perches            2014-11-17  1804  #define dev_level_once(dev_level, dev, fmt, ...)			\
e135303bd5bebcd Joe Perches            2014-11-17  1805  do {									\
e135303bd5bebcd Joe Perches            2014-11-17  1806  	static bool __print_once __read_mostly;				\
e135303bd5bebcd Joe Perches            2014-11-17  1807  									\
e135303bd5bebcd Joe Perches            2014-11-17  1808  	if (!__print_once) {						\
e135303bd5bebcd Joe Perches            2014-11-17  1809  		__print_once = true;					\
e135303bd5bebcd Joe Perches            2014-11-17  1810  		dev_level(dev, fmt, ##__VA_ARGS__);			\
e135303bd5bebcd Joe Perches            2014-11-17  1811  	}								\
e135303bd5bebcd Joe Perches            2014-11-17  1812  } while (0)
e135303bd5bebcd Joe Perches            2014-11-17  1813  #else
e135303bd5bebcd Joe Perches            2014-11-17  1814  #define dev_level_once(dev_level, dev, fmt, ...)			\
e135303bd5bebcd Joe Perches            2014-11-17  1815  do {									\
e135303bd5bebcd Joe Perches            2014-11-17  1816  	if (0)								\
e135303bd5bebcd Joe Perches            2014-11-17  1817  		dev_level(dev, fmt, ##__VA_ARGS__);			\
e135303bd5bebcd Joe Perches            2014-11-17  1818  } while (0)
e135303bd5bebcd Joe Perches            2014-11-17  1819  #endif
e135303bd5bebcd Joe Perches            2014-11-17  1820  
e135303bd5bebcd Joe Perches            2014-11-17  1821  #define dev_emerg_once(dev, fmt, ...)					\
e135303bd5bebcd Joe Perches            2014-11-17  1822  	dev_level_once(dev_emerg, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1823  #define dev_alert_once(dev, fmt, ...)					\
e135303bd5bebcd Joe Perches            2014-11-17  1824  	dev_level_once(dev_alert, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1825  #define dev_crit_once(dev, fmt, ...)					\
e135303bd5bebcd Joe Perches            2014-11-17  1826  	dev_level_once(dev_crit, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1827  #define dev_err_once(dev, fmt, ...)					\
e135303bd5bebcd Joe Perches            2014-11-17  1828  	dev_level_once(dev_err, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1829  #define dev_warn_once(dev, fmt, ...)					\
e135303bd5bebcd Joe Perches            2014-11-17  1830  	dev_level_once(dev_warn, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1831  #define dev_notice_once(dev, fmt, ...)					\
e135303bd5bebcd Joe Perches            2014-11-17  1832  	dev_level_once(dev_notice, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1833  #define dev_info_once(dev, fmt, ...)					\
e135303bd5bebcd Joe Perches            2014-11-17  1834  	dev_level_once(dev_info, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1835  #define dev_dbg_once(dev, fmt, ...)					\
a2a15d54ab2d5c8 Joe Perches            2015-01-03  1836  	dev_level_once(dev_dbg, dev, fmt, ##__VA_ARGS__)
e135303bd5bebcd Joe Perches            2014-11-17  1837  
6ca045930338485 Hiroshi DOYU           2012-05-14  1838  #define dev_level_ratelimited(dev_level, dev, fmt, ...)			\
6ca045930338485 Hiroshi DOYU           2012-05-14  1839  do {									\
6ca045930338485 Hiroshi DOYU           2012-05-14  1840  	static DEFINE_RATELIMIT_STATE(_rs,				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1841  				      DEFAULT_RATELIMIT_INTERVAL,	\
6ca045930338485 Hiroshi DOYU           2012-05-14  1842  				      DEFAULT_RATELIMIT_BURST);		\
6ca045930338485 Hiroshi DOYU           2012-05-14  1843  	if (__ratelimit(&_rs))						\
6ca045930338485 Hiroshi DOYU           2012-05-14  1844  		dev_level(dev, fmt, ##__VA_ARGS__);			\
6ca045930338485 Hiroshi DOYU           2012-05-14  1845  } while (0)
6ca045930338485 Hiroshi DOYU           2012-05-14  1846  
6ca045930338485 Hiroshi DOYU           2012-05-14  1847  #define dev_emerg_ratelimited(dev, fmt, ...)				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1848  	dev_level_ratelimited(dev_emerg, dev, fmt, ##__VA_ARGS__)
6ca045930338485 Hiroshi DOYU           2012-05-14  1849  #define dev_alert_ratelimited(dev, fmt, ...)				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1850  	dev_level_ratelimited(dev_alert, dev, fmt, ##__VA_ARGS__)
6ca045930338485 Hiroshi DOYU           2012-05-14  1851  #define dev_crit_ratelimited(dev, fmt, ...)				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1852  	dev_level_ratelimited(dev_crit, dev, fmt, ##__VA_ARGS__)
6ca045930338485 Hiroshi DOYU           2012-05-14  1853  #define dev_err_ratelimited(dev, fmt, ...)				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1854  	dev_level_ratelimited(dev_err, dev, fmt, ##__VA_ARGS__)
6ca045930338485 Hiroshi DOYU           2012-05-14  1855  #define dev_warn_ratelimited(dev, fmt, ...)				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1856  	dev_level_ratelimited(dev_warn, dev, fmt, ##__VA_ARGS__)
6ca045930338485 Hiroshi DOYU           2012-05-14  1857  #define dev_notice_ratelimited(dev, fmt, ...)				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1858  	dev_level_ratelimited(dev_notice, dev, fmt, ##__VA_ARGS__)
6ca045930338485 Hiroshi DOYU           2012-05-14  1859  #define dev_info_ratelimited(dev, fmt, ...)				\
6ca045930338485 Hiroshi DOYU           2012-05-14  1860  	dev_level_ratelimited(dev_info, dev, fmt, ##__VA_ARGS__)
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1861  #if defined(CONFIG_DYNAMIC_DEBUG)
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1862  /* descriptor check is first to prevent flooding with "callbacks suppressed" */
6ca045930338485 Hiroshi DOYU           2012-05-14  1863  #define dev_dbg_ratelimited(dev, fmt, ...)				\
99bcf217183e02e Joe Perches            2010-06-27  1864  do {									\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1865  	static DEFINE_RATELIMIT_STATE(_rs,				\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1866  				      DEFAULT_RATELIMIT_INTERVAL,	\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1867  				      DEFAULT_RATELIMIT_BURST);		\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1868  	DEFINE_DYNAMIC_DEBUG_METADATA(descriptor, fmt);			\
e0b73d7beb919ad Rasmus Villemoes       2019-03-07  1869  	if (DYNAMIC_DEBUG_BRANCH(descriptor) &&				\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1870  	    __ratelimit(&_rs))						\
663336ee2628096 Joe Perches            2018-05-09  1871  		__dynamic_dev_dbg(&descriptor, dev, dev_fmt(fmt),	\
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1872  				  ##__VA_ARGS__);			\
346e15beb5343c2 Jason Baron            2008-08-12  1873  } while (0)
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1874  #elif defined(DEBUG)
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1875  #define dev_dbg_ratelimited(dev, fmt, ...)				\
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1876  do {									\
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1877  	static DEFINE_RATELIMIT_STATE(_rs,				\
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1878  				      DEFAULT_RATELIMIT_INTERVAL,	\
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1879  				      DEFAULT_RATELIMIT_BURST);		\
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1880  	if (__ratelimit(&_rs))						\
663336ee2628096 Joe Perches            2018-05-09  1881  		dev_printk(KERN_DEBUG, dev, dev_fmt(fmt), ##__VA_ARGS__); \
8ef2d6511f7eba8 Dmitry Kasatkin        2013-08-27  1882  } while (0)
^1da177e4c3f415 Linus Torvalds         2005-04-16  1883  #else
6f586e663e3b367 Hiroshi Doyu           2012-09-04  1884  #define dev_dbg_ratelimited(dev, fmt, ...)				\
1f62ff34a90471d Arnd Bergmann          2016-03-24  1885  do {									\
1f62ff34a90471d Arnd Bergmann          2016-03-24  1886  	if (0)								\
663336ee2628096 Joe Perches            2018-05-09  1887  		dev_printk(KERN_DEBUG, dev, dev_fmt(fmt), ##__VA_ARGS__); \
1f62ff34a90471d Arnd Bergmann          2016-03-24  1888  } while (0)
^1da177e4c3f415 Linus Torvalds         2005-04-16  1889  #endif
^1da177e4c3f415 Linus Torvalds         2005-04-16  1890  
aebdc3b450a3feb David Brownell         2007-07-12  1891  #ifdef VERBOSE_DEBUG
aebdc3b450a3feb David Brownell         2007-07-12  1892  #define dev_vdbg	dev_dbg
aebdc3b450a3feb David Brownell         2007-07-12  1893  #else
663336ee2628096 Joe Perches            2018-05-09  1894  #define dev_vdbg(dev, fmt, ...)						\
99bcf217183e02e Joe Perches            2010-06-27  1895  ({									\
99bcf217183e02e Joe Perches            2010-06-27  1896  	if (0)								\
663336ee2628096 Joe Perches            2018-05-09  1897  		dev_printk(KERN_DEBUG, dev, dev_fmt(fmt), ##__VA_ARGS__); \
99bcf217183e02e Joe Perches            2010-06-27  1898  })
aebdc3b450a3feb David Brownell         2007-07-12  1899  #endif
aebdc3b450a3feb David Brownell         2007-07-12  1900  
e61396627f91abb Arjan van de Ven       2008-09-20  1901  /*
3eae13671716492 Bjorn Helgaas          2013-10-24  1902   * dev_WARN*() acts like dev_printk(), but with the key difference of
3eae13671716492 Bjorn Helgaas          2013-10-24  1903   * using WARN/WARN_ONCE to include file/line information and a backtrace.
e61396627f91abb Arjan van de Ven       2008-09-20  1904   */
e61396627f91abb Arjan van de Ven       2008-09-20  1905  #define dev_WARN(dev, format, arg...) \
3eae13671716492 Bjorn Helgaas          2013-10-24  1906  	WARN(1, "%s %s: " format, dev_driver_string(dev), dev_name(dev), ## arg);
e61396627f91abb Arjan van de Ven       2008-09-20  1907  
bcdd323b893ad3c Felipe Balbi           2011-03-16  1908  #define dev_WARN_ONCE(dev, condition, format, arg...) \
3eae13671716492 Bjorn Helgaas          2013-10-24  1909  	WARN_ONCE(condition, "%s %s: " format, \
3eae13671716492 Bjorn Helgaas          2013-10-24  1910  			dev_driver_string(dev), dev_name(dev), ## arg)
bcdd323b893ad3c Felipe Balbi           2011-03-16  1911  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1912  /* Create alias, so I can be autoloaded. */
^1da177e4c3f415 Linus Torvalds         2005-04-16  1913  #define MODULE_ALIAS_CHARDEV(major,minor) \
^1da177e4c3f415 Linus Torvalds         2005-04-16  1914  	MODULE_ALIAS("char-major-" __stringify(major) "-" __stringify(minor))
^1da177e4c3f415 Linus Torvalds         2005-04-16  1915  #define MODULE_ALIAS_CHARDEV_MAJOR(major) \
^1da177e4c3f415 Linus Torvalds         2005-04-16  1916  	MODULE_ALIAS("char-major-" __stringify(major) "-*")
e52eec13cd6b7f3 Andi Kleen             2010-09-08  1917  
e52eec13cd6b7f3 Andi Kleen             2010-09-08  1918  #ifdef CONFIG_SYSFS_DEPRECATED
e52eec13cd6b7f3 Andi Kleen             2010-09-08  1919  extern long sysfs_deprecated;
e52eec13cd6b7f3 Andi Kleen             2010-09-08  1920  #else
e52eec13cd6b7f3 Andi Kleen             2010-09-08  1921  #define sysfs_deprecated 0
e52eec13cd6b7f3 Andi Kleen             2010-09-08  1922  #endif
e52eec13cd6b7f3 Andi Kleen             2010-09-08  1923  
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1924  /**
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1925   * module_driver() - Helper macro for drivers that don't do anything
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1926   * special in module init/exit. This eliminates a lot of boilerplate.
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1927   * Each module may only use this macro once, and calling it replaces
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1928   * module_init() and module_exit().
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1929   *
2eda013f4894bc2 Randy Dunlap           2012-01-21  1930   * @__driver: driver name
2eda013f4894bc2 Randy Dunlap           2012-01-21  1931   * @__register: register function for this driver type
2eda013f4894bc2 Randy Dunlap           2012-01-21  1932   * @__unregister: unregister function for this driver type
cd4946188aac597 Lars-Peter Clausen     2012-02-25  1933   * @...: Additional arguments to be passed to __register and __unregister.
2eda013f4894bc2 Randy Dunlap           2012-01-21  1934   *
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1935   * Use this macro to construct bus specific macros for registering
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1936   * drivers, and do not use it on its own.
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1937   */
cd4946188aac597 Lars-Peter Clausen     2012-02-25  1938  #define module_driver(__driver, __register, __unregister, ...) \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1939  static int __init __driver##_init(void) \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1940  { \
cd4946188aac597 Lars-Peter Clausen     2012-02-25  1941  	return __register(&(__driver) , ##__VA_ARGS__); \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1942  } \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1943  module_init(__driver##_init); \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1944  static void __exit __driver##_exit(void) \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1945  { \
cd4946188aac597 Lars-Peter Clausen     2012-02-25  1946  	__unregister(&(__driver) , ##__VA_ARGS__); \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1947  } \
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1948  module_exit(__driver##_exit);
907d0ed1c84114d Lars-Peter Clausen     2011-11-16  1949  
f309d4443130bf8 Paul Gortmaker         2015-05-01  1950  /**
f309d4443130bf8 Paul Gortmaker         2015-05-01  1951   * builtin_driver() - Helper macro for drivers that don't do anything
f309d4443130bf8 Paul Gortmaker         2015-05-01  1952   * special in init and have no exit. This eliminates some boilerplate.
f309d4443130bf8 Paul Gortmaker         2015-05-01  1953   * Each driver may only use this macro once, and calling it replaces
f309d4443130bf8 Paul Gortmaker         2015-05-01  1954   * device_initcall (or in some cases, the legacy __initcall).  This is
f309d4443130bf8 Paul Gortmaker         2015-05-01  1955   * meant to be a direct parallel of module_driver() above but without
f309d4443130bf8 Paul Gortmaker         2015-05-01  1956   * the __exit stuff that is not used for builtin cases.
f309d4443130bf8 Paul Gortmaker         2015-05-01  1957   *
f309d4443130bf8 Paul Gortmaker         2015-05-01  1958   * @__driver: driver name
f309d4443130bf8 Paul Gortmaker         2015-05-01  1959   * @__register: register function for this driver type
f309d4443130bf8 Paul Gortmaker         2015-05-01  1960   * @...: Additional arguments to be passed to __register
f309d4443130bf8 Paul Gortmaker         2015-05-01  1961   *
f309d4443130bf8 Paul Gortmaker         2015-05-01  1962   * Use this macro to construct bus specific macros for registering
f309d4443130bf8 Paul Gortmaker         2015-05-01  1963   * drivers, and do not use it on its own.
f309d4443130bf8 Paul Gortmaker         2015-05-01  1964   */
f309d4443130bf8 Paul Gortmaker         2015-05-01  1965  #define builtin_driver(__driver, __register, ...) \
f309d4443130bf8 Paul Gortmaker         2015-05-01  1966  static int __init __driver##_init(void) \
f309d4443130bf8 Paul Gortmaker         2015-05-01  1967  { \
f309d4443130bf8 Paul Gortmaker         2015-05-01  1968  	return __register(&(__driver) , ##__VA_ARGS__); \
f309d4443130bf8 Paul Gortmaker         2015-05-01  1969  } \
f309d4443130bf8 Paul Gortmaker         2015-05-01  1970  device_initcall(__driver##_init);
f309d4443130bf8 Paul Gortmaker         2015-05-01  1971  
^1da177e4c3f415 Linus Torvalds         2005-04-16  1972  #endif /* _DEVICE_H_ */

:::::: The code at line 1357 was first introduced by commit
:::::: 1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 Linux-2.6.12-rc2

:::::: TO: Linus Torvalds <torvalds at ppc970.osdl.org>
:::::: CC: Linus Torvalds <torvalds at ppc970.osdl.org>

---
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: 7283 bytes
Desc: not available
URL: <http://driverdev.linuxdriverproject.org/pipermail/driverdev-devel/attachments/20190801/20b5fd3f/attachment-0001.bin>

^ permalink raw reply	[flat|nested] 2+ messages in thread