From http://www.jwz.org/xscreensaver/xscreensaver-5.39.tar.gz
[xscreensaver] / 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 doRansomware ,
81 .BR doAmiga ,
82 .BR doMac ,
83 .BR doMac1 ,
84 .BR doMacsBug ,
85 .BR doMacX ,
86 .BR doSCO ,
87 .BR doAtari ,
88 .BR doBSD ,
89 .BR doLinux ,
90 .BR doSparcLinux ,
91 .BR doHPPALinux ,
92 .BR doBlitDamage ,
93 .BR doSolaris ,
94 .BR doHPUX ,
95 .BR doApple2 ,
96 .BR doOS390 ,
97 .BR doTru64 ,
98 .BR doVMS ,
99 .BR doMSDOS ,
100 .BR doOS2 ,
101 .BR doHVX ,
102 .BR doVMware ,
103 and
104 .BR doATM .
105 Each of these is a Boolean resource, they all default to true, except
106 for doAtari, doBSD, doSparcLinux, and doHPPALinux, which are turned off
107 by default, because they're really not all that interesting looking
108 unless you're a fan of those systems.  
109
110 There are command-line options for all of these:
111 e.g., \fI\-bsd\fP, \fI\-no-bsd\fP.  (Also note the \fI\-only\fP option.)
112 .SH BUGS
113 Unlike the systems being simulated, \fIbsod\fP does not require a
114 reboot after running.
115 .SH SEE ALSO
116 .BR X (1),
117 .BR xscreensaver (1),
118 .BR http://www.microsoft.com/ ,
119 .BR http://www.apple.com/ ,
120 .BR http://www.sco.com/ ,
121 .BR http://www.kernel.org/ ,
122 and
123 .BR http://www.amiga.de/ .
124 .SH TRADEMARKS
125 Microsoft Windows, Microsoft Windows 95, and Microsoft Windows NT are all
126 registered trademarks of Microsoft Corporation.  Apple Macintosh is a
127 registered trademark of Apple Computer.  Amiga is a registered trademark of
128 Amiga International, Inc.  Solaris is a trademark of Sun Microsystems.  HP-UX
129 is a trademark of HP Hewlett Packard Group LLC.  Nvidia is a tradmark of
130 Nvidia Corporation.  VMS is probably a trademark of Digital Equipment
131 Corporation.  Atari ST is probably a trademark, too, but it's hard to tell who
132 owns it.  SCO is probably still a trademark of somebody these days, I guess.
133 Linux is a registered trademark of Linus Torvalds, but it isn't his
134 fault. OS/2 is a registered trademark of International Business Machines
135 Corporation. VMware is a registered trademark of VMware, Inc.  Android is a
136 trademark of Google LLC. GladOS is a trademark of Aperture Science
137 Incorporated.
138 .SH COPYRIGHT
139 Copyright \(co 1998-2018 by Jamie Zawinski.  Permission to use, copy, modify, 
140 distribute, and sell this software and its documentation for any purpose is 
141 hereby granted without fee, provided that the above copyright notice appear 
142 in all copies and that both that copyright notice and this permission notice
143 appear in supporting documentation.  No representations are made about the 
144 suitability of this software for any purpose.  It is provided "as is" without
145 express or implied warranty.  No animals were harmed during the testing of
146 these simulations.  Always mount a scratch monkey.
147 .SH AUTHOR
148 Concept cribbed from Stephen Martin <smartin@mks.com>.  This version is by
149 Jamie Zawinski <jwz@jwz.org>, with contributions from many others.