Banner (Unix)

banner
Operating system	Unix and Unix-like
Type	Command

The banner program on Unix and Unix-like operating systems outputs a large ASCII art version of the text that is supplied to it as its program arguments. One use of the command is to create highly visible separator pages for print jobs.^[1]

Operation

Each argument is truncated at 10 characters and printed on a "line" of its own. To print multiple words on a single line, they must therefore be passed as a single argument, which is done from the shell by escaping or quoting the words as appropriate.^[1]

A related and more flexible program is FIGlet, which can display text in different fonts and orientations.^[2]

Implementation

The way that the program is implemented internally is antiquated. The character fonts used are hardwired into the program code itself, as statically initialized data structures. Two data structures are used. The first is a data table comprising a sequence of printing instructions that encode the bitmap for each character (in an encoding specific to the banner program). The second is an index into that table that indicates, for each character code, where the printing instructions for that character begin and end.^[3]

Both data structures were hand-written. Spinellis observes that it is "difficult to come up with a more error-prone and unmaintainable data format". He observes a stark contrast between the source code of the banner program and automatically generated source code for encoding computer fonts into program data (using the 6-by-10 font data in the source code of the mac68k port of NetBSD for comparison). The automatically generated data are commented, documenting with ASCII art how the bit patterns were derived. The automatically generated data were generated from a bitmap file, itself generated using a bitmap creation/editing program with a graphical user interface. And the automatically generated data are organized in a straightforward and obvious manner — a fixed-length sequence of unencoded bytes for each glyph.^[3]

Spinellis further observes that in modern computer systems it is seldom sensible to embed such data into the program executable image itself, the performance gains of doing so being negligible. Doing so makes it difficult to adapt the program to different locales, or to maintain the program. The more preferred approach in modern systems is to store such data in a separate data file, distinct from the program executable image file, or in a resource fork of the program, that the program reads at run-time.^[3]

Versions

A partial list of versions:

By AT&T, in UNIX System V.^[4]^[5]^[6]
By Cedar Solutions. Runs on modern Linux systems as of 2008. Prints horizontally only with a fixed size.
By Mary Ann Horton at the University of California Berkeley, distributed as part of the bsdmainutils package, under the name printerbanner. Runs on modern Linux, GNU Hurd, and Mac OS X systems as of 2008. Prints vertically with variable size font.

Example output

From the terminal-oriented banner program:

 $ banner 'Hello!'
 #     #                                   ###
 #     #  ######  #       #        ####    ###
 #     #  #       #       #       #    #   ###
 #######  #####   #       #       #    #    #
 #     #  #       #       #       #    #
 #     #  #       #       #       #    #   ###
 #     #  ######  ######  ######   ####    ###

One letter from the printer-oriented banner program as usually found in BSD and derivatives:

 $ banner -w80 "a"
                          #####
                        #########
                     ###############        ###
                    ################      ######
                   ##################     ########
                   #####         #####    #########
                   ####           ####      ##  ###
                   ###            ####           ##
                   ###            ###            ##
                   ###            ###           ###
                    ####         ###           ####
                      #############################
                    ##############################
                   ##############################
                   ############################
                   ###########################
                   ###
                   #
                   #

Display a continuous clock for approximately 1000 seconds:^[a]^[b]

 $ repeat 1000 sh -c '( clear ; date +" %H.%M.%S" | xargs banner ; sleep 1)'

   #     #####             #     #####          ####### #######
  ##    #     #           ##    #     #         #       #
 # #    #                # #          #         #       #
   #    ######             #     #####          ######  ######
   #    #     #   ###      #    #         ###         #       #
   #    #     #   ###      #    #         ###   #     # #     #
 #####   #####    ###    #####  #######   ###    #####   #####

Notes

^
If the following code is not run on a Zsh shell then the repeat command needs to be defined,^[7] as in this code:
```
function repeat(){
for ((i=0;i<$1;i++)); do
   eval ${*:2}
}
```
or that definition can be avoided by replacing the repeat command with a while loop, like this:
```
$ i=0 ; while (($i<1000)); do sh -c '( clear ; date +" %H.%M.%S" | xargs banner ; sleep 1 ; ((i=$i+1)))' ; done
```
^ It can also be done using FIGlet utility with the substitution of banner with figlet -f banner

References

^ ^a ^b Steve Moritsugu; Sanjiv Guha; James Edwards; David Pitts (2000). Practical UNIX. Que Publishing. pp. 220–221. ISBN 0-7897-2250-X.
^ Arnold Robbins (2006). UNIX in a Nutshell. O'Reilly. pp. 24. ISBN 0-596-10029-9.
^ ^a ^b ^c Diomidis Spinellis (2006). Code Quality. Adobe Press. pp. 70–71. ISBN 0-321-16607-8.
^ Hatch (19 April 2004). "System V in AIX and Dynix/ptx". Archived from the original on 2009-05-26. Retrieved 2008-07-23.
^ "AIX: Document 157-28-E" (PDF). zen77087.zen.co.uk.^{[permanent dead link]}
^ "Package: sysvbanner (1.0.15 and others)". Debian. Archived from the original on 2016-12-20. Retrieved 2010-05-06.
^ Frankowski, Jędrzej (May 8, 2020). "Linux Commands – Repeat a Command n Times". Archived from the original on November 19, 2021. Retrieved January 22, 2022.