distributions(5) [debian man page]
DISTRIBUTIONS(5) InterNetNews Documentation DISTRIBUTIONS(5) NAME
distributions - Recommended values for the Distribution: header DESCRIPTION
The file pathetc/distributions contains a list of relevant distributions and their descriptions. It provides local information for posters who wish to add a Distribution: header to their articles so as to restrict their propagation, although it does not guarantee that such articles will not leak elsewhere because of a misconfiguration of a news server to which they are fed. See newsfeeds(5) for more information about how a news server handles the Distribution: header. Each line of this file consists of a distribution area followed by its description (encoded in UTF-8) after at least a whitespace. For instance: fr Local to France. local Local to this news server. nj Local to New Jersey. usa Local to the United States of America. Blank lines and lines beginning with a number sign ("#") are ignored. Any client that issues the LIST DISTRIBUTIONS command obtain these recommended values, if available. However, be aware that use of the LIST DISTRIBUTIONS command is not widespread (though documented in RFC 6048) and most news clients will never ask for this file. If this file is empty, it is not an error. The server will just send the client an empty response. And if the file is missing, the server will also send the client an appropriate response to indicate that the distributions list is not maintained on the server. The Distribution: header can also be automatically set by nnrpd if distrib.pats(5) is correctly configured. HISTORY
Written by Julien Elie for InterNetNews. $Id: distributions.pod 9138 2010-10-29 18:09:50Z iulius $ SEE ALSO
distrib.pats(5), newsfeeds(5), nnrpd(8). INN 2.5.3 2011-06-10 DISTRIBUTIONS(5)
Check Out this Related Man Page
DISTRIB.PATS(5) InterNetNews Documentation DISTRIB.PATS(5) NAME
distrib.pats - Default values for the Distribution: header DESCRIPTION
The file pathetc/distrib.pats is used by nnrpd to determine the default value of the Distribution: header. Blank lines and lines beginning with a number sign ("#") are ignored. All other lines consist of three fields separated by a colon: <weight>:<pattern>:<value> The first field is the weight to assign to this match. If a newsgroup matches multiple lines, the line with the highest weight is used. This should be an arbitrary integer greater than zero. The order of lines in the file is only important if groups have equal weight (in which case, the first matching line will be used). The second field is either the name of a newsgroup or a uwildmat(3)-style pattern to specify a set of newsgroups. The third field is the value that should be used for the Distribution: header of a posted article, if this line was picked as the best match and no Distribution: header was supplied by the user. It can be an empty string, specifying that no Distribution: header should be added. If it is not empty, it is better to only use US-ASCII characters for that field; otherwise, make sure it is encoded in UTF-8. When a post is received by nnrpd that does not already contain a Distribution: header, each newsgroup to which an article is posted will be checked against this file in turn, and the matching line with the highest weight will be used as the value of the Distribution: header. If no lines match, or if the matching line has an empty string for its third field, no header will be added. In case a distribution is added by nnrpd, make sure it is not rejected by the newsfeeds "ME" entry. A list of recommended distributions can be specified and described in distributions(5). HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. Converted to POD by Russ Allbery <rra@stanford.edu>. $Id: distrib.pats.pod 8803 2009-11-15 09:29:41Z iulius $ SEE ALSO
distributions(5), inn.conf(5), newsfeeds(5), nnrpd(8), uwildmat(3). INN 2.5.2 2009-11-15 DISTRIB.PATS(5)