iPXE
ecdhe.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2025 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  * 02110-1301, USA.
18  *
19  * You can also choose to distribute this program under the terms of
20  * the Unmodified Binary Distribution Licence (as given in the file
21  * COPYING.UBDL), provided that you have satisfied its requirements.
22  */
23 
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
25 
26 /** @file
27  *
28  * Elliptic Curve Ephemeral Diffie-Hellman (ECDHE) key exchange
29  *
30  */
31 
32 #include <string.h>
33 #include <ipxe/ecdhe.h>
34 
35 /**
36  * Calculate ECDHE key
37  *
38  * @v curve Elliptic curve
39  * @v partner Partner public curve point
40  * @v private Private key
41  * @v public Public curve point to fill in (may overlap partner key)
42  * @v shared Shared secret curve point to fill in
43  * @ret rc Return status code
44  */
45 int ecdhe_key ( struct elliptic_curve *curve, const void *partner,
46  const void *private, void *public, void *shared ) {
47  int rc;
48 
49  /* Construct shared key */
50  if ( ( rc = elliptic_multiply ( curve, partner, private,
51  shared ) ) != 0 ) {
52  DBGC ( curve, "CURVE %s could not generate shared key: %s\n",
53  curve->name, strerror ( rc ) );
54  return rc;
55  }
56 
57  /* Construct public key */
58  if ( ( rc = elliptic_multiply ( curve, NULL, private,
59  public ) ) != 0 ) {
60  DBGC ( curve, "CURVE %s could not generate public key: %s\n",
61  curve->name, strerror ( rc ) );
62  return rc;
63  }
64 
65  return 0;
66 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
static int elliptic_multiply(struct elliptic_curve *curve, const void *base, const void *scalar, void *result)
Definition: crypto.h:310
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)
#define DBGC(...)
Definition: compiler.h:505
Elliptic Curve Ephemeral Diffie-Hellman (ECDHE) key exchange.
const char * name
Curve name.
Definition: crypto.h:186
int ecdhe_key(struct elliptic_curve *curve, const void *partner, const void *private, void *public, void *shared)
Calculate ECDHE key.
Definition: ecdhe.c:45
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
An elliptic curve.
Definition: crypto.h:184
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
String functions.
struct eth_slow_lacp_entity_tlv partner
Partner information.
Definition: eth_slow.h:16