Function make_query

dns/message.py:1749–1845

Make a query message. The query name, type, and class may all be specified either as objects of the appropriate type, or as strings. The query will have a randomly chosen query id, and its DNS flags will be set to dns.flags.RD. qname, a ``dns.name.Name`` or ``str``, the query

(
    qname: dns.name.Name | str,
    rdtype: dns.rdatatype.RdataType | str,
    rdclass: dns.rdataclass.RdataClass | str = dns.rdataclass.IN,
    use_edns: int | bool | None = None,
    want_dnssec: bool = False,
    ednsflags: int | None = None,
    payload: int | None = None,
    request_payload: int | None = None,
    options: List[dns.edns.Option] | None = None,
    idna_codec: dns.name.IDNACodec | None = None,
    id: int | None = None,
    flags: int = dns.flags.RD,
    pad: int = 0,
)

def make_query(
    qname: dns.name.Name | str,
    rdtype: dns.rdatatype.RdataType | str,
    rdclass: dns.rdataclass.RdataClass | str = dns.rdataclass.IN,
    use_edns: int | bool | None = None,
    want_dnssec: bool = False,
    ednsflags: int | None = None,
    payload: int | None = None,
    request_payload: int | None = None,
    options: List[dns.edns.Option] | None = None,
    idna_codec: dns.name.IDNACodec | None = None,
    id: int | None = None,
    flags: int = dns.flags.RD,
    pad: int = 0,
) -> QueryMessage:
    """Make a query message.

    The query name, type, and class may all be specified either
    as objects of the appropriate type, or as strings.

    The query will have a randomly chosen query id, and its DNS flags
    will be set to dns.flags.RD.

    qname, a ``dns.name.Name`` or ``str``, the query name.

    *rdtype*, an ``int`` or ``str``, the desired rdata type.

    *rdclass*, an ``int`` or ``str``,  the desired rdata class; the default
    is class IN.

    *use_edns*, an ``int``, ``bool`` or ``None``.  The EDNS level to use; the
    default is ``None``.  If ``None``, EDNS will be enabled only if other
    parameters (*ednsflags*, *payload*, *request_payload*, or *options*) are
    set.
    See the description of dns.message.Message.use_edns() for the possible
    values for use_edns and their meanings.

    *want_dnssec*, a ``bool``.  If ``True``, DNSSEC data is desired.

    *ednsflags*, an ``int``, the EDNS flag values.

    *payload*, an ``int``, is the EDNS sender's payload field, which is the
    maximum size of UDP datagram the sender can handle.  I.e. how big
    a response to this message can be.

    *request_payload*, an ``int``, is the EDNS payload size to use when
    sending this message.  If not specified, defaults to the value of
    *payload*.

    *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS
    options.

    *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA
    encoder/decoder.  If ``None``, the default IDNA 2003 encoder/decoder
    is used.

    *id*, an ``int`` or ``None``, the desired query id.  The default is
    ``None``, which generates a random query id.