NAME

       linuxcnc - LinuxCNC (The Enhanced Machine Controller)

SYNOPSIS

       linuxcnc [-v] [-d] [INIFILE]

DESCRIPTION

       linuxcnc  is  used  to  start  LinuxCNC  (The  Enhanced Machine Controller). It starts the
       realtime system and then initializes a number of LinuxCNC  components  (IO,  Motion,  GUI,
       HAL,  etc).   The  most  important parameter is INIFILE, which specifies the configuration
       name you would like to run. If INIFILE is not specified, the linuxcnc  script  presents  a
       graphical wizard to let you choose one.

OPTIONS

       -v     Be a little bit verbose. This causes the script to print information as it works.

       -d     Print  lots  of  debug information. All executed commands are echoed to the screen.
              This mode is useful when something is not working as it should.

       -l     Use the last-used INI file without prompting. This is often a  good  choice  for  a
              shortcut command or startup item.

       INIFILE
              The  ini  file is the main piece of an LinuxCNC configuration. It is not the entire
              configuration; there are various other files that go with it (NML files, HAL files,
              TBL  files,  VAR  files). It is, however, the most important one, because it is the
              file that holds the configuration together. It  can  adjust  a  lot  of  parameters
              itself, but it also tells linuxcnc which other files to load and use.

              There are several ways to specify which config to use:

              Specify the absolute path to an ini, e.g.
              linuxcnc /usr/local/linuxcnc/configs/sim/sim.ini

              Specify a relative path from the current directory, e.g.
              linuxcnc configs/sim/sim.ini

              Otherwise, in the case where the INIFILE is not specified, the behavior will depend
              on whether you configured linuxcnc with --enable-run-in-place.  If so, the linuxcnc
              config  chooser will search only the configs directory in your source tree.  If not
              (or if you are using a  packaged  version  of  linuxcnc),  it  may  search  several
              directories.  The config chooser is currently set to search the path:

              ~/linuxcnc/configs:/usr/local/etc/linuxcnc/configs:/usr/share/doc/linuxcnc/examples/sample-configs

EXAMPLES

       linuxcnc

       linuxcnc configs/sim/sim.ini

       linuxcnc /etc/linuxcnc/sample-configs/stepper/stepper_mm.ini

SEE ALSO

       halcmd(1)

       Much  more  information  about  LinuxCNC and HAL is available in the LinuxCNC and HAL User
       Manuals, found at /usr/share/doc/linuxcnc/.

HISTORY

BUGS

       None known at this time.

AUTHOR

       This man page written by Alex Joni, as part of the LinuxCNC  Enhanced  Machine  Controller
       project.

REPORTING BUGS

       Report bugs to alex_joni AT users DOT sourceforge DOT net

COPYRIGHT

       Copyright © 2006 Alex Joni.
       This  is  free software; see the source for copying conditions.  There is NO warranty; not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.