/*************************************************************************
 *  Copyright (C) 2010 by Volker Lanz <vl@fidra.de>                      *
 *                                                                       *
 *  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 3 of       *
 *  the License, or (at your option) any later version.                  *
 *                                                                       *
 *  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 General Public License for more details.                         *
 *                                                                       *
 *  You should have received a copy of the GNU General Public License    *
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.*
 *************************************************************************/

#if !defined(COREBACKENDDEVICE__H)

#define COREBACKENDDEVICE__H

#include "../util/libpartitionmanagerexport.h"

#include <QString>

class CoreBackendPartition;
class CoreBackendPartitionTable;
class Partition;
class PartitionTable;
class Report;

/**
  * Interface class representing a device in the backend plugin.
  * @author Volker Lanz <vl@fidra.de>
  */
class LIBKPMCORE_EXPORT CoreBackendDevice
{
	public:
		CoreBackendDevice(const QString& device_node);
		virtual ~CoreBackendDevice() {}

	public:
		/**
		  * Get the device path for this device (e.g. "/dev/sda")
		  * @return the device path
		  */
		virtual const QString& deviceNode() const { return m_DeviceNode; }

		/**
		  * Determine if this device is opened in exclusive mode.
		  * @return true if it is opened in exclusive mode, otherwise false
		  */
		virtual bool isExclusive() const { return m_Exclusive; }

		/**
		  * Open the backend device
		  * @return true if successful
		  */
		virtual bool open() = 0;

		/**
		  * Open the backend device in exclusive mode
		  * @return true if successful
		  */
		virtual bool openExclusive() = 0;

		/**
		  * Close the backend device
		  * @return true if successful
		  */
		virtual bool close() = 0;

		/**
		  * Open this backend device's partition table
		  * @return a pointer to the CoreBackendPartitionTable for this device or NULL in case
		  *         of errors
		  */
		virtual CoreBackendPartitionTable* openPartitionTable() = 0;

		/**
		  * Create a new partition table on this device.
		  * @param report the Report to write information to
		  * @param ptable the PartitionTable to create on this backend device
		  * @return true if successful
		  */
		virtual bool createPartitionTable(Report& report, const PartitionTable& ptable) = 0;

		/**
		  * Read sectors from an opened device into a buffer.
		  * @param buffer the buffer to write the read data to
		  * @param offset offset sector where to start reading on the device
		  * @param numSectors number of sectors to read
		  * @return true on success
		  */
		virtual bool readSectors(void* buffer, qint64 offset, qint64 numSectors) = 0;

		/**
		  * Write sectors from a buffer to an exclusively opened device.
		  * @param buffer the buffer with the data
		  * @param offset offset sector where to start writing to the device
		  * @param numSectors number of sectors to write
		  * @return true on success
		  */
		virtual bool writeSectors(void* buffer, qint64 offset, qint64 numSectors) = 0;

	protected:
		void setExclusive(bool b) { m_Exclusive = b; }

	private:
		const QString m_DeviceNode;
		bool m_Exclusive;
};

#endif