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, getUnrecognizedLines
long 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()