aoetools/aoe-mkdevs.8

.TH aoe-mkdevs 8
.SH NAME
aoe-mkdevs \- create special device files for aoe driver
.SH SYNOPSIS
.nf
.B aoe-mkdevs {device-dir}
.B env n_partitions=1 aoe-mkdevs {device-dir}
.fi
.SH DESCRIPTION
The
.I aoe-mkdevs
command uses mknod to create the character special files necessary to
control the aoe driver.  It also uses 
.I aoe-mkshelf
to create block special files.
.PP
If your aoe driver supports only one partition per device (whole-disk
partitions), then the device files must match, and you should use the 
.I n_partitions
environment variable described below.
.SS Arguments
.TP
\fBdevice-dir\fP
This should be the name of the directory where the special device files
will be created.
.SH ENVIRONMENT VARIABLES
If the
.I n_partitions
variable is set in the environment, it will override the default
number of partitions per aoe disk, namely 16.
.SH EXAMPLE
In this example, the root user on a host named
.I nai
creates special files for using the aoe disks in shelf 7.  After
remembering that the driver doesn't have partition support, this
sysadmin gets rid of the mismatching device nodes and calls
\fIaoe-mkdevs\fP again with \fIn_partitions\fP set to 1.
.IP
.EX
  nai:~# rm -rf /dev/etherd 
  nai:~# aoe-mkdevs /dev/etherd
  nai:~# ls /dev/etherd | wc -l
  1603
  nai:~# rm -rf /dev/etherd
  nai:~# n_partitions=1 aoe-mkdevs /dev/etherd
  nai:~# ls /dev/etherd | wc -l
  103
.EE
.LP
.SH "SEE ALSO"
.IR aoe-discover (8),
.IR aoe-interfaces (8),
.IR aoe-mkshelf (8),
.IR aoe-stat (8).
.SH AUTHOR
Ed L. Cashin (ecashin@coraid.com)