INTAREA WG                                                      M. Nayak
Internet-Draft                                                  R. Bonica
Updates: 8335 (if approved)                                     R. Puttur
Intended status: Standards Track                         Juniper Networks
Expires: August 5, 2019                                  February 1, 2019


            Probing IP Interfaces By Virtual Function Index
                  draft-nayak-intarea-probe-by-vfi-00

Abstract

   This document enhances the PROBE diagnostic tool so that it can
   identify the probed interface by Virtual Function Index.  In order to
   achieve that goal, this document also extends the Interface
   Identification Object.  The Interface Identification Object is an
   ICMP Extension Object class.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at https://datatracker.ietf.org/drafts/current/.

   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."

   This Internet-Draft will expire on August 5, 2019.

Copyright Notice

   Copyright (c) 2019 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (https://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of




Nayak, et al.             Expires August 5, 2019                 [Page 1]


Internet-Draft                Probe By VFI                  February 2019


   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Problem Statement . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Requirements Language . . . . . . . . . . . . . . . . . . . .   2
   3.  ICMP Extended Echo Request Message  . . . . . . . . . . . . .   3
   4.  Interface Identification Object . . . . . . . . . . . . . . .   3
   5.  ICMP Extended Echo Reply Message  . . . . . . . . . . . . . .   4
   6.  ICMP Message Processing . . . . . . . . . . . . . . . . . . .   4
   7.  Updates To RFC 8335 . . . . . . . . . . . . . . . . . . . . .   4
   8.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   5
   9.  Security Considerations . . . . . . . . . . . . . . . . . . .   5
   10. Acknowledgements  . . . . . . . . . . . . . . . . . . . . . .   5
   11. References  . . . . . . . . . . . . . . . . . . . . . . . . .   5
     11.1.  Normative References . . . . . . . . . . . . . . . . . .   5
     11.2.  Informative References . . . . . . . . . . . . . . . . .   5
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .   6

1.  Problem Statement

   PROBE [RFC8335] is a diagnostic tool that can be used to query the
   status of an interface.  PROBE sends an ICMP Extended Echo Request
   message to a proxy interface.  The ICMP Extended Echo Request message
   contains an ICMP Extension Structure and the ICMP Extension Structure
   contains an Interface Identification Object.  The Interface
   Identification Object identifies the probed interface by name,
   ifIndex or address.

   When the proxy interface receives the ICMP Extended Echo Request, the
   node upon which it resides executes access control procedures.  If
   access is granted, the node determines the status of the probed
   interface and returns an ICMP Extended Echo Reply message.  The ICMP
   Extended Echo Reply indicates the status of the probed interface.

   This document enhances the PROBE so that it can identify the probed
   interface by Virtual Function Index (VFI) [SR-IOV].  In order to
   achieve that goal, this document extends the Interface Identification
   Object.  The Interface Identification Object is an ICMP Extension
   Object class.

2.  Requirements Language

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL" in this document are to be interpreted as described in BCP




Nayak, et al.             Expires August 5, 2019                 [Page 2]


Internet-Draft                Probe By VFI                  February 2019


   14 [RFC2119] [RFC8174] when, and only when, they appear in all
   capitals, as shown here.

3.  ICMP Extended Echo Request Message

   Section 2.1 of [RFC8335] defines the ICMP Extended Echo Request
   message.  As per [RFC8335], the ICMP Extended Echo Request message
   contains the following fields:

   o  Type

   o  Code

   o  Checksum

   o  Identifier

   o  Reserved

   o  L (local)

   o  ICMP Extension Structure

   Section 7 of [RFC4884] defines the ICMP Extension Structure.  As per
   [RFC4884], the Extension Structure contains exactly one Extension
   Header followed by one or more objects.  When applied to the ICMP
   Extended Echo Request message, the ICMP Extension Structure contains
   exactly one instance of the Interface Identification Object.
   Section 2.1 of [RFC8335] defines the Interface Identification Object.
   Section 4 of this document extends that definition.

   If the L-bit is set, the Interface Identification Object can identify
   the probed interface by name, index, address or VFI.  If the L-bit is
   clear, the Interface Identification Object identifies the probed
   interface by address.

4.  Interface Identification Object

   Section 2.1 of [RFC8335] defines the Interface Identification Object.
   The Interface Identification Object identifies the probed interface
   by name, index, or address.  Like any other ICMP Extension Object, it
   contains an Object Header and Object Payload.  The Object Header
   contains the following fields:

   o  Class-Num: Interface Identification Object.  The value is 3.

   o  C-Type: Determines how the probed interface is identified.




Nayak, et al.             Expires August 5, 2019                 [Page 3]


Internet-Draft                Probe By VFI                  February 2019


   o  Length: Length of the object, measured in octets, including the
      Object Header and Object Payload.

   Currently, the following values are defined for C-Type:

   o  (0) Reserved

   o  (1) Identifies Interface by Name

   o  (2) Identifies Interface by Index

   o  (3) Identifies Interface by Address

   This document defines the following, new C-Type:

   o  (value TBD by IANA) Identifies Interfaces by Virtual Function
      Index (VFI)

   If the Interface Identification Object identifies the probed
   interface by Virtual Function Index, the length is equal to 8 and the
   payload contains the Virtual Function Index.

5.  ICMP Extended Echo Reply Message

   Section 3 of [RFC8335] defines the ICMP Extended Echo Reply message.
   This document does not change that definition.

6.  ICMP Message Processing

   Section 4 of [RFC8335] defines the ICMP message processing.  This
   document does not change that definition.

7.  Updates To RFC 8335

   Section 2 of [RFC8335] states:

   "If the L-bit is set, the Interface Identification Object can
   identify the probed interface by name, index, or address.  If the
   L-bit is clear, the Interface Identification Object MUST identify the
   probed interface by address."

   This document updates that text as follows:

   "If the L-bit is set, the Interface Identification Object can
   identify the probed interface by name, index, address, or Virtual
   Function Index (VFI).  If the L-bit is clear, the Interface
   Identification Object MUST identify the probed interface by address."




Nayak, et al.             Expires August 5, 2019                 [Page 4]


Internet-Draft                Probe By VFI                  February 2019


8.  IANA Considerations

   IANA is requested to add the following a new C-type:

   o  (value TBD by IANA) Identifies Interfaces by Virtual Function
      Index (VFI)

   This new C-Type is to be added to the Interface Identification Object
   under the "ICMP Extension Object Classes and Class Sub-types"
   registry.

9.  Security Considerations

   This documen neither extends nor mitigates any of the security
   considerations mentioned in [RFC8335].

10.  Acknowledgements

   The authors wish to acknowledge Ross Callon for his helpful comments.

11.  References

11.1.  Normative References

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <https://www.rfc-editor.org/info/rfc2119>.

   [RFC4884]  Bonica, R., Gan, D., Tappan, D., and C. Pignataro,
              "Extended ICMP to Support Multi-Part Messages", RFC 4884,
              DOI 10.17487/RFC4884, April 2007,
              <https://www.rfc-editor.org/info/rfc4884>.

   [RFC8174]  Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
              2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
              May 2017, <https://www.rfc-editor.org/info/rfc8174>.

   [RFC8335]  Bonica, R., Thomas, R., Linkova, J., Lenart, C., and M.
              Boucadair, "PROBE: A Utility for Probing Interfaces",
              RFC 8335, DOI 10.17487/RFC8335, February 2018,
              <https://www.rfc-editor.org/info/rfc8335>.

11.2.  Informative References







Nayak, et al.             Expires August 5, 2019                 [Page 5]


Internet-Draft                Probe By VFI                  February 2019


   [SR-IOV]   PCI-SIG, ., "Single Root I/O Virtualization and Sharing
              Specification Revision 1.1", January 2010,
              <https://members.pcisig.com/wg/PCI-SIG/document/
              download/8238>.

Authors' Addresses

   Manoj Nayak
   Juniper Networks
   Bangalore, KA  560103
   India

   Email: manojnayak@juniper.net


   Ron Bonica
   Juniper Networks
   Herndon, Virginia  20171
   USA

   Email: rbonica@juniper.net


   Rafik Puttur
   Juniper Networks
   Bangalore, KA  560103
   India

   Email: rafikp@juniper.net























Nayak, et al.             Expires July 24, 2019                 [Page 6]