Home

Documentation

Project Support

Changes in Version 4 of GraspSwControllerCmdIfconfig

Author:
crae
Timestamp:
Fri Jul 8 14:56:33 2011

Legend:

Unmodified
Added
Removed
Modified

  • GraspSwControllerCmdIfconfig

    v3 v4
    1 1  '''[wiki:GraspSwControllerCmd ifconfig]''' 
    2 2  [[TracNav(GraspContents)]] 
    3 3  ||Command:||'''ifconfig'''|| 
    4 4  ||Contexts:||Network socket, serial console.|| 
    5 5  ||Function:||Displays or sets the STARGRASP controller's network configuration|| 
    6 6  ||Required Parameters:||none.|| 
    7 7  ||Optional Parameters:||dynamic|| 
    8 8  ||                    ||static ipaddress netmask logaddress defaultrouter|| 
    9 9  With no parameters, this command displays the current configuration and basic stats of the STARGRASP controller's network interface. This includes the link status, MAC address, configuration (dynamic or static), IP address information and packet counts. For example: 
    10 10   {{{ 
    11 11  Link: up                                                                          
    12 12  HWaddr 00:50:C2:64:90:5A                                                          
    13 13  IP address configuration: Dynamic                                                 
    14 14  inet addr: 10.213.1.170  Mask:255.255.0.0  Router:10.213.1.1                      
    15 15  RX packets:2244219                                                                
    16 16  TX packets:323158 errors:0 
    17 17  }}} 
    18 18  Additionally, the ifconfig command can be used to choose between two methods of obtaining an IP address: ''dynamic'', which obtains an IP address and other information via DHCP; or ''static'' which assigns a specific IP address to the controller. 
    19 19  === Dynamic IP === 
    20 20  When set, the STARGRASP controller will negotiate an IP address via DHCP with a server on the network. In this mode, it takes the IP address, netmask and gateway IP assigned by the DHCP server, and will send log messages to the address specified by the configured next-server parameter (see the DHCP server's documentation for how to set this). 
    21 21  Usage: 
    22 22   {{{ 
    23 23  ifconfig dynamic 
    24 24  }}} 
    25 25  === Static IP === 
    26 26  In this mode, the STARGRASP controller uses a preconfigured IP address to communicate on the network. 
    27 27  Usage: 
    28 28   {{{ 
    29 29  ifconfig static ipaddress netmask logaddress defaultrouter 
    30 30  }}} 
    31 31  The four required parameters after the ''static'' option are as follows: 
    32 32   * '''ipaddress''' - the IP address that the system should use. 
    33 33   * '''netmask''' - the netmask for the subnet the system is on. 
    34 34   * '''logaddress''' - the IP address where the system should log to. 
    35 35   * '''defaultrouter''' - the gateway for the network the system is connected to. 
    36 36  All four parameters must be supplied in dotted-decimal format. 
    37 37  === Notes: === 
    38    When switching between dynamic and static mode, the controller must be rebooted for the change to take effect. 
      38  When switching between dynamic and static mode or setting a new static IP address, the controller must be rebooted for the change to take effect.