ssh_kex_kem.c File Reference

Pure post-quantum key exchange. More...

#include "ssh/ssh.h"
#include "ssh/ssh_algorithms.h"
#include "ssh/ssh_transport.h"
#include "ssh/ssh_kex.h"
#include "ssh/ssh_kex_kem.h"
#include "ssh/ssh_packet.h"
#include "ssh/ssh_key_material.h"
#include "ssh/ssh_exchange_hash.h"
#include "ssh/ssh_key_verify.h"
#include "ssh/ssh_cert_verify.h"
#include "ssh/ssh_misc.h"
#include "debug.h"

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   SSH_TRACE_LEVEL

Functions
error_t	sshSendKexKemInit (SshConnection *connection)
	Send SSH_MSG_KEX_KEM_INIT message. More...
error_t	sshSendKexKemReply (SshConnection *connection)
	Send SSH_MSG_KEX_KEM_REPLY message. More...
error_t	sshFormatKexKemInit (SshConnection *connection, uint8_t *p, size_t *length)
	Format SSH_MSG_KEX_KEM_INIT message. More...
error_t	sshFormatKexKemReply (SshConnection *connection, uint8_t *p, size_t *length)
	Format SSH_MSG_KEX_KEM_REPLY message. More...
error_t	sshParseKexKemInit (SshConnection *connection, const uint8_t *message, size_t length)
	Parse SSH_MSG_KEX_KEM_INIT message. More...
error_t	sshParseKexKemReply (SshConnection *connection, const uint8_t *message, size_t length)
	Parse SSH_MSG_KEX_KEM_REPLY message. More...
error_t	sshParseKexKemMessage (SshConnection *connection, uint8_t type, const uint8_t *message, size_t length)
	Parse ML-KEM specific messages. More...
error_t	sshSelectKemAlgo (SshConnection *connection)
	Select key encapsulation mechanism. More...

Detailed Description

Pure post-quantum key exchange.

License

SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2019-2026 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneSSH Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

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.

Author

Oryx Embedded SARL (www.oryx-embedded.com)

Version

2.6.0

Definition in file ssh_kex_kem.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   SSH_TRACE_LEVEL

Definition at line 32 of file ssh_kex_kem.c.

Function Documentation

sshFormatKexKemInit()

error_t sshFormatKexKemInit	(	SshConnection *	connection,
		uint8_t *	p,
		size_t *	length
	)

Format SSH_MSG_KEX_KEM_INIT message.

Parameters

[in]	connection	Pointer to the SSH connection
[out]	p	Buffer where to format the message
[out]	length	Length of the resulting message, in bytes

Returns

Error code

Definition at line 171 of file ssh_kex_kem.c.

sshFormatKexKemReply()

error_t sshFormatKexKemReply	(	SshConnection *	connection,
		uint8_t *	p,
		size_t *	length
	)

Format SSH_MSG_KEX_KEM_REPLY message.

Parameters

[in]	connection	Pointer to the SSH connection
[out]	p	Buffer where to format the message
[out]	length	Length of the resulting message, in bytes

Returns

Error code

Definition at line 215 of file ssh_kex_kem.c.

sshParseKexKemInit()

error_t sshParseKexKemInit	(	SshConnection *	connection,
		const uint8_t *	message,
		size_t	length
	)

Parse SSH_MSG_KEX_KEM_INIT message.

Parameters

[in]	connection	Pointer to the SSH connection
[in]	message	Pointer to message
[in]	length	Length of the message, in bytes

Returns

Error code

Definition at line 324 of file ssh_kex_kem.c.

sshParseKexKemMessage()

error_t sshParseKexKemMessage	(	SshConnection *	connection,
		uint8_t	type,
		const uint8_t *	message,
		size_t	length
	)

Parse ML-KEM specific messages.

Parameters

[in]	connection	Pointer to the SSH connection
[in]	type	SSH message type
[in]	message	Pointer to message
[in]	length	Length of the message, in bytes

Returns

Error code

Definition at line 587 of file ssh_kex_kem.c.

sshParseKexKemReply()

error_t sshParseKexKemReply	(	SshConnection *	connection,
		const uint8_t *	message,
		size_t	length
	)

Parse SSH_MSG_KEX_KEM_REPLY message.

Parameters

[in]	connection	Pointer to the SSH connection
[in]	message	Pointer to message
[in]	length	Length of the message, in bytes

Returns

Error code

Definition at line 411 of file ssh_kex_kem.c.

sshSelectKemAlgo()

error_t sshSelectKemAlgo

(

SshConnection *

connection

)

Select key encapsulation mechanism.

Parameters

[in]

connection

Pointer to the SSH connection

Returns

Error code

Definition at line 645 of file ssh_kex_kem.c.

sshSendKexKemInit()

error_t sshSendKexKemInit

(

SshConnection *

connection

)

Send SSH_MSG_KEX_KEM_INIT message.

Parameters

[in]

connection

Pointer to the SSH connection

Returns

Error code

Definition at line 58 of file ssh_kex_kem.c.

sshSendKexKemReply()

error_t sshSendKexKemReply

(

SshConnection *

connection

)

Send SSH_MSG_KEX_KEM_REPLY message.

Parameters

[in]

connection

Pointer to the SSH connection

Returns

Error code

Definition at line 123 of file ssh_kex_kem.c.