| 
									
										
										
										
											2008-03-03 19:11:41 +00:00
										 |  |  | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-03-03 19:11:41 +00:00
										 |  |  | <!--Converted with LaTeX2HTML 2002-2-1 (1.71)
 | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | original version by:  Nikos Drakos, CBLU, University of Leeds | 
					
						
							|  |  |  | * revised and updated by:  Marcus Hennecke, Ross Moore, Herb Swan | 
					
						
							|  |  |  | * with significant contributions from: | 
					
						
							|  |  |  |   Jens Lippmann, Marek Rouchal, Martin Wilck and others --> | 
					
						
							|  |  |  | <HTML> | 
					
						
							|  |  |  | <HEAD> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <TITLE>Engine structure</TITLE> | 
					
						
							|  |  |  | <META NAME="description" CONTENT="Engine structure"> | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | <META NAME="keywords" CONTENT="clamdoc"> | 
					
						
							|  |  |  | <META NAME="resource-type" CONTENT="document"> | 
					
						
							|  |  |  | <META NAME="distribution" CONTENT="global"> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-03-03 19:11:41 +00:00
										 |  |  | <META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1"> | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | <LINK REL="STYLESHEET" HREF="clamdoc.css"> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2007-10-08 19:22:34 +00:00
										 |  |  | <LINK REL="previous" HREF="node42.html"> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <LINK REL="up" HREF="node39.html"> | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | <LINK REL="next" HREF="node44.html"> | 
					
						
							|  |  |  | </HEAD> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | <BODY > | 
					
						
							| 
									
										
										
										
											2008-03-03 19:11:41 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | <DIV CLASS="navigation"><!--Navigation Panel--> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <A NAME="tex2html760" | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  |   HREF="node44.html"> | 
					
						
							|  |  |  | <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>  | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <A NAME="tex2html756" | 
					
						
							|  |  |  |   HREF="node39.html"> | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>  | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <A NAME="tex2html752" | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  |   HREF="node42.html"> | 
					
						
							|  |  |  | <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>  | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <A NAME="tex2html758" | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  |   HREF="node1.html"> | 
					
						
							|  |  |  | <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>   | 
					
						
							|  |  |  | <BR> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <B> Next:</B> <A NAME="tex2html761" | 
					
						
							|  |  |  |   HREF="node44.html">Database reloading</A> | 
					
						
							|  |  |  | <B> Up:</B> <A NAME="tex2html757" | 
					
						
							|  |  |  |   HREF="node39.html">API</A> | 
					
						
							|  |  |  | <B> Previous:</B> <A NAME="tex2html753" | 
					
						
							|  |  |  |   HREF="node42.html">Error handling</A> | 
					
						
							|  |  |  |    <B>  <A NAME="tex2html759" | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  |   HREF="node1.html">Contents</A></B>  | 
					
						
							|  |  |  | <BR> | 
					
						
							| 
									
										
										
										
											2008-03-03 19:11:41 +00:00
										 |  |  | <BR></DIV> | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | <!--End of Navigation Panel--> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <H3><A NAME="SECTION00073400000000000000"> | 
					
						
							|  |  |  | Engine structure</A> | 
					
						
							| 
									
										
										
										
											2007-10-08 19:22:34 +00:00
										 |  |  | </H3> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  |     When all required databases are loaded you should prepare the detection | 
					
						
							|  |  |  |     engine by calling <code>cl_build</code>. In the case of failure you should | 
					
						
							|  |  |  |     free the memory occupied by the engine with <code>cl_free</code>: | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  |     <PRE> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | 	int cl_build(struct cl_engine *engine); | 
					
						
							|  |  |  | 	void cl_free(struct cl_engine *engine); | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | </PRE> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  |     In our example: | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  |     <PRE> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | 	if((ret = cl_build(engine))) { | 
					
						
							|  |  |  | 	    printf("cl_build() error: %s\n", cl_strerror(ret)); | 
					
						
							|  |  |  | 	    cl_free(engine); | 
					
						
							|  |  |  | 	    exit(1); | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | 	} | 
					
						
							|  |  |  | </PRE> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | <P> | 
					
						
							| 
									
										
										
										
											2008-07-16 16:40:13 +00:00
										 |  |  | <BR><HR> | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | <ADDRESS> | 
					
						
							|  |  |  | Tomasz Kojm | 
					
						
							| 
									
										
										
										
											2008-08-15 17:03:57 +00:00
										 |  |  | 2008-08-15 | 
					
						
							| 
									
										
										
										
											2007-02-12 12:50:17 +00:00
										 |  |  | </ADDRESS> | 
					
						
							|  |  |  | </BODY> | 
					
						
							|  |  |  | </HTML> |