diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2013-06-05 19:39:26 -0400 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2013-06-10 10:10:07 -0400 |
| commit | 5302ebe15ff3a11eceb75e095e5a09d2a676de2b (patch) | |
| tree | af3fe38ff0e433d824684e77840cbf00af7cf211 /man | |
| parent | 6eb7a9a0010d035e5bdbbf70227088ce02b2120e (diff) | |
journal: add sd_journal_open_files
This allows the caller to explicitly specify which journal files
should be opened. The same functionality could be achieved before
by creating a directory and playing around with symlinks. It
is useful to debug stuff and explore the journal, and has been
requested before.
Waiting is supported, the journal will notice modifications on
the files supplied when opening the journal, but will not add
any new files.
Diffstat (limited to 'man')
| -rw-r--r-- | man/sd_journal_open.xml | 23 |
1 files changed, 20 insertions, 3 deletions
diff --git a/man/sd_journal_open.xml b/man/sd_journal_open.xml index dd2f32d81a..4ac94c4ce3 100644 --- a/man/sd_journal_open.xml +++ b/man/sd_journal_open.xml @@ -45,6 +45,7 @@ <refnamediv> <refname>sd_journal_open</refname> <refname>sd_journal_open_directory</refname> + <refname>sd_journal_open_files</refname> <refname>sd_journal_close</refname> <refname>sd_journal</refname> <refname>SD_JOURNAL_LOCAL_ONLY</refname> @@ -72,6 +73,13 @@ </funcprototype> <funcprototype> + <funcdef>int <function>sd_journal_open_files</function></funcdef> + <paramdef>sd_journal** <parameter>ret</parameter></paramdef> + <paramdef>const char** <parameter>paths</parameter></paramdef> + <paramdef>int <parameter>flags</parameter></paramdef> + </funcprototype> + + <funcprototype> <funcdef>void <function>sd_journal_close</function></funcdef> <paramdef>sd_journal* <parameter>j</parameter></paramdef> </funcprototype> @@ -111,6 +119,14 @@ flags argument, but it must be passed as 0 as no flags are currently understood for this call.</para> + <para><function>sd_journal_open_files()</function> + is similar to <function>sd_journal_open()</function> + but takes a <literal>NULL</literal>-terminated list + of file paths to open. All files will be opened and + interleaved automatically. This call also takes a + flags argument, but it must be passed as 0 as no flags + are currently understood for this call.</para> + <para><function>sd_journal_close()</function> will close the journal context allocated with <function>sd_journal_open()</function> or @@ -188,9 +204,10 @@ <para><function>sd_journal_open_directory()</function> was added in systemd-187.</para> - <para><literal>SD_JOURNAL_SYSTEM</literal> and - <literal>SD_JOURNAL_CURRENT_USER</literal> were added - in systemd-205. + <para><literal>SD_JOURNAL_SYSTEM</literal>, + <literal>SD_JOURNAL_CURRENT_USER</literal>, + and <function>sd_journal_open_files()</function> + were added in systemd-205. <literal>SD_JOURNAL_SYSTEM_ONLY</literal> was deprecated.</para> </refsect1> |