This section shows all environment variables that are relevant to compiling and running the CF programs. Only the first three variables affects the build of the CF programs.
LD_LIBRARY_PATH
This is the path for shared-objects (so's). The standard
location is defined in /etc/ld.so.conf.
If XULRunner is installed in PREFIX $P and XULRunner is version
1.9.0.10, this can be defined with:
LD_LIBRARY_PATH=$P/lib:$P/lib/xulrunner-1.9.0.10 export LD_LIBRARY_PATH
This variable should be set both for compiling the CF programs and when running the CF programs.
PATHThis is the path for programs. If XULRunner is installed in PREFIX $P, this can be extended with:
PATH=$P/bin:$PATH export PATH
This variable should be set both for compiling the CF programs and when running the CF programs.
PKG_CONFIG_PATHThis is the path for the pkg-config system. If XULRunner is installed in PREFIX $P, this can be extended with:
PKG_CONFIG_PATH=$P/lib/pkgconfig export PKG_CONFIG_PATH
This variable only affects compilation of the CF programs.
GRE_HOMEThis variable tells the CF programs where the XULRunner system is located. It only needs to be defined if XULRunner is not installed in a standard location or if multiple XULRunner versions are installed at the same time. If prefix is $P and XULRunner is version 1.9.0.10 it might be defined as follows:
GRE_HOME=$P/lib/xulrunner-1.9.0.10 export GRE_HOME
This is a run-time only setting. It is only used when the CF programs are executed.
CF_MODULE_PATH
This variable tells the CF programs where the JavaScript
modules for running a connector is located. These modules
is bascially the shared code between the CF Engine and the
CF Builder. The run-time is located in directory
builder/modules of the
CF distribution. This variable is a run-time only setting.
The directory and the contents needs to be readable by the
CF programs. No write-permission is needed.
The directory specified must be absolute path
CF_CONNECTOR_PATH
This variable tells the cf-zserver
where the Connectors files are located. These files all have suffix
.cf.
The connector files are located in directory
connectors of the
CF distribution. This variable is a run-time only setting.
The directory and the contents needs to be readable by the
CF programs. No write-permission is needed.
The directory specified must be absolute path
CF_APP_PATH
This variable specifies an application directory for CF
browser. This directory must include the two directories
components and defaults
which is or is a copy-of the same directories from
engine/src from the CF distribution.
This variable is a run-time only setting.
The directory and the contents needs to be readable by the
CF programs. No write-permission is needed.
If this variable is not set, the application path is assumed
to be current working directory.
The directory specified must be absolute path
CF_PROFILE_PATHThis variable specifies an application directory for CF browser. This directory holds profile directories for the browser - including cache. It should be both readable and writable.
If this variable is unset or has en empty value, the Engine will not use file storage for the profile.
The directory specified must be absolute path
CF_BASE_PATH
This variable is a convenience variable read
by the cf-zserver server. The
value of the variable should be the directory of the
CF distribution - for example
/home/adam/proj/cf-2.0. When
set, cf-zserver will assume that connectors/modules are located in
connectors and builder/modules . This variable serves
as an alternative to
CF_CONNECTOR_PATH / CF_MODULE_PATH.
The directory specified must be absolute path
CF_REPO_FETCH_URL
This variable applies to cf-zserver.
It is a URL recipe for how to fetch a connector remote
remotely via a Web service. Connector files are only
fetched this way if CF_BASE_PATH and
CF_CONNECTOR_PATH are both unset.
The URL recipe must include the two character sequence
%s . This sequence is substituted with
the Z39.50 database.
For example http://host/cf.pl?%s.cf
which will fetch database X from the URL
http://host/cf.pl?X.cf.
The connector file is fetched via HTTP GET. If Z39.50 username and password is supplied during a Z39.50 session this is passed in the HTTP request using Basic HTTP Authentication.
CF_REPO_AUTH_URLThis variable applies to cf-zserver. It is a URL recipe for how to authenticate a user during Z39.50 session initialization.
If username and password is supplied in the Z39.50 Initialize Request,
these are passed as parameters for Basic HTTP authentication.
Unlike CF_REPO_FETCH_URL there is no substitution
taking place.
CF_TMP_DIRThis variable applies to cf-zserver and metaproxy module. It is a directory which holds temporary files for these applications and it must be writable.
DISPLAYThis environment specifies the X11 server for display.
CF_XVFB_LOCKDIR
This environment specifies a directory that holds lock files of the
form Xvfb.$i.LCK ($i=0, 1, 2, ...). The content of each file is
a valid DISPLAY content. It is a way for the engine to get exclusive
access to a particular Xvfb. It is, thus, an alternative way to specify
a DISPLAY for an engine. The init scripts for cf-xvfb on Debian
and RPM by default will use the directory
/var/run/cf-xvfb.
This variable was called CF_XVFB in CF releases 2.6.13-2.6.16.