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

FreeBSD Manual Pages

  
 
  

home | help
explain_setbuffer_or_die(3)Library Functions Manualexplain_setbuffer_or_die(3)

NAME
       explain_setbuffer_or_die	 -  stream buffering operations	and report er-
       rors

SYNOPSIS
       #include	<libexplain/setbuffer.h>
       void explain_setbuffer_or_die(FILE *fp, char *data, size_t size);
       void explain_setbuffer_on_error(FILE *fp, char *data, size_t size);

DESCRIPTION
       The explain_setbuffer_or_die function is	used to	call the  setbuffer(3)
       system  call.  On failure an explanation	will be	printed	to stderr, ob-
       tained from the explain_setbuffer(3) function,  and  then  the  process
       terminates by calling exit(EXIT_FAILURE).

       The  explain_setbuffer_on_error	function  is  used  to	call  the set-
       buffer(3) system	call. On failure an explanation	 will  be  printed  to
       stderr,	obtained from the explain_setbuffer(3) function, but still re-
       turns to	the caller.

       fp      The fp, exactly as to be	 passed	 to  the  setbuffer(3)	system
	       call.

       data    The  data,  exactly  as to be passed to the setbuffer(3)	system
	       call.

       size    The size, exactly as to be passed to  the  setbuffer(3)	system
	       call.

RETURN VALUE
       The explain_setbuffer_or_die function only returns on success, see set-
       buffer(3) for more information. On failure, prints an  explanation  and
       exits, it does not return.

       The explain_setbuffer_on_error function always returns the value	return
       by the wrapped setbuffer(3) system call.

EXAMPLE
       The explain_setbuffer_or_die function is	intended to be used in a fash-
       ion similar to the following example:
	      void result = explain_setbuffer_or_die(fp, data, size);

SEE ALSO
       setbuffer(3)
	       stream buffering	operations

       explain_setbuffer(3)
	       explain setbuffer(3) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2010 Peter	Miller

						   explain_setbuffer_or_die(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=explain_setbuffer_or_die&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help