aoe-mkshelf.8 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  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 uses mknod to create the block special files necessary to
  13. access the AoE devices with the given shelf address.
  14. .PP
  15. If your aoe driver supports only one partition per device (whole-disk
  16. partitions), then the device files must match, and you should use the
  17. .I n_partitions
  18. environment variable described below.
  19. .SS Arguments
  20. .TP
  21. \fBdevice-dir\fP
  22. This should be the name of the directory where the block device files
  23. will be created.
  24. .TP
  25. \fBshelf-address\fP
  26. This is the AoE major address, or shelf address, for which to create
  27. device nodes. For example, specifying a shelf address of 1 means that
  28. the e1.* device nodes will be created in \fBdevice-dir\fP.
  29. .SH ENVIRONMENT VARIABLES
  30. If the
  31. .I n_partitions
  32. variable is set in the environment, it will override the default
  33. number of partitions per aoe disk, namely 16.
  34. .SH EXAMPLE
  35. In this example, the root user on a host named
  36. .I nai
  37. creates special files for using the aoe disks in shelf 7. Then he
  38. remembers that the driver doesn't have partition support, so the
  39. command is called again with \fIn_partitions\fP set to 1.
  40. .IP
  41. .EX
  42. nai:~# aoe-mkshelf /dev/etherd 7
  43. nai:~# ls /dev/etherd/e7.* | wc -l
  44. 160
  45. nai:~# rm /dev/etherd/e7.*
  46. nai:~# n_partitions=1 aoe-mkshelf /dev/etherd 7
  47. nai:~# ls /dev/etherd/e7.* | wc -l
  48. 10
  49. nai:~#
  50. .EE
  51. .LP
  52. .SH "SEE ALSO"
  53. .IR aoe-discover (8),
  54. .IR aoe-interfaces (8),
  55. .IR aoe-mkdevs (8),
  56. .IR aoe-stat (8).
  57. .SH AUTHOR
  58. Ed L. Cashin (ecashin@coraid.com)