sd-journal.xml revision 12b42c76672a66c2d4ea7212c14f8f1b5a62b78d
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor<?xml version='1.0'?> <!--*-nxml-*-->
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
f2d4040444c202e2b4451de0a977fa4060fa2c86lgentis
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor<!--
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor This file is part of systemd.
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor Copyright 2012 Lennart Poettering
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor systemd is free software; you can redistribute it and/or modify it
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor under the terms of the GNU Lesser General Public License as published by
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor the Free Software Foundation; either version 2.1 of the License, or
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor (at your option) any later version.
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor systemd is distributed in the hope that it will be useful, but
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor WITHOUT ANY WARRANTY; without even the implied warranty of
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor Lesser General Public License for more details.
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor You should have received a copy of the GNU Lesser General Public License
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor along with systemd; If not, see <http://www.gnu.org/licenses/>.
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor-->
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor<refentry id="sd-journal"
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor xmlns:xi="http://www.w3.org/2001/XInclude">
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refentryinfo>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <title>sd-journal</title>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <productname>systemd</productname>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <authorgroup>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <author>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <contrib>Developer</contrib>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <firstname>Lennart</firstname>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <surname>Poettering</surname>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <email>lennart@poettering.net</email>
d86c91b1fc2f496820df50f431ad85d28b7131a8lgentis </author>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </authorgroup>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </refentryinfo>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refmeta>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refentrytitle>sd-journal</refentrytitle>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <manvolnum>3</manvolnum>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </refmeta>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refnamediv>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refname>sd-journal</refname>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refpurpose>APIs for submitting and querying log entries to and
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor from the journal</refpurpose>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </refnamediv>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refsynopsisdiv>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <funcsynopsis>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <funcsynopsisinfo>#include &lt;systemd/sd-journal.h&gt;</funcsynopsisinfo>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </funcsynopsis>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <cmdsynopsis>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <command>pkg-config --cflags --libs libsystemd</command>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </cmdsynopsis>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </refsynopsisdiv>
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis <refsect1>
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis <title>Description</title>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <para><filename>sd-journal.h</filename> provides APIs to submit
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor and query log entries. The APIs exposed act both as client for the
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis <citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis journal service and as parser for the journal files on disk.
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </para>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <para>See
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_print</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_stream_fd</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_open</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_add_match</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_seek_head</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_cutoff_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_cutoff_monotonic_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_usage</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_catalog</refentrytitle><manvolnum>3</manvolnum></citerefentry>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor and
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_fd</refentrytitle><manvolnum>3</manvolnum></citerefentry>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor for more information about the functions implemented.</para>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <para>Command line access for submitting entries to the journal is
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor available with the
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>systemd-cat</refentrytitle><manvolnum>1</manvolnum></citerefentry>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor tool. Command line access for querying entries from the journal is
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor available with the
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor tool.</para>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </refsect1>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <xi:include href="libsystemd-pkgconfig.xml" />
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <refsect1>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <title>See Also</title>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <para>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_print</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_stream_fd</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_open</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_data</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
eacd4e6ae9f4f2740b3d3b3c315067d8a0da71e3lgentis <citerefentry><refentrytitle>sd_journal_add_match</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
eacd4e6ae9f4f2740b3d3b3c315067d8a0da71e3lgentis <citerefentry><refentrytitle>sd_journal_seek_head</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_cutoff_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_cutoff_monotonic_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_usage</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_fd</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_query_unique</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd_journal_get_catalog</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry><refentrytitle>sd-id128</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor <citerefentry project='die-net'><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </para>
594b4dd7639cd01b2200bd0774bc50952ceffcbegryzor </refsect1>
f2d4040444c202e2b4451de0a977fa4060fa2c86lgentis
f2d4040444c202e2b4451de0a977fa4060fa2c86lgentis</refentry>
f2d4040444c202e2b4451de0a977fa4060fa2c86lgentis