errmsgcat.tex

刚才是说明 现在是安装程序在 LINUX环境下进行编程的MPICH安装文件

\startmanpage
\mantitle{errmsgcat}{tex}{10/7/2002}
\manname{errmsgcat}
--- Generate the message catalog from the source files 
\subhead{Usage}
errmsgcat [ -append ] [ -msgcat filename ] [ -ignore filename ]
[ -basefile filename ] [ -deffile filename ] [ -validate ]
[ -msglenfile filename ] path
\par
\subhead{Command line options}
\startarg{-append }{Add entries to the message catalog.  Without this option,
a new file is created
}
\startarg{-msgcat filename }{Specify the name of the message catalog.  If no name is
specified, {\tt msg.cat} is used.
}
\startarg{-deffile filename }{Specify the name of a file to contain the messages as 
a C array.  This file may be included in an application to ensure that
error messages can be generated even if the error message catalog cannot be
found or read.  By default, the name {\tt msgcat.h} is used.  If no file is
desired, use {\tt /dev/null}.
}
\startarg{-ignore filename }{Specify a file containing a list of files or directories
to skip.  The names must not contain a {\tt /} .
}
\startarg{-basefile filename }{Specifiy a file containing predefined messages.  See 
notes.
}
\startarg{-validate }{If this is specified, the message catalog is validated by 
ensuring that all references to a predefined message are matched by 
a message definition and that the instance-specific messages are supplied 
with the correct number of arguments in the {\tt MPID{\tt \char`\_}Err{\tt \char`\_}create{\tt \char`\_}code} call.
}
\startarg{-msglenfile filename }{Filename to create containing the maximum length 
of any error message.  This file contains a line of the form
}
\begin{verbatim}
  #define MAX_ERROR_MSG 231
\end{verbatim}

If no filename is provided, {\tt msgcatlen.h} is used.  If no file is desired,
specify {\tt /dev/null
}
\startarg{path }{File or directory to search for messages.  If {\tt path} is a directory,
all files in the directory and any subdirectories are searched, except for
any files specified using the {\tt -ignore} option.
}
\subhead{Notes}
This is the program that reads source files and creates a message catalog
from the source file.  It searches for {\tt MPID{\tt \char`\_}Err{\tt \char`\_}create{\tt \char`\_}code} and extracts
the class value and messages and creates a message catalog file {\tt msg.cat},
along with files used to allow an application to generate error messages
even if the message catalog file cannot be found.
\par
The basefile allows the use of standardized messages.  This should contain
lines of the form
\begin{verbatim}
  **shortname
  long version of message \
  using backslashes at the end of\
  the line to continue
\end{verbatim}

The form {\tt **shortname} is used in {\tt MPID{\tt \char`\_}Err{\tt \char`\_}create{\tt \char`\_}code} calls.
\par
The {\tt msgcatlen.h} file is provided to allow a tool to define an appropriate
maximum message length or to check that a specified maximum message length
is in fact sufficient.  The value in this file can be used to
specify {\tt MPI{\tt \char`\_}MAX{\tt \char`\_}ERROR{\tt \char`\_}STRING}.
\par
The computation of the maximum message length requires that any formatting
command contain a maximum field length.  If no lengths are provided, the
following defaults will be used:
\begin{verbatim}
  %d   10
  %s   32
  %ld  16
  %x   8
  %lx  16
\end{verbatim}

These values must also be enforced by the implementation of
{\tt MPID{\tt \char`\_}Err{\tt \char`\_}get{\tt \char`\_}string}.  For example, the standard {\tt \%.32s} can be used to
control the length of {\tt \%s} formatting.  For the other controls, we may
need to introduce a non-standard syntax.
\par
\subhead{Module}
Error
\endmanpage