NfsRdmaClient/Home
From Linux NFS
Chucklever (Talk | contribs) (→Submitting patches) |
Chucklever (Talk | contribs) (→Submitting patches) |
||
| Line 43: | Line 43: | ||
It is strongly recommended that patches be compile-tested, tested with sparse, and run by scripts/checkpatch.pl before submission. Patches should be tested with the tools above before submission, though that's not needed if you are posting only for review. | It is strongly recommended that patches be compile-tested, tested with sparse, and run by scripts/checkpatch.pl before submission. Patches should be tested with the tools above before submission, though that's not needed if you are posting only for review. | ||
| - | Label your patches "[RFC ... ]" or "untested" "DO NOT APPLY" or "for review only" so | + | ==== Review ==== |
| + | |||
| + | Label your patches "[RFC ... ]" or "untested" "DO NOT APPLY" or "for review only" so maintainers know the patch is for review and may not be broadly tested yet. | ||
Submit patches to linux-nfs@vger.kernel.org and linux-rdma@vger.kernel.org for review. | Submit patches to linux-nfs@vger.kernel.org and linux-rdma@vger.kernel.org for review. | ||
| + | |||
| + | If you have reviewed a posted patch, reply with a "Reviewed-by:". If you've tested it, reply with a "Tested-by:" | ||
| + | |||
| + | ==== Merge request ==== | ||
| + | |||
| + | When the community feels a client-side patch is ready to be merged, submit the patches again to linux-nfs@vger.kernel.org and linux-rdma@vger.kernel.org, and cc: Anna.Schumaker@netapp.com. Anna will collect ready patches for Trond to merge upstream. | ||
| + | |||
| + | We are still developing a mechanism for requesting server-side fixes be merged. | ||
=== Engineering Notes === | === Engineering Notes === | ||
* [[NfsRdmaClient/MemRegModes|Simplifying memory registration modes]] | * [[NfsRdmaClient/MemRegModes|Simplifying memory registration modes]] | ||
Revision as of 16:47, 30 April 2014
Contents |
Support for Linux NFS/RDMA Client upstream
Goals
Provide maintenance for NFS/RDMA and RPC/RDMA client-side code in the Linux kernel. Support continuous testing of NFS/RDMA feature in upstream Linux kernels. Provide enhancements (see below). Identify resources for supporting server-side code.
Bug tracking
Upstream bug tracking is here.
Feature planning
Our Pivotal Tracking project lists individual work items and defines several long-term arcs. At a high level, these include:
- Broad support for a variety of RDMA-capable hardware
- Performance and scalability enhancements
- Support for NFSv4.1
- Observability features that enable distributor support teams and customers to diagnose and address problems
Developer tools
For anyone working directly on Linux NFS/RDMA or RPC/RDMA, please consider the following tools for validating your work.
- cthon04: git://git.linux-nfs.org/projects/steved/cthon04.git
- xfstests: git://oss.sgi.com/xfs/cmds/xfstests
- fsx
- IOzone
- fio
- Multi-process Linux kernel builds
Typically, for testing, the NFS/RDMA server exports a tmpfs or ram disk-based local FS to drive the transport fast enough.
Asking for help
You can find Linux NFS developers at linux-nfs@vger.kernel.org, or in the linux-nfs chatroom at oftc.net.
Submitting patches
Clone the upstream Linux kernel with:
$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
General advice for preparing upstream kernel or nfs-utils patches: see SubmittingPatches.
It is strongly recommended that patches be compile-tested, tested with sparse, and run by scripts/checkpatch.pl before submission. Patches should be tested with the tools above before submission, though that's not needed if you are posting only for review.
Review
Label your patches "[RFC ... ]" or "untested" "DO NOT APPLY" or "for review only" so maintainers know the patch is for review and may not be broadly tested yet.
Submit patches to linux-nfs@vger.kernel.org and linux-rdma@vger.kernel.org for review.
If you have reviewed a posted patch, reply with a "Reviewed-by:". If you've tested it, reply with a "Tested-by:"
Merge request
When the community feels a client-side patch is ready to be merged, submit the patches again to linux-nfs@vger.kernel.org and linux-rdma@vger.kernel.org, and cc: Anna.Schumaker@netapp.com. Anna will collect ready patches for Trond to merge upstream.
We are still developing a mechanism for requesting server-side fixes be merged.
