SMOKEINFO(1)

🌸 SMOKEINFO(1) β€” the SmokePing one, bestie 🌸

okay so before we even get into it: this is smokeinfo, part of the SmokePing manual fam. She's a little command-line girlie who goes and polls your smokeping site for numeric info. Let's get into it πŸ’…


✨ NAME ✨

smokeinfo β€” poll smokeping site for numeric information πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

smokeinfo path/to/config.cfg [options]

like, config path first, then whatever flags you're feeling πŸ’–

  • --start x β€” the rrd graph start time, no cap. (default now-24h)
  • --end y β€” the rrd graph end time. (default now)
  • --filter pattern β€” the search pattern used when picking which nodes to show πŸ”
  • --mode plain (default) β€” how the pattern gets used, bestie. the vibe options are:
    • plain
    • recursive
    • regexp
  • --separator ; (default) β€” yep, that's the separator, default is ;
  • --format %le (default) β€” the output format, default %le ✨
  • --no-head β€” do not print a header, if the header is giving too much
  • --man β€” show the man-page and exit πŸ“–
  • -h, --help β€” display this help and exit 🫢
  • --version β€” output version information and exit ⭐

πŸ’œ DESCRIPTION πŸ’œ

SmokeInfo is literally just a simple frontend to the Smokeping::Info module. That's it, that's the job. She gives you access to the numeric data stored in the rrd files 🌈

heads up bestie: --start and --end get passed directly to rrd graph. so yeah, they work on the same syntax. no extra spice added, no notes taken 😭

🌸 Examples 🌸

Get all data all nodes:

smokeinfo etc/config

Only show nodes directly under /Customers:

smokeinfo --filter=/Customers/ etc/config

Show all nodes under /Customers:

smokeinfo --mode=recursive --filter=/Customers/ etc/config

Show all nodes with _wlan_ in the name:

smokeinfo --mode=regexp --filter=_wlan_ etc/config

iconic behavior, honestly πŸ‘‘


πŸ‘€ SEE ALSO πŸ‘€

  • smokeping(1) β€” go read her too, she's the main character 🧚

Copyright (c) 2009 by OETIKER+PARTNER AG. All rights reserved. fr fr, all of them 🫑


πŸ“œ 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. (yes this part is in all caps and yes it's serious, don't @ me πŸ’€)

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.


πŸ‘‘ AUTHOR πŸ‘‘

Tobi Oetiker <tobi@oetiker.ch> β€” an absolute legend, we stan 🌟


πŸŽ€ HISTORY πŸŽ€

  • 2009-01-05 to β€” Initial Version (the origin story ✨)

that's the whole page bestie, no skips, no skimming, every flag accounted for 🫢 this version of smokeinfo is from 2.9.0, dated 2025-06-30, and that's the vibe check complete πŸ’– see you in the group chat 🌸

πŸ“¦ where this page comes from