Query Options Flags

Query Options

There are two different sets of query flags that can be used to query the RADB. whois.radb.net supports queries with both types of flags.

! RADB Query Flags
- RIPE Query Flags

In any one query you cannot combine a RIPE flag with a RADB flag.

If you plan on making a large number of queries please invoke a persistent tcp/ip session. This is done by telneting directly to whois.radb.net and issuing the !! command. This will spare our server having to establish and teardown connections for every query.


    [darkstar ~]$ telnet whois.radb.net 43
    Connected to whois.radb.net.
    Escape character is '^]'.
    %  No entries found for the selected source(s).
    descr:        MERIT Network Inc.
    descr:        4251 Plymouth Rd
    descr:        Ann Arbor
    descr:        MI 48105-2785, USA
    origin:       AS237
    mnt-by:       MAINT-AS237
    changed:      har@merit.edu 20001115
    source:       SAVVIS
    Connection closed by forExample host.
    [darkstar ~]$

IRRd specific commands:

    !g Get routes with specified origin.

    % whois -h whois.radb.net '\!gas237'

    !6  Get IPv6 routes with specified origin. e.g., !6as1234. This is the
    IPv6 equivalent of the '!g' command.

    !i  Return members of an as-set or route-set. Optionally,
        recursively expand members of all sets within the named set.
            !iAS-ESNETEU  # non-recursive, don't expand
                          # any embedded as-set's
            !iAS-ESNETEU,1   # expand any embedded as-set's
            !iRS-FOOBAR,1    # recusive expansion of a route-set

    !j  performs distributed checks on database synchronization.
        This command makes it possible to view the mirror status
        (oldest journal number, CURRENTSERIAL) for a database.
        If a : is present after the range, the database was last
        exported at that serial number.    For example:
        !j-*                # Show all databases
        Y means that the database is mirrorable.
        N means that the database is not mirrorable, but the
        local IRRd server is reporting the current serial number.
        You can use this option to check for updates. The first
        number will _always_ be zero. The second number may be
        zero if the CURRENTSERIAL file doesn't exist.
        X means that the database doesn't exist, or the local
        server is denying information about an existing database
        for administrative reasons.
        Returned databases are canonicalized to upper case.

    !m  Match an object of the specified type with the specified
        key. Return immediately after first match.
            Example, !maut-num,as701       #lookup aut-num object
            Example, !mmntner,maint-as237  #lookup mntner object

    !n  Identify the tool for statistics/logging purposes.
            Example, !nRoe

    !o  Display all objects maintained by a given mntner name.
            Example, !oMAINT-AS237

    !q  Quit the IRRd session.
        Example, !q

    !r  Perform route searches.
        Default finds exact prefix/len match.
        o - return origin of exact match(es)
        l - one-level less specific
        L - all less specific
        M - all more specific
            Example, !r141.211.128/24,l

    !s  Set the sources to the specified list.
        Default is all sources.
        Default search order is the order in which sources are
        configured in the irrd-conf file.
            Example, !sradb,ripe,savvis
        lc - show the currently selected sources
            Example, !s-lc

    !v  Provide the IRRd version number.
            Example, !v

RIPE specific commands we support

    -s  Set the sources to the specified list.
        Example -s radb

    -m  First level more specifics of a route object
        Example: -m

    -M  All level more specifics of a route object
        Example: -M

    -l  First level less spefics of a route object
        Example -l

    -L  All levels less specfics of a route object
        Example -L

    -i mnt-by   Find objects associated(mnt-by) a specified maintainer
        Example -i mnt-by MAINT-AS237

    -i origin   Find objects with a specified origin AS
        Example: -i origin AS237

    -t  Show the template for specified object type
        Example: -t route

    -k  Establish a persistent connection
        Like the !! command, this prevents the closure
        of the connection after the initial query

    -K  Return only primary key for specified object
        Example: -K MAINT-AS237

    -T  Return only objects of specified type
        Example:  -T route

    -g  for mirroring purposes

Back to Tutorials