Jenkins : Locked Files Report Plugin

Plugin Information

View Locked Files Report on the plugin site for more information.

The current version of this plugin may not be safe to use. Please review the following warnings before use:

This debug plugin fails a build if there are locked files in the workspace at the begining or end of a build.
This plugin is only thought to be used when figuring out why sometimes a SCM (or any other file) action fails as it can not delete files in the workspace.


Enable it in the project configuration and it will at begining and end of the build check if there are any locked files in the workspace.

If there are any locked files, a short summary will be displayed in the Build page.

Clicking on the Locked files page, will show a more detailed list of what files that was locked and by whatprocess.

Windows note

To be able to use the plugin on Windows, you must install Handle on all nodes that is going to use the plugin. Easiest is to add the handle.exe path to the PATH environmental variable, otherwise you must specify the path in System configuration.

handle.exe pops up an EULA dialogue the first time you run it;  if you are running Hudson as a Windows service as a user other than yourself, then you will have to run the exe with "run as..." the service user to accept the EULA once, otherwise you will find that handle.exe just hangs when run from hudson.


1.6 (3rd feb 2012)

Thanks to hokatichenci for fixing the below issues in a pull request.

  • Handle.exe fixes - The plugin always accepts the EULA right now . (JENKINS-8467)
  • Handle.exe fixes - Added support for the new output format (JENKINS-12344)

1.4 - 1.5 (16th nov 2011)

  • Fixed so the plugin can be used in Matrix builds. (JENKINS-9904)
  • Added a timeout for joining on the tool process, this should fix problems with the handle.exe tool not finishing properly. (JENKINS-4797)
  • Updated plugin so it will copy the output from the tool to the console of the build, so it is possible to see if the tool actually found any locked files.
  • Updated source code so the plugin works with a Java 5.0 JRE.

1.3 (5th Jan 2011)

  • Fixed a parsing problem when the workspace folder was locked. (JENKINS-8323)



  • Added support for Handle on windows.
  • Added support for lsof on *nix.


summary.png (image/png)
action.png (image/png)