xref: /qemu/tests/unit/test-logging.c (revision b355f08a)
1 /*
2  * logging unit-tests
3  *
4  * Copyright (C) 2016 Linaro Ltd.
5  *
6  *  Author: Alex Bennée <alex.bennee@linaro.org>
7  *
8  * Permission is hereby granted, free of charge, to any person obtaining a copy
9  * of this software and associated documentation files (the "Software"), to deal
10  * in the Software without restriction, including without limitation the rights
11  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12  * copies of the Software, and to permit persons to whom the Software is
13  * furnished to do so, subject to the following conditions:
14  *
15  * The above copyright notice and this permission notice shall be included in
16  * all copies or substantial portions of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24  * THE SOFTWARE.
25  */
26 
27 #include "qemu/osdep.h"
28 #include <glib/gstdio.h>
29 
30 #include "qemu-common.h"
31 #include "qapi/error.h"
32 #include "qemu/log.h"
33 
34 static void test_parse_range(void)
35 {
36     Error *err = NULL;
37 
38     qemu_set_dfilter_ranges("0x1000+0x100", &error_abort);
39 
40     g_assert_false(qemu_log_in_addr_range(0xfff));
41     g_assert(qemu_log_in_addr_range(0x1000));
42     g_assert(qemu_log_in_addr_range(0x1001));
43     g_assert(qemu_log_in_addr_range(0x10ff));
44     g_assert_false(qemu_log_in_addr_range(0x1100));
45 
46     qemu_set_dfilter_ranges("0x1000-0x100", &error_abort);
47 
48     g_assert_false(qemu_log_in_addr_range(0x1001));
49     g_assert(qemu_log_in_addr_range(0x1000));
50     g_assert(qemu_log_in_addr_range(0x0f01));
51     g_assert_false(qemu_log_in_addr_range(0x0f00));
52 
53     qemu_set_dfilter_ranges("0x1000..0x1100", &error_abort);
54 
55     g_assert_false(qemu_log_in_addr_range(0xfff));
56     g_assert(qemu_log_in_addr_range(0x1000));
57     g_assert(qemu_log_in_addr_range(0x1100));
58     g_assert_false(qemu_log_in_addr_range(0x1101));
59 
60     qemu_set_dfilter_ranges("0x1000..0x1000", &error_abort);
61 
62     g_assert_false(qemu_log_in_addr_range(0xfff));
63     g_assert(qemu_log_in_addr_range(0x1000));
64     g_assert_false(qemu_log_in_addr_range(0x1001));
65 
66     qemu_set_dfilter_ranges("0x1000+0x100,0x2100-0x100,0x3000..0x3100",
67                             &error_abort);
68     g_assert(qemu_log_in_addr_range(0x1050));
69     g_assert(qemu_log_in_addr_range(0x2050));
70     g_assert(qemu_log_in_addr_range(0x3050));
71 
72     qemu_set_dfilter_ranges("0xffffffffffffffff-1", &error_abort);
73     g_assert(qemu_log_in_addr_range(UINT64_MAX));
74     g_assert_false(qemu_log_in_addr_range(UINT64_MAX - 1));
75 
76     qemu_set_dfilter_ranges("0..0xffffffffffffffff", &error_abort);
77     g_assert(qemu_log_in_addr_range(0));
78     g_assert(qemu_log_in_addr_range(UINT64_MAX));
79 
80     qemu_set_dfilter_ranges("2..1", &err);
81     error_free_or_abort(&err);
82 
83     qemu_set_dfilter_ranges("0x1000+onehundred", &err);
84     error_free_or_abort(&err);
85 
86     qemu_set_dfilter_ranges("0x1000+0", &err);
87     error_free_or_abort(&err);
88 }
89 
90 static void set_log_path_tmp(char const *dir, char const *tpl, Error **errp)
91 {
92     gchar *file_path = g_build_filename(dir, tpl, NULL);
93 
94     qemu_set_log_filename(file_path, errp);
95     g_free(file_path);
96 }
97 
98 static void test_parse_path(gconstpointer data)
99 {
100     gchar const *tmp_path = data;
101     Error *err = NULL;
102 
103     set_log_path_tmp(tmp_path, "qemu.log", &error_abort);
104     set_log_path_tmp(tmp_path, "qemu-%d.log", &error_abort);
105     set_log_path_tmp(tmp_path, "qemu.log.%d", &error_abort);
106 
107     set_log_path_tmp(tmp_path, "qemu-%d%d.log", &err);
108     error_free_or_abort(&err);
109 }
110 
111 static void test_logfile_write(gconstpointer data)
112 {
113     QemuLogFile *logfile;
114     QemuLogFile *logfile2;
115     gchar const *dir = data;
116     g_autofree gchar *file_path = NULL;
117     g_autofree gchar *file_path1 = NULL;
118     FILE *orig_fd;
119 
120     /*
121      * Before starting test, set log flags, to ensure the file gets
122      * opened below with the call to qemu_set_log_filename().
123      * In cases where a logging backend other than log is used,
124      * this is needed.
125      */
126     qemu_set_log(CPU_LOG_TB_OUT_ASM);
127     file_path = g_build_filename(dir, "qemu_test_log_write0.log", NULL);
128     file_path1 = g_build_filename(dir, "qemu_test_log_write1.log", NULL);
129 
130     /*
131      * Test that even if an open file handle is changed,
132      * our handle remains valid due to RCU.
133      */
134     qemu_set_log_filename(file_path, &error_abort);
135     rcu_read_lock();
136     logfile = qatomic_rcu_read(&qemu_logfile);
137     orig_fd = logfile->fd;
138     g_assert(logfile && logfile->fd);
139     fprintf(logfile->fd, "%s 1st write to file\n", __func__);
140     fflush(logfile->fd);
141 
142     /* Change the logfile and ensure that the handle is still valid. */
143     qemu_set_log_filename(file_path1, &error_abort);
144     logfile2 = qatomic_rcu_read(&qemu_logfile);
145     g_assert(logfile->fd == orig_fd);
146     g_assert(logfile2->fd != logfile->fd);
147     fprintf(logfile->fd, "%s 2nd write to file\n", __func__);
148     fflush(logfile->fd);
149     rcu_read_unlock();
150 }
151 
152 static void test_logfile_lock(gconstpointer data)
153 {
154     FILE *logfile;
155     gchar const *dir = data;
156     g_autofree gchar *file_path = NULL;
157 
158     file_path = g_build_filename(dir, "qemu_test_logfile_lock0.log", NULL);
159 
160     /*
161      * Test the use of the logfile lock, such
162      * that even if an open file handle is closed,
163      * our handle remains valid for use due to RCU.
164      */
165     qemu_set_log_filename(file_path, &error_abort);
166     logfile = qemu_log_lock();
167     g_assert(logfile);
168     fprintf(logfile, "%s 1st write to file\n", __func__);
169     fflush(logfile);
170 
171     /*
172      * Initiate a close file and make sure our handle remains
173      * valid since we still have the logfile lock.
174      */
175     qemu_log_close();
176     fprintf(logfile, "%s 2nd write to file\n", __func__);
177     fflush(logfile);
178     qemu_log_unlock(logfile);
179 }
180 
181 /* Remove a directory and all its entries (non-recursive). */
182 static void rmdir_full(gchar const *root)
183 {
184     GDir *root_gdir = g_dir_open(root, 0, NULL);
185     gchar const *entry_name;
186 
187     g_assert_nonnull(root_gdir);
188     while ((entry_name = g_dir_read_name(root_gdir)) != NULL) {
189         gchar *entry_path = g_build_filename(root, entry_name, NULL);
190         g_assert(g_remove(entry_path) == 0);
191         g_free(entry_path);
192     }
193     g_dir_close(root_gdir);
194     g_assert(g_rmdir(root) == 0);
195 }
196 
197 int main(int argc, char **argv)
198 {
199     g_autofree gchar *tmp_path = g_dir_make_tmp("qemu-test-logging.XXXXXX", NULL);
200     int rc;
201 
202     g_test_init(&argc, &argv, NULL);
203     g_assert_nonnull(tmp_path);
204 
205     g_test_add_func("/logging/parse_range", test_parse_range);
206     g_test_add_data_func("/logging/parse_path", tmp_path, test_parse_path);
207     g_test_add_data_func("/logging/logfile_write_path",
208                          tmp_path, test_logfile_write);
209     g_test_add_data_func("/logging/logfile_lock_path",
210                          tmp_path, test_logfile_lock);
211 
212     rc = g_test_run();
213     qemu_log_close();
214     drain_call_rcu();
215 
216     rmdir_full(tmp_path);
217     return rc;
218 }
219