xref: /titanic_52/usr/src/man/man7ipp/ipgpc.7ipp (revision 4a5d661a82b942b6538acd26209d959ce98b593a)
te
Copyright (c) 2004, Sun Microsystems Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
IPGPC 7IPP "Sep 29, 2004"
NAME
ipgpc - IP Generic Packet Classifier
DESCRIPTION

The IP Generic Packet Classifier (ipgpc) module provides packet classification at the Solaris IP layer. ipgpc is an implementation of the Multi-Field (MF) classifier as described in RFC2475: An Architecture for Differentiated Services.

The classifier is configured, at startup or dynamically, using a set of "filters." Filters describe selectors that are matched against input packets that are processed by the classifier. Some selectors feature exact matching data points, while others utilize non-exact or wildcard data points.

Each filter is associated with a class describing the next actions to process a packet. There is a many-to-one (M-to-1) mapping relationship between filters and a class. Additionally, each class is aware of which filters are associated with it. A class is configured with a class name and a next action.

Unlike traditional classifiers used in edge routers, ipgpc is designed for a host or server device. A host-based classifier provides access to more resources and data than edge routers. User, project, and interface information are available at the host.

STATISTICS

The ipgpc module exports global and per-class statistics (available through kstat:)

Global statistics:

module: ipgpc instance:<action id>
name: ipgpc global stats class: <action name>
 crtime
 snaptime
 nbytes <number of classified bytes>
 nclasses <number of classes>
 nfilters <number of filters>
 npackets <number of classified packets>
 epackets <number of packets in error>

Per-class statistics:

module: ipgpc instance:<action id>
name: <class name> class: <action name>
 crtime
 snaptime
 last match <time of last match>
 nbytes <number of classified bytes>
 npackets <number of classified packets>
FILES
/kernel/ipp/sparcv9/ipgpc

64-bit module (SPARC only.)

SEE ALSO

ipqosconf(1M), dlcosmk(7ipp), dscpmk(7ipp), flowacct(7ipp), ipqos(7ipp), tokenmt(7ipp), tswtclmt(7ipp)

RFC 2475, An Architecture for Differentiated Services S. Blake, D. Black, M. Carlson, E. Davies, Z. Wang, W. Weiss \(em The Internet Society, 1998