Interface RelayDirectory
- All Superinterfaces:
Descriptor,Serializable
Directory authorities in the (long outdated) version 1 of the
directory protocol served signed directory documents containing a list
of signed server descriptors (ServerDescriptor) along with
short summaries of the status of each server
(RouterStatusEntry).
Clients in that version of the directory protocol would fetch this signed directory to get up-to-date information on the state of the network and be certain that the list was attested by a trusted directory authority.
Signed directories in the version 1 directory protocol have first
been superseded by network status documents in the version 2 directory
protocol (RelayNetworkStatus) and later by network status
consensuses (RelayNetworkStatusConsensus) in the version 3
directory protocol.
- Since:
- 1.0.0
-
Method Summary
Modifier and TypeMethodDescriptionReturn the SHA-1 directory digest, encoded as 40 lower-case hexadecimal characters, that the directory authority used to sign the directory.Return the directory signature string made with the authority's identity key.Return the RSA-1024 public key in PEM format used by this authority as long-term identity key and to sign network statuses, or null if this key is not included in the descriptor header.Return the directory nickname consisting of 1 to 19 alphanumeric characters.longReturn the time in milliseconds since the epoch when this descriptor was published.Return recommended Tor versions.Return router status entries, one for each contained relay.Return a (very likely empty) list of exceptions from parsing the contained server descriptors.Return a list of server descriptors contained in the signed directory.Methods inherited from interface org.torproject.descriptor.Descriptor
getAnnotations, getDescriptorFile, getRawDescriptorBytes, getRawDescriptorLength, getUnrecognizedLines
-
Method Details
-
getPublishedMillis
long getPublishedMillis()Return the time in milliseconds since the epoch when this descriptor was published.- Since:
- 1.0.0
-
getDirSigningKey
String getDirSigningKey()Return the RSA-1024 public key in PEM format used by this authority as long-term identity key and to sign network statuses, or null if this key is not included in the descriptor header.- Since:
- 1.0.0
-
getRecommendedSoftware
Return recommended Tor versions.- Since:
- 1.0.0
-
getDirectorySignature
String getDirectorySignature()Return the directory signature string made with the authority's identity key.- Since:
- 1.0.0
-
getRouterStatusEntries
List<RouterStatusEntry> getRouterStatusEntries()Return router status entries, one for each contained relay.- Since:
- 1.0.0
-
getServerDescriptors
List<ServerDescriptor> getServerDescriptors()Return a list of server descriptors contained in the signed directory.- Since:
- 1.0.0
-
getServerDescriptorParseExceptions
Return a (very likely empty) list of exceptions from parsing the contained server descriptors.- Since:
- 1.0.0
-
getNickname
String getNickname()Return the directory nickname consisting of 1 to 19 alphanumeric characters.- Since:
- 1.0.0
-
getDigestSha1Hex
String getDigestSha1Hex()Return the SHA-1 directory digest, encoded as 40 lower-case hexadecimal characters, that the directory authority used to sign the directory.- Since:
- 1.7.0
-