README
1dcd: Dave's CD player
2
3Installation instructions are in the file named INSTALL.
4The copying policy and license for use are in the file named COPYING.
5Known bugs are in the file called BUGS.
6
7***
8
9What is it? -- dcd is a simple, command-line based CD player.
10
11There was one simple premise behind the design of dcd:
12You want to listen to a CD.
13
14That's it. You don't need to tie up a console, launch X Windows, or
15connect to the Internet to get music pounding out of your speakers as
16quickly as possible. So, unless you tell it otherwise, dcd will start a CD
17and get out of your way. It's programmable, intelligent, and has plenty of
18"cool" features, but they won't interfere with this goal.
19
20***
21
22Building dcd
23
24Simply typing `make' in the dcd source directory will usually work fine.
25If it doesn't, take a look at the Makefile with your favorite text editor.
26There are a few configurable things in there (like the location of your
27CD-ROM device, which defaults to /dev/cdrom).
28
29Oh yeah, you'll need a 2.x Linux kernel. It should work on all 2.0 and
30later kernels, but I haven't tested it extensively. (I tend to use the
31most recent kernels, so it should always work there...)
32
33If you're a Debian user, Lalo Martins tries to keep a current copy of dcd
34in the Debian package system. I don't know how it works, though, and if
35it's not current don't blame me.
36
37***
38
39Using dcd:
40dcd by itself starts the disk on track 1.
41dcd 6 starts the disk at track 6. Substitute your favorite number.
42dcd stop will stop the CD.
43dcd eject will eject the CD tray (if your hardware supports it).
44dcd info and dcd dir reports information on the entire disk.
45dcd loop will loop, continually playing the disc or the tracks specified.
46dcd (list of numbers) will do the same thing.
47dcd random will randomly play tracks from the CD, natch.
48There's a few other less-used options detailed in the man page (like help).
49
50All parameters can be shortened to their first letter; dcd i is just as
51good as dcd info. GNU fanatics can put a dash in front of options (getting
52dcd -i or dcd -info) too.
53
54Looping is a bit tricky, mostly because Linux's sleep() call depends
55somewhat on how heavily the system is loaded. The last few seconds of a
56track may be cut off, or the first few seconds of the next track may be
57played before the next selected track starts. If this is a serious
58problem, look at the Makefile; there's a switch there just for you.
59
60***
61
62UGLY LEGAL STUFF
63
64This program is (C) 1998-2001 David E. Smith, and covered by the GNU GPL.
65See the file `COPYING' for details.
66
67The CD Index algorithm is described at http://www.freeamp.org/cdindex/
68and in fact I browsed heavily through their reference implementation to
69do mine.
70
71base64.c is (C)1988 Leland Stanford Junior University, (C) 1998 University
72of Washington. See that file for more information.
73
74sha.c was contributed to the public domain by someone listed in that file.
75The headers in that file are so bloody confusing, I can't sort it out.
76
77***
78
79Think dcd sucks? Tell me about it at <dave@technopagan.org>.
80
README.LZO
1-----BEGIN PGP SIGNED MESSAGE-----
2
3
4 ============================================================================
5 miniLZO -- mini subset of the LZO real-time data compression library
6 ============================================================================
7
8 Author : Markus Franz Xaver Johannes Oberhumer
9 <markus.oberhumer@jk.uni-linz.ac.at>
10 http://wildsau.idv.uni-linz.ac.at/mfx/lzo.html
11 Version : 1.07
12 Date : 18-Oct-2000
13
14 I've created miniLZO for projects where it is inconvenient to
15 include (or require) the full LZO source code just because you
16 want to add a little bit of data compression to your application.
17
18 miniLZO implements the LZO1X-1 compressor and both the standard and
19 safe LZO1X decompressor. Apart from fast compression it also useful
20 for situations where you want to use pre-compressed data files (which
21 must have been compressed with LZO1X-999).
22
23 miniLZO consists of one C source file and two header files:
24 minilzo.c
25 minilzo.h
26 lzoconf.h
27
28 To use miniLZO just copy these files into your source directory, add
29 minilzo.c to your Makefile and #include minilzo.h from your program.
30 Note: you also must distribute this file (`README.LZO') with your project.
31
32 minilzo.o compiles to about 6 kB (using gcc or Watcom C on a i386), and
33 the sources are about 14 kB when packed with zip - so there's no more
34 excuse that your application doesn't support data compression :-)
35
36 For more information, documentation, example programs and other support
37 files (like Makefiles and build scripts) please download the full LZO
38 package from
39 http://wildsau.idv.uni-linz.ac.at/mfx/lzo.html
40
41 Have fun,
42 Markus
43
44
45 P.S. minilzo.c is generated automatically from the LZO sources and
46 therefore functionality is completely identical
47
48
49 Appendix A: building miniLZO
50 ----------------------------
51 miniLZO is written such a way that it should compile and run
52 out-of-the-box on most machines.
53
54 If you are running on a very unusual architecture and lzo_init() fails then
55 you should first recompile with `-DLZO_DEBUG' to see what causes the failure.
56 The most probable case is something like `sizeof(char *) != sizeof(long)'.
57 After identifying the problem you can compile by adding some defines
58 like `-DSIZEOF_CHAR_P=8' to your Makefile.
59
60 The best solution is (of course) using Autoconf - if your project uses
61 Autoconf anyway just add `-DMINILZO_HAVE_CONFIG_H' to your compiler
62 flags when compiling minilzo.c. See the LZO distribution for an example
63 how to set up configure.in.
64
65
66 Appendix B: list of public functions available in miniLZO
67 ---------------------------------------------------------
68 Library initialization
69 lzo_init()
70
71 Compression
72 lzo1x_1_compress()
73
74 Decompression
75 lzo1x_decompress()
76 lzo1x_decompress_safe()
77
78 Checksum functions
79 lzo_adler32()
80
81 Version functions
82 lzo_version()
83 lzo_version_string()
84 lzo_version_date()
85
86 Portable (but slow) string functions
87 lzo_memcmp()
88 lzo_memcpy()
89 lzo_memmove()
90 lzo_memset()
91
92
93 Appendix C: suggested macros for `configure.in' when using Autoconf
94 -------------------------------------------------------------------
95 Checks for typedefs and structures
96 AC_CHECK_TYPE(ptrdiff_t,long)
97 AC_TYPE_SIZE_T
98 AC_CHECK_SIZEOF(unsigned short)
99 AC_CHECK_SIZEOF(unsigned)
100 AC_CHECK_SIZEOF(unsigned long)
101 AC_CHECK_SIZEOF(char *)
102 AC_CHECK_SIZEOF(ptrdiff_t)
103 AC_CHECK_SIZEOF(size_t)
104
105 Checks for compiler characteristics
106 AC_C_CONST
107
108 Checks for library functions
109 AC_CHECK_FUNCS(memcmp memcpy memmove memset)
110
111
112 Appendix D: Copyright
113 ---------------------
114 LZO and miniLZO are Copyright (C) 1996-2000
115 Markus Franz Xaver Johannes Oberhumer
116
117 LZO and miniLZO are distributed under the terms of the GNU General
118 Public License (GPL). See the file COPYING.
119
120 Special licenses for commercial and other applications which
121 are not willing to accept the GNU General Public License
122 are available by contacting the author.
123
124
125
126
127-----BEGIN PGP SIGNATURE-----
128Version: 2.6.3ia
129Charset: noconv
130
131iQCVAwUBOez6EG10fyLu8beJAQFYJAQAx5RYO13VB8A25KGP2BFzvHWfX+QkGTmO
132LEUfTm2URZZ9DDyz7UbZsVWuK+ztOqD4H6BiwpXldJ1JWf02gI9seCZd7GA5LaGP
133VyLrU2Kuv7DVf74cVMRs+CSKDYV6AW0KsGDeBY7Uceh7r9nBSM8QJkcqCnZnFkm5
134JXP8ySD6u9U=
135=oXrB
136-----END PGP SIGNATURE-----
137