http://ftp.x.org/contrib/applications/xscreensaver-3.24.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 "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, the
31 Apple Macintosh (both the MacsBug debugger and the rarer "Sad Mac"), and the
32 Atari ST.
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 .SH ENVIRONMENT
57 .PP
58 .TP 8
59 .B DISPLAY
60 to get the default host and display number.
61 .TP 8
62 .B XENVIRONMENT
63 to get the name of a resource file that overrides the global resources
64 stored in the RESOURCE_MANAGER property.
65 .SH X RESOURCES
66 Notable X resources supported include the following, which control which
67 hacks are displayed and which aren't.
68 .BR doWindows ,
69 .BR doNT ,
70 .BR doAmiga ,
71 .BR doMac ,
72 .BR doMacsBug ,
73 .BR doSCO ,
74 .BR doAtari ,
75 .BR doBlitDamage ,
76 and
77 .BR doSparcLinux .
78 Each of these is a Boolean resource, they all default to true, except for
79 doSparcLinux and doAtari, which are turned off by default, because they're
80 really not all that interesting looking unless you're a fan of those systems.
81 There aren't command-line options for these, so to change them, you'll need
82 to add entries to your .Xdefaults file, or use the -xrm option.
83 For example, to tell bsod not to show the NT crash:
84 .EX
85 bsod -xrm '*doNT: false'
86 .EE
87 .SH BUGS
88 Unlike the systems that the images are borrowed from,
89 .I bsod
90 does not require a reboot after running.
91 .PP
92 .I bsod
93 should also emulate more systems, but systems with interesting crash
94 graphics are not as common as one might hope.
95
96 One I'd really like to see is a Unix system getting a kernel panic, 
97 rebooting, and running
98 .BR fsck (8).
99 .SH SEE ALSO
100 .BR X (1),
101 .BR xscreensaver (1),
102 .BR http://www.microsoft.com/ ,
103 .BR http://www.apple.com/ ,
104 and
105 .BR http://www.sco.com/ ,
106 .BR http://www.kernel.org/ ,
107 and
108 .BR http://www.amiga.de/ .
109 .SH TRADEMARKS
110 Microsoft Windows, Microsoft Windows 95, and Microsoft Windows NT are all
111 registered trademarks of Microsoft Corporation.  Apple Macintosh is a
112 registered trademark of Apple Computer.  Amiga is a registered trademark of
113 Amiga International, Inc.  Atari ST is probably a trademark, too, but it's
114 hard to tell who owns it. Linux is a registered trademark of Linus Torvalds,
115 but it isn't his fault.
116 .SH COPYRIGHT
117 Copyright \(co 1998 by Jamie Zawinski.  Permission to use, copy, modify, 
118 distribute, and sell this software and its documentation for any purpose is 
119 hereby granted without fee, provided that the above copyright notice appear 
120 in all copies and that both that copyright notice and this permission notice
121 appear in supporting documentation.  No representations are made about the 
122 suitability of this software for any purpose.  It is provided "as is" without
123 express or implied warranty.  No animals were harmed during the testing of
124 these simulations.  Always mount a scratch monkey.
125 .SH AUTHOR
126 Concept cribbed from Stephen Martin <smartin@mks.com>.  This version is by
127 Jamie Zawinski <jwz@jwz.org>.