Provided by: hobbit_4.2.0.dfsg-16build1_i386 bug

NAME

       bb-findhost.cgi - Hobbit CGI script to find hosts

SYNOPSIS

       bb-findhost.cgi?host=REGEX

DESCRIPTION

       bb-findhost.cgi  is  invoked as a CGI script via the bb-findhost.sh CGI
       wrapper.

       bb-findhost.cgi is passed a QUERY_STRING environment variable with  the
       "host=REGEX"  parameter.  The  REGEX is a Posix regular expression (see
       regex(7) ) describing the hostnames to look for.  A  trailing  wildcard
       is  assumed  on all hostnames - e.g. requesting the hostname "www" will
       match any host whose name begins with "www".

       It then produces a single web page,  listing  all  of  the  hosts  that
       matched  any  of the hostnames, with links to the Hobbit webpages where
       they are located.

       The output page lists hosts in the order they appear in the bb-hosts(5)
       file.

       A  sample  web  page  implementing the search facility is included with
       bbgen, you access it via the URL /bb/help/bb-findhost.html.

OPTIONS

       --env=FILENAME
              Loads the environment from FILENAME before executing the CGI.

FILES

       $BBHOME/web/findhost_header
              HTML header file for the generated web page

       $BBHOME/web/findhost_footer
              HTML footer file for the generated web page

       $BBHOME/web/findhost_form
              Query form displayed when  bb-findhost.cgi  is  called  with  no
              parameters.

ENVIRONMENT VARIABLES

       BBHOSTS
              bb-findhost.cgi  uses  the  BBHOSTS environment variable to find
              the bb-hosts  file  listing  all  known  hosts  and  their  page
              locations.

       BBHOME Used to locate the template files for the generated web pages.

SEE ALSO

       bbgen(1), bb-hosts(5), hobbitserver.cfg(5)