\input manualMacros.tex
\manBegin
\manPageInfo{RCCL Reference Manual}{}{}
\manTitle{getActiveConf}{3}
\manSection{NAME}
{\rightskip=0ptplus1fil
{\tt \manName{getActiveConf}}
-- get current configuration of an RCCL manipulator.

}
\manSection{USAGE}
\cverbatim
getActiveConf (mnp, conf)
  MANIP *mnp;
  char *conf;
@endcverbatim
\manSection{ARGUMENTS}
\manItem{{\tt mnp} --}
Manipulator reference structure.
\manItem{{\tt conf} --}
String to receive a configuration description.
These are optional and may be given as {\tt NULL}.
\manSection{DESCRIPTION}
{\tt getActiveConf()} returns both an integer and string description of the 
current configuration of a manipulator. 
The string description has the same format as that used
by {\tt setConf()}. It is terminated
with a {\tt '\\0'}, and is omitted if {\tt conf} is given as {\tt NULL}.

An empty string and a code of {\tt 0} are returned for virtual manipulators.
\manSection{DIAGNOSTICS}

No errors are currently implemented.

\manSection{BUGS}
The information returned by this routine is redundant with the
information provided by the {\tt conf} field of the {\tt MANIP}
structure.
\manSection{SEE ALSO}
\rightskip=0ptplus1fil
{\tt setConf(3)}, {\tt configToStr(3)}.

\manEnd
\end

