[u/mdw/catacomb] / fipstest.h

/* -*-c-*-
 *
 * $Id: fipstest.h,v 1.2 2000/08/11 21:34:34 mdw Exp $
 *
 * FIPS140 randomness tests
 *
 * (c) 2000 Straylight/Edgeware
 */

/*----- Licensing notice --------------------------------------------------* 
 *
 * This file is part of Catacomb.
 *
 * Catacomb is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Library General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, or (at your option) any later version.
 * 
 * Catacomb 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 Library General Public License for more details.
 * 
 * You should have received a copy of the GNU Library General Public
 * License along with Catacomb; if not, write to the Free
 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
 * MA 02111-1307, USA.
 */

/*----- Revision history --------------------------------------------------* 
 *
 * $Log: fipstest.h,v $
 * Revision 1.2  2000/08/11 21:34:34  mdw
 * Change to use the new thresholds given in the draft FIPS140-2.
 *
 * Revision 1.1  2000/06/17 10:55:38  mdw
 * FIPS 140-1 random generator test.
 *
 */

#ifndef CATACOMB_FIPSTEST_H
#define CATACOMB_FIPSTEST_H

#ifdef __cplusplus
  extern "C" {
#endif

/*----- Header files ------------------------------------------------------*/

#include <mLib/bits.h>

/*----- Magic numbers -----------------------------------------------------*/

#define FIPSTEST_BUFSZ 2500

enum {
  FIPSTEST_OK = 0,
  FIPSTEST_MONOBIT = 1,
  FIPSTEST_POKER = 2,
  FIPSTEST_RUNS = 4,
  FIPSTEST_LONGRUNS = 8
};

/*----- Functions provided ------------------------------------------------*/

/* --- @fipstest@ --- *
 *
 * Arguments:	@const octet *p@ = pointer to a buffer of @FIPSTEST_BUFSZ@
 *			bytes
 *
 * Returns:	Zero if OK, or a bitmask of failed tests.
 *
 * Use:		Performs the FIPS140 randomness tests on a block of data.
 */

extern unsigned fipstest(const octet */*p*/);

/*----- That's all, folks -------------------------------------------------*/

#ifdef __cplusplus
  }
#endif

#endif
Commit	Line	Data
44d4e7aa	1	/* --c--
44d4e7aa	2	*
5d14574b	3	* $Id: fipstest.h,v 1.2 2000/08/11 21:34:34 mdw Exp $
44d4e7aa	4	*
5d14574b	5	* FIPS140 randomness tests
44d4e7aa	6	*
	7	* (c) 2000 Straylight/Edgeware
	8	*/
	9
	10	/----- Licensing notice --------------------------------------------------
	11	*
	12	* This file is part of Catacomb.
	13	*
	14	* Catacomb is free software; you can redistribute it and/or modify
	15	* it under the terms of the GNU Library General Public License as
	16	* published by the Free Software Foundation; either version 2 of the
	17	* License, or (at your option) any later version.
	18	*
	19	* Catacomb is distributed in the hope that it will be useful,
	20	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	21	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	22	* GNU Library General Public License for more details.
	23	*
	24	* You should have received a copy of the GNU Library General Public
	25	* License along with Catacomb; if not, write to the Free
	26	* Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
	27	* MA 02111-1307, USA.
	28	*/
	29
	30	/----- Revision history --------------------------------------------------
	31	*
	32	* $Log: fipstest.h,v $
5d14574b	33	* Revision 1.2 2000/08/11 21:34:34 mdw
	34	* Change to use the new thresholds given in the draft FIPS140-2.
	35	*
44d4e7aa	36	* Revision 1.1 2000/06/17 10:55:38 mdw
	37	* FIPS 140-1 random generator test.
	38	*
	39	*/
	40
	41	#ifndef CATACOMB_FIPSTEST_H
	42	#define CATACOMB_FIPSTEST_H
	43
	44	#ifdef __cplusplus
	45	extern "C" {
	46	#endif
	47
	48	/----- Header files ------------------------------------------------------/
	49
	50	#include <mLib/bits.h>
	51
	52	/----- Magic numbers -----------------------------------------------------/
	53
	54	#define FIPSTEST_BUFSZ 2500
	55
	56	enum {
	57	FIPSTEST_OK = 0,
	58	FIPSTEST_MONOBIT = 1,
	59	FIPSTEST_POKER = 2,
	60	FIPSTEST_RUNS = 4,
	61	FIPSTEST_LONGRUNS = 8
	62	};
	63
	64	/----- Functions provided ------------------------------------------------/
	65
	66	/* --- @fipstest@ --- *
	67	*
	68	* Arguments: @const octet *p@ = pointer to a buffer of @FIPSTEST_BUFSZ@
	69	* bytes
	70	*
	71	* Returns: Zero if OK, or a bitmask of failed tests.
	72	*
5d14574b	73	* Use: Performs the FIPS140 randomness tests on a block of data.
44d4e7aa	74	*/
	75
	76	extern unsigned fipstest(const octet /p*/);
	77
	78	/----- That's all, folks -------------------------------------------------/
	79
	80	#ifdef __cplusplus
	81	}
	82	#endif
	83
	84	#endif