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