aoe-mkshelf.8 2.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. .TH aoe-mkshelf 8
  2. .SH NAME
  3. aoe-mkshelf \- create special device files for one shelf address
  4. .SH SYNOPSIS
  5. .nf
  6. .B aoe-mkshelf {device-dir} {shelf-address}
  7. .B env n_partitions=1 aoe-mkshelf {device-dir} {shelf-address}
  8. .fi
  9. .SH DESCRIPTION
  10. The
  11. .I aoe-mkshelf
  12. command is not needed on systems that have udev installed and
  13. is incompatible with aoe drivers that have the \fIaoe_dyndevs\fP
  14. module parameter set to 1.
  15. .PP
  16. Systems lacking udev and having an aoe driver that uses static minor
  17. device numbers can use \fIaoe-mkshelf\fP to create the block special
  18. files necessary to access the AoE devices with the given shelf
  19. address.
  20. .PP
  21. All aoe drivers prior to \fIaoe6-50\fP use static minor device
  22. numbers. Versions 50 and up use dynamic minor device numbers
  23. when the module parameter aoe_dyndevs=1 is set.
  24. .PP
  25. If you are using static minor device numbers and your aoe driver
  26. supports only one partition per device (whole-disk
  27. partitions), then the device files must match, and you should use the
  28. .I n_partitions
  29. environment variable described below.
  30. .SS Arguments
  31. .TP
  32. \fBdevice-dir\fP
  33. This should be the name of the directory where the block device files
  34. will be created.
  35. .TP
  36. \fBshelf-address\fP
  37. This is the AoE major address, or shelf address, for which to create
  38. device nodes. For example, specifying a shelf address of 1 means that
  39. the e1.* device nodes will be created in \fBdevice-dir\fP.
  40. .SH ENVIRONMENT VARIABLES
  41. If the
  42. .I n_partitions
  43. variable is set in the environment, it will override the default
  44. number of partitions per aoe disk, namely 16.
  45. .SH EXAMPLE
  46. In this example, the root user on a host named
  47. .I nai
  48. creates special files for using the aoe disks in shelf 7. Then he
  49. remembers that the driver doesn't have partition support, so the
  50. command is called again with \fIn_partitions\fP set to 1.
  51. .IP
  52. .EX
  53. .nf
  54. nai:~# aoe-mkshelf /dev/etherd 7
  55. nai:~# ls /dev/etherd/e7.* | wc -l
  56. 160
  57. nai:~# rm /dev/etherd/e7.*
  58. nai:~# n_partitions=1 aoe-mkshelf /dev/etherd 7
  59. nai:~# ls /dev/etherd/e7.* | wc -l
  60. 10
  61. nai:~#
  62. .fi
  63. .EE
  64. .SH "SEE ALSO"
  65. .IR aoe-discover (8),
  66. .IR aoe-interfaces (8),
  67. .IR aoe-mkdevs (8),
  68. .IR aoe-stat (8),
  69. .IR aoetools (8),
  70. .IR udev (7).
  71. .SH AUTHOR
  72. Ed L. Cashin (ecashin@coraid.com)