#

# Copyright 2005 Sun Microsystems, Inc. All rights reserved.

# Use is subject to license terms.

#

# CDDL HEADER START

#

# The contents of this file are subject to the terms of the

# Common Development and Distribution License, Version 1.0 only

# (the "License"). You may not use this file except in compliance

# with the License.

#

# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE

# or http://www.opensolaris.org/os/licensing.

# See the License for the specific language governing permissions

# and limitations under the License.

#

# When distributing Covered Code, include this CDDL HEADER in each

# file and include the License file at usr/src/OPENSOLARIS.LICENSE.

# If applicable, add the following below this CDDL HEADER, with the

# fields enclosed by brackets "[]" replaced with your own identifying

# information: Portions Copyright [yyyy] [name of copyright owner]

#

# CDDL HEADER END

#

#pragma ident "%Z%%M% %I% %E% SMI"

This directory contains source code to the rdb debugger. This debugger

is distributed as an example client of the librtld_db.so.1 interface.

As well as offering examples of the proper calling sequence for the

librtld_db.so.1 interface rdb also offers a sample implementation of the

proc_services (/usr/include/proc_service.h) that rdb is dependent upon.

The following is an overview of the directory structure and highlight

of some of the important files contained within:

rdb.man - man page for the rdb debugger

Makefile.targ - common Makefiles included by ${MACH)/Makefile

common/* - common source code used for all architectures

sparc/

sparcv9/

i386/ - contains architecture specific source files and also

acts as the build directory

i386/Makefile - makefiles to build rdb for each architecture

test/* - sample command files which can be used to test rdb

Building rdb

------------

Before attempting to build the rdb debugger be sure that you have

installed the Solaris Developer Cluster and a C compiler (purchased

serpartly) onto your system.

To build rdb:

% cd {sparc,sparcv9,i386} - depending on which architecture you are building for

% make all

To test the demo:

% make test