diff options
Diffstat (limited to 'spa/plugins/support/journal.c')
-rw-r--r-- | spa/plugins/support/journal.c | 341 |
1 files changed, 341 insertions, 0 deletions
diff --git a/spa/plugins/support/journal.c b/spa/plugins/support/journal.c new file mode 100644 index 0000000..e0e58eb --- /dev/null +++ b/spa/plugins/support/journal.c @@ -0,0 +1,341 @@ +/* Spa + * + * Copyright © 2020 Sergey Bugaev + * + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice (including the next + * paragraph) shall be included in all copies or substantial portions of the + * Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + * DEALINGS IN THE SOFTWARE. + */ + +#include <stddef.h> +#include <unistd.h> +#include <string.h> +#include <errno.h> +#include <stdio.h> +#include <limits.h> +#include <syslog.h> +#include <sys/stat.h> + +#include <spa/support/log.h> +#include <spa/support/plugin.h> +#include <spa/utils/type.h> +#include <spa/utils/names.h> +#include <spa/utils/string.h> + +#include <systemd/sd-journal.h> + +#include "log-patterns.h" + +#define NAME "journal" + +#define DEFAULT_LOG_LEVEL SPA_LOG_LEVEL_INFO + +struct impl { + struct spa_handle handle; + struct spa_log log; + + /* if non-null, we'll additionally forward all logging to there */ + struct spa_log *chain_log; + + struct spa_list patterns; +}; + +static SPA_PRINTF_FUNC(7,0) void +impl_log_logtv(void *object, + enum spa_log_level level, + const struct spa_log_topic *topic, + const char *file, + int line, + const char *func, + const char *fmt, + va_list args) +{ + struct impl *impl = object; + char line_buffer[32]; + char file_buffer[strlen("CODE_FILE=") + strlen(file) + 1]; + char message_buffer[LINE_MAX]; + int priority; + size_t sz = 0; + + if (impl->chain_log != NULL) { + va_list args_copy; + va_copy(args_copy, args); + spa_log_logtv(impl->chain_log, + level, topic, + file, line, func, fmt, args_copy); + va_end(args_copy); + } + + /* convert SPA log level to syslog priority */ + switch (level) { + case SPA_LOG_LEVEL_ERROR: + priority = LOG_ERR; + break; + case SPA_LOG_LEVEL_WARN: + priority = LOG_WARNING; + break; + case SPA_LOG_LEVEL_INFO: + priority = LOG_INFO; + break; + case SPA_LOG_LEVEL_DEBUG: + case SPA_LOG_LEVEL_TRACE: + default: + priority = LOG_DEBUG; + break; + } + + if (topic) + sz = spa_scnprintf(message_buffer, sizeof(message_buffer), + "%s: ", topic->topic); + + /* we'll be using the low-level journal API, which expects us to provide + * the location explicitly. line and file are to be passed as preformatted + * entries, whereas the function name is passed as-is, and converted into + * a field inside sd_journal_send_with_location(). */ + snprintf(line_buffer, sizeof(line_buffer), "CODE_LINE=%d", line); + snprintf(file_buffer, sizeof(file_buffer), "CODE_FILE=%s", file); + vsnprintf(message_buffer + sz, sizeof(message_buffer) - sz, fmt, args); + + sd_journal_send_with_location(file_buffer, line_buffer, func, + "MESSAGE=%s", message_buffer, + "PRIORITY=%i", priority, + NULL); +} + +static SPA_PRINTF_FUNC(6,7) void +impl_log_log(void *object, + enum spa_log_level level, + const char *file, + int line, + const char *func, + const char *fmt, ...) +{ + va_list args; + va_start(args, fmt); + impl_log_logtv(object, level, NULL, file, line, func, fmt, args); + va_end(args); +} + +static SPA_PRINTF_FUNC(6,0) void +impl_log_logv(void *object, + enum spa_log_level level, + const char *file, + int line, + const char *func, + const char *fmt, + va_list args) +{ + impl_log_logtv(object, level, NULL, file, line, func, fmt, args); +} + +static SPA_PRINTF_FUNC(7,8) void +impl_log_logt(void *object, + enum spa_log_level level, + const struct spa_log_topic *topic, + const char *file, + int line, + const char *func, + const char *fmt, ...) +{ + va_list args; + va_start(args, fmt); + impl_log_logtv(object, level, topic, file, line, func, fmt, args); + va_end(args); +} + +static void +impl_log_topic_init(void *object, struct spa_log_topic *t) +{ + struct impl *impl = object; + enum spa_log_level level = impl->log.level; + + support_log_topic_init(&impl->patterns, level, t); +} + +static const struct spa_log_methods impl_log = { + SPA_VERSION_LOG_METHODS, + .log = impl_log_log, + .logv = impl_log_logv, + .logt = impl_log_logt, + .logtv = impl_log_logtv, + .topic_init = impl_log_topic_init, +}; + +static int impl_get_interface(struct spa_handle *handle, const char *type, void **interface) +{ + struct impl *this; + + spa_return_val_if_fail(handle != NULL, -EINVAL); + spa_return_val_if_fail(interface != NULL, -EINVAL); + + this = (struct impl *) handle; + + if (spa_streq(type, SPA_TYPE_INTERFACE_Log)) + *interface = &this->log; + else + return -ENOENT; + + return 0; +} + +static int impl_clear(struct spa_handle *handle) +{ + struct impl *this; + + spa_return_val_if_fail(handle != NULL, -EINVAL); + + this = (struct impl *) handle; + support_log_free_patterns(&this->patterns); + + return 0; +} + +static size_t +impl_get_size(const struct spa_handle_factory *factory, + const struct spa_dict *params) +{ + return sizeof(struct impl); +} + +/** Determine if our stderr goes straight to the journal */ +static int +stderr_is_connected_to_journal(void) +{ + const char *journal_stream; + unsigned long long journal_device, journal_inode; + struct stat stderr_stat; + + /* when a service's stderr is connected to the journal, systemd sets + * JOURNAL_STREAM in the environment of that service to device:inode + * of its stderr. if the variable is not set, clearly our stderr is + * not connected to the journal */ + journal_stream = getenv("JOURNAL_STREAM"); + if (journal_stream == NULL) + return 0; + + /* if it *is* set, that doesn't immediately mean that *our* stderr + * is (still) connected to the journal. to know for sure, we have to + * compare our actual stderr to the stream systemd has created for + * the service we're a part of */ + + if (sscanf(journal_stream, "%llu:%llu", &journal_device, &journal_inode) != 2) + return 0; + + if (fstat(STDERR_FILENO, &stderr_stat) < 0) + return 0; + + return stderr_stat.st_dev == journal_device && stderr_stat.st_ino == journal_inode; +} + +static int +impl_init(const struct spa_handle_factory *factory, + struct spa_handle *handle, + const struct spa_dict *info, + const struct spa_support *support, + uint32_t n_support) +{ + struct impl *impl; + const char *str; + + spa_return_val_if_fail(factory != NULL, -EINVAL); + spa_return_val_if_fail(handle != NULL, -EINVAL); + + handle->get_interface = impl_get_interface; + handle->clear = impl_clear; + + impl = (struct impl *) handle; + + impl->log.iface = SPA_INTERFACE_INIT( + SPA_TYPE_INTERFACE_Log, + SPA_VERSION_LOG, + &impl_log, impl); + impl->log.level = DEFAULT_LOG_LEVEL; + + spa_list_init(&impl->patterns); + + if (info) { + if ((str = spa_dict_lookup(info, SPA_KEY_LOG_LEVEL)) != NULL) + impl->log.level = atoi(str); + if ((str = spa_dict_lookup(info, SPA_KEY_LOG_PATTERNS)) != NULL) + support_log_parse_patterns(&impl->patterns, str); + } + + /* if our stderr goes to the journal, there's no point in logging both + * via the native journal API and by printing to stderr, that would just + * result in message duplication */ + if (stderr_is_connected_to_journal()) + impl->chain_log = NULL; + else + impl->chain_log = spa_support_find(support, n_support, SPA_TYPE_INTERFACE_Log); + + spa_log_debug(&impl->log, NAME " %p: initialized", impl); + + return 0; +} + +static const struct spa_interface_info impl_interfaces[] = { + {SPA_TYPE_INTERFACE_Log,}, +}; + +static int +impl_enum_interface_info(const struct spa_handle_factory *factory, + const struct spa_interface_info **info, + uint32_t *index) +{ + spa_return_val_if_fail(factory != NULL, -EINVAL); + spa_return_val_if_fail(info != NULL, -EINVAL); + spa_return_val_if_fail(index != NULL, -EINVAL); + + switch (*index) { + case 0: + *info = &impl_interfaces[*index]; + break; + default: + return 0; + } + (*index)++; + + return 1; +} + +static const struct spa_handle_factory journal_factory = { + SPA_VERSION_HANDLE_FACTORY, + .name = SPA_NAME_SUPPORT_LOG, + .info = NULL, + .get_size = impl_get_size, + .init = impl_init, + .enum_interface_info = impl_enum_interface_info, +}; + + +SPA_EXPORT +int spa_handle_factory_enum(const struct spa_handle_factory **factory, uint32_t *index) +{ + spa_return_val_if_fail(factory != NULL, -EINVAL); + spa_return_val_if_fail(index != NULL, -EINVAL); + + switch (*index) { + case 0: + *factory = &journal_factory; + break; + default: + return 0; + } + (*index)++; + return 1; +} |