Copyright (c) 1989, 1991, 1992 by Digital Equipment Corporation Permission to use, copy, modify, and distribute this software for any purpose and without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies, and that the name of Digital Equipment Corporation not be used in advertising or publicity pertaining to distribution of the document or software without specific, written prior permission. Digital Equipment Corporation makes no representations about the suitability of the software described herein for any purpose. It is provided "as is" without express or implied warranty. The software was originally written by Mark Clement and was later substantially revised by Mark Longo, both of Digital Equipment Corp. STARTING OUT ~~~~~~~~~~~~ Dependencies: ------------- You must have an RRD42 CDROM attached to your DECstation. You must be running Ultrix 4.2 (though the ULTRIX binary for xcd mostly works right on OSF/1 systems with the CDROM driver). Getting the Kit: ---------------- The xcd kit is available via. anonymous FTP from gatekeeper.dec.com in the directory pub/DEC. The files are: xcd.README this file xcd.tar.Z prebuilt binary for DECstations (works on both low and high res. monitors) xcd_source.tar.Z source code for low res. monitors xcd_source100.tar.Z source code for high res. monitors Unpacking the Kit: ------------------ Unpack the kit by doing the following: csh> su csh> cd / csh> zcat /wherever/you/put/it/xcd.tar.Z | tar xvf - If you have 100 DPI display hardware: ------------------------------------- Some DECstations use 100 dots-per-inch displays. If you're using one of these displays, xcd's status display area will be incorrectly sized. In order to correct this condition, perform the following: csh> su csh> rm /usr/lib/X11/uid/xcd.uid csh> ln -s /usr/lib/X11/uid/xcd.uid.100dpi /usr/lib/X11/uid/xcd.uid Finding out the device name of your CDROM player: ------------------------------------------------- You need to know the character special device for the CD ROM. To find out the name of this file, you can use the locate_cd program in this distribution. Simply type 'locate_cd'. Here's what output looks like if you have an RRD42 csh> locate_cd /dev/rrz4c You may see a different number between the 'rrz' and the 'c'. If you don't have an RRD42, here's the output you get csh> locate_cd It appears that an RRD42 is not installed on this system. We'll use /dev/rrz4c as the CD ROM device in examples below. Setting device permissions: --------------------------- Permissions on the CD device file returned by locate_cd should be 666. They are not set this way by default, so as superuser you should csh> chmod 666 /dev/rrz4c You need to tell xcd where the CD ROM drive is. You can do this by either setting the environment variable CDROM to the device returned by locate_cd, or by starting xcd with the -f option. For example: # using the environment variable csh> setenv CDROM /dev/rrz4c csh> xcd # using the '-f' option csh> xcd -f /dev/rrz4c Front panel buttons: -------------------- Most of the buttons on the control panel are self-explanatory. One, however, may not be obvious. The padlock button may be used to disable the eject button on the front of the RRD42. This can be used to prevent someone from ripping off your CD. Insert a disk: -------------- You should have the CD you want to listen to inserted in the drive before starting the xcd application. If you do not, xcd will take a few minutes to come up and you may get some error messages. It is safe to ignore these messages if you get them. CUSTOMIZATION ~~~~~~~~~~~~~ You may control some aspects of xcd's appearance by specifying xcd resources in your ~/.Xdefaults file. Use the file "Xcd" as a template. In the binary kit, this file is found at : /usr/lib/X11/app-defaults/Xcd If you have the source kit, a motif UIL compiler, and a little iniative, you can do a quite a bit of customization of xcd by monkeying with the UIL file. Most notable are customizations of the number of "select" buttons/row, button size, and the startup volume level. See the makefile rule for "xcd.uid" to see how to compile the UIL file. Have fun!