"Fossies" - the Fresh Open Source Software Archive

Member "leafnode-1.12.0/config.example" (28 Dec 2021, 11930 Bytes) of package /linux/misc/leafnode-1.12.0.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "config.example": 1.11.12_vs_1.12.0.

    1 ## Articles that haven't been read for <expire> days get expired and
    2 ## removed by texpire(8), unless you define special expire times.
    3 ## Note that texpire arguments can change this to relate to the date of
    4 ## arrival. See the texpire manual page.
    5 ## Mandatory.
    6 expire = 20
    7 
    8 ## This is the NNTP server leafnode fetches its news from.
    9 ## You need read and post access to it. Mandatory.
   10 server = news.example.org
   11 
   12 ##
   13 ## All the following parameters are optional
   14 ##
   15 
   16 ## Important and recommended setting:
   17 ## Fetch only a few articles when we subscribe a new newsgroup. The
   18 ## default is to fetch all articles.
   19 ## As leafnode forgets the article numbers of its upstream server when
   20 ## a group is marked as uninteresting, and later marked interesting
   21 ## again, you may end up downloading ALL articles from the upstream
   22 ## in that group. So uncomment and adjust this line:
   23 # initialfetch = 100
   24 
   25 ## Debugging setting:
   26 ##
   27 ## This MUST be accompanied by syslog.conf changes!
   28 ## ------------------------------------------------
   29 ## Make sure you've also read the TROUBLESHOOTING section in README.
   30 ##
   31 ## The higher, the more output will be logged - note the debugging
   32 ## output is copious in any case, so leave this at 0 for normal use,
   33 ## and set to 1, 2 or 3 only for debugging.
   34 # debugmode = 3
   35 
   36 ## I have free access to my news server. If you don't have, comment out
   37 ## the following two lines and change them accordingly.
   38 # username = gulbrandsen
   39 # password = secret
   40 
   41 ## By default, leafnode only serves connections from addresses in the
   42 ## local networks and drops those from outside. An IPv4 address, or an
   43 ## IPv6 address on computers that provide the getifaddrs() interface is
   44 ## considered local if it is within the networks (IP/netmask) of the local
   45 ## interfaces. On computers that lack the getifaddrs() interface, an
   46 ## IPv6 address is considered local if it is site-local, link-local or
   47 ## the loopback address (::1).
   48 ##
   49 ## You can enable remote access by doing:
   50 ## 1. enabling access for single static IPs (or subnetworks) through
   51 ##    your super server (inetd, xinetd) or, if the service is wrapped by
   52 ##    tcpd, hosts.allow/hosts.deny configuration,
   53 ## 2. disabling access for all other hosts (default to deny),
   54 ## 3. testing that "deny" works, to avoid abuse of your server,
   55 ## 4. uncommenting this option, capitalizing the "strangers" subword and
   56 ##    setting the value to 42.
   57 ##
   58 ## WARNING: ENABLING THIS OPTION IS DANGEROUS. YOU AGREE TO BE LIABLE
   59 ## FOR ALL ABUSE OF YOUR SERVER WHEN THIS OPTION IS ENABLED.
   60 ## IF ANYTHING ABOUT ITEMS 1. TO 3. ABOVE IS UNCLEAR, DO NOT ENABLE THIS!
   61 ## IF YOU ARE NOT FAMILIAR WITH ACCESS CONTROL, OR YOUR CLIENTS ARE ON
   62 ## DYNAMIC IPS, YOU MUST NOT ENABLE THIS. (You can use other, authenticated,
   63 ## methods of access instead, for instance SSH tunnels.)
   64 ##
   65 # allowstrangers = 0
   66 
   67 ## Standard news servers run on port 119, reserved for NNTP, so that's
   68 ## the default port fetchnews wants to connect to. If your ISP's news
   69 ## server (or other "upstream") does not listen on this standard port,
   70 ## you can set the "port" option. Note that it is only relevant for
   71 ## fetchnews, for leafnode, set the port in your inetd.conf, xinetd.conf
   72 ## file, whatever is relevant for your system.
   73 ## Leafnode does not currently support SSL.
   74 ## Give "port" a numeric value, example:
   75 # port = 9119
   76 
   77 ## If you want to guarantee that the stdout/stderr are line buffered
   78 ## (GNU libc sets them to full buffering if they are redirected to
   79 ## files), then set this:
   80 # linebuffer = 1
   81 
   82 ## This is another news server which stores some groups that are not
   83 ## available on the first one. You can define username, password and port
   84 ## for each server separately.
   85 # server = specific.newsgroups.example.com
   86 # username = xenu
   87 # password = secret
   88 
   89 ## This is a news server which does not understand the
   90 ## "LIST NEWSGROUP news.group" command. For this reason, we don't try to
   91 ## download newsgroups descriptions when getting new newsgroups. This is
   92 ## achieved by putting "nodesc = 1" somewhere behind the server
   93 ## line.
   94 # server = broken.upstream.example.org
   95 # nodesc = 1
   96 
   97 ## Here we have another news server which has a very slow connection. For
   98 ## that reason, we wait a full minute before we give up trying to connect.
   99 ## The default is 10 seconds.
  100 # server = really.slow.example.org
  101 # timeout = 60
  102 
  103 ## Disable the updating of the active file unless specifically requested
  104 ## in order to minimise network usage as much as possible.  The active
  105 ## file can be updated manually with the "-f" option to fetchnews.
  106 # server = even.slower.example.com
  107 # noactive = 1
  108 
  109 ## And this is a news server you only want to pull news from, but never
  110 ## post to. You can also use this as a workaround if you do not have posting
  111 ## permission on the server while it still greets you with a 200 code.
  112 ## The default is: nopost = 0
  113 # server = lurk-only.example.com
  114 # nopost = 1
  115 
  116 ## And this is a news server you only want to post to, but never
  117 ## fetch messages from. If set, noactive = 1 is also assumed.
  118 ## The default is: noread = 0
  119 # server = post-only.example.com
  120 # noread = 1
  121 
  122 ## And this is a news server with broken XOVER. Forbid XOVER,
  123 ## leafnode will use XHDR. XHDR may be slower or faster than XOVER,
  124 ## depending how many of the maxlines/minlines, maxbytes, maxage
  125 ## and similar options.
  126 ## The default is: noxover = 0
  127 # server = post-only.example.com
  128 # noxover = 1
  129 
  130 ## The post_anygroup parameter affects posting and makes leafnode skip
  131 ## the check if the newsgroup is carried by the respective server.
  132 ## Use this on servers that allow only posting, but no "GROUP" commands.
  133 ## Note: do not enable unless you know you may post to that server, your
  134 ## postings might end up in the failed.postings directory otherwise.
  135 # server = post-only.example.com
  136 # post_anygroup = 1
  137 
  138 ## This shows how a server is configured that only has specific news
  139 ## groups. Note that this parameter is a Perl-compatible regular expression, 
  140 ## not a wildmat!  See pcre2pattern(3).
  141 ## IMPORTANT: you must run fetchnews -f to make changes to this
  142 ## option effective.
  143 # server = cnews.corel.com
  144 # only_groups_pcre = corel\.
  145 
  146 ## Another option related to and depending on this only_groups_pcre option
  147 ## is relevant for posting; if set, ALL groups in a Newsgroups: header
  148 ## of a cross-posting will must match before the article is posted to
  149 ## the server. If unset, ANY group that matches allows the post.
  150 # only_groups_match_all = 1
  151 
  152 ## Non-standard expire times (glob(7) wildcard constructs possible)
  153 #
  154 # groups too big to hold articles 20 days:
  155 # groupexpire comp.os.linux.* = 5
  156 #
  157 # very interesting, hold articles longer:
  158 # groupexpire any.local.newsgroup = 100
  159 #
  160 # archive this group (fetchnews uses the global expire to figure the
  161 # maxage, but texpire will skip it):
  162 # groupexpire my.archived.group = -1
  163 
  164 ## Never fetch more than this many articles from one group in one run.
  165 ## Be careful with this; setting it much below 1000 is probably a bad
  166 ## idea.
  167 # maxfetch = 2000
  168 
  169 ## If you want to use leafnode like an offline newsreader (e.g. Forte
  170 ## Agent) you can download headers and bodies separately if you set
  171 ## delaybody to 1. In this case, fetch will only download the headers
  172 ## and only when you select an article, it will download the body.
  173 ## This can save a huge amount of bandwith if only few articles are really
  174 ## read from groups with lots of postings.
  175 ## This feature works not very well with Netscape, though (which is not
  176 ## a fault of Leafnode).
  177 # delaybody = 0
  178 
  179 ## If you have configured delaybody mode and your newsreader doesn't
  180 ## cope with articles changing their numbers but not their Message-ID
  181 ## such as Knode, then try setting this switch to 1, which
  182 ## will make fetchnews keep the article number.
  183 ## You'll have to switch the article body cache off though in your
  184 ## newsreader.
  185 # delaybody_in_situ = 0
  186 
  187 ## To avoid spam, you can select the maximum number of crosspostings
  188 ## that are allowed in incoming postings. Setting this below 5 is
  189 ## probably a bad idea. The default is unlimited crossposting.
  190 # maxcrosspost = 5
  191 
  192 ## If you suffer from repeatedly receiving old postings (this happens
  193 ## sometimes when an upstream server goes into hiccup mode) you can
  194 ## refuse to receive them with the parameter "maxage" which tells the
  195 ## maximum allowed age of an article in days. A value of 0 indicates that
  196 ## no checking should be performed. The default maxage is 10 days.
  197 ## WARNING: maxage can be overridden by expire! See the clamp_maxage
  198 ## parameter below.
  199 # maxage = 10
  200 
  201 ## By default, maxage is limited to groupexpire (if applicable) or
  202 ## expire (otherwise). On some rare occasions, this limit may be
  203 ## undesirable. To avoid this maxage manipulation, uncomment this line:
  204 # clamp_maxage = 0
  205 
  206 ## maxlines will make fetch reject postings that are longer than a certain
  207 ## amount of lines.
  208 # maxlines = 100
  209 
  210 ## minlines will make fetch reject postings that are shorter than a certain
  211 ## amount of lines.
  212 # minlines = 2
  213 
  214 ## maxbytes will make fetch reject postings that are larger
  215 # maxbytes = 50000
  216 
  217 ## timeout_short determines how many days fetch gets a newsgroup which
  218 ## has been accidentally opened. The default is two days.
  219 # timeout_short = 1
  220 
  221 ## timeout_long determines how many days fetch will wait before not getting
  222 ## an unread newsgroup any more. The default is seven days.
  223 # timeout_long = 6
  224 
  225 ## timeout_active determines how many days fetch will wait before re-reading
  226 ## the whole active file. The default is 90 days.
  227 # timeout_active = 365
  228 
  229 ## timeout_client determines how many seconds of inactivity to allow before
  230 ## a client is forcibly disconnected. The default is 15 mins (900s). Optional.
  231 # timeout_client = 900
  232 
  233 ## timeout_fetchnews determines how many seconds fetchnews will wait for
  234 ## a server reply before assuming the server has become wedged.
  235 ## The default is 5 mins (300s). Optional.
  236 # timeout_fetchnews = 300
  237 
  238 ## timeout_lock determines how long the leafnode programs retry to
  239 ## obtain the lock file. The default is 5 seconds.
  240 ## Note you can use the LN_LOCK_TIMEOUT environment variable to override
  241 ## this.
  242 # timeout_lock = 900
  243 
  244 ## If you want to have your newsreader score/kill on Xref: lines, you might
  245 ## want to uncomment this.
  246 # create_all_links = 1
  247 
  248 ## If you want to filter out certain regular expressions in the header,
  249 ## create a "filterfile" (how this is done is explained in the README)
  250 ## and set
  251 # filterfile = /etc/leafnode/filters
  252 
  253 ## Note that filtering usually means HEAD and BODY are downloaded
  254 ## separately, so fetchnews has to wait for the packets TWICE to travel
  255 ## to the server and back. If you have a fast link with high latencies
  256 ## (for example a DSL line with interleaving or a satellite link), it
  257 ## may be faster to request header and body in a single command and
  258 ## discard the body. Note that the filter applies to the header only in
  259 ## either case because PCRE matching is expensive.
  260 ##
  261 ## If you have one of the high-latency high-throughput links and have
  262 ## enough free traffic left or a flat rate (no per-MByte billing), uncomment
  263 ## this:
  264 # article_despite_filter = 1
  265 
  266 ## If your newsreader does not supply a Message-ID for your postings
  267 ## Leafnode will supply one, using the hostname of the machine it is
  268 ## running on.  If this hostname is not suitable, this parameter can be
  269 ## used to override it.  Do not use a fantasy name, it may interfere with
  270 ## the propagation of your messages.  Most modern newsreaders do provide
  271 ## a Message-ID.
  272 # hostname = myhost.example.org
  273 
  274 ## You can also override the From: header address shown in placeholder
  275 ## articles. It should be the news administrator's mail address.
  276 # newsadmin = postmaster@another.example.org
  277 
  278 ## If in your local Usenet hierarchy, posting unencoded 8-bit data in
  279 ## headers is condoned, uncomment this option to allow this. 8-bit data
  280 ## in headers is officially illegal, although the header character set
  281 ## may change to UTF-8 soon.
  282 # allow_8bit_headers = 1