openssl/demos
Jiasheng Jiang 87e747000f Replace size_t with int and add the check for the EVP_MD_get_size()
Replace the type of "digest_size" with int to avoid implicit conversion when it is assigned by EVP_MD_get_size().
Moreover, add the check for the "digest_size".

Fixes: 29ce1066bc ("Update the demos/README file because it is really old. New demos should provide best practice for API use. Add demonstration for computing a SHA3-512 digest - digest/EVP_MD_demo")
Signed-off-by: Jiasheng Jiang <jiasheng@purdue.edu>

Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Kurt Roeckx <kurt@roeckx.be>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/23924)
2024-03-25 17:49:03 +01:00
..
bio demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
certs demos: fix cert scripts 2023-12-29 10:22:05 +01:00
cipher demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
cms demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
digest Replace size_t with int and add the check for the EVP_MD_get_size() 2024-03-25 17:49:03 +01:00
encode demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
encrypt demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
guide augment quic demos to support ipv4/6 connections 2023-11-21 13:01:54 +01:00
http3 demos/http3: Use `SSL_write_ex2()` together with `SSL_WRITE_FLAG_CONCLUDE` 2024-03-01 10:56:16 +01:00
kdf demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
keyexch demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
mac demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
pkcs12 Copyright year updates 2023-09-07 09:59:15 +01:00
pkey demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
signature demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
smime demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
sslecho fix demos/sslecho/main.c so it builds on OpenBSD too 2024-03-25 13:49:47 +01:00
Makefile demos: tidy up makefiles, fix warnings 2023-11-15 08:43:23 +01:00
README.txt Update to the demos README file 2023-10-30 07:53:40 +00:00

README.txt

OpenSSL Demonstration Applications

This folder contains source code that demonstrates the proper use of the OpenSSL
library API.

bio:                   Demonstration of a simple TLS client and server

certs:                 Demonstration of creating certs, using OCSP

cipher:
aesgcm.c               Demonstration of symmetric cipher GCM mode encrypt/decrypt
aesccm.c               Demonstration of symmetric cipher CCM mode encrypt/decrypt
ariacbc.c              Demonstration of symmetric cipher CBC mode encrypt/decrypt

cms:                   Demonstrations related to the Cryptographic Message
                       Syntax (CMS) standard

digest:
EVP_MD_demo.c          Compute a digest from multiple buffers
EVP_MD_stdin.c         Compute a digest with data read from stdin
EVP_MD_xof.c           Compute a digest using the SHAKE256 XOF
EVP_f_md.c             Compute a digest using BIO and EVP_f_md

encode:
rsa_encode.c           Encode and decode PEM-encoded RSA keys

encrypt:
rsa_encrypt.c          Encrypt and decrypt data using an RSA keypair.

guide:                   Sample code from the OpenSSL Guide tutorials. See
                         the oss-guide-quic-introduction(7) man page.
quic-client-block.c:     A simple blocking QUIC client
quic-client-non-block.c: A simple non-blocking QUIC client
quic-multi-stream.c:     A simple QUIC client using multiple streams
tls-client-block.c:      A simple blocking SSL/TLS client
tls-client-non-block.c:  A simple non-blocking SSL/TLS client

http3:                 Demonstration of how to use OpenSSL's QUIC capabilities
                       for HTTP/3.

kdf:
hkdf.c                 Demonstration of HMAC based key derivation
pbkdf2.c               Demonstration of PBKDF2 password based key derivation
scrypt.c               Demonstration of SCRYPT password based key derivation

keyexch:
x25519.c               Demonstration of X25519 based key exchange

mac:
gmac.c                 Demonstration of GMAC message authentication
poly1305.c             Demonstration of Poly1305-AES message authentication
siphash.c              Demonstration of SIPHASH message authentication

pkcs12:
pkread.c               Print out a description of a PKCS12 file.
pkwrite.c              Add a password to an existing PKCS12 file.

pkey:
EVP_PKEY_EC_keygen.c           Generate an EC key.
EVP_PKEY_RSA_keygen.c          Generate an RSA key.
EVP_PKEY_DSA_keygen.c          Generate a DSA key.
EVP_PKEY_DSA_paramgen.c        Generate a DSA param key.
EVP_PKEY_DSA_paramvalidate.c   Validate a DSA param key.
EVP_PKEY_DSA_paramfromdata.c   Load a DSA param key using raw data.

signature:
EVP_EC_Signature_demo.c   Compute and verify an EC signature.
EVP_DSA_Signature_demo.c  Compute and verify a DSA signature.
EVP_ED_Signature_demo.c   Compute and verify an ED25519 signature.
rsa_pss_direct.c          Compute and verify an RSA-PSS signature from a hash
rsa_pss_hash.c            Compute and verify an RSA-PSS signature over a buffer

smime:                 Demonstrations related to S/MIME

sslecho:
main.c                 Simple SSL/TLS echo client/server.