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