new file mode 100644

@@ -0,0 +1,57 @@

+/*

+ * Mtree module API specification

+ *

+ * This file is part of Kamailio, a free SIP server.

+ *

+ * Kamailio 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 2 of the License, or

+ * (at your option) any later version

+ *

+ * Kamailio 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, write to the Free Software

+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

+ *

+ */

+

+#ifndef _MTREE_API_H_

+#define _MTREE_API_H_

+

+#include "../../core/parser/msg_parser.h"

+

+typedef int (*mt_match_f)(sip_msg_t *msg, str *tname, str *tomatch, int mval);

+

+typedef struct mtree_api {

+	mt_match_f mt_match;

+	mt_match_f mt_match_value;

+	mt_match_f mt_match_values;

+} mtree_api_t;

+

+typedef int (*bind_mtree_f)(mtree_api_t* api);

+

+/**

+ * @brief Load Mtree API

+ */

+static inline int mtree_load_api(mtree_api_t *api)

+{

+	bind_mtree_f bind_mtree;

+

+	bind_mtree = (bind_mtree_f)find_export("bind_mtree", 0, 0);

+	if (bind_mtree == 0) {

+		LM_ERR("cannot find bind_mtree\n");

+		return -1;

+	}

+	if (bind_mtree(api) <0) {

+		LM_ERR("cannot bind mtree api\n");

+		return -1;

+	}

+	return 0;

+}

+

+

+#endif /* _MTREE_API_H_ */

@@ -46,5 +46,6 @@

     <toc></toc>

 	<xi:include href="mtree_admin.xml"/>

+	<xi:include href="mtree_devel.xml"/>

 </book>

new file mode 100644

@@ -0,0 +1,65 @@

+<?xml version="1.0" encoding='ISO-8859-1'?>

+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"

+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

+

+<!-- Include general documentation entities -->

+<!ENTITY % docentities SYSTEM "../../../../doc/docbook/entities.xml">

+%docentities;

+

+]>

+<!-- Module Developer's Guide -->

+

+<chapter>

+	

+	<title>&develguide;</title>

+	<section>

+	<title>Available Functions</title>

+	<section>

+		<title>

+		<function moreinfo="none">mt_load_api(api)

+			</function>

+		</title>

+		<para>

+		The function imports all API functions that are exported by the 

+		mtree module (see sections below).

+		</para>

+		<para>Meaning of the parameters is as follows:</para>

+		<itemizedlist>

+		<listitem>

+			<para><emphasis>mtree_api_t* api</emphasis> - mtree API

+			</para>

+		</listitem>

+		</itemizedlist>

+	</section>

+	<section>

+		<title>

+		<function moreinfo="none">mt_match(msg, mtree, value, mode)</function>

+		</title>

+		<para>

+		Match 'value' against 'mtree' using 'mode' (see mt_match

+        function Admin Guide documentation).

+		</para>

+		<para>Meaning of the parameters is as follows:</para>

+		<itemizedlist>

+		<listitem>

+			<para><emphasis>sip_msg_t *msg</emphasis> - SIP Request

+			</para>

+		</listitem>

+		<listitem>

+			<para><emphasis>str *mtree</emphasis> - Name of mtree

+			</para>

+		</listitem>

+		<listitem>

+			<para><emphasis>str *value</emphasis> - Value to match

+			</para>

+		</listitem>

+		<listitem>

+			<para><emphasis>int mode</emphasis> - Match mode

+			</para>

+		</listitem>

+		</itemizedlist>

+	</section>

+	</section>

+

+</chapter>

+

@@ -42,6 +42,7 @@

 #include "../../core/kemi.h"

 #include "mtree.h"

+#include "api.h"

 MODULE_VERSION

@@ -112,6 +113,7 @@ static int  mod_init(void);

 static void mod_destroy(void);

 static int  child_init(int rank);

 static int mtree_init_rpc(void);

+static int bind_mtree(mtree_api_t* api);

 static int mt_match(sip_msg_t *msg, str *tname, str *tomatch,

 		int mval);

@@ -122,6 +124,7 @@ static int mt_load_db_trees();

 static cmd_export_t cmds[]={

 	{"mt_match", (cmd_function)w_mt_match, 3, fixup_mt_match,

 		0, REQUEST_ROUTE|FAILURE_ROUTE|BRANCH_ROUTE|ONREPLY_ROUTE},

+	{"bind_mtree", (cmd_function)bind_mtree, 0, 0, 0},

 	{0, 0, 0, 0, 0, 0}

 };

@@ -1191,6 +1194,22 @@ static sr_kemi_t sr_kemi_mtree_exports[] = {

 	{ {0, 0}, {0, 0}, 0, NULL, { 0, 0, 0, 0, 0, 0 } }

 };

+

+/**

+ * load mtree module API

+ */

+static int bind_mtree(mtree_api_t* api)

+{

+	if (!api) {

+		LM_ERR("Invalid parameter value\n");

+		return -1;

+	}

+	api->mt_match = mt_match;

+

+	return 0;

+}

+

+

 /**

  *

  */