1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190
|
.\" Written Feb 1994 by Steve Greenland (stevegr@neosoft.com)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Translated into Spanish Thu Mar 12 12:24:57 CET 1998 by Gerardo
.\" Aburruzaga Garca <gerardo.aburruzaga@uca.es>
.\"
.TH SYSLOG 3 "12 Marzo 1998" "Linux" "Manual del Programador de Linux"
.SH NOMBRE
closelog, openlog, syslog \- envan mensajes al registrador del sistema
.SH SINOPSIS
.B #include <syslog.h>
.sp
.BI "void openlog( char " *ident ", int " opcion ", int " facilidad )
.sp
.BI "void syslog( int " prioridad ", char " *format ", ...)"
.sp
.BI "void closelog( void )"
.sp
.SH DESCRIPCIN
.B closelog()
cierra el descriptor que se est usando para escribir en el
registrador del sistema. El empleo de
.B closelog()
es opcional.
.sp
.B openlog()
abre, para un programa, una conexin con el registrador del sistema. La
cadena de caracteres a la que apunte
.I ident
se aade a cada mensaje, y normalmente se hace que contenga el nombre
del programa. Los valores de
.I opcion
y
.I facilidad
se dan en la seccin siguiente. El empleo de
.B openlog()
es opcional;
.B syslog()
la llamara automticamente si fuera menester, en cuyo caso
.I ident
tomara el valor NULL.
.sp
.B syslog()
genera un mensaje en el registro, que ser distribuido por
.BR syslogd (8).
.I prioridad
es una combinacin de
.I facilidad
y de
.IR nivel ,
cuyos valores se dan en la seccin siguiente. Los restantes argumentos
son un formato,
.IR format ,
como en
.BR printf (3),
y cualesquiera argumentos requeridos por
.IR format ,
salvo que los dos caracteres %m sern reemplazados por la cadena con
el mensaje de error
.RI ( strerror )
correspondiente al valor actual de
.IR errno .
.SH "PARMETROS"
Esta seccin enumera los parmetros empleados para poner los valores de
.IR opcion , " facilidad" ", y " prioridad .
.SS opcion
El argumento
.I opcion
de
.B openlog()
es el resultado de la combinacin con el operador de bits O inclusivo
de cualquiera de estos valoes:
.TP
.B LOG_CONS
escribe directamente en la consola del sistema si hay un error
mientras se est enviando algo al registrador del sistema
.TP
.B LOG_NDELAY
abre la conexin inmediatamente (normalmente, la conexin se abre
cuando se registra el primer mensaje)
.TP
.B LOG_PERROR
imprime tambin en stderr
.TP
.B LOG_PID
incluye el PID con cada mensaje
.SS facilidad
El argumento
.I facilidad
se emplea para especificar qu tipo de programa est registrando el
mensaje. Esto permite que en el fichero de configuracin se
especifique que mensajes de diferentes programas se manejen de forma
distinta.
.TP
.B LOG_AUTH
mensajes de seguridad o autorizacin (DESAPROBADO; emplee en su lugar
.BR LOG_AUTHPRIV )
.TP
.B LOG_AUTHPRIV
mensajes de seguridad o autorizacin (privado)
.TP
.B LOG_CRON
el demonio del reloj
.RB ( cron " y " at )
.TP
.B LOG_DAEMON
otros demonios del sistema
.TP
.B LOG_KERN
mensajes del ncleo
.TP
.BR LOG_LOCAL0 " a " LOG_LOCAL7
reservados para uso local
.TP
.B LOG_LPR
subsistema de impresora de lnea (de impresin)
.TP
.B LOG_MAIL
subsistema de correo
.TP
.B LOG_NEWS
subsistema de tabln de anuncios USENET News
.TP
.B LOG_SYSLOG
mensajes generados internamente por
.B syslogd
.TP
.B LOG_USER
(predeterminado)
mensajes genricos del nivel de usuario
.TP
.B LOG_UUCP
subsistema de UUCP
.SS nivel
Esto determina la importancia del mensaje. Los niveles son, en orden
de importancia decreciente:
.TP
.B LOG_EMERG
el sistema est inutilizable
.TP
.B LOG_ALERT
debe tomarse una accin correctora inmediatamente
.TP
.B LOG_CRIT
condiciones crticas
.TP
.B LOG_ERR
condiciones de error
.TP
.B LOG_WARNING
condiciones de advertencia
.TP
.B LOG_NOTICE
condicin normal, pero significativa
.TP
.B LOG_INFO
mensaje informativo
.TP
.B LOG_DEBUG
mensaje del nivel de depuracin
.SH HISTORIA
Una llamada a funcin
.B syslog
apareci en BSD 4.2.
.SH "VASE TAMBIN"
.BR logger "(1), " syslog.conf "(5), " syslogd (8)
|