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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 * RFC5424 syslog protocol declarations
19 #ifndef __included_syslog_h__
20 #define __included_syslog_h__
22 #include <vlib/vlib.h>
23 #include <vnet/vnet.h>
24 #include <vnet/ip/ip4_packet.h>
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") \
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")
53 #define _(v, N, s) SYSLOG_FACILITY_##N = v,
54 foreach_syslog_facility
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") \
71 #define _(v, N, s) SYSLOG_SEVERITY_##N = v,
72 foreach_syslog_severity
79 /** facility value, part of priority */
80 syslog_facility_t facility;
82 /** severity value, part of priority */
83 syslog_severity_t severity;
85 /** message timestamp */
88 /** application that originated the message RFC5424 6.2.5. */
91 /** identify the type of message RFC5424 6.2.7. */
99 syslog_header_t header;
101 /** structured data RFC5424 6.3. */
102 u8 **structured_data;
105 /** free-form message RFC5424 6.4. */
111 /** process ID RFC5424 6.2.6. */
117 /** IPv4 address of remote host (destination) */
118 ip4_address_t collector;
120 /** UDP port number of remote host (destination) */
123 /** IPv4 address of sender (source) */
124 ip4_address_t src_address;
126 /** FIB table index */
129 /** message size limit */
132 /** severity filter (specified severity and greater match) */
133 syslog_severity_t severity_filter;
135 /** ip4-lookup node index */
136 u32 ip4_lookup_node_index;
138 /** convenience variables */
139 vnet_main_t *vnet_main;
144 extern syslog_main_t syslog_main;
147 * @brief Initialize syslog message header
149 * @param facility facility value
150 * @param severity severity level
151 * @param app_name application that originated message RFC424 6.2.5. (optional)
152 * @param msgid identify the type of message RFC5424 6.2.7. (optional)
154 void syslog_msg_init (syslog_msg_t * syslog_msg, syslog_facility_t facility,
155 syslog_severity_t severity, char *app_name,
158 * @brief Initialize structured data element
160 * @param sd_id structured data element name RFC5424 6.3.2.
162 void syslog_msg_sd_init (syslog_msg_t * syslog_msg, char *sd_id);
165 * @brief Add structured data elemnt parameter name-value pair RFC5424 6.3.3.
167 void syslog_msg_add_sd_param (syslog_msg_t * syslog_msg, char *name,
171 * @brief Add free-form message RFC5424 6.4.
173 void syslog_msg_add_msg (syslog_msg_t * syslog_msg, char *fmt, ...);
176 * @brief Send syslog message
178 int syslog_msg_send (syslog_msg_t * syslog_msg);
181 * @brief Set syslog sender configuration
183 * @param collector IPv4 address of syslog collector (destination)
184 * @param collector_port UDP port of syslog colector (destination)
185 * @param src IPv4 address of syslog sender (source)
186 * @param vrf_id VRF/FIB table ID
187 * @param max_msg_size maximum message length
189 vnet_api_error_t set_syslog_sender (ip4_address_t * collector,
190 u16 collector_port, ip4_address_t * src,
191 u32 vrf_id, u32 max_msg_size);
194 * @brief Check if syslog logging is enabled
196 * @return 1 if syslog logging is enabled, 0 otherwise
199 syslog_is_enabled (void)
201 syslog_main_t *sm = &syslog_main;
203 return sm->collector.as_u32 ? 1 : 0;
207 * @brief Severity filter test
209 * @return 1 if message with specified severity is not selected to be logged
212 syslog_severity_filter_block (syslog_severity_t s)
214 syslog_main_t *sm = &syslog_main;
216 return (sm->severity_filter < s);
219 #endif /* __included_syslog_h__ */
222 * fd.io coding-style-patch-verification: ON
225 * eval: (c-set-style "gnu")