DS | Javadocs [I2P+]

org.minidns.record.DS

public class DSextends DelegatingDnssecRR

DNS DS (Delegation Signer) record payload for DNSSEC.
Contains the hash of a DNSKEY record used to authenticate delegated DNS zones in DNSSEC chain of trust.

See Also:

Nested Class Summary
Nested classes/interfaces inherited from class DelegatingDnssecRR
DelegatingDnssecRR.SharedData
Modifier and Type
Class
Description
protected static final class
DelegatingDnssecRR.SharedData
The fixed fields read out of a delegation record, before it is interpreted.
Field Summary
Fields inherited from class DelegatingDnssecRR
algorithm, algorithmByte, digest, digestType, digestTypeByte, keyTag
Modifier and Type
Field
Description
final DnssecConstants.SignatureAlgorithm
algorithm
The cryptographic algorithm used to create the signature.
final byte
algorithmByte
The byte value of the cryptographic algorithm used to create the signature.
protected final byte[]
digest
The digest build from a DNSKEY.
final DnssecConstants.DigestAlgorithm
digestType
The algorithm used to construct the digest.
final byte
digestTypeByte
The byte value of algorithm used to construct the digest.
final int
keyTag
The key tag value of the DNSKEY RR that validates this signature.
Constructor Summary
Constructors
Constructor
Description
DS(int keyTag, byte algorithm, byte digestType, byte[] digest)
Create a DS record, keeping the signature and digest algorithms as raw numbers for use when MiniDNS does not recognize them.
DS(int keyTag, DnssecConstants.SignatureAlgorithm algorithm, byte digestType, byte[] digest)
Create a DS record with a known signature algorithm but a digest type that is kept as a raw number.
DS(int keyTag, DnssecConstants.SignatureAlgorithm algorithm, DnssecConstants.DigestAlgorithm digestType, byte[] digest)
Create a DS record with both the signature and the digest algorithm resolved to the constants MiniDNS knows.
Method Summary
Modifier and Type
Method
Description
Record.TYPE
getType()
Report the RR type constant that identifies this payload as a DS record.
static DS
parse(DataInputStream dis, int length)
Read a DS record payload from a wire-format stream.
Methods inherited from class DelegatingDnssecRR
digestEquals, getDigestBigInteger, getDigestHex, parseSharedData, serialize, toString
Modifier and Type
Method
Description
boolean
digestEquals(byte[] otherDigest)
Compares this record's DNSKEY digest with another byte by byte.
BigInteger
getDigestBigInteger()
Gets the DNSKEY digest as an unsigned big-endian integer.
String
getDigestHex()
Gets the DNSKEY digest as upper-case hexadecimal.
protected static DelegatingDnssecRR.SharedData
parseSharedData(DataInputStream dis, int length)
Reads the key tag, algorithm bytes and digest that DNSSEC records share.
void
serialize(DataOutputStream dos)
Writes the key tag, algorithm bytes and digest to the wire.
String
toString()
Renders the delegation as key tag, algorithms and digest.
Methods inherited from class Data
equals, hashCode, length, toByteArray, toOutputStream, toOutputStream
Modifier and Type
Method
Description
final boolean
equals(Object other)

final int
hashCode()

final int
length()
Serialize this record, if that has not been done already, and report the resulting wire size.
final byte[]
toByteArray()
Serialize this record, if that has not been done already, and return a copy of the result so callers cannot mutate the cached bytes.
final void
toOutputStream(DataOutputStream dos)
Write the binary representation of this payload to the given DataOutputStream.
final void
toOutputStream(OutputStream outputStream)
Write the binary representation to the given OutputStream.
Methods inherited from class Object
clone, getClass, notify, notifyAll, wait, wait, wait

Constructor Details
- DS
  public DS(int keyTag, byte algorithm, byte digestType, byte[] digest)
  Create a DS record, keeping the signature and digest algorithms as raw numbers for use when MiniDNS does not recognize them.
  Parameters:
  keyTag - the key tag of the DNSKEY RR that validates this delegation's signature
  algorithm - the wire signature algorithm byte
  digestType - the wire digest algorithm byte
  digest - the DNSKEY digest, which must not be null
- DS
  public DS(int keyTag, DnssecConstants.SignatureAlgorithm algorithm, byte digestType, byte[] digest)
  Create a DS record with a known signature algorithm but a digest type that is kept as a raw number.
  Parameters:
  keyTag - the key tag of the DNSKEY RR that validates this delegation's signature
  algorithm - the signing algorithm, resolved from its wire value
  digestType - the wire digest algorithm byte
  digest - the DNSKEY digest, which must not be null
- DS
  public DS(int keyTag, DnssecConstants.SignatureAlgorithm algorithm, DnssecConstants.DigestAlgorithm digestType, byte[] digest)
  Create a DS record with both the signature and the digest algorithm resolved to the constants MiniDNS knows.
  Parameters:
  keyTag - the key tag of the DNSKEY RR that validates this delegation's signature
  algorithm - the signing algorithm, resolved from its wire value
  digestType - the hashing algorithm the DNSKEY was digested with
  digest - the DNSKEY digest, which must not be null
Method Details
- parse
  public static DS parse(DataInputStream dis, int length) throws IOException
  Read a DS record payload from a wire-format stream.
  Parameters:
  dis - the stream positioned at the start of the record payload
  length - the length in bytes of the record payload
  Returns:
  the parsed DS record
  Throws:
  IOException - if the payload cannot be read from the stream
- getType
  public Record.TYPE getType()
  Report the RR type constant that identifies this payload as a DS record.
  Specified by:
  getType in class Data
  Returns:
  The DNS record type of this payload.

Nested Class Summary

Nested classes/interfaces inherited from class DelegatingDnssecRR

Field Summary

Fields inherited from class DelegatingDnssecRR

Constructor Summary

Method Summary

Methods inherited from class DelegatingDnssecRR

Methods inherited from class Data

Methods inherited from class Object

Constructor Details

DS

DS

DS

Method Details

parse

getType