docs: add compressed core file description
To the issue reporting page Change-Id: I3d2b53521bcb1b9b4a85802a84427f17390f0f77 Type: docs Signed-off-by: Dave Barach <dave@barachs.net>
This commit is contained in:

committed by
Florin Coras

parent
95dd1fe279
commit
edff805464
@ -238,6 +238,33 @@ Even given a byte-for-byte identical source tree, it's easy to build
|
|||||||
dramatically different binary artifacts. All it takes is a different
|
dramatically different binary artifacts. All it takes is a different
|
||||||
toolchain version.
|
toolchain version.
|
||||||
|
|
||||||
|
|
||||||
|
Compressed Core Files
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
Depending on operational requirements, it's possible to compress
|
||||||
|
corefiles as they are generated. Please note that it takes several
|
||||||
|
seconds' worth of wall-clock time to compress a vpp core file on the
|
||||||
|
fly, during which all packet processing activities are suspended.
|
||||||
|
|
||||||
|
To create compressed core files on the fly, create the following
|
||||||
|
script, e.g. in /usr/local/bin/compressed_corefiles, owned by root,
|
||||||
|
executable:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
#!/bin/sh
|
||||||
|
exec /bin/gzip -f - >"/tmp/dumps/core-$1.$2.gz"
|
||||||
|
|
||||||
|
Adjust the kernel core file pattern as shown:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
sysctl -w kernel.core_pattern="|/usr/local/bin/compressed_corefiles %e %t"
|
||||||
|
|
||||||
|
Core File Summary
|
||||||
|
-----------------
|
||||||
|
|
||||||
Bottom line: please follow core file handling instructions to the
|
Bottom line: please follow core file handling instructions to the
|
||||||
letter. It's not complicated. Simply copy the exact Debian packages or
|
letter. It's not complicated. Simply copy the exact Debian packages or
|
||||||
RPMs which correspond to core files to accessible locations.
|
RPMs which correspond to core files to accessible locations.
|
||||||
|
Reference in New Issue
Block a user