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

FreeBSD Manual Pages

  
 
  

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

NAME
       xo_message,  xo_message_c,  xo_message_hc,  xo_message_hcv -- emit mes-
       sages in	multiple output	styles

LIBRARY
       library "libxo"

SYNOPSIS
       #include	<libxo/xo.h>

       void
       xo_message(const	char *fmt, ...);

       void
       xo_message_e(const char *fmt, ...);

       void
       xo_message_c(int	code, const char *fmt, ...);

       void
       xo_message_hc(xo_handle_t *xop, int code, const char *fmt, ...);

       void
       xo_message_hcv(xo_handle_t   *xop,   int	  code,	  const	  char	 *fmt,
	   va_list vap);

DESCRIPTION
       xo_message  generates  text  message  which lack	any sort of structure.
       These functions should not be used under	normal conditions, since  they
       completely defeat the value of using libxo.  They are provided for sce-
       narios when the output's	content	is genuinely unknown and unusable.  It
       is used in converting programs where err/warn where not used, and error
       messages	 went  to  stdout, not stderr.	Use of xo_message allows back-
       wards compatibility with	that output, but does not put the error	 in  a
       useful form.

       The xo_message function generates output	strings	using the printf-style
       format  string  and  arguments provided.	 If the	format string does not
       end in a	newline, xo_message_e will appear a colon, a  space,  and  the
       error  associated  with	the current errno value.  xo_message_c behaves
       similarly for the value passed in the  code  parameter.	 xo_message_hc
       accepts a handle	as opened by xo_create(3) and xo_message_hcv accepts a
       va_list parameter of arguments.

SEE ALSO
       xo_emit(3), libxo(3)

ADDITIONAL DOCUMENTATION
       FreeBSD	uses libxo version 0.6.1.  Complete documentation can be found
       on github:

	     http://juniper.github.io/libxo/0.6.1/libxo-manual.html

       libxo lives on github as:

	     https://github.com/Juniper/libxo

       The latest release of libxo is available	at:

	     https://github.com/Juniper/libxo/releases

HISTORY
       The libxo library was added in FreeBSD 11.0.

AUTHOR
       Phil Shafer

FreeBSD	ports 15.0	       December	4, 2014			      LIBXO(3)

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

home | help