pkg_info.1 (174475) | pkg_info.1 (179433) |
---|---|
1.\" 2.\" FreeBSD install - a package for the installation and maintenance 3.\" of non-core utilities. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" Jordan K. Hubbard 15.\" 16.\" 17.\" @(#)pkg_info.1 | 1.\" 2.\" FreeBSD install - a package for the installation and maintenance 3.\" of non-core utilities. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" Jordan K. Hubbard 15.\" 16.\" 17.\" @(#)pkg_info.1 |
18.\" $FreeBSD: head/usr.sbin/pkg_install/info/pkg_info.1 174475 2007-12-09 11:01:58Z krion $ | 18.\" $FreeBSD: head/usr.sbin/pkg_install/info/pkg_info.1 179433 2008-05-30 14:26:09Z flz $ |
19.\" | 19.\" |
20.Dd January 9, 2006 | 20.Dd May 30, 2008 |
21.Dt PKG_INFO 1 22.Os 23.Sh NAME 24.Nm pkg_info 25.Nd a utility for displaying information on software packages 26.Sh SYNOPSIS 27.Nm | 21.Dt PKG_INFO 1 22.Os 23.Sh NAME 24.Nm pkg_info 25.Nd a utility for displaying information on software packages 26.Sh SYNOPSIS 27.Nm |
28.Op Fl bcdDEfgGiIjkKLmopPqQrRsvVxX | 28.Op Fl bcdDEfghGiIjkKLmopPqQrRsvVxX |
29.Op Fl e Ar package 30.Op Fl l Ar prefix 31.Op Fl t Ar template 32.Fl a | Ar pkg-name ... 33.Nm 34.Op Fl qQ 35.Fl W Ar filename 36.Nm --- 25 unchanged lines hidden (view full) --- 62operators. 63For example, 64.Pp 65.Dl "pkg_info 'portupgrade>=20030723'" 66.Pp 67will match versions 20030723 and later of the 68.Pa portupgrade 69package. | 29.Op Fl e Ar package 30.Op Fl l Ar prefix 31.Op Fl t Ar template 32.Fl a | Ar pkg-name ... 33.Nm 34.Op Fl qQ 35.Fl W Ar filename 36.Nm --- 25 unchanged lines hidden (view full) --- 62operators. 63For example, 64.Pp 65.Dl "pkg_info 'portupgrade>=20030723'" 66.Pp 67will match versions 20030723 and later of the 68.Pa portupgrade 69package. |
70.It Fl a | 70.It Fl a , -all |
71Show all currently installed packages. | 71Show all currently installed packages. |
72.It Fl b | 72.It Fl b , -blocksize |
73Use the 74.Ev BLOCKSIZE 75environment variable for output even when the 76.Fl q 77or 78.Fl Q 79flag is present. | 73Use the 74.Ev BLOCKSIZE 75environment variable for output even when the 76.Fl q 77or 78.Fl Q 79flag is present. |
80.It Fl v | 80.It Fl h , -help 81Print help message. 82.It Fl v , -verbose |
81Turn on verbose output. 82.It Fl p 83Show the installation prefix for each package. | 83Turn on verbose output. 84.It Fl p 85Show the installation prefix for each package. |
84.It Fl q | 86.It Fl q , -quiet |
85Be 86.Dq quiet 87in emitting report headers and such, just dump the 88raw info (basically, assume a non-human reading). 89.It Fl Q 90Be 91.Dq quiet 92as above but print preface output with the package name. --- 12 unchanged lines hidden (view full) --- 105.It Fl I 106Show an index line for each package. 107This option takes 108precedence over all other package formatting options. 109.It Fl j 110Show the requirements script (if any) for each package. 111.It Fl k 112Show the de-install script (if any) for each package. | 87Be 88.Dq quiet 89in emitting report headers and such, just dump the 90raw info (basically, assume a non-human reading). 91.It Fl Q 92Be 93.Dq quiet 94as above but print preface output with the package name. --- 12 unchanged lines hidden (view full) --- 107.It Fl I 108Show an index line for each package. 109This option takes 110precedence over all other package formatting options. 111.It Fl j 112Show the requirements script (if any) for each package. 113.It Fl k 114Show the de-install script (if any) for each package. |
113.It Fl K | 115.It Fl K , -keep |
114Keep any downloaded package in 115.Ev PKGDIR 116if it is defined or in current directory by default. 117.It Fl r 118For each of the specified packages, 119show the list of packages on which it depends. 120.It Fl R 121For each of the specified packages, --- 12 unchanged lines hidden (view full) --- 134.It Fl o 135Show the 136.Dq origin 137path recorded on package generation. 138This path is the directory name in the 139.Fx 140.Em "Ports Collection" 141of the underlying port from which the package was generated. | 116Keep any downloaded package in 117.Ev PKGDIR 118if it is defined or in current directory by default. 119.It Fl r 120For each of the specified packages, 121show the list of packages on which it depends. 122.It Fl R 123For each of the specified packages, --- 12 unchanged lines hidden (view full) --- 136.It Fl o 137Show the 138.Dq origin 139path recorded on package generation. 140This path is the directory name in the 141.Fx 142.Em "Ports Collection" 143of the underlying port from which the package was generated. |
142.It Fl G | 144.It Fl G , -no-glob |
143Do not try to expand shell glob patterns in the 144.Ar pkg-name 145when selecting packages to be displayed (by default 146.Nm 147automatically expands shell glob patterns in the 148.Ar pkg-name ) . | 145Do not try to expand shell glob patterns in the 146.Ar pkg-name 147when selecting packages to be displayed (by default 148.Nm 149automatically expands shell glob patterns in the 150.Ar pkg-name ) . |
149.It Fl W Ar filename | 151.It Fl W , -which Ar filename |
150For the specified 151.Ar filename 152argument show which package it belongs to. 153If the file is not in the 154current directory, and does not have an absolute path, then the 155directories specified in the environment variable 156.Ev PATH 157are searched using 158.Xr which 1 . | 152For the specified 153.Ar filename 154argument show which package it belongs to. 155If the file is not in the 156current directory, and does not have an absolute path, then the 157directories specified in the environment variable 158.Ev PATH 159are searched using 160.Xr which 1 . |
159.It Fl O Ar origin | 161.It Fl O , -origin Ar origin |
160List all packages having the specified 161.Ar origin . | 162List all packages having the specified 163.Ar origin . |
162.It Fl x | 164.It Fl x , -regex |
163Treat the 164.Ar pkg-name 165as a regular expression and display information only for packages 166whose names match that regular expression. 167Multiple regular 168expressions could be provided, in that case 169.Nm 170displays information about all packages that match at least one 171regular expression from the list. | 165Treat the 166.Ar pkg-name 167as a regular expression and display information only for packages 168whose names match that regular expression. 169Multiple regular 170expressions could be provided, in that case 171.Nm 172displays information about all packages that match at least one 173regular expression from the list. |
172.It Fl X | 174.It Fl X , -extended |
173Like 174.Fl x , 175but treats the 176.Ar pkg-name 177as an extended regular expression. | 175Like 176.Fl x , 177but treats the 178.Ar pkg-name 179as an extended regular expression. |
178.It Fl e Ar package | 180.It Fl e , -exists Ar package |
179If the package identified by 180.Ar package 181is currently installed, return 0, otherwise return 1. 182This option 183allows you to easily test for the presence of another (perhaps 184prerequisite) package from a script. 185.It Fl E 186Show only matching package names. --- 6 unchanged lines hidden (view full) --- 193shown with 194.Ar prefix . 195This is primarily of use to front-end programs that want to request a 196lot of different information fields at once for a package, but do not 197necessarily want the output intermingled in such a way that they cannot 198organize it. 199This lets you add a special token to the start of 200each field. | 181If the package identified by 182.Ar package 183is currently installed, return 0, otherwise return 1. 184This option 185allows you to easily test for the presence of another (perhaps 186prerequisite) package from a script. 187.It Fl E 188Show only matching package names. --- 6 unchanged lines hidden (view full) --- 195shown with 196.Ar prefix . 197This is primarily of use to front-end programs that want to request a 198lot of different information fields at once for a package, but do not 199necessarily want the output intermingled in such a way that they cannot 200organize it. 201This lets you add a special token to the start of 202each field. |
201.It Fl t Ar template | 203.It Fl t , -template Ar template |
202Use 203.Ar template 204as the argument to 205.Xr mktemp 3 206when creating a 207.Dq staging area . 208By default, this is the string 209.Pa /tmp/instmp.XXXXXX , --- 11 unchanged lines hidden (view full) --- 221.Nm , 222since very little information is extracted from each package 223and one would have to have a very small 224.Pa /tmp 225indeed to overflow it. 226.Ed 227.It Fl V 228Show revision number of the packing list format. | 204Use 205.Ar template 206as the argument to 207.Xr mktemp 3 208when creating a 209.Dq staging area . 210By default, this is the string 211.Pa /tmp/instmp.XXXXXX , --- 11 unchanged lines hidden (view full) --- 223.Nm , 224since very little information is extracted from each package 225and one would have to have a very small 226.Pa /tmp 227indeed to overflow it. 228.Ed 229.It Fl V 230Show revision number of the packing list format. |
229.It Fl P | 231.It Fl P , -version |
230Show revision number of package tools. 231.El 232.Sh TECHNICAL DETAILS 233Package info is either extracted from package files named on the 234command line, or from already installed package information 235in 236.Pa /var/db/pkg/ Ns Aq Ar pkg-name . 237.Sh ENVIRONMENT --- 55 unchanged lines hidden --- | 232Show revision number of package tools. 233.El 234.Sh TECHNICAL DETAILS 235Package info is either extracted from package files named on the 236command line, or from already installed package information 237in 238.Pa /var/db/pkg/ Ns Aq Ar pkg-name . 239.Sh ENVIRONMENT --- 55 unchanged lines hidden --- |