draft-ietf-nfsv4-minorversion2-dot-x-39.txt   draft-ietf-nfsv4-minorversion2-dot-x-40.txt 
NFSv4 T. Haynes NFSv4 T. Haynes
Internet-Draft Primary Data Internet-Draft Primary Data
Intended status: Standards Track September 01, 2015 Intended status: Standards Track January 06, 2016
Expires: March 4, 2016 Expires: July 9, 2016
NFSv4 Minor Version 2 Protocol External Data Representation Standard NFSv4 Minor Version 2 Protocol External Data Representation Standard
(XDR) Description (XDR) Description
draft-ietf-nfsv4-minorversion2-dot-x-39.txt draft-ietf-nfsv4-minorversion2-dot-x-40.txt
Abstract Abstract
This Internet-Draft provides the XDR description for NFSv4 minor This Internet-Draft provides the XDR description for NFSv4 minor
version two. version two.
Requirements Language Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
skipping to change at page 1, line 38 skipping to change at page 1, line 38
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on March 4, 2016. This Internet-Draft will expire on July 9, 2016.
Copyright Notice Copyright Notice
Copyright (c) 2015 IETF Trust and the persons identified as the Copyright (c) 2016 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License. described in the Simplified BSD License.
Table of Contents Table of Contents
1. XDR Description of NFSv4.2 . . . . . . . . . . . . . . . . . 2 1. XDR Description of NFSv4.2 . . . . . . . . . . . . . . . . . 2
2. Security Considerations . . . . . . . . . . . . . . . . . . . 80 2. Security Considerations . . . . . . . . . . . . . . . . . . . 81
3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 81 3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 81
4. Normative References . . . . . . . . . . . . . . . . . . . . 81 4. Normative References . . . . . . . . . . . . . . . . . . . . 81
Appendix A. Acknowledgments . . . . . . . . . . . . . . . . . . 81 Appendix A. Acknowledgments . . . . . . . . . . . . . . . . . . 81
Appendix B. RFC Editor Notes . . . . . . . . . . . . . . . . . . 81 Appendix B. RFC Editor Notes . . . . . . . . . . . . . . . . . . 81
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 81 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 82
1. XDR Description of NFSv4.2 1. XDR Description of NFSv4.2
This document contains the XDR ([RFC4506]) description of NFSv4.2 This document contains the XDR ([RFC4506]) description of NFSv4.2
protocol ([NFSv42]). In order to facilitate implementations that protocol ([I-D.ietf-nfsv4-minorversion2]). In order to facilitate
support all of NFSv4.0, NFSv4.1, and NFSv4.2, the description implementations that support all of NFSv4.0, NFSv4.1, and NFSv4.2,
includes operations, and other features of NFSv4.0 and NFSv4.1 that the description includes operations, and other features of NFSv4.0
do not apply to NFSv4.2. 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 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 it simple for the reader to extract into ready to compile form. The
reader can feed this document in the following shell script to reader can feed this document in the following shell script to
produce the machine readable XDR description of NFSv4.2: produce the machine readable XDR description of NFSv4.2:
<CODE BEGINS> <CODE BEGINS>
#!/bin/sh #!/bin/sh
grep "^ *///" | sed 's?^ */// ??' | sed 's?^ *///$??' grep "^ *///" | sed 's?^ */// ??' | sed 's?^ *///$??'
skipping to change at page 3, line 10 skipping to change at page 3, line 19
<CODE ENDS> <CODE ENDS>
The effect of the script is to remove leading white space from each The effect of the script is to remove leading white space from each
line, plus a sentinel sequence of "///". line, plus a sentinel sequence of "///".
The XDR description, with the sentinel sequence follows: The XDR description, with the sentinel sequence follows:
<CODE BEGINS> <CODE BEGINS>
/// /* /// /*
/// * This file was machine generated for [draft-ietf-nfsv4-minorversion2-39]. /// * This file was machine generated for [draft-ietf-nfsv4-minorversion2-40].
/// * /// *
/// * Last updated Tue Sep 1 13:21:16 PDT 2015 /// * Last updated Wed Jan 6 08:16:17 PST 2016
/// */ /// */
/// ///
/// /* /// /*
/// * Copyright (c) 2015 IETF Trust and the persons identified /// * Copyright (c) 2015 IETF Trust and the persons identified
/// * as the document authors. All rights reserved. /// * as the document authors. All rights reserved.
/// * /// *
/// * The Redistribution and use in source and binary forms, with /// * The Redistribution and use in source and binary forms, with
/// * or without modification, are permitted provided that the /// * or without modification, are permitted provided that the
/// * following conditions are met: /// * following conditions are met:
/// * /// *
/// * - Redistributions of source code must retain the above /// * - Redistributions of source code must retain the above
/// * copyright notice, this list of conditions and the /// * copyright notice, this list of conditions and the
/// * following disclaimer. /// * following disclaimer.
/// * /// *
/// * - Redistributions in binary form must reproduce the above /// * - Redistributions in binary form must reproduce the above
/// * copyright notice, this list of conditions and the /// * copyright notice, this list of conditions and the
/// * following disclaimer in the documentation and/or other /// * following disclaimer in the documentation and/or other
/// * materials provided with the distribution. /// * materials provided with the distribution.
/// * /// *
/// * - Neither the name of Internet Society Society, IETF or IETF /// * - Neither the name of Internet Society, IETF or IETF
/// * Trust, nor the names of specific contributors, may be /// * Trust, nor the names of specific contributors, may be
/// * used to endorse or promote products derived from this /// * used to endorse or promote products derived from this
/// * software without specific prior written permission. /// * software without specific prior written permission.
/// * /// *
/// * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS /// * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
/// * AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED /// * AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
/// * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE /// * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
/// * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS /// * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
/// * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO /// * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
/// * EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE /// * EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
skipping to change at page 4, line 7 skipping to change at page 4, line 16
/// * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS /// * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
/// * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF /// * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
/// * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, /// * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
/// * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING /// * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
/// * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF /// * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
/// * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. /// * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
/// ///
/// */ /// */
/// ///
/// /* /// /*
/// * This code was derived from [draft-ietf-nfsv4-minorversion2-dot-x-39]. /// * This code was derived from [draft-ietf-nfsv4-minorversion2-dot-x-40].
/// */ /// */
/// ///
/// /* /// /*
/// * Copyright (C) The IETF Trust (2007-2014) /// * Copyright (C) The IETF Trust (2007-2014)
/// * All Rights Reserved. /// * All Rights Reserved.
/// * /// *
/// * Copyright (C) The Internet Society (1998-2006). /// * Copyright (C) The Internet Society (1998-2006).
/// * All Rights Reserved. /// * All Rights Reserved.
/// */ /// */
/// ///
skipping to change at page 20, line 35 skipping to change at page 20, line 44
/// typedef uint64_t fattr4_mounted_on_fileid; /// typedef uint64_t fattr4_mounted_on_fileid;
/// typedef bool fattr4_no_trunc; /// typedef bool fattr4_no_trunc;
/// typedef uint32_t fattr4_numlinks; /// typedef uint32_t fattr4_numlinks;
/// typedef utf8str_mixed fattr4_owner; /// typedef utf8str_mixed fattr4_owner;
/// typedef utf8str_mixed fattr4_owner_group; /// typedef utf8str_mixed fattr4_owner_group;
/// typedef uint64_t fattr4_quota_avail_hard; /// typedef uint64_t fattr4_quota_avail_hard;
/// typedef uint64_t fattr4_quota_avail_soft; /// typedef uint64_t fattr4_quota_avail_soft;
/// typedef uint64_t fattr4_quota_used; /// typedef uint64_t fattr4_quota_used;
/// typedef specdata4 fattr4_rawdev; /// typedef specdata4 fattr4_rawdev;
/// typedef uint64_t fattr4_space_avail; /// typedef uint64_t fattr4_space_avail;
/// typedef uint64_t fattr4_space_free; /// typedef length4 fattr4_space_free;
/// typedef uint64_t fattr4_space_total; /// typedef uint64_t fattr4_space_total;
/// typedef uint64_t fattr4_space_used; /// typedef uint64_t fattr4_space_used;
/// typedef bool fattr4_system; /// typedef bool fattr4_system;
/// typedef nfstime4 fattr4_time_access; /// typedef nfstime4 fattr4_time_access;
/// typedef settime4 fattr4_time_access_set; /// typedef settime4 fattr4_time_access_set;
/// typedef nfstime4 fattr4_time_backup; /// typedef nfstime4 fattr4_time_backup;
/// typedef nfstime4 fattr4_time_create; /// typedef nfstime4 fattr4_time_create;
/// typedef nfstime4 fattr4_time_delta; /// typedef nfstime4 fattr4_time_delta;
/// typedef nfstime4 fattr4_time_metadata; /// typedef nfstime4 fattr4_time_metadata;
/// typedef nfstime4 fattr4_time_modify; /// typedef nfstime4 fattr4_time_modify;
skipping to change at page 78, line 29 skipping to change at page 78, line 39
/// OP_CB_SEQUENCE = 11, /// OP_CB_SEQUENCE = 11,
/// OP_CB_WANTS_CANCELLED = 12, /// OP_CB_WANTS_CANCELLED = 12,
/// OP_CB_NOTIFY_LOCK = 13, /// OP_CB_NOTIFY_LOCK = 13,
/// OP_CB_NOTIFY_DEVICEID = 14, /// OP_CB_NOTIFY_DEVICEID = 14,
/// %/* Callback operations new to NFSv4.2 */ /// %/* Callback operations new to NFSv4.2 */
/// OP_CB_OFFLOAD = 15, /// OP_CB_OFFLOAD = 15,
/// ///
/// OP_CB_ILLEGAL = 10044 /// OP_CB_ILLEGAL = 10044
/// }; /// };
/// ///
/// union nfs_cb_argop4 switch (unsigned argop) { /// union nfs_cb_argop4 switch (nfs_cb_opnum4 argop) {
/// case OP_CB_GETATTR: /// case OP_CB_GETATTR:
/// CB_GETATTR4args opcbgetattr; /// CB_GETATTR4args opcbgetattr;
/// ///
/// /* new NFSv4.1 operations */ /// /* new NFSv4.1 operations */
/// case OP_CB_RECALL: /// case OP_CB_RECALL:
/// CB_RECALL4args opcbrecall; /// CB_RECALL4args opcbrecall;
/// case OP_CB_LAYOUTRECALL: /// case OP_CB_LAYOUTRECALL:
/// CB_LAYOUTRECALL4args opcblayoutrecall; /// CB_LAYOUTRECALL4args opcblayoutrecall;
/// case OP_CB_NOTIFY: /// case OP_CB_NOTIFY:
/// CB_NOTIFY4args opcbnotify; /// CB_NOTIFY4args opcbnotify;
skipping to change at page 79, line 16 skipping to change at page 79, line 26
/// case OP_CB_NOTIFY_DEVICEID: /// case OP_CB_NOTIFY_DEVICEID:
/// CB_NOTIFY_DEVICEID4args opcbnotify_deviceid; /// CB_NOTIFY_DEVICEID4args opcbnotify_deviceid;
/// ///
/// /* new NFSv4.2 operations */ /// /* new NFSv4.2 operations */
/// case OP_CB_OFFLOAD: /// case OP_CB_OFFLOAD:
/// CB_OFFLOAD4args opcboffload; /// CB_OFFLOAD4args opcboffload;
/// ///
/// case OP_CB_ILLEGAL: void; /// case OP_CB_ILLEGAL: void;
/// }; /// };
/// ///
/// union nfs_cb_resop4 switch (unsigned resop) { /// union nfs_cb_resop4 switch (nfs_cb_opnum4 resop) {
/// case OP_CB_GETATTR: CB_GETATTR4res opcbgetattr; /// case OP_CB_GETATTR: CB_GETATTR4res opcbgetattr;
/// case OP_CB_RECALL: CB_RECALL4res opcbrecall; /// case OP_CB_RECALL: CB_RECALL4res opcbrecall;
/// ///
/// /* new NFSv4.1 operations */ /// /* new NFSv4.1 operations */
/// case OP_CB_LAYOUTRECALL: /// case OP_CB_LAYOUTRECALL:
/// CB_LAYOUTRECALL4res /// CB_LAYOUTRECALL4res
/// opcblayoutrecall; /// opcblayoutrecall;
/// ///
/// case OP_CB_NOTIFY: CB_NOTIFY4res opcbnotify; /// case OP_CB_NOTIFY: CB_NOTIFY4res opcbnotify;
/// ///
skipping to change at page 80, line 34 skipping to change at page 80, line 42
/// nfsstat4 status; /// nfsstat4 status;
/// utf8str_cs tag; /// utf8str_cs tag;
/// nfs_cb_resop4 resarray<>; /// nfs_cb_resop4 resarray<>;
/// }; /// };
/// ///
/// ///
/// ///
/// /* /// /*
/// * Program number is in the transient range since the client /// * Program number is in the transient range since the client
/// * will assign the exact transient program number and provide /// * will assign the exact transient program number and provide
/// * that to the server via the SETCLIENTID operation. /// * that to the server via the CREATE_SESSION or
/// * BACKCHANNEL_CTL operations.
/// */ /// */
/// program NFS4_CALLBACK { /// program NFS4_CALLBACK {
/// version NFS_CB { /// version NFS_CB {
/// void /// void
/// CB_NULL(void) = 0; /// CB_NULL(void) = 0;
/// CB_COMPOUND4res /// CB_COMPOUND4res
/// CB_COMPOUND(CB_COMPOUND4args) = 1; /// CB_COMPOUND(CB_COMPOUND4args) = 1;
/// } = 1; /// } = 1;
/// } = 0x40000000; /// } = 0x40000000;
<CODE ENDS> <CODE ENDS>
2. Security Considerations 2. Security Considerations
See the Security Considerations section of [NFSv42]. See the Security Considerations section of
[I-D.ietf-nfsv4-minorversion2].
3. IANA Considerations 3. IANA Considerations
See the IANA Considerations section of [NFSv42]. See the IANA Considerations section of
[I-D.ietf-nfsv4-minorversion2].
4. Normative References 4. Normative References
[NFSv42] Haynes, T., "NFS Version 4 Minor Version 2", draft-ietf- [I-D.ietf-nfsv4-minorversion2]
nfsv4-minorversion2-29 (Work In Progress), December 2014. Haynes, T., "NFS Version 4 Minor Version 2", draft-ietf-
nfsv4-minorversion2-40 (work in progress), January 2016.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", March 1997. Requirement Levels", March 1997.
[RFC4506] Eisler, M., "XDR: External Data Representation Standard", [RFC4506] Eisler, M., "XDR: External Data Representation Standard",
STD 67, RFC 4506, May 2006. STD 67, RFC 4506, May 2006.
[RFC5662] Shepler, S., Eisler, M., and D. Noveck, "Network File
System (NFS) Version 4 Minor Version 1 External Data
Representation Standard (XDR) Description", RFC 5662,
January 2010.
[RFC7531] Haynes, T. and D. Noveck, "Network File System (NFS)
version 4 Protocol External Data Representation Standard
(XDR) Description", RFC 7531, March 2015.
Appendix A. Acknowledgments Appendix A. Acknowledgments
Tom Haynes would like to thank NetApp, Inc. for its funding of his Tom Haynes would like to thank NetApp, Inc. for its funding of his
time on this project. time on this project.
Appendix B. RFC Editor Notes Appendix B. RFC Editor Notes
[RFC Editor: please remove this section prior to publishing this [RFC Editor: please remove this section prior to publishing this
document as an RFC] document as an RFC]
[RFC Editor: prior to publishing this document as an RFC, please [RFC Editor: prior to publishing this document as an RFC, please
replace all occurrences of NFSv42 with RFCxxxx where xxxx is the RFC replace all occurrences of I-D.ietf-nfsv4-minorversion2 with RFCxxxx
number of the companion document] where xxxx is the RFC number of the companion document]
Author's Address Author's Address
Thomas Haynes Thomas Haynes
Primary Data, Inc. Primary Data, Inc.
4300 El Camino Real Ste 100 4300 El Camino Real Ste 100
Los Altos, CA 94022 Los Altos, CA 94022
USA USA
Phone: +1-408-215-1519 Phone: +1-408-215-1519
 End of changes. 20 change blocks. 
25 lines changed or deleted 47 lines changed or added

This html diff was produced by rfcdiff 1.42. The latest version is available from http://tools.ietf.org/tools/rfcdiff/