mirror
/
transmission
mirror of https://github.com/transmission/transmission
1
0
Fork 0
Code Issues Releases Wiki Activity
transmission/libtransmission/crypto.h

85 lines
2.0 KiB
C
Raw Normal View History

merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
/*
Licensing changes: 1. add the option the code to be used under GPLv2 or GPLv3; previously only GPLv2 was allowed 2. add the "proxy option" as described in GPLv3 so we can add future licenses without having to bulk-edit everything again :) 3. remove the awkward "exception for MIT code in Mac client" clause; it was unnecessary and confusing.
2014-01-19 01:09:44 +00:00
* This file Copyright (C) 2007-2014 Mnemosyne LLC
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
*
Copyedit the license's revised text: (1) remove unnecessary repitition use of the word 'license' from the top of the header and source files (2) add the standard 'we hope it's useful, but no warranty' clause to COPYING (3) make explicit that linking OpenSSL is allowed (see https://people.gnome.org/~markmc/openssl-and-the-gpl.html for background) (4) sync the Qt and GTK+ clients' license popups with COPYING's revised text
2014-01-21 03:10:30 +00:00
* It may be used under the GNU GPL versions 2 or 3
Licensing changes: 1. add the option the code to be used under GPLv2 or GPLv3; previously only GPLv2 was allowed 2. add the "proxy option" as described in GPLv3 so we can add future licenses without having to bulk-edit everything again :) 3. remove the awkward "exception for MIT code in Mac client" clause; it was unnecessary and confusing.
2014-01-19 01:09:44 +00:00
* or any future license endorsed by Mnemosyne LLC.
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
*
*/
refactor: use GTest for running tests (#1383) * refactor: use google-test on libtransmission tests
2020-08-11 18:11:55 +00:00
// NB: crypto-test-ref.h needs this, so use it instead of #pragma once
Ensure include guard is the first non-comment line
2017-11-14 20:21:28 +00:00
#ifndef TR_ENCRYPTION_H
#define TR_ENCRYPTION_H
(libT) add #ifdefs to ensure that client apps don't #include private libtransmission headers.
2008-11-24 20:17:36 +00:00
#ifndef __TRANSMISSION__
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
#error only libtransmission should #include this header.
(libT) add #ifdefs to ensure that client apps don't #include private libtransmission headers.
2008-11-24 20:17:36 +00:00
#endif
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
#include <inttypes.h>
#4400, #5462: Move RC4 helpers to crypto-utils On a way to factoring out OpenSSL support to a standalone file to ease addition of other crypto libraries support in the future, move helpers providing RC4 ciphering to crypto-utils.{c,h}. OpenSSL-related functionality (RC4 context management) is moved to crypto-utils-openssl.c. Add new tr_rc4_ctx_t type and functions to be implemented by crypto backends: * tr_rc4_new - allocate RC4 context, * tr_rc4_free - free the context, * tr_rc4_set_key - set cipher key, * tr_rc4_process - cipher memory block.
2014-12-04 12:37:08 +00:00
#include "crypto-utils.h"
refactor: use GTest for running tests (#1383) * refactor: use google-test on libtransmission tests
2020-08-11 18:11:55 +00:00
#include "tr-macros.h"
fix mac build?
2008-10-22 17:19:22 +00:00
#include "utils.h" /* TR_GNUC_NULL_TERMINATED */
(libT) add some extra gcc safeguards. fix a couple of compiler warnings in makemeta
2008-10-22 17:14:50 +00:00
refactor: use GTest for running tests (#1383) * refactor: use google-test on libtransmission tests
2020-08-11 18:11:55 +00:00
TR_BEGIN_DECLS
(trunk libT) re-start work on making libT doxygen friendly. still a long ways to go on this.
2009-05-29 19:17:12 +00:00
/**
(trunk) No code changes here... filling in some of the blanks in the "peers" and "utils" doxygen groups' documentation.
2010-01-19 19:37:00 +00:00
*** @addtogroup peers
*** @{
**/
(trunk libT) re-start work on making libT doxygen friendly. still a long ways to go on this.
2009-05-29 19:17:12 +00:00
(trunk libT) more heap pruning: use composition rather than aggregation for the tr_crypto object owned by tr_peerIo.
2011-04-17 05:22:50 +00:00
enum
{
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
KEY_LEN = 96
(trunk libT) more heap pruning: use composition rather than aggregation for the tr_crypto object owned by tr_peerIo.
2011-04-17 05:22:50 +00:00
};
/** @brief Holds state information for encrypted peer communications */
typedef struct
{
Switch to a standalone ARC4 implementation (#1788) * Switch to a standalone ARC4 implementation This frees us from expecting it being provided by one of the crypto libraries we support, all of which deprecated and/or removed it at this point. Fixes: #1103 Fixes: #1777 * Suppress lgtm warnings about RC4 being weak (we don't care)
2021-09-12 03:47:29 +00:00
struct arc4_context* dec_key;
struct arc4_context* enc_key;
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
tr_dh_ctx_t dh;
uint8_t myPublicKey[KEY_LEN];
tr_dh_secret_t mySecret;
uint8_t torrentHash[SHA_DIGEST_LENGTH];
bool isIncoming;
bool torrentHashIsSet;
Switch to clang-format for code formatting, include Mac client
2021-08-15 09:41:48 +00:00
} tr_crypto;
(trunk libT) more heap pruning: use composition rather than aggregation for the tr_crypto object owned by tr_peerIo.
2011-04-17 05:22:50 +00:00
/** @brief construct a new tr_crypto object */
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
void tr_cryptoConstruct(tr_crypto* crypto, uint8_t const* torrentHash, bool isIncoming);
(trunk libT) more heap pruning: use composition rather than aggregation for the tr_crypto object owned by tr_peerIo.
2011-04-17 05:22:50 +00:00
/** @brief destruct an existing tr_crypto object */
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
void tr_cryptoDestruct(tr_crypto* crypto);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
void tr_cryptoSetTorrentHash(tr_crypto* crypto, uint8_t const* torrentHash);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
uint8_t const* tr_cryptoGetTorrentHash(tr_crypto const* crypto);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
bool tr_cryptoHasTorrentHash(tr_crypto const* crypto);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
bool tr_cryptoComputeSecret(tr_crypto* crypto, uint8_t const* peerPublicKey);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
uint8_t const* tr_cryptoGetMyPublicKey(tr_crypto const* crypto, int* setme_len);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
void tr_cryptoDecryptInit(tr_crypto* crypto);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
void tr_cryptoDecrypt(tr_crypto* crypto, size_t buflen, void const* buf_in, void* buf_out);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes.
2017-04-19 12:04:45 +00:00
void tr_cryptoEncryptInit(tr_crypto* crypto);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Align type qualifiers to the right (code style) This way all the qualifiers (`const`, `volatile`, `mutable`) are grouped together, e.g. `T const* const x` vs. `const T* const x`. Also helps reading types right-to-left, e.g. "constant pointer to constant T" vs. "constant pointer to T which is constant".
2017-04-20 16:02:19 +00:00
void tr_cryptoEncrypt(tr_crypto* crypto, size_t buflen, void const* buf_in, void* buf_out);
merge encryption branch to trunk (xcode project is still out of date)
2007-09-20 16:32:01 +00:00
Switch to clang-format for code formatting, include Mac client
2021-08-15 09:41:48 +00:00
bool tr_cryptoSecretKeySha1(
tr_crypto const* crypto,
void const* prepend_data,
size_t prepend_data_size,
void const* append_data,
size_t append_data_size,
uint8_t* hash);
#4400, #5462: Move DH helpers to crypto-utils On a way to factoring out OpenSSL support to a standalone file to ease addition of other crypto libraries support in the future, move helpers providing DH key exchange to crypto-utils.{c,h}. OpenSSL-related functionality (DH context management) is moved to crypto-utils-openssl.c. Since we know in advance that DH secret key management code will be the same for most of backends, implement common functionality in separate crypto-utils-fallback.c. Add new tr_dh_ctx_t and tr_dh_secret_t types and functions to be implemented by crypto backends: * tr_dh_new - allocate DH context, * tr_dh_free - free the context, * tr_dh_make_key - generate private/public keypair, * tr_dh_agree - perform DH key exchange and generate secret key, * tr_dh_secret_derive - calculate secret key hash, * tr_dh_secret_free - free the secret key, * tr_dh_align_key - align some DH key in the buffer allocated for it. Make DH secret key not accessible in plain form outside the crypto backend. This allows for implementations where the key is managed by the underlying library and is not even exposed to our backend.
2014-12-04 19:18:08 +00:00
(trunk) No code changes here... filling in some of the blanks in the "peers" and "utils" doxygen groups' documentation.
2010-01-19 19:37:00 +00:00
/* @} */
refactor: use GTest for running tests (#1383) * refactor: use google-test on libtransmission tests
2020-08-11 18:11:55 +00:00
TR_END_DECLS
#endif // TR_ENCRYPTION_H