/ 
NOLookup-1.37.20
River stage zero No dependents
/ no_rdap.pl

NAME

no_rdap.pl

DESCRIPTION

Default behaviour: Uses NOLookup::RDAP::RDAPLookup to perform RDAP lookup on domain related queries and fetch and print the matching information in a textual format inspired by rdapper.

With the -w option: Uses NOLookup::RDAP::RDAPLookup::Whois to perform RDAP lookup on domain related queries and fetch and print the matching information in Norid old school whois format (rdap2whois behaviour).

USAGE

The lookup arguments can be specified by the user, and passed as a
raw argument. A raw query must be indicated with the -r option.

Otherwise the default behavious kicks in. The query type is
automagically guessed by analyzing the query, combined with
-n or -e options to resole some ambiguous cases.

perl no_rdap.pl -q <query>

Examples:

* Lookup a single object:

  - A domain:
    no_rdap.pl -q norid.no

  - A nameserver:
    no_rdap.pl -q nn.uninett.no -n 1

  - A role/host/registrar/registrant entity object:
    no_rdap.pl -q UH9R-NORID
    no_rdap.pl -q NN14H-NORID
    no_rdap.pl -q reg2-NORID -w
    no_rdap.pl -q UNA78O-NORID -e
    no_rdap.pl -q XX18091P-NORID -e

* Search for matching objects:

  - List of matching domains from a domain name or wildcard:
    no_rdap.pl -q winter.no (same as lookup of one domain)
    no_rdap.pl -q winter*.no
    no_rdap.pl -q *apartment.no

  - List of matching domains from a registrant identity:
    no_rdap.pl -q 985821585
    no_rdap.pl -q N.PRI.1234567
    no_rdap.pl -q N.ORG.1234567
    no_rdap.pl -q N.LEG.1234567

  - List of matching domains from a registrant handle:
    no_rdap.pl -q UNA78O-NORID
    no_rdap.pl -q XX18091P-NORID

  - List of matching domains from a nameserver name
    or wildcard:
    no_rdap.pl -q nn.uninett.no -n 2
    no_rdap.pl -q nn.u*.no -n 2
    no_rdap.pl -q *inett.no -n 2

  - List of matching domains from a nameserver ip:
    no_rdap.pl -q 158.38.0.181
    no_rdap.pl -q 2001:700:0:503::aa:5302

  - List of matching nameservers from a nameserver name
    wildcard:
    no_rdap.pl -q nn.uninett.no -n 1 (same as lookup of one
                                      nameserver)
    no_rdap.pl -q nn.u*.no -n 1
    no_rdap.pl -q *inett.no -n 1

  - List of matching nameservers from a nameserver ip:
    no_rdap.pl -q 158.38.0.181 -n 1
    no_rdap.pl -q 2001:700:0:503::aa:5302 -n 1

  - List of matching entities from a registrant identity:
    no_rdap.pl -q 985821585 -e
    no_rdap.pl -q N.PRI.1234567 -e
    no_rdap.pl -q N.ORG.1234567 -e
    no_rdap.pl -q N.LEG.1234567 -e

  - List of matching entities from a contact's full name or
    wildcard:
    no_rdap.pl -q 'trond haugen'
    no_rdap.pl -q 'haugen'
    no_rdap.pl -q 'trond hau*'
    no_rdap.pl -q '* haugen'

Mandatory arguments:

 -q: query, one of:
     - domain name or wildcard
     - nameserver name or wildcard (see use of -n)
     - handle, if query matches a handle (P/O/R/H/REG (D not
       supported, use domain name))
     - identity: if query is a holder identity [ 985821585 | N.{PRI|ORG|LEG}.xxxxx ], a search is
       performed to find matching domains.
     - identity: if query is a O/P holder handle, a search is
       performed to find matching domains
       if -e is set, the handle object is looked up instead
     - ip-address: lookup domains with nameservers using this ip,
       or lookup nameservers using this ip if -n is set.

  -r: The query is raw:
      A raw query is complete, and shall be used as is towards the
      RDAP backend. The http(s) part must not be included.

     
Optional arguments:

 Query options:
 -n: integer, one of:
     1: The query is a nameserver name, and a nameservers
        by nameserver name search shall be performed
     2: The query is a nameserver name, and a domains 
        by nameserver name search shall be performed
 -s: The full http(s)-address (URL) of the RDAP service (default is
     https://rdap.test.norid.no)
 -c: Do a HEAD instead of the default GET. HEAD returns no data, and
     can be used to check existence of domain etc.

 Authentication options:
 Grants access to access layer with more functionality and data
 (default is basic layer)
 -U: Basic authentication username
     For a Norid registrar RDAP user where:
     - RDAP username is     : 'rdapuser',
     - Norid registrar id is: 'reg1234'
     The basic username must be set as follows: 'rdapuser@reg1234'.
 -P: Basic authentication password

 Authentication options (for Norid usage only):
 Grants access to access layer with more functionality and data
 (default is basic layer)
 -z: Secret for access layer with higher amount of visible data
 -I: The ip address of the client UA for proper referral rate
     limiting (default is none)
 -y: Act as a Norid proxy

 Page control for searches:
 -F: Fieldset value, undef or one of the valid fieldSets
 -C: Cursor to be used in first page lookup for a search, undef for
     first page

 -p: max number of pages from cursor (1..x, default
     $RDAP_ENTITY_QUOTA_PAGES in rdap lib).
     Note on page size:
     The 'pageSize' parameter in RDAP lookup result tells the number of
     hits per page and cannot be controlled by a client.

 Various:
 -e: lookup entity instead of doing a domain search
 -o: present short result ( only when -w not set)
 -x: expand result, do additional lookups if data is truncated
 -f: force ipv4 (-f 4) or ipv6 (-f 6) connection, else use what your system picks
     Note: option added to force mode if you experience DNS/connect problems
 -l: Use terminal colors

Format for output of the result:

 -w: dump result in old style Norid whois format (default is a
     rudimentary text output inspired by rdapper)

 Other:
 -d: debug
   0  : debug off
   1  : debug output from this module
   2  : headers output from LWP UA callback
   3  : Debug output from Net::RDAP::UA (headers and contents)
   4-8: Debug output using LWP::ConsoleLogger::Easy,
        which then must be installed
 -a: activate Net::RDAP library caching
 -v: verbose: dump JSON result received from RDAP
 -h: help