LimitationsThis section contains limitations added in both this release and in previous releases. Limitations for installation, upgrade and deploymentIf re-installing the Klocwork plug-in for TeamCity, make sure the Project Settings do not have the 'klocwork.step.enabled' parameter If you have installed and uninstalled the Klocwork plug-in for TeamCity previously, this parameter may have been defined. When doing a new installation, ensure this parameter has been removed. Workaround: To remove this parameter, access your TeamCity server and go to Administration -> <Project_name> -> Project Settings -> Configuration Parameters. From this page, remove the 'klocwork.step.enabled' parameter. Limitations for Checker configuration migration Note the following limitations with checker configuration files during the upgrade process (via the import process):
java_wrappers.conf is no longer used to edit heap size setting A new file, java_wrappers_memory.conf is created during installation, that populates appropriate heap sizes according to your machine's memory. If you want to modify the heap size, modify this file. The previous recommendation to modify the java_wrappers.conf on Windows is deprecated, as those settings are ignored. Similarly, the previous recommendation for Linux, to modify the last two lines in the shell scripts under <klocwork_install_path>/bin, is unsafe as it may conflict with the java_wrappers_memory.conf settings. Limitation for importing projects with existing reports If you attempt to import a project with existing reports that use default metric names, you may see unexpected results. Workaround: When importing a project, ensure that the reports do not use default metric names. If you encounter this error message, you can either delete and re-create the report or edit the metrics.xml file, ensuring that missing or disabled definitions are enabled. You must have the Microsoft .NET 4.0 Framework installed in order to run Windows services This framework is installed by default as part of Windows 8 and Windows 10. For all other versions of Windows, you must download the Microsoft .NET 4.0 Framework Installer and install the framework manually. kwcollect fails on tables generated by new analysis engine The behavior of kwcollect has changed with the introduction of the Klocwork 2018 analysis engine. Workaround: If your project has been built with Klocwork 2018's new analysis engine, you must include the, '--all-sources' option on the command-line. This requirement does not apply if your project was built without Klocwork 2018's new analysis engine. To determine if your project was built with the new analysis engine, examine the output of the build process in the build.log, contained in the root of the build's output tables folder. Find the line that begins with 'Selected Engines'. Your project has been built using Klocwork 2018's new analysis engine if 'MODERN' appears between square brackets. Limitations for Mac OS support
Limitations for build integrationCannot load Android 4.4 (KitKat) using the default memory settings for kwloaddb, kwadmin and kwjava When building the Android platform, you may need to increase the memory settings for certain Klocwork tools on the machine invoking the load process. These values can be modified in the <klocwork_install>/config/java_wrappers_memory.conf file. Android N Java analysis with Jack toolchain When building Android N using the Jack compiler, some jar files required for Klocwork Java analysis are not generated during the build process. Therefore, kwbuildproject encounters "Unresolved import", "Unresolved method", and "Unresolved name" semantic errors that affect the accuracy of the analysis results. Workaround: Open a ticket with Klocwork customer support. Customer support can provide a script that can generate the jar files required for analysis. Run the script after running the kwinject command and before running the kwbuildproject command. Limitations for C# analysisKlocwork's C# analysis is supported only on Windows. The following features are not supported for C# integration projects:
The following features are not supported for C# desktop analysis:
Using metric thresholds and knowledge bases is not supported for C# server build analysis. Limitations for Klocwork Static Code AnalysisIn Microsoft Edge, some items may not be clickable Due to a Microsoft Edge issue, some items in the portal may not be clickable. For more information, see https://developer.microsoft.com/en-us/microsoft-edge/platform/issues/5782378/ Workaround: Refresh the page. Middle-clicking a link doesn't open it in a new tab when using Google Chrome Due to a bug in Google Chrome, some links do not open in a new tab when they are middle clicked, shift-clicked or ctrl-clicked after the first time the link is opened in this manner. Each successive attempt simply opens the link within the active tab. For more information, see http://code.google.com/p/chromium/issues/detail?id=177502. Workaround: Refresh the page and this will allow you to open the link in a new tab the first time you attempt it. Limitations for Klocwork Desktop AnalysisAnalysis is not supported for 'no-resolve' mode in certain scenarios The "no-resolve" mode was added to support symbolic links to source files on Linux. Symbolic links to directories are not supported. The Eclipse plug-in supports the "no-resolve" mode only if project is configured to use an external build specification, and that build specification was created by using kwinject with "--no-resolve" option. For WindRiver Workbench users, you will receive an error message if you attempt to use a project with exterior sources linked to it. Limitations for the Visual Studio plug-inVisual Studio 2017 help As of Visual Studio 2017, the Help Viewer component is no longer installed by default and must be explicitly selected during installation. If you attempt to install our Klocwork extension for Visual Studio and you do not have this component installed, you will receive an error as our local help is unable to be installed. For more details on this, see Klocwork Help registration could not acquire the location of the Help Viewer. Kwvcprojparser not supported for Visual Studio 2017 The kwvcprojparser command is not supported for Visual Studio 2017 projects built from the command line. Workaround: Use the kwinject command to create the build specification. The filter by severity option in the Microsoft Visual Studio extension may not display custom severities for C++ projects For C++ projects where you have defined custom severities, the severity filter list may not display the correct items. The list may display default severity names, or in the case where you have a mixed C++ and C# project, the list will display the C# severities. You can still use the filter, but the severity names displayed in the issue tree may not match the items you selected in the list (as the filter is applied by severity number). After uninstalling the Klocwork Microsoft Visual Studio extension, the Klocwork help content is not removed Due to a limitation of the Microsoft VSIX installer, Klocwork help is not removed after uninstalling the plug-in. Workaround: You can uninstall the help files manually. Go to Help > Add and Remove Help Content; In the Klocwork Inc. section, click the Remove action next to Klocwork Desktop Plugin. You can install a future version of the plug-in without issue. For the Microsoft Visual Studio extension, minor performance degradation when working with server issues if connection to server is lost A lost server connection causes a delay of up to three seconds when working with server issues, for example, when opening or citing a server issue. Workaround: Work with local issues only by clicking the "Show local issues only" button. F1 help does not work when you attempt to open help for an issue from the Klocwork Issues window in Visual Studio for the Klocwork extension for Visual Studio If you click on an issue in the Klocwork Issues window and attempt to open the help for it by pressing F1, the shortcut opens the incorrect help in the Help Viewer. Workaround: Open the help for the checker by right-clicking on the issue and select View Checker Documentation from the Manage <checker name> Checker menu. Klocwork server option fails to retrieve projects when you use a hard-coded IP addressIf you use a hard-coded IP address in the Klocwork server dialog under the Klocwork options menu, the Klocwork extension for Visual Studio fails to retrieve the list of projects. Workaround: Use the host name instead of the IP address; if this is not an option, you can add an entry in the hosts file for the IP address. Klocwork plug-in for Android Studio installs to unexpected locationIf IntelliJ IDEA 2017 and Android Studio are both installed, and you install the Android Studio plug-in, the IntelliJ IDEA path will be auto-filled instead of the Android Studio path. Klocwork automatically detects your IntelliJ IDEA directory and installs the plug-in to that location. Workaround: If more than one installation directory is detected, you must browse to the preferred location for Android Studio manually. Limitations for Klocwork DesktopAnalysis is not supported with any of the following configurations:
Limitations for Klocwork extensibilityC/C++ Path checker compilation makefile compatibility The makefile generated by kwcreatechecker on Unix systems requires GNU make to build the checker. The default make installed on non-GNU systems such as AIX or Solaris may not compile Klocwork extensions for C/C++. On Windows, the makefile generated by kwcreatechecker requires nmake to build the checker. Workaround: None. |