| Junxiao Shi | 6c13562 | 2016-11-21 14:30:33 +0000 | [diff] [blame] | 1 | nfdc-strategy |
| 2 | ============= |
| 3 | |
| 4 | SYNOPSIS |
| 5 | -------- |
| 6 | | nfdc strategy [list] |
| Junxiao Shi | 5d3e481 | 2017-04-05 16:52:59 +0000 | [diff] [blame] | 7 | | nfdc strategy show [prefix] <PREFIX> |
| Junxiao Shi | f0dfb33 | 2017-02-02 05:32:25 +0000 | [diff] [blame] | 8 | | nfdc set-strategy <PREFIX> <STRATEGY> |
| 9 | | nfdc unset-strategy <PREFIX> |
| Junxiao Shi | 6c13562 | 2016-11-21 14:30:33 +0000 | [diff] [blame] | 10 | |
| 11 | DESCRIPTION |
| 12 | ----------- |
| 13 | In NFD, packet forwarding behavior is determined by forwarding pipelines and forwarding strategies. |
| 14 | The forwarding pipelines define general steps of packet processing. |
| 15 | Forwarding strategies provide the intelligence to make decision on whether, when, and where |
| 16 | to forward Interests. |
| 17 | |
| 18 | NFD contains multiple forwarding strategy implementations. |
| 19 | The strategy choice table determines which strategy is used in forwarding an Interest. |
| 20 | |
| Junxiao Shi | 5d3e481 | 2017-04-05 16:52:59 +0000 | [diff] [blame] | 21 | The **nfdc strategy list** command shows a list of strategy choices. |
| 22 | |
| 23 | The **nfdc strategy show** command shows the effective strategy choice for a specific name. |
| Junxiao Shi | 6c13562 | 2016-11-21 14:30:33 +0000 | [diff] [blame] | 24 | |
| 25 | The **nfdc set-strategy** command sets the strategy for a name prefix. |
| 26 | |
| 27 | The **nfdc unset-strategy** command clears the strategy choice at a name prefix, |
| 28 | so that a strategy choice at a shorter prefix or the default strategy will be used. |
| 29 | It undoes a prior **nfdc set-strategy** command on the same name prefix. |
| 30 | |
| 31 | OPTIONS |
| 32 | ------- |
| Junxiao Shi | f0dfb33 | 2017-02-02 05:32:25 +0000 | [diff] [blame] | 33 | <PREFIX> |
| Junxiao Shi | 6c13562 | 2016-11-21 14:30:33 +0000 | [diff] [blame] | 34 | The name prefix of a strategy choice. |
| 35 | The strategy choice is effective for all Interests under the name prefix, |
| 36 | unless overridden by another strategy choice. |
| 37 | Specifying ``ndn:/`` as the prefix in **nfdc set-strategy** changes the default strategy. |
| 38 | Specifying ``ndn:/`` as the prefix in **nfdc unset-strategy** is disallowed, |
| 39 | because NFD must always have a default strategy. |
| 40 | |
| Junxiao Shi | f0dfb33 | 2017-02-02 05:32:25 +0000 | [diff] [blame] | 41 | <STRATEGY> |
| Junxiao Shi | 6c13562 | 2016-11-21 14:30:33 +0000 | [diff] [blame] | 42 | A name that identifies the forwarding strategy. |
| 43 | Consult NFD Developer's Guide for a complete list of all implemented strategies. |
| 44 | |
| Junxiao Shi | 5d3e481 | 2017-04-05 16:52:59 +0000 | [diff] [blame] | 45 | EXIT CODES |
| 46 | ---------- |
| 47 | |
| 48 | 0: Success |
| 49 | |
| 50 | 1: An unspecified error occurred |
| 51 | |
| 52 | 2: Malformed command line |
| 53 | |
| Junxiao Shi | 6c13562 | 2016-11-21 14:30:33 +0000 | [diff] [blame] | 54 | SEE ALSO |
| 55 | -------- |
| 56 | nfd(1), nfdc(1) |