smbutils

Inspect, validate, repair, and maintain Synchronet Message Base files.

107|19|Updated Sep 4, 2020
One-click install
npx skills add https://github.com/SynchronetBBS/sbbs --skill smbutils
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smbutils
Source: https://github.com/SynchronetBBS/sbbs/tree/main/.claude/skills/smbutils
Command: npx skills add https://github.com/SynchronetBBS/sbbs --skill smbutils

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of managing low-level Synchronet Message Base (SMB) files that cannot be accessed, repaired, or maintained via the BBS's built-in configuration tools, JavaScript API, or web interface, especially when bases are corrupt, the BBS is offline, or bulk operations like packing or importing messages are required.

Core Features & Use Cases

  • Read-Only Integrity Checking: Use chksmb to scan mail bases, sub-boards, and file bases for corruption without modifying any data, ideal for cron-based health checks or troubleshooting base access issues.
  • Targeted Repair & Maintenance: Fix common SMB issues like mismatched message numbers, hash file corruption, or accidental message deletions using fixsmb, or run base maintenance and space reclamation via smbutil.
  • Bulk Message Operations: Import FidoNet netmail, email, or generic messages from text files directly to SMB bases, or list, view, and filter messages across large bases for auditing or recovery. A common use case is recovering a corrupted message sub-board that fails to open in the BBS by running an integrity check, applying targeted repairs, and verifying the base is functional without complex custom scripting.

Quick Start

Use the smbutils skill to run a read-only integrity check on your Synchronet mail base to identify any corruption before attempting repairs.

Frequently Asked Questions about smbutils

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I repair a corrupted Synchronet message base that fails to open?

To repair a corrupted Synchronet message base, run an integrity check with chksmb to identify issues, apply targeted fixes with fixsmb, and verify the base is functional. This workflow recovers sub-boards without custom scripting.

Can I run read-only integrity checks on Synchronet SMB files for health monitoring?

Yes, you can run read-only integrity checks on Synchronet SMB files using chksmb. It scans mail bases, sub-boards, and file bases for corruption without modifying data, making it ideal for cron-based health monitoring.

How do I bulk import messages into a Synchronet message base from text files?

You can bulk import messages into a Synchronet message base from text files using smbutil. It supports importing FidoNet netmail, email, or generic messages directly into local mail bases and sub-boards.

Does Synchronet SMB maintenance require command-line tools when the BBS is offline?

Synchronet SMB maintenance requires command-line tools like smbutil, chksmb, and fixsmb when bases are corrupt or the BBS is offline. These tools perform low-level operations inaccessible via the BBS interface or JavaScript API.

What is the best way to reclaim space and perform maintenance on Synchronet SMB bases?

The best way to reclaim space and perform maintenance on Synchronet SMB bases is using smbutil. It handles base packing and scheduled maintenance tasks that cannot be executed through the standard BBS web interface.

Are safe backups supported before applying repairs to Synchronet message bases?

Yes, safe backups are supported before applying repairs to Synchronet message bases. The repair workflow includes safe backup creation to protect data before executing targeted fixes with fixsmb or maintenance with smbutil.