The Tor Browser / file comparison
comparison: security/nss/tests/pkcs11/netscape/trivial/README.txt
security/nss/tests/pkcs11/netscape/trivial/README.txt
- branch
- TOR_BUG_9701
- changeset 15
- b8a032363ba2
equal
deleted
inserted
replaced
| -1:000000000000 | 0:104b0cf7357f |
|---|---|
| 1 This is a very trivial program that loads and excercises a PKCS#11 | |
| 2 module, trying basic operations. I used it as a basic check that | |
| 3 my data-only modules for NSS worked, and I'm including it here as | |
| 4 a first sample test program. | |
| 5 | |
| 6 | |
| 7 This program uses GNU autoconf: run ./configure --help for info. | |
| 8 In addition to the standard options, the configure script accepts | |
| 9 the following: | |
| 10 | |
| 11 --with-nspr[=path] specify location of NSPR | |
| 12 --with-nss-dist[=path] specify path to NSS dist directory | |
| 13 --with-nss-hdrs[=path] or, specify path to installed NSS headers | |
| 14 --with-rsa-hdrs[=path] if not using NSS, specify path to RSA headers | |
| 15 --disable-debug default is enabled | |
| 16 | |
| 17 This program uses NSPR; you may specify the path to your NSPR | |
| 18 installation by using the "--with-nspr" option. The specified | |
| 19 directory should be the one containing "include" and "lib." | |
| 20 If this option is not given, the default is the usual prefix | |
| 21 directories; see ./configure --help for more info. | |
| 22 | |
| 23 This program requires either the pkcs11*.h files from RSA, or | |
| 24 the NSS equivalents. To specify their location, you must | |
| 25 specify one of --with-nss-dist, --with-nss-hdrs, or --with-rsa-hdrs. | |
| 26 | |
| 27 If you have an NSS build tree, specify --with-nss-dist and provide | |
| 28 the path to the mozilla/dist/*.OBJ directory. (If you got this | |
| 29 package by checking it out from mozilla, it should be about six | |
| 30 directories up, once you've built NSS.) | |
| 31 | |
| 32 Alternatively, if you have an NSS installation (including "private" | |
| 33 files, e.g. "ck.h") you may point directly to the directory containing | |
| 34 the headers with --with-nss-hdrs. | |
| 35 | |
| 36 If you would rather use the RSA-provided header files, or your own | |
| 37 versions of them, specify their location with --with-rsa-hdrs. | |
| 38 | |
| 39 The flag --disable-debug doesn't really do much here other than | |
| 40 exclude the CVS_ID info from the binary. | |
| 41 | |
| 42 | |
| 43 To run the program, specify the name of the .so (or your platform's | |
| 44 equivalent) containing the module to be tested, e.g.: | |
| 45 | |
| 46 ./trivial ../../../../../../dist/*.OBJ/lib/libnssckbi.so | |
| 47 | |
| 48 | |
| 49 If you're using NSS, and using our experimental "installer's | |
| 50 arguments" fields in CK_C_INITIALIZE_ARGS, you can specify an | |
| 51 "installer argument" with the -i flag: | |
| 52 | |
| 53 ./trivial -i ~/.netscape/certs.db [...]/libnssckdb.so | |
| 54 | |
| 55 | |
| 56 Share and enjoy. |
