src/hookmacros.h

   1 /*
   2  * Macros to hook functions.
   3  *
   4  * Copyright (C) 2013  Simon Ruderich
   5  *
   6  * This program is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 #ifndef MACROS_H
  21 #define MACROS_H 1
  22
  23 /* Hook the function by creating a function with the same name. With
  24  * LD_PRELOAD our function will be preferred. The original function is stored
  25  * in a static variable (real_*). Any function called in these macros must
  26  * make sure to restore the errno if it changes it.
  27  *
  28  * "Pseudo code" for the following macros. <name> is the name of the hooked
  29  * function, <fd> is either a file descriptor or a FILE pointer.
  30  *
  31  *     if (!real_<name>) {
  32  *         real_<name> = dlsym_function(<name>);
  33  *         if (!initialized) {
  34  *             init_from_environment();
  35  *         }
  36  *     }
  37  *     if (tracked_fds_find(<fd>)) {
  38  *         if (force_write_to_non_tty) {
  39  *             handle = 1;
  40  *         } else {
  41  *             handle = isatty_noinline(<fd>);
  42  *         }
  43  *     } else {
  44  *         handle = 0;
  45  *     }
  46  *
  47  *     if (handle) {
  48  *         handle_<fd>_pre(<fd>);
  49  *     }
  50  *     <type> result = real_<name>(<args>);
  51  *     if (handle) {
  52  *         handle_<fd>_post(<fd>);
  53  *     }
  54  *     return result;
  55  */
  56
  57 #define _HOOK_PRE(type, name, fd) \
  58         int handle; \
  59         if (unlikely(!(real_ ## name ))) { \
  60             *(void **) (&(real_ ## name)) = dlsym_function(#name); \
  61             /* Initialize our data while we're at it. */ \
  62             if (unlikely(!initialized)) { \
  63                 init_from_environment(); \
  64             } \
  65         } \
  66         /* Check if this fd should be handled. */ \
  67         if (unlikely(tracked_fds_find(fd))) { \
  68             if (unlikely(force_write_to_non_tty)) { \
  69                 handle = 1; \
  70             } else { \
  71                 handle = isatty_noinline(fd); \
  72             } \
  73         } else { \
  74             handle = 0; \
  75         }
  76 #define _HOOK_PRE_FD(type, name, fd) \
  77         type result; \
  78         _HOOK_PRE_FD_(type, name, fd)
  79 #define _HOOK_PRE_FD_(type, name, fd) \
  80         _HOOK_PRE(type, name, fd) \
  81         if (unlikely(handle)) { \
  82             handle_fd_pre(fd); \
  83         }
  84 #define _HOOK_PRE_FILE(type, name, file) \
  85         type result; \
  86         _HOOK_PRE(type, name, fileno(file)) \
  87         if (unlikely(handle)) { \
  88             handle_file_pre(file); \
  89         }
  90 #define _HOOK_POST_FD_(fd) \
  91         if (unlikely(handle)) { \
  92             handle_fd_post(fd); \
  93         }
  94 #define _HOOK_POST_FD(fd) \
  95         _HOOK_POST_FD_(fd) \
  96         return result;
  97 #define _HOOK_POST_FILE(file) \
  98         if (unlikely(handle)) { \
  99             handle_file_post(file); \
 100         } \
 101         return result;
 102
 103
 104 #define HOOK_FUNC_DEF1(type, name, type1, arg1) \
 105     static type (*real_ ## name)(type1); \
 106     type name(type1 arg1)
 107 #define HOOK_FUNC_DEF2(type, name, type1, arg1, type2, arg2) \
 108     static type (*real_ ## name)(type1, type2); \
 109     type name(type1 arg1, type2 arg2)
 110 #define HOOK_FUNC_DEF3(type, name, type1, arg1, type2, arg2, type3, arg3) \
 111     static type (*real_ ## name)(type1, type2, type3); \
 112     type name(type1 arg1, type2 arg2, type3 arg3)
 113
 114 #define HOOK_FUNC_VAR_DEF2(type, name, type1, arg1, type2, arg2) \
 115     static type (*real_ ## name)(type1, type2, ...); \
 116     type name(type1 arg1, type2 arg2, ...)
 117
 118 #define HOOK_FUNC_SIMPLE3(type, name, type1, arg1, type2, arg2, type3, arg3) \
 119     type name(type1 arg1, type2 arg2, type3 arg3)
 120
 121 #define HOOK_VOID1(type, name, fd, type1, arg1) \
 122     static type (*real_ ## name)(type1); \
 123     type name(type1 arg1) { \
 124         _HOOK_PRE_FD_(type, name, fd) \
 125         real_ ## name(arg1); \
 126         _HOOK_POST_FD_(fd) \
 127     }
 128 #define HOOK_VOID2(type, name, fd, type1, arg1, type2, arg2) \
 129     static type (*real_ ## name)(type1, type2); \
 130     type name(type1 arg1, type2 arg2) { \
 131         _HOOK_PRE_FD_(type, name, fd) \
 132         real_ ## name(arg1, arg2); \
 133         _HOOK_POST_FD_(fd) \
 134     }
 135 #define HOOK_VOID3(type, name, fd, type1, arg1, type2, arg2, type3, arg3) \
 136     static type (*real_ ## name)(type1, type2, type3); \
 137     type name(type1 arg1, type2 arg2, type3 arg3) { \
 138         _HOOK_PRE_FD_(type, name, fd) \
 139         real_ ## name(arg1, arg2, arg3); \
 140         _HOOK_POST_FD_(fd) \
 141     }
 142
 143 #define HOOK_VAR_VOID1(type, name, fd, func, type1, arg1) \
 144     type name(type1 arg1, ...) { \
 145         va_list ap; \
 146         va_start(ap, arg1); \
 147         func(arg1, ap); \
 148         va_end(ap); \
 149     }
 150 #define HOOK_VAR_VOID2(type, name, fd, func, type1, arg1, type2, arg2) \
 151     type name(type1 arg1, type2 arg2, ...) { \
 152         va_list ap; \
 153         va_start(ap, arg2); \
 154         func(arg1, arg2, ap); \
 155         va_end(ap); \
 156     }
 157
 158 #define HOOK_FD2(type, name, fd, type1, arg1, type2, arg2) \
 159     static type (*real_ ## name)(type1, type2); \
 160     type name(type1 arg1, type2 arg2) { \
 161         _HOOK_PRE_FD(type, name, fd) \
 162         result = real_ ## name(arg1, arg2); \
 163         _HOOK_POST_FD(fd) \
 164     }
 165 #define HOOK_FD3(type, name, fd, type1, arg1, type2, arg2, type3, arg3) \
 166     static type (*real_ ## name)(type1, type2, type3); \
 167     type name(type1 arg1, type2 arg2, type3 arg3) { \
 168         _HOOK_PRE_FD(type, name, fd) \
 169         result = real_ ## name(arg1, arg2, arg3); \
 170         _HOOK_POST_FD(fd) \
 171     }
 172
 173 #define HOOK_FILE1(type, name, file, type1, arg1) \
 174     static type (*real_ ## name)(type1); \
 175     type name(type1 arg1) { \
 176         _HOOK_PRE_FILE(type, name, file) \
 177         result = real_ ## name(arg1); \
 178         _HOOK_POST_FILE(file) \
 179     }
 180 #define HOOK_FILE2(type, name, file, type1, arg1, type2, arg2) \
 181     static type (*real_ ## name)(type1, type2); \
 182     type name(type1 arg1, type2 arg2) { \
 183         _HOOK_PRE_FILE(type, name, file) \
 184         result = real_ ## name(arg1, arg2); \
 185         _HOOK_POST_FILE(file) \
 186     }
 187 #define HOOK_FILE3(type, name, file, type1, arg1, type2, arg2, type3, arg3) \
 188     static type (*real_ ## name)(type1, type2, type3); \
 189     type name(type1 arg1, type2 arg2, type3 arg3) { \
 190         _HOOK_PRE_FILE(type, name, file) \
 191         result = real_ ## name(arg1, arg2, arg3); \
 192         _HOOK_POST_FILE(file) \
 193     }
 194 #define HOOK_FILE4(type, name, file, type1, arg1, type2, arg2, type3, arg3, type4, arg4) \
 195     static type (*real_ ## name)(type1, type2, type3, type4); \
 196     type name(type1 arg1, type2 arg2, type3 arg3, type4 arg4) { \
 197         _HOOK_PRE_FILE(type, name, file) \
 198         result = real_ ## name(arg1, arg2, arg3, arg4); \
 199         _HOOK_POST_FILE(file) \
 200     }
 201
 202 #define HOOK_VAR_FILE1(type, name, file, func, type1, arg1) \
 203     type name(type1 arg1, ...) { \
 204         va_list ap; \
 205         va_start(ap, arg1); \
 206         type result = func(arg1, ap); \
 207         va_end(ap); \
 208         return result; \
 209     }
 210 #define HOOK_VAR_FILE2(type, name, file, func, type1, arg1, type2, arg2) \
 211     type name(type1 arg1, type2 arg2, ...) { \
 212         va_list ap; \
 213         va_start(ap, arg2); \
 214         type result = func(arg1, arg2, ap); \
 215         va_end(ap); \
 216         return result; \
 217     }
 218 #define HOOK_VAR_FILE3(type, name, file, func, type1, arg1, type2, arg2, type3, arg3) \
 219     type name(type1 arg1, type2 arg2, type3 arg3, ...) { \
 220         va_list ap; \
 221         va_start(ap, arg3); \
 222         type result = func(arg1, arg2, arg3, ap); \
 223         va_end(ap); \
 224         return result; \
 225     }
 226
 227 #endif