~ubuntu-branches/ubuntu/vivid/curl/vivid

« back to all changes in this revision

Viewing changes to lib/README.NSS

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Schuldei
  • Date: 2009-04-02 23:35:45 UTC
  • mto: (1.2.1 upstream) (3.2.3 sid)
  • mto: This revision was merged to the branch mainline in revision 38.
  • Revision ID: james.westby@ubuntu.com-20090402233545-geixkwhe3izccjt7
Tags: upstream-7.19.4
ImportĀ upstreamĀ versionĀ 7.19.4

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.