name action_name | Assigns a name to the action. |
module module_name | Identifies the IPQoS module to be invoked, which must be one of the modules in Table 37-5. |
params_clause | Can be parameters for the classifier to process, such as global statistics or the next action to process. |
cf_clauses | A set of zero or more class clauses or filter clauses |
Module Definitions
The module definition indicates which module is to process the parameters in the action statement. The IPQoS configuration file can include the following modules.
Table 37-5 IPQoS Modules
Module Name | Definition |
---|---|
ipgpc | IP classifier |
dscpmk | Marker to be used to create DSCPs in IP packets |
dlcosmk | Marker to be used with VLAN devices |
tokenmt | Token bucket meter |
tswtclmt | Time-sliding window meter |
flowacct | Flow-accounting module |
class Clause
You define a class clause for each class of traffic.
Use this syntax to define the remaining classes in the IPQoS configuration:
class { name class-name next_action next-action-name } |
To enable statistics collection on a particular class, you must first enable global statistics in the ipgpc.classify action statement. For more information, refer to action Statement.
Use the enable_stats TRUE statement whenever you want to turn on statistics collection for a class. If you do not need to gather statistics for a class, you can specify enable_stats FALSE. Alternatively, you can eliminate the enable_stats statement.
Traffic on an IPQoS-enabled network that you do not specifically define is relegated to the default class.
filter Clause
Filters are made up of selectors that group traffic flows into classes. These selectors specifically define the criteria to be applied to traffic of the class that was created in the class clause. If a packet matches all selectors of the highest-priority filter, the packet is considered to be a member of the filter's class. For a complete list of selectors that you can use with the ipgpc classifier, refer to Table 37-1.
You define filters in the IPQoS configuration file by using a filter clause, which has the following syntax:
filter { name filter-name class class-name parameters (selectors) } |
params Clause
The params clause contains processing instructions for the module that is defined in the action statement. Use the following syntax for the params clause:
params { parameters params-stats | "" } |
In the params clause, you use parameters that are applicable to the module.
The params-stats value in the params clause is either global_stats TRUE or global_stats FALSE. The global_stats TRUE instruction turns on UNIX style statistics for the action statement where global statistics is invoked. You can view the statistics by using the kstat command. You must enable action statement statistics before you can enable per-class statistics.
ipqosconf Configuration Utility
You use the ipqosconf utility to read the IPQoS configuration file and to configure IPQoS modules in the UNIX kernel. ipqosconf performs the following actions:
Applies the configuration file to the IPQoS kernel modules (ipqosconf -a filename)
Lists the IPQoS configuration file currently resident in the kernel (ipqosconf -l)
Ensures that the current IPQoS configuration is read and applied each time the machine reboots (ipqosconf -c)
Flushes the current IPQoS kernel modules (ipqosconf -f)
For technical information, refer to the ipqosconf(1M) man page.