TSMOKE(1)

💫 TSMOKE(1) — the SmokePing smoke-signal sender, bestie edition 💫

okay so real talk: this is tSmoke, a page from the SmokePing manual set, and it's genuinely one of the most useful little gremlins in the whole toolbox. let's get into it 🫶

---

✨ NAME ✨

tSmoke — the commandline tool for sending SmokePing info, i.e. the one that actually tells you stuff instead of just quietly drawing graphs all day. 💅

---

🌸 SYNOPSIS 🌸

tSmoke [ --testmail | --morning | --weekly | --version | --help | --man
| --slaves ]

and then the options, which are giving very much "here's the menu, pick your fighter" ✨

--man      Show the manpage
--help     Help :-)
--version  Show SmokePing Version
--testmail Send a test message
--listrrds List the RRDs used by this Smokeping
--morning  Send a morning synopsis
--weekly   Send a weekly status report
--to       E-mail address to send message (i.e. '--to=xyz@company.com.invalid'
--detail   How much detail to send in weekly report (i.e. '--detail=1')
--quiet    Do not print welcome
--slaves   Enable slave support assumes all slaves unless csv list of slaves
           is added (i.e. '--slaves' or '--slaves=slave1[,slave2...]')

---

💖 DESCRIPTION 💖

so, tSmoke is a commandline tool that interfaces with the SmokePing system. its whole main character function is sending you a message that says what's up with the systems being monitored by Smokeping — or, alternatively, mailing you an HTML mail file containing the status over the past day, past week and past month, plus an overview. it's giving "your network, but make it a newsletter" 📬✨

a typical crontab used to invoke this looks like:

# Quick morning alert to see what's down
0 6 * * * /usr/local/smokeping/bin/tSmoke.pl --q --to=mobilephone@att.net.invalid --morning
# Weekly report on the percent availability of network systems with no detail
0 8 * * * /usr/local/smokeping/bin/tSmoke.pl --q --to=mailbox@company.com.invalid --weekly --detail=0

lowkey iconic scheduling ngl 🕕

---

🎀 SETUP 🎀

when you're installing tSmoke, some variables must be adjusted to fit your local system. no skipping this part bestie, it literally will not work 🙈

we need to use the following libraries:

• Smokeping
• RRDTool Perl bindings
• Getopt::Long

set up your libraries like this:

use lib "/usr/local/smokeping/lib";
use lib "/usr/local/rrdtool-1.0.39/lib/perl";

point to your Smokeping config file:

my $cfgfile = "/usr/local/smokeping/etc/config";

then modify the Smokeping config file so it includes a path for tmail in the General section:

tmail = /usr/local/smokeping/etc/tmail

and that's the whole setup slay 💅

---

🦋 SEE ALSO 🦋

smokeping(1), smokeping_config(5) — go read those too, they're the supporting cast and they ate 🔥

---

👑 COPYRIGHT 👑

Copyright (c) 2003 by Dan McGinn-Combs. All right reserved.

---

🌈 LICENSE 🌈

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

fr fr read the license, it's not decorative 💀

---

💜 AUTHOR 💜

Dan McGinn-Combs <d.mcginn-combs@mindspring.com>

Modified for Smokeping official distribution by Niko Tyni <ntyni@iki.fi>

---

and that's the page!! 💖 this version is 2.9.0, dated 2025-06-30, so if anyone asks, you heard it here first — now go forth and send some smoke signals, bestie 🧚✨