logo

Manual Pages


Table of Contents

NAME

vif - create and destroy virtual interfaces

SYNOPSIS

vif { create | add } vif_name interface_name ...

vif { destroy | favor | nofavor } vif_name

vif stat [ vif_name ] [ interval ]

vif status [ vif_name ]

In the vif commands, vif_name stands for the name of a virtual interface. It must be a string that is no longer than 15 characters and meets the following criteria:

-
It must begin with a letter.

-
It must not contain a space.

-
It must not already be in use for a virtual interface.

Virtual interface names are case-sensitive.

Use the ifconfig command to see what virtual interface names are being used.

DESCRIPTION

The vif command creates and eliminates virtual interfaces. It also displays statistics for a specified virtual interface.

Virtual interface names are case-sensitive.

The vif create command creates a virtual interface.

You can specify up to four Ethernet interfaces in the command. The interfaces do not have to be on the same network card. However, some Ethernet switches or routers require that all Ethernet interfaces forming a virtual interface be either half-duplex or full-duplex. Check the documentation that comes with your Ethernet switch or router to see whether you need to configure the filer Ethernet interfaces to be half-duplex or full-duplex.

The vif add command adds interfaces to an existing virtual interface.

The vif destroy command eliminates an existing virtual interface. You must configure the virtual interface down using the ifconfig command before entering the vif destroy command.

The vif favor command specifies a physical interface to be the active one in a virtual interface.

The vif nofavor command specifies that a physical interface not be the active one in a virtual interface.

The vif stat command displays the number of packets received and transmitted on each Ethernet interface that makes up the virtual interface. You can specify the time interval, in seconds, at which the statistics are displayed. By default, the statistics are displayed at one-second intervals. If you do not specify a virtual interface, the statistics for all virtual interfaces on a filer are displayed.

The vif status command displays the status of a virtual interface. If you do not specify a virtual interface, the statuses of all virtual interfaces on a filer are displayed.

EXAMPLES

The following example creates the virtual interface vif3:

toaster> vif vif3 create e0 e7a e6b e8

The following example eliminates virtual interface vif4:

toaster> vif destroy vif4

The following example displays statistics about virtual interface vif1:

toaster> vif stat vif1

  Virtual interface (trunk) vif1
      e5d                      e5c             e5b             e5a
  In      Out         In      Out     In      Out     In      Out
  8637076 47801540        158     159     7023083 38300325 8477195 47223431
  1617    9588        0       0       634     3708    919     5400
  1009    5928        0       0       925     5407    1246    7380
  1269    7506        0       0       862     5040    1302    7710
  1293    7632        0       0       761     4416    964     5676
  920     5388        0       0       721     4188    981     5784
  1098    6462        0       0       988     5772    1003    5898
  2212    13176       0       0       769     4500    1216    7185
  1315    7776        0       0       743     4320    530     3108

The following example displays the status of all virtual interfaces on a filer:

toaster> vif status

  default: transmit 'multi', fail 'log'
  vif.one: 2 links, transmit 'multi', fail 'default'
      up:
          e3a: state up, since 28Jan1999 23:57:26 (00:00:07)
                  mediatype: 100tx-fd
                  flags: enabled next-link
                  input packets 52, input bytes 3178
                  output packets 6, output bytes 553
                  up indications 6, broken indications 0
                  indication: up at 28Jan1999 23:57:28
                          consecutive 6, transitions 0
          e3b: state up, since 28Jan1999 23:57:24 (00:00:05)
                  mediatype: 100tx-fd
                  flags: enabled address-set-1
                  input packets 34, input bytes 2915
                  output packets 5, output bytes 210
                  up indications 4, broken indications 0
                  indication: up at 28Jan1999 23:57:28
                          consecutive 4, transitions 0

SEE ALSO

na_ifconfig(1)


Table of Contents