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 "5-May-2004" "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
  30 Windows 3.1, Windows 95, Windows NT, MS-DOS, AmigaDOS 1.3, Linux,
  31 SCO UNIX, BSD UNIX, HPUX, Solaris, Tru64, VMS, HVX/GCOS6, IBM OS/390, OS/2,
  32 MacOS (MacsBug, Bomb, Sad Mac, and OSX), Atari ST, Apple ][+, and
  33 NCD X Terminals.
  34 .PP
  35 .SH OPTIONS
  36 .I bsod
  37 accepts the following options:
  38 .TP 8
  39 .B \-window
  40 Draw on a newly-created window.  This is the default.
  41 .TP 8
  42 .B \-root
  43 Draw on the root window.
  44 .TP 8
  45 .B \-mono
  46 If on a color display, pretend we're on a monochrome display.
  47 .TP 8
  48 .B \-install
  49 Install a private colormap for the window.
  50 .TP 8
  51 .B \-visual \fIvisual\fP
  52 Specify which visual to use.  Legal values are the name of a visual class,
  53 or the id number (decimal or hex) of a specific visual.
  54 .TP 8
  55 .B \-delay \fIdelay\fP
  56 The delay between displaying one crash and another.
  57 .TP 8
  58 .B \-only \fIwhich\fP
  59 Tell it to run only one mode, e.g., \fI\-only HPUX\fP.
  60 .SH ENVIRONMENT
  61 .PP
  62 .TP 8
  63 .B DISPLAY
  64 to get the default host and display number.
  65 .TP 8
  66 .B XENVIRONMENT
  67 to get the name of a resource file that overrides the global resources
  68 stored in the RESOURCE_MANAGER property.
  69 .SH X RESOURCES
  70 Notable X resources supported include the following, which control which
  71 hacks are displayed and which aren't.
  72 .BR doWindows ,
  73 .BR doNT ,
  74 .BR doWin2K ,
  75 .BR doAmiga ,
  76 .BR doMac ,
  77 .BR doMac1 ,
  78 .BR doMacsBug ,
  79 .BR doMacX ,
  80 .BR doSCO ,
  81 .BR doAtari ,
  82 .BR doBSD ,
  83 .BR doLinux ,
  84 .BR doSparcLinux ,
  85 .BR doHPPALinux ,
  86 .BR doBlitDamage ,
  87 .BR doSolaris ,
  88 .BR doHPUX ,
  89 .BR doApple2 ,
  90 .BR doOS390 ,
  91 .BR doTru64 ,
  92 .BR doVMS ,
  93 .BR doMSDOS ,
  94 .BR doOS2 ,
  95 and
  96 .BR doHVX .
  97 Each of these is a Boolean resource, they all default to true, except
  98 for doAtari, doBSD, doSparcLinux, and doHPPALinux, which are turned off
  99 by default, because they're really not all that interesting looking
 100 unless you're a fan of those systems.
 101
 102 There are command-line options for all of these:
 103 e.g., \fI\-bsd\fP, \fI\-no-bsd\fP.  (Also note the \fI\-only\fP option.)
 104 .SH BUGS
 105 Unlike the systems being simulated, \fIbsod\fP does not require a
 106 reboot after running.
 107 .SH SEE ALSO
 108 .BR X (1),
 109 .BR xscreensaver (1),
 110 .BR http://www.microsoft.com/ ,
 111 .BR http://www.apple.com/ ,
 112 .BR http://www.sco.com/ ,
 113 .BR http://www.kernel.org/ ,
 114 and
 115 .BR http://www.amiga.de/ .
 116 .SH TRADEMARKS
 117 Microsoft Windows, Microsoft Windows 95, and Microsoft Windows NT are all
 118 registered trademarks of Microsoft Corporation.  Apple Macintosh is a
 119 registered trademark of Apple Computer.  Amiga is a registered trademark of
 120 Amiga International, Inc.  Atari ST is probably a trademark, too, but it's
 121 hard to tell who owns it.  Linux is a registered trademark of Linus Torvalds,
 122 but it isn't his fault. OS/2 is a registered trademark of International
 123 Business Machines Corporation.
 124 .SH COPYRIGHT
 125 Copyright \(co 1998-2003 by Jamie Zawinski.  Permission to use, copy, modify,
 126 distribute, and sell this software and its documentation for any purpose is
 127 hereby granted without fee, provided that the above copyright notice appear
 128 in all copies and that both that copyright notice and this permission notice
 129 appear in supporting documentation.  No representations are made about the
 130 suitability of this software for any purpose.  It is provided "as is" without
 131 express or implied warranty.  No animals were harmed during the testing of
 132 these simulations.  Always mount a scratch monkey.
 133 .SH AUTHOR
 134 Concept cribbed from Stephen Martin <smartin@mks.com>.  This version is by
 135 Jamie Zawinski <jwz@jwz.org>, with contributions from many others.