Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_record_send_file(3)	     gnutls	      gnutls_record_send_file(3)

NAME
     gnutls_record_send_file - API function

SYNOPSIS
     #include <gnutls/gnutls.h>

     ssize_t  gnutls_record_send_file(gnutls_session_t	session, int fd, off_t *
     offset, size_t count);

ARGUMENTS
     gnutls_session_t session
		 is a gnutls_session_t type.

     int fd	 file descriptor from which to read data.

     off_t * offset
		 Is relative to file offset, denotes the starting  location  for
		 reading.   after function returns, it point to position follow-
		 ing last read byte.

     size_t countis the length of the data in bytes to be  read  from  file  and
		 send.

DESCRIPTION
     This  function  sends  data  from	fd . If KTLS (kernel TLS) is enabled, it
     will use the sendfile() system call to avoid overhead of copying  data  be-
     tween  user  space  and the kernel. Otherwise, this functionality is merely
     emulated by calling read() and gnutls_record_send(). If this implementation
     is  suboptimal,  check  whether  KTLS  is	 enabled   using   gnutls_trans-
     port_is_ktls_enabled().

     If  offset is NULL then file offset is incremented by number of bytes send,
     otherwise file offset remains unchanged.

RETURNS
     The number of bytes sent, or a negative error code.

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

COPYRIGHT
     Copyright (C) 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/local/share/doc/gnutls/ directory does not contain the  HTML  form
     visit

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

gnutls				     3.8.13	      gnutls_record_send_file(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_record_send_file&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help