man7.org > Linux > man-pages

Linux/UNIX system programming training

gnutls_session_set_premaster(3) — Linux manual page

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON 

gnutls_session_set_premaster(3)   gnutls  gnutls_session_set_premaster(3)

NAME         top

       gnutls_session_set_premaster - API function

SYNOPSIS         top

       #include <gnutls/gnutls.h>

       int gnutls_session_set_premaster(gnutls_session_t session,
       unsigned int entity, gnutls_protocol_t version,
       gnutls_kx_algorithm_t kx, gnutls_cipher_algorithm_t cipher,
       gnutls_mac_algorithm_t mac, gnutls_compression_method_t comp,
       const gnutls_datum_t * master, const gnutls_datum_t * session_id);

ARGUMENTS         top

       gnutls_session_t session
                   is a gnutls_session_t type.

       unsigned int entity
                   GNUTLS_SERVER or GNUTLS_CLIENT

       gnutls_protocol_t version
                   the TLS protocol version

       gnutls_kx_algorithm_t kx
                   the key exchange method

       gnutls_cipher_algorithm_t cipher
                   the cipher

       gnutls_mac_algorithm_t mac
                   the MAC algorithm

       gnutls_compression_method_t comp
                   the compression method (ignored)

       const gnutls_datum_t * master
                   the master key to use

       const gnutls_datum_t * session_id
                   the session identifier

DESCRIPTION         top

       This function sets the premaster secret in a session. This is a
       function intended for exceptional uses. Do not use this function
       unless you are implementing a legacy protocol.  Use
       gnutls_session_set_data() instead.

RETURNS         top

       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error
       code is returned.

REPORTING BUGS         top

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

COPYRIGHT         top

       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         top

       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/

COLOPHON         top

       This page is part of the GnuTLS (GnuTLS Transport Layer Security
       Library) project.  Information about the project can be found at
       ⟨http://www.gnutls.org/⟩.  If you have a bug report for this
       manual page, send it to bugs@gnutls.org.  This page was obtained
       from the tarball fetched from
       ⟨https://www.gnupg.org/ftp/gcrypt/gnutls/⟩ on 2025-08-11.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

gnutls                            3.8.10  gnutls_session_set_premaster(3)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI