Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: "port_ignore_on_rx" is removed (not available in NDIS6), typos corrected

Anchor
TopNetPage
TopNetPage

...

(warning) The EIx0_MODE variable name is case insensitive, while its values are case sensitive! This is feature of OpenVMS EIDRIVER.

The values are:

ParameterDescription
"Auto"Auto-negotiate (default)
"Twisted"10Mbps half duplex
"Full"10Mbps full duplex
"Fast"100Mbps half duplex
"FastFD" 100Mbps full duplex

...

Parameter

Type

Value

interface

Text string

This parameter identifies an Ethernet adapter of the host system dedicated to CHARON-AXP. The leading keyword "connection:" is mandatory.

Syntax:

set <name> interface="connection:<adapter>"

Example:

set NDIS interface="connection:Charon"

port_enable_mac_addr_change

Boolean

If "true" is specified (default value), CHARON-AXP sets the appropriate Ethernet address automatically.

If "false" is specified, set the Ethernet address manually.

Example:

set NDIS port_enable_mac_addr_change=false

port_ignore_on_rx

Numeric

The "port_ignore_on_rx" parameter provides the ability to shutdown the port when a specified number of sequential "on receive" errors is exceeded.

Typically, errors "on receive" indicate serious (unrecoverable) errors.

By default, the value is set to the value of the "port_pending_rx_number" parameter. A value of ‘0’ means infinite.

Example:

set NDIS

port_

ignore_on_rx=16

port_retry_on_tx

Numeric

The "port_retry_on_tx" parameter controls the number of times a port will attempt to transmit a packet before giving up.

By default, the value is 3.

Increasing this value may introduce problems in carrier loss logic, because not all NIC drivers support a carrier status query.

Typically, you do not need to increase the value.

Example:

set NDIS port_retry_on_tx=8

port_pending_rx_number

Numeric

The "port_pending_rx_number" parameter sets the number of pending receive buffers.

The default value is 63. The maximum value allowed is 195.

You may want to increase the "port_pending_rx_number" when you have very busy networking and experience problems like losing connections not related to the carrier loss.

Typically, you do not need to change this parameter.

Example:

set NDIS port_pending_rx_number=128

port_pending_rxtx_number

Numeric

The "port_pending_tx_number" parameter sets the number of buffers the port uses to transmit.

The default value is 62.

You may want to increase the "port_pending_tx_number" value if the log file indicates dropped TX packets due to TX queue overflow.

Typically, you do not need to change this parameter.

Example:

set NDIS port_pending_rxtx_number=128

suspend_msg_on_mac_change

Boolean

To avoid confusion arising from non critical errors during a MAC address change, logging is by default suppressed (default value is "true").

To enable tracing during a MAC address change set this parameter to "false"

Example:

set NDIS suspend_msg_on_mac_change=false
legacy_modeBoolean

If this parameter is set to "true" CHARON-AXP tries to use very first implementation of "packet_port" having certain restrictions such as inability to automatically change MAC address on given interface etc.

This setting may be needed if CHARON-AXP runs in VMware environment for example.

In other situations please do not change its default value ("false").

Example:

set NDIS legacy_mode=true
Info

This parameter is required only if you do not want to allow promiscuous traffic for the VMware adapter/port. In this mode, CHARON-AXP uses legacy MAC address change logic, so use of this option is not desirable.

Thus for ESXi networking configuration:

  1. Create the port with e1000 adapter;
  2. Enable the promiscuous traffic;
  3. do not use legacy_mode option in Charon's configuration file;

...