NAME
aoe – ATA–over–Ethernet (AoE) interface |
SYNOPSIS
bind –a #æ /dev /dev/aoe/ctl /dev/aoe/log /dev/aoe/shelf.slot/config /dev/aoe/shelf.slot/ctl /dev/aoe/shelf.slot/devlink/0 ... /dev/aoe/shelf.slot/devlink/i /dev/aoe/shelf.slot/ident ... |
DESCRIPTION
The AoE (ATA–over–Ethernet) interface serves a three–level directory
providing control and access to AoE targets. The interface provided
is primarily intended for low–level control of the AoE initiator.
See sdaoe(3) for the standard interface. Top–level files
Each local interface is called a netlink. The mapping of AoE targets to netlinks is called a devlink. Each devlink may see multiple interfaces per target. For example, if the local machine has one Ethernet address bound and the target has two interfaces on the same Ethernet segment, this will result in one netlink and one devlink with two Ethernet addresses. AoE frames are sent in round–robin fashion. Each successive frame is sent on the next address available on the next available devlink (local interface).
Normally the initiator automatically discovers and adds new device
directories on startup. New devices are not added except as new
interfaces are bound to the initiator. Several messages can be
written to /dev/aoe/ctl which alter this behavior:
debug autodiscover rediscover Returns the current state of the variable named by the keyword. Writing the variable's name to the control file toggles the state of that variable. ifn path Path to nth bound Ethernet device. ifn ea Ethernet address of this device. ifn flag A flag of ``Up'' indicates that this interface is available. ifn lostjumbo Number of consecutive lost jumbograms. ifn datamtu Incorrect and unused. Shelf–and–slot subdirectories
Reading a shelf and slot's ctl file returns a list of colon–separated
lines with the following keywords and values: The data file may be read or written like a normal file except that reads and writes to this file are converted to AoE commands to the target, so transfers should be 512 or 1024 bytes long (or a larger multiple of 512 iff jumbo packets are in use). The size of this file is the usable size of the target.
The devlink directory contains one file for each interface the
target was discovered on. The files are numbers from 0 to n and
contain a list of colon–separated lines with keywords and their
values:
|
SOURCE
/sys/src/9/port/devaoe.c |
SEE ALSO
sd(3), sdaoe(3), vblade(8), snoopy(8) http://www.coraid.com/documents/AoEr10.txt Van Jacobson and Michael J. Karels, ``Congestion Avoidance and Control'', ACM Computer Communication Review; Proceedings of the Sigcomm '88 Symposium in Stanford, CA, August, 1988. |
BUGS
There is no raw file for executing arbitrary commands.
This is a fairly primitive interface; sdaoe(3) is usually more
suitable. |