summaryrefslogtreecommitdiffstats
path: root/src/prefetcher/session_manager.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/prefetcher/session_manager.h')
-rw-r--r--src/prefetcher/session_manager.h91
1 files changed, 91 insertions, 0 deletions
diff --git a/src/prefetcher/session_manager.h b/src/prefetcher/session_manager.h
new file mode 100644
index 0000000..45120d5
--- /dev/null
+++ b/src/prefetcher/session_manager.h
@@ -0,0 +1,91 @@
+// Copyright (C) 2019 The Android Open Source Project
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef PREFETCHER_SESSION_MANAGER_H_
+#define PREFETCHER_SESSION_MANAGER_H_
+
+#include <optional>
+#include <ostream>
+#include <memory>
+
+namespace iorap {
+namespace prefetcher {
+
+class Session;
+
+enum class SessionKind : uint32_t {
+ kInProcessDirect,
+ kOutOfProcessIpc,
+ kOutOfProcessSocket,
+};
+
+inline std::ostream& operator<<(std::ostream& os, SessionKind kind) {
+ if (kind == SessionKind::kInProcessDirect) {
+ os << "kInProcessDirect";
+ } else if (kind == SessionKind::kOutOfProcessIpc) {
+ os << "kOutOfProcessIpc";
+ } else if (kind == SessionKind::kOutOfProcessSocket) {
+ os << "kOutOfProcessSocket";
+ } else {
+ os << "(invalid)";
+ }
+ return os;
+}
+
+class SessionManager {
+ public:
+ static std::unique_ptr<SessionManager> CreateManager(SessionKind kind);
+
+ // Create a new session. The description is used by Dump.
+ // Manager maintains a strong ref to this session, so DestroySession must also
+ // be called prior to all refs dropping to 0.
+ virtual std::shared_ptr<Session> CreateSession(size_t session_id,
+ std::string description) = 0;
+
+ // Create a new session. The description is used by Dump.
+ // Manager maintains a strong ref to this session, so DestroySession must also
+ // be called prior to all refs dropping to 0.
+ virtual std::shared_ptr<Session> CreateSession(size_t session_id,
+ std::string description,
+ std::optional<int> fd) {
+ return CreateSession(session_id, description);
+ }
+
+ // Look up an existing session that was already created.
+ // Returns null if there is no such session.
+ virtual std::shared_ptr<Session> FindSession(size_t session_id) const = 0;
+
+ // Drop all manager references to an existing session.
+ // Returns false if the session does not exist already.
+ virtual bool DestroySession(size_t session_id) = 0;
+
+ // Multi-line detailed dump, e.g. for dumpsys.
+ // Single-line summary dump, e.g. for logcat.
+ virtual void Dump(std::ostream& os, bool multiline) const = 0;
+
+ // Note: session lifetime is tied to manager. The manager has strong pointers to sessions.
+ virtual ~SessionManager() {}
+
+ protected:
+ SessionManager();
+};
+
+// Single-line summary dump of Session.
+std::ostream& operator<<(std::ostream&os, const SessionManager& session);
+
+} // namespace prefetcher
+} // namespace iorap
+
+#endif
+