Catalog

### Index Up << >>

## Catalog

Specifies a catalog that can run using this MiniVend server. There are three required parameters, separated by spaces and/or tabs.

The first is the name of the catalog -- it will be referred to as that name in error, warning, and informational messages. It must contain only alphanumeric characters, hyphens, and underscores.

The second is the base directory of the catalog. If the directory does not contain a catalog.cfg file, the server will report an error and refuse to start.

The third directive is very important to get right -- it is the SCRIPT_NAME of the vlink program that runs the catalog. It must be unique from other CGI program paths that run on this server -- that is how the catalog is selected for operation.

        Catalog  simple /home/minivend/simple /cgi-bin/simple /simple

You can specify any number of alias script names as additional parameters. This allows the calling path to be different while still calling the same catalog -- it is most probably useful when calling an SSL server or a members-only executable that requires a username/password via HTTP Basic authorization. All branched links will be called using the aliased URL.

Optionally, you can call individual `Catalog` lines that specify the different parameters. The equivalent of the above is:

        Catalog simple directory /home/minivend/simple
        Catalog simple script    /cgi-bin/simple
        Catalog simple alias     /simple

You can also specify global directives that will change for that catalog only. This is mostly useful for `ErrorFile` and `DisplayErrors`:

        Catalog simple directive ErrorFile /var/log/mvend/simple_error.log

### Index Up << >>