X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_add_match.xml;h=d02285f2059ed166b4bc2366c9e4f32f3e364ded;hb=6f47d17c3c594bd6b0923ed1801f9ad706966d52;hp=ad2486d749ba67b909623e2290df92c65b88e77e;hpb=0bc62352805b98cebe5debb12a5d45adfc0c66d1;p=elogind.git
diff --git a/man/sd_journal_add_match.xml b/man/sd_journal_add_match.xml
index ad2486d74..d02285f20 100644
--- a/man/sd_journal_add_match.xml
+++ b/man/sd_journal_add_match.xml
@@ -45,6 +45,7 @@
sd_journal_add_match
sd_journal_add_disjunction
+ sd_journal_add_conjunction
sd_journal_flush_matches
Add or remove entry matches
@@ -66,7 +67,12 @@
- int sd_journal_flush_matches
+ int sd_journal_add_conjunction
+ sd_journal* j
+
+
+
+ void sd_journal_flush_matches
sd_journal* j
@@ -105,21 +111,45 @@
sd_journal_add_disjunction()
may be used to insert a disjunction (i.e. logical OR)
in the match list. If this call is invoked all
- previously added matches are combined in an OR with
- all matches added afterwards, until
- sd_journal_add_disjunction() is
- invoked again to begin the next OR term. The
+ previously added matches since the last invocation of
+ sd_journal_add_disjunction() or
+ sd_journal_add_conjunction() are
+ combined in an OR with all matches added afterwards,
+ until
+ sd_journal_add_disjunction() or
+ sd_journal_add_conjunction() is
+ invoked again to begin the next OR or AND
+ term.
+
+ sd_journal_add_conjunction()
+ may be used to insert a conjunction (i.e. logical AND)
+ in the match list. If this call is invoked all
+ previously added matches since the last invocation of
+ sd_journal_add_conjunction() are
+ combined in an AND with all matches added afterwards,
+ until
+ sd_journal_add_conjunction() is
+ invoked again to begin the next AND term. The
combination of
- sd_journal_add_match() and
- sd_journal_add_disjunction() may
+ sd_journal_add_match(),
+ sd_journal_add_disjunction() and
+ sd_journal_add_conjunction() may
be used to build complex search terms, even though
- full logical expressions are not available.
+ full logical expressions are not available. Note that
+ sd_journal_add_conjunction()
+ operates one level 'higher' than
+ sd_journal_add_disjunction(). It
+ is hence possible to build an expression of AND terms,
+ consisting of OR terms, consisting of AND terms,
+ consisting of OR terms of matches (the latter OR
+ expression is implicitly created for matches with the
+ same field name, see above).
sd_journal_flush_matches()
- may be used to flush all matches and disjunction terms
- again. After this call all filtering is removed and
- all entries in the journal will be iterated
- again.
+ may be used to flush all matches, disjunction and
+ conjunction terms again. After this call all filtering
+ is removed and all entries in the journal will be
+ iterated again.
Note that filtering via matches only applies to
the way the journal is read, it has no effect on storage
@@ -129,8 +159,9 @@
Return Value
- sd_journal_add_match() and
- sd_journal_add_disjunction()
+ sd_journal_add_match(),
+ sd_journal_add_disjunction() and
+ sd_journal_add_conjunction()
return 0 on success or a negative errno-style error
code. sd_journal_flush_matches()
returns nothing.
@@ -140,12 +171,12 @@
Notes
The sd_journal_add_match(),
- sd_journal_add_disjunction() and
- sd_journal_flush_matches() interfaces are
- available as shared library, which can be compiled and
- linked to with the
- libsystemd-journal
- pkg-config1
+ sd_journal_add_disjunction(),
+ sd_journal_add_conjunction() and
+ sd_journal_flush_matches()
+ interfaces are available as shared library, which can
+ be compiled and linked to with the
+ libsystemd-journal pkg-config1
file.