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.

SEE ALSO

Net::ACL, Net::ACL::Rule, Net::ACL::RouteMap, Net::BGP, Net::BGP::NLRI, Net::BGP::Router

AUTHOR

Martin Lorensen <bgp@martin.lorensen.dk>