public interface RelayNetworkStatus extends Descriptor
Directory authorities in the (outdated) version 2 of the directory
protocol published signed network status documents. Each network
status listed, for every relay in the network
(NetworkStatusEntry
): a hash of its identity key, a hash of its
most recent server descriptor, and a summary of what the authority
believed about its status.
Clients would download the authorities' network status documents in turn, and believe statements about routers iff they were attested to by more than half of the authorities.
Network status documents in the version 2 directory protocol
supersede signed directories in the version 1 directory protocol
(RelayDirectory
) and have been superseded by network status
consensuses (RelayNetworkStatusConsensus
) in the version 3
directory protocol.
Modifier and Type | Method and Description |
---|---|
boolean |
containsStatusEntry(java.lang.String fingerprint)
Return whether a status entry with the given relay fingerprint
(SHA-1 digest of the server's public identity key, encoded as 40
upper-case hexadecimal characters) exists; convenience method for
getStatusEntries().containsKey(fingerprint) . |
java.lang.String |
getAddress()
Return the authority's primary IPv4 address in dotted-quad format,
or null if the descriptor does not contain an address.
|
java.lang.String |
getContactLine()
Return the contact information for this authority, which may contain
non-ASCII characters.
|
java.lang.String |
getDigestSha1Hex()
Return the SHA-1 status digest, encoded as 40 lower-case hexadecimal
characters, that the directory authority used to sign the network
status.
|
java.lang.String |
getDirectorySignature()
Return the directory signature string made with the authority's
identity key.
|
java.util.SortedSet<java.lang.String> |
getDirOptions()
Return the set of flags that this directory assigns to relays, or
null if the status does not assign such flags.
|
int |
getDirport()
Return the TCP port where this authority accepts directory-related
HTTP connections, or 0 if the authority does not accept such
connections.
|
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.
|
java.lang.String |
getFingerprint()
Return a SHA-1 digest of the authority's public identity key,
encoded as 40 upper-case hexadecimal characters, which is also used
to sign network statuses.
|
java.lang.String |
getHostname()
Return the authority's hostname.
|
int |
getNetworkStatusVersion()
Return the document format version of this descriptor which is 2.
|
java.lang.String |
getNickname()
Return the authority's 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> |
getRecommendedClientVersions()
Return recommended Tor versions for client usage, or null if the
authority does not recommend client versions.
|
java.util.List<java.lang.String> |
getRecommendedServerVersions()
Return recommended Tor versions for server usage, or null if the
authority does not recommend server versions.
|
java.util.SortedMap<java.lang.String,NetworkStatusEntry> |
getStatusEntries()
Return status entries for each contained server, with map keys being
SHA-1 digests of the servers' public identity keys, encoded as 40
upper-case hexadecimal characters.
|
NetworkStatusEntry |
getStatusEntry(java.lang.String fingerprint)
Return a status entry by relay fingerprint (SHA-1 digest of the
server's public identity key, encoded as 40 upper-case hexadecimal
characters), or null if no such status entry exists; convenience
method for
getStatusEntries().get(fingerprint) . |
getAnnotations, getDescriptorFile, getRawDescriptorBytes, getRawDescriptorLength, getUnrecognizedLines
int getNetworkStatusVersion()
java.lang.String getHostname()
java.lang.String getAddress()
int getDirport()
java.lang.String getFingerprint()
java.lang.String getContactLine()
java.lang.String getDirSigningKey()
java.util.List<java.lang.String> getRecommendedServerVersions()
java.util.List<java.lang.String> getRecommendedClientVersions()
long getPublishedMillis()
java.util.SortedSet<java.lang.String> getDirOptions()
java.util.SortedMap<java.lang.String,NetworkStatusEntry> getStatusEntries()
boolean containsStatusEntry(java.lang.String fingerprint)
getStatusEntries().containsKey(fingerprint)
.NetworkStatusEntry getStatusEntry(java.lang.String fingerprint)
getStatusEntries().get(fingerprint)
.java.lang.String getNickname()
java.lang.String getDirectorySignature()
java.lang.String getDigestSha1Hex()