MASES.PLC4NetCLI 0.12.0

title: PLC4Net CLI tool of PLC4X suite for .NET _description: Describes the CLI tool to use PLC4X classes from any command-line shell

PLC4Net: CLI

Installation

• dotnet tool hosted on NuGet: check https://www.nuget.org/packages/MASES.PLC4NetCLI/ and https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools for deep installation instructions.
• Docker image hosted on GitHub and Docker Hub: follow instruction within the page and general instruction on https://docs.docker.com
  • The image hosts both .NET 8 and JRE 11 runtimes

[!IMPORTANT] The dotnet tool needs a JRE/JDK installed within the system (see JVM identification)

Usage

To use the CLI interface (PLC4NetCLI) runs a command like the following:

• dotnet tool

plc4net -i

[!IMPORTANT] If the previous command raises the error described in Intel CET and PLC4Net, the only solution is to apply the following workaround (within an elevated shell) and disable CET:

  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\plc4net.exe" /v MitigationOptions /t REG_BINARY /d "0000000000000000000000000000002000" /f

• Docker image

docker run ghcr.io/masesgroup/plc4net -i

docker run masesgroup/plc4net -i

Command switch available

plc4net accepts the following command-line switch:

• ClassToRun: has precedence to all others and needs a second parameter which identify the command class to be executed
• Interactive (i): Activates an interactive shell
• Script (s): Executes the c# script in the file arument
• JarList (jl): A CSV list of JAR to be used or folders containing the JARs
• NamespaceList (nl): A CSV list of namespace to be used for interactive shell, PLC4Net namespace are added automatically
• ImportList (il): A CSV list of import to be used

Plus other switches available at Command line switch page.

JVM identification

One of the most important command-line switch is JVMPath and it is available in JCOBridge switches: it can be used to set-up the location of the JVM library (jvm.dll/libjvm.so) if JCOBridge is not able to identify a suitable JRE installation.