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