NOMBRE¶

closelog, openlog, syslog - envían mensajes al registrador del sistema

SINOPSIS¶

#include <syslog.h>

void openlog(const char *ident, int option, int facility);
void syslog(int priority, const char *format, ...);
void closelog(void);

#include <stdarg.h>

void vsyslog(int priority, const char *format, va_list ap);

DESCRIPCIÓN¶

closelog() cierra el descriptor que se esté usando para escribir en el registrador del sistema. El empleo de closelog() es opcional.

openlog() abre, para un programa, una conexión con el registrador del sistema. La cadena de caracteres a la que apunte ident se adjunta con cada mensaje, y su valor es normalmente el nombre del programa. El argumento option especifica banderas que controlan la operación de openlog() y las llamadas posteriores a syslog(). El argumento facility establece un valor por defecto que se utiliza si no se especifica ninguno en llamadas posteriores a syslog(). Los valores de option y facility se dan abajo. El uso de openlog() es opcional; syslog() la llamaría automáticamente si fuera necesario, en cuyo caso ident tomaría el valor NULL.

syslog() genera un mensaje en el registro, que será distribuido por syslogd(8). El argumento priority se construye con la operación lógica OR de facility y de level , (explicados abajo). Los restantes argumentos son un formato, format, como en printf(3), y cualesquiera argumentos requeridos por format, salvo que la secuencia de dos caracteres %m será reemplazada por la cadena con el mensaje de error strerror(errno). Un carácter final de nueva línea será añadido cuando sea necesario.

La función vsyslog() hace la misma tarea que syslog() con la diferencia de que acepta un conjunto de argumentos que han sido obtenidos usando las macros de stdarg(3) para listas de argumentos variables.

PARÁMETROS¶

Esta sección enumera los parámetros empleados para poner los valores de option, facility, y priority.

CONFORME A¶

Las funciones openlog(), closelog(), y syslog() (pero no vsyslog()) están especificadas en SUSv2 y POSIX 1003.1-2001. POSIX 1003.1-2001 especifica solamente los valores LOG_USER y LOG_LOCAL* para facility. Sin embargo, salvo la excepción de LOG_AUTHPRIV y LOG_FTP, los otros valores de facility aparecen en la mayoría de sistemas Unix. El valor LOG_PERROR para option no está especificado por POSIX 1003.1-2001, pero está disponible en la mayoría de versiones de Unix.

HISTORIA¶

La función syslog apareció en BSD 4.2. BSD 4.3 documenta openlog(), syslog(), closelog(), y setlogmask(). 4.3BSD-Reno documenta también vsyslog(). Por supuesto, funciones v* anteriores usaban el mecanismo <varargs.h> , que no es compatible con <stdarg.h>.

OBSERVACIONES¶

El parámetro ident en la llamada a openlog() es probablemente almacenado tal cual. De esta manera, si la cadena a la que apunta es modificada, syslog() puede comenzar añadiendo la cadena modificada, y si la cadena a la que apunta deja de existir, los resultados son indefinidos. La mayor portabilidad se consigue usando una cadena constante.

Nunca pase una cadena con datos de usuario como formato, use

VÉASE TAMBIÉN¶

logger(1), setlogmask(3), syslog.conf(5), syslogd(8)