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 "remap.h"
40#include "imports.h"
41#include "glapi/glapi.h"
42
43#define MAX_ENTRY_POINTS 16
44
45#define need_MESA_remap_table
46#include "main/remap_helper.h"
47#include "errors.h"
48
49
50/* this is global for quick access */
51int driDispatchRemapTable[driDispatchRemapTable_size];
52
53
54/**
55 * Map a function by its spec.  The function will be added to glapi,
56 * and the dispatch offset will be returned.
57 *
58 * \param spec a '\0'-separated string array specifying a function.
59 *        It begins with the parameter signature of the function,
60 *        followed by the names of the entry points.  An empty entry
61 *        point name terminates the array.
62 *
63 * \return the offset of the (re-)mapped function in the dispatch
64 *         table, or -1.
65 */
66static int
67map_function_spec(const char *spec)
68{
69   const char *signature;
70   const char *names[MAX_ENTRY_POINTS + 1];
71   int num_names = 0;
72
73   if (!spec)
74      return -1;
75
76   signature = spec;
77   spec += strlen(spec) + 1;
78
79   /* spec is terminated by an empty string */
80   while (*spec) {
81      names[num_names] = spec;
82      num_names++;
83      if (num_names >= MAX_ENTRY_POINTS)
84         break;
85      spec += strlen(spec) + 1;
86   }
87   if (!num_names)
88      return -1;
89
90   names[num_names] = NULL;
91
92   /* add the entry points to the dispatch table */
93   return _glapi_add_dispatch(names, signature);
94}
95
96
97/**
98 * Initialize the remap table.  This is called in one_time_init().
99 * The remap table needs to be initialized before calling the
100 * CALL/GET/SET macros defined in main/dispatch.h.
101 */
102void
103_mesa_init_remap_table(void)
104{
105   static bool initialized = false;
106   GLint i;
107
108   if (initialized)
109      return;
110   initialized = true;
111
112   /* initialize the MESA_remap_table_functions table */
113   for (i = 0; i < driDispatchRemapTable_size; i++) {
114      int offset;
115      const char *spec;
116
117      /* sanity check */
118      assert(i == MESA_remap_table_functions[i].remap_index);
119      spec = _mesa_function_pool + MESA_remap_table_functions[i].pool_index;
120
121      offset = map_function_spec(spec);
122      /* store the dispatch offset in the MESA_remap_table_functions table */
123      driDispatchRemapTable[i] = offset;
124      if (offset < 0) {
125         const char *name = spec + strlen(spec) + 1;
126         _mesa_warning(NULL, "failed to remap %s", name);
127      }
128   }
129}
130