syslog

SYSLOG(3)                Manual del Programador de Linux               SYSLOG(3)



NOMBRE
       closelog, openlog, syslog, vsyslog - 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);

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

   Requisitos de Macros de Prueba de Características para glibc (véase
   feature_test_macros(7)):

       vsyslog():
           Since glibc 2.19:
               _DEFAULT_SOURCE
           Glibc 2.19 and earlier:
               _BSD_SOURCE

DESCRIPCIÓN
   openlog()
       openlog()  opens a connection to the system logger for a program.

       The string pointed to by ident is prepended to every message, and is
       typically set to the program name.  If ident is NULL, the program name is
       used.  (POSIX.1-2008 does not specify the behavior when ident is NULL.)

       The option argument specifies flags which control the operation of
       openlog()  and subsequent calls to syslog().  The facility argument
       establishes a default to be used if none is specified in subsequent calls
       to syslog().  The values that may be specified for option and facility
       are described below.

       The use of openlog()  is optional; it will automatically be called by
       syslog()  if necessary, in which case ident will default to NULL.

   syslog() y vsyslog()
       syslog()  generates a log message, which will be distributed by
       syslogd(8).

       The priority argument is formed by ORing together a facility value and a
       level value (described below).  If no facility value is ORed into
       priority, then the default value set by openlog()  is used, or, if there
       was no preceding openlog()  call, a default of LOG_USER is employed.

       The remaining arguments are a format, as in printf(3), and any arguments
       required by the format, except that the two-character sequence %m will be
       replaced by the error message string strerror(errno).  The format string
       need not include a terminating newline character.

       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.

   closelog()
       closelog()  closes the file descriptor being used to write to the system
       logger.  The use of closelog()  is optional.

   Values for option
       The option argument to openlog()  is a bit mask constructed by ORing
       together any of the following values:

       LOG_CONS       Escribe directamente en la consola del sistema si hay un
                      error mientras se está enviando algo al registrador del
                      sistema.

       LOG_NDELAY     Open the connection immediately (normally, the connection
                      is opened when the first message is logged).  This may be
                      useful, for example, if a subsequent chroot(2)  would make
                      the pathname used internally by the logging facility
                      unreachable.

       LOG_NOWAIT     No espera a los procesos hijo que pueden haber sido
                      creados mientras se registraba el mensaje.  (La biblioteca
                      C de GNU no crea un proceso hijo, así que esta opción no
                      tiene efecto en Linux.)

       LOG_ODELAY     La opuesta de LOG_NDELAY; la apertura de la conexión se
                      retrasa hasta que se invoca a syslog(). (Esta es la opción
                      por defecto, y no necesita ser especificada.)

       LOG_PERROR     (Not in POSIX.1-2001 or POSIX.1-2008.)  Also log the
                      message to stderr.

       LOG_PID        Include the caller's PID with each message.

   Values for facility
       El argumento facility se emplea para especificar qué tipo de programa
       está registrando el mensaje. Esto permite que en el fichero de
       configuración se especifique que mensajes de diferentes programas se
       manejen de forma distinta.

       LOG_AUTH       mensajes de seguridad o autorización

       LOG_AUTHPRIV   mensajes de seguridad o autorización (privado)

       LOG_CRON       el demonio del reloj (cron y at)

       LOG_DAEMON     demonios del sistema con valor de `facility' separado

       LOG_FTP        demonio de ftp

       LOG_KERN       kernel messages (these can't be generated from user
                      processes)

       LOG_LOCAL0 a LOG_LOCAL7
                      reservados para uso local

       LOG_LPR        subsistema de impresora de línea (de impresión)

       LOG_MAIL       subsistema de correo

       LOG_NEWS       subsistema de tablón de anuncios USENET News

       LOG_SYSLOG     mensajes generados internamente por syslogd(8)

       LOG_USER (predeterminado)
                      mensajes genéricos del nivel de usuario

       LOG_UUCP       subsistema de UUCP

   Values for level
       Esto determina la importancia del mensaje. Los niveles son, en orden de
       importancia decreciente:

       LOG_EMERG      el sistema está inutilizable

       LOG_ALERT      debe tomarse una acción correctora inmediatamente

       LOG_CRIT       condiciones críticas

       LOG_ERR        condiciones de error

       LOG_WARNING    condiciones de advertencia

       LOG_NOTICE     condición normal, pero significativa

       LOG_INFO       mensaje informativo

       LOG_DEBUG      mensaje del nivel de depuración

       La función setlogmask(3)  puede ser empleada para restringir el registro
       solamente en niveles determinados.

ATRIBUTOS
       Para obtener una explicación de los términos usados en esta sección,
       véase attributes(7).

       ┌──────────────────────┬────────────────────┬────────────────────┐
       │Interfaz              Atributo           Valor              │
       ├──────────────────────┼────────────────────┼────────────────────┤
       │openlog(), closelog() │ Seguridad del hilo │ Multi-hilo seguro  │
       ├──────────────────────┼────────────────────┼────────────────────┤
       │syslog(), vsyslog()   │ Seguridad del hilo │ MT-Safe env locale │
       └──────────────────────┴────────────────────┴────────────────────┘
CONFORME A
       Las funciones openlog(), closelog() y syslog() (pero no vsyslog())  están
       especificadas en SUSv2, POSIX.1-2001 y POSIX.1-2008.

       POSIX.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.1-2001 o
       POSIX.1-2008, pero está disponible en la mayoría de versiones de Unix.

NOTAS
       The argument ident in the call of openlog()  is probably stored as-is.
       Thus, if the string it points to is changed, syslog()  may start
       prepending the changed string, and if the string it points to ceases to
       exist, the results are undefined.  Most portable is to use a string
       constant.

       Never pass a string with user-supplied data as a format, use the
       following instead:

           syslog(priority, "%s", string);

VÉASE TAMBIÉN
       journalctl(1), logger(1), setlogmask(3), syslog.conf(5), syslogd(8)

COLOFÓN
       Esta página es parte de la versión 5.10 del proyecto Linux man-pages.
       Puede encontrar una descripción del proyecto, información sobre cómo
       informar errores y la última versión de esta página en
       https://www.kernel.org/doc/man-pages/.


TRADUCCIÓN
       La traducción al español de esta página del manual fue creada por Gerardo
       Aburruzaga García <gerardo.aburruzaga@uca.es> y Miguel Pérez Ibars
       <mpi79470@alu.um.es>

       Esta traducción es documentación libre; lea la GNU General Public License
       Version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o posterior con
       respecto a las condiciones de copyright.  No existe NINGUNA
       RESPONSABILIDAD.

       Si encuentra algún error en la traducción de esta página del manual,
       envíe un correo electrónico a debian-l10n-spanish@lists.debian.org>.  ⟨⟩.



Linux                          15 Septiembre 2017                      SYSLOG(3)