File: syslog.3

package info (click to toggle)
manpages-es 1.28-13
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 4,884 kB
  • ctags: 6
  • sloc: makefile: 63; sh: 55
file content (190 lines) | stat: -rw-r--r-- 4,897 bytes parent folder | download | duplicates (3)
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)