• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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.
GetBits()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_
77