components/nacl/browser/bad_message.h

   1 // Copyright 2015 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 #ifndef COMPONENTS_NACL_BROWSER_BAD_MESSAGE_H_
   6 #define COMPONENTS_NACL_BROWSER_BAD_MESSAGE_H_
   7
   8 namespace content {
   9 class BrowserMessageFilter;
  10 }
  11
  12 namespace nacl {
  13 namespace bad_message {
  14
  15 // The browser process often chooses to terminate a renderer if it receives
  16 // a bad IPC message. The reasons are tracked for metrics.
  17 //
  18 // See also content/browser/bad_message.h.
  19 //
  20 // NOTE: Do not remove or reorder elements in this list. Add new entries at the
  21 // end. Items may be renamed but do not change the values. We rely on the enum
  22 // values in histograms.
  23 enum BadMessageReason {
  24   NFH_OPEN_EXECUTABLE_BAD_ROUTING_ID = 0,
  25   NHMF_LAUNCH_CONTINUATION_BAD_ROUTING_ID = 1,
  26   NHMF_GET_NEXE_FD_BAD_URL = 2,
  27
  28   // Please add new elements here. The naming convention is abbreviated class
  29   // name (e.g. NaclHostMessageFilter becomes NHMF) plus a unique description of
  30   // the reason. After making changes, you MUST update histograms.xml by
  31   // running:
  32   // "python tools/metrics/histograms/update_bad_message_reasons.py"
  33   BAD_MESSAGE_MAX
  34 };
  35
  36 // Called when a browser message filter receives a bad IPC message from a
  37 // renderer or other child process. Logs the event, records a histogram metric
  38 // for the |reason|, and terminates the process for |filter|.
  39 void ReceivedBadMessage(content::BrowserMessageFilter* filter,
  40                         BadMessageReason reason);
  41
  42 }  // namespace bad_message
  43 }  // namespace nacl
  44
  45 #endif  // COMPONENTS_NACL_BROWSER_BAD_MESSAGE_H_