XYMONCFG(1)

💖 XYMONCFG 💖

okay so bestie, welcome to the xymoncfg page from the General Commands Manual — yes it's section 1, yes it's a command, yes it's lowkey iconic 🎀

✨ NAME ✨

xymoncfg — output the full hosts.cfg file 🦋

🌸 SYNOPSIS 🌸

xymoncfg [--web] [--net] [filename]

💅 DESCRIPTION 💅

so xymoncfg(1) dumps the full hosts.cfg file straight to stdout. no cap. it follows the include tags inside your hosts.cfg files and prints out the whole entire contents exactly as seen by the xymongen(1) and xymonnet(1) utilities 👑

basically it's giving "here's the receipts, all of them, nothing hidden" ✨

if you don't hand it a filename, xymoncfg just shows you the file that the HOSTSCFG environment variable is pointing at. simple as that 🫶

🎀 OPTIONS 🎀

• --web — shows the hosts.cfg file following include statements the way a Xymon web-server would do it 🌈
• --net — shows the hosts.cfg file following include statements the way it gets done when you run xymonnet 💜
• -s — outputs only the lines that look like environment variable definitions, in a format that's suitable for Bourne-style shells (think bash, ksh). you'll probably not use this with the default hosts.cfg input file, but like, e.g. xymonserver.cfg is the vibe. and to define all the variables in xymonserver.cfg inside your shell script, you can use:

eval `xymoncfg -s /etc/xymon/xymonserver.cfg`

• -c — similar to -s, but for C-shell. same energy, different shell 💀

🧚 ENVIRONMENT VARIABLES 🧚

• HOSTSCFG — filename for the hosts.cfg(5) file. it's the fallback bestie when you don't pass a filename 🌸

👑 SEE ALSO 👑

hosts.cfg(5), xymonserver.cfg(5)

and that's the whole thing, periodt 💖 this lil gem is brought to you by Xymon, Version 4.3.30, dated 4 Sep 2019 — mwah, go read your config files bestie, ily 🫶✨