log.c revision bd27541a0c96caa881f17a490e23cdd220d480c8
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* http_log.c: Dealing with the logs and errors
*
* Rob McCool
*
*/
#include "apr.h"
#include "apr_general.h" /* for signal stuff */
#include "apr_strings.h"
#include "apr_errno.h"
#include "apr_thread_proc.h"
#include "apr_lib.h"
#include "apr_signal.h"
#define APR_WANT_STDIO
#define APR_WANT_STRFUNC
#include "apr_want.h"
#include <stdarg.h>
#endif
#include <unistd.h>
#endif
#include "ap_config.h"
#include "httpd.h"
#include "http_config.h"
#include "http_core.h"
#include "http_log.h"
#include "http_main.h"
#include "util_time.h"
#include "ap_mpm.h"
typedef struct {
const char *t_name;
int t_val;
} TRANS;
)
#ifdef HAVE_SYSLOG
static const TRANS facilities[] = {
{"auth", LOG_AUTH},
#ifdef LOG_AUTHPRIV
{"authpriv",LOG_AUTHPRIV},
#endif
#ifdef LOG_CRON
{"cron", LOG_CRON},
#endif
#ifdef LOG_DAEMON
{"daemon", LOG_DAEMON},
#endif
#ifdef LOG_FTP
{"ftp", LOG_FTP},
#endif
#ifdef LOG_KERN
{"kern", LOG_KERN},
#endif
#ifdef LOG_LPR
{"lpr", LOG_LPR},
#endif
#ifdef LOG_MAIL
{"mail", LOG_MAIL},
#endif
#ifdef LOG_NEWS
{"news", LOG_NEWS},
#endif
#ifdef LOG_SYSLOG
{"syslog", LOG_SYSLOG},
#endif
#ifdef LOG_USER
{"user", LOG_USER},
#endif
#ifdef LOG_UUCP
{"uucp", LOG_UUCP},
#endif
#ifdef LOG_LOCAL0
{"local0", LOG_LOCAL0},
#endif
#ifdef LOG_LOCAL1
{"local1", LOG_LOCAL1},
#endif
#ifdef LOG_LOCAL2
{"local2", LOG_LOCAL2},
#endif
#ifdef LOG_LOCAL3
{"local3", LOG_LOCAL3},
#endif
#ifdef LOG_LOCAL4
{"local4", LOG_LOCAL4},
#endif
#ifdef LOG_LOCAL5
{"local5", LOG_LOCAL5},
#endif
#ifdef LOG_LOCAL6
{"local6", LOG_LOCAL6},
#endif
#ifdef LOG_LOCAL7
{"local7", LOG_LOCAL7},
#endif
{NULL, -1},
};
#endif
static const TRANS priorities[] = {
{"emerg", APLOG_EMERG},
{"alert", APLOG_ALERT},
{"crit", APLOG_CRIT},
{"error", APLOG_ERR},
{"warn", APLOG_WARNING},
{"notice", APLOG_NOTICE},
{"info", APLOG_INFO},
{"debug", APLOG_DEBUG},
{NULL, -1},
};
/* track pipe handles to close in child process */
typedef struct read_handle_t {
struct read_handle_t *next;
static read_handle_t *read_handles;
/**
* @brief The piped logging structure.
*
* Piped logs are used to move functionality out of the main server.
* For example, log rotation is done with piped logs.
*/
struct piped_log {
/** The pool to use for the piped log */
apr_pool_t *p;
/** The pipe between the server and the logging process */
#ifdef AP_HAVE_RELIABLE_PIPED_LOGS
/** The name of the program the logging process is running */
char *program;
/** The pid of the logging process */
/** How to reinvoke program when it must be replaced */
#endif
};
{
}
{
}
/* clear_handle_list() is called when plog is cleared; at that
* point we need to forget about our old list of pipe read
* handles. We let the plog cleanups close the actual pipes.
*/
static apr_status_t clear_handle_list(void *v)
{
read_handles = NULL;
return APR_SUCCESS;
}
/* remember to close this handle in the child process
*
* On Win32 this makes zero sense, because we don't
* take the parent process's child procs.
* If the win32 parent instead passed each and every
* logger write handle from itself down to the child,
* and the parent manages all aspects of keeping the
* reliable pipe log children alive, this would still
* make no sense :) Cripple it on Win32.
*/
{
#ifndef WIN32
new_handle->handle = f;
#endif
}
{
while (cur) {
}
}
{
}
const char *fname)
{
if (!filename) {
fname);
return APR_EBADPATH;
}
APR_OS_DEFAULT, p)) != APR_SUCCESS) {
"%s: could not open error log file %s.",
return rc;
}
if (!stderr_pool) {
/* This is safe provided we revert it when we are finished.
* We don't manager the callers pool!
*/
stderr_pool = p;
}
== APR_SUCCESS) {
== APR_SUCCESS) {
/*
* You might ponder why stderr_pool should survive?
* The trouble is, stderr_pool may have s_main->error_log,
* so we aren't in a position to destory stderr_pool until
* the next recycle. There's also an apparent bug which
* is not; if some folk decided to call this function before
* the core open error logs hook, this pool won't survive.
* Neither does the stderr logger, so this isn't a problem.
*/
}
}
/* Revert, see above */
if (stderr_pool == p)
stderr_pool = NULL;
if (rc != APR_SUCCESS) {
"unable to replace stderr with error log file");
}
return rc;
}
const char *description)
{
"%s", description);
}
/* Create a child process running PROGNAME with a pipe connected to
* the childs stdin. The write-end of the pipe will be placed in
* *FPIN on successful return. If dummy_stderr is non-zero, the
* stderr for the child will be the same as the stdout of the parent.
* Otherwise the child will inherit the stderr from the parent. */
int dummy_stderr)
{
/* Child process code for 'ErrorLog "|..."';
* may want a common framework for this, since I expect it will
* be common for other foo-loggers to want this sort of thing...
*/
ap_server_root)) == APR_SUCCESS)
APR_NO_PIPE)) == APR_SUCCESS)
== APR_SUCCESS)) {
char **args;
const char *pname;
if (dummy_stderr) {
}
if (rc == APR_SUCCESS) {
/* read handle to pipe not kept open, so no need to call
* close_handle_in_child()
*/
}
}
return rc;
}
/* Open the error log for the given server_rec. If IS_MAIN is
* non-zero, s is the main server. */
{
const char *fname;
int rc;
if (*s->error_fname == '|') {
/* In 2.4 favor PROGRAM_ENV, accept "||prog" syntax for compatibility
* and "|$cmd" to override the default.
* Any 2.2 backport would continue to favor SHELLCMD_ENV so there
* accept "||prog" to override, and "|$cmd" to ease conversion.
*/
if (*fname == '|')
++fname;
if (*fname == '$') {
++fname;
}
/* Spawn a new child logger. If this is the main server_rec,
* the new child must use a dummy stderr since the current
* stderr might be a pipe to the old logger. Otherwise, the
* child inherits the parents stderr. */
if (rc != APR_SUCCESS) {
"Couldn't start ErrorLog process '%s'.",
s->error_fname + 1);
return DONE;
}
}
#ifdef HAVE_SYSLOG
fname++;
return OK;
}
}
}
else {
}
}
#endif
else {
if (!fname) {
"%s: Invalid error log path %s.",
ap_server_argv0, s->error_fname);
return DONE;
}
APR_OS_DEFAULT, p)) != APR_SUCCESS) {
"%s: could not open error log file %s.",
return DONE;
}
}
return OK;
}
{
server_rec *virt, *q;
int replace_stderr;
/* Register to throw away the read_handles list when we
* cleanup plog. Upon fork() for the apache children,
* this read_handles list is closed so only the parent
* can relaunch a lost log child. These read handles
* are always closed on exec.
* We won't care what happens to our stderr log child
* between log phases, so we don't mind losing stderr's
* read_handle a little bit early.
*/
/* HERE we need a stdout log that outlives plog.
* We *presume* the parent of plog is a process
* or global pool which spans server restarts.
* Create our stderr_pool as a child of the plog's
* parent pool.
*/
return DONE;
}
replace_stderr = 1;
/* Replace existing stderr with new log. */
if (rv != APR_SUCCESS) {
"unable to replace stderr with error_log");
}
else {
/* We are done with stderr_pool, close it, killing
* the previous generation's stderr logger
*/
if (stderr_pool)
replace_stderr = 0;
/*
* Now that we have dup'ed s_main->error_log to stderr_log
* close it and set s_main->error_log to stderr_log. This avoids
* this fd being inherited by the next piped logger who would
* keep open the writing end of the pipe that this one uses
* as stdin. This in turn would prevent the piped logger from
* exiting.
*/
}
}
/* note that stderr may still need to be replaced with something
* because it points to the old error log, or back to the tty
* of the submitter.
* errno-as-apr_status_t is also non-portable
*/
}
if (virt->error_fname) {
if (q->error_fname != NULL
break;
}
}
if (q == virt) {
return DONE;
}
}
else {
}
}
else {
}
}
return OK;
}
}
}
const conn_rec *c,
{
char errstr[MAX_STRING_LEN];
#ifndef AP_UNSAFE_ERROR_LOG_UNESCAPED
char scratch[MAX_STRING_LEN];
#endif
const char *referer;
if (r && r->connection) {
c = r->connection;
}
if (s == NULL) {
/*
* If we are doing stderr logging (startup), don't log messages that are
* notice
*/
#ifndef DEBUG
if ((level_and_mask != APLOG_NOTICE)
&& (level_and_mask > ap_default_loglevel)) {
return;
}
#endif
logf = stderr_log;
}
else if (s->error_log) {
/*
* If we are doing normal logging, don't log messages that are
*/
if ((level_and_mask != APLOG_NOTICE)
&& (level_and_mask > s->loglevel)) {
return;
}
}
else {
/*
* If we are doing syslog logging, don't log messages that are
*/
if (level_and_mask > s->loglevel) {
return;
}
}
errstr[0] = '[';
} else {
len = 0;
}
}
char tmp[256];
#ifdef WIN32
if (!e) {
}
#endif
* (it even returns an absolute path for sources in
* the current directory). Here we try to strip this
* down to the basename.
*/
if (*e == ')') {
*e = '\0';
}
}
#else /* _OSD_POSIX || WIN32 */
const char *p;
/* On Unix, __FILE__ may be an absolute path in a
* VPATH build. */
file = p + 1;
}
#endif /*_OSD_POSIX || WIN32 */
}
if (c) {
/* XXX: TODO: add a method of selecting whether logged client
* addresses are in dotted quad or resolved form... dotted
* quad is the most secure, which is why I'm implementing it
* first. -djg
*/
"[client %s] ", c->remote_ip);
}
if (status != 0) {
if (status < APR_OS_START_EAIERR) {
"(%d)", status);
}
else if (status < APR_OS_START_SYSERR) {
}
}
else {
}
}
}
#ifndef AP_UNSAFE_ERROR_LOG_UNESCAPED
MAX_STRING_LEN - len);
}
#else
#endif
#ifndef AP_UNSAFE_ERROR_LOG_UNESCAPED
#endif
) {
", referer: %s",
#ifndef AP_UNSAFE_ERROR_LOG_UNESCAPED
#else
#endif
);
}
/* NULL if we are logging to syslog */
if (logf) {
/* Truncate for the terminator (as apr_snprintf does) */
}
}
#ifdef HAVE_SYSLOG
else {
}
#endif
}
const char *fmt, ...)
{
}
const char *fmt, ...)
{
}
const char *fmt, ...)
{
args);
/*
* IF APLOG_TOCLIENT is set,
* AND the error level is 'warning' or more severe,
* AND there isn't already error text associated with this request,
* THEN make the message text available to ErrorDocument and
* other error processors.
*/
if ((level & APLOG_TOCLIENT)
args)));
}
}
const char *fmt, ...)
{
}
{
int i;
char *result;
int len_needed = 0;
/* Piece together the command line from the pieces
* in process->argv, with spaces in between.
*/
}
*result = '\0';
}
}
"Command line: '%s'", result);
}
{
const char *fname;
if (!filename) {
return;
}
if (!fname) {
return;
}
/* AP_SIG_GRACEFUL and HUP call this on each restart.
* Only warn on first time through for this pid.
*
* XXX: Could just write first time through too, although
* that may screw up scripts written to do something
* based on the last modification time of the pid file.
*/
"pid file %s overwritten -- Unclean "
"shutdown of previous Apache run?",
fname);
}
!= APR_SUCCESS) {
"could not create %s", fname);
"%s: could not log pid to file %s",
exit(1);
}
}
{
const char *fname;
if (!filename) {
return APR_EGENERAL;
}
if (!fname) {
return APR_EGENERAL;
}
if (rv != APR_SUCCESS) {
return rv;
}
return rv;
}
/* If we fill the buffer, we're probably reading a corrupt pid file.
* To be nice, let's also ensure the first char is a digit. */
return APR_EGENERAL;
}
return APR_SUCCESS;
}
int nLine)
{
char time_str[APR_CTIME_LEN];
"[%s] file %s, line %d, assertion \"%s\" failed",
#if defined(WIN32)
DebugBreak();
#else
/* unix assert does an abort leading to a core dump */
abort();
#endif
}
/* piped log support */
#ifdef AP_HAVE_RELIABLE_PIPED_LOGS
/* forward declaration */
/* Spawn the piped logger process pl->program. */
{
!= APR_SUCCESS) ||
!= APR_SUCCESS) ||
!= APR_SUCCESS) ||
!= APR_SUCCESS) ||
char buf[120];
/* Something bad happened, give up and go away. */
"piped_log_spawn: unable to setup child process '%s': %s",
}
else {
char **args;
const char *pname;
if (status == APR_SUCCESS) {
/* procnew->in was dup2'd from pl->write_fd;
* since the original fd is still valid, close the copy to
* avoid a leak. */
}
else {
char buf[120];
/* Something bad happened, give up and go away. */
"unable to start piped log program '%s': %s",
}
}
return status;
}
{
int mpm_state;
switch (reason) {
case APR_OC_REASON_DEATH:
case APR_OC_REASON_LOST:
* tells other logic not to try to kill it
*/
if (stats != APR_SUCCESS) {
"can't query MPM state; not restarting "
"piped log program '%s'",
}
else if (mpm_state != AP_MPMQ_STOPPING) {
"piped log program '%s' failed unexpectedly",
/* what can we do? This could be the error log we're having
* problems opening up... */
char buf[120];
"piped_log_maintenance: unable to respawn '%s': %s",
}
}
break;
case APR_OC_REASON_UNWRITABLE:
/* We should not kill off the pipe here, since it may only be full.
* If it really is locked, we should kill it off manually. */
break;
case APR_OC_REASON_RESTART:
}
break;
case APR_OC_REASON_UNREGISTER:
break;
}
}
{
return APR_SUCCESS;
}
{
}
return piped_log_cleanup_for_exec(data);
}
const char *program,
{
pl->p = p;
APR_FULL_BLOCK, p) != APR_SUCCESS) {
return NULL;
}
return NULL;
}
return pl;
}
#else /* !AP_HAVE_RELIABLE_PIPED_LOGS */
{
return APR_SUCCESS;
}
const char *program,
{
int rc;
if (rc != APR_SUCCESS) {
"Couldn't start piped log process '%s'.",
return NULL;
}
pl->p = p;
return pl;
}
#endif
const char *program)
{
/* In 2.4 favor PROGRAM_ENV, accept "||prog" syntax for compatibility
* and "|$cmd" to override the default.
* Any 2.2 backport would continue to favor SHELLCMD_ENV so there
* accept "||prog" to override, and "|$cmd" to ease conversion.
*/
if (*program == '|')
++program;
if (*program == '$') {
++program;
}
}
{
}
{
int i = 0;
return err;
return NULL;
}
i++;
}
return err;
}