Class DnsSoaResource

A Start of Authority record (abbreviated as SOA record) is a type of resource record in the Domain Name System (DNS) containing administrative information about the zone, especially regarding zone transfers. The SOA record format is specified in RFC 1035.

Inheritance

Object

DnsSoaResource

Implements

IDnsResource

IDnsByteArrayWriter

IEquatable<DnsSoaResource>

Namespace: Ae.Dns.Protocol.Records

Assembly: Ae.Dns.Protocol.dll

Syntax

public sealed class DnsSoaResource : object, IDnsResource, IDnsByteArrayWriter, IEquatable<DnsSoaResource>

Properties

Expire

Number of seconds after which secondary name servers should stop answering request for this zone if the master does not respond. This value must be bigger than the sum of Refresh and Retry. Recommendation for small and stable zones: 3600000 seconds (1000 hours).

Declaration

public TimeSpan Expire { get; set; }

Property Value

Type	Description
TimeSpan

Minimum

Time to live for purposes of negative caching. Recommendation for small and stable zones: 3600 seconds (1 hour). Originally this field had the meaning of a minimum TTL value for resource records in this zone; it was changed to its current meaning by RFC 2308.

Declaration

public TimeSpan Minimum { get; set; }

Property Value

Type	Description
TimeSpan

MName

Primary master name server for this zone

Declaration

public string MName { get; set; }

Property Value

Type	Description
String

Refresh

Number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes. Recommendation for small and stable zones:[4] 86400 seconds (24 hours).

Declaration

public TimeSpan Refresh { get; set; }

Property Value

Type	Description
TimeSpan

Retry

Number of seconds after which secondary name servers should retry to request the serial number from the master if the master does not respond. It must be less than Refresh. Recommendation for small and stable zones: 7200 seconds (2 hours).

Declaration

public TimeSpan Retry { get; set; }

Property Value

Type	Description
TimeSpan

RName

Email address of the administrator responsible for this zone. (As usual, the email address is encoded as a name. The part of the email address before the @ becomes the first label of the name; the domain name after the @ becomes the rest of the name. In zone-file format, dots in labels are escaped with backslashes; thus the email address john.doe@example.com would be represented in a zone file as john.doe.example.com.)

Declaration

public string RName { get; set; }

Property Value

Type	Description
String

Serial

Serial number for this zone. If a secondary name server slaved to this one observes an increase in this number, the slave will assume that the zone has been updated and initiate a zone transfer.

Declaration

public uint Serial { get; set; }

Property Value

Type	Description
UInt32

Methods

Equals(DnsSoaResource)

Declaration

public bool Equals(DnsSoaResource other)

Parameters

Type	Name	Description
DnsSoaResource	other

Returns

Type	Description
Boolean

Equals(Object)

Declaration

public override bool Equals(object obj)

Parameters

Type	Name	Description
Object	obj

Returns

Type	Description
Boolean

GetHashCode()

Declaration

public override int GetHashCode()

Returns

Type	Description
Int32

ReadBytes(ReadOnlyMemory<Byte>, ref Int32, Int32)

Read from the specified byte array, starting at the specified offset.

Declaration

public void ReadBytes(ReadOnlyMemory<byte> bytes, ref int offset, int length)

Parameters

Type	Name	Description
ReadOnlyMemory<Byte>	bytes	The byte array to read from.
Int32	offset	The offset to start at.
Int32	length	The maximum number of bytes to read.

ToString()

Declaration

public override string ToString()

Returns

Type	Description
String

WriteBytes(Memory<Byte>, ref Int32)

Write to the the specified byte array.

Declaration

public void WriteBytes(Memory<byte> bytes, ref int offset)

Parameters

Type	Name	Description
Memory<Byte>	bytes	The byte array to read from.
Int32	offset	The offset to start at.

Implements

IDnsResource

IDnsByteArrayWriter

IEquatable<>