Forum und email

openlog

(PHP 4, PHP 5)

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

Descripción

bool openlog ( string $id , int $opcion , int $facilidad )

openlog() abre una conexión con el registro del sistema para un programa.

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.

Lista de parámetros

id

La cadena id es agregada a cada mensaje.

opcion

El argumento opcion es usado para indicar qué opciones de registro serán usadas cuando se genere un mensaje de registro.

Opciones de openlog()
Constante Descripció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_PERROR imprimir el mensaje de registro a la salida de errores estándar también
LOG_PID incluir 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

facilidad

El argumento facilidad 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.

Recursos de openlog()
Constante Descripción
LOG_AUTH mensajes de seguridad/autorización (use LOG_AUTHPRIV en su lugar en sistemas en donde ésta última esté definida)
LOG_AUTHPRIV mensajes de seguridad/autorización (privados)
LOG_CRON daemonio de reloj (cron y at)
LOG_DAEMON otros daemonios de sistema
LOG_DAEMON otros daemonios de sistema
LOG_KERN mensajes de núcleo
LOG_LOCAL0 ... LOG_LOCAL7 reservados para uso local, no están disponibles en Windows
LOG_LPR subsistema de impresora de línea
LOG_MAIL subsistema de correo
LOG_NEWS subsistema de noticias USENET
LOG_SYSLOG mensajes generados internamente por syslogd
LOG_USER mensajes genéricos de nivel de usuario
LOG_UUCP subsistema UUCP

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

Valores retornados

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.