aoe-mkdevs.8 2.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. .TH aoe-mkdevs 8
  2. .SH NAME
  3. aoe-mkdevs \- create special device files for aoe driver
  4. .SH SYNOPSIS
  5. .nf
  6. .B aoe-mkdevs {device-dir}
  7. .B env n_partitions=1 aoe-mkdevs {device-dir}
  8. .fi
  9. .SH DESCRIPTION
  10. The
  11. .I aoe-mkdevs
  12. command is deprecated in favor of udev. Systems with udev do not need
  13. to use the \fIaoe-mkdevs\fP or \fIaoe-mkself\fP commands, because udev
  14. will create device nodes as needed.
  15. .PP
  16. Systems without udev use \fIaoe-mkdevs\fP to create the character
  17. special files necessary to
  18. control the aoe driver. The \fIaoe-mkdevs\fP command uses
  19. .I aoe-mkshelf
  20. to also create block special files.
  21. .PP
  22. The aoe drivers after version 49 support dynamic minor device numbers
  23. so that a greater number of devices can be supported. The
  24. \fIaoe-mkdevs\fP command is incompatible with dynamic device numbers.
  25. If your system lacks udev, and you are using an aoe driver version 50
  26. or above, use the aoe_dyndevs=0 module option to force the aoe driver
  27. to use static device numbers.
  28. .PP
  29. If you are not using dynamic device numbers, and you built your aoe
  30. driver to support only one partition per device
  31. (whole-disk
  32. partitions), then the device files must match, and you should use the
  33. .I n_partitions
  34. environment variable described below.
  35. .SS Arguments
  36. .TP
  37. \fBdevice-dir\fP
  38. This should be the name of the directory where the special device files
  39. will be created.
  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. After
  49. remembering that the driver doesn't have partition support, this
  50. sysadmin gets rid of the mismatching device nodes and calls
  51. \fIaoe-mkdevs\fP again with \fIn_partitions\fP set to 1.
  52. .IP
  53. .EX
  54. .nf
  55. nai:~# rm -rf /dev/etherd
  56. nai:~# aoe-mkdevs /dev/etherd
  57. nai:~# ls /dev/etherd | wc -l
  58. 1603
  59. nai:~# rm -rf /dev/etherd
  60. nai:~# n_partitions=1 aoe-mkdevs /dev/etherd
  61. nai:~# ls /dev/etherd | wc -l
  62. 103
  63. .fi
  64. .EE
  65. .SH "SEE ALSO"
  66. .IR aoe-discover (8),
  67. .IR aoe-interfaces (8),
  68. .IR aoe-mkshelf (8),
  69. .IR aoe-stat (8),
  70. .IR aoetools (8),
  71. .IR udev (7).
  72. .SH AUTHOR
  73. Ed L. Cashin (ecashin@coraid.com)