SSL_SESSION_GET0_PEER(3ossl)

📦
version 15.1 · 3 versions
, in freebsd 15.1

💅 SSL_SESSION_GET0_PEER 💅

okay so bestie, welcome to the SSL_SESSION_get0_peer page — that's page 3ossl of the OpenSSL manual, and it's literally one of the shortest, most chill pages you'll ever read. no cap. let's get into it 🫶

✨ NAME ✨

SSL_SESSION_get0_peer — get the deets about the peer's certificate for a session 💖

like, that's the whole vibe. you have a session, you wanna know who's on the other end, this is your girl.

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

X509 *SSL_SESSION_get0_peer(SSL_SESSION *s);

yes that's it. one include, one function, one argument. iconic minimalism, honestly 🎀

🦋 DESCRIPTION 🦋

okay so SSL_SESSION_get0_peer() returns the peer certificate associated with the session s, or NULL if no peer certificate is available. 🍓

but listen — the caller should NOT free the returned value (unless X509_up_ref(3) has also been called). like, do not touch it. do not free it. it is not yours to free. it's giving "borrowed, not given" energy and honestly respect 💅

⚠️ bestie please internalise that. freeing it without calling X509_up_ref(3) first is a whole mess you do not want. the only exception is if X509_up_ref(3) was also called — then you're allowed. periodt.

⭐ RETURN VALUES ⭐

SSL_SESSION_get0_peer() returns a pointer to the peer certificate, or NULL if no peer certificate is available. 😭

so like, two possible outcomes:

  • pointer to the peer certificate 👑
  • NULL, meaning no peer certificate is available 🙈

that's the vibe check, and it passed.

🌈 SEE ALSO 🌈

  • ssl(7) — go read it, iykyk 🧚

Copyright 2017 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>. ✨

and that's the whole page, bestie — short, sweet, and lowkey perfect. this one's from OpenSSL 3.5.6, dated 2026-04-07, and it lives at SSL_SESSION_GET0_PEER(3ossl). mwah 💋🎀🦋

📦 where this page comes from