diff options
| author | Lennart Poettering <lennart@poettering.net> | 2012-10-18 03:29:19 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2012-10-18 03:35:18 +0200 |
| commit | 3c1668da6202f1ead3d4d3981b89e9da1a0e98e3 (patch) | |
| tree | d4e2785f1dac02c19797373bb4342354e1958e9d /man/sd_journal_get_data.xml | |
| parent | 86b2e20a5e5abf222fb81edcb5d58d012e35cbaa (diff) | |
journal: add ability to list values a specified field can take in all entries of the journal
The new 'unique' API allows listing all unique field values that a field
specified by a field name can take in all entries of the journal. This
allows answering queries such as "What units logged to the journal?",
"What hosts have logged into the journal?", "Which boot IDs have logged
into the journal?".
Ultimately this allows implementation of tools similar to lastlog based
on journal data.
Note that listing these field values will not work for journal files
created with older journald, as the field values are not indexed in
older files.
Diffstat (limited to 'man/sd_journal_get_data.xml')
| -rw-r--r-- | man/sd_journal_get_data.xml | 7 |
1 files changed, 4 insertions, 3 deletions
diff --git a/man/sd_journal_get_data.xml b/man/sd_journal_get_data.xml index a7754129f..6470f19cc 100644 --- a/man/sd_journal_get_data.xml +++ b/man/sd_journal_get_data.xml @@ -70,7 +70,7 @@ </funcprototype> <funcprototype> - <funcdef>int <function>sd_journal_restart_data</function></funcdef> + <funcdef>void <function>sd_journal_restart_data</function></funcdef> <paramdef>sd_journal* <parameter>j</parameter></paramdef> </funcprototype> @@ -120,7 +120,7 @@ <para>Note that the <function>SD_JOURNAL_FOREACH_DATA()</function> macro - may be used as a wrapper around + may be used as a handy wrapper around <function>sd_journal_restart_data()</function> and <function>sd_journal_enumerate_data()</function>.</para> @@ -193,7 +193,8 @@ int print_fields(sd_journal *j) { <citerefentry><refentrytitle>sd-journal</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>sd_journal_open</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry>, - <citerefentry><refentrytitle>sd_journal_get_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry> + <citerefentry><refentrytitle>sd_journal_get_realtime_usec</refentrytitle><manvolnum>3</manvolnum></citerefentry>, + <citerefentry><refentrytitle>sd_journal_query_unique</refentrytitle><manvolnum>3</manvolnum></citerefentry> </para> </refsect1> |