~ubuntu-branches/ubuntu/maverick/curl/maverick

« back to all changes in this revision

Viewing changes to lib/README.NSS

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2009-12-11 19:33:21 UTC
  • mfrom: (3.4.2 squeeze) (40.1.2 curl)
  • Revision ID: james.westby@ubuntu.com-20091211193321-tenukopudyznzbjj
* Merge with Debian testing.  Remaining changes:
  - Keep build deps in main:
    - Drop build dependencies: stunnel, libdb4.6-dev, libssh2-1-dev
    - Add build-dependency on openssh-server
    - Drop libssh2-1-dev from libcurl4-openssl-dev's Depends.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
                               libcurl with NSS
2
 
                               ================
3
 
 
4
 
Author: Daniel Stenberg
5
 
Date:   June 24, 2008
6
 
 
7
 
NSS home => http://www.mozilla.org/projects/security/pki/nss/
8
 
 
9
 
libcurl can be built to use the NSS libraries for SSL/TLS. Invoke configure
10
 
--without-ssl --with-nss.
11
 
 
12
 
The source code in lib/nss.c currently cause a compiler warning due to the
13
 
lack of a prototype. The prototype is provided by the public header provided
14
 
by NSS called "base64.h". But since we use a private header in libcurl named
15
 
identically, we cannot include the NSS one.
16
 
 
17
 
This problem persists because:
18
 
 
19
 
* NSS doesn't use a properly established separate subdir for their include
20
 
  files. Instead different distros have put them in /usr/include/nss and
21
 
  /usr/include/nss3 etc.
22
 
 
23
 
* The pkg-config output for NSS provides a full -I path to the nss include dir,
24
 
  so we cannot #include <nss/base64.h> or <nss3/base64.h>. This too may be due
25
 
  to how distros do it.
26
 
 
27
 
* I tried getting the (all new in June 2008) NSS 3.12 tarball to check how it
28
 
  behaves out-of-box but this wouldn't even build - complaining on missing
29
 
  files that aren't included in the tarball. The tarball doesn't even include
30
 
  build instuctions but you must hunt them down on their web site.
31
 
 
32
 
Due to these design problems we may of course get further similar problems in
33
 
the future, but I hope we can work them out somehow along the way.