Browse Source

Expand the comments on ASN.1-encoded TAP keys

Nick Mathewson 5 years ago
parent
commit
6c0c08bbb5
2 changed files with 10 additions and 2 deletions
  1. 5 1
      src/feature/nodelist/microdesc_st.h
  2. 5 1
      src/feature/nodelist/routerinfo_st.h

+ 5 - 1
src/feature/nodelist/microdesc_st.h

@@ -53,8 +53,12 @@ struct microdesc_t {
 
   /* Fields in the microdescriptor. */
 
-  /* Public RSA key for onions in ASN.1 encoded. */
+  /**
+   * Public RSA TAP key for onions, ASN.1 encoded.  We store this
+   * in its encoded format since storing it as a crypto_pk_t uses
+   * significantly more memory. */
   char *onion_pkey;
+  /** Length of onion_pkey, in bytes. */
   size_t onion_pkey_len;
 
   /** As routerinfo_t.onion_curve25519_pkey */

+ 5 - 1
src/feature/nodelist/routerinfo_st.h

@@ -27,8 +27,12 @@ struct routerinfo_t {
   tor_addr_t ipv6_addr;
   uint16_t ipv6_orport;
 
-  /* Public RSA key for onions in ASN.1 encoded. */
+  /**
+   * Public RSA TAP key for onions, ASN.1 encoded.  We store this
+   * in its encoded format since storing it as a crypto_pk_t uses
+   * significantly more memory. */
   char *onion_pkey;
+  /** Length of onion_pkey, in bytes. */
   size_t onion_pkey_len;
 
   crypto_pk_t *identity_pkey;  /**< Public RSA key for signing. */