commit 7e6fefc4a2e2ed120bdf70c2b631556ba908521b
author Alexander Afanasyev <alexander.afanasyev@ucla.edu> Mon Oct 20 12:31:55 2014 -0400
committer Alexander Afanasyev <alexander.afanasyev@ucla.edu> Mon Oct 20 14:56:57 2014 -0400
tree 2b6729bca59bcc6b0349f5c0602d2b05d629aeea
parent 66cd424d10a4fadc5d406ed06002e459c3a09d5e

management: Fix regression with the prefix registration using the default certificate

This commit re-introduces a no longer deprecated feature in

    ndn::nfd::Controller::start(ControlParameter,
                                CommandSuccessCallback, CommandFailCallback,
                                IdentityCertificate,
                                time::milliseconds),

which treats IdentityCertificate() (an invalid certificate that has an empty
name) as the default certificate.

Change-Id: I3f147260d649e82c6bd1927ff5998be79a37d0dc
Refs: #2080

src/face.hpp

diff --git a/src/face.hpp b/src/face.hpp
index 9f11b0a..d95d04a 100644
--- a/src/face.hpp
+++ b/src/face.hpp
@@ -251,6 +251,10 @@
    *
    * @return Opaque registered prefix ID which can be used with unsetInterestFilter or
    *         removeRegisteredPrefix
+   *
+   * @note IdentityCertificate() creates a certificate with an empty name, which is an invalid
+   *       certificate.  A valid IdentityCertificate has at least 4 name components, as it follows
+   *       `<...>/KEY/<...>/<key-id>/ID-CERT/<version>` naming model.
    */
   const RegisteredPrefixId*
   setInterestFilter(const InterestFilter& interestFilter,
@@ -280,6 +284,10 @@
    *
    * @return Opaque registered prefix ID which can be used with unsetInterestFilter or
    *         removeRegisteredPrefix
+   *
+   * @note IdentityCertificate() creates a certificate with an empty name, which is an invalid
+   *       certificate.  A valid IdentityCertificate has at least 4 name components, as it follows
+   *       `<...>/KEY/<...>/<key-id>/ID-CERT/<version>` naming model.
    */
   const RegisteredPrefixId*
   setInterestFilter(const InterestFilter& interestFilter,
@@ -375,6 +383,10 @@
    * @param flags       (optional) RIB flags (not used when direct FIB management is requested)
    *
    * @return The registered prefix ID which can be used with unregisterPrefix
+   *
+   * @note IdentityCertificate() creates a certificate with an empty name, which is an invalid
+   *       certificate.  A valid IdentityCertificate has at least 4 name components, as it follows
+   *       `<...>/KEY/<...>/<key-id>/ID-CERT/<version>` naming model.
    */
   const RegisteredPrefixId*
   registerPrefix(const Name& prefix,