/*

  *  Copyright (C) 2007-2008 Sourcefire, Inc.
  *
  *  Authors: Tomasz Kojm

  *
  *  This program is free software; you can redistribute it and/or modify

  *  it under the terms of the GNU General Public License version 2 as
  *  published by the Free Software Foundation.

  *
  *  This program 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 __CLAMAV_H
 #define __CLAMAV_H
 
 #include <sys/types.h>
 #include <sys/stat.h>

 #ifdef __cplusplus
 extern "C"
 {
 #endif
 
 #define CL_COUNT_PRECISION 4096
 
 /* return codes */

 #define CL_CLEAN	0   /* no virus found */
 #define CL_VIRUS	1   /* virus(es) found */

 #define CL_SUCCESS	CL_CLEAN

 #define CL_BREAK	2

 #define CL_EMAXREC	-100 /* (internal) recursion limit exceeded */
 #define CL_EMAXSIZE	-101 /* (internal) size limit exceeded */
 #define CL_EMAXFILES	-102 /* (internal) files limit exceeded */

 #define CL_ERAR		-103 /* rar handler error */
 #define CL_EZIP		-104 /* zip handler error */
 #define CL_EGZIP	-105 /* gzip handler error */
 #define CL_EBZIP	-106 /* bzip2 handler error */
 #define CL_EOLE2	-107 /* OLE2 handler error */
 #define CL_EMSCOMP	-108 /* MS Expand handler error */
 #define CL_EMSCAB	-109 /* MS CAB module error */
 #define CL_EACCES	-110 /* access denied */
 #define CL_ENULLARG	-111 /* null argument */
 #define CL_ETMPFILE	-112 /* tmpfile() failed */

 /* #define CL_EFSYNC	-113 *//* fsync() failed */

 #define CL_EMEM		-114 /* memory allocation error */
 #define CL_EOPEN	-115 /* file open error */
 #define CL_EMALFDB	-116 /* malformed database */
 #define CL_EPATSHORT	-117 /* pattern too short */
 #define CL_ETMPDIR	-118 /* mkdir() failed */
 #define CL_ECVD		-119 /* not a CVD file (or broken) */
 #define CL_ECVDEXTR	-120 /* CVD extraction failure */
 #define CL_EMD5		-121 /* MD5 verification error */
 #define CL_EDSIG	-122 /* digital signature verification error */
 #define CL_EIO		-123 /* general I/O error */

 #define CL_EFORMAT	-124 /* (internal) bad format or broken file */

 #define CL_ESUPPORT	-125 /* not supported data format */

 #define CL_EARJ         -127 /* ARJ handler error */

 /* db options */

 #define CL_DB_PHISHING	    0x2

 #define CL_DB_ACONLY	    0x4 /* WARNING: only for developers */

 #define CL_DB_PHISHING_URLS 0x8

 #define CL_DB_PUA	    0x10

 #define CL_DB_CVDNOTMP	    0x20

 #define CL_DB_OFFICIAL	    0x40

 #define CL_DB_PUA_MODE	    0x80
 #define CL_DB_PUA_INCLUDE   0x100
 #define CL_DB_PUA_EXCLUDE   0x200

 /* recommended db settings */

 #define CL_DB_STDOPT	    (CL_DB_PHISHING | CL_DB_PHISHING_URLS)

 /* scan options */

 #define CL_SCAN_RAW			0x0
 #define CL_SCAN_ARCHIVE			0x1
 #define CL_SCAN_MAIL			0x2
 #define CL_SCAN_OLE2			0x4
 #define CL_SCAN_BLOCKENCRYPTED		0x8
 #define CL_SCAN_HTML			0x10
 #define CL_SCAN_PE			0x20
 #define CL_SCAN_BLOCKBROKEN		0x40
 #define CL_SCAN_MAILURL			0x80
 #define CL_SCAN_BLOCKMAX		0x100 /* ignored */
 #define CL_SCAN_ALGORITHMIC		0x200
 #define CL_SCAN_PHISHING_BLOCKSSL	0x800 /* ssl mismatches, not ssl by itself*/
 #define CL_SCAN_PHISHING_BLOCKCLOAK	0x1000
 #define CL_SCAN_ELF			0x2000
 #define CL_SCAN_PDF			0x4000
 #define CL_SCAN_STRUCTURED		0x8000
 #define CL_SCAN_STRUCTURED_SSN_NORMAL	0x10000
 #define CL_SCAN_STRUCTURED_SSN_STRIPPED	0x20000

 #define CL_SCAN_PARTIAL_MESSAGE         0x40000

 #define CL_SCAN_HEURISTIC_PRECEDENCE    0x80000

 
 /* recommended scan settings */

 #define CL_SCAN_STDOPT		(CL_SCAN_ARCHIVE | CL_SCAN_MAIL | CL_SCAN_OLE2 | CL_SCAN_PDF | CL_SCAN_HTML | CL_SCAN_PE | CL_SCAN_ALGORITHMIC | CL_SCAN_ELF)

 struct cl_engine;

 #define CL_INIT_DEFAULT	0x0
 extern int cl_init(unsigned int options);

 extern struct cl_engine *cl_engine_new(void);

 enum cl_engine_field {
     CL_ENGINE_MAX_SCANSIZE,	    /* uint64_t */
     CL_ENGINE_MAX_FILESIZE,	    /* uint64_t */
     CL_ENGINE_MAX_RECURSION,	    /* uint32_t	*/
     CL_ENGINE_MAX_FILES,	    /* uint32_t */
     CL_ENGINE_MIN_CC_COUNT,	    /* uint32_t */
     CL_ENGINE_MIN_SSN_COUNT,	    /* uint32_t */

     CL_ENGINE_PUA_CATEGORIES,	    /* (char *) */
     CL_ENGINE_DB_VERSION,	    /* uint32_t */
     CL_ENGINE_DB_TIME		    /* uint32_t */

 };

 extern int cl_engine_set(struct cl_engine *engine, enum cl_engine_field field, const void *val);

 extern int cl_engine_get(const struct cl_engine *engine, enum cl_engine_field field, void *val);

 extern int cl_engine_compile(struct cl_engine *engine);

 extern int cl_engine_addref(struct cl_engine *engine);

 extern int cl_engine_free(struct cl_engine *engine);

 
 struct cl_stat {
     char *dir;

     unsigned int entries;

     struct stat *stattab;

     char **statdname;

 };
 

 struct cl_cvd {		    /* field no. */
     char *time;		    /* 2 */
     unsigned int version;   /* 3 */
     unsigned int sigs;	    /* 4 */
     unsigned int fl;	    /* 5 */
     char *md5;		    /* 6 */
     char *dsig;		    /* 7 */
     char *builder;	    /* 8 */
     unsigned int stime;	    /* 9 */

 };
 

 /* file scanning */

 extern int cl_scandesc(int desc, const char **virname, unsigned long int *scanned, const struct cl_engine *engine, unsigned int options);

 extern int cl_scanfile(const char *filename, const char **virname, unsigned long int *scanned, const struct cl_engine *engine, unsigned int options);

 /* database handling */

 extern int cl_load(const char *path, struct cl_engine *engine, unsigned int *signo, unsigned int options);

 extern const char *cl_retdbdir(void);

 
 /* engine handling */

 /* CVD */

 extern struct cl_cvd *cl_cvdhead(const char *file);

 extern struct cl_cvd *cl_cvdparse(const char *head);
 extern int cl_cvdverify(const char *file);

 extern void cl_cvdfree(struct cl_cvd *cvd);
 

 /* db dir stat functions */

 extern int cl_statinidir(const char *dirname, struct cl_stat *dbstat);
 extern int cl_statchkdir(const struct cl_stat *dbstat);
 extern int cl_statfree(struct cl_stat *dbstat);
 

 /* enable debug messages */

 extern void cl_debug(void);

 /* software versions */
 extern unsigned int cl_retflevel(void);
 extern const char *cl_retver(void);

 /* others */
 extern void cl_settempdir(const char *dir, short leavetemps);

 extern const char *cl_strerror(int clerror);

 
 #ifdef __cplusplus

 }

 #endif
  

 #endif /* __CLAMAV_H */