CGIOPTIONS.CFG(5)

💖 CGIOPTIONS.CFG — the file-formats manual, bestie edition 💖

okay so this is cgioptions.cfg(5), and it lives in the File Formats Manual section of the Xymon docs. grab a snack, we're going in 🍓

✨ SYNOPSIS ✨

$XYMONHOME/etc/cgioptions.cfg

that's it. that's the whole vibe. one file, one path, so much power 🫶

🌸 DESCRIPTION 🌸

so cgioptions.cfg(1) is literally the puppet master of command-line options — it controls the options that get passed to all of the Xymon CGI tools, and it does it through their respective shell-script wrappers. the way that it works is so iconic honestly.

usually the options you list in here are for system-wide configuration of the CGI utilities — like, for example, defining where they read their configuration files from. classic.

the exact set of command-line options that are actually available? those are described in the man-page for each of the CGI utilities individually. so if you're looking for the full menu, go read those. iykyk 📖

also super important, no cap: the file gets "sourced" into the shell script wrapper. so any assignments to the CGI-specific variables must follow standard shell-script syntax. it's giving shell script or it's giving nothing 💅

🎀 SETTINGS 🎀

here's the whole roster, one by one, no skipping, we don't do that here ✨

• CGI_ACKINFO_OPTS — the options for the ackinfo.cgi(1) utility.
• CGI_ACK_OPTS — the options for the acknowledge.cgi(1) utility.
• CGI_CSVINFO_OPTS — the options for the csvinfo.cgi(1) utility.
• CGI_DATEPAGE_OPTS — the options for the datepage.cgi(1) utility.
• CGI_ENADIS_OPTS — the options for the enadis.cgi(8) utility.
• CGI_EVENTLOG_OPTS — the options for the eventlog.cgi(1) utility.
• CGI_FINDHOST_OPTS — the options for the findhost.cgi(1) utility.
• CGI_HIST_OPTS — the options for the history.cgi(1) utility.
• CGI_COLUMNDOC_OPTS — the Xymon-specific options for column documentation. this one uses the csvinfo.cgi(1) utility together with the server/etc/columndoc.cfg configuration file. bestie collaboration fr fr 🤝
• CGI_CONFREPORT_OPTS — the options for the confreport.cgi(1) utility.
• CGI_SHOWGRAPH_OPTS — the options for the showgraph.cgi(1) utility.
• CGI_HOSTGRAPHS_OPTS — the options for the hostgraphs.cgi(1) utility.
• CGI_CRITEDIT_OPTS — the options for the criticaleditor.cgi(1) utility.
• CGI_CRITVIEW_OPTS — the options for the criticalview.cgi(1) utility.
• CGI_REPLOG_OPTS — the options for the reportlog.cgi(1) utility.
• CGI_REP_OPTS — the options for the report.cgi(1) utility.
• CGI_SNAPSHOT_OPTS — the options for the snapshot.cgi(1) utility.
• CGI_SVCHIST_OPTS — the options for the svcstatus.cgi(1) utility when it's being used to view historical logs. ⚠️ heads up: the "--historical" option must be included in this setting. like, mandatory mandatory. don't forget it or it's not gonna slay 😭
• CGI_SVC_OPTS — the options for the svcstatus.cgi(1) utility.

🦋 SEE ALSO 🦋

• xymon(7)
• the individual CGI utility man-pages

and that's the whole page, bestie!! go forth and configure responsibly 💜

this lil masterpiece comes to you from Xymon, Version 4.3.30: 4 Sep 2019 — mwah, love u, bye 👑💖