idnits 2.17.1 draft-malkin-tftpexts-options-00.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Cannot find the required boilerplate sections (Copyright, IPR, etc.) in this document. Expected boilerplate is as follows today (2024-04-26) according to https://trustee.ietf.org/license-info : IETF Trust Legal Provisions of 28-dec-2009, Section 6.a: This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 2: Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved. IETF Trust Legal Provisions of 28-dec-2009, Section 6.b(i), paragraph 3: 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 the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- ** Missing document type: Expected "INTERNET-DRAFT" in the upper left hand corner of the first page ** Missing expiration date. The document expiration date should appear on the first and last page. ** The document seems to lack a 1id_guidelines paragraph about Internet-Drafts being working documents. ** The document seems to lack a 1id_guidelines paragraph about the list of current Internet-Drafts. ** The document seems to lack a 1id_guidelines paragraph about the list of Shadow Directories. == No 'Intended status' indicated for this document; assuming Proposed Standard Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an Introduction section. ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** The document seems to lack separate sections for Informative/Normative References. All references will be assumed normative when checking for downward references. ** The abstract seems to contain references ([2], [1]), which it shouldn't. Please replace those with straight textual mentions of the documents in question. Miscellaneous warnings: ---------------------------------------------------------------------------- -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (January 1998) is 9598 days in the past. Is this intentional? -- Found something which looks like a code comment -- if you have code sections in the document, please surround them with '' and '' lines. Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) -- Unexpected draft version: The latest known version of draft-ietf-tftpexts-options is -00, but you're referring to -02. Summary: 10 errors (**), 0 flaws (~~), 1 warning (==), 4 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 draft-malkin-tftpexts-options-00.txt G. Malkin / Bay Networks 3 TFTP Blocksize Option A. Harkin / Hewlett Packard Co. 4 January 1998 6 TFTP Timeout Interval and Transfer Size Options 8 Abstract 10 The Trivial File Transfer Protocol [1] is a simple, lock-step, file 11 transfer protocol which allows a client to get or put a file onto a 12 remote host. 14 This document describes two TFTP options. The first allows the client 15 and server to negotiate the Timeout Interval. The second allows the 16 side receiving the file to determine the ultimate size of the 17 transfer before it begins. The TFTP Option Extension mechanism is 18 described in [2]. 20 Status of this Memo 22 This document is an Internet-Draft. Internet-Drafts are working 23 documents of the Internet Engineering Task Force (IETF), its areas, 24 and its working groups. Note that other groups may also distribute 25 working documents as Internet-Drafts. 27 Internet-Drafts are draft documents valid for a maximum of six months 28 and may be updated, replaced, or obsoleted by other documents at any 29 time. It is inappropriate to use Internet-Drafts as reference 30 material or to cite them other than as "work in progress." 32 To learn the current status of any Internet-Draft, please check the 33 "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow 34 Directories on ds.internic.net (US East Coast), nic.nordu.net 35 (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific 36 Rim). 38 Timeout Interval Option Specification 40 The TFTP Read Request or Write Request packet is modified to include 41 the timeout option as follows: 43 +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ 44 | opc |filename| 0 | mode | 0 | timeout| 0 | #secs | 0 | 45 +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ 46 opc 47 The opcode field contains either a 1, for Read Requests, or 2, 48 for Write Requests, as defined in [1]. 50 filename 51 The name of the file to be read or written, as defined in [1]. 52 This is a NULL-terminated field. 54 mode 55 The mode of the file transfer: "netascii", "octet", or "mail", 56 as defined in [1]. This is a NULL-terminated field. 58 timeout 59 The Timeout Interval option, "timeout" (case in-sensitive). 60 This is a NULL-terminated field. 62 #secs 63 The number of seconds to wait before retransmitting, specified 64 in ASCII. Valid values range between "1" and "255" octets, 65 inclusive. This is a NULL-terminated field. 67 For example: 69 +-------+--------+---+--------+---+--------+---+--------+---+ 70 | 1 | foobar | 0 | binary | 0 | timeout| 0 | 1 | 0 | 71 +-------+--------+---+--------+---+--------+---+--------+---+ 73 is a Read Request, for the file named "foobar", in binary transfer 74 mode, with a timeout interval of 1 second. 76 If the server is willing to accept the timeout option, it sends an 77 Option Acknowledgment (OACK) to the client. The specified timeout 78 value must match the value specified by the client. 80 Transfer Size Option Specification 82 The TFTP Read Request or Write Request packet is modified to include 83 the tsize option as follows: 85 +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ 86 | opc |filename| 0 | mode | 0 | tsize | 0 | size | 0 | 87 +-------+---~~---+---+---~~---+---+---~~---+---+---~~---+---+ 89 opc 90 The opcode field contains either a 1, for Read Requests, or 2, 91 for Write Requests, as defined in [1]. 93 filename 94 The name of the file to be read or written, as defined in [1]. 95 This is a NULL-terminated field. 97 mode 98 The mode of the file transfer: "netascii", "octet", or "mail", 99 as defined in [1]. This is a NULL-terminated field. 101 tsize 102 The Transfer Size option, "tsize" (case in-sensitive). This is 103 a NULL-terminated field. 105 size 106 The size of the file to be transfered. This is a NULL- 107 terminated field. 109 For example: 111 +-------+--------+---+--------+---+--------+---+--------+---+ 112 | 2 | foobar | 0 | binary | 0 | tsize | 0 | 673312 | 0 | 113 +-------+--------+---+--------+---+--------+---+--------+---+ 115 is a Write Request, with the 673312-octet file named "foobar", in 116 binary transfer mode. 118 In Read Request packets, a size of "0" is specified in the request 119 and the size of the file, in octets, is returned in the OACK. If the 120 file is too large for the client to handle, it may abort the transfer 121 with an Error packet (error code 3). In Write Request packets, the 122 size of the file, in octets, is specified in the request and echoed 123 back in the OACK. If the file is too large for the server to handle, 124 it may abort the transfer with an Error packet (error code 3). 126 Security Considerations 128 The basic TFTP protocol has no security mechanism. This is why it 129 has no rename, delete, or file overwrite capabilities. This document 130 does not add any security to TFTP; however, the specified extensions 131 do not add any additional security risks. 133 References 135 [1] Sollins, K., "The TFTP Protocol (Revision 2)", Request for 136 Comments 1350 (STD 33), October 1992. 138 [2] Malkin, G., Harkin, A., "TFTP Option Extension", Internet Draft, 139 draft-ietf-tftpexts-options-02.txt, December 1994. 141 Authors' Addresses 143 Gary Scott Malkin 144 Bay Networks 145 8 Federal Street 146 Billerica, MA 01821 148 Phone: (978) 916-4237 149 EMail: gmalkin@baynetworks.com 151 Art Harkin 152 Internet Services Project 153 Information Networks Division 154 19420 Homestead Road MS 43LN 155 Cupertino, CA 95014 157 Phone: (408) 447-3755 158 EMail: ash@cup.hp.com