src/ppapi/shared_impl/ppapi_permissions.h

   1 // Copyright (c) 2012 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 PPAPI_SHARED_IMPL_PPAPI_PERMISSIONS_H_
   6 #define PPAPI_SHARED_IMPL_PPAPI_PERMISSIONS_H_
   7
   8 #include "base/basictypes.h"
   9 #include "ppapi/shared_impl/ppapi_shared_export.h"
  10
  11 namespace ppapi {
  12
  13 enum Permission {
  14   // Placeholder/uninitialized permission.
  15   PERMISSION_NONE = 0,
  16
  17   // Allows access to dev interfaces.
  18   PERMISSION_DEV = 1 << 0,
  19
  20   // Allows access to Browser-internal interfaces.
  21   PERMISSION_PRIVATE = 1 << 1,
  22
  23   // Allows ability to bypass user-gesture checks for showing things like
  24   // file select dialogs.
  25   PERMISSION_BYPASS_USER_GESTURE = 1 << 2,
  26
  27   // Testing-only interfaces.
  28   PERMISSION_TESTING = 1 << 3,
  29
  30   // Flash-related interfaces.
  31   PERMISSION_FLASH = 1 << 4,
  32
  33   // NOTE: If you add stuff be sure to update PERMISSION_ALL_BITS.
  34
  35   // Meta permission for initializing plugins registered on the command line
  36   // that get all permissions.
  37   PERMISSION_ALL_BITS = PERMISSION_DEV |
  38                         PERMISSION_PRIVATE |
  39                         PERMISSION_BYPASS_USER_GESTURE |
  40                         PERMISSION_TESTING |
  41                         PERMISSION_FLASH
  42 };
  43
  44 class PPAPI_SHARED_EXPORT PpapiPermissions {
  45  public:
  46   // Initializes the permissions struct with no permissions.
  47   PpapiPermissions();
  48
  49   // Initializes with the given permissions bits set.
  50   explicit PpapiPermissions(uint32 perms);
  51
  52   ~PpapiPermissions();
  53
  54   // Returns a permissions class with all features enabled. This is for testing
  55   // and manually registered plugins.
  56   static PpapiPermissions AllPermissions();
  57
  58   // Returns the effective permissions given the "base" permissions granted
  59   // to the given plugin and the current command line flags, which may enable
  60   // more features.
  61   static PpapiPermissions GetForCommandLine(uint32 base_perms);
  62
  63   bool HasPermission(Permission perm) const;
  64
  65   // Returns the internal permission bits. Use for serialization only.
  66   uint32 GetBits() const { return permissions_; }
  67
  68  private:
  69   uint32 permissions_;
  70
  71   // Note: Copy & assign supported.
  72 };
  73
  74 }  // namespace ppapi
  75
  76 #endif  // PPAPI_SHARED_IMPL_PPAPI_PERMISSIONS_H_