Merge lp:~dandrader/unity-mir/clipboard into lp:unity-mir

[Daniel d'Andrada]

Unity8 now provides a clipboard service through the mir socket

That service can later be used for other custom messages as well.

Needs:
https://code.launchpad.net/~dandrader/platform-api/unity8_clipboard/+merge/205138
Mir 0.1.5

You can test it with this simple application:
http://ubuntuone.com/5nQjzPLv2GlLXBIyJ4LYsS

Also tested with ubuntu-ui-toolkit-gallery.qml (from lp:ubuntu-ui-toolkit), in the "Text Fields" section.

Doesn't work with the webbrowser though. Might be a problem with their code.

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:171
http://jenkins.qa.ubuntu.com/job/unity-mir-ci/241/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-amd64-ci/104/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-armhf-ci/105/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-i386-ci/104/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/unity-mir-ci/241/rebuild

review: Needs Fixing (continuous-integration)

[lp:~dandrader/unity-mir/clipboard]

173. By Daniel d'Andrada on 2014-02-06

Unity8 now provides a clipboard service through the mir socket

That service can later be used for other custom messages as well.

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:173
http://jenkins.qa.ubuntu.com/job/unity-mir-ci/242/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-amd64-ci/105/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-armhf-ci/106/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-i386-ci/105/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/unity-mir-ci/242/rebuild

review: Needs Fixing (continuous-integration)

[Gerry Boland (gerboland)]

+++ src/unity-mir/CMakeLists.txt
+ boost_system
Does this require adding libboost-system-dev to debian/control?

[Daniel d'Andrada (dandrader)]

> +++ src/unity-mir/CMakeLists.txt
> + boost_system
> Does this require adding libboost-system-dev to debian/control?

Not sure, to be honest. But I'll add it just to be on the safe side.

[lp:~dandrader/unity-mir/clipboard]

174. By Daniel d'Andrada on 2014-02-06

Added libboost-system-dev to build dependencies

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:174
http://jenkins.qa.ubuntu.com/job/unity-mir-ci/243/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-amd64-ci/106/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-armhf-ci/107/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-i386-ci/106/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/unity-mir-ci/243/rebuild

review: Needs Fixing (continuous-integration)

[Gerry Boland (gerboland)]

+message Void {
+ optional string error = 127;
+}
+service UnityService {
+ rpc copy(Clip) returns (Void);
+ rpc paste(Void) returns (Clip);
+}
I'm curious why you an rpc call for copy. Can copy fail? If not, would not a message be sufficient?

[Gerry Boland (gerboland)]

+ std::string clip;
m_clip please.

review: Needs Fixing

[lp:~dandrader/unity-mir/clipboard]

175. By Daniel d'Andrada on 2014-02-06

s/clip/m_clip to comply with coding style

[Daniel d'Andrada (dandrader)]

> + std::string clip;
> m_clip please.

done.

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:175
http://jenkins.qa.ubuntu.com/job/unity-mir-ci/244/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-amd64-ci/107/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-armhf-ci/108/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-i386-ci/107/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/unity-mir-ci/244/rebuild

review: Needs Fixing (continuous-integration)

[Daniel d'Andrada (dandrader)]

> +message Void {
> + optional string error = 127;
> +}
> +service UnityService {
> + rpc copy(Clip) returns (Void);
> + rpc paste(Void) returns (Clip);
> +}
> I'm curious why you an rpc call for copy. Can copy fail? If not, would not a
> message be sufficient?

Any RPC can fail, theoretically.
And that's the way communication between client and service works in protobuffer. A request messsage and a reply message.

[Gerry Boland (gerboland)]

+class UnityService : public unity::protobuf::UnityService
class name kinda vague, could we make it UnityClientService? Or something like that?

I'd also appreciate DLOG messages in those copy/paste methods to ease debugging.

[Gerry Boland (gerboland)]

> I'm curious why you an rpc call for copy. Can copy fail? If not, would not a
> message be sufficient?
<alan_g> greyback: "copy" needs to be an RPC call because it happens client side and the existing support in Mir is for RPC on the client and messaging on the server.

Objection withdrawn

[Alan Griffiths (alan-griffiths)]

LGTM

review: Approve

[Daniel d'Andrada (dandrader)]

> +class UnityService : public unity::protobuf::UnityService
> class name kinda vague, could we make it UnityClientService? Or something like
> that?

The vagueness is intentional. This service is supposed to hold all the future RPC that unity8 has with apps that is not covered by mir's protocol. As for you suggestion, I think "Client" just bloats the name without adding any more meaning as every "Service" implies a Client-Server relationship. IT might even be misleading as it might imply that this clients is the client-side of a service, whereas it's actually the server side.

Another suitable name I think would be UnityProtobufService, which is exactly what it is: a protobuf service provided by unity. Do you like it better?

>
> I'd also appreciate DLOG messages in those copy/paste methods to ease
> debugging.

This code is bug free. Why would you ever want to debug it? :P

[Olivier Tilloy (osomon)]

> Also tested with ubuntu-ui-toolkit-gallery.qml (from lp:ubuntu-ui-toolkit), in the "Text Fields" section.

The TextField component in the UITK wraps the standard TextInput QML component, which talks directly to the system clipboard…

> Doesn't work with the webbrowser though. Might be a problem with their code.

… Whereas copying content from a webpage in the browser uses the Clipboard object exposed by the UITK (see http://developer.ubuntu.com/api/qml/sdk-1.0/Ubuntu.Components.Clipboard/). This component is supposed to talk to the system clipboard under the hood, so it might be a bug in the component itself.

[lp:~dandrader/unity-mir/clipboard]

176. By Daniel d'Andrada on 2014-02-07

s/UnityService/UnityProtobufService

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:176
http://jenkins.qa.ubuntu.com/job/unity-mir-ci/246/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-amd64-ci/109/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-armhf-ci/110/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-mir-trusty-i386-ci/109/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/unity-mir-ci/246/rebuild

review: Needs Fixing (continuous-integration)

[Gerry Boland (gerboland)]

review: Approve

=== modified file 'CMakeLists.txt'
--- CMakeLists.txt	2014-01-15 14:59:00 +0000
+++ CMakeLists.txt	2014-02-07 16:10:33 +0000
@@ -58,6 +58,11 @@
 find_package(Qt5Quick REQUIRED)
 find_package(Qt5DBus REQUIRED)
 
+find_package(Protobuf REQUIRED)
+if(PROTOBUF_PROTOC_EXECUTABLE STREQUAL "PROTOBUF_PROTOC_EXECUTABLE-NOTFOUND")
+  message(SEND_ERROR "protoc executable not found! Missing protobuf-compiler package?")
+endif()
+
 pkg_check_modules(MIRSERVER mirserver REQUIRED)
 pkg_check_modules(MIRCOMMON mircommon REQUIRED)
 pkg_check_modules(UBUNTU_PLATFORM_API ubuntu-platform-api REQUIRED)

=== modified file 'debian/control'
--- debian/control	2014-02-04 16:47:30 +0000
+++ debian/control	2014-02-07 16:10:33 +0000
@@ -5,6 +5,7 @@
 Build-Depends: debhelper (>= 9),
                cmake,
                pkg-config,
+               libboost-system-dev,
                libplatform-api1-dev,
                libmirserver-dev (>= 0.1.4),
                libmirclient-dev (>= 0.1.4),
@@ -13,6 +14,7 @@
                qt5-default,
                qtbase5-dev,
                qtdeclarative5-dev,
+               protobuf-compiler,
 Standards-Version: 3.9.4
 Homepage: https://launchpad.net/unity-mir
 # If you aren't a member of ~mir-team but need to upload packaging changes,

=== modified file 'src/unity-mir/CMakeLists.txt'
--- src/unity-mir/CMakeLists.txt	2014-01-09 15:49:18 +0000
+++ src/unity-mir/CMakeLists.txt	2014-02-07 16:10:33 +0000
@@ -2,6 +2,13 @@
   ${MIRCOMMON_INCLUDE_DIRS}
   ${MIRSERVER_INCLUDE_DIRS}
   ${UBUNTU_PLATFORM_API_INCLUDE_DIRS}
+  ${PROTOBUF_INCLUDE_DIRS}
+  ${CMAKE_CURRENT_BINARY_DIR}
+)
+
+protobuf_generate_cpp(
+  GENERATED_PROTOBUF_SRCS GENERATED_PROTOBUF_HDRS
+  unityrpc.proto
 )
 
 set(
@@ -11,14 +18,19 @@
   initialsurfaceplacementstrategy.h
   qmirserverapplication.h
   qmirserver.h
+  messageprocessor.h
   sessionauthorizer.h
+  sessioncreator.h
   sessionlistener.h
   shellserverconfiguration.h
   surfacefactory.h
   surfaceconfigurator.h
+  unityprotobufservice.h
   logging.h
   focussetter.h
-  serverstatuslistener.h)
+  serverstatuslistener.h
+  ${GENERATED_PROTOBUF_HDRS}
+)
 
 add_library(
   unity-mir SHARED
@@ -27,15 +39,20 @@
   initialsurfaceplacementstrategy.cpp
   qmirserverapplication.cpp
   qmirserver.cpp
+  messageprocessor.cpp
   sessionauthorizer.cpp
+  sessioncreator.cpp
   sessionlistener.cpp
   shellserverconfiguration.cpp
   surfacefactory.cpp
   surfaceconfigurator.cpp
+  unityprotobufservice.cpp
   focussetter.cpp
   serverstatuslistener.cpp
 
-  ${UNITY_MIR_HEADERS})
+  ${UNITY_MIR_HEADERS}
+  ${GENERATED_PROTOBUF_SRCS}
+)
 
 # We should not need this line according to the Qt5/CMake docs.
 # However, when removing it, include paths are not set and linking to Qt5 fails.
@@ -60,6 +77,9 @@
   ${UBUNTU_PLATFORM_API_LIBRARIES}
   ${MIRCOMMON_LIBRARIES}
   ${MIRSERVER_LIBRARIES}
+  ${PROTOBUF_LIBRARIES}
+
+  boost_system
 
   ubuntu_application_api_mirserver)
 

=== added file 'src/unity-mir/messageprocessor.cpp'
--- src/unity-mir/messageprocessor.cpp	1970-01-01 00:00:00 +0000
+++ src/unity-mir/messageprocessor.cpp	2014-02-07 16:10:33 +0000
@@ -0,0 +1,45 @@
+/*
+ * Copyright (C) 2014 Canonical, Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License version 3, as published by
+ * the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
+ * SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "messageprocessor.h"
+#include <mir/frontend/template_protobuf_message_processor.h>
+
+
+bool MessageProcessor::dispatch(mir::frontend::detail::Invocation const& invocation)
+{
+    if ("copy" == invocation.method_name()) {
+        mir::frontend::detail::invoke(
+            this,
+            m_unityService.get(),
+            &unity::protobuf::UnityService::copy,
+            invocation);
+        return true;
+    } else if ("paste" == invocation.method_name()) {
+        mir::frontend::detail::invoke(
+            this,
+            m_unityService.get(),
+            &unity::protobuf::UnityService::paste,
+            invocation);
+        return true;
+    } else {
+        return m_wrapped->dispatch(invocation);
+    }
+}
+
+void MessageProcessor::send_response(::google::protobuf::uint32 id, ::google::protobuf::Message* response)
+{
+    m_sender->send_response(id, response, {});
+}

=== added file 'src/unity-mir/messageprocessor.h'
--- src/unity-mir/messageprocessor.h	1970-01-01 00:00:00 +0000
+++ src/unity-mir/messageprocessor.h	2014-02-07 16:10:33 +0000
@@ -0,0 +1,44 @@
+/*
+ * Copyright (C) 2014 Canonical, Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License version 3, as published by
+ * the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
+ * SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include <mir/frontend/message_processor.h>
+#include <mir/frontend/protobuf_message_sender.h>
+
+#include "unityrpc.pb.h"
+
+#include <memory>
+
+class MessageProcessor : public mir::frontend::detail::MessageProcessor
+{
+public:
+    MessageProcessor(
+        std::shared_ptr<unity::protobuf::UnityService> const& unityService,
+        std::shared_ptr<mir::frontend::detail::ProtobufMessageSender> const& sender,
+        std::shared_ptr<mir::frontend::detail::MessageProcessor> const& wrapped) :
+        m_sender(sender),
+        m_wrapped(wrapped),
+        m_unityService(unityService) {}
+
+    bool dispatch(mir::frontend::detail::Invocation const& invocation);
+
+    void send_response(::google::protobuf::uint32 id, ::google::protobuf::Message* response);
+
+private:
+    std::shared_ptr<mir::frontend::detail::ProtobufMessageSender> const m_sender;
+    std::shared_ptr<mir::frontend::detail::MessageProcessor> const m_wrapped;
+    std::shared_ptr<unity::protobuf::UnityService> const m_unityService;
+};
+

=== added file 'src/unity-mir/sessioncreator.cpp'
--- src/unity-mir/sessioncreator.cpp	1970-01-01 00:00:00 +0000
+++ src/unity-mir/sessioncreator.cpp	2014-02-07 16:10:33 +0000
@@ -0,0 +1,41 @@
+/*
+ * Copyright (C) 2014 Canonical, Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License version 3, as published by
+ * the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
+ * SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "sessioncreator.h"
+#include <messageprocessor.h>
+
+SessionCreator::SessionCreator(
+        std::shared_ptr<unity::protobuf::UnityService> const& unityService,
+        std::shared_ptr<mir::frontend::ProtobufIpcFactory> const& ipc_factory,
+        std::shared_ptr<mir::frontend::SessionAuthorizer> const& session_authorizer,
+        std::shared_ptr<mir::frontend::MessageProcessorReport> const& report)
+    : ProtobufSessionCreator(ipc_factory, session_authorizer, report)
+    , m_unityService(unityService)
+{
+}
+
+std::shared_ptr<mir::frontend::detail::MessageProcessor> SessionCreator::create_processor(
+    std::shared_ptr<mir::frontend::detail::ProtobufMessageSender> const& sender,
+    std::shared_ptr<mir::protobuf::DisplayServer> const& display_server,
+    std::shared_ptr<mir::frontend::MessageProcessorReport> const& report) const
+{
+    auto const wrapped = mir::frontend::ProtobufSessionCreator::create_processor(
+            sender,
+            display_server,
+            report);
+
+    return std::make_shared<MessageProcessor>(m_unityService, sender, wrapped);
+}

=== added file 'src/unity-mir/sessioncreator.h'
--- src/unity-mir/sessioncreator.h	1970-01-01 00:00:00 +0000
+++ src/unity-mir/sessioncreator.h	2014-02-07 16:10:33 +0000
@@ -0,0 +1,45 @@
+/*
+ * Copyright (C) 2014 Canonical, Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License version 3, as published by
+ * the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
+ * SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef SESSIONCREATOR_H
+#define SESSIONCREATOR_H
+
+#include <mir/frontend/protobuf_session_creator.h>
+
+namespace unity {
+    namespace protobuf {
+        class UnityService;
+    }
+}
+
+class SessionCreator : public mir::frontend::ProtobufSessionCreator
+{
+public:
+    SessionCreator(
+        std::shared_ptr<unity::protobuf::UnityService> const& unityService,
+        std::shared_ptr<mir::frontend::ProtobufIpcFactory> const& ipc_factory,
+        std::shared_ptr<mir::frontend::SessionAuthorizer> const& session_authorizer,
+        std::shared_ptr<mir::frontend::MessageProcessorReport> const& report);
+
+    std::shared_ptr<mir::frontend::detail::MessageProcessor> create_processor(
+        std::shared_ptr<mir::frontend::detail::ProtobufMessageSender> const& sender,
+        std::shared_ptr<mir::protobuf::DisplayServer> const& display_server,
+        std::shared_ptr<mir::frontend::MessageProcessorReport> const& report) const override;
+private:
+    std::shared_ptr<unity::protobuf::UnityService> m_unityService;
+};
+
+#endif // SESSIONCREATOR_H

=== modified file 'src/unity-mir/shellserverconfiguration.cpp'
--- src/unity-mir/shellserverconfiguration.cpp	2013-12-11 01:16:48 +0000
+++ src/unity-mir/shellserverconfiguration.cpp	2014-02-07 16:10:33 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2013 Canonical, Ltd.
+ * Copyright (C) 2013-2014 Canonical, Ltd.
  *
  * This program is free software: you can redistribute it and/or modify it under
  * the terms of the GNU Lesser General Public License version 3, as published by
@@ -16,8 +16,10 @@
 
 #include "shellserverconfiguration.h"
 
+#include "unityprotobufservice.h"
 #include "initialsurfaceplacementstrategy.h"
 #include "serverstatuslistener.h"
+#include "sessioncreator.h"
 #include "sessionlistener.h"
 #include "surfaceconfigurator.h"
 #include "surfacefactory.h"
@@ -30,6 +32,7 @@
 ShellServerConfiguration::ShellServerConfiguration(int argc, char const* argv[], QObject* parent)
     : QObject(parent)
     , DefaultServerConfiguration(argc, argv)
+    , m_unityService(std::make_shared<UnityProtobufService>())
 {
     DLOG("ShellServerConfiguration created");
 }
@@ -78,6 +81,19 @@
     });
 }
 
+std::shared_ptr<mir::frontend::SessionCreator>
+ShellServerConfiguration::the_session_creator()
+{
+    return session_creator([this]
+        {
+            return std::make_shared<SessionCreator>(
+                m_unityService,
+                the_ipc_factory(the_frontend_shell(), the_buffer_allocator()),
+                the_session_authorizer(),
+                the_message_processor_report());
+        });
+}
+
 // FIXME: Needed to detect the shell's surface - there must be a better way
 std::shared_ptr<msh::SurfaceFactory>
 ShellServerConfiguration::the_shell_surface_factory()

=== modified file 'src/unity-mir/shellserverconfiguration.h'
--- src/unity-mir/shellserverconfiguration.h	2013-12-11 01:16:48 +0000
+++ src/unity-mir/shellserverconfiguration.h	2014-02-07 16:10:33 +0000
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2013 Canonical, Ltd.
+ * Copyright (C) 2013-2014 Canonical, Ltd.
  *
  * This program is free software: you can redistribute it and/or modify it under
  * the terms of the GNU Lesser General Public License version 3, as published by
@@ -20,6 +20,11 @@
 #include <QObject>
 #include <mir/default_server_configuration.h>
 
+namespace unity {
+    namespace protobuf {
+        class UnityService;
+    }
+}
 
 class FocusSetter;
 class SessionListener;
@@ -49,6 +54,7 @@
     std::shared_ptr<mir::shell::FocusSetter> the_shell_focus_setter() override;
     std::shared_ptr<mir::ServerStatusListener> the_server_status_listener() override;
     std::shared_ptr<mir::frontend::SessionAuthorizer> the_session_authorizer() override;
+    std::shared_ptr<mir::frontend::SessionCreator> the_session_creator() override;
 
     /* qt specific */
     // getters
@@ -61,6 +67,7 @@
 
 protected:
     std::shared_ptr<SurfaceFactory> m_surfaceFactory;
+    std::shared_ptr<unity::protobuf::UnityService> m_unityService;
 };
 
 #endif // SHELLSERVERCONFIGURATION_H

=== added file 'src/unity-mir/unityprotobufservice.cpp'
--- src/unity-mir/unityprotobufservice.cpp	1970-01-01 00:00:00 +0000
+++ src/unity-mir/unityprotobufservice.cpp	2014-02-07 16:10:33 +0000
@@ -0,0 +1,35 @@
+/*
+ * Copyright (C) 2014 Canonical, Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License version 3, as published by
+ * the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
+ * SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "unityprotobufservice.h"
+
+void UnityProtobufService::copy(::google::protobuf::RpcController* /*controller*/,
+        const ::unity::protobuf::Clip* newClip,
+        ::unity::protobuf::Void* /*response*/,
+        ::google::protobuf::Closure* done)
+{
+    m_clip = newClip->content();
+    done->Run();
+}
+
+void UnityProtobufService::paste(::google::protobuf::RpcController* /*controller*/,
+        const ::unity::protobuf::Void* /*request*/,
+        ::unity::protobuf::Clip* clipReturned,
+        ::google::protobuf::Closure* done)
+{
+    clipReturned->set_content(m_clip);
+    done->Run();
+}

=== added file 'src/unity-mir/unityprotobufservice.h'
--- src/unity-mir/unityprotobufservice.h	1970-01-01 00:00:00 +0000
+++ src/unity-mir/unityprotobufservice.h	2014-02-07 16:10:33 +0000
@@ -0,0 +1,40 @@
+/*
+ * Copyright (C) 2014 Canonical, Ltd.
+ *
+ * This program is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Lesser General Public License version 3, as published by
+ * the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranties of MERCHANTABILITY,
+ * SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef UNITY_PROTOBUF_SERVICE_H
+#define UNITY_PROTOBUF_SERVICE_H
+
+#include "unityrpc.pb.h"
+#include <string>
+
+class UnityProtobufService : public unity::protobuf::UnityService
+{
+public:
+    void copy(::google::protobuf::RpcController* controller,
+            const ::unity::protobuf::Clip* request,
+            ::unity::protobuf::Void* response,
+            ::google::protobuf::Closure* done) override;
+
+    void paste(::google::protobuf::RpcController* controller,
+            const ::unity::protobuf::Void* request,
+            ::unity::protobuf::Clip* response,
+            ::google::protobuf::Closure* done) override;
+
+private:
+    std::string m_clip;
+};
+
+#endif // UNITY_PROTOBUF_SERVICE_H

=== added file 'src/unity-mir/unityrpc.proto'
--- src/unity-mir/unityrpc.proto	1970-01-01 00:00:00 +0000
+++ src/unity-mir/unityrpc.proto	2014-02-07 16:10:33 +0000
@@ -0,0 +1,17 @@
+option cc_generic_services = true;
+
+package unity.protobuf;
+
+message Clip {
+  required bytes content = 1;
+  optional string error = 127;
+}
+
+message Void {
+  optional string error = 127;
+}
+
+service UnityService {
+  rpc copy(Clip) returns (Void);
+  rpc paste(Void) returns (Clip);
+}