Home | History | Annotate | Download | only in dump_cache
      1 // Copyright (c) 2008 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 // This command-line program dumps the contents of a set of cache files, either
      6 // to stdout or to another set of cache files.
      7 
      8 #include <stdio.h>
      9 #include <string>
     10 
     11 #include "base/at_exit.h"
     12 #include "base/command_line.h"
     13 #include "base/process_util.h"
     14 #include "base/scoped_handle.h"
     15 #include "base/string_util.h"
     16 
     17 #include "net/disk_cache/disk_format.h"
     18 
     19 enum Errors {
     20   GENERIC = -1,
     21   ALL_GOOD = 0,
     22   INVALID_ARGUMENT = 1,
     23   FILE_ACCESS_ERROR,
     24   UNKNOWN_VERSION,
     25   TOOL_NOT_FOUND,
     26 };
     27 
     28 int GetMajorVersion(const std::wstring& input_path);
     29 int DumpContents(const std::wstring& input_path);
     30 int DumpHeaders(const std::wstring& input_path);
     31 int RunSlave(const std::wstring& input_path, const std::wstring& pipe_number);
     32 int CopyCache(const std::wstring& output_path, HANDLE pipe, bool copy_to_text);
     33 HANDLE CreateServer(std::wstring* pipe_number);
     34 
     35 const char kUpgradeHelp[] =
     36     "\nIn order to use the upgrade function, a version of this tool that\n"
     37     "understands the file format of the files to upgrade is needed. For\n"
     38     "instance, to upgrade files saved with file format 3.4 to version 5.2,\n"
     39     "a version of this program that was compiled with version 3.4 has to be\n"
     40     "located beside this executable, and named dump_cache_3.exe, and this\n"
     41     "executable should be compiled with version 5.2 being the current one.";
     42 
     43 // Folders to read and write cache files.
     44 const wchar_t kInputPath[] = L"input";
     45 const wchar_t kOutputPath[] = L"output";
     46 
     47 // Dumps the file headers to stdout.
     48 const wchar_t kDumpHeaders[] = L"dump-headers";
     49 
     50 // Dumps all entries to stdout.
     51 const wchar_t kDumpContents[] = L"dump-contents";
     52 
     53 // Convert the cache to files.
     54 const wchar_t kDumpToFiles[] = L"dump-to-files";
     55 
     56 // Upgrade an old version to the current one.
     57 const wchar_t kUpgrade[] = L"upgrade";
     58 
     59 // Internal use:
     60 const char kSlave[] = "slave";
     61 const char kPipe[] = "pipe";
     62 
     63 int Help() {
     64   printf("warning: input files are modified by this tool\n");
     65   printf("dump_cache --input=path1 [--output=path2]\n");
     66   printf("--dump-headers: display file headers\n");
     67   printf("--dump-contents: display all entries\n");
     68   printf("--upgrade: copy contents to the output path\n");
     69   printf("--dump-to-files: write the contents of the cache to files\n");
     70   return INVALID_ARGUMENT;
     71 }
     72 
     73 // Starts a new process, to generate the files.
     74 int LaunchSlave(const CommandLine& command_line,
     75                 const std::wstring& pipe_number, int version) {
     76   // TODO(port): remove this string-munging hackery.
     77   std::wstring hacked_command_line = command_line.command_line_string();
     78   const std::wstring old_exe(L"dump_cache");
     79   size_t to_remove = hacked_command_line.find(old_exe);
     80   hacked_command_line.erase(to_remove, old_exe.size());
     81 
     82   bool do_upgrade = command_line.HasSwitch(kUpgrade);
     83   bool do_convert_to_text = command_line.HasSwitch(kDumpToFiles);
     84 
     85   std::wstring new_program;
     86   if (do_upgrade)
     87     new_program = StringPrintf(L"%ls%d", L"dump_cache_", version);
     88   else
     89     new_program = StringPrintf(L"dump_cache");
     90 
     91   hacked_command_line.insert(to_remove, new_program);
     92 
     93   CommandLine new_command_line = CommandLine::FromString(hacked_command_line);
     94 
     95   if (do_upgrade || do_convert_to_text)
     96     new_command_line.AppendSwitch(kSlave);
     97 
     98   new_command_line.AppendSwitchWithValue(kPipe, pipe_number);
     99   if (!base::LaunchApp(new_command_line, false, false, NULL)) {
    100     printf("Unable to launch the needed version of this tool: %ls\n",
    101            new_program.c_str());
    102     printf(kUpgradeHelp);
    103     return TOOL_NOT_FOUND;
    104   }
    105   return ALL_GOOD;
    106 }
    107 
    108 // -----------------------------------------------------------------------
    109 
    110 int main(int argc, const char* argv[]) {
    111   // Setup an AtExitManager so Singleton objects will be destroyed.
    112   base::AtExitManager at_exit_manager;
    113 
    114   CommandLine::Init(argc, argv);
    115 
    116   const CommandLine& command_line = *CommandLine::ForCurrentProcess();
    117   std::wstring input_path = command_line.GetSwitchValue(kInputPath);
    118   if (input_path.empty())
    119     return Help();
    120 
    121   bool upgrade = false;
    122   bool slave_required = false;
    123   bool copy_to_text = false;
    124   std::wstring output_path = command_line.GetSwitchValue(kOutputPath);
    125   if (command_line.HasSwitch(kUpgrade))
    126     upgrade = true;
    127   if (command_line.HasSwitch(kDumpToFiles))
    128     copy_to_text = true;
    129 
    130   if (upgrade || copy_to_text) {
    131     if (output_path.empty())
    132       return Help();
    133     slave_required = true;
    134   }
    135 
    136   int version = GetMajorVersion(input_path);
    137   if (!version)
    138     return FILE_ACCESS_ERROR;
    139 
    140   if (version != disk_cache::kCurrentVersion >> 16) {
    141     if (command_line.HasSwitch(kSlave)) {
    142       printf("Unknown version\n");
    143       return UNKNOWN_VERSION;
    144     }
    145     slave_required = true;
    146   }
    147 
    148   std::wstring pipe_number = command_line.GetSwitchValue(kPipe);
    149   if (command_line.HasSwitch(kSlave) && slave_required)
    150     return RunSlave(input_path, pipe_number);
    151 
    152   ScopedHandle server;
    153   if (slave_required) {
    154     server.Set(CreateServer(&pipe_number));
    155     if (!server.IsValid()) {
    156       printf("Unable to create the server pipe\n");
    157       return -1;
    158     }
    159 
    160     int ret = LaunchSlave(command_line, pipe_number, version);
    161     if (ret)
    162       return ret;
    163   }
    164 
    165   if (upgrade || copy_to_text)
    166     return CopyCache(output_path, server, copy_to_text);
    167 
    168   if (slave_required) {
    169     // Wait until the slave starts dumping data before we quit. Lazy "fix" for a
    170     // console quirk.
    171     Sleep(500);
    172     return ALL_GOOD;
    173   }
    174 
    175   if (command_line.HasSwitch(kDumpContents))
    176     return DumpContents(input_path);
    177   if (command_line.HasSwitch(kDumpHeaders))
    178     return DumpHeaders(input_path);
    179   return Help();
    180 }
    181