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
|
/* This file is part of the KDE project
*
* Copyright (C) 2001-2004 George Staikos <staikos@kde.org>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef _KWALLETBACKEND_H
#define _KWALLETBACKEND_H
#include <kmdcodec.h>
#include <qstring.h>
#include <qstringlist.h>
#include <qmap.h>
#include "kwalletentry.h"
namespace KWallet {
class MD5Digest;
/* @internal
*/
class KDE_EXPORT Backend {
public:
Backend(const QString& name = "kdewallet", bool isPath = false);
~Backend();
// Open and unlock the wallet.
int open(const QByteArray& password);
// Close and lock the wallet (saving changes).
int close(const QByteArray& password);
// Close the wallet, losing any changes.
int close();
// Write the wallet to disk
int sync(const QByteArray& password);
// Returns true if the current wallet is open.
bool isOpen() const;
// Returns the current wallet name.
const QString& walletName() const;
// The list of folders.
QStringList folderList() const;
// Force creation of a folder.
bool createFolder(const QString& f);
// Change the folder.
void setFolder(const QString& f) { _folder = f; }
// Current folder. If empty, it's the global folder.
const QString& folder() const { return _folder; }
// Does it have this folder?
bool hasFolder(const QString& f) const { return _entries.contains(f); }
// Look up an entry. Returns null if it doesn't exist.
Entry *readEntry(const QString& key);
// Look up a list of entries. Supports wildcards.
// You delete the list.
QPtrList<Entry> readEntryList(const QString& key);
// Store an entry.
void writeEntry(Entry *e);
// Does this folder contain this entry?
bool hasEntry(const QString& key) const;
// Returns true if the entry was removed
bool removeEntry(const QString& key);
// Returns true if the folder was removed
bool removeFolder(const QString& f);
// The list of entries in this folder.
QStringList entryList() const;
// Rename an entry in this folder.
int renameEntry(const QString& oldName, const QString& newName);
int ref() { return ++_ref; }
int deref() { return --_ref; }
int refCount() const { return _ref; }
static bool exists(const QString& wallet);
bool folderDoesNotExist(const QString& folder) const;
bool entryDoesNotExist(const QString& folder, const QString& entry) const;
static QString openRCToString(int rc);
private:
class BackendPrivate;
BackendPrivate *d;
QString _name;
QString _path;
bool _open;
QString _folder;
int _ref;
// Map Folder->Entries
typedef QMap< QString, Entry* > EntryMap;
typedef QMap< QString, EntryMap > FolderMap;
FolderMap _entries;
typedef QMap<MD5Digest, QValueList<MD5Digest> > HashMap;
HashMap _hashes;
};
/**
* @internal
*/
class MD5Digest : public QByteArray {
public:
MD5Digest() : QByteArray(16) {}
MD5Digest(const KMD5::Digest d) : QByteArray() { duplicate(reinterpret_cast<const char *>(d), 16); }
virtual ~MD5Digest() {}
int operator<(const MD5Digest& r) const {
int i = 0;
char x, y;
for (; i < 16; ++i) {
x = at(i);
y = r.at(i);
if (x != y) {
break;
}
}
if (i < 16 && x < y) {
return 1;
}
return 0;
}
};
}
#endif
|
