Config file format¶

Initial state of NFD daemon is configured using an INI file.

INI details¶

• Blank lines are allowed.
• Comments must start with ;, and must appear on its own line.
• Sections must be used. Properties cannot be declared out of sections.
• Section and property names are case-sensitive.
• Duplicate section names and duplicate property names are allowed.
• Whitespaces are not allowed at beginning of the line, or around the equal sign. Whitespaces after the equal sign are part of the value.
• Escape characters are not supported.

Example configuration¶

; the process section defines settings of nfd process
[process]
pidfile=/tmp/nfd.pid
; filename where NFD writes its PID upon startup
uid=ndn
; uid to change into after initialization
gid=ndn
; gid to change into after initialization

; a channel section defines a channel
; it can be repeated to define multiple channels
[channel]
name=unix
; name of channel, must be unique
proto=unix
; underlying protocol
path=/var/run/nfd.sock
; (UNIX) path
listen=y
; whether to start listening

[channel]
name=tcp
proto=tcp
port=6363
; (TCP) listen port
listen=y

[channel]
name=udp
proto=udp
port=6363
; (UDP) listen port
listen=y

[channel]
name=udp_mcast
proto=udp
port=56363
mcast_group=224.0.23.170
; (UDP) join multicast group
local_ip=192.0.2.1
; (UDP mcast) local IP to use; must belong to a local NIC

[channel]
name=ether
proto=ether
dev=eth1
; (Ethernet) local NIC
wire=ndnlp

; an auth section defines an authorized key
; it can be repeated to define multiple authorized keys
[auth]
keyfile=/etc/nfd/keys/1.pub
; path to a public key, should be readable by root only
privilege=fib
privilege=stats
; a privilege granted to this public key
; privilege property can be repeated to grant multiple privileges