xref: /onnv-gate/usr/src/cmd/sgs/librtld_db/demo/00README (revision 12927:a27c46eb192b)
1*12927SRod.Evans@Sun.COM#
2*12927SRod.Evans@Sun.COM# CDDL HEADER START
3*12927SRod.Evans@Sun.COM#
4*12927SRod.Evans@Sun.COM# The contents of this file are subject to the terms of the
5*12927SRod.Evans@Sun.COM# Common Development and Distribution License (the "License").
6*12927SRod.Evans@Sun.COM# You may not use this file except in compliance with the License.
7*12927SRod.Evans@Sun.COM#
8*12927SRod.Evans@Sun.COM# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*12927SRod.Evans@Sun.COM# or http://www.opensolaris.org/os/licensing.
10*12927SRod.Evans@Sun.COM# See the License for the specific language governing permissions
11*12927SRod.Evans@Sun.COM# and limitations under the License.
12*12927SRod.Evans@Sun.COM#
13*12927SRod.Evans@Sun.COM# When distributing Covered Code, include this CDDL HEADER in each
14*12927SRod.Evans@Sun.COM# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15*12927SRod.Evans@Sun.COM# If applicable, add the following below this CDDL HEADER, with the
16*12927SRod.Evans@Sun.COM# fields enclosed by brackets "[]" replaced with your own identifying
17*12927SRod.Evans@Sun.COM# information: Portions Copyright [yyyy] [name of copyright owner]
18*12927SRod.Evans@Sun.COM#
19*12927SRod.Evans@Sun.COM# CDDL HEADER END
20*12927SRod.Evans@Sun.COM#
21*12927SRod.Evans@Sun.COM
22*12927SRod.Evans@Sun.COM#
23*12927SRod.Evans@Sun.COM# Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
24*12927SRod.Evans@Sun.COM#
25*12927SRod.Evans@Sun.COM
26*12927SRod.Evans@Sun.COMThis directory contains source code to the rdb debugger.  This debugger
27*12927SRod.Evans@Sun.COMis distributed as an example client of the librtld_db.so.1 interface.
28*12927SRod.Evans@Sun.COMAs well as offering examples of the proper calling sequence for the
29*12927SRod.Evans@Sun.COMlibrtld_db.so.1 interface rdb also offers a sample implementation of the
30*12927SRod.Evans@Sun.COMproc_services (/usr/include/proc_service.h) that rdb is dependent upon.
31*12927SRod.Evans@Sun.COM
32*12927SRod.Evans@Sun.COMThe following is an overview of the directory structure and highlight
33*12927SRod.Evans@Sun.COMof some of the important files contained within:
34*12927SRod.Evans@Sun.COM
35*12927SRod.Evans@Sun.COMrdb.man		- man page for the rdb debugger
36*12927SRod.Evans@Sun.COMMakefile.com
37*12927SRod.Evans@Sun.COMMakefile.targ	- common Makefiles included by ${MACH)/Makefile
38*12927SRod.Evans@Sun.COMcommon/*	- common source code used for all architectures
39*12927SRod.Evans@Sun.COMamd64/		- build directory contains architecture specific source files
40*12927SRod.Evans@Sun.COMi386/		 	"	"	"	"
41*12927SRod.Evans@Sun.COMsparc/			"	"	"	"
42*12927SRod.Evans@Sun.COMsparcv9/		"	"	"	"
43*12927SRod.Evans@Sun.COMamd64/Makefile	- makefiles to build rdb for each architecture
44*12927SRod.Evans@Sun.COMi386/Makefile		"	"	"	"
45*12927SRod.Evans@Sun.COMsparc/Makefil		"	"	"	"
46*12927SRod.Evans@Sun.COMsparcv9/Makefil		"	"	"	"
47*12927SRod.Evans@Sun.COMtest/*		- sample command files which can be used to test rdb
48*12927SRod.Evans@Sun.COM
49*12927SRod.Evans@Sun.COM
50*12927SRod.Evans@Sun.COMBuilding rdb
51*12927SRod.Evans@Sun.COM------------
52*12927SRod.Evans@Sun.COM
53*12927SRod.Evans@Sun.COMTo build rdb:
54*12927SRod.Evans@Sun.COM
55*12927SRod.Evans@Sun.COM % cd {amd64,i386,sparc,sparcv9}	- depending on which architecture
56*12927SRod.Evans@Sun.COM					  you are building for
57*12927SRod.Evans@Sun.COM % make all
58*12927SRod.Evans@Sun.COM
59*12927SRod.Evans@Sun.COMTo test the demo:
60*12927SRod.Evans@Sun.COM
61*12927SRod.Evans@Sun.COM % make test
62