[p5sagit/p5-mst-13.2.git] / lib / perldb.pl

package DB;

# modified Perl debugger, to be run from Emacs in perldb-mode
# Ray Lischner (uunet!mntgfx!lisch) as of 5 Nov 1990
# Johan Vromans -- upgrade to 4.0 pl 10

$header = '$RCSfile: perldb.pl,v $$Revision: 4.0.1.3 $$Date: 92/06/08 13:43:57 $';
#
# This file is automatically included if you do perl -d.
# It's probably not useful to include this yourself.
#
# Perl supplies the values for @line and %sub.  It effectively inserts
# a do DB'DB(<linenum>); in front of every place that can
# have a breakpoint.  It also inserts a do 'perldb.pl' before the first line.
#
# $Log:	perldb.pl,v $
# Revision 4.0.1.3  92/06/08  13:43:57  lwall
# patch20: support for MSDOS folded into perldb.pl
# patch20: perldb couldn't debug file containing '-', such as STDIN designator
# 
# Revision 4.0.1.2  91/11/05  17:55:58  lwall
# patch11: perldb.pl modified to run within emacs in perldb-mode
# 
# Revision 4.0.1.1  91/06/07  11:17:44  lwall
# patch4: added $^P variable to control calling of perldb routines
# patch4: debugger sometimes listed wrong number of lines for a statement
# 
# Revision 4.0  91/03/20  01:25:50  lwall
# 4.0 baseline.
# 
# Revision 3.0.1.6  91/01/11  18:08:58  lwall
# patch42: @_ couldn't be accessed from debugger
# 
# Revision 3.0.1.5  90/11/10  01:40:26  lwall
# patch38: the debugger wouldn't stop correctly or do action routines
# 
# Revision 3.0.1.4  90/10/15  17:40:38  lwall
# patch29: added caller
# patch29: the debugger now understands packages and evals
# patch29: scripts now run at almost full speed under the debugger
# patch29: more variables are settable from debugger
# 
# Revision 3.0.1.3  90/08/09  04:00:58  lwall
# patch19: debugger now allows continuation lines
# patch19: debugger can now dump lists of variables
# patch19: debugger can now add aliases easily from prompt
# 
# Revision 3.0.1.2  90/03/12  16:39:39  lwall
# patch13: perl -d didn't format stack traces of *foo right
# patch13: perl -d wiped out scalar return values of subroutines
# 
# Revision 3.0.1.1  89/10/26  23:14:02  lwall
# patch1: RCS expanded an unintended $Header in lib/perldb.pl
# 
# Revision 3.0  89/10/18  15:19:46  lwall
# 3.0 baseline
# 
# Revision 2.0  88/06/05  00:09:45  root
# Baseline version 2.0.
# 
#

if (-e "/dev/tty") {
    $console = "/dev/tty";
    $rcfile=".perldb";
}
else {
    $console = "con";
    $rcfile="perldb.ini";
}

open(IN, "<$console") || open(IN,  "<&STDIN");	# so we don't dingle stdin
open(OUT,">$console") || open(OUT, ">&STDOUT");	# so we don't dongle stdout
select(OUT);
$| = 1;				# for DB'OUT
select(STDOUT);
$| = 1;				# for real STDOUT
$sub = '';

# Is Perl being run from Emacs?
$emacs = $main'ARGV[$[] eq '-emacs';
shift(@main'ARGV) if $emacs;

$header =~ s/.Header: ([^,]+),v(\s+\S+\s+\S+).*$/$1$2/;
print OUT "\nLoading DB routines from $header\n";
print OUT ("Emacs support ",
	   $emacs ? "enabled" : "available",
	   ".\n");
print OUT "\nEnter h for help.\n\n";

sub DB {
    &save;
    ($package, $filename, $line) = caller;
    $usercontext = '($@, $!, $[, $,, $/, $\) = @saved;' .
	"package $package;";		# this won't let them modify, alas
    local($^P) = 0;			# don't debug our own evals
    local(*dbline) = "_<$filename";
    $max = $#dbline;
    if (($stop,$action) = split(/\0/,$dbline{$line})) {
	if ($stop eq '1') {
	    $signal |= 1;
	}
	else {
	    $evalarg = "\$DB'signal |= do {$stop;}"; &eval;
	    $dbline{$line} =~ s/;9($|\0)/$1/;
	}
    }
    if ($single || $trace || $signal) {
	if ($emacs) {
	    print OUT "\032\032$filename:$line:0\n";
	} else {
	    print OUT "$package'" unless $sub =~ /'/;
	    print OUT "$sub($filename:$line):\t",$dbline[$line];
	    for ($i = $line + 1; $i <= $max && $dbline[$i] == 0; ++$i) {
		last if $dbline[$i] =~ /^\s*(}|#|\n)/;
		print OUT "$sub($filename:$i):\t",$dbline[$i];
	    }
	}
    }
    $evalarg = $action, &eval if $action;
    if ($single || $signal) {
	$evalarg = $pre, &eval if $pre;
	print OUT $#stack . " levels deep in subroutine calls!\n"
	    if $single & 4;
	$start = $line;
      CMD:
	while ((print OUT "  DB<", $#hist+1, "> "), $cmd=&gets) {
	    {
		$single = 0;
		$signal = 0;
		$cmd eq '' && exit 0;
		chop($cmd);
		$cmd =~ s/\\$// && do {
		    print OUT "  cont: ";
		    $cmd .= &gets;
		    redo CMD;
		};
		$cmd =~ /^q$/ && exit 0;
		$cmd =~ /^$/ && ($cmd = $laststep);
		push(@hist,$cmd) if length($cmd) > 1;
		($i) = split(/\s+/,$cmd);
		eval "\$cmd =~ $alias{$i}", print OUT $@ if $alias{$i};
		$cmd =~ /^h$/ && do {
		    print OUT "
T		Stack trace.
s		Single step.
n		Next, steps over subroutine calls.
r		Return from current subroutine.
c [line]	Continue; optionally inserts a one-time-only breakpoint 
		at the specified line.
<CR>		Repeat last n or s.
l min+incr	List incr+1 lines starting at min.
l min-max	List lines.
l line		List line;
l		List next window.
-		List previous window.
w line		List window around line.
l subname	List subroutine.
f filename	Switch to filename.
/pattern/	Search forwards for pattern; final / is optional.
?pattern?	Search backwards for pattern.
L		List breakpoints and actions.
S		List subroutine names.
t		Toggle trace mode.
b [line] [condition]
		Set breakpoint; line defaults to the current execution line; 
		condition breaks if it evaluates to true, defaults to \'1\'.
b subname [condition]
		Set breakpoint at first line of subroutine.
d [line]	Delete breakpoint.
D		Delete all breakpoints.
a [line] command
		Set an action to be done before the line is executed.
		Sequence is: check for breakpoint, print line if necessary,
		do action, prompt user if breakpoint or step, evaluate line.
A		Delete all actions.
V [pkg [vars]]	List some (default all) variables in package (default current).
X [vars]	Same as \"V currentpackage [vars]\".
< command	Define command before prompt.
> command	Define command after prompt.
! number	Redo command (default previous command).
! -number	Redo number\'th to last command.
H -number	Display last number commands (default all).
q or ^D		Quit.
p expr		Same as \"print DB'OUT expr\" in current package.
= [alias value]	Define a command alias, or list current aliases.
command		Execute as a perl statement in current package.

";
		    next CMD; };
		$cmd =~ /^t$/ && do {
		    $trace = !$trace;
		    print OUT "Trace = ".($trace?"on":"off")."\n";
		    next CMD; };
		$cmd =~ /^S$/ && do {
		    foreach $subname (sort(keys %sub)) {
			print OUT $subname,"\n";
		    }
		    next CMD; };
		$cmd =~ s/^X\b/V $package/;
		$cmd =~ /^V$/ && do {
		    $cmd = 'V $package'; };
		$cmd =~ /^V\b\s*(\S+)\s*(.*)/ && do {
		    $packname = $1;
		    @vars = split(' ',$2);
		    do 'dumpvar.pl' unless defined &main'dumpvar;
		    if (defined &main'dumpvar) {
			&main'dumpvar($packname,@vars);
		    }
		    else {
			print DB'OUT "dumpvar.pl not available.\n";
		    }
		    next CMD; };
		$cmd =~ /^f\b\s*(.*)/ && do {
		    $file = $1;
		    if (!$file) {
			print OUT "The old f command is now the r command.\n";
			print OUT "The new f command switches filenames.\n";
			next CMD;
		    }
		    if (!defined $_main{'_<' . $file}) {
			if (($try) = grep(m#^_<.*$file#, keys %_main)) {
			    $file = substr($try,2);
			    print "\n$file:\n";
			}
		    }
		    if (!defined $_main{'_<' . $file}) {
			print OUT "There's no code here anything matching $file.\n";
			next CMD;
		    }
		    elsif ($file ne $filename) {
			*dbline = "_<$file";
			$max = $#dbline;
			$filename = $file;
			$start = 1;
			$cmd = "l";
		    } };
		$cmd =~ /^l\b\s*(['A-Za-z_]['\w]*)/ && do {
		    $subname = $1;
		    $subname = "main'" . $subname unless $subname =~ /'/;
		    $subname = "main" . $subname if substr($subname,0,1) eq "'";
		    ($file,$subrange) = split(/:/,$sub{$subname});
		    if ($file ne $filename) {
			*dbline = "_<$file";
			$max = $#dbline;
			$filename = $file;
		    }
		    if ($subrange) {
			if (eval($subrange) < -$window) {
			    $subrange =~ s/-.*/+/;
			}
			$cmd = "l $subrange";
		    } else {
			print OUT "Subroutine $1 not found.\n";
			next CMD;
		    } };
		$cmd =~ /^w\b\s*(\d*)$/ && do {
		    $incr = $window - 1;
		    $start = $1 if $1;
		    $start -= $preview;
		    $cmd = 'l ' . $start . '-' . ($start + $incr); };
		$cmd =~ /^-$/ && do {
		    $incr = $window - 1;
		    $cmd = 'l ' . ($start-$window*2) . '+'; };
		$cmd =~ /^l$/ && do {
		    $incr = $window - 1;
		    $cmd = 'l ' . $start . '-' . ($start + $incr); };
		$cmd =~ /^l\b\s*(\d*)\+(\d*)$/ && do {
		    $start = $1 if $1;
		    $incr = $2;
		    $incr = $window - 1 unless $incr;
		    $cmd = 'l ' . $start . '-' . ($start + $incr); };
		$cmd =~ /^l\b\s*(([\d\$\.]+)([-,]([\d\$\.]+))?)?/ && do {
		    $end = (!$2) ? $max : ($4 ? $4 : $2);
		    $end = $max if $end > $max;
		    $i = $2;
		    $i = $line if $i eq '.';
		    $i = 1 if $i < 1;
		    if ($emacs) {
			print OUT "\032\032$filename:$i:0\n";
			$i = $end;
		    } else {
			for (; $i <= $end; $i++) {
			    print OUT "$i:\t", $dbline[$i];
			    last if $signal;
			}
		    }
		    $start = $i;	# remember in case they want more
		    $start = $max if $start > $max;
		    next CMD; };
		$cmd =~ /^D$/ && do {
		    print OUT "Deleting all breakpoints...\n";
		    for ($i = 1; $i <= $max ; $i++) {
			if (defined $dbline{$i}) {
			    $dbline{$i} =~ s/^[^\0]+//;
			    if ($dbline{$i} =~ s/^\0?$//) {
				delete $dbline{$i};
			    }
			}
		    }
		    next CMD; };
		$cmd =~ /^L$/ && do {
		    for ($i = 1; $i <= $max; $i++) {
			if (defined $dbline{$i}) {
			    print OUT "$i:\t", $dbline[$i];
			    ($stop,$action) = split(/\0/, $dbline{$i});
			    print OUT "  break if (", $stop, ")\n" 
				if $stop;
			    print OUT "  action:  ", $action, "\n" 
				if $action;
			    last if $signal;
			}
		    }
		    next CMD; };
		$cmd =~ /^b\b\s*(['A-Za-z_]['\w]*)\s*(.*)/ && do {
		    $subname = $1;
		    $cond = $2 || '1';
		    $subname = "$package'" . $subname unless $subname =~ /'/;
		    $subname = "main" . $subname if substr($subname,0,1) eq "'";
		    ($filename,$i) = split(/:/, $sub{$subname});
		    $i += 0;
		    if ($i) {
			*dbline = "_<$filename";
			++$i while $dbline[$i] == 0 && $i < $#dbline;
			$dbline{$i} =~ s/^[^\0]*/$cond/;
		    } else {
			print OUT "Subroutine $subname not found.\n";
		    }
		    next CMD; };
		$cmd =~ /^b\b\s*(\d*)\s*(.*)/ && do {
		    $i = ($1?$1:$line);
		    $cond = $2 || '1';
		    if ($dbline[$i] == 0) {
			print OUT "Line $i not breakable.\n";
		    } else {
			$dbline{$i} =~ s/^[^\0]*/$cond/;
		    }
		    next CMD; };
		$cmd =~ /^d\b\s*(\d+)?/ && do {
		    $i = ($1?$1:$line);
		    $dbline{$i} =~ s/^[^\0]*//;
		    delete $dbline{$i} if $dbline{$i} eq '';
		    next CMD; };
		$cmd =~ /^A$/ && do {
		    for ($i = 1; $i <= $max ; $i++) {
			if (defined $dbline{$i}) {
			    $dbline{$i} =~ s/\0[^\0]*//;
			    delete $dbline{$i} if $dbline{$i} eq '';
			}
		    }
		    next CMD; };
		$cmd =~ /^<\s*(.*)/ && do {
		    $pre = do action($1);
		    next CMD; };
		$cmd =~ /^>\s*(.*)/ && do {
		    $post = do action($1);
		    next CMD; };
		$cmd =~ /^a\b\s*(\d+)(\s+(.*))?/ && do {
		    $i = $1;
		    if ($dbline[$i] == 0) {
			print OUT "Line $i may not have an action.\n";
		    } else {
			$dbline{$i} =~ s/\0[^\0]*//;
			$dbline{$i} .= "\0" . do action($3);
		    }
		    next CMD; };
		$cmd =~ /^n$/ && do {
		    $single = 2;
		    $laststep = $cmd;
		    last CMD; };
		$cmd =~ /^s$/ && do {
		    $single = 1;
		    $laststep = $cmd;
		    last CMD; };
		$cmd =~ /^c\b\s*(\d*)\s*$/ && do {
		    $i = $1;
		    if ($i) {
			if ($dbline[$i] == 0) {
			    print OUT "Line $i not breakable.\n";
			    next CMD;
			}
			$dbline{$i} =~ s/(\0|$)/;9$1/;	# add one-time-only b.p.
		    }
		    for ($i=0; $i <= $#stack; ) {
			$stack[$i++] &= ~1;
		    }
		    last CMD; };
		$cmd =~ /^r$/ && do {
		    $stack[$#stack] |= 2;
		    last CMD; };
		$cmd =~ /^T$/ && do {
		    local($p,$f,$l,$s,$h,$a,@a,@sub);
		    for ($i = 1; ($p,$f,$l,$s,$h,$w) = caller($i); $i++) {
			@a = @args;
			for (@a) {
			    if (/^StB\000/ && length($_) == length($_main{'_main'})) {
				$_ = sprintf("%s",$_);
			    }
			    else {
				s/'/\\'/g;
				s/([^\0]*)/'$1'/ unless /^-?[\d.]+$/;
				s/([\200-\377])/sprintf("M-%c",ord($1)&0177)/eg;
				s/([\0-\37\177])/sprintf("^%c",ord($1)^64)/eg;
			    }
			}
			$w = $w ? '@ = ' : '$ = ';
			$a = $h ? '(' . join(', ', @a) . ')' : '';
			push(@sub, "$w&$s$a from file $f line $l\n");
			last if $signal;
		    }
		    for ($i=0; $i <= $#sub; $i++) {
			last if $signal;
			print OUT $sub[$i];
		    }
		    next CMD; };
		$cmd =~ /^\/(.*)$/ && do {
		    $inpat = $1;
		    $inpat =~ s:([^\\])/$:$1:;
		    if ($inpat ne "") {
			eval '$inpat =~ m'."\n$inpat\n";	
			if ($@ ne "") {
			    print OUT "$@";
			    next CMD;
			}
			$pat = $inpat;
		    }
		    $end = $start;
		    eval '
		    for (;;) {
			++$start;
			$start = 1 if ($start > $max);
			last if ($start == $end);
			if ($dbline[$start] =~ m'."\n$pat\n".'i) {
			    if ($emacs) {
				print OUT "\032\032$filename:$start:0\n";
			    } else {
				print OUT "$start:\t", $dbline[$start], "\n";
			    }
			    last;
			}
		    } ';
		    print OUT "/$pat/: not found\n" if ($start == $end);
		    next CMD; };
		$cmd =~ /^\?(.*)$/ && do {
		    $inpat = $1;
		    $inpat =~ s:([^\\])\?$:$1:;
		    if ($inpat ne "") {
			eval '$inpat =~ m'."\n$inpat\n";	
			if ($@ ne "") {
			    print OUT "$@";
			    next CMD;
			}
			$pat = $inpat;
		    }
		    $end = $start;
		    eval '
		    for (;;) {
			--$start;
			$start = $max if ($start <= 0);
			last if ($start == $end);
			if ($dbline[$start] =~ m'."\n$pat\n".'i) {
			    if ($emacs) {
				print OUT "\032\032$filename:$start:0\n";
			    } else {
				print OUT "$start:\t", $dbline[$start], "\n";
			    }
			    last;
			}
		    } ';
		    print OUT "?$pat?: not found\n" if ($start == $end);
		    next CMD; };
		$cmd =~ /^!+\s*(-)?(\d+)?$/ && do {
		    pop(@hist) if length($cmd) > 1;
		    $i = ($1?($#hist-($2?$2:1)):($2?$2:$#hist));
		    $cmd = $hist[$i] . "\n";
		    print OUT $cmd;
		    redo CMD; };
		$cmd =~ /^!(.+)$/ && do {
		    $pat = "^$1";
		    pop(@hist) if length($cmd) > 1;
		    for ($i = $#hist; $i; --$i) {
			last if $hist[$i] =~ $pat;
		    }
		    if (!$i) {
			print OUT "No such command!\n\n";
			next CMD;
		    }
		    $cmd = $hist[$i] . "\n";
		    print OUT $cmd;
		    redo CMD; };
		$cmd =~ /^H\b\s*(-(\d+))?/ && do {
		    $end = $2?($#hist-$2):0;
		    $hist = 0 if $hist < 0;
		    for ($i=$#hist; $i>$end; $i--) {
			print OUT "$i: ",$hist[$i],"\n"
			    unless $hist[$i] =~ /^.?$/;
		    };
		    next CMD; };
		$cmd =~ s/^p( .*)?$/print DB'OUT$1/;
		$cmd =~ /^=/ && do {
		    if (local($k,$v) = ($cmd =~ /^=\s*(\S+)\s+(.*)/)) {
			$alias{$k}="s~$k~$v~";
			print OUT "$k = $v\n";
		    } elsif ($cmd =~ /^=\s*$/) {
			foreach $k (sort keys(%alias)) {
			    if (($v = $alias{$k}) =~ s~^s\~$k\~(.*)\~$~$1~) {
				print OUT "$k = $v\n";
			    } else {
				print OUT "$k\t$alias{$k}\n";
			    };
			};
		    };
		    next CMD; };
	    }
	    $evalarg = $cmd; &eval;
	    print OUT "\n";
	}
	if ($post) {
	    $evalarg = $post; &eval;
	}
    }
    ($@, $!, $[, $,, $/, $\) = @saved;
}

sub save {
    @saved = ($@, $!, $[, $,, $/, $\);
    $[ = 0; $, = ""; $/ = "\n"; $\ = "";
}

# The following takes its argument via $evalarg to preserve current @_

sub eval {
    eval "$usercontext $evalarg; &DB'save";
    print OUT $@;
}

sub action {
    local($action) = @_;
    while ($action =~ s/\\$//) {
	print OUT "+ ";
	$action .= &gets;
    }
    $action;
}

sub gets {
    local($.);
    <IN>;
}

sub catch {
    $signal = 1;
}

sub sub {
    push(@stack, $single);
    $single &= 1;
    $single |= 4 if $#stack == $deep;
    if (wantarray) {
	@i = &$sub;
	$single |= pop(@stack);
	@i;
    }
    else {
	$i = &$sub;
	$single |= pop(@stack);
	$i;
    }
}

$single = 1;			# so it stops on first executable statement
@hist = ('?');
$SIG{'INT'} = "DB'catch";
$deep = 100;		# warning if stack gets this deep
$window = 10;
$preview = 3;

@stack = (0);
@ARGS = @ARGV;
for (@args) {
    s/'/\\'/g;
    s/(.*)/'$1'/ unless /^-?[\d.]+$/;
}

if (-f $rcfile) {
    do "./$rcfile";
}
elsif (-f "$ENV{'LOGDIR'}/$rcfile") {
    do "$ENV{'LOGDIR'}/$rcfile";
}
elsif (-f "$ENV{'HOME'}/$rcfile") {
    do "$ENV{'HOME'}/$rcfile";
}

1;
Commit	Line	Data
a687059c	1	package DB;
a687059c	2
f0fcb552	3	# modified Perl debugger, to be run from Emacs in perldb-mode
	4	# Ray Lischner (uunet!mntgfx!lisch) as of 5 Nov 1990
	5	# Johan Vromans -- upgrade to 4.0 pl 10
	6
83025b21	7	$header = '$RCSfile: perldb.pl,v $$Revision: 4.0.1.3 $$Date: 92/06/08 13:43:57 $';
a687059c	8	#
	9	# This file is automatically included if you do perl -d.
	10	# It's probably not useful to include this yourself.
	11	#
	12	# Perl supplies the values for @line and %sub. It effectively inserts
	13	# a do DB'DB(<linenum>); in front of every place that can
	14	# have a breakpoint. It also inserts a do 'perldb.pl' before the first line.
	15	#
	16	# $Log: perldb.pl,v $
83025b21	17	# Revision 4.0.1.3 92/06/08 13:43:57 lwall
	18	# patch20: support for MSDOS folded into perldb.pl
	19	# patch20: perldb couldn't debug file containing '-', such as STDIN designator
	20	#
f0fcb552	21	# Revision 4.0.1.2 91/11/05 17:55:58 lwall
	22	# patch11: perldb.pl modified to run within emacs in perldb-mode
	23	#
9ef589d8	24	# Revision 4.0.1.1 91/06/07 11:17:44 lwall
	25	# patch4: added $^P variable to control calling of perldb routines
	26	# patch4: debugger sometimes listed wrong number of lines for a statement
	27	#
fe14fcc3	28	# Revision 4.0 91/03/20 01:25:50 lwall
	29	# 4.0 baseline.
	30	#
27e2fb84	31	# Revision 3.0.1.6 91/01/11 18:08:58 lwall
	32	# patch42: @_ couldn't be accessed from debugger
	33	#
34de22dd	34	# Revision 3.0.1.5 90/11/10 01:40:26 lwall
	35	# patch38: the debugger wouldn't stop correctly or do action routines
	36	#
76854fea	37	# Revision 3.0.1.4 90/10/15 17:40:38 lwall
	38	# patch29: added caller
	39	# patch29: the debugger now understands packages and evals
	40	# patch29: scripts now run at almost full speed under the debugger
	41	# patch29: more variables are settable from debugger
	42	#
33b78306	43	# Revision 3.0.1.3 90/08/09 04:00:58 lwall
	44	# patch19: debugger now allows continuation lines
	45	# patch19: debugger can now dump lists of variables
	46	# patch19: debugger can now add aliases easily from prompt
	47	#
79a0689e	48	# Revision 3.0.1.2 90/03/12 16:39:39 lwall
	49	# patch13: perl -d didn't format stack traces of *foo right
	50	# patch13: perl -d wiped out scalar return values of subroutines
	51	#
03a14243	52	# Revision 3.0.1.1 89/10/26 23:14:02 lwall
	53	# patch1: RCS expanded an unintended $Header in lib/perldb.pl
	54	#
a687059c	55	# Revision 3.0 89/10/18 15:19:46 lwall
	56	# 3.0 baseline
	57	#
	58	# Revision 2.0 88/06/05 00:09:45 root
	59	# Baseline version 2.0.
	60	#
	61	#
	62
83025b21	63	if (-e "/dev/tty") {
	64	$console = "/dev/tty";
	65	$rcfile=".perldb";
	66	}
	67	else {
	68	$console = "con";
	69	$rcfile="perldb.ini";
	70	}
	71
	72	open(IN, "<$console") \|\| open(IN, "<&STDIN"); # so we don't dingle stdin
	73	open(OUT,">$console") \|\| open(OUT, ">&STDOUT"); # so we don't dongle stdout
a687059c	74	select(OUT);
	75	$\| = 1; # for DB'OUT
	76	select(STDOUT);
	77	$\| = 1; # for real STDOUT
76854fea	78	$sub = '';
a687059c	79
f0fcb552	80	# Is Perl being run from Emacs?
	81	$emacs = $main'ARGV[$[] eq '-emacs';
	82	shift(@main'ARGV) if $emacs;
	83
03a14243	84	$header =~ s/.Header: ([^,]+),v(\s+\S+\s+\S+).*$/$1$2/;
f0fcb552	85	print OUT "\nLoading DB routines from $header\n";
	86	print OUT ("Emacs support ",
	87	$emacs ? "enabled" : "available",
	88	".\n");
	89	print OUT "\nEnter h for help.\n\n";
a687059c	90
a687059c	91	sub DB {
76854fea	92	&save;
	93	($package, $filename, $line) = caller;
	94	$usercontext = '($@, $!, $[, $,, $/, $\) = @saved;' .
	95	"package $package;"; # this won't let them modify, alas
9ef589d8	96	local($^P) = 0; # don't debug our own evals
76854fea	97	local(*dbline) = "_<$filename";
	98	$max = $#dbline;
	99	if (($stop,$action) = split(/\0/,$dbline{$line})) {
a687059c	100	if ($stop eq '1') {
	101	$signal \|= 1;
	102	}
	103	else {
27e2fb84	104	$evalarg = "\$DB'signal \|= do {$stop;}"; &eval;
76854fea	105	$dbline{$line} =~ s/;9($\|\0)/$1/;
a687059c	106	}
	107	}
	108	if ($single \|\| $trace \|\| $signal) {
f0fcb552	109	if ($emacs) {
	110	print OUT "\032\032$filename:$line:0\n";
	111	} else {
	112	print OUT "$package'" unless $sub =~ /'/;
	113	print OUT "$sub($filename:$line):\t",$dbline[$line];
	114	for ($i = $line + 1; $i <= $max && $dbline[$i] == 0; ++$i) {
	115	last if $dbline[$i] =~ /^\s*(}\|#\|\n)/;
	116	print OUT "$sub($filename:$i):\t",$dbline[$i];
	117	}
a687059c	118	}
a687059c	119	}
27e2fb84	120	$evalarg = $action, &eval if $action;
a687059c	121	if ($single \|\| $signal) {
27e2fb84	122	$evalarg = $pre, &eval if $pre;
a687059c	123	print OUT $#stack . " levels deep in subroutine calls!\n"
	124	if $single & 4;
	125	$start = $line;
fe14fcc3	126	CMD:
76854fea	127	while ((print OUT " DB<", $#hist+1, "> "), $cmd=&gets) {
fe14fcc3	128	{
	129	$single = 0;
	130	$signal = 0;
	131	$cmd eq '' && exit 0;
	132	chop($cmd);
	133	$cmd =~ s/\\$// && do {
	134	print OUT " cont: ";
	135	$cmd .= &gets;
	136	redo CMD;
	137	};
	138	$cmd =~ /^q$/ && exit 0;
	139	$cmd =~ /^$/ && ($cmd = $laststep);
	140	push(@hist,$cmd) if length($cmd) > 1;
	141	($i) = split(/\s+/,$cmd);
	142	eval "\$cmd =~ $alias{$i}", print OUT $@ if $alias{$i};
	143	$cmd =~ /^h$/ && do {
	144	print OUT "
a687059c	145	T Stack trace.
	146	s Single step.
	147	n Next, steps over subroutine calls.
76854fea	148	r Return from current subroutine.
a687059c	149	c [line] Continue; optionally inserts a one-time-only breakpoint
	150	at the specified line.
	151	<CR> Repeat last n or s.
	152	l min+incr List incr+1 lines starting at min.
	153	l min-max List lines.
	154	l line List line;
	155	l List next window.
	156	- List previous window.
	157	w line List window around line.
	158	l subname List subroutine.
76854fea	159	f filename Switch to filename.
a687059c	160	/pattern/ Search forwards for pattern; final / is optional.
	161	?pattern? Search backwards for pattern.
	162	L List breakpoints and actions.
	163	S List subroutine names.
	164	t Toggle trace mode.
	165	b [line] [condition]
	166	Set breakpoint; line defaults to the current execution line;
	167	condition breaks if it evaluates to true, defaults to \'1\'.
	168	b subname [condition]
	169	Set breakpoint at first line of subroutine.
	170	d [line] Delete breakpoint.
	171	D Delete all breakpoints.
	172	a [line] command
	173	Set an action to be done before the line is executed.
	174	Sequence is: check for breakpoint, print line if necessary,
	175	do action, prompt user if breakpoint or step, evaluate line.
	176	A Delete all actions.
76854fea	177	V [pkg [vars]] List some (default all) variables in package (default current).
76854fea	178	X [vars] Same as \"V currentpackage [vars]\".
a687059c	179	< command Define command before prompt.
	180	> command Define command after prompt.
	181	! number Redo command (default previous command).
	182	! -number Redo number\'th to last command.
	183	H -number Display last number commands (default all).
	184	q or ^D Quit.
76854fea	185	p expr Same as \"print DB'OUT expr\" in current package.
33b78306	186	= [alias value] Define a command alias, or list current aliases.
76854fea	187	command Execute as a perl statement in current package.
a687059c	188
a687059c	189	";
fe14fcc3	190	next CMD; };
	191	$cmd =~ /^t$/ && do {
	192	$trace = !$trace;
	193	print OUT "Trace = ".($trace?"on":"off")."\n";
	194	next CMD; };
	195	$cmd =~ /^S$/ && do {
	196	foreach $subname (sort(keys %sub)) {
	197	print OUT $subname,"\n";
	198	}
	199	next CMD; };
	200	$cmd =~ s/^X\b/V $package/;
	201	$cmd =~ /^V$/ && do {
	202	$cmd = 'V $package'; };
	203	$cmd =~ /^V\b\s(\S+)\s(.*)/ && do {
	204	$packname = $1;
	205	@vars = split(' ',$2);
	206	do 'dumpvar.pl' unless defined &main'dumpvar;
	207	if (defined &main'dumpvar) {
	208	&main'dumpvar($packname,@vars);
	209	}
	210	else {
	211	print DB'OUT "dumpvar.pl not available.\n";
76854fea	212	}
fe14fcc3	213	next CMD; };
	214	$cmd =~ /^f\b\s(.)/ && do {
	215	$file = $1;
	216	if (!$file) {
	217	print OUT "The old f command is now the r command.\n";
	218	print OUT "The new f command switches filenames.\n";
	219	next CMD;
a687059c	220	}
fe14fcc3	221	if (!defined $_main{'_<' . $file}) {
	222	if (($try) = grep(m#^_<.*$file#, keys %_main)) {
	223	$file = substr($try,2);
	224	print "\n$file:\n";
76854fea	225	}
76854fea	226	}
fe14fcc3	227	if (!defined $_main{'_<' . $file}) {
	228	print OUT "There's no code here anything matching $file.\n";
	229	next CMD;
	230	}
	231	elsif ($file ne $filename) {
	232	*dbline = "_<$file";
	233	$max = $#dbline;
	234	$filename = $file;
	235	$start = 1;
	236	$cmd = "l";
	237	} };
	238	$cmd =~ /^l\b\s(['A-Za-z_]['\w])/ && do {
	239	$subname = $1;
	240	$subname = "main'" . $subname unless $subname =~ /'/;
	241	$subname = "main" . $subname if substr($subname,0,1) eq "'";
	242	($file,$subrange) = split(/:/,$sub{$subname});
	243	if ($file ne $filename) {
	244	*dbline = "_<$file";
	245	$max = $#dbline;
	246	$filename = $file;
	247	}
	248	if ($subrange) {
	249	if (eval($subrange) < -$window) {
	250	$subrange =~ s/-.*/+/;
	251	}
	252	$cmd = "l $subrange";
	253	} else {
	254	print OUT "Subroutine $1 not found.\n";
	255	next CMD;
	256	} };
	257	$cmd =~ /^w\b\s(\d)$/ && do {
	258	$incr = $window - 1;
	259	$start = $1 if $1;
	260	$start -= $preview;
	261	$cmd = 'l ' . $start . '-' . ($start + $incr); };
	262	$cmd =~ /^-$/ && do {
	263	$incr = $window - 1;
	264	$cmd = 'l ' . ($start-$window*2) . '+'; };
	265	$cmd =~ /^l$/ && do {
	266	$incr = $window - 1;
	267	$cmd = 'l ' . $start . '-' . ($start + $incr); };
	268	$cmd =~ /^l\b\s(\d)\+(\d*)$/ && do {
	269	$start = $1 if $1;
	270	$incr = $2;
	271	$incr = $window - 1 unless $incr;
	272	$cmd = 'l ' . $start . '-' . ($start + $incr); };
	273	$cmd =~ /^l\b\s*(([\d\$\.]+)([-,]([\d\$\.]+))?)?/ && do {
	274	$end = (!$2) ? $max : ($4 ? $4 : $2);
	275	$end = $max if $end > $max;
	276	$i = $2;
	277	$i = $line if $i eq '.';
	278	$i = 1 if $i < 1;
f0fcb552	279	if ($emacs) {
	280	print OUT "\032\032$filename:$i:0\n";
	281	$i = $end;
	282	} else {
	283	for (; $i <= $end; $i++) {
	284	print OUT "$i:\t", $dbline[$i];
	285	last if $signal;
	286	}
a687059c	287	}
fe14fcc3	288	$start = $i; # remember in case they want more
	289	$start = $max if $start > $max;
	290	next CMD; };
	291	$cmd =~ /^D$/ && do {
	292	print OUT "Deleting all breakpoints...\n";
	293	for ($i = 1; $i <= $max ; $i++) {
	294	if (defined $dbline{$i}) {
	295	$dbline{$i} =~ s/^[^\0]+//;
	296	if ($dbline{$i} =~ s/^\0?$//) {
	297	delete $dbline{$i};
	298	}
	299	}
	300	}
	301	next CMD; };
	302	$cmd =~ /^L$/ && do {
	303	for ($i = 1; $i <= $max; $i++) {
	304	if (defined $dbline{$i}) {
	305	print OUT "$i:\t", $dbline[$i];
	306	($stop,$action) = split(/\0/, $dbline{$i});
	307	print OUT " break if (", $stop, ")\n"
	308	if $stop;
	309	print OUT " action: ", $action, "\n"
	310	if $action;
	311	last if $signal;
	312	}
	313	}
	314	next CMD; };
	315	$cmd =~ /^b\b\s(['A-Za-z_]['\w])\s(.)/ && do {
	316	$subname = $1;
	317	$cond = $2 \|\| '1';
	318	$subname = "$package'" . $subname unless $subname =~ /'/;
	319	$subname = "main" . $subname if substr($subname,0,1) eq "'";
83025b21	320	($filename,$i) = split(/:/, $sub{$subname});
83025b21	321	$i += 0;
fe14fcc3	322	if ($i) {
	323	*dbline = "_<$filename";
	324	++$i while $dbline[$i] == 0 && $i < $#dbline;
	325	$dbline{$i} =~ s/^[^\0]*/$cond/;
	326	} else {
	327	print OUT "Subroutine $subname not found.\n";
76854fea	328	}
fe14fcc3	329	next CMD; };
	330	$cmd =~ /^b\b\s(\d)\s(.)/ && do {
	331	$i = ($1?$1:$line);
	332	$cond = $2 \|\| '1';
76854fea	333	if ($dbline[$i] == 0) {
fe14fcc3	334	print OUT "Line $i not breakable.\n";
	335	} else {
	336	$dbline{$i} =~ s/^[^\0]*/$cond/;
a687059c	337	}
fe14fcc3	338	next CMD; };
	339	$cmd =~ /^d\b\s*(\d+)?/ && do {
	340	$i = ($1?$1:$line);
	341	$dbline{$i} =~ s/^[^\0]*//;
	342	delete $dbline{$i} if $dbline{$i} eq '';
	343	next CMD; };
	344	$cmd =~ /^A$/ && do {
	345	for ($i = 1; $i <= $max ; $i++) {
	346	if (defined $dbline{$i}) {
	347	$dbline{$i} =~ s/\0[^\0]*//;
	348	delete $dbline{$i} if $dbline{$i} eq '';
76854fea	349	}
fe14fcc3	350	}
	351	next CMD; };
	352	$cmd =~ /^<\s(.)/ && do {
	353	$pre = do action($1);
	354	next CMD; };
	355	$cmd =~ /^>\s(.)/ && do {
	356	$post = do action($1);
	357	next CMD; };
	358	$cmd =~ /^a\b\s(\d+)(\s+(.))?/ && do {
	359	$i = $1;
	360	if ($dbline[$i] == 0) {
	361	print OUT "Line $i may not have an action.\n";
	362	} else {
	363	$dbline{$i} =~ s/\0[^\0]*//;
	364	$dbline{$i} .= "\0" . do action($3);
	365	}
	366	next CMD; };
	367	$cmd =~ /^n$/ && do {
	368	$single = 2;
	369	$laststep = $cmd;
	370	last CMD; };
	371	$cmd =~ /^s$/ && do {
	372	$single = 1;
	373	$laststep = $cmd;
	374	last CMD; };
	375	$cmd =~ /^c\b\s(\d)\s*$/ && do {
	376	$i = $1;
	377	if ($i) {
	378	if ($dbline[$i] == 0) {
	379	print OUT "Line $i not breakable.\n";
	380	next CMD;
76854fea	381	}
fe14fcc3	382	$dbline{$i} =~ s/(\0\|$)/;9$1/; # add one-time-only b.p.
76854fea	383	}
fe14fcc3	384	for ($i=0; $i <= $#stack; ) {
fe14fcc3	385	$stack[$i++] &= ~1;
a687059c	386	}
fe14fcc3	387	last CMD; };
	388	$cmd =~ /^r$/ && do {
	389	$stack[$#stack] \|= 2;
	390	last CMD; };
	391	$cmd =~ /^T$/ && do {
	392	local($p,$f,$l,$s,$h,$a,@a,@sub);
	393	for ($i = 1; ($p,$f,$l,$s,$h,$w) = caller($i); $i++) {
	394	@a = @args;
	395	for (@a) {
	396	if (/^StB\000/ && length($_) == length($_main{'_main'})) {
	397	$_ = sprintf("%s",$_);
	398	}
	399	else {
	400	s/'/\\'/g;
	401	s/([^\0]*)/'$1'/ unless /^-?[\d.]+$/;
	402	s/([\200-\377])/sprintf("M-%c",ord($1)&0177)/eg;
	403	s/([\0-\37\177])/sprintf("^%c",ord($1)^64)/eg;
	404	}
	405	}
	406	$w = $w ? '@ = ' : '$ = ';
	407	$a = $h ? '(' . join(', ', @a) . ')' : '';
	408	push(@sub, "$w&$s$a from file $f line $l\n");
	409	last if $signal;
a687059c	410	}
fe14fcc3	411	for ($i=0; $i <= $#sub; $i++) {
	412	last if $signal;
	413	print OUT $sub[$i];
a687059c	414	}
fe14fcc3	415	next CMD; };
	416	$cmd =~ /^\/(.*)$/ && do {
	417	$inpat = $1;
	418	$inpat =~ s:([^\\])/$:$1:;
	419	if ($inpat ne "") {
	420	eval '$inpat =~ m'."\n$inpat\n";
	421	if ($@ ne "") {
	422	print OUT "$@";
	423	next CMD;
	424	}
	425	$pat = $inpat;
a687059c	426	}
fe14fcc3	427	$end = $start;
	428	eval '
	429	for (;;) {
	430	++$start;
	431	$start = 1 if ($start > $max);
	432	last if ($start == $end);
	433	if ($dbline[$start] =~ m'."\n$pat\n".'i) {
f0fcb552	434	if ($emacs) {
	435	print OUT "\032\032$filename:$start:0\n";
	436	} else {
	437	print OUT "$start:\t", $dbline[$start], "\n";
	438	}
fe14fcc3	439	last;
	440	}
	441	} ';
	442	print OUT "/$pat/: not found\n" if ($start == $end);
	443	next CMD; };
	444	$cmd =~ /^\?(.*)$/ && do {
	445	$inpat = $1;
	446	$inpat =~ s:([^\\])\?$:$1:;
	447	if ($inpat ne "") {
	448	eval '$inpat =~ m'."\n$inpat\n";
	449	if ($@ ne "") {
	450	print OUT "$@";
	451	next CMD;
	452	}
	453	$pat = $inpat;
	454	}
	455	$end = $start;
	456	eval '
	457	for (;;) {
	458	--$start;
	459	$start = $max if ($start <= 0);
	460	last if ($start == $end);
	461	if ($dbline[$start] =~ m'."\n$pat\n".'i) {
f0fcb552	462	if ($emacs) {
	463	print OUT "\032\032$filename:$start:0\n";
	464	} else {
	465	print OUT "$start:\t", $dbline[$start], "\n";
	466	}
fe14fcc3	467	last;
	468	}
	469	} ';
	470	print OUT "?$pat?: not found\n" if ($start == $end);
	471	next CMD; };
	472	$cmd =~ /^!+\s*(-)?(\d+)?$/ && do {
	473	pop(@hist) if length($cmd) > 1;
	474	$i = ($1?($#hist-($2?$2:1)):($2?$2:$#hist));
	475	$cmd = $hist[$i] . "\n";
	476	print OUT $cmd;
	477	redo CMD; };
	478	$cmd =~ /^!(.+)$/ && do {
	479	$pat = "^$1";
	480	pop(@hist) if length($cmd) > 1;
	481	for ($i = $#hist; $i; --$i) {
	482	last if $hist[$i] =~ $pat;
	483	}
	484	if (!$i) {
	485	print OUT "No such command!\n\n";
	486	next CMD;
	487	}
	488	$cmd = $hist[$i] . "\n";
	489	print OUT $cmd;
	490	redo CMD; };
	491	$cmd =~ /^H\b\s*(-(\d+))?/ && do {
	492	$end = $2?($#hist-$2):0;
	493	$hist = 0 if $hist < 0;
	494	for ($i=$#hist; $i>$end; $i--) {
	495	print OUT "$i: ",$hist[$i],"\n"
	496	unless $hist[$i] =~ /^.?$/;
	497	};
	498	next CMD; };
	499	$cmd =~ s/^p( .*)?$/print DB'OUT$1/;
	500	$cmd =~ /^=/ && do {
	501	if (local($k,$v) = ($cmd =~ /^=\s(\S+)\s+(.)/)) {
	502	$alias{$k}="s~$k~$v~";
	503	print OUT "$k = $v\n";
	504	} elsif ($cmd =~ /^=\s*$/) {
	505	foreach $k (sort keys(%alias)) {
	506	if (($v = $alias{$k}) =~ s~^s\~$k\~(.*)\~$~$1~) {
	507	print OUT "$k = $v\n";
	508	} else {
	509	print OUT "$k\t$alias{$k}\n";
	510	};
33b78306	511	};
33b78306	512	};
fe14fcc3	513	next CMD; };
fe14fcc3	514	}
27e2fb84	515	$evalarg = $cmd; &eval;
76854fea	516	print OUT "\n";
a687059c	517	}
a687059c	518	if ($post) {
27e2fb84	519	$evalarg = $post; &eval;
a687059c	520	}
a687059c	521	}
76854fea	522	($@, $!, $[, $,, $/, $\) = @saved;
	523	}
	524
	525	sub save {
	526	@saved = ($@, $!, $[, $,, $/, $\);
	527	$[ = 0; $, = ""; $/ = "\n"; $\ = "";
	528	}
	529
27e2fb84	530	# The following takes its argument via $evalarg to preserve current @_
27e2fb84	531
76854fea	532	sub eval {
27e2fb84	533	eval "$usercontext $evalarg; &DB'save";
76854fea	534	print OUT $@;
a687059c	535	}
	536
	537	sub action {
	538	local($action) = @_;
	539	while ($action =~ s/\\$//) {
	540	print OUT "+ ";
76854fea	541	$action .= &gets;
a687059c	542	}
	543	$action;
	544	}
	545
76854fea	546	sub gets {
	547	local($.);
	548	<IN>;
	549	}
	550
a687059c	551	sub catch {
	552	$signal = 1;
	553	}
	554
	555	sub sub {
	556	push(@stack, $single);
	557	$single &= 1;
	558	$single \|= 4 if $#stack == $deep;
a687059c	559	if (wantarray) {
a687059c	560	@i = &$sub;
79a0689e	561	$single \|= pop(@stack);
79a0689e	562	@i;
a687059c	563	}
	564	else {
	565	$i = &$sub;
79a0689e	566	$single \|= pop(@stack);
79a0689e	567	$i;
a687059c	568	}
a687059c	569	}
	570
	571	$single = 1; # so it stops on first executable statement
a687059c	572	@hist = ('?');
	573	$SIG{'INT'} = "DB'catch";
	574	$deep = 100; # warning if stack gets this deep
	575	$window = 10;
	576	$preview = 3;
	577
	578	@stack = (0);
76854fea	579	@ARGS = @ARGV;
a687059c	580	for (@args) {
	581	s/'/\\'/g;
	582	s/(.*)/'$1'/ unless /^-?[\d.]+$/;
	583	}
a687059c	584
83025b21	585	if (-f $rcfile) {
83025b21	586	do "./$rcfile";
a687059c	587	}
83025b21	588	elsif (-f "$ENV{'LOGDIR'}/$rcfile") {
83025b21	589	do "$ENV{'LOGDIR'}/$rcfile";
a687059c	590	}
83025b21	591	elsif (-f "$ENV{'HOME'}/$rcfile") {
83025b21	592	do "$ENV{'HOME'}/$rcfile";
a687059c	593	}
	594
	595	1;