Commit a23c58a3 authored by Luis Carlos Cobo Rus's avatar Luis Carlos Cobo Rus Committed by John W. Linville

[PATCH] libertas: updated readme file

Fix some wording and blinding table command options, clarify argument list for
fwt_add and fwt_list, simplify fwt_list_route
Signed-off-by: default avatarLuis Carlos Cobo Rus <luisca@cozybit.com>
Signed-off-by: default avatarJohn W. Linville <linville@tuxdriver.com>
parent 90a42210
...@@ -47,15 +47,19 @@ Version 5 Command: ...@@ -47,15 +47,19 @@ Version 5 Command:
iwpriv ethX ledgpio <n> iwpriv ethX ledgpio <n>
BT Commands: BT Commands:
The blinding table (BT) contains a list of mac addresses that should be The blinding table (BT) contains a list of mac addresses that will be,
ignored by the firmware. It is primarily used for debugging and by default, ignored by the firmware. It is also possible to invert this
testing networks. It can be edited and inspected with the following behavior so that we will ignore all traffic except for the portion
commands: coming from mac addresess in the list. It is primarily used for
debugging and testing networks. It can be edited and inspected with
the following commands:
iwpriv ethX bt_reset iwpriv ethX bt_reset
iwpriv ethX bt_add <mac_address> iwpriv ethX bt_add <mac_address>
iwpriv ethX bt_del <mac_address> iwpriv ethX bt_del <mac_address>
iwpriv ethX bt_list <id> iwpriv ethX bt_list <id>
iwpriv ethX bt_get_invert <n>
iwpriv ethX bt_set_invert <n>
FWT Commands: FWT Commands:
The forwarding table (FWT) is a feature used to manage mesh network The forwarding table (FWT) is a feature used to manage mesh network
...@@ -135,7 +139,7 @@ fwt_add ...@@ -135,7 +139,7 @@ fwt_add
This command is used to insert an entry into the FWT table. The list of This command is used to insert an entry into the FWT table. The list of
parameters must follow the following structure: parameters must follow the following structure:
iwpriv ethX fwt_add da ra [metric dir ssn dsn hopcount ttl expiration sleepmode snr] iwpriv ethX fwt_add da ra [metric dir rate ssn dsn hopcount ttl expiration sleepmode snr]
The parameters between brackets are optional, but they must appear in The parameters between brackets are optional, but they must appear in
the order specified. For example, if you want to specify the metric, the order specified. For example, if you want to specify the metric,
...@@ -150,6 +154,9 @@ fwt_add ...@@ -150,6 +154,9 @@ fwt_add
preferred, default is 0) preferred, default is 0)
dir -- direction (1 for direct, 0 for reverse, dir -- direction (1 for direct, 0 for reverse,
default is 1) default is 1)
rate -- data rate used for transmission to the RA,
as specified for the rateadapt command,
default is 3 (11Mbps)
ssn -- Source Sequence Number (time at the RA for ssn -- Source Sequence Number (time at the RA for
reverse routes. Default is 0) reverse routes. Default is 0)
dsn -- Destination Sequence Number (time at the DA dsn -- Destination Sequence Number (time at the DA
...@@ -207,13 +214,17 @@ fwt_list ...@@ -207,13 +214,17 @@ fwt_list
The output is a string of the following form: The output is a string of the following form:
da ra metric dir ssn dsn hopcount ttl expiration sleepmode snr da ra valid metric dir rate ssn dsn hopcount ttl expiration
sleepmode snr precursor
where the different fields are:- where the different fields are:-
da -- DA MAC address (in the form "00:11:22:33:44:55") da -- DA MAC address (in the form "00:11:22:33:44:55")
ra -- RA MAC address (in the form "00:11:22:33:44:55") ra -- RA MAC address (in the form "00:11:22:33:44:55")
valid -- whether the route is valid (0 if not valid)
metric -- route metric (cost: smaller-metric routes are preferred) metric -- route metric (cost: smaller-metric routes are preferred)
dir -- direction (1 for direct, 0 for reverse) dir -- direction (1 for direct, 0 for reverse)
rate -- data rate used for transmission to the RA,
as specified for the rateadapt command
ssn -- Source Sequence Number (time at the RA for reverse routes) ssn -- Source Sequence Number (time at the RA for reverse routes)
dsn -- Destination Sequence Number (time at the DA for direct routes) dsn -- Destination Sequence Number (time at the DA for direct routes)
hopcount -- hop count (currently unused) hopcount -- hop count (currently unused)
...@@ -221,33 +232,10 @@ fwt_list ...@@ -221,33 +232,10 @@ fwt_list
expiration -- entry expiration (in ticks, where a tick is 1024us, or ~ 1ms. Use 0 for an indefinite entry) expiration -- entry expiration (in ticks, where a tick is 1024us, or ~ 1ms. Use 0 for an indefinite entry)
sleepmode -- RA's sleep mode (currently unused) sleepmode -- RA's sleep mode (currently unused)
snr -- SNR in the link to RA (currently unused) snr -- SNR in the link to RA (currently unused)
precursor -- predecessor in direct routes
fwt_list_route fwt_list_route
This command is used to list a route from the FWT table. The only This command is equivalent to fwt_list.
parameter is the route ID. If you want to list all the routes in a
table, start with rid=0, and keep incrementing rid until you get a
"(null)" string. This function is similar to fwt_list. The only
difference is the output format. Also note that this command is meant
for debugging. It is expected that users will use fwt_lookup and
fwt_list. One important reason for this is that the route id may change
as the route table is altered.
iwpriv ethX fwt_list_route rid
The output is a string of the following form:
da metric dir nid ssn dsn hopcount ttl expiration
where the different fields are:-
da -- DA MAC address (in the form "00:11:22:33:44:55")
metric -- route metric (cost: smaller-metric routes are preferred)
dir -- direction (1 for direct, 0 for reverse)
nid -- Next-hop (neighbor) host ID (nid)
ssn -- Source Sequence Number (time at the RA for reverse routes)
dsn -- Destination Sequence Number (time at the DA for direct routes)
hopcount -- hop count (currently unused)
ttl -- TTL count (only used in reverse entries)
expiration -- entry expiration (in ticks, where a tick is 1024us, or ~ 1ms. Use 0 for an indefinite entry)
fwt_list_neigh fwt_list_neigh
This command is used to list a neighbor from the FWT table. The only This command is used to list a neighbor from the FWT table. The only
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment