% ----------------------------------------------------------------------------
%
%                                  Hans Wolfgang Loidl, RISC-Linz,  10.3.1992 
%
% Changes:    <By whom>, <When>, <What changes> 
%
% H.W.  Loidl, 7.11.1991, Title in \bf style, contents of
%                         `Functions' in \tt style
%
%  SW-form for registering the software products that are installed
%  on a machine in the ACPC network. 
%  NOTE: This is no independent LaTex file. It has to be included in the 
%        file that describes the corresponding ACPC group
%        or in a `frame' LaTex file (see `sw-frame.tex') where
%        formating information etc is given.
%        All SW-forms should be included into the group description file
%        after the included HW-form.
%
% ----------------------------------------------------------------------------


\subsubsection*{\bf ANSI C Toolset}

\begin{itemize}
 \item {\bf Name:}  ANSI C Toolset of INMOS (Version IMS D711)

 \item {\bf Location:}  /usr0/dos/ictools/tools
                   % important directories might be included here).

 \item {\bf Type:} C compiler, linker and configurer    % What sort of sw-p is this?
                   % Possible entries are: (Parallelizing) Compiler, Debugger,
                   % Editor, Computer Algebra System etc.

 \item {\bf Characterization:}
       Like the occam toolset this toolset contains several programs
       for programming in ANSI C on a transputer. Among others, this toolset
       contains the following programs:
       \begin{itemize}
        \item {\tt icc} --- the ANSI C compiler,
        \item {\tt ilink} --- the  toolset linker,
        \item {\tt icconf} --- the configurer tool,
        \item {\tt icollect} --- the code collector.
       \end{itemize}

 
 % A short description of what the sw-p
                           % does (no longer than 50 words).

 \item {\bf Functions:}   
       For the most important tools listed above, their usage is
       described in more detail here:
    \begin{itemize}
     \item {{\tt icc} --- the ANSI C compiler}.
       An ANSI C Compiler with concurrency support of INMOS that has been developed
       from the 3L Parallel C Compiler, which implemented K \& R C.
       \begin{itemize}
        \item {Invocation:}  {\tt icc} {\it filename} \{ {\it options} \} % How to start the sw-p.
        \item {Termination:}  {\tt <CTRL> C}
        \item {Help:}         % How to get help.
        \item {Example:}     {\tt icc foo.c} % An Example of a typical session with the usage
                                             % of some important features.

                             Compiles the C program in {\tt foo.c} and creates
                              the result in {\tt foo.tco}.
        \item {Other important functions:}  % A list of important functions.
       \end{itemize}
     \item {{\tt ilink} --- the toolset linker}.
       The toolset linker for linking separately compiled program units and
       libraries into a single code unit.
       \begin{itemize}
        \item {Invocation:}  {\tt ilink} \{ {\it filenames} \} \{ {\it options} \} % How to start the sw-p.
        \item {Termination:}  {\tt <CTRL> C}
        \item {Help:}         % How to get help.
        \item {Example:}     {\tt ilink foo1.tco foo2.tco} % An Example of a typical session with the usage
                                             % of some important features.

                             Links the compiled C programs {\tt foo1.tco} and {\tt foo2.tco} 
                              into the file {\tt foo1.lku}.
        \item {Other important functions:}  % A list of important functions.
       \end{itemize}
     \item {{\tt icconf} --- the configurer tool}.
       The configurer tool generates configuration information for transputer
       networks from a configuration description written in the transputer configuration
       language.
       \begin{itemize}
        \item {Invocation:}  {\tt icconf}  {\it filename}  \{ {\it options} \} % How to start the sw-p.
        \item {Termination:}  {\tt <CTRL> C}
        \item {Help:}         % How to get help.
        \item {Example:}     {\tt icconf foo.cfs} % An Example of a typical session with the usage
                                             % of some important features.

                             Produce the configuration data file {\tt foo.cfb}
                              from the configuration description file {\tt foo.cfs}.
                              The {\tt foo.cfb} file can then be taken as the input 
                              file for {\tt icollect}.
        \item {Other important functions:}  % A list of important functions.
       \end{itemize}

     \item {{\tt icollect} --- the code collector}.
       The code collector generates executable files for single and 
       multitransputer programs, from configuration data files and linked
       units respectively.
       \begin{itemize}
        \item {Invocation:}  {\tt icollect}  {\it filename}  \{ {\it options} \} % How to start the sw-p.
        \item {Termination:}  {\tt <CTRL> C}
        \item {Help:}         % How to get help.
        \item {Example:}     {\tt icollect foo.lku /t} % An Example of a typical session with the usage
                                             % of some important features.

                             This creates a bootable file for a single tranpsuter
                              in {\tt foo.btl}.

                             {\tt icollect foo.cfb}

                             (This creates a file {\tt foo.btl} that can be 
                              executed on a multitransputer network).

        \item {Other important functions:}  {\tt } % A list of important functions.
       \end{itemize}
     \end{itemize}


 \item {\bf Installation:}  \verb+SET IBOARDSIZE=#400000+ (this sets the transputer
                            memory size for the bootstrap loader).

                            \verb+SET TRANSPUTER=#150+ (this sets the transputer 
                            base address).

                            \verb+SET ITERM=Z:\USR0\DOS\ITOOLS\ITERMS\IBMPC.ITM+
                            (the terminal description file for a PC).

                            \verb+SET ISEARCH=Z:\USR0\DOS\ITOOLS\LIBS+ (this sets the
                            library path).


 \item {\bf Manuals:}  
                     ``ANSI C Toolset --- User Manual'', by INMOS Limited, 1990.

\end{itemize}


