| /* External interfaces usable by dynamic objects loaded into GNU Make. |
| --THIS API IS A "TECHNOLOGY PREVIEW" ONLY. IT IS NOT A STABLE INTERFACE-- |
| |
| Copyright (C) 2013 Free Software Foundation, Inc. |
| This file is part of GNU Make. |
| |
| GNU Make is free software; you can redistribute it and/or modify it under the |
| terms of the GNU General Public License as published by the Free Software |
| Foundation; either version 3 of the License, or (at your option) any later |
| version. |
| |
| GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY |
| WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR |
| A PARTICULAR PURPOSE. See the GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License along with |
| this program. If not, see <http://www.gnu.org/licenses/>. */ |
| |
| #ifndef _GNUMAKE_H_ |
| #define _GNUMAKE_H_ |
| |
| /* Specify the location of elements read from makefiles. */ |
| typedef struct |
| { |
| const char *filenm; |
| unsigned long lineno; |
| } gmk_floc; |
| |
| |
| #ifdef _WIN32 |
| # ifdef GMK_BUILDING_MAKE |
| # define GMK_EXPORT __declspec(dllexport) |
| # else |
| # define GMK_EXPORT __declspec(dllimport) |
| # endif |
| #else |
| # define GMK_EXPORT |
| #endif |
| |
| /* Free memory returned by the gmk_expand() function. */ |
| void GMK_EXPORT gmk_free (char *str); |
| |
| /* Allocate memory in GNU make's context. */ |
| char * GMK_EXPORT gmk_alloc (unsigned int len); |
| |
| /* Run $(eval ...) on the provided string BUFFER. */ |
| void GMK_EXPORT gmk_eval (const char *buffer, const gmk_floc *floc); |
| |
| /* Run GNU make expansion on the provided string STR. |
| Returns an allocated buffer that the caller must free with gmk_free(). */ |
| char * GMK_EXPORT gmk_expand (const char *str); |
| |
| /* Register a new GNU make function NAME (maximum of 255 chars long). |
| When the function is expanded in the makefile, FUNC will be invoked with |
| the appropriate arguments. |
| |
| The return value of FUNC must be either NULL, in which case it expands to |
| the empty string, or a pointer to the result of the expansion in a string |
| created by gmk_alloc(). GNU make will free the memory when it's done. |
| |
| MIN_ARGS is the minimum number of arguments the function requires. |
| MAX_ARGS is the maximum number of arguments (or 0 if there's no maximum). |
| MIN_ARGS and MAX_ARGS must be >= 0 and <= 255. |
| |
| If EXPAND_ARGS is 0, the arguments to the function will not be expanded |
| before FUNC is called. If EXPAND_ARGS is non-0, they will be expanded. |
| */ |
| void GMK_EXPORT gmk_add_function (const char *name, |
| char *(*func)(const char *nm, |
| int argc, char **argv), |
| int min_args, int max_args, int expand_args); |
| |
| #endif /* _GNUMAKE_H_ */ |