Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java(TM) System Directory Server 5.2 2005Q1 Administration Reference 

Chapter 5
Directory Internationalization Reference

Directory Server allows you to store, manage, and search for entries and their associated attributes in a number of different languages. An internationalized directory can be an invaluable corporate resource, providing employees and business partners with immediate access to the information they need in the languages they can understand.

The directory supports all international characters by default because directory data is stored in UTF-8. Further, Directory Server allows you to specify matching rules and collation orders based on language preferences in search operations.


Note

You must use ASCII characters for attribute and object class names.


This chapter contains the following sections:


About Locales

Directory Server provides support for multiple languages through the use of locales. A locale identifies language-specific information about how users of a specific region, culture, and/or custom expect data to be presented, including how data of a given language is interpreted and how data is to be sorted, or collated.

In addition, the locale may indicate what code page an application should select for interaction with an end user concerning this data. A code page is an internal table that the operating system uses to relate keyboard keys to character font screen displays.

More specifically, a locale specifies:


Identifying Supported Locales

When performing directory operations that require you to specify a locale, such as a search operation, you can use a language tag or a collation order object identifier (OID).

A language tag is a string that begins with the two-character lowercase language code that identifies the language (as defined in ISO standard 639). If necessary to distinguish regional differences in language, the language tag may also contain a country code, which is a two-character string (as defined in ISO standard 3166). The language code and country code are separated by a hyphen. For example, the language tag used to identify the American English locale is en-US.

An object identifier (OID) is a decimal number used to uniquely identify an object, such as an attribute or object class. The OIDs you use when searching or indexing an internationalized directory identify specific collation orders supported by Directory Server. For example, the OID 1.3.6.1.4.1.42.2.27.9.4.74.1 identifies the Finnish collation order.

When performing an international search in the directory, use either the language tag or the OID to identify the collation order you want to use. When setting up an international index, you must use the OIDs. For more information on indexing, see "Managing Indexes" in the Directory Server Administration Guide.

Table 5-1 lists each locale supported by Directory Server and identifies the associated language tags and OIDs. The old OID is provided for backward compatibility.

Table 5-1 Supported Locales 

Locale

Tag

Collation Order OID

Backward Compatible OID

Afrikaans

af

1.3.6.1.4.1.42.2.27.9.4.1.1

 

Amharic Ethiopia

am

1.3.6.1.4.1.42.2.27.9.4.2.1

 

Arabic

ar

1.3.6.1.4.1.42.2.27.9.4.3.1

2.16.840.1.113730.3.3.2.1.1

Arabic United Arab Emirates

ar-AE

1.3.6.1.4.1.42.2.27.9.4.4.1

 

Arabic Bahrain

ar-BH

1.3.6.1.4.1.42.2.27.9.4.5.1

 

Arabic Algeria

ar-DZ

1.3.6.1.4.1.42.2.27.9.4.6.1

 

Arabic Egypt

ar-EG

1.3.6.1.4.1.42.2.27.9.4.7.1

 

Arabic India

ar-IN

1.3.6.1.4.1.42.2.27.9.4.8.1

 

Arabic Iraq

ar-IQ

1.3.6.1.4.1.42.2.27.9.4.9.1

 

Arabic Jordan

ar-JO

1.3.6.1.4.1.42.2.27.9.4.10.1

 

Arabic Kuwait

ar-KW

1.3.6.1.4.1.42.2.27.9.4.11.1

 

Arabic Lebanon

ar-LB

1.3.6.1.4.1.42.2.27.9.4.12.1

 

Arabic Libya

ar-LY

1.3.6.1.4.1.42.2.27.9.4.13.1

 

Arabic Morocco

ar-MA

1.3.6.1.4.1.42.2.27.9.4.14.1

 

Arabic Oman

ar-OM

1.3.6.1.4.1.42.2.27.9.4.15.1

 

Arabic Qatar

ar-QA

1.3.6.1.4.1.42.2.27.9.4.16.1

 

Arabic Saudi Arabia

ar-SA

1.3.6.1.4.1.42.2.27.9.4.17.1

 

Arabic Sudan

ar-SD

1.3.6.1.4.1.42.2.27.9.4.18.1

 

Arabic Syria

ar-SY

1.3.6.1.4.1.42.2.27.9.4.19.1

 

Arabic Tunisia

ar-TN

1.3.6.1.4.1.42.2.27.9.4.20.1

 

Arabic Yemen

ar-YE

1.3.6.1.4.1.42.2.27.9.4.21.1

 

Byelorussian

be

1.3.6.1.4.1.42.2.27.9.4.22.1

2.16.840.1.113730.3.3.2.2.1

Bulgarian

bg

1.3.6.1.4.1.42.2.27.9.4.23.1

2.16.840.1.113730.3.3.2.3.1

Bengali India

bn

1.3.6.1.4.1.42.2.27.9.4.24.1

 

Catalan

ca

1.3.6.1.4.1.42.2.27.9.4.25.1

2.16.840.1.113730.3.3.2.4.1

Czech

cs

1.3.6.1.4.1.42.2.27.9.4.26.1

2.16.840.1.113730.3.3.2.5.1

Danish

da

1.3.6.1.4.1.42.2.27.9.4.27.1

2.16.840.1.113730.3.3.2.6.1

German

de or de-DE

1.3.6.1.4.1.42.2.27.9.4.28.1

2.16.840.1.113730.3.3.2.7.1

German Austria

de-AT

1.3.6.1.4.1.42.2.27.9.4.29.1

2.16.840.1.113730.3.3.2.8.1

German Belgium

de-BE

1.3.6.1.4.1.42.2.27.9.4.30.1

 

German Swiss

de-CH

1.3.6.1.4.1.42.2.27.9.4.31.1

2.16.840.1.113730.3.3.2.9.1

German Luxembourg

de-LU

1.3.6.1.4.1.42.2.27.9.4.32.1

 

Greek

el

1.3.6.1.4.1.42.2.27.9.4.33.1

2.16.840.1.113730.3.3.2.10.1

English (US)

en-US

1.3.6.1.4.1.42.2.27.9.4.34.1

2.16.840.1.113730.3.3.2.11.1

English Australian

en-AU

1.3.6.1.4.1.42.2.27.9.4.35.1

 

English Canada

en-CA

1.3.6.1.4.1.42.2.27.9.4.36.1

2.16.840.1.113730.3.3.2.12.1

English Great Britain

en-GB

1.3.6.1.4.1.42.2.27.9.4.37.1

2.16.840.1.113730.3.3.2.13.1

English Hong Kong

en-HK

1.3.6.1.4.1.42.2.27.9.4.38.1

 

English Ireland

en-IE

1.3.6.1.4.1.42.2.27.9.4.39.1

2.16.840.1.113730.3.3.2.14.1

English India

en-IN

1.3.6.1.4.1.42.2.27.9.4.40.1

 

English Malta

en-MT

1.3.6.1.4.1.42.2.27.9.4.41.1

 

English New Zealand

en-NZ

1.3.6.1.4.1.42.2.27.9.4.42.1

 

English Philippines

en-PH

1.3.6.1.4.1.42.2.27.9.4.43.1

 

English Singapore

en-SG

1.3.6.1.4.1.42.2.27.9.4.44.1

 

English Virgin Island

en-VI

1.3.6.1.4.1.42.2.27.9.4.45.1

 

English South Africa

en-ZA

1.3.6.1.4.1.42.2.27.9.4.46.1

 

English Zimbabwe

en-ZW

1.3.6.1.4.1.42.2.27.9.4.47.1

 

Esperanto

eo

1.3.6.1.4.1.42.2.27.9.4.48.1

 

Spanish

es or es-ES

1.3.6.1.4.1.42.2.27.9.4.49.1

2.16.840.1.113730.3.3.2.15.1

Spanish Argentina

es-AR

1.3.6.1.4.1.42.2.27.9.4.50.1

 

Spanish Bolivia

es-BO

1.3.6.1.4.1.42.2.27.9.4.51.1

 

Spanish Chile

es-CL

1.3.6.1.4.1.42.2.27.9.4.52.1

 

Spanish Colombia

es-CO

1.3.6.1.4.1.42.2.27.9.4.53.1

 

Spanish Costa Rica

es-CR

1.3.6.1.4.1.42.2.27.9.4.54.1

 

Spanish Dominican Rep.

es-DO

1.3.6.1.4.1.42.2.27.9.4.55.1

 

Spanish Ecuador

es-EC

1.3.6.1.4.1.42.2.27.9.4.56.1

 

Spanish Guatemala

es-GT

1.3.6.1.4.1.42.2.27.9.4.57.1

 

Spanish Honduras

es-HN

1.3.6.1.4.1.42.2.27.9.4.58.1

 

Spanish Mexico

es-MX

1.3.6.1.4.1.42.2.27.9.4.59.1

 

Spanish Nicaragua

es-NI

1.3.6.1.4.1.42.2.27.9.4.60.1

 

Spanish Panama

es-PA

1.3.6.1.4.1.42.2.27.9.4.61.1

 

Spanish Peru

es-PE

1.3.6.1.4.1.42.2.27.9.4.62.1

 

Spanish Puerto Rico

es-PR

1.3.6.1.4.1.42.2.27.9.4.63.1

 

Spanish Paraguay

es-PY

1.3.6.1.4.1.42.2.27.9.4.64.1

 

Spanish El Salvador

es-SV

1.3.6.1.4.1.42.2.27.9.4.65.1

 

Spanish US

es-US

1.3.6.1.4.1.42.2.27.9.4.66.1

 

Spanish Uruguay

es-UY

1.3.6.1.4.1.42.2.27.9.4.67.1

 

Spanish Venezuela

es-VE

1.3.6.1.4.1.42.2.27.9.4.68.1

 

Estonian

et

1.3.6.1.4.1.42.2.27.9.4.69.1

2.16.840.1.113730.3.3.2.16.1

Basque

eu

1.3.6.1.4.1.42.2.27.9.4.70.1

 

Persian

fa

1.3.6.1.4.1.42.2.27.9.4.71.1

 

Persian India

fa-IN

1.3.6.1.4.1.42.2.27.9.4.72.1

 

Persian Iran

fa-IR

1.3.6.1.4.1.42.2.27.9.4.73.1

 

Finnish

fi

1.3.6.1.4.1.42.2.27.9.4.74.1

2.16.840.1.113730.3.3.2.17.1

Faeroese

fo

1.3.6.1.4.1.42.2.27.9.4.75.1

 

French

fr or fr-FR

1.3.6.1.4.1.42.2.27.9.4.76.1

2.16.840.1.113730.3.3.2.18.1

French Belgium

fr-BE

1.3.6.1.4.1.42.2.27.9.4.77.1

2.16.840.1.113730.3.3.2.19.1

French Canada

fr-CA

1.3.6.1.4.1.42.2.27.9.4.78.1

2.16.840.1.113730.3.3.2.20.1

French Swiss

fr-CH

1.3.6.1.4.1.42.2.27.9.4.79.1

2.16.840.1.113730.3.3.2.21.1

French Luxembourg

fr-LU

1.3.6.1.4.1.42.2.27.9.4.80.1

 

Irish

ga

1.3.6.1.4.1.42.2.27.9.4.81.1

 

Galician

gl

1.3.6.1.4.1.42.2.27.9.4.82.1

 

Gujarati

gu

1.3.6.1.4.1.42.2.27.9.4.83.1

 

Manx Gaelic (Isle of Man)

gv

1.3.6.1.4.1.42.2.27.9.4.84.1

 

Hebrew

he or iw

1.3.6.1.4.1.42.2.27.9.4.85.1

2.16.840.1.113730.3.3.2.27.1

Hindi

hi

1.3.6.1.4.1.42.2.27.9.4.86.1

 

Croatian

hr

1.3.6.1.4.1.42.2.27.9.4.87.1

2.16.840.1.113730.3.3.2.22.1

Hungarian

hu

1.3.6.1.4.1.42.2.27.9.4.88.1

2.16.840.1.113730.3.3.2.23.1

Armenian

hy

1.3.6.1.4.1.42.2.27.9.4.89.1

 

Indonesian

id

1.3.6.1.4.1.42.2.27.9.4.90.1

 

Icelandic

is

1.3.6.1.4.1.42.2.27.9.4.91.1

2.16.840.1.113730.3.3.2.24.1

Italian

it

1.3.6.1.4.1.42.2.27.9.4.92.1

2.16.840.1.113730.3.3.2.25.1

Italian Swiss

it-CH

1.3.6.1.4.1.42.2.27.9.4.93.1

2.16.840.1.113730.3.3.2.26.1

Japanese

ja

1.3.6.1.4.1.42.2.27.9.4.94.1

2.16.840.1.113730.3.3.2.28.1

Greenlandic

kl

1.3.6.1.4.1.42.2.27.9.4.95.1

 

Kannada

kn

1.3.6.1.4.1.42.2.27.9.4.96.1

 

Korean

ko

1.3.6.1.4.1.42.2.27.9.4.97.1

2.16.840.1.113730.3.3.2.29.1

Konkani

kok

1.3.6.1.4.1.42.2.27.9.4.98.1

 

Cornish

kw

1.3.6.1.4.1.42.2.27.9.4.99.1

 

Lithuanian

lt

1.3.6.1.4.1.42.2.27.9.4.100.1

2.16.840.1.113730.3.3.2.30.1

Latvian or Lettish

lv

1.3.6.1.4.1.42.2.27.9.4.101.1

2.16.840.1.113730.3.3.2.31.1

Macedonian

mk

1.3.6.1.4.1.42.2.27.9.4.102.1

2.16.840.1.113730.3.3.2.32.1

Marathi

mr

1.3.6.1.4.1.42.2.27.9.4.103.1

 

Maltese

mt

1.3.6.1.4.1.42.2.27.9.4.104.1

 

Dutch

nl or nl-NL

1.3.6.1.4.1.42.2.27.9.4.105.1

2.16.840.1.113730.3.3.2.33.1

Dutch Belgium

nl-BE

1.3.6.1.4.1.42.2.27.9.4.106.1

2.16.840.1.113730.3.3.2.34.1

Norwegian

no or no-NO

1.3.6.1.4.1.42.2.27.9.4.107.1

2.16.840.1.113730.3.3.2.35.1

Norwegian Nynorsk

no-NO-NY

1.3.6.1.4.1.42.2.27.9.4.108.1

2.16.840.1.113730.3.3.2.37.1

Norwegian Nynorsk

nn

1.3.6.1.4.1.42.2.27.9.4.109.1

 

Norwegian Bokmål

nb or no-NO-B

1.3.6.1.4.1.42.2.27.9.4.110.1

2.16.840.1.113730.3.3.2.36.1

Oromo (Afan)

om

1.3.6.1.4.1.42.2.27.9.4.111.1

 

Oromo Ethiopia

om-ET

1.3.6.1.4.1.42.2.27.9.4.112.1

 

Oromo Kenya

om-KE

1.3.6.1.4.1.42.2.27.9.4.113.1

 

Polish

pl

1.3.6.1.4.1.42.2.27.9.4.114.1

2.16.840.1.113730.3.3.2.38.1

Portuguese

pt or pt-PT

1.3.6.1.4.1.42.2.27.9.4.115.1

 

Portuguese Brazil

pt-BR

1.3.6.1.4.1.42.2.27.9.4.116.1

 

Romanian

ro

1.3.6.1.4.1.42.2.27.9.4.117.1

2.16.840.1.113730.3.3.2.39.1

Russian

ru or ru-RU

1.3.6.1.4.1.42.2.27.9.4.118.1

2.16.840.1.113730.3.3.2.40.1

Russian Ukraine

ru-UA

1.3.6.1.4.1.42.2.27.9.4.119.1

 

Serbo-Croatian

sh

1.3.6.1.4.1.42.2.27.9.4.120.1

2.16.840.1.113730.3.3.2.41.1

Slovak

sk

1.3.6.1.4.1.42.2.27.9.4.121.1

2.16.840.1.113730.3.3.2.42.1

Slovenian

sl

1.3.6.1.4.1.42.2.27.9.4.122.1

2.16.840.1.113730.3.3.2.43.1

Somali

so or so-SO

1.3.6.1.4.1.42.2.27.9.4.123.1

 

Somali Djibouti

so-DJ

1.3.6.1.4.1.42.2.27.9.4.124.1

 

Somali Ethiopia

so-ET

1.3.6.1.4.1.42.2.27.9.4.125.1

 

Somali Kenya

so-KE

1.3.6.1.4.1.42.2.27.9.4.126.1

 

Albanian

sq

1.3.6.1.4.1.42.2.27.9.4.127.1

2.16.840.1.113730.3.3.2.44.1

Serbian

sr

1.3.6.1.4.1.42.2.27.9.4.128.1

2.16.840.1.113730.3.3.2.45.1

Swedish

sv-SE

1.3.6.1.4.1.42.2.27.9.4.129.1

2.16.840.1.113730.3.3.2.46.1

Swedish Finland

sv-FI

1.3.6.1.4.1.42.2.27.9.4.130.1

 

Swahili

sw

1.3.6.1.4.1.42.2.27.9.4.131.1

 

Swahili Kenya

sw-KE

1.3.6.1.4.1.42.2.27.9.4.132.1

 

Swahili Tanzania

sw-TZ

1.3.6.1.4.1.42.2.27.9.4.133.1

 

Tamil

ta

1.3.6.1.4.1.42.2.27.9.4.134.1

 

Telugu

te

1.3.6.1.4.1.42.2.27.9.4.135.1

 

Thai

th

1.3.6.1.4.1.42.2.27.9.4.136.1

 

Tigrinya

ti

1.3.6.1.4.1.42.2.27.9.4.137.1

 

Tigrinya Eritrea

ti-ER

1.3.6.1.4.1.42.2.27.9.4.138.1

 

Tigrinya Ethiopia

ti-ET

1.3.6.1.4.1.42.2.27.9.4.139.1

 

Turkish

tr

1.3.6.1.4.1.42.2.27.9.4.140.1

2.16.840.1.113730.3.3.2.47.1

Ukrainian

uk

1.3.6.1.4.1.42.2.27.9.4.141.1

2.16.840.1.113730.3.3.2.48.1

Vietnamese

vi

1.3.6.1.4.1.42.2.27.9.4.142.1

 

Chinese

zh

1.3.6.1.4.1.42.2.27.9.4.143.1

2.16.840.1.113730.3.3.2.49.1

Chinese China

zh-CN

1.3.6.1.4.1.42.2.27.9.4.144.1

 

Chinese Hong Kong

zh-HK

1.3.6.1.4.1.42.2.27.9.4.145.1

 

Chinese Mongolia

zh-MO

1.3.6.1.4.1.42.2.27.9.4.146.1

 

Chinese Singapore

zh-SG

1.3.6.1.4.1.42.2.27.9.4.147.1

 

Chinese Taiwan

zh-TW

1.3.6.1.4.1.42.2.27.9.4.148.1

2.16.840.1.113730.3.3.2.50.1


Supported Language Subtypes

Language subtypes can be used by clients to indicate specific attributes in characters of a language other than the default language of a deployment. For example, German users may prefer to see addresses in German when possible. In this case, you can select German as a language subtype for the streetAddress attribute so that users can search for either the English or the German representation of the address. If you specify a language subtype for an attribute, the subtype is added to the attribute name as follows:

attribute;lang-subtype

The example mentioned previously would be displayed in LDIF as follows:

streetAddress;lang-en: 10 Schlossplatz, 76113, Karlsruhe, Germany
streetAddress;lang-de: Schloßplatz 10, 76113, Karlsruhe, Deutschland

Table 5-2 contains the list of supported language subtypes.

Table 5-2 Supported Language Subtypes 

Language

Language Tag

Afrikaans

af

Albanian

sq

Amharic Ethiopia

am

Arabic

ar

Armenian

hy

Basque

eu

Bengali India

bn

Bulgarian

bg

Byelorussian

be

Catalan

ca

Chinese

zh

Cornish

kw

Croatian

hr

Czech

cs

Danish

da

Dutch

nl

English

en

Esperanto

eo

Estonian

et

Faeroese

fo

Finnish

fi

French

fr

Galician

gl

German

de

Greek

el

Greenlandic

kl

Gujarati

gu

Hebrew

he or iw

Hindi

hi

Hungarian

hu

Icelandic

is

Indonesian

id

Irish

ga

Italian

it

Japanese

ja

Kannada

kn

Konkani

kok

Korean

ko

Latvian or Lettish

lv

Lithuanian

lt

Macedonian

mk

Maltese

mt

Manx (Isle of Man)

gv

Marathi

mr

Norwegian

no

Oromo

om

Persian

fa

Polish

pl

Portuguese

pt

Romanian

ro

Russian

ru

Serbian

sr

Serbo-Croatian

sh

Slovak

sk

Slovenian

sl

Somali

so

Spanish

es

Swahili

sw

Swedish

sv

Tamil

ta

Telugu

te

Thai

th

Tigrinya

ti

Turkish

tr

Ukrainian

uk

Vietnamese

vi



Previous      Contents      Index      Next     


Copyright 2005 Sun Microsystems, Inc. All rights reserved.