makeThere are three alternate versions; see alternate code below +
There are three alternate versions; see Alternate code below for more details.
./gavare > ioccc_ray.ppm convert ioccc_ray.ppm ioccc_ray.jpgand then view ioccc_ray.jpg in a graphics viewer, editor or web browser.
NOTE: if you do not have ImageMagick installed, see the +FAQ on “ImageMagick” +for help.
If you have xv(1) you can do:
./gavare | xv -The author also provided on their web page for the entry an unobfuscated version that was used during development, which we have included in the file -gavare.r3.c.
+gavare.r3.c (named such because that is +what they called it).Finally, the file gavare.alt2.c sets binary mode
-on stdout which theoretically should work in Windows.
stdout which theoretically should work in Windows (if anything works in
+Windows :-) ).
To build the configurable and unobfuscated versions:
make altstdout which theoretically should work in Windows.
You may of course combine the above two commands and give any combination you wish.
This is not possible with the author’s version but it is with the alt versions -(Windows - see below - and otherwise).
+(Windows - see below).As the Windows version will not compile on most viewers’ systems we do not build
it with make alt; instead try:
make alt2make alt; instead try:
For users of systems that distinguish between text and binary mode
(you know who you are), add a library call that specifies binary mode
for stdout as the first statement of main(),
-or use freopen("ioccc_ray.ppm", "wb", stdout); and do not use redirection.
freopen("ioccc_ray.ppm", "wb", stdout); and do not use redirection (or
+see Alternate code above).
A freely distributable command-line version of Microsoft Visual C
exhibits an optimizer bug when compiling this entry. Disable /Og for
best results.
makeThere is an alternate version for those who wish to use QEMU rather than having -to reboot and rely on having a floppy drive (if you even remember what those are -:-) ) etc. See alternate code below.
+There is an alternate version for those who wish to use +QEMU rather than having +to reboot and rely on having a floppy +drive (if you even +remember what those are +:-) ) etc. See Alternate code below.
The current status of this entry is:
-STATUS: compiled executable crashes - please help us fix
+
-STATUS: doesn’t work with some platforms - please help us fix it
-STATUS: INABIAF - please DO NOT fixSTATUS: INABIAF - please DO NOT fix
For more detailed information see 2004/gavin in bugs.html.
./gavinTo enjoy the results (on a Linux/x86 machine) with a floppy drive (remember -those? We do!):
+To enjoy the results (on a Linux/x86 machine) with a floppy drive +(remember those? We do!):
suMake a floppy with an ext2 filesystem (mke2fs /dev/fd0 replacing fd0 with
whatever the floppy device is!), mount it under /mnt/floppy and then:
cp kernel fs.tar lilo.conf boot.b /mnt/floppyNOTE: If the version of your lilo is not 21.4, use the appropriate boot.b file.
-NOTE: If your floppy drive is not /dev/fd0, edit lilo.conf appropriately.
NOTE: If the version of your lilo is not 21.4, use the appropriate boot.b file.
NOTE: If your floppy drive is not /dev/fd0, edit lilo.conf appropriately.
lilo -C /mnt/floppy/lilo.confBoot from the floppy on an x86 machine with a PS/2 keyboard and mouse. Move the window away from the corner.
@@ -448,7 +449,7 @@ you can use it withQEMU.
make altThe use is mostly the same as gavin except that one initially executes gavin.alt
-(which make alt will do) and one will have to use QEMU instead. The files
+and one will have to use QEMU instead. The files
generated are the same names. See to use and try above as
well as the judges’ remarks below plus gavin.html.
You can put additional text files in fs.tar for browsing with vi.
If you do not want to bother rebooting your computer at all, see -http://bellard.org for QEMU (Fabrice Bellard -is an IOCCC 2001 winning entry), but your experience will be limited; use the -alternate code instead. You’ll have to move the mouse to +https://www.qemu.org for QEMU (by Fabrice +Bellard, an IOCCC winning author) and use +the Alternate code instead. You’ll have to move the mouse to trigger the initial screen update.
The judges were able to write a few more programs to run in this OS. What are the limitations for such programs?
@@ -493,7 +494,7 @@ then building a tarball containing the resulting programs (the filesystem format supported by the OS is the tarball format).For further usage information see gavin.html.
The filenames vi and sh are significant, and should not be changed.
Known issues are really too plentiful to list.
If the mouse pointer goes off the left hand side of the screen
it will reappear on the right, and vice-versa.
@@ -519,13 +520,12 @@ Linux-esque kernel header for the bootloader, protected mode descriptor tables,
keyboard maps, etc. (I should also mention that it contains mini functions to
perform an x86 in and out instruction - to allow the keyboard & mouse to be
driven from C code).
Porting to another architecture should be relatively easy* - +
Porting to another architecture should be relatively easy1 -
the string simply needs be replaced with one containing
data & code suitable for the new target platform.
Accesses to data in the string are made relative to the define V,
so these may need updating as appropriate (0x90200 is the address
at which a Linux bootloader loads an x86 kernel image).
\* ;-)* ;-)↩︎