mask

Function

The mask command sets the aggregate mask length.

The undo mask command deletes the aggregate mask length.

By default, masks of entries in a FIB table are used for stream aggregation.

Format

mask { source | destination } minimum mask-length

undo mask { source | destination }

Parameters

Parameter	Description	Value
source	Indicates the source mask, which is used in prefix, prefix-ToS, source-prefix, or source-prefix-ToS aggregation mode.	-
destination	Indicates the destination mask, which is used in prefix, prefix-ToS, destination-prefix, or destination-prefix-ToS aggregation mode.	-
minimum mask-length	Specifies the aggregate mask length.	The value is an integer. For statistics about IPv4 aggregated flows, the value ranges from 1 to 32. The default value is 24. For statistics about IPv6 aggregated flows, the value ranges from 1 to 128. The default value is 64.

Parameter

Description

Value

source

Indicates the source mask, which is used in prefix, prefix-ToS, source-prefix, or source-prefix-ToS aggregation mode.

destination

Indicates the destination mask, which is used in prefix, prefix-ToS, destination-prefix, or destination-prefix-ToS aggregation mode.

minimum mask-length

Specifies the aggregate mask length.

The value is an integer.

For statistics about IPv4 aggregated flows, the value ranges from 1 to 32. The default value is 24.
For statistics about IPv6 aggregated flows, the value ranges from 1 to 128. The default value is 64.

Views

IPv6 NetStream aggregation view, NetStream aggregation view

Default Level

3: Management level

Task Name and Operations

Task Name	Operations
netstream	write

Usage Guidelines

Usage Scenario

The aggregate mask can be configured only in the destination-prefix, destination-prefix-ToS, prefix, prefix-ToS, source-prefix, and source-prefix-ToS aggregation modes.

A higher mask between the mask in the FIB table and the configured mask takes effect. If no aggregate mask is set, you can aggregate flows based on the mask in the FIB table.

Configuration Impact

Setting the aggregate mask defines the granularity for collected NetStream statistics:

Increasing an aggregate mask length enables a device to collect refined NetStream statistics.
Decreasing an aggregate mask length enables a device to collect summary NetStream statistics.

Example

# Set the mask length in the source-prefix aggregation mode to 25.

<HUAWEI> system-view
[~HUAWEI] ip netstream aggregation source-prefix
[*HUAWEI-aggregation-srcpre] mask source minimum 25