Environment Variables

The package uses environment variables to control the initialization procedure. The environment variables replace the system property entries used by Log4j.

For compability reasons the Log4j entry is recognised. Alternatively a environment variable style Log4Qt form can be used. The following entries are used:

• LOG4QT_DEBUG
  The variable controls the Level value for the logger LogManager::logLogger(). If the value is a valid Level string, the level for the is set to the level. If the value is not a valid Level string, DEBUG_INT is used. Otherwise ERROR_INT is used.
  • LogManager::configureLogLogger()

• LOG4QT_DEFAULTINITOVERRIDE
  The variable controls the initialization procedure performed by the LogManager on startup. If it is set to any other value then false the initialization procedure is skipped.
  • LogManager::startup()

• LOG4QT_CONFIGURATION
  The variable specifies the configuration file used for initialising the package.
  • LogManager::startup()

• LOG4QT_CONFIGURATORCLASS
  The variable specifies the configurator class used for initialising the package.

Environment variables are read during static initialisation on creation of the InitialisationHelper. They can be accessed by calling InitialisationHelper::environmentSettings().

All settings can also be made in the application settings under the group Log4Qt. For example the environment variable LOG4QT_DEBUG is equivalent to the setting Log4Qt/Debug. If an environment variable is set it takes precedence over the application setting. Settings are only used, if an QApplication object is available, when the LogManager is initialised (see InitialisationHelper::setting() for details).