Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
STATUSREPORT.CGI(1)	    General Commands Manual	   STATUSREPORT.CGI(1)

       statusreport.cgi	 -  CGI	 program  to  report  a	 status	for a group of

       statusreport.cgi	--column=COLUMNNAME [options]

       statusreport.cgi	is a CGI tool to generate a simple HTML	report showing
       the current status of a single column for a group of Xymon hosts.

       E.g.  You can use this report to	get an overview	of all of the SSL cer-
       tificates that are about	to expire.

       The generated webpage is	a simple HTML table, suitable for copying into
       other documents or e-mail.

       statusreport.cgi	 runs as a CGI program,	invoked	by your	webserver.  It
       is normally run via a wrapper shell-script in the CGI directory for Xy-

       The  Xymon  installation	includes two web report	scripts	using this CGI
       tool: The script generates	a list of SSL server  certifi-
       cates that are yellow or	red (i.e. they will expire soon); and the non-	script generates a report of all statuses that	are  currently
       non-green.  These can be	accessed from a	web browser through a URL ref-
       erencing	the script in the Xymon	CGI  directory	(e.g.  "/xymon-cgi/xy-").

	      Report the status	of the COLUMNNAME column.

       --all  Report the status	for all	hosts known to Xymon. By default, this
	      tool reports only	on the hosts found on the  current  page  from
	      where the	CGI was	invoked	(by looking at the "pagepath" cookie).

	      Only report on statuses that match the CRITERIA setting. See the
	      xymon(1) man-page	- in the "xymondboard" command	description  -
	      for details about	specifying filters.

	      Defines the webpage heading - i.e. the "title" tag in the	gener-
	      ated HTML	code.

	      Include the column name in the display.

	      Show the status color on the generated webpage. The  default  is
	      to not show the status color.

	      Do  not include text showing the current color of	each status in
	      the report. This is the default.

	      Show only	a summary of the important lines in  the  status  mes-
	      sage.  By	default, the entire status message appears in the gen-
	      erated HTML code.	This option causes the first non-blank line of
	      the  status  message  to	be shown, and also any lines beginning
	      with "&COLOR" which is used by many status messages to point out
	      lines of interest	(non-green lines only, though).

	      Show the entire message on the webpage. This is the default.

       --link Include HTML links to the	host "info" page, and the status page.

	      Only  generate  the  HTML	table, not a full webpage. This	can be
	      used to embed the	status report into an external webpage.

	      Load the environment from	FILENAME before	executing the CGI.

	      Load environment variables for a specific	 area.	NB:  if	 used,
	      this option must appear before any --env=FILENAME	option.


Xymon			  Version 4.3.30:  4 Sep 2019	   STATUSREPORT.CGI(1)


Want to link to this manual page? Use this URL:

home | help