draft-ietf-asid-mime-vcard-05.txt   draft-ietf-asid-mime-vcard-06.txt 
Network Working Group Frank Dawson Network Working Group Frank Dawson
Request for Comments: DRAFT Lotus Development Corporation Request for Comments: DRAFT Lotus Development Corporation
draft-ietf-asid-mime-vcard-05.txt Tim Howes draft-ietf-asid-mime-vcard-06.txt Tim Howes
March 8, 1998 Netscape Communications Expires six months after April 17, 1998 Netscape Communications
vCard MIME Directory Profile vCard MIME Directory Profile
Status of this Memo Status of this Memo
This document is an Internet-Draft. Internet-Drafts are working This document is an Internet-Draft. Internet-Drafts are working
documents of the Internet Engineering Task Force (IETF), its areas, documents of the Internet Engineering Task Force (IETF), its areas,
and its working groups. Note that other groups may also distribute and its working groups. Note that other groups may also distribute
working documents as Internet-Drafts. working documents as Internet-Drafts.
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."
To learn the current status of any Internet-Draft, please check the To view the entire list of current Internet-Drafts, please check
"1id-abstracts.txt" listing contained in the Internet- Drafts Shadow the "1id-abstracts.txt" listing contained in the Internet-Drafts
Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe), Shadow Directories on ftp.is.co.za (Africa), ftp.nordu.net
munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or (Northern Europe), ftp.nis.garr.it (Southern Europe), munnari.oz.au
ftp.isi.edu (US West Coast). (Pacific Rim), ftp.ietf.org (US East Coast), or ftp.isi.edu
(US West Coast).
Distribution of this memo is unlimited. Distribution of this memo is unlimited.
Copyright (C) The Internet Society 1997. All Rights Reserved. Copyright (C) The Internet Society 1997. All Rights Reserved.
Abstract Abstract
This memo defines the profile of the MIME Content-Type [MIME-DIR] for This memo defines the profile of the MIME Content-Type [MIME-DIR] for
directory information for a white-pages person object, based on a directory information for a white-pages person object, based on a
vCard electronic business card. The profile definition is independent vCard electronic business card. The profile definition is independent
skipping to change at page 2, line 5 skipping to change at line 52
profile is based on the attributes for the person object defined in profile is based on the attributes for the person object defined in
the X.520 and X.521 directory services recommendations. The profile the X.520 and X.521 directory services recommendations. The profile
also provides the method for including a [VCARD] representation of a also provides the method for including a [VCARD] representation of a
white-pages directory entry within the MIME Content-Type defined by white-pages directory entry within the MIME Content-Type defined by
the [MIME-DIR] document. the [MIME-DIR] document.
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 interopreted as described in [RFC 2119]. document are to be interopreted as described in [RFC 2119].
Dawson & Howes [Page 1] October 1998
vCard MIME Directory Profile vCard MIME Directory Profile
Table of Contents Table of Contents
1. THE VCARD MIME DIRECTORY PROFILE REGISTRATION.......................4 1. THE VCARD MIME DIRECTORY PROFILE REGISTRATION.......................4
2. MIME DIRECTORY FEATURES.............................................5 2. MIME DIRECTORY FEATURES.............................................5
2.1 PREDEFINED TYPE USAGE............................................5 2.1 PREDEFINED TYPE USAGE............................................5
2.1.1 BEGIN and END Type............................................5 2.1.1 BEGIN and END Type............................................5
2.1.2 NAME Type.....................................................5 2.1.2 NAME Type .....................................................6
2.1.3 PROFILE Type..................................................6 2.1.3 PROFILE Type..................................................6
2.1.4 SOURCE Type...................................................6 2.1.4 SOURCE Type...................................................6
2.2 PREDEFINED TYPE PARAMETER USAGE..................................6 2.2 PREDEFINED TYPE PARAMETER USAGE..................................6
2.3 PREDEFINED VALUE TYPE USAGE......................................6 2.3 PREDEFINED VALUE TYPE USAGE......................................6
2.4 EXTENSIONS TO THE PREDEFINED VALUE TYPES.........................6 2.4 EXTENSIONS TO THE PREDEFINED VALUE TYPES.........................6
2.4.1 BINARY........................................................6 2.4.1 BINARY........................................................6
2.4.2 VCARD.........................................................7 2.4.2 VCARD.........................................................7
2.4.3 PHONE-NUMBER..................................................7 2.4.3 PHONE-NUMBER..................................................7
2.4.4 UTC-OFFSET....................................................7 2.4.4 UTC-OFFSET....................................................7
2.5 STRUCTURED TYPE VALUES...........................................7 2.5 STRUCTURED TYPE VALUES ...........................................8
2.6 LINE DELIMITING AND FOLDING......................................8 2.6 LINE DELIMITING AND FOLDING......................................8
3. VCARD PROFILE FEATURES..............................................8 3. VCARD PROFILE FEATURES..............................................8
3.1 IDENTIFICATION TYPES.............................................8 3.1 IDENTIFICATION TYPES.............................................8
3.1.1 FN Type Definition............................................8 3.1.1 FN Type Definition............................................8
3.1.2 N Type Definition.............................................8 3.1.2 N Type Definition .............................................9
3.1.3 NICKNAME Type Definition......................................9 3.1.3 NICKNAME Type Definition......................................9
3.1.4 PHOTO Type Definition........................................10 3.1.4 PHOTO Type Definition........................................10
3.1.5 BDAY Type Definition.........................................10 3.1.5 BDAY Type Definition.........................................10
3.2 DELIVERY ADDRESSING TYPES.......................................11 3.2 DELIVERY ADDRESSING TYPES.......................................11
3.2.1 ADR Type Definition..........................................11 3.2.1 ADR Type Definition..........................................11
3.2.2 LABEL Type Definition........................................12 3.2.2 LABEL Type Definition........................................12
3.3 TELECOMMUNICATIONS ADDRESSING TYPES.............................13 3.3 TELECOMMUNICATIONS ADDRESSING TYPES.............................13
3.3.1 TEL Type Definition..........................................13 3.3.1 TEL Type Definition..........................................13
3.3.2 EMAIL Type Definition........................................14 3.3.2 EMAIL Type Definition........................................14
3.3.3 MAILER Type Definition.......................................14 3.3.3 MAILER Type Definition.......................................14
3.4 GEOGRAPHICAL TYPES..............................................15 3.4 GEOGRAPHICAL TYPES..............................................15
3.4.1 TZ Type Definition...........................................15 3.4.1 TZ Type Definition...........................................15
3.4.2 GEO Type Definition..........................................15 3.4.2 GEO Type Definition..........................................15
3.5 ORGANIZATIONAL TYPES............................................16 3.5 ORGANIZATIONAL TYPES............................................16
3.5.1 TITLE Type Definition........................................16 3.5.1 TITLE Type Definition........................................16
3.5.2 ROLE Type Definition.........................................16 3.5.2 ROLE Type Definition.........................................16
3.5.3 LOGO Type Definition.........................................17 3.5.3 LOGO Type Definition.........................................17
3.5.4 AGENT Type Definition........................................18 3.5.4 AGENT Type Definition ........................................17
3.5.5 ORG Type Definition..........................................18 3.5.5 ORG Type Definition..........................................18
3.6 EXPLANATORY TYPES...............................................19 3.6 EXPLANATORY TYPES ...............................................18
3.6.1 CATEGORIES Type Definition...................................19 3.6.1 CATEGORIES Type Definition...................................19
3.6.2 NOTE Type Definition.........................................19 3.6.2 NOTE Type Definition.........................................19
3.6.3 PRODID Type Definition.......................................20 3.6.3 PRODID Type Definition .......................................19
3.6.4 REV Type Definition..........................................20 3.6.4 REV Type Definition..........................................20
3.6.5 SORT-STRING Type Definition..................................21
3.6.6 SOUND Type Definition........................................21 Dawson & Howes [Page 2] October 1998
3.6.7 UID Type Definition..........................................22
vCard MIME Directory Profile vCard MIME Directory Profile
3.6.5 SORT-STRING Type Definition ..................................20
3.6.6 SOUND Type Definition ........................................21
3.6.7 UID Type Definition ..........................................21
3.6.8 URL Type Definition..........................................22 3.6.8 URL Type Definition..........................................22
3.6.9 VERSION Type Definition......................................23 3.6.9 VERSION Type Definition ......................................22
3.7 SECURITY TYPES..................................................23 3.7 SECURITY TYPES..................................................23
3.7.1 CLASS Type Definition........................................23 3.7.1 CLASS Type Definition........................................23
3.7.2 KEY Type Definition..........................................24 3.7.2 KEY Type Definition ..........................................23
3.8 EXTENDED TYPES..................................................25 3.8 EXTENDED TYPES ..................................................24
4. FORMAL GRAMMAR.....................................................25 4. FORMAL GRAMMAR.....................................................24
5. DIFFERENCES WITH VCARD V2.1........................................34 5. DIFFERENCES FROM VCARD V2.1........................................33
6. ACKNOWLEDGEMENTS...................................................35 6. ACKNOWLEDGEMENTS...................................................34
7. AUTHORS?S ADDRESSES................................................35 7. AUTHORS' ADDRESSES.................................................35
8. REFERENCES.........................................................35 8. REFERENCES.........................................................35
9. FULL COPYRIGHT STATEMENT...........................................37 9. FULL COPYRIGHT STATEMENT...........................................36
Dawson & Howes [Page 3] October 1998
vCard MIME Directory Profile vCard MIME Directory Profile
Overview Overview
The [MIME-DIR] document defines a MIME Content-Type for holding The [MIME-DIR] document defines a MIME Content-Type for holding
different kinds of directory information. The directory information different kinds of directory information. The directory information
may be based on any of a number of directory schemas. This document may be based on any of a number of directory schemas. This document
defines a [MIME-DIR] usage profile for conveying directory defines a [MIME-DIR] usage profile for conveying directory
information based on one such schema; that of the white-pages type of information based on one such schema; that of the white-pages type of
person object. person object.
skipping to change at page 5, line 4 skipping to change at line 185
1. The vCard Mime Directory Profile Registration 1. The vCard Mime Directory Profile Registration
This profile is identified by the following [MIME-DIR] registration This profile is identified by the following [MIME-DIR] registration
template information. Subsequent sections define the profile template information. Subsequent sections define the profile
definition. definition.
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME profile VCARD Subject: Registration of text/directory MIME profile VCARD
vCard MIME Directory Profile
Profile name: VCARD Profile name: VCARD
Dawson & Howes [Page 4] October 1998
vCard MIME Directory Profile
Profile purpose: To hold person object or white-pages type of Profile purpose: To hold person object or white-pages type of
directory information. The person schema captured in the directory directory information. The person schema captured in the directory
entries is that commonly found in an electronic business card. entries is that commonly found in an electronic business card.
Predefined MIME Directory value specifications used: uri, date, date-
time, float
New value specifications: This profile places further constraints on
the [MIME-DIR] text value specification. In addition, it adds a
binary, phone-number, utc-offset and vcard value specifications.
Predefined MIME Directory types used: SOURCE, NAME, PROFILE, BEGIN, Predefined MIME Directory types used: SOURCE, NAME, PROFILE, BEGIN,
END. END.
Predefined MIME Directory parameters used: ENCODING, VALUE, CHARSET, Predefined MIME Directory parameters used: ENCODING, VALUE, CHARSET,
LANGUAGE, CONTEXT. LANGUAGE, CONTEXT.
New types: FN, N, NICKNAME, PHOTO, BDAY, ADR, LABEL, TEL, EMAIL, New types: FN, N, NICKNAME, PHOTO, BDAY, ADR, LABEL, TEL, EMAIL,
MAILER, TZ, GEO, TITLE, ROLE, LOGO, AGENT, ORG, CATEGORIES, NOTE, MAILER, TZ, GEO, TITLE, ROLE, LOGO, AGENT, ORG, CATEGORIES, NOTE,
PRODID, REV, SORT-STRING, SOUND, URL, UID, VERSION, CLASS, KEY PRODID, REV, SORT-STRING, SOUND, URL, UID, VERSION, CLASS, KEY
skipping to change at page 5, line 52 skipping to change at line 242
The vCard MIME Directory Profile uses the following predefined types The vCard MIME Directory Profile uses the following predefined types
from [MIME-DIR]. from [MIME-DIR].
2.1.1 BEGIN and END Type 2.1.1 BEGIN and END Type
The content entity MUST begin with the BEGIN type with a value of The content entity MUST begin with the BEGIN type with a value of
"VCARD". The content entity MUST end with the END type with a value "VCARD". The content entity MUST end with the END type with a value
of "VCARD". of "VCARD".
Dawson & Howes [Page 5] October 1998
vCard MIME Directory Profile
2.1.2 NAME Type 2.1.2 NAME Type
If the NAME type appears within a MIME entity conforming to this If the NAME type appears within a MIME entity conforming to this
profile, it's value is the displayable, presentation text associated profile, its value is the displayable, presentation text associated
with the source for the vCard, as specified in the SOURCE type. with the source for the vCard, as specified in the SOURCE type.
vCard MIME Directory Profile
2.1.3 PROFILE Type 2.1.3 PROFILE Type
If the PROFILE type appears within a MIME entity conforming to this If the PROFILE type appears within a MIME entity conforming to this
profile, it?s value MUST be "VCARD". profile, its value MUST be "VCARD".
2.1.4 SOURCE Type 2.1.4 SOURCE Type
If the SOURCE type appears within a MIME entity conforming to this If the SOURCE type appears within a MIME entity conforming to this
profile, it's value provides information how to find the source for profile, its value provides information how to find the source for
the vCard. the vCard.
2.2 Predefined Type Parameter Usage 2.2 Predefined Type Parameter Usage
The vCard MIME Directory Profile uses the following predefined types The vCard MIME Directory Profile uses the following predefined type
parameters as defined by [MIME-DIR]. parameters as defined by [MIME-DIR].
LANGUAGE - LANGUAGE
ENCODING - ENCODING
VALUE - VALUE
2.3 Predefined VALUE Type Usage 2.3 Predefined VALUE Type Usage
The predefined data type values specified in [MIME-DIR] MAY NOT be The predefined data type values specified in [MIME-DIR] MUST NOT be
repeated in COMMA separated value lists, unless specified by this repeated in COMMA separated value lists, unless specified by this
specification. specification.
The text value type defined in [MIME-DIR] is further restricted such
that any SEMI-COLON character (ASCII decimal 59) in the value MUST be
escaped with the BACKSLASH character (ASCII decimal 92).
2.4 Extensions To The Predefined VALUE Types 2.4 Extensions To The Predefined VALUE Types
The predefined data type values specified in [MIME-DIR] have been The predefined data type values specified in [MIME-DIR] have been
extended by the vCard profile to include a number of value types that extended by the vCard profile to include a number of value types that
are specific to this profile. are specific to this profile.
2.4.1 BINARY 2.4.1 BINARY
The "binary" value type specifies that the type value is inline, The "binary" value type specifies that the type value is inline,
encoded binary data. This value type may be specified in the PHOTO, encoded binary data. This value type may be specified in the PHOTO,
LOGO, SOUND, and KEY types. LOGO, SOUND, and KEY types.
If inline encoded binary data is specified, the ENCODING type If inline encoded binary data is specified, the ENCODING type
parameter MUST be used to specify the encoding format. The binary parameter MUST be used to specify the encoding format. The binary
data MUST be encoded using the "B" encoding format. Long lines of data MUST be encoded using the "B" encoding format. Long lines of
Dawson & Howes [Page 6] October 1998
vCard MIME Directory Profile
encoded binary data may be folded using the folding method defined in encoded binary data may be folded using the folding method defined in
[MIME-DIR]. [MIME-DIR].
The value type is defined by the following notation: The value type is defined by the following notation:
binary = <A "B" binary encoded string as defined by [RFC 2047].> binary = <A "B" binary encoded string as defined by [RFC 2047].>
vCard MIME Directory Profile
2.4.2 VCARD 2.4.2 VCARD
The "vcard" value type specifies that the type value is another The "vcard" value type specifies that the type value is another
vCard. This value type may be specified in the AGENT type. The value vCard. This value type can be specified in the AGENT type. The value
type is defined by this specification. Since each of the type type is defined by this specification. Since each of the type
declarations with in the vcard value type are being specified within declarations with in the vcard value type are being specified within
a type value themselves, they MUST be terminated with the backslash a text value themselves, they MUST be terminated with the backslash
escapement sequence "\n" or "\N", instead of the character sequence escape sequence "\n" or "\N", instead of the normal newline character
CRLF. For example, with the AGENT type a value would be specified as sequence CRLF. In addition, any COMMA character (ASCII decimal 44),
: SEMI-COLON character (ASCII decimal 59) and COLON character (ASCII
decimal 58) MUST be escaped with the BACKSLASH character (ASCII
decimal 92). For example, with the AGENT type a value would be
specified as :
AGENT:BEGIN:VCARD\nFN:Joe Friday\nTEL:+1-919-555-7878\n AGENT:BEGIN:VCARD\nFN:Joe Friday\nTEL:+1-919-555-7878\n
TITLE:Area Administrator\, Assistant\n TITLE:Area Administrator\, Assistant\n EMAIL\;TYPE=INTERN\n
EMAIL;INTERNET:jfriday@host.com\n ET:jfriday@host.com\nEND:VCARD\n
END:VCARD
2.4.3 PHONE-NUMBER 2.4.3 PHONE-NUMBER
The "phone-number" value type specifies that the type value is a The "phone-number" value type specifies that the type value is a
telephone number. This value type may be specified in the TEL type. telephone number. This value type can be specified in the TEL type.
The value type is a text value that has the special semantics of a The value type is a text value that has the special semantics of a
telephone number as defined in [CCITT E.163] and [CCITT X.121]. telephone number as defined in [CCITT E.163] and [CCITT X.121].
2.4.4 UTC-OFFSET 2.4.4 UTC-OFFSET
The "utc-offset" value type specifies that the type value is a signed The "utc-offset" value type specifies that the type value is a signed
offset from UTC. This value type may be specified in the TZ type. offset from UTC. This value type can be specified in the TZ type.
The value type is an offset from Coordinated Universal Time (UTC). It The value type is an offset from Coordinated Universal Time (UTC). It
is specified as a positive or negative difference in units of hours is specified as a positive or negative difference in units of hours
and minutes (e.g., +hh:mm). The time is specified as a 24-hour clock. and minutes (e.g., +hh:mm). The time is specified as a 24-hour clock.
Hour values are from 00 to 23, and minute values are from 00 to 59. Hour values are from 00 to 23, and minute values are from 00 to 59.
Hour and minutes are 2-digits with high order zeroes required to Hour and minutes are 2-digits with high order zeroes required to
maintain digit count. The extended format for ISO 8601 UTC offsets maintain digit count. The extended format for ISO 8601 UTC offsets
MUST be used. The extended format makes use of a colon character as a MUST be used. The extended format makes use of a colon character as a
separator of the hour and minute text fields. separator of the hour and minute text fields.
The value is defined by the following notation: The value is defined by the following notation:
time-hour = 2DIGIT ;00-23 time-hour = 2DIGIT ;00-23
time-minute = 2DIGIT ;00-59 time-minute = 2DIGIT ;00-59
utc-offset = ("+" / "-") time-hour ":" time-minute utc-offset = ("+" / "-") time-hour ":" time-minute
Dawson & Howes [Page 7] October 1998
vCard MIME Directory Profile
2.5 Structured Type Values 2.5 Structured Type Values
Compound type values are delimited by a field delimiter, specified by Compound type values are delimited by a field delimiter, specified by
the SEMI-COLON character (ASCII decimal 59). A SEMI-COLON in a the SEMI-COLON character (ASCII decimal 59). A SEMI-COLON in a
component of a compound property value MUST be escaped with a component of a compound property value MUST be escaped with a
BACKSLASH character (ASCII decimal 92). BACKSLASH character (ASCII decimal 92).
Lists of values are delimited by a list delimiter, specified by the Lists of values are delimited by a list delimiter, specified by the
COMMA character (ASCII decimal 44). A COMMA character in a value MUST COMMA character (ASCII decimal 44). A COMMA character in a value MUST
be escaped with a BACKSLASH character (ASCII decimal 92). be escaped with a BACKSLASH character (ASCII decimal 92).
vCard MIME Directory Profile
This profile supports the type grouping mechanism defined in [MIME- This profile supports the type grouping mechanism defined in [MIME-
DIR]. Grouping of related types is a useful technique to communicate DIR]. Grouping of related types is a useful technique to communicate
common semantics concerning the properties of a vCard. common semantics concerning the properties of a vCard.
2.6 Line Delimiting and Folding 2.6 Line Delimiting and Folding
This profile supports the same line delimiting and folding methods This profile supports the same line delimiting and folding methods
defined in [MIME-DIR]. defined in [MIME-DIR].
3. vCard Profile Features 3. vCard Profile Features
skipping to change at page 8, line 48 skipping to change at line 409
Type name:FN Type name:FN
Type purpose: To specify the formatted text corresponding to the name Type purpose: To specify the formatted text corresponding to the name
of the object the vCard represents. of the object the vCard represents.
Type encoding: 8bit Type encoding: 8bit
Type value: A single text value. Type value: A single text value.
Dawson & Howes [Page 8] October 1998
vCard MIME Directory Profile
Type special notes: This type is based on the semantics of the X.520 Type special notes: This type is based on the semantics of the X.520
Common Name attribute. The property MUST be present if the vCard Common Name attribute. The property MUST be present if the vCard
conforms to this specification. conforms to this specification.
Type example: Type example:
FN:Mr. John Q. Public, Esq. FN:Mr. John Q. Public\, Esq.
3.1.2 N Type Definition 3.1.2 N Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
vCard MIME Directory Profile
Subject: Registration of text/directory MIME type N Subject: Registration of text/directory MIME type N
Type name: N Type name: N
Type purpose: To specify the structured components of the name of the Type purpose: To specify the components of the name of the object the
object the vCard represents. vCard represents.
Type encoding: 8bit Type encoding: 8bit
Type value: A single structured text value. Each component may have Type value: A single structured text value. Each component may have
multiple values. multiple values.
Type special note: The structured text value corresponds, in Type special note: The structured type value corresponds, in
sequence, to the Family Name, Given Name, Additional Names, Honorific sequence, to the Family Name, Given Name, Additional Names, Honorific
Prefixes, and Honorific Suffixes. The text components are separated Prefixes, and Honorific Suffixes. The text components are separated
by the SEMI-COLON character (ASCII decimal 59) and possibly one or by the SEMI-COLON character (ASCII decimal 59). Individual text
more LWSP. Individual text components MAY include multiple text components MAY include multiple text values (e.g., multiple
values (e.g., multiple Additional Names), separated by the COMMA Additional Names), separated by the COMMA character (ASCII decimal
character (ASCII decimal 44). This type is based on the semantics of 44). This type is based on the semantics of the X.520 individual name
the X.520 individual name attributes. The property MUST be present in attributes. The property MUST be present in the vCard object.
the vCard object.
Type example: Type example:
N:Public;John;Quinlan;Mr.;Esq. N:Public;John;Quinlan;Mr.;Esq.
N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P. N:Stevenson;John;Philip,Paul;Dr.;Jr.,M.D.,A.C.P.
3.1.3 NICKNAME Type Definition 3.1.3 NICKNAME Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
skipping to change at page 9, line 50 skipping to change at line 467
Type name: NICKNAME Type name: NICKNAME
Type purpose: To specify the text corresponding to the nickname of Type purpose: To specify the text corresponding to the nickname of
the object the vCard represents. the object the vCard represents.
Type encoding: 8bit Type encoding: 8bit
Type value: One or more text values separated by a COMMA character Type value: One or more text values separated by a COMMA character
(ASCII decimal 44). (ASCII decimal 44).
Dawson & Howes [Page 9] October 1998
vCard MIME Directory Profile
Type special note: The nickname is the descriptive name given instead Type special note: The nickname is the descriptive name given instead
of or in addition to the one belonging to a person, place, or thing. of or in addition to the one belonging to a person, place, or thing.
It may also be used to specify a familiar form of a proper name It may also be used to specify a familiar form of a proper name
specified by the FN or N types. specified by the FN or N types.
Type example: Type example:
NICKNAME:Robbie NICKNAME:Robbie
vCard MIME Directory Profile
NICKNAME:Jim,Jimmie NICKNAME:Jim,Jimmie
3.1.4 PHOTO Type Definition 3.1.4 PHOTO Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type PHOTO Subject: Registration of text/directory MIME type PHOTO
Type name: PHOTO Type name: PHOTO
Type purpose: To specify an image or photograph information that Type purpose: To specify an image or photograph information that
annotates some aspect of the object the vCard represents. annotates some aspect of the object the vCard represents.
Type encoding: The encoding MUST be reset to "b" using the ENCODING Type encoding: The encoding MUST be reset to "b" using the ENCODING
parameter in order to specify inline, encoded binary data. If the parameter in order to specify inline, encoded binary data. If the
value is referenced by a URI value, then the default encoding of 8bit value is referenced by a URI value, then the default encoding of 8bit
is used and no explicit ENCODING parameter is needed. is used and no explicit ENCODING parameter is needed.
Type value: A single value. The default is binary. It may also be Type value: A single value. The default is binary value. It may also
reset to uri. The uri value may be used to specify a value outside of be reset to uri value. The uri value may be used to specify a value
this MIME entity. outside of this MIME entity.
Type special notes: The type MAY include the type parameter "TYPE" to Type special notes: The type MAY include the type parameter "TYPE" to
specify the graphic image format type. The TYPE parameter values MUST specify the graphic image format type. The TYPE parameter values MUST
be one of the IANA registered image formats or a non-standard image be one of the IANA registered image formats or a non-standard image
format. format.
Type example: Type example:
PHOTO;VALUE=uri:=http://www.abc.com/pub/photos PHOTO;VALUE=uri:http://www.abc.com/pub/photos
/jqpublic.gif /jqpublic.gif
PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
<...remainder of "B" encoded binary data...> <...remainder of "B" encoded binary data...>
3.1.5 BDAY Type Definition 3.1.5 BDAY Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type BDAY Subject: Registration of text/directory MIME type BDAY
Type name: BDAY Type name: BDAY
Dawson & Howes [Page 10] October 1998
vCard MIME Directory Profile
Type purpose: To specify the birth date of the object the vCard Type purpose: To specify the birth date of the object the vCard
represents. represents.
Type encoding: 8bit Type encoding: 8bit
Type value: The default is a single date value. It may also be reset Type value: The default is a single date value. It may also be reset
to a single date-time value. to a single date-time value.
vCard MIME Directory Profile
Type examples: Type examples:
BDAY:1996-04-15 BDAY:1996-04-15
BDAY:1953-10-15T23:10:00Z BDAY:1953-10-15T23:10:00Z
BDAY:1987-09-27T08:30:00-06:00 BDAY:1987-09-27T08:30:00-06:00
3.2 Delivery Addressing Types 3.2 Delivery Addressing Types
skipping to change at page 11, line 28 skipping to change at line 556
addressing or label for the vCard object. addressing or label for the vCard object.
3.2.1 ADR Type Definition 3.2.1 ADR Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type ADR Subject: Registration of text/directory MIME type ADR
Type name: ADR Type name: ADR
Type purpose: To specify the structured components of the delivery Type purpose: To specify the components of the delivery address for
address for the vCard object. the vCard object.
Type encoding: 8bit Type encoding: 8bit
Type value: A single structured text value, separated by the SEMI- Type value: A single structured text value, separated by the SEMI-
COLON character (ASCII decimal 59) and optionally one or more LWSP. COLON character (ASCII decimal 59).
Type special notes: The structured text value consists of a sequence Type special notes: The structured type value consists of a sequence
of address components. The component values MUST be specified in of address components. The component values MUST be specified in
their corresponding position. The structured text value corresponds, their corresponding position. The structured type value corresponds,
in sequence, to the post office box; the extended address; the street in sequence, to the post office box; the extended address; the street
address; the locality (e.g., city); the region (e.g., state or address; the locality (e.g., city); the region (e.g., state or
province); the postal code; the country name. When a component value province); the postal code; the country name. When a component value
is missing, the associated component separator MUST still be is missing, the associated component separator MUST still be
specified. specified.
The type may include the type parameter "TYPE" to specify the The type may include the type parameter "TYPE" to specify the
delivery address type. The TYPE parameter values may include "dom" to delivery address type. The TYPE parameter values may include "dom" to
indicate a domestic delivery address; "intl" to indicate an indicate a domestic delivery address; "intl" to indicate an
international delivery address; "postal" to indicate a postal international delivery address; "postal" to indicate a postal
delivery address; "parcel" to indicate a parcel delivery address; delivery address; "parcel" to indicate a parcel delivery address;
"home" to indicate a delivery address for a residence; "work" to "home" to indicate a delivery address for a residence; "work" to
indicate delivery address for a place of work; and "pref" to indicate indicate delivery address for a place of work; and "pref" to indicate
the preferred delivery address when more than one address is the preferred delivery address when more than one address is
Dawson & Howes [Page 11] October 1998
vCard MIME Directory Profile
specified. These type parameter values may be specified as a specified. These type parameter values may be specified as a
parameter list (i.e., "TYPE=dom;TYPE=postal") or as a value list parameter list (i.e., "TYPE=dom;TYPE=postal") or as a value list
(i.e., "TYPE=dom,postal"). This type is based on semantics of the (i.e., "TYPE=dom,postal"). This type is based on semantics of the
X.520 geographical and postal addressing attributes. The default is X.520 geographical and postal addressing attributes. The default is
"TYPE=intl,postal,parcel,work". The default can be overridden to some "TYPE=intl,postal,parcel,work". The default can be overridden to some
other set of values by specifying one or more alternate values. For other set of values by specifying one or more alternate values. For
example, the default can be reset to "TYPE=dom,postal,work,home" to example, the default can be reset to "TYPE=dom,postal,work,home" to
vCard MIME Directory Profile
specify a domestic delivery address for postal delivery to a specify a domestic delivery address for postal delivery to a
residence that is also used for work. residence that is also used for work.
Type example: In this example the post office box and the extended Type example: In this example the post office box and the extended
address are absent. address are absent.
ADR;TYPE=dom,home,postal,parcel:;;123 Main ADR;TYPE=dom,home,postal,parcel:;;123 Main
Street;Any Town;CA;91921-1234 Street;Any Town;CA;91921-1234
3.2.2 LABEL Type Definition 3.2.2 LABEL Type Definition
skipping to change at page 12, line 51 skipping to change at line 637
(i.e., "TYPE=dom,postal"). This type is based on semantics of the (i.e., "TYPE=dom,postal"). This type is based on semantics of the
X.520 geographical and postal addressing attributes. The default is X.520 geographical and postal addressing attributes. The default is
"TYPE=intl,postal,parcel,work". The default can be overridden to some "TYPE=intl,postal,parcel,work". The default can be overridden to some
other set of values by specifying one or more alternate values. For other set of values by specifying one or more alternate values. For
example, the default can be reset to "TYPE=intl,post,parcel,home" to example, the default can be reset to "TYPE=intl,post,parcel,home" to
specify an international delivery label for both postal and parcel specify an international delivery label for both postal and parcel
delivery to a residential location. delivery to a residential location.
Type example: A multi-line address label. Type example: A multi-line address label.
LABEL;TYPE=dom,home,postal,parcel:Mr.John Q. Public, Esq.\n LABEL;TYPE=dom,home,postal,parcel:Mr.John Q. Public\, Esq.\n
Mail Drop: TNE QB\n Mail Drop: TNE QB\n
123 Main Street\n
Any Town, CA 91921-1234\n
U.S.A.
Dawson & Howes [Page 12] October 1998
vCard MIME Directory Profile vCard MIME Directory Profile
123 Main Street\n
Any Town\, CA 91921-1234\n
U.S.A.
3.3 Telecommunications Addressing Types 3.3 Telecommunications Addressing Types
These types are concerned with information associated with the These types are concerned with information associated with the
telecommunications addressing of the object the vCard represents. telecommunications addressing of the object the vCard represents.
3.3.1 TEL Type Definition 3.3.1 TEL Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type TEL Subject: Registration of text/directory MIME type TEL
Type name: TEL Type name: TEL
Type purpose: To specify the telephone number for telephony Type purpose: To specify the telephone number for telephony
communication with the object the vCard represents. communication with the object the vCard represents.
Type encoding: 8bit Type encoding: 8bit
Type value: A single phone-number. Type value: A single phone-number value.
Type special notes: The value of this type is specified in a Type special notes: The value of this type is specified in a
canonical form in order to specify an unambiguous representation of canonical form in order to specify an unambiguous representation of
the globally unique telephone endpoint. This type is based on the the globally unique telephone endpoint. This type is based on the
X.500 Telephone Number attribute. X.500 Telephone Number attribute.
The type may include the type parameter "TYPE" to specify intended The type may include the type parameter "TYPE" to specify intended
use for the telephone number. The TYPE parameter values may include: use for the telephone number. The TYPE parameter values may include:
"home" to indicate a telephone number associated with a residence, "home" to indicate a telephone number associated with a residence,
"msg" to indicate the telephone number has voice messaging support, "msg" to indicate the telephone number has voice messaging support,
skipping to change at page 14, line 4 skipping to change at line 697
a parameter list (i.e., "TYPE=work;TYPE=voice") or as a value list a parameter list (i.e., "TYPE=work;TYPE=voice") or as a value list
(i.e., "TYPE=work,voice"). The default may be overridden to another (i.e., "TYPE=work,voice"). The default may be overridden to another
set of values by specifying one or more alternate values. For set of values by specifying one or more alternate values. For
example, the default TYPE of "voice" can be reset to a WORK and HOME, example, the default TYPE of "voice" can be reset to a WORK and HOME,
VOICE and FAX telephone number by the value list VOICE and FAX telephone number by the value list
"TYPE=work,home,voice,fax". "TYPE=work,home,voice,fax".
Type example: Type example:
TEL;TYPE=work,voice,pref,msg:+1-213-555-1234 TEL;TYPE=work,voice,pref,msg:+1-213-555-1234
Dawson & Howes [Page 13] October 1998
vCard MIME Directory Profile vCard MIME Directory Profile
3.3.2 EMAIL Type Definition 3.3.2 EMAIL Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type EMAIL Subject: Registration of text/directory MIME type EMAIL
Type name: EMAIL Type name: EMAIL
skipping to change at page 15, line 5 skipping to change at line 754
Type encoding: 8bit Type encoding: 8bit
Type value: A single text value. Type value: A single text value.
Type special notes: This information may provide assistance to a Type special notes: This information may provide assistance to a
correspondent regarding the type of data representation which can be correspondent regarding the type of data representation which can be
used, and how they may be packaged. This property is based on the used, and how they may be packaged. This property is based on the
private MIME type X-Mailer that is generally implemented by MIME user private MIME type X-Mailer that is generally implemented by MIME user
agent products. agent products.
vCard MIME Directory Profile
Type example: Type example:
Dawson & Howes [Page 14] October 1998
vCard MIME Directory Profile
MAILER:PigeonMail 2.1 MAILER:PigeonMail 2.1
3.4 Geographical Types 3.4 Geographical Types
These types are concerned with information associated with These types are concerned with information associated with
geographical positions or regions associated with the object the geographical positions or regions associated with the object the
vCard represents. vCard represents.
3.4.1 TZ Type Definition 3.4.1 TZ Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type TZ Subject: Registration of text/directory MIME type TZ
Type name: TZ Type name: TZ
Type purpose: To specify information related to the time zone of the Type purpose: To specify information related to the time zone of the
object the vCard represents. object the vCard represents.
Type encoding: 8bit. Type encoding: 8bit
Type value: The default is a single utc-offset value. It may also be Type value: The default is a single utc-offset value. It may also be
reset to a single text value. reset to a single text value.
Type special notes: The type value consists of a single value. Type special notes: The type value consists of a single value.
Type examples: Type examples:
TZ:-05:00 TZ:-05:00
skipping to change at page 15, line 53 skipping to change at line 803
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type GEO Subject: Registration of text/directory MIME type GEO
Type name: GEO Type name: GEO
Type purpose: To specify information related to the global Type purpose: To specify information related to the global
positioning of the object the vCard represents. positioning of the object the vCard represents.
Type encoding: 8bit. Type encoding: 8bit
Type value: Two float values separated by the SEMI-COLON character Type value: A single structured value consisting of two float values
(ASCII decimal 59). separated by the SEMI-COLON character (ASCII decimal 59).
Type special notes: This type specifies information related to the Type special notes: This type specifies information related to the
global position of the object associated with the vCard. The value global position of the object associated with the vCard. The value
vCard MIME Directory Profile
specifies latitude and longitude, in that order (i.e., "LAT LON" specifies latitude and longitude, in that order (i.e., "LAT LON"
ordering). The longitude represents the location east and west of the ordering). The longitude represents the location east and west of the
prime meridian as a positive or negative real number, respectively. prime meridian as a positive or negative real number, respectively.
Dawson & Howes [Page 15] October 1998
vCard MIME Directory Profile
The latitude represents the location north and south of the equator The latitude represents the location north and south of the equator
as a positive or negative real number, respectively. The longitude as a positive or negative real number, respectively. The longitude
and latitude values MUST be specified as decimal degrees and should and latitude values MUST be specified as decimal degrees and should
be specified to six decimal places. This will allow for granularity be specified to six decimal places. This will allow for granularity
within a meter of the geographical position. The text components are within a meter of the geographical position. The text components are
separated by the SEMI-COLON character (ASCII decimal 59). The simple separated by the SEMI-COLON character (ASCII decimal 59). The simple
formula for converting degrees-minutes-seconds into decimal degrees formula for converting degrees-minutes-seconds into decimal degrees
is: is:
decimal = degrees + minutes/60 + seconds/3600. decimal = degrees + minutes/60 + seconds/3600.
skipping to change at page 16, line 49 skipping to change at line 857
function of the object the vCard represents. function of the object the vCard represents.
Type encoding: 8bit Type encoding: 8bit
Type value: A single text value. Type value: A single text value.
Type special notes: This type is based on the X.520 Title attribute. Type special notes: This type is based on the X.520 Title attribute.
Type example: Type example:
TITLE:Director, Research and Development TITLE:Director\, Research and Development
3.5.2 ROLE Type Definition 3.5.2 ROLE Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type ROLE Subject: Registration of text/directory MIME type ROLE
Type name: ROLE Type name: ROLE
vCard MIME Directory Profile
Type purpose: To specify information concerning the role, occupation, Type purpose: To specify information concerning the role, occupation,
or business category of the object the vCard represents. or business category of the object the vCard represents.
Type encoding: 8bit Type encoding: 8bit
Dawson & Howes [Page 16] October 1998
vCard MIME Directory Profile
Type value: A single text value. Type value: A single text value.
Type special notes: This type is based on the X.520 Business Category Type special notes: This type is based on the X.520 Business Category
explanatory attribute. This property is included as an organizational explanatory attribute. This property is included as an organizational
type to avoid confusion with the semantics of the TITLE type and type to avoid confusion with the semantics of the TITLE type and
incorrect usage of that type when the semantics of this type is incorrect usage of that type when the semantics of this type is
intended. intended.
Type example: Type example:
skipping to change at page 17, line 39 skipping to change at line 903
Type name: LOGO Type name: LOGO
Type purpose: To specify a graphic image of a logo associated with Type purpose: To specify a graphic image of a logo associated with
the object the vCard represents. the object the vCard represents.
Type encoding: The encoding MUST be reset to "b" using the ENCODING Type encoding: The encoding MUST be reset to "b" using the ENCODING
parameter in order to specify inline, encoded binary data. If the parameter in order to specify inline, encoded binary data. If the
value is referenced by a URI value, then the default encoding of 8bit value is referenced by a URI value, then the default encoding of 8bit
is used and no explicit ENCODING parameter is needed. is used and no explicit ENCODING parameter is needed.
Type value: A single value. The default is binary. It may also be Type value: A single value. The default is binary value. It may also
reset to uri. The uri value may be used to specify a value outside of be reset to uri value. The uri value may be used to specify a value
this MIME entity. outside of this MIME entity.
Type special notes: The type MAY include the type parameter "TYPE" to Type special notes: The type MAY include the type parameter "TYPE" to
specify the graphic image format type. The TYPE parameter values MUST specify the graphic image format type. The TYPE parameter values MUST
be one of the IANA registered image formats or a non-standard image be one of the IANA registered image formats or a non-standard image
format. format.
Type example: Type example:
LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg
LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
<...the remainder of "B" encoded binary data...> <...the remainder of "B" encoded binary data...>
vCard MIME Directory Profile
3.5.4 AGENT Type Definition 3.5.4 AGENT Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type AGENT Subject: Registration of text/directory MIME type AGENT
Type name: AGENT Type name: AGENT
Dawson & Howes [Page 17] October 1998
vCard MIME Directory Profile
Type purpose: To specify information about another person who will Type purpose: To specify information about another person who will
act on behalf of the individual or resource associated with the act on behalf of the individual or resource associated with the
vCard. vCard.
Type encoding: 8-bit. Type encoding: 8-bit
Type value: The default is a single vcard value. It may also be reset Type value: The default is a single vcard value. It may also be reset
to either a single text or uri value. The text value may be used to to either a single text or uri value. The text value may be used to
specify textual information. The uri value may be used to specify specify textual information. The uri value may be used to specify
information outside of this MIME entity. information outside of this MIME entity.
Type special notes: This type typically is used to specify an area Type special notes: This type typically is used to specify an area
administrator, assistant, or secretary for the individual associated administrator, assistant, or secretary for the individual associated
with the vCard. A key characteristic of the Agent type is that it with the vCard. A key characteristic of the Agent type is that it
represents somebody or something that is separately addressable. represents somebody or something that is separately addressable.
Type example: Type example:
AGENT;VALUE=uri: AGENT;VALUE=uri:
CID:JQPUBLIC.part3.960129T083020.xyzMail@host3.com CID:JQPUBLIC.part3.960129T083020.xyzMail@host3.com
AGENT:BEGIN:VCARD\n AGENT:BEGIN:VCARD\nFN:Susan Thomas\nTEL:+1-919-555-
FN:Susan Thomas\n 1234\nEMAIL\;INTERNET:sthomas@host.com\nEND:VCARD\n
TEL:+1-919-555-1234\n
EMAIL;INTERNET:sthomas@host.com\n
END:VCARD\n
3.5.5 ORG Type Definition 3.5.5 ORG Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type ORG Subject: Registration of text/directory MIME type ORG
Type name: ORG Type name: ORG
Type purpose: To specify the organizational name and units associated Type purpose: To specify the organizational name and units associated
with the vCard. with the vCard.
Type encoding: 8bit Type encoding: 8bit
Type value: A single structured text value consisting of components Type value: A single structured text value consisting of components
separated the SEMI-COLON character (ASCII decimal 59). separated the SEMI-COLON character (ASCII decimal 59).
Type special notes: The type is based on the X.520 Organization Name Type special notes: The type is based on the X.520 Organization Name
and Organization Unit attributes. The type value is a structured text and Organization Unit attributes. The type value is a structured type
vCard MIME Directory Profile
consisting of the organization name, followed by one or more levels consisting of the organization name, followed by one or more levels
of organizational unit names. of organizational unit names.
Type example: A type value consisting of an organizational name, Type example: A type value consisting of an organizational name,
organizational unit #1 name and organizational unit #2 name. organizational unit #1 name and organizational unit #2 name.
ORG:ABC, Inc.;North American Division;Marketing ORG:ABC\, Inc.;North American Division;Marketing
3.6 Explanatory Types 3.6 Explanatory Types
These types are concerned with additional explanations, such as that These types are concerned with additional explanations, such as that
related to informational notes or revisions specific to the vCard. related to informational notes or revisions specific to the vCard.
Dawson & Howes [Page 18] October 1998
vCard MIME Directory Profile
3.6.1 CATEGORIES Type Definition 3.6.1 CATEGORIES Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type CATEGORIES Subject: Registration of text/directory MIME type CATEGORIES
Type name: CATEGORIES Type name: CATEGORIES
Type purpose: To specify application category information about the Type purpose: To specify application category information about the
vCard. vCard.
skipping to change at page 20, line 5 skipping to change at line 1030
Type purpose: To specify supplemental information or a comment that Type purpose: To specify supplemental information or a comment that
is associated with the vCard. is associated with the vCard.
Type encoding: 8bit Type encoding: 8bit
Type value: A single text value. Type value: A single text value.
Type special notes: The type is based on the X.520 Description Type special notes: The type is based on the X.520 Description
attribute. attribute.
vCard MIME Directory Profile
Type example: Type example:
NOTE:This fax number is operational 0800 to 1715 NOTE:This fax number is operational 0800 to 1715
EST, Mon-Fri. EST\, Mon-Fri.
3.6.3 PRODID Type Definition 3.6.3 PRODID Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type PRODID Subject: Registration of text/directory MIME type PRODID
Type name: PRODID Type name: PRODID
Dawson & Howes [Page 19] October 1998
vCard MIME Directory Profile
Type purpose: To specify the identifier for the product that created Type purpose: To specify the identifier for the product that created
the vCard object. the vCard object.
Type encoding: 8-bit. Type encoding: 8-bit
Type value: A single text value. Type value: A single text value.
Type special notes: Implementations SHOULD use a method such as that Type special notes: Implementations SHOULD use a method such as that
specified for Formal Public Identifiers in ISO 9070 to assure that specified for Formal Public Identifiers in ISO 9070 to assure that
the text value is unique. the text value is unique.
Type example: Type example:
PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN
skipping to change at page 20, line 46 skipping to change at line 1072
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type REV Subject: Registration of text/directory MIME type REV
Type name: REV Type name: REV
Type purpose: To specify revision information about the current Type purpose: To specify revision information about the current
vCard. vCard.
Type encoding: 8-bit. Type encoding: 8-bit
Type value: The default is a single date-time value. May also be Type value: The default is a single date-time value. May also be
reset to a single date value. reset to a single date value.
Type special notes: The value distinguishes the current revision of Type special notes: The value distinguishes the current revision of
the information in this vCard for other renditions of the the information in this vCard for other renditions of the
information. information.
Type example: Type example:
REV:1995-10-31T22:27:10Z REV:1995-10-31T22:27:10Z
REV:1997-11-15 REV:1997-11-15
vCard MIME Directory Profile
3.6.5 SORT-STRING Type Definition 3.6.5 SORT-STRING Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type SORT-STRING Subject: Registration of text/directory MIME type SORT-STRING
Type Name: SORT-STRING Type Name: SORT-STRING
Type purpose: To specify the text to be used in national language Type purpose: To specify the text to be used in national language
specific sorting of the values specified by the FN or N types. specific sorting of the values specified by the FN or N types.
Type encoding: The default is 8bit. May also be reset to 7bit or Type encoding: 8bit
quoted-printable.
Type value: text Dawson & Howes [Page 20] October 1998
vCard MIME Directory Profile
Type value: A single text value.
Type special notes: The sort string is used to provide text that is Type special notes: The sort string is used to provide text that is
to be used in locale- or national language-specific sorting of the to be used in locale- or national language-specific sorting of the
values for the formatted name or structured name types. Without this values for the formatted name or structured name types. Without this
information, sorting algorithms may incorrectly sort this vCard information, sorting algorithms may incorrectly sort this vCard
within a sequence of sorted vCards. If this type is present in a within a sequence of sorted vCards. If this type is present in a
vCard, then this value should be used for sorting the vCard, instead vCard, then this value should be used for sorting the vCard, instead
of the values of the FN or N types. of the values of the FN or N types.
Type example: The following would define the sort string "Harten" for Type example: The following would define the sort string "Harten" for
skipping to change at page 21, line 53 skipping to change at line 1136
Type purpose: To specify a digital sound content information that Type purpose: To specify a digital sound content information that
annotates some aspect of the vCard. By default this type is used to annotates some aspect of the vCard. By default this type is used to
specify the proper pronunciation of the name type value of the vCard. specify the proper pronunciation of the name type value of the vCard.
Type encoding: The encoding MUST be reset to "b" using the ENCODING Type encoding: The encoding MUST be reset to "b" using the ENCODING
parameter in order to specify inline, encoded binary data. If the parameter in order to specify inline, encoded binary data. If the
value is referenced by a URI value, then the default encoding of 8bit value is referenced by a URI value, then the default encoding of 8bit
is used and no explicit ENCODING parameter is needed. is used and no explicit ENCODING parameter is needed.
Type value: A single value. The default is binary. It may also be Type value: A single value. The default is binary value. It may also
reset to uri. The uri value may be used to specify a value outside of be reset to uri value. The uri value may be used to specify a value
this MIME entity. outside of this MIME entity.
vCard MIME Directory Profile
Type special notes: The type MAY include the type parameter "TYPE" to Type special notes: The type MAY include the type parameter "TYPE" to
specify the audio format type. The TYPE parameter values MUST be one specify the audio format type. The TYPE parameter values MUST be one
of the IANA registered audio formats or a non-standard audio format. of the IANA registered audio formats or a non-standard audio format.
Type example: Type example:
SOUND;TYPE=BASIC;VALUE=uri:CID:JOHNQPUBLIC.part8. SOUND;TYPE=BASIC;VALUE=uri:CID:JOHNQPUBLIC.part8.
19960229T080000.xyzMail@host1.com 19960229T080000.xyzMail@host1.com
SOUND;TYPE=BASIC;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN SOUND;TYPE=BASIC;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN
AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm
ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0
<...the remainder of "B" encoded binary data...> <...the remainder of "B" encoded binary data...>
3.6.7 UID Type Definition 3.6.7 UID Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Dawson & Howes [Page 21] October 1998
vCard MIME Directory Profile
Subject: Registration of text/directory MIME type UID Subject: Registration of text/directory MIME type UID
Type name: UID Type name: UID
Type purpose: To specify a value that represents a globally unique Type purpose: To specify a value that represents a globally unique
identifier corresponding to the individual or resource associated identifier corresponding to the individual or resource associated
with the vCard. with the vCard.
Type encoding: 8bit. Type encoding: 8bit
Type value: A single text value. Type value: A single text value.
Type special notes: The type is used to uniquely identify the object Type special notes: The type is used to uniquely identify the object
that the vCard represents. that the vCard represents.
The type may include the type parameter "TYPE" to specify the format The type may include the type parameter "TYPE" to specify the format
of the identifier. The TYPE parameter value may be any IANA of the identifier. The TYPE parameter value may be any IANA
registered identifier format. The value may also be a non-standard registered identifier format. The value may also be a non-standard
format. format.
skipping to change at page 23, line 5 skipping to change at line 1196
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type URL Subject: Registration of text/directory MIME type URL
Type name: URL Type name: URL
Type purpose: To specify a uniform resource locator associated with Type purpose: To specify a uniform resource locator associated with
the object that the vCard refers to. the object that the vCard refers to.
vCard MIME Directory Profile
Type encoding: 8bit Type encoding: 8bit
Type value: A single uri value. Type value: A single uri value.
Type example: Type example:
URL:http://www.swbyps.restaurant.french/~chezchic.html URL:http://www.swbyps.restaurant.french/~chezchic.html
3.6.9 VERSION Type Definition 3.6.9 VERSION Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type VERSION Subject: Registration of text/directory MIME type VERSION
Type name: VERSION Type name: VERSION
Type purpose: To specify the version of the vCard specification used Type purpose: To specify the version of the vCard specification used
to format this vCard. to format this vCard.
Dawson & Howes [Page 22] October 1998
vCard MIME Directory Profile
Type encoding: 8bit Type encoding: 8bit
Type value: A single text value. Type value: A single text value.
Type special notes: The property MUST be present in the vCard object. Type special notes: The property MUST be present in the vCard object.
The value MUST be "3.0" if the vCard corresponds to this The value MUST be "3.0" if the vCard corresponds to this
specification. specification.
Type example: Type example:
skipping to change at page 24, line 4 skipping to change at line 1252
Type purpose: To specify the access classification for a vCard Type purpose: To specify the access classification for a vCard
object. object.
Type encoding: 8bit Type encoding: 8bit
Type value: A single text value. Type value: A single text value.
Type special notes: An access classification is only one component of Type special notes: An access classification is only one component of
the general security model for a directory service. The the general security model for a directory service. The
vCard MIME Directory Profile
classification attribute provides a method of capturing the intent of classification attribute provides a method of capturing the intent of
the owner for general access to information described by the vCard the owner for general access to information described by the vCard
object. object.
Type examples: Type examples:
CLASS:PUBLIC CLASS:PUBLIC
CLASS:PRIVATE CLASS:PRIVATE
CLASS:CONFIDENTIAL CLASS:CONFIDENTIAL
3.7.2 KEY Type Definition 3.7.2 KEY Type Definition
To: ietf-mime-directory@imc.org To: ietf-mime-directory@imc.org
Subject: Registration of text/directory MIME type KEY Subject: Registration of text/directory MIME type KEY
Type name: KEY Type name: KEY
Dawson & Howes [Page 23] October 1998
vCard MIME Directory Profile
Type purpose: To specify a public key or authentication certificate Type purpose: To specify a public key or authentication certificate
associated with the object that the vCard represents. associated with the object that the vCard represents.
Type encoding: The encoding MUST be reset to "b" using the ENCODING Type encoding: The encoding MUST be reset to "b" using the ENCODING
parameter in order to specify inline, encoded binary data. If the parameter in order to specify inline, encoded binary data. If the
value is a text value, then the default encoding of 8bit is used and value is a text value, then the default encoding of 8bit is used and
no explicit ENCODING parameter is needed. no explicit ENCODING parameter is needed.
Type value: A single value. The default is binary. It may also be Type value: A single value. The default is binary. It may also be
reset to text. The text value may be used to specify a text key. reset to text value. The text value may be used to specify a text
key.
Type special notes: The type may also include the type parameter TYPE Type special notes: The type may also include the type parameter TYPE
to specify the public key or authentication certificate format. The to specify the public key or authentication certificate format. The
parameter type may specify any IANA registered public key or parameter type may specify any IANA registered public key or
authentication certificate format. The parameter type may also authentication certificate format. The parameter type may also
specify a non-standard format. specify a non-standard format.
Type example: Type example:
KEY;ENCODING=b: MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQA KEY;ENCODING=b: MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcNAQEEBQA
skipping to change at page 25, line 4 skipping to change at line 1308
ZW1zMRwwGgYDVQQDExNyb290Y2EubmV0c2NhcGUuY29tMB4XDTk3MDYwNj ZW1zMRwwGgYDVQQDExNyb290Y2EubmV0c2NhcGUuY29tMB4XDTk3MDYwNj
E5NDc1OVoXDTk3MTIwMzE5NDc1OVowgYkxCzAJBgNVBAYTAlVTMSYwJAYD E5NDc1OVoXDTk3MTIwMzE5NDc1OVowgYkxCzAJBgNVBAYTAlVTMSYwJAYD
VQQKEx1OZXRzY2FwZSBDb21tdW5pY2F0aW9ucyBDb3JwLjEYMBYGA1UEAx VQQKEx1OZXRzY2FwZSBDb21tdW5pY2F0aW9ucyBDb3JwLjEYMBYGA1UEAx
MPVGltb3RoeSBBIEhvd2VzMSEwHwYJKoZIhvcNAQkBFhJob3dlc0BuZXRz MPVGltb3RoeSBBIEhvd2VzMSEwHwYJKoZIhvcNAQkBFhJob3dlc0BuZXRz
Y2FwZS5jb20xFTATBgoJkiaJk/IsZAEBEwVob3dlczBcMA0GCSqGSIb3DQ Y2FwZS5jb20xFTATBgoJkiaJk/IsZAEBEwVob3dlczBcMA0GCSqGSIb3DQ
EBAQUAA0sAMEgCQQC0JZf6wkg8pLMXHHCUvMfL5H6zjSk4vTTXZpYyrdN2 EBAQUAA0sAMEgCQQC0JZf6wkg8pLMXHHCUvMfL5H6zjSk4vTTXZpYyrdN2
dXcoX49LKiOmgeJSzoiFKHtLOIboyludF90CgqcxtwKnAgMBAAGjNjA0MB dXcoX49LKiOmgeJSzoiFKHtLOIboyludF90CgqcxtwKnAgMBAAGjNjA0MB
EGCWCGSAGG+EIBAQQEAwIAoDAfBgNVHSMEGDAWgBT84FToB/GV3jr3mcau EGCWCGSAGG+EIBAQQEAwIAoDAfBgNVHSMEGDAWgBT84FToB/GV3jr3mcau
+hUMbsQukjANBgkqhkiG9w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIP +hUMbsQukjANBgkqhkiG9w0BAQQFAAOBgQBexv7o7mi3PLXadkmNP9LcIP
mx93HGp0Kgyx1jIVMyNgsemeAwBM+MSlhMfcpbTrONwNjZYW8vJDSoi//y mx93HGp0Kgyx1jIVMyNgsemeAwBM+MSlhMfcpbTrONwNjZYW8vJDSoi//y
vCard MIME Directory Profile
rZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8VUMk1U7jt8LYpo4YULU7 rZlVt9bJbs7MNYZVsyF1unsqaln4/vy6Uawfg8VUMk1U7jt8LYpo4YULU7
UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ== UZHPYVUaSgVttImOHZIKi4hlPXBOhcUQ==
3.8 Extended Types 3.8 Extended Types
The types defined by this document can be extended with private types The types defined by this document can be extended with private types
using the non-standard, private values mechanism defined in [RFC using the non-standard, private values mechanism defined in [RFC
2045]. Non-standard, private types with a name starting with "X-" may 2045]. Non-standard, private types with a name starting with "X-" may
be defined bilaterally between two cooperating agents without outside be defined bilaterally between two cooperating agents without outside
registration or standardization. registration or standardization.
4. Formal Grammar 4. Formal Grammar
The following formal grammar is provided to assist developers in The following formal grammar is provided to assist developers in
building parsers for the vCard. building parsers for the vCard.
This syntax is written according to the form described in RFC 2234, This syntax is written according to the form described in RFC 2234,
but it references just this small subset of RFC 2234 literals: but it references just this small subset of RFC 2234 literals:
Dawson & Howes [Page 24] October 1998
vCard MIME Directory Profile
;******************************************* ;*******************************************
; Commonly Used Literal Definition ; Commonly Used Literal Definition
;******************************************* ;*******************************************
ALPHA = %x41-5A / %x61-7A ALPHA = %x41-5A / %x61-7A
; Latin Capital Letter A-Latin Capital Letter Z / ; Latin Capital Letter A-Latin Capital Letter Z /
; Latin Small Letter a-Latin Small Letter z ; Latin Small Letter a-Latin Small Letter z
CHAR = %x01-7F CHAR = %x01-7F
; Any C0 Controls and Basic Latin, excluding NULL from ; Any C0 Controls and Basic Latin, excluding NULL from
skipping to change at page 26, line 4 skipping to change at line 1362
; Controls. Not used, but referenced in comments. ; Controls. Not used, but referenced in comments.
DIGIT = %x30-39 DIGIT = %x30-39
; Digit Zero-Digit Nine ; Digit Zero-Digit Nine
DQUOTE = %x22 DQUOTE = %x22
; Quotation Mark ; Quotation Mark
HTAB = %x09 HTAB = %x09
; Horizontal Tabulation ; Horizontal Tabulation
vCard MIME Directory Profile
SP = %x20 SP = %x20
; space ; space
VCHAR = %x21-7E VCHAR = %x21-7E
; Visible (printing) characters ; Visible (printing) characters
WSP = SP / HTAB WSP = SP / HTAB
; White Space ; White Space
;******************************************* ;*******************************************
; Basic vCard Definition ; Basic vCard Definition
;******************************************* ;*******************************************
vcard_entity = 1*(vcard) vcard_entity = 1*(vcard)
vcard = [group "."] "BEGIN" ":" *WSP "VCARD" 1*CRLF vcard = [group "."] "BEGIN" ":" "VCARD" 1*CRLF
1*(contentline) 1*(contentline)
;A vCard object MUST include the VERSION, FN and N types. ;A vCard object MUST include the VERSION, FN and N types.
[group "."] "END" ":" *WSP "VCARD" 1*CRLF [group "."] "END" ":" "VCARD" 1*CRLF
contentline = [group "."] name *(";" *WSP param ) ":" value CRLF Dawson & Howes [Page 25] October 1998
vCard MIME Directory Profile
contentline = [group "."] name *(";" param ) ":" value CRLF
; When parsing a content line, folded lines must first ; When parsing a content line, folded lines must first
; be unfolded according to the unfolding procedure ; be unfolded according to the unfolding procedure
; described above. When generating a content line, lines ; described above. When generating a content line, lines
; longer than 75 characters SHOULD be folded according to ; longer than 75 characters SHOULD be folded according to
; the folding procedure described above. ; the folding procedure described above.
group = 1*(ALPHA / DIGIT / "-") group = 1*(ALPHA / DIGIT / "-")
name = iana-token / x-name name = iana-token / x-name
; Parsing of the param and value is ; Parsing of the param and value is
; based on the "name" or type identifier ; based on the "name" or type identifier
; as defined in ABNF sections below ; as defined in ABNF sections below
iana-token = 1*(ALPHA / DIGIT / "-") iana-token = 1*(ALPHA / DIGIT / "-")
; vCard type or parameter identifier registered with IANA ; vCard type or parameter identifier registered with IANA
x-name = "X-" 1*(ALPHA / DIGIT / "-") x-name = "X-" 1*(ALPHA / DIGIT / "-")
; Reserved for non-standard use ; Reserved for non-standard use
param = [param-name "="] param-value *("," *WSP param-value) param = param-name "=" param-value *("," param-value)
param-name = iana-token / x-name param-name = iana-token / x-name
param-value = text / quoted-string param-value = ptext / quoted-string
text = *SAFE-CHAR ptext = *SAFE-CHAR
value = *VALUE-CHAR value = *VALUE-CHAR
quoted-string = DQUOTE *qtext DQUOTE quoted-string = DQUOTE QSAFE-CHAR DQUOTE
qtext = QSAFE-CHAR / QUOTED-CHAR
vCard MIME Directory Profile
NON-ASCII = %x80-FF NON-ASCII = %x80-FF
; Use is restricted by CHARSET parameter ; Use is restricted by CHARSET parameter
; on outer MIME object (UTF-8 preferred) ; on outer MIME object (UTF-8 preferred)
QSAFE-CHAR = WSP / %x21 / %x23-5B / %x5D-7E / NON-ASCII QSAFE-CHAR = WSP / %x21 / %x23-7E / NON-ASCII
; Any character except CTLs, DQUOTE, or "\" ; Any character except CTLs, DQUOTE
QUOTED-CHAR = "\" ("\" / DQUOTE)
; \\ encodes \ and \" encodes "
SAFE-CHAR = WSP / %x21 / %x23-2B / %x2D-39 / %x3C-7E / NON-ASCII SAFE-CHAR = WSP / %x21 / %x23-2B / %x2D-39 / %x3C-7E / NON-ASCII
; Any character except CTLs, DQUOTE, ";", ":", "," ; Any character except CTLs, DQUOTE, ";", ":", ","
VALUE-CHAR = WSP / VCHAR / NON-ASCII VALUE-CHAR = WSP / VCHAR / NON-ASCII
; Any textual character ; Any textual character
;******************************************* ;*******************************************
; vCard Type Definition ; vCard Type Definition
; ;
; Provides type-specific definitions for how the ; Provides type-specific definitions for how the
; "value" and "param" are defined. ; "value" and "param" are defined.
;******************************************* ;*******************************************
Dawson & Howes [Page 26] October 1998
vCard MIME Directory Profile
;For name="NAME" ;For name="NAME"
param = "" param = ""
;No parameters allowed ;No parameters allowed
value = text-value value = text-value
;For name="PROFILE" ;For name="PROFILE"
param = "" param = ""
;No parameters allowed ;No parameters allowed
value = "VCARD" value = text-value
; Value MUST be the case insensitive value "VCARD
;For name="SOURCE" ;For name="SOURCE"
param = source-param param = source-param
;No parameters allowed ;No parameters allowed
value = uri value = uri
source-param = ( "VALUE" "=" "uri") source-param = ( "VALUE" "=" "uri")
/ ( "CONTEXT" "=" word) / ("CONTEXT" "=" "word")
;Parameter values specifies the protocol ; Parameter value specifies the protocol context
; context for the URI value. ; for the uri value.
/ (x-name "=" *SAFE-CHAR / (x-name "=" *SAFE-CHAR)
;For name="FN" ;For name="FN"
;This type MUST be included in a vCard object. ;This type MUST be included in a vCard object.
param = text-param param = text-param
;Text parameters allowed ;Text parameters allowed
value = text-value value = text-value
vCard MIME Directory Profile
;For name="N" ;For name="N"
;This type MUST be included in a vCard object. ;This type MUST be included in a vCard object.
param = text-param param = text-param
;Text parameters allowed ;Text parameters allowed
value = n-value value = n-value
n-value = 0*4(text-value *("," text-value) ";") n-value = 0*4(text-value *("," text-value) ";")
text-value *("," text-value) text-value *("," text-value)
; Family, Given, Middle, Prefix, Suffix. ; Family; Given; Middle; Prefix; Suffix.
; Example:Public;John;Quincy,Adams;Reverend Dr.;III, ; Example: Public;John;Quincy,Adams;Reverend Dr. III
; Esq.
;For name="NICKNAME" ;For name="NICKNAME"
param = text-param param = text-param
;Text parameters allowed ;Text parameters allowed
value = text-list value = text-list
;For name="PHOTO" ;For name="PHOTO"
param = img-inline-param param = img-inline-param
;Only image parameters allowed ;Only image parameters allowed
Dawson & Howes [Page 27] October 1998
vCard MIME Directory Profile
param =/ img-refer-param param =/ img-refer-param
;Only image parameters allowed ;Only image parameters allowed
value = img-inline-value value = img-inline-value
;Value and parameter MUST match ;Value and parameter MUST match
value =/ img-refer-value value =/ img-refer-value
;Value and parameter MUST match ;Value and parameter MUST match
;For name="BDAY" ;For name="BDAY"
param = ("VALUE" "=" "DATE") param = ("VALUE" "=" "date")
;Only value parameter allowed ;Only value parameter allowed
param =/ ("VALUE" "=" "DATE-TIME") param =/ ("VALUE" "=" "date-time")
;Only value parameter allowed ;Only value parameter allowed
value = date-value value = date-value
;Value MUST match value type ;Value MUST match value type
value =/ date-time-value value =/ date-time-value
;Value MUST match value type ;Value MUST match value type
;For name="ADR" ;For name="ADR"
param = adr-param / text-param param = adr-param / text-param
;Only adr and text parameters allowed ;Only adr and text parameters allowed
value = adr-value value = adr-value
;For name="LABEL" ;For name="LABEL"
param = adr-param / text-param param = adr-param / text-param
;Only adr and text parameters allowed ;Only adr and text parameters allowed
vCard MIME Directory Profile
value = text-value value = text-value
;For name="TEL" ;For name="TEL"
param = tel-param param = tel-param
;Only tel parameters allowed ;Only tel parameters allowed
value = phone-number-value value = phone-number-value
tel-param = ["TYPE" "="] tel-type *("," *WSP tel-type) tel-param = "TYPE" "=" tel-type *("," tel-type)
tel-type = "HOME" / "WORK" / "PREF" / "VOICE" / "FAX" / "MSG" tel-type = "HOME" / "WORK" / "PREF" / "VOICE" / "FAX" / "MSG"
/ "CELL" / "PAGER" / "BBS" / "MODEM" / "CAR" / "ISDN" / "CELL" / "PAGER" / "BBS" / "MODEM" / "CAR" / "ISDN"
/ "VIDEO" / "PCS" / iana-token / x-name / "VIDEO" / "PCS" / iana-token / x-name
; Values are case insensitive
;For name="EMAIL" ;For name="EMAIL"
param = email-param param = email-param
;Only email parameters allowed ;Only email parameters allowed
value = text-value value = text-value
email-param = ["TYPE" "="] email-type ["," *WSP "PREF"] Dawson & Howes [Page 28] October 1998
vCard MIME Directory Profile
email-param = "TYPE" "=" email-type ["," "PREF"]
; Value is case insensitive
email-type = "INTERNET" / "X400" / iana-token / "X-" word email-type = "INTERNET" / "X400" / iana-token / "X-" word
; Values are case insensitive
;For name="MAILER" ;For name="MAILER"
param = text-param param = text-param
;Only text parameters allowed ;Only text parameters allowed
value = text-value value = text-value
;For name="TZ" ;For name="TZ"
param = "" param = ""
;No parameters allowed ;No parameters allowed
skipping to change at page 30, line 4 skipping to change at line 1589
param = text-param param = text-param
;Only text parameters allowed ;Only text parameters allowed
value = text-value value = text-value
;For name="ROLE" ;For name="ROLE"
param = text-param param = text-param
;Only text parameters allowed ;Only text parameters allowed
value = text-value value = text-value
vCard MIME Directory Profile
;For name="LOGO" ;For name="LOGO"
param = img-inline-param / img-refer-param param = img-inline-param / img-refer-param
;Only image parameters allowed ;Only image parameters allowed
value = img-inline-value / img-refer-value value = img-inline-value / img-refer-value
;Value and parameter MUST match ;Value and parameter MUST match
;For name="AGENT" ;For name="AGENT"
param = agent-inline-param param = agent-inline-param
param =/ agent-refer-param param =/ agent-refer-param
value = agent-inline-value value = agent-inline-value
; Value and parameter MUST match
value =/ agent-refer-value value =/ agent-refer-value
; Value and parameter MUST match
Dawson & Howes [Page 29] October 1998
vCard MIME Directory Profile
agent-inline-param = "" agent-inline-param = ""
;No parameters allowed ;No parameters allowed
agent-refer-param = "VALUE" "=" "uri" agent-refer-param = "VALUE" "=" "uri"
;Only value parameter allowed ;Only value parameter allowed
agent-inline-value = text-value agent-inline-value = text-value
;Value MUST be a valid vCard object ;Value MUST be a valid vCard object
skipping to change at page 31, line 4 skipping to change at line 1648
;For name="NOTE" ;For name="NOTE"
param = text-param param = text-param
;Only text parameters allowed ;Only text parameters allowed
value = text-value value = text-value
;For name="PRODID" ;For name="PRODID"
param = "" param = ""
;No parameters allowed ;No parameters allowed
vCard MIME Directory Profile
value = text-value value = text-value
;For name="REV" ;For name="REV"
param = ["VALUE" =" "DATE-TIME"] param = ["VALUE" =" "date-time"]
;Only value parameters allowed ; Only value parameters allowed. Values are case insensitive.
param =/ "VALUE" =" "DATE" param =/ "VALUE" =" "date"
;Only value parameters allowed ; Only value parameters allowed. Values are case insensitive.
value = date-time-value value = date-time-value
value =/ date-value value =/ date-value
;For name="SORT-STRING" ;For name="SORT-STRING"
param = text-param param = text-param
;Only text parameters allowed ;Only text parameters allowed
value = text Dawson & Howes [Page 30] October 1998
vCard MIME Directory Profile
value = text-value
;For name="SOUND" ;For name="SOUND"
param = snd-inline-param param = snd-inline-param
;Only sound parameters allowed ;Only sound parameters allowed
param =/ snd-refer-param param =/ snd-refer-param
;Only sound parameters allowed ;Only sound parameters allowed
value = snd-line-value value = snd-line-value
;Value MUST match value type ;Value MUST match value type
value =/ snd-refer-value value =/ snd-refer-value
;Value MUST match value type ;Value MUST match value type
snd-inline-value = binary CRLF snd-inline-value = binary-value CRLF
;Value MUST be "b" encoded audio content ;Value MUST be "b" encoded audio content
snd-inline-param = ("VALUE" "=" "binary"]) snd-inline-param = ("VALUE" "=" "binary"])
/ ("ENCODING" "=" "b") / ("ENCODING" "=" "b")
/ ("TYPE" "=" *SAFE-CHAR) / ("TYPE" "=" *SAFE-CHAR)
;Value MUST be an IANA registered audio type ;Value MUST be an IANA registered audio type
snd-refer-value = uri snd-refer-value = uri
;URI MUST refer to audio content of given type ;URI MUST refer to audio content of given type
snd-refer-param = ("VALUE" "=" "uri") snd-refer-param = ("VALUE" "=" "uri")
/ ("TYPE" "=" word) / ("TYPE" "=" word)
;Value MUST be an IANA registered audio type ;Value MUST be an IANA registered audio type
;For name="UID" ;For name="UID"
param = "" param = ""
;No parameters allowed ;No parameters allowed
value = text-value value = text-value
vCard MIME Directory Profile
;For name="URL" ;For name="URL"
param = "" param = ""
;No parameters allowed ;No parameters allowed
value = uri value = uri
;For name="VERSION" ;For name="VERSION"
;This type MUST be included in a vCard object. ;This type MUST be included in a vCard object.
param = "" param = ""
;No parameters allowed ;No parameters allowed
value = "3.0" value = text-value
; Value MUST be "3.0"
;For name="CLASS" ;For name="CLASS"
param = "" param = ""
;No parameters allowed ;No parameters allowed
Dawson & Howes [Page 31] October 1998
vCard MIME Directory Profile
value = "PUBLIC" / "PRIVATE" / "CONFIDENTIAL" value = "PUBLIC" / "PRIVATE" / "CONFIDENTIAL"
/ iana-token / x-name / iana-token / x-name
; Value are case insensitive
;For name="KEY" ;For name="KEY"
param = key-txt-param param = key-txt-param
;Only value and type parameters allowed ;Only value and type parameters allowed
param =/ key-bin-param param =/ key-bin-param
;Only value and type parameters allowed ;Only value and type parameters allowed
value = text-value value = text-value
value =/ binary value =/ binary-value
key-txt-param = "TYPE" "=" keytype key-txt-param = "TYPE" "=" keytype
key-bin-param = ("TYPE" "=" keytype) key-bin-param = ("TYPE" "=" keytype)
/ ("ENCODING" "=" "b) / ("ENCODING" "=" "b")
;Value MUST be a "b" encoded key or certificate ;Value MUST be a "b" encoded key or certificate
keytype = "X509" / "PGP" / iana-token / x-name keytype = "X509" / "PGP" / iana-token / x-name
; Values are case insensitive
;For name="X-" non-standard type ;For name="X-" non-standard type
param = text-param / (x-name "=" *SAFE-CHAR) param = text-param / (x-name "=" param-value)
;Only text or non-standard parameters allowed ;Only text or non-standard parameters allowed
value = text-list value = text-value
;******************************************* ;*******************************************
; vCard Commonly Used Parameter Definition ; vCard Commonly Used Parameter Definition
;******************************************* ;*******************************************
text-param = ("VALUE" "=" "text") text-param = ("VALUE" "=" "ptext")
/ ("LANGUAGE" "=" langval) / ("LANGUAGE" "=" langval)
/ (x-name "=" *SAFE-CHAR) / (x-name "=" param-value)
langval = <a language string as defined in RFC 1766> langval = <a language string as defined in RFC 1766>
vCard MIME Directory Profile
img-inline-value = binary img-inline-value = binary-value
;Value MUST be "b" encoded image content ;Value MUST be "b" encoded image content
img-inline-param
img-inline-param = ("VALUE" "=" "binary") img-inline-param = ("VALUE" "=" "binary")
/ ("ENCODING" "=" "b") / ("ENCODING" "=" "b")
/ ("TYPE" "=" *SAFE-CHAR / ("TYPE" "=" param-value
;TYPE value MUST be an IANA registered image type ;TYPE value MUST be an IANA registered image type
img-refer-value = uri img-refer-value = uri
;URI MUST refer to image content of given type ;URI MUST refer to image content of given type
Dawson & Howes [Page 32] October 1998
vCard MIME Directory Profile
img-refer-param = ("VALUE" "=" "uri") img-refer-param = ("VALUE" "=" "uri")
/ ("TYPE" "=" *SAFE-CHAR) / ("TYPE" "=" param-value)
;TYPE value MUST be an IANA registered image type ;TYPE value MUST be an IANA registered image type
adr-param = (["TYPE" "="] adr-type *("," *WSP adr-type)) adr-param = ("TYPE" "=" adr-type *("," adr-type))
/ (text-param) / (text-param)
adr-type = "dom" / "intl" / "postal" / "parcel" / "home" adr-type = "dom" / "intl" / "postal" / "parcel" / "home"
/ "work" / "pref" / iana-type / x-name / "work" / "pref" / iana-type / x-name
adr-value = 0*6(text-value ";") text-value adr-value = 0*6(text-value ";") text-value
; PO Box, Extended Address, Street, Locality, Region, Postal ; PO Box, Extended Address, Street, Locality, Region, Postal
; Code, Country Name ; Code, Country Name
;******************************************* ;*******************************************
; vCard Type Value Definition ; vCard Type Value Definition
;******************************************* ;*******************************************
text-list = <A text list value as defined in [MIME-DIR]> text-value-list = 1*text-value *("," 1*text-value)
text-value = <A single text value as defined in [MIME-DIR]> text-value = *(SAFE-CHAR / ":" / DQUOTE / ESCAPED-CHAR)
ESCAPED-CHAR = "\\" / "\;" / "\," / "\n" / "\N")
; \\ encodes \, \n or \N encodes newline
; \; encodes ;, \, encodes ,
binary-value = <A "b" encoded text value as defined in [RFC 2047]> binary-value = <A "b" encoded text value as defined in [RFC 2047]>
date-value = <A single date value as defined in [MIME-DIR]> date-value = <A single date value as defined in [MIME-DIR]>
time-value = <A single time value as defined in [MIME-DIR]> time-value = <A single time value as defined in [MIME-DIR]>
date-time-value = <A single date-time value as defined in [MIME-DIR] date-time-value = <A single date-time value as defined in [MIME-DIR]
float-value = <A single float value as defined in [MIME-DIR]> float-value = <A single float value as defined in [MIME-DIR]>
phone-number-value = <A single text value as defined in [CCITT phone-number-value = <A single text value as defined in [CCITT
E.163] and [CCITT X.121]> E.163] and [CCITT X.121]>
uri-value = <A text value as defined in RFC 1738> uri-value = <A uri value as defined in [MIME-DIR]>
utc-offset-value = ("+" / "-") time-hour ":" time-minute utc-offset-value = ("+" / "-") time-hour ":" time-minute
time-hour = 2DIGIT ;00-23 time-hour = 2DIGIT ;00-23
time-minute = 2DIGIT ;00-59 time-minute = 2DIGIT ;00-59
vCard MIME Directory Profile
5. Differences With vCard v2.1 5. Differences From vCard v2.1
This specification has been reviewed by the IETF community. The This specification has been reviewed by the IETF community. The
review process introduced a number of differences with the [VCARD] review process introduced a number of differences from the [VCARD]
version 2.1. These differences are minor, but require that vCard version 2.1. These differences require that vCard objects conforming
objects conforming to this specification have a different version to this specification have a different version number than a vCard
number than a vCard conforming to [VCARD]. The differences include conforming to [VCARD]. The differences include the following:
the following:
The QUOTED-PRINTABLE inline encoding has been eliminated. Dawson & Howes [Page 33] October 1998
vCard MIME Directory Profile
. The QUOTED-PRINTABLE inline encoding has been eliminated.
Only the "B" encoding of [RFC 2047] is an allowed value for Only the "B" encoding of [RFC 2047] is an allowed value for
the ENCODING parameter. the ENCODING parameter.
The method for specifying CRLF character sequences in text . The method for specifying CRLF character sequences in text
type values has been changed. The CRLF character sequence in type values has been changed. The CRLF character sequence in
a text type value is specified with the backslash character a text type value is specified with the backslash character
sequence "\n" or "\N". sequence "\n" or "\N".
Any COMMA or SEMICOLON in a text type value must be backslash . Any COMMA or SEMICOLON in a text type value must be backslash
escaped. escaped.
VERSION value corresponding to this specification MUST be . VERSION value corresponding to this specification MUST be
"3.0". "3.0".
The [MIME-DIR] predefined types of SOURCE, NAME and PROFILE . The [MIME-DIR] predefined types of SOURCE, NAME and PROFILE
are allowed. are allowed.
The [MIME-DIR] VALUE type parameter for value data typing is . The [MIME-DIR] VALUE type parameter for value data typing is
allowed. In addition, there are extensions made to these type allowed. In addition, there are extensions made to these type
values for additional value types used in this specification. values for additional value types used in this specification.
The [VCARD] CHARSET type parameter has been eliminated. . The [VCARD] CHARSET type parameter has been eliminated.
Character set may only be specified on the CHARSET parameter Character set may only be specified on the CHARSET parameter
on the Content-Type MIME header field. on the Content-Type MIME header field.
The [VCARD] support for non-significant WSP character, other . The [VCARD] support for non-significant WSP character has
than after the COMMA character list separator, SEMICOLON been eliminated.
character value component separator and the COLON value
separator has been eliminated.
LOGO, PHOTO and SOUND multimedia formats MUST be either IANA . The "TYPE=" prefix to parameter values is required. In
[VCARD] this was optional.
. LOGO, PHOTO and SOUND multimedia formats MUST be either IANA
registered types or non-standard types. registered types or non-standard types.
Inline binary content must be "B" encoded and folded. A blank . Inline binary content must be "B" encoded and folded. A blank
line after the encoded binary content is no longer required. line after the encoded binary content is no longer required.
TEL values may be identified as personal communication . TEL values may be identified as personal communication
services telephone numbers with the PCS type parameter value. services telephone numbers with the PCS type parameter value.
The CATEGORIES, CLASS, NICKNAME, PRODID and SORT-STRING types . The CATEGORIES, CLASS, NICKNAME, PRODID and SORT-STRING types
have been added. have been added.
vCard MIME Directory Profile . The VERSION, N and FN types MUST be specified in a vCard.
The VERSION, N and FN types MUST be specified in a vCard.
This identifies the version of the specification that the This identifies the version of the specification that the
object was formatted to. It also assures that every vCard object was formatted to. It also assures that every vCard
will include both a structured and formatted name that can be will include both a structured and formatted name that can be
used to identify the object. used to identify the object.
6. Acknowledgements 6. Acknowledgements
The many valuable comments contributed by members of the IETF ASID The many valuable comments contributed by members of the IETF ASID
working group are gratefully acknowledged, as are the contributions working group are gratefully acknowledged, as are the contributions
Dawson & Howes [Page 34] October 1998
vCard MIME Directory Profile
by Roland Alden, Stephen Bartlett, Alec Dun, Daniel Gurney, Bruce by Roland Alden, Stephen Bartlett, Alec Dun, Daniel Gurney, Bruce
Johnston, Daniel Klaussen, Vinod Seraphin, Michelle Watkins. Chris Johnston, Daniel Klaussen, Vinod Seraphin, Michelle Watkins. Chris
Newman was especially helpful in navigating the intricacies of ABNF Newman was especially helpful in navigating the intricacies of ABNF
lore. lore.
7. Authors?s Addresses 7. Authors' Addresses
BEGIN:vCard BEGIN:vCard
VERSION:3.0 VERSION:3.0
FN:Frank Dawson FN:Frank Dawson
ORG:Lotus Development Corporation ORG:Lotus Development Corporation
ADR;TYPE=WORK,POSTAL,PARCEL:;;6544 Battleford Drive ADR;TYPE=WORK,POSTAL,PARCEL:;;6544 Battleford Drive
;Raleigh;NC;27613-3502;U.S.A. ;Raleigh;NC;27613-3502;U.S.A.
TEL;TYPE=VOICE,MSG,WORK: +1-919-676-9515 TEL;TYPE=VOICE,MSG,WORK: +1-919-676-9515
TEL;TYPE=FAX,WORK: +1-919-676-9564 TEL;TYPE=FAX,WORK: +1-919-676-9564
EMAIL;TYPE=INTERNET,PREF:Frank_Dawson@Lotus.com EMAIL;TYPE=INTERNET,PREF:Frank_Dawson@Lotus.com
skipping to change at page 36, line 5 skipping to change at line 1940
[ISO 8601] ISO 8601:1988 - Data elements and interchange formats - [ISO 8601] ISO 8601:1988 - Data elements and interchange formats -
Information interchange - Representation of dates and times - The Information interchange - Representation of dates and times - The
International Organization for Standardization, June, 1988. International Organization for Standardization, June, 1988.
[ISO 8601 TC] ISO 8601, Technical Corrigendum 1 - Data elements and [ISO 8601 TC] ISO 8601, Technical Corrigendum 1 - Data elements and
interchange formats - Information interchange - Representation of interchange formats - Information interchange - Representation of
dates and times - The International Organization for Standardization, dates and times - The International Organization for Standardization,
May, 1991. May, 1991.
vCard MIME Directory Profile
[ISO 9070] ISO 9070, Information Processing - SGML support facilities [ISO 9070] ISO 9070, Information Processing - SGML support facilities
- Registration Procedures for Public Text Owner Identifiers, April, - Registration Procedures for Public Text Owner Identifiers, April,
1991. 1991.
[CCITT E.163] Recommendation E.163 - Numbering Plan for The [CCITT E.163] Recommendation E.163 - Numbering Plan for The
International Telephone Service, CCITT Blue Book, Fascicle II.2, pp. International Telephone Service, CCITT Blue Book, Fascicle II.2, pp.
128-134, November, 1988. 128-134, November, 1988.
Dawson & Howes [Page 35] October 1998
vCard MIME Directory Profile
[CCITT X.121] Recommendation X.121 - International Numbering Plan for [CCITT X.121] Recommendation X.121 - International Numbering Plan for
Public Data Networks, CCITT Blue Book, Fascicle VIII.3, pp. 317-332, Public Data Networks, CCITT Blue Book, Fascicle VIII.3, pp. 317-332,
November, 1988. November, 1988.
[CCITT X.520] Recommendation X.520 - The Directory - Selected [CCITT X.520] Recommendation X.520 - The Directory - Selected
Attribute Types, November 1988. Attribute Types, November 1988.
[CCITT X.521] Recommendation X.521 - The Directory - Selected Object [CCITT X.521] Recommendation X.521 - The Directory - Selected Object
Classes, November 1988. Classes, November 1988.
[MIME-DIR] Howes, T., Smith, M., Dawson, F. "A MIME Content-Type for [MIME-DIR] Howes, T., Smith, M., Dawson, F. "A MIME Content-Type for
Directory Information", RFC xxxx, March 1998. Directory Information", RFC xxxx, April 1998.
[RFC 1738] Berners-Lee, T., Masinter, L., McCahill, M., "Uniform [RFC 1738] Berners-Lee, T., Masinter, L., McCahill, M., "Uniform
Resource Locators (URL)", RFC 1738, December 1994. Resource Locators (URL)", RFC 1738, December 1994.
[RFC 1766] Alvestrand, H., "Tags for the Identification of [RFC 1766] Alvestrand, H., "Tags for the Identification of
Languages", March 1995. Languages", March 1995.
[RFC 1872] Levinson, E., "The MIME Multipart/Related Content-type," [RFC 1872] Levinson, E., "The MIME Multipart/Related Content-type,"
RFC 1872, December 1995. RFC 1872, December 1995.
skipping to change at page 37, line 5 skipping to change at line 1997
[RFC 2119] "Key words for use in RFCs to Indicate Requirement [RFC 2119] "Key words for use in RFCs to Indicate Requirement
Levels", RFC 2119, March 1997. Levels", RFC 2119, March 1997.
[RFC 2234] Crocker, D., Overell, P., "Augmented BNF for Syntax [RFC 2234] Crocker, D., Overell, P., "Augmented BNF for Syntax
Specifications: ABNF", RFC 2234, November 1997. Specifications: ABNF", RFC 2234, November 1997.
[UNICODE] "The Unicode Standard - Version 2.0", The Unicode [UNICODE] "The Unicode Standard - Version 2.0", The Unicode
Consortium, July 1996. Consortium, July 1996.
vCard MIME Directory Profile
[VCARD] Internet Mail Consortium, "vCard - The Electronic Business [VCARD] Internet Mail Consortium, "vCard - The Electronic Business
Card Version 2.1", http://www.imc.org/pdi/vcard-21.txt, September 18, Card Version 2.1", http://www.imc.org/pdi/vcard-21.txt, September 18,
1996. 1996.
9. Full Copyright Statement 9. Full Copyright Statement
"Copyright (C) The Internet Society (date). All Rights Reserved. "Copyright (C) The Internet Society (date). All Rights Reserved.
Dawson & Howes [Page 36] October 1998
vCard MIME Directory Profile
This document and translations of it MAY be copied and furnished to This document and translations of it MAY be copied and furnished to
others, and derivative works that comment on or otherwise explain it others, and derivative works that comment on or otherwise explain it
or assist in its implementation MAY be prepared, copied, published or assist in its implementation MAY be prepared, copied, published
and distributed, in whole or in part, without restriction of any and distributed, in whole or in part, without restriction of any
kind, provided that the above copyright notice and this paragraph are kind, provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this included on all such copies and derivative works. However, this
document itself MAY not be modified in any way, such as by removing document itself MAY not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for developing Internet standards in which case the procedures for
skipping to change at line 1952 skipping to change at line 2031
The limited permissions granted above are perpetual and will not be The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assigns. revoked by the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an This document and the information contained herein is provided on an
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Dawson & Howes [Page 37] October 1998
 End of changes. 176 change blocks. 
209 lines changed or deleted 288 lines changed or added

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