aboutsummaryrefslogtreecommitdiff
path: root/include/perfetto/tracing/ipc/service_ipc_host.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/perfetto/tracing/ipc/service_ipc_host.h')
-rw-r--r--include/perfetto/tracing/ipc/service_ipc_host.h65
1 files changed, 65 insertions, 0 deletions
diff --git a/include/perfetto/tracing/ipc/service_ipc_host.h b/include/perfetto/tracing/ipc/service_ipc_host.h
new file mode 100644
index 000000000..eeec568ca
--- /dev/null
+++ b/include/perfetto/tracing/ipc/service_ipc_host.h
@@ -0,0 +1,65 @@
+/*
+ * Copyright (C) 2017 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 INCLUDE_PERFETTO_TRACING_IPC_SERVICE_IPC_HOST_H_
+#define INCLUDE_PERFETTO_TRACING_IPC_SERVICE_IPC_HOST_H_
+
+#include <memory>
+
+#include "perfetto/base/scoped_file.h"
+#include "perfetto/tracing/core/basic_types.h"
+
+namespace perfetto {
+namespace base {
+class TaskRunner;
+} // namespace base.
+
+class TracingService;
+
+// Creates an instance of the service (business logic + UNIX socket transport).
+// Exposed to:
+// The code in the tracing client that will host the service e.g., traced.
+// Implemented in:
+// src/tracing/ipc/service/service_ipc_host_impl.cc
+class ServiceIPCHost {
+ public:
+ static std::unique_ptr<ServiceIPCHost> CreateInstance(base::TaskRunner*);
+ virtual ~ServiceIPCHost();
+
+ // Start listening on the Producer & Consumer ports. Returns false in case of
+ // failure (e.g., something else is listening on |socket_name|).
+ virtual bool Start(const char* producer_socket_name,
+ const char* consumer_socket_name) = 0;
+
+ // Like the above, but takes two file descriptors to already bound sockets.
+ // This is used when building as part of the Android tree, where init opens
+ // and binds the socket beore exec()-ing us.
+ virtual bool Start(base::ScopedFile producer_socket_fd,
+ base::ScopedFile consumer_socket_fd) = 0;
+
+ virtual TracingService* service() const = 0;
+
+ protected:
+ ServiceIPCHost();
+
+ private:
+ ServiceIPCHost(const ServiceIPCHost&) = delete;
+ ServiceIPCHost& operator=(const ServiceIPCHost&) = delete;
+};
+
+} // namespace perfetto
+
+#endif // INCLUDE_PERFETTO_TRACING_IPC_SERVICE_IPC_HOST_H_