banner(1)             MPE/iX Shell and Utilities             banner(1)
  ______________________________________________________________________

  NAME
       banner -- display text in large font

  SYNOPSIS
       banner [-c char] [-f fontfile] [-w n] [text...]

  DESCRIPTION
       banner writes the text arguments to the standard output in large
       letters using a default font.  When no text arguments are
       present, banner reads text from the standard input.

  Options
       banner accepts the following options:

       -c char
            uses the single character char to form output characters
            instead of the default X.

       -f fontfile
            uses the output font from fontfile instead of the default
            font.

       -w n limits the output width to at most n characters.

  FILES
       banner uses the following files:

       /etc/small.fnt
            optional small font file.

       /etc/italic.fnt
            optional italic font file.

  DIAGNOSTICS
       Possible exit status values are:

       0  Successful completion.

       1  An error occurred.

  Messages

       Message:  bad HALO font file format in "fontfile"
       Cause:    You specified an invalid font file.
       Action:   Use one of the files listed in the FILES section.

       Message:  cannot open font file "fontfile": system error
       Cause:    See syserror(3).
       Action:   See syserror(3).

                                                                       1

  banner(1)             MPE/iX Shell and Utilities             banner(1)
  ______________________________________________________________________

       Message:  Missing font file
       Cause:    You specified the -f option but did not provide the
                 name of a font file following it.
       Action:   Provide a font file following the -f option.

       Message:  Missing fill character
       Cause:    You specified the -c option but did not provide a char-
                 acter following it.
       Action:   Provide a character following the -c option.

       Message:  Missing width after -w
       Cause:    You specified the -w option but did not provide a width
                 following it.
       Action:   Provide a width following the -w option.

       Message:  Unknown option "-option"
       Cause:    You specified an option that is not valid for banner.
       Action:   Check the DESCRIPTION section for a list of valid
                 banner options.

  PORTABILITY
       x/OPEN Portability Guide 4.0.  All UNIX systems.

       The -c, -f, and -w options are extensions to traditional imple-
       mentations of banner.

  MPE/iX NOTES
       For information on how the current MPE/iX implementation may
       affect the operation of this utility, see Appendix A, MPE/iX
       Implementation Considerations.

                                                                       2