| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| dir:data [2018/01/19 22:39] – [qnet] Added details about avatar files in data/qnet digital man | dir:data [2025/08/30 20:43] (current) – Document batch queue files correctly digital man |
|---|
| ====== DATA Directory ====== | ====== data directory ====== |
| |
| The location of the DATA directory is configurable (in [[util:SCFG]]->System->Advanced Options), but defaults to a sub-directory named ''data'' off of the installation directory (e.g. ''/sbbs/data/''). | The location of the ''data'' directory is configurable (in [[util:SCFG]]->System->Advanced Options), but defaults to a sub-directory named **''data''** off of the installation directory (e.g. ''/sbbs/data/''). |
| |
| ===== Directory Contents ===== | ===== Directory Contents ===== |
| |
| The Synchronet DATA directory contains the run-time data created during the normal operation of the BBS. | The Synchronet Data directory contains the run-time data created during the normal operation of the BBS. |
| | |
| | Examples include: |
| | |
| | - ''mail.*'' - Private email and netmail message base |
| | - ''spam.hash'' - Database of known-SPAM message body hashes (used by the [[server:Mail]] Server) |
| | - ''logon.jsonl'' - List of user logons to the [[server:Terminal]] Server (''logon.*.jsonl'' files are previous days logons) |
| | - ''logon.lst'' - List of user logons to the [[server:Terminal]] Server - //legacy format// |
| | - ''areas.bbs'' - FidoNet-style message areas (used by [[util:SBBSecho]]) |
| | - ''badareas.lst'' - Unconnected FidoNet-style message areas (used by [[util:SBBSecho]]) |
| | - ''echostats.ini'' - FidoNet-style message area statistics (used by [[util:SBBSecho]]) |
| | - ''sbbslist.json'' - BBS List (used by [[module:sbbslist]]) |
| | - ''*.log'' - Log files created by Synchronet and some utilities (e.g. [[util:SBBSecho]]) |
| | - ''*.now'' - [[config:semfiles|Semaphore files]] used by Synchronet |
| |
| ===== Sub-directories ===== | ===== Sub-directories ===== |
| |
| Typical sub-directories of the DATA directory include: | Typical sub-directories of the Data directory include: |
| |
| ==== user ==== | ==== user ==== |
| Where user data is stored. | Where user data is stored. |
| - ''user.dat'' - user database | - ''user.tab'' - [[history:newuserbase|user database]] |
| - ''name.dat'' - username index | - ''name.dat'' - username index |
| - ''<user-number>.sig'' - user signature | - ''<user-number>.sig'' - user signature |
| - ''<user-number>.*'' - other user file | - ''<user-number>.*'' - other user data (e.g. settings) file |
| - ''ptrs/<user-number>.ixb'' - user message scan configuration and pointers | - ''<user-number>.ini'' - user configuration settings (used by JS modules) |
| | - ''<user-number>.subs'' - user message-scan configuration and pointers |
| | - ''<user-number>.upload'' - user batch upload queue |
| | - ''<user-number>.dnload'' - user batch download queue |
| | - ''<user-number>/*/'' - sub-directories for further per-user data storage |
| |
| ==== subs ==== | ==== subs ==== |
| Synchronet message-base (SMB) files for configured sub-boards ([[util:SCFG]]->Message Areas) reside here. | Synchronet message-base (SMB) files for configured sub-boards ([[util:SCFG]]->Message Areas) reside here. |
| - ''<internal-code>.shd'' - message headers | - ''<internal-code>.shd'' - message headers |
| - ''<internal-code>.shd'' - message header allocation (optional) | - ''<internal-code>.sha'' - message header allocation (optional) |
| - ''<internal-code>.sid'' - message indexes | - ''<internal-code>.sid'' - message indexes |
| - ''<internal-code>.sdt'' - message data | - ''<internal-code>.sdt'' - message data |
| - ''<internal-code>.sdt'' - message data allocation (optional) | - ''<internal-code>.sda'' - message data allocation (optional) |
| - ''<internal-code>.sch'' - message CRC history (for duplicate message body text checking) | - ''<internal-code>.sch'' - message CRC history (for duplicate message body text checking) |
| - ''<internal-code>.ini'' - message base auxiliary configuration and state information | - ''<internal-code>.ini'' - message base auxiliary configuration and state information |
| ==== dirs ==== | ==== dirs ==== |
| File transfer directory database files reside here. | File transfer directory database files reside here. |
| - ''<internal-code>.dab'' - file base binary data (last-uploaded file date/time) | - ''<internal-code>.shd'' - file headers (metadata about files) |
| - ''<internal-code>.dat'' - file base text data | - ''<internal-code>.sha'' - file header allocation |
| - ''<internal-code>.ixb'' - file base index | - ''<internal-code>.sid'' - file indexes (filenames and hash values) |
| - ''<internal-code>.exb'' - file base extended descriptions | - ''<internal-code>.sdt'' - file extended descriptions and aux data |
| | - ''<internal-code>.sda'' - file extended descriptions and aux data allocation |
| | - ''<internal-code>.ini'' - filebase metadata |
| |
| ==== file ==== | ==== file ==== |
| This directory contains various file transfer: | This directory contains various file transfer: |
| |
| - User download queues (''<user-number>.dwn'') | |
| - Pre-packed QWK packets (''<user-number>.qwk'') | - Pre-packed QWK packets (''<user-number>.qwk'') |
| - Uploaded QWK reply packets (''<user-number>.rep'') | - Uploaded QWK reply packets (''<user-number>.rep'') |
| |
| ==== logs ==== | ==== logs ==== |
| Various activity log files are stored in this directory. | Various dated activity log files are stored in this directory. |
| |
| ==== qnet ==== | ==== qnet ==== |
| - ''NODES.DAT'' - QWKnet node list | - ''NODES.DAT'' - QWKnet node list |
| - ''USERS.DAT'' - QWKnet user list | - ''USERS.DAT'' - QWKnet user list |
| | |
| | ==== fido==== |
| | FidoNet-style networking files are stored in this directory (''<node>'' is in hexadecimal net/node format). |
| | - ''<node>.avatars.ini'' - Users avatars received from FidoNet-style node |
| | - ''<node>.*.bin'' - Avatar collections received from FidoNet-style |
| | |
| | ==== finger ==== |
| | Files placed here can be queried using "special finger requests" to the [[service:finger]] service. |
| |
| ==== msgs ==== | ==== msgs ==== |
