---
name: "gnutls_dh_get_pubkey"
section: "3"
platform: "linux"
package: "gnutls"
version: "3.8.13-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_dh_get_pubkey"
---

# gnutls\_dh\_get\_pubkey(3)

API function

## NAME

gnutls\_dh\_get\_pubkey - API function

## SYNOPSIS

**#include \<gnutls/gnutls.h\>**

**int gnutls\_dh\_get\_pubkey(gnutls\_session\_t** *session***, gnutls\_datum\_t \*** *raw\_key***);**

## ARGUMENTS

- gnutls\_session\_t session

  is a gnutls session

- gnutls\_datum\_t \* raw\_key

  will hold the public key.

## DESCRIPTION

This function will return the peer's public key used in the last Diffie-Hellman key exchange.  This function should be used for both anonymous and ephemeral Diffie-Hellman.  The output parameters must be freed with **gnutls\_free()**.

Note, that public key is exported as non-negative integer and may include a leading zero byte.

## RETURNS

On success, **GNUTLS\_E\_SUCCESS** (0) is returned, otherwise an error code is returned.

## REPORTING BUGS

Report bugs to \<bugs@gnutls.org\>.\
 Home page: https://www.gnutls.org

## COPYRIGHT

Copyright © 2001-2023 Free Software Foundation, Inc., and others.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## SEE ALSO

The full documentation for **gnutls** is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

- https://www.gnutls.org/manual/