]>
git.saurik.com Git - apt.git/blob - cmdline/apt-cache.cc
1 // -*- mode: cpp; mode: fold -*-
3 // $Id: apt-cache.cc,v 1.34 1999/04/19 02:35:38 jgg Exp $
4 /* ######################################################################
6 apt-cache - Manages the cache files
8 apt-cache provides some functions fo manipulating the cache files.
9 It uses the command line interface common to all the APT tools. The
10 only really usefull function right now is dumpavail which is used
11 by the dselect method. Everything else is ment as a debug aide.
13 Returns 100 on failure, 0 on success.
15 ##################################################################### */
17 // Include Files /*{{{*/
18 #include <apt-pkg/error.h>
19 #include <apt-pkg/pkgcachegen.h>
20 #include <apt-pkg/deblistparser.h>
21 #include <apt-pkg/init.h>
22 #include <apt-pkg/progress.h>
23 #include <apt-pkg/sourcelist.h>
24 #include <apt-pkg/cmndline.h>
25 #include <apt-pkg/strutl.h>
26 #include <apt-pkg/pkgrecords.h>
37 // UnMet - Show unmet dependencies /*{{{*/
38 // ---------------------------------------------------------------------
40 bool UnMet(CommandLine
&CmdL
)
42 pkgCache
&Cache
= *GCache
;
43 bool Important
= _config
->FindB("APT::Cache::Important",false);
45 for (pkgCache::PkgIterator P
= Cache
.PkgBegin(); P
.end() == false; P
++)
47 for (pkgCache::VerIterator V
= P
.VersionList(); V
.end() == false; V
++)
50 for (pkgCache::DepIterator D
= V
.DependsList(); D
.end() == false;)
53 pkgCache::DepIterator Start
;
54 pkgCache::DepIterator End
;
57 /* cout << "s: Check " << Start.TargetPkg().Name() << ',' <<
58 End.TargetPkg().Name() << endl;*/
60 // Skip conflicts and replaces
61 if (End
->Type
!= pkgCache::Dep::PreDepends
&&
62 End
->Type
!= pkgCache::Dep::Depends
&&
63 End
->Type
!= pkgCache::Dep::Suggests
&&
64 End
->Type
!= pkgCache::Dep::Recommends
)
67 // Important deps only
68 if (Important
== true)
69 if (End
->Type
!= pkgCache::Dep::PreDepends
&&
70 End
->Type
!= pkgCache::Dep::Depends
)
73 // Verify the or group
75 pkgCache::DepIterator RealStart
= Start
;
78 // See if this dep is Ok
79 pkgCache::Version
**VList
= Start
.AllTargets();
100 cout
<< "Package " << P
.Name() << " version " <<
101 V
.VerStr() << " has an unmet dep:" << endl
;
104 // Print out the dep type
105 cout
<< " " << End
.DepType() << ": ";
111 cout
<< Start
.TargetPkg().Name();
112 if (Start
.TargetVer() != 0)
113 cout
<< " (" << Start
.CompType() << " " << Start
.TargetVer() <<
129 // DumpPackage - Show a dump of a package record /*{{{*/
130 // ---------------------------------------------------------------------
132 bool DumpPackage(CommandLine
&CmdL
)
134 pkgCache
&Cache
= *GCache
;
135 for (const char **I
= CmdL
.FileList
+ 1; *I
!= 0; I
++)
137 pkgCache::PkgIterator Pkg
= Cache
.FindPkg(*I
);
138 if (Pkg
.end() == true)
140 _error
->Warning("Unable to locate package %s",*I
);
144 cout
<< "Package: " << Pkg
.Name() << endl
;
145 cout
<< "Versions: ";
146 for (pkgCache::VerIterator Cur
= Pkg
.VersionList(); Cur
.end() != true; Cur
++)
148 cout
<< Cur
.VerStr();
149 for (pkgCache::VerFileIterator Vf
= Cur
.FileList(); Vf
.end() == false; Vf
++)
150 cout
<< "(" << Vf
.File().FileName() << ")";
156 cout
<< "Reverse Depends: " << endl
;
157 for (pkgCache::DepIterator D
= Pkg
.RevDependsList(); D
.end() != true; D
++)
158 cout
<< " " << D
.ParentPkg().Name() << ',' << D
.TargetPkg().Name() << endl
;
160 cout
<< "Dependencies: " << endl
;
161 for (pkgCache::VerIterator Cur
= Pkg
.VersionList(); Cur
.end() != true; Cur
++)
163 cout
<< Cur
.VerStr() << " - ";
164 for (pkgCache::DepIterator Dep
= Cur
.DependsList(); Dep
.end() != true; Dep
++)
165 cout
<< Dep
.TargetPkg().Name() << " (" << (int)Dep
->CompareOp
<< " " << Dep
.TargetVer() << ") ";
169 cout
<< "Provides: " << endl
;
170 for (pkgCache::VerIterator Cur
= Pkg
.VersionList(); Cur
.end() != true; Cur
++)
172 cout
<< Cur
.VerStr() << " - ";
173 for (pkgCache::PrvIterator Prv
= Cur
.ProvidesList(); Prv
.end() != true; Prv
++)
174 cout
<< Prv
.ParentPkg().Name() << " ";
177 cout
<< "Reverse Provides: " << endl
;
178 for (pkgCache::PrvIterator Prv
= Pkg
.ProvidesList(); Prv
.end() != true; Prv
++)
179 cout
<< Prv
.OwnerPkg().Name() << " " << Prv
.OwnerVer().VerStr();
187 // Stats - Dump some nice statistics /*{{{*/
188 // ---------------------------------------------------------------------
190 bool Stats(CommandLine
&Cmd
)
192 pkgCache
&Cache
= *GCache
;
193 cout
<< "Total Package Names : " << Cache
.Head().PackageCount
<< " (" <<
194 SizeToStr(Cache
.Head().PackageCount
*Cache
.Head().PackageSz
) << ')' << endl
;
195 pkgCache::PkgIterator I
= Cache
.PkgBegin();
202 for (;I
.end() != true; I
++)
204 if (I
->VersionList
!= 0 && I
->ProvidesList
== 0)
210 if (I
->VersionList
!= 0 && I
->ProvidesList
!= 0)
216 if (I
->VersionList
== 0 && I
->ProvidesList
!= 0)
219 if (I
.ProvidesList()->NextProvides
== 0)
227 if (I
->VersionList
== 0 && I
->ProvidesList
== 0)
233 cout
<< " Normal Packages: " << Normal
<< endl
;
234 cout
<< " Pure Virtual Packages: " << Virtual
<< endl
;
235 cout
<< " Single Virtual Packages: " << DVirt
<< endl
;
236 cout
<< " Mixed Virtual Packages: " << NVirt
<< endl
;
237 cout
<< " Missing: " << Missing
<< endl
;
239 cout
<< "Total Distinct Versions: " << Cache
.Head().VersionCount
<< " (" <<
240 SizeToStr(Cache
.Head().VersionCount
*Cache
.Head().VersionSz
) << ')' << endl
;
241 cout
<< "Total Dependencies: " << Cache
.Head().DependsCount
<< " (" <<
242 SizeToStr(Cache
.Head().DependsCount
*Cache
.Head().DependencySz
) << ')' << endl
;
244 cout
<< "Total Ver/File relations: " << Cache
.Head().VerFileCount
<< " (" <<
245 SizeToStr(Cache
.Head().VerFileCount
*Cache
.Head().VerFileSz
) << ')' << endl
;
246 cout
<< "Total Provides Mappings: " << Cache
.Head().ProvidesCount
<< " (" <<
247 SizeToStr(Cache
.Head().ProvidesCount
*Cache
.Head().ProvidesSz
) << ')' << endl
;
250 unsigned long Size
= 0;
251 unsigned long Count
= 0;
252 for (pkgCache::StringItem
*I
= Cache
.StringItemP
+ Cache
.Head().StringList
;
253 I
!= Cache
.StringItemP
; I
= Cache
.StringItemP
+ I
->NextItem
)
256 Size
+= strlen(Cache
.StrP
+ I
->String
);
258 cout
<< "Total Globbed Strings: " << Count
<< " (" << SizeToStr(Size
) << ')' << endl
;
260 unsigned long Slack
= 0;
261 for (int I
= 0; I
!= 7; I
++)
262 Slack
+= Cache
.Head().Pools
[I
].ItemSize
*Cache
.Head().Pools
[I
].Count
;
263 cout
<< "Total Slack space: " << SizeToStr(Slack
) << endl
;
265 unsigned long Total
= 0;
266 Total
= Slack
+ Size
+ Cache
.Head().DependsCount
*Cache
.Head().DependencySz
+
267 Cache
.Head().VersionCount
*Cache
.Head().VersionSz
+
268 Cache
.Head().PackageCount
*Cache
.Head().PackageSz
+
269 Cache
.Head().VerFileCount
*Cache
.Head().VerFileSz
+
270 Cache
.Head().ProvidesCount
*Cache
.Head().ProvidesSz
;
271 cout
<< "Total Space Accounted for: " << SizeToStr(Total
) << endl
;
276 // Check - Check some things about the cache /*{{{*/
277 // ---------------------------------------------------------------------
278 /* Debug aide mostly */
279 bool Check(CommandLine
&Cmd
)
281 pkgCache
&Cache
= *GCache
;
282 pkgCache::PkgIterator Pkg
= Cache
.PkgBegin();
283 for (;Pkg
.end() != true; Pkg
++)
285 if (Pkg
.Section() == 0 && Pkg
->VersionList
!= 0)
286 cout
<< "Bad section " << Pkg
.Name() << endl
;
288 for (pkgCache::VerIterator Cur
= Pkg
.VersionList();
289 Cur
.end() != true; Cur
++)
291 if (Cur
->Priority
< 1 || Cur
->Priority
> 5)
292 cout
<< "Bad prio " << Pkg
.Name() << ',' << Cur
.VerStr() << " == " << (int)Cur
->Priority
<< endl
;
298 // Dump - show everything /*{{{*/
299 // ---------------------------------------------------------------------
301 bool Dump(CommandLine
&Cmd
)
303 pkgCache
&Cache
= *GCache
;
304 for (pkgCache::PkgIterator P
= Cache
.PkgBegin(); P
.end() == false; P
++)
306 cout
<< "Package: " << P
.Name() << endl
;
307 for (pkgCache::VerIterator V
= P
.VersionList(); V
.end() == false; V
++)
309 cout
<< " Version: " << V
.VerStr() << endl
;
310 cout
<< " File: " << V
.FileList().File().FileName() << endl
;
311 for (pkgCache::DepIterator D
= V
.DependsList(); D
.end() == false; D
++)
312 cout
<< " Depends: " << D
.TargetPkg().Name() << ' ' << D
.TargetVer() << endl
;
316 for (pkgCache::PkgFileIterator
F(Cache
); F
.end() == false; F
++)
318 cout
<< "File: " << F
.FileName() << endl
;
319 cout
<< " Size: " << F
->Size
<< endl
;
320 cout
<< " ID: " << F
->ID
<< endl
;
321 cout
<< " Flags: " << F
->Flags
<< endl
;
322 cout
<< " Time: " << TimeRFC1123(F
->mtime
) << endl
;
323 cout
<< " Archive: " << F
.Archive() << endl
;
324 cout
<< " Component: " << F
.Component() << endl
;
325 cout
<< " Version: " << F
.Version() << endl
;
326 cout
<< " Origin: " << F
.Origin() << endl
;
327 cout
<< " Label: " << F
.Label() << endl
;
328 cout
<< " Architecture: " << F
.Architecture() << endl
;
334 // DumpAvail - Print out the available list /*{{{*/
335 // ---------------------------------------------------------------------
336 /* This is needed to make dpkg --merge happy */
337 bool DumpAvail(CommandLine
&Cmd
)
339 pkgCache
&Cache
= *GCache
;
340 unsigned char *Buffer
= new unsigned char[Cache
.HeaderP
->MaxVerFileSize
];
342 for (pkgCache::PkgFileIterator I
= Cache
.FileBegin(); I
.end() == false; I
++)
344 if ((I
->Flags
& pkgCache::Flag::NotSource
) != 0)
347 if (I
.IsOk() == false)
350 return _error
->Error("Package file %s is out of sync.",I
.FileName());
353 FileFd
PkgF(I
.FileName(),FileFd::ReadOnly
);
354 if (_error
->PendingError() == true)
360 /* Write all of the records from this package file, we search the entire
361 structure to find them */
362 for (pkgCache::PkgIterator P
= Cache
.PkgBegin(); P
.end() == false; P
++)
364 // Find the proper version to use. We should probably use the DepCache.
365 pkgCache::VerIterator V
= Cache
.GetCandidateVer(P
,false);
367 if (V
.end() == true || V
.FileList().File() != I
)
370 // Read the record and then write it out again.
371 if (PkgF
.Seek(V
.FileList()->Offset
) == false ||
372 PkgF
.Read(Buffer
,V
.FileList()->Size
) == false ||
373 write(STDOUT_FILENO
,Buffer
,V
.FileList()->Size
) != V
.FileList()->Size
)
384 // DoAdd - Perform an adding operation /*{{{*/
385 // ---------------------------------------------------------------------
387 bool DoAdd(CommandLine
&CmdL
)
389 // Make sure there is at least one argument
390 if (CmdL
.FileSize() <= 1)
391 return _error
->Error("You must give at least one file name");
394 FileFd
CacheF(_config
->FindFile("Dir::Cache::pkgcache"),FileFd::WriteAny
);
395 if (_error
->PendingError() == true)
398 DynamicMMap
Map(CacheF
,MMap::Public
);
399 if (_error
->PendingError() == true)
402 OpTextProgress
Progress(*_config
);
403 pkgCacheGenerator
Gen(Map
,Progress
);
404 if (_error
->PendingError() == true)
407 unsigned long Length
= CmdL
.FileSize() - 1;
408 for (const char **I
= CmdL
.FileList
+ 1; *I
!= 0; I
++)
410 Progress
.OverallProgress(I
- CmdL
.FileList
,Length
,1,"Generating cache");
411 Progress
.SubProgress(Length
);
414 FileFd
TagF(*I
,FileFd::ReadOnly
);
415 debListParser
Parser(TagF
);
416 if (_error
->PendingError() == true)
417 return _error
->Error("Problem opening %s",*I
);
419 if (Gen
.SelectFile(*I
) == false)
420 return _error
->Error("Problem with SelectFile");
422 if (Gen
.MergeList(Parser
) == false)
423 return _error
->Error("Problem with MergeList");
427 GCache
= &Gen
.GetCache();
433 // DisplayRecord - Displays the complete record for the package /*{{{*/
434 // ---------------------------------------------------------------------
435 /* This displays the package record from the proper package index file.
436 It is not used by DumpAvail for performance reasons. */
437 bool DisplayRecord(pkgCache::VerIterator V
)
439 // Find an appropriate file
440 pkgCache::VerFileIterator Vf
= V
.FileList();
441 for (; Vf
.end() == false; Vf
++)
442 if ((Vf
.File()->Flags
& pkgCache::Flag::NotSource
) == 0)
444 if (Vf
.end() == true)
447 // Check and load the package list file
448 pkgCache::PkgFileIterator I
= Vf
.File();
449 if (I
.IsOk() == false)
450 return _error
->Error("Package file %s is out of sync.",I
.FileName());
452 FileFd
PkgF(I
.FileName(),FileFd::ReadOnly
);
453 if (_error
->PendingError() == true)
456 // Read the record and then write it out again.
457 unsigned char *Buffer
= new unsigned char[GCache
->HeaderP
->MaxVerFileSize
];
458 if (PkgF
.Seek(V
.FileList()->Offset
) == false ||
459 PkgF
.Read(Buffer
,V
.FileList()->Size
) == false ||
460 write(STDOUT_FILENO
,Buffer
,V
.FileList()->Size
) != V
.FileList()->Size
)
471 // Search - Perform a search /*{{{*/
472 // ---------------------------------------------------------------------
473 /* This searches the package names and pacakge descriptions for a pattern */
474 bool Search(CommandLine
&CmdL
)
476 pkgCache
&Cache
= *GCache
;
477 bool ShowFull
= _config
->FindB("APT::Cache::ShowFull",false);
478 bool NamesOnly
= _config
->FindB("APT::Cache::NamesOnly",false);
480 // Make sure there is at least one argument
481 if (CmdL
.FileSize() != 2)
482 return _error
->Error("You must give exactly one pattern");
484 // Compile the regex pattern
486 if (regcomp(&Pattern
,CmdL
.FileList
[1],REG_EXTENDED
| REG_ICASE
|
488 return _error
->Error("Regex compilation error");
490 // Create the text record parser
491 pkgRecords
Recs(Cache
);
492 if (_error
->PendingError() == true)
495 // Search package names
496 pkgCache::PkgIterator I
= Cache
.PkgBegin();
497 for (;I
.end() != true; I
++)
499 // We search against the install version as that makes the most sense..
500 pkgCache::VerIterator V
= Cache
.GetCandidateVer(I
);
504 pkgRecords::Parser
&P
= Recs
.Lookup(V
.FileList());
506 if (regexec(&Pattern
,I
.Name(),0,0,0) == 0 ||
507 (NamesOnly
== false &&
508 regexec(&Pattern
,P
.LongDesc().c_str(),0,0,0) == 0))
510 if (ShowFull
== true)
513 cout
<< I
.Name() << " - " << P
.ShortDesc() << endl
;
521 // ShowPackage - Dump the package record to the screen /*{{{*/
522 // ---------------------------------------------------------------------
524 bool ShowPackage(CommandLine
&CmdL
)
526 pkgCache
&Cache
= *GCache
;
527 for (const char **I
= CmdL
.FileList
+ 1; *I
!= 0; I
++)
529 pkgCache::PkgIterator Pkg
= Cache
.FindPkg(*I
);
530 if (Pkg
.end() == true)
532 _error
->Warning("Unable to locate package %s",*I
);
536 // Find the proper version to use. We should probably use the DepCache.
537 pkgCache::VerIterator V
= Cache
.GetCandidateVer(Pkg
);
538 if (V
.end() == true || V
.FileList().end() == true)
540 if (DisplayRecord(V
) == false)
546 // GenCaches - Call the main cache generator /*{{{*/
547 // ---------------------------------------------------------------------
549 bool GenCaches(CommandLine
&Cmd
)
551 OpTextProgress
Progress(*_config
);
555 return pkgMakeStatusCache(List
,Progress
);
558 // ShowHelp - Show a help screen /*{{{*/
559 // ---------------------------------------------------------------------
561 bool ShowHelp(CommandLine
&Cmd
)
563 cout
<< PACKAGE
<< ' ' << VERSION
<< " for " << ARCHITECTURE
<<
564 " compiled on " << __DATE__
<< " " << __TIME__
<< endl
;
565 if (_config
->FindB("version") == true)
568 cout
<< "Usage: apt-cache [options] command" << endl
;
569 cout
<< " apt-cache [options] add file1 [file1 ...]" << endl
;
570 cout
<< " apt-cache [options] showpkg pkg1 [pkg2 ...]" << endl
;
572 cout
<< "apt-cache is a low-level tool used to manipulate APT's binary" << endl
;
573 cout
<< "cache files stored in " << _config
->FindFile("Dir::Cache") << endl
;
574 cout
<< "It is not ment for ordinary use only as a debug aide." << endl
;
576 cout
<< "Commands:" << endl
;
577 cout
<< " add - Add an package file to the source cache" << endl
;
578 cout
<< " gencaches - Build both the package and source cache" << endl
;
579 cout
<< " showpkg - Show some general information for a single package" << endl
;
580 cout
<< " stats - Show some basic statistics" << endl
;
581 cout
<< " dump - Show the entire file in a terse form" << endl
;
582 cout
<< " dumpavail - Print an available file to stdout" << endl
;
583 cout
<< " unmet - Show unmet dependencies" << endl
;
584 cout
<< " check - Check the cache a bit" << endl
;
585 cout
<< " search - Search the package list for a regex pattern" << endl
;
586 cout
<< " show - Show a readable record for the package" << endl
;
588 cout
<< "Options:" << endl
;
589 cout
<< " -h This help text." << endl
;
590 cout
<< " -p=? The package cache. [" << _config
->FindFile("Dir::Cache::pkgcache") << ']' << endl
;
591 cout
<< " -s=? The source cache. [" << _config
->FindFile("Dir::Cache::srcpkgcache") << ']' << endl
;
592 cout
<< " -q Disable progress indicator." << endl
;
593 cout
<< " -i Show only important deps for the unmet command." << endl
;
594 cout
<< " -c=? Read this configuration file" << endl
;
595 cout
<< " -o=? Set an arbitary configuration option, eg -o dir::cache=/tmp" << endl
;
596 cout
<< "See the apt-cache(8) and apt.conf(5) manual pages for more information." << endl
;
600 // CacheInitialize - Initialize things for apt-cache /*{{{*/
601 // ---------------------------------------------------------------------
603 void CacheInitialize()
605 _config
->Set("quiet",0);
606 _config
->Set("help",false);
610 int main(int argc
,const char *argv
[])
612 CommandLine::Args Args
[] = {
613 {'h',"help","help",0},
614 {'v',"version","version",0},
615 {'p',"pkg-cache","Dir::Cache::pkgcache",CommandLine::HasArg
},
616 {'s',"src-cache","Dir::Cache::srcpkgcache",CommandLine::HasArg
},
617 {'q',"quiet","quiet",CommandLine::IntLevel
},
618 {'i',"important","APT::Cache::Important",0},
619 {'f',"full","APT::Cache::ShowFull",0},
620 {0,"names-only","APT::Cache::NamesOnly",0},
621 {'c',"config-file",0,CommandLine::ConfigFile
},
622 {'o',"option",0,CommandLine::ArbItem
},
624 CommandLine::Dispatch CmdsA
[] = {{"help",&ShowHelp
},
626 {"gencaches",&GenCaches
},
628 CommandLine::Dispatch CmdsB
[] = {{"showpkg",&DumpPackage
},
631 {"dumpavail",&DumpAvail
},
635 {"show",&ShowPackage
},
640 // Parse the command line and initialize the package library
641 CommandLine
CmdL(Args
,_config
);
642 if (pkgInitialize(*_config
) == false ||
643 CmdL
.Parse(argc
,argv
) == false)
645 _error
->DumpErrors();
649 // See if the help should be shown
650 if (_config
->FindB("help") == true ||
651 CmdL
.FileSize() == 0)
652 return ShowHelp(CmdL
);
654 // Deal with stdout not being a tty
655 if (ttyname(STDOUT_FILENO
) == 0 && _config
->FindI("quiet",0) < 1)
656 _config
->Set("quiet","1");
658 if (CmdL
.DispatchArg(CmdsA
,false) == false && _error
->PendingError() == false)
660 // Open the cache file
664 // Generate it and map it
666 MMap
*Map
= pkgMakeStatusCacheMem(List
,Prog
);
667 if (_error
->PendingError() == false)
669 pkgCache
Cache(*Map
);
671 if (_error
->PendingError() == false)
672 CmdL
.DispatchArg(CmdsB
);
677 // Print any errors or warnings found during parsing
678 if (_error
->empty() == false)
680 bool Errors
= _error
->PendingError();
681 _error
->DumpErrors();
682 return Errors
== true?100:0;