rfc1714.txt

中、英文RFC文档大全打包下载完全版 .

   <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
   directive must be returned.

   A %directive response with no arguments must be sent between
   directives.

   Format for use:

   %directive<SP>directive:<directive>
   %directive<SP>description:<description>
   %directive<SP>syntax:<format>
   %directive

   The arguments below are required except when separating directives.

   <directive>{%s}     This required argument indicates the name of
                       the directive.

   <description>{%s}   This required argument describes the
                       directive.

   <format>{%s}        This required argument defines the format of
                       the directive.

   Example of use:

   %directive directive:schema
   %directive description:displays schema attributes
   %directive syntax:schema<SP>[%s]
   %directive
   %directive directive:xfer
   %directive description:transfer all object[authority area]
   %directive syntax:xfer<SP>[%s]<SP>[%s]






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


3.4.10 info

   The %info response is used to give the user of the client a message.
   This response is not initiated by any directive.  The information
   between the %info on and the %info off should be presented to the
   user of the client.  An ideal use of this response is to present a
   Message of The Day (MOTD) to the user.

   Format for use:

   %info<SP><mode>

   <mode>{on|off}

     on:  Turns the passthru mode on.
     off: Turns the passthru mode off.

   Example of use:

   %info on
   As of 3/24/1994 at 9:00 EST this server will no longer be in
   service. If you have this server in your configuration file we
   recommend that you change it to rs.internic.net:4343. You will
   automatically be redire