halrun(1)

halrun1

Manipulate the linuxcnc hal from the command line

Usage

halrun -h

halrun [-I] [halcmd_opts] [filename [{.hal | .tcl}]]

halrun -T [halcmd_opts] [filename [{.hal | .tcl}]]

halrun -U

Overview

halrun is a convenience script used to manipulate the HAL (Hardware Abstraction Layer) from the command line. When invoked, halrun:

Sets up the realtime environment.
Executes a command interpreter (halcmd or haltcl).
(Optionally) runs an interactive session.
Tears down the realtime environment.

If no filename is specified, an interactive session is started.
The session will use halcmd(1) unless -T is specified in
which case haltcl(1) will be used.

If a filename is specified and neither the -I nor the -T option
is included, the filename will be processed by the command
interpreter corresponding to the filename extension (halcmd
or haltcl). After processing, the realtime environment
will be torn down.

If a filename is specified and the -I or -T option is included,
the file is processed by the appropriate command interpreter and
then an interactive session is started for halcmd or
haltcl according to the -I or -T option.

Options

halcmd_opts

When a .hal file is specified, the halcmd_opts are passed to halcmd. See the man page for halcmd(1). When a .tcl file is specified, the only valid options are:
-i <INI file>
-f <filename[.tcl|.hal]> (alternate means of specifying a file)

-I

Run an interactive halcmd session

-T

Run an interactive haltcl session.

-U

Forcibly cause the realtime environment to exit. It releases the HAL mutex, requests that all HAL components unload, and stops the realtime system. -U must be the only commandline argument.

-h

display a brief help screen and exit

Releases

2 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13

Bugs

None known at this time.

Author

Original version by John Kasunich, as part of the LinuxCNC Enhanced Machine Controller project. Now includes major contributions by several members of the project.

Reporting bugs

Report bugs to the LinuxCNC bug tracker ⟨URL: https://github.com/LinuxCNC/linuxcnc/issues ⟩.

From linuxcnc-uspace 1:2.9.4-2+deb13u1 in Debian 13 (Trixie). Parsed by carta from the page's man source.