NFSv4 Minor Version 2 Protocol External Data Representation Standard (XDR) Description
draft-ietf-nfsv4-minorversion2-dot-x-41

Document Type Active Internet-Draft (nfsv4 WG)
Last updated 2016-02-04 (latest revision 2016-01-28)
Stream IETF
Intended RFC status Proposed Standard
Formats plain text pdf html bibtex
Stream WG state Submitted to IESG for Publication
Document shepherd Spencer Shepler
Shepherd write-up Show (last changed 2015-09-10)
IESG IESG state RFC Ed Queue
Consensus Yes
Telechat date
Responsible AD Martin Stiemerling
Send notices to (None)
IANA IANA review state Version Changed - Review Needed
IANA action state No IC
RFC Editor RFC Editor state AUTH48
NFSv4                                                          T. Haynes
Internet-Draft                                              Primary Data
Intended status: Standards Track                        January 28, 2016
Expires: July 31, 2016

  NFSv4 Minor Version 2 Protocol External Data Representation Standard
                           (XDR) Description
              draft-ietf-nfsv4-minorversion2-dot-x-41.txt

Abstract

   This Internet-Draft provides the XDR description for NFSv4 minor
   version two.

Requirements Language

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC 2119 [RFC2119].

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 http://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 July 31, 2016.

Copyright Notice

   Copyright (c) 2016 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
   (http://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

Haynes                    Expires July 31, 2016                 [Page 1]
Internet-Draft                    NFSv4                     January 2016

   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  XDR Description of NFSv4.2  . . . . . . . . . . . . . . . . .   2
   2.  Security Considerations . . . . . . . . . . . . . . . . . . .  81
   3.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  81
   4.  Normative References  . . . . . . . . . . . . . . . . . . . .  81
   Appendix A.  Acknowledgments  . . . . . . . . . . . . . . . . . .  81
   Appendix B.  RFC Editor Notes . . . . . . . . . . . . . . . . . .  81
   Author's Address  . . . . . . . . . . . . . . . . . . . . . . . .  82

1.  XDR Description of NFSv4.2

   This document contains the XDR ([RFC4506]) description of NFSv4.2
   protocol ([I-D.ietf-nfsv4-minorversion2]).  In order to facilitate
   implementations that support all of NFSv4.0, NFSv4.1, and NFSv4.2,
   the description includes operations, and other features of NFSv4.0
   and NFSv4.1 that do not apply to NFSv4.2.  This XDR specification is
   fully compatible with that for NFSv4.0 ([RFC7531]) with the exception
   of the clientaddr4 structure which has been replaced by (strictly,
   aliased to) netaddr4 which has the same members with the same
   purposes but the names have changed

       (r_netid -> na_r_netid, r_addr ->na_r_addr).

   This effectively fully reconverges the NFSv4.0 ([RFC7531]) and
   NFSv4.1 ([RFC5662]) strands of the XDR.

   The XDR description is provided in this document in a way that makes
   it simple for the reader to extract into ready to compile form.  The
   reader can feed this document in the following shell script to
   produce the machine readable XDR description of NFSv4.2:

   <CODE BEGINS>

   #!/bin/sh
   grep "^  *///" | sed 's?^  */// ??' | sed 's?^  *///$??'

   <CODE ENDS>

   I.e., if the above script is stored in a file called "extract.sh",
   and this document is in a file called "spec.txt", then the reader can
   do:

Haynes                    Expires July 31, 2016                 [Page 2]
Internet-Draft                    NFSv4                     January 2016

   <CODE BEGINS>

    sh extract.sh < spec.txt > nfs4_prot.x

   <CODE ENDS>

   The effect of the script is to remove leading white space from each
   line, plus a sentinel sequence of "///".

   The XDR description, with the sentinel sequence follows:
Show full document text