1 # SPDX-License-Identifier: GPL-2.0
3 # clang-format configuration file. Intended for clang-format >= 4.
5 # For more information, see:
7 # Documentation/process/clang-format.rst
8 # https://clang.llvm.org/docs/ClangFormat.html
9 # https://clang.llvm.org/docs/ClangFormatStyleOptions.html
12 AccessModifierOffset: -4
13 AlignAfterOpenBracket: Align
14 AlignConsecutiveAssignments: false
15 AlignConsecutiveDeclarations: false
16 #AlignEscapedNewlines: Left # Unknown to clang-format-4.0
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
33 AfterControlStatement: false
37 AfterObjCDeclaration: false
40 #AfterExternBlock: false # Unknown to clang-format-5.0
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
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
64 ExperimentalAutoDetectBinPacking: false
65 #FixNamespaceComments: false # Unknown to clang-format-4.0
68 # git grep -h '^#define [^[:space:]]*for_each[^[:space:]]*(' include/ \
69 # | sed "s,^#define \([^[:space:]]*for_each[^[:space:]]*\)(.*$, - '\1'," \
70 # | LC_ALL=C sort | uniq
73 - '__bio_for_each_bvec'
74 - '__bio_for_each_segment'
75 - '__for_each_mem_range'
76 - '__for_each_mem_range_rev'
78 - '__hlist_for_each_rcu'
80 - '__shost_for_each_device'
81 - 'apei_estatus_for_each_section'
85 - 'ata_qc_for_each_raw'
86 - 'ata_qc_for_each_with_internal'
90 - 'bio_for_each_bvec_all'
91 - 'bio_for_each_folio_all'
92 - 'bio_for_each_integrity_vec'
93 - 'bio_for_each_segment'
94 - 'bio_for_each_segment_all'
97 - 'bond_for_each_slave'
98 - 'bond_for_each_slave_rcu'
99 - 'bpf_for_each_spilled_reg'
100 - 'btree_for_each_safe128'
101 - 'btree_for_each_safe32'
102 - 'btree_for_each_safe64'
103 - 'btree_for_each_safel'
104 - 'card_for_each_dev'
105 - 'cgroup_taskset_for_each'
106 - 'cgroup_taskset_for_each_leader'
107 - 'cpufreq_for_each_efficient_entry_idx'
108 - 'cpufreq_for_each_entry'
109 - 'cpufreq_for_each_entry_idx'
110 - 'cpufreq_for_each_valid_entry'
111 - 'cpufreq_for_each_valid_entry_idx'
112 - 'css_for_each_child'
113 - 'css_for_each_descendant_post'
114 - 'css_for_each_descendant_pre'
115 - 'damon_for_each_region'
116 - 'damon_for_each_region_safe'
117 - 'damon_for_each_scheme'
118 - 'damon_for_each_scheme_safe'
119 - 'damon_for_each_target'
120 - 'damon_for_each_target_safe'
121 - 'device_for_each_child_node'
122 - 'displayid_iter_for_each'
123 - 'dma_fence_array_for_each'
124 - 'dma_fence_chain_for_each'
125 - 'dma_fence_unwrap_for_each'
126 - 'dma_resv_for_each_fence'
127 - 'dma_resv_for_each_fence_unlocked'
128 - 'do_for_each_ftrace_op'
129 - 'drm_atomic_crtc_for_each_plane'
130 - 'drm_atomic_crtc_state_for_each_plane'
131 - 'drm_atomic_crtc_state_for_each_plane_state'
132 - 'drm_atomic_for_each_plane_damage'
133 - 'drm_client_for_each_connector_iter'
134 - 'drm_client_for_each_modeset'
135 - 'drm_connector_for_each_possible_encoder'
136 - 'drm_for_each_bridge_in_chain'
137 - 'drm_for_each_connector_iter'
138 - 'drm_for_each_crtc'
139 - 'drm_for_each_crtc_reverse'
140 - 'drm_for_each_encoder'
141 - 'drm_for_each_encoder_mask'
143 - 'drm_for_each_legacy_plane'
144 - 'drm_for_each_plane'
145 - 'drm_for_each_plane_mask'
146 - 'drm_for_each_privobj'
147 - 'drm_mm_for_each_hole'
148 - 'drm_mm_for_each_node'
149 - 'drm_mm_for_each_node_in_range'
150 - 'drm_mm_for_each_node_safe'
151 - 'dsa_switch_for_each_available_port'
152 - 'dsa_switch_for_each_cpu_port'
153 - 'dsa_switch_for_each_port'
154 - 'dsa_switch_for_each_port_continue_reverse'
155 - 'dsa_switch_for_each_port_safe'
156 - 'dsa_switch_for_each_user_port'
157 - 'dsa_tree_for_each_user_port'
158 - 'flow_action_for_each'
159 - 'for_each_acpi_dev_match'
160 - 'for_each_active_dev_scope'
161 - 'for_each_active_drhd_unit'
162 - 'for_each_active_iommu'
163 - 'for_each_aggr_pgid'
164 - 'for_each_available_child_of_node'
166 - 'for_each_board_func_rsrc'
168 - 'for_each_card_auxs'
169 - 'for_each_card_auxs_safe'
170 - 'for_each_card_components'
171 - 'for_each_card_dapms'
172 - 'for_each_card_pre_auxs'
173 - 'for_each_card_prelinks'
174 - 'for_each_card_rtds'
175 - 'for_each_card_rtds_safe'
176 - 'for_each_card_widgets'
177 - 'for_each_card_widgets_safe'
178 - 'for_each_cgroup_storage_type'
179 - 'for_each_child_of_node'
180 - 'for_each_clear_bit'
181 - 'for_each_clear_bit_from'
182 - 'for_each_clear_bitrange'
183 - 'for_each_clear_bitrange_from'
185 - 'for_each_comp_order'
186 - 'for_each_compatible_node'
187 - 'for_each_component_dais'
188 - 'for_each_component_dais_safe'
193 - 'for_each_cpu_wrap'
194 - 'for_each_dapm_widgets'
195 - 'for_each_dev_addr'
196 - 'for_each_dev_scope'
197 - 'for_each_dma_cap_mask'
199 - 'for_each_dpcm_be_rollback'
200 - 'for_each_dpcm_be_safe'
202 - 'for_each_drhd_unit'
204 - 'for_each_efi_memory_desc'
205 - 'for_each_efi_memory_desc_in_map'
207 - 'for_each_element_extid'
208 - 'for_each_element_id'
209 - 'for_each_endpoint_of_node'
210 - 'for_each_evictable_lru'
211 - 'for_each_fib6_node_rt_rcu'
212 - 'for_each_fib6_walker_rt'
213 - 'for_each_free_mem_pfn_range_in_zone'
214 - 'for_each_free_mem_pfn_range_in_zone_from'
215 - 'for_each_free_mem_range'
216 - 'for_each_free_mem_range_reverse'
217 - 'for_each_func_rsrc'
221 - 'for_each_ip_tunnel_rcu'
223 - 'for_each_link_codecs'
224 - 'for_each_link_cpus'
225 - 'for_each_link_platforms'
227 - 'for_each_matching_node'
228 - 'for_each_matching_node_and_match'
229 - 'for_each_mem_pfn_range'
230 - 'for_each_mem_range'
231 - 'for_each_mem_range_rev'
232 - 'for_each_mem_region'
234 - 'for_each_migratetype_order'
236 - 'for_each_net_continue_reverse'
239 - 'for_each_netdev_continue'
240 - 'for_each_netdev_continue_rcu'
241 - 'for_each_netdev_continue_reverse'
242 - 'for_each_netdev_feature'
243 - 'for_each_netdev_in_bond_rcu'
244 - 'for_each_netdev_rcu'
245 - 'for_each_netdev_reverse'
246 - 'for_each_netdev_safe'
247 - 'for_each_new_connector_in_state'
248 - 'for_each_new_crtc_in_state'
249 - 'for_each_new_mst_mgr_in_state'
250 - 'for_each_new_plane_in_state'
251 - 'for_each_new_plane_in_state_reverse'
252 - 'for_each_new_private_obj_in_state'
254 - 'for_each_node_by_name'
255 - 'for_each_node_by_type'
256 - 'for_each_node_mask'
257 - 'for_each_node_state'
258 - 'for_each_node_with_cpus'
259 - 'for_each_node_with_property'
260 - 'for_each_nonreserved_multicast_dest_pgid'
261 - 'for_each_of_allnodes'
262 - 'for_each_of_allnodes_from'
263 - 'for_each_of_cpu_node'
264 - 'for_each_of_pci_range'
265 - 'for_each_old_connector_in_state'
266 - 'for_each_old_crtc_in_state'
267 - 'for_each_old_mst_mgr_in_state'
268 - 'for_each_old_plane_in_state'
269 - 'for_each_old_private_obj_in_state'
270 - 'for_each_oldnew_connector_in_state'
271 - 'for_each_oldnew_crtc_in_state'
272 - 'for_each_oldnew_mst_mgr_in_state'
273 - 'for_each_oldnew_plane_in_state'
274 - 'for_each_oldnew_plane_in_state_reverse'
275 - 'for_each_oldnew_private_obj_in_state'
276 - 'for_each_online_cpu'
277 - 'for_each_online_node'
278 - 'for_each_online_pgdat'
279 - 'for_each_pci_bridge'
281 - 'for_each_pcm_streams'
282 - 'for_each_physmem_range'
283 - 'for_each_populated_zone'
284 - 'for_each_possible_cpu'
285 - 'for_each_present_cpu'
286 - 'for_each_prime_number'
287 - 'for_each_prime_number_from'
289 - 'for_each_process_thread'
290 - 'for_each_prop_codec_conf'
291 - 'for_each_prop_dai_codec'
292 - 'for_each_prop_dai_cpu'
293 - 'for_each_prop_dlc_codecs'
294 - 'for_each_prop_dlc_cpus'
295 - 'for_each_prop_dlc_platforms'
296 - 'for_each_property_of_node'
297 - 'for_each_registered_fb'
298 - 'for_each_requested_gpio'
299 - 'for_each_requested_gpio_in_range'
300 - 'for_each_reserved_mem_range'
301 - 'for_each_reserved_mem_region'
302 - 'for_each_rtd_codec_dais'
303 - 'for_each_rtd_components'
304 - 'for_each_rtd_cpu_dais'
305 - 'for_each_rtd_dais'
307 - 'for_each_set_bit_from'
308 - 'for_each_set_bitrange'
309 - 'for_each_set_bitrange_from'
310 - 'for_each_set_clump8'
312 - 'for_each_sg_dma_page'
314 - 'for_each_sgtable_dma_page'
315 - 'for_each_sgtable_dma_sg'
316 - 'for_each_sgtable_page'
317 - 'for_each_sgtable_sg'
318 - 'for_each_sibling_event'
319 - 'for_each_subelement'
320 - 'for_each_subelement_extid'
321 - 'for_each_subelement_id'
323 - 'for_each_unicast_dest_pgid'
325 - 'for_each_wakeup_source'
327 - 'for_each_zone_zonelist'
328 - 'for_each_zone_zonelist_nodemask'
329 - 'fwnode_for_each_available_child_node'
330 - 'fwnode_for_each_child_node'
331 - 'fwnode_graph_for_each_endpoint'
332 - 'gadget_for_each_ep'
333 - 'genradix_for_each'
334 - 'genradix_for_each_from'
336 - 'hash_for_each_possible'
337 - 'hash_for_each_possible_rcu'
338 - 'hash_for_each_possible_rcu_notrace'
339 - 'hash_for_each_possible_safe'
340 - 'hash_for_each_rcu'
341 - 'hash_for_each_safe'
342 - 'hctx_for_each_ctx'
343 - 'hlist_bl_for_each_entry'
344 - 'hlist_bl_for_each_entry_rcu'
345 - 'hlist_bl_for_each_entry_safe'
347 - 'hlist_for_each_entry'
348 - 'hlist_for_each_entry_continue'
349 - 'hlist_for_each_entry_continue_rcu'
350 - 'hlist_for_each_entry_continue_rcu_bh'
351 - 'hlist_for_each_entry_from'
352 - 'hlist_for_each_entry_from_rcu'
353 - 'hlist_for_each_entry_rcu'
354 - 'hlist_for_each_entry_rcu_bh'
355 - 'hlist_for_each_entry_rcu_notrace'
356 - 'hlist_for_each_entry_safe'
357 - 'hlist_for_each_entry_srcu'
358 - 'hlist_for_each_safe'
359 - 'hlist_nulls_for_each_entry'
360 - 'hlist_nulls_for_each_entry_from'
361 - 'hlist_nulls_for_each_entry_rcu'
362 - 'hlist_nulls_for_each_entry_safe'
363 - 'i3c_bus_for_each_i2cdev'
364 - 'i3c_bus_for_each_i3cdev'
365 - 'idr_for_each_entry'
366 - 'idr_for_each_entry_continue'
367 - 'idr_for_each_entry_continue_ul'
368 - 'idr_for_each_entry_ul'
369 - 'in_dev_for_each_ifa_rcu'
370 - 'in_dev_for_each_ifa_rtnl'
371 - 'inet_bind_bucket_for_each'
372 - 'inet_lhash2_for_each_icsk'
373 - 'inet_lhash2_for_each_icsk_continue'
374 - 'inet_lhash2_for_each_icsk_rcu'
376 - 'key_for_each_safe'
377 - 'klp_for_each_func'
378 - 'klp_for_each_func_safe'
379 - 'klp_for_each_func_static'
380 - 'klp_for_each_object'
381 - 'klp_for_each_object_safe'
382 - 'klp_for_each_object_static'
383 - 'kunit_suite_for_each_test_case'
384 - 'kvm_for_each_memslot'
385 - 'kvm_for_each_memslot_in_gfn_range'
386 - 'kvm_for_each_vcpu'
388 - 'list_for_each_codec'
389 - 'list_for_each_codec_safe'
390 - 'list_for_each_continue'
391 - 'list_for_each_entry'
392 - 'list_for_each_entry_continue'
393 - 'list_for_each_entry_continue_rcu'
394 - 'list_for_each_entry_continue_reverse'
395 - 'list_for_each_entry_from'
396 - 'list_for_each_entry_from_rcu'
397 - 'list_for_each_entry_from_reverse'
398 - 'list_for_each_entry_lockless'
399 - 'list_for_each_entry_rcu'
400 - 'list_for_each_entry_reverse'
401 - 'list_for_each_entry_safe'
402 - 'list_for_each_entry_safe_continue'
403 - 'list_for_each_entry_safe_from'
404 - 'list_for_each_entry_safe_reverse'
405 - 'list_for_each_entry_srcu'
406 - 'list_for_each_prev'
407 - 'list_for_each_prev_safe'
408 - 'list_for_each_safe'
410 - 'llist_for_each_entry'
411 - 'llist_for_each_entry_safe'
412 - 'llist_for_each_safe'
413 - 'mci_for_each_dimm'
414 - 'media_device_for_each_entity'
415 - 'media_device_for_each_intf'
416 - 'media_device_for_each_link'
417 - 'media_device_for_each_pad'
418 - 'msi_for_each_desc'
419 - 'nanddev_io_for_each_page'
420 - 'netdev_for_each_lower_dev'
421 - 'netdev_for_each_lower_private'
422 - 'netdev_for_each_lower_private_rcu'
423 - 'netdev_for_each_mc_addr'
424 - 'netdev_for_each_uc_addr'
425 - 'netdev_for_each_upper_dev_rcu'
426 - 'netdev_hw_addr_list_for_each'
427 - 'nft_rule_for_each_expr'
428 - 'nla_for_each_attr'
429 - 'nla_for_each_nested'
430 - 'nlmsg_for_each_attr'
431 - 'nlmsg_for_each_msg'
432 - 'nr_neigh_for_each'
433 - 'nr_neigh_for_each_safe'
435 - 'nr_node_for_each_safe'
436 - 'of_for_each_phandle'
437 - 'of_property_for_each_string'
438 - 'of_property_for_each_u32'
439 - 'pci_bus_for_each_resource'
440 - 'pcl_for_each_chunk'
441 - 'pcl_for_each_segment'
442 - 'pcm_for_each_format'
443 - 'ping_portaddr_for_each_entry'
445 - 'plist_for_each_continue'
446 - 'plist_for_each_entry'
447 - 'plist_for_each_entry_continue'
448 - 'plist_for_each_entry_safe'
449 - 'plist_for_each_safe'
450 - 'pnp_for_each_card'
452 - 'protocol_for_each_card'
453 - 'protocol_for_each_dev'
454 - 'queue_for_each_hw_ctx'
455 - 'radix_tree_for_each_slot'
456 - 'radix_tree_for_each_tagged'
458 - 'rbtree_postorder_for_each_entry_safe'
459 - 'rdma_for_each_block'
460 - 'rdma_for_each_port'
461 - 'rdma_umem_for_each_dma_block'
462 - 'resource_list_for_each_entry'
463 - 'resource_list_for_each_entry_safe'
464 - 'rhl_for_each_entry_rcu'
467 - 'rht_for_each_entry'
468 - 'rht_for_each_entry_from'
469 - 'rht_for_each_entry_rcu'
470 - 'rht_for_each_entry_rcu_from'
471 - 'rht_for_each_entry_safe'
472 - 'rht_for_each_from'
474 - 'rht_for_each_rcu_from'
476 - 'rq_for_each_segment'
478 - 'rq_list_for_each_safe'
479 - 'scsi_for_each_prot_sg'
481 - 'sctp_for_each_hentry'
482 - 'sctp_skb_for_each'
483 - 'shdma_for_each_chan'
484 - 'shost_for_each_device'
486 - 'sk_for_each_bound'
487 - 'sk_for_each_entry_offset_rcu'
491 - 'sk_nulls_for_each'
492 - 'sk_nulls_for_each_from'
493 - 'sk_nulls_for_each_rcu'
494 - 'snd_array_for_each'
495 - 'snd_pcm_group_for_each_entry'
496 - 'snd_soc_dapm_widget_for_each_path'
497 - 'snd_soc_dapm_widget_for_each_path_safe'
498 - 'snd_soc_dapm_widget_for_each_sink_path'
499 - 'snd_soc_dapm_widget_for_each_source_path'
500 - 'tb_property_for_each'
501 - 'tcf_act_for_each_action'
502 - 'tcf_exts_for_each_action'
503 - 'udp_portaddr_for_each_entry'
504 - 'udp_portaddr_for_each_entry_rcu'
505 - 'usb_hub_for_each_child'
506 - 'v4l2_device_for_each_subdev'
507 - 'v4l2_m2m_for_each_dst_buf'
508 - 'v4l2_m2m_for_each_dst_buf_safe'
509 - 'v4l2_m2m_for_each_src_buf'
510 - 'v4l2_m2m_for_each_src_buf_safe'
511 - 'virtio_device_for_each_vq'
512 - 'while_for_each_ftrace_op'
514 - 'xa_for_each_marked'
515 - 'xa_for_each_range'
516 - 'xa_for_each_start'
518 - 'xas_for_each_conflict'
519 - 'xas_for_each_marked'
520 - 'xbc_array_for_each_value'
521 - 'xbc_for_each_key_value'
522 - 'xbc_node_for_each_array_value'
523 - 'xbc_node_for_each_child'
524 - 'xbc_node_for_each_key_value'
525 - 'xbc_node_for_each_subkey'
526 - 'zorro_for_each_dev'
528 #IncludeBlocks: Preserve # Unknown to clang-format-5.0
532 IncludeIsMainRegex: '(Test)?$'
533 IndentCaseLabels: false
534 #IndentPPDirectives: None # Unknown to clang-format-5.0
536 IndentWrappedFunctionNames: false
537 JavaScriptQuotes: Leave
538 JavaScriptWrapImports: true
539 KeepEmptyLinesAtTheStartOfBlocks: false
542 MaxEmptyLinesToKeep: 1
543 NamespaceIndentation: None
544 #ObjCBinPackProtocolList: Auto # Unknown to clang-format-5.0
545 ObjCBlockIndentWidth: 8
546 ObjCSpaceAfterProperty: true
547 ObjCSpaceBeforeProtocolList: true
549 # Taken from git's rules
550 #PenaltyBreakAssignment: 10 # Unknown to clang-format-4.0
551 PenaltyBreakBeforeFirstCallParameter: 30
552 PenaltyBreakComment: 10
553 PenaltyBreakFirstLessLess: 0
554 PenaltyBreakString: 10
555 PenaltyExcessCharacter: 100
556 PenaltyReturnTypeOnItsOwnLine: 60
558 PointerAlignment: Right
559 ReflowComments: false
561 #SortUsingDeclarations: false # Unknown to clang-format-4.0
562 SpaceAfterCStyleCast: false
563 SpaceAfterTemplateKeyword: true
564 SpaceBeforeAssignmentOperators: true
565 #SpaceBeforeCtorInitializerColon: true # Unknown to clang-format-5.0
566 #SpaceBeforeInheritanceColon: true # Unknown to clang-format-5.0
567 SpaceBeforeParens: ControlStatements
568 #SpaceBeforeRangeBasedForLoopColon: true # Unknown to clang-format-5.0
569 SpaceInEmptyParentheses: false
570 SpacesBeforeTrailingComments: 1
571 SpacesInAngles: false
572 SpacesInContainerLiterals: false
573 SpacesInCStyleCastParentheses: false
574 SpacesInParentheses: false
575 SpacesInSquareBrackets: false