forked from freebsd/pkg
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathpkg-info.8
212 lines (212 loc) · 5.12 KB
/
pkg-info.8
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
.\"
.\" FreeBSD pkg - a next generation package for the installation and maintenance
.\" of non-core utilities.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\"
.\" @(#)pkg.8
.\"
.Dd December 1, 2014
.Dt PKG-INFO 8
.Os
.Sh NAME
.Nm "pkg info"
.Nd display information for packages
.Sh SYNOPSIS
.Nm
.Ar pkg-name
.Nm
.Fl a
.Nm
.Op Fl AbBDdefIklOpqRrs
.Op Fl Cgix
.Ar pkg-name
.Nm
.Op Fl AbBDdfIlpqRrs
.Fl F Ar pkg-file
.Pp
.Nm
.Ar pkg-name
.Nm
.Cm --all
.Nm
.Op Cm --{annotations,provided-shlibs,required-shlibs}
.Op Cm --{pkg-message,dependencies,exists,full,comment,locked}
.Op Cm --{list-files,by-origin,quiet,prefix,raw,required-by,size}
.Op Cm --{case-sensitive,glob,case-insensitive,regex}
.Ar pkg-name
.Nm
.Op Cm --{annotations,provided-shlibs,required-shlibs}
.Op Cm --{pkg-message,dependencies,full,comment,list-files}
.Op Cm --{quiet,prefix,raw,required-by,size}
.Cm --file Ar pkg-file
.Op Fl -raw-format Ar format
.Sh DESCRIPTION
.Nm
is used for displaying information for packages.
.Sh OPTIONS
The following options are supported by
.Nm :
.Bl -tag -width origin
.It Fl a , Cm --all
Display all installed packages.
.It Fl A , Cm --annotations
Display any annotations added to the package.
.It Fl C , Cm --case-sensitive
Make the standard or the regular expression
.Fl ( x )
matching against
.Ar pkg-name
case sensitive.
.It Fl f , Cm --full
Display full information about the packages matching
.Ar pkg-name .
This is the default.
.It Fl R , Cm --raw
Display the full manifest (raw) for the packages matching
.Ar pkg-name .
.It Fl -raw-format Ar format
Choose the format of the raw output.
The format can be:
json, json-compact, yaml (default).
.It Fl e , Cm --exists
If
.Ar pkg-name
is installed and registered in the database, return 0, otherwise return 1.
Useful for checking whether the package is installed.
.It Fl D , Cm --pkg-message
Show the pkg-message for matching packages.
.It Fl g , Cm --glob
Treat
.Ar pkg-name
as a shell glob pattern.
.It Fl i , Cm --case-insensitive
Make the standard or the regular expression
.Fl ( x )
matching against
.Ar pkg-name
case insensitive.
This is the default, unless modified by setting
.Ev CASE_SENSITIVE_MATCH
to true in
.Pa pkg.conf .
.It Fl I , Cm --comment
Display the specified packages and their comments.
.It Fl x , Cm --regex
Treat
.Ar pkg-name
as a regular expression according to the "modern" or "extended" syntax
of
.Xr re_format 7 .
.It Fl d , Cm --dependencies
Display the list of packages on which
.Ar pkg-name
depends.
.It Fl r , Cm --required-by
Display the list of packages which require
.Ar pkg-name .
.It Fl k , Cm --locked
Show the locking status for
.Ar pkg-name .
When used in combination with
.Fl d
or
.Fl r ,
indicate which packages, dependencies or requirements are locked
by '(*)'.
Locking status is only meaningful for installed packages; all locking
statuses will show as unlocked when information about a
.Ar pkg-file
is queried.
.It Fl l , Cm --list-files
Display all files installed by
.Ar pkg-name .
.It Fl b , Cm --provided-shlibs
Display all shared libraries provided by
.Ar pkg-name .
.It Fl B , Cm --required-shlibs
Display all shared libraries used by
.Ar pkg-name .
.It Fl s , Cm --size
Display the total size of files installed by
.Ar pkg-name .
.It Fl q , Cm --quiet
Be
.Dq quiet .
Prints only the requested information without displaying many hints.
.It Fl O , Cm --by-origin
Search is done by the
.Ar pkg-name
origin.
Added only for Ports compatibility.
.Pp
.It Fl E , Cm --show-name-only
Hides the full package output and only shows the package name.
This option is deprecated and exists only for Ports compatibility.
.It Fl o , Cm --origin
Display
.Ar pkg-name
origin.
.It Fl p , Cm --prefix
Display the installation prefix for each package matching
.Ar pkg-name .
.It Fl F Ar pkg-file , Cm --file Ar pkg-file
Displays information from the package archive
.Ar pkg-file .
.El
.Sh ENVIRONMENT
The following environment variables affect the execution of
.Nm .
See
.Xr pkg.conf 5
for further description.
.Bl -tag -width ".Ev NO_DESCRIPTIONS"
.It Ev PKG_DBDIR
.It Ev CASE_SENSITIVE_MATCH
.El
.Sh FILES
See
.Xr pkg.conf 5 .
.Sh SEE ALSO
.Xr pkg_printf 3 ,
.Xr pkg_repos 3 ,
.Xr pkg-repository 5 ,
.Xr pkg.conf 5 ,
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-alias 8 ,
.Xr pkg-annotate 8 ,
.Xr pkg-audit 8 ,
.Xr pkg-autoremove 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-check 8 ,
.Xr pkg-clean 8 ,
.Xr pkg-config 8 ,
.Xr pkg-create 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-fetch 8 ,
.Xr pkg-install 8 ,
.Xr pkg-lock 8 ,
.Xr pkg-query 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-rquery 8 ,
.Xr pkg-search 8 ,
.Xr pkg-set 8 ,
.Xr pkg-shell 8 ,
.Xr pkg-shlib 8 ,
.Xr pkg-ssh 8 ,
.Xr pkg-stats 8 ,
.Xr pkg-update 8 ,
.Xr pkg-updating 8 ,
.Xr pkg-upgrade 8 ,
.Xr pkg-version 8 ,
.Xr pkg-which 8