filter-template

Required Command-Line Mode = Configure

Use the filter-template command to configure filter templates on GigaVUE‑HC3 and GigaVUE-TA100.

For more information on filter templates, refer to the “Flexible Filter Templates” section in the GigaVUE Fabric Management Guide.

The filter-template command has the following syntax:

filter-template alias <alias>
   
comment <comment>
   qualifiers <add | remove> <ethertype | innervlan | ip6dst | ip6src | ipdst | ipsrc | macdst | macsrc |
      portdst | portsrc | protocol | qset1 | uda1 | uda2 | vlan>

The following table describes the arguments for the filter-template command:

Argument

Description

alias <alias>

Supplies an alias for the filter template. The maximum number of characters supported in an alias is 128. Each alias should be unique across the configured filter templates.

An alias can be created only after a filter template is defined with one or more qualifiers.

An alias cannot contain the forward slash (/) character.

comment <comment>

Specifies a unique text string that describes the filter template. Comments can be up to 256 characters. Comments must be enclosed in double quotation marks.

Comments can be added only after a filter template is defined by specifying an alias and adding one or more qualifiers.

For example:

(config) # filter-template alias ft1 comment “UDA filter”

qualifiers <add | remove> <ethertype |
   innervlan | ip6dst | ip6src | ipdst | ipsrc |
   macdst | macsrc | portdst | portsrc | protocol |
   qset1 | uda1 | uda2 | vlan>

Specifies a list of qualifiers for the filter template. The qualifiers are predefined.

The list of qualifiers can consist of one or more qualifiers separated by a space. Specify each qualifier only once. Duplicate qualifiers are not allowed in the list.

Examples:

(config) # filter-template alias ft1 qualifiers add uda1 uda2

(config) # filter-template alias ipv6+mac qualifiers add ip6src ip6dst macsrc macdst

(config) # filter-template alias ft2 qualifiers add innervlan vlan

Note:  The uda2 qualifier cannot be specified without the uda1 qualifier. However, the uda1 qualifier can be specified with or without the uda2 qualifier.

After a filter template is created, it can be applied to a module. Refer to card (GigaVUE H Series).

When a filter template is not applied to a line card or module, it can be modified. Qualifiers can be added or removed.

For example, to add qualifiers to an existing filter template:

(config) # filter-template alias ft1 qualifiers add vlan

For example, to remove qualifiers from an existing filter template:

(config) # filter-template alias ft1 qualifiers remove uda2

Related Commands

The following table summarizes other commands related to the filter-template command:

Task

Command

Displays all filter templates in table format.

show filter-template

Displays a specified filter template.

show filter-template alias filt1

Displays a specified filter template in brief format.

show filter-template alias filt1 brief

Displays all filter templates, including default and user-defined templates.

show filter-template all

Displays limits of all filter templates in table format.

show filter-template limit

Displays limits of all filter templates for GigaVUE nodes. A zero (0) means not supported.

show filter-template limit all

Displays limits of the filter templates on the specified box ID.

show filter-template limit box 1

Displays limits of the filter templates on the specified slot ID.

show filter-template limit slot 2

Displays filter resource usage.

show filter-resource

Displays filter resource usage in detail.

show filter-resource all

Displays filter resource usage in detail for a specified box ID.

show filter-resource box-id 1

Displays filter resource usage in detail for a specified slot ID.

show filter-resource slot-id 3

Displays filter resource usage in detail for a specified slot ID on a GigaVUE-TA100.

show filter-resource slot-id 1/1PS1

Displays all app filter resource usage in detail.

show app-filter-rsc

Displays all app filter resource usage in detail.

show app-filter-rsc all

Displays app filter resource usage in detail for a specified box ID.

show app-filter-rsc box-id 3

Displays all app filter resource usage in brief format.

show app-filter-rsc brief

Displays app filter resource usage in detail for a specified slot ID.

show app-filter-rsc slot-id 4

Displays app filter resource usage in detail for a specified slot ID on a GigaVUE-TA100.

show app-filter-rsc slot-id 1/1PS1

Displays pseudo-slot port mapping on GigaVUE-TA100.

show pseudo-slot portmap

Displays pseudo-slot port mapping on GigaVUE-TA100 for a specified box ID.

show pseudo-slot portmap box-id 3

Deletes a specified unused filter template. If the filter template has been applied to a module, it will not be deleted and an error message will be displayed.

(config) # no filter-template alias filt1

Deletes all unused filter templates. If any filter templates have been applied to a module, they will not be deleted and an error message will be displayed.

(config) # no filter-template all