apt-get.cc 57 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693
  1. // -*- mode: cpp; mode: fold -*-
  2. // Description /*{{{*/
  3. // $Id: apt-get.cc,v 1.156 2004/08/28 01:05:16 mdz Exp $
  4. /* ######################################################################
  5. apt-get - Cover for dpkg
  6. This is an allout cover for dpkg implementing a safer front end. It is
  7. based largely on libapt-pkg.
  8. The syntax is different,
  9. apt-get [opt] command [things]
  10. Where command is:
  11. update - Resyncronize the package files from their sources
  12. upgrade - Smart-Download the newest versions of all packages
  13. dselect-upgrade - Follows dselect's changes to the Status: field
  14. and installes new and removes old packages
  15. dist-upgrade - Powerful upgrader designed to handle the issues with
  16. a new distribution.
  17. install - Download and install a given package (by name, not by .deb)
  18. check - Update the package cache and check for broken packages
  19. clean - Erase the .debs downloaded to /var/cache/apt/archives and
  20. the partial dir too
  21. ##################################################################### */
  22. /*}}}*/
  23. // Include Files /*{{{*/
  24. #include <config.h>
  25. #include <apt-pkg/acquire-item.h>
  26. #include <apt-pkg/algorithms.h>
  27. #include <apt-pkg/aptconfiguration.h>
  28. #include <apt-pkg/cachefile.h>
  29. #include <apt-pkg/cacheset.h>
  30. #include <apt-pkg/clean.h>
  31. #include <apt-pkg/cmndline.h>
  32. #include <apt-pkg/debmetaindex.h>
  33. #include <apt-pkg/depcache.h>
  34. #include <apt-pkg/error.h>
  35. #include <apt-pkg/fileutl.h>
  36. #include <apt-pkg/indexfile.h>
  37. #include <apt-pkg/init.h>
  38. #include <apt-pkg/md5.h>
  39. #include <apt-pkg/metaindex.h>
  40. #include <apt-pkg/pkgrecords.h>
  41. #include <apt-pkg/pkgsystem.h>
  42. #include <apt-pkg/progress.h>
  43. #include <apt-pkg/sourcelist.h>
  44. #include <apt-pkg/srcrecords.h>
  45. #include <apt-pkg/strutl.h>
  46. #include <apt-pkg/version.h>
  47. #include <apt-pkg/acquire.h>
  48. #include <apt-pkg/configuration.h>
  49. #include <apt-pkg/macros.h>
  50. #include <apt-pkg/pkgcache.h>
  51. #include <apt-pkg/cacheiterators.h>
  52. #include <apt-pkg/upgrade.h>
  53. #include <apt-pkg/sptr.h>
  54. #include <apt-private/acqprogress.h>
  55. #include <apt-private/private-cacheset.h>
  56. #include <apt-private/private-cachefile.h>
  57. #include <apt-private/private-cmndline.h>
  58. #include <apt-private/private-download.h>
  59. #include <apt-private/private-install.h>
  60. #include <apt-private/private-main.h>
  61. #include <apt-private/private-moo.h>
  62. #include <apt-private/private-output.h>
  63. #include <apt-private/private-update.h>
  64. #include <apt-private/private-upgrade.h>
  65. #include <apt-private/private-utils.h>
  66. #include <errno.h>
  67. #include <signal.h>
  68. #include <stddef.h>
  69. #include <stdio.h>
  70. #include <stdlib.h>
  71. #include <string.h>
  72. #include <sys/ioctl.h>
  73. #include <sys/stat.h>
  74. #include <sys/wait.h>
  75. #include <unistd.h>
  76. #include <pwd.h>
  77. #include <grp.h>
  78. #include <algorithm>
  79. #include <fstream>
  80. #include <iostream>
  81. #include <sstream>
  82. #include <set>
  83. #include <string>
  84. #include <vector>
  85. #include <apti18n.h>
  86. /*}}}*/
  87. using namespace std;
  88. // TryToInstallBuildDep - Try to install a single package /*{{{*/
  89. // ---------------------------------------------------------------------
  90. /* This used to be inlined in DoInstall, but with the advent of regex package
  91. name matching it was split out.. */
  92. static bool TryToInstallBuildDep(pkgCache::PkgIterator Pkg,pkgCacheFile &Cache,
  93. pkgProblemResolver &Fix,bool Remove,bool BrokenFix,
  94. bool AllowFail = true)
  95. {
  96. if (Cache[Pkg].CandidateVer == 0 && Pkg->ProvidesList != 0)
  97. {
  98. CacheSetHelperAPTGet helper(c1out);
  99. helper.showErrors(false);
  100. pkgCache::VerIterator Ver = helper.canNotFindNewestVer(Cache, Pkg);
  101. if (Ver.end() == false)
  102. Pkg = Ver.ParentPkg();
  103. else if (helper.showVirtualPackageErrors(Cache) == false)
  104. return AllowFail;
  105. }
  106. if (_config->FindB("Debug::BuildDeps",false) == true)
  107. {
  108. if (Remove == true)
  109. cout << " Trying to remove " << Pkg << endl;
  110. else
  111. cout << " Trying to install " << Pkg << endl;
  112. }
  113. if (Remove == true)
  114. {
  115. TryToRemove RemoveAction(Cache, &Fix);
  116. RemoveAction(Pkg.VersionList());
  117. } else if (Cache[Pkg].CandidateVer != 0) {
  118. TryToInstall InstallAction(Cache, &Fix, BrokenFix);
  119. InstallAction(Cache[Pkg].CandidateVerIter(Cache));
  120. InstallAction.doAutoInstall();
  121. } else
  122. return AllowFail;
  123. return true;
  124. }
  125. /*}}}*/
  126. // GetReleaseFileForSourceRecord - Return Suite for the given srcrecord /*{{{*/
  127. static pkgCache::RlsFileIterator GetReleaseFileForSourceRecord(CacheFile &CacheFile,
  128. pkgSourceList *SrcList, pkgSrcRecords::Parser *Parse)
  129. {
  130. // try to find release
  131. const pkgIndexFile& CurrentIndexFile = Parse->Index();
  132. for (pkgSourceList::const_iterator S = SrcList->begin();
  133. S != SrcList->end(); ++S)
  134. {
  135. vector<pkgIndexFile *> *Indexes = (*S)->GetIndexFiles();
  136. for (vector<pkgIndexFile *>::const_iterator IF = Indexes->begin();
  137. IF != Indexes->end(); ++IF)
  138. {
  139. if (&CurrentIndexFile == (*IF))
  140. return (*S)->FindInCache(CacheFile, false);
  141. }
  142. }
  143. return pkgCache::RlsFileIterator(CacheFile);
  144. }
  145. /*}}}*/
  146. // FindSrc - Find a source record /*{{{*/
  147. // ---------------------------------------------------------------------
  148. /* */
  149. static pkgSrcRecords::Parser *FindSrc(const char *Name,
  150. pkgSrcRecords &SrcRecs,string &Src,
  151. CacheFile &CacheFile)
  152. {
  153. string VerTag, UserRequestedVerTag;
  154. string ArchTag = "";
  155. string RelTag = _config->Find("APT::Default-Release");
  156. string TmpSrc = Name;
  157. pkgDepCache *Cache = CacheFile.GetDepCache();
  158. // extract release
  159. size_t found = TmpSrc.find_last_of("/");
  160. if (found != string::npos)
  161. {
  162. RelTag = TmpSrc.substr(found+1);
  163. TmpSrc = TmpSrc.substr(0,found);
  164. }
  165. // extract the version
  166. found = TmpSrc.find_last_of("=");
  167. if (found != string::npos)
  168. {
  169. VerTag = UserRequestedVerTag = TmpSrc.substr(found+1);
  170. TmpSrc = TmpSrc.substr(0,found);
  171. }
  172. // extract arch
  173. found = TmpSrc.find_last_of(":");
  174. if (found != string::npos)
  175. {
  176. ArchTag = TmpSrc.substr(found+1);
  177. TmpSrc = TmpSrc.substr(0,found);
  178. }
  179. /* Lookup the version of the package we would install if we were to
  180. install a version and determine the source package name, then look
  181. in the archive for a source package of the same name. */
  182. bool MatchSrcOnly = _config->FindB("APT::Get::Only-Source");
  183. pkgCache::PkgIterator Pkg;
  184. if (ArchTag != "")
  185. Pkg = Cache->FindPkg(TmpSrc, ArchTag);
  186. else
  187. Pkg = Cache->FindPkg(TmpSrc);
  188. // if we can't find a package but the user qualified with a arch,
  189. // error out here
  190. if (Pkg.end() && ArchTag != "")
  191. {
  192. Src = Name;
  193. _error->Error(_("Can not find a package for architecture '%s'"),
  194. ArchTag.c_str());
  195. return 0;
  196. }
  197. if (MatchSrcOnly == false && Pkg.end() == false)
  198. {
  199. if(VerTag != "" || RelTag != "" || ArchTag != "")
  200. {
  201. bool fuzzy = false;
  202. // we have a default release, try to locate the pkg. we do it like
  203. // this because GetCandidateVer() will not "downgrade", that means
  204. // "apt-get source -t stable apt" won't work on a unstable system
  205. for (pkgCache::VerIterator Ver = Pkg.VersionList();; ++Ver)
  206. {
  207. // try first only exact matches, later fuzzy matches
  208. if (Ver.end() == true)
  209. {
  210. if (fuzzy == true)
  211. break;
  212. fuzzy = true;
  213. Ver = Pkg.VersionList();
  214. // exit right away from the Pkg.VersionList() loop if we
  215. // don't have any versions
  216. if (Ver.end() == true)
  217. break;
  218. }
  219. // ignore arches that are not for us
  220. if (ArchTag != "" && Ver.Arch() != ArchTag)
  221. continue;
  222. // pick highest version for the arch unless the user wants
  223. // something else
  224. if (ArchTag != "" && VerTag == "" && RelTag == "")
  225. if(Cache->VS().CmpVersion(VerTag, Ver.VerStr()) < 0)
  226. VerTag = Ver.VerStr();
  227. // We match against a concrete version (or a part of this version)
  228. if (VerTag.empty() == false &&
  229. (fuzzy == true || Cache->VS().CmpVersion(VerTag, Ver.VerStr()) != 0) && // exact match
  230. (fuzzy == false || strncmp(VerTag.c_str(), Ver.VerStr(), VerTag.size()) != 0)) // fuzzy match
  231. continue;
  232. for (pkgCache::VerFileIterator VF = Ver.FileList();
  233. VF.end() == false; ++VF)
  234. {
  235. /* If this is the status file, and the current version is not the
  236. version in the status file (ie it is not installed, or somesuch)
  237. then it is not a candidate for installation, ever. This weeds
  238. out bogus entries that may be due to config-file states, or
  239. other. */
  240. if ((VF.File()->Flags & pkgCache::Flag::NotSource) ==
  241. pkgCache::Flag::NotSource && Pkg.CurrentVer() != Ver)
  242. continue;
  243. // or we match against a release
  244. if(VerTag.empty() == false ||
  245. (VF.File().Archive() != 0 && VF.File().Archive() == RelTag) ||
  246. (VF.File().Codename() != 0 && VF.File().Codename() == RelTag))
  247. {
  248. // the Version we have is possibly fuzzy or includes binUploads,
  249. // so we use the Version of the SourcePkg (empty if same as package)
  250. Src = Ver.SourcePkgName();
  251. VerTag = Ver.SourceVerStr();
  252. break;
  253. }
  254. }
  255. if (Src.empty() == false)
  256. break;
  257. }
  258. }
  259. if (Src == "" && ArchTag != "")
  260. {
  261. if (VerTag != "")
  262. _error->Error(_("Can not find a package '%s' with version '%s'"),
  263. Pkg.FullName().c_str(), VerTag.c_str());
  264. if (RelTag != "")
  265. _error->Error(_("Can not find a package '%s' with release '%s'"),
  266. Pkg.FullName().c_str(), RelTag.c_str());
  267. Src = Name;
  268. return 0;
  269. }
  270. if (Src.empty() == true)
  271. {
  272. // if we don't have found a fitting package yet so we will
  273. // choose a good candidate and proceed with that.
  274. // Maybe we will find a source later on with the right VerTag
  275. // or RelTag
  276. pkgCache::VerIterator Ver = Cache->GetCandidateVer(Pkg);
  277. if (Ver.end() == false)
  278. {
  279. if (strcmp(Ver.SourcePkgName(),Ver.ParentPkg().Name()) != 0)
  280. Src = Ver.SourcePkgName();
  281. if (VerTag.empty() == true && strcmp(Ver.SourceVerStr(),Ver.VerStr()) != 0)
  282. VerTag = Ver.SourceVerStr();
  283. }
  284. }
  285. }
  286. if (Src.empty() == true)
  287. {
  288. Src = TmpSrc;
  289. }
  290. else
  291. {
  292. /* if we have a source pkg name, make sure to only search
  293. for srcpkg names, otherwise apt gets confused if there
  294. is a binary package "pkg1" and a source package "pkg1"
  295. with the same name but that comes from different packages */
  296. MatchSrcOnly = true;
  297. if (Src != TmpSrc)
  298. {
  299. ioprintf(c1out, _("Picking '%s' as source package instead of '%s'\n"), Src.c_str(), TmpSrc.c_str());
  300. }
  301. }
  302. // The best hit
  303. pkgSrcRecords::Parser *Last = 0;
  304. unsigned long Offset = 0;
  305. string Version;
  306. pkgSourceList *SrcList = CacheFile.GetSourceList();
  307. /* Iterate over all of the hits, which includes the resulting
  308. binary packages in the search */
  309. pkgSrcRecords::Parser *Parse;
  310. while (true)
  311. {
  312. SrcRecs.Restart();
  313. while ((Parse = SrcRecs.Find(Src.c_str(), MatchSrcOnly)) != 0)
  314. {
  315. const string Ver = Parse->Version();
  316. // See if we need to look for a specific release tag
  317. if (RelTag != "" && UserRequestedVerTag == "")
  318. {
  319. pkgCache::RlsFileIterator const Rls = GetReleaseFileForSourceRecord(CacheFile, SrcList, Parse);
  320. if (Rls.end() == false)
  321. {
  322. if ((Rls->Archive != 0 && RelTag == Rls.Archive()) ||
  323. (Rls->Codename != 0 && RelTag == Rls.Codename()))
  324. {
  325. Last = Parse;
  326. Offset = Parse->Offset();
  327. Version = Ver;
  328. }
  329. }
  330. }
  331. // Ignore all versions which doesn't fit
  332. if (VerTag.empty() == false &&
  333. Cache->VS().CmpVersion(VerTag, Ver) != 0) // exact match
  334. continue;
  335. // Newer version or an exact match? Save the hit
  336. if (Last == 0 || Cache->VS().CmpVersion(Version,Ver) < 0) {
  337. Last = Parse;
  338. Offset = Parse->Offset();
  339. Version = Ver;
  340. }
  341. // was the version check above an exact match?
  342. // If so, we don't need to look further
  343. if (VerTag.empty() == false && (VerTag == Ver))
  344. break;
  345. }
  346. if (UserRequestedVerTag == "" && Version != "" && RelTag != "")
  347. ioprintf(c1out, "Selected version '%s' (%s) for %s\n",
  348. Version.c_str(), RelTag.c_str(), Src.c_str());
  349. if (Last != 0 || VerTag.empty() == true)
  350. break;
  351. _error->Error(_("Can not find version '%s' of package '%s'"), VerTag.c_str(), TmpSrc.c_str());
  352. return 0;
  353. }
  354. if (Last == 0 || Last->Jump(Offset) == false)
  355. return 0;
  356. return Last;
  357. }
  358. /*}}}*/
  359. /* mark packages as automatically/manually installed. {{{*/
  360. static bool DoMarkAuto(CommandLine &CmdL)
  361. {
  362. bool Action = true;
  363. int AutoMarkChanged = 0;
  364. OpTextProgress progress;
  365. CacheFile Cache;
  366. if (Cache.Open() == false)
  367. return false;
  368. if (strcasecmp(CmdL.FileList[0],"markauto") == 0)
  369. Action = true;
  370. else if (strcasecmp(CmdL.FileList[0],"unmarkauto") == 0)
  371. Action = false;
  372. for (const char **I = CmdL.FileList + 1; *I != 0; I++)
  373. {
  374. const char *S = *I;
  375. // Locate the package
  376. pkgCache::PkgIterator Pkg = Cache->FindPkg(S);
  377. if (Pkg.end() == true) {
  378. return _error->Error(_("Couldn't find package %s"),S);
  379. }
  380. else
  381. {
  382. if (!Action)
  383. ioprintf(c1out,_("%s set to manually installed.\n"), Pkg.Name());
  384. else
  385. ioprintf(c1out,_("%s set to automatically installed.\n"),
  386. Pkg.Name());
  387. Cache->MarkAuto(Pkg,Action);
  388. AutoMarkChanged++;
  389. }
  390. }
  391. _error->Notice(_("This command is deprecated. Please use 'apt-mark auto' and 'apt-mark manual' instead."));
  392. if (AutoMarkChanged && ! _config->FindB("APT::Get::Simulate",false))
  393. return Cache->writeStateFile(NULL);
  394. return false;
  395. }
  396. /*}}}*/
  397. // DoDSelectUpgrade - Do an upgrade by following dselects selections /*{{{*/
  398. // ---------------------------------------------------------------------
  399. /* Follows dselect's selections */
  400. static bool DoDSelectUpgrade(CommandLine &)
  401. {
  402. CacheFile Cache;
  403. if (Cache.OpenForInstall() == false || Cache.CheckDeps() == false)
  404. return false;
  405. pkgDepCache::ActionGroup group(Cache);
  406. // Install everything with the install flag set
  407. pkgCache::PkgIterator I = Cache->PkgBegin();
  408. for (;I.end() != true; ++I)
  409. {
  410. /* Install the package only if it is a new install, the autoupgrader
  411. will deal with the rest */
  412. if (I->SelectedState == pkgCache::State::Install)
  413. Cache->MarkInstall(I,false);
  414. }
  415. /* Now install their deps too, if we do this above then order of
  416. the status file is significant for | groups */
  417. for (I = Cache->PkgBegin();I.end() != true; ++I)
  418. {
  419. /* Install the package only if it is a new install, the autoupgrader
  420. will deal with the rest */
  421. if (I->SelectedState == pkgCache::State::Install)
  422. Cache->MarkInstall(I,true);
  423. }
  424. // Apply erasures now, they override everything else.
  425. for (I = Cache->PkgBegin();I.end() != true; ++I)
  426. {
  427. // Remove packages
  428. if (I->SelectedState == pkgCache::State::DeInstall ||
  429. I->SelectedState == pkgCache::State::Purge)
  430. Cache->MarkDelete(I,I->SelectedState == pkgCache::State::Purge);
  431. }
  432. /* Resolve any problems that dselect created, allupgrade cannot handle
  433. such things. We do so quite aggressively too.. */
  434. if (Cache->BrokenCount() != 0)
  435. {
  436. pkgProblemResolver Fix(Cache);
  437. // Hold back held packages.
  438. if (_config->FindB("APT::Ignore-Hold",false) == false)
  439. {
  440. for (pkgCache::PkgIterator I = Cache->PkgBegin(); I.end() == false; ++I)
  441. {
  442. if (I->SelectedState == pkgCache::State::Hold)
  443. {
  444. Fix.Protect(I);
  445. Cache->MarkKeep(I);
  446. }
  447. }
  448. }
  449. if (Fix.Resolve() == false)
  450. {
  451. ShowBroken(c1out,Cache,false);
  452. return _error->Error(_("Internal error, problem resolver broke stuff"));
  453. }
  454. }
  455. // Now upgrade everything
  456. if (APT::Upgrade::Upgrade(Cache, APT::Upgrade::FORBID_REMOVE_PACKAGES | APT::Upgrade::FORBID_INSTALL_NEW_PACKAGES) == false)
  457. {
  458. ShowBroken(c1out,Cache,false);
  459. return _error->Error(_("Internal error, problem resolver broke stuff"));
  460. }
  461. return InstallPackages(Cache,false);
  462. }
  463. /*}}}*/
  464. // DoClean - Remove download archives /*{{{*/
  465. // ---------------------------------------------------------------------
  466. /* */
  467. static bool DoClean(CommandLine &)
  468. {
  469. std::string const archivedir = _config->FindDir("Dir::Cache::archives");
  470. std::string const listsdir = _config->FindDir("Dir::state::lists");
  471. if (_config->FindB("APT::Get::Simulate") == true)
  472. {
  473. std::string const pkgcache = _config->FindFile("Dir::cache::pkgcache");
  474. std::string const srcpkgcache = _config->FindFile("Dir::cache::srcpkgcache");
  475. cout << "Del " << archivedir << "* " << archivedir << "partial/*"<< endl
  476. << "Del " << listsdir << "partial/*" << endl
  477. << "Del " << pkgcache << " " << srcpkgcache << endl;
  478. return true;
  479. }
  480. pkgAcquire Fetcher;
  481. Fetcher.GetLock(archivedir);
  482. Fetcher.Clean(archivedir);
  483. Fetcher.Clean(archivedir + "partial/");
  484. Fetcher.GetLock(listsdir);
  485. Fetcher.Clean(listsdir + "partial/");
  486. pkgCacheFile::RemoveCaches();
  487. return true;
  488. }
  489. /*}}}*/
  490. // DoAutoClean - Smartly remove downloaded archives /*{{{*/
  491. // ---------------------------------------------------------------------
  492. /* This is similar to clean but it only purges things that cannot be
  493. downloaded, that is old versions of cached packages. */
  494. class LogCleaner : public pkgArchiveCleaner
  495. {
  496. protected:
  497. virtual void Erase(const char *File,string Pkg,string Ver,struct stat &St) APT_OVERRIDE
  498. {
  499. c1out << "Del " << Pkg << " " << Ver << " [" << SizeToStr(St.st_size) << "B]" << endl;
  500. if (_config->FindB("APT::Get::Simulate") == false)
  501. unlink(File);
  502. };
  503. };
  504. static bool DoAutoClean(CommandLine &)
  505. {
  506. // Lock the archive directory
  507. FileFd Lock;
  508. if (_config->FindB("Debug::NoLocking",false) == false)
  509. {
  510. int lock_fd = GetLock(_config->FindDir("Dir::Cache::Archives") + "lock");
  511. if (lock_fd < 0)
  512. return _error->Error(_("Unable to lock the download directory"));
  513. Lock.Fd(lock_fd);
  514. }
  515. CacheFile Cache;
  516. if (Cache.Open() == false)
  517. return false;
  518. LogCleaner Cleaner;
  519. return Cleaner.Go(_config->FindDir("Dir::Cache::archives"),*Cache) &&
  520. Cleaner.Go(_config->FindDir("Dir::Cache::archives") + "partial/",*Cache);
  521. }
  522. /*}}}*/
  523. // DoDownload - download a binary /*{{{*/
  524. // ---------------------------------------------------------------------
  525. static bool DoDownload(CommandLine &CmdL)
  526. {
  527. CacheFile Cache;
  528. if (Cache.ReadOnlyOpen() == false)
  529. return false;
  530. APT::CacheSetHelper helper;
  531. APT::VersionSet verset = APT::VersionSet::FromCommandLine(Cache,
  532. CmdL.FileList + 1, APT::CacheSetHelper::CANDIDATE, helper);
  533. if (verset.empty() == true)
  534. return false;
  535. AcqTextStatus Stat(std::cout, ScreenWidth,_config->FindI("quiet",0));
  536. pkgAcquire Fetcher(&Stat);
  537. pkgRecords Recs(Cache);
  538. pkgSourceList *SrcList = Cache.GetSourceList();
  539. // reuse the usual acquire methods for deb files, but don't drop them into
  540. // the usual directories - keep everything in the current directory
  541. std::vector<std::string> storefile(verset.size());
  542. std::string const cwd = SafeGetCWD();
  543. _config->Set("Dir::Cache::Archives", cwd);
  544. int i = 0;
  545. for (APT::VersionSet::const_iterator Ver = verset.begin();
  546. Ver != verset.end(); ++Ver, ++i)
  547. {
  548. pkgAcquire::Item *I = new pkgAcqArchive(&Fetcher, SrcList, &Recs, *Ver, storefile[i]);
  549. if (storefile[i].empty())
  550. continue;
  551. std::string const filename = cwd + flNotDir(storefile[i]);
  552. storefile[i].assign(filename);
  553. I->DestFile.assign(filename);
  554. }
  555. // Just print out the uris and exit if the --print-uris flag was used
  556. if (_config->FindB("APT::Get::Print-URIs") == true)
  557. {
  558. pkgAcquire::UriIterator I = Fetcher.UriBegin();
  559. for (; I != Fetcher.UriEnd(); ++I)
  560. cout << '\'' << I->URI << "' " << flNotDir(I->Owner->DestFile) << ' ' <<
  561. I->Owner->FileSize << ' ' << I->Owner->HashSum() << endl;
  562. return true;
  563. }
  564. // Disable drop-privs if "_apt" can not write to the target dir
  565. CheckDropPrivsMustBeDisabled(Fetcher);
  566. if (_error->PendingError() == true || CheckAuth(Fetcher, false) == false)
  567. return false;
  568. bool Failed = false;
  569. if (AcquireRun(Fetcher, 0, &Failed, NULL) == false)
  570. return false;
  571. // copy files in local sources to the current directory
  572. for (pkgAcquire::ItemIterator I = Fetcher.ItemsBegin(); I != Fetcher.ItemsEnd(); ++I)
  573. {
  574. std::string const filename = cwd + flNotDir((*I)->DestFile);
  575. if ((*I)->Local == true &&
  576. filename != (*I)->DestFile &&
  577. (*I)->Status == pkgAcquire::Item::StatDone)
  578. {
  579. std::ifstream src((*I)->DestFile.c_str(), std::ios::binary);
  580. std::ofstream dst(filename.c_str(), std::ios::binary);
  581. dst << src.rdbuf();
  582. }
  583. }
  584. return Failed == false;
  585. }
  586. /*}}}*/
  587. // DoCheck - Perform the check operation /*{{{*/
  588. // ---------------------------------------------------------------------
  589. /* Opening automatically checks the system, this command is mostly used
  590. for debugging */
  591. static bool DoCheck(CommandLine &)
  592. {
  593. CacheFile Cache;
  594. Cache.Open();
  595. Cache.CheckDeps();
  596. return true;
  597. }
  598. /*}}}*/
  599. // DoSource - Fetch a source archive /*{{{*/
  600. // ---------------------------------------------------------------------
  601. /* Fetch souce packages */
  602. struct DscFile
  603. {
  604. string Package;
  605. string Version;
  606. string Dsc;
  607. };
  608. static bool DoSource(CommandLine &CmdL)
  609. {
  610. CacheFile Cache;
  611. if (Cache.Open(false) == false)
  612. return false;
  613. if (CmdL.FileSize() <= 1)
  614. return _error->Error(_("Must specify at least one package to fetch source for"));
  615. // Read the source list
  616. if (Cache.BuildSourceList() == false)
  617. return false;
  618. pkgSourceList *List = Cache.GetSourceList();
  619. // Create the text record parsers
  620. pkgSrcRecords SrcRecs(*List);
  621. if (_error->PendingError() == true)
  622. return false;
  623. // Create the download object
  624. AcqTextStatus Stat(std::cout, ScreenWidth,_config->FindI("quiet",0));
  625. pkgAcquire Fetcher(&Stat);
  626. SPtrArray<DscFile> Dsc = new DscFile[CmdL.FileSize()];
  627. // insert all downloaded uris into this set to avoid downloading them
  628. // twice
  629. set<string> queued;
  630. // Diff only mode only fetches .diff files
  631. bool const diffOnly = _config->FindB("APT::Get::Diff-Only", false);
  632. // Tar only mode only fetches .tar files
  633. bool const tarOnly = _config->FindB("APT::Get::Tar-Only", false);
  634. // Dsc only mode only fetches .dsc files
  635. bool const dscOnly = _config->FindB("APT::Get::Dsc-Only", false);
  636. // Load the requestd sources into the fetcher
  637. unsigned J = 0;
  638. std::vector<std::string> UntrustedList;
  639. for (const char **I = CmdL.FileList + 1; *I != 0; I++, J++)
  640. {
  641. string Src;
  642. pkgSrcRecords::Parser *Last = FindSrc(*I,SrcRecs,Src,Cache);
  643. if (Last == 0) {
  644. return _error->Error(_("Unable to find a source package for %s"),Src.c_str());
  645. }
  646. if (Last->Index().IsTrusted() == false)
  647. UntrustedList.push_back(Src);
  648. string srec = Last->AsStr();
  649. string::size_type pos = srec.find("\nVcs-");
  650. while (pos != string::npos)
  651. {
  652. pos += strlen("\nVcs-");
  653. string vcs = srec.substr(pos,srec.find(":",pos)-pos);
  654. if(vcs == "Browser")
  655. {
  656. pos = srec.find("\nVcs-", pos);
  657. continue;
  658. }
  659. pos += vcs.length()+2;
  660. string::size_type epos = srec.find("\n", pos);
  661. string uri = srec.substr(pos,epos-pos).c_str();
  662. ioprintf(c1out, _("NOTICE: '%s' packaging is maintained in "
  663. "the '%s' version control system at:\n"
  664. "%s\n"),
  665. Src.c_str(), vcs.c_str(), uri.c_str());
  666. if(vcs == "Bzr")
  667. ioprintf(c1out,_("Please use:\n"
  668. "bzr branch %s\n"
  669. "to retrieve the latest (possibly unreleased) "
  670. "updates to the package.\n"),
  671. uri.c_str());
  672. break;
  673. }
  674. // Back track
  675. vector<pkgSrcRecords::File2> Lst;
  676. if (Last->Files2(Lst) == false) {
  677. return false;
  678. }
  679. // Load them into the fetcher
  680. for (vector<pkgSrcRecords::File2>::const_iterator I = Lst.begin();
  681. I != Lst.end(); ++I)
  682. {
  683. // Try to guess what sort of file it is we are getting.
  684. if (I->Type == "dsc")
  685. {
  686. Dsc[J].Package = Last->Package();
  687. Dsc[J].Version = Last->Version();
  688. Dsc[J].Dsc = flNotDir(I->Path);
  689. }
  690. // Handle the only options so that multiple can be used at once
  691. if (diffOnly == true || tarOnly == true || dscOnly == true)
  692. {
  693. if ((diffOnly == true && I->Type == "diff") ||
  694. (tarOnly == true && I->Type == "tar") ||
  695. (dscOnly == true && I->Type == "dsc"))
  696. ; // Fine, we want this file downloaded
  697. else
  698. continue;
  699. }
  700. // don't download the same uri twice (should this be moved to
  701. // the fetcher interface itself?)
  702. if(queued.find(Last->Index().ArchiveURI(I->Path)) != queued.end())
  703. continue;
  704. queued.insert(Last->Index().ArchiveURI(I->Path));
  705. // check if we have a file with that md5 sum already localy
  706. std::string localFile = flNotDir(I->Path);
  707. if (FileExists(localFile) == true)
  708. if(I->Hashes.VerifyFile(localFile) == true)
  709. {
  710. ioprintf(c1out,_("Skipping already downloaded file '%s'\n"),
  711. localFile.c_str());
  712. continue;
  713. }
  714. // see if we have a hash (Acquire::ForceHash is the only way to have none)
  715. if (I->Hashes.usable() == false && _config->FindB("APT::Get::AllowUnauthenticated",false) == false)
  716. {
  717. ioprintf(c1out, "Skipping download of file '%s' as requested hashsum is not available for authentication\n",
  718. localFile.c_str());
  719. continue;
  720. }
  721. new pkgAcqFile(&Fetcher,Last->Index().ArchiveURI(I->Path),
  722. I->Hashes, I->FileSize, Last->Index().SourceInfo(*Last,*I), Src);
  723. }
  724. }
  725. // Display statistics
  726. unsigned long long FetchBytes = Fetcher.FetchNeeded();
  727. unsigned long long FetchPBytes = Fetcher.PartialPresent();
  728. unsigned long long DebBytes = Fetcher.TotalNeeded();
  729. if (CheckFreeSpaceBeforeDownload(".", (FetchBytes - FetchPBytes)) == false)
  730. return false;
  731. // Number of bytes
  732. if (DebBytes != FetchBytes)
  733. //TRANSLATOR: The required space between number and unit is already included
  734. // in the replacement strings, so %sB will be correctly translate in e.g. 1,5 MB
  735. ioprintf(c1out,_("Need to get %sB/%sB of source archives.\n"),
  736. SizeToStr(FetchBytes).c_str(),SizeToStr(DebBytes).c_str());
  737. else
  738. //TRANSLATOR: The required space between number and unit is already included
  739. // in the replacement string, so %sB will be correctly translate in e.g. 1,5 MB
  740. ioprintf(c1out,_("Need to get %sB of source archives.\n"),
  741. SizeToStr(DebBytes).c_str());
  742. if (_config->FindB("APT::Get::Simulate",false) == true)
  743. {
  744. for (unsigned I = 0; I != J; I++)
  745. ioprintf(cout,_("Fetch source %s\n"),Dsc[I].Package.c_str());
  746. return true;
  747. }
  748. // Just print out the uris an exit if the --print-uris flag was used
  749. if (_config->FindB("APT::Get::Print-URIs") == true)
  750. {
  751. pkgAcquire::UriIterator I = Fetcher.UriBegin();
  752. for (; I != Fetcher.UriEnd(); ++I)
  753. cout << '\'' << I->URI << "' " << flNotDir(I->Owner->DestFile) << ' ' <<
  754. I->Owner->FileSize << ' ' << I->Owner->HashSum() << endl;
  755. return true;
  756. }
  757. // Disable drop-privs if "_apt" can not write to the target dir
  758. CheckDropPrivsMustBeDisabled(Fetcher);
  759. // check authentication status of the source as well
  760. if (UntrustedList.empty() == false && AuthPrompt(UntrustedList, false) == false)
  761. return false;
  762. // Run it
  763. bool Failed = false;
  764. if (AcquireRun(Fetcher, 0, &Failed, NULL) == false || Failed == true)
  765. {
  766. return _error->Error(_("Failed to fetch some archives."));
  767. }
  768. if (_config->FindB("APT::Get::Download-only",false) == true)
  769. {
  770. c1out << _("Download complete and in download only mode") << endl;
  771. return true;
  772. }
  773. // Unpack the sources
  774. pid_t Process = ExecFork();
  775. if (Process == 0)
  776. {
  777. bool const fixBroken = _config->FindB("APT::Get::Fix-Broken", false);
  778. for (unsigned I = 0; I != J; ++I)
  779. {
  780. string Dir = Dsc[I].Package + '-' + Cache->VS().UpstreamVersion(Dsc[I].Version.c_str());
  781. // Diff only mode only fetches .diff files
  782. if (_config->FindB("APT::Get::Diff-Only",false) == true ||
  783. _config->FindB("APT::Get::Tar-Only",false) == true ||
  784. Dsc[I].Dsc.empty() == true)
  785. continue;
  786. // See if the package is already unpacked
  787. struct stat Stat;
  788. if (fixBroken == false && stat(Dir.c_str(),&Stat) == 0 &&
  789. S_ISDIR(Stat.st_mode) != 0)
  790. {
  791. ioprintf(c0out ,_("Skipping unpack of already unpacked source in %s\n"),
  792. Dir.c_str());
  793. }
  794. else
  795. {
  796. // Call dpkg-source
  797. std::string const sourceopts = _config->Find("DPkg::Source-Options", "-x");
  798. std::string S;
  799. strprintf(S, "%s %s %s",
  800. _config->Find("Dir::Bin::dpkg-source","dpkg-source").c_str(),
  801. sourceopts.c_str(), Dsc[I].Dsc.c_str());
  802. if (system(S.c_str()) != 0)
  803. {
  804. fprintf(stderr, _("Unpack command '%s' failed.\n"), S.c_str());
  805. fprintf(stderr, _("Check if the 'dpkg-dev' package is installed.\n"));
  806. _exit(1);
  807. }
  808. }
  809. // Try to compile it with dpkg-buildpackage
  810. if (_config->FindB("APT::Get::Compile",false) == true)
  811. {
  812. string buildopts = _config->Find("APT::Get::Host-Architecture");
  813. if (buildopts.empty() == false)
  814. buildopts = "-a" + buildopts + " ";
  815. // get all active build profiles
  816. std::string const profiles = APT::Configuration::getBuildProfilesString();
  817. if (profiles.empty() == false)
  818. buildopts.append(" -P").append(profiles).append(" ");
  819. buildopts.append(_config->Find("DPkg::Build-Options","-b -uc"));
  820. // Call dpkg-buildpackage
  821. std::string S;
  822. strprintf(S, "cd %s && %s %s",
  823. Dir.c_str(),
  824. _config->Find("Dir::Bin::dpkg-buildpackage","dpkg-buildpackage").c_str(),
  825. buildopts.c_str());
  826. if (system(S.c_str()) != 0)
  827. {
  828. fprintf(stderr, _("Build command '%s' failed.\n"), S.c_str());
  829. _exit(1);
  830. }
  831. }
  832. }
  833. _exit(0);
  834. }
  835. // Wait for the subprocess
  836. int Status = 0;
  837. while (waitpid(Process,&Status,0) != Process)
  838. {
  839. if (errno == EINTR)
  840. continue;
  841. return _error->Errno("waitpid","Couldn't wait for subprocess");
  842. }
  843. if (WIFEXITED(Status) == 0 || WEXITSTATUS(Status) != 0)
  844. return _error->Error(_("Child process failed"));
  845. return true;
  846. }
  847. /*}}}*/
  848. // DoBuildDep - Install/removes packages to satisfy build dependencies /*{{{*/
  849. // ---------------------------------------------------------------------
  850. /* This function will look at the build depends list of the given source
  851. package and install the necessary packages to make it true, or fail. */
  852. static bool DoBuildDep(CommandLine &CmdL)
  853. {
  854. CacheFile Cache;
  855. _config->Set("APT::Install-Recommends", false);
  856. if (Cache.Open(true) == false)
  857. return false;
  858. if (CmdL.FileSize() <= 1)
  859. return _error->Error(_("Must specify at least one package to check builddeps for"));
  860. // Read the source list
  861. if (Cache.BuildSourceList() == false)
  862. return false;
  863. pkgSourceList *List = Cache.GetSourceList();
  864. // Create the text record parsers
  865. pkgSrcRecords SrcRecs(*List);
  866. if (_error->PendingError() == true)
  867. return false;
  868. bool StripMultiArch;
  869. string hostArch = _config->Find("APT::Get::Host-Architecture");
  870. if (hostArch.empty() == false)
  871. {
  872. std::vector<std::string> archs = APT::Configuration::getArchitectures();
  873. if (std::find(archs.begin(), archs.end(), hostArch) == archs.end())
  874. return _error->Error(_("No architecture information available for %s. See apt.conf(5) APT::Architectures for setup"), hostArch.c_str());
  875. StripMultiArch = false;
  876. }
  877. else
  878. StripMultiArch = true;
  879. unsigned J = 0;
  880. for (const char **I = CmdL.FileList + 1; *I != 0; I++, J++)
  881. {
  882. string Src;
  883. pkgSrcRecords::Parser *Last = 0;
  884. SPtr<pkgSrcRecords::Parser> LastOwner;
  885. // an unpacked debian source tree
  886. using APT::String::Startswith;
  887. if ((Startswith(*I, "./") || Startswith(*I, "/")) &&
  888. DirectoryExists(*I))
  889. {
  890. ioprintf(c1out, _("Note, using directory '%s' to get the build dependencies\n"), *I);
  891. // FIXME: how can we make this more elegant?
  892. std::string TypeName = "Debian control file";
  893. pkgIndexFile::Type *Type = pkgIndexFile::Type::GetType(TypeName.c_str());
  894. if(Type != NULL)
  895. LastOwner = Last = Type->CreateSrcPkgParser(*I);
  896. }
  897. // if its a local file (e.g. .dsc) use this
  898. else if (FileExists(*I))
  899. {
  900. ioprintf(c1out, _("Note, using file '%s' to get the build dependencies\n"), *I);
  901. // see if we can get a parser for this pkgIndexFile type
  902. string TypeName = "Debian " + flExtension(*I) + " file";
  903. pkgIndexFile::Type *Type = pkgIndexFile::Type::GetType(TypeName.c_str());
  904. if(Type != NULL)
  905. LastOwner = Last = Type->CreateSrcPkgParser(*I);
  906. } else {
  907. // normal case, search the cache for the source file
  908. Last = FindSrc(*I,SrcRecs,Src,Cache);
  909. }
  910. if (Last == 0)
  911. return _error->Error(_("Unable to find a source package for %s"),Src.c_str());
  912. // Process the build-dependencies
  913. vector<pkgSrcRecords::Parser::BuildDepRec> BuildDeps;
  914. // FIXME: Can't specify architecture to use for [wildcard] matching, so switch default arch temporary
  915. if (hostArch.empty() == false)
  916. {
  917. std::string nativeArch = _config->Find("APT::Architecture");
  918. _config->Set("APT::Architecture", hostArch);
  919. bool Success = Last->BuildDepends(BuildDeps, _config->FindB("APT::Get::Arch-Only", false), StripMultiArch);
  920. _config->Set("APT::Architecture", nativeArch);
  921. if (Success == false)
  922. return _error->Error(_("Unable to get build-dependency information for %s"),Src.c_str());
  923. }
  924. else if (Last->BuildDepends(BuildDeps, _config->FindB("APT::Get::Arch-Only", false), StripMultiArch) == false)
  925. return _error->Error(_("Unable to get build-dependency information for %s"),Src.c_str());
  926. // Also ensure that build-essential packages are present
  927. Configuration::Item const *Opts = _config->Tree("APT::Build-Essential");
  928. if (Opts)
  929. Opts = Opts->Child;
  930. for (; Opts; Opts = Opts->Next)
  931. {
  932. if (Opts->Value.empty() == true)
  933. continue;
  934. pkgSrcRecords::Parser::BuildDepRec rec;
  935. rec.Package = Opts->Value;
  936. rec.Type = pkgSrcRecords::Parser::BuildDependIndep;
  937. rec.Op = 0;
  938. BuildDeps.push_back(rec);
  939. }
  940. if (BuildDeps.empty() == true)
  941. {
  942. ioprintf(c1out,_("%s has no build depends.\n"),Src.c_str());
  943. continue;
  944. }
  945. // Install the requested packages
  946. vector <pkgSrcRecords::Parser::BuildDepRec>::iterator D;
  947. pkgProblemResolver Fix(Cache);
  948. bool skipAlternatives = false; // skip remaining alternatives in an or group
  949. for (D = BuildDeps.begin(); D != BuildDeps.end(); ++D)
  950. {
  951. bool hasAlternatives = (((*D).Op & pkgCache::Dep::Or) == pkgCache::Dep::Or);
  952. if (skipAlternatives == true)
  953. {
  954. /*
  955. * if there are alternatives, we've already picked one, so skip
  956. * the rest
  957. *
  958. * TODO: this means that if there's a build-dep on A|B and B is
  959. * installed, we'll still try to install A; more importantly,
  960. * if A is currently broken, we cannot go back and try B. To fix
  961. * this would require we do a Resolve cycle for each package we
  962. * add to the install list. Ugh
  963. */
  964. if (!hasAlternatives)
  965. skipAlternatives = false; // end of or group
  966. continue;
  967. }
  968. if ((*D).Type == pkgSrcRecords::Parser::BuildConflict ||
  969. (*D).Type == pkgSrcRecords::Parser::BuildConflictIndep)
  970. {
  971. pkgCache::GrpIterator Grp = Cache->FindGrp((*D).Package);
  972. // Build-conflicts on unknown packages are silently ignored
  973. if (Grp.end() == true)
  974. continue;
  975. for (pkgCache::PkgIterator Pkg = Grp.PackageList(); Pkg.end() == false; Pkg = Grp.NextPkg(Pkg))
  976. {
  977. pkgCache::VerIterator IV = (*Cache)[Pkg].InstVerIter(*Cache);
  978. /*
  979. * Remove if we have an installed version that satisfies the
  980. * version criteria
  981. */
  982. if (IV.end() == false &&
  983. Cache->VS().CheckDep(IV.VerStr(),(*D).Op,(*D).Version.c_str()) == true)
  984. TryToInstallBuildDep(Pkg,Cache,Fix,true,false);
  985. }
  986. }
  987. else // BuildDep || BuildDepIndep
  988. {
  989. if (_config->FindB("Debug::BuildDeps",false) == true)
  990. cout << "Looking for " << (*D).Package << "...\n";
  991. pkgCache::PkgIterator Pkg;
  992. // Cross-Building?
  993. if (StripMultiArch == false && D->Type != pkgSrcRecords::Parser::BuildDependIndep)
  994. {
  995. size_t const colon = D->Package.find(":");
  996. if (colon != string::npos)
  997. {
  998. if (strcmp(D->Package.c_str() + colon, ":any") == 0 || strcmp(D->Package.c_str() + colon, ":native") == 0)
  999. Pkg = Cache->FindPkg(D->Package.substr(0,colon));
  1000. else
  1001. Pkg = Cache->FindPkg(D->Package);
  1002. }
  1003. else
  1004. Pkg = Cache->FindPkg(D->Package, hostArch);
  1005. // a bad version either is invalid or doesn't satify dependency
  1006. #define BADVER(Ver) (Ver.end() == true || \
  1007. (D->Version.empty() == false && \
  1008. Cache->VS().CheckDep(Ver.VerStr(),D->Op,D->Version.c_str()) == false))
  1009. APT::VersionList verlist;
  1010. if (Pkg.end() == false)
  1011. {
  1012. pkgCache::VerIterator Ver = (*Cache)[Pkg].InstVerIter(*Cache);
  1013. if (BADVER(Ver) == false)
  1014. verlist.insert(Ver);
  1015. Ver = (*Cache)[Pkg].CandidateVerIter(*Cache);
  1016. if (BADVER(Ver) == false)
  1017. verlist.insert(Ver);
  1018. }
  1019. if (verlist.empty() == true)
  1020. {
  1021. pkgCache::PkgIterator BuildPkg = Cache->FindPkg(D->Package, "native");
  1022. if (BuildPkg.end() == false && Pkg != BuildPkg)
  1023. {
  1024. pkgCache::VerIterator Ver = (*Cache)[BuildPkg].InstVerIter(*Cache);
  1025. if (BADVER(Ver) == false)
  1026. verlist.insert(Ver);
  1027. Ver = (*Cache)[BuildPkg].CandidateVerIter(*Cache);
  1028. if (BADVER(Ver) == false)
  1029. verlist.insert(Ver);
  1030. }
  1031. }
  1032. #undef BADVER
  1033. string forbidden;
  1034. // We need to decide if host or build arch, so find a version we can look at
  1035. APT::VersionList::const_iterator Ver = verlist.begin();
  1036. for (; Ver != verlist.end(); ++Ver)
  1037. {
  1038. forbidden.clear();
  1039. if (Ver->MultiArch == pkgCache::Version::No || Ver->MultiArch == pkgCache::Version::All)
  1040. {
  1041. if (colon == string::npos)
  1042. Pkg = Ver.ParentPkg().Group().FindPkg(hostArch);
  1043. else if (strcmp(D->Package.c_str() + colon, ":any") == 0)
  1044. forbidden = "Multi-Arch: no";
  1045. else if (strcmp(D->Package.c_str() + colon, ":native") == 0)
  1046. Pkg = Ver.ParentPkg().Group().FindPkg("native");
  1047. }
  1048. else if (Ver->MultiArch == pkgCache::Version::Same)
  1049. {
  1050. if (colon == string::npos)
  1051. Pkg = Ver.ParentPkg().Group().FindPkg(hostArch);
  1052. else if (strcmp(D->Package.c_str() + colon, ":any") == 0)
  1053. forbidden = "Multi-Arch: same";
  1054. else if (strcmp(D->Package.c_str() + colon, ":native") == 0)
  1055. Pkg = Ver.ParentPkg().Group().FindPkg("native");
  1056. }
  1057. else if ((Ver->MultiArch & pkgCache::Version::Foreign) == pkgCache::Version::Foreign)
  1058. {
  1059. if (colon == string::npos)
  1060. Pkg = Ver.ParentPkg().Group().FindPkg("native");
  1061. else if (strcmp(D->Package.c_str() + colon, ":any") == 0 ||
  1062. strcmp(D->Package.c_str() + colon, ":native") == 0)
  1063. forbidden = "Multi-Arch: foreign";
  1064. }
  1065. else if ((Ver->MultiArch & pkgCache::Version::Allowed) == pkgCache::Version::Allowed)
  1066. {
  1067. if (colon == string::npos)
  1068. Pkg = Ver.ParentPkg().Group().FindPkg(hostArch);
  1069. else if (strcmp(D->Package.c_str() + colon, ":any") == 0)
  1070. {
  1071. // prefer any installed over preferred non-installed architectures
  1072. pkgCache::GrpIterator Grp = Ver.ParentPkg().Group();
  1073. // we don't check for version here as we are better of with upgrading than remove and install
  1074. for (Pkg = Grp.PackageList(); Pkg.end() == false; Pkg = Grp.NextPkg(Pkg))
  1075. if (Pkg.CurrentVer().end() == false)
  1076. break;
  1077. if (Pkg.end() == true)
  1078. Pkg = Grp.FindPreferredPkg(true);
  1079. }
  1080. else if (strcmp(D->Package.c_str() + colon, ":native") == 0)
  1081. Pkg = Ver.ParentPkg().Group().FindPkg("native");
  1082. }
  1083. if (forbidden.empty() == false)
  1084. {
  1085. if (_config->FindB("Debug::BuildDeps",false) == true)
  1086. cout << D->Package.substr(colon, string::npos) << " is not allowed from " << forbidden << " package " << (*D).Package << " (" << Ver.VerStr() << ")" << endl;
  1087. continue;
  1088. }
  1089. //we found a good version
  1090. break;
  1091. }
  1092. if (Ver == verlist.end())
  1093. {
  1094. if (_config->FindB("Debug::BuildDeps",false) == true)
  1095. cout << " No multiarch info as we have no satisfying installed nor candidate for " << D->Package << " on build or host arch" << endl;
  1096. if (forbidden.empty() == false)
  1097. {
  1098. if (hasAlternatives)
  1099. continue;
  1100. return _error->Error(_("%s dependency for %s can't be satisfied "
  1101. "because %s is not allowed on '%s' packages"),
  1102. Last->BuildDepType(D->Type), Src.c_str(),
  1103. D->Package.c_str(), forbidden.c_str());
  1104. }
  1105. }
  1106. }
  1107. else
  1108. Pkg = Cache->FindPkg(D->Package);
  1109. if (Pkg.end() == true || (Pkg->VersionList == 0 && Pkg->ProvidesList == 0))
  1110. {
  1111. if (_config->FindB("Debug::BuildDeps",false) == true)
  1112. cout << " (not found)" << (*D).Package << endl;
  1113. if (hasAlternatives)
  1114. continue;
  1115. return _error->Error(_("%s dependency for %s cannot be satisfied "
  1116. "because the package %s cannot be found"),
  1117. Last->BuildDepType((*D).Type),Src.c_str(),
  1118. (*D).Package.c_str());
  1119. }
  1120. pkgCache::VerIterator IV = (*Cache)[Pkg].InstVerIter(*Cache);
  1121. if (IV.end() == false)
  1122. {
  1123. if (_config->FindB("Debug::BuildDeps",false) == true)
  1124. cout << " Is installed\n";
  1125. if (D->Version.empty() == true ||
  1126. Cache->VS().CheckDep(IV.VerStr(),(*D).Op,(*D).Version.c_str()) == true)
  1127. {
  1128. skipAlternatives = hasAlternatives;
  1129. continue;
  1130. }
  1131. if (_config->FindB("Debug::BuildDeps",false) == true)
  1132. cout << " ...but the installed version doesn't meet the version requirement\n";
  1133. if (((*D).Op & pkgCache::Dep::LessEq) == pkgCache::Dep::LessEq)
  1134. return _error->Error(_("Failed to satisfy %s dependency for %s: Installed package %s is too new"),
  1135. Last->BuildDepType((*D).Type), Src.c_str(), Pkg.FullName(true).c_str());
  1136. }
  1137. // Only consider virtual packages if there is no versioned dependency
  1138. if ((*D).Version.empty() == true)
  1139. {
  1140. /*
  1141. * If this is a virtual package, we need to check the list of
  1142. * packages that provide it and see if any of those are
  1143. * installed
  1144. */
  1145. pkgCache::PrvIterator Prv = Pkg.ProvidesList();
  1146. for (; Prv.end() != true; ++Prv)
  1147. {
  1148. if (_config->FindB("Debug::BuildDeps",false) == true)
  1149. cout << " Checking provider " << Prv.OwnerPkg().FullName() << endl;
  1150. if ((*Cache)[Prv.OwnerPkg()].InstVerIter(*Cache).end() == false)
  1151. break;
  1152. }
  1153. if (Prv.end() == false)
  1154. {
  1155. if (_config->FindB("Debug::BuildDeps",false) == true)
  1156. cout << " Is provided by installed package " << Prv.OwnerPkg().FullName() << endl;
  1157. skipAlternatives = hasAlternatives;
  1158. continue;
  1159. }
  1160. }
  1161. else // versioned dependency
  1162. {
  1163. pkgCache::VerIterator CV = (*Cache)[Pkg].CandidateVerIter(*Cache);
  1164. if (CV.end() == true ||
  1165. Cache->VS().CheckDep(CV.VerStr(),(*D).Op,(*D).Version.c_str()) == false)
  1166. {
  1167. if (hasAlternatives)
  1168. continue;
  1169. else if (CV.end() == false)
  1170. return _error->Error(_("%s dependency for %s cannot be satisfied "
  1171. "because candidate version of package %s "
  1172. "can't satisfy version requirements"),
  1173. Last->BuildDepType(D->Type), Src.c_str(),
  1174. D->Package.c_str());
  1175. else
  1176. return _error->Error(_("%s dependency for %s cannot be satisfied "
  1177. "because package %s has no candidate version"),
  1178. Last->BuildDepType(D->Type), Src.c_str(),
  1179. D->Package.c_str());
  1180. }
  1181. }
  1182. if (TryToInstallBuildDep(Pkg,Cache,Fix,false,false,false) == true)
  1183. {
  1184. // We successfully installed something; skip remaining alternatives
  1185. skipAlternatives = hasAlternatives;
  1186. if(_config->FindB("APT::Get::Build-Dep-Automatic", false) == true)
  1187. Cache->MarkAuto(Pkg, true);
  1188. continue;
  1189. }
  1190. else if (hasAlternatives)
  1191. {
  1192. if (_config->FindB("Debug::BuildDeps",false) == true)
  1193. cout << " Unsatisfiable, trying alternatives\n";
  1194. continue;
  1195. }
  1196. else
  1197. {
  1198. return _error->Error(_("Failed to satisfy %s dependency for %s: %s"),
  1199. Last->BuildDepType((*D).Type),
  1200. Src.c_str(),
  1201. (*D).Package.c_str());
  1202. }
  1203. }
  1204. }
  1205. if (Fix.Resolve(true) == false)
  1206. _error->Discard();
  1207. // Now we check the state of the packages,
  1208. if (Cache->BrokenCount() != 0)
  1209. {
  1210. ShowBroken(cout, Cache, false);
  1211. return _error->Error(_("Build-dependencies for %s could not be satisfied."),*I);
  1212. }
  1213. }
  1214. if (InstallPackages(Cache, false, true) == false)
  1215. return _error->Error(_("Failed to process build dependencies"));
  1216. return true;
  1217. }
  1218. /*}}}*/
  1219. // DoChangelog - Get changelog from the command line /*{{{*/
  1220. static bool DoChangelog(CommandLine &CmdL)
  1221. {
  1222. CacheFile Cache;
  1223. if (Cache.ReadOnlyOpen() == false)
  1224. return false;
  1225. APT::CacheSetHelper helper;
  1226. APT::VersionList verset = APT::VersionList::FromCommandLine(Cache,
  1227. CmdL.FileList + 1, APT::CacheSetHelper::CANDIDATE, helper);
  1228. if (verset.empty() == true)
  1229. return false;
  1230. pkgAcquire Fetcher;
  1231. AcqTextStatus Stat(std::cout, ScreenWidth,_config->FindI("quiet",0));
  1232. Fetcher.SetLog(&Stat);
  1233. bool const downOnly = _config->FindB("APT::Get::Download-Only", false);
  1234. bool const printOnly = _config->FindB("APT::Get::Print-URIs", false);
  1235. for (APT::VersionList::const_iterator Ver = verset.begin();
  1236. Ver != verset.end();
  1237. ++Ver)
  1238. {
  1239. if (printOnly)
  1240. new pkgAcqChangelog(&Fetcher, Ver, "/dev/null");
  1241. else if (downOnly)
  1242. new pkgAcqChangelog(&Fetcher, Ver, ".");
  1243. else
  1244. new pkgAcqChangelog(&Fetcher, Ver);
  1245. }
  1246. if (printOnly == false)
  1247. {
  1248. // Disable drop-privs if "_apt" can not write to the target dir
  1249. CheckDropPrivsMustBeDisabled(Fetcher);
  1250. if (_error->PendingError() == true)
  1251. return false;
  1252. bool Failed = false;
  1253. if (AcquireRun(Fetcher, 0, &Failed, NULL) == false || Failed == true)
  1254. return false;
  1255. }
  1256. if (downOnly == false || printOnly == true)
  1257. {
  1258. bool Failed = false;
  1259. for (pkgAcquire::ItemIterator I = Fetcher.ItemsBegin(); I != Fetcher.ItemsEnd(); ++I)
  1260. {
  1261. if (printOnly)
  1262. {
  1263. if ((*I)->ErrorText.empty() == false)
  1264. {
  1265. Failed = true;
  1266. _error->Error("%s", (*I)->ErrorText.c_str());
  1267. }
  1268. else
  1269. cout << '\'' << (*I)->DescURI() << "' " << flNotDir((*I)->DestFile) << std::endl;
  1270. }
  1271. else
  1272. DisplayFileInPager((*I)->DestFile);
  1273. }
  1274. return Failed == false;
  1275. }
  1276. return true;
  1277. }
  1278. /*}}}*/
  1279. // DoIndexTargets - Lists all IndexTargets /*{{{*/
  1280. static std::string format_key(std::string key)
  1281. {
  1282. // deb822 is case-insensitive, but the human eye prefers candy
  1283. std::transform(key.begin(), key.end(), key.begin(), ::tolower);
  1284. key[0] = ::toupper(key[0]);
  1285. size_t found = key.find("_uri");
  1286. if (found != std::string::npos)
  1287. key.replace(found, 4, "-URI");
  1288. while ((found = key.find('_')) != std::string::npos)
  1289. {
  1290. key[found] = '-';
  1291. key[found + 1] = ::toupper(key[found + 1]);
  1292. }
  1293. return key;
  1294. }
  1295. static bool DoIndexTargets(CommandLine &CmdL)
  1296. {
  1297. pkgCacheFile CacheFile;
  1298. pkgSourceList *SrcList = CacheFile.GetSourceList();
  1299. if (SrcList == NULL)
  1300. return false;
  1301. std::string const Format = _config->Find("APT::Get::IndexTargets::Format");
  1302. bool const ReleaseInfo = _config->FindB("APT::Get::IndexTargets::ReleaseInfo", true);
  1303. bool Filtered = CmdL.FileSize() > 1;
  1304. for (pkgSourceList::const_iterator S = SrcList->begin(); S != SrcList->end(); ++S)
  1305. {
  1306. std::vector<IndexTarget> const targets = (*S)->GetIndexTargets();
  1307. std::map<std::string, string> AddOptions;
  1308. if (ReleaseInfo)
  1309. {
  1310. AddOptions.insert(std::make_pair("TRUSTED", ((*S)->IsTrusted() ? "yes" : "no")));
  1311. pkgCache &Cache = *CacheFile.GetPkgCache();
  1312. pkgCache::RlsFileIterator const RlsFile = (*S)->FindInCache(Cache, false);
  1313. if (RlsFile.end())
  1314. continue;
  1315. #define APT_RELEASE(X,Y) if (RlsFile.Y() != NULL) AddOptions.insert(std::make_pair(X, RlsFile.Y()))
  1316. APT_RELEASE("CODENAME", Codename);
  1317. APT_RELEASE("SUITE", Archive);
  1318. APT_RELEASE("VERSION", Version);
  1319. APT_RELEASE("ORIGIN", Origin);
  1320. APT_RELEASE("LABEL", Label);
  1321. #undef APT_RELEASE
  1322. }
  1323. for (std::vector<IndexTarget>::const_iterator T = targets.begin(); T != targets.end(); ++T)
  1324. {
  1325. std::string filename = T->Option(ReleaseInfo ? IndexTarget::EXISTING_FILENAME : IndexTarget::FILENAME);
  1326. if (filename.empty())
  1327. continue;
  1328. std::ostringstream stanza;
  1329. if (Filtered || Format.empty())
  1330. {
  1331. stanza << "MetaKey: " << T->MetaKey << "\n"
  1332. << "ShortDesc: " << T->ShortDesc << "\n"
  1333. << "Description: " << T->Description << "\n"
  1334. << "URI: " << T->URI << "\n"
  1335. << "Filename: " << filename << "\n"
  1336. << "Optional: " << (T->IsOptional ? "yes" : "no") << "\n";
  1337. for (std::map<std::string,std::string>::const_iterator O = AddOptions.begin(); O != AddOptions.end(); ++O)
  1338. stanza << format_key(O->first) << ": " << O->second << "\n";
  1339. for (std::map<std::string,std::string>::const_iterator O = T->Options.begin(); O != T->Options.end(); ++O)
  1340. stanza << format_key(O->first) << ": " << O->second << "\n";
  1341. stanza << "\n";
  1342. if (Filtered)
  1343. {
  1344. // that is a bit crude, but good enough for now
  1345. bool found = true;
  1346. std::string haystack = std::string("\n") + stanza.str() + "\n";
  1347. std::transform(haystack.begin(), haystack.end(), haystack.begin(), ::tolower);
  1348. size_t const filesize = CmdL.FileSize() - 1;
  1349. for (size_t i = 0; i != filesize; ++i)
  1350. {
  1351. std::string needle = std::string("\n") + CmdL.FileList[i + 1] + "\n";
  1352. std::transform(needle.begin(), needle.end(), needle.begin(), ::tolower);
  1353. if (haystack.find(needle) != std::string::npos)
  1354. continue;
  1355. found = false;
  1356. break;
  1357. }
  1358. if (found == false)
  1359. continue;
  1360. }
  1361. }
  1362. if (Format.empty())
  1363. cout << stanza.str();
  1364. else
  1365. {
  1366. std::string out = SubstVar(Format, "$(FILENAME)", filename);
  1367. out = T->Format(out);
  1368. for (std::map<std::string,std::string>::const_iterator O = AddOptions.begin(); O != AddOptions.end(); ++O)
  1369. out = SubstVar(out, std::string("$(") + O->first + ")", O->second);
  1370. cout << out << std::endl;
  1371. }
  1372. }
  1373. }
  1374. return true;
  1375. }
  1376. /*}}}*/
  1377. // ShowHelp - Show a help screen /*{{{*/
  1378. // ---------------------------------------------------------------------
  1379. /* */
  1380. static bool ShowHelp(CommandLine &)
  1381. {
  1382. ioprintf(cout, "%s %s (%s)\n", PACKAGE, PACKAGE_VERSION, COMMON_ARCH);
  1383. if (_config->FindB("version") == true)
  1384. {
  1385. cout << _("Supported modules:") << endl;
  1386. for (unsigned I = 0; I != pkgVersioningSystem::GlobalListLen; I++)
  1387. {
  1388. pkgVersioningSystem *VS = pkgVersioningSystem::GlobalList[I];
  1389. if (_system != 0 && _system->VS == VS)
  1390. cout << '*';
  1391. else
  1392. cout << ' ';
  1393. cout << "Ver: " << VS->Label << endl;
  1394. /* Print out all the packaging systems that will work with
  1395. this VS */
  1396. for (unsigned J = 0; J != pkgSystem::GlobalListLen; J++)
  1397. {
  1398. pkgSystem *Sys = pkgSystem::GlobalList[J];
  1399. if (_system == Sys)
  1400. cout << '*';
  1401. else
  1402. cout << ' ';
  1403. if (Sys->VS->TestCompatibility(*VS) == true)
  1404. cout << "Pkg: " << Sys->Label << " (Priority " << Sys->Score(*_config) << ")" << endl;
  1405. }
  1406. }
  1407. for (unsigned I = 0; I != pkgSourceList::Type::GlobalListLen; I++)
  1408. {
  1409. pkgSourceList::Type *Type = pkgSourceList::Type::GlobalList[I];
  1410. cout << " S.L: '" << Type->Name << "' " << Type->Label << endl;
  1411. }
  1412. for (unsigned I = 0; I != pkgIndexFile::Type::GlobalListLen; I++)
  1413. {
  1414. pkgIndexFile::Type *Type = pkgIndexFile::Type::GlobalList[I];
  1415. cout << " Idx: " << Type->Label << endl;
  1416. }
  1417. return true;
  1418. }
  1419. cout <<
  1420. _("Usage: apt-get [options] command\n"
  1421. " apt-get [options] install|remove pkg1 [pkg2 ...]\n"
  1422. " apt-get [options] source pkg1 [pkg2 ...]\n"
  1423. "\n"
  1424. "apt-get is a simple command line interface for downloading and\n"
  1425. "installing packages. The most frequently used commands are update\n"
  1426. "and install.\n"
  1427. "\n"
  1428. "Commands:\n"
  1429. " update - Retrieve new lists of packages\n"
  1430. " upgrade - Perform an upgrade\n"
  1431. " install - Install new packages (pkg is libc6 not libc6.deb)\n"
  1432. " remove - Remove packages\n"
  1433. " autoremove - Remove automatically all unused packages\n"
  1434. " purge - Remove packages and config files\n"
  1435. " source - Download source archives\n"
  1436. " build-dep - Configure build-dependencies for source packages\n"
  1437. " dist-upgrade - Distribution upgrade, see apt-get(8)\n"
  1438. " dselect-upgrade - Follow dselect selections\n"
  1439. " clean - Erase downloaded archive files\n"
  1440. " autoclean - Erase old downloaded archive files\n"
  1441. " check - Verify that there are no broken dependencies\n"
  1442. " changelog - Download and display the changelog for the given package\n"
  1443. " download - Download the binary package into the current directory\n"
  1444. "\n"
  1445. "Options:\n"
  1446. " -h This help text.\n"
  1447. " -q Loggable output - no progress indicator\n"
  1448. " -qq No output except for errors\n"
  1449. " -d Download only - do NOT install or unpack archives\n"
  1450. " -s No-act. Perform ordering simulation\n"
  1451. " -y Assume Yes to all queries and do not prompt\n"
  1452. " -f Attempt to correct a system with broken dependencies in place\n"
  1453. " -m Attempt to continue if archives are unlocatable\n"
  1454. " -u Show a list of upgraded packages as well\n"
  1455. " -b Build the source package after fetching it\n"
  1456. " -V Show verbose version numbers\n"
  1457. " -c=? Read this configuration file\n"
  1458. " -o=? Set an arbitrary configuration option, eg -o dir::cache=/tmp\n"
  1459. "See the apt-get(8), sources.list(5) and apt.conf(5) manual\n"
  1460. "pages for more information and options.\n"
  1461. " This APT has Super Cow Powers.\n");
  1462. return true;
  1463. }
  1464. /*}}}*/
  1465. int main(int argc,const char *argv[]) /*{{{*/
  1466. {
  1467. CommandLine::Dispatch Cmds[] = {{"update",&DoUpdate},
  1468. {"upgrade",&DoUpgrade},
  1469. {"install",&DoInstall},
  1470. {"remove",&DoInstall},
  1471. {"purge",&DoInstall},
  1472. {"autoremove",&DoInstall},
  1473. {"markauto",&DoMarkAuto},
  1474. {"unmarkauto",&DoMarkAuto},
  1475. {"dist-upgrade",&DoDistUpgrade},
  1476. {"dselect-upgrade",&DoDSelectUpgrade},
  1477. {"build-dep",&DoBuildDep},
  1478. {"clean",&DoClean},
  1479. {"autoclean",&DoAutoClean},
  1480. {"check",&DoCheck},
  1481. {"source",&DoSource},
  1482. {"download",&DoDownload},
  1483. {"changelog",&DoChangelog},
  1484. {"indextargets",&DoIndexTargets},
  1485. {"moo",&DoMoo},
  1486. {"help",&ShowHelp},
  1487. {0,0}};
  1488. std::vector<CommandLine::Args> Args = getCommandArgs("apt-get", CommandLine::GetCommand(Cmds, argc, argv));
  1489. // Set up gettext support
  1490. setlocale(LC_ALL,"");
  1491. textdomain(PACKAGE);
  1492. // Parse the command line and initialize the package library
  1493. CommandLine CmdL;
  1494. ParseCommandLine(CmdL, Cmds, Args.data(), &_config, &_system, argc, argv, ShowHelp);
  1495. // see if we are in simulate mode
  1496. CheckSimulateMode(CmdL);
  1497. // Init the signals
  1498. InitSignals();
  1499. // Setup the output streams
  1500. InitOutput();
  1501. // Match the operation
  1502. CmdL.DispatchArg(Cmds);
  1503. // Print any errors or warnings found during parsing
  1504. bool const Errors = _error->PendingError();
  1505. if (_config->FindI("quiet",0) > 0)
  1506. _error->DumpErrors();
  1507. else
  1508. _error->DumpErrors(GlobalError::DEBUG);
  1509. return Errors == true ? 100 : 0;
  1510. }
  1511. /*}}}*/