openlog

(PHP 3, PHP 4, PHP 5)

openlog -- Abrir una conexión con el registro del sistema

Descripción

bool openlog ( string id, int opcion, int recurso )

openlog() abre una conexión con el registro del sistema para un programa. La cadena id es agregada a cada mensaje. Los valores para opcion y recurso son dados más adelante. El argumento opcion es usado para indicar qué opciones de registro serán usadas cuando se genere un mensaje de registro. El argumento recurso es usado para especificar qué tipo de programa está registrando el mensaje. Esto le permite especificar (en la configuración de syslog de su máquina) cómo serán manejados los mensajes provenientes de diferentes recursos. El uso de openlog() es opcional. La función será llamada automáticamente por syslog() si es necesario, en cuyo caso el valor predeterminado para id será FALSE.

Tabla 1. Opciones de openlog()

ConstanteDescripción
LOG_CONS si hay un error mientras se envían datos al registro del sistema, escribirlos directamente a la consola del sistema
LOG_NDELAY abrir la conexión con el registro inmediatamente
LOG_ODELAY (predeterminado) retrasar la apertura de la conexión hasta que el primer mensaje sea registrado
LOG_PERRORimprimir el mensaje de registro a la salida de errores estándar también
LOG_PIDincluir el valor PID con cada mensaje
Es posible usar una o más de estas opciones. Cuando se usen múltiples opciones, es necesario combinarlas mediante la operación OR, es decir, para abrir la conexión inmediatamente, escribir a la consola e incluir el PID en cada mensaje, se deberá usar: LOG_CONS | LOG_NDELAY | LOG_PID

Tabla 2. Recursos de openlog()

ConstanteDescripción
LOG_AUTH mensajes de seguridad/autorización (use LOG_AUTHPRIV en su lugar en sistemas en donde ésta última esté definida)
LOG_AUTHPRIVmensajes de seguridad/autorización (privados)
LOG_CRONdaemonio de reloj (cron y at)
LOG_DAEMONotros daemonios de sistema
LOG_KERNmensajes de núcleo
LOG_LOCAL0 ... LOG_LOCAL7reservados para uso local, no están disponibles en Windows
LOG_LPRsubsistema de impresora de línea
LOG_MAILsubsistema de correo
LOG_NEWSsubsistema de noticias USENET
LOG_SYSLOGmensajes generados internamente por syslogd
LOG_USERmensajes genéricos de nivel de usuario
LOG_UUCPsubsistema UUCP

Nota: LOG_USER es el único tipo de registro válido bajo sistemas operativos Windows

Vea también define_syslog_variables(), syslog() y closelog().