rfc2832.txt

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

   implementation specific error that occurs when a potentially billable
   operation, such as adding a domain name, renewing a domain name, or
   transferring a domain name, is attempted and the registrar does not
   have sufficient financial standing with the registry to complete the
   operation.

   547 Invalid command sequence
   RRP commands are issued using a well-formed syntax that requires
   entry of command structures in particular sequences. This response
   code indicates that an ill-formed command was received and rejected.

   548 Domain is not up for renewal
   A RENEW command was attempted during a period in which the domain can
   not be renewed. Implementations MAY limit renewal periods to
   particular time frames, such as within 90 days of the domain's
   expiration. This response indicates that the RENEW command was
   received outside of the System-defined domain renewal period.

   549 Command failed
   A System error prevented successful completion of the requested RRP
   command.  Retrying the command might produce success, but a repeated
   failure indicates a System error condition.

   550 Parent domain not registered
   The parent domain of a name server being registered is not
   registered. This occurs when the registrar tries to add a new name
   server and the parent domain for the server does not exist in the
   registry.

   551 Parent domain status does not allow for operation
   The status of the parent domain does not allow the requested
   operation. This occurs when a registrar tries to modify a server
   whose parent domain is flagged as LOCK or HOLD in the registry.

   552 Domain status does not allow for operation
   The status of the domain does not allow the requested operation. This
   occurs when a registrar tries to modify or delete a domain that is
   flagged as LOCK or HOLD in the registry.

   553 Operation not allowed. Domain pending transfer
   The status of the domain does not allow the requested operation. The
   registrar is attempting to delete a domain that is pending approval
   or denial of a transfer request.






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


   554 Domain already registered
   A registrar tried to register a domain name that has already been
   registered by the same registrar.

   555 Domain already renewed
   A registrar tried to renew a domain using the same parameters as
   specified for an earlier, successful renewal. This will commonly
   occur when executing the same RENEW command more than once.

   556 Maximum registration period exceeded
   A registrar tried to renew a domain registration, and the resulting
   new registration period exceeds the System-defined maximum
   registration period. If there is renewal time available with the
   System-defined maximum registration period it may be possible to
   retry the RENEW command with specified renewal period parameters.

5.2 Command-Response Correspondence

   The session between the client and the server is intended to be an
   alternating dialogue. Each command issued by a client MUST be acted
   upon by the server, which MUST return a response code to document the
   success or failure of command execution. "Success" means that the
   command completed normal execution without error.  "Failure" means
   that the System did not complete the command as requested. Failure
   may be due to either syntax, semantic, data, or System errors.

   A complete list of response codes for each RRP command is listed
   below.

   Command: ADD
   Success: 200, 220
   Failure: 420, 421, 500, 502, 503, 504, 505, 507, 508, 520, 531, 535,
   540, 541, 545, 546, 547, 549, 550, 554

   Command: CHECK
   Success: 210, 211, 212, 213
   Failure: 220, 420, 421, 500, 502, 503, 504, 505, 507, 508, 520, 541,
   547, 549

   Command: DEL
   Success: 200, 220
   Failure: 420, 421, 500, 502, 503, 504, 505, 507, 508, 520, 531, 532,
   533, 541, 544, 545, 547, 549, 551, 552, 553

   Command: DESCRIBE
   Success: 200, 220
   Failure: 420, 421, 500, 501, 506, 507, 509, 520, 547, 549




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


   Command: MOD
   Success: 200, 220
   Failure: 420, 421, 500, 502, 503, 504, 505, 507, 508, 520, 531, 535,
   540, 541, 542, 543, 544, 545, 547, 549, 550, 551, 552, 553

   Command: QUIT
   Success: 220
   Failure: 420, 421, 500, 507, 520, 547, 549

   Command: RENEW
   Success: 200, 220
   Failure: 420, 421, 500, 502, 503, 504, 505, 507, 508, 520, 531, 541,
   545, 546, 547, 548, 549, 552, 553, 555, 556

   Command: SESSION
   Success: 200, 220
   Failure: 420, 421, 500, 501, 506, 507, 508, 509, 520, 521, 530, 531,
   547, 549

   Command: STATUS
   Success: 200, 220
   Failure: 420, 421, 500, 501, 502, 503, 504, 505, 506, 507, 508, 520,
   531, 541, 545, 547, 549

   Command: TRANSFER
   Success: 200, 220
   Failure: 420, 421, 500, 501, 502, 503, 504, 505, 506, 507, 508, 520,
   531, 534, 536, 541, 544, 545, 546, 547, 549, 552, 553

6. Domain Status Codes

   The status of a domain can be viewed using the RRP STATUS command and
   modified using the RRP MOD command. Both the registry and the
   sponsoring registrar MAY view and change the status of a domain. The
   criteria for status changes are highly dependent on registry and
   registrar business models and are thus beyond the scope of this
   specification.

   The domain's status SHOULD have a direct bearing on whether or not
   the domain appears in the appropriate TLD zone file and whether or
   not the domain can be modified. A domain can have more than one
   assigned status, e.g., REGISTRAR-HOLD and REGISTRAR-LOCK. If a domain
   is in ACTIVE status, then the domain name can only be in this status.
   When a registrar sets a domain name to REGISTRAR-LOCK, the registry
   MUST automatically remove the ACTIVE status. When the registrar
   removes the REGISTRAR-LOCK and other domain statuses, the registry
   MUST automatically set the domain name status to ACTIVE.




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


6.1 Domain Status Code Description

   ACTIVE: This is the default status of a domain at registration time.
   The registry sets the domain to this status. The domain is modifiable
   by the registrar. The domain can be renewed. The domain SHALL be
   included in the zone file when in this status if the domain has at
   least one associated name server.

   REGISTRY-LOCK: The registry sets the domain to this status. The
   domain cannot be modified or deleted by the registrar. The registry
   MUST remove the REGISTRY-LOCK status for the registrar to modify the
   domain. The domain can be renewed. The domain SHALL be included in
   the zone file when in this status if the domain has at least one
   associated name server.

   REGISTRY-HOLD: The registry sets the domain to this status. The
   domain cannot be modified or deleted by the registrar. The registry
   MUST remove the REGISTRY-HOLD status for the registrar to modify the
   domain. The domain can be renewed. The domain SHALL NOT be included
   in the zone file when in this status.

   REGISTRAR-HOLD: The registrar of the domain sets the domain to this
   status. The domain can not be modified or deleted when in this
   status. The registrar MUST remove REGISTRAR-HOLD status to modify the
   domain. The domain can be renewed. The domain SHALL NOT be included
   in the zone file when in this status.

   REGISTRAR-LOCK: The registrar of the domain sets the domain to this
   status. The domain cannot be modified or deleted when in this status.
   The registrar MUST remove REGISTRAR-LOCK status to modify the domain.
   The domain can be renewed. The domain SHALL be included in the zone
   file when in this status.

   REGISTRY-DELETE-NOTIFY: A domain is set on this status if it has
   expired and has child name servers that are hosting other domains.
   Only the registry may set this status. The domain SHALL be included
   in the zone file when in this status if the domain has at least one
   associated name server.

7. Formal Syntax

   The following syntax specification uses the augmented Backus-Naur
   Form (BNF) as described in [ABNF].

; ABNF specification for Registry Registrar Protocol (RRP) v1.1.0
; Note that character string literals are case insensitive.





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


; Lexical tokens
space = %x20 ; " "
dot = %x2E ; "."
dash = %x2D ; "-"
underscore = %x5F ; "_"
colon = %x3A ; ":"
cr = %x0D ; ASCII carriage return
lf = %x0A ; ASCII linefeed
crlf = cr lf
alpha = %x41-5A / %x61-7A ; A-Z / a-z
digit = %x30-39 ; 0-9
dns-char = alpha / digit / dash
id-char = alpha / digit / underscore / dash
id-prefix = alpha / digit
id-word = id-prefix *id-char
printable-char = %x20-7E ; ASCII " " - "~"

; Start of basic grammar.
year = 4digit
month = 2digit
day = 2digit
ymd = year dash month dash day
hour = 2digit
minute = 2digit
second = 2digit
split-second = 1digit
hms = hour colon minute colon second dot split-second
time-stamp = ymd space hms
ip-address = 1*3digit dot 1*3digit dot 1*3digit dot 1*3digit
password = 4*16printable-char
option-name = 1*128id-word
option-tag = dash option-name
option-value = 1*128id-word
attribute-name = 1*128id-word
attribute-value = 1*128printable-char
attribute-line = attribute-name colon attribute-value crlf
response = 3digit space 1*printable-char crlf
version-number = "RRP" space 1*digit dot 1*digit dot 1*digit
label = id-prefix [*61dns-char id-prefix]
sldn = label dot label
servername = *(label dot) sldn
period = %x31-39 / (%x31-39 %x30-39) ; "1" - "9" or "10" - "99"
period-option = dash "Period" colon period crlf
yesno = "Yes" / "No"
domainstatus = "Active" / "Registry-Lock" / "Registry-Hold" /
               "Registrar-Lock" / "Registrar-Hold" /
               "Registry-Delete-Notify"




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


; RRP commands and responses.
rrp = add / check / delete / describe / mod / quit / renew /
      session / status / transfer

add = add-request add-response
check = check-request check-response
delete = del-request del-response
describe = describe-request describe-response
mod = mod-request mod-response
quit = quit-request quit-response
renew = renew-request renew-response
session = session-request session-response
status = status-request status-response
transfer = transfer-request transfer-response

; ADD command.
add-request = add-domain-request / add-nameserver-request
add-response = add-domain-response / add-nameserver-response
add-domain-request = "add" crlf
 "EntityName" colon "Domain" crlf
 "DomainName" colon sldn crlf
 [period-option]
 0*13("NameServer" colon servername crlf)
 dot crlf
add-nameserver-request = "add" crlf
 "EntityName" colon "NameServer" crlf
 "NameServer" colon servername crlf
 1*("IPAddress" colon ip-address crlf)
 dot crlf
add-domain-response = response
 "RegistrationExpirationDate" colon time-stamp crlf
 "status" colon domainstatus crlf
 dot crlf
add-nameserver-response = response
 dot crlf

; CHECK command.
check-request = check-domain-request / check-nameserver-request
check-response = check-domain-response / check-nameserver-response
check-domain-request = "check" crlf
 "EntityName" colon "Domain" crlf
 "DomainName" colon sldn crlf
 dot crlf
check-nameserver-request = "check" crlf
 "EntityName" colon "NameServer" crlf
 "NameServer" colon servername crlf
 dot crlf
check-domain-response = response



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


 dot crlf
check-nameserver-response = available-check-nameserver-response /
                            notavailable-check-nameserver-response
available-check-nameserver-response = response
 dot crlf
notavailable-check-nameserver-response = response
 1*("IPAddress" colon ip-address crlf)
 dot crlf

; DEL command.
del-request = del-domain-request / del-nameserver-request
del-response = response
 dot crlf
del-domain-request = "del" crlf
 "EntityName" colon "Domain" crlf
 "DomainName" colon sldn crlf
 dot crlf
del-nameserver-request = "del" crlf
 "EntityName" colon "NameServer" crlf
 "NameServer" colon servername crlf
 dot crlf

; DESCRIBE command.
describe-request = "describe" crlf
 [target-option]
 *(option-tag colon option-value crlf)
 dot crlf
describe-response = response
 "Protocol" colon version-number crlf
 *attribute-line
 dot crlf
target-option = dash