Added evictEntries() methods to nsICacheService and nsICacheSession. Removed lastValidated attribute from nsICacheVisitor. r=beard sr=darin.

netwerk/cache/public/nsICacheService.idl

@@ -44,7 +44,7 @@ interface nsICacheService : nsISupports
      */
     void shutdown();
 
-    /*
+    /**
      * Create a cache session
      *
      * A cache session represents a client's access into the cache.  The cache
@@ -68,8 +68,13 @@ interface nsICacheService : nsISupports
                                   in nsCacheStoragePolicy   storagePolicy,
                                   in boolean                streamBased);
 
-    /*
+    /**
      * Visit entries stored in the cache.  Used to implement about:cache.
      */
     void visitEntries(in nsICacheVisitor visitor);
+
+    /**
+     * Evicts all entries in all devices implied by the storage policy.
+     */
+    void evictEntries(in nsCacheStoragePolicy  storagePolicy);
 };

netwerk/cache/public/nsICacheSession.idl

@@ -63,4 +63,9 @@ interface nsICacheSession : nsISupports
     void asyncOpenCacheEntry(in string            key,
                              in nsCacheAccessMode accessRequested,
                              in nsICacheListener  listener);
+
+    /**
+     * Evict all entries for this session's clientID according to its storagePolicy.
+     */
+    void evictEntries();
 };

netwerk/cache/public/nsICacheVisitor.idl

@@ -120,11 +120,6 @@ interface nsICacheEntryInfo : nsISupports
      */
     readonly attribute PRUint32  lastModified;
 
-    /**
-     * Get the last time the cache entry was marked valid (in seconds since the Epoch).
-     */
-    readonly attribute PRUint32  lastValidated;
-
     /**
      * Get the expiration time of the cache entry (in seconds since the Epoch).
      */