tools: add mtu option to 'nfdc face create'
refs #4789
Change-Id: I9e31c5fb460ee99199332ffb6fadc9f0f33125e9
diff --git a/docs/manpages/nfdc-face.rst b/docs/manpages/nfdc-face.rst
index f9dd1fd..c00a6ce 100644
--- a/docs/manpages/nfdc-face.rst
+++ b/docs/manpages/nfdc-face.rst
@@ -9,6 +9,7 @@
| [reliability on|off] [congestion-marking on|off]
| [congestion-marking-interval <MARKING-INTERVAL>]
| [default-congestion-threshold <CONGESTION-THRESHOLD>]
+| [mtu <MTU>]
| nfdc face destroy [face] <FACEID|FACEURI>
| nfdc channel [list]
@@ -37,6 +38,11 @@
default on all other face types.
Parameters for this feature can set with the **congestion-marking-interval** option (specified in
milliseconds) and the **default-congestion-threshold** option (specified in bytes).
+The MTUs of unicast Ethernet and UDP faces may be overridden using the **mtu** parameter (specified
+in bytes).
+However, a face may choose to limit the range of acceptable values for this parameter or disregard
+it altogether when setting its MTU.
+The MTU of an existing face may not be modified using this parameter and will result in an error.
The **nfdc face destroy** command destroys an existing face.
@@ -128,6 +134,10 @@
nfdc face create remote udp://router.example.net congestion-marking off
Create a face with the specified remote FaceUri and explicitly disable congestion marking.
+nfdc face create remote udp://router.example.net mtu 4000
+ Create a face with the specified remote FaceUri and an MTU of 4000 bytes (which may be ignored
+ or limited to within a certain range by the internal logic of the face).
+
nfdc face destroy 300
Destroy the face whose FaceId is 300.