2022-01-24 04:07:52 +00:00
|
|
|
# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
|
|
|
|
|
|
|
|
import contextlib
|
|
|
|
import struct
|
2024-03-03 17:15:23 +00:00
|
|
|
from typing import Iterator, Optional, Tuple
|
2022-01-24 04:07:52 +00:00
|
|
|
|
|
|
|
import dns.exception
|
|
|
|
import dns.name
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
|
2022-01-24 04:07:52 +00:00
|
|
|
class Parser:
|
2024-03-03 17:15:23 +00:00
|
|
|
def __init__(self, wire: bytes, current: int = 0):
|
2022-01-24 04:07:52 +00:00
|
|
|
self.wire = wire
|
|
|
|
self.current = 0
|
|
|
|
self.end = len(self.wire)
|
|
|
|
if current:
|
|
|
|
self.seek(current)
|
|
|
|
self.furthest = current
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def remaining(self) -> int:
|
2022-01-24 04:07:52 +00:00
|
|
|
return self.end - self.current
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_bytes(self, size: int) -> bytes:
|
|
|
|
assert size >= 0
|
2022-01-24 04:07:52 +00:00
|
|
|
if size > self.remaining():
|
|
|
|
raise dns.exception.FormError
|
2024-03-03 17:15:23 +00:00
|
|
|
output = self.wire[self.current : self.current + size]
|
2022-01-24 04:07:52 +00:00
|
|
|
self.current += size
|
|
|
|
self.furthest = max(self.furthest, self.current)
|
|
|
|
return output
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_counted_bytes(self, length_size: int = 1) -> bytes:
|
|
|
|
length = int.from_bytes(self.get_bytes(length_size), "big")
|
2022-01-24 04:07:52 +00:00
|
|
|
return self.get_bytes(length)
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_remaining(self) -> bytes:
|
2022-01-24 04:07:52 +00:00
|
|
|
return self.get_bytes(self.remaining())
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_uint8(self) -> int:
|
|
|
|
return struct.unpack("!B", self.get_bytes(1))[0]
|
2022-01-24 04:07:52 +00:00
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_uint16(self) -> int:
|
|
|
|
return struct.unpack("!H", self.get_bytes(2))[0]
|
2022-01-24 04:07:52 +00:00
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_uint32(self) -> int:
|
|
|
|
return struct.unpack("!I", self.get_bytes(4))[0]
|
2022-01-24 04:07:52 +00:00
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_uint48(self) -> int:
|
|
|
|
return int.from_bytes(self.get_bytes(6), "big")
|
2022-01-24 04:07:52 +00:00
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_struct(self, format: str) -> Tuple:
|
2022-01-24 04:07:52 +00:00
|
|
|
return struct.unpack(format, self.get_bytes(struct.calcsize(format)))
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def get_name(self, origin: Optional["dns.name.Name"] = None) -> "dns.name.Name":
|
2022-01-24 04:07:52 +00:00
|
|
|
name = dns.name.from_wire_parser(self)
|
|
|
|
if origin:
|
|
|
|
name = name.relativize(origin)
|
|
|
|
return name
|
|
|
|
|
2024-03-03 17:15:23 +00:00
|
|
|
def seek(self, where: int) -> None:
|
2022-01-24 04:07:52 +00:00
|
|
|
# Note that seeking to the end is OK! (If you try to read
|
|
|
|
# after such a seek, you'll get an exception as expected.)
|
|
|
|
if where < 0 or where > self.end:
|
|
|
|
raise dns.exception.FormError
|
|
|
|
self.current = where
|
|
|
|
|
|
|
|
@contextlib.contextmanager
|
2024-03-03 17:15:23 +00:00
|
|
|
def restrict_to(self, size: int) -> Iterator:
|
|
|
|
assert size >= 0
|
2022-01-24 04:07:52 +00:00
|
|
|
if size > self.remaining():
|
|
|
|
raise dns.exception.FormError
|
|
|
|
saved_end = self.end
|
|
|
|
try:
|
|
|
|
self.end = self.current + size
|
|
|
|
yield
|
|
|
|
# We make this check here and not in the finally as we
|
|
|
|
# don't want to raise if we're already raising for some
|
|
|
|
# other reason.
|
|
|
|
if self.current != self.end:
|
|
|
|
raise dns.exception.FormError
|
|
|
|
finally:
|
|
|
|
self.end = saved_end
|
|
|
|
|
|
|
|
@contextlib.contextmanager
|
2024-03-03 17:15:23 +00:00
|
|
|
def restore_furthest(self) -> Iterator:
|
2022-01-24 04:07:52 +00:00
|
|
|
try:
|
|
|
|
yield None
|
|
|
|
finally:
|
|
|
|
self.current = self.furthest
|