home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xmcd-1.4 / FAQ < prev    next >
Encoding:
Text File  |  1995-05-10  |  12.1 KB  |  285 lines
  1. #
  2. # @(#)FAQ    5.7.1 95/03/27
  3. #
  4. # xmcd   - Motif(tm) CD Audio Player
  5. # cda    - Command-line CD Audio Player
  6. #
  7. # by Ti Kan
  8. #
  9.  
  10. FREQUENTLY ASKED QUESTIONS
  11. --------------------------
  12.  
  13. If you have a question about xmcd/cda or encounter problem,
  14. please read through this file.  You questions may already be
  15. answered in here.  If not, send e-mail to the author.
  16. Suggestions to add new entries to this list are also welcome.
  17.  
  18. ----------
  19. Q. Why do I have to type the disc and track titles into the CD
  20.    database?  Isn't the information recorded on the CD?
  21.  
  22. A. No.  There is no way to get such information by reading the CD.
  23.    Fortunately, the public xmcd CD database is growing at a rapid
  24.    pace and many of your CDs may already be in it.  See the README
  25.    file about how to get a copy of this.
  26. ----------
  27. Q. When I compile the xmcd source code, I get an error about
  28.    XmClientLibs.
  29.  
  30. A. Your system's imake configuration is not set up to properly
  31.    support Motif.  To work around this problem, see the INSTALL
  32.    file and read the comments in the xmcd.d/Imakefile.
  33. ----------
  34. Q. I get the following message when I start xmcd:
  35.    
  36.     Error: attempt to add non-widget child "dsm" to parent "xmcd"
  37.     which supports only widgets
  38.  
  39. A. On certain platforms, there appears to be a problem with
  40.    the vendor shell widget class in the shared Motif library.
  41.    Rearranging the order of the Motif and X libraries linked may
  42.    alleviate this problem, and re-linking with the static
  43.    Motif library instead of the shared version usually solves this
  44.    problem.
  45. ----------
  46. Q. When I start xmcd, I get error messages such as these:
  47.  
  48.     Warning: translation table syntax error: Unknown keysym name: osfActivate
  49.     Warning: ... found while parsing '<Key>osfActivate: BulletinBoardReturn()'
  50.     Warning: translation table syntax error: Unknown keysym name: osfCancel
  51.     Warning: ... found while parsing '<Key>osfCancel: BulletinBoardCancel()'
  52.     etc...
  53.  
  54. A. The LIBDIR/XKeysymDB file is not installed on your system (where
  55.    LIBDIR is typically /usr/lib/X11).  A XKeysymDB file is supplied
  56.    with the xmcd release.  When the XKeysymDB is installed in the
  57.    proper location this problem should go away.
  58. ----------
  59. Q. Xmcd prints the following error message:
  60.  
  61.     Neither the XMcd*libdir resource nor the XMCD_LIBDIR environment is
  62.     defined!
  63.  
  64. A. Your xmcd software is not properly installed.  If you compiled the
  65.    xmcd from the source code, be sure to use "make install" to install
  66.    the software.  Also, make sure that the xmcd.d/XMcd.ad file is
  67.    installed as LIBDIR/app-defaults/XMcd (where LIBDIR is typically
  68.    /usr/lib/X11).  Check the contents of the LIBDIR/app-defaults/XMcd
  69.    file to make sure everything is configured correctly for your system.
  70. ----------
  71. Q. Cda prints the following error message:
  72.  
  73.     XMCD_LIBDIR environment not defined.
  74.  
  75. A. You must set the XMCD_LIBDIR environment variable to run cda.
  76.    Typically this is set to "/usr/lib/X11/xmcd" (your local set-up
  77.    may vary).  You set the environment variable as follows:
  78.  
  79.    Bourne Shell, Korn Shell or bash:
  80.     XMCD_LIBDIR=/usr/lib/X11/xmcd; export XMCD_LIBDIR
  81.  
  82.    C Shell or tcsh:
  83.     setenv XMCD_LIBDIR /usr/lib/X11/xmcd
  84. ----------
  85. Q. Xmcd dies with a message similar to one the following upon startup:
  86.  
  87.     ld.so.1: xmcd: fatal: libXm.so.2: can't open file: errno=2
  88.     Killed
  89.  
  90.     dynamic linker : xmcd : error opening libXm.so.2
  91.     Killed
  92.  
  93. A. Your xmcd binary was compiled to link with dynamic libraries.
  94.    On SVR4 systems, a setuid program such as xmcd will search only
  95.    the /usr/lib and /usr/ccs/lib for dynamic libraries (for security
  96.    concerns).  However, some of the dynamic libraries that xmcd needs
  97.    are not in these standard locations.  This is notably true for
  98.    the Motif (libXm), Xt Intrinsics (libXt) and X11 (libX11) libraries.
  99.  
  100.    In the example messages above, libXm.so.2 is not found.  You may
  101.    also run into the same problem with other libraries.
  102.  
  103.    A solution is to create symbolic links such that these needed
  104.    dynamic libraries are linked to /usr/lib, and thus can be found
  105.    by xmcd.  In this example, if the shared library image for
  106.    Motif is /usr/openwin/lib/libXm.so.2, the following command
  107.    will establish the link:
  108.  
  109.     ln -s /usr/openwin/lib/libXm.so.2 /usr/lib/libXm.so.2
  110.  
  111.    If you don't like the symbolic link approach, an alternate solution
  112.    is to recompile xmcd such that the dynamic library locations are
  113.    specified with the -R option to the ld(1) command.  To do this, you
  114.    must be adept at editing the xmcd.d/Makefile and making the
  115.    appropriate changes, compile the xmcd sources, and re-installing
  116.    the binary.
  117. ----------
  118. Q. Xmcd or cda complains that the CD is busy.
  119.  
  120. A. Check the system for another xmcd or cda process running on
  121.    the same CD-ROM device.  If there are no other xmcd/cda process,
  122.    then look for a file /tmp/.cdaudio/lock.XXXX where XXXX is the
  123.    hexadecimal string of the device number.  Remove this file and
  124.    the problem should go away.  Normally a new xmcd/cda process will
  125.    inherit the lock from a previously exited xmcd/cda process, but
  126.    if the original process ID is now re-used by another process
  127.    this will not work.
  128. ----------
  129. Q. Xmcd or cda complains that the device is not a CD-ROM and quits.
  130.  
  131. A. Ensure that the CD-ROM drive is connected and functioning,
  132.    and that xmcd/cda is properly configured.  If it still fails,
  133.    make sure you did not compile the software with the -ansi option
  134.    to gcc.  If you did, that's the cause of the problem.
  135.  
  136.    If you have one of those unusual OEM SCSI CD-ROM drives that
  137.    identify themselves as a hard disk (such as the Toshiba CD-ROM
  138.    XM revision 1971 units OEM'ed by SGI), you will need to add
  139.    -DOEM_CDROM to the libdi.d/Makefile and recompile.
  140. ----------
  141. Q. Xmcd seems to be real slow to respond to mouse clicks.
  142.  
  143. A. Make sure your system has enough memory.  X11 programs, especially
  144.    Motif applications, consume a lot of memory.  Xmcd is no exception.
  145.    Your system may be swapping and paging heavily, causing the
  146.    performance degradation.  Try closing some unneeded windows.  Also,
  147.    the X server may have a memory leak which causes it to grow
  148.    over time.  Try stopping the entire X session and starting a new
  149.    one.
  150.  
  151.    Run some system performance analysis tools (sar, u386mon, vmstat,
  152.    crash, etc.) to see if there is a system tuning issue.
  153.  
  154.    Also, setting the xmcd X resource XMcd*mainShowFocus to False may
  155.    improve performance somewhat.
  156. ----------
  157. Q. Clicking the mouse button #3 on the volume control, balance control
  158.    and track warp slider thumbs will not bring up the help window.
  159.  
  160. A. Click on the label area instead of the thumb.  This is a limitation
  161.    of the Motif scale widget.
  162. ----------
  163. Q. When clicking mouse button #3 on the volume control numeric label
  164.    area, sometimes the help window does not appear.
  165.  
  166. A. The problem occurs when the current keyboard input focus is on the
  167.    volume control slider.  This is a limitation of the Motif scale
  168.    widget.  The work-around is to click another button first to change
  169.    the keyboard focus to another button, then click the #3 button
  170.    on the volume control numeric label to bring up the help window.
  171. ----------
  172. Q. Xmcd/cda seems to be playing the CD, but there is no sound.
  173.  
  174. A. Make sure you are not running a "demo" version of xmcd.  If you
  175.    see this message when you start xmcd or cda, then you are running
  176.    the demo version that does not actually work with a real CD-ROM
  177.    drive:
  178.  
  179.     CD-ROM simulator version x.xx (pid=xxxxx) starting...
  180.  
  181.    You will get the demo mode if you compile and run xmcd/cda on
  182.    an unsupported OS platform.
  183.  
  184.    Also, make sure your CD-ROM drive audio output is connected to
  185.    something.  You may either connect headphones or amplified speakers
  186.    to the front jack, or connect the rear audio output to an external
  187.    amplifier.
  188.  
  189.    On PC platforms, you can also connect the CD-ROM audio output to
  190.    a sound card.  If a sound card is used, you must also use an audio
  191.    mixer program to set the CD Input Level and Master Volume.  See the
  192.    README file about the xmmix (Motif Audio Mixer) utility.
  193.  
  194.    Xmcd/cda currently does not support the built-in audio hardware
  195.    on some HP, SGI and Sun workstations.  Thus, there is no way
  196.    to make the CD-ROM play via the workstation's internal speakers.
  197.    You probably wouldn't want to use the internal speakers anyway,
  198.    since the sound quality is typically quite poor.
  199. ----------
  200. Q. Xmcd/cda reports "no disc" even though there is a CD in the drive.
  201.  
  202. A. Your system must be set up properly to use a CD-ROM drive.  A good
  203.    test is to see if you can mount ISO-9660/High Sierra CD-ROM
  204.    file-systems.  If your system does not support ISO-9660 but otherwise
  205.    supports a raw CD-ROM device, you can try typing this command while
  206.    logged in as the super-user (with a DATA CD loaded in the CD-ROM
  207.    drive):
  208.  
  209.     dd if=DEVICE of=/dev/null bs=2k count=10
  210.  
  211.    where DEVICE is the CD-ROM device node, such as /dev/rcd0 (SCO ODT),
  212.    /dev/rcdrom/cdrom1 (SVR4.2/x86) or /dev/rsr0 (SunOS 4.1.x).
  213.  
  214.    If the dd command fails, then either your hardware is not set up
  215.    properly, or your OS is not configured to support the CD-ROM device.
  216.    You should fix the problem first before attempting to run xmcd/cda.
  217.  
  218.    Once you have validated basic functionality with data CDs, then
  219.    make sure xmcd/cda is properly configured.  Run the
  220.    LIBDIR/xmcd/config/configure.sh script (where LIBDIR is typically
  221.    /usr/lib/X11).
  222.  
  223.    Also, be sure that you are running on a supported operating system
  224.    and hardware platform, and that the minimum OS version requirement
  225.    is met.  Some platforms require special kernel or driver
  226.    configuration to run xmcd/cda.  See the README and INSTALL files
  227.    for details.
  228. ----------
  229. Q. Some of the features of xmcd/cda do not work, such as the volume
  230.    control, balance control, channel routing, caddy eject, or index
  231.    search buttons.
  232.  
  233. A. Your CD-ROM drive may not support some of these features.
  234.    Another possibility is that the software is improperly configured.
  235.    Run the LIBDIR/xmcd/config/configure.sh script to re-configure
  236.    xmcd/cda.
  237. ----------
  238. Q. The xmcd shuffle mode button doesn't work, it just beeps when I click
  239.    on it.
  240.  
  241. A. Shuffle mode can only be enabled when the CD is stopped.  If your
  242.    CD is playing, stop the playback and the shuffle button should work.
  243.    This is a safeguard feature to prevent unintentionally interrupting
  244.    the playback.
  245. ----------
  246. Q. I am using a non-SCSI CD-ROM drive under Linux.  The system seems to
  247.    hang for a few seconds when I start or stop the CD via xmcd/cda,
  248.    then everything works fine after that.
  249.  
  250. A. This is the characteristic of the particular CD-ROM device driver
  251.    and can be considered "normal" (or send bug report to the driver
  252.    author).
  253. ----------
  254. Q. I would like to purchase a CD-ROM drive for use with xmcd/cda and
  255.    for data CD purposes.  Which do you recommend?
  256.  
  257. A. I will not give specific brand and model recommendations, but I
  258.    will recommend a SCSI-2 drive over a non-SCSI one.  Xmcd does not
  259.    currently support non-SCSI units except under Linux.  Also, more
  260.    features are supported by xmcd on SCSI drives than on non-SCSI units.
  261.  
  262.    Furthermore, SCSI CD-ROM drives are universally supported on the
  263.    various OS and hardware platforms (whereas non-SCSI units only
  264.    work on x86 PCs).  This makes a SCSI drive more portable between
  265.    different systems, and there is less worry about getting obscure
  266.    device drivers to work.
  267.  
  268.    Note that not all SCSI-2 drives are created equal, some of them
  269.    implement more of the audio-related commands than others.  If you
  270.    do a careful study of xmcd's libdi.d/cfgtbl/* files, you'll get
  271.    a good glimpse at the CD-ROM drives' capabilities.  Some of
  272.    xmcd's features will not work unless these commands are fully
  273.    implemented on the drive.  Also, see the README file for specific
  274.    drive-related notes.
  275.  
  276.    While all audio CDs run at single-speed, if you will mount data CDs
  277.    extensively, it pays to get the double-speed or faster units.  A good
  278.    size cache (256KB or more) is a good idea.
  279.  
  280.    Note that some workstations require special OEM versions of the
  281.    CD-ROM drives (such as Sun, which requires support of 512-byte
  282.    block sizes rather than the standard 2048).
  283. ----------
  284.  
  285.