aboutsummaryrefslogtreecommitdiffstats
path: root/hicn-light/README.md
diff options
context:
space:
mode:
authorAlberto Compagno <acompagn+fdio@cisco.com>2019-03-21 17:15:56 +0000
committerGerrit Code Review <gerrit@fd.io>2019-03-21 17:15:56 +0000
commitf88831fb8df34730141c728138c66698fc1d0ca7 (patch)
tree58cfb070c3257f09ae47df48cd391b3f3a983a91 /hicn-light/README.md
parent972ccbeb3d6765c2add13b7b4da10c9fb6fb2c9c (diff)
parentd0111c2f8b5b73739f7193a79415e1d0bc8ee8c8 (diff)
Merge "[HICN-128] README utils and renaming of executables"
Diffstat (limited to 'hicn-light/README.md')
-rw-r--r--hicn-light/README.md61
1 files changed, 30 insertions, 31 deletions
diff --git a/hicn-light/README.md b/hicn-light/README.md
index ba7ed77b3..974cad1fe 100644
--- a/hicn-light/README.md
+++ b/hicn-light/README.md
@@ -33,67 +33,66 @@ Basic dependencies:
## hicn-light Executables ##
-hicn-light is a set of binary executables that are used to run a forwarder instance.
+hicn-light is a set of binary executables that are used to run a forwarder instance.
The forwarder can be run and configured using the commands
-- `hicnLightDaemon`
-- `hicnLightControl`
+- `hicn-light-daemon`
+- `hicn-light-control`
Use the `-h` option to display the help messages
### hicn-light Daemon ###
-The command `hicnLightDaemon` runs the hicn-light forwarder. The forwarder can be executed
+The command `hicn-light-daemon` runs the hicn-light forwarder. The forwarder can be executed
with the following options:
```
-hicnLightDaemon [--port port] [--daemon] [--capacity objectStoreSize] [--log facility=level]
+hicn-light-daemon [--port port] [--daemon] [--capacity objectStoreSize] [--log facility=level]
[--log-file filename] [--config file]
Options:
-
---port = tcp port for local in-bound connections
---daemon = start as daemon process
---capacity = maximum number of content objects to cache. To disable the cache
- objectStoreSize must be 0.
- Default vaule for objectStoreSize is 100000
---log = sets a facility to a given log level. You can have multiple of these.
- facilities: all, config, core, io, message, processor
- levels: debug, info, notice, warning, error, critical, alert, off
- example: hicnLightDaemon --log io=debug --log core=off
---log-file = file to write log messages to (required in daemon mode)
---config = configuration filename
-```
-
-The configuration file contains configuration lines as per hicnLightControl (see below for all
+--port <tcp_port> = tcp port for local in-bound connections
+--daemon = start as daemon process
+--capacity <capacity> = maximum number of content objects to cache. To disable the cache
+ objectStoreSize must be 0.
+ Default vaule for objectStoreSize is 100000
+--log <log_granularity> = sets a facility to a given log level. You can have multiple of these.
+ facilities: all, config, core, io, message, processor
+ levels: debug, info, notice, warning, error, critical, alert, off
+ example: hicn-light-daemon --log io=debug --log core=off
+--log-file <output_logfile> = file to write log messages to (required in daemon mode)
+--config <config_path> = configuration filename
+```
+
+The configuration file contains configuration lines as per hicn-light-control (see below for all
the available commands). If logging level or content store capacity is set in the configuration
file, it overrides the command_line. When a configuration file is specified, no default listeners
are setup. Only 'add listener' lines in the configuration file matter.
-If no configuration file is specified, hicnLightDaemon will listen on TCP and UDP ports specified
+If no configuration file is specified, hicn-light-daemon will listen on TCP and UDP ports specified
by the --port flag (or default port). It will listen on both IPv4 and IPv6 if available. The
default port for hicn-light is 9695. Commands are expected on port 2001.
-### hicn-light Control ###
+### hicn-light-control ###
-`hicnLightControl` can be used to send command to the hicn-light forwarder and configure it.
+`hicn-light-control` can be used to send command to the hicn-light forwarder and configure it.
The command can be executed in the following way:
```
-hicnLightControl [commands]
+hicn-light-control [commands]
Options:
- -h = This help screen
- commands = configuration line to send to hicn-light (use 'help' for list)
+ -h = This help screen
+ commands = configuration line to send to hicn-light (use 'help' for list)
```
-#### Available Commands in hicn-light Control ####
+#### Available Commands in hicn-light-control ####
-This is the full list of available commands in `hicnLightControl`. This commands can be used
-from the command line running `hicnLightControl` as explained before, or listing them in a
+This is the full list of available commands in `hicn-light-control`. This commands can be used
+from the command line running `hicn-light-control` as explained before, or listing them in a
configuration file.
-Information about the commands are also available in the `hicnLightControl` help message.
+Information about the commands are also available in the `hicn-light-control` help message.
`add listener`: creates a TCP or UDP listener with the specified options on the local forwarder.
For local connections (application to hicn-light) we expect a TCP listener. The default port for
@@ -267,7 +266,7 @@ mapme retx <milliseconds>
### hicn-light Configuration File Example ###
This is an example of a simple configuration file for hicn-light. It can be loaded by running
-the command `hicnLightDaemon --config configFile.cfg`, assuming the file name is configFile.cfg
+the command `hicn-light-daemon --config configFile.cfg`, assuming the file name is configFile.cfg
```
#create a local listener on port 9199. This will be used by the applications to talk