docs: aoe: convert docs to ReST and rename to *.rst

Introduction

============

ATA over Ethernet is a network protocol that provides simple access to

block storage on the LAN.

the aoetools.

CREATING DEVICE NODES

Creating Device Nodes

=====================

  Users of udev should find the block device nodes created

  automatically, but to create all the necessary device nodes, use the

  confusing when an AoE device is not present the first time the a

  command is run but appears a second later.

USING DEVICE NODES

Using Device Nodes

==================

  "cat /dev/etherd/err" blocks, waiting for error diagnostic output,

  like any retransmitted packets.

  by sysfs counterparts.  Using the commands in aoetools insulates

  users from these implementation details.

  The block devices are named like this:

  The block devices are named like this::

	e{shelf}.{slot}

	e{shelf}.{slot}p{part}

  first shelf (shelf address zero).  That's the whole disk.  The first

  partition on that disk would be "e0.2p1".

USING SYSFS

Using sysfs

===========

  Each aoe block device in /sys/block has the extra attributes of

  state, mac, and netif.  The state attribute is "up" when the device

  There is a script in this directory that formats this information in

  a convenient way.  Users with aoetools should use the aoe-stat

  command.

  command::

    root@makki root# sh Documentation/aoe/status.sh

       e10.0            eth3              up

  for this purpose.  You can also directly use the

  /dev/etherd/discover special file described above.

DRIVER OPTIONS

Driver Options

==============

  There is a boot option for the built-in aoe driver and a

  corresponding module parameter, aoe_iflist.  Without this option,

  all network interfaces may be used for ATA over Ethernet.  Here is a

  usage example for the module parameter.

  usage example for the module parameter::

    modprobe aoe_iflist="eth1 eth3"

Example of udev rules

---------------------

 .. include:: udev.txt

    :literal:

Example of udev install rules script

------------------------------------

 .. literalinclude:: udev-install.sh

    :language: shell

Example script to get status

----------------------------

 .. literalinclude:: status.sh

    :language: shell

Example of AoE autoload script

------------------------------

 .. literalinclude:: autoload.sh

    :language: shell

:orphan:

=======================

ATA over Ethernet (AoE)

=======================

.. toctree::

    :maxdepth: 1

    aoe

    todo

    examples

.. only::  subproject and html

   Indices

   =======

   * :ref:`genindex`

TODO

====

There is a potential for deadlock when allocating a struct sk_buff for

data that needs to be written out to aoe storage.  If the data is

being written from a dirty page in order to free that page, and if

#   udev_rules="/etc/udev/rules.d/"

#   bash# ls /etc/udev/rules.d/

#   10-wacom.rules  50-udev.rules

#   bash# cp /path/to/linux-2.6.xx/Documentation/aoe/udev.txt \

#   bash# cp /path/to/linux/Documentation/aoe/udev.txt \

#           /etc/udev/rules.d/60-aoe.rules

#