kio Library API Documentation

kmimetype.cpp

00001 /*  This file is part of the KDE libraries
00002  *  Copyright (C) 1999 Waldo Bastian <bastian@kde.org>
00003  *                     David Faure   <faure@kde.org>
00004  *
00005  *  This library is free software; you can redistribute it and/or
00006  *  modify it under the terms of the GNU Library General Public
00007  *  License version 2 as published by the Free Software Foundation;
00008  *
00009  *  This library is distributed in the hope that it will be useful,
00010  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
00011  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012  *  Library General Public License for more details.
00013  *
00014  *  You should have received a copy of the GNU Library General Public License
00015  *  along with this library; see the file COPYING.LIB.  If not, write to
00016  *  the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
00017  *  Boston, MA 02111-1307, USA.
00018  **/
00019 // $Id$
00020 
00021 #include <config.h>
00022 
00023 #include <sys/types.h>
00024 #include <sys/stat.h>
00025 
00026 #include <assert.h>
00027 #include <dirent.h>
00028 #include <errno.h>
00029 #include <stddef.h>
00030 #include <unistd.h>
00031 #include <stdlib.h>
00032 
00033 #include <kprotocolinfo.h>
00034 #include <kio/global.h>
00035 #include "kmimetype.h"
00036 #include "kservicetypefactory.h"
00037 #include "kmimemagic.h"
00038 #include "kservice.h"
00039 #include "krun.h"
00040 #include "kautomount.h"
00041 #include <kdirnotify_stub.h>
00042 
00043 #include <qstring.h>
00044 #include <qfile.h>
00045 #include <kmessageboxwrapper.h>
00046 
00047 #include <dcopclient.h>
00048 #include <dcopref.h>
00049 #include <kapplication.h>
00050 #include <kprocess.h>
00051 #include <kdebug.h>
00052 #include <kdesktopfile.h>
00053 #include <kdirwatch.h>
00054 #include <kiconloader.h>
00055 #include <klocale.h>
00056 #include <ksimpleconfig.h>
00057 #include <kstandarddirs.h>
00058 #include <kurl.h>
00059 #include <ksycoca.h>
00060 #include <kde_file.h>
00061 
00062 template class KSharedPtr<KMimeType>;
00063 template class QValueList<KMimeType::Ptr>;
00064 
00065 KMimeType::Ptr KMimeType::s_pDefaultType = 0L;
00066 bool KMimeType::s_bChecked = false;
00067 
00068 void KMimeType::buildDefaultType()
00069 {
00070   assert ( !s_pDefaultType );
00071   // Try to find the default type
00072   KServiceType * mime = KServiceTypeFactory::self()->
00073         findServiceTypeByName( defaultMimeType() );
00074 
00075   if (mime && mime->isType( KST_KMimeType ))
00076   {
00077       s_pDefaultType = KMimeType::Ptr((KMimeType *) mime);
00078   }
00079   else
00080   {
00081      errorMissingMimeType( defaultMimeType() );
00082      KStandardDirs stdDirs;
00083      QString sDefaultMimeType = stdDirs.resourceDirs("mime").first()+defaultMimeType()+".desktop";
00084      s_pDefaultType = new KMimeType( sDefaultMimeType, defaultMimeType(),
00085                                      "unknown", "mime", QStringList() );
00086   }
00087 }
00088 
00089 KMimeType::Ptr KMimeType::defaultMimeTypePtr()
00090 {
00091   if ( !s_pDefaultType ) // we need a default type first
00092     buildDefaultType();
00093   return s_pDefaultType;
00094 }
00095 
00096 // Check for essential mimetypes
00097 void KMimeType::checkEssentialMimeTypes()
00098 {
00099   if ( s_bChecked ) // already done
00100     return;
00101   if ( !s_pDefaultType ) // we need a default type first
00102     buildDefaultType();
00103 
00104   s_bChecked = true; // must be done before building mimetypes
00105 
00106   // No Mime-Types installed ?
00107   // Lets do some rescue here.
00108   if ( !KServiceTypeFactory::self()->checkMimeTypes() )
00109   {
00110     KMessageBoxWrapper::error( 0L, i18n( "No mime types installed." ) );
00111     return; // no point in going any further
00112   }
00113 
00114   if ( KMimeType::mimeType( "inode/directory" ) == s_pDefaultType )
00115     errorMissingMimeType( "inode/directory" );
00116   if ( KMimeType::mimeType( "inode/directory-locked" ) == s_pDefaultType )
00117     errorMissingMimeType( "inode/directory-locked" );
00118   if ( KMimeType::mimeType( "inode/blockdevice" ) == s_pDefaultType )
00119     errorMissingMimeType( "inode/blockdevice" );
00120   if ( KMimeType::mimeType( "inode/chardevice" ) == s_pDefaultType )
00121     errorMissingMimeType( "inode/chardevice" );
00122   if ( KMimeType::mimeType( "inode/socket" ) == s_pDefaultType )
00123     errorMissingMimeType( "inode/socket" );
00124   if ( KMimeType::mimeType( "inode/fifo" ) == s_pDefaultType )
00125     errorMissingMimeType( "inode/fifo" );
00126   if ( KMimeType::mimeType( "application/x-shellscript" ) == s_pDefaultType )
00127     errorMissingMimeType( "application/x-shellscript" );
00128   if ( KMimeType::mimeType( "application/x-executable" ) == s_pDefaultType )
00129     errorMissingMimeType( "application/x-executable" );
00130   if ( KMimeType::mimeType( "application/x-desktop" ) == s_pDefaultType )
00131     errorMissingMimeType( "application/x-desktop" );
00132 }
00133 
00134 void KMimeType::errorMissingMimeType( const QString& _type )
00135 {
00136   QString tmp = i18n( "Could not find mime type\n%1" ).arg( _type );
00137 
00138   KMessageBoxWrapper::sorry( 0, tmp );
00139 }
00140 
00141 KMimeType::Ptr KMimeType::mimeType( const QString& _name )
00142 {
00143   KServiceType * mime = KServiceTypeFactory::self()->findServiceTypeByName( _name );
00144 
00145   if ( !mime || !mime->isType( KST_KMimeType ) )
00146   {
00147     // When building ksycoca, findServiceTypeByName doesn't create an object
00148     // but returns one from a dict.
00149     if ( !KSycoca::self()->isBuilding() )
00150         delete mime;
00151     if ( !s_pDefaultType )
00152       buildDefaultType();
00153     return s_pDefaultType;
00154   }
00155 
00156   // We got a mimetype
00157   return KMimeType::Ptr((KMimeType *) mime);
00158 }
00159 
00160 KMimeType::List KMimeType::allMimeTypes()
00161 {
00162   return KServiceTypeFactory::self()->allMimeTypes();
00163 }
00164 
00165 KMimeType::Ptr KMimeType::findByURL( const KURL& _url, mode_t _mode,
00166                                      bool _is_local_file, bool _fast_mode )
00167 {
00168   checkEssentialMimeTypes();
00169   QString path = _url.path();
00170 
00171   if ( !_fast_mode && !_is_local_file && _url.isLocalFile() )
00172     _is_local_file = true;
00173 
00174   if ( !_fast_mode && _is_local_file && (_mode == 0 || _mode == (mode_t)-1) )
00175   {
00176     KDE_struct_stat buff;
00177     if ( KDE_stat( QFile::encodeName(path), &buff ) != -1 )
00178       _mode = buff.st_mode;
00179   }
00180 
00181   // Look at mode_t first
00182   if ( S_ISDIR( _mode ) )
00183   {
00184     // Special hack for local files. We want to see whether we
00185     // are allowed to enter the directory
00186     if ( _is_local_file )
00187     {
00188       if ( access( QFile::encodeName(path), R_OK ) == -1 )
00189         return mimeType( "inode/directory-locked" );
00190     }
00191     return mimeType( "inode/directory" );
00192   }
00193   if ( S_ISCHR( _mode ) )
00194     return mimeType( "inode/chardevice" );
00195   if ( S_ISBLK( _mode ) )
00196     return mimeType( "inode/blockdevice" );
00197   if ( S_ISFIFO( _mode ) )
00198     return mimeType( "inode/fifo" );
00199   if ( S_ISSOCK( _mode ) )
00200     return mimeType( "inode/socket" );
00201   // KMimeMagic can do that better for local files
00202   if ( !_is_local_file && S_ISREG( _mode ) && ( _mode & ( S_IXUSR | S_IXGRP | S_IXOTH ) ) )
00203     return mimeType( "application/x-executable" );
00204 
00205   QString fileName ( _url.fileName() );
00206 
00207   static const QString& slash = KGlobal::staticQString("/");
00208   if ( ! fileName.isNull() && !path.endsWith( slash ) )
00209   {
00210       // Try to find it out by looking at the filename
00211       KMimeType::Ptr mime = KServiceTypeFactory::self()->findFromPattern( fileName );
00212       if ( mime )
00213       {
00214         // Found something - can we trust it ? (e.g. don't trust *.pl over HTTP, could be anything)
00215         if ( _is_local_file || _url.hasSubURL() || // Explicitly trust suburls
00216              KProtocolInfo::determineMimetypeFromExtension( _url.protocol() ) )
00217         {
00218             if ( _is_local_file && !_fast_mode ) {
00219                 if ( mime->patternsAccuracy()<100 )
00220                 {
00221                     KMimeMagicResult* result =
00222                             KMimeMagic::self()->findFileType( path );
00223 
00224                     if ( result && result->isValid() )
00225                         return mimeType( result->mimeType() );
00226                 }
00227             }
00228 
00229             return mime;
00230         }
00231       }
00232 
00233       static const QString& dotdesktop = KGlobal::staticQString(".desktop");
00234       static const QString& dotkdelnk = KGlobal::staticQString(".kdelnk");
00235       static const QString& dotdirectory = KGlobal::staticQString(".directory");
00236 
00237       // Another filename binding, hardcoded, is .desktop:
00238       if ( fileName.endsWith( dotdesktop ) )
00239         return mimeType( "application/x-desktop" );
00240       // Another filename binding, hardcoded, is .kdelnk;
00241       // this is preserved for backwards compatibility
00242       if ( fileName.endsWith( dotkdelnk ) )
00243         return mimeType( "application/x-desktop" );
00244       // .directory files are detected as x-desktop by mimemagic
00245       // but don't have a Type= entry. Better cheat and say they are text files
00246       if ( fileName == dotdirectory )
00247         return mimeType( "text/plain" );
00248     }
00249 
00250   if ( !_is_local_file || _fast_mode )
00251   {
00252     QString def = KProtocolInfo::defaultMimetype( _url );
00253     if ( !def.isEmpty() && def != defaultMimeType() )
00254     {
00255        // The protocol says it always returns a given mimetype (e.g. text/html for "man:")
00256        return mimeType( def );
00257     }
00258     if ( path.endsWith( slash ) || path.isEmpty() )
00259     {
00260       // We have no filename at all. Maybe the protocol has a setting for
00261       // which mimetype this means (e.g. directory).
00262       // For HTTP (def==defaultMimeType()) we don't assume anything,
00263       // because of redirections (e.g. freshmeat downloads).
00264       if ( def.isEmpty() )
00265       {
00266           // Assume inode/directory, if the protocol supports listing.
00267           if ( KProtocolInfo::supportsListing( _url ) )
00268               return mimeType( QString::fromLatin1("inode/directory") );
00269           else
00270               return defaultMimeTypePtr(); // == 'no idea', e.g. for "data:,foo/"
00271       }
00272     }
00273 
00274     // No more chances for non local URLs
00275     return defaultMimeTypePtr();
00276   }
00277 
00278   // Do some magic for local files
00279   //kdDebug(7009) << QString("Mime Type finding for '%1'").arg(path) << endl;
00280   KMimeMagicResult* result = KMimeMagic::self()->findFileType( path );
00281 
00282   // If we still did not find it, we must assume the default mime type
00283   if ( !result || !result->isValid() )
00284     return defaultMimeTypePtr();
00285 
00286   // The mimemagic stuff was successful
00287   return mimeType( result->mimeType() );
00288 }
00289 
00290 KMimeType::Ptr KMimeType::findByURL( const KURL& _url, mode_t _mode,
00291                                      bool _is_local_file, bool _fast_mode,
00292                                      bool *accurate)
00293 {
00294     KMimeType::Ptr mime = findByURL(_url, _mode, _is_local_file, _fast_mode);
00295     if (accurate) *accurate = !(_fast_mode) || ((mime->patternsAccuracy() == 100) && mime != defaultMimeTypePtr());
00296     return mime;
00297 }
00298 
00299 KMimeType::Ptr KMimeType::diagnoseFileName(const QString &fileName, QString &pattern)
00300 {
00301   return KServiceTypeFactory::self()->findFromPattern( fileName, &pattern );
00302 }
00303 
00304 KMimeType::Ptr KMimeType::findByPath( const QString& path, mode_t mode, bool fast_mode )
00305 {
00306     KURL u;
00307     u.setPath(path);
00308     return findByURL( u, mode, true, fast_mode );
00309 }
00310 
00311 KMimeType::Ptr KMimeType::findByContent( const QByteArray &data, int *accuracy )
00312 {
00313   KMimeMagicResult *result = KMimeMagic::self()->findBufferType(data);
00314   QString type = (result && result->isValid())?
00315     result->mimeType() : defaultMimeType();
00316   if (accuracy)
00317       *accuracy = result->accuracy();
00318   return mimeType( result->mimeType() );
00319 }
00320 
00321 KMimeType::Ptr KMimeType::findByFileContent( const QString &fileName, int *accuracy )
00322 {
00323   KMimeMagicResult *result = KMimeMagic::self()->findFileType(fileName);
00324   QString type = (result && result->isValid())?
00325     result->mimeType() : defaultMimeType();
00326   if (accuracy)
00327       *accuracy = result->accuracy();
00328   return mimeType( result->mimeType() );
00329 }
00330 
00331 #define GZIP_MAGIC1 0x1f
00332 #define GZIP_MAGIC2 0x8b
00333 
00334 KMimeType::Format KMimeType::findFormatByFileContent( const QString &fileName )
00335 {
00336   KMimeType::Format result;
00337   result.compression = Format::NoCompression;
00338   KMimeType::Ptr mime = findByPath(fileName);
00339   if (mime->name() == "application/octet-stream")
00340      mime =  findByFileContent(fileName);
00341 
00342   result.text = mime->name().startsWith("text/");
00343   QVariant v = mime->property("X-KDE-text");
00344   if (v.isValid())
00345      result.text = v.toBool();
00346 
00347   if (mime->name().startsWith("inode/"))
00348      return result;
00349 
00350   QFile f(fileName);
00351   if (f.open(IO_ReadOnly))
00352   {
00353      unsigned char buf[10+1];
00354      int l = f.readBlock((char *)buf, 10);
00355      if ((l > 2) && (buf[0] == GZIP_MAGIC1) && (buf[1] == GZIP_MAGIC2))
00356         result.compression = Format::GZipCompression;
00357   }
00358   return result;
00359 }
00360 
00361 KMimeType::KMimeType( const QString & _fullpath, const QString& _type, const QString& _icon,
00362                       const QString& _comment, const QStringList& _patterns )
00363   : KServiceType( _fullpath, _type, _icon, _comment )
00364 {
00365   m_lstPatterns = _patterns;
00366 }
00367 
00368 KMimeType::KMimeType( const QString & _fullpath ) : KServiceType( _fullpath )
00369 {
00370   KDesktopFile _cfg( _fullpath, true );
00371   init ( &_cfg );
00372 
00373   if ( !isValid() )
00374     kdWarning(7009) << "mimetype not valid '" << m_strName << "' (missing entry in the file ?)" << endl;
00375 }
00376 
00377 KMimeType::KMimeType( KDesktopFile *config ) : KServiceType( config )
00378 {
00379   init( config );
00380 
00381   if ( !isValid() )
00382     kdWarning(7009) << "mimetype not valid '" << m_strName << "' (missing entry in the file ?)" << endl;
00383 }
00384 
00385 void KMimeType::init( KDesktopFile * config )
00386 {
00387   config->setDesktopGroup();
00388   m_lstPatterns = config->readListEntry( "Patterns", ';' );
00389 
00390   // Read the X-KDE-AutoEmbed setting and store it in the properties map
00391   QString XKDEAutoEmbed = QString::fromLatin1("X-KDE-AutoEmbed");
00392   if ( config->hasKey( XKDEAutoEmbed ) )
00393     m_mapProps.insert( XKDEAutoEmbed, QVariant( config->readBoolEntry( XKDEAutoEmbed ), 0 ) );
00394 
00395   QString XKDEText = QString::fromLatin1("X-KDE-text");
00396   if ( config->hasKey( XKDEText ) )
00397     m_mapProps.insert( XKDEText, config->readBoolEntry( XKDEText ) );
00398 
00399   QString XKDEIsAlso = QString::fromLatin1("X-KDE-IsAlso");
00400   if ( config->hasKey( XKDEIsAlso ) )
00401     m_mapProps.insert( XKDEIsAlso, config->readEntry( XKDEIsAlso ) );
00402 
00403   QString XKDEPatternsAccuracy = QString::fromLatin1("X-KDE-PatternsAccuracy");
00404   if ( config->hasKey( XKDEPatternsAccuracy ) )
00405     m_mapProps.insert( XKDEPatternsAccuracy, config->readEntry( XKDEPatternsAccuracy ) );
00406 
00407 }
00408 
00409 KMimeType::KMimeType( QDataStream& _str, int offset ) : KServiceType( _str, offset )
00410 {
00411   loadInternal( _str ); // load our specific stuff
00412 }
00413 
00414 void KMimeType::load( QDataStream& _str )
00415 {
00416   KServiceType::load( _str );
00417   loadInternal( _str );
00418 }
00419 
00420 void KMimeType::loadInternal( QDataStream& _str )
00421 {
00422   // kdDebug(7009) << "KMimeType::load( QDataStream& ) : loading list of patterns" << endl;
00423   _str >> m_lstPatterns;
00424 }
00425 
00426 void KMimeType::save( QDataStream& _str )
00427 {
00428   KServiceType::save( _str );
00429   // Warning adding/removing fields here involves a binary incompatible change - update version
00430   // number in ksycoca.h
00431   _str << m_lstPatterns;
00432 }
00433 
00434 QVariant KMimeType::property( const QString& _name ) const
00435 {
00436   if ( _name == "Patterns" )
00437     return QVariant( m_lstPatterns );
00438 
00439   return KServiceType::property( _name );
00440 }
00441 
00442 QStringList KMimeType::propertyNames() const
00443 {
00444   QStringList res = KServiceType::propertyNames();
00445   res.append( "Patterns" );
00446 
00447   return res;
00448 }
00449 
00450 KMimeType::~KMimeType()
00451 {
00452 }
00453 
00454 QPixmap KMimeType::pixmap( KIcon::Group _group, int _force_size, int _state,
00455                            QString * _path ) const
00456 {
00457   KIconLoader *iconLoader=KGlobal::iconLoader();
00458   QString iconName=icon( QString::null, false );
00459   if (!iconLoader->extraDesktopThemesAdded())
00460   {
00461     QPixmap pixmap=iconLoader->loadIcon( iconName, _group, _force_size, _state, _path, true );
00462     if (!pixmap.isNull() ) return pixmap;
00463 
00464     iconLoader->addExtraDesktopThemes();
00465   }
00466 
00467   return iconLoader->loadIcon( iconName , _group, _force_size, _state, _path, false );
00468 }
00469 
00470 QPixmap KMimeType::pixmap( const KURL& _url, KIcon::Group _group, int _force_size,
00471                            int _state, QString * _path ) const
00472 {
00473   KIconLoader *iconLoader=KGlobal::iconLoader();
00474   QString iconName=icon( _url, _url.isLocalFile() );
00475   if (!iconLoader->extraDesktopThemesAdded())
00476   {
00477     QPixmap pixmap=iconLoader->loadIcon( iconName, _group, _force_size, _state, _path, true );
00478     if (!pixmap.isNull() ) return pixmap;
00479 
00480     iconLoader->addExtraDesktopThemes();
00481   }
00482 
00483   return iconLoader->loadIcon( iconName , _group, _force_size, _state, _path, false );
00484 }
00485 
00486 QPixmap KMimeType::pixmapForURL( const KURL & _url, mode_t _mode, KIcon::Group _group,
00487                                  int _force_size, int _state, QString * _path )
00488 {
00489   KIconLoader *iconLoader=KGlobal::iconLoader();
00490   QString iconName = iconForURL( _url, _mode );
00491 
00492   if (!iconLoader->extraDesktopThemesAdded())
00493   {
00494     QPixmap pixmap=iconLoader->loadIcon( iconName, _group, _force_size, _state, _path, true );
00495     if (!pixmap.isNull() ) return pixmap;
00496 
00497     iconLoader->addExtraDesktopThemes();
00498   }
00499 
00500   return iconLoader->loadIcon( iconName , _group, _force_size, _state, _path, false );
00501 
00502 }
00503 
00504 QString KMimeType::iconForURL( const KURL & _url, mode_t _mode )
00505 {
00506     const KMimeType::Ptr mt = findByURL( _url, _mode, _url.isLocalFile(),
00507                                          false /*HACK*/);
00508     static const QString& unknown = KGlobal::staticQString("unknown");
00509     const QString mimeTypeIcon = mt->icon( _url, _url.isLocalFile() );
00510     QString i = mimeTypeIcon;
00511 
00512     // if we don't find an icon, maybe we can use the one for the protocol
00513     if ( i == unknown || i.isEmpty() || mt == defaultMimeTypePtr()
00514         // and for the root of the protocol (e.g. trash:/) the protocol icon has priority over the mimetype icon
00515         || _url.path().length() <= 1 ) 
00516     {
00517         i = favIconForURL( _url ); // maybe there is a favicon?
00518 
00519         if ( i.isEmpty() )
00520             i = KProtocolInfo::icon( _url.protocol() );
00521 
00522         // root of protocol: if we found nothing, revert to mimeTypeIcon (which is usually "folder")
00523         if ( _url.path().length() <= 1 && ( i == unknown || i.isEmpty() ) )
00524             i = mimeTypeIcon;
00525     }
00526     return i;
00527 }
00528 
00529 QString KMimeType::favIconForURL( const KURL& url )
00530 {
00531     // this method will be called quite often, so better not read the config
00532     // again and again.
00533     static bool useFavIcons = true;
00534     static bool check = true;
00535     if ( check ) {
00536         check = false;
00537         KConfig *config = KGlobal::config();
00538         KConfigGroupSaver cs( config, "HTML Settings" );
00539         useFavIcons = config->readBoolEntry( "EnableFavicon", true );
00540     }
00541 
00542     if ( url.isLocalFile() || !url.protocol().startsWith("http")
00543          || !useFavIcons )
00544         return QString::null;
00545 
00546     DCOPRef kded( "kded", "favicons" );
00547     DCOPReply result = kded.call( "iconForURL(KURL)", url );
00548     if ( result.isValid() )
00549         return result;
00550 
00551     return QString::null;
00552 }
00553 
00554 QString KMimeType::parentMimeType() const
00555 {
00556   QVariant v = property("X-KDE-IsAlso");
00557   return v.toString();
00558 }
00559 
00560 bool KMimeType::is( const QString& mimeTypeName ) const
00561 {
00562   if ( name() == mimeTypeName )
00563       return true;
00564   QString st = parentMimeType();
00565   //if (st.isEmpty()) kdDebug(7009)<<"Parent mimetype is empty"<<endl;
00566   while ( !st.isEmpty() )
00567   {
00568       //kdDebug(7009)<<"Checking parent mime type: "<<st<<endl;
00569       KMimeType::Ptr ptr = KMimeType::mimeType( st );
00570       if (!ptr) return false; //error
00571       if ( ptr->name() == mimeTypeName )
00572           return true;
00573       st = ptr->parentMimeType();
00574   }
00575   return false;
00576 }
00577 
00578 int KMimeType::patternsAccuracy() const {
00579   QVariant v = property("X-KDE-PatternsAccuracy");
00580   if (!v.isValid()) return 100;
00581   else
00582       return v.toInt();
00583 }
00584 
00585 
00586 /*******************************************************
00587  *
00588  * KFolderType
00589  *
00590  ******************************************************/
00591 
00592 QString KFolderType::icon( const QString& _url, bool _is_local ) const
00593 {
00594   if ( !_is_local || _url.isEmpty() )
00595     return KMimeType::icon( _url, _is_local );
00596 
00597   return KFolderType::icon( KURL(_url), _is_local );
00598 }
00599 
00600 QString KFolderType::icon( const KURL& _url, bool _is_local ) const
00601 {
00602   if ( !_is_local )
00603     return KMimeType::icon( _url, _is_local );
00604 
00605   KURL u( _url );
00606   if( u.path() == KIO::findPathMountPoint( u.path())) {
00607     // don't mount automounted fs just because of trying to read .directory
00608     if( KIO::probably_slow_mounted( u.path()))
00609         return KMimeType::icon( _url, _is_local );
00610   }
00611   u.addPath( ".directory" );
00612 
00613   QString icon;
00614   // using KStandardDirs as this one checks for path being
00615   // a file instead of a directory
00616   if ( KStandardDirs::exists( u.path() ) )
00617   {
00618     KSimpleConfig cfg( u.path(), true );
00619     cfg.setDesktopGroup();
00620     icon = cfg.readEntry( "Icon" );
00621     QString empty_icon = cfg.readEntry( "EmptyIcon" );
00622 
00623     if ( !empty_icon.isEmpty() )
00624     {
00625       bool isempty = false;
00626       DIR *dp = 0L;
00627       struct dirent *ep;
00628       dp = opendir( QFile::encodeName(_url.path()) );
00629       if ( dp )
00630       {
00631         QValueList<QCString> entries;
00632         // Note that readdir isn't guaranteed to return "." and ".." first (#79826)
00633         ep=readdir( dp ); if ( ep ) entries.append( ep->d_name );
00634         ep=readdir( dp ); if ( ep ) entries.append( ep->d_name );
00635         if ( (ep=readdir( dp )) == 0L ) // third file is NULL entry -> empty directory
00636           isempty = true;
00637         else {
00638           entries.append( ep->d_name );
00639           if ( readdir( dp ) == 0 ) { // only three
00640             // check if we got "." ".." and ".directory"
00641             isempty = entries.find( "." ) != entries.end() &&
00642                       entries.find( ".." ) != entries.end() &&
00643                       entries.find( ".directory" ) != entries.end();
00644           }
00645         }
00646         if (!isempty && !strcmp(ep->d_name, ".directory"))
00647           isempty = (readdir(dp) == 0L);
00648         closedir( dp );
00649       }
00650 
00651       if ( isempty )
00652         return empty_icon;
00653     }
00654   }
00655 
00656   if ( icon.isEmpty() )
00657     return KMimeType::icon( _url, _is_local );
00658 
00659   if ( icon.startsWith( "./" ) ) {
00660     // path is relative with respect to the location
00661     // of the .directory file (#73463)
00662     KURL v( _url );
00663     v.addPath( icon.mid( 2 ) );
00664     icon = v.path();
00665   }
00666 
00667   return icon;
00668 }
00669 
00670 QString KFolderType::comment( const QString& _url, bool _is_local ) const
00671 {
00672   if ( !_is_local || _url.isEmpty() )
00673     return KMimeType::comment( _url, _is_local );
00674 
00675   return KFolderType::comment( KURL(_url), _is_local );
00676 }
00677 
00678 QString KFolderType::comment( const KURL& _url, bool _is_local ) const
00679 {
00680   if ( !_is_local )
00681     return KMimeType::comment( _url, _is_local );
00682 
00683   KURL u( _url );
00684   u.addPath( ".directory" );
00685 
00686   KSimpleConfig cfg( u.path(), true );
00687   cfg.setDesktopGroup();
00688   QString comment = cfg.readEntry( "Comment" );
00689   if ( comment.isEmpty() )
00690     return KMimeType::comment( _url, _is_local );
00691 
00692   return comment;
00693 }
00694 
00695 /*******************************************************
00696  *
00697  * KDEDesktopMimeType
00698  *
00699  ******************************************************/
00700 
00701 QString KDEDesktopMimeType::icon( const QString& _url, bool _is_local ) const
00702 {
00703   if ( !_is_local || _url.isEmpty() )
00704     return KMimeType::icon( _url, _is_local );
00705 
00706   KURL u( _url );
00707   return icon( u, _is_local );
00708 }
00709 
00710 QString KDEDesktopMimeType::icon( const KURL& _url, bool _is_local ) const
00711 {
00712   if ( !_is_local )
00713     return KMimeType::icon( _url, _is_local );
00714 
00715   KSimpleConfig cfg( _url.path(), true );
00716   cfg.setDesktopGroup();
00717   QString icon = cfg.readEntry( "Icon" );
00718   QString type = cfg.readEntry( "Type" );
00719 
00720   if ( type == "FSDevice" || type == "FSDev") // need to provide FSDev for
00721                                               // backwards compatibility
00722   {
00723     QString unmount_icon = cfg.readEntry( "UnmountIcon" );
00724     QString dev = cfg.readEntry( "Dev" );
00725     if ( !icon.isEmpty() && !unmount_icon.isEmpty() && !dev.isEmpty() )
00726     {
00727       QString mp = KIO::findDeviceMountPoint( dev );
00728       // Is the device not mounted ?
00729       if ( mp.isNull() )
00730         return unmount_icon;
00731     }
00732   } else if ( type == "Link" ) {
00733       const QString emptyIcon = cfg.readEntry( "EmptyIcon" );
00734       if ( !emptyIcon.isEmpty() ) {
00735           const QString u = cfg.readPathEntry( "URL" );
00736           const KURL url( u );
00737           if ( url.protocol() == "trash" ) {
00738               // We need to find if the trash is empty, preferrably without using a KIO job.
00739               // So instead kio_trash leaves an entry in its config file for us.
00740               KSimpleConfig trashConfig( "trashrc", true );
00741               trashConfig.setGroup( "Status" );
00742               if ( trashConfig.readBoolEntry( "Empty", true ) ) {
00743                   return emptyIcon;
00744               }
00745           }
00746       }
00747   }
00748 
00749   if ( icon.isEmpty() )
00750     return KMimeType::icon( _url, _is_local );
00751 
00752   return icon;
00753 }
00754 
00755 QPixmap KDEDesktopMimeType::pixmap( const KURL& _url, KIcon::Group _group, int _force_size,
00756                                     int _state, QString * _path ) const
00757 {
00758   QString _icon = icon( _url, _url.isLocalFile() );
00759   QPixmap pix = KGlobal::iconLoader()->loadIcon( _icon, _group,
00760         _force_size, _state, _path, false );
00761   if ( pix.isNull() )
00762       pix = KGlobal::iconLoader()->loadIcon( "unknown", _group,
00763         _force_size, _state, _path, false );
00764   return pix;
00765 }
00766 
00767 QString KDEDesktopMimeType::comment( const QString& _url, bool _is_local ) const
00768 {
00769   if ( !_is_local || _url.isEmpty() )
00770     return KMimeType::comment( _url, _is_local );
00771 
00772   KURL u( _url );
00773   return comment( u, _is_local );
00774 }
00775 
00776 QString KDEDesktopMimeType::comment( const KURL& _url, bool _is_local ) const
00777 {
00778   if ( !_is_local )
00779     return KMimeType::comment( _url, _is_local );
00780 
00781   KSimpleConfig cfg( _url.path(), true );
00782   cfg.setDesktopGroup();
00783   QString comment = cfg.readEntry( "Comment" );
00784   if ( comment.isEmpty() )
00785     return KMimeType::comment( _url, _is_local );
00786 
00787   return comment;
00788 }
00789 
00790 pid_t KDEDesktopMimeType::run( const KURL& u, bool _is_local )
00791 {
00792   // It might be a security problem to run external untrusted desktop
00793   // entry files
00794   if ( !_is_local )
00795     return 0;
00796 
00797   KSimpleConfig cfg( u.path(), true );
00798   cfg.setDesktopGroup();
00799   QString type = cfg.readEntry( "Type" );
00800   if ( type.isEmpty() )
00801   {
00802     QString tmp = i18n("The desktop entry file %1 "
00803                        "has no Type=... entry.").arg(u.path() );
00804     KMessageBoxWrapper::error( 0, tmp);
00805     return 0;
00806   }
00807 
00808   //kdDebug(7009) << "TYPE = " << type.data() << endl;
00809 
00810   if ( type == "FSDevice" )
00811     return runFSDevice( u, cfg );
00812   else if ( type == "Application" )
00813     return runApplication( u, u.path() );
00814   else if ( type == "Link" )
00815   {
00816     cfg.setDollarExpansion( true ); // for URL=file:$HOME (Simon)
00817     return runLink( u, cfg );
00818   }
00819   else if ( type == "MimeType" )
00820     return runMimeType( u, cfg );
00821 
00822 
00823   QString tmp = i18n("The desktop entry of type\n%1\nis unknown.").arg( type );
00824   KMessageBoxWrapper::error( 0, tmp);
00825 
00826   return 0;
00827 }
00828 
00829 pid_t KDEDesktopMimeType::runFSDevice( const KURL& _url, const KSimpleConfig &cfg )
00830 {
00831   pid_t retval = 0;
00832 
00833   QString dev = cfg.readEntry( "Dev" );
00834 
00835   if ( dev.isEmpty() )
00836   {
00837     QString tmp = i18n("The desktop entry file\n%1\nis of type FSDevice but has no Dev=... entry.").arg( _url.path() );
00838     KMessageBoxWrapper::error( 0, tmp);
00839     return retval;
00840   }
00841 
00842   QString mp = KIO::findDeviceMountPoint( dev );
00843   // Is the device already mounted ?
00844   if ( !mp.isNull() )
00845   {
00846     KURL mpURL;
00847     mpURL.setPath( mp );
00848     // Open a new window
00849     retval = KRun::runURL( mpURL, QString::fromLatin1("inode/directory") );
00850   }
00851   else
00852   {
00853     bool ro = cfg.readBoolEntry( "ReadOnly", false );
00854     QString fstype = cfg.readEntry( "FSType" );
00855     if ( fstype == "Default" ) // KDE-1 thing
00856       fstype = QString::null;
00857     QString point = cfg.readEntry( "MountPoint" );
00858 #ifndef Q_WS_WIN
00859     (void) new KAutoMount( ro, fstype, dev, point, _url.path() );
00860 #endif
00861     retval = -1; // we don't want to return 0, but we don't want to return a pid
00862   }
00863 
00864   return retval;
00865 }
00866 
00867 pid_t KDEDesktopMimeType::runApplication( const KURL& , const QString & _serviceFile )
00868 {
00869   KService s( _serviceFile );
00870   if ( !s.isValid() )
00871     // The error message was already displayed, so we can just quit here
00872     return 0;
00873 
00874   KURL::List lst;
00875   return KRun::run( s, lst );
00876 }
00877 
00878 pid_t KDEDesktopMimeType::runLink( const KURL& _url, const KSimpleConfig &cfg )
00879 {
00880   QString u = cfg.readPathEntry( "URL" );
00881   if ( u.isEmpty() )
00882   {
00883     QString tmp = i18n("The desktop entry file\n%1\nis of type Link but has no URL=... entry.").arg( _url.prettyURL() );
00884     KMessageBoxWrapper::error( 0, tmp );
00885     return 0;
00886   }
00887 
00888   KURL url ( u );
00889   KRun* run = new KRun(url);
00890 
00891   // X-KDE-LastOpenedWith holds the service desktop entry name that
00892   // was should be preferred for opening this URL if possible.
00893   // This is used by the Recent Documents menu for instance.
00894   QString lastOpenedWidth = cfg.readEntry( "X-KDE-LastOpenedWith" );
00895   if ( !lastOpenedWidth.isEmpty() )
00896       run->setPreferredService( lastOpenedWidth );
00897 
00898   return -1; // we don't want to return 0, but we don't want to return a pid
00899 }
00900 
00901 pid_t KDEDesktopMimeType::runMimeType( const KURL& url , const KSimpleConfig & )
00902 {
00903   // Hmm, can't really use keditfiletype since we might be looking
00904   // at the global file, or at a file not in share/mimelnk...
00905 
00906   QStringList args;
00907   args << "openProperties";
00908   args << url.path();
00909 
00910   int pid;
00911   if ( !KApplication::kdeinitExec("kfmclient", args, 0, &pid) )
00912       return pid;
00913 
00914   KProcess p;
00915   p << "kfmclient" << args;
00916   p.start(KProcess::DontCare);
00917   return p.pid();
00918 }
00919 
00920 QValueList<KDEDesktopMimeType::Service> KDEDesktopMimeType::builtinServices( const KURL& _url )
00921 {
00922   QValueList<Service> result;
00923 
00924   if ( !_url.isLocalFile() )
00925     return result;
00926 
00927   KSimpleConfig cfg( _url.path(), true );
00928   cfg.setDesktopGroup();
00929   QString type = cfg.readEntry( "Type" );
00930 
00931   if ( type.isEmpty() )
00932     return result;
00933 
00934   if ( type == "FSDevice" )
00935   {
00936     QString dev = cfg.readEntry( "Dev" );
00937     if ( dev.isEmpty() )
00938     {
00939       QString tmp = i18n("The desktop entry file\n%1\nis of type FSDevice but has no Dev=... entry.").arg( _url.path() );
00940       KMessageBoxWrapper::error( 0, tmp);
00941     }
00942     else
00943     {
00944       QString mp = KIO::findDeviceMountPoint( dev );
00945       // not mounted ?
00946       if ( mp.isEmpty() )
00947       {
00948         Service mount;
00949         mount.m_strName = i18n("Mount");
00950         mount.m_type = ST_MOUNT;
00951         result.append( mount );
00952       }
00953       else
00954       {
00955         Service unmount;
00956 #ifdef HAVE_VOLMGT
00957         /*
00958          *  Solaris' volume management can only umount+eject
00959          */
00960         unmount.m_strName = i18n("Eject");
00961 #else
00962         unmount.m_strName = i18n("Unmount");
00963 #endif
00964         unmount.m_type = ST_UNMOUNT;
00965         result.append( unmount );
00966       }
00967     }
00968   }
00969 
00970   return result;
00971 }
00972 
00973 QValueList<KDEDesktopMimeType::Service> KDEDesktopMimeType::userDefinedServices( const QString& path, bool bLocalFiles )
00974 {
00975   KSimpleConfig cfg( path, true );
00976   return userDefinedServices( path, cfg, bLocalFiles );
00977 }
00978 
00979 QValueList<KDEDesktopMimeType::Service> KDEDesktopMimeType::userDefinedServices( const QString& path, KConfig& cfg, bool bLocalFiles )
00980 {
00981   QValueList<Service> result;
00982 
00983   cfg.setDesktopGroup();
00984 
00985   if ( !cfg.hasKey( "Actions" ) )
00986     return result;
00987 
00988   if ( cfg.hasKey( "TryExec" ) )
00989   {
00990       QString tryexec = cfg.readPathEntry( "TryExec" );
00991       QString exe =  KStandardDirs::findExe( tryexec );
00992       if (exe.isEmpty()) {
00993           return result;
00994       }
00995   }
00996 
00997   QStringList keys = cfg.readListEntry( "Actions", ';' ); //the desktop standard defines ";" as separator!
00998 
00999   if ( keys.count() == 0 )
01000     return result;
01001 
01002   QStringList::ConstIterator it = keys.begin();
01003   QStringList::ConstIterator end = keys.end();
01004   for ( ; it != end; ++it )
01005   {
01006     //kdDebug(7009) << "CURRENT KEY = " << (*it) << endl;
01007 
01008     QString group = *it;
01009 
01010     if (group == "_SEPARATOR_")
01011     {
01012         Service s;
01013         result.append(s);
01014         continue;
01015     }
01016 
01017     group.prepend( "Desktop Action " );
01018 
01019     bool bInvalidMenu = false;
01020 
01021     if ( cfg.hasGroup( group ) )
01022     {
01023       cfg.setGroup( group );
01024 
01025       if ( !cfg.hasKey( "Name" ) || !cfg.hasKey( "Exec" ) )
01026         bInvalidMenu = true;
01027       else
01028       {
01029         QString exec = cfg.readPathEntry( "Exec" );
01030         if ( bLocalFiles || exec.contains("%U") || exec.contains("%u") )
01031         {
01032           Service s;
01033           s.m_strName = cfg.readEntry( "Name" );
01034           s.m_strIcon = cfg.readEntry( "Icon" );
01035           s.m_strExec = exec;
01036           s.m_type = ST_USER_DEFINED;
01037           s.m_display = !cfg.readBoolEntry( "NoDisplay" );
01038           result.append( s );
01039         }
01040       }
01041     }
01042     else
01043       bInvalidMenu = true;
01044 
01045     if ( bInvalidMenu )
01046     {
01047       QString tmp = i18n("The desktop entry file\n%1\n has an invalid menu entry\n%2.").arg( path ).arg( *it );
01048       KMessageBoxWrapper::error( 0, tmp );
01049     }
01050   }
01051 
01052   return result;
01053 }
01054 
01055 void KDEDesktopMimeType::executeService( const QString& _url, KDEDesktopMimeType::Service& _service )
01056 {
01057     KURL u;
01058     u.setPath(_url);
01059     KURL::List lst;
01060     lst.append( u );
01061     executeService( lst, _service );
01062 }
01063 
01064 void KDEDesktopMimeType::executeService( const KURL::List& urls, KDEDesktopMimeType::Service& _service )
01065 {
01066   //kdDebug(7009) << "EXECUTING Service " << _service.m_strName << endl;
01067 
01068   if ( _service.m_type == ST_USER_DEFINED )
01069   {
01070     kdDebug() << "KDEDesktopMimeType::executeService " << _service.m_strName
01071               << " first url's path=" << urls.first().path() << " exec=" << _service.m_strExec << endl;
01072     KRun::run( _service.m_strExec, urls, _service.m_strName, _service.m_strIcon, _service.m_strIcon );
01073     // The action may update the desktop file. Example: eject unmounts (#5129).
01074     KDirNotify_stub allDirNotify("*", "KDirNotify*");
01075     allDirNotify.FilesChanged( urls );
01076     return;
01077   }
01078   else if ( _service.m_type == ST_MOUNT || _service.m_type == ST_UNMOUNT )
01079   {
01080     Q_ASSERT( urls.count() == 1 );
01081     QString path = urls.first().path();
01082     //kdDebug(7009) << "MOUNT&UNMOUNT" << endl;
01083 
01084     KSimpleConfig cfg( path, true );
01085     cfg.setDesktopGroup();
01086     QString dev = cfg.readEntry( "Dev" );
01087     if ( dev.isEmpty() )
01088     {
01089       QString tmp = i18n("The desktop entry file\n%1\nis of type FSDevice but has no Dev=... entry.").arg( path );
01090       KMessageBoxWrapper::error( 0, tmp );
01091       return;
01092     }
01093     QString mp = KIO::findDeviceMountPoint( dev );
01094 
01095     if ( _service.m_type == ST_MOUNT )
01096     {
01097       // Already mounted? Strange, but who knows ...
01098       if ( !mp.isEmpty() )
01099       {
01100         kdDebug(7009) << "ALREADY Mounted" << endl;
01101         return;
01102       }
01103 
01104       bool ro = cfg.readBoolEntry( "ReadOnly", false );
01105       QString fstype = cfg.readEntry( "FSType" );
01106       if ( fstype == "Default" ) // KDE-1 thing
01107           fstype = QString::null;
01108       QString point = cfg.readEntry( "MountPoint" );
01109 #ifndef Q_WS_WIN
01110       (void)new KAutoMount( ro, fstype, dev, point, path, false );
01111 #endif
01112     }
01113     else if ( _service.m_type == ST_UNMOUNT )
01114     {
01115       // Not mounted? Strange, but who knows ...
01116       if ( mp.isEmpty() )
01117         return;
01118 
01119 #ifndef Q_WS_WIN
01120       (void)new KAutoUnmount( mp, path );
01121 #endif
01122     }
01123   }
01124   else
01125     assert( 0 );
01126 }
01127 
01128 const QString & KMimeType::defaultMimeType()
01129 {
01130     static const QString & s_strDefaultMimeType =
01131         KGlobal::staticQString( "application/octet-stream" );
01132     return s_strDefaultMimeType;
01133 }
01134 
01135 void KMimeType::virtual_hook( int id, void* data )
01136 { KServiceType::virtual_hook( id, data ); }
01137 
01138 void KFolderType::virtual_hook( int id, void* data )
01139 { KMimeType::virtual_hook( id, data ); }
01140 
01141 void KDEDesktopMimeType::virtual_hook( int id, void* data )
01142 { KMimeType::virtual_hook( id, data ); }
01143 
01144 void KExecMimeType::virtual_hook( int id, void* data )
01145 { KMimeType::virtual_hook( id, data ); }
01146 
01147 #include "kmimetyperesolver.moc"
01148 
KDE Logo
This file is part of the documentation for kio Library Version 3.4.1.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Tue Nov 1 10:33:17 2005 by doxygen 1.4.3 written by Dimitri van Heesch, © 1997-2003