sysconfig/interfaces/ifcfg-description

   1 #       $Id: ifcfg-description,v 1.10.2.5 2001/09/30 10:19:41 misiek Exp $
   2 DEVICE=<name>
   3 [ BOOTMETHOD={none|bootp|dhcp|pump} ]
   4   You can specify which dhcp client to use with the DHCP_CLIENT, if
   5   the DHCP_CLIENT is not specified we trying to launch in order :
   6   /sbin/dhcpcd
   7   /sbin/dhclient
   8   /sbin/dhcpxd
   9   /sbin/pump
  10   if you have a preferred client define the DHCP_CLIENT variable.
  11   You can also pass some options to dhcl client via DHCP_OPTIONS.
  12
  13 [ BOOTMETHOD6={none|dhcp6|v4compat}
  14   dhcp6 method isn't supported, yet.
  15   v4compat uses available IPv4 addresses (ie. from DHCPv4)
  16   and then convert them to IPv6 (IPv4-compatible) to use with
  17   automatic tunnels
  18
  19
  20 IP_1_ADDR="(IPv4 or IPv6 address)/prefix"
  21 IP_1_AOPTS="broadcast xxx etc" (by default broadcast is autocalculated)
  22 IP_1_ROPTS=""
  23
  24 IP_2_ADDR=
  25 IP_2_AOPTS= options for ip addr add
  26 IP_2_ROPTS= options for ip route add (currently used only for IP4_PRIM_NR)
  27
  28 IP4_PRIM_NR="2"         # number X of primary IPv4 interface (IP_X_ADDR)
  29 IP4_SRC_NR="2"          # number X of IPv4 address for ip's ,,src'' parameter
  30 IP6_PRIM_NR=""          #
  31 IP6_SRC_NR=""           #
  32
  33 [ ONBOOT={no|yes} ]
  34 [ MULTICAST={|no|yes} ] - for eth automamaticly set to yes
  35 [ ARP={no|yes} ]        - for eth automamaticly set to yes
  36 [ IPV6_DISABLE_AUTOCONF={yes|no} ] - disable IPv6 autoconfiguration
  37
  38 [ IPX=yes|no ]
  39 if      IPX=yes ; then
  40
  41         IPXNETNUM_{802_2,802_2TR,802_3,EtherII,SNAP}
  42         IPXPRIMARY_{802_2,802_2TR,802_3,EtherII,SNAP}=yes|no
  43         IPXACTIVE_{802_2,802_2TR,802_3,EtherII,SNAP}=yes|no
  44 fi
  45
  46 [ MTU= ]
  47 [ METRIC= ]
  48
  49 [ QDISC= ]
  50
  51 [ DEFAULTHANDLING=yes|no ] (used in configuration for ATM interfaces,
  52                             obsolete variable)
  53 [ HANDLING=0|1|2|3 ] (0 is default; used ie. in ATM configuration, for
  54                       details see ifup script)
  55
  56 if      DEVICE=eth* ; then
  57
  58         [ MEDIA={auto|10baseT|10base2|AUI} ]
  59         [ MAC=<hw addres> ]
  60
  61 elif    DEVICE=ppp* || DEVICE=sl* ; then
  62
  63         PERSIST=yes|no
  64         MODEMPORT=<device, say /dev/modem>
  65         LINESPEED=<speed, say 115200>
  66         DEFABORT=yes|no
  67
  68         if      DEVICE=ppp* ; then
  69
  70                 DIRECT_CONNECT=yes|no (dirrect connection without modem ?)
  71                 WVDIALSECT=<section name> from /etc/wvdial.conf; if not set
  72                            use chat program
  73                 AUTH=yes|no
  74                 PEERDNS=yes|no
  75                 DEFROUTE=yes|no
  76                 ESCAPECHARS=yes|no
  77                 HARDFLOWCTL=yes|no ("crtscts" pppd option)
  78                 MODEMCTL=yes|no ("modem" pppd option)
  79                 PPPOPTIONS=<arbitrary option string>
  80                 PAPNAME=<"name $PAPNAME" on pppd command line>
  81                 REMIP=<remote ip4 address, normally unspecified>
  82                 REMIP6=<remote ip6 address, normally unspecified>
  83                 MRU=
  84                 INITSCRIPT=<modem command>
  85                 IPV6_PPP=yes|no (IPv6 over ppp)
  86                 if IPV6_PPP = yes ; then
  87                         IPV6_CP_USEV4=yes|no (use local IPv4 mapped addresses
  88                                               as IPv6 addresses)
  89                         IPV6_CP_PERSISTENT=yes|no (use EUI-48 addresses
  90                                                    as IPv6 addresses; not
  91                                                    supported on Linux, yet)
  92                         or by default use address specified by IP6_PRIM_NR
  93                         and REMIP6
  94                 fi
  95                 IPX_PPP=yes|no
  96                 if IPX_PPP = yes; then
  97                         IPX_PPP_NETWORK=hex net number without leading 0x
  98                         IPX_PPP_NODE=n:m node number
  99                         IPX_PPP_ROUTING=routing protocol
 100                 fi
 101
 102         elif    DEVICE=sl* ; then       (SLIP)
 103                 DIRECT_CONNECT=yes|no (dirrect connection via slattach ?)
 104                 PROTOCOL=slip|cslip|adaptive
 105                 REMIP=<remote ip4 address>
 106                 REMIP6=<remote ip6 address, normally unspecified>
 107         fi
 108
 109 elif    DEVICE=br* ; then       /* Bridge */
 110
 111         BRIDGE_DEVS=<list of devices betwen which do bridging>
 112                     Note: separation configuration for devices in this list
 113                           should be avoided !
 114         AGEING=<ethernet (MAC) address ageing time in seconds>
 115         GCINT=<garbage collection interval time for the bridge in seconds>
 116
 117         SPANNING_TREE=yes|no (enable SPT - Spanning Tree Protocol)
 118         if      SPANNING_TREE=yes ; then
 119                         BRIDGEPRIO=<bridge's priority; 0-65535; less == better>
 120                         FD=<bridge forward delay time in seconds>
 121                         HELLO=<bridge hello time in seconds>
 122                         MAXAGE=<maximum message age in seconds>
 123                         PATHCOST_PORT=<port number>
 124                         PATHCOST=<cost of the port specified in PATHCOST_PORT>
 125                                 Note: both PATHCOST_PORT and PATHCOST must be
 126                                       specified to set cost of port
 127                         PORTPRIO_PORT=<port>
 128                         PORTPRIO=<port priority used by port selection algorithms;
 129                                   a number between 0 and 255>
 130                                 Note: see note above
 131         fi
 132
 133 elif    DEVICE=irda* ; then     /* IrDA */
 134
 135         IRDAPORT=<device, say /dev/ttyS1>
 136         DONGLE=<driver, see README.irattach from irda-utils package>
 137         DISCOVERY=yes|no (starts discovery of remote IrDA devices)
 138
 139 elif    DEVICE=vlan* ; then     /* Virtual LAN */
 140
 141         VLAN_DEV=<real VLAN device, ie. eth0>
 142
 143 elif    DEVICE=lec* ; then      /* ATM LAME  */
 144
 145 # LANE settings:
 146
 147         VLAN_NAME=<vlan name to connect to>
 148         VLAN_FORESWITCH_NAME="$HOSTNAME-$VLAN_NAME"
 149         LEC_LISTEN_ADDR=<local listen address or selector byte>
 150         LEC_PHYS=<physical interface number (use to choose card)>
 151         LANE_VERSION=<LANE version, 1 or 2, LANEv2 is required for MPOA>
 152         LANE_PROXY=yes|no (enable proxy, used for bridging ATM and ethernet)
 153         LECS_ADDR=<address of LECS>
 154         LES_ADDR=<address of LES>
 155         LEC_MAC=<MAC address to use when communicating in Emulated LAN>
 156         MTU=1516|1580|4544|9234|18190
 157         ZEPPELIN_DEBUG_MASK=<0 = No messages, ffff = All messages>
 158
 159 # MPOA settings:
 160
 161         MPOA_CONTROL=<local ATM address this MPC uses for MPOA
 162                                 control connections>
 163         MPOA_DATA=<local ATM address from and to which MPOA shortcuts
 164                                 are established>
 165         MPOA_MPS=<ATM address of MPS>
 166         MPOA_MPS_MAC=<MAC address of default router where MPS recides>
 167
 168 elif    DEVICE=atm* ; then      /* ATM CLIP */
 169
 170 # SVC specific options
 171
 172         ARPSRV_ATMADDR=<ATM address of ATMARP server; omit if local>
 173         ATMARP_SERVER=yes|no    (is this host an ATM ARP server?)
 174
 175 # PVC specific options
 176
 177         ATMARP_REMIP=<remote ip4 address, must be specified>
 178         ATMARP_PVC=<[itf.]vpi.vci>
 179         ATMARP_NULL=yes|no      (use NULL encapsulation, PVC only)
 180
 181 # General options
 182
 183         ATMARP_DEFAULT_QOS=<see qos(7)>         # "ubr:max_pcr=700kbps"
 184         ATMARP_DEFAULT_SNDBUF=<default send buffer size in bytes>
 185         ATMARP_QOS=<see qos(7)>                 # "ubr:max_pcr=100kbps"
 186         ATMARP_SNDBUF=<send buffer size in bytes>
 187         ATMARP_TEMP=yes|no      (do not mark the entry as permanent)
 188         ATMARP_PUB=yes|no       (publishes the entry, for ATMARP server only)
 189 fi