forked from xen-project/xen
-
Notifications
You must be signed in to change notification settings - Fork 0
/
MAINTAINERS
614 lines (522 loc) · 17.7 KB
/
MAINTAINERS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
List of maintainers and how to submit changes
=============================================
Please try to follow the guidelines below. This will make things
easier on the maintainers. Not all of these guidelines matter for every
trivial patch so apply some common sense.
1. Always _test_ your changes, however small, on at least 4 or
5 people, preferably many more.
2. Make sure your changes compile correctly in multiple
configurations. For example, both 32- and 64-bit x86.
3. Make a patch available to the relevant maintainer in the list. Use
'diff -u' to make the patch easy to merge. Be prepared to get your
changes sent back with seemingly silly requests about formatting
and variable names. These aren't as silly as they seem. One
job the maintainers do is to keep things looking the same.
PLEASE see https://wiki.xenproject.org/wiki/Submitting_Xen_Patches for
hints on how to submit a patch to xen-unstable in a suitable
form.
PLEASE try to include any credit lines you want added with the
patch. It avoids people being missed off by mistake and makes
it easier to know who wants adding and who doesn't.
PLEASE document known bugs. If it doesn't work for everything
or does something very odd once a month document it.
PLEASE remember that submissions must be made under the terms
of the "Developer's Certificate of Origin" (DCO) and should include
a Signed-off-by: line.
4. Make sure you have the right to send any changes you make. If you
do changes at work you may find your employer owns the patch
not you.
5. Happy hacking.
Stable Release Maintenance
==========================
The policy for inclusion in a Xen stable release is different to that
for inclusion in xen-unstable.
Please see https://wiki.xenproject.org/wiki/Xen_Maintenance_Releases for more
information.
Backport requests should be made on the [email protected]
list. Remember to copy the appropriate stable branch maintainer who
will be listed in this section of the MAINTAINERS file in the
appropriate branch.
Unstable Subsystem Maintainers
==============================
Descriptions of section entries:
M: Maintainer: FullName <address@domain>
Maintainers should be CCed on patches. At least one of them
needs to approve changes to the covered files.
R: Designated reviewer: FullName <address@domain>
Reviewers should be CCed on patches. However, they do not
have a formal governance role, and are listed here
simply because of their own request.
L: Mailing list that is relevant to this area
W: Web-page with status/info
T: SCM tree type and location. Type is one of: git, hg, quilt, stgit.
S: Status, one of the following:
Supported: Someone is actually paid to look after this.
Maintained: Someone actually looks after it.
Odd Fixes: It has a maintainer but they don't have time to do
much other than throw the odd patch in. See below..
Orphan: No current maintainer [but maybe you could take the
role as you write your new code].
Obsolete: Old code. Something tagged obsolete generally means
it has been replaced by a better system and you
should be using that.
F: Files and directories with wildcard patterns.
A trailing slash includes all files and subdirectory files.
F: drivers/net/ all files in and below drivers/net
F: drivers/net/* all files in drivers/net, but not below
F: */net/* all files in "any top level directory"/net
One pattern per line. Multiple F: lines acceptable.
X: Files and directories that are NOT maintained, same rules as F:
Files exclusions are tested before file matches.
Can be useful for excluding a specific subdirectory, for instance:
F: net/
X: net/ipv6/
matches all files in and below net excluding net/ipv6/
K: Keyword perl extended regex pattern to match content in a
patch or file. For instance:
K: of_get_profile
matches patches or files that contain "of_get_profile"
K: \b(printk|pr_(info|err))\b
matches patches or files that contain one or more of the words
printk, pr_info or pr_err
One regex pattern per line. Multiple K: lines acceptable.
V: Version identifier that must be under THE REST and follows
the format:
xen-maintainers-<version format number of this file>
Check-in policy
===============
In order for a patch to be checked in, in general, several conditions
must be met:
1. In order to get a change to a given file committed, it must have
the approval of at least one maintainer of that file.
A patch of course needs Acks from the maintainers of each file that
it changes; so a patch which changes xen/arch/x86/traps.c,
xen/arch/x86/mm/p2m.c, and xen/arch/x86/mm/shadow/multi.c would
require an Ack from each of the three sets of maintainers.
See below for rules on nested maintainership.
2. It must have appropriate approval from someone other than the
submitter. This can be either:
a. An Acked-by from a maintainer of the code being touched (a
co-maintainer if available, or a more general level maintainer if
not available; see the secton on nested maintainership)
b. A Reviewed-by by anyone of suitable stature in the community
3. Sufficient time must have been given for anyone to respond. This
depends in large part upon the urgency and nature of the patch.
For a straightforward uncontroversial patch, a day or two may be
sufficient; for a controversial patch, a week or two may be better.
4. There must be no "open" objections.
In a case where one person submits a patch and a maintainer gives an
Ack, the Ack stands in for both the approval requirement (#1) and the
Acked-by-non-submitter requirement (#2).
In a case where a maintainer themselves submits a patch, the
Signed-off-by meets the approval requirement (#1); so a Review
from anyone in the community suffices for requirement #2.
Before a maintainer checks in their own patch with another community
member's R-b but no co-maintainer Ack, it is especially important to
give their co-maintainer opportunity to give feedback, perhaps
declaring their intention to check it in without their co-maintainers
ack a day before doing so.
Maintainers may choose to override non-maintainer objections in the
case that consensus can't be reached.
As always, no policy can cover all possible situations. In
exceptional circumstances, committers may commit a patch in absence of
one or more of the above requirements, if they are reasonably
confident that the other maintainers will approve of their decision in
retrospect.
The meaning of nesting
======================
Many maintainership areas are "nested": for example, there are entries
for xen/arch/x86 as well as xen/arch/x86/mm, and even
xen/arch/x86/mm/shadow; and there is a section at the end called "THE
REST" which lists all committers. The meaning of nesting is that:
1. Under normal circumstances, the Ack of the most specific maintainer
is both necessary and sufficient to get a change to a given file
committed. So a change to xen/arch/x86/mm/shadow/multi.c requires the
the Ack of the xen/arch/x86/mm/shadow maintainer for that part of the
patch, but would not require the Ack of the xen/arch/x86 maintainer or
the xen/arch/x86/mm maintainer.
2. In unusual circumstances, a more general maintainer's Ack can stand
in for or even overrule a specific maintainer's Ack. Unusual
circumstances might include:
- The patch is fixing a high-priority issue causing immediate pain,
and the more specific maintainer is not available.
- The more specific maintainer has not responded either to the
original patch, nor to "pings", within a reasonable amount of time.
- The more general maintainer wants to overrule the more specific
maintainer on some issue. (This should be exceptional.)
- In the case of a disagreement between maintainers, THE REST can
settle the matter by majority vote. (This should be very exceptional
indeed.)
Maintainers List (try to look for most precise areas first)
-----------------------------------
ACPI
M: Jan Beulich <[email protected]>
S: Supported
F: xen/arch/x86/acpi/
F: xen/drivers/acpi/
F: xen/include/acpi/
F: tools/libacpi/
AMD IOMMU
M: Jan Beulich <[email protected]>
M: Andrew Cooper <[email protected]>
S: Maintained
F: xen/drivers/passthrough/amd/
AMD SVM
M: Jan Beulich <[email protected]>
M: Andrew Cooper <[email protected]>
S: Supported
F: xen/arch/x86/hvm/svm/
F: xen/arch/x86/cpu/vpmu_amd.c
ARGO
M: Christopher Clark <[email protected]>
S: Maintained
F: xen/include/public/argo.h
F: xen/include/xen/argo.h
F: xen/common/argo.c
ARINC653 SCHEDULER
M: Josh Whitehead <[email protected]>
M: Stewart Hildebrand <[email protected]>
S: Supported
F: xen/common/sched/arinc653.c
F: tools/libs/ctrl/xc_arinc653.c
ARM (W/ VIRTUALISATION EXTENSIONS) ARCHITECTURE
M: Stefano Stabellini <[email protected]>
M: Julien Grall <[email protected]>
R: Volodymyr Babchuk <[email protected]>
S: Supported
F: docs/misc/arm/
F: xen/arch/arm/
F: xen/drivers/char/arm-uart.c
F: xen/drivers/char/cadence-uart.c
F: xen/drivers/char/exynos4210-uart.c
F: xen/drivers/char/meson-uart.c
F: xen/drivers/char/mvebu-uart.c
F: xen/drivers/char/omap-uart.c
F: xen/drivers/char/pl011.c
F: xen/drivers/char/scif-uart.c
F: xen/drivers/passthrough/arm/
F: xen/include/asm-arm/
F: xen/include/public/arch-arm/
F: xen/include/public/arch-arm.h
Change Log
M: Paul Durrant <[email protected]>
R: Community Manager <[email protected]>
S: Maintained
F: CHANGELOG.md
Continuous Integration (CI)
M: Doug Goldstein <[email protected]>
W: https://gitlab.com/xen-project/xen
W: https://travis-ci.org/xen-project/xen
S: Supported
F: .gitlab-ci.yml
F: .travis.yml
F: automation/
F: scripts/travis-build
CPU POOLS
M: Juergen Gross <[email protected]>
M: Dario Faggioli <[email protected]>
S: Supported
F: xen/common/sched/cpupool.c
DEVICE TREE
M: Stefano Stabellini <[email protected]>
M: Julien Grall <[email protected]>
S: Supported
F: xen/common/libfdt/
F: xen/common/device_tree.c
F: xen/include/xen/libfdt/
F: xen/include/xen/device_tree.h
F: xen/drivers/passthrough/device_tree.c
EFI
M: Jan Beulich <[email protected]>
S: Supported
F: xen/arch/x86/efi/
F: xen/common/efi/
F: xen/include/efi/
F: xen/include/asm-x86/efi*.h
F: xen/include/asm-x86/x86_*/efi*.h
GDBSX DEBUGGER
M: Elena Ufimtseva <[email protected]>
S: Supported
F: xen/arch/x86/debug.c
F: tools/debugger/gdbsx/
GOLANG BINDINGS
M: George Dunlap <[email protected]>
M: Nick Rosbrook <[email protected]>
S: Maintained
F: tools/golang
INTEL(R) TRUSTED EXECUTION TECHNOLOGY (TXT)
R: Lukasz Hawrylko <[email protected]>
S: Odd Fixes
F: xen/arch/x86/tboot.c
F: xen/include/asm-x86/tboot.h
INTEL(R) VT FOR DIRECTED I/O (VT-D)
M: Kevin Tian <[email protected]>
S: Supported
F: xen/drivers/passthrough/vtd/
INTEL(R) VT FOR X86 (VT-X)
M: Jun Nakajima <[email protected]>
M: Kevin Tian <[email protected]>
S: Supported
F: xen/arch/x86/hvm/vmx/
F: xen/arch/x86/mm/p2m-ept.c
F: xen/include/asm-x86/hvm/vmx/
F: xen/arch/x86/cpu/vpmu_intel.c
IOMMU VENDOR INDEPENDENT CODE
M: Jan Beulich <[email protected]>
M: Paul Durrant <[email protected]>
S: Supported
F: xen/drivers/passthrough/
X: xen/drivers/passthrough/amd/
X: xen/drivers/passthrough/arm/
X: xen/drivers/passthrough/vtd/
X: xen/drivers/passthrough/device_tree.c
F: xen/include/xen/iommu.h
KCONFIG
M: Doug Goldstein <[email protected]>
S: Supported
F: docs/misc/kconfig{,-language}.txt
F: xen/tools/kconfig/
KDD DEBUGGER
M: Tim Deegan <[email protected]>
S: Odd Fixes
F: tools/debugger/kdd/
KEXEC
M: Andrew Cooper <[email protected]>
S: Supported
F: xen/common/{kexec,kimage}.c
F: xen/include/{kexec,kimage}.h
F: xen/arch/x86/machine_kexec.c
F: xen/arch/x86/x86_64/kexec_reloc.S
LIBXENLIGHT
M: Ian Jackson <[email protected]>
M: Wei Liu <[email protected]>
M: Anthony PERARD <[email protected]>
S: Supported
F: tools/libs/guest/
F: tools/libs/light/
F: tools/xl/
LIVEPATCH
M: Konrad Rzeszutek Wilk <[email protected]>
M: Ross Lagerwall <[email protected]>
S: Supported
F: docs/misc/livepatch.pandoc
F: tools/misc/xen-livepatch.c
F: xen/arch/*/livepatch*
F: xen/arch/*/*/livepatch*
F: xen/common/livepatch*
F: xen/include/asm-*/livepatch.h
F: xen/include/xen/livepatch*
F: xen/test/livepatch/*
MINI-OS
M: Samuel Thibault <[email protected]>
R: Wei Liu <[email protected]>
S: Supported
T: git https://xenbits.xenproject.org/git-http/mini-os.git
F: config/MiniOS.mk
OCAML TOOLS
M: Christian Lindig <[email protected]>
M: David Scott <[email protected]>
S: Supported
F: tools/ocaml/
OVMF UPSTREAM
M: Anthony PERARD <[email protected]>
M: Wei Liu <[email protected]>
S: Supported
T: git https://xenbits.xenproject.org/git-http/ovmf.git
POWER MANAGEMENT
M: Jan Beulich <[email protected]>
S: Supported
F: xen/arch/x86/acpi/
X: xen/arch/x86/acpi/boot.c
X: xen/arch/x86/acpi/lib.c
F: xen/drivers/cpufreq/
F: xen/include/acpi/cpufreq/
PUBLIC I/O INTERFACES AND PV DRIVERS DESIGNS
M: Juergen Gross <[email protected]>
S: Supported
F: xen/include/public/io/
PYTHON BINDINGS
M: Marek Marczykowski-Górecki <[email protected]>
S: Supported
F: tools/python
QEMU-DM
M: Ian Jackson <[email protected]>
S: Supported
T: git https://xenbits.xenproject.org/git-http/qemu-xen-traditional.git
QEMU UPSTREAM
M: Stefano Stabellini <[email protected]>
M: Anthony Perard <[email protected]>
S: Supported
T: git https://xenbits.xenproject.org/git-http/qemu-xen.git
REMUS
M: Shriram Rajagopalan <[email protected]>
S: Maintained
F: docs/README.remus
F: tools/libs/light/libxl_remus_*
F: tools/libs/light/libxl_netbuffer.c
F: tools/libs/light/libxl_nonetbuffer.c
F: tools/hotplug/Linux/remus-netbuf-setup
F: tools/hotplug/Linux/block-drbd-probe
RTDS SCHEDULER
M: Dario Faggioli <[email protected]>
M: Meng Xu <[email protected]>
S: Supported
F: xen/common/sched/rt.c
SCHEDULING
M: George Dunlap <[email protected]>
M: Dario Faggioli <[email protected]>
S: Supported
F: xen/common/sched/
SEABIOS UPSTREAM
M: Wei Liu <[email protected]>
S: Supported
T: git https://xenbits.xenproject.org/git-http/seabios.git
STUB DOMAINS
M: Samuel Thibault <[email protected]>
S: Supported
F: config/Stubdom.mk.in
F: m4/stubdom.m4
F: stubdom/
TEE MEDIATORS
M: Volodymyr Babchuk <[email protected]>
S: Supported
F: xen/arch/arm/tee/
F: xen/include/asm-arm/tee
TOOLSTACK
M: Ian Jackson <[email protected]>
M: Wei Liu <[email protected]>
S: Supported
F: autogen.sh
F: config/*.in
F: install.sh
F: m4/
F: configure
F: docs/Makefile
F: docs/man/
F: stubdom/Makefile
F: *.ac
F: */configure
F: */*.ac
F: tools/
VM EVENT, MEM ACCESS and MONITOR
M: Tamas K Lengyel <[email protected]>
R: Alexandru Isaila <[email protected]>
R: Petre Pircalabu <[email protected]>
S: Supported
F: tools/tests/xen-access
F: xen/arch/*/monitor.c
F: xen/arch/*/vm_event.c
F: xen/arch/arm/mem_access.c
F: xen/arch/x86/mm/mem_access.c
F: xen/arch/x86/hvm/monitor.c
F: xen/arch/x86/hvm/vm_event.c
F: xen/common/mem_access.c
F: xen/common/monitor.c
F: xen/common/vm_event.c
F: xen/include/*/mem_access.h
F: xen/include/*/monitor.h
F: xen/include/*/vm_event.h
F: xen/include/asm-x86/hvm/monitor.h
F: xen/include/asm-x86/hvm/vm_event.h
VPCI
M: Roger Pau Monné <[email protected]>
S: Supported
F: xen/drivers/vpci/
F: xen/include/xen/vpci.h
VTPM
M: Daniel De Graaf <[email protected]>
M: Quan Xu <[email protected]>
S: Supported
F: extras/mini-os/tpm*
F: extras/mini-os/include/tpm*
F: stubdom/vtpm/
F: stubdom/vtpmmgr/
F: docs/misc/vtpm-platforms.txt
X86 ARCHITECTURE
M: Jan Beulich <[email protected]>
M: Andrew Cooper <[email protected]>
M: Roger Pau Monné <[email protected]>
R: Wei Liu <[email protected]>
S: Supported
F: xen/arch/x86/
F: xen/include/asm-x86/
F: xen/include/public/arch-x86/
F: xen/include/xen/lib/x86
F: xen/lib/x86
F: tools/firmware/hvmloader/
F: tools/firmware/rombios/
F: tools/firmware/vgabios/
F: tools/fuzz/cpu-policy/
F: tools/fuzz/x86_instruction_emulator/
F: tools/misc/xen-cpuid.c
F: tools/tests/cpu-policy/
F: tools/tests/x86_emulator/
X86 I/O EMULATION
M: Paul Durrant <[email protected]>
S: Supported
F: xen/arch/x86/hvm/emulate.c
F: xen/arch/x86/hvm/intercept.c
F: xen/arch/x86/hvm/io.c
F: xen/arch/x86/hvm/ioreq.c
F: xen/include/asm-x86/hvm/emulate.h
F: xen/include/asm-x86/hvm/io.h
F: xen/include/asm-x86/hvm/ioreq.h
F: xen/include/public/hvm/ioreq.h
X86 MEMORY MANAGEMENT
M: Jan Beulich <[email protected]>
M: Andrew Cooper <[email protected]>
R: George Dunlap <[email protected]>
S: Supported
F: xen/arch/x86/mm/
X86 MEMORY PAGING
S: Orphaned
F: xen/arch/x86/mm/mem_paging.c
X86 MEMORY SHARING
M: Tamas K Lengyel <[email protected]>
S: Odd Fixes
F: xen/arch/x86/mm/mem_sharing.c
F: tools/tests/mem-sharing/
X86 SHADOW PAGETABLES
M: Tim Deegan <[email protected]>
S: Maintained
F: xen/arch/x86/mm/shadow/
X86 VIRIDIAN ENLIGHTENMENTS
M: Paul Durrant <[email protected]>
M: Wei Liu <[email protected]>
S: Supported
F: xen/arch/x86/guest/hyperv/
F: xen/arch/x86/hvm/viridian/
F: xen/include/asm-x86/guest/hyperv.h
F: xen/include/asm-x86/guest/hyperv-hcall.h
F: xen/include/asm-x86/guest/hyperv-tlfs.h
F: xen/include/asm-x86/hvm/viridian.h
XENTRACE
M: George Dunlap <[email protected]>
S: Supported
F: tools/xentrace/
F: xen/common/trace.c
F: xen/include/xen/trace.h
XSM/FLASK
M: Daniel De Graaf <[email protected]>
S: Supported
F: tools/flask/
F: xen/include/xsm/
F: xen/xsm/
F: docs/misc/xsm-flask.txt
THE REST
M: Andrew Cooper <[email protected]>
M: George Dunlap <[email protected]>
M: Ian Jackson <[email protected]>
M: Jan Beulich <[email protected]>
M: Julien Grall <[email protected]>
M: Stefano Stabellini <[email protected]>
M: Wei Liu <[email protected]>
S: Supported
F: *
F: */
V: xen-maintainers-1