VhvF.ddlmZmZmZeZdZdZdZddl m Z ddl m Z ddl mZddlmZdd lZ dd lZdd lZdd lZdd lZdd lZdd lmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-d Z.eZ0d Z1Gdde Z2y #e/$rd Z.YwxYw))absolute_importdivisionprint_functiona_ name: dig author: Jan-Piet Mens (@jpmens) short_description: query DNS using the dnspython library requirements: - dnspython (python library, http://www.dnspython.org/) description: - The dig lookup runs queries against DNS servers to retrieve DNS records for a specific name (FQDN - fully qualified domain name). It is possible to lookup any DNS record in this manner. - There is a couple of different syntaxes that can be used to specify what record should be retrieved, and for which name. It is also possible to explicitly specify the DNS server(s) to use for lookups. - In its simplest form, the dig lookup plugin can be used to retrieve an IPv4 address (DNS A record) associated with FQDN. - In addition to (default) A record, it is also possible to specify a different record type that should be queried. This can be done by either passing-in additional parameter of format qtype=TYPE to the dig lookup, or by appending /TYPE to the FQDN being queried. - If multiple values are associated with the requested record, the results will be returned as a comma-separated list. In such cases you may want to pass option C(wantlist=true) to the lookup call, or alternatively use C(query) instead of C(lookup), which will result in the record values being returned as a list over which you can iterate later on. - By default, the lookup will rely on system-wide configured DNS servers for performing the query. It is also possible to explicitly specify DNS servers to query using the @DNS_SERVER_1,DNS_SERVER_2,...,DNS_SERVER_N notation. This needs to be passed-in as an additional parameter to the lookup. options: _terms: description: Domain(s) to query. type: list elements: str qtype: description: - Record type to query. - V(DLV) has been removed in community.general 6.0.0. - V(CAA) has been added in community.general 6.3.0. type: str default: 'A' choices: - A - ALL - AAAA - CAA - CNAME - DNAME - DNSKEY - DS - HINFO - LOC - MX - NAPTR - NS - NSEC3PARAM - PTR - RP - RRSIG - SOA - SPF - SRV - SSHFP - TLSA - TXT flat: description: If 0 each record is returned as a dictionary, otherwise a string. type: int default: 1 retry_servfail: description: Retry a nameserver if it returns SERVFAIL. default: false type: bool version_added: 3.6.0 fail_on_error: description: - Abort execution on lookup errors. - The default for this option will likely change to V(true) in the future. The current default, V(false), is used for backwards compatibility, and will result in empty strings or the string V(NXDOMAIN) in the result in case of errors. default: false type: bool version_added: 5.4.0 real_empty: description: - Return empty result without empty strings, and return empty list instead of V(NXDOMAIN). - The default for this option will likely change to V(true) in the future. - This option will be forced to V(true) if multiple domains to be queried are specified. default: false type: bool version_added: 6.0.0 class: description: - Class. type: str default: 'IN' tcp: description: Use TCP to lookup DNS records. default: false type: bool version_added: 7.5.0 port: description: Use port as target port when looking up DNS records. default: 53 type: int version_added: 9.5.0 notes: - V(ALL) is not a record in itself, merely the listed fields are available for any record results you retrieve in the form of a dictionary. - While the plugin supports anything which C(dnspython) supports out of the box, only a subset can be converted into a dictionary. - If you need to obtain the AAAA record (IPv6 address), you must specify the record type explicitly. Syntax for specifying the record type is shown in the examples below. - The trailing dot in most of the examples listed is purely optional, but is specified for completeness/correctness sake. a - name: Simple A record (IPV4 address) lookup for example.com ansible.builtin.debug: msg: "{{ lookup('community.general.dig', 'example.com.')}}" - name: "The TXT record for example.org." ansible.builtin.debug: msg: "{{ lookup('community.general.dig', 'example.org.', qtype='TXT') }}" - name: "The TXT record for example.org, alternative syntax." ansible.builtin.debug: msg: "{{ lookup('community.general.dig', 'example.org./TXT') }}" - name: use in a loop ansible.builtin.debug: msg: "MX record for gmail.com {{ item }}" with_items: "{{ lookup('community.general.dig', 'gmail.com./MX', wantlist=true) }}" - name: Lookup multiple names at once ansible.builtin.debug: msg: "A record found {{ item }}" loop: "{{ query('community.general.dig', 'example.org.', 'example.com.', 'gmail.com.') }}" - name: Lookup multiple names at once (from list variable) ansible.builtin.debug: msg: "A record found {{ item }}" loop: "{{ query('community.general.dig', *hosts) }}" vars: hosts: - example.org. - example.com. - gmail.com. - ansible.builtin.debug: msg: "Reverse DNS for 192.0.2.5 is {{ lookup('community.general.dig', '192.0.2.5/PTR') }}" - ansible.builtin.debug: msg: "Reverse DNS for 192.0.2.5 is {{ lookup('community.general.dig', '5.2.0.192.in-addr.arpa./PTR') }}" - ansible.builtin.debug: msg: "Reverse DNS for 192.0.2.5 is {{ lookup('community.general.dig', '5.2.0.192.in-addr.arpa.', qtype='PTR') }}" - ansible.builtin.debug: msg: "Querying 198.51.100.23 for IPv4 address for example.com. produces {{ lookup('dig', 'example.com', '@198.51.100.23') }}" - ansible.builtin.debug: msg: "XMPP service for gmail.com. is available at {{ item.target }} on port {{ item.port }}" with_items: "{{ lookup('community.general.dig', '_xmpp-server._tcp.gmail.com./SRV', flat=0, wantlist=true) }}" - name: Retry nameservers that return SERVFAIL ansible.builtin.debug: msg: "{{ lookup('community.general.dig', 'example.org./A', retry_servfail=true) }}" a _list: description: - List of composed strings or of dictionaries, with fields depending on query type. type: list elements: raw contains: ALL: description: - C(owner), C(ttl), C(type). A: description: - C(address). AAAA: description: - C(address). CAA: description: - C(flags). - C(tag). - C(value). version_added: 6.3.0 CNAME: description: - C(target). DNAME: description: - C(target). DNSKEY: description: - C(flags), C(algorithm), C(protocol), C(key). DS: description: - C(algorithm), C(digest_type), C(key_tag), C(digest). HINFO: description: - C(cpu), C(os). LOC: description: - C(latitude), C(longitude), C(altitude), C(size), C(horizontal_precision), C(vertical_precision). MX: description: - C(preference), C(exchange). NAPTR: description: - C(order), C(preference), C(flags), C(service), C(regexp), C(replacement). NS: description: - C(target). NSEC3PARAM: description: - C(algorithm), C(flags), C(iterations), C(salt). PTR: description: - C(target). RP: description: - C(mbox), C(txt). SOA: description: - C(mname), C(rname), C(serial), C(refresh), C(retry), C(expire), C(minimum). SPF: description: - C(strings). SRV: description: - C(priority), C(weight), C(port), C(target). SSHFP: description: - C(algorithm), C(fp_type), C(fingerprint). TLSA: description: - C(usage), C(selector), C(mtype), C(cert). TXT: description: - C(strings). ) AnsibleError) LookupBase)boolean)DisplayN)AAAAACAACNAMEDNAMEDNSKEYDSHINFOLOCMXNAPTRNS NSEC3PARAMPTRRPSOASPFSRVSSHFPTLSATXTTFc itdgtdgtgdtdgtdgt gdt gdtddgtgdtd d gtgd tdgtgd tdgtd dgtgdt dgt"gdt$gdt&gdt(dgi}i}|j*|vr3||j*}|D]}|j-|}t/|t0j2j4r)t0j2j4j7|}|j*t k(r>|dk(r9t0j8j;|j<j?dd}|j*t k(r|dk(r tA|}|j*t k(r>|dk(r9t0j8jC|jDj?dd}|j*tk(r>|dk(r9t0j8j;|jFj?dd}|j*t$k(r>|dk(r9t0j8j;|jHj?dd}|j*t&k(r>|dk(r9t0j8j;|jJj?dd}|||<!|S)a While the 'dig' lookup plugin supports anything which dnspython supports out of the box, the following supported_types list describes which DNS query types we can convert to a dict. Note: adding support for RRSIG is hard work. :) address)flagstagvaluetarget)r! algorithmprotocolkey)r% digest_typekey_tagdigestcpuos)latitude longitudealtitudesizehorizontal_precisionvertical_precision preferenceexchange)orderr3r!serviceregexp replacement)r%r! iterationssaltmboxtxt)mnamernameserialrefreshretryexpireminimumstrings)priorityweightportr$)r%fp_type fingerprint)usageselectormtypecertr* r%r'r:rIrM)&r r r r rrrrrrrrrrrrrrrrrrdtype__getattribute__ isinstancednsnameNameto_textrdata_hexifyr*replaceint _base64ifyr'r:rIrM)rWsupported_typesrdfieldsfvals h/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/lookup/dig.pymake_rdata_dictrb s I; yk & z  z  9  = t} h \: & S XJ @ hZ VUO" R#$ i[%& 5 6 4 i[-O2 B ||& . A((+C#sxx}}-hhmm++C0||r!a8mii'' 5==c2F||v%!{*:#h||v%!u*ii**5995==c2F||z)a6kii'' 3;;CD||u$m);ii''(9(9:BB3K||t#V ii'' 3;;CDBqE' * IceZdZddZy) LookupModuleNc tdur td|j||tjj d}d}|j dtjj|g}g}|jd }|jd } |jd } |jd } |jd } |jd} tjj|jd}|jd|_ |D]E}|jdrC|ddjd}|D])} t!j"||j%|+Xd|vr |jdd\}}d k(rj+}n|d k(r t-} nn|dk(r! tjj}nH|dk(rt/|_ n2|d k(r t/} n!|d k(r t/} n|d k(r t/}  d|vr( |jd\}}|j%|5|j%|H| r| |_t3|dkDr||_|j+dk(rJg}|D]A} tj6j9|}|j%|j;C|}t3|dkDrd} g}|D]} |j'|||| }|D]}|j;}|j+dk(r|dd}| r|j%|? tA|}|jBj;|d<tjDj;|jF|d<|jHjJ|d <tjj;|jL|d<|j%| |S#t$r}td|d}~wwxYw#t$rb tjj'|dj(}|j%|n#t$r}td|d}~wwxYwYCwxYw#t$rY wxYw#t$r}td|d}~wwxYw#t$r|j%|YwxYw#tj<j>$rYdt$r}td|d}~wwxYw#t$r5}| rtd!||j%tO|Yd}~Ed}~wwxYw#tjjP$r.}| rtd!|| s|j%d"Yd}~d}~wtjjRtjjTtjjVf$r.}| rtd!|| s|j%d#Yd}~+d}~wtj<jX$r}td$|d}~wwxYw)%a terms contains a string with things to `dig' for. We support the following formats: example.com # A record example.com qtype=A # same example.com/TXT # specific qtype example.com qtype=txt # same 192.0.2.23/PTR # reverse PTR ^^ shortcut for 23.2.0.192.in-addr.arpa/PTR example.net/AAAA @nameserver # query specified server ^^^ can be comma-sep list of names/addresses ... flat=0 # returns a dict; default is 1 == string FzNThe dig lookup requires the python 'dnspython' library and it is not installed) var_optionsdirectT) configureir) ednsflagspayloadqtypeflat fail_on_error real_emptytcprGclasszdns lookup illegal CLASS: Nretry_servfail@,zdns lookup NS: =/rz$dns.reversename unhandled exception )rdclassrprownertypettlzLookup failed: NXDOMAINrOz!dns.resolver unhandled exception )-HAVE_DNSr set_optionsrSresolverResolveruse_ednsr!DO get_option rdataclass from_text Exceptionrr startswithsplitsocket inet_atonappendqueryr upperrZrrGlen nameservers reversename from_addressrV exception SyntaxErrorrbcanonical_name rdatatyperPrrsetr|rxstrr}NoAnswerTimeout NoNameservers DNSException)selfterms variableskwargsmyres edns_sizedomainsrrlrmrnrorprGrxetnssetnsnsaddroptargdomainreversed_domainsnretanswersrWsr]errs rarunzLookupModule.runOs u op p Yv> %%%5  qCIILL)D (v&8 __\2 ooe$v& Ann..tw/GHG $/?@2 "A||C !" C( FBF((,#**2. Fax wwsAHC'>IIKEF]s8DG^M"%..":":3"?,,+23)>u||)LBvJ(/ (9(9BuI*-..*@*@*OBwKJJrN1# NJ k A!;A3?@ @ A%FF%(\\%7%7%;A%>%F%FF'..v6(F"./D"EEF7F!%M*-Gs+KLLM"!&NN1%&$}}00 S&)MaS'QRRS8 )1,&2_SE3J&K KJJs3x001 <<(( + &'>??!JJz*LL))3<<+?+?A[A[\ # &'>??!JJrN==-- N"%Fse#LMM Ns .P &P*RR(4%S(>S(AU'B*T&U' P'P""P'* R4=Q21R2 R ;R R RR R%$R%( S1R??SS%$S%(T#T#TT#& U$/*UU'U$$U''Y#V--AY#X)) Y YY)N)__name__ __module__ __qualname__rrcrarereMsYrcre)3 __future__rrrr{ __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.errorsransible.plugins.lookupr)ansible.module_utils.parsing.convert_boolransible.utils.displayr r dns.exceptionrSdns.name dns.resolverdns.reversenamedns.rdataclass dns.rdatatyper r r r rrrrrrrrrrrrrrrrrr~ ImportErrordisplayrbrerrcrars CB i V1 fM ^(-=)  ddddddH )9B[:[QHsAB BB