ligang/vpp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add compressed core file description

Browse Source 
To the issue reporting page

Change-Id: I3d2b53521bcb1b9b4a85802a84427f17390f0f77
Type: docs
Signed-off-by: Dave Barach <dave@barachs.net>
This commit is contained in:
Dave Barach
2019-07-12 10:24:03 -04:00
committed by Florin Coras
parent 95dd1fe279
commit edff805464
1 changed files with 27 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
docs/troubleshooting/reportingissues/reportingissues.rst
View File

@ -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.