apt-installed-status/trunk/apt-installed-status.1

.\" Manpage for apt-installed-status.
.\" Contact frodo@frodo.looijaard.name to correct errors or typos.
.TH man 1 "4 July 2014" "1.1" "apt-installed-status man page"
.SH NAME
apt-installed-status \- get the repository an installed package comes from
.SH SYNOPSIS
apt-installed-status [ \fIOPTION ...\fR ]
.SH DESCRIPTION
apt-installed-status determines for installed packages from which apt repository they come. 
.PP
If you use a lot of repositories, it is not always clear which package you installed from which repository. This tool helps you determine that. It can also show you which packages are not in any of your current apt repositories.
.PP
To determine which repository a package is from, the package name, its version and its architecture are examined.
.PP
This tool will only work properly if you have installed all pending updates (
.B apt-get dist-upgrade
should show no pending packages). 
.SH OPTIONS
Without options, a list of all installed packages is displayed with the archives they are found in.
.PP
\fB\-V\fR, \fB--version\fR
.RS 4
Show the current version and quit
.RE
.PP
\fB\-h\fR, \fB--help\fR
.RS 4
Show the help text and quit
.RE
.PP
\fB-o\fR
.RS 4
Show all orphans: those packages that are not found in any of the current apt archives. Note that matching will be done on package name, version number and architecture: if you have pending package updates waiting, packages may be designed as orphans because the exact version is not found anymore.
.RE
.PP
\fB-a\fR \fIARCHIVES\fR
.RS 4
Show all packages that are \fIonly\fR in these archives. Archives should be complete names (as shown by calling this tool without arguments) and should be separated by commas.
.RE
.PP
\fB-A\fR \fIPATTERN\fR
.RS 4
Show all packages that are \fIonly\fR in archives matching the perl regular expression specified.
.RE
.PP
\fB-x\fR \fIARCHIVES\fR
.RS 4
Show all packages that are \fInot found\fR in any of these archives. Archives should be complete names (as shown by calling this tool without arguments) and should be separated by commas.
.RE
.PP
\fB-X\fR \fIPATTERN\fR
.RS 4
Show all packages that are \fInot found\fR in any of the archives matching the perl regular expression specified.
.RE
.PP
.B -l
.RS 4
Used with the \fB-a\fR, \fB-A\fR, \fB-x\fR or \fB\-X\fR arguments: display the archives in which this package is found too.
.RE
.PP
.B -L
.RS 4
Used without other arguments or with the \fB-a\fR, \fB-A\fR, \fB-x\fR or \fB\-X\fR arguments: display the (selected) archives, instead of packages.
.RE
.SH OUTPUT FORMAT
Depending on the options chosen, output will be three or four tab-separated fields. The first column is the package name, the second column the architecture, the third column the version number and the optional fourth column a list of apt archives this package was found in, separated by commas.
.SH EXAMPLES
.PP
\fBapt-installed-status\fR
.RS 4
List all installed packages and the archives the package is found in.
.RE
.PP
\fBapt-installed-status \-o\fR
.RS 4
List all installed packages which are not found in any archive, or whose current version is not found.
.RE
.PP
\fBapt-installed-status \-X wheezy\fR
.RS 4
List all packages whose current installed version is not found in Wheezy.
.RE
.PP
\fBapt-installed-status \-l \-A non-free\fR
.RS 4
List all packages which are non-free, including the repository they are installed from.
.RE
.PP
\fBapt-installed-status \-L \-A non-free\fR
.RS 4
Do not list the packages which are non-free, but the repositories that are selected (contain the string \fBnon-free\fR).
.RE
.SH SEE ALSO
apt-get(8)
.SH BUGS
No known bugs.
.SH AUTHOR
Frodo Looijaard (frodo@frodo.looijaard.name)
1	frodo	333	.\" Manpage for apt-installed-status.
2			.\" Contact frodo@frodo.looijaard.name to correct errors or typos.
3	frodo	337	.TH man 1 "4 July 2014" "1.1" "apt-installed-status man page"
4	frodo	333	.SH NAME
5			apt-installed-status \- get the repository an installed package comes from
6			.SH SYNOPSIS
7			apt-installed-status [ \fIOPTION ...\fR ]
8			.SH DESCRIPTION
9			apt-installed-status determines for installed packages from which apt repository they come.
10			.PP
11			If you use a lot of repositories, it is not always clear which package you installed from which repository. This tool helps you determine that. It can also show you which packages are not in any of your current apt repositories.
12			.PP
13			To determine which repository a package is from, the package name, its version and its architecture are examined.
14			.PP
15			This tool will only work properly if you have installed all pending updates (
16			.B apt-get dist-upgrade
17			should show no pending packages).
18			.SH OPTIONS
19			Without options, a list of all installed packages is displayed with the archives they are found in.
20			.PP
21			\fB\-V\fR, \fB--version\fR
22			.RS 4
23			Show the current version and quit
24			.RE
25			.PP
26			\fB\-h\fR, \fB--help\fR
27			.RS 4
28			Show the help text and quit
29			.RE
30			.PP
31			\fB-o\fR
32			.RS 4
33			Show all orphans: those packages that are not found in any of the current apt archives. Note that matching will be done on package name, version number and architecture: if you have pending package updates waiting, packages may be designed as orphans because the exact version is not found anymore.
34			.RE
35			.PP
36			\fB-a\fR \fIARCHIVES\fR
37			.RS 4
38			Show all packages that are \fIonly\fR in these archives. Archives should be complete names (as shown by calling this tool without arguments) and should be separated by commas.
39			.RE
40			.PP
41			\fB-A\fR \fIPATTERN\fR
42			.RS 4
43			Show all packages that are \fIonly\fR in archives matching the perl regular expression specified.
44			.RE
45			.PP
46			\fB-x\fR \fIARCHIVES\fR
47			.RS 4
48			Show all packages that are \fInot found\fR in any of these archives. Archives should be complete names (as shown by calling this tool without arguments) and should be separated by commas.
49			.RE
50			.PP
51			\fB-X\fR \fIPATTERN\fR
52			.RS 4
53			Show all packages that are \fInot found\fR in any of the archives matching the perl regular expression specified.
54			.RE
55			.PP
56			.B -l
57			.RS 4
58			Used with the \fB-a\fR, \fB-A\fR, \fB-x\fR or \fB\-X\fR arguments: display the archives in which this package is found too.
59			.RE
60			.PP
61	frodo	337	.B -L
62			.RS 4
63			Used without other arguments or with the \fB-a\fR, \fB-A\fR, \fB-x\fR or \fB\-X\fR arguments: display the (selected) archives, instead of packages.
64			.RE
65	frodo	333	.SH OUTPUT FORMAT
66			Depending on the options chosen, output will be three or four tab-separated fields. The first column is the package name, the second column the architecture, the third column the version number and the optional fourth column a list of apt archives this package was found in, separated by commas.
67	frodo	334	.SH EXAMPLES
68			.PP
69			\fBapt-installed-status\fR
70			.RS 4
71			List all installed packages and the archives the package is found in.
72			.RE
73			.PP
74			\fBapt-installed-status \-o\fR
75			.RS 4
76			List all installed packages which are not found in any archive, or whose current version is not found.
77			.RE
78			.PP
79			\fBapt-installed-status \-X wheezy\fR
80			.RS 4
81			List all packages whose current installed version is not found in Wheezy.
82			.RE
83			.PP
84			\fBapt-installed-status \-l \-A non-free\fR
85			.RS 4
86			List all packages which are non-free, including the repository they are installed from.
87			.RE
88	frodo	337	.PP
89			\fBapt-installed-status \-L \-A non-free\fR
90			.RS 4
91			Do not list the packages which are non-free, but the repositories that are selected (contain the string \fBnon-free\fR).
92			.RE
93	frodo	333	.SH SEE ALSO
94			apt-get(8)
95			.SH BUGS
96			No known bugs.
97			.SH AUTHOR
98			Frodo Looijaard (frodo@frodo.looijaard.name)
frodo@frodo.looijaard.name	ViewVC Help
Powered by ViewVC 1.1.26