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 "17 June 2014" "1.0" "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
.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 SEE ALSO
apt-get(8)
.SH BUGS
No known bugs.
.SH AUTHOR
Frodo Looijaard (frodo@frodo.looijaard.name)
1	.\" Manpage for apt-installed-status.
2	.\" Contact frodo@frodo.looijaard.name to correct errors or typos.
3	.TH man 1 "17 June 2014" "1.0" "apt-installed-status man page"
4	.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	.SH OUTPUT FORMAT
62	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.
63	.SH SEE ALSO
64	apt-get(8)
65	.SH BUGS
66	No known bugs.
67	.SH AUTHOR
68	Frodo Looijaard (frodo@frodo.looijaard.name)
frodo@frodo.looijaard.name	ViewVC Help
Powered by ViewVC 1.1.26