MAINTAINERS

   1
   2
   3         List of maintainers and how to submit coreboot changes
   4
   5 Please try to follow the guidelines below.  This will make things
   6 easier on the maintainers.  Not all of these guidelines matter for every
   7 trivial patch so apply some common sense.
   8
   9 1.      Always _test_ your changes, however small, on at least 1 or
  10         2 people, preferably many more.
  11
  12 2.      Try to release a few ALPHA test versions to gerrit. Announce
  13         them onto the coreboot mailing list and IRC channel and await
  14         results. This is especially important on coreboot core changes,
  15         but also for device drivers, because often that's the only way
  16         you will find things like the fact revision 3 chipset needs
  17         a magic fix you didn't know about, or some clown changed the
  18         chips on a board and not its name.  (Don't laugh!)
  19
  20 3.      Make sure your changes compile correctly in multiple
  21         configurations. In particular check that changes work for all
  22         boards in the tree (use abuild!)
  23
  24 4.      When you are happy with a change make it generally available for
  25         testing in gerrit and await feedback.
  26
  27 5.      Make your patch available through coreboot's gerrit code review
  28         system, and add the relevant maintainer from this list as a code
  29         reviewer. Be prepared to get your changes sent back with seemingly
  30         silly requests about formatting and variable names.  These aren't
  31         as silly as they seem. One job the maintainers do is to keep
  32         things looking the same.  Sometimes this means that the clever
  33         hack in your mainboard or chipset to get around a problem actually
  34         needs to become a generalized coreboot feature ready for next time.
  35
  36         PLEASE check your patch with the automated style checker
  37         (util/lint/checkpatch.pl) to catch trival style violations.
  38         See http://coreboot.org/Coding_Style for guidance here.
  39
  40         PLEASE add the maintainers that are generated by
  41         util/scripts/get_maintainer.pl as reviewers.  The results returned
  42         by the script will be best if you have git installed and are
  43         making your changes in a branch derived from coreboot.org's latest
  44         git tree.
  45
  46         PLEASE try to include any credit lines you want added with the
  47         patch. It avoids people being missed off by mistake and makes
  48         it easier to know who wants adding and who doesn't.
  49
  50         PLEASE document known bugs. If it doesn't work for everything
  51         or does something very odd once a month document it.
  52
  53         PLEASE remember that submissions must be made under the terms
  54         of the OSDL certificate of contribution and should include a
  55         Signed-off-by: line.  The current version of this "Developer's
  56         Certificate of Origin" (DCO) is listed at
  57         http://coreboot.org/Development_Guidelines#Sign-off_Procedure.
  58
  59 6.      Make sure you have the right to send any changes you make. If you
  60         do changes at work you may find your employer owns the patch
  61         not you.
  62
  63 7.      Happy hacking.
  64
  65 Descriptions of section entries:
  66
  67         M: Maintainer: FullName <address@domain>
  68         R: Designated reviewer: FullName <address@domain>
  69            These reviewers should be CCed on patches.
  70         L: Mailing list that is relevant to this area
  71         W: Web-page with status/info
  72         Q: Patchwork web based patch tracking system site
  73         T: SCM tree type and location.
  74            Type is one of: git, hg, quilt, stgit, topgit
  75         S: Status, one of the following:
  76            Supported:   Someone is actually paid to look after this.
  77            Maintained:  Someone actually looks after it.
  78            Odd Fixes:   It has a maintainer but they don't have time to do
  79                         much other than throw the odd patch in. See below..
  80            Orphan:      No current maintainer [but maybe you could take the
  81                         role as you write your new code].
  82            Obsolete:    Old code. Something tagged obsolete generally means
  83                         it has been replaced by a better system and you
  84                         should be using that.
  85         F: Files and directories with wildcard patterns.
  86            A trailing slash includes all files and subdirectory files.
  87            F:   drivers/net/    all files in and below drivers/net
  88            F:   drivers/net/*   all files in drivers/net, but not below
  89            F:   */net/*         all files in "any top level directory"/net
  90            One pattern per line.  Multiple F: lines acceptable.
  91         N: Files and directories with regex patterns.
  92            N:   [^a-z]tegra     all files whose path contains the word tegra
  93            One pattern per line.  Multiple N: lines acceptable.
  94            scripts/get_maintainer.pl has different behavior for files that
  95            match F: pattern and matches of N: patterns.  By default,
  96            get_maintainer will not look at git log history when an F: pattern
  97            match occurs.  When an N: match occurs, git log history is used
  98            to also notify the people that have git commit signatures.
  99         X: Files and directories that are NOT maintained, same rules as F:
 100            Files exclusions are tested before file matches.
 101            Can be useful for excluding a specific subdirectory, for instance:
 102            F:   net/
 103            X:   net/ipv6/
 104            matches all files in and below net excluding net/ipv6/
 105         K: Keyword perl extended regex pattern to match content in a
 106            patch or file.  For instance:
 107            K: of_get_profile
 108               matches patches or files that contain "of_get_profile"
 109            K: \b(printk|pr_(info|err))\b
 110               matches patches or files that contain one or more of the words
 111               printk, pr_info or pr_err
 112            One regex pattern per line.  Multiple K: lines acceptable.
 113
 114 Note: For the hard of thinking, this list is meant to remain in alphabetical
 115 order. If you could add yourselves to it in alphabetical order that would be
 116 so much easier [Ed]
 117
 118 Maintainers List (try to look for most precise areas first)
 119
 120                 -----------------------------------
 121
 122 RISC-V ARCHITECTURE
 123 M:      Ronald Minnich <rminnich@gmail.com>
 124 S:      Maintained
 125 F:      src/arch/riscv/
 126 F:      src/soc/ucb/
 127 F:      src/mainboard/emulation/qemu-riscv/
 128
 129 LENOVO EC
 130 M:      Alexander Couzens <lynxis@fe80.eu>
 131 S:      Maintained
 132 F:      src/ec/lenovo/
 133
 134 LENOVO MAINBOARDS
 135 M:      Alexander Couzens <lynxis@fe80.eu>
 136 S:      Maintained
 137 F:      src/mainboard/lenovo/
 138
 139 GOOGLE PANTHER MAINBOARD
 140 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
 141 S:      Supported
 142 F:      src/mainboard/google/panther/
 143
 144 INTEL FSP IVYBRIDGE/PANTHERPOINT/CAVECREEK & CRBs
 145 M:      York Yang <york.yang@intel.com>
 146 S:      Supported
 147 F:      src/cpu/intel/fsp_model_206ax/
 148 F:      src/northbridge/intel/fsp_sandybridge/
 149 F:      src/southbridge/intel/fsp_bd82x6x/
 150 F:      src/southbridge/intel/fsp_i89xx/
 151 F:      src/vendorcode/intel/fsp1_0/ivybridge_bd82x6x
 152 F:      src/vendorcode/intel/fsp1_0/ivybridge_i89xx
 153 F:      src/mainboard/intel/cougar_canyon2/
 154 F:      src/mainboard/intel/stargo2/
 155
 156 INTEL MINNOWBOARD MAX MAINBOARD
 157 M:      Huang Jin <huang.jin@intel.com>
 158 M:      York Yang <york.yang@intel.com>
 159 M:      Martin Roth <gaumless@gmail.com>
 160 S:      Supported
 161 F:      src/mainboard/intel/minnowmax/
 162
 163 INTEL FSP BAYTRAIL CHIP & CRBs
 164 M:      Huang Jin <huang.jin@intel.com>
 165 M:      York Yang <york.yang@intel.com>
 166 M:      Martin Roth <gaumless@gmail.com>
 167 S:      Supported
 168 F:      src/soc/intel/fsp_baytrail/
 169 F:      src/vendorcode/intel/fsp1_0/baytrail/
 170 F:      src/mainboard/intel/bakersport_fsp/
 171 F:      src/mainboard/intel/bayleybay_fsp/
 172
 173 FSP 1.0 RANGELEY & CRB
 174 M:      David Guckian <david.guckian@intel.com>
 175 M:      Fei Wang <fei.z.wang@intel.com>
 176 S:      Supported
 177 F:      src/cpu/intel/fsp_model_406dx/
 178 F:      src/northbridge/intel/fsp_rangeley/
 179 F:      src/southbridge/intel/fsp_rangeley/
 180 F:      src/vendorcode/intel/fsp1_0/rangeley/
 181 F:      src/mainboard/intel/mohonpeak/
 182
 183 INTEL LITTLE PLAINS MAINBOARD
 184 M:      Marcin Wojciechowski <marcin.wojciechowski@intel.com>
 185 S:      Supported
 186 F:      src/mainboard/intel/littleplains/
 187
 188 INTEL FSP 1.0
 189 M:      Huang Jin <huang.jin@intel.com>
 190 M:      York Yang <york.yang@intel.com>
 191 M:      Martin Roth <gaumless@gmail.com>
 192 S:      Supported
 193 F:      src/drivers/intel/fsp1_0/
 194
 195 INTEL FSP 1.1
 196 M:      Lee Leahy <leroy.p.leahy@intel.com>
 197 M:      Andrey Petrov <andrey.petrov@intel.com>
 198 M:      Huang Jin <huang.jin@intel.com>
 199 M:      York Yang <york.yang@intel.com>
 200 S:      Supported
 201 F:      src/drivers/intel/fsp1_1/
 202
 203 ASUS KFSN4-DRE & KFSN4-DRE_K8 MAINBOARDS
 204 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
 205 S:      Supported
 206 F:      src/mainboard/asus/kfsn4-dre/
 207 F:      src/mainboard/asus/kfsn4-dre_k8/
 208
 209 ASUS KCMA-D8 MAINBOARD
 210 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
 211 S:      Supported
 212 F:      src/mainboard/asus/kcma-d8/
 213
 214 ASUS KGPE-D16 MAINBOARD
 215 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
 216 S:      Supported
 217 F:      src/mainboard/asus/kgpe-d16/
 218
 219 AMD FAMILY10H & FAMILY15H (NON-AGESA) CPUS & NORTHBRIDGE
 220 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
 221 S:      Supported
 222 F:      src/cpu/amd/family_10h-family_15h/
 223 F:      src/northbridge/amd/amdfam10/
 224 F:      src/northbridge/amd/amdmct/
 225 F:      src/northbridge/amd/amdht/
 226
 227 AMD SB700 (NON-CIMX) SOUTHBRIDGE
 228 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
 229 S:      Supported
 230 F:      src/southbridge/amd/sb700/
 231
 232 AMD SR5650 SOUTHBRIDGE
 233 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
 234 S:      Supported
 235 F:      src/southbridge/amd/sr5650/
 236
 237 ASPEED AST2050 DRIVER & COMMON CODE
 238 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
 239 S:      Supported
 240 F:      src/drivers/aspeed/common/
 241 F:      src/drivers/aspeed/ast2050/
 242
 243 ATI MACH64 Driver
 244 S:      Orphan
 245 F:      src/drivers/ati/mach64/
 246
 247 ABUILD
 248 M:      Patrick Georgi <patrick@georgi-clan.de>
 249 S:      Supported
 250 F:      util/abuild/
 251
 252 ACPI
 253 F:      src/acpi/
 254 F:      src/arch/x86/acpi/
 255 F:      util/acpi/
 256
 257 ARM ARCHITECTURE
 258 F:      src/arch/arm/
 259 F:      src/arch/arm64
 260 F:      src/cpu/allwinner/
 261 F:      src/cpu/armltd/
 262 F:      src/cpu/samsung/
 263 F:      src/cpu/ti/
 264 F:      src/soc/broadcom/
 265 F:      src/soc/marvell/
 266 F:      src/soc/nvidia/
 267 F:      src/soc/qualcomm/
 268 F:      src/soc/rockchip/
 269 F:      src/soc/samsung/
 270 F:      util/arm_boot_tools/
 271 F:      util/broadcom/
 272 F:      util/exynos/
 273 F:      util/ipqheader/
 274 F:      util/nvidia/
 275 F:      util/rockchip/
 276
 277 MIPS ARCHITECTURE
 278 F:      src/arch/mips/
 279 F:      src/cpu/mips/
 280 F:      src/soc/imgtec/
 281 F:      util/bimgtool/
 282
 283 X86 ARCHITECTURE
 284 F:      src/arch/x86/
 285 F:      src/cpu/x86/
 286 F:      src/drivers/pc80/
 287 F:      src/include/pc80/
 288 F:      src/include/cpu/x86/
 289
 290 INTEL SUPPORT
 291 F:      src/vendorcode/intel/
 292 F:      src/cpu/intel/
 293 F:      src/northbridge/intel/
 294 F:      src/southbridge/intel/
 295 F:      src/soc/intel/
 296 F:      src/drivers/intel/
 297 F:      src/include/cpu/intel/
 298
 299 AMD SUPPORT
 300 F:      src/vendorcode/amd/
 301 F:      src/cpu/amd/
 302 F:      src/northbridge/amd/
 303 F:      src/southbridge/amd/
 304 F:      src/include/cpu/amd/
 305
 306 VIA SUPPORT
 307 F:      src/cpu/via/
 308 F:      src/northbridge/via/
 309 F:      src/southbridge/via/
 310
 311 LINT SCRIPTS
 312 M:      Patrick Georgi <patrick@georgi-clan.de>
 313 S:      Supported
 314 F:      util/lint/
 315
 316 INTELTOOL
 317 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
 318 F:      util/inteltool/
 319
 320 IFDTOOL
 321 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
 322 F:      util/ifdtool/
 323 F:      util/ifdfake/
 324
 325 BUILD SYSTEM
 326 M:      Patrick Georgi <patrick@georgi-clan.de>
 327 M:      Martin Roth <gaumless@gmail.com>
 328 S:      Supported
 329 F:      Makefile
 330 F:      *.inc
 331 F:      src/include/kconfig.h
 332 F:      util/kconfig/
 333 F:      util/sconfig/
 334
 335 BOARD STATUS
 336 F:      util/board_status/
 337
 338 BINARY OBJECTS
 339 F:      3rdparty/blobs/
 340
 341 VERIFIED BOOT
 342 F:      3rdparty/vboot/
 343 F:      src/vendorcode/google/chromeos/
 344 F:      src/include/tpm.h
 345 F:      src/include/tpm_lite/
 346
 347 RESOURCE ALLOCATOR
 348 F:      src/device/*
 349 F:      src/include/device/
 350 F:      src/include/cpu/cpu.h
 351
 352 OPTION ROM EXECUTION & X86EMU
 353 F:      src/device/oprom/
 354
 355 CBFS
 356 F:      src/include/cbfs.h
 357 F:      src/include/cbfs_serialized.h
 358 F:      util/cbfstool/
 359
 360 CBMEM
 361 F:      src/include/cbmem.h
 362 F:      src/include/cbmem_id.h
 363 F:      util/cbmem/
 364
 365 CONSOLE
 366 F:      src/console/
 367 F:      src/include/console/
 368 F:      src/drivers/uart/
 369
 370 NVRAM
 371 F:      util/nvramtool/
 372 F:      util/optionlist/
 373 F:      payloads/nvramcui/
 374
 375 LIBPAYLOAD
 376 F:      payloads/libpayload/
 377
 378 BAYOU PAYLOAD
 379 F:      payloads/bayou/
 380
 381 COREINFO PAYLOAD
 382 F:      payloads/coreinfo/
 383
 384 EXTERNAL PAYLOADS INTEGRATION
 385 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
 386 F:      payloads/external
 387
 388 VERIFIED BOOT 2
 389 M:      Aaron Durbin <adurbin@chromium.org>
 390 F:      src/vendorcode/google/chromeos/vboot2/
 391
 392 MISSING: TIMERS / DELAYS
 393
 394 MISSING: TIMESTAMPS
 395
 396 MISSING: MEMLAYOUT
 397
 398 MISSING: FMAP
 399
 400 MISSING: GPIO
 401
 402 MISSING: SMP
 403
 404 MISSING: SUPERIOS
 405
 406 MISSING: DMP / QEMU-X86
 407
 408 MISSING: ELOG
 409
 410 MISSING: GENERIC DRAM (should drop)
 411
 412 MISSING: SPI
 413
 414 THE REST
 415 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
 416 L:      coreboot@coreboot.org
 417 T:      git http://review.coreboot.org/coreboot
 418 S:      Buried alive in mainboards
 419 F:      *
 420 F:      */