1ipqos(7ipp)              IP Quality of Service Modules             ipqos(7ipp)
2
3
4

NAME

6       ipqos - IP Quality of Service
7

DESCRIPTION

9       ipqos is an implementation of the Differentiated Services model defined
10       in RFC2475: An Architecture for Differentiated Services, which  defines
11       the  following  entities:  multi-field  classifier,  meter, marker, and
12       dropper. The Solaris implementation of ipqos  adds  a  flow  accounting
13       entity.
14
15
16       These  entities can be combined into processing paths that constitute a
17       series of actions that are performed on groups of flows. The classifier
18       groups  together  flows  and  directs  them in a given processing path.
19       Classifier configuration and path construction are achieved  using  the
20       ipqosconf(1M) command.
21
22
23       A summary of the ipqos entities follows. For more information, refer to
24       the corresponding man page for each entity.
25
26       ipgpc                An implementation of the classifier defined in the
27                            model.  ipgpc  has  been  extended  and is able to
28                            select traffic based on IP header parameters, user
29                            id,  project  id,  interface name, interface group
30                            and direction.
31
32
33       tokenmt, tswtclmt    These modules implement different  metering  algo‐
34                            rithms.  tokenmt implements both RFC2697: A Single
35                            Rate Three Color Marker  and RFC 2698: A Two  Rate
36                            Three Color Marker. tswtclmt implements RFC2859: A
37                            Time Sliding Window Three Color Marker. These mod‐
38                            ules only implement the metering functions defined
39                            in the RFCs.
40
41
42       dlcosmk              A marker entity that allows  the  setting  of  the
43                            user  priority field of Ethernet frames as defined
44                            in the IEEE 802.1D specification. dlcosmk is  only
45                            available  with  VLAN capable       network inter‐
46                            faces.
47
48
49       dscpmk               A marker entity that enables the  setting  of  the
50                            Differentiated Services Code Point Value in the IP
51                            header as defined in RFC 2474: Definition  of  the
52                            Differentiated  Services  Field  (DS Field) in the
53                            IPv4 and IPv6 headers.
54
55
56       flowacct             An accounting module  that  utilizes  the  Solaris
57                            extended  accounting  facility.  flowacct logs all
58                            flows with parameters used to build a charge  back
59                            mechanism.
60
61

STATISTICS

63       ipqos  modules  export  statistics through the kstat facility. Exported
64       statistics contain the following common parameters:
65
66       module      module name
67
68
69       instance    dynamic parameter identifying a specific instance
70
71
72       name        a string  for global statistics (for example, ipgpc  global
73                   stat)  or a class name for per-class statistics for a clas‐
74                   sifier action
75
76
77
78       To verify classifier configuration, generate traffic for  each  of  the
79       configured  classes  and  check  that  the  statistic  counters for the
80       expected class are increased. If you're unsure about the parameters for
81       your traffic, you can use snoop(1M) to determine them.
82
83
84       Some  actions  have  the  instance  id of the next configured action in
85       their statistics. This instance id can be used  to  follow  the  action
86       processing  path. Instance id's -1 and -2 are the built-in actions con‐
87       tinue and drop, respectively.
88
89
90       Examples:
91
92
93       To retrieve all statistics for ipgpc:
94
95
96        kstat -m ipgpc
97
98
99       To retrieve statistics for the class http:
100
101
102        kstat -m ipgpc -c http
103

ATTRIBUTES

105       See attributes(5) for descriptions of the following attributes:
106
107
108
109
110       ┌─────────────────────────────┬───────────────────────────────────┐
111       │      ATTRIBUTE TYPE         │         ATTRIBUTE VALUE           │
112       ├─────────────────────────────┼───────────────────────────────────┤
113       │Availability                 │SUNWqos (32-bit) SUNWqosx (64-bit) │
114       └─────────────────────────────┴───────────────────────────────────┘
115

SEE ALSO

117       ipqosconf(1M),     dlcosmk(7ipp),     dscpmk(7ipp),     flowacct(7ipp),
118       ipgpc(7ipp), tokenmt(7ipp), tswtclmt(7ipp)
119
120
121       RFC  2475,  An  Architecture  for  Differentiated Services S. Blake, D.
122       Black, M. Carlson, E. Davies, Z. Wang, W. Weiss — The Internet Society,
123       1998
124
125
126       RFC 2474, Definition of the Differentiated Services Field (DS Field) in
127       the IPv4 and IPv6 Headers K. Nichols, S. Blake, F. Baker,  D.  Black  —
128       The Internet Society, 1998
129
130
131       RFC 2697, A Single Rate Three Color Marker J. Heinanen, R. Guerin — The
132       Internet Society, 1999
133
134
135       RFC 2698, A Two Rate Three Color Marker J. Heinanen, R.  Guerin  —  The
136       Internet Society, 1999
137
138
139       RFC  2859,  A Time Sliding Window Three Colour Marker (TSWTCM) W. Fang,
140       N. Seddigh, B. Nandy — The Internet Society, 2000
141
142
143
144SunOS 5.11                        25 Feb 2002                      ipqos(7ipp)