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

FreeBSD Manual Pages

  
 
  

home | help
KCGI_BUF_PRINTF(3)	    Library Functions Manual	    KCGI_BUF_PRINTF(3)

NAME
       kcgi_buf_printf -- put variable content into a kcgi buffer

LIBRARY
       library "libkcgi"

SYNOPSIS
       #include	<sys/types.h>
       #include	<stdarg.h>
       #include	<stdint.h>
       #include	<kcgi.h>

       enum kcgi_err
       kcgi_buf_puts(struct kcgi_buf *buf, const char *fmt, ...);

DESCRIPTION
       Appends	output according to the	given fmt to a buffer buf.  The	format
       is as  for  printf(3).	Buffers	 must  be  initialised	to  zero  with
       memset(3) prior to first	use.

RETURN VALUES
       Returns an enum kcgi_err	indicating the error state.

       KCGI_OK
	    Success (not an error).

       KCGI_ENOMEM
	    Internal memory allocation failure.

       KCGI_HUP
	    The	 output	 connection  has been terminated.  For FastCGI connec-
	    tions,  the	  current   connection	 should	  be   released	  with
	    khttp_free(3) and parse loop reentered.

       KCGI_FORM
	    The	connection is still expecting headers with khttp_head(3).  In-
	    dicates  that khttp_body(3)	did not	return with success or was not
	    invoked.  For FastCGI connections, the current  connection	should
	    be released	with khttp_free(3) and parse loop reentered.

       KCGI_SYSTEM
	    Internal system error writing to the output	stream.

EXAMPLES
       The  following  creates	a simple NUL-terminated	buffer and outputs its
       contents.  It does not perform any error	checking.

	     struct kcgi_buf buf;

	     memset(&buf, 0, sizeof(struct kcgi_buf));
	     kcgi_buf_printf(&buf, "number %d",	1);
	     puts(buf.buf); /* Emits "number 1"	*/
	     free(buf.buf);

SEE ALSO
       kcgi_buf_putc(3), kcgi_buf_puts(3), kcgi_buf_write(3)

AUTHORS
       Written by Kristaps Dzonsons <kristaps@bsd.lv>.

FreeBSD	ports 15.0		  $Mdocdate$		    KCGI_BUF_PRINTF(3)

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

home | help