The Joern shell can be used as a script interpreter, that is, in non-interactive mode.

Basic Usage#

Joern can be used in non-interactive mode. You would execute commands and operations via a script that you specify as an argument instead of manually typing them after the Joern prompt. Joern runs the commands in your script and exits when done.

For example, let's say you have a file named with the following contents:

@main def exec(cpgFile: String, outFile: String) = {
loadCpg(cpgFile) |> outFile

You can include Scala code in and use the |> operator to pipe output into files. The script is then run as follows:

./joern --script --params cpgFile=/,outFile=output.log

Importing Additional Scripts#

If your script depends on code from one or more additional scripts, you can use the --import parameter, which accepts a comma-separated list of input scripts:

./joern --script --params cpgFile=/,outFile=output.log --import scripts/