Reference Manual

NAME

netcfg - display a network configuration dialog box

netcfg ifn

Command netcfg displays a network configuration dialog box for a specified NAT32 network adapter.

Sample 1 Sample 2

Argument ifn is a value in the range 1..16.

The dialog box writes its contents to the appropriate netcfg file when the OK button is clicked. The netcfg files have the following format:

Ethernet Adapter ID   = \Device\NDISWANIP
IP Addr               = 0.0.0.0
Main Internet Ifn     = true
Main Private  Ifn     = false
Simplex Interface     = false
Mask                  = 0.0.0.0
Gateway               = 0.0.0.0
Name Server           = auto
Filter Address        = 0.0.0.0
Mode                  = Normal
MTU                   = 1400
Monitor               = true
Server                = 0
Enable Dialing        = true
Autodial Connection   = OfficeVPN
Source Addr           = 0.0.0.0
Source Mask           = 255.255.255.255
Speed                 = auto

Ethernet Adapter ID is the NDIS3 Adapter Name and is a four-digit number under Windows 95/98 or a string such as \DEVICE\RTL81391 under Windows NT (the string denotes the first instance of the RTL8139 device). It is a GUID string under Windows 2000 and higher.

IP Addr is the address which NAT32 is to use for this adapter. This address must be on the same network as the Windows TCP/IP stack for this adapter. If the Windows TCP/IP stack for the adapter is DHCP-configured, or if it is a Dial-Up Networking adapter, IP Addr and Mask will each be 0.0.0.0.

Main Internet Ifn (when true) indicates that this is the default interface for Internet communications. Its IP address is used as the target for address and port mappings. DNS requests are also sent via this interface.

Main Private Ifn (when true) indicates that this is the default private interface. The network portion of the IP address of this interface determines which packets should be mapped. Note that if you have more than one private network attached to NAT32, the use of Class B private addresses like 172.16.x.y will ensure that traffic from all private networks is mapped.

Simplex Interface (when true) indicates that the interface can receive packets but not send them. Simplex interfaces are sometimes used with Satellite connections and one-way Cable Modems.

Mask is the subnet mask which NAT32 is to use for this adapter. It will usually be 255.255.255.0.

Gateway is the IP address of a gateway on the attached network. There is usually only a gateway on Internet-connected interfaces, but if NAT32 is to be able to reach additional networks behind a gateway on a private network, that gateway address can be specified here.

Name Server is the IP address of a Domain Name Server anywhere on the Internet. If auto is specified, the value is obtained from the Windows Registry or via a DNS detection mechanism.

Filter Address is always 0.0.0.0 if NAT32 is sharing an IP address with Windows. Otherwise, it is the address used by the Windows TCP/IP stack on this adapter.

Mode is Normal for Ethernet, Token Ring and Dial-Up adapters, but can be set to PPPoE if an RFC2516 compliant protocol stack is in use on the adapter.

MTU is normally 1500 for Ethernet and PPP adapters, 1492 for PPPoE adapters and 1400 for VPN connections. If a value of 0 is specified, NAT32 will use the MTU reported by Windows for this adapter.

Monitor is normally true for all adapters which have an IP address which Windows may change at run-time. NAT32 will automatically detect such changes and update its configuration details accordingly.

Server is set to 1 only if the adapter is a Dial-Up Networking Server.

Enable Dialing is set to true if the adapter is a Dial-Up Networking Client and connections are to be dialed via this adapter.

Autodial Connection should be specified for Dial-Up Networking Client adapters if Enable Dialing is true. It is the name of the Dial-Up Networking connection which is to be dialed via this adapter.

Source Addr is the IP address of a private computer or subnet. Only that computer or only computers on that subnet will be allowed to communicate with the Internet via this adapter.

Source Mask is used to generate a subnet address from the above IP address. If the mask is 255.255.255.255, then the above address is a host address and no subnet address will be calculated.

Speed can be used to override the speed reported by Windows. This is useful in cases where a DSL Modem is attached to the computer via an Ethernet Adapter and Windows reports its speed as 100 Mbps, even though the DSL service is actually much slower.

Command netcfg cannot be used to add Network Interfaces while NAT32 is running.

The number of Network Interfaces to be used should be specified when NAT32 is invoked.

For LAN adapters which are not Windows DHCP-configured, if IP Addr is specified as 0.0.0.0 for that adapter, NAT32 will use the DHCP protocol at startup in order to determine configuration details. The netcfg file for the adapter then contains no relevant address details, although a mask which is to override the DHCP-supplied value can be specified if required.

conf, ipmap, netstat, ns, reg, setns