Lightbulb Manual Page

lightbulb(1)                                             lightbulb(1)

NAME
     lightbulb - Convert electrons to photons

SYNOPSIS
     lightbulb [-wattage number]

DESCRIPTION
     lightbulb reads a stream of electrons from standard input and
     produces photons on standard output.
     Thus

         lightbulb <110_volts_ac >light

     The following options apply to lightbulb:

     -wattage  Sets the rate at which electrons are converted
               to photons.

FILES
     None

SEE ALSO
     xmas_tree_lights(1), streetlamp(1), led(2)

KNOWN BUGS
     lightbulb is known to fail unexpectedly after some unknown
     number of applications. Repeated complaints to the authors
     of lightbulb have failed to come up with a fix for this
     bug. The only known workaround for a crashed lightbulb is
     re-installation from a fresh copy of the source media.

NOTES
     I believe M$ Windows is based on lighbulb because they
     share the same bug - and the same workaround.

     It is important to ensure that the input stream is correctly
     formatted or the lightbulb may crash unexpectedly and with
     undefined results.

     Do not attempt to apply lightbulb's input files to other
     UNIX tools (esp. 'finger(1)'), however, lightbulb's output
     stream is fairly compatible with most other devices.

INSTALLATION
     Consult a hardware engineer.

PREREQUISITES
     Your operating system must support sockets and switches.