10_set-client-ccid.diff

[paraslash.git] / ggo / dccp_recv.ggo

diff --git a/ggo/dccp_recv.ggo b/ggo/dccp_recv.ggo
index 9717329d29b036baf460fb747901ea41b913e632..2c7f364ca7f296f7bbbcf175aa9fd79d39b3651b 100644 (file)
--- a/ggo/dccp_recv.ggo
+++ b/ggo/dccp_recv.ggo
@@ -11,3 +11,31 @@ option "port" p
 int
 default="8000"
 optional
+
+option "ccid" c
+"CCID preference(s) for this connection"
+int
+# restrict the maximum number of times this option can be passed
+optional multiple(-10)
+# currently known CCIDs:
+# - CCID-2 (RFC 4341),
+# - CCID-3 (RFC 4342),
+# - CCID-4 (RFC 5622),
+# - CCID-248 ... CCID-254 are experimental (RFC 4340, 19.5)
+values="2", "3", "4", "248", "249", "250", "251", "252", "253", "254"
+details="
+       Depends on the CCIDs available on the server; this information
+       can be seen in the display of 'para_client si'.
+
+       When present exactly once, this option mandates the CCID
+       to use for the sender-receiver connection.
+
+       If it is passed more than once, it sets a preference list
+       of CCIDs for this connection. The order of appearance here
+       signifies descending priority. For example,
+                   --ccid 4   --c 2   --ccid 3
+       generates the preference list (CCID-4, CCID-2, CCID-3).
+
+       The request is reconciled with the CCIDs on the server via
+       the 'server-priority' mechanism of RFC 4340 6.3.1/10.
+"