summaryrefslogtreecommitdiffstats
path: root/kdat/TapeManager.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit37333bf25ad9a4c538250f5af2f9f1d666362883 (patch)
treec45e8df5b9efbffe07eb3d9340df7811c7e16943 /kdat/TapeManager.h
downloadtdeadmin-37333bf25ad9a4c538250f5af2f9f1d666362883.tar.gz
tdeadmin-37333bf25ad9a4c538250f5af2f9f1d666362883.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeadmin@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kdat/TapeManager.h')
-rw-r--r--kdat/TapeManager.h154
1 files changed, 154 insertions, 0 deletions
diff --git a/kdat/TapeManager.h b/kdat/TapeManager.h
new file mode 100644
index 0000000..bc91aab
--- /dev/null
+++ b/kdat/TapeManager.h
@@ -0,0 +1,154 @@
+// KDat - a tar-based DAT archiver
+// Copyright (C) 1998-2000 Sean Vyain, svyain@mail.tds.net
+// Copyright (C) 2001-2002 Lawrence Widman, kdat@cardiothink.com
+//
+// 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.
+//
+// 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, write to the Free Software
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+#ifndef _TapeManager_h_
+#define _TapeManager_h_
+
+#include <qdict.h>
+#include <qobject.h>
+#include <qstrlist.h>
+
+#include "Tape.h"
+
+/**
+ * @short Control access to the set of tape indexes.
+ *
+ * Each user has a set of tape indexes that are stored under
+ * <TT>$HOME/.kdat/</TT>. This class provides a single point of access for
+ * reading and writing these index files.
+ *
+ * Other objects can register to be notified when a tape index is added or
+ * removed, and when a tape index is modified.
+ *
+ * A reference to the index of the currently mounted tape is maintained, and
+ * other objects can register to be notified when a tape is mounted and
+ * unmounted.
+ *
+ * The TapeManager follows the Singleton pattern.
+ */
+class TapeManager : public QObject {
+ Q_OBJECT
+
+ static TapeManager* _instance;
+
+ QDict<Tape> _tapes;
+ QStringList _tapeIDs;
+ Tape* _mountedTape;
+
+ TapeManager();
+public:
+ ~TapeManager();
+
+ /**
+ * All access to the TapeManager goes through this method.
+ *
+ * @return a pointer to the single instance of the TapeManager.
+ */
+ static TapeManager* instance();
+
+ /**
+ * Get the list of all known tape IDs.
+ *
+ * @return a QStringList containing the tape IDs.
+ */
+ const QStringList& getTapeIDs();
+
+ /**
+ * Retrieve the index for a tape.
+ *
+ * @param id the ID of the tape.
+ * @return the tape's index.
+ */
+ Tape* findTape( const QString & id );
+
+ /**
+ * Add a new tape index.
+ *
+ * @param tape a pointer to the new tape index.
+ */
+ void addTape( Tape* tape );
+
+ /**
+ * Remove a tape index. The tape index is removed from memory and from
+ * disk. A signal is emitted before the tape is actually removed.
+ *
+ * @param tape a pointer to the tape index to remove.
+ */
+ void removeTape( Tape* tape );
+
+ /**
+ * Notify anyone who cares that the tape index has been modified.
+ *
+ * @param tape a pointer to the tape index that was modified.
+ */
+ void tapeModified( Tape* tape );
+
+ /**
+ * Call this method whenever a tape is first mounted.
+ *
+ * @param tape a pointer to the newly mounted tape's index.
+ */
+ void mountTape( Tape* tape );
+
+ /**
+ * Call this method whenever the current tape is about to be unmounted.
+ */
+ void unmountTape();
+
+ /**
+ * Get a handle on the currently mounted tape's index.
+ *
+ * @return a pointer to the mounted tape's index, or NULL if no tape is
+ * mounted.
+ */
+ Tape* getMountedTape();
+signals:
+ /**
+ * Emitted after a new tape index is created.
+ *
+ * @param tape a pointer to the new tape index.
+ */
+ void sigTapeAdded( Tape* tape );
+
+ /**
+ * Emitted before a tape index is destroyed. This signal is emitted
+ * immediately before the tape index is deleted.
+ *
+ * @param tape a pointer to the tape index that is about to be destroyed.
+ */
+ void sigTapeRemoved( Tape* tape );
+
+ /**
+ * Emitted after a tape index has been changed in some way.
+ *
+ * @param tape a pointer to the tape index that has been modified.
+ */
+ void sigTapeModified( Tape* tape );
+
+ /**
+ * Emitted after a tape has been mounted.
+ */
+ void sigTapeMounted();
+
+ /**
+ * Emitted just before the current tape is unmounted.
+ */
+ void sigTapeUnmounted();
+};
+
+#endif