FIPVLAN(8) Open-FCoE Tools FIPVLAN(8)
NAME fipvlan - Fibre Channel over Ethernet VLAN Discovery
SYNOPSIS fipvlan [-c|--create] [-s|--start] interfaces
fipvlan -a|--auto [-c|--create] [-s|--start]
DESCRIPTION The fipvlan command performs Fibre Channel over Ethernet (FCoE) Initialization Protocol (FIP) VLAN Discovery over Ethernet interfaces. fipvlan can be used as a diagnostic tool to determine which VLANs have FCoE services available on a network, prior to configuring VLAN interfaces and the Open-FCoE initiator. fipvlan can also be used to create VLAN interfaces as the are discovered, and to start the Open-FCoE initiator. The --create and --start options are primarily intended to be used as part of an Open-FCoE boot solution.
fipvlan takes a list of network interface names to run the VLAN discovery protocol over, or the --auto option to use all available Ethernet interfaces.
OPTIONS -a, --auto Use all Ethernet interfaces currently available
-c, --create Create network interfaces for discovered FCoE VLANs. If a VLAN device already exists for a discovered VLAN, a new VLAN device will not be created.
-s, --start Start the Open-FCoE initiator on discovered FCoE VLANs
-h, --help Display a help message with basic usage instructions
-v, --version Display the fipvlan version string
VLAN NAMING CONVENTIONS If a new VLAN device is created, it will have the name dev.vlan-fcoe; where dev is the name of the Ethernet parent device and vlan is the discovered VLAN ID number.
EXAMPLES Display all discoverable VLANs with FCoE services
Discover FCoE VLANs on interface eth2, create VLAN devices and start the Open-FCoE initiator
fipvlan --create --start eth2
In this example if FCoE services were available on VLAN 101 of network interface eth2, then a VLAN interface eth2.101-fcoe would be created and used as the parent device for the initiator.
SEE ALSO fcoeadm(8) fcoemon(8)
SUPPORT fipvlan is part of the fcoe-utils package, maintained through the Open-FCoE project. Resources for both developers and users can be found at the Open-FCoE website http://open-fcoe.org/
Open-FCoE 04/01/2010 FIPVLAN(8)