Difference between revisions of "RFC6474"

From RFC-Wiki
imported>Admin
(Created page with " Internet Engineering Task Force (IETF) K. Li Request for Comments: 6474 B. Leiba Category: Standards Tra...")
 
 
Line 1: Line 1:
 
 
 
 
 
 
 
Internet Engineering Task Force (IETF)                            K. Li
 
Internet Engineering Task Force (IETF)                            K. Li
 
Request for Comments: 6474                                      B. Leiba
 
Request for Comments: 6474                                      B. Leiba
 
Category: Standards Track                            Huawei Technologies
 
Category: Standards Track                            Huawei Technologies
 
ISSN: 2070-1721                                            December 2011
 
ISSN: 2070-1721                                            December 2011
 
  
 
  vCard Format Extensions: Place of Birth, Place and Date of Death
 
  vCard Format Extensions: Place of Birth, Place and Date of Death
  
Abstract
+
'''Abstract'''
  
 
The base vCard 4.0 specification defines a large number of
 
The base vCard 4.0 specification defines a large number of
Line 20: Line 13:
 
of death.
 
of death.
  
Status of This Memo
+
'''Status of This Memo'''
  
 
This is an Internet Standards Track document.
 
This is an Internet Standards Track document.
Line 34: Line 27:
 
http://www.rfc-editor.org/info/rfc6474.
 
http://www.rfc-editor.org/info/rfc6474.
  
Copyright Notice
+
'''Copyright Notice'''
  
 
Copyright (c) 2011 IETF Trust and the persons identified as the
 
Copyright (c) 2011 IETF Trust and the persons identified as the
Line 48: Line 41:
 
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.
 
 
 
 
 
 
 
 
 
  
 
== Introduction ==
 
== Introduction ==
  
The base vCard 4.0 specification [RFC6350] defines a large number of
+
The base vCard 4.0 specification [[RFC6350]] defines a large number of
 
properties, including date of birth.  This specification adds three
 
properties, including date of birth.  This specification adds three
 
new properties to vCard 4.0: place of birth, place of death, and date
 
new properties to vCard 4.0: place of birth, place of death, and date
Line 69: Line 53:
 
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
document are to be interpreted as described in [RFC2119].
+
document are to be interpreted as described in [[RFC2119]].
  
 
Syntax specifications shown here use the augmented Backus-Naur Form
 
Syntax specifications shown here use the augmented Backus-Naur Form
(ABNF) as described in [RFC5234], and are specified as in the base
+
(ABNF) as described in [[RFC5234]], and are specified as in the base
vCard specification [RFC6350].
+
vCard specification [[RFC6350]].
  
 
== Identification Property Extensions ==
 
== Identification Property Extensions ==
Line 91: Line 75:
  
 
Property parameters:  VALUE, LANGUAGE
 
Property parameters:  VALUE, LANGUAGE
 
 
 
 
 
 
  
 
Description:
 
Description:
Line 144: Line 122:
 
   DEATHPLACE;VALUE=uri:http://example.com/ships/titanic.vcf
 
   DEATHPLACE;VALUE=uri:http://example.com/ships/titanic.vcf
 
   DEATHPLACE;VALUE=uri:geo:41.731944,-49.945833
 
   DEATHPLACE;VALUE=uri:geo:41.731944,-49.945833
 
 
 
 
 
 
  
 
=== Property: DEATHDATE ===
 
=== Property: DEATHDATE ===
Line 196: Line 168:
 
   DEATHDATE;19531015T231000Z
 
   DEATHDATE;19531015T231000Z
 
   DEATHDATE;VALUE=text:circa 1800
 
   DEATHDATE;VALUE=text:circa 1800
 
 
 
 
 
 
 
  
 
== Security Considerations ==
 
== Security Considerations ==
Line 208: Line 173:
 
The properties defined in this document present no security
 
The properties defined in this document present no security
 
considerations beyond those in Section 9 of the base vCard
 
considerations beyond those in Section 9 of the base vCard
specification [RFC6350].
+
specification [[RFC6350]].
  
 
== IANA Considerations ==
 
== IANA Considerations ==
  
 
IANA has added the following entries to the vCard Properties
 
IANA has added the following entries to the vCard Properties
registry, defined in Section 10.3.1 of [RFC6350].
+
registry, defined in Section 10.3.1 of [[RFC6350]].
  
 
       +-----------+--------------+------------------------+
 
       +-----------+--------------+------------------------+
 
       | Namespace | Property    | Reference              |
 
       | Namespace | Property    | Reference              |
 
       +-----------+--------------+------------------------+
 
       +-----------+--------------+------------------------+
       |          | BIRTHPLACE  | [RFC6474], Section 2.1 |
+
       |          | BIRTHPLACE  | [[RFC6474]], Section 2.1 |
       |          | DEATHPLACE  | [RFC6474], Section 2.2 |
+
       |          | DEATHPLACE  | [[RFC6474]], Section 2.2 |
       |          | DEATHDATE    | [RFC6474], Section 2.3 |
+
       |          | DEATHDATE    | [[RFC6474]], Section 2.3 |
 
       +-----------+--------------+------------------------+
 
       +-----------+--------------+------------------------+
  
Line 231: Line 196:
 
== Normative References ==
 
== Normative References ==
  
[RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
+
[[RFC2119]]  Bradner, S., "Key words for use in RFCs to Indicate
 
           Requirement Levels", [[BCP14|BCP 14]], [[RFC2119|RFC 2119]], March 1997.
 
           Requirement Levels", [[BCP14|BCP 14]], [[RFC2119|RFC 2119]], March 1997.
  
[RFC5234]  Crocker, D., Ed., and P. Overell, "Augmented BNF for
+
[[RFC5234]]  Crocker, D., Ed., and P. Overell, "Augmented BNF for
           Syntax Specifications: ABNF", STD 68, [[RFC5234|RFC 5234]],
+
           Syntax Specifications: ABNF", [[STD68|STD 68]], [[RFC5234|RFC 5234]],
 
           January 2008.
 
           January 2008.
  
[RFC6350]  Perreault, S., "vCard Format Specification", [[RFC6350|RFC 6350]],
+
[[RFC6350]]  Perreault, S., "vCard Format Specification", [[RFC6350|RFC 6350]],
 
           August 2011.
 
           August 2011.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  
 
Authors' Addresses
 
Authors' Addresses
Line 267: Line 216:
 
Phone: +86-755-28974289
 
Phone: +86-755-28974289
  
 
  
 
Barry Leiba
 
Barry Leiba
Line 275: Line 223:
  
 
URI:  http://internetmessagingtechnology.org/
 
URI:  http://internetmessagingtechnology.org/
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  
 
[[Category:Standards Track]]
 
[[Category:Standards Track]]

Latest revision as of 12:37, 1 October 2020

Internet Engineering Task Force (IETF) K. Li Request for Comments: 6474 B. Leiba Category: Standards Track Huawei Technologies ISSN: 2070-1721 December 2011

vCard Format Extensions: Place of Birth, Place and Date of Death

Abstract

The base vCard 4.0 specification defines a large number of properties, including date of birth. This specification adds three new properties to vCard 4.0: place of birth, place of death, and date of death.

Status of This Memo

This is an Internet Standards Track document.

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 5741.

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc6474.

Copyright Notice

Copyright (c) 2011 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 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.

Introduction

The base vCard 4.0 specification RFC6350 defines a large number of properties, including date of birth. This specification adds three new properties to vCard 4.0: place of birth, place of death, and date of death.

Terminology Used in This Document

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

Syntax specifications shown here use the augmented Backus-Naur Form (ABNF) as described in RFC5234, and are specified as in the base vCard specification RFC6350.

Identification Property Extensions

Property: BIRTHPLACE

Namespace:

Property name: BIRTHPLACE

Purpose: To specify the place of birth of the object the vCard

         represents.

Value type: A single text value (default) or a single URI value.

Cardinality: *1

Property parameters: VALUE, LANGUAGE

Description:

Format definition:

  BIRTHPLACE-param =  "VALUE=" ("text" / "uri")
  BIRTHPLACE-value =  text / uri
     ; Value type and VALUE parameter MUST match.
  BIRTHPLACE-param =/  altid-param / language-param / any-param

Examples:

  BIRTHPLACE:Babies'R'Us Hospital
  BIRTHPLACE;VALUE=uri:http://example.com/hospitals/babiesrus.vcf
  BIRTHPLACE;VALUE=uri:geo:46.769307,-71.283079

Property: DEATHPLACE

Namespace:

Property name: DEATHPLACE

Purpose: To specify the place of death of the object the vCard

         represents.

Value type: A single text value (default) or a single URI value.

Cardinality: *1

Property parameters: VALUE, LANGUAGE

Description:

Format definition:

  DEATHPLACE-param =  "VALUE=" ("text" / "uri")
  DEATHPLACE-value =  text / uri
     ; Value type and VALUE parameter MUST match.
  DEATHPLACE-param =/  altid-param / language-param / any-param

Examples:

  DEATHPLACE:Aboard the Titanic\, near Newfoundland
  DEATHPLACE;VALUE=uri:http://example.com/ships/titanic.vcf
  DEATHPLACE;VALUE=uri:geo:41.731944,-49.945833

Property: DEATHDATE

Namespace:

Property name: DEATHDATE

Purpose: To specify the date of death of the object the vCard

         represents.

Value type: The default is a single date-and-or-time value. It can

            also be reset to a single text value.

Cardinality: *1

Property parameters: VALUE, CALSCALE, LANGUAGE

  CALSCALE can only be present when the value is a
  date-and-or-time value and actually contains a date or date-time.
  LANGUAGE can only be present when the value is text.

Description: The presence of a DEATHDATE property indicates that the

             subject of the vCard is known to be dead.  The absence
             of this property makes no statement one way or the
             other.

Format definition:

  DEATHDATE-param =  DEATHDATE-param-date / DEATHDATE-param-text
  DEATHDATE-value =  date-and-or-time / text
     ; Value type and VALUE parameter MUST match.
  DEATHDATE-param-date =  "VALUE=date-and-or-time" / calscale-param
     ; calscale-param can only be present when DEATHDATE-value is
     ; date-and-or-time and actually contains a date or date-time.
  DEATHDATE-param-date =  "VALUE=text" / language-param
  DEATHDATE-param =/  altid-param / any-param

Examples:

  DEATHDATE:19960415
  DEATHDATE:--0415
  DEATHDATE;19531015T231000Z
  DEATHDATE;VALUE=text:circa 1800

Security Considerations

The properties defined in this document present no security considerations beyond those in Section 9 of the base vCard specification RFC6350.

IANA Considerations

IANA has added the following entries to the vCard Properties registry, defined in Section 10.3.1 of RFC6350.

     +-----------+--------------+------------------------+
     | Namespace | Property     | Reference              |
     +-----------+--------------+------------------------+
     |           | BIRTHPLACE   | RFC6474, Section 2.1 |
     |           | DEATHPLACE   | RFC6474, Section 2.2 |
     |           | DEATHDATE    | RFC6474, Section 2.3 |
     +-----------+--------------+------------------------+

Acknowledgements

The authors of this document would like to thank Simon Perreault and Pete Resnick, the authors of a draft version of RFC 6350 whence the properties defined herein originated.

Normative References

RFC2119 Bradner, S., "Key words for use in RFCs to Indicate

          Requirement Levels", BCP 14, RFC 2119, March 1997.

RFC5234 Crocker, D., Ed., and P. Overell, "Augmented BNF for

          Syntax Specifications: ABNF", STD 68, RFC 5234,
          January 2008.

RFC6350 Perreault, S., "vCard Format Specification", RFC 6350,

          August 2011.

Authors' Addresses

Kepeng Li Huawei Technologies Huawei Base, Bantian, Longgang District Shenzhen, Guangdong 518129 P.R. China

Phone: +86-755-28974289 EMail: [email protected]

Barry Leiba Huawei Technologies

Phone: +1 646 827 0648 EMail: [email protected] URI: http://internetmessagingtechnology.org/