source: mainline/uspace/lib/c/generic/io/logctl.c@ 694ca3d6

topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 694ca3d6 was 01900b6, checked in by Martin Decky <martin@…>, 5 years ago

Use an optional output argument instead of errno to propagate the error

The use of errno is troublesome in all other than top-level library
functions since the value in errno might get overwritten by subsequent
inner calls on the error path (e.g. cleanup, deallocation, etc.). The
optional output argument makes it possible to explicitly ignore the
error code if it is not needed, but still to pass it reliably back to
the original caller.

This change affecs async_connect_me_to(),
async_connect_me_to_blocking(), async_connect_kbox(), service_connect(),
service_connect_blocking() and loader_connect().

  • Property mode set to 100644
File size: 4.3 KB
Line 
1/*
2 * Copyright (c) 2012 Vojtech Horky
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libc
30 * @{
31 */
32
33#include <assert.h>
34#include <errno.h>
35#include <io/logctl.h>
36#include <ipc/logger.h>
37#include <sysinfo.h>
38#include <ns.h>
39#include <str.h>
40#include <vfs/vfs.h>
41
42/** IPC session with the logger service. */
43static async_sess_t *logger_session = NULL;
44
45static errno_t start_logger_exchange(async_exch_t **exchange_out)
46{
47 assert(exchange_out != NULL);
48
49 if (logger_session == NULL) {
50 errno_t rc;
51 logger_session = service_connect_blocking(SERVICE_LOGGER,
52 INTERFACE_LOGGER_CONTROL, 0, &rc);
53 if (logger_session == NULL)
54 return rc;
55 }
56
57 assert(logger_session != NULL);
58
59 async_exch_t *exchange = async_exchange_begin(logger_session);
60 if (exchange == NULL)
61 return ENOMEM;
62
63 *exchange_out = exchange;
64
65 return EOK;
66}
67
68/** Set default reported log level (global setting).
69 *
70 * This setting affects all logger clients whose reporting level was
71 * not yet changed.
72 *
73 * If logging level of client A is changed with logctl_set_log_level()
74 * to some level, this call will have no effect at that client's reporting
75 * level. Even if the actual value of the reporting level of client A is
76 * the same as current (previous) default log level.
77 *
78 * @param new_level New reported logging level.
79 * @return Error code of the conversion or EOK on success.
80 */
81errno_t logctl_set_default_level(log_level_t new_level)
82{
83 async_exch_t *exchange = NULL;
84 errno_t rc = start_logger_exchange(&exchange);
85 if (rc != EOK)
86 return rc;
87
88 rc = (errno_t) async_req_1_0(exchange,
89 LOGGER_CONTROL_SET_DEFAULT_LEVEL, new_level);
90
91 async_exchange_end(exchange);
92
93 return rc;
94}
95
96/** Set reported log level of a single log.
97 *
98 * @see logctl_set_default_level
99 *
100 * @param logname Log name.
101 * @param new_level New reported logging level.
102 * @return Error code of the conversion or EOK on success.
103 */
104errno_t logctl_set_log_level(const char *logname, log_level_t new_level)
105{
106 async_exch_t *exchange = NULL;
107 errno_t rc = start_logger_exchange(&exchange);
108 if (rc != EOK)
109 return rc;
110
111 aid_t reg_msg = async_send_1(exchange, LOGGER_CONTROL_SET_LOG_LEVEL,
112 new_level, NULL);
113 rc = async_data_write_start(exchange, logname, str_size(logname));
114 errno_t reg_msg_rc;
115 async_wait_for(reg_msg, &reg_msg_rc);
116
117 async_exchange_end(exchange);
118
119 if (rc != EOK)
120 return rc;
121
122 return (errno_t) reg_msg_rc;
123}
124
125/** Set logger's VFS root.
126 *
127 * @return Error code or EOK on success.
128 */
129errno_t logctl_set_root(void)
130{
131 async_exch_t *exchange = NULL;
132 errno_t rc = start_logger_exchange(&exchange);
133 if (rc != EOK)
134 return rc;
135
136 aid_t reg_msg = async_send_0(exchange, LOGGER_CONTROL_SET_ROOT, NULL);
137 async_exch_t *vfs_exch = vfs_exchange_begin();
138 rc = vfs_pass_handle(vfs_exch, vfs_root(), exchange);
139 vfs_exchange_end(vfs_exch);
140 errno_t reg_msg_rc;
141 async_wait_for(reg_msg, &reg_msg_rc);
142
143 async_exchange_end(exchange);
144
145 if (rc != EOK)
146 return rc;
147
148 return (errno_t) reg_msg_rc;
149}
150
151/** @}
152 */
Note: See TracBrowser for help on using the repository browser.