Documentation: Fix table and layout
[coreboot.git] / MAINTAINERS
blob6c565f7db73b12d7e1d463ce55f8cf9aed0540d2
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 APPLE MAINBOARDS
167 M:      Evgeny Zinoviev <me@ch1p.io>
168 S:      Maintained
169 F:      src/mainboard/apple/
171 GETAC P470 MAINBOARD
172 M:      Patrick Georgi <patrick@georgi.software>
173 S:      Maintained
174 F:      src/mainboard/getac/p470
176 INTEL PINEVIEW CHIPSET
177 M:      Damien Zammit <damien@zamaudio.com>
178 S:      Odd Fixes
179 F:      src/northbridge/intel/pineview/
181 INTEL D510MO MAINBOARD
182 M:      Damien Zammit <damien@zamaudio.com>
183 S:      Odd Fixes
184 F:      src/mainboard/intel/d510mo
186 INTEL X4X CHIPSET
187 M:      Damien Zammit <damien@zamaudio.com>
188 S:      Odd Fixes
189 F:      src/northbridge/intel/x4x/
191 GIGABYTE GA-G41M-ES2L MAINBOARD
192 M:      Damien Zammit <damien@zamaudio.com>
193 S:      Odd Fixes
194 F:      src/mainboard/gigabyte/ga-g41m-es2l
196 GIGABYTE GA-H61M-S2PV MAINBOARD
197 M:      Angel Pons <th3fanbus@gmail.com>
198 S:      Maintained
199 F:      src/mainboard/gigabyte/ga-h61m-s2pv
201 GOOGLE PANTHER MAINBOARD
202 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
203 S:      Supported
204 F:      src/mainboard/google/panther/
206 GOOGLE MAINBOARDS (Intel-based, legacy/inactive)
207 M:      Matt DeVillier <MrChromebox@gmail.com>
208 S:      Maintained
209 F:      src/mainboard/google/auron/
210 F:      src/mainboard/google/beltino/
211 F:      src/mainboard/google/butterfly/
212 F:      src/mainboard/google/cyan/
213 F:      src/mainboard/google/glados/
214 F:      src/mainboard/google/jecht/
215 F:      src/mainboard/google/link/
216 F:      src/mainboard/google/parrot/
217 F:      src/mainboard/google/slippy/
218 F:      src/mainboard/google/stout/
220 OPENCELLULAR MAINBOARDS
221 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
222 M:      Patrick Rudolph <patrick.rudolph@9elements.com>
223 S:      Supported
224 F:      src/mainboard/opencellular/elgon/
226 PURISM MAINBOARDS
227 M:      Matt DeVillier <matt.devillier@puri.sm>
228 S:      Supported
229 F:      src/mainboard/purism
231 SAMSUNG CHROMEOS MAINBOARDS
232 M:      Matt DeVillier <MrChromebox@gmail.com>
233 S:      Maintained
234 F:      src/mainboard/samsung/lumpy/
235 F:      src/mainboard/samsung/stumpy/
237 INTEL FSP DENVERTON-NS SOC & HARCUVAR CRB
238 M:      Vanessa Eusebio <vanessa.f.eusebio@intel.com>
239 M:      David Guckian <david.guckian@intel.com>
240 S:      Odd Fixes
241 F:      src/mainboard/intel/harcuvar/
242 F:      src/soc/intel/denverton_ns/
243 F:      src/vendorcode/intel/fsp/fsp2_0/denverton_ns/
245 INTEL FSP 1.1
246 M:      Lee Leahy <leroy.p.leahy@intel.com>
247 M:      Huang Jin <huang.jin@intel.com>
248 M:      York Yang <york.yang@intel.com>
249 S:      Supported
250 F:      src/drivers/intel/fsp1_1/
252 INTEL FSP 2.0
253 M:      Andrey Petrov <andrey.petrov@gmail.com>
254 S:      Maintained
255 F:      src/drivers/intel/fsp2_0/
257 INTEL STRAGO MAINBOARD
258 M:      Hannah Williams <hannah.williams@intel.com>
259 S:      Supported
260 F:      /src/mainboard/intel/strago/
262 INTEL BRASWELL SOC
263 M:      Piotr Król <piotr.krol@3mdeb.com>
264 M:      Michał Żygowski <michal.zygowski@3mdeb.com>
265 M:      Frans Hendriks <fhendriks@eltan.com>
266 S:      Maintained
267 F:      /src/soc/intel/braswell
268 F:      /src/vendorcode/intel/fsp/fsp1_1/braswell
270 INTEL APOLLOLAKE_SOC
271 M:      Andrey Petrov <andrey.petrov@gmail.com>
272 S:      Maintained
273 F:      src/soc/intel/apollolake/
275 ASROCK G41C-GS MAINBOARD & VARIANTS
276 M:      Angel Pons <th3fanbus@gmail.com>
277 S:      Maintained
278 F:      src/mainboard/asrock/g41c-gs/
280 ASROCK H81M-HDS MAINBOARD
281 M:      Tristan Corrick <tristan@corrick.kiwi>
282 S:      Maintained
283 F:      src/mainboard/asrock/h81m-hds/
285 ASUS MAXIMUS IV GENE-Z MAINBOARD
286 M:      Tristan Corrick <tristan@corrick.kiwi>
287 S:      Maintained
288 F:      src/mainboard/asus/maximus_iv_gene-z/
290 ASUS P5QC PRO MAINBOARD & VARIANTS
291 M:      Angel Pons <th3fanbus@gmail.com>
292 S:      Maintained
293 F:      src/mainboard/asus/p5qc/
295 ASUS P8H61-M LX MAINBOARD
296 M:      Tristan Corrick <tristan@corrick.kiwi>
297 S:      Maintained
298 F:      src/mainboard/asus/p8h61-m_lx/
300 ASUS P8H61-M PRO MAINBOARD
301 M:      Angel Pons <th3fanbus@gmail.com>
302 S:      Maintained
303 F:      src/mainboard/asus/p8h61-m_pro/
305 ASUS P8Z77-M PRO MAINBOARD
306 M:      Vlado Cibic <vladocb@protonmail.com>
307 S:      Maintained
308 F:      src/mainboard/asus/p8z77-m_pro/
310 PC ENGINES ALL MAINBOARDS
311 M:      Piotr Król <piotr.krol@3mdeb.com>
312 M:      Michał Żygowski <michal.zygowski@3mdeb.com>
313 S:      Supported
314 F:      src/mainboard/pcengines/
316 SIEMENS MC_xxxx MAINBOARDS
317 M:      Werner Zeh <werner.zeh@siemens.com>
318 S:      Maintained
319 F:      src/mainboard/siemens/mc_apl1/
321 SUPERMICRO X10SLM+-F MAINBOARD
322 M:      Tristan Corrick <tristan@corrick.kiwi>
323 S:      Maintained
324 F:      src/mainboard/supermicro/x10slm-f/
326 SUPERMICRO X11-LGA1151-SERIES
327 M:      Michael Niewöhner <foss@mniewoehner.de>
328 S:      Maintained
329 F:      src/mainboard/supermicro/x11-lga1151-series
331 FACEBOOK FBG1701 MAINBOARD
332 M:      Frans Hendriks <fhendriks@eltan.com>
333 M:      Wim Vervoorn <wvervoorn@eltan.com>
334 S:      Maintained
335 F:      src/mainboard/facebook/fbg1701/
337 FACEBOOK MONOLITH MAINBOARD
338 M:      Frans Hendriks <fhendriks@eltan.com>
339 M:      Wim Vervoorn <wvervoorn@eltan.com>
340 S:      Maintained
341 F:      src/mainboard/facebook/monolith/
343 PORTWELL PQ-M107 MAINBOARD
344 M:      Frans Hendriks <fhendriks@eltan.com>
345 M:      Wim Vervoorn <wvervoorn@eltan.com>
346 S:      Maintained
347 F:      src/mainboard/portwell/m107/
349 ASPEED AST2050 DRIVER & COMMON CODE
350 M:      Timothy Pearson <tpearson@raptorengineeringinc.com>
351 S:      Supported
352 F:      src/drivers/aspeed/common/
353 F:      src/drivers/aspeed/ast2050/
355 ATI MACH64 Driver
356 S:      Orphan
357 F:      src/drivers/ati/mach64/
359 ABUILD
360 M:      Patrick Georgi <patrick@georgi-clan.de>
361 M:      Martin Roth <gaumless@gmail.com>
362 S:      Supported
363 F:      util/abuild/
365 ACPI
366 F:      src/acpi/
367 F:      src/arch/x86/acpi/
368 F:      util/acpi/
370 LZ4 COMPRESSION
371 M:      Julius Werner <jwerner@chromium.org>
372 S:      Supported
373 F:      src/commonlib/lz4*
374 F:      payloads/libpayload/liblz4/
375 F:      util/cbfstool/lz4/
377 ARM ARCHITECTURE
378 M:      Julius Werner <jwerner@chromium.org>
379 S:      Supported
380 F:      src/arch/arm/
381 F:      src/arch/arm64/
382 F:      src/soc/mediatek/
383 F:      src/soc/nvidia/
384 F:      src/soc/rockchip/
385 F:      util/nvidia/
386 F:      util/rockchip/
388 ORPHANED ARM SOCS
389 S:      Orphaned
390 F:      src/cpu/allwinner/
391 F:      src/cpu/armltd/
392 F:      src/cpu/ti/
393 F:      src/soc/marvell/
394 F:      src/soc/qualcomm/
395 F:      src/soc/samsung/
396 F:      util/arm_boot_tools/
397 F:      util/exynos/
398 F:      util/ipqheader/
400 X86 ARCHITECTURE
401 F:      src/arch/x86/
402 F:      src/cpu/x86/
403 F:      src/drivers/pc80/
404 F:      src/include/pc80/
405 F:      src/include/cpu/x86/
407 INTEL SUPPORT
408 M:      Patrick Rudolph <siro@das-labor.org>
409 S:      Maintained
410 F:      src/vendorcode/intel/
411 F:      src/cpu/intel/
412 F:      src/northbridge/intel/
413 F:      src/southbridge/intel/
414 F:      src/soc/intel/
415 F:      src/drivers/intel/
416 F:      src/include/cpu/intel/
418 AMD SUPPORT
419 F:      src/vendorcode/amd/
420 F:      src/cpu/amd/
421 F:      src/northbridge/amd/
422 F:      src/southbridge/amd/
423 F:      src/include/cpu/amd/
425 LINT SCRIPTS
426 M:      Patrick Georgi <patrick@georgi-clan.de>
427 M:      Martin Roth <gaumless@gmail.com>
428 S:      Supported
429 F:      util/lint/
431 INTELTOOL
432 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
433 F:      util/inteltool/
435 INTELMETOOL
436 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
437 F:      util/intelmetool/
439 ME_CLEANER
440 M:      Nicola Corna <nicola@corna.info>
441 W:      https://github.com/corna/me_cleaner
442 S:      Maintained
443 F:      util/me_cleaner/
445 IFDTOOL
446 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
447 F:      util/ifdtool/
449 BUILD SYSTEM
450 M:      Patrick Georgi <patrick@georgi-clan.de>
451 M:      Martin Roth <gaumless@gmail.com>
452 S:      Supported
453 F:      Makefile
454 F:      *.inc
455 F:      src/include/kconfig.h
456 F:      util/kconfig/
457 F:      util/sconfig/
458 F:      util/xcompile/
459 F:      util/genbuild_h/
461 BOARD STATUS
462 F:      util/board_status/
464 BINARY OBJECTS
465 F:      3rdparty/blobs/
467 VERIFIED BOOT
468 F:      3rdparty/vboot/
469 F:      src/vendorcode/google/chromeos/
470 F:      src/include/tpm.h
471 F:      src/include/tpm_lite/
473 RESOURCE ALLOCATOR
474 F:      src/device/*
475 F:      src/include/device/
476 F:      src/include/cpu/cpu.h
478 OPTION ROM EXECUTION & X86EMU
479 F:      src/device/oprom/
481 CBFS
482 F:      src/include/cbfs.h
483 F:      src/include/cbfs_serialized.h
484 F:      util/cbfstool/
486 CBMEM
487 F:      src/include/cbmem.h
488 F:      src/include/cbmem_id.h
489 F:      util/cbmem/
491 CONSOLE
492 F:      src/console/
493 F:      src/include/console/
494 F:      src/drivers/uart/
496 NVRAM
497 F:      util/nvramtool/
498 F:      util/optionlist/
499 F:      payloads/nvramcui/
501 LIBPAYLOAD
502 F:      payloads/libpayload/
504 BAYOU PAYLOAD
505 F:      payloads/bayou/
507 COREINFO PAYLOAD
508 F:      payloads/coreinfo/
510 EXTERNAL PAYLOADS INTEGRATION
511 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
512 M:      Martin Roth <gaumless@gmail.com>
513 F:      payloads/external
515 LINUXBOOT PAYLOAD INTEGRATION
516 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
517 M:      Marcello Sylvester Bauer <info@marcellobauer.com>
518 S:      Supported
519 F:      payloads/external/LinuxBoot
521 VERIFIED BOOT 2
522 M:      Aaron Durbin <adurbin@chromium.org>
523 F:      src/security/vboot/
525 TPM SUPPORT
526 M:      Philipp Deppenwiese <zaolin.daisuki@gmail.com>
527 S:      Supported
528 F:      src/drivers/*/tpm/
529 F:      src/security/vboot/vboot_crtm.*
530 F:      src/security/tpm
532 DOCKER
533 M:      Martin Roth <gaumless@gmail.com>
534 S:      Supported
535 F:      util/docker/
537 TOOLCHAIN
538 F:      util/crossgcc/
541 F:      .git*
542 F:      /util/gitconfig
544 SUPERIOS & SUPERIOTOOL
545 M:      Felix Held <felix-coreboot@felixheld.de>
546 S:      Maintained
547 F:      src/superio/
548 F:      util/superiotool/
550 MEMLAYOUT
551 M:      Julius Werner <jwerner@chromium.org>
552 S:      Supported
553 F:      */memlayout.h
554 F:      *.ld
556 ELTAN VENDORCODE
557 M:      Frans Hendriks <fhendriks@eltan.com>
558 M:      Wim Vervoorn <wvervoorn@eltan.com>
559 S:      Maintained
560 F:      src/vendorcode/eltan
562 MISSING: TIMERS / DELAYS
564 MISSING: TIMESTAMPS
566 MISSING: FMAP
568 MISSING: GPIO
570 MISSING: SMP
572 MISSING: DMP / QEMU-X86
574 MISSING: ELOG
576 MISSING: SPI
578 # *** Infrastructure Owners***
579 # This is intended to let people know who they should contact for issues with various infrastructure pieces.
580 # Hardware
581 #       Owners: Stefan, Patrick
582 #       Backups:
584 # Web Server
585 #       Owners: Stefan, Patrick
586 #       Backups:
588 # Website
589 #       Owners: Martin, Philipp
590 #       Backups: Patrick, Stefan
592 # Documentation Website
593 #       Owners: Patrick, Philipp
594 #       Backups:
596 CODE OF CONDUCT
597 M:      Stefan Reinauer <stefan.reinauer@coreboot.org>
598 M:      Patrick Georgi <patrick@coreboot.org>
599 M:      Ronald Minnich <rminnich@coreboot.org>
600 M:      Martin Roth <martin@coreboot.org>
601 S:      Maintained
602 F:      Documentation/community/code_of_conduct.md
604 # Wiki
605 #       Owners: Stefan, Patrick
606 #       Backups:
608 # Gerrit
609 #       Owners: Stefan, Patrick
610 #       Backups: Martin
612 # Jenkins
613 #       Owners: Patrick, Martin
614 #       Backups:
616 # Bug Tracker
617 #       Owners: Lynxis,
618 #       Backups: Martin,
620 # Mailing List
621 #       Owners: Stefan, Patrick
622 #       Backups: Martin,
624 # Software Freedom Conservancy
625 #       Main contact: Martin
626 #       “Official” contact: Stefan