NAME Apache::LogFile - Interface to Apache's logging routines SYNOPSIS #in a startup file use Apache::LogFile (); Apache::LogFile->new("|perl/mylogger.pl", "MyLogger"); #in a request-time file use Apache::LogFile (); my $fh = Apache::LogFile->handle("MyLogger"); print $fh "a message to the log"; DESCRIPTION The `new' method should be called by a server startup script or module. It will create a new log file or open a pipe to a program if the first character of the filename is a `|'. The last argument to `new' is optional, it is simply a name that can be used to retrive the filehandle via the `handle' method. If this argument is not present, the filename will be used the handle key, which can also be retrived via the `handle' method. The `new' method will return a reference to the filehandle if you wish to store it elsewhere, e.g.: $MyLog::Pipe = Apache::LogFile->new("|perl/mylogger.pl"); $MyLog::Append = Apache::LogFile->new("logs/my_log"); Filenames can be absolute or relative to ServerRoot. AUTHOR Doug MacEachern SEE ALSO Apache(3), mod_perl(3)