| 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). |