Domain names mapping ==================== Informative commands: .. toctree:: :maxdepth: 1 check info Object transform commands: .. toctree:: :maxdepth: 1 create update delete transfer Unimplemented commands: .. toctree:: :maxdepth: 1 renew Overview -------- Implementation of domain names mapping closely follows RFC-5731, with a simple :ref:`extension `. Several policy restrictions apply (read more on this :ref:`here `): * Nameservers are attributes of domain names and should be specified with ``domain:hostAttr`` elements [#hostattr]_ * Up to 5 nameservers can be assigned for a domain name - at least two are required for a domain to become active. * Domain name should always have exactly 4 contacts: - billing contact (always registrar's primary person) - technical contact (one of the hostmasters, associated with the registrar) - the registrant (may be a legal or private person) - administrative contact (should be a private person) What can be registered? ~~~~~~~~~~~~~~~~~~~~~~~ We offer also IDN domain names - they may include following Unicode symbols, specific for the Latvian language: * ``ē``, ``ū``, ``ī``, ``ā``, ``š``, ``ģ``, ``ķ``, ``ļ``, ``ž``, ``č``, ``ņ`` and ``ŗ`` .. note :: Please note, that the length of an IDN domain name is measured in its ACE-encoded (Punycode) form! .. note :: Our server recognizes IDN domain and host names both in their UTF8 and Punycode representations - so either one may be used in commands and queries. A set of **second level subdomains** of TLD ".lv" may be registered, including: * ``.com.lv`` - subdomain for commercial entities * ``.edu.lv`` - subdomain for educational institutions * ``.org.lv`` - subdomain for various forms of affiliation groups * ``.id.lv`` - subdomain for individuals * ``.net.lv`` - subdomain for network infrastructure providers * ``.asn.lv`` - subdomain for associations * ``.conf.lv`` - subdomain for conferences and exhibitions requiring short duration Internet connectivity .. _epp-domain-states-list: Supported status values ~~~~~~~~~~~~~~~~~~~~~~~ ``ok`` The normal state of an active domain name ``inactive`` This state means that the domain name has no name servers attached and, therefore, is not exported in .lv zone. ``serverHold`` Is set when the domain name is *"commented"* - meaning that warning has been sent, but the payment is still late and domain has been taken out from .lv zone. ``pendingCreate`` A domain name is in a pending create state when a registration request has been submitted but is not yet reviewed (and approved or rejected). ``pendingRenew`` During a month when the domain name expires, it is included in the registrar's bill and goes into pendingRenew state. While in that state, the registrar may choose - auto-renew domain name at the end of the month or let it expire. ``pendingTransfer`` Registrar change request for a domain name has been initiated but is not yet reviewed by the other involved side. .. _epp-domain-state-clientAutoRenewProhibited: ``clientAutoRenewProhibited`` A client can set this state for domain names, included in the :ref:`active bill `, to refuse further management of that domain object after the bill is finalized. ``serverTransferProhibited`` This status freezes domain name sponsorship transfer and is set: * for newly registered domain names - until the end of the following month (e.g. ``example-summerify.lv``, registered on 3rd of June will have this status removed on 31th of July); * for expiring domain names - while a domain name is included in the active registrar bill (e.g., if ``shouldrenew.lv``, registered a year ago, expires on 15th of August, the ``serverTransferProhibited`` status would be set as soon as August bill is created, and would persist until the last day of the August). ``serverUpdateProhibited`` It is set when a domain name is locked for editing (because of payment or legal issues). ``clientUpdateProhibited`` When this is set, the only allowed change is to remove this status (no much use of it though, as only the sponsoring client can modify details of a domain name) Some status values are defined in EPP protocol but not used for .lv domain names (and cannot, therefore, be set or removed), for example: ``pendingDelete``, ``pendingUpdate``, ``clientRenewProhibited`` and ``serverRenewProhibited`` .. Domain names * Although NIC.LV supports a subset :term:`IDN` domain names, they should always be given in :term:`ACE-encoded form ` * See :ref:`Technical requirements for .lv domain names` to learn what .lv names are allowed. .. rubric:: Footnotes .. [#hostattr] `(RFC-5731) 1.1 Relationship of Domain Objects and Host Objects `_