/usr/include/k3bdevicemanager.h is in libk3b-dev 2.0.2-8.
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 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 | /*
*
* Copyright (C) 2003-2009 Sebastian Trueg <trueg@k3b.org>
*
* This file is part of the K3b project.
* Copyright (C) 1998-2009 Sebastian Trueg <trueg@k3b.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
* See the file "COPYING" for the exact licensing terms.
*/
#ifndef K3BDEVICEMANAGER_H
#define K3BDEVICEMANAGER_H
#include <qobject.h>
#include <qstring.h>
#include <qstringlist.h>
#include "k3bdevice_export.h"
#include <kdebug.h>
class KConfigGroup;
namespace Solid {
class Device;
}
namespace K3b {
namespace Device {
class Device;
/**
* \brief Manages all devices.
*
* Searches the system for devices and maintains lists of them.
*
* <b>Basic usage:</b>
* \code
* K3b::Device::DeviceManager* manager = new K3b::Device::DeviceManager( this );
* manager->scanBus();
* K3b::Device::Device* dev = manager->findDevice( "/dev/cdrom" );
* \endcode
*/
class LIBK3BDEVICE_EXPORT DeviceManager : public QObject
{
Q_OBJECT
public:
/**
* Creates a new DeviceManager
*/
DeviceManager( QObject* parent = 0 );
virtual ~DeviceManager();
/**
* By default the DeviceManager makes the Devices check their writing modes.
* This includes commands to be sent which require writing permissions on the
* devices and might take some time.
*
* So if you don't need the information about the writing modes use this method
* to speed up the device detection procedure.
*
* Be aware that this only refers to CD writing modes. If you only want to handle
* DVD devices it's always save to set this to false.
*/
void setCheckWritingModes( bool b );
/**
* \deprecated use findDevice( const QString& )
*/
Device* deviceByName( const QString& );
/**
* Search a device by blockdevice name.
*
* \return The corresponding device or 0 if there is no such device.
*/
Device* findDevice( const QString& devicename );
/**
* Search a device by UDI.
*
* \return The corresponding device or 0 if there is no such device.
*/
Device* findDeviceByUdi( const QString& udi );
/**
* Before getting the devices do a @ref scanBus().
* \return List of all cd writer devices.
* \deprecated use cdWriter()
*/
QList<Device*> burningDevices() const;
/**
* \return List of all reader devices without writer devices.
* \deprecated use cdReader()
**/
QList<Device*> readingDevices() const;
/**
* Before getting the devices do a @ref scanBus() or add
* devices via addDevice( const QString& ).
*
* \return List of all devices.
*/
QList<Device*> allDevices() const;
/**
* Before getting the devices do a @ref scanBus() or add
* devices via addDevice( const QString& ).
*
* \return List of all cd writer devices.
*/
QList<Device*> cdWriter() const;
/**
* Before getting the devices do a @ref scanBus() or add
* devices via addDevice( const QString& ).
*
* \return List of all cd reader devices.
*/
QList<Device*> cdReader() const;
/**
* Before getting the devices do a @ref scanBus() or add
* devices via addDevice( const QString& ).
*
* \return List of all DVD writer devices.
*/
QList<Device*> dvdWriter() const;
/**
* Before getting the devices do a @ref scanBus() or add
* devices via addDevice( const QString& ).
*
* \return List of all DVD reader devices.
*/
QList<Device*> dvdReader() const;
/**
* Before getting the devices do a @ref scanBus() or add
* devices via addDevice( const QString& ).
*
* \return List of all Blue Ray reader devices.
*/
QList<Device*> blueRayReader() const;
/**
* Before getting the devices do a @ref scanBus() or add
* devices via addDevice( const QString& ).
*
* \return List of all Blue Ray writer devices.
*/
QList<Device*> blueRayWriters() const;
/**
* Reads the device information from the config file.
*/
virtual bool readConfig( const KConfigGroup& );
virtual bool saveConfig( KConfigGroup );
public Q_SLOTS:
/**
* Writes a list of all devices to stderr.
*/
void printDevices();
/**
* Scan the system for devices. Call this to initialize all devices.
*
* \return Number of found devices.
**/
virtual int scanBus();
/**
* Clears the writers and readers list of devices.
*/
virtual void clear();
Q_SIGNALS:
/**
* Emitted if the device configuration changed, i.e. a device was added or removed.
*/
void changed( K3b::Device::DeviceManager* );
void changed();
private Q_SLOTS:
K3b::Device::Device* checkDevice( const Solid::Device& dev );
void slotSolidDeviceAdded( const QString& );
void slotSolidDeviceRemoved( const QString& );
protected:
/**
* Add a new device.
*
* Called by scanBus()
*
* \return The device if it could be found or 0 otherwise.
*/
virtual Device* addDevice( const Solid::Device& dev );
/**
* Remove a device from the device manager.
*/
virtual void removeDevice( const Solid::Device& dev );
private:
class Private;
Private* const d;
/**
* Add a device to the managers device lists and initialize the device.
*/
Device *addDevice( Device* );
};
}
}
#endif
|