Page MenuHomePhabricator

Configure Cmake Build - Error : Could NOT find Plantuml (missing: PLANTUML_VERSION)
Closed, ResolvedPublic


Cmake : 3.10.2
Linux : Ubuntu 18.04



When following software requirements, and setting

export PLANTUML_JAR_PATH="~/plantuml/plantuml.jar"

It reports..

-- Could NOT find Plantuml (missing: PLANTUML_VERSION) 
CMake Warning at cmake/Common/BuildSphinxDoc.cmake:59 (message):
  Some tools are missing for Sphinx document generation.  Document generation
  target is not created.
Call Stack (most recent call first):
  cmake/Common/BuildSphinxDoc.cmake:65 (SphinxFindTools)
  secure_fw/CMakeLists.txt:23 (include)

Although If i set:
export PLANTUML_JAR_PATH="/home/<user>/plantuml/plantuml.jar"
It seems to solve this issue.

Problem could be here.

Event Timeline


It is wrong to set PLANTUML_JAR_PATH as export PLANTUML_JAR_PATH="~/plantuml/plantuml.jar" and instead export PLANTUML_JAR_PATH=~/plantuml/plantuml.jar shall be used (Note: quotation marks removed).


The ~ character has a special meaning only to the shell. If you call any executable with a path relative to ~, then tile file operations will fail as the kernel is not able to convert ~ to your home path (see and

Investigation steps:

  1. I re-created the error on a a Linux Mint 19.1 machine by moving the plantuml.jar file to my home directory and setting the environment variable to point to it, ensuring the environment variable has the ~ character inside. Then I ran cmake against the current tip of the master branch. This lead to the same error as reported by @jainvikas8 .
  2. I modified FindPlantuml.cmake to output the the java command used to get plantuml version. This seems to be /usr/bin/java -jar "~/plantuml.jar" -version and it reports Error: Unable to access jarfile ~/plantuml.jar
  3. Removing the quotation marks solved the issue. This results in the shell resolving ~ to the full path of the home directory. Thus the full path will be passed to java as a parameter.
  4. I checked how cat behaves with and without quotation marks, and found the same behavior.
  5. The I run strace /usr/bin/java -jar "~/plantuml.jar" -version to see what file operations were executed, and found this line in the strace output openat(AT_FDCWD, "~/plantuml.jar", O_RDONLY) = -1 ENOENT (No such file or directory). So the ~ relative path was passed to the kernel which failed to resolve it.
  6. Then I checked the documentation and confirmed the Kernel behavior is matching the documentation. (Note: in the details section I link to the man page of open and not openat, but the two system calls use the same pathname parameter type and look up the path the same way.)
gyuri-szing closed this task as Invalid.Aug 23 2019, 8:36 AM

Based on my investigations this is not a bug and no fix is needed.

Hi @gyuri-szing,

The documentation defines exporting PLANTUML_JAR_PATH including the double quotes. The issue is valid and the documentation needs fixing.


gyuri-szing reopened this task as Open.Aug 23 2019, 9:01 AM

That's a valid point, the documentation needs to be fixed.

I'm happy to create a patch set for it.

@jainvikas8: Thank you for volunteering! Please create a patch to fix the documentation.

gyuri-szing closed this task as Resolved.Sep 13 2019, 4:11 PM

Fix has been merged.