This module provides a simple wrapper around Log::Log4perl for cases where initialization may need to be delayed until a statup process is complete, but where configuration may need to be registered before that point. In essence it provides a way to delay logger initialization until the logger is actually needed or used.

A key use for this is for daemons where configuration may be set on loading a Perl module, but where file handles may be subsequently closed. This module allows you to delay initialization until you are actually logging, with an ability to initialize the logger at a specific point and reinitialize if necessary.

This API sets the configuration for subsequent logger initialization. This only caches the config and does no initialization itself. This is safe to call at any point in the program but if logging is already being done, you must reinitialize (see initialize_now() below).

Initializes, if necessary, and returns a logger with the identical syntax to Log4perl::get_logger(). If you close the file handles out from under the logger, you must reinitialize immediately after. See initialize_now() below.

This initializes Log4perl. If $reinitialize is set, it allows Log4perl to be explicitly reinitialized. This can be used to force a reinitialization, for example after file handles have been closed or after a configuration change.