Commit | Line | Data |
---|---|---|
302ab118 DD |
1 | ========= Binutils Maintainers ========= |
2 | ||
3 | This is the list of individuals responsible for maintenance and update | |
1b577b00 NC |
4 | of the GNU Binary Utilities project. This includes the linker (ld), |
5 | the assembler (gas), the profiler (gprof), a whole suite of other | |
6 | programs (binutils) and the libraries that they use (bfd and | |
7 | opcodes). This project shares a common set of header files with the | |
eacf2b70 | 8 | GCC and GDB projects (include), so maintainership of those files is |
1b577b00 | 9 | shared amoungst the projects. |
302ab118 | 10 | |
1b577b00 | 11 | The home page for binutils is: |
8c2bc687 | 12 | |
1b577b00 NC |
13 | http://www.gnu.org/software/binutils/binutils.html |
14 | ||
15 | and patches should be sent to: | |
16 | ||
eacf2b70 AM |
17 | binutils@sourceware.org |
18 | ||
1b577b00 | 19 | with "[Patch]" as part of the subject line. Note - patches to the |
04fbe429 | 20 | top level config.guess and config.sub scripts should be sent to: |
302ab118 | 21 | |
1b577b00 | 22 | config-patches@gnu.org |
302ab118 | 23 | |
04fbe429 | 24 | and not to the binutils lists. Patches to the other top level |
bf41f30d | 25 | configure files (configure, configure.ac, config-ml.in) should |
73fb7068 | 26 | be sent to the binutils lists, and copied to the gcc and gdb |
04fbe429 | 27 | lists as well (gcc-patches@gcc.gnu.org and |
eacf2b70 | 28 | gdb-patches@sourceware.org). |
1b577b00 | 29 | |
bf41f30d NC |
30 | Patches to the libiberty sources should be sent to |
31 | gcc-patches@gcc.gnu.org. | |
32 | ||
1b577b00 | 33 | --------- Blanket Write Privs --------- |
302ab118 | 34 | |
1b577b00 NC |
35 | The following people have permission to check patches into the |
36 | repository without obtaining approval first: | |
eacf2b70 | 37 | |
1b577b00 | 38 | Nick Clifton <nickc@redhat.com> (head maintainer) |
3517749c | 39 | Ian Lance Taylor <ian@airs.com> |
1b577b00 | 40 | Jeff Law <law@redhat.com> |
4b3be0b6 | 41 | Jim Wilson <wilson@tuliptree.org> |
1b577b00 | 42 | DJ Delorie <dj@redhat.com> |
ebc5095a | 43 | Alan Modra <amodra@gmail.com> |
2445335e | 44 | Michael Meissner <gnu@the-meissners.org> |
9483a6ee | 45 | Daniel Jacobowitz <drow@false.org> |
93abc97a | 46 | Richard Sandiford <rdsandiford@googlemail.com> |
1b577b00 NC |
47 | |
48 | --------- Maintainers --------- | |
49 | ||
50 | Maintainers are individuals who are responsible for, and have | |
51 | permission to check in changes in, certain subsets of the code. Note | |
52 | that maintainers still need approval to check in changes outside of | |
53 | the immediate domain that they maintain. | |
302ab118 DD |
54 | |
55 | If there is no maintainer for a given domain then the responsibility | |
1b577b00 NC |
56 | falls to the head maintainer (above). If there are several |
57 | maintainers for a given domain then responsibility falls to the first | |
58 | maintainer. The first maintainer is free to devolve that | |
59 | responsibility among the other maintainers. | |
60 | ||
2141b110 | 61 | ALPHA Richard Henderson <rth@twiddle.net> |
a06ea964 | 62 | AARCH64 Richard Earnshaw <rearnsha@arm.com> |
5b2ab150 | 63 | AARCH64 Marcus Shawcroft <marcus.shawcroft@arm.com> |
02d7a79e | 64 | ARC Claudiu Zissulescu <claziss@synopsys.com> |
1b577b00 | 65 | ARM Nick Clifton <nickc@redhat.com> |
3a7e524e | 66 | ARM Richard Earnshaw <rearnsha@arm.com> |
6c1965f9 | 67 | ARM Ramana Radhakrishnan <ramana.radhakrishnan@arm.com> |
e8b338d0 | 68 | AVR Denis Chertykov <chertykov@gmail.com> |
e0159aa9 | 69 | AVR Marek Michalkiewicz <marekm@amelek.gda.pl> |
4161fbb0 | 70 | BFIN Jie Zhang <jzhang918@gmail.com> |
3d5ff620 | 71 | BFIN Mike Frysinger <vapier@gentoo.org> |
9483a6ee | 72 | BUILD SYSTEM Daniel Jacobowitz <drow@false.org> |
ec8cbbf6 | 73 | CR16 M R Swami Reddy <MR.Swami.Reddy@nsc.com> |
1b577b00 | 74 | CRIS Hans-Peter Nilsson <hp@axis.com> |
ec8cbbf6 | 75 | CRX M R Swami Reddy <MR.Swami.Reddy@nsc.com> |
d0ba5758 | 76 | C-SKY Lifang Xia <lifang_xia@c-sky.com> |
2409af1e | 77 | C-SKY Yunhai Shang <yunhai_shang@c-sky.com> |
4b3dc01d | 78 | DLX Nikolaos Kavvadias <nkavv@physics.auth.gr> |
1b577b00 | 79 | DWARF2 Jason Merrill <jason@redhat.com> |
1cd48f98 | 80 | DWARF2 Jakub Jelinek <jakub@redhat.com> |
be459434 | 81 | dwarf-mode.el Tom Tromey <tom@tromey.com> |
5b169225 | 82 | EPIPHANY Joern Rennecke <joern.rennecke@embecosm.com> |
a9f0b5e7 DB |
83 | FR30 Dave Brolley <brolley@redhat.com> |
84 | FRV Dave Brolley <brolley@redhat.com> | |
ec2dfb42 | 85 | FRV Alexandre Oliva <aoliva@redhat.com> |
ee441d9a | 86 | GOLD Ian Lance Taylor <iant@google.com> |
08e4f608 | 87 | GOLD Cary Coutant <ccoutant@gmail.com> |
db448d50 | 88 | H8300 Prafulla Thakare <prafulla.thakare@kpitcummins.com> |
89f60df2 | 89 | HPPA Dave Anglin <dave.anglin@bell.net> |
ebc5095a | 90 | HPPA elf32 Alan Modra <amodra@gmail.com> |
f52e0eb8 | 91 | HPPA elf64 Jeff Law <law@redhat.com> [Basic maintainance only] |
4b3be0b6 | 92 | IA-64 Jim Wilson <wilson@tuliptree.org> |
3b36097d | 93 | IQ2000 Stan Cox <scox@redhat.com> |
ccdb9c9f | 94 | ix86 H.J. Lu <hjl.tools@gmail.com> |
bd5a94b0 | 95 | ix86 PE Christopher Faylor <me+binutils@cgf.cx> |
b54e7460 | 96 | ix86 COFF DJ Delorie <dj@redhat.com> |
57f6e0bc | 97 | ix86 PE/COFF Dave Korn <dave.korn.cygwin@gmail.com> |
53260797 | 98 | ix86 INTEL MODE Jan Beulich <jbeulich@novell.com> |
84e94c90 | 99 | LM32 Jon Beniston <jon@beniston.com> |
5d0c4f10 | 100 | M32R Doug Evans <dje@sebabeach.org> |
a481d14b | 101 | M68HC11 M68HC12 Stephane Carrez <Stephane.Carrez@gmail.com> |
554adb2c | 102 | M68HC11 M68HC12 Sean Keys <skeys@ipdatasys.com> |
c91933e9 | 103 | MACH-O Tristan Gingold <tgingold@free.fr> |
c4cf3821 | 104 | MAXQ Inderpreet Singh <inderpreetb@noida.hcltech.com> |
0dd5bc5e | 105 | MEP Dave Brolley <brolley@redhat.com> |
d5c7e0e9 | 106 | METAG Markos Chandras <markos.chandras@imgtec.com> |
7ba29e2a | 107 | MICROBLAZE Michael Eager <eager@eagercon.com> |
4c971803 | 108 | MIPS Chenghua Xu <paul.hua.gm@gmail.com> |
e2e31f10 | 109 | MIPS I-IV Maciej W. Rozycki <macro@linux-mips.org> |
9b19141a | 110 | MMIX Hans-Peter Nilsson <hp@bitrange.com> |
91593c9d | 111 | MN10300 Alexandre Oliva <aoliva@redhat.com> |
17eb60e9 | 112 | Moxie Anthony Green <green@moxielogic.com> |
1acfb01b | 113 | MSP430 Dmitry Diky <diwil@spec.ru> |
35c08157 KLC |
114 | NDS32 Kuan-Lin Chen <kuanlinchentw@gmail.com> |
115 | NDS32 Wei-Cheng Wang <cole945@gmail.com> | |
5ad507ee | 116 | NetBSD support Matt Thomas <matt@netbsd.org> |
36591ba1 SL |
117 | Nios II Sandra Loosemore <sandra@codesourcery.com> |
118 | Nios II Andrew Jenner <andrew@codesourcery.com> | |
b2bcb4bd CS |
119 | OR1K Christian Svensson <blue@cmd.nu> |
120 | OR1K Stefan Kristiansson <stefan.kristiansson@saunalahti.fi> | |
a926ab2f | 121 | PPC Geoff Keating <geoffk@geoffk.org> |
ebc5095a | 122 | PPC Alan Modra <amodra@gmail.com> |
4bc0608a | 123 | PPC Peter Bergner <bergner@vnet.ibm.com> |
42ea8716 | 124 | PPC vector ext Aldy Hernandez <aldyh@redhat.com> |
180093c7 PD |
125 | RISC-V Palmer Dabbelt <palmer@sifive.com> |
126 | RISC-V Andrew Waterman <andrew@sifive.com> | |
016f5a37 | 127 | RISC-V Jim Wilson <jimw@sifive.com> |
c7927a3c | 128 | RX Nick Clifton <nickc@redhat.com> |
54589086 | 129 | s390, s390x Martin Schwidefsky <schwidefsky@de.ibm.com> |
6604eb5f | 130 | s390, s390x Andreas Krebbel <krebbel@linux.vnet.ibm.com> |
9f77fa06 | 131 | SH Alexandre Oliva <aoliva@redhat.com> |
cdd30861 | 132 | SPARC David S. Miller <davem@davemloft.net> |
9b5481c6 | 133 | SPARC Jose E. Marchesi <jose.marchesi@oracle.com> |
ebc5095a | 134 | SPU Alan Modra <amodra@gmail.com> |
6e917903 | 135 | TIC54X Timothy Wall <twall@alum.mit.edu> |
40b36596 | 136 | TIC6X Joseph Myers <joseph@codesourcery.com> |
ab8b6d29 WL |
137 | TILE-Gx Walter Lee <walt@tilera.com> |
138 | TILEPro Walter Lee <walt@tilera.com> | |
5ad507ee | 139 | VAX Matt Thomas <matt@netbsd.org> |
677c6f3a | 140 | VAX Jan-Benedict Glaw <jbglaw@lug-owl.de> |
2a6969e1 | 141 | Visium Eric Botcazou <ebotcazou@libertysurf.fr> |
c91933e9 | 142 | VMS Tristan Gingold <tgingold@free.fr> |
91593c9d AM |
143 | x86_64 Jan Hubicka <jh@suse.cz> |
144 | x86_64 Andreas Jaeger <aj@suse.de> | |
fabda5a7 | 145 | x86_64 H.J. Lu <hjl.tools@gmail.com> |
93abc97a | 146 | XCOFF Richard Sandiford <r.sandiford@uk.ibm.com> |
8d88d7ec | 147 | XGATE Sean Keys <skeys@ipdatasys.com> |
3aade688 | 148 | Xtensa Sterling Augustine <augustine.sterling@gmail.com> |
3c25c5f6 NC |
149 | z8k Christian Groessler <chris@groessler.org> |
150 | ||
13364275 NC |
151 | --------- Past Maintainers ------------- |
152 | ||
153 | These folks have acted as maintainers in the past, but have now | |
154 | moved on to other things. Our thanks for all their hard work | |
155 | goes with them. | |
156 | ||
fd13a84b | 157 | Paul Brook |
7c723eec | 158 | Eric Christopher |
f1ca0d6d | 159 | Jason Eckhardt |
c2bf1eec | 160 | Mark Kettenis |
71d01c69 | 161 | Mei Ligang |
06d743b7 | 162 | Arnold Metselaar |
13364275 | 163 | Mark Mitchell |
cf581a9b | 164 | Bernd Schmidt |
482366c3 | 165 | Svein Seldal |
1b577b00 NC |
166 | |
167 | --------- CGEN Maintainers ------------- | |
dac850af | 168 | |
08c404a5 | 169 | CGEN is a tool for building, amongst other things, assemblers, |
1b577b00 NC |
170 | disassemblers and simulators from a single description of a CPU. |
171 | It creates files in several of the binutils directories, but it | |
172 | is mentioned here since there is a single group that maintains | |
eacf2b70 | 173 | CGEN and the files that it creates. |
dac850af NC |
174 | |
175 | If you have CGEN related problems you can send email to; | |
176 | ||
eacf2b70 | 177 | cgen@sourceware.org |
dac850af NC |
178 | |
179 | The current CGEN maintainers are: | |
180 | ||
b893fd29 | 181 | Doug Evans, Frank Eigler |
302ab118 | 182 | |
1b577b00 | 183 | --------- Write After Approval --------- |
302ab118 DD |
184 | |
185 | Individuals with "write after approval" have the ability to check in | |
186 | changes, but they must get approval for each change from someone in | |
187 | one of the above lists (blanket write or maintainers). | |
188 | ||
189 | [It's a huge list, folks. You know who you are. If you have the | |
1b577b00 NC |
190 | *ability* to do binutils checkins, you're in this group. Just |
191 | remember to get approval before checking anything in.] | |
a9f10786 | 192 | |
1b577b00 | 193 | ------------- Obvious Fixes ------------- |
a9f10786 NC |
194 | |
195 | Fixes for obvious mistakes do not need approval, and can be checked in | |
196 | right away, but the patch should still be sent to the binutils list. | |
197 | The definition of obvious is a bit hazy, and if you are not sure, then | |
198 | you should seek approval first. Obvious fixes include fixes for | |
199 | spelling mistakes, blatantly incorrect code (where the correct code is | |
200 | also blatantly obvious), and so on. Obvious fixes should always be | |
201 | small, the larger they are, the more likely it is that they contain | |
202 | some un-obvious side effect or consequence. | |
90ab7e9a | 203 | |
1b577b00 | 204 | --------- Branch Checkins --------- |
90ab7e9a NC |
205 | |
206 | If a patch is approved for check in to the mainline sources, it can | |
207 | also be checked into the current release branch. Normally however | |
208 | only bug fixes should be applied to the branch. New features, new | |
209 | ports, etc, should be restricted to the mainline. (Otherwise the | |
eacf2b70 | 210 | burden of maintaining the branch in sync with the mainline becomes too |
90ab7e9a NC |
211 | great). If you are uncertain as to whether a patch is appropriate for |
212 | the branch, ask the branch maintainer. This is: | |
213 | ||
c91933e9 | 214 | (cf global maintainers) |
873e0588 NC |
215 | |
216 | -------- Testsuites --------------- | |
217 | ||
218 | In general patches to any of the binutils testsuites should be | |
219 | considered generic and sent to the binutils mailing list for | |
220 | approval. Patches to target specific tests are the responsibility the | |
13364275 | 221 | relevant port maintainer(s), and can be approved/checked in by them. |
873e0588 NC |
222 | Other testsuite patches need the approval of a blanket-write-priveleges |
223 | person. | |
224 | ||
225 | -------- Configure patches ---------- | |
226 | ||
227 | Patches to the top level configure files (config.sub & config.guess) | |
228 | are not the domain of the binutils project and they cannot be approved | |
229 | by the binutils group. Instead they should be submitted to the config | |
230 | maintainer at: | |
231 | ||
232 | config-patches@gnu.org | |
619b8b60 MM |
233 | |
234 | --------- Creating Branches --------- | |
235 | ||
236 | Anyone with at least write-after-approval access may create a branch | |
237 | to use for their own development purposes. In keeping with FSF | |
238 | policies, all patches applied to such a branch must come from people | |
239 | with appropriate copyright assignments on file. All legal | |
240 | requirements that would apply to any other contribution apply equally | |
241 | to contributions on a branch. | |
242 | ||
243 | Before creating the branch, you should select a name for the branch of | |
244 | the form: | |
245 | ||
eacf2b70 | 246 | binutils-<org>-<name> |
619b8b60 MM |
247 | |
248 | where "org" is the initials of your organization, or your own initials | |
249 | if you are acting as an individual. For example, for a branch created | |
250 | by The GNUDist Company, "tgc" would be an appropriate choice for | |
251 | "org". It's up to each organization to select an appropriate choice | |
252 | for "name"; some organizations may use more structure than others, so | |
253 | "name" may contain additional hyphens. | |
254 | ||
255 | Suppose that The GNUDist Company was creating a branch to develop a | |
256 | port of Binutils to the FullMonty processor. Then, an appropriate | |
257 | choice of branch name would be: | |
258 | ||
259 | binutils-tgc-fm | |
260 | ||
45781998 | 261 | A date stamp is not required as part of the name field, but some |
619b8b60 MM |
262 | organizations like to have one. If you do include the date, you |
263 | should follow these rules: | |
264 | ||
265 | 1. The date should be the date that the branch was created. | |
266 | ||
267 | 2. The date should be numerical and in the form YYYYMMDD. | |
268 | ||
269 | For example: | |
270 | ||
271 | binutils-tgc-fm_20050101 | |
272 | ||
273 | would be appropriate if the branch was created on January 1st, 2005. | |
274 | ||
275 | Having selected the branch name, create the branch as follows: | |
276 | ||
20cef68c | 277 | 1. Check out binutils, so that you have a git checkout corresponding |
619b8b60 MM |
278 | to the initial state of your branch. |
279 | ||
280 | 2. Create a tag: | |
281 | ||
20cef68c | 282 | git tag binutils-<org>-<name>-branchpoint |
619b8b60 MM |
283 | |
284 | That tag will allow you, and others, to easily determine what's | |
285 | changed on the branch relative to the initial state. | |
286 | ||
20cef68c | 287 | 3. Create and push the branch: |
619b8b60 | 288 | |
20cef68c TT |
289 | git checkout -b binutils-<org>-<name>-branch |
290 | git push origin HEAD | |
619b8b60 MM |
291 | |
292 | 4. Document the branch: | |
293 | ||
294 | Add a description of the branch to binutils/BRANCHES, and check | |
295 | that file in. All branch descriptions should be added to the | |
296 | HEAD revision of the file; it doesn't help to modify | |
297 | binutils/BRANCHES on a branch! | |
298 | ||
299 | Please do not commit any patches to a branch you did not create | |
300 | without the explicit permission of the person who created the branch. | |
5bf135a7 | 301 | \f |
219d1afa | 302 | Copyright (C) 2012-2018 Free Software Foundation, Inc. |
5bf135a7 NC |
303 | |
304 | Copying and distribution of this file, with or without modification, | |
305 | are permitted in any medium without royalty provided the copyright | |
306 | notice and this notice are preserved. |