summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/EVP_EncryptInit.3 (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Move the horrific EVP_aes_128_ccm(3) API out of the important,schwarze2024-12-201-50/+4
| | | | | | | | | | | | algorithm-independent EVP_EncryptInit(3) manual as another step in making the latter leaner and more palatable. As a side benefit, the new EVP_aes_128_ccm(3) manual page may provide a better fighting chance to programmers who see themselves forced to support CCM for whatever reason. It documents the mandatory, but so far undocumented EVP_CTRL_CCM_GET_TAG control command and makes the description of the three EVP_CTRL_CCM_SET_* control commands and the numerous related quirks more precise.
* New manual page EVP_aes_128_gcm(3).schwarze2024-12-171-54/+4
| | | | | | | | | | | | The main benefit is moving the cumbersome and error-prone method of using EVP_EncryptInit(3) for AES-GCM out of the important, but obese manual page EVP_EncryptInit(3), and to create a logical place for pointing readers to the safer and more flexible EVP_AEAD_CTX_init(3). As a side benefit, document three control commands that were so far undocumented and make the description of three others more precise. Feedback and OK tb@.
* Move the algorithm-specific functions EVP_rc2_*(3) out of EVP_EncryptInit(3)schwarze2024-12-081-51/+5
| | | | | | | | | and document them properly in their own manual page, including the control commands EVP_CTRL_SET_RC2_KEY_BITS and EVP_CTRL_GET_RC2_KEY_BITS that were so far undocumented. Arguably, the main benefit is another small step making the important, but still obese EVP_EncryptInit(3) manual page more palatable.
* Mention the key lengths of some encryption algorithms.schwarze2024-11-091-14/+27
| | | | | | | | This is relevant because EVP_EncryptInit(3) takes a "key" argument, and users need to consider the size of that argument. While here, also mention whether ciphers are stream ciphers or block ciphers and what the block size is.
* Unify description of the obsolete ENGINE parametertb2024-07-211-6/+6
| | | | | | | This uses the same language in most manuals mentioning the obsolete ENGINE parameters. Make it clear that it is always ignored and that NULL should be passed. Always call it engine instead of a mix of e pe, impl, eng.
* Rename some argument placeholders to be less cryptic,schwarze2023-12-261-49/+52
| | | | | | | | | | | | | | in particular s/inl/in_len/ and s/outl/out_len/ as suggested by tb@. While here, also get rid of the "outm" placeholder that has been around since the file was added to OpenSSL in 2000, replacing it with the usual "out" in the four function prototypes affected; tb@ and myself suspect it was simply a typo followed by copy and paste. Slightly improve variable naming in the examples, too, for clarity and consistency, even though that doesn't turn the examples into good examples. OK tb@
* Some cleanup:schwarze2023-12-011-71/+33
| | | | | | | | | | Remove some lies and some irrelevant historical information about the non_ex variants and waste fewer words deprecating them. Telling people to type longer function names and to pass an ignored NULL argument doesn't really help anything. Also talk less about those ignored ENGINE arguments. OK tb@
* EVP_EncryptInit(3) is among the most important "how to drive" manuals,schwarze2023-12-011-62/+10
| | | | | | | | but it is still excessively long and complicated. To reduce the amount of distractions a bit, split out three deprecated functions into a new manual page EVP_CIPHER_CTX_init(3). No text change. In part suggested by tb@, who agrees with the direction.
* Split three new manual pages EVP_CIPHER_nid(3), EVP_CIPHER_CTX_ctrl(3),schwarze2023-08-311-448/+15
| | | | | | | | | | | and EVP_CIPHER_CTX_set_flags(3) out of the excessively large and unwieldy EVP_EncryptInit(3). This causes a number of inaccuracies and gaps to stand out, but i'm not mixing text changes or content additions into this split. Using very useful feedback from tb@ regarding what belongs together and how important the various functions are. I refrained from bothering him with the complete patch, but he likes the general direction.
* write documentation for EVP_CIPHER_CTX_copy(3)schwarze2023-08-261-4/+86
| | | | and EVP_CIPHER_CTX_encrypting(3) from scratch
* add the missing entry for EVP_CIPHER_CTX_ctrl(3) to the RETURN VALUES sectionschwarze2023-08-161-2/+11
|
* Import the EVP_chacha20(3) manual page from the OpenSSL 1.1 branch,schwarze2023-08-151-11/+4
| | | | | | which is still under a free license, to work on it in the tree. The required content changes have not been done yet, i only tweaked the markup and wording so far.
* Remove most mentions of contexts on the stack.tb2022-08-311-9/+2
|
* man pages: add missing commas between subordinate and main clausesnaddy2022-03-311-6/+6
| | | | | | | jmc@ dislikes a comma before "then" in a conditional, so leave those untouched. ok jmc@
* Use unsigned char instead of u_char for two prototypes (like everywheretb2021-10-141-4/+4
| | | | else in libcrypto's manuals and headers).
* double word fix; from martin vahlensieckjmc2021-01-051-3/+3
|
* grammar fixes from Varik "The Genuine Article!!!" Valefor;jmc2020-12-031-3/+3
|
* tweak previous; ok tbjmc2020-01-261-3/+3
|
* Document the change in EVP_chacha20(3).tb2020-01-261-3/+5
| | | | Discussed with jsing
* The length of the IV of EVP_chacha20 is currently 64 bits, not 96.tb2020-01-221-3/+3
| | | | ok beck
* document but do not recommend EVP_Cipher(3);schwarze2019-08-151-3/+52
| | | | | jsing@ provided crucial help regarding the content; tweaks and OK tb@
* Tree structure for manual pages: crypto(3) links to 33 functionschwarze2019-06-061-2/+6
| | | | | | | | | | | group pages, and these link on to all their second-level subpages. Only a handful of second-level pages have third-level subpages. So all crypto pages can now be reached from the www.libressl.org frontpage via at most four clicks, in most cases three clicks. Also link back from leaf pages to their respective group pages and add a couple of additional links between related pages. Triggered by a question from deraadt@. OK jmc@ tb@
* import EVP_camellia_128_cbc(3) from OpenSSL 1.1.1,schwarze2019-03-211-1/+3
| | | | still under a free license, tweaked by me
* Split EVP_rc4(3) out of EVP_EncryptInit(3) to reduce clutter.schwarze2019-03-211-19/+3
| | | | | | The algorithm is insecure and yet its description would spread over three paragraphs in the cipher list, including remarkable advice like using a 40 bit key length.
* Split EVP_des_cbc(3) out of EVP_EncryptInit(3) to reduce clutter:schwarze2019-03-211-52/+4
| | | | | this moves a large number of functions out of the way that are no longer the latest and greatest. Also mention a few that were missing.
* add a handful of missing functionsschwarze2019-03-211-5/+38
| | | | that are also documented in OpenSSL 1.1.1 (still under a free license)
* Bring back EVP_chacha20 list item that was accidentally removedtb2019-03-211-2/+3
| | | | in r1.28 when the AES ciphers were split into their own manual.
* Document the flag EVP_CIPHER_CTX_FLAG_WRAP_ALLOW needed for the EVPschwarze2019-03-191-2/+44
| | | | | | | AES wrap modes, the function EVP_CIPHER_CTX_set_flags(3) needed to set it, and the companion functions EVP_CIPHER_CTX_clear_flags(3) and EVP_CIPHER_CTX_test_flags(3). With help and an OK from tb@.
* Split EVP_aes_128_cbc(3) out of EVP_EncryptInit(3):schwarze2019-03-181-72/+7
| | | | | | | | | | | | both resulting pages are still long. Mention a number of missing functions. Add some text from the OpenSSL 1.1.1 EVP_aes.pod manual page, which is still under a free license. Add missing HISTORY information. Triggered by tb@ providing EVP_aes_{128,192,256}_wrap(3) in evp.h rev. 1.74.
* Document SM4; related to evp.h rev. 1.73.schwarze2019-03-181-3/+7
|
* fix some cases of spaces before full stops, where none were neccessary;jmc2019-03-101-3/+3
|
* tweak previous;jmc2018-09-121-2/+2
|
* Add some accessor functions:djm2018-09-121-2/+33
| | | | | | RSA_meth_get_finish() RSA_meth_set1_name() EVP_CIPHER_CTX_(get|set)_iv() feedback and ok jsing@ tb@
* Remove extra "and" in "These functions and have been available"tb2018-08-281-3/+3
|
* typo: an nonce -> a noncetb2018-08-261-3/+3
|
* missing "const" in seven prototypes;schwarze2018-03-291-16/+16
| | | | | from Kurt Roeckx <kurt at roeckx dot be> via OpenSSL commit b38fa985 Mar 10 16:32:55 2018 +0100
* found a complete archive of SSLeay-0.4 to SSLeay-0.8.1b tarballsschwarze2018-03-271-21/+33
| | | | on the web, so fix up SSLeay HISTORY accordingly
* finish crypto HISTORY; mostly 1.1.0/6.3, but also various other fixesschwarze2018-03-231-2/+3
|
* crypto HISTORY up to 1.0.1; researched from OpenSSL gitschwarze2018-03-231-1/+14
|
* crypto HISTORY up to 0.9.8h; researched from OpenSSL gitschwarze2018-03-231-2/+7
|
* crypto HISTORY up to 0.9.8; researched from OpenSSL gitschwarze2018-03-231-2/+6
|
* crypto HISTORY up to 0.9.7; researched from OpenSSL gitschwarze2018-03-221-2/+3
|
* crypto HISTORY up to 0.9.6; researched from OpenSSL gitschwarze2018-03-221-2/+12
|
* crypto HISTORY up to 0.9.3; researched from OpenSSL gitschwarze2018-03-211-2/+5
|
* crypto HISTORY up to SSLeay 0.9.1; researched from OpenSSL gitschwarze2018-03-211-1/+5
|
* evp.h HISTORY up to SSLeay 0.9.0; researched from OpenSSL gitschwarze2018-03-211-4/+9
|
* evp.h HISTORY up to SSLeay 0.8.1b; researched from OpenSSL gitschwarze2018-03-201-3/+58
|
* Garbage collect RC5 documentation.schwarze2018-02-271-22/+3
| | | | | | We have no code implementing it, tedu@ took care of the rc5/ directory in 2014, the related files are commented out in arch/*/Makefile.inc, and opensslfeatures.h contains an explicit #define OPENSSL_NO_RC5.
* In evp.h rev. 1.57 2018/02/17 16:54:08,schwarze2018-02-191-70/+96
| | | | | | | | | | | | jsing@ provided EVP_CIPHER_CTX_reset(3). Merge the documentation, most from Richard Levitte via OpenSSL commit 05fdb8d3 Dec 18 17:09:45 2015 +0100. Also merge improvements to the EXAMPLES section from OpenSSL, fixing one additional bug that still remains in OpenSSL. While here, improve information on the deprecated functions, sort RETURN VALUES, and add a few missing functions to it, though that section still remains incomplete.
* Mention two more block cipher modes that actually exist in our tree;schwarze2018-02-141-8/+30
| | | | | | | | | | | | | from Patrick dot Steuer at de dot ibm dot com via OpenSSL commit 338ead0f Oct 9 12:16:34 2017 +0200. Correct the EVP_EncryptUpdate(3) and EVP_DecryptUpdate(3) prototypes; from FdaSilvaYY at gmail dot com via OpenSSL commit 7bbb0050 Nov 22 22:00:29 2017 +0100. Document the additional public function EVP_CIPHER_CTX_rand_key(3); from Patrick dot Steuer at de dot ibm dot com via OpenSSL commit 5c5eb286 Dec 5 00:36:43 2017 +0100.
generated by cgit v1.2.3-55-g6feb (git 2.39.1) at 2025-04-28 07:32:27 +0000