Home | History | Annotate | Download | only in shared_impl 
      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_
     77