/usr/include/KF5/BluezQt/bluezqt/obexagent.h is in libkf5bluezqt-dev 5.18.0-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 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | /*
* BluezQt - Asynchronous BlueZ wrapper library
*
* Copyright (C) 2014-2015 David Rosca <nowrep@gmail.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) version 3, or any
* later version accepted by the membership of KDE e.V. (or its
* successor approved by the membership of KDE e.V.), which shall
* act as a proxy defined in Section 6 of version 3 of the license.
*
* This library 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 library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef BLUEZQT_OBEXAGENT_H
#define BLUEZQT_OBEXAGENT_H
#include <QObject>
#include "types.h"
#include "request.h"
#include "bluezqt_export.h"
class QDBusObjectPath;
namespace BluezQt
{
class Device;
class ObexTransfer;
/**
* Bluetooth OBEX agent.
*
* This class represents a Bluetooth OBEX agent.
*
* The agent is used to authorize an incoming object push requests.
*
* @note The return value of request will be sent asynchronously with Request class.
* It is also possible to cancel/reject the request.
*/
class BLUEZQT_EXPORT ObexAgent : public QObject
{
Q_OBJECT
public:
/**
* Creates a new ObexAgent object.
*
* @param parent
*/
explicit ObexAgent(QObject *parent = Q_NULLPTR);
/**
* D-Bus object path of the agent.
*
* The path where the agent will be registered.
*
* @note You must provide valid object path!
*
* @return object path of agent
*/
virtual QDBusObjectPath objectPath() const = 0;
/**
* Requests the agent to authorize an incoming object push request.
*
* This method gets called when the Bluetooth daemon
* needs to accept/reject a Bluetooth object push request.
*
* The return value should be full path where the incoming object
* will be saved.
*
* The ObexTransfer::fileName() contains the default location
* and name that can be returned.
*
* You can use @p session to get device and adapter this transfer
* belongs to.
*
* @param transfer transfer object
* @param session transfer session
* @param request request to be used for sending reply
*/
virtual void authorizePush(ObexTransferPtr transfer, ObexSessionPtr session, const Request<QString> &request);
/**
* Indicate that the agent request failed before receiving reply.
*
* This method gets called to indicate that the agent
* request failed before a reply was returned.
*
* It cancels the previous request.
*/
virtual void cancel();
/**
* Indicates that the agent was unregistered.
*
* This method gets called when the Bluetooth daemon
* unregisters the agent.
*
* An agent can use it to do cleanup tasks. There is no need
* to unregister the agent, because when this method gets called
* it has already been unregistered.
*/
virtual void release();
};
} // namespace BluezQt
#endif // BLUEZQT_OBEXAGENT_H
|