[Nfd-dev] [Ndn-app] NFD faces/create: requires canonical FaceUri

[Burke, Jeff]

Hi Junxiao,

Thanks.  What's the design rationale for the changes?   (In general, I'd suggest that API updates should include at least a brief statement on why they're being made.)

The removal of support for DNS names seems odd from a usability standpoint, and I don't understand why udp and udp4 can't just be considered equivalent.

Thanks,
Jeff

From: Junxiao Shi <shijunxiao at email.arizona.edu<mailto:shijunxiao at email.arizona.edu>>
Date: Thu, 27 Nov 2014 20:59:27 -0700
To: "ndn-app at lists.cs.ucla.edu<mailto:ndn-app at lists.cs.ucla.edu>" <ndn-app at lists.cs.ucla.edu<mailto:ndn-app at lists.cs.ucla.edu>>, "ndn-lib at lists.cs.ucla.edu<mailto:ndn-lib at lists.cs.ucla.edu>" <ndn-lib at lists.cs.ucla.edu<mailto:ndn-lib at lists.cs.ucla.edu>>, "<nfd-dev at lists.cs.ucla.edu<mailto:nfd-dev at lists.cs.ucla.edu>>" <nfd-dev at lists.cs.ucla.edu<mailto:nfd-dev at lists.cs.ucla.edu>>
Subject: [Ndn-app] NFD faces/create: requires canonical FaceUri

Dear folks

Please be aware of an upcoming NFD Management API change: faces/create command requires canonical FaceUri.
This change will happen no sooner than Dec 04 12:00 UTC.

A canonical FaceUri for UDP and TCP tunnels should specify either IPv4 or IPv6, have IP address instead of hostname, and contain port number.

Examples of canonical FaceUri:
udp4://192.0.2.1:6363<http://192.0.2.1:6363>
udp6://[2001:db8::1]:6363
tcp4://192.0.2.1:6363<http://192.0.2.1:6363>
tcp6://[2001:db8::1]:6363

Examples of non-canonical FaceUri that will be rejected by faces/create command after the change:
udp://192.0.2.1<http://192.0.2.1>
udp://example.net:6363<http://example.net:6363>
udp4://example.net:6363<http://example.net:6363>
udp6://example.net:6363<http://example.net:6363>
tcp://192.0.2.1<http://192.0.2.1>
tcp://example.net:6363<http://example.net:6363>
tcp4://example.net:6363<http://example.net:6363>
tcp6://example.net:6363<http://example.net:6363>

If you have a library / application that utilizes NFD faces/create command, please canonize the FaceUri before sending the command.
Scripts calling nfdc command line tool are unaffected by this change.

Yours, Junxiao
_______________________________________________ Ndn-app mailing list Ndn-app at lists.cs.ucla.edu<mailto:Ndn-app at lists.cs.ucla.edu> http://www.lists.cs.ucla.edu/mailman/listinfo/ndn-app
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://www.lists.cs.ucla.edu/pipermail/nfd-dev/attachments/20141128/7705cbd6/attachment.html>