Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perlmod / DiagList / 1.11 / bin / dlist
CommitLineData
86530b38
AT
1
2eval 'exec $DV_ROOT/tools/perl-5.8.7/bin/perl -S $0 ${1+"$@"}'
3 if 0; # not running under some shell
4
5use strict;
6use warnings;
7
8use Getopt::Long;
9use Pod::Usage;
10use File::Spec;
11use File::Basename;
12use File::Find;
13
14use lib '.';
15use DiagList ':script';
16
17
18dlist(@ARGV);
19
20exit(0);
21
22
23__END__
24
25=head1 NAME
26
27dlist - tool for locating diags
28
29=head1 SYNOPSIS
30
31 dlist [options] [<diag_name>]
32
33=head1 DESCRIPTION
34
35This script queries the specified diag list and prints information.
36If a diag name is specified, then the results are displayed only for
37that particular diag. It first runs the diag list through cpp, unless
38the -nocpp option is given. The E<lt>diag_nameE<gt> can either be a
39diag alias or the E<lt>aliasE<gt>:E<lt>nametagE<gt> syntax. If a diag
40name is not given, and no -group is given, then a list of all groups
41is displayed.
42
43=head2 Options
44
45The following options are recognized:
46
47=over 4
48
49=item -h
50
51Display man page.
52
53=item -q
54
55Quiet. Do not print much.
56
57=item -find
58
59Find a full path for files. Uses diag_root (default is
60$DV_ROOT/verif/diag) as search root. Implies -q.
61
62=item -group E<lt>groupE<gt>
63
64Filter results to only display the specified group.
65
66=item -buildtag [E<lt>buildtagE<gt>]
67
68If a E<lt>buildtagE<gt> is specified, print the build arguments for
69the tag and exit. If -buildtag is given with no argument, then the
70build arguments for all buildtags are printed, and then the program exits.
71
72=item -nocpp
73
74Do not preprocess the diaglist
75
76=item -cpp E<lt>cmdnameE<gt>
77
78Use E<lt>cmdnameE<gt> as the preprocessor. Default = bw_cpp.
79
80=item -cpp_args E<lt>argsE<gt>
81
82Use E<lt>argsE<gt> as arguments to the preprocessor. Default = "-undef -B".
83
84=item -nostdinc
85
86Do not use standard include path with preprocessor. The standard
87include path is the directory containing the diaglist.
88
89=item -IE<lt>pathE<gt> -DE<lt>defineE<gt>
90
91Pass these arguments to the preprocessor.
92
93=item -diag_root E<lt>diag_rootE<gt>
94
95Default diaglist (if -diaglist is not specified) is
96E<lt>diag_rootE<gt>/master_diaglist. Default is $DV_ROOT/verif/diag.
97
98=item -diaglist E<lt>diaglistE<gt>
99
100Use this as the diaglist. Deafult is
101E<lt>diag_rootE<gt>/master_diaglist where
102E<lt>diag_rootE<gt> defaults to $DV_ROOT/verif/diag.
103
104=back
105
106=head1 SEE ALSO
107
108DiagList(3).