Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 1 | nfd-asf-strategy |
| 2 | ================ |
| 3 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 4 | Synopsis |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 5 | -------- |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 6 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 7 | **nfdc strategy set** **prefix** *NAME* **strategy** |
| 8 | /localhost/nfd/strategy/asf[/v=4][/**probing-interval**\ ~\ *INTERVAL*][/**max-timeouts**\ ~\ *TIMEOUTS*] |
| 9 | |
| 10 | Description |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 11 | ----------- |
| 12 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 13 | **ASF** is an Adaptive Smoothed RTT-based Forwarding Strategy that chooses the |
| 14 | best next hop based on SRTT measurements, and also periodically probes other |
| 15 | next hops to learn their RTTs. |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 16 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 17 | Options |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 18 | ------- |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 19 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 20 | .. option:: probing-interval |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 21 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 22 | This optional parameter tells ASF how often to send a probe to determine |
| 23 | alternative paths. The value is specified in milliseconds (non-negative |
| 24 | integer). Smaller values will result in higher overhead but faster reaction. |
| 25 | The default value is 1 minute and the minimum value is 1 second. |
| 26 | |
| 27 | .. option:: max-timeouts |
| 28 | |
| 29 | This optional parameter makes ASF switch to another appropriate face (if available) |
| 30 | after it has encountered the specified number of timeouts. The value is a positive |
| 31 | integer and defaults to 3, i.e., switch to another face after 3 timeouts. Smaller |
| 32 | values make ASF more sensitive to timeouts and will switch paths more frequently, |
| 33 | which should provide a faster reaction to link failures. Larger values may be better |
| 34 | suited when transient timeouts are common and for certain application uses. |
| 35 | |
| 36 | Examples |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 37 | -------- |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 38 | |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 39 | nfdc strategy set prefix /ndn strategy /localhost/nfd/strategy/asf |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 40 | Use the default values for all parameters. |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 41 | |
Eric Newberry | 7249fb4 | 2021-04-04 21:09:32 -0700 | [diff] [blame] | 42 | nfdc strategy set prefix /ndn strategy /localhost/nfd/strategy/asf/v=4/probing-interval~30000 |
Ashlesh Gawande | 1ef93d0 | 2022-04-08 00:25:06 -0400 | [diff] [blame^] | 43 | Set the probing interval to 30 seconds. |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 44 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 45 | nfdc strategy set prefix /ndn strategy /localhost/nfd/strategy/asf/v=4/max-timeouts~5 |
Ashlesh Gawande | 1ef93d0 | 2022-04-08 00:25:06 -0400 | [diff] [blame^] | 46 | Set the maximum number of timeouts to 5. |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 47 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 48 | nfdc strategy set prefix /ndn strategy /localhost/nfd/strategy/asf/v=4/probing-interval~30000/max-timeouts~2 |
Ashlesh Gawande | 1ef93d0 | 2022-04-08 00:25:06 -0400 | [diff] [blame^] | 49 | Set the probing interval to 30 seconds and the maximum number of timeouts to 2. |
| 50 | |
| 51 | nfdc strategy set prefix /ndn strategy /localhost/nfd/strategy/asf/v=4/retx-suppression-multiplier~2.5/probing-interval~45000 |
| 52 | Set the retransmission suppression multiplier to 2.5 and the probing interval |
| 53 | to 45 seconds. See :manpage:`nfdc-strategy(1)` for more information on the |
| 54 | retransmission suppression parameters. |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 55 | |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 56 | See also |
Ashlesh Gawande | 92e4ea5 | 2017-07-19 11:38:12 -0500 | [diff] [blame] | 57 | -------- |
Saurab Dulal | af3ff5a | 2021-09-19 19:45:07 -0400 | [diff] [blame] | 58 | |
Eric Newberry | 7249fb4 | 2021-04-04 21:09:32 -0700 | [diff] [blame] | 59 | nfdc(1), nfdc-strategy(1) |