1LIBXO(3)                 BSD Library Functions Manual                 LIBXO(3)
2

NAME

4     xo_message, xo_message_c, xo_message_hc, xo_message_hcv — emit messages
5     in multiple output styles
6

LIBRARY

8     library “libxo”
9

SYNOPSIS

11     #include <libxo/xo.h>
12
13     void
14     xo_message(const char *fmt, ...);
15
16     void
17     xo_message_e(const char *fmt, ...);
18
19     void
20     xo_message_c(int code, const char *fmt, ...);
21
22     void
23     xo_message_hc(xo_handle_t *xop, int code, const char *fmt, ...);
24
25     void
26     xo_message_hcv(xo_handle_t *xop, int code, const char *fmt, va_list vap);
27

DESCRIPTION

29     xo_message generates text message which lack any sort of structure.
30     These functions should not be used under normal conditions, since they
31     completely defeat the value of using libxo.  They are provided for sce‐
32     narios when the output's content is genuinely unknown and unusable.  It
33     is used in converting programs where err/warn where not used, and error
34     messages went to stdout, not stderr.  Use of xo_message allows backwards
35     compatibility with that output, but does not put the error in a useful
36     form.
37
38     The xo_message function generates output strings using the printf-style
39     format string and arguments provided.  If the format string does not end
40     in a newline, xo_message_e will appear a colon, a space, and the error
41     associated with the current errno value.  xo_message_c behaves similarly
42     for the value passed in the code parameter.  xo_message_hc accepts a
43     handle as opened by xo_create(3) and xo_message_hcv accepts a va_list
44     parameter of arguments.
45

SEE ALSO

47     xo_emit(3), libxo(3)
48

HISTORY

50     The libxo library first appeared in FreeBSD 11.0.
51

AUTHORS

53     libxo was written by Phil Shafer <phil@freebsd.org>.
54
55

ADDITIONAL DOCUMENTATION

57     FreeBSD uses libxo version 1.6.0.  Complete documentation can be found on
58     github:
59
60           https://juniper.github.io/libxo/1.6.0/html/index.html
61
62     libxo lives on github as:
63
64           https://github.com/Juniper/libxo
65
66     The latest release of libxo is available at:
67
68           https://github.com/Juniper/libxo/releases
69

HISTORY

71     The libxo library was added in FreeBSD 11.0.
72

AUTHOR

74     Phil Shafer
75
76BSD                            December 4, 2014                            BSD
Impressum