README
1This is libdomainkeys. It's Copyright (c) 2004 Yahoo, Inc.
2This code incorporates intellectual property owned by
3Yahoo! and licensed pursuant to the Yahoo! DomainKeys Public License
4Agreement: http://domainkeys.sourceforge.net/license/softwarelicense1-1.html
5
6INSTALLATION
7
8 C lib build
9'make' will create libdomainkeys.a and domainkeys.h.
10
11Or else it won't.
12
13Python module build
14'make python' will build the python wrapper and shared object (_domainkeys.so)
15
16Common problems with the build:
17
18If it can't find the openssl include files, you
19might need to add a -I pointing to them to INCS variable in the Makefile.
20In addition, you may have to add an -L to the the LIBS variable to point to the
21path for the crypto lib.
22
23Problems in "dns_text" with undefined refrences. Odds are the makefile failed
24to correctly setup the dns.lib file so the easy fix is to do this:
25 echo "-lresolv" > dns.lib; make
26that should build the dktest binary.
27
28Unixware users may need to add -DUNIXWARE to the CFLAGS variable in the make file to
29make a compatable header file for cc (not gcc) on that platform.
30
31WIN32
32
33Visual Studio 2003 Project files are included and configured to create
34lib or dll in debug or release mode. OpenSSL is required and your environment
35must be configured to find the openssl include files and pre-compiled library
36from where they are. In Visual Studio, see Tools/Options/Projects/VC++
37Directories.
38
39USAGE
40
41See dktest.html and dknewkey.html.
42
43TESTING
44
45The program named 'test' will execute a number of test cases.
46
47./test
48
49It should only print the test case numbers. If it prints anything
50else, then that test failed.
51
52ERRATA
53
54None known.
55
56DOCUMENTATION
57
58Read domainkeys.h. If you need more information than it has,
59then I need to write more.
60
61
62Russell Nelson
63Crynwr Software
64nelson@crynwr.com
65315-323-1241
66FWD# 404529
67