sys/man/3/sdaoe

   1 .TH SDAOE 3
   2 .SH NAME
   3 sdaoe \- ATA-over-Ethernet (AoE) storage device interface
   4 .SH SYNOPSIS
   5 .nf
   6 .B bind -a #S /dev
   7 .BI "echo config switch on spec " l " type aoe//dev/aoe/" shelf\fB.\fPslot " >/dev/sdctl"
   8 .BI "echo config switch off spec " l " >/dev/sdctl"
   9 .sp 0.3v
  10 .BI /dev/sd l 0/ctl
  11 .BI /dev/sd l 0/raw
  12 .BI /dev/sd l 0/data
  13 \&...
  14 .sp 0.3v
  15 .fi
  16 .B addaoe
  17 .I letter
  18 .I unit
  19 .SH DESCRIPTION
  20 .I Sdaoe
  21 has a few quirks because
  22 network-attached storage can't be enumerated as directly-attached storage can.
  23 The default first controller letter for AoE devices is
  24 .LR e .
  25 Each
  26 .B sdaoe
  27 device must be configured explicitly.
  28 .PP
  29 .I Addaoe
  30 packages up the
  31 .L "switch on"
  32 invocation as an
  33 .I rc
  34 script.
  35 .PP
  36 To boot from an AoE root, the
  37 .B sd
  38 device must be configured on boot by either PXE booting or
  39 booting from directly-attached storage and adding two configuration lines to
  40 .IR plan9.ini (8)
  41 for
  42 .BR aoeif ,
  43 listing the names of the Ethernet interface(s) to use,
  44 and
  45 .BI aoedev= letter !#æ/aoe/ lun.
  46 .SH EXAMPLES
  47 To configure target (LUN)
  48 .B 42.0
  49 on
  50 .BR #S/sde0 ,
  51 .IP
  52 .EX
  53 echo config switch on spec e type aoe//dev/aoe/42.0 >/dev/sdctl
  54 .EE
  55 .PP
  56 To turn this device off,
  57 .IP
  58 .EX
  59 echo config switch off spec e >/dev/sdctl
  60 .EE
  61 .PP
  62 To boot using target
  63 .B 42.0
  64 as
  65 .B #S/sde0
  66 and as root,
  67 over Ethernet interfaces 0 and 1,
  68 .IP
  69 .EX
  70 aoeif=ether0 ether1
  71 aoedev=e!42.0
  72 .EE
  73 .SH SOURCE
  74 .B /sys/src/9/port/sdaoe.c
  75 .SH SEE ALSO
  76 .\" .IR vblade (1),
  77 .IR aoe (3),
  78 .IR sd (3),
  79 .\" .IR cec (8),
  80 .IR snoopy (8)
  81 .SH BUGS
  82 It is not currently possible to boot from an AoE target without an
  83 external bootstrap like PXE.