[ntk/apt.git] / apt-pkg / policy.cc

// -*- mode: cpp; mode: fold -*-
// Description								/*{{{*/
// $Id: policy.cc,v 1.10 2003/08/12 00:17:37 mdz Exp $
/* ######################################################################

   Package Version Policy implementation
   
   This is just a really simple wrapper around pkgVersionMatch with
   some added goodies to manage the list of things..
   
   Priority Table:
   
   1000 -> inf = Downgradeable priorities
   1000        = The 'no downgrade' pseduo-status file
   100 -> 1000 = Standard priorities
   990         = Config file override package files
   989         = Start for preference auto-priorities
   500         = Default package files
   100         = The status file and ButAutomaticUpgrades sources
   0 -> 100    = NotAutomatic sources like experimental
   -inf -> 0   = Never selected   
   
   ##################################################################### */
									/*}}}*/
// Include Files							/*{{{*/
#include <apt-pkg/policy.h>
#include <apt-pkg/configuration.h>
#include <apt-pkg/tagfile.h>
#include <apt-pkg/strutl.h>
#include <apt-pkg/fileutl.h>
#include <apt-pkg/error.h>
#include <apt-pkg/sptr.h>

#include <apti18n.h>

#include <iostream>
#include <sstream>
									/*}}}*/

using namespace std;

// Policy::Init - Startup and bind to a cache				/*{{{*/
// ---------------------------------------------------------------------
/* Set the defaults for operation. The default mode with no loaded policy
   file matches the V0 policy engine. */
pkgPolicy::pkgPolicy(pkgCache *Owner) : Pins(0), PFPriority(0), Cache(Owner)
{
   if (Owner == 0 || &(Owner->Head()) == 0)
      return;
   PFPriority = new signed short[Owner->Head().PackageFileCount];
   Pins = new Pin[Owner->Head().PackageCount];

   for (unsigned long I = 0; I != Owner->Head().PackageCount; I++)
      Pins[I].Type = pkgVersionMatch::None;

   // The config file has a master override.
   string DefRel = _config->Find("APT::Default-Release");
   if (DefRel.empty() == false)
      CreatePin(pkgVersionMatch::Release,"",DefRel,990);
      
   InitDefaults();
}
									/*}}}*/
// Policy::InitDefaults - Compute the default selections		/*{{{*/
// ---------------------------------------------------------------------
/* */
bool pkgPolicy::InitDefaults()
{   
   // Initialize the priorities based on the status of the package file
   for (pkgCache::PkgFileIterator I = Cache->FileBegin(); I != Cache->FileEnd(); I++)
   {
      PFPriority[I->ID] = 500;
      if ((I->Flags & pkgCache::Flag::NotSource) == pkgCache::Flag::NotSource)
	 PFPriority[I->ID] = 100;
      else if ((I->Flags & pkgCache::Flag::ButAutomaticUpgrades) == pkgCache::Flag::ButAutomaticUpgrades)
	 PFPriority[I->ID] = 100;
      else if ((I->Flags & pkgCache::Flag::NotAutomatic) == pkgCache::Flag::NotAutomatic)
	 PFPriority[I->ID] = 1;
   }

   // Apply the defaults..
   SPtrArray<bool> Fixed = new bool[Cache->HeaderP->PackageFileCount];
   memset(Fixed,0,sizeof(*Fixed)*Cache->HeaderP->PackageFileCount);
   signed Cur = 989;
   StatusOverride = false;
   for (vector<Pin>::const_iterator I = Defaults.begin(); I != Defaults.end();
	I++, Cur--)
   {
      pkgVersionMatch Match(I->Data,I->Type);
      for (pkgCache::PkgFileIterator F = Cache->FileBegin(); F != Cache->FileEnd(); F++)
      {
	 if (Match.FileMatch(F) == true && Fixed[F->ID] == false)
	 {
	    if (I->Priority != 0 && I->Priority > 0)
	       Cur = I->Priority;
	    
	    if (I->Priority < 0)
	       PFPriority[F->ID] =  I->Priority;
	    else
	       PFPriority[F->ID] = Cur;
	    
	    if (PFPriority[F->ID] > 1000)
	       StatusOverride = true;
	    
	    Fixed[F->ID] = true;
	 }      
      }      
   }

   if (_config->FindB("Debug::pkgPolicy",false) == true)
      for (pkgCache::PkgFileIterator F = Cache->FileBegin(); F != Cache->FileEnd(); F++)
	 std::clog << "Prio of " << F.FileName() << ' ' << PFPriority[F->ID] << std::endl; 
   
   return true;   
}
									/*}}}*/
// Policy::GetCandidateVer - Get the candidate install version		/*{{{*/
// ---------------------------------------------------------------------
/* Evaluate the package pins and the default list to deteremine what the
   best package is. */
pkgCache::VerIterator pkgPolicy::GetCandidateVer(pkgCache::PkgIterator const &Pkg)
{
   // Look for a package pin and evaluate it.
   signed Max = GetPriority(Pkg);
   pkgCache::VerIterator Pref = GetMatch(Pkg);

   // Alternatives in case we can not find our package pin (Bug#512318).
   signed MaxAlt = 0;
   pkgCache::VerIterator PrefAlt;

   // no package = no candidate version
   if (Pkg.end() == true)
      return Pref;

   // packages with a pin lower than 0 have no newer candidate than the current version
   if (Max < 0)
      return Pkg.CurrentVer();

   /* Falling through to the default version.. Setting Max to zero
      effectively excludes everything <= 0 which are the non-automatic
      priorities.. The status file is given a prio of 100 which will exclude
      not-automatic sources, except in a single shot not-installed mode.
      The second pseduo-status file is at prio 1000, above which will permit
      the user to force-downgrade things.
      
      The user pin is subject to the same priority rules as default 
      selections. Thus there are two ways to create a pin - a pin that
      tracks the default when the default is taken away, and a permanent
      pin that stays at that setting.
    */
   for (pkgCache::VerIterator Ver = Pkg.VersionList(); Ver.end() == false; Ver++)
   {
      /* Lets see if this version is the installed version */
      bool instVer = (Pkg.CurrentVer() == Ver);

      for (pkgCache::VerFileIterator VF = Ver.FileList(); VF.end() == false; VF++)
      {
	 /* If this is the status file, and the current version is not the
	    version in the status file (ie it is not installed, or somesuch)
	    then it is not a candidate for installation, ever. This weeds
	    out bogus entries that may be due to config-file states, or
	    other. */
	 if ((VF.File()->Flags & pkgCache::Flag::NotSource) == pkgCache::Flag::NotSource &&
	     instVer == false)
	    continue;

	 signed Prio = PFPriority[VF.File()->ID];
	 if (Prio > Max)
	 {
	    Pref = Ver;
	    Max = Prio;
	 }
	 if (Prio > MaxAlt)
	 {
	    PrefAlt = Ver;
	    MaxAlt = Prio;
	 }	 
      }      
      
      if (instVer == true && Max < 1000)
      {
	 /* Elevate our current selection (or the status file itself)
	    to the Pseudo-status priority. */
	 if (Pref.end() == true)
	    Pref = Ver;
	 Max = 1000;
	 
	 // Fast path optimize.
	 if (StatusOverride == false)
	    break;
      }            
   }
   // If we do not find our candidate, use the one with the highest pin.
   // This means that if there is a version available with pin > 0; there
   // will always be a candidate (Closes: #512318)
   if (!Pref.IsGood() && MaxAlt > 0)
       Pref = PrefAlt;

   return Pref;
}
									/*}}}*/
// Policy::CreatePin - Create an entry in the pin table..		/*{{{*/
// ---------------------------------------------------------------------
/* For performance we have 3 tables, the default table, the main cache
   table (hashed to the cache). A blank package name indicates the pin
   belongs to the default table. Order of insertion matters here, the
   earlier defaults override later ones. */
void pkgPolicy::CreatePin(pkgVersionMatch::MatchType Type,string Name,
			  string Data,signed short Priority)
{
   if (Name.empty() == true)
   {
      Pin *P = &*Defaults.insert(Defaults.end(),PkgPin());
      P->Type = Type;
      P->Priority = Priority;
      P->Data = Data;
      return;
   }
   
   // Allow pinning by wildcards
   // TODO: Maybe we should always prefer specific pins over non-
   // specific ones.
   if (Name.find("*") != string::npos || Name.find("[") != string::npos
       || Name.find("?") != string::npos || Name[0] == '/') {
	  pkgVersionMatch match(Data, Type);
	  for (pkgCache::PkgIterator P = Cache->PkgBegin();
	       P != Cache->PkgEnd(); P++) {
		  if (match.ExpressionMatches(Name, P.Name())) {
			CreatePin(Type, P.Name(), Data, Priority);
		  }  
      }
      return;
   }

   // Get a spot to put the pin
   pkgCache::GrpIterator Grp = Cache->FindGrp(Name);
   for (pkgCache::PkgIterator Pkg = Grp.FindPkg("any");
	Pkg.end() != true; Pkg = Grp.NextPkg(Pkg))
   {
      Pin *P = 0;
      if (Pkg.end() == false)
	 P = Pins + Pkg->ID;
      else
      {
	 // Check the unmatched table
	 for (vector<PkgPin>::iterator I = Unmatched.begin();
	      I != Unmatched.end() && P == 0; I++)
	    if (I->Pkg == Name)
	       P = &*I;

	 if (P == 0)
	    P = &*Unmatched.insert(Unmatched.end(),PkgPin());
      }
      P->Type = Type;
      P->Priority = Priority;
      P->Data = Data;
   }
}
									/*}}}*/
// Policy::GetMatch - Get the matching version for a package pin	/*{{{*/
// ---------------------------------------------------------------------
/* */
pkgCache::VerIterator pkgPolicy::GetMatch(pkgCache::PkgIterator const &Pkg)
{
   const Pin &PPkg = Pins[Pkg->ID];
   if (PPkg.Type == pkgVersionMatch::None)
      return pkgCache::VerIterator(*Pkg.Cache());

   pkgVersionMatch Match(PPkg.Data,PPkg.Type);
   return Match.Find(Pkg);
}
									/*}}}*/
// Policy::GetPriority - Get the priority of the package pin		/*{{{*/
// ---------------------------------------------------------------------
/* */
signed short pkgPolicy::GetPriority(pkgCache::PkgIterator const &Pkg)
{
   if (Pins[Pkg->ID].Type != pkgVersionMatch::None)
   {
      // In this case 0 means default priority
      if (Pins[Pkg->ID].Priority == 0)
	 return 989;
      return Pins[Pkg->ID].Priority;
   }
   
   return 0;
}
									/*}}}*/
// PreferenceSection class - Overriding the default TrimRecord method	/*{{{*/
// ---------------------------------------------------------------------
/* The preference file is a user generated file so the parser should
   therefore be a bit more friendly by allowing comments and new lines
   all over the place rather than forcing a special format */
class PreferenceSection : public pkgTagSection
{
   void TrimRecord(bool BeforeRecord, const char* &End)
   {
      for (; Stop < End && (Stop[0] == '\n' || Stop[0] == '\r' || Stop[0] == '#'); Stop++)
	 if (Stop[0] == '#')
	    Stop = (const char*) memchr(Stop,'\n',End-Stop);
   }
};
									/*}}}*/
// ReadPinDir - Load the pin files from this dir into a Policy		/*{{{*/
// ---------------------------------------------------------------------
/* This will load each pin file in the given dir into a Policy. If the
   given dir is empty the dir set in Dir::Etc::PreferencesParts is used.
   Note also that this method will issue a warning if the dir does not
   exists but it will return true in this case! */
bool ReadPinDir(pkgPolicy &Plcy,string Dir)
{
   if (Dir.empty() == true)
      Dir = _config->FindDir("Dir::Etc::PreferencesParts");

   if (DirectoryExists(Dir) == false)
   {
      _error->WarningE("DirectoryExists",_("Unable to read %s"),Dir.c_str());
      return true;
   }

   vector<string> const List = GetListOfFilesInDir(Dir, "pref", true, true);

   // Read the files
   for (vector<string>::const_iterator I = List.begin(); I != List.end(); I++)
      if (ReadPinFile(Plcy, *I) == false)
	 return false;
   return true;
}
									/*}}}*/
// ReadPinFile - Load the pin file into a Policy			/*{{{*/
// ---------------------------------------------------------------------
/* I'd like to see the preferences file store more than just pin information
   but right now that is the only stuff I have to store. Later there will
   have to be some kind of combined super parser to get the data into all
   the right classes.. */
bool ReadPinFile(pkgPolicy &Plcy,string File)
{
   if (File.empty() == true)
      File = _config->FindFile("Dir::Etc::Preferences");

   if (RealFileExists(File) == false)
      return true;
   
   FileFd Fd(File,FileFd::ReadOnly);
   pkgTagFile TF(&Fd);
   if (_error->PendingError() == true)
      return false;
   
   PreferenceSection Tags;
   while (TF.Step(Tags) == true)
   {
      string Name = Tags.FindS("Package");
      if (Name.empty() == true)
	 return _error->Error(_("Invalid record in the preferences file %s, no Package header"), File.c_str());
      if (Name == "*")
	 Name = string();
      
      const char *Start;
      const char *End;
      if (Tags.Find("Pin",Start,End) == false)
	 continue;
	 
      const char *Word = Start;
      for (; Word != End && isspace(*Word) == 0; Word++);

      // Parse the type..
      pkgVersionMatch::MatchType Type;
      if (stringcasecmp(Start,Word,"version") == 0 && Name.empty() == false)
	 Type = pkgVersionMatch::Version;
      else if (stringcasecmp(Start,Word,"release") == 0)
	 Type = pkgVersionMatch::Release;
      else if (stringcasecmp(Start,Word,"origin") == 0)
	 Type = pkgVersionMatch::Origin;
      else
      {
	 _error->Warning(_("Did not understand pin type %s"),string(Start,Word).c_str());
	 continue;
      }
      for (; Word != End && isspace(*Word) != 0; Word++);

      short int priority = Tags.FindI("Pin-Priority", 0);
      if (priority == 0)
      {
         _error->Warning(_("No priority (or zero) specified for pin"));
         continue;
      }

      istringstream s(Name);
      string pkg;
      while(!s.eof())
      {
	 s >> pkg;
         Plcy.CreatePin(Type, pkg, string(Word,End),priority);
      };
   }

   Plcy.InitDefaults();
   return true;
}
									/*}}}*/
Commit	Line	Data
b2e465d6 AL	1	// -- mode: cpp; mode: fold --
b2e465d6 AL	2	// Description /{{{/
56298634	3	// $Id: policy.cc,v 1.10 2003/08/12 00:17:37 mdz Exp $
b2e465d6 AL	4	/* ######################################################################
	5
	6	Package Version Policy implementation
	7
	8	This is just a really simple wrapper around pkgVersionMatch with
	9	some added goodies to manage the list of things..
	10
	11	Priority Table:
	12
	13	1000 -> inf = Downgradeable priorities
	14	1000 = The 'no downgrade' pseduo-status file
	15	100 -> 1000 = Standard priorities
	16	990 = Config file override package files
	17	989 = Start for preference auto-priorities
	18	500 = Default package files
5ed56f93	19	100 = The status file and ButAutomaticUpgrades sources
b2e465d6 AL	20	0 -> 100 = NotAutomatic sources like experimental
	21	-inf -> 0 = Never selected
	22
	23	##################################################################### */
	24	/}}}/
	25	// Include Files /{{{/
b2e465d6 AL	26	#include <apt-pkg/policy.h>
	27	#include <apt-pkg/configuration.h>
	28	#include <apt-pkg/tagfile.h>
	29	#include <apt-pkg/strutl.h>
46e39c8e	30	#include <apt-pkg/fileutl.h>
b2e465d6 AL	31	#include <apt-pkg/error.h>
b2e465d6 AL	32	#include <apt-pkg/sptr.h>
46e39c8e	33
b2e465d6	34	#include <apti18n.h>
e7b470ee AL	35
e7b470ee AL	36	#include <iostream>
1c62ab24	37	#include <sstream>
b2e465d6 AL	38	/}}}/
b2e465d6 AL	39
e7b470ee AL	40	using namespace std;
e7b470ee AL	41
b2e465d6 AL	42	// Policy::Init - Startup and bind to a cache /{{{/
	43	// ---------------------------------------------------------------------
	44	/* Set the defaults for operation. The default mode with no loaded policy
	45	file matches the V0 policy engine. */
	46	pkgPolicy::pkgPolicy(pkgCache *Owner) : Pins(0), PFPriority(0), Cache(Owner)
	47	{
c55b8a54 DK	48	if (Owner == 0 \|\| &(Owner->Head()) == 0)
c55b8a54 DK	49	return;
b2e465d6 AL	50	PFPriority = new signed short[Owner->Head().PackageFileCount];
	51	Pins = new Pin[Owner->Head().PackageCount];
	52
	53	for (unsigned long I = 0; I != Owner->Head().PackageCount; I++)
	54	Pins[I].Type = pkgVersionMatch::None;
	55
	56	// The config file has a master override.
	57	string DefRel = _config->Find("APT::Default-Release");
	58	if (DefRel.empty() == false)
	59	CreatePin(pkgVersionMatch::Release,"",DefRel,990);
	60
	61	InitDefaults();
	62	}
	63	/}}}/
	64	// Policy::InitDefaults - Compute the default selections /{{{/
	65	// ---------------------------------------------------------------------
	66	/* */
	67	bool pkgPolicy::InitDefaults()
	68	{
	69	// Initialize the priorities based on the status of the package file
	70	for (pkgCache::PkgFileIterator I = Cache->FileBegin(); I != Cache->FileEnd(); I++)
	71	{
	72	PFPriority[I->ID] = 500;
	73	if ((I->Flags & pkgCache::Flag::NotSource) == pkgCache::Flag::NotSource)
	74	PFPriority[I->ID] = 100;
5ed56f93 DK	75	else if ((I->Flags & pkgCache::Flag::ButAutomaticUpgrades) == pkgCache::Flag::ButAutomaticUpgrades)
	76	PFPriority[I->ID] = 100;
	77	else if ((I->Flags & pkgCache::Flag::NotAutomatic) == pkgCache::Flag::NotAutomatic)
	78	PFPriority[I->ID] = 1;
b2e465d6 AL	79	}
	80
	81	// Apply the defaults..
20ebd488	82	SPtrArray<bool> Fixed = new bool[Cache->HeaderP->PackageFileCount];
b2e465d6 AL	83	memset(Fixed,0,sizeof(Fixed)Cache->HeaderP->PackageFileCount);
	84	signed Cur = 989;
	85	StatusOverride = false;
	86	for (vector<Pin>::const_iterator I = Defaults.begin(); I != Defaults.end();
	87	I++, Cur--)
	88	{
	89	pkgVersionMatch Match(I->Data,I->Type);
	90	for (pkgCache::PkgFileIterator F = Cache->FileBegin(); F != Cache->FileEnd(); F++)
	91	{
b2e465d6 AL	92	if (Match.FileMatch(F) == true && Fixed[F->ID] == false)
	93	{
	94	if (I->Priority != 0 && I->Priority > 0)
	95	Cur = I->Priority;
	96
	97	if (I->Priority < 0)
	98	PFPriority[F->ID] = I->Priority;
	99	else
	100	PFPriority[F->ID] = Cur;
	101
	102	if (PFPriority[F->ID] > 1000)
	103	StatusOverride = true;
	104
	105	Fixed[F->ID] = true;
	106	}
	107	}
	108	}
	109
	110	if (_config->FindB("Debug::pkgPolicy",false) == true)
	111	for (pkgCache::PkgFileIterator F = Cache->FileBegin(); F != Cache->FileEnd(); F++)
4dec007b	112	std::clog << "Prio of " << F.FileName() << ' ' << PFPriority[F->ID] << std::endl;
b2e465d6 AL	113
	114	return true;
	115	}
	116	/}}}/
	117	// Policy::GetCandidateVer - Get the candidate install version /{{{/
	118	// ---------------------------------------------------------------------
	119	/* Evaluate the package pins and the default list to deteremine what the
	120	best package is. */
9ee8287e	121	pkgCache::VerIterator pkgPolicy::GetCandidateVer(pkgCache::PkgIterator const &Pkg)
b2e465d6	122	{
b2e465d6	123	// Look for a package pin and evaluate it.
af87ab54 AL	124	signed Max = GetPriority(Pkg);
af87ab54 AL	125	pkgCache::VerIterator Pref = GetMatch(Pkg);
e7b470ee	126
8f5525e9 JAK	127	// Alternatives in case we can not find our package pin (Bug#512318).
	128	signed MaxAlt = 0;
	129	pkgCache::VerIterator PrefAlt;
	130
9f5bf66a DK	131	// no package = no candidate version
	132	if (Pkg.end() == true)
	133	return Pref;
	134
	135	// packages with a pin lower than 0 have no newer candidate than the current version
	136	if (Max < 0)
	137	return Pkg.CurrentVer();
	138
b2e465d6 AL	139	/* Falling through to the default version.. Setting Max to zero
	140	effectively excludes everything <= 0 which are the non-automatic
	141	priorities.. The status file is given a prio of 100 which will exclude
	142	not-automatic sources, except in a single shot not-installed mode.
	143	The second pseduo-status file is at prio 1000, above which will permit
	144	the user to force-downgrade things.
	145
	146	The user pin is subject to the same priority rules as default
	147	selections. Thus there are two ways to create a pin - a pin that
	148	tracks the default when the default is taken away, and a permanent
	149	pin that stays at that setting.
	150	*/
	151	for (pkgCache::VerIterator Ver = Pkg.VersionList(); Ver.end() == false; Ver++)
10639577	152	{
9ee8287e DK	153	/* Lets see if this version is the installed version */
9ee8287e DK	154	bool instVer = (Pkg.CurrentVer() == Ver);
9ee8287e	155
b2e465d6 AL	156	for (pkgCache::VerFileIterator VF = Ver.FileList(); VF.end() == false; VF++)
b2e465d6 AL	157	{
6aeda9fa AL	158	/* If this is the status file, and the current version is not the
	159	version in the status file (ie it is not installed, or somesuch)
	160	then it is not a candidate for installation, ever. This weeds
	161	out bogus entries that may be due to config-file states, or
	162	other. */
	163	if ((VF.File()->Flags & pkgCache::Flag::NotSource) == pkgCache::Flag::NotSource &&
9ee8287e	164	instVer == false)
6aeda9fa	165	continue;
9ee8287e	166
b2e465d6 AL	167	signed Prio = PFPriority[VF.File()->ID];
	168	if (Prio > Max)
	169	{
	170	Pref = Ver;
	171	Max = Prio;
8f5525e9 JAK	172	}
	173	if (Prio > MaxAlt)
	174	{
	175	PrefAlt = Ver;
	176	MaxAlt = Prio;
b2e465d6 AL	177	}
	178	}
	179
9ee8287e	180	if (instVer == true && Max < 1000)
b2e465d6 AL	181	{
	182	/* Elevate our current selection (or the status file itself)
	183	to the Pseudo-status priority. */
	184	if (Pref.end() == true)
	185	Pref = Ver;
	186	Max = 1000;
	187
	188	// Fast path optimize.
	189	if (StatusOverride == false)
	190	break;
	191	}
	192	}
8f5525e9 JAK	193	// If we do not find our candidate, use the one with the highest pin.
	194	// This means that if there is a version available with pin > 0; there
	195	// will always be a candidate (Closes: #512318)
	196	if (!Pref.IsGood() && MaxAlt > 0)
	197	Pref = PrefAlt;
9ee8287e	198
b2e465d6 AL	199	return Pref;
	200	}
	201	/}}}/
	202	// Policy::CreatePin - Create an entry in the pin table.. /{{{/
	203	// ---------------------------------------------------------------------
	204	/* For performance we have 3 tables, the default table, the main cache
	205	table (hashed to the cache). A blank package name indicates the pin
	206	belongs to the default table. Order of insertion matters here, the
	207	earlier defaults override later ones. */
	208	void pkgPolicy::CreatePin(pkgVersionMatch::MatchType Type,string Name,
	209	string Data,signed short Priority)
	210	{
b2e465d6	211	if (Name.empty() == true)
b2e465d6	212	{
4a6d2163 DK	213	Pin P = &Defaults.insert(Defaults.end(),PkgPin());
	214	P->Type = Type;
	215	P->Priority = Priority;
	216	P->Data = Data;
	217	return;
	218	}
1a4c9766 JAK	219
	220	// Allow pinning by wildcards
	221	// TODO: Maybe we should always prefer specific pins over non-
	222	// specific ones.
	223	if (Name.find("*") != string::npos \|\| Name.find("[") != string::npos
	224	\|\| Name.find("?") != string::npos \|\| Name[0] == '/') {
	225	pkgVersionMatch match(Data, Type);
	226	for (pkgCache::PkgIterator P = Cache->PkgBegin();
	227	P != Cache->PkgEnd(); P++) {
	228	if (match.ExpressionMatches(Name, P.Name())) {
	229	CreatePin(Type, P.Name(), Data, Priority);
	230	}
	231	}
	232	return;
	233	}
4a6d2163 DK	234
	235	// Get a spot to put the pin
	236	pkgCache::GrpIterator Grp = Cache->FindGrp(Name);
	237	for (pkgCache::PkgIterator Pkg = Grp.FindPkg("any");
	238	Pkg.end() != true; Pkg = Grp.NextPkg(Pkg))
	239	{
	240	Pin *P = 0;
	241	if (Pkg.end() == false)
	242	P = Pins + Pkg->ID;
	243	else
b2e465d6 AL	244	{
b2e465d6 AL	245	// Check the unmatched table
4a6d2163	246	for (vector<PkgPin>::iterator I = Unmatched.begin();
b2e465d6 AL	247	I != Unmatched.end() && P == 0; I++)
b2e465d6 AL	248	if (I->Pkg == Name)
d4887f3c	249	P = &*I;
4a6d2163	250
b2e465d6	251	if (P == 0)
4a6d2163	252	P = &*Unmatched.insert(Unmatched.end(),PkgPin());
b2e465d6	253	}
4a6d2163 DK	254	P->Type = Type;
	255	P->Priority = Priority;
	256	P->Data = Data;
b2e465d6	257	}
b2e465d6 AL	258	}
b2e465d6 AL	259	/}}}/
af87ab54 AL	260	// Policy::GetMatch - Get the matching version for a package pin /{{{/
	261	// ---------------------------------------------------------------------
	262	/* */
9ee8287e	263	pkgCache::VerIterator pkgPolicy::GetMatch(pkgCache::PkgIterator const &Pkg)
af87ab54 AL	264	{
af87ab54 AL	265	const Pin &PPkg = Pins[Pkg->ID];
9ee8287e DK	266	if (PPkg.Type == pkgVersionMatch::None)
	267	return pkgCache::VerIterator(*Pkg.Cache());
	268
	269	pkgVersionMatch Match(PPkg.Data,PPkg.Type);
	270	return Match.Find(Pkg);
af87ab54 AL	271	}
	272	/}}}/
	273	// Policy::GetPriority - Get the priority of the package pin /{{{/
	274	// ---------------------------------------------------------------------
	275	/* */
	276	signed short pkgPolicy::GetPriority(pkgCache::PkgIterator const &Pkg)
	277	{
	278	if (Pins[Pkg->ID].Type != pkgVersionMatch::None)
	279	{
	280	// In this case 0 means default priority
	281	if (Pins[Pkg->ID].Priority == 0)
	282	return 989;
	283	return Pins[Pkg->ID].Priority;
	284	}
	285
	286	return 0;
	287	}
	288	/}}}/
81e9789b MV	289	// PreferenceSection class - Overriding the default TrimRecord method /{{{/
	290	// ---------------------------------------------------------------------
	291	/* The preference file is a user generated file so the parser should
	292	therefore be a bit more friendly by allowing comments and new lines
	293	all over the place rather than forcing a special format */
	294	class PreferenceSection : public pkgTagSection
	295	{
	296	void TrimRecord(bool BeforeRecord, const char* &End)
	297	{
	298	for (; Stop < End && (Stop[0] == '\n' \|\| Stop[0] == '\r' \|\| Stop[0] == '#'); Stop++)
	299	if (Stop[0] == '#')
	300	Stop = (const char*) memchr(Stop,'\n',End-Stop);
	301	}
	302	};
	303	/}}}/
ef1dff93 DK	304	// ReadPinDir - Load the pin files from this dir into a Policy /{{{/
ef1dff93 DK	305	// ---------------------------------------------------------------------
6009e60d DK	306	/* This will load each pin file in the given dir into a Policy. If the
	307	given dir is empty the dir set in Dir::Etc::PreferencesParts is used.
	308	Note also that this method will issue a warning if the dir does not
	309	exists but it will return true in this case! */
e68ca100 JAK	310	bool ReadPinDir(pkgPolicy &Plcy,string Dir)
	311	{
	312	if (Dir.empty() == true)
	313	Dir = _config->FindDir("Dir::Etc::PreferencesParts");
	314
448eaf8b	315	if (DirectoryExists(Dir) == false)
6009e60d	316	{
448eaf8b	317	_error->WarningE("DirectoryExists",_("Unable to read %s"),Dir.c_str());
6009e60d DK	318	return true;
	319	}
	320
b39c1859	321	vector<string> const List = GetListOfFilesInDir(Dir, "pref", true, true);
e68ca100 JAK	322
	323	// Read the files
	324	for (vector<string>::const_iterator I = List.begin(); I != List.end(); I++)
	325	if (ReadPinFile(Plcy, *I) == false)
	326	return false;
	327	return true;
	328	}
81e9789b	329	/}}}/
b2e465d6 AL	330	// ReadPinFile - Load the pin file into a Policy /{{{/
	331	// ---------------------------------------------------------------------
	332	/* I'd like to see the preferences file store more than just pin information
	333	but right now that is the only stuff I have to store. Later there will
	334	have to be some kind of combined super parser to get the data into all
	335	the right classes.. */
	336	bool ReadPinFile(pkgPolicy &Plcy,string File)
	337	{
	338	if (File.empty() == true)
	339	File = _config->FindFile("Dir::Etc::Preferences");
	340
36f1098a	341	if (RealFileExists(File) == false)
b2e465d6 AL	342	return true;
	343
	344	FileFd Fd(File,FileFd::ReadOnly);
	345	pkgTagFile TF(&Fd);
	346	if (_error->PendingError() == true)
	347	return false;
	348
81e9789b	349	PreferenceSection Tags;
b2e465d6 AL	350	while (TF.Step(Tags) == true)
	351	{
	352	string Name = Tags.FindS("Package");
	353	if (Name.empty() == true)
e68ca100	354	return _error->Error(_("Invalid record in the preferences file %s, no Package header"), File.c_str());
b2e465d6 AL	355	if (Name == "*")
	356	Name = string();
	357
	358	const char *Start;
	359	const char *End;
	360	if (Tags.Find("Pin",Start,End) == false)
	361	continue;
	362
	363	const char *Word = Start;
	364	for (; Word != End && isspace(*Word) == 0; Word++);
	365
	366	// Parse the type..
	367	pkgVersionMatch::MatchType Type;
	368	if (stringcasecmp(Start,Word,"version") == 0 && Name.empty() == false)
	369	Type = pkgVersionMatch::Version;
	370	else if (stringcasecmp(Start,Word,"release") == 0)
	371	Type = pkgVersionMatch::Release;
	372	else if (stringcasecmp(Start,Word,"origin") == 0)
	373	Type = pkgVersionMatch::Origin;
	374	else
	375	{
	376	_error->Warning(_("Did not understand pin type %s"),string(Start,Word).c_str());
	377	continue;
	378	}
	379	for (; Word != End && isspace(*Word) != 0; Word++);
	380
56298634 AL	381	short int priority = Tags.FindI("Pin-Priority", 0);
	382	if (priority == 0)
	383	{
	384	_error->Warning(_("No priority (or zero) specified for pin"));
	385	continue;
	386	}
	387
1c62ab24 MV	388	istringstream s(Name);
	389	string pkg;
	390	while(!s.eof())
	391	{
	392	s >> pkg;
	393	Plcy.CreatePin(Type, pkg, string(Word,End),priority);
	394	};
b2e465d6 AL	395	}
	396
	397	Plcy.InitDefaults();
	398	return true;
	399	}
	400	/}}}/