gnutls_load_file

Section: gnutls (3)
Updated: 3.7.1
Page Index

NAME

gnutls_load_file - API function

SYNOPSIS

#include <gnutls/gnutls.h>

int gnutls_load_file(const char * filename, gnutls_datum_t * data);

ARGUMENTS

const char * filename: the name of the file to load
gnutls_datum_t * data: Where the file will be stored

DESCRIPTION

This function will load a file into a datum. The data are zero terminated but the terminating null is not included in length. The returned data are allocated using gnutls_malloc().

Note that this function is not designed for reading sensitive materials, such as private keys, on practical applications. When the reading fails in the middle, the partially loaded content might remain on memory.

RETURNS

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

Since 3.1.0

REPORTING BUGS

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

COPYRIGHT

Copyright © 2001- 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.