.\" Copyright (c) 2006 Alex Joni.\"                (alex_joni AT users DOT sourceforge DOT net).\".\" This is free documentation; you can redistribute it and/or.\" modify it under the terms of the GNU General Public License as.\" published by the Free Software Foundation; either version 2 of.\" the License, or (at your option) any later version..\".\" The GNU General Public License's references to "object code".\" and "executables" are to be interpreted as the output of any.\" document formatting or typesetting system, including.\" intermediate and printed output..\".\" This manual is distributed in the hope that it will be useful,.\" but WITHOUT ANY WARRANTY; without even the implied warranty of.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the.\" GNU General Public License for more details..\".\" You should have received a copy of the GNU General Public.\" License along with this manual; if not, write to the Free.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,.\" USA..\".\".\".TH EMC "1"  "2006-02-20" "EMC Documentation" "The Enhanced Machine Controller".SH NAMEemc \- EMC (The Enhanced Machine Controller).SH SYNOPSIS.B emc[\fI-v\fR] [\fI-d\fR] [\fIINIFILE\fR].SH DESCRIPTION\fBemc\fR is used to start EMC (The Enhanced Machine Controller). Itstarts the realtime system and then initializes a number of EMCcomponents (IO, Motion, GUI, HAL, etc).  The most important parameteris \fIINIFILE\fR, which specifies the configuration name you would liketo run. If \fIINIFILE\fR is not specified, the \fBemc\fR script presentsa graphical wizard to let you choose one..SH OPTIONS.TP\fB\-v\fR Be a little bit verbose. This causes the script to print informationas it works..TP\fB\-d\fRPrint lots of debug information. All executed commandsare echoed to the screen. This mode is useful when something isnot working as it should..TP\fBINIFILE\fRThe ini file is the main piece of an EMC configuration. It is not theentire configuration; there are various other files that go with it(NML files, HAL files, TBL files, VAR files). It is, however, the mostimportant one, because it is the file that holds the configurationtogether. It can adjust a lot of parameters itself, but it also tells\fBemc\fR 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..br\fBemc\fR \fI/usr/local/emc2/configs/sim/sim.ini\fRSpecify a relative path from the current directory, e.g..br\fBemc\fR \fIconfigs/sim/sim.ini\fROtherwise, in the case where the \fBINIFILE\fR is not specified,the behavior will depend on whether you configured emc with\fB--enable-run-in-place\fR.  If so, the emc config chooser will searchonly the configs directory in your source tree.  If not (or if you areusing a packaged version of emc), it may search several directories.The config chooser is currently set to search the path:.nf\fB~/emc2/configs:/usr/local/etc/emc2/configs:/etc/emc2/sample-configs\fR.SH EXAMPLES    \fBemc\fR\fBemc\fR \fIconfigs/sim/sim.ini\fR\fBemc\fR \fI/etc/emc2/sample-configs/stepper/stepper_mm.ini\fR.SH "SEE ALSO"\fBhalcmd(1)\fRMuch more information about EMC2 and HAL is available in the EMC2and HAL User Manuals, found at /usr/share/doc/emc2/..SH HISTORY.SH BUGSNone known at this time. .PP.SH AUTHORThis man page written by Alex Joni, as part of the Enhanced MachineController (EMC) project..SH REPORTING BUGSReport bugs to alex_joni AT users DOT sourceforge DOT net.SH COPYRIGHTCopyright \(co 2006 Alex Joni..brThis is free software; see the source for copying conditions.  There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.