| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| module:newslink [2010/02/26 14:22] – Links to util:scfg changed to util:scfg:index digitalman | module:newslink [2018/07/24 16:26] – [Command-line Options] Fix the option list by using a table digital man |
|---|
| ====== NewsLink ====== | ====== NewsLink ====== |
| | {{:module:rob_s_iphone_sept-2015_185_2_.jpg?500|A newsstand sign I saw in an airport, long after I named this module}} |
| ====== Background ====== | ====== Background ====== |
| |
| |
| NewsLink is written in 100% JavaScript and the source code (if you're | NewsLink is written in 100% JavaScript and the source code (if you're |
| interested) is contained in the files newslink.js and newsutil.js in the | interested) is contained in the file ''newslink.js'' in the |
| Synchronet EXEC directory. | Synchronet ''[[dir:exec]]'' directory. Current version is always available via [[dev:CVS]]. |
| |
| |
| |
| |
| 1. Go into SCFG->External Programs->Timed Events and created a timed event | 1. Go into [[:util:SCFG]]->External Programs->Timed Events and created a timed event |
| for NewsLink (if one doesn't already exist). Example: | for NewsLink (if one doesn't already exist). Example: |
| |
| 13: Duplicate Checking Enabled (10000 message CRCs) | 13: Duplicate Checking Enabled (10000 message CRCs) |
| |
| 4. For each NewsLinked sub-board, set Network Options->Internet (UUCP/NNTP) | 4. For each NewsLinked sub-board, set Network Options->Internet (UUCP/NNTP) to "Yes". |
| to "Yes". | |
| |
| 5. Edit your ''[[dir:ctrl]]/[[config:newslink.cfg]]'' file: | 5. Edit your ''[[dir:ctrl]]/[[config:newslink.cfg]]'' file: |
| |
| * Change the "SERVER" line to specify the host name or IP address of the News Server you are linking with. If the News Server is listening on a non-standard TCP port (e.g. other than 119), you will need to add a "PORT" line specifying the TCP port number of the server. | * Change the "SERVER" line to specify the host name or IP address of the News Server you are linking with. If the News Server is listening on a non-standard TCP port (e.g. other than 119), you will need to add a "PORT" line specifying the TCP port number of the server. |
| | * If you wish to use TLS/SSL, uncomment the "TLS" line. This will change the default port to 563. |
| * If the News Server requires an authenticated user login, change the "USER" and "PASS" lines to specify the username and password you use to login to the above News Server. If the "USER" line is missing or commented-out (with a semicolon), then no user authentication will be attempted (sometimes called "anonymous login"). | * If the News Server requires an authenticated user login, change the "USER" and "PASS" lines to specify the username and password you use to login to the above News Server. If the "USER" line is missing or commented-out (with a semicolon), then no user authentication will be attempted (sometimes called "anonymous login"). |
| * For each sub-board you configured in step 3, add an "AREA" line, specifying each sub-board's "Internal Code" (from SCFG->Message Areas). | * For each sub-board you configured in step 3, add an "AREA" line, specifying each sub-board's "Internal Code" (from SCFG->Message Areas). |
| Other supported NewsLink command-line options: | Other supported NewsLink command-line options: |
| |
| -d enable debug output | ^ Option ^ Description ^ |
| -ri reset import pointers (import all) | | ''-d'' | enable debug output | |
| -ui update import pointers (import none) | | ''-ri'' | reset import pointers (import all) | |
| -re reset export pointers (export all) | | ''-ui'' | update import pointers (import none) | |
| -ue update export pointers (export none) | | ''-re'' | reset export pointers (export all) | |
| -ne no e-mail addresses | | ''-ue'' | update export pointers (export none) | |
| -nm no mangling of e-mail addresses (disable anti-SPAM measures) | | ''-ne'' | no e-mail addresses | |
| -um un-mangle e-mail addresses when importing | | ''-nm'' | no mangling of e-mail addresses (disable anti-SPAM measures) | |
| -ix [n] import a fixed number (n) of articles/messages (default is 500) | | ''-um'' | un-mangle e-mail addresses when importing | |
| | | ''-ix //[n]//'' | import a fixed number (n) of articles/messages (default is 500) | |
| |
| |
| ====== Stopping NewsLink ====== | ====== Stopping NewsLink ====== |
| |
| NewsLink can be stopped by "touching" (creating or updating) the file: ''[[dir:data]]/newslink.stop'' | NewsLink can be stopped by "touching" (creating or updating) the semaphore file: ''[[dir:data]]/newslink.stop'' |
| |
| |
| ====== JSexec ====== | ====== JSexec ====== |
| With Synchronet v3.11, it is also possible to run NewsLink externally from | With Synchronet v3.11, it is also possible to run NewsLink externally from |
| Synchronet (or as a background timed event) by using [[util:scfg:index]]. | Synchronet (or as a background timed event) by using [[util:JSexec]]. |
| |
| |
| ===== See Also ===== | ===== See Also ===== |
| * [[config:newslink.cfg]] | * [[config:newslink.cfg]] |
| * [[util:scfg:index]] | * [[util:JSexec]] |
| * [[:service:nntp|NNTP Service]] | * [[:service:nntp|NNTP Service]] |
| * [[network:USENET]] | * [[network:USENET]] |
