Package dns :: Module update :: Class Update
[show private | hide private]
[frames | no frames]

Class Update

object --+    
         |    
   Message --+
             |
            Update


Method Summary
  __init__(self, zone, rdclass, keyring, keyname)
Initialize a new DNS Update object.
bool __eq__(self, other)
Two messages are equal if they have the same content in the header, question, answer, and authority sections. (inherited from Message)
bool __ne__(self, other)
Are two messages not equal? (inherited from Message)
a new object with type S, a subtype of T __new__(S, ...)
  __repr__(self)
(inherited from Message)
  __str__(self)
(inherited from Message)
  absent(self, name, rdtype)
Require that an owner name (and optionally an rdata type) does not exist as a prerequisite to the execution of the update.
  add(self, name, *args)
Add records.
  delete(self, name, *args)
Delete records.
dns.rrset.RRset object find_rrset(self, section, name, rdclass, rdtype, covers, deleting, create, force_unique)
Find the RRset with the given attributes in the specified section. (inherited from Message)
dns.rrset.RRset object or None get_rrset(self, section, name, rdclass, rdtype, covers, deleting, create, force_unique)
Get the RRset with the given attributes in the specified section. (inherited from Message)
bool is_response(self, other)
Is other a response to self? (inherited from Message)
  present(self, name, *args)
Require that an owner name (and optionally an rdata type, or specific rdataset) exists as a prerequisite to the execution of the update.
int rcode(self)
Return the rcode. (inherited from Message)
  replace(self, name, *args)
Replace records.
  set_rcode(self, rcode)
Set the rcode. (inherited from Message)
string to_text(self, origin, relativize, **kw)
Convert the message to text. (inherited from Message)
string to_wire(self, origin, max_size)
Return a string containing the update in DNS compressed wire format.
  use_edns(self, edns, ednsflags, payload)
Configure EDNS behavior. (inherited from Message)
  use_tsig(self, keyring, keyname, fudge, original_id, tsig_error, other_data)
When sending, a TSIG signature using the specified keyring and keyname should be added. (inherited from Message)

Method Details

__init__(self, zone, rdclass=1, keyring=None, keyname=None)
(Constructor)

Initialize a new DNS Update object.
Parameters:
zone - The zone which is being updated.
           (type=A dns.name.Name or string)
rdclass - The class of the zone; defaults to dns.rdataclass.IN.
           (type=An int designating the class, or a string whose value is the name of a class.)
keyring - The TSIG keyring to use; defaults to None.
           (type=dict)
keyname - The name of the TSIG key to use; defaults to None. The key must be defined in the keyring. If a keyring is specified but a keyname is not, then the key used will be the first key in the keyring. Note that the order of keys in a dictionary is not defined, so applications should supply a keyname when a keyring is used, unless they know the keyring contains only one key.
           (type=dns.name.Name or string)

__new__(S, ...)

Returns:
a new object with type S, a subtype of T

absent(self, name, rdtype=None)

Require that an owner name (and optionally an rdata type) does not exist as a prerequisite to the execution of the update.

add(self, name, *args)

Add records. The first argument is always a name. The other arguments can be:
  • rdataset...
  • ttl, rdata...
  • ttl, rdtype, string...

delete(self, name, *args)

Delete records. The first argument is always a name. The other arguments can be:
  • nothing
  • rdataset...
  • rdata...
  • rdtype, [string...]

present(self, name, *args)

Require that an owner name (and optionally an rdata type, or specific rdataset) exists as a prerequisite to the execution of the update. The first argument is always a name. The other arguments can be:
  • rdataset...
  • rdata...
  • rdtype, string...

replace(self, name, *args)

Replace records. The first argument is always a name. The other arguments can be:
  • rdataset...
  • ttl, rdata...
  • ttl, rdtype, string...
Note that if you want to replace the entire node, you should do a delete of the name followed by one or more calls to add.

to_wire(self, origin=None, max_size=65535)

Return a string containing the update in DNS compressed wire format.
Returns:
string

Generated by Epydoc 1.1 on Sat Aug 2 15:09:35 2003 http://epydoc.sf.net