FD.io VPP  v20.05-21-gb1500e9ff
Vector Packet Processing
syslog.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2018 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 /**
16  * @file syslog.h
17  * RFC5424 syslog protocol declarations
18  */
19 #ifndef __included_syslog_h__
20 #define __included_syslog_h__
21 
22 #include <vlib/vlib.h>
23 #include <vnet/vnet.h>
24 #include <vnet/ip/ip4_packet.h>
25 
26 /* syslog message facilities */
27 #define foreach_syslog_facility \
28  _(0, KERNEL, "kernel") \
29  _(1, USER_LEVEL, "user-level") \
30  _(2, MAIL_SYSTEM, "mail-system") \
31  _(3, SYSTEM_DAEMONS, "system-daemons") \
32  _(4, SEC_AUTH, "security-authorization") \
33  _(5, SYSLOGD, "syslogd") \
34  _(6, LINE_PRINTER, "line-printer") \
35  _(7, NETWORK_NEWS, "network-news") \
36  _(8, UUCP, "uucp") \
37  _(9, CLOCK, "clock-daemon") \
38  _(11, FTP, "ftp-daemon") \
39  _(12, NTP, "ntp-subsystem") \
40  _(13, LOG_AUDIT, "log-audit") \
41  _(14, LOG_ALERT, "log-alert") \
42  _(16, LOCAL0, "local0") \
43  _(17, LOCAL1, "local1") \
44  _(18, LOCAL2, "local2") \
45  _(19, LOCAL3, "local3") \
46  _(20, LOCAL4, "local4") \
47  _(21, LOCAL5, "local5") \
48  _(22, LOCAL6, "local6") \
49  _(23, LOCAL7, "local7")
50 
51 typedef enum
52 {
53 #define _(v, N, s) SYSLOG_FACILITY_##N = v,
55 #undef _
57 
58 /* syslog message severities */
59 #define foreach_syslog_severity \
60  _(0, EMERGENCY, "emergency") \
61  _(1, ALERT, "alert") \
62  _(2, CRITICAL, "critical") \
63  _(3, ERROR, "error") \
64  _(4, WARNING, "warning") \
65  _(5, NOTICE, "notice") \
66  _(6, INFORMATIONAL, "informational") \
67  _(7, DEBUG, "debug")
68 
69 typedef enum
70 {
71 #define _(v, N, s) SYSLOG_SEVERITY_##N = v,
73 #undef _
75 
76 /** syslog header */
77 typedef struct
78 {
79  /** facility value, part of priority */
81 
82  /** severity value, part of priority */
84 
85  /** message timestamp */
87 
88  /** application that originated the message RFC5424 6.2.5. */
89  char *app_name;
90 
91  /** identify the type of message RFC5424 6.2.7. */
92  char *msgid;
94 
95 /** syslog message */
96 typedef struct
97 {
98  /** header */
100 
101  /** structured data RFC5424 6.3. */
104 
105  /** free-form message RFC5424 6.4. */
106  u8 *msg;
107 } syslog_msg_t;
108 
109 typedef struct
110 {
111  /** process ID RFC5424 6.2.6. */
113 
114  /** time offset */
116 
117  /** IPv4 address of remote host (destination) */
119 
120  /** UDP port number of remote host (destination) */
122 
123  /** IPv4 address of sender (source) */
125 
126  /** FIB table index */
128 
129  /** message size limit */
131 
132  /** severity filter (specified severity and greater match) */
134 
135  /** ip4-lookup node index */
137 
138  /** convenience variables */
141 } syslog_main_t;
142 
144 
145 /**
146  * @brief Initialize syslog message header
147  *
148  * @param facility facility value
149  * @param severity severity level
150  * @param app_name application that originated message RFC424 6.2.5. (optional)
151  * @param msgid identify the type of message RFC5424 6.2.7. (optional)
152  */
154  syslog_severity_t severity, char *app_name,
155  char *msgid);
156 /**
157  * @brief Initialize structured data element
158  *
159  * @param sd_id structured data element name RFC5424 6.3.2.
160  */
161 void syslog_msg_sd_init (syslog_msg_t * syslog_msg, char *sd_id);
162 
163 /**
164  * @brief Add structured data elemnt parameter name-value pair RFC5424 6.3.3.
165  */
167  char *fmt, ...);
168 
169 /**
170  * @brief Add free-form message RFC5424 6.4.
171  */
172 void syslog_msg_add_msg (syslog_msg_t * syslog_msg, char *fmt, ...);
173 
174 /**
175  * @brief Send syslog message
176  */
178 
179 /**
180  * @brief Set syslog sender configuration
181  *
182  * @param collector IPv4 address of syslog collector (destination)
183  * @param collector_port UDP port of syslog colector (destination)
184  * @param src IPv4 address of syslog sender (source)
185  * @param vrf_id VRF/FIB table ID
186  * @param max_msg_size maximum message length
187  */
189  u16 collector_port, ip4_address_t * src,
190  u32 vrf_id, u32 max_msg_size);
191 
192 /**
193  * @brief Check if syslog logging is enabled
194  *
195  * @return 1 if syslog logging is enabled, 0 otherwise
196  */
197 always_inline int
199 {
200  syslog_main_t *sm = &syslog_main;
201 
202  return sm->collector.as_u32 ? 1 : 0;
203 }
204 
205 /**
206  * @brief Severity filter test
207  *
208  * @return 1 if message with specified severity is not selected to be logged
209  */
210 always_inline int
212 {
213  syslog_main_t *sm = &syslog_main;
214 
215  return (sm->severity_filter < s);
216 }
217 
218 #endif /* __included_syslog_h__ */
219 
220 /*
221  * fd.io coding-style-patch-verification: ON
222  *
223  * Local Variables:
224  * eval: (c-set-style "gnu")
225  * End:
226  */
char * app_name
application that originated the message RFC5424 6.2.5.
Definition: syslog.h:89
#define foreach_syslog_facility
Definition: syslog.h:27
u16 collector_port
UDP port number of remote host (destination)
Definition: syslog.h:121
vnet_api_error_t
Definition: api_errno.h:160
char * msgid
identify the type of message RFC5424 6.2.7.
Definition: syslog.h:92
f64 time_offset
time offset
Definition: syslog.h:115
vl_api_address_t src
Definition: gre.api:54
syslog header
Definition: syslog.h:77
u32 fib_index
FIB table index.
Definition: syslog.h:127
u32 max_msg_size
message size limit
Definition: syslog.h:130
vlib_main_t * vlib_main
convenience variables
Definition: syslog.h:139
unsigned char u8
Definition: types.h:56
vnet_api_error_t set_syslog_sender(ip4_address_t *collector, u16 collector_port, ip4_address_t *src, u32 vrf_id, u32 max_msg_size)
Set syslog sender configuration.
Definition: syslog.c:249
double f64
Definition: types.h:142
u32 procid
process ID RFC5424 6.2.6.
Definition: syslog.h:112
unsigned int u32
Definition: types.h:88
void syslog_msg_add_sd_param(syslog_msg_t *syslog_msg, char *name, char *fmt,...)
Add structured data elemnt parameter name-value pair RFC5424 6.3.3.
Definition: syslog.c:111
int syslog_msg_send(syslog_msg_t *syslog_msg)
Send syslog message.
Definition: syslog.c:160
syslog_severity_t
Definition: syslog.h:69
unsigned short u16
Definition: types.h:57
syslog_header_t header
header
Definition: syslog.h:99
syslog_facility_t
Definition: syslog.h:51
#define always_inline
Definition: ipsec.h:28
u8 * msg
free-form message RFC5424 6.4.
Definition: syslog.h:106
void syslog_msg_sd_init(syslog_msg_t *syslog_msg, char *sd_id)
Initialize structured data element.
Definition: syslog.c:101
syslog_severity_t severity_filter
severity filter (specified severity and greater match)
Definition: syslog.h:133
void syslog_msg_add_msg(syslog_msg_t *syslog_msg, char *fmt,...)
Add free-form message RFC5424 6.4.
Definition: syslog.c:129
string name[64]
Definition: ip.api:44
vnet_main_t * vnet_main
Definition: syslog.h:140
syslog_main_t syslog_main
Definition: syslog.c:33
syslog_facility_t facility
facility value, part of priority
Definition: syslog.h:80
ip4_address_t src_address
IPv4 address of sender (source)
Definition: syslog.h:124
#define foreach_syslog_severity
Definition: syslog.h:59
syslog message
Definition: syslog.h:96
u32 ip4_lookup_node_index
ip4-lookup node index
Definition: syslog.h:136
void syslog_msg_init(syslog_msg_t *syslog_msg, syslog_facility_t facility, syslog_severity_t severity, char *app_name, char *msgid)
Initialize syslog message header.
Definition: syslog.c:143
f64 timestamp
message timestamp
Definition: syslog.h:86
static u8 * syslog_msg
Definition: main.c:95
u8 ** structured_data
structured data RFC5424 6.3.
Definition: syslog.h:102
syslog_severity_t severity
severity value, part of priority
Definition: syslog.h:83
ip4_address_t collector
IPv4 address of remote host (destination)
Definition: syslog.h:118
u32 curr_sd_index
Definition: syslog.h:103
u32 vrf_id
Definition: nat.api:856
static int syslog_severity_filter_block(syslog_severity_t s)
Severity filter test.
Definition: syslog.h:211
static int syslog_is_enabled(void)
Check if syslog logging is enabled.
Definition: syslog.h:198