ZyXEL Communications VMG1312 User manual

1
ZyXEL Confidential
www.zyxel.com
ZyXEL VMG1312 Broadband Router
CLI Reference Manual
Version 1.0
04/22/2013

2
ZyXEL Confidential
www.zyxel.com
Table of Contents
Overview.......................................................................................................... 3
Control Key Support................................................................................... 4
1. ADSL............................................................................................................... 5
2. ARP ............................................................................................................... 18
3. BRCTL........................................................................................................... 19
4. CAT ............................................................................................................... 21
5. DEFAULTGATEWAY ...................................................................................... 22
6. DF ................................................................................................................. 23
7. DHCPSERVER................................................................................................ 24
8. DUMPCFG ..................................................................................................... 26
9. ECHO ............................................................................................................ 26
10. EXITONIDLE ................................................................................................. 27
11. HELP ............................................................................................................. 28
12. IFCONFIG...................................................................................................... 28
13. KILL.............................................................................................................. 31
14. LAN............................................................................................................... 32
15. LOGLEVEL.................................................................................................... 34
16. LOGOUT........................................................................................................ 35
17. MEMINFO...................................................................................................... 36
18. PASSWD ........................................................................................................ 37
19. PING.............................................................................................................. 37
20. PPP................................................................................................................ 38
21. PS.................................................................................................................. 39
22. PSP................................................................................................................ 40
23. PWD .............................................................................................................. 41
24. REBOOT........................................................................................................ 41
25. RESTOREDEFAULT ....................................................................................... 42
26. ROUTE .......................................................................................................... 42
27. SAVE ............................................................................................................. 44
28. SNTP ............................................................................................................. 44
29. SWVERSION.................................................................................................. 45
30. SYSINFO ....................................................................................................... 46
31. TFTP.............................................................................................................. 47
32. WAN.............................................................................................................. 48
33. EXIT.............................................................................................................. 56
34. QUIT.............................................................................................................. 57
35. SYSLOG ........................................................................................................ 57

3
ZyXEL Confidential
www.zyxel.com
36. DUMPMDM ................................................................................................... 58
37. DUMPSYSINFO.............................................................................................. 59
38. UPTIME......................................................................................................... 59
39. SAVE_DEFAULT ............................................................................................ 60
40. CELLD........................................................................................................... 61
41. XDSLCLI ....................................................................................................... 62
42. LOGDEST ...................................................................................................... 68
43. DNS............................................................................................................... 69
44. VIRTUALSERVER.......................................................................................... 70
45. WLCTL.......................................................................................................... 71
46. DHCPCONDSERV .........................................................................................112
47. IGMPCMD ....................................................................................................113
48. LANHOSTS...................................................................................................114
49. WLAN...........................................................................................................114
50. UDPECHOD..................................................................................................115
51. XTM .............................................................................................................116
52. TR69C...........................................................................................................118
53. WEBSTYLE ..................................................................................................118
54. RADVDCONF ...............................................................................................119
55. VCAUTOHUNT............................................................................................ 120
56. TR064 .......................................................................................................... 121
57. SYS.............................................................................................................. 121
Overview
The CLI is available from the serial console, telnet login, and ssh logins. It is enabled via the make
menuconfig option “Enable Command Line Interface” in the “Management Protocols and User Interface

4
ZyXEL Confidential
www.zyxel.com
Selection” section. The CLI is part of the Configuration Management System (CMS), so CMS must also be
enabled make menuconfig in order to have the CLI.
The CLI has a “>” prompt character. If you type “sh”, you will enter the busybox shell, which has the “#”
prompt character. This document describes the commands available from the CLI (“>”), not the busybox
shell.
To see a list of available CLI commands, type “help”. Many of the newer, updated commands support a
help message. To see the help message for a command, type the command name and then -h or --help.
In order to use commands which modify the configuration, you must be logged into the CLI as either
“Admin” or “Support”.
The following is a list of commands that are available, but are not listed by typing “help”. These are
refered to as hidden commands.
dumpmem
ebtables
iptables
logread
setmem
sh
Only the Admin and Support users are allowed to use the hidden commands.
Similar to the WebUI, all commands take effect immediately (without requiring reboot). In accordance to
the CMS architecture, all commands which modify the configuration will modify the MDM (shared
memory configuration database). Most commands will automatically save the changes to the configuration
file. If the command does not save the changes to the configuration file, the user must use the “save”
command to save the changes. The table below summarizes the CLI commands.
Control Key Support
1. Command history scrolling (maximum 15 commands in history):
UP: UP arrow key, or CTL+p
DOWN: DOWN arrow key, or CTL+n
2. Move cursor:
a. LEFT: LEFT arrow key, or CTL-b
b. RIGHT: RIGHT arrow key, or CTL-f
c. Beginning of line: CTL+a
d. End of line: CTL+e
3. Clear screen: CTL+l (lowercase letter of L)

5
ZyXEL Confidential
www.zyxel.com
4. Clear to the beginning of line: CTL+u
5. Clear to the end of line: CTL+k
6. Delete: DEL key, or CTL+h
7. Terminate CTL-c (can ‘t terminate certain running application such as ping)
The rest of the document describes each command in detail. Examples are also provided.
ADSL
NAME
adsl –allow a user to control the Broadcom BCM63xx ADSL driver
SYNOPSIS
adsl start [options]
adsl stop
adsl connection [options]
adsl configure [options]
adsl bert [options]
adsl info [options]
adsl afelb [options]
adsl qlnmntr [options]
adsl inm [options]
adsl diag [options]
adsl snrclamp [options]
adsl info [options]
adsl nlnm [options]
adsl --version
adsl –help
DESCRIPTION
Adsl is used to control the Broadcom BCM63xx ADSL driver. This utility can:
° start and stop the driver
° activate, deactivate and control ADSL connection
° configure ADSL driver and connection parameters
° start, stop and monitor Bit Error Rate Test (BERT)
° display status and information of ADSL driver and connection
° display statistics for ADSL driver and connection
All information is displayed to stdout. A program or shell script that calls this utility can redirect stdout

6
ZyXEL Confidential
www.zyxel.com
COMMANDS
start:
Starts the Broadcom ADSL driver. This command calls BcmAdsl_Initialize to initialize the driver and
BcmAdsl_ConnectionStart to start ADSL PHY connection if [--up] is specified. This command takes
parameters that can specify various connection modes. These parameters are the same as in “configure”
command.
stop:
Stops ADSL connection and Broadcom ADSL driver. This command calls BcmAdsl_Uninitialize.
configure :
Configures ADSL connection parameters. These command takes the same parameters as “start”
command except for [--up] . This command will cause ADSL PHY to retrain.
connection :
Controls ADSL connection modes, such as up and down and several special test modes. This
command can also be used to specify tone selection for upstream and downstream..
bert :
Controls ADSL bit error rate test (BERT). This command can start/stop
the BERT test and monitor its results.
afelb :
Starts, sets control parameters such as test time, signal type for AFE loopback test.
qlnmntr :
Starts, sets control parameters such as total monitor time,reporting frequency for QLN monitoring test
mode.
inm :
To configure inm parameters and Start inm, Stop monitoring, and show inm results
info :
Display information about ADSL driver and PHY status.
diag :
Log statuses locally. It is useful when DslDiags is not available
snrclamp :
Command to configure shape of snrclamping mask.
info :
About the adsl link information.
nlnm :

7
ZyXEL Confidential
www.zyxel.com
To show the “NonLinearityFlag”,“NumberOfAffectedBins”and “Echo-to-Noise Ratio (ENR)”.
--version:
Show current version.
--help:
Show the adsl support commands.
OPTIONS
Options for the start and configure commands :
adsl start [--up] [--mod <a|d|l|t|2|p|e|m|v>] [--lpair <(i)nner|(o)uter>]
[--trellis <on|off>] [--snr <snrQ4>] [--bitswap <on|off>][--sesdrop <on|off>][--sra
<on|off>][--CoMinMgn<on|off>][--i24k<on|off>][--phyReXmt <0xBitMap-UsDs>][--TpsTc
<0xBitMap-AvPvAaPa>][--profile <0x00 –0x7F> | <”8a |8b |8c |8d |12a |12b |17a |30a”>] [--us0
<on|off>][--forceJ43 <on|off>][--toggleJ43B43 <on|off>]
or for AnnexC:
[--bm <(D)BM|(F)BM>] [--ccw]
adsl configure [--mod <a|d|l|t|2|p|e|m>] [--lpair <(i)nner|(o)uter>]
[--trellis <on|off>] [--snr <snrQ4>] [--bitswap <on|off>]
or for AnnexC:
[--bm <(D)BM|(F)BM>] [--ccw]
--up :
Will call BcmAdsl_ConnectionStart to start ADSL PHY connection
--mod <a|d|l|t|2|p|e|m|v> :
a –all modulations allowed.
d –G.DMT enabled
l –G.Lite enabled
t –T1.413 enabled
2 –ADSL2 (G.992.3) enabled
p –ADSL2+ (G.992.5) enabled
e –Reach extended ADSL (AnnexL) enabled
m –Double upstream (Annex M) enabled
v –VDSL2 enabled
More than one mode letter can be given to enable several modes.
--lpair <(i)nner|(o)uter>:
(i)nner –inner loop pair is used
(o)uter –outer loop pair is used
--trellis <on|off> :
Enabled or disables trellis coding

8
ZyXEL Confidential
www.zyxel.com
--snr <snrQ4> :
Specify SNR margin as Q4 number
--bitswap <on|off> :
Enables or disables ADSL bitswap
--sesdrop <on|off>:
Enables or disables SESdrop
--sra <on|off> :
Enables or disables SRA
--CoMinMgn <on|off> :
Enables or disables Co Minimum Margin Drop
--i24k <on|off> :
Enables or disables i24k
[--phyReXmt <0xBitMap-UsDs>] :
Enables or disables phy Re-transmit feature in US and DS
--TpsTc <0xBitMap-AvPvAaPa> :
Enable or disable ATM and PTM modes in VDSL (AvPv) and Adsl (AaPa)
--profile <0x00 –0x7F> | <”8a |8b |8c |8d |12a |12b |17a 30a”> :
VDSL profile selection. More than one profile to enable several profiles
[--us0 <on|off>] :
Enable/disable UpStream0 in VDSL2 mode
--forceJ43 <on|off> :
Enable or disable forceJ43
--toggleJ43B43 <on|off> :
Enable or disable toggleJ43B43
The following options apply to AnnexC only
--bm <(D)BM|(F)BM> :
(D)BM - DBM mode
(F)BM - FBM mode
--ccw :
Enables special CRC workaround for Centillium modems

9
ZyXEL Confidential
www.zyxel.com
Options for the stop command
adsl stop :
Options for the connection command
adsl connection [--up] [--down] [--loopback] [--reverb]
[--medley] [--noretrain] [--L3][--diagMode][--Lo]
[--tones <xmtStart xmtNum xmtMap rcvStart rcvNum rcvMap>]
[--normal][--freezeReverb][--freezeMedley]
--up :
Starts ADSL connection in normal mode
--down :
Puts ADSL PHY in idle mode
--loopback :
Puts ADSL PHY in ATM cell loopback mode. In this modem ADSL PHY will not try to establish
connection .
--reverb :
Puts ADSL PHY in test mode in which it only sends REVERB signal
--medley :
Puts ADSL PHY in test mode in which it only sends MEDLEY signal
--noretrain :
In this mode ADSL PHY will be trying to establish connection as in normal mode, but once the
connection is up it will not retrain even if the signal is lost.
--L3 :
Puts ADSL modem in L3 power state
--diagmode :
Puts modem in diagnostic test mode
--L0 :
Puts modem in L0 mode
--tones :
Specifies tones which can be used by ADSL PHY.
Tone ranges should be given separated by commas. For example, to select tones 0 to 100 and 200 to
300 use:
--tones 0-100,200-300 :

10
ZyXEL Confidential
www.zyxel.com
Tone configuration command does not cause ADSL PHY retrain automatically. To experience the
effect of this command ADSL connection must be restarted using for example adsl connection –down
followed by adsl connection –up command.
Tone selection is not affected by adsl configure commands and has to be changed explicitly.
--normal :
Puts modem in Normal mode
--freezeReverb :
Puts modem in freeze reverb mode
--freezeMedley :
Puts modem in freeze medley mode
Options for the bert command
adsl bert [--start <seconds>] [--stop] [--show]
--start :
Starts Bit Error Rate Test (BERT)
seconds –duration of BERT test in seconds
--stop :
Stops the BERT test.
--show :
Display BERT results to stdout in the following format:
BERT Status = [NOT] RUNNING
BERT Total Time = 10 sec
BERT Elapsed Time = 10 sec
BERT Bits Tested = 0x00000000045A6380 bits
BERT Err Bits = 0x0000000000000002 bits
BERT Status indicates whether or not the BERT test is currently running. It can be used to monitor when
the BERT test is complete after it is started. The numbers of total bit tested and errorred bits are displayed
as 64 bit hexadecimal numbers.
Options for the info command
adsl info [--state] [--show] [--stats] [--SNR] [--QLN] [--Hlog] [--Hlin] [--HlinS]
[--Bits][--pbParams][--linediag][--linediag1][--reset][--vendor][--cfg]
--state :
Displays the shortest message about ADSL PHY connection state, e.g.
adsl: ADSL driver and PHY status
Status: Showtime Channel: FAST, Upstream rate = 8064 Kbps, Downstream rate = 1024 Kbps

11
ZyXEL Confidential
www.zyxel.com
--show :
Displays more statistics about ADSL connection.
--stats :
Displays all available statistics about ADSL connection.
--SNR :
Displays signal to noise ratio (SNR) per tone in dB
--QLN :
Displays Quiet Line Noise (QLN) per tone in dBm/Hz
--Hlog :
Displays Hlog (Channel Response) per tone in dB
--Hlin :
Displays Hlin (Channel Respose linear)
--HlinS :
Displays Hlin Scaled and corresponding Scaling Factors
--Bits :
Display Bit Allocation per tone
--pbParams :
Displays Per Band Parameters in VDSL2 mode. This includes Band plan information, Net Data rate,
TxPwr, per band LATN, SATN, SNRM.
--linediag :
Used in ADSL mode. Displays Line Diagnostic Results for ADSL mode including aggregate PMD
parameters such as SNRM, LATN, SATN, TxPwr, ATTNDR and per tone SNR, QLN, Hlog, HlinS
Example:
> adsl info --linediag
adsl: ADSL driver and PHY status
Status: G.992 Started
Retrain Reason: 0 Down Up
SNRM(dB): 0.0 0.0
LATN(dB): 0.0 0.0
SATN(dB): 0.0 0.0
TxPwr(dBm): 0.0 13.0
ATTNDR(Kbps): 0 0

12
ZyXEL Confidential
www.zyxel.com
Tone number SNR
0 -180.0000
1 -180.0000
2 -180.0000
. . .
Tone number QLN
0 -90.0000
1 -142.0000
2 -143.0000
3 -144.0000
. . .
Tone number Hlog
0 0.0000
1 0.0000
2 0.0000
3 0.0000
. . .
Hlin scale factor: DS = 0 US = 0
Tone number Hlin
0 0 0
1 0 0
2 0 0
. . .
--linediag1 :
Used in VDSL2 mode. Displays Line Diagnostic Results for VDSL2 mode. Displayed items include
Net Data Rate, Tx Power, Per Band PMD parameters and per-tone Hlog,QLN,SNR,HlinS
Example:
> adsl info --linediag1
adsl: ADSL driver and PHY status
Status: Showtime
Retrain Reason: 0
Max: Upstream rate = 50971 Kbps, Downstream rate = 118860 Kbps
Path: 0, Upstream rate = 20011 Kbps, Downstream rate = 79895 Kbps
VDSL Port Details Upstream Downstream
Attainable Net Data Rate: 50971 kbps 118860 kbps
Actual Aggregate Tx Power: 13.4 dBm 14.4 dBm
=============================================================
VDSL Band Status U0 U1 U2 U3 D1 D2 D3
Line Attenuation: N/A 17.2dB 29.0dB N/A 7.7dB 19.1dB 32.2dB
Signal Attenuation: N/A 16.9dB 29.8dB N/A 7.7dB 19.1dB 32.2dB
SNR Margin: N/A 27.2dB 27.3dB N/A 15.4dB 14.4dB 15.1dB

13
ZyXEL Confidential
www.zyxel.com
Line 0 DS HLOG (dB) (grouped by 8 tones):
0 : -96.0 -96.0 -96.0 -96.0 -96.0 -8.4 -7.1 -6.1 -5.5 -5.2
10 : -4.9 -4.8 -4.6 -4.5 -4.5 -4.4 -4.4 -4.5 -4.6 -4.7
. . .
Line 0 US HLOG (dB) (grouped by 8 tones):
0 : -96.0 -96.0 -96.0 -96.0 -96.0 -96.0 -96.0 -96.0 -96.0 -96.0
. . .
Line 0 DS QLN (dBm/Hz) (grouped by 8 tones):
0 : -160.0 -160.0 -160.0 -160.0 -160.0 -121.5 -119.5 -119.0 -118.0 -119.0
. . .
Line 0 US QLN (dBm/Hz) (grouped by 8 tones):
0 : -160.0 -160.0 -160.0 -160.0 -160.0 . . .
Line 0 DS SNR (dBm/Hz) (grouped by 8 tones):
0 : 0.0 0.0 0.0 0.0 0.0 53.4 54.4 56.2 56.7 . . .
Line 0 US SNR (dBm/Hz) (grouped by 8 tones):
0 : 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 0.0 . . .
--reset :
Clears all statistic counters in ADSL driver
--vendor :
Display Chipset Vendor Details
--cfg :
Display AdslCfgProfile values in MIB
Options for the afelb command
adsl afelb [--time] [--tones] [--signal]
--time :
Sets the time in seconds the test would take to return the result.
--tones :
Optional parameter - Sets the test tone range
Example -–tones 0-20,25-30
--signal :
Sets the test signal to be used
1 Reverb
2 Medley
8 High Crest factor Signal
Result will be available in SNR Mib info and seen using
adsl info –SNR
Options for the qlnmntr command

14
ZyXEL Confidential
www.zyxel.com
adsl qlnmntr [--time] [--freq]
--time :
Sets the time in seconds for which QLN monitoring is to be done. If set to 0 , monitoring will be done
for ever.
--freq :
Sets the frequency in milli-seconds of QLN reporting.
At the end of monitoring time , the result is available in the QLN MIB info and can be seen using
adsl info --QLN :
Also, during the monitoring period the updated results is being updated in MIB and can be seen
every “--freq” milli-seconds.
Guidelines and description for inm command
adsl inm [--start <BB_THRESH 10*dB> <INMIATO> <INMIATS>] [--stop] [--show]
Starting INM
adsl inm --start <BB_THRESH 10*dB> <INMIATO> <INMIATS> :
Broadband Threshold value expressed as 10*dB (range [-361 to 120]), inter-arrival time offset
INMIATO (range [3-511]) and inter-arrival time step in log2 format INMIATS (range [0-7]) are the
required parameters to be specified in start command
Stopping impulse noise monitoring
adsl inm --stop :
Displaying INM configuration and results
adsl inm –show :
This will print inm state (Active/Not) , mode, configuration and results in the following format. The
actual Inter Arrival Time Step in IAT histogram is displayed as INMIATS
INM State:ACTIVE BB_THLD=-10.0dB INM_INPEQ_MODE=0 INMCC=0 INMAITO=2
INMIATS=16
INMAME (BB Counter)= 8777
INPEQ1: 0
INPEQ2: 0
INPEQ3: 0
. . .
. . .
INPEQ17: 0
Inter Arrival Histogram:
[2-2]: 0
[3-18]: 0
. . .

15
ZyXEL Confidential
www.zyxel.com
. . .
[99-INF]: 0
Guidelines and description for diag command
adsl diag [--logstart < nBytes to store statuses > ] [--logpause ] [--logstop] [--loguntilbufferfull]
[--loguntilretrain]
adsl --logstart :
Start logging statues locally and will wrap around when the buffer is full
adsl --logpause :
Pause logging
adsl --logstop :
Stop logging session.
adsl --loguntilbufferfull :
Log statuses until the buffer is full
adsl --loguntilretrain :
Log until the modem retrain
To retrieve the logged statuses, connect DslDiags and issue “dbgcmd=25 4”
Guidelines and description for snrclamp command
adsl snrclamp [--shape <shapeId>] [--bpshape [bpIndex-bpLevel,]
--shape :
Set one of the pre-defined shapes shapeIds in [0,1,2]
--bpshape :
Set shape as defined by the bpIndex-bpLevel pairs
Example
>adsl snrclamp --bpshape 1-1,128-32,512-128
EXIT CODES
Exit codes less than 100 are assigned by the ADSL driver. Exit codes of 100 or greater are assigned by the
adsl utility.
BCMADSL_STATUS_SUCCESS 0
BCMADSL_STATUS_ERROR 1
ADSL_GENERAL_ERROR 100
ADSL_ALLOC_ERROR 101
ADSL_INVALID_COMMAND 102
ADSL_INVALID_OPTION 103
ADSL_INVALID_PARAMETER 104
ADSL_INVALID_NUMBER_OF_OPTIONS 105

16
ZyXEL Confidential
www.zyxel.com
ADSL_INVALID_NUMBER_OF_PARAMETERS 106
EXAMPLES
° A simple initialization.
> adsl start [--up]
or
> adsl start
> adsl connection --up
° A more complex initialization.
> adsl start --up --mod d l--lpair I
or
> adsl start
> adsl connection --up --mod dl --lpair I
° Getting in and out of the test modes
> adsl connection –-reverb
…
> adsl connection --up
° Selecting tones
> adsl connection --tones 0 32 0xFEFFFF7F 32 224 0xFEFFFFFFFFFFFF7F
selects tones from 1 to 31 for upstream and from 33 to 95 for downstream
° Starting and monitoring BERT
> adsl bert –start 60
to run BERT test for 60 seconds. After about 20 seconds of BERT running the results will look like:
> adsl bert –show
adsl: BERT results:
BERT Status = RUNNING
BERT Total Time = 60 sec
BERT Elapsed Time = 20 sec
BERT Bits Tested = 0x0000000008B4C700 bits
BERT Err Bits = 0x0000000000000067 bits
After 60 seconds when the BERT has completed the results of –show command will be:
> adsl bert –show
adsl: BERT results:
BERT Status = NOT RUNNING

17
ZyXEL Confidential
www.zyxel.com
BERT Total Time = 60 sec
BERT Elapsed Time = 60 sec
BERT Bits Tested = 0x000000001A1E5500 bits
BERT Err Bits = 0x0000000000000067 bits
° Display minimal ADSL state.
> adsl info –-state
adsl: ADSL driver and PHY status
Status: Showtime Channel: FAST, Upstream rate = 8064 Kbps, Downstream rate = 1024 Kbps
° Display complete ADSL driver and PHY status.
> adsl info –-show
adsl: ADSL driver and PHY status
Status: Showtime Channel: FAST, Upstream rate = 8064 Kbps, Downstream rate = 1024 Kbps
Mode: G.DMT
Channel: Fast
Trellis: ON
Line Status: No Defect
Training Status: Showtime
Down Up
SNR (dB): 16.1 7.0
Attn(dB): 0.0 5.5
Pwr(dBm): 6.5 7.8
Max(Kbps): 11040 1088
Rate (Kbps): 0 0
K: 0(0) 0
R: 0 0
S: 1 1
D: 1 1
SF: 25288 25286
SFErr: 1 0
RS: 0 0
RSCorr: 0 0
RSUnCorr: 0 0
HEC: 1 0
OCD: 0 0
LCD: 0 0
ES: 1 0
Guidelines and description for nlnm command
adsl nlnm [--show ] [--setThld <Thld_Num_Tones>]

18
ZyXEL Confidential
www.zyxel.com
--show :
To show the “NonLinearityFlag”,“NumberOfAffectedBins” and “Echo-to-Noise Ratio (ENR)”.
--setThld :
To setting “NumberOfAffectedBins”
Guidelines and description for --version command
adsl --version
Show current version.
Guidelines and description for --help command
adsl --help
Show the adsl support commands.
EXAMPLES
> adsl nlnm –show
NonLinearityFlag 0
NumberOfAffectedBins -1
ThresholdNumberOfBins 60
Echo-to-Noise Ratio (ENR) 0
ARP
NAME
arp –manipulate modem‟s ARP (Address Resolution Protocol) table
SYNOPSIS
arp add <IP address> <MAC address>
arp delete <IP address>
arp show
arp --help
DESCRIPTION
Arp is used to manipulate modem‟s ARP table. Note that ARP entries added by this command are not
saved in the flash memory by the save command. After system reboot, ARP entries need to be re-added.
EXAMPLES
° Add a static ARP entry for IP address 192.168.1.2 with MAC address 00:11:22:33:44:55.
> arp add 192.168.1.2 00:11:22:33:44:55

19
ZyXEL Confidential
www.zyxel.com
° Show ARP table.
> arp show
IP address HW type Flags HW address Mask Device
192.168.1.3 0x1 0x2 00:01:03:E3:4F:F9 * br0
192.168.1.2 0x1 0x6 00:11:22:33:44:55 * br0
° Delete ARP entry for IP address 192.168.1.2.
> arp delete 192.168.1.2
BRCTL
NAME
brctl –bridge administration utility
SYNOPSIS
brctl [ command ]
DESCRIPTION
brctl is used to set up, maintain, and inspect the bridge configuration.
A bridge is a device commonly used to connect different networks (Ethernet, USB, 802.11x wireless
network or ATM) together, so that these networks will appear as one network to the participants.
Each of the networks being connected corresponds to one physical interface (port) in the bridge. These
individual networks are bundled into one bigger ('logical') network, this bigger network corresponds to the
bridge network interface such as “br0”.
COMMANDS
addbr <bridge>
Creates a new instance of the bridge. The network interface corresponding to the bridge will be called
<bridge>.
delbr <bridge>
Deletes the instance <bridge> of the bridge. The network interface corresponding to the bridge must
be down before it can be deleted.
show <bridge>
Shows the instance <bridge> of the bridge.
show
Shows all current instances of the bridge.
addif <bridge> <device>

20
ZyXEL Confidential
www.zyxel.com
Makes the interface <device> a port of the bridge <bridge>. This
means that all frames received on <device> will be processed as if destined for the bridge. Also, when
sending frames on <bridge>, <device> will be considered as a potential output interface.
delif <bridge> <device>
Detaches the interface <device> from the bridge <bridge>.
showmacs <bridge>
Shows a list of learned MAC addresses for this bridge.
showstp <bridge>
Shows the STP (Spanning Tree Protocol) status of this bridge.
setageing <bridge> <time>
Sets the MAC address ageing time, in seconds. After <time> seconds of not having seen a frame
coming from a certain address, the bridge will time out (delete) that address from the Forwarding
DataBase (fdb).
setbridgeprio <bridge> <priority>
Sets the bridge's priority to <priority>. The priority value is an unsigned 16-bit quantity (a number
between 0 and 65535), and has no dimension. Lower priority values are 'better'. The bridge with the
lowest priority will be elected 'root bridge'.
setfd <bridge> <time>
Sets the bridge's 'bridge forward delay' to <time> seconds.
setgcint <bridge> <time>
Sets the garbage collectioninterval for the bridge <bridge> to <time> seconds. This means that the
bridge will check the forwarding database for timed out entries every <time> seconds.
sethello <bridge> <time>
Sets the bridge's 'bridge hello time' to <time> seconds.
setmaxage <bridge> <time>
Sets the bridge's 'maximum message age' to <time> seconds.
setpathcost <bridge> <port> <cost>
Sets the port cost of the port <port> to <cost>. This is a dimensionless metric.
setportprio <bridge> <port> <prio>
Sets the port <port>'s priority to <priority>. The priority value is an unsigned 8-bit quantity (a number
between 0 and 255), and has no dimension. This metric is used in the designated port and root port
selection algorithms.
setportsnooping <bridge> <port> <addr>
Adds an entry for a port <port> in the port snooping table of the bridge <bridge>. The format of the