MAINTAINERS

   1
   2         List of maintainers and how to submit Lustre changes
   3
   4 Please try to follow the guidelines below.  This will make things
   5 easier on the maintainers.  Not all of these guidelines matter for every
   6 trivial patch so apply some common sense.
   7
   8 1.      Always _test_ your changes, however small.
   9
  10 2.      PLEASE remember that submissions must be made under the terms
  11         of the Linux Foundation certificate of contribution and should
  12         include a Signed-off-by: line.  The current version of this
  13         "Developer's Certificate of Origin" (DCO) is listed in the file
  14         Documentation/process/submitting-patches.rst.
  15
  16 3.      Make sure your changes compile correctly in multiple
  17         configurations. In particular check that changes work both as a
  18         module and built into the kernel.
  19
  20 4.      Add reviewers to the patch based on the get_maintainers.pl script.
  21
  22 5.      PLEASE check your patch with the automated style checker
  23         (contrib/scripts/checkpatch.pl) to catch trivial style violations.
  24
  25 6.      Make sure you have the right to send any changes you make. If you
  26         do changes at work you may find your employer owns the patch
  27         not you.
  28
  29 7.      Happy hacking.
  30
  31 Descriptions of section entries:
  32
  33         M: Mail patches to: FullName <address@domain>
  34         R: Designated reviewer: FullName <address@domain>
  35            These reviewers should be CCed on patches.
  36         W: Web-page with status/info
  37         B: URI for where to file bugs. A web-page with detailed bug
  38            filing info, a direct bug tracker link, or a mailto: URI.
  39         C: URI for chat protocol, server and channel where developers
  40            usually hang out, for example irc://server/channel.
  41         T: SCM tree type and location.
  42            Type is one of: git, hg, quilt, stgit, topgit
  43         S: Status, one of the following:
  44            Supported:   Someone is actually paid to look after this.
  45            Maintained:  Someone actually looks after it.
  46            Odd Fixes:   It has a maintainer but they don't have time to do
  47                         much other than throw the odd patch in. See below..
  48            Orphan:      No current maintainer [but maybe you could take the
  49                         role as you write your new code].
  50            Obsolete:    Old code. Something tagged obsolete generally means
  51                         it has been replaced by a better system and you
  52                         should be using that.
  53         F: Files and directories with wildcard patterns.
  54            A trailing slash includes all files and subdirectory files.
  55            F:   drivers/net/    all files in and below drivers/net
  56            F:   drivers/net/*   all files in drivers/net, but not below
  57            F:   */net/*         all files in "any top level directory"/net
  58            One pattern per line.  Multiple F: lines acceptable.
  59         N: Files and directories with regex patterns.
  60            N:   [^a-z]tegra     all files whose path contains the word tegra
  61            One pattern per line.  Multiple N: lines acceptable.
  62            scripts/get_maintainer.pl has different behavior for files that
  63            match F: pattern and matches of N: patterns.  By default,
  64            get_maintainer will not look at git log history when an F: pattern
  65            match occurs.  When an N: match occurs, git log history is used
  66            to also notify the people that have git commit signatures.
  67         X: Files and directories that are NOT maintained, same rules as F:
  68            Files exclusions are tested before file matches.
  69            Can be useful for excluding a specific subdirectory, for instance:
  70            F:   net/
  71            X:   net/ipv6/
  72            matches all files in and below net excluding net/ipv6/
  73         K: Keyword perl extended regex pattern to match content in a
  74            patch or file.  For instance:
  75            K: of_get_profile
  76               matches patches or files that contain "of_get_profile"
  77            K: \b(printk|pr_(info|err))\b
  78               matches patches or files that contain one or more of the words
  79               printk, pr_info or pr_err
  80            One regex pattern per line.  Multiple K: lines acceptable.
  81
  82 This list is meant to remain in alphabetical order. Please add yourselves
  83 to it in alphabetical order.  Please include "Lustre" in the subsystem
  84 description, even though it is currently redundant, so that it is easier
  85 to keep this in sync once the client is merged upstream.
  86
  87 Maintainers List (try to look for most precise areas first)
  88
  89                 -----------------------------------
  90
  91 Lustre data checksums
  92 R:      Andreas Dilger <adilger@whamcloud.com>
  93 S:      Supported
  94 F:      lustre/include/uapi/linux/lustre/lustre_idl.h
  95 F:      lustre/include/uapi/linux/lustre/lustre_user.h
  96 F:      lustre/ptlrpc/pack_generic.c
  97 F:      lustre/ptlrpc/layout.c
  98 F:      lustre/utils/wire*.c
  99 F:      lustre/ptlrpc/wire*.c
 100 K:      \b(OBD_CKSUM_|OBD_FL_CKSUM|OBD_CONNECT_CKSUM)
 101
 102 Lustre GSSAPI
 103 S:      Odd Fixes
 104 F:      lustre/doc/lgss_sk.8
 105 F:      lustre/utils/gss
 106 F:      lustre/ptlrpc/gss
 107 F:      lustre/ptlrpc/sec*.c
 108 F:      lustre/tests/sanity-sec.sh
 109
 110 Lustre HSM
 111 S:      Maintained
 112 F:      lustre/doc/llapi_hsm*.3
 113 F:      lustre/utils/lhsmtool_posix.c
 114 F:      lustre/utils/liblustreapi_hsm.c
 115
 116 Lustre library interface
 117 R:      Andreas Dilger <adilger@whamcloud.com>
 118 S:      Supported
 119 F:      lustre/doc/llapi_*.3
 120 F:      lustre/utils/liblustreapi*.c
 121 F:      lustre/utils/lustreapi_internal.h
 122 F:      lustre/include/lustre/lustreapi.h
 123
 124 Lustre Network Request Scheduler
 125 S:      Maintained
 126 F:      lustre/ptlrpc/nrs*.c
 127 K:      (quota|QUOTA)
 128
 129 Lustre Networking
 130 S:      Supported
 131 F:      lnet/
 132
 133 Lustre Nodemap
 134 S:      Maintained
 135 F:      lustre/ptlrpc/nodemap*.[ch]
 136 K:      (quota|QUOTA)
 137
 138 Lustre /proc and /sys
 139 S:      Maintained
 140 F:      lustre/*/*lproc*.[ch]
 141 K:      (quota|QUOTA)
 142
 143 Lustre protocol compatibility
 144 R:      Andreas Dilger <adilger@whamcloud.com>
 145 S:      Supported
 146 F:      lustre/include/uapi/linux/lustre/lustre_idl.h
 147 F:      lustre/include/uapi/linux/lustre/lustre_user.h
 148 F:      lustre/ptlrpc/pack_generic.c
 149 F:      lustre/ptlrpc/layout.c
 150 F:      lustre/utils/wire*.[ch]
 151 F:      lustre/ptlrpc/wire*.[ch]
 152 K:      OBD_CONNECT
 153
 154 Lustre quotas
 155 S:      Maintained
 156 F:      lustre/quota/
 157 F:      lustre/osc/osc_quota.c
 158 F:      lustre/osd-ldiskfs/osd_quota*.[ch]
 159 F:      lustre/osd-zfs/osd_quota*.[ch]
 160 F:      lustre/tests/sanity-quota.sh
 161 F:      lustre/doc/*quota*.[13]
 162 K:      (quota|QUOTA)
 163
 164 Lustre user documentation
 165 R:      Andreas Dilger <adilger@whamcloud.com>
 166 S:      Supported
 167 F:      lustre/doc/*.[1-9]
 168
 169 Lustre userspace tools
 170 R:      Andreas Dilger <adilger@whamcloud.com>
 171 S:      Supported
 172 F:      lustre/utils/
 173 X:      lustre/utils/gss/
 174