blob: 5078bb09c67275870bd7208c3bd9423f0eeb41d2 [file] [log] [blame]
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -07001
2
3 List of maintainers and how to submit coreboot changes
4
5Please try to follow the guidelines below. This will make things
6easier on the maintainers. Not all of these guidelines matter for every
7trivial patch so apply some common sense.
8
91. Always _test_ your changes, however small, on at least 1 or
10 2 people, preferably many more.
11
122. 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
203. 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
244. When you are happy with a change make it generally available for
25 testing in gerrit and await feedback.
26
275. 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
596. 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
637. Happy hacking.
64
65Descriptions of section entries:
66
Stefan Reinauera4ffe8a2015-10-21 13:09:42 -070067 M: Maintainer: FullName <address@domain>
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -070068 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
114Note: For the hard of thinking, this list is meant to remain in alphabetical
115order. If you could add yourselves to it in alphabetical order that would be
116so much easier [Ed]
117
118Maintainers List (try to look for most precise areas first)
119
120 -----------------------------------
121
122RISC-V ARCHITECTURE
123M: Ronald Minnich <rminnich@gmail.com>
Jonathan Neuschäfer968292b2016-10-12 00:17:59 +0200124M: Jonathan Neuschäfer <j.neuschaefer@gmx.net>
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -0700125S: Maintained
Stefan Reinauera4ffe8a2015-10-21 13:09:42 -0700126F: src/arch/riscv/
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700127F: src/soc/ucb/
Jonathan Neuschäfer950d48f2016-10-12 00:18:00 +0200128F: src/mainboard/emulation/*-riscv/
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -0700129
Martin Roth57fcae12016-03-17 12:00:25 -0600130POWER8 ARCHITECTURE
131M: Ronald Minnich <rminnich@gmail.com>
132M: Timothy Pearson <tpearson@raptorengineeringinc.com>
133S: Maintained
134F: src/arch/power8/
135F: src/cpu/qemu-power8/
136F: src/mainboard/emulation/qemu-power8/
137
Alexander Couzens753af5b2015-12-05 13:45:27 +0100138LENOVO EC
139M: Alexander Couzens <lynxis@fe80.eu>
140S: Maintained
141F: src/ec/lenovo/
142
143LENOVO MAINBOARDS
144M: Alexander Couzens <lynxis@fe80.eu>
Patrick Rudolph6c1e8102016-04-06 16:17:40 +0200145M: Patrick Rudolph <siro@das-labor.org>
Alexander Couzens753af5b2015-12-05 13:45:27 +0100146S: Maintained
147F: src/mainboard/lenovo/
148
Martin Roth7fae59b2016-03-17 12:01:27 -0600149INTEL PINEVIEW CHIPSET
150M: Damien Zammit <damien@zamaudio.com>
151S: Maintained
152F: src/northbridge/intel/pineview/
153
154INTEL D510MO MAINBOARD
155M: Damien Zammit <damien@zamaudio.com>
156S: Maintained
157F: src/mainboard/intel/d510mo
158
159INTEL X4X CHIPSET
160M: Damien Zammit <damien@zamaudio.com>
161S: Maintained
162F: src/northbridge/intel/x4x/
163
164GIGABYTE GA-G41M-ES2L MAINBOARD
165M: Damien Zammit <damien@zamaudio.com>
166S: Maintained
167F: src/mainboard/gigabyte/ga-g41m-es2l
168
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -0700169GOOGLE PANTHER MAINBOARD
170M: Stefan Reinauer <stefan.reinauer@coreboot.org>
171S: Supported
Stefan Reinauera4ffe8a2015-10-21 13:09:42 -0700172F: src/mainboard/google/panther/
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -0700173
Martin Roth3a18a802015-11-19 15:45:32 -0700174INTEL MINNOWBOARD MAX MAINBOARD
Alexandru Gagniuc000e8aa2015-10-13 17:30:04 -0700175M: Huang Jin <huang.jin@intel.com>
176M: York Yang <york.yang@intel.com>
Martin Roth3a18a802015-11-19 15:45:32 -0700177M: Martin Roth <gaumless@gmail.com>
Alexandru Gagniuc000e8aa2015-10-13 17:30:04 -0700178S: Supported
Martin Roth3a18a802015-11-19 15:45:32 -0700179F: src/mainboard/intel/minnowmax/
180
Alexandru Gagniuc000e8aa2015-10-13 17:30:04 -0700181INTEL FSP BAYTRAIL CHIP & CRBs
182M: Huang Jin <huang.jin@intel.com>
183M: York Yang <york.yang@intel.com>
Martin Roth3a18a802015-11-19 15:45:32 -0700184M: Martin Roth <gaumless@gmail.com>
Alexandru Gagniuc000e8aa2015-10-13 17:30:04 -0700185S: Supported
Martin Roth3a18a802015-11-19 15:45:32 -0700186F: src/soc/intel/fsp_baytrail/
Alexandru Gagniuc000e8aa2015-10-13 17:30:04 -0700187F: src/vendorcode/intel/fsp1_0/baytrail/
188F: src/mainboard/intel/bakersport_fsp/
189F: src/mainboard/intel/bayleybay_fsp/
Martin Roth3a18a802015-11-19 15:45:32 -0700190
York Yangfbec6b12016-04-15 11:22:49 -0700191INTEL FSP BROADWELL-DE SOC & CRB
192M: York Yang <york.yang@intel.com>
193S: Supported
194F: src/soc/intel/fsp_broadwell_de/
195F: src/vendorcode/intel/fsp1_0/broadwell_de/
196F: src/mainboard/intel/camelbackmountain_fsp/
197
198INTEL FSP IVYBRIDGE/PANTHERPOINT/CAVECREEK & CRBs
199M: York Yang <york.yang@intel.com>
200S: Supported
201F: src/cpu/intel/fsp_model_206ax/
202F: src/northbridge/intel/fsp_sandybridge/
203F: src/southbridge/intel/fsp_bd82x6x/
204F: src/southbridge/intel/fsp_i89xx/
205F: src/vendorcode/intel/fsp1_0/ivybridge_bd82x6x
206F: src/vendorcode/intel/fsp1_0/ivybridge_i89xx
207F: src/mainboard/intel/cougar_canyon2/
208F: src/mainboard/intel/stargo2/
209
Martin Roth980a8c12015-12-04 08:33:35 -0700210FSP 1.0 RANGELEY & CRB
211M: David Guckian <david.guckian@intel.com>
212M: Fei Wang <fei.z.wang@intel.com>
213S: Supported
214F: src/cpu/intel/fsp_model_406dx/
215F: src/northbridge/intel/fsp_rangeley/
216F: src/southbridge/intel/fsp_rangeley/
217F: src/vendorcode/intel/fsp1_0/rangeley/
218F: src/mainboard/intel/mohonpeak/
219
220INTEL LITTLE PLAINS MAINBOARD
221M: Marcin Wojciechowski <marcin.wojciechowski@intel.com>
222S: Supported
223F: src/mainboard/intel/littleplains/
224
Martin Roth3a18a802015-11-19 15:45:32 -0700225INTEL FSP 1.0
Alexandru Gagniuc000e8aa2015-10-13 17:30:04 -0700226M: Huang Jin <huang.jin@intel.com>
227M: York Yang <york.yang@intel.com>
Martin Roth3a18a802015-11-19 15:45:32 -0700228M: Martin Roth <gaumless@gmail.com>
Alexandru Gagniuc000e8aa2015-10-13 17:30:04 -0700229S: Supported
Martin Roth3a18a802015-11-19 15:45:32 -0700230F: src/drivers/intel/fsp1_0/
Martin Roth3a18a802015-11-19 15:45:32 -0700231
Martin Roth533f6662015-12-04 08:36:49 -0700232INTEL FSP 1.1
233M: Lee Leahy <leroy.p.leahy@intel.com>
234M: Andrey Petrov <andrey.petrov@intel.com>
235M: Huang Jin <huang.jin@intel.com>
236M: York Yang <york.yang@intel.com>
237S: Supported
238F: src/drivers/intel/fsp1_1/
239
Andrey Petrov842dfe82016-05-24 22:01:56 -0700240INTEL FSP 2.0
241M: Andrey Petrov <andrey.petrov@intel.com>
242S: Supported
243F: src/drivers/intel/fsp2_0/
244
Martin Roth4a1c69a2016-03-17 12:02:12 -0600245INTEL STRAGO MAINBOARD
246M: Hannah Williams <hannah.williams@intel.com>
247S: Supported
248F: /src/mainboard/intel/strago/
249
250INTEL BRASWELL SOC
251M: Hannah Williams <hannah.williams@intel.com>
252S: Supported
253F: /src/soc/intel/braswell
254F: /src/vendorcode/intel/fsp/fsp1_1/braswell
255
Andrey Petrov842dfe82016-05-24 22:01:56 -0700256INTEL APOLLOLAKE_SOC
257M: Andrey Petrov <andrey.petrov@intel.com>
258S: Supported
259F: src/soc/intel/apollolake/
260
Martin Roth2a3434752016-03-05 18:31:29 -0700261ASUS KFSN4-DRE & KFSN4-DRE_K8 MAINBOARDS
262M: Timothy Pearson <tpearson@raptorengineeringinc.com>
263S: Supported
264F: src/mainboard/asus/kfsn4-dre/
265F: src/mainboard/asus/kfsn4-dre_k8/
266
267ASUS KCMA-D8 MAINBOARD
268M: Timothy Pearson <tpearson@raptorengineeringinc.com>
269S: Supported
270F: src/mainboard/asus/kcma-d8/
271
272ASUS KGPE-D16 MAINBOARD
273M: Timothy Pearson <tpearson@raptorengineeringinc.com>
274S: Supported
275F: src/mainboard/asus/kgpe-d16/
276
277AMD FAMILY10H & FAMILY15H (NON-AGESA) CPUS & NORTHBRIDGE
278M: Timothy Pearson <tpearson@raptorengineeringinc.com>
279S: Supported
280F: src/cpu/amd/family_10h-family_15h/
281F: src/northbridge/amd/amdfam10/
282F: src/northbridge/amd/amdmct/
283F: src/northbridge/amd/amdht/
284
285AMD SB700 (NON-CIMX) SOUTHBRIDGE
286M: Timothy Pearson <tpearson@raptorengineeringinc.com>
287S: Supported
288F: src/southbridge/amd/sb700/
289
290AMD SR5650 SOUTHBRIDGE
291M: Timothy Pearson <tpearson@raptorengineeringinc.com>
292S: Supported
293F: src/southbridge/amd/sr5650/
294
295ASPEED AST2050 DRIVER & COMMON CODE
296M: Timothy Pearson <tpearson@raptorengineeringinc.com>
297S: Supported
298F: src/drivers/aspeed/common/
299F: src/drivers/aspeed/ast2050/
300
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -0700301ATI MACH64 Driver
302S: Orphan
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700303F: src/drivers/ati/mach64/
304
305ABUILD
306M: Patrick Georgi <patrick@georgi-clan.de>
307S: Supported
308F: util/abuild/
309
310ACPI
311F: src/acpi/
312F: src/arch/x86/acpi/
313F: util/acpi/
314
315ARM ARCHITECTURE
316F: src/arch/arm/
317F: src/arch/arm64
318F: src/cpu/allwinner/
319F: src/cpu/armltd/
320F: src/cpu/samsung/
321F: src/cpu/ti/
322F: src/soc/broadcom/
323F: src/soc/marvell/
324F: src/soc/nvidia/
325F: src/soc/qualcomm/
326F: src/soc/rockchip/
327F: src/soc/samsung/
328F: util/arm_boot_tools/
329F: util/broadcom/
330F: util/exynos/
331F: util/ipqheader/
332F: util/nvidia/
333F: util/rockchip/
334
335MIPS ARCHITECTURE
336F: src/arch/mips/
337F: src/cpu/mips/
338F: src/soc/imgtec/
339F: util/bimgtool/
340
341X86 ARCHITECTURE
342F: src/arch/x86/
343F: src/cpu/x86/
344F: src/drivers/pc80/
345F: src/include/pc80/
346F: src/include/cpu/x86/
347
348INTEL SUPPORT
Patrick Rudolph6c1e8102016-04-06 16:17:40 +0200349M: Patrick Rudolph <siro@das-labor.org>
350S: Maintained
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700351F: src/vendorcode/intel/
352F: src/cpu/intel/
353F: src/northbridge/intel/
354F: src/southbridge/intel/
355F: src/soc/intel/
356F: src/drivers/intel/
357F: src/include/cpu/intel/
358
359AMD SUPPORT
360F: src/vendorcode/amd/
361F: src/cpu/amd/
362F: src/northbridge/amd/
363F: src/southbridge/amd/
364F: src/include/cpu/amd/
365
366VIA SUPPORT
367F: src/cpu/via/
368F: src/northbridge/via/
369F: src/southbridge/via/
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -0700370
Stefan Reinauer2e38cc52015-05-06 11:15:38 -0700371LINT SCRIPTS
372M: Patrick Georgi <patrick@georgi-clan.de>
Martin Roth057ce5f2016-03-17 12:03:00 -0600373M: Martin Roth <gaumless@gmail.com>
Stefan Reinauer2e38cc52015-05-06 11:15:38 -0700374S: Supported
375F: util/lint/
376
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700377INTELTOOL
378M: Stefan Reinauer <stefan.reinauer@coreboot.org>
379F: util/inteltool/
380
Philipp Deppenwiese4cd9a112016-03-23 00:02:40 +0100381INTELMETOOL
382M: Philipp Deppenwiese <zaolin.daisuki@gmail.com>
383F: util/intelmetool/
384
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700385IFDTOOL
386M: Stefan Reinauer <stefan.reinauer@coreboot.org>
387F: util/ifdtool/
388F: util/ifdfake/
389
Patrick Georgi65ff63f2015-05-21 18:54:10 +0200390BUILD SYSTEM
391M: Patrick Georgi <patrick@georgi-clan.de>
Martin Roth3a18a802015-11-19 15:45:32 -0700392M: Martin Roth <gaumless@gmail.com>
Patrick Georgi65ff63f2015-05-21 18:54:10 +0200393S: Supported
394F: Makefile
395F: *.inc
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700396F: src/include/kconfig.h
Stefan Reinauera4ffe8a2015-10-21 13:09:42 -0700397F: util/kconfig/
398F: util/sconfig/
Patrick Georgi65ff63f2015-05-21 18:54:10 +0200399
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700400BOARD STATUS
Martin Roth057ce5f2016-03-17 12:03:00 -0600401M: Martin Roth <gaumless@gmail.com>
402S: Supported
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700403F: util/board_status/
404
405BINARY OBJECTS
406F: 3rdparty/blobs/
407
408VERIFIED BOOT
409F: 3rdparty/vboot/
410F: src/vendorcode/google/chromeos/
411F: src/include/tpm.h
412F: src/include/tpm_lite/
413
414RESOURCE ALLOCATOR
415F: src/device/*
416F: src/include/device/
417F: src/include/cpu/cpu.h
418
419OPTION ROM EXECUTION & X86EMU
420F: src/device/oprom/
421
422CBFS
423F: src/include/cbfs.h
424F: src/include/cbfs_serialized.h
425F: util/cbfstool/
426
427CBMEM
428F: src/include/cbmem.h
429F: src/include/cbmem_id.h
430F: util/cbmem/
431
432CONSOLE
433F: src/console/
434F: src/include/console/
435F: src/drivers/uart/
436
437NVRAM
438F: util/nvramtool/
439F: util/optionlist/
440F: payloads/nvramcui/
441
442LIBPAYLOAD
443F: payloads/libpayload/
444
445BAYOU PAYLOAD
446F: payloads/bayou/
447
448COREINFO PAYLOAD
449F: payloads/coreinfo/
450
451EXTERNAL PAYLOADS INTEGRATION
452M: Stefan Reinauer <stefan.reinauer@coreboot.org>
Martin Roth057ce5f2016-03-17 12:03:00 -0600453M: Martin Roth <gaumless@gmail.com>
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700454F: payloads/external
455
456VERIFIED BOOT 2
457M: Aaron Durbin <adurbin@chromium.org>
458F: src/vendorcode/google/chromeos/vboot2/
459
Philipp Deppenwiese6507e6f2016-06-22 19:01:47 +0200460TPM SUPPORT
461M: Philipp Deppenwiese <zaolin.daisuki@gmail.com>
462F: src/drivers/*/tpm/
463F: src/security/tpm12/
464F: src/security/tpm20/
465F: util/tss-generator/
466
Stefan Reinauerbf3dbaf2015-06-12 15:30:59 -0700467MISSING: TIMERS / DELAYS
468
469MISSING: TIMESTAMPS
470
471MISSING: MEMLAYOUT
472
473MISSING: FMAP
474
475MISSING: GPIO
476
477MISSING: SMP
478
479MISSING: SUPERIOS
480
481MISSING: DMP / QEMU-X86
482
483MISSING: ELOG
484
485MISSING: GENERIC DRAM (should drop)
486
487MISSING: SPI
488
Stefan Reinauerc6e1f8a2015-04-28 13:42:55 -0700489THE REST
490M: Stefan Reinauer <stefan.reinauer@coreboot.org>
491L: coreboot@coreboot.org
492T: git http://review.coreboot.org/coreboot
493S: Buried alive in mainboards
494F: *
495F: */