diff options
author | David Walter Seikel | 2011-06-27 15:59:06 +1000 |
---|---|---|
committer | David Walter Seikel | 2011-06-27 15:59:06 +1000 |
commit | 92bd9b2503e7dd927f416cb9b17f169ea925fa56 (patch) | |
tree | f0f3776cfc0c6e6224db66f5678387c580095f16 /linden/indra/libgcrypt/libgcrypt-1.2.2/README.apichanges | |
parent | Make use of the new packaging stuff from upstream. (diff) | |
download | meta-impy-92bd9b2503e7dd927f416cb9b17f169ea925fa56.zip meta-impy-92bd9b2503e7dd927f416cb9b17f169ea925fa56.tar.gz meta-impy-92bd9b2503e7dd927f416cb9b17f169ea925fa56.tar.bz2 meta-impy-92bd9b2503e7dd927f416cb9b17f169ea925fa56.tar.xz |
Clean up line endings, execute bits, and other bits of errant nonsense from Windows.
Diffstat (limited to 'linden/indra/libgcrypt/libgcrypt-1.2.2/README.apichanges')
-rw-r--r--[-rwxr-xr-x] | linden/indra/libgcrypt/libgcrypt-1.2.2/README.apichanges | 226 |
1 files changed, 113 insertions, 113 deletions
diff --git a/linden/indra/libgcrypt/libgcrypt-1.2.2/README.apichanges b/linden/indra/libgcrypt/libgcrypt-1.2.2/README.apichanges index c95050f..d6510f6 100755..100644 --- a/linden/indra/libgcrypt/libgcrypt-1.2.2/README.apichanges +++ b/linden/indra/libgcrypt/libgcrypt-1.2.2/README.apichanges | |||
@@ -1,113 +1,113 @@ | |||
1 | README.apichanges 2003-07-28 | 1 | README.apichanges 2003-07-28 |
2 | 2 | ||
3 | 3 | ||
4 | We decided to change a couple of annoying things in Libgcrypt and to | 4 | We decided to change a couple of annoying things in Libgcrypt and to |
5 | cleanup the API. The new API better fits into a multi-threaded | 5 | cleanup the API. The new API better fits into a multi-threaded |
6 | environment and is more consistent. One import change is that all | 6 | environment and is more consistent. One import change is that all |
7 | functions return error codes from a set of error codes shared between | 7 | functions return error codes from a set of error codes shared between |
8 | GnuPG, GPGME and Libgcrypt. | 8 | GnuPG, GPGME and Libgcrypt. |
9 | 9 | ||
10 | This file contains some hints on how to port your application from | 10 | This file contains some hints on how to port your application from |
11 | libgcrypt <= 1.1.12 to the current API as of 1.1.42. We hope that | 11 | libgcrypt <= 1.1.12 to the current API as of 1.1.42. We hope that |
12 | there won't be another need for such a major change. | 12 | there won't be another need for such a major change. |
13 | 13 | ||
14 | 14 | ||
15 | * Types | 15 | * Types |
16 | 16 | ||
17 | All types definitions changed to a foo_t scheme; for some time we | 17 | All types definitions changed to a foo_t scheme; for some time we |
18 | will support the old names but you better start to rename them: | 18 | will support the old names but you better start to rename them: |
19 | 19 | ||
20 | s/GCRY_MPI/gcry_mpi_t/ | 20 | s/GCRY_MPI/gcry_mpi_t/ |
21 | s/GcryMPI/gcry_mpi_t/ | 21 | s/GcryMPI/gcry_mpi_t/ |
22 | s/GCRY_SEXP/gcry_sexp_t/ | 22 | s/GCRY_SEXP/gcry_sexp_t/ |
23 | s/GcrySexp/gcry_sexp_t/ | 23 | s/GcrySexp/gcry_sexp_t/ |
24 | s/GCRY_CIPHER_HD/gcry_cipher_hd_t/ | 24 | s/GCRY_CIPHER_HD/gcry_cipher_hd_t/ |
25 | s/GcryCipherHd/gcry_cipher_hd_t/ | 25 | s/GcryCipherHd/gcry_cipher_hd_t/ |
26 | s/GCRY_MD_HD/gcry_md_hd_t/ | 26 | s/GCRY_MD_HD/gcry_md_hd_t/ |
27 | s/GcryMDHd/gcry_md_hd_t/ | 27 | s/GcryMDHd/gcry_md_hd_t/ |
28 | 28 | ||
29 | * Initialization | 29 | * Initialization |
30 | 30 | ||
31 | For proper initialization of the library, you must call | 31 | For proper initialization of the library, you must call |
32 | gcry_check_version() before calling any other function except for | 32 | gcry_check_version() before calling any other function except for |
33 | these gcry_control operations: | 33 | these gcry_control operations: |
34 | GCRYCTL_SUSPEND_SECMEM_WARN | 34 | GCRYCTL_SUSPEND_SECMEM_WARN |
35 | GCRYCTL_DISABLE_INTERNAL_LOCKING | 35 | GCRYCTL_DISABLE_INTERNAL_LOCKING |
36 | GCRYCTL_ANY_INITIALIZATION_P | 36 | GCRYCTL_ANY_INITIALIZATION_P |
37 | GCRYCTL_INITIALIZATION_FINISHED_P | 37 | GCRYCTL_INITIALIZATION_FINISHED_P |
38 | 38 | ||
39 | 39 | ||
40 | * Handles | 40 | * Handles |
41 | 41 | ||
42 | gcry_cipher_open and gcry_md_open do now return an error code | 42 | gcry_cipher_open and gcry_md_open do now return an error code |
43 | instead of a NULL handle; the handle is now returned by | 43 | instead of a NULL handle; the handle is now returned by |
44 | asigning it to the first argument. Example on how to change your | 44 | asigning it to the first argument. Example on how to change your |
45 | code: | 45 | code: |
46 | 46 | ||
47 | Old: | 47 | Old: |
48 | 48 | ||
49 | hd = gcry_md_open (algo, flags); | 49 | hd = gcry_md_open (algo, flags); |
50 | if (!hd) | 50 | if (!hd) |
51 | { | 51 | { |
52 | fprintf (stderr, "md_open failed: %s\n", gcry_errno (-1)); | 52 | fprintf (stderr, "md_open failed: %s\n", gcry_errno (-1)); |
53 | .... | 53 | .... |
54 | 54 | ||
55 | New: | 55 | New: |
56 | 56 | ||
57 | rc = gcry_md_open (&hd, algo, flags); | 57 | rc = gcry_md_open (&hd, algo, flags); |
58 | if (rc) | 58 | if (rc) |
59 | { | 59 | { |
60 | fprintf (stderr, "md_open failed: %s\n", gcry_strerror (rc)); | 60 | fprintf (stderr, "md_open failed: %s\n", gcry_strerror (rc)); |
61 | .... | 61 | .... |
62 | 62 | ||
63 | If you are not interested in the error code, you can do it in a | 63 | If you are not interested in the error code, you can do it in a |
64 | simplified way: | 64 | simplified way: |
65 | 65 | ||
66 | gcry_md_open (&hd, algo, flags); | 66 | gcry_md_open (&hd, algo, flags); |
67 | if (!hd) | 67 | if (!hd) |
68 | abort (); | 68 | abort (); |
69 | 69 | ||
70 | i.e. the function makes sure that HD points to NULL in case of an error. | 70 | i.e. the function makes sure that HD points to NULL in case of an error. |
71 | The required change for gcry_cipher_open is similar. | 71 | The required change for gcry_cipher_open is similar. |
72 | 72 | ||
73 | * Message Digests | 73 | * Message Digests |
74 | 74 | ||
75 | The order of the arguments to gcry_md_copy has been changed in order | 75 | The order of the arguments to gcry_md_copy has been changed in order |
76 | to be more consistent with other functions of this type. This means | 76 | to be more consistent with other functions of this type. This means |
77 | that the new message digest handle will be a copy of the message | 77 | that the new message digest handle will be a copy of the message |
78 | handle specified by the second argument and stored at the address | 78 | handle specified by the second argument and stored at the address |
79 | pointed to by the first argument. | 79 | pointed to by the first argument. |
80 | 80 | ||
81 | * Error codes | 81 | * Error codes |
82 | 82 | ||
83 | gcry_errno () has been removed because it is hard to use in | 83 | gcry_errno () has been removed because it is hard to use in |
84 | multi-threaded environment. You need to save the error code | 84 | multi-threaded environment. You need to save the error code |
85 | returned by the functions and use it either numerical or passing it | 85 | returned by the functions and use it either numerical or passing it |
86 | to gcry_strerror (since gcry_strerror is a wrapper function for | 86 | to gcry_strerror (since gcry_strerror is a wrapper function for |
87 | gpg_strerror, the latter function can also be used). | 87 | gpg_strerror, the latter function can also be used). |
88 | 88 | ||
89 | Instead of using the error codes GCRYERR_*, you have to use the | 89 | Instead of using the error codes GCRYERR_*, you have to use the |
90 | GPG_ERR_* names. | 90 | GPG_ERR_* names. |
91 | 91 | ||
92 | * S-expressions | 92 | * S-expressions |
93 | 93 | ||
94 | gcry_sexp_canon_len used to return a `historical' error code in | 94 | gcry_sexp_canon_len used to return a `historical' error code in |
95 | `errcode', this is not the case anymore; the value returned in | 95 | `errcode', this is not the case anymore; the value returned in |
96 | `errcode' is now a standard Libgcrypt (i.e. gpg-error) error code. | 96 | `errcode' is now a standard Libgcrypt (i.e. gpg-error) error code. |
97 | 97 | ||
98 | * MPI | 98 | * MPI |
99 | 99 | ||
100 | gcry_mpi_scan and gcry_mpi_print need the size of a provided buffer | 100 | gcry_mpi_scan and gcry_mpi_print need the size of a provided buffer |
101 | as input and return the number of bytes actually scanned/printed to | 101 | as input and return the number of bytes actually scanned/printed to |
102 | the user. The old API used a single size_t Pointer for both tasks, | 102 | the user. The old API used a single size_t Pointer for both tasks, |
103 | the new API distinguishes between the input and the output values. | 103 | the new API distinguishes between the input and the output values. |
104 | 104 | ||
105 | * Public Key cryptography | 105 | * Public Key cryptography |
106 | 106 | ||
107 | gcry_pk_decrypt used to return a `simple S-expression part' that | 107 | gcry_pk_decrypt used to return a `simple S-expression part' that |
108 | contains a single MPI value. In case the `data' S-expression | 108 | contains a single MPI value. In case the `data' S-expression |
109 | contains a `flags' element, the result S-expression is filled with a | 109 | contains a `flags' element, the result S-expression is filled with a |
110 | complete S-expression of the following format: | 110 | complete S-expression of the following format: |
111 | 111 | ||
112 | (value PLAINTEXT) | 112 | (value PLAINTEXT) |
113 | 113 | ||