summaryrefslogtreecommitdiff
path: root/library/qlibrary.cpp
authorzecke <zecke>2002-09-10 12:09:49 (UTC)
committer zecke <zecke>2002-09-10 12:09:49 (UTC)
commit6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4 (patch) (unidiff)
tree6ebc93c6432f4ed9d00ef1448b6a047ef522a79a /library/qlibrary.cpp
parentd10cddb3c9ce75bc90b14add14bc133737fe35aa (diff)
downloadopie-6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4.zip
opie-6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4.tar.gz
opie-6b77a1cdb9536b1c135eb86d53a6b2c22c19b0a4.tar.bz2
Qtopia1-6 merge
still to test bic changes to be resolved more changes to be made?
Diffstat (limited to 'library/qlibrary.cpp') (more/less context) (ignore whitespace changes)
-rw-r--r--library/qlibrary.cpp4
1 files changed, 2 insertions, 2 deletions
diff --git a/library/qlibrary.cpp b/library/qlibrary.cpp
index 4aabbc5..cbf49a3 100644
--- a/library/qlibrary.cpp
+++ b/library/qlibrary.cpp
@@ -1,260 +1,260 @@
1/********************************************************************** 1/**********************************************************************
2** Copyright (C) 2000 Trolltech AS. All rights reserved. 2** Copyright (C) 2000-2002 Trolltech AS. All rights reserved.
3** 3**
4** This file is part of Qtopia Environment. 4** This file is part of the Qtopia Environment.
5** 5**
6** This file may be distributed and/or modified under the terms of the 6** This file may be distributed and/or modified under the terms of the
7** GNU General Public License version 2 as published by the Free Software 7** GNU General Public License version 2 as published by the Free Software
8** Foundation and appearing in the file LICENSE.GPL included in the 8** Foundation and appearing in the file LICENSE.GPL included in the
9** packaging of this file. 9** packaging of this file.
10** 10**
11** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE 11** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
12** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 12** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
13** 13**
14** See http://www.trolltech.com/gpl/ for GPL licensing information. 14** See http://www.trolltech.com/gpl/ for GPL licensing information.
15** 15**
16** Contact info@trolltech.com if any conditions of this licensing are 16** Contact info@trolltech.com if any conditions of this licensing are
17** not clear to you. 17** not clear to you.
18** 18**
19**********************************************************************/ 19**********************************************************************/
20 20
21 21
22#include "qlibrary_p.h" 22#include "qlibrary_p.h"
23 23
24// uncomment this to get error messages 24// uncomment this to get error messages
25//#define QT_DEBUG_COMPONENT 1 25//#define QT_DEBUG_COMPONENT 1
26// uncomment this to get error and success messages 26// uncomment this to get error and success messages
27//#define QT_DEBUG_COMPONENT 2 27//#define QT_DEBUG_COMPONENT 2
28 28
29#ifndef QT_DEBUG_COMPONENT 29#ifndef QT_DEBUG_COMPONENT
30# if defined(QT_DEBUG) 30# if defined(QT_DEBUG)
31# define QT_DEBUG_COMPONENT 1 31# define QT_DEBUG_COMPONENT 1
32# endif 32# endif
33#endif 33#endif
34 34
35#ifndef QT_NO_COMPONENT 35#ifndef QT_NO_COMPONENT
36 36
37// KAI C++ has at the moment problems with unloading the Qt plugins. So don't 37// KAI C++ has at the moment problems with unloading the Qt plugins. So don't
38// unload them as a workaround for now. 38// unload them as a workaround for now.
39#if defined(Q_CC_KAI) || defined(Q_OS_MAC) 39#if defined(Q_CC_KAI) || defined(Q_OS_MAC)
40#define QT_NO_LIBRARY_UNLOAD 40#define QT_NO_LIBRARY_UNLOAD
41#endif 41#endif
42 42
43#if defined(Q_WS_WIN) && !defined(QT_MAKEDLL) 43#if defined(Q_WS_WIN) && !defined(QT_MAKEDLL)
44#define QT_NO_LIBRARY_UNLOAD 44#define QT_NO_LIBRARY_UNLOAD
45#endif 45#endif
46 46
47/* Platform independent QLibraryPrivate implementations */ 47/* Platform independent QLibraryPrivate implementations */
48#ifndef QT_LITE_COMPONENT 48#ifndef QT_LITE_COMPONENT
49 49
50#include "qtimer.h" 50#include "qtimer.h"
51 51
52extern Q_EXPORT QApplication *qApp; 52extern Q_EXPORT QApplication *qApp;
53 53
54QLibraryPrivate::QLibraryPrivate( QLibrary *lib ) 54QLibraryPrivate::QLibraryPrivate( QLibrary *lib )
55 : QObject( 0, lib->library().latin1() ), pHnd( 0 ), libIface( 0 ), unloadTimer( 0 ), library( lib ) 55 : QObject( 0, lib->library().latin1() ), pHnd( 0 ), libIface( 0 ), unloadTimer( 0 ), library( lib )
56{ 56{
57} 57}
58 58
59QLibraryPrivate::~QLibraryPrivate() 59QLibraryPrivate::~QLibraryPrivate()
60{ 60{
61 if ( libIface ) 61 if ( libIface )
62 libIface->release(); 62 libIface->release();
63 killTimer(); 63 killTimer();
64} 64}
65 65
66/* 66/*
67 Only components that implement the QLibraryInterface can 67 Only components that implement the QLibraryInterface can
68 be unloaded automatically. 68 be unloaded automatically.
69*/ 69*/
70void QLibraryPrivate::tryUnload() 70void QLibraryPrivate::tryUnload()
71{ 71{
72 if ( library->policy() == QLibrary::Manual || !pHnd || !libIface ) 72 if ( library->policy() == QLibrary::Manual || !pHnd || !libIface )
73 return; 73 return;
74 74
75 if ( !libIface->canUnload() ) 75 if ( !libIface->canUnload() )
76 return; 76 return;
77 77
78#if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2 78#if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2
79 if ( library->unload() ) 79 if ( library->unload() )
80 qDebug( "%s has been automatically unloaded", library->library().latin1() ); 80 qDebug( "%s has been automatically unloaded", library->library().latin1() );
81#else 81#else
82 library->unload(); 82 library->unload();
83#endif 83#endif
84} 84}
85 85
86#else // QT_LITE_COMPOINENT 86#else // QT_LITE_COMPOINENT
87 87
88QLibraryPrivate::QLibraryPrivate( QLibrary *lib ) 88QLibraryPrivate::QLibraryPrivate( QLibrary *lib )
89 : pHnd( 0 ), libIface( 0 ), library( lib ) 89 : pHnd( 0 ), libIface( 0 ), library( lib )
90{ 90{
91} 91}
92 92
93#endif // QT_LITE_COMPOINENT 93#endif // QT_LITE_COMPOINENT
94 94
95void QLibraryPrivate::startTimer() 95void QLibraryPrivate::startTimer()
96{ 96{
97#ifndef QT_LITE_COMPONENT 97#ifndef QT_LITE_COMPONENT
98 unloadTimer = new QTimer( this ); 98 unloadTimer = new QTimer( this );
99 connect( unloadTimer, SIGNAL( timeout() ), this, SLOT( tryUnload() ) ); 99 connect( unloadTimer, SIGNAL( timeout() ), this, SLOT( tryUnload() ) );
100 unloadTimer->start( 5000, FALSE ); 100 unloadTimer->start( 5000, FALSE );
101#endif 101#endif
102} 102}
103 103
104void QLibraryPrivate::killTimer() 104void QLibraryPrivate::killTimer()
105{ 105{
106#ifndef QT_LITE_COMPONENT 106#ifndef QT_LITE_COMPONENT
107 delete unloadTimer; 107 delete unloadTimer;
108 unloadTimer = 0; 108 unloadTimer = 0;
109#endif 109#endif
110} 110}
111 111
112/*! 112/*!
113 \class QLibrary qlibrary.h 113 \class QLibrary qlibrary.h
114 114
115 \brief The QLibrary class provides a wrapper for handling shared libraries. 115 \brief The QLibrary class provides a wrapper for handling shared libraries.
116 116
117 This class is temporarily copied from Qt 3.0. 117 This class is temporarily copied from Qt 3.0.
118*/ 118*/
119 119
120/*! 120/*!
121 \enum QLibrary::Policy 121 \enum QLibrary::Policy
122 122
123 This enum type defines the various policies a QLibrary can have with respect to 123 This enum type defines the various policies a QLibrary can have with respect to
124 loading and unloading the shared library. 124 loading and unloading the shared library.
125 125
126 The \e policy can be: 126 The \e policy can be:
127 127
128 \value Delayed The library get's loaded as soon as needed and unloaded in the destructor 128 \value Delayed The library get's loaded as soon as needed and unloaded in the destructor
129 \value Immediately The library is loaded immediately and unloaded in the destructor 129 \value Immediately The library is loaded immediately and unloaded in the destructor
130 \value Manual Like delayed, and library has to be unloaded manually 130 \value Manual Like delayed, and library has to be unloaded manually
131*/ 131*/
132 132
133/*! 133/*!
134 Creates a QLibrary object for the shared library \a filename. 134 Creates a QLibrary object for the shared library \a filename.
135 The library get's loaded if \a pol is Immediately. 135 The library get's loaded if \a pol is Immediately.
136 136
137 Note that \a filename does not need to include the (platform specific) 137 Note that \a filename does not need to include the (platform specific)
138 file extension, so calling 138 file extension, so calling
139 139
140 \code 140 \code
141 QLibrary lib( "mylib" ); 141 QLibrary lib( "mylib" );
142 \endcode 142 \endcode
143 143
144 would be equivalent to 144 would be equivalent to
145 145
146 \code 146 \code
147 QLibrary lib( "mylib.dll" ); 147 QLibrary lib( "mylib.dll" );
148 \endcode 148 \endcode
149 149
150 on Windows. But \e "mylib.dll" will obviously not work on other platforms. 150 on Windows. But \e "mylib.dll" will obviously not work on other platforms.
151 151
152 \sa setPolicy(), unload() 152 \sa setPolicy(), unload()
153*/ 153*/
154QLibrary::QLibrary( const QString& filename, Policy pol ) 154QLibrary::QLibrary( const QString& filename, Policy pol )
155 : libfile( filename ), libPol( pol ), entry( 0 ) 155 : libfile( filename ), libPol( pol ), entry( 0 )
156{ 156{
157 d = new QLibraryPrivate( this ); 157 d = new QLibraryPrivate( this );
158 if ( pol == Immediately ) 158 if ( pol == Immediately )
159 load(); 159 load();
160} 160}
161 161
162/*! 162/*!
163 Deletes the QLibrary object. 163 Deletes the QLibrary object.
164 The library will be unloaded if the policy is not Manual. 164 The library will be unloaded if the policy is not Manual.
165 165
166 \sa unload(), setPolicy() 166 \sa unload(), setPolicy()
167*/ 167*/
168QLibrary::~QLibrary() 168QLibrary::~QLibrary()
169{ 169{
170 if ( libPol == Manual || !unload() ) { 170 if ( libPol == Manual || !unload() ) {
171 if ( entry ) { 171 if ( entry ) {
172 entry->release(); 172 entry->release();
173 entry = 0; 173 entry = 0;
174 } 174 }
175 } 175 }
176 delete d; 176 delete d;
177} 177}
178 178
179void QLibrary::createInstanceInternal() 179void QLibrary::createInstanceInternal()
180{ 180{
181 if ( libfile.isEmpty() ) 181 if ( libfile.isEmpty() )
182 return; 182 return;
183 183
184 if ( !d->pHnd ) { 184 if ( !d->pHnd ) {
185 ASSERT( entry == 0 ); 185 ASSERT( entry == 0 );
186 load(); 186 load();
187 } 187 }
188 188
189 if ( d->pHnd && !entry ) { 189 if ( d->pHnd && !entry ) {
190#if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2 190#if defined(QT_DEBUG_COMPONENT) && QT_DEBUG_COMPONENT == 2
191 qWarning( "%s has been loaded.", library().latin1() ); 191 qWarning( "%s has been loaded.", library().latin1() );
192#endif 192#endif
193 typedef QUnknownInterface* (*UCMInstanceProc)(); 193 typedef QUnknownInterface* (*UCMInstanceProc)();
194 UCMInstanceProc ucmInstanceProc; 194 UCMInstanceProc ucmInstanceProc;
195 ucmInstanceProc = (UCMInstanceProc) resolve( "ucm_instantiate" ); 195 ucmInstanceProc = (UCMInstanceProc) resolve( "ucm_instantiate" );
196 entry = ucmInstanceProc ? ucmInstanceProc() : 0; 196 entry = ucmInstanceProc ? ucmInstanceProc() : 0;
197 if ( entry ) { 197 if ( entry ) {
198 entry->queryInterface( IID_QLibrary, (QUnknownInterface**)&d->libIface); 198 entry->queryInterface( IID_QLibrary, (QUnknownInterface**)&d->libIface);
199 if ( d->libIface ) { 199 if ( d->libIface ) {
200 if ( !d->libIface->init() ) { 200 if ( !d->libIface->init() ) {
201#if defined(QT_DEBUG_COMPONENT) 201#if defined(QT_DEBUG_COMPONENT)
202 qWarning( "%s: QLibraryInterface::init() failed.", library().latin1() ); 202 qWarning( "%s: QLibraryInterface::init() failed.", library().latin1() );
203#endif 203#endif
204 unload(); 204 unload();
205 return; 205 return;
206 } 206 }
207 207
208 d->killTimer(); 208 d->killTimer();
209 if ( libPol != Manual ) 209 if ( libPol != Manual )
210 d->startTimer(); 210 d->startTimer();
211 } 211 }
212 } else { 212 } else {
213#if defined(QT_DEBUG_COMPONENT) 213#if defined(QT_DEBUG_COMPONENT)
214 qWarning( "%s: No interface implemented.", library().latin1() ); 214 qWarning( "%s: No interface implemented.", library().latin1() );
215#endif 215#endif
216 unload(); 216 unload();
217 } 217 }
218 } 218 }
219} 219}
220 220
221/*! 221/*!
222 Returns the address of the exported symbol \a symb. The library gets 222 Returns the address of the exported symbol \a symb. The library gets
223 loaded if necessary. The function returns NULL if the symbol could 223 loaded if necessary. The function returns NULL if the symbol could
224 not be resolved, or if loading the library failed. 224 not be resolved, or if loading the library failed.
225 225
226 \code 226 \code
227 typedef int (*addProc)( int, int ); 227 typedef int (*addProc)( int, int );
228 228
229 addProc add = (addProc) library->resolve( "add" ); 229 addProc add = (addProc) library->resolve( "add" );
230 if ( add ) 230 if ( add )
231 return add( 5, 8 ); 231 return add( 5, 8 );
232 else 232 else
233 return 5 + 8; 233 return 5 + 8;
234 \endcode 234 \endcode
235 235
236 \sa queryInterface() 236 \sa queryInterface()
237*/ 237*/
238void *QLibrary::resolve( const char* symb ) 238void *QLibrary::resolve( const char* symb )
239{ 239{
240 if ( !d->pHnd ) 240 if ( !d->pHnd )
241 load(); 241 load();
242 if ( !d->pHnd ) 242 if ( !d->pHnd )
243 return 0; 243 return 0;
244 244
245 void *address = d->resolveSymbol( symb ); 245 void *address = d->resolveSymbol( symb );
246 if ( !address ) { 246 if ( !address ) {
247#if defined(QT_DEBUG_COMPONENT) 247#if defined(QT_DEBUG_COMPONENT)
248 // resolveSymbol() might give a warning; so let that warning look so fatal 248 // resolveSymbol() might give a warning; so let that warning look so fatal
249 qWarning( QString("Trying to resolve symbol \"_%1\" instead").arg( symb ) ); 249 qWarning( QString("Trying to resolve symbol \"_%1\" instead").arg( symb ) );
250#endif 250#endif
251 address = d->resolveSymbol( QString( "_" ) + symb ); 251 address = d->resolveSymbol( QString( "_" ) + symb );
252 } 252 }
253 return address; 253 return address;
254} 254}
255 255
256/*! 256/*!
257 \overload 257 \overload
258 258
259 Loads the library \a filename and returns the address of the exported symbol \a symb. 259 Loads the library \a filename and returns the address of the exported symbol \a symb.
260 Note that like for the constructor, \a filename does not need to include the (platform specific) 260 Note that like for the constructor, \a filename does not need to include the (platform specific)