Skip to main content :: ::

KDE API Reference

:: Skip to Link Menu

/ API Reference / kio / kio

global.cpp /* This file is part of the KDE libraries Copyright (C) 2000 David Faure <faure@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 version 2 as published by the Free Software Foundation. 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. */ #include <config.h> #include <sys/types.h> #include <sys/wait.h> #include <sys/uio.h> #include <assert.h> #include <signal.h> #include <stdlib.h> #include <string.h> #include <unistd.h> #include <stdio.h> #include "kio/global.h" #include "kio/job.h" #include <kdebug.h> #include <klocale.h> #include <kglobal.h> #include <kprotocolmanager.h> #include <kde_file.h> #ifdef HAVE_VOLMGT #include <volmgt.h> #endif KIO_EXPORT QString KIO::convertSizeWithBytes( KIO::filesize_t size ) { if ( size >= 1024 ) return convertSize( size ) + " (" + i18n( "%1 B" ).arg( KGlobal::locale()->formatNumber(size, 0) ) + ")"; else return convertSize( size ); } KIO_EXPORT QString KIO::convertSize( KIO::filesize_t size ) { double fsize = size; QString s; // Giga-byte if ( size >= 1073741824 ) { fsize /= 1073741824.0; if ( fsize > 1024 ) // Tera-byte s = i18n( "%1 TB" ).arg( KGlobal::locale()->formatNumber(fsize / 1024.0, 1)); else s = i18n( "%1 GB" ).arg( KGlobal::locale()->formatNumber(fsize, 1)); } // Mega-byte else if ( size >= 1048576 ) { fsize /= 1048576.0; s = i18n( "%1 MB" ).arg( KGlobal::locale()->formatNumber(fsize, 1)); } // Kilo-byte else if ( size >= 1024 ) { fsize /= 1024.0; s = i18n( "%1 KB" ).arg( KGlobal::locale()->formatNumber(fsize, 1)); } // Just byte else if ( size > 0 ) { s = i18n( "%1 B" ).arg( KGlobal::locale()->formatNumber(fsize, 0)); } // Nothing else { s = i18n( "0 B" ); } return s; } KIO_EXPORT QString KIO::convertSizeFromKB( KIO::filesize_t kbSize ) { return convertSize(kbSize * 1024); } KIO_EXPORT QString KIO::number( KIO::filesize_t size ) { char charbuf[256]; sprintf(charbuf, "%lld", size); return QString::fromLatin1(charbuf); } KIO_EXPORT unsigned int KIO::calculateRemainingSeconds( KIO::filesize_t totalSize, KIO::filesize_t processedSize, KIO::filesize_t speed ) { if ( (speed != 0) && (totalSize != 0) ) return ( totalSize - processedSize ) / speed; else return 0; } KIO_EXPORT QString KIO::convertSeconds( unsigned int seconds ) { unsigned int days = seconds / 86400; unsigned int hours = (seconds - (days * 86400)) / 3600; unsigned int mins = (seconds - (days * 86400) - (hours * 3600)) / 60; seconds = (seconds - (days * 86400) - (hours * 3600) - (mins * 60)); const QTime time(hours, mins, seconds); const QString timeStr( KGlobal::locale()->formatTime(time, true /*with seconds*/, true /*duration*/) ); if ( days > 0 ) return i18n("1 day %1", "%n days %1", days).arg(timeStr); else return timeStr; } KIO_EXPORT QTime KIO::calculateRemaining( KIO::filesize_t totalSize, KIO::filesize_t processedSize, KIO::filesize_t speed ) { QTime remainingTime; if ( speed != 0 ) { KIO::filesize_t secs; if ( totalSize == 0 ) { secs = 0; } else { secs = ( totalSize - processedSize ) / speed; } if (secs >= (24*60*60)) // Limit to 23:59:59 secs = (24*60*60)-1; int hr = secs / ( 60 * 60 ); int mn = ( secs - hr * 60 * 60 ) / 60; int sc = ( secs - hr * 60 * 60 - mn * 60 ); remainingTime.setHMS( hr, mn, sc ); } return remainingTime; } KIO_EXPORT QString KIO::itemsSummaryString(uint items, uint files, uint dirs, KIO::filesize_t size, bool showSize) { QString text = items == 0 ? i18n( "No Items" ) : i18n( "One Item", "%n Items", items ); text += " - "; text += files == 0 ? i18n( "No Files" ) : i18n( "One File", "%n Files", files ); if ( showSize && files > 0 ) { text += " "; text += i18n("(%1 Total)").arg(KIO::convertSize( size ) ); } text += " - "; text += dirs == 0 ? i18n( "No Folders" ) : i18n("One Folder", "%n Folders", dirs); return text; } KIO_EXPORT QString KIO::encodeFileName( const QString & _str ) { QString str( _str ); int i = 0; while ( ( i = str.find( "%", i ) ) != -1 ) { str.replace( i, 1, "%%"); i += 2; } while ( ( i = str.find( "/" ) ) != -1 ) str.replace( i, 1, "%2f"); return str; } KIO_EXPORT QString KIO::decodeFileName( const QString & _str ) { QString str; unsigned int i = 0; for ( ; i < _str.length() ; ++i ) { if ( _str[i]=='%' ) { if ( _str[i+1]=='%' ) // %% -> % { str.append('%'); ++i; } else if ( _str[i+1]=='2' && (i+2<_str.length()) && _str[i+2].lower()=='f' ) // %2f -> / { str.append('/'); i += 2; } else str.append('%'); } else str.append(_str[i]); } return str; } KIO_EXPORT QString KIO::Job::errorString() const { return KIO::buildErrorString(m_error, m_errorText); } KIO_EXPORT QString KIO::buildErrorString(int errorCode, const QString &errorText) { QString result; switch( errorCode ) { case KIO::ERR_CANNOT_OPEN_FOR_READING: result = i18n( "Could not read %1." ).arg( errorText ); break; case KIO::ERR_CANNOT_OPEN_FOR_WRITING: result = i18n( "Could not write to %1." ).arg( errorText ); break; case KIO::ERR_CANNOT_LAUNCH_PROCESS: result = i18n( "Could not start process %1." ).arg( errorText ); break; case KIO::ERR_INTERNAL: result = i18n( "Internal Error\nPlease send a full bug report at http://bugs.kde.org\n%1" ).arg( errorText ); break; case KIO::ERR_MALFORMED_URL: result = i18n( "Malformed URL %1." ).arg( errorText ); break; case KIO::ERR_UNSUPPORTED_PROTOCOL: result = i18n( "The protocol %1 is not supported." ).arg( errorText ); break; case KIO::ERR_NO_SOURCE_PROTOCOL: result = i18n( "The protocol %1 is only a filter protocol.").arg( errorText ); break; case KIO::ERR_UNSUPPORTED_ACTION: result = errorText; // result = i18n( "Unsupported action %1" ).arg( errorText ); break; case KIO::ERR_IS_DIRECTORY: result = i18n( "%1 is a folder, but a file was expected." ).arg( errorText ); break; case KIO::ERR_IS_FILE: result = i18n( "%1 is a file, but a folder was expected." ).arg( errorText ); break; case KIO::ERR_DOES_NOT_EXIST: result = i18n( "The file or folder %1 does not exist." ).arg( errorText ); break; case KIO::ERR_FILE_ALREADY_EXIST: result = i18n( "A file named %1 already exists." ).arg( errorText ); break; case KIO::ERR_DIR_ALREADY_EXIST: result = i18n( "A folder named %1 already exists." ).arg( errorText ); break; case KIO::ERR_UNKNOWN_HOST: result = errorText.isEmpty() ? i18n( "No hostname specified." ) : i18n( "Unknown host %1" ).arg( errorText ); break; case KIO::ERR_ACCESS_DENIED: result = i18n( "Access denied to %1." ).arg( errorText ); break; case KIO::ERR_WRITE_ACCESS_DENIED: result = i18n( "Access denied.\nCould not write to %1." ).arg( errorText ); break; case KIO::ERR_CANNOT_ENTER_DIRECTORY: result = i18n( "Could not enter folder %1." ).arg( errorText ); break; case KIO::ERR_PROTOCOL_IS_NOT_A_FILESYSTEM: result = i18n( "The protocol %1 does not implement a folder service." ).arg( errorText ); break; case KIO::ERR_CYCLIC_LINK: result = i18n( "Found a cyclic link in %1." ).arg( errorText ); break; case KIO::ERR_USER_CANCELED: // Do nothing in this case. The user doesn't need to be told what he just did. break; case KIO::ERR_CYCLIC_COPY: result = i18n( "Found a cyclic link while copying %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_CREATE_SOCKET: result = i18n( "Could not create socket for accessing %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_CONNECT: result = i18n( "Could not connect to host %1." ).arg( errorText.isEmpty() ? QString::fromLatin1("localhost") : errorText ); break; case KIO::ERR_CONNECTION_BROKEN: result = i18n( "Connection to host %1 is broken." ).arg( errorText ); break; case KIO::ERR_NOT_FILTER_PROTOCOL: result = i18n( "The protocol %1 is not a filter protocol." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_MOUNT: result = i18n( "Could not mount device.\nThe reported error was:\n%1" ).arg( errorText ); break; case KIO::ERR_COULD_NOT_UNMOUNT: result = i18n( "Could not unmount device.\nThe reported error was:\n%1" ).arg( errorText ); break; case KIO::ERR_COULD_NOT_READ: result = i18n( "Could not read file %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_WRITE: result = i18n( "Could not write to file %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_BIND: result = i18n( "Could not bind %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_LISTEN: result = i18n( "Could not listen %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_ACCEPT: result = i18n( "Could not accept %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_LOGIN: result = errorText; break; case KIO::ERR_COULD_NOT_STAT: result = i18n( "Could not access %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_CLOSEDIR: result = i18n( "Could not terminate listing %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_MKDIR: result = i18n( "Could not make folder %1." ).arg( errorText ); break; case KIO::ERR_COULD_NOT_RMDIR: result = i18n( "Could not remove folder %1." ).arg( errorText ); break; case KIO::ERR_CANNOT_RESUME: result = i18n( "Could not resume file %1." ).arg( errorText ); break; case KIO::ERR_CANNOT_RENAME: result = i18n( "Could not rename file %1." ).arg( errorText ); break; case KIO::ERR_CANNOT_CHMOD: result = i18n( "Could not change permissions for %1." ).arg( errorText ); break; case KIO::ERR_CANNOT_DELETE: result = i18n( "Could not delete file %1." ).arg( errorText ); break; case KIO::ERR_SLAVE_DIED: result = i18n( "The process for the %1 protocol died unexpectedly." ).arg( errorText ); break; case KIO::ERR_OUT_OF_MEMORY: result = i18n( "Error. Out of memory.\n%1" ).arg( errorText ); break; case KIO::ERR_UNKNOWN_PROXY_HOST: result = i18n( "Unknown proxy host\n%1" ).arg( errorText ); break; case KIO::ERR_COULD_NOT_AUTHENTICATE: result = i18n( "Authorization failed, %1 authentication not supported" ).arg( errorText ); break; case KIO::ERR_ABORTED: result = i18n( "User canceled action\n%1" ).arg( errorText ); break; case KIO::ERR_INTERNAL_SERVER: result = i18n( "Internal error in server\n%1" ).arg( errorText ); break; case KIO::ERR_SERVER_TIMEOUT: result = i18n( "Timeout on server\n%1" ).arg( errorText ); break; case KIO::ERR_UNKNOWN: result = i18n( "Unknown error\n%1" ).arg( errorText ); break; case KIO::ERR_UNKNOWN_INTERRUPT: result = i18n( "Unknown interrupt\n%1" ).arg( errorText ); break; /* case KIO::ERR_CHECKSUM_MISMATCH: if (errorText) result = i18n( "Warning: MD5 Checksum for %1 does not match checksum returned from server" ).arg(errorText); else result = i18n( "Warning: MD5 Checksum for %1 does not match checksum returned from server" ).arg("document"); break; */ case KIO::ERR_CANNOT_DELETE_ORIGINAL: result = i18n( "Could not delete original file %1.\nPlease check permissions." ).arg( errorText ); break; case KIO::ERR_CANNOT_DELETE_PARTIAL: result = i18n( "Could not delete partial file %1.\nPlease check permissions." ).arg( errorText ); break; case KIO::ERR_CANNOT_RENAME_ORIGINAL: result = i18n( "Could not rename original file %1.\nPlease check permissions." ).arg( errorText ); break; case KIO::ERR_CANNOT_RENAME_PARTIAL: result = i18n( "Could not rename partial file %1.\nPlease check permissions." ).arg( errorText ); break; case KIO::ERR_CANNOT_SYMLINK: result = i18n( "Could not create symlink %1.\nPlease check permissions." ).arg( errorText ); break; case KIO::ERR_NO_CONTENT: result = errorText; break; case KIO::ERR_DISK_FULL: result = i18n( "Could not write file %1.\nDisk full." ).arg( errorText ); break; case KIO::ERR_IDENTICAL_FILES: result = i18n( "The source and destination are the same file.\n%1" ).arg( errorText ); break; case KIO::ERR_SLAVE_DEFINED: result = errorText; break; case KIO::ERR_UPGRADE_REQUIRED: result = i18n( "%1 is required by the server, but is not available." ).arg(errorText); break; case KIO::ERR_POST_DENIED: result = i18n( "Access to restricted port in POST denied."); break; default: result = i18n( "Unknown error code %1\n%2\nPlease send a full bug report at http://bugs.kde.org." ).arg( errorCode ).arg( errorText ); break; } return result; } KIO_EXPORT QString KIO::unsupportedActionErrorString(const QString &protocol, int cmd) { switch (cmd) { case CMD_CONNECT: return i18n("Opening connections is not supported with the protocol %1." ).arg(protocol); case CMD_DISCONNECT: return i18n("Closing connections is not supported with the protocol %1." ).arg(protocol); case CMD_STAT: return i18n("Accessing files is not supported with the protocol %1.").arg(protocol); case CMD_PUT: return i18n("Writing to %1 is not supported.").arg(protocol); case CMD_SPECIAL: return i18n("There are no special actions available for protocol %1.").arg(protocol); case CMD_LISTDIR: return i18n("Listing folders is not supported for protocol %1.").arg(protocol); case CMD_GET: return i18n("Retrieving data from %1 is not supported.").arg(protocol); case CMD_MIMETYPE: return i18n("Retrieving mime type information from %1 is not supported.").arg(protocol); case CMD_RENAME: return i18n("Renaming or moving files within %1 is not supported.").arg(protocol); case CMD_SYMLINK: return i18n("Creating symlinks is not supported with protocol %1.").arg(protocol); case CMD_COPY: return i18n("Copying files within %1 is not supported.").arg(protocol); case CMD_DEL: return i18n("Deleting files from %1 is not supported.").arg(protocol); case CMD_MKDIR: return i18n("Creating folders is not supported with protocol %1.").arg(protocol); case CMD_CHMOD: return i18n("Changing the attributes of files is not supported with protocol %1.").arg(protocol); case CMD_SUBURL: return i18n("Using sub-URLs with %1 is not supported.").arg(protocol); case CMD_MULTI_GET: return i18n("Multiple get is not supported with protocol %1.").arg(protocol); default: return i18n("Protocol %1 does not support action %2.").arg(protocol).arg(cmd); }/*end switch*/ } KIO_EXPORT QStringList KIO::Job::detailedErrorStrings( const KURL *reqUrl /*= 0L*/, int method /*= -1*/ ) const { QString errorName, techName, description, ret2; QStringList causes, solutions, ret; QByteArray raw = rawErrorDetail( m_error, m_errorText, reqUrl, method ); QDataStream stream(raw, IO_ReadOnly); stream >> errorName >> techName >> description >> causes >> solutions; QString url, protocol, datetime; if ( reqUrl ) { url = reqUrl->htmlURL(); protocol = reqUrl->protocol(); } else { url = i18n( "(unknown)" ); } datetime = KGlobal::locale()->formatDateTime( QDateTime::currentDateTime(), false ); ret << errorName; ret << QString::fromLatin1( "<qt><p><b>" ) + errorName + QString::fromLatin1( "</b></p><p>" ) + description + QString::fromLatin1( "</p>" ); ret2 = QString::fromLatin1( "<qt><p>" ); if ( !techName.isEmpty() ) ret2 += i18n( "<b>Technical reason</b>: " ) + techName + QString::fromLatin1( "</p>" ); ret2 += i18n( "</p><p><b>Details of the request</b>:" ); ret2 += i18n( "</p><ul><li>URL: %1</li>" ).arg( url ); if ( !protocol.isEmpty() ) { ret2 += i18n( "<li>Protocol: %1</li>" ).arg( protocol ); } ret2 += i18n( "<li>Date and time: %1</li>" ).arg( datetime ); ret2 += i18n( "<li>Additional information: %1</li></ul>" ).arg( m_errorText ); if ( !causes.isEmpty() ) { ret2 += i18n( "<p><b>Possible causes</b>:</p><ul><li>" ); ret2 += causes.join( "</li><li>" ); ret2 += QString::fromLatin1( "</li></ul>" ); } if ( !solutions.isEmpty() ) { ret2 += i18n( "<p><b>Possible solutions</b>:</p><ul><li>" ); ret2 += solutions.join( "</li><li>" ); ret2 += QString::fromLatin1( "</li></ul>" ); } ret << ret2; return ret; } KIO_EXPORT QByteArray KIO::rawErrorDetail(int errorCode, const QString &errorText, const KURL *reqUrl /*= 0L*/, int /*method = -1*/ ) { QString url, host, protocol, datetime, domain, path, dir, filename; bool isSlaveNetwork = false; if ( reqUrl ) { url = reqUrl->prettyURL(); host = reqUrl->host(); protocol = reqUrl->protocol(); if ( host.left(4) == "www." ) domain = host.mid(4); else domain = host; path = reqUrl->path(1); filename = reqUrl->fileName(); dir = path + filename; // detect if protocol is a network protocol... // add your hacks here... if ( protocol == "http" || protocol == "https" || protocol == "ftp" || protocol == "sftp" || protocol == "webdav" || protocol == "webdavs" || protocol == "finger" || protocol == "fish" || protocol == "gopher" || protocol == "imap" || protocol == "imaps" || protocol == "lan" || protocol == "ldap" || protocol == "mailto" || protocol == "news" || protocol == "nntp" || protocol == "pop3" || protocol == "pop3s" || protocol == "smtp" || protocol == "smtps" || protocol == "telnet" ) { isSlaveNetwork = false; } } else { // assume that the errorText has the location we are interested in url = host = domain = path = filename = dir = errorText; protocol = i18n( "(unknown)" ); } datetime = KGlobal::locale()->formatDateTime( QDateTime::currentDateTime(), false ); QString errorName, techName, description; QStringList causes, solutions; // c == cause, s == solution QString sSysadmin = i18n( "Contact your appropriate computer support system, " "whether the system administrator, or technical support group for further " "assistance." ); QString sServeradmin = i18n( "Contact the administrator of the server " "for further assistance." ); // FIXME active link to permissions dialog QString sAccess = i18n( "Check your access permissions on this resource." ); QString cAccess = i18n( "Your access permissions may be inadequate to " "perform the requested operation on this resource." ); QString cLocked = i18n( "The file may be in use (and thus locked) by " "another user or application." ); QString sQuerylock = i18n( "Check to make sure that no other " "application or user is using the file or has locked the file." ); QString cHardware = i18n( "Although unlikely, a hardware error may have " "occurred." ); QString cBug = i18n( "You may have encountered a bug in the program." ); QString cBuglikely = i18n( "This is most likely to be caused by a bug in the " "program. Please consider submitting a full bug report as detailed below." ); QString sUpdate = i18n( "Update your software to the latest version. " "Your distribution should provide tools to update your software." ); QString sBugreport = i18n( "When all else fails, please consider helping the " "KDE team or the third party maintainer of this software by submitting a " "high quality bug report. If the software is provided by a third party, " "please contact them directly. Otherwise, first look to see if " "the same bug has been submitted by someone else by searching at the " "<a href=\"http://bugs.kde.org/\">KDE bug reporting website</a>. If not, take " "note of the details given above, and include them in your bug report, along " "with as many other details as you think might help." ); QString cNetwork = i18n( "There may have been a problem with your network " "connection." ); // FIXME netconf kcontrol link QString cNetconf = i18n( "There may have been a problem with your network " "configuration. If you have been accessing the Internet with no problems " "recently, this is unlikely." ); QString cNetpath = i18n( "There may have been a problem at some point along " "the network path between the server and this computer." ); QString sTryagain = i18n( "Try again, either now or at a later time." ); QString cProtocol = i18n( "A protocol error or incompatibility may have occurred." ); QString sExists = i18n( "Ensure that the resource exists, and try again." ); QString cExists = i18n( "The specified resource may not exist." ); QString cTypo = i18n( "You may have incorrectly typed the location." ); QString sTypo = i18n( "Double-check that you have entered the correct location " "and try again." ); QString sNetwork = i18n( "Check your network connection status." ); switch( errorCode ) { case KIO::ERR_CANNOT_OPEN_FOR_READING: errorName = i18n( "Cannot Open Resource For Reading" ); description = i18n( "This means that the contents of the requested file " "or folder <strong>%1</strong> could not be retrieved, as read " "access could not be obtained." ).arg( dir ); causes << i18n( "You may not have permissions to read the file or open " "the folder.") << cLocked << cHardware; solutions << sAccess << sQuerylock << sSysadmin; break; case KIO::ERR_CANNOT_OPEN_FOR_WRITING: errorName = i18n( "Cannot Open Resource For Writing" ); description = i18n( "This means that the file, <strong>%1</strong>, could " "not be written to as requested, because access with permission to " "write could not be obtained." ).arg( filename ); causes << cAccess << cLocked << cHardware; solutions << sAccess << sQuerylock << sSysadmin; break; case KIO::ERR_CANNOT_LAUNCH_PROCESS: errorName = i18n( "Cannot Initiate the %1 Protocol" ).arg( protocol ); techName = i18n( "Unable to Launch Process" ); description = i18n( "The program on your computer which provides access " "to the <strong>%1</strong> protocol could not be started. This is " "usually due to technical reasons." ).arg( protocol ); causes << i18n( "The program which provides compatibility with this " "protocol may not have been updated with your last update of KDE. " "This can cause the program to be incompatible with the current version " "and thus not start." ) << cBug; solutions << sUpdate << sSysadmin; break; case KIO::ERR_INTERNAL: errorName = i18n( "Internal Error" ); description = i18n( "The program on your computer which provides access " "to the <strong>%1</strong> protocol has reported an internal error." ) .arg( protocol ); causes << cBuglikely; solutions << sUpdate << sBugreport; break; case KIO::ERR_MALFORMED_URL: errorName = i18n( "Improperly Formatted URL" ); description = i18n( "The <strong>U</strong>niform <strong>R</strong>esource " "<strong>L</strong>ocator (URL) that you entered was not properly " "formatted. The format of a URL is generally as follows:" "<blockquote><strong>protocol://user:password@www.example.org:port/folder/" "filename.extension?query=value</strong></blockquote>" ); solutions << sTypo; break; case KIO::ERR_UNSUPPORTED_PROTOCOL: errorName = i18n( "Unsupported Protocol %1" ).arg( protocol ); description = i18n( "The protocol <strong>%1</strong> is not supported " "by the KDE programs currently installed on this computer." ) .arg( protocol ); causes << i18n( "The requested protocol may not be supported." ) << i18n( "The versions of the %1 protocol supported by this computer and " "the server may be incompatible." ).arg( protocol ); solutions << i18n( "You may perform a search on the Internet for a KDE " "program (called a kioslave or ioslave) which supports this protocol. " "Places to search include <a href=\"http://kde-apps.org/\">" "http://kde-apps.org/</a> and <a href=\"http://freshmeat.net/\">" "http://freshmeat.net/</a>." ) << sUpdate << sSysadmin; break; case KIO::ERR_NO_SOURCE_PROTOCOL: errorName = i18n( "URL Does Not Refer to a Resource." ); techName = i18n( "Protocol is a Filter Protocol" ); description = i18n( "The <strong>U</strong>niform <strong>R</strong>esource " "<strong>L</strong>ocator (URL) that you entered did not refer to a " "specific resource." ); causes << i18n( "KDE is able to communicate through a protocol within a " "protocol; the protocol specified is only for use in such situations, " "however this is not one of these situations. This is a rare event, and " "is likely to indicate a programming error." ); solutions << sTypo; break; case KIO::ERR_UNSUPPORTED_ACTION: errorName = i18n( "Unsupported Action: %1" ).arg( errorText ); description = i18n( "The requested action is not supported by the KDE " "program which is implementing the <strong>%1</strong> protocol." ) .arg( protocol ); causes << i18n( "This error is very much dependent on the KDE program. The " "additional information should give you more information than is available " "to the KDE input/output architecture." ); solutions << i18n( "Attempt to find another way to accomplish the same " "outcome." ); break; case KIO::ERR_IS_DIRECTORY: errorName = i18n( "File Expected" ); description = i18n( "The request expected a file, however the " "folder <strong>%1</strong> was found instead." ).arg( dir ); causes << i18n( "This may be an error on the server side." ) << cBug; solutions << sUpdate << sSysadmin; break; case KIO::ERR_IS_FILE: errorName = i18n( "Folder Expected" ); description = i18n( "The request expected a folder, however " "the file <strong>%1</strong> was found instead." ).arg( filename ); causes << cBug; solutions << sUpdate << sSysadmin; break; case KIO::ERR_DOES_NOT_EXIST: errorName = i18n( "File or Folder Does Not Exist" ); description = i18n( "The specified file or folder <strong>%1</strong> " "does not exist." ).arg( dir ); causes << cBug; solutions << sUpdate << sSysadmin; break; case KIO::ERR_FILE_ALREADY_EXIST: errorName = i18n( "File Already Exists" ); description = i18n( "The requested file could not be created because a " "file with the same name already exists." ); solutions << i18n ( "Try moving the current file out of the way first, " "and then try again." ) << i18n ( "Delete the current file and try again." ) << i18n( "Choose an alternate filename for the new file." ); break; case KIO::ERR_DIR_ALREADY_EXIST: errorName = i18n( "Folder Already Exists" ); description = i18n( "The requested folder could not be created because " "a folder with the same name already exists." ); solutions << i18n( "Try moving the current folder out of the way first, " "and then try again." ) << i18n( "Delete the current folder and try again." ) << i18n( "Choose an alternate name for the new folder." ); break; case KIO::ERR_UNKNOWN_HOST: errorName = i18n( "Unknown Host" ); description = i18n( "An unknown host error indicates that the server with " "the requested name, <strong>%1</strong>, could not be " "located on the Internet." ).arg( host ); causes << i18n( "The name that you typed, %1, may not exist: it may be " "incorrectly typed." ).arg( host ) << cNetwork << cNetconf; solutions << sNetwork << sSysadmin; break; case KIO::ERR_ACCESS_DENIED: errorName = i18n( "Access Denied" ); description = i18n( "Access was denied to the specified resource, " "<strong>%1</strong>." ).arg( url ); causes << i18n( "You may have supplied incorrect authentication details or " "none at all." ) << i18n( "Your account may not have permission to access the " "specified resource." ); solutions << i18n( "Retry the request and ensure your authentication details " "are entered correctly." ) << sSysadmin; if ( !isSlaveNetwork ) solutions << sServeradmin; break; case KIO::ERR_WRITE_ACCESS_DENIED: errorName = i18n( "Write Access Denied" ); description = i18n( "This means that an attempt to write to the file " "<strong>%1</strong> was rejected." ).arg( filename ); causes << cAccess << cLocked << cHardware; solutions << sAccess << sQuerylock << sSysadmin; break; case KIO::ERR_CANNOT_ENTER_DIRECTORY: errorName = i18n( "Unable to Enter Folder" ); description = i18n( "This means that an attempt to enter (in other words, " "to open) the requested folder <strong>%1</strong> was rejected." ) .arg( dir ); causes << cAccess << cLocked; solutions << sAccess << sQuerylock << sSysadmin; break; case KIO::ERR_PROTOCOL_IS_NOT_A_FILESYSTEM: errorName = i18n( "Folder Listing Unavailable" ); techName = i18n( "Protocol %1 is not a Filesystem" ).arg( protocol ); description = i18n( "This means that a request was made which requires " "determining the contents of the folder, and the KDE program supporting " "this protocol is unable to do so." ); causes << cBug; solutions << sUpdate << sBugreport; break; case KIO::ERR_CYCLIC_LINK: errorName = i18n( "Cyclic Link Detected" ); description = i18n( "UNIX environments are commonly able to link a file or " "folder to a separate name and/or location. KDE detected a link or " "series of links that results in an infinite loop - i.e. the file was " "(perhaps in a roundabout way) linked to itself." ); solutions << i18n( "Delete one part of the loop in order that it does not " "cause an infinite loop, and try again." ) << sSysadmin; break; case KIO::ERR_USER_CANCELED: // Do nothing in this case. The user doesn't need to be told what he just did. // rodda: However, if we have been called, an application is about to display // this information anyway. If we don't return sensible information, the // user sees a blank dialog (I have seen this myself) errorName = i18n( "Request Aborted By User" ); description = i18n( "The request was not completed because it was " "aborted." ); solutions << i18n( "Retry the request." ); break; case KIO::ERR_CYCLIC_COPY: errorName = i18n( "Cyclic Link Detected During Copy" ); description = i18n( "UNIX environments are commonly able to link a file or " "folder to a separate name and/or location. During the requested copy " "operation, KDE detected a link or series of links that results in an " "infinite loop - i.e. the file was (perhaps in a roundabout way) linked " "to itself." ); solutions << i18n( "Delete one part of the loop in order that it does not " "cause an infinite loop, and try again." ) << sSysadmin; break; case KIO::ERR_COULD_NOT_CREATE_SOCKET: errorName = i18n( "Could Not Create Network Connection" ); techName = i18n( "Could Not Create Socket" ); description = i18n( "This is a fairly technical error in which a required " "device for network communications (a socket) could not be created." ); causes << i18n( "The network connection may be incorrectly configured, or " "the network interface may not be enabled." ); solutions << sNetwork << sSysadmin; break; case KIO::ERR_COULD_NOT_CONNECT: errorName = i18n( "Connection to Server Refused" ); description = i18n( "The server <strong>%1</strong> refused to allow this " "computer to make a connection." ).arg( host ); causes << i18n( "The server, while currently connected to the Internet, " "may not be configured to allow requests." ) << i18n( "The server, while currently connected to the Internet, " "may not be running the requested service (%1)." ).arg( protocol ) << i18n( "A network firewall (a device which restricts Internet " "requests), either protecting your network or the network of the server, " "may have intervened, preventing this request." ); solutions << sTryagain << sServeradmin << sSysadmin; break; case KIO::ERR_CONNECTION_BROKEN: errorName = i18n( "Connection to Server Closed Unexpectedly" ); description = i18n( "Although a connection was established to " "<strong>%1</strong>, the connection was closed at an unexpected point " "in the communication." ).arg( host ); causes << cNetwork << cNetpath << i18n( "A protocol error may have occurred, " "causing the server to close the connection as a response to the error." ); solutions << sTryagain << sServeradmin << sSysadmin; break; case KIO::ERR_NOT_FILTER_PROTOCOL: errorName = i18n( "URL Resource Invalid" ); techName = i18n( "Protocol %1 is not a Filter Protocol" ).arg( protocol ); description = i18n( "The <strong>U</strong>niform <strong>R</strong>esource " "<strong>L</strong>ocator (URL) that you entered did not refer to " "a valid mechanism of accessing the specific resource, " "<strong>%1%2</strong>." ) .arg( !host.isNull() ? host + '/' : QString::null ).arg( dir ); causes << i18n( "KDE is able to communicate through a protocol within a " "protocol. This request specified a protocol be used as such, however " "this protocol is not capable of such an action. This is a rare event, " "and is likely to indicate a programming error." ); solutions << sTypo << sSysadmin; break; case KIO::ERR_COULD_NOT_MOUNT: errorName = i18n( "Unable to Initialize Input/Output Device" ); techName = i18n( "Could Not Mount Device" ); description = i18n( "The requested device could not be initialized " "(\"mounted\"). The reported error was: <strong>%1</strong>" ) .arg( errorText ); causes << i18n( "The device may not be ready, for example there may be " "no media in a removable media device (i.e. no CD-ROM in a CD drive), " "or in the case of a peripheral/portable device, the device may not " "be correctly connected." ) << i18n( "You may not have permissions to initialize (\"mount\") the " "device. On UNIX systems, often system administrator privileges are " "required to initialize a device." ) << cHardware; solutions << i18n( "Check that the device is ready; removable drives " "must contain media, and portable devices must be connected and powered " "on.; and try again." ) << sAccess << sSysadmin; break; case KIO::ERR_COULD_NOT_UNMOUNT: errorName = i18n( "Unable to Uninitialize Input/Output Device" ); techName = i18n( "Could Not Unmount Device" ); description = i18n( "The requested device could not be uninitialized " "(\"unmounted\"). The reported error was: <strong>%1</strong>" ) .arg( errorText ); causes << i18n( "The device may be busy, that is, still in use by " "another application or user. Even such things as having an open " "browser window on a location on this device may cause the device to " "remain in use." ) << i18n( "You may not have permissions to uninitialize (\"unmount\") " "the device. On UNIX systems, system administrator privileges are " "often required to uninitialize a device." ) << cHardware; solutions << i18n( "Check that no applications are accessing the device, " "and try again." ) << sAccess << sSysadmin; break; case KIO::ERR_COULD_NOT_READ: errorName = i18n( "Cannot Read From Resource" ); description = i18n( "This means that although the resource, " "<strong>%1</strong>, was able to be opened, an error occurred while " "reading the contents of the resource." ).arg( url ); causes << i18n( "You may not have permissions to read from the resource." ); if ( !isSlaveNetwork ) causes << cNetwork; causes << cHardware; solutions << sAccess; if ( !isSlaveNetwork ) solutions << sNetwork; solutions << sSysadmin; break; case KIO::ERR_COULD_NOT_WRITE: errorName = i18n( "Cannot Write to Resource" ); description = i18n( "This means that although the resource, <strong>%1</strong>" ", was able to be opened, an error occurred while writing to the resource." ) .arg( url ); causes << i18n( "You may not have permissions to write to the resource." ); if ( !isSlaveNetwork ) causes << cNetwork; causes << cHardware; solutions << sAccess; if ( !isSlaveNetwork ) solutions << sNetwork; solutions << sSysadmin; break; case KIO::ERR_COULD_NOT_BIND: errorName = i18n( "Could Not Listen for Network Connections" ); techName = i18n( "Could Not Bind" ); description = i18n( "This is a fairly technical error in which a required " "device for network communications (a socket) could not be established " "to listen for incoming network connections." ); causes << i18n( "The network connection may be incorrectly configured, or " "the network interface may not be enabled." ); solutions << sNetwork << sSysadmin; break; case KIO::ERR_COULD_NOT_LISTEN: errorName = i18n( "Could Not Listen for Network Connections" ); techName = i18n( "Could Not Listen" ); description = i18n( "This is a fairly technical error in which a required " "device for network communications (a socket) could not be established " "to listen for incoming network connections." ); causes << i18n( "The network connection may be incorrectly configured, or " "the network interface may not be enabled." ); solutions << sNetwork << sSysadmin; break; case KIO::ERR_COULD_NOT_ACCEPT: errorName = i18n( "Could Not Accept Network Connection" ); description = i18n( "This is a fairly technical error in which an error " "occurred while attempting to accept an incoming network connection." ); causes << i18n( "The network connection may be incorrectly configured, or " "the network interface may not be enabled." ) << i18n( "You may not have permissions to accept the connection." ); solutions << sNetwork << sSysadmin; break; case KIO::ERR_COULD_NOT_LOGIN: errorName = i18n( "Could Not Login: %1" ).arg( errorText ); description = i18n( "An attempt to login to perform the requested " "operation was unsuccessful." ); causes << i18n( "You may have supplied incorrect authentication details or " "none at all." ) << i18n( "Your account may not have permission to access the " "specified resource." ) << cProtocol; solutions << i18n( "Retry the request and ensure your authentication details " "are entered correctly." ) << sServeradmin << sSysadmin; break; case KIO::ERR_COULD_NOT_STAT: errorName = i18n( "Could Not Determine Resource Status" ); techName = i18n( "Could Not Stat Resource" ); description = i18n( "An attempt to determine information about the status " "of the resource <strong>%1</strong>, such as the resource name, type, " "size, etc., was unsuccessful." ).arg( url ); causes << i18n( "The specified resource may not have existed or may " "not be accessible." ) << cProtocol << cHardware; solutions << i18n( "Retry the request and ensure your authentication details " "are entered correctly." ) << sSysadmin; break; case KIO::ERR_COULD_NOT_CLOSEDIR: //result = i18n( "Could not terminate listing %1" ).arg( errorText ); errorName = i18n( "Could Not Cancel Listing" ); techName = i18n( "FIXME: Document this" ); break; case KIO::ERR_COULD_NOT_MKDIR: errorName = i18n( "Could Not Create Folder" ); description = i18n( "An attempt to create the requested folder failed." ); causes << cAccess << i18n( "The location where the folder was to be created " "may not exist." ); if ( !isSlaveNetwork ) causes << cProtocol; solutions << i18n( "Retry the request." ) << sAccess; break; case KIO::ERR_COULD_NOT_RMDIR: errorName = i18n( "Could Not Remove Folder" ); description = i18n( "An attempt to remove the specified folder, " "<strong>%1</strong>, failed." ).arg( dir ); causes << i18n( "The specified folder may not exist." ) << i18n( "The specified folder may not be empty." ) << cAccess; if ( !isSlaveNetwork ) causes << cProtocol; solutions << i18n( "Ensure that the folder exists and is empty, and try " "again." ) << sAccess; break; case KIO::ERR_CANNOT_RESUME: errorName = i18n( "Could Not Resume File Transfer" );