[p5sagit/p5-mst-13.2.git] / lib / perl5db.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: perl5db.pl,v $$Revision: 4.1 $$Date: 92/08/07 18:24:07 $';
#
# 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 &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 $

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

#require Term::ReadLine;

local($^W) = 0;

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

# Around a bug:
if (defined $ENV{'OS2_SHELL'}) { # In OS/2
  if ($DB::emacs) {
    $console = undef;
  } else {
    $console = "/dev/con";
  }
}

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

$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";

@ARGS;

sub DB {
    &save;
    ($pkg, $filename, $line) = caller;
    $usercontext = '($@, $!, $,, $/, $\, $^W) = @saved;' .
	"package $pkg;";		# this won't let them modify, alas
    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 {
	    $prefix = $sub =~ /'|::/ ? "" : "${pkg}::";
	    $prefix .= "$sub($filename:";
	    if (length($prefix) > 30) {
		print OUT "$prefix$line):\n$line:\t",$dbline[$line];
		$prefix = "";
		$infix = ":\t";
	    }
	    else {
		$infix = "):\t";
		print OUT "$prefix$line$infix",$dbline[$line];
	    }
	    for ($i = $line + 1; $i <= $max && $dbline[$i] == 0; ++$i) {
		last if $dbline[$i] =~ /^\s*(}|#|\n)/;
		print OUT "$prefix$i$infix",$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 $pkg/;
		$cmd =~ /^V$/ && do {
		    $cmd = "V $pkg"; };
		$cmd =~ /^V\b\s*(\S+)\s*(.*)/ && do {
		    local ($savout) = select(OUT);
		    $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";
		    }
		    select ($savout);
		    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 "'";
		    $subname = "main" . $subname if substr($subname,0,2)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 = "${pkg}::" . $subname
			unless $subname =~ /'|::/;
		    $subname = "main" . $subname if substr($subname,0,1) eq "'";
		    $subname = "main" . $subname if substr($subname,0,2) 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 = action($1);
		    next CMD; };
		$cmd =~ /^>\s*(.*)/ && do {
		    $post = 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" . 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 = ();
			for $arg (@args) {
			    $_ = "$arg";
			    s/'/\\'/g;
			    s/([^\0]*)/'$1'/
				unless /^(?: -?[\d.]+ | \*[\w:]* )$/x;
			    s/([\200-\377])/sprintf("M-%c",ord($1)&0177)/eg;
			    s/([\0-\37\177])/sprintf("^%c",ord($1)^64)/eg;
			    push(@a, $_);
			}
			$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'."\a$inpat\a";	
			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'."\a$pat\a".'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'."\a$inpat\a";	
			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'."\a$pat\a".'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;
	}
    }
    ($@, $!, $,, $/, $\, $^W) = @saved;
    ();
}

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

# 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;
    }
}

$trace = $signal = $single = 0;	# uninitialized warning suppression

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