NAME

Net::ACL::RouteMapRule - Class representing a BGP-4 policy route-map rule

SYNOPSIS

    use Net::ACL::RouteMapRule;

    # Constructor
    $rule = new Net::ACL::RouteMapRule(
        Action  => ACL_PERMIT,
        Match   => {
                ASPath          => [ 'my-as-path-list' ],
                Community       => [ 'my-community-list' ],
                Prefix          => [ 'my-prefix-list' ],
                Next_hop        => [ 'my-access-list' ],
                Routesource     => [ 'my-access-list' ],
                MED             => 20,
                Local_Pref      => 200,
                Origin          => IGP
                },
        Set     => {
                ASPath          => [ 65001, 65001 ],  # Prepend
                Community       => [ qw( 65001:100 65001:200 ) ],
                Next_hop        => '10.0.0.1',
                Local_Pref      => 200,
                MED             => 50,
                Origin          => EGP,
                Weight          => 42
                }
        );

    # Accessor Methods
    ($rc,$nlri) = $rule->query($prefix, $nlri);
    $rc = $rule->match($prefix, $nlri);

DESCRIPTION

This module represents a single route-map clause with a match part, a set part and an action. This object is used by the Net::ACL::RouteMap object. It inherits from Net::ACL::Rule, with the only changed method being the autoconstructor() method.

CONSTRUCTOR

new() - create a new Net::ACL::RouteMapRule object: The method is inherited from the Net::ACL::Rule object. But since the autoconstruction() method has been replaced, some extra named arguments below Match and Set are understood:

ASPath: When used in Match, the ASPath named argument should be a name of an ASPath access-lists.
When used in Set, it should be the AS numbers that should be prepended. They may be specified in anyway that the Net::BGP:ASPath->new() constructor allows them.
Community: When used in Match, the Community named argument should be a community-list.
When used in Set, it should be a list of communities to set.
Prefix: The Prefix named argument can only be used under Match. It's value should be a list of Net::ACL prefix-list names.
Next_hop: When used under Match, its value should be a list of names of access-lists.
When used under Set, its value should be an IP address.
Routesource: The Routesource named argument can only be used under Match. It's value should be a list of Net::ACL access-list names.
Origin: The Origin named argument should have a value of either IGP, EGP or INCOMPLETE, as exported by Net::BGP::NLRI ":origin".
Local_Pref
MED
Weight: The Local_Pref, MED and Weight named argument should have values of integers.
Weight can only be used in Set.

ACCESSOR METHODS

query()
match(): The query() and match() methods take a Net::BGP::NLRI object as first argument and a prefix as second, but does and return the same as the match() and query() methods of the Net::ACL::Rule object.

AUTHOR