2 * Copyright (C) 2013 - Jérémie Galarneau <jeremie.galarneau@efficios.com>
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU General Public License, version 2 only, as
6 * published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * You should have received a copy of the GNU General Public License along with
14 * this program; if not, write to the Free Software Foundation, Inc., 51
15 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
27 #include <sys/types.h>
31 #include <common/defaults.h>
32 #include <common/error.h>
33 #include <common/macros.h>
34 #include <common/utils.h>
35 #include <common/compat/getenv.h>
36 #include <lttng/lttng-error.h>
37 #include <libxml/parser.h>
38 #include <libxml/valid.h>
39 #include <libxml/xmlschemas.h>
40 #include <libxml/tree.h>
41 #include <lttng/lttng.h>
42 #include <lttng/snapshot.h>
44 #include "session-config.h"
45 #include "config-internal.h"
47 struct handler_filter_args
{
49 config_entry_handler_cb handler
;
53 struct session_config_validation_ctx
{
54 xmlSchemaParserCtxtPtr parser_ctx
;
56 xmlSchemaValidCtxtPtr schema_validation_ctx
;
59 const char * const config_str_yes
= "yes";
60 const char * const config_str_true
= "true";
61 const char * const config_str_on
= "on";
62 const char * const config_str_no
= "no";
63 const char * const config_str_false
= "false";
64 const char * const config_str_off
= "off";
65 const char * const config_xml_encoding
= "UTF-8";
66 const size_t config_xml_encoding_bytes_per_char
= 2; /* Size of the encoding's largest character */
67 const char * const config_xml_indent_string
= "\t";
68 const char * const config_xml_true
= "true";
69 const char * const config_xml_false
= "false";
71 const char * const config_element_channel
= "channel";
72 const char * const config_element_channels
= "channels";
73 const char * const config_element_domain
= "domain";
74 const char * const config_element_domains
= "domains";
75 const char * const config_element_event
= "event";
76 const char * const config_element_events
= "events";
77 const char * const config_element_context
= "context";
78 const char * const config_element_contexts
= "contexts";
79 const char * const config_element_attributes
= "attributes";
80 const char * const config_element_exclusion
= "exclusion";
81 const char * const config_element_exclusions
= "exclusions";
82 const char * const config_element_function_attributes
= "function_attributes";
83 const char * const config_element_probe_attributes
= "probe_attributes";
84 const char * const config_element_symbol_name
= "symbol_name";
85 const char * const config_element_address
= "address";
86 const char * const config_element_offset
= "offset";
87 const char * const config_element_name
= "name";
88 const char * const config_element_enabled
= "enabled";
89 const char * const config_element_overwrite_mode
= "overwrite_mode";
90 const char * const config_element_subbuf_size
= "subbuffer_size";
91 const char * const config_element_num_subbuf
= "subbuffer_count";
92 const char * const config_element_switch_timer_interval
= "switch_timer_interval";
93 const char * const config_element_read_timer_interval
= "read_timer_interval";
94 const char * const config_element_output
= "output";
95 const char * const config_element_output_type
= "output_type";
96 const char * const config_element_tracefile_size
= "tracefile_size";
97 const char * const config_element_tracefile_count
= "tracefile_count";
98 const char * const config_element_live_timer_interval
= "live_timer_interval";
99 LTTNG_HIDDEN
const char * const config_element_discarded_events
= "discarded_events";
100 LTTNG_HIDDEN
const char * const config_element_lost_packets
= "lost_packets";
101 const char * const config_element_type
= "type";
102 const char * const config_element_buffer_type
= "buffer_type";
103 const char * const config_element_session
= "session";
104 const char * const config_element_sessions
= "sessions";
105 LTTNG_HIDDEN
const char * const config_element_context_perf
= "perf";
106 LTTNG_HIDDEN
const char * const config_element_context_app
= "app";
107 LTTNG_HIDDEN
const char * const config_element_context_app_provider_name
= "provider_name";
108 LTTNG_HIDDEN
const char * const config_element_context_app_ctx_name
= "ctx_name";
109 const char * const config_element_config
= "config";
110 const char * const config_element_started
= "started";
111 const char * const config_element_snapshot_mode
= "snapshot_mode";
112 const char * const config_element_loglevel
= "loglevel";
113 const char * const config_element_loglevel_type
= "loglevel_type";
114 const char * const config_element_filter
= "filter";
115 LTTNG_HIDDEN
const char * const config_element_filter_expression
= "filter_expression";
116 const char * const config_element_snapshot_outputs
= "snapshot_outputs";
117 const char * const config_element_consumer_output
= "consumer_output";
118 const char * const config_element_destination
= "destination";
119 const char * const config_element_path
= "path";
120 const char * const config_element_net_output
= "net_output";
121 const char * const config_element_control_uri
= "control_uri";
122 const char * const config_element_data_uri
= "data_uri";
123 const char * const config_element_max_size
= "max_size";
124 const char * const config_element_pid
= "pid";
125 const char * const config_element_pids
= "pids";
126 const char * const config_element_shared_memory_path
= "shared_memory_path";
127 const char * const config_element_pid_tracker
= "pid_tracker";
128 const char * const config_element_trackers
= "trackers";
129 const char * const config_element_targets
= "targets";
130 const char * const config_element_target_pid
= "pid_target";
132 const char * const config_domain_type_kernel
= "KERNEL";
133 const char * const config_domain_type_ust
= "UST";
134 const char * const config_domain_type_jul
= "JUL";
135 const char * const config_domain_type_log4j
= "LOG4J";
136 const char * const config_domain_type_python
= "PYTHON";
138 const char * const config_buffer_type_per_pid
= "PER_PID";
139 const char * const config_buffer_type_per_uid
= "PER_UID";
140 const char * const config_buffer_type_global
= "GLOBAL";
142 const char * const config_overwrite_mode_discard
= "DISCARD";
143 const char * const config_overwrite_mode_overwrite
= "OVERWRITE";
145 const char * const config_output_type_splice
= "SPLICE";
146 const char * const config_output_type_mmap
= "MMAP";
148 const char * const config_loglevel_type_all
= "ALL";
149 const char * const config_loglevel_type_range
= "RANGE";
150 const char * const config_loglevel_type_single
= "SINGLE";
152 const char * const config_event_type_all
= "ALL";
153 const char * const config_event_type_tracepoint
= "TRACEPOINT";
154 const char * const config_event_type_probe
= "PROBE";
155 const char * const config_event_type_function
= "FUNCTION";
156 const char * const config_event_type_function_entry
= "FUNCTION_ENTRY";
157 const char * const config_event_type_noop
= "NOOP";
158 const char * const config_event_type_syscall
= "SYSCALL";
159 const char * const config_event_type_kprobe
= "KPROBE";
160 const char * const config_event_type_kretprobe
= "KRETPROBE";
162 const char * const config_event_context_pid
= "PID";
163 const char * const config_event_context_procname
= "PROCNAME";
164 const char * const config_event_context_prio
= "PRIO";
165 const char * const config_event_context_nice
= "NICE";
166 const char * const config_event_context_vpid
= "VPID";
167 const char * const config_event_context_tid
= "TID";
168 const char * const config_event_context_vtid
= "VTID";
169 const char * const config_event_context_ppid
= "PPID";
170 const char * const config_event_context_vppid
= "VPPID";
171 const char * const config_event_context_pthread_id
= "PTHREAD_ID";
172 const char * const config_event_context_hostname
= "HOSTNAME";
173 const char * const config_event_context_ip
= "IP";
174 const char * const config_event_context_perf_thread_counter
= "PERF_THREAD_COUNTER";
175 LTTNG_HIDDEN
const char * const config_event_context_app
= "APP";
176 LTTNG_HIDDEN
const char * const config_event_context_interruptible
= "INTERRUPTIBLE";
177 LTTNG_HIDDEN
const char * const config_event_context_preemptible
= "PREEMPTIBLE";
178 LTTNG_HIDDEN
const char * const config_event_context_need_reschedule
= "NEED_RESCHEDULE";
179 LTTNG_HIDDEN
const char * const config_event_context_migratable
= "MIGRATABLE";
181 /* Deprecated symbols */
182 const char * const config_element_perf
;
184 enum process_event_node_phase
{
189 struct consumer_output
{
196 static int config_entry_handler_filter(struct handler_filter_args
*args
,
197 const char *section
, const char *name
, const char *value
)
200 struct config_entry entry
= { section
, name
, value
};
204 if (!section
|| !name
|| !value
) {
210 if (strcmp(args
->section
, section
)) {
215 ret
= args
->handler(&entry
, args
->user_data
);
221 int config_get_section_entries(const char *override_path
, const char *section
,
222 config_entry_handler_cb handler
, void *user_data
)
226 FILE *config_file
= NULL
;
227 struct handler_filter_args filter
= { section
, handler
, user_data
};
229 /* First, try system-wide conf. file. */
230 path
= DEFAULT_DAEMON_SYSTEM_CONFIGPATH
;
232 config_file
= fopen(path
, "r");
234 DBG("Loading daemon conf file at %s", path
);
236 * Return value is not very important here since error or not, we
237 * continue and try the next possible conf. file.
239 (void) ini_parse_file(config_file
,
240 (ini_entry_handler
) config_entry_handler_filter
,
245 /* Second is the user local configuration. */
246 path
= utils_get_home_dir();
248 char fullpath
[PATH_MAX
];
250 ret
= snprintf(fullpath
, sizeof(fullpath
),
251 DEFAULT_DAEMON_HOME_CONFIGPATH
, path
);
253 PERROR("snprintf user conf. path");
257 config_file
= fopen(fullpath
, "r");
259 DBG("Loading daemon user conf file at %s", path
);
261 * Return value is not very important here since error or not, we
262 * continue and try the next possible conf. file.
264 (void) ini_parse_file(config_file
,
265 (ini_entry_handler
) config_entry_handler_filter
,
271 /* Final path is the one that the user might have provided. */
273 config_file
= fopen(override_path
, "r");
275 DBG("Loading daemon command line conf file at %s", override_path
);
276 (void) ini_parse_file(config_file
,
277 (ini_entry_handler
) config_entry_handler_filter
,
281 ERR("Failed to open daemon configuration file at %s",
288 /* Everything went well. */
296 int config_parse_value(const char *value
)
299 char *endptr
, *lower_str
;
309 v
= strtoul(value
, &endptr
, 10);
310 if (endptr
!= value
) {
315 lower_str
= zmalloc(len
+ 1);
322 for (i
= 0; i
< len
; i
++) {
323 lower_str
[i
] = tolower(value
[i
]);
326 if (!strcmp(lower_str
, config_str_yes
) ||
327 !strcmp(lower_str
, config_str_true
) ||
328 !strcmp(lower_str
, config_str_on
)) {
330 } else if (!strcmp(lower_str
, config_str_no
) ||
331 !strcmp(lower_str
, config_str_false
) ||
332 !strcmp(lower_str
, config_str_off
)) {
344 * Returns a xmlChar string which must be released using xmlFree().
346 static xmlChar
*encode_string(const char *in_str
)
348 xmlChar
*out_str
= NULL
;
349 xmlCharEncodingHandlerPtr handler
;
350 int out_len
, ret
, in_len
;
354 handler
= xmlFindCharEncodingHandler(config_xml_encoding
);
356 ERR("xmlFindCharEncodingHandler return NULL!. Configure issue!");
360 in_len
= strlen(in_str
);
362 * Add 1 byte for the NULL terminted character. The factor 4 here is
363 * used because UTF-8 characters can take up to 4 bytes.
365 out_len
= (in_len
* 4) + 1;
366 out_str
= xmlMalloc(out_len
);
371 ret
= handler
->input(out_str
, &out_len
, (const xmlChar
*) in_str
, &in_len
);
378 /* out_len is now the size of out_str */
379 out_str
[out_len
] = '\0';
385 struct config_writer
*config_writer_create(int fd_output
, int indent
)
388 struct config_writer
*writer
;
389 xmlOutputBufferPtr buffer
;
391 writer
= zmalloc(sizeof(struct config_writer
));
393 PERROR("zmalloc config_writer_create");
397 buffer
= xmlOutputBufferCreateFd(fd_output
, NULL
);
402 writer
->writer
= xmlNewTextWriter(buffer
);
403 ret
= xmlTextWriterStartDocument(writer
->writer
, NULL
,
404 config_xml_encoding
, NULL
);
409 ret
= xmlTextWriterSetIndentString(writer
->writer
,
410 BAD_CAST config_xml_indent_string
);
415 ret
= xmlTextWriterSetIndent(writer
->writer
, indent
);
423 config_writer_destroy(writer
);
428 int config_writer_destroy(struct config_writer
*writer
)
437 if (xmlTextWriterEndDocument(writer
->writer
) < 0) {
438 WARN("Could not close XML document");
442 if (writer
->writer
) {
443 xmlFreeTextWriter(writer
->writer
);
452 int config_writer_open_element(struct config_writer
*writer
,
453 const char *element_name
)
456 xmlChar
*encoded_element_name
;
458 if (!writer
|| !writer
->writer
|| !element_name
|| !element_name
[0]) {
463 encoded_element_name
= encode_string(element_name
);
464 if (!encoded_element_name
) {
469 ret
= xmlTextWriterStartElement(writer
->writer
, encoded_element_name
);
470 xmlFree(encoded_element_name
);
472 return ret
>= 0 ? 0 : ret
;
476 int config_writer_write_attribute(struct config_writer
*writer
,
477 const char *name
, const char *value
)
480 xmlChar
*encoded_name
= NULL
;
481 xmlChar
*encoded_value
= NULL
;
483 if (!writer
|| !writer
->writer
|| !name
|| !name
[0]) {
488 encoded_name
= encode_string(name
);
494 encoded_value
= encode_string(value
);
495 if (!encoded_value
) {
500 ret
= xmlTextWriterWriteAttribute(writer
->writer
, encoded_name
,
503 xmlFree(encoded_name
);
504 xmlFree(encoded_value
);
505 return ret
>= 0 ? 0 : ret
;
509 int config_writer_close_element(struct config_writer
*writer
)
513 if (!writer
|| !writer
->writer
) {
518 ret
= xmlTextWriterEndElement(writer
->writer
);
520 return ret
>= 0 ? 0 : ret
;
524 int config_writer_write_element_unsigned_int(struct config_writer
*writer
,
525 const char *element_name
, uint64_t value
)
528 xmlChar
*encoded_element_name
;
530 if (!writer
|| !writer
->writer
|| !element_name
|| !element_name
[0]) {
535 encoded_element_name
= encode_string(element_name
);
536 if (!encoded_element_name
) {
541 ret
= xmlTextWriterWriteFormatElement(writer
->writer
,
542 encoded_element_name
, "%" PRIu64
, value
);
543 xmlFree(encoded_element_name
);
545 return ret
>= 0 ? 0 : ret
;
549 int config_writer_write_element_signed_int(struct config_writer
*writer
,
550 const char *element_name
, int64_t value
)
553 xmlChar
*encoded_element_name
;
555 if (!writer
|| !writer
->writer
|| !element_name
|| !element_name
[0]) {
560 encoded_element_name
= encode_string(element_name
);
561 if (!encoded_element_name
) {
566 ret
= xmlTextWriterWriteFormatElement(writer
->writer
,
567 encoded_element_name
, "%" PRIi64
, value
);
568 xmlFree(encoded_element_name
);
570 return ret
>= 0 ? 0 : ret
;
574 int config_writer_write_element_bool(struct config_writer
*writer
,
575 const char *element_name
, int value
)
577 return config_writer_write_element_string(writer
, element_name
,
578 value
? config_xml_true
: config_xml_false
);
582 int config_writer_write_element_string(struct config_writer
*writer
,
583 const char *element_name
, const char *value
)
586 xmlChar
*encoded_element_name
= NULL
;
587 xmlChar
*encoded_value
= NULL
;
589 if (!writer
|| !writer
->writer
|| !element_name
|| !element_name
[0] ||
595 encoded_element_name
= encode_string(element_name
);
596 if (!encoded_element_name
) {
601 encoded_value
= encode_string(value
);
602 if (!encoded_value
) {
607 ret
= xmlTextWriterWriteElement(writer
->writer
, encoded_element_name
,
610 xmlFree(encoded_element_name
);
611 xmlFree(encoded_value
);
612 return ret
>= 0 ? 0 : ret
;
616 void xml_error_handler(void *ctx
, const char *format
, ...)
622 va_start(args
, format
);
623 ret
= vasprintf(&errMsg
, format
, args
);
626 ERR("String allocation failed in xml error handler");
630 fprintf(stderr
, "XML Error: %s", errMsg
);
635 void fini_session_config_validation_ctx(
636 struct session_config_validation_ctx
*ctx
)
638 if (ctx
->parser_ctx
) {
639 xmlSchemaFreeParserCtxt(ctx
->parser_ctx
);
643 xmlSchemaFree(ctx
->schema
);
646 if (ctx
->schema_validation_ctx
) {
647 xmlSchemaFreeValidCtxt(ctx
->schema_validation_ctx
);
650 memset(ctx
, 0, sizeof(struct session_config_validation_ctx
));
654 char *get_session_config_xsd_path()
657 const char *base_path
= lttng_secure_getenv(DEFAULT_SESSION_CONFIG_XSD_PATH_ENV
);
658 size_t base_path_len
;
662 base_path
= DEFAULT_SESSION_CONFIG_XSD_PATH
;
665 base_path_len
= strlen(base_path
);
666 max_path_len
= base_path_len
+
667 sizeof(DEFAULT_SESSION_CONFIG_XSD_FILENAME
) + 1;
668 xsd_path
= zmalloc(max_path_len
);
673 strncpy(xsd_path
, base_path
, max_path_len
);
674 if (xsd_path
[base_path_len
- 1] != '/') {
675 xsd_path
[base_path_len
++] = '/';
678 strncpy(xsd_path
+ base_path_len
, DEFAULT_SESSION_CONFIG_XSD_FILENAME
,
679 max_path_len
- base_path_len
);
685 int init_session_config_validation_ctx(
686 struct session_config_validation_ctx
*ctx
)
689 char *xsd_path
= get_session_config_xsd_path();
692 ret
= -LTTNG_ERR_NOMEM
;
696 ctx
->parser_ctx
= xmlSchemaNewParserCtxt(xsd_path
);
697 if (!ctx
->parser_ctx
) {
698 ERR("XSD parser context creation failed");
699 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
702 xmlSchemaSetParserErrors(ctx
->parser_ctx
, xml_error_handler
,
703 xml_error_handler
, NULL
);
705 ctx
->schema
= xmlSchemaParse(ctx
->parser_ctx
);
707 ERR("XSD parsing failed");
708 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
712 ctx
->schema_validation_ctx
= xmlSchemaNewValidCtxt(ctx
->schema
);
713 if (!ctx
->schema_validation_ctx
) {
714 ERR("XSD validation context creation failed");
715 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
719 xmlSchemaSetValidErrors(ctx
->schema_validation_ctx
, xml_error_handler
,
720 xml_error_handler
, NULL
);
725 fini_session_config_validation_ctx(ctx
);
733 int parse_uint(xmlChar
*str
, uint64_t *val
)
743 *val
= strtoull((const char *) str
, &endptr
, 10);
744 if (!endptr
|| *endptr
) {
755 int parse_int(xmlChar
*str
, int64_t *val
)
765 *val
= strtoll((const char *) str
, &endptr
, 10);
766 if (!endptr
|| *endptr
) {
777 int parse_bool(xmlChar
*str
, int *val
)
786 if (!strcmp((const char *) str
, config_xml_true
)) {
788 } else if (!strcmp((const char *) str
, config_xml_false
)) {
791 WARN("Invalid boolean value encoutered (%s).",
800 int get_domain_type(xmlChar
*domain
)
808 if (!strcmp((char *) domain
, config_domain_type_kernel
)) {
809 ret
= LTTNG_DOMAIN_KERNEL
;
810 } else if (!strcmp((char *) domain
, config_domain_type_ust
)) {
811 ret
= LTTNG_DOMAIN_UST
;
812 } else if (!strcmp((char *) domain
, config_domain_type_jul
)) {
813 ret
= LTTNG_DOMAIN_JUL
;
814 } else if (!strcmp((char *) domain
, config_domain_type_log4j
)) {
815 ret
= LTTNG_DOMAIN_LOG4J
;
816 } else if (!strcmp((char *) domain
, config_domain_type_python
)) {
817 ret
= LTTNG_DOMAIN_PYTHON
;
828 int get_buffer_type(xmlChar
*buffer_type
)
836 if (!strcmp((char *) buffer_type
, config_buffer_type_global
)) {
837 ret
= LTTNG_BUFFER_GLOBAL
;
838 } else if (!strcmp((char *) buffer_type
, config_buffer_type_per_uid
)) {
839 ret
= LTTNG_BUFFER_PER_UID
;
840 } else if (!strcmp((char *) buffer_type
, config_buffer_type_per_pid
)) {
841 ret
= LTTNG_BUFFER_PER_PID
;
852 int get_overwrite_mode(xmlChar
*overwrite_mode
)
856 if (!overwrite_mode
) {
860 if (!strcmp((char *) overwrite_mode
, config_overwrite_mode_overwrite
)) {
862 } else if (!strcmp((char *) overwrite_mode
,
863 config_overwrite_mode_discard
)) {
875 int get_output_type(xmlChar
*output_type
)
883 if (!strcmp((char *) output_type
, config_output_type_mmap
)) {
884 ret
= LTTNG_EVENT_MMAP
;
885 } else if (!strcmp((char *) output_type
, config_output_type_splice
)) {
886 ret
= LTTNG_EVENT_SPLICE
;
897 int get_event_type(xmlChar
*event_type
)
905 if (!strcmp((char *) event_type
, config_event_type_all
)) {
906 ret
= LTTNG_EVENT_ALL
;
907 } else if (!strcmp((char *) event_type
, config_event_type_tracepoint
)) {
908 ret
= LTTNG_EVENT_TRACEPOINT
;
909 } else if (!strcmp((char *) event_type
, config_event_type_probe
)) {
910 ret
= LTTNG_EVENT_PROBE
;
911 } else if (!strcmp((char *) event_type
, config_event_type_function
)) {
912 ret
= LTTNG_EVENT_FUNCTION
;
913 } else if (!strcmp((char *) event_type
,
914 config_event_type_function_entry
)) {
915 ret
= LTTNG_EVENT_FUNCTION_ENTRY
;
916 } else if (!strcmp((char *) event_type
, config_event_type_noop
)) {
917 ret
= LTTNG_EVENT_NOOP
;
918 } else if (!strcmp((char *) event_type
, config_event_type_syscall
)) {
919 ret
= LTTNG_EVENT_SYSCALL
;
930 int get_loglevel_type(xmlChar
*loglevel_type
)
934 if (!loglevel_type
) {
938 if (!strcmp((char *) loglevel_type
, config_loglevel_type_all
)) {
939 ret
= LTTNG_EVENT_LOGLEVEL_ALL
;
940 } else if (!strcmp((char *) loglevel_type
,
941 config_loglevel_type_range
)) {
942 ret
= LTTNG_EVENT_LOGLEVEL_RANGE
;
943 } else if (!strcmp((char *) loglevel_type
,
944 config_loglevel_type_single
)) {
945 ret
= LTTNG_EVENT_LOGLEVEL_SINGLE
;
956 * Return the context type or -1 on error.
959 int get_context_type(xmlChar
*context_type
)
967 if (!strcmp((char *) context_type
, config_event_context_pid
)) {
968 ret
= LTTNG_EVENT_CONTEXT_PID
;
969 } else if (!strcmp((char *) context_type
,
970 config_event_context_procname
)) {
971 ret
= LTTNG_EVENT_CONTEXT_PROCNAME
;
972 } else if (!strcmp((char *) context_type
,
973 config_event_context_prio
)) {
974 ret
= LTTNG_EVENT_CONTEXT_PRIO
;
975 } else if (!strcmp((char *) context_type
,
976 config_event_context_nice
)) {
977 ret
= LTTNG_EVENT_CONTEXT_NICE
;
978 } else if (!strcmp((char *) context_type
,
979 config_event_context_vpid
)) {
980 ret
= LTTNG_EVENT_CONTEXT_VPID
;
981 } else if (!strcmp((char *) context_type
,
982 config_event_context_tid
)) {
983 ret
= LTTNG_EVENT_CONTEXT_TID
;
984 } else if (!strcmp((char *) context_type
,
985 config_event_context_vtid
)) {
986 ret
= LTTNG_EVENT_CONTEXT_VTID
;
987 } else if (!strcmp((char *) context_type
,
988 config_event_context_ppid
)) {
989 ret
= LTTNG_EVENT_CONTEXT_PPID
;
990 } else if (!strcmp((char *) context_type
,
991 config_event_context_vppid
)) {
992 ret
= LTTNG_EVENT_CONTEXT_VPPID
;
993 } else if (!strcmp((char *) context_type
,
994 config_event_context_pthread_id
)) {
995 ret
= LTTNG_EVENT_CONTEXT_PTHREAD_ID
;
996 } else if (!strcmp((char *) context_type
,
997 config_event_context_hostname
)) {
998 ret
= LTTNG_EVENT_CONTEXT_HOSTNAME
;
999 } else if (!strcmp((char *) context_type
,
1000 config_event_context_ip
)) {
1001 ret
= LTTNG_EVENT_CONTEXT_IP
;
1002 } else if (!strcmp((char *) context_type
,
1003 config_event_context_interruptible
)) {
1004 ret
= LTTNG_EVENT_CONTEXT_INTERRUPTIBLE
;
1005 } else if (!strcmp((char *) context_type
,
1006 config_event_context_preemptible
)) {
1007 ret
= LTTNG_EVENT_CONTEXT_PREEMPTIBLE
;
1008 } else if (!strcmp((char *) context_type
,
1009 config_event_context_need_reschedule
)) {
1010 ret
= LTTNG_EVENT_CONTEXT_NEED_RESCHEDULE
;
1011 } else if (!strcmp((char *) context_type
,
1012 config_event_context_migratable
)) {
1013 ret
= LTTNG_EVENT_CONTEXT_MIGRATABLE
;
1024 int init_domain(xmlNodePtr domain_node
, struct lttng_domain
*domain
)
1029 for (node
= xmlFirstElementChild(domain_node
); node
;
1030 node
= xmlNextElementSibling(node
)) {
1031 if (!strcmp((const char *) node
->name
, config_element_type
)) {
1033 xmlChar
*node_content
= xmlNodeGetContent(node
);
1034 if (!node_content
) {
1035 ret
= -LTTNG_ERR_NOMEM
;
1039 ret
= get_domain_type(node_content
);
1042 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1047 } else if (!strcmp((const char *) node
->name
,
1048 config_element_buffer_type
)) {
1050 xmlChar
*node_content
= xmlNodeGetContent(node
);
1051 if (!node_content
) {
1052 ret
= -LTTNG_ERR_NOMEM
;
1056 ret
= get_buffer_type(node_content
);
1059 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1063 domain
->buf_type
= ret
;
1072 int get_net_output_uris(xmlNodePtr net_output_node
, char **control_uri
,
1077 for (node
= xmlFirstElementChild(net_output_node
); node
;
1078 node
= xmlNextElementSibling(node
)) {
1079 if (!strcmp((const char *) node
->name
, config_element_control_uri
)) {
1081 *control_uri
= (char *) xmlNodeGetContent(node
);
1082 if (!*control_uri
) {
1087 *data_uri
= (char *) xmlNodeGetContent(node
);
1094 return *control_uri
|| *data_uri
? 0 : -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1098 int process_consumer_output(xmlNodePtr consumer_output_node
,
1099 struct consumer_output
*output
)
1106 for (node
= xmlFirstElementChild(consumer_output_node
); node
;
1107 node
= xmlNextElementSibling(node
)) {
1108 if (!strcmp((const char *) node
->name
, config_element_enabled
)) {
1109 xmlChar
*enabled_str
= xmlNodeGetContent(node
);
1113 ret
= -LTTNG_ERR_NOMEM
;
1117 ret
= parse_bool(enabled_str
, &output
->enabled
);
1123 xmlNodePtr output_type_node
;
1126 output_type_node
= xmlFirstElementChild(node
);
1127 if (!output_type_node
) {
1128 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1132 if (!strcmp((const char *) output_type_node
->name
,
1133 config_element_path
)) {
1135 output
->path
= (char *) xmlNodeGetContent(output_type_node
);
1136 if (!output
->path
) {
1137 ret
= -LTTNG_ERR_NOMEM
;
1142 ret
= get_net_output_uris(output_type_node
,
1143 &output
->control_uri
, &output
->data_uri
);
1155 free(output
->control_uri
);
1156 free(output
->data_uri
);
1157 memset(output
, 0, sizeof(struct consumer_output
));
1163 int create_session_net_output(const char *name
, const char *control_uri
,
1164 const char *data_uri
)
1167 struct lttng_handle
*handle
;
1168 const char *uri
= NULL
;
1172 handle
= lttng_create_handle(name
, NULL
);
1174 ret
= -LTTNG_ERR_NOMEM
;
1178 if (!control_uri
|| !data_uri
) {
1179 uri
= control_uri
? control_uri
: data_uri
;
1184 ret
= lttng_set_consumer_url(handle
, control_uri
, data_uri
);
1185 lttng_destroy_handle(handle
);
1191 int create_snapshot_session(const char *session_name
, xmlNodePtr output_node
)
1194 xmlNodePtr node
= NULL
;
1195 xmlNodePtr snapshot_output_list_node
;
1196 xmlNodePtr snapshot_output_node
;
1198 assert(session_name
);
1200 ret
= lttng_create_session_snapshot(session_name
, NULL
);
1209 snapshot_output_list_node
= xmlFirstElementChild(output_node
);
1211 /* Parse and create snapshot outputs */
1213 for (snapshot_output_node
=
1214 xmlFirstElementChild(snapshot_output_list_node
);
1215 snapshot_output_node
; snapshot_output_node
=
1216 xmlNextElementSibling(snapshot_output_node
)) {
1218 uint64_t max_size
= UINT64_MAX
;
1219 struct consumer_output output
= { 0 };
1220 struct lttng_snapshot_output
*snapshot_output
= NULL
;
1222 for (node
= xmlFirstElementChild(snapshot_output_node
); node
;
1223 node
= xmlNextElementSibling(node
)) {
1224 if (!strcmp((const char *) node
->name
,
1225 config_element_name
)) {
1227 name
= (char *) xmlNodeGetContent(node
);
1229 ret
= -LTTNG_ERR_NOMEM
;
1230 goto error_snapshot_output
;
1232 } else if (!strcmp((const char *) node
->name
,
1233 config_element_max_size
)) {
1234 xmlChar
*content
= xmlNodeGetContent(node
);
1238 ret
= -LTTNG_ERR_NOMEM
;
1239 goto error_snapshot_output
;
1241 ret
= parse_uint(content
, &max_size
);
1244 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1245 goto error_snapshot_output
;
1248 /* consumer_output */
1249 ret
= process_consumer_output(node
, &output
);
1251 goto error_snapshot_output
;
1256 snapshot_output
= lttng_snapshot_output_create();
1257 if (!snapshot_output
) {
1258 ret
= -LTTNG_ERR_NOMEM
;
1259 goto error_snapshot_output
;
1262 ret
= lttng_snapshot_output_set_name(name
, snapshot_output
);
1264 goto error_snapshot_output
;
1267 ret
= lttng_snapshot_output_set_size(max_size
, snapshot_output
);
1269 goto error_snapshot_output
;
1273 ret
= lttng_snapshot_output_set_ctrl_url(output
.path
,
1276 goto error_snapshot_output
;
1279 if (output
.control_uri
) {
1280 ret
= lttng_snapshot_output_set_ctrl_url(output
.control_uri
,
1283 goto error_snapshot_output
;
1287 if (output
.data_uri
) {
1288 ret
= lttng_snapshot_output_set_data_url(output
.data_uri
,
1291 goto error_snapshot_output
;
1296 ret
= lttng_snapshot_add_output(session_name
, snapshot_output
);
1297 error_snapshot_output
:
1300 free(output
.control_uri
);
1301 free(output
.data_uri
);
1302 lttng_snapshot_output_destroy(snapshot_output
);
1312 int create_session(const char *name
,
1313 struct lttng_domain
*kernel_domain
,
1314 struct lttng_domain
*ust_domain
,
1315 struct lttng_domain
*jul_domain
,
1316 struct lttng_domain
*log4j_domain
,
1317 xmlNodePtr output_node
,
1318 uint64_t live_timer_interval
)
1321 struct consumer_output output
= { 0 };
1322 xmlNodePtr consumer_output_node
;
1327 consumer_output_node
= xmlFirstElementChild(output_node
);
1328 if (!consumer_output_node
) {
1329 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1333 if (strcmp((const char *) consumer_output_node
->name
,
1334 config_element_consumer_output
)) {
1335 WARN("Invalid output type, expected %s node",
1336 config_element_consumer_output
);
1337 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1341 ret
= process_consumer_output(consumer_output_node
, &output
);
1347 if (live_timer_interval
!= UINT64_MAX
&&
1348 !output
.control_uri
&& !output
.data_uri
) {
1349 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1353 if (output
.control_uri
|| output
.data_uri
) {
1354 /* network destination */
1355 if (live_timer_interval
&& live_timer_interval
!= UINT64_MAX
) {
1357 * URLs are provided for sure since the test above make sure that
1358 * with a live timer the data and control URIs are provided. So,
1359 * NULL is passed here and will be set right after.
1361 ret
= lttng_create_session_live(name
, NULL
, live_timer_interval
);
1363 ret
= lttng_create_session(name
, NULL
);
1369 ret
= create_session_net_output(name
, output
.control_uri
,
1376 /* either local output or no output */
1377 ret
= lttng_create_session(name
, output
.path
);
1384 free(output
.control_uri
);
1385 free(output
.data_uri
);
1389 int process_probe_attribute_node(xmlNodePtr probe_attribute_node
,
1390 struct lttng_event_probe_attr
*attr
)
1394 assert(probe_attribute_node
);
1397 if (!strcmp((const char *) probe_attribute_node
->name
,
1398 config_element_address
)) {
1403 content
= xmlNodeGetContent(probe_attribute_node
);
1405 ret
= -LTTNG_ERR_NOMEM
;
1409 ret
= parse_uint(content
, &addr
);
1412 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1417 } else if (!strcmp((const char *) probe_attribute_node
->name
,
1418 config_element_offset
)) {
1420 uint64_t offset
= 0;
1423 content
= xmlNodeGetContent(probe_attribute_node
);
1425 ret
= -LTTNG_ERR_NOMEM
;
1429 ret
= parse_uint(content
, &offset
);
1432 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1436 attr
->offset
= offset
;
1437 } else if (!strcmp((const char *) probe_attribute_node
->name
,
1438 config_element_symbol_name
)) {
1443 content
= xmlNodeGetContent(probe_attribute_node
);
1445 ret
= -LTTNG_ERR_NOMEM
;
1449 name_len
= strlen((char *) content
);
1450 if (name_len
>= LTTNG_SYMBOL_NAME_LEN
) {
1451 WARN("symbol_name too long.");
1452 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1457 strncpy(attr
->symbol_name
, (const char *) content
, name_len
);
1466 int process_event_node(xmlNodePtr event_node
, struct lttng_handle
*handle
,
1467 const char *channel_name
, const enum process_event_node_phase phase
)
1471 struct lttng_event event
;
1472 char **exclusions
= NULL
;
1473 unsigned long exclusion_count
= 0;
1474 char *filter_expression
= NULL
;
1478 assert(channel_name
);
1480 memset(&event
, 0, sizeof(event
));
1482 /* Initialize default log level which varies by domain */
1483 switch (handle
->domain
.type
)
1485 case LTTNG_DOMAIN_JUL
:
1486 event
.loglevel
= LTTNG_LOGLEVEL_JUL_ALL
;
1488 case LTTNG_DOMAIN_LOG4J
:
1489 event
.loglevel
= LTTNG_LOGLEVEL_LOG4J_ALL
;
1491 case LTTNG_DOMAIN_PYTHON
:
1492 event
.loglevel
= LTTNG_LOGLEVEL_PYTHON_DEBUG
;
1494 case LTTNG_DOMAIN_UST
:
1495 case LTTNG_DOMAIN_KERNEL
:
1496 event
.loglevel
= LTTNG_LOGLEVEL_DEBUG
;
1502 for (node
= xmlFirstElementChild(event_node
); node
;
1503 node
= xmlNextElementSibling(node
)) {
1504 if (!strcmp((const char *) node
->name
, config_element_name
)) {
1509 content
= xmlNodeGetContent(node
);
1511 ret
= -LTTNG_ERR_NOMEM
;
1515 name_len
= strlen((char *) content
);
1516 if (name_len
>= LTTNG_SYMBOL_NAME_LEN
) {
1517 WARN("Channel name too long.");
1518 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1523 strncpy(event
.name
, (const char *) content
, name_len
);
1525 } else if (!strcmp((const char *) node
->name
,
1526 config_element_enabled
)) {
1527 xmlChar
*content
= xmlNodeGetContent(node
);
1531 ret
= -LTTNG_ERR_NOMEM
;
1535 ret
= parse_bool(content
, &event
.enabled
);
1538 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1541 } else if (!strcmp((const char *) node
->name
,
1542 config_element_type
)) {
1543 xmlChar
*content
= xmlNodeGetContent(node
);
1547 ret
= -LTTNG_ERR_NOMEM
;
1551 ret
= get_event_type(content
);
1554 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1559 } else if (!strcmp((const char *) node
->name
,
1560 config_element_loglevel_type
)) {
1561 xmlChar
*content
= xmlNodeGetContent(node
);
1565 ret
= -LTTNG_ERR_NOMEM
;
1569 ret
= get_loglevel_type(content
);
1572 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1576 event
.loglevel_type
= ret
;
1577 } else if (!strcmp((const char *) node
->name
,
1578 config_element_loglevel
)) {
1580 int64_t loglevel
= 0;
1583 content
= xmlNodeGetContent(node
);
1585 ret
= -LTTNG_ERR_NOMEM
;
1589 ret
= parse_int(content
, &loglevel
);
1592 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1596 if (loglevel
> INT_MAX
|| loglevel
< INT_MIN
) {
1597 WARN("loglevel out of range.");
1598 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1602 event
.loglevel
= loglevel
;
1603 } else if (!strcmp((const char *) node
->name
,
1604 config_element_filter
)) {
1606 xmlNodeGetContent(node
);
1610 ret
= -LTTNG_ERR_NOMEM
;
1614 filter_expression
= strdup((char *) content
);
1616 if (!filter_expression
) {
1617 ret
= -LTTNG_ERR_NOMEM
;
1620 } else if (!strcmp((const char *) node
->name
,
1621 config_element_exclusions
)) {
1622 xmlNodePtr exclusion_node
;
1623 int exclusion_index
= 0;
1628 * Exclusions has already been initialized,
1631 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1635 exclusion_count
= xmlChildElementCount(node
);
1636 if (!exclusion_count
) {
1640 exclusions
= zmalloc(exclusion_count
* sizeof(char *));
1642 exclusion_count
= 0;
1643 ret
= -LTTNG_ERR_NOMEM
;
1647 for (exclusion_node
= xmlFirstElementChild(node
); exclusion_node
;
1648 exclusion_node
= xmlNextElementSibling(exclusion_node
)) {
1650 xmlNodeGetContent(exclusion_node
);
1653 ret
= -LTTNG_ERR_NOMEM
;
1657 exclusions
[exclusion_index
] = strdup((const char *) content
);
1659 if (!exclusions
[exclusion_index
]) {
1660 ret
= -LTTNG_ERR_NOMEM
;
1666 event
.exclusion
= 1;
1667 } else if (!strcmp((const char *) node
->name
,
1668 config_element_attributes
)) {
1669 xmlNodePtr attribute_node
= xmlFirstElementChild(node
);
1672 if (!attribute_node
) {
1673 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1677 if (!strcmp((const char *) node
->name
,
1678 config_element_probe_attributes
)) {
1679 xmlNodePtr probe_attribute_node
;
1681 /* probe_attributes */
1682 for (probe_attribute_node
=
1683 xmlFirstElementChild(attribute_node
); probe_attribute_node
;
1684 probe_attribute_node
= xmlNextElementSibling(
1685 probe_attribute_node
)) {
1687 ret
= process_probe_attribute_node(probe_attribute_node
,
1696 xmlNodePtr symbol_node
= xmlFirstElementChild(attribute_node
);
1698 /* function_attributes */
1699 content
= xmlNodeGetContent(symbol_node
);
1701 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1705 sym_len
= strlen((char *) content
);
1706 if (sym_len
>= LTTNG_SYMBOL_NAME_LEN
) {
1707 WARN("Function name too long.");
1708 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1713 strncpy(event
.attr
.ftrace
.symbol_name
, (char *) content
,
1720 if ((event
.enabled
&& phase
== ENABLE
) || phase
== CREATION
) {
1721 ret
= lttng_enable_event_with_exclusions(handle
, &event
, channel_name
,
1722 filter_expression
, exclusion_count
, exclusions
);
1724 WARN("Enabling event (name:%s) on load failed.", event
.name
);
1725 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1730 for (i
= 0; i
< exclusion_count
; i
++) {
1731 free(exclusions
[i
]);
1735 free(filter_expression
);
1740 int process_events_node(xmlNodePtr events_node
, struct lttng_handle
*handle
,
1741 const char *channel_name
)
1744 struct lttng_event event
;
1747 assert(events_node
);
1749 assert(channel_name
);
1751 for (node
= xmlFirstElementChild(events_node
); node
;
1752 node
= xmlNextElementSibling(node
)) {
1753 ret
= process_event_node(node
, handle
, channel_name
, CREATION
);
1760 * Disable all events to enable only the necessary events.
1761 * Limitations regarding lttng_disable_events and tuple descriptor
1762 * force this approach.
1764 memset(&event
, 0, sizeof(event
));
1765 event
.loglevel
= -1;
1766 event
.type
= LTTNG_EVENT_ALL
;
1767 ret
= lttng_disable_event_ext(handle
, &event
, channel_name
, NULL
);
1772 for (node
= xmlFirstElementChild(events_node
); node
;
1773 node
= xmlNextElementSibling(node
)) {
1774 ret
= process_event_node(node
, handle
, channel_name
, ENABLE
);
1785 int process_channel_attr_node(xmlNodePtr attr_node
,
1786 struct lttng_channel
*channel
, xmlNodePtr
*contexts_node
,
1787 xmlNodePtr
*events_node
)
1793 assert(contexts_node
);
1794 assert(events_node
);
1796 if (!strcmp((const char *) attr_node
->name
, config_element_name
)) {
1801 content
= xmlNodeGetContent(attr_node
);
1803 ret
= -LTTNG_ERR_NOMEM
;
1807 name_len
= strlen((char *) content
);
1808 if (name_len
>= LTTNG_SYMBOL_NAME_LEN
) {
1809 WARN("Channel name too long.");
1810 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1815 strncpy(channel
->name
, (const char *) content
, name_len
);
1817 } else if (!strcmp((const char *) attr_node
->name
,
1818 config_element_enabled
)) {
1823 content
= xmlNodeGetContent(attr_node
);
1825 ret
= -LTTNG_ERR_NOMEM
;
1829 ret
= parse_bool(content
, &enabled
);
1832 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1836 channel
->enabled
= enabled
;
1837 } else if (!strcmp((const char *) attr_node
->name
,
1838 config_element_overwrite_mode
)) {
1841 /* overwrite_mode */
1842 content
= xmlNodeGetContent(attr_node
);
1844 ret
= -LTTNG_ERR_NOMEM
;
1848 ret
= get_overwrite_mode(content
);
1851 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1855 channel
->attr
.overwrite
= ret
;
1856 } else if (!strcmp((const char *) attr_node
->name
,
1857 config_element_subbuf_size
)) {
1860 /* subbuffer_size */
1861 content
= xmlNodeGetContent(attr_node
);
1863 ret
= -LTTNG_ERR_NOMEM
;
1867 ret
= parse_uint(content
, &channel
->attr
.subbuf_size
);
1870 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1873 } else if (!strcmp((const char *) attr_node
->name
,
1874 config_element_num_subbuf
)) {
1877 /* subbuffer_count */
1878 content
= xmlNodeGetContent(attr_node
);
1880 ret
= -LTTNG_ERR_NOMEM
;
1884 ret
= parse_uint(content
, &channel
->attr
.num_subbuf
);
1887 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1890 } else if (!strcmp((const char *) attr_node
->name
,
1891 config_element_switch_timer_interval
)) {
1893 uint64_t switch_timer_interval
= 0;
1895 /* switch_timer_interval */
1896 content
= xmlNodeGetContent(attr_node
);
1898 ret
= -LTTNG_ERR_NOMEM
;
1902 ret
= parse_uint(content
, &switch_timer_interval
);
1905 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1909 if (switch_timer_interval
> UINT_MAX
) {
1910 WARN("switch_timer_interval out of range.");
1911 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1915 channel
->attr
.switch_timer_interval
=
1916 switch_timer_interval
;
1917 } else if (!strcmp((const char *) attr_node
->name
,
1918 config_element_read_timer_interval
)) {
1920 uint64_t read_timer_interval
= 0;
1922 /* read_timer_interval */
1923 content
= xmlNodeGetContent(attr_node
);
1925 ret
= -LTTNG_ERR_NOMEM
;
1929 ret
= parse_uint(content
, &read_timer_interval
);
1932 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1936 if (read_timer_interval
> UINT_MAX
) {
1937 WARN("read_timer_interval out of range.");
1938 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1942 channel
->attr
.read_timer_interval
=
1943 read_timer_interval
;
1944 } else if (!strcmp((const char *) attr_node
->name
,
1945 config_element_output_type
)) {
1949 content
= xmlNodeGetContent(attr_node
);
1951 ret
= -LTTNG_ERR_NOMEM
;
1955 ret
= get_output_type(content
);
1958 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1962 channel
->attr
.output
= ret
;
1963 } else if (!strcmp((const char *) attr_node
->name
,
1964 config_element_tracefile_size
)) {
1967 /* tracefile_size */
1968 content
= xmlNodeGetContent(attr_node
);
1970 ret
= -LTTNG_ERR_NOMEM
;
1974 ret
= parse_uint(content
, &channel
->attr
.tracefile_size
);
1977 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1980 } else if (!strcmp((const char *) attr_node
->name
,
1981 config_element_tracefile_count
)) {
1984 /* tracefile_count */
1985 content
= xmlNodeGetContent(attr_node
);
1987 ret
= -LTTNG_ERR_NOMEM
;
1991 ret
= parse_uint(content
, &channel
->attr
.tracefile_count
);
1994 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
1997 } else if (!strcmp((const char *) attr_node
->name
,
1998 config_element_live_timer_interval
)) {
2000 uint64_t live_timer_interval
= 0;
2002 /* live_timer_interval */
2003 content
= xmlNodeGetContent(attr_node
);
2005 ret
= -LTTNG_ERR_NOMEM
;
2009 ret
= parse_uint(content
, &live_timer_interval
);
2012 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2016 if (live_timer_interval
> UINT_MAX
) {
2017 WARN("live_timer_interval out of range.");
2018 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2022 channel
->attr
.live_timer_interval
=
2023 live_timer_interval
;
2024 } else if (!strcmp((const char *) attr_node
->name
,
2025 config_element_events
)) {
2027 *events_node
= attr_node
;
2030 *contexts_node
= attr_node
;
2038 int process_context_node(xmlNodePtr context_node
,
2039 struct lttng_handle
*handle
, const char *channel_name
)
2042 struct lttng_event_context context
;
2043 xmlNodePtr context_child_node
= xmlFirstElementChild(context_node
);
2046 assert(channel_name
);
2048 if (!context_child_node
) {
2049 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2053 memset(&context
, 0, sizeof(context
));
2055 if (!strcmp((const char *) context_child_node
->name
,
2056 config_element_type
)) {
2058 xmlChar
*content
= xmlNodeGetContent(context_child_node
);
2061 ret
= -LTTNG_ERR_NOMEM
;
2065 ret
= get_context_type(content
);
2068 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2073 } else if (!strcmp((const char *) context_child_node
->name
,
2074 config_element_context_perf
)) {
2076 xmlNodePtr perf_attr_node
;
2078 context
.ctx
= handle
->domain
.type
== LTTNG_DOMAIN_KERNEL
?
2079 LTTNG_EVENT_CONTEXT_PERF_CPU_COUNTER
:
2080 LTTNG_EVENT_CONTEXT_PERF_THREAD_COUNTER
;
2081 for (perf_attr_node
= xmlFirstElementChild(context_child_node
);
2082 perf_attr_node
; perf_attr_node
=
2083 xmlNextElementSibling(perf_attr_node
)) {
2084 if (!strcmp((const char *) perf_attr_node
->name
,
2085 config_element_type
)) {
2090 content
= xmlNodeGetContent(perf_attr_node
);
2092 ret
= -LTTNG_ERR_NOMEM
;
2096 ret
= parse_uint(content
, &type
);
2099 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2103 if (type
> UINT32_MAX
) {
2104 WARN("perf context type out of range.");
2105 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2109 context
.u
.perf_counter
.type
= type
;
2110 } else if (!strcmp((const char *) perf_attr_node
->name
,
2111 config_element_config
)) {
2113 uint64_t config
= 0;
2116 content
= xmlNodeGetContent(perf_attr_node
);
2118 ret
= -LTTNG_ERR_NOMEM
;
2122 ret
= parse_uint(content
, &config
);
2125 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2129 context
.u
.perf_counter
.config
= config
;
2130 } else if (!strcmp((const char *) perf_attr_node
->name
,
2131 config_element_name
)) {
2136 content
= xmlNodeGetContent(perf_attr_node
);
2138 ret
= -LTTNG_ERR_NOMEM
;
2142 name_len
= strlen((char *) content
);
2143 if (name_len
>= LTTNG_SYMBOL_NAME_LEN
) {
2144 WARN("perf context name too long.");
2145 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2150 strncpy(context
.u
.perf_counter
.name
, (const char *) content
,
2155 } else if (!strcmp((const char *) context_child_node
->name
,
2156 config_element_context_app
)) {
2157 /* application context */
2158 xmlNodePtr app_ctx_node
;
2160 context
.ctx
= LTTNG_EVENT_CONTEXT_APP_CONTEXT
;
2161 for (app_ctx_node
= xmlFirstElementChild(context_child_node
);
2162 app_ctx_node
; app_ctx_node
=
2163 xmlNextElementSibling(app_ctx_node
)) {
2165 char **target
= strcmp(
2166 (const char *) app_ctx_node
->name
,
2167 config_element_context_app_provider_name
) == 0 ?
2168 &context
.u
.app_ctx
.provider_name
:
2169 &context
.u
.app_ctx
.ctx_name
;
2171 content
= xmlNodeGetContent(app_ctx_node
);
2173 ret
= -LTTNG_ERR_NOMEM
;
2177 *target
= (char *) content
;
2180 /* Unrecognized context type */
2181 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2185 ret
= lttng_add_context(handle
, &context
, NULL
, channel_name
);
2186 if (context
.ctx
== LTTNG_EVENT_CONTEXT_APP_CONTEXT
) {
2187 free(context
.u
.app_ctx
.provider_name
);
2188 free(context
.u
.app_ctx
.ctx_name
);
2195 int process_contexts_node(xmlNodePtr contexts_node
,
2196 struct lttng_handle
*handle
, const char *channel_name
)
2199 xmlNodePtr context_node
;
2201 for (context_node
= xmlFirstElementChild(contexts_node
); context_node
;
2202 context_node
= xmlNextElementSibling(context_node
)) {
2203 ret
= process_context_node(context_node
, handle
, channel_name
);
2213 int process_pid_tracker_node(xmlNodePtr pid_tracker_node
,
2214 struct lttng_handle
*handle
)
2217 xmlNodePtr targets_node
= NULL
;
2221 assert(pid_tracker_node
);
2222 /* get the targets node */
2223 for (node
= xmlFirstElementChild(pid_tracker_node
); node
;
2224 node
= xmlNextElementSibling(node
)) {
2225 if (!strcmp((const char *) node
->name
,
2226 config_element_targets
)) {
2227 targets_node
= node
;
2232 if (!targets_node
) {
2233 ret
= LTTNG_ERR_INVALID
;
2237 /* Go through all pid_target node */
2238 child
= xmlChildElementCount(targets_node
);
2240 /* The session is explicitly set to target nothing. */
2241 ret
= lttng_untrack_pid(handle
, -1);
2246 for (node
= xmlFirstElementChild(targets_node
); node
;
2247 node
= xmlNextElementSibling(node
)) {
2248 xmlNodePtr pid_target_node
= node
;
2250 /* get pid node and track it */
2251 for (node
= xmlFirstElementChild(pid_target_node
); node
;
2252 node
= xmlNextElementSibling(node
)) {
2253 if (!strcmp((const char *) node
->name
,
2254 config_element_pid
)) {
2256 xmlChar
*content
= NULL
;
2258 content
= xmlNodeGetContent(node
);
2260 ret
= LTTNG_ERR_LOAD_INVALID_CONFIG
;
2264 ret
= parse_int(content
, &pid
);
2267 ret
= LTTNG_ERR_LOAD_INVALID_CONFIG
;
2271 ret
= lttng_track_pid(handle
, (int) pid
);
2277 node
= pid_target_node
;
2286 int process_domain_node(xmlNodePtr domain_node
, const char *session_name
)
2289 struct lttng_domain domain
= { 0 };
2290 struct lttng_handle
*handle
= NULL
;
2291 xmlNodePtr channels_node
= NULL
;
2292 xmlNodePtr trackers_node
= NULL
;
2293 xmlNodePtr pid_tracker_node
= NULL
;
2296 assert(session_name
);
2298 ret
= init_domain(domain_node
, &domain
);
2303 handle
= lttng_create_handle(session_name
, &domain
);
2305 ret
= -LTTNG_ERR_NOMEM
;
2309 /* get the channels node */
2310 for (node
= xmlFirstElementChild(domain_node
); node
;
2311 node
= xmlNextElementSibling(node
)) {
2312 if (!strcmp((const char *) node
->name
,
2313 config_element_channels
)) {
2314 channels_node
= node
;
2319 if (!channels_node
) {
2323 /* create all channels */
2324 for (node
= xmlFirstElementChild(channels_node
); node
;
2325 node
= xmlNextElementSibling(node
)) {
2326 struct lttng_channel channel
;
2327 xmlNodePtr contexts_node
= NULL
;
2328 xmlNodePtr events_node
= NULL
;
2329 xmlNodePtr channel_attr_node
;
2331 memset(&channel
, 0, sizeof(channel
));
2332 lttng_channel_set_default_attr(&domain
, &channel
.attr
);
2334 for (channel_attr_node
= xmlFirstElementChild(node
);
2335 channel_attr_node
; channel_attr_node
=
2336 xmlNextElementSibling(channel_attr_node
)) {
2337 ret
= process_channel_attr_node(channel_attr_node
,
2338 &channel
, &contexts_node
, &events_node
);
2344 ret
= lttng_enable_channel(handle
, &channel
);
2349 ret
= process_events_node(events_node
, handle
, channel
.name
);
2354 ret
= process_contexts_node(contexts_node
, handle
,
2361 /* get the trackers node */
2362 for (node
= xmlFirstElementChild(domain_node
); node
;
2363 node
= xmlNextElementSibling(node
)) {
2364 if (!strcmp((const char *) node
->name
,
2365 config_element_trackers
)) {
2366 trackers_node
= node
;
2371 if (!trackers_node
) {
2375 for (node
= xmlFirstElementChild(trackers_node
); node
;
2376 node
= xmlNextElementSibling(node
)) {
2377 if (!strcmp((const char *)node
->name
,config_element_pid_tracker
)) {
2378 pid_tracker_node
= node
;
2379 ret
= process_pid_tracker_node(pid_tracker_node
, handle
);
2386 if (!pid_tracker_node
) {
2387 lttng_track_pid(handle
, -1);
2391 lttng_destroy_handle(handle
);
2396 int process_session_node(xmlNodePtr session_node
, const char *session_name
,
2399 int ret
, started
= -1, snapshot_mode
= -1;
2400 uint64_t live_timer_interval
= UINT64_MAX
;
2401 xmlChar
*name
= NULL
;
2402 xmlChar
*shm_path
= NULL
;
2403 xmlNodePtr domains_node
= NULL
;
2404 xmlNodePtr output_node
= NULL
;
2406 struct lttng_domain
*kernel_domain
= NULL
;
2407 struct lttng_domain
*ust_domain
= NULL
;
2408 struct lttng_domain
*jul_domain
= NULL
;
2409 struct lttng_domain
*log4j_domain
= NULL
;
2410 struct lttng_domain
*python_domain
= NULL
;
2412 for (node
= xmlFirstElementChild(session_node
); node
;
2413 node
= xmlNextElementSibling(node
)) {
2414 if (!name
&& !strcmp((const char *) node
->name
,
2415 config_element_name
)) {
2417 xmlChar
*node_content
= xmlNodeGetContent(node
);
2418 if (!node_content
) {
2419 ret
= -LTTNG_ERR_NOMEM
;
2423 name
= node_content
;
2424 } else if (!domains_node
&& !strcmp((const char *) node
->name
,
2425 config_element_domains
)) {
2427 domains_node
= node
;
2428 } else if (started
== -1 && !strcmp((const char *) node
->name
,
2429 config_element_started
)) {
2431 xmlChar
*node_content
= xmlNodeGetContent(node
);
2432 if (!node_content
) {
2433 ret
= -LTTNG_ERR_NOMEM
;
2437 ret
= parse_bool(node_content
, &started
);
2440 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2443 } else if (!output_node
&& !strcmp((const char *) node
->name
,
2444 config_element_output
)) {
2447 } else if (!shm_path
&& !strcmp((const char *) node
->name
,
2448 config_element_shared_memory_path
)) {
2449 /* shared memory path */
2450 xmlChar
*node_content
= xmlNodeGetContent(node
);
2451 if (!node_content
) {
2452 ret
= -LTTNG_ERR_NOMEM
;
2456 shm_path
= node_content
;
2458 /* attributes, snapshot_mode or live_timer_interval */
2459 xmlNodePtr attributes_child
=
2460 xmlFirstElementChild(node
);
2462 if (!strcmp((const char *) attributes_child
->name
,
2463 config_element_snapshot_mode
)) {
2465 xmlChar
*snapshot_mode_content
=
2466 xmlNodeGetContent(attributes_child
);
2467 if (!snapshot_mode_content
) {
2468 ret
= -LTTNG_ERR_NOMEM
;
2472 ret
= parse_bool(snapshot_mode_content
, &snapshot_mode
);
2473 free(snapshot_mode_content
);
2475 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2479 /* live_timer_interval */
2480 xmlChar
*timer_interval_content
=
2481 xmlNodeGetContent(attributes_child
);
2482 if (!timer_interval_content
) {
2483 ret
= -LTTNG_ERR_NOMEM
;
2487 ret
= parse_uint(timer_interval_content
, &live_timer_interval
);
2488 free(timer_interval_content
);
2490 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2498 /* Mandatory attribute, as defined in the session XSD */
2499 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2503 if (session_name
&& strcmp((char *) name
, session_name
)) {
2504 /* This is not the session we are looking for */
2505 ret
= -LTTNG_ERR_NO_SESSION
;
2509 /* Init domains to create the session handles */
2510 for (node
= xmlFirstElementChild(domains_node
); node
;
2511 node
= xmlNextElementSibling(node
)) {
2512 struct lttng_domain
*domain
;
2514 domain
= zmalloc(sizeof(*domain
));
2516 ret
= -LTTNG_ERR_NOMEM
;
2520 ret
= init_domain(node
, domain
);
2522 goto domain_init_error
;
2525 switch (domain
->type
) {
2526 case LTTNG_DOMAIN_KERNEL
:
2527 if (kernel_domain
) {
2528 /* Same domain seen twice, invalid! */
2529 goto domain_init_error
;
2531 kernel_domain
= domain
;
2533 case LTTNG_DOMAIN_UST
:
2535 /* Same domain seen twice, invalid! */
2536 goto domain_init_error
;
2538 ust_domain
= domain
;
2540 case LTTNG_DOMAIN_JUL
:
2542 /* Same domain seen twice, invalid! */
2543 goto domain_init_error
;
2545 jul_domain
= domain
;
2547 case LTTNG_DOMAIN_LOG4J
:
2549 /* Same domain seen twice, invalid! */
2550 goto domain_init_error
;
2552 log4j_domain
= domain
;
2554 case LTTNG_DOMAIN_PYTHON
:
2555 if (python_domain
) {
2556 /* Same domain seen twice, invalid! */
2557 goto domain_init_error
;
2559 python_domain
= domain
;
2562 WARN("Invalid domain type");
2563 goto domain_init_error
;
2568 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2573 /* Destroy session if it exists */
2574 ret
= lttng_destroy_session((const char *) name
);
2575 if (ret
&& ret
!= -LTTNG_ERR_SESS_NOT_FOUND
) {
2576 ERR("Failed to destroy existing session.");
2581 /* Create session type depending on output type */
2582 if (snapshot_mode
&& snapshot_mode
!= -1) {
2583 ret
= create_snapshot_session((const char *) name
, output_node
);
2584 } else if (live_timer_interval
&&
2585 live_timer_interval
!= UINT64_MAX
) {
2586 ret
= create_session((const char *) name
, kernel_domain
,
2587 ust_domain
, jul_domain
, log4j_domain
,
2588 output_node
, live_timer_interval
);
2590 /* regular session */
2591 ret
= create_session((const char *) name
, kernel_domain
,
2592 ust_domain
, jul_domain
, log4j_domain
,
2593 output_node
, UINT64_MAX
);
2600 ret
= lttng_set_session_shm_path((const char *) name
,
2601 (const char *) shm_path
);
2607 for (node
= xmlFirstElementChild(domains_node
); node
;
2608 node
= xmlNextElementSibling(node
)) {
2609 ret
= process_domain_node(node
, (const char *) name
);
2616 ret
= lttng_start_tracing((const char *) name
);
2624 ERR("Failed to load session %s: %s", (const char *) name
,
2625 lttng_strerror(ret
));
2626 lttng_destroy_session((const char *) name
);
2630 free(kernel_domain
);
2634 free(python_domain
);
2641 * Return 1 if the given path is readable by the current UID or 0 if not.
2642 * Return -1 if the path is EPERM.
2644 static int validate_file_read_creds(const char *path
)
2650 /* Can we read the file. */
2651 ret
= access(path
, R_OK
);
2655 if (errno
== EACCES
) {
2666 int load_session_from_file(const char *path
, const char *session_name
,
2667 struct session_config_validation_ctx
*validation_ctx
, int override
)
2669 int ret
, session_found
= !session_name
;
2670 xmlDocPtr doc
= NULL
;
2671 xmlNodePtr sessions_node
;
2672 xmlNodePtr session_node
;
2675 assert(validation_ctx
);
2677 ret
= validate_file_read_creds(path
);
2680 ret
= -LTTNG_ERR_EPERM
;
2682 ret
= -LTTNG_ERR_LOAD_SESSION_NOENT
;
2687 doc
= xmlParseFile(path
);
2689 ret
= -LTTNG_ERR_LOAD_IO_FAIL
;
2693 ret
= xmlSchemaValidateDoc(validation_ctx
->schema_validation_ctx
, doc
);
2695 ERR("Session configuration file validation failed");
2696 ret
= -LTTNG_ERR_LOAD_INVALID_CONFIG
;
2700 sessions_node
= xmlDocGetRootElement(doc
);
2701 if (!sessions_node
) {
2705 for (session_node
= xmlFirstElementChild(sessions_node
);
2706 session_node
; session_node
=
2707 xmlNextElementSibling(session_node
)) {
2708 ret
= process_session_node(session_node
,
2709 session_name
, override
);
2710 if (session_name
&& ret
== 0) {
2711 /* Target session found and loaded */
2719 ret
= session_found
? 0 : -LTTNG_ERR_LOAD_SESSION_NOENT
;
2724 /* Allocate dirent as recommended by READDIR(3), NOTES on readdir_r */
2726 struct dirent
*alloc_dirent(const char *path
)
2730 struct dirent
*entry
;
2732 name_max
= pathconf(path
, _PC_NAME_MAX
);
2733 if (name_max
== -1) {
2734 name_max
= PATH_MAX
;
2736 len
= offsetof(struct dirent
, d_name
) + name_max
+ 1;
2737 entry
= zmalloc(len
);
2742 int load_session_from_path(const char *path
, const char *session_name
,
2743 struct session_config_validation_ctx
*validation_ctx
, int override
)
2745 int ret
, session_found
= !session_name
;
2746 DIR *directory
= NULL
;
2749 assert(validation_ctx
);
2751 directory
= opendir(path
);
2755 /* Try the file loading. */
2758 ret
= -LTTNG_ERR_LOAD_SESSION_NOENT
;
2761 ret
= -LTTNG_ERR_LOAD_IO_FAIL
;
2766 struct dirent
*entry
;
2767 struct dirent
*result
;
2768 char *file_path
= NULL
;
2769 size_t path_len
= strlen(path
);
2771 if (path_len
>= PATH_MAX
) {
2772 ret
= -LTTNG_ERR_INVALID
;
2776 entry
= alloc_dirent(path
);
2778 ret
= -LTTNG_ERR_NOMEM
;
2782 file_path
= zmalloc(PATH_MAX
);
2784 ret
= -LTTNG_ERR_NOMEM
;
2789 strncpy(file_path
, path
, path_len
);
2790 if (file_path
[path_len
- 1] != '/') {
2791 file_path
[path_len
++] = '/';
2795 /* Search for *.lttng files */
2796 while (!readdir_r(directory
, entry
, &result
) && result
) {
2797 size_t file_name_len
= strlen(result
->d_name
);
2799 if (file_name_len
<=
2800 sizeof(DEFAULT_SESSION_CONFIG_FILE_EXTENSION
)) {
2804 if (path_len
+ file_name_len
>= PATH_MAX
) {
2808 if (strcmp(DEFAULT_SESSION_CONFIG_FILE_EXTENSION
,
2809 result
->d_name
+ file_name_len
- sizeof(
2810 DEFAULT_SESSION_CONFIG_FILE_EXTENSION
) + 1)) {
2814 strncpy(file_path
+ path_len
, result
->d_name
, file_name_len
);
2815 file_path
[path_len
+ file_name_len
] = '\0';
2817 ret
= load_session_from_file(file_path
, session_name
,
2818 validation_ctx
, override
);
2819 if (session_name
&& !ret
) {
2828 ret
= load_session_from_file(path
, session_name
,
2829 validation_ctx
, override
);
2839 if (closedir(directory
)) {
2844 if (session_found
) {
2852 * Validate that the given path's credentials and the current process have the
2853 * same UID. If so, return 1 else return 0 if it does NOT match.
2855 static int validate_path_creds(const char *path
)
2857 int ret
, uid
= getuid();
2866 ret
= stat(path
, &buf
);
2868 if (errno
!= ENOENT
) {
2871 ret
= -LTTNG_ERR_INVALID
;
2875 if (buf
.st_uid
!= uid
) {
2886 int config_load_session(const char *path
, const char *session_name
,
2887 int override
, unsigned int autoload
)
2890 bool session_loaded
= false;
2891 const char *path_ptr
= NULL
;
2892 struct session_config_validation_ctx validation_ctx
= { 0 };
2894 ret
= init_session_config_validation_ctx(&validation_ctx
);
2901 const char *sys_path
;
2904 home_path
= utils_get_home_dir();
2906 char path
[PATH_MAX
];
2909 * Try user session configuration path. Ignore error here so we can
2910 * continue loading the system wide sessions.
2913 ret
= snprintf(path
, sizeof(path
),
2914 DEFAULT_SESSION_HOME_CONFIGPATH
"/"
2915 DEFAULT_SESSION_CONFIG_AUTOLOAD
, home_path
);
2917 PERROR("snprintf session autoload home config path");
2922 * Credentials are only validated for the autoload in order to
2923 * avoid any user session daemon to try to load kernel sessions
2924 * automatically and failing all the times.
2926 ret
= validate_path_creds(path
);
2931 ret
= snprintf(path
, sizeof(path
),
2932 DEFAULT_SESSION_HOME_CONFIGPATH
, home_path
);
2934 PERROR("snprintf session home config path");
2940 ret
= load_session_from_path(path_ptr
, session_name
,
2941 &validation_ctx
, override
);
2942 if (ret
&& ret
!= -LTTNG_ERR_LOAD_SESSION_NOENT
) {
2946 * Continue even if the session was found since we have to try
2947 * the system wide sessions.
2949 session_loaded
= true;
2953 /* Reset path pointer for the system wide dir. */
2956 /* Try system wide configuration directory. */
2958 sys_path
= DEFAULT_SESSION_SYSTEM_CONFIGPATH
"/"
2959 DEFAULT_SESSION_CONFIG_AUTOLOAD
;
2960 ret
= validate_path_creds(sys_path
);
2962 path_ptr
= sys_path
;
2965 sys_path
= DEFAULT_SESSION_SYSTEM_CONFIGPATH
;
2966 path_ptr
= sys_path
;
2970 ret
= load_session_from_path(path_ptr
, session_name
,
2971 &validation_ctx
, override
);
2973 session_loaded
= true;
2977 ret
= access(path
, F_OK
);
2982 ret
= -LTTNG_ERR_INVALID
;
2983 WARN("Session configuration path does not exist.");
2986 ret
= -LTTNG_ERR_EPERM
;
2989 ret
= -LTTNG_ERR_UNK
;
2995 ret
= load_session_from_path(path
, session_name
,
2996 &validation_ctx
, override
);
2999 fini_session_config_validation_ctx(&validation_ctx
);
3000 if (ret
== -LTTNG_ERR_LOAD_SESSION_NOENT
&& !session_name
&& !path
) {
3002 * Don't report an error if no sessions are found when called
3003 * without a session_name or a search path.
3008 if (session_loaded
&& ret
== -LTTNG_ERR_LOAD_SESSION_NOENT
) {
3009 /* A matching session was found in one of the search paths. */