        Attributes

                    The lay-out of this document is:

                    <attribute> == {basic}

    or else the attribute is defined in this document.

    If
            <attribute> == {basic}

    look for {basic} in the "Basics" file.

                    address
                    -------

                    Full postal address of a person.

    <address> == {free text}

                    admin-c
                    -------

                    An on-site contact (person)

    <admin-c> == {auto-nic-assign} | {nic-handle} | {name}

                    advisory
                    --------

                    Advises a specific `target' autonomous system (AS)
                    to use the information that is defined in this
                    attribute.

                    <ASnnnn> <AS specific information>

    <ASnnnn> == <aut-num> == {aut-num}
    <AS specific information> == not defined in code; see ripe-131.
    <AS specific information> == defined by the operator of ASnnnn
    <AS specific information> == <1 or more of any type of character>

                    as-exclude
                    ----------

                    A list of transit ASes from which all routes will be
                    ignored.

                    exclude <aut-num> to <exclude-route-keyword>

    exclude == `exclude'
    <aut-num> == {aut-num}
    to == `to'
    <exclude-route-keyword> == [ <aut-num> | <as-macro> | <community> | ANY ]
    ANY == `ANY'

                    as-in
                    -----

                    Description of policy for route acceptance.

                    from <aut-num> <cost> accept <routing policy expres-
                    sion>

    from == `from'
    <aut-num> == <aut-num>
    <cost> == {cost}
    accept == `accept'
    <routing policy expression> == ({askeyword} | <netlist>) <brackets> | <braces>
    <netlist> == {netlist}
    <brackets> == {brackets}
    <braces> == {braces}

                    as-list
                    -------

                    The list of ASes or other AS macros that make up an
                    AS Macro.

                    <aut-num> <as-macro> ...

    <aut-num> == {aut-num}
    <as-macro> == {as-macro}

                    as-macro
                    --------

                    The identifier of a macro containing at least two
                    Autonomous Systems.

                    AS-<string> where <string> consists of uppercase
                    leters only.

    <as-macro> == `AS-'(1 or more `A'...`Z')

                    as-name
                    -------

                    A descriptive name associated with an AS.

                    Uppercase letters, dashes ("-") and digits, no
                    spaces.  Must start with a letter.  "." and "_"
                    will be converted into "-".

    <as-name> == {netname}

                    as-out
                    ------

                    Description of policy for route announcement.

                    to <aut-num> announce <routing policy expression>

    to == `to'
    <aut-num> == {aut-num}
    announce == `announce'
    <routing policy expression> == ({brackets}|{braces}) (`{' {netlist} `}') | \
                                    {askeyword}

                    as-transit
                    ----------

                    The transit preferences of an AS.

                    transit <ASpath> to <destination>

    transit == `transit'
    <ASpath> == <ASpath>  # not defined in the code
    to == `to'
    <destination> == <destination>  # not defined in the code

                    aut-num
                    -------

                    The autonomous system number.  This must be a
                    uniquely allocated autonomous system number from an
                    AS registry (e.g.RIPE NCC, the Inter-NIC, etc).

                    "AS"<positive integer between 1 and 65535>

    <aut-num> == {aut-num}

                    aut-sys
                    -------

                    This attribute is OBSOLETE.

                    auth
                    ----

                    Scheme to be used to authenticate update requests.

    <auth> == ({auth_NONE} | {auth_MAIL-FROM} | {auth_CRYPT-PW})

                    author
                    ------

                    Limerick author (i.e. author of a Limerick, not an
                    author from Limerick :-D )

    <author> == ({auto-nic-assign} | {nic-handle} | {name})

                    authority
                    ---------

                    The formal authority for a community. This could be
                    an organisation, institute, committee, etc.

    <authority> == (1 or more [`a'..`z', `A'..`Z', 0..9, `-', ` ', `,',
                    `\', `(', `)', `/'])

                    bdry-gw
                    -------

                    This attribute is OBSOLETE.

                    bdrygw-l
                    --------

                    List of boundary gateways.

                    Obsolete in the inetnum object.

                    bis
                    ---

                    This is the `boundary intermediate system'
                    attribute.

    <bis> == {CLNS prefix} or {CLNS prefix} {CLNS prefix}

                    changed
                    -------

                    Who previously changed this object and when this
                    change was made.

                    <RFC822 e-mail address> <DATE> E-mail address of
                    person updating the object.  DATE in YYYYMMDD or
                    YYMMDD format.

    <changed> == {RFC-822 address} {DATE}

                    comm-list
                    ---------

                    A list or 1 or more communities of which a route is
                    part.

                    <community object> <community object> ...

    <community object> == <community>

                    community

                    Name of a community.

                    Uppercase text which cannot start with a routing
                    policy expression keyword.

    <community> == {community}

                    connect

                    This attribute is OBSOLETE

                    country
                    --------

                    Name of the country of the admin-c.

                    2 letter uppercase ISO 3166 country code.

    <country> == <member of the country code list>
    <member of the country code list> == <[`A'..`Z'][`A'..`Z']>

                    default
                    -------

                    There are two uses of this attribute; (a) with the
                    dom-prefix (CLNS) object; (b) with the aut-num (AS)
                    object:

    dom-prefix (CLNS) object:
    ------------------------
                    <CLNS prefix>

    aut-num (AS) object:
    -------------------

                    <aut-num> <relative cost> <default-expression>
                    <default-expression> is optional.

    <aut-num> == {aut-num}
    <relative cost>  == <cost> == {cost} == <positive, non-zero integer>
    <default-expression> == (`static' | `default' |{netlist})

                    descr
                    -----

                    A short description of this object.

                    All characters possible.

                    <descr> == {free text}

                    dom-in
                    ------

                    <boundary intermediate system> <preference cost>
                    <CLNS keyword>

    <boundary intermediate system> == {CLNS prefix}
    <preference cost> == {cost} == (positive, non-zero integer)

    <CLNS keyword> == ({CLNS prefix} |ANY|AND|OR|NOT| `(' | `)'

                    dom-name
                    --------

                    The IP domain name for a ConnectionLess Network Ser-
                    vice object.

                    Fully qualified domain name without trailing "."

    <dom-name> == <domain name>

                    dom-net
                    -------

                    List of IP networks in a domain.

                    Dotted quad including trailing 0's.

    <dom-net> == {net number}

                    dom-out
                    -------

                    dom-out attribute

                    <boundary intermediate system> <routing policy
                    expression>

    <boundary intermediate system> == <CLNS prefix>
    <routing policy expression> ==
            < <aut-num> | <KEYWORD> | <community> | <as-macro> | <netlist> >

                    dom-prefix
                    ----------

                    <CLNS prefix>

                    domain
                    ------

                    IP domain name.

                    Full qualified domain name without trailing ".".

    <domain> == {domain name}

                    e-mail
                    ------

                    The e-mail address of a person or role.

                    RFC-822 address.
    <e-mail> == {RFC-822 address}

                    fax-no
                    ------

                    The fax number of a person or role

                    + <Country Code> <Area Code> <Fax Number>
                    + <Country Code><Area Code & Number><extension>

    <fax-no> == {phone number}

                    gateway
                    -------

                    This attribute is OBSOLETED

                    guardian
                    --------

                    This attribute functions as a "notify" attribute.

    <guardian> == {RFC-822 address}

                    hole
                    ----

                    Indicates the parts of the address space covered to
                    which the originator does not provide connectivity.

                    Classless prefix length representation.  <IP num-
                    ber>/<prefix length>

    <hole> == {IP number}/{prefix length}

    <IP number> == <quad>.<quad>.<quad>.<quad>
    <quad> == 0 <= X <= 255
    <prefix length> == 0 <= X <= 32

                    ias-int
                    -------

                    OBSOLOETED

                    NONE

                    ifaddr
                    ------

                    An interface address within an internet router.

                    <Interface Address> <Interface Subnet Mask>

    <ifaddr> == {Interface Address} {Interface Subnet Mask}

    <Interface Address> == {IP address}

                    inet-rtr
                    --------

                    Fully qualified domain name of an internet router.

                    Fully qualified domain name without trailing "."

    <inet-rtr> == <domain name>

                    inet6num
                    --------

                    Full IP version 6 address.

                    <ip6num>/<prefix length>

                    inetnum
                    -------

                    A range of IP address space.

                    x.x.x.x - x.x.x.x, where 0 =< x =< 255

    <inetnum> == {inetnum range} or {inetnum prefix}/{inetnum length}

                    interas-in
                    ----------

                    Incoming local preferences on an inter-AS connec-
                    tion.

                    from <aut-num> <local-rid> <neighbour-rid> <prefer-
                    ence> accept <routing policy expression>

    <interas-in> == from <aut-num> <local-rid> <neighbour-rid> \
                    <preference> accept <routing policy expression>

    from == `from'
    <aut-num> == <aut-num>
    accept == `accept'
    <local-rid> == <IP address>
    <neighbour-rid> == <IP address>
    <preference> == <cost> == <positive, non-zero integer>
    accept == `accept'
    <routing policy expression> ==
                    < <aut-num> | <KEYWORD> | <community> | <as-macro> | <netlist> >

                    interas-out

                    Outgoing local preferences on an inter-AS connec-
                    tion.

                    to <aut-num> <local-rid> <neighbour-rid> [<metric>]
                    announce <routing policy expression> <metric> is
                    optional and is defined as: (<metric-type>=<value>)

    to == `to'
    <aut-num> == <aut-num>
    <local-rid> == <IP address>
    <neighbour-rid> == <IP address>
    [<metric>] == optional <metric>
    <metric> == `(metric-out=)'<metric value>
    <metric value> == [`IGP'| 1 or more dec dgt]
    announce == `announce'
    <routing policy expression> == <routing policy expression>

                    limerick
                    --------

                    Title of a limerick.

                    LIM-<string>, where string can include alphanumeric
                    characters, "-" character.

    <limerick> == `LIM-'(0 or more [a..z,A..Z,0..9,`-'])

                    localas
                    -------

                    The autonomous system in which a router belongs.

                    AS<positive integer between 1 and 65535>.

    <localas> == <aut-num>

                    location
                    --------

                    This attribute is OBSOLETE

                    maintainer
                    ----------

                    This attribute is OBSOLETE.

                    mnt-by
                    ------

                    The identifier of a registered mntner object used
                    for authorization and authentication.

                    <mntner>

    <mnt-by> == (1 or more [`A'..`Z', 0..9, `-'])

                    mnt-lower
                    ---------

    <mnt-lower> == (1 or more [`A'..`Z', 0..9, `-'])

                    The identifier of a registered mntner object used
                    for hierarchical authorization and authentication.

                    <mntner>

                    mnt-nfy
                    -------

                    The e-mail address to be notified when an object
                    protected by a mntner is successfully updated.

                    RFC-822 address.

    <mnt-nfy> == {RFC-822 address}

                    mntner
                    ------

                    The name of a mntner object.  Must be an unique mnt-
                    ner name, but can be identical to AS names, nic-han-
                    dles.

                    <uppercase letter><uppercase alphanumeric, "-">

    <mntner> == ([`A'..`Z'])(0 or more [`A'..'Z', 0..9, `-'])

                    netname
                    -------

                    The name of a range of IP address space.

    <netname> == {netname}

                    nic-hdl
                    -------

                    The NIC handle of a role or person object.  This can
                    be a RIPE NIC-handle or a NIC-handle assigned by
                    other regional registries.

                    RIPE NIC-handle: <Initials><0-999>-RIPE

    <nic-hdl> == {NIC-handle}

                    notify
                    ------

                    The e-mail address to which notifications of changes
                    to an object should be sent.

                    <RFC-822 address>

    <notify> == {RFC-822 address}

                    nserver
                    ------

                    List of nameservers for a domain object; a minimum
                    of two is mandatory .

                    <Fully qualified domain name(s) without trailing
                    "."> OR <IP Address(es) of the nameserver(s)>

    <nserver> == {domain-name}  OR <nservIP-addr>

    <nservIP-addr> ==
    ( <nservIP-element>.<nservIP-element>.<nservIP-element>.<nservIP-element> )
    <nservIP-element> == ([0..9] 0 or more [0..9])

    #
    # N.B. this definition of an IP address is not as strict as other definitions

                    nsf-in
                    ------

                    This attribute is OBSOLETE

                    nsf-out
                    -------

                    This attribute is not used.

                    Obsolete

                    op-fax
                    ------

                    Fax Number

                    + <Country Code><Area Code><Fax Number> Optional:
                    spaces may be used to split up the number into its
                    constituent components.  "." characters can also be
                    used to separate the digits.

    <op-fax> == {phone number}

                    op-mail
                    -------

                    E-mail address of a person or role object

                    <RFC-822 address>

    <op-mail> == <RFC-822 address>

                    op-phone
                    --------

                    Telephone number

                    + <Country Code><Area Code><Phone Number> + <Country
                    Code><Area Code><Phone Number> <ext.> <number>
                    Optional: spaces may be used to split up the number
                    into its constituent components.  "." characters can
                    also be used to separate the digits.

    <op-phone> == <phone number>

                    origin
                    ------

                    The autonomous system announcing a route.

                    AS<positive integer between 1 and 65535>

    <origin> == <aut-num>

                    peer
                    ----

                    Details of any (interior or exterior) router peer-
                    ings.

                    <Peer address> <Peer AS> <Routing Protocol> [Local
                    AS] [Local AS] is optional.

    <peer> == <Peer address> <Peer AS> <Routing Protocol> [<Local AS>]
    <Peer address> == <IP address>
    <Peer AS> == <aut-num>

    #
    # Code is strange; if it finds "pe", it checks for the optional
    # `localas' string.  If it finds `localas', it only checks the
    # optional part, and does not do a syntax check on <Peer address>,
    # <Peer AS> etc.
    #

                    person
                    ------

                    The full name of an adminstrative, technical or zone
                    contact person specified in another object.  Do not
                    use titles such as "Dr.", "Prof.", "Mv.", "Ms.",
                    "Mr.", etc.

                    <Personal Name> <Family Name> where each name is
                    composed of alphabetic characters.

    <person> != {nic-handle}
    <person> == {Name}{Name} ... {Name}
    #
    # Number of <Name> is defined in the configuration file;
    # now, it is 2
    #

    <Name> != `AUTO-'
    <Name> cannot include <Titles>
    <Titles> == ([mr|ms|mrs|dr|drs||ir|ing|sign|herr|hr|frau|prof]`.')
    <Name> == (At least two characters, neither can be the `.' character)
    <Name> == !(`AUTO-') && <Name-part-1><Name-part-2>
    <Name-part-1> == ([`a'..`z', `A'..`Z'])
    <Name-part-2> == (0 or more [alphanumeric, `-', `.', `|', "`", "'" ])

                    phone
                    -----

                    Telephone number

                    + <Country Code><Area Code><Phone Number> + <Country
                    Code><Area Code><Phone Number> ext. <number>
                    Optional: spaces may be used to split up the phone
                    number into its constituent components.  "." charac-
                    ters can also be used between to separate the dig-
                    its.

    <phone> == <phone number>

                    remarks
                    -------

                    General remarks.  Can include an URL or RFC822
                    address (if preceeded by mailto:).

    <remarks> == {free text}

                    rev-srv
                    -------

                    Domain name server for a range of IP addresses.

                    Fully qualified name without trailing "."
    <rev-srv> == {domain name}

                    role
                    ----

                    The full name of a role entity e.g. RIPE DBM.

                    Two components, each consisting of alphabetic char-
                    acters.  Note: there is no "-" character between the
                    two components of the the name.

    <role> != `AUTO-'
    <role> cannot be a NIC-handle
    <role> != <NIC-handle>
    <role> == {person}

                    rout-pr
                    -------

                    Routing privilages attribute.

                    Uppercase letters, digits or "-" characters.

    <rout-pr> == ( 1 or more [`A'..`Z', 0..9, `-'] )

                    route
                    -----

                    A route being anounced.

                    Classless prefix length representation.  <IP num-
                    ber>/<prefix length>
    <route> == (1 or more [0..9, `.']) or

    <route> == {inetnum prefix}/{inetnum length}
    <route> == {inetnum range}

                    routpr-l
                    --------

                    This attribute is OBSOLETE

                    source
                    ------

                    Identifier of the database containing authoritative
                    data for this object.  Use RIPE for objects in the
                    RIPE Database.

                    Uppercase Text.

    <source> == defined in configuration file as DBFILE and CANUPD

                    status
                    ------

                    Type of allocated or assigned address space.

                    Uppercase Text.

    <status> == ([`D'(`ELEGATED')|`ASSIGNED '(`PA'|`PI') |
                    `ALLOCATED '(`PI'|`PA'|`UNSPECIFIED')] )

                    sub-dom
                    -------

                    List of the sub-domains of a domain

                    <Relative domain name to the domain>

    <sub-dom> == <domain name>

                    tech-c
                    ------

                    A technical contact.

                    <NIC-handle>

    <tech-c> == <NIC-handle> or <person> or <role>

                    text
                    ---

                    Must be humourous, but not malicious or insulting.
                    :-)

    <text> == {free text}

                    trouble
                    -------

                    Information on who to contact when there are prob-
                    lems.

    <text> == {free text}

                    upd-to
                    ------

                    The e-mail address to be notified when an object
                    protected by a mntner is unsuccessfully updated.

                    RFC-822 address

    <upd-to> == {RFC-822 address}

                    withdrawn
                    ---------

                    Indicates who withdrew a route and the date.

                    <RFC822 e-mail address> <DATE> E-mail address of
                    person withdrawing the route.  DATE in YYYYMMDD or
                    YYMMDD format.

    <withdrawn> == {RFC-822 address} {DATE}

                    zone-c
                    ------

                    NIC-handle of the person with authority over a zone.

                    <NIC-handle>

    <zone-c> == <NIC-handle> or <person> or <role>