SYNOPSIS

       fmtmsg [-a action] [-c class] [-l label] [-s severity] [-t tag]
              [-u subclass[,subclass[,...]]] [text]

DESCRIPTION

       The fmtmsg command writes  a  message  either  to  standard  error,  to
       /dev/console,  or to both.  The text argument specifies the actual mes-
       sage.

       The following options are accepted:

       -a action   A hint to the user what to do to fix  the  situation.   The
                   action  string  is  written  in a second line following the
                   actual message and is preceded by `TO FIX:'.

       -c class    A classification for the problem.  May be one of `hard' for
                   Hardware, `soft' for Software, or `firm' for Firmware.

       -l label    The label indicates which component issued the message, for
                   example, the name of the command which invokes fmtmsg.

       -s severity The severity  argument  may  be  one  of  `halt',  `error',
                   `warn',  or  `info'.   It is printed immediately before the
                   actual message.

       -t tag      An additional identifier for the message.  It is written at
                   the end of a second line following the actual message.

       -u subclass[,subclass[,...]]
                   A  comma-separated  list of strings that specifies the mes-
                   sage destination, or gives further details about  the  mes-
                   sage.  Valid values for subclass are:

                   l2fB lw(38).  appl T{ The message originates from an appli-
                   cation.  T} util T{ The message originates from a  utility.
                   T}  opsys     T{  The message originates from the operating
                   system.  T} recov     T{ The problem  is  recoverable.   T}
                   nrecov    T{   The   problem   is   not   recoverable.   T}
                   print     T{ Print the message to standard error.  T}  con-
                   sole   T{ Print the message to /dev/console.  T}

       Unless at least one of `-u print' or `-u console' is given, fmtmsg pro-
       duces no output.



Heirloom Toolchest                  9/25/05                          FMTMSG(1)