carta
xo_message(3)

xo_message3

Emit messages in multiple output styles

Usage

void

void

void

void

void

Library

library “libxo”

Overview

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 scenarios 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 backwards 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.

History

  • FreeBSD 16.0-CURRENT (2026-10-27) to FreeBSD 11.2-RELEASE: the text shown here
  • FreeBSD 11.1-RELEASE to FreeBSD 11.0-RELEASE

History

The libxo library first appeared in FreeBSD 11.0.

Authors

libxo was written by Phil Shafer ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.