Common Open Policy Service (COPS) Protocol

Created

  • 2000-11

Last Updated

  • 2012-09-28

Available Formats

Client Types Values

Reference

  • RFC 2748: The COPS (Common Open Policy Service) Protocol

Note

Client-type values in the range 0x4000 - 0x7FFF are reserved for Private Use as defined in RFC 8126. These Client-types are not tracked by IANA and are not to be used in standards or general-release products, as their uniqueness cannot be assured.

Available Formats

Range Registration Procedures Notes
0x0 IETF Review Defined by RFC4261
0x001-0x3FF Specification Required COPS extension document required
0x4000-0x7FFF Reserved Private Use
0x8000-0xFFFF First Come First Served

Client-type Values (0x0001-0x3FFF)

Available Formats

Value Name PIB Module Description Reference
1 COPS Usage for RSVP RFC 2749
2 diffServ dsPolicyPib DiffServ QoS, DIFFSERV-PIB RFC 3317

Client-Type Values (0x8000-0xFFFF)

Available Formats

Value Name PIB Module Description Reference
0x8001 IP Highway Shai Herzog
0x8002 IP Highway Shai Herzog
0x8003 IP Highway Shai Herzog
0x8004 IP Highway Shai Herzog
0x8005 Fujitsu Application Server Software Division Tetsuharu Hanada
0x8006 HP OpenView PolicyXpert Brian O'Keefe
0x8007 HP OpenView PolicyXpert COPS-PR PXPIB Brian O'Keefe
0x8008 PacketCable Dynamic Quality of Service Jason Gaedtke
0x8009 go3gppPib go3gppPib COPS usage for 3GPP GO interface ftp://ftp.3gpp.org/specs/Specs/archive/29_series/29.207/
0x800a PacketCable Multimedia [http://www.packetcable.com/specifications/multimedia.html]
0x800b Juniper Networks John Scano
0x800c ITUT-RwPIB ITUT-RwPIB Q.3303.1 (Rw interface) COPS alternative ITU-T Recommendation Q.3303.1
0x800d ITUT-RcPIB ITUT-RcPIB Q.3304.1 (Rc interface) COPS alternative ITU-T Recommendation Q.3304.1

C-Num and C-Type Values

Registration Procedure(s)

  • IETF Review

Reference

  • RFC 2748: The COPS (Common Open Policy Service) Protocol

Available Formats

c-num c-type Description Reference
0x01 0x01 Handle RFC 2748
0x02 0x01 Context RFC 2748
0x03 0x01 In-Interface, IPv4 RFC 2748
0x03 0x02 In-Interface, IPv6 RFC 2748
0x04 0x01 Out-Interface, IPv4 RFC 2748
0x04 0x02 Out-Interface, IPv6 RFC 2748
0x05 0x01 Reason RFC 2748
0x06 0x01 Decision, Flags RFC 2748
0x06 0x02 Decision, Stateless Data RFC 2748
0x06 0x03 Decision, Replacement Data RFC 2748
0x06 0x04 Decision, Client Specific Decision Data RFC 2748
0x06 0x05 Decision, Named Decision Data RFC 2748
0x07 0x01 LPDP Decision, Flags RFC 2748
0x07 0x02 LPDP Decision, Stateless Data RFC 2748
0x07 0x03 LPDP Decision, Replacement Data RFC 2748
0x07 0x04 LPDP Decision, Client Specific Decision Data RFC 2748
0x07 0x05 LPDP Decision, Named Decision Data RFC 2748
0x08 0x01 Error RFC 2748
0x09 0x01 Client Specific Information, Signaled RFC 2748
0x09 0x02 Client Specific Information, Named RFC 2748
0x0A 0x01 Keep-Alive Timer RFC 2748
0x0B 0x01 PEP Identification RFC 2748
0x0C 0x01 Report-Type RFC 2748
0x0D 0x01 PDP Redirect Address, IPv4 + TCP Port RFC 2748
0x0D 0x02 PDP Redirect Address, IPv6 + TCP Port RFC 2748
0x0E 0x01 Last PDP Address, IPv4 + TCP Port RFC 2748
0x0E 0x02 Last PDP Address, IPv6 + TCP Port RFC 2748
0x0F 0x01 Accounting Timer RFC 2748
0x10 0x01 Message Integrity RFC 2748
0x10 0x02 Message Integrity, Integrity-TLS RFC 4261

R-Types, Reason-Codes, Report-Types, Decision Object Command-Codes/Flags, and Error-Codes

Registration Procedure(s)

  • IETF Review

Reference

  • RFC 2748: The COPS (Common Open Policy Service) Protocol

R-Types

Available Formats

R-Type Description Reference
0x01 Incoming-Message/Admission Control request RFC 2748
0x02 Resource-Allocation request RFC 2748
0x04 Outgoing-Message request RFC 2748
0x08 Configuration request RFC 2748

Reason-Codes

Available Formats

Reason-Code Description Reference
1 Unspecified RFC 2748
2 Management RFC 2748
3 Preempted RFC 2748
4 Tear RFC 2748
5 Timeout RFC 2748
6 Route Change RFC 2748
7 Insufficient Resources RFC 2748
8 PDP's Directive RFC 2748
9 Unsupported decision RFC 2748
10 Synchronize Handle Unknown RFC 2748
11 Transient Handle RFC 2748
12 Malformed Decision RFC 2748
13 Unknown COPS Object RFC 2748

Report-Types

Available Formats

Report-Type Description Reference
1 Success RFC 2748
2 Failure RFC 2748
3 Accounting RFC 2748

Decision Object Command-Codes

Available Formats

Command-Code Description Reference
0 NULL Decision RFC 2748
1 Install RFC 2748
2 Remove RFC 2748

Decision Object Flags

Available Formats

Decision-Flag Description Reference
0x01 Trigger Error RFC 2748
0x02 Request-State RFC 3084

Error Codes

Available Formats

Error-Code Description Reference
1 Bad handle RFC 2748
2 Invalid handle reference RFC 2748
3 Bad message format RFC 2748
4 Unable to process RFC 2748
5 Mandatory client-specific info missing RFC 2748
6 Unsupported client-type RFC 2748
7 Mandatory COPS object missing RFC 2748
8 Client Failure RFC 2748
9 Communication Failure RFC 2748
10 Unspecified RFC 2748
11 Shutting down RFC 2748
12 Redirect to Preferred Server RFC 2748
13 Unknown COPS Object RFC 2748
14 Authentication Failure RFC 2748
15 Authentication Required RFC 2748

M-Types, Reason Sub-Codes, and Error Sub-codes

Registration Procedure(s)

  • Values are assigned relative to the respective Client-type

Reference

  • RFC 2748: The COPS (Common Open Policy Service) Protocol
No registrations at this time.

Client-type = 0 Flags and Error-SubCodes

Registration Procedure(s)

  • IETF Review

Reference

  • RFC 4261: Common Open Policy Service (COPS) Over Transport Layer Security (TLS)

Available Formats

Error-Code Error-SubCode Octet 2 Error-SubCode Octet 3 Description Reference
15 16 0 No security RFC 4261
15 16 2 Integrity-TLS supported/preferred RFC 4261

Flags

Registration Procedure(s)

  • IETF Review

Reference

  • RFC 4261: Common Open Policy Service (COPS) Over Transport Layer Security (TLS)

Available Formats

Value Flag Reference
0x01 StartTLS RFC 4261

COPS-PR Object S-Num, S-Types, and Error-Codes

Registration Procedure(s)

  • IETF Review

Reference

  • RFC 3084: COPS Usage for Policy Provisioning (COPS-PR)

Note

Additional COPS-PR RFC 3084 Object S-Num, S-Types, and Error-Codes MAY be defined for use with future COPS-PR Client-types, but such additions require IETF Review as defined in RFC 8126.

Available Formats

s-num s-type val Description (s-num, s-type) Reference
0x01 0x01 Complete PRID, BER RFC 3084
0x02 0x01 Prefix PRID, BER RFC 3084
0x03 0x01 EPD, BER RFC 3084
0x04 0x01 GPERR, BER RFC 3084
0x05 0x01 CPERR, BER RFC 3084
0x06 0x01 ErrorPRID, BER RFC 3084
0x02 Reserved for transport of XML encoded data RFC 3084

Global Provisioning Error (GPERR) (s-num=4, s-type=1)

Registration Procedure(s)

  • IETF Review

Reference

  • RFC 3084: COPS Usage for Policy Provisioning (COPS-PR)

Available Formats

Value Name Reference
1 availMemLow RFC 3084
2 availMemExhausted RFC 3084
3 unknownASN.1Tag RFC 3084
4 maxMsgSizeExceeded RFC 3084
5 unknownError RFC 3084
6 maxRequestStatesOpen RFC 3084
7 invalidASN.1Length RFC 3084
8 invalidObjectPad RFC 3084
9 unknownPIBData RFC 3084
10 unknownCOPSPRObject RFC 3084
11 malformedDecision RFC 3084

Class-Specific Provisioning Error (CPERR) (s-num=5, s-type=1)

Registration Procedure(s)

  • IETF Review

Reference

  • RFC 3084: COPS Usage for Policy Provisioning (COPS-PR)

Available Formats

Value Name Reference
1 priSpaceExhausted RFC 3084
2 priInstanceInvalid RFC 3084
3 attrValueInvalid RFC 3084
4 attrValueSupLimited RFC 3084
5 attrEnumSupLimited RFC 3084
6 attrMaxLengthExceeded RFC 3084
7 attrReferenceUnknown RFC 3084
8 priNotifyOnly RFC 3084
9 unknownPrc RFC 3084
10 tooFewAttrs RFC 3084
11 invalidAttrType RFC 3084
12 deletedInRef RFC 3084
13 priSpecificError RFC 3084

P-types

Reference

  • RFC 2750: RSVP Extensions for Policy Control

Available Formats

Range Registration Procedures Note
0-49151 IETF Review
49152-53247 First Come First Served Vendor-specific
53248-65535 Reserved for Private Use
P-Type Description Reference
0x01 PREEMPTION_PRI RFC 3181
0x02 AUTH_USER RFC 3182
0x03 AUTH_APP RFC 3182
0x04 AUTH_SESSION RFC 3520
0x05 ADMISSION_PRI RFC 6401
0x06 APP_RESOURCE_PRI RFC 6401
0x07 REC_PROXY_CONTROL RFC 5946

AUTH_SESSION X-Types (0x04)

Reference

  • RFC 3520: Session Authorization Policy Element

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
X-Type Description Reference
0 Reserved
1 AUTH_ENT_ID RFC 3520
2 SESSION_ID RFC 3520
3 SOURCE_ADDR RFC 3520
4 DEST_ADDR RFC 3520
5 START_TIME RFC 3520
6 END_TIME RFC 3520
7 RESOURCES RFC 3520
8 AUTHENTICATION_DATA RFC 3520
9-127 Unassigned
128-255 Reserved

AUTH_ENT_ID (X-Type 1) SubType values

Reference

  • RFC 3520: Session Authorization Policy Element

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 IPV4_ADDRESS RFC 3520
2 IPV6_ADDRESS RFC 3520
3 FQDN RFC 3520
4 ASCII_DN RFC 3520
5 UNICODE_DN RFC 3520
6 URI RFC 3520
7 KRB_PRINCIPAL RFC 3520
8 X509_V3_CERT RFC 3520
9 PGP_CERT RFC 3520
10-127 Unassigned
128-255 Reserved

SOURCE_ADDR (X-Type 3) SubType values

Reference

  • RFC 3520: Session Authorization Policy Element

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 IPV4_ADDRESS RFC 3520
2 IPV6_ADDRESS RFC 3520
3 UDP_PORT_LIST RFC 3520
4 TCP_PORT_LIST RFC 3520
5-127 Unassigned
128-255 Reserved

DEST_ADDR (X-Type 4) SubType values

Reference

  • RFC 3520: Session Authorization Policy Element

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 IPV4_ADDRESS RFC 3520
2 IPV6_ADDRESS RFC 3520
3 UDP_PORT_LIST RFC 3520
4 TCP_PORT_LIST RFC 3520
5-127 Unassigned
128-255 Reserved

START_TIME (X-Type 5) SubType values

Reference

  • RFC 3520: Session Authorization Policy Element

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 NTP_TIMESTAMP RFC 3520
2-127 Unassigned
128-255 Reserved

END_TIME (X-Type 6) SubType values

Reference

  • RFC 3520: Session Authorization Policy Element

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 NTP_TIMESTAMP RFC 3520
2-127 Unassigned
128-255 Reserved

RESOURCES (X-Type 7) SubType values

Reference

  • RFC 3520: Session Authorization Policy Element

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 BANDWIDTH RFC 3520
2 FLOW_SPEC RFC 3520
3 SDP RFC 3520
4 DSCP RFC 3520
5-127 Unassigned
128-255 Reserved

A-types

Reference

  • RFC 3182: Identity Representation for RSVP

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
A-Type Description Reference
0 Reserved
1 POLICY_LOCATOR RFC 3182
2 CREDENTIAL RFC 3182
3 DIGITAL_SIGNATURE RFC 3182
4 POLICY_ERROR_OBJECT RFC 3182
5-127 Unassigned
128-255 Reserved

POLICY_LOCATOR (A-Type 1) SubType values

Reference

  • RFC 3182: Identity Representation for RSVP

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 ASCII_DN RFC 3182
2 UNICODE_DN RFC 3182
3 ASCII_DN_ENCRYPT RFC 3182
4 UNICODE_DN_ENCRYPT RFC 3182
5-127 Unassigned
128-255 Reserved

CREDENTIAL (A-Type 2) SubType values

Reference

  • RFC 3182: Identity Representation for RSVP

Available Formats

Range Registration Procedures
0-127 IETF Review
128-255 Private Use
SubType Description Reference
0 Reserved
1 ASCII_ID RFC 3182
2 UNICODE_ID RFC 3182
3 KERBEROS_TKT RFC 3182
4 X509_V3_CERT RFC 3182
5 PGP_CERT RFC 3182
6-127 Unassigned
128-255 Reserved

POLICY_ERROR_CODE ErrorValues (A-Type 4)

Reference

  • RFC 3182: Identity Representation for RSVP

Available Formats

Range Registration Procedures
0-32767 IETF Review
32768-65535 Private Use
ErrorValue Description Reference
0 Reserved
1 ErrorValue ERROR_NO_MORE_INFO RFC 3182
2 UNSUPPORTED_CREDENTIAL_TYPE RFC 3182
3 INSUFFICIENT_PRIVILEGES RFC 3182
4 EXPIRED_CREDENTIAL RFC 3182
5 IDENTITY_CHANGED RFC 3182
6-32767 Unassigned
32768-65535 Reserved

Merge Strategies

Reference

  • RFC 6401: RSVP Extensions for Admission Priority

Available Formats

Range Registration Procedures
0-127 IETF Review
128-240 First Come First Served
Value Description Reference
0 Reserved RFC 6401
1 Take priority of highest QoS RFC 3181; RFC 6401
2 Take highest priority RFC 3181; RFC 6401
3 Force Error on heterogenous merge RFC 3181; RFC 6401
4-240 Unassigned
241-255 Reserved for Private Use RFC 6401

ADMISSION_PRI (P-Type 0x05) Error Codes

Reference

  • RFC 6401: RSVP Extensions for Admission Priority

Available Formats

Range Registration Procedures
0-127 IETF Review
128-240 First Come First Served
Value Description Reference
0 NO_ERROR Value used for regular ADMISSION_PRI elements RFC 6401
1 Reserved RFC 6401
2 HETEROGENEOUS This element encountered heterogeneous merge RFC 6401
3-240 Unassigned
241-255 Reserved for Private Use RFC 6401

Receiver Proxy Control Policy Element (P-Type 0x07) Control-Value field

Reference

  • RFC 5946: Resource Reservation Protocol (RSVP) Extensions for Path-Triggered RSVP Receiver Proxy

Available Formats

Range Registration Procedures
0-127 IETF Review
128-240 First Come First Served
Value Description Reference
0 Reserved RFC 5946
1 Receiver-Proxy-Needed RFC 5946
2 Receiver-Proxy-Not-Needed RFC 5946
3-240 Unassigned
241-255 Reserved for Private Use RFC 5946

Contact Information

Name Contact URI Last Updated
Brian O'Keefe brian_okeefe&hp.com 2001-05
Jason Gaedtke j.gaedtke&cablelabs.com 2001-12
John Scano jscano&juniper.net 2005-01
Shai Herzog herzog&policyconsulting.com 1999-11
Tetsuharu Hanada hanada&pc.fujitsu.com 2000-12