Shell Commands/NetConfig

From MorphOS Library

< Shell Commands

NetConfig - Configures network interfaces

INTERFACE,IP=IPADDR/K,DEST=DESTINATION/K,MASK=NETMASK/K,MTU/N/K,GW=GATEWAY/K,NS=NS1=NAMESERVER1/K,NS2=NAMESERVER2/K, NS3=NAMESERVER3/K,DHCPS=DHCPSERVER=BPS=BOOTPSERVER/K,DHCPSCAN/S,HOSTNAME/K,NOGW=NOGATEWAY/S,LOOPBACK/S,BOOTP/S, DHCP/S,NOONLINE/S,NOHWADDR/S,AUTOCONFIG/S,DIALSCRIPT/K,PROVIDERFILE/K,FORCEPRIMARY/S,NODIAL/S,DEBUG/S

INTERFACE           - The name of the interface to configure.
AUTOCONFIG          - The system preferences are used to configure
                      all interfaces automaticly. The file <env:sys/interfaces>
                      is used to describe the interfaces and the file <env:sys/netconfig>
                      is used to pass extra netconfig config arguments.
IPADDR              - The IP address of the interface. This
                      should be given only if the IP address
                      is known and is not dynamic.
DESTINATION         - The destination IP address for the point
                      to point interfaces and the broadcast
                      address for the broadcast interfaces.
                      This is generally needed for point to
                      point interfaces.  The gateway address
                      will be used as the destination address
                      if the destination IP address is not
                      availabe.  For broadcast interfaces this
                      option is generally not needed at all.
NETMASK             - The netmask of the interface. If not
                      supplied, a suitable default is
                      calculated by NetStack.
GATEWAY             - The IP address of the default gateway.
                      This should not be given if no specific
                      default gateway is assigned. On point to
                      point links the destination IP address
                      will be used as the gateway address as
                      well, if no specific gateway address is
                      given.
MTU                 - The mtu of the interface. If not
                      supplied, a suitable default is
                      calculated by NetStack
NAMESERVER1         - The IP address of the first nameserver.
NAMESERVER2         - The IP address of the 2nd nameserver.
NAMESERVER3         - The IP address of the 3rd nameserver.
DHCPSERVER          - The IP address of the BOOTP/DHCP server to
                      use. Normally this is not needed and a
                      default broadcast address will be used
                      instead.
DHCPSCAN            - Scan and output all found dhcp servers
HOSTNAME            - The name of your systen.
NOGATEWAY           - Specifies that no default gateway should
                      be configured.
LOOPBACK            - Specifies that the loopback interface
                      ("lo0") should be configured as well.
BOOTP               - Use BOOTP to get the configuration
                      information. If your network has a BOOTP
                      server, you normally do not need any
                      other options to configure your
                      interface.
DHCP                - Use DHCP to get the configuration
                      information. If your network has a DHCP
                      server, you normally do not need any
                      other options to configure your
                      interface.
NOONLINE            - Do not put the Sana2 device online.
                      Normally netconfig puts the Sana2
                      device configured for interface-name
                      online. This option causes the online
                      command not to be sent.
NOHWADDR            - Do not use hardware address on the BOOTP
                      request. Normally this is not needed,
                      since netconfig can disable hardware
                      address usage automatically for
                      appropriate interface types.
DEBUG               - Turns on debugging output. Normally
                      netconfig produces very little output,
                      but this option causes all relevant
                      information to be printed out.
DIALSCRIPT          - Not documented.
PROVIDERFILE        - Not documented.
FORCEPRIMARY        - Not documented.
NODIAL              - Not documented.

NetConfig is launched at boot time from system's startup scripts and users aren't adviced to use it separately.

See also: IfConfig, Route