/* External interfaces usable by dynamic objects loaded into GNU Make.

[0] Fix | Delete

--THIS API IS A "TECHNOLOGY PREVIEW" ONLY. IT IS NOT A STABLE INTERFACE--

[1] Fix | Delete

[2] Fix | Delete

Copyright (C) 2013-2016 Free Software Foundation, Inc.

[3] Fix | Delete

This file is part of GNU Make.

[4] Fix | Delete

[5] Fix | Delete

GNU Make is free software; you can redistribute it and/or modify it under the

[6] Fix | Delete

terms of the GNU General Public License as published by the Free Software

[7] Fix | Delete

Foundation; either version 3 of the License, or (at your option) any later

[8] Fix | Delete

version.

[9] Fix | Delete

[10] Fix | Delete

GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY

[11] Fix | Delete

WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR

[12] Fix | Delete

A PARTICULAR PURPOSE. See the GNU General Public License for more details.

[13] Fix | Delete

[14] Fix | Delete

You should have received a copy of the GNU General Public License along with

[15] Fix | Delete

this program. If not, see <http://www.gnu.org/licenses/>. */

[16] Fix | Delete

[17] Fix | Delete

#ifndef _GNUMAKE_H_

[18] Fix | Delete

#define _GNUMAKE_H_

[19] Fix | Delete

[20] Fix | Delete

/* Specify the location of elements read from makefiles. */

[21] Fix | Delete

typedef struct

[22] Fix | Delete

{

[23] Fix | Delete

const char *filenm;

[24] Fix | Delete

unsigned long lineno;

[25] Fix | Delete

} gmk_floc;

[26] Fix | Delete

[27] Fix | Delete

typedef char *(*gmk_func_ptr)(const char *nm, unsigned int argc, char **argv);

[28] Fix | Delete

[29] Fix | Delete

#ifdef _WIN32

[30] Fix | Delete

# ifdef GMK_BUILDING_MAKE

[31] Fix | Delete

# define GMK_EXPORT __declspec(dllexport)

[32] Fix | Delete

# else

[33] Fix | Delete

# define GMK_EXPORT __declspec(dllimport)

[34] Fix | Delete

# endif

[35] Fix | Delete

#else

[36] Fix | Delete

# define GMK_EXPORT

[37] Fix | Delete

#endif

[38] Fix | Delete

[39] Fix | Delete

/* Free memory returned by the gmk_expand() function. */

[40] Fix | Delete

GMK_EXPORT void gmk_free (char *str);

[41] Fix | Delete

[42] Fix | Delete

/* Allocate memory in GNU make's context. */

[43] Fix | Delete

GMK_EXPORT char *gmk_alloc (unsigned int len);

[44] Fix | Delete

[45] Fix | Delete

/* Run $(eval ...) on the provided string BUFFER. */

[46] Fix | Delete

GMK_EXPORT void gmk_eval (const char *buffer, const gmk_floc *floc);

[47] Fix | Delete

[48] Fix | Delete

/* Run GNU make expansion on the provided string STR.

[49] Fix | Delete

Returns an allocated buffer that the caller must free with gmk_free(). */

[50] Fix | Delete

GMK_EXPORT char *gmk_expand (const char *str);

[51] Fix | Delete

[52] Fix | Delete

/* Register a new GNU make function NAME (maximum of 255 chars long).

[53] Fix | Delete

When the function is expanded in the makefile, FUNC will be invoked with

[54] Fix | Delete

the appropriate arguments.

[55] Fix | Delete

[56] Fix | Delete

The return value of FUNC must be either NULL, in which case it expands to

[57] Fix | Delete

the empty string, or a pointer to the result of the expansion in a string

[58] Fix | Delete

created by gmk_alloc(). GNU make will free the memory when it's done.

[59] Fix | Delete

[60] Fix | Delete

MIN_ARGS is the minimum number of arguments the function requires.

[61] Fix | Delete

MAX_ARGS is the maximum number of arguments (or 0 if there's no maximum).

[62] Fix | Delete

MIN_ARGS and MAX_ARGS may not exceed 255.

[63] Fix | Delete

[64] Fix | Delete

The FLAGS value may be GMK_FUNC_DEFAULT, or one or more of the following

[65] Fix | Delete

flags OR'd together:

[66] Fix | Delete

[67] Fix | Delete

GMK_FUNC_NOEXPAND: the arguments to the function will be not be expanded

[68] Fix | Delete

before FUNC is called.

[69] Fix | Delete

*/

[70] Fix | Delete

GMK_EXPORT void gmk_add_function (const char *name, gmk_func_ptr func,

[71] Fix | Delete

unsigned int min_args, unsigned int max_args,

[72] Fix | Delete

unsigned int flags);

[73] Fix | Delete

[74] Fix | Delete

#define GMK_FUNC_DEFAULT 0x00

[75] Fix | Delete

#define GMK_FUNC_NOEXPAND 0x01

[76] Fix | Delete

[77] Fix | Delete

#endif /* _GNUMAKE_H_ */

[78] Fix | Delete

[79] Fix | Delete