Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
module:sbbslist [2017/12/09 18:59] – [Timed Events] Document the -preview option digital manmodule:sbbslist [2023/03/06 11:00] (current) – [See Also] digital man
Line 1: Line 1:
-====== sbbslist ======+====== BBS List ======
  
-The Synchronet BBS List v4 module (''[[dir:exec]]/sbbslist.js'') provides the following functionality:+The Synchronet BBS List module (''[[dir:exec]]/sbbslist.js'') provides the following functionality:
   * Online BBS List (interactive door mode or just a read-only listing)   * Online BBS List (interactive door mode or just a read-only listing)
   * Exports locally created BBS entries to networked message base (e.g. SYNCDATA)   * Exports locally created BBS entries to networked message base (e.g. SYNCDATA)
Line 10: Line 10:
   * Auto-synchronizes statistics (e.g. totals) in the local system's entry in the database   * Auto-synchronizes statistics (e.g. totals) in the local system's entry in the database
   * Auto-verifies TCP/IP services of listed BBSes and tracks the results   * Auto-verifies TCP/IP services of listed BBSes and tracks the results
 +
 +===== Dependencies ===== 
 +
 +As of this writing, sbbslist v4 is known to be compatible with Synchronet v3.17.
 +
 +A JavaScript ''printf()'' bug in Synchronet v3.16 causes sbbslist v4 to crash in Synchronet for Linux, but appears to work fine in the Windows build.
 +
 +Files known to be required by sbbslist v4:
 +  * ''exec/sbbslist.js''
 +  * ''exec/load/sbbslist_lib.js''
 +  * ''exec/load/sbbslist_html.js''
 +  * ''exec/load/sbbsdefs.js''
 +  * ''exec/load/sockdefs.js''
 +  * ''exec/load/portdefs.js''
 +  * ''exec/load/modopts.js''
 +  * ''exec/load/graphic.js''
 +  * ''exec/load/termcapture_lib.js''
 +  * ''exec/load/synchronet-json.js''
  
 ===== History =====  ===== History ===== 
Line 33: Line 51:
   * ''[[dir:exec]]/[[dir:exec#load]]'' for loadable library files, e.g. ''sbbslist_lib.js''   * ''[[dir:exec]]/[[dir:exec#load]]'' for loadable library files, e.g. ''sbbslist_lib.js''
  
-===== Configuration ===== +===== Install  =====  
 + 
 +From command-line, run ''jsexec sbbslist install'' 
 + 
 +If all the prerequisites were met, this step will perform all the necessary configuration changes mentioned later in this document and you should be ready to go with the new Synchronet BBS List. 
 + 
 +:!: **Note**: 
 +If you previously had the ''SBL'' door in an external program section other than the //first// external program section, you may want to move the new ''SBBSLIST'' configuration to that location (in [[util:SCFG]]->External Programs->Online Programs). 
 + 
 +===== Configure ===== 
 Other than command-line parameters, the only configuration options for ''sbbslist.js'' are stored in the ''[sbbslist]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file: Other than command-line parameters, the only configuration options for ''sbbslist.js'' are stored in the ''[sbbslist]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file:
  
-<file>+<file ini>
 [sbbslist] [sbbslist]
-        sub     = syncdata+        sort = name 
 +        reverse = false 
 +        format = 0
         add_ars = not guest         add_ars = not guest
-        beep    = true +        beep = true 
-        format  = 0 +        sub = dove-syncdata 
-        sort    = name+        live_preview = true 
 +        backup_level = 5 
 +        export_freq = 7 
 +        max_inactivity = 180
 </file> </file>
  
 +^ Option       ^ Description ^
 +| sort         | The default list sort field (default: //none//) |
 +| reverse      | Reverse the default sort order (default: ''false'') |
 +| format       | The default browse list format (''0''-''9'', default: ''0'') |
 +| add_ars      | The access requirements of a user able to //add// a BBS entry (default: none) |
 +| beep         | Set to false to disable beeps sent to the remote terminal (default: ''true'') |
 +| sub          | Sub-board internal code for import and export command (default: //auto-detected//) |
 +| live_preview | Set to true to enable live previews (outbound connections) while in browse mode (default: ''false'') |
 +| backup_level | Over-ride the default number of backup files to maintain (default: ''5'') |
 +| export_freq  | Maximum export (to message-base) frequency, in days (default: ''7'') |
 +| max_inactivity | Maximum number of days of entry inactivity before auto-deletion via ''maint'' command (default: 180) |
 +==== Sorting ====
 +The configured/default sort field can also be specified on the ''sbbslist'' command-line (e.g. using the ''-sort'' option). The available sort fields are:
 +
 +^ Field           ^ Description ^
 +| name            | BBS name (with "the" prefix and "BBS" suffix removed) |
 +| sysops          | List of BBS's system operators |
 +| location        | BBS's location (e.g. city, state, country) |
 +| phone_number    | BBS's phone number (if it has one) |
 +| service_address | BBS's primary TCP service address |
 +| since           | Date the BBS was first placed online |
 +| software        | BBS software in use |
 +| web_site        | BBS's web-site address |
 +| description     | BBS's description |
 +| networks        | List of message networks to which the BBS belongs |
 +| nodes           | Total number of terminal server //nodes// |
 +| users           | Total number of BBS users |
 +| subs            | Total number of BBS message areas (sub-boards) |
 +| dirs            | Total number of BBS file directories |
 +| doors           | Total number of BBS online programs (doors) |
 +| msgs            | Total number of public messages stored on the BBS |
 +| files           | Total number of files available for download |
 +| storage         | Total disk capacity |
 +| protocols       | List of TCP protocols supported by the BBS |
 +| created_by      | Name of user that created this BBS entry |
 +| created_on      | Date that this BBS entry was created |
 +| updated_by      | Name of user that last updated/edited this BBS entry |
 +| updated_on      | Date that this BBS entry was last updated |
 +| verified_by     | Name of user or program that last verified this BBS entry |
 +| verified_on     | Date that this BBS entry was last verified |
 +| verify          | Special sort order based on auto-verification results |
 +| active          | Special sort order based on last-activity (modification or verification) date |
 +
 +The default sort order is alphabetical for string fields and reversed (descending) for numeric fields.
 +
 +==== Live Preview ====
 +This feature allows a browsing user to request a real-time capture and preview of a listed BBS's answer/login screen. This is not an interactive connection and does not allow the user to send data or control the remote BBS in any way. The TCP connection, if successful, lasts about 10 seconds.
 ===== Invocation =====  ===== Invocation ===== 
 ''sbbslist.js'' can be invoked from [[util:JSexec]] to utilize many of its functions, but for it's primary "browse" (BBS door) functionality, it must run from the Synchronet Terminal Server (e.g. as an ''External Program'', a.k.a. door). ''sbbslist.js'' can be invoked from [[util:JSexec]] to utilize many of its functions, but for it's primary "browse" (BBS door) functionality, it must run from the Synchronet Terminal Server (e.g. as an ''External Program'', a.k.a. door).
Line 125: Line 204:
 ║ │Internal Code                   SMB2SBL                           ║ ║ │Internal Code                   SMB2SBL                           ║
 ║ │Start-up Directory                                                ║ ║ │Start-up Directory                                                ║
-║ │Command Line                    ?sbbslist import=syncdata         ║+║ │Command Line                    ?sbbslist import                  ║
 ║ │Enabled                         Yes                               ║ ║ │Enabled                         Yes                               ║
 ║ │Execution Node                  1                                 ║ ║ │Execution Node                  1                                 ║
Line 140: Line 219:
 ╚════════════════════════════════════════════════════════════════════╝ ╚════════════════════════════════════════════════════════════════════╝
 </file> </file>
- 
-**Note:** 
-Take care to match the //internal code// (''syncdata'' above) with the correct code shown for the corresponding message area in [[util:SCFG]]->Message Areas. 
  
 **Note:** **Note:**
Line 156: Line 232:
 ║ │Internal Code                   SBL2SMB                           ║ ║ │Internal Code                   SBL2SMB                           ║
 ║ │Start-up Directory                                                ║ ║ │Start-up Directory                                                ║
-║ │Command Line                    ?sbbslist export=syncdata         ║+║ │Command Line                    ?sbbslist export                  ║
 ║ │Enabled                         Yes                               ║ ║ │Enabled                         Yes                               ║
 ║ │Execution Node                  1                                 ║ ║ │Execution Node                  1                                 ║
Line 171: Line 247:
 ╚════════════════════════════════════════════════════════════════════╝ ╚════════════════════════════════════════════════════════════════════╝
 </file> </file>
- 
-**Note:** 
-Take care to match the //internal code// (''syncdata'' above) with the correct code shown for the corresponding message area in [[util:SCFG]]->Message Areas. 
  
 **Note:** **Note:**
 If you have the old ''SBL2SMB'' timed event, you should remove it now. If you have the old ''SBL2SMB'' timed event, you should remove it now.
  
 +=== Maintenance ===
 +This timed event (''SBLMAINT'') is also helpful for auto-purging old/inactive BBS list entries based on the configured ''max_inactivity'' duration (default: 180 days).
 +<file>
 +╔════════════════════════════════════════════════════════════════════╗
 +║                        SBLMAINT Timed Event                        ║
 +╠════════════════════════════════════════════════════════════════════╣
 +║ │Internal Code                   SBLMAINT                          ║
 +║ │Start-up Directory                                                ║
 +║ │Command Line                    ?sbbslist maint                   ║
 +║ │Enabled                         Yes                               ║
 +║ │Execution Node                  1                                 ║
 +║ │Execution Months                Any                               ║
 +║ │Execution Days of Month         Any                               ║
 +║ │Execution Days of Week          All                               ║
 +║ │Execution Time                  00:00                             ║
 +║ │Requires Exclusive Execution    No                                ║
 +║ │Force Users Off-line For Event  No                                ║
 +║ │Native Executable               No                                ║
 +║ │Use Shell to Execute            No                                ║
 +║ │Background Execution            No                                ║
 +║ │Always Run After Init/Re-init   No                                ║
 +╚════════════════════════════════════════════════════════════════════╝
 +</file>
 +==== Command-line ====
 +
 +=== Commands ===
 +Commands are just words passed on the command-line to ''sbbslist.js''. Many commands are only there for trouble-shooting or experimental purposes.
 +
 +^ Command   ^ Description ^
 +| browse    | Perform the interactive BBS-user //door// function for listing and adding systems to the list |
 +| list       | Display all or part of the BBS list |
 +| dump       | Perform a JSON-dump of the BBS list |
 +| count      | Count the number of entries in the BBS list|
 +| upgrade    | Upgrade from the old SBL (''sbl.dab'') list format |
 +| backup     | Backup the BBS list database file (''sbslist.json'') |
 +| import     | Import BBS entries from a networked message base |
 +| export     | Export BBS entries to a networked message base |
 +| syncterm   | Export the BBS List to a SyncTERM compatible list file (''syncterm.lst'') |
 +| html       | Export the BBS List to an HTML file (''sbbslist.html'') |
 +| imsglist   | Export the BBS List to an instant-message system list file (''sbbsimsg.lst'') | 
 +| sort=field | Sort the BBS List by the specified field |
 +| randomize  | Randomize the BBS List |
 +| find=value | Find a string in the BBS List |
 +| verify     | Verify the BBS List |
 +| save       | Save the BBS List back to the database file |
 +| show       | Show, in a basic plain format, the BBS List |
 +| add        | Add the local system to the BBS List |
 +| update         | Update the local system in the BBS List |
 +| delete         | Remove the local system from the BBS List (see also ''-remote'') |
 +| remove=<name>  | Remove an entry from the BBS List (see also ''-remote'') |
 +| preview=<name> | Capture the preview of the specified BBS entry |
 +| active         | Display the last activity date of each entry in the BBS List |
 +| dedupe         | Remove duplicate entries from the BBS List (''-v'') |
 +| maint          | Delete old/inactive entries from the BBS List (''-v'') |
 +| install        | Install the Synchronet BBS List in a Synchronet BBS |
 +
 +=== Options === 
 +Command-line options begin with a ''-'' and modify the default behavior of ''sbbslist.js''.
 +
 +^ Option   ^ Description ^
 +| -v       | Increase console output verbosity (e.g. for trouble-shooting) |
 +| -f=<file>| Specify an alternate JSON database path/filename  (default is ''[[dir:data]]/sbbslist.json'') |
 +| -quiet   | Minimize console output |
 +| -exclude=<value> | Exclude select entries from the BBS List |
 +| -format=<value> | Specify the default list format (''-format='' for a list of formats) |
 +| -filter=<value> | Filter BBS List based on specified value |
 +| -all            | Import/export all entries (even those locally created) - not normally recommended |
 +| -ptr=<value>    | Over-ride the stored import/export message base pointer value |
 +| -addr=<value>   | Specify the address to capture a BBS preview from |
 +| -preview        | Include a preview with a BBS List ''update'' |
 +| -sort=<value>   | Sort the BBS List based on specified field |
 +| -reverse        | Reverse the natural/default sort order |
 +| -remote         | Remove/delete an entry in remote/networked databases too (use with the ''delete'' or ''remove'' command) |
 +| -debug          | Enable debug console/log output |
 +| -test           | Perform non-destructive maintenance and de-duplication operations |
 +| -#              | Limit the number of entries listed |
  
 ===== See Also ===== ===== See Also =====
-  * [[:module:|module index]]+  * [[:module:|Modules]] 
 +  * [[:bbs:|BBS Lists]] 
 +  * [[faq:misc#sbbslist|How do I get my BBS listed in the Synchronet BBS List?]]
  
-{{tag>}}+{{tag>sbbslist}}
  

Trace: