/usr/include/core/trust/mir_agent.h is in libtrust-store-dev 2.0.0+16.04.20160119-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 | /*
* Copyright © 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 warranty of
* MERCHANTABILITY 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/>.
*
* Authored by: Thomas Voß <thomas.voss@canonical.com>
*/
#ifndef CORE_TRUST_MIR_AGENT_H_
#define CORE_TRUST_MIR_AGENT_H_
#include <core/trust/visibility.h>
#include <memory>
#include <stdexcept>
// Forward declare the MirConnection type.
struct MirConnection;
namespace core
{
namespace trust
{
// Forward declare the Agent interface.
class Agent;
namespace mir
{
class InvalidMirConnection : public std::runtime_error
{
public:
explicit InvalidMirConnection(const char* what_arg)
: std::runtime_error(what_arg)
{}
};
/**
* @brief Helper function building up a connection to Mir.
* @param endpoint The name of the endpoint exposed by the Mir instance.
* @param name The name assigned to this connection.
* @throws std::runtime_error in case of issues.
*/
CORE_TRUST_DLL_PUBLIC MirConnection* connect(const std::string& endpoint, const std::string& name);
/**
* @brief create_agent_for_mir_connection creates a trust::Agent implementation leveraging Mir's trusted prompting API.
* @param connection An existing connection to a Mir instance.
* @throws InvalidMirConnection if the connection object is invalid.
*/
CORE_TRUST_DLL_PUBLIC std::shared_ptr<core::trust::Agent> create_agent_for_mir_connection(MirConnection* connection);
}
}
}
#endif // CORE_TRUST_MIR_AGENT_H_
|