share/man/man7d/vni.7d

   1 '\" te
   2 .\" Copyright (c) 2004 Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH VNI 7D "Jul 18, 2004"
   7 .SH NAME
   8 vni \- STREAMS virtual network interface driver
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 The \fBvni\fR pseudo device is a multi-threaded, loadable, clonable, STREAMS
  13 pseudo-device supporting the connectionless Data Link Provider Interface
  14 \fBdlpi\fR(7P) Style 2. Note that DLPI is intended to interact with IP, meaning
  15 that DLPI access to applications is not supported. (For example, snoop fails on
  16 the \fBvni\fR interface.)
  17 .sp
  18 .LP
  19 The \fBvni\fR device is a software-only interface and does not send or receive
  20 data. The device provides a DLPI upper interface that identifies itself to IP
  21 with a private media type. It can be configured via \fBifconfig\fR(8) and can
  22 have IP addresses assigned to it, making aliases possible.
  23 .sp
  24 .LP
  25 The \fBvni\fR pseudo device is particularly useful in hosting an IP address
  26 when used in conjunction with the 'usesrc' \fBifconfig\fR option (see
  27 \fBifconfig\fR(8) for examples).  The logical instances of the device can also
  28 be used to host addresses as an alternative to hosting them over the loopback
  29 interface.
  30 .sp
  31 .LP
  32 Multicast is not supported on this device. More specifically, the following
  33 options return an error when used with an address specified on \fBvni\fR:
  34 IP_MULTICAST_IF, IP_ADD_MEMBERSHIP, IP_DROP_MEMBERSHIP, IPV6_MULTICAST_IF,
  35 IPV6_JOIN_GROUP, IPV6_LEAVE_GROUP. In addition, broadcast is not supported.
  36 .sp
  37 .LP
  38 Because there is no physical hardware configured below it, no traffic can be
  39 received through nor transmitted on a virtual interface. All packet
  40 transmission and reception is accomplished with existing physical interfaces
  41 and tunnels. Because applications that deal with packet transmission and
  42 reception (such as packet filters) cannot filter traffic on virtual interfaces,
  43 you cannot set up a packet filter on a virtual interface. Instead, you should
  44 configure the policy rules to apply to the physical interfaces and tunnels, and
  45 if necessary, use the virtual IP addresses themselves as part of the rule
  46 configuration. Also, note that the virtual interface cannot be part of an IP
  47 multipathing (IPMP) group.
  48 .SH FILES
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fB/dev/vni\fR\fR
  53 .ad
  54 .RS 12n
  55 64-bit ELF kernel driver
  56 .RE
  57
  58 .SH SEE ALSO
  59 .sp
  60 .LP
  61 \fBifconfig\fR(8), \fBin.mpathd\fR(8), \fBip\fR(7P), \fBip6\fR(7P)