|
L vicodin side effects nux Crash HOWTONorman Pattennepatten@us.ibm.com2002-01-30Revision History Revision 1.0 vicodin side effects 2002-01-30 Revised by: NM Initial release. This document descr vicodin side effects bes the installation and usage of the LKCD (Linux KernelCrash Dump) package.----------------------------------------------------------------------------- vicodin side effects able of Contents1. Introduction 1.1. Copyright and License 2. How LKCD Works 2.1. What You Need 3. Installation of lkcd 3.1. Installin vicodin side effects From Source Code 3.2. Building and Installing LKCD Utilities 3.3. What Gets Installed 3.4. Installing LKCD Utilities From RPM 3.5. Patching vicodin side effects he Kernel 3.6. Build and Install the Kernel 4. Setup, Test, and Running crash 4.1. Setting up crash dump 4.2. Testing crash 4.3. Running vicodin side effects crash -----------------------------------------------------------------------------1. IntroductionThe LKCD (Linux Kernel Crash Dump) project is a se vicodin side effects of kernel patches andutilities to allow a copy of the kernel memory to be saved in the event of akernel panic. The saved kernel image makes forensics on vicodin side effects the kernel panicpossible with utilities included in the package. Most commercial Unixoperating systems come with similar crash utilities, but this packag vicodin side effects isfairly new to Linux and has to be added on manually. The LKCD utility is notdesigned to gather helpful information in the case of a hardware caused pa vicodin side effects icor a segment violation. The complete LKCD package is available for downloadat [http://lkcd.sourceforge.net/] http://lkcd.sourceforge.net/.------------- vicodin side effects ---------------------------------------------------------------1.1. Copyright and LicenseThis document is copyrighted (c) 2002 by Norman Patten. Permissi vicodin side effects n is grantedto copy, distribute and/or modify this document under the terms of the GNUFree Documentation License, Version 1.1 or any later version publis vicodin side effects ed by theFree Software Foundation; with no Invariant Sections, with no Front-CoverTexts, and with no Back-Cover Texts. A copy of the license is available vicodin side effects at[http://www.gnu.org/copyleft/fdl.html] http://www.gnu.org/copyleft/fdl.html.Linux is a registered trademark of Linus Torvalds . lkcd is distributed und vicodin side effects rthe copyright of Silicon Graphics Inc.Send feedback to nepatten@us.ibm.com.----------------------------------------------------------------------------- vicodin side effects . How LKCD WorksWhen a kernel encounters certain errors it calls the "panic" function whichresults from a unrecoverable error. This panic results in LKCD vicodin side effects initiating akernel dump where kernel memory is copied out to the pre-designated dumparea. The dump device is configured as primary swap by default. The k vicodin side effects rnel isnot completely functional at this point, but there is enough functionality tocopy memory to disk. After dump finishes copying memory to disk, the vicodin side effects ystemre-boots. When the system boots back up, it checks for a new crash dump. If anew crash dump is found it is copied from the dump location to the file vicodin side effects ystem, "/var/log/dump" directory by default. After copying the image, thesystem continues to boot normally and forensics can be performed at a laterdate. vicodin side effects ----------------------------------------------------------------------------2.1. What You Needlkcd-kernelxxx.diff file for patching the kernel. The kerne vicodin side effects versionsupported will change routinely. lkcdutils-xx.src.rpm - this is the utilitiessource and scripts you will need to setup and read a crash. At the t vicodin side effects me ofthis writing there is a i386 binary rpm available from [http://lkcd.sourceforge.net/] lkcd.sourceforge.net, but you will still need thepatches for t vicodin side effects e startup scripts from the source rpm.-----------------------------------------------------------------------------3. Installation of lkcd3.1. Installing vicodin side effects From Source CodeGet the lkcdutils-xxx.src.rpm and install it using rpm -ikcdutils-xxx.src.rpm . This will place a file called lkcdutils-xxx.tar.gz inthe vicodin side effects usr/src/redhat/SOURCES directory. This file is a compressed tar image ofthe lkcd source tree. Unwind the source in a directory of your choice like "/usr/ vicodin side effects rc" with tar -zxvf kcdutils-xxx.src.rpm . This will create a directorycalled "kcdutils-xxx" which will contain the LKCD utilities source.---------------- vicodin side effects ------------------------------------------------------------3.2. Building and Installing LKCD UtilitiesLKCD used the standard GCC compiler and make files vicodin side effects To build the suite, cd tothe LKCD src directory and run ./configure to build configuration files. Thenext step is to run make to build the utilities, an vicodin side effects finally run make installto install the utilities and man pages.-----------------------------------------------------------------------------3.3. What Ge vicodin side effects s Installed+-------------------------------------------------------------------------------+| /etc/sysconfig/dump # Configuration file for d vicodin side effects mp || /sbin/lcrash # The crash utility || /sbin/lkcd # Script to config vicodin side effects re and save a crash || /sbin/lkcd_config # Configuration utility for dump || /sbin/lkcd_ksyms # Utility vicodin side effects or reconstructing kernel symbols || /usr/include/sial_api.h # Header file for the SIAL API || /usr/lib/libsial.a # vicodin side effects imple Image Access Language library || /usr/man/man1/lcrash.1 # man page for lcrash || /usr/man/man1/lkcd_config. vicodin side effects # man page for lkcd_config || /usr/man/man1/lkcd_ksyms.1 # man page for lkcd_ksyms || /usr/share/sial/lc vicodin side effects ash/ps.sial # ps command implementation of SIAL || |+------------ vicodin side effects ------------------------------------------------------------------+-----------------------------------------------------------------------------3.4. Inst vicodin side effects lling LKCD Utilities From RPMYou can install the pre-built utilities from rpm by running rpm -ikcdutils-xxx.rpm . You will still need to patch the kernel vicodin side effects and install thestartup script patches. However you can bypass building the utilities step.--------------------------------------------------------------- vicodin side effects -------------3.5. Patching the KernelThe next step is patching and rebuilding the kernel. You will need to patchthe kernel source with the lkcd-xxx.diff vicodin side effects ile you downloaded from [http://lkcd.sourceforge.net/] http://lkcd.sourceforge.net/. Copy the patch into thesame directory as your kernel and run patch - vicodin side effects 0 < lkcd-kernelxxx.diff . Makesure the patch you use is the same version as the kernel you are patching.Next you will need to configure the kernel to ena vicodin side effects le crash dump support. Bydefault crash support is turned off after applying the patch. If you use makemenuconfig or make xconfig, the "LKCD support" opti vicodin side effects n is under kernelhacking. You will also need to enable other kernel features you might need.See the The Linux Kernel HOWTO for further details.---------- vicodin side effects ------------------------------------------------------------------3.6. Build and Install the KernelThe next is building and installing the crash enabled vicodin side effects ernel. In the kernelsource directory run the following commands in order.+---------------------------------------------------------------------------+| vicodin side effects || make depend || vicodin side effects ake install || make modules || make modules_install || |+---------------------------------------------------------------------------+This will build and installing the new kernel, you will also need to copy theKerntypes file from the kernel source to the /boot directory. You may alsoneed to edit the lilo.conf file to point to you new kernel. See [http://linuxdoc.org/HOWTO/Kernel-HOWTO.html] http://www.linuxdoc.org/HOWTO/Kernel-HOWTO.html for more information on building and installing a kernel.-----------------------------------------------------------------------------4. Setup, Test, and Running crash4.1. Setting up crash dumpIn order to save a core image that has been written into swap, the image mustbe saved prior to swap being re-mounted during boot. To accomplish this, thesysinit startup file needs to be changed. The lkcd source includes a scriptsdirectory which contains patches for various sysinit startup scripts. Thesepatches add the lkcd config and lkcd save com
|
