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