Content Duration MIME Header Definition
A MIME field that states the playback duration of timed media.
Vaudreuil, G. and G. Parsons, "Content Duration MIME Header Definition", RFC 2424, DOI 10.17487/RFC2424, September 1998, <https://www.rfc-editor.org/info/rfc2424>.
@misc{rfc2424,
series = {Request for Comments},
number = 2424,
howpublished = {RFC 2424},
publisher = {RFC Editor},
doi = {10.17487/RFC2424},
url = {https://www.rfc-editor.org/info/rfc2424},
author = {G. Vaudreuil and G. Parsons},
title = {{Content Duration MIME Header Definition}},
pagetotal = 4,
year = 1998,
month = sep,
} RFC text
Contents
Network Working Group G. Vaudreuil
Request for Comments: 2424 Lucent Technologies
Category: Standards Track G. Parsons
Northern Telecom
September 1998
Content Duration
MIME Header Definition
Status of this Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (1998). All Rights Reserved.
Overview
This document describes the MIME header Content-Duration that is
intended for use with any timed media content (typically audio/* or
video/*).
1. Abstract
This document describes the MIME header Content-Duration that is
intended for use with any time varying media content (typically
audio/* or video/*). The length of time is represented in seconds
without any units indication.
2. Content-Duration Header Field
Time varying media contents, for example, a spoken voice message or a
video clip, have an inherent time duration. Many audio and video
encodings may include their duration as header information or may
allow accurate calculation based on the byte length of the data.
However, it may be useful to present the time duration of the content
in a MIME header to allow its simple determination without dealing
with the actual content.
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 [REQ].
2.1 Syntax
The Content-Duration field's value is a single number specifying the
time duration in seconds of the content. Formally:
duration := "Content-Duration" ":" 1*10DIGIT
Note that practically (though highly unlikely in MIME media), the
upper bound on the numerical value of the time duration is (2^^31 -
1) or 2147483647.
2.2 Semantics
This field represents the time duration of the associated time
varying media content. The time duration is noted in seconds with no
units tag. The time value should be exact, however the exact value
of the time duration cannot be known without opening the content and
playing it. If an exact value must be known, then the latter method
should be used. This mechanism simply allows placing a sender
determined time duration value in the header for easy access.
Though there are several ways to present this duration to the
recipient (e.g. with the inbox headers, when audio attachment
opened), the actual use of this field on reception is a local
implementation issue.
2.3 Example
In this example the content duration represents 33 seconds:
Content-Duration: 33
3. VPIM Usage
The Content-Duration header field for the audio/32KADPCM sub-type is
a useful component of the VPIM specification [VPIM2]. All VPIM
Messages MUST contain this sub-type to carry the audio of a voice
message. It may be useful in some instances (e.g. viewing on a
simple MIME or non-MIME desktop) to have the time duration of the
voice message available without having to open the audio content.
4. Security Considerations
This definition introduces the option of explicitly identifying the
time duration of an audio/* or video/* content outside of the binary
data that forms the content. In some environments (though likely not
the majority), the identification of the actual time duration in a
header field may be a security issue and as a result should not be
noted. Reliance on the time indicated in this header field cannot be
trusted for the purposes of determining the exact size of the data.
The exact length of the data must be determined by examining the data
itself.
5. Authors' Addresses
Glenn W. Parsons
Northern Telecom
P.O. Box 3511, Station C
Ottawa, ON K1Y 4H7
Canada
Phone: +1-613-763-7582
Fax: +1-613-763-4461
EMail: Glenn.Parsons@Nortel.ca
Gregory M. Vaudreuil
Lucent Technologies
17080 Dallas Parkway
Dallas, TX 75248-1905
United States
Phone/Fax: +1-972-733-2722
EMail: GregV@Lucent.Com
6. References
[MIME2] Freed, N., and N. Borenstein, "Multipurpose Internet Mail
Extensions (MIME) Part Two: Media Types", RFC 2046, November
1996.
[VPIM2] Vaudreuil, G., and G. Parsons, "Voice Profile for Internet
Mail - version 2", RFC 2421, September 1998.
[REQ] Bradner, S., "Key words for use in RFCs to Indicate Requirement
Levels", BCP 14, RFC 2119, March 1997.
7. Full Copyright Statement
Copyright (C) The Internet Society (1998). All Rights Reserved.
This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it
or assist in its implementation may be prepared, copied, published
and distributed, in whole or in part, without restriction of any
kind, provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for
copyrights defined in the Internet Standards process must be
followed, or as required to translate it into languages other than
English.
The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
ISO Plain Language
On this page
§1A Duration Value in the MIME Header
Audio and video have a time duration. Although some encodings include duration information or allow it to be calculated from the data, a MIME header can make a sender-determined duration available without processing the content.
The field is intended for timed media, typically audio or video, and its value gives the duration in seconds without a units indication.
The header puts a media duration in the message so a recipient can see it without opening the content. The number is in seconds.
§2.1Syntax and Meaning
The syntax is Content-Duration: followed by one to ten decimal digits. For example, Content-Duration: 33 represents 33 seconds. The theoretical upper bound stated by the RFC is 2147483647.
The value should be exact, but an exact duration cannot be known without opening and playing the content. The receiver's use of the field is a local implementation matter.
A value such as Content-Duration: 33 means the sender reports 33 seconds. To know the exact duration, a recipient has to inspect and play the content.
§3Use with Voice Messages
The RFC identifies the audio/32KADPCM subtype used by VPIM as a useful case for Content-Duration. Making the duration available in the header can help a recipient view the length of a voice message without opening its audio content, including with a simple MIME or non-MIME desktop.
A mail program can show the reported length of a voice message before the recipient opens the audio.
§4Trust and Privacy
The duration is supplied by the sender, and the RFC says it cannot be trusted to determine the exact size of the media data. The data itself must be examined to determine its exact length. In some environments, including the duration in a header may create a security issue, so the sender may choose not to include it.
The value is not verified, so do not use it to determine the actual data size. In some cases, revealing a duration in a header may also be a security concern.