summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlan Coopersmith <alan.coopersmith@oracle.com>2019-08-03 13:45:54 -0700
committerAlan Coopersmith <alan.coopersmith@oracle.com>2019-08-03 13:54:35 -0700
commitc4ed2e069dc8aa5b8b7ef2fc926ae8584ff2a67b (patch)
tree0eb30743859df68a6b50d621a46d28fd9d078268
parent77ae4048564eff2e96b80cedfac013877e46d506 (diff)
Add some unit testing utilities
The test/utils directory contains some standalone test programs for testing libXfont funtionality without needing a full X server session. They could be used to generate automated unit testing in the future, but that work has not yet been done. [v2: updated original work from libXfont 1.5 to 2.0 API & makefiles] Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
-rw-r--r--Makefile.am11
-rw-r--r--test/utils/README18
-rw-r--r--test/utils/font-test-utils.c335
-rw-r--r--test/utils/font-test-utils.h49
-rw-r--r--test/utils/lsfontdir.c74
5 files changed, 487 insertions, 0 deletions
diff --git a/Makefile.am b/Makefile.am
index 7c0546e..a4a8009 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -157,6 +157,17 @@ endif
EXTRA_DIST = src/builtins/buildfont README.md
+# Test utilities
+EXTRA_DIST += test/utils/README
+
+TEST_UTIL_SRCS = test/utils/font-test-utils.c test/utils/font-test-utils.h
+
+noinst_PROGRAMS = lsfontdir
+
+lsfontdir_SOURCES = test/utils/lsfontdir.c $(TEST_UTIL_SRCS)
+lsfontdir_LDADD = libXfont2.la
+
+
MAINTAINERCLEANFILES = ChangeLog INSTALL
.PHONY: ChangeLog INSTALL
diff --git a/test/utils/README b/test/utils/README
new file mode 100644
index 0000000..ce093a4
--- /dev/null
+++ b/test/utils/README
@@ -0,0 +1,18 @@
+This directory contains utilities which can be used for adhoc testing of
+libXfont by developers, and which are hoped to be useful for building up
+automated testing in the future.
+
+They are not intended for distros to package and ship to end users - they
+are not documented, and are full of assert() and fatal err() calls where
+end user software would have error handling.
+
+No promises of interface stability are made for these - they may change at
+any time to allow better testing.
+
+Utilities include:
+
+lsfontdir:
+ Reads & prints the contents of fonts.dir files.
+ Takes a list of font path entries on the command line, uses defaults
+ if none specified.
+ For use with afl fuzzer, you must use afl -f fonts.dir lsfontdir @@
diff --git a/test/utils/font-test-utils.c b/test/utils/font-test-utils.c
new file mode 100644
index 0000000..bc4039e
--- /dev/null
+++ b/test/utils/font-test-utils.c
@@ -0,0 +1,335 @@
+/* Common utility code for interacting with libXfont from test utilities
+ *
+ * Note that this code is designed for test programs, and thus uses assert()
+ * and fatal err() calls in places that real code would do error handling,
+ * since the goal is to catch bugs faster, not help users get past problems.
+ */
+
+/*
+ * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
+ *
+ * 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.
+ */
+
+/* Based on code from xorg-server/dix/dixfont.c covered by this notice:
+
+Copyright 1987 by Digital Equipment Corporation, Maynard, Massachusetts.
+
+ All Rights Reserved
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation, and that the name of Digital not be
+used in advertising or publicity pertaining to distribution of the
+software without specific, written prior permission.
+
+DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
+ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
+DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
+ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
+SOFTWARE.
+
+ */
+
+#include "font-test-utils.h"
+#include <stdio.h>
+#include <stdlib.h>
+#include <limits.h>
+#include <assert.h>
+#include <err.h>
+#include <X11/X.h>
+
+static unsigned long server_generation;
+static xfont2_fpe_funcs_rec const **fpe_functions;
+static int num_fpe_types;
+
+static int
+test_client_auth_generation(ClientPtr client)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static Bool
+test_client_signal(ClientPtr client)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static void
+test_delete_font_client_id(Font id)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static void _X_ATTRIBUTE_PRINTF(1,0)
+test_verrorf(const char *f, va_list ap)
+{
+ vwarn(f, ap);
+}
+
+static FontPtr
+test_find_old_font(FSID id)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static FontResolutionPtr
+test_get_client_resolutions(int *num)
+{
+ *num = 0;
+ return NULL;
+}
+
+static int
+test_get_default_point_size(void)
+{
+ return 120;
+}
+
+static Font
+test_get_new_font_client_id(void)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static uint32_t
+test_get_time_in_millis(void)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static int
+test_init_fs_handlers(FontPathElementPtr fpe,
+ FontBlockHandlerProcPtr block_handler)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+/* Callback from libXfont when each fpe handler is registered */
+static int
+test_register_fpe_funcs(const xfont2_fpe_funcs_rec *funcs)
+{
+ xfont2_fpe_funcs_rec const **new;
+
+ /* grow the list */
+ new = realloc(fpe_functions, (num_fpe_types + 1) * sizeof(xfont2_fpe_funcs_ptr));
+ assert (new != NULL);
+ fpe_functions = new;
+
+ fpe_functions[num_fpe_types] = funcs;
+
+ return num_fpe_types++;
+}
+
+static void
+test_remove_fs_handlers(FontPathElementPtr fpe,
+ FontBlockHandlerProcPtr block_handler, Bool all)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static void *
+test_get_server_client(void)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static int
+test_set_font_authorizations(char **authorizations, int *authlen, void *client)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static int
+test_store_font_client_font(FontPtr pfont, Font id)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static Atom
+test_make_atom(const char *string, unsigned len, int makeit)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static int
+test_valid_atom(Atom atom)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static const char *
+test_name_for_atom(Atom atom)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static unsigned long
+test_get_server_generation(void)
+{
+ return server_generation;
+}
+
+static int
+test_add_fs_fd(int fd, FontFdHandlerProcPtr handler, void *data)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static void
+test_remove_fs_fd(int fd)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static void
+test_adjust_fs_wait_for_delay(void *wt, unsigned long newdelay)
+{
+ err(BadImplementation, "%s called but not yet implemented", __func__);
+}
+
+static const xfont2_client_funcs_rec xfont2_client_funcs = {
+ .version = XFONT2_CLIENT_FUNCS_VERSION,
+ .client_auth_generation = test_client_auth_generation,
+ .client_signal = test_client_signal,
+ .delete_font_client_id = test_delete_font_client_id,
+ .verrorf = test_verrorf,
+ .find_old_font = test_find_old_font,
+ .get_client_resolutions = test_get_client_resolutions,
+ .get_default_point_size = test_get_default_point_size,
+ .get_new_font_client_id = test_get_new_font_client_id,
+ .get_time_in_millis = test_get_time_in_millis,
+ .init_fs_handlers = test_init_fs_handlers,
+ .register_fpe_funcs = test_register_fpe_funcs,
+ .remove_fs_handlers = test_remove_fs_handlers,
+ .get_server_client = test_get_server_client,
+ .set_font_authorizations = test_set_font_authorizations,
+ .store_font_client_font = test_store_font_client_font,
+ .make_atom = test_make_atom,
+ .valid_atom = test_valid_atom,
+ .name_for_atom = test_name_for_atom,
+ .get_server_generation = test_get_server_generation,
+ .add_fs_fd = test_add_fs_fd,
+ .remove_fs_fd = test_remove_fs_fd,
+ .adjust_fs_wait_for_delay = test_adjust_fs_wait_for_delay,
+};
+
+
+xfont2_fpe_funcs_rec const **
+init_font_handlers(int *fpe_function_count)
+{
+ server_generation++;
+ xfont2_init(&xfont2_client_funcs);
+ /* make sure our callbacks were called & worked */
+ assert (fpe_functions != NULL);
+ assert (num_fpe_types > 0);
+ *fpe_function_count = num_fpe_types;
+ return fpe_functions;
+}
+
+
+/* does the necessary magic to figure out the fpe type */
+static int
+DetermineFPEType(const char *pathname)
+{
+ int i;
+
+ /* make sure init_font_handlers was called first */
+ assert (num_fpe_types > 0);
+
+ for (i = 0; i < num_fpe_types; i++) {
+ if ((*fpe_functions[i]->name_check) (pathname))
+ return i;
+ }
+ return -1;
+}
+
+
+static const char * const default_fpes[] = {
+ "catalogue:/etc/X11/fontpath.d",
+ "built-ins"
+};
+#define num_default_fpes (sizeof(default_fpes) / sizeof(*default_fpes))
+
+FontPathElementPtr *
+init_font_paths(const char * const *font_paths, int *num_fpes)
+{
+ FontPathElementPtr *fpe_list;
+ int i;
+
+ /* make sure init_font_handlers was called first */
+ assert (num_fpe_types > 0);
+
+ /* Use default if caller didn't supply any */
+ if (*num_fpes == 0) {
+ font_paths = default_fpes;
+ *num_fpes = num_default_fpes;
+ }
+
+ fpe_list = calloc(*num_fpes, sizeof(FontPathElementPtr));
+ assert(fpe_list != NULL);
+
+ for (i = 0; i < *num_fpes; i++) {
+ int result;
+ FontPathElementPtr fpe = calloc(1, sizeof(FontPathElementRec));
+ assert(fpe != NULL);
+
+ fpe->name = strdup(font_paths[i]);
+ assert(fpe->name != NULL);
+ fpe->name_length = strlen(fpe->name);
+ assert(fpe->name_length > 0);
+ /* If path is to fonts.dir file, trim it off and use the full
+ directory path instead. Simplifies testing with afl. */
+ if (fpe->name_length > (int) sizeof("/fonts.dir")) {
+ char *tail = fpe->name + fpe->name_length -
+ (sizeof("/fonts.dir") - 1);
+
+ if (strcmp(tail, "/fonts.dir") == 0) {
+ char *fullpath;
+
+ *tail = '\0';
+ fullpath = realpath(fpe->name, NULL);
+ assert(fullpath != NULL);
+ free(fpe->name);
+ fpe->name = fullpath;
+ fpe->name_length = strlen(fpe->name);
+ assert(fpe->name_length > 0);
+ }
+ }
+ fpe->type = DetermineFPEType(fpe->name);
+ if (fpe->type == -1)
+ err(BadFontPath, "Unable to find handler for font path %s",
+ fpe->name);
+ result = (*fpe_functions[fpe->type]->init_fpe) (fpe);
+ if (result != Successful)
+ err(result, "init_fpe failed for font path %s: error %d",
+ fpe->name, result);
+
+ printf("Initialized font path element #%d: %s\n", i, fpe->name);
+ fpe_list[i] = fpe;
+ }
+ printf("\n");
+
+ return fpe_list;
+}
diff --git a/test/utils/font-test-utils.h b/test/utils/font-test-utils.h
new file mode 100644
index 0000000..254f1b9
--- /dev/null
+++ b/test/utils/font-test-utils.h
@@ -0,0 +1,49 @@
+/* Common utility code for interacting with libXfont from test utilities */
+
+/*
+ * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
+ *
+ * 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.
+ */
+
+#ifdef HAVE_CONFIG_H
+# include "config.h"
+#endif
+
+#include <X11/Xfuncproto.h>
+#include <X11/fonts/font.h>
+#include <X11/fonts/fontstruct.h>
+#include <X11/fonts/fontmisc.h>
+#include <X11/fonts/libxfont2.h>
+
+/* Returns pointer to array of functions for each type of font_path_entry
+ * handler, and puts count of entries in that array into fpe_function_count.
+ * Must be called before init_font_paths().
+ */
+extern xfont2_fpe_funcs_rec const **init_font_handlers(int *fpe_function_count);
+
+/* Returns pointer to array of FontPathElement structs for each font path
+ * entry passed in. num_fpes must be set to the number of entries in the
+ * font_paths array when called - will be set to the number of entries in
+ * the returned array. May be called with (NULL, 0) to use default font
+ * path of "catalogue:/etc/X11/fontpath.d" & "built-ins".
+ */
+extern FontPathElementPtr *init_font_paths(const char * const *font_paths,
+ int *num_fpes);
diff --git a/test/utils/lsfontdir.c b/test/utils/lsfontdir.c
new file mode 100644
index 0000000..1f46599
--- /dev/null
+++ b/test/utils/lsfontdir.c
@@ -0,0 +1,74 @@
+/* lsfontdir [<font path entry> ...]
+ *
+ * Lists entries from fonts.dir file in given directory paths.
+ * Defaults to "catalogue:/etc/X11/fontpath.d" & "built-ins" if no paths given.
+ */
+
+/*
+ * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
+ *
+ * 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 "font-test-utils.h"
+#include <stdio.h>
+#include <assert.h>
+#include <err.h>
+
+int
+main(int argc, char **argv)
+{
+ FontPathElementPtr *fpe_list;
+ xfont2_fpe_funcs_rec const **fpe_functions;
+ int fpe_function_count, fpe_list_count;
+ int i, n;
+
+ fpe_functions = init_font_handlers(&fpe_function_count);
+
+ fpe_list_count = argc - 1;
+ fpe_list = init_font_paths((const char **) argv + 1, &fpe_list_count);
+
+ for (i = 0; i < fpe_list_count; i++) {
+ FontPathElementPtr fpe = fpe_list[i];
+ FontNamesPtr names;
+ const int max_names_count = 8192;
+ const char *pattern = "*";
+ int result;
+
+ /* Don't allocate max size up front to allow testing expansion code */
+ names = xfont2_make_font_names_record(max_names_count / 16);
+ assert(names != NULL);
+
+ result = (*fpe_functions[fpe->type]->list_fonts)
+ (NULL, fpe, pattern, strlen(pattern), max_names_count, names);
+ if (result != Successful)
+ err(result, "list_font failed for font path %s: error %d",
+ fpe->name, result);
+
+ printf("--- %s:\n", fpe->name);
+ for (n = 0 ; n < names->nnames; n++) {
+ printf("%s\n", names->names[n]);
+ }
+
+ xfont2_free_font_names(names);
+ }
+
+ return 0;
+}