---
name: "bb-snapshot.cgi"
section: "1"
platform: "linux"
package: "xymon"
version: "4.3.0~beta2.dfsg-9.1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/bb-snapshot.cgi"
---

# bb-snapshot.cgi(1)

CGI program to rebuild the Xymon webpages for a specific point in time.

## NAME

bb-snapshot.cgi - CGI program to rebuild the Xymon webpages for a specific point in time.

## SYNOPSIS

**bb-snapshot.cgi**

## DESCRIPTION

**bb-snapshot.cgi** is invoked as a CGI script via the bb-snapshot.sh CGI wrapper. It rebuilds the Xymon web pages to the look they had  at a particular point in time, based upon the historical information logged about events.

bb-snapshot.cgi is passed a QUERY\_STRING environment variable with the following parameters:

   mon (Start month of the snapshot)\
    day (Start day-of-month of the snapshot)\
    yr  (Start year of the snapshot)\
    hour (Start hour of the snapshot)\
    min  (Start minute of the snapshot)\
    sec  (Start second of the snapshot)

The "month" parameters must be specified as the three-letter english month name abbreviation: Jan, Feb, Mar ...

"day" must be in the range 1..31; "yr" must be specified  including century (e.g. "2003"). "hour" must be specified  using a 24-hour clock.

All of the processing involved in generating the report is done  by invoking  *[bbgen(1)](/bbgen/1.md)* with the proper "--snapshot" option.

## OPTIONS

- \--env=FILENAME

  Load environment from FILENAME before executing the CGI.

- bbgen-options

  All options except "--env" are passed on to the  *[bbgen(1)](/bbgen/1.md)* program building the snapshot files.

## ENVIRONMENT VARIABLES

- BBGENSNAPOPTS

  bbgen options passed by default to the bb-snapshot.cgi script.  This happens in the bb-snapshot.sh CGI wrapper script.

- BBHOME

  Home directory of the Xymon server files

- BBSNAP

  Directory where generated snapshots are stored. This directory must be writable by the userid executing the CGI script, typically "www", "apache" or "nobody". Default: $BBHOME/www/snap/

- BBSNAPURL

  The URL prefix to use when accessing the reports via a browser. Default: $BBWEB/snap

## SEE ALSO

[bbgen(1)](/bbgen/1.md), [bb-hosts(5)](/bb-hosts/5.md), [hobbitserver.cfg(5)](/hobbitserver.cfg/5.md)