Merge tag 'configfs-5.10' of git://git.infradead.org/users/hch/configfs
[platform/kernel/linux-rpi.git] / .clang-format
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
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
71 ForEachMacros:
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   - 'dma_fence_chain_for_each'
114   - 'do_for_each_ftrace_op'
115   - 'drm_atomic_crtc_for_each_plane'
116   - 'drm_atomic_crtc_state_for_each_plane'
117   - 'drm_atomic_crtc_state_for_each_plane_state'
118   - 'drm_atomic_for_each_plane_damage'
119   - 'drm_client_for_each_connector_iter'
120   - 'drm_client_for_each_modeset'
121   - 'drm_connector_for_each_possible_encoder'
122   - 'drm_for_each_bridge_in_chain'
123   - 'drm_for_each_connector_iter'
124   - 'drm_for_each_crtc'
125   - 'drm_for_each_encoder'
126   - 'drm_for_each_encoder_mask'
127   - 'drm_for_each_fb'
128   - 'drm_for_each_legacy_plane'
129   - 'drm_for_each_plane'
130   - 'drm_for_each_plane_mask'
131   - 'drm_for_each_privobj'
132   - 'drm_mm_for_each_hole'
133   - 'drm_mm_for_each_node'
134   - 'drm_mm_for_each_node_in_range'
135   - 'drm_mm_for_each_node_safe'
136   - 'flow_action_for_each'
137   - 'for_each_active_dev_scope'
138   - 'for_each_active_drhd_unit'
139   - 'for_each_active_iommu'
140   - 'for_each_aggr_pgid'
141   - 'for_each_available_child_of_node'
142   - 'for_each_bio'
143   - 'for_each_board_func_rsrc'
144   - 'for_each_bvec'
145   - 'for_each_card_auxs'
146   - 'for_each_card_auxs_safe'
147   - 'for_each_card_components'
148   - 'for_each_card_dapms'
149   - 'for_each_card_pre_auxs'
150   - 'for_each_card_prelinks'
151   - 'for_each_card_rtds'
152   - 'for_each_card_rtds_safe'
153   - 'for_each_card_widgets'
154   - 'for_each_card_widgets_safe'
155   - 'for_each_cgroup_storage_type'
156   - 'for_each_child_of_node'
157   - 'for_each_clear_bit'
158   - 'for_each_clear_bit_from'
159   - 'for_each_cmsghdr'
160   - 'for_each_compatible_node'
161   - 'for_each_component_dais'
162   - 'for_each_component_dais_safe'
163   - 'for_each_comp_order'
164   - 'for_each_console'
165   - 'for_each_cpu'
166   - 'for_each_cpu_and'
167   - 'for_each_cpu_not'
168   - 'for_each_cpu_wrap'
169   - 'for_each_dapm_widgets'
170   - 'for_each_dev_addr'
171   - 'for_each_dev_scope'
172   - 'for_each_displayid_db'
173   - 'for_each_dma_cap_mask'
174   - 'for_each_dpcm_be'
175   - 'for_each_dpcm_be_rollback'
176   - 'for_each_dpcm_be_safe'
177   - 'for_each_dpcm_fe'
178   - 'for_each_drhd_unit'
179   - 'for_each_dss_dev'
180   - 'for_each_efi_memory_desc'
181   - 'for_each_efi_memory_desc_in_map'
182   - 'for_each_element'
183   - 'for_each_element_extid'
184   - 'for_each_element_id'
185   - 'for_each_endpoint_of_node'
186   - 'for_each_evictable_lru'
187   - 'for_each_fib6_node_rt_rcu'
188   - 'for_each_fib6_walker_rt'
189   - 'for_each_free_mem_pfn_range_in_zone'
190   - 'for_each_free_mem_pfn_range_in_zone_from'
191   - 'for_each_free_mem_range'
192   - 'for_each_free_mem_range_reverse'
193   - 'for_each_func_rsrc'
194   - 'for_each_hstate'
195   - 'for_each_if'
196   - 'for_each_iommu'
197   - 'for_each_ip_tunnel_rcu'
198   - 'for_each_irq_nr'
199   - 'for_each_link_codecs'
200   - 'for_each_link_cpus'
201   - 'for_each_link_platforms'
202   - 'for_each_lru'
203   - 'for_each_matching_node'
204   - 'for_each_matching_node_and_match'
205   - 'for_each_member'
206   - 'for_each_mem_region'
207   - 'for_each_memblock_type'
208   - 'for_each_memcg_cache_index'
209   - 'for_each_mem_pfn_range'
210   - '__for_each_mem_range'
211   - 'for_each_mem_range'
212   - '__for_each_mem_range_rev'
213   - 'for_each_mem_range_rev'
214   - 'for_each_migratetype_order'
215   - 'for_each_msi_entry'
216   - 'for_each_msi_entry_safe'
217   - 'for_each_net'
218   - 'for_each_net_continue_reverse'
219   - 'for_each_netdev'
220   - 'for_each_netdev_continue'
221   - 'for_each_netdev_continue_rcu'
222   - 'for_each_netdev_continue_reverse'
223   - 'for_each_netdev_feature'
224   - 'for_each_netdev_in_bond_rcu'
225   - 'for_each_netdev_rcu'
226   - 'for_each_netdev_reverse'
227   - 'for_each_netdev_safe'
228   - 'for_each_net_rcu'
229   - 'for_each_new_connector_in_state'
230   - 'for_each_new_crtc_in_state'
231   - 'for_each_new_mst_mgr_in_state'
232   - 'for_each_new_plane_in_state'
233   - 'for_each_new_private_obj_in_state'
234   - 'for_each_node'
235   - 'for_each_node_by_name'
236   - 'for_each_node_by_type'
237   - 'for_each_node_mask'
238   - 'for_each_node_state'
239   - 'for_each_node_with_cpus'
240   - 'for_each_node_with_property'
241   - 'for_each_nonreserved_multicast_dest_pgid'
242   - 'for_each_of_allnodes'
243   - 'for_each_of_allnodes_from'
244   - 'for_each_of_cpu_node'
245   - 'for_each_of_pci_range'
246   - 'for_each_old_connector_in_state'
247   - 'for_each_old_crtc_in_state'
248   - 'for_each_old_mst_mgr_in_state'
249   - 'for_each_oldnew_connector_in_state'
250   - 'for_each_oldnew_crtc_in_state'
251   - 'for_each_oldnew_mst_mgr_in_state'
252   - 'for_each_oldnew_plane_in_state'
253   - 'for_each_oldnew_plane_in_state_reverse'
254   - 'for_each_oldnew_private_obj_in_state'
255   - 'for_each_old_plane_in_state'
256   - 'for_each_old_private_obj_in_state'
257   - 'for_each_online_cpu'
258   - 'for_each_online_node'
259   - 'for_each_online_pgdat'
260   - 'for_each_pci_bridge'
261   - 'for_each_pci_dev'
262   - 'for_each_pci_msi_entry'
263   - 'for_each_pcm_streams'
264   - 'for_each_physmem_range'
265   - 'for_each_populated_zone'
266   - 'for_each_possible_cpu'
267   - 'for_each_present_cpu'
268   - 'for_each_prime_number'
269   - 'for_each_prime_number_from'
270   - 'for_each_process'
271   - 'for_each_process_thread'
272   - 'for_each_property_of_node'
273   - 'for_each_registered_fb'
274   - 'for_each_requested_gpio'
275   - 'for_each_requested_gpio_in_range'
276   - 'for_each_reserved_mem_range'
277   - 'for_each_reserved_mem_region'
278   - 'for_each_rtd_codec_dais'
279   - 'for_each_rtd_codec_dais_rollback'
280   - 'for_each_rtd_components'
281   - 'for_each_rtd_cpu_dais'
282   - 'for_each_rtd_cpu_dais_rollback'
283   - 'for_each_rtd_dais'
284   - 'for_each_set_bit'
285   - 'for_each_set_bit_from'
286   - 'for_each_set_clump8'
287   - 'for_each_sg'
288   - 'for_each_sg_dma_page'
289   - 'for_each_sg_page'
290   - 'for_each_sgtable_dma_page'
291   - 'for_each_sgtable_dma_sg'
292   - 'for_each_sgtable_page'
293   - 'for_each_sgtable_sg'
294   - 'for_each_sibling_event'
295   - 'for_each_subelement'
296   - 'for_each_subelement_extid'
297   - 'for_each_subelement_id'
298   - '__for_each_thread'
299   - 'for_each_thread'
300   - 'for_each_unicast_dest_pgid'
301   - 'for_each_wakeup_source'
302   - 'for_each_zone'
303   - 'for_each_zone_zonelist'
304   - 'for_each_zone_zonelist_nodemask'
305   - 'fwnode_for_each_available_child_node'
306   - 'fwnode_for_each_child_node'
307   - 'fwnode_graph_for_each_endpoint'
308   - 'gadget_for_each_ep'
309   - 'genradix_for_each'
310   - 'genradix_for_each_from'
311   - 'hash_for_each'
312   - 'hash_for_each_possible'
313   - 'hash_for_each_possible_rcu'
314   - 'hash_for_each_possible_rcu_notrace'
315   - 'hash_for_each_possible_safe'
316   - 'hash_for_each_rcu'
317   - 'hash_for_each_safe'
318   - 'hctx_for_each_ctx'
319   - 'hlist_bl_for_each_entry'
320   - 'hlist_bl_for_each_entry_rcu'
321   - 'hlist_bl_for_each_entry_safe'
322   - 'hlist_for_each'
323   - 'hlist_for_each_entry'
324   - 'hlist_for_each_entry_continue'
325   - 'hlist_for_each_entry_continue_rcu'
326   - 'hlist_for_each_entry_continue_rcu_bh'
327   - 'hlist_for_each_entry_from'
328   - 'hlist_for_each_entry_from_rcu'
329   - 'hlist_for_each_entry_rcu'
330   - 'hlist_for_each_entry_rcu_bh'
331   - 'hlist_for_each_entry_rcu_notrace'
332   - 'hlist_for_each_entry_safe'
333   - '__hlist_for_each_rcu'
334   - 'hlist_for_each_safe'
335   - 'hlist_nulls_for_each_entry'
336   - 'hlist_nulls_for_each_entry_from'
337   - 'hlist_nulls_for_each_entry_rcu'
338   - 'hlist_nulls_for_each_entry_safe'
339   - 'i3c_bus_for_each_i2cdev'
340   - 'i3c_bus_for_each_i3cdev'
341   - 'ide_host_for_each_port'
342   - 'ide_port_for_each_dev'
343   - 'ide_port_for_each_present_dev'
344   - 'idr_for_each_entry'
345   - 'idr_for_each_entry_continue'
346   - 'idr_for_each_entry_continue_ul'
347   - 'idr_for_each_entry_ul'
348   - 'in_dev_for_each_ifa_rcu'
349   - 'in_dev_for_each_ifa_rtnl'
350   - 'inet_bind_bucket_for_each'
351   - 'inet_lhash2_for_each_icsk_rcu'
352   - 'key_for_each'
353   - 'key_for_each_safe'
354   - 'klp_for_each_func'
355   - 'klp_for_each_func_safe'
356   - 'klp_for_each_func_static'
357   - 'klp_for_each_object'
358   - 'klp_for_each_object_safe'
359   - 'klp_for_each_object_static'
360   - 'kunit_suite_for_each_test_case'
361   - 'kvm_for_each_memslot'
362   - 'kvm_for_each_vcpu'
363   - 'list_for_each'
364   - 'list_for_each_codec'
365   - 'list_for_each_codec_safe'
366   - 'list_for_each_continue'
367   - 'list_for_each_entry'
368   - 'list_for_each_entry_continue'
369   - 'list_for_each_entry_continue_rcu'
370   - 'list_for_each_entry_continue_reverse'
371   - 'list_for_each_entry_from'
372   - 'list_for_each_entry_from_rcu'
373   - 'list_for_each_entry_from_reverse'
374   - 'list_for_each_entry_lockless'
375   - 'list_for_each_entry_rcu'
376   - 'list_for_each_entry_reverse'
377   - 'list_for_each_entry_safe'
378   - 'list_for_each_entry_safe_continue'
379   - 'list_for_each_entry_safe_from'
380   - 'list_for_each_entry_safe_reverse'
381   - 'list_for_each_prev'
382   - 'list_for_each_prev_safe'
383   - 'list_for_each_safe'
384   - 'llist_for_each'
385   - 'llist_for_each_entry'
386   - 'llist_for_each_entry_safe'
387   - 'llist_for_each_safe'
388   - 'mci_for_each_dimm'
389   - 'media_device_for_each_entity'
390   - 'media_device_for_each_intf'
391   - 'media_device_for_each_link'
392   - 'media_device_for_each_pad'
393   - 'nanddev_io_for_each_page'
394   - 'netdev_for_each_lower_dev'
395   - 'netdev_for_each_lower_private'
396   - 'netdev_for_each_lower_private_rcu'
397   - 'netdev_for_each_mc_addr'
398   - 'netdev_for_each_uc_addr'
399   - 'netdev_for_each_upper_dev_rcu'
400   - 'netdev_hw_addr_list_for_each'
401   - 'nft_rule_for_each_expr'
402   - 'nla_for_each_attr'
403   - 'nla_for_each_nested'
404   - 'nlmsg_for_each_attr'
405   - 'nlmsg_for_each_msg'
406   - 'nr_neigh_for_each'
407   - 'nr_neigh_for_each_safe'
408   - 'nr_node_for_each'
409   - 'nr_node_for_each_safe'
410   - 'of_for_each_phandle'
411   - 'of_property_for_each_string'
412   - 'of_property_for_each_u32'
413   - 'pci_bus_for_each_resource'
414   - 'pcm_for_each_format'
415   - 'ping_portaddr_for_each_entry'
416   - 'plist_for_each'
417   - 'plist_for_each_continue'
418   - 'plist_for_each_entry'
419   - 'plist_for_each_entry_continue'
420   - 'plist_for_each_entry_safe'
421   - 'plist_for_each_safe'
422   - 'pnp_for_each_card'
423   - 'pnp_for_each_dev'
424   - 'protocol_for_each_card'
425   - 'protocol_for_each_dev'
426   - 'queue_for_each_hw_ctx'
427   - 'radix_tree_for_each_slot'
428   - 'radix_tree_for_each_tagged'
429   - 'rbtree_postorder_for_each_entry_safe'
430   - 'rdma_for_each_block'
431   - 'rdma_for_each_port'
432   - 'resource_list_for_each_entry'
433   - 'resource_list_for_each_entry_safe'
434   - 'rhl_for_each_entry_rcu'
435   - 'rhl_for_each_rcu'
436   - 'rht_for_each'
437   - 'rht_for_each_entry'
438   - 'rht_for_each_entry_from'
439   - 'rht_for_each_entry_rcu'
440   - 'rht_for_each_entry_rcu_from'
441   - 'rht_for_each_entry_safe'
442   - 'rht_for_each_from'
443   - 'rht_for_each_rcu'
444   - 'rht_for_each_rcu_from'
445   - '__rq_for_each_bio'
446   - 'rq_for_each_bvec'
447   - 'rq_for_each_segment'
448   - 'scsi_for_each_prot_sg'
449   - 'scsi_for_each_sg'
450   - 'sctp_for_each_hentry'
451   - 'sctp_skb_for_each'
452   - 'shdma_for_each_chan'
453   - '__shost_for_each_device'
454   - 'shost_for_each_device'
455   - 'sk_for_each'
456   - 'sk_for_each_bound'
457   - 'sk_for_each_entry_offset_rcu'
458   - 'sk_for_each_from'
459   - 'sk_for_each_rcu'
460   - 'sk_for_each_safe'
461   - 'sk_nulls_for_each'
462   - 'sk_nulls_for_each_from'
463   - 'sk_nulls_for_each_rcu'
464   - 'snd_array_for_each'
465   - 'snd_pcm_group_for_each_entry'
466   - 'snd_soc_dapm_widget_for_each_path'
467   - 'snd_soc_dapm_widget_for_each_path_safe'
468   - 'snd_soc_dapm_widget_for_each_sink_path'
469   - 'snd_soc_dapm_widget_for_each_source_path'
470   - 'tb_property_for_each'
471   - 'tcf_exts_for_each_action'
472   - 'udp_portaddr_for_each_entry'
473   - 'udp_portaddr_for_each_entry_rcu'
474   - 'usb_hub_for_each_child'
475   - 'v4l2_device_for_each_subdev'
476   - 'v4l2_m2m_for_each_dst_buf'
477   - 'v4l2_m2m_for_each_dst_buf_safe'
478   - 'v4l2_m2m_for_each_src_buf'
479   - 'v4l2_m2m_for_each_src_buf_safe'
480   - 'virtio_device_for_each_vq'
481   - 'while_for_each_ftrace_op'
482   - 'xa_for_each'
483   - 'xa_for_each_marked'
484   - 'xa_for_each_range'
485   - 'xa_for_each_start'
486   - 'xas_for_each'
487   - 'xas_for_each_conflict'
488   - 'xas_for_each_marked'
489   - 'xbc_array_for_each_value'
490   - 'xbc_for_each_key_value'
491   - 'xbc_node_for_each_array_value'
492   - 'xbc_node_for_each_child'
493   - 'xbc_node_for_each_key_value'
494   - 'zorro_for_each_dev'
495
496 #IncludeBlocks: Preserve # Unknown to clang-format-5.0
497 IncludeCategories:
498   - Regex: '.*'
499     Priority: 1
500 IncludeIsMainRegex: '(Test)?$'
501 IndentCaseLabels: false
502 #IndentPPDirectives: None # Unknown to clang-format-5.0
503 IndentWidth: 8
504 IndentWrappedFunctionNames: false
505 JavaScriptQuotes: Leave
506 JavaScriptWrapImports: true
507 KeepEmptyLinesAtTheStartOfBlocks: false
508 MacroBlockBegin: ''
509 MacroBlockEnd: ''
510 MaxEmptyLinesToKeep: 1
511 NamespaceIndentation: None
512 #ObjCBinPackProtocolList: Auto # Unknown to clang-format-5.0
513 ObjCBlockIndentWidth: 8
514 ObjCSpaceAfterProperty: true
515 ObjCSpaceBeforeProtocolList: true
516
517 # Taken from git's rules
518 #PenaltyBreakAssignment: 10 # Unknown to clang-format-4.0
519 PenaltyBreakBeforeFirstCallParameter: 30
520 PenaltyBreakComment: 10
521 PenaltyBreakFirstLessLess: 0
522 PenaltyBreakString: 10
523 PenaltyExcessCharacter: 100
524 PenaltyReturnTypeOnItsOwnLine: 60
525
526 PointerAlignment: Right
527 ReflowComments: false
528 SortIncludes: false
529 #SortUsingDeclarations: false # Unknown to clang-format-4.0
530 SpaceAfterCStyleCast: false
531 SpaceAfterTemplateKeyword: true
532 SpaceBeforeAssignmentOperators: true
533 #SpaceBeforeCtorInitializerColon: true # Unknown to clang-format-5.0
534 #SpaceBeforeInheritanceColon: true # Unknown to clang-format-5.0
535 SpaceBeforeParens: ControlStatements
536 #SpaceBeforeRangeBasedForLoopColon: true # Unknown to clang-format-5.0
537 SpaceInEmptyParentheses: false
538 SpacesBeforeTrailingComments: 1
539 SpacesInAngles: false
540 SpacesInContainerLiterals: false
541 SpacesInCStyleCastParentheses: false
542 SpacesInParentheses: false
543 SpacesInSquareBrackets: false
544 Standard: Cpp03
545 TabWidth: 8
546 UseTab: Always
547 ...