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