/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2015 Mark Roszko * Copyright (C) 2015-2021 KiCad Developers, see AUTHORS.txt for contributors. * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 3 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ // kicad_curl_easy.h **must be** included before any wxWidgets header to avoid conflicts // at least on Windows/msys2 #include #include #include #include #include #include #include #include #include #include #include // THROW_IO_ERROR #include #include #include struct CURL_PROGRESS { KICAD_CURL_EASY* m_Curl; TRANSFER_CALLBACK m_Callback; curl_off_t m_Last_run_time; curl_off_t m_Interval; CURL_PROGRESS( KICAD_CURL_EASY* aCURL, TRANSFER_CALLBACK aCallback, curl_off_t aInterval ) : m_Curl( aCURL ), m_Callback( aCallback ), m_Last_run_time( 0 ), m_Interval( aInterval ) { } }; static size_t write_callback( void* aContents, size_t aSize, size_t aNmemb, void* aUserp ) { size_t realsize = aSize * aNmemb; std::string* p = static_cast( aUserp ); p->append( static_cast( aContents ), realsize ); return realsize; } static size_t stream_write_callback( void* aContents, size_t aSize, size_t aNmemb, void* aUserp ) { size_t realsize = aSize * aNmemb; std::ostream* p = static_cast( aUserp ); p->write( static_cast( aContents ), realsize ); return realsize; } static int xferinfo( void* aProgress, curl_off_t aDLtotal, curl_off_t aDLnow, curl_off_t aULtotal, curl_off_t aULnow ) { CURL_PROGRESS* progress = static_cast( aProgress ); curl_off_t curtime = 0; curl_easy_getinfo( progress->m_Curl->GetCurl(), CURLINFO_TOTAL_TIME, &curtime ); if( curtime - progress->m_Last_run_time >= progress->m_Interval ) { progress->m_Last_run_time = curtime; return progress->m_Callback( aDLtotal, aDLnow, aULtotal, aULnow ); } return CURLE_OK; } static int progressinfo( void* aProgress, double aDLtotal, double aDLnow, double aULtotal, double aULnow ) { return xferinfo( aProgress, static_cast( aDLtotal ), static_cast( aDLnow ), static_cast( aULtotal ), static_cast( aULnow ) ); } KICAD_CURL_EASY::KICAD_CURL_EASY() : m_headers( nullptr ) { // Call KICAD_CURL::Init() from in here every time, but only the first time // will incur any overhead. This strategy ensures that libcurl is never loaded // unless it is needed. KICAD_CURL::Init(); m_CURL = curl_easy_init(); if( !m_CURL ) THROW_IO_ERROR( "Unable to initialize CURL session" ); curl_easy_setopt( m_CURL, CURLOPT_WRITEFUNCTION, write_callback ); curl_easy_setopt( m_CURL, CURLOPT_WRITEDATA, static_cast( &m_buffer ) ); // Only allow HTTP and HTTPS protocols curl_easy_setopt( m_CURL, CURLOPT_PROTOCOLS, CURLPROTO_HTTP | CURLPROTO_HTTPS ); #ifdef _WIN32 // We need this to use the Windows Certificate store curl_easy_setopt( m_CURL, CURLOPT_SSL_OPTIONS, CURLSSLOPT_NATIVE_CA ); #endif wxPlatformInfo platformInfo; wxString application( Pgm().App().GetAppName() ); wxString version( GetBuildVersion() ); wxString platform = "(" + wxGetOsDescription() + ";" + GetPlatformGetBitnessName(); #if defined( KICAD_BUILD_ARCH_X64 ) platform << ";64-bit"; #elif defined( KICAD_BUILD_ARCH_X86 ) platform << ";32-bit"; #elif defined( KICAD_BUILD_ARCH_ARM ) platform << ";ARM 32-bit"; #elif defined( KICAD_BUILD_ARCH_ARM64 ) platform << ";ARM 64-bit"; #endif platform << ")"; wxString user_agent = "KiCad/" + version + " " + platform + " " + application; user_agent << "/" << GetBuildDate(); setOption( CURLOPT_USERAGENT, user_agent.ToStdString().c_str() ); setOption( CURLOPT_ACCEPT_ENCODING, "gzip,deflate" ); } KICAD_CURL_EASY::~KICAD_CURL_EASY() { if( m_headers ) curl_slist_free_all( m_headers ); curl_easy_cleanup( m_CURL ); } int KICAD_CURL_EASY::Perform() { if( m_headers ) curl_easy_setopt( m_CURL, CURLOPT_HTTPHEADER, m_headers ); // bonus: retain worst case memory allocation, should re-use occur m_buffer.clear(); return curl_easy_perform( m_CURL ); } void KICAD_CURL_EASY::SetHeader( const std::string& aName, const std::string& aValue ) { std::string header = aName + ':' + aValue; m_headers = curl_slist_append( m_headers, header.c_str() ); } template int KICAD_CURL_EASY::setOption( int aOption, T aArg ) { return curl_easy_setopt( m_CURL, static_cast( aOption ), aArg ); } const std::string KICAD_CURL_EASY::GetErrorText( int aCode ) { return curl_easy_strerror( static_cast( aCode ) ); } bool KICAD_CURL_EASY::SetUserAgent( const std::string& aAgent ) { if( setOption( CURLOPT_USERAGENT, aAgent.c_str() ) == CURLE_OK ) return true; return false; } bool KICAD_CURL_EASY::SetURL( const std::string& aURL ) { if( setOption( CURLOPT_URL, aURL.c_str() ) == CURLE_OK ) { KIPLATFORM::ENV::PROXY_CONFIG cfg; // Unforunately on Windows land, proxies can be configured depending on destination url // So we also check and set any proxy config here if( KIPLATFORM::ENV::GetSystemProxyConfig( aURL, cfg ) ) { curl_easy_setopt( m_CURL, CURLOPT_PROXY, static_cast( cfg.host.c_str() ) ); if( !cfg.username.empty() ) { curl_easy_setopt( m_CURL, CURLOPT_PROXYUSERNAME, static_cast( cfg.username.c_str() ) ); } if( !cfg.password.empty() ) { curl_easy_setopt( m_CURL, CURLOPT_PROXYPASSWORD, static_cast( cfg.password.c_str() ) ); } } return true; } return false; } bool KICAD_CURL_EASY::SetFollowRedirects( bool aFollow ) { if( setOption( CURLOPT_FOLLOWLOCATION, ( aFollow ? 1 : 0 ) ) == CURLE_OK ) return true; return false; } std::string KICAD_CURL_EASY::Escape( const std::string& aUrl ) { char* escaped = curl_easy_escape( m_CURL, aUrl.c_str(), aUrl.length() ); std::string ret( escaped ); curl_free( escaped ); return ret; } bool KICAD_CURL_EASY::SetTransferCallback( const TRANSFER_CALLBACK& aCallback, size_t aInterval ) { progress = std::make_unique( this, aCallback, static_cast( aInterval ) ); #ifdef CURLOPT_XFERINFOFUNCTION setOption( CURLOPT_XFERINFOFUNCTION, xferinfo ); setOption( CURLOPT_XFERINFODATA, progress.get() ); #else setOption( CURLOPT_PROGRESSFUNCTION, progressinfo ); setOption( CURLOPT_PROGRESSDATA, progress.get() ); #endif setOption( CURLOPT_NOPROGRESS, 0L ); return true; } bool KICAD_CURL_EASY::SetOutputStream( const std::ostream* aOutput ) { curl_easy_setopt( m_CURL, CURLOPT_WRITEFUNCTION, stream_write_callback ); curl_easy_setopt( m_CURL, CURLOPT_WRITEDATA, reinterpret_cast( aOutput ) ); return true; } int KICAD_CURL_EASY::GetTransferTotal( uint64_t& aDownloadedBytes ) const { #ifdef CURLINFO_SIZE_DOWNLOAD_T curl_off_t dl; int result = curl_easy_getinfo( m_CURL, CURLINFO_SIZE_DOWNLOAD_T, &dl ); aDownloadedBytes = static_cast( dl ); #else double dl; int result = curl_easy_getinfo( m_CURL, CURLINFO_SIZE_DOWNLOAD, &dl ); aDownloadedBytes = static_cast( dl ); #endif return result; }