tests: reinstate 100% libdlog coverage

Change-Id: I993a5d6d36f5ebc5fc6220cc74988eeb4de7e808
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

unit tests: add a copy of TCT

Running the actual TCT suite is a massive hassle, especially
given its simplicity, so it's great to be able to catch any
applicable bugs at build time.

Change-Id: Id7b546f347ef8e98b8647b2a0c63c3f6ae103908
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix coding style

Change-Id: Ie33d0b3a0f99eaa823faec9f719ac715ee0e3d5e
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix a potential buffer overflow

Change-Id: I7407b2ed68322d6c0fd6eac2ec3600cd14ce7d80
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

packaging: Allow disabling dynamic filtering in resulting package

Unwanted feature will be disableable via _with_dynamic_filtering
rpm's compile time option.

Change-Id: Icce63a9a62a1aa9f7a1778d5be359b89116371ef

libdlog: remove library destructor

A destructor assumes that it has an exclusive thread
access (no other library function can run in paralell).
This condition is not always met, which can lead to a
race condition and use after free situation. Since all
other, backend specific resources are not freed anyway,
we can get rid of the destructor to make things more
reliable.
The function itself is left because it is still necessary
in tests.

Change-Id: I3bc2a7b660c6c805182592a70a8a954beba16772
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

logctl/common: unduplicate free_ptr/freep

Change-Id: Ibbada3aa01904860a396ee50fb8ebf92a5e46ae4
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

logger: fix data corruption for listening sockets

The sockets are of the type SOCK_STREAM which can receive data
in chunks. This is quite unlikely due to small data sizes but
is not impossible.

Change-Id: I5efa42c52c58fcd913eb882a77641f595fc99e9e
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Expand commentary on previous

Change-Id: I2eb99e2201ebb82451d5dc291ed0866455f269f5
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

svace: set umask to protect tempfile

umask(077) needs to be called before mkstemp(),
to prevent a potential race condition vulnerability.

Change-Id: Id7c167e9627e55d563dc4a881a6ecfbb4843f70e
Signed-off-by: sanghyeok.oh <sanghyeok.oh@samsung.com>
Signed-off-by: Hyotaek Shim <hyotaek.shim@samsung.com>

util: allow filterspec to work with empty-tagged messages

Change-Id: I9b49e3a07145e2f3dc83ab59b99e9ee340dab414
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

Merge "testsuite: speed up format tests" into tizen

testsuite: speed up format tests

Get rid of unnecessary sorting in dlogutil
when performing format checks.

Change-Id: Iaecd583c3994f73de0b11626a89e87b19379f7ae
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

libdlog: detect and notify about empty tagged messages

It is an error for an application to send a message with empty tag. To
make it easy to catch such situation and fix it in the app, empty-tagged
messages are exluded from limiter and marked with DLOG_ERROR_NOTAG tag.

Change-Id: I5ca0e0ef0e20f9d7cabcec11dad379023b7f0630
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

logctl: simplify and document a confusing function

  Minor behaviour change: all affected lines are now moved to the end,
  in the order they were specified in the kv struct (used to stay in
  place) and duplicate keys are pruned (used to be left alone).

  Example: kv pairs {"A", "1"} and {"B", "2"}, file:
    C=3
    B=8
    A=4
    B=6
    D=4

  Previously, the resulting file:
    C=3
    B=2
    A=1
    B=2
    D=4

  Now:
    C=3
    D=4
    A=1
    B=2

  This has no effect on configs because the order among different keys
  doesn't matter and a given key used to get the same value across copies,
  but allows to simplify some logic.

Change-Id: Ib2ac9e07dced12614cde000dc3876e2887410537
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix log_config initialisation properly

The test wrapper around log_config_read had different behaviour
than the real function and did not properly initialise members.

The previous fix was less elegant and is no longer needed.
This partially reverts commit 682e540702101156881a5c3219f1b27a8fcb4894.

Change-Id: Ib9210dabe0c6033fe22de073ceaada30e012cdc5
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Release 5.5.1

This release adds follwing features:

 - dlog printf format is now enforced

 - android driver v2 is now required for android backend

 - reduce default client side buffer to 64k (from 1MB) due to
   global (system wide) limit

 - add testsuite together with coverage reporting

Lastly, long list of fixes.

Change-Id: I03af7cc3dba8c7c9fa8a8758f281cdb5eeef5b59

fix: test common: use correct cast to validate pipefd receive

Change-Id: Ibf7b808ddfccdbdc9ea54e44f37961383099954e

fix: parse_number 64-bit architecture compatibility

Simplify strtol() return error code checking to properly handle 64-bit
architectures.  Problem appears only on 64-bit architectures, where
LONG_MAX (long type, 4 bytes) does not fit into regular int type
(4 bytes).

Additionally, this commit removes str2num() function which is copy
paste of parse_number (with same bugs).

Change-Id: I44cbcdd1e5601c8ed988368932e84f29f719c8a9

fix: ensure log_config is always properly initialized

Proper initialization is required to be able to free the
structure after eg. failing log_config_read() which might
have either read some entries (and updated .begin/.end)
or have not read anything (keeping .begin/.end unchanged).

Change-Id: I3a2a2434488e13349746a85afcb4c81752609dd9

Remove executable flag from non-executable files

Change-Id: Ibf83f8fcec9a3596a317b3d202fc76eb89ecc259
Signed-off-by: lokilee73 <changjoo.lee@samsung.com>

tests: top up coverage of some files in shared

Change-Id: I33be1871e67a90f20099afe8e632519253043e27
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: extend logcommon unit tests

Change-Id: I64900e1c453be7131a05fdc886a290df756364bb
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: reinstate 100% libdlog unit test coverage

Change-Id: I4d5fb273567a63c04d21a87434cf532c5b62f383
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: compile with -O0

autoconf adds some flags, including -O2, which prevents
gcov from properly measuring test coverage by optimizing
various functions and code paths out.

Change-Id: I288ed6261f6a07ed23e5cd09c7517bb4b39695ba
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: handle limiter allocation failures

Change-Id: Ie097957247c72c3d8cdccfbc4d3b080343582873
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: stricter correctness checks

Change-Id: Ice3b5b65d907e7c56c2924dcb94a3300b89a94ad
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Enforce Android Logger device protocol version 2

Will no longer fail on devices compatible with version 2 of the protocol
which change the GET_LOG_LEN ioctl behaviour where the returned value is
not the sum of the values returned by read() calls. Such devices are so
far a straight-up hypothetical, but it's better to exercise our foresight
right now rather than have to deal with the fallout after such change,
since as unlikely as a fix would be given that this behaviour is not in
theory an error and that DLog is the primary way to access this interface,
it doesn't look like Android Logger is getting abandoned anytime soon.

This patch also makes protocol version requirement checks more strict;
specifically, it makes support for version 2 mandatory. Previously such
devices would silently drop logs past the amount that would usually be
reported by a v2 device, so we now spare ourselves painful debugging
and won't have to pollute our code with exceptional handling of obsolete
versions. The drawback is not particularly harsh because virtually all
kernels nowadays have either dropped Android Logger devices altogether,
or use version 2.

Change-Id: Ic66f0abfb1de83fba454bfa151b7e40b90e30ad6
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

util: document some tricky code

Change-Id: I301c7bd877248201edb7ca27590ad348b18db06a
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: add queued_entry unit tests

Change-Id: Ifd9748ba07f8f6a7e0faa7a2dc0871b9b9cc8617
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix minor issues with log entry parsing

Change-Id: I2a566647cdde20aa7168d816afd1c78146567f4f
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix missing header inclusion

`get_proper_clock` returns `clockid_t` which requires <time.h>

Change-Id: I40c6416246cde0d2033b80bf8eb7219f3500fb77
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

testsuite: test tag based dynamic filters

Change-Id: Iebea3f70867d117b765737113bead7837bd285f6
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

testsuite: check if dlogctl denies invalid arguments

Change-Id: I7b50ead74478b210e04b1324ed7d2bf0da54d949
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

Apply __attribute__((format(printf..))) Warning to Public dlog_print()

In public rootstrap, dlog-internal.h is removed.
So,
"#pragma GCC diagnostic warning "-Wformat"" will be applied instead of
"#pragma GCC diagnostic error "-Wformat""

Change-Id: I56beb06ac1cdb17fee45411e32f058f56b743bba
Signed-off-by: Hyotaek Shim <hyotaek.shim@samsung.com>

tests: add libdlog base unit tests

Change-Id: I9d489ed607d9917aaf782339b7db700259955ac9
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: fix reconstruction after destruction

Change-Id: Ib3409ce958d6c936f9a44e337bbec50d36117d02
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

testsuite: test filters added by dlogctl

Change-Id: I3309ee558a3549438aa9a45bf17ab2ff03a184de
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

util: fix dlogutil failing with multiple buffers

Change-Id: Ia0375c7118194dddb51725af3cdfea3065de353f
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

testsuite: make sure proper values are returned when testing filters

Change-Id: I08200630ea299c71865f06da09a235ed395d533d
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

testsuite: extend dynamic filters tests

Dynamic filters directory SMACK label is now tested,
as well as alternative filters config file.

Change-Id: I3d2879885c87991965fab65339c68f0b05d9ab18
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

shared: add log_config_copy & log_config_remove

The former copies a config structure and the latter removes
an entry under given key. Includes unit tests for both.

Change-Id: Ideca55a2b9fe9d0b038675e06f5ace72d12af78a
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: add libdlog Android Logger unit tests

Change-Id: Ib529daa9fb8fff828c0255bdd871bf81b7263158
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: add libdlog-pipe unit tests

Change-Id: I7f25900125ba5901a527c6a1268a39e3d68c3710
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog pipe: fix correctness checks

 * rejects on negative buffer ID (no longer crashes)
 * rejects relative socket paths
 * accepts maximal payloads

Change-Id: I7344cf4d47eb65c98a65a01ad4ada38ca9c9b5fd
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: fail early on long pipe paths

Change-Id: I779b8427db928c8dc29174b508194cbd38561329
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix `log_config_free` corrupting the config

It used to leave the config in a corrupt state that
referenced freed memory and leaked any added entries.
This did not cause any actual problems because no
config structure was ever reused in production code,
only in tests which do that for convenience.

Change-Id: I90a52c31ca2985ab9c67b32849bca426fb3f1ed7
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Revert "Apply __attribute__((format(printf..))) to Public dlog_print()"

This reverts commit 6b5b9d0c435fa4b79395e22bc8ba39eedee3f0c0.

Change-Id: Id7739408a38f86f78ddaa12e93e42de2cc208a8d

dlogutil: allow printing current DLog version

Change-Id: I49c1d4cf5c5bd725c9d516414e7fbd0774f2af8d
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

Merge "dlogctl: allow empty priority when printing limits" into tizen

Merge "dlogsend: notify and return error code when message send fails" into tizen

Fix compilation errors

 * `malloc` requires `stdlib.h`
 * case labels only accept constants, not variables (even static const)

Change-Id: Ie508947abd79e6d3b47a08f63cb07dbf8463dd72
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlogsend: notify and return error code when message send fails

Change-Id: I3545f90ef57a71e93ee59977d185d8c90306170b
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

dlogctl: allow empty priority when printing limits

Change-Id: If2ed606bc3f99ba03cb87974f5ec7e09a2c3121b
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

Apply __attribute__((format(printf..))) to Public dlog_print()

to check format even for variable arguments (...)

format (printf, string-index, first-to-check)
- string-index : format string index (starting from 1)
- first-to-check : first argument index to be checked
https://gcc.gnu.org/onlinedocs/gcc-4.0.1/gcc/Function-Attributes.html#Function-Attributes

Change-Id: I852fcea60109517e50e26e3ee1a8064fd9bb649f
Signed-off-by: Hyotaek Shim <hyotaek.shim@samsung.com>

Apply __attribute__((format(printf..))) to internal __dlog_print()

to check format even for variable arguments (...)

format (printf, string-index, first-to-check)
- string-index : format string index (starting from 1)
- first-to-check : first argument index to be checked
https://gcc.gnu.org/onlinedocs/gcc-4.0.1/gcc/Function-Attributes.html#Function-Attributes

Change-Id: I70ee2d0687c87b4f15f46dd962c249136d27709f
Signed-off-by: Hyotaek Shim <hyotaek.shim@samsung.com>

tests: add libdlog dynamic config unit tests

Change-Id: I120962c2b83f05d52487a955abd8731119e57b0d
Signed-off-by: Michal Bloch <m.bloch@samsung.com>
(cherry picked from commit 8d4febbb4cbf3e7d322560ae7a438fd11b8d2954)

libdlog: treat inotify creation errors as a failure

Change-Id: I7abcfcf606fbd32c9b6806e6bab557ee6155a9e5
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: don't report coverage of tests themselves

Counting test cases themselves in the report just inflates the coverage
since they tend to have a lot of lines that are executed unconditionally.

Change-Id: I74f961fb8432bbfef06fa522e06aad650ad94a6c
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Use the actual bool type instead of a fake enum

Improves type correctness and fixes a case of two functions
being identical - `log_config_get_boolean` used to just call
`log_config_get_int` with the same parameters and did not
even touch the return value.

Includes tests for `log_config_get_boolean`.

Change-Id: I185dfac32d40bcab3ddbf95d3b4536c2d275098e
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: complete ptrs_list unit tests

Add tests for `list_clear_free_contents`, the last untested func.
Also improve type correctness.

Change-Id: I4ccc62268757b990e1462a9af9f76f7084848177
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlog_logger: read /dev/kmsg in a throttled loop

KMSG only returns one entry per read() - do it in a throttled loop
for efficiency. This is similar to how Android Logger devices are
handled.

Change-Id: I0f95dc657898a9d68bcfd96f9d2e2daab5814176
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

testsuite: make sure all buffers are disabled when testing

Change-Id: Ic48475b7862ffae7d7d1263fce885f31f68a0d16
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

tests: add libdlog limiter unit tests

Change-Id: I8dacfcf606fbd32c9b6806e6bab557ee6155a9e5
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

limiter: fix internal priority mapping

Now makes sure the result is one of the chars "?*VDIWEFS".

Previously it could return lowercase characters, numerical
characters (except '8' which stands for SILENT but including
'1' which stands for DEFAULT which is not a real priority),
or the null character (when passed the integers 0 or 1).

Change-Id: I3766d699e553d71265a979ababe59fccdd16d571
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix a missing include

`stddef.h` is needed for `size_t`, which is
one of the arguments to `__log_limiter_dump_rule`.

Change-Id: Iffbf5666dbfffe26ac1214e0068628ecfb5dd789
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: reduce pipe size 1 MB → 64 kB

It seems that the amount of memory allocated specifically to pipes
can be limited and on most targets it seems to be set to 16k pages,
that is, 64 MB raw memory. Pipes are currently very aggressively
sized which burns through this limit easily. 64 kB is still quite
a lot and should not cause any problems to prolific loggers while
heavily culling memory wastage.

Change-Id: I5465de849a279e23ca0d6bae34bceddd6136db16
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Fix pipe resize failure being considered an error

Pipes are enlarged so that prolific logging does not clog the pipe,
which is just an optimisation - logging can still continue if it
fails (albeit slower).

Change-Id: I5218512d3b22eea1636460ed463eeb2280faa9e7
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Build process: create a test coverage report

Uses LCOV to assemble a HTML report in the build directory.

Change-Id: I990d3d59b5fcb500708688c06e7f9a6573e39255
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: add dlogctl buffer toggling tests

Change-Id: Ibbdfbc938799230cf3e036d7274bf9ffdc9b0e1e
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: test misc utility stuff from logcommon.h

Change-Id: Ib8ea673ae9eeae990dcfe8e998fc8383df3c8bae

tests: add daemon file descriptor checks

Checks whether the daemon crashes with low FD limit
and whether it leaks any FDs.

Change-Id: I7352a0e71b5e066ad4600854f34d6bc67375df40
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

tests: cleanup programs when no longer needed

Change-Id: I5cbe9a0723d7cecc657198fb716e78256c5bbde9

dlogctl: fix -s working as -c if without -t or -p

Change-Id: Icf3dfee19d51a7312c4f392424774904622dd24e
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlogctl: add --clear / -c

Without any parameters, clears all rules. With just one of -t or -p
supplied, the other is assumed to be '*' (same logic as -g).

The argument to the -s option is now mandatory.

Change-Id: I3ec152e49076f58b1f052e4c21c32fcee0deff56
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlogctl: add a parameter correctness check

Now `-g -s 123 --disable` is disallowed.

Change-Id: I9b8163e21cbc9c4fe1d20d2d3c58d289cfb0f640
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlog_logger: commentary for the recent epoll fixes

Some of the recent epoll changes needed an explanation
since it wasn't immediately obvious how they work.

Change-Id: Idecadedcd8bf8a570f65c602d7dbf11e971360f3
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlog_logger: fix writing to files

Change-Id: I172cb2dcd8bf8a570f65c602d7dbf11e971360f3
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: filters the `apps` buffer by default

Change-Id: Ie89cd6f5f660cc831aa55e95db7181720fca9191
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Merge "libdlog: enable dynamic filters by default" into tizen

Merge "dlog_logger: reuse clock readings" into tizen

libdlog: fix a dynamic config crash

Change-Id: I83867775088438636cf483a14616b8ef49106a84
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: enable dynamic filters by default

Change-Id: I8f9a6ec4ab2d99c3bf4c4e36c6790db744747889
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlog_logger: reuse clock readings

No need for every reader to read the same value on its own.

Change-Id: I91f0e81306061607cb848911bafaf69554b15229
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlog_logger: improve reader epoll registration

 * now keeps readers registered with EPOLLHUP for
   immediate removal when the other end gets closed

 * no longer attempts to unregister already unregistered FDs

Change-Id: If5a28be45158896a174ab90259648602af594b92
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Release 5.0.4

Contains various fixes:
 * fix dynamic config not rejecting relative paths
 * fix libdlog not closing FDs on exec() under Android Logger backend
 * fix removal of the dynamic config file being unhandled
 * fix treating log limitation as an error

Also:
 * increase the daemon's FD limit from 1K to 16K
 * optimize dlogutil's dumping mode performance

Change-Id: Ic3ac0ab254490268698af46da73723e963edd57a
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dlog_logger daemon: reaching FD limit leaves a log

Change-Id: Ie70e7fa6e1fe5a3c394e0fd428cf0aa3375e03aa
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Merge "limiter: do not treat limiter restrictions as an error" into tizen

Merge "Handle deleting dynamic configuration file" into tizen

limiter: do not treat limiter restrictions as an error

Currently when a log is blocked by limiter rules,
dlog_print() returns an error code. Let it be blocked,
but return a success code - number of written bytes
(which is 0).

Change-Id: Ie37e3d0e17f0fa3cd9fef012412270bdce8565e2
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

Increase the limit of open files from 1K to 16K in dlog_logger

Change-Id: Ib334e7762099fef2008adec29da9120115764b19
Signed-off-by: Hyotaek Shim <hyotaek.shim@samsung.com>

Handle deleting dynamic configuration file

It's no longer an error when a dynamic configuration
file is deleted - restore default values both for plog and
filters in that case.

Change-Id: I3ec06aeba50f2e74bfee90736beeb5634d79e06d
Signed-off-by: Maciej Slodczyk <m.slodczyk2@partner.samsung.com>

Merge "dynamic config: fail on relative paths" into tizen

libdlog: close Android Logger connections on exec

Change-Id: Ib6576073f3c0c7f224a9d0c9605f879a9f347cd0
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

dynamic config: fail on relative paths

Change-Id: I50ca411b3268fdc25d1cb58a19f1dc8aa9752bbb
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

util: optimize dumping instance timezone handling

  We can assume that such instances will not see a timezone
  change happen during their lifetime, and even if they do,
  it is probably best if they ignore it (a dump would ideally
  behave as if it was atomic). This means we can optimize the
  behaviour where printing the timestamp requires us to check
  whether the timezone changed, which involves calling stat()
  on /etc/localtime, which is not cheap on its own and made
  even worse when multiple symlinks are involves.

  glibc has a feature where setting the TZ environmental var
  will cache the timezone, achieving precisely what we want.

Change-Id: I2f5e26a4be81b8f846036282fc1a0bfe02b70b48
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Release 5.0.3

Contains fixes and documentation for the recently added
dynamic configuration features:

 * the dlog-doc package now contains a usage guide describing
   the new feature with examples and common mistakes

 * fixed disabling dynamic configuration turning the limiter off as well

 * fixed disabling all buffers being permanent

 * fixed logs being able to slip through a disabled buffer

 * fixed dynamic config behaviour with forked processes

And some miscellaneous fixes:

 * fixed some resource leak and corruption issues

 * fixed some spurious static analysis warnings

 * fixed the config being needlessly read twice by libdlog

 * fixed the daemon not noticing timezone changes for the purpose
   of writing log files (on both backends)

Change-Id: I7acdc373c7acb5ae0b06bc0fe12ad507fd327d30
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

libdlog: Do not remove the dynamic filter watch in library destructor

Calling inotify_rm_watch() on inotify fd will remove watches for
all processes that share that inotify fd. This means that every
process that uses dlog and forks will have the dynamic config
feature broken.

This commit fixes that by removing the erroneous rm_watch.

Change-Id: If023d75937b5b435e2188aca7f70b57ce964c767

documentation: describe some common mistakes

Change-Id: Ib18b454042a50152bc0815fe42780d2fb8a05004
Signed-off-by: Michal Bloch <m.bloch@samsung.com>

Further documentation improvements

 * fix some mistakes in the previous documentation commit
 * in particular, make the txt file actually end up in the doc rpm
 * extend config entry documentation
 * remove unused entries

Change-Id: I6f423ee42f5fc26059ee738909208719e4dd6753
Signed-off-by: Michal Bloch <m.bloch@samsung.com>