Google Git
Sign in
kernel / pub / scm / utils / mdadm / mdadm.git / 3f90be087fa62c0c7ed76c2ac26752f0ac3a89e7
commit3f90be087fa62c0c7ed76c2ac26752f0ac3a89e7[log] [tgz]
authorMariusz Tkaczyk <mariusz.tkaczyk@linux.intel.com>Tue May 07 17:35:09 2024 +0200
committerMariusz Tkaczyk <mariusz.tkaczyk@linux.intel.com>Wed May 15 11:03:42 2024 +0200
treea120424dd7c8aaea896b448631b5706e25a3f563
parentaa1cc5815d2b14a8b47add18cfaa8264e19c10ce [diff]
mdadm: Change main repository to Github

Now github will be used for tracking mdadm, adjust README.md.
Daily routines will be automated on Github, there is not need to
decribe them.

Adjust release process, it must be published to both repositories.

Signed-off-by: Mariusz Tkaczyk <mariusz.tkaczyk@linux.intel.com>
2 files changed
tree: a120424dd7c8aaea896b448631b5706e25a3f563
  1. clustermd_tests/
  2. documentation/
  3. misc/
  4. systemd/
  5. tests/
  6. .gitignore
  7. Assemble.c
  8. bitmap.c
  9. bitmap.h
  10. Build.c
  11. CHANGELOG.md
  12. config.c
  13. COPYING
  14. coverity-gcc-hack.h
  15. crc32.c
  16. crc32.h
  17. crc32c.c
  18. Create.c
  19. Detail.c
  20. dlink.c
  21. dlink.h
  22. drive_encryption.c
  23. drive_encryption.h
  24. Dump.c
  25. Examine.c
  26. Grow.c
  27. Incremental.c
  28. INSTALL
  29. Kill.c
  30. lib.c
  31. MAINTAINERS.md
  32. Makefile
  33. Manage.c
  34. managemon.c
  35. mapfile.c
  36. maps.c
  37. md.4
  38. md5.h
  39. md_p.h
  40. md_u.h
  41. mdadm.8.in
  42. mdadm.c
  43. mdadm.conf.5.in
  44. mdadm.h
  45. mdmon.8
  46. mdmon.c
  47. mdmon.h
  48. mdopen.c
  49. mdstat.c
  50. Monitor.c
  51. monitor.c
  52. msg.c
  53. msg.h
  54. part.h
  55. platform-intel.c
  56. platform-intel.h
  57. policy.c
  58. probe_roms.c
  59. probe_roms.h
  60. pwgr.c
  61. Query.c
  62. raid5extend.c
  63. raid6check.8
  64. raid6check.c
  65. ReadMe.c
  66. README.md
  67. restripe.c
  68. sg_io.c
  69. sha1.c
  70. sha1.h
  71. super-ddf.c
  72. super-gpt.c
  73. super-intel.c
  74. super-mbr.c
  75. super0.c
  76. super1.c
  77. swap_super.c
  78. sysfs.c
  79. test
  80. udev-md-clustered-confirm-device.rules
  81. udev-md-raid-arrays.rules
  82. udev-md-raid-assembly.rules
  83. udev-md-raid-creating.rules
  84. udev-md-raid-safe-timeouts.rules
  85. udev.c
  86. udev.h
  87. util.c
  88. uuid.c
  89. xmalloc.c
README.md

mdadm is a utility used to create and manage software RAID devices implemented through Multiple devices driver (MD) in kernel. It supports following RAID metadata formats:

  • Linux native RAID:

    Known as native or native RAID. First and default metadata format. Metadata management is implemented in MD driver.

  • Matrix Storage Manager Support (no reference, metadata format documentation is proprietary).

    Known as IMSM. Metadata format developed and maintained by Intel® as a part of VROC solution. There are some functional differences between native and imsm. The most important difference is that the metadata is managed from userspace.

    CAUTION: imsm is compatible with Intel RST, however it is not officially supported. You are using it on your own risk.

  • Common RAID DDF Specification Revision

    IMPORTANT: DDF is in maintenance only mode. There is no active development around it. Please do not use it in new solutions.

Questions and Support

This Github site is not right place to ask if your are looking for:

  • support from Linux Raid Community;
  • support with kernel issues;

This is the place where development of mdadm application is done. Please, do not use for looking for support. You should always ask on Mailing List.

Please use issues if you have confirmation that issue you are experiencing is related to mdadm components:

  • mdadm;
  • mdmon;
  • raid6check;
  • swap_super;
  • test_stripe;
  • systemd services ( see systemd/);
  • udev rules;
  • manual pages (including md.man)

For example:

  • mdadm issues (e.g segfaults, memory leaks, crashes, bad communication with MD driver);
  • feature requests for mdadm;
  • suggestions or minor fixes requested (e.g. better error messages);

Generally, if you are not sure it is better to ask on Mailing List first.

How to Contribute

Effective immediately Github is the primary location for mdadm. Use pull request to contribute.

It was originally hosted on kernel.org. You can access the old repository here.

Patches sent through Mailing list are accepted but Github is preferred. Sent then to ML only if you cannot use Github. Please add “mdadm:” to the subject to allow automation to create Github Pull Request and run checks.

NOTE: Maintainers may ask you to send RFC to mailing list if the proposed code requires consultation with kernel developers.

Kernel coding style is used. Please familiarize with general kernel submitting patches documentation. Formatting, tags and commit message guidelines applies to mdadm.

Checkpatch script is run on every patch in pull request so be sure that your commits are not generating issues. There are some excludes, so the best is to follow github checkpatch action result.

Pull Request are closed by Rebase and Merge option, so it requires to keep every commit meaningful. Kernel style requires that. The review changes must be pushed with push --force to the chosen branch, then Pull Request will be automatically updated.

Maintainers of mdadm repository on kernel.org

If there are differences between github and kernel.org, please contact kernel.org mdadm maintainers:

Minimal supported kernel version

We do not support kernel versions below v3.10. Please be aware that maintainers may remove workarounds and fixes for legacy issues.

License

It is released under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.