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.long
Return 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
-