| Davide Pesavento | 59769b1 | 2017-11-12 23:52:06 -0500 | [diff] [blame] | 1 | nfd-autoreg |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 2 | =========== |
| 3 | |
| Davide Pesavento | 9f6a7d9 | 2020-10-06 15:21:48 -0400 | [diff] [blame] | 4 | Synopsis |
| 5 | -------- |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 6 | |
| Davide Pesavento | 9f6a7d9 | 2020-10-06 15:21:48 -0400 | [diff] [blame] | 7 | **nfd-autoreg** --prefix=</autoreg/prefix> [--prefix=</another/prefix>]... |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 8 | |
| 9 | Description |
| 10 | ----------- |
| 11 | |
| Davide Pesavento | 59769b1 | 2017-11-12 23:52:06 -0500 | [diff] [blame] | 12 | ``nfd-autoreg`` is a daemon application that automatically registers the specified |
| 13 | prefix(es) when new on-demand faces are created (i.e., when a new UDP face is created as |
| Niv Sardi | 5e8755c | 2016-12-13 14:11:53 -0300 | [diff] [blame] | 14 | the result of an incoming packet or when a new TCP face is created as the result of an |
| 15 | incoming connection). |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 16 | |
| 17 | Options |
| 18 | ------- |
| 19 | |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 20 | ``-i`` or ``--prefix`` |
| 21 | Prefix that should be automatically registered when a new remote face is created. |
| Davide Pesavento | 59769b1 | 2017-11-12 23:52:06 -0500 | [diff] [blame] | 22 | Can be repeated multiple times to specify additional prefixes. |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 23 | |
| 24 | ``-c`` or ``--cost`` |
| Davide Pesavento | 59769b1 | 2017-11-12 23:52:06 -0500 | [diff] [blame] | 25 | RIB cost to be assigned to auto-registered prefixes. If not specified, default cost |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 26 | is set to 255. |
| 27 | |
| 28 | ``-w`` or ``--whitelist`` |
| 29 | Whitelisted network, e.g., 192.168.2.0/24 or ::1/128. Can be repeated multiple times |
| 30 | to specify multiple whitelisted networks. |
| 31 | |
| 32 | Prefix(es) will be auto-registered only when remote IP address is within the specified |
| 33 | range(s), except blacklist ranges. |
| 34 | |
| 35 | Default: 0.0.0.0/0 and ::/0 |
| 36 | |
| 37 | ``-b`` or ``--blacklist`` |
| 38 | Blacklisted network, e.g., 192.168.2.32/30 or ::1/128. Can be repeated multiple times |
| 39 | to specify multiple blacklisted networks. |
| 40 | |
| 41 | Prefix(es) will be auto-registered only when remote IP address in **NOT** within the |
| 42 | specified range(s), but is within the range define by the whitelist(s). |
| 43 | |
| 44 | Default: none |
| 45 | |
| Davide Pesavento | 59769b1 | 2017-11-12 23:52:06 -0500 | [diff] [blame] | 46 | ``-h`` or ``--help`` |
| 47 | Print help message and exit. |
| 48 | |
| 49 | ``-V`` or ``--version`` |
| 50 | Show version information and exit. |
| 51 | |
| 52 | Exit status |
| 53 | ----------- |
| 54 | |
| 55 | 0: No error. |
| 56 | |
| 57 | 1: An unspecified error occurred. |
| 58 | |
| 59 | 2: Malformed command line, e.g., invalid, missing, or unknown argument. |
| 60 | |
| 61 | 4: Insufficient privileges. |
| 62 | |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 63 | Examples |
| 64 | -------- |
| 65 | |
| Davide Pesavento | 59769b1 | 2017-11-12 23:52:06 -0500 | [diff] [blame] | 66 | Auto-register two prefixes for any newly created on-demand face, except those that has |
| hilata | 6ee6e07 | 2014-04-20 17:10:18 -0500 | [diff] [blame] | 67 | source IP address in ``10.0.0.0/8`` network:: |
| 68 | |
| 69 | nfd-autoreg --prefix=/app1/video --prefix=/app2/pictures -b 10.0.0.0/8 |