rfc1714.txt

RFC 的详细文档！

      refresh
      increment



Williamson & Kosters                                           [Page 26]

RFC 1714            Referral Whois Protocol (RWhois)       November 1994


      retry
      tech-contact
      admin-contact
      hostmaster
      primary

   Format for use:

   %soa<SP>authority:<SP><authority area>
   %soa<SP>ttl:<SP><ttl>
   %soa<SP>serial:<SP><serial>
   %soa<SP>refresh:<SP><refresh>
   %soa<SP>increment:<SP><incremental>
   %soa<SP>retry:<SP><retry>
   %soa<SP>tech-contact:<SP><tech-contact>
   %soa<SP>admin-contact:<SP><admin-contact>
   %soa<SP>hostmaster:<SP><hostmaster>
   %soa<SP>primary:<SP><primary>

   <authority area>{%s}  The authority name of the SOA. (Example:
                         internic.net or 198.41.0.0/24)

   <ttl>{%d}           The time to live for data within this
                       authority area that another server may cache.
                       The server caching the data should consider
                       the data expired after storage for the number
                       of seconds identified by this attribute.

   <serial>{%Mserial}  Serial number of the data contained in the
                       authority area.  The serial number must be
                       incremented every time data in the authority
                       area has changed.  It must be numeric.

   <refresh>{%d}       The time to completely remove cached data and
                       transfer all data from the primary server.

   <increment>{%d}     The time to wait before checking for
                       incremental updates from a primary server.

   <retry>{%d}         The time to wait before retrying connection
                       to a server that appears to be out-of-service.

   <tech-contact>{%Memail}  E-mail address of the person or role
                            account responsible for the operation of
                            the server.






Williamson & Kosters                                           [Page 27]

RFC 1714            Referral Whois Protocol (RWhois)       November 1994


   <admin-contact>{%Memail} E-mail address of the person or role
                            account responsible for the data
                            contained on the server.

   <hostmaster>{%Memail}    E-mail address to which changes of the
                            server's data should be sent.  A data
                            edit tool can automatically send changes
                            to update the data on the server via e-mail.

   <primary>{%Mperm}        Primary server for authority area.

   Example of use:

   %soa authority: netsol.com
   %soa ttl: 7200
   %soa serial: 19940606203030
   %soa refresh: 7200
   %soa increment: 60
   %soa retry: 1200
   %soa tech-contact: [e-mail]
   %soa admin-contact: [e-mail]
   %soa hostmaster: [e-mail]
   %soa primary: netman1.netsol.com:4343
   %ok

3.4.4 status

   The %status response returns the status of several important flags or
   values.  The response must contain the following elements.

   Limit:         Current limit set on the server.  This value may
                  be changed using the -limit directive.  This is
                  not the maximum limit of the server.  This value
                  is not disclosed to prevent clients from
                  automatically setting the highest limit possible,
                  causing degradation in performance of the server.

   Load:          This is the current load of the host system.

   Cache:         Current status of the cache flag. (on or off)

   Holdconnect:   Current status of the holdconnect flag. (on or
                  off)

   Forward:       Current status of the forward flag. (on or off)

   Authority records:  Number of authority records in server's
                       database.



Williamson & Kosters                                           [Page 28]

RFC 1714            Referral Whois Protocol (RWhois)       November 1994


   Cached records:     Number of records in the server's cache
                       database.

   Display:            Indicates the types of display modes the
                       server is using.

   Format for use:

   %status<SP>limit:<SP><current limit>
   %status<SP>load:<SP><current load>
   %status<SP>cache:<SP><cache>
   %status<SP>holdconnect:<SP><holdconnect>
   %status<SP>forward:<SP><forward>
   %status<SP>Authority:<SP><SOA number>
   %status<SP>Cached:<SP><cached number>
   %status<SP>Display<SP><mode>:<SP><type>

   See above for the description of these values.

   <current limit>{%d}
   <current load>{%2.2f}
   <cache>{on|off}
   <holdconnect>{on|off}
   <forward>{on|off}
   <SOA number>{%d}
   <cached number>{%d}
   <mode>{single|multi}
   <type>{%s}

   Example of use:
   %status limit: 1500
   %status load: 1.23
   %status cache: off
   %status holdconnect: on
   %status forward: off
   %status Authority:25
   %status Cached:200
   %status display multi: summary

3.4.5 xfer

   The %xfer response will send all instances of an object.  This is in
   response to the -xfer directive.  The transfer may be limited by the
   arguments to the directive.  If there are no arguments, the server
   must send all of the objects in the database.  Cached data must not
   be transferred using this method unless caching is turned on.





Williamson & Kosters                                           [Page 29]

RFC 1714            Referral Whois Protocol (RWhois)       November 1994


   Each object instance is sent with a blank %xfer response between
   instances.

   Format for use:

   %xfer<SP>[<object>:<attribute>:<value>]

   These arguments are not required if the current response is an object
   instance separator.

   <object>{%s}     This required argument represents the name of
                    the object being transferred.

   <attribute>{%s}  This required argument identifies the attribute
                    being sent.

   <value>{%s}      This required argument contains the value of the
                    attribute.  If blank, the attribute value is
                    blank.

   Example of use:

   %xfer user:last-name:Kosters
   %xfer user:first-name:Mark
   %xfer user:organization-phone:[phone]
   %xfer
   %xfer user:last-name:Williamson
   %xfer user:first-name:Scott
   %xfer user:organization-phone:[phone]
   %xfer

3.4.6 schema

   The %schema response is used to describe the attributes of an object.
   This is in response to the -schema directive.

   Each attribute is sent with a blank %schema as a separator.

   Format for use:

   %schema<SP><object>:attribute:<attribute name>
   %schema<SP><object>:format:<format string>
   %schema<SP><object>:description:<descriptive string>
   %schema<SP><object>:indexed:<indexed>
   %schema<SP><object>:required:<required>
   %schema<SP><object>:multi-line:<multi-line>
   %schema<SP><object>:type:<type>
   %schema<SP><object>:primary:<primary>



Williamson & Kosters                                           [Page 30]

RFC 1714            Referral Whois Protocol (RWhois)       November 1994


   %schema

   These arguments are not required if the current response is an
   attribute separator.

   <attribute name>{%s}     This required argument identifies the
                            name of the attribute being described.

   <format string>{%s}      This required argument describes the
                            allowed format for the attribute.

   <descriptive string>{%s} This required argument describes the
                            attribute's use.

   <indexed>{on|off}        This required argument identifies
                            attributes that are indexed.

   <required>{on|off}       This required argument identifies
                            attributes that are required.

   <multi-line>{on|off}     This required argument indicates whether
                            the attribute can span multiple lines.

   <type>{text|MIME|see-also|PostScript}
                            This required argument identifies the
                            type of the attribute.

   <unique-key>{on|off}     This required argument indicates whether
                            the attribute is a unique key.

   Example of use:

   %schema user:attribute:Object-Type
   %schema user:description:Name of the object
   %schema
   %schema user:attribute:Email
   %schema user:format:[%Memail]
   %schema user:description:RFC-822 compliant Email address
   %schema
   %schema user:attribute:Organization-Phone
   %schema user:format:[%3d[0-999]-%3d[0-999]-%4d[0-9999]]
   %schema user:description:Work phone number
   %schema








Williamson & Kosters                                           [Page 31]

RFC 1714            Referral Whois Protocol (RWhois)       November 1994


3.4.7 define

   The %define response describes format macros to the client.  All
   format macros used in the schema format definition string must be
   available to the client through the -define directive.  Format macros
   may be nested.  It is the client's responsibility to request all
   format strings that are unrecognized from a server.  If the format
   strings change on a server, the serial number of the schemas that use
   the format must change.

   Format for use:

   %define<SP><macro name>:<[format string]>

   [NOTE:  The brackets around the format string are required to ensure
   that spaces contained in the format string are interpreted correctly
   by the client.]

   Example of use:

   %format server:[%s:%16Bd]
   %format email:[%s@%s]

3.4.8 object

   All visible objects on an RWhois server must be identified in
   response to a -object directive.  The %object response either
   confirms the existence of an object or returns a complete list of all
   objects available to the currently connected user.

   A blank %object line serves as an object separator.

   Format for use:

   %object
   %object<SP><object name>:description:<object description>
   %object<SP><object name>:restrict:<restriction words>

   <object name>{%s}        This required argument is the name of
                            the object.

   <object description>{%s} This required argument is a description
                            of the object identified.

   <restriction words>{%s}  This required argument is a list of
                            words used to restrict a search to this
                            object.




Williamson & Kosters                                           [Page 32]

RFC 1714            Referral Whois Protocol (RWhois)       November 1994


   Example of use:

   %object user:description:user records for entity POC
   %object user:restrict:user
   %object user:restrict:person
   %object user:restrict:mailbox

3.4.9 directive

   The %directive response is used to display directives allowed on the
   connected server.  The directive name, description and syntax
   attributes must be sent for each directive.  If information about a
   single directive is requested then only information about that