\input manualMacros.tex
\manBegin
\manPageInfo{RCI Reference Manual}{}{}
\manTitle{rciPrintf}{3}
\manSection{NAME}
{\tt \manName{rciPrintf}},
{\tt \manName{rciPrintToTerminal}}
 -- RCI diagnostic print routines.
\manSection{USAGE}
\cverbatim
rciPrintf (format [,arg] ...)
   char *format; 

rciPrintToTerminal (on)
   int on; @endcverbatim
\manSection{ARGUMENTS}
\manItem{{\tt format} --}
{\tt printf()} style format string.
\manItem{{\tt on} --}
Set true to route printing to the program's terminal.
\manSection{DESCRIPTION}
{\tt rciPrintf()} can be used by any part of an RCI program to print
diagnostic  
information. The usage is the same as {\tt printf()}, except that
the total size of the output string produced should not exceed
{\tt MAX_PMSG} (defined in the source file {\filefont supportFxns.c}
and 255 at the time of this writing).

On Sun4 and MicroVAX systems, the output from {\tt rciPrintf()}
goes, by default, to the console of the CPU hosting the control
task, unless {\tt rciPrintf()} is called from the planning
level, in which case output goes to the program's standard output.
{\tt rciPrintToTerminal()} can be used to route the default output
of {\tt rciPrintf()} to the program's terminal, but only 
for control tasks running on the arbiter CPU.

On SGI and VxWorks systems, the output from {\tt rciPrintf()} goes
to the program's standard output, and {\tt rciPrintToTerminal()}
has no effect.

\manEnd
\end

