.clang-format 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505
  1. # SPDX-License-Identifier: GPL-2.0
  2. #
  3. # clang-format configuration file. Intended for clang-format >= 4.
  4. #
  5. # For more information, see:
  6. #
  7. # Documentation/process/clang-format.rst
  8. # https://clang.llvm.org/docs/ClangFormat.html
  9. # https://clang.llvm.org/docs/ClangFormatStyleOptions.html
  10. #
  11. ---
  12. AccessModifierOffset: -4
  13. AlignAfterOpenBracket: Align
  14. AlignConsecutiveAssignments: false
  15. AlignConsecutiveDeclarations: false
  16. #AlignEscapedNewlines: Left # Unknown to clang-format-4.0
  17. AlignOperands: true
  18. AlignTrailingComments: false
  19. AllowAllParametersOfDeclarationOnNextLine: false
  20. AllowShortBlocksOnASingleLine: false
  21. AllowShortCaseLabelsOnASingleLine: false
  22. AllowShortFunctionsOnASingleLine: None
  23. AllowShortIfStatementsOnASingleLine: false
  24. AllowShortLoopsOnASingleLine: false
  25. AlwaysBreakAfterDefinitionReturnType: None
  26. AlwaysBreakAfterReturnType: None
  27. AlwaysBreakBeforeMultilineStrings: false
  28. AlwaysBreakTemplateDeclarations: false
  29. BinPackArguments: true
  30. BinPackParameters: true
  31. BraceWrapping:
  32. AfterClass: false
  33. AfterControlStatement: false
  34. AfterEnum: false
  35. AfterFunction: true
  36. AfterNamespace: true
  37. AfterObjCDeclaration: false
  38. AfterStruct: false
  39. AfterUnion: false
  40. #AfterExternBlock: false # Unknown to clang-format-5.0
  41. BeforeCatch: false
  42. BeforeElse: false
  43. IndentBraces: false
  44. #SplitEmptyFunction: true # Unknown to clang-format-4.0
  45. #SplitEmptyRecord: true # Unknown to clang-format-4.0
  46. #SplitEmptyNamespace: true # Unknown to clang-format-4.0
  47. BreakBeforeBinaryOperators: None
  48. BreakBeforeBraces: Custom
  49. #BreakBeforeInheritanceComma: false # Unknown to clang-format-4.0
  50. BreakBeforeTernaryOperators: false
  51. BreakConstructorInitializersBeforeComma: false
  52. #BreakConstructorInitializers: BeforeComma # Unknown to clang-format-4.0
  53. BreakAfterJavaFieldAnnotations: false
  54. BreakStringLiterals: false
  55. ColumnLimit: 80
  56. CommentPragmas: '^ IWYU pragma:'
  57. #CompactNamespaces: false # Unknown to clang-format-4.0
  58. ConstructorInitializerAllOnOneLineOrOnePerLine: false
  59. ConstructorInitializerIndentWidth: 8
  60. ContinuationIndentWidth: 8
  61. Cpp11BracedListStyle: false
  62. DerivePointerAlignment: false
  63. DisableFormat: false
  64. ExperimentalAutoDetectBinPacking: false
  65. #FixNamespaceComments: false # Unknown to clang-format-4.0
  66. # Taken from:
  67. # git grep -h '^#define [^[:space:]]*for_each[^[:space:]]*(' include/ \
  68. # | sed "s,^#define \([^[:space:]]*for_each[^[:space:]]*\)(.*$, - '\1'," \
  69. # | sort | uniq
  70. ForEachMacros:
  71. - 'apei_estatus_for_each_section'
  72. - 'ata_for_each_dev'
  73. - 'ata_for_each_link'
  74. - '__ata_qc_for_each'
  75. - 'ata_qc_for_each'
  76. - 'ata_qc_for_each_raw'
  77. - 'ata_qc_for_each_with_internal'
  78. - 'ax25_for_each'
  79. - 'ax25_uid_for_each'
  80. - '__bio_for_each_bvec'
  81. - 'bio_for_each_bvec'
  82. - 'bio_for_each_integrity_vec'
  83. - '__bio_for_each_segment'
  84. - 'bio_for_each_segment'
  85. - 'bio_for_each_segment_all'
  86. - 'bio_list_for_each'
  87. - 'bip_for_each_vec'
  88. - 'blkg_for_each_descendant_post'
  89. - 'blkg_for_each_descendant_pre'
  90. - 'blk_queue_for_each_rl'
  91. - 'bond_for_each_slave'
  92. - 'bond_for_each_slave_rcu'
  93. - 'bpf_for_each_spilled_reg'
  94. - 'btree_for_each_safe128'
  95. - 'btree_for_each_safe32'
  96. - 'btree_for_each_safe64'
  97. - 'btree_for_each_safel'
  98. - 'card_for_each_dev'
  99. - 'cgroup_taskset_for_each'
  100. - 'cgroup_taskset_for_each_leader'
  101. - 'cpufreq_for_each_entry'
  102. - 'cpufreq_for_each_entry_idx'
  103. - 'cpufreq_for_each_valid_entry'
  104. - 'cpufreq_for_each_valid_entry_idx'
  105. - 'css_for_each_child'
  106. - 'css_for_each_descendant_post'
  107. - 'css_for_each_descendant_pre'
  108. - 'device_for_each_child_node'
  109. - 'dma_fence_chain_for_each'
  110. - 'drm_atomic_crtc_for_each_plane'
  111. - 'drm_atomic_crtc_state_for_each_plane'
  112. - 'drm_atomic_crtc_state_for_each_plane_state'
  113. - 'drm_atomic_for_each_plane_damage'
  114. - 'drm_client_for_each_connector_iter'
  115. - 'drm_client_for_each_modeset'
  116. - 'drm_connector_for_each_possible_encoder'
  117. - 'drm_for_each_connector_iter'
  118. - 'drm_for_each_crtc'
  119. - 'drm_for_each_encoder'
  120. - 'drm_for_each_encoder_mask'
  121. - 'drm_for_each_fb'
  122. - 'drm_for_each_legacy_plane'
  123. - 'drm_for_each_plane'
  124. - 'drm_for_each_plane_mask'
  125. - 'drm_for_each_privobj'
  126. - 'drm_mm_for_each_hole'
  127. - 'drm_mm_for_each_node'
  128. - 'drm_mm_for_each_node_in_range'
  129. - 'drm_mm_for_each_node_safe'
  130. - 'flow_action_for_each'
  131. - 'for_each_active_dev_scope'
  132. - 'for_each_active_drhd_unit'
  133. - 'for_each_active_iommu'
  134. - 'for_each_available_child_of_node'
  135. - 'for_each_bio'
  136. - 'for_each_board_func_rsrc'
  137. - 'for_each_bvec'
  138. - 'for_each_card_components'
  139. - 'for_each_card_links'
  140. - 'for_each_card_links_safe'
  141. - 'for_each_card_prelinks'
  142. - 'for_each_card_rtds'
  143. - 'for_each_card_rtds_safe'
  144. - 'for_each_cgroup_storage_type'
  145. - 'for_each_child_of_node'
  146. - 'for_each_clear_bit'
  147. - 'for_each_clear_bit_from'
  148. - 'for_each_cmsghdr'
  149. - 'for_each_compatible_node'
  150. - 'for_each_component_dais'
  151. - 'for_each_component_dais_safe'
  152. - 'for_each_comp_order'
  153. - 'for_each_console'
  154. - 'for_each_cpu'
  155. - 'for_each_cpu_and'
  156. - 'for_each_cpu_not'
  157. - 'for_each_cpu_wrap'
  158. - 'for_each_dev_addr'
  159. - 'for_each_dev_scope'
  160. - 'for_each_displayid_db'
  161. - 'for_each_dma_cap_mask'
  162. - 'for_each_dpcm_be'
  163. - 'for_each_dpcm_be_rollback'
  164. - 'for_each_dpcm_be_safe'
  165. - 'for_each_dpcm_fe'
  166. - 'for_each_drhd_unit'
  167. - 'for_each_dss_dev'
  168. - 'for_each_efi_memory_desc'
  169. - 'for_each_efi_memory_desc_in_map'
  170. - 'for_each_element'
  171. - 'for_each_element_extid'
  172. - 'for_each_element_id'
  173. - 'for_each_endpoint_of_node'
  174. - 'for_each_evictable_lru'
  175. - 'for_each_fib6_node_rt_rcu'
  176. - 'for_each_fib6_walker_rt'
  177. - 'for_each_free_mem_pfn_range_in_zone'
  178. - 'for_each_free_mem_pfn_range_in_zone_from'
  179. - 'for_each_free_mem_range'
  180. - 'for_each_free_mem_range_reverse'
  181. - 'for_each_func_rsrc'
  182. - 'for_each_hstate'
  183. - 'for_each_if'
  184. - 'for_each_iommu'
  185. - 'for_each_ip_tunnel_rcu'
  186. - 'for_each_irq_nr'
  187. - 'for_each_link_codecs'
  188. - 'for_each_link_platforms'
  189. - 'for_each_lru'
  190. - 'for_each_matching_node'
  191. - 'for_each_matching_node_and_match'
  192. - 'for_each_memblock'
  193. - 'for_each_memblock_type'
  194. - 'for_each_memcg_cache_index'
  195. - 'for_each_mem_pfn_range'
  196. - 'for_each_mem_range'
  197. - 'for_each_mem_range_rev'
  198. - 'for_each_migratetype_order'
  199. - 'for_each_msi_entry'
  200. - 'for_each_msi_entry_safe'
  201. - 'for_each_net'
  202. - 'for_each_netdev'
  203. - 'for_each_netdev_continue'
  204. - 'for_each_netdev_continue_rcu'
  205. - 'for_each_netdev_feature'
  206. - 'for_each_netdev_in_bond_rcu'
  207. - 'for_each_netdev_rcu'
  208. - 'for_each_netdev_reverse'
  209. - 'for_each_netdev_safe'
  210. - 'for_each_net_rcu'
  211. - 'for_each_new_connector_in_state'
  212. - 'for_each_new_crtc_in_state'
  213. - 'for_each_new_mst_mgr_in_state'
  214. - 'for_each_new_plane_in_state'
  215. - 'for_each_new_private_obj_in_state'
  216. - 'for_each_node'
  217. - 'for_each_node_by_name'
  218. - 'for_each_node_by_type'
  219. - 'for_each_node_mask'
  220. - 'for_each_node_state'
  221. - 'for_each_node_with_cpus'
  222. - 'for_each_node_with_property'
  223. - 'for_each_of_allnodes'
  224. - 'for_each_of_allnodes_from'
  225. - 'for_each_of_cpu_node'
  226. - 'for_each_of_pci_range'
  227. - 'for_each_old_connector_in_state'
  228. - 'for_each_old_crtc_in_state'
  229. - 'for_each_old_mst_mgr_in_state'
  230. - 'for_each_oldnew_connector_in_state'
  231. - 'for_each_oldnew_crtc_in_state'
  232. - 'for_each_oldnew_mst_mgr_in_state'
  233. - 'for_each_oldnew_plane_in_state'
  234. - 'for_each_oldnew_plane_in_state_reverse'
  235. - 'for_each_oldnew_private_obj_in_state'
  236. - 'for_each_old_plane_in_state'
  237. - 'for_each_old_private_obj_in_state'
  238. - 'for_each_online_cpu'
  239. - 'for_each_online_node'
  240. - 'for_each_online_pgdat'
  241. - 'for_each_pci_bridge'
  242. - 'for_each_pci_dev'
  243. - 'for_each_pci_msi_entry'
  244. - 'for_each_populated_zone'
  245. - 'for_each_possible_cpu'
  246. - 'for_each_present_cpu'
  247. - 'for_each_prime_number'
  248. - 'for_each_prime_number_from'
  249. - 'for_each_process'
  250. - 'for_each_process_thread'
  251. - 'for_each_property_of_node'
  252. - 'for_each_registered_fb'
  253. - 'for_each_reserved_mem_region'
  254. - 'for_each_rtd_codec_dai'
  255. - 'for_each_rtd_codec_dai_rollback'
  256. - 'for_each_rtdcom'
  257. - 'for_each_rtdcom_safe'
  258. - 'for_each_set_bit'
  259. - 'for_each_set_bit_from'
  260. - 'for_each_sg'
  261. - 'for_each_sg_dma_page'
  262. - 'for_each_sg_page'
  263. - 'for_each_sibling_event'
  264. - 'for_each_subelement'
  265. - 'for_each_subelement_extid'
  266. - 'for_each_subelement_id'
  267. - '__for_each_thread'
  268. - 'for_each_thread'
  269. - 'for_each_zone'
  270. - 'for_each_zone_zonelist'
  271. - 'for_each_zone_zonelist_nodemask'
  272. - 'fwnode_for_each_available_child_node'
  273. - 'fwnode_for_each_child_node'
  274. - 'fwnode_graph_for_each_endpoint'
  275. - 'gadget_for_each_ep'
  276. - 'genradix_for_each'
  277. - 'genradix_for_each_from'
  278. - 'hash_for_each'
  279. - 'hash_for_each_possible'
  280. - 'hash_for_each_possible_rcu'
  281. - 'hash_for_each_possible_rcu_notrace'
  282. - 'hash_for_each_possible_safe'
  283. - 'hash_for_each_rcu'
  284. - 'hash_for_each_safe'
  285. - 'hctx_for_each_ctx'
  286. - 'hlist_bl_for_each_entry'
  287. - 'hlist_bl_for_each_entry_rcu'
  288. - 'hlist_bl_for_each_entry_safe'
  289. - 'hlist_for_each'
  290. - 'hlist_for_each_entry'
  291. - 'hlist_for_each_entry_continue'
  292. - 'hlist_for_each_entry_continue_rcu'
  293. - 'hlist_for_each_entry_continue_rcu_bh'
  294. - 'hlist_for_each_entry_from'
  295. - 'hlist_for_each_entry_from_rcu'
  296. - 'hlist_for_each_entry_rcu'
  297. - 'hlist_for_each_entry_rcu_bh'
  298. - 'hlist_for_each_entry_rcu_notrace'
  299. - 'hlist_for_each_entry_safe'
  300. - '__hlist_for_each_rcu'
  301. - 'hlist_for_each_safe'
  302. - 'hlist_nulls_for_each_entry'
  303. - 'hlist_nulls_for_each_entry_from'
  304. - 'hlist_nulls_for_each_entry_rcu'
  305. - 'hlist_nulls_for_each_entry_safe'
  306. - 'i3c_bus_for_each_i2cdev'
  307. - 'i3c_bus_for_each_i3cdev'
  308. - 'ide_host_for_each_port'
  309. - 'ide_port_for_each_dev'
  310. - 'ide_port_for_each_present_dev'
  311. - 'idr_for_each_entry'
  312. - 'idr_for_each_entry_continue'
  313. - 'idr_for_each_entry_continue_ul'
  314. - 'idr_for_each_entry_ul'
  315. - 'in_dev_for_each_ifa_rcu'
  316. - 'in_dev_for_each_ifa_rtnl'
  317. - 'inet_bind_bucket_for_each'
  318. - 'inet_lhash2_for_each_icsk_rcu'
  319. - 'key_for_each'
  320. - 'key_for_each_safe'
  321. - 'klp_for_each_func'
  322. - 'klp_for_each_func_safe'
  323. - 'klp_for_each_func_static'
  324. - 'klp_for_each_object'
  325. - 'klp_for_each_object_safe'
  326. - 'klp_for_each_object_static'
  327. - 'kvm_for_each_memslot'
  328. - 'kvm_for_each_vcpu'
  329. - 'list_for_each'
  330. - 'list_for_each_codec'
  331. - 'list_for_each_codec_safe'
  332. - 'list_for_each_entry'
  333. - 'list_for_each_entry_continue'
  334. - 'list_for_each_entry_continue_rcu'
  335. - 'list_for_each_entry_continue_reverse'
  336. - 'list_for_each_entry_from'
  337. - 'list_for_each_entry_from_rcu'
  338. - 'list_for_each_entry_from_reverse'
  339. - 'list_for_each_entry_lockless'
  340. - 'list_for_each_entry_rcu'
  341. - 'list_for_each_entry_reverse'
  342. - 'list_for_each_entry_safe'
  343. - 'list_for_each_entry_safe_continue'
  344. - 'list_for_each_entry_safe_from'
  345. - 'list_for_each_entry_safe_reverse'
  346. - 'list_for_each_prev'
  347. - 'list_for_each_prev_safe'
  348. - 'list_for_each_safe'
  349. - 'llist_for_each'
  350. - 'llist_for_each_entry'
  351. - 'llist_for_each_entry_safe'
  352. - 'llist_for_each_safe'
  353. - 'media_device_for_each_entity'
  354. - 'media_device_for_each_intf'
  355. - 'media_device_for_each_link'
  356. - 'media_device_for_each_pad'
  357. - 'nanddev_io_for_each_page'
  358. - 'netdev_for_each_lower_dev'
  359. - 'netdev_for_each_lower_private'
  360. - 'netdev_for_each_lower_private_rcu'
  361. - 'netdev_for_each_mc_addr'
  362. - 'netdev_for_each_uc_addr'
  363. - 'netdev_for_each_upper_dev_rcu'
  364. - 'netdev_hw_addr_list_for_each'
  365. - 'nft_rule_for_each_expr'
  366. - 'nla_for_each_attr'
  367. - 'nla_for_each_nested'
  368. - 'nlmsg_for_each_attr'
  369. - 'nlmsg_for_each_msg'
  370. - 'nr_neigh_for_each'
  371. - 'nr_neigh_for_each_safe'
  372. - 'nr_node_for_each'
  373. - 'nr_node_for_each_safe'
  374. - 'of_for_each_phandle'
  375. - 'of_property_for_each_string'
  376. - 'of_property_for_each_u32'
  377. - 'pci_bus_for_each_resource'
  378. - 'ping_portaddr_for_each_entry'
  379. - 'plist_for_each'
  380. - 'plist_for_each_continue'
  381. - 'plist_for_each_entry'
  382. - 'plist_for_each_entry_continue'
  383. - 'plist_for_each_entry_safe'
  384. - 'plist_for_each_safe'
  385. - 'pnp_for_each_card'
  386. - 'pnp_for_each_dev'
  387. - 'protocol_for_each_card'
  388. - 'protocol_for_each_dev'
  389. - 'queue_for_each_hw_ctx'
  390. - 'radix_tree_for_each_slot'
  391. - 'radix_tree_for_each_tagged'
  392. - 'rbtree_postorder_for_each_entry_safe'
  393. - 'rdma_for_each_block'
  394. - 'rdma_for_each_port'
  395. - 'resource_list_for_each_entry'
  396. - 'resource_list_for_each_entry_safe'
  397. - 'rhl_for_each_entry_rcu'
  398. - 'rhl_for_each_rcu'
  399. - 'rht_for_each'
  400. - 'rht_for_each_entry'
  401. - 'rht_for_each_entry_from'
  402. - 'rht_for_each_entry_rcu'
  403. - 'rht_for_each_entry_rcu_from'
  404. - 'rht_for_each_entry_safe'
  405. - 'rht_for_each_from'
  406. - 'rht_for_each_rcu'
  407. - 'rht_for_each_rcu_from'
  408. - '__rq_for_each_bio'
  409. - 'rq_for_each_bvec'
  410. - 'rq_for_each_segment'
  411. - 'scsi_for_each_prot_sg'
  412. - 'scsi_for_each_sg'
  413. - 'sctp_for_each_hentry'
  414. - 'sctp_skb_for_each'
  415. - 'shdma_for_each_chan'
  416. - '__shost_for_each_device'
  417. - 'shost_for_each_device'
  418. - 'sk_for_each'
  419. - 'sk_for_each_bound'
  420. - 'sk_for_each_entry_offset_rcu'
  421. - 'sk_for_each_from'
  422. - 'sk_for_each_rcu'
  423. - 'sk_for_each_safe'
  424. - 'sk_nulls_for_each'
  425. - 'sk_nulls_for_each_from'
  426. - 'sk_nulls_for_each_rcu'
  427. - 'snd_array_for_each'
  428. - 'snd_pcm_group_for_each_entry'
  429. - 'snd_soc_dapm_widget_for_each_path'
  430. - 'snd_soc_dapm_widget_for_each_path_safe'
  431. - 'snd_soc_dapm_widget_for_each_sink_path'
  432. - 'snd_soc_dapm_widget_for_each_source_path'
  433. - 'tb_property_for_each'
  434. - 'tcf_exts_for_each_action'
  435. - 'udp_portaddr_for_each_entry'
  436. - 'udp_portaddr_for_each_entry_rcu'
  437. - 'usb_hub_for_each_child'
  438. - 'v4l2_device_for_each_subdev'
  439. - 'v4l2_m2m_for_each_dst_buf'
  440. - 'v4l2_m2m_for_each_dst_buf_safe'
  441. - 'v4l2_m2m_for_each_src_buf'
  442. - 'v4l2_m2m_for_each_src_buf_safe'
  443. - 'virtio_device_for_each_vq'
  444. - 'xa_for_each'
  445. - 'xa_for_each_marked'
  446. - 'xa_for_each_start'
  447. - 'xas_for_each'
  448. - 'xas_for_each_conflict'
  449. - 'xas_for_each_marked'
  450. - 'zorro_for_each_dev'
  451. #IncludeBlocks: Preserve # Unknown to clang-format-5.0
  452. IncludeCategories:
  453. - Regex: '.*'
  454. Priority: 1
  455. IncludeIsMainRegex: '(Test)?$'
  456. IndentCaseLabels: false
  457. #IndentPPDirectives: None # Unknown to clang-format-5.0
  458. IndentWidth: 8
  459. IndentWrappedFunctionNames: false
  460. JavaScriptQuotes: Leave
  461. JavaScriptWrapImports: true
  462. KeepEmptyLinesAtTheStartOfBlocks: false
  463. MacroBlockBegin: ''
  464. MacroBlockEnd: ''
  465. MaxEmptyLinesToKeep: 1
  466. NamespaceIndentation: Inner
  467. #ObjCBinPackProtocolList: Auto # Unknown to clang-format-5.0
  468. ObjCBlockIndentWidth: 8
  469. ObjCSpaceAfterProperty: true
  470. ObjCSpaceBeforeProtocolList: true
  471. # Taken from git's rules
  472. #PenaltyBreakAssignment: 10 # Unknown to clang-format-4.0
  473. PenaltyBreakBeforeFirstCallParameter: 30
  474. PenaltyBreakComment: 10
  475. PenaltyBreakFirstLessLess: 0
  476. PenaltyBreakString: 10
  477. PenaltyExcessCharacter: 100
  478. PenaltyReturnTypeOnItsOwnLine: 60
  479. PointerAlignment: Right
  480. ReflowComments: false
  481. SortIncludes: false
  482. #SortUsingDeclarations: false # Unknown to clang-format-4.0
  483. SpaceAfterCStyleCast: false
  484. SpaceAfterTemplateKeyword: true
  485. SpaceBeforeAssignmentOperators: true
  486. #SpaceBeforeCtorInitializerColon: true # Unknown to clang-format-5.0
  487. #SpaceBeforeInheritanceColon: true # Unknown to clang-format-5.0
  488. SpaceBeforeParens: ControlStatements
  489. #SpaceBeforeRangeBasedForLoopColon: true # Unknown to clang-format-5.0
  490. SpaceInEmptyParentheses: false
  491. SpacesBeforeTrailingComments: 1
  492. SpacesInAngles: false
  493. SpacesInContainerLiterals: false
  494. SpacesInCStyleCastParentheses: false
  495. SpacesInParentheses: false
  496. SpacesInSquareBrackets: false
  497. Standard: Cpp03
  498. TabWidth: 8
  499. UseTab: Always
  500. ...