jdk-sandbox: jdk/src/share/native/sun/security/ec/ec2.h@e549cea58864 (annotated)

3492 e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	1	/* *********************************************************************
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	2	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	3	* Sun elects to have this file available under and governed by the
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	4	* Mozilla Public License Version 1.1 ("MPL") (see
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	5	* http://www.mozilla.org/MPL/ for full license text). For the avoidance
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	6	* of doubt and subject to the following, Sun also elects to allow
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	7	* licensees to use this file under the MPL, the GNU General Public
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	8	* License version 2 only or the Lesser General Public License version
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	9	* 2.1 only. Any references to the "GNU General Public License version 2
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	10	* or later" or "GPL" in the following shall be construed to mean the
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	11	* GNU General Public License version 2 only. Any references to the "GNU
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	12	* Lesser General Public License version 2.1 or later" or "LGPL" in the
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	13	* following shall be construed to mean the GNU Lesser General Public
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	14	* License version 2.1 only. However, the following notice accompanied
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	15	* the original version of this file:
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	16	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	17	* Version: MPL 1.1/GPL 2.0/LGPL 2.1
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	18	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	19	* The contents of this file are subject to the Mozilla Public License Version
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	20	* 1.1 (the "License"); you may not use this file except in compliance with
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	21	* the License. You may obtain a copy of the License at
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	22	* http://www.mozilla.org/MPL/
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	23	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	24	* Software distributed under the License is distributed on an "AS IS" basis,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	25	* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	26	* for the specific language governing rights and limitations under the
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	27	* License.
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	28	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	29	* The Original Code is the elliptic curve math library for binary polynomial field curves.
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	30	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	31	* The Initial Developer of the Original Code is
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	32	* Sun Microsystems, Inc.
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	33	* Portions created by the Initial Developer are Copyright (C) 2003
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	34	* the Initial Developer. All Rights Reserved.
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	35	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	36	* Contributor(s):
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	37	* Douglas Stebila <douglas@stebila.ca>, Sun Microsystems Laboratories
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	38	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	39	* Alternatively, the contents of this file may be used under the terms of
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	40	* either the GNU General Public License Version 2 or later (the "GPL"), or
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	41	* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	42	* in which case the provisions of the GPL or the LGPL are applicable instead
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	43	* of those above. If you wish to allow use of your version of this file only
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	44	* under the terms of either the GPL or the LGPL, and not to allow others to
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	45	* use your version of this file under the terms of the MPL, indicate your
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	46	* decision by deleting the provisions above and replace them with the notice
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	47	* and other provisions required by the GPL or the LGPL. If you do not delete
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	48	* the provisions above, a recipient may use your version of this file under
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	49	* the terms of any one of the MPL, the GPL or the LGPL.
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	50	*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	51	*********************************************************************** */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	52	/*
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	53	* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	54	* Use is subject to license terms.
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	55	*/
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	56
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	57	#ifndef _EC2_H
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	58	#define _EC2_H
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	59
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	60	#pragma ident "%Z%%M% %I% %E% SMI"
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	61
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	62	#include "ecl-priv.h"
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	63
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	64	/* Checks if point P(px, py) is at infinity. Uses affine coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	65	mp_err ec_GF2m_pt_is_inf_aff(const mp_int px, const mp_int py);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	66
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	67	/* Sets P(px, py) to be the point at infinity. Uses affine coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	68	mp_err ec_GF2m_pt_set_inf_aff(mp_int px, mp_int py);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	69
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	70	/* Computes R = P + Q where R is (rx, ry), P is (px, py) and Q is (qx,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	71	* qy). Uses affine coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	72	mp_err ec_GF2m_pt_add_aff(const mp_int px, const mp_int py,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	73	const mp_int qx, const mp_int qy, mp_int *rx,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	74	mp_int ry, const ECGroup group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	75
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	76	/* Computes R = P - Q. Uses affine coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	77	mp_err ec_GF2m_pt_sub_aff(const mp_int px, const mp_int py,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	78	const mp_int qx, const mp_int qy, mp_int *rx,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	79	mp_int ry, const ECGroup group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	80
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	81	/* Computes R = 2P. Uses affine coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	82	mp_err ec_GF2m_pt_dbl_aff(const mp_int px, const mp_int py, mp_int *rx,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	83	mp_int ry, const ECGroup group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	84
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	85	/* Validates a point on a GF2m curve. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	86	mp_err ec_GF2m_validate_point(const mp_int px, const mp_int py, const ECGroup *group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	87
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	88	/* by default, this routine is unused and thus doesn't need to be compiled */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	89	#ifdef ECL_ENABLE_GF2M_PT_MUL_AFF
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	90	/* Computes R = nP where R is (rx, ry) and P is (px, py). The parameters
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	91	* a, b and p are the elliptic curve coefficients and the irreducible that
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	92	* determines the field GF2m. Uses affine coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	93	mp_err ec_GF2m_pt_mul_aff(const mp_int n, const mp_int px,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	94	const mp_int py, mp_int rx, mp_int *ry,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	95	const ECGroup *group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	96	#endif
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	97
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	98	/* Computes R = nP where R is (rx, ry) and P is (px, py). The parameters
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	99	* a, b and p are the elliptic curve coefficients and the irreducible that
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	100	* determines the field GF2m. Uses Montgomery projective coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	101	mp_err ec_GF2m_pt_mul_mont(const mp_int n, const mp_int px,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	102	const mp_int py, mp_int rx, mp_int *ry,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	103	const ECGroup *group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	104
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	105	#ifdef ECL_ENABLE_GF2M_PROJ
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	106	/* Converts a point P(px, py) from affine coordinates to projective
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	107	* coordinates R(rx, ry, rz). */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	108	mp_err ec_GF2m_pt_aff2proj(const mp_int px, const mp_int py, mp_int *rx,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	109	mp_int ry, mp_int rz, const ECGroup *group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	110
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	111	/* Converts a point P(px, py, pz) from projective coordinates to affine
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	112	* coordinates R(rx, ry). */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	113	mp_err ec_GF2m_pt_proj2aff(const mp_int px, const mp_int py,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	114	const mp_int pz, mp_int rx, mp_int *ry,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	115	const ECGroup *group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	116
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	117	/* Checks if point P(px, py, pz) is at infinity. Uses projective
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	118	* coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	119	mp_err ec_GF2m_pt_is_inf_proj(const mp_int px, const mp_int py,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	120	const mp_int *pz);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	121
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	122	/* Sets P(px, py, pz) to be the point at infinity. Uses projective
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	123	* coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	124	mp_err ec_GF2m_pt_set_inf_proj(mp_int px, mp_int py, mp_int *pz);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	125
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	126	/* Computes R = P + Q where R is (rx, ry, rz), P is (px, py, pz) and Q is
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	127	* (qx, qy, qz). Uses projective coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	128	mp_err ec_GF2m_pt_add_proj(const mp_int px, const mp_int py,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	129	const mp_int pz, const mp_int qx,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	130	const mp_int qy, mp_int rx, mp_int *ry,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	131	mp_int rz, const ECGroup group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	132
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	133	/* Computes R = 2P. Uses projective coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	134	mp_err ec_GF2m_pt_dbl_proj(const mp_int px, const mp_int py,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	135	const mp_int pz, mp_int rx, mp_int *ry,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	136	mp_int rz, const ECGroup group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	137
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	138	/* Computes R = nP where R is (rx, ry) and P is (px, py). The parameters
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	139	* a, b and p are the elliptic curve coefficients and the prime that
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	140	* determines the field GF2m. Uses projective coordinates. */
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	141	mp_err ec_GF2m_pt_mul_proj(const mp_int n, const mp_int px,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	142	const mp_int py, mp_int rx, mp_int *ry,
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	143	const ECGroup *group);
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	144	#endif
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	145
e549cea58864 6840752: Provide out-of-the-box support for ECC algorithms vinnie parents: diff changeset	146	#endif /* _EC2_H */

author	vinnie
	Tue, 11 Aug 2009 16:52:26 +0100
changeset 3492	e549cea58864
permissions	-rw-r--r--