libgaviotatb-dev 0.4-2 / usr / include / gtb-probe.h

/*
This Software is distributed with the following X11 License,
sometimes also known as MIT license.
 
Copyright (c) 2010 Miguel A. Ballicora

 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation
 files (the "Software"), to deal in the Software without
 restriction, including without limitation the rights to use,
 copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the
 Software is furnished to do so, subject to the following
 conditions:

 The above copyright notice and this permission notice shall be
 included in all copies or substantial portions of the Software.

 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
 OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 OTHER DEALINGS IN THE SOFTWARE.
*/

#if !defined(H_GTBPROBE)
#define H_GTBPROBE
#ifdef __cplusplus
extern "C" {
#endif
/*>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>*/

#include <stdlib.h>

#define tb_MAXPATHLEN 1024

/*----------------------------------*\
|            CONSTANTS
\*----------------------------------*/

enum TB_mask_values { tb_RESMASK = 3, tb_INFOMASK = 7, tb_PLYSHIFT = 3 };

enum TB_return_values {   
   tb_DRAW = 0,
   tb_WMATE = 1,
   tb_BMATE = 2,
   tb_FORBID = 3,
   tb_UNKNOWN = 7
};

enum TB_pieces    {
   tb_NOPIECE, tb_PAWN, tb_KNIGHT, tb_BISHOP, tb_ROOK, tb_QUEEN, tb_KING
};

enum TB_sides {
   tb_WHITE_TO_MOVE, tb_BLACK_TO_MOVE
};

enum TB_squares {
   tb_A1, tb_B1, tb_C1, tb_D1, tb_E1, tb_F1, tb_G1, tb_H1,
   tb_A2, tb_B2, tb_C2, tb_D2, tb_E2, tb_F2, tb_G2, tb_H2,
   tb_A3, tb_B3, tb_C3, tb_D3, tb_E3, tb_F3, tb_G3, tb_H3,
   tb_A4, tb_B4, tb_C4, tb_D4, tb_E4, tb_F4, tb_G4, tb_H4,
   tb_A5, tb_B5, tb_C5, tb_D5, tb_E5, tb_F5, tb_G5, tb_H5,
   tb_A6, tb_B6, tb_C6, tb_D6, tb_E6, tb_F6, tb_G6, tb_H6,
   tb_A7, tb_B7, tb_C7, tb_D7, tb_E7, tb_F7, tb_G7, tb_H7,
   tb_A8, tb_B8, tb_C8, tb_D8, tb_E8, tb_F8, tb_G8, tb_H8,
   tb_NOSQUARE
};

enum TB_castling {
   tb_NOCASTLE = 0,
   tb_WOO  = 8,
   tb_WOOO = 4,    
   tb_BOO  = 2,
   tb_BOOO = 1
};

enum TB_compression_scheme {
	tb_UNCOMPRESSED, tb_CP1, tb_CP2, tb_CP3, tb_CP4 
};

/*----------------------------------*\
|         	FUNCTIONS
\*----------------------------------*/

extern char *		tb_init   (int verbosity, int compression_scheme, const char **paths);

extern char *		tb_restart(int verbosity, int compression_scheme, const char **paths);

extern void			tb_done (void);

extern int /*bool*/	tb_probe_hard 
							(unsigned stm, 
			 				 unsigned epsq,
							 unsigned castles,
			 				 const unsigned *inp_wSQ, 
			 				 const unsigned *inp_bSQ,
			 				 const unsigned char *inp_wPC, 
			 				 const unsigned char *inp_bPC,
			 				 /*@out@*/ unsigned *tbinfo, 
			 				 /*@out@*/ unsigned *plies);

extern int /*bool*/	tb_probe_soft 
							(unsigned stm, 
			 				 unsigned epsq,
							 unsigned castles,
			 				 const unsigned *inp_wSQ, 
			 				 const unsigned *inp_bSQ,
			 				 const unsigned char *inp_wPC, 
			 				 const unsigned char *inp_bPC,
			 				 /*@out@*/ unsigned *tbinfo, 
			 				 /*@out@*/ unsigned *plies);

extern int /*bool*/	tb_probe_WDL_hard 
							(unsigned stm, 
			 				 unsigned epsq,
							 unsigned castles,
			 				 const unsigned *inp_wSQ, 
			 				 const unsigned *inp_bSQ,
			 				 const unsigned char *inp_wPC, 
			 				 const unsigned char *inp_bPC,
			 				 /*@out@*/ unsigned *tbinfo); 

extern int /*bool*/	tb_probe_WDL_soft 
							(unsigned stm, 
			 				 unsigned epsq,
							 unsigned castles,
			 				 const unsigned *inp_wSQ, 
			 				 const unsigned *inp_bSQ,
			 				 const unsigned char *inp_wPC, 
			 				 const unsigned char *inp_bPC,
			 				 /*@out@*/ unsigned *tbinfo);

extern int /*bool*/	tb_is_initialized (void);

/* 	
|	tb_availability() returns 0 if no TBs available 
|	Otherwise, the following bits are turned 'on' if...
|	----------------------------------
|	bit: meaning
|	----------------------------------
|	0: at least one 3-pc TB is present
|	1: 3-pc TBs are complete
|	2: at least one 4-pc TB is present
|	3: 4-pc TBs are complete
|	4: at least one 5-pc TB is present
|	5: 5-pc TBs are complete
|	6: at least one 6-pc TB is present
|	7: 6-pc TBs are complete
|	Example: if 63 is returned, it means all 3-4-5-pc TBs are present
|	Bits 6 and 7 will be always off, of course, until 6-piece TBs
|	are supported.
*/

extern unsigned int	tb_availability(void);

/* 	
|	tb_indexmemory ()returns 
|	how much memory has been allocated for indexes 
*/

extern size_t		tb_indexmemory (void);

/*----------------------------------*\
|         	cache
\*----------------------------------*/

extern int /*bool*/	tbcache_init    (size_t cache_mem, int wdl_fraction);
extern int /*bool*/	tbcache_restart (size_t cache_mem, int wdl_fraction);
extern void			tbcache_done (void);
extern int /*bool*/	tbcache_is_on (void);
extern void			tbcache_flush (void);

/*----------------------------------*\
|         	STATS
\*----------------------------------*/

/*
|	For maximum portability, some stats are provided
|	in two 32 bits integers rather than a single 64 bit number. 
|	For intance, prob_hard_hits[0] contains the less significant 32 bits 
|	(0 to 31), and prob_hard_hits[1] the most significant ones (32 to 63). 
|	The 64-bit number can be recreated like this:
|	uint64_t x;
|	x = (uint64_t)probe_hard_hits[0]|((uint64_t)probe_hard_hits[1]<<32);
|	The user has the responsibility to combine the numbers and use the 
|	proper 64 bit integers.
*/

struct TB_STATS {
	long unsigned int wdl_easy_hits  [2]; /* hits that were found in own wdl cache */
	long unsigned int wdl_hard_prob  [2]; /* hard probes to the wdl cache: if fail, they will go to HD */
	long unsigned int wdl_soft_prob  [2]; /* soft probes to the wdl cache: if fail, they won't go to HD */	
	size_t			  wdl_cachesize     ; /* size allocated for wdl cache */
	double			  wdl_occupancy     ; /* % of slots filled in wdl cache */

	long unsigned int dtm_easy_hits  [2]; /* hits that were found in own dtm cache */
	long unsigned int dtm_hard_prob  [2]; /* hard probes to the dtm cache: if fail, they will go to HD */
	long unsigned int dtm_soft_prob  [2]; /* soft probes to the dtm cache: if fail, they won't go to HD */	
	size_t			  dtm_cachesize     ; /* size allocated for dtm cache */
	double			  dtm_occupancy     ; /* % of slots filled in dtm cache */

	long unsigned int  total_hits    [2]; /* succesful probes */
	long unsigned int memory_hits    [2]; /* succesful probes to memory */
	long unsigned int  drive_hits    [2]; /* succesful probes to the Hard drive */
	long unsigned int  drive_miss    [2]; /* failing   probes to the Hard drive */
	long unsigned int  bytes_read    [2]; /* bytes read from Hard drive */
	long unsigned int files_opened      ; /* number of files newly opened */
	double			  memory_efficiency ; /* % hits from memory over total hits */
};

extern void			tbstats_reset (void);
extern void 		tbstats_get (struct TB_STATS *stats);


/*----------------------------------*\
|         	PATH MANAGEMENT
\*----------------------------------*/

extern const char ** 		tbpaths_init	(void);
extern const char ** 		tbpaths_add		(const char **ps, const char *newpath);
extern const char ** 		tbpaths_done	(const char **ps);

extern const char *			tbpaths_getmain (void);

/*<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<*/
#ifdef __cplusplus
}
#endif
#endif