usefor-usefor-03 April 2005

[< Prev] [TOC] [ Next >]
3.2.13  Injection-Info

   The Injection-Info header provides information as to how an article
   entered the Netnews system and to assist in tracing its true origin.
   It can also specify one or more addresses where complaints concerning
   the poster of the article may be sent.
   injection-info  =  "Injection-Info:" SP [CFWS] path-identity [CFWS]
            *( ";" inj-info-para ) CRLF

   inj-info-param  =  post-host-param /
            post-account-param /
            sender-param /
            logging-param /
            complainto-param

   [[Each parameter is allowed only once?]]

   [[Should also allow for x-attributes?]]

   post-host-param =  "posting-host" "=" host-value

   host-value      =  dot-atom / [ dot-atom ":" ]
            ( IPv4address / IPv6address ) ;  see [RFC 2373]

   post-acct-param =  "posting-account" "=" value

   sender-param    =  "sender" "=" sender-value

   sender-value    =  mailbox / "verified"

   logging-param   =  "logging-data" "=" value

   complainto-param=  "complaints-to" "=" address-list


   Although comments and folding of white space are permitted throughout
   the Injection-Info header, it is RECOMMENDED that folding is not used
   within any parameter (but only before or after the ";" separating
   those parameters), and that comments are only used following the last
   parameter.

   This header is intended to replace various currently-used but
   undocumented headers such as "NNTP-Posting-Host", "X-Trace" and
   "X-Complaints-To".  These headers are thus deprecated.

   The "posting-host" parameter specifies the FQDN and/or IP address
   (IPv4address or IPv6address) of the host from which the injecting
   agent received the article.

      NOTE: If the "posting-host" parameter identifies a dial-up point-
      of-presence, the "posting-account" or the "logging-data" parameter
      may provide additional information about true origin of the
      article.
   The "posting-account" parameter identifies the source from which the
   injecting agent received the article.  For security reasons, it
   SHOULD be in a cryptic notation understandable only by the
   administrator of the injecting agent.

   The "sender" parameter identifies the mailbox of the verified sender
   of the article (alternatively, it uses the token "verified" to
   indicate that at least any addr-spec in the Sender header of the
   article, or in the From header if the Sender header is absent, is
   correct).  If an injecting agent can verify sender of an article, it
   SHOULD use this parameter in favour of the "posting-account"
   parameter.

   The "logging-data" parameter contains information (typically a
   session number or other non-persistent means of identifying a posting
   account) which will enable the true origin of the article to be
   determined by reference to logging information kept by the injecting
   agent.

   The "complaints-to" parameter specifies mailbox(es) for sending
   complaints concerning the behaviour of the poster of the article.
[< Prev] [TOC] [ Next >]
#Diff to first older
NewerOlder
usefor-usefor May 2005
usefor-usefor November 2004
usefor-usefor September 2004
News Article Format and Transmission May 2004

--- ../usefor-usefor-02/Injection-Info.out          November 2004
+++ ../usefor-usefor-03/Injection-Info.out          April 2005
@@ -2,36 +2,74 @@
 
    The Injection-Info header provides information as to how an article
    entered the Netnews system and to assist in tracing its true origin.
-
+   It can also specify one or more addresses where complaints concerning
+   the poster of the article may be sent.
    injection-info  =  "Injection-Info:" SP [CFWS] path-identity [CFWS]
             *( ";" inj-info-para ) CRLF
 
    inj-info-param  =  post-host-param /
             post-account-param /
             sender-param /
-            logging-param
+            logging-param /
+            complainto-param
+
+   [[Each parameter is allowed only once?]]
 
-   post-host-param =  "posting-host=" host-value
+   [[Should also allow for x-attributes?]]
+
+   post-host-param =  "posting-host" "=" host-value
 
    host-value      =  dot-atom / [ dot-atom ":" ]
             ( IPv4address / IPv6address ) ;  see [RFC 2373]
 
-   post-acct-param =  "posting-account=" value
+   post-acct-param =  "posting-account" "=" value
 
-   sender-param    =  "sender=" sender-value
+   sender-param    =  "sender" "=" sender-value
 
    sender-value    =  mailbox / "verified"
 
-   logging-param   =  "logging-data=" value
+   logging-param   =  "logging-data" "=" value
+
+   complainto-param=  "complaints-to" "=" address-list
+
+
    Although comments and folding of white space are permitted throughout
    the Injection-Info header, it is RECOMMENDED that folding is not used
    within any parameter (but only before or after the ";" separating
    those parameters), and that comments are only used following the last
-   parameter.  It is also RECOMMENDED that such parameters as are
-   present are included in the order in which they have been defined in
-   the syntax above.
+   parameter.
 
    This header is intended to replace various currently-used but
-   undocumented headers such as "NNTP-Posting-Host" and "X-Trace".
-   These headers are now deprecated.
+   undocumented headers such as "NNTP-Posting-Host", "X-Trace" and
+   "X-Complaints-To".  These headers are thus deprecated.
+
+   The "posting-host" parameter specifies the FQDN and/or IP address
+   (IPv4address or IPv6address) of the host from which the injecting
+   agent received the article.
+
+      NOTE: If the "posting-host" parameter identifies a dial-up point-
+      of-presence, the "posting-account" or the "logging-data" parameter
+      may provide additional information about true origin of the
+      article.
+   The "posting-account" parameter identifies the source from which the
+   injecting agent received the article.  For security reasons, it
+   SHOULD be in a cryptic notation understandable only by the
+   administrator of the injecting agent.
+
+   The "sender" parameter identifies the mailbox of the verified sender
+   of the article (alternatively, it uses the token "verified" to
+   indicate that at least any addr-spec in the Sender header of the
+   article, or in the From header if the Sender header is absent, is
+   correct).  If an injecting agent can verify sender of an article, it
+   SHOULD use this parameter in favour of the "posting-account"
+   parameter.
+
+   The "logging-data" parameter contains information (typically a
+   session number or other non-persistent means of identifying a posting
+   account) which will enable the true origin of the article to be
+   determined by reference to logging information kept by the injecting
+   agent.
+
+   The "complaints-to" parameter specifies mailbox(es) for sending
+   complaints concerning the behaviour of the poster of the article.
 

Documents were processed to this format by Forrest J. Cavalier III