Skip to main content

ethercfg

The ethercfg command is used to view, manually control, and save the Ethernet configuration parameters.

When a Makito X Series device boots up, it automatically initializes and configures the Ethernet interface to match the settings on the Ethernet switch to which it is connecting. However, you may need to manually force settings such as the Ethernet interface line rate and duplex mode.

  • You can change the Ethernet interface line rate while autonegotiation is enabled.
  • However, in order to change the duplex mode, you must disable autonegotiation.

If no options are specified, the system displays the current settings, as shown in the following example.

ethercfg
Speed : 1000mbps
Duplex : Full
Auto-Negotiation : On
Advertised Mode : All
Link Detected : Yes
Ceiling : 100000kbps

Synopsis

ethercfg [-a on|off] [-s 10|100|1000] [-d half|full] [-c bandwidth] [-w yes|no]

Options

OptionDescription/Values
-a
--autoneg
Enables (on) or disables (off) autonegotiation.
-s
--speed

If autonegotiation is disabled, sets the speed: 10, 100, 1000.

If autonegotiation is enabled, this is the advertised supported speed which will be available for the peer Ethernet switch to use.

-d
--duplex

If autonegotiation is disabled, sets the duplex mode: half, full.

If autonegotiation is enabled, this will be the advertised duplex mode.

-c
--ceiling
Puts a "ceiling" (in kbps or Mbps) on the bandwidth available to the Ethernet port.
-w
--write
If yes, skips the save settings prompt.

Note

When the entire set of parameters is not specified, the system will try to combine the current Ethernet settings with the newly supplied ones. Therefore, you should carefully review the outputted configuration when the command completes to make sure it matches the desired Ethernet settings.

Always enable autonegotiation with Gigabit Ethernet (GigE) speed (1000 Mbps).

Parameter

N/A

Actions

N/A

Example

# ethercfg -s 100

Sets the line speed to 100 Mbps (which also modifies the advertised mode, see example below).

# ethercfg -s 100
Speed : 100mbps
Duplex : Full
Auto-Negotiation : On
Advertised Mode : 100mbps Full-Duplex
Link Detected : Yes
Ceiling : 100000kbps
Do you wish to save these settings ? (y,n): y
Settings saved successfully.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.