Previous     Contents     Index     Next     
iPlanet Directory Server Resource Kit 5.1 Tools Reference



Chapter 25   viewldbg


The viewldbg tool (view LDAP debugging--formerly viewcore) analyzes the contents of a core file to extract the debugging information. Use this tool when developing applications with the iPlanet LDAP SDK for C to analyze runtime conditions and errors.



Note The viewldbg tool is specific to the Solaris operating environment. The command is available only on Solaris platform installations.



This tool is identical to the viewcore tool released in version 5.0 of iPlanet DSRK, only the name has changed.

This chapter contains the following section:



Command Usage

The viewldbg tool reads a core file and extracts information about the runtime execution path and data structures.The core file must be generated by an executable that was compiled to produce the debugging information. The executable must also be given as input to the viewldbg command.


Syntax

The viewldbg command has the following syntax:

viewldbg executableFile coreFile outputFile

Where:

  • executableFile is the path and filename of the binary executable to debug, the one which produced the core file. This executable must be compiled with debugging options in order for analysis to be possible.

  • coreFile is the path and filename of the core information from an executable. Core files may be generated automatically when executables crash or generated by the gcore command for a running executable. For more information, see the gcore(1) man page.

  • outputFile is path and filename of a file where the viewcore tool will write the result of the core analysis. See the following example of sample output.



Sample Output

The following example show the output of the viewldbg tool:

$ viewldbg executableFile ./core ~/coreOutput.txt

$ cat ~/coreOutput.txt

Core analysis date . Copyright (c) 2000 Sun Microsystems, Inc.
Currently time

Opening executableFile ./core

architecture is SPARC

0: NOTE offset=0x1234 filesz=0x1234 flags=9 align=8
1: LOAD vaddr=0x0394 filesz=0x0948 memsz=0x0948 mode=RWX
...

Previous     Contents     Index     Next     
Copyright 2002 Sun Microsystems, Inc.. All rights reserved.

Last Updated April 15, 2002