xref: /third_party/mesa3d/src/mesa/main/remap.c (revision bf215546)
1/*
2 * Mesa 3-D graphics library
3 *
4 * Copyright (C) 2009 Chia-I Wu <olv@0xlab.org>
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included
14 * in all copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
22 * DEALINGS IN THE SOFTWARE.
23 */
24
25
26/**
27 * \file remap.c
28 * Remap table management.
29 *
30 * Entries in the dispatch table are either static or dynamic.  The
31 * dispatch table is shared by mesa core and glapi.  When they are
32 * built separately, it is possible that a static entry in mesa core
33 * is dynamic, or assigned a different static offset, in glapi.  The
34 * remap table is in charge of mapping a static entry in mesa core to
35 * a dynamic entry, or the corresponding static entry, in glapi.
36 */
37
38#include <stdbool.h>
39#include <string.h>
40#include "remap.h"
41
42#include "glapi/glapi.h"
43
44#define MAX_ENTRY_POINTS 16
45
46#define need_MESA_remap_table
47#include "main/remap_helper.h"
48#include "errors.h"
49
50
51/* this is global for quick access */
52int driDispatchRemapTable[driDispatchRemapTable_size];
53
54
55/**
56 * Map a function by its spec.  The function will be added to glapi,
57 * and the dispatch offset will be returned.
58 *
59 * \param spec a '\0'-separated string array specifying a function.
60 *        It begins with the parameter signature of the function,
61 *        followed by the names of the entry points.  An empty entry
62 *        point name terminates the array.
63 *
64 * \return the offset of the (re-)mapped function in the dispatch
65 *         table, or -1.
66 */
67static int
68map_function_spec(const char *spec)
69{
70   const char *signature;
71   const char *names[MAX_ENTRY_POINTS + 1];
72   int num_names = 0;
73
74   if (!spec)
75      return -1;
76
77   signature = spec;
78   spec += strlen(spec) + 1;
79
80   /* spec is terminated by an empty string */
81   while (*spec) {
82      names[num_names] = spec;
83      num_names++;
84      if (num_names >= MAX_ENTRY_POINTS)
85         break;
86      spec += strlen(spec) + 1;
87   }
88   if (!num_names)
89      return -1;
90
91   names[num_names] = NULL;
92
93   /* add the entry points to the dispatch table */
94   return _glapi_add_dispatch(names, signature);
95}
96
97
98/**
99 * Initialize the remap table.  This is called in one_time_init().
100 * The remap table needs to be initialized before calling the
101 * CALL/GET/SET macros defined in main/dispatch.h.
102 */
103void
104_mesa_init_remap_table(void)
105{
106   static bool initialized = false;
107   GLint i;
108
109   if (initialized)
110      return;
111   initialized = true;
112
113   /* initialize the MESA_remap_table_functions table */
114   for (i = 0; i < driDispatchRemapTable_size; i++) {
115      int offset;
116      const char *spec;
117
118      /* sanity check */
119      assert(i == MESA_remap_table_functions[i].remap_index);
120      spec = _mesa_function_pool + MESA_remap_table_functions[i].pool_index;
121
122      offset = map_function_spec(spec);
123      /* store the dispatch offset in the MESA_remap_table_functions table */
124      driDispatchRemapTable[i] = offset;
125      if (offset < 0) {
126         const char *name = spec + strlen(spec) + 1;
127         _mesa_warning(NULL, "failed to remap %s", name);
128      }
129   }
130}
131