Documentation/s390/c7000.txt

   1 Cisco 7000 (CLAW) support
   2
   3 The c7000 module provides support for a channel attached Cisco 7xxx
   4 family router on Linux/390.  The parameters for the module are as follows:
   5
   6         base0=0xYYYY    This parameter defines the base unit address of the
   7                         channel attached router.
   8
   9         lhost0=s1       This parameter defines the local host name and
  10                         must match the claw directive "host-name" field
  11                         (first string).  The default value is "UTS".
  12
  13         uhost0=s2       This parameter defines the unit's name and must
  14                         match the claw directive "device-name" field
  15                         (second string).  The default value is "C7011".
  16
  17         lappl0=s3       This parameter defines the local application name
  18                         and must match the claw directive "host-app" field
  19                         (third string).  The default value is "TCPIP".
  20
  21         uappl0=s4       This parameter defines the unit application name and
  22                         must match the claw directive "device-app" field
  23                         (fourth string).  The default value is "TCPIP".
  24
  25         dbg=x           This parameter defines the message level.  Higher
  26                         numbers will result in additional diagnostic messages.
  27                         The default value is 0.
  28
  29         noauto=z        This parameter controls the automatic detection of
  30                         the unit base address (base0).  When set to a non
  31                         zero value, automatic detection of unit base addresses
  32                         is not done.  The default value is 0.
  33
  34 Note that the values coded in strings s1 - s4 are case sensitive.
  35
  36 For example, assume that the following claw directive has been coded in
  37 the Cisco router:
  38
  39 claw 0100 6C 129.212.61.101 UTS C7011 TCPIP TCPIP
  40
  41 The module can be loaded using the following command:
  42
  43 insmod c7000 base0=0x336c lhost0="UTS" uhost0="C7011" lappl0="TCPIP" \
  44 uappl0="TCPIP" dbg=0 noauto=1
  45
  46 Additional interfaces can be defined via parameters base1 - base3,
  47 lhost1 - lhost3, lappl1 - lappl3, uhost1 - uhost3, uappl1 - uappl3.
  48 The interfaces are named "ci0" - "ci3".  After loading the module, the
  49 ifconfig command is used to configure the interface.  For example:
  50
  51 ifconfig ci0 129.212.61.101
  52 ifconfig ci0 netmask 255.255.255.0 broadcast 129.212.61.0
  53 ifconfig ci0
  54
  55 The route command is used to specify the router as the default route:
  56
  57 route add default gw 129.212.61.200
  58
  59 The interface can be automatically activated at boot time by following this
  60 procedure:
  61
  62 1) Add the following two lines to file "/etc/conf.modules":
  63
  64 alias ci0 c7000
  65 options c7000 base0=0xYYYY lhost0=s1 uhost0=s2 lappl0=s3 uappl0=s4
  66
  67 2) Edit file "/etc/sysconfig/network" as follows:
  68
  69 NETWORKING=yes
  70 FORWARD_IPV4=no
  71 HOSTNAME=your-hostname
  72 GATEWAYDEV=ci0
  73 GATEWAY=your-gateway-ip-address
  74
  75 Substitute your own host name and gateway IP address.
  76
  77 3) Create a file in directory "/etc/sysconfig/network-scripts" called
  78 "ifcfg-ci0".  The contents are as follows:
  79
  80 DEVICE=ci0
  81 USERCTL=no
  82 ONBOOT=yes
  83 BOOTPROTO=none
  84 BROADCAST=your-broadcast-ip-address
  85 NETWORK=your-network-address
  86 NETMASK=your-netmask
  87 IPADDR=your-ip-address
  88
  89 Substitute your IP address, broadcast IP address, network address and
  90 network mask.
  91
  92 4) chmod +x ifcfg-ci0