mb/google/hatch: reflow comment
[coreboot.git] / MAINTAINERS
blob77769c0487de3a82e388d551f64b40070373a444
3                     List of upstream coreboot maintainers
4                      and how to submit coreboot changes
6 This represents the list of maintainers that work on the upstream coreboot
7 code base (on coreboot.org).  Maintainers are assigned to topics and when
8 applicable to subtrees of the source tree. You'll find some subtrees that
9 don't have a maintainer. If you are looking for reviewers for such a sub-
10 tree, it's often a good choice to look at the git history to see who worked
11 on it last.
13 Please try to follow the guidelines below.  This will make things
14 easier on the maintainers.  Not all of these guidelines matter for every
15 trivial patch so apply some common sense.
17 1.      Always _test_ your changes, however small, on at least 1 or
18         2 people, preferably many more.
20 2.      Try to release a few ALPHA test versions to gerrit. Announce
21         them onto the coreboot mailing list and IRC channel and await
22         results. This is especially important on coreboot core changes,
23         but also for device drivers, because often that's the only way
24         you will find things like the fact revision 3 chipset needs
25         a magic fix you didn't know about, or some clown changed the
26         chips on a board and not its name.  (Don't laugh!)
28 3.      Make sure your changes compile correctly in multiple
29         configurations. In particular check that changes work for all
30         boards in the tree (use abuild!)
32 4.      When you are happy with a change make it generally available for
33         testing in gerrit and await feedback.
35 5.      Make your patch available through coreboot's gerrit code review
36         system, and add the relevant maintainer from this list as a code
37         reviewer. Be prepared to get your changes sent back with seemingly
38         silly requests about formatting and variable names.  These aren't
39         as silly as they seem. One job the maintainers do is to keep
40         things looking the same.  Sometimes this means that the clever
41         hack in your mainboard or chipset to get around a problem actually
42         needs to become a generalized coreboot feature ready for next time.
44         PLEASE check your patch with the automated style checker
45         (util/lint/checkpatch.pl) to catch trival style violations.
46         See https://www.coreboot.org/Coding_Style for guidance here.
48         PLEASE add the maintainers that are generated by
49         util/scripts/get_maintainer.pl as reviewers.  The results returned
50         by the script will be best if you have git installed and are
51         making your changes in a branch derived from coreboot.org's latest
52         git tree.
54         PLEASE try to include any credit lines you want added with the
55         patch. It avoids people being missed off by mistake and makes
56         it easier to know who wants adding and who doesn't.
58         PLEASE document known bugs. If it doesn't work for everything
59         or does something very odd once a month document it.
61         PLEASE remember that submissions must be made under the terms
62         of the OSDL certificate of contribution and should include a
63         Signed-off-by: line.  The current version of this "Developer's
64         Certificate of Origin" (DCO) is listed at
65         https://www.coreboot.org/Development_Guidelines#Sign-off_Procedure.
67 6.      Make sure you have the right to send any changes you make. If you
68         do changes at work you may find your employer owns the patch
69         not you.
71 7.      Happy hacking.
73 Descriptions of section entries:
75         M: Maintainer: FullName <address@domain>
76            Must be registered to Gerrit (https://review.coreboot.org/).
77            Should have experience with upstream coreboot development.
78         R: Designated reviewer: FullName <address@domain>
79            These reviewers should be CCed on patches.
80         L: Mailing list that is relevant to this area
81         W: Web-page with status/info
82         Q: Patchwork web based patch tracking system site
83         T: SCM tree type and location.
84            Type is one of: git, hg, quilt, stgit, topgit
85         S: Status, one of the following:
86            Supported:   Someone is continuously paid to look after this and
87                         a reaction to review requests can be expected
88                         within a few days, a month at most.
89            Maintained:  Someone actually looks after it and a reaction to
90                         review requests can usually be expected within a
91                         few weeks.
92            Odd Fixes:   It has a maintainer but they don't have time to do
93                         much other than throw the odd patch in. See below..
94            Orphan:      No current maintainer [but maybe you could take the
95                         role as you write your new code].
96            Obsolete:    Old code. Something tagged obsolete generally means
97                         it has been replaced by a better system and you
98                         should be using that.
99         F: Files and directories with wildcard patterns.
100            A trailing slash includes all files and subdirectory files.
101            F:   drivers/net/    all files in and below drivers/net
102            F:   drivers/net/*   all files in drivers/net, but not below
103            F:   */net/*         all files in "any top level directory"/net
104            One pattern per line.  Multiple F: lines acceptable.
105         N: Files and directories with regex patterns.
106            N:   [^a-z]tegra     all files whose path contains the word tegra
107            One pattern per line.  Multiple N: lines acceptable.
108            scripts/get_maintainer.pl has different behavior for files that
109            match F: pattern and matches of N: patterns.  By default,
110            get_maintainer will not look at git log history when an F: pattern
111            match occurs.  When an N: match occurs, git log history is used
112            to also notify the people that have git commit signatures.
113         X: Files and directories that are NOT maintained, same rules as F:
114            Files exclusions are tested before file matches.
115            Can be useful for excluding a specific subdirectory, for instance:
116            F:   net/
117            X:   net/ipv6/
118            matches all files in and below net excluding net/ipv6/
119         K: Keyword perl extended regex pattern to match content in a
120            patch or file.  For instance:
121            K: of_get_profile
122               matches patches or files that contain "of_get_profile"
123            K: \b(printk|pr_(info|err))\b
124               matches patches or files that contain one or more of the words
125               printk, pr_info or pr_err
126            One regex pattern per line.  Multiple K: lines acceptable.
128 Note: For the hard of thinking, this list is meant to remain in alphabetical
129 order. If you could add yourselves to it in alphabetical order that would be
130 so much easier [Ed]
132 Maintainers List (try to look for most precise areas first)
134                 -----------------------------------
136 RISC-V ARCHITECTURE
137 M:      Ronald Minnich <rminnich@gmail.com>
138 R:      Philipp Hug <philipp@hug.cx>
139 S:      Maintained
140 F:      src/arch/riscv/
141 F:      src/soc/sifive/
142 F:      src/soc/ucb/
143 F:      src/mainboard/emulation/*-riscv/
144 F:      src/mainboard/sifive/
145 F:      util/riscv/
147 PPC64 ARCHITECTURE
148 M:      Ronald Minnich <rminnich@gmail.com>
149 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
150 S:      Maintained
151 F:      src/arch/ppc64/
152 F:      src/cpu/qemu-power8/
153 F:      src/mainboard/emulation/qemu-power8/
155 LENOVO EC
156 M:      Alexander Couzens <lynxis@fe80.eu>
157 S:      Maintained
158 F:      src/ec/lenovo/
160 LENOVO MAINBOARDS
161 M:      Alexander Couzens <lynxis@fe80.eu>
162 M:      Patrick Rudolph <siro@das-labor.org>
163 S:      Maintained
164 F:      src/mainboard/lenovo/
166 LENOVO G505S MAINBOARD
167 M:      Mike Banon <mikebdp2@gmail.com>
168 S:      Maintained
169 F:      src/mainboard/lenovo/g505s/
171 APPLE MAINBOARDS
172 M:      Evgeny Zinoviev <me@ch1p.io>
173 S:      Maintained
174 F:      src/mainboard/apple/
176 GETAC P470 MAINBOARD
177 M:      Patrick Georgi <patrick@georgi.software>
178 S:      Maintained
179 F:      src/mainboard/getac/p470
181 INTEL PINEVIEW CHIPSET
182 M:      Damien Zammit <damien@zamaudio.com>
183 S:      Odd Fixes
184 F:      src/northbridge/intel/pineview/
186 INTEL D510MO MAINBOARD
187 M:      Damien Zammit <damien@zamaudio.com>
188 S:      Odd Fixes
189 F:      src/mainboard/intel/d510mo
191 INTEL X4X CHIPSET
192 M:      Damien Zammit <damien@zamaudio.com>
193 S:      Odd Fixes
194 F:      src/northbridge/intel/x4x/
196 GIGABYTE GA-G41M-ES2L MAINBOARD
197 M:      Damien Zammit <damien@zamaudio.com>
198 S:      Odd Fixes
199 F:      src/mainboard/gigabyte/ga-g41m-es2l
201 GIGABYTE GA-H61M-S2PV MAINBOARD
202 M:      Angel Pons <th3fanbus@gmail.com>
203 S:      Maintained
204 F:      src/mainboard/gigabyte/ga-h61m-s2pv
206 GOOGLE PANTHER MAINBOARD
207 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
208 S:      Supported
209 F:      src/mainboard/google/panther/
211 GOOGLE MAINBOARDS (Intel-based, legacy/inactive)
212 M:      Matt DeVillier <MrChromebox@gmail.com>
213 S:      Maintained
214 F:      src/mainboard/google/auron/
215 F:      src/mainboard/google/beltino/
216 F:      src/mainboard/google/butterfly/
217 F:      src/mainboard/google/cyan/
218 F:      src/mainboard/google/glados/
219 F:      src/mainboard/google/jecht/
220 F:      src/mainboard/google/link/
221 F:      src/mainboard/google/parrot/
222 F:      src/mainboard/google/slippy/
223 F:      src/mainboard/google/stout/
225 OPENCELLULAR MAINBOARDS
226 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
227 M:      Patrick Rudolph <patrick.rudolph@9elements.com>
228 S:      Supported
229 F:      src/mainboard/opencellular/elgon/
231 PURISM MAINBOARDS
232 M:      Matt DeVillier <matt.devillier@puri.sm>
233 S:      Supported
234 F:      src/mainboard/purism
236 SAMSUNG CHROMEOS MAINBOARDS
237 M:      Matt DeVillier <MrChromebox@gmail.com>
238 S:      Maintained
239 F:      src/mainboard/samsung/lumpy/
240 F:      src/mainboard/samsung/stumpy/
242 INTEL FSP DENVERTON-NS SOC & HARCUVAR CRB
243 M:      Vanessa Eusebio <vanessa.f.eusebio@intel.com>
244 M:      David Guckian <david.guckian@intel.com>
245 S:      Odd Fixes
246 F:      src/mainboard/intel/harcuvar/
247 F:      src/soc/intel/denverton_ns/
248 F:      src/vendorcode/intel/fsp/fsp2_0/denverton_ns/
250 INTEL FSP 1.1
251 M:      Lee Leahy <leroy.p.leahy@intel.com>
252 M:      Huang Jin <huang.jin@intel.com>
253 M:      York Yang <york.yang@intel.com>
254 S:      Supported
255 F:      src/drivers/intel/fsp1_1/
257 INTEL FSP 2.0
258 M:      Andrey Petrov <andrey.petrov@gmail.com>
259 S:      Maintained
260 F:      src/drivers/intel/fsp2_0/
262 INTEL STRAGO MAINBOARD
263 M:      Hannah Williams <hannah.williams@intel.com>
264 S:      Supported
265 F:      /src/mainboard/intel/strago/
267 INTEL BRASWELL SOC
268 M:      Piotr Król <piotr.krol@3mdeb.com>
269 M:      Michał Żygowski <michal.zygowski@3mdeb.com>
270 M:      Frans Hendriks <fhendriks@eltan.com>
271 S:      Maintained
272 F:      /src/soc/intel/braswell
273 F:      /src/vendorcode/intel/fsp/fsp1_1/braswell
275 INTEL APOLLOLAKE_SOC
276 M:      Andrey Petrov <andrey.petrov@gmail.com>
277 S:      Maintained
278 F:      src/soc/intel/apollolake/
280 ASROCK G41C-GS MAINBOARD & VARIANTS
281 M:      Angel Pons <th3fanbus@gmail.com>
282 S:      Maintained
283 F:      src/mainboard/asrock/g41c-gs/
285 ASROCK H81M-HDS MAINBOARD
286 M:      Tristan Corrick <tristan@corrick.kiwi>
287 S:      Maintained
288 F:      src/mainboard/asrock/h81m-hds/
290 ASUS AM1I-A MAINBOARD
291 M:      Mike Banon <mikebdp2@gmail.com>
292 S:      Maintained
293 F:      src/mainboard/asus/am1i-a/
295 ASUS MAXIMUS IV GENE-Z MAINBOARD
296 M:      Tristan Corrick <tristan@corrick.kiwi>
297 S:      Maintained
298 F:      src/mainboard/asus/maximus_iv_gene-z/
300 ASUS P5QC PRO MAINBOARD & VARIANTS
301 M:      Angel Pons <th3fanbus@gmail.com>
302 S:      Maintained
303 F:      src/mainboard/asus/p5qc/
305 ASUS P8H61-M LX MAINBOARD
306 M:      Tristan Corrick <tristan@corrick.kiwi>
307 S:      Maintained
308 F:      src/mainboard/asus/p8h61-m_lx/
310 ASUS P8H61-M PRO MAINBOARD
311 M:      Angel Pons <th3fanbus@gmail.com>
312 S:      Maintained
313 F:      src/mainboard/asus/p8h61-m_pro/
315 ASUS P8Z77-M PRO MAINBOARD
316 M:      Vlado Cibic <vladocb@protonmail.com>
317 S:      Maintained
318 F:      src/mainboard/asus/p8z77-m_pro/
320 PC ENGINES ALL MAINBOARDS
321 M:      Piotr Król <piotr.krol@3mdeb.com>
322 M:      Michał Żygowski <michal.zygowski@3mdeb.com>
323 S:      Supported
324 F:      src/mainboard/pcengines/
326 SIEMENS MC_xxxx MAINBOARDS
327 M:      Werner Zeh <werner.zeh@siemens.com>
328 S:      Maintained
329 F:      src/mainboard/siemens/mc_apl1/
331 SUPERMICRO X10SLM+-F MAINBOARD
332 M:      Tristan Corrick <tristan@corrick.kiwi>
333 S:      Maintained
334 F:      src/mainboard/supermicro/x10slm-f/
336 SUPERMICRO X11-LGA1151-SERIES
337 M:      Michael Niewöhner <foss@mniewoehner.de>
338 S:      Maintained
339 F:      src/mainboard/supermicro/x11-lga1151-series
341 FACEBOOK FBG1701 MAINBOARD
342 M:      Frans Hendriks <fhendriks@eltan.com>
343 M:      Wim Vervoorn <wvervoorn@eltan.com>
344 S:      Maintained
345 F:      src/mainboard/facebook/fbg1701/
347 FACEBOOK MONOLITH MAINBOARD
348 M:      Frans Hendriks <fhendriks@eltan.com>
349 M:      Wim Vervoorn <wvervoorn@eltan.com>
350 S:      Maintained
351 F:      src/mainboard/facebook/monolith/
353 PORTWELL PQ-M107 MAINBOARD
354 M:      Frans Hendriks <fhendriks@eltan.com>
355 M:      Wim Vervoorn <wvervoorn@eltan.com>
356 S:      Maintained
357 F:      src/mainboard/portwell/m107/
359 ASPEED AST2050 DRIVER & COMMON CODE
360 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
361 S:      Supported
362 F:      src/drivers/aspeed/common/
363 F:      src/drivers/aspeed/ast2050/
365 ATI MACH64 Driver
366 S:      Orphan
367 F:      src/drivers/ati/mach64/
369 ABUILD
370 M:      Patrick Georgi <patrick@georgi-clan.de>
371 M:      Martin Roth <gaumless@gmail.com>
372 S:      Supported
373 F:      util/abuild/
375 ACPI
376 F:      src/acpi/
377 F:      src/arch/x86/acpi/
378 F:      util/acpi/
380 LZ4 COMPRESSION
381 M:      Julius Werner <jwerner@chromium.org>
382 S:      Supported
383 F:      src/commonlib/lz4*
384 F:      payloads/libpayload/liblz4/
385 F:      util/cbfstool/lz4/
387 ARM ARCHITECTURE
388 M:      Julius Werner <jwerner@chromium.org>
389 S:      Supported
390 F:      src/arch/arm/
391 F:      src/arch/arm64/
392 F:      src/soc/mediatek/
393 F:      src/soc/nvidia/
394 F:      src/soc/rockchip/
395 F:      util/nvidia/
396 F:      util/rockchip/
398 ORPHANED ARM SOCS
399 S:      Orphaned
400 F:      src/cpu/allwinner/
401 F:      src/cpu/armltd/
402 F:      src/cpu/ti/
403 F:      src/soc/marvell/
404 F:      src/soc/qualcomm/
405 F:      src/soc/samsung/
406 F:      util/arm_boot_tools/
407 F:      util/exynos/
408 F:      util/ipqheader/
410 X86 ARCHITECTURE
411 F:      src/arch/x86/
412 F:      src/cpu/x86/
413 F:      src/drivers/pc80/
414 F:      src/include/pc80/
415 F:      src/include/cpu/x86/
417 INTEL SUPPORT
418 M:      Patrick Rudolph <siro@das-labor.org>
419 S:      Maintained
420 F:      src/vendorcode/intel/
421 F:      src/cpu/intel/
422 F:      src/northbridge/intel/
423 F:      src/southbridge/intel/
424 F:      src/soc/intel/
425 F:      src/drivers/intel/
426 F:      src/include/cpu/intel/
428 AMD SUPPORT
429 F:      src/vendorcode/amd/
430 F:      src/cpu/amd/
431 F:      src/northbridge/amd/
432 F:      src/southbridge/amd/
433 F:      src/include/cpu/amd/
435 LINT SCRIPTS
436 M:      Patrick Georgi <patrick@georgi-clan.de>
437 M:      Martin Roth <gaumless@gmail.com>
438 S:      Supported
439 F:      util/lint/
441 INTELTOOL
442 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
443 F:      util/inteltool/
445 INTELMETOOL
446 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
447 F:      util/intelmetool/
449 ME_CLEANER
450 M:      Nicola Corna <nicola@corna.info>
451 W:      https://github.com/corna/me_cleaner
452 S:      Maintained
453 F:      util/me_cleaner/
455 IFDTOOL
456 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
457 F:      util/ifdtool/
459 BUILD SYSTEM
460 M:      Patrick Georgi <patrick@georgi-clan.de>
461 M:      Martin Roth <gaumless@gmail.com>
462 S:      Supported
463 F:      Makefile
464 F:      *.inc
465 F:      src/include/kconfig.h
466 F:      util/kconfig/
467 F:      util/sconfig/
468 F:      util/xcompile/
469 F:      util/genbuild_h/
471 BOARD STATUS
472 F:      util/board_status/
474 BINARY OBJECTS
475 F:      3rdparty/blobs/
477 VERIFIED BOOT
478 F:      3rdparty/vboot/
479 F:      src/vendorcode/google/chromeos/
480 F:      src/include/tpm.h
481 F:      src/include/tpm_lite/
483 RESOURCE ALLOCATOR
484 F:      src/device/*
485 F:      src/include/device/
486 F:      src/include/cpu/cpu.h
488 OPTION ROM EXECUTION & X86EMU
489 F:      src/device/oprom/
491 CBFS
492 F:      src/include/cbfs.h
493 F:      src/commonlib/bsd/include/commonlib/bsd/cbfs_serialized.h
494 F:      util/cbfstool/
496 CBMEM
497 F:      src/include/cbmem.h
498 F:      src/include/cbmem_id.h
499 F:      util/cbmem/
501 CONSOLE
502 F:      src/console/
503 F:      src/include/console/
504 F:      src/drivers/uart/
506 NVRAM
507 F:      util/nvramtool/
508 F:      util/optionlist/
509 F:      payloads/nvramcui/
511 LIBPAYLOAD
512 F:      payloads/libpayload/
514 BAYOU PAYLOAD
515 F:      payloads/bayou/
517 COREINFO PAYLOAD
518 F:      payloads/coreinfo/
520 EXTERNAL PAYLOADS INTEGRATION
521 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
522 M:      Martin Roth <gaumless@gmail.com>
523 F:      payloads/external
525 LINUXBOOT PAYLOAD INTEGRATION
526 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
527 M:      Marcello Sylvester Bauer <info@marcellobauer.com>
528 S:      Supported
529 F:      payloads/external/LinuxBoot
531 VERIFIED BOOT 2
532 M:      Aaron Durbin <adurbin@chromium.org>
533 F:      src/security/vboot/
535 TPM SUPPORT
536 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
537 S:      Supported
538 F:      src/drivers/*/tpm/
539 F:      src/security/vboot/vboot_crtm.*
540 F:      src/security/tpm
542 DOCKER
543 M:      Martin Roth <gaumless@gmail.com>
544 S:      Supported
545 F:      util/docker/
547 TOOLCHAIN
548 F:      util/crossgcc/
551 F:      .git*
552 F:      /util/gitconfig
554 SUPERIOS & SUPERIOTOOL
555 M:      Felix Held <felix-coreboot@felixheld.de>
556 S:      Maintained
557 F:      src/superio/
558 F:      util/superiotool/
560 MEMLAYOUT
561 M:      Julius Werner <jwerner@chromium.org>
562 S:      Supported
563 F:      */memlayout.h
564 F:      *.ld
566 ELTAN VENDORCODE
567 M:      Frans Hendriks <fhendriks@eltan.com>
568 M:      Wim Vervoorn <wvervoorn@eltan.com>
569 S:      Maintained
570 F:      src/vendorcode/eltan
572 MISSING: TIMERS / DELAYS
574 MISSING: TIMESTAMPS
576 MISSING: FMAP
578 MISSING: GPIO
580 MISSING: SMP
582 MISSING: DMP / QEMU-X86
584 MISSING: ELOG
586 MISSING: SPI
588 # *** Infrastructure Owners***
589 # This is intended to let people know who they should contact for issues with various infrastructure pieces.
590 # Hardware
591 #       Owners: Stefan, Patrick
592 #       Backups:
594 # Web Server
595 #       Owners: Stefan, Patrick
596 #       Backups:
598 # Website
599 #       Owners: Martin, Philipp
600 #       Backups: Patrick, Stefan
602 # Documentation Website
603 #       Owners: Patrick, Philipp
604 #       Backups:
606 CODE OF CONDUCT
607 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
608 M:      Patrick Georgi <patrick@coreboot.org>
609 M:      Ronald Minnich <rminnich@coreboot.org>
610 M:      Martin Roth <martin@coreboot.org>
611 S:      Maintained
612 F:      Documentation/community/code_of_conduct.md
614 # Wiki
615 #       Owners: Stefan, Patrick
616 #       Backups:
618 # Gerrit
619 #       Owners: Stefan, Patrick
620 #       Backups: Martin
622 # Jenkins
623 #       Owners: Patrick, Martin
624 #       Backups:
626 # Bug Tracker
627 #       Owners: Lynxis,
628 #       Backups: Martin,
630 # Mailing List
631 #       Owners: Stefan, Patrick
632 #       Backups: Martin,
634 # Software Freedom Conservancy
635 #       Main contact: Martin
636 #       “Official” contact: Stefan