tools: nfdc face create command
refs #3864
Change-Id: Icca589eceae0b78f68cda61e761dd4721ce54f9c
diff --git a/docs/manpages/nfdc-face.rst b/docs/manpages/nfdc-face.rst
index 2d97407..86935d4 100644
--- a/docs/manpages/nfdc-face.rst
+++ b/docs/manpages/nfdc-face.rst
@@ -5,9 +5,9 @@
--------
| nfdc face [list]
| nfdc face show <FACEID>
-| nfdc channel [list]
-| nfdc create [-P] <FACEURI>
+| nfdc face create [remote] <FACEURI> [[persistency] <PERSISTENCY>]
| nfdc destroy <FACEID|FACEURI>
+| nfdc channel [list]
DESCRIPTION
-----------
@@ -20,25 +20,19 @@
The **nfdc face show** command shows properties and statistics of one specific face.
-The **nfdc channel list** command shows a list of channels.
-Channels are listening sockets that can accept incoming connections and create new faces.
-
-The **nfdc create** command creates a new UDP or TCP face.
+The **nfdc face create** command creates a unicast UDP or TCP face.
The **nfdc destroy** command destroys an existing face.
It has no effect if the specified face does not exist.
+The **nfdc channel list** command shows a list of channels.
+Channels are listening sockets that can accept incoming connections and create new faces.
+
OPTIONS
-------
--P
- Creates a "permanent" rather than persistent face.
- A persistent face is closed when a socket error occrs.
- A permanent face is kept alive upon socket errors,
- and is closed only upon **nfdc destroy** command.
-
<FACEID>
Numerical identifier of the face.
- It is displayed in the output of **nfdc face list** and **nfdc create** commands.
+ It is displayed in the output of **nfdc face list** and **nfdc face create** commands.
<FACEURI>
An URI representing the remote endpoint of a face.
@@ -49,6 +43,11 @@
When a hostname is specified, a DNS query is used to obtain the IP address.
+<PERSISTENCY>
+ Either "persistent" or "permanent".
+ A "persistent" face (the default) is closed when a socket error occurs.
+ A "permanent" face survives socket errors, and is closed only with a **nfdc destroy** command.
+
EXIT CODES
----------
@@ -60,6 +59,8 @@
3: Face not found (**nfdc face show** only)
+4: FaceUri canonization failed (**nfdc face create** only)
+
SEE ALSO
--------
nfd(1), nfdc(1)