vblade.8 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. .TH vblade 8
  2. .SH NAME
  3. vblade, vbladed \- export data via ATA over Ethernet
  4. .SH SYNOPSIS
  5. .nf
  6. .B vblade [ -m mac[,mac...] ] shelf slot netif filename
  7. .fi
  8. .SH DESCRIPTION
  9. The
  10. .I vblade
  11. command starts a process that uses raw sockets to perform ATA over
  12. Ethernet, acting like a virtual EtherDrive (R) blade.
  13. .PP
  14. The
  15. .I vbladed
  16. script can be used to daemonize the vblade process,
  17. detaching it from your terminal and sending its output to the system
  18. logs.
  19. .SS Arguments
  20. .TP
  21. \fBshelf\fP
  22. This should be the shelf address (major AoE address) of the AoE device
  23. to create.
  24. .TP
  25. \fBslot\fP
  26. This should be the slot address (minor AoE address) of the AoE device
  27. to create.
  28. .TP
  29. \fBnetif\fP
  30. The name of the ethernet network interface to use for AoE
  31. communications.
  32. .TP
  33. \fBfilename\fP
  34. The name of the regular file or block device to export.
  35. .SS Options
  36. .TP
  37. \fB-b\fP
  38. The -b flag takes an argument, the advertised buffer count, specifying
  39. the maximum number of outstanding messages the server can queue for
  40. processing.
  41. .TP
  42. \fB-d\fP
  43. The -d flag selects O_DIRECT mode for accessing the underlying block
  44. device.
  45. .TP
  46. \fB-s\fP
  47. The -s flag selects O_SYNC mode for accessing the underlying block
  48. device, so all writes are committed to disk before returning to the
  49. client.
  50. .TP
  51. \fB-r\fP
  52. The -r flag restricts the export of the device to be read-only.
  53. .TP
  54. \fB-m\fP
  55. The -m flag takes an argument, a comma separated list of MAC addresses
  56. permitted access to the vblade. A MAC address can be specified in upper
  57. or lower case, with or without colons.
  58. .SH EXAMPLE
  59. In this example, the root user on a host named
  60. .I nai
  61. exports a file named "3TB" to the LAN on eth0 using AoE shelf address 11
  62. and slot address 1. The process runs in the foreground. Using
  63. .I vbladed
  64. would have resulted in the process running as a daemon in the
  65. background.
  66. .IP
  67. .EX
  68. .nf
  69. nai:~# vblade 11 1 eth0 /data/3TB
  70. .fi
  71. .EE
  72. .SH BUGS
  73. Users of Jumbo frames should read the README file distributed with
  74. vblade to learn about a workaround for kernel buffering limitations.
  75. .SH AUTHOR
  76. Brantley Coile (brantley@coraid.com)