public interface RelayDirectory extends Descriptor
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.
| Modifier and Type | Method and Description |
|---|---|
java.lang.String |
getDigestSha1Hex()
Return the SHA-1 directory digest, encoded as 40 lower-case
hexadecimal characters, that the directory authority used to sign the
directory.
|
java.lang.String |
getDirectorySignature()
Return the directory signature string made with the authority's
identity key.
|
java.lang.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.
|
java.lang.String |
getNickname()
Return the directory nickname consisting of 1 to 19 alphanumeric
characters.
|
long |
getPublishedMillis()
Return the time in milliseconds since the epoch when this descriptor
was published.
|
java.util.List<java.lang.String> |
getRecommendedSoftware()
Return recommended Tor versions.
|
java.util.List<RouterStatusEntry> |
getRouterStatusEntries()
Return router status entries, one for each contained relay.
|
java.util.List<java.lang.Exception> |
getServerDescriptorParseExceptions()
Return a (very likely empty) list of exceptions from parsing the
contained server descriptors.
|
java.util.List<ServerDescriptor> |
getServerDescriptors()
Return a list of server descriptors contained in the signed
directory.
|
getAnnotations, getDescriptorFile, getRawDescriptorBytes, getRawDescriptorLength, getUnrecognizedLineslong getPublishedMillis()
java.lang.String getDirSigningKey()
java.util.List<java.lang.String> getRecommendedSoftware()
java.lang.String getDirectorySignature()
java.util.List<RouterStatusEntry> getRouterStatusEntries()
java.util.List<ServerDescriptor> getServerDescriptors()
java.util.List<java.lang.Exception> getServerDescriptorParseExceptions()
java.lang.String getNickname()
java.lang.String getDigestSha1Hex()