git.hungrycats.org Git - xscreensaver/blob - hacks/bsod.man

   1 .de EX          \"Begin example
   2 .ne 5
   3 .if n .sp 1
   4 .if t .sp .5
   5 .nf
   6 .in +.5i
   7 ..
   8 .de EE
   9 .fi
  10 .in -.5i
  11 .if n .sp 1
  12 .if t .sp .5
  13 ..
  14 .TH XScreenSaver 1 "28-Oct-98" "X Version 11"
  15 .SH NAME
  16 bsod - Blue Screen of Death emulator
  17 .SH SYNOPSIS
  18 .B bsod
  19 [\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP]
  20 [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install]
  21 [\-visual \fIvisual\fP] [\-delay \fIseconds\fP]
  22 .SH DESCRIPTION
  23 The
  24 .I bsod
  25 program is the finest in personal computer emulation.
  26 .PP
  27 .I bsod
  28 steps through a set of screens, each one a recreation of a different failure
  29 mode of an operating system.  Systems depicted include Microsoft's Windows 95
  30 and Windows NT, Commodore-Amiga's AmigaDOS 1.3, SPARC Linux, SCO UNIX,
  31 HPUX, IBM OS/360, the Apple Macintosh (both the MacsBug debugger and the
  32 rarer "Sad Mac"), the Atari ST, and the Apple ][+.
  33 .PP
  34 .SH OPTIONS
  35 .I bsod
  36 accepts the following options:
  37 .TP 8
  38 .B \-window
  39 Draw on a newly-created window.  This is the default.
  40 .TP 8
  41 .B \-root
  42 Draw on the root window.
  43 .TP 8
  44 .B \-mono
  45 If on a color display, pretend we're on a monochrome display.
  46 .TP 8
  47 .B \-install
  48 Install a private colormap for the window.
  49 .TP 8
  50 .B \-visual \fIvisual\fP
  51 Specify which visual to use.  Legal values are the name of a visual class,
  52 or the id number (decimal or hex) of a specific visual.
  53 .TP 8
  54 .B \-delay \fIdelay\fP
  55 The delay between displaying one crash and another.
  56 .TP 8
  57 .B \-only \fIwhich\fP
  58 Tell it to run only one mode, e.g., \fI\-only HPUX\fP.
  59 .SH ENVIRONMENT
  60 .PP
  61 .TP 8
  62 .B DISPLAY
  63 to get the default host and display number.
  64 .TP 8
  65 .B XENVIRONMENT
  66 to get the name of a resource file that overrides the global resources
  67 stored in the RESOURCE_MANAGER property.
  68 .SH X RESOURCES
  69 Notable X resources supported include the following, which control which
  70 hacks are displayed and which aren't.
  71 .BR doWindows ,
  72 .BR doNT ,
  73 .BR doWin2K ,
  74 .BR doAmiga ,
  75 .BR doMac ,
  76 .BR doMac1 ,
  77 .BR doMacsBug ,
  78 .BR doMacX ,
  79 .BR doSCO ,
  80 .BR doAtari ,
  81 .BR doBSD ,
  82 .BR doLinux ,
  83 .BR doSparcLinux ,
  84 .BR doBlitDamage ,
  85 .BR doSolaris ,
  86 .BR doHPUX ,
  87 .BR doOS390 ,
  88 and
  89 .BR doApple2 .
  90 Each of these is a Boolean resource, they all default to true, except
  91 for doAtari, doBSD, and doSparcLinux, which are turned off by default,
  92 because they're really not all that interesting looking unless you're a
  93 fan of those systems.
  94
  95 There are command-line options for all of these:
  96 e.g., \fI\-bsd\fP, \fI\-no-bsd\fP.
  97 .SH BUGS
  98 Unlike the systems that the images are borrowed from,
  99 .I bsod
 100 does not require a reboot after running.
 101 .PP
 102 .I bsod
 103 should also emulate more systems, but systems with interesting crash
 104 graphics are not as common as one might hope.
 105 .SH SEE ALSO
 106 .BR X (1),
 107 .BR xscreensaver (1),
 108 .BR http://www.microsoft.com/ ,
 109 .BR http://www.apple.com/ ,
 110 .BR http://www.sco.com/ ,
 111 .BR http://www.kernel.org/ ,
 112 and
 113 .BR http://www.amiga.de/ .
 114 .SH TRADEMARKS
 115 Microsoft Windows, Microsoft Windows 95, and Microsoft Windows NT are all
 116 registered trademarks of Microsoft Corporation.  Apple Macintosh is a
 117 registered trademark of Apple Computer.  Amiga is a registered trademark of
 118 Amiga International, Inc.  Atari ST is probably a trademark, too, but it's
 119 hard to tell who owns it.  Linux is a registered trademark of Linus Torvalds,
 120 but it isn't his fault.
 121 .SH COPYRIGHT
 122 Copyright \(co 1998-2003 by Jamie Zawinski.  Permission to use, copy, modify,
 123 distribute, and sell this software and its documentation for any purpose is
 124 hereby granted without fee, provided that the above copyright notice appear
 125 in all copies and that both that copyright notice and this permission notice
 126 appear in supporting documentation.  No representations are made about the
 127 suitability of this software for any purpose.  It is provided "as is" without
 128 express or implied warranty.  No animals were harmed during the testing of
 129 these simulations.  Always mount a scratch monkey.
 130 .SH AUTHOR
 131 Concept cribbed from Stephen Martin <smartin@mks.com>.  This version is by
 132 Jamie Zawinski <jwz@jwz.org>, with contributions from many others.