ഒരു പിഎസ്പി ഗെയിം കൺസോൾ എമുലേറ്ററിന്റെ ഉദാഹരണം ഉപയോഗിച്ച് ട്രാവിസ് സിഐയിൽ പിവിഎസ്-സ്റ്റുഡിയോ എങ്ങനെ ക്രമീകരിക്കാം

സോഴ്‌സ് കോഡ് ഹോസ്റ്റിംഗായി GitHub ഉപയോഗിക്കുന്ന സോഫ്റ്റ്‌വെയർ നിർമ്മിക്കുന്നതിനും പരിശോധിക്കുന്നതിനുമുള്ള ഒരു വിതരണം ചെയ്ത വെബ് സേവനമാണ് ട്രാവിസ് CI. മുകളിലുള്ള ഓപ്പറേറ്റിംഗ് സാഹചര്യങ്ങൾക്ക് പുറമേ, വിപുലമായ കോൺഫിഗറേഷൻ ഓപ്ഷനുകളിലേക്ക് നിങ്ങളുടെ സ്വന്തം നന്ദി ചേർക്കാൻ കഴിയും. ഈ ലേഖനത്തിൽ PPSSPP കോഡ് ഉദാഹരണം ഉപയോഗിച്ച് PVS-Studio-മായി പ്രവർത്തിക്കാൻ ഞങ്ങൾ ട്രാവിസ് CI ക്രമീകരിക്കും.

ആമുഖം

ട്രാവിസ് സിഐ സോഫ്റ്റ്‌വെയർ നിർമ്മിക്കുന്നതിനും പരിശോധിക്കുന്നതിനുമുള്ള ഒരു വെബ് സേവനമാണ്. തുടർച്ചയായ സംയോജന സമ്പ്രദായങ്ങളുമായി ഇത് സാധാരണയായി ഉപയോഗിക്കുന്നു.

പി.പി.എസ്.എസ്.പി.പി. - പിഎസ്പി ഗെയിം കൺസോൾ എമുലേറ്റർ. സോണി പിഎസ്പിക്കായി ഉദ്ദേശിച്ചിട്ടുള്ള ഡിസ്ക് ഇമേജുകളിൽ നിന്ന് ഏതെങ്കിലും ഗെയിമുകളുടെ സമാരംഭം അനുകരിക്കാൻ പ്രോഗ്രാമിന് കഴിയും. 1 നവംബർ 2012 ന് പ്രോഗ്രാം പുറത്തിറങ്ങി. GPL v2 പ്രകാരം PPSSPP ലൈസൻസ് ചെയ്തിട്ടുണ്ട്. ആർക്കും മെച്ചപ്പെടുത്താൻ കഴിയും പ്രോജക്റ്റ് സോഴ്സ് കോഡ്.

പിവിഎസ്-സ്റ്റുഡിയോ - പ്രോഗ്രാം കോഡിലെ പിശകുകളും സാധ്യതയുള്ള കേടുപാടുകളും തിരയുന്നതിനുള്ള ഒരു സ്റ്റാറ്റിക് കോഡ് അനലൈസർ. ഈ ലേഖനത്തിൽ, ഒരു മാറ്റത്തിനായി, ഞങ്ങൾ പിവിഎസ്-സ്റ്റുഡിയോ ഡെവലപ്പറുടെ മെഷീനിൽ പ്രാദേശികമായി അല്ല, ക്ലൗഡിൽ സമാരംഭിക്കും, കൂടാതെ PPSSPP-യിലെ പിശകുകൾക്കായി നോക്കുക.

ട്രാവിസ് സിഐ സജ്ജീകരിക്കുന്നു

ഞങ്ങൾക്ക് ആവശ്യമുള്ള പ്രോജക്റ്റ് സ്ഥിതി ചെയ്യുന്ന GitHub-ൽ ഞങ്ങൾക്ക് ഒരു ശേഖരം ആവശ്യമാണ്, കൂടാതെ PVS-സ്റ്റുഡിയോയ്ക്കുള്ള ഒരു കീയും (നിങ്ങൾക്ക് ലഭിക്കും ട്രയൽ കീ അഥവാ ഓപ്പൺ സോഴ്സ് പ്രോജക്റ്റുകൾക്ക് സൗജന്യം).

നമുക്ക് സൈറ്റിലേക്ക് പോകാം ട്രാവിസ് സിഐ. നിങ്ങളുടെ GitHub അക്കൗണ്ട് ഉപയോഗിച്ചുള്ള അംഗീകാരത്തിന് ശേഷം, ഞങ്ങൾ റിപ്പോസിറ്ററികളുടെ ഒരു ലിസ്റ്റ് കാണും:

ടെസ്റ്റിനായി, ഞാൻ PPSSPP ഫോർക്ക് ചെയ്തു.

ഞങ്ങൾ ശേഖരിക്കാൻ ആഗ്രഹിക്കുന്ന ശേഖരം ഞങ്ങൾ സജീവമാക്കുന്നു:

നിലവിൽ, ട്രാവിസ് സിഐക്ക് ഞങ്ങളുടെ പ്രോജക്റ്റ് നിർമ്മിക്കാൻ കഴിയില്ല, കാരണം കെട്ടിടനിർമ്മാണത്തിനുള്ള നിർദ്ദേശങ്ങളൊന്നുമില്ല. അതിനാൽ കോൺഫിഗറേഷനുള്ള സമയമാണിത്.

വിശകലന സമയത്ത്, ചില വേരിയബിളുകൾ ഞങ്ങൾക്ക് ഉപയോഗപ്രദമാകും, ഉദാഹരണത്തിന്, പിവിഎസ്-സ്റ്റുഡിയോയ്ക്കുള്ള കീ, കോൺഫിഗറേഷൻ ഫയലിൽ വ്യക്തമാക്കുന്നത് അഭികാമ്യമല്ല. അതിനാൽ ട്രാവിസ് സിഐയിലെ ബിൽഡ് ക്രമീകരണങ്ങൾ ഉപയോഗിച്ച് എൻവയോൺമെന്റ് വേരിയബിളുകൾ ചേർക്കാം:

ഞങ്ങൾക്ക് വേണ്ടത്:

• PVS_USERNAME - ഉപയോക്തൃനാമം
• PVS_KEY - കീ
• MAIL_USER - റിപ്പോർട്ട് അയയ്ക്കാൻ ഉപയോഗിക്കുന്ന ഇമെയിൽ
• MAIL_PASSWORD - ഇമെയിൽ പാസ്‌വേഡ്

അവസാനത്തെ രണ്ടെണ്ണം ഓപ്ഷണൽ ആണ്. മെയിൽ വഴി ഫലങ്ങൾ അയയ്ക്കാൻ ഇവ ഉപയോഗിക്കും. നിങ്ങൾക്ക് മറ്റൊരു രീതിയിൽ റിപ്പോർട്ട് വിതരണം ചെയ്യണമെങ്കിൽ, അവ സൂചിപ്പിക്കേണ്ടതില്ല.

അതിനാൽ, ഞങ്ങൾക്ക് ആവശ്യമായ പരിസ്ഥിതി വേരിയബിളുകൾ ഞങ്ങൾ ചേർത്തു:

ഇനി നമുക്ക് ഒരു ഫയൽ ഉണ്ടാക്കാം .travis.yml പ്രോജക്റ്റിന്റെ റൂട്ടിൽ സ്ഥാപിക്കുക. പി‌പി‌എസ്‌എസ്‌പി‌പിക്ക് ഇതിനകം ട്രാവിസ് സി‌ഐയ്‌ക്കായി ഒരു കോൺഫിഗറേഷൻ ഫയൽ ഉണ്ടായിരുന്നു, എന്നിരുന്നാലും, ഇത് വളരെ വലുതും ഉദാഹരണത്തിന് പൂർണ്ണമായും അനുയോജ്യമല്ലാത്തതുമാണ്, അതിനാൽ ഞങ്ങൾക്ക് ഇത് വളരെ ലളിതമാക്കുകയും അടിസ്ഥാന ഘടകങ്ങൾ മാത്രം ഉപേക്ഷിക്കുകയും ചെയ്യേണ്ടതുണ്ട്.

ആദ്യം, നമുക്ക് ഭാഷ, വെർച്വൽ മെഷീനിൽ ഉപയോഗിക്കാൻ ആഗ്രഹിക്കുന്ന ഉബുണ്ടു ലിനക്സിന്റെ പതിപ്പ്, ബിൽഡിന് ആവശ്യമായ പാക്കേജുകൾ എന്നിവ സൂചിപ്പിക്കാം:

language: cpp
dist: xenial

addons:
  apt:
    update: true
    packages:
      - ant
      - aria2
      - build-essential
      - cmake
      - libgl1-mesa-dev
      - libglu1-mesa-dev
      - libsdl2-dev
      - pv
      - sendemail
      - software-properties-common
    sources:
      - sourceline: 'ppa:ubuntu-toolchain-r/test'
      - sourceline: 'ppa:ubuntu-sdk-team/ppa'

ലിസ്‌റ്റ് ചെയ്‌തിരിക്കുന്ന എല്ലാ പാക്കേജുകളും PPSSPP-യ്‌ക്ക് മാത്രമായി ആവശ്യമാണ്.

ഇപ്പോൾ ഞങ്ങൾ അസംബ്ലി മാട്രിക്സ് സൂചിപ്പിക്കുന്നു:

matrix:
  include:
    - os: linux
      compiler: "gcc"
      env: PPSSPP_BUILD_TYPE=Linux PVS_ANALYZE=Yes
    - os: linux
      compiler: "clang"
      env: PPSSPP_BUILD_TYPE=Linux

വിഭാഗത്തെക്കുറിച്ച് കുറച്ചുകൂടി മാട്രിക്സ്. ട്രാവിസ് സിഐയിൽ, ബിൽഡ് ഓപ്‌ഷനുകൾ സൃഷ്‌ടിക്കാൻ രണ്ട് വഴികളുണ്ട്: ആദ്യത്തേത് കംപൈലറുകൾ, ഓപ്പറേറ്റിംഗ് സിസ്റ്റം തരങ്ങൾ, എൻവയോൺമെന്റ് വേരിയബിളുകൾ മുതലായവയുടെ ഒരു ലിസ്റ്റ് വ്യക്തമാക്കുന്നതാണ്, അതിനുശേഷം സാധ്യമായ എല്ലാ കോമ്പിനേഷനുകളുടെയും ഒരു മാട്രിക്സ് സൃഷ്ടിക്കപ്പെടുന്നു; രണ്ടാമത്തേത് മാട്രിക്സിന്റെ വ്യക്തമായ സൂചനയാണ്. തീർച്ചയായും, നിങ്ങൾക്ക് ഈ രണ്ട് സമീപനങ്ങളും സംയോജിപ്പിച്ച് ഒരു അദ്വിതീയ കേസ് ചേർക്കാം, അല്ലെങ്കിൽ, വിഭാഗം ഉപയോഗിച്ച് അത് ഒഴിവാക്കുക പെടുത്തിയിട്ടില്ല. നിങ്ങൾക്ക് ഇതിനെക്കുറിച്ച് കൂടുതൽ വായിക്കാം ട്രാവിസ് സിഐ ഡോക്യുമെന്റേഷൻ.

പ്രോജക്റ്റ്-നിർദ്ദിഷ്ട അസംബ്ലി നിർദ്ദേശങ്ങൾ നൽകുക മാത്രമാണ് ശേഷിക്കുന്നത്:

before_install:
  - travis_retry bash .travis.sh travis_before_install

install:
  - travis_retry bash .travis.sh travis_install

script:
  - bash .travis.sh travis_script

after_success:
  - bash .travis.sh travis_after_success

ഒരു വെർച്വൽ മെഷീന്റെ ജീവിതത്തിന്റെ വിവിധ ഘട്ടങ്ങളിൽ നിങ്ങളുടെ സ്വന്തം കമാൻഡുകൾ ചേർക്കാൻ ട്രാവിസ് സിഐ നിങ്ങളെ അനുവദിക്കുന്നു. വിഭാഗം മുമ്പ്_ഇൻസ്റ്റാൾ ചെയ്യുക പാക്കേജുകൾ ഇൻസ്റ്റാൾ ചെയ്യുന്നതിനു മുമ്പ് നടപ്പിലാക്കി. പിന്നെ ഇൻസ്റ്റാൾ ചെയ്യുക, ഇത് ലിസ്റ്റിൽ നിന്നുള്ള പാക്കേജുകളുടെ ഇൻസ്റ്റാളേഷനെ പിന്തുടരുന്നു addons.aptഞങ്ങൾ മുകളിൽ സൂചിപ്പിച്ചത്. അസംബ്ലി തന്നെ നടക്കുന്നു സ്ക്രിപ്റ്റ്. എല്ലാം ശരിയായിരുന്നുവെങ്കിൽ, നമ്മൾ സ്വയം കണ്ടെത്തും ശേഷം_വിജയം (ഞങ്ങൾ സ്റ്റാറ്റിക് വിശകലനം നടത്തുന്നത് ഈ വിഭാഗത്തിലാണ്). ഇവയെല്ലാം പരിഷ്‌ക്കരിക്കാവുന്ന ഘട്ടങ്ങളല്ല, നിങ്ങൾക്ക് കൂടുതൽ ആവശ്യമുണ്ടെങ്കിൽ, നിങ്ങൾ നോക്കണം ട്രാവിസ് സിഐ ഡോക്യുമെന്റേഷൻ.

വായനയുടെ എളുപ്പത്തിനായി, കമാൻഡുകൾ ഒരു പ്രത്യേക സ്ക്രിപ്റ്റിൽ സ്ഥാപിച്ചു .travis.sh, ഇത് പ്രോജക്റ്റ് റൂട്ടിൽ സ്ഥാപിച്ചിരിക്കുന്നു.

അതിനാൽ ഞങ്ങൾക്ക് ഇനിപ്പറയുന്ന ഫയൽ ഉണ്ട് .travis.yml:

language: cpp
dist: xenial

addons:
  apt:
    update: true
    packages:
      - ant
      - aria2
      - build-essential
      - cmake
      - libgl1-mesa-dev
      - libglu1-mesa-dev
      - libsdl2-dev
      - pv
      - sendemail
      - software-properties-common
    sources:
      - sourceline: 'ppa:ubuntu-toolchain-r/test'
      - sourceline: 'ppa:ubuntu-sdk-team/ppa'

matrix:
  include:
    - os: linux
      compiler: "gcc"
      env: PVS_ANALYZE=Yes
    - os: linux
      compiler: "clang"

before_install:
  - travis_retry bash .travis.sh travis_before_install

install:
  - travis_retry bash .travis.sh travis_install

script:
  - bash .travis.sh travis_script

after_success:
  - bash .travis.sh travis_after_success

പാക്കേജുകൾ ഇൻസ്റ്റാൾ ചെയ്യുന്നതിനുമുമ്പ്, ഞങ്ങൾ സബ്മോഡ്യൂളുകൾ അപ്ഡേറ്റ് ചെയ്യും. PPSSPP നിർമ്മിക്കുന്നതിന് ഇത് ആവശ്യമാണ്. ഇതിലേക്ക് ആദ്യ ഫംഗ്ഷൻ ചേർക്കാം .travis.sh (വിപുലീകരണം ശ്രദ്ധിക്കുക):

travis_before_install() {
  git submodule update --init --recursive
}

ട്രാവിസ് സിഐയിൽ പിവിഎസ്-സ്റ്റുഡിയോയുടെ ഓട്ടോമാറ്റിക് ലോഞ്ച് സജ്ജീകരിക്കുന്നതിലേക്ക് ഞങ്ങൾ ഇപ്പോൾ നേരിട്ട് വരുന്നു. ആദ്യം നമ്മൾ സിസ്റ്റത്തിൽ PVS-Studio പാക്കേജ് ഇൻസ്റ്റാൾ ചെയ്യണം:

travis_install() {
  if [ "$CXX" = "g++" ]; then
    sudo apt-get install -qq g++-4.8
  fi
  
  if [ "$PVS_ANALYZE" = "Yes" ]; then
    wget -q -O - https://files.viva64.com/etc/pubkey.txt 
      | sudo apt-key add -
    sudo wget -O /etc/apt/sources.list.d/viva64.list 
      https://files.viva64.com/etc/viva64.list  
    
    sudo apt-get update -qq
    sudo apt-get install -qq pvs-studio 
                             libio-socket-ssl-perl 
                             libnet-ssleay-perl
  fi
    
  download_extract 
    "https://cmake.org/files/v3.6/cmake-3.6.2-Linux-x86_64.tar.gz" 
    cmake-3.6.2-Linux-x86_64.tar.gz
}

ചടങ്ങിന്റെ തുടക്കത്തിൽ ട്രാവിസ്_ഇൻസ്റ്റാൾ പരിസ്ഥിതി വേരിയബിളുകൾ ഉപയോഗിച്ച് നമുക്ക് ആവശ്യമായ കമ്പൈലറുകൾ ഞങ്ങൾ ഇൻസ്റ്റാൾ ചെയ്യുന്നു. അപ്പോൾ വേരിയബിൾ ആണെങ്കിൽ $PVS_ANALYZE മൂല്യം സംഭരിക്കുന്നു അതെ (ഞങ്ങൾ അത് വിഭാഗത്തിൽ സൂചിപ്പിച്ചു അയക്കുക ബിൽഡ് മാട്രിക്സ് കോൺഫിഗറേഷൻ സമയത്ത്), ഞങ്ങൾ പാക്കേജ് ഇൻസ്റ്റാൾ ചെയ്യുന്നു pvs-studio. ഇതുകൂടാതെ, പാക്കേജുകളും സൂചിപ്പിച്ചിരിക്കുന്നു libio-socket-ssl-perl и libnet-ssley-perlഎന്നിരുന്നാലും, മെയിലിംഗ് ഫലങ്ങൾക്ക് അവ ആവശ്യമാണ്, അതിനാൽ നിങ്ങളുടെ റിപ്പോർട്ട് നൽകുന്നതിന് നിങ്ങൾ മറ്റൊരു രീതി തിരഞ്ഞെടുത്തിട്ടുണ്ടെങ്കിൽ അവ ആവശ്യമില്ല.

ഫംഗ്ഷൻ download_extract നിർദ്ദിഷ്ട ആർക്കൈവ് ഡൗൺലോഡ് ചെയ്യുകയും അൺപാക്ക് ചെയ്യുകയും ചെയ്യുന്നു:

download_extract() {
  aria2c -x 16 $1 -o $2
  tar -xf $2
}

പ്രോജക്റ്റ് ഒരുമിച്ച് ചേർക്കേണ്ട സമയമാണിത്. വിഭാഗത്തിലാണ് ഇത് സംഭവിക്കുന്നത് സ്ക്രിപ്റ്റ്:

travis_script() {
  if [ -d cmake-3.6.2-Linux-x86_64 ]; then
    export PATH=$(pwd)/cmake-3.6.2-Linux-x86_64/bin:$PATH
  fi
  
  CMAKE_ARGS="-DHEADLESS=ON ${CMAKE_ARGS}"
  if [ "$PVS_ANALYZE" = "Yes" ]; then
    CMAKE_ARGS="-DCMAKE_EXPORT_COMPILE_COMMANDS=On ${CMAKE_ARGS}"
  fi
  cmake $CMAKE_ARGS CMakeLists.txt
  make
}

വാസ്തവത്തിൽ, ഈ വരികൾ ഒഴികെ ഇത് ലളിതമായ ഒരു യഥാർത്ഥ കോൺഫിഗറേഷനാണ്:

if [ "$PVS_ANALYZE" = "Yes" ]; then
  CMAKE_ARGS="-DCMAKE_EXPORT_COMPILE_COMMANDS=On ${CMAKE_ARGS}"
fi

കോഡിന്റെ ഈ വിഭാഗത്തിൽ ഞങ്ങൾ സജ്ജീകരിച്ചിരിക്കുന്നു cmake കംപൈലേഷൻ കമാൻഡുകൾ കയറ്റുമതി ചെയ്യുന്നതിനുള്ള ഫ്ലാഗ്. ഒരു സ്റ്റാറ്റിക് കോഡ് അനലൈസറിന് ഇത് ആവശ്യമാണ്. ലേഖനത്തിൽ നിങ്ങൾക്ക് ഇതിനെക്കുറിച്ച് കൂടുതൽ വായിക്കാം "Linux-ലും macOS-ലും PVS-Studio എങ്ങനെ പ്രവർത്തിപ്പിക്കാം".

അസംബ്ലി വിജയകരമാണെങ്കിൽ, ഞങ്ങൾ എത്തിച്ചേരും ശേഷം_വിജയം, ഞങ്ങൾ സ്റ്റാറ്റിക് വിശകലനം നടത്തുന്നിടത്ത്:

travis_after_success() {
  if [ "$PVS_ANALYZE" = "Yes" ]; then
    pvs-studio-analyzer credentials $PVS_USERNAME $PVS_KEY -o PVS-Studio.lic
    pvs-studio-analyzer analyze -j2 -l PVS-Studio.lic 
                                    -o PVS-Studio-${CC}.log 
                                    --disableLicenseExpirationCheck
    
    plog-converter -t html PVS-Studio-${CC}.log -o PVS-Studio-${CC}.html
    sendemail -t [email protected] 
              -u "PVS-Studio $CC report, commit:$TRAVIS_COMMIT" 
              -m "PVS-Studio $CC report, commit:$TRAVIS_COMMIT" 
              -s smtp.gmail.com:587 
              -xu $MAIL_USER 
              -xp $MAIL_PASSWORD 
              -o tls=yes 
              -f $MAIL_USER 
              -a PVS-Studio-${CC}.log PVS-Studio-${CC}.html
  fi
}

ഇനിപ്പറയുന്ന വരികൾ നമുക്ക് സൂക്ഷ്മമായി പരിശോധിക്കാം:

pvs-studio-analyzer credentials $PVS_USERNAME $PVS_KEY -o PVS-Studio.lic
pvs-studio-analyzer analyze -j2 -l PVS-Studio.lic 
                                -o PVS-Studio-${CC}.log 
                                --disableLicenseExpirationCheck
plog-converter -t html PVS-Studio-${CC}.log -o PVS-Studio-${CC}.html

ട്രാവിസ് സിഐ എൻവയോൺമെന്റ് വേരിയബിളുകൾ സജ്ജീകരിക്കുമ്പോൾ തുടക്കത്തിൽ തന്നെ ഞങ്ങൾ വ്യക്തമാക്കിയ ഉപയോക്തൃനാമത്തിൽ നിന്നും കീയിൽ നിന്നും ആദ്യ വരി ഒരു ലൈസൻസ് ഫയൽ സൃഷ്ടിക്കുന്നു.

രണ്ടാമത്തെ വരി നേരിട്ട് വിശകലനം ആരംഭിക്കുന്നു. പതാക -ജെ വിശകലനത്തിനായി ത്രെഡുകളുടെ എണ്ണം സജ്ജമാക്കുന്നു, ഫ്ലാഗ് -എൽ ലൈസൻസ്, ഫ്ലാഗ് എന്നിവ സൂചിപ്പിക്കുന്നു -ഒ ലോഗുകൾ ഔട്ട്പുട്ട് ചെയ്യുന്നതിനുള്ള ഫയലും ഫ്ലാഗും നിർവചിക്കുന്നു -ഡിസെബിൾ ലൈസൻസ് എക്‌സ്‌പറേഷൻ ചെക്ക് സ്വതവേയുള്ളതിനാൽ ട്രയൽ പതിപ്പുകൾക്ക് ആവശ്യമാണ് pvs-studio-analyzer ലൈസൻസ് കാലഹരണപ്പെടാൻ പോകുന്നുവെന്ന് ഉപയോക്താവിന് മുന്നറിയിപ്പ് നൽകും. ഇത് സംഭവിക്കുന്നത് തടയാൻ, നിങ്ങൾക്ക് ഈ ഫ്ലാഗ് വ്യക്തമാക്കാം.

ലോഗ് ഫയലിൽ റോ ഔട്ട്പുട്ട് അടങ്ങിയിരിക്കുന്നു, അത് പരിവർത്തനം ചെയ്യാതെ വായിക്കാൻ കഴിയില്ല, അതിനാൽ നിങ്ങൾ ആദ്യം ഫയൽ റീഡബിൾ ആക്കണം. നമുക്ക് ലോഗുകൾ കടന്നുപോകാം പ്ലഗ്-കൺവെർട്ടർ, ഔട്ട്പുട്ട് ഒരു html ഫയലാണ്.

ഈ ഉദാഹരണത്തിൽ, കമാൻഡ് ഉപയോഗിച്ച് മെയിൽ വഴി റിപ്പോർട്ടുകൾ അയയ്ക്കാൻ ഞാൻ തീരുമാനിച്ചു ഇമെയിൽ അയയ്ക്കുക.

തൽഫലമായി, ഞങ്ങൾക്ക് ഇനിപ്പറയുന്ന ഫയൽ ലഭിച്ചു .travis.sh:

#/bin/bash

travis_before_install() {
  git submodule update --init --recursive
}

download_extract() {
  aria2c -x 16 $1 -o $2
  tar -xf $2
}

travis_install() {
  if [ "$CXX" = "g++" ]; then
    sudo apt-get install -qq g++-4.8
  fi
  
  if [ "$PVS_ANALYZE" = "Yes" ]; then
    wget -q -O - https://files.viva64.com/etc/pubkey.txt 
      | sudo apt-key add -
    sudo wget -O /etc/apt/sources.list.d/viva64.list 
      https://files.viva64.com/etc/viva64.list  
    
    sudo apt-get update -qq
    sudo apt-get install -qq pvs-studio 
                             libio-socket-ssl-perl 
                             libnet-ssleay-perl
  fi
    
  download_extract 
    "https://cmake.org/files/v3.6/cmake-3.6.2-Linux-x86_64.tar.gz" 
    cmake-3.6.2-Linux-x86_64.tar.gz
}
travis_script() {
  if [ -d cmake-3.6.2-Linux-x86_64 ]; then
    export PATH=$(pwd)/cmake-3.6.2-Linux-x86_64/bin:$PATH
  fi
  
  CMAKE_ARGS="-DHEADLESS=ON ${CMAKE_ARGS}"
  if [ "$PVS_ANALYZE" = "Yes" ]; then
    CMAKE_ARGS="-DCMAKE_EXPORT_COMPILE_COMMANDS=On ${CMAKE_ARGS}"
  fi
  cmake $CMAKE_ARGS CMakeLists.txt
  make
}
travis_after_success() {
  if [ "$PVS_ANALYZE" = "Yes" ]; then
    pvs-studio-analyzer credentials $PVS_USERNAME $PVS_KEY -o PVS-Studio.lic
    pvs-studio-analyzer analyze -j2 -l PVS-Studio.lic 
                                    -o PVS-Studio-${CC}.log 
                                    --disableLicenseExpirationCheck
    
    plog-converter -t html PVS-Studio-${CC}.log -o PVS-Studio-${CC}.html
    sendemail -t [email protected] 
              -u "PVS-Studio $CC report, commit:$TRAVIS_COMMIT" 
              -m "PVS-Studio $CC report, commit:$TRAVIS_COMMIT" 
              -s smtp.gmail.com:587 
              -xu $MAIL_USER 
              -xp $MAIL_PASSWORD 
              -o tls=yes 
              -f $MAIL_USER 
              -a PVS-Studio-${CC}.log PVS-Studio-${CC}.html
  fi
}
set -e
set -x

$1;

Git റിപ്പോസിറ്ററിയിലേക്ക് മാറ്റങ്ങൾ വരുത്താനുള്ള സമയമാണിത്, അതിനുശേഷം ട്രാവിസ് CI ബിൽഡ് സ്വയമേവ പ്രവർത്തിപ്പിക്കും. ബിൽഡ് റിപ്പോർട്ടുകളിലേക്ക് പോകാൻ "ppsspp" ക്ലിക്ക് ചെയ്യുക:

നിലവിലെ ബിൽഡിന്റെ ഒരു അവലോകനം ഞങ്ങൾ കാണും:

ബിൽഡ് വിജയകരമായി പൂർത്തിയാക്കിയാൽ, സ്റ്റാറ്റിക് വിശകലനത്തിന്റെ ഫലങ്ങളുള്ള ഒരു ഇമെയിൽ ഞങ്ങൾക്ക് ലഭിക്കും. തീർച്ചയായും, ഒരു റിപ്പോർട്ട് ലഭിക്കാനുള്ള ഒരേയൊരു മാർഗ്ഗം മെയിലിംഗ് മാത്രമല്ല. ഏത് നടപ്പാക്കൽ രീതിയും നിങ്ങൾക്ക് തിരഞ്ഞെടുക്കാം. എന്നാൽ ബിൽഡ് പൂർത്തിയാക്കിയ ശേഷം, വെർച്വൽ മെഷീൻ ഫയലുകൾ ആക്സസ് ചെയ്യാൻ കഴിയില്ല എന്നത് ഓർത്തിരിക്കേണ്ടത് പ്രധാനമാണ്.

പിശക് സംഗ്രഹം

ഏറ്റവും ബുദ്ധിമുട്ടുള്ള ഭാഗം ഞങ്ങൾ വിജയകരമായി പൂർത്തിയാക്കി. ഇപ്പോൾ നമ്മുടെ എല്ലാ ശ്രമങ്ങളും വിലമതിക്കുന്നുവെന്ന് ഉറപ്പാക്കാം. മെയിൽ വഴി എനിക്ക് വന്ന സ്റ്റാറ്റിക് അനാലിസിസ് റിപ്പോർട്ടിൽ നിന്നുള്ള രസകരമായ ചില പോയിന്റുകൾ നോക്കാം (ഞാൻ അത് സൂചിപ്പിച്ചത് വെറുതെയല്ല).

അപകടകരമായ ഒപ്റ്റിമൈസേഷൻ

void sha1( unsigned char *input, int ilen, unsigned char output[20] )
{
  sha1_context ctx;

  sha1_starts( &ctx );
  sha1_update( &ctx, input, ilen );
  sha1_finish( &ctx, output );

  memset( &ctx, 0, sizeof( sha1_context ) );
}

PVS-സ്റ്റുഡിയോ മുന്നറിയിപ്പ്: V597 കംപൈലറിന് 'സം' ബഫർ ഫ്ലഷ് ചെയ്യാൻ ഉപയോഗിക്കുന്ന 'മെംസെറ്റ്' ഫംഗ്‌ഷൻ കോൾ ഇല്ലാതാക്കാൻ കഴിയും. സ്വകാര്യ ഡാറ്റ മായ്‌ക്കുന്നതിന് RtlSecureZeroMemory() ഫംഗ്‌ഷൻ ഉപയോഗിക്കണം. sha1.cpp 325

ഈ കോഡിന്റെ ഭാഗം സുരക്ഷിതമായ ഹാഷിംഗ് മൊഡ്യൂളിലാണ് സ്ഥിതി ചെയ്യുന്നത്, എന്നിരുന്നാലും, അതിൽ ഗുരുതരമായ ഒരു സുരക്ഷാ പിഴവ് അടങ്ങിയിരിക്കുന്നു (CWE-14). ഡീബഗ് പതിപ്പ് കംപൈൽ ചെയ്യുമ്പോൾ സൃഷ്ടിക്കുന്ന അസംബ്ലി ലിസ്റ്റിംഗ് നോക്കാം:

; Line 355
  mov r8d, 20
  xor edx, edx
  lea rcx, QWORD PTR sum$[rsp]
  call memset
; Line 356

എല്ലാം ക്രമത്തിലും പ്രവർത്തനത്തിലുമാണ് മെംസെറ്റ് എക്സിക്യൂട്ട് ചെയ്യപ്പെടുന്നു, അതുവഴി പ്രധാനപ്പെട്ട ഡാറ്റ റാമിൽ പുനരാലേഖനം ചെയ്യുന്നു, എന്നിരുന്നാലും, ഇതുവരെ സന്തോഷിക്കരുത്. ഒപ്റ്റിമൈസേഷനോടുകൂടിയ റിലീസ് പതിപ്പിന്റെ അസംബ്ലി ലിസ്റ്റിംഗ് നോക്കാം:

; 354  :
; 355  :  memset( sum, 0, sizeof( sum ) );
; 356  :}

ലിസ്റ്റിംഗിൽ നിന്ന് കാണാൻ കഴിയുന്നതുപോലെ, കംപൈലർ കോൾ അവഗണിച്ചു മെംസെറ്റ്. ഇത് ചടങ്ങിൽ വസ്തുത കാരണം sha1 കോളിന് ശേഷം മെംസെറ്റ് ഘടനയെക്കുറിച്ച് കൂടുതൽ പരാമർശമില്ല ctx. അതിനാൽ, ഭാവിയിൽ ഉപയോഗിക്കാത്ത മെമ്മറി ഓവർറൈറ്റിംഗ് പ്രോസസ്സർ സമയം പാഴാക്കുന്നതിൽ കംപൈലർ ഒന്നും കാണുന്നില്ല. ഫംഗ്ഷൻ ഉപയോഗിച്ച് നിങ്ങൾക്ക് ഇത് പരിഹരിക്കാനാകും RtlSecureZeroMemory അഥവാ സമാനമായത് അവളോട്.

ശരിയാണ്:

void sha1( unsigned char *input, int ilen, unsigned char output[20] )
{
  sha1_context ctx;

  sha1_starts( &ctx );
  sha1_update( &ctx, input, ilen );
  sha1_finish( &ctx, output );

  RtlSecureZeroMemory(&ctx, sizeof( sha1_context ) );
} 

അനാവശ്യമായ താരതമ്യം

static u32 sceAudioOutputPannedBlocking
             (u32 chan, int leftvol, int rightvol, u32 samplePtr) {
  int result = 0;
  // For some reason, this is the only one that checks for negative.
  if (leftvol > 0xFFFF || rightvol > 0xFFFF || leftvol < 0 || rightvol < 0) {
    ....
  } else {
    if (leftvol >= 0) {
      chans[chan].leftVolume = leftvol;
    }
    if (rightvol >= 0) {
      chans[chan].rightVolume = rightvol;
    }
    chans[chan].sampleAddress = samplePtr;
    result = __AudioEnqueue(chans[chan], chan, true);
  }
}

PVS-സ്റ്റുഡിയോ മുന്നറിയിപ്പ്: V547 'leftvol >= 0' എന്ന പ്രയോഗം എല്ലായ്പ്പോഴും ശരിയാണ്. sceAudio.cpp 120

ആദ്യത്തേതിന് മറ്റ് ബ്രാഞ്ചിലേക്ക് ശ്രദ്ധിക്കുക if. എല്ലാ വ്യവസ്ഥകളും ഉണ്ടെങ്കിൽ മാത്രമേ കോഡ് നടപ്പിലാക്കുകയുള്ളൂ leftvol > 0xFFFF || rightvol > 0xFFFF || leftvol < 0 || rightvol < 0 വ്യാജമായി മാറും. അതിനാൽ, ഞങ്ങൾക്ക് ഇനിപ്പറയുന്ന പ്രസ്താവനകൾ ലഭിക്കുന്നു, അത് മറ്റ് ബ്രാഞ്ചിന് ശരിയാകും: leftvol <= 0xFFFF, rightvol <= 0xFFFF, leftvol >= 0 и rightvol >= 0. അവസാനത്തെ രണ്ട് പ്രസ്താവനകൾ ശ്രദ്ധിക്കുക. ഈ കോഡിന്റെ നിർവ്വഹണത്തിന് ആവശ്യമായ വ്യവസ്ഥ എന്താണെന്ന് പരിശോധിക്കുന്നതിൽ അർത്ഥമുണ്ടോ?

അതിനാൽ നമുക്ക് ഈ സോപാധിക പ്രസ്താവനകൾ സുരക്ഷിതമായി നീക്കം ചെയ്യാം:

static u32 sceAudioOutputPannedBlocking
(u32 chan, int leftvol, int rightvol, u32 samplePtr) {
  int result = 0;
  // For some reason, this is the only one that checks for negative.
  if (leftvol > 0xFFFF || rightvol > 0xFFFF || leftvol < 0 || rightvol < 0) {
    ....
  } else {
    chans[chan].leftVolume = leftvol;
    chans[chan].rightVolume = rightvol;

    chans[chan].sampleAddress = samplePtr;
    result = __AudioEnqueue(chans[chan], chan, true);
  }
}

മറ്റൊരു രംഗം. ഈ അനാവശ്യ വ്യവസ്ഥകൾക്ക് പിന്നിൽ ചില തരത്തിലുള്ള പിശകുകൾ മറഞ്ഞിരിക്കുന്നു. ഒരുപക്ഷെ, എന്താണ് വേണ്ടതെന്ന് അവർ പരിശോധിച്ചില്ല.

Ctrl+C Ctrl+V സ്ട്രൈക്ക് ബാക്ക്

static u32 scePsmfSetPsmf(u32 psmfStruct, u32 psmfData) {
  if (!Memory::IsValidAddress(psmfData) ||
      !Memory::IsValidAddress(psmfData)) {
    return hleReportError(ME, SCE_KERNEL_ERROR_ILLEGAL_ADDRESS, "bad address");
  }
  ....
}

V501 '||' യുടെ ഇടത്തോട്ടും വലത്തോട്ടും ഒരേ പോലെയുള്ള ഉപ-എക്‌സ്‌പ്രഷനുകളുണ്ട് '!Memory::IsValidAddress(psmfData)' ഓപ്പറേറ്റർ. scePsmf.cpp 703

ഉള്ളിലെ ചെക്ക് ശ്രദ്ധിക്കുക if. വിലാസം സാധുതയുള്ളതാണോ എന്ന് ഞങ്ങൾ പരിശോധിക്കുന്നത് വിചിത്രമായി തോന്നുന്നില്ലേ? psmfData, ഇരട്ടി? അതിനാൽ ഇത് എനിക്ക് വിചിത്രമായി തോന്നുന്നു... വാസ്തവത്തിൽ, ഇത് തീർച്ചയായും ഒരു അക്ഷരത്തെറ്റാണ്, രണ്ട് ഇൻപുട്ട് പാരാമീറ്ററുകളും പരിശോധിക്കുക എന്നതായിരുന്നു ആശയം.

ശരിയായ ഓപ്ഷൻ:

static u32 scePsmfSetPsmf(u32 psmfStruct, u32 psmfData) {
  if (!Memory::IsValidAddress(psmfStruct) ||
      !Memory::IsValidAddress(psmfData)) {
    return hleReportError(ME, SCE_KERNEL_ERROR_ILLEGAL_ADDRESS, "bad address");
  }
  ....
}

മറന്നുപോയ വേരിയബിൾ

extern void ud_translate_att(
  int size = 0;
  ....
  if (size == 8) {
    ud_asmprintf(u, "b");
  } else if (size == 16) {
    ud_asmprintf(u, "w");
  } else if (size == 64) {
    ud_asmprintf(u, "q");
  }
  ....
}

PVS-സ്റ്റുഡിയോ മുന്നറിയിപ്പ്: V547 'വലിപ്പം == 8' എന്ന പ്രയോഗം എപ്പോഴും തെറ്റാണ്. syn-att.c 195

ഈ പിശക് ഫോൾഡറിലാണ് ext, അതിനാൽ പ്രോജക്റ്റിന് ശരിക്കും പ്രസക്തമല്ല, പക്ഷേ ഞാൻ അത് ശ്രദ്ധിക്കുന്നതിന് മുമ്പ് ബഗ് കണ്ടെത്തി, അതിനാൽ ഞാൻ അത് ഉപേക്ഷിക്കാൻ തീരുമാനിച്ചു. എല്ലാത്തിനുമുപരി, ഈ ലേഖനം പിശകുകൾ അവലോകനം ചെയ്യുന്നതിനെക്കുറിച്ചല്ല, മറിച്ച് ട്രാവിസ് സിഐയുമായുള്ള സംയോജനത്തെക്കുറിച്ചാണ്, കൂടാതെ അനലൈസറിന്റെ കോൺഫിഗറേഷനൊന്നും നടത്തിയിട്ടില്ല.

വേരിയബിൾ വലുപ്പം ഒരു സ്ഥിരാങ്കം ഉപയോഗിച്ച് ആരംഭിക്കുന്നു, എന്നിരുന്നാലും, ഇത് കോഡിൽ ഉപയോഗിക്കില്ല, ഓപ്പറേറ്റർ വരെ if, അത് തീർച്ചയായും നൽകുന്നു തെറ്റായ വ്യവസ്ഥകൾ പരിശോധിക്കുമ്പോൾ, കാരണം, ഞങ്ങൾ ഓർക്കുന്നതുപോലെ, വലുപ്പം പൂജ്യത്തിന് തുല്യം. തുടർന്നുള്ള പരിശോധനകൾക്കും അർത്ഥമില്ല.

പ്രത്യക്ഷത്തിൽ, കോഡ് ശകലത്തിന്റെ രചയിതാവ് വേരിയബിളിനെ തിരുത്തിയെഴുതാൻ മറന്നു വലുപ്പം അതിനു മുൻപ്.

നിർത്തുക

ഇവിടെയാണ് നമ്മൾ തെറ്റുകളിൽ അവസാനിക്കുന്നത്. ഈ ലേഖനത്തിന്റെ ഉദ്ദേശ്യം ട്രാവിസ് സിഐയുമായി ചേർന്ന് പിവിഎസ്-സ്റ്റുഡിയോയുടെ പ്രവർത്തനം പ്രകടിപ്പിക്കുക എന്നതാണ്, അല്ലാതെ പ്രോജക്റ്റ് കഴിയുന്നത്ര സമഗ്രമായി വിശകലനം ചെയ്യുകയല്ല. നിങ്ങൾക്ക് വലുതും മനോഹരവുമായ തെറ്റുകൾ വേണമെങ്കിൽ, നിങ്ങൾക്ക് എല്ലായ്പ്പോഴും അവരെ അഭിനന്ദിക്കാം ഇവിടെ :).

തീരുമാനം

പ്രോജക്റ്റുകൾ നിർമ്മിക്കുന്നതിന് വെബ് സേവനങ്ങൾ ഉപയോഗിക്കുന്നത് ഇൻക്രിമെന്റൽ അനാലിസിസ് പ്രാക്ടീസ് ഉപയോഗിച്ച് കോഡ് ലയിപ്പിച്ച ഉടൻ തന്നെ നിരവധി പ്രശ്നങ്ങൾ കണ്ടെത്താൻ നിങ്ങളെ അനുവദിക്കുന്നു. എന്നിരുന്നാലും, ഒരു ബിൽഡ് മതിയാകണമെന്നില്ല, അതിനാൽ സ്റ്റാറ്റിക് വിശകലനത്തോടൊപ്പം ടെസ്റ്റിംഗ് സജ്ജീകരിക്കുന്നത് കോഡിന്റെ ഗുണനിലവാരം ഗണ്യമായി മെച്ചപ്പെടുത്തും.

ഉപയോഗപ്രദമായ ലിങ്കുകൾ

• Linux, macOS എന്നിവയിൽ PVS-സ്റ്റുഡിയോ സമാരംഭിക്കുന്നു
• ഡോക്കറിൽ PVS-സ്റ്റുഡിയോ സമാരംഭിക്കുന്നു
• ട്രാവിസ് സിഐ ഡോക്യുമെന്റേഷൻ

ഇംഗ്ലീഷ് സംസാരിക്കുന്ന പ്രേക്ഷകരുമായി ഈ ലേഖനം പങ്കിടാൻ നിങ്ങൾ ആഗ്രഹിക്കുന്നുവെങ്കിൽ, വിവർത്തന ലിങ്ക് ഉപയോഗിക്കുക: Maxim Zvyagintsev. പിഎസ്പി ഗെയിം കൺസോൾ എമുലേറ്ററിന്റെ ഉദാഹരണം ഉപയോഗിച്ച് ട്രാവിസ് സിഐയിൽ പിവിഎസ്-സ്റ്റുഡിയോ എങ്ങനെ സജ്ജീകരിക്കാം.

അവലംബം: www.habr.com