dnspython  1.16.0
About: dnspython is a DNS toolkit (for Python 2.x) that supports almost all record types.
  Fossies Dox: dnspython-1.16.0.tar.gz  ("inofficial" and yet experimental doxygen-generated source code documentation)  

HIP.py
Go to the documentation of this file.
1 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
2 
3 # Copyright (C) 2010, 2011 Nominum, Inc.
4 #
5 # Permission to use, copy, modify, and distribute this software and its
6 # documentation for any purpose with or without fee is hereby granted,
7 # provided that the above copyright notice and this permission notice
8 # appear in all copies.
9 #
10 # THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES
11 # WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 # MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR
13 # ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
16 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 
18 import struct
19 import base64
20 import binascii
21 
22 import dns.exception
23 import dns.rdata
24 import dns.rdatatype
25 
26 
28 
29  """HIP record
30 
31  @ivar hit: the host identity tag
32  @type hit: string
33  @ivar algorithm: the public key cryptographic algorithm
34  @type algorithm: int
35  @ivar key: the public key
36  @type key: string
37  @ivar servers: the rendezvous servers
38  @type servers: list of dns.name.Name objects
39  @see: RFC 5205"""
40 
41  __slots__ = ['hit', 'algorithm', 'key', 'servers']
42 
43  def __init__(self, rdclass, rdtype, hit, algorithm, key, servers):
44  super(HIP, self).__init__(rdclass, rdtype)
45  self.hit = hit
46  self.algorithm = algorithm
47  self.key = key
48  self.servers = servers
49 
50  def to_text(self, origin=None, relativize=True, **kw):
51  hit = binascii.hexlify(self.hit).decode()
52  key = base64.b64encode(self.key).replace(b'\n', b'').decode()
53  text = u''
54  servers = []
55  for server in self.servers:
56  servers.append(server.choose_relativity(origin, relativize))
57  if len(servers) > 0:
58  text += (u' ' + u' '.join((x.to_unicode() for x in servers)))
59  return u'%u %s %s%s' % (self.algorithm, hit, key, text)
60 
61  @classmethod
62  def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True):
63  algorithm = tok.get_uint8()
64  hit = binascii.unhexlify(tok.get_string().encode())
65  if len(hit) > 255:
66  raise dns.exception.SyntaxError("HIT too long")
67  key = base64.b64decode(tok.get_string().encode())
68  servers = []
69  while 1:
70  token = tok.get()
71  if token.is_eol_or_eof():
72  break
73  server = dns.name.from_text(token.value, origin)
74  server.choose_relativity(origin, relativize)
75  servers.append(server)
76  return cls(rdclass, rdtype, hit, algorithm, key, servers)
77 
78  def to_wire(self, file, compress=None, origin=None):
79  lh = len(self.hit)
80  lk = len(self.key)
81  file.write(struct.pack("!BBH", lh, self.algorithm, lk))
82  file.write(self.hit)
83  file.write(self.key)
84  for server in self.servers:
85  server.to_wire(file, None, origin)
86 
87  @classmethod
88  def from_wire(cls, rdclass, rdtype, wire, current, rdlen, origin=None):
89  (lh, algorithm, lk) = struct.unpack('!BBH',
90  wire[current: current + 4])
91  current += 4
92  rdlen -= 4
93  hit = wire[current: current + lh].unwrap()
94  current += lh
95  rdlen -= lh
96  key = wire[current: current + lk].unwrap()
97  current += lk
98  rdlen -= lk
99  servers = []
100  while rdlen > 0:
101  (server, cused) = dns.name.from_wire(wire[: current + rdlen],
102  current)
103  current += cused
104  rdlen -= cused
105  if origin is not None:
106  server = server.relativize(origin)
107  servers.append(server)
108  return cls(rdclass, rdtype, hit, algorithm, key, servers)
109 
110  def choose_relativity(self, origin=None, relativize=True):
111  servers = []
112  for server in self.servers:
113  server = server.choose_relativity(origin, relativize)
114  servers.append(server)
115  self.servers = servers
dns.rdtypes.ANY.HIP.HIP.algorithm
algorithm
Definition: HIP.py:46
dns.exception.SyntaxError
Definition: exception.py:113
dns.rdtypes.ANY.HIP.HIP.to_text
def to_text(self, origin=None, relativize=True, **kw)
Definition: HIP.py:50
dns.name.from_text
def from_text(text, origin=root, idna_codec=None)
Definition: name.py:873
dns.rdtypes.ANY.HIP.HIP.__init__
def __init__(self, rdclass, rdtype, hit, algorithm, key, servers)
Definition: HIP.py:43
dns.name.from_wire
def from_wire(message, current)
Definition: name.py:945
dns.rdtypes.ANY.HIP.HIP.hit
hit
Definition: HIP.py:45
dns.rdtypes.ANY.HIP.HIP.key
key
Definition: HIP.py:47
dns.rdtypes.ANY.HIP.HIP
Definition: HIP.py:27
dns.rdtypes.ANY.HIP.HIP.from_text
def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True)
Definition: HIP.py:62
dns.rdata
Definition: rdata.py:1
dns.rdatatype
Definition: rdatatype.py:1
dns.rdtypes.ANY.HIP.HIP.servers
servers
Definition: HIP.py:48
dns.rdtypes.ANY.HIP.HIP.from_wire
def from_wire(cls, rdclass, rdtype, wire, current, rdlen, origin=None)
Definition: HIP.py:88
dns.rdtypes.ANY.HIP.HIP.to_wire
def to_wire(self, file, compress=None, origin=None)
Definition: HIP.py:78
dns.rdtypes.ANY.HIP.HIP.choose_relativity
def choose_relativity(self, origin=None, relativize=True)
Definition: HIP.py:110
dns.exception
Definition: exception.py:1
dns.rdata.Rdata
Definition: rdata.py:95