banner (Unix)

The Unix banner program 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 Mark Horton at the University of California Berkeley, distributed as part of the bsdmainutils package, under the name printerbanner. Runs of 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 1000 seconds:

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

References

1 2 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. p. 24. ISBN 0-596-10029-9.
1 2 3 Diomidis Spinellis (2006). Code Quality. Adobe Press. pp. 70–71. ISBN 0-321-16607-8.
↑ http://www.zen77087.zen.co.uk/nug/alleg/sysv-aix-dynix.shtml
↑ http://www.zen77087.zen.co.uk/nug/doc/IBM-157-28-E.pdf
↑ http://packages.debian.org/stable/sysvbanner

External links

banner(6) – 4.2BSD Games Manual
banner(6) – FreeBSD Games Manual

Unix command-line interface programs and shell builtins

File system	cat chmod chown chgrp cksum cmp cp dd du df file fsck fuser ln ls mkdir mount mv pax pwd rm rmdir split tee touch type umask

Processes	at bg chroot cron fg kill killall nice pgrep pkill ps pstree time top

User environment	clear env exit finger history logname mesg passwd su sudo uptime talk tput uname w wall who whoami write

Text processing	awk banner basename comm csplit cut diff dirname ed ex fmt fold head iconv join less more nl paste printf sed sort spell strings tail tr uniq vi wc xargs yes

Shell builtins	alias cd echo test unset wait

Networking	dig host ifconfig inetd netcat netstat nslookup ping rdate rlogin route ssh traceroute

Searching	find grep locate whatis whereis

Documentation	apropos help man

Miscellaneous	bc dc cal expr lp od sleep true and false

List of Unix utilities

This article is issued from Wikipedia - version of the Wednesday, March 02, 2016. The text is available under the Creative Commons Attribution/Share Alike but additional terms may apply for the media files.