[Search] [txt|ps|pdf|bibtex] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: 00 01                                                         
Internet Draft                                               Shai Herzog
Expiration: Oct. 1997                                          IPHighway
File: draft-ietf-rsvp-policy-oops-01.txt
                                                    Dimitrios Pendarakis
                                                              Raju Rajan
                                                             Roch Guerin
                                         IBM T.J. Watson Research Center



            Open Outsourcing Policy Service (OOPS) for RSVP



                                07/30/97

Status of Memo

   This document is an Internet-Draft.  Internet-Drafts are working
   documents of the Internet Engineering Task Force (IETF), its areas,
   and its working groups.  Note that other groups may also distribute
   working documents as Internet-Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   To learn the current status of any Internet-Draft, please check the
   "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow
   Directories on ds.internic.net (US East Coast), nic.nordu.net
   (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific
   Rim).

Abstract

   This document describes a protocol for exchanging policy information
   and decisions between an RSVP-capable router (client) and a policy
   server. The OOPS protocol supports a wide range of router
   configurations and RSVP implementations, and is compatible with the
   RSVP Extensions for Policy Control [Ext].











Shai Herzog et al.       Expiration: Oct. 1997                  [Page 1]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


1. Overview Reservation protocols function by discriminating between
   users by providing some users with better service at the expense of
   others.  The utility of reservation protocols is sharply degraded in
   the absence of mechanisms for restricting access to higher service
   categories and enforcing network and bandwidth usage criteria. In
   this document, we refer to such mechanisms as "policy control". This
   term is quite broad; it ranges from simple access control to
   sophisticated accounting and debiting mechanisms.

   The policy control component may reside fully within the router (as
   an add-on module to RSVP). However, it is often advantageous for
   routers to outsource some of their policy decision making to external
   entities.  Open Outsourcing Policy Service (OOPS) is a protocol for
   exchanging policy information and decisions between Local Policy
   Modules (LPMs) located within RSVP-capable routers and one or more
   external policy servers. OOPS is an open protocol in a sense that it
   does not define or depend on particular policies; instead, it
   provides a framework for adding, modifying and experimenting with new
   policies in a modular, plug-n-play fashion. Moreover, the OOPS
   protocol supports both partial and complete delegation of policy
   control.

   The OOPS protocol was designed to be compatible with the RSVP
   Extensions for Policy Control [Ext], both in the format of RSVP
   objects, as well as the set of supported services.

   The basic features of OOPS are as follows:



   Asymmetry between client and server

        Adding policy support to RSVP may require substantial
        modifications to platforms (e.g., routers) which may not have
        the required implementation flexibility and/or processing power.
        OOPS assumes that the server is more sophisticated than the
        client, in terms of processing power and support for diverse
        policies.


   Support for a wide range of client implementation

        The OOPS protocol supports a wide range of client
        implementations.  At one end of the spectrum, a "dumb" client
        may delegate total responsibility to the server for all policy
        decisions without even maintaining cached states.  At the other
        end, smart clients can perform most policy processing locally
        and only address the server for a small number of sub-policy



Shai Herzog et al.       Expiration: Oct. 1997                  [Page 2]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


        elements and only when things change (otherwise, cache can be
        used).


   Support for different policy interfaces

        The OOPS protocol allows clients and servers to negotiate the
        nature and sophistication of their interaction. For instance,
        responses from the server to the client may be restricted to
        allow the server to merely accept, deny or remain neutral on
        reservation requests, while a more sophisticated implementation
        may allow the server to respond with preemption priorities or
        other characteristics of the reservation. The negotiation
        handshake is simple, and may always fall back onto the lowest
        level of interaction that must always be supported.


   Minimal knowledge of RSVP's processing rules.

        The server must be aware of the format of several RSVP objects
        and basic RSVP message types. However, it is not required to
        understand RSVP's processing rules (e.g., different reservation
        styles).  Moreover, OOPS functionality is not tied to that of
        RSVP, and OOPS may be extended to be used by other, non-RSVP,
        connection setup protocols.


   Asynchronicity

        Both client and server may asynchronously generate queries or
        requests.


   TCP for reliable communications

        TCP is used as a reliable communication protocol between client
        and server.



   1.1 Glossary


      Policy

           Comprehensive set of rules for controlling some aspects of
           the network.




Shai Herzog et al.       Expiration: Oct. 1997                  [Page 3]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      Sub-policies

           Modular building blocks out of which comprehensive policies
           are compiled.


      POLICY_DESC

           Data representation of policy information (e.g., POLICY_DATA
           objects in RSVP).


      Sub-policy element

           Data representation of sub-policy information, as
           encapsulated in POLICY_DESC objects.



   1.2 Representative OOPS Scenarios

      Figure 1 depicts some representative scenarios for policy control
      along an RSVP path, as envisioned in OOPS.  Nodes A, B and C
      belong to one administrative domain AD-1 (advised by policy server
      PS-1), while D and E belong to AD-2 and AD-3, respectively.


























Shai Herzog et al.       Expiration: Oct. 1997                  [Page 4]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


                             AD-1                AD-2       AD-3
               _______________/\___________     __/\__     __/\__
              {                            }   {      }   {      }

              +------+   +------+   +------+   +------+   +------+
      +----+  |  A   |   |  B   |   |  C   |   |  D   |   |  E   |  +----+
      | S1 |--| RSVP |---| RSVP |---| RSVP |---| RSVP |---| RSVP |--| R1 |
      +----+  +------+   +------+   +------+   +------+   +------+  +----+
              | LPM  |              | LPM  |   | LPM  |   | LPM  |
              +------+              +------+   +------+   +------+
                    \                /                       |
                     \              /                     +------+
                      \            /                      |Policy|
                       \          /                       |Server|
                        \        /                        | PS-2 |
                         \      /                         +------+
                         +------+
                         |Policy|
                         |Server|
                         | PS-1 |
                         +------+

               Figure 1: Policy Control along an RSVP path


      Policy objects are carried in RSVP messages along the path
      consisting of four typical node types:

      (1) Policy incapable nodes: Node B. (2) Self-sufficient policy
      node: Node D does not need to outsource policy tasks to external
      servers since its LPM satisfies its entire policy needs.  (3)
      "Dumb" policy nodes: Node E is an unsophisticated node that lacks
      processing power, code support or caching capabilities, and needs
      to rely on PS-2 for every policy processing operation.  In this
      case, the volume of traffic and delay requirements make it
      imperative to connect Node E to PS-2 a direct link or a LAN.  (4)
      "Smart" policy nodes:  Nodes A and C include sophisticated LPMs,
      in that these nodes can process some sub-policy elements, and have
      the capacity to cache responses from PS-1.  In this case, the
      contact between the clients and server would be limited to
      occasional updates, and PS-1 could be located somewhere in AD-1.

      Consider the case where the receiver R1 sends a Resv message
      upstream toward sender S1.  Assuming that the reservation is
      successful, the conceptual flow of policy objects is:

      R1 -- E -- ELPM -- PS-2 -- ELPM -- E -- D -- DLPM -- D -- C -- CLPM
      -- PS-1 -- CLPM -- C -- B -- A -- ALPM -- PS-1 -- ALPM -- A -- S1.



Shai Herzog et al.       Expiration: Oct. 1997                  [Page 5]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      Of course, other OOPS messages may be exchanged between policy
      servers and nodes before authorizing the reservation at individual
      nodes.

      The functioning of the policy module at a policy aware router is
      presented through the following conceptual diagram.

                     +---------+         +----------+
                     |  RSVP   |         |  Policy  |
                     |  Module |         |  Server  |
                     +---------+  OOPS   |          |
                     |  LPM    |---------|          |
                     +- - - - -+         +----------+
                     |PSM| |PSM|         |PSM|  |PSM|
                     |___| |___|         |___|  |___|

           Figure 2: Local Policy Modules and Policy Server communications

      The policy server and the local policy module provide support for
      a number of sub-policy elements, each embodied by a policy sub-
      module (PSM).  The policy object forwarded by RSVP may contain a
      number of elements, each identified by a number, and hence
      destined to the sub-module that enforces that sub-policy element's
      number. For instance, some of these sub-objects may deal with
      authentication, others with security, accounting and so on.  The
      LPM is aware of the sub-modules it is capable of processing
      locally; After the handshake comes to know the set of sub-policies
      that are supported by the server. Processing of policy sub-objects
      can be split between the LPM and the policy server, and responses
      may be merged back before returning a unified response to RSVP.

2. OOPS Protocol: Basic Features

   OOPS is a transaction protocol, in which most communication is in the
   form of queries from the client followed by responses from the
   server.  However, a small portion of the communication may also
   consist of queries originating from the server, or of unidirectional
   notifications from one entity to another.  In this context, it is
   important that messages be distinguished by a unique association, so
   that responses may identify the query to which they correspond.

   This section discusses four fundamental concepts of the OOPS
   protocol:  (a) query/response mechanism, (b) flexible division of
   labor between client and server, and (c) consistent management of
   client, server and RSVP state.

   2.1 Query/Response mechanism

      Each OOPS message is uniquely identified by a sequence number;
      Both client and server begin communication with Mseq = 0 (the
      handshake message), and number consecutive messages in increasing
      order. These sequence numbers do not imply the order of execution;
      while the server receives messages in-order, it is free to execute
      them in any reasonable order.

Shai Herzog et al.       Expiration: Oct. 1997                 [Page 6]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      These sequence numbers are mainly used by the Error-Notification
      operation as a means to identify the message that is associated
      with the reported error. [Note 2]

      2.1.1 Associating Queries and Responses

         Queries and responses carry a Q_ASSOC object which relates
         newly received responses to their original query operations.
         The contents of this object is client-specific and therefore
         opaque to the server; it is set by the client for each query
         and is echoed back as-is by the server. The client must store
         enough information in the Q_ASSOC object to enable its own
         unique identification of the original query.

   2.2 Division of Labor between Client and Server

      The OOPS protocol allows for a flexible division of
      responsibilities between server and client. First, the client must
      be able to decide how to distribute the processing and second, it
      must be able to merge the distributed responses into one unified
      result.

      2.2.1 Distributed Processing

         Processing of sub-policies (sub-policy elements within
         POLICY_DESC objects) can be performed by the server, the
         client, or by both.  The decision on which sub-policies are to
         be handled locally and which are to be sent to the server is
         always made by the client based on information exchanged during
         the connection establishment handshake (see Section 3.1).

         The client may remove sub-policy elements which are not to be
         processed by the server. In this case, the client is solely
         responsible for checking the integrity of the incoming policy
         object; [Note 3]
_________________________
[Note 1] Execution order is implementation and policy specific; any
order that does not violate the policy specific requirements is assumed
to be reasonable.

[Note 2] Senders must be informed about the receiver's failure to
process their messages. This is especially critical given that OOPS
relies on TCP's reliability and lacks additional reliability mechanisms.

[Note 3] If any portion of the POLICY_DESC object is modified, the
digest integrity verification at the server is bound to fail.





Shai Herzog et al.       Expiration: Oct. 1997                 [Page 7]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


         the client must also set the OP-Code header flag to inform the
         server to that fact.

         During connection establishment, the server may request to have
         oversight over the clients local decisions; in this case, the
         client should forward incoming policy objects in their
         entirety, and consult the server for all RSVP flows, regardless
         of whether they include POLICY_DATA objects. This oversight is
         transparent to the client and is therefore post factum. [Note
         4]


         OOPS does not impose limitations on the number of servers
         connected to the client; when appropriate, the client could
         divide the work along policy lines between several servers, and
         be responsible for combining their results. In the rest of this
         document we describe the protocol for a single server-client
         pair.

      2.2.2 Unification of Distributed Responses

         Division of labor between client and server is only possible to
         the extent that the client has the capability to unify or merge
         results; the client must be able to merge the results of
         queries arriving from servers with its own local results, to
         produce a single unified response to the underlying protocol
         (e.g., RSVP).

         Results unification is straight-forward for outgoing
         POLICY_DESC object; since sub-policy elements are independent,
         their unification is performed by concatenating all local and
         server elements and packing them in POLICY_DESC objects. [Note
         5]


         Unification is more complex for status queries, since the
         various responses must truly be merged to produce a single
         status result.  OOPS defines one basic (default) status
         response interface (object and unification rules).
_________________________
[Note 4] The client should not wait for an oversight decision; if the
server overrides a local decision, it may notify the client sometime
later, even after the local client authorized the RSVP operation.

[Note 5] An oversight sub-policy element would override the locally
generated element, if the two are of the same type.





Shai Herzog et al.       Expiration: Oct. 1997                 [Page 8]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


         However, given that OOPS is an extensible framework, it allows
         the the client and server to negotiate a more sophisticated
         interface (see Section 3.1).  Additional response interfaces
         could be described in separate documents which should define
         the response object format and unification rules. [Note 6]


      2.2.3 Default Status Response

         The default status response object is of the C-Type 1.  C-Type
         1 objects may contain two values: a policy admission decision
         (PAD) and a preemption priority value (PP).  It is reasonable
         to assume that some clients would not be able to utilize the
         flow preemption priority information; such clients are free to
         ignore this value and assume that all flows are created equal.
         (have priority 0).

         PADs may have one of three values: ACCEPT, SNUB, and VETO.
         ACCEPT authorizes the query, SNUB signifies neutrality (neither
         accept nor reject).  A VETO from the server or LPM has a
         stronger semantics than a snub, since it has the power to
         forcefully reject a flow regardless of any accept decisions
         made by the other.

         The rules for unification of PAD values A and B are straight-
         forward:

                   +----------------------+---------------------+
                   |  A+B                 | IF...               |
                   +----------------------+---------------------+
                   |  SNUB                | A=SNUB and B=SNUB   |
                   |  VETO                | A=VETO or  B=VETO   |
                   |  ACCEPT (+PP value)  | Otherwise           |
                   +----------------------+---------------------+

         A unified result of ACCEPT provides approval for the status
         query; both SNUB and VETO signal the rejection of the query.

         Note that a client and/or server should complete their policy
         processing even if a veto was cast by some policy. [Note 7]
_________________________
[Note 6] A separate template document and a list of more sophisticated
responses should be prepared.

[Note 7] A wide range of sub-policies may not care about the final
status results and should be activated regardless.  For instance: a
policy that logs all policy queries.




Shai Herzog et al.       Expiration: Oct. 1997                 [Page 9]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


         An ACCEPT response is accompanied by a PP value between 0..255.
         Lower values describe higher priorities (priority 1 is the
         highest).  The value 0 is reserved for "N/A"; this value is
         used when preemption priority is not applicable.

         The unification of PP values A and B attempts to provide the
         highest priority (lowest value) which is supported by an ACCEPT
         decision. The value 0 has no effect on the unified priority:

                   +----------------------+---------------------+
                   |  A+B                 | IF...               |
                   +----------------------+---------------------+
                   |  MIN(A,B)            | A!=0 and B!=0       |
                   |  A                   | B=0                 |
                   |  B                   | A=0                 |
                   |  0 (n/a)             | A=0  and B=0        |
                   +----------------------+---------------------+

   2.3 State Management

      In order for policy objects contained in RSVP messages to be
      processed quickly and correctly, it is often required that the
      results of past policy decisions be cached and maintained at the
      LPM or the policy server. During normal operations, the state
      maintained in the client and in the server must remain consistent,
      and must timeout at roughly the identical times in RSVP, the
      client, and the server.

      The most straightforward method for state maintenance is for the
      LPM and the policy server to use the same soft-state mechanism as
      the RSVP capable router. Unfortunately, this soft-state approach
      has undesirable scaling properties since it requires the client to
      contact the server on each refresh period (regardless of state
      changes).

      An alternative approach is to allow both client and server to use
      hard-state mechanisms that could limit the client-server
      communication to state updates only. To support the hard-state
      mode, the client must be able to distinguish between repeats
      (refreshes) and updates; it must also be able to translate the
      soft-state that is provided by RSVP into the hard-state exchanged
      with the server.

      Thus, we envision one end of the spectrum where a "dumb" client
      would use a soft-state approach and simply pass all policy objects
      to the server relying on it for all policy processing.  The rate
      of queries and lack of caching at the client implies the need for
      a dedicated, close-by server (PS-2, in our example). As we move



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 10]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      towards the other extreme, clients become smarter, split the work
      between themselves and the server, utilize caching capabilities.
      Such clients could take advantage of the benefits of hard-state
      management, and initiate queries only on actual state updates.

      OOPS supports soft and hard state mechanisms seamlessly, as
      described in this section. The client determines its desired type
      of state management, and communicates it on an object-by-object
      basis.  A single client can use soft-state for some information,
      and hard state for others.  Furthermore, the OOPS protocol allows
      clients to modify their caching strategies on the fly (without
      having to renegotiate with the server).  While the protocol does
      not impose strategy limitations, a client implementation could
      restrict itself to a more modest and simple combination of soft
      and hard state.

      There are two types of state information that is stored at the
      client:  (a) client state information that was forwarded to the
      server (e.g., policy objects in incoming Path/Resv messages).  (b)
      server state which is cached at the client (e.g., policy results
      computed by the server). The OOPS protocol addresses each of these
      types of states separately:

      2.3.1 Client State Information Cached at the Server

         The client indicates its choice of state management approach by
         setting (or resetting) the OOPS_HardState flag in objects sent
         to the server.  When the client chooses soft-state management,
         policy state for that specific object ages and expires at the
         server according to the specified timeout (refresh-period * K).
         Therefore, the state cached at the server is kept alive by
         constant refreshing (the client must forward ALL incoming RSVP
         messages, whether or not they represent refreshes or updates).
         On the other hand, when indicating a choice of hard-state
         management, the client assumes responsibility for reliably
         informing the server on every policy update.  In this case, the
         state cached at the server would not expire unless explicitly
         modified by the client, or when the communication channel to
         the client breaks. [Note 8]
          The client may refrain from forwarding to the server any
         repeat policy objects (which represent no updated information).

         The client may switch between hard and soft states on the fly
_________________________
[Note 8] Clearly the channel breaks when either the client or server
become disfunctional or die.





Shai Herzog et al.       Expiration: Oct. 1997                 [Page 11]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


         by modifying the OOPS_HardState flag while forwarding input to
         the server.

      2.3.2 Server State Information Cached at the Client

         The client indicate its state management capabilities by
         setting (or resetting) the OOPS_HardState flag in queries sent
         to the server. A choice of soft-state indicates that the client
         is incapable of caching, and it purges the server responses
         after usage (one-time, or disposable results). Clearly, without
         caching, the client must issue a new query each time that
         responses are needed.

         When the server responds to a cached (hard-state) query, it
         assumes responsibility to reliably inform the client about any
         changes that may occur later with the original response to this
         query.  The client may rely on cached results as long as there
         is no change in RSVP's state (which includes incoming policy
         objects), [Note 9]
          and the communication channel with the server is intact.

         The client may switch between hard and soft states on the fly
         by issuing a new query with a modified flag.

      2.3.3 State Change Notification

         State change notification is done by resending the same type as
         the original message but with the modified state instead.

         Client notification example (incoming POLICY_DESC objects for
         Resv-X):

_________________________
[Note 9] A configurable option may allow the client to use cached
results even when some RSVP state changes.  There is a clear trade-off
here between fast and accurate policy processing, however, given that
the server is up, and that authorization was already granted previously
for that RSVP flow, some may find it a reasonable policy approach.












Shai Herzog et al.       Expiration: Oct. 1997                 [Page 12]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


                                  TYPE           DATA
                                  ----           ----
         CLIENT ==> SERVER:       NOTIFY:INPUT   RESV-X: PD-1

         Time passes; the input POLICY_DESC object associated with
         Resv-X changed to PD-2.

         CLIENT ==> SERVER:       NOTIFY:INPUT   RESV-X: PD-2


         Server notification example (status query for reservation
         Resv-X):


                                  TYPE            DATA
                                  ----            ----
         CLIENT ==> SERVER:       QUERY:STATUS   Q_ASSOC=ID1, RESV-X
         SERVER ==> CLIENT:       RESP :STATUS   Q_ASSOC=ID1, ACCEPT

         Time passes; the status of Resv-X changed to "reject".

         SERVER ==> CLIENT:       RESP :STATUS   Q_ASSOC=ID1, REJECT


      2.3.4 State Re-synchronization

         Both client and server may re-synchronize their respective
         states at any time during the connection. The reset initiator
         sends a Bye-Notification with a RESET code, and the receiver
         responds with a Bye-Notification with the same code.  After
         this exchange, all cached state becomes soft, and a new logical
         connection is reestablished (beginning with Connection-
         Initiation-Query,...). New/hard state gradually replaces
         old/soft state as described in Section 2.3.4.

   2.4 Error Handling

      We distinguish between two types of possible errors; policy errors
      and protocol errors.

      2.4.1 Protocol Errors

         Protocol errors (e.g., missing or bad parameters) do not reveal
         either positive or negative policy decisions and are therefore
         neutral (represented as SNUBs). [Note 10]
_________________________
[Note 10] This neutrality allows, when appropriate, other valid sub-
policy elements to support an accept decision.



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 13]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997




         It is recommended (although not required) that all local status
         processing at the client be completed before querying the
         server.  This allows the server to immediately commit the
         transaction rather than having to wait until the client is
         done.  (See the Client-Status-Notification Op-Code.)

         Some OOPS protocol errors may only affect the OOPS protocol
         processing or simply be logged. Other errors may escalate to
         become policy errors (e.g., a bad POLICY_DESC is reported as a
         policy error).

      2.4.2 Policy Errors

         Policy errors are reported in a sub-policy element specific
         format. These elements are encapsulated in POLICY_DESC objects
         and are forwarded toward the originator (cause) of the error.
         In most cases, a negative Status-Response initiates an
         automatic error response (e.g., RSVP ResvErr or PathErr),
         however, OOPS allows reporting of other error situations by
         scheduling an explicit error message (using the Protocol-
         Message-Notification op-code).  (See [Ext] for more about the
         rules governing error reporting).

         Consider a scenario where two receivers R1 and R2 listen to a
         multicast transmission from S1. A reservation sent by R1 is
         propagated upstream until it reaches node A, where it
         encounters a policy rejection.


           R1------------+
                                            B--------------A----------- S1
                          / \             |
           R2------------+   \            |
                              \           |
                              PS1        PS2

                   Figure 3: An Error Reporting Scenario


         The following table describes a subset of the relevant
         signaling which begins with reservation initiation by R1 and R2
         and ends by R1 receiving the appropriate error response.







Shai Herzog et al.       Expiration: Oct. 1997                 [Page 14]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997



From/To   Message                                    Comments
________________________________________________________________________________
R1->B     Resv [PD1]
R2->B     Resv [PD2]
B->PS1    OOPS-Incoming-Policy-Query[PD1,PD2]        ;B queries PS1
          OOPS-Status-Query?
          OOPS-Outgoing-Policy-Query? [Resv]
PS1->B    OOPS-Status-Response: ACCEPT
          OOPS-Outgoing-Policy-Response[PD3]
B->A      Resv [PD3]                                 ;B forwards the Resv to A
A->PS2    OOPS-Incoming-Policy-Query[PD3]            ;A queries PS2
          OOPS-Status-Query?
PS2->A    OOPS-Status-Response: SNUB (reject)        ;PS2 reject the reservation
A->PS2    OOPS-Outgoing-Policy-Query? [ResvErr]      ;PS2 provides error PD
PS2->A    OOPS-Outgoing-Policy-Response [PD1-E]
A->B      ResvErr [PD1-E]                            ;A sends back ResvErr to B
B->PS1    OOPS-Incoming-Policy-Query[PD1-E]
          OOPS-Outgoing-Policy-Query? [ResvErr]      ;PS1 builds error PD
PS1->B    OOPS-Outgoing-Policy-Response[PD1-E'],R1   ; (directed to R1 only)
B->R1     ResvErr [PD1-E']                           ;B sends back ResvErr to R1
________________________________________________________________________________

          Figure 4: Error Reporting Signaling


         All error information is carried in POLICY_DESC objects (as
         sub-policy elements). OOPS server may read and modify this
         information along the ResvErr path; it may also direct the
         error responses only to the relevant branches of the reserved
         tree (in this scenario, the error is associated with R1 but not
         with R2).


3. Client-Server Connection

   The following section describes the fundamentals of client-server
   connection: establishment, channel, and termination.

   3.1 Connection Establishment

      OOPS uses a well known port number (OOPS = 3288) for incoming
      connection requests. Usually, the client would attempt to
      establish a TCP connection to its preferred policy server,
      however, both client and server listen to the OOPS port. [Note 11]

_________________________
[Note 11] New (or recovering) policy servers are allowed to notify
clients on their existence by issuing a TCP connection request to the
client's OOPS port number.


Shai Herzog et al.       Expiration: Oct. 1997                 [Page 15]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      Regardless of who initiated the TCP connection, once the
      connection is in place, the OOPS logical connection establishment
      is always initiated by the client and is performed through a two
      way handshake.

      o    Communication Initiation by the Client

           The client sends a Connection-Initiation-Query to the server.
           This message identifies the client to the server and provides
           the basic characteristics of the client as well as a list of
           policy responses that are acceptable to the client. This list
           is in decreasing order of acceptability, and terminates with
           the default element.


      o    Response by the Server

           The server responds with a Connection-Accept-Response to
           connect to the client. It may also respond with a
           Connection-Reject-Response to refuse and disconnect from the
           client.

           After connection establishment both the client and server
           know the set of sub-policies that the client can send to the
           server, which one of them should handle default
           (unrecognized) sub-policies, as well as the format of status
           responses from server to client.  They also establish the
           Channel-Hold period which is determined as the minimum
           between the two values declared in the handshake messages,
           but must be at least 3 seconds.

      3.1.1 Reliable Communication

         We expect TCP to provide us with reliable, in-order delivery of
         packets.  Given that TCP is responsible for all the time
         critical network operations, reliability errors are assumed to
         be virtually nonexistent.

      3.1.2 Secure Communications

         OOPS relies on standard protocols for security of client-server
         communications. An emerging standard protocol IPSEC [IPSEC] is
         the mechanism of choice for ensuring either integrity or
         secrecy.  The use of IPSEC and/or other security protocols is
         transparent to OOPS.

   3.2 Connection Termination

      This section describes the handling of communication breakdown.


Shai Herzog et al.       Expiration: Oct. 1997                 [Page 16]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      3.2.1 Implicit Termination

         The communication channel may be unexpectedly disconnected
         because of a misbehaving client or server, network split, or
         for other reasons.  Both client and server must be able to
         detect such channel failures and act accordingly.  Consider the
         case where OOPS is used for quota enforcement.  The server may
         approve a reservation while debiting X/min from a local
         account. If the OOPS communication channel breaks, it is
         critical for the server to detect the break and stop debiting
         this account.

         The OOPS protocol relies on Keep-Alive messages to provide
         application-level communication-channel verification. [Note 12]

         Implicitly, the communications channel is assumed to be
         disconnected after it has been idle (no message was received on
         it) for more than a Channel-Hold period (see Section 3.1).
         Keep-Alive messages are sent by both client and server as
         needed [Note 13]
          to ensure the liveness of the connection (to prevent a
         Channel-Hold timeout). Keep-Alive messages are not
         acknowledged.

      3.2.2 Explicit Termination

         The client (or server) may terminate the connection by sending
         a Bye-Notification, and wait until either it receives an echoed
         Bye-Notification or the Channel-Hold period had passed. In
         between, it should ignore incoming messages (and not reset the
         Channel-Hold timer).

         At the opposite side, when a client (or server) receive a Bye-
         Notification message, it should echo it, and close the
         connection.



_________________________
[Note 12] OOPS implementations may utilize system dependent mechanisms
for detecting broken TCP connections, but does not rely on them. This is
especially important since a server may be in a dysfunctional state
while its TCP connection is still open and viable.

[Note 13] When the intermediate period in between two OOPS messages
approaches the Channel-Hold time.





Shai Herzog et al.       Expiration: Oct. 1997                 [Page 17]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      3.2.3 Post Termination

         Soft-state has an inherent cleanup mechanism; when the channel
         disconnects, the soft-state begins to age until it eventually
         expires (using the same mechanism and refresh-period * K used
         by RSVP).

         In contrast, hard-state is assumed to be valid unless
         explicitly modified. However, when the channel disconnects such
         an explicit notification is not possible.  Clearly, purging all
         state immediately upon disconnection is not an acceptable
         approach since should cause disruption of service and would not
         allow enough time to contact an alternate server.  OOPS uses
         the following simple rule:

         When the communication channel disconnects, all hard state
         associated with it is assumed to be soft-state that had been
         refreshed recently.

      3.2.4 Switching to An Alternative Server

         We assume that as part of their local configuration, clients
         obtain a list of policy servers and site specific selection
         criteria. This list can be the basis for server switching
         decisions.

         A switch to an alternate server may be triggered by a voluntary
         disconnection (i.e., Bye-Notification) or an unexpected break
         in the communication channel.  During normal operations, the
         client may wish to switch to an alternate server (for any
         reason). The client is advised to first connect to the new
         server before sending a Bye-Notification to the original one.
         If the communication channel unexpectedly disconnects, the
         client should quickly attempt to connect to an alternate
         server.

         In both cases, after the connection to a new server [Note 14]
          is established, the aging cached state from the old server
         would be gradually replaced by responses from the new server.
         [Note 15]
_________________________
[Note 14] The term "new server" may be the same as the "previous
server"; it may happen that the connection encounters a problem and the
client chooses to disconnected and re-established the connection.

[Note 15] The client could speed-up replacement of cached state by
sending copies of cached input to the server and issuing repeated
queries, on connection establishment (instead of waiting until objects



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 18]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


         As general guidelines, state replacement from a new server
         should not cause a disruption of service that would not
         otherwise occur (if a new server was not found). [Note 16]


         After switching to an alternate server, the client may
         periodically poll its old (preferred) server by attempting a
         TCP connection to its OOPS port. Similarly, a new (or recovered
         server) may notify clients about its liveness by attempting to
         connect to their OOPS port. In the latter case, clients may
         disconnect the TCP connection or respond with a Connection-
         Initiation-Query as if the client initiated the connection in
         the first place. [Note 17]


          %% TOO EARLY: WE SHOULD PUT IT IN THE NEXT VERSION (02)
          %% ----------------------------------------------------
          %%The client may choose to use both the main and the alternate
         servers
          %%in tandem. In this case, the client would send inputs and
         updates to
          %%both servers, but will make status and outgoing-policy
         queries only
          %%to the main server. Given that both servers have the same
         state image,
          %%a switch between them could be fast without causing
         disruption of
          %%service.

4. OOPS Message Format

   OOPS messages serve as a wrapper that may include one or more Op-
   Codes; the message wrapper allows common operation (e.g., MD5
   integrity, HOP_DESCs, protocol version, etc.) to be performed and
   verified in one-shot. All OOPS messages are composed of the following
   fields:

_________________________
arrive from RSVP).

[Note 16] Practically, this means that as long as there is no change in
RSVP messages, the client is advised to choose between cached and new
results in favor of authorizing the request.

[Note 17] Future version of this document may include the use of
multicast to advertise the liveness of servers.





Shai Herzog et al.       Expiration: Oct. 1997                 [Page 19]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


   +---------------+---------------+---------------+---------------+
   |    Ver        |  #Op-Codes    |  Flags        |    //////     |
   +---------------+---------------+---------------+---------------+
   |                  Message Length                               |
   +---------------+---------------+---------------+---------------+
   |                  Message Sequence Number                      |
   +---------------+---------------+---------------+---------------+
   |                  OOPS_MSG_AUTH (Optional)                     |
   +---------------+---------------+---------------+---------------+
   |                  List of Op-Codes...                          |
   +---------------+---------------+---------------+---------------+


   Version: 8 bits

        Protocol version number. The current version is 1.


   Flags: 8 bits

        0x01 H_Integrity_Checked      POLICY_DESC Integrity already checked by client
        0x02 H_Hops_Checked           Prev/Next HOPs already checked by client


   #Op-Codes: 8 bits

        Number of Op-Codes included in this message.


   Message Length: 32 bits

        The total length of this OOPS message in bytes.


   Message Sequence Number: 32 bits

        The sequence number of the message being sent.


   OOPS_MSG_AUTH (optional): variable length

        This Message Authenticator provides integrity verification based
        on a shared-keyed message digest. The message digest is
        calculated over the entire OOPS message.

        There is only one object format currently defined is identical
        to the RSVP INTEGRITY object (defined in [Bak96]).




Shai Herzog et al.       Expiration: Oct. 1997                 [Page 20]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


   List of OOPS operation codes (Op-Codes): variable length

        Described in the following section.



   4.1 OOPS Operation Codes (Op-Codes)

      Each OOPS message may contain multiple OOPS operations each
      encapsulating a different query, response or notification.  For
      example, multiple Incoming-Policy-Queries might be followed by a
      Status-Query operation in the same message.

      Individual OOPS Op-Codes have the following header:

      +---------------+---------------+---------------+---------------+
      | Operation Code| Op. Subtype   |  Flags        |    //////     |
      +---------------+---------------+---------------+---------------+
      |                      Length (bytes)                           |
      +---------------+---------------+---------------+---------------+
      |                      Refresh Period                           |
      +---------------+---------------+---------------+---------------+

      The operation header has the following fields:


      operation Code: 8 bits

           The type of OOPS operation.


      Operation Subtype: 8 bits

           This field can be used to indicate an attribute of the Op-
           Code, such as its version; currently it is always set to 1.


      Flags: 8 bits

           0x01 OOPS_HardState:   Hard State (soft-state if not set (0) )
           0x02 OOPS_Shared   :   Resv shared among sources as filter specs
           0x02 OOPS_FullList :   Last in the set of status queries.


      Length: 32 bits

           Contains the total operation length in bytes (including
           header).



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 21]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      Refresh Period

           The refresh-period associates with this object (e.g., RSVP's
           refresh period).



      The remainder of this section describes the set of operations that
      may appear in OOPS messages and their object format.  OOPS does
      not bind itself to a particular protocol (i.e., RSVP) and is built
      around objects that may belong to different (other) protocols. The
      current draft is based on the assumption that RSVP would be one
      (the first) of these protocols and thus, the draft provides the
      appropriate RSVP objects format.

      4.1.1 Null-Notification (a.k.a Keep-Alive)

         Operation Type = 0, sub-type = 1

         <Null-Notification> ::= <Common OOPS header>

         This empty or null notification triggers no operation; thus,
         can be used as as Keep-Alive signal to test the viability of
         the communication channel between client and server (see
         Section 3.2.1).

      4.1.2 Connection-Initiation-Query

         Operation Type = 1, sub-type = 1

         <Connection-Initiation-Query> ::=  <Common OOPS header>
                                            <CONNECT_DESC>
                                            <CLASS_ID>
                                            <CLIENT_ID>
                                            <RESP_INT>
                                            <COOKIE>


         The client sends this query to establish a connection with a
         server. This message is sent following the establishment of a
         transport connection (TCP).



         o    CONNECT_DESC

              Description of connection parameters.




Shai Herzog et al.       Expiration: Oct. 1997                 [Page 22]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


         o    CLASS_ID

              The client's class provides an implicit description of the
              client's capabilities and requirements; the CLASS_ID is an
              index into the class list maintained by the server; it is
              used in conjunction with the CLIENT_ID.)


         o    CLIENT_ID

              The network address of the client.  From the combination
              of CLIENT_ID and CLASS_ID the server can learn about the
              set of sub-policies it is required to support for this
              particular client; it can also learn which of these sub-
              policies are optional and which are mandatory.


         o    RESP_INT

              A list of possible response interfaces.


         o    COOKIE



      4.1.3 Connection-Accept-Response

         Operation Type = 2, sub-type = 1

         <Connection-Accept-Response> ::=  <Common OOPS header>
                                           <CONNECT_DESC>
                                           <PLIST>
                                           <RESP_INT>
                                           <COOKIE>

         The server sends this response to accept a client's connection
         connection request.



         o    CONNECT_DESC


         o    PLIST

              Each "From Policy m" and "To Policy m" pair represent a
              range of sub-policies that the server is willing to



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 23]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


              support.


         o    RESP_INT

              The chosen (agreed upon) status response interface.


         o    COOKIE



      4.1.4 Connection-Reject-Response

         Operation Type = 3, sub-type = 1

         <Connection-Reject-Response> ::=  <Common OOPS header>
                                           <ERR_DESC>

         The server sends this response to reject a client's connection
         initiation. It specifies both reason code and text.

      4.1.5 Bye-Notification

         Operation Type = 4, sub-type = 1

         <Bye-Notification> ::= <Common OOPS header>
                                <BYE_DESC>
                                [<ERR_DESC>]


         This message is used by either client or server to terminate
         the OOPS connection.



         o    BYE_DESC



         (Section 3.2.2 includes a description of explicit termination
         using Bye-Notification)

      4.1.6 Incoming-Policy-Query

         Operation Type = 5, sub-type = 1

         <Incoming-Policy-Query> ::=  <Common OOPS header>



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 24]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


                                      <Q_ASSOC>
                                      <PROT_MSG_TYPE>
                                      <DST_DESC>
                                      <SRC_DESC list>
                                      <HOP_DESC>
                                      [<ADV_DESC>]
                                      <POLICY_DESC list>

         This operation is used to forward POLICY_DESC objects from the
         client to the server.  Selection between hard and soft state
         management is reflected in the OOPS_HardState flag.  The other
         fields are copied from the PC_InPolicy() function called by
         RSVP. (See [Ext]).

      4.1.7 Incoming-Policy-Response

         Operation Type = 6, sub-type = 1

         <Incoming-Policy-Response> ::=  <Common OOPS header>
                                         <Q_ASSOC>
                                         <ERR_DESC>

         Incoming-Policy-Response is used ONLY to report protocol errors
         (e.g., syntax) found with incoming policy objects.  (it is not
         used in the normal operation of the protocol).

      4.1.8 Outgoing-Policy-Query

         Operation Type = 7, sub-type = 1

         <Outgoing-Policy-Query> ::=  <Common OOPS header>
                                      <Q_ASSOC>
                                      <PROT_MSG_TYPE>
                                      <DST_DESC>
                                      <SRC_DESC list>
                                      <HOP_DESC list>

         This operation queries the server for a set of outgoing policy
         objects for a set of HOP_DESCs.  The client can choose between
         hard and soft state management through the OOPS_HardState flag.
         When hard state is selected, the client caches copies of the
         outgoing objects and assumes they remain valid unless
         explicitly modified by the server.

      4.1.9 Outgoing-Policy-Response

         Operation Type = 8, sub-type = 1




Shai Herzog et al.       Expiration: Oct. 1997                 [Page 25]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997

         <Outgoing-Policy-Response> ::=  <Common OOPS header>
                                         <Q_ASSOC>
                                         { <HOP_DESC>
                                           <ERR_DESC> or <POLICY_DESC>
                                         } pairs list

         The  <Query Sequence Number> links the response to the original query.

         In the response, the server provides a list of triplets, one
         for each outgoing HOP_DESC (For Path messages, only the LIH
         part is significant). Each triplet contains a list of policy
         objects for that hop and an error description.

         The OOPS server can block an outgoing RSVP message by replacing
         the outgoing POLICY_DESC list for a particular HOP_DESC with an
         <Error-Description> with an appropriate value.

         The ability to block outgoing RSVP control messages is
         especially useful when policy is enforcement is performed at
         border nodes of a network; RSVP control messages that are
         allowed through are capable of installing state at internal
         nodes without being subject to further policy control.

      4.1.10 Status-Query

         Operation Type = 9, sub-type = 1

         <Status_Query> ::=  <Common OOPS header>
                             <Q_ASSOC>
                             <PROT_MSG_TYPE>
                             <DST_DESC>
                             <SRC_DESC list>
                             { <HOP_DESC>
                               <QOS_DESC>
                             } triplets list

         This operation queries the server for status results of a list
         of LIHs.  The client can choose between hard and soft state
         management through the OOPS_HardState flag. When hard state is
         selected, the client caches the status results and assumes they
         remain valid unless explicitly modified by the server.

         In the upstream direction (e.g., Resv) status may need to be
         checked on multiple LIHs (all reservations for a flow). In such
         cases, status queries can be perform separately for each LIH,
         once for all LIHs, or anything in between. Flag OOPS_FullList
         must be set at the last of status query of the series. [Note 18]
_________________________
[Note 18] When sub-policies are interdependent across LIHs (as when the
cost is shared among downstream receivers), flag OOPS_FullList notifies
the server that the list of reserved LIH is complete and that it can
safely compute the status of these reservations.

Shai Herzog et al.       Expiration: Oct. 1997                 [Page 26]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      4.1.11 Status-Response

         Operation Type = 10, sub-type = 1

         <Status-Response> ::=  <Common OOPS header>
                                <Q_ASSOC>
                                { <HOP_DESC>
                                  <STATUS_DESC>
                                  [<ERR_DESC>]
                                } triplet list

         The  <Q_ASSOC> links the response to the original query.

         In the response, the server provides a list of triplets, each
         of which contains an LIH, status, and any applicable error
         results.  The set of LIHs is an attribute of the results and
         not of the query; the server is allowed to respond with a
         superset of LIHs specified in the original query, as in the
         following example:

                             SEQ#  TYPE           DATA
                             ---   ----           ----
         Client ==> Server:  150   Query:status   Q_ASSOC=ID2, Resv-X, LIH={2}
         Server ==> Client:  153   Resp :status   Q_ASSOC=ID2, {2,rej}

         Two new reservations arrive, carrying new policy data objects:

         Client ==> Server:  160   Query:status   Q_ASSOC=ID3, Resv-X, LIH={4,7}
         Server ==> Client:  169   Resp :status   Q_ASSOC=ID3, {2,acc;4,acc;7,rej}

      4.1.12 Delete-State-Notification

         Operation Type = 11, sub-type = 1

         <Delete-State-Notification> ::=  <Common OOPS header>
                                          <STATE_OP_DESC>
                                          <DST_DESC>
                                          [<PROT_MSG_TYPE>]
                                          [<SRC_DESC list>]
                                          [<HOP_DESC>]
                                          [<ERR_DESC>]



         o    STATE_OP_DESC

              This object describes the type of requested operation (see
              Appendix A).



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 27]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


         This operation informs the sender about an immediate RSVP
         teardown of state caused by PATH_TEAR, RESV_TEAR, routes
         change, etc.  As a result, the server should ignore the
         described state as if it was never received from the client.

         Despite its name, this operation can be used to switch between
         blockaded and non-blockaded state.

         The semantics of this operation is described for PC_DelState()
         in [Ext].

         Error description is used to provide the server with a reason
         for the delete (for logging purposes).

      4.1.13 Protocol-Message-Notification

         Operation Type = 12, sub-type = 1

         <Protocol-Message-Notification> ::=  <Common OOPS header>
                                              <PROT_MSG_TYPE>
                                              <DST_DESC>
                                              <SRC_DESC list>
                                              <HOP_DESC>

         The operation results in the generation of an outgoing protocol
         message (e.g., RSVP's Path, Resv).  The client should schedule
         the requested message to the specified HOP_DESC.

      4.1.14 Client-Status-Notification

         Operation Type = 13, sub-type = 1

         <Client-Status-Notification> ::=  <Common OOPS header>
                                           <Q_ASSOC>
                                           <STATUS_DESC>

         The Client notifies the server about the status results
         computed at the client (that may also include results from
         other servers, if policy computation is spread among several
         servers).

         The overall status of an RSVP flow is computed by merging the
         client's status report with the server's. The server should not
         commit a transaction (e.g., charge an account) before knowing
         its final status. The Client-Status-Results operation can be
         sent with the query, if the client computed its status prior to
         making the query. It can also be sent later, after the server
         sent its response to the status query.



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 28]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


      4.1.15 Error-Notification

         Operation Type = 14, sub-type = 1

         <Message-Error-Notification> ::=  <Common OOPS header>
                                           <Message-Sequence-Number>
                                           <ERR_DESC>

         Message-Error-Notification can be used by either client or
         server to report errors associated with an entire message (as
         opposed to a specific operation). Error-Notification may be
         triggered by both syntax or substantive errors (e.g., failure
         to verify the integrity of the message).

         <Message-Sequence-Number> identified the message that triggered
         the error. It uses identical format to the one used by the OOPS
         message header.

         Message-Error-Notification is not acked.

5. Acknowledgment

   This document reflects feedback from Paul Amsden, Fred Baker, Lou
   Berger, Bob Braden, Ron Cohen, Deborah Estrin, Steve Jackowski, Tim
   O'Malley, Claudio Topolcic, Raj Yavatkar, and many other IPC and RSVP
   collaborators,

6. Authors' Address


   Shai Herzog              Phone: (917) 318-7938
   IP"Highway"                Email: herzog@iphighway.com




   Dimitrios Pendarakis     Phone: (914) 784-7536
                            Email: dimitris@watson.ibm.com
   Raju Rajan               Phone: (914) 784-7260
                            Email: raju@watson.ibm.com
   Roch Guerin              Phone: (914) 784-7038
                            Email: guerin@watson.ibm.com


   IBM T. J. Watson Research Center
   P.O. Box 704
   Yorktown Heights, NY 10598




Shai Herzog et al.       Expiration: Oct. 1997                 [Page 29]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


7. References

References

[IPSEC]  R. Atkinson, Security Architecture for the Internet Protocol,
    "RFC1825", Aug. 1997.

[Bak96]  F. Baker.  RSVP Cryptographic Authentication "Internet-Draft",
    draft-ietf-rsvp-md5-02.txt, 1996.

[RSVPSP]  R. Braden, L. Zhang, S. Berson, S. Herzog, and S. Jamin,
    Resource ReSerVation Protocol (RSVP) Version 1 Functional
    Specification.  "Internet-Draft", draft-ietf-RSVPSP-14.[ps,txt],
    Nov. 1996.

[Arch]  S. Herzog Accounting and Access Control Policies for Resource
    Reservation Protocols. "Internet-Draft", draft-ietf-rsvp-policy-
    arch-01.[ps,txt], Nov. 1996.

[LPM]  S. Herzog Local Policy Modules (LPM): Policy Enforcement for
    Resource Reservation Protocols. "Internet-Draft", draft-ietf-rsvp-
    policy-lpm-01.[ps,txt], Nov. 1996.

[Ext]  S. Herzog RSVP Extensions for Policy Control.  "Internet-Draft",
    draft-ietf-rsvp-policy-ext-02.[ps,txt], Apr. 1997.


























Shai Herzog et al.       Expiration: Oct. 1997                 [Page 30]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


A Appendix: OOPS Objects

This section describes objects that are used within OOPS OP-Codes.  All
objects have a common header:

+---------------+---------------+---------------+---------------+
|            Length             |      Class    |   C-Type      |
+---------------+---------------+---------------+---------------+

Length describes the length of the entire object, in bytes.  Class
describes the type of object and C-Type describes the a class sub-type.



o    CLASS_ID class



     -    Class = 1, C-Type = 1

          +---------------+---------------+---------------+---------------+
          |   ASCII String ........ 0 Padded to multiples of 32 bits      |
          +---------------+---------------+---------------+---------------+




o    CLIENT_ID class



     -    Class = 2, C-Type = 1

          A Network Address.

          +---------------+---------------+---------------+---------------+
          |   IPv4 Address                                                |
          +---------------+---------------+---------------+---------------+


     -    Class = 2, C-Type = 2

          +---------------+---------------+---------------+---------------+
          |   IPv6 Address                                                |
          |                                                               |
          |                                                               |
          |                                                               |
          +---------------+---------------+---------------+---------------+



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 31]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


     From the combination of Client-ID and Class-Indicator the server
     can learn about the set of sub-policies it is required to support
     for this particular client; it can also learn which of these sub-
     policies are optional and which are mandatory.


o    RESP_INT class



     -    Class = 3, C-Type = 1

          +---------------+---------------+---------------+---------------+
          | Most-Prefered |.....          |               |               |
          +---------------+---------------+---------------+---------------+
          |               | Least-Pref.   |...0 Padded to 32 bit multiples|
          +---------------+---------------+---------------+---------------+



o    COOKIE class



     -    Class = 4, C-Type = 1

          Currently, no values are defined.




o    PLIST class



     -    Class = 5, C-Type = 1

          +---------------+---------------+---------------+---------------+
          |          Number (or pairs)    |             //////            |
          +---------------+---------------+---------------+---------------+
          |          From Policy 1        |         To Policy 1           |
          +---------------+---------------+---------------+---------------+
          +---------------+---------------+---------------+---------------+
          |          From Policy n        |         To Policy n           |
          +---------------+---------------+---------------+---------------+


     Each "From Policy m" and "To Policy m" pair represent a range of



Shai Herzog et al.       Expiration: Oct. 1997                 [Page 32]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


     sub-policies that the server is willing to support.


o    ERR_DESC class



     -    Class = 6, C-Type = 1

          +---------------+---------------+---------------+---------------+
          | Error-Code    |     //////    |        Reason Code            |
          +---------------+---------------+---------------+---------------+
          |   Error ASCII String .... 0 Padded to multiples of 32 bits    |
          +---------------+---------------+---------------+---------------+


     Detailed Error-Code and Reason-Codes would be defined in future
     versions of this document.


o    Q_ASSOC class



     -    Class = 7, C-Type = 1

          +---------------+---------------+---------------+---------------+
          |                      Client-Specific Semantics                |
          //                        (Variable Length)                    //
          |                                                               |
          +---------------+---------------+---------------+---------------+

          The client-specific contents of this object is opaque to the
          server; it is set by the client for a query and is echoed by
          the server as-is. The client must store enough information
          there that will enable it to uniquely identify the original
          query when the response arrive. This must at least include a
          counter to identify the version of the latest query. [Note 19]




_________________________
[Note 19] A simple association could be the combination of a pointer to
an internal client (router) control-block that describes the query, and
a query version counter.





Shai Herzog et al.       Expiration: Oct. 1997                 [Page 33]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


o    PROT_MSG_TYPE class



     -    Class = 8, C-Type = 1

          +---------------+---------------+---------------+---------------+
          |               RSVP MSG TYPE                                   |
          +---------------+---------------+---------------+---------------+

          Values specified in [RSVPSP].




o    DST_DESC class



     -    Class = 9, C-Type = 1

          The RSVP SESSION object as defined in [RSVPSP].




o    SRC_DESC class



     -    Class = 10, C-Type = 1

          The RSVP FILTER_SPEC object as defined in [RSVPSP].




o    HOP_DESC class



     -    Class = 11, C-Type = 1

          The RSVP_HOP object as defined in [RSVPSP].







Shai Herzog et al.       Expiration: Oct. 1997                 [Page 34]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


o    ADV_DESC class



     -    Class = 12, C-Type = 1

          The RSVP ADSPEC object as defined in [RSVPSP].




o    QOS_DESC class



     -    Class = 13, C-Type = 1

          The RSVP FLOWDESC object as defined in [RSVPSP].




o    POLICY_DESC class



     -    Class = 14, C-Type = 1

          The RSVP POLICY_DATA object as defined in [Ext] and [RSVPSP].




o    OOPS_MSG_AUTH class



     -    Class = 15, C-Type = 1

          The RSVP INTEGRITY object as defined in [RSVPSP] and [Bak96].




o    STATUS_DESC class






Shai Herzog et al.       Expiration: Oct. 1997                 [Page 35]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


     -    Class = 16, C-Type = 1

          +---------------+---------------+---------------+---------------+
          | Results       |   Priority    |             //////            |
          +---------------+---------------+---------------+---------------+

          Results may have one of the following values:


          1 :         Accept
          2 :         Snub
          3 :         Veto


          Priority ranges between 1..255 (see 2.2.3).




o    CONNECT_DESC class



     -    Class = 17, C-Type = 1

          This object describes the OOPS connection parameters; in the
          Connection-Accept-Response, the refresh-multiplier is an echo
          of the value received with the Connection-Initiation-Query.

          +---------------+---------------+---------------+---------------+
          |  Version      |  Flags        | Refresh-Mult. |    //////     |
          +---------------+---------------+---------------+---------------+
          | Max-Msg-Size (in KBytes)      | Channel-Hold period (in sec.) |
          +---------------+---------------+---------------+---------------+


          Ver: 8 bits

               Currently, version 1.


          Flags:

               0x01  OOPS_CONNECT_DefaultC     Client handles default sub-policies.


          Refresh-Mult.:




Shai Herzog et al.       Expiration: Oct. 1997                 [Page 36]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


               The refresh-period multiplier (e.g., RSVP's K value).


          Max-Msg-Size: Upper limit on the length of an OOPS message


          Channel-Hold period: Implicit disconnection timeout






o    BYE_DESC class



     -    Class = 18, C-Type = 1

          BYE_DESC provides details about the Bye-Notification request.

          +---------------+---------------+---------------+---------------+
          |   Bye-Flags   |   //////      |      BYE_DELAY (seconds)      |
          +---------------+---------------+---------------+---------------+

          Bye-Flags:
          0x01     An echo (response) to a received Bye-Notification

          The BYE_DELAY could provide both sides with some time delay to
          be better prepared to a pending bye. [Note 20]
           The delay value is determined by the originator of the bye-
          notification, and is echoed in the bye response. The delay
          effect should be as if the Bye-Notification was sent BYE_DELAY
          seconds later with a delay timer value of 0.




o    STATE_OP_DESC class



     -    Class = 19, C-Type = 1

_________________________
[Note 20] Similar to the delayed shutdown command known in Unix.





Shai Herzog et al.       Expiration: Oct. 1997                 [Page 37]


Internet Draft       OOPS: Policy Protocol for RSVP            Apr. 1997


          +---------------+---------------+---------------+---------------+
          |   Op-Type     |                      //////                   |
          +---------------+---------------+---------------+---------------+

          Op-Type values:


          1 :         Delete State
          2 :         Block State
          3 :         Unblock State


B Appendix: Error Codes

This appendix describes an initial list of error codes available in
OOPS, as well as the set of Reason Codes for each error code.  (Reason
Code of 0 must be used when Reason Codes are not applicable).  This list
should evolve and not be considered conclusive. [Note 21]

o    Code = 1, Connection Management

     1:  Connection Reject: Server does not support client version.
     2:  Bye: Reset due to routine state re-synchronization
     3:  Bye: Reset due to connection problems (Bad message formats)


o    Code = 2, Protocol problems

     1:  Syntax: Bad OOPS message
     2:  Syntax: Bad OOPS Op-Code
     3:  Syntax: Bad POLICY_DESC format

o    Code = 3, Policy Decisions

     1:  Don't forward: refrain from forwarding an outgoing message.
     2:  Policy Reject: cancel protocol operation (Reservation, path, etc.)

o     Code = 4, State Management

     1:  Delete State: Reservation Canceled
     2:  Delete State: route change
     3:  Delete State: State Timeout
     4:  Blockade State
     5:  Unblock State








Shai Herzog et al.       Expiration: Oct. 1997                 [Page 38]