home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xmcd-1.4 / README < prev    next >
Encoding:
Text File  |  1995-05-10  |  23.7 KB  |  613 lines
  1. #
  2. # @(#)README    5.36 95/02/12
  3. #
  4. # xmcd   - Motif(tm) CD Audio Player
  5. # cda    - Command-line CD Audio Player
  6. #
  7. # by Ti Kan
  8. #
  9.  
  10.  
  11. INTRODUCTION
  12. ------------
  13.  
  14. These are the release notes for xmcd, an X11/Motif-based CD player
  15. utility; and for cda, a command-line driven, non-graphical CD audio
  16. player.  Please read through this file before building, installing, or
  17. using xmcd/cda.  You should also read the INSTALL file if you will be
  18. compiling these applications from the source code distribution.  After
  19. installation, you can use the man(1) or xman(1) command to read the
  20. on-line manual entry.  The CHANGES file contains a revision log.
  21. If you encounter a problem, please read the FAQ file first, as it may
  22. already document a solution.
  23.  
  24.  
  25.  
  26. SOURCE CODE RELEASE NOTES
  27. -------------------------
  28.  
  29. The source code of this version of xmcd and cda supports the following
  30. operating systems environments:
  31.  
  32.  
  33.     1.  Apple A/UX (on Apple Macintosh 680x0)
  34.         - A/UX version 3.0 or later
  35.           (with devscsi module installed)
  36.  
  37.     2.  Data General DG/UX (on DG AViiON m88k)
  38.         - DG/UX version 5.4R3.00 or later (see notes below)
  39.  
  40.     3.  DEC OSF/1 (on DEC Alpha AXP)
  41.         - DEC OSF/1 version 1.3 or later (see notes below)
  42.  
  43.     4.  DEC Ultrix (on DECstation)
  44.         - DEC Ultrix version 4.3 or later
  45.           (with SCSI CAM installed, see notes below)
  46.  
  47.     5.  FreeBSD (on Intel x86 PC-compatible)
  48.         - FreeBSD 2.1 or later with XFree86 (X11R5 or X11R6) +
  49.           Motif 1.2 (see notes below)
  50.  
  51.     6.  Hewlett Packard HP-UX (on HP Series 700 PA-RISC)
  52.         - HP-UX Release 9.x or later
  53.  
  54.     7.  IBM AIX (on IBM RS/6000 Power/PowerPC and compatibles from Bull)
  55.         - AIX version 3.2.x
  56.         - AIX version 4.x
  57.  
  58.     8.  Linux (on Intel x86 PC-compatible)
  59.         - Linux 0.99 or later with XFree86 (X11R5 or X11R6) + Motif 1.2
  60.  
  61.     9.  SCO UNIX System V Release 3.2 (on Intel x86 PC-compatible)
  62.         - SCO Open Desktop Version 2.x (X11R4 or X11R5 server)
  63.         - SCO Open Desktop Version 3.x
  64.         - SCO UNIX 3.2v4.x with XFree86 (X11R5 or X11R6) + Motif 1.2
  65.  
  66.     10. Silicon Graphics IRIX (on SGI)
  67.         - IRIX version 4.x
  68.         - IRIX version 5.x
  69.  
  70.     11. Stratus FTX System V Release 4 (on Stratus PA-RISC)
  71.         - FTX version 3.x
  72.  
  73.     12. SunOS (on Sun Sparc and compatibles)
  74.         - SunOS 4.1.x / Solaris 1.x (see notes below)
  75.  
  76.     13. SunOS System V Release 4 (on Sun Sparc and compatibles)
  77.         - SunOS 5.x / Solaris 2.x (see notes below)
  78.  
  79.     14. SunOS System V Release 4 (on Intel x86 PC-compatible)
  80.         - SunOS 5.x / Solaris 2.x (see notes below)
  81.  
  82.     15. UNIX System V Release 4.0 (on Intel x86 PC-compatible)
  83.         (Note: 4.0.3 or later recommended)
  84.         - AT&T
  85.         - Consensys
  86.         - Dell
  87.         - ESIX
  88.         - ISC
  89.         - Microport
  90.         - Micro Station Technology
  91.         - UHC
  92.         - USL
  93.  
  94.     16. UNIX System V Release 4.0 (on Motorola 88k)
  95.         - Motorola
  96.  
  97.     17. UNIX System V Release 4.2 (on Intel x86 PC-compatible)
  98.         - Consensys
  99.         - Information Foundation
  100.         - Novell/Univel UnixWare 1.x
  101.         - Onsite
  102.         - USL
  103.  
  104.     18. UNIX System V Release 4.2MP (on Intel x86 PC-compatible)
  105.         - Novell/USL UnixWare 2.x
  106.  
  107.  
  108. In general, binaries compiled on one OS can run on another OS under the
  109. same group.  Thus, xmcd and cda binaries compiled on Consensys SVR4.0
  110. should run on ESIX SVR4.0, but not on Novell UnixWare or SCO ODT.
  111. There are some issues with shared library compatibility amongst the
  112. different SVR4.0 vendors, so it is best to run xmcd on the same OS that
  113. it's compiled on.
  114.  
  115. Xmcd and cda must be installed as a setuid-root program on virtually
  116. all platforms.  This is because these utilities use the SCSI
  117. pass-through mechanism to control the CD-ROM drive, which requires root
  118. privilege on most systems.  Security issues have been addressed, however,
  119. since neither application will send read/write commands to a device.
  120. They will also refuse to send any more command to a device if the
  121. initial inquiry shows that the device is not a CD-ROM.  Also, xmcd
  122. changes the uid and gid to that of the real user before reading/writing
  123. CD database files or executing external programs.
  124.  
  125. On systems that do not require super-user privilege for SCSI
  126. pass-through, it is actually more secure to turn off the user and group
  127. permissions of the SCSI device nodes, and make xmcd and cda setuid-root.
  128. This prevents malicious users from writing programs that send arbitrary
  129. commands to the devices.
  130.  
  131. An exception to the setuid-root requirement:  If you configure xmcd
  132. and cda to operate the drive via the "SunOS/Linux ioctl method"
  133. (see the NON-SCSI CD-ROM DRIVES section below), setuid-root privilege
  134. is not required.
  135.  
  136. The minimum DEC Ultrix and OSF/1 OS version listed above should be
  137. heeded.  Running xmcd and cda on earlier releases of either OS may
  138. cause the system to crash, due to bugs in the OS.  You must create
  139. the /dev/cam device before using xmcd/cda under Ultrix.  To do so,
  140. type the following commands while logged in as root:
  141.  
  142.     cd /dev
  143.     MAKEDEV cam
  144.  
  145. For DG/UX, you must configure the CD-ROM to be a user SCSI device
  146. instead of a SCSI disk.  To do so, follow these steps:
  147.  
  148.     1) Find the line in the file /var/Build/system.<hostname> which
  149.        represents your CD-ROM drive and change the prefix "sd" to
  150.        "scsi".
  151.     2) Rebuild and reboot your kernel.
  152.  
  153. The current SunOS 4.1.x run-time support is limited to systems
  154. running the sun4c and sun4m kernels.  To find out which kernel you
  155. have, use the "arch -k" command.  Please note it has been observed
  156. that at least on some SunOS 4.x systems, 12-byte SCSI commands are
  157. not properly supported by the Sun CD-ROM driver.  Thus, if you have
  158. a SCSI-2 CD-ROM drive, be sure that the "playAudio12Support" parameter
  159. is set to "False" in your xmcd device-specific configuration file
  160. (such as /usr/lib/X11/xmcd/config/rsr0).  Because of this OS
  161. limitation, the SCSI-1 Hitachi CD-ROM drives (which has all 12-byte
  162. vendor-unique SCSI-1 audio commands) may not work under SunOS 4.1.
  163.  
  164. On Solaris 2.x platforms, you should use the virtual CD-ROM device
  165. (such as /vol/dev/aliases/cdrom0) if the Solaris Volume Manager
  166. (/usr/sbin/vold) is also running. You should set xmcd's
  167. "solaris2VolumeManager" X resource and either the "closeOnEject" or
  168. "exitOnEject" device-specific parameter to True when operating under
  169. the Volume Manager.  If you want the Volume Manager to automatically
  170. start xmcd when a CD is inserted, you can specify the action_workman.so
  171. start-up program in the /etc/rmmount.conf file:
  172.  
  173. action cdrom action_workman.so /usr/local/bin/X11/xmcd
  174.  
  175. Substitute /usr/local/bin/X11 with the actual path to your xmcd
  176. binary.  See rmmount(1M) and rmmount.conf(4) for more information.
  177.  
  178. If the Solaris Volume Manager is running, you should only use the
  179. Eject button on the xmcd main window to eject the CD.  Do not use
  180. the eject button on the CD-ROM drive itself.
  181.  
  182. The XMcd.ad file contains several long lines broken into separate lines
  183. using the "\" continuation marker (in particular, the
  184. "XMcd*someWidgetName.fontList" lines).  This has been known to cause
  185. error messages on SGI IRIX systems.  To remedy this, remove the "\"
  186. continuation markers and join the multiple lines back into a single
  187. line.
  188.  
  189. Several portions of xmcd and cda were contributed by these dedicated
  190. individuals:
  191.  
  192.     Apple A/UX port:
  193.     Eric Rosen
  194.  
  195.     Data General DG/UX port:
  196.     Karl Owen (owen@dg-rtp.dg.com)
  197.  
  198.     DEC Ultrix and DEC OSF/1 port:
  199.     Matt Thomas (thomas@lkg.dec.com)
  200.         Anthony Baxter (anthony@aaii.oz.au)
  201.  
  202.     FreeBSD port:
  203.     Gennady B. Sorokopud (gena@netvision.net.il)
  204.  
  205.     IBM AIX port:
  206.     Kurt Brunton (kbrunton@ccs.harris.com)
  207.         Tom Crawley (tomc@osi.curtin.edu.au)
  208.  
  209.     Motorola SVR4/88K port:
  210.     Mark Scott (mscott@urbana.mot.com)
  211.  
  212.     The SunOS/Linux ioctl method code to support non-SCSI CD-ROM
  213.     drives is based on code contributed by Peter Bauer
  214.     (100136.3530@compuserve.com).
  215.  
  216.     Several Solaris 2.x enhancements were contributed by
  217.     Lee Duncan (Lee.Duncan@sun.com).
  218.  
  219.     The visual mode support in cda is based on code contributed
  220.     by Philip Le Riche (pleriche@uk03.bull.co.uk).
  221.  
  222. Although xmcd and cda should run reliably on the supported platforms
  223. and CD hardware as noted, if you encounter a problem, please send a
  224. report to "ti@amb.org" with detailed descriptions of the configuration
  225. and problem symptoms.  It would also be helpful to reproduce the
  226. problem while running either application with the -debug option, and
  227. capture the diagnostic output.  Send the output to the author for
  228. examination.
  229.  
  230. Better yet, send bug fixes!
  231.  
  232. See the INSTALL file for information about the required X11 and Motif
  233. library versions and configurations, and build/install instructions.
  234.  
  235. For Copyright information, read the COPYING file.
  236.  
  237. The modular design of xmcd and cda is such that support for other UNIX
  238. environments and CD-ROM drives can be readily added.  See the "PORTING"
  239. file for details if you are interested in contributing to the development
  240. effort.  Before you start a porting effort or add significant code,
  241. contact the author to ensure that this effort isn't being duplicated
  242. by others.
  243.  
  244.  
  245. GENERAL SOFTWARE NOTES
  246. ----------------------
  247.  
  248. This release of xmcd features the following:
  249.  
  250.     - Standard functions: Stop, Play, Pause, Next/Previous Track,
  251.       Next/Previous Index, Fast forward/rewind with audio sample,
  252.       Eject and On/off.
  253.     - Direct track access keypad and track-warp slider controls.
  254.     - Volume control with selectable taper characteristics.
  255.     - Balance control.
  256.     - Channel routing control: Select between normal stereo,
  257.       reversed stereo, mono-L, mono-R, or mono-L+R.
  258.     - Track/Index/Time display: Selectable to display elapsed time,
  259.       remaining track time, or remaining disc time.
  260.     - Status display: for current play status, A->B mode, program
  261.       mode, CD database.
  262.     - Shuffle (random) play function.
  263.     - Repeat function with iteration counter.
  264.     - Sample function: Play a few seconds of each track.
  265.     - A->B function: Repeat from selectable point A and B.
  266.     - Eject inhibit function: To prevent someone from ejecting the
  267.       disc by pressing the button on the drive.
  268.     - Automation options on CD load, eject, play completion and
  269.       program exit.
  270.     - Track Program function: Play tracks in custom order.
  271.     - CD database function: Allows you to store CD title/track titles
  272.       in database, and associate each disc with a play program.
  273.       Displays the current playing disc title/track information.
  274.       In addition, you can enter and display arbitrary text associated
  275.       with the disc or each track, such as band information, lyrics,
  276.       etc.
  277.     - CD database entry send: Contribute CD database entries to
  278.       a central archive via Internet electronic mail.
  279.     - Main window button face labels can be configured to display
  280.       pictorial symbols, or text with hotkey mnemonics.
  281.     - The complete application can be operated via the keyboard with
  282.       full support for keyboard traversal and hotkeys.
  283.     - All labels and messages can be customized to non-English
  284.       languages via X resources in the .Xdefaults file.
  285.     - All colors and many other functionality are user-customizable
  286.       using X resource settings.
  287.     - On-line help information.
  288.     - Attractive, intuitive-to-use Motif user interface.
  289.     - Device-specific configuration files to make xmcd adaptable
  290.       to various brands of CD-ROM drives.
  291.  
  292. Xmcd uses the Motif toolkit to achieve a pleasing appearance, such that
  293. it actually looks and feels like a real CD player for all basic
  294. functions, yet takes advantage of the GUI and window system to make
  295. programming and CD database functions easy.
  296.  
  297. Currently, the cda utility offers almost the same functionality as
  298. xmcd except the FF, REW, Sample and A->B features are not available.
  299. Also, the CD database is read-only via cda (no updates).  In addition,
  300. a visual mode is available that turns cda into a screen-oriented
  301. (curses-based) CD player.
  302.  
  303.  
  304. Your xmcd/cda binary should only be run on the same OS platform group
  305. that it was compiled on.  For example, UNIX SVR4.0 binaries must
  306. not be run on a UNIX SVR4.2 system.  Likewise, a binary compiled
  307. on a SunOS 4.x platform cannot be used on a SunOS 5.x system.
  308.  
  309. Do not use xmcd/cda if the CD-ROM drive contains a mounted filesystem
  310. data disc (ISO-9660, High Sierra or other formats).  Always use the
  311. "df" or "mount" command to check if such a filesystem is mounted
  312. before invoking the application.
  313.  
  314. Certain OS platforms will print console error messages or record error
  315. messages in a log file if the CD device is accessed without a CD loaded
  316. in the drive.  If you encounter this situation, the workaround is to
  317. load a CD in the drive before starting xmcd or cda, and refrain from
  318. leaving xmcd in the "no disc" state for an extended period of time.
  319.  
  320. Unless otherwise instructed by your OS or system hardware vendor,
  321. it is generally a bad idea to turn off the power of the CD-ROM drive
  322. while the operating system is running.  Cycling the power may
  323. cause the CD-ROM drive to assert a SCSI bus reset, which is not always
  324. gracefully handled by your system's SCSI device driver (i.e., possible
  325. system hang or crash).  Thus, it is best to turn on the CD-ROM drive
  326. before booting the OS, and do not turn it off until after OS shutdown.
  327.  
  328.  
  329. CD-ROM NOTES
  330. ------------
  331.  
  332. This release of xmcd and cda should work with the following CD-ROM
  333. drives.  See notes below for specific information:
  334.  
  335.     Apple
  336.         CD SC+, CD-150, CD-300, CD-300i
  337.     Chinon
  338.         CDS-431, CDX-431, CDS-435, CDX-435, CDS-525, CDX-525,
  339.         CDS-535, CDX-535
  340.     Compaq
  341.         CDU-561, CR-503BCQ
  342.     Creative Labs
  343.         CD-ROM (#)
  344.     DEC
  345.         RRD42, RRD43, RRD44
  346.     Hitachi
  347.         CDR-1650S, CDR-1750S, CDR-1950S, CDR-3650, CDR-3750,
  348.         CDR-6750
  349.     IBM
  350.         7210-001
  351.     Mitsumi
  352.         FX001S (#). FX001D (#), FX001DE (#), LU005S (#)
  353.     NEC
  354.         CDR-72, CDR-74, CDR-77, CDR-80, CDR-82, CDR-84,
  355.         CDR-38 (*), CDR-74-1 (*), CDR-84-1 (*),
  356.         CDR-210P, CDR-260 (#), CDR-260R (#),
  357.         CDR-400 (Multispin 3X), CDR-500 (Multispin 3X),
  358.         CDR-510 (Multispin 3X), CDR-600 (Multispin 3X),
  359.         CDR-501 (Multispin 4x), CDR-601 (Multispin 4X)
  360.         CDR-900 (4XPro)
  361.     Kotobuki/Matsushita/Panasonic
  362.         CR-521 (#), CR-562 (#), CR-563 (#)
  363.     Pioneer
  364.         DRM-600, DRM-600A, DRM-610, DRM-602X, DRM-604X (*),
  365.         DRM-1804X
  366.     Plextor/Texel
  367.         DM-3024, DM-5024, DM-3028, DM-5028, PX-43CH (4Plex),
  368.         PX-45CH (4Plex), PX-43CS (4Plex), PX-45CS (4Plex)
  369.     Procom
  370.         CDT4-3X, CDT4-DS, CDT4-MX, CDT7-3X, CDT7-DS,
  371.         DSP-DR0020, ICD-MX, MCD-DS, MCDN-3X, SICD-DS,
  372.         SICDN-3X, SXCD-DS, SXCDN-3X
  373.     Sony
  374.         CDU-31A (#), CDU-33A (#), CDU-55E (#), CDU-55S,
  375.         CDU-541, CDU-561, CDU-6111, CDU-6211, CDU-7211,
  376.         CDU-7811, CDU-8002, CDU-8003, CDU-8003A, CDU-8012
  377.     Sun
  378.         CD-ROM (Sony OEM), CD-ROM (Toshiba OEM)
  379.     Toshiba
  380.         XM-3101, XM-3201, XM-3301, XM-3401, XM-3501,
  381.         XM-4101, XM-8100
  382.  
  383.     Other SCSI-2 compliant CD-ROM drives
  384.     Other non-SCSI CD-ROM drives (#) (driver support required)
  385.  
  386. Units denoted with a hash symbol (#) are currently supported only on
  387. the Linux platform.  These drives are typically used with a
  388. proprietary interface card or a sound card.  See the "NON-SCSI CD-ROM
  389. DRIVES" section below for details.
  390.  
  391. Units denoted with an asterisk (*) can be configured to operate in the
  392. SCSI-1 or SCSI-2 mode (via jumpers or DIP switch).  You must configure
  393. the xmcd software accordingly (with the LIBDIR/xmcd/config/configure.sh
  394. program).  Depending upon the specific model, you may find that xmcd/cda
  395. supports more features while operating in SCSI-2 mode.  See the CD-ROM
  396. drive owner's manual for details about setting the mode.
  397.  
  398. The Chinon CDx-431 and CDx-435 drives do not support commands to
  399. implement audio pause and resume operations.  Thus, these features
  400. are non-functional when these drives are used with xmcd/cda.  The
  401. CDx-525 and CDx-535 units do not have this limitation.
  402.  
  403. To avoid possible SCSI bus lock-up, never eject the disc using the
  404. eject button on the front panel of the Hitachi CD-ROM drives while
  405. the unit is playing audio.  Use the software eject function of xmcd/cda
  406. instead.  Also, you may wish to adjust the searchSkipBlocks and
  407. searchPauseInterval configuration parameters to achieve the best
  408. audio sampling effect during xmcd's REW and FF search operations.
  409.  
  410. This release of xmcd/cda supports operating only the first disc on the
  411. Pioneer multi-disc CD-ROM changers.  Pioneer DRM-604X units with
  412. revisions of the firmware prior to 2403 must be configured to operate
  413. in the SCSI-1 mode (DRM-600 emulation, via back panel DIP switches),
  414. and xmcd/cda must be configured as if it's operating a DRM-600.  Newer
  415. DRM-604X units (firmware version 2403 and later) can be set up to
  416. run in SCSI-2 mode, and xmcd/cda must be set up accordingly.
  417.  
  418. The Plextor/Texel DM-x024 drive firmware should be version 1.10 or
  419. later to avoid system lockups.  The DM-x028 drives do not have these
  420. restrictions.
  421.  
  422. Note that even if a CD-ROM drive is marketed as SCSI-2 compliant, it
  423. still may not implement the full set of audio-related commands that
  424. xmcd/cda requires.
  425.  
  426. The SCSI drives listed above will work only when connected via a
  427. proper SCSI host adapter board.  Some x86 PC platforms use SCSI
  428. CD-ROM drives but they are connected to sound cards that use a
  429. proprietary interface.  These may work if xmcd/cda is configured
  430. to operate the unit as a non-SCSI drive (see below).
  431.  
  432. If you have a CD-ROM drive not listed above, I would appreciate a note
  433. from you regarding whether it works with xmcd/cda or not.  If it works,
  434. please send me your xmcd device-specific configuration file for this
  435. drive (usually /usr/lib/X11/xmcd/config/NAME, where NAME is the name
  436. of the device node name of the CD-ROM drive).  I will then add your
  437. drive to the supported list.
  438.  
  439. Some CD-ROM drives do not function well when the SCSI host adapter
  440. board is configured to "synchronous negotiation" mode.  Examples
  441. of these include certain NEC and Hitachi units.  If you experience
  442. malfunctions with xmcd/cda, check the host adapter board configuration
  443. and try disabling the synchronous mode.  On the Adaptec AHA-1542B,
  444. there is a single jumper that controls whether synchronous negotiation
  445. is enabled for all devices on the SCSI bus.  On the AHA-1542C,
  446. synchronous negotiation is configurable via the on-board setup program,
  447. and is settable on a per-ID basis.  Please consult your SCSI host
  448. adapter board owner's manual for information.
  449.  
  450.  
  451. NON-SCSI CD-ROM DRIVES
  452. ----------------------
  453.  
  454. This release of xmcd and cda supports several non-SCSI CD-ROM drives
  455. on the Linux platform only.  Xmcd/cda must be configured to operate
  456. in the "SunOS/Linux ioctl method" when used with these drives (rather
  457. than the "SCSI pass-through method").  See the "deviceInterfaceMethod"
  458. parameter in /usr/lib/X11/xmcd/config/sr0.
  459.  
  460. The specific list of non-SCSI drives supported depends upon the
  461. configuration of the Linux host CD-ROM driver.  The following are
  462. descriptions of the Linux mcd, sbpcd and cdu31a drivers, currently
  463. supplied with Linux:
  464.  
  465.     - mcd
  466.     Several Mitsumi CD-ROMs (FX001, LU005S and others)
  467.     - sbpcd
  468.     The SoundBlaster Pro (Matsushita, Kotobuki, Panasonic,
  469.     Creative Labs, Aztech) CD-ROM driver.  Supports the whole
  470.     family of Matsushita/Kotobuki/Panasonic drives, and it
  471.     will work with the soundcard interfaces (SB Pro, SB 16,
  472.     Galaxy, OmniCD, SoundFX, ...) and/or with the "no-sound"
  473.     cards (Panasonic CI-101P, LaserMate, Aztech, ...).  See
  474.     the /usr/src/linux/drivers/block/README.sbpcd file for
  475.     details.
  476.     - cdu31a
  477.     The Sony interface device driver handles Sony interface
  478.     CDROM drives and provides a complete block-level interface
  479.     as well as an ioctl() interface compatible with the Sun
  480.     (as specified in <linux/cdrom.h>).  With this interface,
  481.     CDROMs can be accessed and standard audio CDs can be
  482.     played back normally.
  483.  
  484. An IDE/EIDE/ATAPI CD-ROM driver is included on Linux kernels
  485. 1.1.76 or later only.  Patches for earlier kernels are available
  486. from Linux FTP sites.  IDE/EIDE/ATAPI-based CD-ROM drives must be
  487. used with a kernel with the proper driver support.
  488.  
  489. Development is ongoing and new drivers are likely to be added
  490. for other non-SCSI CD-ROM drives.  As long as new drivers conform
  491. to the existing ioctl interface, xmcd/cda should work without
  492. modifications.
  493.  
  494. See your Linux documentation about configuring a kernel to use these
  495. drivers.
  496.  
  497. All features which are defined for the SunOS/Linux ioctl interface
  498. are enabled in xmcd/cda regardless whether the drivers can handle it
  499. or not, because enhancements are ongoing.
  500.  
  501. Although the SunOS/Linux ioctl method will also work with many
  502. SCSI CD-ROM drives on the Linux, SunOS 4.1.x (Solaris 1.x) and
  503. SunOS 5.x (Solaris 2.x) platforms, it offers less features than
  504. the SCSI pass-through method and is thus not recommended for SCSI
  505. drives.
  506.  
  507.  
  508. WHERE TO GET XMCD
  509. -----------------
  510. The source code release of xmcd/cda version 1.4 is available via
  511. Internet anonymous FTP.  Location:
  512.  
  513.     (Instructions)
  514.     ftp.x.org:/contrib/applications/xmcd/xmcd-1.4.README
  515.     (gzip'd tar archive)
  516.     ftp.x.org:/contrib/applications/xmcd/xmcd-1.4.tar.gz
  517.  
  518. An xmcd CD database is also available via anonymous FTP:
  519.  
  520.     (Instructions)
  521.     ftp.x.org:/contrib/applications/xmcd/xmcd-cddb.README
  522.     (gzip'd tar archive)
  523.     ftp.x.org:/contrib/applications/xmcd/xmcd-cddb.tar.gz
  524.  
  525. Both packages require the "gunzip" (GNU unzip) utility to uncompress.
  526. The source code to gzip/gunzip can be found on various FTP sites
  527. (such as prep.ai.mit.edu:/pub/gnu).
  528.  
  529. This CD database is periodically updated with more entries, and you are
  530. encouraged to contribute to this database by using the "Send" feature
  531. in xmcd.
  532.  
  533. Binary releases of xmcd and cda for certain OS environments are also
  534. available from the author.   Please write to "ti@amb.org" for more
  535. information.
  536.  
  537.  
  538. XMCD/CDA WORLD WIDE WEB HOME PAGE
  539. ---------------------------------
  540. For those of you with access to the WWW (via NCSA Mosaic, Netscape
  541. or other WWW browser), there is now a Home Page for xmcd and cda.
  542. The location is:
  543.  
  544.     http://www.btg.com/~cknudsen/xmcd/
  545.  
  546. This home page provides up-to-date information about the
  547. current release version, online README file, FTP service to get
  548. the software, an interactive form to send comments and
  549. suggestions, and late breaking announcement, if any.
  550.  
  551. Also available on the xmcd/cda WWW Home Page is the Online CD
  552. Database Search feature.  This is based on the public xmcd CD
  553. database and allows you to find entries in the database quickly.
  554.  
  555. You are invited to visit this space and make use of its services.
  556.  
  557. Many thanks to Craig Knudsen (cknudsen@btg.com) for graciously
  558. providing the Web server space, and creating the CD database
  559. search feature.
  560.  
  561.  
  562. OTHER INFORMATION
  563. -----------------
  564.  
  565. Linux, SCO, UnixWare or other System V variant UNIX users on an
  566. x86 PC-compatible platform:  If you have a sound card such as
  567. the Adlib, Sound Blaster series, Pro Audio Spectrum, Gravis
  568. Ultrasound, Roland MPU-401, Microsoft Sound System, etc., you
  569. may want to look into the sound card driver package called
  570. "VoxWare" by Hannu Savolainen (hannu@voxware.pp.fi).  This package
  571. allows you to operate the sound card's mixer settings, amongst
  572. many other capabilities.
  573.  
  574. I have written an X11/Motif audio mixer utility "xmmix" which
  575. works with the VoxWare package.  Slider controls are provided
  576. in xmmix to set the Synth, PCM, Line, CD and Microphone
  577. input levels, the Rec Out, Rec Monitor, Speaker, and Master
  578. output levels, and Bass/Treble settings, where applicable.
  579. You can also use the Mute, Loudness and Stereo Enhance features
  580. of the sound card if so equipped.
  581.  
  582. Xmcd and xmmix makes an ideal pair in your multimedia PC system.
  583. You are invited to give xmmix a try.  Xmmix can be obtained via
  584. anonymous FTP from the following location:
  585.  
  586.     ftp.x.org:/contrib/applications/xmmix
  587.  
  588. VoxWare anonymous FTP location:
  589.  
  590.     sunsite.unc.edu:/pub/Linux/kernel/sound
  591.  
  592. For further information please refer to the VoxWare documentation
  593. or contact the author of the VoxWare software.
  594.  
  595. On other platforms, please refer to your OS/platform vendor
  596. documentation about controlling your audio hardware, if applicable.
  597.  
  598.  
  599. ACKNOWLEDGEMENTS
  600. ----------------
  601.  
  602. Companies names and product names appearing in this file are each
  603. trademarks of the respective company.  The names are for identification
  604. purposes only.  This software and its author are not affiliated with any
  605. of these companies.
  606.  
  607. I wish to express my appreciation for all the people who participated
  608. in the extensive xmcd beta test program, who have contributed a great
  609. deal to the user-friendliness, robustness and device support.
  610. Many thanks also goes out to those that have contributed code,
  611. suggestions, ideas, criticisms and notes of encouragement!
  612.  
  613.