rfc2832.txt

著名的RFC文档,其中有一些文档是已经翻译成中文的的.

   A command name specifies the type of an RRP request.  A command is a
   word or abbreviation terminated by a carriage-return linefeed (crlf)
   sequence.

     CommandName<crlf>

   An entity block specifies the data in an RRP request. It consists of
   attribute name-value pairs specifying the entity and all of the
   attributes of the entity.  Each attribute name-value pair starts with
   the attribute name, followed by a colon, the attribute value, and is
   finally terminated by a carriage-return linefeed sequence.  Entity
   blocks are optional for some requests.

     entityName:entityValue<crlf>
     attributeName:attributeValue<crlf>

   Command options specify control parameters for an RRP request. A
   command option starts with a dash, followed by the option name, a
   colon, the option value, and is finally terminated by a carriage-
   return linefeed sequence.

     -commandOptionName:commandOptionValue<crlf>





Hollenbeck & Srivastava      Informational                      [Page 7]

RFC 2832            NSI Registry Registrar Protocol             May 2000


   An EndOfCommand delimiter specifies the end of an RRP request.  It
   consists of a dot (".") in column one followed by a carriage-return
   linefeed sequence.

     .<crlf>

4.2 Response Format

   An RRP response starts with a three-digit response code, followed by
   a space, an ASCII text description of the response, a carriage-return
   linefeed sequence, and zero or more attribute name-value pair lines.
   An RRP response is terminated by a dot in column one followed by a
   carriage-return linefeed sequence.

     ResponseCode<space>responseDescription<crlf>
     [attributeName:attributeValue<crlf>]
     .<crlf>

4.3 Protocol Commands

   Implementations of RRP commands MUST provide "all or nothing" success
   and failure operation. Failed command execution MUST leave the System
   in the same state it was in before the command was attempted and
   failed.

   All RRP commands include features to provide idempotency. Command
   features that are not idempotent are explained fully as needed as
   part of the appropriate command description.

4.3.1 ADD

   This command allows a registrar to register a domain name or a name
   server in the System.

4.3.1.1 Registering a Domain Name

   The request to register a domain name MUST contain the following
   data:

   - The "EntityName" parameter set to value "Domain".
   - Fully qualified second level domain name in the "DomainName"
     parameter.









Hollenbeck & Srivastava      Informational                      [Page 8]

RFC 2832            NSI Registry Registrar Protocol             May 2000


   The request to register a domain name MAY contain 1 or more, and a
   maximum of 13, fully qualified name servers hosting the domain name
   in multiple instances of the "NameServer" parameter. The name servers
   MUST have already been registered in the registry. Implementations
   MAY allow specification of name servers associated with domains
   registered in other TLDs. For example, an implementation MAY allow
   use of ccTLD name servers for gTLD domain name registration.

   The request to register a domain name MAY contain the initial
   registration period in years for the domain being registered in a
   single instance of the "Period" parameter. The System MUST provide a
   default initial registration period in years if the "Period"
   parameter is not provided. The acceptable year values for the
   "Period" parameter are implementation specific.

   The System will register the domain name to the registrar for the
   period specified by the registrar. If the registrar does not specify
   a registration period, a System-specified default value MUST be used
   for the initial registration period. If the domain name is
   successfully registered, the System MUST return the registration
   expiration date in the "registration expiration date" attribute in
   the response.

   Authorized User: All registrars MAY use the ADD command to register
   domain names.

   Examples

   A registrar registers a domain name without specifying name servers:

   C:add<crlf>
   C:EntityName:Domain<crlf>
   C:DomainName:example.com<crlf>
   C:-Period:10<crlf>
   C:.<crlf>
   S:200 Command completed successfully<crlf>
   S:registration expiration date:2009-09-22 10:27:00.0<crlf>
   S:status:ACTIVE<crlf>
   S:.<crlf>












Hollenbeck & Srivastava      Informational                      [Page 9]

RFC 2832            NSI Registry Registrar Protocol             May 2000


   A registrar registers a domain name using previously-registered name
   servers:

   C:add<crlf>
   C:EntityName:Domain<crlf>
   C:DomainName:example2.com<crlf>
   C:-Period:10<crlf>
   C:NameServer:ns1.example.com<crlf>
   C:NameServer:ns2.example.com<crlf>
   C:.<crlf>
   S:200 Command completed successfully<crlf>
   S:registration expiration date:2000-09-22 10:27:00.0<crlf>
   S:status:ACTIVE<crlf>
   S:.<crlf>

4.3.1.2 Registering a Name Server

   The request to register a name server MUST contain the following
   data:

   - The "EntityName" parameter set to value "NameServer".
   - Fully qualified server name of the name server in the "NameServer"
     parameter.

   If the name server being registered is the child of a registered
   domain name, the name server registration request MUST include one or
   more, and a maximum of 13, name server IP addresses in multiple
   instances of the "IPAddress" parameter. Name servers associated with
   domains registered in other TLDs SHOULD NOT be specified with IP
   addresses to reduce the possibility of duplicating DNS NS records for
   the name servers in multiple zone files.

   The registrar MUST register the name server in the System before
   using it to host domain names. Further, the name server MUST be
   registered through the same registrar that is the current registrar
   of its parent domain name. The System MAY allow any registrar to use
   the name server to host domain names.

   Authorized User: All registrars MAY use the ADD command to register
   name servers.











Hollenbeck & Srivastava      Informational                     [Page 10]

RFC 2832            NSI Registry Registrar Protocol             May 2000


   Examples

   A registrar registers a new name server in an existing domain name:

   C:add<crlf>
   C:EntityName:NameServer<crlf>
   C:NameServer:ns1.example.com<crlf>
   C:IPAddress:198.41.1.11<crlf>
   C:.<crlf>
   S:200 Command completed successfully<crlf>
   S:.<crlf>

4.3.2 CHECK

   This command allows a registrar to determine if a domain name or name
   server has been registered in the System.

4.3.2.1 Domain Name Check

   The request to determine if a domain name is registered MUST contain
   the following data:

   - The "EntityName" parameter set to value "Domain".
     - Fully qualified second level domain name in the "DomainName"
     parameter.

   The System MUST provide a positive or negative response to document
   domain name availability at the moment the command is executed.

   Authorized User: All registrars MAY use the CHECK command to
   determine if a domain name has been registered or not.

   Examples

   A registrar checks the availability of a domain name in the System:

   C:check<crlf>
   C:EntityName:Domain<crlf>
   C:DomainName:example.com<crlf>
   C:.<crlf>
   S:211 Domain name not available<crlf>
   S:.<crlf>









Hollenbeck & Srivastava      Informational                     [Page 11]

RFC 2832            NSI Registry Registrar Protocol             May 2000


4.3.2.2 Name Server Check

   The request to determine if a name server is registered MUST contain
   the following data:

   - The "EntityName" parameter set to value "NameServer".
   - Fully qualified server name in the "NameServer" parameter.

   The System MUST provide a positive or negative response to document
   name server availability at the moment the command is executed. If
   the name server has been registered, the System MUST return the IP
   address(es) of the name server.

   Authorized User: All registrars MAY use the CHECK command to
   determine if a name server has been registered or not.

   Examples

   A registrar checks the availability of a server name in the System:

   C:check<crlf>
   C:EntityName:Nameserver<crlf>
   C:Nameserver:ns1.example.com<crlf>
   C:.<crlf>
   S:213 Name server not available<crlf>
   S:ipAddress:192.10.10.10<crlf>
   S:.<crlf>

4.3.3 DEL

   This command allows a registrar to delete (cancel the registration)
   of a domain name or delete a name server.

4.3.3.1 Deleting a Domain Name

   The request to cancel the registration of a domain name MUST contain
   the following data:

   - The "EntityName" parameter set to value "Domain".
   - Fully qualified second level domain name in the "DomainName"
     parameter.

   A request to delete a domain name SHOULD cause the deletion of all
   name servers that are children of the domain name being deleted. The
   name servers SHOULD be deleted if they are not actively hosting other
   domains. A domain MUST not be deleted if it has child name servers
   hosting other domains.




Hollenbeck & Srivastava      Informational                     [Page 12]

RFC 2832            NSI Registry Registrar Protocol             May 2000


   Authorized User: The current registrar of a domain name MAY use the
   DEL command to delete a domain name from the System.

   Examples

   A registrar deletes a domain name, implicitly deleting all name
   servers registered in the domain:

   C:del<crlf>
   C:EntityName:Domain<crlf>
   C:DomainName:example.com<crlf>
   C:.<crlf>
   S:200 Command completed successfully<crlf>
   S:.<crlf>

4.3.3.2 Deleting a Name Server

   The request to delete a name server MUST contain the following data:

   - The "EntityName" parameter set to value "NameServer".
   - Fully qualified name of the name server in the "NameServer"
     parameter.

   A name server MUST not be deleted if it is hosting domains. Deleting
   such domains or name servers is prohibited because their deletion
   WILL result in orphaning the hosted domains.

   Authorized User: The current registrar of a name server MAY use the
   DEL command to delete a name server from the System.

   Examples

   A registrar deletes a name server that is not hosting domains:

   C:del<crlf>
   C:EntityName:NameServer<crlf>
   C:NameServer:ns1.registrarA.com<crlf>
   C:.<crlf>
   S:200 Command completed successfully<crlf>
   S:.<crlf>











Hollenbeck & Srivastava      Informational                     [Page 13]

RFC 2832            NSI Registry Registrar Protocol             May 2000