Blame view

Documentation/nvdimm/maintainer-entry-profile.rst 2.61 KB
47843401e   Dan Williams   libnvdimm, MAINTA...
1
2
3
4
5
6
  LIBNVDIMM Maintainer Entry Profile
  ==================================
  
  Overview
  --------
  The libnvdimm subsystem manages persistent memory across multiple
f45ab53f7   Randy Dunlap   nvdimm: fixes to ...
7
  architectures. The mailing list is tracked by patchwork here:
47843401e   Dan Williams   libnvdimm, MAINTA...
8
9
10
  https://patchwork.kernel.org/project/linux-nvdimm/list/
  ...and that instance is configured to give feedback to submitters on
  patch acceptance and upstream merge. Patches are merged to either the
f45ab53f7   Randy Dunlap   nvdimm: fixes to ...
11
  'libnvdimm-fixes' or 'libnvdimm-for-next' branch. Those branches are
47843401e   Dan Williams   libnvdimm, MAINTA...
12
13
  available here:
  https://git.kernel.org/pub/scm/linux/kernel/git/nvdimm/nvdimm.git/
f45ab53f7   Randy Dunlap   nvdimm: fixes to ...
14
  In general patches can be submitted against the latest -rc; however, if
47843401e   Dan Williams   libnvdimm, MAINTA...
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
  the incoming code change is dependent on other pending changes then the
  patch should be based on the libnvdimm-for-next branch. However, since
  persistent memory sits at the intersection of storage and memory there
  are cases where patches are more suitable to be merged through a
  Filesystem or the Memory Management tree. When in doubt copy the nvdimm
  list and the maintainers will help route.
  
  Submissions will be exposed to the kbuild robot for compile regression
  testing. It helps to get a success notification from that infrastructure
  before submitting, but it is not required.
  
  
  Submit Checklist Addendum
  -------------------------
  There are unit tests for the subsystem via the ndctl utility:
  https://github.com/pmem/ndctl
  Those tests need to be passed before the patches go upstream, but not
  necessarily before initial posting. Contact the list if you need help
  getting the test environment set up.
06b9c2699   Lukas Bulwahn   docs: nvdimm: use...
34
35
  ACPI Device Specific Methods (_DSM)
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
f45ab53f7   Randy Dunlap   nvdimm: fixes to ...
36
  Before patches enabling a new _DSM family will be considered, it must
47843401e   Dan Williams   libnvdimm, MAINTA...
37
38
  be assigned a format-interface-code from the NVDIMM Sub-team of the ACPI
  Specification Working Group. In general, the stance of the subsystem is
f45ab53f7   Randy Dunlap   nvdimm: fixes to ...
39
  to push back on the proliferation of NVDIMM command sets, so do strongly
47843401e   Dan Williams   libnvdimm, MAINTA...
40
  consider implementing support for an existing command set. See
f45ab53f7   Randy Dunlap   nvdimm: fixes to ...
41
  drivers/acpi/nfit/nfit.h for the set of supported command sets.
47843401e   Dan Williams   libnvdimm, MAINTA...
42
43
44
45
46
47
48
  
  
  Key Cycle Dates
  ---------------
  New submissions can be sent at any time, but if they intend to hit the
  next merge window they should be sent before -rc4, and ideally
  stabilized in the libnvdimm-for-next branch by -rc6. Of course if a
f45ab53f7   Randy Dunlap   nvdimm: fixes to ...
49
  patch set requires more than 2 weeks of review, -rc4 is already too late
47843401e   Dan Williams   libnvdimm, MAINTA...
50
51
52
53
54
55
56
57
58
  and some patches may require multiple development cycles to review.
  
  
  Review Cadence
  --------------
  In general, please wait up to one week before pinging for feedback. A
  private mail reminder is preferred. Alternatively ask for other
  developers that have Reviewed-by tags for libnvdimm changes to take a
  look and offer their opinion.