vblade/vblade.8

.TH vblade 8
.SH NAME
vblade, vbladed \- export data via ATA over Ethernet
.SH SYNOPSIS
.nf
.B vblade [ -m mac[,mac...] ] shelf slot netif filename
.fi
.SH DESCRIPTION
The
.I vblade
command starts a process that uses raw sockets to perform ATA over
Ethernet, acting like a virtual EtherDrive (R) blade.
.PP
The 
.I vbladed
script can be used to daemonize the vblade process,
detaching it from your terminal and sending its output to the system
logs.
.SS Arguments
.TP
\fBshelf\fP
This should be the shelf address (major AoE address) of the AoE device
to create.
.TP
\fBslot\fP
This should be the slot address (minor AoE address) of the AoE device
to create.
.TP
\fBnetif\fP
The name of the ethernet network interface to use for AoE
communications.
.TP
\fBfilename\fP
The name of the regular file or block device to export.
.SS Options
.TP
\fB-m\fP
The -m flag takes an argument, a comma separated list of MAC addresses
permitted access to the vblade.  A MAC address can be specified in upper
or lower case, with or without colons.
.SH EXAMPLE
In this example, the root user on a host named
.I nai
exports a file named "3TB" to the LAN on eth0 using AoE shelf address 11
and slot address 1.  The process runs in the foreground.  Using 
.I vbladed
would have resulted in the process running as a daemon in the
background.
.IP
.EX
.nf
nai:~# vblade 11 1 eth0 /data/3TB
.fi
.EE
.SH BUGS
Users of Jumbo frames should read the README file distributed with
vblade to learn about a workaround for kernel buffering limitations.
.SH AUTHOR
Brantley Coile (brantley@coraid.com)