Reference Manual

NAME

netcfg  - display a network configuration dialog box
netcfgx - display a network configuration file
SYNOPSIS
netcfg ifn
netcfgx [ifn]

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

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

The dialog box writes its contents to the appropriate ifnx.ini file when the OK button is clicked. The configuration files contain the entries shown below.

Ethernet Adapter ID is an internal Adapter Name and is either a GUID string or a special string such as \Device\NDISWANIP.

IP Addr is the address that 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.

Aux Internet Ifn (when true) indicates that this is an auxiliary interface for Internet communications. Its IP address is used as the target for address and port mappings for traffic via this interface. Usage of the interface is governed by the settings of the interface selection command setis. The interface can also be used as a fallback interface for uninterrupted Internet connectivity. DNS requests are normally not 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 that 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.

Aux Gateway is the IP address of a second gateway on the attached network. For Internet-connected interfaces, this gateway is used according to the Gateway Selection algorithm specified with the setgs command.

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 that have an IP address that 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 that 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 adapter speed reported by Windows. This may be needed for Internet-connected interfaces where the actual Internet connection speed is usually far less than the adapter speed.

NOTES
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 that 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 ifnx.ini file for the adapter then contains no relevant address details, although a mask that is to override the DHCP-supplied value can be specified if required.

SEE ALSO
conf, ipmap, netstat, ns, reg, setns, setgs, setis, Fallback configuration