gpt-query(8)

1GPT-QUERY(8)          User Contributed Perl Documentation         GPT-QUERY(8)
2
3
4

NAME

6       gpt-query - Queries an installation for packages
7

SYNOPSIS

9       gpt-query [-name=Name -flavor=Flavor -pkgtype=Type --help -file=name
10       -man -deps=run|sdk] [pkgname-flavor-pkgtype+]
11

DESCRIPTION

13       gpt-query searches installed packages for matches to the query.  Name
14       is the name of the package. Flavor is the information about linking and
15       compile options used on package.  Type is the type of the package. ?
16       will alow the use to access system help.
17
18       The user may enter a value for any of the options.  These options can
19       be used in combination or not at all.  The script will take the options
20       being used and try to find all matching items.
21
22       An alternate form is to use the pkgname-flavor-pkgtype tuples.
23       Multiple of instances of these tuples can be used in a query.
24

OPTIONS

26       -name=NAME
27            Returns all of the packages matching NAME.
28
29       -flavor=FLAVOR
30           Returns all of the packages matching FLAVOR.
31
32       -pkgtype=TYPE
33           Returns all of the packages matching TYPE.
34
35       -file=FILE
36           Returns the package owning the FILE.  FILE needs to be either an
37           absolute path or referenced to $GLOBUS_LOCATION.
38
39       -deps=run|sdk
40           Returns the runtime or build dependencies of a package.
41
42       -help
43           Print a brief help message and exits.
44
45       -man
46           Prints the manual page and exits.
47
48       -version
49           Prints the version of GPT and exits.
50
51       -what-bundles
52           Prints a list of the installed bundles.
53
54       -verify-bundle=BUNDLE
55           Takes a bundle defintion and checks to see if it matches the
56           installation.
57
58       -bundle-packages=BUNDLE
59           List the packages that belong to the desired bundle.
60
61       -bundle BUNDLE 1 [BUNDLE 2]
62           If two bundles are given, the bundles will be compared to one
63           another for equality.  If only one bundle is given, the bundle will
64           be checked against the installation.  This command works on tar
65           bundles.
66

EXAMPLES

68         gpt-query
69
70       Returns a listing of all of the installed packages.
71
72         gpt-query -name=foo
73
74       Returns all flavors and package types with the name "foo".
75
76        gpt-query foo
77
78       Also returns all flavors and package types with the name "foo".
79
80         gpt-query 'foo-*-*'
81
82       A third way of typing the same query.  Note the single quotes.
83
84         gpt-query '*-noflavor-*'
85
86       List all of the packages with a 'noflavor' build flavor.
87
88         gpt-query -file=libexec/globus-build-env-gcc32.sh
89
90       Returns "/libexec/globus-build-env-gcc32.sh is owned by
91       globus_core-gcc32-rtl"
92
93         gpt-query -file=$GLOBUS_LOCATION/libexec/globus-build-env-gcc32.sh
94
95       Returns the same.
96
97         gpt-query -file=globus-build-env-gcc32.sh
98
99       Returns an error because the path is incorrect.
100

OUTPUT

102       Here is an example output:
103
104          gpt-query '*-noflavor-*'
105
106        4 packages were found in /home/mbletzin/work/install that matched your query:
107
108        packages found that matched your query
109               globus_core-noflavor-data ver: 2.1 cmp id: 2.1.0
110               globus_core_setup-noflavor-pgm ver: 2.0 cmp id: 2.0.0
111               globus_ssl_utils-noflavor-data ver: 2.1 cmp id: 2.1.0
112               kca_setup-noflavor-pgm ver: 3.0.2p1 cmp id: 1.0.0
113
114       For each package name, flavor, package type, version, and the
115       compatibility identifier is return.  The compatibility identifier is
116       what is used to resolve dependencies.
117

AUTHOR

122       Michael Bletzinger <mbletzin.ncsa.uiuc.edu> and Eric Blau
123       <eblau.ncsa.uiuc.edu>
124
125
126
127perl v5.12.3                      2011-03-24                      GPT-QUERY(8)