From 4485f045ca1acf6b357a13a36d701791a9333edd Mon Sep 17 00:00:00 2001 From: ecpvint Date: Thu, 15 Aug 2024 18:40:30 +0800 Subject: [PATCH] init --- .gitignore | 23 + Android.mk | 26 + Application.mk | 4 + OpenSSL_LICENSE | 125 + OpenSSL_README | 93 + RakNet_LICENSE | 25 + RakNet_README | 271 + include/array/GrowableArray.hpp | 74 + include/array/GrowableBooleanArray.hpp | 51 + include/array/GrowableByteArray.hpp | 51 + include/array/GrowableDoubleArray.hpp | 51 + include/array/GrowableFloatArray.hpp | 51 + include/array/GrowableIntegerArray.hpp | 51 + include/array/GrowableLongArray.hpp | 52 + include/array/GrowableObjectArray.hpp | 55 + include/array/GrowableShortArray.hpp | 51 + include/colorspace/SampleUtils.hpp | 24 + include/drfstream/drfstream.hpp | 12 + include/encoding/CharTableGBK.hpp | 14 + include/encoding/CharTableUTF8.hpp | 14 + include/encoding/EncodingUtils.hpp | 26 + include/memory/Memory.hpp | 20 + include/openssl/__DECC_INCLUDE_EPILOGUE.H | 16 + include/openssl/__DECC_INCLUDE_PROLOGUE.H | 20 + include/openssl/aes.h | 92 + include/openssl/asn1.h | 886 +++ include/openssl/asn1_mac.h | 10 + include/openssl/asn1err.h | 252 + include/openssl/asn1t.h | 945 +++ include/openssl/async.h | 76 + include/openssl/asyncerr.h | 38 + include/openssl/bio.h | 804 ++ include/openssl/bioerr.h | 120 + include/openssl/blowfish.h | 61 + include/openssl/bn.h | 539 ++ include/openssl/bnerr.h | 96 + include/openssl/buffer.h | 58 + include/openssl/buffererr.h | 30 + include/openssl/camellia.h | 83 + include/openssl/cast.h | 53 + include/openssl/cmac.h | 41 + include/openssl/cms.h | 342 + include/openssl/cmserr.h | 196 + include/openssl/comp.h | 53 + include/openssl/comperr.h | 40 + include/openssl/conf.h | 168 + include/openssl/conf_api.h | 40 + include/openssl/conferr.h | 72 + include/openssl/crypto.h | 445 ++ include/openssl/crypto/arm_arch.h | 84 + include/openssl/crypto/buildinf.h | 47 + .../crypto/internal/__DECC_INCLUDE_EPILOGUE.H | 16 + .../crypto/internal/__DECC_INCLUDE_PROLOGUE.H | 20 + include/openssl/crypto/internal/aria.h | 50 + include/openssl/crypto/internal/asn1_int.h | 115 + include/openssl/crypto/internal/async.h | 15 + include/openssl/crypto/internal/bn_conf.h | 28 + include/openssl/crypto/internal/bn_dh.h | 26 + include/openssl/crypto/internal/bn_int.h | 83 + include/openssl/crypto/internal/bn_srp.h | 34 + include/openssl/crypto/internal/chacha.h | 42 + .../openssl/crypto/internal/cryptlib_int.h | 35 + include/openssl/crypto/internal/ctype.h | 80 + include/openssl/crypto/internal/dso_conf.h | 18 + include/openssl/crypto/internal/ec_int.h | 45 + include/openssl/crypto/internal/engine.h | 20 + include/openssl/crypto/internal/err_int.h | 19 + include/openssl/crypto/internal/evp_int.h | 442 ++ include/openssl/crypto/internal/lhash.h | 15 + include/openssl/crypto/internal/md32_common.h | 259 + include/openssl/crypto/internal/objects.h | 12 + include/openssl/crypto/internal/poly1305.h | 21 + include/openssl/crypto/internal/rand_int.h | 131 + include/openssl/crypto/internal/sha.h | 21 + include/openssl/crypto/internal/siphash.h | 25 + include/openssl/crypto/internal/sm2.h | 78 + include/openssl/crypto/internal/sm2err.h | 61 + include/openssl/crypto/internal/sm3.h | 39 + include/openssl/crypto/internal/sm4.h | 37 + include/openssl/crypto/internal/store.h | 10 + include/openssl/crypto/internal/store_int.h | 26 + include/openssl/crypto/internal/x509_int.h | 287 + include/openssl/crypto/mips_arch.h | 40 + include/openssl/crypto/ppc_arch.h | 26 + include/openssl/crypto/s390x_arch.h | 103 + include/openssl/crypto/sparc_arch.h | 118 + include/openssl/crypto/vms_rms.h | 58 + include/openssl/cryptoerr.h | 53 + include/openssl/ct.h | 476 ++ include/openssl/cterr.h | 76 + include/openssl/des.h | 174 + include/openssl/dh.h | 340 + include/openssl/dherr.h | 84 + include/openssl/dsa.h | 238 + include/openssl/dsaerr.h | 67 + include/openssl/dtls1.h | 55 + include/openssl/e_os2.h | 293 + include/openssl/ebcdic.h | 33 + include/openssl/ec.h | 1467 ++++ include/openssl/ecdh.h | 10 + include/openssl/ecdsa.h | 10 + include/openssl/ecerr.h | 267 + include/openssl/engine.h | 751 ++ include/openssl/engineerr.h | 107 + include/openssl/err.h | 273 + include/openssl/evp.h | 1638 +++++ include/openssl/evperr.h | 193 + include/openssl/hmac.h | 51 + include/openssl/idea.h | 64 + .../internal/__DECC_INCLUDE_EPILOGUE.H | 16 + .../internal/__DECC_INCLUDE_PROLOGUE.H | 20 + include/openssl/internal/bio.h | 33 + include/openssl/internal/comp.h | 12 + include/openssl/internal/conf.h | 23 + include/openssl/internal/constant_time_locl.h | 327 + include/openssl/internal/cryptlib.h | 94 + include/openssl/internal/dane.h | 103 + include/openssl/internal/dso.h | 165 + include/openssl/internal/dsoerr.h | 83 + include/openssl/internal/err.h | 15 + include/openssl/internal/nelem.h | 14 + include/openssl/internal/numbers.h | 68 + include/openssl/internal/o_dir.h | 52 + include/openssl/internal/o_str.h | 17 + include/openssl/internal/refcount.h | 140 + include/openssl/internal/sockets.h | 159 + include/openssl/internal/sslconf.h | 20 + include/openssl/internal/thread_once.h | 45 + include/openssl/internal/tsan_assist.h | 138 + include/openssl/kdf.h | 97 + include/openssl/kdferr.h | 51 + include/openssl/lhash.h | 217 + include/openssl/md2.h | 44 + include/openssl/md4.h | 51 + include/openssl/md5.h | 50 + include/openssl/mdc2.h | 42 + include/openssl/modes.h | 208 + include/openssl/obj_mac.h | 5198 +++++++++++++ include/openssl/objects.h | 175 + include/openssl/objectserr.h | 38 + include/openssl/ocsp.h | 355 + include/openssl/ocsperr.h | 74 + include/openssl/opensslconf.h | 198 + include/openssl/opensslv.h | 101 + include/openssl/ossl_typ.h | 196 + include/openssl/pem.h | 378 + include/openssl/pem2.h | 13 + include/openssl/pemerr.h | 99 + include/openssl/pkcs12.h | 223 + include/openssl/pkcs12err.h | 77 + include/openssl/pkcs7.h | 319 + include/openssl/pkcs7err.h | 99 + include/openssl/rand.h | 77 + include/openssl/rand_drbg.h | 120 + include/openssl/randerr.h | 88 + include/openssl/rc2.h | 51 + include/openssl/rc4.h | 36 + include/openssl/rc5.h | 63 + include/openssl/ripemd.h | 47 + include/openssl/rsa.h | 512 ++ include/openssl/rsaerr.h | 162 + include/openssl/safestack.h | 172 + include/openssl/seed.h | 96 + include/openssl/sha.h | 119 + include/openssl/srp.h | 135 + include/openssl/srtp.h | 50 + include/openssl/ssl.h | 2413 ++++++ include/openssl/ssl2.h | 24 + include/openssl/ssl3.h | 339 + include/openssl/sslerr.h | 767 ++ include/openssl/stack.h | 83 + include/openssl/store.h | 266 + include/openssl/storeerr.h | 87 + include/openssl/symhacks.h | 52 + include/openssl/tls1.h | 1236 ++++ include/openssl/ts.h | 559 ++ include/openssl/tserr.h | 128 + include/openssl/txt_db.h | 57 + include/openssl/ui.h | 368 + include/openssl/uierr.h | 61 + include/openssl/whrlpool.h | 48 + include/openssl/x509.h | 1047 +++ include/openssl/x509_vfy.h | 624 ++ include/openssl/x509err.h | 125 + include/openssl/x509v3.h | 935 +++ include/openssl/x509v3err.h | 158 + include/png/IDATDecoder.hpp | 19 + include/png/PNGChunk.hpp | 48 + include/png/PNGChunkIDAT.hpp | 14 + include/png/PNGChunkIHDR.hpp | 61 + include/png/PNGChunkITXT.hpp | 39 + include/png/PNGChunkPHYS.hpp | 28 + include/png/PNGChunkPLTE.hpp | 13 + include/png/PNGChunkTEXT.hpp | 25 + include/png/PNGChunkTIME.hpp | 40 + include/png/PNGChunkTRNS.hpp | 13 + include/png/PNGChunkZTXT.hpp | 25 + include/png/UnfilterAverage.hpp | 18 + include/png/UnfilterNone.hpp | 12 + include/png/UnfilterPaeth.hpp | 18 + include/png/UnfilterSub.hpp | 18 + include/png/UnfilterUp.hpp | 12 + include/raknet/AutopatcherPatchContext.hpp | 28 + .../raknet/AutopatcherRepositoryInterface.hpp | 77 + include/raknet/Base64Encoder.hpp | 26 + include/raknet/BitStream.hpp | 2048 ++++++ include/raknet/CCRakNetSlidingWindow.hpp | 220 + include/raknet/CCRakNetUDT.hpp | 404 + include/raknet/CheckSum.hpp | 63 + include/raknet/CloudClient.hpp | 171 + include/raknet/CloudCommon.hpp | 150 + include/raknet/CloudServer.hpp | 383 + include/raknet/CommandParserInterface.hpp | 147 + include/raknet/ConnectionGraph2.hpp | 126 + include/raknet/ConsoleServer.hpp | 84 + include/raknet/DR_SHA1.hpp | 308 + include/raknet/DS_BPlusTree.hpp | 1154 +++ include/raknet/DS_BinarySearchTree.hpp | 1141 +++ include/raknet/DS_BytePool.hpp | 54 + include/raknet/DS_ByteQueue.hpp | 47 + include/raknet/DS_Hash.hpp | 357 + include/raknet/DS_Heap.hpp | 305 + include/raknet/DS_HuffmanEncodingTree.hpp | 74 + .../raknet/DS_HuffmanEncodingTreeFactory.hpp | 64 + include/raknet/DS_HuffmanEncodingTreeNode.hpp | 27 + include/raknet/DS_LinkedList.hpp | 1257 ++++ include/raknet/DS_List.hpp | 525 ++ include/raknet/DS_Map.hpp | 335 + include/raknet/DS_MemoryPool.hpp | 356 + include/raknet/DS_Multilist.hpp | 1650 +++++ include/raknet/DS_OrderedChannelHeap.hpp | 251 + include/raknet/DS_OrderedList.hpp | 286 + include/raknet/DS_Queue.hpp | 461 ++ include/raknet/DS_QueueLinkedList.hpp | 110 + include/raknet/DS_RangeList.hpp | 243 + include/raknet/DS_Table.hpp | 351 + .../raknet/DS_ThreadsafeAllocatingQueue.hpp | 184 + include/raknet/DS_Tree.hpp | 106 + include/raknet/DS_WeightedGraph.hpp | 544 ++ include/raknet/DataCompressor.hpp | 40 + include/raknet/DirectoryDeltaTransfer.hpp | 172 + include/raknet/DynDNS.hpp | 110 + include/raknet/EmailSender.hpp | 65 + include/raknet/EmptyHeader.hpp | 1 + include/raknet/EpochTimeToString.hpp | 24 + include/raknet/Export.hpp | 23 + include/raknet/FileList.hpp | 266 + include/raknet/FileListNodeContext.hpp | 57 + include/raknet/FileListTransfer.hpp | 185 + .../raknet/FileListTransferCBInterface.hpp | 162 + include/raknet/FileOperations.hpp | 32 + include/raknet/FormatString.hpp | 30 + include/raknet/FullyConnectedMesh2.hpp | 424 ++ include/raknet/GetTime.hpp | 42 + include/raknet/Getche.hpp | 19 + include/raknet/Gets.hpp | 23 + include/raknet/GridSectorizer.hpp | 78 + include/raknet/HTTPConnection.hpp | 175 + include/raknet/HTTPConnection2.hpp | 124 + include/raknet/IncrementalReadInterface.hpp | 38 + include/raknet/InternalPacket.hpp | 130 + include/raknet/Itoa.hpp | 25 + include/raknet/Kbhit.hpp | 84 + include/raknet/LinuxStrings.hpp | 40 + include/raknet/LocklessTypes.hpp | 50 + include/raknet/LogCommandParser.hpp | 127 + include/raknet/MTUSize.hpp | 38 + include/raknet/MessageFilter.hpp | 198 + include/raknet/MessageIdentifiers.hpp | 437 ++ include/raknet/NatPunchthroughClient.hpp | 306 + include/raknet/NatPunchthroughServer.hpp | 156 + include/raknet/NatTypeDetectionClient.hpp | 97 + include/raknet/NatTypeDetectionCommon.hpp | 79 + include/raknet/NatTypeDetectionServer.hpp | 137 + include/raknet/NativeFeatureIncludes.hpp | 206 + .../raknet/NativeFeatureIncludesOverrides.hpp | 19 + include/raknet/NativeTypes.hpp | 33 + include/raknet/NetworkIDManager.hpp | 80 + include/raknet/NetworkIDObject.hpp | 89 + include/raknet/PS3Includes.hpp | 75 + include/raknet/PS4Includes.hpp | 46 + include/raknet/PacketConsoleLogger.hpp | 45 + include/raknet/PacketFileLogger.hpp | 45 + include/raknet/PacketLogger.hpp | 109 + include/raknet/PacketOutputWindowLogger.hpp | 42 + include/raknet/PacketPool.hpp | 1 + include/raknet/PacketPriority.hpp | 87 + include/raknet/PacketizedTCP.hpp | 86 + include/raknet/PluginInterface2.hpp | 211 + include/raknet/RPC4Plugin.hpp | 244 + include/raknet/Rackspace.hpp | 413 ++ include/raknet/RakAlloca.hpp | 26 + include/raknet/RakAssert.hpp | 12 + include/raknet/RakMemoryOverride.hpp | 244 + include/raknet/RakNetCommandParser.hpp | 70 + include/raknet/RakNetDefines.hpp | 195 + include/raknet/RakNetDefinesOverrides.hpp | 12 + include/raknet/RakNetSmartPtr.hpp | 183 + include/raknet/RakNetSocket.hpp | 194 + include/raknet/RakNetSocket2.hpp | 453 ++ include/raknet/RakNetStatistics.hpp | 133 + include/raknet/RakNetTime.hpp | 33 + include/raknet/RakNetTransport2.hpp | 110 + include/raknet/RakNetTypes.hpp | 507 ++ include/raknet/RakNetVersion.hpp | 19 + include/raknet/RakPeer.hpp | 1034 +++ include/raknet/RakPeerInterface.hpp | 616 ++ include/raknet/RakSleep.hpp | 18 + include/raknet/RakString.hpp | 354 + include/raknet/RakThread.hpp | 106 + include/raknet/RakWString.hpp | 123 + include/raknet/Rand.hpp | 67 + include/raknet/RandSync.hpp | 58 + include/raknet/ReadyEvent.hpp | 242 + include/raknet/RefCountedObj.hpp | 33 + include/raknet/RelayPlugin.hpp | 166 + include/raknet/ReliabilityLayer.hpp | 596 ++ include/raknet/ReplicaEnums.hpp | 51 + include/raknet/ReplicaManager3.hpp | 1137 +++ include/raknet/Router2.hpp | 203 + include/raknet/SecureHandshake.hpp | 34 + include/raknet/SendToThread.hpp | 57 + include/raknet/SignaledEvent.hpp | 69 + include/raknet/SimpleMutex.hpp | 78 + include/raknet/SimpleTCPServer.hpp | 1 + include/raknet/SingleProducerConsumer.hpp | 267 + include/raknet/SocketDefines.hpp | 122 + include/raknet/SocketIncludes.hpp | 98 + include/raknet/SocketLayer.hpp | 197 + include/raknet/StatisticsHistory.hpp | 235 + include/raknet/StringCompressor.hpp | 113 + include/raknet/StringTable.hpp | 104 + include/raknet/SuperFastHash.hpp | 27 + include/raknet/TCPInterface.hpp | 263 + include/raknet/TableSerializer.hpp | 218 + include/raknet/TeamBalancer.hpp | 206 + include/raknet/TeamManager.hpp | 757 ++ include/raknet/TelnetTransport.hpp | 80 + include/raknet/ThreadPool.hpp | 633 ++ include/raknet/ThreadsafePacketLogger.hpp | 48 + include/raknet/TransportInterface.hpp | 91 + include/raknet/TwoWayAuthentication.hpp | 154 + include/raknet/UDPForwarder.hpp | 159 + include/raknet/UDPProxyClient.hpp | 181 + include/raknet/UDPProxyCommon.hpp | 67 + include/raknet/UDPProxyCoordinator.hpp | 117 + include/raknet/UDPProxyServer.hpp | 126 + include/raknet/VariableDeltaSerializer.hpp | 267 + include/raknet/VariableListDeltaTracker.hpp | 146 + include/raknet/VariadicSQLParser.hpp | 34 + include/raknet/VitaIncludes.hpp | 58 + include/raknet/WSAStartupSingleton.hpp | 26 + include/raknet/WindowsIncludes.hpp | 29 + include/raknet/XBox360Includes.hpp | 57 + include/raknet/_FindFirst.hpp | 56 + include/raknet/gettimeofday.hpp | 74 + include/utils/BitReader.hpp | 48 + include/utils/CRC.hpp | 30 + include/utils/EndianUtils.hpp | 30 + include/utils/FileReader.hpp | 33 + include/utils/FileWriter.hpp | 28 + include/utils/GzipUtils.hpp | 17 + include/utils/HeaderChecker.hpp | 25 + include/utils/Integer.hpp | 35 + include/utils/LineReader.hpp | 28 + include/utils/Obfuscator.hpp | 19 + include/utils/ZLibUtils.hpp | 20 + include/zlib/crc32.h | 441 ++ include/zlib/deflate.h | 349 + include/zlib/gzguts.h | 218 + include/zlib/inffast.h | 11 + include/zlib/inffixed.h | 94 + include/zlib/inflate.h | 125 + include/zlib/inftrees.h | 62 + include/zlib/trees.h | 128 + include/zlib/zconf.h | 534 ++ include/zlib/zlib.h | 1912 +++++ include/zlib/zutil.h | 271 + libs/libcrypto64.a | Bin 0 -> 4323838 bytes libs/libssl64.a | Bin 0 -> 813266 bytes native-utilities-dll.pro | 576 ++ native-utilities-dll.pro.user | 1102 +++ native-utilities.pro.user | 1102 +++ readme.md | 7 + src/array/GrowableArray.cpp | 281 + src/array/GrowableBooleanArray.cpp | 102 + src/array/GrowableByteArray.cpp | 98 + src/array/GrowableDoubleArray.cpp | 97 + src/array/GrowableFloatArray.cpp | 97 + src/array/GrowableIntegerArray.cpp | 97 + src/array/GrowableLongArray.cpp | 97 + src/array/GrowableObjectArray.cpp | 118 + src/array/GrowableShortArray.cpp | 97 + src/colorspace/SampleUtils.cpp | 39 + src/drfstream/drfstream.cpp | 209 + src/encoding/CharTableGBK.cpp | 1420 ++++ src/encoding/CharTableUTF8.cpp | 1420 ++++ src/encoding/EncodingUtils.cpp | 278 + src/main.cpp | 20 + src/memory/Memory.cpp | 123 + src/png/IDATDecoder.cpp | 143 + src/png/PNGChunk.cpp | 183 + src/png/PNGChunkIDAT.cpp | 12 + src/png/PNGChunkIHDR.cpp | 122 + src/png/PNGChunkITXT.cpp | 140 + src/png/PNGChunkPHYS.cpp | 46 + src/png/PNGChunkPLTE.cpp | 14 + src/png/PNGChunkTEXT.cpp | 61 + src/png/PNGChunkTIME.cpp | 144 + src/png/PNGChunkTRNS.cpp | 10 + src/png/PNGChunkZTXT.cpp | 84 + src/png/UnfilterAverage.cpp | 38 + src/png/UnfilterNone.cpp | 17 + src/png/UnfilterPaeth.cpp | 63 + src/png/UnfilterSub.cpp | 27 + src/png/UnfilterUp.cpp | 23 + src/raknet/Base64Encoder.cpp | 95 + src/raknet/BitStream.cpp | 1182 +++ src/raknet/CCRakNetSlidingWindow.cpp | 372 + src/raknet/CCRakNetUDT.cpp | 808 ++ src/raknet/CheckSum.cpp | 107 + src/raknet/CloudClient.cpp | 256 + src/raknet/CloudCommon.cpp | 169 + src/raknet/CloudServer.cpp | 1685 +++++ src/raknet/CommandParserInterface.cpp | 172 + src/raknet/ConnectionGraph2.cpp | 309 + src/raknet/ConsoleServer.cpp | 321 + src/raknet/DR_SHA1.cpp | 312 + src/raknet/DS_BytePool.cpp | 159 + src/raknet/DS_ByteQueue.cpp | 137 + src/raknet/DS_HuffmanEncodingTree.cpp | 302 + src/raknet/DS_Table.cpp | 1131 +++ src/raknet/DataCompressor.cpp | 73 + src/raknet/DirectoryDeltaTransfer.cpp | 252 + src/raknet/DynDNS.cpp | 249 + src/raknet/EmailSender.cpp | 377 + src/raknet/EpochTimeToString.cpp | 45 + src/raknet/FileList.cpp | 818 +++ src/raknet/FileListTransfer.cpp | 1165 +++ src/raknet/FileOperations.cpp | 179 + src/raknet/FormatString.cpp | 40 + src/raknet/FullyConnectedMesh2.cpp | 1423 ++++ src/raknet/GetTime.cpp | 231 + src/raknet/Getche.cpp | 35 + src/raknet/Gets.cpp | 35 + src/raknet/GridSectorizer.cpp | 201 + src/raknet/HTTPConnection.cpp | 310 + src/raknet/HTTPConnection2.cpp | 621 ++ src/raknet/IncrementalReadInterface.cpp | 25 + src/raknet/Itoa.cpp | 64 + src/raknet/LinuxStrings.cpp | 39 + src/raknet/LocklessTypes.cpp | 52 + src/raknet/LogCommandParser.cpp | 289 + src/raknet/MessageFilter.cpp | 418 ++ src/raknet/NatPunchthroughClient.cpp | 1216 +++ src/raknet/NatPunchthroughServer.cpp | 624 ++ src/raknet/NatTypeDetectionClient.cpp | 244 + src/raknet/NatTypeDetectionCommon.cpp | 209 + src/raknet/NatTypeDetectionServer.cpp | 438 ++ src/raknet/NetworkIDManager.cpp | 133 + src/raknet/NetworkIDObject.cpp | 91 + src/raknet/PS4Includes.cpp | 55 + src/raknet/PacketConsoleLogger.cpp | 36 + src/raknet/PacketFileLogger.cpp | 55 + src/raknet/PacketLogger.cpp | 477 ++ src/raknet/PacketOutputWindowLogger.cpp | 52 + src/raknet/PacketizedTCP.cpp | 356 + src/raknet/PluginInterface2.cpp | 221 + src/raknet/RPC4Plugin.cpp | 629 ++ src/raknet/Rackspace.cpp | 671 ++ src/raknet/RakMemoryOverride.cpp | 306 + src/raknet/RakNetCommandParser.cpp | 312 + src/raknet/RakNetSocket.cpp | 158 + src/raknet/RakNetSocket2.cpp | 513 ++ src/raknet/RakNetSocket2_360_720.cpp | 86 + src/raknet/RakNetSocket2_Berkley.cpp | 554 ++ .../RakNetSocket2_Berkley_NativeClient.cpp | 114 + src/raknet/RakNetSocket2_NativeClient.cpp | 169 + src/raknet/RakNetSocket2_PS3_PS4.cpp | 128 + src/raknet/RakNetSocket2_PS4.cpp | 72 + src/raknet/RakNetSocket2_Vita.cpp | 159 + src/raknet/RakNetSocket2_WindowsStore8.cpp | 467 ++ src/raknet/RakNetSocket2_Windows_Linux.cpp | 121 + .../RakNetSocket2_Windows_Linux_360.cpp | 73 + src/raknet/RakNetStatistics.cpp | 156 + src/raknet/RakNetTransport2.cpp | 138 + src/raknet/RakNetTypes.cpp | 812 ++ src/raknet/RakPeer.cpp | 6504 +++++++++++++++++ src/raknet/RakSleep.cpp | 71 + src/raknet/RakString.cpp | 1687 +++++ src/raknet/RakThread.cpp | 178 + src/raknet/RakWString.cpp | 412 ++ src/raknet/Rand.cpp | 274 + src/raknet/RandSync.cpp | 167 + src/raknet/ReadyEvent.cpp | 572 ++ src/raknet/RelayPlugin.cpp | 432 ++ src/raknet/ReliabilityLayer.cpp | 3957 ++++++++++ src/raknet/ReplicaManager3.cpp | 2593 +++++++ src/raknet/Router2.cpp | 1368 ++++ src/raknet/SecureHandshake.cpp | 62 + src/raknet/SendToThread.cpp | 87 + src/raknet/SignaledEvent.cpp | 264 + src/raknet/SimpleMutex.cpp | 191 + src/raknet/SocketLayer.cpp | 613 ++ src/raknet/StatisticsHistory.cpp | 827 +++ src/raknet/StringCompressor.cpp | 509 ++ src/raknet/StringTable.cpp | 150 + src/raknet/SuperFastHash.cpp | 129 + src/raknet/TCPInterface.cpp | 1439 ++++ src/raknet/TableSerializer.cpp | 330 + src/raknet/TeamBalancer.cpp | 885 +++ src/raknet/TeamManager.cpp | 2853 ++++++++ src/raknet/TelnetTransport.cpp | 374 + src/raknet/ThreadsafePacketLogger.cpp | 48 + src/raknet/TwoWayAuthentication.cpp | 441 ++ src/raknet/UDPForwarder.cpp | 643 ++ src/raknet/UDPProxyClient.cpp | 313 + src/raknet/UDPProxyCoordinator.cpp | 568 ++ src/raknet/UDPProxyServer.cpp | 178 + src/raknet/VariableDeltaSerializer.cpp | 285 + src/raknet/VariableListDeltaTracker.cpp | 50 + src/raknet/VariadicSQLParser.cpp | 160 + src/raknet/VitaIncludes.cpp | 165 + src/raknet/WSAStartupSingleton.cpp | 85 + src/raknet/_FindFirst.cpp | 159 + src/raknet/gettimeofday.cpp | 69 + src/utils/BitReader.cpp | 208 + src/utils/CRC.cpp | 54 + src/utils/EndianUtils.cpp | 66 + src/utils/FileReader.cpp | 89 + src/utils/FileWriter.cpp | 53 + src/utils/GzipUtils.cpp | 224 + src/utils/HeaderChecker.cpp | 12 + src/utils/Integer.cpp | 361 + src/utils/LineReader.cpp | 142 + src/utils/Obfuscator.cpp | 114 + src/utils/ZLibUtils.cpp | 110 + src/zlib/adler32.c | 186 + src/zlib/compress.c | 86 + src/zlib/crc32.c | 442 ++ src/zlib/deflate.c | 2163 ++++++ src/zlib/gzclose.c | 25 + src/zlib/gzlib.c | 637 ++ src/zlib/gzread.c | 654 ++ src/zlib/gzwrite.c | 665 ++ src/zlib/inffast.c | 323 + src/zlib/inflate.c | 1561 ++++ src/zlib/inftrees.c | 304 + src/zlib/trees.c | 1203 +++ src/zlib/uncompr.c | 93 + src/zlib/zutil.c | 325 + zlib.3.pdf | Bin 0 -> 19318 bytes 552 files changed, 147047 insertions(+) create mode 100644 .gitignore create mode 100644 Android.mk create mode 100644 Application.mk create mode 100644 OpenSSL_LICENSE create mode 100644 OpenSSL_README create mode 100644 RakNet_LICENSE create mode 100644 RakNet_README create mode 100644 include/array/GrowableArray.hpp create mode 100644 include/array/GrowableBooleanArray.hpp create mode 100644 include/array/GrowableByteArray.hpp create mode 100644 include/array/GrowableDoubleArray.hpp create mode 100644 include/array/GrowableFloatArray.hpp create mode 100644 include/array/GrowableIntegerArray.hpp create mode 100644 include/array/GrowableLongArray.hpp create mode 100644 include/array/GrowableObjectArray.hpp create mode 100644 include/array/GrowableShortArray.hpp create mode 100644 include/colorspace/SampleUtils.hpp create mode 100644 include/drfstream/drfstream.hpp create mode 100644 include/encoding/CharTableGBK.hpp create mode 100644 include/encoding/CharTableUTF8.hpp create mode 100644 include/encoding/EncodingUtils.hpp create mode 100644 include/memory/Memory.hpp create mode 100644 include/openssl/__DECC_INCLUDE_EPILOGUE.H create mode 100644 include/openssl/__DECC_INCLUDE_PROLOGUE.H create mode 100644 include/openssl/aes.h create mode 100644 include/openssl/asn1.h create mode 100644 include/openssl/asn1_mac.h create mode 100644 include/openssl/asn1err.h create mode 100644 include/openssl/asn1t.h create mode 100644 include/openssl/async.h create mode 100644 include/openssl/asyncerr.h create mode 100644 include/openssl/bio.h create mode 100644 include/openssl/bioerr.h create mode 100644 include/openssl/blowfish.h create mode 100644 include/openssl/bn.h create mode 100644 include/openssl/bnerr.h create mode 100644 include/openssl/buffer.h create mode 100644 include/openssl/buffererr.h create mode 100644 include/openssl/camellia.h create mode 100644 include/openssl/cast.h create mode 100644 include/openssl/cmac.h create mode 100644 include/openssl/cms.h create mode 100644 include/openssl/cmserr.h create mode 100644 include/openssl/comp.h create mode 100644 include/openssl/comperr.h create mode 100644 include/openssl/conf.h create mode 100644 include/openssl/conf_api.h create mode 100644 include/openssl/conferr.h create mode 100644 include/openssl/crypto.h create mode 100644 include/openssl/crypto/arm_arch.h create mode 100644 include/openssl/crypto/buildinf.h create mode 100644 include/openssl/crypto/internal/__DECC_INCLUDE_EPILOGUE.H create mode 100644 include/openssl/crypto/internal/__DECC_INCLUDE_PROLOGUE.H create mode 100644 include/openssl/crypto/internal/aria.h create mode 100644 include/openssl/crypto/internal/asn1_int.h create mode 100644 include/openssl/crypto/internal/async.h create mode 100644 include/openssl/crypto/internal/bn_conf.h create mode 100644 include/openssl/crypto/internal/bn_dh.h create mode 100644 include/openssl/crypto/internal/bn_int.h create mode 100644 include/openssl/crypto/internal/bn_srp.h create mode 100644 include/openssl/crypto/internal/chacha.h create mode 100644 include/openssl/crypto/internal/cryptlib_int.h create mode 100644 include/openssl/crypto/internal/ctype.h create mode 100644 include/openssl/crypto/internal/dso_conf.h create mode 100644 include/openssl/crypto/internal/ec_int.h create mode 100644 include/openssl/crypto/internal/engine.h create mode 100644 include/openssl/crypto/internal/err_int.h create mode 100644 include/openssl/crypto/internal/evp_int.h create mode 100644 include/openssl/crypto/internal/lhash.h create mode 100644 include/openssl/crypto/internal/md32_common.h create mode 100644 include/openssl/crypto/internal/objects.h create mode 100644 include/openssl/crypto/internal/poly1305.h create mode 100644 include/openssl/crypto/internal/rand_int.h create mode 100644 include/openssl/crypto/internal/sha.h create mode 100644 include/openssl/crypto/internal/siphash.h create mode 100644 include/openssl/crypto/internal/sm2.h create mode 100644 include/openssl/crypto/internal/sm2err.h create mode 100644 include/openssl/crypto/internal/sm3.h create mode 100644 include/openssl/crypto/internal/sm4.h create mode 100644 include/openssl/crypto/internal/store.h create mode 100644 include/openssl/crypto/internal/store_int.h create mode 100644 include/openssl/crypto/internal/x509_int.h create mode 100644 include/openssl/crypto/mips_arch.h create mode 100644 include/openssl/crypto/ppc_arch.h create mode 100644 include/openssl/crypto/s390x_arch.h create mode 100644 include/openssl/crypto/sparc_arch.h create mode 100644 include/openssl/crypto/vms_rms.h create mode 100644 include/openssl/cryptoerr.h create mode 100644 include/openssl/ct.h create mode 100644 include/openssl/cterr.h create mode 100644 include/openssl/des.h create mode 100644 include/openssl/dh.h create mode 100644 include/openssl/dherr.h create mode 100644 include/openssl/dsa.h create mode 100644 include/openssl/dsaerr.h create mode 100644 include/openssl/dtls1.h create mode 100644 include/openssl/e_os2.h create mode 100644 include/openssl/ebcdic.h create mode 100644 include/openssl/ec.h create mode 100644 include/openssl/ecdh.h create mode 100644 include/openssl/ecdsa.h create mode 100644 include/openssl/ecerr.h create mode 100644 include/openssl/engine.h create mode 100644 include/openssl/engineerr.h create mode 100644 include/openssl/err.h create mode 100644 include/openssl/evp.h create mode 100644 include/openssl/evperr.h create mode 100644 include/openssl/hmac.h create mode 100644 include/openssl/idea.h create mode 100644 include/openssl/internal/__DECC_INCLUDE_EPILOGUE.H create mode 100644 include/openssl/internal/__DECC_INCLUDE_PROLOGUE.H create mode 100644 include/openssl/internal/bio.h create mode 100644 include/openssl/internal/comp.h create mode 100644 include/openssl/internal/conf.h create mode 100644 include/openssl/internal/constant_time_locl.h create mode 100644 include/openssl/internal/cryptlib.h create mode 100644 include/openssl/internal/dane.h create mode 100644 include/openssl/internal/dso.h create mode 100644 include/openssl/internal/dsoerr.h create mode 100644 include/openssl/internal/err.h create mode 100644 include/openssl/internal/nelem.h create mode 100644 include/openssl/internal/numbers.h create mode 100644 include/openssl/internal/o_dir.h create mode 100644 include/openssl/internal/o_str.h create mode 100644 include/openssl/internal/refcount.h create mode 100644 include/openssl/internal/sockets.h create mode 100644 include/openssl/internal/sslconf.h create mode 100644 include/openssl/internal/thread_once.h create mode 100644 include/openssl/internal/tsan_assist.h create mode 100644 include/openssl/kdf.h create mode 100644 include/openssl/kdferr.h create mode 100644 include/openssl/lhash.h create mode 100644 include/openssl/md2.h create mode 100644 include/openssl/md4.h create mode 100644 include/openssl/md5.h create mode 100644 include/openssl/mdc2.h create mode 100644 include/openssl/modes.h create mode 100644 include/openssl/obj_mac.h create mode 100644 include/openssl/objects.h create mode 100644 include/openssl/objectserr.h create mode 100644 include/openssl/ocsp.h create mode 100644 include/openssl/ocsperr.h create mode 100644 include/openssl/opensslconf.h create mode 100644 include/openssl/opensslv.h create mode 100644 include/openssl/ossl_typ.h create mode 100644 include/openssl/pem.h create mode 100644 include/openssl/pem2.h create mode 100644 include/openssl/pemerr.h create mode 100644 include/openssl/pkcs12.h create mode 100644 include/openssl/pkcs12err.h create mode 100644 include/openssl/pkcs7.h create mode 100644 include/openssl/pkcs7err.h create mode 100644 include/openssl/rand.h create mode 100644 include/openssl/rand_drbg.h create mode 100644 include/openssl/randerr.h create mode 100644 include/openssl/rc2.h create mode 100644 include/openssl/rc4.h create mode 100644 include/openssl/rc5.h create mode 100644 include/openssl/ripemd.h create mode 100644 include/openssl/rsa.h create mode 100644 include/openssl/rsaerr.h create mode 100644 include/openssl/safestack.h create mode 100644 include/openssl/seed.h create mode 100644 include/openssl/sha.h create mode 100644 include/openssl/srp.h create mode 100644 include/openssl/srtp.h create mode 100644 include/openssl/ssl.h create mode 100644 include/openssl/ssl2.h create mode 100644 include/openssl/ssl3.h create mode 100644 include/openssl/sslerr.h create mode 100644 include/openssl/stack.h create mode 100644 include/openssl/store.h create mode 100644 include/openssl/storeerr.h create mode 100644 include/openssl/symhacks.h create mode 100644 include/openssl/tls1.h create mode 100644 include/openssl/ts.h create mode 100644 include/openssl/tserr.h create mode 100644 include/openssl/txt_db.h create mode 100644 include/openssl/ui.h create mode 100644 include/openssl/uierr.h create mode 100644 include/openssl/whrlpool.h create mode 100644 include/openssl/x509.h create mode 100644 include/openssl/x509_vfy.h create mode 100644 include/openssl/x509err.h create mode 100644 include/openssl/x509v3.h create mode 100644 include/openssl/x509v3err.h create mode 100644 include/png/IDATDecoder.hpp create mode 100644 include/png/PNGChunk.hpp create mode 100644 include/png/PNGChunkIDAT.hpp create mode 100644 include/png/PNGChunkIHDR.hpp create mode 100644 include/png/PNGChunkITXT.hpp create mode 100644 include/png/PNGChunkPHYS.hpp create mode 100644 include/png/PNGChunkPLTE.hpp create mode 100644 include/png/PNGChunkTEXT.hpp create mode 100644 include/png/PNGChunkTIME.hpp create mode 100644 include/png/PNGChunkTRNS.hpp create mode 100644 include/png/PNGChunkZTXT.hpp create mode 100644 include/png/UnfilterAverage.hpp create mode 100644 include/png/UnfilterNone.hpp create mode 100644 include/png/UnfilterPaeth.hpp create mode 100644 include/png/UnfilterSub.hpp create mode 100644 include/png/UnfilterUp.hpp create mode 100644 include/raknet/AutopatcherPatchContext.hpp create mode 100644 include/raknet/AutopatcherRepositoryInterface.hpp create mode 100644 include/raknet/Base64Encoder.hpp create mode 100644 include/raknet/BitStream.hpp create mode 100644 include/raknet/CCRakNetSlidingWindow.hpp create mode 100644 include/raknet/CCRakNetUDT.hpp create mode 100644 include/raknet/CheckSum.hpp create mode 100644 include/raknet/CloudClient.hpp create mode 100644 include/raknet/CloudCommon.hpp create mode 100644 include/raknet/CloudServer.hpp create mode 100644 include/raknet/CommandParserInterface.hpp create mode 100644 include/raknet/ConnectionGraph2.hpp create mode 100644 include/raknet/ConsoleServer.hpp create mode 100644 include/raknet/DR_SHA1.hpp create mode 100644 include/raknet/DS_BPlusTree.hpp create mode 100644 include/raknet/DS_BinarySearchTree.hpp create mode 100644 include/raknet/DS_BytePool.hpp create mode 100644 include/raknet/DS_ByteQueue.hpp create mode 100644 include/raknet/DS_Hash.hpp create mode 100644 include/raknet/DS_Heap.hpp create mode 100644 include/raknet/DS_HuffmanEncodingTree.hpp create mode 100644 include/raknet/DS_HuffmanEncodingTreeFactory.hpp create mode 100644 include/raknet/DS_HuffmanEncodingTreeNode.hpp create mode 100644 include/raknet/DS_LinkedList.hpp create mode 100644 include/raknet/DS_List.hpp create mode 100644 include/raknet/DS_Map.hpp create mode 100644 include/raknet/DS_MemoryPool.hpp create mode 100644 include/raknet/DS_Multilist.hpp create mode 100644 include/raknet/DS_OrderedChannelHeap.hpp create mode 100644 include/raknet/DS_OrderedList.hpp create mode 100644 include/raknet/DS_Queue.hpp create mode 100644 include/raknet/DS_QueueLinkedList.hpp create mode 100644 include/raknet/DS_RangeList.hpp create mode 100644 include/raknet/DS_Table.hpp create mode 100644 include/raknet/DS_ThreadsafeAllocatingQueue.hpp create mode 100644 include/raknet/DS_Tree.hpp create mode 100644 include/raknet/DS_WeightedGraph.hpp create mode 100644 include/raknet/DataCompressor.hpp create mode 100644 include/raknet/DirectoryDeltaTransfer.hpp create mode 100644 include/raknet/DynDNS.hpp create mode 100644 include/raknet/EmailSender.hpp create mode 100644 include/raknet/EmptyHeader.hpp create mode 100644 include/raknet/EpochTimeToString.hpp create mode 100644 include/raknet/Export.hpp create mode 100644 include/raknet/FileList.hpp create mode 100644 include/raknet/FileListNodeContext.hpp create mode 100644 include/raknet/FileListTransfer.hpp create mode 100644 include/raknet/FileListTransferCBInterface.hpp create mode 100644 include/raknet/FileOperations.hpp create mode 100644 include/raknet/FormatString.hpp create mode 100644 include/raknet/FullyConnectedMesh2.hpp create mode 100644 include/raknet/GetTime.hpp create mode 100644 include/raknet/Getche.hpp create mode 100644 include/raknet/Gets.hpp create mode 100644 include/raknet/GridSectorizer.hpp create mode 100644 include/raknet/HTTPConnection.hpp create mode 100644 include/raknet/HTTPConnection2.hpp create mode 100644 include/raknet/IncrementalReadInterface.hpp create mode 100644 include/raknet/InternalPacket.hpp create mode 100644 include/raknet/Itoa.hpp create mode 100644 include/raknet/Kbhit.hpp create mode 100644 include/raknet/LinuxStrings.hpp create mode 100644 include/raknet/LocklessTypes.hpp create mode 100644 include/raknet/LogCommandParser.hpp create mode 100644 include/raknet/MTUSize.hpp create mode 100644 include/raknet/MessageFilter.hpp create mode 100644 include/raknet/MessageIdentifiers.hpp create mode 100644 include/raknet/NatPunchthroughClient.hpp create mode 100644 include/raknet/NatPunchthroughServer.hpp create mode 100644 include/raknet/NatTypeDetectionClient.hpp create mode 100644 include/raknet/NatTypeDetectionCommon.hpp create mode 100644 include/raknet/NatTypeDetectionServer.hpp create mode 100644 include/raknet/NativeFeatureIncludes.hpp create mode 100644 include/raknet/NativeFeatureIncludesOverrides.hpp create mode 100644 include/raknet/NativeTypes.hpp create mode 100644 include/raknet/NetworkIDManager.hpp create mode 100644 include/raknet/NetworkIDObject.hpp create mode 100644 include/raknet/PS3Includes.hpp create mode 100644 include/raknet/PS4Includes.hpp create mode 100644 include/raknet/PacketConsoleLogger.hpp create mode 100644 include/raknet/PacketFileLogger.hpp create mode 100644 include/raknet/PacketLogger.hpp create mode 100644 include/raknet/PacketOutputWindowLogger.hpp create mode 100644 include/raknet/PacketPool.hpp create mode 100644 include/raknet/PacketPriority.hpp create mode 100644 include/raknet/PacketizedTCP.hpp create mode 100644 include/raknet/PluginInterface2.hpp create mode 100644 include/raknet/RPC4Plugin.hpp create mode 100644 include/raknet/Rackspace.hpp create mode 100644 include/raknet/RakAlloca.hpp create mode 100644 include/raknet/RakAssert.hpp create mode 100644 include/raknet/RakMemoryOverride.hpp create mode 100644 include/raknet/RakNetCommandParser.hpp create mode 100644 include/raknet/RakNetDefines.hpp create mode 100644 include/raknet/RakNetDefinesOverrides.hpp create mode 100644 include/raknet/RakNetSmartPtr.hpp create mode 100644 include/raknet/RakNetSocket.hpp create mode 100644 include/raknet/RakNetSocket2.hpp create mode 100644 include/raknet/RakNetStatistics.hpp create mode 100644 include/raknet/RakNetTime.hpp create mode 100644 include/raknet/RakNetTransport2.hpp create mode 100644 include/raknet/RakNetTypes.hpp create mode 100644 include/raknet/RakNetVersion.hpp create mode 100644 include/raknet/RakPeer.hpp create mode 100644 include/raknet/RakPeerInterface.hpp create mode 100644 include/raknet/RakSleep.hpp create mode 100644 include/raknet/RakString.hpp create mode 100644 include/raknet/RakThread.hpp create mode 100644 include/raknet/RakWString.hpp create mode 100644 include/raknet/Rand.hpp create mode 100644 include/raknet/RandSync.hpp create mode 100644 include/raknet/ReadyEvent.hpp create mode 100644 include/raknet/RefCountedObj.hpp create mode 100644 include/raknet/RelayPlugin.hpp create mode 100644 include/raknet/ReliabilityLayer.hpp create mode 100644 include/raknet/ReplicaEnums.hpp create mode 100644 include/raknet/ReplicaManager3.hpp create mode 100644 include/raknet/Router2.hpp create mode 100644 include/raknet/SecureHandshake.hpp create mode 100644 include/raknet/SendToThread.hpp create mode 100644 include/raknet/SignaledEvent.hpp create mode 100644 include/raknet/SimpleMutex.hpp create mode 100644 include/raknet/SimpleTCPServer.hpp create mode 100644 include/raknet/SingleProducerConsumer.hpp create mode 100644 include/raknet/SocketDefines.hpp create mode 100644 include/raknet/SocketIncludes.hpp create mode 100644 include/raknet/SocketLayer.hpp create mode 100644 include/raknet/StatisticsHistory.hpp create mode 100644 include/raknet/StringCompressor.hpp create mode 100644 include/raknet/StringTable.hpp create mode 100644 include/raknet/SuperFastHash.hpp create mode 100644 include/raknet/TCPInterface.hpp create mode 100644 include/raknet/TableSerializer.hpp create mode 100644 include/raknet/TeamBalancer.hpp create mode 100644 include/raknet/TeamManager.hpp create mode 100644 include/raknet/TelnetTransport.hpp create mode 100644 include/raknet/ThreadPool.hpp create mode 100644 include/raknet/ThreadsafePacketLogger.hpp create mode 100644 include/raknet/TransportInterface.hpp create mode 100644 include/raknet/TwoWayAuthentication.hpp create mode 100644 include/raknet/UDPForwarder.hpp create mode 100644 include/raknet/UDPProxyClient.hpp create mode 100644 include/raknet/UDPProxyCommon.hpp create mode 100644 include/raknet/UDPProxyCoordinator.hpp create mode 100644 include/raknet/UDPProxyServer.hpp create mode 100644 include/raknet/VariableDeltaSerializer.hpp create mode 100644 include/raknet/VariableListDeltaTracker.hpp create mode 100644 include/raknet/VariadicSQLParser.hpp create mode 100644 include/raknet/VitaIncludes.hpp create mode 100644 include/raknet/WSAStartupSingleton.hpp create mode 100644 include/raknet/WindowsIncludes.hpp create mode 100644 include/raknet/XBox360Includes.hpp create mode 100644 include/raknet/_FindFirst.hpp create mode 100644 include/raknet/gettimeofday.hpp create mode 100644 include/utils/BitReader.hpp create mode 100644 include/utils/CRC.hpp create mode 100644 include/utils/EndianUtils.hpp create mode 100644 include/utils/FileReader.hpp create mode 100644 include/utils/FileWriter.hpp create mode 100644 include/utils/GzipUtils.hpp create mode 100644 include/utils/HeaderChecker.hpp create mode 100644 include/utils/Integer.hpp create mode 100644 include/utils/LineReader.hpp create mode 100644 include/utils/Obfuscator.hpp create mode 100644 include/utils/ZLibUtils.hpp create mode 100644 include/zlib/crc32.h create mode 100644 include/zlib/deflate.h create mode 100644 include/zlib/gzguts.h create mode 100644 include/zlib/inffast.h create mode 100644 include/zlib/inffixed.h create mode 100644 include/zlib/inflate.h create mode 100644 include/zlib/inftrees.h create mode 100644 include/zlib/trees.h create mode 100644 include/zlib/zconf.h create mode 100644 include/zlib/zlib.h create mode 100644 include/zlib/zutil.h create mode 100644 libs/libcrypto64.a create mode 100644 libs/libssl64.a create mode 100644 native-utilities-dll.pro create mode 100644 native-utilities-dll.pro.user create mode 100644 native-utilities.pro.user create mode 100644 readme.md create mode 100644 src/array/GrowableArray.cpp create mode 100644 src/array/GrowableBooleanArray.cpp create mode 100644 src/array/GrowableByteArray.cpp create mode 100644 src/array/GrowableDoubleArray.cpp create mode 100644 src/array/GrowableFloatArray.cpp create mode 100644 src/array/GrowableIntegerArray.cpp create mode 100644 src/array/GrowableLongArray.cpp create mode 100644 src/array/GrowableObjectArray.cpp create mode 100644 src/array/GrowableShortArray.cpp create mode 100644 src/colorspace/SampleUtils.cpp create mode 100644 src/drfstream/drfstream.cpp create mode 100644 src/encoding/CharTableGBK.cpp create mode 100644 src/encoding/CharTableUTF8.cpp create mode 100644 src/encoding/EncodingUtils.cpp create mode 100644 src/main.cpp create mode 100644 src/memory/Memory.cpp create mode 100644 src/png/IDATDecoder.cpp create mode 100644 src/png/PNGChunk.cpp create mode 100644 src/png/PNGChunkIDAT.cpp create mode 100644 src/png/PNGChunkIHDR.cpp create mode 100644 src/png/PNGChunkITXT.cpp create mode 100644 src/png/PNGChunkPHYS.cpp create mode 100644 src/png/PNGChunkPLTE.cpp create mode 100644 src/png/PNGChunkTEXT.cpp create mode 100644 src/png/PNGChunkTIME.cpp create mode 100644 src/png/PNGChunkTRNS.cpp create mode 100644 src/png/PNGChunkZTXT.cpp create mode 100644 src/png/UnfilterAverage.cpp create mode 100644 src/png/UnfilterNone.cpp create mode 100644 src/png/UnfilterPaeth.cpp create mode 100644 src/png/UnfilterSub.cpp create mode 100644 src/png/UnfilterUp.cpp create mode 100644 src/raknet/Base64Encoder.cpp create mode 100644 src/raknet/BitStream.cpp create mode 100644 src/raknet/CCRakNetSlidingWindow.cpp create mode 100644 src/raknet/CCRakNetUDT.cpp create mode 100644 src/raknet/CheckSum.cpp create mode 100644 src/raknet/CloudClient.cpp create mode 100644 src/raknet/CloudCommon.cpp create mode 100644 src/raknet/CloudServer.cpp create mode 100644 src/raknet/CommandParserInterface.cpp create mode 100644 src/raknet/ConnectionGraph2.cpp create mode 100644 src/raknet/ConsoleServer.cpp create mode 100644 src/raknet/DR_SHA1.cpp create mode 100644 src/raknet/DS_BytePool.cpp create mode 100644 src/raknet/DS_ByteQueue.cpp create mode 100644 src/raknet/DS_HuffmanEncodingTree.cpp create mode 100644 src/raknet/DS_Table.cpp create mode 100644 src/raknet/DataCompressor.cpp create mode 100644 src/raknet/DirectoryDeltaTransfer.cpp create mode 100644 src/raknet/DynDNS.cpp create mode 100644 src/raknet/EmailSender.cpp create mode 100644 src/raknet/EpochTimeToString.cpp create mode 100644 src/raknet/FileList.cpp create mode 100644 src/raknet/FileListTransfer.cpp create mode 100644 src/raknet/FileOperations.cpp create mode 100644 src/raknet/FormatString.cpp create mode 100644 src/raknet/FullyConnectedMesh2.cpp create mode 100644 src/raknet/GetTime.cpp create mode 100644 src/raknet/Getche.cpp create mode 100644 src/raknet/Gets.cpp create mode 100644 src/raknet/GridSectorizer.cpp create mode 100644 src/raknet/HTTPConnection.cpp create mode 100644 src/raknet/HTTPConnection2.cpp create mode 100644 src/raknet/IncrementalReadInterface.cpp create mode 100644 src/raknet/Itoa.cpp create mode 100644 src/raknet/LinuxStrings.cpp create mode 100644 src/raknet/LocklessTypes.cpp create mode 100644 src/raknet/LogCommandParser.cpp create mode 100644 src/raknet/MessageFilter.cpp create mode 100644 src/raknet/NatPunchthroughClient.cpp create mode 100644 src/raknet/NatPunchthroughServer.cpp create mode 100644 src/raknet/NatTypeDetectionClient.cpp create mode 100644 src/raknet/NatTypeDetectionCommon.cpp create mode 100644 src/raknet/NatTypeDetectionServer.cpp create mode 100644 src/raknet/NetworkIDManager.cpp create mode 100644 src/raknet/NetworkIDObject.cpp create mode 100644 src/raknet/PS4Includes.cpp create mode 100644 src/raknet/PacketConsoleLogger.cpp create mode 100644 src/raknet/PacketFileLogger.cpp create mode 100644 src/raknet/PacketLogger.cpp create mode 100644 src/raknet/PacketOutputWindowLogger.cpp create mode 100644 src/raknet/PacketizedTCP.cpp create mode 100644 src/raknet/PluginInterface2.cpp create mode 100644 src/raknet/RPC4Plugin.cpp create mode 100644 src/raknet/Rackspace.cpp create mode 100644 src/raknet/RakMemoryOverride.cpp create mode 100644 src/raknet/RakNetCommandParser.cpp create mode 100644 src/raknet/RakNetSocket.cpp create mode 100644 src/raknet/RakNetSocket2.cpp create mode 100644 src/raknet/RakNetSocket2_360_720.cpp create mode 100644 src/raknet/RakNetSocket2_Berkley.cpp create mode 100644 src/raknet/RakNetSocket2_Berkley_NativeClient.cpp create mode 100644 src/raknet/RakNetSocket2_NativeClient.cpp create mode 100644 src/raknet/RakNetSocket2_PS3_PS4.cpp create mode 100644 src/raknet/RakNetSocket2_PS4.cpp create mode 100644 src/raknet/RakNetSocket2_Vita.cpp create mode 100644 src/raknet/RakNetSocket2_WindowsStore8.cpp create mode 100644 src/raknet/RakNetSocket2_Windows_Linux.cpp create mode 100644 src/raknet/RakNetSocket2_Windows_Linux_360.cpp create mode 100644 src/raknet/RakNetStatistics.cpp create mode 100644 src/raknet/RakNetTransport2.cpp create mode 100644 src/raknet/RakNetTypes.cpp create mode 100644 src/raknet/RakPeer.cpp create mode 100644 src/raknet/RakSleep.cpp create mode 100644 src/raknet/RakString.cpp create mode 100644 src/raknet/RakThread.cpp create mode 100644 src/raknet/RakWString.cpp create mode 100644 src/raknet/Rand.cpp create mode 100644 src/raknet/RandSync.cpp create mode 100644 src/raknet/ReadyEvent.cpp create mode 100644 src/raknet/RelayPlugin.cpp create mode 100644 src/raknet/ReliabilityLayer.cpp create mode 100644 src/raknet/ReplicaManager3.cpp create mode 100644 src/raknet/Router2.cpp create mode 100644 src/raknet/SecureHandshake.cpp create mode 100644 src/raknet/SendToThread.cpp create mode 100644 src/raknet/SignaledEvent.cpp create mode 100644 src/raknet/SimpleMutex.cpp create mode 100644 src/raknet/SocketLayer.cpp create mode 100644 src/raknet/StatisticsHistory.cpp create mode 100644 src/raknet/StringCompressor.cpp create mode 100644 src/raknet/StringTable.cpp create mode 100644 src/raknet/SuperFastHash.cpp create mode 100644 src/raknet/TCPInterface.cpp create mode 100644 src/raknet/TableSerializer.cpp create mode 100644 src/raknet/TeamBalancer.cpp create mode 100644 src/raknet/TeamManager.cpp create mode 100644 src/raknet/TelnetTransport.cpp create mode 100644 src/raknet/ThreadsafePacketLogger.cpp create mode 100644 src/raknet/TwoWayAuthentication.cpp create mode 100644 src/raknet/UDPForwarder.cpp create mode 100644 src/raknet/UDPProxyClient.cpp create mode 100644 src/raknet/UDPProxyCoordinator.cpp create mode 100644 src/raknet/UDPProxyServer.cpp create mode 100644 src/raknet/VariableDeltaSerializer.cpp create mode 100644 src/raknet/VariableListDeltaTracker.cpp create mode 100644 src/raknet/VariadicSQLParser.cpp create mode 100644 src/raknet/VitaIncludes.cpp create mode 100644 src/raknet/WSAStartupSingleton.cpp create mode 100644 src/raknet/_FindFirst.cpp create mode 100644 src/raknet/gettimeofday.cpp create mode 100644 src/utils/BitReader.cpp create mode 100644 src/utils/CRC.cpp create mode 100644 src/utils/EndianUtils.cpp create mode 100644 src/utils/FileReader.cpp create mode 100644 src/utils/FileWriter.cpp create mode 100644 src/utils/GzipUtils.cpp create mode 100644 src/utils/HeaderChecker.cpp create mode 100644 src/utils/Integer.cpp create mode 100644 src/utils/LineReader.cpp create mode 100644 src/utils/Obfuscator.cpp create mode 100644 src/utils/ZLibUtils.cpp create mode 100644 src/zlib/adler32.c create mode 100644 src/zlib/compress.c create mode 100644 src/zlib/crc32.c create mode 100644 src/zlib/deflate.c create mode 100644 src/zlib/gzclose.c create mode 100644 src/zlib/gzlib.c create mode 100644 src/zlib/gzread.c create mode 100644 src/zlib/gzwrite.c create mode 100644 src/zlib/inffast.c create mode 100644 src/zlib/inflate.c create mode 100644 src/zlib/inftrees.c create mode 100644 src/zlib/trees.c create mode 100644 src/zlib/uncompr.c create mode 100644 src/zlib/zutil.c create mode 100644 zlib.3.pdf diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..670a114 --- /dev/null +++ b/.gitignore @@ -0,0 +1,23 @@ +# Prerequisites +*.d + +/build* + +# Compiled Object files +*.slo +*.lo +*.o +*.obj + +# Precompiled Headers +*.gch +*.pch + +# Fortran module files +*.mod +*.smod + +# Executables +*.exe +*.out +*.app diff --git a/Android.mk b/Android.mk new file mode 100644 index 0000000..8914d91 --- /dev/null +++ b/Android.mk @@ -0,0 +1,26 @@ +LOCAL_PATH:= $(call my-dir) + +include $(CLEAR_VARS) + +LOCAL_CPP_EXTENSION := .cpp .cc + +#traverse all the directory and subdirectory +define walk + $(wildcard $(1)) $(foreach e, $(wildcard $(1)/*), $(call walk, $(e))) +endef + +#find all the file recursively under jni/ +ALLFILES = $(call walk, $(LOCAL_PATH)) +FILE_LIST := $(filter %.cpp %.cc %.c, $(ALLFILES)) + +LOCAL_SRC_FILES := $(FILE_LIST:$(LOCAL_PATH)/%=%) + +LOCAL_MODULE := libnative-utilities-dll + +LOCAL_CPPFLAGS += -fexceptions -std=c++14 + +ifeq ($(TARGET_ARCH_ABI),x86) + LOCAL_CFLAGS += -ffast-math -mtune=atom -mssse3 -mfpmath=sse +endif + +include $(BUILD_SHARED_LIBRARY) \ No newline at end of file diff --git a/Application.mk b/Application.mk new file mode 100644 index 0000000..5a4c22b --- /dev/null +++ b/Application.mk @@ -0,0 +1,4 @@ +NDK_TOOLCHAIN_VERSION := 4.9 +APP_STL := gnustl_static +APP_PIE := $(APP_PIE_REQUIRED) +APP_ABI := armeabi-v7a arm64-v8a x86 x86_64 diff --git a/OpenSSL_LICENSE b/OpenSSL_LICENSE new file mode 100644 index 0000000..e953f59 --- /dev/null +++ b/OpenSSL_LICENSE @@ -0,0 +1,125 @@ + + LICENSE ISSUES + ============== + + The OpenSSL toolkit stays under a double license, i.e. both the conditions of + the OpenSSL License and the original SSLeay license apply to the toolkit. + See below for the actual license texts. + + OpenSSL License + --------------- + +/* ==================================================================== + * Copyright (c) 1998-2018 The OpenSSL Project. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * + * 3. All advertising materials mentioning features or use of this + * software must display the following acknowledgment: + * "This product includes software developed by the OpenSSL Project + * for use in the OpenSSL Toolkit. (http://www.openssl.org/)" + * + * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to + * endorse or promote products derived from this software without + * prior written permission. For written permission, please contact + * openssl-core@openssl.org. + * + * 5. Products derived from this software may not be called "OpenSSL" + * nor may "OpenSSL" appear in their names without prior written + * permission of the OpenSSL Project. + * + * 6. Redistributions of any form whatsoever must retain the following + * acknowledgment: + * "This product includes software developed by the OpenSSL Project + * for use in the OpenSSL Toolkit (http://www.openssl.org/)" + * + * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY + * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR + * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR + * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT + * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED + * OF THE POSSIBILITY OF SUCH DAMAGE. + * ==================================================================== + * + * This product includes cryptographic software written by Eric Young + * (eay@cryptsoft.com). This product includes software written by Tim + * Hudson (tjh@cryptsoft.com). + * + */ + + Original SSLeay License + ----------------------- + +/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) + * All rights reserved. + * + * This package is an SSL implementation written + * by Eric Young (eay@cryptsoft.com). + * The implementation was written so as to conform with Netscapes SSL. + * + * This library is free for commercial and non-commercial use as long as + * the following conditions are aheared to. The following conditions + * apply to all code found in this distribution, be it the RC4, RSA, + * lhash, DES, etc., code; not just the SSL code. The SSL documentation + * included with this distribution is covered by the same copyright terms + * except that the holder is Tim Hudson (tjh@cryptsoft.com). + * + * Copyright remains Eric Young's, and as such any Copyright notices in + * the code are not to be removed. + * If this package is used in a product, Eric Young should be given attribution + * as the author of the parts of the library used. + * This can be in the form of a textual message at program startup or + * in documentation (online or textual) provided with the package. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * "This product includes cryptographic software written by + * Eric Young (eay@cryptsoft.com)" + * The word 'cryptographic' can be left out if the rouines from the library + * being used are not cryptographic related :-). + * 4. If you include any Windows specific code (or a derivative thereof) from + * the apps directory (application code) you must include an acknowledgement: + * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" + * + * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + * The licence and distribution terms for any publically available version or + * derivative of this code cannot be changed. i.e. this code cannot simply be + * copied and put under another distribution licence + * [including the GNU Public Licence.] + */ + diff --git a/OpenSSL_README b/OpenSSL_README new file mode 100644 index 0000000..e70acb3 --- /dev/null +++ b/OpenSSL_README @@ -0,0 +1,93 @@ + + OpenSSL 1.1.1 11 Sep 2018 + + Copyright (c) 1998-2018 The OpenSSL Project + Copyright (c) 1995-1998 Eric A. Young, Tim J. Hudson + All rights reserved. + + DESCRIPTION + ----------- + + The OpenSSL Project is a collaborative effort to develop a robust, + commercial-grade, fully featured, and Open Source toolkit implementing the + Transport Layer Security (TLS) protocols (including SSLv3) as well as a + full-strength general purpose cryptographic library. + + OpenSSL is descended from the SSLeay library developed by Eric A. Young + and Tim J. Hudson. The OpenSSL toolkit is licensed under a dual-license (the + OpenSSL license plus the SSLeay license), which means that you are free to + get and use it for commercial and non-commercial purposes as long as you + fulfill the conditions of both licenses. + + OVERVIEW + -------- + + The OpenSSL toolkit includes: + + libssl (with platform specific naming): + Provides the client and server-side implementations for SSLv3 and TLS. + + libcrypto (with platform specific naming): + Provides general cryptographic and X.509 support needed by SSL/TLS but + not logically part of it. + + openssl: + A command line tool that can be used for: + Creation of key parameters + Creation of X.509 certificates, CSRs and CRLs + Calculation of message digests + Encryption and decryption + SSL/TLS client and server tests + Handling of S/MIME signed or encrypted mail + And more... + + INSTALLATION + ------------ + + See the appropriate file: + INSTALL Linux, Unix, Windows, OpenVMS, ... + NOTES.* INSTALL addendums for different platforms + + SUPPORT + ------- + + See the OpenSSL website www.openssl.org for details on how to obtain + commercial technical support. Free community support is available through the + openssl-users email list (see + https://www.openssl.org/community/mailinglists.html for further details). + + If you have any problems with OpenSSL then please take the following steps + first: + + - Download the latest version from the repository + to see if the problem has already been addressed + - Configure with no-asm + - Remove compiler optimization flags + + If you wish to report a bug then please include the following information + and create an issue on GitHub: + + - OpenSSL version: output of 'openssl version -a' + - Configuration data: output of 'perl configdata.pm --dump' + - OS Name, Version, Hardware platform + - Compiler Details (name, version) + - Application Details (name, version) + - Problem Description (steps that will reproduce the problem, if known) + - Stack Traceback (if the application dumps core) + + Just because something doesn't work the way you expect does not mean it + is necessarily a bug in OpenSSL. Use the openssl-users email list for this type + of query. + + HOW TO CONTRIBUTE TO OpenSSL + ---------------------------- + + See CONTRIBUTING + + LEGALITIES + ---------- + + A number of nations restrict the use or export of cryptography. If you + are potentially subject to such restrictions you should seek competent + professional legal advice before attempting to develop or distribute + cryptographic code. diff --git a/RakNet_LICENSE b/RakNet_LICENSE new file mode 100644 index 0000000..29dfb0e --- /dev/null +++ b/RakNet_LICENSE @@ -0,0 +1,25 @@ +BSD License +For RakNet software + +Copyright (c) 2014, Oculus VR, Inc. +All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, +are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY +EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT +SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED +TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN +ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. \ No newline at end of file diff --git a/RakNet_README b/RakNet_README new file mode 100644 index 0000000..e66acf3 --- /dev/null +++ b/RakNet_README @@ -0,0 +1,271 @@ +RakNet 4.081 +============ + +Copyright (c) 2014, Oculus VR, Inc. + +Package notes +------------------------------------------ +The Help directory contains index.html, which is full help documentation in HTML format +The Source directory contain all files required for the core of Raknet and is used if you want to use the source in your program or create your own dll +The Samples directory contains code samples and one game using an older version of Raknet. The code samples each demonstrate one feature of Raknet. The game samples cover several features. +The lib directory contains libs for debug and release versions of RakNet and RakVoice +There is a make file for linux users in the root directory. Windows users can use projects under Samples\Project Samples + +C# support +------------------------------------------ + +See Help\swigtutorial.html + +Upgrading from version 3 +------------------------------------------ + +See 3.x_to_4.x_upgrade.txt + +Windows users (Visual Studio 2008 and 2010) +----------------------------------------- +Load RakNet_VS2008.sln and convert if necessary. + +After the project conversion, if you encounter error MSB4006, +follow the steps below to fix it: + +1. Open project properties +2. Click on "Common Properties" +3. Click on "Framework and References" +4. Look under "Build Properties" +5. Change the "Copy Local" flag from "True" to "False" + +For other compiler issues, please see Help/compilersetup.html + +Windows users (VC6) +----------------------------------------- +Not supported, but you can get by if you directly include the source. + +CYGWIN users +----------------------------------------- +Copy Include, Source, and whatever you want to run in the home directory. Then type +`g++ ../../lib/w32api/libws2_32.a *.cpp` +You can run `a.exe`. +You might have to copy `*.dll` from `cygwin\bin` as well. + +Linux users +----------------------------------------- +Use `cmake`, or `g++ -lpthread -g *.cpp` in the /Source directory. +With libcat, use `g++ -pthread -g -I./../DependentExtensions *.cpp` in the /Source directory. + +64 bit use -m64 command line +Sometimes you need -pthread instead of -lpthread + +Command to build 64 bit chat example server from the /Source directory: + + g++ -m64 -g -lpthread -I./ "../Samples/Chat Example/Chat Example Server.cpp" *.cpp + +Command to build NATCompleteServer from the Samples/NATCompleteServer directory: + + g++ -g -lpthread -I./ -I./../../Source main.cpp -I./../CloudServer ./../../Source/*.cpp ./../CloudServer/CloudServerHelper.cpp + +Command to build autopatcher server from /Source directory: + + g++ -lpthread -lpq -lssl -lbz2 -lssl -lcrypto -L/opt/PostgreSQL/9.0/lib -L../DependentExtensions/bzip2-1.0.6 -I/opt/PostgreSQL/9.0/include -I../DependentExtensions/bzip2-1.0.6 -I./ -I../DependentExtensions/Autopatcher -I../DependentExtensions/Autopatcher/AutopatcherPostgreRepository -I../DependentExtensions/PostgreSQLInterface -g *.cpp ../DependentExtensions/Autopatcher/AutopatcherServer.cpp ../DependentExtensions/Autopatcher/CreatePatch.cpp ../DependentExtensions/Autopatcher/MemoryCompressor.cpp ../DependentExtensions/Autopatcher/AutopatcherPostgreRepository/AutopatcherPostgreRepository.cpp ../DependentExtensions/PostgreSQLInterface/PostgreSQLInterface.cpp ../Samples/AutopatcherServer/AutopatcherServerTest.cpp + +Command to build NATCompleteServer from /Source directory: + + g++ -lpthread -I./ -I../Samples/CloudServer ../Samples/CloudServer/CloudServerHelper.cpp ../Samples/NATCompleteServer/main.cpp *.cpp + +Command to build BigPacketTest from /Source directory: + + g++ -lpthread -I./ ../Samples/BigPacketTest/BigPacketTest.cpp *.cpp + +Or with debugging info on: + + g++ -g -lpthread -I./ ../Samples/BigPacketTest/BigPacketTest.cpp *.cpp + +If you get /usr/local/lib/libraknet.so: undefined reference to \`__sync_fetch_and_add_4 then build with `-march=i686` + +To debug: +http://www.unknownroad.com/rtfm/gdbtut/gdbstack.html +http://cs.baylor.edu/~donahoo/tools/gdb/tutorial.html +http://linux.bytesex.org/gdb.html +http://www.delorie.com/gnu/docs/gdb/gdb_29.html + + gdb ./a.out + +Set breakpoint: + + b file:line + +Disable a breakpoint: + + disable + +Delete a breakpoint: + + delete + +Get a list of breakpoints: + + info breakpoints + +St breakpoint to be ignored that number of times + + ignore + run + +Other useful commands: + + info stack + info locals + delete (Clears all breakpoints) + step (step into) + next (step over) + finish (step out) + continue to keep going after step or next + p + For example: p users.orderedList.listArray[0].guid + +Command to install g++ + + sudo apt-get install gcc-c++ + sudo apt-get install build-essential +Or: + + yum install gcc-c++ +Or: + + sudo apt-get update + sudo apt-get install g++ + +Command to install gdb + + sudo apt-get install gdb + +Command to install wget, used to download files from webpages +sudo apt-get install wget + +Series of commands for a new server: + sudo apt-get install wget + sudo apt-get update + sudo apt-get install --fix-missing g++ + sudo apt-get install gdb + cd RakNet_Install_Directory\Source + g++ -m64 -g -pthread -I./ "../Samples/Chat Example/Chat Example Server.cpp" *.cpp + ./a.out + +Mac Users +----------------------------------------- +Open a Terminal window and type: + + cd ~/Desktop/RakNet/Source + g++ -c -DNDEBUG -I -isysroot /Developer/SDKs/MacOSX10.5u.sdk/ -arch i386 *.cpp + +Use whichever SDK you have. However, the 10.4 SDK is bugged and will not compile unless you use GCC 4.0 from inside XCODE + +The sources should build cleanly. This gives you a bunch of PowerPC binaries, compiled against the 10.3.9 SDK which is a good thing. + +Give the following command: + + libtool -static -o raknetppc.a *.o + +This will stitch together a static library for the PowerPC architecture. There may be warnings that some .o files do not have any symbols. If you want to be prudent, remove the named files (the .o files, not the .cpp files!) and re-run the libtool command. + +Now, we build the source files for Intel: + + gcc -c -I ../Include -isysroot /Developer/SDKs/MacOSX10.4u.sdk/ -arch i386 *.cpp + +..and stitch it into a i386 library: + + libtool -static -o rakneti386.a *.o + +Now, type: + + ls *.a + +which should list the two .a files. Now, we make them into a universal binary: + + lipo -create *.a -o libraknet.a + +You now have a file named libraknet.a. This is the RakNet library, built to run on both PowerPC and Intel Macs. Enjoy! ;-) + +IPod +----------------------------------------- +Depending on what version you target, you may have to change two defines to not use 64 bit integers and floats or doubles. + +Android +----------------------------------------- + +You will need the latest CYWGIN and the android SDK to build native code on the android. Under CYWGIN, you will need to run ndk-build on a directory for RakNet. + +1. Under cygwin, create the RakNet directory somewhere, such as under samples. +For example, if you create the path `\cygwin\home\Kevin\android-ndk-r4b\samples\RakNet` + +2. I copied the Android.Manifest.xml and other files from another sample + +3. Under jni, you will need the following Android.mk + + LOCAL_PATH := $(call my-dir) + include $(CLEAR_VARS) + LOCAL_MODULE := RakNet + MY_PREFIX := $(LOCAL_PATH)/RakNetSources/ + MY_SOURCES := $(wildcard $(MY_PREFIX)*.cpp) + LOCAL_SRC_FILES += $(MY_SOURCES:$(MY_PREFIX)%=RakNetSources/%) + include $(BUILD_SHARED_LIBRARY) + +This version of Android.mk assumes there is a directory called RakNetSources, for example +`cygwin/home/Kevin/android-ndk-r4b/samples/RakNet/jni/RakNetSources` + +Under RakNetSources should be the /Source directory to RakNet. Rather than copy the files I used junction.exe +http://technet.microsoft.com/en-us/sysinternals/bb896768.aspx + +The command I used to create the junction was: + + D:/cygwin/home/Kevin/android-ndk-r4b/samples/RakNet/jni/junction.exe -s D:/cygwin/home/Kevin/android-ndk-r4b/samples/RakNet/jni/RakNetSources D:/RakNet4/Source + +To unjunction I used: + + D:/cygwin/home/Kevin/android-ndk-r4b/samples/RakNet/jni/junction.exe -d D:/cygwin/home/Kevin/android-ndk-r4b/samples/RakNet/jni/RakNetSources + +From within the CYWGIN enviroment, navigate to home/Kevin/android-ndk-r4b/samples/RakNet. Then type + + ../../ndk-build + +Everything should build and you should end up with a .so file. + +You should then be able to create a project in eclipse, and import cygwin/home/Kevin/android-ndk-r4b/samples/RakNet + +Native client +----------------------------------------- +Solution: RakNet_NativeClient_VS2010. See Samples\nacl_sdk\RakNet_NativeClient_VS2010\HowToSetup.txt for detailed instructions on setup. + +Windows Phone 8 +----------------------------------------- +Example solution: RakNet_WinPhone8_VS2012. +Add to your project DependentExtensions\WinPhone8\ThreadEmulation.cpp +Add DependentExtensions\WinPhone8\ to your include paths +Define _CRT_SECURE_NO_WARNINGS and WINDOWS_PHONE_8 + +Windows Store 8 +----------------------------------------- +Example solution: RakNet_WindowsStore8_VS2012.sln +Add to your project DependentExtensions\WinPhone8\ThreadEmulation.cpp +Add DependentExtensions\WinPhone8\ and DependentExtensions\WinRT to your include paths +TCP is not supported, only UDP (RakPeer). +IPV4 only (not hard to also add IPV6 upon request). +Define: +_CRT_SECURE_NO_WARNINGS +WINDOWS_STORE_RT +_RAKNET_SUPPORT_TCPInterface=0 +_RAKNET_SUPPORT_PacketizedTCP=0 +_RAKNET_SUPPORT_EmailSender=0 +_RAKNET_SUPPORT_HTTPConnection=0 +_RAKNET_SUPPORT_HTTPConnection2=0 +_RAKNET_SUPPORT_TelnetTransport=0 +_RAKNET_SUPPORT_NatTypeDetectionServer=0 +_RAKNET_SUPPORT_UDPProxyServer=0 +_RAKNET_SUPPORT_UDPProxyCoordinator=0 +_RAKNET_SUPPORT_UDPForwarder=0 + + +Unreal engine +----------------------------------------- +See https://udn.epicgames.com/lists/showpost.php?list=unprog3&id=37697&lessthan=&show=20 + + diff --git a/include/array/GrowableArray.hpp b/include/array/GrowableArray.hpp new file mode 100644 index 0000000..47f22ba --- /dev/null +++ b/include/array/GrowableArray.hpp @@ -0,0 +1,74 @@ +#ifndef GROWABLEARRAY_HPP +#define GROWABLEARRAY_HPP + +class GrowableArray{ + + public: + + static const unsigned int TYPE_BOOLEAN; + + static const unsigned int TYPE_BYTE; + + static const unsigned int TYPE_SHORT; + + static const unsigned int TYPE_INT; + + static const unsigned int TYPE_FLOAT; + + static const unsigned int TYPE_DOUBLE; + + static const unsigned int TYPE_LONG; + + static const unsigned int TYPE_VOIDPTR; + + GrowableArray(unsigned int type, unsigned int initSize); + + ~GrowableArray(); + + void* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const void* e); + + void set(unsigned index, const void* e); + + void copyFrom(const void* data, unsigned int count); + + void copyFrom(const void* data, unsigned int index, unsigned int count); + + void copyFrom(const void* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + void* get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + private: + + unsigned int arrlen; + + unsigned int arrayCapacity; + + unsigned int elementSize; + + unsigned int init_cap; + + void* array; + + void grow(unsigned int count); + + void decrease(unsigned int count); + + void checkIndex(unsigned int index); + +}; + +#endif // GROWABLEARRAY_HPP diff --git a/include/array/GrowableBooleanArray.hpp b/include/array/GrowableBooleanArray.hpp new file mode 100644 index 0000000..d99e55a --- /dev/null +++ b/include/array/GrowableBooleanArray.hpp @@ -0,0 +1,51 @@ +#ifndef GROWABLEBOOLEANARRAY_HPP +#define GROWABLEBOOLEANARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableBooleanArray{ + + public: + + GrowableBooleanArray(unsigned int initSize=minmum_capacity); + + int* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const int e); + + void set(unsigned index, const int e); + + void copyFrom(const int* data, unsigned int count); + + void copyFrom(const int* data, unsigned int index, unsigned int count); + + void copyFrom(const int* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + int get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + ~GrowableBooleanArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + static const unsigned int minmum_capacity; + +}; + +#endif // GROWABLEBOOLEANARRAY_HPP diff --git a/include/array/GrowableByteArray.hpp b/include/array/GrowableByteArray.hpp new file mode 100644 index 0000000..a06ed27 --- /dev/null +++ b/include/array/GrowableByteArray.hpp @@ -0,0 +1,51 @@ +#ifndef GROWABLEBYTEARRAY_HPP +#define GROWABLEBYTEARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableByteArray{ + + public: + + GrowableByteArray(unsigned int initSize=minmum_capacity); + + unsigned char* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const unsigned char e); + + void set(unsigned index, const unsigned char e); + + void copyFrom(const unsigned char* data, unsigned int count); + + void copyFrom(const unsigned char* data, unsigned int index, unsigned int count); + + void copyFrom(const unsigned char* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + unsigned char get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + ~GrowableByteArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + static const unsigned int minmum_capacity; + +}; + +#endif // GROWABLEBYTEARRAY_HPP diff --git a/include/array/GrowableDoubleArray.hpp b/include/array/GrowableDoubleArray.hpp new file mode 100644 index 0000000..870af17 --- /dev/null +++ b/include/array/GrowableDoubleArray.hpp @@ -0,0 +1,51 @@ +#ifndef GROWABLEDOUBLEARRAY_HPP +#define GROWABLEDOUBLEARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableDoubleArray{ + + public: + + GrowableDoubleArray(unsigned int initSize=minmum_capacity); + + double* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const double e); + + void set(unsigned index, const double e); + + void copyFrom(const double* data, unsigned int count); + + void copyFrom(const double* data, unsigned int index, unsigned int count); + + void copyFrom(const double* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + double get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + ~GrowableDoubleArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + static const unsigned int minmum_capacity; + +}; + +#endif // GROWABLEDOUBLEARRAY_HPP diff --git a/include/array/GrowableFloatArray.hpp b/include/array/GrowableFloatArray.hpp new file mode 100644 index 0000000..b3475c5 --- /dev/null +++ b/include/array/GrowableFloatArray.hpp @@ -0,0 +1,51 @@ +#ifndef GROWABLEFLOATARRAY_HPP +#define GROWABLEFLOATARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableFloatArray{ + + public: + + GrowableFloatArray(unsigned int initSize=minmum_capacity); + + float* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const float e); + + void set(unsigned index, const float e); + + void copyFrom(const float* data, unsigned int count); + + void copyFrom(const float* data, unsigned int index, unsigned int count); + + void copyFrom(const float* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + float get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + ~GrowableFloatArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + static const unsigned int minmum_capacity; + +}; + +#endif // GROWABLEFLOATARRAY_HPP diff --git a/include/array/GrowableIntegerArray.hpp b/include/array/GrowableIntegerArray.hpp new file mode 100644 index 0000000..e9da70c --- /dev/null +++ b/include/array/GrowableIntegerArray.hpp @@ -0,0 +1,51 @@ +#ifndef GROWABLEINTEGERARRAY_HPP +#define GROWABLEINTEGERARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableIntegerArray{ + + public: + + GrowableIntegerArray(unsigned int initSize=minmum_capacity); + + int* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const int e); + + void set(unsigned index, const int e); + + void copyFrom(const int* data, unsigned int count); + + void copyFrom(const int* data, unsigned int index, unsigned int count); + + void copyFrom(const int* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + int get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + ~GrowableIntegerArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + static const unsigned int minmum_capacity; + +}; + +#endif // GROWABLEINTEGERARRAY_HPP diff --git a/include/array/GrowableLongArray.hpp b/include/array/GrowableLongArray.hpp new file mode 100644 index 0000000..7e3e593 --- /dev/null +++ b/include/array/GrowableLongArray.hpp @@ -0,0 +1,52 @@ +#ifndef GROWABLELONGARRAY_HPP +#define GROWABLELONGARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableLongArray{ + + public: + + GrowableLongArray(unsigned int initSize=minmum_capacity); + + long long* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const long long e); + + void set(unsigned index, const long long e); + + void copyFrom(const long long* data, unsigned int count); + + void copyFrom(const long long* data, unsigned int index, unsigned int count); + + void copyFrom(const long long* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + long long get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + ~GrowableLongArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + static const unsigned int minmum_capacity; + +}; + + +#endif // GROWABLELONGARRAY_HPP diff --git a/include/array/GrowableObjectArray.hpp b/include/array/GrowableObjectArray.hpp new file mode 100644 index 0000000..ea81a6a --- /dev/null +++ b/include/array/GrowableObjectArray.hpp @@ -0,0 +1,55 @@ +#ifndef GROWABLEOBJECTARRAY_HPP +#define GROWABLEOBJECTARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableObjectArray{ + + public: + + GrowableObjectArray(unsigned int initSize=minmum_capacity); + + void* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const void* e); + + void set(unsigned index, const void* e); + + void copyFrom(const void* data, unsigned int count); + + void copyFrom(const void* data, unsigned int index, unsigned int count); + + void copyFrom(const void* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + void* get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + void destroyAllObjectOnDelete(unsigned int flag); + + ~GrowableObjectArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + unsigned int destroyFlag=false; + + static const unsigned int minmum_capacity; + +}; + +#endif // GROWABLEOBJECTARRAY_HPP diff --git a/include/array/GrowableShortArray.hpp b/include/array/GrowableShortArray.hpp new file mode 100644 index 0000000..e3f5dff --- /dev/null +++ b/include/array/GrowableShortArray.hpp @@ -0,0 +1,51 @@ +#ifndef GROWABLESHORTARRAY_HPP +#define GROWABLESHORTARRAY_HPP + +#include "include/array/GrowableArray.hpp" + +class GrowableShortArray{ + + public: + + GrowableShortArray(unsigned int initSize=minmum_capacity); + + short* getArrayData(); + + unsigned int capacity(); + + const unsigned int& length=arrlen; + + const unsigned int& element_size=elementSize; + + void put(const short e); + + void set(unsigned index, const short e); + + void copyFrom(const short* data, unsigned int count); + + void copyFrom(const short* data, unsigned int index, unsigned int count); + + void copyFrom(const short* data, unsigned int index, unsigned int bufferOffset, unsigned int count); + + short get(unsigned int index); + + void remove(unsigned int index); + + void gc(); + + void clear(); + + ~GrowableShortArray(); + + private: + + GrowableArray* array; + + unsigned int arrlen; + unsigned int elementSize; + + static const unsigned int minmum_capacity; + +}; + +#endif // GROWABLESHORTARRAY_HPP diff --git a/include/colorspace/SampleUtils.hpp b/include/colorspace/SampleUtils.hpp new file mode 100644 index 0000000..89db4cc --- /dev/null +++ b/include/colorspace/SampleUtils.hpp @@ -0,0 +1,24 @@ +#ifndef SAMPLEUTILS_H +#define SAMPLEUTILS_H + +class SampleUtils{ + + private: + + SampleUtils(); + + public: + + static unsigned char convert1BitTo8Bit(unsigned char color); + + static unsigned char convert2BitTo8Bit(unsigned char color); + + static unsigned char convert4BitTo8Bit(unsigned char color); + + static unsigned char convert16BitTo8Bit(unsigned short color); + + static unsigned int convertRGBtoBrightness(unsigned int color); + +}; + +#endif // SAMPLEUTILS_H diff --git a/include/drfstream/drfstream.hpp b/include/drfstream/drfstream.hpp new file mode 100644 index 0000000..b4c2a73 --- /dev/null +++ b/include/drfstream/drfstream.hpp @@ -0,0 +1,12 @@ +#ifndef EXPORT_HPP +#define EXPORT_HPP + +extern "C"{ + + char* encode(const char* srcData, const unsigned int dataLength, unsigned int* resultLength); + + char* decode(const char* srcData, const unsigned int dataLength, unsigned int* resultLength); + +} + +#endif // EXPORT_HPP diff --git a/include/encoding/CharTableGBK.hpp b/include/encoding/CharTableGBK.hpp new file mode 100644 index 0000000..950b86f --- /dev/null +++ b/include/encoding/CharTableGBK.hpp @@ -0,0 +1,14 @@ +#ifndef CHARTABLEGBK_HPP +#define CHARTABLEGBK_HPP + +class CharTableGBK{ + + public: + + static const unsigned int GBKTable_size=22645; + + static const unsigned short GBKTable[GBKTable_size]; + +}; + +#endif // CHARTABLEGBK_HPP diff --git a/include/encoding/CharTableUTF8.hpp b/include/encoding/CharTableUTF8.hpp new file mode 100644 index 0000000..283dcf6 --- /dev/null +++ b/include/encoding/CharTableUTF8.hpp @@ -0,0 +1,14 @@ +#ifndef CHARTABLEUTF8_HPP +#define CHARTABLEUTF8_HPP + +class CharTableUTF8{ + + public: + + static const unsigned int UTF8Table_size=22645; + + static const unsigned int UTF8Table[UTF8Table_size]; + +}; + +#endif // CHARTABLEUTF8_HPP diff --git a/include/encoding/EncodingUtils.hpp b/include/encoding/EncodingUtils.hpp new file mode 100644 index 0000000..0d516ec --- /dev/null +++ b/include/encoding/EncodingUtils.hpp @@ -0,0 +1,26 @@ +#ifndef ENCODINGUTILS_HPP +#define ENCODINGUTILS_HPP + +class EncodingUtils{ + + public: + + static char* convertUTF8toGBK(const char* str); + + static char* convertGBKtoUTF8(const char* str); + + static unsigned int getUTF8TableSize(); + + static char* getUTF8TableElement(unsigned int index); + + static unsigned int getGBKTableSize(); + + static char* getGBKTableElement(unsigned int index); + + static unsigned int getUTF8CharLength(char header); + + static unsigned int getGBKCharLength(char header); + +}; + +#endif diff --git a/include/memory/Memory.hpp b/include/memory/Memory.hpp new file mode 100644 index 0000000..0312bf3 --- /dev/null +++ b/include/memory/Memory.hpp @@ -0,0 +1,20 @@ +#ifndef MEMORY_HPP +#define MEMORY_HPP + +class Memory{ + + public: + + static void* allocateMemory(unsigned long size); + + static void* allocateExecutableMemory(unsigned long size); + + static void* allocateHugePage(unsigned long size); + + static int setPremission(void* page,unsigned long size, unsigned int permission); + + static int releaseMemory(void* mem, unsigned long size); + +}; + +#endif diff --git a/include/openssl/__DECC_INCLUDE_EPILOGUE.H b/include/openssl/__DECC_INCLUDE_EPILOGUE.H new file mode 100644 index 0000000..c350018 --- /dev/null +++ b/include/openssl/__DECC_INCLUDE_EPILOGUE.H @@ -0,0 +1,16 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This file is only used by HP C on VMS, and is included automatically + * after each header file from this directory + */ + +/* restore state. Must correspond to the save in __decc_include_prologue.h */ +#pragma names restore diff --git a/include/openssl/__DECC_INCLUDE_PROLOGUE.H b/include/openssl/__DECC_INCLUDE_PROLOGUE.H new file mode 100644 index 0000000..9a9c777 --- /dev/null +++ b/include/openssl/__DECC_INCLUDE_PROLOGUE.H @@ -0,0 +1,20 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This file is only used by HP C on VMS, and is included automatically + * after each header file from this directory + */ + +/* save state */ +#pragma names save +/* have the compiler shorten symbols larger than 31 chars to 23 chars + * followed by a 8 hex char CRC + */ +#pragma names as_is,shortened diff --git a/include/openssl/aes.h b/include/openssl/aes.h new file mode 100644 index 0000000..b1a27cb --- /dev/null +++ b/include/openssl/aes.h @@ -0,0 +1,92 @@ +/* + * Copyright 2002-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_AES_H +# define HEADER_AES_H + +# include + +# include +# ifdef __cplusplus +extern "C" { +# endif + +# define AES_ENCRYPT 1 +# define AES_DECRYPT 0 + +/* + * Because array size can't be a const in C, the following two are macros. + * Both sizes are in bytes. + */ +# define AES_MAXNR 14 +# define AES_BLOCK_SIZE 16 + +/* This should be a hidden type, but EVP requires that the size be known */ +struct aes_key_st { +# ifdef AES_LONG + unsigned long rd_key[4 * (AES_MAXNR + 1)]; +# else + unsigned int rd_key[4 * (AES_MAXNR + 1)]; +# endif + int rounds; +}; +typedef struct aes_key_st AES_KEY; + +const char *AES_options(void); + +int AES_set_encrypt_key(const unsigned char *userKey, const int bits, + AES_KEY *key); +int AES_set_decrypt_key(const unsigned char *userKey, const int bits, + AES_KEY *key); + +void AES_encrypt(const unsigned char *in, unsigned char *out, + const AES_KEY *key); +void AES_decrypt(const unsigned char *in, unsigned char *out, + const AES_KEY *key); + +void AES_ecb_encrypt(const unsigned char *in, unsigned char *out, + const AES_KEY *key, const int enc); +void AES_cbc_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const AES_KEY *key, + unsigned char *ivec, const int enc); +void AES_cfb128_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const AES_KEY *key, + unsigned char *ivec, int *num, const int enc); +void AES_cfb1_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const AES_KEY *key, + unsigned char *ivec, int *num, const int enc); +void AES_cfb8_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const AES_KEY *key, + unsigned char *ivec, int *num, const int enc); +void AES_ofb128_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const AES_KEY *key, + unsigned char *ivec, int *num); +/* NB: the IV is _two_ blocks long */ +void AES_ige_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const AES_KEY *key, + unsigned char *ivec, const int enc); +/* NB: the IV is _four_ blocks long */ +void AES_bi_ige_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const AES_KEY *key, + const AES_KEY *key2, const unsigned char *ivec, + const int enc); + +int AES_wrap_key(AES_KEY *key, const unsigned char *iv, + unsigned char *out, + const unsigned char *in, unsigned int inlen); +int AES_unwrap_key(AES_KEY *key, const unsigned char *iv, + unsigned char *out, + const unsigned char *in, unsigned int inlen); + + +# ifdef __cplusplus +} +# endif + +#endif diff --git a/include/openssl/asn1.h b/include/openssl/asn1.h new file mode 100644 index 0000000..9681a27 --- /dev/null +++ b/include/openssl/asn1.h @@ -0,0 +1,886 @@ +/* + * Copyright 1995-2017 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ASN1_H +# define HEADER_ASN1_H + +# include +# include +# include +# include +# include +# include +# include + +# include +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# endif + +# ifdef OPENSSL_BUILD_SHLIBCRYPTO +# undef OPENSSL_EXTERN +# define OPENSSL_EXTERN OPENSSL_EXPORT +# endif + +#ifdef __cplusplus +extern "C" { +#endif + +# define V_ASN1_UNIVERSAL 0x00 +# define V_ASN1_APPLICATION 0x40 +# define V_ASN1_CONTEXT_SPECIFIC 0x80 +# define V_ASN1_PRIVATE 0xc0 + +# define V_ASN1_CONSTRUCTED 0x20 +# define V_ASN1_PRIMITIVE_TAG 0x1f +# define V_ASN1_PRIMATIVE_TAG /*compat*/ V_ASN1_PRIMITIVE_TAG + +# define V_ASN1_APP_CHOOSE -2/* let the recipient choose */ +# define V_ASN1_OTHER -3/* used in ASN1_TYPE */ +# define V_ASN1_ANY -4/* used in ASN1 template code */ + +# define V_ASN1_UNDEF -1 +/* ASN.1 tag values */ +# define V_ASN1_EOC 0 +# define V_ASN1_BOOLEAN 1 /**/ +# define V_ASN1_INTEGER 2 +# define V_ASN1_BIT_STRING 3 +# define V_ASN1_OCTET_STRING 4 +# define V_ASN1_NULL 5 +# define V_ASN1_OBJECT 6 +# define V_ASN1_OBJECT_DESCRIPTOR 7 +# define V_ASN1_EXTERNAL 8 +# define V_ASN1_REAL 9 +# define V_ASN1_ENUMERATED 10 +# define V_ASN1_UTF8STRING 12 +# define V_ASN1_SEQUENCE 16 +# define V_ASN1_SET 17 +# define V_ASN1_NUMERICSTRING 18 /**/ +# define V_ASN1_PRINTABLESTRING 19 +# define V_ASN1_T61STRING 20 +# define V_ASN1_TELETEXSTRING 20/* alias */ +# define V_ASN1_VIDEOTEXSTRING 21 /**/ +# define V_ASN1_IA5STRING 22 +# define V_ASN1_UTCTIME 23 +# define V_ASN1_GENERALIZEDTIME 24 /**/ +# define V_ASN1_GRAPHICSTRING 25 /**/ +# define V_ASN1_ISO64STRING 26 /**/ +# define V_ASN1_VISIBLESTRING 26/* alias */ +# define V_ASN1_GENERALSTRING 27 /**/ +# define V_ASN1_UNIVERSALSTRING 28 /**/ +# define V_ASN1_BMPSTRING 30 + +/* + * NB the constants below are used internally by ASN1_INTEGER + * and ASN1_ENUMERATED to indicate the sign. They are *not* on + * the wire tag values. + */ + +# define V_ASN1_NEG 0x100 +# define V_ASN1_NEG_INTEGER (2 | V_ASN1_NEG) +# define V_ASN1_NEG_ENUMERATED (10 | V_ASN1_NEG) + +/* For use with d2i_ASN1_type_bytes() */ +# define B_ASN1_NUMERICSTRING 0x0001 +# define B_ASN1_PRINTABLESTRING 0x0002 +# define B_ASN1_T61STRING 0x0004 +# define B_ASN1_TELETEXSTRING 0x0004 +# define B_ASN1_VIDEOTEXSTRING 0x0008 +# define B_ASN1_IA5STRING 0x0010 +# define B_ASN1_GRAPHICSTRING 0x0020 +# define B_ASN1_ISO64STRING 0x0040 +# define B_ASN1_VISIBLESTRING 0x0040 +# define B_ASN1_GENERALSTRING 0x0080 +# define B_ASN1_UNIVERSALSTRING 0x0100 +# define B_ASN1_OCTET_STRING 0x0200 +# define B_ASN1_BIT_STRING 0x0400 +# define B_ASN1_BMPSTRING 0x0800 +# define B_ASN1_UNKNOWN 0x1000 +# define B_ASN1_UTF8STRING 0x2000 +# define B_ASN1_UTCTIME 0x4000 +# define B_ASN1_GENERALIZEDTIME 0x8000 +# define B_ASN1_SEQUENCE 0x10000 +/* For use with ASN1_mbstring_copy() */ +# define MBSTRING_FLAG 0x1000 +# define MBSTRING_UTF8 (MBSTRING_FLAG) +# define MBSTRING_ASC (MBSTRING_FLAG|1) +# define MBSTRING_BMP (MBSTRING_FLAG|2) +# define MBSTRING_UNIV (MBSTRING_FLAG|4) +# define SMIME_OLDMIME 0x400 +# define SMIME_CRLFEOL 0x800 +# define SMIME_STREAM 0x1000 + struct X509_algor_st; +DEFINE_STACK_OF(X509_ALGOR) + +# define ASN1_STRING_FLAG_BITS_LEFT 0x08/* Set if 0x07 has bits left value */ +/* + * This indicates that the ASN1_STRING is not a real value but just a place + * holder for the location where indefinite length constructed data should be + * inserted in the memory buffer + */ +# define ASN1_STRING_FLAG_NDEF 0x010 + +/* + * This flag is used by the CMS code to indicate that a string is not + * complete and is a place holder for content when it had all been accessed. + * The flag will be reset when content has been written to it. + */ + +# define ASN1_STRING_FLAG_CONT 0x020 +/* + * This flag is used by ASN1 code to indicate an ASN1_STRING is an MSTRING + * type. + */ +# define ASN1_STRING_FLAG_MSTRING 0x040 +/* String is embedded and only content should be freed */ +# define ASN1_STRING_FLAG_EMBED 0x080 +/* String should be parsed in RFC 5280's time format */ +# define ASN1_STRING_FLAG_X509_TIME 0x100 +/* This is the base type that holds just about everything :-) */ +struct asn1_string_st { + int length; + int type; + unsigned char *data; + /* + * The value of the following field depends on the type being held. It + * is mostly being used for BIT_STRING so if the input data has a + * non-zero 'unused bits' value, it will be handled correctly + */ + long flags; +}; + +/* + * ASN1_ENCODING structure: this is used to save the received encoding of an + * ASN1 type. This is useful to get round problems with invalid encodings + * which can break signatures. + */ + +typedef struct ASN1_ENCODING_st { + unsigned char *enc; /* DER encoding */ + long len; /* Length of encoding */ + int modified; /* set to 1 if 'enc' is invalid */ +} ASN1_ENCODING; + +/* Used with ASN1 LONG type: if a long is set to this it is omitted */ +# define ASN1_LONG_UNDEF 0x7fffffffL + +# define STABLE_FLAGS_MALLOC 0x01 +/* + * A zero passed to ASN1_STRING_TABLE_new_add for the flags is interpreted + * as "don't change" and STABLE_FLAGS_MALLOC is always set. By setting + * STABLE_FLAGS_MALLOC only we can clear the existing value. Use the alias + * STABLE_FLAGS_CLEAR to reflect this. + */ +# define STABLE_FLAGS_CLEAR STABLE_FLAGS_MALLOC +# define STABLE_NO_MASK 0x02 +# define DIRSTRING_TYPE \ + (B_ASN1_PRINTABLESTRING|B_ASN1_T61STRING|B_ASN1_BMPSTRING|B_ASN1_UTF8STRING) +# define PKCS9STRING_TYPE (DIRSTRING_TYPE|B_ASN1_IA5STRING) + +typedef struct asn1_string_table_st { + int nid; + long minsize; + long maxsize; + unsigned long mask; + unsigned long flags; +} ASN1_STRING_TABLE; + +DEFINE_STACK_OF(ASN1_STRING_TABLE) + +/* size limits: this stuff is taken straight from RFC2459 */ + +# define ub_name 32768 +# define ub_common_name 64 +# define ub_locality_name 128 +# define ub_state_name 128 +# define ub_organization_name 64 +# define ub_organization_unit_name 64 +# define ub_title 64 +# define ub_email_address 128 + +/* + * Declarations for template structures: for full definitions see asn1t.h + */ +typedef struct ASN1_TEMPLATE_st ASN1_TEMPLATE; +typedef struct ASN1_TLC_st ASN1_TLC; +/* This is just an opaque pointer */ +typedef struct ASN1_VALUE_st ASN1_VALUE; + +/* Declare ASN1 functions: the implement macro in in asn1t.h */ + +# define DECLARE_ASN1_FUNCTIONS(type) DECLARE_ASN1_FUNCTIONS_name(type, type) + +# define DECLARE_ASN1_ALLOC_FUNCTIONS(type) \ + DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, type) + +# define DECLARE_ASN1_FUNCTIONS_name(type, name) \ + DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \ + DECLARE_ASN1_ENCODE_FUNCTIONS(type, name, name) + +# define DECLARE_ASN1_FUNCTIONS_fname(type, itname, name) \ + DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \ + DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) + +# define DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) \ + type *d2i_##name(type **a, const unsigned char **in, long len); \ + int i2d_##name(type *a, unsigned char **out); \ + DECLARE_ASN1_ITEM(itname) + +# define DECLARE_ASN1_ENCODE_FUNCTIONS_const(type, name) \ + type *d2i_##name(type **a, const unsigned char **in, long len); \ + int i2d_##name(const type *a, unsigned char **out); \ + DECLARE_ASN1_ITEM(name) + +# define DECLARE_ASN1_NDEF_FUNCTION(name) \ + int i2d_##name##_NDEF(name *a, unsigned char **out); + +# define DECLARE_ASN1_FUNCTIONS_const(name) \ + DECLARE_ASN1_ALLOC_FUNCTIONS(name) \ + DECLARE_ASN1_ENCODE_FUNCTIONS_const(name, name) + +# define DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \ + type *name##_new(void); \ + void name##_free(type *a); + +# define DECLARE_ASN1_PRINT_FUNCTION(stname) \ + DECLARE_ASN1_PRINT_FUNCTION_fname(stname, stname) + +# define DECLARE_ASN1_PRINT_FUNCTION_fname(stname, fname) \ + int fname##_print_ctx(BIO *out, stname *x, int indent, \ + const ASN1_PCTX *pctx); + +# define D2I_OF(type) type *(*)(type **,const unsigned char **,long) +# define I2D_OF(type) int (*)(type *,unsigned char **) +# define I2D_OF_const(type) int (*)(const type *,unsigned char **) + +# define CHECKED_D2I_OF(type, d2i) \ + ((d2i_of_void*) (1 ? d2i : ((D2I_OF(type))0))) +# define CHECKED_I2D_OF(type, i2d) \ + ((i2d_of_void*) (1 ? i2d : ((I2D_OF(type))0))) +# define CHECKED_NEW_OF(type, xnew) \ + ((void *(*)(void)) (1 ? xnew : ((type *(*)(void))0))) +# define CHECKED_PTR_OF(type, p) \ + ((void*) (1 ? p : (type*)0)) +# define CHECKED_PPTR_OF(type, p) \ + ((void**) (1 ? p : (type**)0)) + +# define TYPEDEF_D2I_OF(type) typedef type *d2i_of_##type(type **,const unsigned char **,long) +# define TYPEDEF_I2D_OF(type) typedef int i2d_of_##type(type *,unsigned char **) +# define TYPEDEF_D2I2D_OF(type) TYPEDEF_D2I_OF(type); TYPEDEF_I2D_OF(type) + +TYPEDEF_D2I2D_OF(void); + +/*- + * The following macros and typedefs allow an ASN1_ITEM + * to be embedded in a structure and referenced. Since + * the ASN1_ITEM pointers need to be globally accessible + * (possibly from shared libraries) they may exist in + * different forms. On platforms that support it the + * ASN1_ITEM structure itself will be globally exported. + * Other platforms will export a function that returns + * an ASN1_ITEM pointer. + * + * To handle both cases transparently the macros below + * should be used instead of hard coding an ASN1_ITEM + * pointer in a structure. + * + * The structure will look like this: + * + * typedef struct SOMETHING_st { + * ... + * ASN1_ITEM_EXP *iptr; + * ... + * } SOMETHING; + * + * It would be initialised as e.g.: + * + * SOMETHING somevar = {...,ASN1_ITEM_ref(X509),...}; + * + * and the actual pointer extracted with: + * + * const ASN1_ITEM *it = ASN1_ITEM_ptr(somevar.iptr); + * + * Finally an ASN1_ITEM pointer can be extracted from an + * appropriate reference with: ASN1_ITEM_rptr(X509). This + * would be used when a function takes an ASN1_ITEM * argument. + * + */ + +# ifndef OPENSSL_EXPORT_VAR_AS_FUNCTION + +/* ASN1_ITEM pointer exported type */ +typedef const ASN1_ITEM ASN1_ITEM_EXP; + +/* Macro to obtain ASN1_ITEM pointer from exported type */ +# define ASN1_ITEM_ptr(iptr) (iptr) + +/* Macro to include ASN1_ITEM pointer from base type */ +# define ASN1_ITEM_ref(iptr) (&(iptr##_it)) + +# define ASN1_ITEM_rptr(ref) (&(ref##_it)) + +# define DECLARE_ASN1_ITEM(name) \ + OPENSSL_EXTERN const ASN1_ITEM name##_it; + +# else + +/* + * Platforms that can't easily handle shared global variables are declared as + * functions returning ASN1_ITEM pointers. + */ + +/* ASN1_ITEM pointer exported type */ +typedef const ASN1_ITEM *ASN1_ITEM_EXP (void); + +/* Macro to obtain ASN1_ITEM pointer from exported type */ +# define ASN1_ITEM_ptr(iptr) (iptr()) + +/* Macro to include ASN1_ITEM pointer from base type */ +# define ASN1_ITEM_ref(iptr) (iptr##_it) + +# define ASN1_ITEM_rptr(ref) (ref##_it()) + +# define DECLARE_ASN1_ITEM(name) \ + const ASN1_ITEM * name##_it(void); + +# endif + +/* Parameters used by ASN1_STRING_print_ex() */ + +/* + * These determine which characters to escape: RFC2253 special characters, + * control characters and MSB set characters + */ + +# define ASN1_STRFLGS_ESC_2253 1 +# define ASN1_STRFLGS_ESC_CTRL 2 +# define ASN1_STRFLGS_ESC_MSB 4 + +/* + * This flag determines how we do escaping: normally RC2253 backslash only, + * set this to use backslash and quote. + */ + +# define ASN1_STRFLGS_ESC_QUOTE 8 + +/* These three flags are internal use only. */ + +/* Character is a valid PrintableString character */ +# define CHARTYPE_PRINTABLESTRING 0x10 +/* Character needs escaping if it is the first character */ +# define CHARTYPE_FIRST_ESC_2253 0x20 +/* Character needs escaping if it is the last character */ +# define CHARTYPE_LAST_ESC_2253 0x40 + +/* + * NB the internal flags are safely reused below by flags handled at the top + * level. + */ + +/* + * If this is set we convert all character strings to UTF8 first + */ + +# define ASN1_STRFLGS_UTF8_CONVERT 0x10 + +/* + * If this is set we don't attempt to interpret content: just assume all + * strings are 1 byte per character. This will produce some pretty odd + * looking output! + */ + +# define ASN1_STRFLGS_IGNORE_TYPE 0x20 + +/* If this is set we include the string type in the output */ +# define ASN1_STRFLGS_SHOW_TYPE 0x40 + +/* + * This determines which strings to display and which to 'dump' (hex dump of + * content octets or DER encoding). We can only dump non character strings or + * everything. If we don't dump 'unknown' they are interpreted as character + * strings with 1 octet per character and are subject to the usual escaping + * options. + */ + +# define ASN1_STRFLGS_DUMP_ALL 0x80 +# define ASN1_STRFLGS_DUMP_UNKNOWN 0x100 + +/* + * These determine what 'dumping' does, we can dump the content octets or the + * DER encoding: both use the RFC2253 #XXXXX notation. + */ + +# define ASN1_STRFLGS_DUMP_DER 0x200 + +/* + * This flag specifies that RC2254 escaping shall be performed. + */ +#define ASN1_STRFLGS_ESC_2254 0x400 + +/* + * All the string flags consistent with RFC2253, escaping control characters + * isn't essential in RFC2253 but it is advisable anyway. + */ + +# define ASN1_STRFLGS_RFC2253 (ASN1_STRFLGS_ESC_2253 | \ + ASN1_STRFLGS_ESC_CTRL | \ + ASN1_STRFLGS_ESC_MSB | \ + ASN1_STRFLGS_UTF8_CONVERT | \ + ASN1_STRFLGS_DUMP_UNKNOWN | \ + ASN1_STRFLGS_DUMP_DER) + +DEFINE_STACK_OF(ASN1_INTEGER) + +DEFINE_STACK_OF(ASN1_GENERALSTRING) + +DEFINE_STACK_OF(ASN1_UTF8STRING) + +typedef struct asn1_type_st { + int type; + union { + char *ptr; + ASN1_BOOLEAN boolean; + ASN1_STRING *asn1_string; + ASN1_OBJECT *object; + ASN1_INTEGER *integer; + ASN1_ENUMERATED *enumerated; + ASN1_BIT_STRING *bit_string; + ASN1_OCTET_STRING *octet_string; + ASN1_PRINTABLESTRING *printablestring; + ASN1_T61STRING *t61string; + ASN1_IA5STRING *ia5string; + ASN1_GENERALSTRING *generalstring; + ASN1_BMPSTRING *bmpstring; + ASN1_UNIVERSALSTRING *universalstring; + ASN1_UTCTIME *utctime; + ASN1_GENERALIZEDTIME *generalizedtime; + ASN1_VISIBLESTRING *visiblestring; + ASN1_UTF8STRING *utf8string; + /* + * set and sequence are left complete and still contain the set or + * sequence bytes + */ + ASN1_STRING *set; + ASN1_STRING *sequence; + ASN1_VALUE *asn1_value; + } value; +} ASN1_TYPE; + +DEFINE_STACK_OF(ASN1_TYPE) + +typedef STACK_OF(ASN1_TYPE) ASN1_SEQUENCE_ANY; + +DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SEQUENCE_ANY) +DECLARE_ASN1_ENCODE_FUNCTIONS_const(ASN1_SEQUENCE_ANY, ASN1_SET_ANY) + +/* This is used to contain a list of bit names */ +typedef struct BIT_STRING_BITNAME_st { + int bitnum; + const char *lname; + const char *sname; +} BIT_STRING_BITNAME; + +# define B_ASN1_TIME \ + B_ASN1_UTCTIME | \ + B_ASN1_GENERALIZEDTIME + +# define B_ASN1_PRINTABLE \ + B_ASN1_NUMERICSTRING| \ + B_ASN1_PRINTABLESTRING| \ + B_ASN1_T61STRING| \ + B_ASN1_IA5STRING| \ + B_ASN1_BIT_STRING| \ + B_ASN1_UNIVERSALSTRING|\ + B_ASN1_BMPSTRING|\ + B_ASN1_UTF8STRING|\ + B_ASN1_SEQUENCE|\ + B_ASN1_UNKNOWN + +# define B_ASN1_DIRECTORYSTRING \ + B_ASN1_PRINTABLESTRING| \ + B_ASN1_TELETEXSTRING|\ + B_ASN1_BMPSTRING|\ + B_ASN1_UNIVERSALSTRING|\ + B_ASN1_UTF8STRING + +# define B_ASN1_DISPLAYTEXT \ + B_ASN1_IA5STRING| \ + B_ASN1_VISIBLESTRING| \ + B_ASN1_BMPSTRING|\ + B_ASN1_UTF8STRING + +DECLARE_ASN1_FUNCTIONS_fname(ASN1_TYPE, ASN1_ANY, ASN1_TYPE) + +int ASN1_TYPE_get(const ASN1_TYPE *a); +void ASN1_TYPE_set(ASN1_TYPE *a, int type, void *value); +int ASN1_TYPE_set1(ASN1_TYPE *a, int type, const void *value); +int ASN1_TYPE_cmp(const ASN1_TYPE *a, const ASN1_TYPE *b); + +ASN1_TYPE *ASN1_TYPE_pack_sequence(const ASN1_ITEM *it, void *s, ASN1_TYPE **t); +void *ASN1_TYPE_unpack_sequence(const ASN1_ITEM *it, const ASN1_TYPE *t); + +ASN1_OBJECT *ASN1_OBJECT_new(void); +void ASN1_OBJECT_free(ASN1_OBJECT *a); +int i2d_ASN1_OBJECT(const ASN1_OBJECT *a, unsigned char **pp); +ASN1_OBJECT *d2i_ASN1_OBJECT(ASN1_OBJECT **a, const unsigned char **pp, + long length); + +DECLARE_ASN1_ITEM(ASN1_OBJECT) + +DEFINE_STACK_OF(ASN1_OBJECT) + +ASN1_STRING *ASN1_STRING_new(void); +void ASN1_STRING_free(ASN1_STRING *a); +void ASN1_STRING_clear_free(ASN1_STRING *a); +int ASN1_STRING_copy(ASN1_STRING *dst, const ASN1_STRING *str); +ASN1_STRING *ASN1_STRING_dup(const ASN1_STRING *a); +ASN1_STRING *ASN1_STRING_type_new(int type); +int ASN1_STRING_cmp(const ASN1_STRING *a, const ASN1_STRING *b); + /* + * Since this is used to store all sorts of things, via macros, for now, + * make its data void * + */ +int ASN1_STRING_set(ASN1_STRING *str, const void *data, int len); +void ASN1_STRING_set0(ASN1_STRING *str, void *data, int len); +int ASN1_STRING_length(const ASN1_STRING *x); +void ASN1_STRING_length_set(ASN1_STRING *x, int n); +int ASN1_STRING_type(const ASN1_STRING *x); +DEPRECATEDIN_1_1_0(unsigned char *ASN1_STRING_data(ASN1_STRING *x)) +const unsigned char *ASN1_STRING_get0_data(const ASN1_STRING *x); + +DECLARE_ASN1_FUNCTIONS(ASN1_BIT_STRING) +int ASN1_BIT_STRING_set(ASN1_BIT_STRING *a, unsigned char *d, int length); +int ASN1_BIT_STRING_set_bit(ASN1_BIT_STRING *a, int n, int value); +int ASN1_BIT_STRING_get_bit(const ASN1_BIT_STRING *a, int n); +int ASN1_BIT_STRING_check(const ASN1_BIT_STRING *a, + const unsigned char *flags, int flags_len); + +int ASN1_BIT_STRING_name_print(BIO *out, ASN1_BIT_STRING *bs, + BIT_STRING_BITNAME *tbl, int indent); +int ASN1_BIT_STRING_num_asc(const char *name, BIT_STRING_BITNAME *tbl); +int ASN1_BIT_STRING_set_asc(ASN1_BIT_STRING *bs, const char *name, int value, + BIT_STRING_BITNAME *tbl); + +DECLARE_ASN1_FUNCTIONS(ASN1_INTEGER) +ASN1_INTEGER *d2i_ASN1_UINTEGER(ASN1_INTEGER **a, const unsigned char **pp, + long length); +ASN1_INTEGER *ASN1_INTEGER_dup(const ASN1_INTEGER *x); +int ASN1_INTEGER_cmp(const ASN1_INTEGER *x, const ASN1_INTEGER *y); + +DECLARE_ASN1_FUNCTIONS(ASN1_ENUMERATED) + +int ASN1_UTCTIME_check(const ASN1_UTCTIME *a); +ASN1_UTCTIME *ASN1_UTCTIME_set(ASN1_UTCTIME *s, time_t t); +ASN1_UTCTIME *ASN1_UTCTIME_adj(ASN1_UTCTIME *s, time_t t, + int offset_day, long offset_sec); +int ASN1_UTCTIME_set_string(ASN1_UTCTIME *s, const char *str); +int ASN1_UTCTIME_cmp_time_t(const ASN1_UTCTIME *s, time_t t); + +int ASN1_GENERALIZEDTIME_check(const ASN1_GENERALIZEDTIME *a); +ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_set(ASN1_GENERALIZEDTIME *s, + time_t t); +ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_adj(ASN1_GENERALIZEDTIME *s, + time_t t, int offset_day, + long offset_sec); +int ASN1_GENERALIZEDTIME_set_string(ASN1_GENERALIZEDTIME *s, const char *str); + +int ASN1_TIME_diff(int *pday, int *psec, + const ASN1_TIME *from, const ASN1_TIME *to); + +DECLARE_ASN1_FUNCTIONS(ASN1_OCTET_STRING) +ASN1_OCTET_STRING *ASN1_OCTET_STRING_dup(const ASN1_OCTET_STRING *a); +int ASN1_OCTET_STRING_cmp(const ASN1_OCTET_STRING *a, + const ASN1_OCTET_STRING *b); +int ASN1_OCTET_STRING_set(ASN1_OCTET_STRING *str, const unsigned char *data, + int len); + +DECLARE_ASN1_FUNCTIONS(ASN1_VISIBLESTRING) +DECLARE_ASN1_FUNCTIONS(ASN1_UNIVERSALSTRING) +DECLARE_ASN1_FUNCTIONS(ASN1_UTF8STRING) +DECLARE_ASN1_FUNCTIONS(ASN1_NULL) +DECLARE_ASN1_FUNCTIONS(ASN1_BMPSTRING) + +int UTF8_getc(const unsigned char *str, int len, unsigned long *val); +int UTF8_putc(unsigned char *str, int len, unsigned long value); + +DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, ASN1_PRINTABLE) + +DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DIRECTORYSTRING) +DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DISPLAYTEXT) +DECLARE_ASN1_FUNCTIONS(ASN1_PRINTABLESTRING) +DECLARE_ASN1_FUNCTIONS(ASN1_T61STRING) +DECLARE_ASN1_FUNCTIONS(ASN1_IA5STRING) +DECLARE_ASN1_FUNCTIONS(ASN1_GENERALSTRING) +DECLARE_ASN1_FUNCTIONS(ASN1_UTCTIME) +DECLARE_ASN1_FUNCTIONS(ASN1_GENERALIZEDTIME) +DECLARE_ASN1_FUNCTIONS(ASN1_TIME) + +DECLARE_ASN1_ITEM(ASN1_OCTET_STRING_NDEF) + +ASN1_TIME *ASN1_TIME_set(ASN1_TIME *s, time_t t); +ASN1_TIME *ASN1_TIME_adj(ASN1_TIME *s, time_t t, + int offset_day, long offset_sec); +int ASN1_TIME_check(const ASN1_TIME *t); +ASN1_GENERALIZEDTIME *ASN1_TIME_to_generalizedtime(const ASN1_TIME *t, + ASN1_GENERALIZEDTIME **out); +int ASN1_TIME_set_string(ASN1_TIME *s, const char *str); +int ASN1_TIME_set_string_X509(ASN1_TIME *s, const char *str); +int ASN1_TIME_to_tm(const ASN1_TIME *s, struct tm *tm); +int ASN1_TIME_normalize(ASN1_TIME *s); +int ASN1_TIME_cmp_time_t(const ASN1_TIME *s, time_t t); +int ASN1_TIME_compare(const ASN1_TIME *a, const ASN1_TIME *b); + +int i2a_ASN1_INTEGER(BIO *bp, const ASN1_INTEGER *a); +int a2i_ASN1_INTEGER(BIO *bp, ASN1_INTEGER *bs, char *buf, int size); +int i2a_ASN1_ENUMERATED(BIO *bp, const ASN1_ENUMERATED *a); +int a2i_ASN1_ENUMERATED(BIO *bp, ASN1_ENUMERATED *bs, char *buf, int size); +int i2a_ASN1_OBJECT(BIO *bp, const ASN1_OBJECT *a); +int a2i_ASN1_STRING(BIO *bp, ASN1_STRING *bs, char *buf, int size); +int i2a_ASN1_STRING(BIO *bp, const ASN1_STRING *a, int type); +int i2t_ASN1_OBJECT(char *buf, int buf_len, const ASN1_OBJECT *a); + +int a2d_ASN1_OBJECT(unsigned char *out, int olen, const char *buf, int num); +ASN1_OBJECT *ASN1_OBJECT_create(int nid, unsigned char *data, int len, + const char *sn, const char *ln); + +int ASN1_INTEGER_get_int64(int64_t *pr, const ASN1_INTEGER *a); +int ASN1_INTEGER_set_int64(ASN1_INTEGER *a, int64_t r); +int ASN1_INTEGER_get_uint64(uint64_t *pr, const ASN1_INTEGER *a); +int ASN1_INTEGER_set_uint64(ASN1_INTEGER *a, uint64_t r); + +int ASN1_INTEGER_set(ASN1_INTEGER *a, long v); +long ASN1_INTEGER_get(const ASN1_INTEGER *a); +ASN1_INTEGER *BN_to_ASN1_INTEGER(const BIGNUM *bn, ASN1_INTEGER *ai); +BIGNUM *ASN1_INTEGER_to_BN(const ASN1_INTEGER *ai, BIGNUM *bn); + +int ASN1_ENUMERATED_get_int64(int64_t *pr, const ASN1_ENUMERATED *a); +int ASN1_ENUMERATED_set_int64(ASN1_ENUMERATED *a, int64_t r); + + +int ASN1_ENUMERATED_set(ASN1_ENUMERATED *a, long v); +long ASN1_ENUMERATED_get(const ASN1_ENUMERATED *a); +ASN1_ENUMERATED *BN_to_ASN1_ENUMERATED(const BIGNUM *bn, ASN1_ENUMERATED *ai); +BIGNUM *ASN1_ENUMERATED_to_BN(const ASN1_ENUMERATED *ai, BIGNUM *bn); + +/* General */ +/* given a string, return the correct type, max is the maximum length */ +int ASN1_PRINTABLE_type(const unsigned char *s, int max); + +unsigned long ASN1_tag2bit(int tag); + +/* SPECIALS */ +int ASN1_get_object(const unsigned char **pp, long *plength, int *ptag, + int *pclass, long omax); +int ASN1_check_infinite_end(unsigned char **p, long len); +int ASN1_const_check_infinite_end(const unsigned char **p, long len); +void ASN1_put_object(unsigned char **pp, int constructed, int length, + int tag, int xclass); +int ASN1_put_eoc(unsigned char **pp); +int ASN1_object_size(int constructed, int length, int tag); + +/* Used to implement other functions */ +void *ASN1_dup(i2d_of_void *i2d, d2i_of_void *d2i, void *x); + +# define ASN1_dup_of(type,i2d,d2i,x) \ + ((type*)ASN1_dup(CHECKED_I2D_OF(type, i2d), \ + CHECKED_D2I_OF(type, d2i), \ + CHECKED_PTR_OF(type, x))) + +# define ASN1_dup_of_const(type,i2d,d2i,x) \ + ((type*)ASN1_dup(CHECKED_I2D_OF(const type, i2d), \ + CHECKED_D2I_OF(type, d2i), \ + CHECKED_PTR_OF(const type, x))) + +void *ASN1_item_dup(const ASN1_ITEM *it, void *x); + +/* ASN1 alloc/free macros for when a type is only used internally */ + +# define M_ASN1_new_of(type) (type *)ASN1_item_new(ASN1_ITEM_rptr(type)) +# define M_ASN1_free_of(x, type) \ + ASN1_item_free(CHECKED_PTR_OF(type, x), ASN1_ITEM_rptr(type)) + +# ifndef OPENSSL_NO_STDIO +void *ASN1_d2i_fp(void *(*xnew) (void), d2i_of_void *d2i, FILE *in, void **x); + +# define ASN1_d2i_fp_of(type,xnew,d2i,in,x) \ + ((type*)ASN1_d2i_fp(CHECKED_NEW_OF(type, xnew), \ + CHECKED_D2I_OF(type, d2i), \ + in, \ + CHECKED_PPTR_OF(type, x))) + +void *ASN1_item_d2i_fp(const ASN1_ITEM *it, FILE *in, void *x); +int ASN1_i2d_fp(i2d_of_void *i2d, FILE *out, void *x); + +# define ASN1_i2d_fp_of(type,i2d,out,x) \ + (ASN1_i2d_fp(CHECKED_I2D_OF(type, i2d), \ + out, \ + CHECKED_PTR_OF(type, x))) + +# define ASN1_i2d_fp_of_const(type,i2d,out,x) \ + (ASN1_i2d_fp(CHECKED_I2D_OF(const type, i2d), \ + out, \ + CHECKED_PTR_OF(const type, x))) + +int ASN1_item_i2d_fp(const ASN1_ITEM *it, FILE *out, void *x); +int ASN1_STRING_print_ex_fp(FILE *fp, const ASN1_STRING *str, unsigned long flags); +# endif + +int ASN1_STRING_to_UTF8(unsigned char **out, const ASN1_STRING *in); + +void *ASN1_d2i_bio(void *(*xnew) (void), d2i_of_void *d2i, BIO *in, void **x); + +# define ASN1_d2i_bio_of(type,xnew,d2i,in,x) \ + ((type*)ASN1_d2i_bio( CHECKED_NEW_OF(type, xnew), \ + CHECKED_D2I_OF(type, d2i), \ + in, \ + CHECKED_PPTR_OF(type, x))) + +void *ASN1_item_d2i_bio(const ASN1_ITEM *it, BIO *in, void *x); +int ASN1_i2d_bio(i2d_of_void *i2d, BIO *out, unsigned char *x); + +# define ASN1_i2d_bio_of(type,i2d,out,x) \ + (ASN1_i2d_bio(CHECKED_I2D_OF(type, i2d), \ + out, \ + CHECKED_PTR_OF(type, x))) + +# define ASN1_i2d_bio_of_const(type,i2d,out,x) \ + (ASN1_i2d_bio(CHECKED_I2D_OF(const type, i2d), \ + out, \ + CHECKED_PTR_OF(const type, x))) + +int ASN1_item_i2d_bio(const ASN1_ITEM *it, BIO *out, void *x); +int ASN1_UTCTIME_print(BIO *fp, const ASN1_UTCTIME *a); +int ASN1_GENERALIZEDTIME_print(BIO *fp, const ASN1_GENERALIZEDTIME *a); +int ASN1_TIME_print(BIO *fp, const ASN1_TIME *a); +int ASN1_STRING_print(BIO *bp, const ASN1_STRING *v); +int ASN1_STRING_print_ex(BIO *out, const ASN1_STRING *str, unsigned long flags); +int ASN1_buf_print(BIO *bp, const unsigned char *buf, size_t buflen, int off); +int ASN1_bn_print(BIO *bp, const char *number, const BIGNUM *num, + unsigned char *buf, int off); +int ASN1_parse(BIO *bp, const unsigned char *pp, long len, int indent); +int ASN1_parse_dump(BIO *bp, const unsigned char *pp, long len, int indent, + int dump); +const char *ASN1_tag2str(int tag); + +/* Used to load and write Netscape format cert */ + +int ASN1_UNIVERSALSTRING_to_string(ASN1_UNIVERSALSTRING *s); + +int ASN1_TYPE_set_octetstring(ASN1_TYPE *a, unsigned char *data, int len); +int ASN1_TYPE_get_octetstring(const ASN1_TYPE *a, unsigned char *data, int max_len); +int ASN1_TYPE_set_int_octetstring(ASN1_TYPE *a, long num, + unsigned char *data, int len); +int ASN1_TYPE_get_int_octetstring(const ASN1_TYPE *a, long *num, + unsigned char *data, int max_len); + +void *ASN1_item_unpack(const ASN1_STRING *oct, const ASN1_ITEM *it); + +ASN1_STRING *ASN1_item_pack(void *obj, const ASN1_ITEM *it, + ASN1_OCTET_STRING **oct); + +void ASN1_STRING_set_default_mask(unsigned long mask); +int ASN1_STRING_set_default_mask_asc(const char *p); +unsigned long ASN1_STRING_get_default_mask(void); +int ASN1_mbstring_copy(ASN1_STRING **out, const unsigned char *in, int len, + int inform, unsigned long mask); +int ASN1_mbstring_ncopy(ASN1_STRING **out, const unsigned char *in, int len, + int inform, unsigned long mask, + long minsize, long maxsize); + +ASN1_STRING *ASN1_STRING_set_by_NID(ASN1_STRING **out, + const unsigned char *in, int inlen, + int inform, int nid); +ASN1_STRING_TABLE *ASN1_STRING_TABLE_get(int nid); +int ASN1_STRING_TABLE_add(int, long, long, unsigned long, unsigned long); +void ASN1_STRING_TABLE_cleanup(void); + +/* ASN1 template functions */ + +/* Old API compatible functions */ +ASN1_VALUE *ASN1_item_new(const ASN1_ITEM *it); +void ASN1_item_free(ASN1_VALUE *val, const ASN1_ITEM *it); +ASN1_VALUE *ASN1_item_d2i(ASN1_VALUE **val, const unsigned char **in, + long len, const ASN1_ITEM *it); +int ASN1_item_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it); +int ASN1_item_ndef_i2d(ASN1_VALUE *val, unsigned char **out, + const ASN1_ITEM *it); + +void ASN1_add_oid_module(void); +void ASN1_add_stable_module(void); + +ASN1_TYPE *ASN1_generate_nconf(const char *str, CONF *nconf); +ASN1_TYPE *ASN1_generate_v3(const char *str, X509V3_CTX *cnf); +int ASN1_str2mask(const char *str, unsigned long *pmask); + +/* ASN1 Print flags */ + +/* Indicate missing OPTIONAL fields */ +# define ASN1_PCTX_FLAGS_SHOW_ABSENT 0x001 +/* Mark start and end of SEQUENCE */ +# define ASN1_PCTX_FLAGS_SHOW_SEQUENCE 0x002 +/* Mark start and end of SEQUENCE/SET OF */ +# define ASN1_PCTX_FLAGS_SHOW_SSOF 0x004 +/* Show the ASN1 type of primitives */ +# define ASN1_PCTX_FLAGS_SHOW_TYPE 0x008 +/* Don't show ASN1 type of ANY */ +# define ASN1_PCTX_FLAGS_NO_ANY_TYPE 0x010 +/* Don't show ASN1 type of MSTRINGs */ +# define ASN1_PCTX_FLAGS_NO_MSTRING_TYPE 0x020 +/* Don't show field names in SEQUENCE */ +# define ASN1_PCTX_FLAGS_NO_FIELD_NAME 0x040 +/* Show structure names of each SEQUENCE field */ +# define ASN1_PCTX_FLAGS_SHOW_FIELD_STRUCT_NAME 0x080 +/* Don't show structure name even at top level */ +# define ASN1_PCTX_FLAGS_NO_STRUCT_NAME 0x100 + +int ASN1_item_print(BIO *out, ASN1_VALUE *ifld, int indent, + const ASN1_ITEM *it, const ASN1_PCTX *pctx); +ASN1_PCTX *ASN1_PCTX_new(void); +void ASN1_PCTX_free(ASN1_PCTX *p); +unsigned long ASN1_PCTX_get_flags(const ASN1_PCTX *p); +void ASN1_PCTX_set_flags(ASN1_PCTX *p, unsigned long flags); +unsigned long ASN1_PCTX_get_nm_flags(const ASN1_PCTX *p); +void ASN1_PCTX_set_nm_flags(ASN1_PCTX *p, unsigned long flags); +unsigned long ASN1_PCTX_get_cert_flags(const ASN1_PCTX *p); +void ASN1_PCTX_set_cert_flags(ASN1_PCTX *p, unsigned long flags); +unsigned long ASN1_PCTX_get_oid_flags(const ASN1_PCTX *p); +void ASN1_PCTX_set_oid_flags(ASN1_PCTX *p, unsigned long flags); +unsigned long ASN1_PCTX_get_str_flags(const ASN1_PCTX *p); +void ASN1_PCTX_set_str_flags(ASN1_PCTX *p, unsigned long flags); + +ASN1_SCTX *ASN1_SCTX_new(int (*scan_cb) (ASN1_SCTX *ctx)); +void ASN1_SCTX_free(ASN1_SCTX *p); +const ASN1_ITEM *ASN1_SCTX_get_item(ASN1_SCTX *p); +const ASN1_TEMPLATE *ASN1_SCTX_get_template(ASN1_SCTX *p); +unsigned long ASN1_SCTX_get_flags(ASN1_SCTX *p); +void ASN1_SCTX_set_app_data(ASN1_SCTX *p, void *data); +void *ASN1_SCTX_get_app_data(ASN1_SCTX *p); + +const BIO_METHOD *BIO_f_asn1(void); + +BIO *BIO_new_NDEF(BIO *out, ASN1_VALUE *val, const ASN1_ITEM *it); + +int i2d_ASN1_bio_stream(BIO *out, ASN1_VALUE *val, BIO *in, int flags, + const ASN1_ITEM *it); +int PEM_write_bio_ASN1_stream(BIO *out, ASN1_VALUE *val, BIO *in, int flags, + const char *hdr, const ASN1_ITEM *it); +int SMIME_write_ASN1(BIO *bio, ASN1_VALUE *val, BIO *data, int flags, + int ctype_nid, int econt_nid, + STACK_OF(X509_ALGOR) *mdalgs, const ASN1_ITEM *it); +ASN1_VALUE *SMIME_read_ASN1(BIO *bio, BIO **bcont, const ASN1_ITEM *it); +int SMIME_crlf_copy(BIO *in, BIO *out, int flags); +int SMIME_text(BIO *in, BIO *out); + +const ASN1_ITEM *ASN1_ITEM_lookup(const char *name); +const ASN1_ITEM *ASN1_ITEM_get(size_t i); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/asn1_mac.h b/include/openssl/asn1_mac.h new file mode 100644 index 0000000..7ac1782 --- /dev/null +++ b/include/openssl/asn1_mac.h @@ -0,0 +1,10 @@ +/* + * Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#error "This file is obsolete; please update your software." diff --git a/include/openssl/asn1err.h b/include/openssl/asn1err.h new file mode 100644 index 0000000..5a91126 --- /dev/null +++ b/include/openssl/asn1err.h @@ -0,0 +1,252 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ASN1ERR_H +# define HEADER_ASN1ERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_ASN1_strings(void); + +/* + * ASN1 function codes. + */ +# define ASN1_F_A2D_ASN1_OBJECT 100 +# define ASN1_F_A2I_ASN1_INTEGER 102 +# define ASN1_F_A2I_ASN1_STRING 103 +# define ASN1_F_APPEND_EXP 176 +# define ASN1_F_ASN1_BIO_INIT 113 +# define ASN1_F_ASN1_BIT_STRING_SET_BIT 183 +# define ASN1_F_ASN1_CB 177 +# define ASN1_F_ASN1_CHECK_TLEN 104 +# define ASN1_F_ASN1_COLLECT 106 +# define ASN1_F_ASN1_D2I_EX_PRIMITIVE 108 +# define ASN1_F_ASN1_D2I_FP 109 +# define ASN1_F_ASN1_D2I_READ_BIO 107 +# define ASN1_F_ASN1_DIGEST 184 +# define ASN1_F_ASN1_DO_ADB 110 +# define ASN1_F_ASN1_DO_LOCK 233 +# define ASN1_F_ASN1_DUP 111 +# define ASN1_F_ASN1_ENC_SAVE 115 +# define ASN1_F_ASN1_EX_C2I 204 +# define ASN1_F_ASN1_FIND_END 190 +# define ASN1_F_ASN1_GENERALIZEDTIME_ADJ 216 +# define ASN1_F_ASN1_GENERATE_V3 178 +# define ASN1_F_ASN1_GET_INT64 224 +# define ASN1_F_ASN1_GET_OBJECT 114 +# define ASN1_F_ASN1_GET_UINT64 225 +# define ASN1_F_ASN1_I2D_BIO 116 +# define ASN1_F_ASN1_I2D_FP 117 +# define ASN1_F_ASN1_ITEM_D2I_FP 206 +# define ASN1_F_ASN1_ITEM_DUP 191 +# define ASN1_F_ASN1_ITEM_EMBED_D2I 120 +# define ASN1_F_ASN1_ITEM_EMBED_NEW 121 +# define ASN1_F_ASN1_ITEM_FLAGS_I2D 118 +# define ASN1_F_ASN1_ITEM_I2D_BIO 192 +# define ASN1_F_ASN1_ITEM_I2D_FP 193 +# define ASN1_F_ASN1_ITEM_PACK 198 +# define ASN1_F_ASN1_ITEM_SIGN 195 +# define ASN1_F_ASN1_ITEM_SIGN_CTX 220 +# define ASN1_F_ASN1_ITEM_UNPACK 199 +# define ASN1_F_ASN1_ITEM_VERIFY 197 +# define ASN1_F_ASN1_MBSTRING_NCOPY 122 +# define ASN1_F_ASN1_OBJECT_NEW 123 +# define ASN1_F_ASN1_OUTPUT_DATA 214 +# define ASN1_F_ASN1_PCTX_NEW 205 +# define ASN1_F_ASN1_PRIMITIVE_NEW 119 +# define ASN1_F_ASN1_SCTX_NEW 221 +# define ASN1_F_ASN1_SIGN 128 +# define ASN1_F_ASN1_STR2TYPE 179 +# define ASN1_F_ASN1_STRING_GET_INT64 227 +# define ASN1_F_ASN1_STRING_GET_UINT64 230 +# define ASN1_F_ASN1_STRING_SET 186 +# define ASN1_F_ASN1_STRING_TABLE_ADD 129 +# define ASN1_F_ASN1_STRING_TO_BN 228 +# define ASN1_F_ASN1_STRING_TYPE_NEW 130 +# define ASN1_F_ASN1_TEMPLATE_EX_D2I 132 +# define ASN1_F_ASN1_TEMPLATE_NEW 133 +# define ASN1_F_ASN1_TEMPLATE_NOEXP_D2I 131 +# define ASN1_F_ASN1_TIME_ADJ 217 +# define ASN1_F_ASN1_TYPE_GET_INT_OCTETSTRING 134 +# define ASN1_F_ASN1_TYPE_GET_OCTETSTRING 135 +# define ASN1_F_ASN1_UTCTIME_ADJ 218 +# define ASN1_F_ASN1_VERIFY 137 +# define ASN1_F_B64_READ_ASN1 209 +# define ASN1_F_B64_WRITE_ASN1 210 +# define ASN1_F_BIO_NEW_NDEF 208 +# define ASN1_F_BITSTR_CB 180 +# define ASN1_F_BN_TO_ASN1_STRING 229 +# define ASN1_F_C2I_ASN1_BIT_STRING 189 +# define ASN1_F_C2I_ASN1_INTEGER 194 +# define ASN1_F_C2I_ASN1_OBJECT 196 +# define ASN1_F_C2I_IBUF 226 +# define ASN1_F_C2I_UINT64_INT 101 +# define ASN1_F_COLLECT_DATA 140 +# define ASN1_F_D2I_ASN1_OBJECT 147 +# define ASN1_F_D2I_ASN1_UINTEGER 150 +# define ASN1_F_D2I_AUTOPRIVATEKEY 207 +# define ASN1_F_D2I_PRIVATEKEY 154 +# define ASN1_F_D2I_PUBLICKEY 155 +# define ASN1_F_DO_BUF 142 +# define ASN1_F_DO_CREATE 124 +# define ASN1_F_DO_DUMP 125 +# define ASN1_F_DO_TCREATE 222 +# define ASN1_F_I2A_ASN1_OBJECT 126 +# define ASN1_F_I2D_ASN1_BIO_STREAM 211 +# define ASN1_F_I2D_ASN1_OBJECT 143 +# define ASN1_F_I2D_DSA_PUBKEY 161 +# define ASN1_F_I2D_EC_PUBKEY 181 +# define ASN1_F_I2D_PRIVATEKEY 163 +# define ASN1_F_I2D_PUBLICKEY 164 +# define ASN1_F_I2D_RSA_PUBKEY 165 +# define ASN1_F_LONG_C2I 166 +# define ASN1_F_NDEF_PREFIX 127 +# define ASN1_F_NDEF_SUFFIX 136 +# define ASN1_F_OID_MODULE_INIT 174 +# define ASN1_F_PARSE_TAGGING 182 +# define ASN1_F_PKCS5_PBE2_SET_IV 167 +# define ASN1_F_PKCS5_PBE2_SET_SCRYPT 231 +# define ASN1_F_PKCS5_PBE_SET 202 +# define ASN1_F_PKCS5_PBE_SET0_ALGOR 215 +# define ASN1_F_PKCS5_PBKDF2_SET 219 +# define ASN1_F_PKCS5_SCRYPT_SET 232 +# define ASN1_F_SMIME_READ_ASN1 212 +# define ASN1_F_SMIME_TEXT 213 +# define ASN1_F_STABLE_GET 138 +# define ASN1_F_STBL_MODULE_INIT 223 +# define ASN1_F_UINT32_C2I 105 +# define ASN1_F_UINT32_NEW 139 +# define ASN1_F_UINT64_C2I 112 +# define ASN1_F_UINT64_NEW 141 +# define ASN1_F_X509_CRL_ADD0_REVOKED 169 +# define ASN1_F_X509_INFO_NEW 170 +# define ASN1_F_X509_NAME_ENCODE 203 +# define ASN1_F_X509_NAME_EX_D2I 158 +# define ASN1_F_X509_NAME_EX_NEW 171 +# define ASN1_F_X509_PKEY_NEW 173 + +/* + * ASN1 reason codes. + */ +# define ASN1_R_ADDING_OBJECT 171 +# define ASN1_R_ASN1_PARSE_ERROR 203 +# define ASN1_R_ASN1_SIG_PARSE_ERROR 204 +# define ASN1_R_AUX_ERROR 100 +# define ASN1_R_BAD_OBJECT_HEADER 102 +# define ASN1_R_BMPSTRING_IS_WRONG_LENGTH 214 +# define ASN1_R_BN_LIB 105 +# define ASN1_R_BOOLEAN_IS_WRONG_LENGTH 106 +# define ASN1_R_BUFFER_TOO_SMALL 107 +# define ASN1_R_CIPHER_HAS_NO_OBJECT_IDENTIFIER 108 +# define ASN1_R_CONTEXT_NOT_INITIALISED 217 +# define ASN1_R_DATA_IS_WRONG 109 +# define ASN1_R_DECODE_ERROR 110 +# define ASN1_R_DEPTH_EXCEEDED 174 +# define ASN1_R_DIGEST_AND_KEY_TYPE_NOT_SUPPORTED 198 +# define ASN1_R_ENCODE_ERROR 112 +# define ASN1_R_ERROR_GETTING_TIME 173 +# define ASN1_R_ERROR_LOADING_SECTION 172 +# define ASN1_R_ERROR_SETTING_CIPHER_PARAMS 114 +# define ASN1_R_EXPECTING_AN_INTEGER 115 +# define ASN1_R_EXPECTING_AN_OBJECT 116 +# define ASN1_R_EXPLICIT_LENGTH_MISMATCH 119 +# define ASN1_R_EXPLICIT_TAG_NOT_CONSTRUCTED 120 +# define ASN1_R_FIELD_MISSING 121 +# define ASN1_R_FIRST_NUM_TOO_LARGE 122 +# define ASN1_R_HEADER_TOO_LONG 123 +# define ASN1_R_ILLEGAL_BITSTRING_FORMAT 175 +# define ASN1_R_ILLEGAL_BOOLEAN 176 +# define ASN1_R_ILLEGAL_CHARACTERS 124 +# define ASN1_R_ILLEGAL_FORMAT 177 +# define ASN1_R_ILLEGAL_HEX 178 +# define ASN1_R_ILLEGAL_IMPLICIT_TAG 179 +# define ASN1_R_ILLEGAL_INTEGER 180 +# define ASN1_R_ILLEGAL_NEGATIVE_VALUE 226 +# define ASN1_R_ILLEGAL_NESTED_TAGGING 181 +# define ASN1_R_ILLEGAL_NULL 125 +# define ASN1_R_ILLEGAL_NULL_VALUE 182 +# define ASN1_R_ILLEGAL_OBJECT 183 +# define ASN1_R_ILLEGAL_OPTIONAL_ANY 126 +# define ASN1_R_ILLEGAL_OPTIONS_ON_ITEM_TEMPLATE 170 +# define ASN1_R_ILLEGAL_PADDING 221 +# define ASN1_R_ILLEGAL_TAGGED_ANY 127 +# define ASN1_R_ILLEGAL_TIME_VALUE 184 +# define ASN1_R_ILLEGAL_ZERO_CONTENT 222 +# define ASN1_R_INTEGER_NOT_ASCII_FORMAT 185 +# define ASN1_R_INTEGER_TOO_LARGE_FOR_LONG 128 +# define ASN1_R_INVALID_BIT_STRING_BITS_LEFT 220 +# define ASN1_R_INVALID_BMPSTRING_LENGTH 129 +# define ASN1_R_INVALID_DIGIT 130 +# define ASN1_R_INVALID_MIME_TYPE 205 +# define ASN1_R_INVALID_MODIFIER 186 +# define ASN1_R_INVALID_NUMBER 187 +# define ASN1_R_INVALID_OBJECT_ENCODING 216 +# define ASN1_R_INVALID_SCRYPT_PARAMETERS 227 +# define ASN1_R_INVALID_SEPARATOR 131 +# define ASN1_R_INVALID_STRING_TABLE_VALUE 218 +# define ASN1_R_INVALID_UNIVERSALSTRING_LENGTH 133 +# define ASN1_R_INVALID_UTF8STRING 134 +# define ASN1_R_INVALID_VALUE 219 +# define ASN1_R_LIST_ERROR 188 +# define ASN1_R_MIME_NO_CONTENT_TYPE 206 +# define ASN1_R_MIME_PARSE_ERROR 207 +# define ASN1_R_MIME_SIG_PARSE_ERROR 208 +# define ASN1_R_MISSING_EOC 137 +# define ASN1_R_MISSING_SECOND_NUMBER 138 +# define ASN1_R_MISSING_VALUE 189 +# define ASN1_R_MSTRING_NOT_UNIVERSAL 139 +# define ASN1_R_MSTRING_WRONG_TAG 140 +# define ASN1_R_NESTED_ASN1_STRING 197 +# define ASN1_R_NESTED_TOO_DEEP 201 +# define ASN1_R_NON_HEX_CHARACTERS 141 +# define ASN1_R_NOT_ASCII_FORMAT 190 +# define ASN1_R_NOT_ENOUGH_DATA 142 +# define ASN1_R_NO_CONTENT_TYPE 209 +# define ASN1_R_NO_MATCHING_CHOICE_TYPE 143 +# define ASN1_R_NO_MULTIPART_BODY_FAILURE 210 +# define ASN1_R_NO_MULTIPART_BOUNDARY 211 +# define ASN1_R_NO_SIG_CONTENT_TYPE 212 +# define ASN1_R_NULL_IS_WRONG_LENGTH 144 +# define ASN1_R_OBJECT_NOT_ASCII_FORMAT 191 +# define ASN1_R_ODD_NUMBER_OF_CHARS 145 +# define ASN1_R_SECOND_NUMBER_TOO_LARGE 147 +# define ASN1_R_SEQUENCE_LENGTH_MISMATCH 148 +# define ASN1_R_SEQUENCE_NOT_CONSTRUCTED 149 +# define ASN1_R_SEQUENCE_OR_SET_NEEDS_CONFIG 192 +# define ASN1_R_SHORT_LINE 150 +# define ASN1_R_SIG_INVALID_MIME_TYPE 213 +# define ASN1_R_STREAMING_NOT_SUPPORTED 202 +# define ASN1_R_STRING_TOO_LONG 151 +# define ASN1_R_STRING_TOO_SHORT 152 +# define ASN1_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 154 +# define ASN1_R_TIME_NOT_ASCII_FORMAT 193 +# define ASN1_R_TOO_LARGE 223 +# define ASN1_R_TOO_LONG 155 +# define ASN1_R_TOO_SMALL 224 +# define ASN1_R_TYPE_NOT_CONSTRUCTED 156 +# define ASN1_R_TYPE_NOT_PRIMITIVE 195 +# define ASN1_R_UNEXPECTED_EOC 159 +# define ASN1_R_UNIVERSALSTRING_IS_WRONG_LENGTH 215 +# define ASN1_R_UNKNOWN_FORMAT 160 +# define ASN1_R_UNKNOWN_MESSAGE_DIGEST_ALGORITHM 161 +# define ASN1_R_UNKNOWN_OBJECT_TYPE 162 +# define ASN1_R_UNKNOWN_PUBLIC_KEY_TYPE 163 +# define ASN1_R_UNKNOWN_SIGNATURE_ALGORITHM 199 +# define ASN1_R_UNKNOWN_TAG 194 +# define ASN1_R_UNSUPPORTED_ANY_DEFINED_BY_TYPE 164 +# define ASN1_R_UNSUPPORTED_CIPHER 228 +# define ASN1_R_UNSUPPORTED_PUBLIC_KEY_TYPE 167 +# define ASN1_R_UNSUPPORTED_TYPE 196 +# define ASN1_R_WRONG_INTEGER_TYPE 225 +# define ASN1_R_WRONG_PUBLIC_KEY_TYPE 200 +# define ASN1_R_WRONG_TAG 168 + +#endif diff --git a/include/openssl/asn1t.h b/include/openssl/asn1t.h new file mode 100644 index 0000000..c629b62 --- /dev/null +++ b/include/openssl/asn1t.h @@ -0,0 +1,945 @@ +/* + * Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ASN1T_H +# define HEADER_ASN1T_H + +# include +# include +# include + +# ifdef OPENSSL_BUILD_SHLIBCRYPTO +# undef OPENSSL_EXTERN +# define OPENSSL_EXTERN OPENSSL_EXPORT +# endif + +/* ASN1 template defines, structures and functions */ + +#ifdef __cplusplus +extern "C" { +#endif + +# ifndef OPENSSL_EXPORT_VAR_AS_FUNCTION + +/* Macro to obtain ASN1_ADB pointer from a type (only used internally) */ +# define ASN1_ADB_ptr(iptr) ((const ASN1_ADB *)(iptr)) + +/* Macros for start and end of ASN1_ITEM definition */ + +# define ASN1_ITEM_start(itname) \ + const ASN1_ITEM itname##_it = { + +# define static_ASN1_ITEM_start(itname) \ + static const ASN1_ITEM itname##_it = { + +# define ASN1_ITEM_end(itname) \ + }; + +# else + +/* Macro to obtain ASN1_ADB pointer from a type (only used internally) */ +# define ASN1_ADB_ptr(iptr) ((const ASN1_ADB *)((iptr)())) + +/* Macros for start and end of ASN1_ITEM definition */ + +# define ASN1_ITEM_start(itname) \ + const ASN1_ITEM * itname##_it(void) \ + { \ + static const ASN1_ITEM local_it = { + +# define static_ASN1_ITEM_start(itname) \ + static ASN1_ITEM_start(itname) + +# define ASN1_ITEM_end(itname) \ + }; \ + return &local_it; \ + } + +# endif + +/* Macros to aid ASN1 template writing */ + +# define ASN1_ITEM_TEMPLATE(tname) \ + static const ASN1_TEMPLATE tname##_item_tt + +# define ASN1_ITEM_TEMPLATE_END(tname) \ + ;\ + ASN1_ITEM_start(tname) \ + ASN1_ITYPE_PRIMITIVE,\ + -1,\ + &tname##_item_tt,\ + 0,\ + NULL,\ + 0,\ + #tname \ + ASN1_ITEM_end(tname) +# define static_ASN1_ITEM_TEMPLATE_END(tname) \ + ;\ + static_ASN1_ITEM_start(tname) \ + ASN1_ITYPE_PRIMITIVE,\ + -1,\ + &tname##_item_tt,\ + 0,\ + NULL,\ + 0,\ + #tname \ + ASN1_ITEM_end(tname) + +/* This is a ASN1 type which just embeds a template */ + +/*- + * This pair helps declare a SEQUENCE. We can do: + * + * ASN1_SEQUENCE(stname) = { + * ... SEQUENCE components ... + * } ASN1_SEQUENCE_END(stname) + * + * This will produce an ASN1_ITEM called stname_it + * for a structure called stname. + * + * If you want the same structure but a different + * name then use: + * + * ASN1_SEQUENCE(itname) = { + * ... SEQUENCE components ... + * } ASN1_SEQUENCE_END_name(stname, itname) + * + * This will create an item called itname_it using + * a structure called stname. + */ + +# define ASN1_SEQUENCE(tname) \ + static const ASN1_TEMPLATE tname##_seq_tt[] + +# define ASN1_SEQUENCE_END(stname) ASN1_SEQUENCE_END_name(stname, stname) + +# define static_ASN1_SEQUENCE_END(stname) static_ASN1_SEQUENCE_END_name(stname, stname) + +# define ASN1_SEQUENCE_END_name(stname, tname) \ + ;\ + ASN1_ITEM_start(tname) \ + ASN1_ITYPE_SEQUENCE,\ + V_ASN1_SEQUENCE,\ + tname##_seq_tt,\ + sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\ + NULL,\ + sizeof(stname),\ + #tname \ + ASN1_ITEM_end(tname) + +# define static_ASN1_SEQUENCE_END_name(stname, tname) \ + ;\ + static_ASN1_ITEM_start(tname) \ + ASN1_ITYPE_SEQUENCE,\ + V_ASN1_SEQUENCE,\ + tname##_seq_tt,\ + sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\ + NULL,\ + sizeof(stname),\ + #stname \ + ASN1_ITEM_end(tname) + +# define ASN1_NDEF_SEQUENCE(tname) \ + ASN1_SEQUENCE(tname) + +# define ASN1_NDEF_SEQUENCE_cb(tname, cb) \ + ASN1_SEQUENCE_cb(tname, cb) + +# define ASN1_SEQUENCE_cb(tname, cb) \ + static const ASN1_AUX tname##_aux = {NULL, 0, 0, 0, cb, 0}; \ + ASN1_SEQUENCE(tname) + +# define ASN1_BROKEN_SEQUENCE(tname) \ + static const ASN1_AUX tname##_aux = {NULL, ASN1_AFLG_BROKEN, 0, 0, 0, 0}; \ + ASN1_SEQUENCE(tname) + +# define ASN1_SEQUENCE_ref(tname, cb) \ + static const ASN1_AUX tname##_aux = {NULL, ASN1_AFLG_REFCOUNT, offsetof(tname, references), offsetof(tname, lock), cb, 0}; \ + ASN1_SEQUENCE(tname) + +# define ASN1_SEQUENCE_enc(tname, enc, cb) \ + static const ASN1_AUX tname##_aux = {NULL, ASN1_AFLG_ENCODING, 0, 0, cb, offsetof(tname, enc)}; \ + ASN1_SEQUENCE(tname) + +# define ASN1_NDEF_SEQUENCE_END(tname) \ + ;\ + ASN1_ITEM_start(tname) \ + ASN1_ITYPE_NDEF_SEQUENCE,\ + V_ASN1_SEQUENCE,\ + tname##_seq_tt,\ + sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\ + NULL,\ + sizeof(tname),\ + #tname \ + ASN1_ITEM_end(tname) +# define static_ASN1_NDEF_SEQUENCE_END(tname) \ + ;\ + static_ASN1_ITEM_start(tname) \ + ASN1_ITYPE_NDEF_SEQUENCE,\ + V_ASN1_SEQUENCE,\ + tname##_seq_tt,\ + sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\ + NULL,\ + sizeof(tname),\ + #tname \ + ASN1_ITEM_end(tname) + +# define ASN1_BROKEN_SEQUENCE_END(stname) ASN1_SEQUENCE_END_ref(stname, stname) +# define static_ASN1_BROKEN_SEQUENCE_END(stname) \ + static_ASN1_SEQUENCE_END_ref(stname, stname) + +# define ASN1_SEQUENCE_END_enc(stname, tname) ASN1_SEQUENCE_END_ref(stname, tname) + +# define ASN1_SEQUENCE_END_cb(stname, tname) ASN1_SEQUENCE_END_ref(stname, tname) +# define static_ASN1_SEQUENCE_END_cb(stname, tname) static_ASN1_SEQUENCE_END_ref(stname, tname) + +# define ASN1_SEQUENCE_END_ref(stname, tname) \ + ;\ + ASN1_ITEM_start(tname) \ + ASN1_ITYPE_SEQUENCE,\ + V_ASN1_SEQUENCE,\ + tname##_seq_tt,\ + sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\ + &tname##_aux,\ + sizeof(stname),\ + #tname \ + ASN1_ITEM_end(tname) +# define static_ASN1_SEQUENCE_END_ref(stname, tname) \ + ;\ + static_ASN1_ITEM_start(tname) \ + ASN1_ITYPE_SEQUENCE,\ + V_ASN1_SEQUENCE,\ + tname##_seq_tt,\ + sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\ + &tname##_aux,\ + sizeof(stname),\ + #stname \ + ASN1_ITEM_end(tname) + +# define ASN1_NDEF_SEQUENCE_END_cb(stname, tname) \ + ;\ + ASN1_ITEM_start(tname) \ + ASN1_ITYPE_NDEF_SEQUENCE,\ + V_ASN1_SEQUENCE,\ + tname##_seq_tt,\ + sizeof(tname##_seq_tt) / sizeof(ASN1_TEMPLATE),\ + &tname##_aux,\ + sizeof(stname),\ + #stname \ + ASN1_ITEM_end(tname) + +/*- + * This pair helps declare a CHOICE type. We can do: + * + * ASN1_CHOICE(chname) = { + * ... CHOICE options ... + * ASN1_CHOICE_END(chname) + * + * This will produce an ASN1_ITEM called chname_it + * for a structure called chname. The structure + * definition must look like this: + * typedef struct { + * int type; + * union { + * ASN1_SOMETHING *opt1; + * ASN1_SOMEOTHER *opt2; + * } value; + * } chname; + * + * the name of the selector must be 'type'. + * to use an alternative selector name use the + * ASN1_CHOICE_END_selector() version. + */ + +# define ASN1_CHOICE(tname) \ + static const ASN1_TEMPLATE tname##_ch_tt[] + +# define ASN1_CHOICE_cb(tname, cb) \ + static const ASN1_AUX tname##_aux = {NULL, 0, 0, 0, cb, 0}; \ + ASN1_CHOICE(tname) + +# define ASN1_CHOICE_END(stname) ASN1_CHOICE_END_name(stname, stname) + +# define static_ASN1_CHOICE_END(stname) static_ASN1_CHOICE_END_name(stname, stname) + +# define ASN1_CHOICE_END_name(stname, tname) ASN1_CHOICE_END_selector(stname, tname, type) + +# define static_ASN1_CHOICE_END_name(stname, tname) static_ASN1_CHOICE_END_selector(stname, tname, type) + +# define ASN1_CHOICE_END_selector(stname, tname, selname) \ + ;\ + ASN1_ITEM_start(tname) \ + ASN1_ITYPE_CHOICE,\ + offsetof(stname,selname) ,\ + tname##_ch_tt,\ + sizeof(tname##_ch_tt) / sizeof(ASN1_TEMPLATE),\ + NULL,\ + sizeof(stname),\ + #stname \ + ASN1_ITEM_end(tname) + +# define static_ASN1_CHOICE_END_selector(stname, tname, selname) \ + ;\ + static_ASN1_ITEM_start(tname) \ + ASN1_ITYPE_CHOICE,\ + offsetof(stname,selname) ,\ + tname##_ch_tt,\ + sizeof(tname##_ch_tt) / sizeof(ASN1_TEMPLATE),\ + NULL,\ + sizeof(stname),\ + #stname \ + ASN1_ITEM_end(tname) + +# define ASN1_CHOICE_END_cb(stname, tname, selname) \ + ;\ + ASN1_ITEM_start(tname) \ + ASN1_ITYPE_CHOICE,\ + offsetof(stname,selname) ,\ + tname##_ch_tt,\ + sizeof(tname##_ch_tt) / sizeof(ASN1_TEMPLATE),\ + &tname##_aux,\ + sizeof(stname),\ + #stname \ + ASN1_ITEM_end(tname) + +/* This helps with the template wrapper form of ASN1_ITEM */ + +# define ASN1_EX_TEMPLATE_TYPE(flags, tag, name, type) { \ + (flags), (tag), 0,\ + #name, ASN1_ITEM_ref(type) } + +/* These help with SEQUENCE or CHOICE components */ + +/* used to declare other types */ + +# define ASN1_EX_TYPE(flags, tag, stname, field, type) { \ + (flags), (tag), offsetof(stname, field),\ + #field, ASN1_ITEM_ref(type) } + +/* implicit and explicit helper macros */ + +# define ASN1_IMP_EX(stname, field, type, tag, ex) \ + ASN1_EX_TYPE(ASN1_TFLG_IMPLICIT | (ex), tag, stname, field, type) + +# define ASN1_EXP_EX(stname, field, type, tag, ex) \ + ASN1_EX_TYPE(ASN1_TFLG_EXPLICIT | (ex), tag, stname, field, type) + +/* Any defined by macros: the field used is in the table itself */ + +# ifndef OPENSSL_EXPORT_VAR_AS_FUNCTION +# define ASN1_ADB_OBJECT(tblname) { ASN1_TFLG_ADB_OID, -1, 0, #tblname, (const ASN1_ITEM *)&(tblname##_adb) } +# define ASN1_ADB_INTEGER(tblname) { ASN1_TFLG_ADB_INT, -1, 0, #tblname, (const ASN1_ITEM *)&(tblname##_adb) } +# else +# define ASN1_ADB_OBJECT(tblname) { ASN1_TFLG_ADB_OID, -1, 0, #tblname, tblname##_adb } +# define ASN1_ADB_INTEGER(tblname) { ASN1_TFLG_ADB_INT, -1, 0, #tblname, tblname##_adb } +# endif +/* Plain simple type */ +# define ASN1_SIMPLE(stname, field, type) ASN1_EX_TYPE(0,0, stname, field, type) +/* Embedded simple type */ +# define ASN1_EMBED(stname, field, type) ASN1_EX_TYPE(ASN1_TFLG_EMBED,0, stname, field, type) + +/* OPTIONAL simple type */ +# define ASN1_OPT(stname, field, type) ASN1_EX_TYPE(ASN1_TFLG_OPTIONAL, 0, stname, field, type) +# define ASN1_OPT_EMBED(stname, field, type) ASN1_EX_TYPE(ASN1_TFLG_OPTIONAL|ASN1_TFLG_EMBED, 0, stname, field, type) + +/* IMPLICIT tagged simple type */ +# define ASN1_IMP(stname, field, type, tag) ASN1_IMP_EX(stname, field, type, tag, 0) +# define ASN1_IMP_EMBED(stname, field, type, tag) ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_EMBED) + +/* IMPLICIT tagged OPTIONAL simple type */ +# define ASN1_IMP_OPT(stname, field, type, tag) ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL) +# define ASN1_IMP_OPT_EMBED(stname, field, type, tag) ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL|ASN1_TFLG_EMBED) + +/* Same as above but EXPLICIT */ + +# define ASN1_EXP(stname, field, type, tag) ASN1_EXP_EX(stname, field, type, tag, 0) +# define ASN1_EXP_EMBED(stname, field, type, tag) ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_EMBED) +# define ASN1_EXP_OPT(stname, field, type, tag) ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL) +# define ASN1_EXP_OPT_EMBED(stname, field, type, tag) ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL|ASN1_TFLG_EMBED) + +/* SEQUENCE OF type */ +# define ASN1_SEQUENCE_OF(stname, field, type) \ + ASN1_EX_TYPE(ASN1_TFLG_SEQUENCE_OF, 0, stname, field, type) + +/* OPTIONAL SEQUENCE OF */ +# define ASN1_SEQUENCE_OF_OPT(stname, field, type) \ + ASN1_EX_TYPE(ASN1_TFLG_SEQUENCE_OF|ASN1_TFLG_OPTIONAL, 0, stname, field, type) + +/* Same as above but for SET OF */ + +# define ASN1_SET_OF(stname, field, type) \ + ASN1_EX_TYPE(ASN1_TFLG_SET_OF, 0, stname, field, type) + +# define ASN1_SET_OF_OPT(stname, field, type) \ + ASN1_EX_TYPE(ASN1_TFLG_SET_OF|ASN1_TFLG_OPTIONAL, 0, stname, field, type) + +/* Finally compound types of SEQUENCE, SET, IMPLICIT, EXPLICIT and OPTIONAL */ + +# define ASN1_IMP_SET_OF(stname, field, type, tag) \ + ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF) + +# define ASN1_EXP_SET_OF(stname, field, type, tag) \ + ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF) + +# define ASN1_IMP_SET_OF_OPT(stname, field, type, tag) \ + ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF|ASN1_TFLG_OPTIONAL) + +# define ASN1_EXP_SET_OF_OPT(stname, field, type, tag) \ + ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SET_OF|ASN1_TFLG_OPTIONAL) + +# define ASN1_IMP_SEQUENCE_OF(stname, field, type, tag) \ + ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF) + +# define ASN1_IMP_SEQUENCE_OF_OPT(stname, field, type, tag) \ + ASN1_IMP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF|ASN1_TFLG_OPTIONAL) + +# define ASN1_EXP_SEQUENCE_OF(stname, field, type, tag) \ + ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF) + +# define ASN1_EXP_SEQUENCE_OF_OPT(stname, field, type, tag) \ + ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_SEQUENCE_OF|ASN1_TFLG_OPTIONAL) + +/* EXPLICIT using indefinite length constructed form */ +# define ASN1_NDEF_EXP(stname, field, type, tag) \ + ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_NDEF) + +/* EXPLICIT OPTIONAL using indefinite length constructed form */ +# define ASN1_NDEF_EXP_OPT(stname, field, type, tag) \ + ASN1_EXP_EX(stname, field, type, tag, ASN1_TFLG_OPTIONAL|ASN1_TFLG_NDEF) + +/* Macros for the ASN1_ADB structure */ + +# define ASN1_ADB(name) \ + static const ASN1_ADB_TABLE name##_adbtbl[] + +# ifndef OPENSSL_EXPORT_VAR_AS_FUNCTION + +# define ASN1_ADB_END(name, flags, field, adb_cb, def, none) \ + ;\ + static const ASN1_ADB name##_adb = {\ + flags,\ + offsetof(name, field),\ + adb_cb,\ + name##_adbtbl,\ + sizeof(name##_adbtbl) / sizeof(ASN1_ADB_TABLE),\ + def,\ + none\ + } + +# else + +# define ASN1_ADB_END(name, flags, field, adb_cb, def, none) \ + ;\ + static const ASN1_ITEM *name##_adb(void) \ + { \ + static const ASN1_ADB internal_adb = \ + {\ + flags,\ + offsetof(name, field),\ + adb_cb,\ + name##_adbtbl,\ + sizeof(name##_adbtbl) / sizeof(ASN1_ADB_TABLE),\ + def,\ + none\ + }; \ + return (const ASN1_ITEM *) &internal_adb; \ + } \ + void dummy_function(void) + +# endif + +# define ADB_ENTRY(val, template) {val, template} + +# define ASN1_ADB_TEMPLATE(name) \ + static const ASN1_TEMPLATE name##_tt + +/* + * This is the ASN1 template structure that defines a wrapper round the + * actual type. It determines the actual position of the field in the value + * structure, various flags such as OPTIONAL and the field name. + */ + +struct ASN1_TEMPLATE_st { + unsigned long flags; /* Various flags */ + long tag; /* tag, not used if no tagging */ + unsigned long offset; /* Offset of this field in structure */ + const char *field_name; /* Field name */ + ASN1_ITEM_EXP *item; /* Relevant ASN1_ITEM or ASN1_ADB */ +}; + +/* Macro to extract ASN1_ITEM and ASN1_ADB pointer from ASN1_TEMPLATE */ + +# define ASN1_TEMPLATE_item(t) (t->item_ptr) +# define ASN1_TEMPLATE_adb(t) (t->item_ptr) + +typedef struct ASN1_ADB_TABLE_st ASN1_ADB_TABLE; +typedef struct ASN1_ADB_st ASN1_ADB; + +struct ASN1_ADB_st { + unsigned long flags; /* Various flags */ + unsigned long offset; /* Offset of selector field */ + int (*adb_cb)(long *psel); /* Application callback */ + const ASN1_ADB_TABLE *tbl; /* Table of possible types */ + long tblcount; /* Number of entries in tbl */ + const ASN1_TEMPLATE *default_tt; /* Type to use if no match */ + const ASN1_TEMPLATE *null_tt; /* Type to use if selector is NULL */ +}; + +struct ASN1_ADB_TABLE_st { + long value; /* NID for an object or value for an int */ + const ASN1_TEMPLATE tt; /* item for this value */ +}; + +/* template flags */ + +/* Field is optional */ +# define ASN1_TFLG_OPTIONAL (0x1) + +/* Field is a SET OF */ +# define ASN1_TFLG_SET_OF (0x1 << 1) + +/* Field is a SEQUENCE OF */ +# define ASN1_TFLG_SEQUENCE_OF (0x2 << 1) + +/* + * Special case: this refers to a SET OF that will be sorted into DER order + * when encoded *and* the corresponding STACK will be modified to match the + * new order. + */ +# define ASN1_TFLG_SET_ORDER (0x3 << 1) + +/* Mask for SET OF or SEQUENCE OF */ +# define ASN1_TFLG_SK_MASK (0x3 << 1) + +/* + * These flags mean the tag should be taken from the tag field. If EXPLICIT + * then the underlying type is used for the inner tag. + */ + +/* IMPLICIT tagging */ +# define ASN1_TFLG_IMPTAG (0x1 << 3) + +/* EXPLICIT tagging, inner tag from underlying type */ +# define ASN1_TFLG_EXPTAG (0x2 << 3) + +# define ASN1_TFLG_TAG_MASK (0x3 << 3) + +/* context specific IMPLICIT */ +# define ASN1_TFLG_IMPLICIT (ASN1_TFLG_IMPTAG|ASN1_TFLG_CONTEXT) + +/* context specific EXPLICIT */ +# define ASN1_TFLG_EXPLICIT (ASN1_TFLG_EXPTAG|ASN1_TFLG_CONTEXT) + +/* + * If tagging is in force these determine the type of tag to use. Otherwise + * the tag is determined by the underlying type. These values reflect the + * actual octet format. + */ + +/* Universal tag */ +# define ASN1_TFLG_UNIVERSAL (0x0<<6) +/* Application tag */ +# define ASN1_TFLG_APPLICATION (0x1<<6) +/* Context specific tag */ +# define ASN1_TFLG_CONTEXT (0x2<<6) +/* Private tag */ +# define ASN1_TFLG_PRIVATE (0x3<<6) + +# define ASN1_TFLG_TAG_CLASS (0x3<<6) + +/* + * These are for ANY DEFINED BY type. In this case the 'item' field points to + * an ASN1_ADB structure which contains a table of values to decode the + * relevant type + */ + +# define ASN1_TFLG_ADB_MASK (0x3<<8) + +# define ASN1_TFLG_ADB_OID (0x1<<8) + +# define ASN1_TFLG_ADB_INT (0x1<<9) + +/* + * This flag when present in a SEQUENCE OF, SET OF or EXPLICIT causes + * indefinite length constructed encoding to be used if required. + */ + +# define ASN1_TFLG_NDEF (0x1<<11) + +/* Field is embedded and not a pointer */ +# define ASN1_TFLG_EMBED (0x1 << 12) + +/* This is the actual ASN1 item itself */ + +struct ASN1_ITEM_st { + char itype; /* The item type, primitive, SEQUENCE, CHOICE + * or extern */ + long utype; /* underlying type */ + const ASN1_TEMPLATE *templates; /* If SEQUENCE or CHOICE this contains + * the contents */ + long tcount; /* Number of templates if SEQUENCE or CHOICE */ + const void *funcs; /* functions that handle this type */ + long size; /* Structure size (usually) */ + const char *sname; /* Structure name */ +}; + +/*- + * These are values for the itype field and + * determine how the type is interpreted. + * + * For PRIMITIVE types the underlying type + * determines the behaviour if items is NULL. + * + * Otherwise templates must contain a single + * template and the type is treated in the + * same way as the type specified in the template. + * + * For SEQUENCE types the templates field points + * to the members, the size field is the + * structure size. + * + * For CHOICE types the templates field points + * to each possible member (typically a union) + * and the 'size' field is the offset of the + * selector. + * + * The 'funcs' field is used for application + * specific functions. + * + * The EXTERN type uses a new style d2i/i2d. + * The new style should be used where possible + * because it avoids things like the d2i IMPLICIT + * hack. + * + * MSTRING is a multiple string type, it is used + * for a CHOICE of character strings where the + * actual strings all occupy an ASN1_STRING + * structure. In this case the 'utype' field + * has a special meaning, it is used as a mask + * of acceptable types using the B_ASN1 constants. + * + * NDEF_SEQUENCE is the same as SEQUENCE except + * that it will use indefinite length constructed + * encoding if requested. + * + */ + +# define ASN1_ITYPE_PRIMITIVE 0x0 + +# define ASN1_ITYPE_SEQUENCE 0x1 + +# define ASN1_ITYPE_CHOICE 0x2 + +# define ASN1_ITYPE_EXTERN 0x4 + +# define ASN1_ITYPE_MSTRING 0x5 + +# define ASN1_ITYPE_NDEF_SEQUENCE 0x6 + +/* + * Cache for ASN1 tag and length, so we don't keep re-reading it for things + * like CHOICE + */ + +struct ASN1_TLC_st { + char valid; /* Values below are valid */ + int ret; /* return value */ + long plen; /* length */ + int ptag; /* class value */ + int pclass; /* class value */ + int hdrlen; /* header length */ +}; + +/* Typedefs for ASN1 function pointers */ +typedef int ASN1_ex_d2i(ASN1_VALUE **pval, const unsigned char **in, long len, + const ASN1_ITEM *it, int tag, int aclass, char opt, + ASN1_TLC *ctx); + +typedef int ASN1_ex_i2d(ASN1_VALUE **pval, unsigned char **out, + const ASN1_ITEM *it, int tag, int aclass); +typedef int ASN1_ex_new_func(ASN1_VALUE **pval, const ASN1_ITEM *it); +typedef void ASN1_ex_free_func(ASN1_VALUE **pval, const ASN1_ITEM *it); + +typedef int ASN1_ex_print_func(BIO *out, ASN1_VALUE **pval, + int indent, const char *fname, + const ASN1_PCTX *pctx); + +typedef int ASN1_primitive_i2c(ASN1_VALUE **pval, unsigned char *cont, + int *putype, const ASN1_ITEM *it); +typedef int ASN1_primitive_c2i(ASN1_VALUE **pval, const unsigned char *cont, + int len, int utype, char *free_cont, + const ASN1_ITEM *it); +typedef int ASN1_primitive_print(BIO *out, ASN1_VALUE **pval, + const ASN1_ITEM *it, int indent, + const ASN1_PCTX *pctx); + +typedef struct ASN1_EXTERN_FUNCS_st { + void *app_data; + ASN1_ex_new_func *asn1_ex_new; + ASN1_ex_free_func *asn1_ex_free; + ASN1_ex_free_func *asn1_ex_clear; + ASN1_ex_d2i *asn1_ex_d2i; + ASN1_ex_i2d *asn1_ex_i2d; + ASN1_ex_print_func *asn1_ex_print; +} ASN1_EXTERN_FUNCS; + +typedef struct ASN1_PRIMITIVE_FUNCS_st { + void *app_data; + unsigned long flags; + ASN1_ex_new_func *prim_new; + ASN1_ex_free_func *prim_free; + ASN1_ex_free_func *prim_clear; + ASN1_primitive_c2i *prim_c2i; + ASN1_primitive_i2c *prim_i2c; + ASN1_primitive_print *prim_print; +} ASN1_PRIMITIVE_FUNCS; + +/* + * This is the ASN1_AUX structure: it handles various miscellaneous + * requirements. For example the use of reference counts and an informational + * callback. The "informational callback" is called at various points during + * the ASN1 encoding and decoding. It can be used to provide minor + * customisation of the structures used. This is most useful where the + * supplied routines *almost* do the right thing but need some extra help at + * a few points. If the callback returns zero then it is assumed a fatal + * error has occurred and the main operation should be abandoned. If major + * changes in the default behaviour are required then an external type is + * more appropriate. + */ + +typedef int ASN1_aux_cb(int operation, ASN1_VALUE **in, const ASN1_ITEM *it, + void *exarg); + +typedef struct ASN1_AUX_st { + void *app_data; + int flags; + int ref_offset; /* Offset of reference value */ + int ref_lock; /* Lock type to use */ + ASN1_aux_cb *asn1_cb; + int enc_offset; /* Offset of ASN1_ENCODING structure */ +} ASN1_AUX; + +/* For print related callbacks exarg points to this structure */ +typedef struct ASN1_PRINT_ARG_st { + BIO *out; + int indent; + const ASN1_PCTX *pctx; +} ASN1_PRINT_ARG; + +/* For streaming related callbacks exarg points to this structure */ +typedef struct ASN1_STREAM_ARG_st { + /* BIO to stream through */ + BIO *out; + /* BIO with filters appended */ + BIO *ndef_bio; + /* Streaming I/O boundary */ + unsigned char **boundary; +} ASN1_STREAM_ARG; + +/* Flags in ASN1_AUX */ + +/* Use a reference count */ +# define ASN1_AFLG_REFCOUNT 1 +/* Save the encoding of structure (useful for signatures) */ +# define ASN1_AFLG_ENCODING 2 +/* The Sequence length is invalid */ +# define ASN1_AFLG_BROKEN 4 + +/* operation values for asn1_cb */ + +# define ASN1_OP_NEW_PRE 0 +# define ASN1_OP_NEW_POST 1 +# define ASN1_OP_FREE_PRE 2 +# define ASN1_OP_FREE_POST 3 +# define ASN1_OP_D2I_PRE 4 +# define ASN1_OP_D2I_POST 5 +# define ASN1_OP_I2D_PRE 6 +# define ASN1_OP_I2D_POST 7 +# define ASN1_OP_PRINT_PRE 8 +# define ASN1_OP_PRINT_POST 9 +# define ASN1_OP_STREAM_PRE 10 +# define ASN1_OP_STREAM_POST 11 +# define ASN1_OP_DETACHED_PRE 12 +# define ASN1_OP_DETACHED_POST 13 + +/* Macro to implement a primitive type */ +# define IMPLEMENT_ASN1_TYPE(stname) IMPLEMENT_ASN1_TYPE_ex(stname, stname, 0) +# define IMPLEMENT_ASN1_TYPE_ex(itname, vname, ex) \ + ASN1_ITEM_start(itname) \ + ASN1_ITYPE_PRIMITIVE, V_##vname, NULL, 0, NULL, ex, #itname \ + ASN1_ITEM_end(itname) + +/* Macro to implement a multi string type */ +# define IMPLEMENT_ASN1_MSTRING(itname, mask) \ + ASN1_ITEM_start(itname) \ + ASN1_ITYPE_MSTRING, mask, NULL, 0, NULL, sizeof(ASN1_STRING), #itname \ + ASN1_ITEM_end(itname) + +# define IMPLEMENT_EXTERN_ASN1(sname, tag, fptrs) \ + ASN1_ITEM_start(sname) \ + ASN1_ITYPE_EXTERN, \ + tag, \ + NULL, \ + 0, \ + &fptrs, \ + 0, \ + #sname \ + ASN1_ITEM_end(sname) + +/* Macro to implement standard functions in terms of ASN1_ITEM structures */ + +# define IMPLEMENT_ASN1_FUNCTIONS(stname) IMPLEMENT_ASN1_FUNCTIONS_fname(stname, stname, stname) + +# define IMPLEMENT_ASN1_FUNCTIONS_name(stname, itname) IMPLEMENT_ASN1_FUNCTIONS_fname(stname, itname, itname) + +# define IMPLEMENT_ASN1_FUNCTIONS_ENCODE_name(stname, itname) \ + IMPLEMENT_ASN1_FUNCTIONS_ENCODE_fname(stname, itname, itname) + +# define IMPLEMENT_STATIC_ASN1_ALLOC_FUNCTIONS(stname) \ + IMPLEMENT_ASN1_ALLOC_FUNCTIONS_pfname(static, stname, stname, stname) + +# define IMPLEMENT_ASN1_ALLOC_FUNCTIONS(stname) \ + IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, stname, stname) + +# define IMPLEMENT_ASN1_ALLOC_FUNCTIONS_pfname(pre, stname, itname, fname) \ + pre stname *fname##_new(void) \ + { \ + return (stname *)ASN1_item_new(ASN1_ITEM_rptr(itname)); \ + } \ + pre void fname##_free(stname *a) \ + { \ + ASN1_item_free((ASN1_VALUE *)a, ASN1_ITEM_rptr(itname)); \ + } + +# define IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, itname, fname) \ + stname *fname##_new(void) \ + { \ + return (stname *)ASN1_item_new(ASN1_ITEM_rptr(itname)); \ + } \ + void fname##_free(stname *a) \ + { \ + ASN1_item_free((ASN1_VALUE *)a, ASN1_ITEM_rptr(itname)); \ + } + +# define IMPLEMENT_ASN1_FUNCTIONS_fname(stname, itname, fname) \ + IMPLEMENT_ASN1_ENCODE_FUNCTIONS_fname(stname, itname, fname) \ + IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, itname, fname) + +# define IMPLEMENT_ASN1_ENCODE_FUNCTIONS_fname(stname, itname, fname) \ + stname *d2i_##fname(stname **a, const unsigned char **in, long len) \ + { \ + return (stname *)ASN1_item_d2i((ASN1_VALUE **)a, in, len, ASN1_ITEM_rptr(itname));\ + } \ + int i2d_##fname(stname *a, unsigned char **out) \ + { \ + return ASN1_item_i2d((ASN1_VALUE *)a, out, ASN1_ITEM_rptr(itname));\ + } + +# define IMPLEMENT_ASN1_NDEF_FUNCTION(stname) \ + int i2d_##stname##_NDEF(stname *a, unsigned char **out) \ + { \ + return ASN1_item_ndef_i2d((ASN1_VALUE *)a, out, ASN1_ITEM_rptr(stname));\ + } + +# define IMPLEMENT_STATIC_ASN1_ENCODE_FUNCTIONS(stname) \ + static stname *d2i_##stname(stname **a, \ + const unsigned char **in, long len) \ + { \ + return (stname *)ASN1_item_d2i((ASN1_VALUE **)a, in, len, \ + ASN1_ITEM_rptr(stname)); \ + } \ + static int i2d_##stname(stname *a, unsigned char **out) \ + { \ + return ASN1_item_i2d((ASN1_VALUE *)a, out, \ + ASN1_ITEM_rptr(stname)); \ + } + +/* + * This includes evil casts to remove const: they will go away when full ASN1 + * constification is done. + */ +# define IMPLEMENT_ASN1_ENCODE_FUNCTIONS_const_fname(stname, itname, fname) \ + stname *d2i_##fname(stname **a, const unsigned char **in, long len) \ + { \ + return (stname *)ASN1_item_d2i((ASN1_VALUE **)a, in, len, ASN1_ITEM_rptr(itname));\ + } \ + int i2d_##fname(const stname *a, unsigned char **out) \ + { \ + return ASN1_item_i2d((ASN1_VALUE *)a, out, ASN1_ITEM_rptr(itname));\ + } + +# define IMPLEMENT_ASN1_DUP_FUNCTION(stname) \ + stname * stname##_dup(stname *x) \ + { \ + return ASN1_item_dup(ASN1_ITEM_rptr(stname), x); \ + } + +# define IMPLEMENT_ASN1_PRINT_FUNCTION(stname) \ + IMPLEMENT_ASN1_PRINT_FUNCTION_fname(stname, stname, stname) + +# define IMPLEMENT_ASN1_PRINT_FUNCTION_fname(stname, itname, fname) \ + int fname##_print_ctx(BIO *out, stname *x, int indent, \ + const ASN1_PCTX *pctx) \ + { \ + return ASN1_item_print(out, (ASN1_VALUE *)x, indent, \ + ASN1_ITEM_rptr(itname), pctx); \ + } + +# define IMPLEMENT_ASN1_FUNCTIONS_const(name) \ + IMPLEMENT_ASN1_FUNCTIONS_const_fname(name, name, name) + +# define IMPLEMENT_ASN1_FUNCTIONS_const_fname(stname, itname, fname) \ + IMPLEMENT_ASN1_ENCODE_FUNCTIONS_const_fname(stname, itname, fname) \ + IMPLEMENT_ASN1_ALLOC_FUNCTIONS_fname(stname, itname, fname) + +/* external definitions for primitive types */ + +DECLARE_ASN1_ITEM(ASN1_BOOLEAN) +DECLARE_ASN1_ITEM(ASN1_TBOOLEAN) +DECLARE_ASN1_ITEM(ASN1_FBOOLEAN) +DECLARE_ASN1_ITEM(ASN1_SEQUENCE) +DECLARE_ASN1_ITEM(CBIGNUM) +DECLARE_ASN1_ITEM(BIGNUM) +DECLARE_ASN1_ITEM(INT32) +DECLARE_ASN1_ITEM(ZINT32) +DECLARE_ASN1_ITEM(UINT32) +DECLARE_ASN1_ITEM(ZUINT32) +DECLARE_ASN1_ITEM(INT64) +DECLARE_ASN1_ITEM(ZINT64) +DECLARE_ASN1_ITEM(UINT64) +DECLARE_ASN1_ITEM(ZUINT64) + +# if OPENSSL_API_COMPAT < 0x10200000L +/* + * LONG and ZLONG are strongly discouraged for use as stored data, as the + * underlying C type (long) differs in size depending on the architecture. + * They are designed with 32-bit longs in mind. + */ +DECLARE_ASN1_ITEM(LONG) +DECLARE_ASN1_ITEM(ZLONG) +# endif + +DEFINE_STACK_OF(ASN1_VALUE) + +/* Functions used internally by the ASN1 code */ + +int ASN1_item_ex_new(ASN1_VALUE **pval, const ASN1_ITEM *it); +void ASN1_item_ex_free(ASN1_VALUE **pval, const ASN1_ITEM *it); + +int ASN1_item_ex_d2i(ASN1_VALUE **pval, const unsigned char **in, long len, + const ASN1_ITEM *it, int tag, int aclass, char opt, + ASN1_TLC *ctx); + +int ASN1_item_ex_i2d(ASN1_VALUE **pval, unsigned char **out, + const ASN1_ITEM *it, int tag, int aclass); + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/async.h b/include/openssl/async.h new file mode 100644 index 0000000..92e56e8 --- /dev/null +++ b/include/openssl/async.h @@ -0,0 +1,76 @@ +/* + * Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +#ifndef HEADER_ASYNC_H +# define HEADER_ASYNC_H + +#if defined(_WIN32) +# if defined(BASETYPES) || defined(_WINDEF_H) +/* application has to include to use this */ +#define OSSL_ASYNC_FD HANDLE +#define OSSL_BAD_ASYNC_FD INVALID_HANDLE_VALUE +# endif +#else +#define OSSL_ASYNC_FD int +#define OSSL_BAD_ASYNC_FD -1 +#endif +# include + + +# ifdef __cplusplus +extern "C" { +# endif + +typedef struct async_job_st ASYNC_JOB; +typedef struct async_wait_ctx_st ASYNC_WAIT_CTX; + +#define ASYNC_ERR 0 +#define ASYNC_NO_JOBS 1 +#define ASYNC_PAUSE 2 +#define ASYNC_FINISH 3 + +int ASYNC_init_thread(size_t max_size, size_t init_size); +void ASYNC_cleanup_thread(void); + +#ifdef OSSL_ASYNC_FD +ASYNC_WAIT_CTX *ASYNC_WAIT_CTX_new(void); +void ASYNC_WAIT_CTX_free(ASYNC_WAIT_CTX *ctx); +int ASYNC_WAIT_CTX_set_wait_fd(ASYNC_WAIT_CTX *ctx, const void *key, + OSSL_ASYNC_FD fd, + void *custom_data, + void (*cleanup)(ASYNC_WAIT_CTX *, const void *, + OSSL_ASYNC_FD, void *)); +int ASYNC_WAIT_CTX_get_fd(ASYNC_WAIT_CTX *ctx, const void *key, + OSSL_ASYNC_FD *fd, void **custom_data); +int ASYNC_WAIT_CTX_get_all_fds(ASYNC_WAIT_CTX *ctx, OSSL_ASYNC_FD *fd, + size_t *numfds); +int ASYNC_WAIT_CTX_get_changed_fds(ASYNC_WAIT_CTX *ctx, OSSL_ASYNC_FD *addfd, + size_t *numaddfds, OSSL_ASYNC_FD *delfd, + size_t *numdelfds); +int ASYNC_WAIT_CTX_clear_fd(ASYNC_WAIT_CTX *ctx, const void *key); +#endif + +int ASYNC_is_capable(void); + +int ASYNC_start_job(ASYNC_JOB **job, ASYNC_WAIT_CTX *ctx, int *ret, + int (*func)(void *), void *args, size_t size); +int ASYNC_pause_job(void); + +ASYNC_JOB *ASYNC_get_current_job(void); +ASYNC_WAIT_CTX *ASYNC_get_wait_ctx(ASYNC_JOB *job); +void ASYNC_block_pause(void); +void ASYNC_unblock_pause(void); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/asyncerr.h b/include/openssl/asyncerr.h new file mode 100644 index 0000000..5497ba7 --- /dev/null +++ b/include/openssl/asyncerr.h @@ -0,0 +1,38 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ASYNCERR_H +# define HEADER_ASYNCERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_ASYNC_strings(void); + +/* + * ASYNC function codes. + */ +# define ASYNC_F_ASYNC_CTX_NEW 100 +# define ASYNC_F_ASYNC_INIT_THREAD 101 +# define ASYNC_F_ASYNC_JOB_NEW 102 +# define ASYNC_F_ASYNC_PAUSE_JOB 103 +# define ASYNC_F_ASYNC_START_FUNC 104 +# define ASYNC_F_ASYNC_START_JOB 105 +# define ASYNC_F_ASYNC_WAIT_CTX_SET_WAIT_FD 106 + +/* + * ASYNC reason codes. + */ +# define ASYNC_R_FAILED_TO_SET_POOL 101 +# define ASYNC_R_FAILED_TO_SWAP_CONTEXT 102 +# define ASYNC_R_INIT_FAILED 105 +# define ASYNC_R_INVALID_POOL_SIZE 103 + +#endif diff --git a/include/openssl/bio.h b/include/openssl/bio.h new file mode 100644 index 0000000..c0e85cc --- /dev/null +++ b/include/openssl/bio.h @@ -0,0 +1,804 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BIO_H +# define HEADER_BIO_H + +# include + +# ifndef OPENSSL_NO_STDIO +# include +# endif +# include + +# include +# include + +# ifndef OPENSSL_NO_SCTP +# include +# endif + +#ifdef __cplusplus +extern "C" { +#endif + +/* There are the classes of BIOs */ +# define BIO_TYPE_DESCRIPTOR 0x0100 /* socket, fd, connect or accept */ +# define BIO_TYPE_FILTER 0x0200 +# define BIO_TYPE_SOURCE_SINK 0x0400 + +/* These are the 'types' of BIOs */ +# define BIO_TYPE_NONE 0 +# define BIO_TYPE_MEM ( 1|BIO_TYPE_SOURCE_SINK) +# define BIO_TYPE_FILE ( 2|BIO_TYPE_SOURCE_SINK) + +# define BIO_TYPE_FD ( 4|BIO_TYPE_SOURCE_SINK|BIO_TYPE_DESCRIPTOR) +# define BIO_TYPE_SOCKET ( 5|BIO_TYPE_SOURCE_SINK|BIO_TYPE_DESCRIPTOR) +# define BIO_TYPE_NULL ( 6|BIO_TYPE_SOURCE_SINK) +# define BIO_TYPE_SSL ( 7|BIO_TYPE_FILTER) +# define BIO_TYPE_MD ( 8|BIO_TYPE_FILTER) +# define BIO_TYPE_BUFFER ( 9|BIO_TYPE_FILTER) +# define BIO_TYPE_CIPHER (10|BIO_TYPE_FILTER) +# define BIO_TYPE_BASE64 (11|BIO_TYPE_FILTER) +# define BIO_TYPE_CONNECT (12|BIO_TYPE_SOURCE_SINK|BIO_TYPE_DESCRIPTOR) +# define BIO_TYPE_ACCEPT (13|BIO_TYPE_SOURCE_SINK|BIO_TYPE_DESCRIPTOR) + +# define BIO_TYPE_NBIO_TEST (16|BIO_TYPE_FILTER)/* server proxy BIO */ +# define BIO_TYPE_NULL_FILTER (17|BIO_TYPE_FILTER) +# define BIO_TYPE_BIO (19|BIO_TYPE_SOURCE_SINK)/* half a BIO pair */ +# define BIO_TYPE_LINEBUFFER (20|BIO_TYPE_FILTER) +# define BIO_TYPE_DGRAM (21|BIO_TYPE_SOURCE_SINK|BIO_TYPE_DESCRIPTOR) +# define BIO_TYPE_ASN1 (22|BIO_TYPE_FILTER) +# define BIO_TYPE_COMP (23|BIO_TYPE_FILTER) +# ifndef OPENSSL_NO_SCTP +# define BIO_TYPE_DGRAM_SCTP (24|BIO_TYPE_SOURCE_SINK|BIO_TYPE_DESCRIPTOR) +# endif + +#define BIO_TYPE_START 128 + +/* + * BIO_FILENAME_READ|BIO_CLOSE to open or close on free. + * BIO_set_fp(in,stdin,BIO_NOCLOSE); + */ +# define BIO_NOCLOSE 0x00 +# define BIO_CLOSE 0x01 + +/* + * These are used in the following macros and are passed to BIO_ctrl() + */ +# define BIO_CTRL_RESET 1/* opt - rewind/zero etc */ +# define BIO_CTRL_EOF 2/* opt - are we at the eof */ +# define BIO_CTRL_INFO 3/* opt - extra tit-bits */ +# define BIO_CTRL_SET 4/* man - set the 'IO' type */ +# define BIO_CTRL_GET 5/* man - get the 'IO' type */ +# define BIO_CTRL_PUSH 6/* opt - internal, used to signify change */ +# define BIO_CTRL_POP 7/* opt - internal, used to signify change */ +# define BIO_CTRL_GET_CLOSE 8/* man - set the 'close' on free */ +# define BIO_CTRL_SET_CLOSE 9/* man - set the 'close' on free */ +# define BIO_CTRL_PENDING 10/* opt - is their more data buffered */ +# define BIO_CTRL_FLUSH 11/* opt - 'flush' buffered output */ +# define BIO_CTRL_DUP 12/* man - extra stuff for 'duped' BIO */ +# define BIO_CTRL_WPENDING 13/* opt - number of bytes still to write */ +# define BIO_CTRL_SET_CALLBACK 14/* opt - set callback function */ +# define BIO_CTRL_GET_CALLBACK 15/* opt - set callback function */ + +# define BIO_CTRL_PEEK 29/* BIO_f_buffer special */ +# define BIO_CTRL_SET_FILENAME 30/* BIO_s_file special */ + +/* dgram BIO stuff */ +# define BIO_CTRL_DGRAM_CONNECT 31/* BIO dgram special */ +# define BIO_CTRL_DGRAM_SET_CONNECTED 32/* allow for an externally connected + * socket to be passed in */ +# define BIO_CTRL_DGRAM_SET_RECV_TIMEOUT 33/* setsockopt, essentially */ +# define BIO_CTRL_DGRAM_GET_RECV_TIMEOUT 34/* getsockopt, essentially */ +# define BIO_CTRL_DGRAM_SET_SEND_TIMEOUT 35/* setsockopt, essentially */ +# define BIO_CTRL_DGRAM_GET_SEND_TIMEOUT 36/* getsockopt, essentially */ + +# define BIO_CTRL_DGRAM_GET_RECV_TIMER_EXP 37/* flag whether the last */ +# define BIO_CTRL_DGRAM_GET_SEND_TIMER_EXP 38/* I/O operation tiemd out */ + +/* #ifdef IP_MTU_DISCOVER */ +# define BIO_CTRL_DGRAM_MTU_DISCOVER 39/* set DF bit on egress packets */ +/* #endif */ + +# define BIO_CTRL_DGRAM_QUERY_MTU 40/* as kernel for current MTU */ +# define BIO_CTRL_DGRAM_GET_FALLBACK_MTU 47 +# define BIO_CTRL_DGRAM_GET_MTU 41/* get cached value for MTU */ +# define BIO_CTRL_DGRAM_SET_MTU 42/* set cached value for MTU. + * want to use this if asking + * the kernel fails */ + +# define BIO_CTRL_DGRAM_MTU_EXCEEDED 43/* check whether the MTU was + * exceed in the previous write + * operation */ + +# define BIO_CTRL_DGRAM_GET_PEER 46 +# define BIO_CTRL_DGRAM_SET_PEER 44/* Destination for the data */ + +# define BIO_CTRL_DGRAM_SET_NEXT_TIMEOUT 45/* Next DTLS handshake timeout + * to adjust socket timeouts */ +# define BIO_CTRL_DGRAM_SET_DONT_FRAG 48 + +# define BIO_CTRL_DGRAM_GET_MTU_OVERHEAD 49 + +/* Deliberately outside of OPENSSL_NO_SCTP - used in bss_dgram.c */ +# define BIO_CTRL_DGRAM_SCTP_SET_IN_HANDSHAKE 50 +# ifndef OPENSSL_NO_SCTP +/* SCTP stuff */ +# define BIO_CTRL_DGRAM_SCTP_ADD_AUTH_KEY 51 +# define BIO_CTRL_DGRAM_SCTP_NEXT_AUTH_KEY 52 +# define BIO_CTRL_DGRAM_SCTP_AUTH_CCS_RCVD 53 +# define BIO_CTRL_DGRAM_SCTP_GET_SNDINFO 60 +# define BIO_CTRL_DGRAM_SCTP_SET_SNDINFO 61 +# define BIO_CTRL_DGRAM_SCTP_GET_RCVINFO 62 +# define BIO_CTRL_DGRAM_SCTP_SET_RCVINFO 63 +# define BIO_CTRL_DGRAM_SCTP_GET_PRINFO 64 +# define BIO_CTRL_DGRAM_SCTP_SET_PRINFO 65 +# define BIO_CTRL_DGRAM_SCTP_SAVE_SHUTDOWN 70 +# endif + +# define BIO_CTRL_DGRAM_SET_PEEK_MODE 71 + +/* modifiers */ +# define BIO_FP_READ 0x02 +# define BIO_FP_WRITE 0x04 +# define BIO_FP_APPEND 0x08 +# define BIO_FP_TEXT 0x10 + +# define BIO_FLAGS_READ 0x01 +# define BIO_FLAGS_WRITE 0x02 +# define BIO_FLAGS_IO_SPECIAL 0x04 +# define BIO_FLAGS_RWS (BIO_FLAGS_READ|BIO_FLAGS_WRITE|BIO_FLAGS_IO_SPECIAL) +# define BIO_FLAGS_SHOULD_RETRY 0x08 +# ifndef BIO_FLAGS_UPLINK +/* + * "UPLINK" flag denotes file descriptors provided by application. It + * defaults to 0, as most platforms don't require UPLINK interface. + */ +# define BIO_FLAGS_UPLINK 0 +# endif + +# define BIO_FLAGS_BASE64_NO_NL 0x100 + +/* + * This is used with memory BIOs: + * BIO_FLAGS_MEM_RDONLY means we shouldn't free up or change the data in any way; + * BIO_FLAGS_NONCLEAR_RST means we shouldn't clear data on reset. + */ +# define BIO_FLAGS_MEM_RDONLY 0x200 +# define BIO_FLAGS_NONCLEAR_RST 0x400 + +typedef union bio_addr_st BIO_ADDR; +typedef struct bio_addrinfo_st BIO_ADDRINFO; + +int BIO_get_new_index(void); +void BIO_set_flags(BIO *b, int flags); +int BIO_test_flags(const BIO *b, int flags); +void BIO_clear_flags(BIO *b, int flags); + +# define BIO_get_flags(b) BIO_test_flags(b, ~(0x0)) +# define BIO_set_retry_special(b) \ + BIO_set_flags(b, (BIO_FLAGS_IO_SPECIAL|BIO_FLAGS_SHOULD_RETRY)) +# define BIO_set_retry_read(b) \ + BIO_set_flags(b, (BIO_FLAGS_READ|BIO_FLAGS_SHOULD_RETRY)) +# define BIO_set_retry_write(b) \ + BIO_set_flags(b, (BIO_FLAGS_WRITE|BIO_FLAGS_SHOULD_RETRY)) + +/* These are normally used internally in BIOs */ +# define BIO_clear_retry_flags(b) \ + BIO_clear_flags(b, (BIO_FLAGS_RWS|BIO_FLAGS_SHOULD_RETRY)) +# define BIO_get_retry_flags(b) \ + BIO_test_flags(b, (BIO_FLAGS_RWS|BIO_FLAGS_SHOULD_RETRY)) + +/* These should be used by the application to tell why we should retry */ +# define BIO_should_read(a) BIO_test_flags(a, BIO_FLAGS_READ) +# define BIO_should_write(a) BIO_test_flags(a, BIO_FLAGS_WRITE) +# define BIO_should_io_special(a) BIO_test_flags(a, BIO_FLAGS_IO_SPECIAL) +# define BIO_retry_type(a) BIO_test_flags(a, BIO_FLAGS_RWS) +# define BIO_should_retry(a) BIO_test_flags(a, BIO_FLAGS_SHOULD_RETRY) + +/* + * The next three are used in conjunction with the BIO_should_io_special() + * condition. After this returns true, BIO *BIO_get_retry_BIO(BIO *bio, int + * *reason); will walk the BIO stack and return the 'reason' for the special + * and the offending BIO. Given a BIO, BIO_get_retry_reason(bio) will return + * the code. + */ +/* + * Returned from the SSL bio when the certificate retrieval code had an error + */ +# define BIO_RR_SSL_X509_LOOKUP 0x01 +/* Returned from the connect BIO when a connect would have blocked */ +# define BIO_RR_CONNECT 0x02 +/* Returned from the accept BIO when an accept would have blocked */ +# define BIO_RR_ACCEPT 0x03 + +/* These are passed by the BIO callback */ +# define BIO_CB_FREE 0x01 +# define BIO_CB_READ 0x02 +# define BIO_CB_WRITE 0x03 +# define BIO_CB_PUTS 0x04 +# define BIO_CB_GETS 0x05 +# define BIO_CB_CTRL 0x06 + +/* + * The callback is called before and after the underling operation, The + * BIO_CB_RETURN flag indicates if it is after the call + */ +# define BIO_CB_RETURN 0x80 +# define BIO_CB_return(a) ((a)|BIO_CB_RETURN) +# define BIO_cb_pre(a) (!((a)&BIO_CB_RETURN)) +# define BIO_cb_post(a) ((a)&BIO_CB_RETURN) + +typedef long (*BIO_callback_fn)(BIO *b, int oper, const char *argp, int argi, + long argl, long ret); +typedef long (*BIO_callback_fn_ex)(BIO *b, int oper, const char *argp, + size_t len, int argi, + long argl, int ret, size_t *processed); +BIO_callback_fn BIO_get_callback(const BIO *b); +void BIO_set_callback(BIO *b, BIO_callback_fn callback); + +BIO_callback_fn_ex BIO_get_callback_ex(const BIO *b); +void BIO_set_callback_ex(BIO *b, BIO_callback_fn_ex callback); + +char *BIO_get_callback_arg(const BIO *b); +void BIO_set_callback_arg(BIO *b, char *arg); + +typedef struct bio_method_st BIO_METHOD; + +const char *BIO_method_name(const BIO *b); +int BIO_method_type(const BIO *b); + +typedef int BIO_info_cb(BIO *, int, int); +typedef BIO_info_cb bio_info_cb; /* backward compatibility */ + +DEFINE_STACK_OF(BIO) + +/* Prefix and suffix callback in ASN1 BIO */ +typedef int asn1_ps_func (BIO *b, unsigned char **pbuf, int *plen, + void *parg); + +# ifndef OPENSSL_NO_SCTP +/* SCTP parameter structs */ +struct bio_dgram_sctp_sndinfo { + uint16_t snd_sid; + uint16_t snd_flags; + uint32_t snd_ppid; + uint32_t snd_context; +}; + +struct bio_dgram_sctp_rcvinfo { + uint16_t rcv_sid; + uint16_t rcv_ssn; + uint16_t rcv_flags; + uint32_t rcv_ppid; + uint32_t rcv_tsn; + uint32_t rcv_cumtsn; + uint32_t rcv_context; +}; + +struct bio_dgram_sctp_prinfo { + uint16_t pr_policy; + uint32_t pr_value; +}; +# endif + +/* + * #define BIO_CONN_get_param_hostname BIO_ctrl + */ + +# define BIO_C_SET_CONNECT 100 +# define BIO_C_DO_STATE_MACHINE 101 +# define BIO_C_SET_NBIO 102 +/* # define BIO_C_SET_PROXY_PARAM 103 */ +# define BIO_C_SET_FD 104 +# define BIO_C_GET_FD 105 +# define BIO_C_SET_FILE_PTR 106 +# define BIO_C_GET_FILE_PTR 107 +# define BIO_C_SET_FILENAME 108 +# define BIO_C_SET_SSL 109 +# define BIO_C_GET_SSL 110 +# define BIO_C_SET_MD 111 +# define BIO_C_GET_MD 112 +# define BIO_C_GET_CIPHER_STATUS 113 +# define BIO_C_SET_BUF_MEM 114 +# define BIO_C_GET_BUF_MEM_PTR 115 +# define BIO_C_GET_BUFF_NUM_LINES 116 +# define BIO_C_SET_BUFF_SIZE 117 +# define BIO_C_SET_ACCEPT 118 +# define BIO_C_SSL_MODE 119 +# define BIO_C_GET_MD_CTX 120 +/* # define BIO_C_GET_PROXY_PARAM 121 */ +# define BIO_C_SET_BUFF_READ_DATA 122/* data to read first */ +# define BIO_C_GET_CONNECT 123 +# define BIO_C_GET_ACCEPT 124 +# define BIO_C_SET_SSL_RENEGOTIATE_BYTES 125 +# define BIO_C_GET_SSL_NUM_RENEGOTIATES 126 +# define BIO_C_SET_SSL_RENEGOTIATE_TIMEOUT 127 +# define BIO_C_FILE_SEEK 128 +# define BIO_C_GET_CIPHER_CTX 129 +# define BIO_C_SET_BUF_MEM_EOF_RETURN 130/* return end of input + * value */ +# define BIO_C_SET_BIND_MODE 131 +# define BIO_C_GET_BIND_MODE 132 +# define BIO_C_FILE_TELL 133 +# define BIO_C_GET_SOCKS 134 +# define BIO_C_SET_SOCKS 135 + +# define BIO_C_SET_WRITE_BUF_SIZE 136/* for BIO_s_bio */ +# define BIO_C_GET_WRITE_BUF_SIZE 137 +# define BIO_C_MAKE_BIO_PAIR 138 +# define BIO_C_DESTROY_BIO_PAIR 139 +# define BIO_C_GET_WRITE_GUARANTEE 140 +# define BIO_C_GET_READ_REQUEST 141 +# define BIO_C_SHUTDOWN_WR 142 +# define BIO_C_NREAD0 143 +# define BIO_C_NREAD 144 +# define BIO_C_NWRITE0 145 +# define BIO_C_NWRITE 146 +# define BIO_C_RESET_READ_REQUEST 147 +# define BIO_C_SET_MD_CTX 148 + +# define BIO_C_SET_PREFIX 149 +# define BIO_C_GET_PREFIX 150 +# define BIO_C_SET_SUFFIX 151 +# define BIO_C_GET_SUFFIX 152 + +# define BIO_C_SET_EX_ARG 153 +# define BIO_C_GET_EX_ARG 154 + +# define BIO_C_SET_CONNECT_MODE 155 + +# define BIO_set_app_data(s,arg) BIO_set_ex_data(s,0,arg) +# define BIO_get_app_data(s) BIO_get_ex_data(s,0) + +# define BIO_set_nbio(b,n) BIO_ctrl(b,BIO_C_SET_NBIO,(n),NULL) + +# ifndef OPENSSL_NO_SOCK +/* IP families we support, for BIO_s_connect() and BIO_s_accept() */ +/* Note: the underlying operating system may not support some of them */ +# define BIO_FAMILY_IPV4 4 +# define BIO_FAMILY_IPV6 6 +# define BIO_FAMILY_IPANY 256 + +/* BIO_s_connect() */ +# define BIO_set_conn_hostname(b,name) BIO_ctrl(b,BIO_C_SET_CONNECT,0, \ + (char *)(name)) +# define BIO_set_conn_port(b,port) BIO_ctrl(b,BIO_C_SET_CONNECT,1, \ + (char *)(port)) +# define BIO_set_conn_address(b,addr) BIO_ctrl(b,BIO_C_SET_CONNECT,2, \ + (char *)(addr)) +# define BIO_set_conn_ip_family(b,f) BIO_int_ctrl(b,BIO_C_SET_CONNECT,3,f) +# define BIO_get_conn_hostname(b) ((const char *)BIO_ptr_ctrl(b,BIO_C_GET_CONNECT,0)) +# define BIO_get_conn_port(b) ((const char *)BIO_ptr_ctrl(b,BIO_C_GET_CONNECT,1)) +# define BIO_get_conn_address(b) ((const BIO_ADDR *)BIO_ptr_ctrl(b,BIO_C_GET_CONNECT,2)) +# define BIO_get_conn_ip_family(b) BIO_ctrl(b,BIO_C_GET_CONNECT,3,NULL) +# define BIO_set_conn_mode(b,n) BIO_ctrl(b,BIO_C_SET_CONNECT_MODE,(n),NULL) + +/* BIO_s_accept() */ +# define BIO_set_accept_name(b,name) BIO_ctrl(b,BIO_C_SET_ACCEPT,0, \ + (char *)(name)) +# define BIO_set_accept_port(b,port) BIO_ctrl(b,BIO_C_SET_ACCEPT,1, \ + (char *)(port)) +# define BIO_get_accept_name(b) ((const char *)BIO_ptr_ctrl(b,BIO_C_GET_ACCEPT,0)) +# define BIO_get_accept_port(b) ((const char *)BIO_ptr_ctrl(b,BIO_C_GET_ACCEPT,1)) +# define BIO_get_peer_name(b) ((const char *)BIO_ptr_ctrl(b,BIO_C_GET_ACCEPT,2)) +# define BIO_get_peer_port(b) ((const char *)BIO_ptr_ctrl(b,BIO_C_GET_ACCEPT,3)) +/* #define BIO_set_nbio(b,n) BIO_ctrl(b,BIO_C_SET_NBIO,(n),NULL) */ +# define BIO_set_nbio_accept(b,n) BIO_ctrl(b,BIO_C_SET_ACCEPT,2,(n)?(void *)"a":NULL) +# define BIO_set_accept_bios(b,bio) BIO_ctrl(b,BIO_C_SET_ACCEPT,3, \ + (char *)(bio)) +# define BIO_set_accept_ip_family(b,f) BIO_int_ctrl(b,BIO_C_SET_ACCEPT,4,f) +# define BIO_get_accept_ip_family(b) BIO_ctrl(b,BIO_C_GET_ACCEPT,4,NULL) + +/* Aliases kept for backward compatibility */ +# define BIO_BIND_NORMAL 0 +# define BIO_BIND_REUSEADDR BIO_SOCK_REUSEADDR +# define BIO_BIND_REUSEADDR_IF_UNUSED BIO_SOCK_REUSEADDR +# define BIO_set_bind_mode(b,mode) BIO_ctrl(b,BIO_C_SET_BIND_MODE,mode,NULL) +# define BIO_get_bind_mode(b) BIO_ctrl(b,BIO_C_GET_BIND_MODE,0,NULL) + +/* BIO_s_accept() and BIO_s_connect() */ +# define BIO_do_connect(b) BIO_do_handshake(b) +# define BIO_do_accept(b) BIO_do_handshake(b) +# endif /* OPENSSL_NO_SOCK */ + +# define BIO_do_handshake(b) BIO_ctrl(b,BIO_C_DO_STATE_MACHINE,0,NULL) + +/* BIO_s_datagram(), BIO_s_fd(), BIO_s_socket(), BIO_s_accept() and BIO_s_connect() */ +# define BIO_set_fd(b,fd,c) BIO_int_ctrl(b,BIO_C_SET_FD,c,fd) +# define BIO_get_fd(b,c) BIO_ctrl(b,BIO_C_GET_FD,0,(char *)(c)) + +/* BIO_s_file() */ +# define BIO_set_fp(b,fp,c) BIO_ctrl(b,BIO_C_SET_FILE_PTR,c,(char *)(fp)) +# define BIO_get_fp(b,fpp) BIO_ctrl(b,BIO_C_GET_FILE_PTR,0,(char *)(fpp)) + +/* BIO_s_fd() and BIO_s_file() */ +# define BIO_seek(b,ofs) (int)BIO_ctrl(b,BIO_C_FILE_SEEK,ofs,NULL) +# define BIO_tell(b) (int)BIO_ctrl(b,BIO_C_FILE_TELL,0,NULL) + +/* + * name is cast to lose const, but might be better to route through a + * function so we can do it safely + */ +# ifdef CONST_STRICT +/* + * If you are wondering why this isn't defined, its because CONST_STRICT is + * purely a compile-time kludge to allow const to be checked. + */ +int BIO_read_filename(BIO *b, const char *name); +# else +# define BIO_read_filename(b,name) (int)BIO_ctrl(b,BIO_C_SET_FILENAME, \ + BIO_CLOSE|BIO_FP_READ,(char *)(name)) +# endif +# define BIO_write_filename(b,name) (int)BIO_ctrl(b,BIO_C_SET_FILENAME, \ + BIO_CLOSE|BIO_FP_WRITE,name) +# define BIO_append_filename(b,name) (int)BIO_ctrl(b,BIO_C_SET_FILENAME, \ + BIO_CLOSE|BIO_FP_APPEND,name) +# define BIO_rw_filename(b,name) (int)BIO_ctrl(b,BIO_C_SET_FILENAME, \ + BIO_CLOSE|BIO_FP_READ|BIO_FP_WRITE,name) + +/* + * WARNING WARNING, this ups the reference count on the read bio of the SSL + * structure. This is because the ssl read BIO is now pointed to by the + * next_bio field in the bio. So when you free the BIO, make sure you are + * doing a BIO_free_all() to catch the underlying BIO. + */ +# define BIO_set_ssl(b,ssl,c) BIO_ctrl(b,BIO_C_SET_SSL,c,(char *)(ssl)) +# define BIO_get_ssl(b,sslp) BIO_ctrl(b,BIO_C_GET_SSL,0,(char *)(sslp)) +# define BIO_set_ssl_mode(b,client) BIO_ctrl(b,BIO_C_SSL_MODE,client,NULL) +# define BIO_set_ssl_renegotiate_bytes(b,num) \ + BIO_ctrl(b,BIO_C_SET_SSL_RENEGOTIATE_BYTES,num,NULL) +# define BIO_get_num_renegotiates(b) \ + BIO_ctrl(b,BIO_C_GET_SSL_NUM_RENEGOTIATES,0,NULL) +# define BIO_set_ssl_renegotiate_timeout(b,seconds) \ + BIO_ctrl(b,BIO_C_SET_SSL_RENEGOTIATE_TIMEOUT,seconds,NULL) + +/* defined in evp.h */ +/* #define BIO_set_md(b,md) BIO_ctrl(b,BIO_C_SET_MD,1,(char *)(md)) */ + +# define BIO_get_mem_data(b,pp) BIO_ctrl(b,BIO_CTRL_INFO,0,(char *)(pp)) +# define BIO_set_mem_buf(b,bm,c) BIO_ctrl(b,BIO_C_SET_BUF_MEM,c,(char *)(bm)) +# define BIO_get_mem_ptr(b,pp) BIO_ctrl(b,BIO_C_GET_BUF_MEM_PTR,0, \ + (char *)(pp)) +# define BIO_set_mem_eof_return(b,v) \ + BIO_ctrl(b,BIO_C_SET_BUF_MEM_EOF_RETURN,v,NULL) + +/* For the BIO_f_buffer() type */ +# define BIO_get_buffer_num_lines(b) BIO_ctrl(b,BIO_C_GET_BUFF_NUM_LINES,0,NULL) +# define BIO_set_buffer_size(b,size) BIO_ctrl(b,BIO_C_SET_BUFF_SIZE,size,NULL) +# define BIO_set_read_buffer_size(b,size) BIO_int_ctrl(b,BIO_C_SET_BUFF_SIZE,size,0) +# define BIO_set_write_buffer_size(b,size) BIO_int_ctrl(b,BIO_C_SET_BUFF_SIZE,size,1) +# define BIO_set_buffer_read_data(b,buf,num) BIO_ctrl(b,BIO_C_SET_BUFF_READ_DATA,num,buf) + +/* Don't use the next one unless you know what you are doing :-) */ +# define BIO_dup_state(b,ret) BIO_ctrl(b,BIO_CTRL_DUP,0,(char *)(ret)) + +# define BIO_reset(b) (int)BIO_ctrl(b,BIO_CTRL_RESET,0,NULL) +# define BIO_eof(b) (int)BIO_ctrl(b,BIO_CTRL_EOF,0,NULL) +# define BIO_set_close(b,c) (int)BIO_ctrl(b,BIO_CTRL_SET_CLOSE,(c),NULL) +# define BIO_get_close(b) (int)BIO_ctrl(b,BIO_CTRL_GET_CLOSE,0,NULL) +# define BIO_pending(b) (int)BIO_ctrl(b,BIO_CTRL_PENDING,0,NULL) +# define BIO_wpending(b) (int)BIO_ctrl(b,BIO_CTRL_WPENDING,0,NULL) +/* ...pending macros have inappropriate return type */ +size_t BIO_ctrl_pending(BIO *b); +size_t BIO_ctrl_wpending(BIO *b); +# define BIO_flush(b) (int)BIO_ctrl(b,BIO_CTRL_FLUSH,0,NULL) +# define BIO_get_info_callback(b,cbp) (int)BIO_ctrl(b,BIO_CTRL_GET_CALLBACK,0, \ + cbp) +# define BIO_set_info_callback(b,cb) (int)BIO_callback_ctrl(b,BIO_CTRL_SET_CALLBACK,cb) + +/* For the BIO_f_buffer() type */ +# define BIO_buffer_get_num_lines(b) BIO_ctrl(b,BIO_CTRL_GET,0,NULL) +# define BIO_buffer_peek(b,s,l) BIO_ctrl(b,BIO_CTRL_PEEK,(l),(s)) + +/* For BIO_s_bio() */ +# define BIO_set_write_buf_size(b,size) (int)BIO_ctrl(b,BIO_C_SET_WRITE_BUF_SIZE,size,NULL) +# define BIO_get_write_buf_size(b,size) (size_t)BIO_ctrl(b,BIO_C_GET_WRITE_BUF_SIZE,size,NULL) +# define BIO_make_bio_pair(b1,b2) (int)BIO_ctrl(b1,BIO_C_MAKE_BIO_PAIR,0,b2) +# define BIO_destroy_bio_pair(b) (int)BIO_ctrl(b,BIO_C_DESTROY_BIO_PAIR,0,NULL) +# define BIO_shutdown_wr(b) (int)BIO_ctrl(b, BIO_C_SHUTDOWN_WR, 0, NULL) +/* macros with inappropriate type -- but ...pending macros use int too: */ +# define BIO_get_write_guarantee(b) (int)BIO_ctrl(b,BIO_C_GET_WRITE_GUARANTEE,0,NULL) +# define BIO_get_read_request(b) (int)BIO_ctrl(b,BIO_C_GET_READ_REQUEST,0,NULL) +size_t BIO_ctrl_get_write_guarantee(BIO *b); +size_t BIO_ctrl_get_read_request(BIO *b); +int BIO_ctrl_reset_read_request(BIO *b); + +/* ctrl macros for dgram */ +# define BIO_ctrl_dgram_connect(b,peer) \ + (int)BIO_ctrl(b,BIO_CTRL_DGRAM_CONNECT,0, (char *)(peer)) +# define BIO_ctrl_set_connected(b,peer) \ + (int)BIO_ctrl(b, BIO_CTRL_DGRAM_SET_CONNECTED, 0, (char *)(peer)) +# define BIO_dgram_recv_timedout(b) \ + (int)BIO_ctrl(b, BIO_CTRL_DGRAM_GET_RECV_TIMER_EXP, 0, NULL) +# define BIO_dgram_send_timedout(b) \ + (int)BIO_ctrl(b, BIO_CTRL_DGRAM_GET_SEND_TIMER_EXP, 0, NULL) +# define BIO_dgram_get_peer(b,peer) \ + (int)BIO_ctrl(b, BIO_CTRL_DGRAM_GET_PEER, 0, (char *)(peer)) +# define BIO_dgram_set_peer(b,peer) \ + (int)BIO_ctrl(b, BIO_CTRL_DGRAM_SET_PEER, 0, (char *)(peer)) +# define BIO_dgram_get_mtu_overhead(b) \ + (unsigned int)BIO_ctrl((b), BIO_CTRL_DGRAM_GET_MTU_OVERHEAD, 0, NULL) + +#define BIO_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_BIO, l, p, newf, dupf, freef) +int BIO_set_ex_data(BIO *bio, int idx, void *data); +void *BIO_get_ex_data(BIO *bio, int idx); +uint64_t BIO_number_read(BIO *bio); +uint64_t BIO_number_written(BIO *bio); + +/* For BIO_f_asn1() */ +int BIO_asn1_set_prefix(BIO *b, asn1_ps_func *prefix, + asn1_ps_func *prefix_free); +int BIO_asn1_get_prefix(BIO *b, asn1_ps_func **pprefix, + asn1_ps_func **pprefix_free); +int BIO_asn1_set_suffix(BIO *b, asn1_ps_func *suffix, + asn1_ps_func *suffix_free); +int BIO_asn1_get_suffix(BIO *b, asn1_ps_func **psuffix, + asn1_ps_func **psuffix_free); + +const BIO_METHOD *BIO_s_file(void); +BIO *BIO_new_file(const char *filename, const char *mode); +# ifndef OPENSSL_NO_STDIO +BIO *BIO_new_fp(FILE *stream, int close_flag); +# endif +BIO *BIO_new(const BIO_METHOD *type); +int BIO_free(BIO *a); +void BIO_set_data(BIO *a, void *ptr); +void *BIO_get_data(BIO *a); +void BIO_set_init(BIO *a, int init); +int BIO_get_init(BIO *a); +void BIO_set_shutdown(BIO *a, int shut); +int BIO_get_shutdown(BIO *a); +void BIO_vfree(BIO *a); +int BIO_up_ref(BIO *a); +int BIO_read(BIO *b, void *data, int dlen); +int BIO_read_ex(BIO *b, void *data, size_t dlen, size_t *readbytes); +int BIO_gets(BIO *bp, char *buf, int size); +int BIO_write(BIO *b, const void *data, int dlen); +int BIO_write_ex(BIO *b, const void *data, size_t dlen, size_t *written); +int BIO_puts(BIO *bp, const char *buf); +int BIO_indent(BIO *b, int indent, int max); +long BIO_ctrl(BIO *bp, int cmd, long larg, void *parg); +long BIO_callback_ctrl(BIO *b, int cmd, BIO_info_cb *fp); +void *BIO_ptr_ctrl(BIO *bp, int cmd, long larg); +long BIO_int_ctrl(BIO *bp, int cmd, long larg, int iarg); +BIO *BIO_push(BIO *b, BIO *append); +BIO *BIO_pop(BIO *b); +void BIO_free_all(BIO *a); +BIO *BIO_find_type(BIO *b, int bio_type); +BIO *BIO_next(BIO *b); +void BIO_set_next(BIO *b, BIO *next); +BIO *BIO_get_retry_BIO(BIO *bio, int *reason); +int BIO_get_retry_reason(BIO *bio); +void BIO_set_retry_reason(BIO *bio, int reason); +BIO *BIO_dup_chain(BIO *in); + +int BIO_nread0(BIO *bio, char **buf); +int BIO_nread(BIO *bio, char **buf, int num); +int BIO_nwrite0(BIO *bio, char **buf); +int BIO_nwrite(BIO *bio, char **buf, int num); + +long BIO_debug_callback(BIO *bio, int cmd, const char *argp, int argi, + long argl, long ret); + +const BIO_METHOD *BIO_s_mem(void); +const BIO_METHOD *BIO_s_secmem(void); +BIO *BIO_new_mem_buf(const void *buf, int len); +# ifndef OPENSSL_NO_SOCK +const BIO_METHOD *BIO_s_socket(void); +const BIO_METHOD *BIO_s_connect(void); +const BIO_METHOD *BIO_s_accept(void); +# endif +const BIO_METHOD *BIO_s_fd(void); +const BIO_METHOD *BIO_s_log(void); +const BIO_METHOD *BIO_s_bio(void); +const BIO_METHOD *BIO_s_null(void); +const BIO_METHOD *BIO_f_null(void); +const BIO_METHOD *BIO_f_buffer(void); +const BIO_METHOD *BIO_f_linebuffer(void); +const BIO_METHOD *BIO_f_nbio_test(void); +# ifndef OPENSSL_NO_DGRAM +const BIO_METHOD *BIO_s_datagram(void); +int BIO_dgram_non_fatal_error(int error); +BIO *BIO_new_dgram(int fd, int close_flag); +# ifndef OPENSSL_NO_SCTP +const BIO_METHOD *BIO_s_datagram_sctp(void); +BIO *BIO_new_dgram_sctp(int fd, int close_flag); +int BIO_dgram_is_sctp(BIO *bio); +int BIO_dgram_sctp_notification_cb(BIO *b, + void (*handle_notifications) (BIO *bio, + void *context, + void *buf), + void *context); +int BIO_dgram_sctp_wait_for_dry(BIO *b); +int BIO_dgram_sctp_msg_waiting(BIO *b); +# endif +# endif + +# ifndef OPENSSL_NO_SOCK +int BIO_sock_should_retry(int i); +int BIO_sock_non_fatal_error(int error); +# endif + +int BIO_fd_should_retry(int i); +int BIO_fd_non_fatal_error(int error); +int BIO_dump_cb(int (*cb) (const void *data, size_t len, void *u), + void *u, const char *s, int len); +int BIO_dump_indent_cb(int (*cb) (const void *data, size_t len, void *u), + void *u, const char *s, int len, int indent); +int BIO_dump(BIO *b, const char *bytes, int len); +int BIO_dump_indent(BIO *b, const char *bytes, int len, int indent); +# ifndef OPENSSL_NO_STDIO +int BIO_dump_fp(FILE *fp, const char *s, int len); +int BIO_dump_indent_fp(FILE *fp, const char *s, int len, int indent); +# endif +int BIO_hex_string(BIO *out, int indent, int width, unsigned char *data, + int datalen); + +# ifndef OPENSSL_NO_SOCK +BIO_ADDR *BIO_ADDR_new(void); +int BIO_ADDR_rawmake(BIO_ADDR *ap, int family, + const void *where, size_t wherelen, unsigned short port); +void BIO_ADDR_free(BIO_ADDR *); +void BIO_ADDR_clear(BIO_ADDR *ap); +int BIO_ADDR_family(const BIO_ADDR *ap); +int BIO_ADDR_rawaddress(const BIO_ADDR *ap, void *p, size_t *l); +unsigned short BIO_ADDR_rawport(const BIO_ADDR *ap); +char *BIO_ADDR_hostname_string(const BIO_ADDR *ap, int numeric); +char *BIO_ADDR_service_string(const BIO_ADDR *ap, int numeric); +char *BIO_ADDR_path_string(const BIO_ADDR *ap); + +const BIO_ADDRINFO *BIO_ADDRINFO_next(const BIO_ADDRINFO *bai); +int BIO_ADDRINFO_family(const BIO_ADDRINFO *bai); +int BIO_ADDRINFO_socktype(const BIO_ADDRINFO *bai); +int BIO_ADDRINFO_protocol(const BIO_ADDRINFO *bai); +const BIO_ADDR *BIO_ADDRINFO_address(const BIO_ADDRINFO *bai); +void BIO_ADDRINFO_free(BIO_ADDRINFO *bai); + +enum BIO_hostserv_priorities { + BIO_PARSE_PRIO_HOST, BIO_PARSE_PRIO_SERV +}; +int BIO_parse_hostserv(const char *hostserv, char **host, char **service, + enum BIO_hostserv_priorities hostserv_prio); +enum BIO_lookup_type { + BIO_LOOKUP_CLIENT, BIO_LOOKUP_SERVER +}; +int BIO_lookup(const char *host, const char *service, + enum BIO_lookup_type lookup_type, + int family, int socktype, BIO_ADDRINFO **res); +int BIO_lookup_ex(const char *host, const char *service, + int lookup_type, int family, int socktype, int protocol, + BIO_ADDRINFO **res); +int BIO_sock_error(int sock); +int BIO_socket_ioctl(int fd, long type, void *arg); +int BIO_socket_nbio(int fd, int mode); +int BIO_sock_init(void); +# if OPENSSL_API_COMPAT < 0x10100000L +# define BIO_sock_cleanup() while(0) continue +# endif +int BIO_set_tcp_ndelay(int sock, int turn_on); + +DEPRECATEDIN_1_1_0(struct hostent *BIO_gethostbyname(const char *name)) +DEPRECATEDIN_1_1_0(int BIO_get_port(const char *str, unsigned short *port_ptr)) +DEPRECATEDIN_1_1_0(int BIO_get_host_ip(const char *str, unsigned char *ip)) +DEPRECATEDIN_1_1_0(int BIO_get_accept_socket(char *host_port, int mode)) +DEPRECATEDIN_1_1_0(int BIO_accept(int sock, char **ip_port)) + +union BIO_sock_info_u { + BIO_ADDR *addr; +}; +enum BIO_sock_info_type { + BIO_SOCK_INFO_ADDRESS +}; +int BIO_sock_info(int sock, + enum BIO_sock_info_type type, union BIO_sock_info_u *info); + +# define BIO_SOCK_REUSEADDR 0x01 +# define BIO_SOCK_V6_ONLY 0x02 +# define BIO_SOCK_KEEPALIVE 0x04 +# define BIO_SOCK_NONBLOCK 0x08 +# define BIO_SOCK_NODELAY 0x10 + +int BIO_socket(int domain, int socktype, int protocol, int options); +int BIO_connect(int sock, const BIO_ADDR *addr, int options); +int BIO_bind(int sock, const BIO_ADDR *addr, int options); +int BIO_listen(int sock, const BIO_ADDR *addr, int options); +int BIO_accept_ex(int accept_sock, BIO_ADDR *addr, int options); +int BIO_closesocket(int sock); + +BIO *BIO_new_socket(int sock, int close_flag); +BIO *BIO_new_connect(const char *host_port); +BIO *BIO_new_accept(const char *host_port); +# endif /* OPENSSL_NO_SOCK*/ + +BIO *BIO_new_fd(int fd, int close_flag); + +int BIO_new_bio_pair(BIO **bio1, size_t writebuf1, + BIO **bio2, size_t writebuf2); +/* + * If successful, returns 1 and in *bio1, *bio2 two BIO pair endpoints. + * Otherwise returns 0 and sets *bio1 and *bio2 to NULL. Size 0 uses default + * value. + */ + +void BIO_copy_next_retry(BIO *b); + +/* + * long BIO_ghbn_ctrl(int cmd,int iarg,char *parg); + */ + +# define ossl_bio__attr__(x) +# if defined(__GNUC__) && defined(__STDC_VERSION__) \ + && !defined(__APPLE__) + /* + * Because we support the 'z' modifier, which made its appearance in C99, + * we can't use __attribute__ with pre C99 dialects. + */ +# if __STDC_VERSION__ >= 199901L +# undef ossl_bio__attr__ +# define ossl_bio__attr__ __attribute__ +# if __GNUC__*10 + __GNUC_MINOR__ >= 44 +# define ossl_bio__printf__ __gnu_printf__ +# else +# define ossl_bio__printf__ __printf__ +# endif +# endif +# endif +int BIO_printf(BIO *bio, const char *format, ...) +ossl_bio__attr__((__format__(ossl_bio__printf__, 2, 3))); +int BIO_vprintf(BIO *bio, const char *format, va_list args) +ossl_bio__attr__((__format__(ossl_bio__printf__, 2, 0))); +int BIO_snprintf(char *buf, size_t n, const char *format, ...) +ossl_bio__attr__((__format__(ossl_bio__printf__, 3, 4))); +int BIO_vsnprintf(char *buf, size_t n, const char *format, va_list args) +ossl_bio__attr__((__format__(ossl_bio__printf__, 3, 0))); +# undef ossl_bio__attr__ +# undef ossl_bio__printf__ + + +BIO_METHOD *BIO_meth_new(int type, const char *name); +void BIO_meth_free(BIO_METHOD *biom); +int (*BIO_meth_get_write(const BIO_METHOD *biom)) (BIO *, const char *, int); +int (*BIO_meth_get_write_ex(const BIO_METHOD *biom)) (BIO *, const char *, size_t, + size_t *); +int BIO_meth_set_write(BIO_METHOD *biom, + int (*write) (BIO *, const char *, int)); +int BIO_meth_set_write_ex(BIO_METHOD *biom, + int (*bwrite) (BIO *, const char *, size_t, size_t *)); +int (*BIO_meth_get_read(const BIO_METHOD *biom)) (BIO *, char *, int); +int (*BIO_meth_get_read_ex(const BIO_METHOD *biom)) (BIO *, char *, size_t, size_t *); +int BIO_meth_set_read(BIO_METHOD *biom, + int (*read) (BIO *, char *, int)); +int BIO_meth_set_read_ex(BIO_METHOD *biom, + int (*bread) (BIO *, char *, size_t, size_t *)); +int (*BIO_meth_get_puts(const BIO_METHOD *biom)) (BIO *, const char *); +int BIO_meth_set_puts(BIO_METHOD *biom, + int (*puts) (BIO *, const char *)); +int (*BIO_meth_get_gets(const BIO_METHOD *biom)) (BIO *, char *, int); +int BIO_meth_set_gets(BIO_METHOD *biom, + int (*gets) (BIO *, char *, int)); +long (*BIO_meth_get_ctrl(const BIO_METHOD *biom)) (BIO *, int, long, void *); +int BIO_meth_set_ctrl(BIO_METHOD *biom, + long (*ctrl) (BIO *, int, long, void *)); +int (*BIO_meth_get_create(const BIO_METHOD *bion)) (BIO *); +int BIO_meth_set_create(BIO_METHOD *biom, int (*create) (BIO *)); +int (*BIO_meth_get_destroy(const BIO_METHOD *biom)) (BIO *); +int BIO_meth_set_destroy(BIO_METHOD *biom, int (*destroy) (BIO *)); +long (*BIO_meth_get_callback_ctrl(const BIO_METHOD *biom)) + (BIO *, int, BIO_info_cb *); +int BIO_meth_set_callback_ctrl(BIO_METHOD *biom, + long (*callback_ctrl) (BIO *, int, + BIO_info_cb *)); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/bioerr.h b/include/openssl/bioerr.h new file mode 100644 index 0000000..f119a59 --- /dev/null +++ b/include/openssl/bioerr.h @@ -0,0 +1,120 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BIOERR_H +# define HEADER_BIOERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_BIO_strings(void); + +/* + * BIO function codes. + */ +# define BIO_F_ACPT_STATE 100 +# define BIO_F_ADDRINFO_WRAP 148 +# define BIO_F_ADDR_STRINGS 134 +# define BIO_F_BIO_ACCEPT 101 +# define BIO_F_BIO_ACCEPT_EX 137 +# define BIO_F_BIO_ACCEPT_NEW 152 +# define BIO_F_BIO_ADDR_NEW 144 +# define BIO_F_BIO_BIND 147 +# define BIO_F_BIO_CALLBACK_CTRL 131 +# define BIO_F_BIO_CONNECT 138 +# define BIO_F_BIO_CONNECT_NEW 153 +# define BIO_F_BIO_CTRL 103 +# define BIO_F_BIO_GETS 104 +# define BIO_F_BIO_GET_HOST_IP 106 +# define BIO_F_BIO_GET_NEW_INDEX 102 +# define BIO_F_BIO_GET_PORT 107 +# define BIO_F_BIO_LISTEN 139 +# define BIO_F_BIO_LOOKUP 135 +# define BIO_F_BIO_LOOKUP_EX 143 +# define BIO_F_BIO_MAKE_PAIR 121 +# define BIO_F_BIO_METH_NEW 146 +# define BIO_F_BIO_NEW 108 +# define BIO_F_BIO_NEW_DGRAM_SCTP 145 +# define BIO_F_BIO_NEW_FILE 109 +# define BIO_F_BIO_NEW_MEM_BUF 126 +# define BIO_F_BIO_NREAD 123 +# define BIO_F_BIO_NREAD0 124 +# define BIO_F_BIO_NWRITE 125 +# define BIO_F_BIO_NWRITE0 122 +# define BIO_F_BIO_PARSE_HOSTSERV 136 +# define BIO_F_BIO_PUTS 110 +# define BIO_F_BIO_READ 111 +# define BIO_F_BIO_READ_EX 105 +# define BIO_F_BIO_READ_INTERN 120 +# define BIO_F_BIO_SOCKET 140 +# define BIO_F_BIO_SOCKET_NBIO 142 +# define BIO_F_BIO_SOCK_INFO 141 +# define BIO_F_BIO_SOCK_INIT 112 +# define BIO_F_BIO_WRITE 113 +# define BIO_F_BIO_WRITE_EX 119 +# define BIO_F_BIO_WRITE_INTERN 128 +# define BIO_F_BUFFER_CTRL 114 +# define BIO_F_CONN_CTRL 127 +# define BIO_F_CONN_STATE 115 +# define BIO_F_DGRAM_SCTP_NEW 149 +# define BIO_F_DGRAM_SCTP_READ 132 +# define BIO_F_DGRAM_SCTP_WRITE 133 +# define BIO_F_DOAPR_OUTCH 150 +# define BIO_F_FILE_CTRL 116 +# define BIO_F_FILE_READ 130 +# define BIO_F_LINEBUFFER_CTRL 129 +# define BIO_F_LINEBUFFER_NEW 151 +# define BIO_F_MEM_WRITE 117 +# define BIO_F_NBIOF_NEW 154 +# define BIO_F_SLG_WRITE 155 +# define BIO_F_SSL_NEW 118 + +/* + * BIO reason codes. + */ +# define BIO_R_ACCEPT_ERROR 100 +# define BIO_R_ADDRINFO_ADDR_IS_NOT_AF_INET 141 +# define BIO_R_AMBIGUOUS_HOST_OR_SERVICE 129 +# define BIO_R_BAD_FOPEN_MODE 101 +# define BIO_R_BROKEN_PIPE 124 +# define BIO_R_CONNECT_ERROR 103 +# define BIO_R_GETHOSTBYNAME_ADDR_IS_NOT_AF_INET 107 +# define BIO_R_GETSOCKNAME_ERROR 132 +# define BIO_R_GETSOCKNAME_TRUNCATED_ADDRESS 133 +# define BIO_R_GETTING_SOCKTYPE 134 +# define BIO_R_INVALID_ARGUMENT 125 +# define BIO_R_INVALID_SOCKET 135 +# define BIO_R_IN_USE 123 +# define BIO_R_LENGTH_TOO_LONG 102 +# define BIO_R_LISTEN_V6_ONLY 136 +# define BIO_R_LOOKUP_RETURNED_NOTHING 142 +# define BIO_R_MALFORMED_HOST_OR_SERVICE 130 +# define BIO_R_NBIO_CONNECT_ERROR 110 +# define BIO_R_NO_ACCEPT_ADDR_OR_SERVICE_SPECIFIED 143 +# define BIO_R_NO_HOSTNAME_OR_SERVICE_SPECIFIED 144 +# define BIO_R_NO_PORT_DEFINED 113 +# define BIO_R_NO_SUCH_FILE 128 +# define BIO_R_NULL_PARAMETER 115 +# define BIO_R_UNABLE_TO_BIND_SOCKET 117 +# define BIO_R_UNABLE_TO_CREATE_SOCKET 118 +# define BIO_R_UNABLE_TO_KEEPALIVE 137 +# define BIO_R_UNABLE_TO_LISTEN_SOCKET 119 +# define BIO_R_UNABLE_TO_NODELAY 138 +# define BIO_R_UNABLE_TO_REUSEADDR 139 +# define BIO_R_UNAVAILABLE_IP_FAMILY 145 +# define BIO_R_UNINITIALIZED 120 +# define BIO_R_UNKNOWN_INFO_TYPE 140 +# define BIO_R_UNSUPPORTED_IP_FAMILY 146 +# define BIO_R_UNSUPPORTED_METHOD 121 +# define BIO_R_UNSUPPORTED_PROTOCOL_FAMILY 131 +# define BIO_R_WRITE_TO_READ_ONLY_BIO 126 +# define BIO_R_WSASTARTUP 122 + +#endif diff --git a/include/openssl/blowfish.h b/include/openssl/blowfish.h new file mode 100644 index 0000000..62cf9db --- /dev/null +++ b/include/openssl/blowfish.h @@ -0,0 +1,61 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BLOWFISH_H +# define HEADER_BLOWFISH_H + +# include + +# ifndef OPENSSL_NO_BF +# include +# ifdef __cplusplus +extern "C" { +# endif + +# define BF_ENCRYPT 1 +# define BF_DECRYPT 0 + +/*- + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + * ! BF_LONG has to be at least 32 bits wide. ! + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + */ +# define BF_LONG unsigned int + +# define BF_ROUNDS 16 +# define BF_BLOCK 8 + +typedef struct bf_key_st { + BF_LONG P[BF_ROUNDS + 2]; + BF_LONG S[4 * 256]; +} BF_KEY; + +void BF_set_key(BF_KEY *key, int len, const unsigned char *data); + +void BF_encrypt(BF_LONG *data, const BF_KEY *key); +void BF_decrypt(BF_LONG *data, const BF_KEY *key); + +void BF_ecb_encrypt(const unsigned char *in, unsigned char *out, + const BF_KEY *key, int enc); +void BF_cbc_encrypt(const unsigned char *in, unsigned char *out, long length, + const BF_KEY *schedule, unsigned char *ivec, int enc); +void BF_cfb64_encrypt(const unsigned char *in, unsigned char *out, + long length, const BF_KEY *schedule, + unsigned char *ivec, int *num, int enc); +void BF_ofb64_encrypt(const unsigned char *in, unsigned char *out, + long length, const BF_KEY *schedule, + unsigned char *ivec, int *num); +const char *BF_options(void); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/bn.h b/include/openssl/bn.h new file mode 100644 index 0000000..ff3c663 --- /dev/null +++ b/include/openssl/bn.h @@ -0,0 +1,539 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BN_H +# define HEADER_BN_H + +# include +# ifndef OPENSSL_NO_STDIO +# include +# endif +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* + * 64-bit processor with LP64 ABI + */ +# ifdef SIXTY_FOUR_BIT_LONG +# define BN_ULONG unsigned long +# define BN_BYTES 8 +# endif + +/* + * 64-bit processor other than LP64 ABI + */ +# ifdef SIXTY_FOUR_BIT +# define BN_ULONG unsigned long long +# define BN_BYTES 8 +# endif + +# ifdef THIRTY_TWO_BIT +# define BN_ULONG unsigned int +# define BN_BYTES 4 +# endif + +# define BN_BITS2 (BN_BYTES * 8) +# define BN_BITS (BN_BITS2 * 2) +# define BN_TBIT ((BN_ULONG)1 << (BN_BITS2 - 1)) + +# define BN_FLG_MALLOCED 0x01 +# define BN_FLG_STATIC_DATA 0x02 + +/* + * avoid leaking exponent information through timing, + * BN_mod_exp_mont() will call BN_mod_exp_mont_consttime, + * BN_div() will call BN_div_no_branch, + * BN_mod_inverse() will call BN_mod_inverse_no_branch. + */ +# define BN_FLG_CONSTTIME 0x04 +# define BN_FLG_SECURE 0x08 + +# if OPENSSL_API_COMPAT < 0x00908000L +/* deprecated name for the flag */ +# define BN_FLG_EXP_CONSTTIME BN_FLG_CONSTTIME +# define BN_FLG_FREE 0x8000 /* used for debugging */ +# endif + +void BN_set_flags(BIGNUM *b, int n); +int BN_get_flags(const BIGNUM *b, int n); + +/* Values for |top| in BN_rand() */ +#define BN_RAND_TOP_ANY -1 +#define BN_RAND_TOP_ONE 0 +#define BN_RAND_TOP_TWO 1 + +/* Values for |bottom| in BN_rand() */ +#define BN_RAND_BOTTOM_ANY 0 +#define BN_RAND_BOTTOM_ODD 1 + +/* + * get a clone of a BIGNUM with changed flags, for *temporary* use only (the + * two BIGNUMs cannot be used in parallel!). Also only for *read only* use. The + * value |dest| should be a newly allocated BIGNUM obtained via BN_new() that + * has not been otherwise initialised or used. + */ +void BN_with_flags(BIGNUM *dest, const BIGNUM *b, int flags); + +/* Wrapper function to make using BN_GENCB easier */ +int BN_GENCB_call(BN_GENCB *cb, int a, int b); + +BN_GENCB *BN_GENCB_new(void); +void BN_GENCB_free(BN_GENCB *cb); + +/* Populate a BN_GENCB structure with an "old"-style callback */ +void BN_GENCB_set_old(BN_GENCB *gencb, void (*callback) (int, int, void *), + void *cb_arg); + +/* Populate a BN_GENCB structure with a "new"-style callback */ +void BN_GENCB_set(BN_GENCB *gencb, int (*callback) (int, int, BN_GENCB *), + void *cb_arg); + +void *BN_GENCB_get_arg(BN_GENCB *cb); + +# define BN_prime_checks 0 /* default: select number of iterations based + * on the size of the number */ + +/* + * BN_prime_checks_for_size() returns the number of Miller-Rabin iterations + * that will be done for checking that a random number is probably prime. The + * error rate for accepting a composite number as prime depends on the size of + * the prime |b|. The error rates used are for calculating an RSA key with 2 primes, + * and so the level is what you would expect for a key of double the size of the + * prime. + * + * This table is generated using the algorithm of FIPS PUB 186-4 + * Digital Signature Standard (DSS), section F.1, page 117. + * (https://dx.doi.org/10.6028/NIST.FIPS.186-4) + * + * The following magma script was used to generate the output: + * securitybits:=125; + * k:=1024; + * for t:=1 to 65 do + * for M:=3 to Floor(2*Sqrt(k-1)-1) do + * S:=0; + * // Sum over m + * for m:=3 to M do + * s:=0; + * // Sum over j + * for j:=2 to m do + * s+:=(RealField(32)!2)^-(j+(k-1)/j); + * end for; + * S+:=2^(m-(m-1)*t)*s; + * end for; + * A:=2^(k-2-M*t); + * B:=8*(Pi(RealField(32))^2-6)/3*2^(k-2)*S; + * pkt:=2.00743*Log(2)*k*2^-k*(A+B); + * seclevel:=Floor(-Log(2,pkt)); + * if seclevel ge securitybits then + * printf "k: %5o, security: %o bits (t: %o, M: %o)\n",k,seclevel,t,M; + * break; + * end if; + * end for; + * if seclevel ge securitybits then break; end if; + * end for; + * + * It can be run online at: + * http://magma.maths.usyd.edu.au/calc + * + * And will output: + * k: 1024, security: 129 bits (t: 6, M: 23) + * + * k is the number of bits of the prime, securitybits is the level we want to + * reach. + * + * prime length | RSA key size | # MR tests | security level + * -------------+--------------|------------+--------------- + * (b) >= 6394 | >= 12788 | 3 | 256 bit + * (b) >= 3747 | >= 7494 | 3 | 192 bit + * (b) >= 1345 | >= 2690 | 4 | 128 bit + * (b) >= 1080 | >= 2160 | 5 | 128 bit + * (b) >= 852 | >= 1704 | 5 | 112 bit + * (b) >= 476 | >= 952 | 5 | 80 bit + * (b) >= 400 | >= 800 | 6 | 80 bit + * (b) >= 347 | >= 694 | 7 | 80 bit + * (b) >= 308 | >= 616 | 8 | 80 bit + * (b) >= 55 | >= 110 | 27 | 64 bit + * (b) >= 6 | >= 12 | 34 | 64 bit + */ + +# define BN_prime_checks_for_size(b) ((b) >= 3747 ? 3 : \ + (b) >= 1345 ? 4 : \ + (b) >= 476 ? 5 : \ + (b) >= 400 ? 6 : \ + (b) >= 347 ? 7 : \ + (b) >= 308 ? 8 : \ + (b) >= 55 ? 27 : \ + /* b >= 6 */ 34) + +# define BN_num_bytes(a) ((BN_num_bits(a)+7)/8) + +int BN_abs_is_word(const BIGNUM *a, const BN_ULONG w); +int BN_is_zero(const BIGNUM *a); +int BN_is_one(const BIGNUM *a); +int BN_is_word(const BIGNUM *a, const BN_ULONG w); +int BN_is_odd(const BIGNUM *a); + +# define BN_one(a) (BN_set_word((a),1)) + +void BN_zero_ex(BIGNUM *a); + +# if OPENSSL_API_COMPAT >= 0x00908000L +# define BN_zero(a) BN_zero_ex(a) +# else +# define BN_zero(a) (BN_set_word((a),0)) +# endif + +const BIGNUM *BN_value_one(void); +char *BN_options(void); +BN_CTX *BN_CTX_new(void); +BN_CTX *BN_CTX_secure_new(void); +void BN_CTX_free(BN_CTX *c); +void BN_CTX_start(BN_CTX *ctx); +BIGNUM *BN_CTX_get(BN_CTX *ctx); +void BN_CTX_end(BN_CTX *ctx); +int BN_rand(BIGNUM *rnd, int bits, int top, int bottom); +int BN_priv_rand(BIGNUM *rnd, int bits, int top, int bottom); +int BN_rand_range(BIGNUM *rnd, const BIGNUM *range); +int BN_priv_rand_range(BIGNUM *rnd, const BIGNUM *range); +int BN_pseudo_rand(BIGNUM *rnd, int bits, int top, int bottom); +int BN_pseudo_rand_range(BIGNUM *rnd, const BIGNUM *range); +int BN_num_bits(const BIGNUM *a); +int BN_num_bits_word(BN_ULONG l); +int BN_security_bits(int L, int N); +BIGNUM *BN_new(void); +BIGNUM *BN_secure_new(void); +void BN_clear_free(BIGNUM *a); +BIGNUM *BN_copy(BIGNUM *a, const BIGNUM *b); +void BN_swap(BIGNUM *a, BIGNUM *b); +BIGNUM *BN_bin2bn(const unsigned char *s, int len, BIGNUM *ret); +int BN_bn2bin(const BIGNUM *a, unsigned char *to); +int BN_bn2binpad(const BIGNUM *a, unsigned char *to, int tolen); +BIGNUM *BN_lebin2bn(const unsigned char *s, int len, BIGNUM *ret); +int BN_bn2lebinpad(const BIGNUM *a, unsigned char *to, int tolen); +BIGNUM *BN_mpi2bn(const unsigned char *s, int len, BIGNUM *ret); +int BN_bn2mpi(const BIGNUM *a, unsigned char *to); +int BN_sub(BIGNUM *r, const BIGNUM *a, const BIGNUM *b); +int BN_usub(BIGNUM *r, const BIGNUM *a, const BIGNUM *b); +int BN_uadd(BIGNUM *r, const BIGNUM *a, const BIGNUM *b); +int BN_add(BIGNUM *r, const BIGNUM *a, const BIGNUM *b); +int BN_mul(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx); +int BN_sqr(BIGNUM *r, const BIGNUM *a, BN_CTX *ctx); +/** BN_set_negative sets sign of a BIGNUM + * \param b pointer to the BIGNUM object + * \param n 0 if the BIGNUM b should be positive and a value != 0 otherwise + */ +void BN_set_negative(BIGNUM *b, int n); +/** BN_is_negative returns 1 if the BIGNUM is negative + * \param b pointer to the BIGNUM object + * \return 1 if a < 0 and 0 otherwise + */ +int BN_is_negative(const BIGNUM *b); + +int BN_div(BIGNUM *dv, BIGNUM *rem, const BIGNUM *m, const BIGNUM *d, + BN_CTX *ctx); +# define BN_mod(rem,m,d,ctx) BN_div(NULL,(rem),(m),(d),(ctx)) +int BN_nnmod(BIGNUM *r, const BIGNUM *m, const BIGNUM *d, BN_CTX *ctx); +int BN_mod_add(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, const BIGNUM *m, + BN_CTX *ctx); +int BN_mod_add_quick(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const BIGNUM *m); +int BN_mod_sub(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, const BIGNUM *m, + BN_CTX *ctx); +int BN_mod_sub_quick(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const BIGNUM *m); +int BN_mod_mul(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, const BIGNUM *m, + BN_CTX *ctx); +int BN_mod_sqr(BIGNUM *r, const BIGNUM *a, const BIGNUM *m, BN_CTX *ctx); +int BN_mod_lshift1(BIGNUM *r, const BIGNUM *a, const BIGNUM *m, BN_CTX *ctx); +int BN_mod_lshift1_quick(BIGNUM *r, const BIGNUM *a, const BIGNUM *m); +int BN_mod_lshift(BIGNUM *r, const BIGNUM *a, int n, const BIGNUM *m, + BN_CTX *ctx); +int BN_mod_lshift_quick(BIGNUM *r, const BIGNUM *a, int n, const BIGNUM *m); + +BN_ULONG BN_mod_word(const BIGNUM *a, BN_ULONG w); +BN_ULONG BN_div_word(BIGNUM *a, BN_ULONG w); +int BN_mul_word(BIGNUM *a, BN_ULONG w); +int BN_add_word(BIGNUM *a, BN_ULONG w); +int BN_sub_word(BIGNUM *a, BN_ULONG w); +int BN_set_word(BIGNUM *a, BN_ULONG w); +BN_ULONG BN_get_word(const BIGNUM *a); + +int BN_cmp(const BIGNUM *a, const BIGNUM *b); +void BN_free(BIGNUM *a); +int BN_is_bit_set(const BIGNUM *a, int n); +int BN_lshift(BIGNUM *r, const BIGNUM *a, int n); +int BN_lshift1(BIGNUM *r, const BIGNUM *a); +int BN_exp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx); + +int BN_mod_exp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, + const BIGNUM *m, BN_CTX *ctx); +int BN_mod_exp_mont(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, + const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx); +int BN_mod_exp_mont_consttime(BIGNUM *rr, const BIGNUM *a, const BIGNUM *p, + const BIGNUM *m, BN_CTX *ctx, + BN_MONT_CTX *in_mont); +int BN_mod_exp_mont_word(BIGNUM *r, BN_ULONG a, const BIGNUM *p, + const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx); +int BN_mod_exp2_mont(BIGNUM *r, const BIGNUM *a1, const BIGNUM *p1, + const BIGNUM *a2, const BIGNUM *p2, const BIGNUM *m, + BN_CTX *ctx, BN_MONT_CTX *m_ctx); +int BN_mod_exp_simple(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, + const BIGNUM *m, BN_CTX *ctx); + +int BN_mask_bits(BIGNUM *a, int n); +# ifndef OPENSSL_NO_STDIO +int BN_print_fp(FILE *fp, const BIGNUM *a); +# endif +int BN_print(BIO *bio, const BIGNUM *a); +int BN_reciprocal(BIGNUM *r, const BIGNUM *m, int len, BN_CTX *ctx); +int BN_rshift(BIGNUM *r, const BIGNUM *a, int n); +int BN_rshift1(BIGNUM *r, const BIGNUM *a); +void BN_clear(BIGNUM *a); +BIGNUM *BN_dup(const BIGNUM *a); +int BN_ucmp(const BIGNUM *a, const BIGNUM *b); +int BN_set_bit(BIGNUM *a, int n); +int BN_clear_bit(BIGNUM *a, int n); +char *BN_bn2hex(const BIGNUM *a); +char *BN_bn2dec(const BIGNUM *a); +int BN_hex2bn(BIGNUM **a, const char *str); +int BN_dec2bn(BIGNUM **a, const char *str); +int BN_asc2bn(BIGNUM **a, const char *str); +int BN_gcd(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx); +int BN_kronecker(const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx); /* returns + * -2 for + * error */ +BIGNUM *BN_mod_inverse(BIGNUM *ret, + const BIGNUM *a, const BIGNUM *n, BN_CTX *ctx); +BIGNUM *BN_mod_sqrt(BIGNUM *ret, + const BIGNUM *a, const BIGNUM *n, BN_CTX *ctx); + +void BN_consttime_swap(BN_ULONG swap, BIGNUM *a, BIGNUM *b, int nwords); + +/* Deprecated versions */ +DEPRECATEDIN_0_9_8(BIGNUM *BN_generate_prime(BIGNUM *ret, int bits, int safe, + const BIGNUM *add, + const BIGNUM *rem, + void (*callback) (int, int, + void *), + void *cb_arg)) +DEPRECATEDIN_0_9_8(int + BN_is_prime(const BIGNUM *p, int nchecks, + void (*callback) (int, int, void *), + BN_CTX *ctx, void *cb_arg)) +DEPRECATEDIN_0_9_8(int + BN_is_prime_fasttest(const BIGNUM *p, int nchecks, + void (*callback) (int, int, void *), + BN_CTX *ctx, void *cb_arg, + int do_trial_division)) + +/* Newer versions */ +int BN_generate_prime_ex(BIGNUM *ret, int bits, int safe, const BIGNUM *add, + const BIGNUM *rem, BN_GENCB *cb); +int BN_is_prime_ex(const BIGNUM *p, int nchecks, BN_CTX *ctx, BN_GENCB *cb); +int BN_is_prime_fasttest_ex(const BIGNUM *p, int nchecks, BN_CTX *ctx, + int do_trial_division, BN_GENCB *cb); + +int BN_X931_generate_Xpq(BIGNUM *Xp, BIGNUM *Xq, int nbits, BN_CTX *ctx); + +int BN_X931_derive_prime_ex(BIGNUM *p, BIGNUM *p1, BIGNUM *p2, + const BIGNUM *Xp, const BIGNUM *Xp1, + const BIGNUM *Xp2, const BIGNUM *e, BN_CTX *ctx, + BN_GENCB *cb); +int BN_X931_generate_prime_ex(BIGNUM *p, BIGNUM *p1, BIGNUM *p2, BIGNUM *Xp1, + BIGNUM *Xp2, const BIGNUM *Xp, const BIGNUM *e, + BN_CTX *ctx, BN_GENCB *cb); + +BN_MONT_CTX *BN_MONT_CTX_new(void); +int BN_mod_mul_montgomery(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + BN_MONT_CTX *mont, BN_CTX *ctx); +int BN_to_montgomery(BIGNUM *r, const BIGNUM *a, BN_MONT_CTX *mont, + BN_CTX *ctx); +int BN_from_montgomery(BIGNUM *r, const BIGNUM *a, BN_MONT_CTX *mont, + BN_CTX *ctx); +void BN_MONT_CTX_free(BN_MONT_CTX *mont); +int BN_MONT_CTX_set(BN_MONT_CTX *mont, const BIGNUM *mod, BN_CTX *ctx); +BN_MONT_CTX *BN_MONT_CTX_copy(BN_MONT_CTX *to, BN_MONT_CTX *from); +BN_MONT_CTX *BN_MONT_CTX_set_locked(BN_MONT_CTX **pmont, CRYPTO_RWLOCK *lock, + const BIGNUM *mod, BN_CTX *ctx); + +/* BN_BLINDING flags */ +# define BN_BLINDING_NO_UPDATE 0x00000001 +# define BN_BLINDING_NO_RECREATE 0x00000002 + +BN_BLINDING *BN_BLINDING_new(const BIGNUM *A, const BIGNUM *Ai, BIGNUM *mod); +void BN_BLINDING_free(BN_BLINDING *b); +int BN_BLINDING_update(BN_BLINDING *b, BN_CTX *ctx); +int BN_BLINDING_convert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx); +int BN_BLINDING_invert(BIGNUM *n, BN_BLINDING *b, BN_CTX *ctx); +int BN_BLINDING_convert_ex(BIGNUM *n, BIGNUM *r, BN_BLINDING *b, BN_CTX *); +int BN_BLINDING_invert_ex(BIGNUM *n, const BIGNUM *r, BN_BLINDING *b, + BN_CTX *); + +int BN_BLINDING_is_current_thread(BN_BLINDING *b); +void BN_BLINDING_set_current_thread(BN_BLINDING *b); +int BN_BLINDING_lock(BN_BLINDING *b); +int BN_BLINDING_unlock(BN_BLINDING *b); + +unsigned long BN_BLINDING_get_flags(const BN_BLINDING *); +void BN_BLINDING_set_flags(BN_BLINDING *, unsigned long); +BN_BLINDING *BN_BLINDING_create_param(BN_BLINDING *b, + const BIGNUM *e, BIGNUM *m, BN_CTX *ctx, + int (*bn_mod_exp) (BIGNUM *r, + const BIGNUM *a, + const BIGNUM *p, + const BIGNUM *m, + BN_CTX *ctx, + BN_MONT_CTX *m_ctx), + BN_MONT_CTX *m_ctx); + +DEPRECATEDIN_0_9_8(void BN_set_params(int mul, int high, int low, int mont)) +DEPRECATEDIN_0_9_8(int BN_get_params(int which)) /* 0, mul, 1 high, 2 low, 3 + * mont */ + +BN_RECP_CTX *BN_RECP_CTX_new(void); +void BN_RECP_CTX_free(BN_RECP_CTX *recp); +int BN_RECP_CTX_set(BN_RECP_CTX *recp, const BIGNUM *rdiv, BN_CTX *ctx); +int BN_mod_mul_reciprocal(BIGNUM *r, const BIGNUM *x, const BIGNUM *y, + BN_RECP_CTX *recp, BN_CTX *ctx); +int BN_mod_exp_recp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, + const BIGNUM *m, BN_CTX *ctx); +int BN_div_recp(BIGNUM *dv, BIGNUM *rem, const BIGNUM *m, + BN_RECP_CTX *recp, BN_CTX *ctx); + +# ifndef OPENSSL_NO_EC2M + +/* + * Functions for arithmetic over binary polynomials represented by BIGNUMs. + * The BIGNUM::neg property of BIGNUMs representing binary polynomials is + * ignored. Note that input arguments are not const so that their bit arrays + * can be expanded to the appropriate size if needed. + */ + +/* + * r = a + b + */ +int BN_GF2m_add(BIGNUM *r, const BIGNUM *a, const BIGNUM *b); +# define BN_GF2m_sub(r, a, b) BN_GF2m_add(r, a, b) +/* + * r=a mod p + */ +int BN_GF2m_mod(BIGNUM *r, const BIGNUM *a, const BIGNUM *p); +/* r = (a * b) mod p */ +int BN_GF2m_mod_mul(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const BIGNUM *p, BN_CTX *ctx); +/* r = (a * a) mod p */ +int BN_GF2m_mod_sqr(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx); +/* r = (1 / b) mod p */ +int BN_GF2m_mod_inv(BIGNUM *r, const BIGNUM *b, const BIGNUM *p, BN_CTX *ctx); +/* r = (a / b) mod p */ +int BN_GF2m_mod_div(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const BIGNUM *p, BN_CTX *ctx); +/* r = (a ^ b) mod p */ +int BN_GF2m_mod_exp(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const BIGNUM *p, BN_CTX *ctx); +/* r = sqrt(a) mod p */ +int BN_GF2m_mod_sqrt(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, + BN_CTX *ctx); +/* r^2 + r = a mod p */ +int BN_GF2m_mod_solve_quad(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, + BN_CTX *ctx); +# define BN_GF2m_cmp(a, b) BN_ucmp((a), (b)) +/*- + * Some functions allow for representation of the irreducible polynomials + * as an unsigned int[], say p. The irreducible f(t) is then of the form: + * t^p[0] + t^p[1] + ... + t^p[k] + * where m = p[0] > p[1] > ... > p[k] = 0. + */ +/* r = a mod p */ +int BN_GF2m_mod_arr(BIGNUM *r, const BIGNUM *a, const int p[]); +/* r = (a * b) mod p */ +int BN_GF2m_mod_mul_arr(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const int p[], BN_CTX *ctx); +/* r = (a * a) mod p */ +int BN_GF2m_mod_sqr_arr(BIGNUM *r, const BIGNUM *a, const int p[], + BN_CTX *ctx); +/* r = (1 / b) mod p */ +int BN_GF2m_mod_inv_arr(BIGNUM *r, const BIGNUM *b, const int p[], + BN_CTX *ctx); +/* r = (a / b) mod p */ +int BN_GF2m_mod_div_arr(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const int p[], BN_CTX *ctx); +/* r = (a ^ b) mod p */ +int BN_GF2m_mod_exp_arr(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const int p[], BN_CTX *ctx); +/* r = sqrt(a) mod p */ +int BN_GF2m_mod_sqrt_arr(BIGNUM *r, const BIGNUM *a, + const int p[], BN_CTX *ctx); +/* r^2 + r = a mod p */ +int BN_GF2m_mod_solve_quad_arr(BIGNUM *r, const BIGNUM *a, + const int p[], BN_CTX *ctx); +int BN_GF2m_poly2arr(const BIGNUM *a, int p[], int max); +int BN_GF2m_arr2poly(const int p[], BIGNUM *a); + +# endif + +/* + * faster mod functions for the 'NIST primes' 0 <= a < p^2 + */ +int BN_nist_mod_192(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx); +int BN_nist_mod_224(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx); +int BN_nist_mod_256(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx); +int BN_nist_mod_384(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx); +int BN_nist_mod_521(BIGNUM *r, const BIGNUM *a, const BIGNUM *p, BN_CTX *ctx); + +const BIGNUM *BN_get0_nist_prime_192(void); +const BIGNUM *BN_get0_nist_prime_224(void); +const BIGNUM *BN_get0_nist_prime_256(void); +const BIGNUM *BN_get0_nist_prime_384(void); +const BIGNUM *BN_get0_nist_prime_521(void); + +int (*BN_nist_mod_func(const BIGNUM *p)) (BIGNUM *r, const BIGNUM *a, + const BIGNUM *field, BN_CTX *ctx); + +int BN_generate_dsa_nonce(BIGNUM *out, const BIGNUM *range, + const BIGNUM *priv, const unsigned char *message, + size_t message_len, BN_CTX *ctx); + +/* Primes from RFC 2409 */ +BIGNUM *BN_get_rfc2409_prime_768(BIGNUM *bn); +BIGNUM *BN_get_rfc2409_prime_1024(BIGNUM *bn); + +/* Primes from RFC 3526 */ +BIGNUM *BN_get_rfc3526_prime_1536(BIGNUM *bn); +BIGNUM *BN_get_rfc3526_prime_2048(BIGNUM *bn); +BIGNUM *BN_get_rfc3526_prime_3072(BIGNUM *bn); +BIGNUM *BN_get_rfc3526_prime_4096(BIGNUM *bn); +BIGNUM *BN_get_rfc3526_prime_6144(BIGNUM *bn); +BIGNUM *BN_get_rfc3526_prime_8192(BIGNUM *bn); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define get_rfc2409_prime_768 BN_get_rfc2409_prime_768 +# define get_rfc2409_prime_1024 BN_get_rfc2409_prime_1024 +# define get_rfc3526_prime_1536 BN_get_rfc3526_prime_1536 +# define get_rfc3526_prime_2048 BN_get_rfc3526_prime_2048 +# define get_rfc3526_prime_3072 BN_get_rfc3526_prime_3072 +# define get_rfc3526_prime_4096 BN_get_rfc3526_prime_4096 +# define get_rfc3526_prime_6144 BN_get_rfc3526_prime_6144 +# define get_rfc3526_prime_8192 BN_get_rfc3526_prime_8192 +# endif + +int BN_bntest_rand(BIGNUM *rnd, int bits, int top, int bottom); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/bnerr.h b/include/openssl/bnerr.h new file mode 100644 index 0000000..8a022cc --- /dev/null +++ b/include/openssl/bnerr.h @@ -0,0 +1,96 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BNERR_H +# define HEADER_BNERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_BN_strings(void); + +/* + * BN function codes. + */ +# define BN_F_BNRAND 127 +# define BN_F_BNRAND_RANGE 138 +# define BN_F_BN_BLINDING_CONVERT_EX 100 +# define BN_F_BN_BLINDING_CREATE_PARAM 128 +# define BN_F_BN_BLINDING_INVERT_EX 101 +# define BN_F_BN_BLINDING_NEW 102 +# define BN_F_BN_BLINDING_UPDATE 103 +# define BN_F_BN_BN2DEC 104 +# define BN_F_BN_BN2HEX 105 +# define BN_F_BN_COMPUTE_WNAF 142 +# define BN_F_BN_CTX_GET 116 +# define BN_F_BN_CTX_NEW 106 +# define BN_F_BN_CTX_START 129 +# define BN_F_BN_DIV 107 +# define BN_F_BN_DIV_RECP 130 +# define BN_F_BN_EXP 123 +# define BN_F_BN_EXPAND_INTERNAL 120 +# define BN_F_BN_GENCB_NEW 143 +# define BN_F_BN_GENERATE_DSA_NONCE 140 +# define BN_F_BN_GENERATE_PRIME_EX 141 +# define BN_F_BN_GF2M_MOD 131 +# define BN_F_BN_GF2M_MOD_EXP 132 +# define BN_F_BN_GF2M_MOD_MUL 133 +# define BN_F_BN_GF2M_MOD_SOLVE_QUAD 134 +# define BN_F_BN_GF2M_MOD_SOLVE_QUAD_ARR 135 +# define BN_F_BN_GF2M_MOD_SQR 136 +# define BN_F_BN_GF2M_MOD_SQRT 137 +# define BN_F_BN_LSHIFT 145 +# define BN_F_BN_MOD_EXP2_MONT 118 +# define BN_F_BN_MOD_EXP_MONT 109 +# define BN_F_BN_MOD_EXP_MONT_CONSTTIME 124 +# define BN_F_BN_MOD_EXP_MONT_WORD 117 +# define BN_F_BN_MOD_EXP_RECP 125 +# define BN_F_BN_MOD_EXP_SIMPLE 126 +# define BN_F_BN_MOD_INVERSE 110 +# define BN_F_BN_MOD_INVERSE_NO_BRANCH 139 +# define BN_F_BN_MOD_LSHIFT_QUICK 119 +# define BN_F_BN_MOD_SQRT 121 +# define BN_F_BN_MONT_CTX_NEW 149 +# define BN_F_BN_MPI2BN 112 +# define BN_F_BN_NEW 113 +# define BN_F_BN_POOL_GET 147 +# define BN_F_BN_RAND 114 +# define BN_F_BN_RAND_RANGE 122 +# define BN_F_BN_RECP_CTX_NEW 150 +# define BN_F_BN_RSHIFT 146 +# define BN_F_BN_SET_WORDS 144 +# define BN_F_BN_STACK_PUSH 148 +# define BN_F_BN_USUB 115 + +/* + * BN reason codes. + */ +# define BN_R_ARG2_LT_ARG3 100 +# define BN_R_BAD_RECIPROCAL 101 +# define BN_R_BIGNUM_TOO_LONG 114 +# define BN_R_BITS_TOO_SMALL 118 +# define BN_R_CALLED_WITH_EVEN_MODULUS 102 +# define BN_R_DIV_BY_ZERO 103 +# define BN_R_ENCODING_ERROR 104 +# define BN_R_EXPAND_ON_STATIC_BIGNUM_DATA 105 +# define BN_R_INPUT_NOT_REDUCED 110 +# define BN_R_INVALID_LENGTH 106 +# define BN_R_INVALID_RANGE 115 +# define BN_R_INVALID_SHIFT 119 +# define BN_R_NOT_A_SQUARE 111 +# define BN_R_NOT_INITIALIZED 107 +# define BN_R_NO_INVERSE 108 +# define BN_R_NO_SOLUTION 116 +# define BN_R_PRIVATE_KEY_TOO_LARGE 117 +# define BN_R_P_IS_NOT_PRIME 112 +# define BN_R_TOO_MANY_ITERATIONS 113 +# define BN_R_TOO_MANY_TEMPORARY_VARIABLES 109 + +#endif diff --git a/include/openssl/buffer.h b/include/openssl/buffer.h new file mode 100644 index 0000000..45dc975 --- /dev/null +++ b/include/openssl/buffer.h @@ -0,0 +1,58 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BUFFER_H +# define HEADER_BUFFER_H + +# include +# ifndef HEADER_CRYPTO_H +# include +# endif +# include + + +#ifdef __cplusplus +extern "C" { +#endif + +# include +# include + +/* + * These names are outdated as of OpenSSL 1.1; a future release + * will move them to be deprecated. + */ +# define BUF_strdup(s) OPENSSL_strdup(s) +# define BUF_strndup(s, size) OPENSSL_strndup(s, size) +# define BUF_memdup(data, size) OPENSSL_memdup(data, size) +# define BUF_strlcpy(dst, src, size) OPENSSL_strlcpy(dst, src, size) +# define BUF_strlcat(dst, src, size) OPENSSL_strlcat(dst, src, size) +# define BUF_strnlen(str, maxlen) OPENSSL_strnlen(str, maxlen) + +struct buf_mem_st { + size_t length; /* current number of bytes */ + char *data; + size_t max; /* size of buffer */ + unsigned long flags; +}; + +# define BUF_MEM_FLAG_SECURE 0x01 + +BUF_MEM *BUF_MEM_new(void); +BUF_MEM *BUF_MEM_new_ex(unsigned long flags); +void BUF_MEM_free(BUF_MEM *a); +size_t BUF_MEM_grow(BUF_MEM *str, size_t len); +size_t BUF_MEM_grow_clean(BUF_MEM *str, size_t len); +void BUF_reverse(unsigned char *out, const unsigned char *in, size_t siz); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/buffererr.h b/include/openssl/buffererr.h new file mode 100644 index 0000000..3aee132 --- /dev/null +++ b/include/openssl/buffererr.h @@ -0,0 +1,30 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BUFERR_H +# define HEADER_BUFERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_BUF_strings(void); + +/* + * BUF function codes. + */ +# define BUF_F_BUF_MEM_GROW 100 +# define BUF_F_BUF_MEM_GROW_CLEAN 105 +# define BUF_F_BUF_MEM_NEW 101 + +/* + * BUF reason codes. + */ + +#endif diff --git a/include/openssl/camellia.h b/include/openssl/camellia.h new file mode 100644 index 0000000..c3fa2f4 --- /dev/null +++ b/include/openssl/camellia.h @@ -0,0 +1,83 @@ +/* + * Copyright 2006-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CAMELLIA_H +# define HEADER_CAMELLIA_H + +# include + +# ifndef OPENSSL_NO_CAMELLIA +# include +#ifdef __cplusplus +extern "C" { +#endif + +# define CAMELLIA_ENCRYPT 1 +# define CAMELLIA_DECRYPT 0 + +/* + * Because array size can't be a const in C, the following two are macros. + * Both sizes are in bytes. + */ + +/* This should be a hidden type, but EVP requires that the size be known */ + +# define CAMELLIA_BLOCK_SIZE 16 +# define CAMELLIA_TABLE_BYTE_LEN 272 +# define CAMELLIA_TABLE_WORD_LEN (CAMELLIA_TABLE_BYTE_LEN / 4) + +typedef unsigned int KEY_TABLE_TYPE[CAMELLIA_TABLE_WORD_LEN]; /* to match + * with WORD */ + +struct camellia_key_st { + union { + double d; /* ensures 64-bit align */ + KEY_TABLE_TYPE rd_key; + } u; + int grand_rounds; +}; +typedef struct camellia_key_st CAMELLIA_KEY; + +int Camellia_set_key(const unsigned char *userKey, const int bits, + CAMELLIA_KEY *key); + +void Camellia_encrypt(const unsigned char *in, unsigned char *out, + const CAMELLIA_KEY *key); +void Camellia_decrypt(const unsigned char *in, unsigned char *out, + const CAMELLIA_KEY *key); + +void Camellia_ecb_encrypt(const unsigned char *in, unsigned char *out, + const CAMELLIA_KEY *key, const int enc); +void Camellia_cbc_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const CAMELLIA_KEY *key, + unsigned char *ivec, const int enc); +void Camellia_cfb128_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const CAMELLIA_KEY *key, + unsigned char *ivec, int *num, const int enc); +void Camellia_cfb1_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const CAMELLIA_KEY *key, + unsigned char *ivec, int *num, const int enc); +void Camellia_cfb8_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const CAMELLIA_KEY *key, + unsigned char *ivec, int *num, const int enc); +void Camellia_ofb128_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const CAMELLIA_KEY *key, + unsigned char *ivec, int *num); +void Camellia_ctr128_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const CAMELLIA_KEY *key, + unsigned char ivec[CAMELLIA_BLOCK_SIZE], + unsigned char ecount_buf[CAMELLIA_BLOCK_SIZE], + unsigned int *num); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/cast.h b/include/openssl/cast.h new file mode 100644 index 0000000..74dad83 --- /dev/null +++ b/include/openssl/cast.h @@ -0,0 +1,53 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CAST_H +# define HEADER_CAST_H + +# include + +# ifndef OPENSSL_NO_CAST +# ifdef __cplusplus +extern "C" { +# endif + +# define CAST_ENCRYPT 1 +# define CAST_DECRYPT 0 + +# define CAST_LONG unsigned int + +# define CAST_BLOCK 8 +# define CAST_KEY_LENGTH 16 + +typedef struct cast_key_st { + CAST_LONG data[32]; + int short_key; /* Use reduced rounds for short key */ +} CAST_KEY; + +void CAST_set_key(CAST_KEY *key, int len, const unsigned char *data); +void CAST_ecb_encrypt(const unsigned char *in, unsigned char *out, + const CAST_KEY *key, int enc); +void CAST_encrypt(CAST_LONG *data, const CAST_KEY *key); +void CAST_decrypt(CAST_LONG *data, const CAST_KEY *key); +void CAST_cbc_encrypt(const unsigned char *in, unsigned char *out, + long length, const CAST_KEY *ks, unsigned char *iv, + int enc); +void CAST_cfb64_encrypt(const unsigned char *in, unsigned char *out, + long length, const CAST_KEY *schedule, + unsigned char *ivec, int *num, int enc); +void CAST_ofb64_encrypt(const unsigned char *in, unsigned char *out, + long length, const CAST_KEY *schedule, + unsigned char *ivec, int *num); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/cmac.h b/include/openssl/cmac.h new file mode 100644 index 0000000..3e64bdd --- /dev/null +++ b/include/openssl/cmac.h @@ -0,0 +1,41 @@ +/* + * Copyright 2010-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CMAC_H +# define HEADER_CMAC_H + +# ifndef OPENSSL_NO_CMAC + +#ifdef __cplusplus +extern "C" { +#endif + +# include + +/* Opaque */ +typedef struct CMAC_CTX_st CMAC_CTX; + +CMAC_CTX *CMAC_CTX_new(void); +void CMAC_CTX_cleanup(CMAC_CTX *ctx); +void CMAC_CTX_free(CMAC_CTX *ctx); +EVP_CIPHER_CTX *CMAC_CTX_get0_cipher_ctx(CMAC_CTX *ctx); +int CMAC_CTX_copy(CMAC_CTX *out, const CMAC_CTX *in); + +int CMAC_Init(CMAC_CTX *ctx, const void *key, size_t keylen, + const EVP_CIPHER *cipher, ENGINE *impl); +int CMAC_Update(CMAC_CTX *ctx, const void *data, size_t dlen); +int CMAC_Final(CMAC_CTX *ctx, unsigned char *out, size_t *poutlen); +int CMAC_resume(CMAC_CTX *ctx); + +#ifdef __cplusplus +} +#endif + +# endif +#endif diff --git a/include/openssl/cms.h b/include/openssl/cms.h new file mode 100644 index 0000000..1859f15 --- /dev/null +++ b/include/openssl/cms.h @@ -0,0 +1,342 @@ +/* + * Copyright 2008-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CMS_H +# define HEADER_CMS_H + +# include + +# ifndef OPENSSL_NO_CMS +# include +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +typedef struct CMS_ContentInfo_st CMS_ContentInfo; +typedef struct CMS_SignerInfo_st CMS_SignerInfo; +typedef struct CMS_CertificateChoices CMS_CertificateChoices; +typedef struct CMS_RevocationInfoChoice_st CMS_RevocationInfoChoice; +typedef struct CMS_RecipientInfo_st CMS_RecipientInfo; +typedef struct CMS_ReceiptRequest_st CMS_ReceiptRequest; +typedef struct CMS_Receipt_st CMS_Receipt; +typedef struct CMS_RecipientEncryptedKey_st CMS_RecipientEncryptedKey; +typedef struct CMS_OtherKeyAttribute_st CMS_OtherKeyAttribute; + +DEFINE_STACK_OF(CMS_SignerInfo) +DEFINE_STACK_OF(CMS_RecipientEncryptedKey) +DEFINE_STACK_OF(CMS_RecipientInfo) +DEFINE_STACK_OF(CMS_RevocationInfoChoice) +DECLARE_ASN1_FUNCTIONS(CMS_ContentInfo) +DECLARE_ASN1_FUNCTIONS(CMS_ReceiptRequest) +DECLARE_ASN1_PRINT_FUNCTION(CMS_ContentInfo) + +# define CMS_SIGNERINFO_ISSUER_SERIAL 0 +# define CMS_SIGNERINFO_KEYIDENTIFIER 1 + +# define CMS_RECIPINFO_NONE -1 +# define CMS_RECIPINFO_TRANS 0 +# define CMS_RECIPINFO_AGREE 1 +# define CMS_RECIPINFO_KEK 2 +# define CMS_RECIPINFO_PASS 3 +# define CMS_RECIPINFO_OTHER 4 + +/* S/MIME related flags */ + +# define CMS_TEXT 0x1 +# define CMS_NOCERTS 0x2 +# define CMS_NO_CONTENT_VERIFY 0x4 +# define CMS_NO_ATTR_VERIFY 0x8 +# define CMS_NOSIGS \ + (CMS_NO_CONTENT_VERIFY|CMS_NO_ATTR_VERIFY) +# define CMS_NOINTERN 0x10 +# define CMS_NO_SIGNER_CERT_VERIFY 0x20 +# define CMS_NOVERIFY 0x20 +# define CMS_DETACHED 0x40 +# define CMS_BINARY 0x80 +# define CMS_NOATTR 0x100 +# define CMS_NOSMIMECAP 0x200 +# define CMS_NOOLDMIMETYPE 0x400 +# define CMS_CRLFEOL 0x800 +# define CMS_STREAM 0x1000 +# define CMS_NOCRL 0x2000 +# define CMS_PARTIAL 0x4000 +# define CMS_REUSE_DIGEST 0x8000 +# define CMS_USE_KEYID 0x10000 +# define CMS_DEBUG_DECRYPT 0x20000 +# define CMS_KEY_PARAM 0x40000 +# define CMS_ASCIICRLF 0x80000 + +const ASN1_OBJECT *CMS_get0_type(const CMS_ContentInfo *cms); + +BIO *CMS_dataInit(CMS_ContentInfo *cms, BIO *icont); +int CMS_dataFinal(CMS_ContentInfo *cms, BIO *bio); + +ASN1_OCTET_STRING **CMS_get0_content(CMS_ContentInfo *cms); +int CMS_is_detached(CMS_ContentInfo *cms); +int CMS_set_detached(CMS_ContentInfo *cms, int detached); + +# ifdef HEADER_PEM_H +DECLARE_PEM_rw_const(CMS, CMS_ContentInfo) +# endif +int CMS_stream(unsigned char ***boundary, CMS_ContentInfo *cms); +CMS_ContentInfo *d2i_CMS_bio(BIO *bp, CMS_ContentInfo **cms); +int i2d_CMS_bio(BIO *bp, CMS_ContentInfo *cms); + +BIO *BIO_new_CMS(BIO *out, CMS_ContentInfo *cms); +int i2d_CMS_bio_stream(BIO *out, CMS_ContentInfo *cms, BIO *in, int flags); +int PEM_write_bio_CMS_stream(BIO *out, CMS_ContentInfo *cms, BIO *in, + int flags); +CMS_ContentInfo *SMIME_read_CMS(BIO *bio, BIO **bcont); +int SMIME_write_CMS(BIO *bio, CMS_ContentInfo *cms, BIO *data, int flags); + +int CMS_final(CMS_ContentInfo *cms, BIO *data, BIO *dcont, + unsigned int flags); + +CMS_ContentInfo *CMS_sign(X509 *signcert, EVP_PKEY *pkey, + STACK_OF(X509) *certs, BIO *data, + unsigned int flags); + +CMS_ContentInfo *CMS_sign_receipt(CMS_SignerInfo *si, + X509 *signcert, EVP_PKEY *pkey, + STACK_OF(X509) *certs, unsigned int flags); + +int CMS_data(CMS_ContentInfo *cms, BIO *out, unsigned int flags); +CMS_ContentInfo *CMS_data_create(BIO *in, unsigned int flags); + +int CMS_digest_verify(CMS_ContentInfo *cms, BIO *dcont, BIO *out, + unsigned int flags); +CMS_ContentInfo *CMS_digest_create(BIO *in, const EVP_MD *md, + unsigned int flags); + +int CMS_EncryptedData_decrypt(CMS_ContentInfo *cms, + const unsigned char *key, size_t keylen, + BIO *dcont, BIO *out, unsigned int flags); + +CMS_ContentInfo *CMS_EncryptedData_encrypt(BIO *in, const EVP_CIPHER *cipher, + const unsigned char *key, + size_t keylen, unsigned int flags); + +int CMS_EncryptedData_set1_key(CMS_ContentInfo *cms, const EVP_CIPHER *ciph, + const unsigned char *key, size_t keylen); + +int CMS_verify(CMS_ContentInfo *cms, STACK_OF(X509) *certs, + X509_STORE *store, BIO *dcont, BIO *out, unsigned int flags); + +int CMS_verify_receipt(CMS_ContentInfo *rcms, CMS_ContentInfo *ocms, + STACK_OF(X509) *certs, + X509_STORE *store, unsigned int flags); + +STACK_OF(X509) *CMS_get0_signers(CMS_ContentInfo *cms); + +CMS_ContentInfo *CMS_encrypt(STACK_OF(X509) *certs, BIO *in, + const EVP_CIPHER *cipher, unsigned int flags); + +int CMS_decrypt(CMS_ContentInfo *cms, EVP_PKEY *pkey, X509 *cert, + BIO *dcont, BIO *out, unsigned int flags); + +int CMS_decrypt_set1_pkey(CMS_ContentInfo *cms, EVP_PKEY *pk, X509 *cert); +int CMS_decrypt_set1_key(CMS_ContentInfo *cms, + unsigned char *key, size_t keylen, + const unsigned char *id, size_t idlen); +int CMS_decrypt_set1_password(CMS_ContentInfo *cms, + unsigned char *pass, ossl_ssize_t passlen); + +STACK_OF(CMS_RecipientInfo) *CMS_get0_RecipientInfos(CMS_ContentInfo *cms); +int CMS_RecipientInfo_type(CMS_RecipientInfo *ri); +EVP_PKEY_CTX *CMS_RecipientInfo_get0_pkey_ctx(CMS_RecipientInfo *ri); +CMS_ContentInfo *CMS_EnvelopedData_create(const EVP_CIPHER *cipher); +CMS_RecipientInfo *CMS_add1_recipient_cert(CMS_ContentInfo *cms, + X509 *recip, unsigned int flags); +int CMS_RecipientInfo_set0_pkey(CMS_RecipientInfo *ri, EVP_PKEY *pkey); +int CMS_RecipientInfo_ktri_cert_cmp(CMS_RecipientInfo *ri, X509 *cert); +int CMS_RecipientInfo_ktri_get0_algs(CMS_RecipientInfo *ri, + EVP_PKEY **pk, X509 **recip, + X509_ALGOR **palg); +int CMS_RecipientInfo_ktri_get0_signer_id(CMS_RecipientInfo *ri, + ASN1_OCTET_STRING **keyid, + X509_NAME **issuer, + ASN1_INTEGER **sno); + +CMS_RecipientInfo *CMS_add0_recipient_key(CMS_ContentInfo *cms, int nid, + unsigned char *key, size_t keylen, + unsigned char *id, size_t idlen, + ASN1_GENERALIZEDTIME *date, + ASN1_OBJECT *otherTypeId, + ASN1_TYPE *otherType); + +int CMS_RecipientInfo_kekri_get0_id(CMS_RecipientInfo *ri, + X509_ALGOR **palg, + ASN1_OCTET_STRING **pid, + ASN1_GENERALIZEDTIME **pdate, + ASN1_OBJECT **potherid, + ASN1_TYPE **pothertype); + +int CMS_RecipientInfo_set0_key(CMS_RecipientInfo *ri, + unsigned char *key, size_t keylen); + +int CMS_RecipientInfo_kekri_id_cmp(CMS_RecipientInfo *ri, + const unsigned char *id, size_t idlen); + +int CMS_RecipientInfo_set0_password(CMS_RecipientInfo *ri, + unsigned char *pass, + ossl_ssize_t passlen); + +CMS_RecipientInfo *CMS_add0_recipient_password(CMS_ContentInfo *cms, + int iter, int wrap_nid, + int pbe_nid, + unsigned char *pass, + ossl_ssize_t passlen, + const EVP_CIPHER *kekciph); + +int CMS_RecipientInfo_decrypt(CMS_ContentInfo *cms, CMS_RecipientInfo *ri); +int CMS_RecipientInfo_encrypt(CMS_ContentInfo *cms, CMS_RecipientInfo *ri); + +int CMS_uncompress(CMS_ContentInfo *cms, BIO *dcont, BIO *out, + unsigned int flags); +CMS_ContentInfo *CMS_compress(BIO *in, int comp_nid, unsigned int flags); + +int CMS_set1_eContentType(CMS_ContentInfo *cms, const ASN1_OBJECT *oid); +const ASN1_OBJECT *CMS_get0_eContentType(CMS_ContentInfo *cms); + +CMS_CertificateChoices *CMS_add0_CertificateChoices(CMS_ContentInfo *cms); +int CMS_add0_cert(CMS_ContentInfo *cms, X509 *cert); +int CMS_add1_cert(CMS_ContentInfo *cms, X509 *cert); +STACK_OF(X509) *CMS_get1_certs(CMS_ContentInfo *cms); + +CMS_RevocationInfoChoice *CMS_add0_RevocationInfoChoice(CMS_ContentInfo *cms); +int CMS_add0_crl(CMS_ContentInfo *cms, X509_CRL *crl); +int CMS_add1_crl(CMS_ContentInfo *cms, X509_CRL *crl); +STACK_OF(X509_CRL) *CMS_get1_crls(CMS_ContentInfo *cms); + +int CMS_SignedData_init(CMS_ContentInfo *cms); +CMS_SignerInfo *CMS_add1_signer(CMS_ContentInfo *cms, + X509 *signer, EVP_PKEY *pk, const EVP_MD *md, + unsigned int flags); +EVP_PKEY_CTX *CMS_SignerInfo_get0_pkey_ctx(CMS_SignerInfo *si); +EVP_MD_CTX *CMS_SignerInfo_get0_md_ctx(CMS_SignerInfo *si); +STACK_OF(CMS_SignerInfo) *CMS_get0_SignerInfos(CMS_ContentInfo *cms); + +void CMS_SignerInfo_set1_signer_cert(CMS_SignerInfo *si, X509 *signer); +int CMS_SignerInfo_get0_signer_id(CMS_SignerInfo *si, + ASN1_OCTET_STRING **keyid, + X509_NAME **issuer, ASN1_INTEGER **sno); +int CMS_SignerInfo_cert_cmp(CMS_SignerInfo *si, X509 *cert); +int CMS_set1_signers_certs(CMS_ContentInfo *cms, STACK_OF(X509) *certs, + unsigned int flags); +void CMS_SignerInfo_get0_algs(CMS_SignerInfo *si, EVP_PKEY **pk, + X509 **signer, X509_ALGOR **pdig, + X509_ALGOR **psig); +ASN1_OCTET_STRING *CMS_SignerInfo_get0_signature(CMS_SignerInfo *si); +int CMS_SignerInfo_sign(CMS_SignerInfo *si); +int CMS_SignerInfo_verify(CMS_SignerInfo *si); +int CMS_SignerInfo_verify_content(CMS_SignerInfo *si, BIO *chain); + +int CMS_add_smimecap(CMS_SignerInfo *si, STACK_OF(X509_ALGOR) *algs); +int CMS_add_simple_smimecap(STACK_OF(X509_ALGOR) **algs, + int algnid, int keysize); +int CMS_add_standard_smimecap(STACK_OF(X509_ALGOR) **smcap); + +int CMS_signed_get_attr_count(const CMS_SignerInfo *si); +int CMS_signed_get_attr_by_NID(const CMS_SignerInfo *si, int nid, + int lastpos); +int CMS_signed_get_attr_by_OBJ(const CMS_SignerInfo *si, const ASN1_OBJECT *obj, + int lastpos); +X509_ATTRIBUTE *CMS_signed_get_attr(const CMS_SignerInfo *si, int loc); +X509_ATTRIBUTE *CMS_signed_delete_attr(CMS_SignerInfo *si, int loc); +int CMS_signed_add1_attr(CMS_SignerInfo *si, X509_ATTRIBUTE *attr); +int CMS_signed_add1_attr_by_OBJ(CMS_SignerInfo *si, + const ASN1_OBJECT *obj, int type, + const void *bytes, int len); +int CMS_signed_add1_attr_by_NID(CMS_SignerInfo *si, + int nid, int type, + const void *bytes, int len); +int CMS_signed_add1_attr_by_txt(CMS_SignerInfo *si, + const char *attrname, int type, + const void *bytes, int len); +void *CMS_signed_get0_data_by_OBJ(CMS_SignerInfo *si, const ASN1_OBJECT *oid, + int lastpos, int type); + +int CMS_unsigned_get_attr_count(const CMS_SignerInfo *si); +int CMS_unsigned_get_attr_by_NID(const CMS_SignerInfo *si, int nid, + int lastpos); +int CMS_unsigned_get_attr_by_OBJ(const CMS_SignerInfo *si, + const ASN1_OBJECT *obj, int lastpos); +X509_ATTRIBUTE *CMS_unsigned_get_attr(const CMS_SignerInfo *si, int loc); +X509_ATTRIBUTE *CMS_unsigned_delete_attr(CMS_SignerInfo *si, int loc); +int CMS_unsigned_add1_attr(CMS_SignerInfo *si, X509_ATTRIBUTE *attr); +int CMS_unsigned_add1_attr_by_OBJ(CMS_SignerInfo *si, + const ASN1_OBJECT *obj, int type, + const void *bytes, int len); +int CMS_unsigned_add1_attr_by_NID(CMS_SignerInfo *si, + int nid, int type, + const void *bytes, int len); +int CMS_unsigned_add1_attr_by_txt(CMS_SignerInfo *si, + const char *attrname, int type, + const void *bytes, int len); +void *CMS_unsigned_get0_data_by_OBJ(CMS_SignerInfo *si, ASN1_OBJECT *oid, + int lastpos, int type); + +# ifdef HEADER_X509V3_H + +int CMS_get1_ReceiptRequest(CMS_SignerInfo *si, CMS_ReceiptRequest **prr); +CMS_ReceiptRequest *CMS_ReceiptRequest_create0(unsigned char *id, int idlen, + int allorfirst, + STACK_OF(GENERAL_NAMES) + *receiptList, STACK_OF(GENERAL_NAMES) + *receiptsTo); +int CMS_add1_ReceiptRequest(CMS_SignerInfo *si, CMS_ReceiptRequest *rr); +void CMS_ReceiptRequest_get0_values(CMS_ReceiptRequest *rr, + ASN1_STRING **pcid, + int *pallorfirst, + STACK_OF(GENERAL_NAMES) **plist, + STACK_OF(GENERAL_NAMES) **prto); +# endif +int CMS_RecipientInfo_kari_get0_alg(CMS_RecipientInfo *ri, + X509_ALGOR **palg, + ASN1_OCTET_STRING **pukm); +STACK_OF(CMS_RecipientEncryptedKey) +*CMS_RecipientInfo_kari_get0_reks(CMS_RecipientInfo *ri); + +int CMS_RecipientInfo_kari_get0_orig_id(CMS_RecipientInfo *ri, + X509_ALGOR **pubalg, + ASN1_BIT_STRING **pubkey, + ASN1_OCTET_STRING **keyid, + X509_NAME **issuer, + ASN1_INTEGER **sno); + +int CMS_RecipientInfo_kari_orig_id_cmp(CMS_RecipientInfo *ri, X509 *cert); + +int CMS_RecipientEncryptedKey_get0_id(CMS_RecipientEncryptedKey *rek, + ASN1_OCTET_STRING **keyid, + ASN1_GENERALIZEDTIME **tm, + CMS_OtherKeyAttribute **other, + X509_NAME **issuer, ASN1_INTEGER **sno); +int CMS_RecipientEncryptedKey_cert_cmp(CMS_RecipientEncryptedKey *rek, + X509 *cert); +int CMS_RecipientInfo_kari_set0_pkey(CMS_RecipientInfo *ri, EVP_PKEY *pk); +EVP_CIPHER_CTX *CMS_RecipientInfo_kari_get0_ctx(CMS_RecipientInfo *ri); +int CMS_RecipientInfo_kari_decrypt(CMS_ContentInfo *cms, + CMS_RecipientInfo *ri, + CMS_RecipientEncryptedKey *rek); + +int CMS_SharedInfo_encode(unsigned char **pder, X509_ALGOR *kekalg, + ASN1_OCTET_STRING *ukm, int keylen); + +/* Backward compatibility for spelling errors. */ +# define CMS_R_UNKNOWN_DIGEST_ALGORITM CMS_R_UNKNOWN_DIGEST_ALGORITHM +# define CMS_R_UNSUPPORTED_RECPIENTINFO_TYPE \ + CMS_R_UNSUPPORTED_RECIPIENTINFO_TYPE + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/cmserr.h b/include/openssl/cmserr.h new file mode 100644 index 0000000..7225243 --- /dev/null +++ b/include/openssl/cmserr.h @@ -0,0 +1,196 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CMSERR_H +# define HEADER_CMSERR_H + +# include + +# ifndef OPENSSL_NO_CMS + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_CMS_strings(void); + +/* + * CMS function codes. + */ +# define CMS_F_CHECK_CONTENT 99 +# define CMS_F_CMS_ADD0_CERT 164 +# define CMS_F_CMS_ADD0_RECIPIENT_KEY 100 +# define CMS_F_CMS_ADD0_RECIPIENT_PASSWORD 165 +# define CMS_F_CMS_ADD1_RECEIPTREQUEST 158 +# define CMS_F_CMS_ADD1_RECIPIENT_CERT 101 +# define CMS_F_CMS_ADD1_SIGNER 102 +# define CMS_F_CMS_ADD1_SIGNINGTIME 103 +# define CMS_F_CMS_COMPRESS 104 +# define CMS_F_CMS_COMPRESSEDDATA_CREATE 105 +# define CMS_F_CMS_COMPRESSEDDATA_INIT_BIO 106 +# define CMS_F_CMS_COPY_CONTENT 107 +# define CMS_F_CMS_COPY_MESSAGEDIGEST 108 +# define CMS_F_CMS_DATA 109 +# define CMS_F_CMS_DATAFINAL 110 +# define CMS_F_CMS_DATAINIT 111 +# define CMS_F_CMS_DECRYPT 112 +# define CMS_F_CMS_DECRYPT_SET1_KEY 113 +# define CMS_F_CMS_DECRYPT_SET1_PASSWORD 166 +# define CMS_F_CMS_DECRYPT_SET1_PKEY 114 +# define CMS_F_CMS_DIGESTALGORITHM_FIND_CTX 115 +# define CMS_F_CMS_DIGESTALGORITHM_INIT_BIO 116 +# define CMS_F_CMS_DIGESTEDDATA_DO_FINAL 117 +# define CMS_F_CMS_DIGEST_VERIFY 118 +# define CMS_F_CMS_ENCODE_RECEIPT 161 +# define CMS_F_CMS_ENCRYPT 119 +# define CMS_F_CMS_ENCRYPTEDCONTENT_INIT 179 +# define CMS_F_CMS_ENCRYPTEDCONTENT_INIT_BIO 120 +# define CMS_F_CMS_ENCRYPTEDDATA_DECRYPT 121 +# define CMS_F_CMS_ENCRYPTEDDATA_ENCRYPT 122 +# define CMS_F_CMS_ENCRYPTEDDATA_SET1_KEY 123 +# define CMS_F_CMS_ENVELOPEDDATA_CREATE 124 +# define CMS_F_CMS_ENVELOPEDDATA_INIT_BIO 125 +# define CMS_F_CMS_ENVELOPED_DATA_INIT 126 +# define CMS_F_CMS_ENV_ASN1_CTRL 171 +# define CMS_F_CMS_FINAL 127 +# define CMS_F_CMS_GET0_CERTIFICATE_CHOICES 128 +# define CMS_F_CMS_GET0_CONTENT 129 +# define CMS_F_CMS_GET0_ECONTENT_TYPE 130 +# define CMS_F_CMS_GET0_ENVELOPED 131 +# define CMS_F_CMS_GET0_REVOCATION_CHOICES 132 +# define CMS_F_CMS_GET0_SIGNED 133 +# define CMS_F_CMS_MSGSIGDIGEST_ADD1 162 +# define CMS_F_CMS_RECEIPTREQUEST_CREATE0 159 +# define CMS_F_CMS_RECEIPT_VERIFY 160 +# define CMS_F_CMS_RECIPIENTINFO_DECRYPT 134 +# define CMS_F_CMS_RECIPIENTINFO_ENCRYPT 169 +# define CMS_F_CMS_RECIPIENTINFO_KARI_ENCRYPT 178 +# define CMS_F_CMS_RECIPIENTINFO_KARI_GET0_ALG 175 +# define CMS_F_CMS_RECIPIENTINFO_KARI_GET0_ORIG_ID 173 +# define CMS_F_CMS_RECIPIENTINFO_KARI_GET0_REKS 172 +# define CMS_F_CMS_RECIPIENTINFO_KARI_ORIG_ID_CMP 174 +# define CMS_F_CMS_RECIPIENTINFO_KEKRI_DECRYPT 135 +# define CMS_F_CMS_RECIPIENTINFO_KEKRI_ENCRYPT 136 +# define CMS_F_CMS_RECIPIENTINFO_KEKRI_GET0_ID 137 +# define CMS_F_CMS_RECIPIENTINFO_KEKRI_ID_CMP 138 +# define CMS_F_CMS_RECIPIENTINFO_KTRI_CERT_CMP 139 +# define CMS_F_CMS_RECIPIENTINFO_KTRI_DECRYPT 140 +# define CMS_F_CMS_RECIPIENTINFO_KTRI_ENCRYPT 141 +# define CMS_F_CMS_RECIPIENTINFO_KTRI_GET0_ALGS 142 +# define CMS_F_CMS_RECIPIENTINFO_KTRI_GET0_SIGNER_ID 143 +# define CMS_F_CMS_RECIPIENTINFO_PWRI_CRYPT 167 +# define CMS_F_CMS_RECIPIENTINFO_SET0_KEY 144 +# define CMS_F_CMS_RECIPIENTINFO_SET0_PASSWORD 168 +# define CMS_F_CMS_RECIPIENTINFO_SET0_PKEY 145 +# define CMS_F_CMS_SD_ASN1_CTRL 170 +# define CMS_F_CMS_SET1_IAS 176 +# define CMS_F_CMS_SET1_KEYID 177 +# define CMS_F_CMS_SET1_SIGNERIDENTIFIER 146 +# define CMS_F_CMS_SET_DETACHED 147 +# define CMS_F_CMS_SIGN 148 +# define CMS_F_CMS_SIGNED_DATA_INIT 149 +# define CMS_F_CMS_SIGNERINFO_CONTENT_SIGN 150 +# define CMS_F_CMS_SIGNERINFO_SIGN 151 +# define CMS_F_CMS_SIGNERINFO_VERIFY 152 +# define CMS_F_CMS_SIGNERINFO_VERIFY_CERT 153 +# define CMS_F_CMS_SIGNERINFO_VERIFY_CONTENT 154 +# define CMS_F_CMS_SIGN_RECEIPT 163 +# define CMS_F_CMS_STREAM 155 +# define CMS_F_CMS_UNCOMPRESS 156 +# define CMS_F_CMS_VERIFY 157 +# define CMS_F_KEK_UNWRAP_KEY 180 + +/* + * CMS reason codes. + */ +# define CMS_R_ADD_SIGNER_ERROR 99 +# define CMS_R_CERTIFICATE_ALREADY_PRESENT 175 +# define CMS_R_CERTIFICATE_HAS_NO_KEYID 160 +# define CMS_R_CERTIFICATE_VERIFY_ERROR 100 +# define CMS_R_CIPHER_INITIALISATION_ERROR 101 +# define CMS_R_CIPHER_PARAMETER_INITIALISATION_ERROR 102 +# define CMS_R_CMS_DATAFINAL_ERROR 103 +# define CMS_R_CMS_LIB 104 +# define CMS_R_CONTENTIDENTIFIER_MISMATCH 170 +# define CMS_R_CONTENT_NOT_FOUND 105 +# define CMS_R_CONTENT_TYPE_MISMATCH 171 +# define CMS_R_CONTENT_TYPE_NOT_COMPRESSED_DATA 106 +# define CMS_R_CONTENT_TYPE_NOT_ENVELOPED_DATA 107 +# define CMS_R_CONTENT_TYPE_NOT_SIGNED_DATA 108 +# define CMS_R_CONTENT_VERIFY_ERROR 109 +# define CMS_R_CTRL_ERROR 110 +# define CMS_R_CTRL_FAILURE 111 +# define CMS_R_DECRYPT_ERROR 112 +# define CMS_R_ERROR_GETTING_PUBLIC_KEY 113 +# define CMS_R_ERROR_READING_MESSAGEDIGEST_ATTRIBUTE 114 +# define CMS_R_ERROR_SETTING_KEY 115 +# define CMS_R_ERROR_SETTING_RECIPIENTINFO 116 +# define CMS_R_INVALID_ENCRYPTED_KEY_LENGTH 117 +# define CMS_R_INVALID_KEY_ENCRYPTION_PARAMETER 176 +# define CMS_R_INVALID_KEY_LENGTH 118 +# define CMS_R_MD_BIO_INIT_ERROR 119 +# define CMS_R_MESSAGEDIGEST_ATTRIBUTE_WRONG_LENGTH 120 +# define CMS_R_MESSAGEDIGEST_WRONG_LENGTH 121 +# define CMS_R_MSGSIGDIGEST_ERROR 172 +# define CMS_R_MSGSIGDIGEST_VERIFICATION_FAILURE 162 +# define CMS_R_MSGSIGDIGEST_WRONG_LENGTH 163 +# define CMS_R_NEED_ONE_SIGNER 164 +# define CMS_R_NOT_A_SIGNED_RECEIPT 165 +# define CMS_R_NOT_ENCRYPTED_DATA 122 +# define CMS_R_NOT_KEK 123 +# define CMS_R_NOT_KEY_AGREEMENT 181 +# define CMS_R_NOT_KEY_TRANSPORT 124 +# define CMS_R_NOT_PWRI 177 +# define CMS_R_NOT_SUPPORTED_FOR_THIS_KEY_TYPE 125 +# define CMS_R_NO_CIPHER 126 +# define CMS_R_NO_CONTENT 127 +# define CMS_R_NO_CONTENT_TYPE 173 +# define CMS_R_NO_DEFAULT_DIGEST 128 +# define CMS_R_NO_DIGEST_SET 129 +# define CMS_R_NO_KEY 130 +# define CMS_R_NO_KEY_OR_CERT 174 +# define CMS_R_NO_MATCHING_DIGEST 131 +# define CMS_R_NO_MATCHING_RECIPIENT 132 +# define CMS_R_NO_MATCHING_SIGNATURE 166 +# define CMS_R_NO_MSGSIGDIGEST 167 +# define CMS_R_NO_PASSWORD 178 +# define CMS_R_NO_PRIVATE_KEY 133 +# define CMS_R_NO_PUBLIC_KEY 134 +# define CMS_R_NO_RECEIPT_REQUEST 168 +# define CMS_R_NO_SIGNERS 135 +# define CMS_R_PRIVATE_KEY_DOES_NOT_MATCH_CERTIFICATE 136 +# define CMS_R_RECEIPT_DECODE_ERROR 169 +# define CMS_R_RECIPIENT_ERROR 137 +# define CMS_R_SIGNER_CERTIFICATE_NOT_FOUND 138 +# define CMS_R_SIGNFINAL_ERROR 139 +# define CMS_R_SMIME_TEXT_ERROR 140 +# define CMS_R_STORE_INIT_ERROR 141 +# define CMS_R_TYPE_NOT_COMPRESSED_DATA 142 +# define CMS_R_TYPE_NOT_DATA 143 +# define CMS_R_TYPE_NOT_DIGESTED_DATA 144 +# define CMS_R_TYPE_NOT_ENCRYPTED_DATA 145 +# define CMS_R_TYPE_NOT_ENVELOPED_DATA 146 +# define CMS_R_UNABLE_TO_FINALIZE_CONTEXT 147 +# define CMS_R_UNKNOWN_CIPHER 148 +# define CMS_R_UNKNOWN_DIGEST_ALGORITHM 149 +# define CMS_R_UNKNOWN_ID 150 +# define CMS_R_UNSUPPORTED_COMPRESSION_ALGORITHM 151 +# define CMS_R_UNSUPPORTED_CONTENT_TYPE 152 +# define CMS_R_UNSUPPORTED_KEK_ALGORITHM 153 +# define CMS_R_UNSUPPORTED_KEY_ENCRYPTION_ALGORITHM 179 +# define CMS_R_UNSUPPORTED_RECIPIENTINFO_TYPE 155 +# define CMS_R_UNSUPPORTED_RECIPIENT_TYPE 154 +# define CMS_R_UNSUPPORTED_TYPE 156 +# define CMS_R_UNWRAP_ERROR 157 +# define CMS_R_UNWRAP_FAILURE 180 +# define CMS_R_VERIFICATION_FAILURE 158 +# define CMS_R_WRAP_ERROR 159 + +# endif +#endif diff --git a/include/openssl/comp.h b/include/openssl/comp.h new file mode 100644 index 0000000..a337bd6 --- /dev/null +++ b/include/openssl/comp.h @@ -0,0 +1,53 @@ +/* + * Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_COMP_H +# define HEADER_COMP_H + +# include + +# ifndef OPENSSL_NO_COMP +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + + + +COMP_CTX *COMP_CTX_new(COMP_METHOD *meth); +const COMP_METHOD *COMP_CTX_get_method(const COMP_CTX *ctx); +int COMP_CTX_get_type(const COMP_CTX* comp); +int COMP_get_type(const COMP_METHOD *meth); +const char *COMP_get_name(const COMP_METHOD *meth); +void COMP_CTX_free(COMP_CTX *ctx); + +int COMP_compress_block(COMP_CTX *ctx, unsigned char *out, int olen, + unsigned char *in, int ilen); +int COMP_expand_block(COMP_CTX *ctx, unsigned char *out, int olen, + unsigned char *in, int ilen); + +COMP_METHOD *COMP_zlib(void); + +#if OPENSSL_API_COMPAT < 0x10100000L +#define COMP_zlib_cleanup() while(0) continue +#endif + +# ifdef HEADER_BIO_H +# ifdef ZLIB +const BIO_METHOD *BIO_f_zlib(void); +# endif +# endif + + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/comperr.h b/include/openssl/comperr.h new file mode 100644 index 0000000..49a589f --- /dev/null +++ b/include/openssl/comperr.h @@ -0,0 +1,40 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_COMPERR_H +# define HEADER_COMPERR_H + +# include + +# ifndef OPENSSL_NO_COMP + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_COMP_strings(void); + +/* + * COMP function codes. + */ +# define COMP_F_BIO_ZLIB_FLUSH 99 +# define COMP_F_BIO_ZLIB_NEW 100 +# define COMP_F_BIO_ZLIB_READ 101 +# define COMP_F_BIO_ZLIB_WRITE 102 +# define COMP_F_COMP_CTX_NEW 103 + +/* + * COMP reason codes. + */ +# define COMP_R_ZLIB_DEFLATE_ERROR 99 +# define COMP_R_ZLIB_INFLATE_ERROR 100 +# define COMP_R_ZLIB_NOT_SUPPORTED 101 + +# endif +#endif diff --git a/include/openssl/conf.h b/include/openssl/conf.h new file mode 100644 index 0000000..f57d321 --- /dev/null +++ b/include/openssl/conf.h @@ -0,0 +1,168 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CONF_H +# define HEADER_CONF_H + +# include +# include +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct { + char *section; + char *name; + char *value; +} CONF_VALUE; + +DEFINE_STACK_OF(CONF_VALUE) +DEFINE_LHASH_OF(CONF_VALUE); + +struct conf_st; +struct conf_method_st; +typedef struct conf_method_st CONF_METHOD; + +struct conf_method_st { + const char *name; + CONF *(*create) (CONF_METHOD *meth); + int (*init) (CONF *conf); + int (*destroy) (CONF *conf); + int (*destroy_data) (CONF *conf); + int (*load_bio) (CONF *conf, BIO *bp, long *eline); + int (*dump) (const CONF *conf, BIO *bp); + int (*is_number) (const CONF *conf, char c); + int (*to_int) (const CONF *conf, char c); + int (*load) (CONF *conf, const char *name, long *eline); +}; + +/* Module definitions */ + +typedef struct conf_imodule_st CONF_IMODULE; +typedef struct conf_module_st CONF_MODULE; + +DEFINE_STACK_OF(CONF_MODULE) +DEFINE_STACK_OF(CONF_IMODULE) + +/* DSO module function typedefs */ +typedef int conf_init_func (CONF_IMODULE *md, const CONF *cnf); +typedef void conf_finish_func (CONF_IMODULE *md); + +# define CONF_MFLAGS_IGNORE_ERRORS 0x1 +# define CONF_MFLAGS_IGNORE_RETURN_CODES 0x2 +# define CONF_MFLAGS_SILENT 0x4 +# define CONF_MFLAGS_NO_DSO 0x8 +# define CONF_MFLAGS_IGNORE_MISSING_FILE 0x10 +# define CONF_MFLAGS_DEFAULT_SECTION 0x20 + +int CONF_set_default_method(CONF_METHOD *meth); +void CONF_set_nconf(CONF *conf, LHASH_OF(CONF_VALUE) *hash); +LHASH_OF(CONF_VALUE) *CONF_load(LHASH_OF(CONF_VALUE) *conf, const char *file, + long *eline); +# ifndef OPENSSL_NO_STDIO +LHASH_OF(CONF_VALUE) *CONF_load_fp(LHASH_OF(CONF_VALUE) *conf, FILE *fp, + long *eline); +# endif +LHASH_OF(CONF_VALUE) *CONF_load_bio(LHASH_OF(CONF_VALUE) *conf, BIO *bp, + long *eline); +STACK_OF(CONF_VALUE) *CONF_get_section(LHASH_OF(CONF_VALUE) *conf, + const char *section); +char *CONF_get_string(LHASH_OF(CONF_VALUE) *conf, const char *group, + const char *name); +long CONF_get_number(LHASH_OF(CONF_VALUE) *conf, const char *group, + const char *name); +void CONF_free(LHASH_OF(CONF_VALUE) *conf); +#ifndef OPENSSL_NO_STDIO +int CONF_dump_fp(LHASH_OF(CONF_VALUE) *conf, FILE *out); +#endif +int CONF_dump_bio(LHASH_OF(CONF_VALUE) *conf, BIO *out); + +DEPRECATEDIN_1_1_0(void OPENSSL_config(const char *config_name)) + +#if OPENSSL_API_COMPAT < 0x10100000L +# define OPENSSL_no_config() \ + OPENSSL_init_crypto(OPENSSL_INIT_NO_LOAD_CONFIG, NULL) +#endif + +/* + * New conf code. The semantics are different from the functions above. If + * that wasn't the case, the above functions would have been replaced + */ + +struct conf_st { + CONF_METHOD *meth; + void *meth_data; + LHASH_OF(CONF_VALUE) *data; +}; + +CONF *NCONF_new(CONF_METHOD *meth); +CONF_METHOD *NCONF_default(void); +CONF_METHOD *NCONF_WIN32(void); +void NCONF_free(CONF *conf); +void NCONF_free_data(CONF *conf); + +int NCONF_load(CONF *conf, const char *file, long *eline); +# ifndef OPENSSL_NO_STDIO +int NCONF_load_fp(CONF *conf, FILE *fp, long *eline); +# endif +int NCONF_load_bio(CONF *conf, BIO *bp, long *eline); +STACK_OF(CONF_VALUE) *NCONF_get_section(const CONF *conf, + const char *section); +char *NCONF_get_string(const CONF *conf, const char *group, const char *name); +int NCONF_get_number_e(const CONF *conf, const char *group, const char *name, + long *result); +#ifndef OPENSSL_NO_STDIO +int NCONF_dump_fp(const CONF *conf, FILE *out); +#endif +int NCONF_dump_bio(const CONF *conf, BIO *out); + +#define NCONF_get_number(c,g,n,r) NCONF_get_number_e(c,g,n,r) + +/* Module functions */ + +int CONF_modules_load(const CONF *cnf, const char *appname, + unsigned long flags); +int CONF_modules_load_file(const char *filename, const char *appname, + unsigned long flags); +void CONF_modules_unload(int all); +void CONF_modules_finish(void); +#if OPENSSL_API_COMPAT < 0x10100000L +# define CONF_modules_free() while(0) continue +#endif +int CONF_module_add(const char *name, conf_init_func *ifunc, + conf_finish_func *ffunc); + +const char *CONF_imodule_get_name(const CONF_IMODULE *md); +const char *CONF_imodule_get_value(const CONF_IMODULE *md); +void *CONF_imodule_get_usr_data(const CONF_IMODULE *md); +void CONF_imodule_set_usr_data(CONF_IMODULE *md, void *usr_data); +CONF_MODULE *CONF_imodule_get_module(const CONF_IMODULE *md); +unsigned long CONF_imodule_get_flags(const CONF_IMODULE *md); +void CONF_imodule_set_flags(CONF_IMODULE *md, unsigned long flags); +void *CONF_module_get_usr_data(CONF_MODULE *pmod); +void CONF_module_set_usr_data(CONF_MODULE *pmod, void *usr_data); + +char *CONF_get1_default_config_file(void); + +int CONF_parse_list(const char *list, int sep, int nospc, + int (*list_cb) (const char *elem, int len, void *usr), + void *arg); + +void OPENSSL_load_builtin_modules(void); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/conf_api.h b/include/openssl/conf_api.h new file mode 100644 index 0000000..6ae8a30 --- /dev/null +++ b/include/openssl/conf_api.h @@ -0,0 +1,40 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CONF_API_H +# define HEADER_CONF_API_H + +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* Up until OpenSSL 0.9.5a, this was new_section */ +CONF_VALUE *_CONF_new_section(CONF *conf, const char *section); +/* Up until OpenSSL 0.9.5a, this was get_section */ +CONF_VALUE *_CONF_get_section(const CONF *conf, const char *section); +/* Up until OpenSSL 0.9.5a, this was CONF_get_section */ +STACK_OF(CONF_VALUE) *_CONF_get_section_values(const CONF *conf, + const char *section); + +int _CONF_add_string(CONF *conf, CONF_VALUE *section, CONF_VALUE *value); +char *_CONF_get_string(const CONF *conf, const char *section, + const char *name); +long _CONF_get_number(const CONF *conf, const char *section, + const char *name); + +int _CONF_new_data(CONF *conf); +void _CONF_free_data(CONF *conf); + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/conferr.h b/include/openssl/conferr.h new file mode 100644 index 0000000..d1c92f4 --- /dev/null +++ b/include/openssl/conferr.h @@ -0,0 +1,72 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CONFERR_H +# define HEADER_CONFERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_CONF_strings(void); + +/* + * CONF function codes. + */ +# define CONF_F_CONF_DUMP_FP 104 +# define CONF_F_CONF_LOAD 100 +# define CONF_F_CONF_LOAD_FP 103 +# define CONF_F_CONF_PARSE_LIST 119 +# define CONF_F_DEF_LOAD 120 +# define CONF_F_DEF_LOAD_BIO 121 +# define CONF_F_GET_NEXT_FILE 107 +# define CONF_F_MODULE_ADD 122 +# define CONF_F_MODULE_INIT 115 +# define CONF_F_MODULE_LOAD_DSO 117 +# define CONF_F_MODULE_RUN 118 +# define CONF_F_NCONF_DUMP_BIO 105 +# define CONF_F_NCONF_DUMP_FP 106 +# define CONF_F_NCONF_GET_NUMBER_E 112 +# define CONF_F_NCONF_GET_SECTION 108 +# define CONF_F_NCONF_GET_STRING 109 +# define CONF_F_NCONF_LOAD 113 +# define CONF_F_NCONF_LOAD_BIO 110 +# define CONF_F_NCONF_LOAD_FP 114 +# define CONF_F_NCONF_NEW 111 +# define CONF_F_PROCESS_INCLUDE 116 +# define CONF_F_SSL_MODULE_INIT 123 +# define CONF_F_STR_COPY 101 + +/* + * CONF reason codes. + */ +# define CONF_R_ERROR_LOADING_DSO 110 +# define CONF_R_LIST_CANNOT_BE_NULL 115 +# define CONF_R_MISSING_CLOSE_SQUARE_BRACKET 100 +# define CONF_R_MISSING_EQUAL_SIGN 101 +# define CONF_R_MISSING_INIT_FUNCTION 112 +# define CONF_R_MODULE_INITIALIZATION_ERROR 109 +# define CONF_R_NO_CLOSE_BRACE 102 +# define CONF_R_NO_CONF 105 +# define CONF_R_NO_CONF_OR_ENVIRONMENT_VARIABLE 106 +# define CONF_R_NO_SECTION 107 +# define CONF_R_NO_SUCH_FILE 114 +# define CONF_R_NO_VALUE 108 +# define CONF_R_NUMBER_TOO_LARGE 121 +# define CONF_R_RECURSIVE_DIRECTORY_INCLUDE 111 +# define CONF_R_SSL_COMMAND_SECTION_EMPTY 117 +# define CONF_R_SSL_COMMAND_SECTION_NOT_FOUND 118 +# define CONF_R_SSL_SECTION_EMPTY 119 +# define CONF_R_SSL_SECTION_NOT_FOUND 120 +# define CONF_R_UNABLE_TO_CREATE_NEW_SECTION 103 +# define CONF_R_UNKNOWN_MODULE_NAME 113 +# define CONF_R_VARIABLE_EXPANSION_TOO_LONG 116 +# define CONF_R_VARIABLE_HAS_NO_VALUE 104 + +#endif diff --git a/include/openssl/crypto.h b/include/openssl/crypto.h new file mode 100644 index 0000000..cc7c565 --- /dev/null +++ b/include/openssl/crypto.h @@ -0,0 +1,445 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CRYPTO_H +# define HEADER_CRYPTO_H + +# include +# include + +# include + +# ifndef OPENSSL_NO_STDIO +# include +# endif + +# include +# include +# include +# include +# include + +# ifdef CHARSET_EBCDIC +# include +# endif + +/* + * Resolve problems on some operating systems with symbol names that clash + * one way or another + */ +# include + +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# endif + +#ifdef __cplusplus +extern "C" { +#endif + +# if OPENSSL_API_COMPAT < 0x10100000L +# define SSLeay OpenSSL_version_num +# define SSLeay_version OpenSSL_version +# define SSLEAY_VERSION_NUMBER OPENSSL_VERSION_NUMBER +# define SSLEAY_VERSION OPENSSL_VERSION +# define SSLEAY_CFLAGS OPENSSL_CFLAGS +# define SSLEAY_BUILT_ON OPENSSL_BUILT_ON +# define SSLEAY_PLATFORM OPENSSL_PLATFORM +# define SSLEAY_DIR OPENSSL_DIR + +/* + * Old type for allocating dynamic locks. No longer used. Use the new thread + * API instead. + */ +typedef struct { + int dummy; +} CRYPTO_dynlock; + +# endif /* OPENSSL_API_COMPAT */ + +typedef void CRYPTO_RWLOCK; + +CRYPTO_RWLOCK *CRYPTO_THREAD_lock_new(void); +int CRYPTO_THREAD_read_lock(CRYPTO_RWLOCK *lock); +int CRYPTO_THREAD_write_lock(CRYPTO_RWLOCK *lock); +int CRYPTO_THREAD_unlock(CRYPTO_RWLOCK *lock); +void CRYPTO_THREAD_lock_free(CRYPTO_RWLOCK *lock); + +int CRYPTO_atomic_add(int *val, int amount, int *ret, CRYPTO_RWLOCK *lock); + +/* + * The following can be used to detect memory leaks in the library. If + * used, it turns on malloc checking + */ +# define CRYPTO_MEM_CHECK_OFF 0x0 /* Control only */ +# define CRYPTO_MEM_CHECK_ON 0x1 /* Control and mode bit */ +# define CRYPTO_MEM_CHECK_ENABLE 0x2 /* Control and mode bit */ +# define CRYPTO_MEM_CHECK_DISABLE 0x3 /* Control only */ + +struct crypto_ex_data_st { + STACK_OF(void) *sk; +}; +DEFINE_STACK_OF(void) + +/* + * Per class, we have a STACK of function pointers. + */ +# define CRYPTO_EX_INDEX_SSL 0 +# define CRYPTO_EX_INDEX_SSL_CTX 1 +# define CRYPTO_EX_INDEX_SSL_SESSION 2 +# define CRYPTO_EX_INDEX_X509 3 +# define CRYPTO_EX_INDEX_X509_STORE 4 +# define CRYPTO_EX_INDEX_X509_STORE_CTX 5 +# define CRYPTO_EX_INDEX_DH 6 +# define CRYPTO_EX_INDEX_DSA 7 +# define CRYPTO_EX_INDEX_EC_KEY 8 +# define CRYPTO_EX_INDEX_RSA 9 +# define CRYPTO_EX_INDEX_ENGINE 10 +# define CRYPTO_EX_INDEX_UI 11 +# define CRYPTO_EX_INDEX_BIO 12 +# define CRYPTO_EX_INDEX_APP 13 +# define CRYPTO_EX_INDEX_UI_METHOD 14 +# define CRYPTO_EX_INDEX_DRBG 15 +# define CRYPTO_EX_INDEX__COUNT 16 + +/* + * This is the default callbacks, but we can have others as well: this is + * needed in Win32 where the application malloc and the library malloc may + * not be the same. + */ +#define OPENSSL_malloc_init() \ + CRYPTO_set_mem_functions(CRYPTO_malloc, CRYPTO_realloc, CRYPTO_free) + +int CRYPTO_mem_ctrl(int mode); + +# define OPENSSL_malloc(num) \ + CRYPTO_malloc(num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_zalloc(num) \ + CRYPTO_zalloc(num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_realloc(addr, num) \ + CRYPTO_realloc(addr, num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_clear_realloc(addr, old_num, num) \ + CRYPTO_clear_realloc(addr, old_num, num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_clear_free(addr, num) \ + CRYPTO_clear_free(addr, num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_free(addr) \ + CRYPTO_free(addr, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_memdup(str, s) \ + CRYPTO_memdup((str), s, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_strdup(str) \ + CRYPTO_strdup(str, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_strndup(str, n) \ + CRYPTO_strndup(str, n, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_secure_malloc(num) \ + CRYPTO_secure_malloc(num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_secure_zalloc(num) \ + CRYPTO_secure_zalloc(num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_secure_free(addr) \ + CRYPTO_secure_free(addr, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_secure_clear_free(addr, num) \ + CRYPTO_secure_clear_free(addr, num, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_secure_actual_size(ptr) \ + CRYPTO_secure_actual_size(ptr) + +size_t OPENSSL_strlcpy(char *dst, const char *src, size_t siz); +size_t OPENSSL_strlcat(char *dst, const char *src, size_t siz); +size_t OPENSSL_strnlen(const char *str, size_t maxlen); +char *OPENSSL_buf2hexstr(const unsigned char *buffer, long len); +unsigned char *OPENSSL_hexstr2buf(const char *str, long *len); +int OPENSSL_hexchar2int(unsigned char c); + +# define OPENSSL_MALLOC_MAX_NELEMS(type) (((1U<<(sizeof(int)*8-1))-1)/sizeof(type)) + +unsigned long OpenSSL_version_num(void); +const char *OpenSSL_version(int type); +# define OPENSSL_VERSION 0 +# define OPENSSL_CFLAGS 1 +# define OPENSSL_BUILT_ON 2 +# define OPENSSL_PLATFORM 3 +# define OPENSSL_DIR 4 +# define OPENSSL_ENGINES_DIR 5 + +int OPENSSL_issetugid(void); + +typedef void CRYPTO_EX_new (void *parent, void *ptr, CRYPTO_EX_DATA *ad, + int idx, long argl, void *argp); +typedef void CRYPTO_EX_free (void *parent, void *ptr, CRYPTO_EX_DATA *ad, + int idx, long argl, void *argp); +typedef int CRYPTO_EX_dup (CRYPTO_EX_DATA *to, const CRYPTO_EX_DATA *from, + void *from_d, int idx, long argl, void *argp); +__owur int CRYPTO_get_ex_new_index(int class_index, long argl, void *argp, + CRYPTO_EX_new *new_func, CRYPTO_EX_dup *dup_func, + CRYPTO_EX_free *free_func); +/* No longer use an index. */ +int CRYPTO_free_ex_index(int class_index, int idx); + +/* + * Initialise/duplicate/free CRYPTO_EX_DATA variables corresponding to a + * given class (invokes whatever per-class callbacks are applicable) + */ +int CRYPTO_new_ex_data(int class_index, void *obj, CRYPTO_EX_DATA *ad); +int CRYPTO_dup_ex_data(int class_index, CRYPTO_EX_DATA *to, + const CRYPTO_EX_DATA *from); + +void CRYPTO_free_ex_data(int class_index, void *obj, CRYPTO_EX_DATA *ad); + +/* + * Get/set data in a CRYPTO_EX_DATA variable corresponding to a particular + * index (relative to the class type involved) + */ +int CRYPTO_set_ex_data(CRYPTO_EX_DATA *ad, int idx, void *val); +void *CRYPTO_get_ex_data(const CRYPTO_EX_DATA *ad, int idx); + +# if OPENSSL_API_COMPAT < 0x10100000L +/* + * This function cleans up all "ex_data" state. It mustn't be called under + * potential race-conditions. + */ +# define CRYPTO_cleanup_all_ex_data() while(0) continue + +/* + * The old locking functions have been removed completely without compatibility + * macros. This is because the old functions either could not properly report + * errors, or the returned error values were not clearly documented. + * Replacing the locking functions with no-ops would cause race condition + * issues in the affected applications. It is far better for them to fail at + * compile time. + * On the other hand, the locking callbacks are no longer used. Consequently, + * the callback management functions can be safely replaced with no-op macros. + */ +# define CRYPTO_num_locks() (1) +# define CRYPTO_set_locking_callback(func) +# define CRYPTO_get_locking_callback() (NULL) +# define CRYPTO_set_add_lock_callback(func) +# define CRYPTO_get_add_lock_callback() (NULL) + +/* + * These defines where used in combination with the old locking callbacks, + * they are not called anymore, but old code that's not called might still + * use them. + */ +# define CRYPTO_LOCK 1 +# define CRYPTO_UNLOCK 2 +# define CRYPTO_READ 4 +# define CRYPTO_WRITE 8 + +/* This structure is no longer used */ +typedef struct crypto_threadid_st { + int dummy; +} CRYPTO_THREADID; +/* Only use CRYPTO_THREADID_set_[numeric|pointer]() within callbacks */ +# define CRYPTO_THREADID_set_numeric(id, val) +# define CRYPTO_THREADID_set_pointer(id, ptr) +# define CRYPTO_THREADID_set_callback(threadid_func) (0) +# define CRYPTO_THREADID_get_callback() (NULL) +# define CRYPTO_THREADID_current(id) +# define CRYPTO_THREADID_cmp(a, b) (-1) +# define CRYPTO_THREADID_cpy(dest, src) +# define CRYPTO_THREADID_hash(id) (0UL) + +# if OPENSSL_API_COMPAT < 0x10000000L +# define CRYPTO_set_id_callback(func) +# define CRYPTO_get_id_callback() (NULL) +# define CRYPTO_thread_id() (0UL) +# endif /* OPENSSL_API_COMPAT < 0x10000000L */ + +# define CRYPTO_set_dynlock_create_callback(dyn_create_function) +# define CRYPTO_set_dynlock_lock_callback(dyn_lock_function) +# define CRYPTO_set_dynlock_destroy_callback(dyn_destroy_function) +# define CRYPTO_get_dynlock_create_callback() (NULL) +# define CRYPTO_get_dynlock_lock_callback() (NULL) +# define CRYPTO_get_dynlock_destroy_callback() (NULL) +# endif /* OPENSSL_API_COMPAT < 0x10100000L */ + +int CRYPTO_set_mem_functions( + void *(*m) (size_t, const char *, int), + void *(*r) (void *, size_t, const char *, int), + void (*f) (void *, const char *, int)); +int CRYPTO_set_mem_debug(int flag); +void CRYPTO_get_mem_functions( + void *(**m) (size_t, const char *, int), + void *(**r) (void *, size_t, const char *, int), + void (**f) (void *, const char *, int)); + +void *CRYPTO_malloc(size_t num, const char *file, int line); +void *CRYPTO_zalloc(size_t num, const char *file, int line); +void *CRYPTO_memdup(const void *str, size_t siz, const char *file, int line); +char *CRYPTO_strdup(const char *str, const char *file, int line); +char *CRYPTO_strndup(const char *str, size_t s, const char *file, int line); +void CRYPTO_free(void *ptr, const char *file, int line); +void CRYPTO_clear_free(void *ptr, size_t num, const char *file, int line); +void *CRYPTO_realloc(void *addr, size_t num, const char *file, int line); +void *CRYPTO_clear_realloc(void *addr, size_t old_num, size_t num, + const char *file, int line); + +int CRYPTO_secure_malloc_init(size_t sz, int minsize); +int CRYPTO_secure_malloc_done(void); +void *CRYPTO_secure_malloc(size_t num, const char *file, int line); +void *CRYPTO_secure_zalloc(size_t num, const char *file, int line); +void CRYPTO_secure_free(void *ptr, const char *file, int line); +void CRYPTO_secure_clear_free(void *ptr, size_t num, + const char *file, int line); +int CRYPTO_secure_allocated(const void *ptr); +int CRYPTO_secure_malloc_initialized(void); +size_t CRYPTO_secure_actual_size(void *ptr); +size_t CRYPTO_secure_used(void); + +void OPENSSL_cleanse(void *ptr, size_t len); + +# ifndef OPENSSL_NO_CRYPTO_MDEBUG +# define OPENSSL_mem_debug_push(info) \ + CRYPTO_mem_debug_push(info, OPENSSL_FILE, OPENSSL_LINE) +# define OPENSSL_mem_debug_pop() \ + CRYPTO_mem_debug_pop() +int CRYPTO_mem_debug_push(const char *info, const char *file, int line); +int CRYPTO_mem_debug_pop(void); +void CRYPTO_get_alloc_counts(int *mcount, int *rcount, int *fcount); + +/*- + * Debugging functions (enabled by CRYPTO_set_mem_debug(1)) + * The flag argument has the following significance: + * 0: called before the actual memory allocation has taken place + * 1: called after the actual memory allocation has taken place + */ +void CRYPTO_mem_debug_malloc(void *addr, size_t num, int flag, + const char *file, int line); +void CRYPTO_mem_debug_realloc(void *addr1, void *addr2, size_t num, int flag, + const char *file, int line); +void CRYPTO_mem_debug_free(void *addr, int flag, + const char *file, int line); + +int CRYPTO_mem_leaks_cb(int (*cb) (const char *str, size_t len, void *u), + void *u); +# ifndef OPENSSL_NO_STDIO +int CRYPTO_mem_leaks_fp(FILE *); +# endif +int CRYPTO_mem_leaks(BIO *bio); +# endif + +/* die if we have to */ +ossl_noreturn void OPENSSL_die(const char *assertion, const char *file, int line); +# if OPENSSL_API_COMPAT < 0x10100000L +# define OpenSSLDie(f,l,a) OPENSSL_die((a),(f),(l)) +# endif +# define OPENSSL_assert(e) \ + (void)((e) ? 0 : (OPENSSL_die("assertion failed: " #e, OPENSSL_FILE, OPENSSL_LINE), 1)) + +int OPENSSL_isservice(void); + +int FIPS_mode(void); +int FIPS_mode_set(int r); + +void OPENSSL_init(void); +# ifdef OPENSSL_SYS_UNIX +void OPENSSL_fork_prepare(void); +void OPENSSL_fork_parent(void); +void OPENSSL_fork_child(void); +# endif + +struct tm *OPENSSL_gmtime(const time_t *timer, struct tm *result); +int OPENSSL_gmtime_adj(struct tm *tm, int offset_day, long offset_sec); +int OPENSSL_gmtime_diff(int *pday, int *psec, + const struct tm *from, const struct tm *to); + +/* + * CRYPTO_memcmp returns zero iff the |len| bytes at |a| and |b| are equal. + * It takes an amount of time dependent on |len|, but independent of the + * contents of |a| and |b|. Unlike memcmp, it cannot be used to put elements + * into a defined order as the return value when a != b is undefined, other + * than to be non-zero. + */ +int CRYPTO_memcmp(const void * in_a, const void * in_b, size_t len); + +/* Standard initialisation options */ +# define OPENSSL_INIT_NO_LOAD_CRYPTO_STRINGS 0x00000001L +# define OPENSSL_INIT_LOAD_CRYPTO_STRINGS 0x00000002L +# define OPENSSL_INIT_ADD_ALL_CIPHERS 0x00000004L +# define OPENSSL_INIT_ADD_ALL_DIGESTS 0x00000008L +# define OPENSSL_INIT_NO_ADD_ALL_CIPHERS 0x00000010L +# define OPENSSL_INIT_NO_ADD_ALL_DIGESTS 0x00000020L +# define OPENSSL_INIT_LOAD_CONFIG 0x00000040L +# define OPENSSL_INIT_NO_LOAD_CONFIG 0x00000080L +# define OPENSSL_INIT_ASYNC 0x00000100L +# define OPENSSL_INIT_ENGINE_RDRAND 0x00000200L +# define OPENSSL_INIT_ENGINE_DYNAMIC 0x00000400L +# define OPENSSL_INIT_ENGINE_OPENSSL 0x00000800L +# define OPENSSL_INIT_ENGINE_CRYPTODEV 0x00001000L +# define OPENSSL_INIT_ENGINE_CAPI 0x00002000L +# define OPENSSL_INIT_ENGINE_PADLOCK 0x00004000L +# define OPENSSL_INIT_ENGINE_AFALG 0x00008000L +/* OPENSSL_INIT_ZLIB 0x00010000L */ +# define OPENSSL_INIT_ATFORK 0x00020000L +/* OPENSSL_INIT_BASE_ONLY 0x00040000L */ +/* OPENSSL_INIT flag range 0xfff00000 reserved for OPENSSL_init_ssl() */ +/* Max OPENSSL_INIT flag value is 0x80000000 */ + +/* openssl and dasync not counted as builtin */ +# define OPENSSL_INIT_ENGINE_ALL_BUILTIN \ + (OPENSSL_INIT_ENGINE_RDRAND | OPENSSL_INIT_ENGINE_DYNAMIC \ + | OPENSSL_INIT_ENGINE_CRYPTODEV | OPENSSL_INIT_ENGINE_CAPI | \ + OPENSSL_INIT_ENGINE_PADLOCK) + + +/* Library initialisation functions */ +void OPENSSL_cleanup(void); +int OPENSSL_init_crypto(uint64_t opts, const OPENSSL_INIT_SETTINGS *settings); +int OPENSSL_atexit(void (*handler)(void)); +void OPENSSL_thread_stop(void); + +/* Low-level control of initialization */ +OPENSSL_INIT_SETTINGS *OPENSSL_INIT_new(void); +# ifndef OPENSSL_NO_STDIO +int OPENSSL_INIT_set_config_appname(OPENSSL_INIT_SETTINGS *settings, + const char *config_file); +# endif +void OPENSSL_INIT_free(OPENSSL_INIT_SETTINGS *settings); + +# if defined(OPENSSL_THREADS) && !defined(CRYPTO_TDEBUG) +# if defined(_WIN32) +# if defined(BASETYPES) || defined(_WINDEF_H) +/* application has to include in order to use this */ +typedef DWORD CRYPTO_THREAD_LOCAL; +typedef DWORD CRYPTO_THREAD_ID; + +typedef LONG CRYPTO_ONCE; +# define CRYPTO_ONCE_STATIC_INIT 0 +# endif +# else +# include +typedef pthread_once_t CRYPTO_ONCE; +typedef pthread_key_t CRYPTO_THREAD_LOCAL; +typedef pthread_t CRYPTO_THREAD_ID; + +# define CRYPTO_ONCE_STATIC_INIT PTHREAD_ONCE_INIT +# endif +# endif + +# if !defined(CRYPTO_ONCE_STATIC_INIT) +typedef unsigned int CRYPTO_ONCE; +typedef unsigned int CRYPTO_THREAD_LOCAL; +typedef unsigned int CRYPTO_THREAD_ID; +# define CRYPTO_ONCE_STATIC_INIT 0 +# endif + +int CRYPTO_THREAD_run_once(CRYPTO_ONCE *once, void (*init)(void)); + +int CRYPTO_THREAD_init_local(CRYPTO_THREAD_LOCAL *key, void (*cleanup)(void *)); +void *CRYPTO_THREAD_get_local(CRYPTO_THREAD_LOCAL *key); +int CRYPTO_THREAD_set_local(CRYPTO_THREAD_LOCAL *key, void *val); +int CRYPTO_THREAD_cleanup_local(CRYPTO_THREAD_LOCAL *key); + +CRYPTO_THREAD_ID CRYPTO_THREAD_get_current_id(void); +int CRYPTO_THREAD_compare_id(CRYPTO_THREAD_ID a, CRYPTO_THREAD_ID b); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/crypto/arm_arch.h b/include/openssl/crypto/arm_arch.h new file mode 100644 index 0000000..f11b543 --- /dev/null +++ b/include/openssl/crypto/arm_arch.h @@ -0,0 +1,84 @@ +/* + * Copyright 2011-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef __ARM_ARCH_H__ +# define __ARM_ARCH_H__ + +# if !defined(__ARM_ARCH__) +# if defined(__CC_ARM) +# define __ARM_ARCH__ __TARGET_ARCH_ARM +# if defined(__BIG_ENDIAN) +# define __ARMEB__ +# else +# define __ARMEL__ +# endif +# elif defined(__GNUC__) +# if defined(__aarch64__) +# define __ARM_ARCH__ 8 +# if __BYTE_ORDER__==__ORDER_BIG_ENDIAN__ +# define __ARMEB__ +# else +# define __ARMEL__ +# endif + /* + * Why doesn't gcc define __ARM_ARCH__? Instead it defines + * bunch of below macros. See all_architectures[] table in + * gcc/config/arm/arm.c. On a side note it defines + * __ARMEL__/__ARMEB__ for little-/big-endian. + */ +# elif defined(__ARM_ARCH) +# define __ARM_ARCH__ __ARM_ARCH +# elif defined(__ARM_ARCH_8A__) +# define __ARM_ARCH__ 8 +# elif defined(__ARM_ARCH_7__) || defined(__ARM_ARCH_7A__) || \ + defined(__ARM_ARCH_7R__)|| defined(__ARM_ARCH_7M__) || \ + defined(__ARM_ARCH_7EM__) +# define __ARM_ARCH__ 7 +# elif defined(__ARM_ARCH_6__) || defined(__ARM_ARCH_6J__) || \ + defined(__ARM_ARCH_6K__)|| defined(__ARM_ARCH_6M__) || \ + defined(__ARM_ARCH_6Z__)|| defined(__ARM_ARCH_6ZK__) || \ + defined(__ARM_ARCH_6T2__) +# define __ARM_ARCH__ 6 +# elif defined(__ARM_ARCH_5__) || defined(__ARM_ARCH_5T__) || \ + defined(__ARM_ARCH_5E__)|| defined(__ARM_ARCH_5TE__) || \ + defined(__ARM_ARCH_5TEJ__) +# define __ARM_ARCH__ 5 +# elif defined(__ARM_ARCH_4__) || defined(__ARM_ARCH_4T__) +# define __ARM_ARCH__ 4 +# else +# error "unsupported ARM architecture" +# endif +# endif +# endif + +# if !defined(__ARM_MAX_ARCH__) +# define __ARM_MAX_ARCH__ __ARM_ARCH__ +# endif + +# if __ARM_MAX_ARCH__<__ARM_ARCH__ +# error "__ARM_MAX_ARCH__ can't be less than __ARM_ARCH__" +# elif __ARM_MAX_ARCH__!=__ARM_ARCH__ +# if __ARM_ARCH__<7 && __ARM_MAX_ARCH__>=7 && defined(__ARMEB__) +# error "can't build universal big-endian binary" +# endif +# endif + +# ifndef __ASSEMBLER__ +extern unsigned int OPENSSL_armcap_P; +# endif + +# define ARMV7_NEON (1<<0) +# define ARMV7_TICK (1<<1) +# define ARMV8_AES (1<<2) +# define ARMV8_SHA1 (1<<3) +# define ARMV8_SHA256 (1<<4) +# define ARMV8_PMULL (1<<5) +# define ARMV8_SHA512 (1<<6) + +#endif diff --git a/include/openssl/crypto/buildinf.h b/include/openssl/crypto/buildinf.h new file mode 100644 index 0000000..20e1249 --- /dev/null +++ b/include/openssl/crypto/buildinf.h @@ -0,0 +1,47 @@ +/* + * WARNING: do not edit! + * Generated by util/mkbuildinf.pl + * + * Copyright 2014-2017 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#define PLATFORM "platform: mingw64" +#define DATE "built on: Sat Jul 11 20:24:19 2020 UTC" + +/* + * Generate compiler_flags as an array of individual characters. This is a + * workaround for the situation where CFLAGS gets too long for a C90 string + * literal + */ +static const char compiler_flags[] = { + 'c','o','m','p','i','l','e','r',':',' ','g','c','c',' ','-','m', + '6','4',' ','-','W','a','l','l',' ','-','O','3',' ','-','D','L', + '_','E','N','D','I','A','N',' ','-','D','O','P','E','N','S','S', + 'L','_','P','I','C',' ','-','D','O','P','E','N','S','S','L','_', + 'C','P','U','I','D','_','O','B','J',' ','-','D','O','P','E','N', + 'S','S','L','_','I','A','3','2','_','S','S','E','2',' ','-','D', + 'O','P','E','N','S','S','L','_','B','N','_','A','S','M','_','M', + 'O','N','T',' ','-','D','O','P','E','N','S','S','L','_','B','N', + '_','A','S','M','_','M','O','N','T','5',' ','-','D','O','P','E', + 'N','S','S','L','_','B','N','_','A','S','M','_','G','F','2','m', + ' ','-','D','S','H','A','1','_','A','S','M',' ','-','D','S','H', + 'A','2','5','6','_','A','S','M',' ','-','D','S','H','A','5','1', + '2','_','A','S','M',' ','-','D','K','E','C','C','A','K','1','6', + '0','0','_','A','S','M',' ','-','D','R','C','4','_','A','S','M', + ' ','-','D','M','D','5','_','A','S','M',' ','-','D','A','E','S', + '_','A','S','M',' ','-','D','V','P','A','E','S','_','A','S','M', + ' ','-','D','B','S','A','E','S','_','A','S','M',' ','-','D','G', + 'H','A','S','H','_','A','S','M',' ','-','D','E','C','P','_','N', + 'I','S','T','Z','2','5','6','_','A','S','M',' ','-','D','X','2', + '5','5','1','9','_','A','S','M',' ','-','D','P','A','D','L','O', + 'C','K','_','A','S','M',' ','-','D','P','O','L','Y','1','3','0', + '5','_','A','S','M',' ','-','D','U','N','I','C','O','D','E',' ', + '-','D','_','U','N','I','C','O','D','E',' ','-','D','W','I','N', + '3','2','_','L','E','A','N','_','A','N','D','_','M','E','A','N', + ' ','-','D','_','M','T',' ','-','D','N','D','E','B','U','G','\0' +}; diff --git a/include/openssl/crypto/internal/__DECC_INCLUDE_EPILOGUE.H b/include/openssl/crypto/internal/__DECC_INCLUDE_EPILOGUE.H new file mode 100644 index 0000000..c350018 --- /dev/null +++ b/include/openssl/crypto/internal/__DECC_INCLUDE_EPILOGUE.H @@ -0,0 +1,16 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This file is only used by HP C on VMS, and is included automatically + * after each header file from this directory + */ + +/* restore state. Must correspond to the save in __decc_include_prologue.h */ +#pragma names restore diff --git a/include/openssl/crypto/internal/__DECC_INCLUDE_PROLOGUE.H b/include/openssl/crypto/internal/__DECC_INCLUDE_PROLOGUE.H new file mode 100644 index 0000000..9a9c777 --- /dev/null +++ b/include/openssl/crypto/internal/__DECC_INCLUDE_PROLOGUE.H @@ -0,0 +1,20 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This file is only used by HP C on VMS, and is included automatically + * after each header file from this directory + */ + +/* save state */ +#pragma names save +/* have the compiler shorten symbols larger than 31 chars to 23 chars + * followed by a 8 hex char CRC + */ +#pragma names as_is,shortened diff --git a/include/openssl/crypto/internal/aria.h b/include/openssl/crypto/internal/aria.h new file mode 100644 index 0000000..df86996 --- /dev/null +++ b/include/openssl/crypto/internal/aria.h @@ -0,0 +1,50 @@ +/* + * Copyright 2006-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + + /* Copyright (c) 2017 National Security Research Institute. All rights reserved. */ + +#ifndef HEADER_ARIA_H +# define HEADER_ARIA_H + +# include + +# ifdef OPENSSL_NO_ARIA +# error ARIA is disabled. +# endif + +# define ARIA_ENCRYPT 1 +# define ARIA_DECRYPT 0 + +# define ARIA_BLOCK_SIZE 16 /* Size of each encryption/decryption block */ +# define ARIA_MAX_KEYS 17 /* Number of keys needed in the worst case */ + +typedef union { + unsigned char c[ARIA_BLOCK_SIZE]; + unsigned int u[ARIA_BLOCK_SIZE / sizeof(unsigned int)]; +} ARIA_u128; + +typedef unsigned char ARIA_c128[ARIA_BLOCK_SIZE]; + +struct aria_key_st { + ARIA_u128 rd_key[ARIA_MAX_KEYS]; + unsigned int rounds; +}; +typedef struct aria_key_st ARIA_KEY; + + +int aria_set_encrypt_key(const unsigned char *userKey, const int bits, + ARIA_KEY *key); +int aria_set_decrypt_key(const unsigned char *userKey, const int bits, + ARIA_KEY *key); + +void aria_encrypt(const unsigned char *in, unsigned char *out, + const ARIA_KEY *key); + +#endif diff --git a/include/openssl/crypto/internal/asn1_int.h b/include/openssl/crypto/internal/asn1_int.h new file mode 100644 index 0000000..5c72a55 --- /dev/null +++ b/include/openssl/crypto/internal/asn1_int.h @@ -0,0 +1,115 @@ +/* + * Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* Internal ASN1 structures and functions: not for application use */ + +/* ASN1 public key method structure */ + +#include "include/openssl/asn1.h" + +struct evp_pkey_asn1_method_st { + int pkey_id; + int pkey_base_id; + unsigned long pkey_flags; + char *pem_str; + char *info; + int (*pub_decode) (EVP_PKEY *pk, X509_PUBKEY *pub); + int (*pub_encode) (X509_PUBKEY *pub, const EVP_PKEY *pk); + int (*pub_cmp) (const EVP_PKEY *a, const EVP_PKEY *b); + int (*pub_print) (BIO *out, const EVP_PKEY *pkey, int indent, + ASN1_PCTX *pctx); + int (*priv_decode) (EVP_PKEY *pk, const PKCS8_PRIV_KEY_INFO *p8inf); + int (*priv_encode) (PKCS8_PRIV_KEY_INFO *p8, const EVP_PKEY *pk); + int (*priv_print) (BIO *out, const EVP_PKEY *pkey, int indent, + ASN1_PCTX *pctx); + int (*pkey_size) (const EVP_PKEY *pk); + int (*pkey_bits) (const EVP_PKEY *pk); + int (*pkey_security_bits) (const EVP_PKEY *pk); + int (*param_decode) (EVP_PKEY *pkey, + const unsigned char **pder, int derlen); + int (*param_encode) (const EVP_PKEY *pkey, unsigned char **pder); + int (*param_missing) (const EVP_PKEY *pk); + int (*param_copy) (EVP_PKEY *to, const EVP_PKEY *from); + int (*param_cmp) (const EVP_PKEY *a, const EVP_PKEY *b); + int (*param_print) (BIO *out, const EVP_PKEY *pkey, int indent, + ASN1_PCTX *pctx); + int (*sig_print) (BIO *out, + const X509_ALGOR *sigalg, const ASN1_STRING *sig, + int indent, ASN1_PCTX *pctx); + void (*pkey_free) (EVP_PKEY *pkey); + int (*pkey_ctrl) (EVP_PKEY *pkey, int op, long arg1, void *arg2); + /* Legacy functions for old PEM */ + int (*old_priv_decode) (EVP_PKEY *pkey, + const unsigned char **pder, int derlen); + int (*old_priv_encode) (const EVP_PKEY *pkey, unsigned char **pder); + /* Custom ASN1 signature verification */ + int (*item_verify) (EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn, + X509_ALGOR *a, ASN1_BIT_STRING *sig, EVP_PKEY *pkey); + int (*item_sign) (EVP_MD_CTX *ctx, const ASN1_ITEM *it, void *asn, + X509_ALGOR *alg1, X509_ALGOR *alg2, + ASN1_BIT_STRING *sig); + int (*siginf_set) (X509_SIG_INFO *siginf, const X509_ALGOR *alg, + const ASN1_STRING *sig); + /* Check */ + int (*pkey_check) (const EVP_PKEY *pk); + int (*pkey_public_check) (const EVP_PKEY *pk); + int (*pkey_param_check) (const EVP_PKEY *pk); + /* Get/set raw private/public key data */ + int (*set_priv_key) (EVP_PKEY *pk, const unsigned char *priv, size_t len); + int (*set_pub_key) (EVP_PKEY *pk, const unsigned char *pub, size_t len); + int (*get_priv_key) (const EVP_PKEY *pk, unsigned char *priv, size_t *len); + int (*get_pub_key) (const EVP_PKEY *pk, unsigned char *pub, size_t *len); +} /* EVP_PKEY_ASN1_METHOD */ ; + +DEFINE_STACK_OF_CONST(EVP_PKEY_ASN1_METHOD) + +extern const EVP_PKEY_ASN1_METHOD cmac_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD dh_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD dhx_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD dsa_asn1_meths[5]; +extern const EVP_PKEY_ASN1_METHOD eckey_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD ecx25519_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD ecx448_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD ed25519_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD ed448_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD sm2_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD poly1305_asn1_meth; + +extern const EVP_PKEY_ASN1_METHOD hmac_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD rsa_asn1_meths[2]; +extern const EVP_PKEY_ASN1_METHOD rsa_pss_asn1_meth; +extern const EVP_PKEY_ASN1_METHOD siphash_asn1_meth; + +/* + * These are used internally in the ASN1_OBJECT to keep track of whether the + * names and data need to be free()ed + */ +# define ASN1_OBJECT_FLAG_DYNAMIC 0x01/* internal use */ +# define ASN1_OBJECT_FLAG_CRITICAL 0x02/* critical x509v3 object id */ +# define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04/* internal use */ +# define ASN1_OBJECT_FLAG_DYNAMIC_DATA 0x08/* internal use */ +struct asn1_object_st { + const char *sn, *ln; + int nid; + int length; + const unsigned char *data; /* data remains const after init */ + int flags; /* Should we free this one */ +}; + +/* ASN1 print context structure */ + +struct asn1_pctx_st { + unsigned long flags; + unsigned long nm_flags; + unsigned long cert_flags; + unsigned long oid_flags; + unsigned long str_flags; +} /* ASN1_PCTX */ ; + +int asn1_d2i_read_bio(BIO *in, BUF_MEM **pb); diff --git a/include/openssl/crypto/internal/async.h b/include/openssl/crypto/internal/async.h new file mode 100644 index 0000000..736cd87 --- /dev/null +++ b/include/openssl/crypto/internal/async.h @@ -0,0 +1,15 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +int async_init(void); +void async_deinit(void); +void async_delete_thread_state(void); + diff --git a/include/openssl/crypto/internal/bn_conf.h b/include/openssl/crypto/internal/bn_conf.h new file mode 100644 index 0000000..0d071bd --- /dev/null +++ b/include/openssl/crypto/internal/bn_conf.h @@ -0,0 +1,28 @@ +/* WARNING: do not edit! */ +/* Generated by Makefile from crypto/include/internal/bn_conf.h.in */ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BN_CONF_H +# define HEADER_BN_CONF_H + +/* + * The contents of this file are not used in the UEFI build, as + * both 32-bit and 64-bit builds are supported from a single run + * of the Configure script. + */ + +/* Should we define BN_DIV2W here? */ + +/* Only one for the following should be defined */ +#undef SIXTY_FOUR_BIT_LONG +#define SIXTY_FOUR_BIT +#undef THIRTY_TWO_BIT + +#endif diff --git a/include/openssl/crypto/internal/bn_dh.h b/include/openssl/crypto/internal/bn_dh.h new file mode 100644 index 0000000..22635cb --- /dev/null +++ b/include/openssl/crypto/internal/bn_dh.h @@ -0,0 +1,26 @@ +/* + * Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include "include/openssl/bn.h" + +#define declare_dh_bn(x) \ + extern const BIGNUM _bignum_dh##x##_p; \ + extern const BIGNUM _bignum_dh##x##_g; \ + extern const BIGNUM _bignum_dh##x##_q; + +declare_dh_bn(1024_160) +declare_dh_bn(2048_224) +declare_dh_bn(2048_256) + +extern const BIGNUM _bignum_ffdhe2048_p; +extern const BIGNUM _bignum_ffdhe3072_p; +extern const BIGNUM _bignum_ffdhe4096_p; +extern const BIGNUM _bignum_ffdhe6144_p; +extern const BIGNUM _bignum_ffdhe8192_p; +extern const BIGNUM _bignum_const_2; diff --git a/include/openssl/crypto/internal/bn_int.h b/include/openssl/crypto/internal/bn_int.h new file mode 100644 index 0000000..ec9e9f7 --- /dev/null +++ b/include/openssl/crypto/internal/bn_int.h @@ -0,0 +1,83 @@ +/* + * Copyright 2014-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_BN_INT_H +# define HEADER_BN_INT_H + +# include +# include + +BIGNUM *bn_wexpand(BIGNUM *a, int words); +BIGNUM *bn_expand2(BIGNUM *a, int words); + +void bn_correct_top(BIGNUM *a); + +/* + * Determine the modified width-(w+1) Non-Adjacent Form (wNAF) of 'scalar'. + * This is an array r[] of values that are either zero or odd with an + * absolute value less than 2^w satisfying scalar = \sum_j r[j]*2^j where at + * most one of any w+1 consecutive digits is non-zero with the exception that + * the most significant digit may be only w-1 zeros away from that next + * non-zero digit. + */ +signed char *bn_compute_wNAF(const BIGNUM *scalar, int w, size_t *ret_len); + +int bn_get_top(const BIGNUM *a); + +int bn_get_dmax(const BIGNUM *a); + +/* Set all words to zero */ +void bn_set_all_zero(BIGNUM *a); + +/* + * Copy the internal BIGNUM words into out which holds size elements (and size + * must be bigger than top) + */ +int bn_copy_words(BN_ULONG *out, const BIGNUM *in, int size); + +BN_ULONG *bn_get_words(const BIGNUM *a); + +/* + * Set the internal data words in a to point to words which contains size + * elements. The BN_FLG_STATIC_DATA flag is set + */ +void bn_set_static_words(BIGNUM *a, const BN_ULONG *words, int size); + +/* + * Copy words into the BIGNUM |a|, reallocating space as necessary. + * The negative flag of |a| is not modified. + * Returns 1 on success and 0 on failure. + */ +/* + * |num_words| is int because bn_expand2 takes an int. This is an internal + * function so we simply trust callers not to pass negative values. + */ +int bn_set_words(BIGNUM *a, const BN_ULONG *words, int num_words); + +/* + * Some BIGNUM functions assume most significant limb to be non-zero, which + * is customarily arranged by bn_correct_top. Output from below functions + * is not processed with bn_correct_top, and for this reason it may not be + * returned out of public API. It may only be passed internally into other + * functions known to support non-minimal or zero-padded BIGNUMs. + */ +int bn_mul_mont_fixed_top(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + BN_MONT_CTX *mont, BN_CTX *ctx); +int bn_to_mont_fixed_top(BIGNUM *r, const BIGNUM *a, BN_MONT_CTX *mont, + BN_CTX *ctx); +int bn_from_mont_fixed_top(BIGNUM *r, const BIGNUM *a, BN_MONT_CTX *mont, + BN_CTX *ctx); +int bn_mod_add_fixed_top(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const BIGNUM *m); +int bn_mod_sub_fixed_top(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, + const BIGNUM *m); +int bn_mul_fixed_top(BIGNUM *r, const BIGNUM *a, const BIGNUM *b, BN_CTX *ctx); +int bn_sqr_fixed_top(BIGNUM *r, const BIGNUM *a, BN_CTX *ctx); + +#endif diff --git a/include/openssl/crypto/internal/bn_srp.h b/include/openssl/crypto/internal/bn_srp.h new file mode 100644 index 0000000..f50575d --- /dev/null +++ b/include/openssl/crypto/internal/bn_srp.h @@ -0,0 +1,34 @@ +/* + * Copyright 2014-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include "include/openssl/bn.h" + +#ifndef OPENSSL_NO_SRP + +extern const BIGNUM bn_group_1024; + +extern const BIGNUM bn_group_1536; + +extern const BIGNUM bn_group_2048; + +extern const BIGNUM bn_group_3072; + +extern const BIGNUM bn_group_4096; + +extern const BIGNUM bn_group_6144; + +extern const BIGNUM bn_group_8192; + +extern const BIGNUM bn_generator_19; + +extern const BIGNUM bn_generator_5; + +extern const BIGNUM bn_generator_2; + +#endif diff --git a/include/openssl/crypto/internal/chacha.h b/include/openssl/crypto/internal/chacha.h new file mode 100644 index 0000000..67243f2 --- /dev/null +++ b/include/openssl/crypto/internal/chacha.h @@ -0,0 +1,42 @@ +/* + * Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CHACHA_H +#define HEADER_CHACHA_H + +#include + +/* + * ChaCha20_ctr32 encrypts |len| bytes from |inp| with the given key and + * nonce and writes the result to |out|, which may be equal to |inp|. + * The |key| is not 32 bytes of verbatim key material though, but the + * said material collected into 8 32-bit elements array in host byte + * order. Same approach applies to nonce: the |counter| argument is + * pointer to concatenated nonce and counter values collected into 4 + * 32-bit elements. This, passing crypto material collected into 32-bit + * elements as opposite to passing verbatim byte vectors, is chosen for + * efficiency in multi-call scenarios. + */ +void ChaCha20_ctr32(unsigned char *out, const unsigned char *inp, + size_t len, const unsigned int key[8], + const unsigned int counter[4]); +/* + * You can notice that there is no key setup procedure. Because it's + * as trivial as collecting bytes into 32-bit elements, it's reckoned + * that below macro is sufficient. + */ +#define CHACHA_U8TOU32(p) ( \ + ((unsigned int)(p)[0]) | ((unsigned int)(p)[1]<<8) | \ + ((unsigned int)(p)[2]<<16) | ((unsigned int)(p)[3]<<24) ) + +#define CHACHA_KEY_SIZE 32 +#define CHACHA_CTR_SIZE 16 +#define CHACHA_BLK_SIZE 64 + +#endif diff --git a/include/openssl/crypto/internal/cryptlib_int.h b/include/openssl/crypto/internal/cryptlib_int.h new file mode 100644 index 0000000..bdb9757 --- /dev/null +++ b/include/openssl/crypto/internal/cryptlib_int.h @@ -0,0 +1,35 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include "include/openssl/internal/cryptlib.h" + +/* This file is not scanned by mkdef.pl, whereas cryptlib.h is */ + +struct thread_local_inits_st { + int async; + int err_state; + int rand; +}; + +int ossl_init_thread_start(uint64_t opts); + +/* + * OPENSSL_INIT flags. The primary list of these is in crypto.h. Flags below + * are those omitted from crypto.h because they are "reserved for internal + * use". + */ +# define OPENSSL_INIT_ZLIB 0x00010000L +# define OPENSSL_INIT_BASE_ONLY 0x00040000L + +/* OPENSSL_INIT_THREAD flags */ +# define OPENSSL_INIT_THREAD_ASYNC 0x01 +# define OPENSSL_INIT_THREAD_ERR_STATE 0x02 +# define OPENSSL_INIT_THREAD_RAND 0x04 + +void ossl_malloc_setup_failures(void); diff --git a/include/openssl/crypto/internal/ctype.h b/include/openssl/crypto/internal/ctype.h new file mode 100644 index 0000000..a35b12b --- /dev/null +++ b/include/openssl/crypto/internal/ctype.h @@ -0,0 +1,80 @@ +/* + * Copyright 2017 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This version of ctype.h provides a standardised and platform + * independent implementation that supports seven bit ASCII characters. + * The specific intent is to not pass extended ASCII characters (> 127) + * even if the host operating system would. + * + * There is EBCDIC support included for machines which use this. However, + * there are a number of concerns about how well EBCDIC is supported + * throughout the rest of the source code. Refer to issue #4154 for + * details. + */ +#ifndef INTERNAL_CTYPE_H +# define INTERNAL_CTYPE_H + +# define CTYPE_MASK_lower 0x1 +# define CTYPE_MASK_upper 0x2 +# define CTYPE_MASK_digit 0x4 +# define CTYPE_MASK_space 0x8 +# define CTYPE_MASK_xdigit 0x10 +# define CTYPE_MASK_blank 0x20 +# define CTYPE_MASK_cntrl 0x40 +# define CTYPE_MASK_graph 0x80 +# define CTYPE_MASK_print 0x100 +# define CTYPE_MASK_punct 0x200 +# define CTYPE_MASK_base64 0x400 +# define CTYPE_MASK_asn1print 0x800 + +# define CTYPE_MASK_alpha (CTYPE_MASK_lower | CTYPE_MASK_upper) +# define CTYPE_MASK_alnum (CTYPE_MASK_alpha | CTYPE_MASK_digit) + +/* + * The ascii mask assumes that any other classification implies that + * the character is ASCII and that there are no ASCII characters + * that aren't in any of the classifications. + * + * This assumption holds at the moment, but it might not in the future. + */ +# define CTYPE_MASK_ascii (~0) + +# ifdef CHARSET_EBCDIC +int ossl_toascii(int c); +int ossl_fromascii(int c); +# else +# define ossl_toascii(c) (c) +# define ossl_fromascii(c) (c) +# endif +int ossl_ctype_check(int c, unsigned int mask); +int ossl_tolower(int c); +int ossl_toupper(int c); + +# define ossl_isalnum(c) (ossl_ctype_check((c), CTYPE_MASK_alnum)) +# define ossl_isalpha(c) (ossl_ctype_check((c), CTYPE_MASK_alpha)) +# ifdef CHARSET_EBCDIC +# define ossl_isascii(c) (ossl_ctype_check((c), CTYPE_MASK_ascii)) +# else +# define ossl_isascii(c) (((c) & ~127) == 0) +# endif +# define ossl_isblank(c) (ossl_ctype_check((c), CTYPE_MASK_blank)) +# define ossl_iscntrl(c) (ossl_ctype_check((c), CTYPE_MASK_cntrl)) +# define ossl_isdigit(c) (ossl_ctype_check((c), CTYPE_MASK_digit)) +# define ossl_isgraph(c) (ossl_ctype_check((c), CTYPE_MASK_graph)) +# define ossl_islower(c) (ossl_ctype_check((c), CTYPE_MASK_lower)) +# define ossl_isprint(c) (ossl_ctype_check((c), CTYPE_MASK_print)) +# define ossl_ispunct(c) (ossl_ctype_check((c), CTYPE_MASK_punct)) +# define ossl_isspace(c) (ossl_ctype_check((c), CTYPE_MASK_space)) +# define ossl_isupper(c) (ossl_ctype_check((c), CTYPE_MASK_upper)) +# define ossl_isxdigit(c) (ossl_ctype_check((c), CTYPE_MASK_xdigit)) +# define ossl_isbase64(c) (ossl_ctype_check((c), CTYPE_MASK_base64)) +# define ossl_isasn1print(c) (ossl_ctype_check((c), CTYPE_MASK_asn1print)) + +#endif diff --git a/include/openssl/crypto/internal/dso_conf.h b/include/openssl/crypto/internal/dso_conf.h new file mode 100644 index 0000000..d476661 --- /dev/null +++ b/include/openssl/crypto/internal/dso_conf.h @@ -0,0 +1,18 @@ +/* WARNING: do not edit! */ +/* Generated by Makefile from crypto/include/internal/dso_conf.h.in */ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DSO_CONF_H +# define HEADER_DSO_CONF_H + +# define DSO_WIN32 +# define DSO_EXTENSION ".dll" + +#endif diff --git a/include/openssl/crypto/internal/ec_int.h b/include/openssl/crypto/internal/ec_int.h new file mode 100644 index 0000000..0b45562 --- /dev/null +++ b/include/openssl/crypto/internal/ec_int.h @@ -0,0 +1,45 @@ +/* + * Copyright 2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* Internal EC functions for other submodules: not for application use */ + +#ifndef HEADER_OSSL_EC_INTERNAL_H +# define HEADER_OSSL_EC_INTERNAL_H +# include + +# ifndef OPENSSL_NO_EC + +# include + +/*- + * Computes the multiplicative inverse of x in the range + * [1,EC_GROUP::order), where EC_GROUP::order is the cardinality of the + * subgroup generated by the generator G: + * + * res := x^(-1) (mod EC_GROUP::order). + * + * This function expects the following two conditions to hold: + * - the EC_GROUP order is prime, and + * - x is included in the range [1, EC_GROUP::order). + * + * This function returns 1 on success, 0 on error. + * + * If the EC_GROUP order is even, this function explicitly returns 0 as + * an error. + * In case any of the two conditions stated above is not satisfied, + * the correctness of its output is not guaranteed, even if the return + * value could still be 1 (as primality testing and a conditional modular + * reduction round on the input can be omitted by the underlying + * implementations for better SCA properties on regular input values). + */ +__owur int ec_group_do_inverse_ord(const EC_GROUP *group, BIGNUM *res, + const BIGNUM *x, BN_CTX *ctx); + +# endif /* OPENSSL_NO_EC */ +#endif diff --git a/include/openssl/crypto/internal/engine.h b/include/openssl/crypto/internal/engine.h new file mode 100644 index 0000000..cc2bdac --- /dev/null +++ b/include/openssl/crypto/internal/engine.h @@ -0,0 +1,20 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +void engine_load_openssl_int(void); +void engine_load_devcrypto_int(void); +void engine_load_rdrand_int(void); +void engine_load_dynamic_int(void); +void engine_load_padlock_int(void); +void engine_load_capi_int(void); +void engine_load_dasync_int(void); +void engine_load_afalg_int(void); +void engine_cleanup_int(void); diff --git a/include/openssl/crypto/internal/err_int.h b/include/openssl/crypto/internal/err_int.h new file mode 100644 index 0000000..44ac944 --- /dev/null +++ b/include/openssl/crypto/internal/err_int.h @@ -0,0 +1,19 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef INTERNAL_ERR_INT_H +# define INTERNAL_ERR_INT_H + +int err_load_crypto_strings_int(void); +void err_cleanup(void); +void err_delete_thread_state(void); +int err_shelve_state(void **); +void err_unshelve_state(void *); + +#endif diff --git a/include/openssl/crypto/internal/evp_int.h b/include/openssl/crypto/internal/evp_int.h new file mode 100644 index 0000000..2a40d7d --- /dev/null +++ b/include/openssl/crypto/internal/evp_int.h @@ -0,0 +1,442 @@ +/* + * Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include +#include "include/openssl/internal/refcount.h" + +/* + * Don't free up md_ctx->pctx in EVP_MD_CTX_reset, use the reserved flag + * values in evp.h + */ +#define EVP_MD_CTX_FLAG_KEEP_PKEY_CTX 0x0400 + +struct evp_pkey_ctx_st { + /* Method associated with this operation */ + const EVP_PKEY_METHOD *pmeth; + /* Engine that implements this method or NULL if builtin */ + ENGINE *engine; + /* Key: may be NULL */ + EVP_PKEY *pkey; + /* Peer key for key agreement, may be NULL */ + EVP_PKEY *peerkey; + /* Actual operation */ + int operation; + /* Algorithm specific data */ + void *data; + /* Application specific data */ + void *app_data; + /* Keygen callback */ + EVP_PKEY_gen_cb *pkey_gencb; + /* implementation specific keygen data */ + int *keygen_info; + int keygen_info_count; +} /* EVP_PKEY_CTX */ ; + +#define EVP_PKEY_FLAG_DYNAMIC 1 + +struct evp_pkey_method_st { + int pkey_id; + int flags; + int (*init) (EVP_PKEY_CTX *ctx); + int (*copy) (EVP_PKEY_CTX *dst, EVP_PKEY_CTX *src); + void (*cleanup) (EVP_PKEY_CTX *ctx); + int (*paramgen_init) (EVP_PKEY_CTX *ctx); + int (*paramgen) (EVP_PKEY_CTX *ctx, EVP_PKEY *pkey); + int (*keygen_init) (EVP_PKEY_CTX *ctx); + int (*keygen) (EVP_PKEY_CTX *ctx, EVP_PKEY *pkey); + int (*sign_init) (EVP_PKEY_CTX *ctx); + int (*sign) (EVP_PKEY_CTX *ctx, unsigned char *sig, size_t *siglen, + const unsigned char *tbs, size_t tbslen); + int (*verify_init) (EVP_PKEY_CTX *ctx); + int (*verify) (EVP_PKEY_CTX *ctx, + const unsigned char *sig, size_t siglen, + const unsigned char *tbs, size_t tbslen); + int (*verify_recover_init) (EVP_PKEY_CTX *ctx); + int (*verify_recover) (EVP_PKEY_CTX *ctx, + unsigned char *rout, size_t *routlen, + const unsigned char *sig, size_t siglen); + int (*signctx_init) (EVP_PKEY_CTX *ctx, EVP_MD_CTX *mctx); + int (*signctx) (EVP_PKEY_CTX *ctx, unsigned char *sig, size_t *siglen, + EVP_MD_CTX *mctx); + int (*verifyctx_init) (EVP_PKEY_CTX *ctx, EVP_MD_CTX *mctx); + int (*verifyctx) (EVP_PKEY_CTX *ctx, const unsigned char *sig, int siglen, + EVP_MD_CTX *mctx); + int (*encrypt_init) (EVP_PKEY_CTX *ctx); + int (*encrypt) (EVP_PKEY_CTX *ctx, unsigned char *out, size_t *outlen, + const unsigned char *in, size_t inlen); + int (*decrypt_init) (EVP_PKEY_CTX *ctx); + int (*decrypt) (EVP_PKEY_CTX *ctx, unsigned char *out, size_t *outlen, + const unsigned char *in, size_t inlen); + int (*derive_init) (EVP_PKEY_CTX *ctx); + int (*derive) (EVP_PKEY_CTX *ctx, unsigned char *key, size_t *keylen); + int (*ctrl) (EVP_PKEY_CTX *ctx, int type, int p1, void *p2); + int (*ctrl_str) (EVP_PKEY_CTX *ctx, const char *type, const char *value); + int (*digestsign) (EVP_MD_CTX *ctx, unsigned char *sig, size_t *siglen, + const unsigned char *tbs, size_t tbslen); + int (*digestverify) (EVP_MD_CTX *ctx, const unsigned char *sig, + size_t siglen, const unsigned char *tbs, + size_t tbslen); + int (*check) (EVP_PKEY *pkey); + int (*public_check) (EVP_PKEY *pkey); + int (*param_check) (EVP_PKEY *pkey); + + int (*digest_custom) (EVP_PKEY_CTX *ctx, EVP_MD_CTX *mctx); +} /* EVP_PKEY_METHOD */ ; + +DEFINE_STACK_OF_CONST(EVP_PKEY_METHOD) + +void evp_pkey_set_cb_translate(BN_GENCB *cb, EVP_PKEY_CTX *ctx); + +extern const EVP_PKEY_METHOD cmac_pkey_meth; +extern const EVP_PKEY_METHOD dh_pkey_meth; +extern const EVP_PKEY_METHOD dhx_pkey_meth; +extern const EVP_PKEY_METHOD dsa_pkey_meth; +extern const EVP_PKEY_METHOD ec_pkey_meth; +extern const EVP_PKEY_METHOD sm2_pkey_meth; +extern const EVP_PKEY_METHOD ecx25519_pkey_meth; +extern const EVP_PKEY_METHOD ecx448_pkey_meth; +extern const EVP_PKEY_METHOD ed25519_pkey_meth; +extern const EVP_PKEY_METHOD ed448_pkey_meth; +extern const EVP_PKEY_METHOD hmac_pkey_meth; +extern const EVP_PKEY_METHOD rsa_pkey_meth; +extern const EVP_PKEY_METHOD rsa_pss_pkey_meth; +extern const EVP_PKEY_METHOD scrypt_pkey_meth; +extern const EVP_PKEY_METHOD tls1_prf_pkey_meth; +extern const EVP_PKEY_METHOD hkdf_pkey_meth; +extern const EVP_PKEY_METHOD poly1305_pkey_meth; +extern const EVP_PKEY_METHOD siphash_pkey_meth; + +struct evp_md_st { + int type; + int pkey_type; + int md_size; + unsigned long flags; + int (*init) (EVP_MD_CTX *ctx); + int (*update) (EVP_MD_CTX *ctx, const void *data, size_t count); + int (*final) (EVP_MD_CTX *ctx, unsigned char *md); + int (*copy) (EVP_MD_CTX *to, const EVP_MD_CTX *from); + int (*cleanup) (EVP_MD_CTX *ctx); + int block_size; + int ctx_size; /* how big does the ctx->md_data need to be */ + /* control function */ + int (*md_ctrl) (EVP_MD_CTX *ctx, int cmd, int p1, void *p2); +} /* EVP_MD */ ; + +struct evp_cipher_st { + int nid; + int block_size; + /* Default value for variable length ciphers */ + int key_len; + int iv_len; + /* Various flags */ + unsigned long flags; + /* init key */ + int (*init) (EVP_CIPHER_CTX *ctx, const unsigned char *key, + const unsigned char *iv, int enc); + /* encrypt/decrypt data */ + int (*do_cipher) (EVP_CIPHER_CTX *ctx, unsigned char *out, + const unsigned char *in, size_t inl); + /* cleanup ctx */ + int (*cleanup) (EVP_CIPHER_CTX *); + /* how big ctx->cipher_data needs to be */ + int ctx_size; + /* Populate a ASN1_TYPE with parameters */ + int (*set_asn1_parameters) (EVP_CIPHER_CTX *, ASN1_TYPE *); + /* Get parameters from a ASN1_TYPE */ + int (*get_asn1_parameters) (EVP_CIPHER_CTX *, ASN1_TYPE *); + /* Miscellaneous operations */ + int (*ctrl) (EVP_CIPHER_CTX *, int type, int arg, void *ptr); + /* Application data */ + void *app_data; +} /* EVP_CIPHER */ ; + +/* Macros to code block cipher wrappers */ + +/* Wrapper functions for each cipher mode */ + +#define EVP_C_DATA(kstruct, ctx) \ + ((kstruct *)EVP_CIPHER_CTX_get_cipher_data(ctx)) + +#define BLOCK_CIPHER_ecb_loop() \ + size_t i, bl; \ + bl = EVP_CIPHER_CTX_cipher(ctx)->block_size; \ + if (inl < bl) return 1;\ + inl -= bl; \ + for (i=0; i <= inl; i+=bl) + +#define BLOCK_CIPHER_func_ecb(cname, cprefix, kstruct, ksched) \ +static int cname##_ecb_cipher(EVP_CIPHER_CTX *ctx, unsigned char *out, const unsigned char *in, size_t inl) \ +{\ + BLOCK_CIPHER_ecb_loop() \ + cprefix##_ecb_encrypt(in + i, out + i, &EVP_C_DATA(kstruct,ctx)->ksched, EVP_CIPHER_CTX_encrypting(ctx)); \ + return 1;\ +} + +#define EVP_MAXCHUNK ((size_t)1<<(sizeof(long)*8-2)) + +#define BLOCK_CIPHER_func_ofb(cname, cprefix, cbits, kstruct, ksched) \ + static int cname##_ofb_cipher(EVP_CIPHER_CTX *ctx, unsigned char *out, const unsigned char *in, size_t inl) \ +{\ + while(inl>=EVP_MAXCHUNK) {\ + int num = EVP_CIPHER_CTX_num(ctx);\ + cprefix##_ofb##cbits##_encrypt(in, out, (long)EVP_MAXCHUNK, &EVP_C_DATA(kstruct,ctx)->ksched, EVP_CIPHER_CTX_iv_noconst(ctx), &num); \ + EVP_CIPHER_CTX_set_num(ctx, num);\ + inl-=EVP_MAXCHUNK;\ + in +=EVP_MAXCHUNK;\ + out+=EVP_MAXCHUNK;\ + }\ + if (inl) {\ + int num = EVP_CIPHER_CTX_num(ctx);\ + cprefix##_ofb##cbits##_encrypt(in, out, (long)inl, &EVP_C_DATA(kstruct,ctx)->ksched, EVP_CIPHER_CTX_iv_noconst(ctx), &num); \ + EVP_CIPHER_CTX_set_num(ctx, num);\ + }\ + return 1;\ +} + +#define BLOCK_CIPHER_func_cbc(cname, cprefix, kstruct, ksched) \ +static int cname##_cbc_cipher(EVP_CIPHER_CTX *ctx, unsigned char *out, const unsigned char *in, size_t inl) \ +{\ + while(inl>=EVP_MAXCHUNK) \ + {\ + cprefix##_cbc_encrypt(in, out, (long)EVP_MAXCHUNK, &EVP_C_DATA(kstruct,ctx)->ksched, EVP_CIPHER_CTX_iv_noconst(ctx), EVP_CIPHER_CTX_encrypting(ctx));\ + inl-=EVP_MAXCHUNK;\ + in +=EVP_MAXCHUNK;\ + out+=EVP_MAXCHUNK;\ + }\ + if (inl)\ + cprefix##_cbc_encrypt(in, out, (long)inl, &EVP_C_DATA(kstruct,ctx)->ksched, EVP_CIPHER_CTX_iv_noconst(ctx), EVP_CIPHER_CTX_encrypting(ctx));\ + return 1;\ +} + +#define BLOCK_CIPHER_func_cfb(cname, cprefix, cbits, kstruct, ksched) \ +static int cname##_cfb##cbits##_cipher(EVP_CIPHER_CTX *ctx, unsigned char *out, const unsigned char *in, size_t inl) \ +{\ + size_t chunk = EVP_MAXCHUNK;\ + if (cbits == 1) chunk >>= 3;\ + if (inl < chunk) chunk = inl;\ + while (inl && inl >= chunk)\ + {\ + int num = EVP_CIPHER_CTX_num(ctx);\ + cprefix##_cfb##cbits##_encrypt(in, out, (long) \ + ((cbits == 1) \ + && !EVP_CIPHER_CTX_test_flags(ctx, EVP_CIPH_FLAG_LENGTH_BITS) \ + ? chunk*8 : chunk), \ + &EVP_C_DATA(kstruct, ctx)->ksched, EVP_CIPHER_CTX_iv_noconst(ctx),\ + &num, EVP_CIPHER_CTX_encrypting(ctx));\ + EVP_CIPHER_CTX_set_num(ctx, num);\ + inl -= chunk;\ + in += chunk;\ + out += chunk;\ + if (inl < chunk) chunk = inl;\ + }\ + return 1;\ +} + +#define BLOCK_CIPHER_all_funcs(cname, cprefix, cbits, kstruct, ksched) \ + BLOCK_CIPHER_func_cbc(cname, cprefix, kstruct, ksched) \ + BLOCK_CIPHER_func_cfb(cname, cprefix, cbits, kstruct, ksched) \ + BLOCK_CIPHER_func_ecb(cname, cprefix, kstruct, ksched) \ + BLOCK_CIPHER_func_ofb(cname, cprefix, cbits, kstruct, ksched) + +#define BLOCK_CIPHER_def1(cname, nmode, mode, MODE, kstruct, nid, block_size, \ + key_len, iv_len, flags, init_key, cleanup, \ + set_asn1, get_asn1, ctrl) \ +static const EVP_CIPHER cname##_##mode = { \ + nid##_##nmode, block_size, key_len, iv_len, \ + flags | EVP_CIPH_##MODE##_MODE, \ + init_key, \ + cname##_##mode##_cipher, \ + cleanup, \ + sizeof(kstruct), \ + set_asn1, get_asn1,\ + ctrl, \ + NULL \ +}; \ +const EVP_CIPHER *EVP_##cname##_##mode(void) { return &cname##_##mode; } + +#define BLOCK_CIPHER_def_cbc(cname, kstruct, nid, block_size, key_len, \ + iv_len, flags, init_key, cleanup, set_asn1, \ + get_asn1, ctrl) \ +BLOCK_CIPHER_def1(cname, cbc, cbc, CBC, kstruct, nid, block_size, key_len, \ + iv_len, flags, init_key, cleanup, set_asn1, get_asn1, ctrl) + +#define BLOCK_CIPHER_def_cfb(cname, kstruct, nid, key_len, \ + iv_len, cbits, flags, init_key, cleanup, \ + set_asn1, get_asn1, ctrl) \ +BLOCK_CIPHER_def1(cname, cfb##cbits, cfb##cbits, CFB, kstruct, nid, 1, \ + key_len, iv_len, flags, init_key, cleanup, set_asn1, \ + get_asn1, ctrl) + +#define BLOCK_CIPHER_def_ofb(cname, kstruct, nid, key_len, \ + iv_len, cbits, flags, init_key, cleanup, \ + set_asn1, get_asn1, ctrl) \ +BLOCK_CIPHER_def1(cname, ofb##cbits, ofb, OFB, kstruct, nid, 1, \ + key_len, iv_len, flags, init_key, cleanup, set_asn1, \ + get_asn1, ctrl) + +#define BLOCK_CIPHER_def_ecb(cname, kstruct, nid, block_size, key_len, \ + flags, init_key, cleanup, set_asn1, \ + get_asn1, ctrl) \ +BLOCK_CIPHER_def1(cname, ecb, ecb, ECB, kstruct, nid, block_size, key_len, \ + 0, flags, init_key, cleanup, set_asn1, get_asn1, ctrl) + +#define BLOCK_CIPHER_defs(cname, kstruct, \ + nid, block_size, key_len, iv_len, cbits, flags, \ + init_key, cleanup, set_asn1, get_asn1, ctrl) \ +BLOCK_CIPHER_def_cbc(cname, kstruct, nid, block_size, key_len, iv_len, flags, \ + init_key, cleanup, set_asn1, get_asn1, ctrl) \ +BLOCK_CIPHER_def_cfb(cname, kstruct, nid, key_len, iv_len, cbits, \ + flags, init_key, cleanup, set_asn1, get_asn1, ctrl) \ +BLOCK_CIPHER_def_ofb(cname, kstruct, nid, key_len, iv_len, cbits, \ + flags, init_key, cleanup, set_asn1, get_asn1, ctrl) \ +BLOCK_CIPHER_def_ecb(cname, kstruct, nid, block_size, key_len, flags, \ + init_key, cleanup, set_asn1, get_asn1, ctrl) + +/*- +#define BLOCK_CIPHER_defs(cname, kstruct, \ + nid, block_size, key_len, iv_len, flags,\ + init_key, cleanup, set_asn1, get_asn1, ctrl)\ +static const EVP_CIPHER cname##_cbc = {\ + nid##_cbc, block_size, key_len, iv_len, \ + flags | EVP_CIPH_CBC_MODE,\ + init_key,\ + cname##_cbc_cipher,\ + cleanup,\ + sizeof(EVP_CIPHER_CTX)-sizeof((((EVP_CIPHER_CTX *)NULL)->c))+\ + sizeof((((EVP_CIPHER_CTX *)NULL)->c.kstruct)),\ + set_asn1, get_asn1,\ + ctrl, \ + NULL \ +};\ +const EVP_CIPHER *EVP_##cname##_cbc(void) { return &cname##_cbc; }\ +static const EVP_CIPHER cname##_cfb = {\ + nid##_cfb64, 1, key_len, iv_len, \ + flags | EVP_CIPH_CFB_MODE,\ + init_key,\ + cname##_cfb_cipher,\ + cleanup,\ + sizeof(EVP_CIPHER_CTX)-sizeof((((EVP_CIPHER_CTX *)NULL)->c))+\ + sizeof((((EVP_CIPHER_CTX *)NULL)->c.kstruct)),\ + set_asn1, get_asn1,\ + ctrl,\ + NULL \ +};\ +const EVP_CIPHER *EVP_##cname##_cfb(void) { return &cname##_cfb; }\ +static const EVP_CIPHER cname##_ofb = {\ + nid##_ofb64, 1, key_len, iv_len, \ + flags | EVP_CIPH_OFB_MODE,\ + init_key,\ + cname##_ofb_cipher,\ + cleanup,\ + sizeof(EVP_CIPHER_CTX)-sizeof((((EVP_CIPHER_CTX *)NULL)->c))+\ + sizeof((((EVP_CIPHER_CTX *)NULL)->c.kstruct)),\ + set_asn1, get_asn1,\ + ctrl,\ + NULL \ +};\ +const EVP_CIPHER *EVP_##cname##_ofb(void) { return &cname##_ofb; }\ +static const EVP_CIPHER cname##_ecb = {\ + nid##_ecb, block_size, key_len, iv_len, \ + flags | EVP_CIPH_ECB_MODE,\ + init_key,\ + cname##_ecb_cipher,\ + cleanup,\ + sizeof(EVP_CIPHER_CTX)-sizeof((((EVP_CIPHER_CTX *)NULL)->c))+\ + sizeof((((EVP_CIPHER_CTX *)NULL)->c.kstruct)),\ + set_asn1, get_asn1,\ + ctrl,\ + NULL \ +};\ +const EVP_CIPHER *EVP_##cname##_ecb(void) { return &cname##_ecb; } +*/ + +#define IMPLEMENT_BLOCK_CIPHER(cname, ksched, cprefix, kstruct, nid, \ + block_size, key_len, iv_len, cbits, \ + flags, init_key, \ + cleanup, set_asn1, get_asn1, ctrl) \ + BLOCK_CIPHER_all_funcs(cname, cprefix, cbits, kstruct, ksched) \ + BLOCK_CIPHER_defs(cname, kstruct, nid, block_size, key_len, iv_len, \ + cbits, flags, init_key, cleanup, set_asn1, \ + get_asn1, ctrl) + +#define IMPLEMENT_CFBR(cipher,cprefix,kstruct,ksched,keysize,cbits,iv_len,fl) \ + BLOCK_CIPHER_func_cfb(cipher##_##keysize,cprefix,cbits,kstruct,ksched) \ + BLOCK_CIPHER_def_cfb(cipher##_##keysize,kstruct, \ + NID_##cipher##_##keysize, keysize/8, iv_len, cbits, \ + (fl)|EVP_CIPH_FLAG_DEFAULT_ASN1, \ + cipher##_init_key, NULL, NULL, NULL, NULL) + + +# ifndef OPENSSL_NO_EC + +#define X25519_KEYLEN 32 +#define X448_KEYLEN 56 +#define ED448_KEYLEN 57 + +#define MAX_KEYLEN ED448_KEYLEN + +typedef struct { + unsigned char pubkey[MAX_KEYLEN]; + unsigned char *privkey; +} ECX_KEY; + +#endif + +/* + * Type needs to be a bit field Sub-type needs to be for variations on the + * method, as in, can it do arbitrary encryption.... + */ +struct evp_pkey_st { + int type; + int save_type; + CRYPTO_REF_COUNT references; + const EVP_PKEY_ASN1_METHOD *ameth; + ENGINE *engine; + ENGINE *pmeth_engine; /* If not NULL public key ENGINE to use */ + union { + void *ptr; +# ifndef OPENSSL_NO_RSA + struct rsa_st *rsa; /* RSA */ +# endif +# ifndef OPENSSL_NO_DSA + struct dsa_st *dsa; /* DSA */ +# endif +# ifndef OPENSSL_NO_DH + struct dh_st *dh; /* DH */ +# endif +# ifndef OPENSSL_NO_EC + struct ec_key_st *ec; /* ECC */ + ECX_KEY *ecx; /* X25519, X448, Ed25519, Ed448 */ +# endif + } pkey; + int save_parameters; + STACK_OF(X509_ATTRIBUTE) *attributes; /* [ 0 ] */ + CRYPTO_RWLOCK *lock; +} /* EVP_PKEY */ ; + + +void openssl_add_all_ciphers_int(void); +void openssl_add_all_digests_int(void); +void evp_cleanup_int(void); +void evp_app_cleanup_int(void); + +/* Pulling defines out of C source files */ + +#define EVP_RC4_KEY_SIZE 16 +#ifndef TLS1_1_VERSION +# define TLS1_1_VERSION 0x0302 +#endif + +void evp_encode_ctx_set_flags(EVP_ENCODE_CTX *ctx, unsigned int flags); + +/* EVP_ENCODE_CTX flags */ +/* Don't generate new lines when encoding */ +#define EVP_ENCODE_CTX_NO_NEWLINES 1 +/* Use the SRP base64 alphabet instead of the standard one */ +#define EVP_ENCODE_CTX_USE_SRP_ALPHABET 2 diff --git a/include/openssl/crypto/internal/lhash.h b/include/openssl/crypto/internal/lhash.h new file mode 100644 index 0000000..200ba86 --- /dev/null +++ b/include/openssl/crypto/internal/lhash.h @@ -0,0 +1,15 @@ +/* + * Copyright 2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef INTERNAL_LHASH_H +# define INTERNAL_LHASH_H + +unsigned long openssl_lh_strcasehash(const char *); + +#endif diff --git a/include/openssl/crypto/internal/md32_common.h b/include/openssl/crypto/internal/md32_common.h new file mode 100644 index 0000000..3f00b23 --- /dev/null +++ b/include/openssl/crypto/internal/md32_common.h @@ -0,0 +1,259 @@ +/* + * Copyright 1999-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include +#include + +/*- + * This is a generic 32 bit "collector" for message digest algorithms. + * Whenever needed it collects input character stream into chunks of + * 32 bit values and invokes a block function that performs actual hash + * calculations. + * + * Porting guide. + * + * Obligatory macros: + * + * DATA_ORDER_IS_BIG_ENDIAN or DATA_ORDER_IS_LITTLE_ENDIAN + * this macro defines byte order of input stream. + * HASH_CBLOCK + * size of a unit chunk HASH_BLOCK operates on. + * HASH_LONG + * has to be at least 32 bit wide. + * HASH_CTX + * context structure that at least contains following + * members: + * typedef struct { + * ... + * HASH_LONG Nl,Nh; + * either { + * HASH_LONG data[HASH_LBLOCK]; + * unsigned char data[HASH_CBLOCK]; + * }; + * unsigned int num; + * ... + * } HASH_CTX; + * data[] vector is expected to be zeroed upon first call to + * HASH_UPDATE. + * HASH_UPDATE + * name of "Update" function, implemented here. + * HASH_TRANSFORM + * name of "Transform" function, implemented here. + * HASH_FINAL + * name of "Final" function, implemented here. + * HASH_BLOCK_DATA_ORDER + * name of "block" function capable of treating *unaligned* input + * message in original (data) byte order, implemented externally. + * HASH_MAKE_STRING + * macro converting context variables to an ASCII hash string. + * + * MD5 example: + * + * #define DATA_ORDER_IS_LITTLE_ENDIAN + * + * #define HASH_LONG MD5_LONG + * #define HASH_CTX MD5_CTX + * #define HASH_CBLOCK MD5_CBLOCK + * #define HASH_UPDATE MD5_Update + * #define HASH_TRANSFORM MD5_Transform + * #define HASH_FINAL MD5_Final + * #define HASH_BLOCK_DATA_ORDER md5_block_data_order + */ + +#include + +#if !defined(DATA_ORDER_IS_BIG_ENDIAN) && !defined(DATA_ORDER_IS_LITTLE_ENDIAN) +# error "DATA_ORDER must be defined!" +#endif + +#ifndef HASH_CBLOCK +# error "HASH_CBLOCK must be defined!" +#endif +#ifndef HASH_LONG +# error "HASH_LONG must be defined!" +#endif +#ifndef HASH_CTX +# error "HASH_CTX must be defined!" +#endif + +#ifndef HASH_UPDATE +# error "HASH_UPDATE must be defined!" +#endif +#ifndef HASH_TRANSFORM +# error "HASH_TRANSFORM must be defined!" +#endif +#ifndef HASH_FINAL +# error "HASH_FINAL must be defined!" +#endif + +#ifndef HASH_BLOCK_DATA_ORDER +# error "HASH_BLOCK_DATA_ORDER must be defined!" +#endif + +#define ROTATE(a,n) (((a)<<(n))|(((a)&0xffffffff)>>(32-(n)))) + +#if defined(DATA_ORDER_IS_BIG_ENDIAN) + +# define HOST_c2l(c,l) (l =(((unsigned long)(*((c)++)))<<24), \ + l|=(((unsigned long)(*((c)++)))<<16), \ + l|=(((unsigned long)(*((c)++)))<< 8), \ + l|=(((unsigned long)(*((c)++))) ) ) +# define HOST_l2c(l,c) (*((c)++)=(unsigned char)(((l)>>24)&0xff), \ + *((c)++)=(unsigned char)(((l)>>16)&0xff), \ + *((c)++)=(unsigned char)(((l)>> 8)&0xff), \ + *((c)++)=(unsigned char)(((l) )&0xff), \ + l) + +#elif defined(DATA_ORDER_IS_LITTLE_ENDIAN) + +# define HOST_c2l(c,l) (l =(((unsigned long)(*((c)++))) ), \ + l|=(((unsigned long)(*((c)++)))<< 8), \ + l|=(((unsigned long)(*((c)++)))<<16), \ + l|=(((unsigned long)(*((c)++)))<<24) ) +# define HOST_l2c(l,c) (*((c)++)=(unsigned char)(((l) )&0xff), \ + *((c)++)=(unsigned char)(((l)>> 8)&0xff), \ + *((c)++)=(unsigned char)(((l)>>16)&0xff), \ + *((c)++)=(unsigned char)(((l)>>24)&0xff), \ + l) + +#endif + +/* + * Time for some action :-) + */ + +int HASH_UPDATE(HASH_CTX *c, const void *data_, size_t len) +{ + const unsigned char *data = data_; + unsigned char *p; + HASH_LONG l; + size_t n; + + if (len == 0) + return 1; + + l = (c->Nl + (((HASH_LONG) len) << 3)) & 0xffffffffUL; + if (l < c->Nl) /* overflow */ + c->Nh++; + c->Nh += (HASH_LONG) (len >> 29); /* might cause compiler warning on + * 16-bit */ + c->Nl = l; + + n = c->num; + if (n != 0) { + p = (unsigned char *)c->data; + + if (len >= HASH_CBLOCK || len + n >= HASH_CBLOCK) { + memcpy(p + n, data, HASH_CBLOCK - n); + HASH_BLOCK_DATA_ORDER(c, p, 1); + n = HASH_CBLOCK - n; + data += n; + len -= n; + c->num = 0; + /* + * We use memset rather than OPENSSL_cleanse() here deliberately. + * Using OPENSSL_cleanse() here could be a performance issue. It + * will get properly cleansed on finalisation so this isn't a + * security problem. + */ + memset(p, 0, HASH_CBLOCK); /* keep it zeroed */ + } else { + memcpy(p + n, data, len); + c->num += (unsigned int)len; + return 1; + } + } + + n = len / HASH_CBLOCK; + if (n > 0) { + HASH_BLOCK_DATA_ORDER(c, data, n); + n *= HASH_CBLOCK; + data += n; + len -= n; + } + + if (len != 0) { + p = (unsigned char *)c->data; + c->num = (unsigned int)len; + memcpy(p, data, len); + } + return 1; +} + +void HASH_TRANSFORM(HASH_CTX *c, const unsigned char *data) +{ + HASH_BLOCK_DATA_ORDER(c, data, 1); +} + +int HASH_FINAL(unsigned char *md, HASH_CTX *c) +{ + unsigned char *p = (unsigned char *)c->data; + size_t n = c->num; + + p[n] = 0x80; /* there is always room for one */ + n++; + + if (n > (HASH_CBLOCK - 8)) { + memset(p + n, 0, HASH_CBLOCK - n); + n = 0; + HASH_BLOCK_DATA_ORDER(c, p, 1); + } + memset(p + n, 0, HASH_CBLOCK - 8 - n); + + p += HASH_CBLOCK - 8; +#if defined(DATA_ORDER_IS_BIG_ENDIAN) + (void)HOST_l2c(c->Nh, p); + (void)HOST_l2c(c->Nl, p); +#elif defined(DATA_ORDER_IS_LITTLE_ENDIAN) + (void)HOST_l2c(c->Nl, p); + (void)HOST_l2c(c->Nh, p); +#endif + p -= HASH_CBLOCK; + HASH_BLOCK_DATA_ORDER(c, p, 1); + c->num = 0; + OPENSSL_cleanse(p, HASH_CBLOCK); + +#ifndef HASH_MAKE_STRING +# error "HASH_MAKE_STRING must be defined!" +#else + HASH_MAKE_STRING(c, md); +#endif + + return 1; +} + +#ifndef MD32_REG_T +# if defined(__alpha) || defined(__sparcv9) || defined(__mips) +# define MD32_REG_T long +/* + * This comment was originally written for MD5, which is why it + * discusses A-D. But it basically applies to all 32-bit digests, + * which is why it was moved to common header file. + * + * In case you wonder why A-D are declared as long and not + * as MD5_LONG. Doing so results in slight performance + * boost on LP64 architectures. The catch is we don't + * really care if 32 MSBs of a 64-bit register get polluted + * with eventual overflows as we *save* only 32 LSBs in + * *either* case. Now declaring 'em long excuses the compiler + * from keeping 32 MSBs zeroed resulting in 13% performance + * improvement under SPARC Solaris7/64 and 5% under AlphaLinux. + * Well, to be honest it should say that this *prevents* + * performance degradation. + */ +# else +/* + * Above is not absolute and there are LP64 compilers that + * generate better code if MD32_REG_T is defined int. The above + * pre-processor condition reflects the circumstances under which + * the conclusion was made and is subject to further extension. + */ +# define MD32_REG_T int +# endif +#endif diff --git a/include/openssl/crypto/internal/objects.h b/include/openssl/crypto/internal/objects.h new file mode 100644 index 0000000..686ba13 --- /dev/null +++ b/include/openssl/crypto/internal/objects.h @@ -0,0 +1,12 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +void obj_cleanup_int(void); diff --git a/include/openssl/crypto/internal/poly1305.h b/include/openssl/crypto/internal/poly1305.h new file mode 100644 index 0000000..5fef239 --- /dev/null +++ b/include/openssl/crypto/internal/poly1305.h @@ -0,0 +1,21 @@ +/* + * Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +#define POLY1305_BLOCK_SIZE 16 +#define POLY1305_DIGEST_SIZE 16 +#define POLY1305_KEY_SIZE 32 + +typedef struct poly1305_context POLY1305; + +size_t Poly1305_ctx_size(void); +void Poly1305_Init(POLY1305 *ctx, const unsigned char key[32]); +void Poly1305_Update(POLY1305 *ctx, const unsigned char *inp, size_t len); +void Poly1305_Final(POLY1305 *ctx, unsigned char mac[16]); diff --git a/include/openssl/crypto/internal/rand_int.h b/include/openssl/crypto/internal/rand_int.h new file mode 100644 index 0000000..e025ec9 --- /dev/null +++ b/include/openssl/crypto/internal/rand_int.h @@ -0,0 +1,131 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * Licensed under the OpenSSL licenses, (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * https://www.openssl.org/source/license.html + * or in the file LICENSE in the source distribution. + */ + +#ifndef HEADER_RAND_INT_H +# define HEADER_RAND_INT_H + +# include + +/* forward declaration */ +typedef struct rand_pool_st RAND_POOL; + +void rand_cleanup_int(void); +void rand_drbg_cleanup_int(void); +void drbg_delete_thread_state(void); +void rand_fork(void); + +/* Hardware-based seeding functions. */ +size_t rand_acquire_entropy_from_tsc(RAND_POOL *pool); +size_t rand_acquire_entropy_from_cpu(RAND_POOL *pool); + +/* DRBG entropy callbacks. */ +size_t rand_drbg_get_entropy(RAND_DRBG *drbg, + unsigned char **pout, + int entropy, size_t min_len, size_t max_len, + int prediction_resistance); +void rand_drbg_cleanup_entropy(RAND_DRBG *drbg, + unsigned char *out, size_t outlen); +size_t rand_drbg_get_nonce(RAND_DRBG *drbg, + unsigned char **pout, + int entropy, size_t min_len, size_t max_len); +void rand_drbg_cleanup_nonce(RAND_DRBG *drbg, + unsigned char *out, size_t outlen); + +size_t rand_drbg_get_additional_data(unsigned char **pout, size_t max_len); + +void rand_drbg_cleanup_additional_data(unsigned char *out, size_t outlen); + +/* + * RAND_POOL functions + */ +RAND_POOL *rand_pool_new(int entropy_requested, size_t min_len, size_t max_len); +void rand_pool_free(RAND_POOL *pool); + +const unsigned char *rand_pool_buffer(RAND_POOL *pool); +unsigned char *rand_pool_detach(RAND_POOL *pool); + +size_t rand_pool_entropy(RAND_POOL *pool); +size_t rand_pool_length(RAND_POOL *pool); + +size_t rand_pool_entropy_available(RAND_POOL *pool); +size_t rand_pool_entropy_needed(RAND_POOL *pool); +/* |entropy_factor| expresses how many bits of data contain 1 bit of entropy */ +size_t rand_pool_bytes_needed(RAND_POOL *pool, unsigned int entropy_factor); +size_t rand_pool_bytes_remaining(RAND_POOL *pool); + +int rand_pool_add(RAND_POOL *pool, + const unsigned char *buffer, size_t len, size_t entropy); +unsigned char *rand_pool_add_begin(RAND_POOL *pool, size_t len); +int rand_pool_add_end(RAND_POOL *pool, size_t len, size_t entropy); + + +/* + * Add random bytes to the pool to acquire requested amount of entropy + * + * This function is platform specific and tries to acquire the requested + * amount of entropy by polling platform specific entropy sources. + * + * If the function succeeds in acquiring at least |entropy_requested| bits + * of entropy, the total entropy count is returned. If it fails, it returns + * an entropy count of 0. + */ +size_t rand_pool_acquire_entropy(RAND_POOL *pool); + +/* + * Add some application specific nonce data + * + * This function is platform specific and adds some application specific + * data to the nonce used for instantiating the drbg. + * + * This data currently consists of the process and thread id, and a high + * resolution timestamp. The data does not include an atomic counter, + * because that is added by the calling function rand_drbg_get_nonce(). + * + * Returns 1 on success and 0 on failure. + */ +int rand_pool_add_nonce_data(RAND_POOL *pool); + + +/* + * Add some platform specific additional data + * + * This function is platform specific and adds some random noise to the + * additional data used for generating random bytes and for reseeding + * the drbg. + * + * Returns 1 on success and 0 on failure. + */ +int rand_pool_add_additional_data(RAND_POOL *pool); + +/* + * Initialise the random pool reseeding sources. + * + * Returns 1 on success and 0 on failure. + */ +int rand_pool_init(void); + +/* + * Finalise the random pool reseeding sources. + */ +void rand_pool_cleanup(void); + +/* + * Control the random pool use of open file descriptors. + */ +void rand_pool_keep_random_devices_open(int keep); + +#endif diff --git a/include/openssl/crypto/internal/sha.h b/include/openssl/crypto/internal/sha.h new file mode 100644 index 0000000..6d4af2b --- /dev/null +++ b/include/openssl/crypto/internal/sha.h @@ -0,0 +1,21 @@ +/* + * Copyright 2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include "include/openssl/sha.h" + +#ifndef HEADER_INTERNAL_SHA_H +# define HEADER_INTERNAL_SHA_H + +# include + +int sha512_224_init(SHA512_CTX *); +int sha512_256_init(SHA512_CTX *); + +#endif diff --git a/include/openssl/crypto/internal/siphash.h b/include/openssl/crypto/internal/siphash.h new file mode 100644 index 0000000..9573680 --- /dev/null +++ b/include/openssl/crypto/internal/siphash.h @@ -0,0 +1,25 @@ +/* + * Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +#define SIPHASH_BLOCK_SIZE 8 +#define SIPHASH_KEY_SIZE 16 +#define SIPHASH_MIN_DIGEST_SIZE 8 +#define SIPHASH_MAX_DIGEST_SIZE 16 + +typedef struct siphash_st SIPHASH; + +size_t SipHash_ctx_size(void); +size_t SipHash_hash_size(SIPHASH *ctx); +int SipHash_set_hash_size(SIPHASH *ctx, size_t hash_size); +int SipHash_Init(SIPHASH *ctx, const unsigned char *k, + int crounds, int drounds); +void SipHash_Update(SIPHASH *ctx, const unsigned char *in, size_t inlen); +int SipHash_Final(SIPHASH *ctx, unsigned char *out, size_t outlen); diff --git a/include/openssl/crypto/internal/sm2.h b/include/openssl/crypto/internal/sm2.h new file mode 100644 index 0000000..fc64c76 --- /dev/null +++ b/include/openssl/crypto/internal/sm2.h @@ -0,0 +1,78 @@ +/* + * Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright 2017 Ribose Inc. All Rights Reserved. + * Ported from Ribose contributions from Botan. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SM2_H +# define HEADER_SM2_H +# include + +# ifndef OPENSSL_NO_SM2 + +# include + +/* The default user id as specified in GM/T 0009-2012 */ +# define SM2_DEFAULT_USERID "1234567812345678" + +int sm2_compute_z_digest(uint8_t *out, + const EVP_MD *digest, + const uint8_t *id, + const size_t id_len, + const EC_KEY *key); + +/* + * SM2 signature operation. Computes Z and then signs H(Z || msg) using SM2 + */ +ECDSA_SIG *sm2_do_sign(const EC_KEY *key, + const EVP_MD *digest, + const uint8_t *id, + const size_t id_len, + const uint8_t *msg, size_t msg_len); + +int sm2_do_verify(const EC_KEY *key, + const EVP_MD *digest, + const ECDSA_SIG *signature, + const uint8_t *id, + const size_t id_len, + const uint8_t *msg, size_t msg_len); + +/* + * SM2 signature generation. + */ +int sm2_sign(const unsigned char *dgst, int dgstlen, + unsigned char *sig, unsigned int *siglen, EC_KEY *eckey); + +/* + * SM2 signature verification. + */ +int sm2_verify(const unsigned char *dgst, int dgstlen, + const unsigned char *sig, int siglen, EC_KEY *eckey); + +/* + * SM2 encryption + */ +int sm2_ciphertext_size(const EC_KEY *key, const EVP_MD *digest, size_t msg_len, + size_t *ct_size); + +int sm2_plaintext_size(const EC_KEY *key, const EVP_MD *digest, size_t msg_len, + size_t *pt_size); + +int sm2_encrypt(const EC_KEY *key, + const EVP_MD *digest, + const uint8_t *msg, + size_t msg_len, + uint8_t *ciphertext_buf, size_t *ciphertext_len); + +int sm2_decrypt(const EC_KEY *key, + const EVP_MD *digest, + const uint8_t *ciphertext, + size_t ciphertext_len, uint8_t *ptext_buf, size_t *ptext_len); + +# endif /* OPENSSL_NO_SM2 */ +#endif diff --git a/include/openssl/crypto/internal/sm2err.h b/include/openssl/crypto/internal/sm2err.h new file mode 100644 index 0000000..d5e8f75 --- /dev/null +++ b/include/openssl/crypto/internal/sm2err.h @@ -0,0 +1,61 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SM2ERR_H +# define HEADER_SM2ERR_H + +# include + +# ifndef OPENSSL_NO_SM2 + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_SM2_strings(void); + +/* + * SM2 function codes. + */ +# define SM2_F_PKEY_SM2_COPY 115 +# define SM2_F_PKEY_SM2_CTRL 109 +# define SM2_F_PKEY_SM2_CTRL_STR 110 +# define SM2_F_PKEY_SM2_DIGEST_CUSTOM 114 +# define SM2_F_PKEY_SM2_INIT 111 +# define SM2_F_PKEY_SM2_SIGN 112 +# define SM2_F_SM2_COMPUTE_MSG_HASH 100 +# define SM2_F_SM2_COMPUTE_USERID_DIGEST 101 +# define SM2_F_SM2_COMPUTE_Z_DIGEST 113 +# define SM2_F_SM2_DECRYPT 102 +# define SM2_F_SM2_ENCRYPT 103 +# define SM2_F_SM2_PLAINTEXT_SIZE 104 +# define SM2_F_SM2_SIGN 105 +# define SM2_F_SM2_SIG_GEN 106 +# define SM2_F_SM2_SIG_VERIFY 107 +# define SM2_F_SM2_VERIFY 108 + +/* + * SM2 reason codes. + */ +# define SM2_R_ASN1_ERROR 100 +# define SM2_R_BAD_SIGNATURE 101 +# define SM2_R_BUFFER_TOO_SMALL 107 +# define SM2_R_DIST_ID_TOO_LARGE 110 +# define SM2_R_ID_NOT_SET 112 +# define SM2_R_ID_TOO_LARGE 111 +# define SM2_R_INVALID_CURVE 108 +# define SM2_R_INVALID_DIGEST 102 +# define SM2_R_INVALID_DIGEST_TYPE 103 +# define SM2_R_INVALID_ENCODING 104 +# define SM2_R_INVALID_FIELD 105 +# define SM2_R_NO_PARAMETERS_SET 109 +# define SM2_R_USER_ID_TOO_LARGE 106 + +# endif +#endif diff --git a/include/openssl/crypto/internal/sm3.h b/include/openssl/crypto/internal/sm3.h new file mode 100644 index 0000000..d7a3aee --- /dev/null +++ b/include/openssl/crypto/internal/sm3.h @@ -0,0 +1,39 @@ +/* + * Copyright 2017 The OpenSSL Project Authors. All Rights Reserved. + * Copyright 2017 Ribose Inc. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SM3_H +# define HEADER_SM3_H + +# include +# include +# ifdef OPENSSL_NO_SM3 +# error SM3 is disabled. +# endif + +# define SM3_DIGEST_LENGTH 32 +# define SM3_WORD unsigned int + +# define SM3_CBLOCK 64 +# define SM3_LBLOCK (SM3_CBLOCK/4) + +typedef struct SM3state_st { + SM3_WORD A, B, C, D, E, F, G, H; + SM3_WORD Nl, Nh; + SM3_WORD data[SM3_LBLOCK]; + unsigned int num; +} SM3_CTX; + +int sm3_init(SM3_CTX *c); +int sm3_update(SM3_CTX *c, const void *data, size_t len); +int sm3_final(unsigned char *md, SM3_CTX *c); + +void sm3_block_data_order(SM3_CTX *c, const void *p, size_t num); + +#endif diff --git a/include/openssl/crypto/internal/sm4.h b/include/openssl/crypto/internal/sm4.h new file mode 100644 index 0000000..24d6155 --- /dev/null +++ b/include/openssl/crypto/internal/sm4.h @@ -0,0 +1,37 @@ +/* + * Copyright 2017 The OpenSSL Project Authors. All Rights Reserved. + * Copyright 2017 Ribose Inc. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SM4_H +# define HEADER_SM4_H + +# include +# include + +# ifdef OPENSSL_NO_SM4 +# error SM4 is disabled. +# endif + +# define SM4_ENCRYPT 1 +# define SM4_DECRYPT 0 + +# define SM4_BLOCK_SIZE 16 +# define SM4_KEY_SCHEDULE 32 + +typedef struct SM4_KEY_st { + uint32_t rk[SM4_KEY_SCHEDULE]; +} SM4_KEY; + +int SM4_set_key(const uint8_t *key, SM4_KEY *ks); + +void SM4_encrypt(const uint8_t *in, uint8_t *out, const SM4_KEY *ks); + +void SM4_decrypt(const uint8_t *in, uint8_t *out, const SM4_KEY *ks); + +#endif diff --git a/include/openssl/crypto/internal/store.h b/include/openssl/crypto/internal/store.h new file mode 100644 index 0000000..f5013dc --- /dev/null +++ b/include/openssl/crypto/internal/store.h @@ -0,0 +1,10 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +void ossl_store_cleanup_int(void); diff --git a/include/openssl/crypto/internal/store_int.h b/include/openssl/crypto/internal/store_int.h new file mode 100644 index 0000000..2f95885 --- /dev/null +++ b/include/openssl/crypto/internal/store_int.h @@ -0,0 +1,26 @@ +/* + * Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_STORE_INT_H +# define HEADER_STORE_INT_H + +# include +# include +# include + +/* + * Two functions to read PEM data off an already opened BIO. To be used + * instead of OSSLSTORE_open() and OSSLSTORE_close(). Everything is done + * as usual with OSSLSTORE_load() and OSSLSTORE_eof(). + */ +OSSL_STORE_CTX *ossl_store_attach_pem_bio(BIO *bp, const UI_METHOD *ui_method, + void *ui_data); +int ossl_store_detach_pem_bio(OSSL_STORE_CTX *ctx); + +#endif diff --git a/include/openssl/crypto/internal/x509_int.h b/include/openssl/crypto/internal/x509_int.h new file mode 100644 index 0000000..d863423 --- /dev/null +++ b/include/openssl/crypto/internal/x509_int.h @@ -0,0 +1,287 @@ +/* + * Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include "include/openssl/internal/refcount.h" +#include "include/openssl/x509.h" + +/* Internal X509 structures and functions: not for application use */ + +/* Note: unless otherwise stated a field pointer is mandatory and should + * never be set to NULL: the ASN.1 code and accessors rely on mandatory + * fields never being NULL. + */ + +/* + * name entry structure, equivalent to AttributeTypeAndValue defined + * in RFC5280 et al. + */ +struct X509_name_entry_st { + ASN1_OBJECT *object; /* AttributeType */ + ASN1_STRING *value; /* AttributeValue */ + int set; /* index of RDNSequence for this entry */ + int size; /* temp variable */ +}; + +/* Name from RFC 5280. */ +struct X509_name_st { + STACK_OF(X509_NAME_ENTRY) *entries; /* DN components */ + int modified; /* true if 'bytes' needs to be built */ + BUF_MEM *bytes; /* cached encoding: cannot be NULL */ + /* canonical encoding used for rapid Name comparison */ + unsigned char *canon_enc; + int canon_enclen; +} /* X509_NAME */ ; + +/* Signature info structure */ + +struct x509_sig_info_st { + /* NID of message digest */ + int mdnid; + /* NID of public key algorithm */ + int pknid; + /* Security bits */ + int secbits; + /* Various flags */ + uint32_t flags; +}; + +/* PKCS#10 certificate request */ + +struct X509_req_info_st { + ASN1_ENCODING enc; /* cached encoding of signed part */ + ASN1_INTEGER *version; /* version, defaults to v1(0) so can be NULL */ + X509_NAME *subject; /* certificate request DN */ + X509_PUBKEY *pubkey; /* public key of request */ + /* + * Zero or more attributes. + * NB: although attributes is a mandatory field some broken + * encodings omit it so this may be NULL in that case. + */ + STACK_OF(X509_ATTRIBUTE) *attributes; +}; + +struct X509_req_st { + X509_REQ_INFO req_info; /* signed certificate request data */ + X509_ALGOR sig_alg; /* signature algorithm */ + ASN1_BIT_STRING *signature; /* signature */ + CRYPTO_REF_COUNT references; + CRYPTO_RWLOCK *lock; +}; + +struct X509_crl_info_st { + ASN1_INTEGER *version; /* version: defaults to v1(0) so may be NULL */ + X509_ALGOR sig_alg; /* signature algorithm */ + X509_NAME *issuer; /* CRL issuer name */ + ASN1_TIME *lastUpdate; /* lastUpdate field */ + ASN1_TIME *nextUpdate; /* nextUpdate field: optional */ + STACK_OF(X509_REVOKED) *revoked; /* revoked entries: optional */ + STACK_OF(X509_EXTENSION) *extensions; /* extensions: optional */ + ASN1_ENCODING enc; /* encoding of signed portion of CRL */ +}; + +struct X509_crl_st { + X509_CRL_INFO crl; /* signed CRL data */ + X509_ALGOR sig_alg; /* CRL signature algorithm */ + ASN1_BIT_STRING signature; /* CRL signature */ + CRYPTO_REF_COUNT references; + int flags; + /* + * Cached copies of decoded extension values, since extensions + * are optional any of these can be NULL. + */ + AUTHORITY_KEYID *akid; + ISSUING_DIST_POINT *idp; + /* Convenient breakdown of IDP */ + int idp_flags; + int idp_reasons; + /* CRL and base CRL numbers for delta processing */ + ASN1_INTEGER *crl_number; + ASN1_INTEGER *base_crl_number; + STACK_OF(GENERAL_NAMES) *issuers; + /* hash of CRL */ + unsigned char sha1_hash[SHA_DIGEST_LENGTH]; + /* alternative method to handle this CRL */ + const X509_CRL_METHOD *meth; + void *meth_data; + CRYPTO_RWLOCK *lock; +}; + +struct x509_revoked_st { + ASN1_INTEGER serialNumber; /* revoked entry serial number */ + ASN1_TIME *revocationDate; /* revocation date */ + STACK_OF(X509_EXTENSION) *extensions; /* CRL entry extensions: optional */ + /* decoded value of CRLissuer extension: set if indirect CRL */ + STACK_OF(GENERAL_NAME) *issuer; + /* revocation reason: set to CRL_REASON_NONE if reason extension absent */ + int reason; + /* + * CRL entries are reordered for faster lookup of serial numbers. This + * field contains the original load sequence for this entry. + */ + int sequence; +}; + +/* + * This stuff is certificate "auxiliary info": it contains details which are + * useful in certificate stores and databases. When used this is tagged onto + * the end of the certificate itself. OpenSSL specific structure not defined + * in any RFC. + */ + +struct x509_cert_aux_st { + STACK_OF(ASN1_OBJECT) *trust; /* trusted uses */ + STACK_OF(ASN1_OBJECT) *reject; /* rejected uses */ + ASN1_UTF8STRING *alias; /* "friendly name" */ + ASN1_OCTET_STRING *keyid; /* key id of private key */ + STACK_OF(X509_ALGOR) *other; /* other unspecified info */ +}; + +struct x509_cinf_st { + ASN1_INTEGER *version; /* [ 0 ] default of v1 */ + ASN1_INTEGER serialNumber; + X509_ALGOR signature; + X509_NAME *issuer; + X509_VAL validity; + X509_NAME *subject; + X509_PUBKEY *key; + ASN1_BIT_STRING *issuerUID; /* [ 1 ] optional in v2 */ + ASN1_BIT_STRING *subjectUID; /* [ 2 ] optional in v2 */ + STACK_OF(X509_EXTENSION) *extensions; /* [ 3 ] optional in v3 */ + ASN1_ENCODING enc; +}; + +struct x509_st { + X509_CINF cert_info; + X509_ALGOR sig_alg; + ASN1_BIT_STRING signature; + X509_SIG_INFO siginf; + CRYPTO_REF_COUNT references; + CRYPTO_EX_DATA ex_data; + /* These contain copies of various extension values */ + long ex_pathlen; + long ex_pcpathlen; + uint32_t ex_flags; + uint32_t ex_kusage; + uint32_t ex_xkusage; + uint32_t ex_nscert; + ASN1_OCTET_STRING *skid; + AUTHORITY_KEYID *akid; + X509_POLICY_CACHE *policy_cache; + STACK_OF(DIST_POINT) *crldp; + STACK_OF(GENERAL_NAME) *altname; + NAME_CONSTRAINTS *nc; +#ifndef OPENSSL_NO_RFC3779 + STACK_OF(IPAddressFamily) *rfc3779_addr; + struct ASIdentifiers_st *rfc3779_asid; +# endif + unsigned char sha1_hash[SHA_DIGEST_LENGTH]; + X509_CERT_AUX *aux; + CRYPTO_RWLOCK *lock; + volatile int ex_cached; +} /* X509 */ ; + +/* + * This is a used when verifying cert chains. Since the gathering of the + * cert chain can take some time (and have to be 'retried', this needs to be + * kept and passed around. + */ +struct x509_store_ctx_st { /* X509_STORE_CTX */ + X509_STORE *ctx; + /* The following are set by the caller */ + /* The cert to check */ + X509 *cert; + /* chain of X509s - untrusted - passed in */ + STACK_OF(X509) *untrusted; + /* set of CRLs passed in */ + STACK_OF(X509_CRL) *crls; + X509_VERIFY_PARAM *param; + /* Other info for use with get_issuer() */ + void *other_ctx; + /* Callbacks for various operations */ + /* called to verify a certificate */ + int (*verify) (X509_STORE_CTX *ctx); + /* error callback */ + int (*verify_cb) (int ok, X509_STORE_CTX *ctx); + /* get issuers cert from ctx */ + int (*get_issuer) (X509 **issuer, X509_STORE_CTX *ctx, X509 *x); + /* check issued */ + int (*check_issued) (X509_STORE_CTX *ctx, X509 *x, X509 *issuer); + /* Check revocation status of chain */ + int (*check_revocation) (X509_STORE_CTX *ctx); + /* retrieve CRL */ + int (*get_crl) (X509_STORE_CTX *ctx, X509_CRL **crl, X509 *x); + /* Check CRL validity */ + int (*check_crl) (X509_STORE_CTX *ctx, X509_CRL *crl); + /* Check certificate against CRL */ + int (*cert_crl) (X509_STORE_CTX *ctx, X509_CRL *crl, X509 *x); + /* Check policy status of the chain */ + int (*check_policy) (X509_STORE_CTX *ctx); + STACK_OF(X509) *(*lookup_certs) (X509_STORE_CTX *ctx, X509_NAME *nm); + STACK_OF(X509_CRL) *(*lookup_crls) (X509_STORE_CTX *ctx, X509_NAME *nm); + int (*cleanup) (X509_STORE_CTX *ctx); + /* The following is built up */ + /* if 0, rebuild chain */ + int valid; + /* number of untrusted certs */ + int num_untrusted; + /* chain of X509s - built up and trusted */ + STACK_OF(X509) *chain; + /* Valid policy tree */ + X509_POLICY_TREE *tree; + /* Require explicit policy value */ + int explicit_policy; + /* When something goes wrong, this is why */ + int error_depth; + int error; + X509 *current_cert; + /* cert currently being tested as valid issuer */ + X509 *current_issuer; + /* current CRL */ + X509_CRL *current_crl; + /* score of current CRL */ + int current_crl_score; + /* Reason mask */ + unsigned int current_reasons; + /* For CRL path validation: parent context */ + X509_STORE_CTX *parent; + CRYPTO_EX_DATA ex_data; + SSL_DANE *dane; + /* signed via bare TA public key, rather than CA certificate */ + int bare_ta_signed; +}; + +/* PKCS#8 private key info structure */ + +struct pkcs8_priv_key_info_st { + ASN1_INTEGER *version; + X509_ALGOR *pkeyalg; + ASN1_OCTET_STRING *pkey; + STACK_OF(X509_ATTRIBUTE) *attributes; +}; + +struct X509_sig_st { + X509_ALGOR *algor; + ASN1_OCTET_STRING *digest; +}; + +struct x509_object_st { + /* one of the above types */ + X509_LOOKUP_TYPE type; + union { + char *ptr; + X509 *x509; + X509_CRL *crl; + EVP_PKEY *pkey; + } data; +}; + +int a2i_ipadd(unsigned char *ipout, const char *ipasc); +int x509_set1_time(ASN1_TIME **ptm, const ASN1_TIME *tm); + +void x509_init_sig_info(X509 *x); diff --git a/include/openssl/crypto/mips_arch.h b/include/openssl/crypto/mips_arch.h new file mode 100644 index 0000000..75043e7 --- /dev/null +++ b/include/openssl/crypto/mips_arch.h @@ -0,0 +1,40 @@ +/* + * Copyright 2011-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef __MIPS_ARCH_H__ +# define __MIPS_ARCH_H__ + +# if (defined(__mips_smartmips) || defined(_MIPS_ARCH_MIPS32R3) || \ + defined(_MIPS_ARCH_MIPS32R5) || defined(_MIPS_ARCH_MIPS32R6)) + && !defined(_MIPS_ARCH_MIPS32R2) +# define _MIPS_ARCH_MIPS32R2 +# endif + +# if (defined(_MIPS_ARCH_MIPS64R3) || defined(_MIPS_ARCH_MIPS64R5) || \ + defined(_MIPS_ARCH_MIPS64R6)) \ + && !defined(_MIPS_ARCH_MIPS64R2) +# define _MIPS_ARCH_MIPS64R2 +# endif + +# if defined(_MIPS_ARCH_MIPS64R6) +# define dmultu(rs,rt) +# define mflo(rd,rs,rt) dmulu rd,rs,rt +# define mfhi(rd,rs,rt) dmuhu rd,rs,rt +# elif defined(_MIPS_ARCH_MIPS32R6) +# define multu(rs,rt) +# define mflo(rd,rs,rt) mulu rd,rs,rt +# define mfhi(rd,rs,rt) muhu rd,rs,rt +# else +# define dmultu(rs,rt) dmultu rs,rt +# define multu(rs,rt) multu rs,rt +# define mflo(rd,rs,rt) mflo rd +# define mfhi(rd,rs,rt) mfhi rd +# endif + +#endif diff --git a/include/openssl/crypto/ppc_arch.h b/include/openssl/crypto/ppc_arch.h new file mode 100644 index 0000000..65cf96f --- /dev/null +++ b/include/openssl/crypto/ppc_arch.h @@ -0,0 +1,26 @@ +/* + * Copyright 2014-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PPC_ARCH_H +# define HEADER_PPC_ARCH_H + +extern unsigned int OPENSSL_ppccap_P; + +/* + * Flags' usage can appear ambiguous, because they are set rather + * to reflect OpenSSL performance preferences than actual processor + * capabilities. + */ +# define PPC_FPU64 (1<<0) +# define PPC_ALTIVEC (1<<1) +# define PPC_CRYPTO207 (1<<2) +# define PPC_FPU (1<<3) +# define PPC_MADD300 (1<<4) + +#endif diff --git a/include/openssl/crypto/s390x_arch.h b/include/openssl/crypto/s390x_arch.h new file mode 100644 index 0000000..4a775a9 --- /dev/null +++ b/include/openssl/crypto/s390x_arch.h @@ -0,0 +1,103 @@ +/* + * Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef S390X_ARCH_H +# define S390X_ARCH_H + +# ifndef __ASSEMBLER__ + +void s390x_kimd(const unsigned char *in, size_t len, unsigned int fc, + void *param); +void s390x_klmd(const unsigned char *in, size_t inlen, unsigned char *out, + size_t outlen, unsigned int fc, void *param); +void s390x_km(const unsigned char *in, size_t len, unsigned char *out, + unsigned int fc, void *param); +void s390x_kmac(const unsigned char *in, size_t len, unsigned int fc, + void *param); +void s390x_kmo(const unsigned char *in, size_t len, unsigned char *out, + unsigned int fc, void *param); +void s390x_kmf(const unsigned char *in, size_t len, unsigned char *out, + unsigned int fc, void *param); +void s390x_kma(const unsigned char *aad, size_t alen, const unsigned char *in, + size_t len, unsigned char *out, unsigned int fc, void *param); + +/* + * The field elements of OPENSSL_s390xcap_P are the 64-bit words returned by + * the STFLE instruction followed by the 64-bit word pairs returned by + * instructions' QUERY functions. If STFLE returns fewer data or an instruction + * is not supported, the corresponding field elements are zero. + */ +struct OPENSSL_s390xcap_st { + unsigned long long stfle[4]; + unsigned long long kimd[2]; + unsigned long long klmd[2]; + unsigned long long km[2]; + unsigned long long kmc[2]; + unsigned long long kmac[2]; + unsigned long long kmctr[2]; + unsigned long long kmo[2]; + unsigned long long kmf[2]; + unsigned long long prno[2]; + unsigned long long kma[2]; +}; + +extern struct OPENSSL_s390xcap_st OPENSSL_s390xcap_P; + +/* convert facility bit number or function code to bit mask */ +# define S390X_CAPBIT(i) (1ULL << (63 - (i) % 64)) + +# endif + +/* OPENSSL_s390xcap_P offsets [bytes] */ +# define S390X_STFLE 0x00 +# define S390X_KIMD 0x20 +# define S390X_KLMD 0x30 +# define S390X_KM 0x40 +# define S390X_KMC 0x50 +# define S390X_KMAC 0x60 +# define S390X_KMCTR 0x70 +# define S390X_KMO 0x80 +# define S390X_KMF 0x90 +# define S390X_PRNO 0xa0 +# define S390X_KMA 0xb0 + +/* Facility Bit Numbers */ +# define S390X_VX 129 +# define S390X_VXD 134 +# define S390X_VXE 135 + +/* Function Codes */ + +/* all instructions */ +# define S390X_QUERY 0 + +/* kimd/klmd */ +# define S390X_SHA3_224 32 +# define S390X_SHA3_256 33 +# define S390X_SHA3_384 34 +# define S390X_SHA3_512 35 +# define S390X_SHAKE_128 36 +# define S390X_SHAKE_256 37 +# define S390X_GHASH 65 + +/* km/kmc/kmac/kmctr/kmo/kmf/kma */ +# define S390X_AES_128 18 +# define S390X_AES_192 19 +# define S390X_AES_256 20 + +/* prno */ +# define S390X_TRNG 114 + +/* Register 0 Flags */ +# define S390X_DECRYPT 0x80 +# define S390X_KMA_LPC 0x100 +# define S390X_KMA_LAAD 0x200 +# define S390X_KMA_HS 0x400 + +#endif diff --git a/include/openssl/crypto/sparc_arch.h b/include/openssl/crypto/sparc_arch.h new file mode 100644 index 0000000..99eafb3 --- /dev/null +++ b/include/openssl/crypto/sparc_arch.h @@ -0,0 +1,118 @@ +/* + * Copyright 2012-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef __SPARC_ARCH_H__ +# define __SPARC_ARCH_H__ + +# define SPARCV9_TICK_PRIVILEGED (1<<0) +# define SPARCV9_PREFER_FPU (1<<1) +# define SPARCV9_VIS1 (1<<2) +# define SPARCV9_VIS2 (1<<3)/* reserved */ +# define SPARCV9_FMADD (1<<4) +# define SPARCV9_BLK (1<<5)/* VIS1 block copy */ +# define SPARCV9_VIS3 (1<<6) +# define SPARCV9_RANDOM (1<<7) +# define SPARCV9_64BIT_STACK (1<<8) +# define SPARCV9_FJAESX (1<<9)/* Fujitsu SPARC64 X AES */ +# define SPARCV9_FJDESX (1<<10)/* Fujitsu SPARC64 X DES, reserved */ +# define SPARCV9_FJHPCACE (1<<11)/* Fujitsu HPC-ACE, reserved */ +# define SPARCV9_IMA (1<<13)/* reserved */ +# define SPARCV9_VIS4 (1<<14)/* reserved */ + +/* + * OPENSSL_sparcv9cap_P[1] is copy of Compatibility Feature Register, + * %asr26, SPARC-T4 and later. There is no SPARCV9_CFR bit in + * OPENSSL_sparcv9cap_P[0], as %cfr copy is sufficient... + */ +# define CFR_AES 0x00000001/* Supports AES opcodes */ +# define CFR_DES 0x00000002/* Supports DES opcodes */ +# define CFR_KASUMI 0x00000004/* Supports KASUMI opcodes */ +# define CFR_CAMELLIA 0x00000008/* Supports CAMELLIA opcodes */ +# define CFR_MD5 0x00000010/* Supports MD5 opcodes */ +# define CFR_SHA1 0x00000020/* Supports SHA1 opcodes */ +# define CFR_SHA256 0x00000040/* Supports SHA256 opcodes */ +# define CFR_SHA512 0x00000080/* Supports SHA512 opcodes */ +# define CFR_MPMUL 0x00000100/* Supports MPMUL opcodes */ +# define CFR_MONTMUL 0x00000200/* Supports MONTMUL opcodes */ +# define CFR_MONTSQR 0x00000400/* Supports MONTSQR opcodes */ +# define CFR_CRC32C 0x00000800/* Supports CRC32C opcodes */ +# define CFR_XMPMUL 0x00001000/* Supports XMPMUL opcodes */ +# define CFR_XMONTMUL 0x00002000/* Supports XMONTMUL opcodes */ +# define CFR_XMONTSQR 0x00004000/* Supports XMONTSQR opcodes */ + +# if defined(OPENSSL_PIC) && !defined(__PIC__) +# define __PIC__ +# endif + +# if defined(__SUNPRO_C) && defined(__sparcv9) && !defined(__arch64__) +# define __arch64__ +# endif + +# define SPARC_PIC_THUNK(reg) \ + .align 32; \ +.Lpic_thunk: \ + jmp %o7 + 8; \ + add %o7, reg, reg; + +# define SPARC_PIC_THUNK_CALL(reg) \ + sethi %hi(_GLOBAL_OFFSET_TABLE_-4), reg; \ + call .Lpic_thunk; \ + or reg, %lo(_GLOBAL_OFFSET_TABLE_+4), reg; + +# if 1 +# define SPARC_SETUP_GOT_REG(reg) SPARC_PIC_THUNK_CALL(reg) +# else +# define SPARC_SETUP_GOT_REG(reg) \ + sethi %hi(_GLOBAL_OFFSET_TABLE_-4), reg; \ + call .+8; \ + or reg,%lo(_GLOBAL_OFFSET_TABLE_+4), reg; \ + add %o7, reg, reg +# endif + +# if defined(__arch64__) + +# define SPARC_LOAD_ADDRESS(SYM, reg) \ + setx SYM, %o7, reg; +# define LDPTR ldx +# define SIZE_T_CC %xcc +# define STACK_FRAME 192 +# define STACK_BIAS 2047 +# define STACK_7thARG (STACK_BIAS+176) + +# else + +# define SPARC_LOAD_ADDRESS(SYM, reg) \ + set SYM, reg; +# define LDPTR ld +# define SIZE_T_CC %icc +# define STACK_FRAME 112 +# define STACK_BIAS 0 +# define STACK_7thARG 92 +# define SPARC_LOAD_ADDRESS_LEAF(SYM,reg,tmp) SPARC_LOAD_ADDRESS(SYM,reg) + +# endif + +# ifdef __PIC__ +# undef SPARC_LOAD_ADDRESS +# undef SPARC_LOAD_ADDRESS_LEAF +# define SPARC_LOAD_ADDRESS(SYM, reg) \ + SPARC_SETUP_GOT_REG(reg); \ + sethi %hi(SYM), %o7; \ + or %o7, %lo(SYM), %o7; \ + LDPTR [reg + %o7], reg; +# endif + +# ifndef SPARC_LOAD_ADDRESS_LEAF +# define SPARC_LOAD_ADDRESS_LEAF(SYM, reg, tmp) \ + mov %o7, tmp; \ + SPARC_LOAD_ADDRESS(SYM, reg) \ + mov tmp, %o7; +# endif + +#endif /* __SPARC_ARCH_H__ */ diff --git a/include/openssl/crypto/vms_rms.h b/include/openssl/crypto/vms_rms.h new file mode 100644 index 0000000..3b994a0 --- /dev/null +++ b/include/openssl/crypto/vms_rms.h @@ -0,0 +1,58 @@ +/* + * Copyright 2011-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifdef NAML$C_MAXRSS + +# define CC_RMS_NAMX cc$rms_naml +# define FAB_NAMX fab$l_naml +# define FAB_OR_NAML( fab, naml) naml +# define FAB_OR_NAML_DNA naml$l_long_defname +# define FAB_OR_NAML_DNS naml$l_long_defname_size +# define FAB_OR_NAML_FNA naml$l_long_filename +# define FAB_OR_NAML_FNS naml$l_long_filename_size +# define NAMX_ESA naml$l_long_expand +# define NAMX_ESL naml$l_long_expand_size +# define NAMX_ESS naml$l_long_expand_alloc +# define NAMX_NOP naml$b_nop +# define SET_NAMX_NO_SHORT_UPCASE( nam) nam.naml$v_no_short_upcase = 1 + +# if __INITIAL_POINTER_SIZE == 64 +# define NAMX_DNA_FNA_SET(fab) fab.fab$l_dna = (__char_ptr32) -1; \ + fab.fab$l_fna = (__char_ptr32) -1; +# else /* __INITIAL_POINTER_SIZE == 64 */ +# define NAMX_DNA_FNA_SET(fab) fab.fab$l_dna = (char *) -1; \ + fab.fab$l_fna = (char *) -1; +# endif /* __INITIAL_POINTER_SIZE == 64 [else] */ + +# define NAMX_MAXRSS NAML$C_MAXRSS +# define NAMX_STRUCT NAML + +#else /* def NAML$C_MAXRSS */ + +# define CC_RMS_NAMX cc$rms_nam +# define FAB_NAMX fab$l_nam +# define FAB_OR_NAML( fab, naml) fab +# define FAB_OR_NAML_DNA fab$l_dna +# define FAB_OR_NAML_DNS fab$b_dns +# define FAB_OR_NAML_FNA fab$l_fna +# define FAB_OR_NAML_FNS fab$b_fns +# define NAMX_ESA nam$l_esa +# define NAMX_ESL nam$b_esl +# define NAMX_ESS nam$b_ess +# define NAMX_NOP nam$b_nop +# define NAMX_DNA_FNA_SET(fab) +# define NAMX_MAXRSS NAM$C_MAXRSS +# define NAMX_STRUCT NAM +# ifdef NAM$M_NO_SHORT_UPCASE +# define SET_NAMX_NO_SHORT_UPCASE( nam) naml.naml$v_no_short_upcase = 1 +# else /* def NAM$M_NO_SHORT_UPCASE */ +# define SET_NAMX_NO_SHORT_UPCASE( nam) +# endif /* def NAM$M_NO_SHORT_UPCASE [else] */ + +#endif /* def NAML$C_MAXRSS [else] */ diff --git a/include/openssl/cryptoerr.h b/include/openssl/cryptoerr.h new file mode 100644 index 0000000..e127ff6 --- /dev/null +++ b/include/openssl/cryptoerr.h @@ -0,0 +1,53 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CRYPTOERR_H +# define HEADER_CRYPTOERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_CRYPTO_strings(void); + +/* + * CRYPTO function codes. + */ +# define CRYPTO_F_CMAC_CTX_NEW 120 +# define CRYPTO_F_CRYPTO_DUP_EX_DATA 110 +# define CRYPTO_F_CRYPTO_FREE_EX_DATA 111 +# define CRYPTO_F_CRYPTO_GET_EX_NEW_INDEX 100 +# define CRYPTO_F_CRYPTO_MEMDUP 115 +# define CRYPTO_F_CRYPTO_NEW_EX_DATA 112 +# define CRYPTO_F_CRYPTO_OCB128_COPY_CTX 121 +# define CRYPTO_F_CRYPTO_OCB128_INIT 122 +# define CRYPTO_F_CRYPTO_SET_EX_DATA 102 +# define CRYPTO_F_FIPS_MODE_SET 109 +# define CRYPTO_F_GET_AND_LOCK 113 +# define CRYPTO_F_OPENSSL_ATEXIT 114 +# define CRYPTO_F_OPENSSL_BUF2HEXSTR 117 +# define CRYPTO_F_OPENSSL_FOPEN 119 +# define CRYPTO_F_OPENSSL_HEXSTR2BUF 118 +# define CRYPTO_F_OPENSSL_INIT_CRYPTO 116 +# define CRYPTO_F_OPENSSL_LH_NEW 126 +# define CRYPTO_F_OPENSSL_SK_DEEP_COPY 127 +# define CRYPTO_F_OPENSSL_SK_DUP 128 +# define CRYPTO_F_PKEY_HMAC_INIT 123 +# define CRYPTO_F_PKEY_POLY1305_INIT 124 +# define CRYPTO_F_PKEY_SIPHASH_INIT 125 +# define CRYPTO_F_SK_RESERVE 129 + +/* + * CRYPTO reason codes. + */ +# define CRYPTO_R_FIPS_MODE_NOT_SUPPORTED 101 +# define CRYPTO_R_ILLEGAL_HEX_DIGIT 102 +# define CRYPTO_R_ODD_NUMBER_OF_DIGITS 103 + +#endif diff --git a/include/openssl/ct.h b/include/openssl/ct.h new file mode 100644 index 0000000..6444c38 --- /dev/null +++ b/include/openssl/ct.h @@ -0,0 +1,476 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CT_H +# define HEADER_CT_H + +# include + +# ifndef OPENSSL_NO_CT +# include +# include +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + + +/* Minimum RSA key size, from RFC6962 */ +# define SCT_MIN_RSA_BITS 2048 + +/* All hashes are SHA256 in v1 of Certificate Transparency */ +# define CT_V1_HASHLEN SHA256_DIGEST_LENGTH + +typedef enum { + CT_LOG_ENTRY_TYPE_NOT_SET = -1, + CT_LOG_ENTRY_TYPE_X509 = 0, + CT_LOG_ENTRY_TYPE_PRECERT = 1 +} ct_log_entry_type_t; + +typedef enum { + SCT_VERSION_NOT_SET = -1, + SCT_VERSION_V1 = 0 +} sct_version_t; + +typedef enum { + SCT_SOURCE_UNKNOWN, + SCT_SOURCE_TLS_EXTENSION, + SCT_SOURCE_X509V3_EXTENSION, + SCT_SOURCE_OCSP_STAPLED_RESPONSE +} sct_source_t; + +typedef enum { + SCT_VALIDATION_STATUS_NOT_SET, + SCT_VALIDATION_STATUS_UNKNOWN_LOG, + SCT_VALIDATION_STATUS_VALID, + SCT_VALIDATION_STATUS_INVALID, + SCT_VALIDATION_STATUS_UNVERIFIED, + SCT_VALIDATION_STATUS_UNKNOWN_VERSION +} sct_validation_status_t; + +DEFINE_STACK_OF(SCT) +DEFINE_STACK_OF(CTLOG) + +/****************************************** + * CT policy evaluation context functions * + ******************************************/ + +/* + * Creates a new, empty policy evaluation context. + * The caller is responsible for calling CT_POLICY_EVAL_CTX_free when finished + * with the CT_POLICY_EVAL_CTX. + */ +CT_POLICY_EVAL_CTX *CT_POLICY_EVAL_CTX_new(void); + +/* Deletes a policy evaluation context and anything it owns. */ +void CT_POLICY_EVAL_CTX_free(CT_POLICY_EVAL_CTX *ctx); + +/* Gets the peer certificate that the SCTs are for */ +X509* CT_POLICY_EVAL_CTX_get0_cert(const CT_POLICY_EVAL_CTX *ctx); + +/* + * Sets the certificate associated with the received SCTs. + * Increments the reference count of cert. + * Returns 1 on success, 0 otherwise. + */ +int CT_POLICY_EVAL_CTX_set1_cert(CT_POLICY_EVAL_CTX *ctx, X509 *cert); + +/* Gets the issuer of the aforementioned certificate */ +X509* CT_POLICY_EVAL_CTX_get0_issuer(const CT_POLICY_EVAL_CTX *ctx); + +/* + * Sets the issuer of the certificate associated with the received SCTs. + * Increments the reference count of issuer. + * Returns 1 on success, 0 otherwise. + */ +int CT_POLICY_EVAL_CTX_set1_issuer(CT_POLICY_EVAL_CTX *ctx, X509 *issuer); + +/* Gets the CT logs that are trusted sources of SCTs */ +const CTLOG_STORE *CT_POLICY_EVAL_CTX_get0_log_store(const CT_POLICY_EVAL_CTX *ctx); + +/* Sets the log store that is in use. It must outlive the CT_POLICY_EVAL_CTX. */ +void CT_POLICY_EVAL_CTX_set_shared_CTLOG_STORE(CT_POLICY_EVAL_CTX *ctx, + CTLOG_STORE *log_store); + +/* + * Gets the time, in milliseconds since the Unix epoch, that will be used as the + * current time when checking whether an SCT was issued in the future. + * Such SCTs will fail validation, as required by RFC6962. + */ +uint64_t CT_POLICY_EVAL_CTX_get_time(const CT_POLICY_EVAL_CTX *ctx); + +/* + * Sets the time to evaluate SCTs against, in milliseconds since the Unix epoch. + * If an SCT's timestamp is after this time, it will be interpreted as having + * been issued in the future. RFC6962 states that "TLS clients MUST reject SCTs + * whose timestamp is in the future", so an SCT will not validate in this case. + */ +void CT_POLICY_EVAL_CTX_set_time(CT_POLICY_EVAL_CTX *ctx, uint64_t time_in_ms); + +/***************** + * SCT functions * + *****************/ + +/* + * Creates a new, blank SCT. + * The caller is responsible for calling SCT_free when finished with the SCT. + */ +SCT *SCT_new(void); + +/* + * Creates a new SCT from some base64-encoded strings. + * The caller is responsible for calling SCT_free when finished with the SCT. + */ +SCT *SCT_new_from_base64(unsigned char version, + const char *logid_base64, + ct_log_entry_type_t entry_type, + uint64_t timestamp, + const char *extensions_base64, + const char *signature_base64); + +/* + * Frees the SCT and the underlying data structures. + */ +void SCT_free(SCT *sct); + +/* + * Free a stack of SCTs, and the underlying SCTs themselves. + * Intended to be compatible with X509V3_EXT_FREE. + */ +void SCT_LIST_free(STACK_OF(SCT) *a); + +/* + * Returns the version of the SCT. + */ +sct_version_t SCT_get_version(const SCT *sct); + +/* + * Set the version of an SCT. + * Returns 1 on success, 0 if the version is unrecognized. + */ +__owur int SCT_set_version(SCT *sct, sct_version_t version); + +/* + * Returns the log entry type of the SCT. + */ +ct_log_entry_type_t SCT_get_log_entry_type(const SCT *sct); + +/* + * Set the log entry type of an SCT. + * Returns 1 on success, 0 otherwise. + */ +__owur int SCT_set_log_entry_type(SCT *sct, ct_log_entry_type_t entry_type); + +/* + * Gets the ID of the log that an SCT came from. + * Ownership of the log ID remains with the SCT. + * Returns the length of the log ID. + */ +size_t SCT_get0_log_id(const SCT *sct, unsigned char **log_id); + +/* + * Set the log ID of an SCT to point directly to the *log_id specified. + * The SCT takes ownership of the specified pointer. + * Returns 1 on success, 0 otherwise. + */ +__owur int SCT_set0_log_id(SCT *sct, unsigned char *log_id, size_t log_id_len); + +/* + * Set the log ID of an SCT. + * This makes a copy of the log_id. + * Returns 1 on success, 0 otherwise. + */ +__owur int SCT_set1_log_id(SCT *sct, const unsigned char *log_id, + size_t log_id_len); + +/* + * Returns the timestamp for the SCT (epoch time in milliseconds). + */ +uint64_t SCT_get_timestamp(const SCT *sct); + +/* + * Set the timestamp of an SCT (epoch time in milliseconds). + */ +void SCT_set_timestamp(SCT *sct, uint64_t timestamp); + +/* + * Return the NID for the signature used by the SCT. + * For CT v1, this will be either NID_sha256WithRSAEncryption or + * NID_ecdsa_with_SHA256 (or NID_undef if incorrect/unset). + */ +int SCT_get_signature_nid(const SCT *sct); + +/* + * Set the signature type of an SCT + * For CT v1, this should be either NID_sha256WithRSAEncryption or + * NID_ecdsa_with_SHA256. + * Returns 1 on success, 0 otherwise. + */ +__owur int SCT_set_signature_nid(SCT *sct, int nid); + +/* + * Set *ext to point to the extension data for the SCT. ext must not be NULL. + * The SCT retains ownership of this pointer. + * Returns length of the data pointed to. + */ +size_t SCT_get0_extensions(const SCT *sct, unsigned char **ext); + +/* + * Set the extensions of an SCT to point directly to the *ext specified. + * The SCT takes ownership of the specified pointer. + */ +void SCT_set0_extensions(SCT *sct, unsigned char *ext, size_t ext_len); + +/* + * Set the extensions of an SCT. + * This takes a copy of the ext. + * Returns 1 on success, 0 otherwise. + */ +__owur int SCT_set1_extensions(SCT *sct, const unsigned char *ext, + size_t ext_len); + +/* + * Set *sig to point to the signature for the SCT. sig must not be NULL. + * The SCT retains ownership of this pointer. + * Returns length of the data pointed to. + */ +size_t SCT_get0_signature(const SCT *sct, unsigned char **sig); + +/* + * Set the signature of an SCT to point directly to the *sig specified. + * The SCT takes ownership of the specified pointer. + */ +void SCT_set0_signature(SCT *sct, unsigned char *sig, size_t sig_len); + +/* + * Set the signature of an SCT to be a copy of the *sig specified. + * Returns 1 on success, 0 otherwise. + */ +__owur int SCT_set1_signature(SCT *sct, const unsigned char *sig, + size_t sig_len); + +/* + * The origin of this SCT, e.g. TLS extension, OCSP response, etc. + */ +sct_source_t SCT_get_source(const SCT *sct); + +/* + * Set the origin of this SCT, e.g. TLS extension, OCSP response, etc. + * Returns 1 on success, 0 otherwise. + */ +__owur int SCT_set_source(SCT *sct, sct_source_t source); + +/* + * Returns a text string describing the validation status of |sct|. + */ +const char *SCT_validation_status_string(const SCT *sct); + +/* + * Pretty-prints an |sct| to |out|. + * It will be indented by the number of spaces specified by |indent|. + * If |logs| is not NULL, it will be used to lookup the CT log that the SCT came + * from, so that the log name can be printed. + */ +void SCT_print(const SCT *sct, BIO *out, int indent, const CTLOG_STORE *logs); + +/* + * Pretty-prints an |sct_list| to |out|. + * It will be indented by the number of spaces specified by |indent|. + * SCTs will be delimited by |separator|. + * If |logs| is not NULL, it will be used to lookup the CT log that each SCT + * came from, so that the log names can be printed. + */ +void SCT_LIST_print(const STACK_OF(SCT) *sct_list, BIO *out, int indent, + const char *separator, const CTLOG_STORE *logs); + +/* + * Gets the last result of validating this SCT. + * If it has not been validated yet, returns SCT_VALIDATION_STATUS_NOT_SET. + */ +sct_validation_status_t SCT_get_validation_status(const SCT *sct); + +/* + * Validates the given SCT with the provided context. + * Sets the "validation_status" field of the SCT. + * Returns 1 if the SCT is valid and the signature verifies. + * Returns 0 if the SCT is invalid or could not be verified. + * Returns -1 if an error occurs. + */ +__owur int SCT_validate(SCT *sct, const CT_POLICY_EVAL_CTX *ctx); + +/* + * Validates the given list of SCTs with the provided context. + * Sets the "validation_status" field of each SCT. + * Returns 1 if there are no invalid SCTs and all signatures verify. + * Returns 0 if at least one SCT is invalid or could not be verified. + * Returns a negative integer if an error occurs. + */ +__owur int SCT_LIST_validate(const STACK_OF(SCT) *scts, + CT_POLICY_EVAL_CTX *ctx); + + +/********************************* + * SCT parsing and serialisation * + *********************************/ + +/* + * Serialize (to TLS format) a stack of SCTs and return the length. + * "a" must not be NULL. + * If "pp" is NULL, just return the length of what would have been serialized. + * If "pp" is not NULL and "*pp" is null, function will allocate a new pointer + * for data that caller is responsible for freeing (only if function returns + * successfully). + * If "pp" is NULL and "*pp" is not NULL, caller is responsible for ensuring + * that "*pp" is large enough to accept all of the serialized data. + * Returns < 0 on error, >= 0 indicating bytes written (or would have been) + * on success. + */ +__owur int i2o_SCT_LIST(const STACK_OF(SCT) *a, unsigned char **pp); + +/* + * Convert TLS format SCT list to a stack of SCTs. + * If "a" or "*a" is NULL, a new stack will be created that the caller is + * responsible for freeing (by calling SCT_LIST_free). + * "**pp" and "*pp" must not be NULL. + * Upon success, "*pp" will point to after the last bytes read, and a stack + * will be returned. + * Upon failure, a NULL pointer will be returned, and the position of "*pp" is + * not defined. + */ +STACK_OF(SCT) *o2i_SCT_LIST(STACK_OF(SCT) **a, const unsigned char **pp, + size_t len); + +/* + * Serialize (to DER format) a stack of SCTs and return the length. + * "a" must not be NULL. + * If "pp" is NULL, just returns the length of what would have been serialized. + * If "pp" is not NULL and "*pp" is null, function will allocate a new pointer + * for data that caller is responsible for freeing (only if function returns + * successfully). + * If "pp" is NULL and "*pp" is not NULL, caller is responsible for ensuring + * that "*pp" is large enough to accept all of the serialized data. + * Returns < 0 on error, >= 0 indicating bytes written (or would have been) + * on success. + */ +__owur int i2d_SCT_LIST(const STACK_OF(SCT) *a, unsigned char **pp); + +/* + * Parses an SCT list in DER format and returns it. + * If "a" or "*a" is NULL, a new stack will be created that the caller is + * responsible for freeing (by calling SCT_LIST_free). + * "**pp" and "*pp" must not be NULL. + * Upon success, "*pp" will point to after the last bytes read, and a stack + * will be returned. + * Upon failure, a NULL pointer will be returned, and the position of "*pp" is + * not defined. + */ +STACK_OF(SCT) *d2i_SCT_LIST(STACK_OF(SCT) **a, const unsigned char **pp, + long len); + +/* + * Serialize (to TLS format) an |sct| and write it to |out|. + * If |out| is null, no SCT will be output but the length will still be returned. + * If |out| points to a null pointer, a string will be allocated to hold the + * TLS-format SCT. It is the responsibility of the caller to free it. + * If |out| points to an allocated string, the TLS-format SCT will be written + * to it. + * The length of the SCT in TLS format will be returned. + */ +__owur int i2o_SCT(const SCT *sct, unsigned char **out); + +/* + * Parses an SCT in TLS format and returns it. + * If |psct| is not null, it will end up pointing to the parsed SCT. If it + * already points to a non-null pointer, the pointer will be free'd. + * |in| should be a pointer to a string containing the TLS-format SCT. + * |in| will be advanced to the end of the SCT if parsing succeeds. + * |len| should be the length of the SCT in |in|. + * Returns NULL if an error occurs. + * If the SCT is an unsupported version, only the SCT's 'sct' and 'sct_len' + * fields will be populated (with |in| and |len| respectively). + */ +SCT *o2i_SCT(SCT **psct, const unsigned char **in, size_t len); + +/******************** + * CT log functions * + ********************/ + +/* + * Creates a new CT log instance with the given |public_key| and |name|. + * Takes ownership of |public_key| but copies |name|. + * Returns NULL if malloc fails or if |public_key| cannot be converted to DER. + * Should be deleted by the caller using CTLOG_free when no longer needed. + */ +CTLOG *CTLOG_new(EVP_PKEY *public_key, const char *name); + +/* + * Creates a new CTLOG instance with the base64-encoded SubjectPublicKeyInfo DER + * in |pkey_base64|. The |name| is a string to help users identify this log. + * Returns 1 on success, 0 on failure. + * Should be deleted by the caller using CTLOG_free when no longer needed. + */ +int CTLOG_new_from_base64(CTLOG ** ct_log, + const char *pkey_base64, const char *name); + +/* + * Deletes a CT log instance and its fields. + */ +void CTLOG_free(CTLOG *log); + +/* Gets the name of the CT log */ +const char *CTLOG_get0_name(const CTLOG *log); +/* Gets the ID of the CT log */ +void CTLOG_get0_log_id(const CTLOG *log, const uint8_t **log_id, + size_t *log_id_len); +/* Gets the public key of the CT log */ +EVP_PKEY *CTLOG_get0_public_key(const CTLOG *log); + +/************************** + * CT log store functions * + **************************/ + +/* + * Creates a new CT log store. + * Should be deleted by the caller using CTLOG_STORE_free when no longer needed. + */ +CTLOG_STORE *CTLOG_STORE_new(void); + +/* + * Deletes a CT log store and all of the CT log instances held within. + */ +void CTLOG_STORE_free(CTLOG_STORE *store); + +/* + * Finds a CT log in the store based on its log ID. + * Returns the CT log, or NULL if no match is found. + */ +const CTLOG *CTLOG_STORE_get0_log_by_id(const CTLOG_STORE *store, + const uint8_t *log_id, + size_t log_id_len); + +/* + * Loads a CT log list into a |store| from a |file|. + * Returns 1 if loading is successful, or 0 otherwise. + */ +__owur int CTLOG_STORE_load_file(CTLOG_STORE *store, const char *file); + +/* + * Loads the default CT log list into a |store|. + * See internal/cryptlib.h for the environment variable and file path that are + * consulted to find the default file. + * Returns 1 if loading is successful, or 0 otherwise. + */ +__owur int CTLOG_STORE_load_default_file(CTLOG_STORE *store); + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/cterr.h b/include/openssl/cterr.h new file mode 100644 index 0000000..5dda41f --- /dev/null +++ b/include/openssl/cterr.h @@ -0,0 +1,76 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CTERR_H +# define HEADER_CTERR_H + +# include + +# ifndef OPENSSL_NO_CT + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_CT_strings(void); + +/* + * CT function codes. + */ +# define CT_F_CTLOG_NEW 117 +# define CT_F_CTLOG_NEW_FROM_BASE64 118 +# define CT_F_CTLOG_NEW_FROM_CONF 119 +# define CT_F_CTLOG_STORE_LOAD_CTX_NEW 122 +# define CT_F_CTLOG_STORE_LOAD_FILE 123 +# define CT_F_CTLOG_STORE_LOAD_LOG 130 +# define CT_F_CTLOG_STORE_NEW 131 +# define CT_F_CT_BASE64_DECODE 124 +# define CT_F_CT_POLICY_EVAL_CTX_NEW 133 +# define CT_F_CT_V1_LOG_ID_FROM_PKEY 125 +# define CT_F_I2O_SCT 107 +# define CT_F_I2O_SCT_LIST 108 +# define CT_F_I2O_SCT_SIGNATURE 109 +# define CT_F_O2I_SCT 110 +# define CT_F_O2I_SCT_LIST 111 +# define CT_F_O2I_SCT_SIGNATURE 112 +# define CT_F_SCT_CTX_NEW 126 +# define CT_F_SCT_CTX_VERIFY 128 +# define CT_F_SCT_NEW 100 +# define CT_F_SCT_NEW_FROM_BASE64 127 +# define CT_F_SCT_SET0_LOG_ID 101 +# define CT_F_SCT_SET1_EXTENSIONS 114 +# define CT_F_SCT_SET1_LOG_ID 115 +# define CT_F_SCT_SET1_SIGNATURE 116 +# define CT_F_SCT_SET_LOG_ENTRY_TYPE 102 +# define CT_F_SCT_SET_SIGNATURE_NID 103 +# define CT_F_SCT_SET_VERSION 104 + +/* + * CT reason codes. + */ +# define CT_R_BASE64_DECODE_ERROR 108 +# define CT_R_INVALID_LOG_ID_LENGTH 100 +# define CT_R_LOG_CONF_INVALID 109 +# define CT_R_LOG_CONF_INVALID_KEY 110 +# define CT_R_LOG_CONF_MISSING_DESCRIPTION 111 +# define CT_R_LOG_CONF_MISSING_KEY 112 +# define CT_R_LOG_KEY_INVALID 113 +# define CT_R_SCT_FUTURE_TIMESTAMP 116 +# define CT_R_SCT_INVALID 104 +# define CT_R_SCT_INVALID_SIGNATURE 107 +# define CT_R_SCT_LIST_INVALID 105 +# define CT_R_SCT_LOG_ID_MISMATCH 114 +# define CT_R_SCT_NOT_SET 106 +# define CT_R_SCT_UNSUPPORTED_VERSION 115 +# define CT_R_UNRECOGNIZED_SIGNATURE_NID 101 +# define CT_R_UNSUPPORTED_ENTRY_TYPE 102 +# define CT_R_UNSUPPORTED_VERSION 103 + +# endif +#endif diff --git a/include/openssl/des.h b/include/openssl/des.h new file mode 100644 index 0000000..bf164b8 --- /dev/null +++ b/include/openssl/des.h @@ -0,0 +1,174 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DES_H +# define HEADER_DES_H + +# include + +# ifndef OPENSSL_NO_DES +# ifdef __cplusplus +extern "C" { +# endif +# include + +typedef unsigned int DES_LONG; + +# ifdef OPENSSL_BUILD_SHLIBCRYPTO +# undef OPENSSL_EXTERN +# define OPENSSL_EXTERN OPENSSL_EXPORT +# endif + +typedef unsigned char DES_cblock[8]; +typedef /* const */ unsigned char const_DES_cblock[8]; +/* + * With "const", gcc 2.8.1 on Solaris thinks that DES_cblock * and + * const_DES_cblock * are incompatible pointer types. + */ + +typedef struct DES_ks { + union { + DES_cblock cblock; + /* + * make sure things are correct size on machines with 8 byte longs + */ + DES_LONG deslong[2]; + } ks[16]; +} DES_key_schedule; + +# define DES_KEY_SZ (sizeof(DES_cblock)) +# define DES_SCHEDULE_SZ (sizeof(DES_key_schedule)) + +# define DES_ENCRYPT 1 +# define DES_DECRYPT 0 + +# define DES_CBC_MODE 0 +# define DES_PCBC_MODE 1 + +# define DES_ecb2_encrypt(i,o,k1,k2,e) \ + DES_ecb3_encrypt((i),(o),(k1),(k2),(k1),(e)) + +# define DES_ede2_cbc_encrypt(i,o,l,k1,k2,iv,e) \ + DES_ede3_cbc_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(e)) + +# define DES_ede2_cfb64_encrypt(i,o,l,k1,k2,iv,n,e) \ + DES_ede3_cfb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n),(e)) + +# define DES_ede2_ofb64_encrypt(i,o,l,k1,k2,iv,n) \ + DES_ede3_ofb64_encrypt((i),(o),(l),(k1),(k2),(k1),(iv),(n)) + +OPENSSL_DECLARE_GLOBAL(int, DES_check_key); /* defaults to false */ +# define DES_check_key OPENSSL_GLOBAL_REF(DES_check_key) + +const char *DES_options(void); +void DES_ecb3_encrypt(const_DES_cblock *input, DES_cblock *output, + DES_key_schedule *ks1, DES_key_schedule *ks2, + DES_key_schedule *ks3, int enc); +DES_LONG DES_cbc_cksum(const unsigned char *input, DES_cblock *output, + long length, DES_key_schedule *schedule, + const_DES_cblock *ivec); +/* DES_cbc_encrypt does not update the IV! Use DES_ncbc_encrypt instead. */ +void DES_cbc_encrypt(const unsigned char *input, unsigned char *output, + long length, DES_key_schedule *schedule, + DES_cblock *ivec, int enc); +void DES_ncbc_encrypt(const unsigned char *input, unsigned char *output, + long length, DES_key_schedule *schedule, + DES_cblock *ivec, int enc); +void DES_xcbc_encrypt(const unsigned char *input, unsigned char *output, + long length, DES_key_schedule *schedule, + DES_cblock *ivec, const_DES_cblock *inw, + const_DES_cblock *outw, int enc); +void DES_cfb_encrypt(const unsigned char *in, unsigned char *out, int numbits, + long length, DES_key_schedule *schedule, + DES_cblock *ivec, int enc); +void DES_ecb_encrypt(const_DES_cblock *input, DES_cblock *output, + DES_key_schedule *ks, int enc); + +/* + * This is the DES encryption function that gets called by just about every + * other DES routine in the library. You should not use this function except + * to implement 'modes' of DES. I say this because the functions that call + * this routine do the conversion from 'char *' to long, and this needs to be + * done to make sure 'non-aligned' memory access do not occur. The + * characters are loaded 'little endian'. Data is a pointer to 2 unsigned + * long's and ks is the DES_key_schedule to use. enc, is non zero specifies + * encryption, zero if decryption. + */ +void DES_encrypt1(DES_LONG *data, DES_key_schedule *ks, int enc); + +/* + * This functions is the same as DES_encrypt1() except that the DES initial + * permutation (IP) and final permutation (FP) have been left out. As for + * DES_encrypt1(), you should not use this function. It is used by the + * routines in the library that implement triple DES. IP() DES_encrypt2() + * DES_encrypt2() DES_encrypt2() FP() is the same as DES_encrypt1() + * DES_encrypt1() DES_encrypt1() except faster :-). + */ +void DES_encrypt2(DES_LONG *data, DES_key_schedule *ks, int enc); + +void DES_encrypt3(DES_LONG *data, DES_key_schedule *ks1, + DES_key_schedule *ks2, DES_key_schedule *ks3); +void DES_decrypt3(DES_LONG *data, DES_key_schedule *ks1, + DES_key_schedule *ks2, DES_key_schedule *ks3); +void DES_ede3_cbc_encrypt(const unsigned char *input, unsigned char *output, + long length, + DES_key_schedule *ks1, DES_key_schedule *ks2, + DES_key_schedule *ks3, DES_cblock *ivec, int enc); +void DES_ede3_cfb64_encrypt(const unsigned char *in, unsigned char *out, + long length, DES_key_schedule *ks1, + DES_key_schedule *ks2, DES_key_schedule *ks3, + DES_cblock *ivec, int *num, int enc); +void DES_ede3_cfb_encrypt(const unsigned char *in, unsigned char *out, + int numbits, long length, DES_key_schedule *ks1, + DES_key_schedule *ks2, DES_key_schedule *ks3, + DES_cblock *ivec, int enc); +void DES_ede3_ofb64_encrypt(const unsigned char *in, unsigned char *out, + long length, DES_key_schedule *ks1, + DES_key_schedule *ks2, DES_key_schedule *ks3, + DES_cblock *ivec, int *num); +char *DES_fcrypt(const char *buf, const char *salt, char *ret); +char *DES_crypt(const char *buf, const char *salt); +void DES_ofb_encrypt(const unsigned char *in, unsigned char *out, int numbits, + long length, DES_key_schedule *schedule, + DES_cblock *ivec); +void DES_pcbc_encrypt(const unsigned char *input, unsigned char *output, + long length, DES_key_schedule *schedule, + DES_cblock *ivec, int enc); +DES_LONG DES_quad_cksum(const unsigned char *input, DES_cblock output[], + long length, int out_count, DES_cblock *seed); +int DES_random_key(DES_cblock *ret); +void DES_set_odd_parity(DES_cblock *key); +int DES_check_key_parity(const_DES_cblock *key); +int DES_is_weak_key(const_DES_cblock *key); +/* + * DES_set_key (= set_key = DES_key_sched = key_sched) calls + * DES_set_key_checked if global variable DES_check_key is set, + * DES_set_key_unchecked otherwise. + */ +int DES_set_key(const_DES_cblock *key, DES_key_schedule *schedule); +int DES_key_sched(const_DES_cblock *key, DES_key_schedule *schedule); +int DES_set_key_checked(const_DES_cblock *key, DES_key_schedule *schedule); +void DES_set_key_unchecked(const_DES_cblock *key, DES_key_schedule *schedule); +void DES_string_to_key(const char *str, DES_cblock *key); +void DES_string_to_2keys(const char *str, DES_cblock *key1, DES_cblock *key2); +void DES_cfb64_encrypt(const unsigned char *in, unsigned char *out, + long length, DES_key_schedule *schedule, + DES_cblock *ivec, int *num, int enc); +void DES_ofb64_encrypt(const unsigned char *in, unsigned char *out, + long length, DES_key_schedule *schedule, + DES_cblock *ivec, int *num); + +# define DES_fixup_key_parity DES_set_odd_parity + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/dh.h b/include/openssl/dh.h new file mode 100644 index 0000000..f9d793a --- /dev/null +++ b/include/openssl/dh.h @@ -0,0 +1,340 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DH_H +# define HEADER_DH_H + +# include + +# ifndef OPENSSL_NO_DH +# include +# include +# include +# include +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# endif +# include + +# ifdef __cplusplus +extern "C" { +# endif + +# ifndef OPENSSL_DH_MAX_MODULUS_BITS +# define OPENSSL_DH_MAX_MODULUS_BITS 10000 +# endif + +# define OPENSSL_DH_FIPS_MIN_MODULUS_BITS 1024 + +# define DH_FLAG_CACHE_MONT_P 0x01 + +# if OPENSSL_API_COMPAT < 0x10100000L +/* + * Does nothing. Previously this switched off constant time behaviour. + */ +# define DH_FLAG_NO_EXP_CONSTTIME 0x00 +# endif + +/* + * If this flag is set the DH method is FIPS compliant and can be used in + * FIPS mode. This is set in the validated module method. If an application + * sets this flag in its own methods it is its responsibility to ensure the + * result is compliant. + */ + +# define DH_FLAG_FIPS_METHOD 0x0400 + +/* + * If this flag is set the operations normally disabled in FIPS mode are + * permitted it is then the applications responsibility to ensure that the + * usage is compliant. + */ + +# define DH_FLAG_NON_FIPS_ALLOW 0x0400 + +/* Already defined in ossl_typ.h */ +/* typedef struct dh_st DH; */ +/* typedef struct dh_method DH_METHOD; */ + +DECLARE_ASN1_ITEM(DHparams) + +# define DH_GENERATOR_2 2 +/* #define DH_GENERATOR_3 3 */ +# define DH_GENERATOR_5 5 + +/* DH_check error codes */ +# define DH_CHECK_P_NOT_PRIME 0x01 +# define DH_CHECK_P_NOT_SAFE_PRIME 0x02 +# define DH_UNABLE_TO_CHECK_GENERATOR 0x04 +# define DH_NOT_SUITABLE_GENERATOR 0x08 +# define DH_CHECK_Q_NOT_PRIME 0x10 +# define DH_CHECK_INVALID_Q_VALUE 0x20 +# define DH_CHECK_INVALID_J_VALUE 0x40 + +/* DH_check_pub_key error codes */ +# define DH_CHECK_PUBKEY_TOO_SMALL 0x01 +# define DH_CHECK_PUBKEY_TOO_LARGE 0x02 +# define DH_CHECK_PUBKEY_INVALID 0x04 + +/* + * primes p where (p-1)/2 is prime too are called "safe"; we define this for + * backward compatibility: + */ +# define DH_CHECK_P_NOT_STRONG_PRIME DH_CHECK_P_NOT_SAFE_PRIME + +# define d2i_DHparams_fp(fp,x) \ + (DH *)ASN1_d2i_fp((char *(*)())DH_new, \ + (char *(*)())d2i_DHparams, \ + (fp), \ + (unsigned char **)(x)) +# define i2d_DHparams_fp(fp,x) \ + ASN1_i2d_fp(i2d_DHparams,(fp), (unsigned char *)(x)) +# define d2i_DHparams_bio(bp,x) \ + ASN1_d2i_bio_of(DH, DH_new, d2i_DHparams, bp, x) +# define i2d_DHparams_bio(bp,x) \ + ASN1_i2d_bio_of_const(DH,i2d_DHparams,bp,x) + +# define d2i_DHxparams_fp(fp,x) \ + (DH *)ASN1_d2i_fp((char *(*)())DH_new, \ + (char *(*)())d2i_DHxparams, \ + (fp), \ + (unsigned char **)(x)) +# define i2d_DHxparams_fp(fp,x) \ + ASN1_i2d_fp(i2d_DHxparams,(fp), (unsigned char *)(x)) +# define d2i_DHxparams_bio(bp,x) \ + ASN1_d2i_bio_of(DH, DH_new, d2i_DHxparams, bp, x) +# define i2d_DHxparams_bio(bp,x) \ + ASN1_i2d_bio_of_const(DH, i2d_DHxparams, bp, x) + +DH *DHparams_dup(DH *); + +const DH_METHOD *DH_OpenSSL(void); + +void DH_set_default_method(const DH_METHOD *meth); +const DH_METHOD *DH_get_default_method(void); +int DH_set_method(DH *dh, const DH_METHOD *meth); +DH *DH_new_method(ENGINE *engine); + +DH *DH_new(void); +void DH_free(DH *dh); +int DH_up_ref(DH *dh); +int DH_bits(const DH *dh); +int DH_size(const DH *dh); +int DH_security_bits(const DH *dh); +#define DH_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_DH, l, p, newf, dupf, freef) +int DH_set_ex_data(DH *d, int idx, void *arg); +void *DH_get_ex_data(DH *d, int idx); + +/* Deprecated version */ +DEPRECATEDIN_0_9_8(DH *DH_generate_parameters(int prime_len, int generator, + void (*callback) (int, int, + void *), + void *cb_arg)) + +/* New version */ +int DH_generate_parameters_ex(DH *dh, int prime_len, int generator, + BN_GENCB *cb); + +int DH_check_params_ex(const DH *dh); +int DH_check_ex(const DH *dh); +int DH_check_pub_key_ex(const DH *dh, const BIGNUM *pub_key); +int DH_check_params(const DH *dh, int *ret); +int DH_check(const DH *dh, int *codes); +int DH_check_pub_key(const DH *dh, const BIGNUM *pub_key, int *codes); +int DH_generate_key(DH *dh); +int DH_compute_key(unsigned char *key, const BIGNUM *pub_key, DH *dh); +int DH_compute_key_padded(unsigned char *key, const BIGNUM *pub_key, DH *dh); +DH *d2i_DHparams(DH **a, const unsigned char **pp, long length); +int i2d_DHparams(const DH *a, unsigned char **pp); +DH *d2i_DHxparams(DH **a, const unsigned char **pp, long length); +int i2d_DHxparams(const DH *a, unsigned char **pp); +# ifndef OPENSSL_NO_STDIO +int DHparams_print_fp(FILE *fp, const DH *x); +# endif +int DHparams_print(BIO *bp, const DH *x); + +/* RFC 5114 parameters */ +DH *DH_get_1024_160(void); +DH *DH_get_2048_224(void); +DH *DH_get_2048_256(void); + +/* Named parameters, currently RFC7919 */ +DH *DH_new_by_nid(int nid); +int DH_get_nid(const DH *dh); + +# ifndef OPENSSL_NO_CMS +/* RFC2631 KDF */ +int DH_KDF_X9_42(unsigned char *out, size_t outlen, + const unsigned char *Z, size_t Zlen, + ASN1_OBJECT *key_oid, + const unsigned char *ukm, size_t ukmlen, const EVP_MD *md); +# endif + +void DH_get0_pqg(const DH *dh, + const BIGNUM **p, const BIGNUM **q, const BIGNUM **g); +int DH_set0_pqg(DH *dh, BIGNUM *p, BIGNUM *q, BIGNUM *g); +void DH_get0_key(const DH *dh, + const BIGNUM **pub_key, const BIGNUM **priv_key); +int DH_set0_key(DH *dh, BIGNUM *pub_key, BIGNUM *priv_key); +const BIGNUM *DH_get0_p(const DH *dh); +const BIGNUM *DH_get0_q(const DH *dh); +const BIGNUM *DH_get0_g(const DH *dh); +const BIGNUM *DH_get0_priv_key(const DH *dh); +const BIGNUM *DH_get0_pub_key(const DH *dh); +void DH_clear_flags(DH *dh, int flags); +int DH_test_flags(const DH *dh, int flags); +void DH_set_flags(DH *dh, int flags); +ENGINE *DH_get0_engine(DH *d); +long DH_get_length(const DH *dh); +int DH_set_length(DH *dh, long length); + +DH_METHOD *DH_meth_new(const char *name, int flags); +void DH_meth_free(DH_METHOD *dhm); +DH_METHOD *DH_meth_dup(const DH_METHOD *dhm); +const char *DH_meth_get0_name(const DH_METHOD *dhm); +int DH_meth_set1_name(DH_METHOD *dhm, const char *name); +int DH_meth_get_flags(const DH_METHOD *dhm); +int DH_meth_set_flags(DH_METHOD *dhm, int flags); +void *DH_meth_get0_app_data(const DH_METHOD *dhm); +int DH_meth_set0_app_data(DH_METHOD *dhm, void *app_data); +int (*DH_meth_get_generate_key(const DH_METHOD *dhm)) (DH *); +int DH_meth_set_generate_key(DH_METHOD *dhm, int (*generate_key) (DH *)); +int (*DH_meth_get_compute_key(const DH_METHOD *dhm)) + (unsigned char *key, const BIGNUM *pub_key, DH *dh); +int DH_meth_set_compute_key(DH_METHOD *dhm, + int (*compute_key) (unsigned char *key, const BIGNUM *pub_key, DH *dh)); +int (*DH_meth_get_bn_mod_exp(const DH_METHOD *dhm)) + (const DH *, BIGNUM *, const BIGNUM *, const BIGNUM *, const BIGNUM *, + BN_CTX *, BN_MONT_CTX *); +int DH_meth_set_bn_mod_exp(DH_METHOD *dhm, + int (*bn_mod_exp) (const DH *, BIGNUM *, const BIGNUM *, const BIGNUM *, + const BIGNUM *, BN_CTX *, BN_MONT_CTX *)); +int (*DH_meth_get_init(const DH_METHOD *dhm))(DH *); +int DH_meth_set_init(DH_METHOD *dhm, int (*init)(DH *)); +int (*DH_meth_get_finish(const DH_METHOD *dhm)) (DH *); +int DH_meth_set_finish(DH_METHOD *dhm, int (*finish) (DH *)); +int (*DH_meth_get_generate_params(const DH_METHOD *dhm)) + (DH *, int, int, BN_GENCB *); +int DH_meth_set_generate_params(DH_METHOD *dhm, + int (*generate_params) (DH *, int, int, BN_GENCB *)); + + +# define EVP_PKEY_CTX_set_dh_paramgen_prime_len(ctx, len) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DH, EVP_PKEY_OP_PARAMGEN, \ + EVP_PKEY_CTRL_DH_PARAMGEN_PRIME_LEN, len, NULL) + +# define EVP_PKEY_CTX_set_dh_paramgen_subprime_len(ctx, len) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DH, EVP_PKEY_OP_PARAMGEN, \ + EVP_PKEY_CTRL_DH_PARAMGEN_SUBPRIME_LEN, len, NULL) + +# define EVP_PKEY_CTX_set_dh_paramgen_type(ctx, typ) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DH, EVP_PKEY_OP_PARAMGEN, \ + EVP_PKEY_CTRL_DH_PARAMGEN_TYPE, typ, NULL) + +# define EVP_PKEY_CTX_set_dh_paramgen_generator(ctx, gen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DH, EVP_PKEY_OP_PARAMGEN, \ + EVP_PKEY_CTRL_DH_PARAMGEN_GENERATOR, gen, NULL) + +# define EVP_PKEY_CTX_set_dh_rfc5114(ctx, gen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, EVP_PKEY_OP_PARAMGEN, \ + EVP_PKEY_CTRL_DH_RFC5114, gen, NULL) + +# define EVP_PKEY_CTX_set_dhx_rfc5114(ctx, gen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, EVP_PKEY_OP_PARAMGEN, \ + EVP_PKEY_CTRL_DH_RFC5114, gen, NULL) + +# define EVP_PKEY_CTX_set_dh_nid(ctx, nid) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DH, \ + EVP_PKEY_OP_PARAMGEN | EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_DH_NID, nid, NULL) + +# define EVP_PKEY_CTX_set_dh_pad(ctx, pad) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DH, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_DH_PAD, pad, NULL) + +# define EVP_PKEY_CTX_set_dh_kdf_type(ctx, kdf) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_DH_KDF_TYPE, kdf, NULL) + +# define EVP_PKEY_CTX_get_dh_kdf_type(ctx) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_DH_KDF_TYPE, -2, NULL) + +# define EVP_PKEY_CTX_set0_dh_kdf_oid(ctx, oid) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_DH_KDF_OID, 0, (void *)(oid)) + +# define EVP_PKEY_CTX_get0_dh_kdf_oid(ctx, poid) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_GET_DH_KDF_OID, 0, (void *)(poid)) + +# define EVP_PKEY_CTX_set_dh_kdf_md(ctx, md) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_DH_KDF_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_get_dh_kdf_md(ctx, pmd) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_GET_DH_KDF_MD, 0, (void *)(pmd)) + +# define EVP_PKEY_CTX_set_dh_kdf_outlen(ctx, len) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_DH_KDF_OUTLEN, len, NULL) + +# define EVP_PKEY_CTX_get_dh_kdf_outlen(ctx, plen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_GET_DH_KDF_OUTLEN, 0, (void *)(plen)) + +# define EVP_PKEY_CTX_set0_dh_kdf_ukm(ctx, p, plen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_DH_KDF_UKM, plen, (void *)(p)) + +# define EVP_PKEY_CTX_get0_dh_kdf_ukm(ctx, p) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DHX, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_GET_DH_KDF_UKM, 0, (void *)(p)) + +# define EVP_PKEY_CTRL_DH_PARAMGEN_PRIME_LEN (EVP_PKEY_ALG_CTRL + 1) +# define EVP_PKEY_CTRL_DH_PARAMGEN_GENERATOR (EVP_PKEY_ALG_CTRL + 2) +# define EVP_PKEY_CTRL_DH_RFC5114 (EVP_PKEY_ALG_CTRL + 3) +# define EVP_PKEY_CTRL_DH_PARAMGEN_SUBPRIME_LEN (EVP_PKEY_ALG_CTRL + 4) +# define EVP_PKEY_CTRL_DH_PARAMGEN_TYPE (EVP_PKEY_ALG_CTRL + 5) +# define EVP_PKEY_CTRL_DH_KDF_TYPE (EVP_PKEY_ALG_CTRL + 6) +# define EVP_PKEY_CTRL_DH_KDF_MD (EVP_PKEY_ALG_CTRL + 7) +# define EVP_PKEY_CTRL_GET_DH_KDF_MD (EVP_PKEY_ALG_CTRL + 8) +# define EVP_PKEY_CTRL_DH_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 9) +# define EVP_PKEY_CTRL_GET_DH_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 10) +# define EVP_PKEY_CTRL_DH_KDF_UKM (EVP_PKEY_ALG_CTRL + 11) +# define EVP_PKEY_CTRL_GET_DH_KDF_UKM (EVP_PKEY_ALG_CTRL + 12) +# define EVP_PKEY_CTRL_DH_KDF_OID (EVP_PKEY_ALG_CTRL + 13) +# define EVP_PKEY_CTRL_GET_DH_KDF_OID (EVP_PKEY_ALG_CTRL + 14) +# define EVP_PKEY_CTRL_DH_NID (EVP_PKEY_ALG_CTRL + 15) +# define EVP_PKEY_CTRL_DH_PAD (EVP_PKEY_ALG_CTRL + 16) + +/* KDF types */ +# define EVP_PKEY_DH_KDF_NONE 1 +# ifndef OPENSSL_NO_CMS +# define EVP_PKEY_DH_KDF_X9_42 2 +# endif + + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/dherr.h b/include/openssl/dherr.h new file mode 100644 index 0000000..98334c4 --- /dev/null +++ b/include/openssl/dherr.h @@ -0,0 +1,84 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DHERR_H +# define HEADER_DHERR_H + +# include + +# ifndef OPENSSL_NO_DH + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_DH_strings(void); + +/* + * DH function codes. + */ +# define DH_F_COMPUTE_KEY 102 +# define DH_F_DHPARAMS_PRINT_FP 101 +# define DH_F_DH_BUILTIN_GENPARAMS 106 +# define DH_F_DH_CHECK_EX 121 +# define DH_F_DH_CHECK_PARAMS_EX 122 +# define DH_F_DH_CHECK_PUB_KEY_EX 123 +# define DH_F_DH_CMS_DECRYPT 114 +# define DH_F_DH_CMS_SET_PEERKEY 115 +# define DH_F_DH_CMS_SET_SHARED_INFO 116 +# define DH_F_DH_METH_DUP 117 +# define DH_F_DH_METH_NEW 118 +# define DH_F_DH_METH_SET1_NAME 119 +# define DH_F_DH_NEW_BY_NID 104 +# define DH_F_DH_NEW_METHOD 105 +# define DH_F_DH_PARAM_DECODE 107 +# define DH_F_DH_PKEY_PUBLIC_CHECK 124 +# define DH_F_DH_PRIV_DECODE 110 +# define DH_F_DH_PRIV_ENCODE 111 +# define DH_F_DH_PUB_DECODE 108 +# define DH_F_DH_PUB_ENCODE 109 +# define DH_F_DO_DH_PRINT 100 +# define DH_F_GENERATE_KEY 103 +# define DH_F_PKEY_DH_CTRL_STR 120 +# define DH_F_PKEY_DH_DERIVE 112 +# define DH_F_PKEY_DH_INIT 125 +# define DH_F_PKEY_DH_KEYGEN 113 + +/* + * DH reason codes. + */ +# define DH_R_BAD_GENERATOR 101 +# define DH_R_BN_DECODE_ERROR 109 +# define DH_R_BN_ERROR 106 +# define DH_R_CHECK_INVALID_J_VALUE 115 +# define DH_R_CHECK_INVALID_Q_VALUE 116 +# define DH_R_CHECK_PUBKEY_INVALID 122 +# define DH_R_CHECK_PUBKEY_TOO_LARGE 123 +# define DH_R_CHECK_PUBKEY_TOO_SMALL 124 +# define DH_R_CHECK_P_NOT_PRIME 117 +# define DH_R_CHECK_P_NOT_SAFE_PRIME 118 +# define DH_R_CHECK_Q_NOT_PRIME 119 +# define DH_R_DECODE_ERROR 104 +# define DH_R_INVALID_PARAMETER_NAME 110 +# define DH_R_INVALID_PARAMETER_NID 114 +# define DH_R_INVALID_PUBKEY 102 +# define DH_R_KDF_PARAMETER_ERROR 112 +# define DH_R_KEYS_NOT_SET 108 +# define DH_R_MISSING_PUBKEY 125 +# define DH_R_MODULUS_TOO_LARGE 103 +# define DH_R_NOT_SUITABLE_GENERATOR 120 +# define DH_R_NO_PARAMETERS_SET 107 +# define DH_R_NO_PRIVATE_VALUE 100 +# define DH_R_PARAMETER_ENCODING_ERROR 105 +# define DH_R_PEER_KEY_ERROR 111 +# define DH_R_SHARED_INFO_ERROR 113 +# define DH_R_UNABLE_TO_CHECK_GENERATOR 121 + +# endif +#endif diff --git a/include/openssl/dsa.h b/include/openssl/dsa.h new file mode 100644 index 0000000..34dc83d --- /dev/null +++ b/include/openssl/dsa.h @@ -0,0 +1,238 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DSA_H +# define HEADER_DSA_H + +# include + +# ifndef OPENSSL_NO_DSA +# ifdef __cplusplus +extern "C" { +# endif +# include +# include +# include +# include +# include +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# endif +# include + +# ifndef OPENSSL_DSA_MAX_MODULUS_BITS +# define OPENSSL_DSA_MAX_MODULUS_BITS 10000 +# endif + +# define OPENSSL_DSA_FIPS_MIN_MODULUS_BITS 1024 + +# define DSA_FLAG_CACHE_MONT_P 0x01 +# if OPENSSL_API_COMPAT < 0x10100000L +/* + * Does nothing. Previously this switched off constant time behaviour. + */ +# define DSA_FLAG_NO_EXP_CONSTTIME 0x00 +# endif + +/* + * If this flag is set the DSA method is FIPS compliant and can be used in + * FIPS mode. This is set in the validated module method. If an application + * sets this flag in its own methods it is its responsibility to ensure the + * result is compliant. + */ + +# define DSA_FLAG_FIPS_METHOD 0x0400 + +/* + * If this flag is set the operations normally disabled in FIPS mode are + * permitted it is then the applications responsibility to ensure that the + * usage is compliant. + */ + +# define DSA_FLAG_NON_FIPS_ALLOW 0x0400 +# define DSA_FLAG_FIPS_CHECKED 0x0800 + +/* Already defined in ossl_typ.h */ +/* typedef struct dsa_st DSA; */ +/* typedef struct dsa_method DSA_METHOD; */ + +typedef struct DSA_SIG_st DSA_SIG; + +# define d2i_DSAparams_fp(fp,x) (DSA *)ASN1_d2i_fp((char *(*)())DSA_new, \ + (char *(*)())d2i_DSAparams,(fp),(unsigned char **)(x)) +# define i2d_DSAparams_fp(fp,x) ASN1_i2d_fp(i2d_DSAparams,(fp), \ + (unsigned char *)(x)) +# define d2i_DSAparams_bio(bp,x) ASN1_d2i_bio_of(DSA,DSA_new,d2i_DSAparams,bp,x) +# define i2d_DSAparams_bio(bp,x) ASN1_i2d_bio_of_const(DSA,i2d_DSAparams,bp,x) + +DSA *DSAparams_dup(DSA *x); +DSA_SIG *DSA_SIG_new(void); +void DSA_SIG_free(DSA_SIG *a); +int i2d_DSA_SIG(const DSA_SIG *a, unsigned char **pp); +DSA_SIG *d2i_DSA_SIG(DSA_SIG **v, const unsigned char **pp, long length); +void DSA_SIG_get0(const DSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps); +int DSA_SIG_set0(DSA_SIG *sig, BIGNUM *r, BIGNUM *s); + +DSA_SIG *DSA_do_sign(const unsigned char *dgst, int dlen, DSA *dsa); +int DSA_do_verify(const unsigned char *dgst, int dgst_len, + DSA_SIG *sig, DSA *dsa); + +const DSA_METHOD *DSA_OpenSSL(void); + +void DSA_set_default_method(const DSA_METHOD *); +const DSA_METHOD *DSA_get_default_method(void); +int DSA_set_method(DSA *dsa, const DSA_METHOD *); +const DSA_METHOD *DSA_get_method(DSA *d); + +DSA *DSA_new(void); +DSA *DSA_new_method(ENGINE *engine); +void DSA_free(DSA *r); +/* "up" the DSA object's reference count */ +int DSA_up_ref(DSA *r); +int DSA_size(const DSA *); +int DSA_bits(const DSA *d); +int DSA_security_bits(const DSA *d); + /* next 4 return -1 on error */ +DEPRECATEDIN_1_2_0(int DSA_sign_setup(DSA *dsa, BN_CTX *ctx_in, BIGNUM **kinvp, BIGNUM **rp)) +int DSA_sign(int type, const unsigned char *dgst, int dlen, + unsigned char *sig, unsigned int *siglen, DSA *dsa); +int DSA_verify(int type, const unsigned char *dgst, int dgst_len, + const unsigned char *sigbuf, int siglen, DSA *dsa); +#define DSA_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_DSA, l, p, newf, dupf, freef) +int DSA_set_ex_data(DSA *d, int idx, void *arg); +void *DSA_get_ex_data(DSA *d, int idx); + +DSA *d2i_DSAPublicKey(DSA **a, const unsigned char **pp, long length); +DSA *d2i_DSAPrivateKey(DSA **a, const unsigned char **pp, long length); +DSA *d2i_DSAparams(DSA **a, const unsigned char **pp, long length); + +/* Deprecated version */ +DEPRECATEDIN_0_9_8(DSA *DSA_generate_parameters(int bits, + unsigned char *seed, + int seed_len, + int *counter_ret, + unsigned long *h_ret, void + (*callback) (int, int, + void *), + void *cb_arg)) + +/* New version */ +int DSA_generate_parameters_ex(DSA *dsa, int bits, + const unsigned char *seed, int seed_len, + int *counter_ret, unsigned long *h_ret, + BN_GENCB *cb); + +int DSA_generate_key(DSA *a); +int i2d_DSAPublicKey(const DSA *a, unsigned char **pp); +int i2d_DSAPrivateKey(const DSA *a, unsigned char **pp); +int i2d_DSAparams(const DSA *a, unsigned char **pp); + +int DSAparams_print(BIO *bp, const DSA *x); +int DSA_print(BIO *bp, const DSA *x, int off); +# ifndef OPENSSL_NO_STDIO +int DSAparams_print_fp(FILE *fp, const DSA *x); +int DSA_print_fp(FILE *bp, const DSA *x, int off); +# endif + +# define DSS_prime_checks 64 +/* + * Primality test according to FIPS PUB 186-4, Appendix C.3. Since we only + * have one value here we set the number of checks to 64 which is the 128 bit + * security level that is the highest level and valid for creating a 3072 bit + * DSA key. + */ +# define DSA_is_prime(n, callback, cb_arg) \ + BN_is_prime(n, DSS_prime_checks, callback, NULL, cb_arg) + +# ifndef OPENSSL_NO_DH +/* + * Convert DSA structure (key or just parameters) into DH structure (be + * careful to avoid small subgroup attacks when using this!) + */ +DH *DSA_dup_DH(const DSA *r); +# endif + +# define EVP_PKEY_CTX_set_dsa_paramgen_bits(ctx, nbits) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_DSA, EVP_PKEY_OP_PARAMGEN, \ + EVP_PKEY_CTRL_DSA_PARAMGEN_BITS, nbits, NULL) + +# define EVP_PKEY_CTRL_DSA_PARAMGEN_BITS (EVP_PKEY_ALG_CTRL + 1) +# define EVP_PKEY_CTRL_DSA_PARAMGEN_Q_BITS (EVP_PKEY_ALG_CTRL + 2) +# define EVP_PKEY_CTRL_DSA_PARAMGEN_MD (EVP_PKEY_ALG_CTRL + 3) + +void DSA_get0_pqg(const DSA *d, + const BIGNUM **p, const BIGNUM **q, const BIGNUM **g); +int DSA_set0_pqg(DSA *d, BIGNUM *p, BIGNUM *q, BIGNUM *g); +void DSA_get0_key(const DSA *d, + const BIGNUM **pub_key, const BIGNUM **priv_key); +int DSA_set0_key(DSA *d, BIGNUM *pub_key, BIGNUM *priv_key); +const BIGNUM *DSA_get0_p(const DSA *d); +const BIGNUM *DSA_get0_q(const DSA *d); +const BIGNUM *DSA_get0_g(const DSA *d); +const BIGNUM *DSA_get0_pub_key(const DSA *d); +const BIGNUM *DSA_get0_priv_key(const DSA *d); +void DSA_clear_flags(DSA *d, int flags); +int DSA_test_flags(const DSA *d, int flags); +void DSA_set_flags(DSA *d, int flags); +ENGINE *DSA_get0_engine(DSA *d); + +DSA_METHOD *DSA_meth_new(const char *name, int flags); +void DSA_meth_free(DSA_METHOD *dsam); +DSA_METHOD *DSA_meth_dup(const DSA_METHOD *dsam); +const char *DSA_meth_get0_name(const DSA_METHOD *dsam); +int DSA_meth_set1_name(DSA_METHOD *dsam, const char *name); +int DSA_meth_get_flags(const DSA_METHOD *dsam); +int DSA_meth_set_flags(DSA_METHOD *dsam, int flags); +void *DSA_meth_get0_app_data(const DSA_METHOD *dsam); +int DSA_meth_set0_app_data(DSA_METHOD *dsam, void *app_data); +DSA_SIG *(*DSA_meth_get_sign(const DSA_METHOD *dsam)) + (const unsigned char *, int, DSA *); +int DSA_meth_set_sign(DSA_METHOD *dsam, + DSA_SIG *(*sign) (const unsigned char *, int, DSA *)); +int (*DSA_meth_get_sign_setup(const DSA_METHOD *dsam)) + (DSA *, BN_CTX *, BIGNUM **, BIGNUM **); +int DSA_meth_set_sign_setup(DSA_METHOD *dsam, + int (*sign_setup) (DSA *, BN_CTX *, BIGNUM **, BIGNUM **)); +int (*DSA_meth_get_verify(const DSA_METHOD *dsam)) + (const unsigned char *, int, DSA_SIG *, DSA *); +int DSA_meth_set_verify(DSA_METHOD *dsam, + int (*verify) (const unsigned char *, int, DSA_SIG *, DSA *)); +int (*DSA_meth_get_mod_exp(const DSA_METHOD *dsam)) + (DSA *, BIGNUM *, const BIGNUM *, const BIGNUM *, const BIGNUM *, + const BIGNUM *, const BIGNUM *, BN_CTX *, BN_MONT_CTX *); +int DSA_meth_set_mod_exp(DSA_METHOD *dsam, + int (*mod_exp) (DSA *, BIGNUM *, const BIGNUM *, const BIGNUM *, + const BIGNUM *, const BIGNUM *, const BIGNUM *, BN_CTX *, + BN_MONT_CTX *)); +int (*DSA_meth_get_bn_mod_exp(const DSA_METHOD *dsam)) + (DSA *, BIGNUM *, const BIGNUM *, const BIGNUM *, const BIGNUM *, + BN_CTX *, BN_MONT_CTX *); +int DSA_meth_set_bn_mod_exp(DSA_METHOD *dsam, + int (*bn_mod_exp) (DSA *, BIGNUM *, const BIGNUM *, const BIGNUM *, + const BIGNUM *, BN_CTX *, BN_MONT_CTX *)); +int (*DSA_meth_get_init(const DSA_METHOD *dsam))(DSA *); +int DSA_meth_set_init(DSA_METHOD *dsam, int (*init)(DSA *)); +int (*DSA_meth_get_finish(const DSA_METHOD *dsam)) (DSA *); +int DSA_meth_set_finish(DSA_METHOD *dsam, int (*finish) (DSA *)); +int (*DSA_meth_get_paramgen(const DSA_METHOD *dsam)) + (DSA *, int, const unsigned char *, int, int *, unsigned long *, + BN_GENCB *); +int DSA_meth_set_paramgen(DSA_METHOD *dsam, + int (*paramgen) (DSA *, int, const unsigned char *, int, int *, + unsigned long *, BN_GENCB *)); +int (*DSA_meth_get_keygen(const DSA_METHOD *dsam)) (DSA *); +int DSA_meth_set_keygen(DSA_METHOD *dsam, int (*keygen) (DSA *)); + + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/dsaerr.h b/include/openssl/dsaerr.h new file mode 100644 index 0000000..915b515 --- /dev/null +++ b/include/openssl/dsaerr.h @@ -0,0 +1,67 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DSAERR_H +# define HEADER_DSAERR_H + +# include + +# ifndef OPENSSL_NO_DSA + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_DSA_strings(void); + +/* + * DSA function codes. + */ +# define DSA_F_DSAPARAMS_PRINT 100 +# define DSA_F_DSAPARAMS_PRINT_FP 101 +# define DSA_F_DSA_BUILTIN_PARAMGEN 125 +# define DSA_F_DSA_BUILTIN_PARAMGEN2 126 +# define DSA_F_DSA_DO_SIGN 112 +# define DSA_F_DSA_DO_VERIFY 113 +# define DSA_F_DSA_METH_DUP 127 +# define DSA_F_DSA_METH_NEW 128 +# define DSA_F_DSA_METH_SET1_NAME 129 +# define DSA_F_DSA_NEW_METHOD 103 +# define DSA_F_DSA_PARAM_DECODE 119 +# define DSA_F_DSA_PRINT_FP 105 +# define DSA_F_DSA_PRIV_DECODE 115 +# define DSA_F_DSA_PRIV_ENCODE 116 +# define DSA_F_DSA_PUB_DECODE 117 +# define DSA_F_DSA_PUB_ENCODE 118 +# define DSA_F_DSA_SIGN 106 +# define DSA_F_DSA_SIGN_SETUP 107 +# define DSA_F_DSA_SIG_NEW 102 +# define DSA_F_OLD_DSA_PRIV_DECODE 122 +# define DSA_F_PKEY_DSA_CTRL 120 +# define DSA_F_PKEY_DSA_CTRL_STR 104 +# define DSA_F_PKEY_DSA_KEYGEN 121 + +/* + * DSA reason codes. + */ +# define DSA_R_BAD_Q_VALUE 102 +# define DSA_R_BN_DECODE_ERROR 108 +# define DSA_R_BN_ERROR 109 +# define DSA_R_DECODE_ERROR 104 +# define DSA_R_INVALID_DIGEST_TYPE 106 +# define DSA_R_INVALID_PARAMETERS 112 +# define DSA_R_MISSING_PARAMETERS 101 +# define DSA_R_MODULUS_TOO_LARGE 103 +# define DSA_R_NO_PARAMETERS_SET 107 +# define DSA_R_PARAMETER_ENCODING_ERROR 105 +# define DSA_R_Q_NOT_PRIME 113 +# define DSA_R_SEED_LEN_SMALL 110 + +# endif +#endif diff --git a/include/openssl/dtls1.h b/include/openssl/dtls1.h new file mode 100644 index 0000000..a312e38 --- /dev/null +++ b/include/openssl/dtls1.h @@ -0,0 +1,55 @@ +/* + * Copyright 2005-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DTLS1_H +# define HEADER_DTLS1_H + +#ifdef __cplusplus +extern "C" { +#endif + +# define DTLS1_VERSION 0xFEFF +# define DTLS1_2_VERSION 0xFEFD +# define DTLS_MIN_VERSION DTLS1_VERSION +# define DTLS_MAX_VERSION DTLS1_2_VERSION +# define DTLS1_VERSION_MAJOR 0xFE + +# define DTLS1_BAD_VER 0x0100 + +/* Special value for method supporting multiple versions */ +# define DTLS_ANY_VERSION 0x1FFFF + +/* lengths of messages */ +/* + * Actually the max cookie length in DTLS is 255. But we can't change this now + * due to compatibility concerns. + */ +# define DTLS1_COOKIE_LENGTH 256 + +# define DTLS1_RT_HEADER_LENGTH 13 + +# define DTLS1_HM_HEADER_LENGTH 12 + +# define DTLS1_HM_BAD_FRAGMENT -2 +# define DTLS1_HM_FRAGMENT_RETRY -3 + +# define DTLS1_CCS_HEADER_LENGTH 1 + +# define DTLS1_AL_HEADER_LENGTH 2 + +/* Timeout multipliers (timeout slice is defined in apps/timeouts.h */ +# define DTLS1_TMO_READ_COUNT 2 +# define DTLS1_TMO_WRITE_COUNT 2 + +# define DTLS1_TMO_ALERT_COUNT 12 + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/e_os2.h b/include/openssl/e_os2.h new file mode 100644 index 0000000..e576357 --- /dev/null +++ b/include/openssl/e_os2.h @@ -0,0 +1,293 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_E_OS2_H +# define HEADER_E_OS2_H + +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/****************************************************************************** + * Detect operating systems. This probably needs completing. + * The result is that at least one OPENSSL_SYS_os macro should be defined. + * However, if none is defined, Unix is assumed. + **/ + +# define OPENSSL_SYS_UNIX + +/* --------------------- Microsoft operating systems ---------------------- */ + +/* + * Note that MSDOS actually denotes 32-bit environments running on top of + * MS-DOS, such as DJGPP one. + */ +# if defined(OPENSSL_SYS_MSDOS) +# undef OPENSSL_SYS_UNIX +# endif + +/* + * For 32 bit environment, there seems to be the CygWin environment and then + * all the others that try to do the same thing Microsoft does... + */ +/* + * UEFI lives here because it might be built with a Microsoft toolchain and + * we need to avoid the false positive match on Windows. + */ +# if defined(OPENSSL_SYS_UEFI) +# undef OPENSSL_SYS_UNIX +# elif defined(OPENSSL_SYS_UWIN) +# undef OPENSSL_SYS_UNIX +# define OPENSSL_SYS_WIN32_UWIN +# else +# if defined(__CYGWIN__) || defined(OPENSSL_SYS_CYGWIN) +# define OPENSSL_SYS_WIN32_CYGWIN +# else +# if defined(_WIN32) || defined(OPENSSL_SYS_WIN32) +# undef OPENSSL_SYS_UNIX +# if !defined(OPENSSL_SYS_WIN32) +# define OPENSSL_SYS_WIN32 +# endif +# endif +# if defined(_WIN64) || defined(OPENSSL_SYS_WIN64) +# undef OPENSSL_SYS_UNIX +# if !defined(OPENSSL_SYS_WIN64) +# define OPENSSL_SYS_WIN64 +# endif +# endif +# if defined(OPENSSL_SYS_WINNT) +# undef OPENSSL_SYS_UNIX +# endif +# if defined(OPENSSL_SYS_WINCE) +# undef OPENSSL_SYS_UNIX +# endif +# endif +# endif + +/* Anything that tries to look like Microsoft is "Windows" */ +# if defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_WIN64) || defined(OPENSSL_SYS_WINNT) || defined(OPENSSL_SYS_WINCE) +# undef OPENSSL_SYS_UNIX +# define OPENSSL_SYS_WINDOWS +# ifndef OPENSSL_SYS_MSDOS +# define OPENSSL_SYS_MSDOS +# endif +# endif + +/* + * DLL settings. This part is a bit tough, because it's up to the + * application implementor how he or she will link the application, so it + * requires some macro to be used. + */ +# ifdef OPENSSL_SYS_WINDOWS +# ifndef OPENSSL_OPT_WINDLL +# if defined(_WINDLL) /* This is used when building OpenSSL to + * indicate that DLL linkage should be used */ +# define OPENSSL_OPT_WINDLL +# endif +# endif +# endif + +/* ------------------------------- OpenVMS -------------------------------- */ +# if defined(__VMS) || defined(VMS) || defined(OPENSSL_SYS_VMS) +# if !defined(OPENSSL_SYS_VMS) +# undef OPENSSL_SYS_UNIX +# endif +# define OPENSSL_SYS_VMS +# if defined(__DECC) +# define OPENSSL_SYS_VMS_DECC +# elif defined(__DECCXX) +# define OPENSSL_SYS_VMS_DECC +# define OPENSSL_SYS_VMS_DECCXX +# else +# define OPENSSL_SYS_VMS_NODECC +# endif +# endif + +/* -------------------------------- Unix ---------------------------------- */ +# ifdef OPENSSL_SYS_UNIX +# if defined(linux) || defined(__linux__) && !defined(OPENSSL_SYS_LINUX) +# define OPENSSL_SYS_LINUX +# endif +# if defined(_AIX) && !defined(OPENSSL_SYS_AIX) +# define OPENSSL_SYS_AIX +# endif +# endif + +/* -------------------------------- VOS ----------------------------------- */ +# if defined(__VOS__) && !defined(OPENSSL_SYS_VOS) +# define OPENSSL_SYS_VOS +# ifdef __HPPA__ +# define OPENSSL_SYS_VOS_HPPA +# endif +# ifdef __IA32__ +# define OPENSSL_SYS_VOS_IA32 +# endif +# endif + +/** + * That's it for OS-specific stuff + *****************************************************************************/ + +/* Specials for I/O an exit */ +# ifdef OPENSSL_SYS_MSDOS +# define OPENSSL_UNISTD_IO +# define OPENSSL_DECLARE_EXIT extern void exit(int); +# else +# define OPENSSL_UNISTD_IO OPENSSL_UNISTD +# define OPENSSL_DECLARE_EXIT /* declared in unistd.h */ +# endif + +/*- + * OPENSSL_EXTERN is normally used to declare a symbol with possible extra + * attributes to handle its presence in a shared library. + * OPENSSL_EXPORT is used to define a symbol with extra possible attributes + * to make it visible in a shared library. + * Care needs to be taken when a header file is used both to declare and + * define symbols. Basically, for any library that exports some global + * variables, the following code must be present in the header file that + * declares them, before OPENSSL_EXTERN is used: + * + * #ifdef SOME_BUILD_FLAG_MACRO + * # undef OPENSSL_EXTERN + * # define OPENSSL_EXTERN OPENSSL_EXPORT + * #endif + * + * The default is to have OPENSSL_EXPORT and OPENSSL_EXTERN + * have some generally sensible values. + */ + +# if defined(OPENSSL_SYS_WINDOWS) && defined(OPENSSL_OPT_WINDLL) +# define OPENSSL_EXPORT extern __declspec(dllexport) +# define OPENSSL_EXTERN extern __declspec(dllimport) +# else +# define OPENSSL_EXPORT extern +# define OPENSSL_EXTERN extern +# endif + +/*- + * Macros to allow global variables to be reached through function calls when + * required (if a shared library version requires it, for example. + * The way it's done allows definitions like this: + * + * // in foobar.c + * OPENSSL_IMPLEMENT_GLOBAL(int,foobar,0) + * // in foobar.h + * OPENSSL_DECLARE_GLOBAL(int,foobar); + * #define foobar OPENSSL_GLOBAL_REF(foobar) + */ +# ifdef OPENSSL_EXPORT_VAR_AS_FUNCTION +# define OPENSSL_IMPLEMENT_GLOBAL(type,name,value) \ + type *_shadow_##name(void) \ + { static type _hide_##name=value; return &_hide_##name; } +# define OPENSSL_DECLARE_GLOBAL(type,name) type *_shadow_##name(void) +# define OPENSSL_GLOBAL_REF(name) (*(_shadow_##name())) +# else +# define OPENSSL_IMPLEMENT_GLOBAL(type,name,value) type _shadow_##name=value; +# define OPENSSL_DECLARE_GLOBAL(type,name) OPENSSL_EXPORT type _shadow_##name +# define OPENSSL_GLOBAL_REF(name) _shadow_##name +# endif + +# ifdef _WIN32 +# ifdef _WIN64 +# define ossl_ssize_t __int64 +# define OSSL_SSIZE_MAX _I64_MAX +# else +# define ossl_ssize_t int +# define OSSL_SSIZE_MAX INT_MAX +# endif +# endif + +# if defined(OPENSSL_SYS_UEFI) && !defined(ossl_ssize_t) +# define ossl_ssize_t INTN +# define OSSL_SSIZE_MAX MAX_INTN +# endif + +# ifndef ossl_ssize_t +# define ossl_ssize_t ssize_t +# if defined(SSIZE_MAX) +# define OSSL_SSIZE_MAX SSIZE_MAX +# elif defined(_POSIX_SSIZE_MAX) +# define OSSL_SSIZE_MAX _POSIX_SSIZE_MAX +# else +# define OSSL_SSIZE_MAX ((ssize_t)(SIZE_MAX>>1)) +# endif +# endif + +# ifdef DEBUG_UNUSED +# define __owur __attribute__((__warn_unused_result__)) +# else +# define __owur +# endif + +/* Standard integer types */ +# if defined(OPENSSL_SYS_UEFI) +typedef INT8 int8_t; +typedef UINT8 uint8_t; +typedef INT16 int16_t; +typedef UINT16 uint16_t; +typedef INT32 int32_t; +typedef UINT32 uint32_t; +typedef INT64 int64_t; +typedef UINT64 uint64_t; +# elif (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || \ + defined(__osf__) || defined(__sgi) || defined(__hpux) || \ + defined(OPENSSL_SYS_VMS) || defined (__OpenBSD__) +# include +# elif defined(_MSC_VER) && _MSC_VER<=1500 +/* + * minimally required typdefs for systems not supporting inttypes.h or + * stdint.h: currently just older VC++ + */ +typedef signed char int8_t; +typedef unsigned char uint8_t; +typedef short int16_t; +typedef unsigned short uint16_t; +typedef int int32_t; +typedef unsigned int uint32_t; +typedef __int64 int64_t; +typedef unsigned __int64 uint64_t; +# else +# include +# endif + +/* ossl_inline: portable inline definition usable in public headers */ +# if !defined(inline) && !defined(__cplusplus) +# if defined(__STDC_VERSION__) && __STDC_VERSION__>=199901L + /* just use inline */ +# define ossl_inline inline +# elif defined(__GNUC__) && __GNUC__>=2 +# define ossl_inline __inline__ +# elif defined(_MSC_VER) + /* + * Visual Studio: inline is available in C++ only, however + * __inline is available for C, see + * http://msdn.microsoft.com/en-us/library/z8y1yy88.aspx + */ +# define ossl_inline __inline +# else +# define ossl_inline +# endif +# else +# define ossl_inline inline +# endif + +# if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L +# define ossl_noreturn _Noreturn +# elif defined(__GNUC__) && __GNUC__ >= 2 +# define ossl_noreturn __attribute__((noreturn)) +# else +# define ossl_noreturn +# endif + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/ebcdic.h b/include/openssl/ebcdic.h new file mode 100644 index 0000000..aa01285 --- /dev/null +++ b/include/openssl/ebcdic.h @@ -0,0 +1,33 @@ +/* + * Copyright 1999-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_EBCDIC_H +# define HEADER_EBCDIC_H + +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* Avoid name clashes with other applications */ +# define os_toascii _openssl_os_toascii +# define os_toebcdic _openssl_os_toebcdic +# define ebcdic2ascii _openssl_ebcdic2ascii +# define ascii2ebcdic _openssl_ascii2ebcdic + +extern const unsigned char os_toascii[256]; +extern const unsigned char os_toebcdic[256]; +void *ebcdic2ascii(void *dest, const void *srce, size_t count); +void *ascii2ebcdic(void *dest, const void *srce, size_t count); + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/ec.h b/include/openssl/ec.h new file mode 100644 index 0000000..81c6820 --- /dev/null +++ b/include/openssl/ec.h @@ -0,0 +1,1467 @@ +/* + * Copyright 2002-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_EC_H +# define HEADER_EC_H + +# include + +# ifndef OPENSSL_NO_EC +# include +# include +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# endif +# include +# ifdef __cplusplus +extern "C" { +# endif + +# ifndef OPENSSL_ECC_MAX_FIELD_BITS +# define OPENSSL_ECC_MAX_FIELD_BITS 661 +# endif + +/** Enum for the point conversion form as defined in X9.62 (ECDSA) + * for the encoding of a elliptic curve point (x,y) */ +typedef enum { + /** the point is encoded as z||x, where the octet z specifies + * which solution of the quadratic equation y is */ + POINT_CONVERSION_COMPRESSED = 2, + /** the point is encoded as z||x||y, where z is the octet 0x04 */ + POINT_CONVERSION_UNCOMPRESSED = 4, + /** the point is encoded as z||x||y, where the octet z specifies + * which solution of the quadratic equation y is */ + POINT_CONVERSION_HYBRID = 6 +} point_conversion_form_t; + +typedef struct ec_method_st EC_METHOD; +typedef struct ec_group_st EC_GROUP; +typedef struct ec_point_st EC_POINT; +typedef struct ecpk_parameters_st ECPKPARAMETERS; +typedef struct ec_parameters_st ECPARAMETERS; + +/********************************************************************/ +/* EC_METHODs for curves over GF(p) */ +/********************************************************************/ + +/** Returns the basic GFp ec methods which provides the basis for the + * optimized methods. + * \return EC_METHOD object + */ +const EC_METHOD *EC_GFp_simple_method(void); + +/** Returns GFp methods using montgomery multiplication. + * \return EC_METHOD object + */ +const EC_METHOD *EC_GFp_mont_method(void); + +/** Returns GFp methods using optimized methods for NIST recommended curves + * \return EC_METHOD object + */ +const EC_METHOD *EC_GFp_nist_method(void); + +# ifndef OPENSSL_NO_EC_NISTP_64_GCC_128 +/** Returns 64-bit optimized methods for nistp224 + * \return EC_METHOD object + */ +const EC_METHOD *EC_GFp_nistp224_method(void); + +/** Returns 64-bit optimized methods for nistp256 + * \return EC_METHOD object + */ +const EC_METHOD *EC_GFp_nistp256_method(void); + +/** Returns 64-bit optimized methods for nistp521 + * \return EC_METHOD object + */ +const EC_METHOD *EC_GFp_nistp521_method(void); +# endif + +# ifndef OPENSSL_NO_EC2M +/********************************************************************/ +/* EC_METHOD for curves over GF(2^m) */ +/********************************************************************/ + +/** Returns the basic GF2m ec method + * \return EC_METHOD object + */ +const EC_METHOD *EC_GF2m_simple_method(void); + +# endif + +/********************************************************************/ +/* EC_GROUP functions */ +/********************************************************************/ + +/** Creates a new EC_GROUP object + * \param meth EC_METHOD to use + * \return newly created EC_GROUP object or NULL in case of an error. + */ +EC_GROUP *EC_GROUP_new(const EC_METHOD *meth); + +/** Frees a EC_GROUP object + * \param group EC_GROUP object to be freed. + */ +void EC_GROUP_free(EC_GROUP *group); + +/** Clears and frees a EC_GROUP object + * \param group EC_GROUP object to be cleared and freed. + */ +void EC_GROUP_clear_free(EC_GROUP *group); + +/** Copies EC_GROUP objects. Note: both EC_GROUPs must use the same EC_METHOD. + * \param dst destination EC_GROUP object + * \param src source EC_GROUP object + * \return 1 on success and 0 if an error occurred. + */ +int EC_GROUP_copy(EC_GROUP *dst, const EC_GROUP *src); + +/** Creates a new EC_GROUP object and copies the copies the content + * form src to the newly created EC_KEY object + * \param src source EC_GROUP object + * \return newly created EC_GROUP object or NULL in case of an error. + */ +EC_GROUP *EC_GROUP_dup(const EC_GROUP *src); + +/** Returns the EC_METHOD of the EC_GROUP object. + * \param group EC_GROUP object + * \return EC_METHOD used in this EC_GROUP object. + */ +const EC_METHOD *EC_GROUP_method_of(const EC_GROUP *group); + +/** Returns the field type of the EC_METHOD. + * \param meth EC_METHOD object + * \return NID of the underlying field type OID. + */ +int EC_METHOD_get_field_type(const EC_METHOD *meth); + +/** Sets the generator and it's order/cofactor of a EC_GROUP object. + * \param group EC_GROUP object + * \param generator EC_POINT object with the generator. + * \param order the order of the group generated by the generator. + * \param cofactor the index of the sub-group generated by the generator + * in the group of all points on the elliptic curve. + * \return 1 on success and 0 if an error occurred + */ +int EC_GROUP_set_generator(EC_GROUP *group, const EC_POINT *generator, + const BIGNUM *order, const BIGNUM *cofactor); + +/** Returns the generator of a EC_GROUP object. + * \param group EC_GROUP object + * \return the currently used generator (possibly NULL). + */ +const EC_POINT *EC_GROUP_get0_generator(const EC_GROUP *group); + +/** Returns the montgomery data for order(Generator) + * \param group EC_GROUP object + * \return the currently used montgomery data (possibly NULL). +*/ +BN_MONT_CTX *EC_GROUP_get_mont_data(const EC_GROUP *group); + +/** Gets the order of a EC_GROUP + * \param group EC_GROUP object + * \param order BIGNUM to which the order is copied + * \param ctx unused + * \return 1 on success and 0 if an error occurred + */ +int EC_GROUP_get_order(const EC_GROUP *group, BIGNUM *order, BN_CTX *ctx); + +/** Gets the order of an EC_GROUP + * \param group EC_GROUP object + * \return the group order + */ +const BIGNUM *EC_GROUP_get0_order(const EC_GROUP *group); + +/** Gets the number of bits of the order of an EC_GROUP + * \param group EC_GROUP object + * \return number of bits of group order. + */ +int EC_GROUP_order_bits(const EC_GROUP *group); + +/** Gets the cofactor of a EC_GROUP + * \param group EC_GROUP object + * \param cofactor BIGNUM to which the cofactor is copied + * \param ctx unused + * \return 1 on success and 0 if an error occurred + */ +int EC_GROUP_get_cofactor(const EC_GROUP *group, BIGNUM *cofactor, + BN_CTX *ctx); + +/** Gets the cofactor of an EC_GROUP + * \param group EC_GROUP object + * \return the group cofactor + */ +const BIGNUM *EC_GROUP_get0_cofactor(const EC_GROUP *group); + +/** Sets the name of a EC_GROUP object + * \param group EC_GROUP object + * \param nid NID of the curve name OID + */ +void EC_GROUP_set_curve_name(EC_GROUP *group, int nid); + +/** Returns the curve name of a EC_GROUP object + * \param group EC_GROUP object + * \return NID of the curve name OID or 0 if not set. + */ +int EC_GROUP_get_curve_name(const EC_GROUP *group); + +void EC_GROUP_set_asn1_flag(EC_GROUP *group, int flag); +int EC_GROUP_get_asn1_flag(const EC_GROUP *group); + +void EC_GROUP_set_point_conversion_form(EC_GROUP *group, + point_conversion_form_t form); +point_conversion_form_t EC_GROUP_get_point_conversion_form(const EC_GROUP *); + +unsigned char *EC_GROUP_get0_seed(const EC_GROUP *x); +size_t EC_GROUP_get_seed_len(const EC_GROUP *); +size_t EC_GROUP_set_seed(EC_GROUP *, const unsigned char *, size_t len); + +/** Sets the parameters of a ec curve defined by y^2 = x^3 + a*x + b (for GFp) + * or y^2 + x*y = x^3 + a*x^2 + b (for GF2m) + * \param group EC_GROUP object + * \param p BIGNUM with the prime number (GFp) or the polynomial + * defining the underlying field (GF2m) + * \param a BIGNUM with parameter a of the equation + * \param b BIGNUM with parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_GROUP_set_curve(EC_GROUP *group, const BIGNUM *p, const BIGNUM *a, + const BIGNUM *b, BN_CTX *ctx); + +/** Gets the parameters of the ec curve defined by y^2 = x^3 + a*x + b (for GFp) + * or y^2 + x*y = x^3 + a*x^2 + b (for GF2m) + * \param group EC_GROUP object + * \param p BIGNUM with the prime number (GFp) or the polynomial + * defining the underlying field (GF2m) + * \param a BIGNUM for parameter a of the equation + * \param b BIGNUM for parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_GROUP_get_curve(const EC_GROUP *group, BIGNUM *p, BIGNUM *a, BIGNUM *b, + BN_CTX *ctx); + +/** Sets the parameters of an ec curve. Synonym for EC_GROUP_set_curve + * \param group EC_GROUP object + * \param p BIGNUM with the prime number (GFp) or the polynomial + * defining the underlying field (GF2m) + * \param a BIGNUM with parameter a of the equation + * \param b BIGNUM with parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_GROUP_set_curve_GFp(EC_GROUP *group, const BIGNUM *p, + const BIGNUM *a, const BIGNUM *b, + BN_CTX *ctx)) + +/** Gets the parameters of an ec curve. Synonym for EC_GROUP_get_curve + * \param group EC_GROUP object + * \param p BIGNUM with the prime number (GFp) or the polynomial + * defining the underlying field (GF2m) + * \param a BIGNUM for parameter a of the equation + * \param b BIGNUM for parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_GROUP_get_curve_GFp(const EC_GROUP *group, BIGNUM *p, + BIGNUM *a, BIGNUM *b, + BN_CTX *ctx)) + +# ifndef OPENSSL_NO_EC2M +/** Sets the parameter of an ec curve. Synonym for EC_GROUP_set_curve + * \param group EC_GROUP object + * \param p BIGNUM with the prime number (GFp) or the polynomial + * defining the underlying field (GF2m) + * \param a BIGNUM with parameter a of the equation + * \param b BIGNUM with parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_GROUP_set_curve_GF2m(EC_GROUP *group, const BIGNUM *p, + const BIGNUM *a, const BIGNUM *b, + BN_CTX *ctx)) + +/** Gets the parameters of an ec curve. Synonym for EC_GROUP_get_curve + * \param group EC_GROUP object + * \param p BIGNUM with the prime number (GFp) or the polynomial + * defining the underlying field (GF2m) + * \param a BIGNUM for parameter a of the equation + * \param b BIGNUM for parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_GROUP_get_curve_GF2m(const EC_GROUP *group, BIGNUM *p, + BIGNUM *a, BIGNUM *b, + BN_CTX *ctx)) +# endif +/** Returns the number of bits needed to represent a field element + * \param group EC_GROUP object + * \return number of bits needed to represent a field element + */ +int EC_GROUP_get_degree(const EC_GROUP *group); + +/** Checks whether the parameter in the EC_GROUP define a valid ec group + * \param group EC_GROUP object + * \param ctx BN_CTX object (optional) + * \return 1 if group is a valid ec group and 0 otherwise + */ +int EC_GROUP_check(const EC_GROUP *group, BN_CTX *ctx); + +/** Checks whether the discriminant of the elliptic curve is zero or not + * \param group EC_GROUP object + * \param ctx BN_CTX object (optional) + * \return 1 if the discriminant is not zero and 0 otherwise + */ +int EC_GROUP_check_discriminant(const EC_GROUP *group, BN_CTX *ctx); + +/** Compares two EC_GROUP objects + * \param a first EC_GROUP object + * \param b second EC_GROUP object + * \param ctx BN_CTX object (optional) + * \return 0 if the groups are equal, 1 if not, or -1 on error + */ +int EC_GROUP_cmp(const EC_GROUP *a, const EC_GROUP *b, BN_CTX *ctx); + +/* + * EC_GROUP_new_GF*() calls EC_GROUP_new() and EC_GROUP_set_GF*() after + * choosing an appropriate EC_METHOD + */ + +/** Creates a new EC_GROUP object with the specified parameters defined + * over GFp (defined by the equation y^2 = x^3 + a*x + b) + * \param p BIGNUM with the prime number + * \param a BIGNUM with the parameter a of the equation + * \param b BIGNUM with the parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return newly created EC_GROUP object with the specified parameters + */ +EC_GROUP *EC_GROUP_new_curve_GFp(const BIGNUM *p, const BIGNUM *a, + const BIGNUM *b, BN_CTX *ctx); +# ifndef OPENSSL_NO_EC2M +/** Creates a new EC_GROUP object with the specified parameters defined + * over GF2m (defined by the equation y^2 + x*y = x^3 + a*x^2 + b) + * \param p BIGNUM with the polynomial defining the underlying field + * \param a BIGNUM with the parameter a of the equation + * \param b BIGNUM with the parameter b of the equation + * \param ctx BN_CTX object (optional) + * \return newly created EC_GROUP object with the specified parameters + */ +EC_GROUP *EC_GROUP_new_curve_GF2m(const BIGNUM *p, const BIGNUM *a, + const BIGNUM *b, BN_CTX *ctx); +# endif + +/** Creates a EC_GROUP object with a curve specified by a NID + * \param nid NID of the OID of the curve name + * \return newly created EC_GROUP object with specified curve or NULL + * if an error occurred + */ +EC_GROUP *EC_GROUP_new_by_curve_name(int nid); + +/** Creates a new EC_GROUP object from an ECPARAMETERS object + * \param params pointer to the ECPARAMETERS object + * \return newly created EC_GROUP object with specified curve or NULL + * if an error occurred + */ +EC_GROUP *EC_GROUP_new_from_ecparameters(const ECPARAMETERS *params); + +/** Creates an ECPARAMETERS object for the given EC_GROUP object. + * \param group pointer to the EC_GROUP object + * \param params pointer to an existing ECPARAMETERS object or NULL + * \return pointer to the new ECPARAMETERS object or NULL + * if an error occurred. + */ +ECPARAMETERS *EC_GROUP_get_ecparameters(const EC_GROUP *group, + ECPARAMETERS *params); + +/** Creates a new EC_GROUP object from an ECPKPARAMETERS object + * \param params pointer to an existing ECPKPARAMETERS object, or NULL + * \return newly created EC_GROUP object with specified curve, or NULL + * if an error occurred + */ +EC_GROUP *EC_GROUP_new_from_ecpkparameters(const ECPKPARAMETERS *params); + +/** Creates an ECPKPARAMETERS object for the given EC_GROUP object. + * \param group pointer to the EC_GROUP object + * \param params pointer to an existing ECPKPARAMETERS object or NULL + * \return pointer to the new ECPKPARAMETERS object or NULL + * if an error occurred. + */ +ECPKPARAMETERS *EC_GROUP_get_ecpkparameters(const EC_GROUP *group, + ECPKPARAMETERS *params); + +/********************************************************************/ +/* handling of internal curves */ +/********************************************************************/ + +typedef struct { + int nid; + const char *comment; +} EC_builtin_curve; + +/* + * EC_builtin_curves(EC_builtin_curve *r, size_t size) returns number of all + * available curves or zero if a error occurred. In case r is not zero, + * nitems EC_builtin_curve structures are filled with the data of the first + * nitems internal groups + */ +size_t EC_get_builtin_curves(EC_builtin_curve *r, size_t nitems); + +const char *EC_curve_nid2nist(int nid); +int EC_curve_nist2nid(const char *name); + +/********************************************************************/ +/* EC_POINT functions */ +/********************************************************************/ + +/** Creates a new EC_POINT object for the specified EC_GROUP + * \param group EC_GROUP the underlying EC_GROUP object + * \return newly created EC_POINT object or NULL if an error occurred + */ +EC_POINT *EC_POINT_new(const EC_GROUP *group); + +/** Frees a EC_POINT object + * \param point EC_POINT object to be freed + */ +void EC_POINT_free(EC_POINT *point); + +/** Clears and frees a EC_POINT object + * \param point EC_POINT object to be cleared and freed + */ +void EC_POINT_clear_free(EC_POINT *point); + +/** Copies EC_POINT object + * \param dst destination EC_POINT object + * \param src source EC_POINT object + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_copy(EC_POINT *dst, const EC_POINT *src); + +/** Creates a new EC_POINT object and copies the content of the supplied + * EC_POINT + * \param src source EC_POINT object + * \param group underlying the EC_GROUP object + * \return newly created EC_POINT object or NULL if an error occurred + */ +EC_POINT *EC_POINT_dup(const EC_POINT *src, const EC_GROUP *group); + +/** Returns the EC_METHOD used in EC_POINT object + * \param point EC_POINT object + * \return the EC_METHOD used + */ +const EC_METHOD *EC_POINT_method_of(const EC_POINT *point); + +/** Sets a point to infinity (neutral element) + * \param group underlying EC_GROUP object + * \param point EC_POINT to set to infinity + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_set_to_infinity(const EC_GROUP *group, EC_POINT *point); + +/** Sets the jacobian projective coordinates of a EC_POINT over GFp + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM with the x-coordinate + * \param y BIGNUM with the y-coordinate + * \param z BIGNUM with the z-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_set_Jprojective_coordinates_GFp(const EC_GROUP *group, + EC_POINT *p, const BIGNUM *x, + const BIGNUM *y, const BIGNUM *z, + BN_CTX *ctx); + +/** Gets the jacobian projective coordinates of a EC_POINT over GFp + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM for the x-coordinate + * \param y BIGNUM for the y-coordinate + * \param z BIGNUM for the z-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_get_Jprojective_coordinates_GFp(const EC_GROUP *group, + const EC_POINT *p, BIGNUM *x, + BIGNUM *y, BIGNUM *z, + BN_CTX *ctx); + +/** Sets the affine coordinates of an EC_POINT + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM with the x-coordinate + * \param y BIGNUM with the y-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_set_affine_coordinates(const EC_GROUP *group, EC_POINT *p, + const BIGNUM *x, const BIGNUM *y, + BN_CTX *ctx); + +/** Gets the affine coordinates of an EC_POINT. + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM for the x-coordinate + * \param y BIGNUM for the y-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_get_affine_coordinates(const EC_GROUP *group, const EC_POINT *p, + BIGNUM *x, BIGNUM *y, BN_CTX *ctx); + +/** Sets the affine coordinates of an EC_POINT. A synonym of + * EC_POINT_set_affine_coordinates + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM with the x-coordinate + * \param y BIGNUM with the y-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_POINT_set_affine_coordinates_GFp(const EC_GROUP *group, + EC_POINT *p, + const BIGNUM *x, + const BIGNUM *y, + BN_CTX *ctx)) + +/** Gets the affine coordinates of an EC_POINT. A synonym of + * EC_POINT_get_affine_coordinates + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM for the x-coordinate + * \param y BIGNUM for the y-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_POINT_get_affine_coordinates_GFp(const EC_GROUP *group, + const EC_POINT *p, + BIGNUM *x, + BIGNUM *y, + BN_CTX *ctx)) + +/** Sets the x9.62 compressed coordinates of a EC_POINT + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM with x-coordinate + * \param y_bit integer with the y-Bit (either 0 or 1) + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_set_compressed_coordinates(const EC_GROUP *group, EC_POINT *p, + const BIGNUM *x, int y_bit, + BN_CTX *ctx); + +/** Sets the x9.62 compressed coordinates of a EC_POINT. A synonym of + * EC_POINT_set_compressed_coordinates + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM with x-coordinate + * \param y_bit integer with the y-Bit (either 0 or 1) + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_POINT_set_compressed_coordinates_GFp(const EC_GROUP *group, + EC_POINT *p, + const BIGNUM *x, + int y_bit, + BN_CTX *ctx)) +# ifndef OPENSSL_NO_EC2M +/** Sets the affine coordinates of an EC_POINT. A synonym of + * EC_POINT_set_affine_coordinates + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM with the x-coordinate + * \param y BIGNUM with the y-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_POINT_set_affine_coordinates_GF2m(const EC_GROUP *group, + EC_POINT *p, + const BIGNUM *x, + const BIGNUM *y, + BN_CTX *ctx)) + +/** Gets the affine coordinates of an EC_POINT. A synonym of + * EC_POINT_get_affine_coordinates + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM for the x-coordinate + * \param y BIGNUM for the y-coordinate + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_POINT_get_affine_coordinates_GF2m(const EC_GROUP *group, + const EC_POINT *p, + BIGNUM *x, + BIGNUM *y, + BN_CTX *ctx)) + +/** Sets the x9.62 compressed coordinates of a EC_POINT. A synonym of + * EC_POINT_set_compressed_coordinates + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param x BIGNUM with x-coordinate + * \param y_bit integer with the y-Bit (either 0 or 1) + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +DEPRECATEDIN_1_2_0(int EC_POINT_set_compressed_coordinates_GF2m(const EC_GROUP *group, + EC_POINT *p, + const BIGNUM *x, + int y_bit, + BN_CTX *ctx)) +# endif +/** Encodes a EC_POINT object to a octet string + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param form point conversion form + * \param buf memory buffer for the result. If NULL the function returns + * required buffer size. + * \param len length of the memory buffer + * \param ctx BN_CTX object (optional) + * \return the length of the encoded octet string or 0 if an error occurred + */ +size_t EC_POINT_point2oct(const EC_GROUP *group, const EC_POINT *p, + point_conversion_form_t form, + unsigned char *buf, size_t len, BN_CTX *ctx); + +/** Decodes a EC_POINT from a octet string + * \param group underlying EC_GROUP object + * \param p EC_POINT object + * \param buf memory buffer with the encoded ec point + * \param len length of the encoded ec point + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_oct2point(const EC_GROUP *group, EC_POINT *p, + const unsigned char *buf, size_t len, BN_CTX *ctx); + +/** Encodes an EC_POINT object to an allocated octet string + * \param group underlying EC_GROUP object + * \param point EC_POINT object + * \param form point conversion form + * \param pbuf returns pointer to allocated buffer + * \param ctx BN_CTX object (optional) + * \return the length of the encoded octet string or 0 if an error occurred + */ +size_t EC_POINT_point2buf(const EC_GROUP *group, const EC_POINT *point, + point_conversion_form_t form, + unsigned char **pbuf, BN_CTX *ctx); + +/* other interfaces to point2oct/oct2point: */ +BIGNUM *EC_POINT_point2bn(const EC_GROUP *, const EC_POINT *, + point_conversion_form_t form, BIGNUM *, BN_CTX *); +EC_POINT *EC_POINT_bn2point(const EC_GROUP *, const BIGNUM *, + EC_POINT *, BN_CTX *); +char *EC_POINT_point2hex(const EC_GROUP *, const EC_POINT *, + point_conversion_form_t form, BN_CTX *); +EC_POINT *EC_POINT_hex2point(const EC_GROUP *, const char *, + EC_POINT *, BN_CTX *); + +/********************************************************************/ +/* functions for doing EC_POINT arithmetic */ +/********************************************************************/ + +/** Computes the sum of two EC_POINT + * \param group underlying EC_GROUP object + * \param r EC_POINT object for the result (r = a + b) + * \param a EC_POINT object with the first summand + * \param b EC_POINT object with the second summand + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_add(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, + const EC_POINT *b, BN_CTX *ctx); + +/** Computes the double of a EC_POINT + * \param group underlying EC_GROUP object + * \param r EC_POINT object for the result (r = 2 * a) + * \param a EC_POINT object + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_dbl(const EC_GROUP *group, EC_POINT *r, const EC_POINT *a, + BN_CTX *ctx); + +/** Computes the inverse of a EC_POINT + * \param group underlying EC_GROUP object + * \param a EC_POINT object to be inverted (it's used for the result as well) + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_invert(const EC_GROUP *group, EC_POINT *a, BN_CTX *ctx); + +/** Checks whether the point is the neutral element of the group + * \param group the underlying EC_GROUP object + * \param p EC_POINT object + * \return 1 if the point is the neutral element and 0 otherwise + */ +int EC_POINT_is_at_infinity(const EC_GROUP *group, const EC_POINT *p); + +/** Checks whether the point is on the curve + * \param group underlying EC_GROUP object + * \param point EC_POINT object to check + * \param ctx BN_CTX object (optional) + * \return 1 if the point is on the curve, 0 if not, or -1 on error + */ +int EC_POINT_is_on_curve(const EC_GROUP *group, const EC_POINT *point, + BN_CTX *ctx); + +/** Compares two EC_POINTs + * \param group underlying EC_GROUP object + * \param a first EC_POINT object + * \param b second EC_POINT object + * \param ctx BN_CTX object (optional) + * \return 1 if the points are not equal, 0 if they are, or -1 on error + */ +int EC_POINT_cmp(const EC_GROUP *group, const EC_POINT *a, const EC_POINT *b, + BN_CTX *ctx); + +int EC_POINT_make_affine(const EC_GROUP *group, EC_POINT *point, BN_CTX *ctx); +int EC_POINTs_make_affine(const EC_GROUP *group, size_t num, + EC_POINT *points[], BN_CTX *ctx); + +/** Computes r = generator * n + sum_{i=0}^{num-1} p[i] * m[i] + * \param group underlying EC_GROUP object + * \param r EC_POINT object for the result + * \param n BIGNUM with the multiplier for the group generator (optional) + * \param num number further summands + * \param p array of size num of EC_POINT objects + * \param m array of size num of BIGNUM objects + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINTs_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, + size_t num, const EC_POINT *p[], const BIGNUM *m[], + BN_CTX *ctx); + +/** Computes r = generator * n + q * m + * \param group underlying EC_GROUP object + * \param r EC_POINT object for the result + * \param n BIGNUM with the multiplier for the group generator (optional) + * \param q EC_POINT object with the first factor of the second summand + * \param m BIGNUM with the second factor of the second summand + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_POINT_mul(const EC_GROUP *group, EC_POINT *r, const BIGNUM *n, + const EC_POINT *q, const BIGNUM *m, BN_CTX *ctx); + +/** Stores multiples of generator for faster point multiplication + * \param group EC_GROUP object + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ +int EC_GROUP_precompute_mult(EC_GROUP *group, BN_CTX *ctx); + +/** Reports whether a precomputation has been done + * \param group EC_GROUP object + * \return 1 if a pre-computation has been done and 0 otherwise + */ +int EC_GROUP_have_precompute_mult(const EC_GROUP *group); + +/********************************************************************/ +/* ASN1 stuff */ +/********************************************************************/ + +DECLARE_ASN1_ITEM(ECPKPARAMETERS) +DECLARE_ASN1_ALLOC_FUNCTIONS(ECPKPARAMETERS) +DECLARE_ASN1_ITEM(ECPARAMETERS) +DECLARE_ASN1_ALLOC_FUNCTIONS(ECPARAMETERS) + +/* + * EC_GROUP_get_basis_type() returns the NID of the basis type used to + * represent the field elements + */ +int EC_GROUP_get_basis_type(const EC_GROUP *); +# ifndef OPENSSL_NO_EC2M +int EC_GROUP_get_trinomial_basis(const EC_GROUP *, unsigned int *k); +int EC_GROUP_get_pentanomial_basis(const EC_GROUP *, unsigned int *k1, + unsigned int *k2, unsigned int *k3); +# endif + +# define OPENSSL_EC_EXPLICIT_CURVE 0x000 +# define OPENSSL_EC_NAMED_CURVE 0x001 + +EC_GROUP *d2i_ECPKParameters(EC_GROUP **, const unsigned char **in, long len); +int i2d_ECPKParameters(const EC_GROUP *, unsigned char **out); + +# define d2i_ECPKParameters_bio(bp,x) ASN1_d2i_bio_of(EC_GROUP,NULL,d2i_ECPKParameters,bp,x) +# define i2d_ECPKParameters_bio(bp,x) ASN1_i2d_bio_of_const(EC_GROUP,i2d_ECPKParameters,bp,x) +# define d2i_ECPKParameters_fp(fp,x) (EC_GROUP *)ASN1_d2i_fp(NULL, \ + (char *(*)())d2i_ECPKParameters,(fp),(unsigned char **)(x)) +# define i2d_ECPKParameters_fp(fp,x) ASN1_i2d_fp(i2d_ECPKParameters,(fp), \ + (unsigned char *)(x)) + +int ECPKParameters_print(BIO *bp, const EC_GROUP *x, int off); +# ifndef OPENSSL_NO_STDIO +int ECPKParameters_print_fp(FILE *fp, const EC_GROUP *x, int off); +# endif + +/********************************************************************/ +/* EC_KEY functions */ +/********************************************************************/ + +/* some values for the encoding_flag */ +# define EC_PKEY_NO_PARAMETERS 0x001 +# define EC_PKEY_NO_PUBKEY 0x002 + +/* some values for the flags field */ +# define EC_FLAG_NON_FIPS_ALLOW 0x1 +# define EC_FLAG_FIPS_CHECKED 0x2 +# define EC_FLAG_COFACTOR_ECDH 0x1000 + +/** Creates a new EC_KEY object. + * \return EC_KEY object or NULL if an error occurred. + */ +EC_KEY *EC_KEY_new(void); + +int EC_KEY_get_flags(const EC_KEY *key); + +void EC_KEY_set_flags(EC_KEY *key, int flags); + +void EC_KEY_clear_flags(EC_KEY *key, int flags); + +/** Creates a new EC_KEY object using a named curve as underlying + * EC_GROUP object. + * \param nid NID of the named curve. + * \return EC_KEY object or NULL if an error occurred. + */ +EC_KEY *EC_KEY_new_by_curve_name(int nid); + +/** Frees a EC_KEY object. + * \param key EC_KEY object to be freed. + */ +void EC_KEY_free(EC_KEY *key); + +/** Copies a EC_KEY object. + * \param dst destination EC_KEY object + * \param src src EC_KEY object + * \return dst or NULL if an error occurred. + */ +EC_KEY *EC_KEY_copy(EC_KEY *dst, const EC_KEY *src); + +/** Creates a new EC_KEY object and copies the content from src to it. + * \param src the source EC_KEY object + * \return newly created EC_KEY object or NULL if an error occurred. + */ +EC_KEY *EC_KEY_dup(const EC_KEY *src); + +/** Increases the internal reference count of a EC_KEY object. + * \param key EC_KEY object + * \return 1 on success and 0 if an error occurred. + */ +int EC_KEY_up_ref(EC_KEY *key); + +/** Returns the ENGINE object of a EC_KEY object + * \param eckey EC_KEY object + * \return the ENGINE object (possibly NULL). + */ +ENGINE *EC_KEY_get0_engine(const EC_KEY *eckey); + +/** Returns the EC_GROUP object of a EC_KEY object + * \param key EC_KEY object + * \return the EC_GROUP object (possibly NULL). + */ +const EC_GROUP *EC_KEY_get0_group(const EC_KEY *key); + +/** Sets the EC_GROUP of a EC_KEY object. + * \param key EC_KEY object + * \param group EC_GROUP to use in the EC_KEY object (note: the EC_KEY + * object will use an own copy of the EC_GROUP). + * \return 1 on success and 0 if an error occurred. + */ +int EC_KEY_set_group(EC_KEY *key, const EC_GROUP *group); + +/** Returns the private key of a EC_KEY object. + * \param key EC_KEY object + * \return a BIGNUM with the private key (possibly NULL). + */ +const BIGNUM *EC_KEY_get0_private_key(const EC_KEY *key); + +/** Sets the private key of a EC_KEY object. + * \param key EC_KEY object + * \param prv BIGNUM with the private key (note: the EC_KEY object + * will use an own copy of the BIGNUM). + * \return 1 on success and 0 if an error occurred. + */ +int EC_KEY_set_private_key(EC_KEY *key, const BIGNUM *prv); + +/** Returns the public key of a EC_KEY object. + * \param key the EC_KEY object + * \return a EC_POINT object with the public key (possibly NULL) + */ +const EC_POINT *EC_KEY_get0_public_key(const EC_KEY *key); + +/** Sets the public key of a EC_KEY object. + * \param key EC_KEY object + * \param pub EC_POINT object with the public key (note: the EC_KEY object + * will use an own copy of the EC_POINT object). + * \return 1 on success and 0 if an error occurred. + */ +int EC_KEY_set_public_key(EC_KEY *key, const EC_POINT *pub); + +unsigned EC_KEY_get_enc_flags(const EC_KEY *key); +void EC_KEY_set_enc_flags(EC_KEY *eckey, unsigned int flags); +point_conversion_form_t EC_KEY_get_conv_form(const EC_KEY *key); +void EC_KEY_set_conv_form(EC_KEY *eckey, point_conversion_form_t cform); + +#define EC_KEY_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_EC_KEY, l, p, newf, dupf, freef) +int EC_KEY_set_ex_data(EC_KEY *key, int idx, void *arg); +void *EC_KEY_get_ex_data(const EC_KEY *key, int idx); + +/* wrapper functions for the underlying EC_GROUP object */ +void EC_KEY_set_asn1_flag(EC_KEY *eckey, int asn1_flag); + +/** Creates a table of pre-computed multiples of the generator to + * accelerate further EC_KEY operations. + * \param key EC_KEY object + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred. + */ +int EC_KEY_precompute_mult(EC_KEY *key, BN_CTX *ctx); + +/** Creates a new ec private (and optional a new public) key. + * \param key EC_KEY object + * \return 1 on success and 0 if an error occurred. + */ +int EC_KEY_generate_key(EC_KEY *key); + +/** Verifies that a private and/or public key is valid. + * \param key the EC_KEY object + * \return 1 on success and 0 otherwise. + */ +int EC_KEY_check_key(const EC_KEY *key); + +/** Indicates if an EC_KEY can be used for signing. + * \param eckey the EC_KEY object + * \return 1 if can can sign and 0 otherwise. + */ +int EC_KEY_can_sign(const EC_KEY *eckey); + +/** Sets a public key from affine coordinates performing + * necessary NIST PKV tests. + * \param key the EC_KEY object + * \param x public key x coordinate + * \param y public key y coordinate + * \return 1 on success and 0 otherwise. + */ +int EC_KEY_set_public_key_affine_coordinates(EC_KEY *key, BIGNUM *x, + BIGNUM *y); + +/** Encodes an EC_KEY public key to an allocated octet string + * \param key key to encode + * \param form point conversion form + * \param pbuf returns pointer to allocated buffer + * \param ctx BN_CTX object (optional) + * \return the length of the encoded octet string or 0 if an error occurred + */ +size_t EC_KEY_key2buf(const EC_KEY *key, point_conversion_form_t form, + unsigned char **pbuf, BN_CTX *ctx); + +/** Decodes a EC_KEY public key from a octet string + * \param key key to decode + * \param buf memory buffer with the encoded ec point + * \param len length of the encoded ec point + * \param ctx BN_CTX object (optional) + * \return 1 on success and 0 if an error occurred + */ + +int EC_KEY_oct2key(EC_KEY *key, const unsigned char *buf, size_t len, + BN_CTX *ctx); + +/** Decodes an EC_KEY private key from an octet string + * \param key key to decode + * \param buf memory buffer with the encoded private key + * \param len length of the encoded key + * \return 1 on success and 0 if an error occurred + */ + +int EC_KEY_oct2priv(EC_KEY *key, const unsigned char *buf, size_t len); + +/** Encodes a EC_KEY private key to an octet string + * \param key key to encode + * \param buf memory buffer for the result. If NULL the function returns + * required buffer size. + * \param len length of the memory buffer + * \return the length of the encoded octet string or 0 if an error occurred + */ + +size_t EC_KEY_priv2oct(const EC_KEY *key, unsigned char *buf, size_t len); + +/** Encodes an EC_KEY private key to an allocated octet string + * \param eckey key to encode + * \param pbuf returns pointer to allocated buffer + * \return the length of the encoded octet string or 0 if an error occurred + */ +size_t EC_KEY_priv2buf(const EC_KEY *eckey, unsigned char **pbuf); + +/********************************************************************/ +/* de- and encoding functions for SEC1 ECPrivateKey */ +/********************************************************************/ + +/** Decodes a private key from a memory buffer. + * \param key a pointer to a EC_KEY object which should be used (or NULL) + * \param in pointer to memory with the DER encoded private key + * \param len length of the DER encoded private key + * \return the decoded private key or NULL if an error occurred. + */ +EC_KEY *d2i_ECPrivateKey(EC_KEY **key, const unsigned char **in, long len); + +/** Encodes a private key object and stores the result in a buffer. + * \param key the EC_KEY object to encode + * \param out the buffer for the result (if NULL the function returns number + * of bytes needed). + * \return 1 on success and 0 if an error occurred. + */ +int i2d_ECPrivateKey(EC_KEY *key, unsigned char **out); + +/********************************************************************/ +/* de- and encoding functions for EC parameters */ +/********************************************************************/ + +/** Decodes ec parameter from a memory buffer. + * \param key a pointer to a EC_KEY object which should be used (or NULL) + * \param in pointer to memory with the DER encoded ec parameters + * \param len length of the DER encoded ec parameters + * \return a EC_KEY object with the decoded parameters or NULL if an error + * occurred. + */ +EC_KEY *d2i_ECParameters(EC_KEY **key, const unsigned char **in, long len); + +/** Encodes ec parameter and stores the result in a buffer. + * \param key the EC_KEY object with ec parameters to encode + * \param out the buffer for the result (if NULL the function returns number + * of bytes needed). + * \return 1 on success and 0 if an error occurred. + */ +int i2d_ECParameters(EC_KEY *key, unsigned char **out); + +/********************************************************************/ +/* de- and encoding functions for EC public key */ +/* (octet string, not DER -- hence 'o2i' and 'i2o') */ +/********************************************************************/ + +/** Decodes a ec public key from a octet string. + * \param key a pointer to a EC_KEY object which should be used + * \param in memory buffer with the encoded public key + * \param len length of the encoded public key + * \return EC_KEY object with decoded public key or NULL if an error + * occurred. + */ +EC_KEY *o2i_ECPublicKey(EC_KEY **key, const unsigned char **in, long len); + +/** Encodes a ec public key in an octet string. + * \param key the EC_KEY object with the public key + * \param out the buffer for the result (if NULL the function returns number + * of bytes needed). + * \return 1 on success and 0 if an error occurred + */ +int i2o_ECPublicKey(const EC_KEY *key, unsigned char **out); + +/** Prints out the ec parameters on human readable form. + * \param bp BIO object to which the information is printed + * \param key EC_KEY object + * \return 1 on success and 0 if an error occurred + */ +int ECParameters_print(BIO *bp, const EC_KEY *key); + +/** Prints out the contents of a EC_KEY object + * \param bp BIO object to which the information is printed + * \param key EC_KEY object + * \param off line offset + * \return 1 on success and 0 if an error occurred + */ +int EC_KEY_print(BIO *bp, const EC_KEY *key, int off); + +# ifndef OPENSSL_NO_STDIO +/** Prints out the ec parameters on human readable form. + * \param fp file descriptor to which the information is printed + * \param key EC_KEY object + * \return 1 on success and 0 if an error occurred + */ +int ECParameters_print_fp(FILE *fp, const EC_KEY *key); + +/** Prints out the contents of a EC_KEY object + * \param fp file descriptor to which the information is printed + * \param key EC_KEY object + * \param off line offset + * \return 1 on success and 0 if an error occurred + */ +int EC_KEY_print_fp(FILE *fp, const EC_KEY *key, int off); + +# endif + +const EC_KEY_METHOD *EC_KEY_OpenSSL(void); +const EC_KEY_METHOD *EC_KEY_get_default_method(void); +void EC_KEY_set_default_method(const EC_KEY_METHOD *meth); +const EC_KEY_METHOD *EC_KEY_get_method(const EC_KEY *key); +int EC_KEY_set_method(EC_KEY *key, const EC_KEY_METHOD *meth); +EC_KEY *EC_KEY_new_method(ENGINE *engine); + +int ECDH_KDF_X9_62(unsigned char *out, size_t outlen, + const unsigned char *Z, size_t Zlen, + const unsigned char *sinfo, size_t sinfolen, + const EVP_MD *md); + +int ECDH_compute_key(void *out, size_t outlen, const EC_POINT *pub_key, + const EC_KEY *ecdh, + void *(*KDF) (const void *in, size_t inlen, + void *out, size_t *outlen)); + +typedef struct ECDSA_SIG_st ECDSA_SIG; + +/** Allocates and initialize a ECDSA_SIG structure + * \return pointer to a ECDSA_SIG structure or NULL if an error occurred + */ +ECDSA_SIG *ECDSA_SIG_new(void); + +/** frees a ECDSA_SIG structure + * \param sig pointer to the ECDSA_SIG structure + */ +void ECDSA_SIG_free(ECDSA_SIG *sig); + +/** DER encode content of ECDSA_SIG object (note: this function modifies *pp + * (*pp += length of the DER encoded signature)). + * \param sig pointer to the ECDSA_SIG object + * \param pp pointer to a unsigned char pointer for the output or NULL + * \return the length of the DER encoded ECDSA_SIG object or 0 + */ +int i2d_ECDSA_SIG(const ECDSA_SIG *sig, unsigned char **pp); + +/** Decodes a DER encoded ECDSA signature (note: this function changes *pp + * (*pp += len)). + * \param sig pointer to ECDSA_SIG pointer (may be NULL) + * \param pp memory buffer with the DER encoded signature + * \param len length of the buffer + * \return pointer to the decoded ECDSA_SIG structure (or NULL) + */ +ECDSA_SIG *d2i_ECDSA_SIG(ECDSA_SIG **sig, const unsigned char **pp, long len); + +/** Accessor for r and s fields of ECDSA_SIG + * \param sig pointer to ECDSA_SIG structure + * \param pr pointer to BIGNUM pointer for r (may be NULL) + * \param ps pointer to BIGNUM pointer for s (may be NULL) + */ +void ECDSA_SIG_get0(const ECDSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps); + +/** Accessor for r field of ECDSA_SIG + * \param sig pointer to ECDSA_SIG structure + */ +const BIGNUM *ECDSA_SIG_get0_r(const ECDSA_SIG *sig); + +/** Accessor for s field of ECDSA_SIG + * \param sig pointer to ECDSA_SIG structure + */ +const BIGNUM *ECDSA_SIG_get0_s(const ECDSA_SIG *sig); + +/** Setter for r and s fields of ECDSA_SIG + * \param sig pointer to ECDSA_SIG structure + * \param r pointer to BIGNUM for r (may be NULL) + * \param s pointer to BIGNUM for s (may be NULL) + */ +int ECDSA_SIG_set0(ECDSA_SIG *sig, BIGNUM *r, BIGNUM *s); + +/** Computes the ECDSA signature of the given hash value using + * the supplied private key and returns the created signature. + * \param dgst pointer to the hash value + * \param dgst_len length of the hash value + * \param eckey EC_KEY object containing a private EC key + * \return pointer to a ECDSA_SIG structure or NULL if an error occurred + */ +ECDSA_SIG *ECDSA_do_sign(const unsigned char *dgst, int dgst_len, + EC_KEY *eckey); + +/** Computes ECDSA signature of a given hash value using the supplied + * private key (note: sig must point to ECDSA_size(eckey) bytes of memory). + * \param dgst pointer to the hash value to sign + * \param dgstlen length of the hash value + * \param kinv BIGNUM with a pre-computed inverse k (optional) + * \param rp BIGNUM with a pre-computed rp value (optional), + * see ECDSA_sign_setup + * \param eckey EC_KEY object containing a private EC key + * \return pointer to a ECDSA_SIG structure or NULL if an error occurred + */ +ECDSA_SIG *ECDSA_do_sign_ex(const unsigned char *dgst, int dgstlen, + const BIGNUM *kinv, const BIGNUM *rp, + EC_KEY *eckey); + +/** Verifies that the supplied signature is a valid ECDSA + * signature of the supplied hash value using the supplied public key. + * \param dgst pointer to the hash value + * \param dgst_len length of the hash value + * \param sig ECDSA_SIG structure + * \param eckey EC_KEY object containing a public EC key + * \return 1 if the signature is valid, 0 if the signature is invalid + * and -1 on error + */ +int ECDSA_do_verify(const unsigned char *dgst, int dgst_len, + const ECDSA_SIG *sig, EC_KEY *eckey); + +/** Precompute parts of the signing operation + * \param eckey EC_KEY object containing a private EC key + * \param ctx BN_CTX object (optional) + * \param kinv BIGNUM pointer for the inverse of k + * \param rp BIGNUM pointer for x coordinate of k * generator + * \return 1 on success and 0 otherwise + */ +int ECDSA_sign_setup(EC_KEY *eckey, BN_CTX *ctx, BIGNUM **kinv, BIGNUM **rp); + +/** Computes ECDSA signature of a given hash value using the supplied + * private key (note: sig must point to ECDSA_size(eckey) bytes of memory). + * \param type this parameter is ignored + * \param dgst pointer to the hash value to sign + * \param dgstlen length of the hash value + * \param sig memory for the DER encoded created signature + * \param siglen pointer to the length of the returned signature + * \param eckey EC_KEY object containing a private EC key + * \return 1 on success and 0 otherwise + */ +int ECDSA_sign(int type, const unsigned char *dgst, int dgstlen, + unsigned char *sig, unsigned int *siglen, EC_KEY *eckey); + +/** Computes ECDSA signature of a given hash value using the supplied + * private key (note: sig must point to ECDSA_size(eckey) bytes of memory). + * \param type this parameter is ignored + * \param dgst pointer to the hash value to sign + * \param dgstlen length of the hash value + * \param sig buffer to hold the DER encoded signature + * \param siglen pointer to the length of the returned signature + * \param kinv BIGNUM with a pre-computed inverse k (optional) + * \param rp BIGNUM with a pre-computed rp value (optional), + * see ECDSA_sign_setup + * \param eckey EC_KEY object containing a private EC key + * \return 1 on success and 0 otherwise + */ +int ECDSA_sign_ex(int type, const unsigned char *dgst, int dgstlen, + unsigned char *sig, unsigned int *siglen, + const BIGNUM *kinv, const BIGNUM *rp, EC_KEY *eckey); + +/** Verifies that the given signature is valid ECDSA signature + * of the supplied hash value using the specified public key. + * \param type this parameter is ignored + * \param dgst pointer to the hash value + * \param dgstlen length of the hash value + * \param sig pointer to the DER encoded signature + * \param siglen length of the DER encoded signature + * \param eckey EC_KEY object containing a public EC key + * \return 1 if the signature is valid, 0 if the signature is invalid + * and -1 on error + */ +int ECDSA_verify(int type, const unsigned char *dgst, int dgstlen, + const unsigned char *sig, int siglen, EC_KEY *eckey); + +/** Returns the maximum length of the DER encoded signature + * \param eckey EC_KEY object + * \return numbers of bytes required for the DER encoded signature + */ +int ECDSA_size(const EC_KEY *eckey); + +/********************************************************************/ +/* EC_KEY_METHOD constructors, destructors, writers and accessors */ +/********************************************************************/ + +EC_KEY_METHOD *EC_KEY_METHOD_new(const EC_KEY_METHOD *meth); +void EC_KEY_METHOD_free(EC_KEY_METHOD *meth); +void EC_KEY_METHOD_set_init(EC_KEY_METHOD *meth, + int (*init)(EC_KEY *key), + void (*finish)(EC_KEY *key), + int (*copy)(EC_KEY *dest, const EC_KEY *src), + int (*set_group)(EC_KEY *key, const EC_GROUP *grp), + int (*set_private)(EC_KEY *key, + const BIGNUM *priv_key), + int (*set_public)(EC_KEY *key, + const EC_POINT *pub_key)); + +void EC_KEY_METHOD_set_keygen(EC_KEY_METHOD *meth, + int (*keygen)(EC_KEY *key)); + +void EC_KEY_METHOD_set_compute_key(EC_KEY_METHOD *meth, + int (*ckey)(unsigned char **psec, + size_t *pseclen, + const EC_POINT *pub_key, + const EC_KEY *ecdh)); + +void EC_KEY_METHOD_set_sign(EC_KEY_METHOD *meth, + int (*sign)(int type, const unsigned char *dgst, + int dlen, unsigned char *sig, + unsigned int *siglen, + const BIGNUM *kinv, const BIGNUM *r, + EC_KEY *eckey), + int (*sign_setup)(EC_KEY *eckey, BN_CTX *ctx_in, + BIGNUM **kinvp, BIGNUM **rp), + ECDSA_SIG *(*sign_sig)(const unsigned char *dgst, + int dgst_len, + const BIGNUM *in_kinv, + const BIGNUM *in_r, + EC_KEY *eckey)); + +void EC_KEY_METHOD_set_verify(EC_KEY_METHOD *meth, + int (*verify)(int type, const unsigned + char *dgst, int dgst_len, + const unsigned char *sigbuf, + int sig_len, EC_KEY *eckey), + int (*verify_sig)(const unsigned char *dgst, + int dgst_len, + const ECDSA_SIG *sig, + EC_KEY *eckey)); + +void EC_KEY_METHOD_get_init(const EC_KEY_METHOD *meth, + int (**pinit)(EC_KEY *key), + void (**pfinish)(EC_KEY *key), + int (**pcopy)(EC_KEY *dest, const EC_KEY *src), + int (**pset_group)(EC_KEY *key, + const EC_GROUP *grp), + int (**pset_private)(EC_KEY *key, + const BIGNUM *priv_key), + int (**pset_public)(EC_KEY *key, + const EC_POINT *pub_key)); + +void EC_KEY_METHOD_get_keygen(const EC_KEY_METHOD *meth, + int (**pkeygen)(EC_KEY *key)); + +void EC_KEY_METHOD_get_compute_key(const EC_KEY_METHOD *meth, + int (**pck)(unsigned char **psec, + size_t *pseclen, + const EC_POINT *pub_key, + const EC_KEY *ecdh)); + +void EC_KEY_METHOD_get_sign(const EC_KEY_METHOD *meth, + int (**psign)(int type, const unsigned char *dgst, + int dlen, unsigned char *sig, + unsigned int *siglen, + const BIGNUM *kinv, const BIGNUM *r, + EC_KEY *eckey), + int (**psign_setup)(EC_KEY *eckey, BN_CTX *ctx_in, + BIGNUM **kinvp, BIGNUM **rp), + ECDSA_SIG *(**psign_sig)(const unsigned char *dgst, + int dgst_len, + const BIGNUM *in_kinv, + const BIGNUM *in_r, + EC_KEY *eckey)); + +void EC_KEY_METHOD_get_verify(const EC_KEY_METHOD *meth, + int (**pverify)(int type, const unsigned + char *dgst, int dgst_len, + const unsigned char *sigbuf, + int sig_len, EC_KEY *eckey), + int (**pverify_sig)(const unsigned char *dgst, + int dgst_len, + const ECDSA_SIG *sig, + EC_KEY *eckey)); + +# define ECParameters_dup(x) ASN1_dup_of(EC_KEY,i2d_ECParameters,d2i_ECParameters,x) + +# ifndef __cplusplus +# if defined(__SUNPRO_C) +# if __SUNPRO_C >= 0x520 +# pragma error_messages (default,E_ARRAY_OF_INCOMPLETE_NONAME,E_ARRAY_OF_INCOMPLETE) +# endif +# endif +# endif + +# define EVP_PKEY_CTX_set_ec_paramgen_curve_nid(ctx, nid) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_PARAMGEN|EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID, nid, NULL) + +# define EVP_PKEY_CTX_set_ec_param_enc(ctx, flag) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_PARAMGEN|EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_EC_PARAM_ENC, flag, NULL) + +# define EVP_PKEY_CTX_set_ecdh_cofactor_mode(ctx, flag) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_EC_ECDH_COFACTOR, flag, NULL) + +# define EVP_PKEY_CTX_get_ecdh_cofactor_mode(ctx) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_EC_ECDH_COFACTOR, -2, NULL) + +# define EVP_PKEY_CTX_set_ecdh_kdf_type(ctx, kdf) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_EC_KDF_TYPE, kdf, NULL) + +# define EVP_PKEY_CTX_get_ecdh_kdf_type(ctx) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_EC_KDF_TYPE, -2, NULL) + +# define EVP_PKEY_CTX_set_ecdh_kdf_md(ctx, md) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_EC_KDF_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_get_ecdh_kdf_md(ctx, pmd) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_GET_EC_KDF_MD, 0, (void *)(pmd)) + +# define EVP_PKEY_CTX_set_ecdh_kdf_outlen(ctx, len) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_EC_KDF_OUTLEN, len, NULL) + +# define EVP_PKEY_CTX_get_ecdh_kdf_outlen(ctx, plen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_GET_EC_KDF_OUTLEN, 0, \ + (void *)(plen)) + +# define EVP_PKEY_CTX_set0_ecdh_kdf_ukm(ctx, p, plen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_EC_KDF_UKM, plen, (void *)(p)) + +# define EVP_PKEY_CTX_get0_ecdh_kdf_ukm(ctx, p) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_EC, \ + EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_GET_EC_KDF_UKM, 0, (void *)(p)) + +/* SM2 will skip the operation check so no need to pass operation here */ +# define EVP_PKEY_CTX_set1_id(ctx, id, id_len) \ + EVP_PKEY_CTX_ctrl(ctx, -1, -1, \ + EVP_PKEY_CTRL_SET1_ID, (int)id_len, (void*)(id)) + +# define EVP_PKEY_CTX_get1_id(ctx, id) \ + EVP_PKEY_CTX_ctrl(ctx, -1, -1, \ + EVP_PKEY_CTRL_GET1_ID, 0, (void*)(id)) + +# define EVP_PKEY_CTX_get1_id_len(ctx, id_len) \ + EVP_PKEY_CTX_ctrl(ctx, -1, -1, \ + EVP_PKEY_CTRL_GET1_ID_LEN, 0, (void*)(id_len)) + +# define EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID (EVP_PKEY_ALG_CTRL + 1) +# define EVP_PKEY_CTRL_EC_PARAM_ENC (EVP_PKEY_ALG_CTRL + 2) +# define EVP_PKEY_CTRL_EC_ECDH_COFACTOR (EVP_PKEY_ALG_CTRL + 3) +# define EVP_PKEY_CTRL_EC_KDF_TYPE (EVP_PKEY_ALG_CTRL + 4) +# define EVP_PKEY_CTRL_EC_KDF_MD (EVP_PKEY_ALG_CTRL + 5) +# define EVP_PKEY_CTRL_GET_EC_KDF_MD (EVP_PKEY_ALG_CTRL + 6) +# define EVP_PKEY_CTRL_EC_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 7) +# define EVP_PKEY_CTRL_GET_EC_KDF_OUTLEN (EVP_PKEY_ALG_CTRL + 8) +# define EVP_PKEY_CTRL_EC_KDF_UKM (EVP_PKEY_ALG_CTRL + 9) +# define EVP_PKEY_CTRL_GET_EC_KDF_UKM (EVP_PKEY_ALG_CTRL + 10) +# define EVP_PKEY_CTRL_SET1_ID (EVP_PKEY_ALG_CTRL + 11) +# define EVP_PKEY_CTRL_GET1_ID (EVP_PKEY_ALG_CTRL + 12) +# define EVP_PKEY_CTRL_GET1_ID_LEN (EVP_PKEY_ALG_CTRL + 13) +/* KDF types */ +# define EVP_PKEY_ECDH_KDF_NONE 1 +# define EVP_PKEY_ECDH_KDF_X9_62 2 + + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/ecdh.h b/include/openssl/ecdh.h new file mode 100644 index 0000000..61b5bd3 --- /dev/null +++ b/include/openssl/ecdh.h @@ -0,0 +1,10 @@ +/* + * Copyright 2002-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include diff --git a/include/openssl/ecdsa.h b/include/openssl/ecdsa.h new file mode 100644 index 0000000..61b5bd3 --- /dev/null +++ b/include/openssl/ecdsa.h @@ -0,0 +1,10 @@ +/* + * Copyright 2002-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include diff --git a/include/openssl/ecerr.h b/include/openssl/ecerr.h new file mode 100644 index 0000000..de4275a --- /dev/null +++ b/include/openssl/ecerr.h @@ -0,0 +1,267 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ECERR_H +# define HEADER_ECERR_H + +# include + +# ifndef OPENSSL_NO_EC + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_EC_strings(void); + +/* + * EC function codes. + */ +# define EC_F_BN_TO_FELEM 224 +# define EC_F_D2I_ECPARAMETERS 144 +# define EC_F_D2I_ECPKPARAMETERS 145 +# define EC_F_D2I_ECPRIVATEKEY 146 +# define EC_F_DO_EC_KEY_PRINT 221 +# define EC_F_ECDH_CMS_DECRYPT 238 +# define EC_F_ECDH_CMS_SET_SHARED_INFO 239 +# define EC_F_ECDH_COMPUTE_KEY 246 +# define EC_F_ECDH_SIMPLE_COMPUTE_KEY 257 +# define EC_F_ECDSA_DO_SIGN_EX 251 +# define EC_F_ECDSA_DO_VERIFY 252 +# define EC_F_ECDSA_SIGN_EX 254 +# define EC_F_ECDSA_SIGN_SETUP 248 +# define EC_F_ECDSA_SIG_NEW 265 +# define EC_F_ECDSA_VERIFY 253 +# define EC_F_ECD_ITEM_VERIFY 270 +# define EC_F_ECKEY_PARAM2TYPE 223 +# define EC_F_ECKEY_PARAM_DECODE 212 +# define EC_F_ECKEY_PRIV_DECODE 213 +# define EC_F_ECKEY_PRIV_ENCODE 214 +# define EC_F_ECKEY_PUB_DECODE 215 +# define EC_F_ECKEY_PUB_ENCODE 216 +# define EC_F_ECKEY_TYPE2PARAM 220 +# define EC_F_ECPARAMETERS_PRINT 147 +# define EC_F_ECPARAMETERS_PRINT_FP 148 +# define EC_F_ECPKPARAMETERS_PRINT 149 +# define EC_F_ECPKPARAMETERS_PRINT_FP 150 +# define EC_F_ECP_NISTZ256_GET_AFFINE 240 +# define EC_F_ECP_NISTZ256_INV_MOD_ORD 275 +# define EC_F_ECP_NISTZ256_MULT_PRECOMPUTE 243 +# define EC_F_ECP_NISTZ256_POINTS_MUL 241 +# define EC_F_ECP_NISTZ256_PRE_COMP_NEW 244 +# define EC_F_ECP_NISTZ256_WINDOWED_MUL 242 +# define EC_F_ECX_KEY_OP 266 +# define EC_F_ECX_PRIV_ENCODE 267 +# define EC_F_ECX_PUB_ENCODE 268 +# define EC_F_EC_ASN1_GROUP2CURVE 153 +# define EC_F_EC_ASN1_GROUP2FIELDID 154 +# define EC_F_EC_GF2M_MONTGOMERY_POINT_MULTIPLY 208 +# define EC_F_EC_GF2M_SIMPLE_GROUP_CHECK_DISCRIMINANT 159 +# define EC_F_EC_GF2M_SIMPLE_GROUP_SET_CURVE 195 +# define EC_F_EC_GF2M_SIMPLE_LADDER_POST 285 +# define EC_F_EC_GF2M_SIMPLE_LADDER_PRE 288 +# define EC_F_EC_GF2M_SIMPLE_OCT2POINT 160 +# define EC_F_EC_GF2M_SIMPLE_POINT2OCT 161 +# define EC_F_EC_GF2M_SIMPLE_POINTS_MUL 289 +# define EC_F_EC_GF2M_SIMPLE_POINT_GET_AFFINE_COORDINATES 162 +# define EC_F_EC_GF2M_SIMPLE_POINT_SET_AFFINE_COORDINATES 163 +# define EC_F_EC_GF2M_SIMPLE_SET_COMPRESSED_COORDINATES 164 +# define EC_F_EC_GFP_MONT_FIELD_DECODE 133 +# define EC_F_EC_GFP_MONT_FIELD_ENCODE 134 +# define EC_F_EC_GFP_MONT_FIELD_MUL 131 +# define EC_F_EC_GFP_MONT_FIELD_SET_TO_ONE 209 +# define EC_F_EC_GFP_MONT_FIELD_SQR 132 +# define EC_F_EC_GFP_MONT_GROUP_SET_CURVE 189 +# define EC_F_EC_GFP_NISTP224_GROUP_SET_CURVE 225 +# define EC_F_EC_GFP_NISTP224_POINTS_MUL 228 +# define EC_F_EC_GFP_NISTP224_POINT_GET_AFFINE_COORDINATES 226 +# define EC_F_EC_GFP_NISTP256_GROUP_SET_CURVE 230 +# define EC_F_EC_GFP_NISTP256_POINTS_MUL 231 +# define EC_F_EC_GFP_NISTP256_POINT_GET_AFFINE_COORDINATES 232 +# define EC_F_EC_GFP_NISTP521_GROUP_SET_CURVE 233 +# define EC_F_EC_GFP_NISTP521_POINTS_MUL 234 +# define EC_F_EC_GFP_NISTP521_POINT_GET_AFFINE_COORDINATES 235 +# define EC_F_EC_GFP_NIST_FIELD_MUL 200 +# define EC_F_EC_GFP_NIST_FIELD_SQR 201 +# define EC_F_EC_GFP_NIST_GROUP_SET_CURVE 202 +# define EC_F_EC_GFP_SIMPLE_BLIND_COORDINATES 287 +# define EC_F_EC_GFP_SIMPLE_GROUP_CHECK_DISCRIMINANT 165 +# define EC_F_EC_GFP_SIMPLE_GROUP_SET_CURVE 166 +# define EC_F_EC_GFP_SIMPLE_MAKE_AFFINE 102 +# define EC_F_EC_GFP_SIMPLE_OCT2POINT 103 +# define EC_F_EC_GFP_SIMPLE_POINT2OCT 104 +# define EC_F_EC_GFP_SIMPLE_POINTS_MAKE_AFFINE 137 +# define EC_F_EC_GFP_SIMPLE_POINT_GET_AFFINE_COORDINATES 167 +# define EC_F_EC_GFP_SIMPLE_POINT_SET_AFFINE_COORDINATES 168 +# define EC_F_EC_GFP_SIMPLE_SET_COMPRESSED_COORDINATES 169 +# define EC_F_EC_GROUP_CHECK 170 +# define EC_F_EC_GROUP_CHECK_DISCRIMINANT 171 +# define EC_F_EC_GROUP_COPY 106 +# define EC_F_EC_GROUP_GET_CURVE 291 +# define EC_F_EC_GROUP_GET_CURVE_GF2M 172 +# define EC_F_EC_GROUP_GET_CURVE_GFP 130 +# define EC_F_EC_GROUP_GET_DEGREE 173 +# define EC_F_EC_GROUP_GET_ECPARAMETERS 261 +# define EC_F_EC_GROUP_GET_ECPKPARAMETERS 262 +# define EC_F_EC_GROUP_GET_PENTANOMIAL_BASIS 193 +# define EC_F_EC_GROUP_GET_TRINOMIAL_BASIS 194 +# define EC_F_EC_GROUP_NEW 108 +# define EC_F_EC_GROUP_NEW_BY_CURVE_NAME 174 +# define EC_F_EC_GROUP_NEW_FROM_DATA 175 +# define EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS 263 +# define EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS 264 +# define EC_F_EC_GROUP_SET_CURVE 292 +# define EC_F_EC_GROUP_SET_CURVE_GF2M 176 +# define EC_F_EC_GROUP_SET_CURVE_GFP 109 +# define EC_F_EC_GROUP_SET_GENERATOR 111 +# define EC_F_EC_GROUP_SET_SEED 286 +# define EC_F_EC_KEY_CHECK_KEY 177 +# define EC_F_EC_KEY_COPY 178 +# define EC_F_EC_KEY_GENERATE_KEY 179 +# define EC_F_EC_KEY_NEW 182 +# define EC_F_EC_KEY_NEW_METHOD 245 +# define EC_F_EC_KEY_OCT2PRIV 255 +# define EC_F_EC_KEY_PRINT 180 +# define EC_F_EC_KEY_PRINT_FP 181 +# define EC_F_EC_KEY_PRIV2BUF 279 +# define EC_F_EC_KEY_PRIV2OCT 256 +# define EC_F_EC_KEY_SET_PUBLIC_KEY_AFFINE_COORDINATES 229 +# define EC_F_EC_KEY_SIMPLE_CHECK_KEY 258 +# define EC_F_EC_KEY_SIMPLE_OCT2PRIV 259 +# define EC_F_EC_KEY_SIMPLE_PRIV2OCT 260 +# define EC_F_EC_PKEY_CHECK 273 +# define EC_F_EC_PKEY_PARAM_CHECK 274 +# define EC_F_EC_POINTS_MAKE_AFFINE 136 +# define EC_F_EC_POINTS_MUL 290 +# define EC_F_EC_POINT_ADD 112 +# define EC_F_EC_POINT_BN2POINT 280 +# define EC_F_EC_POINT_CMP 113 +# define EC_F_EC_POINT_COPY 114 +# define EC_F_EC_POINT_DBL 115 +# define EC_F_EC_POINT_GET_AFFINE_COORDINATES 293 +# define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GF2M 183 +# define EC_F_EC_POINT_GET_AFFINE_COORDINATES_GFP 116 +# define EC_F_EC_POINT_GET_JPROJECTIVE_COORDINATES_GFP 117 +# define EC_F_EC_POINT_INVERT 210 +# define EC_F_EC_POINT_IS_AT_INFINITY 118 +# define EC_F_EC_POINT_IS_ON_CURVE 119 +# define EC_F_EC_POINT_MAKE_AFFINE 120 +# define EC_F_EC_POINT_NEW 121 +# define EC_F_EC_POINT_OCT2POINT 122 +# define EC_F_EC_POINT_POINT2BUF 281 +# define EC_F_EC_POINT_POINT2OCT 123 +# define EC_F_EC_POINT_SET_AFFINE_COORDINATES 294 +# define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GF2M 185 +# define EC_F_EC_POINT_SET_AFFINE_COORDINATES_GFP 124 +# define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES 295 +# define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GF2M 186 +# define EC_F_EC_POINT_SET_COMPRESSED_COORDINATES_GFP 125 +# define EC_F_EC_POINT_SET_JPROJECTIVE_COORDINATES_GFP 126 +# define EC_F_EC_POINT_SET_TO_INFINITY 127 +# define EC_F_EC_PRE_COMP_NEW 196 +# define EC_F_EC_SCALAR_MUL_LADDER 284 +# define EC_F_EC_WNAF_MUL 187 +# define EC_F_EC_WNAF_PRECOMPUTE_MULT 188 +# define EC_F_I2D_ECPARAMETERS 190 +# define EC_F_I2D_ECPKPARAMETERS 191 +# define EC_F_I2D_ECPRIVATEKEY 192 +# define EC_F_I2O_ECPUBLICKEY 151 +# define EC_F_NISTP224_PRE_COMP_NEW 227 +# define EC_F_NISTP256_PRE_COMP_NEW 236 +# define EC_F_NISTP521_PRE_COMP_NEW 237 +# define EC_F_O2I_ECPUBLICKEY 152 +# define EC_F_OLD_EC_PRIV_DECODE 222 +# define EC_F_OSSL_ECDH_COMPUTE_KEY 247 +# define EC_F_OSSL_ECDSA_SIGN_SIG 249 +# define EC_F_OSSL_ECDSA_VERIFY_SIG 250 +# define EC_F_PKEY_ECD_CTRL 271 +# define EC_F_PKEY_ECD_DIGESTSIGN 272 +# define EC_F_PKEY_ECD_DIGESTSIGN25519 276 +# define EC_F_PKEY_ECD_DIGESTSIGN448 277 +# define EC_F_PKEY_ECX_DERIVE 269 +# define EC_F_PKEY_EC_CTRL 197 +# define EC_F_PKEY_EC_CTRL_STR 198 +# define EC_F_PKEY_EC_DERIVE 217 +# define EC_F_PKEY_EC_INIT 282 +# define EC_F_PKEY_EC_KDF_DERIVE 283 +# define EC_F_PKEY_EC_KEYGEN 199 +# define EC_F_PKEY_EC_PARAMGEN 219 +# define EC_F_PKEY_EC_SIGN 218 +# define EC_F_VALIDATE_ECX_DERIVE 278 + +/* + * EC reason codes. + */ +# define EC_R_ASN1_ERROR 115 +# define EC_R_BAD_SIGNATURE 156 +# define EC_R_BIGNUM_OUT_OF_RANGE 144 +# define EC_R_BUFFER_TOO_SMALL 100 +# define EC_R_COORDINATES_OUT_OF_RANGE 146 +# define EC_R_CURVE_DOES_NOT_SUPPORT_ECDH 160 +# define EC_R_CURVE_DOES_NOT_SUPPORT_SIGNING 159 +# define EC_R_D2I_ECPKPARAMETERS_FAILURE 117 +# define EC_R_DECODE_ERROR 142 +# define EC_R_DISCRIMINANT_IS_ZERO 118 +# define EC_R_EC_GROUP_NEW_BY_NAME_FAILURE 119 +# define EC_R_FIELD_TOO_LARGE 143 +# define EC_R_GF2M_NOT_SUPPORTED 147 +# define EC_R_GROUP2PKPARAMETERS_FAILURE 120 +# define EC_R_I2D_ECPKPARAMETERS_FAILURE 121 +# define EC_R_INCOMPATIBLE_OBJECTS 101 +# define EC_R_INVALID_ARGUMENT 112 +# define EC_R_INVALID_COMPRESSED_POINT 110 +# define EC_R_INVALID_COMPRESSION_BIT 109 +# define EC_R_INVALID_CURVE 141 +# define EC_R_INVALID_DIGEST 151 +# define EC_R_INVALID_DIGEST_TYPE 138 +# define EC_R_INVALID_ENCODING 102 +# define EC_R_INVALID_FIELD 103 +# define EC_R_INVALID_FORM 104 +# define EC_R_INVALID_GROUP_ORDER 122 +# define EC_R_INVALID_KEY 116 +# define EC_R_INVALID_OUTPUT_LENGTH 161 +# define EC_R_INVALID_PEER_KEY 133 +# define EC_R_INVALID_PENTANOMIAL_BASIS 132 +# define EC_R_INVALID_PRIVATE_KEY 123 +# define EC_R_INVALID_TRINOMIAL_BASIS 137 +# define EC_R_KDF_PARAMETER_ERROR 148 +# define EC_R_KEYS_NOT_SET 140 +# define EC_R_LADDER_POST_FAILURE 136 +# define EC_R_LADDER_PRE_FAILURE 153 +# define EC_R_LADDER_STEP_FAILURE 162 +# define EC_R_MISSING_PARAMETERS 124 +# define EC_R_MISSING_PRIVATE_KEY 125 +# define EC_R_NEED_NEW_SETUP_VALUES 157 +# define EC_R_NOT_A_NIST_PRIME 135 +# define EC_R_NOT_IMPLEMENTED 126 +# define EC_R_NOT_INITIALIZED 111 +# define EC_R_NO_PARAMETERS_SET 139 +# define EC_R_NO_PRIVATE_VALUE 154 +# define EC_R_OPERATION_NOT_SUPPORTED 152 +# define EC_R_PASSED_NULL_PARAMETER 134 +# define EC_R_PEER_KEY_ERROR 149 +# define EC_R_PKPARAMETERS2GROUP_FAILURE 127 +# define EC_R_POINT_ARITHMETIC_FAILURE 155 +# define EC_R_POINT_AT_INFINITY 106 +# define EC_R_POINT_COORDINATES_BLIND_FAILURE 163 +# define EC_R_POINT_IS_NOT_ON_CURVE 107 +# define EC_R_RANDOM_NUMBER_GENERATION_FAILED 158 +# define EC_R_SHARED_INFO_ERROR 150 +# define EC_R_SLOT_FULL 108 +# define EC_R_UNDEFINED_GENERATOR 113 +# define EC_R_UNDEFINED_ORDER 128 +# define EC_R_UNKNOWN_COFACTOR 164 +# define EC_R_UNKNOWN_GROUP 129 +# define EC_R_UNKNOWN_ORDER 114 +# define EC_R_UNSUPPORTED_FIELD 131 +# define EC_R_WRONG_CURVE_PARAMETERS 145 +# define EC_R_WRONG_ORDER 130 + +# endif +#endif diff --git a/include/openssl/engine.h b/include/openssl/engine.h new file mode 100644 index 0000000..baa1578 --- /dev/null +++ b/include/openssl/engine.h @@ -0,0 +1,751 @@ +/* + * Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ENGINE_H +# define HEADER_ENGINE_H + +# include + +# ifndef OPENSSL_NO_ENGINE +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# include +# include +# include +# include +# include +# include +# include +# endif +# include +# include +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +/* + * These flags are used to control combinations of algorithm (methods) by + * bitwise "OR"ing. + */ +# define ENGINE_METHOD_RSA (unsigned int)0x0001 +# define ENGINE_METHOD_DSA (unsigned int)0x0002 +# define ENGINE_METHOD_DH (unsigned int)0x0004 +# define ENGINE_METHOD_RAND (unsigned int)0x0008 +# define ENGINE_METHOD_CIPHERS (unsigned int)0x0040 +# define ENGINE_METHOD_DIGESTS (unsigned int)0x0080 +# define ENGINE_METHOD_PKEY_METHS (unsigned int)0x0200 +# define ENGINE_METHOD_PKEY_ASN1_METHS (unsigned int)0x0400 +# define ENGINE_METHOD_EC (unsigned int)0x0800 +/* Obvious all-or-nothing cases. */ +# define ENGINE_METHOD_ALL (unsigned int)0xFFFF +# define ENGINE_METHOD_NONE (unsigned int)0x0000 + +/* + * This(ese) flag(s) controls behaviour of the ENGINE_TABLE mechanism used + * internally to control registration of ENGINE implementations, and can be + * set by ENGINE_set_table_flags(). The "NOINIT" flag prevents attempts to + * initialise registered ENGINEs if they are not already initialised. + */ +# define ENGINE_TABLE_FLAG_NOINIT (unsigned int)0x0001 + +/* ENGINE flags that can be set by ENGINE_set_flags(). */ +/* Not used */ +/* #define ENGINE_FLAGS_MALLOCED 0x0001 */ + +/* + * This flag is for ENGINEs that wish to handle the various 'CMD'-related + * control commands on their own. Without this flag, ENGINE_ctrl() handles + * these control commands on behalf of the ENGINE using their "cmd_defns" + * data. + */ +# define ENGINE_FLAGS_MANUAL_CMD_CTRL (int)0x0002 + +/* + * This flag is for ENGINEs who return new duplicate structures when found + * via "ENGINE_by_id()". When an ENGINE must store state (eg. if + * ENGINE_ctrl() commands are called in sequence as part of some stateful + * process like key-generation setup and execution), it can set this flag - + * then each attempt to obtain the ENGINE will result in it being copied into + * a new structure. Normally, ENGINEs don't declare this flag so + * ENGINE_by_id() just increments the existing ENGINE's structural reference + * count. + */ +# define ENGINE_FLAGS_BY_ID_COPY (int)0x0004 + +/* + * This flag if for an ENGINE that does not want its methods registered as + * part of ENGINE_register_all_complete() for example if the methods are not + * usable as default methods. + */ + +# define ENGINE_FLAGS_NO_REGISTER_ALL (int)0x0008 + +/* + * ENGINEs can support their own command types, and these flags are used in + * ENGINE_CTRL_GET_CMD_FLAGS to indicate to the caller what kind of input + * each command expects. Currently only numeric and string input is + * supported. If a control command supports none of the _NUMERIC, _STRING, or + * _NO_INPUT options, then it is regarded as an "internal" control command - + * and not for use in config setting situations. As such, they're not + * available to the ENGINE_ctrl_cmd_string() function, only raw ENGINE_ctrl() + * access. Changes to this list of 'command types' should be reflected + * carefully in ENGINE_cmd_is_executable() and ENGINE_ctrl_cmd_string(). + */ + +/* accepts a 'long' input value (3rd parameter to ENGINE_ctrl) */ +# define ENGINE_CMD_FLAG_NUMERIC (unsigned int)0x0001 +/* + * accepts string input (cast from 'void*' to 'const char *', 4th parameter + * to ENGINE_ctrl) + */ +# define ENGINE_CMD_FLAG_STRING (unsigned int)0x0002 +/* + * Indicates that the control command takes *no* input. Ie. the control + * command is unparameterised. + */ +# define ENGINE_CMD_FLAG_NO_INPUT (unsigned int)0x0004 +/* + * Indicates that the control command is internal. This control command won't + * be shown in any output, and is only usable through the ENGINE_ctrl_cmd() + * function. + */ +# define ENGINE_CMD_FLAG_INTERNAL (unsigned int)0x0008 + +/* + * NB: These 3 control commands are deprecated and should not be used. + * ENGINEs relying on these commands should compile conditional support for + * compatibility (eg. if these symbols are defined) but should also migrate + * the same functionality to their own ENGINE-specific control functions that + * can be "discovered" by calling applications. The fact these control + * commands wouldn't be "executable" (ie. usable by text-based config) + * doesn't change the fact that application code can find and use them + * without requiring per-ENGINE hacking. + */ + +/* + * These flags are used to tell the ctrl function what should be done. All + * command numbers are shared between all engines, even if some don't make + * sense to some engines. In such a case, they do nothing but return the + * error ENGINE_R_CTRL_COMMAND_NOT_IMPLEMENTED. + */ +# define ENGINE_CTRL_SET_LOGSTREAM 1 +# define ENGINE_CTRL_SET_PASSWORD_CALLBACK 2 +# define ENGINE_CTRL_HUP 3/* Close and reinitialise + * any handles/connections + * etc. */ +# define ENGINE_CTRL_SET_USER_INTERFACE 4/* Alternative to callback */ +# define ENGINE_CTRL_SET_CALLBACK_DATA 5/* User-specific data, used + * when calling the password + * callback and the user + * interface */ +# define ENGINE_CTRL_LOAD_CONFIGURATION 6/* Load a configuration, + * given a string that + * represents a file name + * or so */ +# define ENGINE_CTRL_LOAD_SECTION 7/* Load data from a given + * section in the already + * loaded configuration */ + +/* + * These control commands allow an application to deal with an arbitrary + * engine in a dynamic way. Warn: Negative return values indicate errors FOR + * THESE COMMANDS because zero is used to indicate 'end-of-list'. Other + * commands, including ENGINE-specific command types, return zero for an + * error. An ENGINE can choose to implement these ctrl functions, and can + * internally manage things however it chooses - it does so by setting the + * ENGINE_FLAGS_MANUAL_CMD_CTRL flag (using ENGINE_set_flags()). Otherwise + * the ENGINE_ctrl() code handles this on the ENGINE's behalf using the + * cmd_defns data (set using ENGINE_set_cmd_defns()). This means an ENGINE's + * ctrl() handler need only implement its own commands - the above "meta" + * commands will be taken care of. + */ + +/* + * Returns non-zero if the supplied ENGINE has a ctrl() handler. If "not", + * then all the remaining control commands will return failure, so it is + * worth checking this first if the caller is trying to "discover" the + * engine's capabilities and doesn't want errors generated unnecessarily. + */ +# define ENGINE_CTRL_HAS_CTRL_FUNCTION 10 +/* + * Returns a positive command number for the first command supported by the + * engine. Returns zero if no ctrl commands are supported. + */ +# define ENGINE_CTRL_GET_FIRST_CMD_TYPE 11 +/* + * The 'long' argument specifies a command implemented by the engine, and the + * return value is the next command supported, or zero if there are no more. + */ +# define ENGINE_CTRL_GET_NEXT_CMD_TYPE 12 +/* + * The 'void*' argument is a command name (cast from 'const char *'), and the + * return value is the command that corresponds to it. + */ +# define ENGINE_CTRL_GET_CMD_FROM_NAME 13 +/* + * The next two allow a command to be converted into its corresponding string + * form. In each case, the 'long' argument supplies the command. In the + * NAME_LEN case, the return value is the length of the command name (not + * counting a trailing EOL). In the NAME case, the 'void*' argument must be a + * string buffer large enough, and it will be populated with the name of the + * command (WITH a trailing EOL). + */ +# define ENGINE_CTRL_GET_NAME_LEN_FROM_CMD 14 +# define ENGINE_CTRL_GET_NAME_FROM_CMD 15 +/* The next two are similar but give a "short description" of a command. */ +# define ENGINE_CTRL_GET_DESC_LEN_FROM_CMD 16 +# define ENGINE_CTRL_GET_DESC_FROM_CMD 17 +/* + * With this command, the return value is the OR'd combination of + * ENGINE_CMD_FLAG_*** values that indicate what kind of input a given + * engine-specific ctrl command expects. + */ +# define ENGINE_CTRL_GET_CMD_FLAGS 18 + +/* + * ENGINE implementations should start the numbering of their own control + * commands from this value. (ie. ENGINE_CMD_BASE, ENGINE_CMD_BASE + 1, etc). + */ +# define ENGINE_CMD_BASE 200 + +/* + * NB: These 2 nCipher "chil" control commands are deprecated, and their + * functionality is now available through ENGINE-specific control commands + * (exposed through the above-mentioned 'CMD'-handling). Code using these 2 + * commands should be migrated to the more general command handling before + * these are removed. + */ + +/* Flags specific to the nCipher "chil" engine */ +# define ENGINE_CTRL_CHIL_SET_FORKCHECK 100 + /* + * Depending on the value of the (long)i argument, this sets or + * unsets the SimpleForkCheck flag in the CHIL API to enable or + * disable checking and workarounds for applications that fork(). + */ +# define ENGINE_CTRL_CHIL_NO_LOCKING 101 + /* + * This prevents the initialisation function from providing mutex + * callbacks to the nCipher library. + */ + +/* + * If an ENGINE supports its own specific control commands and wishes the + * framework to handle the above 'ENGINE_CMD_***'-manipulation commands on + * its behalf, it should supply a null-terminated array of ENGINE_CMD_DEFN + * entries to ENGINE_set_cmd_defns(). It should also implement a ctrl() + * handler that supports the stated commands (ie. the "cmd_num" entries as + * described by the array). NB: The array must be ordered in increasing order + * of cmd_num. "null-terminated" means that the last ENGINE_CMD_DEFN element + * has cmd_num set to zero and/or cmd_name set to NULL. + */ +typedef struct ENGINE_CMD_DEFN_st { + unsigned int cmd_num; /* The command number */ + const char *cmd_name; /* The command name itself */ + const char *cmd_desc; /* A short description of the command */ + unsigned int cmd_flags; /* The input the command expects */ +} ENGINE_CMD_DEFN; + +/* Generic function pointer */ +typedef int (*ENGINE_GEN_FUNC_PTR) (void); +/* Generic function pointer taking no arguments */ +typedef int (*ENGINE_GEN_INT_FUNC_PTR) (ENGINE *); +/* Specific control function pointer */ +typedef int (*ENGINE_CTRL_FUNC_PTR) (ENGINE *, int, long, void *, + void (*f) (void)); +/* Generic load_key function pointer */ +typedef EVP_PKEY *(*ENGINE_LOAD_KEY_PTR)(ENGINE *, const char *, + UI_METHOD *ui_method, + void *callback_data); +typedef int (*ENGINE_SSL_CLIENT_CERT_PTR) (ENGINE *, SSL *ssl, + STACK_OF(X509_NAME) *ca_dn, + X509 **pcert, EVP_PKEY **pkey, + STACK_OF(X509) **pother, + UI_METHOD *ui_method, + void *callback_data); +/*- + * These callback types are for an ENGINE's handler for cipher and digest logic. + * These handlers have these prototypes; + * int foo(ENGINE *e, const EVP_CIPHER **cipher, const int **nids, int nid); + * int foo(ENGINE *e, const EVP_MD **digest, const int **nids, int nid); + * Looking at how to implement these handlers in the case of cipher support, if + * the framework wants the EVP_CIPHER for 'nid', it will call; + * foo(e, &p_evp_cipher, NULL, nid); (return zero for failure) + * If the framework wants a list of supported 'nid's, it will call; + * foo(e, NULL, &p_nids, 0); (returns number of 'nids' or -1 for error) + */ +/* + * Returns to a pointer to the array of supported cipher 'nid's. If the + * second parameter is non-NULL it is set to the size of the returned array. + */ +typedef int (*ENGINE_CIPHERS_PTR) (ENGINE *, const EVP_CIPHER **, + const int **, int); +typedef int (*ENGINE_DIGESTS_PTR) (ENGINE *, const EVP_MD **, const int **, + int); +typedef int (*ENGINE_PKEY_METHS_PTR) (ENGINE *, EVP_PKEY_METHOD **, + const int **, int); +typedef int (*ENGINE_PKEY_ASN1_METHS_PTR) (ENGINE *, EVP_PKEY_ASN1_METHOD **, + const int **, int); +/* + * STRUCTURE functions ... all of these functions deal with pointers to + * ENGINE structures where the pointers have a "structural reference". This + * means that their reference is to allowed access to the structure but it + * does not imply that the structure is functional. To simply increment or + * decrement the structural reference count, use ENGINE_by_id and + * ENGINE_free. NB: This is not required when iterating using ENGINE_get_next + * as it will automatically decrement the structural reference count of the + * "current" ENGINE and increment the structural reference count of the + * ENGINE it returns (unless it is NULL). + */ + +/* Get the first/last "ENGINE" type available. */ +ENGINE *ENGINE_get_first(void); +ENGINE *ENGINE_get_last(void); +/* Iterate to the next/previous "ENGINE" type (NULL = end of the list). */ +ENGINE *ENGINE_get_next(ENGINE *e); +ENGINE *ENGINE_get_prev(ENGINE *e); +/* Add another "ENGINE" type into the array. */ +int ENGINE_add(ENGINE *e); +/* Remove an existing "ENGINE" type from the array. */ +int ENGINE_remove(ENGINE *e); +/* Retrieve an engine from the list by its unique "id" value. */ +ENGINE *ENGINE_by_id(const char *id); + +#if OPENSSL_API_COMPAT < 0x10100000L +# define ENGINE_load_openssl() \ + OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_OPENSSL, NULL) +# define ENGINE_load_dynamic() \ + OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_DYNAMIC, NULL) +# ifndef OPENSSL_NO_STATIC_ENGINE +# define ENGINE_load_padlock() \ + OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_PADLOCK, NULL) +# define ENGINE_load_capi() \ + OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_CAPI, NULL) +# define ENGINE_load_afalg() \ + OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_AFALG, NULL) +# endif +# define ENGINE_load_cryptodev() \ + OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_CRYPTODEV, NULL) +# define ENGINE_load_rdrand() \ + OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_RDRAND, NULL) +#endif +void ENGINE_load_builtin_engines(void); + +/* + * Get and set global flags (ENGINE_TABLE_FLAG_***) for the implementation + * "registry" handling. + */ +unsigned int ENGINE_get_table_flags(void); +void ENGINE_set_table_flags(unsigned int flags); + +/*- Manage registration of ENGINEs per "table". For each type, there are 3 + * functions; + * ENGINE_register_***(e) - registers the implementation from 'e' (if it has one) + * ENGINE_unregister_***(e) - unregister the implementation from 'e' + * ENGINE_register_all_***() - call ENGINE_register_***() for each 'e' in the list + * Cleanup is automatically registered from each table when required. + */ + +int ENGINE_register_RSA(ENGINE *e); +void ENGINE_unregister_RSA(ENGINE *e); +void ENGINE_register_all_RSA(void); + +int ENGINE_register_DSA(ENGINE *e); +void ENGINE_unregister_DSA(ENGINE *e); +void ENGINE_register_all_DSA(void); + +int ENGINE_register_EC(ENGINE *e); +void ENGINE_unregister_EC(ENGINE *e); +void ENGINE_register_all_EC(void); + +int ENGINE_register_DH(ENGINE *e); +void ENGINE_unregister_DH(ENGINE *e); +void ENGINE_register_all_DH(void); + +int ENGINE_register_RAND(ENGINE *e); +void ENGINE_unregister_RAND(ENGINE *e); +void ENGINE_register_all_RAND(void); + +int ENGINE_register_ciphers(ENGINE *e); +void ENGINE_unregister_ciphers(ENGINE *e); +void ENGINE_register_all_ciphers(void); + +int ENGINE_register_digests(ENGINE *e); +void ENGINE_unregister_digests(ENGINE *e); +void ENGINE_register_all_digests(void); + +int ENGINE_register_pkey_meths(ENGINE *e); +void ENGINE_unregister_pkey_meths(ENGINE *e); +void ENGINE_register_all_pkey_meths(void); + +int ENGINE_register_pkey_asn1_meths(ENGINE *e); +void ENGINE_unregister_pkey_asn1_meths(ENGINE *e); +void ENGINE_register_all_pkey_asn1_meths(void); + +/* + * These functions register all support from the above categories. Note, use + * of these functions can result in static linkage of code your application + * may not need. If you only need a subset of functionality, consider using + * more selective initialisation. + */ +int ENGINE_register_complete(ENGINE *e); +int ENGINE_register_all_complete(void); + +/* + * Send parameterised control commands to the engine. The possibilities to + * send down an integer, a pointer to data or a function pointer are + * provided. Any of the parameters may or may not be NULL, depending on the + * command number. In actuality, this function only requires a structural + * (rather than functional) reference to an engine, but many control commands + * may require the engine be functional. The caller should be aware of trying + * commands that require an operational ENGINE, and only use functional + * references in such situations. + */ +int ENGINE_ctrl(ENGINE *e, int cmd, long i, void *p, void (*f) (void)); + +/* + * This function tests if an ENGINE-specific command is usable as a + * "setting". Eg. in an application's config file that gets processed through + * ENGINE_ctrl_cmd_string(). If this returns zero, it is not available to + * ENGINE_ctrl_cmd_string(), only ENGINE_ctrl(). + */ +int ENGINE_cmd_is_executable(ENGINE *e, int cmd); + +/* + * This function works like ENGINE_ctrl() with the exception of taking a + * command name instead of a command number, and can handle optional + * commands. See the comment on ENGINE_ctrl_cmd_string() for an explanation + * on how to use the cmd_name and cmd_optional. + */ +int ENGINE_ctrl_cmd(ENGINE *e, const char *cmd_name, + long i, void *p, void (*f) (void), int cmd_optional); + +/* + * This function passes a command-name and argument to an ENGINE. The + * cmd_name is converted to a command number and the control command is + * called using 'arg' as an argument (unless the ENGINE doesn't support such + * a command, in which case no control command is called). The command is + * checked for input flags, and if necessary the argument will be converted + * to a numeric value. If cmd_optional is non-zero, then if the ENGINE + * doesn't support the given cmd_name the return value will be success + * anyway. This function is intended for applications to use so that users + * (or config files) can supply engine-specific config data to the ENGINE at + * run-time to control behaviour of specific engines. As such, it shouldn't + * be used for calling ENGINE_ctrl() functions that return data, deal with + * binary data, or that are otherwise supposed to be used directly through + * ENGINE_ctrl() in application code. Any "return" data from an ENGINE_ctrl() + * operation in this function will be lost - the return value is interpreted + * as failure if the return value is zero, success otherwise, and this + * function returns a boolean value as a result. In other words, vendors of + * 'ENGINE'-enabled devices should write ENGINE implementations with + * parameterisations that work in this scheme, so that compliant ENGINE-based + * applications can work consistently with the same configuration for the + * same ENGINE-enabled devices, across applications. + */ +int ENGINE_ctrl_cmd_string(ENGINE *e, const char *cmd_name, const char *arg, + int cmd_optional); + +/* + * These functions are useful for manufacturing new ENGINE structures. They + * don't address reference counting at all - one uses them to populate an + * ENGINE structure with personalised implementations of things prior to + * using it directly or adding it to the builtin ENGINE list in OpenSSL. + * These are also here so that the ENGINE structure doesn't have to be + * exposed and break binary compatibility! + */ +ENGINE *ENGINE_new(void); +int ENGINE_free(ENGINE *e); +int ENGINE_up_ref(ENGINE *e); +int ENGINE_set_id(ENGINE *e, const char *id); +int ENGINE_set_name(ENGINE *e, const char *name); +int ENGINE_set_RSA(ENGINE *e, const RSA_METHOD *rsa_meth); +int ENGINE_set_DSA(ENGINE *e, const DSA_METHOD *dsa_meth); +int ENGINE_set_EC(ENGINE *e, const EC_KEY_METHOD *ecdsa_meth); +int ENGINE_set_DH(ENGINE *e, const DH_METHOD *dh_meth); +int ENGINE_set_RAND(ENGINE *e, const RAND_METHOD *rand_meth); +int ENGINE_set_destroy_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR destroy_f); +int ENGINE_set_init_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR init_f); +int ENGINE_set_finish_function(ENGINE *e, ENGINE_GEN_INT_FUNC_PTR finish_f); +int ENGINE_set_ctrl_function(ENGINE *e, ENGINE_CTRL_FUNC_PTR ctrl_f); +int ENGINE_set_load_privkey_function(ENGINE *e, + ENGINE_LOAD_KEY_PTR loadpriv_f); +int ENGINE_set_load_pubkey_function(ENGINE *e, ENGINE_LOAD_KEY_PTR loadpub_f); +int ENGINE_set_load_ssl_client_cert_function(ENGINE *e, + ENGINE_SSL_CLIENT_CERT_PTR + loadssl_f); +int ENGINE_set_ciphers(ENGINE *e, ENGINE_CIPHERS_PTR f); +int ENGINE_set_digests(ENGINE *e, ENGINE_DIGESTS_PTR f); +int ENGINE_set_pkey_meths(ENGINE *e, ENGINE_PKEY_METHS_PTR f); +int ENGINE_set_pkey_asn1_meths(ENGINE *e, ENGINE_PKEY_ASN1_METHS_PTR f); +int ENGINE_set_flags(ENGINE *e, int flags); +int ENGINE_set_cmd_defns(ENGINE *e, const ENGINE_CMD_DEFN *defns); +/* These functions allow control over any per-structure ENGINE data. */ +#define ENGINE_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_ENGINE, l, p, newf, dupf, freef) +int ENGINE_set_ex_data(ENGINE *e, int idx, void *arg); +void *ENGINE_get_ex_data(const ENGINE *e, int idx); + +#if OPENSSL_API_COMPAT < 0x10100000L +/* + * This function previously cleaned up anything that needs it. Auto-deinit will + * now take care of it so it is no longer required to call this function. + */ +# define ENGINE_cleanup() while(0) continue +#endif + +/* + * These return values from within the ENGINE structure. These can be useful + * with functional references as well as structural references - it depends + * which you obtained. Using the result for functional purposes if you only + * obtained a structural reference may be problematic! + */ +const char *ENGINE_get_id(const ENGINE *e); +const char *ENGINE_get_name(const ENGINE *e); +const RSA_METHOD *ENGINE_get_RSA(const ENGINE *e); +const DSA_METHOD *ENGINE_get_DSA(const ENGINE *e); +const EC_KEY_METHOD *ENGINE_get_EC(const ENGINE *e); +const DH_METHOD *ENGINE_get_DH(const ENGINE *e); +const RAND_METHOD *ENGINE_get_RAND(const ENGINE *e); +ENGINE_GEN_INT_FUNC_PTR ENGINE_get_destroy_function(const ENGINE *e); +ENGINE_GEN_INT_FUNC_PTR ENGINE_get_init_function(const ENGINE *e); +ENGINE_GEN_INT_FUNC_PTR ENGINE_get_finish_function(const ENGINE *e); +ENGINE_CTRL_FUNC_PTR ENGINE_get_ctrl_function(const ENGINE *e); +ENGINE_LOAD_KEY_PTR ENGINE_get_load_privkey_function(const ENGINE *e); +ENGINE_LOAD_KEY_PTR ENGINE_get_load_pubkey_function(const ENGINE *e); +ENGINE_SSL_CLIENT_CERT_PTR ENGINE_get_ssl_client_cert_function(const ENGINE + *e); +ENGINE_CIPHERS_PTR ENGINE_get_ciphers(const ENGINE *e); +ENGINE_DIGESTS_PTR ENGINE_get_digests(const ENGINE *e); +ENGINE_PKEY_METHS_PTR ENGINE_get_pkey_meths(const ENGINE *e); +ENGINE_PKEY_ASN1_METHS_PTR ENGINE_get_pkey_asn1_meths(const ENGINE *e); +const EVP_CIPHER *ENGINE_get_cipher(ENGINE *e, int nid); +const EVP_MD *ENGINE_get_digest(ENGINE *e, int nid); +const EVP_PKEY_METHOD *ENGINE_get_pkey_meth(ENGINE *e, int nid); +const EVP_PKEY_ASN1_METHOD *ENGINE_get_pkey_asn1_meth(ENGINE *e, int nid); +const EVP_PKEY_ASN1_METHOD *ENGINE_get_pkey_asn1_meth_str(ENGINE *e, + const char *str, + int len); +const EVP_PKEY_ASN1_METHOD *ENGINE_pkey_asn1_find_str(ENGINE **pe, + const char *str, + int len); +const ENGINE_CMD_DEFN *ENGINE_get_cmd_defns(const ENGINE *e); +int ENGINE_get_flags(const ENGINE *e); + +/* + * FUNCTIONAL functions. These functions deal with ENGINE structures that + * have (or will) be initialised for use. Broadly speaking, the structural + * functions are useful for iterating the list of available engine types, + * creating new engine types, and other "list" operations. These functions + * actually deal with ENGINEs that are to be used. As such these functions + * can fail (if applicable) when particular engines are unavailable - eg. if + * a hardware accelerator is not attached or not functioning correctly. Each + * ENGINE has 2 reference counts; structural and functional. Every time a + * functional reference is obtained or released, a corresponding structural + * reference is automatically obtained or released too. + */ + +/* + * Initialise a engine type for use (or up its reference count if it's + * already in use). This will fail if the engine is not currently operational + * and cannot initialise. + */ +int ENGINE_init(ENGINE *e); +/* + * Free a functional reference to a engine type. This does not require a + * corresponding call to ENGINE_free as it also releases a structural + * reference. + */ +int ENGINE_finish(ENGINE *e); + +/* + * The following functions handle keys that are stored in some secondary + * location, handled by the engine. The storage may be on a card or + * whatever. + */ +EVP_PKEY *ENGINE_load_private_key(ENGINE *e, const char *key_id, + UI_METHOD *ui_method, void *callback_data); +EVP_PKEY *ENGINE_load_public_key(ENGINE *e, const char *key_id, + UI_METHOD *ui_method, void *callback_data); +int ENGINE_load_ssl_client_cert(ENGINE *e, SSL *s, + STACK_OF(X509_NAME) *ca_dn, X509 **pcert, + EVP_PKEY **ppkey, STACK_OF(X509) **pother, + UI_METHOD *ui_method, void *callback_data); + +/* + * This returns a pointer for the current ENGINE structure that is (by + * default) performing any RSA operations. The value returned is an + * incremented reference, so it should be free'd (ENGINE_finish) before it is + * discarded. + */ +ENGINE *ENGINE_get_default_RSA(void); +/* Same for the other "methods" */ +ENGINE *ENGINE_get_default_DSA(void); +ENGINE *ENGINE_get_default_EC(void); +ENGINE *ENGINE_get_default_DH(void); +ENGINE *ENGINE_get_default_RAND(void); +/* + * These functions can be used to get a functional reference to perform + * ciphering or digesting corresponding to "nid". + */ +ENGINE *ENGINE_get_cipher_engine(int nid); +ENGINE *ENGINE_get_digest_engine(int nid); +ENGINE *ENGINE_get_pkey_meth_engine(int nid); +ENGINE *ENGINE_get_pkey_asn1_meth_engine(int nid); + +/* + * This sets a new default ENGINE structure for performing RSA operations. If + * the result is non-zero (success) then the ENGINE structure will have had + * its reference count up'd so the caller should still free their own + * reference 'e'. + */ +int ENGINE_set_default_RSA(ENGINE *e); +int ENGINE_set_default_string(ENGINE *e, const char *def_list); +/* Same for the other "methods" */ +int ENGINE_set_default_DSA(ENGINE *e); +int ENGINE_set_default_EC(ENGINE *e); +int ENGINE_set_default_DH(ENGINE *e); +int ENGINE_set_default_RAND(ENGINE *e); +int ENGINE_set_default_ciphers(ENGINE *e); +int ENGINE_set_default_digests(ENGINE *e); +int ENGINE_set_default_pkey_meths(ENGINE *e); +int ENGINE_set_default_pkey_asn1_meths(ENGINE *e); + +/* + * The combination "set" - the flags are bitwise "OR"d from the + * ENGINE_METHOD_*** defines above. As with the "ENGINE_register_complete()" + * function, this function can result in unnecessary static linkage. If your + * application requires only specific functionality, consider using more + * selective functions. + */ +int ENGINE_set_default(ENGINE *e, unsigned int flags); + +void ENGINE_add_conf_module(void); + +/* Deprecated functions ... */ +/* int ENGINE_clear_defaults(void); */ + +/**************************/ +/* DYNAMIC ENGINE SUPPORT */ +/**************************/ + +/* Binary/behaviour compatibility levels */ +# define OSSL_DYNAMIC_VERSION (unsigned long)0x00030000 +/* + * Binary versions older than this are too old for us (whether we're a loader + * or a loadee) + */ +# define OSSL_DYNAMIC_OLDEST (unsigned long)0x00030000 + +/* + * When compiling an ENGINE entirely as an external shared library, loadable + * by the "dynamic" ENGINE, these types are needed. The 'dynamic_fns' + * structure type provides the calling application's (or library's) error + * functionality and memory management function pointers to the loaded + * library. These should be used/set in the loaded library code so that the + * loading application's 'state' will be used/changed in all operations. The + * 'static_state' pointer allows the loaded library to know if it shares the + * same static data as the calling application (or library), and thus whether + * these callbacks need to be set or not. + */ +typedef void *(*dyn_MEM_malloc_fn) (size_t, const char *, int); +typedef void *(*dyn_MEM_realloc_fn) (void *, size_t, const char *, int); +typedef void (*dyn_MEM_free_fn) (void *, const char *, int); +typedef struct st_dynamic_MEM_fns { + dyn_MEM_malloc_fn malloc_fn; + dyn_MEM_realloc_fn realloc_fn; + dyn_MEM_free_fn free_fn; +} dynamic_MEM_fns; +/* + * FIXME: Perhaps the memory and locking code (crypto.h) should declare and + * use these types so we (and any other dependent code) can simplify a bit?? + */ +/* The top-level structure */ +typedef struct st_dynamic_fns { + void *static_state; + dynamic_MEM_fns mem_fns; +} dynamic_fns; + +/* + * The version checking function should be of this prototype. NB: The + * ossl_version value passed in is the OSSL_DYNAMIC_VERSION of the loading + * code. If this function returns zero, it indicates a (potential) version + * incompatibility and the loaded library doesn't believe it can proceed. + * Otherwise, the returned value is the (latest) version supported by the + * loading library. The loader may still decide that the loaded code's + * version is unsatisfactory and could veto the load. The function is + * expected to be implemented with the symbol name "v_check", and a default + * implementation can be fully instantiated with + * IMPLEMENT_DYNAMIC_CHECK_FN(). + */ +typedef unsigned long (*dynamic_v_check_fn) (unsigned long ossl_version); +# define IMPLEMENT_DYNAMIC_CHECK_FN() \ + OPENSSL_EXPORT unsigned long v_check(unsigned long v); \ + OPENSSL_EXPORT unsigned long v_check(unsigned long v) { \ + if (v >= OSSL_DYNAMIC_OLDEST) return OSSL_DYNAMIC_VERSION; \ + return 0; } + +/* + * This function is passed the ENGINE structure to initialise with its own + * function and command settings. It should not adjust the structural or + * functional reference counts. If this function returns zero, (a) the load + * will be aborted, (b) the previous ENGINE state will be memcpy'd back onto + * the structure, and (c) the shared library will be unloaded. So + * implementations should do their own internal cleanup in failure + * circumstances otherwise they could leak. The 'id' parameter, if non-NULL, + * represents the ENGINE id that the loader is looking for. If this is NULL, + * the shared library can choose to return failure or to initialise a + * 'default' ENGINE. If non-NULL, the shared library must initialise only an + * ENGINE matching the passed 'id'. The function is expected to be + * implemented with the symbol name "bind_engine". A standard implementation + * can be instantiated with IMPLEMENT_DYNAMIC_BIND_FN(fn) where the parameter + * 'fn' is a callback function that populates the ENGINE structure and + * returns an int value (zero for failure). 'fn' should have prototype; + * [static] int fn(ENGINE *e, const char *id); + */ +typedef int (*dynamic_bind_engine) (ENGINE *e, const char *id, + const dynamic_fns *fns); +# define IMPLEMENT_DYNAMIC_BIND_FN(fn) \ + OPENSSL_EXPORT \ + int bind_engine(ENGINE *e, const char *id, const dynamic_fns *fns); \ + OPENSSL_EXPORT \ + int bind_engine(ENGINE *e, const char *id, const dynamic_fns *fns) { \ + if (ENGINE_get_static_state() == fns->static_state) goto skip_cbs; \ + CRYPTO_set_mem_functions(fns->mem_fns.malloc_fn, \ + fns->mem_fns.realloc_fn, \ + fns->mem_fns.free_fn); \ + skip_cbs: \ + if (!fn(e, id)) return 0; \ + return 1; } + +/* + * If the loading application (or library) and the loaded ENGINE library + * share the same static data (eg. they're both dynamically linked to the + * same libcrypto.so) we need a way to avoid trying to set system callbacks - + * this would fail, and for the same reason that it's unnecessary to try. If + * the loaded ENGINE has (or gets from through the loader) its own copy of + * the libcrypto static data, we will need to set the callbacks. The easiest + * way to detect this is to have a function that returns a pointer to some + * static data and let the loading application and loaded ENGINE compare + * their respective values. + */ +void *ENGINE_get_static_state(void); + +# if defined(__OpenBSD__) || defined(__FreeBSD__) || defined(__DragonFly__) +DEPRECATEDIN_1_1_0(void ENGINE_setup_bsd_cryptodev(void)) +# endif + + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/engineerr.h b/include/openssl/engineerr.h new file mode 100644 index 0000000..f14ed9d --- /dev/null +++ b/include/openssl/engineerr.h @@ -0,0 +1,107 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ENGINEERR_H +# define HEADER_ENGINEERR_H + +# include + +# ifndef OPENSSL_NO_ENGINE + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_ENGINE_strings(void); + +/* + * ENGINE function codes. + */ +# define ENGINE_F_DIGEST_UPDATE 198 +# define ENGINE_F_DYNAMIC_CTRL 180 +# define ENGINE_F_DYNAMIC_GET_DATA_CTX 181 +# define ENGINE_F_DYNAMIC_LOAD 182 +# define ENGINE_F_DYNAMIC_SET_DATA_CTX 183 +# define ENGINE_F_ENGINE_ADD 105 +# define ENGINE_F_ENGINE_BY_ID 106 +# define ENGINE_F_ENGINE_CMD_IS_EXECUTABLE 170 +# define ENGINE_F_ENGINE_CTRL 142 +# define ENGINE_F_ENGINE_CTRL_CMD 178 +# define ENGINE_F_ENGINE_CTRL_CMD_STRING 171 +# define ENGINE_F_ENGINE_FINISH 107 +# define ENGINE_F_ENGINE_GET_CIPHER 185 +# define ENGINE_F_ENGINE_GET_DIGEST 186 +# define ENGINE_F_ENGINE_GET_FIRST 195 +# define ENGINE_F_ENGINE_GET_LAST 196 +# define ENGINE_F_ENGINE_GET_NEXT 115 +# define ENGINE_F_ENGINE_GET_PKEY_ASN1_METH 193 +# define ENGINE_F_ENGINE_GET_PKEY_METH 192 +# define ENGINE_F_ENGINE_GET_PREV 116 +# define ENGINE_F_ENGINE_INIT 119 +# define ENGINE_F_ENGINE_LIST_ADD 120 +# define ENGINE_F_ENGINE_LIST_REMOVE 121 +# define ENGINE_F_ENGINE_LOAD_PRIVATE_KEY 150 +# define ENGINE_F_ENGINE_LOAD_PUBLIC_KEY 151 +# define ENGINE_F_ENGINE_LOAD_SSL_CLIENT_CERT 194 +# define ENGINE_F_ENGINE_NEW 122 +# define ENGINE_F_ENGINE_PKEY_ASN1_FIND_STR 197 +# define ENGINE_F_ENGINE_REMOVE 123 +# define ENGINE_F_ENGINE_SET_DEFAULT_STRING 189 +# define ENGINE_F_ENGINE_SET_ID 129 +# define ENGINE_F_ENGINE_SET_NAME 130 +# define ENGINE_F_ENGINE_TABLE_REGISTER 184 +# define ENGINE_F_ENGINE_UNLOCKED_FINISH 191 +# define ENGINE_F_ENGINE_UP_REF 190 +# define ENGINE_F_INT_CLEANUP_ITEM 199 +# define ENGINE_F_INT_CTRL_HELPER 172 +# define ENGINE_F_INT_ENGINE_CONFIGURE 188 +# define ENGINE_F_INT_ENGINE_MODULE_INIT 187 +# define ENGINE_F_OSSL_HMAC_INIT 200 + +/* + * ENGINE reason codes. + */ +# define ENGINE_R_ALREADY_LOADED 100 +# define ENGINE_R_ARGUMENT_IS_NOT_A_NUMBER 133 +# define ENGINE_R_CMD_NOT_EXECUTABLE 134 +# define ENGINE_R_COMMAND_TAKES_INPUT 135 +# define ENGINE_R_COMMAND_TAKES_NO_INPUT 136 +# define ENGINE_R_CONFLICTING_ENGINE_ID 103 +# define ENGINE_R_CTRL_COMMAND_NOT_IMPLEMENTED 119 +# define ENGINE_R_DSO_FAILURE 104 +# define ENGINE_R_DSO_NOT_FOUND 132 +# define ENGINE_R_ENGINES_SECTION_ERROR 148 +# define ENGINE_R_ENGINE_CONFIGURATION_ERROR 102 +# define ENGINE_R_ENGINE_IS_NOT_IN_LIST 105 +# define ENGINE_R_ENGINE_SECTION_ERROR 149 +# define ENGINE_R_FAILED_LOADING_PRIVATE_KEY 128 +# define ENGINE_R_FAILED_LOADING_PUBLIC_KEY 129 +# define ENGINE_R_FINISH_FAILED 106 +# define ENGINE_R_ID_OR_NAME_MISSING 108 +# define ENGINE_R_INIT_FAILED 109 +# define ENGINE_R_INTERNAL_LIST_ERROR 110 +# define ENGINE_R_INVALID_ARGUMENT 143 +# define ENGINE_R_INVALID_CMD_NAME 137 +# define ENGINE_R_INVALID_CMD_NUMBER 138 +# define ENGINE_R_INVALID_INIT_VALUE 151 +# define ENGINE_R_INVALID_STRING 150 +# define ENGINE_R_NOT_INITIALISED 117 +# define ENGINE_R_NOT_LOADED 112 +# define ENGINE_R_NO_CONTROL_FUNCTION 120 +# define ENGINE_R_NO_INDEX 144 +# define ENGINE_R_NO_LOAD_FUNCTION 125 +# define ENGINE_R_NO_REFERENCE 130 +# define ENGINE_R_NO_SUCH_ENGINE 116 +# define ENGINE_R_UNIMPLEMENTED_CIPHER 146 +# define ENGINE_R_UNIMPLEMENTED_DIGEST 147 +# define ENGINE_R_UNIMPLEMENTED_PUBLIC_KEY_METHOD 101 +# define ENGINE_R_VERSION_INCOMPATIBILITY 145 + +# endif +#endif diff --git a/include/openssl/err.h b/include/openssl/err.h new file mode 100644 index 0000000..63bf72b --- /dev/null +++ b/include/openssl/err.h @@ -0,0 +1,273 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ERR_H +# define HEADER_ERR_H + +# include + +# ifndef OPENSSL_NO_STDIO +# include +# include +# endif + +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +# ifndef OPENSSL_NO_ERR +# define ERR_PUT_error(a,b,c,d,e) ERR_put_error(a,b,c,d,e) +# else +# define ERR_PUT_error(a,b,c,d,e) ERR_put_error(a,b,c,NULL,0) +# endif + +# include + +# define ERR_TXT_MALLOCED 0x01 +# define ERR_TXT_STRING 0x02 + +# define ERR_FLAG_MARK 0x01 + +# define ERR_NUM_ERRORS 16 +typedef struct err_state_st { + int err_flags[ERR_NUM_ERRORS]; + unsigned long err_buffer[ERR_NUM_ERRORS]; + char *err_data[ERR_NUM_ERRORS]; + int err_data_flags[ERR_NUM_ERRORS]; + const char *err_file[ERR_NUM_ERRORS]; + int err_line[ERR_NUM_ERRORS]; + int top, bottom; +} ERR_STATE; + +/* library */ +# define ERR_LIB_NONE 1 +# define ERR_LIB_SYS 2 +# define ERR_LIB_BN 3 +# define ERR_LIB_RSA 4 +# define ERR_LIB_DH 5 +# define ERR_LIB_EVP 6 +# define ERR_LIB_BUF 7 +# define ERR_LIB_OBJ 8 +# define ERR_LIB_PEM 9 +# define ERR_LIB_DSA 10 +# define ERR_LIB_X509 11 +/* #define ERR_LIB_METH 12 */ +# define ERR_LIB_ASN1 13 +# define ERR_LIB_CONF 14 +# define ERR_LIB_CRYPTO 15 +# define ERR_LIB_EC 16 +# define ERR_LIB_SSL 20 +/* #define ERR_LIB_SSL23 21 */ +/* #define ERR_LIB_SSL2 22 */ +/* #define ERR_LIB_SSL3 23 */ +/* #define ERR_LIB_RSAREF 30 */ +/* #define ERR_LIB_PROXY 31 */ +# define ERR_LIB_BIO 32 +# define ERR_LIB_PKCS7 33 +# define ERR_LIB_X509V3 34 +# define ERR_LIB_PKCS12 35 +# define ERR_LIB_RAND 36 +# define ERR_LIB_DSO 37 +# define ERR_LIB_ENGINE 38 +# define ERR_LIB_OCSP 39 +# define ERR_LIB_UI 40 +# define ERR_LIB_COMP 41 +# define ERR_LIB_ECDSA 42 +# define ERR_LIB_ECDH 43 +# define ERR_LIB_OSSL_STORE 44 +# define ERR_LIB_FIPS 45 +# define ERR_LIB_CMS 46 +# define ERR_LIB_TS 47 +# define ERR_LIB_HMAC 48 +/* # define ERR_LIB_JPAKE 49 */ +# define ERR_LIB_CT 50 +# define ERR_LIB_ASYNC 51 +# define ERR_LIB_KDF 52 +# define ERR_LIB_SM2 53 + +# define ERR_LIB_USER 128 + +# define SYSerr(f,r) ERR_PUT_error(ERR_LIB_SYS,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define BNerr(f,r) ERR_PUT_error(ERR_LIB_BN,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define RSAerr(f,r) ERR_PUT_error(ERR_LIB_RSA,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define DHerr(f,r) ERR_PUT_error(ERR_LIB_DH,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define EVPerr(f,r) ERR_PUT_error(ERR_LIB_EVP,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define BUFerr(f,r) ERR_PUT_error(ERR_LIB_BUF,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define OBJerr(f,r) ERR_PUT_error(ERR_LIB_OBJ,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define PEMerr(f,r) ERR_PUT_error(ERR_LIB_PEM,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define DSAerr(f,r) ERR_PUT_error(ERR_LIB_DSA,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define X509err(f,r) ERR_PUT_error(ERR_LIB_X509,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define ASN1err(f,r) ERR_PUT_error(ERR_LIB_ASN1,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define CONFerr(f,r) ERR_PUT_error(ERR_LIB_CONF,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define CRYPTOerr(f,r) ERR_PUT_error(ERR_LIB_CRYPTO,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define ECerr(f,r) ERR_PUT_error(ERR_LIB_EC,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define SSLerr(f,r) ERR_PUT_error(ERR_LIB_SSL,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define BIOerr(f,r) ERR_PUT_error(ERR_LIB_BIO,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define PKCS7err(f,r) ERR_PUT_error(ERR_LIB_PKCS7,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define X509V3err(f,r) ERR_PUT_error(ERR_LIB_X509V3,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define PKCS12err(f,r) ERR_PUT_error(ERR_LIB_PKCS12,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define RANDerr(f,r) ERR_PUT_error(ERR_LIB_RAND,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define DSOerr(f,r) ERR_PUT_error(ERR_LIB_DSO,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define ENGINEerr(f,r) ERR_PUT_error(ERR_LIB_ENGINE,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define OCSPerr(f,r) ERR_PUT_error(ERR_LIB_OCSP,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define UIerr(f,r) ERR_PUT_error(ERR_LIB_UI,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define COMPerr(f,r) ERR_PUT_error(ERR_LIB_COMP,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define ECDSAerr(f,r) ERR_PUT_error(ERR_LIB_ECDSA,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define ECDHerr(f,r) ERR_PUT_error(ERR_LIB_ECDH,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define OSSL_STOREerr(f,r) ERR_PUT_error(ERR_LIB_OSSL_STORE,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define FIPSerr(f,r) ERR_PUT_error(ERR_LIB_FIPS,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define CMSerr(f,r) ERR_PUT_error(ERR_LIB_CMS,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define TSerr(f,r) ERR_PUT_error(ERR_LIB_TS,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define HMACerr(f,r) ERR_PUT_error(ERR_LIB_HMAC,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define CTerr(f,r) ERR_PUT_error(ERR_LIB_CT,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define ASYNCerr(f,r) ERR_PUT_error(ERR_LIB_ASYNC,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define KDFerr(f,r) ERR_PUT_error(ERR_LIB_KDF,(f),(r),OPENSSL_FILE,OPENSSL_LINE) +# define SM2err(f,r) ERR_PUT_error(ERR_LIB_SM2,(f),(r),OPENSSL_FILE,OPENSSL_LINE) + +# define ERR_PACK(l,f,r) ( \ + (((unsigned int)(l) & 0x0FF) << 24L) | \ + (((unsigned int)(f) & 0xFFF) << 12L) | \ + (((unsigned int)(r) & 0xFFF) ) ) +# define ERR_GET_LIB(l) (int)(((l) >> 24L) & 0x0FFL) +# define ERR_GET_FUNC(l) (int)(((l) >> 12L) & 0xFFFL) +# define ERR_GET_REASON(l) (int)( (l) & 0xFFFL) +# define ERR_FATAL_ERROR(l) (int)( (l) & ERR_R_FATAL) + +/* OS functions */ +# define SYS_F_FOPEN 1 +# define SYS_F_CONNECT 2 +# define SYS_F_GETSERVBYNAME 3 +# define SYS_F_SOCKET 4 +# define SYS_F_IOCTLSOCKET 5 +# define SYS_F_BIND 6 +# define SYS_F_LISTEN 7 +# define SYS_F_ACCEPT 8 +# define SYS_F_WSASTARTUP 9/* Winsock stuff */ +# define SYS_F_OPENDIR 10 +# define SYS_F_FREAD 11 +# define SYS_F_GETADDRINFO 12 +# define SYS_F_GETNAMEINFO 13 +# define SYS_F_SETSOCKOPT 14 +# define SYS_F_GETSOCKOPT 15 +# define SYS_F_GETSOCKNAME 16 +# define SYS_F_GETHOSTBYNAME 17 +# define SYS_F_FFLUSH 18 +# define SYS_F_OPEN 19 +# define SYS_F_CLOSE 20 +# define SYS_F_IOCTL 21 +# define SYS_F_STAT 22 +# define SYS_F_FCNTL 23 +# define SYS_F_FSTAT 24 + +/* reasons */ +# define ERR_R_SYS_LIB ERR_LIB_SYS/* 2 */ +# define ERR_R_BN_LIB ERR_LIB_BN/* 3 */ +# define ERR_R_RSA_LIB ERR_LIB_RSA/* 4 */ +# define ERR_R_DH_LIB ERR_LIB_DH/* 5 */ +# define ERR_R_EVP_LIB ERR_LIB_EVP/* 6 */ +# define ERR_R_BUF_LIB ERR_LIB_BUF/* 7 */ +# define ERR_R_OBJ_LIB ERR_LIB_OBJ/* 8 */ +# define ERR_R_PEM_LIB ERR_LIB_PEM/* 9 */ +# define ERR_R_DSA_LIB ERR_LIB_DSA/* 10 */ +# define ERR_R_X509_LIB ERR_LIB_X509/* 11 */ +# define ERR_R_ASN1_LIB ERR_LIB_ASN1/* 13 */ +# define ERR_R_EC_LIB ERR_LIB_EC/* 16 */ +# define ERR_R_BIO_LIB ERR_LIB_BIO/* 32 */ +# define ERR_R_PKCS7_LIB ERR_LIB_PKCS7/* 33 */ +# define ERR_R_X509V3_LIB ERR_LIB_X509V3/* 34 */ +# define ERR_R_ENGINE_LIB ERR_LIB_ENGINE/* 38 */ +# define ERR_R_UI_LIB ERR_LIB_UI/* 40 */ +# define ERR_R_ECDSA_LIB ERR_LIB_ECDSA/* 42 */ +# define ERR_R_OSSL_STORE_LIB ERR_LIB_OSSL_STORE/* 44 */ + +# define ERR_R_NESTED_ASN1_ERROR 58 +# define ERR_R_MISSING_ASN1_EOS 63 + +/* fatal error */ +# define ERR_R_FATAL 64 +# define ERR_R_MALLOC_FAILURE (1|ERR_R_FATAL) +# define ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED (2|ERR_R_FATAL) +# define ERR_R_PASSED_NULL_PARAMETER (3|ERR_R_FATAL) +# define ERR_R_INTERNAL_ERROR (4|ERR_R_FATAL) +# define ERR_R_DISABLED (5|ERR_R_FATAL) +# define ERR_R_INIT_FAIL (6|ERR_R_FATAL) +# define ERR_R_PASSED_INVALID_ARGUMENT (7) +# define ERR_R_OPERATION_FAIL (8|ERR_R_FATAL) + +/* + * 99 is the maximum possible ERR_R_... code, higher values are reserved for + * the individual libraries + */ + +typedef struct ERR_string_data_st { + unsigned long error; + const char *string; +} ERR_STRING_DATA; + +DEFINE_LHASH_OF(ERR_STRING_DATA); + +void ERR_put_error(int lib, int func, int reason, const char *file, int line); +void ERR_set_error_data(char *data, int flags); + +unsigned long ERR_get_error(void); +unsigned long ERR_get_error_line(const char **file, int *line); +unsigned long ERR_get_error_line_data(const char **file, int *line, + const char **data, int *flags); +unsigned long ERR_peek_error(void); +unsigned long ERR_peek_error_line(const char **file, int *line); +unsigned long ERR_peek_error_line_data(const char **file, int *line, + const char **data, int *flags); +unsigned long ERR_peek_last_error(void); +unsigned long ERR_peek_last_error_line(const char **file, int *line); +unsigned long ERR_peek_last_error_line_data(const char **file, int *line, + const char **data, int *flags); +void ERR_clear_error(void); +char *ERR_error_string(unsigned long e, char *buf); +void ERR_error_string_n(unsigned long e, char *buf, size_t len); +const char *ERR_lib_error_string(unsigned long e); +const char *ERR_func_error_string(unsigned long e); +const char *ERR_reason_error_string(unsigned long e); +void ERR_print_errors_cb(int (*cb) (const char *str, size_t len, void *u), + void *u); +# ifndef OPENSSL_NO_STDIO +void ERR_print_errors_fp(FILE *fp); +# endif +void ERR_print_errors(BIO *bp); +void ERR_add_error_data(int num, ...); +void ERR_add_error_vdata(int num, va_list args); +int ERR_load_strings(int lib, ERR_STRING_DATA *str); +int ERR_load_strings_const(const ERR_STRING_DATA *str); +int ERR_unload_strings(int lib, ERR_STRING_DATA *str); +int ERR_load_ERR_strings(void); + +#if OPENSSL_API_COMPAT < 0x10100000L +# define ERR_load_crypto_strings() \ + OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CRYPTO_STRINGS, NULL) +# define ERR_free_strings() while(0) continue +#endif + +DEPRECATEDIN_1_1_0(void ERR_remove_thread_state(void *)) +DEPRECATEDIN_1_0_0(void ERR_remove_state(unsigned long pid)) +ERR_STATE *ERR_get_state(void); + +int ERR_get_next_error_library(void); + +int ERR_set_mark(void); +int ERR_pop_to_mark(void); +int ERR_clear_last_mark(void); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/evp.h b/include/openssl/evp.h new file mode 100644 index 0000000..0d7a0ec --- /dev/null +++ b/include/openssl/evp.h @@ -0,0 +1,1638 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_ENVELOPE_H +# define HEADER_ENVELOPE_H + +# include +# include +# include +# include +# include + +# define EVP_MAX_MD_SIZE 64/* longest known is SHA512 */ +# define EVP_MAX_KEY_LENGTH 64 +# define EVP_MAX_IV_LENGTH 16 +# define EVP_MAX_BLOCK_LENGTH 32 + +# define PKCS5_SALT_LEN 8 +/* Default PKCS#5 iteration count */ +# define PKCS5_DEFAULT_ITER 2048 + +# include + +# define EVP_PK_RSA 0x0001 +# define EVP_PK_DSA 0x0002 +# define EVP_PK_DH 0x0004 +# define EVP_PK_EC 0x0008 +# define EVP_PKT_SIGN 0x0010 +# define EVP_PKT_ENC 0x0020 +# define EVP_PKT_EXCH 0x0040 +# define EVP_PKS_RSA 0x0100 +# define EVP_PKS_DSA 0x0200 +# define EVP_PKS_EC 0x0400 + +# define EVP_PKEY_NONE NID_undef +# define EVP_PKEY_RSA NID_rsaEncryption +# define EVP_PKEY_RSA2 NID_rsa +# define EVP_PKEY_RSA_PSS NID_rsassaPss +# define EVP_PKEY_DSA NID_dsa +# define EVP_PKEY_DSA1 NID_dsa_2 +# define EVP_PKEY_DSA2 NID_dsaWithSHA +# define EVP_PKEY_DSA3 NID_dsaWithSHA1 +# define EVP_PKEY_DSA4 NID_dsaWithSHA1_2 +# define EVP_PKEY_DH NID_dhKeyAgreement +# define EVP_PKEY_DHX NID_dhpublicnumber +# define EVP_PKEY_EC NID_X9_62_id_ecPublicKey +# define EVP_PKEY_SM2 NID_sm2 +# define EVP_PKEY_HMAC NID_hmac +# define EVP_PKEY_CMAC NID_cmac +# define EVP_PKEY_SCRYPT NID_id_scrypt +# define EVP_PKEY_TLS1_PRF NID_tls1_prf +# define EVP_PKEY_HKDF NID_hkdf +# define EVP_PKEY_POLY1305 NID_poly1305 +# define EVP_PKEY_SIPHASH NID_siphash +# define EVP_PKEY_X25519 NID_X25519 +# define EVP_PKEY_ED25519 NID_ED25519 +# define EVP_PKEY_X448 NID_X448 +# define EVP_PKEY_ED448 NID_ED448 + +#ifdef __cplusplus +extern "C" { +#endif + +# define EVP_PKEY_MO_SIGN 0x0001 +# define EVP_PKEY_MO_VERIFY 0x0002 +# define EVP_PKEY_MO_ENCRYPT 0x0004 +# define EVP_PKEY_MO_DECRYPT 0x0008 + +# ifndef EVP_MD +EVP_MD *EVP_MD_meth_new(int md_type, int pkey_type); +EVP_MD *EVP_MD_meth_dup(const EVP_MD *md); +void EVP_MD_meth_free(EVP_MD *md); + +int EVP_MD_meth_set_input_blocksize(EVP_MD *md, int blocksize); +int EVP_MD_meth_set_result_size(EVP_MD *md, int resultsize); +int EVP_MD_meth_set_app_datasize(EVP_MD *md, int datasize); +int EVP_MD_meth_set_flags(EVP_MD *md, unsigned long flags); +int EVP_MD_meth_set_init(EVP_MD *md, int (*init)(EVP_MD_CTX *ctx)); +int EVP_MD_meth_set_update(EVP_MD *md, int (*update)(EVP_MD_CTX *ctx, + const void *data, + size_t count)); +int EVP_MD_meth_set_final(EVP_MD *md, int (*final)(EVP_MD_CTX *ctx, + unsigned char *md)); +int EVP_MD_meth_set_copy(EVP_MD *md, int (*copy)(EVP_MD_CTX *to, + const EVP_MD_CTX *from)); +int EVP_MD_meth_set_cleanup(EVP_MD *md, int (*cleanup)(EVP_MD_CTX *ctx)); +int EVP_MD_meth_set_ctrl(EVP_MD *md, int (*ctrl)(EVP_MD_CTX *ctx, int cmd, + int p1, void *p2)); + +int EVP_MD_meth_get_input_blocksize(const EVP_MD *md); +int EVP_MD_meth_get_result_size(const EVP_MD *md); +int EVP_MD_meth_get_app_datasize(const EVP_MD *md); +unsigned long EVP_MD_meth_get_flags(const EVP_MD *md); +int (*EVP_MD_meth_get_init(const EVP_MD *md))(EVP_MD_CTX *ctx); +int (*EVP_MD_meth_get_update(const EVP_MD *md))(EVP_MD_CTX *ctx, + const void *data, + size_t count); +int (*EVP_MD_meth_get_final(const EVP_MD *md))(EVP_MD_CTX *ctx, + unsigned char *md); +int (*EVP_MD_meth_get_copy(const EVP_MD *md))(EVP_MD_CTX *to, + const EVP_MD_CTX *from); +int (*EVP_MD_meth_get_cleanup(const EVP_MD *md))(EVP_MD_CTX *ctx); +int (*EVP_MD_meth_get_ctrl(const EVP_MD *md))(EVP_MD_CTX *ctx, int cmd, + int p1, void *p2); + +/* digest can only handle a single block */ +# define EVP_MD_FLAG_ONESHOT 0x0001 + +/* digest is extensible-output function, XOF */ +# define EVP_MD_FLAG_XOF 0x0002 + +/* DigestAlgorithmIdentifier flags... */ + +# define EVP_MD_FLAG_DIGALGID_MASK 0x0018 + +/* NULL or absent parameter accepted. Use NULL */ + +# define EVP_MD_FLAG_DIGALGID_NULL 0x0000 + +/* NULL or absent parameter accepted. Use NULL for PKCS#1 otherwise absent */ + +# define EVP_MD_FLAG_DIGALGID_ABSENT 0x0008 + +/* Custom handling via ctrl */ + +# define EVP_MD_FLAG_DIGALGID_CUSTOM 0x0018 + +/* Note if suitable for use in FIPS mode */ +# define EVP_MD_FLAG_FIPS 0x0400 + +/* Digest ctrls */ + +# define EVP_MD_CTRL_DIGALGID 0x1 +# define EVP_MD_CTRL_MICALG 0x2 +# define EVP_MD_CTRL_XOF_LEN 0x3 + +/* Minimum Algorithm specific ctrl value */ + +# define EVP_MD_CTRL_ALG_CTRL 0x1000 + +# endif /* !EVP_MD */ + +/* values for EVP_MD_CTX flags */ + +# define EVP_MD_CTX_FLAG_ONESHOT 0x0001/* digest update will be + * called once only */ +# define EVP_MD_CTX_FLAG_CLEANED 0x0002/* context has already been + * cleaned */ +# define EVP_MD_CTX_FLAG_REUSE 0x0004/* Don't free up ctx->md_data + * in EVP_MD_CTX_reset */ +/* + * FIPS and pad options are ignored in 1.0.0, definitions are here so we + * don't accidentally reuse the values for other purposes. + */ + +# define EVP_MD_CTX_FLAG_NON_FIPS_ALLOW 0x0008/* Allow use of non FIPS + * digest in FIPS mode */ + +/* + * The following PAD options are also currently ignored in 1.0.0, digest + * parameters are handled through EVP_DigestSign*() and EVP_DigestVerify*() + * instead. + */ +# define EVP_MD_CTX_FLAG_PAD_MASK 0xF0/* RSA mode to use */ +# define EVP_MD_CTX_FLAG_PAD_PKCS1 0x00/* PKCS#1 v1.5 mode */ +# define EVP_MD_CTX_FLAG_PAD_X931 0x10/* X9.31 mode */ +# define EVP_MD_CTX_FLAG_PAD_PSS 0x20/* PSS mode */ + +# define EVP_MD_CTX_FLAG_NO_INIT 0x0100/* Don't initialize md_data */ +/* + * Some functions such as EVP_DigestSign only finalise copies of internal + * contexts so additional data can be included after the finalisation call. + * This is inefficient if this functionality is not required: it is disabled + * if the following flag is set. + */ +# define EVP_MD_CTX_FLAG_FINALISE 0x0200 +/* NOTE: 0x0400 is reserved for internal usage in evp_int.h */ + +EVP_CIPHER *EVP_CIPHER_meth_new(int cipher_type, int block_size, int key_len); +EVP_CIPHER *EVP_CIPHER_meth_dup(const EVP_CIPHER *cipher); +void EVP_CIPHER_meth_free(EVP_CIPHER *cipher); + +int EVP_CIPHER_meth_set_iv_length(EVP_CIPHER *cipher, int iv_len); +int EVP_CIPHER_meth_set_flags(EVP_CIPHER *cipher, unsigned long flags); +int EVP_CIPHER_meth_set_impl_ctx_size(EVP_CIPHER *cipher, int ctx_size); +int EVP_CIPHER_meth_set_init(EVP_CIPHER *cipher, + int (*init) (EVP_CIPHER_CTX *ctx, + const unsigned char *key, + const unsigned char *iv, + int enc)); +int EVP_CIPHER_meth_set_do_cipher(EVP_CIPHER *cipher, + int (*do_cipher) (EVP_CIPHER_CTX *ctx, + unsigned char *out, + const unsigned char *in, + size_t inl)); +int EVP_CIPHER_meth_set_cleanup(EVP_CIPHER *cipher, + int (*cleanup) (EVP_CIPHER_CTX *)); +int EVP_CIPHER_meth_set_set_asn1_params(EVP_CIPHER *cipher, + int (*set_asn1_parameters) (EVP_CIPHER_CTX *, + ASN1_TYPE *)); +int EVP_CIPHER_meth_set_get_asn1_params(EVP_CIPHER *cipher, + int (*get_asn1_parameters) (EVP_CIPHER_CTX *, + ASN1_TYPE *)); +int EVP_CIPHER_meth_set_ctrl(EVP_CIPHER *cipher, + int (*ctrl) (EVP_CIPHER_CTX *, int type, + int arg, void *ptr)); + +int (*EVP_CIPHER_meth_get_init(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *ctx, + const unsigned char *key, + const unsigned char *iv, + int enc); +int (*EVP_CIPHER_meth_get_do_cipher(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *ctx, + unsigned char *out, + const unsigned char *in, + size_t inl); +int (*EVP_CIPHER_meth_get_cleanup(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *); +int (*EVP_CIPHER_meth_get_set_asn1_params(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *, + ASN1_TYPE *); +int (*EVP_CIPHER_meth_get_get_asn1_params(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *, + ASN1_TYPE *); +int (*EVP_CIPHER_meth_get_ctrl(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *, + int type, int arg, + void *ptr); + +/* Values for cipher flags */ + +/* Modes for ciphers */ + +# define EVP_CIPH_STREAM_CIPHER 0x0 +# define EVP_CIPH_ECB_MODE 0x1 +# define EVP_CIPH_CBC_MODE 0x2 +# define EVP_CIPH_CFB_MODE 0x3 +# define EVP_CIPH_OFB_MODE 0x4 +# define EVP_CIPH_CTR_MODE 0x5 +# define EVP_CIPH_GCM_MODE 0x6 +# define EVP_CIPH_CCM_MODE 0x7 +# define EVP_CIPH_XTS_MODE 0x10001 +# define EVP_CIPH_WRAP_MODE 0x10002 +# define EVP_CIPH_OCB_MODE 0x10003 +# define EVP_CIPH_MODE 0xF0007 +/* Set if variable length cipher */ +# define EVP_CIPH_VARIABLE_LENGTH 0x8 +/* Set if the iv handling should be done by the cipher itself */ +# define EVP_CIPH_CUSTOM_IV 0x10 +/* Set if the cipher's init() function should be called if key is NULL */ +# define EVP_CIPH_ALWAYS_CALL_INIT 0x20 +/* Call ctrl() to init cipher parameters */ +# define EVP_CIPH_CTRL_INIT 0x40 +/* Don't use standard key length function */ +# define EVP_CIPH_CUSTOM_KEY_LENGTH 0x80 +/* Don't use standard block padding */ +# define EVP_CIPH_NO_PADDING 0x100 +/* cipher handles random key generation */ +# define EVP_CIPH_RAND_KEY 0x200 +/* cipher has its own additional copying logic */ +# define EVP_CIPH_CUSTOM_COPY 0x400 +/* Allow use default ASN1 get/set iv */ +# define EVP_CIPH_FLAG_DEFAULT_ASN1 0x1000 +/* Buffer length in bits not bytes: CFB1 mode only */ +# define EVP_CIPH_FLAG_LENGTH_BITS 0x2000 +/* Note if suitable for use in FIPS mode */ +# define EVP_CIPH_FLAG_FIPS 0x4000 +/* Allow non FIPS cipher in FIPS mode */ +# define EVP_CIPH_FLAG_NON_FIPS_ALLOW 0x8000 +/* + * Cipher handles any and all padding logic as well as finalisation. + */ +# define EVP_CIPH_FLAG_CUSTOM_CIPHER 0x100000 +# define EVP_CIPH_FLAG_AEAD_CIPHER 0x200000 +# define EVP_CIPH_FLAG_TLS1_1_MULTIBLOCK 0x400000 +/* Cipher can handle pipeline operations */ +# define EVP_CIPH_FLAG_PIPELINE 0X800000 + +/* + * Cipher context flag to indicate we can handle wrap mode: if allowed in + * older applications it could overflow buffers. + */ + +# define EVP_CIPHER_CTX_FLAG_WRAP_ALLOW 0x1 + +/* ctrl() values */ + +# define EVP_CTRL_INIT 0x0 +# define EVP_CTRL_SET_KEY_LENGTH 0x1 +# define EVP_CTRL_GET_RC2_KEY_BITS 0x2 +# define EVP_CTRL_SET_RC2_KEY_BITS 0x3 +# define EVP_CTRL_GET_RC5_ROUNDS 0x4 +# define EVP_CTRL_SET_RC5_ROUNDS 0x5 +# define EVP_CTRL_RAND_KEY 0x6 +# define EVP_CTRL_PBE_PRF_NID 0x7 +# define EVP_CTRL_COPY 0x8 +# define EVP_CTRL_AEAD_SET_IVLEN 0x9 +# define EVP_CTRL_AEAD_GET_TAG 0x10 +# define EVP_CTRL_AEAD_SET_TAG 0x11 +# define EVP_CTRL_AEAD_SET_IV_FIXED 0x12 +# define EVP_CTRL_GCM_SET_IVLEN EVP_CTRL_AEAD_SET_IVLEN +# define EVP_CTRL_GCM_GET_TAG EVP_CTRL_AEAD_GET_TAG +# define EVP_CTRL_GCM_SET_TAG EVP_CTRL_AEAD_SET_TAG +# define EVP_CTRL_GCM_SET_IV_FIXED EVP_CTRL_AEAD_SET_IV_FIXED +# define EVP_CTRL_GCM_IV_GEN 0x13 +# define EVP_CTRL_CCM_SET_IVLEN EVP_CTRL_AEAD_SET_IVLEN +# define EVP_CTRL_CCM_GET_TAG EVP_CTRL_AEAD_GET_TAG +# define EVP_CTRL_CCM_SET_TAG EVP_CTRL_AEAD_SET_TAG +# define EVP_CTRL_CCM_SET_IV_FIXED EVP_CTRL_AEAD_SET_IV_FIXED +# define EVP_CTRL_CCM_SET_L 0x14 +# define EVP_CTRL_CCM_SET_MSGLEN 0x15 +/* + * AEAD cipher deduces payload length and returns number of bytes required to + * store MAC and eventual padding. Subsequent call to EVP_Cipher even + * appends/verifies MAC. + */ +# define EVP_CTRL_AEAD_TLS1_AAD 0x16 +/* Used by composite AEAD ciphers, no-op in GCM, CCM... */ +# define EVP_CTRL_AEAD_SET_MAC_KEY 0x17 +/* Set the GCM invocation field, decrypt only */ +# define EVP_CTRL_GCM_SET_IV_INV 0x18 + +# define EVP_CTRL_TLS1_1_MULTIBLOCK_AAD 0x19 +# define EVP_CTRL_TLS1_1_MULTIBLOCK_ENCRYPT 0x1a +# define EVP_CTRL_TLS1_1_MULTIBLOCK_DECRYPT 0x1b +# define EVP_CTRL_TLS1_1_MULTIBLOCK_MAX_BUFSIZE 0x1c + +# define EVP_CTRL_SSL3_MASTER_SECRET 0x1d + +/* EVP_CTRL_SET_SBOX takes the char * specifying S-boxes */ +# define EVP_CTRL_SET_SBOX 0x1e +/* + * EVP_CTRL_SBOX_USED takes a 'size_t' and 'char *', pointing at a + * pre-allocated buffer with specified size + */ +# define EVP_CTRL_SBOX_USED 0x1f +/* EVP_CTRL_KEY_MESH takes 'size_t' number of bytes to mesh the key after, + * 0 switches meshing off + */ +# define EVP_CTRL_KEY_MESH 0x20 +/* EVP_CTRL_BLOCK_PADDING_MODE takes the padding mode */ +# define EVP_CTRL_BLOCK_PADDING_MODE 0x21 + +/* Set the output buffers to use for a pipelined operation */ +# define EVP_CTRL_SET_PIPELINE_OUTPUT_BUFS 0x22 +/* Set the input buffers to use for a pipelined operation */ +# define EVP_CTRL_SET_PIPELINE_INPUT_BUFS 0x23 +/* Set the input buffer lengths to use for a pipelined operation */ +# define EVP_CTRL_SET_PIPELINE_INPUT_LENS 0x24 + +/* Padding modes */ +#define EVP_PADDING_PKCS7 1 +#define EVP_PADDING_ISO7816_4 2 +#define EVP_PADDING_ANSI923 3 +#define EVP_PADDING_ISO10126 4 +#define EVP_PADDING_ZERO 5 + +/* RFC 5246 defines additional data to be 13 bytes in length */ +# define EVP_AEAD_TLS1_AAD_LEN 13 + +typedef struct { + unsigned char *out; + const unsigned char *inp; + size_t len; + unsigned int interleave; +} EVP_CTRL_TLS1_1_MULTIBLOCK_PARAM; + +/* GCM TLS constants */ +/* Length of fixed part of IV derived from PRF */ +# define EVP_GCM_TLS_FIXED_IV_LEN 4 +/* Length of explicit part of IV part of TLS records */ +# define EVP_GCM_TLS_EXPLICIT_IV_LEN 8 +/* Length of tag for TLS */ +# define EVP_GCM_TLS_TAG_LEN 16 + +/* CCM TLS constants */ +/* Length of fixed part of IV derived from PRF */ +# define EVP_CCM_TLS_FIXED_IV_LEN 4 +/* Length of explicit part of IV part of TLS records */ +# define EVP_CCM_TLS_EXPLICIT_IV_LEN 8 +/* Total length of CCM IV length for TLS */ +# define EVP_CCM_TLS_IV_LEN 12 +/* Length of tag for TLS */ +# define EVP_CCM_TLS_TAG_LEN 16 +/* Length of CCM8 tag for TLS */ +# define EVP_CCM8_TLS_TAG_LEN 8 + +/* Length of tag for TLS */ +# define EVP_CHACHAPOLY_TLS_TAG_LEN 16 + +typedef struct evp_cipher_info_st { + const EVP_CIPHER *cipher; + unsigned char iv[EVP_MAX_IV_LENGTH]; +} EVP_CIPHER_INFO; + + +/* Password based encryption function */ +typedef int (EVP_PBE_KEYGEN) (EVP_CIPHER_CTX *ctx, const char *pass, + int passlen, ASN1_TYPE *param, + const EVP_CIPHER *cipher, const EVP_MD *md, + int en_de); + +# ifndef OPENSSL_NO_RSA +# define EVP_PKEY_assign_RSA(pkey,rsa) EVP_PKEY_assign((pkey),EVP_PKEY_RSA,\ + (char *)(rsa)) +# endif + +# ifndef OPENSSL_NO_DSA +# define EVP_PKEY_assign_DSA(pkey,dsa) EVP_PKEY_assign((pkey),EVP_PKEY_DSA,\ + (char *)(dsa)) +# endif + +# ifndef OPENSSL_NO_DH +# define EVP_PKEY_assign_DH(pkey,dh) EVP_PKEY_assign((pkey),EVP_PKEY_DH,\ + (char *)(dh)) +# endif + +# ifndef OPENSSL_NO_EC +# define EVP_PKEY_assign_EC_KEY(pkey,eckey) EVP_PKEY_assign((pkey),EVP_PKEY_EC,\ + (char *)(eckey)) +# endif +# ifndef OPENSSL_NO_SIPHASH +# define EVP_PKEY_assign_SIPHASH(pkey,shkey) EVP_PKEY_assign((pkey),EVP_PKEY_SIPHASH,\ + (char *)(shkey)) +# endif + +# ifndef OPENSSL_NO_POLY1305 +# define EVP_PKEY_assign_POLY1305(pkey,polykey) EVP_PKEY_assign((pkey),EVP_PKEY_POLY1305,\ + (char *)(polykey)) +# endif + +/* Add some extra combinations */ +# define EVP_get_digestbynid(a) EVP_get_digestbyname(OBJ_nid2sn(a)) +# define EVP_get_digestbyobj(a) EVP_get_digestbynid(OBJ_obj2nid(a)) +# define EVP_get_cipherbynid(a) EVP_get_cipherbyname(OBJ_nid2sn(a)) +# define EVP_get_cipherbyobj(a) EVP_get_cipherbynid(OBJ_obj2nid(a)) + +int EVP_MD_type(const EVP_MD *md); +# define EVP_MD_nid(e) EVP_MD_type(e) +# define EVP_MD_name(e) OBJ_nid2sn(EVP_MD_nid(e)) +int EVP_MD_pkey_type(const EVP_MD *md); +int EVP_MD_size(const EVP_MD *md); +int EVP_MD_block_size(const EVP_MD *md); +unsigned long EVP_MD_flags(const EVP_MD *md); + +const EVP_MD *EVP_MD_CTX_md(const EVP_MD_CTX *ctx); +int (*EVP_MD_CTX_update_fn(EVP_MD_CTX *ctx))(EVP_MD_CTX *ctx, + const void *data, size_t count); +void EVP_MD_CTX_set_update_fn(EVP_MD_CTX *ctx, + int (*update) (EVP_MD_CTX *ctx, + const void *data, size_t count)); +# define EVP_MD_CTX_size(e) EVP_MD_size(EVP_MD_CTX_md(e)) +# define EVP_MD_CTX_block_size(e) EVP_MD_block_size(EVP_MD_CTX_md(e)) +# define EVP_MD_CTX_type(e) EVP_MD_type(EVP_MD_CTX_md(e)) +EVP_PKEY_CTX *EVP_MD_CTX_pkey_ctx(const EVP_MD_CTX *ctx); +void EVP_MD_CTX_set_pkey_ctx(EVP_MD_CTX *ctx, EVP_PKEY_CTX *pctx); +void *EVP_MD_CTX_md_data(const EVP_MD_CTX *ctx); + +int EVP_CIPHER_nid(const EVP_CIPHER *cipher); +# define EVP_CIPHER_name(e) OBJ_nid2sn(EVP_CIPHER_nid(e)) +int EVP_CIPHER_block_size(const EVP_CIPHER *cipher); +int EVP_CIPHER_impl_ctx_size(const EVP_CIPHER *cipher); +int EVP_CIPHER_key_length(const EVP_CIPHER *cipher); +int EVP_CIPHER_iv_length(const EVP_CIPHER *cipher); +unsigned long EVP_CIPHER_flags(const EVP_CIPHER *cipher); +# define EVP_CIPHER_mode(e) (EVP_CIPHER_flags(e) & EVP_CIPH_MODE) + +const EVP_CIPHER *EVP_CIPHER_CTX_cipher(const EVP_CIPHER_CTX *ctx); +int EVP_CIPHER_CTX_encrypting(const EVP_CIPHER_CTX *ctx); +int EVP_CIPHER_CTX_nid(const EVP_CIPHER_CTX *ctx); +int EVP_CIPHER_CTX_block_size(const EVP_CIPHER_CTX *ctx); +int EVP_CIPHER_CTX_key_length(const EVP_CIPHER_CTX *ctx); +int EVP_CIPHER_CTX_iv_length(const EVP_CIPHER_CTX *ctx); +const unsigned char *EVP_CIPHER_CTX_iv(const EVP_CIPHER_CTX *ctx); +const unsigned char *EVP_CIPHER_CTX_original_iv(const EVP_CIPHER_CTX *ctx); +unsigned char *EVP_CIPHER_CTX_iv_noconst(EVP_CIPHER_CTX *ctx); +unsigned char *EVP_CIPHER_CTX_buf_noconst(EVP_CIPHER_CTX *ctx); +int EVP_CIPHER_CTX_num(const EVP_CIPHER_CTX *ctx); +void EVP_CIPHER_CTX_set_num(EVP_CIPHER_CTX *ctx, int num); +int EVP_CIPHER_CTX_copy(EVP_CIPHER_CTX *out, const EVP_CIPHER_CTX *in); +void *EVP_CIPHER_CTX_get_app_data(const EVP_CIPHER_CTX *ctx); +void EVP_CIPHER_CTX_set_app_data(EVP_CIPHER_CTX *ctx, void *data); +void *EVP_CIPHER_CTX_get_cipher_data(const EVP_CIPHER_CTX *ctx); +void *EVP_CIPHER_CTX_set_cipher_data(EVP_CIPHER_CTX *ctx, void *cipher_data); +# define EVP_CIPHER_CTX_type(c) EVP_CIPHER_type(EVP_CIPHER_CTX_cipher(c)) +# if OPENSSL_API_COMPAT < 0x10100000L +# define EVP_CIPHER_CTX_flags(c) EVP_CIPHER_flags(EVP_CIPHER_CTX_cipher(c)) +# endif +# define EVP_CIPHER_CTX_mode(c) EVP_CIPHER_mode(EVP_CIPHER_CTX_cipher(c)) + +# define EVP_ENCODE_LENGTH(l) ((((l)+2)/3*4)+((l)/48+1)*2+80) +# define EVP_DECODE_LENGTH(l) (((l)+3)/4*3+80) + +# define EVP_SignInit_ex(a,b,c) EVP_DigestInit_ex(a,b,c) +# define EVP_SignInit(a,b) EVP_DigestInit(a,b) +# define EVP_SignUpdate(a,b,c) EVP_DigestUpdate(a,b,c) +# define EVP_VerifyInit_ex(a,b,c) EVP_DigestInit_ex(a,b,c) +# define EVP_VerifyInit(a,b) EVP_DigestInit(a,b) +# define EVP_VerifyUpdate(a,b,c) EVP_DigestUpdate(a,b,c) +# define EVP_OpenUpdate(a,b,c,d,e) EVP_DecryptUpdate(a,b,c,d,e) +# define EVP_SealUpdate(a,b,c,d,e) EVP_EncryptUpdate(a,b,c,d,e) +# define EVP_DigestSignUpdate(a,b,c) EVP_DigestUpdate(a,b,c) +# define EVP_DigestVerifyUpdate(a,b,c) EVP_DigestUpdate(a,b,c) + +# ifdef CONST_STRICT +void BIO_set_md(BIO *, const EVP_MD *md); +# else +# define BIO_set_md(b,md) BIO_ctrl(b,BIO_C_SET_MD,0,(char *)(md)) +# endif +# define BIO_get_md(b,mdp) BIO_ctrl(b,BIO_C_GET_MD,0,(char *)(mdp)) +# define BIO_get_md_ctx(b,mdcp) BIO_ctrl(b,BIO_C_GET_MD_CTX,0, \ + (char *)(mdcp)) +# define BIO_set_md_ctx(b,mdcp) BIO_ctrl(b,BIO_C_SET_MD_CTX,0, \ + (char *)(mdcp)) +# define BIO_get_cipher_status(b) BIO_ctrl(b,BIO_C_GET_CIPHER_STATUS,0,NULL) +# define BIO_get_cipher_ctx(b,c_pp) BIO_ctrl(b,BIO_C_GET_CIPHER_CTX,0, \ + (char *)(c_pp)) + +/*__owur*/ int EVP_Cipher(EVP_CIPHER_CTX *c, + unsigned char *out, + const unsigned char *in, unsigned int inl); + +# define EVP_add_cipher_alias(n,alias) \ + OBJ_NAME_add((alias),OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS,(n)) +# define EVP_add_digest_alias(n,alias) \ + OBJ_NAME_add((alias),OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS,(n)) +# define EVP_delete_cipher_alias(alias) \ + OBJ_NAME_remove(alias,OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS); +# define EVP_delete_digest_alias(alias) \ + OBJ_NAME_remove(alias,OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS); + +int EVP_MD_CTX_ctrl(EVP_MD_CTX *ctx, int cmd, int p1, void *p2); +EVP_MD_CTX *EVP_MD_CTX_new(void); +int EVP_MD_CTX_reset(EVP_MD_CTX *ctx); +void EVP_MD_CTX_free(EVP_MD_CTX *ctx); +# define EVP_MD_CTX_create() EVP_MD_CTX_new() +# define EVP_MD_CTX_init(ctx) EVP_MD_CTX_reset((ctx)) +# define EVP_MD_CTX_destroy(ctx) EVP_MD_CTX_free((ctx)) +__owur int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out, const EVP_MD_CTX *in); +void EVP_MD_CTX_set_flags(EVP_MD_CTX *ctx, int flags); +void EVP_MD_CTX_clear_flags(EVP_MD_CTX *ctx, int flags); +int EVP_MD_CTX_test_flags(const EVP_MD_CTX *ctx, int flags); +__owur int EVP_DigestInit_ex(EVP_MD_CTX *ctx, const EVP_MD *type, + ENGINE *impl); +__owur int EVP_DigestUpdate(EVP_MD_CTX *ctx, const void *d, + size_t cnt); +__owur int EVP_DigestFinal_ex(EVP_MD_CTX *ctx, unsigned char *md, + unsigned int *s); +__owur int EVP_Digest(const void *data, size_t count, + unsigned char *md, unsigned int *size, + const EVP_MD *type, ENGINE *impl); + +__owur int EVP_MD_CTX_copy(EVP_MD_CTX *out, const EVP_MD_CTX *in); +__owur int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type); +__owur int EVP_DigestFinal(EVP_MD_CTX *ctx, unsigned char *md, + unsigned int *s); +__owur int EVP_DigestFinalXOF(EVP_MD_CTX *ctx, unsigned char *md, + size_t len); + +int EVP_read_pw_string(char *buf, int length, const char *prompt, int verify); +int EVP_read_pw_string_min(char *buf, int minlen, int maxlen, + const char *prompt, int verify); +void EVP_set_pw_prompt(const char *prompt); +char *EVP_get_pw_prompt(void); + +__owur int EVP_BytesToKey(const EVP_CIPHER *type, const EVP_MD *md, + const unsigned char *salt, + const unsigned char *data, int datal, int count, + unsigned char *key, unsigned char *iv); + +void EVP_CIPHER_CTX_set_flags(EVP_CIPHER_CTX *ctx, int flags); +void EVP_CIPHER_CTX_clear_flags(EVP_CIPHER_CTX *ctx, int flags); +int EVP_CIPHER_CTX_test_flags(const EVP_CIPHER_CTX *ctx, int flags); + +__owur int EVP_EncryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher, + const unsigned char *key, const unsigned char *iv); +/*__owur*/ int EVP_EncryptInit_ex(EVP_CIPHER_CTX *ctx, + const EVP_CIPHER *cipher, ENGINE *impl, + const unsigned char *key, + const unsigned char *iv); +/*__owur*/ int EVP_EncryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, + int *outl, const unsigned char *in, int inl); +/*__owur*/ int EVP_EncryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *out, + int *outl); +/*__owur*/ int EVP_EncryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, + int *outl); + +__owur int EVP_DecryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher, + const unsigned char *key, const unsigned char *iv); +/*__owur*/ int EVP_DecryptInit_ex(EVP_CIPHER_CTX *ctx, + const EVP_CIPHER *cipher, ENGINE *impl, + const unsigned char *key, + const unsigned char *iv); +/*__owur*/ int EVP_DecryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, + int *outl, const unsigned char *in, int inl); +__owur int EVP_DecryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm, + int *outl); +/*__owur*/ int EVP_DecryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm, + int *outl); + +__owur int EVP_CipherInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher, + const unsigned char *key, const unsigned char *iv, + int enc); +/*__owur*/ int EVP_CipherInit_ex(EVP_CIPHER_CTX *ctx, + const EVP_CIPHER *cipher, ENGINE *impl, + const unsigned char *key, + const unsigned char *iv, int enc); +__owur int EVP_CipherUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, + int *outl, const unsigned char *in, int inl); +__owur int EVP_CipherFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm, + int *outl); +__owur int EVP_CipherFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm, + int *outl); + +__owur int EVP_SignFinal(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *s, + EVP_PKEY *pkey); + +__owur int EVP_DigestSign(EVP_MD_CTX *ctx, unsigned char *sigret, + size_t *siglen, const unsigned char *tbs, + size_t tbslen); + +__owur int EVP_VerifyFinal(EVP_MD_CTX *ctx, const unsigned char *sigbuf, + unsigned int siglen, EVP_PKEY *pkey); + +__owur int EVP_DigestVerify(EVP_MD_CTX *ctx, const unsigned char *sigret, + size_t siglen, const unsigned char *tbs, + size_t tbslen); + +/*__owur*/ int EVP_DigestSignInit(EVP_MD_CTX *ctx, EVP_PKEY_CTX **pctx, + const EVP_MD *type, ENGINE *e, + EVP_PKEY *pkey); +__owur int EVP_DigestSignFinal(EVP_MD_CTX *ctx, unsigned char *sigret, + size_t *siglen); + +__owur int EVP_DigestVerifyInit(EVP_MD_CTX *ctx, EVP_PKEY_CTX **pctx, + const EVP_MD *type, ENGINE *e, + EVP_PKEY *pkey); +__owur int EVP_DigestVerifyFinal(EVP_MD_CTX *ctx, const unsigned char *sig, + size_t siglen); + +# ifndef OPENSSL_NO_RSA +__owur int EVP_OpenInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type, + const unsigned char *ek, int ekl, + const unsigned char *iv, EVP_PKEY *priv); +__owur int EVP_OpenFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl); + +__owur int EVP_SealInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type, + unsigned char **ek, int *ekl, unsigned char *iv, + EVP_PKEY **pubk, int npubk); +__owur int EVP_SealFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl); +# endif + +EVP_ENCODE_CTX *EVP_ENCODE_CTX_new(void); +void EVP_ENCODE_CTX_free(EVP_ENCODE_CTX *ctx); +int EVP_ENCODE_CTX_copy(EVP_ENCODE_CTX *dctx, EVP_ENCODE_CTX *sctx); +int EVP_ENCODE_CTX_num(EVP_ENCODE_CTX *ctx); +void EVP_EncodeInit(EVP_ENCODE_CTX *ctx); +int EVP_EncodeUpdate(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl, + const unsigned char *in, int inl); +void EVP_EncodeFinal(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl); +int EVP_EncodeBlock(unsigned char *t, const unsigned char *f, int n); + +void EVP_DecodeInit(EVP_ENCODE_CTX *ctx); +int EVP_DecodeUpdate(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl, + const unsigned char *in, int inl); +int EVP_DecodeFinal(EVP_ENCODE_CTX *ctx, unsigned + char *out, int *outl); +int EVP_DecodeBlock(unsigned char *t, const unsigned char *f, int n); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define EVP_CIPHER_CTX_init(c) EVP_CIPHER_CTX_reset(c) +# define EVP_CIPHER_CTX_cleanup(c) EVP_CIPHER_CTX_reset(c) +# endif +EVP_CIPHER_CTX *EVP_CIPHER_CTX_new(void); +int EVP_CIPHER_CTX_reset(EVP_CIPHER_CTX *c); +void EVP_CIPHER_CTX_free(EVP_CIPHER_CTX *c); +int EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX *x, int keylen); +int EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX *c, int pad); +int EVP_CIPHER_CTX_ctrl(EVP_CIPHER_CTX *ctx, int type, int arg, void *ptr); +int EVP_CIPHER_CTX_rand_key(EVP_CIPHER_CTX *ctx, unsigned char *key); + +const BIO_METHOD *BIO_f_md(void); +const BIO_METHOD *BIO_f_base64(void); +const BIO_METHOD *BIO_f_cipher(void); +const BIO_METHOD *BIO_f_reliable(void); +__owur int BIO_set_cipher(BIO *b, const EVP_CIPHER *c, const unsigned char *k, + const unsigned char *i, int enc); + +const EVP_MD *EVP_md_null(void); +# ifndef OPENSSL_NO_MD2 +const EVP_MD *EVP_md2(void); +# endif +# ifndef OPENSSL_NO_MD4 +const EVP_MD *EVP_md4(void); +# endif +# ifndef OPENSSL_NO_MD5 +const EVP_MD *EVP_md5(void); +const EVP_MD *EVP_md5_sha1(void); +# endif +# ifndef OPENSSL_NO_BLAKE2 +const EVP_MD *EVP_blake2b512(void); +const EVP_MD *EVP_blake2s256(void); +# endif +const EVP_MD *EVP_sha1(void); +const EVP_MD *EVP_sha224(void); +const EVP_MD *EVP_sha256(void); +const EVP_MD *EVP_sha384(void); +const EVP_MD *EVP_sha512(void); +const EVP_MD *EVP_sha512_224(void); +const EVP_MD *EVP_sha512_256(void); +const EVP_MD *EVP_sha3_224(void); +const EVP_MD *EVP_sha3_256(void); +const EVP_MD *EVP_sha3_384(void); +const EVP_MD *EVP_sha3_512(void); +const EVP_MD *EVP_shake128(void); +const EVP_MD *EVP_shake256(void); +# ifndef OPENSSL_NO_MDC2 +const EVP_MD *EVP_mdc2(void); +# endif +# ifndef OPENSSL_NO_RMD160 +const EVP_MD *EVP_ripemd160(void); +# endif +# ifndef OPENSSL_NO_WHIRLPOOL +const EVP_MD *EVP_whirlpool(void); +# endif +# ifndef OPENSSL_NO_SM3 +const EVP_MD *EVP_sm3(void); +# endif +const EVP_CIPHER *EVP_enc_null(void); /* does nothing :-) */ +# ifndef OPENSSL_NO_DES +const EVP_CIPHER *EVP_des_ecb(void); +const EVP_CIPHER *EVP_des_ede(void); +const EVP_CIPHER *EVP_des_ede3(void); +const EVP_CIPHER *EVP_des_ede_ecb(void); +const EVP_CIPHER *EVP_des_ede3_ecb(void); +const EVP_CIPHER *EVP_des_cfb64(void); +# define EVP_des_cfb EVP_des_cfb64 +const EVP_CIPHER *EVP_des_cfb1(void); +const EVP_CIPHER *EVP_des_cfb8(void); +const EVP_CIPHER *EVP_des_ede_cfb64(void); +# define EVP_des_ede_cfb EVP_des_ede_cfb64 +const EVP_CIPHER *EVP_des_ede3_cfb64(void); +# define EVP_des_ede3_cfb EVP_des_ede3_cfb64 +const EVP_CIPHER *EVP_des_ede3_cfb1(void); +const EVP_CIPHER *EVP_des_ede3_cfb8(void); +const EVP_CIPHER *EVP_des_ofb(void); +const EVP_CIPHER *EVP_des_ede_ofb(void); +const EVP_CIPHER *EVP_des_ede3_ofb(void); +const EVP_CIPHER *EVP_des_cbc(void); +const EVP_CIPHER *EVP_des_ede_cbc(void); +const EVP_CIPHER *EVP_des_ede3_cbc(void); +const EVP_CIPHER *EVP_desx_cbc(void); +const EVP_CIPHER *EVP_des_ede3_wrap(void); +/* + * This should now be supported through the dev_crypto ENGINE. But also, why + * are rc4 and md5 declarations made here inside a "NO_DES" precompiler + * branch? + */ +# endif +# ifndef OPENSSL_NO_RC4 +const EVP_CIPHER *EVP_rc4(void); +const EVP_CIPHER *EVP_rc4_40(void); +# ifndef OPENSSL_NO_MD5 +const EVP_CIPHER *EVP_rc4_hmac_md5(void); +# endif +# endif +# ifndef OPENSSL_NO_IDEA +const EVP_CIPHER *EVP_idea_ecb(void); +const EVP_CIPHER *EVP_idea_cfb64(void); +# define EVP_idea_cfb EVP_idea_cfb64 +const EVP_CIPHER *EVP_idea_ofb(void); +const EVP_CIPHER *EVP_idea_cbc(void); +# endif +# ifndef OPENSSL_NO_RC2 +const EVP_CIPHER *EVP_rc2_ecb(void); +const EVP_CIPHER *EVP_rc2_cbc(void); +const EVP_CIPHER *EVP_rc2_40_cbc(void); +const EVP_CIPHER *EVP_rc2_64_cbc(void); +const EVP_CIPHER *EVP_rc2_cfb64(void); +# define EVP_rc2_cfb EVP_rc2_cfb64 +const EVP_CIPHER *EVP_rc2_ofb(void); +# endif +# ifndef OPENSSL_NO_BF +const EVP_CIPHER *EVP_bf_ecb(void); +const EVP_CIPHER *EVP_bf_cbc(void); +const EVP_CIPHER *EVP_bf_cfb64(void); +# define EVP_bf_cfb EVP_bf_cfb64 +const EVP_CIPHER *EVP_bf_ofb(void); +# endif +# ifndef OPENSSL_NO_CAST +const EVP_CIPHER *EVP_cast5_ecb(void); +const EVP_CIPHER *EVP_cast5_cbc(void); +const EVP_CIPHER *EVP_cast5_cfb64(void); +# define EVP_cast5_cfb EVP_cast5_cfb64 +const EVP_CIPHER *EVP_cast5_ofb(void); +# endif +# ifndef OPENSSL_NO_RC5 +const EVP_CIPHER *EVP_rc5_32_12_16_cbc(void); +const EVP_CIPHER *EVP_rc5_32_12_16_ecb(void); +const EVP_CIPHER *EVP_rc5_32_12_16_cfb64(void); +# define EVP_rc5_32_12_16_cfb EVP_rc5_32_12_16_cfb64 +const EVP_CIPHER *EVP_rc5_32_12_16_ofb(void); +# endif +const EVP_CIPHER *EVP_aes_128_ecb(void); +const EVP_CIPHER *EVP_aes_128_cbc(void); +const EVP_CIPHER *EVP_aes_128_cfb1(void); +const EVP_CIPHER *EVP_aes_128_cfb8(void); +const EVP_CIPHER *EVP_aes_128_cfb128(void); +# define EVP_aes_128_cfb EVP_aes_128_cfb128 +const EVP_CIPHER *EVP_aes_128_ofb(void); +const EVP_CIPHER *EVP_aes_128_ctr(void); +const EVP_CIPHER *EVP_aes_128_ccm(void); +const EVP_CIPHER *EVP_aes_128_gcm(void); +const EVP_CIPHER *EVP_aes_128_xts(void); +const EVP_CIPHER *EVP_aes_128_wrap(void); +const EVP_CIPHER *EVP_aes_128_wrap_pad(void); +# ifndef OPENSSL_NO_OCB +const EVP_CIPHER *EVP_aes_128_ocb(void); +# endif +const EVP_CIPHER *EVP_aes_192_ecb(void); +const EVP_CIPHER *EVP_aes_192_cbc(void); +const EVP_CIPHER *EVP_aes_192_cfb1(void); +const EVP_CIPHER *EVP_aes_192_cfb8(void); +const EVP_CIPHER *EVP_aes_192_cfb128(void); +# define EVP_aes_192_cfb EVP_aes_192_cfb128 +const EVP_CIPHER *EVP_aes_192_ofb(void); +const EVP_CIPHER *EVP_aes_192_ctr(void); +const EVP_CIPHER *EVP_aes_192_ccm(void); +const EVP_CIPHER *EVP_aes_192_gcm(void); +const EVP_CIPHER *EVP_aes_192_wrap(void); +const EVP_CIPHER *EVP_aes_192_wrap_pad(void); +# ifndef OPENSSL_NO_OCB +const EVP_CIPHER *EVP_aes_192_ocb(void); +# endif +const EVP_CIPHER *EVP_aes_256_ecb(void); +const EVP_CIPHER *EVP_aes_256_cbc(void); +const EVP_CIPHER *EVP_aes_256_cfb1(void); +const EVP_CIPHER *EVP_aes_256_cfb8(void); +const EVP_CIPHER *EVP_aes_256_cfb128(void); +# define EVP_aes_256_cfb EVP_aes_256_cfb128 +const EVP_CIPHER *EVP_aes_256_ofb(void); +const EVP_CIPHER *EVP_aes_256_ctr(void); +const EVP_CIPHER *EVP_aes_256_ccm(void); +const EVP_CIPHER *EVP_aes_256_gcm(void); +const EVP_CIPHER *EVP_aes_256_xts(void); +const EVP_CIPHER *EVP_aes_256_wrap(void); +const EVP_CIPHER *EVP_aes_256_wrap_pad(void); +# ifndef OPENSSL_NO_OCB +const EVP_CIPHER *EVP_aes_256_ocb(void); +# endif +const EVP_CIPHER *EVP_aes_128_cbc_hmac_sha1(void); +const EVP_CIPHER *EVP_aes_256_cbc_hmac_sha1(void); +const EVP_CIPHER *EVP_aes_128_cbc_hmac_sha256(void); +const EVP_CIPHER *EVP_aes_256_cbc_hmac_sha256(void); +# ifndef OPENSSL_NO_ARIA +const EVP_CIPHER *EVP_aria_128_ecb(void); +const EVP_CIPHER *EVP_aria_128_cbc(void); +const EVP_CIPHER *EVP_aria_128_cfb1(void); +const EVP_CIPHER *EVP_aria_128_cfb8(void); +const EVP_CIPHER *EVP_aria_128_cfb128(void); +# define EVP_aria_128_cfb EVP_aria_128_cfb128 +const EVP_CIPHER *EVP_aria_128_ctr(void); +const EVP_CIPHER *EVP_aria_128_ofb(void); +const EVP_CIPHER *EVP_aria_128_gcm(void); +const EVP_CIPHER *EVP_aria_128_ccm(void); +const EVP_CIPHER *EVP_aria_192_ecb(void); +const EVP_CIPHER *EVP_aria_192_cbc(void); +const EVP_CIPHER *EVP_aria_192_cfb1(void); +const EVP_CIPHER *EVP_aria_192_cfb8(void); +const EVP_CIPHER *EVP_aria_192_cfb128(void); +# define EVP_aria_192_cfb EVP_aria_192_cfb128 +const EVP_CIPHER *EVP_aria_192_ctr(void); +const EVP_CIPHER *EVP_aria_192_ofb(void); +const EVP_CIPHER *EVP_aria_192_gcm(void); +const EVP_CIPHER *EVP_aria_192_ccm(void); +const EVP_CIPHER *EVP_aria_256_ecb(void); +const EVP_CIPHER *EVP_aria_256_cbc(void); +const EVP_CIPHER *EVP_aria_256_cfb1(void); +const EVP_CIPHER *EVP_aria_256_cfb8(void); +const EVP_CIPHER *EVP_aria_256_cfb128(void); +# define EVP_aria_256_cfb EVP_aria_256_cfb128 +const EVP_CIPHER *EVP_aria_256_ctr(void); +const EVP_CIPHER *EVP_aria_256_ofb(void); +const EVP_CIPHER *EVP_aria_256_gcm(void); +const EVP_CIPHER *EVP_aria_256_ccm(void); +# endif +# ifndef OPENSSL_NO_CAMELLIA +const EVP_CIPHER *EVP_camellia_128_ecb(void); +const EVP_CIPHER *EVP_camellia_128_cbc(void); +const EVP_CIPHER *EVP_camellia_128_cfb1(void); +const EVP_CIPHER *EVP_camellia_128_cfb8(void); +const EVP_CIPHER *EVP_camellia_128_cfb128(void); +# define EVP_camellia_128_cfb EVP_camellia_128_cfb128 +const EVP_CIPHER *EVP_camellia_128_ofb(void); +const EVP_CIPHER *EVP_camellia_128_ctr(void); +const EVP_CIPHER *EVP_camellia_192_ecb(void); +const EVP_CIPHER *EVP_camellia_192_cbc(void); +const EVP_CIPHER *EVP_camellia_192_cfb1(void); +const EVP_CIPHER *EVP_camellia_192_cfb8(void); +const EVP_CIPHER *EVP_camellia_192_cfb128(void); +# define EVP_camellia_192_cfb EVP_camellia_192_cfb128 +const EVP_CIPHER *EVP_camellia_192_ofb(void); +const EVP_CIPHER *EVP_camellia_192_ctr(void); +const EVP_CIPHER *EVP_camellia_256_ecb(void); +const EVP_CIPHER *EVP_camellia_256_cbc(void); +const EVP_CIPHER *EVP_camellia_256_cfb1(void); +const EVP_CIPHER *EVP_camellia_256_cfb8(void); +const EVP_CIPHER *EVP_camellia_256_cfb128(void); +# define EVP_camellia_256_cfb EVP_camellia_256_cfb128 +const EVP_CIPHER *EVP_camellia_256_ofb(void); +const EVP_CIPHER *EVP_camellia_256_ctr(void); +# endif +# ifndef OPENSSL_NO_CHACHA +const EVP_CIPHER *EVP_chacha20(void); +# ifndef OPENSSL_NO_POLY1305 +const EVP_CIPHER *EVP_chacha20_poly1305(void); +# endif +# endif + +# ifndef OPENSSL_NO_SEED +const EVP_CIPHER *EVP_seed_ecb(void); +const EVP_CIPHER *EVP_seed_cbc(void); +const EVP_CIPHER *EVP_seed_cfb128(void); +# define EVP_seed_cfb EVP_seed_cfb128 +const EVP_CIPHER *EVP_seed_ofb(void); +# endif + +# ifndef OPENSSL_NO_SM4 +const EVP_CIPHER *EVP_sm4_ecb(void); +const EVP_CIPHER *EVP_sm4_cbc(void); +const EVP_CIPHER *EVP_sm4_cfb128(void); +# define EVP_sm4_cfb EVP_sm4_cfb128 +const EVP_CIPHER *EVP_sm4_ofb(void); +const EVP_CIPHER *EVP_sm4_ctr(void); +# endif + +# if OPENSSL_API_COMPAT < 0x10100000L +# define OPENSSL_add_all_algorithms_conf() \ + OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS \ + | OPENSSL_INIT_ADD_ALL_DIGESTS \ + | OPENSSL_INIT_LOAD_CONFIG, NULL) +# define OPENSSL_add_all_algorithms_noconf() \ + OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS \ + | OPENSSL_INIT_ADD_ALL_DIGESTS, NULL) + +# ifdef OPENSSL_LOAD_CONF +# define OpenSSL_add_all_algorithms() \ + OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS \ + | OPENSSL_INIT_ADD_ALL_DIGESTS \ + | OPENSSL_INIT_LOAD_CONFIG, NULL) +# else +# define OpenSSL_add_all_algorithms() \ + OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS \ + | OPENSSL_INIT_ADD_ALL_DIGESTS, NULL) +# endif + +# define OpenSSL_add_all_ciphers() \ + OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_CIPHERS, NULL) +# define OpenSSL_add_all_digests() \ + OPENSSL_init_crypto(OPENSSL_INIT_ADD_ALL_DIGESTS, NULL) + +# define EVP_cleanup() while(0) continue +# endif + +int EVP_add_cipher(const EVP_CIPHER *cipher); +int EVP_add_digest(const EVP_MD *digest); + +const EVP_CIPHER *EVP_get_cipherbyname(const char *name); +const EVP_MD *EVP_get_digestbyname(const char *name); + +void EVP_CIPHER_do_all(void (*fn) (const EVP_CIPHER *ciph, + const char *from, const char *to, void *x), + void *arg); +void EVP_CIPHER_do_all_sorted(void (*fn) + (const EVP_CIPHER *ciph, const char *from, + const char *to, void *x), void *arg); + +void EVP_MD_do_all(void (*fn) (const EVP_MD *ciph, + const char *from, const char *to, void *x), + void *arg); +void EVP_MD_do_all_sorted(void (*fn) + (const EVP_MD *ciph, const char *from, + const char *to, void *x), void *arg); + +int EVP_PKEY_decrypt_old(unsigned char *dec_key, + const unsigned char *enc_key, int enc_key_len, + EVP_PKEY *private_key); +int EVP_PKEY_encrypt_old(unsigned char *enc_key, + const unsigned char *key, int key_len, + EVP_PKEY *pub_key); +int EVP_PKEY_type(int type); +int EVP_PKEY_id(const EVP_PKEY *pkey); +int EVP_PKEY_base_id(const EVP_PKEY *pkey); +int EVP_PKEY_bits(const EVP_PKEY *pkey); +int EVP_PKEY_security_bits(const EVP_PKEY *pkey); +int EVP_PKEY_size(EVP_PKEY *pkey); +int EVP_PKEY_set_type(EVP_PKEY *pkey, int type); +int EVP_PKEY_set_type_str(EVP_PKEY *pkey, const char *str, int len); +int EVP_PKEY_set_alias_type(EVP_PKEY *pkey, int type); +# ifndef OPENSSL_NO_ENGINE +int EVP_PKEY_set1_engine(EVP_PKEY *pkey, ENGINE *e); +# endif +int EVP_PKEY_assign(EVP_PKEY *pkey, int type, void *key); +void *EVP_PKEY_get0(const EVP_PKEY *pkey); +const unsigned char *EVP_PKEY_get0_hmac(const EVP_PKEY *pkey, size_t *len); +# ifndef OPENSSL_NO_POLY1305 +const unsigned char *EVP_PKEY_get0_poly1305(const EVP_PKEY *pkey, size_t *len); +# endif +# ifndef OPENSSL_NO_SIPHASH +const unsigned char *EVP_PKEY_get0_siphash(const EVP_PKEY *pkey, size_t *len); +# endif + +# ifndef OPENSSL_NO_RSA +struct rsa_st; +int EVP_PKEY_set1_RSA(EVP_PKEY *pkey, struct rsa_st *key); +struct rsa_st *EVP_PKEY_get0_RSA(EVP_PKEY *pkey); +struct rsa_st *EVP_PKEY_get1_RSA(EVP_PKEY *pkey); +# endif +# ifndef OPENSSL_NO_DSA +struct dsa_st; +int EVP_PKEY_set1_DSA(EVP_PKEY *pkey, struct dsa_st *key); +struct dsa_st *EVP_PKEY_get0_DSA(EVP_PKEY *pkey); +struct dsa_st *EVP_PKEY_get1_DSA(EVP_PKEY *pkey); +# endif +# ifndef OPENSSL_NO_DH +struct dh_st; +int EVP_PKEY_set1_DH(EVP_PKEY *pkey, struct dh_st *key); +struct dh_st *EVP_PKEY_get0_DH(EVP_PKEY *pkey); +struct dh_st *EVP_PKEY_get1_DH(EVP_PKEY *pkey); +# endif +# ifndef OPENSSL_NO_EC +struct ec_key_st; +int EVP_PKEY_set1_EC_KEY(EVP_PKEY *pkey, struct ec_key_st *key); +struct ec_key_st *EVP_PKEY_get0_EC_KEY(EVP_PKEY *pkey); +struct ec_key_st *EVP_PKEY_get1_EC_KEY(EVP_PKEY *pkey); +# endif + +EVP_PKEY *EVP_PKEY_new(void); +int EVP_PKEY_up_ref(EVP_PKEY *pkey); +void EVP_PKEY_free(EVP_PKEY *pkey); + +EVP_PKEY *d2i_PublicKey(int type, EVP_PKEY **a, const unsigned char **pp, + long length); +int i2d_PublicKey(EVP_PKEY *a, unsigned char **pp); + +EVP_PKEY *d2i_PrivateKey(int type, EVP_PKEY **a, const unsigned char **pp, + long length); +EVP_PKEY *d2i_AutoPrivateKey(EVP_PKEY **a, const unsigned char **pp, + long length); +int i2d_PrivateKey(EVP_PKEY *a, unsigned char **pp); + +int EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from); +int EVP_PKEY_missing_parameters(const EVP_PKEY *pkey); +int EVP_PKEY_save_parameters(EVP_PKEY *pkey, int mode); +int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b); + +int EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b); + +int EVP_PKEY_print_public(BIO *out, const EVP_PKEY *pkey, + int indent, ASN1_PCTX *pctx); +int EVP_PKEY_print_private(BIO *out, const EVP_PKEY *pkey, + int indent, ASN1_PCTX *pctx); +int EVP_PKEY_print_params(BIO *out, const EVP_PKEY *pkey, + int indent, ASN1_PCTX *pctx); + +int EVP_PKEY_get_default_digest_nid(EVP_PKEY *pkey, int *pnid); + +int EVP_PKEY_set1_tls_encodedpoint(EVP_PKEY *pkey, + const unsigned char *pt, size_t ptlen); +size_t EVP_PKEY_get1_tls_encodedpoint(EVP_PKEY *pkey, unsigned char **ppt); + +int EVP_CIPHER_type(const EVP_CIPHER *ctx); + +/* calls methods */ +int EVP_CIPHER_param_to_asn1(EVP_CIPHER_CTX *c, ASN1_TYPE *type); +int EVP_CIPHER_asn1_to_param(EVP_CIPHER_CTX *c, ASN1_TYPE *type); + +/* These are used by EVP_CIPHER methods */ +int EVP_CIPHER_set_asn1_iv(EVP_CIPHER_CTX *c, ASN1_TYPE *type); +int EVP_CIPHER_get_asn1_iv(EVP_CIPHER_CTX *c, ASN1_TYPE *type); + +/* PKCS5 password based encryption */ +int PKCS5_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen, + ASN1_TYPE *param, const EVP_CIPHER *cipher, + const EVP_MD *md, int en_de); +int PKCS5_PBKDF2_HMAC_SHA1(const char *pass, int passlen, + const unsigned char *salt, int saltlen, int iter, + int keylen, unsigned char *out); +int PKCS5_PBKDF2_HMAC(const char *pass, int passlen, + const unsigned char *salt, int saltlen, int iter, + const EVP_MD *digest, int keylen, unsigned char *out); +int PKCS5_v2_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen, + ASN1_TYPE *param, const EVP_CIPHER *cipher, + const EVP_MD *md, int en_de); + +#ifndef OPENSSL_NO_SCRYPT +int EVP_PBE_scrypt(const char *pass, size_t passlen, + const unsigned char *salt, size_t saltlen, + uint64_t N, uint64_t r, uint64_t p, uint64_t maxmem, + unsigned char *key, size_t keylen); + +int PKCS5_v2_scrypt_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, + int passlen, ASN1_TYPE *param, + const EVP_CIPHER *c, const EVP_MD *md, int en_de); +#endif + +void PKCS5_PBE_add(void); + +int EVP_PBE_CipherInit(ASN1_OBJECT *pbe_obj, const char *pass, int passlen, + ASN1_TYPE *param, EVP_CIPHER_CTX *ctx, int en_de); + +/* PBE type */ + +/* Can appear as the outermost AlgorithmIdentifier */ +# define EVP_PBE_TYPE_OUTER 0x0 +/* Is an PRF type OID */ +# define EVP_PBE_TYPE_PRF 0x1 +/* Is a PKCS#5 v2.0 KDF */ +# define EVP_PBE_TYPE_KDF 0x2 + +int EVP_PBE_alg_add_type(int pbe_type, int pbe_nid, int cipher_nid, + int md_nid, EVP_PBE_KEYGEN *keygen); +int EVP_PBE_alg_add(int nid, const EVP_CIPHER *cipher, const EVP_MD *md, + EVP_PBE_KEYGEN *keygen); +int EVP_PBE_find(int type, int pbe_nid, int *pcnid, int *pmnid, + EVP_PBE_KEYGEN **pkeygen); +void EVP_PBE_cleanup(void); +int EVP_PBE_get(int *ptype, int *ppbe_nid, size_t num); + +# define ASN1_PKEY_ALIAS 0x1 +# define ASN1_PKEY_DYNAMIC 0x2 +# define ASN1_PKEY_SIGPARAM_NULL 0x4 + +# define ASN1_PKEY_CTRL_PKCS7_SIGN 0x1 +# define ASN1_PKEY_CTRL_PKCS7_ENCRYPT 0x2 +# define ASN1_PKEY_CTRL_DEFAULT_MD_NID 0x3 +# define ASN1_PKEY_CTRL_CMS_SIGN 0x5 +# define ASN1_PKEY_CTRL_CMS_ENVELOPE 0x7 +# define ASN1_PKEY_CTRL_CMS_RI_TYPE 0x8 + +# define ASN1_PKEY_CTRL_SET1_TLS_ENCPT 0x9 +# define ASN1_PKEY_CTRL_GET1_TLS_ENCPT 0xa + +int EVP_PKEY_asn1_get_count(void); +const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_get0(int idx); +const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_find(ENGINE **pe, int type); +const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_find_str(ENGINE **pe, + const char *str, int len); +int EVP_PKEY_asn1_add0(const EVP_PKEY_ASN1_METHOD *ameth); +int EVP_PKEY_asn1_add_alias(int to, int from); +int EVP_PKEY_asn1_get0_info(int *ppkey_id, int *pkey_base_id, + int *ppkey_flags, const char **pinfo, + const char **ppem_str, + const EVP_PKEY_ASN1_METHOD *ameth); + +const EVP_PKEY_ASN1_METHOD *EVP_PKEY_get0_asn1(const EVP_PKEY *pkey); +EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_new(int id, int flags, + const char *pem_str, + const char *info); +void EVP_PKEY_asn1_copy(EVP_PKEY_ASN1_METHOD *dst, + const EVP_PKEY_ASN1_METHOD *src); +void EVP_PKEY_asn1_free(EVP_PKEY_ASN1_METHOD *ameth); +void EVP_PKEY_asn1_set_public(EVP_PKEY_ASN1_METHOD *ameth, + int (*pub_decode) (EVP_PKEY *pk, + X509_PUBKEY *pub), + int (*pub_encode) (X509_PUBKEY *pub, + const EVP_PKEY *pk), + int (*pub_cmp) (const EVP_PKEY *a, + const EVP_PKEY *b), + int (*pub_print) (BIO *out, + const EVP_PKEY *pkey, + int indent, ASN1_PCTX *pctx), + int (*pkey_size) (const EVP_PKEY *pk), + int (*pkey_bits) (const EVP_PKEY *pk)); +void EVP_PKEY_asn1_set_private(EVP_PKEY_ASN1_METHOD *ameth, + int (*priv_decode) (EVP_PKEY *pk, + const PKCS8_PRIV_KEY_INFO + *p8inf), + int (*priv_encode) (PKCS8_PRIV_KEY_INFO *p8, + const EVP_PKEY *pk), + int (*priv_print) (BIO *out, + const EVP_PKEY *pkey, + int indent, + ASN1_PCTX *pctx)); +void EVP_PKEY_asn1_set_param(EVP_PKEY_ASN1_METHOD *ameth, + int (*param_decode) (EVP_PKEY *pkey, + const unsigned char **pder, + int derlen), + int (*param_encode) (const EVP_PKEY *pkey, + unsigned char **pder), + int (*param_missing) (const EVP_PKEY *pk), + int (*param_copy) (EVP_PKEY *to, + const EVP_PKEY *from), + int (*param_cmp) (const EVP_PKEY *a, + const EVP_PKEY *b), + int (*param_print) (BIO *out, + const EVP_PKEY *pkey, + int indent, + ASN1_PCTX *pctx)); + +void EVP_PKEY_asn1_set_free(EVP_PKEY_ASN1_METHOD *ameth, + void (*pkey_free) (EVP_PKEY *pkey)); +void EVP_PKEY_asn1_set_ctrl(EVP_PKEY_ASN1_METHOD *ameth, + int (*pkey_ctrl) (EVP_PKEY *pkey, int op, + long arg1, void *arg2)); +void EVP_PKEY_asn1_set_item(EVP_PKEY_ASN1_METHOD *ameth, + int (*item_verify) (EVP_MD_CTX *ctx, + const ASN1_ITEM *it, + void *asn, + X509_ALGOR *a, + ASN1_BIT_STRING *sig, + EVP_PKEY *pkey), + int (*item_sign) (EVP_MD_CTX *ctx, + const ASN1_ITEM *it, + void *asn, + X509_ALGOR *alg1, + X509_ALGOR *alg2, + ASN1_BIT_STRING *sig)); + +void EVP_PKEY_asn1_set_siginf(EVP_PKEY_ASN1_METHOD *ameth, + int (*siginf_set) (X509_SIG_INFO *siginf, + const X509_ALGOR *alg, + const ASN1_STRING *sig)); + +void EVP_PKEY_asn1_set_check(EVP_PKEY_ASN1_METHOD *ameth, + int (*pkey_check) (const EVP_PKEY *pk)); + +void EVP_PKEY_asn1_set_public_check(EVP_PKEY_ASN1_METHOD *ameth, + int (*pkey_pub_check) (const EVP_PKEY *pk)); + +void EVP_PKEY_asn1_set_param_check(EVP_PKEY_ASN1_METHOD *ameth, + int (*pkey_param_check) (const EVP_PKEY *pk)); + +void EVP_PKEY_asn1_set_set_priv_key(EVP_PKEY_ASN1_METHOD *ameth, + int (*set_priv_key) (EVP_PKEY *pk, + const unsigned char + *priv, + size_t len)); +void EVP_PKEY_asn1_set_set_pub_key(EVP_PKEY_ASN1_METHOD *ameth, + int (*set_pub_key) (EVP_PKEY *pk, + const unsigned char *pub, + size_t len)); +void EVP_PKEY_asn1_set_get_priv_key(EVP_PKEY_ASN1_METHOD *ameth, + int (*get_priv_key) (const EVP_PKEY *pk, + unsigned char *priv, + size_t *len)); +void EVP_PKEY_asn1_set_get_pub_key(EVP_PKEY_ASN1_METHOD *ameth, + int (*get_pub_key) (const EVP_PKEY *pk, + unsigned char *pub, + size_t *len)); + +void EVP_PKEY_asn1_set_security_bits(EVP_PKEY_ASN1_METHOD *ameth, + int (*pkey_security_bits) (const EVP_PKEY + *pk)); + +# define EVP_PKEY_OP_UNDEFINED 0 +# define EVP_PKEY_OP_PARAMGEN (1<<1) +# define EVP_PKEY_OP_KEYGEN (1<<2) +# define EVP_PKEY_OP_SIGN (1<<3) +# define EVP_PKEY_OP_VERIFY (1<<4) +# define EVP_PKEY_OP_VERIFYRECOVER (1<<5) +# define EVP_PKEY_OP_SIGNCTX (1<<6) +# define EVP_PKEY_OP_VERIFYCTX (1<<7) +# define EVP_PKEY_OP_ENCRYPT (1<<8) +# define EVP_PKEY_OP_DECRYPT (1<<9) +# define EVP_PKEY_OP_DERIVE (1<<10) + +# define EVP_PKEY_OP_TYPE_SIG \ + (EVP_PKEY_OP_SIGN | EVP_PKEY_OP_VERIFY | EVP_PKEY_OP_VERIFYRECOVER \ + | EVP_PKEY_OP_SIGNCTX | EVP_PKEY_OP_VERIFYCTX) + +# define EVP_PKEY_OP_TYPE_CRYPT \ + (EVP_PKEY_OP_ENCRYPT | EVP_PKEY_OP_DECRYPT) + +# define EVP_PKEY_OP_TYPE_NOGEN \ + (EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT | EVP_PKEY_OP_DERIVE) + +# define EVP_PKEY_OP_TYPE_GEN \ + (EVP_PKEY_OP_PARAMGEN | EVP_PKEY_OP_KEYGEN) + +# define EVP_PKEY_CTX_set_signature_md(ctx, md) \ + EVP_PKEY_CTX_ctrl(ctx, -1, EVP_PKEY_OP_TYPE_SIG, \ + EVP_PKEY_CTRL_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_get_signature_md(ctx, pmd) \ + EVP_PKEY_CTX_ctrl(ctx, -1, EVP_PKEY_OP_TYPE_SIG, \ + EVP_PKEY_CTRL_GET_MD, 0, (void *)(pmd)) + +# define EVP_PKEY_CTX_set_mac_key(ctx, key, len) \ + EVP_PKEY_CTX_ctrl(ctx, -1, EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_SET_MAC_KEY, len, (void *)(key)) + +# define EVP_PKEY_CTRL_MD 1 +# define EVP_PKEY_CTRL_PEER_KEY 2 + +# define EVP_PKEY_CTRL_PKCS7_ENCRYPT 3 +# define EVP_PKEY_CTRL_PKCS7_DECRYPT 4 + +# define EVP_PKEY_CTRL_PKCS7_SIGN 5 + +# define EVP_PKEY_CTRL_SET_MAC_KEY 6 + +# define EVP_PKEY_CTRL_DIGESTINIT 7 + +/* Used by GOST key encryption in TLS */ +# define EVP_PKEY_CTRL_SET_IV 8 + +# define EVP_PKEY_CTRL_CMS_ENCRYPT 9 +# define EVP_PKEY_CTRL_CMS_DECRYPT 10 +# define EVP_PKEY_CTRL_CMS_SIGN 11 + +# define EVP_PKEY_CTRL_CIPHER 12 + +# define EVP_PKEY_CTRL_GET_MD 13 + +# define EVP_PKEY_CTRL_SET_DIGEST_SIZE 14 + +# define EVP_PKEY_ALG_CTRL 0x1000 + +# define EVP_PKEY_FLAG_AUTOARGLEN 2 +/* + * Method handles all operations: don't assume any digest related defaults. + */ +# define EVP_PKEY_FLAG_SIGCTX_CUSTOM 4 + +const EVP_PKEY_METHOD *EVP_PKEY_meth_find(int type); +EVP_PKEY_METHOD *EVP_PKEY_meth_new(int id, int flags); +void EVP_PKEY_meth_get0_info(int *ppkey_id, int *pflags, + const EVP_PKEY_METHOD *meth); +void EVP_PKEY_meth_copy(EVP_PKEY_METHOD *dst, const EVP_PKEY_METHOD *src); +void EVP_PKEY_meth_free(EVP_PKEY_METHOD *pmeth); +int EVP_PKEY_meth_add0(const EVP_PKEY_METHOD *pmeth); +int EVP_PKEY_meth_remove(const EVP_PKEY_METHOD *pmeth); +size_t EVP_PKEY_meth_get_count(void); +const EVP_PKEY_METHOD *EVP_PKEY_meth_get0(size_t idx); + +EVP_PKEY_CTX *EVP_PKEY_CTX_new(EVP_PKEY *pkey, ENGINE *e); +EVP_PKEY_CTX *EVP_PKEY_CTX_new_id(int id, ENGINE *e); +EVP_PKEY_CTX *EVP_PKEY_CTX_dup(EVP_PKEY_CTX *ctx); +void EVP_PKEY_CTX_free(EVP_PKEY_CTX *ctx); + +int EVP_PKEY_CTX_ctrl(EVP_PKEY_CTX *ctx, int keytype, int optype, + int cmd, int p1, void *p2); +int EVP_PKEY_CTX_ctrl_str(EVP_PKEY_CTX *ctx, const char *type, + const char *value); +int EVP_PKEY_CTX_ctrl_uint64(EVP_PKEY_CTX *ctx, int keytype, int optype, + int cmd, uint64_t value); + +int EVP_PKEY_CTX_str2ctrl(EVP_PKEY_CTX *ctx, int cmd, const char *str); +int EVP_PKEY_CTX_hex2ctrl(EVP_PKEY_CTX *ctx, int cmd, const char *hex); + +int EVP_PKEY_CTX_md(EVP_PKEY_CTX *ctx, int optype, int cmd, const char *md); + +int EVP_PKEY_CTX_get_operation(EVP_PKEY_CTX *ctx); +void EVP_PKEY_CTX_set0_keygen_info(EVP_PKEY_CTX *ctx, int *dat, int datlen); + +EVP_PKEY *EVP_PKEY_new_mac_key(int type, ENGINE *e, + const unsigned char *key, int keylen); +EVP_PKEY *EVP_PKEY_new_raw_private_key(int type, ENGINE *e, + const unsigned char *priv, + size_t len); +EVP_PKEY *EVP_PKEY_new_raw_public_key(int type, ENGINE *e, + const unsigned char *pub, + size_t len); +int EVP_PKEY_get_raw_private_key(const EVP_PKEY *pkey, unsigned char *priv, + size_t *len); +int EVP_PKEY_get_raw_public_key(const EVP_PKEY *pkey, unsigned char *pub, + size_t *len); + +EVP_PKEY *EVP_PKEY_new_CMAC_key(ENGINE *e, const unsigned char *priv, + size_t len, const EVP_CIPHER *cipher); + +void EVP_PKEY_CTX_set_data(EVP_PKEY_CTX *ctx, void *data); +void *EVP_PKEY_CTX_get_data(EVP_PKEY_CTX *ctx); +EVP_PKEY *EVP_PKEY_CTX_get0_pkey(EVP_PKEY_CTX *ctx); + +EVP_PKEY *EVP_PKEY_CTX_get0_peerkey(EVP_PKEY_CTX *ctx); + +void EVP_PKEY_CTX_set_app_data(EVP_PKEY_CTX *ctx, void *data); +void *EVP_PKEY_CTX_get_app_data(EVP_PKEY_CTX *ctx); + +int EVP_PKEY_sign_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_sign(EVP_PKEY_CTX *ctx, + unsigned char *sig, size_t *siglen, + const unsigned char *tbs, size_t tbslen); +int EVP_PKEY_verify_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_verify(EVP_PKEY_CTX *ctx, + const unsigned char *sig, size_t siglen, + const unsigned char *tbs, size_t tbslen); +int EVP_PKEY_verify_recover_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_verify_recover(EVP_PKEY_CTX *ctx, + unsigned char *rout, size_t *routlen, + const unsigned char *sig, size_t siglen); +int EVP_PKEY_encrypt_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_encrypt(EVP_PKEY_CTX *ctx, + unsigned char *out, size_t *outlen, + const unsigned char *in, size_t inlen); +int EVP_PKEY_decrypt_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_decrypt(EVP_PKEY_CTX *ctx, + unsigned char *out, size_t *outlen, + const unsigned char *in, size_t inlen); + +int EVP_PKEY_derive_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_derive_set_peer(EVP_PKEY_CTX *ctx, EVP_PKEY *peer); +int EVP_PKEY_derive(EVP_PKEY_CTX *ctx, unsigned char *key, size_t *keylen); + +typedef int EVP_PKEY_gen_cb(EVP_PKEY_CTX *ctx); + +int EVP_PKEY_paramgen_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_paramgen(EVP_PKEY_CTX *ctx, EVP_PKEY **ppkey); +int EVP_PKEY_keygen_init(EVP_PKEY_CTX *ctx); +int EVP_PKEY_keygen(EVP_PKEY_CTX *ctx, EVP_PKEY **ppkey); +int EVP_PKEY_check(EVP_PKEY_CTX *ctx); +int EVP_PKEY_public_check(EVP_PKEY_CTX *ctx); +int EVP_PKEY_param_check(EVP_PKEY_CTX *ctx); + +void EVP_PKEY_CTX_set_cb(EVP_PKEY_CTX *ctx, EVP_PKEY_gen_cb *cb); +EVP_PKEY_gen_cb *EVP_PKEY_CTX_get_cb(EVP_PKEY_CTX *ctx); + +int EVP_PKEY_CTX_get_keygen_info(EVP_PKEY_CTX *ctx, int idx); + +void EVP_PKEY_meth_set_init(EVP_PKEY_METHOD *pmeth, + int (*init) (EVP_PKEY_CTX *ctx)); + +void EVP_PKEY_meth_set_copy(EVP_PKEY_METHOD *pmeth, + int (*copy) (EVP_PKEY_CTX *dst, + EVP_PKEY_CTX *src)); + +void EVP_PKEY_meth_set_cleanup(EVP_PKEY_METHOD *pmeth, + void (*cleanup) (EVP_PKEY_CTX *ctx)); + +void EVP_PKEY_meth_set_paramgen(EVP_PKEY_METHOD *pmeth, + int (*paramgen_init) (EVP_PKEY_CTX *ctx), + int (*paramgen) (EVP_PKEY_CTX *ctx, + EVP_PKEY *pkey)); + +void EVP_PKEY_meth_set_keygen(EVP_PKEY_METHOD *pmeth, + int (*keygen_init) (EVP_PKEY_CTX *ctx), + int (*keygen) (EVP_PKEY_CTX *ctx, + EVP_PKEY *pkey)); + +void EVP_PKEY_meth_set_sign(EVP_PKEY_METHOD *pmeth, + int (*sign_init) (EVP_PKEY_CTX *ctx), + int (*sign) (EVP_PKEY_CTX *ctx, + unsigned char *sig, size_t *siglen, + const unsigned char *tbs, + size_t tbslen)); + +void EVP_PKEY_meth_set_verify(EVP_PKEY_METHOD *pmeth, + int (*verify_init) (EVP_PKEY_CTX *ctx), + int (*verify) (EVP_PKEY_CTX *ctx, + const unsigned char *sig, + size_t siglen, + const unsigned char *tbs, + size_t tbslen)); + +void EVP_PKEY_meth_set_verify_recover(EVP_PKEY_METHOD *pmeth, + int (*verify_recover_init) (EVP_PKEY_CTX + *ctx), + int (*verify_recover) (EVP_PKEY_CTX + *ctx, + unsigned char + *sig, + size_t *siglen, + const unsigned + char *tbs, + size_t tbslen)); + +void EVP_PKEY_meth_set_signctx(EVP_PKEY_METHOD *pmeth, + int (*signctx_init) (EVP_PKEY_CTX *ctx, + EVP_MD_CTX *mctx), + int (*signctx) (EVP_PKEY_CTX *ctx, + unsigned char *sig, + size_t *siglen, + EVP_MD_CTX *mctx)); + +void EVP_PKEY_meth_set_verifyctx(EVP_PKEY_METHOD *pmeth, + int (*verifyctx_init) (EVP_PKEY_CTX *ctx, + EVP_MD_CTX *mctx), + int (*verifyctx) (EVP_PKEY_CTX *ctx, + const unsigned char *sig, + int siglen, + EVP_MD_CTX *mctx)); + +void EVP_PKEY_meth_set_encrypt(EVP_PKEY_METHOD *pmeth, + int (*encrypt_init) (EVP_PKEY_CTX *ctx), + int (*encryptfn) (EVP_PKEY_CTX *ctx, + unsigned char *out, + size_t *outlen, + const unsigned char *in, + size_t inlen)); + +void EVP_PKEY_meth_set_decrypt(EVP_PKEY_METHOD *pmeth, + int (*decrypt_init) (EVP_PKEY_CTX *ctx), + int (*decrypt) (EVP_PKEY_CTX *ctx, + unsigned char *out, + size_t *outlen, + const unsigned char *in, + size_t inlen)); + +void EVP_PKEY_meth_set_derive(EVP_PKEY_METHOD *pmeth, + int (*derive_init) (EVP_PKEY_CTX *ctx), + int (*derive) (EVP_PKEY_CTX *ctx, + unsigned char *key, + size_t *keylen)); + +void EVP_PKEY_meth_set_ctrl(EVP_PKEY_METHOD *pmeth, + int (*ctrl) (EVP_PKEY_CTX *ctx, int type, int p1, + void *p2), + int (*ctrl_str) (EVP_PKEY_CTX *ctx, + const char *type, + const char *value)); + +void EVP_PKEY_meth_set_check(EVP_PKEY_METHOD *pmeth, + int (*check) (EVP_PKEY *pkey)); + +void EVP_PKEY_meth_set_public_check(EVP_PKEY_METHOD *pmeth, + int (*check) (EVP_PKEY *pkey)); + +void EVP_PKEY_meth_set_param_check(EVP_PKEY_METHOD *pmeth, + int (*check) (EVP_PKEY *pkey)); + +void EVP_PKEY_meth_set_digest_custom(EVP_PKEY_METHOD *pmeth, + int (*digest_custom) (EVP_PKEY_CTX *ctx, + EVP_MD_CTX *mctx)); + +void EVP_PKEY_meth_get_init(const EVP_PKEY_METHOD *pmeth, + int (**pinit) (EVP_PKEY_CTX *ctx)); + +void EVP_PKEY_meth_get_copy(const EVP_PKEY_METHOD *pmeth, + int (**pcopy) (EVP_PKEY_CTX *dst, + EVP_PKEY_CTX *src)); + +void EVP_PKEY_meth_get_cleanup(const EVP_PKEY_METHOD *pmeth, + void (**pcleanup) (EVP_PKEY_CTX *ctx)); + +void EVP_PKEY_meth_get_paramgen(const EVP_PKEY_METHOD *pmeth, + int (**pparamgen_init) (EVP_PKEY_CTX *ctx), + int (**pparamgen) (EVP_PKEY_CTX *ctx, + EVP_PKEY *pkey)); + +void EVP_PKEY_meth_get_keygen(const EVP_PKEY_METHOD *pmeth, + int (**pkeygen_init) (EVP_PKEY_CTX *ctx), + int (**pkeygen) (EVP_PKEY_CTX *ctx, + EVP_PKEY *pkey)); + +void EVP_PKEY_meth_get_sign(const EVP_PKEY_METHOD *pmeth, + int (**psign_init) (EVP_PKEY_CTX *ctx), + int (**psign) (EVP_PKEY_CTX *ctx, + unsigned char *sig, size_t *siglen, + const unsigned char *tbs, + size_t tbslen)); + +void EVP_PKEY_meth_get_verify(const EVP_PKEY_METHOD *pmeth, + int (**pverify_init) (EVP_PKEY_CTX *ctx), + int (**pverify) (EVP_PKEY_CTX *ctx, + const unsigned char *sig, + size_t siglen, + const unsigned char *tbs, + size_t tbslen)); + +void EVP_PKEY_meth_get_verify_recover(const EVP_PKEY_METHOD *pmeth, + int (**pverify_recover_init) (EVP_PKEY_CTX + *ctx), + int (**pverify_recover) (EVP_PKEY_CTX + *ctx, + unsigned char + *sig, + size_t *siglen, + const unsigned + char *tbs, + size_t tbslen)); + +void EVP_PKEY_meth_get_signctx(const EVP_PKEY_METHOD *pmeth, + int (**psignctx_init) (EVP_PKEY_CTX *ctx, + EVP_MD_CTX *mctx), + int (**psignctx) (EVP_PKEY_CTX *ctx, + unsigned char *sig, + size_t *siglen, + EVP_MD_CTX *mctx)); + +void EVP_PKEY_meth_get_verifyctx(const EVP_PKEY_METHOD *pmeth, + int (**pverifyctx_init) (EVP_PKEY_CTX *ctx, + EVP_MD_CTX *mctx), + int (**pverifyctx) (EVP_PKEY_CTX *ctx, + const unsigned char *sig, + int siglen, + EVP_MD_CTX *mctx)); + +void EVP_PKEY_meth_get_encrypt(const EVP_PKEY_METHOD *pmeth, + int (**pencrypt_init) (EVP_PKEY_CTX *ctx), + int (**pencryptfn) (EVP_PKEY_CTX *ctx, + unsigned char *out, + size_t *outlen, + const unsigned char *in, + size_t inlen)); + +void EVP_PKEY_meth_get_decrypt(const EVP_PKEY_METHOD *pmeth, + int (**pdecrypt_init) (EVP_PKEY_CTX *ctx), + int (**pdecrypt) (EVP_PKEY_CTX *ctx, + unsigned char *out, + size_t *outlen, + const unsigned char *in, + size_t inlen)); + +void EVP_PKEY_meth_get_derive(const EVP_PKEY_METHOD *pmeth, + int (**pderive_init) (EVP_PKEY_CTX *ctx), + int (**pderive) (EVP_PKEY_CTX *ctx, + unsigned char *key, + size_t *keylen)); + +void EVP_PKEY_meth_get_ctrl(const EVP_PKEY_METHOD *pmeth, + int (**pctrl) (EVP_PKEY_CTX *ctx, int type, int p1, + void *p2), + int (**pctrl_str) (EVP_PKEY_CTX *ctx, + const char *type, + const char *value)); + +void EVP_PKEY_meth_get_check(const EVP_PKEY_METHOD *pmeth, + int (**pcheck) (EVP_PKEY *pkey)); + +void EVP_PKEY_meth_get_public_check(const EVP_PKEY_METHOD *pmeth, + int (**pcheck) (EVP_PKEY *pkey)); + +void EVP_PKEY_meth_get_param_check(const EVP_PKEY_METHOD *pmeth, + int (**pcheck) (EVP_PKEY *pkey)); + +void EVP_PKEY_meth_get_digest_custom(EVP_PKEY_METHOD *pmeth, + int (**pdigest_custom) (EVP_PKEY_CTX *ctx, + EVP_MD_CTX *mctx)); +void EVP_add_alg_module(void); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/evperr.h b/include/openssl/evperr.h new file mode 100644 index 0000000..3484fa8 --- /dev/null +++ b/include/openssl/evperr.h @@ -0,0 +1,193 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_EVPERR_H +# define HEADER_EVPERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_EVP_strings(void); + +/* + * EVP function codes. + */ +# define EVP_F_AESNI_INIT_KEY 165 +# define EVP_F_AES_GCM_CTRL 196 +# define EVP_F_AES_INIT_KEY 133 +# define EVP_F_AES_OCB_CIPHER 169 +# define EVP_F_AES_T4_INIT_KEY 178 +# define EVP_F_AES_WRAP_CIPHER 170 +# define EVP_F_ALG_MODULE_INIT 177 +# define EVP_F_ARIA_CCM_INIT_KEY 175 +# define EVP_F_ARIA_GCM_CTRL 197 +# define EVP_F_ARIA_GCM_INIT_KEY 176 +# define EVP_F_ARIA_INIT_KEY 185 +# define EVP_F_B64_NEW 198 +# define EVP_F_CAMELLIA_INIT_KEY 159 +# define EVP_F_CHACHA20_POLY1305_CTRL 182 +# define EVP_F_CMLL_T4_INIT_KEY 179 +# define EVP_F_DES_EDE3_WRAP_CIPHER 171 +# define EVP_F_DO_SIGVER_INIT 161 +# define EVP_F_ENC_NEW 199 +# define EVP_F_EVP_CIPHERINIT_EX 123 +# define EVP_F_EVP_CIPHER_ASN1_TO_PARAM 204 +# define EVP_F_EVP_CIPHER_CTX_COPY 163 +# define EVP_F_EVP_CIPHER_CTX_CTRL 124 +# define EVP_F_EVP_CIPHER_CTX_SET_KEY_LENGTH 122 +# define EVP_F_EVP_CIPHER_PARAM_TO_ASN1 205 +# define EVP_F_EVP_DECRYPTFINAL_EX 101 +# define EVP_F_EVP_DECRYPTUPDATE 166 +# define EVP_F_EVP_DIGESTFINALXOF 174 +# define EVP_F_EVP_DIGESTINIT_EX 128 +# define EVP_F_EVP_ENCRYPTFINAL_EX 127 +# define EVP_F_EVP_ENCRYPTUPDATE 167 +# define EVP_F_EVP_MD_CTX_COPY_EX 110 +# define EVP_F_EVP_MD_SIZE 162 +# define EVP_F_EVP_OPENINIT 102 +# define EVP_F_EVP_PBE_ALG_ADD 115 +# define EVP_F_EVP_PBE_ALG_ADD_TYPE 160 +# define EVP_F_EVP_PBE_CIPHERINIT 116 +# define EVP_F_EVP_PBE_SCRYPT 181 +# define EVP_F_EVP_PKCS82PKEY 111 +# define EVP_F_EVP_PKEY2PKCS8 113 +# define EVP_F_EVP_PKEY_ASN1_ADD0 188 +# define EVP_F_EVP_PKEY_CHECK 186 +# define EVP_F_EVP_PKEY_COPY_PARAMETERS 103 +# define EVP_F_EVP_PKEY_CTX_CTRL 137 +# define EVP_F_EVP_PKEY_CTX_CTRL_STR 150 +# define EVP_F_EVP_PKEY_CTX_DUP 156 +# define EVP_F_EVP_PKEY_CTX_MD 168 +# define EVP_F_EVP_PKEY_DECRYPT 104 +# define EVP_F_EVP_PKEY_DECRYPT_INIT 138 +# define EVP_F_EVP_PKEY_DECRYPT_OLD 151 +# define EVP_F_EVP_PKEY_DERIVE 153 +# define EVP_F_EVP_PKEY_DERIVE_INIT 154 +# define EVP_F_EVP_PKEY_DERIVE_SET_PEER 155 +# define EVP_F_EVP_PKEY_ENCRYPT 105 +# define EVP_F_EVP_PKEY_ENCRYPT_INIT 139 +# define EVP_F_EVP_PKEY_ENCRYPT_OLD 152 +# define EVP_F_EVP_PKEY_GET0_DH 119 +# define EVP_F_EVP_PKEY_GET0_DSA 120 +# define EVP_F_EVP_PKEY_GET0_EC_KEY 131 +# define EVP_F_EVP_PKEY_GET0_HMAC 183 +# define EVP_F_EVP_PKEY_GET0_POLY1305 184 +# define EVP_F_EVP_PKEY_GET0_RSA 121 +# define EVP_F_EVP_PKEY_GET0_SIPHASH 172 +# define EVP_F_EVP_PKEY_GET_RAW_PRIVATE_KEY 202 +# define EVP_F_EVP_PKEY_GET_RAW_PUBLIC_KEY 203 +# define EVP_F_EVP_PKEY_KEYGEN 146 +# define EVP_F_EVP_PKEY_KEYGEN_INIT 147 +# define EVP_F_EVP_PKEY_METH_ADD0 194 +# define EVP_F_EVP_PKEY_METH_NEW 195 +# define EVP_F_EVP_PKEY_NEW 106 +# define EVP_F_EVP_PKEY_NEW_CMAC_KEY 193 +# define EVP_F_EVP_PKEY_NEW_RAW_PRIVATE_KEY 191 +# define EVP_F_EVP_PKEY_NEW_RAW_PUBLIC_KEY 192 +# define EVP_F_EVP_PKEY_PARAMGEN 148 +# define EVP_F_EVP_PKEY_PARAMGEN_INIT 149 +# define EVP_F_EVP_PKEY_PARAM_CHECK 189 +# define EVP_F_EVP_PKEY_PUBLIC_CHECK 190 +# define EVP_F_EVP_PKEY_SET1_ENGINE 187 +# define EVP_F_EVP_PKEY_SET_ALIAS_TYPE 206 +# define EVP_F_EVP_PKEY_SIGN 140 +# define EVP_F_EVP_PKEY_SIGN_INIT 141 +# define EVP_F_EVP_PKEY_VERIFY 142 +# define EVP_F_EVP_PKEY_VERIFY_INIT 143 +# define EVP_F_EVP_PKEY_VERIFY_RECOVER 144 +# define EVP_F_EVP_PKEY_VERIFY_RECOVER_INIT 145 +# define EVP_F_EVP_SIGNFINAL 107 +# define EVP_F_EVP_VERIFYFINAL 108 +# define EVP_F_INT_CTX_NEW 157 +# define EVP_F_OK_NEW 200 +# define EVP_F_PKCS5_PBE_KEYIVGEN 117 +# define EVP_F_PKCS5_V2_PBE_KEYIVGEN 118 +# define EVP_F_PKCS5_V2_PBKDF2_KEYIVGEN 164 +# define EVP_F_PKCS5_V2_SCRYPT_KEYIVGEN 180 +# define EVP_F_PKEY_SET_TYPE 158 +# define EVP_F_RC2_MAGIC_TO_METH 109 +# define EVP_F_RC5_CTRL 125 +# define EVP_F_S390X_AES_GCM_CTRL 201 +# define EVP_F_UPDATE 173 + +/* + * EVP reason codes. + */ +# define EVP_R_AES_KEY_SETUP_FAILED 143 +# define EVP_R_ARIA_KEY_SETUP_FAILED 176 +# define EVP_R_BAD_DECRYPT 100 +# define EVP_R_BUFFER_TOO_SMALL 155 +# define EVP_R_CAMELLIA_KEY_SETUP_FAILED 157 +# define EVP_R_CIPHER_PARAMETER_ERROR 122 +# define EVP_R_COMMAND_NOT_SUPPORTED 147 +# define EVP_R_COPY_ERROR 173 +# define EVP_R_CTRL_NOT_IMPLEMENTED 132 +# define EVP_R_CTRL_OPERATION_NOT_IMPLEMENTED 133 +# define EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH 138 +# define EVP_R_DECODE_ERROR 114 +# define EVP_R_DIFFERENT_KEY_TYPES 101 +# define EVP_R_DIFFERENT_PARAMETERS 153 +# define EVP_R_ERROR_LOADING_SECTION 165 +# define EVP_R_ERROR_SETTING_FIPS_MODE 166 +# define EVP_R_EXPECTING_AN_HMAC_KEY 174 +# define EVP_R_EXPECTING_AN_RSA_KEY 127 +# define EVP_R_EXPECTING_A_DH_KEY 128 +# define EVP_R_EXPECTING_A_DSA_KEY 129 +# define EVP_R_EXPECTING_A_EC_KEY 142 +# define EVP_R_EXPECTING_A_POLY1305_KEY 164 +# define EVP_R_EXPECTING_A_SIPHASH_KEY 175 +# define EVP_R_FIPS_MODE_NOT_SUPPORTED 167 +# define EVP_R_GET_RAW_KEY_FAILED 182 +# define EVP_R_ILLEGAL_SCRYPT_PARAMETERS 171 +# define EVP_R_INITIALIZATION_ERROR 134 +# define EVP_R_INPUT_NOT_INITIALIZED 111 +# define EVP_R_INVALID_DIGEST 152 +# define EVP_R_INVALID_FIPS_MODE 168 +# define EVP_R_INVALID_KEY 163 +# define EVP_R_INVALID_KEY_LENGTH 130 +# define EVP_R_INVALID_OPERATION 148 +# define EVP_R_KEYGEN_FAILURE 120 +# define EVP_R_KEY_SETUP_FAILED 180 +# define EVP_R_MEMORY_LIMIT_EXCEEDED 172 +# define EVP_R_MESSAGE_DIGEST_IS_NULL 159 +# define EVP_R_METHOD_NOT_SUPPORTED 144 +# define EVP_R_MISSING_PARAMETERS 103 +# define EVP_R_NOT_XOF_OR_INVALID_LENGTH 178 +# define EVP_R_NO_CIPHER_SET 131 +# define EVP_R_NO_DEFAULT_DIGEST 158 +# define EVP_R_NO_DIGEST_SET 139 +# define EVP_R_NO_KEY_SET 154 +# define EVP_R_NO_OPERATION_SET 149 +# define EVP_R_ONLY_ONESHOT_SUPPORTED 177 +# define EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE 150 +# define EVP_R_OPERATON_NOT_INITIALIZED 151 +# define EVP_R_PARTIALLY_OVERLAPPING 162 +# define EVP_R_PBKDF2_ERROR 181 +# define EVP_R_PKEY_APPLICATION_ASN1_METHOD_ALREADY_REGISTERED 179 +# define EVP_R_PRIVATE_KEY_DECODE_ERROR 145 +# define EVP_R_PRIVATE_KEY_ENCODE_ERROR 146 +# define EVP_R_PUBLIC_KEY_NOT_RSA 106 +# define EVP_R_UNKNOWN_CIPHER 160 +# define EVP_R_UNKNOWN_DIGEST 161 +# define EVP_R_UNKNOWN_OPTION 169 +# define EVP_R_UNKNOWN_PBE_ALGORITHM 121 +# define EVP_R_UNSUPPORTED_ALGORITHM 156 +# define EVP_R_UNSUPPORTED_CIPHER 107 +# define EVP_R_UNSUPPORTED_KEYLENGTH 123 +# define EVP_R_UNSUPPORTED_KEY_DERIVATION_FUNCTION 124 +# define EVP_R_UNSUPPORTED_KEY_SIZE 108 +# define EVP_R_UNSUPPORTED_NUMBER_OF_ROUNDS 135 +# define EVP_R_UNSUPPORTED_PRF 125 +# define EVP_R_UNSUPPORTED_PRIVATE_KEY_ALGORITHM 118 +# define EVP_R_UNSUPPORTED_SALT_TYPE 126 +# define EVP_R_WRAP_MODE_NOT_ALLOWED 170 +# define EVP_R_WRONG_FINAL_BLOCK_LENGTH 109 + +#endif diff --git a/include/openssl/hmac.h b/include/openssl/hmac.h new file mode 100644 index 0000000..6a5df31 --- /dev/null +++ b/include/openssl/hmac.h @@ -0,0 +1,51 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_HMAC_H +# define HEADER_HMAC_H + +# include + +# include + +# if OPENSSL_API_COMPAT < 0x10200000L +# define HMAC_MAX_MD_CBLOCK 128 /* Deprecated */ +# endif + +#ifdef __cplusplus +extern "C" { +#endif + +size_t HMAC_size(const HMAC_CTX *e); +HMAC_CTX *HMAC_CTX_new(void); +int HMAC_CTX_reset(HMAC_CTX *ctx); +void HMAC_CTX_free(HMAC_CTX *ctx); + +DEPRECATEDIN_1_1_0(__owur int HMAC_Init(HMAC_CTX *ctx, const void *key, int len, + const EVP_MD *md)) + +/*__owur*/ int HMAC_Init_ex(HMAC_CTX *ctx, const void *key, int len, + const EVP_MD *md, ENGINE *impl); +/*__owur*/ int HMAC_Update(HMAC_CTX *ctx, const unsigned char *data, + size_t len); +/*__owur*/ int HMAC_Final(HMAC_CTX *ctx, unsigned char *md, + unsigned int *len); +unsigned char *HMAC(const EVP_MD *evp_md, const void *key, int key_len, + const unsigned char *d, size_t n, unsigned char *md, + unsigned int *md_len); +__owur int HMAC_CTX_copy(HMAC_CTX *dctx, HMAC_CTX *sctx); + +void HMAC_CTX_set_flags(HMAC_CTX *ctx, unsigned long flags); +const EVP_MD *HMAC_CTX_get_md(const HMAC_CTX *ctx); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/idea.h b/include/openssl/idea.h new file mode 100644 index 0000000..2f58933 --- /dev/null +++ b/include/openssl/idea.h @@ -0,0 +1,64 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_IDEA_H +# define HEADER_IDEA_H + +# include + +# ifndef OPENSSL_NO_IDEA +# ifdef __cplusplus +extern "C" { +# endif + +typedef unsigned int IDEA_INT; + +# define IDEA_ENCRYPT 1 +# define IDEA_DECRYPT 0 + +# define IDEA_BLOCK 8 +# define IDEA_KEY_LENGTH 16 + +typedef struct idea_key_st { + IDEA_INT data[9][6]; +} IDEA_KEY_SCHEDULE; + +const char *IDEA_options(void); +void IDEA_ecb_encrypt(const unsigned char *in, unsigned char *out, + IDEA_KEY_SCHEDULE *ks); +void IDEA_set_encrypt_key(const unsigned char *key, IDEA_KEY_SCHEDULE *ks); +void IDEA_set_decrypt_key(IDEA_KEY_SCHEDULE *ek, IDEA_KEY_SCHEDULE *dk); +void IDEA_cbc_encrypt(const unsigned char *in, unsigned char *out, + long length, IDEA_KEY_SCHEDULE *ks, unsigned char *iv, + int enc); +void IDEA_cfb64_encrypt(const unsigned char *in, unsigned char *out, + long length, IDEA_KEY_SCHEDULE *ks, unsigned char *iv, + int *num, int enc); +void IDEA_ofb64_encrypt(const unsigned char *in, unsigned char *out, + long length, IDEA_KEY_SCHEDULE *ks, unsigned char *iv, + int *num); +void IDEA_encrypt(unsigned long *in, IDEA_KEY_SCHEDULE *ks); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define idea_options IDEA_options +# define idea_ecb_encrypt IDEA_ecb_encrypt +# define idea_set_encrypt_key IDEA_set_encrypt_key +# define idea_set_decrypt_key IDEA_set_decrypt_key +# define idea_cbc_encrypt IDEA_cbc_encrypt +# define idea_cfb64_encrypt IDEA_cfb64_encrypt +# define idea_ofb64_encrypt IDEA_ofb64_encrypt +# define idea_encrypt IDEA_encrypt +# endif + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/internal/__DECC_INCLUDE_EPILOGUE.H b/include/openssl/internal/__DECC_INCLUDE_EPILOGUE.H new file mode 100644 index 0000000..c350018 --- /dev/null +++ b/include/openssl/internal/__DECC_INCLUDE_EPILOGUE.H @@ -0,0 +1,16 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This file is only used by HP C on VMS, and is included automatically + * after each header file from this directory + */ + +/* restore state. Must correspond to the save in __decc_include_prologue.h */ +#pragma names restore diff --git a/include/openssl/internal/__DECC_INCLUDE_PROLOGUE.H b/include/openssl/internal/__DECC_INCLUDE_PROLOGUE.H new file mode 100644 index 0000000..9a9c777 --- /dev/null +++ b/include/openssl/internal/__DECC_INCLUDE_PROLOGUE.H @@ -0,0 +1,20 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This file is only used by HP C on VMS, and is included automatically + * after each header file from this directory + */ + +/* save state */ +#pragma names save +/* have the compiler shorten symbols larger than 31 chars to 23 chars + * followed by a 8 hex char CRC + */ +#pragma names as_is,shortened diff --git a/include/openssl/internal/bio.h b/include/openssl/internal/bio.h new file mode 100644 index 0000000..ac529f0 --- /dev/null +++ b/include/openssl/internal/bio.h @@ -0,0 +1,33 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +struct bio_method_st { + int type; + char *name; + int (*bwrite) (BIO *, const char *, size_t, size_t *); + int (*bwrite_old) (BIO *, const char *, int); + int (*bread) (BIO *, char *, size_t, size_t *); + int (*bread_old) (BIO *, char *, int); + int (*bputs) (BIO *, const char *); + int (*bgets) (BIO *, char *, int); + long (*ctrl) (BIO *, int, long, void *); + int (*create) (BIO *); + int (*destroy) (BIO *); + long (*callback_ctrl) (BIO *, int, BIO_info_cb *); +}; + +void bio_free_ex_data(BIO *bio); +void bio_cleanup(void); + + +/* Old style to new style BIO_METHOD conversion functions */ +int bwrite_conv(BIO *bio, const char *data, size_t datal, size_t *written); +int bread_conv(BIO *bio, char *data, size_t datal, size_t *read); diff --git a/include/openssl/internal/comp.h b/include/openssl/internal/comp.h new file mode 100644 index 0000000..890af11 --- /dev/null +++ b/include/openssl/internal/comp.h @@ -0,0 +1,12 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +void comp_zlib_cleanup_int(void); diff --git a/include/openssl/internal/conf.h b/include/openssl/internal/conf.h new file mode 100644 index 0000000..4cb9d30 --- /dev/null +++ b/include/openssl/internal/conf.h @@ -0,0 +1,23 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_INTERNAL_CONF_H +# define HEADER_INTERNAL_CONF_H + +#include + +struct ossl_init_settings_st { + char *appname; +}; + +void openssl_config_int(const char *appname); +void openssl_no_config_int(void); +void conf_modules_free_int(void); + +#endif diff --git a/include/openssl/internal/constant_time_locl.h b/include/openssl/internal/constant_time_locl.h new file mode 100644 index 0000000..5794969 --- /dev/null +++ b/include/openssl/internal/constant_time_locl.h @@ -0,0 +1,327 @@ +/* + * Copyright 2014-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CONSTANT_TIME_LOCL_H +# define HEADER_CONSTANT_TIME_LOCL_H + +# include +# include +# include /* For 'ossl_inline' */ + +/*- + * The boolean methods return a bitmask of all ones (0xff...f) for true + * and 0 for false. This is useful for choosing a value based on the result + * of a conditional in constant time. For example, + * if (a < b) { + * c = a; + * } else { + * c = b; + * } + * can be written as + * unsigned int lt = constant_time_lt(a, b); + * c = constant_time_select(lt, a, b); + */ + +/* Returns the given value with the MSB copied to all the other bits. */ +static ossl_inline unsigned int constant_time_msb(unsigned int a); +/* Convenience method for uint32_t. */ +static ossl_inline uint32_t constant_time_msb_32(uint32_t a); +/* Convenience method for uint64_t. */ +static ossl_inline uint64_t constant_time_msb_64(uint64_t a); + +/* Returns 0xff..f if a < b and 0 otherwise. */ +static ossl_inline unsigned int constant_time_lt(unsigned int a, + unsigned int b); +/* Convenience method for getting an 8-bit mask. */ +static ossl_inline unsigned char constant_time_lt_8(unsigned int a, + unsigned int b); +/* Convenience method for uint64_t. */ +static ossl_inline uint64_t constant_time_lt_64(uint64_t a, uint64_t b); + +/* Returns 0xff..f if a >= b and 0 otherwise. */ +static ossl_inline unsigned int constant_time_ge(unsigned int a, + unsigned int b); +/* Convenience method for getting an 8-bit mask. */ +static ossl_inline unsigned char constant_time_ge_8(unsigned int a, + unsigned int b); + +/* Returns 0xff..f if a == 0 and 0 otherwise. */ +static ossl_inline unsigned int constant_time_is_zero(unsigned int a); +/* Convenience method for getting an 8-bit mask. */ +static ossl_inline unsigned char constant_time_is_zero_8(unsigned int a); +/* Convenience method for getting a 32-bit mask. */ +static ossl_inline uint32_t constant_time_is_zero_32(uint32_t a); + +/* Returns 0xff..f if a == b and 0 otherwise. */ +static ossl_inline unsigned int constant_time_eq(unsigned int a, + unsigned int b); +/* Convenience method for getting an 8-bit mask. */ +static ossl_inline unsigned char constant_time_eq_8(unsigned int a, + unsigned int b); +/* Signed integers. */ +static ossl_inline unsigned int constant_time_eq_int(int a, int b); +/* Convenience method for getting an 8-bit mask. */ +static ossl_inline unsigned char constant_time_eq_int_8(int a, int b); + +/*- + * Returns (mask & a) | (~mask & b). + * + * When |mask| is all 1s or all 0s (as returned by the methods above), + * the select methods return either |a| (if |mask| is nonzero) or |b| + * (if |mask| is zero). + */ +static ossl_inline unsigned int constant_time_select(unsigned int mask, + unsigned int a, + unsigned int b); +/* Convenience method for unsigned chars. */ +static ossl_inline unsigned char constant_time_select_8(unsigned char mask, + unsigned char a, + unsigned char b); + +/* Convenience method for uint32_t. */ +static ossl_inline uint32_t constant_time_select_32(uint32_t mask, uint32_t a, + uint32_t b); + +/* Convenience method for uint64_t. */ +static ossl_inline uint64_t constant_time_select_64(uint64_t mask, uint64_t a, + uint64_t b); +/* Convenience method for signed integers. */ +static ossl_inline int constant_time_select_int(unsigned int mask, int a, + int b); + + +static ossl_inline unsigned int constant_time_msb(unsigned int a) +{ + return 0 - (a >> (sizeof(a) * 8 - 1)); +} + + +static ossl_inline uint32_t constant_time_msb_32(uint32_t a) +{ + return 0 - (a >> 31); +} + +static ossl_inline uint64_t constant_time_msb_64(uint64_t a) +{ + return 0 - (a >> 63); +} + +static ossl_inline size_t constant_time_msb_s(size_t a) +{ + return 0 - (a >> (sizeof(a) * 8 - 1)); +} + +static ossl_inline unsigned int constant_time_lt(unsigned int a, + unsigned int b) +{ + return constant_time_msb(a ^ ((a ^ b) | ((a - b) ^ b))); +} + +static ossl_inline size_t constant_time_lt_s(size_t a, size_t b) +{ + return constant_time_msb_s(a ^ ((a ^ b) | ((a - b) ^ b))); +} + +static ossl_inline unsigned char constant_time_lt_8(unsigned int a, + unsigned int b) +{ + return (unsigned char)constant_time_lt(a, b); +} + +static ossl_inline uint64_t constant_time_lt_64(uint64_t a, uint64_t b) +{ + return constant_time_msb_64(a ^ ((a ^ b) | ((a - b) ^ b))); +} + +static ossl_inline unsigned int constant_time_ge(unsigned int a, + unsigned int b) +{ + return ~constant_time_lt(a, b); +} + +static ossl_inline size_t constant_time_ge_s(size_t a, size_t b) +{ + return ~constant_time_lt_s(a, b); +} + +static ossl_inline unsigned char constant_time_ge_8(unsigned int a, + unsigned int b) +{ + return (unsigned char)constant_time_ge(a, b); +} + +static ossl_inline unsigned char constant_time_ge_8_s(size_t a, size_t b) +{ + return (unsigned char)constant_time_ge_s(a, b); +} + +static ossl_inline unsigned int constant_time_is_zero(unsigned int a) +{ + return constant_time_msb(~a & (a - 1)); +} + +static ossl_inline size_t constant_time_is_zero_s(size_t a) +{ + return constant_time_msb_s(~a & (a - 1)); +} + +static ossl_inline unsigned char constant_time_is_zero_8(unsigned int a) +{ + return (unsigned char)constant_time_is_zero(a); +} + +static ossl_inline uint32_t constant_time_is_zero_32(uint32_t a) +{ + return constant_time_msb_32(~a & (a - 1)); +} + +static ossl_inline unsigned int constant_time_eq(unsigned int a, + unsigned int b) +{ + return constant_time_is_zero(a ^ b); +} + +static ossl_inline size_t constant_time_eq_s(size_t a, size_t b) +{ + return constant_time_is_zero_s(a ^ b); +} + +static ossl_inline unsigned char constant_time_eq_8(unsigned int a, + unsigned int b) +{ + return (unsigned char)constant_time_eq(a, b); +} + +static ossl_inline unsigned char constant_time_eq_8_s(size_t a, size_t b) +{ + return (unsigned char)constant_time_eq_s(a, b); +} + +static ossl_inline unsigned int constant_time_eq_int(int a, int b) +{ + return constant_time_eq((unsigned)(a), (unsigned)(b)); +} + +static ossl_inline unsigned char constant_time_eq_int_8(int a, int b) +{ + return constant_time_eq_8((unsigned)(a), (unsigned)(b)); +} + +static ossl_inline unsigned int constant_time_select(unsigned int mask, + unsigned int a, + unsigned int b) +{ + return (mask & a) | (~mask & b); +} + +static ossl_inline size_t constant_time_select_s(size_t mask, + size_t a, + size_t b) +{ + return (mask & a) | (~mask & b); +} + +static ossl_inline unsigned char constant_time_select_8(unsigned char mask, + unsigned char a, + unsigned char b) +{ + return (unsigned char)constant_time_select(mask, a, b); +} + +static ossl_inline int constant_time_select_int(unsigned int mask, int a, + int b) +{ + return (int)constant_time_select(mask, (unsigned)(a), (unsigned)(b)); +} + +static ossl_inline int constant_time_select_int_s(size_t mask, int a, int b) +{ + return (int)constant_time_select((unsigned)mask, (unsigned)(a), + (unsigned)(b)); +} + +static ossl_inline uint32_t constant_time_select_32(uint32_t mask, uint32_t a, + uint32_t b) +{ + return (mask & a) | (~mask & b); +} + +static ossl_inline uint64_t constant_time_select_64(uint64_t mask, uint64_t a, + uint64_t b) +{ + return (mask & a) | (~mask & b); +} + +/* + * mask must be 0xFFFFFFFF or 0x00000000. + * + * if (mask) { + * uint32_t tmp = *a; + * + * *a = *b; + * *b = tmp; + * } + */ +static ossl_inline void constant_time_cond_swap_32(uint32_t mask, uint32_t *a, + uint32_t *b) +{ + uint32_t xor = *a ^ *b; + + xor &= mask; + *a ^= xor; + *b ^= xor; +} + +/* + * mask must be 0xFFFFFFFF or 0x00000000. + * + * if (mask) { + * uint64_t tmp = *a; + * + * *a = *b; + * *b = tmp; + * } + */ +static ossl_inline void constant_time_cond_swap_64(uint64_t mask, uint64_t *a, + uint64_t *b) +{ + uint64_t xor = *a ^ *b; + + xor &= mask; + *a ^= xor; + *b ^= xor; +} + +/* + * table is a two dimensional array of bytes. Each row has rowsize elements. + * Copies row number idx into out. rowsize and numrows are not considered + * private. + */ +static ossl_inline void constant_time_lookup(void *out, + const void *table, + size_t rowsize, + size_t numrows, + size_t idx) +{ + size_t i, j; + const unsigned char *tablec = (const unsigned char *)table; + unsigned char *outc = (unsigned char *)out; + unsigned char mask; + + memset(out, 0, rowsize); + + /* Note idx may underflow - but that is well defined */ + for (i = 0; i < numrows; i++, idx--) { + mask = (unsigned char)constant_time_is_zero_s(idx); + for (j = 0; j < rowsize; j++) + *(outc + j) |= constant_time_select_8(mask, *(tablec++), 0); + } +} + +#endif /* HEADER_CONSTANT_TIME_LOCL_H */ diff --git a/include/openssl/internal/cryptlib.h b/include/openssl/internal/cryptlib.h new file mode 100644 index 0000000..87592a7 --- /dev/null +++ b/include/openssl/internal/cryptlib.h @@ -0,0 +1,94 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_CRYPTLIB_H +# define HEADER_CRYPTLIB_H + +# include +# include + +# ifdef OPENSSL_USE_APPLINK +# undef BIO_FLAGS_UPLINK +# define BIO_FLAGS_UPLINK 0x8000 +# include "ms/uplink.h" +# endif + +# include +# include +# include +# include +# include "internal/nelem.h" + +#ifdef NDEBUG +# define ossl_assert(x) ((x) != 0) +#else +__owur static ossl_inline int ossl_assert_int(int expr, const char *exprstr, + const char *file, int line) +{ + if (!expr) + OPENSSL_die(exprstr, file, line); + + return expr; +} + +# define ossl_assert(x) ossl_assert_int((x) != 0, "Assertion failed: "#x, \ + __FILE__, __LINE__) + +#endif + +typedef struct ex_callback_st EX_CALLBACK; + +DEFINE_STACK_OF(EX_CALLBACK) + +typedef struct app_mem_info_st APP_INFO; + +typedef struct mem_st MEM; +DEFINE_LHASH_OF(MEM); + +# define OPENSSL_CONF "openssl.cnf" + +# ifndef OPENSSL_SYS_VMS +# define X509_CERT_AREA OPENSSLDIR +# define X509_CERT_DIR OPENSSLDIR "/certs" +# define X509_CERT_FILE OPENSSLDIR "/cert.pem" +# define X509_PRIVATE_DIR OPENSSLDIR "/private" +# define CTLOG_FILE OPENSSLDIR "/ct_log_list.cnf" +# else +# define X509_CERT_AREA "OSSL$DATAROOT:[000000]" +# define X509_CERT_DIR "OSSL$DATAROOT:[CERTS]" +# define X509_CERT_FILE "OSSL$DATAROOT:[000000]cert.pem" +# define X509_PRIVATE_DIR "OSSL$DATAROOT:[PRIVATE]" +# define CTLOG_FILE "OSSL$DATAROOT:[000000]ct_log_list.cnf" +# endif + +# define X509_CERT_DIR_EVP "SSL_CERT_DIR" +# define X509_CERT_FILE_EVP "SSL_CERT_FILE" +# define CTLOG_FILE_EVP "CTLOG_FILE" + +/* size of string representations */ +# define DECIMAL_SIZE(type) ((sizeof(type)*8+2)/3+1) +# define HEX_SIZE(type) (sizeof(type)*2) + +void OPENSSL_cpuid_setup(void); +extern unsigned int OPENSSL_ia32cap_P[]; +void OPENSSL_showfatal(const char *fmta, ...); +void crypto_cleanup_all_ex_data_int(void); +int openssl_init_fork_handlers(void); + +extern CRYPTO_RWLOCK *memdbg_lock; +int openssl_strerror_r(int errnum, char *buf, size_t buflen); +# if !defined(OPENSSL_NO_STDIO) +FILE *openssl_fopen(const char *filename, const char *mode); +# else +void *openssl_fopen(const char *filename, const char *mode); +# endif + +uint32_t OPENSSL_rdtsc(void); + +#endif diff --git a/include/openssl/internal/dane.h b/include/openssl/internal/dane.h new file mode 100644 index 0000000..c4a6b62 --- /dev/null +++ b/include/openssl/internal/dane.h @@ -0,0 +1,103 @@ +/* + * Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_INTERNAL_DANE_H +#define HEADER_INTERNAL_DANE_H + +#include + +/*- + * Certificate usages: + * https://tools.ietf.org/html/rfc6698#section-2.1.1 + */ +#define DANETLS_USAGE_PKIX_TA 0 +#define DANETLS_USAGE_PKIX_EE 1 +#define DANETLS_USAGE_DANE_TA 2 +#define DANETLS_USAGE_DANE_EE 3 +#define DANETLS_USAGE_LAST DANETLS_USAGE_DANE_EE + +/*- + * Selectors: + * https://tools.ietf.org/html/rfc6698#section-2.1.2 + */ +#define DANETLS_SELECTOR_CERT 0 +#define DANETLS_SELECTOR_SPKI 1 +#define DANETLS_SELECTOR_LAST DANETLS_SELECTOR_SPKI + +/*- + * Matching types: + * https://tools.ietf.org/html/rfc6698#section-2.1.3 + */ +#define DANETLS_MATCHING_FULL 0 +#define DANETLS_MATCHING_2256 1 +#define DANETLS_MATCHING_2512 2 +#define DANETLS_MATCHING_LAST DANETLS_MATCHING_2512 + +typedef struct danetls_record_st { + uint8_t usage; + uint8_t selector; + uint8_t mtype; + unsigned char *data; + size_t dlen; + EVP_PKEY *spki; +} danetls_record; + +DEFINE_STACK_OF(danetls_record) + +/* + * Shared DANE context + */ +struct dane_ctx_st { + const EVP_MD **mdevp; /* mtype -> digest */ + uint8_t *mdord; /* mtype -> preference */ + uint8_t mdmax; /* highest supported mtype */ + unsigned long flags; /* feature bitmask */ +}; + +/* + * Per connection DANE state + */ +struct ssl_dane_st { + struct dane_ctx_st *dctx; + STACK_OF(danetls_record) *trecs; + STACK_OF(X509) *certs; /* DANE-TA(2) Cert(0) Full(0) certs */ + danetls_record *mtlsa; /* Matching TLSA record */ + X509 *mcert; /* DANE matched cert */ + uint32_t umask; /* Usages present */ + int mdpth; /* Depth of matched cert */ + int pdpth; /* Depth of PKIX trust */ + unsigned long flags; /* feature bitmask */ +}; + +#define DANETLS_ENABLED(dane) \ + ((dane) != NULL && sk_danetls_record_num((dane)->trecs) > 0) + +#define DANETLS_USAGE_BIT(u) (((uint32_t)1) << u) + +#define DANETLS_PKIX_TA_MASK (DANETLS_USAGE_BIT(DANETLS_USAGE_PKIX_TA)) +#define DANETLS_PKIX_EE_MASK (DANETLS_USAGE_BIT(DANETLS_USAGE_PKIX_EE)) +#define DANETLS_DANE_TA_MASK (DANETLS_USAGE_BIT(DANETLS_USAGE_DANE_TA)) +#define DANETLS_DANE_EE_MASK (DANETLS_USAGE_BIT(DANETLS_USAGE_DANE_EE)) + +#define DANETLS_PKIX_MASK (DANETLS_PKIX_TA_MASK | DANETLS_PKIX_EE_MASK) +#define DANETLS_DANE_MASK (DANETLS_DANE_TA_MASK | DANETLS_DANE_EE_MASK) +#define DANETLS_TA_MASK (DANETLS_PKIX_TA_MASK | DANETLS_DANE_TA_MASK) +#define DANETLS_EE_MASK (DANETLS_PKIX_EE_MASK | DANETLS_DANE_EE_MASK) + +#define DANETLS_HAS_PKIX(dane) ((dane) && ((dane)->umask & DANETLS_PKIX_MASK)) +#define DANETLS_HAS_DANE(dane) ((dane) && ((dane)->umask & DANETLS_DANE_MASK)) +#define DANETLS_HAS_TA(dane) ((dane) && ((dane)->umask & DANETLS_TA_MASK)) +#define DANETLS_HAS_EE(dane) ((dane) && ((dane)->umask & DANETLS_EE_MASK)) + +#define DANETLS_HAS_PKIX_TA(dane) ((dane)&&((dane)->umask & DANETLS_PKIX_TA_MASK)) +#define DANETLS_HAS_PKIX_EE(dane) ((dane)&&((dane)->umask & DANETLS_PKIX_EE_MASK)) +#define DANETLS_HAS_DANE_TA(dane) ((dane)&&((dane)->umask & DANETLS_DANE_TA_MASK)) +#define DANETLS_HAS_DANE_EE(dane) ((dane)&&((dane)->umask & DANETLS_DANE_EE_MASK)) + +#endif /* HEADER_INTERNAL_DANE_H */ diff --git a/include/openssl/internal/dso.h b/include/openssl/internal/dso.h new file mode 100644 index 0000000..861d9cb --- /dev/null +++ b/include/openssl/internal/dso.h @@ -0,0 +1,165 @@ +/* + * Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DSO_H +# define HEADER_DSO_H + +# include +# include "internal/dsoerr.h" + +/* These values are used as commands to DSO_ctrl() */ +# define DSO_CTRL_GET_FLAGS 1 +# define DSO_CTRL_SET_FLAGS 2 +# define DSO_CTRL_OR_FLAGS 3 + +/* + * By default, DSO_load() will translate the provided filename into a form + * typical for the platform using the dso_name_converter function of the + * method. Eg. win32 will transform "blah" into "blah.dll", and dlfcn will + * transform it into "libblah.so". This callback could even utilise the + * DSO_METHOD's converter too if it only wants to override behaviour for + * one or two possible DSO methods. However, the following flag can be + * set in a DSO to prevent *any* native name-translation at all - eg. if + * the caller has prompted the user for a path to a driver library so the + * filename should be interpreted as-is. + */ +# define DSO_FLAG_NO_NAME_TRANSLATION 0x01 +/* + * An extra flag to give if only the extension should be added as + * translation. This is obviously only of importance on Unix and other + * operating systems where the translation also may prefix the name with + * something, like 'lib', and ignored everywhere else. This flag is also + * ignored if DSO_FLAG_NO_NAME_TRANSLATION is used at the same time. + */ +# define DSO_FLAG_NAME_TRANSLATION_EXT_ONLY 0x02 + +/* + * Don't unload the DSO when we call DSO_free() + */ +# define DSO_FLAG_NO_UNLOAD_ON_FREE 0x04 + +/* + * This flag loads the library with public symbols. Meaning: The exported + * symbols of this library are public to all libraries loaded after this + * library. At the moment only implemented in unix. + */ +# define DSO_FLAG_GLOBAL_SYMBOLS 0x20 + +typedef void (*DSO_FUNC_TYPE) (void); + +typedef struct dso_st DSO; +typedef struct dso_meth_st DSO_METHOD; + +/* + * The function prototype used for method functions (or caller-provided + * callbacks) that transform filenames. They are passed a DSO structure + * pointer (or NULL if they are to be used independently of a DSO object) and + * a filename to transform. They should either return NULL (if there is an + * error condition) or a newly allocated string containing the transformed + * form that the caller will need to free with OPENSSL_free() when done. + */ +typedef char *(*DSO_NAME_CONVERTER_FUNC)(DSO *, const char *); +/* + * The function prototype used for method functions (or caller-provided + * callbacks) that merge two file specifications. They are passed a DSO + * structure pointer (or NULL if they are to be used independently of a DSO + * object) and two file specifications to merge. They should either return + * NULL (if there is an error condition) or a newly allocated string + * containing the result of merging that the caller will need to free with + * OPENSSL_free() when done. Here, merging means that bits and pieces are + * taken from each of the file specifications and added together in whatever + * fashion that is sensible for the DSO method in question. The only rule + * that really applies is that if the two specification contain pieces of the + * same type, the copy from the first string takes priority. One could see + * it as the first specification is the one given by the user and the second + * being a bunch of defaults to add on if they're missing in the first. + */ +typedef char *(*DSO_MERGER_FUNC)(DSO *, const char *, const char *); + +DSO *DSO_new(void); +int DSO_free(DSO *dso); +int DSO_flags(DSO *dso); +int DSO_up_ref(DSO *dso); +long DSO_ctrl(DSO *dso, int cmd, long larg, void *parg); + +/* + * These functions can be used to get/set the platform-independent filename + * used for a DSO. NB: set will fail if the DSO is already loaded. + */ +const char *DSO_get_filename(DSO *dso); +int DSO_set_filename(DSO *dso, const char *filename); +/* + * This function will invoke the DSO's name_converter callback to translate a + * filename, or if the callback isn't set it will instead use the DSO_METHOD's + * converter. If "filename" is NULL, the "filename" in the DSO itself will be + * used. If the DSO_FLAG_NO_NAME_TRANSLATION flag is set, then the filename is + * simply duplicated. NB: This function is usually called from within a + * DSO_METHOD during the processing of a DSO_load() call, and is exposed so + * that caller-created DSO_METHODs can do the same thing. A non-NULL return + * value will need to be OPENSSL_free()'d. + */ +char *DSO_convert_filename(DSO *dso, const char *filename); +/* + * This function will invoke the DSO's merger callback to merge two file + * specifications, or if the callback isn't set it will instead use the + * DSO_METHOD's merger. A non-NULL return value will need to be + * OPENSSL_free()'d. + */ +char *DSO_merge(DSO *dso, const char *filespec1, const char *filespec2); + +/* + * The all-singing all-dancing load function, you normally pass NULL for the + * first and third parameters. Use DSO_up_ref and DSO_free for subsequent + * reference count handling. Any flags passed in will be set in the + * constructed DSO after its init() function but before the load operation. + * If 'dso' is non-NULL, 'flags' is ignored. + */ +DSO *DSO_load(DSO *dso, const char *filename, DSO_METHOD *meth, int flags); + +/* This function binds to a function inside a shared library. */ +DSO_FUNC_TYPE DSO_bind_func(DSO *dso, const char *symname); + +/* + * This method is the default, but will beg, borrow, or steal whatever method + * should be the default on any particular platform (including + * DSO_METH_null() if necessary). + */ +DSO_METHOD *DSO_METHOD_openssl(void); + +/* + * This function writes null-terminated pathname of DSO module containing + * 'addr' into 'sz' large caller-provided 'path' and returns the number of + * characters [including trailing zero] written to it. If 'sz' is 0 or + * negative, 'path' is ignored and required amount of characters [including + * trailing zero] to accommodate pathname is returned. If 'addr' is NULL, then + * pathname of cryptolib itself is returned. Negative or zero return value + * denotes error. + */ +int DSO_pathbyaddr(void *addr, char *path, int sz); + +/* + * Like DSO_pathbyaddr() but instead returns a handle to the DSO for the symbol + * or NULL on error. + */ +DSO *DSO_dsobyaddr(void *addr, int flags); + +/* + * This function should be used with caution! It looks up symbols in *all* + * loaded modules and if module gets unloaded by somebody else attempt to + * dereference the pointer is doomed to have fatal consequences. Primary + * usage for this function is to probe *core* system functionality, e.g. + * check if getnameinfo(3) is available at run-time without bothering about + * OS-specific details such as libc.so.versioning or where does it actually + * reside: in libc itself or libsocket. + */ +void *DSO_global_lookup(const char *name); + +int ERR_load_DSO_strings(void); + +#endif diff --git a/include/openssl/internal/dsoerr.h b/include/openssl/internal/dsoerr.h new file mode 100644 index 0000000..4bef713 --- /dev/null +++ b/include/openssl/internal/dsoerr.h @@ -0,0 +1,83 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DSOERR_H +# define HEADER_DSOERR_H + +# include + +# ifndef OPENSSL_NO_DSO + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_DSO_strings(void); + +/* + * DSO function codes. + */ +# define DSO_F_DLFCN_BIND_FUNC 100 +# define DSO_F_DLFCN_LOAD 102 +# define DSO_F_DLFCN_MERGER 130 +# define DSO_F_DLFCN_NAME_CONVERTER 123 +# define DSO_F_DLFCN_UNLOAD 103 +# define DSO_F_DL_BIND_FUNC 104 +# define DSO_F_DL_LOAD 106 +# define DSO_F_DL_MERGER 131 +# define DSO_F_DL_NAME_CONVERTER 124 +# define DSO_F_DL_UNLOAD 107 +# define DSO_F_DSO_BIND_FUNC 108 +# define DSO_F_DSO_CONVERT_FILENAME 126 +# define DSO_F_DSO_CTRL 110 +# define DSO_F_DSO_FREE 111 +# define DSO_F_DSO_GET_FILENAME 127 +# define DSO_F_DSO_GLOBAL_LOOKUP 139 +# define DSO_F_DSO_LOAD 112 +# define DSO_F_DSO_MERGE 132 +# define DSO_F_DSO_NEW_METHOD 113 +# define DSO_F_DSO_PATHBYADDR 105 +# define DSO_F_DSO_SET_FILENAME 129 +# define DSO_F_DSO_UP_REF 114 +# define DSO_F_VMS_BIND_SYM 115 +# define DSO_F_VMS_LOAD 116 +# define DSO_F_VMS_MERGER 133 +# define DSO_F_VMS_UNLOAD 117 +# define DSO_F_WIN32_BIND_FUNC 101 +# define DSO_F_WIN32_GLOBALLOOKUP 142 +# define DSO_F_WIN32_JOINER 135 +# define DSO_F_WIN32_LOAD 120 +# define DSO_F_WIN32_MERGER 134 +# define DSO_F_WIN32_NAME_CONVERTER 125 +# define DSO_F_WIN32_PATHBYADDR 109 +# define DSO_F_WIN32_SPLITTER 136 +# define DSO_F_WIN32_UNLOAD 121 + +/* + * DSO reason codes. + */ +# define DSO_R_CTRL_FAILED 100 +# define DSO_R_DSO_ALREADY_LOADED 110 +# define DSO_R_EMPTY_FILE_STRUCTURE 113 +# define DSO_R_FAILURE 114 +# define DSO_R_FILENAME_TOO_BIG 101 +# define DSO_R_FINISH_FAILED 102 +# define DSO_R_INCORRECT_FILE_SYNTAX 115 +# define DSO_R_LOAD_FAILED 103 +# define DSO_R_NAME_TRANSLATION_FAILED 109 +# define DSO_R_NO_FILENAME 111 +# define DSO_R_NULL_HANDLE 104 +# define DSO_R_SET_FILENAME_FAILED 112 +# define DSO_R_STACK_ERROR 105 +# define DSO_R_SYM_FAILURE 106 +# define DSO_R_UNLOAD_FAILED 107 +# define DSO_R_UNSUPPORTED 108 + +# endif +#endif diff --git a/include/openssl/internal/err.h b/include/openssl/internal/err.h new file mode 100644 index 0000000..d46b8bd --- /dev/null +++ b/include/openssl/internal/err.h @@ -0,0 +1,15 @@ +/* + * Copyright 2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef INTERNAL_ERR_H +# define INTERNAL_ERR_H + +void err_free_strings_int(void); + +#endif diff --git a/include/openssl/internal/nelem.h b/include/openssl/internal/nelem.h new file mode 100644 index 0000000..d65a21a --- /dev/null +++ b/include/openssl/internal/nelem.h @@ -0,0 +1,14 @@ +/* + * Copyright 2017 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_NELEM_H +# define HEADER_NELEM_H + +# define OSSL_NELEM(x) (sizeof(x)/sizeof((x)[0])) +#endif diff --git a/include/openssl/internal/numbers.h b/include/openssl/internal/numbers.h new file mode 100644 index 0000000..31931df --- /dev/null +++ b/include/openssl/internal/numbers.h @@ -0,0 +1,68 @@ +/* + * Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_NUMBERS_H +# define HEADER_NUMBERS_H + +# include + +# if (-1 & 3) == 0x03 /* Two's complement */ + +# define __MAXUINT__(T) ((T) -1) +# define __MAXINT__(T) ((T) ((((T) 1) << ((sizeof(T) * CHAR_BIT) - 1)) ^ __MAXUINT__(T))) +# define __MININT__(T) (-__MAXINT__(T) - 1) + +# elif (-1 & 3) == 0x02 /* One's complement */ + +# define __MAXUINT__(T) (((T) -1) + 1) +# define __MAXINT__(T) ((T) ((((T) 1) << ((sizeof(T) * CHAR_BIT) - 1)) ^ __MAXUINT__(T))) +# define __MININT__(T) (-__MAXINT__(T)) + +# elif (-1 & 3) == 0x01 /* Sign/magnitude */ + +# define __MAXINT__(T) ((T) (((((T) 1) << ((sizeof(T) * CHAR_BIT) - 2)) - 1) | (((T) 1) << ((sizeof(T) * CHAR_BIT) - 2)))) +# define __MAXUINT__(T) ((T) (__MAXINT__(T) | (((T) 1) << ((sizeof(T) * CHAR_BIT) - 1)))) +# define __MININT__(T) (-__MAXINT__(T)) + +# else + +# error "do not know the integer encoding on this architecture" + +# endif + +# ifndef INT8_MAX +# define INT8_MIN __MININT__(int8_t) +# define INT8_MAX __MAXINT__(int8_t) +# define UINT8_MAX __MAXUINT__(uint8_t) +# endif + +# ifndef INT16_MAX +# define INT16_MIN __MININT__(int16_t) +# define INT16_MAX __MAXINT__(int16_t) +# define UINT16_MAX __MAXUINT__(uint16_t) +# endif + +# ifndef INT32_MAX +# define INT32_MIN __MININT__(int32_t) +# define INT32_MAX __MAXINT__(int32_t) +# define UINT32_MAX __MAXUINT__(uint32_t) +# endif + +# ifndef INT64_MAX +# define INT64_MIN __MININT__(int64_t) +# define INT64_MAX __MAXINT__(int64_t) +# define UINT64_MAX __MAXUINT__(uint64_t) +# endif + +# ifndef SIZE_MAX +# define SIZE_MAX __MAXUINT__(size_t) +# endif + +#endif + diff --git a/include/openssl/internal/o_dir.h b/include/openssl/internal/o_dir.h new file mode 100644 index 0000000..e7b55e0 --- /dev/null +++ b/include/openssl/internal/o_dir.h @@ -0,0 +1,52 @@ +/* + * Copyright 2004-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * This file is dual-licensed and is also available under the following + * terms: + * + * Copyright (c) 2004, Richard Levitte + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +#ifndef O_DIR_H +# define O_DIR_H + +typedef struct OPENSSL_dir_context_st OPENSSL_DIR_CTX; + +/* + * returns NULL on error or end-of-directory. If it is end-of-directory, + * errno will be zero + */ +const char *OPENSSL_DIR_read(OPENSSL_DIR_CTX **ctx, const char *directory); +/* returns 1 on success, 0 on error */ +int OPENSSL_DIR_end(OPENSSL_DIR_CTX **ctx); + +#endif /* LPDIR_H */ diff --git a/include/openssl/internal/o_str.h b/include/openssl/internal/o_str.h new file mode 100644 index 0000000..86403c9 --- /dev/null +++ b/include/openssl/internal/o_str.h @@ -0,0 +1,17 @@ +/* + * Copyright 2003-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_O_STR_H +# define HEADER_O_STR_H + +# include /* to get size_t */ + +int OPENSSL_memcmp(const void *p1, const void *p2, size_t n); + +#endif diff --git a/include/openssl/internal/refcount.h b/include/openssl/internal/refcount.h new file mode 100644 index 0000000..75d70a6 --- /dev/null +++ b/include/openssl/internal/refcount.h @@ -0,0 +1,140 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ +#ifndef HEADER_INTERNAL_REFCOUNT_H +# define HEADER_INTERNAL_REFCOUNT_H + +/* Used to checking reference counts, most while doing perl5 stuff :-) */ +# if defined(OPENSSL_NO_STDIO) +# if defined(REF_PRINT) +# error "REF_PRINT requires stdio" +# endif +# endif + +# if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L \ + && !defined(__STDC_NO_ATOMICS__) +# include +# define HAVE_C11_ATOMICS +# endif + +# if defined(HAVE_C11_ATOMICS) && defined(ATOMIC_INT_LOCK_FREE) \ + && ATOMIC_INT_LOCK_FREE > 0 + +# define HAVE_ATOMICS 1 + +typedef _Atomic int CRYPTO_REF_COUNT; + +static inline int CRYPTO_UP_REF(_Atomic int *val, int *ret, void *lock) +{ + *ret = atomic_fetch_add_explicit(val, 1, memory_order_relaxed) + 1; + return 1; +} + +/* + * Changes to shared structure other than reference counter have to be + * serialized. And any kind of serialization implies a release fence. This + * means that by the time reference counter is decremented all other + * changes are visible on all processors. Hence decrement itself can be + * relaxed. In case it hits zero, object will be destructed. Since it's + * last use of the object, destructor programmer might reason that access + * to mutable members doesn't have to be serialized anymore, which would + * otherwise imply an acquire fence. Hence conditional acquire fence... + */ +static inline int CRYPTO_DOWN_REF(_Atomic int *val, int *ret, void *lock) +{ + *ret = atomic_fetch_sub_explicit(val, 1, memory_order_relaxed) - 1; + if (*ret == 0) + atomic_thread_fence(memory_order_acquire); + return 1; +} + +# elif defined(__GNUC__) && defined(__ATOMIC_RELAXED) && __GCC_ATOMIC_INT_LOCK_FREE > 0 + +# define HAVE_ATOMICS 1 + +typedef int CRYPTO_REF_COUNT; + +static __inline__ int CRYPTO_UP_REF(int *val, int *ret, void *lock) +{ + *ret = __atomic_fetch_add(val, 1, __ATOMIC_RELAXED) + 1; + return 1; +} + +static __inline__ int CRYPTO_DOWN_REF(int *val, int *ret, void *lock) +{ + *ret = __atomic_fetch_sub(val, 1, __ATOMIC_RELAXED) - 1; + if (*ret == 0) + __atomic_thread_fence(__ATOMIC_ACQUIRE); + return 1; +} + +# elif defined(_MSC_VER) && _MSC_VER>=1200 + +# define HAVE_ATOMICS 1 + +typedef volatile int CRYPTO_REF_COUNT; + +# if (defined(_M_ARM) && _M_ARM>=7) || defined(_M_ARM64) +# include +# if defined(_M_ARM64) && !defined(_ARM_BARRIER_ISH) +# define _ARM_BARRIER_ISH _ARM64_BARRIER_ISH +# endif + +static __inline int CRYPTO_UP_REF(volatile int *val, int *ret, void *lock) +{ + *ret = _InterlockedExchangeAdd_nf(val, 1) + 1; + return 1; +} + +static __inline int CRYPTO_DOWN_REF(volatile int *val, int *ret, void *lock) +{ + *ret = _InterlockedExchangeAdd_nf(val, -1) - 1; + if (*ret == 0) + __dmb(_ARM_BARRIER_ISH); + return 1; +} +# else +# pragma intrinsic(_InterlockedExchangeAdd) + +static __inline int CRYPTO_UP_REF(volatile int *val, int *ret, void *lock) +{ + *ret = _InterlockedExchangeAdd(val, 1) + 1; + return 1; +} + +static __inline int CRYPTO_DOWN_REF(volatile int *val, int *ret, void *lock) +{ + *ret = _InterlockedExchangeAdd(val, -1) - 1; + return 1; +} +# endif + +# else + +typedef int CRYPTO_REF_COUNT; + +# define CRYPTO_UP_REF(val, ret, lock) CRYPTO_atomic_add(val, 1, ret, lock) +# define CRYPTO_DOWN_REF(val, ret, lock) CRYPTO_atomic_add(val, -1, ret, lock) + +# endif + +# if !defined(NDEBUG) && !defined(OPENSSL_NO_STDIO) +# define REF_ASSERT_ISNT(test) \ + (void)((test) ? (OPENSSL_die("refcount error", __FILE__, __LINE__), 1) : 0) +# else +# define REF_ASSERT_ISNT(i) +# endif + +# ifdef REF_PRINT +# define REF_PRINT_COUNT(a, b) \ + fprintf(stderr, "%p:%4d:%s\n", b, b->references, a) +# else +# define REF_PRINT_COUNT(a, b) +# endif + +#endif diff --git a/include/openssl/internal/sockets.h b/include/openssl/internal/sockets.h new file mode 100644 index 0000000..a6026da --- /dev/null +++ b/include/openssl/internal/sockets.h @@ -0,0 +1,159 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + + +#ifndef HEADER_INTERNAL_SOCKETS +# define HEADER_INTERNAL_SOCKETS + +# if defined(OPENSSL_SYS_VXWORKS) || defined(OPENSSL_SYS_UEFI) +# define NO_SYS_PARAM_H +# endif +# ifdef WIN32 +# define NO_SYS_UN_H +# endif +# ifdef OPENSSL_SYS_VMS +# define NO_SYS_PARAM_H +# define NO_SYS_UN_H +# endif + +# ifdef OPENSSL_NO_SOCK + +# elif defined(OPENSSL_SYS_WINDOWS) || defined(OPENSSL_SYS_MSDOS) +# if defined(__DJGPP__) +# include +# include +# include +# include +# elif defined(_WIN32_WCE) && _WIN32_WCE<410 +# define getservbyname _masked_declaration_getservbyname +# endif +# if !defined(IPPROTO_IP) + /* winsock[2].h was included already? */ +# include +# endif +# ifdef getservbyname + /* this is used to be wcecompat/include/winsock_extras.h */ +# undef getservbyname +struct servent *PASCAL getservbyname(const char *, const char *); +# endif + +# ifdef _WIN64 +/* + * Even though sizeof(SOCKET) is 8, it's safe to cast it to int, because + * the value constitutes an index in per-process table of limited size + * and not a real pointer. And we also depend on fact that all processors + * Windows run on happen to be two's-complement, which allows to + * interchange INVALID_SOCKET and -1. + */ +# define socket(d,t,p) ((int)socket(d,t,p)) +# define accept(s,f,l) ((int)accept(s,f,l)) +# endif + +# else + +# ifndef NO_SYS_PARAM_H +# include +# endif +# ifdef OPENSSL_SYS_VXWORKS +# include +# endif + +# include +# if defined(OPENSSL_SYS_VMS_NODECC) +# include +# include +# include +# else +# include +# ifndef NO_SYS_UN_H +# ifdef OPENSSL_SYS_VXWORKS +# include +# else +# include +# endif +# ifndef UNIX_PATH_MAX +# define UNIX_PATH_MAX sizeof(((struct sockaddr_un *)NULL)->sun_path) +# endif +# endif +# ifdef FILIO_H +# include /* FIONBIO in some SVR4, e.g. unixware, solaris */ +# endif +# include +# include +# include +# endif + +# ifdef OPENSSL_SYS_AIX +# include +# endif + +# ifndef VMS +# include +# else +# if !defined(TCPIP_TYPE_SOCKETSHR) && defined(__VMS_VER) && (__VMS_VER > 70000000) + /* ioctl is only in VMS > 7.0 and when socketshr is not used */ +# include +# endif +# include +# if defined(TCPIP_TYPE_SOCKETSHR) +# include +# endif +# endif + +# ifndef INVALID_SOCKET +# define INVALID_SOCKET (-1) +# endif +# endif + +/* + * Some IPv6 implementations are broken, you can disable them in known + * bad versions. + */ +# if !defined(OPENSSL_USE_IPV6) +# if defined(AF_INET6) +# define OPENSSL_USE_IPV6 1 +# else +# define OPENSSL_USE_IPV6 0 +# endif +# endif + +# define get_last_socket_error() errno +# define clear_socket_error() errno=0 + +# if defined(OPENSSL_SYS_WINDOWS) +# undef get_last_socket_error +# undef clear_socket_error +# define get_last_socket_error() WSAGetLastError() +# define clear_socket_error() WSASetLastError(0) +# define readsocket(s,b,n) recv((s),(b),(n),0) +# define writesocket(s,b,n) send((s),(b),(n),0) +# elif defined(__DJGPP__) +# define WATT32 +# define WATT32_NO_OLDIES +# define closesocket(s) close_s(s) +# define readsocket(s,b,n) read_s(s,b,n) +# define writesocket(s,b,n) send(s,b,n,0) +# elif defined(OPENSSL_SYS_VMS) +# define ioctlsocket(a,b,c) ioctl(a,b,c) +# define closesocket(s) close(s) +# define readsocket(s,b,n) recv((s),(b),(n),0) +# define writesocket(s,b,n) send((s),(b),(n),0) +# elif defined(OPENSSL_SYS_VXWORKS) +# define ioctlsocket(a,b,c) ioctl((a),(b),(int)(c)) +# define closesocket(s) close(s) +# define readsocket(s,b,n) read((s),(b),(n)) +# define writesocket(s,b,n) write((s),(char *)(b),(n)) +# else +# define ioctlsocket(a,b,c) ioctl(a,b,c) +# define closesocket(s) close(s) +# define readsocket(s,b,n) read((s),(b),(n)) +# define writesocket(s,b,n) write((s),(b),(n)) +# endif + +#endif diff --git a/include/openssl/internal/sslconf.h b/include/openssl/internal/sslconf.h new file mode 100644 index 0000000..d538f86 --- /dev/null +++ b/include/openssl/internal/sslconf.h @@ -0,0 +1,20 @@ +/* + * Copyright 2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SSLCONF_H +# define HEADER_SSLCONF_H + +typedef struct ssl_conf_cmd_st SSL_CONF_CMD; + +const SSL_CONF_CMD *conf_ssl_get(size_t idx, const char **name, size_t *cnt); +int conf_ssl_name_find(const char *name, size_t *idx); +void conf_ssl_get_cmd(const SSL_CONF_CMD *cmd, size_t idx, char **cmdstr, + char **arg); + +#endif diff --git a/include/openssl/internal/thread_once.h b/include/openssl/internal/thread_once.h new file mode 100644 index 0000000..a79628d --- /dev/null +++ b/include/openssl/internal/thread_once.h @@ -0,0 +1,45 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +#define DEFINE_RUN_ONCE(init) \ + static int init(void); \ + int init##_ossl_ret_ = 0; \ + void init##_ossl_(void) \ + { \ + init##_ossl_ret_ = init(); \ + } \ + static int init(void) +#define DECLARE_RUN_ONCE(init) \ + extern int init##_ossl_ret_; \ + void init##_ossl_(void); + +#define DEFINE_RUN_ONCE_STATIC(init) \ + static int init(void); \ + static int init##_ossl_ret_ = 0; \ + static void init##_ossl_(void) \ + { \ + init##_ossl_ret_ = init(); \ + } \ + static int init(void) + +/* + * RUN_ONCE - use CRYPTO_THREAD_run_once, and check if the init succeeded + * @once: pointer to static object of type CRYPTO_ONCE + * @init: function name that was previously given to DEFINE_RUN_ONCE, + * DEFINE_RUN_ONCE_STATIC or DECLARE_RUN_ONCE. This function + * must return 1 for success or 0 for failure. + * + * The return value is 1 on success (*) or 0 in case of error. + * + * (*) by convention, since the init function must return 1 on success. + */ +#define RUN_ONCE(once, init) \ + (CRYPTO_THREAD_run_once(once, init##_ossl_) ? init##_ossl_ret_ : 0) diff --git a/include/openssl/internal/tsan_assist.h b/include/openssl/internal/tsan_assist.h new file mode 100644 index 0000000..2c76383 --- /dev/null +++ b/include/openssl/internal/tsan_assist.h @@ -0,0 +1,138 @@ +/* + * Copyright 2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * Contemporary compilers implement lock-free atomic memory access + * primitives that facilitate writing "thread-opportunistic" or even real + * multi-threading low-overhead code. "Thread-opportunistic" is when + * exact result is not required, e.g. some statistics, or execution flow + * doesn't have to be unambiguous. Simplest example is lazy "constant" + * initialization when one can synchronize on variable itself, e.g. + * + * if (var == NOT_YET_INITIALIZED) + * var = function_returning_same_value(); + * + * This does work provided that loads and stores are single-instuction + * operations (and integer ones are on *all* supported platforms), but + * it upsets Thread Sanitizer. Suggested solution is + * + * if (tsan_load(&var) == NOT_YET_INITIALIZED) + * tsan_store(&var, function_returning_same_value()); + * + * Production machine code would be the same, so one can wonder why + * bother. Having Thread Sanitizer accept "thread-opportunistic" code + * allows to move on trouble-shooting real bugs. + * + * Resolving Thread Sanitizer nits was the initial purpose for this module, + * but it was later extended with more nuanced primitives that are useful + * even in "non-opportunistic" scenarios. Most notably verifying if a shared + * structure is fully initialized and bypassing the initialization lock. + * It's suggested to view macros defined in this module as "annotations" for + * thread-safe lock-free code, "Thread-Safe ANnotations"... + * + * It's assumed that ATOMIC_{LONG|INT}_LOCK_FREE are assigned same value as + * ATOMIC_POINTER_LOCK_FREE. And check for >= 2 ensures that corresponding + * code is inlined. It should be noted that statistics counters become + * accurate in such case. + * + * Special note about TSAN_QUALIFIER. It might be undesired to use it in + * a shared header. Because whether operation on specific variable or member + * is atomic or not might be irrelevant in other modules. In such case one + * can use TSAN_QUALIFIER in cast specifically when it has to count. + */ + +#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L \ + && !defined(__STDC_NO_ATOMICS__) +# include + +# if defined(ATOMIC_POINTER_LOCK_FREE) \ + && ATOMIC_POINTER_LOCK_FREE >= 2 +# define TSAN_QUALIFIER _Atomic +# define tsan_load(ptr) atomic_load_explicit((ptr), memory_order_relaxed) +# define tsan_store(ptr, val) atomic_store_explicit((ptr), (val), memory_order_relaxed) +# define tsan_counter(ptr) atomic_fetch_add_explicit((ptr), 1, memory_order_relaxed) +# define tsan_ld_acq(ptr) atomic_load_explicit((ptr), memory_order_acquire) +# define tsan_st_rel(ptr, val) atomic_store_explicit((ptr), (val), memory_order_release) +# endif + +#elif defined(__GNUC__) && defined(__ATOMIC_RELAXED) + +# if defined(__GCC_ATOMIC_POINTER_LOCK_FREE) \ + && __GCC_ATOMIC_POINTER_LOCK_FREE >= 2 +# define TSAN_QUALIFIER volatile +# define tsan_load(ptr) __atomic_load_n((ptr), __ATOMIC_RELAXED) +# define tsan_store(ptr, val) __atomic_store_n((ptr), (val), __ATOMIC_RELAXED) +# define tsan_counter(ptr) __atomic_fetch_add((ptr), 1, __ATOMIC_RELAXED) +# define tsan_ld_acq(ptr) __atomic_load_n((ptr), __ATOMIC_ACQUIRE) +# define tsan_st_rel(ptr, val) __atomic_store_n((ptr), (val), __ATOMIC_RELEASE) +# endif + +#elif defined(_MSC_VER) && _MSC_VER>=1200 \ + && (defined(_M_IX86) || defined(_M_AMD64) || defined(_M_X64) || \ + defined(_M_ARM64) || (defined(_M_ARM) && _M_ARM >= 7)) +/* + * There is subtle dependency on /volatile: command-line option. + * "ms" implies same semantic as memory_order_acquire for loads and + * memory_order_release for stores, while "iso" - memory_order_relaxed for + * either. Real complication is that defaults are different on x86 and ARM. + * There is explanation for that, "ms" is backward compatible with earlier + * compiler versions, while multi-processor ARM can be viewed as brand new + * platform to MSC and its users, and with non-relaxed semantic taking toll + * with additional instructions and penalties, it kind of makes sense to + * default to "iso"... + */ +# define TSAN_QUALIFIER volatile +# if defined(_M_ARM) || defined(_M_ARM64) +# define _InterlockedExchangeAdd _InterlockedExchangeAdd_nf +# pragma intrinsic(_InterlockedExchangeAdd_nf) +# pragma intrinsic(__iso_volatile_load32, __iso_volatile_store32) +# ifdef _WIN64 +# define _InterlockedExchangeAdd64 _InterlockedExchangeAdd64_nf +# pragma intrinsic(_InterlockedExchangeAdd64_nf) +# pragma intrinsic(__iso_volatile_load64, __iso_volatile_store64) +# define tsan_load(ptr) (sizeof(*(ptr)) == 8 ? __iso_volatile_load64(ptr) \ + : __iso_volatile_load32(ptr)) +# define tsan_store(ptr, val) (sizeof(*(ptr)) == 8 ? __iso_volatile_store64((ptr), (val)) \ + : __iso_volatile_store32((ptr), (val))) +# else +# define tsan_load(ptr) __iso_volatile_load32(ptr) +# define tsan_store(ptr, val) __iso_volatile_store32((ptr), (val)) +# endif +# else +# define tsan_load(ptr) (*(ptr)) +# define tsan_store(ptr, val) (*(ptr) = (val)) +# endif +# pragma intrinsic(_InterlockedExchangeAdd) +# ifdef _WIN64 +# pragma intrinsic(_InterlockedExchangeAdd64) +# define tsan_counter(ptr) (sizeof(*(ptr)) == 8 ? _InterlockedExchangeAdd64((ptr), 1) \ + : _InterlockedExchangeAdd((ptr), 1)) +# else +# define tsan_counter(ptr) _InterlockedExchangeAdd((ptr), 1) +# endif +# if !defined(_ISO_VOLATILE) +# define tsan_ld_acq(ptr) (*(ptr)) +# define tsan_st_rel(ptr, val) (*(ptr) = (val)) +# endif + +#endif + +#ifndef TSAN_QUALIFIER + +# define TSAN_QUALIFIER volatile +# define tsan_load(ptr) (*(ptr)) +# define tsan_store(ptr, val) (*(ptr) = (val)) +# define tsan_counter(ptr) ((*(ptr))++) +/* + * Lack of tsan_ld_acq and tsan_ld_rel means that compiler support is not + * sophisticated enough to support them. Code that relies on them should be + * protected with #ifdef tsan_ld_acq with locked fallback. + */ + +#endif diff --git a/include/openssl/kdf.h b/include/openssl/kdf.h new file mode 100644 index 0000000..d61dd81 --- /dev/null +++ b/include/openssl/kdf.h @@ -0,0 +1,97 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_KDF_H +# define HEADER_KDF_H + +# include +#ifdef __cplusplus +extern "C" { +#endif + +# define EVP_PKEY_CTRL_TLS_MD (EVP_PKEY_ALG_CTRL) +# define EVP_PKEY_CTRL_TLS_SECRET (EVP_PKEY_ALG_CTRL + 1) +# define EVP_PKEY_CTRL_TLS_SEED (EVP_PKEY_ALG_CTRL + 2) +# define EVP_PKEY_CTRL_HKDF_MD (EVP_PKEY_ALG_CTRL + 3) +# define EVP_PKEY_CTRL_HKDF_SALT (EVP_PKEY_ALG_CTRL + 4) +# define EVP_PKEY_CTRL_HKDF_KEY (EVP_PKEY_ALG_CTRL + 5) +# define EVP_PKEY_CTRL_HKDF_INFO (EVP_PKEY_ALG_CTRL + 6) +# define EVP_PKEY_CTRL_HKDF_MODE (EVP_PKEY_ALG_CTRL + 7) +# define EVP_PKEY_CTRL_PASS (EVP_PKEY_ALG_CTRL + 8) +# define EVP_PKEY_CTRL_SCRYPT_SALT (EVP_PKEY_ALG_CTRL + 9) +# define EVP_PKEY_CTRL_SCRYPT_N (EVP_PKEY_ALG_CTRL + 10) +# define EVP_PKEY_CTRL_SCRYPT_R (EVP_PKEY_ALG_CTRL + 11) +# define EVP_PKEY_CTRL_SCRYPT_P (EVP_PKEY_ALG_CTRL + 12) +# define EVP_PKEY_CTRL_SCRYPT_MAXMEM_BYTES (EVP_PKEY_ALG_CTRL + 13) + +# define EVP_PKEY_HKDEF_MODE_EXTRACT_AND_EXPAND 0 +# define EVP_PKEY_HKDEF_MODE_EXTRACT_ONLY 1 +# define EVP_PKEY_HKDEF_MODE_EXPAND_ONLY 2 + +# define EVP_PKEY_CTX_set_tls1_prf_md(pctx, md) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_TLS_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_set1_tls1_prf_secret(pctx, sec, seclen) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_TLS_SECRET, seclen, (void *)(sec)) + +# define EVP_PKEY_CTX_add1_tls1_prf_seed(pctx, seed, seedlen) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_TLS_SEED, seedlen, (void *)(seed)) + +# define EVP_PKEY_CTX_set_hkdf_md(pctx, md) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_HKDF_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_set1_hkdf_salt(pctx, salt, saltlen) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_HKDF_SALT, saltlen, (void *)(salt)) + +# define EVP_PKEY_CTX_set1_hkdf_key(pctx, key, keylen) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_HKDF_KEY, keylen, (void *)(key)) + +# define EVP_PKEY_CTX_add1_hkdf_info(pctx, info, infolen) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_HKDF_INFO, infolen, (void *)(info)) + +# define EVP_PKEY_CTX_hkdf_mode(pctx, mode) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_HKDF_MODE, mode, NULL) + +# define EVP_PKEY_CTX_set1_pbe_pass(pctx, pass, passlen) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_PASS, passlen, (void *)(pass)) + +# define EVP_PKEY_CTX_set1_scrypt_salt(pctx, salt, saltlen) \ + EVP_PKEY_CTX_ctrl(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_SCRYPT_SALT, saltlen, (void *)(salt)) + +# define EVP_PKEY_CTX_set_scrypt_N(pctx, n) \ + EVP_PKEY_CTX_ctrl_uint64(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_SCRYPT_N, n) + +# define EVP_PKEY_CTX_set_scrypt_r(pctx, r) \ + EVP_PKEY_CTX_ctrl_uint64(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_SCRYPT_R, r) + +# define EVP_PKEY_CTX_set_scrypt_p(pctx, p) \ + EVP_PKEY_CTX_ctrl_uint64(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_SCRYPT_P, p) + +# define EVP_PKEY_CTX_set_scrypt_maxmem_bytes(pctx, maxmem_bytes) \ + EVP_PKEY_CTX_ctrl_uint64(pctx, -1, EVP_PKEY_OP_DERIVE, \ + EVP_PKEY_CTRL_SCRYPT_MAXMEM_BYTES, maxmem_bytes) + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/kdferr.h b/include/openssl/kdferr.h new file mode 100644 index 0000000..6437c27 --- /dev/null +++ b/include/openssl/kdferr.h @@ -0,0 +1,51 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_KDFERR_H +# define HEADER_KDFERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_KDF_strings(void); + +/* + * KDF function codes. + */ +# define KDF_F_PKEY_HKDF_CTRL_STR 103 +# define KDF_F_PKEY_HKDF_DERIVE 102 +# define KDF_F_PKEY_HKDF_INIT 108 +# define KDF_F_PKEY_SCRYPT_CTRL_STR 104 +# define KDF_F_PKEY_SCRYPT_CTRL_UINT64 105 +# define KDF_F_PKEY_SCRYPT_DERIVE 109 +# define KDF_F_PKEY_SCRYPT_INIT 106 +# define KDF_F_PKEY_SCRYPT_SET_MEMBUF 107 +# define KDF_F_PKEY_TLS1_PRF_CTRL_STR 100 +# define KDF_F_PKEY_TLS1_PRF_DERIVE 101 +# define KDF_F_PKEY_TLS1_PRF_INIT 110 +# define KDF_F_TLS1_PRF_ALG 111 + +/* + * KDF reason codes. + */ +# define KDF_R_INVALID_DIGEST 100 +# define KDF_R_MISSING_ITERATION_COUNT 109 +# define KDF_R_MISSING_KEY 104 +# define KDF_R_MISSING_MESSAGE_DIGEST 105 +# define KDF_R_MISSING_PARAMETER 101 +# define KDF_R_MISSING_PASS 110 +# define KDF_R_MISSING_SALT 111 +# define KDF_R_MISSING_SECRET 107 +# define KDF_R_MISSING_SEED 106 +# define KDF_R_UNKNOWN_PARAMETER_TYPE 103 +# define KDF_R_VALUE_ERROR 108 +# define KDF_R_VALUE_MISSING 102 + +#endif diff --git a/include/openssl/lhash.h b/include/openssl/lhash.h new file mode 100644 index 0000000..7309801 --- /dev/null +++ b/include/openssl/lhash.h @@ -0,0 +1,217 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * Header for dynamic hash table routines Author - Eric Young + */ + +#ifndef HEADER_LHASH_H +# define HEADER_LHASH_H + +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct lhash_node_st OPENSSL_LH_NODE; +typedef int (*OPENSSL_LH_COMPFUNC) (const void *, const void *); +typedef unsigned long (*OPENSSL_LH_HASHFUNC) (const void *); +typedef void (*OPENSSL_LH_DOALL_FUNC) (void *); +typedef void (*OPENSSL_LH_DOALL_FUNCARG) (void *, void *); +typedef struct lhash_st OPENSSL_LHASH; + +/* + * Macros for declaring and implementing type-safe wrappers for LHASH + * callbacks. This way, callbacks can be provided to LHASH structures without + * function pointer casting and the macro-defined callbacks provide + * per-variable casting before deferring to the underlying type-specific + * callbacks. NB: It is possible to place a "static" in front of both the + * DECLARE and IMPLEMENT macros if the functions are strictly internal. + */ + +/* First: "hash" functions */ +# define DECLARE_LHASH_HASH_FN(name, o_type) \ + unsigned long name##_LHASH_HASH(const void *); +# define IMPLEMENT_LHASH_HASH_FN(name, o_type) \ + unsigned long name##_LHASH_HASH(const void *arg) { \ + const o_type *a = arg; \ + return name##_hash(a); } +# define LHASH_HASH_FN(name) name##_LHASH_HASH + +/* Second: "compare" functions */ +# define DECLARE_LHASH_COMP_FN(name, o_type) \ + int name##_LHASH_COMP(const void *, const void *); +# define IMPLEMENT_LHASH_COMP_FN(name, o_type) \ + int name##_LHASH_COMP(const void *arg1, const void *arg2) { \ + const o_type *a = arg1; \ + const o_type *b = arg2; \ + return name##_cmp(a,b); } +# define LHASH_COMP_FN(name) name##_LHASH_COMP + +/* Fourth: "doall_arg" functions */ +# define DECLARE_LHASH_DOALL_ARG_FN(name, o_type, a_type) \ + void name##_LHASH_DOALL_ARG(void *, void *); +# define IMPLEMENT_LHASH_DOALL_ARG_FN(name, o_type, a_type) \ + void name##_LHASH_DOALL_ARG(void *arg1, void *arg2) { \ + o_type *a = arg1; \ + a_type *b = arg2; \ + name##_doall_arg(a, b); } +# define LHASH_DOALL_ARG_FN(name) name##_LHASH_DOALL_ARG + + +# define LH_LOAD_MULT 256 + +int OPENSSL_LH_error(OPENSSL_LHASH *lh); +OPENSSL_LHASH *OPENSSL_LH_new(OPENSSL_LH_HASHFUNC h, OPENSSL_LH_COMPFUNC c); +void OPENSSL_LH_free(OPENSSL_LHASH *lh); +void *OPENSSL_LH_insert(OPENSSL_LHASH *lh, void *data); +void *OPENSSL_LH_delete(OPENSSL_LHASH *lh, const void *data); +void *OPENSSL_LH_retrieve(OPENSSL_LHASH *lh, const void *data); +void OPENSSL_LH_doall(OPENSSL_LHASH *lh, OPENSSL_LH_DOALL_FUNC func); +void OPENSSL_LH_doall_arg(OPENSSL_LHASH *lh, OPENSSL_LH_DOALL_FUNCARG func, void *arg); +unsigned long OPENSSL_LH_strhash(const char *c); +unsigned long OPENSSL_LH_num_items(const OPENSSL_LHASH *lh); +unsigned long OPENSSL_LH_get_down_load(const OPENSSL_LHASH *lh); +void OPENSSL_LH_set_down_load(OPENSSL_LHASH *lh, unsigned long down_load); + +# ifndef OPENSSL_NO_STDIO +void OPENSSL_LH_stats(const OPENSSL_LHASH *lh, FILE *fp); +void OPENSSL_LH_node_stats(const OPENSSL_LHASH *lh, FILE *fp); +void OPENSSL_LH_node_usage_stats(const OPENSSL_LHASH *lh, FILE *fp); +# endif +void OPENSSL_LH_stats_bio(const OPENSSL_LHASH *lh, BIO *out); +void OPENSSL_LH_node_stats_bio(const OPENSSL_LHASH *lh, BIO *out); +void OPENSSL_LH_node_usage_stats_bio(const OPENSSL_LHASH *lh, BIO *out); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define _LHASH OPENSSL_LHASH +# define LHASH_NODE OPENSSL_LH_NODE +# define lh_error OPENSSL_LH_error +# define lh_new OPENSSL_LH_new +# define lh_free OPENSSL_LH_free +# define lh_insert OPENSSL_LH_insert +# define lh_delete OPENSSL_LH_delete +# define lh_retrieve OPENSSL_LH_retrieve +# define lh_doall OPENSSL_LH_doall +# define lh_doall_arg OPENSSL_LH_doall_arg +# define lh_strhash OPENSSL_LH_strhash +# define lh_num_items OPENSSL_LH_num_items +# ifndef OPENSSL_NO_STDIO +# define lh_stats OPENSSL_LH_stats +# define lh_node_stats OPENSSL_LH_node_stats +# define lh_node_usage_stats OPENSSL_LH_node_usage_stats +# endif +# define lh_stats_bio OPENSSL_LH_stats_bio +# define lh_node_stats_bio OPENSSL_LH_node_stats_bio +# define lh_node_usage_stats_bio OPENSSL_LH_node_usage_stats_bio +# endif + +/* Type checking... */ + +# define LHASH_OF(type) struct lhash_st_##type + +# define DEFINE_LHASH_OF(type) \ + LHASH_OF(type) { union lh_##type##_dummy { void* d1; unsigned long d2; int d3; } dummy; }; \ + static ossl_inline LHASH_OF(type) * \ + lh_##type##_new(unsigned long (*hfn)(const type *), \ + int (*cfn)(const type *, const type *)) \ + { \ + return (LHASH_OF(type) *) \ + OPENSSL_LH_new((OPENSSL_LH_HASHFUNC)hfn, (OPENSSL_LH_COMPFUNC)cfn); \ + } \ + static ossl_inline void lh_##type##_free(LHASH_OF(type) *lh) \ + { \ + OPENSSL_LH_free((OPENSSL_LHASH *)lh); \ + } \ + static ossl_inline type *lh_##type##_insert(LHASH_OF(type) *lh, type *d) \ + { \ + return (type *)OPENSSL_LH_insert((OPENSSL_LHASH *)lh, d); \ + } \ + static ossl_inline type *lh_##type##_delete(LHASH_OF(type) *lh, const type *d) \ + { \ + return (type *)OPENSSL_LH_delete((OPENSSL_LHASH *)lh, d); \ + } \ + static ossl_inline type *lh_##type##_retrieve(LHASH_OF(type) *lh, const type *d) \ + { \ + return (type *)OPENSSL_LH_retrieve((OPENSSL_LHASH *)lh, d); \ + } \ + static ossl_inline int lh_##type##_error(LHASH_OF(type) *lh) \ + { \ + return OPENSSL_LH_error((OPENSSL_LHASH *)lh); \ + } \ + static ossl_inline unsigned long lh_##type##_num_items(LHASH_OF(type) *lh) \ + { \ + return OPENSSL_LH_num_items((OPENSSL_LHASH *)lh); \ + } \ + static ossl_inline void lh_##type##_node_stats_bio(const LHASH_OF(type) *lh, BIO *out) \ + { \ + OPENSSL_LH_node_stats_bio((const OPENSSL_LHASH *)lh, out); \ + } \ + static ossl_inline void lh_##type##_node_usage_stats_bio(const LHASH_OF(type) *lh, BIO *out) \ + { \ + OPENSSL_LH_node_usage_stats_bio((const OPENSSL_LHASH *)lh, out); \ + } \ + static ossl_inline void lh_##type##_stats_bio(const LHASH_OF(type) *lh, BIO *out) \ + { \ + OPENSSL_LH_stats_bio((const OPENSSL_LHASH *)lh, out); \ + } \ + static ossl_inline unsigned long lh_##type##_get_down_load(LHASH_OF(type) *lh) \ + { \ + return OPENSSL_LH_get_down_load((OPENSSL_LHASH *)lh); \ + } \ + static ossl_inline void lh_##type##_set_down_load(LHASH_OF(type) *lh, unsigned long dl) \ + { \ + OPENSSL_LH_set_down_load((OPENSSL_LHASH *)lh, dl); \ + } \ + static ossl_inline void lh_##type##_doall(LHASH_OF(type) *lh, \ + void (*doall)(type *)) \ + { \ + OPENSSL_LH_doall((OPENSSL_LHASH *)lh, (OPENSSL_LH_DOALL_FUNC)doall); \ + } \ + LHASH_OF(type) + +#define IMPLEMENT_LHASH_DOALL_ARG_CONST(type, argtype) \ + int_implement_lhash_doall(type, argtype, const type) + +#define IMPLEMENT_LHASH_DOALL_ARG(type, argtype) \ + int_implement_lhash_doall(type, argtype, type) + +#define int_implement_lhash_doall(type, argtype, cbargtype) \ + static ossl_inline void \ + lh_##type##_doall_##argtype(LHASH_OF(type) *lh, \ + void (*fn)(cbargtype *, argtype *), \ + argtype *arg) \ + { \ + OPENSSL_LH_doall_arg((OPENSSL_LHASH *)lh, (OPENSSL_LH_DOALL_FUNCARG)fn, (void *)arg); \ + } \ + LHASH_OF(type) + +DEFINE_LHASH_OF(OPENSSL_STRING); +# ifdef _MSC_VER +/* + * push and pop this warning: + * warning C4090: 'function': different 'const' qualifiers + */ +# pragma warning (push) +# pragma warning (disable: 4090) +# endif + +DEFINE_LHASH_OF(OPENSSL_CSTRING); + +# ifdef _MSC_VER +# pragma warning (pop) +# endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/md2.h b/include/openssl/md2.h new file mode 100644 index 0000000..22ebacd --- /dev/null +++ b/include/openssl/md2.h @@ -0,0 +1,44 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_MD2_H +# define HEADER_MD2_H + +# include + +# ifndef OPENSSL_NO_MD2 +# include +# ifdef __cplusplus +extern "C" { +# endif + +typedef unsigned char MD2_INT; + +# define MD2_DIGEST_LENGTH 16 +# define MD2_BLOCK 16 + +typedef struct MD2state_st { + unsigned int num; + unsigned char data[MD2_BLOCK]; + MD2_INT cksm[MD2_BLOCK]; + MD2_INT state[MD2_BLOCK]; +} MD2_CTX; + +const char *MD2_options(void); +int MD2_Init(MD2_CTX *c); +int MD2_Update(MD2_CTX *c, const unsigned char *data, size_t len); +int MD2_Final(unsigned char *md, MD2_CTX *c); +unsigned char *MD2(const unsigned char *d, size_t n, unsigned char *md); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/md4.h b/include/openssl/md4.h new file mode 100644 index 0000000..0f4921d --- /dev/null +++ b/include/openssl/md4.h @@ -0,0 +1,51 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_MD4_H +# define HEADER_MD4_H + +# include + +# ifndef OPENSSL_NO_MD4 +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +/*- + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + * ! MD4_LONG has to be at least 32 bits wide. ! + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + */ +# define MD4_LONG unsigned int + +# define MD4_CBLOCK 64 +# define MD4_LBLOCK (MD4_CBLOCK/4) +# define MD4_DIGEST_LENGTH 16 + +typedef struct MD4state_st { + MD4_LONG A, B, C, D; + MD4_LONG Nl, Nh; + MD4_LONG data[MD4_LBLOCK]; + unsigned int num; +} MD4_CTX; + +int MD4_Init(MD4_CTX *c); +int MD4_Update(MD4_CTX *c, const void *data, size_t len); +int MD4_Final(unsigned char *md, MD4_CTX *c); +unsigned char *MD4(const unsigned char *d, size_t n, unsigned char *md); +void MD4_Transform(MD4_CTX *c, const unsigned char *b); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/md5.h b/include/openssl/md5.h new file mode 100644 index 0000000..2b924ad --- /dev/null +++ b/include/openssl/md5.h @@ -0,0 +1,50 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_MD5_H +# define HEADER_MD5_H + +# include + +# ifndef OPENSSL_NO_MD5 +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +/* + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + * ! MD5_LONG has to be at least 32 bits wide. ! + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + */ +# define MD5_LONG unsigned int + +# define MD5_CBLOCK 64 +# define MD5_LBLOCK (MD5_CBLOCK/4) +# define MD5_DIGEST_LENGTH 16 + +typedef struct MD5state_st { + MD5_LONG A, B, C, D; + MD5_LONG Nl, Nh; + MD5_LONG data[MD5_LBLOCK]; + unsigned int num; +} MD5_CTX; + +int MD5_Init(MD5_CTX *c); +int MD5_Update(MD5_CTX *c, const void *data, size_t len); +int MD5_Final(unsigned char *md, MD5_CTX *c); +unsigned char *MD5(const unsigned char *d, size_t n, unsigned char *md); +void MD5_Transform(MD5_CTX *c, const unsigned char *b); +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/mdc2.h b/include/openssl/mdc2.h new file mode 100644 index 0000000..f4632e6 --- /dev/null +++ b/include/openssl/mdc2.h @@ -0,0 +1,42 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_MDC2_H +# define HEADER_MDC2_H + +# include + +#ifndef OPENSSL_NO_MDC2 +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +# define MDC2_BLOCK 8 +# define MDC2_DIGEST_LENGTH 16 + +typedef struct mdc2_ctx_st { + unsigned int num; + unsigned char data[MDC2_BLOCK]; + DES_cblock h, hh; + int pad_type; /* either 1 or 2, default 1 */ +} MDC2_CTX; + +int MDC2_Init(MDC2_CTX *c); +int MDC2_Update(MDC2_CTX *c, const unsigned char *data, size_t len); +int MDC2_Final(unsigned char *md, MDC2_CTX *c); +unsigned char *MDC2(const unsigned char *d, size_t n, unsigned char *md); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/modes.h b/include/openssl/modes.h new file mode 100644 index 0000000..d544f98 --- /dev/null +++ b/include/openssl/modes.h @@ -0,0 +1,208 @@ +/* + * Copyright 2008-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_MODES_H +# define HEADER_MODES_H + +# include + +# ifdef __cplusplus +extern "C" { +# endif +typedef void (*block128_f) (const unsigned char in[16], + unsigned char out[16], const void *key); + +typedef void (*cbc128_f) (const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], int enc); + +typedef void (*ctr128_f) (const unsigned char *in, unsigned char *out, + size_t blocks, const void *key, + const unsigned char ivec[16]); + +typedef void (*ccm128_f) (const unsigned char *in, unsigned char *out, + size_t blocks, const void *key, + const unsigned char ivec[16], + unsigned char cmac[16]); + +void CRYPTO_cbc128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], block128_f block); +void CRYPTO_cbc128_decrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], block128_f block); + +void CRYPTO_ctr128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], + unsigned char ecount_buf[16], unsigned int *num, + block128_f block); + +void CRYPTO_ctr128_encrypt_ctr32(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], + unsigned char ecount_buf[16], + unsigned int *num, ctr128_f ctr); + +void CRYPTO_ofb128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], int *num, + block128_f block); + +void CRYPTO_cfb128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], int *num, + int enc, block128_f block); +void CRYPTO_cfb128_8_encrypt(const unsigned char *in, unsigned char *out, + size_t length, const void *key, + unsigned char ivec[16], int *num, + int enc, block128_f block); +void CRYPTO_cfb128_1_encrypt(const unsigned char *in, unsigned char *out, + size_t bits, const void *key, + unsigned char ivec[16], int *num, + int enc, block128_f block); + +size_t CRYPTO_cts128_encrypt_block(const unsigned char *in, + unsigned char *out, size_t len, + const void *key, unsigned char ivec[16], + block128_f block); +size_t CRYPTO_cts128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], cbc128_f cbc); +size_t CRYPTO_cts128_decrypt_block(const unsigned char *in, + unsigned char *out, size_t len, + const void *key, unsigned char ivec[16], + block128_f block); +size_t CRYPTO_cts128_decrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], cbc128_f cbc); + +size_t CRYPTO_nistcts128_encrypt_block(const unsigned char *in, + unsigned char *out, size_t len, + const void *key, + unsigned char ivec[16], + block128_f block); +size_t CRYPTO_nistcts128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], cbc128_f cbc); +size_t CRYPTO_nistcts128_decrypt_block(const unsigned char *in, + unsigned char *out, size_t len, + const void *key, + unsigned char ivec[16], + block128_f block); +size_t CRYPTO_nistcts128_decrypt(const unsigned char *in, unsigned char *out, + size_t len, const void *key, + unsigned char ivec[16], cbc128_f cbc); + +typedef struct gcm128_context GCM128_CONTEXT; + +GCM128_CONTEXT *CRYPTO_gcm128_new(void *key, block128_f block); +void CRYPTO_gcm128_init(GCM128_CONTEXT *ctx, void *key, block128_f block); +void CRYPTO_gcm128_setiv(GCM128_CONTEXT *ctx, const unsigned char *iv, + size_t len); +int CRYPTO_gcm128_aad(GCM128_CONTEXT *ctx, const unsigned char *aad, + size_t len); +int CRYPTO_gcm128_encrypt(GCM128_CONTEXT *ctx, + const unsigned char *in, unsigned char *out, + size_t len); +int CRYPTO_gcm128_decrypt(GCM128_CONTEXT *ctx, + const unsigned char *in, unsigned char *out, + size_t len); +int CRYPTO_gcm128_encrypt_ctr32(GCM128_CONTEXT *ctx, + const unsigned char *in, unsigned char *out, + size_t len, ctr128_f stream); +int CRYPTO_gcm128_decrypt_ctr32(GCM128_CONTEXT *ctx, + const unsigned char *in, unsigned char *out, + size_t len, ctr128_f stream); +int CRYPTO_gcm128_finish(GCM128_CONTEXT *ctx, const unsigned char *tag, + size_t len); +void CRYPTO_gcm128_tag(GCM128_CONTEXT *ctx, unsigned char *tag, size_t len); +void CRYPTO_gcm128_release(GCM128_CONTEXT *ctx); + +typedef struct ccm128_context CCM128_CONTEXT; + +void CRYPTO_ccm128_init(CCM128_CONTEXT *ctx, + unsigned int M, unsigned int L, void *key, + block128_f block); +int CRYPTO_ccm128_setiv(CCM128_CONTEXT *ctx, const unsigned char *nonce, + size_t nlen, size_t mlen); +void CRYPTO_ccm128_aad(CCM128_CONTEXT *ctx, const unsigned char *aad, + size_t alen); +int CRYPTO_ccm128_encrypt(CCM128_CONTEXT *ctx, const unsigned char *inp, + unsigned char *out, size_t len); +int CRYPTO_ccm128_decrypt(CCM128_CONTEXT *ctx, const unsigned char *inp, + unsigned char *out, size_t len); +int CRYPTO_ccm128_encrypt_ccm64(CCM128_CONTEXT *ctx, const unsigned char *inp, + unsigned char *out, size_t len, + ccm128_f stream); +int CRYPTO_ccm128_decrypt_ccm64(CCM128_CONTEXT *ctx, const unsigned char *inp, + unsigned char *out, size_t len, + ccm128_f stream); +size_t CRYPTO_ccm128_tag(CCM128_CONTEXT *ctx, unsigned char *tag, size_t len); + +typedef struct xts128_context XTS128_CONTEXT; + +int CRYPTO_xts128_encrypt(const XTS128_CONTEXT *ctx, + const unsigned char iv[16], + const unsigned char *inp, unsigned char *out, + size_t len, int enc); + +size_t CRYPTO_128_wrap(void *key, const unsigned char *iv, + unsigned char *out, + const unsigned char *in, size_t inlen, + block128_f block); + +size_t CRYPTO_128_unwrap(void *key, const unsigned char *iv, + unsigned char *out, + const unsigned char *in, size_t inlen, + block128_f block); +size_t CRYPTO_128_wrap_pad(void *key, const unsigned char *icv, + unsigned char *out, const unsigned char *in, + size_t inlen, block128_f block); +size_t CRYPTO_128_unwrap_pad(void *key, const unsigned char *icv, + unsigned char *out, const unsigned char *in, + size_t inlen, block128_f block); + +# ifndef OPENSSL_NO_OCB +typedef struct ocb128_context OCB128_CONTEXT; + +typedef void (*ocb128_f) (const unsigned char *in, unsigned char *out, + size_t blocks, const void *key, + size_t start_block_num, + unsigned char offset_i[16], + const unsigned char L_[][16], + unsigned char checksum[16]); + +OCB128_CONTEXT *CRYPTO_ocb128_new(void *keyenc, void *keydec, + block128_f encrypt, block128_f decrypt, + ocb128_f stream); +int CRYPTO_ocb128_init(OCB128_CONTEXT *ctx, void *keyenc, void *keydec, + block128_f encrypt, block128_f decrypt, + ocb128_f stream); +int CRYPTO_ocb128_copy_ctx(OCB128_CONTEXT *dest, OCB128_CONTEXT *src, + void *keyenc, void *keydec); +int CRYPTO_ocb128_setiv(OCB128_CONTEXT *ctx, const unsigned char *iv, + size_t len, size_t taglen); +int CRYPTO_ocb128_aad(OCB128_CONTEXT *ctx, const unsigned char *aad, + size_t len); +int CRYPTO_ocb128_encrypt(OCB128_CONTEXT *ctx, const unsigned char *in, + unsigned char *out, size_t len); +int CRYPTO_ocb128_decrypt(OCB128_CONTEXT *ctx, const unsigned char *in, + unsigned char *out, size_t len); +int CRYPTO_ocb128_finish(OCB128_CONTEXT *ctx, const unsigned char *tag, + size_t len); +int CRYPTO_ocb128_tag(OCB128_CONTEXT *ctx, unsigned char *tag, size_t len); +void CRYPTO_ocb128_cleanup(OCB128_CONTEXT *ctx); +# endif /* OPENSSL_NO_OCB */ + +# ifdef __cplusplus +} +# endif + +#endif diff --git a/include/openssl/obj_mac.h b/include/openssl/obj_mac.h new file mode 100644 index 0000000..80ff5a7 --- /dev/null +++ b/include/openssl/obj_mac.h @@ -0,0 +1,5198 @@ +/* + * WARNING: do not edit! + * Generated by crypto/objects/objects.pl + * + * Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved. + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#define SN_undef "UNDEF" +#define LN_undef "undefined" +#define NID_undef 0 +#define OBJ_undef 0L + +#define SN_itu_t "ITU-T" +#define LN_itu_t "itu-t" +#define NID_itu_t 645 +#define OBJ_itu_t 0L + +#define NID_ccitt 404 +#define OBJ_ccitt OBJ_itu_t + +#define SN_iso "ISO" +#define LN_iso "iso" +#define NID_iso 181 +#define OBJ_iso 1L + +#define SN_joint_iso_itu_t "JOINT-ISO-ITU-T" +#define LN_joint_iso_itu_t "joint-iso-itu-t" +#define NID_joint_iso_itu_t 646 +#define OBJ_joint_iso_itu_t 2L + +#define NID_joint_iso_ccitt 393 +#define OBJ_joint_iso_ccitt OBJ_joint_iso_itu_t + +#define SN_member_body "member-body" +#define LN_member_body "ISO Member Body" +#define NID_member_body 182 +#define OBJ_member_body OBJ_iso,2L + +#define SN_identified_organization "identified-organization" +#define NID_identified_organization 676 +#define OBJ_identified_organization OBJ_iso,3L + +#define SN_hmac_md5 "HMAC-MD5" +#define LN_hmac_md5 "hmac-md5" +#define NID_hmac_md5 780 +#define OBJ_hmac_md5 OBJ_identified_organization,6L,1L,5L,5L,8L,1L,1L + +#define SN_hmac_sha1 "HMAC-SHA1" +#define LN_hmac_sha1 "hmac-sha1" +#define NID_hmac_sha1 781 +#define OBJ_hmac_sha1 OBJ_identified_organization,6L,1L,5L,5L,8L,1L,2L + +#define SN_x509ExtAdmission "x509ExtAdmission" +#define LN_x509ExtAdmission "Professional Information or basis for Admission" +#define NID_x509ExtAdmission 1093 +#define OBJ_x509ExtAdmission OBJ_identified_organization,36L,8L,3L,3L + +#define SN_certicom_arc "certicom-arc" +#define NID_certicom_arc 677 +#define OBJ_certicom_arc OBJ_identified_organization,132L + +#define SN_ieee "ieee" +#define NID_ieee 1170 +#define OBJ_ieee OBJ_identified_organization,111L + +#define SN_ieee_siswg "ieee-siswg" +#define LN_ieee_siswg "IEEE Security in Storage Working Group" +#define NID_ieee_siswg 1171 +#define OBJ_ieee_siswg OBJ_ieee,2L,1619L + +#define SN_international_organizations "international-organizations" +#define LN_international_organizations "International Organizations" +#define NID_international_organizations 647 +#define OBJ_international_organizations OBJ_joint_iso_itu_t,23L + +#define SN_wap "wap" +#define NID_wap 678 +#define OBJ_wap OBJ_international_organizations,43L + +#define SN_wap_wsg "wap-wsg" +#define NID_wap_wsg 679 +#define OBJ_wap_wsg OBJ_wap,1L + +#define SN_selected_attribute_types "selected-attribute-types" +#define LN_selected_attribute_types "Selected Attribute Types" +#define NID_selected_attribute_types 394 +#define OBJ_selected_attribute_types OBJ_joint_iso_itu_t,5L,1L,5L + +#define SN_clearance "clearance" +#define NID_clearance 395 +#define OBJ_clearance OBJ_selected_attribute_types,55L + +#define SN_ISO_US "ISO-US" +#define LN_ISO_US "ISO US Member Body" +#define NID_ISO_US 183 +#define OBJ_ISO_US OBJ_member_body,840L + +#define SN_X9_57 "X9-57" +#define LN_X9_57 "X9.57" +#define NID_X9_57 184 +#define OBJ_X9_57 OBJ_ISO_US,10040L + +#define SN_X9cm "X9cm" +#define LN_X9cm "X9.57 CM ?" +#define NID_X9cm 185 +#define OBJ_X9cm OBJ_X9_57,4L + +#define SN_ISO_CN "ISO-CN" +#define LN_ISO_CN "ISO CN Member Body" +#define NID_ISO_CN 1140 +#define OBJ_ISO_CN OBJ_member_body,156L + +#define SN_oscca "oscca" +#define NID_oscca 1141 +#define OBJ_oscca OBJ_ISO_CN,10197L + +#define SN_sm_scheme "sm-scheme" +#define NID_sm_scheme 1142 +#define OBJ_sm_scheme OBJ_oscca,1L + +#define SN_dsa "DSA" +#define LN_dsa "dsaEncryption" +#define NID_dsa 116 +#define OBJ_dsa OBJ_X9cm,1L + +#define SN_dsaWithSHA1 "DSA-SHA1" +#define LN_dsaWithSHA1 "dsaWithSHA1" +#define NID_dsaWithSHA1 113 +#define OBJ_dsaWithSHA1 OBJ_X9cm,3L + +#define SN_ansi_X9_62 "ansi-X9-62" +#define LN_ansi_X9_62 "ANSI X9.62" +#define NID_ansi_X9_62 405 +#define OBJ_ansi_X9_62 OBJ_ISO_US,10045L + +#define OBJ_X9_62_id_fieldType OBJ_ansi_X9_62,1L + +#define SN_X9_62_prime_field "prime-field" +#define NID_X9_62_prime_field 406 +#define OBJ_X9_62_prime_field OBJ_X9_62_id_fieldType,1L + +#define SN_X9_62_characteristic_two_field "characteristic-two-field" +#define NID_X9_62_characteristic_two_field 407 +#define OBJ_X9_62_characteristic_two_field OBJ_X9_62_id_fieldType,2L + +#define SN_X9_62_id_characteristic_two_basis "id-characteristic-two-basis" +#define NID_X9_62_id_characteristic_two_basis 680 +#define OBJ_X9_62_id_characteristic_two_basis OBJ_X9_62_characteristic_two_field,3L + +#define SN_X9_62_onBasis "onBasis" +#define NID_X9_62_onBasis 681 +#define OBJ_X9_62_onBasis OBJ_X9_62_id_characteristic_two_basis,1L + +#define SN_X9_62_tpBasis "tpBasis" +#define NID_X9_62_tpBasis 682 +#define OBJ_X9_62_tpBasis OBJ_X9_62_id_characteristic_two_basis,2L + +#define SN_X9_62_ppBasis "ppBasis" +#define NID_X9_62_ppBasis 683 +#define OBJ_X9_62_ppBasis OBJ_X9_62_id_characteristic_two_basis,3L + +#define OBJ_X9_62_id_publicKeyType OBJ_ansi_X9_62,2L + +#define SN_X9_62_id_ecPublicKey "id-ecPublicKey" +#define NID_X9_62_id_ecPublicKey 408 +#define OBJ_X9_62_id_ecPublicKey OBJ_X9_62_id_publicKeyType,1L + +#define OBJ_X9_62_ellipticCurve OBJ_ansi_X9_62,3L + +#define OBJ_X9_62_c_TwoCurve OBJ_X9_62_ellipticCurve,0L + +#define SN_X9_62_c2pnb163v1 "c2pnb163v1" +#define NID_X9_62_c2pnb163v1 684 +#define OBJ_X9_62_c2pnb163v1 OBJ_X9_62_c_TwoCurve,1L + +#define SN_X9_62_c2pnb163v2 "c2pnb163v2" +#define NID_X9_62_c2pnb163v2 685 +#define OBJ_X9_62_c2pnb163v2 OBJ_X9_62_c_TwoCurve,2L + +#define SN_X9_62_c2pnb163v3 "c2pnb163v3" +#define NID_X9_62_c2pnb163v3 686 +#define OBJ_X9_62_c2pnb163v3 OBJ_X9_62_c_TwoCurve,3L + +#define SN_X9_62_c2pnb176v1 "c2pnb176v1" +#define NID_X9_62_c2pnb176v1 687 +#define OBJ_X9_62_c2pnb176v1 OBJ_X9_62_c_TwoCurve,4L + +#define SN_X9_62_c2tnb191v1 "c2tnb191v1" +#define NID_X9_62_c2tnb191v1 688 +#define OBJ_X9_62_c2tnb191v1 OBJ_X9_62_c_TwoCurve,5L + +#define SN_X9_62_c2tnb191v2 "c2tnb191v2" +#define NID_X9_62_c2tnb191v2 689 +#define OBJ_X9_62_c2tnb191v2 OBJ_X9_62_c_TwoCurve,6L + +#define SN_X9_62_c2tnb191v3 "c2tnb191v3" +#define NID_X9_62_c2tnb191v3 690 +#define OBJ_X9_62_c2tnb191v3 OBJ_X9_62_c_TwoCurve,7L + +#define SN_X9_62_c2onb191v4 "c2onb191v4" +#define NID_X9_62_c2onb191v4 691 +#define OBJ_X9_62_c2onb191v4 OBJ_X9_62_c_TwoCurve,8L + +#define SN_X9_62_c2onb191v5 "c2onb191v5" +#define NID_X9_62_c2onb191v5 692 +#define OBJ_X9_62_c2onb191v5 OBJ_X9_62_c_TwoCurve,9L + +#define SN_X9_62_c2pnb208w1 "c2pnb208w1" +#define NID_X9_62_c2pnb208w1 693 +#define OBJ_X9_62_c2pnb208w1 OBJ_X9_62_c_TwoCurve,10L + +#define SN_X9_62_c2tnb239v1 "c2tnb239v1" +#define NID_X9_62_c2tnb239v1 694 +#define OBJ_X9_62_c2tnb239v1 OBJ_X9_62_c_TwoCurve,11L + +#define SN_X9_62_c2tnb239v2 "c2tnb239v2" +#define NID_X9_62_c2tnb239v2 695 +#define OBJ_X9_62_c2tnb239v2 OBJ_X9_62_c_TwoCurve,12L + +#define SN_X9_62_c2tnb239v3 "c2tnb239v3" +#define NID_X9_62_c2tnb239v3 696 +#define OBJ_X9_62_c2tnb239v3 OBJ_X9_62_c_TwoCurve,13L + +#define SN_X9_62_c2onb239v4 "c2onb239v4" +#define NID_X9_62_c2onb239v4 697 +#define OBJ_X9_62_c2onb239v4 OBJ_X9_62_c_TwoCurve,14L + +#define SN_X9_62_c2onb239v5 "c2onb239v5" +#define NID_X9_62_c2onb239v5 698 +#define OBJ_X9_62_c2onb239v5 OBJ_X9_62_c_TwoCurve,15L + +#define SN_X9_62_c2pnb272w1 "c2pnb272w1" +#define NID_X9_62_c2pnb272w1 699 +#define OBJ_X9_62_c2pnb272w1 OBJ_X9_62_c_TwoCurve,16L + +#define SN_X9_62_c2pnb304w1 "c2pnb304w1" +#define NID_X9_62_c2pnb304w1 700 +#define OBJ_X9_62_c2pnb304w1 OBJ_X9_62_c_TwoCurve,17L + +#define SN_X9_62_c2tnb359v1 "c2tnb359v1" +#define NID_X9_62_c2tnb359v1 701 +#define OBJ_X9_62_c2tnb359v1 OBJ_X9_62_c_TwoCurve,18L + +#define SN_X9_62_c2pnb368w1 "c2pnb368w1" +#define NID_X9_62_c2pnb368w1 702 +#define OBJ_X9_62_c2pnb368w1 OBJ_X9_62_c_TwoCurve,19L + +#define SN_X9_62_c2tnb431r1 "c2tnb431r1" +#define NID_X9_62_c2tnb431r1 703 +#define OBJ_X9_62_c2tnb431r1 OBJ_X9_62_c_TwoCurve,20L + +#define OBJ_X9_62_primeCurve OBJ_X9_62_ellipticCurve,1L + +#define SN_X9_62_prime192v1 "prime192v1" +#define NID_X9_62_prime192v1 409 +#define OBJ_X9_62_prime192v1 OBJ_X9_62_primeCurve,1L + +#define SN_X9_62_prime192v2 "prime192v2" +#define NID_X9_62_prime192v2 410 +#define OBJ_X9_62_prime192v2 OBJ_X9_62_primeCurve,2L + +#define SN_X9_62_prime192v3 "prime192v3" +#define NID_X9_62_prime192v3 411 +#define OBJ_X9_62_prime192v3 OBJ_X9_62_primeCurve,3L + +#define SN_X9_62_prime239v1 "prime239v1" +#define NID_X9_62_prime239v1 412 +#define OBJ_X9_62_prime239v1 OBJ_X9_62_primeCurve,4L + +#define SN_X9_62_prime239v2 "prime239v2" +#define NID_X9_62_prime239v2 413 +#define OBJ_X9_62_prime239v2 OBJ_X9_62_primeCurve,5L + +#define SN_X9_62_prime239v3 "prime239v3" +#define NID_X9_62_prime239v3 414 +#define OBJ_X9_62_prime239v3 OBJ_X9_62_primeCurve,6L + +#define SN_X9_62_prime256v1 "prime256v1" +#define NID_X9_62_prime256v1 415 +#define OBJ_X9_62_prime256v1 OBJ_X9_62_primeCurve,7L + +#define OBJ_X9_62_id_ecSigType OBJ_ansi_X9_62,4L + +#define SN_ecdsa_with_SHA1 "ecdsa-with-SHA1" +#define NID_ecdsa_with_SHA1 416 +#define OBJ_ecdsa_with_SHA1 OBJ_X9_62_id_ecSigType,1L + +#define SN_ecdsa_with_Recommended "ecdsa-with-Recommended" +#define NID_ecdsa_with_Recommended 791 +#define OBJ_ecdsa_with_Recommended OBJ_X9_62_id_ecSigType,2L + +#define SN_ecdsa_with_Specified "ecdsa-with-Specified" +#define NID_ecdsa_with_Specified 792 +#define OBJ_ecdsa_with_Specified OBJ_X9_62_id_ecSigType,3L + +#define SN_ecdsa_with_SHA224 "ecdsa-with-SHA224" +#define NID_ecdsa_with_SHA224 793 +#define OBJ_ecdsa_with_SHA224 OBJ_ecdsa_with_Specified,1L + +#define SN_ecdsa_with_SHA256 "ecdsa-with-SHA256" +#define NID_ecdsa_with_SHA256 794 +#define OBJ_ecdsa_with_SHA256 OBJ_ecdsa_with_Specified,2L + +#define SN_ecdsa_with_SHA384 "ecdsa-with-SHA384" +#define NID_ecdsa_with_SHA384 795 +#define OBJ_ecdsa_with_SHA384 OBJ_ecdsa_with_Specified,3L + +#define SN_ecdsa_with_SHA512 "ecdsa-with-SHA512" +#define NID_ecdsa_with_SHA512 796 +#define OBJ_ecdsa_with_SHA512 OBJ_ecdsa_with_Specified,4L + +#define OBJ_secg_ellipticCurve OBJ_certicom_arc,0L + +#define SN_secp112r1 "secp112r1" +#define NID_secp112r1 704 +#define OBJ_secp112r1 OBJ_secg_ellipticCurve,6L + +#define SN_secp112r2 "secp112r2" +#define NID_secp112r2 705 +#define OBJ_secp112r2 OBJ_secg_ellipticCurve,7L + +#define SN_secp128r1 "secp128r1" +#define NID_secp128r1 706 +#define OBJ_secp128r1 OBJ_secg_ellipticCurve,28L + +#define SN_secp128r2 "secp128r2" +#define NID_secp128r2 707 +#define OBJ_secp128r2 OBJ_secg_ellipticCurve,29L + +#define SN_secp160k1 "secp160k1" +#define NID_secp160k1 708 +#define OBJ_secp160k1 OBJ_secg_ellipticCurve,9L + +#define SN_secp160r1 "secp160r1" +#define NID_secp160r1 709 +#define OBJ_secp160r1 OBJ_secg_ellipticCurve,8L + +#define SN_secp160r2 "secp160r2" +#define NID_secp160r2 710 +#define OBJ_secp160r2 OBJ_secg_ellipticCurve,30L + +#define SN_secp192k1 "secp192k1" +#define NID_secp192k1 711 +#define OBJ_secp192k1 OBJ_secg_ellipticCurve,31L + +#define SN_secp224k1 "secp224k1" +#define NID_secp224k1 712 +#define OBJ_secp224k1 OBJ_secg_ellipticCurve,32L + +#define SN_secp224r1 "secp224r1" +#define NID_secp224r1 713 +#define OBJ_secp224r1 OBJ_secg_ellipticCurve,33L + +#define SN_secp256k1 "secp256k1" +#define NID_secp256k1 714 +#define OBJ_secp256k1 OBJ_secg_ellipticCurve,10L + +#define SN_secp384r1 "secp384r1" +#define NID_secp384r1 715 +#define OBJ_secp384r1 OBJ_secg_ellipticCurve,34L + +#define SN_secp521r1 "secp521r1" +#define NID_secp521r1 716 +#define OBJ_secp521r1 OBJ_secg_ellipticCurve,35L + +#define SN_sect113r1 "sect113r1" +#define NID_sect113r1 717 +#define OBJ_sect113r1 OBJ_secg_ellipticCurve,4L + +#define SN_sect113r2 "sect113r2" +#define NID_sect113r2 718 +#define OBJ_sect113r2 OBJ_secg_ellipticCurve,5L + +#define SN_sect131r1 "sect131r1" +#define NID_sect131r1 719 +#define OBJ_sect131r1 OBJ_secg_ellipticCurve,22L + +#define SN_sect131r2 "sect131r2" +#define NID_sect131r2 720 +#define OBJ_sect131r2 OBJ_secg_ellipticCurve,23L + +#define SN_sect163k1 "sect163k1" +#define NID_sect163k1 721 +#define OBJ_sect163k1 OBJ_secg_ellipticCurve,1L + +#define SN_sect163r1 "sect163r1" +#define NID_sect163r1 722 +#define OBJ_sect163r1 OBJ_secg_ellipticCurve,2L + +#define SN_sect163r2 "sect163r2" +#define NID_sect163r2 723 +#define OBJ_sect163r2 OBJ_secg_ellipticCurve,15L + +#define SN_sect193r1 "sect193r1" +#define NID_sect193r1 724 +#define OBJ_sect193r1 OBJ_secg_ellipticCurve,24L + +#define SN_sect193r2 "sect193r2" +#define NID_sect193r2 725 +#define OBJ_sect193r2 OBJ_secg_ellipticCurve,25L + +#define SN_sect233k1 "sect233k1" +#define NID_sect233k1 726 +#define OBJ_sect233k1 OBJ_secg_ellipticCurve,26L + +#define SN_sect233r1 "sect233r1" +#define NID_sect233r1 727 +#define OBJ_sect233r1 OBJ_secg_ellipticCurve,27L + +#define SN_sect239k1 "sect239k1" +#define NID_sect239k1 728 +#define OBJ_sect239k1 OBJ_secg_ellipticCurve,3L + +#define SN_sect283k1 "sect283k1" +#define NID_sect283k1 729 +#define OBJ_sect283k1 OBJ_secg_ellipticCurve,16L + +#define SN_sect283r1 "sect283r1" +#define NID_sect283r1 730 +#define OBJ_sect283r1 OBJ_secg_ellipticCurve,17L + +#define SN_sect409k1 "sect409k1" +#define NID_sect409k1 731 +#define OBJ_sect409k1 OBJ_secg_ellipticCurve,36L + +#define SN_sect409r1 "sect409r1" +#define NID_sect409r1 732 +#define OBJ_sect409r1 OBJ_secg_ellipticCurve,37L + +#define SN_sect571k1 "sect571k1" +#define NID_sect571k1 733 +#define OBJ_sect571k1 OBJ_secg_ellipticCurve,38L + +#define SN_sect571r1 "sect571r1" +#define NID_sect571r1 734 +#define OBJ_sect571r1 OBJ_secg_ellipticCurve,39L + +#define OBJ_wap_wsg_idm_ecid OBJ_wap_wsg,4L + +#define SN_wap_wsg_idm_ecid_wtls1 "wap-wsg-idm-ecid-wtls1" +#define NID_wap_wsg_idm_ecid_wtls1 735 +#define OBJ_wap_wsg_idm_ecid_wtls1 OBJ_wap_wsg_idm_ecid,1L + +#define SN_wap_wsg_idm_ecid_wtls3 "wap-wsg-idm-ecid-wtls3" +#define NID_wap_wsg_idm_ecid_wtls3 736 +#define OBJ_wap_wsg_idm_ecid_wtls3 OBJ_wap_wsg_idm_ecid,3L + +#define SN_wap_wsg_idm_ecid_wtls4 "wap-wsg-idm-ecid-wtls4" +#define NID_wap_wsg_idm_ecid_wtls4 737 +#define OBJ_wap_wsg_idm_ecid_wtls4 OBJ_wap_wsg_idm_ecid,4L + +#define SN_wap_wsg_idm_ecid_wtls5 "wap-wsg-idm-ecid-wtls5" +#define NID_wap_wsg_idm_ecid_wtls5 738 +#define OBJ_wap_wsg_idm_ecid_wtls5 OBJ_wap_wsg_idm_ecid,5L + +#define SN_wap_wsg_idm_ecid_wtls6 "wap-wsg-idm-ecid-wtls6" +#define NID_wap_wsg_idm_ecid_wtls6 739 +#define OBJ_wap_wsg_idm_ecid_wtls6 OBJ_wap_wsg_idm_ecid,6L + +#define SN_wap_wsg_idm_ecid_wtls7 "wap-wsg-idm-ecid-wtls7" +#define NID_wap_wsg_idm_ecid_wtls7 740 +#define OBJ_wap_wsg_idm_ecid_wtls7 OBJ_wap_wsg_idm_ecid,7L + +#define SN_wap_wsg_idm_ecid_wtls8 "wap-wsg-idm-ecid-wtls8" +#define NID_wap_wsg_idm_ecid_wtls8 741 +#define OBJ_wap_wsg_idm_ecid_wtls8 OBJ_wap_wsg_idm_ecid,8L + +#define SN_wap_wsg_idm_ecid_wtls9 "wap-wsg-idm-ecid-wtls9" +#define NID_wap_wsg_idm_ecid_wtls9 742 +#define OBJ_wap_wsg_idm_ecid_wtls9 OBJ_wap_wsg_idm_ecid,9L + +#define SN_wap_wsg_idm_ecid_wtls10 "wap-wsg-idm-ecid-wtls10" +#define NID_wap_wsg_idm_ecid_wtls10 743 +#define OBJ_wap_wsg_idm_ecid_wtls10 OBJ_wap_wsg_idm_ecid,10L + +#define SN_wap_wsg_idm_ecid_wtls11 "wap-wsg-idm-ecid-wtls11" +#define NID_wap_wsg_idm_ecid_wtls11 744 +#define OBJ_wap_wsg_idm_ecid_wtls11 OBJ_wap_wsg_idm_ecid,11L + +#define SN_wap_wsg_idm_ecid_wtls12 "wap-wsg-idm-ecid-wtls12" +#define NID_wap_wsg_idm_ecid_wtls12 745 +#define OBJ_wap_wsg_idm_ecid_wtls12 OBJ_wap_wsg_idm_ecid,12L + +#define SN_cast5_cbc "CAST5-CBC" +#define LN_cast5_cbc "cast5-cbc" +#define NID_cast5_cbc 108 +#define OBJ_cast5_cbc OBJ_ISO_US,113533L,7L,66L,10L + +#define SN_cast5_ecb "CAST5-ECB" +#define LN_cast5_ecb "cast5-ecb" +#define NID_cast5_ecb 109 + +#define SN_cast5_cfb64 "CAST5-CFB" +#define LN_cast5_cfb64 "cast5-cfb" +#define NID_cast5_cfb64 110 + +#define SN_cast5_ofb64 "CAST5-OFB" +#define LN_cast5_ofb64 "cast5-ofb" +#define NID_cast5_ofb64 111 + +#define LN_pbeWithMD5AndCast5_CBC "pbeWithMD5AndCast5CBC" +#define NID_pbeWithMD5AndCast5_CBC 112 +#define OBJ_pbeWithMD5AndCast5_CBC OBJ_ISO_US,113533L,7L,66L,12L + +#define SN_id_PasswordBasedMAC "id-PasswordBasedMAC" +#define LN_id_PasswordBasedMAC "password based MAC" +#define NID_id_PasswordBasedMAC 782 +#define OBJ_id_PasswordBasedMAC OBJ_ISO_US,113533L,7L,66L,13L + +#define SN_id_DHBasedMac "id-DHBasedMac" +#define LN_id_DHBasedMac "Diffie-Hellman based MAC" +#define NID_id_DHBasedMac 783 +#define OBJ_id_DHBasedMac OBJ_ISO_US,113533L,7L,66L,30L + +#define SN_rsadsi "rsadsi" +#define LN_rsadsi "RSA Data Security, Inc." +#define NID_rsadsi 1 +#define OBJ_rsadsi OBJ_ISO_US,113549L + +#define SN_pkcs "pkcs" +#define LN_pkcs "RSA Data Security, Inc. PKCS" +#define NID_pkcs 2 +#define OBJ_pkcs OBJ_rsadsi,1L + +#define SN_pkcs1 "pkcs1" +#define NID_pkcs1 186 +#define OBJ_pkcs1 OBJ_pkcs,1L + +#define LN_rsaEncryption "rsaEncryption" +#define NID_rsaEncryption 6 +#define OBJ_rsaEncryption OBJ_pkcs1,1L + +#define SN_md2WithRSAEncryption "RSA-MD2" +#define LN_md2WithRSAEncryption "md2WithRSAEncryption" +#define NID_md2WithRSAEncryption 7 +#define OBJ_md2WithRSAEncryption OBJ_pkcs1,2L + +#define SN_md4WithRSAEncryption "RSA-MD4" +#define LN_md4WithRSAEncryption "md4WithRSAEncryption" +#define NID_md4WithRSAEncryption 396 +#define OBJ_md4WithRSAEncryption OBJ_pkcs1,3L + +#define SN_md5WithRSAEncryption "RSA-MD5" +#define LN_md5WithRSAEncryption "md5WithRSAEncryption" +#define NID_md5WithRSAEncryption 8 +#define OBJ_md5WithRSAEncryption OBJ_pkcs1,4L + +#define SN_sha1WithRSAEncryption "RSA-SHA1" +#define LN_sha1WithRSAEncryption "sha1WithRSAEncryption" +#define NID_sha1WithRSAEncryption 65 +#define OBJ_sha1WithRSAEncryption OBJ_pkcs1,5L + +#define SN_rsaesOaep "RSAES-OAEP" +#define LN_rsaesOaep "rsaesOaep" +#define NID_rsaesOaep 919 +#define OBJ_rsaesOaep OBJ_pkcs1,7L + +#define SN_mgf1 "MGF1" +#define LN_mgf1 "mgf1" +#define NID_mgf1 911 +#define OBJ_mgf1 OBJ_pkcs1,8L + +#define SN_pSpecified "PSPECIFIED" +#define LN_pSpecified "pSpecified" +#define NID_pSpecified 935 +#define OBJ_pSpecified OBJ_pkcs1,9L + +#define SN_rsassaPss "RSASSA-PSS" +#define LN_rsassaPss "rsassaPss" +#define NID_rsassaPss 912 +#define OBJ_rsassaPss OBJ_pkcs1,10L + +#define SN_sha256WithRSAEncryption "RSA-SHA256" +#define LN_sha256WithRSAEncryption "sha256WithRSAEncryption" +#define NID_sha256WithRSAEncryption 668 +#define OBJ_sha256WithRSAEncryption OBJ_pkcs1,11L + +#define SN_sha384WithRSAEncryption "RSA-SHA384" +#define LN_sha384WithRSAEncryption "sha384WithRSAEncryption" +#define NID_sha384WithRSAEncryption 669 +#define OBJ_sha384WithRSAEncryption OBJ_pkcs1,12L + +#define SN_sha512WithRSAEncryption "RSA-SHA512" +#define LN_sha512WithRSAEncryption "sha512WithRSAEncryption" +#define NID_sha512WithRSAEncryption 670 +#define OBJ_sha512WithRSAEncryption OBJ_pkcs1,13L + +#define SN_sha224WithRSAEncryption "RSA-SHA224" +#define LN_sha224WithRSAEncryption "sha224WithRSAEncryption" +#define NID_sha224WithRSAEncryption 671 +#define OBJ_sha224WithRSAEncryption OBJ_pkcs1,14L + +#define SN_sha512_224WithRSAEncryption "RSA-SHA512/224" +#define LN_sha512_224WithRSAEncryption "sha512-224WithRSAEncryption" +#define NID_sha512_224WithRSAEncryption 1145 +#define OBJ_sha512_224WithRSAEncryption OBJ_pkcs1,15L + +#define SN_sha512_256WithRSAEncryption "RSA-SHA512/256" +#define LN_sha512_256WithRSAEncryption "sha512-256WithRSAEncryption" +#define NID_sha512_256WithRSAEncryption 1146 +#define OBJ_sha512_256WithRSAEncryption OBJ_pkcs1,16L + +#define SN_pkcs3 "pkcs3" +#define NID_pkcs3 27 +#define OBJ_pkcs3 OBJ_pkcs,3L + +#define LN_dhKeyAgreement "dhKeyAgreement" +#define NID_dhKeyAgreement 28 +#define OBJ_dhKeyAgreement OBJ_pkcs3,1L + +#define SN_pkcs5 "pkcs5" +#define NID_pkcs5 187 +#define OBJ_pkcs5 OBJ_pkcs,5L + +#define SN_pbeWithMD2AndDES_CBC "PBE-MD2-DES" +#define LN_pbeWithMD2AndDES_CBC "pbeWithMD2AndDES-CBC" +#define NID_pbeWithMD2AndDES_CBC 9 +#define OBJ_pbeWithMD2AndDES_CBC OBJ_pkcs5,1L + +#define SN_pbeWithMD5AndDES_CBC "PBE-MD5-DES" +#define LN_pbeWithMD5AndDES_CBC "pbeWithMD5AndDES-CBC" +#define NID_pbeWithMD5AndDES_CBC 10 +#define OBJ_pbeWithMD5AndDES_CBC OBJ_pkcs5,3L + +#define SN_pbeWithMD2AndRC2_CBC "PBE-MD2-RC2-64" +#define LN_pbeWithMD2AndRC2_CBC "pbeWithMD2AndRC2-CBC" +#define NID_pbeWithMD2AndRC2_CBC 168 +#define OBJ_pbeWithMD2AndRC2_CBC OBJ_pkcs5,4L + +#define SN_pbeWithMD5AndRC2_CBC "PBE-MD5-RC2-64" +#define LN_pbeWithMD5AndRC2_CBC "pbeWithMD5AndRC2-CBC" +#define NID_pbeWithMD5AndRC2_CBC 169 +#define OBJ_pbeWithMD5AndRC2_CBC OBJ_pkcs5,6L + +#define SN_pbeWithSHA1AndDES_CBC "PBE-SHA1-DES" +#define LN_pbeWithSHA1AndDES_CBC "pbeWithSHA1AndDES-CBC" +#define NID_pbeWithSHA1AndDES_CBC 170 +#define OBJ_pbeWithSHA1AndDES_CBC OBJ_pkcs5,10L + +#define SN_pbeWithSHA1AndRC2_CBC "PBE-SHA1-RC2-64" +#define LN_pbeWithSHA1AndRC2_CBC "pbeWithSHA1AndRC2-CBC" +#define NID_pbeWithSHA1AndRC2_CBC 68 +#define OBJ_pbeWithSHA1AndRC2_CBC OBJ_pkcs5,11L + +#define LN_id_pbkdf2 "PBKDF2" +#define NID_id_pbkdf2 69 +#define OBJ_id_pbkdf2 OBJ_pkcs5,12L + +#define LN_pbes2 "PBES2" +#define NID_pbes2 161 +#define OBJ_pbes2 OBJ_pkcs5,13L + +#define LN_pbmac1 "PBMAC1" +#define NID_pbmac1 162 +#define OBJ_pbmac1 OBJ_pkcs5,14L + +#define SN_pkcs7 "pkcs7" +#define NID_pkcs7 20 +#define OBJ_pkcs7 OBJ_pkcs,7L + +#define LN_pkcs7_data "pkcs7-data" +#define NID_pkcs7_data 21 +#define OBJ_pkcs7_data OBJ_pkcs7,1L + +#define LN_pkcs7_signed "pkcs7-signedData" +#define NID_pkcs7_signed 22 +#define OBJ_pkcs7_signed OBJ_pkcs7,2L + +#define LN_pkcs7_enveloped "pkcs7-envelopedData" +#define NID_pkcs7_enveloped 23 +#define OBJ_pkcs7_enveloped OBJ_pkcs7,3L + +#define LN_pkcs7_signedAndEnveloped "pkcs7-signedAndEnvelopedData" +#define NID_pkcs7_signedAndEnveloped 24 +#define OBJ_pkcs7_signedAndEnveloped OBJ_pkcs7,4L + +#define LN_pkcs7_digest "pkcs7-digestData" +#define NID_pkcs7_digest 25 +#define OBJ_pkcs7_digest OBJ_pkcs7,5L + +#define LN_pkcs7_encrypted "pkcs7-encryptedData" +#define NID_pkcs7_encrypted 26 +#define OBJ_pkcs7_encrypted OBJ_pkcs7,6L + +#define SN_pkcs9 "pkcs9" +#define NID_pkcs9 47 +#define OBJ_pkcs9 OBJ_pkcs,9L + +#define LN_pkcs9_emailAddress "emailAddress" +#define NID_pkcs9_emailAddress 48 +#define OBJ_pkcs9_emailAddress OBJ_pkcs9,1L + +#define LN_pkcs9_unstructuredName "unstructuredName" +#define NID_pkcs9_unstructuredName 49 +#define OBJ_pkcs9_unstructuredName OBJ_pkcs9,2L + +#define LN_pkcs9_contentType "contentType" +#define NID_pkcs9_contentType 50 +#define OBJ_pkcs9_contentType OBJ_pkcs9,3L + +#define LN_pkcs9_messageDigest "messageDigest" +#define NID_pkcs9_messageDigest 51 +#define OBJ_pkcs9_messageDigest OBJ_pkcs9,4L + +#define LN_pkcs9_signingTime "signingTime" +#define NID_pkcs9_signingTime 52 +#define OBJ_pkcs9_signingTime OBJ_pkcs9,5L + +#define LN_pkcs9_countersignature "countersignature" +#define NID_pkcs9_countersignature 53 +#define OBJ_pkcs9_countersignature OBJ_pkcs9,6L + +#define LN_pkcs9_challengePassword "challengePassword" +#define NID_pkcs9_challengePassword 54 +#define OBJ_pkcs9_challengePassword OBJ_pkcs9,7L + +#define LN_pkcs9_unstructuredAddress "unstructuredAddress" +#define NID_pkcs9_unstructuredAddress 55 +#define OBJ_pkcs9_unstructuredAddress OBJ_pkcs9,8L + +#define LN_pkcs9_extCertAttributes "extendedCertificateAttributes" +#define NID_pkcs9_extCertAttributes 56 +#define OBJ_pkcs9_extCertAttributes OBJ_pkcs9,9L + +#define SN_ext_req "extReq" +#define LN_ext_req "Extension Request" +#define NID_ext_req 172 +#define OBJ_ext_req OBJ_pkcs9,14L + +#define SN_SMIMECapabilities "SMIME-CAPS" +#define LN_SMIMECapabilities "S/MIME Capabilities" +#define NID_SMIMECapabilities 167 +#define OBJ_SMIMECapabilities OBJ_pkcs9,15L + +#define SN_SMIME "SMIME" +#define LN_SMIME "S/MIME" +#define NID_SMIME 188 +#define OBJ_SMIME OBJ_pkcs9,16L + +#define SN_id_smime_mod "id-smime-mod" +#define NID_id_smime_mod 189 +#define OBJ_id_smime_mod OBJ_SMIME,0L + +#define SN_id_smime_ct "id-smime-ct" +#define NID_id_smime_ct 190 +#define OBJ_id_smime_ct OBJ_SMIME,1L + +#define SN_id_smime_aa "id-smime-aa" +#define NID_id_smime_aa 191 +#define OBJ_id_smime_aa OBJ_SMIME,2L + +#define SN_id_smime_alg "id-smime-alg" +#define NID_id_smime_alg 192 +#define OBJ_id_smime_alg OBJ_SMIME,3L + +#define SN_id_smime_cd "id-smime-cd" +#define NID_id_smime_cd 193 +#define OBJ_id_smime_cd OBJ_SMIME,4L + +#define SN_id_smime_spq "id-smime-spq" +#define NID_id_smime_spq 194 +#define OBJ_id_smime_spq OBJ_SMIME,5L + +#define SN_id_smime_cti "id-smime-cti" +#define NID_id_smime_cti 195 +#define OBJ_id_smime_cti OBJ_SMIME,6L + +#define SN_id_smime_mod_cms "id-smime-mod-cms" +#define NID_id_smime_mod_cms 196 +#define OBJ_id_smime_mod_cms OBJ_id_smime_mod,1L + +#define SN_id_smime_mod_ess "id-smime-mod-ess" +#define NID_id_smime_mod_ess 197 +#define OBJ_id_smime_mod_ess OBJ_id_smime_mod,2L + +#define SN_id_smime_mod_oid "id-smime-mod-oid" +#define NID_id_smime_mod_oid 198 +#define OBJ_id_smime_mod_oid OBJ_id_smime_mod,3L + +#define SN_id_smime_mod_msg_v3 "id-smime-mod-msg-v3" +#define NID_id_smime_mod_msg_v3 199 +#define OBJ_id_smime_mod_msg_v3 OBJ_id_smime_mod,4L + +#define SN_id_smime_mod_ets_eSignature_88 "id-smime-mod-ets-eSignature-88" +#define NID_id_smime_mod_ets_eSignature_88 200 +#define OBJ_id_smime_mod_ets_eSignature_88 OBJ_id_smime_mod,5L + +#define SN_id_smime_mod_ets_eSignature_97 "id-smime-mod-ets-eSignature-97" +#define NID_id_smime_mod_ets_eSignature_97 201 +#define OBJ_id_smime_mod_ets_eSignature_97 OBJ_id_smime_mod,6L + +#define SN_id_smime_mod_ets_eSigPolicy_88 "id-smime-mod-ets-eSigPolicy-88" +#define NID_id_smime_mod_ets_eSigPolicy_88 202 +#define OBJ_id_smime_mod_ets_eSigPolicy_88 OBJ_id_smime_mod,7L + +#define SN_id_smime_mod_ets_eSigPolicy_97 "id-smime-mod-ets-eSigPolicy-97" +#define NID_id_smime_mod_ets_eSigPolicy_97 203 +#define OBJ_id_smime_mod_ets_eSigPolicy_97 OBJ_id_smime_mod,8L + +#define SN_id_smime_ct_receipt "id-smime-ct-receipt" +#define NID_id_smime_ct_receipt 204 +#define OBJ_id_smime_ct_receipt OBJ_id_smime_ct,1L + +#define SN_id_smime_ct_authData "id-smime-ct-authData" +#define NID_id_smime_ct_authData 205 +#define OBJ_id_smime_ct_authData OBJ_id_smime_ct,2L + +#define SN_id_smime_ct_publishCert "id-smime-ct-publishCert" +#define NID_id_smime_ct_publishCert 206 +#define OBJ_id_smime_ct_publishCert OBJ_id_smime_ct,3L + +#define SN_id_smime_ct_TSTInfo "id-smime-ct-TSTInfo" +#define NID_id_smime_ct_TSTInfo 207 +#define OBJ_id_smime_ct_TSTInfo OBJ_id_smime_ct,4L + +#define SN_id_smime_ct_TDTInfo "id-smime-ct-TDTInfo" +#define NID_id_smime_ct_TDTInfo 208 +#define OBJ_id_smime_ct_TDTInfo OBJ_id_smime_ct,5L + +#define SN_id_smime_ct_contentInfo "id-smime-ct-contentInfo" +#define NID_id_smime_ct_contentInfo 209 +#define OBJ_id_smime_ct_contentInfo OBJ_id_smime_ct,6L + +#define SN_id_smime_ct_DVCSRequestData "id-smime-ct-DVCSRequestData" +#define NID_id_smime_ct_DVCSRequestData 210 +#define OBJ_id_smime_ct_DVCSRequestData OBJ_id_smime_ct,7L + +#define SN_id_smime_ct_DVCSResponseData "id-smime-ct-DVCSResponseData" +#define NID_id_smime_ct_DVCSResponseData 211 +#define OBJ_id_smime_ct_DVCSResponseData OBJ_id_smime_ct,8L + +#define SN_id_smime_ct_compressedData "id-smime-ct-compressedData" +#define NID_id_smime_ct_compressedData 786 +#define OBJ_id_smime_ct_compressedData OBJ_id_smime_ct,9L + +#define SN_id_smime_ct_contentCollection "id-smime-ct-contentCollection" +#define NID_id_smime_ct_contentCollection 1058 +#define OBJ_id_smime_ct_contentCollection OBJ_id_smime_ct,19L + +#define SN_id_smime_ct_authEnvelopedData "id-smime-ct-authEnvelopedData" +#define NID_id_smime_ct_authEnvelopedData 1059 +#define OBJ_id_smime_ct_authEnvelopedData OBJ_id_smime_ct,23L + +#define SN_id_ct_asciiTextWithCRLF "id-ct-asciiTextWithCRLF" +#define NID_id_ct_asciiTextWithCRLF 787 +#define OBJ_id_ct_asciiTextWithCRLF OBJ_id_smime_ct,27L + +#define SN_id_ct_xml "id-ct-xml" +#define NID_id_ct_xml 1060 +#define OBJ_id_ct_xml OBJ_id_smime_ct,28L + +#define SN_id_smime_aa_receiptRequest "id-smime-aa-receiptRequest" +#define NID_id_smime_aa_receiptRequest 212 +#define OBJ_id_smime_aa_receiptRequest OBJ_id_smime_aa,1L + +#define SN_id_smime_aa_securityLabel "id-smime-aa-securityLabel" +#define NID_id_smime_aa_securityLabel 213 +#define OBJ_id_smime_aa_securityLabel OBJ_id_smime_aa,2L + +#define SN_id_smime_aa_mlExpandHistory "id-smime-aa-mlExpandHistory" +#define NID_id_smime_aa_mlExpandHistory 214 +#define OBJ_id_smime_aa_mlExpandHistory OBJ_id_smime_aa,3L + +#define SN_id_smime_aa_contentHint "id-smime-aa-contentHint" +#define NID_id_smime_aa_contentHint 215 +#define OBJ_id_smime_aa_contentHint OBJ_id_smime_aa,4L + +#define SN_id_smime_aa_msgSigDigest "id-smime-aa-msgSigDigest" +#define NID_id_smime_aa_msgSigDigest 216 +#define OBJ_id_smime_aa_msgSigDigest OBJ_id_smime_aa,5L + +#define SN_id_smime_aa_encapContentType "id-smime-aa-encapContentType" +#define NID_id_smime_aa_encapContentType 217 +#define OBJ_id_smime_aa_encapContentType OBJ_id_smime_aa,6L + +#define SN_id_smime_aa_contentIdentifier "id-smime-aa-contentIdentifier" +#define NID_id_smime_aa_contentIdentifier 218 +#define OBJ_id_smime_aa_contentIdentifier OBJ_id_smime_aa,7L + +#define SN_id_smime_aa_macValue "id-smime-aa-macValue" +#define NID_id_smime_aa_macValue 219 +#define OBJ_id_smime_aa_macValue OBJ_id_smime_aa,8L + +#define SN_id_smime_aa_equivalentLabels "id-smime-aa-equivalentLabels" +#define NID_id_smime_aa_equivalentLabels 220 +#define OBJ_id_smime_aa_equivalentLabels OBJ_id_smime_aa,9L + +#define SN_id_smime_aa_contentReference "id-smime-aa-contentReference" +#define NID_id_smime_aa_contentReference 221 +#define OBJ_id_smime_aa_contentReference OBJ_id_smime_aa,10L + +#define SN_id_smime_aa_encrypKeyPref "id-smime-aa-encrypKeyPref" +#define NID_id_smime_aa_encrypKeyPref 222 +#define OBJ_id_smime_aa_encrypKeyPref OBJ_id_smime_aa,11L + +#define SN_id_smime_aa_signingCertificate "id-smime-aa-signingCertificate" +#define NID_id_smime_aa_signingCertificate 223 +#define OBJ_id_smime_aa_signingCertificate OBJ_id_smime_aa,12L + +#define SN_id_smime_aa_smimeEncryptCerts "id-smime-aa-smimeEncryptCerts" +#define NID_id_smime_aa_smimeEncryptCerts 224 +#define OBJ_id_smime_aa_smimeEncryptCerts OBJ_id_smime_aa,13L + +#define SN_id_smime_aa_timeStampToken "id-smime-aa-timeStampToken" +#define NID_id_smime_aa_timeStampToken 225 +#define OBJ_id_smime_aa_timeStampToken OBJ_id_smime_aa,14L + +#define SN_id_smime_aa_ets_sigPolicyId "id-smime-aa-ets-sigPolicyId" +#define NID_id_smime_aa_ets_sigPolicyId 226 +#define OBJ_id_smime_aa_ets_sigPolicyId OBJ_id_smime_aa,15L + +#define SN_id_smime_aa_ets_commitmentType "id-smime-aa-ets-commitmentType" +#define NID_id_smime_aa_ets_commitmentType 227 +#define OBJ_id_smime_aa_ets_commitmentType OBJ_id_smime_aa,16L + +#define SN_id_smime_aa_ets_signerLocation "id-smime-aa-ets-signerLocation" +#define NID_id_smime_aa_ets_signerLocation 228 +#define OBJ_id_smime_aa_ets_signerLocation OBJ_id_smime_aa,17L + +#define SN_id_smime_aa_ets_signerAttr "id-smime-aa-ets-signerAttr" +#define NID_id_smime_aa_ets_signerAttr 229 +#define OBJ_id_smime_aa_ets_signerAttr OBJ_id_smime_aa,18L + +#define SN_id_smime_aa_ets_otherSigCert "id-smime-aa-ets-otherSigCert" +#define NID_id_smime_aa_ets_otherSigCert 230 +#define OBJ_id_smime_aa_ets_otherSigCert OBJ_id_smime_aa,19L + +#define SN_id_smime_aa_ets_contentTimestamp "id-smime-aa-ets-contentTimestamp" +#define NID_id_smime_aa_ets_contentTimestamp 231 +#define OBJ_id_smime_aa_ets_contentTimestamp OBJ_id_smime_aa,20L + +#define SN_id_smime_aa_ets_CertificateRefs "id-smime-aa-ets-CertificateRefs" +#define NID_id_smime_aa_ets_CertificateRefs 232 +#define OBJ_id_smime_aa_ets_CertificateRefs OBJ_id_smime_aa,21L + +#define SN_id_smime_aa_ets_RevocationRefs "id-smime-aa-ets-RevocationRefs" +#define NID_id_smime_aa_ets_RevocationRefs 233 +#define OBJ_id_smime_aa_ets_RevocationRefs OBJ_id_smime_aa,22L + +#define SN_id_smime_aa_ets_certValues "id-smime-aa-ets-certValues" +#define NID_id_smime_aa_ets_certValues 234 +#define OBJ_id_smime_aa_ets_certValues OBJ_id_smime_aa,23L + +#define SN_id_smime_aa_ets_revocationValues "id-smime-aa-ets-revocationValues" +#define NID_id_smime_aa_ets_revocationValues 235 +#define OBJ_id_smime_aa_ets_revocationValues OBJ_id_smime_aa,24L + +#define SN_id_smime_aa_ets_escTimeStamp "id-smime-aa-ets-escTimeStamp" +#define NID_id_smime_aa_ets_escTimeStamp 236 +#define OBJ_id_smime_aa_ets_escTimeStamp OBJ_id_smime_aa,25L + +#define SN_id_smime_aa_ets_certCRLTimestamp "id-smime-aa-ets-certCRLTimestamp" +#define NID_id_smime_aa_ets_certCRLTimestamp 237 +#define OBJ_id_smime_aa_ets_certCRLTimestamp OBJ_id_smime_aa,26L + +#define SN_id_smime_aa_ets_archiveTimeStamp "id-smime-aa-ets-archiveTimeStamp" +#define NID_id_smime_aa_ets_archiveTimeStamp 238 +#define OBJ_id_smime_aa_ets_archiveTimeStamp OBJ_id_smime_aa,27L + +#define SN_id_smime_aa_signatureType "id-smime-aa-signatureType" +#define NID_id_smime_aa_signatureType 239 +#define OBJ_id_smime_aa_signatureType OBJ_id_smime_aa,28L + +#define SN_id_smime_aa_dvcs_dvc "id-smime-aa-dvcs-dvc" +#define NID_id_smime_aa_dvcs_dvc 240 +#define OBJ_id_smime_aa_dvcs_dvc OBJ_id_smime_aa,29L + +#define SN_id_smime_aa_signingCertificateV2 "id-smime-aa-signingCertificateV2" +#define NID_id_smime_aa_signingCertificateV2 1086 +#define OBJ_id_smime_aa_signingCertificateV2 OBJ_id_smime_aa,47L + +#define SN_id_smime_alg_ESDHwith3DES "id-smime-alg-ESDHwith3DES" +#define NID_id_smime_alg_ESDHwith3DES 241 +#define OBJ_id_smime_alg_ESDHwith3DES OBJ_id_smime_alg,1L + +#define SN_id_smime_alg_ESDHwithRC2 "id-smime-alg-ESDHwithRC2" +#define NID_id_smime_alg_ESDHwithRC2 242 +#define OBJ_id_smime_alg_ESDHwithRC2 OBJ_id_smime_alg,2L + +#define SN_id_smime_alg_3DESwrap "id-smime-alg-3DESwrap" +#define NID_id_smime_alg_3DESwrap 243 +#define OBJ_id_smime_alg_3DESwrap OBJ_id_smime_alg,3L + +#define SN_id_smime_alg_RC2wrap "id-smime-alg-RC2wrap" +#define NID_id_smime_alg_RC2wrap 244 +#define OBJ_id_smime_alg_RC2wrap OBJ_id_smime_alg,4L + +#define SN_id_smime_alg_ESDH "id-smime-alg-ESDH" +#define NID_id_smime_alg_ESDH 245 +#define OBJ_id_smime_alg_ESDH OBJ_id_smime_alg,5L + +#define SN_id_smime_alg_CMS3DESwrap "id-smime-alg-CMS3DESwrap" +#define NID_id_smime_alg_CMS3DESwrap 246 +#define OBJ_id_smime_alg_CMS3DESwrap OBJ_id_smime_alg,6L + +#define SN_id_smime_alg_CMSRC2wrap "id-smime-alg-CMSRC2wrap" +#define NID_id_smime_alg_CMSRC2wrap 247 +#define OBJ_id_smime_alg_CMSRC2wrap OBJ_id_smime_alg,7L + +#define SN_id_alg_PWRI_KEK "id-alg-PWRI-KEK" +#define NID_id_alg_PWRI_KEK 893 +#define OBJ_id_alg_PWRI_KEK OBJ_id_smime_alg,9L + +#define SN_id_smime_cd_ldap "id-smime-cd-ldap" +#define NID_id_smime_cd_ldap 248 +#define OBJ_id_smime_cd_ldap OBJ_id_smime_cd,1L + +#define SN_id_smime_spq_ets_sqt_uri "id-smime-spq-ets-sqt-uri" +#define NID_id_smime_spq_ets_sqt_uri 249 +#define OBJ_id_smime_spq_ets_sqt_uri OBJ_id_smime_spq,1L + +#define SN_id_smime_spq_ets_sqt_unotice "id-smime-spq-ets-sqt-unotice" +#define NID_id_smime_spq_ets_sqt_unotice 250 +#define OBJ_id_smime_spq_ets_sqt_unotice OBJ_id_smime_spq,2L + +#define SN_id_smime_cti_ets_proofOfOrigin "id-smime-cti-ets-proofOfOrigin" +#define NID_id_smime_cti_ets_proofOfOrigin 251 +#define OBJ_id_smime_cti_ets_proofOfOrigin OBJ_id_smime_cti,1L + +#define SN_id_smime_cti_ets_proofOfReceipt "id-smime-cti-ets-proofOfReceipt" +#define NID_id_smime_cti_ets_proofOfReceipt 252 +#define OBJ_id_smime_cti_ets_proofOfReceipt OBJ_id_smime_cti,2L + +#define SN_id_smime_cti_ets_proofOfDelivery "id-smime-cti-ets-proofOfDelivery" +#define NID_id_smime_cti_ets_proofOfDelivery 253 +#define OBJ_id_smime_cti_ets_proofOfDelivery OBJ_id_smime_cti,3L + +#define SN_id_smime_cti_ets_proofOfSender "id-smime-cti-ets-proofOfSender" +#define NID_id_smime_cti_ets_proofOfSender 254 +#define OBJ_id_smime_cti_ets_proofOfSender OBJ_id_smime_cti,4L + +#define SN_id_smime_cti_ets_proofOfApproval "id-smime-cti-ets-proofOfApproval" +#define NID_id_smime_cti_ets_proofOfApproval 255 +#define OBJ_id_smime_cti_ets_proofOfApproval OBJ_id_smime_cti,5L + +#define SN_id_smime_cti_ets_proofOfCreation "id-smime-cti-ets-proofOfCreation" +#define NID_id_smime_cti_ets_proofOfCreation 256 +#define OBJ_id_smime_cti_ets_proofOfCreation OBJ_id_smime_cti,6L + +#define LN_friendlyName "friendlyName" +#define NID_friendlyName 156 +#define OBJ_friendlyName OBJ_pkcs9,20L + +#define LN_localKeyID "localKeyID" +#define NID_localKeyID 157 +#define OBJ_localKeyID OBJ_pkcs9,21L + +#define SN_ms_csp_name "CSPName" +#define LN_ms_csp_name "Microsoft CSP Name" +#define NID_ms_csp_name 417 +#define OBJ_ms_csp_name 1L,3L,6L,1L,4L,1L,311L,17L,1L + +#define SN_LocalKeySet "LocalKeySet" +#define LN_LocalKeySet "Microsoft Local Key set" +#define NID_LocalKeySet 856 +#define OBJ_LocalKeySet 1L,3L,6L,1L,4L,1L,311L,17L,2L + +#define OBJ_certTypes OBJ_pkcs9,22L + +#define LN_x509Certificate "x509Certificate" +#define NID_x509Certificate 158 +#define OBJ_x509Certificate OBJ_certTypes,1L + +#define LN_sdsiCertificate "sdsiCertificate" +#define NID_sdsiCertificate 159 +#define OBJ_sdsiCertificate OBJ_certTypes,2L + +#define OBJ_crlTypes OBJ_pkcs9,23L + +#define LN_x509Crl "x509Crl" +#define NID_x509Crl 160 +#define OBJ_x509Crl OBJ_crlTypes,1L + +#define OBJ_pkcs12 OBJ_pkcs,12L + +#define OBJ_pkcs12_pbeids OBJ_pkcs12,1L + +#define SN_pbe_WithSHA1And128BitRC4 "PBE-SHA1-RC4-128" +#define LN_pbe_WithSHA1And128BitRC4 "pbeWithSHA1And128BitRC4" +#define NID_pbe_WithSHA1And128BitRC4 144 +#define OBJ_pbe_WithSHA1And128BitRC4 OBJ_pkcs12_pbeids,1L + +#define SN_pbe_WithSHA1And40BitRC4 "PBE-SHA1-RC4-40" +#define LN_pbe_WithSHA1And40BitRC4 "pbeWithSHA1And40BitRC4" +#define NID_pbe_WithSHA1And40BitRC4 145 +#define OBJ_pbe_WithSHA1And40BitRC4 OBJ_pkcs12_pbeids,2L + +#define SN_pbe_WithSHA1And3_Key_TripleDES_CBC "PBE-SHA1-3DES" +#define LN_pbe_WithSHA1And3_Key_TripleDES_CBC "pbeWithSHA1And3-KeyTripleDES-CBC" +#define NID_pbe_WithSHA1And3_Key_TripleDES_CBC 146 +#define OBJ_pbe_WithSHA1And3_Key_TripleDES_CBC OBJ_pkcs12_pbeids,3L + +#define SN_pbe_WithSHA1And2_Key_TripleDES_CBC "PBE-SHA1-2DES" +#define LN_pbe_WithSHA1And2_Key_TripleDES_CBC "pbeWithSHA1And2-KeyTripleDES-CBC" +#define NID_pbe_WithSHA1And2_Key_TripleDES_CBC 147 +#define OBJ_pbe_WithSHA1And2_Key_TripleDES_CBC OBJ_pkcs12_pbeids,4L + +#define SN_pbe_WithSHA1And128BitRC2_CBC "PBE-SHA1-RC2-128" +#define LN_pbe_WithSHA1And128BitRC2_CBC "pbeWithSHA1And128BitRC2-CBC" +#define NID_pbe_WithSHA1And128BitRC2_CBC 148 +#define OBJ_pbe_WithSHA1And128BitRC2_CBC OBJ_pkcs12_pbeids,5L + +#define SN_pbe_WithSHA1And40BitRC2_CBC "PBE-SHA1-RC2-40" +#define LN_pbe_WithSHA1And40BitRC2_CBC "pbeWithSHA1And40BitRC2-CBC" +#define NID_pbe_WithSHA1And40BitRC2_CBC 149 +#define OBJ_pbe_WithSHA1And40BitRC2_CBC OBJ_pkcs12_pbeids,6L + +#define OBJ_pkcs12_Version1 OBJ_pkcs12,10L + +#define OBJ_pkcs12_BagIds OBJ_pkcs12_Version1,1L + +#define LN_keyBag "keyBag" +#define NID_keyBag 150 +#define OBJ_keyBag OBJ_pkcs12_BagIds,1L + +#define LN_pkcs8ShroudedKeyBag "pkcs8ShroudedKeyBag" +#define NID_pkcs8ShroudedKeyBag 151 +#define OBJ_pkcs8ShroudedKeyBag OBJ_pkcs12_BagIds,2L + +#define LN_certBag "certBag" +#define NID_certBag 152 +#define OBJ_certBag OBJ_pkcs12_BagIds,3L + +#define LN_crlBag "crlBag" +#define NID_crlBag 153 +#define OBJ_crlBag OBJ_pkcs12_BagIds,4L + +#define LN_secretBag "secretBag" +#define NID_secretBag 154 +#define OBJ_secretBag OBJ_pkcs12_BagIds,5L + +#define LN_safeContentsBag "safeContentsBag" +#define NID_safeContentsBag 155 +#define OBJ_safeContentsBag OBJ_pkcs12_BagIds,6L + +#define SN_md2 "MD2" +#define LN_md2 "md2" +#define NID_md2 3 +#define OBJ_md2 OBJ_rsadsi,2L,2L + +#define SN_md4 "MD4" +#define LN_md4 "md4" +#define NID_md4 257 +#define OBJ_md4 OBJ_rsadsi,2L,4L + +#define SN_md5 "MD5" +#define LN_md5 "md5" +#define NID_md5 4 +#define OBJ_md5 OBJ_rsadsi,2L,5L + +#define SN_md5_sha1 "MD5-SHA1" +#define LN_md5_sha1 "md5-sha1" +#define NID_md5_sha1 114 + +#define LN_hmacWithMD5 "hmacWithMD5" +#define NID_hmacWithMD5 797 +#define OBJ_hmacWithMD5 OBJ_rsadsi,2L,6L + +#define LN_hmacWithSHA1 "hmacWithSHA1" +#define NID_hmacWithSHA1 163 +#define OBJ_hmacWithSHA1 OBJ_rsadsi,2L,7L + +#define SN_sm2 "SM2" +#define LN_sm2 "sm2" +#define NID_sm2 1172 +#define OBJ_sm2 OBJ_sm_scheme,301L + +#define SN_sm3 "SM3" +#define LN_sm3 "sm3" +#define NID_sm3 1143 +#define OBJ_sm3 OBJ_sm_scheme,401L + +#define SN_sm3WithRSAEncryption "RSA-SM3" +#define LN_sm3WithRSAEncryption "sm3WithRSAEncryption" +#define NID_sm3WithRSAEncryption 1144 +#define OBJ_sm3WithRSAEncryption OBJ_sm_scheme,504L + +#define LN_hmacWithSHA224 "hmacWithSHA224" +#define NID_hmacWithSHA224 798 +#define OBJ_hmacWithSHA224 OBJ_rsadsi,2L,8L + +#define LN_hmacWithSHA256 "hmacWithSHA256" +#define NID_hmacWithSHA256 799 +#define OBJ_hmacWithSHA256 OBJ_rsadsi,2L,9L + +#define LN_hmacWithSHA384 "hmacWithSHA384" +#define NID_hmacWithSHA384 800 +#define OBJ_hmacWithSHA384 OBJ_rsadsi,2L,10L + +#define LN_hmacWithSHA512 "hmacWithSHA512" +#define NID_hmacWithSHA512 801 +#define OBJ_hmacWithSHA512 OBJ_rsadsi,2L,11L + +#define LN_hmacWithSHA512_224 "hmacWithSHA512-224" +#define NID_hmacWithSHA512_224 1193 +#define OBJ_hmacWithSHA512_224 OBJ_rsadsi,2L,12L + +#define LN_hmacWithSHA512_256 "hmacWithSHA512-256" +#define NID_hmacWithSHA512_256 1194 +#define OBJ_hmacWithSHA512_256 OBJ_rsadsi,2L,13L + +#define SN_rc2_cbc "RC2-CBC" +#define LN_rc2_cbc "rc2-cbc" +#define NID_rc2_cbc 37 +#define OBJ_rc2_cbc OBJ_rsadsi,3L,2L + +#define SN_rc2_ecb "RC2-ECB" +#define LN_rc2_ecb "rc2-ecb" +#define NID_rc2_ecb 38 + +#define SN_rc2_cfb64 "RC2-CFB" +#define LN_rc2_cfb64 "rc2-cfb" +#define NID_rc2_cfb64 39 + +#define SN_rc2_ofb64 "RC2-OFB" +#define LN_rc2_ofb64 "rc2-ofb" +#define NID_rc2_ofb64 40 + +#define SN_rc2_40_cbc "RC2-40-CBC" +#define LN_rc2_40_cbc "rc2-40-cbc" +#define NID_rc2_40_cbc 98 + +#define SN_rc2_64_cbc "RC2-64-CBC" +#define LN_rc2_64_cbc "rc2-64-cbc" +#define NID_rc2_64_cbc 166 + +#define SN_rc4 "RC4" +#define LN_rc4 "rc4" +#define NID_rc4 5 +#define OBJ_rc4 OBJ_rsadsi,3L,4L + +#define SN_rc4_40 "RC4-40" +#define LN_rc4_40 "rc4-40" +#define NID_rc4_40 97 + +#define SN_des_ede3_cbc "DES-EDE3-CBC" +#define LN_des_ede3_cbc "des-ede3-cbc" +#define NID_des_ede3_cbc 44 +#define OBJ_des_ede3_cbc OBJ_rsadsi,3L,7L + +#define SN_rc5_cbc "RC5-CBC" +#define LN_rc5_cbc "rc5-cbc" +#define NID_rc5_cbc 120 +#define OBJ_rc5_cbc OBJ_rsadsi,3L,8L + +#define SN_rc5_ecb "RC5-ECB" +#define LN_rc5_ecb "rc5-ecb" +#define NID_rc5_ecb 121 + +#define SN_rc5_cfb64 "RC5-CFB" +#define LN_rc5_cfb64 "rc5-cfb" +#define NID_rc5_cfb64 122 + +#define SN_rc5_ofb64 "RC5-OFB" +#define LN_rc5_ofb64 "rc5-ofb" +#define NID_rc5_ofb64 123 + +#define SN_ms_ext_req "msExtReq" +#define LN_ms_ext_req "Microsoft Extension Request" +#define NID_ms_ext_req 171 +#define OBJ_ms_ext_req 1L,3L,6L,1L,4L,1L,311L,2L,1L,14L + +#define SN_ms_code_ind "msCodeInd" +#define LN_ms_code_ind "Microsoft Individual Code Signing" +#define NID_ms_code_ind 134 +#define OBJ_ms_code_ind 1L,3L,6L,1L,4L,1L,311L,2L,1L,21L + +#define SN_ms_code_com "msCodeCom" +#define LN_ms_code_com "Microsoft Commercial Code Signing" +#define NID_ms_code_com 135 +#define OBJ_ms_code_com 1L,3L,6L,1L,4L,1L,311L,2L,1L,22L + +#define SN_ms_ctl_sign "msCTLSign" +#define LN_ms_ctl_sign "Microsoft Trust List Signing" +#define NID_ms_ctl_sign 136 +#define OBJ_ms_ctl_sign 1L,3L,6L,1L,4L,1L,311L,10L,3L,1L + +#define SN_ms_sgc "msSGC" +#define LN_ms_sgc "Microsoft Server Gated Crypto" +#define NID_ms_sgc 137 +#define OBJ_ms_sgc 1L,3L,6L,1L,4L,1L,311L,10L,3L,3L + +#define SN_ms_efs "msEFS" +#define LN_ms_efs "Microsoft Encrypted File System" +#define NID_ms_efs 138 +#define OBJ_ms_efs 1L,3L,6L,1L,4L,1L,311L,10L,3L,4L + +#define SN_ms_smartcard_login "msSmartcardLogin" +#define LN_ms_smartcard_login "Microsoft Smartcardlogin" +#define NID_ms_smartcard_login 648 +#define OBJ_ms_smartcard_login 1L,3L,6L,1L,4L,1L,311L,20L,2L,2L + +#define SN_ms_upn "msUPN" +#define LN_ms_upn "Microsoft Universal Principal Name" +#define NID_ms_upn 649 +#define OBJ_ms_upn 1L,3L,6L,1L,4L,1L,311L,20L,2L,3L + +#define SN_idea_cbc "IDEA-CBC" +#define LN_idea_cbc "idea-cbc" +#define NID_idea_cbc 34 +#define OBJ_idea_cbc 1L,3L,6L,1L,4L,1L,188L,7L,1L,1L,2L + +#define SN_idea_ecb "IDEA-ECB" +#define LN_idea_ecb "idea-ecb" +#define NID_idea_ecb 36 + +#define SN_idea_cfb64 "IDEA-CFB" +#define LN_idea_cfb64 "idea-cfb" +#define NID_idea_cfb64 35 + +#define SN_idea_ofb64 "IDEA-OFB" +#define LN_idea_ofb64 "idea-ofb" +#define NID_idea_ofb64 46 + +#define SN_bf_cbc "BF-CBC" +#define LN_bf_cbc "bf-cbc" +#define NID_bf_cbc 91 +#define OBJ_bf_cbc 1L,3L,6L,1L,4L,1L,3029L,1L,2L + +#define SN_bf_ecb "BF-ECB" +#define LN_bf_ecb "bf-ecb" +#define NID_bf_ecb 92 + +#define SN_bf_cfb64 "BF-CFB" +#define LN_bf_cfb64 "bf-cfb" +#define NID_bf_cfb64 93 + +#define SN_bf_ofb64 "BF-OFB" +#define LN_bf_ofb64 "bf-ofb" +#define NID_bf_ofb64 94 + +#define SN_id_pkix "PKIX" +#define NID_id_pkix 127 +#define OBJ_id_pkix 1L,3L,6L,1L,5L,5L,7L + +#define SN_id_pkix_mod "id-pkix-mod" +#define NID_id_pkix_mod 258 +#define OBJ_id_pkix_mod OBJ_id_pkix,0L + +#define SN_id_pe "id-pe" +#define NID_id_pe 175 +#define OBJ_id_pe OBJ_id_pkix,1L + +#define SN_id_qt "id-qt" +#define NID_id_qt 259 +#define OBJ_id_qt OBJ_id_pkix,2L + +#define SN_id_kp "id-kp" +#define NID_id_kp 128 +#define OBJ_id_kp OBJ_id_pkix,3L + +#define SN_id_it "id-it" +#define NID_id_it 260 +#define OBJ_id_it OBJ_id_pkix,4L + +#define SN_id_pkip "id-pkip" +#define NID_id_pkip 261 +#define OBJ_id_pkip OBJ_id_pkix,5L + +#define SN_id_alg "id-alg" +#define NID_id_alg 262 +#define OBJ_id_alg OBJ_id_pkix,6L + +#define SN_id_cmc "id-cmc" +#define NID_id_cmc 263 +#define OBJ_id_cmc OBJ_id_pkix,7L + +#define SN_id_on "id-on" +#define NID_id_on 264 +#define OBJ_id_on OBJ_id_pkix,8L + +#define SN_id_pda "id-pda" +#define NID_id_pda 265 +#define OBJ_id_pda OBJ_id_pkix,9L + +#define SN_id_aca "id-aca" +#define NID_id_aca 266 +#define OBJ_id_aca OBJ_id_pkix,10L + +#define SN_id_qcs "id-qcs" +#define NID_id_qcs 267 +#define OBJ_id_qcs OBJ_id_pkix,11L + +#define SN_id_cct "id-cct" +#define NID_id_cct 268 +#define OBJ_id_cct OBJ_id_pkix,12L + +#define SN_id_ppl "id-ppl" +#define NID_id_ppl 662 +#define OBJ_id_ppl OBJ_id_pkix,21L + +#define SN_id_ad "id-ad" +#define NID_id_ad 176 +#define OBJ_id_ad OBJ_id_pkix,48L + +#define SN_id_pkix1_explicit_88 "id-pkix1-explicit-88" +#define NID_id_pkix1_explicit_88 269 +#define OBJ_id_pkix1_explicit_88 OBJ_id_pkix_mod,1L + +#define SN_id_pkix1_implicit_88 "id-pkix1-implicit-88" +#define NID_id_pkix1_implicit_88 270 +#define OBJ_id_pkix1_implicit_88 OBJ_id_pkix_mod,2L + +#define SN_id_pkix1_explicit_93 "id-pkix1-explicit-93" +#define NID_id_pkix1_explicit_93 271 +#define OBJ_id_pkix1_explicit_93 OBJ_id_pkix_mod,3L + +#define SN_id_pkix1_implicit_93 "id-pkix1-implicit-93" +#define NID_id_pkix1_implicit_93 272 +#define OBJ_id_pkix1_implicit_93 OBJ_id_pkix_mod,4L + +#define SN_id_mod_crmf "id-mod-crmf" +#define NID_id_mod_crmf 273 +#define OBJ_id_mod_crmf OBJ_id_pkix_mod,5L + +#define SN_id_mod_cmc "id-mod-cmc" +#define NID_id_mod_cmc 274 +#define OBJ_id_mod_cmc OBJ_id_pkix_mod,6L + +#define SN_id_mod_kea_profile_88 "id-mod-kea-profile-88" +#define NID_id_mod_kea_profile_88 275 +#define OBJ_id_mod_kea_profile_88 OBJ_id_pkix_mod,7L + +#define SN_id_mod_kea_profile_93 "id-mod-kea-profile-93" +#define NID_id_mod_kea_profile_93 276 +#define OBJ_id_mod_kea_profile_93 OBJ_id_pkix_mod,8L + +#define SN_id_mod_cmp "id-mod-cmp" +#define NID_id_mod_cmp 277 +#define OBJ_id_mod_cmp OBJ_id_pkix_mod,9L + +#define SN_id_mod_qualified_cert_88 "id-mod-qualified-cert-88" +#define NID_id_mod_qualified_cert_88 278 +#define OBJ_id_mod_qualified_cert_88 OBJ_id_pkix_mod,10L + +#define SN_id_mod_qualified_cert_93 "id-mod-qualified-cert-93" +#define NID_id_mod_qualified_cert_93 279 +#define OBJ_id_mod_qualified_cert_93 OBJ_id_pkix_mod,11L + +#define SN_id_mod_attribute_cert "id-mod-attribute-cert" +#define NID_id_mod_attribute_cert 280 +#define OBJ_id_mod_attribute_cert OBJ_id_pkix_mod,12L + +#define SN_id_mod_timestamp_protocol "id-mod-timestamp-protocol" +#define NID_id_mod_timestamp_protocol 281 +#define OBJ_id_mod_timestamp_protocol OBJ_id_pkix_mod,13L + +#define SN_id_mod_ocsp "id-mod-ocsp" +#define NID_id_mod_ocsp 282 +#define OBJ_id_mod_ocsp OBJ_id_pkix_mod,14L + +#define SN_id_mod_dvcs "id-mod-dvcs" +#define NID_id_mod_dvcs 283 +#define OBJ_id_mod_dvcs OBJ_id_pkix_mod,15L + +#define SN_id_mod_cmp2000 "id-mod-cmp2000" +#define NID_id_mod_cmp2000 284 +#define OBJ_id_mod_cmp2000 OBJ_id_pkix_mod,16L + +#define SN_info_access "authorityInfoAccess" +#define LN_info_access "Authority Information Access" +#define NID_info_access 177 +#define OBJ_info_access OBJ_id_pe,1L + +#define SN_biometricInfo "biometricInfo" +#define LN_biometricInfo "Biometric Info" +#define NID_biometricInfo 285 +#define OBJ_biometricInfo OBJ_id_pe,2L + +#define SN_qcStatements "qcStatements" +#define NID_qcStatements 286 +#define OBJ_qcStatements OBJ_id_pe,3L + +#define SN_ac_auditEntity "ac-auditEntity" +#define NID_ac_auditEntity 287 +#define OBJ_ac_auditEntity OBJ_id_pe,4L + +#define SN_ac_targeting "ac-targeting" +#define NID_ac_targeting 288 +#define OBJ_ac_targeting OBJ_id_pe,5L + +#define SN_aaControls "aaControls" +#define NID_aaControls 289 +#define OBJ_aaControls OBJ_id_pe,6L + +#define SN_sbgp_ipAddrBlock "sbgp-ipAddrBlock" +#define NID_sbgp_ipAddrBlock 290 +#define OBJ_sbgp_ipAddrBlock OBJ_id_pe,7L + +#define SN_sbgp_autonomousSysNum "sbgp-autonomousSysNum" +#define NID_sbgp_autonomousSysNum 291 +#define OBJ_sbgp_autonomousSysNum OBJ_id_pe,8L + +#define SN_sbgp_routerIdentifier "sbgp-routerIdentifier" +#define NID_sbgp_routerIdentifier 292 +#define OBJ_sbgp_routerIdentifier OBJ_id_pe,9L + +#define SN_ac_proxying "ac-proxying" +#define NID_ac_proxying 397 +#define OBJ_ac_proxying OBJ_id_pe,10L + +#define SN_sinfo_access "subjectInfoAccess" +#define LN_sinfo_access "Subject Information Access" +#define NID_sinfo_access 398 +#define OBJ_sinfo_access OBJ_id_pe,11L + +#define SN_proxyCertInfo "proxyCertInfo" +#define LN_proxyCertInfo "Proxy Certificate Information" +#define NID_proxyCertInfo 663 +#define OBJ_proxyCertInfo OBJ_id_pe,14L + +#define SN_tlsfeature "tlsfeature" +#define LN_tlsfeature "TLS Feature" +#define NID_tlsfeature 1020 +#define OBJ_tlsfeature OBJ_id_pe,24L + +#define SN_id_qt_cps "id-qt-cps" +#define LN_id_qt_cps "Policy Qualifier CPS" +#define NID_id_qt_cps 164 +#define OBJ_id_qt_cps OBJ_id_qt,1L + +#define SN_id_qt_unotice "id-qt-unotice" +#define LN_id_qt_unotice "Policy Qualifier User Notice" +#define NID_id_qt_unotice 165 +#define OBJ_id_qt_unotice OBJ_id_qt,2L + +#define SN_textNotice "textNotice" +#define NID_textNotice 293 +#define OBJ_textNotice OBJ_id_qt,3L + +#define SN_server_auth "serverAuth" +#define LN_server_auth "TLS Web Server Authentication" +#define NID_server_auth 129 +#define OBJ_server_auth OBJ_id_kp,1L + +#define SN_client_auth "clientAuth" +#define LN_client_auth "TLS Web Client Authentication" +#define NID_client_auth 130 +#define OBJ_client_auth OBJ_id_kp,2L + +#define SN_code_sign "codeSigning" +#define LN_code_sign "Code Signing" +#define NID_code_sign 131 +#define OBJ_code_sign OBJ_id_kp,3L + +#define SN_email_protect "emailProtection" +#define LN_email_protect "E-mail Protection" +#define NID_email_protect 132 +#define OBJ_email_protect OBJ_id_kp,4L + +#define SN_ipsecEndSystem "ipsecEndSystem" +#define LN_ipsecEndSystem "IPSec End System" +#define NID_ipsecEndSystem 294 +#define OBJ_ipsecEndSystem OBJ_id_kp,5L + +#define SN_ipsecTunnel "ipsecTunnel" +#define LN_ipsecTunnel "IPSec Tunnel" +#define NID_ipsecTunnel 295 +#define OBJ_ipsecTunnel OBJ_id_kp,6L + +#define SN_ipsecUser "ipsecUser" +#define LN_ipsecUser "IPSec User" +#define NID_ipsecUser 296 +#define OBJ_ipsecUser OBJ_id_kp,7L + +#define SN_time_stamp "timeStamping" +#define LN_time_stamp "Time Stamping" +#define NID_time_stamp 133 +#define OBJ_time_stamp OBJ_id_kp,8L + +#define SN_OCSP_sign "OCSPSigning" +#define LN_OCSP_sign "OCSP Signing" +#define NID_OCSP_sign 180 +#define OBJ_OCSP_sign OBJ_id_kp,9L + +#define SN_dvcs "DVCS" +#define LN_dvcs "dvcs" +#define NID_dvcs 297 +#define OBJ_dvcs OBJ_id_kp,10L + +#define SN_ipsec_IKE "ipsecIKE" +#define LN_ipsec_IKE "ipsec Internet Key Exchange" +#define NID_ipsec_IKE 1022 +#define OBJ_ipsec_IKE OBJ_id_kp,17L + +#define SN_capwapAC "capwapAC" +#define LN_capwapAC "Ctrl/provision WAP Access" +#define NID_capwapAC 1023 +#define OBJ_capwapAC OBJ_id_kp,18L + +#define SN_capwapWTP "capwapWTP" +#define LN_capwapWTP "Ctrl/Provision WAP Termination" +#define NID_capwapWTP 1024 +#define OBJ_capwapWTP OBJ_id_kp,19L + +#define SN_sshClient "secureShellClient" +#define LN_sshClient "SSH Client" +#define NID_sshClient 1025 +#define OBJ_sshClient OBJ_id_kp,21L + +#define SN_sshServer "secureShellServer" +#define LN_sshServer "SSH Server" +#define NID_sshServer 1026 +#define OBJ_sshServer OBJ_id_kp,22L + +#define SN_sendRouter "sendRouter" +#define LN_sendRouter "Send Router" +#define NID_sendRouter 1027 +#define OBJ_sendRouter OBJ_id_kp,23L + +#define SN_sendProxiedRouter "sendProxiedRouter" +#define LN_sendProxiedRouter "Send Proxied Router" +#define NID_sendProxiedRouter 1028 +#define OBJ_sendProxiedRouter OBJ_id_kp,24L + +#define SN_sendOwner "sendOwner" +#define LN_sendOwner "Send Owner" +#define NID_sendOwner 1029 +#define OBJ_sendOwner OBJ_id_kp,25L + +#define SN_sendProxiedOwner "sendProxiedOwner" +#define LN_sendProxiedOwner "Send Proxied Owner" +#define NID_sendProxiedOwner 1030 +#define OBJ_sendProxiedOwner OBJ_id_kp,26L + +#define SN_cmcCA "cmcCA" +#define LN_cmcCA "CMC Certificate Authority" +#define NID_cmcCA 1131 +#define OBJ_cmcCA OBJ_id_kp,27L + +#define SN_cmcRA "cmcRA" +#define LN_cmcRA "CMC Registration Authority" +#define NID_cmcRA 1132 +#define OBJ_cmcRA OBJ_id_kp,28L + +#define SN_id_it_caProtEncCert "id-it-caProtEncCert" +#define NID_id_it_caProtEncCert 298 +#define OBJ_id_it_caProtEncCert OBJ_id_it,1L + +#define SN_id_it_signKeyPairTypes "id-it-signKeyPairTypes" +#define NID_id_it_signKeyPairTypes 299 +#define OBJ_id_it_signKeyPairTypes OBJ_id_it,2L + +#define SN_id_it_encKeyPairTypes "id-it-encKeyPairTypes" +#define NID_id_it_encKeyPairTypes 300 +#define OBJ_id_it_encKeyPairTypes OBJ_id_it,3L + +#define SN_id_it_preferredSymmAlg "id-it-preferredSymmAlg" +#define NID_id_it_preferredSymmAlg 301 +#define OBJ_id_it_preferredSymmAlg OBJ_id_it,4L + +#define SN_id_it_caKeyUpdateInfo "id-it-caKeyUpdateInfo" +#define NID_id_it_caKeyUpdateInfo 302 +#define OBJ_id_it_caKeyUpdateInfo OBJ_id_it,5L + +#define SN_id_it_currentCRL "id-it-currentCRL" +#define NID_id_it_currentCRL 303 +#define OBJ_id_it_currentCRL OBJ_id_it,6L + +#define SN_id_it_unsupportedOIDs "id-it-unsupportedOIDs" +#define NID_id_it_unsupportedOIDs 304 +#define OBJ_id_it_unsupportedOIDs OBJ_id_it,7L + +#define SN_id_it_subscriptionRequest "id-it-subscriptionRequest" +#define NID_id_it_subscriptionRequest 305 +#define OBJ_id_it_subscriptionRequest OBJ_id_it,8L + +#define SN_id_it_subscriptionResponse "id-it-subscriptionResponse" +#define NID_id_it_subscriptionResponse 306 +#define OBJ_id_it_subscriptionResponse OBJ_id_it,9L + +#define SN_id_it_keyPairParamReq "id-it-keyPairParamReq" +#define NID_id_it_keyPairParamReq 307 +#define OBJ_id_it_keyPairParamReq OBJ_id_it,10L + +#define SN_id_it_keyPairParamRep "id-it-keyPairParamRep" +#define NID_id_it_keyPairParamRep 308 +#define OBJ_id_it_keyPairParamRep OBJ_id_it,11L + +#define SN_id_it_revPassphrase "id-it-revPassphrase" +#define NID_id_it_revPassphrase 309 +#define OBJ_id_it_revPassphrase OBJ_id_it,12L + +#define SN_id_it_implicitConfirm "id-it-implicitConfirm" +#define NID_id_it_implicitConfirm 310 +#define OBJ_id_it_implicitConfirm OBJ_id_it,13L + +#define SN_id_it_confirmWaitTime "id-it-confirmWaitTime" +#define NID_id_it_confirmWaitTime 311 +#define OBJ_id_it_confirmWaitTime OBJ_id_it,14L + +#define SN_id_it_origPKIMessage "id-it-origPKIMessage" +#define NID_id_it_origPKIMessage 312 +#define OBJ_id_it_origPKIMessage OBJ_id_it,15L + +#define SN_id_it_suppLangTags "id-it-suppLangTags" +#define NID_id_it_suppLangTags 784 +#define OBJ_id_it_suppLangTags OBJ_id_it,16L + +#define SN_id_regCtrl "id-regCtrl" +#define NID_id_regCtrl 313 +#define OBJ_id_regCtrl OBJ_id_pkip,1L + +#define SN_id_regInfo "id-regInfo" +#define NID_id_regInfo 314 +#define OBJ_id_regInfo OBJ_id_pkip,2L + +#define SN_id_regCtrl_regToken "id-regCtrl-regToken" +#define NID_id_regCtrl_regToken 315 +#define OBJ_id_regCtrl_regToken OBJ_id_regCtrl,1L + +#define SN_id_regCtrl_authenticator "id-regCtrl-authenticator" +#define NID_id_regCtrl_authenticator 316 +#define OBJ_id_regCtrl_authenticator OBJ_id_regCtrl,2L + +#define SN_id_regCtrl_pkiPublicationInfo "id-regCtrl-pkiPublicationInfo" +#define NID_id_regCtrl_pkiPublicationInfo 317 +#define OBJ_id_regCtrl_pkiPublicationInfo OBJ_id_regCtrl,3L + +#define SN_id_regCtrl_pkiArchiveOptions "id-regCtrl-pkiArchiveOptions" +#define NID_id_regCtrl_pkiArchiveOptions 318 +#define OBJ_id_regCtrl_pkiArchiveOptions OBJ_id_regCtrl,4L + +#define SN_id_regCtrl_oldCertID "id-regCtrl-oldCertID" +#define NID_id_regCtrl_oldCertID 319 +#define OBJ_id_regCtrl_oldCertID OBJ_id_regCtrl,5L + +#define SN_id_regCtrl_protocolEncrKey "id-regCtrl-protocolEncrKey" +#define NID_id_regCtrl_protocolEncrKey 320 +#define OBJ_id_regCtrl_protocolEncrKey OBJ_id_regCtrl,6L + +#define SN_id_regInfo_utf8Pairs "id-regInfo-utf8Pairs" +#define NID_id_regInfo_utf8Pairs 321 +#define OBJ_id_regInfo_utf8Pairs OBJ_id_regInfo,1L + +#define SN_id_regInfo_certReq "id-regInfo-certReq" +#define NID_id_regInfo_certReq 322 +#define OBJ_id_regInfo_certReq OBJ_id_regInfo,2L + +#define SN_id_alg_des40 "id-alg-des40" +#define NID_id_alg_des40 323 +#define OBJ_id_alg_des40 OBJ_id_alg,1L + +#define SN_id_alg_noSignature "id-alg-noSignature" +#define NID_id_alg_noSignature 324 +#define OBJ_id_alg_noSignature OBJ_id_alg,2L + +#define SN_id_alg_dh_sig_hmac_sha1 "id-alg-dh-sig-hmac-sha1" +#define NID_id_alg_dh_sig_hmac_sha1 325 +#define OBJ_id_alg_dh_sig_hmac_sha1 OBJ_id_alg,3L + +#define SN_id_alg_dh_pop "id-alg-dh-pop" +#define NID_id_alg_dh_pop 326 +#define OBJ_id_alg_dh_pop OBJ_id_alg,4L + +#define SN_id_cmc_statusInfo "id-cmc-statusInfo" +#define NID_id_cmc_statusInfo 327 +#define OBJ_id_cmc_statusInfo OBJ_id_cmc,1L + +#define SN_id_cmc_identification "id-cmc-identification" +#define NID_id_cmc_identification 328 +#define OBJ_id_cmc_identification OBJ_id_cmc,2L + +#define SN_id_cmc_identityProof "id-cmc-identityProof" +#define NID_id_cmc_identityProof 329 +#define OBJ_id_cmc_identityProof OBJ_id_cmc,3L + +#define SN_id_cmc_dataReturn "id-cmc-dataReturn" +#define NID_id_cmc_dataReturn 330 +#define OBJ_id_cmc_dataReturn OBJ_id_cmc,4L + +#define SN_id_cmc_transactionId "id-cmc-transactionId" +#define NID_id_cmc_transactionId 331 +#define OBJ_id_cmc_transactionId OBJ_id_cmc,5L + +#define SN_id_cmc_senderNonce "id-cmc-senderNonce" +#define NID_id_cmc_senderNonce 332 +#define OBJ_id_cmc_senderNonce OBJ_id_cmc,6L + +#define SN_id_cmc_recipientNonce "id-cmc-recipientNonce" +#define NID_id_cmc_recipientNonce 333 +#define OBJ_id_cmc_recipientNonce OBJ_id_cmc,7L + +#define SN_id_cmc_addExtensions "id-cmc-addExtensions" +#define NID_id_cmc_addExtensions 334 +#define OBJ_id_cmc_addExtensions OBJ_id_cmc,8L + +#define SN_id_cmc_encryptedPOP "id-cmc-encryptedPOP" +#define NID_id_cmc_encryptedPOP 335 +#define OBJ_id_cmc_encryptedPOP OBJ_id_cmc,9L + +#define SN_id_cmc_decryptedPOP "id-cmc-decryptedPOP" +#define NID_id_cmc_decryptedPOP 336 +#define OBJ_id_cmc_decryptedPOP OBJ_id_cmc,10L + +#define SN_id_cmc_lraPOPWitness "id-cmc-lraPOPWitness" +#define NID_id_cmc_lraPOPWitness 337 +#define OBJ_id_cmc_lraPOPWitness OBJ_id_cmc,11L + +#define SN_id_cmc_getCert "id-cmc-getCert" +#define NID_id_cmc_getCert 338 +#define OBJ_id_cmc_getCert OBJ_id_cmc,15L + +#define SN_id_cmc_getCRL "id-cmc-getCRL" +#define NID_id_cmc_getCRL 339 +#define OBJ_id_cmc_getCRL OBJ_id_cmc,16L + +#define SN_id_cmc_revokeRequest "id-cmc-revokeRequest" +#define NID_id_cmc_revokeRequest 340 +#define OBJ_id_cmc_revokeRequest OBJ_id_cmc,17L + +#define SN_id_cmc_regInfo "id-cmc-regInfo" +#define NID_id_cmc_regInfo 341 +#define OBJ_id_cmc_regInfo OBJ_id_cmc,18L + +#define SN_id_cmc_responseInfo "id-cmc-responseInfo" +#define NID_id_cmc_responseInfo 342 +#define OBJ_id_cmc_responseInfo OBJ_id_cmc,19L + +#define SN_id_cmc_queryPending "id-cmc-queryPending" +#define NID_id_cmc_queryPending 343 +#define OBJ_id_cmc_queryPending OBJ_id_cmc,21L + +#define SN_id_cmc_popLinkRandom "id-cmc-popLinkRandom" +#define NID_id_cmc_popLinkRandom 344 +#define OBJ_id_cmc_popLinkRandom OBJ_id_cmc,22L + +#define SN_id_cmc_popLinkWitness "id-cmc-popLinkWitness" +#define NID_id_cmc_popLinkWitness 345 +#define OBJ_id_cmc_popLinkWitness OBJ_id_cmc,23L + +#define SN_id_cmc_confirmCertAcceptance "id-cmc-confirmCertAcceptance" +#define NID_id_cmc_confirmCertAcceptance 346 +#define OBJ_id_cmc_confirmCertAcceptance OBJ_id_cmc,24L + +#define SN_id_on_personalData "id-on-personalData" +#define NID_id_on_personalData 347 +#define OBJ_id_on_personalData OBJ_id_on,1L + +#define SN_id_on_permanentIdentifier "id-on-permanentIdentifier" +#define LN_id_on_permanentIdentifier "Permanent Identifier" +#define NID_id_on_permanentIdentifier 858 +#define OBJ_id_on_permanentIdentifier OBJ_id_on,3L + +#define SN_id_pda_dateOfBirth "id-pda-dateOfBirth" +#define NID_id_pda_dateOfBirth 348 +#define OBJ_id_pda_dateOfBirth OBJ_id_pda,1L + +#define SN_id_pda_placeOfBirth "id-pda-placeOfBirth" +#define NID_id_pda_placeOfBirth 349 +#define OBJ_id_pda_placeOfBirth OBJ_id_pda,2L + +#define SN_id_pda_gender "id-pda-gender" +#define NID_id_pda_gender 351 +#define OBJ_id_pda_gender OBJ_id_pda,3L + +#define SN_id_pda_countryOfCitizenship "id-pda-countryOfCitizenship" +#define NID_id_pda_countryOfCitizenship 352 +#define OBJ_id_pda_countryOfCitizenship OBJ_id_pda,4L + +#define SN_id_pda_countryOfResidence "id-pda-countryOfResidence" +#define NID_id_pda_countryOfResidence 353 +#define OBJ_id_pda_countryOfResidence OBJ_id_pda,5L + +#define SN_id_aca_authenticationInfo "id-aca-authenticationInfo" +#define NID_id_aca_authenticationInfo 354 +#define OBJ_id_aca_authenticationInfo OBJ_id_aca,1L + +#define SN_id_aca_accessIdentity "id-aca-accessIdentity" +#define NID_id_aca_accessIdentity 355 +#define OBJ_id_aca_accessIdentity OBJ_id_aca,2L + +#define SN_id_aca_chargingIdentity "id-aca-chargingIdentity" +#define NID_id_aca_chargingIdentity 356 +#define OBJ_id_aca_chargingIdentity OBJ_id_aca,3L + +#define SN_id_aca_group "id-aca-group" +#define NID_id_aca_group 357 +#define OBJ_id_aca_group OBJ_id_aca,4L + +#define SN_id_aca_role "id-aca-role" +#define NID_id_aca_role 358 +#define OBJ_id_aca_role OBJ_id_aca,5L + +#define SN_id_aca_encAttrs "id-aca-encAttrs" +#define NID_id_aca_encAttrs 399 +#define OBJ_id_aca_encAttrs OBJ_id_aca,6L + +#define SN_id_qcs_pkixQCSyntax_v1 "id-qcs-pkixQCSyntax-v1" +#define NID_id_qcs_pkixQCSyntax_v1 359 +#define OBJ_id_qcs_pkixQCSyntax_v1 OBJ_id_qcs,1L + +#define SN_id_cct_crs "id-cct-crs" +#define NID_id_cct_crs 360 +#define OBJ_id_cct_crs OBJ_id_cct,1L + +#define SN_id_cct_PKIData "id-cct-PKIData" +#define NID_id_cct_PKIData 361 +#define OBJ_id_cct_PKIData OBJ_id_cct,2L + +#define SN_id_cct_PKIResponse "id-cct-PKIResponse" +#define NID_id_cct_PKIResponse 362 +#define OBJ_id_cct_PKIResponse OBJ_id_cct,3L + +#define SN_id_ppl_anyLanguage "id-ppl-anyLanguage" +#define LN_id_ppl_anyLanguage "Any language" +#define NID_id_ppl_anyLanguage 664 +#define OBJ_id_ppl_anyLanguage OBJ_id_ppl,0L + +#define SN_id_ppl_inheritAll "id-ppl-inheritAll" +#define LN_id_ppl_inheritAll "Inherit all" +#define NID_id_ppl_inheritAll 665 +#define OBJ_id_ppl_inheritAll OBJ_id_ppl,1L + +#define SN_Independent "id-ppl-independent" +#define LN_Independent "Independent" +#define NID_Independent 667 +#define OBJ_Independent OBJ_id_ppl,2L + +#define SN_ad_OCSP "OCSP" +#define LN_ad_OCSP "OCSP" +#define NID_ad_OCSP 178 +#define OBJ_ad_OCSP OBJ_id_ad,1L + +#define SN_ad_ca_issuers "caIssuers" +#define LN_ad_ca_issuers "CA Issuers" +#define NID_ad_ca_issuers 179 +#define OBJ_ad_ca_issuers OBJ_id_ad,2L + +#define SN_ad_timeStamping "ad_timestamping" +#define LN_ad_timeStamping "AD Time Stamping" +#define NID_ad_timeStamping 363 +#define OBJ_ad_timeStamping OBJ_id_ad,3L + +#define SN_ad_dvcs "AD_DVCS" +#define LN_ad_dvcs "ad dvcs" +#define NID_ad_dvcs 364 +#define OBJ_ad_dvcs OBJ_id_ad,4L + +#define SN_caRepository "caRepository" +#define LN_caRepository "CA Repository" +#define NID_caRepository 785 +#define OBJ_caRepository OBJ_id_ad,5L + +#define OBJ_id_pkix_OCSP OBJ_ad_OCSP + +#define SN_id_pkix_OCSP_basic "basicOCSPResponse" +#define LN_id_pkix_OCSP_basic "Basic OCSP Response" +#define NID_id_pkix_OCSP_basic 365 +#define OBJ_id_pkix_OCSP_basic OBJ_id_pkix_OCSP,1L + +#define SN_id_pkix_OCSP_Nonce "Nonce" +#define LN_id_pkix_OCSP_Nonce "OCSP Nonce" +#define NID_id_pkix_OCSP_Nonce 366 +#define OBJ_id_pkix_OCSP_Nonce OBJ_id_pkix_OCSP,2L + +#define SN_id_pkix_OCSP_CrlID "CrlID" +#define LN_id_pkix_OCSP_CrlID "OCSP CRL ID" +#define NID_id_pkix_OCSP_CrlID 367 +#define OBJ_id_pkix_OCSP_CrlID OBJ_id_pkix_OCSP,3L + +#define SN_id_pkix_OCSP_acceptableResponses "acceptableResponses" +#define LN_id_pkix_OCSP_acceptableResponses "Acceptable OCSP Responses" +#define NID_id_pkix_OCSP_acceptableResponses 368 +#define OBJ_id_pkix_OCSP_acceptableResponses OBJ_id_pkix_OCSP,4L + +#define SN_id_pkix_OCSP_noCheck "noCheck" +#define LN_id_pkix_OCSP_noCheck "OCSP No Check" +#define NID_id_pkix_OCSP_noCheck 369 +#define OBJ_id_pkix_OCSP_noCheck OBJ_id_pkix_OCSP,5L + +#define SN_id_pkix_OCSP_archiveCutoff "archiveCutoff" +#define LN_id_pkix_OCSP_archiveCutoff "OCSP Archive Cutoff" +#define NID_id_pkix_OCSP_archiveCutoff 370 +#define OBJ_id_pkix_OCSP_archiveCutoff OBJ_id_pkix_OCSP,6L + +#define SN_id_pkix_OCSP_serviceLocator "serviceLocator" +#define LN_id_pkix_OCSP_serviceLocator "OCSP Service Locator" +#define NID_id_pkix_OCSP_serviceLocator 371 +#define OBJ_id_pkix_OCSP_serviceLocator OBJ_id_pkix_OCSP,7L + +#define SN_id_pkix_OCSP_extendedStatus "extendedStatus" +#define LN_id_pkix_OCSP_extendedStatus "Extended OCSP Status" +#define NID_id_pkix_OCSP_extendedStatus 372 +#define OBJ_id_pkix_OCSP_extendedStatus OBJ_id_pkix_OCSP,8L + +#define SN_id_pkix_OCSP_valid "valid" +#define NID_id_pkix_OCSP_valid 373 +#define OBJ_id_pkix_OCSP_valid OBJ_id_pkix_OCSP,9L + +#define SN_id_pkix_OCSP_path "path" +#define NID_id_pkix_OCSP_path 374 +#define OBJ_id_pkix_OCSP_path OBJ_id_pkix_OCSP,10L + +#define SN_id_pkix_OCSP_trustRoot "trustRoot" +#define LN_id_pkix_OCSP_trustRoot "Trust Root" +#define NID_id_pkix_OCSP_trustRoot 375 +#define OBJ_id_pkix_OCSP_trustRoot OBJ_id_pkix_OCSP,11L + +#define SN_algorithm "algorithm" +#define LN_algorithm "algorithm" +#define NID_algorithm 376 +#define OBJ_algorithm 1L,3L,14L,3L,2L + +#define SN_md5WithRSA "RSA-NP-MD5" +#define LN_md5WithRSA "md5WithRSA" +#define NID_md5WithRSA 104 +#define OBJ_md5WithRSA OBJ_algorithm,3L + +#define SN_des_ecb "DES-ECB" +#define LN_des_ecb "des-ecb" +#define NID_des_ecb 29 +#define OBJ_des_ecb OBJ_algorithm,6L + +#define SN_des_cbc "DES-CBC" +#define LN_des_cbc "des-cbc" +#define NID_des_cbc 31 +#define OBJ_des_cbc OBJ_algorithm,7L + +#define SN_des_ofb64 "DES-OFB" +#define LN_des_ofb64 "des-ofb" +#define NID_des_ofb64 45 +#define OBJ_des_ofb64 OBJ_algorithm,8L + +#define SN_des_cfb64 "DES-CFB" +#define LN_des_cfb64 "des-cfb" +#define NID_des_cfb64 30 +#define OBJ_des_cfb64 OBJ_algorithm,9L + +#define SN_rsaSignature "rsaSignature" +#define NID_rsaSignature 377 +#define OBJ_rsaSignature OBJ_algorithm,11L + +#define SN_dsa_2 "DSA-old" +#define LN_dsa_2 "dsaEncryption-old" +#define NID_dsa_2 67 +#define OBJ_dsa_2 OBJ_algorithm,12L + +#define SN_dsaWithSHA "DSA-SHA" +#define LN_dsaWithSHA "dsaWithSHA" +#define NID_dsaWithSHA 66 +#define OBJ_dsaWithSHA OBJ_algorithm,13L + +#define SN_shaWithRSAEncryption "RSA-SHA" +#define LN_shaWithRSAEncryption "shaWithRSAEncryption" +#define NID_shaWithRSAEncryption 42 +#define OBJ_shaWithRSAEncryption OBJ_algorithm,15L + +#define SN_des_ede_ecb "DES-EDE" +#define LN_des_ede_ecb "des-ede" +#define NID_des_ede_ecb 32 +#define OBJ_des_ede_ecb OBJ_algorithm,17L + +#define SN_des_ede3_ecb "DES-EDE3" +#define LN_des_ede3_ecb "des-ede3" +#define NID_des_ede3_ecb 33 + +#define SN_des_ede_cbc "DES-EDE-CBC" +#define LN_des_ede_cbc "des-ede-cbc" +#define NID_des_ede_cbc 43 + +#define SN_des_ede_cfb64 "DES-EDE-CFB" +#define LN_des_ede_cfb64 "des-ede-cfb" +#define NID_des_ede_cfb64 60 + +#define SN_des_ede3_cfb64 "DES-EDE3-CFB" +#define LN_des_ede3_cfb64 "des-ede3-cfb" +#define NID_des_ede3_cfb64 61 + +#define SN_des_ede_ofb64 "DES-EDE-OFB" +#define LN_des_ede_ofb64 "des-ede-ofb" +#define NID_des_ede_ofb64 62 + +#define SN_des_ede3_ofb64 "DES-EDE3-OFB" +#define LN_des_ede3_ofb64 "des-ede3-ofb" +#define NID_des_ede3_ofb64 63 + +#define SN_desx_cbc "DESX-CBC" +#define LN_desx_cbc "desx-cbc" +#define NID_desx_cbc 80 + +#define SN_sha "SHA" +#define LN_sha "sha" +#define NID_sha 41 +#define OBJ_sha OBJ_algorithm,18L + +#define SN_sha1 "SHA1" +#define LN_sha1 "sha1" +#define NID_sha1 64 +#define OBJ_sha1 OBJ_algorithm,26L + +#define SN_dsaWithSHA1_2 "DSA-SHA1-old" +#define LN_dsaWithSHA1_2 "dsaWithSHA1-old" +#define NID_dsaWithSHA1_2 70 +#define OBJ_dsaWithSHA1_2 OBJ_algorithm,27L + +#define SN_sha1WithRSA "RSA-SHA1-2" +#define LN_sha1WithRSA "sha1WithRSA" +#define NID_sha1WithRSA 115 +#define OBJ_sha1WithRSA OBJ_algorithm,29L + +#define SN_ripemd160 "RIPEMD160" +#define LN_ripemd160 "ripemd160" +#define NID_ripemd160 117 +#define OBJ_ripemd160 1L,3L,36L,3L,2L,1L + +#define SN_ripemd160WithRSA "RSA-RIPEMD160" +#define LN_ripemd160WithRSA "ripemd160WithRSA" +#define NID_ripemd160WithRSA 119 +#define OBJ_ripemd160WithRSA 1L,3L,36L,3L,3L,1L,2L + +#define SN_blake2b512 "BLAKE2b512" +#define LN_blake2b512 "blake2b512" +#define NID_blake2b512 1056 +#define OBJ_blake2b512 1L,3L,6L,1L,4L,1L,1722L,12L,2L,1L,16L + +#define SN_blake2s256 "BLAKE2s256" +#define LN_blake2s256 "blake2s256" +#define NID_blake2s256 1057 +#define OBJ_blake2s256 1L,3L,6L,1L,4L,1L,1722L,12L,2L,2L,8L + +#define SN_sxnet "SXNetID" +#define LN_sxnet "Strong Extranet ID" +#define NID_sxnet 143 +#define OBJ_sxnet 1L,3L,101L,1L,4L,1L + +#define SN_X500 "X500" +#define LN_X500 "directory services (X.500)" +#define NID_X500 11 +#define OBJ_X500 2L,5L + +#define SN_X509 "X509" +#define NID_X509 12 +#define OBJ_X509 OBJ_X500,4L + +#define SN_commonName "CN" +#define LN_commonName "commonName" +#define NID_commonName 13 +#define OBJ_commonName OBJ_X509,3L + +#define SN_surname "SN" +#define LN_surname "surname" +#define NID_surname 100 +#define OBJ_surname OBJ_X509,4L + +#define LN_serialNumber "serialNumber" +#define NID_serialNumber 105 +#define OBJ_serialNumber OBJ_X509,5L + +#define SN_countryName "C" +#define LN_countryName "countryName" +#define NID_countryName 14 +#define OBJ_countryName OBJ_X509,6L + +#define SN_localityName "L" +#define LN_localityName "localityName" +#define NID_localityName 15 +#define OBJ_localityName OBJ_X509,7L + +#define SN_stateOrProvinceName "ST" +#define LN_stateOrProvinceName "stateOrProvinceName" +#define NID_stateOrProvinceName 16 +#define OBJ_stateOrProvinceName OBJ_X509,8L + +#define SN_streetAddress "street" +#define LN_streetAddress "streetAddress" +#define NID_streetAddress 660 +#define OBJ_streetAddress OBJ_X509,9L + +#define SN_organizationName "O" +#define LN_organizationName "organizationName" +#define NID_organizationName 17 +#define OBJ_organizationName OBJ_X509,10L + +#define SN_organizationalUnitName "OU" +#define LN_organizationalUnitName "organizationalUnitName" +#define NID_organizationalUnitName 18 +#define OBJ_organizationalUnitName OBJ_X509,11L + +#define SN_title "title" +#define LN_title "title" +#define NID_title 106 +#define OBJ_title OBJ_X509,12L + +#define LN_description "description" +#define NID_description 107 +#define OBJ_description OBJ_X509,13L + +#define LN_searchGuide "searchGuide" +#define NID_searchGuide 859 +#define OBJ_searchGuide OBJ_X509,14L + +#define LN_businessCategory "businessCategory" +#define NID_businessCategory 860 +#define OBJ_businessCategory OBJ_X509,15L + +#define LN_postalAddress "postalAddress" +#define NID_postalAddress 861 +#define OBJ_postalAddress OBJ_X509,16L + +#define LN_postalCode "postalCode" +#define NID_postalCode 661 +#define OBJ_postalCode OBJ_X509,17L + +#define LN_postOfficeBox "postOfficeBox" +#define NID_postOfficeBox 862 +#define OBJ_postOfficeBox OBJ_X509,18L + +#define LN_physicalDeliveryOfficeName "physicalDeliveryOfficeName" +#define NID_physicalDeliveryOfficeName 863 +#define OBJ_physicalDeliveryOfficeName OBJ_X509,19L + +#define LN_telephoneNumber "telephoneNumber" +#define NID_telephoneNumber 864 +#define OBJ_telephoneNumber OBJ_X509,20L + +#define LN_telexNumber "telexNumber" +#define NID_telexNumber 865 +#define OBJ_telexNumber OBJ_X509,21L + +#define LN_teletexTerminalIdentifier "teletexTerminalIdentifier" +#define NID_teletexTerminalIdentifier 866 +#define OBJ_teletexTerminalIdentifier OBJ_X509,22L + +#define LN_facsimileTelephoneNumber "facsimileTelephoneNumber" +#define NID_facsimileTelephoneNumber 867 +#define OBJ_facsimileTelephoneNumber OBJ_X509,23L + +#define LN_x121Address "x121Address" +#define NID_x121Address 868 +#define OBJ_x121Address OBJ_X509,24L + +#define LN_internationaliSDNNumber "internationaliSDNNumber" +#define NID_internationaliSDNNumber 869 +#define OBJ_internationaliSDNNumber OBJ_X509,25L + +#define LN_registeredAddress "registeredAddress" +#define NID_registeredAddress 870 +#define OBJ_registeredAddress OBJ_X509,26L + +#define LN_destinationIndicator "destinationIndicator" +#define NID_destinationIndicator 871 +#define OBJ_destinationIndicator OBJ_X509,27L + +#define LN_preferredDeliveryMethod "preferredDeliveryMethod" +#define NID_preferredDeliveryMethod 872 +#define OBJ_preferredDeliveryMethod OBJ_X509,28L + +#define LN_presentationAddress "presentationAddress" +#define NID_presentationAddress 873 +#define OBJ_presentationAddress OBJ_X509,29L + +#define LN_supportedApplicationContext "supportedApplicationContext" +#define NID_supportedApplicationContext 874 +#define OBJ_supportedApplicationContext OBJ_X509,30L + +#define SN_member "member" +#define NID_member 875 +#define OBJ_member OBJ_X509,31L + +#define SN_owner "owner" +#define NID_owner 876 +#define OBJ_owner OBJ_X509,32L + +#define LN_roleOccupant "roleOccupant" +#define NID_roleOccupant 877 +#define OBJ_roleOccupant OBJ_X509,33L + +#define SN_seeAlso "seeAlso" +#define NID_seeAlso 878 +#define OBJ_seeAlso OBJ_X509,34L + +#define LN_userPassword "userPassword" +#define NID_userPassword 879 +#define OBJ_userPassword OBJ_X509,35L + +#define LN_userCertificate "userCertificate" +#define NID_userCertificate 880 +#define OBJ_userCertificate OBJ_X509,36L + +#define LN_cACertificate "cACertificate" +#define NID_cACertificate 881 +#define OBJ_cACertificate OBJ_X509,37L + +#define LN_authorityRevocationList "authorityRevocationList" +#define NID_authorityRevocationList 882 +#define OBJ_authorityRevocationList OBJ_X509,38L + +#define LN_certificateRevocationList "certificateRevocationList" +#define NID_certificateRevocationList 883 +#define OBJ_certificateRevocationList OBJ_X509,39L + +#define LN_crossCertificatePair "crossCertificatePair" +#define NID_crossCertificatePair 884 +#define OBJ_crossCertificatePair OBJ_X509,40L + +#define SN_name "name" +#define LN_name "name" +#define NID_name 173 +#define OBJ_name OBJ_X509,41L + +#define SN_givenName "GN" +#define LN_givenName "givenName" +#define NID_givenName 99 +#define OBJ_givenName OBJ_X509,42L + +#define SN_initials "initials" +#define LN_initials "initials" +#define NID_initials 101 +#define OBJ_initials OBJ_X509,43L + +#define LN_generationQualifier "generationQualifier" +#define NID_generationQualifier 509 +#define OBJ_generationQualifier OBJ_X509,44L + +#define LN_x500UniqueIdentifier "x500UniqueIdentifier" +#define NID_x500UniqueIdentifier 503 +#define OBJ_x500UniqueIdentifier OBJ_X509,45L + +#define SN_dnQualifier "dnQualifier" +#define LN_dnQualifier "dnQualifier" +#define NID_dnQualifier 174 +#define OBJ_dnQualifier OBJ_X509,46L + +#define LN_enhancedSearchGuide "enhancedSearchGuide" +#define NID_enhancedSearchGuide 885 +#define OBJ_enhancedSearchGuide OBJ_X509,47L + +#define LN_protocolInformation "protocolInformation" +#define NID_protocolInformation 886 +#define OBJ_protocolInformation OBJ_X509,48L + +#define LN_distinguishedName "distinguishedName" +#define NID_distinguishedName 887 +#define OBJ_distinguishedName OBJ_X509,49L + +#define LN_uniqueMember "uniqueMember" +#define NID_uniqueMember 888 +#define OBJ_uniqueMember OBJ_X509,50L + +#define LN_houseIdentifier "houseIdentifier" +#define NID_houseIdentifier 889 +#define OBJ_houseIdentifier OBJ_X509,51L + +#define LN_supportedAlgorithms "supportedAlgorithms" +#define NID_supportedAlgorithms 890 +#define OBJ_supportedAlgorithms OBJ_X509,52L + +#define LN_deltaRevocationList "deltaRevocationList" +#define NID_deltaRevocationList 891 +#define OBJ_deltaRevocationList OBJ_X509,53L + +#define SN_dmdName "dmdName" +#define NID_dmdName 892 +#define OBJ_dmdName OBJ_X509,54L + +#define LN_pseudonym "pseudonym" +#define NID_pseudonym 510 +#define OBJ_pseudonym OBJ_X509,65L + +#define SN_role "role" +#define LN_role "role" +#define NID_role 400 +#define OBJ_role OBJ_X509,72L + +#define LN_organizationIdentifier "organizationIdentifier" +#define NID_organizationIdentifier 1089 +#define OBJ_organizationIdentifier OBJ_X509,97L + +#define SN_countryCode3c "c3" +#define LN_countryCode3c "countryCode3c" +#define NID_countryCode3c 1090 +#define OBJ_countryCode3c OBJ_X509,98L + +#define SN_countryCode3n "n3" +#define LN_countryCode3n "countryCode3n" +#define NID_countryCode3n 1091 +#define OBJ_countryCode3n OBJ_X509,99L + +#define LN_dnsName "dnsName" +#define NID_dnsName 1092 +#define OBJ_dnsName OBJ_X509,100L + +#define SN_X500algorithms "X500algorithms" +#define LN_X500algorithms "directory services - algorithms" +#define NID_X500algorithms 378 +#define OBJ_X500algorithms OBJ_X500,8L + +#define SN_rsa "RSA" +#define LN_rsa "rsa" +#define NID_rsa 19 +#define OBJ_rsa OBJ_X500algorithms,1L,1L + +#define SN_mdc2WithRSA "RSA-MDC2" +#define LN_mdc2WithRSA "mdc2WithRSA" +#define NID_mdc2WithRSA 96 +#define OBJ_mdc2WithRSA OBJ_X500algorithms,3L,100L + +#define SN_mdc2 "MDC2" +#define LN_mdc2 "mdc2" +#define NID_mdc2 95 +#define OBJ_mdc2 OBJ_X500algorithms,3L,101L + +#define SN_id_ce "id-ce" +#define NID_id_ce 81 +#define OBJ_id_ce OBJ_X500,29L + +#define SN_subject_directory_attributes "subjectDirectoryAttributes" +#define LN_subject_directory_attributes "X509v3 Subject Directory Attributes" +#define NID_subject_directory_attributes 769 +#define OBJ_subject_directory_attributes OBJ_id_ce,9L + +#define SN_subject_key_identifier "subjectKeyIdentifier" +#define LN_subject_key_identifier "X509v3 Subject Key Identifier" +#define NID_subject_key_identifier 82 +#define OBJ_subject_key_identifier OBJ_id_ce,14L + +#define SN_key_usage "keyUsage" +#define LN_key_usage "X509v3 Key Usage" +#define NID_key_usage 83 +#define OBJ_key_usage OBJ_id_ce,15L + +#define SN_private_key_usage_period "privateKeyUsagePeriod" +#define LN_private_key_usage_period "X509v3 Private Key Usage Period" +#define NID_private_key_usage_period 84 +#define OBJ_private_key_usage_period OBJ_id_ce,16L + +#define SN_subject_alt_name "subjectAltName" +#define LN_subject_alt_name "X509v3 Subject Alternative Name" +#define NID_subject_alt_name 85 +#define OBJ_subject_alt_name OBJ_id_ce,17L + +#define SN_issuer_alt_name "issuerAltName" +#define LN_issuer_alt_name "X509v3 Issuer Alternative Name" +#define NID_issuer_alt_name 86 +#define OBJ_issuer_alt_name OBJ_id_ce,18L + +#define SN_basic_constraints "basicConstraints" +#define LN_basic_constraints "X509v3 Basic Constraints" +#define NID_basic_constraints 87 +#define OBJ_basic_constraints OBJ_id_ce,19L + +#define SN_crl_number "crlNumber" +#define LN_crl_number "X509v3 CRL Number" +#define NID_crl_number 88 +#define OBJ_crl_number OBJ_id_ce,20L + +#define SN_crl_reason "CRLReason" +#define LN_crl_reason "X509v3 CRL Reason Code" +#define NID_crl_reason 141 +#define OBJ_crl_reason OBJ_id_ce,21L + +#define SN_invalidity_date "invalidityDate" +#define LN_invalidity_date "Invalidity Date" +#define NID_invalidity_date 142 +#define OBJ_invalidity_date OBJ_id_ce,24L + +#define SN_delta_crl "deltaCRL" +#define LN_delta_crl "X509v3 Delta CRL Indicator" +#define NID_delta_crl 140 +#define OBJ_delta_crl OBJ_id_ce,27L + +#define SN_issuing_distribution_point "issuingDistributionPoint" +#define LN_issuing_distribution_point "X509v3 Issuing Distribution Point" +#define NID_issuing_distribution_point 770 +#define OBJ_issuing_distribution_point OBJ_id_ce,28L + +#define SN_certificate_issuer "certificateIssuer" +#define LN_certificate_issuer "X509v3 Certificate Issuer" +#define NID_certificate_issuer 771 +#define OBJ_certificate_issuer OBJ_id_ce,29L + +#define SN_name_constraints "nameConstraints" +#define LN_name_constraints "X509v3 Name Constraints" +#define NID_name_constraints 666 +#define OBJ_name_constraints OBJ_id_ce,30L + +#define SN_crl_distribution_points "crlDistributionPoints" +#define LN_crl_distribution_points "X509v3 CRL Distribution Points" +#define NID_crl_distribution_points 103 +#define OBJ_crl_distribution_points OBJ_id_ce,31L + +#define SN_certificate_policies "certificatePolicies" +#define LN_certificate_policies "X509v3 Certificate Policies" +#define NID_certificate_policies 89 +#define OBJ_certificate_policies OBJ_id_ce,32L + +#define SN_any_policy "anyPolicy" +#define LN_any_policy "X509v3 Any Policy" +#define NID_any_policy 746 +#define OBJ_any_policy OBJ_certificate_policies,0L + +#define SN_policy_mappings "policyMappings" +#define LN_policy_mappings "X509v3 Policy Mappings" +#define NID_policy_mappings 747 +#define OBJ_policy_mappings OBJ_id_ce,33L + +#define SN_authority_key_identifier "authorityKeyIdentifier" +#define LN_authority_key_identifier "X509v3 Authority Key Identifier" +#define NID_authority_key_identifier 90 +#define OBJ_authority_key_identifier OBJ_id_ce,35L + +#define SN_policy_constraints "policyConstraints" +#define LN_policy_constraints "X509v3 Policy Constraints" +#define NID_policy_constraints 401 +#define OBJ_policy_constraints OBJ_id_ce,36L + +#define SN_ext_key_usage "extendedKeyUsage" +#define LN_ext_key_usage "X509v3 Extended Key Usage" +#define NID_ext_key_usage 126 +#define OBJ_ext_key_usage OBJ_id_ce,37L + +#define SN_freshest_crl "freshestCRL" +#define LN_freshest_crl "X509v3 Freshest CRL" +#define NID_freshest_crl 857 +#define OBJ_freshest_crl OBJ_id_ce,46L + +#define SN_inhibit_any_policy "inhibitAnyPolicy" +#define LN_inhibit_any_policy "X509v3 Inhibit Any Policy" +#define NID_inhibit_any_policy 748 +#define OBJ_inhibit_any_policy OBJ_id_ce,54L + +#define SN_target_information "targetInformation" +#define LN_target_information "X509v3 AC Targeting" +#define NID_target_information 402 +#define OBJ_target_information OBJ_id_ce,55L + +#define SN_no_rev_avail "noRevAvail" +#define LN_no_rev_avail "X509v3 No Revocation Available" +#define NID_no_rev_avail 403 +#define OBJ_no_rev_avail OBJ_id_ce,56L + +#define SN_anyExtendedKeyUsage "anyExtendedKeyUsage" +#define LN_anyExtendedKeyUsage "Any Extended Key Usage" +#define NID_anyExtendedKeyUsage 910 +#define OBJ_anyExtendedKeyUsage OBJ_ext_key_usage,0L + +#define SN_netscape "Netscape" +#define LN_netscape "Netscape Communications Corp." +#define NID_netscape 57 +#define OBJ_netscape 2L,16L,840L,1L,113730L + +#define SN_netscape_cert_extension "nsCertExt" +#define LN_netscape_cert_extension "Netscape Certificate Extension" +#define NID_netscape_cert_extension 58 +#define OBJ_netscape_cert_extension OBJ_netscape,1L + +#define SN_netscape_data_type "nsDataType" +#define LN_netscape_data_type "Netscape Data Type" +#define NID_netscape_data_type 59 +#define OBJ_netscape_data_type OBJ_netscape,2L + +#define SN_netscape_cert_type "nsCertType" +#define LN_netscape_cert_type "Netscape Cert Type" +#define NID_netscape_cert_type 71 +#define OBJ_netscape_cert_type OBJ_netscape_cert_extension,1L + +#define SN_netscape_base_url "nsBaseUrl" +#define LN_netscape_base_url "Netscape Base Url" +#define NID_netscape_base_url 72 +#define OBJ_netscape_base_url OBJ_netscape_cert_extension,2L + +#define SN_netscape_revocation_url "nsRevocationUrl" +#define LN_netscape_revocation_url "Netscape Revocation Url" +#define NID_netscape_revocation_url 73 +#define OBJ_netscape_revocation_url OBJ_netscape_cert_extension,3L + +#define SN_netscape_ca_revocation_url "nsCaRevocationUrl" +#define LN_netscape_ca_revocation_url "Netscape CA Revocation Url" +#define NID_netscape_ca_revocation_url 74 +#define OBJ_netscape_ca_revocation_url OBJ_netscape_cert_extension,4L + +#define SN_netscape_renewal_url "nsRenewalUrl" +#define LN_netscape_renewal_url "Netscape Renewal Url" +#define NID_netscape_renewal_url 75 +#define OBJ_netscape_renewal_url OBJ_netscape_cert_extension,7L + +#define SN_netscape_ca_policy_url "nsCaPolicyUrl" +#define LN_netscape_ca_policy_url "Netscape CA Policy Url" +#define NID_netscape_ca_policy_url 76 +#define OBJ_netscape_ca_policy_url OBJ_netscape_cert_extension,8L + +#define SN_netscape_ssl_server_name "nsSslServerName" +#define LN_netscape_ssl_server_name "Netscape SSL Server Name" +#define NID_netscape_ssl_server_name 77 +#define OBJ_netscape_ssl_server_name OBJ_netscape_cert_extension,12L + +#define SN_netscape_comment "nsComment" +#define LN_netscape_comment "Netscape Comment" +#define NID_netscape_comment 78 +#define OBJ_netscape_comment OBJ_netscape_cert_extension,13L + +#define SN_netscape_cert_sequence "nsCertSequence" +#define LN_netscape_cert_sequence "Netscape Certificate Sequence" +#define NID_netscape_cert_sequence 79 +#define OBJ_netscape_cert_sequence OBJ_netscape_data_type,5L + +#define SN_ns_sgc "nsSGC" +#define LN_ns_sgc "Netscape Server Gated Crypto" +#define NID_ns_sgc 139 +#define OBJ_ns_sgc OBJ_netscape,4L,1L + +#define SN_org "ORG" +#define LN_org "org" +#define NID_org 379 +#define OBJ_org OBJ_iso,3L + +#define SN_dod "DOD" +#define LN_dod "dod" +#define NID_dod 380 +#define OBJ_dod OBJ_org,6L + +#define SN_iana "IANA" +#define LN_iana "iana" +#define NID_iana 381 +#define OBJ_iana OBJ_dod,1L + +#define OBJ_internet OBJ_iana + +#define SN_Directory "directory" +#define LN_Directory "Directory" +#define NID_Directory 382 +#define OBJ_Directory OBJ_internet,1L + +#define SN_Management "mgmt" +#define LN_Management "Management" +#define NID_Management 383 +#define OBJ_Management OBJ_internet,2L + +#define SN_Experimental "experimental" +#define LN_Experimental "Experimental" +#define NID_Experimental 384 +#define OBJ_Experimental OBJ_internet,3L + +#define SN_Private "private" +#define LN_Private "Private" +#define NID_Private 385 +#define OBJ_Private OBJ_internet,4L + +#define SN_Security "security" +#define LN_Security "Security" +#define NID_Security 386 +#define OBJ_Security OBJ_internet,5L + +#define SN_SNMPv2 "snmpv2" +#define LN_SNMPv2 "SNMPv2" +#define NID_SNMPv2 387 +#define OBJ_SNMPv2 OBJ_internet,6L + +#define LN_Mail "Mail" +#define NID_Mail 388 +#define OBJ_Mail OBJ_internet,7L + +#define SN_Enterprises "enterprises" +#define LN_Enterprises "Enterprises" +#define NID_Enterprises 389 +#define OBJ_Enterprises OBJ_Private,1L + +#define SN_dcObject "dcobject" +#define LN_dcObject "dcObject" +#define NID_dcObject 390 +#define OBJ_dcObject OBJ_Enterprises,1466L,344L + +#define SN_mime_mhs "mime-mhs" +#define LN_mime_mhs "MIME MHS" +#define NID_mime_mhs 504 +#define OBJ_mime_mhs OBJ_Mail,1L + +#define SN_mime_mhs_headings "mime-mhs-headings" +#define LN_mime_mhs_headings "mime-mhs-headings" +#define NID_mime_mhs_headings 505 +#define OBJ_mime_mhs_headings OBJ_mime_mhs,1L + +#define SN_mime_mhs_bodies "mime-mhs-bodies" +#define LN_mime_mhs_bodies "mime-mhs-bodies" +#define NID_mime_mhs_bodies 506 +#define OBJ_mime_mhs_bodies OBJ_mime_mhs,2L + +#define SN_id_hex_partial_message "id-hex-partial-message" +#define LN_id_hex_partial_message "id-hex-partial-message" +#define NID_id_hex_partial_message 507 +#define OBJ_id_hex_partial_message OBJ_mime_mhs_headings,1L + +#define SN_id_hex_multipart_message "id-hex-multipart-message" +#define LN_id_hex_multipart_message "id-hex-multipart-message" +#define NID_id_hex_multipart_message 508 +#define OBJ_id_hex_multipart_message OBJ_mime_mhs_headings,2L + +#define SN_zlib_compression "ZLIB" +#define LN_zlib_compression "zlib compression" +#define NID_zlib_compression 125 +#define OBJ_zlib_compression OBJ_id_smime_alg,8L + +#define OBJ_csor 2L,16L,840L,1L,101L,3L + +#define OBJ_nistAlgorithms OBJ_csor,4L + +#define OBJ_aes OBJ_nistAlgorithms,1L + +#define SN_aes_128_ecb "AES-128-ECB" +#define LN_aes_128_ecb "aes-128-ecb" +#define NID_aes_128_ecb 418 +#define OBJ_aes_128_ecb OBJ_aes,1L + +#define SN_aes_128_cbc "AES-128-CBC" +#define LN_aes_128_cbc "aes-128-cbc" +#define NID_aes_128_cbc 419 +#define OBJ_aes_128_cbc OBJ_aes,2L + +#define SN_aes_128_ofb128 "AES-128-OFB" +#define LN_aes_128_ofb128 "aes-128-ofb" +#define NID_aes_128_ofb128 420 +#define OBJ_aes_128_ofb128 OBJ_aes,3L + +#define SN_aes_128_cfb128 "AES-128-CFB" +#define LN_aes_128_cfb128 "aes-128-cfb" +#define NID_aes_128_cfb128 421 +#define OBJ_aes_128_cfb128 OBJ_aes,4L + +#define SN_id_aes128_wrap "id-aes128-wrap" +#define NID_id_aes128_wrap 788 +#define OBJ_id_aes128_wrap OBJ_aes,5L + +#define SN_aes_128_gcm "id-aes128-GCM" +#define LN_aes_128_gcm "aes-128-gcm" +#define NID_aes_128_gcm 895 +#define OBJ_aes_128_gcm OBJ_aes,6L + +#define SN_aes_128_ccm "id-aes128-CCM" +#define LN_aes_128_ccm "aes-128-ccm" +#define NID_aes_128_ccm 896 +#define OBJ_aes_128_ccm OBJ_aes,7L + +#define SN_id_aes128_wrap_pad "id-aes128-wrap-pad" +#define NID_id_aes128_wrap_pad 897 +#define OBJ_id_aes128_wrap_pad OBJ_aes,8L + +#define SN_aes_192_ecb "AES-192-ECB" +#define LN_aes_192_ecb "aes-192-ecb" +#define NID_aes_192_ecb 422 +#define OBJ_aes_192_ecb OBJ_aes,21L + +#define SN_aes_192_cbc "AES-192-CBC" +#define LN_aes_192_cbc "aes-192-cbc" +#define NID_aes_192_cbc 423 +#define OBJ_aes_192_cbc OBJ_aes,22L + +#define SN_aes_192_ofb128 "AES-192-OFB" +#define LN_aes_192_ofb128 "aes-192-ofb" +#define NID_aes_192_ofb128 424 +#define OBJ_aes_192_ofb128 OBJ_aes,23L + +#define SN_aes_192_cfb128 "AES-192-CFB" +#define LN_aes_192_cfb128 "aes-192-cfb" +#define NID_aes_192_cfb128 425 +#define OBJ_aes_192_cfb128 OBJ_aes,24L + +#define SN_id_aes192_wrap "id-aes192-wrap" +#define NID_id_aes192_wrap 789 +#define OBJ_id_aes192_wrap OBJ_aes,25L + +#define SN_aes_192_gcm "id-aes192-GCM" +#define LN_aes_192_gcm "aes-192-gcm" +#define NID_aes_192_gcm 898 +#define OBJ_aes_192_gcm OBJ_aes,26L + +#define SN_aes_192_ccm "id-aes192-CCM" +#define LN_aes_192_ccm "aes-192-ccm" +#define NID_aes_192_ccm 899 +#define OBJ_aes_192_ccm OBJ_aes,27L + +#define SN_id_aes192_wrap_pad "id-aes192-wrap-pad" +#define NID_id_aes192_wrap_pad 900 +#define OBJ_id_aes192_wrap_pad OBJ_aes,28L + +#define SN_aes_256_ecb "AES-256-ECB" +#define LN_aes_256_ecb "aes-256-ecb" +#define NID_aes_256_ecb 426 +#define OBJ_aes_256_ecb OBJ_aes,41L + +#define SN_aes_256_cbc "AES-256-CBC" +#define LN_aes_256_cbc "aes-256-cbc" +#define NID_aes_256_cbc 427 +#define OBJ_aes_256_cbc OBJ_aes,42L + +#define SN_aes_256_ofb128 "AES-256-OFB" +#define LN_aes_256_ofb128 "aes-256-ofb" +#define NID_aes_256_ofb128 428 +#define OBJ_aes_256_ofb128 OBJ_aes,43L + +#define SN_aes_256_cfb128 "AES-256-CFB" +#define LN_aes_256_cfb128 "aes-256-cfb" +#define NID_aes_256_cfb128 429 +#define OBJ_aes_256_cfb128 OBJ_aes,44L + +#define SN_id_aes256_wrap "id-aes256-wrap" +#define NID_id_aes256_wrap 790 +#define OBJ_id_aes256_wrap OBJ_aes,45L + +#define SN_aes_256_gcm "id-aes256-GCM" +#define LN_aes_256_gcm "aes-256-gcm" +#define NID_aes_256_gcm 901 +#define OBJ_aes_256_gcm OBJ_aes,46L + +#define SN_aes_256_ccm "id-aes256-CCM" +#define LN_aes_256_ccm "aes-256-ccm" +#define NID_aes_256_ccm 902 +#define OBJ_aes_256_ccm OBJ_aes,47L + +#define SN_id_aes256_wrap_pad "id-aes256-wrap-pad" +#define NID_id_aes256_wrap_pad 903 +#define OBJ_id_aes256_wrap_pad OBJ_aes,48L + +#define SN_aes_128_xts "AES-128-XTS" +#define LN_aes_128_xts "aes-128-xts" +#define NID_aes_128_xts 913 +#define OBJ_aes_128_xts OBJ_ieee_siswg,0L,1L,1L + +#define SN_aes_256_xts "AES-256-XTS" +#define LN_aes_256_xts "aes-256-xts" +#define NID_aes_256_xts 914 +#define OBJ_aes_256_xts OBJ_ieee_siswg,0L,1L,2L + +#define SN_aes_128_cfb1 "AES-128-CFB1" +#define LN_aes_128_cfb1 "aes-128-cfb1" +#define NID_aes_128_cfb1 650 + +#define SN_aes_192_cfb1 "AES-192-CFB1" +#define LN_aes_192_cfb1 "aes-192-cfb1" +#define NID_aes_192_cfb1 651 + +#define SN_aes_256_cfb1 "AES-256-CFB1" +#define LN_aes_256_cfb1 "aes-256-cfb1" +#define NID_aes_256_cfb1 652 + +#define SN_aes_128_cfb8 "AES-128-CFB8" +#define LN_aes_128_cfb8 "aes-128-cfb8" +#define NID_aes_128_cfb8 653 + +#define SN_aes_192_cfb8 "AES-192-CFB8" +#define LN_aes_192_cfb8 "aes-192-cfb8" +#define NID_aes_192_cfb8 654 + +#define SN_aes_256_cfb8 "AES-256-CFB8" +#define LN_aes_256_cfb8 "aes-256-cfb8" +#define NID_aes_256_cfb8 655 + +#define SN_aes_128_ctr "AES-128-CTR" +#define LN_aes_128_ctr "aes-128-ctr" +#define NID_aes_128_ctr 904 + +#define SN_aes_192_ctr "AES-192-CTR" +#define LN_aes_192_ctr "aes-192-ctr" +#define NID_aes_192_ctr 905 + +#define SN_aes_256_ctr "AES-256-CTR" +#define LN_aes_256_ctr "aes-256-ctr" +#define NID_aes_256_ctr 906 + +#define SN_aes_128_ocb "AES-128-OCB" +#define LN_aes_128_ocb "aes-128-ocb" +#define NID_aes_128_ocb 958 + +#define SN_aes_192_ocb "AES-192-OCB" +#define LN_aes_192_ocb "aes-192-ocb" +#define NID_aes_192_ocb 959 + +#define SN_aes_256_ocb "AES-256-OCB" +#define LN_aes_256_ocb "aes-256-ocb" +#define NID_aes_256_ocb 960 + +#define SN_des_cfb1 "DES-CFB1" +#define LN_des_cfb1 "des-cfb1" +#define NID_des_cfb1 656 + +#define SN_des_cfb8 "DES-CFB8" +#define LN_des_cfb8 "des-cfb8" +#define NID_des_cfb8 657 + +#define SN_des_ede3_cfb1 "DES-EDE3-CFB1" +#define LN_des_ede3_cfb1 "des-ede3-cfb1" +#define NID_des_ede3_cfb1 658 + +#define SN_des_ede3_cfb8 "DES-EDE3-CFB8" +#define LN_des_ede3_cfb8 "des-ede3-cfb8" +#define NID_des_ede3_cfb8 659 + +#define OBJ_nist_hashalgs OBJ_nistAlgorithms,2L + +#define SN_sha256 "SHA256" +#define LN_sha256 "sha256" +#define NID_sha256 672 +#define OBJ_sha256 OBJ_nist_hashalgs,1L + +#define SN_sha384 "SHA384" +#define LN_sha384 "sha384" +#define NID_sha384 673 +#define OBJ_sha384 OBJ_nist_hashalgs,2L + +#define SN_sha512 "SHA512" +#define LN_sha512 "sha512" +#define NID_sha512 674 +#define OBJ_sha512 OBJ_nist_hashalgs,3L + +#define SN_sha224 "SHA224" +#define LN_sha224 "sha224" +#define NID_sha224 675 +#define OBJ_sha224 OBJ_nist_hashalgs,4L + +#define SN_sha512_224 "SHA512-224" +#define LN_sha512_224 "sha512-224" +#define NID_sha512_224 1094 +#define OBJ_sha512_224 OBJ_nist_hashalgs,5L + +#define SN_sha512_256 "SHA512-256" +#define LN_sha512_256 "sha512-256" +#define NID_sha512_256 1095 +#define OBJ_sha512_256 OBJ_nist_hashalgs,6L + +#define SN_sha3_224 "SHA3-224" +#define LN_sha3_224 "sha3-224" +#define NID_sha3_224 1096 +#define OBJ_sha3_224 OBJ_nist_hashalgs,7L + +#define SN_sha3_256 "SHA3-256" +#define LN_sha3_256 "sha3-256" +#define NID_sha3_256 1097 +#define OBJ_sha3_256 OBJ_nist_hashalgs,8L + +#define SN_sha3_384 "SHA3-384" +#define LN_sha3_384 "sha3-384" +#define NID_sha3_384 1098 +#define OBJ_sha3_384 OBJ_nist_hashalgs,9L + +#define SN_sha3_512 "SHA3-512" +#define LN_sha3_512 "sha3-512" +#define NID_sha3_512 1099 +#define OBJ_sha3_512 OBJ_nist_hashalgs,10L + +#define SN_shake128 "SHAKE128" +#define LN_shake128 "shake128" +#define NID_shake128 1100 +#define OBJ_shake128 OBJ_nist_hashalgs,11L + +#define SN_shake256 "SHAKE256" +#define LN_shake256 "shake256" +#define NID_shake256 1101 +#define OBJ_shake256 OBJ_nist_hashalgs,12L + +#define SN_hmac_sha3_224 "id-hmacWithSHA3-224" +#define LN_hmac_sha3_224 "hmac-sha3-224" +#define NID_hmac_sha3_224 1102 +#define OBJ_hmac_sha3_224 OBJ_nist_hashalgs,13L + +#define SN_hmac_sha3_256 "id-hmacWithSHA3-256" +#define LN_hmac_sha3_256 "hmac-sha3-256" +#define NID_hmac_sha3_256 1103 +#define OBJ_hmac_sha3_256 OBJ_nist_hashalgs,14L + +#define SN_hmac_sha3_384 "id-hmacWithSHA3-384" +#define LN_hmac_sha3_384 "hmac-sha3-384" +#define NID_hmac_sha3_384 1104 +#define OBJ_hmac_sha3_384 OBJ_nist_hashalgs,15L + +#define SN_hmac_sha3_512 "id-hmacWithSHA3-512" +#define LN_hmac_sha3_512 "hmac-sha3-512" +#define NID_hmac_sha3_512 1105 +#define OBJ_hmac_sha3_512 OBJ_nist_hashalgs,16L + +#define OBJ_dsa_with_sha2 OBJ_nistAlgorithms,3L + +#define SN_dsa_with_SHA224 "dsa_with_SHA224" +#define NID_dsa_with_SHA224 802 +#define OBJ_dsa_with_SHA224 OBJ_dsa_with_sha2,1L + +#define SN_dsa_with_SHA256 "dsa_with_SHA256" +#define NID_dsa_with_SHA256 803 +#define OBJ_dsa_with_SHA256 OBJ_dsa_with_sha2,2L + +#define OBJ_sigAlgs OBJ_nistAlgorithms,3L + +#define SN_dsa_with_SHA384 "id-dsa-with-sha384" +#define LN_dsa_with_SHA384 "dsa_with_SHA384" +#define NID_dsa_with_SHA384 1106 +#define OBJ_dsa_with_SHA384 OBJ_sigAlgs,3L + +#define SN_dsa_with_SHA512 "id-dsa-with-sha512" +#define LN_dsa_with_SHA512 "dsa_with_SHA512" +#define NID_dsa_with_SHA512 1107 +#define OBJ_dsa_with_SHA512 OBJ_sigAlgs,4L + +#define SN_dsa_with_SHA3_224 "id-dsa-with-sha3-224" +#define LN_dsa_with_SHA3_224 "dsa_with_SHA3-224" +#define NID_dsa_with_SHA3_224 1108 +#define OBJ_dsa_with_SHA3_224 OBJ_sigAlgs,5L + +#define SN_dsa_with_SHA3_256 "id-dsa-with-sha3-256" +#define LN_dsa_with_SHA3_256 "dsa_with_SHA3-256" +#define NID_dsa_with_SHA3_256 1109 +#define OBJ_dsa_with_SHA3_256 OBJ_sigAlgs,6L + +#define SN_dsa_with_SHA3_384 "id-dsa-with-sha3-384" +#define LN_dsa_with_SHA3_384 "dsa_with_SHA3-384" +#define NID_dsa_with_SHA3_384 1110 +#define OBJ_dsa_with_SHA3_384 OBJ_sigAlgs,7L + +#define SN_dsa_with_SHA3_512 "id-dsa-with-sha3-512" +#define LN_dsa_with_SHA3_512 "dsa_with_SHA3-512" +#define NID_dsa_with_SHA3_512 1111 +#define OBJ_dsa_with_SHA3_512 OBJ_sigAlgs,8L + +#define SN_ecdsa_with_SHA3_224 "id-ecdsa-with-sha3-224" +#define LN_ecdsa_with_SHA3_224 "ecdsa_with_SHA3-224" +#define NID_ecdsa_with_SHA3_224 1112 +#define OBJ_ecdsa_with_SHA3_224 OBJ_sigAlgs,9L + +#define SN_ecdsa_with_SHA3_256 "id-ecdsa-with-sha3-256" +#define LN_ecdsa_with_SHA3_256 "ecdsa_with_SHA3-256" +#define NID_ecdsa_with_SHA3_256 1113 +#define OBJ_ecdsa_with_SHA3_256 OBJ_sigAlgs,10L + +#define SN_ecdsa_with_SHA3_384 "id-ecdsa-with-sha3-384" +#define LN_ecdsa_with_SHA3_384 "ecdsa_with_SHA3-384" +#define NID_ecdsa_with_SHA3_384 1114 +#define OBJ_ecdsa_with_SHA3_384 OBJ_sigAlgs,11L + +#define SN_ecdsa_with_SHA3_512 "id-ecdsa-with-sha3-512" +#define LN_ecdsa_with_SHA3_512 "ecdsa_with_SHA3-512" +#define NID_ecdsa_with_SHA3_512 1115 +#define OBJ_ecdsa_with_SHA3_512 OBJ_sigAlgs,12L + +#define SN_RSA_SHA3_224 "id-rsassa-pkcs1-v1_5-with-sha3-224" +#define LN_RSA_SHA3_224 "RSA-SHA3-224" +#define NID_RSA_SHA3_224 1116 +#define OBJ_RSA_SHA3_224 OBJ_sigAlgs,13L + +#define SN_RSA_SHA3_256 "id-rsassa-pkcs1-v1_5-with-sha3-256" +#define LN_RSA_SHA3_256 "RSA-SHA3-256" +#define NID_RSA_SHA3_256 1117 +#define OBJ_RSA_SHA3_256 OBJ_sigAlgs,14L + +#define SN_RSA_SHA3_384 "id-rsassa-pkcs1-v1_5-with-sha3-384" +#define LN_RSA_SHA3_384 "RSA-SHA3-384" +#define NID_RSA_SHA3_384 1118 +#define OBJ_RSA_SHA3_384 OBJ_sigAlgs,15L + +#define SN_RSA_SHA3_512 "id-rsassa-pkcs1-v1_5-with-sha3-512" +#define LN_RSA_SHA3_512 "RSA-SHA3-512" +#define NID_RSA_SHA3_512 1119 +#define OBJ_RSA_SHA3_512 OBJ_sigAlgs,16L + +#define SN_hold_instruction_code "holdInstructionCode" +#define LN_hold_instruction_code "Hold Instruction Code" +#define NID_hold_instruction_code 430 +#define OBJ_hold_instruction_code OBJ_id_ce,23L + +#define OBJ_holdInstruction OBJ_X9_57,2L + +#define SN_hold_instruction_none "holdInstructionNone" +#define LN_hold_instruction_none "Hold Instruction None" +#define NID_hold_instruction_none 431 +#define OBJ_hold_instruction_none OBJ_holdInstruction,1L + +#define SN_hold_instruction_call_issuer "holdInstructionCallIssuer" +#define LN_hold_instruction_call_issuer "Hold Instruction Call Issuer" +#define NID_hold_instruction_call_issuer 432 +#define OBJ_hold_instruction_call_issuer OBJ_holdInstruction,2L + +#define SN_hold_instruction_reject "holdInstructionReject" +#define LN_hold_instruction_reject "Hold Instruction Reject" +#define NID_hold_instruction_reject 433 +#define OBJ_hold_instruction_reject OBJ_holdInstruction,3L + +#define SN_data "data" +#define NID_data 434 +#define OBJ_data OBJ_itu_t,9L + +#define SN_pss "pss" +#define NID_pss 435 +#define OBJ_pss OBJ_data,2342L + +#define SN_ucl "ucl" +#define NID_ucl 436 +#define OBJ_ucl OBJ_pss,19200300L + +#define SN_pilot "pilot" +#define NID_pilot 437 +#define OBJ_pilot OBJ_ucl,100L + +#define LN_pilotAttributeType "pilotAttributeType" +#define NID_pilotAttributeType 438 +#define OBJ_pilotAttributeType OBJ_pilot,1L + +#define LN_pilotAttributeSyntax "pilotAttributeSyntax" +#define NID_pilotAttributeSyntax 439 +#define OBJ_pilotAttributeSyntax OBJ_pilot,3L + +#define LN_pilotObjectClass "pilotObjectClass" +#define NID_pilotObjectClass 440 +#define OBJ_pilotObjectClass OBJ_pilot,4L + +#define LN_pilotGroups "pilotGroups" +#define NID_pilotGroups 441 +#define OBJ_pilotGroups OBJ_pilot,10L + +#define LN_iA5StringSyntax "iA5StringSyntax" +#define NID_iA5StringSyntax 442 +#define OBJ_iA5StringSyntax OBJ_pilotAttributeSyntax,4L + +#define LN_caseIgnoreIA5StringSyntax "caseIgnoreIA5StringSyntax" +#define NID_caseIgnoreIA5StringSyntax 443 +#define OBJ_caseIgnoreIA5StringSyntax OBJ_pilotAttributeSyntax,5L + +#define LN_pilotObject "pilotObject" +#define NID_pilotObject 444 +#define OBJ_pilotObject OBJ_pilotObjectClass,3L + +#define LN_pilotPerson "pilotPerson" +#define NID_pilotPerson 445 +#define OBJ_pilotPerson OBJ_pilotObjectClass,4L + +#define SN_account "account" +#define NID_account 446 +#define OBJ_account OBJ_pilotObjectClass,5L + +#define SN_document "document" +#define NID_document 447 +#define OBJ_document OBJ_pilotObjectClass,6L + +#define SN_room "room" +#define NID_room 448 +#define OBJ_room OBJ_pilotObjectClass,7L + +#define LN_documentSeries "documentSeries" +#define NID_documentSeries 449 +#define OBJ_documentSeries OBJ_pilotObjectClass,9L + +#define SN_Domain "domain" +#define LN_Domain "Domain" +#define NID_Domain 392 +#define OBJ_Domain OBJ_pilotObjectClass,13L + +#define LN_rFC822localPart "rFC822localPart" +#define NID_rFC822localPart 450 +#define OBJ_rFC822localPart OBJ_pilotObjectClass,14L + +#define LN_dNSDomain "dNSDomain" +#define NID_dNSDomain 451 +#define OBJ_dNSDomain OBJ_pilotObjectClass,15L + +#define LN_domainRelatedObject "domainRelatedObject" +#define NID_domainRelatedObject 452 +#define OBJ_domainRelatedObject OBJ_pilotObjectClass,17L + +#define LN_friendlyCountry "friendlyCountry" +#define NID_friendlyCountry 453 +#define OBJ_friendlyCountry OBJ_pilotObjectClass,18L + +#define LN_simpleSecurityObject "simpleSecurityObject" +#define NID_simpleSecurityObject 454 +#define OBJ_simpleSecurityObject OBJ_pilotObjectClass,19L + +#define LN_pilotOrganization "pilotOrganization" +#define NID_pilotOrganization 455 +#define OBJ_pilotOrganization OBJ_pilotObjectClass,20L + +#define LN_pilotDSA "pilotDSA" +#define NID_pilotDSA 456 +#define OBJ_pilotDSA OBJ_pilotObjectClass,21L + +#define LN_qualityLabelledData "qualityLabelledData" +#define NID_qualityLabelledData 457 +#define OBJ_qualityLabelledData OBJ_pilotObjectClass,22L + +#define SN_userId "UID" +#define LN_userId "userId" +#define NID_userId 458 +#define OBJ_userId OBJ_pilotAttributeType,1L + +#define LN_textEncodedORAddress "textEncodedORAddress" +#define NID_textEncodedORAddress 459 +#define OBJ_textEncodedORAddress OBJ_pilotAttributeType,2L + +#define SN_rfc822Mailbox "mail" +#define LN_rfc822Mailbox "rfc822Mailbox" +#define NID_rfc822Mailbox 460 +#define OBJ_rfc822Mailbox OBJ_pilotAttributeType,3L + +#define SN_info "info" +#define NID_info 461 +#define OBJ_info OBJ_pilotAttributeType,4L + +#define LN_favouriteDrink "favouriteDrink" +#define NID_favouriteDrink 462 +#define OBJ_favouriteDrink OBJ_pilotAttributeType,5L + +#define LN_roomNumber "roomNumber" +#define NID_roomNumber 463 +#define OBJ_roomNumber OBJ_pilotAttributeType,6L + +#define SN_photo "photo" +#define NID_photo 464 +#define OBJ_photo OBJ_pilotAttributeType,7L + +#define LN_userClass "userClass" +#define NID_userClass 465 +#define OBJ_userClass OBJ_pilotAttributeType,8L + +#define SN_host "host" +#define NID_host 466 +#define OBJ_host OBJ_pilotAttributeType,9L + +#define SN_manager "manager" +#define NID_manager 467 +#define OBJ_manager OBJ_pilotAttributeType,10L + +#define LN_documentIdentifier "documentIdentifier" +#define NID_documentIdentifier 468 +#define OBJ_documentIdentifier OBJ_pilotAttributeType,11L + +#define LN_documentTitle "documentTitle" +#define NID_documentTitle 469 +#define OBJ_documentTitle OBJ_pilotAttributeType,12L + +#define LN_documentVersion "documentVersion" +#define NID_documentVersion 470 +#define OBJ_documentVersion OBJ_pilotAttributeType,13L + +#define LN_documentAuthor "documentAuthor" +#define NID_documentAuthor 471 +#define OBJ_documentAuthor OBJ_pilotAttributeType,14L + +#define LN_documentLocation "documentLocation" +#define NID_documentLocation 472 +#define OBJ_documentLocation OBJ_pilotAttributeType,15L + +#define LN_homeTelephoneNumber "homeTelephoneNumber" +#define NID_homeTelephoneNumber 473 +#define OBJ_homeTelephoneNumber OBJ_pilotAttributeType,20L + +#define SN_secretary "secretary" +#define NID_secretary 474 +#define OBJ_secretary OBJ_pilotAttributeType,21L + +#define LN_otherMailbox "otherMailbox" +#define NID_otherMailbox 475 +#define OBJ_otherMailbox OBJ_pilotAttributeType,22L + +#define LN_lastModifiedTime "lastModifiedTime" +#define NID_lastModifiedTime 476 +#define OBJ_lastModifiedTime OBJ_pilotAttributeType,23L + +#define LN_lastModifiedBy "lastModifiedBy" +#define NID_lastModifiedBy 477 +#define OBJ_lastModifiedBy OBJ_pilotAttributeType,24L + +#define SN_domainComponent "DC" +#define LN_domainComponent "domainComponent" +#define NID_domainComponent 391 +#define OBJ_domainComponent OBJ_pilotAttributeType,25L + +#define LN_aRecord "aRecord" +#define NID_aRecord 478 +#define OBJ_aRecord OBJ_pilotAttributeType,26L + +#define LN_pilotAttributeType27 "pilotAttributeType27" +#define NID_pilotAttributeType27 479 +#define OBJ_pilotAttributeType27 OBJ_pilotAttributeType,27L + +#define LN_mXRecord "mXRecord" +#define NID_mXRecord 480 +#define OBJ_mXRecord OBJ_pilotAttributeType,28L + +#define LN_nSRecord "nSRecord" +#define NID_nSRecord 481 +#define OBJ_nSRecord OBJ_pilotAttributeType,29L + +#define LN_sOARecord "sOARecord" +#define NID_sOARecord 482 +#define OBJ_sOARecord OBJ_pilotAttributeType,30L + +#define LN_cNAMERecord "cNAMERecord" +#define NID_cNAMERecord 483 +#define OBJ_cNAMERecord OBJ_pilotAttributeType,31L + +#define LN_associatedDomain "associatedDomain" +#define NID_associatedDomain 484 +#define OBJ_associatedDomain OBJ_pilotAttributeType,37L + +#define LN_associatedName "associatedName" +#define NID_associatedName 485 +#define OBJ_associatedName OBJ_pilotAttributeType,38L + +#define LN_homePostalAddress "homePostalAddress" +#define NID_homePostalAddress 486 +#define OBJ_homePostalAddress OBJ_pilotAttributeType,39L + +#define LN_personalTitle "personalTitle" +#define NID_personalTitle 487 +#define OBJ_personalTitle OBJ_pilotAttributeType,40L + +#define LN_mobileTelephoneNumber "mobileTelephoneNumber" +#define NID_mobileTelephoneNumber 488 +#define OBJ_mobileTelephoneNumber OBJ_pilotAttributeType,41L + +#define LN_pagerTelephoneNumber "pagerTelephoneNumber" +#define NID_pagerTelephoneNumber 489 +#define OBJ_pagerTelephoneNumber OBJ_pilotAttributeType,42L + +#define LN_friendlyCountryName "friendlyCountryName" +#define NID_friendlyCountryName 490 +#define OBJ_friendlyCountryName OBJ_pilotAttributeType,43L + +#define SN_uniqueIdentifier "uid" +#define LN_uniqueIdentifier "uniqueIdentifier" +#define NID_uniqueIdentifier 102 +#define OBJ_uniqueIdentifier OBJ_pilotAttributeType,44L + +#define LN_organizationalStatus "organizationalStatus" +#define NID_organizationalStatus 491 +#define OBJ_organizationalStatus OBJ_pilotAttributeType,45L + +#define LN_janetMailbox "janetMailbox" +#define NID_janetMailbox 492 +#define OBJ_janetMailbox OBJ_pilotAttributeType,46L + +#define LN_mailPreferenceOption "mailPreferenceOption" +#define NID_mailPreferenceOption 493 +#define OBJ_mailPreferenceOption OBJ_pilotAttributeType,47L + +#define LN_buildingName "buildingName" +#define NID_buildingName 494 +#define OBJ_buildingName OBJ_pilotAttributeType,48L + +#define LN_dSAQuality "dSAQuality" +#define NID_dSAQuality 495 +#define OBJ_dSAQuality OBJ_pilotAttributeType,49L + +#define LN_singleLevelQuality "singleLevelQuality" +#define NID_singleLevelQuality 496 +#define OBJ_singleLevelQuality OBJ_pilotAttributeType,50L + +#define LN_subtreeMinimumQuality "subtreeMinimumQuality" +#define NID_subtreeMinimumQuality 497 +#define OBJ_subtreeMinimumQuality OBJ_pilotAttributeType,51L + +#define LN_subtreeMaximumQuality "subtreeMaximumQuality" +#define NID_subtreeMaximumQuality 498 +#define OBJ_subtreeMaximumQuality OBJ_pilotAttributeType,52L + +#define LN_personalSignature "personalSignature" +#define NID_personalSignature 499 +#define OBJ_personalSignature OBJ_pilotAttributeType,53L + +#define LN_dITRedirect "dITRedirect" +#define NID_dITRedirect 500 +#define OBJ_dITRedirect OBJ_pilotAttributeType,54L + +#define SN_audio "audio" +#define NID_audio 501 +#define OBJ_audio OBJ_pilotAttributeType,55L + +#define LN_documentPublisher "documentPublisher" +#define NID_documentPublisher 502 +#define OBJ_documentPublisher OBJ_pilotAttributeType,56L + +#define SN_id_set "id-set" +#define LN_id_set "Secure Electronic Transactions" +#define NID_id_set 512 +#define OBJ_id_set OBJ_international_organizations,42L + +#define SN_set_ctype "set-ctype" +#define LN_set_ctype "content types" +#define NID_set_ctype 513 +#define OBJ_set_ctype OBJ_id_set,0L + +#define SN_set_msgExt "set-msgExt" +#define LN_set_msgExt "message extensions" +#define NID_set_msgExt 514 +#define OBJ_set_msgExt OBJ_id_set,1L + +#define SN_set_attr "set-attr" +#define NID_set_attr 515 +#define OBJ_set_attr OBJ_id_set,3L + +#define SN_set_policy "set-policy" +#define NID_set_policy 516 +#define OBJ_set_policy OBJ_id_set,5L + +#define SN_set_certExt "set-certExt" +#define LN_set_certExt "certificate extensions" +#define NID_set_certExt 517 +#define OBJ_set_certExt OBJ_id_set,7L + +#define SN_set_brand "set-brand" +#define NID_set_brand 518 +#define OBJ_set_brand OBJ_id_set,8L + +#define SN_setct_PANData "setct-PANData" +#define NID_setct_PANData 519 +#define OBJ_setct_PANData OBJ_set_ctype,0L + +#define SN_setct_PANToken "setct-PANToken" +#define NID_setct_PANToken 520 +#define OBJ_setct_PANToken OBJ_set_ctype,1L + +#define SN_setct_PANOnly "setct-PANOnly" +#define NID_setct_PANOnly 521 +#define OBJ_setct_PANOnly OBJ_set_ctype,2L + +#define SN_setct_OIData "setct-OIData" +#define NID_setct_OIData 522 +#define OBJ_setct_OIData OBJ_set_ctype,3L + +#define SN_setct_PI "setct-PI" +#define NID_setct_PI 523 +#define OBJ_setct_PI OBJ_set_ctype,4L + +#define SN_setct_PIData "setct-PIData" +#define NID_setct_PIData 524 +#define OBJ_setct_PIData OBJ_set_ctype,5L + +#define SN_setct_PIDataUnsigned "setct-PIDataUnsigned" +#define NID_setct_PIDataUnsigned 525 +#define OBJ_setct_PIDataUnsigned OBJ_set_ctype,6L + +#define SN_setct_HODInput "setct-HODInput" +#define NID_setct_HODInput 526 +#define OBJ_setct_HODInput OBJ_set_ctype,7L + +#define SN_setct_AuthResBaggage "setct-AuthResBaggage" +#define NID_setct_AuthResBaggage 527 +#define OBJ_setct_AuthResBaggage OBJ_set_ctype,8L + +#define SN_setct_AuthRevReqBaggage "setct-AuthRevReqBaggage" +#define NID_setct_AuthRevReqBaggage 528 +#define OBJ_setct_AuthRevReqBaggage OBJ_set_ctype,9L + +#define SN_setct_AuthRevResBaggage "setct-AuthRevResBaggage" +#define NID_setct_AuthRevResBaggage 529 +#define OBJ_setct_AuthRevResBaggage OBJ_set_ctype,10L + +#define SN_setct_CapTokenSeq "setct-CapTokenSeq" +#define NID_setct_CapTokenSeq 530 +#define OBJ_setct_CapTokenSeq OBJ_set_ctype,11L + +#define SN_setct_PInitResData "setct-PInitResData" +#define NID_setct_PInitResData 531 +#define OBJ_setct_PInitResData OBJ_set_ctype,12L + +#define SN_setct_PI_TBS "setct-PI-TBS" +#define NID_setct_PI_TBS 532 +#define OBJ_setct_PI_TBS OBJ_set_ctype,13L + +#define SN_setct_PResData "setct-PResData" +#define NID_setct_PResData 533 +#define OBJ_setct_PResData OBJ_set_ctype,14L + +#define SN_setct_AuthReqTBS "setct-AuthReqTBS" +#define NID_setct_AuthReqTBS 534 +#define OBJ_setct_AuthReqTBS OBJ_set_ctype,16L + +#define SN_setct_AuthResTBS "setct-AuthResTBS" +#define NID_setct_AuthResTBS 535 +#define OBJ_setct_AuthResTBS OBJ_set_ctype,17L + +#define SN_setct_AuthResTBSX "setct-AuthResTBSX" +#define NID_setct_AuthResTBSX 536 +#define OBJ_setct_AuthResTBSX OBJ_set_ctype,18L + +#define SN_setct_AuthTokenTBS "setct-AuthTokenTBS" +#define NID_setct_AuthTokenTBS 537 +#define OBJ_setct_AuthTokenTBS OBJ_set_ctype,19L + +#define SN_setct_CapTokenData "setct-CapTokenData" +#define NID_setct_CapTokenData 538 +#define OBJ_setct_CapTokenData OBJ_set_ctype,20L + +#define SN_setct_CapTokenTBS "setct-CapTokenTBS" +#define NID_setct_CapTokenTBS 539 +#define OBJ_setct_CapTokenTBS OBJ_set_ctype,21L + +#define SN_setct_AcqCardCodeMsg "setct-AcqCardCodeMsg" +#define NID_setct_AcqCardCodeMsg 540 +#define OBJ_setct_AcqCardCodeMsg OBJ_set_ctype,22L + +#define SN_setct_AuthRevReqTBS "setct-AuthRevReqTBS" +#define NID_setct_AuthRevReqTBS 541 +#define OBJ_setct_AuthRevReqTBS OBJ_set_ctype,23L + +#define SN_setct_AuthRevResData "setct-AuthRevResData" +#define NID_setct_AuthRevResData 542 +#define OBJ_setct_AuthRevResData OBJ_set_ctype,24L + +#define SN_setct_AuthRevResTBS "setct-AuthRevResTBS" +#define NID_setct_AuthRevResTBS 543 +#define OBJ_setct_AuthRevResTBS OBJ_set_ctype,25L + +#define SN_setct_CapReqTBS "setct-CapReqTBS" +#define NID_setct_CapReqTBS 544 +#define OBJ_setct_CapReqTBS OBJ_set_ctype,26L + +#define SN_setct_CapReqTBSX "setct-CapReqTBSX" +#define NID_setct_CapReqTBSX 545 +#define OBJ_setct_CapReqTBSX OBJ_set_ctype,27L + +#define SN_setct_CapResData "setct-CapResData" +#define NID_setct_CapResData 546 +#define OBJ_setct_CapResData OBJ_set_ctype,28L + +#define SN_setct_CapRevReqTBS "setct-CapRevReqTBS" +#define NID_setct_CapRevReqTBS 547 +#define OBJ_setct_CapRevReqTBS OBJ_set_ctype,29L + +#define SN_setct_CapRevReqTBSX "setct-CapRevReqTBSX" +#define NID_setct_CapRevReqTBSX 548 +#define OBJ_setct_CapRevReqTBSX OBJ_set_ctype,30L + +#define SN_setct_CapRevResData "setct-CapRevResData" +#define NID_setct_CapRevResData 549 +#define OBJ_setct_CapRevResData OBJ_set_ctype,31L + +#define SN_setct_CredReqTBS "setct-CredReqTBS" +#define NID_setct_CredReqTBS 550 +#define OBJ_setct_CredReqTBS OBJ_set_ctype,32L + +#define SN_setct_CredReqTBSX "setct-CredReqTBSX" +#define NID_setct_CredReqTBSX 551 +#define OBJ_setct_CredReqTBSX OBJ_set_ctype,33L + +#define SN_setct_CredResData "setct-CredResData" +#define NID_setct_CredResData 552 +#define OBJ_setct_CredResData OBJ_set_ctype,34L + +#define SN_setct_CredRevReqTBS "setct-CredRevReqTBS" +#define NID_setct_CredRevReqTBS 553 +#define OBJ_setct_CredRevReqTBS OBJ_set_ctype,35L + +#define SN_setct_CredRevReqTBSX "setct-CredRevReqTBSX" +#define NID_setct_CredRevReqTBSX 554 +#define OBJ_setct_CredRevReqTBSX OBJ_set_ctype,36L + +#define SN_setct_CredRevResData "setct-CredRevResData" +#define NID_setct_CredRevResData 555 +#define OBJ_setct_CredRevResData OBJ_set_ctype,37L + +#define SN_setct_PCertReqData "setct-PCertReqData" +#define NID_setct_PCertReqData 556 +#define OBJ_setct_PCertReqData OBJ_set_ctype,38L + +#define SN_setct_PCertResTBS "setct-PCertResTBS" +#define NID_setct_PCertResTBS 557 +#define OBJ_setct_PCertResTBS OBJ_set_ctype,39L + +#define SN_setct_BatchAdminReqData "setct-BatchAdminReqData" +#define NID_setct_BatchAdminReqData 558 +#define OBJ_setct_BatchAdminReqData OBJ_set_ctype,40L + +#define SN_setct_BatchAdminResData "setct-BatchAdminResData" +#define NID_setct_BatchAdminResData 559 +#define OBJ_setct_BatchAdminResData OBJ_set_ctype,41L + +#define SN_setct_CardCInitResTBS "setct-CardCInitResTBS" +#define NID_setct_CardCInitResTBS 560 +#define OBJ_setct_CardCInitResTBS OBJ_set_ctype,42L + +#define SN_setct_MeAqCInitResTBS "setct-MeAqCInitResTBS" +#define NID_setct_MeAqCInitResTBS 561 +#define OBJ_setct_MeAqCInitResTBS OBJ_set_ctype,43L + +#define SN_setct_RegFormResTBS "setct-RegFormResTBS" +#define NID_setct_RegFormResTBS 562 +#define OBJ_setct_RegFormResTBS OBJ_set_ctype,44L + +#define SN_setct_CertReqData "setct-CertReqData" +#define NID_setct_CertReqData 563 +#define OBJ_setct_CertReqData OBJ_set_ctype,45L + +#define SN_setct_CertReqTBS "setct-CertReqTBS" +#define NID_setct_CertReqTBS 564 +#define OBJ_setct_CertReqTBS OBJ_set_ctype,46L + +#define SN_setct_CertResData "setct-CertResData" +#define NID_setct_CertResData 565 +#define OBJ_setct_CertResData OBJ_set_ctype,47L + +#define SN_setct_CertInqReqTBS "setct-CertInqReqTBS" +#define NID_setct_CertInqReqTBS 566 +#define OBJ_setct_CertInqReqTBS OBJ_set_ctype,48L + +#define SN_setct_ErrorTBS "setct-ErrorTBS" +#define NID_setct_ErrorTBS 567 +#define OBJ_setct_ErrorTBS OBJ_set_ctype,49L + +#define SN_setct_PIDualSignedTBE "setct-PIDualSignedTBE" +#define NID_setct_PIDualSignedTBE 568 +#define OBJ_setct_PIDualSignedTBE OBJ_set_ctype,50L + +#define SN_setct_PIUnsignedTBE "setct-PIUnsignedTBE" +#define NID_setct_PIUnsignedTBE 569 +#define OBJ_setct_PIUnsignedTBE OBJ_set_ctype,51L + +#define SN_setct_AuthReqTBE "setct-AuthReqTBE" +#define NID_setct_AuthReqTBE 570 +#define OBJ_setct_AuthReqTBE OBJ_set_ctype,52L + +#define SN_setct_AuthResTBE "setct-AuthResTBE" +#define NID_setct_AuthResTBE 571 +#define OBJ_setct_AuthResTBE OBJ_set_ctype,53L + +#define SN_setct_AuthResTBEX "setct-AuthResTBEX" +#define NID_setct_AuthResTBEX 572 +#define OBJ_setct_AuthResTBEX OBJ_set_ctype,54L + +#define SN_setct_AuthTokenTBE "setct-AuthTokenTBE" +#define NID_setct_AuthTokenTBE 573 +#define OBJ_setct_AuthTokenTBE OBJ_set_ctype,55L + +#define SN_setct_CapTokenTBE "setct-CapTokenTBE" +#define NID_setct_CapTokenTBE 574 +#define OBJ_setct_CapTokenTBE OBJ_set_ctype,56L + +#define SN_setct_CapTokenTBEX "setct-CapTokenTBEX" +#define NID_setct_CapTokenTBEX 575 +#define OBJ_setct_CapTokenTBEX OBJ_set_ctype,57L + +#define SN_setct_AcqCardCodeMsgTBE "setct-AcqCardCodeMsgTBE" +#define NID_setct_AcqCardCodeMsgTBE 576 +#define OBJ_setct_AcqCardCodeMsgTBE OBJ_set_ctype,58L + +#define SN_setct_AuthRevReqTBE "setct-AuthRevReqTBE" +#define NID_setct_AuthRevReqTBE 577 +#define OBJ_setct_AuthRevReqTBE OBJ_set_ctype,59L + +#define SN_setct_AuthRevResTBE "setct-AuthRevResTBE" +#define NID_setct_AuthRevResTBE 578 +#define OBJ_setct_AuthRevResTBE OBJ_set_ctype,60L + +#define SN_setct_AuthRevResTBEB "setct-AuthRevResTBEB" +#define NID_setct_AuthRevResTBEB 579 +#define OBJ_setct_AuthRevResTBEB OBJ_set_ctype,61L + +#define SN_setct_CapReqTBE "setct-CapReqTBE" +#define NID_setct_CapReqTBE 580 +#define OBJ_setct_CapReqTBE OBJ_set_ctype,62L + +#define SN_setct_CapReqTBEX "setct-CapReqTBEX" +#define NID_setct_CapReqTBEX 581 +#define OBJ_setct_CapReqTBEX OBJ_set_ctype,63L + +#define SN_setct_CapResTBE "setct-CapResTBE" +#define NID_setct_CapResTBE 582 +#define OBJ_setct_CapResTBE OBJ_set_ctype,64L + +#define SN_setct_CapRevReqTBE "setct-CapRevReqTBE" +#define NID_setct_CapRevReqTBE 583 +#define OBJ_setct_CapRevReqTBE OBJ_set_ctype,65L + +#define SN_setct_CapRevReqTBEX "setct-CapRevReqTBEX" +#define NID_setct_CapRevReqTBEX 584 +#define OBJ_setct_CapRevReqTBEX OBJ_set_ctype,66L + +#define SN_setct_CapRevResTBE "setct-CapRevResTBE" +#define NID_setct_CapRevResTBE 585 +#define OBJ_setct_CapRevResTBE OBJ_set_ctype,67L + +#define SN_setct_CredReqTBE "setct-CredReqTBE" +#define NID_setct_CredReqTBE 586 +#define OBJ_setct_CredReqTBE OBJ_set_ctype,68L + +#define SN_setct_CredReqTBEX "setct-CredReqTBEX" +#define NID_setct_CredReqTBEX 587 +#define OBJ_setct_CredReqTBEX OBJ_set_ctype,69L + +#define SN_setct_CredResTBE "setct-CredResTBE" +#define NID_setct_CredResTBE 588 +#define OBJ_setct_CredResTBE OBJ_set_ctype,70L + +#define SN_setct_CredRevReqTBE "setct-CredRevReqTBE" +#define NID_setct_CredRevReqTBE 589 +#define OBJ_setct_CredRevReqTBE OBJ_set_ctype,71L + +#define SN_setct_CredRevReqTBEX "setct-CredRevReqTBEX" +#define NID_setct_CredRevReqTBEX 590 +#define OBJ_setct_CredRevReqTBEX OBJ_set_ctype,72L + +#define SN_setct_CredRevResTBE "setct-CredRevResTBE" +#define NID_setct_CredRevResTBE 591 +#define OBJ_setct_CredRevResTBE OBJ_set_ctype,73L + +#define SN_setct_BatchAdminReqTBE "setct-BatchAdminReqTBE" +#define NID_setct_BatchAdminReqTBE 592 +#define OBJ_setct_BatchAdminReqTBE OBJ_set_ctype,74L + +#define SN_setct_BatchAdminResTBE "setct-BatchAdminResTBE" +#define NID_setct_BatchAdminResTBE 593 +#define OBJ_setct_BatchAdminResTBE OBJ_set_ctype,75L + +#define SN_setct_RegFormReqTBE "setct-RegFormReqTBE" +#define NID_setct_RegFormReqTBE 594 +#define OBJ_setct_RegFormReqTBE OBJ_set_ctype,76L + +#define SN_setct_CertReqTBE "setct-CertReqTBE" +#define NID_setct_CertReqTBE 595 +#define OBJ_setct_CertReqTBE OBJ_set_ctype,77L + +#define SN_setct_CertReqTBEX "setct-CertReqTBEX" +#define NID_setct_CertReqTBEX 596 +#define OBJ_setct_CertReqTBEX OBJ_set_ctype,78L + +#define SN_setct_CertResTBE "setct-CertResTBE" +#define NID_setct_CertResTBE 597 +#define OBJ_setct_CertResTBE OBJ_set_ctype,79L + +#define SN_setct_CRLNotificationTBS "setct-CRLNotificationTBS" +#define NID_setct_CRLNotificationTBS 598 +#define OBJ_setct_CRLNotificationTBS OBJ_set_ctype,80L + +#define SN_setct_CRLNotificationResTBS "setct-CRLNotificationResTBS" +#define NID_setct_CRLNotificationResTBS 599 +#define OBJ_setct_CRLNotificationResTBS OBJ_set_ctype,81L + +#define SN_setct_BCIDistributionTBS "setct-BCIDistributionTBS" +#define NID_setct_BCIDistributionTBS 600 +#define OBJ_setct_BCIDistributionTBS OBJ_set_ctype,82L + +#define SN_setext_genCrypt "setext-genCrypt" +#define LN_setext_genCrypt "generic cryptogram" +#define NID_setext_genCrypt 601 +#define OBJ_setext_genCrypt OBJ_set_msgExt,1L + +#define SN_setext_miAuth "setext-miAuth" +#define LN_setext_miAuth "merchant initiated auth" +#define NID_setext_miAuth 602 +#define OBJ_setext_miAuth OBJ_set_msgExt,3L + +#define SN_setext_pinSecure "setext-pinSecure" +#define NID_setext_pinSecure 603 +#define OBJ_setext_pinSecure OBJ_set_msgExt,4L + +#define SN_setext_pinAny "setext-pinAny" +#define NID_setext_pinAny 604 +#define OBJ_setext_pinAny OBJ_set_msgExt,5L + +#define SN_setext_track2 "setext-track2" +#define NID_setext_track2 605 +#define OBJ_setext_track2 OBJ_set_msgExt,7L + +#define SN_setext_cv "setext-cv" +#define LN_setext_cv "additional verification" +#define NID_setext_cv 606 +#define OBJ_setext_cv OBJ_set_msgExt,8L + +#define SN_set_policy_root "set-policy-root" +#define NID_set_policy_root 607 +#define OBJ_set_policy_root OBJ_set_policy,0L + +#define SN_setCext_hashedRoot "setCext-hashedRoot" +#define NID_setCext_hashedRoot 608 +#define OBJ_setCext_hashedRoot OBJ_set_certExt,0L + +#define SN_setCext_certType "setCext-certType" +#define NID_setCext_certType 609 +#define OBJ_setCext_certType OBJ_set_certExt,1L + +#define SN_setCext_merchData "setCext-merchData" +#define NID_setCext_merchData 610 +#define OBJ_setCext_merchData OBJ_set_certExt,2L + +#define SN_setCext_cCertRequired "setCext-cCertRequired" +#define NID_setCext_cCertRequired 611 +#define OBJ_setCext_cCertRequired OBJ_set_certExt,3L + +#define SN_setCext_tunneling "setCext-tunneling" +#define NID_setCext_tunneling 612 +#define OBJ_setCext_tunneling OBJ_set_certExt,4L + +#define SN_setCext_setExt "setCext-setExt" +#define NID_setCext_setExt 613 +#define OBJ_setCext_setExt OBJ_set_certExt,5L + +#define SN_setCext_setQualf "setCext-setQualf" +#define NID_setCext_setQualf 614 +#define OBJ_setCext_setQualf OBJ_set_certExt,6L + +#define SN_setCext_PGWYcapabilities "setCext-PGWYcapabilities" +#define NID_setCext_PGWYcapabilities 615 +#define OBJ_setCext_PGWYcapabilities OBJ_set_certExt,7L + +#define SN_setCext_TokenIdentifier "setCext-TokenIdentifier" +#define NID_setCext_TokenIdentifier 616 +#define OBJ_setCext_TokenIdentifier OBJ_set_certExt,8L + +#define SN_setCext_Track2Data "setCext-Track2Data" +#define NID_setCext_Track2Data 617 +#define OBJ_setCext_Track2Data OBJ_set_certExt,9L + +#define SN_setCext_TokenType "setCext-TokenType" +#define NID_setCext_TokenType 618 +#define OBJ_setCext_TokenType OBJ_set_certExt,10L + +#define SN_setCext_IssuerCapabilities "setCext-IssuerCapabilities" +#define NID_setCext_IssuerCapabilities 619 +#define OBJ_setCext_IssuerCapabilities OBJ_set_certExt,11L + +#define SN_setAttr_Cert "setAttr-Cert" +#define NID_setAttr_Cert 620 +#define OBJ_setAttr_Cert OBJ_set_attr,0L + +#define SN_setAttr_PGWYcap "setAttr-PGWYcap" +#define LN_setAttr_PGWYcap "payment gateway capabilities" +#define NID_setAttr_PGWYcap 621 +#define OBJ_setAttr_PGWYcap OBJ_set_attr,1L + +#define SN_setAttr_TokenType "setAttr-TokenType" +#define NID_setAttr_TokenType 622 +#define OBJ_setAttr_TokenType OBJ_set_attr,2L + +#define SN_setAttr_IssCap "setAttr-IssCap" +#define LN_setAttr_IssCap "issuer capabilities" +#define NID_setAttr_IssCap 623 +#define OBJ_setAttr_IssCap OBJ_set_attr,3L + +#define SN_set_rootKeyThumb "set-rootKeyThumb" +#define NID_set_rootKeyThumb 624 +#define OBJ_set_rootKeyThumb OBJ_setAttr_Cert,0L + +#define SN_set_addPolicy "set-addPolicy" +#define NID_set_addPolicy 625 +#define OBJ_set_addPolicy OBJ_setAttr_Cert,1L + +#define SN_setAttr_Token_EMV "setAttr-Token-EMV" +#define NID_setAttr_Token_EMV 626 +#define OBJ_setAttr_Token_EMV OBJ_setAttr_TokenType,1L + +#define SN_setAttr_Token_B0Prime "setAttr-Token-B0Prime" +#define NID_setAttr_Token_B0Prime 627 +#define OBJ_setAttr_Token_B0Prime OBJ_setAttr_TokenType,2L + +#define SN_setAttr_IssCap_CVM "setAttr-IssCap-CVM" +#define NID_setAttr_IssCap_CVM 628 +#define OBJ_setAttr_IssCap_CVM OBJ_setAttr_IssCap,3L + +#define SN_setAttr_IssCap_T2 "setAttr-IssCap-T2" +#define NID_setAttr_IssCap_T2 629 +#define OBJ_setAttr_IssCap_T2 OBJ_setAttr_IssCap,4L + +#define SN_setAttr_IssCap_Sig "setAttr-IssCap-Sig" +#define NID_setAttr_IssCap_Sig 630 +#define OBJ_setAttr_IssCap_Sig OBJ_setAttr_IssCap,5L + +#define SN_setAttr_GenCryptgrm "setAttr-GenCryptgrm" +#define LN_setAttr_GenCryptgrm "generate cryptogram" +#define NID_setAttr_GenCryptgrm 631 +#define OBJ_setAttr_GenCryptgrm OBJ_setAttr_IssCap_CVM,1L + +#define SN_setAttr_T2Enc "setAttr-T2Enc" +#define LN_setAttr_T2Enc "encrypted track 2" +#define NID_setAttr_T2Enc 632 +#define OBJ_setAttr_T2Enc OBJ_setAttr_IssCap_T2,1L + +#define SN_setAttr_T2cleartxt "setAttr-T2cleartxt" +#define LN_setAttr_T2cleartxt "cleartext track 2" +#define NID_setAttr_T2cleartxt 633 +#define OBJ_setAttr_T2cleartxt OBJ_setAttr_IssCap_T2,2L + +#define SN_setAttr_TokICCsig "setAttr-TokICCsig" +#define LN_setAttr_TokICCsig "ICC or token signature" +#define NID_setAttr_TokICCsig 634 +#define OBJ_setAttr_TokICCsig OBJ_setAttr_IssCap_Sig,1L + +#define SN_setAttr_SecDevSig "setAttr-SecDevSig" +#define LN_setAttr_SecDevSig "secure device signature" +#define NID_setAttr_SecDevSig 635 +#define OBJ_setAttr_SecDevSig OBJ_setAttr_IssCap_Sig,2L + +#define SN_set_brand_IATA_ATA "set-brand-IATA-ATA" +#define NID_set_brand_IATA_ATA 636 +#define OBJ_set_brand_IATA_ATA OBJ_set_brand,1L + +#define SN_set_brand_Diners "set-brand-Diners" +#define NID_set_brand_Diners 637 +#define OBJ_set_brand_Diners OBJ_set_brand,30L + +#define SN_set_brand_AmericanExpress "set-brand-AmericanExpress" +#define NID_set_brand_AmericanExpress 638 +#define OBJ_set_brand_AmericanExpress OBJ_set_brand,34L + +#define SN_set_brand_JCB "set-brand-JCB" +#define NID_set_brand_JCB 639 +#define OBJ_set_brand_JCB OBJ_set_brand,35L + +#define SN_set_brand_Visa "set-brand-Visa" +#define NID_set_brand_Visa 640 +#define OBJ_set_brand_Visa OBJ_set_brand,4L + +#define SN_set_brand_MasterCard "set-brand-MasterCard" +#define NID_set_brand_MasterCard 641 +#define OBJ_set_brand_MasterCard OBJ_set_brand,5L + +#define SN_set_brand_Novus "set-brand-Novus" +#define NID_set_brand_Novus 642 +#define OBJ_set_brand_Novus OBJ_set_brand,6011L + +#define SN_des_cdmf "DES-CDMF" +#define LN_des_cdmf "des-cdmf" +#define NID_des_cdmf 643 +#define OBJ_des_cdmf OBJ_rsadsi,3L,10L + +#define SN_rsaOAEPEncryptionSET "rsaOAEPEncryptionSET" +#define NID_rsaOAEPEncryptionSET 644 +#define OBJ_rsaOAEPEncryptionSET OBJ_rsadsi,1L,1L,6L + +#define SN_ipsec3 "Oakley-EC2N-3" +#define LN_ipsec3 "ipsec3" +#define NID_ipsec3 749 + +#define SN_ipsec4 "Oakley-EC2N-4" +#define LN_ipsec4 "ipsec4" +#define NID_ipsec4 750 + +#define SN_whirlpool "whirlpool" +#define NID_whirlpool 804 +#define OBJ_whirlpool OBJ_iso,0L,10118L,3L,0L,55L + +#define SN_cryptopro "cryptopro" +#define NID_cryptopro 805 +#define OBJ_cryptopro OBJ_member_body,643L,2L,2L + +#define SN_cryptocom "cryptocom" +#define NID_cryptocom 806 +#define OBJ_cryptocom OBJ_member_body,643L,2L,9L + +#define SN_id_tc26 "id-tc26" +#define NID_id_tc26 974 +#define OBJ_id_tc26 OBJ_member_body,643L,7L,1L + +#define SN_id_GostR3411_94_with_GostR3410_2001 "id-GostR3411-94-with-GostR3410-2001" +#define LN_id_GostR3411_94_with_GostR3410_2001 "GOST R 34.11-94 with GOST R 34.10-2001" +#define NID_id_GostR3411_94_with_GostR3410_2001 807 +#define OBJ_id_GostR3411_94_with_GostR3410_2001 OBJ_cryptopro,3L + +#define SN_id_GostR3411_94_with_GostR3410_94 "id-GostR3411-94-with-GostR3410-94" +#define LN_id_GostR3411_94_with_GostR3410_94 "GOST R 34.11-94 with GOST R 34.10-94" +#define NID_id_GostR3411_94_with_GostR3410_94 808 +#define OBJ_id_GostR3411_94_with_GostR3410_94 OBJ_cryptopro,4L + +#define SN_id_GostR3411_94 "md_gost94" +#define LN_id_GostR3411_94 "GOST R 34.11-94" +#define NID_id_GostR3411_94 809 +#define OBJ_id_GostR3411_94 OBJ_cryptopro,9L + +#define SN_id_HMACGostR3411_94 "id-HMACGostR3411-94" +#define LN_id_HMACGostR3411_94 "HMAC GOST 34.11-94" +#define NID_id_HMACGostR3411_94 810 +#define OBJ_id_HMACGostR3411_94 OBJ_cryptopro,10L + +#define SN_id_GostR3410_2001 "gost2001" +#define LN_id_GostR3410_2001 "GOST R 34.10-2001" +#define NID_id_GostR3410_2001 811 +#define OBJ_id_GostR3410_2001 OBJ_cryptopro,19L + +#define SN_id_GostR3410_94 "gost94" +#define LN_id_GostR3410_94 "GOST R 34.10-94" +#define NID_id_GostR3410_94 812 +#define OBJ_id_GostR3410_94 OBJ_cryptopro,20L + +#define SN_id_Gost28147_89 "gost89" +#define LN_id_Gost28147_89 "GOST 28147-89" +#define NID_id_Gost28147_89 813 +#define OBJ_id_Gost28147_89 OBJ_cryptopro,21L + +#define SN_gost89_cnt "gost89-cnt" +#define NID_gost89_cnt 814 + +#define SN_gost89_cnt_12 "gost89-cnt-12" +#define NID_gost89_cnt_12 975 + +#define SN_gost89_cbc "gost89-cbc" +#define NID_gost89_cbc 1009 + +#define SN_gost89_ecb "gost89-ecb" +#define NID_gost89_ecb 1010 + +#define SN_gost89_ctr "gost89-ctr" +#define NID_gost89_ctr 1011 + +#define SN_id_Gost28147_89_MAC "gost-mac" +#define LN_id_Gost28147_89_MAC "GOST 28147-89 MAC" +#define NID_id_Gost28147_89_MAC 815 +#define OBJ_id_Gost28147_89_MAC OBJ_cryptopro,22L + +#define SN_gost_mac_12 "gost-mac-12" +#define NID_gost_mac_12 976 + +#define SN_id_GostR3411_94_prf "prf-gostr3411-94" +#define LN_id_GostR3411_94_prf "GOST R 34.11-94 PRF" +#define NID_id_GostR3411_94_prf 816 +#define OBJ_id_GostR3411_94_prf OBJ_cryptopro,23L + +#define SN_id_GostR3410_2001DH "id-GostR3410-2001DH" +#define LN_id_GostR3410_2001DH "GOST R 34.10-2001 DH" +#define NID_id_GostR3410_2001DH 817 +#define OBJ_id_GostR3410_2001DH OBJ_cryptopro,98L + +#define SN_id_GostR3410_94DH "id-GostR3410-94DH" +#define LN_id_GostR3410_94DH "GOST R 34.10-94 DH" +#define NID_id_GostR3410_94DH 818 +#define OBJ_id_GostR3410_94DH OBJ_cryptopro,99L + +#define SN_id_Gost28147_89_CryptoPro_KeyMeshing "id-Gost28147-89-CryptoPro-KeyMeshing" +#define NID_id_Gost28147_89_CryptoPro_KeyMeshing 819 +#define OBJ_id_Gost28147_89_CryptoPro_KeyMeshing OBJ_cryptopro,14L,1L + +#define SN_id_Gost28147_89_None_KeyMeshing "id-Gost28147-89-None-KeyMeshing" +#define NID_id_Gost28147_89_None_KeyMeshing 820 +#define OBJ_id_Gost28147_89_None_KeyMeshing OBJ_cryptopro,14L,0L + +#define SN_id_GostR3411_94_TestParamSet "id-GostR3411-94-TestParamSet" +#define NID_id_GostR3411_94_TestParamSet 821 +#define OBJ_id_GostR3411_94_TestParamSet OBJ_cryptopro,30L,0L + +#define SN_id_GostR3411_94_CryptoProParamSet "id-GostR3411-94-CryptoProParamSet" +#define NID_id_GostR3411_94_CryptoProParamSet 822 +#define OBJ_id_GostR3411_94_CryptoProParamSet OBJ_cryptopro,30L,1L + +#define SN_id_Gost28147_89_TestParamSet "id-Gost28147-89-TestParamSet" +#define NID_id_Gost28147_89_TestParamSet 823 +#define OBJ_id_Gost28147_89_TestParamSet OBJ_cryptopro,31L,0L + +#define SN_id_Gost28147_89_CryptoPro_A_ParamSet "id-Gost28147-89-CryptoPro-A-ParamSet" +#define NID_id_Gost28147_89_CryptoPro_A_ParamSet 824 +#define OBJ_id_Gost28147_89_CryptoPro_A_ParamSet OBJ_cryptopro,31L,1L + +#define SN_id_Gost28147_89_CryptoPro_B_ParamSet "id-Gost28147-89-CryptoPro-B-ParamSet" +#define NID_id_Gost28147_89_CryptoPro_B_ParamSet 825 +#define OBJ_id_Gost28147_89_CryptoPro_B_ParamSet OBJ_cryptopro,31L,2L + +#define SN_id_Gost28147_89_CryptoPro_C_ParamSet "id-Gost28147-89-CryptoPro-C-ParamSet" +#define NID_id_Gost28147_89_CryptoPro_C_ParamSet 826 +#define OBJ_id_Gost28147_89_CryptoPro_C_ParamSet OBJ_cryptopro,31L,3L + +#define SN_id_Gost28147_89_CryptoPro_D_ParamSet "id-Gost28147-89-CryptoPro-D-ParamSet" +#define NID_id_Gost28147_89_CryptoPro_D_ParamSet 827 +#define OBJ_id_Gost28147_89_CryptoPro_D_ParamSet OBJ_cryptopro,31L,4L + +#define SN_id_Gost28147_89_CryptoPro_Oscar_1_1_ParamSet "id-Gost28147-89-CryptoPro-Oscar-1-1-ParamSet" +#define NID_id_Gost28147_89_CryptoPro_Oscar_1_1_ParamSet 828 +#define OBJ_id_Gost28147_89_CryptoPro_Oscar_1_1_ParamSet OBJ_cryptopro,31L,5L + +#define SN_id_Gost28147_89_CryptoPro_Oscar_1_0_ParamSet "id-Gost28147-89-CryptoPro-Oscar-1-0-ParamSet" +#define NID_id_Gost28147_89_CryptoPro_Oscar_1_0_ParamSet 829 +#define OBJ_id_Gost28147_89_CryptoPro_Oscar_1_0_ParamSet OBJ_cryptopro,31L,6L + +#define SN_id_Gost28147_89_CryptoPro_RIC_1_ParamSet "id-Gost28147-89-CryptoPro-RIC-1-ParamSet" +#define NID_id_Gost28147_89_CryptoPro_RIC_1_ParamSet 830 +#define OBJ_id_Gost28147_89_CryptoPro_RIC_1_ParamSet OBJ_cryptopro,31L,7L + +#define SN_id_GostR3410_94_TestParamSet "id-GostR3410-94-TestParamSet" +#define NID_id_GostR3410_94_TestParamSet 831 +#define OBJ_id_GostR3410_94_TestParamSet OBJ_cryptopro,32L,0L + +#define SN_id_GostR3410_94_CryptoPro_A_ParamSet "id-GostR3410-94-CryptoPro-A-ParamSet" +#define NID_id_GostR3410_94_CryptoPro_A_ParamSet 832 +#define OBJ_id_GostR3410_94_CryptoPro_A_ParamSet OBJ_cryptopro,32L,2L + +#define SN_id_GostR3410_94_CryptoPro_B_ParamSet "id-GostR3410-94-CryptoPro-B-ParamSet" +#define NID_id_GostR3410_94_CryptoPro_B_ParamSet 833 +#define OBJ_id_GostR3410_94_CryptoPro_B_ParamSet OBJ_cryptopro,32L,3L + +#define SN_id_GostR3410_94_CryptoPro_C_ParamSet "id-GostR3410-94-CryptoPro-C-ParamSet" +#define NID_id_GostR3410_94_CryptoPro_C_ParamSet 834 +#define OBJ_id_GostR3410_94_CryptoPro_C_ParamSet OBJ_cryptopro,32L,4L + +#define SN_id_GostR3410_94_CryptoPro_D_ParamSet "id-GostR3410-94-CryptoPro-D-ParamSet" +#define NID_id_GostR3410_94_CryptoPro_D_ParamSet 835 +#define OBJ_id_GostR3410_94_CryptoPro_D_ParamSet OBJ_cryptopro,32L,5L + +#define SN_id_GostR3410_94_CryptoPro_XchA_ParamSet "id-GostR3410-94-CryptoPro-XchA-ParamSet" +#define NID_id_GostR3410_94_CryptoPro_XchA_ParamSet 836 +#define OBJ_id_GostR3410_94_CryptoPro_XchA_ParamSet OBJ_cryptopro,33L,1L + +#define SN_id_GostR3410_94_CryptoPro_XchB_ParamSet "id-GostR3410-94-CryptoPro-XchB-ParamSet" +#define NID_id_GostR3410_94_CryptoPro_XchB_ParamSet 837 +#define OBJ_id_GostR3410_94_CryptoPro_XchB_ParamSet OBJ_cryptopro,33L,2L + +#define SN_id_GostR3410_94_CryptoPro_XchC_ParamSet "id-GostR3410-94-CryptoPro-XchC-ParamSet" +#define NID_id_GostR3410_94_CryptoPro_XchC_ParamSet 838 +#define OBJ_id_GostR3410_94_CryptoPro_XchC_ParamSet OBJ_cryptopro,33L,3L + +#define SN_id_GostR3410_2001_TestParamSet "id-GostR3410-2001-TestParamSet" +#define NID_id_GostR3410_2001_TestParamSet 839 +#define OBJ_id_GostR3410_2001_TestParamSet OBJ_cryptopro,35L,0L + +#define SN_id_GostR3410_2001_CryptoPro_A_ParamSet "id-GostR3410-2001-CryptoPro-A-ParamSet" +#define NID_id_GostR3410_2001_CryptoPro_A_ParamSet 840 +#define OBJ_id_GostR3410_2001_CryptoPro_A_ParamSet OBJ_cryptopro,35L,1L + +#define SN_id_GostR3410_2001_CryptoPro_B_ParamSet "id-GostR3410-2001-CryptoPro-B-ParamSet" +#define NID_id_GostR3410_2001_CryptoPro_B_ParamSet 841 +#define OBJ_id_GostR3410_2001_CryptoPro_B_ParamSet OBJ_cryptopro,35L,2L + +#define SN_id_GostR3410_2001_CryptoPro_C_ParamSet "id-GostR3410-2001-CryptoPro-C-ParamSet" +#define NID_id_GostR3410_2001_CryptoPro_C_ParamSet 842 +#define OBJ_id_GostR3410_2001_CryptoPro_C_ParamSet OBJ_cryptopro,35L,3L + +#define SN_id_GostR3410_2001_CryptoPro_XchA_ParamSet "id-GostR3410-2001-CryptoPro-XchA-ParamSet" +#define NID_id_GostR3410_2001_CryptoPro_XchA_ParamSet 843 +#define OBJ_id_GostR3410_2001_CryptoPro_XchA_ParamSet OBJ_cryptopro,36L,0L + +#define SN_id_GostR3410_2001_CryptoPro_XchB_ParamSet "id-GostR3410-2001-CryptoPro-XchB-ParamSet" +#define NID_id_GostR3410_2001_CryptoPro_XchB_ParamSet 844 +#define OBJ_id_GostR3410_2001_CryptoPro_XchB_ParamSet OBJ_cryptopro,36L,1L + +#define SN_id_GostR3410_94_a "id-GostR3410-94-a" +#define NID_id_GostR3410_94_a 845 +#define OBJ_id_GostR3410_94_a OBJ_id_GostR3410_94,1L + +#define SN_id_GostR3410_94_aBis "id-GostR3410-94-aBis" +#define NID_id_GostR3410_94_aBis 846 +#define OBJ_id_GostR3410_94_aBis OBJ_id_GostR3410_94,2L + +#define SN_id_GostR3410_94_b "id-GostR3410-94-b" +#define NID_id_GostR3410_94_b 847 +#define OBJ_id_GostR3410_94_b OBJ_id_GostR3410_94,3L + +#define SN_id_GostR3410_94_bBis "id-GostR3410-94-bBis" +#define NID_id_GostR3410_94_bBis 848 +#define OBJ_id_GostR3410_94_bBis OBJ_id_GostR3410_94,4L + +#define SN_id_Gost28147_89_cc "id-Gost28147-89-cc" +#define LN_id_Gost28147_89_cc "GOST 28147-89 Cryptocom ParamSet" +#define NID_id_Gost28147_89_cc 849 +#define OBJ_id_Gost28147_89_cc OBJ_cryptocom,1L,6L,1L + +#define SN_id_GostR3410_94_cc "gost94cc" +#define LN_id_GostR3410_94_cc "GOST 34.10-94 Cryptocom" +#define NID_id_GostR3410_94_cc 850 +#define OBJ_id_GostR3410_94_cc OBJ_cryptocom,1L,5L,3L + +#define SN_id_GostR3410_2001_cc "gost2001cc" +#define LN_id_GostR3410_2001_cc "GOST 34.10-2001 Cryptocom" +#define NID_id_GostR3410_2001_cc 851 +#define OBJ_id_GostR3410_2001_cc OBJ_cryptocom,1L,5L,4L + +#define SN_id_GostR3411_94_with_GostR3410_94_cc "id-GostR3411-94-with-GostR3410-94-cc" +#define LN_id_GostR3411_94_with_GostR3410_94_cc "GOST R 34.11-94 with GOST R 34.10-94 Cryptocom" +#define NID_id_GostR3411_94_with_GostR3410_94_cc 852 +#define OBJ_id_GostR3411_94_with_GostR3410_94_cc OBJ_cryptocom,1L,3L,3L + +#define SN_id_GostR3411_94_with_GostR3410_2001_cc "id-GostR3411-94-with-GostR3410-2001-cc" +#define LN_id_GostR3411_94_with_GostR3410_2001_cc "GOST R 34.11-94 with GOST R 34.10-2001 Cryptocom" +#define NID_id_GostR3411_94_with_GostR3410_2001_cc 853 +#define OBJ_id_GostR3411_94_with_GostR3410_2001_cc OBJ_cryptocom,1L,3L,4L + +#define SN_id_GostR3410_2001_ParamSet_cc "id-GostR3410-2001-ParamSet-cc" +#define LN_id_GostR3410_2001_ParamSet_cc "GOST R 3410-2001 Parameter Set Cryptocom" +#define NID_id_GostR3410_2001_ParamSet_cc 854 +#define OBJ_id_GostR3410_2001_ParamSet_cc OBJ_cryptocom,1L,8L,1L + +#define SN_id_tc26_algorithms "id-tc26-algorithms" +#define NID_id_tc26_algorithms 977 +#define OBJ_id_tc26_algorithms OBJ_id_tc26,1L + +#define SN_id_tc26_sign "id-tc26-sign" +#define NID_id_tc26_sign 978 +#define OBJ_id_tc26_sign OBJ_id_tc26_algorithms,1L + +#define SN_id_GostR3410_2012_256 "gost2012_256" +#define LN_id_GostR3410_2012_256 "GOST R 34.10-2012 with 256 bit modulus" +#define NID_id_GostR3410_2012_256 979 +#define OBJ_id_GostR3410_2012_256 OBJ_id_tc26_sign,1L + +#define SN_id_GostR3410_2012_512 "gost2012_512" +#define LN_id_GostR3410_2012_512 "GOST R 34.10-2012 with 512 bit modulus" +#define NID_id_GostR3410_2012_512 980 +#define OBJ_id_GostR3410_2012_512 OBJ_id_tc26_sign,2L + +#define SN_id_tc26_digest "id-tc26-digest" +#define NID_id_tc26_digest 981 +#define OBJ_id_tc26_digest OBJ_id_tc26_algorithms,2L + +#define SN_id_GostR3411_2012_256 "md_gost12_256" +#define LN_id_GostR3411_2012_256 "GOST R 34.11-2012 with 256 bit hash" +#define NID_id_GostR3411_2012_256 982 +#define OBJ_id_GostR3411_2012_256 OBJ_id_tc26_digest,2L + +#define SN_id_GostR3411_2012_512 "md_gost12_512" +#define LN_id_GostR3411_2012_512 "GOST R 34.11-2012 with 512 bit hash" +#define NID_id_GostR3411_2012_512 983 +#define OBJ_id_GostR3411_2012_512 OBJ_id_tc26_digest,3L + +#define SN_id_tc26_signwithdigest "id-tc26-signwithdigest" +#define NID_id_tc26_signwithdigest 984 +#define OBJ_id_tc26_signwithdigest OBJ_id_tc26_algorithms,3L + +#define SN_id_tc26_signwithdigest_gost3410_2012_256 "id-tc26-signwithdigest-gost3410-2012-256" +#define LN_id_tc26_signwithdigest_gost3410_2012_256 "GOST R 34.10-2012 with GOST R 34.11-2012 (256 bit)" +#define NID_id_tc26_signwithdigest_gost3410_2012_256 985 +#define OBJ_id_tc26_signwithdigest_gost3410_2012_256 OBJ_id_tc26_signwithdigest,2L + +#define SN_id_tc26_signwithdigest_gost3410_2012_512 "id-tc26-signwithdigest-gost3410-2012-512" +#define LN_id_tc26_signwithdigest_gost3410_2012_512 "GOST R 34.10-2012 with GOST R 34.11-2012 (512 bit)" +#define NID_id_tc26_signwithdigest_gost3410_2012_512 986 +#define OBJ_id_tc26_signwithdigest_gost3410_2012_512 OBJ_id_tc26_signwithdigest,3L + +#define SN_id_tc26_mac "id-tc26-mac" +#define NID_id_tc26_mac 987 +#define OBJ_id_tc26_mac OBJ_id_tc26_algorithms,4L + +#define SN_id_tc26_hmac_gost_3411_2012_256 "id-tc26-hmac-gost-3411-2012-256" +#define LN_id_tc26_hmac_gost_3411_2012_256 "HMAC GOST 34.11-2012 256 bit" +#define NID_id_tc26_hmac_gost_3411_2012_256 988 +#define OBJ_id_tc26_hmac_gost_3411_2012_256 OBJ_id_tc26_mac,1L + +#define SN_id_tc26_hmac_gost_3411_2012_512 "id-tc26-hmac-gost-3411-2012-512" +#define LN_id_tc26_hmac_gost_3411_2012_512 "HMAC GOST 34.11-2012 512 bit" +#define NID_id_tc26_hmac_gost_3411_2012_512 989 +#define OBJ_id_tc26_hmac_gost_3411_2012_512 OBJ_id_tc26_mac,2L + +#define SN_id_tc26_cipher "id-tc26-cipher" +#define NID_id_tc26_cipher 990 +#define OBJ_id_tc26_cipher OBJ_id_tc26_algorithms,5L + +#define SN_id_tc26_cipher_gostr3412_2015_magma "id-tc26-cipher-gostr3412-2015-magma" +#define NID_id_tc26_cipher_gostr3412_2015_magma 1173 +#define OBJ_id_tc26_cipher_gostr3412_2015_magma OBJ_id_tc26_cipher,1L + +#define SN_id_tc26_cipher_gostr3412_2015_magma_ctracpkm "id-tc26-cipher-gostr3412-2015-magma-ctracpkm" +#define NID_id_tc26_cipher_gostr3412_2015_magma_ctracpkm 1174 +#define OBJ_id_tc26_cipher_gostr3412_2015_magma_ctracpkm OBJ_id_tc26_cipher_gostr3412_2015_magma,1L + +#define SN_id_tc26_cipher_gostr3412_2015_magma_ctracpkm_omac "id-tc26-cipher-gostr3412-2015-magma-ctracpkm-omac" +#define NID_id_tc26_cipher_gostr3412_2015_magma_ctracpkm_omac 1175 +#define OBJ_id_tc26_cipher_gostr3412_2015_magma_ctracpkm_omac OBJ_id_tc26_cipher_gostr3412_2015_magma,2L + +#define SN_id_tc26_cipher_gostr3412_2015_kuznyechik "id-tc26-cipher-gostr3412-2015-kuznyechik" +#define NID_id_tc26_cipher_gostr3412_2015_kuznyechik 1176 +#define OBJ_id_tc26_cipher_gostr3412_2015_kuznyechik OBJ_id_tc26_cipher,2L + +#define SN_id_tc26_cipher_gostr3412_2015_kuznyechik_ctracpkm "id-tc26-cipher-gostr3412-2015-kuznyechik-ctracpkm" +#define NID_id_tc26_cipher_gostr3412_2015_kuznyechik_ctracpkm 1177 +#define OBJ_id_tc26_cipher_gostr3412_2015_kuznyechik_ctracpkm OBJ_id_tc26_cipher_gostr3412_2015_kuznyechik,1L + +#define SN_id_tc26_cipher_gostr3412_2015_kuznyechik_ctracpkm_omac "id-tc26-cipher-gostr3412-2015-kuznyechik-ctracpkm-omac" +#define NID_id_tc26_cipher_gostr3412_2015_kuznyechik_ctracpkm_omac 1178 +#define OBJ_id_tc26_cipher_gostr3412_2015_kuznyechik_ctracpkm_omac OBJ_id_tc26_cipher_gostr3412_2015_kuznyechik,2L + +#define SN_id_tc26_agreement "id-tc26-agreement" +#define NID_id_tc26_agreement 991 +#define OBJ_id_tc26_agreement OBJ_id_tc26_algorithms,6L + +#define SN_id_tc26_agreement_gost_3410_2012_256 "id-tc26-agreement-gost-3410-2012-256" +#define NID_id_tc26_agreement_gost_3410_2012_256 992 +#define OBJ_id_tc26_agreement_gost_3410_2012_256 OBJ_id_tc26_agreement,1L + +#define SN_id_tc26_agreement_gost_3410_2012_512 "id-tc26-agreement-gost-3410-2012-512" +#define NID_id_tc26_agreement_gost_3410_2012_512 993 +#define OBJ_id_tc26_agreement_gost_3410_2012_512 OBJ_id_tc26_agreement,2L + +#define SN_id_tc26_wrap "id-tc26-wrap" +#define NID_id_tc26_wrap 1179 +#define OBJ_id_tc26_wrap OBJ_id_tc26_algorithms,7L + +#define SN_id_tc26_wrap_gostr3412_2015_magma "id-tc26-wrap-gostr3412-2015-magma" +#define NID_id_tc26_wrap_gostr3412_2015_magma 1180 +#define OBJ_id_tc26_wrap_gostr3412_2015_magma OBJ_id_tc26_wrap,1L + +#define SN_id_tc26_wrap_gostr3412_2015_magma_kexp15 "id-tc26-wrap-gostr3412-2015-magma-kexp15" +#define NID_id_tc26_wrap_gostr3412_2015_magma_kexp15 1181 +#define OBJ_id_tc26_wrap_gostr3412_2015_magma_kexp15 OBJ_id_tc26_wrap_gostr3412_2015_magma,1L + +#define SN_id_tc26_wrap_gostr3412_2015_kuznyechik "id-tc26-wrap-gostr3412-2015-kuznyechik" +#define NID_id_tc26_wrap_gostr3412_2015_kuznyechik 1182 +#define OBJ_id_tc26_wrap_gostr3412_2015_kuznyechik OBJ_id_tc26_wrap,2L + +#define SN_id_tc26_wrap_gostr3412_2015_kuznyechik_kexp15 "id-tc26-wrap-gostr3412-2015-kuznyechik-kexp15" +#define NID_id_tc26_wrap_gostr3412_2015_kuznyechik_kexp15 1183 +#define OBJ_id_tc26_wrap_gostr3412_2015_kuznyechik_kexp15 OBJ_id_tc26_wrap_gostr3412_2015_magma,1L + +#define SN_id_tc26_constants "id-tc26-constants" +#define NID_id_tc26_constants 994 +#define OBJ_id_tc26_constants OBJ_id_tc26,2L + +#define SN_id_tc26_sign_constants "id-tc26-sign-constants" +#define NID_id_tc26_sign_constants 995 +#define OBJ_id_tc26_sign_constants OBJ_id_tc26_constants,1L + +#define SN_id_tc26_gost_3410_2012_256_constants "id-tc26-gost-3410-2012-256-constants" +#define NID_id_tc26_gost_3410_2012_256_constants 1147 +#define OBJ_id_tc26_gost_3410_2012_256_constants OBJ_id_tc26_sign_constants,1L + +#define SN_id_tc26_gost_3410_2012_256_paramSetA "id-tc26-gost-3410-2012-256-paramSetA" +#define LN_id_tc26_gost_3410_2012_256_paramSetA "GOST R 34.10-2012 (256 bit) ParamSet A" +#define NID_id_tc26_gost_3410_2012_256_paramSetA 1148 +#define OBJ_id_tc26_gost_3410_2012_256_paramSetA OBJ_id_tc26_gost_3410_2012_256_constants,1L + +#define SN_id_tc26_gost_3410_2012_256_paramSetB "id-tc26-gost-3410-2012-256-paramSetB" +#define LN_id_tc26_gost_3410_2012_256_paramSetB "GOST R 34.10-2012 (256 bit) ParamSet B" +#define NID_id_tc26_gost_3410_2012_256_paramSetB 1184 +#define OBJ_id_tc26_gost_3410_2012_256_paramSetB OBJ_id_tc26_gost_3410_2012_256_constants,2L + +#define SN_id_tc26_gost_3410_2012_256_paramSetC "id-tc26-gost-3410-2012-256-paramSetC" +#define LN_id_tc26_gost_3410_2012_256_paramSetC "GOST R 34.10-2012 (256 bit) ParamSet C" +#define NID_id_tc26_gost_3410_2012_256_paramSetC 1185 +#define OBJ_id_tc26_gost_3410_2012_256_paramSetC OBJ_id_tc26_gost_3410_2012_256_constants,3L + +#define SN_id_tc26_gost_3410_2012_256_paramSetD "id-tc26-gost-3410-2012-256-paramSetD" +#define LN_id_tc26_gost_3410_2012_256_paramSetD "GOST R 34.10-2012 (256 bit) ParamSet D" +#define NID_id_tc26_gost_3410_2012_256_paramSetD 1186 +#define OBJ_id_tc26_gost_3410_2012_256_paramSetD OBJ_id_tc26_gost_3410_2012_256_constants,4L + +#define SN_id_tc26_gost_3410_2012_512_constants "id-tc26-gost-3410-2012-512-constants" +#define NID_id_tc26_gost_3410_2012_512_constants 996 +#define OBJ_id_tc26_gost_3410_2012_512_constants OBJ_id_tc26_sign_constants,2L + +#define SN_id_tc26_gost_3410_2012_512_paramSetTest "id-tc26-gost-3410-2012-512-paramSetTest" +#define LN_id_tc26_gost_3410_2012_512_paramSetTest "GOST R 34.10-2012 (512 bit) testing parameter set" +#define NID_id_tc26_gost_3410_2012_512_paramSetTest 997 +#define OBJ_id_tc26_gost_3410_2012_512_paramSetTest OBJ_id_tc26_gost_3410_2012_512_constants,0L + +#define SN_id_tc26_gost_3410_2012_512_paramSetA "id-tc26-gost-3410-2012-512-paramSetA" +#define LN_id_tc26_gost_3410_2012_512_paramSetA "GOST R 34.10-2012 (512 bit) ParamSet A" +#define NID_id_tc26_gost_3410_2012_512_paramSetA 998 +#define OBJ_id_tc26_gost_3410_2012_512_paramSetA OBJ_id_tc26_gost_3410_2012_512_constants,1L + +#define SN_id_tc26_gost_3410_2012_512_paramSetB "id-tc26-gost-3410-2012-512-paramSetB" +#define LN_id_tc26_gost_3410_2012_512_paramSetB "GOST R 34.10-2012 (512 bit) ParamSet B" +#define NID_id_tc26_gost_3410_2012_512_paramSetB 999 +#define OBJ_id_tc26_gost_3410_2012_512_paramSetB OBJ_id_tc26_gost_3410_2012_512_constants,2L + +#define SN_id_tc26_gost_3410_2012_512_paramSetC "id-tc26-gost-3410-2012-512-paramSetC" +#define LN_id_tc26_gost_3410_2012_512_paramSetC "GOST R 34.10-2012 (512 bit) ParamSet C" +#define NID_id_tc26_gost_3410_2012_512_paramSetC 1149 +#define OBJ_id_tc26_gost_3410_2012_512_paramSetC OBJ_id_tc26_gost_3410_2012_512_constants,3L + +#define SN_id_tc26_digest_constants "id-tc26-digest-constants" +#define NID_id_tc26_digest_constants 1000 +#define OBJ_id_tc26_digest_constants OBJ_id_tc26_constants,2L + +#define SN_id_tc26_cipher_constants "id-tc26-cipher-constants" +#define NID_id_tc26_cipher_constants 1001 +#define OBJ_id_tc26_cipher_constants OBJ_id_tc26_constants,5L + +#define SN_id_tc26_gost_28147_constants "id-tc26-gost-28147-constants" +#define NID_id_tc26_gost_28147_constants 1002 +#define OBJ_id_tc26_gost_28147_constants OBJ_id_tc26_cipher_constants,1L + +#define SN_id_tc26_gost_28147_param_Z "id-tc26-gost-28147-param-Z" +#define LN_id_tc26_gost_28147_param_Z "GOST 28147-89 TC26 parameter set" +#define NID_id_tc26_gost_28147_param_Z 1003 +#define OBJ_id_tc26_gost_28147_param_Z OBJ_id_tc26_gost_28147_constants,1L + +#define SN_INN "INN" +#define LN_INN "INN" +#define NID_INN 1004 +#define OBJ_INN OBJ_member_body,643L,3L,131L,1L,1L + +#define SN_OGRN "OGRN" +#define LN_OGRN "OGRN" +#define NID_OGRN 1005 +#define OBJ_OGRN OBJ_member_body,643L,100L,1L + +#define SN_SNILS "SNILS" +#define LN_SNILS "SNILS" +#define NID_SNILS 1006 +#define OBJ_SNILS OBJ_member_body,643L,100L,3L + +#define SN_subjectSignTool "subjectSignTool" +#define LN_subjectSignTool "Signing Tool of Subject" +#define NID_subjectSignTool 1007 +#define OBJ_subjectSignTool OBJ_member_body,643L,100L,111L + +#define SN_issuerSignTool "issuerSignTool" +#define LN_issuerSignTool "Signing Tool of Issuer" +#define NID_issuerSignTool 1008 +#define OBJ_issuerSignTool OBJ_member_body,643L,100L,112L + +#define SN_grasshopper_ecb "grasshopper-ecb" +#define NID_grasshopper_ecb 1012 + +#define SN_grasshopper_ctr "grasshopper-ctr" +#define NID_grasshopper_ctr 1013 + +#define SN_grasshopper_ofb "grasshopper-ofb" +#define NID_grasshopper_ofb 1014 + +#define SN_grasshopper_cbc "grasshopper-cbc" +#define NID_grasshopper_cbc 1015 + +#define SN_grasshopper_cfb "grasshopper-cfb" +#define NID_grasshopper_cfb 1016 + +#define SN_grasshopper_mac "grasshopper-mac" +#define NID_grasshopper_mac 1017 + +#define SN_magma_ecb "magma-ecb" +#define NID_magma_ecb 1187 + +#define SN_magma_ctr "magma-ctr" +#define NID_magma_ctr 1188 + +#define SN_magma_ofb "magma-ofb" +#define NID_magma_ofb 1189 + +#define SN_magma_cbc "magma-cbc" +#define NID_magma_cbc 1190 + +#define SN_magma_cfb "magma-cfb" +#define NID_magma_cfb 1191 + +#define SN_magma_mac "magma-mac" +#define NID_magma_mac 1192 + +#define SN_camellia_128_cbc "CAMELLIA-128-CBC" +#define LN_camellia_128_cbc "camellia-128-cbc" +#define NID_camellia_128_cbc 751 +#define OBJ_camellia_128_cbc 1L,2L,392L,200011L,61L,1L,1L,1L,2L + +#define SN_camellia_192_cbc "CAMELLIA-192-CBC" +#define LN_camellia_192_cbc "camellia-192-cbc" +#define NID_camellia_192_cbc 752 +#define OBJ_camellia_192_cbc 1L,2L,392L,200011L,61L,1L,1L,1L,3L + +#define SN_camellia_256_cbc "CAMELLIA-256-CBC" +#define LN_camellia_256_cbc "camellia-256-cbc" +#define NID_camellia_256_cbc 753 +#define OBJ_camellia_256_cbc 1L,2L,392L,200011L,61L,1L,1L,1L,4L + +#define SN_id_camellia128_wrap "id-camellia128-wrap" +#define NID_id_camellia128_wrap 907 +#define OBJ_id_camellia128_wrap 1L,2L,392L,200011L,61L,1L,1L,3L,2L + +#define SN_id_camellia192_wrap "id-camellia192-wrap" +#define NID_id_camellia192_wrap 908 +#define OBJ_id_camellia192_wrap 1L,2L,392L,200011L,61L,1L,1L,3L,3L + +#define SN_id_camellia256_wrap "id-camellia256-wrap" +#define NID_id_camellia256_wrap 909 +#define OBJ_id_camellia256_wrap 1L,2L,392L,200011L,61L,1L,1L,3L,4L + +#define OBJ_ntt_ds 0L,3L,4401L,5L + +#define OBJ_camellia OBJ_ntt_ds,3L,1L,9L + +#define SN_camellia_128_ecb "CAMELLIA-128-ECB" +#define LN_camellia_128_ecb "camellia-128-ecb" +#define NID_camellia_128_ecb 754 +#define OBJ_camellia_128_ecb OBJ_camellia,1L + +#define SN_camellia_128_ofb128 "CAMELLIA-128-OFB" +#define LN_camellia_128_ofb128 "camellia-128-ofb" +#define NID_camellia_128_ofb128 766 +#define OBJ_camellia_128_ofb128 OBJ_camellia,3L + +#define SN_camellia_128_cfb128 "CAMELLIA-128-CFB" +#define LN_camellia_128_cfb128 "camellia-128-cfb" +#define NID_camellia_128_cfb128 757 +#define OBJ_camellia_128_cfb128 OBJ_camellia,4L + +#define SN_camellia_128_gcm "CAMELLIA-128-GCM" +#define LN_camellia_128_gcm "camellia-128-gcm" +#define NID_camellia_128_gcm 961 +#define OBJ_camellia_128_gcm OBJ_camellia,6L + +#define SN_camellia_128_ccm "CAMELLIA-128-CCM" +#define LN_camellia_128_ccm "camellia-128-ccm" +#define NID_camellia_128_ccm 962 +#define OBJ_camellia_128_ccm OBJ_camellia,7L + +#define SN_camellia_128_ctr "CAMELLIA-128-CTR" +#define LN_camellia_128_ctr "camellia-128-ctr" +#define NID_camellia_128_ctr 963 +#define OBJ_camellia_128_ctr OBJ_camellia,9L + +#define SN_camellia_128_cmac "CAMELLIA-128-CMAC" +#define LN_camellia_128_cmac "camellia-128-cmac" +#define NID_camellia_128_cmac 964 +#define OBJ_camellia_128_cmac OBJ_camellia,10L + +#define SN_camellia_192_ecb "CAMELLIA-192-ECB" +#define LN_camellia_192_ecb "camellia-192-ecb" +#define NID_camellia_192_ecb 755 +#define OBJ_camellia_192_ecb OBJ_camellia,21L + +#define SN_camellia_192_ofb128 "CAMELLIA-192-OFB" +#define LN_camellia_192_ofb128 "camellia-192-ofb" +#define NID_camellia_192_ofb128 767 +#define OBJ_camellia_192_ofb128 OBJ_camellia,23L + +#define SN_camellia_192_cfb128 "CAMELLIA-192-CFB" +#define LN_camellia_192_cfb128 "camellia-192-cfb" +#define NID_camellia_192_cfb128 758 +#define OBJ_camellia_192_cfb128 OBJ_camellia,24L + +#define SN_camellia_192_gcm "CAMELLIA-192-GCM" +#define LN_camellia_192_gcm "camellia-192-gcm" +#define NID_camellia_192_gcm 965 +#define OBJ_camellia_192_gcm OBJ_camellia,26L + +#define SN_camellia_192_ccm "CAMELLIA-192-CCM" +#define LN_camellia_192_ccm "camellia-192-ccm" +#define NID_camellia_192_ccm 966 +#define OBJ_camellia_192_ccm OBJ_camellia,27L + +#define SN_camellia_192_ctr "CAMELLIA-192-CTR" +#define LN_camellia_192_ctr "camellia-192-ctr" +#define NID_camellia_192_ctr 967 +#define OBJ_camellia_192_ctr OBJ_camellia,29L + +#define SN_camellia_192_cmac "CAMELLIA-192-CMAC" +#define LN_camellia_192_cmac "camellia-192-cmac" +#define NID_camellia_192_cmac 968 +#define OBJ_camellia_192_cmac OBJ_camellia,30L + +#define SN_camellia_256_ecb "CAMELLIA-256-ECB" +#define LN_camellia_256_ecb "camellia-256-ecb" +#define NID_camellia_256_ecb 756 +#define OBJ_camellia_256_ecb OBJ_camellia,41L + +#define SN_camellia_256_ofb128 "CAMELLIA-256-OFB" +#define LN_camellia_256_ofb128 "camellia-256-ofb" +#define NID_camellia_256_ofb128 768 +#define OBJ_camellia_256_ofb128 OBJ_camellia,43L + +#define SN_camellia_256_cfb128 "CAMELLIA-256-CFB" +#define LN_camellia_256_cfb128 "camellia-256-cfb" +#define NID_camellia_256_cfb128 759 +#define OBJ_camellia_256_cfb128 OBJ_camellia,44L + +#define SN_camellia_256_gcm "CAMELLIA-256-GCM" +#define LN_camellia_256_gcm "camellia-256-gcm" +#define NID_camellia_256_gcm 969 +#define OBJ_camellia_256_gcm OBJ_camellia,46L + +#define SN_camellia_256_ccm "CAMELLIA-256-CCM" +#define LN_camellia_256_ccm "camellia-256-ccm" +#define NID_camellia_256_ccm 970 +#define OBJ_camellia_256_ccm OBJ_camellia,47L + +#define SN_camellia_256_ctr "CAMELLIA-256-CTR" +#define LN_camellia_256_ctr "camellia-256-ctr" +#define NID_camellia_256_ctr 971 +#define OBJ_camellia_256_ctr OBJ_camellia,49L + +#define SN_camellia_256_cmac "CAMELLIA-256-CMAC" +#define LN_camellia_256_cmac "camellia-256-cmac" +#define NID_camellia_256_cmac 972 +#define OBJ_camellia_256_cmac OBJ_camellia,50L + +#define SN_camellia_128_cfb1 "CAMELLIA-128-CFB1" +#define LN_camellia_128_cfb1 "camellia-128-cfb1" +#define NID_camellia_128_cfb1 760 + +#define SN_camellia_192_cfb1 "CAMELLIA-192-CFB1" +#define LN_camellia_192_cfb1 "camellia-192-cfb1" +#define NID_camellia_192_cfb1 761 + +#define SN_camellia_256_cfb1 "CAMELLIA-256-CFB1" +#define LN_camellia_256_cfb1 "camellia-256-cfb1" +#define NID_camellia_256_cfb1 762 + +#define SN_camellia_128_cfb8 "CAMELLIA-128-CFB8" +#define LN_camellia_128_cfb8 "camellia-128-cfb8" +#define NID_camellia_128_cfb8 763 + +#define SN_camellia_192_cfb8 "CAMELLIA-192-CFB8" +#define LN_camellia_192_cfb8 "camellia-192-cfb8" +#define NID_camellia_192_cfb8 764 + +#define SN_camellia_256_cfb8 "CAMELLIA-256-CFB8" +#define LN_camellia_256_cfb8 "camellia-256-cfb8" +#define NID_camellia_256_cfb8 765 + +#define OBJ_aria 1L,2L,410L,200046L,1L,1L + +#define SN_aria_128_ecb "ARIA-128-ECB" +#define LN_aria_128_ecb "aria-128-ecb" +#define NID_aria_128_ecb 1065 +#define OBJ_aria_128_ecb OBJ_aria,1L + +#define SN_aria_128_cbc "ARIA-128-CBC" +#define LN_aria_128_cbc "aria-128-cbc" +#define NID_aria_128_cbc 1066 +#define OBJ_aria_128_cbc OBJ_aria,2L + +#define SN_aria_128_cfb128 "ARIA-128-CFB" +#define LN_aria_128_cfb128 "aria-128-cfb" +#define NID_aria_128_cfb128 1067 +#define OBJ_aria_128_cfb128 OBJ_aria,3L + +#define SN_aria_128_ofb128 "ARIA-128-OFB" +#define LN_aria_128_ofb128 "aria-128-ofb" +#define NID_aria_128_ofb128 1068 +#define OBJ_aria_128_ofb128 OBJ_aria,4L + +#define SN_aria_128_ctr "ARIA-128-CTR" +#define LN_aria_128_ctr "aria-128-ctr" +#define NID_aria_128_ctr 1069 +#define OBJ_aria_128_ctr OBJ_aria,5L + +#define SN_aria_192_ecb "ARIA-192-ECB" +#define LN_aria_192_ecb "aria-192-ecb" +#define NID_aria_192_ecb 1070 +#define OBJ_aria_192_ecb OBJ_aria,6L + +#define SN_aria_192_cbc "ARIA-192-CBC" +#define LN_aria_192_cbc "aria-192-cbc" +#define NID_aria_192_cbc 1071 +#define OBJ_aria_192_cbc OBJ_aria,7L + +#define SN_aria_192_cfb128 "ARIA-192-CFB" +#define LN_aria_192_cfb128 "aria-192-cfb" +#define NID_aria_192_cfb128 1072 +#define OBJ_aria_192_cfb128 OBJ_aria,8L + +#define SN_aria_192_ofb128 "ARIA-192-OFB" +#define LN_aria_192_ofb128 "aria-192-ofb" +#define NID_aria_192_ofb128 1073 +#define OBJ_aria_192_ofb128 OBJ_aria,9L + +#define SN_aria_192_ctr "ARIA-192-CTR" +#define LN_aria_192_ctr "aria-192-ctr" +#define NID_aria_192_ctr 1074 +#define OBJ_aria_192_ctr OBJ_aria,10L + +#define SN_aria_256_ecb "ARIA-256-ECB" +#define LN_aria_256_ecb "aria-256-ecb" +#define NID_aria_256_ecb 1075 +#define OBJ_aria_256_ecb OBJ_aria,11L + +#define SN_aria_256_cbc "ARIA-256-CBC" +#define LN_aria_256_cbc "aria-256-cbc" +#define NID_aria_256_cbc 1076 +#define OBJ_aria_256_cbc OBJ_aria,12L + +#define SN_aria_256_cfb128 "ARIA-256-CFB" +#define LN_aria_256_cfb128 "aria-256-cfb" +#define NID_aria_256_cfb128 1077 +#define OBJ_aria_256_cfb128 OBJ_aria,13L + +#define SN_aria_256_ofb128 "ARIA-256-OFB" +#define LN_aria_256_ofb128 "aria-256-ofb" +#define NID_aria_256_ofb128 1078 +#define OBJ_aria_256_ofb128 OBJ_aria,14L + +#define SN_aria_256_ctr "ARIA-256-CTR" +#define LN_aria_256_ctr "aria-256-ctr" +#define NID_aria_256_ctr 1079 +#define OBJ_aria_256_ctr OBJ_aria,15L + +#define SN_aria_128_cfb1 "ARIA-128-CFB1" +#define LN_aria_128_cfb1 "aria-128-cfb1" +#define NID_aria_128_cfb1 1080 + +#define SN_aria_192_cfb1 "ARIA-192-CFB1" +#define LN_aria_192_cfb1 "aria-192-cfb1" +#define NID_aria_192_cfb1 1081 + +#define SN_aria_256_cfb1 "ARIA-256-CFB1" +#define LN_aria_256_cfb1 "aria-256-cfb1" +#define NID_aria_256_cfb1 1082 + +#define SN_aria_128_cfb8 "ARIA-128-CFB8" +#define LN_aria_128_cfb8 "aria-128-cfb8" +#define NID_aria_128_cfb8 1083 + +#define SN_aria_192_cfb8 "ARIA-192-CFB8" +#define LN_aria_192_cfb8 "aria-192-cfb8" +#define NID_aria_192_cfb8 1084 + +#define SN_aria_256_cfb8 "ARIA-256-CFB8" +#define LN_aria_256_cfb8 "aria-256-cfb8" +#define NID_aria_256_cfb8 1085 + +#define SN_aria_128_ccm "ARIA-128-CCM" +#define LN_aria_128_ccm "aria-128-ccm" +#define NID_aria_128_ccm 1120 +#define OBJ_aria_128_ccm OBJ_aria,37L + +#define SN_aria_192_ccm "ARIA-192-CCM" +#define LN_aria_192_ccm "aria-192-ccm" +#define NID_aria_192_ccm 1121 +#define OBJ_aria_192_ccm OBJ_aria,38L + +#define SN_aria_256_ccm "ARIA-256-CCM" +#define LN_aria_256_ccm "aria-256-ccm" +#define NID_aria_256_ccm 1122 +#define OBJ_aria_256_ccm OBJ_aria,39L + +#define SN_aria_128_gcm "ARIA-128-GCM" +#define LN_aria_128_gcm "aria-128-gcm" +#define NID_aria_128_gcm 1123 +#define OBJ_aria_128_gcm OBJ_aria,34L + +#define SN_aria_192_gcm "ARIA-192-GCM" +#define LN_aria_192_gcm "aria-192-gcm" +#define NID_aria_192_gcm 1124 +#define OBJ_aria_192_gcm OBJ_aria,35L + +#define SN_aria_256_gcm "ARIA-256-GCM" +#define LN_aria_256_gcm "aria-256-gcm" +#define NID_aria_256_gcm 1125 +#define OBJ_aria_256_gcm OBJ_aria,36L + +#define SN_kisa "KISA" +#define LN_kisa "kisa" +#define NID_kisa 773 +#define OBJ_kisa OBJ_member_body,410L,200004L + +#define SN_seed_ecb "SEED-ECB" +#define LN_seed_ecb "seed-ecb" +#define NID_seed_ecb 776 +#define OBJ_seed_ecb OBJ_kisa,1L,3L + +#define SN_seed_cbc "SEED-CBC" +#define LN_seed_cbc "seed-cbc" +#define NID_seed_cbc 777 +#define OBJ_seed_cbc OBJ_kisa,1L,4L + +#define SN_seed_cfb128 "SEED-CFB" +#define LN_seed_cfb128 "seed-cfb" +#define NID_seed_cfb128 779 +#define OBJ_seed_cfb128 OBJ_kisa,1L,5L + +#define SN_seed_ofb128 "SEED-OFB" +#define LN_seed_ofb128 "seed-ofb" +#define NID_seed_ofb128 778 +#define OBJ_seed_ofb128 OBJ_kisa,1L,6L + +#define SN_sm4_ecb "SM4-ECB" +#define LN_sm4_ecb "sm4-ecb" +#define NID_sm4_ecb 1133 +#define OBJ_sm4_ecb OBJ_sm_scheme,104L,1L + +#define SN_sm4_cbc "SM4-CBC" +#define LN_sm4_cbc "sm4-cbc" +#define NID_sm4_cbc 1134 +#define OBJ_sm4_cbc OBJ_sm_scheme,104L,2L + +#define SN_sm4_ofb128 "SM4-OFB" +#define LN_sm4_ofb128 "sm4-ofb" +#define NID_sm4_ofb128 1135 +#define OBJ_sm4_ofb128 OBJ_sm_scheme,104L,3L + +#define SN_sm4_cfb128 "SM4-CFB" +#define LN_sm4_cfb128 "sm4-cfb" +#define NID_sm4_cfb128 1137 +#define OBJ_sm4_cfb128 OBJ_sm_scheme,104L,4L + +#define SN_sm4_cfb1 "SM4-CFB1" +#define LN_sm4_cfb1 "sm4-cfb1" +#define NID_sm4_cfb1 1136 +#define OBJ_sm4_cfb1 OBJ_sm_scheme,104L,5L + +#define SN_sm4_cfb8 "SM4-CFB8" +#define LN_sm4_cfb8 "sm4-cfb8" +#define NID_sm4_cfb8 1138 +#define OBJ_sm4_cfb8 OBJ_sm_scheme,104L,6L + +#define SN_sm4_ctr "SM4-CTR" +#define LN_sm4_ctr "sm4-ctr" +#define NID_sm4_ctr 1139 +#define OBJ_sm4_ctr OBJ_sm_scheme,104L,7L + +#define SN_hmac "HMAC" +#define LN_hmac "hmac" +#define NID_hmac 855 + +#define SN_cmac "CMAC" +#define LN_cmac "cmac" +#define NID_cmac 894 + +#define SN_rc4_hmac_md5 "RC4-HMAC-MD5" +#define LN_rc4_hmac_md5 "rc4-hmac-md5" +#define NID_rc4_hmac_md5 915 + +#define SN_aes_128_cbc_hmac_sha1 "AES-128-CBC-HMAC-SHA1" +#define LN_aes_128_cbc_hmac_sha1 "aes-128-cbc-hmac-sha1" +#define NID_aes_128_cbc_hmac_sha1 916 + +#define SN_aes_192_cbc_hmac_sha1 "AES-192-CBC-HMAC-SHA1" +#define LN_aes_192_cbc_hmac_sha1 "aes-192-cbc-hmac-sha1" +#define NID_aes_192_cbc_hmac_sha1 917 + +#define SN_aes_256_cbc_hmac_sha1 "AES-256-CBC-HMAC-SHA1" +#define LN_aes_256_cbc_hmac_sha1 "aes-256-cbc-hmac-sha1" +#define NID_aes_256_cbc_hmac_sha1 918 + +#define SN_aes_128_cbc_hmac_sha256 "AES-128-CBC-HMAC-SHA256" +#define LN_aes_128_cbc_hmac_sha256 "aes-128-cbc-hmac-sha256" +#define NID_aes_128_cbc_hmac_sha256 948 + +#define SN_aes_192_cbc_hmac_sha256 "AES-192-CBC-HMAC-SHA256" +#define LN_aes_192_cbc_hmac_sha256 "aes-192-cbc-hmac-sha256" +#define NID_aes_192_cbc_hmac_sha256 949 + +#define SN_aes_256_cbc_hmac_sha256 "AES-256-CBC-HMAC-SHA256" +#define LN_aes_256_cbc_hmac_sha256 "aes-256-cbc-hmac-sha256" +#define NID_aes_256_cbc_hmac_sha256 950 + +#define SN_chacha20_poly1305 "ChaCha20-Poly1305" +#define LN_chacha20_poly1305 "chacha20-poly1305" +#define NID_chacha20_poly1305 1018 + +#define SN_chacha20 "ChaCha20" +#define LN_chacha20 "chacha20" +#define NID_chacha20 1019 + +#define SN_dhpublicnumber "dhpublicnumber" +#define LN_dhpublicnumber "X9.42 DH" +#define NID_dhpublicnumber 920 +#define OBJ_dhpublicnumber OBJ_ISO_US,10046L,2L,1L + +#define SN_brainpoolP160r1 "brainpoolP160r1" +#define NID_brainpoolP160r1 921 +#define OBJ_brainpoolP160r1 1L,3L,36L,3L,3L,2L,8L,1L,1L,1L + +#define SN_brainpoolP160t1 "brainpoolP160t1" +#define NID_brainpoolP160t1 922 +#define OBJ_brainpoolP160t1 1L,3L,36L,3L,3L,2L,8L,1L,1L,2L + +#define SN_brainpoolP192r1 "brainpoolP192r1" +#define NID_brainpoolP192r1 923 +#define OBJ_brainpoolP192r1 1L,3L,36L,3L,3L,2L,8L,1L,1L,3L + +#define SN_brainpoolP192t1 "brainpoolP192t1" +#define NID_brainpoolP192t1 924 +#define OBJ_brainpoolP192t1 1L,3L,36L,3L,3L,2L,8L,1L,1L,4L + +#define SN_brainpoolP224r1 "brainpoolP224r1" +#define NID_brainpoolP224r1 925 +#define OBJ_brainpoolP224r1 1L,3L,36L,3L,3L,2L,8L,1L,1L,5L + +#define SN_brainpoolP224t1 "brainpoolP224t1" +#define NID_brainpoolP224t1 926 +#define OBJ_brainpoolP224t1 1L,3L,36L,3L,3L,2L,8L,1L,1L,6L + +#define SN_brainpoolP256r1 "brainpoolP256r1" +#define NID_brainpoolP256r1 927 +#define OBJ_brainpoolP256r1 1L,3L,36L,3L,3L,2L,8L,1L,1L,7L + +#define SN_brainpoolP256t1 "brainpoolP256t1" +#define NID_brainpoolP256t1 928 +#define OBJ_brainpoolP256t1 1L,3L,36L,3L,3L,2L,8L,1L,1L,8L + +#define SN_brainpoolP320r1 "brainpoolP320r1" +#define NID_brainpoolP320r1 929 +#define OBJ_brainpoolP320r1 1L,3L,36L,3L,3L,2L,8L,1L,1L,9L + +#define SN_brainpoolP320t1 "brainpoolP320t1" +#define NID_brainpoolP320t1 930 +#define OBJ_brainpoolP320t1 1L,3L,36L,3L,3L,2L,8L,1L,1L,10L + +#define SN_brainpoolP384r1 "brainpoolP384r1" +#define NID_brainpoolP384r1 931 +#define OBJ_brainpoolP384r1 1L,3L,36L,3L,3L,2L,8L,1L,1L,11L + +#define SN_brainpoolP384t1 "brainpoolP384t1" +#define NID_brainpoolP384t1 932 +#define OBJ_brainpoolP384t1 1L,3L,36L,3L,3L,2L,8L,1L,1L,12L + +#define SN_brainpoolP512r1 "brainpoolP512r1" +#define NID_brainpoolP512r1 933 +#define OBJ_brainpoolP512r1 1L,3L,36L,3L,3L,2L,8L,1L,1L,13L + +#define SN_brainpoolP512t1 "brainpoolP512t1" +#define NID_brainpoolP512t1 934 +#define OBJ_brainpoolP512t1 1L,3L,36L,3L,3L,2L,8L,1L,1L,14L + +#define OBJ_x9_63_scheme 1L,3L,133L,16L,840L,63L,0L + +#define OBJ_secg_scheme OBJ_certicom_arc,1L + +#define SN_dhSinglePass_stdDH_sha1kdf_scheme "dhSinglePass-stdDH-sha1kdf-scheme" +#define NID_dhSinglePass_stdDH_sha1kdf_scheme 936 +#define OBJ_dhSinglePass_stdDH_sha1kdf_scheme OBJ_x9_63_scheme,2L + +#define SN_dhSinglePass_stdDH_sha224kdf_scheme "dhSinglePass-stdDH-sha224kdf-scheme" +#define NID_dhSinglePass_stdDH_sha224kdf_scheme 937 +#define OBJ_dhSinglePass_stdDH_sha224kdf_scheme OBJ_secg_scheme,11L,0L + +#define SN_dhSinglePass_stdDH_sha256kdf_scheme "dhSinglePass-stdDH-sha256kdf-scheme" +#define NID_dhSinglePass_stdDH_sha256kdf_scheme 938 +#define OBJ_dhSinglePass_stdDH_sha256kdf_scheme OBJ_secg_scheme,11L,1L + +#define SN_dhSinglePass_stdDH_sha384kdf_scheme "dhSinglePass-stdDH-sha384kdf-scheme" +#define NID_dhSinglePass_stdDH_sha384kdf_scheme 939 +#define OBJ_dhSinglePass_stdDH_sha384kdf_scheme OBJ_secg_scheme,11L,2L + +#define SN_dhSinglePass_stdDH_sha512kdf_scheme "dhSinglePass-stdDH-sha512kdf-scheme" +#define NID_dhSinglePass_stdDH_sha512kdf_scheme 940 +#define OBJ_dhSinglePass_stdDH_sha512kdf_scheme OBJ_secg_scheme,11L,3L + +#define SN_dhSinglePass_cofactorDH_sha1kdf_scheme "dhSinglePass-cofactorDH-sha1kdf-scheme" +#define NID_dhSinglePass_cofactorDH_sha1kdf_scheme 941 +#define OBJ_dhSinglePass_cofactorDH_sha1kdf_scheme OBJ_x9_63_scheme,3L + +#define SN_dhSinglePass_cofactorDH_sha224kdf_scheme "dhSinglePass-cofactorDH-sha224kdf-scheme" +#define NID_dhSinglePass_cofactorDH_sha224kdf_scheme 942 +#define OBJ_dhSinglePass_cofactorDH_sha224kdf_scheme OBJ_secg_scheme,14L,0L + +#define SN_dhSinglePass_cofactorDH_sha256kdf_scheme "dhSinglePass-cofactorDH-sha256kdf-scheme" +#define NID_dhSinglePass_cofactorDH_sha256kdf_scheme 943 +#define OBJ_dhSinglePass_cofactorDH_sha256kdf_scheme OBJ_secg_scheme,14L,1L + +#define SN_dhSinglePass_cofactorDH_sha384kdf_scheme "dhSinglePass-cofactorDH-sha384kdf-scheme" +#define NID_dhSinglePass_cofactorDH_sha384kdf_scheme 944 +#define OBJ_dhSinglePass_cofactorDH_sha384kdf_scheme OBJ_secg_scheme,14L,2L + +#define SN_dhSinglePass_cofactorDH_sha512kdf_scheme "dhSinglePass-cofactorDH-sha512kdf-scheme" +#define NID_dhSinglePass_cofactorDH_sha512kdf_scheme 945 +#define OBJ_dhSinglePass_cofactorDH_sha512kdf_scheme OBJ_secg_scheme,14L,3L + +#define SN_dh_std_kdf "dh-std-kdf" +#define NID_dh_std_kdf 946 + +#define SN_dh_cofactor_kdf "dh-cofactor-kdf" +#define NID_dh_cofactor_kdf 947 + +#define SN_ct_precert_scts "ct_precert_scts" +#define LN_ct_precert_scts "CT Precertificate SCTs" +#define NID_ct_precert_scts 951 +#define OBJ_ct_precert_scts 1L,3L,6L,1L,4L,1L,11129L,2L,4L,2L + +#define SN_ct_precert_poison "ct_precert_poison" +#define LN_ct_precert_poison "CT Precertificate Poison" +#define NID_ct_precert_poison 952 +#define OBJ_ct_precert_poison 1L,3L,6L,1L,4L,1L,11129L,2L,4L,3L + +#define SN_ct_precert_signer "ct_precert_signer" +#define LN_ct_precert_signer "CT Precertificate Signer" +#define NID_ct_precert_signer 953 +#define OBJ_ct_precert_signer 1L,3L,6L,1L,4L,1L,11129L,2L,4L,4L + +#define SN_ct_cert_scts "ct_cert_scts" +#define LN_ct_cert_scts "CT Certificate SCTs" +#define NID_ct_cert_scts 954 +#define OBJ_ct_cert_scts 1L,3L,6L,1L,4L,1L,11129L,2L,4L,5L + +#define SN_jurisdictionLocalityName "jurisdictionL" +#define LN_jurisdictionLocalityName "jurisdictionLocalityName" +#define NID_jurisdictionLocalityName 955 +#define OBJ_jurisdictionLocalityName 1L,3L,6L,1L,4L,1L,311L,60L,2L,1L,1L + +#define SN_jurisdictionStateOrProvinceName "jurisdictionST" +#define LN_jurisdictionStateOrProvinceName "jurisdictionStateOrProvinceName" +#define NID_jurisdictionStateOrProvinceName 956 +#define OBJ_jurisdictionStateOrProvinceName 1L,3L,6L,1L,4L,1L,311L,60L,2L,1L,2L + +#define SN_jurisdictionCountryName "jurisdictionC" +#define LN_jurisdictionCountryName "jurisdictionCountryName" +#define NID_jurisdictionCountryName 957 +#define OBJ_jurisdictionCountryName 1L,3L,6L,1L,4L,1L,311L,60L,2L,1L,3L + +#define SN_id_scrypt "id-scrypt" +#define LN_id_scrypt "scrypt" +#define NID_id_scrypt 973 +#define OBJ_id_scrypt 1L,3L,6L,1L,4L,1L,11591L,4L,11L + +#define SN_tls1_prf "TLS1-PRF" +#define LN_tls1_prf "tls1-prf" +#define NID_tls1_prf 1021 + +#define SN_hkdf "HKDF" +#define LN_hkdf "hkdf" +#define NID_hkdf 1036 + +#define SN_id_pkinit "id-pkinit" +#define NID_id_pkinit 1031 +#define OBJ_id_pkinit 1L,3L,6L,1L,5L,2L,3L + +#define SN_pkInitClientAuth "pkInitClientAuth" +#define LN_pkInitClientAuth "PKINIT Client Auth" +#define NID_pkInitClientAuth 1032 +#define OBJ_pkInitClientAuth OBJ_id_pkinit,4L + +#define SN_pkInitKDC "pkInitKDC" +#define LN_pkInitKDC "Signing KDC Response" +#define NID_pkInitKDC 1033 +#define OBJ_pkInitKDC OBJ_id_pkinit,5L + +#define SN_X25519 "X25519" +#define NID_X25519 1034 +#define OBJ_X25519 1L,3L,101L,110L + +#define SN_X448 "X448" +#define NID_X448 1035 +#define OBJ_X448 1L,3L,101L,111L + +#define SN_ED25519 "ED25519" +#define NID_ED25519 1087 +#define OBJ_ED25519 1L,3L,101L,112L + +#define SN_ED448 "ED448" +#define NID_ED448 1088 +#define OBJ_ED448 1L,3L,101L,113L + +#define SN_kx_rsa "KxRSA" +#define LN_kx_rsa "kx-rsa" +#define NID_kx_rsa 1037 + +#define SN_kx_ecdhe "KxECDHE" +#define LN_kx_ecdhe "kx-ecdhe" +#define NID_kx_ecdhe 1038 + +#define SN_kx_dhe "KxDHE" +#define LN_kx_dhe "kx-dhe" +#define NID_kx_dhe 1039 + +#define SN_kx_ecdhe_psk "KxECDHE-PSK" +#define LN_kx_ecdhe_psk "kx-ecdhe-psk" +#define NID_kx_ecdhe_psk 1040 + +#define SN_kx_dhe_psk "KxDHE-PSK" +#define LN_kx_dhe_psk "kx-dhe-psk" +#define NID_kx_dhe_psk 1041 + +#define SN_kx_rsa_psk "KxRSA_PSK" +#define LN_kx_rsa_psk "kx-rsa-psk" +#define NID_kx_rsa_psk 1042 + +#define SN_kx_psk "KxPSK" +#define LN_kx_psk "kx-psk" +#define NID_kx_psk 1043 + +#define SN_kx_srp "KxSRP" +#define LN_kx_srp "kx-srp" +#define NID_kx_srp 1044 + +#define SN_kx_gost "KxGOST" +#define LN_kx_gost "kx-gost" +#define NID_kx_gost 1045 + +#define SN_kx_any "KxANY" +#define LN_kx_any "kx-any" +#define NID_kx_any 1063 + +#define SN_auth_rsa "AuthRSA" +#define LN_auth_rsa "auth-rsa" +#define NID_auth_rsa 1046 + +#define SN_auth_ecdsa "AuthECDSA" +#define LN_auth_ecdsa "auth-ecdsa" +#define NID_auth_ecdsa 1047 + +#define SN_auth_psk "AuthPSK" +#define LN_auth_psk "auth-psk" +#define NID_auth_psk 1048 + +#define SN_auth_dss "AuthDSS" +#define LN_auth_dss "auth-dss" +#define NID_auth_dss 1049 + +#define SN_auth_gost01 "AuthGOST01" +#define LN_auth_gost01 "auth-gost01" +#define NID_auth_gost01 1050 + +#define SN_auth_gost12 "AuthGOST12" +#define LN_auth_gost12 "auth-gost12" +#define NID_auth_gost12 1051 + +#define SN_auth_srp "AuthSRP" +#define LN_auth_srp "auth-srp" +#define NID_auth_srp 1052 + +#define SN_auth_null "AuthNULL" +#define LN_auth_null "auth-null" +#define NID_auth_null 1053 + +#define SN_auth_any "AuthANY" +#define LN_auth_any "auth-any" +#define NID_auth_any 1064 + +#define SN_poly1305 "Poly1305" +#define LN_poly1305 "poly1305" +#define NID_poly1305 1061 + +#define SN_siphash "SipHash" +#define LN_siphash "siphash" +#define NID_siphash 1062 + +#define SN_ffdhe2048 "ffdhe2048" +#define NID_ffdhe2048 1126 + +#define SN_ffdhe3072 "ffdhe3072" +#define NID_ffdhe3072 1127 + +#define SN_ffdhe4096 "ffdhe4096" +#define NID_ffdhe4096 1128 + +#define SN_ffdhe6144 "ffdhe6144" +#define NID_ffdhe6144 1129 + +#define SN_ffdhe8192 "ffdhe8192" +#define NID_ffdhe8192 1130 + +#define SN_ISO_UA "ISO-UA" +#define NID_ISO_UA 1150 +#define OBJ_ISO_UA OBJ_member_body,804L + +#define SN_ua_pki "ua-pki" +#define NID_ua_pki 1151 +#define OBJ_ua_pki OBJ_ISO_UA,2L,1L,1L,1L + +#define SN_dstu28147 "dstu28147" +#define LN_dstu28147 "DSTU Gost 28147-2009" +#define NID_dstu28147 1152 +#define OBJ_dstu28147 OBJ_ua_pki,1L,1L,1L + +#define SN_dstu28147_ofb "dstu28147-ofb" +#define LN_dstu28147_ofb "DSTU Gost 28147-2009 OFB mode" +#define NID_dstu28147_ofb 1153 +#define OBJ_dstu28147_ofb OBJ_dstu28147,2L + +#define SN_dstu28147_cfb "dstu28147-cfb" +#define LN_dstu28147_cfb "DSTU Gost 28147-2009 CFB mode" +#define NID_dstu28147_cfb 1154 +#define OBJ_dstu28147_cfb OBJ_dstu28147,3L + +#define SN_dstu28147_wrap "dstu28147-wrap" +#define LN_dstu28147_wrap "DSTU Gost 28147-2009 key wrap" +#define NID_dstu28147_wrap 1155 +#define OBJ_dstu28147_wrap OBJ_dstu28147,5L + +#define SN_hmacWithDstu34311 "hmacWithDstu34311" +#define LN_hmacWithDstu34311 "HMAC DSTU Gost 34311-95" +#define NID_hmacWithDstu34311 1156 +#define OBJ_hmacWithDstu34311 OBJ_ua_pki,1L,1L,2L + +#define SN_dstu34311 "dstu34311" +#define LN_dstu34311 "DSTU Gost 34311-95" +#define NID_dstu34311 1157 +#define OBJ_dstu34311 OBJ_ua_pki,1L,2L,1L + +#define SN_dstu4145le "dstu4145le" +#define LN_dstu4145le "DSTU 4145-2002 little endian" +#define NID_dstu4145le 1158 +#define OBJ_dstu4145le OBJ_ua_pki,1L,3L,1L,1L + +#define SN_dstu4145be "dstu4145be" +#define LN_dstu4145be "DSTU 4145-2002 big endian" +#define NID_dstu4145be 1159 +#define OBJ_dstu4145be OBJ_dstu4145le,1L,1L + +#define SN_uacurve0 "uacurve0" +#define LN_uacurve0 "DSTU curve 0" +#define NID_uacurve0 1160 +#define OBJ_uacurve0 OBJ_dstu4145le,2L,0L + +#define SN_uacurve1 "uacurve1" +#define LN_uacurve1 "DSTU curve 1" +#define NID_uacurve1 1161 +#define OBJ_uacurve1 OBJ_dstu4145le,2L,1L + +#define SN_uacurve2 "uacurve2" +#define LN_uacurve2 "DSTU curve 2" +#define NID_uacurve2 1162 +#define OBJ_uacurve2 OBJ_dstu4145le,2L,2L + +#define SN_uacurve3 "uacurve3" +#define LN_uacurve3 "DSTU curve 3" +#define NID_uacurve3 1163 +#define OBJ_uacurve3 OBJ_dstu4145le,2L,3L + +#define SN_uacurve4 "uacurve4" +#define LN_uacurve4 "DSTU curve 4" +#define NID_uacurve4 1164 +#define OBJ_uacurve4 OBJ_dstu4145le,2L,4L + +#define SN_uacurve5 "uacurve5" +#define LN_uacurve5 "DSTU curve 5" +#define NID_uacurve5 1165 +#define OBJ_uacurve5 OBJ_dstu4145le,2L,5L + +#define SN_uacurve6 "uacurve6" +#define LN_uacurve6 "DSTU curve 6" +#define NID_uacurve6 1166 +#define OBJ_uacurve6 OBJ_dstu4145le,2L,6L + +#define SN_uacurve7 "uacurve7" +#define LN_uacurve7 "DSTU curve 7" +#define NID_uacurve7 1167 +#define OBJ_uacurve7 OBJ_dstu4145le,2L,7L + +#define SN_uacurve8 "uacurve8" +#define LN_uacurve8 "DSTU curve 8" +#define NID_uacurve8 1168 +#define OBJ_uacurve8 OBJ_dstu4145le,2L,8L + +#define SN_uacurve9 "uacurve9" +#define LN_uacurve9 "DSTU curve 9" +#define NID_uacurve9 1169 +#define OBJ_uacurve9 OBJ_dstu4145le,2L,9L diff --git a/include/openssl/objects.h b/include/openssl/objects.h new file mode 100644 index 0000000..29004e2 --- /dev/null +++ b/include/openssl/objects.h @@ -0,0 +1,175 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OBJECTS_H +# define HEADER_OBJECTS_H + +# include +# include +# include +# include + +# define OBJ_NAME_TYPE_UNDEF 0x00 +# define OBJ_NAME_TYPE_MD_METH 0x01 +# define OBJ_NAME_TYPE_CIPHER_METH 0x02 +# define OBJ_NAME_TYPE_PKEY_METH 0x03 +# define OBJ_NAME_TYPE_COMP_METH 0x04 +# define OBJ_NAME_TYPE_NUM 0x05 + +# define OBJ_NAME_ALIAS 0x8000 + +# define OBJ_BSEARCH_VALUE_ON_NOMATCH 0x01 +# define OBJ_BSEARCH_FIRST_VALUE_ON_MATCH 0x02 + + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct obj_name_st { + int type; + int alias; + const char *name; + const char *data; +} OBJ_NAME; + +# define OBJ_create_and_add_object(a,b,c) OBJ_create(a,b,c) + +int OBJ_NAME_init(void); +int OBJ_NAME_new_index(unsigned long (*hash_func) (const char *), + int (*cmp_func) (const char *, const char *), + void (*free_func) (const char *, int, const char *)); +const char *OBJ_NAME_get(const char *name, int type); +int OBJ_NAME_add(const char *name, int type, const char *data); +int OBJ_NAME_remove(const char *name, int type); +void OBJ_NAME_cleanup(int type); /* -1 for everything */ +void OBJ_NAME_do_all(int type, void (*fn) (const OBJ_NAME *, void *arg), + void *arg); +void OBJ_NAME_do_all_sorted(int type, + void (*fn) (const OBJ_NAME *, void *arg), + void *arg); + +ASN1_OBJECT *OBJ_dup(const ASN1_OBJECT *o); +ASN1_OBJECT *OBJ_nid2obj(int n); +const char *OBJ_nid2ln(int n); +const char *OBJ_nid2sn(int n); +int OBJ_obj2nid(const ASN1_OBJECT *o); +ASN1_OBJECT *OBJ_txt2obj(const char *s, int no_name); +int OBJ_obj2txt(char *buf, int buf_len, const ASN1_OBJECT *a, int no_name); +int OBJ_txt2nid(const char *s); +int OBJ_ln2nid(const char *s); +int OBJ_sn2nid(const char *s); +int OBJ_cmp(const ASN1_OBJECT *a, const ASN1_OBJECT *b); +const void *OBJ_bsearch_(const void *key, const void *base, int num, int size, + int (*cmp) (const void *, const void *)); +const void *OBJ_bsearch_ex_(const void *key, const void *base, int num, + int size, + int (*cmp) (const void *, const void *), + int flags); + +# define _DECLARE_OBJ_BSEARCH_CMP_FN(scope, type1, type2, nm) \ + static int nm##_cmp_BSEARCH_CMP_FN(const void *, const void *); \ + static int nm##_cmp(type1 const *, type2 const *); \ + scope type2 * OBJ_bsearch_##nm(type1 *key, type2 const *base, int num) + +# define DECLARE_OBJ_BSEARCH_CMP_FN(type1, type2, cmp) \ + _DECLARE_OBJ_BSEARCH_CMP_FN(static, type1, type2, cmp) +# define DECLARE_OBJ_BSEARCH_GLOBAL_CMP_FN(type1, type2, nm) \ + type2 * OBJ_bsearch_##nm(type1 *key, type2 const *base, int num) + +/*- + * Unsolved problem: if a type is actually a pointer type, like + * nid_triple is, then its impossible to get a const where you need + * it. Consider: + * + * typedef int nid_triple[3]; + * const void *a_; + * const nid_triple const *a = a_; + * + * The assignment discards a const because what you really want is: + * + * const int const * const *a = a_; + * + * But if you do that, you lose the fact that a is an array of 3 ints, + * which breaks comparison functions. + * + * Thus we end up having to cast, sadly, or unpack the + * declarations. Or, as I finally did in this case, declare nid_triple + * to be a struct, which it should have been in the first place. + * + * Ben, August 2008. + * + * Also, strictly speaking not all types need be const, but handling + * the non-constness means a lot of complication, and in practice + * comparison routines do always not touch their arguments. + */ + +# define IMPLEMENT_OBJ_BSEARCH_CMP_FN(type1, type2, nm) \ + static int nm##_cmp_BSEARCH_CMP_FN(const void *a_, const void *b_) \ + { \ + type1 const *a = a_; \ + type2 const *b = b_; \ + return nm##_cmp(a,b); \ + } \ + static type2 *OBJ_bsearch_##nm(type1 *key, type2 const *base, int num) \ + { \ + return (type2 *)OBJ_bsearch_(key, base, num, sizeof(type2), \ + nm##_cmp_BSEARCH_CMP_FN); \ + } \ + extern void dummy_prototype(void) + +# define IMPLEMENT_OBJ_BSEARCH_GLOBAL_CMP_FN(type1, type2, nm) \ + static int nm##_cmp_BSEARCH_CMP_FN(const void *a_, const void *b_) \ + { \ + type1 const *a = a_; \ + type2 const *b = b_; \ + return nm##_cmp(a,b); \ + } \ + type2 *OBJ_bsearch_##nm(type1 *key, type2 const *base, int num) \ + { \ + return (type2 *)OBJ_bsearch_(key, base, num, sizeof(type2), \ + nm##_cmp_BSEARCH_CMP_FN); \ + } \ + extern void dummy_prototype(void) + +# define OBJ_bsearch(type1,key,type2,base,num,cmp) \ + ((type2 *)OBJ_bsearch_(CHECKED_PTR_OF(type1,key),CHECKED_PTR_OF(type2,base), \ + num,sizeof(type2), \ + ((void)CHECKED_PTR_OF(type1,cmp##_type_1), \ + (void)CHECKED_PTR_OF(type2,cmp##_type_2), \ + cmp##_BSEARCH_CMP_FN))) + +# define OBJ_bsearch_ex(type1,key,type2,base,num,cmp,flags) \ + ((type2 *)OBJ_bsearch_ex_(CHECKED_PTR_OF(type1,key),CHECKED_PTR_OF(type2,base), \ + num,sizeof(type2), \ + ((void)CHECKED_PTR_OF(type1,cmp##_type_1), \ + (void)type_2=CHECKED_PTR_OF(type2,cmp##_type_2), \ + cmp##_BSEARCH_CMP_FN)),flags) + +int OBJ_new_nid(int num); +int OBJ_add_object(const ASN1_OBJECT *obj); +int OBJ_create(const char *oid, const char *sn, const char *ln); +#if OPENSSL_API_COMPAT < 0x10100000L +# define OBJ_cleanup() while(0) continue +#endif +int OBJ_create_objects(BIO *in); + +size_t OBJ_length(const ASN1_OBJECT *obj); +const unsigned char *OBJ_get0_data(const ASN1_OBJECT *obj); + +int OBJ_find_sigid_algs(int signid, int *pdig_nid, int *ppkey_nid); +int OBJ_find_sigid_by_algs(int *psignid, int dig_nid, int pkey_nid); +int OBJ_add_sigid(int signid, int dig_id, int pkey_id); +void OBJ_sigid_free(void); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/objectserr.h b/include/openssl/objectserr.h new file mode 100644 index 0000000..02308df --- /dev/null +++ b/include/openssl/objectserr.h @@ -0,0 +1,38 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OBJERR_H +# define HEADER_OBJERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_OBJ_strings(void); + +/* + * OBJ function codes. + */ +# define OBJ_F_OBJ_ADD_OBJECT 105 +# define OBJ_F_OBJ_ADD_SIGID 107 +# define OBJ_F_OBJ_CREATE 100 +# define OBJ_F_OBJ_DUP 101 +# define OBJ_F_OBJ_NAME_NEW_INDEX 106 +# define OBJ_F_OBJ_NID2LN 102 +# define OBJ_F_OBJ_NID2OBJ 103 +# define OBJ_F_OBJ_NID2SN 104 +# define OBJ_F_OBJ_TXT2OBJ 108 + +/* + * OBJ reason codes. + */ +# define OBJ_R_OID_EXISTS 102 +# define OBJ_R_UNKNOWN_NID 101 + +#endif diff --git a/include/openssl/ocsp.h b/include/openssl/ocsp.h new file mode 100644 index 0000000..5a1d75e --- /dev/null +++ b/include/openssl/ocsp.h @@ -0,0 +1,355 @@ +/* + * Copyright 2000-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OCSP_H +# define HEADER_OCSP_H + +#include + +/* + * These definitions are outside the OPENSSL_NO_OCSP guard because although for + * historical reasons they have OCSP_* names, they can actually be used + * independently of OCSP. E.g. see RFC5280 + */ +/*- + * CRLReason ::= ENUMERATED { + * unspecified (0), + * keyCompromise (1), + * cACompromise (2), + * affiliationChanged (3), + * superseded (4), + * cessationOfOperation (5), + * certificateHold (6), + * removeFromCRL (8) } + */ +# define OCSP_REVOKED_STATUS_NOSTATUS -1 +# define OCSP_REVOKED_STATUS_UNSPECIFIED 0 +# define OCSP_REVOKED_STATUS_KEYCOMPROMISE 1 +# define OCSP_REVOKED_STATUS_CACOMPROMISE 2 +# define OCSP_REVOKED_STATUS_AFFILIATIONCHANGED 3 +# define OCSP_REVOKED_STATUS_SUPERSEDED 4 +# define OCSP_REVOKED_STATUS_CESSATIONOFOPERATION 5 +# define OCSP_REVOKED_STATUS_CERTIFICATEHOLD 6 +# define OCSP_REVOKED_STATUS_REMOVEFROMCRL 8 + + +# ifndef OPENSSL_NO_OCSP + +# include +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* Various flags and values */ + +# define OCSP_DEFAULT_NONCE_LENGTH 16 + +# define OCSP_NOCERTS 0x1 +# define OCSP_NOINTERN 0x2 +# define OCSP_NOSIGS 0x4 +# define OCSP_NOCHAIN 0x8 +# define OCSP_NOVERIFY 0x10 +# define OCSP_NOEXPLICIT 0x20 +# define OCSP_NOCASIGN 0x40 +# define OCSP_NODELEGATED 0x80 +# define OCSP_NOCHECKS 0x100 +# define OCSP_TRUSTOTHER 0x200 +# define OCSP_RESPID_KEY 0x400 +# define OCSP_NOTIME 0x800 + +typedef struct ocsp_cert_id_st OCSP_CERTID; + +DEFINE_STACK_OF(OCSP_CERTID) + +typedef struct ocsp_one_request_st OCSP_ONEREQ; + +DEFINE_STACK_OF(OCSP_ONEREQ) + +typedef struct ocsp_req_info_st OCSP_REQINFO; +typedef struct ocsp_signature_st OCSP_SIGNATURE; +typedef struct ocsp_request_st OCSP_REQUEST; + +# define OCSP_RESPONSE_STATUS_SUCCESSFUL 0 +# define OCSP_RESPONSE_STATUS_MALFORMEDREQUEST 1 +# define OCSP_RESPONSE_STATUS_INTERNALERROR 2 +# define OCSP_RESPONSE_STATUS_TRYLATER 3 +# define OCSP_RESPONSE_STATUS_SIGREQUIRED 5 +# define OCSP_RESPONSE_STATUS_UNAUTHORIZED 6 + +typedef struct ocsp_resp_bytes_st OCSP_RESPBYTES; + +# define V_OCSP_RESPID_NAME 0 +# define V_OCSP_RESPID_KEY 1 + +DEFINE_STACK_OF(OCSP_RESPID) +DECLARE_ASN1_FUNCTIONS(OCSP_RESPID) + +typedef struct ocsp_revoked_info_st OCSP_REVOKEDINFO; + +# define V_OCSP_CERTSTATUS_GOOD 0 +# define V_OCSP_CERTSTATUS_REVOKED 1 +# define V_OCSP_CERTSTATUS_UNKNOWN 2 + +typedef struct ocsp_cert_status_st OCSP_CERTSTATUS; +typedef struct ocsp_single_response_st OCSP_SINGLERESP; + +DEFINE_STACK_OF(OCSP_SINGLERESP) + +typedef struct ocsp_response_data_st OCSP_RESPDATA; + +typedef struct ocsp_basic_response_st OCSP_BASICRESP; + +typedef struct ocsp_crl_id_st OCSP_CRLID; +typedef struct ocsp_service_locator_st OCSP_SERVICELOC; + +# define PEM_STRING_OCSP_REQUEST "OCSP REQUEST" +# define PEM_STRING_OCSP_RESPONSE "OCSP RESPONSE" + +# define d2i_OCSP_REQUEST_bio(bp,p) ASN1_d2i_bio_of(OCSP_REQUEST,OCSP_REQUEST_new,d2i_OCSP_REQUEST,bp,p) + +# define d2i_OCSP_RESPONSE_bio(bp,p) ASN1_d2i_bio_of(OCSP_RESPONSE,OCSP_RESPONSE_new,d2i_OCSP_RESPONSE,bp,p) + +# define PEM_read_bio_OCSP_REQUEST(bp,x,cb) (OCSP_REQUEST *)PEM_ASN1_read_bio( \ + (char *(*)())d2i_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST, \ + bp,(char **)(x),cb,NULL) + +# define PEM_read_bio_OCSP_RESPONSE(bp,x,cb)(OCSP_RESPONSE *)PEM_ASN1_read_bio(\ + (char *(*)())d2i_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE, \ + bp,(char **)(x),cb,NULL) + +# define PEM_write_bio_OCSP_REQUEST(bp,o) \ + PEM_ASN1_write_bio((int (*)())i2d_OCSP_REQUEST,PEM_STRING_OCSP_REQUEST,\ + bp,(char *)(o), NULL,NULL,0,NULL,NULL) + +# define PEM_write_bio_OCSP_RESPONSE(bp,o) \ + PEM_ASN1_write_bio((int (*)())i2d_OCSP_RESPONSE,PEM_STRING_OCSP_RESPONSE,\ + bp,(char *)(o), NULL,NULL,0,NULL,NULL) + +# define i2d_OCSP_RESPONSE_bio(bp,o) ASN1_i2d_bio_of(OCSP_RESPONSE,i2d_OCSP_RESPONSE,bp,o) + +# define i2d_OCSP_REQUEST_bio(bp,o) ASN1_i2d_bio_of(OCSP_REQUEST,i2d_OCSP_REQUEST,bp,o) + +# define ASN1_BIT_STRING_digest(data,type,md,len) \ + ASN1_item_digest(ASN1_ITEM_rptr(ASN1_BIT_STRING),type,data,md,len) + +# define OCSP_CERTSTATUS_dup(cs)\ + (OCSP_CERTSTATUS*)ASN1_dup((int(*)())i2d_OCSP_CERTSTATUS,\ + (char *(*)())d2i_OCSP_CERTSTATUS,(char *)(cs)) + +OCSP_CERTID *OCSP_CERTID_dup(OCSP_CERTID *id); + +OCSP_RESPONSE *OCSP_sendreq_bio(BIO *b, const char *path, OCSP_REQUEST *req); +OCSP_REQ_CTX *OCSP_sendreq_new(BIO *io, const char *path, OCSP_REQUEST *req, + int maxline); +int OCSP_REQ_CTX_nbio(OCSP_REQ_CTX *rctx); +int OCSP_sendreq_nbio(OCSP_RESPONSE **presp, OCSP_REQ_CTX *rctx); +OCSP_REQ_CTX *OCSP_REQ_CTX_new(BIO *io, int maxline); +void OCSP_REQ_CTX_free(OCSP_REQ_CTX *rctx); +void OCSP_set_max_response_length(OCSP_REQ_CTX *rctx, unsigned long len); +int OCSP_REQ_CTX_i2d(OCSP_REQ_CTX *rctx, const ASN1_ITEM *it, + ASN1_VALUE *val); +int OCSP_REQ_CTX_nbio_d2i(OCSP_REQ_CTX *rctx, ASN1_VALUE **pval, + const ASN1_ITEM *it); +BIO *OCSP_REQ_CTX_get0_mem_bio(OCSP_REQ_CTX *rctx); +int OCSP_REQ_CTX_i2d(OCSP_REQ_CTX *rctx, const ASN1_ITEM *it, + ASN1_VALUE *val); +int OCSP_REQ_CTX_http(OCSP_REQ_CTX *rctx, const char *op, const char *path); +int OCSP_REQ_CTX_set1_req(OCSP_REQ_CTX *rctx, OCSP_REQUEST *req); +int OCSP_REQ_CTX_add1_header(OCSP_REQ_CTX *rctx, + const char *name, const char *value); + +OCSP_CERTID *OCSP_cert_to_id(const EVP_MD *dgst, const X509 *subject, + const X509 *issuer); + +OCSP_CERTID *OCSP_cert_id_new(const EVP_MD *dgst, + const X509_NAME *issuerName, + const ASN1_BIT_STRING *issuerKey, + const ASN1_INTEGER *serialNumber); + +OCSP_ONEREQ *OCSP_request_add0_id(OCSP_REQUEST *req, OCSP_CERTID *cid); + +int OCSP_request_add1_nonce(OCSP_REQUEST *req, unsigned char *val, int len); +int OCSP_basic_add1_nonce(OCSP_BASICRESP *resp, unsigned char *val, int len); +int OCSP_check_nonce(OCSP_REQUEST *req, OCSP_BASICRESP *bs); +int OCSP_copy_nonce(OCSP_BASICRESP *resp, OCSP_REQUEST *req); + +int OCSP_request_set1_name(OCSP_REQUEST *req, X509_NAME *nm); +int OCSP_request_add1_cert(OCSP_REQUEST *req, X509 *cert); + +int OCSP_request_sign(OCSP_REQUEST *req, + X509 *signer, + EVP_PKEY *key, + const EVP_MD *dgst, + STACK_OF(X509) *certs, unsigned long flags); + +int OCSP_response_status(OCSP_RESPONSE *resp); +OCSP_BASICRESP *OCSP_response_get1_basic(OCSP_RESPONSE *resp); + +const ASN1_OCTET_STRING *OCSP_resp_get0_signature(const OCSP_BASICRESP *bs); +const X509_ALGOR *OCSP_resp_get0_tbs_sigalg(const OCSP_BASICRESP *bs); +const OCSP_RESPDATA *OCSP_resp_get0_respdata(const OCSP_BASICRESP *bs); +int OCSP_resp_get0_signer(OCSP_BASICRESP *bs, X509 **signer, + STACK_OF(X509) *extra_certs); + +int OCSP_resp_count(OCSP_BASICRESP *bs); +OCSP_SINGLERESP *OCSP_resp_get0(OCSP_BASICRESP *bs, int idx); +const ASN1_GENERALIZEDTIME *OCSP_resp_get0_produced_at(const OCSP_BASICRESP* bs); +const STACK_OF(X509) *OCSP_resp_get0_certs(const OCSP_BASICRESP *bs); +int OCSP_resp_get0_id(const OCSP_BASICRESP *bs, + const ASN1_OCTET_STRING **pid, + const X509_NAME **pname); +int OCSP_resp_get1_id(const OCSP_BASICRESP *bs, + ASN1_OCTET_STRING **pid, + X509_NAME **pname); + +int OCSP_resp_find(OCSP_BASICRESP *bs, OCSP_CERTID *id, int last); +int OCSP_single_get0_status(OCSP_SINGLERESP *single, int *reason, + ASN1_GENERALIZEDTIME **revtime, + ASN1_GENERALIZEDTIME **thisupd, + ASN1_GENERALIZEDTIME **nextupd); +int OCSP_resp_find_status(OCSP_BASICRESP *bs, OCSP_CERTID *id, int *status, + int *reason, + ASN1_GENERALIZEDTIME **revtime, + ASN1_GENERALIZEDTIME **thisupd, + ASN1_GENERALIZEDTIME **nextupd); +int OCSP_check_validity(ASN1_GENERALIZEDTIME *thisupd, + ASN1_GENERALIZEDTIME *nextupd, long sec, long maxsec); + +int OCSP_request_verify(OCSP_REQUEST *req, STACK_OF(X509) *certs, + X509_STORE *store, unsigned long flags); + +int OCSP_parse_url(const char *url, char **phost, char **pport, char **ppath, + int *pssl); + +int OCSP_id_issuer_cmp(OCSP_CERTID *a, OCSP_CERTID *b); +int OCSP_id_cmp(OCSP_CERTID *a, OCSP_CERTID *b); + +int OCSP_request_onereq_count(OCSP_REQUEST *req); +OCSP_ONEREQ *OCSP_request_onereq_get0(OCSP_REQUEST *req, int i); +OCSP_CERTID *OCSP_onereq_get0_id(OCSP_ONEREQ *one); +int OCSP_id_get0_info(ASN1_OCTET_STRING **piNameHash, ASN1_OBJECT **pmd, + ASN1_OCTET_STRING **pikeyHash, + ASN1_INTEGER **pserial, OCSP_CERTID *cid); +int OCSP_request_is_signed(OCSP_REQUEST *req); +OCSP_RESPONSE *OCSP_response_create(int status, OCSP_BASICRESP *bs); +OCSP_SINGLERESP *OCSP_basic_add1_status(OCSP_BASICRESP *rsp, + OCSP_CERTID *cid, + int status, int reason, + ASN1_TIME *revtime, + ASN1_TIME *thisupd, + ASN1_TIME *nextupd); +int OCSP_basic_add1_cert(OCSP_BASICRESP *resp, X509 *cert); +int OCSP_basic_sign(OCSP_BASICRESP *brsp, + X509 *signer, EVP_PKEY *key, const EVP_MD *dgst, + STACK_OF(X509) *certs, unsigned long flags); +int OCSP_basic_sign_ctx(OCSP_BASICRESP *brsp, + X509 *signer, EVP_MD_CTX *ctx, + STACK_OF(X509) *certs, unsigned long flags); +int OCSP_RESPID_set_by_name(OCSP_RESPID *respid, X509 *cert); +int OCSP_RESPID_set_by_key(OCSP_RESPID *respid, X509 *cert); +int OCSP_RESPID_match(OCSP_RESPID *respid, X509 *cert); + +X509_EXTENSION *OCSP_crlID_new(const char *url, long *n, char *tim); + +X509_EXTENSION *OCSP_accept_responses_new(char **oids); + +X509_EXTENSION *OCSP_archive_cutoff_new(char *tim); + +X509_EXTENSION *OCSP_url_svcloc_new(X509_NAME *issuer, const char **urls); + +int OCSP_REQUEST_get_ext_count(OCSP_REQUEST *x); +int OCSP_REQUEST_get_ext_by_NID(OCSP_REQUEST *x, int nid, int lastpos); +int OCSP_REQUEST_get_ext_by_OBJ(OCSP_REQUEST *x, const ASN1_OBJECT *obj, + int lastpos); +int OCSP_REQUEST_get_ext_by_critical(OCSP_REQUEST *x, int crit, int lastpos); +X509_EXTENSION *OCSP_REQUEST_get_ext(OCSP_REQUEST *x, int loc); +X509_EXTENSION *OCSP_REQUEST_delete_ext(OCSP_REQUEST *x, int loc); +void *OCSP_REQUEST_get1_ext_d2i(OCSP_REQUEST *x, int nid, int *crit, + int *idx); +int OCSP_REQUEST_add1_ext_i2d(OCSP_REQUEST *x, int nid, void *value, int crit, + unsigned long flags); +int OCSP_REQUEST_add_ext(OCSP_REQUEST *x, X509_EXTENSION *ex, int loc); + +int OCSP_ONEREQ_get_ext_count(OCSP_ONEREQ *x); +int OCSP_ONEREQ_get_ext_by_NID(OCSP_ONEREQ *x, int nid, int lastpos); +int OCSP_ONEREQ_get_ext_by_OBJ(OCSP_ONEREQ *x, const ASN1_OBJECT *obj, int lastpos); +int OCSP_ONEREQ_get_ext_by_critical(OCSP_ONEREQ *x, int crit, int lastpos); +X509_EXTENSION *OCSP_ONEREQ_get_ext(OCSP_ONEREQ *x, int loc); +X509_EXTENSION *OCSP_ONEREQ_delete_ext(OCSP_ONEREQ *x, int loc); +void *OCSP_ONEREQ_get1_ext_d2i(OCSP_ONEREQ *x, int nid, int *crit, int *idx); +int OCSP_ONEREQ_add1_ext_i2d(OCSP_ONEREQ *x, int nid, void *value, int crit, + unsigned long flags); +int OCSP_ONEREQ_add_ext(OCSP_ONEREQ *x, X509_EXTENSION *ex, int loc); + +int OCSP_BASICRESP_get_ext_count(OCSP_BASICRESP *x); +int OCSP_BASICRESP_get_ext_by_NID(OCSP_BASICRESP *x, int nid, int lastpos); +int OCSP_BASICRESP_get_ext_by_OBJ(OCSP_BASICRESP *x, const ASN1_OBJECT *obj, + int lastpos); +int OCSP_BASICRESP_get_ext_by_critical(OCSP_BASICRESP *x, int crit, + int lastpos); +X509_EXTENSION *OCSP_BASICRESP_get_ext(OCSP_BASICRESP *x, int loc); +X509_EXTENSION *OCSP_BASICRESP_delete_ext(OCSP_BASICRESP *x, int loc); +void *OCSP_BASICRESP_get1_ext_d2i(OCSP_BASICRESP *x, int nid, int *crit, + int *idx); +int OCSP_BASICRESP_add1_ext_i2d(OCSP_BASICRESP *x, int nid, void *value, + int crit, unsigned long flags); +int OCSP_BASICRESP_add_ext(OCSP_BASICRESP *x, X509_EXTENSION *ex, int loc); + +int OCSP_SINGLERESP_get_ext_count(OCSP_SINGLERESP *x); +int OCSP_SINGLERESP_get_ext_by_NID(OCSP_SINGLERESP *x, int nid, int lastpos); +int OCSP_SINGLERESP_get_ext_by_OBJ(OCSP_SINGLERESP *x, const ASN1_OBJECT *obj, + int lastpos); +int OCSP_SINGLERESP_get_ext_by_critical(OCSP_SINGLERESP *x, int crit, + int lastpos); +X509_EXTENSION *OCSP_SINGLERESP_get_ext(OCSP_SINGLERESP *x, int loc); +X509_EXTENSION *OCSP_SINGLERESP_delete_ext(OCSP_SINGLERESP *x, int loc); +void *OCSP_SINGLERESP_get1_ext_d2i(OCSP_SINGLERESP *x, int nid, int *crit, + int *idx); +int OCSP_SINGLERESP_add1_ext_i2d(OCSP_SINGLERESP *x, int nid, void *value, + int crit, unsigned long flags); +int OCSP_SINGLERESP_add_ext(OCSP_SINGLERESP *x, X509_EXTENSION *ex, int loc); +const OCSP_CERTID *OCSP_SINGLERESP_get0_id(const OCSP_SINGLERESP *x); + +DECLARE_ASN1_FUNCTIONS(OCSP_SINGLERESP) +DECLARE_ASN1_FUNCTIONS(OCSP_CERTSTATUS) +DECLARE_ASN1_FUNCTIONS(OCSP_REVOKEDINFO) +DECLARE_ASN1_FUNCTIONS(OCSP_BASICRESP) +DECLARE_ASN1_FUNCTIONS(OCSP_RESPDATA) +DECLARE_ASN1_FUNCTIONS(OCSP_RESPID) +DECLARE_ASN1_FUNCTIONS(OCSP_RESPONSE) +DECLARE_ASN1_FUNCTIONS(OCSP_RESPBYTES) +DECLARE_ASN1_FUNCTIONS(OCSP_ONEREQ) +DECLARE_ASN1_FUNCTIONS(OCSP_CERTID) +DECLARE_ASN1_FUNCTIONS(OCSP_REQUEST) +DECLARE_ASN1_FUNCTIONS(OCSP_SIGNATURE) +DECLARE_ASN1_FUNCTIONS(OCSP_REQINFO) +DECLARE_ASN1_FUNCTIONS(OCSP_CRLID) +DECLARE_ASN1_FUNCTIONS(OCSP_SERVICELOC) + +const char *OCSP_response_status_str(long s); +const char *OCSP_cert_status_str(long s); +const char *OCSP_crl_reason_str(long s); + +int OCSP_REQUEST_print(BIO *bp, OCSP_REQUEST *a, unsigned long flags); +int OCSP_RESPONSE_print(BIO *bp, OCSP_RESPONSE *o, unsigned long flags); + +int OCSP_basic_verify(OCSP_BASICRESP *bs, STACK_OF(X509) *certs, + X509_STORE *st, unsigned long flags); + + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/ocsperr.h b/include/openssl/ocsperr.h new file mode 100644 index 0000000..d081fd5 --- /dev/null +++ b/include/openssl/ocsperr.h @@ -0,0 +1,74 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OCSPERR_H +# define HEADER_OCSPERR_H + +# include + +# ifndef OPENSSL_NO_OCSP + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_OCSP_strings(void); + +/* + * OCSP function codes. + */ +# define OCSP_F_D2I_OCSP_NONCE 102 +# define OCSP_F_OCSP_BASIC_ADD1_STATUS 103 +# define OCSP_F_OCSP_BASIC_SIGN 104 +# define OCSP_F_OCSP_BASIC_SIGN_CTX 119 +# define OCSP_F_OCSP_BASIC_VERIFY 105 +# define OCSP_F_OCSP_CERT_ID_NEW 101 +# define OCSP_F_OCSP_CHECK_DELEGATED 106 +# define OCSP_F_OCSP_CHECK_IDS 107 +# define OCSP_F_OCSP_CHECK_ISSUER 108 +# define OCSP_F_OCSP_CHECK_VALIDITY 115 +# define OCSP_F_OCSP_MATCH_ISSUERID 109 +# define OCSP_F_OCSP_PARSE_URL 114 +# define OCSP_F_OCSP_REQUEST_SIGN 110 +# define OCSP_F_OCSP_REQUEST_VERIFY 116 +# define OCSP_F_OCSP_RESPONSE_GET1_BASIC 111 +# define OCSP_F_PARSE_HTTP_LINE1 118 + +/* + * OCSP reason codes. + */ +# define OCSP_R_CERTIFICATE_VERIFY_ERROR 101 +# define OCSP_R_DIGEST_ERR 102 +# define OCSP_R_ERROR_IN_NEXTUPDATE_FIELD 122 +# define OCSP_R_ERROR_IN_THISUPDATE_FIELD 123 +# define OCSP_R_ERROR_PARSING_URL 121 +# define OCSP_R_MISSING_OCSPSIGNING_USAGE 103 +# define OCSP_R_NEXTUPDATE_BEFORE_THISUPDATE 124 +# define OCSP_R_NOT_BASIC_RESPONSE 104 +# define OCSP_R_NO_CERTIFICATES_IN_CHAIN 105 +# define OCSP_R_NO_RESPONSE_DATA 108 +# define OCSP_R_NO_REVOKED_TIME 109 +# define OCSP_R_NO_SIGNER_KEY 130 +# define OCSP_R_PRIVATE_KEY_DOES_NOT_MATCH_CERTIFICATE 110 +# define OCSP_R_REQUEST_NOT_SIGNED 128 +# define OCSP_R_RESPONSE_CONTAINS_NO_REVOCATION_DATA 111 +# define OCSP_R_ROOT_CA_NOT_TRUSTED 112 +# define OCSP_R_SERVER_RESPONSE_ERROR 114 +# define OCSP_R_SERVER_RESPONSE_PARSE_ERROR 115 +# define OCSP_R_SIGNATURE_FAILURE 117 +# define OCSP_R_SIGNER_CERTIFICATE_NOT_FOUND 118 +# define OCSP_R_STATUS_EXPIRED 125 +# define OCSP_R_STATUS_NOT_YET_VALID 126 +# define OCSP_R_STATUS_TOO_OLD 127 +# define OCSP_R_UNKNOWN_MESSAGE_DIGEST 119 +# define OCSP_R_UNKNOWN_NID 120 +# define OCSP_R_UNSUPPORTED_REQUESTORNAME_TYPE 129 + +# endif +#endif diff --git a/include/openssl/opensslconf.h b/include/openssl/opensslconf.h new file mode 100644 index 0000000..9fccb14 --- /dev/null +++ b/include/openssl/opensslconf.h @@ -0,0 +1,198 @@ +/* + * WARNING: do not edit! + * Generated by Makefile from include/openssl/opensslconf.h.in + * + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +#ifdef OPENSSL_ALGORITHM_DEFINES +# error OPENSSL_ALGORITHM_DEFINES no longer supported +#endif + +/* + * OpenSSL was configured with the following options: + */ + +#ifndef OPENSSL_SYS_MINGW64 +# define OPENSSL_SYS_MINGW64 1 +#endif +#ifndef OPENSSL_NO_MD2 +# define OPENSSL_NO_MD2 +#endif +#ifndef OPENSSL_NO_RC5 +# define OPENSSL_NO_RC5 +#endif +#ifndef OPENSSL_THREADS +# define OPENSSL_THREADS +#endif +#ifndef OPENSSL_RAND_SEED_OS +# define OPENSSL_RAND_SEED_OS +#endif +#ifndef OPENSSL_NO_ASAN +# define OPENSSL_NO_ASAN +#endif +#ifndef OPENSSL_NO_CRYPTO_MDEBUG +# define OPENSSL_NO_CRYPTO_MDEBUG +#endif +#ifndef OPENSSL_NO_CRYPTO_MDEBUG_BACKTRACE +# define OPENSSL_NO_CRYPTO_MDEBUG_BACKTRACE +#endif +#ifndef OPENSSL_NO_DEVCRYPTOENG +# define OPENSSL_NO_DEVCRYPTOENG +#endif +#ifndef OPENSSL_NO_EC_NISTP_64_GCC_128 +# define OPENSSL_NO_EC_NISTP_64_GCC_128 +#endif +#ifndef OPENSSL_NO_EGD +# define OPENSSL_NO_EGD +#endif +#ifndef OPENSSL_NO_EXTERNAL_TESTS +# define OPENSSL_NO_EXTERNAL_TESTS +#endif +#ifndef OPENSSL_NO_FUZZ_AFL +# define OPENSSL_NO_FUZZ_AFL +#endif +#ifndef OPENSSL_NO_FUZZ_LIBFUZZER +# define OPENSSL_NO_FUZZ_LIBFUZZER +#endif +#ifndef OPENSSL_NO_HEARTBEATS +# define OPENSSL_NO_HEARTBEATS +#endif +#ifndef OPENSSL_NO_MSAN +# define OPENSSL_NO_MSAN +#endif +#ifndef OPENSSL_NO_SCTP +# define OPENSSL_NO_SCTP +#endif +#ifndef OPENSSL_NO_SSL_TRACE +# define OPENSSL_NO_SSL_TRACE +#endif +#ifndef OPENSSL_NO_SSL3 +# define OPENSSL_NO_SSL3 +#endif +#ifndef OPENSSL_NO_SSL3_METHOD +# define OPENSSL_NO_SSL3_METHOD +#endif +#ifndef OPENSSL_NO_UBSAN +# define OPENSSL_NO_UBSAN +#endif +#ifndef OPENSSL_NO_UNIT_TEST +# define OPENSSL_NO_UNIT_TEST +#endif +#ifndef OPENSSL_NO_WEAK_SSL_CIPHERS +# define OPENSSL_NO_WEAK_SSL_CIPHERS +#endif +#ifndef OPENSSL_NO_DYNAMIC_ENGINE +# define OPENSSL_NO_DYNAMIC_ENGINE +#endif +#ifndef OPENSSL_NO_AFALGENG +# define OPENSSL_NO_AFALGENG +#endif + + +/* + * Sometimes OPENSSSL_NO_xxx ends up with an empty file and some compilers + * don't like that. This will hopefully silence them. + */ +#define NON_EMPTY_TRANSLATION_UNIT static void *dummy = &dummy; + +/* + * Applications should use -DOPENSSL_API_COMPAT= to suppress the + * declarations of functions deprecated in or before . Otherwise, they + * still won't see them if the library has been built to disable deprecated + * functions. + */ +#ifndef DECLARE_DEPRECATED +# define DECLARE_DEPRECATED(f) f; +# ifdef __GNUC__ +# if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ > 0) +# undef DECLARE_DEPRECATED +# define DECLARE_DEPRECATED(f) f __attribute__ ((deprecated)); +# endif +# endif +#endif + +#ifndef OPENSSL_FILE +# ifdef OPENSSL_NO_FILENAMES +# define OPENSSL_FILE "" +# define OPENSSL_LINE 0 +# else +# define OPENSSL_FILE __FILE__ +# define OPENSSL_LINE __LINE__ +# endif +#endif + +#ifndef OPENSSL_MIN_API +# define OPENSSL_MIN_API 0 +#endif + +#if !defined(OPENSSL_API_COMPAT) || OPENSSL_API_COMPAT < OPENSSL_MIN_API +# undef OPENSSL_API_COMPAT +# define OPENSSL_API_COMPAT OPENSSL_MIN_API +#endif + +/* + * Do not deprecate things to be deprecated in version 1.2.0 before the + * OpenSSL version number matches. + */ +#if OPENSSL_VERSION_NUMBER < 0x10200000L +# define DEPRECATEDIN_1_2_0(f) f; +#elif OPENSSL_API_COMPAT < 0x10200000L +# define DEPRECATEDIN_1_2_0(f) DECLARE_DEPRECATED(f) +#else +# define DEPRECATEDIN_1_2_0(f) +#endif + +#if OPENSSL_API_COMPAT < 0x10100000L +# define DEPRECATEDIN_1_1_0(f) DECLARE_DEPRECATED(f) +#else +# define DEPRECATEDIN_1_1_0(f) +#endif + +#if OPENSSL_API_COMPAT < 0x10000000L +# define DEPRECATEDIN_1_0_0(f) DECLARE_DEPRECATED(f) +#else +# define DEPRECATEDIN_1_0_0(f) +#endif + +#if OPENSSL_API_COMPAT < 0x00908000L +# define DEPRECATEDIN_0_9_8(f) DECLARE_DEPRECATED(f) +#else +# define DEPRECATEDIN_0_9_8(f) +#endif + +/* Generate 80386 code? */ +#undef I386_ONLY + +#undef OPENSSL_UNISTD +#define OPENSSL_UNISTD + +#define OPENSSL_EXPORT_VAR_AS_FUNCTION + +/* + * The following are cipher-specific, but are part of the public API. + */ +#if !defined(OPENSSL_SYS_UEFI) +# undef BN_LLONG +/* Only one for the following should be defined */ +# undef SIXTY_FOUR_BIT_LONG +# define SIXTY_FOUR_BIT +# undef THIRTY_TWO_BIT +#endif + +#define RC4_INT unsigned int + +#ifdef __cplusplus +} +#endif diff --git a/include/openssl/opensslv.h b/include/openssl/opensslv.h new file mode 100644 index 0000000..9e66fc1 --- /dev/null +++ b/include/openssl/opensslv.h @@ -0,0 +1,101 @@ +/* + * Copyright 1999-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OPENSSLV_H +# define HEADER_OPENSSLV_H + +#ifdef __cplusplus +extern "C" { +#endif + +/*- + * Numeric release version identifier: + * MNNFFPPS: major minor fix patch status + * The status nibble has one of the values 0 for development, 1 to e for betas + * 1 to 14, and f for release. The patch level is exactly that. + * For example: + * 0.9.3-dev 0x00903000 + * 0.9.3-beta1 0x00903001 + * 0.9.3-beta2-dev 0x00903002 + * 0.9.3-beta2 0x00903002 (same as ...beta2-dev) + * 0.9.3 0x0090300f + * 0.9.3a 0x0090301f + * 0.9.4 0x0090400f + * 1.2.3z 0x102031af + * + * For continuity reasons (because 0.9.5 is already out, and is coded + * 0x00905100), between 0.9.5 and 0.9.6 the coding of the patch level + * part is slightly different, by setting the highest bit. This means + * that 0.9.5a looks like this: 0x0090581f. At 0.9.6, we can start + * with 0x0090600S... + * + * (Prior to 0.9.3-dev a different scheme was used: 0.9.2b is 0x0922.) + * (Prior to 0.9.5a beta1, a different scheme was used: MMNNFFRBB for + * major minor fix final patch/beta) + */ +# define OPENSSL_VERSION_NUMBER 0x1010100fL +# define OPENSSL_VERSION_TEXT "OpenSSL 1.1.1 11 Sep 2018" + +/*- + * The macros below are to be used for shared library (.so, .dll, ...) + * versioning. That kind of versioning works a bit differently between + * operating systems. The most usual scheme is to set a major and a minor + * number, and have the runtime loader check that the major number is equal + * to what it was at application link time, while the minor number has to + * be greater or equal to what it was at application link time. With this + * scheme, the version number is usually part of the file name, like this: + * + * libcrypto.so.0.9 + * + * Some unixen also make a softlink with the major version number only: + * + * libcrypto.so.0 + * + * On Tru64 and IRIX 6.x it works a little bit differently. There, the + * shared library version is stored in the file, and is actually a series + * of versions, separated by colons. The rightmost version present in the + * library when linking an application is stored in the application to be + * matched at run time. When the application is run, a check is done to + * see if the library version stored in the application matches any of the + * versions in the version string of the library itself. + * This version string can be constructed in any way, depending on what + * kind of matching is desired. However, to implement the same scheme as + * the one used in the other unixen, all compatible versions, from lowest + * to highest, should be part of the string. Consecutive builds would + * give the following versions strings: + * + * 3.0 + * 3.0:3.1 + * 3.0:3.1:3.2 + * 4.0 + * 4.0:4.1 + * + * Notice how version 4 is completely incompatible with version, and + * therefore give the breach you can see. + * + * There may be other schemes as well that I haven't yet discovered. + * + * So, here's the way it works here: first of all, the library version + * number doesn't need at all to match the overall OpenSSL version. + * However, it's nice and more understandable if it actually does. + * The current library version is stored in the macro SHLIB_VERSION_NUMBER, + * which is just a piece of text in the format "M.m.e" (Major, minor, edit). + * For the sake of Tru64, IRIX, and any other OS that behaves in similar ways, + * we need to keep a history of version numbers, which is done in the + * macro SHLIB_VERSION_HISTORY. The numbers are separated by colons and + * should only keep the versions that are binary compatible with the current. + */ +# define SHLIB_VERSION_HISTORY "" +# define SHLIB_VERSION_NUMBER "1.1" + + +#ifdef __cplusplus +} +#endif +#endif /* HEADER_OPENSSLV_H */ diff --git a/include/openssl/ossl_typ.h b/include/openssl/ossl_typ.h new file mode 100644 index 0000000..66f231a --- /dev/null +++ b/include/openssl/ossl_typ.h @@ -0,0 +1,196 @@ +/* + * Copyright 2001-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OPENSSL_TYPES_H +# define HEADER_OPENSSL_TYPES_H + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +# include + +# ifdef NO_ASN1_TYPEDEFS +# define ASN1_INTEGER ASN1_STRING +# define ASN1_ENUMERATED ASN1_STRING +# define ASN1_BIT_STRING ASN1_STRING +# define ASN1_OCTET_STRING ASN1_STRING +# define ASN1_PRINTABLESTRING ASN1_STRING +# define ASN1_T61STRING ASN1_STRING +# define ASN1_IA5STRING ASN1_STRING +# define ASN1_UTCTIME ASN1_STRING +# define ASN1_GENERALIZEDTIME ASN1_STRING +# define ASN1_TIME ASN1_STRING +# define ASN1_GENERALSTRING ASN1_STRING +# define ASN1_UNIVERSALSTRING ASN1_STRING +# define ASN1_BMPSTRING ASN1_STRING +# define ASN1_VISIBLESTRING ASN1_STRING +# define ASN1_UTF8STRING ASN1_STRING +# define ASN1_BOOLEAN int +# define ASN1_NULL int +# else +typedef struct asn1_string_st ASN1_INTEGER; +typedef struct asn1_string_st ASN1_ENUMERATED; +typedef struct asn1_string_st ASN1_BIT_STRING; +typedef struct asn1_string_st ASN1_OCTET_STRING; +typedef struct asn1_string_st ASN1_PRINTABLESTRING; +typedef struct asn1_string_st ASN1_T61STRING; +typedef struct asn1_string_st ASN1_IA5STRING; +typedef struct asn1_string_st ASN1_GENERALSTRING; +typedef struct asn1_string_st ASN1_UNIVERSALSTRING; +typedef struct asn1_string_st ASN1_BMPSTRING; +typedef struct asn1_string_st ASN1_UTCTIME; +typedef struct asn1_string_st ASN1_TIME; +typedef struct asn1_string_st ASN1_GENERALIZEDTIME; +typedef struct asn1_string_st ASN1_VISIBLESTRING; +typedef struct asn1_string_st ASN1_UTF8STRING; +typedef struct asn1_string_st ASN1_STRING; +typedef int ASN1_BOOLEAN; +typedef int ASN1_NULL; +# endif + +typedef struct asn1_object_st ASN1_OBJECT; + +typedef struct ASN1_ITEM_st ASN1_ITEM; +typedef struct asn1_pctx_st ASN1_PCTX; +typedef struct asn1_sctx_st ASN1_SCTX; + +# ifdef _WIN32 +# undef X509_NAME +# undef X509_EXTENSIONS +# undef PKCS7_ISSUER_AND_SERIAL +# undef PKCS7_SIGNER_INFO +# undef OCSP_REQUEST +# undef OCSP_RESPONSE +# endif + +# ifdef BIGNUM +# undef BIGNUM +# endif +struct dane_st; +typedef struct bio_st BIO; +typedef struct bignum_st BIGNUM; +typedef struct bignum_ctx BN_CTX; +typedef struct bn_blinding_st BN_BLINDING; +typedef struct bn_mont_ctx_st BN_MONT_CTX; +typedef struct bn_recp_ctx_st BN_RECP_CTX; +typedef struct bn_gencb_st BN_GENCB; + +typedef struct buf_mem_st BUF_MEM; + +typedef struct evp_cipher_st EVP_CIPHER; +typedef struct evp_cipher_ctx_st EVP_CIPHER_CTX; +typedef struct evp_md_st EVP_MD; +typedef struct evp_md_ctx_st EVP_MD_CTX; +typedef struct evp_pkey_st EVP_PKEY; + +typedef struct evp_pkey_asn1_method_st EVP_PKEY_ASN1_METHOD; + +typedef struct evp_pkey_method_st EVP_PKEY_METHOD; +typedef struct evp_pkey_ctx_st EVP_PKEY_CTX; + +typedef struct evp_Encode_Ctx_st EVP_ENCODE_CTX; + +typedef struct hmac_ctx_st HMAC_CTX; + +typedef struct dh_st DH; +typedef struct dh_method DH_METHOD; + +typedef struct dsa_st DSA; +typedef struct dsa_method DSA_METHOD; + +typedef struct rsa_st RSA; +typedef struct rsa_meth_st RSA_METHOD; + +typedef struct ec_key_st EC_KEY; +typedef struct ec_key_method_st EC_KEY_METHOD; + +typedef struct rand_meth_st RAND_METHOD; +typedef struct rand_drbg_st RAND_DRBG; + +typedef struct ssl_dane_st SSL_DANE; +typedef struct x509_st X509; +typedef struct X509_algor_st X509_ALGOR; +typedef struct X509_crl_st X509_CRL; +typedef struct x509_crl_method_st X509_CRL_METHOD; +typedef struct x509_revoked_st X509_REVOKED; +typedef struct X509_name_st X509_NAME; +typedef struct X509_pubkey_st X509_PUBKEY; +typedef struct x509_store_st X509_STORE; +typedef struct x509_store_ctx_st X509_STORE_CTX; + +typedef struct x509_object_st X509_OBJECT; +typedef struct x509_lookup_st X509_LOOKUP; +typedef struct x509_lookup_method_st X509_LOOKUP_METHOD; +typedef struct X509_VERIFY_PARAM_st X509_VERIFY_PARAM; + +typedef struct x509_sig_info_st X509_SIG_INFO; + +typedef struct pkcs8_priv_key_info_st PKCS8_PRIV_KEY_INFO; + +typedef struct v3_ext_ctx X509V3_CTX; +typedef struct conf_st CONF; +typedef struct ossl_init_settings_st OPENSSL_INIT_SETTINGS; + +typedef struct ui_st UI; +typedef struct ui_method_st UI_METHOD; + +typedef struct engine_st ENGINE; +typedef struct ssl_st SSL; +typedef struct ssl_ctx_st SSL_CTX; + +typedef struct comp_ctx_st COMP_CTX; +typedef struct comp_method_st COMP_METHOD; + +typedef struct X509_POLICY_NODE_st X509_POLICY_NODE; +typedef struct X509_POLICY_LEVEL_st X509_POLICY_LEVEL; +typedef struct X509_POLICY_TREE_st X509_POLICY_TREE; +typedef struct X509_POLICY_CACHE_st X509_POLICY_CACHE; + +typedef struct AUTHORITY_KEYID_st AUTHORITY_KEYID; +typedef struct DIST_POINT_st DIST_POINT; +typedef struct ISSUING_DIST_POINT_st ISSUING_DIST_POINT; +typedef struct NAME_CONSTRAINTS_st NAME_CONSTRAINTS; + +typedef struct crypto_ex_data_st CRYPTO_EX_DATA; + +typedef struct ocsp_req_ctx_st OCSP_REQ_CTX; +typedef struct ocsp_response_st OCSP_RESPONSE; +typedef struct ocsp_responder_id_st OCSP_RESPID; + +typedef struct sct_st SCT; +typedef struct sct_ctx_st SCT_CTX; +typedef struct ctlog_st CTLOG; +typedef struct ctlog_store_st CTLOG_STORE; +typedef struct ct_policy_eval_ctx_st CT_POLICY_EVAL_CTX; + +typedef struct ossl_store_info_st OSSL_STORE_INFO; +typedef struct ossl_store_search_st OSSL_STORE_SEARCH; + +#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L && \ + defined(INTMAX_MAX) && defined(UINTMAX_MAX) +typedef intmax_t ossl_intmax_t; +typedef uintmax_t ossl_uintmax_t; +#else +/* + * Not long long, because the C-library can only be expected to provide + * strtoll(), strtoull() at the same time as intmax_t and strtoimax(), + * strtoumax(). Since we use these for parsing arguments, we need the + * conversion functions, not just the sizes. + */ +typedef long ossl_intmax_t; +typedef unsigned long ossl_uintmax_t; +#endif + +#ifdef __cplusplus +} +#endif +#endif /* def HEADER_OPENSSL_TYPES_H */ diff --git a/include/openssl/pem.h b/include/openssl/pem.h new file mode 100644 index 0000000..7514f7a --- /dev/null +++ b/include/openssl/pem.h @@ -0,0 +1,378 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PEM_H +# define HEADER_PEM_H + +# include +# include +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +# define PEM_BUFSIZE 1024 + +# define PEM_STRING_X509_OLD "X509 CERTIFICATE" +# define PEM_STRING_X509 "CERTIFICATE" +# define PEM_STRING_X509_TRUSTED "TRUSTED CERTIFICATE" +# define PEM_STRING_X509_REQ_OLD "NEW CERTIFICATE REQUEST" +# define PEM_STRING_X509_REQ "CERTIFICATE REQUEST" +# define PEM_STRING_X509_CRL "X509 CRL" +# define PEM_STRING_EVP_PKEY "ANY PRIVATE KEY" +# define PEM_STRING_PUBLIC "PUBLIC KEY" +# define PEM_STRING_RSA "RSA PRIVATE KEY" +# define PEM_STRING_RSA_PUBLIC "RSA PUBLIC KEY" +# define PEM_STRING_DSA "DSA PRIVATE KEY" +# define PEM_STRING_DSA_PUBLIC "DSA PUBLIC KEY" +# define PEM_STRING_PKCS7 "PKCS7" +# define PEM_STRING_PKCS7_SIGNED "PKCS #7 SIGNED DATA" +# define PEM_STRING_PKCS8 "ENCRYPTED PRIVATE KEY" +# define PEM_STRING_PKCS8INF "PRIVATE KEY" +# define PEM_STRING_DHPARAMS "DH PARAMETERS" +# define PEM_STRING_DHXPARAMS "X9.42 DH PARAMETERS" +# define PEM_STRING_SSL_SESSION "SSL SESSION PARAMETERS" +# define PEM_STRING_DSAPARAMS "DSA PARAMETERS" +# define PEM_STRING_ECDSA_PUBLIC "ECDSA PUBLIC KEY" +# define PEM_STRING_ECPARAMETERS "EC PARAMETERS" +# define PEM_STRING_ECPRIVATEKEY "EC PRIVATE KEY" +# define PEM_STRING_PARAMETERS "PARAMETERS" +# define PEM_STRING_CMS "CMS" + +# define PEM_TYPE_ENCRYPTED 10 +# define PEM_TYPE_MIC_ONLY 20 +# define PEM_TYPE_MIC_CLEAR 30 +# define PEM_TYPE_CLEAR 40 + +/* + * These macros make the PEM_read/PEM_write functions easier to maintain and + * write. Now they are all implemented with either: IMPLEMENT_PEM_rw(...) or + * IMPLEMENT_PEM_rw_cb(...) + */ + +# ifdef OPENSSL_NO_STDIO + +# define IMPLEMENT_PEM_read_fp(name, type, str, asn1) /**/ +# define IMPLEMENT_PEM_write_fp(name, type, str, asn1) /**/ +# define IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) /**/ +# define IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) /**/ +# define IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) /**/ +# else + +# define IMPLEMENT_PEM_read_fp(name, type, str, asn1) \ +type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u)\ +{ \ +return PEM_ASN1_read((d2i_of_void *)d2i_##asn1, str,fp,(void **)x,cb,u); \ +} + +# define IMPLEMENT_PEM_write_fp(name, type, str, asn1) \ +int PEM_write_##name(FILE *fp, type *x) \ +{ \ +return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,NULL,NULL,0,NULL,NULL); \ +} + +# define IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) \ +int PEM_write_##name(FILE *fp, const type *x) \ +{ \ +return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,(void *)x,NULL,NULL,0,NULL,NULL); \ +} + +# define IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) \ +int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \ + unsigned char *kstr, int klen, pem_password_cb *cb, \ + void *u) \ + { \ + return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u); \ + } + +# define IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) \ +int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \ + unsigned char *kstr, int klen, pem_password_cb *cb, \ + void *u) \ + { \ + return PEM_ASN1_write((i2d_of_void *)i2d_##asn1,str,fp,x,enc,kstr,klen,cb,u); \ + } + +# endif + +# define IMPLEMENT_PEM_read_bio(name, type, str, asn1) \ +type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u)\ +{ \ +return PEM_ASN1_read_bio((d2i_of_void *)d2i_##asn1, str,bp,(void **)x,cb,u); \ +} + +# define IMPLEMENT_PEM_write_bio(name, type, str, asn1) \ +int PEM_write_bio_##name(BIO *bp, type *x) \ +{ \ +return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,x,NULL,NULL,0,NULL,NULL); \ +} + +# define IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \ +int PEM_write_bio_##name(BIO *bp, const type *x) \ +{ \ +return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,(void *)x,NULL,NULL,0,NULL,NULL); \ +} + +# define IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \ +int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \ + unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \ + { \ + return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,x,enc,kstr,klen,cb,u); \ + } + +# define IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \ +int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \ + unsigned char *kstr, int klen, pem_password_cb *cb, void *u) \ + { \ + return PEM_ASN1_write_bio((i2d_of_void *)i2d_##asn1,str,bp,(void *)x,enc,kstr,klen,cb,u); \ + } + +# define IMPLEMENT_PEM_write(name, type, str, asn1) \ + IMPLEMENT_PEM_write_bio(name, type, str, asn1) \ + IMPLEMENT_PEM_write_fp(name, type, str, asn1) + +# define IMPLEMENT_PEM_write_const(name, type, str, asn1) \ + IMPLEMENT_PEM_write_bio_const(name, type, str, asn1) \ + IMPLEMENT_PEM_write_fp_const(name, type, str, asn1) + +# define IMPLEMENT_PEM_write_cb(name, type, str, asn1) \ + IMPLEMENT_PEM_write_cb_bio(name, type, str, asn1) \ + IMPLEMENT_PEM_write_cb_fp(name, type, str, asn1) + +# define IMPLEMENT_PEM_write_cb_const(name, type, str, asn1) \ + IMPLEMENT_PEM_write_cb_bio_const(name, type, str, asn1) \ + IMPLEMENT_PEM_write_cb_fp_const(name, type, str, asn1) + +# define IMPLEMENT_PEM_read(name, type, str, asn1) \ + IMPLEMENT_PEM_read_bio(name, type, str, asn1) \ + IMPLEMENT_PEM_read_fp(name, type, str, asn1) + +# define IMPLEMENT_PEM_rw(name, type, str, asn1) \ + IMPLEMENT_PEM_read(name, type, str, asn1) \ + IMPLEMENT_PEM_write(name, type, str, asn1) + +# define IMPLEMENT_PEM_rw_const(name, type, str, asn1) \ + IMPLEMENT_PEM_read(name, type, str, asn1) \ + IMPLEMENT_PEM_write_const(name, type, str, asn1) + +# define IMPLEMENT_PEM_rw_cb(name, type, str, asn1) \ + IMPLEMENT_PEM_read(name, type, str, asn1) \ + IMPLEMENT_PEM_write_cb(name, type, str, asn1) + +/* These are the same except they are for the declarations */ + +# if defined(OPENSSL_NO_STDIO) + +# define DECLARE_PEM_read_fp(name, type) /**/ +# define DECLARE_PEM_write_fp(name, type) /**/ +# define DECLARE_PEM_write_fp_const(name, type) /**/ +# define DECLARE_PEM_write_cb_fp(name, type) /**/ +# else + +# define DECLARE_PEM_read_fp(name, type) \ + type *PEM_read_##name(FILE *fp, type **x, pem_password_cb *cb, void *u); + +# define DECLARE_PEM_write_fp(name, type) \ + int PEM_write_##name(FILE *fp, type *x); + +# define DECLARE_PEM_write_fp_const(name, type) \ + int PEM_write_##name(FILE *fp, const type *x); + +# define DECLARE_PEM_write_cb_fp(name, type) \ + int PEM_write_##name(FILE *fp, type *x, const EVP_CIPHER *enc, \ + unsigned char *kstr, int klen, pem_password_cb *cb, void *u); + +# endif + +# define DECLARE_PEM_read_bio(name, type) \ + type *PEM_read_bio_##name(BIO *bp, type **x, pem_password_cb *cb, void *u); + +# define DECLARE_PEM_write_bio(name, type) \ + int PEM_write_bio_##name(BIO *bp, type *x); + +# define DECLARE_PEM_write_bio_const(name, type) \ + int PEM_write_bio_##name(BIO *bp, const type *x); + +# define DECLARE_PEM_write_cb_bio(name, type) \ + int PEM_write_bio_##name(BIO *bp, type *x, const EVP_CIPHER *enc, \ + unsigned char *kstr, int klen, pem_password_cb *cb, void *u); + +# define DECLARE_PEM_write(name, type) \ + DECLARE_PEM_write_bio(name, type) \ + DECLARE_PEM_write_fp(name, type) +# define DECLARE_PEM_write_const(name, type) \ + DECLARE_PEM_write_bio_const(name, type) \ + DECLARE_PEM_write_fp_const(name, type) +# define DECLARE_PEM_write_cb(name, type) \ + DECLARE_PEM_write_cb_bio(name, type) \ + DECLARE_PEM_write_cb_fp(name, type) +# define DECLARE_PEM_read(name, type) \ + DECLARE_PEM_read_bio(name, type) \ + DECLARE_PEM_read_fp(name, type) +# define DECLARE_PEM_rw(name, type) \ + DECLARE_PEM_read(name, type) \ + DECLARE_PEM_write(name, type) +# define DECLARE_PEM_rw_const(name, type) \ + DECLARE_PEM_read(name, type) \ + DECLARE_PEM_write_const(name, type) +# define DECLARE_PEM_rw_cb(name, type) \ + DECLARE_PEM_read(name, type) \ + DECLARE_PEM_write_cb(name, type) +typedef int pem_password_cb (char *buf, int size, int rwflag, void *userdata); + +int PEM_get_EVP_CIPHER_INFO(char *header, EVP_CIPHER_INFO *cipher); +int PEM_do_header(EVP_CIPHER_INFO *cipher, unsigned char *data, long *len, + pem_password_cb *callback, void *u); + +int PEM_read_bio(BIO *bp, char **name, char **header, + unsigned char **data, long *len); +# define PEM_FLAG_SECURE 0x1 +# define PEM_FLAG_EAY_COMPATIBLE 0x2 +# define PEM_FLAG_ONLY_B64 0x4 +int PEM_read_bio_ex(BIO *bp, char **name, char **header, + unsigned char **data, long *len, unsigned int flags); +int PEM_bytes_read_bio_secmem(unsigned char **pdata, long *plen, char **pnm, + const char *name, BIO *bp, pem_password_cb *cb, + void *u); +int PEM_write_bio(BIO *bp, const char *name, const char *hdr, + const unsigned char *data, long len); +int PEM_bytes_read_bio(unsigned char **pdata, long *plen, char **pnm, + const char *name, BIO *bp, pem_password_cb *cb, + void *u); +void *PEM_ASN1_read_bio(d2i_of_void *d2i, const char *name, BIO *bp, void **x, + pem_password_cb *cb, void *u); +int PEM_ASN1_write_bio(i2d_of_void *i2d, const char *name, BIO *bp, void *x, + const EVP_CIPHER *enc, unsigned char *kstr, int klen, + pem_password_cb *cb, void *u); + +STACK_OF(X509_INFO) *PEM_X509_INFO_read_bio(BIO *bp, STACK_OF(X509_INFO) *sk, + pem_password_cb *cb, void *u); +int PEM_X509_INFO_write_bio(BIO *bp, X509_INFO *xi, EVP_CIPHER *enc, + unsigned char *kstr, int klen, + pem_password_cb *cd, void *u); + +#ifndef OPENSSL_NO_STDIO +int PEM_read(FILE *fp, char **name, char **header, + unsigned char **data, long *len); +int PEM_write(FILE *fp, const char *name, const char *hdr, + const unsigned char *data, long len); +void *PEM_ASN1_read(d2i_of_void *d2i, const char *name, FILE *fp, void **x, + pem_password_cb *cb, void *u); +int PEM_ASN1_write(i2d_of_void *i2d, const char *name, FILE *fp, + void *x, const EVP_CIPHER *enc, unsigned char *kstr, + int klen, pem_password_cb *callback, void *u); +STACK_OF(X509_INFO) *PEM_X509_INFO_read(FILE *fp, STACK_OF(X509_INFO) *sk, + pem_password_cb *cb, void *u); +#endif + +int PEM_SignInit(EVP_MD_CTX *ctx, EVP_MD *type); +int PEM_SignUpdate(EVP_MD_CTX *ctx, unsigned char *d, unsigned int cnt); +int PEM_SignFinal(EVP_MD_CTX *ctx, unsigned char *sigret, + unsigned int *siglen, EVP_PKEY *pkey); + +/* The default pem_password_cb that's used internally */ +int PEM_def_callback(char *buf, int num, int rwflag, void *userdata); +void PEM_proc_type(char *buf, int type); +void PEM_dek_info(char *buf, const char *type, int len, char *str); + +# include + +DECLARE_PEM_rw(X509, X509) +DECLARE_PEM_rw(X509_AUX, X509) +DECLARE_PEM_rw(X509_REQ, X509_REQ) +DECLARE_PEM_write(X509_REQ_NEW, X509_REQ) +DECLARE_PEM_rw(X509_CRL, X509_CRL) +DECLARE_PEM_rw(PKCS7, PKCS7) +DECLARE_PEM_rw(NETSCAPE_CERT_SEQUENCE, NETSCAPE_CERT_SEQUENCE) +DECLARE_PEM_rw(PKCS8, X509_SIG) +DECLARE_PEM_rw(PKCS8_PRIV_KEY_INFO, PKCS8_PRIV_KEY_INFO) +# ifndef OPENSSL_NO_RSA +DECLARE_PEM_rw_cb(RSAPrivateKey, RSA) +DECLARE_PEM_rw_const(RSAPublicKey, RSA) +DECLARE_PEM_rw(RSA_PUBKEY, RSA) +# endif +# ifndef OPENSSL_NO_DSA +DECLARE_PEM_rw_cb(DSAPrivateKey, DSA) +DECLARE_PEM_rw(DSA_PUBKEY, DSA) +DECLARE_PEM_rw_const(DSAparams, DSA) +# endif +# ifndef OPENSSL_NO_EC +DECLARE_PEM_rw_const(ECPKParameters, EC_GROUP) +DECLARE_PEM_rw_cb(ECPrivateKey, EC_KEY) +DECLARE_PEM_rw(EC_PUBKEY, EC_KEY) +# endif +# ifndef OPENSSL_NO_DH +DECLARE_PEM_rw_const(DHparams, DH) +DECLARE_PEM_write_const(DHxparams, DH) +# endif +DECLARE_PEM_rw_cb(PrivateKey, EVP_PKEY) +DECLARE_PEM_rw(PUBKEY, EVP_PKEY) + +int PEM_write_bio_PrivateKey_traditional(BIO *bp, EVP_PKEY *x, + const EVP_CIPHER *enc, + unsigned char *kstr, int klen, + pem_password_cb *cb, void *u); + +int PEM_write_bio_PKCS8PrivateKey_nid(BIO *bp, EVP_PKEY *x, int nid, + char *kstr, int klen, + pem_password_cb *cb, void *u); +int PEM_write_bio_PKCS8PrivateKey(BIO *, EVP_PKEY *, const EVP_CIPHER *, + char *, int, pem_password_cb *, void *); +int i2d_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY *x, const EVP_CIPHER *enc, + char *kstr, int klen, + pem_password_cb *cb, void *u); +int i2d_PKCS8PrivateKey_nid_bio(BIO *bp, EVP_PKEY *x, int nid, + char *kstr, int klen, + pem_password_cb *cb, void *u); +EVP_PKEY *d2i_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY **x, pem_password_cb *cb, + void *u); + +# ifndef OPENSSL_NO_STDIO +int i2d_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc, + char *kstr, int klen, + pem_password_cb *cb, void *u); +int i2d_PKCS8PrivateKey_nid_fp(FILE *fp, EVP_PKEY *x, int nid, + char *kstr, int klen, + pem_password_cb *cb, void *u); +int PEM_write_PKCS8PrivateKey_nid(FILE *fp, EVP_PKEY *x, int nid, + char *kstr, int klen, + pem_password_cb *cb, void *u); + +EVP_PKEY *d2i_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY **x, pem_password_cb *cb, + void *u); + +int PEM_write_PKCS8PrivateKey(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc, + char *kstr, int klen, pem_password_cb *cd, + void *u); +# endif +EVP_PKEY *PEM_read_bio_Parameters(BIO *bp, EVP_PKEY **x); +int PEM_write_bio_Parameters(BIO *bp, EVP_PKEY *x); + +# ifndef OPENSSL_NO_DSA +EVP_PKEY *b2i_PrivateKey(const unsigned char **in, long length); +EVP_PKEY *b2i_PublicKey(const unsigned char **in, long length); +EVP_PKEY *b2i_PrivateKey_bio(BIO *in); +EVP_PKEY *b2i_PublicKey_bio(BIO *in); +int i2b_PrivateKey_bio(BIO *out, EVP_PKEY *pk); +int i2b_PublicKey_bio(BIO *out, EVP_PKEY *pk); +# ifndef OPENSSL_NO_RC4 +EVP_PKEY *b2i_PVK_bio(BIO *in, pem_password_cb *cb, void *u); +int i2b_PVK_bio(BIO *out, EVP_PKEY *pk, int enclevel, + pem_password_cb *cb, void *u); +# endif +# endif + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/pem2.h b/include/openssl/pem2.h new file mode 100644 index 0000000..cf0b244 --- /dev/null +++ b/include/openssl/pem2.h @@ -0,0 +1,13 @@ +/* + * Copyright 1999-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PEM2_H +# define HEADER_PEM2_H +# include +#endif diff --git a/include/openssl/pemerr.h b/include/openssl/pemerr.h new file mode 100644 index 0000000..cd61b82 --- /dev/null +++ b/include/openssl/pemerr.h @@ -0,0 +1,99 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PEMERR_H +# define HEADER_PEMERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_PEM_strings(void); + +/* + * PEM function codes. + */ +# define PEM_F_B2I_DSS 127 +# define PEM_F_B2I_PVK_BIO 128 +# define PEM_F_B2I_RSA 129 +# define PEM_F_CHECK_BITLEN_DSA 130 +# define PEM_F_CHECK_BITLEN_RSA 131 +# define PEM_F_D2I_PKCS8PRIVATEKEY_BIO 120 +# define PEM_F_D2I_PKCS8PRIVATEKEY_FP 121 +# define PEM_F_DO_B2I 132 +# define PEM_F_DO_B2I_BIO 133 +# define PEM_F_DO_BLOB_HEADER 134 +# define PEM_F_DO_I2B 146 +# define PEM_F_DO_PK8PKEY 126 +# define PEM_F_DO_PK8PKEY_FP 125 +# define PEM_F_DO_PVK_BODY 135 +# define PEM_F_DO_PVK_HEADER 136 +# define PEM_F_GET_HEADER_AND_DATA 143 +# define PEM_F_GET_NAME 144 +# define PEM_F_I2B_PVK 137 +# define PEM_F_I2B_PVK_BIO 138 +# define PEM_F_LOAD_IV 101 +# define PEM_F_PEM_ASN1_READ 102 +# define PEM_F_PEM_ASN1_READ_BIO 103 +# define PEM_F_PEM_ASN1_WRITE 104 +# define PEM_F_PEM_ASN1_WRITE_BIO 105 +# define PEM_F_PEM_DEF_CALLBACK 100 +# define PEM_F_PEM_DO_HEADER 106 +# define PEM_F_PEM_GET_EVP_CIPHER_INFO 107 +# define PEM_F_PEM_READ 108 +# define PEM_F_PEM_READ_BIO 109 +# define PEM_F_PEM_READ_BIO_DHPARAMS 141 +# define PEM_F_PEM_READ_BIO_EX 145 +# define PEM_F_PEM_READ_BIO_PARAMETERS 140 +# define PEM_F_PEM_READ_BIO_PRIVATEKEY 123 +# define PEM_F_PEM_READ_DHPARAMS 142 +# define PEM_F_PEM_READ_PRIVATEKEY 124 +# define PEM_F_PEM_SIGNFINAL 112 +# define PEM_F_PEM_WRITE 113 +# define PEM_F_PEM_WRITE_BIO 114 +# define PEM_F_PEM_WRITE_PRIVATEKEY 139 +# define PEM_F_PEM_X509_INFO_READ 115 +# define PEM_F_PEM_X509_INFO_READ_BIO 116 +# define PEM_F_PEM_X509_INFO_WRITE_BIO 117 + +/* + * PEM reason codes. + */ +# define PEM_R_BAD_BASE64_DECODE 100 +# define PEM_R_BAD_DECRYPT 101 +# define PEM_R_BAD_END_LINE 102 +# define PEM_R_BAD_IV_CHARS 103 +# define PEM_R_BAD_MAGIC_NUMBER 116 +# define PEM_R_BAD_PASSWORD_READ 104 +# define PEM_R_BAD_VERSION_NUMBER 117 +# define PEM_R_BIO_WRITE_FAILURE 118 +# define PEM_R_CIPHER_IS_NULL 127 +# define PEM_R_ERROR_CONVERTING_PRIVATE_KEY 115 +# define PEM_R_EXPECTING_PRIVATE_KEY_BLOB 119 +# define PEM_R_EXPECTING_PUBLIC_KEY_BLOB 120 +# define PEM_R_HEADER_TOO_LONG 128 +# define PEM_R_INCONSISTENT_HEADER 121 +# define PEM_R_KEYBLOB_HEADER_PARSE_ERROR 122 +# define PEM_R_KEYBLOB_TOO_SHORT 123 +# define PEM_R_MISSING_DEK_IV 129 +# define PEM_R_NOT_DEK_INFO 105 +# define PEM_R_NOT_ENCRYPTED 106 +# define PEM_R_NOT_PROC_TYPE 107 +# define PEM_R_NO_START_LINE 108 +# define PEM_R_PROBLEMS_GETTING_PASSWORD 109 +# define PEM_R_PVK_DATA_TOO_SHORT 124 +# define PEM_R_PVK_TOO_SHORT 125 +# define PEM_R_READ_KEY 111 +# define PEM_R_SHORT_HEADER 112 +# define PEM_R_UNEXPECTED_DEK_IV 130 +# define PEM_R_UNSUPPORTED_CIPHER 113 +# define PEM_R_UNSUPPORTED_ENCRYPTION 114 +# define PEM_R_UNSUPPORTED_KEY_COMPONENTS 126 + +#endif diff --git a/include/openssl/pkcs12.h b/include/openssl/pkcs12.h new file mode 100644 index 0000000..433303e --- /dev/null +++ b/include/openssl/pkcs12.h @@ -0,0 +1,223 @@ +/* + * Copyright 1999-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PKCS12_H +# define HEADER_PKCS12_H + +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +# define PKCS12_KEY_ID 1 +# define PKCS12_IV_ID 2 +# define PKCS12_MAC_ID 3 + +/* Default iteration count */ +# ifndef PKCS12_DEFAULT_ITER +# define PKCS12_DEFAULT_ITER PKCS5_DEFAULT_ITER +# endif + +# define PKCS12_MAC_KEY_LENGTH 20 + +# define PKCS12_SALT_LEN 8 + +/* It's not clear if these are actually needed... */ +# define PKCS12_key_gen PKCS12_key_gen_utf8 +# define PKCS12_add_friendlyname PKCS12_add_friendlyname_utf8 + +/* MS key usage constants */ + +# define KEY_EX 0x10 +# define KEY_SIG 0x80 + +typedef struct PKCS12_MAC_DATA_st PKCS12_MAC_DATA; + +typedef struct PKCS12_st PKCS12; + +typedef struct PKCS12_SAFEBAG_st PKCS12_SAFEBAG; + +DEFINE_STACK_OF(PKCS12_SAFEBAG) + +typedef struct pkcs12_bag_st PKCS12_BAGS; + +# define PKCS12_ERROR 0 +# define PKCS12_OK 1 + +/* Compatibility macros */ + +#if OPENSSL_API_COMPAT < 0x10100000L + +# define M_PKCS12_bag_type PKCS12_bag_type +# define M_PKCS12_cert_bag_type PKCS12_cert_bag_type +# define M_PKCS12_crl_bag_type PKCS12_cert_bag_type + +# define PKCS12_certbag2x509 PKCS12_SAFEBAG_get1_cert +# define PKCS12_certbag2scrl PKCS12_SAFEBAG_get1_crl +# define PKCS12_bag_type PKCS12_SAFEBAG_get_nid +# define PKCS12_cert_bag_type PKCS12_SAFEBAG_get_bag_nid +# define PKCS12_x5092certbag PKCS12_SAFEBAG_create_cert +# define PKCS12_x509crl2certbag PKCS12_SAFEBAG_create_crl +# define PKCS12_MAKE_KEYBAG PKCS12_SAFEBAG_create0_p8inf +# define PKCS12_MAKE_SHKEYBAG PKCS12_SAFEBAG_create_pkcs8_encrypt + +#endif + +DEPRECATEDIN_1_1_0(ASN1_TYPE *PKCS12_get_attr(const PKCS12_SAFEBAG *bag, int attr_nid)) + +ASN1_TYPE *PKCS8_get_attr(PKCS8_PRIV_KEY_INFO *p8, int attr_nid); +int PKCS12_mac_present(const PKCS12 *p12); +void PKCS12_get0_mac(const ASN1_OCTET_STRING **pmac, + const X509_ALGOR **pmacalg, + const ASN1_OCTET_STRING **psalt, + const ASN1_INTEGER **piter, + const PKCS12 *p12); + +const ASN1_TYPE *PKCS12_SAFEBAG_get0_attr(const PKCS12_SAFEBAG *bag, + int attr_nid); +const ASN1_OBJECT *PKCS12_SAFEBAG_get0_type(const PKCS12_SAFEBAG *bag); +int PKCS12_SAFEBAG_get_nid(const PKCS12_SAFEBAG *bag); +int PKCS12_SAFEBAG_get_bag_nid(const PKCS12_SAFEBAG *bag); + +X509 *PKCS12_SAFEBAG_get1_cert(const PKCS12_SAFEBAG *bag); +X509_CRL *PKCS12_SAFEBAG_get1_crl(const PKCS12_SAFEBAG *bag); +const STACK_OF(PKCS12_SAFEBAG) * +PKCS12_SAFEBAG_get0_safes(const PKCS12_SAFEBAG *bag); +const PKCS8_PRIV_KEY_INFO *PKCS12_SAFEBAG_get0_p8inf(const PKCS12_SAFEBAG *bag); +const X509_SIG *PKCS12_SAFEBAG_get0_pkcs8(const PKCS12_SAFEBAG *bag); + +PKCS12_SAFEBAG *PKCS12_SAFEBAG_create_cert(X509 *x509); +PKCS12_SAFEBAG *PKCS12_SAFEBAG_create_crl(X509_CRL *crl); +PKCS12_SAFEBAG *PKCS12_SAFEBAG_create0_p8inf(PKCS8_PRIV_KEY_INFO *p8); +PKCS12_SAFEBAG *PKCS12_SAFEBAG_create0_pkcs8(X509_SIG *p8); +PKCS12_SAFEBAG *PKCS12_SAFEBAG_create_pkcs8_encrypt(int pbe_nid, + const char *pass, + int passlen, + unsigned char *salt, + int saltlen, int iter, + PKCS8_PRIV_KEY_INFO *p8inf); + +PKCS12_SAFEBAG *PKCS12_item_pack_safebag(void *obj, const ASN1_ITEM *it, + int nid1, int nid2); +PKCS8_PRIV_KEY_INFO *PKCS8_decrypt(const X509_SIG *p8, const char *pass, + int passlen); +PKCS8_PRIV_KEY_INFO *PKCS12_decrypt_skey(const PKCS12_SAFEBAG *bag, + const char *pass, int passlen); +X509_SIG *PKCS8_encrypt(int pbe_nid, const EVP_CIPHER *cipher, + const char *pass, int passlen, unsigned char *salt, + int saltlen, int iter, PKCS8_PRIV_KEY_INFO *p8); +X509_SIG *PKCS8_set0_pbe(const char *pass, int passlen, + PKCS8_PRIV_KEY_INFO *p8inf, X509_ALGOR *pbe); +PKCS7 *PKCS12_pack_p7data(STACK_OF(PKCS12_SAFEBAG) *sk); +STACK_OF(PKCS12_SAFEBAG) *PKCS12_unpack_p7data(PKCS7 *p7); +PKCS7 *PKCS12_pack_p7encdata(int pbe_nid, const char *pass, int passlen, + unsigned char *salt, int saltlen, int iter, + STACK_OF(PKCS12_SAFEBAG) *bags); +STACK_OF(PKCS12_SAFEBAG) *PKCS12_unpack_p7encdata(PKCS7 *p7, const char *pass, + int passlen); + +int PKCS12_pack_authsafes(PKCS12 *p12, STACK_OF(PKCS7) *safes); +STACK_OF(PKCS7) *PKCS12_unpack_authsafes(const PKCS12 *p12); + +int PKCS12_add_localkeyid(PKCS12_SAFEBAG *bag, unsigned char *name, + int namelen); +int PKCS12_add_friendlyname_asc(PKCS12_SAFEBAG *bag, const char *name, + int namelen); +int PKCS12_add_friendlyname_utf8(PKCS12_SAFEBAG *bag, const char *name, + int namelen); +int PKCS12_add_CSPName_asc(PKCS12_SAFEBAG *bag, const char *name, + int namelen); +int PKCS12_add_friendlyname_uni(PKCS12_SAFEBAG *bag, + const unsigned char *name, int namelen); +int PKCS8_add_keyusage(PKCS8_PRIV_KEY_INFO *p8, int usage); +ASN1_TYPE *PKCS12_get_attr_gen(const STACK_OF(X509_ATTRIBUTE) *attrs, + int attr_nid); +char *PKCS12_get_friendlyname(PKCS12_SAFEBAG *bag); +const STACK_OF(X509_ATTRIBUTE) * +PKCS12_SAFEBAG_get0_attrs(const PKCS12_SAFEBAG *bag); +unsigned char *PKCS12_pbe_crypt(const X509_ALGOR *algor, + const char *pass, int passlen, + const unsigned char *in, int inlen, + unsigned char **data, int *datalen, + int en_de); +void *PKCS12_item_decrypt_d2i(const X509_ALGOR *algor, const ASN1_ITEM *it, + const char *pass, int passlen, + const ASN1_OCTET_STRING *oct, int zbuf); +ASN1_OCTET_STRING *PKCS12_item_i2d_encrypt(X509_ALGOR *algor, + const ASN1_ITEM *it, + const char *pass, int passlen, + void *obj, int zbuf); +PKCS12 *PKCS12_init(int mode); +int PKCS12_key_gen_asc(const char *pass, int passlen, unsigned char *salt, + int saltlen, int id, int iter, int n, + unsigned char *out, const EVP_MD *md_type); +int PKCS12_key_gen_uni(unsigned char *pass, int passlen, unsigned char *salt, + int saltlen, int id, int iter, int n, + unsigned char *out, const EVP_MD *md_type); +int PKCS12_key_gen_utf8(const char *pass, int passlen, unsigned char *salt, + int saltlen, int id, int iter, int n, + unsigned char *out, const EVP_MD *md_type); +int PKCS12_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen, + ASN1_TYPE *param, const EVP_CIPHER *cipher, + const EVP_MD *md_type, int en_de); +int PKCS12_gen_mac(PKCS12 *p12, const char *pass, int passlen, + unsigned char *mac, unsigned int *maclen); +int PKCS12_verify_mac(PKCS12 *p12, const char *pass, int passlen); +int PKCS12_set_mac(PKCS12 *p12, const char *pass, int passlen, + unsigned char *salt, int saltlen, int iter, + const EVP_MD *md_type); +int PKCS12_setup_mac(PKCS12 *p12, int iter, unsigned char *salt, + int saltlen, const EVP_MD *md_type); +unsigned char *OPENSSL_asc2uni(const char *asc, int asclen, + unsigned char **uni, int *unilen); +char *OPENSSL_uni2asc(const unsigned char *uni, int unilen); +unsigned char *OPENSSL_utf82uni(const char *asc, int asclen, + unsigned char **uni, int *unilen); +char *OPENSSL_uni2utf8(const unsigned char *uni, int unilen); + +DECLARE_ASN1_FUNCTIONS(PKCS12) +DECLARE_ASN1_FUNCTIONS(PKCS12_MAC_DATA) +DECLARE_ASN1_FUNCTIONS(PKCS12_SAFEBAG) +DECLARE_ASN1_FUNCTIONS(PKCS12_BAGS) + +DECLARE_ASN1_ITEM(PKCS12_SAFEBAGS) +DECLARE_ASN1_ITEM(PKCS12_AUTHSAFES) + +void PKCS12_PBE_add(void); +int PKCS12_parse(PKCS12 *p12, const char *pass, EVP_PKEY **pkey, X509 **cert, + STACK_OF(X509) **ca); +PKCS12 *PKCS12_create(const char *pass, const char *name, EVP_PKEY *pkey, + X509 *cert, STACK_OF(X509) *ca, int nid_key, int nid_cert, + int iter, int mac_iter, int keytype); + +PKCS12_SAFEBAG *PKCS12_add_cert(STACK_OF(PKCS12_SAFEBAG) **pbags, X509 *cert); +PKCS12_SAFEBAG *PKCS12_add_key(STACK_OF(PKCS12_SAFEBAG) **pbags, + EVP_PKEY *key, int key_usage, int iter, + int key_nid, const char *pass); +int PKCS12_add_safe(STACK_OF(PKCS7) **psafes, STACK_OF(PKCS12_SAFEBAG) *bags, + int safe_nid, int iter, const char *pass); +PKCS12 *PKCS12_add_safes(STACK_OF(PKCS7) *safes, int p7_nid); + +int i2d_PKCS12_bio(BIO *bp, PKCS12 *p12); +# ifndef OPENSSL_NO_STDIO +int i2d_PKCS12_fp(FILE *fp, PKCS12 *p12); +# endif +PKCS12 *d2i_PKCS12_bio(BIO *bp, PKCS12 **p12); +# ifndef OPENSSL_NO_STDIO +PKCS12 *d2i_PKCS12_fp(FILE *fp, PKCS12 **p12); +# endif +int PKCS12_newpass(PKCS12 *p12, const char *oldpass, const char *newpass); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/pkcs12err.h b/include/openssl/pkcs12err.h new file mode 100644 index 0000000..c7184ff --- /dev/null +++ b/include/openssl/pkcs12err.h @@ -0,0 +1,77 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PKCS12ERR_H +# define HEADER_PKCS12ERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_PKCS12_strings(void); + +/* + * PKCS12 function codes. + */ +# define PKCS12_F_OPENSSL_ASC2UNI 121 +# define PKCS12_F_OPENSSL_UNI2ASC 124 +# define PKCS12_F_OPENSSL_UNI2UTF8 127 +# define PKCS12_F_OPENSSL_UTF82UNI 129 +# define PKCS12_F_PKCS12_CREATE 105 +# define PKCS12_F_PKCS12_GEN_MAC 107 +# define PKCS12_F_PKCS12_INIT 109 +# define PKCS12_F_PKCS12_ITEM_DECRYPT_D2I 106 +# define PKCS12_F_PKCS12_ITEM_I2D_ENCRYPT 108 +# define PKCS12_F_PKCS12_ITEM_PACK_SAFEBAG 117 +# define PKCS12_F_PKCS12_KEY_GEN_ASC 110 +# define PKCS12_F_PKCS12_KEY_GEN_UNI 111 +# define PKCS12_F_PKCS12_KEY_GEN_UTF8 116 +# define PKCS12_F_PKCS12_NEWPASS 128 +# define PKCS12_F_PKCS12_PACK_P7DATA 114 +# define PKCS12_F_PKCS12_PACK_P7ENCDATA 115 +# define PKCS12_F_PKCS12_PARSE 118 +# define PKCS12_F_PKCS12_PBE_CRYPT 119 +# define PKCS12_F_PKCS12_PBE_KEYIVGEN 120 +# define PKCS12_F_PKCS12_SAFEBAG_CREATE0_P8INF 112 +# define PKCS12_F_PKCS12_SAFEBAG_CREATE0_PKCS8 113 +# define PKCS12_F_PKCS12_SAFEBAG_CREATE_PKCS8_ENCRYPT 133 +# define PKCS12_F_PKCS12_SETUP_MAC 122 +# define PKCS12_F_PKCS12_SET_MAC 123 +# define PKCS12_F_PKCS12_UNPACK_AUTHSAFES 130 +# define PKCS12_F_PKCS12_UNPACK_P7DATA 131 +# define PKCS12_F_PKCS12_VERIFY_MAC 126 +# define PKCS12_F_PKCS8_ENCRYPT 125 +# define PKCS12_F_PKCS8_SET0_PBE 132 + +/* + * PKCS12 reason codes. + */ +# define PKCS12_R_CANT_PACK_STRUCTURE 100 +# define PKCS12_R_CONTENT_TYPE_NOT_DATA 121 +# define PKCS12_R_DECODE_ERROR 101 +# define PKCS12_R_ENCODE_ERROR 102 +# define PKCS12_R_ENCRYPT_ERROR 103 +# define PKCS12_R_ERROR_SETTING_ENCRYPTED_DATA_TYPE 120 +# define PKCS12_R_INVALID_NULL_ARGUMENT 104 +# define PKCS12_R_INVALID_NULL_PKCS12_POINTER 105 +# define PKCS12_R_IV_GEN_ERROR 106 +# define PKCS12_R_KEY_GEN_ERROR 107 +# define PKCS12_R_MAC_ABSENT 108 +# define PKCS12_R_MAC_GENERATION_ERROR 109 +# define PKCS12_R_MAC_SETUP_ERROR 110 +# define PKCS12_R_MAC_STRING_SET_ERROR 111 +# define PKCS12_R_MAC_VERIFY_FAILURE 113 +# define PKCS12_R_PARSE_ERROR 114 +# define PKCS12_R_PKCS12_ALGOR_CIPHERINIT_ERROR 115 +# define PKCS12_R_PKCS12_CIPHERFINAL_ERROR 116 +# define PKCS12_R_PKCS12_PBE_CRYPT_ERROR 117 +# define PKCS12_R_UNKNOWN_DIGEST_ALGORITHM 118 +# define PKCS12_R_UNSUPPORTED_PKCS12_MODE 119 + +#endif diff --git a/include/openssl/pkcs7.h b/include/openssl/pkcs7.h new file mode 100644 index 0000000..8c805d2 --- /dev/null +++ b/include/openssl/pkcs7.h @@ -0,0 +1,319 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PKCS7_H +# define HEADER_PKCS7_H + +# include +# include +# include + +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/*- +Encryption_ID DES-CBC +Digest_ID MD5 +Digest_Encryption_ID rsaEncryption +Key_Encryption_ID rsaEncryption +*/ + +typedef struct pkcs7_issuer_and_serial_st { + X509_NAME *issuer; + ASN1_INTEGER *serial; +} PKCS7_ISSUER_AND_SERIAL; + +typedef struct pkcs7_signer_info_st { + ASN1_INTEGER *version; /* version 1 */ + PKCS7_ISSUER_AND_SERIAL *issuer_and_serial; + X509_ALGOR *digest_alg; + STACK_OF(X509_ATTRIBUTE) *auth_attr; /* [ 0 ] */ + X509_ALGOR *digest_enc_alg; + ASN1_OCTET_STRING *enc_digest; + STACK_OF(X509_ATTRIBUTE) *unauth_attr; /* [ 1 ] */ + /* The private key to sign with */ + EVP_PKEY *pkey; +} PKCS7_SIGNER_INFO; + +DEFINE_STACK_OF(PKCS7_SIGNER_INFO) + +typedef struct pkcs7_recip_info_st { + ASN1_INTEGER *version; /* version 0 */ + PKCS7_ISSUER_AND_SERIAL *issuer_and_serial; + X509_ALGOR *key_enc_algor; + ASN1_OCTET_STRING *enc_key; + X509 *cert; /* get the pub-key from this */ +} PKCS7_RECIP_INFO; + +DEFINE_STACK_OF(PKCS7_RECIP_INFO) + +typedef struct pkcs7_signed_st { + ASN1_INTEGER *version; /* version 1 */ + STACK_OF(X509_ALGOR) *md_algs; /* md used */ + STACK_OF(X509) *cert; /* [ 0 ] */ + STACK_OF(X509_CRL) *crl; /* [ 1 ] */ + STACK_OF(PKCS7_SIGNER_INFO) *signer_info; + struct pkcs7_st *contents; +} PKCS7_SIGNED; +/* + * The above structure is very very similar to PKCS7_SIGN_ENVELOPE. How about + * merging the two + */ + +typedef struct pkcs7_enc_content_st { + ASN1_OBJECT *content_type; + X509_ALGOR *algorithm; + ASN1_OCTET_STRING *enc_data; /* [ 0 ] */ + const EVP_CIPHER *cipher; +} PKCS7_ENC_CONTENT; + +typedef struct pkcs7_enveloped_st { + ASN1_INTEGER *version; /* version 0 */ + STACK_OF(PKCS7_RECIP_INFO) *recipientinfo; + PKCS7_ENC_CONTENT *enc_data; +} PKCS7_ENVELOPE; + +typedef struct pkcs7_signedandenveloped_st { + ASN1_INTEGER *version; /* version 1 */ + STACK_OF(X509_ALGOR) *md_algs; /* md used */ + STACK_OF(X509) *cert; /* [ 0 ] */ + STACK_OF(X509_CRL) *crl; /* [ 1 ] */ + STACK_OF(PKCS7_SIGNER_INFO) *signer_info; + PKCS7_ENC_CONTENT *enc_data; + STACK_OF(PKCS7_RECIP_INFO) *recipientinfo; +} PKCS7_SIGN_ENVELOPE; + +typedef struct pkcs7_digest_st { + ASN1_INTEGER *version; /* version 0 */ + X509_ALGOR *md; /* md used */ + struct pkcs7_st *contents; + ASN1_OCTET_STRING *digest; +} PKCS7_DIGEST; + +typedef struct pkcs7_encrypted_st { + ASN1_INTEGER *version; /* version 0 */ + PKCS7_ENC_CONTENT *enc_data; +} PKCS7_ENCRYPT; + +typedef struct pkcs7_st { + /* + * The following is non NULL if it contains ASN1 encoding of this + * structure + */ + unsigned char *asn1; + long length; +# define PKCS7_S_HEADER 0 +# define PKCS7_S_BODY 1 +# define PKCS7_S_TAIL 2 + int state; /* used during processing */ + int detached; + ASN1_OBJECT *type; + /* content as defined by the type */ + /* + * all encryption/message digests are applied to the 'contents', leaving + * out the 'type' field. + */ + union { + char *ptr; + /* NID_pkcs7_data */ + ASN1_OCTET_STRING *data; + /* NID_pkcs7_signed */ + PKCS7_SIGNED *sign; + /* NID_pkcs7_enveloped */ + PKCS7_ENVELOPE *enveloped; + /* NID_pkcs7_signedAndEnveloped */ + PKCS7_SIGN_ENVELOPE *signed_and_enveloped; + /* NID_pkcs7_digest */ + PKCS7_DIGEST *digest; + /* NID_pkcs7_encrypted */ + PKCS7_ENCRYPT *encrypted; + /* Anything else */ + ASN1_TYPE *other; + } d; +} PKCS7; + +DEFINE_STACK_OF(PKCS7) + +# define PKCS7_OP_SET_DETACHED_SIGNATURE 1 +# define PKCS7_OP_GET_DETACHED_SIGNATURE 2 + +# define PKCS7_get_signed_attributes(si) ((si)->auth_attr) +# define PKCS7_get_attributes(si) ((si)->unauth_attr) + +# define PKCS7_type_is_signed(a) (OBJ_obj2nid((a)->type) == NID_pkcs7_signed) +# define PKCS7_type_is_encrypted(a) (OBJ_obj2nid((a)->type) == NID_pkcs7_encrypted) +# define PKCS7_type_is_enveloped(a) (OBJ_obj2nid((a)->type) == NID_pkcs7_enveloped) +# define PKCS7_type_is_signedAndEnveloped(a) \ + (OBJ_obj2nid((a)->type) == NID_pkcs7_signedAndEnveloped) +# define PKCS7_type_is_data(a) (OBJ_obj2nid((a)->type) == NID_pkcs7_data) +# define PKCS7_type_is_digest(a) (OBJ_obj2nid((a)->type) == NID_pkcs7_digest) + +# define PKCS7_set_detached(p,v) \ + PKCS7_ctrl(p,PKCS7_OP_SET_DETACHED_SIGNATURE,v,NULL) +# define PKCS7_get_detached(p) \ + PKCS7_ctrl(p,PKCS7_OP_GET_DETACHED_SIGNATURE,0,NULL) + +# define PKCS7_is_detached(p7) (PKCS7_type_is_signed(p7) && PKCS7_get_detached(p7)) + +/* S/MIME related flags */ + +# define PKCS7_TEXT 0x1 +# define PKCS7_NOCERTS 0x2 +# define PKCS7_NOSIGS 0x4 +# define PKCS7_NOCHAIN 0x8 +# define PKCS7_NOINTERN 0x10 +# define PKCS7_NOVERIFY 0x20 +# define PKCS7_DETACHED 0x40 +# define PKCS7_BINARY 0x80 +# define PKCS7_NOATTR 0x100 +# define PKCS7_NOSMIMECAP 0x200 +# define PKCS7_NOOLDMIMETYPE 0x400 +# define PKCS7_CRLFEOL 0x800 +# define PKCS7_STREAM 0x1000 +# define PKCS7_NOCRL 0x2000 +# define PKCS7_PARTIAL 0x4000 +# define PKCS7_REUSE_DIGEST 0x8000 +# define PKCS7_NO_DUAL_CONTENT 0x10000 + +/* Flags: for compatibility with older code */ + +# define SMIME_TEXT PKCS7_TEXT +# define SMIME_NOCERTS PKCS7_NOCERTS +# define SMIME_NOSIGS PKCS7_NOSIGS +# define SMIME_NOCHAIN PKCS7_NOCHAIN +# define SMIME_NOINTERN PKCS7_NOINTERN +# define SMIME_NOVERIFY PKCS7_NOVERIFY +# define SMIME_DETACHED PKCS7_DETACHED +# define SMIME_BINARY PKCS7_BINARY +# define SMIME_NOATTR PKCS7_NOATTR + +/* CRLF ASCII canonicalisation */ +# define SMIME_ASCIICRLF 0x80000 + +DECLARE_ASN1_FUNCTIONS(PKCS7_ISSUER_AND_SERIAL) + +int PKCS7_ISSUER_AND_SERIAL_digest(PKCS7_ISSUER_AND_SERIAL *data, + const EVP_MD *type, unsigned char *md, + unsigned int *len); +# ifndef OPENSSL_NO_STDIO +PKCS7 *d2i_PKCS7_fp(FILE *fp, PKCS7 **p7); +int i2d_PKCS7_fp(FILE *fp, PKCS7 *p7); +# endif +PKCS7 *PKCS7_dup(PKCS7 *p7); +PKCS7 *d2i_PKCS7_bio(BIO *bp, PKCS7 **p7); +int i2d_PKCS7_bio(BIO *bp, PKCS7 *p7); +int i2d_PKCS7_bio_stream(BIO *out, PKCS7 *p7, BIO *in, int flags); +int PEM_write_bio_PKCS7_stream(BIO *out, PKCS7 *p7, BIO *in, int flags); + +DECLARE_ASN1_FUNCTIONS(PKCS7_SIGNER_INFO) +DECLARE_ASN1_FUNCTIONS(PKCS7_RECIP_INFO) +DECLARE_ASN1_FUNCTIONS(PKCS7_SIGNED) +DECLARE_ASN1_FUNCTIONS(PKCS7_ENC_CONTENT) +DECLARE_ASN1_FUNCTIONS(PKCS7_ENVELOPE) +DECLARE_ASN1_FUNCTIONS(PKCS7_SIGN_ENVELOPE) +DECLARE_ASN1_FUNCTIONS(PKCS7_DIGEST) +DECLARE_ASN1_FUNCTIONS(PKCS7_ENCRYPT) +DECLARE_ASN1_FUNCTIONS(PKCS7) + +DECLARE_ASN1_ITEM(PKCS7_ATTR_SIGN) +DECLARE_ASN1_ITEM(PKCS7_ATTR_VERIFY) + +DECLARE_ASN1_NDEF_FUNCTION(PKCS7) +DECLARE_ASN1_PRINT_FUNCTION(PKCS7) + +long PKCS7_ctrl(PKCS7 *p7, int cmd, long larg, char *parg); + +int PKCS7_set_type(PKCS7 *p7, int type); +int PKCS7_set0_type_other(PKCS7 *p7, int type, ASN1_TYPE *other); +int PKCS7_set_content(PKCS7 *p7, PKCS7 *p7_data); +int PKCS7_SIGNER_INFO_set(PKCS7_SIGNER_INFO *p7i, X509 *x509, EVP_PKEY *pkey, + const EVP_MD *dgst); +int PKCS7_SIGNER_INFO_sign(PKCS7_SIGNER_INFO *si); +int PKCS7_add_signer(PKCS7 *p7, PKCS7_SIGNER_INFO *p7i); +int PKCS7_add_certificate(PKCS7 *p7, X509 *x509); +int PKCS7_add_crl(PKCS7 *p7, X509_CRL *x509); +int PKCS7_content_new(PKCS7 *p7, int nid); +int PKCS7_dataVerify(X509_STORE *cert_store, X509_STORE_CTX *ctx, + BIO *bio, PKCS7 *p7, PKCS7_SIGNER_INFO *si); +int PKCS7_signatureVerify(BIO *bio, PKCS7 *p7, PKCS7_SIGNER_INFO *si, + X509 *x509); + +BIO *PKCS7_dataInit(PKCS7 *p7, BIO *bio); +int PKCS7_dataFinal(PKCS7 *p7, BIO *bio); +BIO *PKCS7_dataDecode(PKCS7 *p7, EVP_PKEY *pkey, BIO *in_bio, X509 *pcert); + +PKCS7_SIGNER_INFO *PKCS7_add_signature(PKCS7 *p7, X509 *x509, + EVP_PKEY *pkey, const EVP_MD *dgst); +X509 *PKCS7_cert_from_signer_info(PKCS7 *p7, PKCS7_SIGNER_INFO *si); +int PKCS7_set_digest(PKCS7 *p7, const EVP_MD *md); +STACK_OF(PKCS7_SIGNER_INFO) *PKCS7_get_signer_info(PKCS7 *p7); + +PKCS7_RECIP_INFO *PKCS7_add_recipient(PKCS7 *p7, X509 *x509); +void PKCS7_SIGNER_INFO_get0_algs(PKCS7_SIGNER_INFO *si, EVP_PKEY **pk, + X509_ALGOR **pdig, X509_ALGOR **psig); +void PKCS7_RECIP_INFO_get0_alg(PKCS7_RECIP_INFO *ri, X509_ALGOR **penc); +int PKCS7_add_recipient_info(PKCS7 *p7, PKCS7_RECIP_INFO *ri); +int PKCS7_RECIP_INFO_set(PKCS7_RECIP_INFO *p7i, X509 *x509); +int PKCS7_set_cipher(PKCS7 *p7, const EVP_CIPHER *cipher); +int PKCS7_stream(unsigned char ***boundary, PKCS7 *p7); + +PKCS7_ISSUER_AND_SERIAL *PKCS7_get_issuer_and_serial(PKCS7 *p7, int idx); +ASN1_OCTET_STRING *PKCS7_digest_from_attributes(STACK_OF(X509_ATTRIBUTE) *sk); +int PKCS7_add_signed_attribute(PKCS7_SIGNER_INFO *p7si, int nid, int type, + void *data); +int PKCS7_add_attribute(PKCS7_SIGNER_INFO *p7si, int nid, int atrtype, + void *value); +ASN1_TYPE *PKCS7_get_attribute(PKCS7_SIGNER_INFO *si, int nid); +ASN1_TYPE *PKCS7_get_signed_attribute(PKCS7_SIGNER_INFO *si, int nid); +int PKCS7_set_signed_attributes(PKCS7_SIGNER_INFO *p7si, + STACK_OF(X509_ATTRIBUTE) *sk); +int PKCS7_set_attributes(PKCS7_SIGNER_INFO *p7si, + STACK_OF(X509_ATTRIBUTE) *sk); + +PKCS7 *PKCS7_sign(X509 *signcert, EVP_PKEY *pkey, STACK_OF(X509) *certs, + BIO *data, int flags); + +PKCS7_SIGNER_INFO *PKCS7_sign_add_signer(PKCS7 *p7, + X509 *signcert, EVP_PKEY *pkey, + const EVP_MD *md, int flags); + +int PKCS7_final(PKCS7 *p7, BIO *data, int flags); +int PKCS7_verify(PKCS7 *p7, STACK_OF(X509) *certs, X509_STORE *store, + BIO *indata, BIO *out, int flags); +STACK_OF(X509) *PKCS7_get0_signers(PKCS7 *p7, STACK_OF(X509) *certs, + int flags); +PKCS7 *PKCS7_encrypt(STACK_OF(X509) *certs, BIO *in, const EVP_CIPHER *cipher, + int flags); +int PKCS7_decrypt(PKCS7 *p7, EVP_PKEY *pkey, X509 *cert, BIO *data, + int flags); + +int PKCS7_add_attrib_smimecap(PKCS7_SIGNER_INFO *si, + STACK_OF(X509_ALGOR) *cap); +STACK_OF(X509_ALGOR) *PKCS7_get_smimecap(PKCS7_SIGNER_INFO *si); +int PKCS7_simple_smimecap(STACK_OF(X509_ALGOR) *sk, int nid, int arg); + +int PKCS7_add_attrib_content_type(PKCS7_SIGNER_INFO *si, ASN1_OBJECT *coid); +int PKCS7_add0_attrib_signing_time(PKCS7_SIGNER_INFO *si, ASN1_TIME *t); +int PKCS7_add1_attrib_digest(PKCS7_SIGNER_INFO *si, + const unsigned char *md, int mdlen); + +int SMIME_write_PKCS7(BIO *bio, PKCS7 *p7, BIO *data, int flags); +PKCS7 *SMIME_read_PKCS7(BIO *bio, BIO **bcont); + +BIO *BIO_new_PKCS7(BIO *out, PKCS7 *p7); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/pkcs7err.h b/include/openssl/pkcs7err.h new file mode 100644 index 0000000..0ba418d --- /dev/null +++ b/include/openssl/pkcs7err.h @@ -0,0 +1,99 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_PKCS7ERR_H +# define HEADER_PKCS7ERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_PKCS7_strings(void); + +/* + * PKCS7 function codes. + */ +# define PKCS7_F_DO_PKCS7_SIGNED_ATTRIB 136 +# define PKCS7_F_PKCS7_ADD0_ATTRIB_SIGNING_TIME 135 +# define PKCS7_F_PKCS7_ADD_ATTRIB_SMIMECAP 118 +# define PKCS7_F_PKCS7_ADD_CERTIFICATE 100 +# define PKCS7_F_PKCS7_ADD_CRL 101 +# define PKCS7_F_PKCS7_ADD_RECIPIENT_INFO 102 +# define PKCS7_F_PKCS7_ADD_SIGNATURE 131 +# define PKCS7_F_PKCS7_ADD_SIGNER 103 +# define PKCS7_F_PKCS7_BIO_ADD_DIGEST 125 +# define PKCS7_F_PKCS7_COPY_EXISTING_DIGEST 138 +# define PKCS7_F_PKCS7_CTRL 104 +# define PKCS7_F_PKCS7_DATADECODE 112 +# define PKCS7_F_PKCS7_DATAFINAL 128 +# define PKCS7_F_PKCS7_DATAINIT 105 +# define PKCS7_F_PKCS7_DATAVERIFY 107 +# define PKCS7_F_PKCS7_DECRYPT 114 +# define PKCS7_F_PKCS7_DECRYPT_RINFO 133 +# define PKCS7_F_PKCS7_ENCODE_RINFO 132 +# define PKCS7_F_PKCS7_ENCRYPT 115 +# define PKCS7_F_PKCS7_FINAL 134 +# define PKCS7_F_PKCS7_FIND_DIGEST 127 +# define PKCS7_F_PKCS7_GET0_SIGNERS 124 +# define PKCS7_F_PKCS7_RECIP_INFO_SET 130 +# define PKCS7_F_PKCS7_SET_CIPHER 108 +# define PKCS7_F_PKCS7_SET_CONTENT 109 +# define PKCS7_F_PKCS7_SET_DIGEST 126 +# define PKCS7_F_PKCS7_SET_TYPE 110 +# define PKCS7_F_PKCS7_SIGN 116 +# define PKCS7_F_PKCS7_SIGNATUREVERIFY 113 +# define PKCS7_F_PKCS7_SIGNER_INFO_SET 129 +# define PKCS7_F_PKCS7_SIGNER_INFO_SIGN 139 +# define PKCS7_F_PKCS7_SIGN_ADD_SIGNER 137 +# define PKCS7_F_PKCS7_SIMPLE_SMIMECAP 119 +# define PKCS7_F_PKCS7_VERIFY 117 + +/* + * PKCS7 reason codes. + */ +# define PKCS7_R_CERTIFICATE_VERIFY_ERROR 117 +# define PKCS7_R_CIPHER_HAS_NO_OBJECT_IDENTIFIER 144 +# define PKCS7_R_CIPHER_NOT_INITIALIZED 116 +# define PKCS7_R_CONTENT_AND_DATA_PRESENT 118 +# define PKCS7_R_CTRL_ERROR 152 +# define PKCS7_R_DECRYPT_ERROR 119 +# define PKCS7_R_DIGEST_FAILURE 101 +# define PKCS7_R_ENCRYPTION_CTRL_FAILURE 149 +# define PKCS7_R_ENCRYPTION_NOT_SUPPORTED_FOR_THIS_KEY_TYPE 150 +# define PKCS7_R_ERROR_ADDING_RECIPIENT 120 +# define PKCS7_R_ERROR_SETTING_CIPHER 121 +# define PKCS7_R_INVALID_NULL_POINTER 143 +# define PKCS7_R_INVALID_SIGNED_DATA_TYPE 155 +# define PKCS7_R_NO_CONTENT 122 +# define PKCS7_R_NO_DEFAULT_DIGEST 151 +# define PKCS7_R_NO_MATCHING_DIGEST_TYPE_FOUND 154 +# define PKCS7_R_NO_RECIPIENT_MATCHES_CERTIFICATE 115 +# define PKCS7_R_NO_SIGNATURES_ON_DATA 123 +# define PKCS7_R_NO_SIGNERS 142 +# define PKCS7_R_OPERATION_NOT_SUPPORTED_ON_THIS_TYPE 104 +# define PKCS7_R_PKCS7_ADD_SIGNATURE_ERROR 124 +# define PKCS7_R_PKCS7_ADD_SIGNER_ERROR 153 +# define PKCS7_R_PKCS7_DATASIGN 145 +# define PKCS7_R_PRIVATE_KEY_DOES_NOT_MATCH_CERTIFICATE 127 +# define PKCS7_R_SIGNATURE_FAILURE 105 +# define PKCS7_R_SIGNER_CERTIFICATE_NOT_FOUND 128 +# define PKCS7_R_SIGNING_CTRL_FAILURE 147 +# define PKCS7_R_SIGNING_NOT_SUPPORTED_FOR_THIS_KEY_TYPE 148 +# define PKCS7_R_SMIME_TEXT_ERROR 129 +# define PKCS7_R_UNABLE_TO_FIND_CERTIFICATE 106 +# define PKCS7_R_UNABLE_TO_FIND_MEM_BIO 107 +# define PKCS7_R_UNABLE_TO_FIND_MESSAGE_DIGEST 108 +# define PKCS7_R_UNKNOWN_DIGEST_TYPE 109 +# define PKCS7_R_UNKNOWN_OPERATION 110 +# define PKCS7_R_UNSUPPORTED_CIPHER_TYPE 111 +# define PKCS7_R_UNSUPPORTED_CONTENT_TYPE 112 +# define PKCS7_R_WRONG_CONTENT_TYPE 113 +# define PKCS7_R_WRONG_PKCS7_TYPE 114 + +#endif diff --git a/include/openssl/rand.h b/include/openssl/rand.h new file mode 100644 index 0000000..3f80276 --- /dev/null +++ b/include/openssl/rand.h @@ -0,0 +1,77 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RAND_H +# define HEADER_RAND_H + +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +struct rand_meth_st { + int (*seed) (const void *buf, int num); + int (*bytes) (unsigned char *buf, int num); + void (*cleanup) (void); + int (*add) (const void *buf, int num, double randomness); + int (*pseudorand) (unsigned char *buf, int num); + int (*status) (void); +}; + +int RAND_set_rand_method(const RAND_METHOD *meth); +const RAND_METHOD *RAND_get_rand_method(void); +# ifndef OPENSSL_NO_ENGINE +int RAND_set_rand_engine(ENGINE *engine); +# endif + +RAND_METHOD *RAND_OpenSSL(void); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define RAND_cleanup() while(0) continue +# endif +int RAND_bytes(unsigned char *buf, int num); +int RAND_priv_bytes(unsigned char *buf, int num); +DEPRECATEDIN_1_1_0(int RAND_pseudo_bytes(unsigned char *buf, int num)) + +void RAND_seed(const void *buf, int num); +void RAND_keep_random_devices_open(int keep); + +# if defined(__ANDROID__) && defined(__NDK_FPABI__) +__NDK_FPABI__ /* __attribute__((pcs("aapcs"))) on ARM */ +# endif +void RAND_add(const void *buf, int num, double randomness); +int RAND_load_file(const char *file, long max_bytes); +int RAND_write_file(const char *file); +const char *RAND_file_name(char *file, size_t num); +int RAND_status(void); + +# ifndef OPENSSL_NO_EGD +int RAND_query_egd_bytes(const char *path, unsigned char *buf, int bytes); +int RAND_egd(const char *path); +int RAND_egd_bytes(const char *path, int bytes); +# endif + +int RAND_poll(void); + +# if defined(_WIN32) && (defined(BASETYPES) || defined(_WINDEF_H)) +/* application has to include in order to use these */ +DEPRECATEDIN_1_1_0(void RAND_screen(void)) +DEPRECATEDIN_1_1_0(int RAND_event(UINT, WPARAM, LPARAM)) +# endif + + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/rand_drbg.h b/include/openssl/rand_drbg.h new file mode 100644 index 0000000..34aea6f --- /dev/null +++ b/include/openssl/rand_drbg.h @@ -0,0 +1,120 @@ +/* + * Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_DRBG_RAND_H +# define HEADER_DRBG_RAND_H + +# include +# include + + +/* In CTR mode, disable derivation function ctr_df */ +# define RAND_DRBG_FLAG_CTR_NO_DF 0x1 + +/* A logical OR of all used flag bits (currently there is only one) */ +# define RAND_DRBG_USED_FLAGS ( \ + RAND_DRBG_FLAG_CTR_NO_DF \ + ) + +/* + * Default security strength (in the sense of [NIST SP 800-90Ar1]) + * + * NIST SP 800-90Ar1 supports the strength of the DRBG being smaller than that + * of the cipher by collecting less entropy. The current DRBG implemantion does + * not take RAND_DRBG_STRENGTH into account and sets the strength of the DRBG + * to that of the cipher. + * + * RAND_DRBG_STRENGTH is currently only used for the legacy RAND + * implementation. + * + * Currently supported ciphers are: NID_aes_128_ctr, NID_aes_192_ctr and + * NID_aes_256_ctr + */ +# define RAND_DRBG_STRENGTH 256 +# define RAND_DRBG_TYPE NID_aes_256_ctr +# define RAND_DRBG_FLAGS 0 + + +# ifdef __cplusplus +extern "C" { +# endif + +/* + * Object lifetime functions. + */ +RAND_DRBG *RAND_DRBG_new(int type, unsigned int flags, RAND_DRBG *parent); +RAND_DRBG *RAND_DRBG_secure_new(int type, unsigned int flags, RAND_DRBG *parent); +int RAND_DRBG_set(RAND_DRBG *drbg, int type, unsigned int flags); +int RAND_DRBG_set_defaults(int type, unsigned int flags); +int RAND_DRBG_instantiate(RAND_DRBG *drbg, + const unsigned char *pers, size_t perslen); +int RAND_DRBG_uninstantiate(RAND_DRBG *drbg); +void RAND_DRBG_free(RAND_DRBG *drbg); + +/* + * Object "use" functions. + */ +int RAND_DRBG_reseed(RAND_DRBG *drbg, + const unsigned char *adin, size_t adinlen, + int prediction_resistance); +int RAND_DRBG_generate(RAND_DRBG *drbg, unsigned char *out, size_t outlen, + int prediction_resistance, + const unsigned char *adin, size_t adinlen); +int RAND_DRBG_bytes(RAND_DRBG *drbg, unsigned char *out, size_t outlen); + +int RAND_DRBG_set_reseed_interval(RAND_DRBG *drbg, unsigned int interval); +int RAND_DRBG_set_reseed_time_interval(RAND_DRBG *drbg, time_t interval); + +int RAND_DRBG_set_reseed_defaults( + unsigned int master_reseed_interval, + unsigned int slave_reseed_interval, + time_t master_reseed_time_interval, + time_t slave_reseed_time_interval + ); + +RAND_DRBG *RAND_DRBG_get0_master(void); +RAND_DRBG *RAND_DRBG_get0_public(void); +RAND_DRBG *RAND_DRBG_get0_private(void); + +/* + * EXDATA + */ +# define RAND_DRBG_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_DRBG, l, p, newf, dupf, freef) +int RAND_DRBG_set_ex_data(RAND_DRBG *drbg, int idx, void *arg); +void *RAND_DRBG_get_ex_data(const RAND_DRBG *drbg, int idx); + +/* + * Callback function typedefs + */ +typedef size_t (*RAND_DRBG_get_entropy_fn)(RAND_DRBG *drbg, + unsigned char **pout, + int entropy, size_t min_len, + size_t max_len, + int prediction_resistance); +typedef void (*RAND_DRBG_cleanup_entropy_fn)(RAND_DRBG *ctx, + unsigned char *out, size_t outlen); +typedef size_t (*RAND_DRBG_get_nonce_fn)(RAND_DRBG *drbg, unsigned char **pout, + int entropy, size_t min_len, + size_t max_len); +typedef void (*RAND_DRBG_cleanup_nonce_fn)(RAND_DRBG *drbg, + unsigned char *out, size_t outlen); + +int RAND_DRBG_set_callbacks(RAND_DRBG *drbg, + RAND_DRBG_get_entropy_fn get_entropy, + RAND_DRBG_cleanup_entropy_fn cleanup_entropy, + RAND_DRBG_get_nonce_fn get_nonce, + RAND_DRBG_cleanup_nonce_fn cleanup_nonce); + + +# ifdef __cplusplus +} +# endif + +#endif diff --git a/include/openssl/randerr.h b/include/openssl/randerr.h new file mode 100644 index 0000000..128f4de --- /dev/null +++ b/include/openssl/randerr.h @@ -0,0 +1,88 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RANDERR_H +# define HEADER_RANDERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_RAND_strings(void); + +/* + * RAND function codes. + */ +# define RAND_F_DRBG_BYTES 101 +# define RAND_F_DRBG_GET_ENTROPY 105 +# define RAND_F_DRBG_SETUP 117 +# define RAND_F_GET_ENTROPY 106 +# define RAND_F_RAND_BYTES 100 +# define RAND_F_RAND_DRBG_ENABLE_LOCKING 119 +# define RAND_F_RAND_DRBG_GENERATE 107 +# define RAND_F_RAND_DRBG_GET_ENTROPY 120 +# define RAND_F_RAND_DRBG_GET_NONCE 123 +# define RAND_F_RAND_DRBG_INSTANTIATE 108 +# define RAND_F_RAND_DRBG_NEW 109 +# define RAND_F_RAND_DRBG_RESEED 110 +# define RAND_F_RAND_DRBG_RESTART 102 +# define RAND_F_RAND_DRBG_SET 104 +# define RAND_F_RAND_DRBG_SET_DEFAULTS 121 +# define RAND_F_RAND_DRBG_UNINSTANTIATE 118 +# define RAND_F_RAND_LOAD_FILE 111 +# define RAND_F_RAND_POOL_ACQUIRE_ENTROPY 122 +# define RAND_F_RAND_POOL_ADD 103 +# define RAND_F_RAND_POOL_ADD_BEGIN 113 +# define RAND_F_RAND_POOL_ADD_END 114 +# define RAND_F_RAND_POOL_BYTES_NEEDED 115 +# define RAND_F_RAND_POOL_NEW 116 +# define RAND_F_RAND_WRITE_FILE 112 + +/* + * RAND reason codes. + */ +# define RAND_R_ADDITIONAL_INPUT_TOO_LONG 102 +# define RAND_R_ALREADY_INSTANTIATED 103 +# define RAND_R_ARGUMENT_OUT_OF_RANGE 105 +# define RAND_R_CANNOT_OPEN_FILE 121 +# define RAND_R_DRBG_ALREADY_INITIALIZED 129 +# define RAND_R_DRBG_NOT_INITIALISED 104 +# define RAND_R_ENTROPY_INPUT_TOO_LONG 106 +# define RAND_R_ENTROPY_OUT_OF_RANGE 124 +# define RAND_R_ERROR_ENTROPY_POOL_WAS_IGNORED 127 +# define RAND_R_ERROR_INITIALISING_DRBG 107 +# define RAND_R_ERROR_INSTANTIATING_DRBG 108 +# define RAND_R_ERROR_RETRIEVING_ADDITIONAL_INPUT 109 +# define RAND_R_ERROR_RETRIEVING_ENTROPY 110 +# define RAND_R_ERROR_RETRIEVING_NONCE 111 +# define RAND_R_FAILED_TO_CREATE_LOCK 126 +# define RAND_R_FUNC_NOT_IMPLEMENTED 101 +# define RAND_R_FWRITE_ERROR 123 +# define RAND_R_GENERATE_ERROR 112 +# define RAND_R_INTERNAL_ERROR 113 +# define RAND_R_IN_ERROR_STATE 114 +# define RAND_R_NOT_A_REGULAR_FILE 122 +# define RAND_R_NOT_INSTANTIATED 115 +# define RAND_R_NO_DRBG_IMPLEMENTATION_SELECTED 128 +# define RAND_R_PARENT_LOCKING_NOT_ENABLED 130 +# define RAND_R_PARENT_STRENGTH_TOO_WEAK 131 +# define RAND_R_PERSONALISATION_STRING_TOO_LONG 116 +# define RAND_R_PREDICTION_RESISTANCE_NOT_SUPPORTED 133 +# define RAND_R_PRNG_NOT_SEEDED 100 +# define RAND_R_RANDOM_POOL_OVERFLOW 125 +# define RAND_R_RANDOM_POOL_UNDERFLOW 134 +# define RAND_R_REQUEST_TOO_LARGE_FOR_DRBG 117 +# define RAND_R_RESEED_ERROR 118 +# define RAND_R_SELFTEST_FAILURE 119 +# define RAND_R_TOO_LITTLE_NONCE_REQUESTED 135 +# define RAND_R_TOO_MUCH_NONCE_REQUESTED 136 +# define RAND_R_UNSUPPORTED_DRBG_FLAGS 132 +# define RAND_R_UNSUPPORTED_DRBG_TYPE 120 + +#endif diff --git a/include/openssl/rc2.h b/include/openssl/rc2.h new file mode 100644 index 0000000..6046ac5 --- /dev/null +++ b/include/openssl/rc2.h @@ -0,0 +1,51 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RC2_H +# define HEADER_RC2_H + +# include + +# ifndef OPENSSL_NO_RC2 +# ifdef __cplusplus +extern "C" { +# endif + +typedef unsigned int RC2_INT; + +# define RC2_ENCRYPT 1 +# define RC2_DECRYPT 0 + +# define RC2_BLOCK 8 +# define RC2_KEY_LENGTH 16 + +typedef struct rc2_key_st { + RC2_INT data[64]; +} RC2_KEY; + +void RC2_set_key(RC2_KEY *key, int len, const unsigned char *data, int bits); +void RC2_ecb_encrypt(const unsigned char *in, unsigned char *out, + RC2_KEY *key, int enc); +void RC2_encrypt(unsigned long *data, RC2_KEY *key); +void RC2_decrypt(unsigned long *data, RC2_KEY *key); +void RC2_cbc_encrypt(const unsigned char *in, unsigned char *out, long length, + RC2_KEY *ks, unsigned char *iv, int enc); +void RC2_cfb64_encrypt(const unsigned char *in, unsigned char *out, + long length, RC2_KEY *schedule, unsigned char *ivec, + int *num, int enc); +void RC2_ofb64_encrypt(const unsigned char *in, unsigned char *out, + long length, RC2_KEY *schedule, unsigned char *ivec, + int *num); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/rc4.h b/include/openssl/rc4.h new file mode 100644 index 0000000..a0b3206 --- /dev/null +++ b/include/openssl/rc4.h @@ -0,0 +1,36 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RC4_H +# define HEADER_RC4_H + +# include + +# ifndef OPENSSL_NO_RC4 +# include +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct rc4_key_st { + RC4_INT x, y; + RC4_INT data[256]; +} RC4_KEY; + +const char *RC4_options(void); +void RC4_set_key(RC4_KEY *key, int len, const unsigned char *data); +void RC4(RC4_KEY *key, size_t len, const unsigned char *indata, + unsigned char *outdata); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/rc5.h b/include/openssl/rc5.h new file mode 100644 index 0000000..a64f6ba --- /dev/null +++ b/include/openssl/rc5.h @@ -0,0 +1,63 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RC5_H +# define HEADER_RC5_H + +# include + +# ifndef OPENSSL_NO_RC5 +# ifdef __cplusplus +extern "C" { +# endif + +# define RC5_ENCRYPT 1 +# define RC5_DECRYPT 0 + +# define RC5_32_INT unsigned int + +# define RC5_32_BLOCK 8 +# define RC5_32_KEY_LENGTH 16/* This is a default, max is 255 */ + +/* + * This are the only values supported. Tweak the code if you want more The + * most supported modes will be RC5-32/12/16 RC5-32/16/8 + */ +# define RC5_8_ROUNDS 8 +# define RC5_12_ROUNDS 12 +# define RC5_16_ROUNDS 16 + +typedef struct rc5_key_st { + /* Number of rounds */ + int rounds; + RC5_32_INT data[2 * (RC5_16_ROUNDS + 1)]; +} RC5_32_KEY; + +void RC5_32_set_key(RC5_32_KEY *key, int len, const unsigned char *data, + int rounds); +void RC5_32_ecb_encrypt(const unsigned char *in, unsigned char *out, + RC5_32_KEY *key, int enc); +void RC5_32_encrypt(unsigned long *data, RC5_32_KEY *key); +void RC5_32_decrypt(unsigned long *data, RC5_32_KEY *key); +void RC5_32_cbc_encrypt(const unsigned char *in, unsigned char *out, + long length, RC5_32_KEY *ks, unsigned char *iv, + int enc); +void RC5_32_cfb64_encrypt(const unsigned char *in, unsigned char *out, + long length, RC5_32_KEY *schedule, + unsigned char *ivec, int *num, int enc); +void RC5_32_ofb64_encrypt(const unsigned char *in, unsigned char *out, + long length, RC5_32_KEY *schedule, + unsigned char *ivec, int *num); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/ripemd.h b/include/openssl/ripemd.h new file mode 100644 index 0000000..fa87102 --- /dev/null +++ b/include/openssl/ripemd.h @@ -0,0 +1,47 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RIPEMD_H +# define HEADER_RIPEMD_H + +# include + +#ifndef OPENSSL_NO_RMD160 +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +# define RIPEMD160_LONG unsigned int + +# define RIPEMD160_CBLOCK 64 +# define RIPEMD160_LBLOCK (RIPEMD160_CBLOCK/4) +# define RIPEMD160_DIGEST_LENGTH 20 + +typedef struct RIPEMD160state_st { + RIPEMD160_LONG A, B, C, D, E; + RIPEMD160_LONG Nl, Nh; + RIPEMD160_LONG data[RIPEMD160_LBLOCK]; + unsigned int num; +} RIPEMD160_CTX; + +int RIPEMD160_Init(RIPEMD160_CTX *c); +int RIPEMD160_Update(RIPEMD160_CTX *c, const void *data, size_t len); +int RIPEMD160_Final(unsigned char *md, RIPEMD160_CTX *c); +unsigned char *RIPEMD160(const unsigned char *d, size_t n, unsigned char *md); +void RIPEMD160_Transform(RIPEMD160_CTX *c, const unsigned char *b); + +# ifdef __cplusplus +} +# endif +# endif + + +#endif diff --git a/include/openssl/rsa.h b/include/openssl/rsa.h new file mode 100644 index 0000000..354d4db --- /dev/null +++ b/include/openssl/rsa.h @@ -0,0 +1,512 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RSA_H +# define HEADER_RSA_H + +# include + +# ifndef OPENSSL_NO_RSA +# include +# include +# include +# include +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# endif +# include +# ifdef __cplusplus +extern "C" { +# endif + +/* The types RSA and RSA_METHOD are defined in ossl_typ.h */ + +# ifndef OPENSSL_RSA_MAX_MODULUS_BITS +# define OPENSSL_RSA_MAX_MODULUS_BITS 16384 +# endif + +# define OPENSSL_RSA_FIPS_MIN_MODULUS_BITS 1024 + +# ifndef OPENSSL_RSA_SMALL_MODULUS_BITS +# define OPENSSL_RSA_SMALL_MODULUS_BITS 3072 +# endif +# ifndef OPENSSL_RSA_MAX_PUBEXP_BITS + +/* exponent limit enforced for "large" modulus only */ +# define OPENSSL_RSA_MAX_PUBEXP_BITS 64 +# endif + +# define RSA_3 0x3L +# define RSA_F4 0x10001L + +/* based on RFC 8017 appendix A.1.2 */ +# define RSA_ASN1_VERSION_DEFAULT 0 +# define RSA_ASN1_VERSION_MULTI 1 + +# define RSA_DEFAULT_PRIME_NUM 2 + +# define RSA_METHOD_FLAG_NO_CHECK 0x0001/* don't check pub/private + * match */ + +# define RSA_FLAG_CACHE_PUBLIC 0x0002 +# define RSA_FLAG_CACHE_PRIVATE 0x0004 +# define RSA_FLAG_BLINDING 0x0008 +# define RSA_FLAG_THREAD_SAFE 0x0010 +/* + * This flag means the private key operations will be handled by rsa_mod_exp + * and that they do not depend on the private key components being present: + * for example a key stored in external hardware. Without this flag + * bn_mod_exp gets called when private key components are absent. + */ +# define RSA_FLAG_EXT_PKEY 0x0020 + +/* + * new with 0.9.6j and 0.9.7b; the built-in + * RSA implementation now uses blinding by + * default (ignoring RSA_FLAG_BLINDING), + * but other engines might not need it + */ +# define RSA_FLAG_NO_BLINDING 0x0080 +# if OPENSSL_API_COMPAT < 0x10100000L +/* + * Does nothing. Previously this switched off constant time behaviour. + */ +# define RSA_FLAG_NO_CONSTTIME 0x0000 +# endif +# if OPENSSL_API_COMPAT < 0x00908000L +/* deprecated name for the flag*/ +/* + * new with 0.9.7h; the built-in RSA + * implementation now uses constant time + * modular exponentiation for secret exponents + * by default. This flag causes the + * faster variable sliding window method to + * be used for all exponents. + */ +# define RSA_FLAG_NO_EXP_CONSTTIME RSA_FLAG_NO_CONSTTIME +# endif + +# define EVP_PKEY_CTX_set_rsa_padding(ctx, pad) \ + RSA_pkey_ctx_ctrl(ctx, -1, EVP_PKEY_CTRL_RSA_PADDING, pad, NULL) + +# define EVP_PKEY_CTX_get_rsa_padding(ctx, ppad) \ + RSA_pkey_ctx_ctrl(ctx, -1, EVP_PKEY_CTRL_GET_RSA_PADDING, 0, ppad) + +# define EVP_PKEY_CTX_set_rsa_pss_saltlen(ctx, len) \ + RSA_pkey_ctx_ctrl(ctx, (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \ + EVP_PKEY_CTRL_RSA_PSS_SALTLEN, len, NULL) +/* Salt length matches digest */ +# define RSA_PSS_SALTLEN_DIGEST -1 +/* Verify only: auto detect salt length */ +# define RSA_PSS_SALTLEN_AUTO -2 +/* Set salt length to maximum possible */ +# define RSA_PSS_SALTLEN_MAX -3 +/* Old compatible max salt length for sign only */ +# define RSA_PSS_SALTLEN_MAX_SIGN -2 + +# define EVP_PKEY_CTX_set_rsa_pss_keygen_saltlen(ctx, len) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA_PSS, EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_RSA_PSS_SALTLEN, len, NULL) + +# define EVP_PKEY_CTX_get_rsa_pss_saltlen(ctx, plen) \ + RSA_pkey_ctx_ctrl(ctx, (EVP_PKEY_OP_SIGN|EVP_PKEY_OP_VERIFY), \ + EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN, 0, plen) + +# define EVP_PKEY_CTX_set_rsa_keygen_bits(ctx, bits) \ + RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_RSA_KEYGEN_BITS, bits, NULL) + +# define EVP_PKEY_CTX_set_rsa_keygen_pubexp(ctx, pubexp) \ + RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP, 0, pubexp) + +# define EVP_PKEY_CTX_set_rsa_keygen_primes(ctx, primes) \ + RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_RSA_KEYGEN_PRIMES, primes, NULL) + +# define EVP_PKEY_CTX_set_rsa_mgf1_md(ctx, md) \ + RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \ + EVP_PKEY_CTRL_RSA_MGF1_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_set_rsa_pss_keygen_mgf1_md(ctx, md) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA_PSS, EVP_PKEY_OP_KEYGEN, \ + EVP_PKEY_CTRL_RSA_MGF1_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_set_rsa_oaep_md(ctx, md) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ + EVP_PKEY_CTRL_RSA_OAEP_MD, 0, (void *)(md)) + +# define EVP_PKEY_CTX_get_rsa_mgf1_md(ctx, pmd) \ + RSA_pkey_ctx_ctrl(ctx, EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT, \ + EVP_PKEY_CTRL_GET_RSA_MGF1_MD, 0, (void *)(pmd)) + +# define EVP_PKEY_CTX_get_rsa_oaep_md(ctx, pmd) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ + EVP_PKEY_CTRL_GET_RSA_OAEP_MD, 0, (void *)(pmd)) + +# define EVP_PKEY_CTX_set0_rsa_oaep_label(ctx, l, llen) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ + EVP_PKEY_CTRL_RSA_OAEP_LABEL, llen, (void *)(l)) + +# define EVP_PKEY_CTX_get0_rsa_oaep_label(ctx, l) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA, EVP_PKEY_OP_TYPE_CRYPT, \ + EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL, 0, (void *)(l)) + +# define EVP_PKEY_CTX_set_rsa_pss_keygen_md(ctx, md) \ + EVP_PKEY_CTX_ctrl(ctx, EVP_PKEY_RSA_PSS, \ + EVP_PKEY_OP_TYPE_KEYGEN, EVP_PKEY_CTRL_MD, \ + 0, (void *)(md)) + +# define EVP_PKEY_CTRL_RSA_PADDING (EVP_PKEY_ALG_CTRL + 1) +# define EVP_PKEY_CTRL_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 2) + +# define EVP_PKEY_CTRL_RSA_KEYGEN_BITS (EVP_PKEY_ALG_CTRL + 3) +# define EVP_PKEY_CTRL_RSA_KEYGEN_PUBEXP (EVP_PKEY_ALG_CTRL + 4) +# define EVP_PKEY_CTRL_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 5) + +# define EVP_PKEY_CTRL_GET_RSA_PADDING (EVP_PKEY_ALG_CTRL + 6) +# define EVP_PKEY_CTRL_GET_RSA_PSS_SALTLEN (EVP_PKEY_ALG_CTRL + 7) +# define EVP_PKEY_CTRL_GET_RSA_MGF1_MD (EVP_PKEY_ALG_CTRL + 8) + +# define EVP_PKEY_CTRL_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 9) +# define EVP_PKEY_CTRL_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 10) + +# define EVP_PKEY_CTRL_GET_RSA_OAEP_MD (EVP_PKEY_ALG_CTRL + 11) +# define EVP_PKEY_CTRL_GET_RSA_OAEP_LABEL (EVP_PKEY_ALG_CTRL + 12) + +# define EVP_PKEY_CTRL_RSA_KEYGEN_PRIMES (EVP_PKEY_ALG_CTRL + 13) + +# define RSA_PKCS1_PADDING 1 +# define RSA_SSLV23_PADDING 2 +# define RSA_NO_PADDING 3 +# define RSA_PKCS1_OAEP_PADDING 4 +# define RSA_X931_PADDING 5 +/* EVP_PKEY_ only */ +# define RSA_PKCS1_PSS_PADDING 6 + +# define RSA_PKCS1_PADDING_SIZE 11 + +# define RSA_set_app_data(s,arg) RSA_set_ex_data(s,0,arg) +# define RSA_get_app_data(s) RSA_get_ex_data(s,0) + +RSA *RSA_new(void); +RSA *RSA_new_method(ENGINE *engine); +int RSA_bits(const RSA *rsa); +int RSA_size(const RSA *rsa); +int RSA_security_bits(const RSA *rsa); + +int RSA_set0_key(RSA *r, BIGNUM *n, BIGNUM *e, BIGNUM *d); +int RSA_set0_factors(RSA *r, BIGNUM *p, BIGNUM *q); +int RSA_set0_crt_params(RSA *r,BIGNUM *dmp1, BIGNUM *dmq1, BIGNUM *iqmp); +int RSA_set0_multi_prime_params(RSA *r, BIGNUM *primes[], BIGNUM *exps[], + BIGNUM *coeffs[], int pnum); +void RSA_get0_key(const RSA *r, + const BIGNUM **n, const BIGNUM **e, const BIGNUM **d); +void RSA_get0_factors(const RSA *r, const BIGNUM **p, const BIGNUM **q); +int RSA_get_multi_prime_extra_count(const RSA *r); +int RSA_get0_multi_prime_factors(const RSA *r, const BIGNUM *primes[]); +void RSA_get0_crt_params(const RSA *r, + const BIGNUM **dmp1, const BIGNUM **dmq1, + const BIGNUM **iqmp); +int RSA_get0_multi_prime_crt_params(const RSA *r, const BIGNUM *exps[], + const BIGNUM *coeffs[]); +const BIGNUM *RSA_get0_n(const RSA *d); +const BIGNUM *RSA_get0_e(const RSA *d); +const BIGNUM *RSA_get0_d(const RSA *d); +const BIGNUM *RSA_get0_p(const RSA *d); +const BIGNUM *RSA_get0_q(const RSA *d); +const BIGNUM *RSA_get0_dmp1(const RSA *r); +const BIGNUM *RSA_get0_dmq1(const RSA *r); +const BIGNUM *RSA_get0_iqmp(const RSA *r); +void RSA_clear_flags(RSA *r, int flags); +int RSA_test_flags(const RSA *r, int flags); +void RSA_set_flags(RSA *r, int flags); +int RSA_get_version(RSA *r); +ENGINE *RSA_get0_engine(const RSA *r); + +/* Deprecated version */ +DEPRECATEDIN_0_9_8(RSA *RSA_generate_key(int bits, unsigned long e, void + (*callback) (int, int, void *), + void *cb_arg)) + +/* New version */ +int RSA_generate_key_ex(RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb); +/* Multi-prime version */ +int RSA_generate_multi_prime_key(RSA *rsa, int bits, int primes, + BIGNUM *e, BN_GENCB *cb); + +int RSA_X931_derive_ex(RSA *rsa, BIGNUM *p1, BIGNUM *p2, BIGNUM *q1, + BIGNUM *q2, const BIGNUM *Xp1, const BIGNUM *Xp2, + const BIGNUM *Xp, const BIGNUM *Xq1, const BIGNUM *Xq2, + const BIGNUM *Xq, const BIGNUM *e, BN_GENCB *cb); +int RSA_X931_generate_key_ex(RSA *rsa, int bits, const BIGNUM *e, + BN_GENCB *cb); + +int RSA_check_key(const RSA *); +int RSA_check_key_ex(const RSA *, BN_GENCB *cb); + /* next 4 return -1 on error */ +int RSA_public_encrypt(int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +int RSA_private_encrypt(int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +int RSA_public_decrypt(int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +int RSA_private_decrypt(int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +void RSA_free(RSA *r); +/* "up" the RSA object's reference count */ +int RSA_up_ref(RSA *r); + +int RSA_flags(const RSA *r); + +void RSA_set_default_method(const RSA_METHOD *meth); +const RSA_METHOD *RSA_get_default_method(void); +const RSA_METHOD *RSA_null_method(void); +const RSA_METHOD *RSA_get_method(const RSA *rsa); +int RSA_set_method(RSA *rsa, const RSA_METHOD *meth); + +/* these are the actual RSA functions */ +const RSA_METHOD *RSA_PKCS1_OpenSSL(void); + +int RSA_pkey_ctx_ctrl(EVP_PKEY_CTX *ctx, int optype, int cmd, int p1, void *p2); + +DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPublicKey) +DECLARE_ASN1_ENCODE_FUNCTIONS_const(RSA, RSAPrivateKey) + +typedef struct rsa_pss_params_st { + X509_ALGOR *hashAlgorithm; + X509_ALGOR *maskGenAlgorithm; + ASN1_INTEGER *saltLength; + ASN1_INTEGER *trailerField; + /* Decoded hash algorithm from maskGenAlgorithm */ + X509_ALGOR *maskHash; +} RSA_PSS_PARAMS; + +DECLARE_ASN1_FUNCTIONS(RSA_PSS_PARAMS) + +typedef struct rsa_oaep_params_st { + X509_ALGOR *hashFunc; + X509_ALGOR *maskGenFunc; + X509_ALGOR *pSourceFunc; + /* Decoded hash algorithm from maskGenFunc */ + X509_ALGOR *maskHash; +} RSA_OAEP_PARAMS; + +DECLARE_ASN1_FUNCTIONS(RSA_OAEP_PARAMS) + +# ifndef OPENSSL_NO_STDIO +int RSA_print_fp(FILE *fp, const RSA *r, int offset); +# endif + +int RSA_print(BIO *bp, const RSA *r, int offset); + +/* + * The following 2 functions sign and verify a X509_SIG ASN1 object inside + * PKCS#1 padded RSA encryption + */ +int RSA_sign(int type, const unsigned char *m, unsigned int m_length, + unsigned char *sigret, unsigned int *siglen, RSA *rsa); +int RSA_verify(int type, const unsigned char *m, unsigned int m_length, + const unsigned char *sigbuf, unsigned int siglen, RSA *rsa); + +/* + * The following 2 function sign and verify a ASN1_OCTET_STRING object inside + * PKCS#1 padded RSA encryption + */ +int RSA_sign_ASN1_OCTET_STRING(int type, + const unsigned char *m, unsigned int m_length, + unsigned char *sigret, unsigned int *siglen, + RSA *rsa); +int RSA_verify_ASN1_OCTET_STRING(int type, const unsigned char *m, + unsigned int m_length, unsigned char *sigbuf, + unsigned int siglen, RSA *rsa); + +int RSA_blinding_on(RSA *rsa, BN_CTX *ctx); +void RSA_blinding_off(RSA *rsa); +BN_BLINDING *RSA_setup_blinding(RSA *rsa, BN_CTX *ctx); + +int RSA_padding_add_PKCS1_type_1(unsigned char *to, int tlen, + const unsigned char *f, int fl); +int RSA_padding_check_PKCS1_type_1(unsigned char *to, int tlen, + const unsigned char *f, int fl, + int rsa_len); +int RSA_padding_add_PKCS1_type_2(unsigned char *to, int tlen, + const unsigned char *f, int fl); +int RSA_padding_check_PKCS1_type_2(unsigned char *to, int tlen, + const unsigned char *f, int fl, + int rsa_len); +int PKCS1_MGF1(unsigned char *mask, long len, const unsigned char *seed, + long seedlen, const EVP_MD *dgst); +int RSA_padding_add_PKCS1_OAEP(unsigned char *to, int tlen, + const unsigned char *f, int fl, + const unsigned char *p, int pl); +int RSA_padding_check_PKCS1_OAEP(unsigned char *to, int tlen, + const unsigned char *f, int fl, int rsa_len, + const unsigned char *p, int pl); +int RSA_padding_add_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, + const unsigned char *from, int flen, + const unsigned char *param, int plen, + const EVP_MD *md, const EVP_MD *mgf1md); +int RSA_padding_check_PKCS1_OAEP_mgf1(unsigned char *to, int tlen, + const unsigned char *from, int flen, + int num, const unsigned char *param, + int plen, const EVP_MD *md, + const EVP_MD *mgf1md); +int RSA_padding_add_SSLv23(unsigned char *to, int tlen, + const unsigned char *f, int fl); +int RSA_padding_check_SSLv23(unsigned char *to, int tlen, + const unsigned char *f, int fl, int rsa_len); +int RSA_padding_add_none(unsigned char *to, int tlen, const unsigned char *f, + int fl); +int RSA_padding_check_none(unsigned char *to, int tlen, + const unsigned char *f, int fl, int rsa_len); +int RSA_padding_add_X931(unsigned char *to, int tlen, const unsigned char *f, + int fl); +int RSA_padding_check_X931(unsigned char *to, int tlen, + const unsigned char *f, int fl, int rsa_len); +int RSA_X931_hash_id(int nid); + +int RSA_verify_PKCS1_PSS(RSA *rsa, const unsigned char *mHash, + const EVP_MD *Hash, const unsigned char *EM, + int sLen); +int RSA_padding_add_PKCS1_PSS(RSA *rsa, unsigned char *EM, + const unsigned char *mHash, const EVP_MD *Hash, + int sLen); + +int RSA_verify_PKCS1_PSS_mgf1(RSA *rsa, const unsigned char *mHash, + const EVP_MD *Hash, const EVP_MD *mgf1Hash, + const unsigned char *EM, int sLen); + +int RSA_padding_add_PKCS1_PSS_mgf1(RSA *rsa, unsigned char *EM, + const unsigned char *mHash, + const EVP_MD *Hash, const EVP_MD *mgf1Hash, + int sLen); + +#define RSA_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_RSA, l, p, newf, dupf, freef) +int RSA_set_ex_data(RSA *r, int idx, void *arg); +void *RSA_get_ex_data(const RSA *r, int idx); + +RSA *RSAPublicKey_dup(RSA *rsa); +RSA *RSAPrivateKey_dup(RSA *rsa); + +/* + * If this flag is set the RSA method is FIPS compliant and can be used in + * FIPS mode. This is set in the validated module method. If an application + * sets this flag in its own methods it is its responsibility to ensure the + * result is compliant. + */ + +# define RSA_FLAG_FIPS_METHOD 0x0400 + +/* + * If this flag is set the operations normally disabled in FIPS mode are + * permitted it is then the applications responsibility to ensure that the + * usage is compliant. + */ + +# define RSA_FLAG_NON_FIPS_ALLOW 0x0400 +/* + * Application has decided PRNG is good enough to generate a key: don't + * check. + */ +# define RSA_FLAG_CHECKED 0x0800 + +RSA_METHOD *RSA_meth_new(const char *name, int flags); +void RSA_meth_free(RSA_METHOD *meth); +RSA_METHOD *RSA_meth_dup(const RSA_METHOD *meth); +const char *RSA_meth_get0_name(const RSA_METHOD *meth); +int RSA_meth_set1_name(RSA_METHOD *meth, const char *name); +int RSA_meth_get_flags(const RSA_METHOD *meth); +int RSA_meth_set_flags(RSA_METHOD *meth, int flags); +void *RSA_meth_get0_app_data(const RSA_METHOD *meth); +int RSA_meth_set0_app_data(RSA_METHOD *meth, void *app_data); +int (*RSA_meth_get_pub_enc(const RSA_METHOD *meth)) + (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +int RSA_meth_set_pub_enc(RSA_METHOD *rsa, + int (*pub_enc) (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, + int padding)); +int (*RSA_meth_get_pub_dec(const RSA_METHOD *meth)) + (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +int RSA_meth_set_pub_dec(RSA_METHOD *rsa, + int (*pub_dec) (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, + int padding)); +int (*RSA_meth_get_priv_enc(const RSA_METHOD *meth)) + (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +int RSA_meth_set_priv_enc(RSA_METHOD *rsa, + int (*priv_enc) (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, + int padding)); +int (*RSA_meth_get_priv_dec(const RSA_METHOD *meth)) + (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, int padding); +int RSA_meth_set_priv_dec(RSA_METHOD *rsa, + int (*priv_dec) (int flen, const unsigned char *from, + unsigned char *to, RSA *rsa, + int padding)); +int (*RSA_meth_get_mod_exp(const RSA_METHOD *meth)) + (BIGNUM *r0, const BIGNUM *I, RSA *rsa, BN_CTX *ctx); +int RSA_meth_set_mod_exp(RSA_METHOD *rsa, + int (*mod_exp) (BIGNUM *r0, const BIGNUM *I, RSA *rsa, + BN_CTX *ctx)); +int (*RSA_meth_get_bn_mod_exp(const RSA_METHOD *meth)) + (BIGNUM *r, const BIGNUM *a, const BIGNUM *p, + const BIGNUM *m, BN_CTX *ctx, BN_MONT_CTX *m_ctx); +int RSA_meth_set_bn_mod_exp(RSA_METHOD *rsa, + int (*bn_mod_exp) (BIGNUM *r, + const BIGNUM *a, + const BIGNUM *p, + const BIGNUM *m, + BN_CTX *ctx, + BN_MONT_CTX *m_ctx)); +int (*RSA_meth_get_init(const RSA_METHOD *meth)) (RSA *rsa); +int RSA_meth_set_init(RSA_METHOD *rsa, int (*init) (RSA *rsa)); +int (*RSA_meth_get_finish(const RSA_METHOD *meth)) (RSA *rsa); +int RSA_meth_set_finish(RSA_METHOD *rsa, int (*finish) (RSA *rsa)); +int (*RSA_meth_get_sign(const RSA_METHOD *meth)) + (int type, + const unsigned char *m, unsigned int m_length, + unsigned char *sigret, unsigned int *siglen, + const RSA *rsa); +int RSA_meth_set_sign(RSA_METHOD *rsa, + int (*sign) (int type, const unsigned char *m, + unsigned int m_length, + unsigned char *sigret, unsigned int *siglen, + const RSA *rsa)); +int (*RSA_meth_get_verify(const RSA_METHOD *meth)) + (int dtype, const unsigned char *m, + unsigned int m_length, const unsigned char *sigbuf, + unsigned int siglen, const RSA *rsa); +int RSA_meth_set_verify(RSA_METHOD *rsa, + int (*verify) (int dtype, const unsigned char *m, + unsigned int m_length, + const unsigned char *sigbuf, + unsigned int siglen, const RSA *rsa)); +int (*RSA_meth_get_keygen(const RSA_METHOD *meth)) + (RSA *rsa, int bits, BIGNUM *e, BN_GENCB *cb); +int RSA_meth_set_keygen(RSA_METHOD *rsa, + int (*keygen) (RSA *rsa, int bits, BIGNUM *e, + BN_GENCB *cb)); +int (*RSA_meth_get_multi_prime_keygen(const RSA_METHOD *meth)) + (RSA *rsa, int bits, int primes, BIGNUM *e, BN_GENCB *cb); +int RSA_meth_set_multi_prime_keygen(RSA_METHOD *meth, + int (*keygen) (RSA *rsa, int bits, + int primes, BIGNUM *e, + BN_GENCB *cb)); + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/rsaerr.h b/include/openssl/rsaerr.h new file mode 100644 index 0000000..d5bc01c --- /dev/null +++ b/include/openssl/rsaerr.h @@ -0,0 +1,162 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_RSAERR_H +# define HEADER_RSAERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_RSA_strings(void); + +/* + * RSA function codes. + */ +# define RSA_F_CHECK_PADDING_MD 140 +# define RSA_F_ENCODE_PKCS1 146 +# define RSA_F_INT_RSA_VERIFY 145 +# define RSA_F_OLD_RSA_PRIV_DECODE 147 +# define RSA_F_PKEY_PSS_INIT 165 +# define RSA_F_PKEY_RSA_CTRL 143 +# define RSA_F_PKEY_RSA_CTRL_STR 144 +# define RSA_F_PKEY_RSA_SIGN 142 +# define RSA_F_PKEY_RSA_VERIFY 149 +# define RSA_F_PKEY_RSA_VERIFYRECOVER 141 +# define RSA_F_RSA_ALGOR_TO_MD 156 +# define RSA_F_RSA_BUILTIN_KEYGEN 129 +# define RSA_F_RSA_CHECK_KEY 123 +# define RSA_F_RSA_CHECK_KEY_EX 160 +# define RSA_F_RSA_CMS_DECRYPT 159 +# define RSA_F_RSA_CMS_VERIFY 158 +# define RSA_F_RSA_ITEM_VERIFY 148 +# define RSA_F_RSA_METH_DUP 161 +# define RSA_F_RSA_METH_NEW 162 +# define RSA_F_RSA_METH_SET1_NAME 163 +# define RSA_F_RSA_MGF1_TO_MD 157 +# define RSA_F_RSA_MULTIP_INFO_NEW 166 +# define RSA_F_RSA_NEW_METHOD 106 +# define RSA_F_RSA_NULL 124 +# define RSA_F_RSA_NULL_PRIVATE_DECRYPT 132 +# define RSA_F_RSA_NULL_PRIVATE_ENCRYPT 133 +# define RSA_F_RSA_NULL_PUBLIC_DECRYPT 134 +# define RSA_F_RSA_NULL_PUBLIC_ENCRYPT 135 +# define RSA_F_RSA_OSSL_PRIVATE_DECRYPT 101 +# define RSA_F_RSA_OSSL_PRIVATE_ENCRYPT 102 +# define RSA_F_RSA_OSSL_PUBLIC_DECRYPT 103 +# define RSA_F_RSA_OSSL_PUBLIC_ENCRYPT 104 +# define RSA_F_RSA_PADDING_ADD_NONE 107 +# define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP 121 +# define RSA_F_RSA_PADDING_ADD_PKCS1_OAEP_MGF1 154 +# define RSA_F_RSA_PADDING_ADD_PKCS1_PSS 125 +# define RSA_F_RSA_PADDING_ADD_PKCS1_PSS_MGF1 152 +# define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_1 108 +# define RSA_F_RSA_PADDING_ADD_PKCS1_TYPE_2 109 +# define RSA_F_RSA_PADDING_ADD_SSLV23 110 +# define RSA_F_RSA_PADDING_ADD_X931 127 +# define RSA_F_RSA_PADDING_CHECK_NONE 111 +# define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP 122 +# define RSA_F_RSA_PADDING_CHECK_PKCS1_OAEP_MGF1 153 +# define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_1 112 +# define RSA_F_RSA_PADDING_CHECK_PKCS1_TYPE_2 113 +# define RSA_F_RSA_PADDING_CHECK_SSLV23 114 +# define RSA_F_RSA_PADDING_CHECK_X931 128 +# define RSA_F_RSA_PARAM_DECODE 164 +# define RSA_F_RSA_PRINT 115 +# define RSA_F_RSA_PRINT_FP 116 +# define RSA_F_RSA_PRIV_DECODE 150 +# define RSA_F_RSA_PRIV_ENCODE 138 +# define RSA_F_RSA_PSS_GET_PARAM 151 +# define RSA_F_RSA_PSS_TO_CTX 155 +# define RSA_F_RSA_PUB_DECODE 139 +# define RSA_F_RSA_SETUP_BLINDING 136 +# define RSA_F_RSA_SIGN 117 +# define RSA_F_RSA_SIGN_ASN1_OCTET_STRING 118 +# define RSA_F_RSA_VERIFY 119 +# define RSA_F_RSA_VERIFY_ASN1_OCTET_STRING 120 +# define RSA_F_RSA_VERIFY_PKCS1_PSS_MGF1 126 +# define RSA_F_SETUP_TBUF 167 + +/* + * RSA reason codes. + */ +# define RSA_R_ALGORITHM_MISMATCH 100 +# define RSA_R_BAD_E_VALUE 101 +# define RSA_R_BAD_FIXED_HEADER_DECRYPT 102 +# define RSA_R_BAD_PAD_BYTE_COUNT 103 +# define RSA_R_BAD_SIGNATURE 104 +# define RSA_R_BLOCK_TYPE_IS_NOT_01 106 +# define RSA_R_BLOCK_TYPE_IS_NOT_02 107 +# define RSA_R_DATA_GREATER_THAN_MOD_LEN 108 +# define RSA_R_DATA_TOO_LARGE 109 +# define RSA_R_DATA_TOO_LARGE_FOR_KEY_SIZE 110 +# define RSA_R_DATA_TOO_LARGE_FOR_MODULUS 132 +# define RSA_R_DATA_TOO_SMALL 111 +# define RSA_R_DATA_TOO_SMALL_FOR_KEY_SIZE 122 +# define RSA_R_DIGEST_DOES_NOT_MATCH 158 +# define RSA_R_DIGEST_NOT_ALLOWED 145 +# define RSA_R_DIGEST_TOO_BIG_FOR_RSA_KEY 112 +# define RSA_R_DMP1_NOT_CONGRUENT_TO_D 124 +# define RSA_R_DMQ1_NOT_CONGRUENT_TO_D 125 +# define RSA_R_D_E_NOT_CONGRUENT_TO_1 123 +# define RSA_R_FIRST_OCTET_INVALID 133 +# define RSA_R_ILLEGAL_OR_UNSUPPORTED_PADDING_MODE 144 +# define RSA_R_INVALID_DIGEST 157 +# define RSA_R_INVALID_DIGEST_LENGTH 143 +# define RSA_R_INVALID_HEADER 137 +# define RSA_R_INVALID_LABEL 160 +# define RSA_R_INVALID_MESSAGE_LENGTH 131 +# define RSA_R_INVALID_MGF1_MD 156 +# define RSA_R_INVALID_MULTI_PRIME_KEY 167 +# define RSA_R_INVALID_OAEP_PARAMETERS 161 +# define RSA_R_INVALID_PADDING 138 +# define RSA_R_INVALID_PADDING_MODE 141 +# define RSA_R_INVALID_PSS_PARAMETERS 149 +# define RSA_R_INVALID_PSS_SALTLEN 146 +# define RSA_R_INVALID_SALT_LENGTH 150 +# define RSA_R_INVALID_TRAILER 139 +# define RSA_R_INVALID_X931_DIGEST 142 +# define RSA_R_IQMP_NOT_INVERSE_OF_Q 126 +# define RSA_R_KEY_PRIME_NUM_INVALID 165 +# define RSA_R_KEY_SIZE_TOO_SMALL 120 +# define RSA_R_LAST_OCTET_INVALID 134 +# define RSA_R_MGF1_DIGEST_NOT_ALLOWED 152 +# define RSA_R_MODULUS_TOO_LARGE 105 +# define RSA_R_MP_COEFFICIENT_NOT_INVERSE_OF_R 168 +# define RSA_R_MP_EXPONENT_NOT_CONGRUENT_TO_D 169 +# define RSA_R_MP_R_NOT_PRIME 170 +# define RSA_R_NO_PUBLIC_EXPONENT 140 +# define RSA_R_NULL_BEFORE_BLOCK_MISSING 113 +# define RSA_R_N_DOES_NOT_EQUAL_PRODUCT_OF_PRIMES 172 +# define RSA_R_N_DOES_NOT_EQUAL_P_Q 127 +# define RSA_R_OAEP_DECODING_ERROR 121 +# define RSA_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE 148 +# define RSA_R_PADDING_CHECK_FAILED 114 +# define RSA_R_PKCS_DECODING_ERROR 159 +# define RSA_R_PSS_SALTLEN_TOO_SMALL 164 +# define RSA_R_P_NOT_PRIME 128 +# define RSA_R_Q_NOT_PRIME 129 +# define RSA_R_RSA_OPERATIONS_NOT_SUPPORTED 130 +# define RSA_R_SLEN_CHECK_FAILED 136 +# define RSA_R_SLEN_RECOVERY_FAILED 135 +# define RSA_R_SSLV3_ROLLBACK_ATTACK 115 +# define RSA_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 116 +# define RSA_R_UNKNOWN_ALGORITHM_TYPE 117 +# define RSA_R_UNKNOWN_DIGEST 166 +# define RSA_R_UNKNOWN_MASK_DIGEST 151 +# define RSA_R_UNKNOWN_PADDING_TYPE 118 +# define RSA_R_UNSUPPORTED_ENCRYPTION_TYPE 162 +# define RSA_R_UNSUPPORTED_LABEL_SOURCE 163 +# define RSA_R_UNSUPPORTED_MASK_ALGORITHM 153 +# define RSA_R_UNSUPPORTED_MASK_PARAMETER 154 +# define RSA_R_UNSUPPORTED_SIGNATURE_TYPE 155 +# define RSA_R_VALUE_MISSING 147 +# define RSA_R_WRONG_SIGNATURE_LENGTH 119 + +#endif diff --git a/include/openssl/safestack.h b/include/openssl/safestack.h new file mode 100644 index 0000000..3a003af --- /dev/null +++ b/include/openssl/safestack.h @@ -0,0 +1,172 @@ +/* + * Copyright 1999-2017 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SAFESTACK_H +# define HEADER_SAFESTACK_H + +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +# define STACK_OF(type) struct stack_st_##type + +# define SKM_DEFINE_STACK_OF(t1, t2, t3) \ + STACK_OF(t1); \ + typedef int (*sk_##t1##_compfunc)(const t3 * const *a, const t3 *const *b); \ + typedef void (*sk_##t1##_freefunc)(t3 *a); \ + typedef t3 * (*sk_##t1##_copyfunc)(const t3 *a); \ + static ossl_inline int sk_##t1##_num(const STACK_OF(t1) *sk) \ + { \ + return OPENSSL_sk_num((const OPENSSL_STACK *)sk); \ + } \ + static ossl_inline t2 *sk_##t1##_value(const STACK_OF(t1) *sk, int idx) \ + { \ + return (t2 *)OPENSSL_sk_value((const OPENSSL_STACK *)sk, idx); \ + } \ + static ossl_inline STACK_OF(t1) *sk_##t1##_new(sk_##t1##_compfunc compare) \ + { \ + return (STACK_OF(t1) *)OPENSSL_sk_new((OPENSSL_sk_compfunc)compare); \ + } \ + static ossl_inline STACK_OF(t1) *sk_##t1##_new_null(void) \ + { \ + return (STACK_OF(t1) *)OPENSSL_sk_new_null(); \ + } \ + static ossl_inline STACK_OF(t1) *sk_##t1##_new_reserve(sk_##t1##_compfunc compare, int n) \ + { \ + return (STACK_OF(t1) *)OPENSSL_sk_new_reserve((OPENSSL_sk_compfunc)compare, n); \ + } \ + static ossl_inline int sk_##t1##_reserve(STACK_OF(t1) *sk, int n) \ + { \ + return OPENSSL_sk_reserve((OPENSSL_STACK *)sk, n); \ + } \ + static ossl_inline void sk_##t1##_free(STACK_OF(t1) *sk) \ + { \ + OPENSSL_sk_free((OPENSSL_STACK *)sk); \ + } \ + static ossl_inline void sk_##t1##_zero(STACK_OF(t1) *sk) \ + { \ + OPENSSL_sk_zero((OPENSSL_STACK *)sk); \ + } \ + static ossl_inline t2 *sk_##t1##_delete(STACK_OF(t1) *sk, int i) \ + { \ + return (t2 *)OPENSSL_sk_delete((OPENSSL_STACK *)sk, i); \ + } \ + static ossl_inline t2 *sk_##t1##_delete_ptr(STACK_OF(t1) *sk, t2 *ptr) \ + { \ + return (t2 *)OPENSSL_sk_delete_ptr((OPENSSL_STACK *)sk, \ + (const void *)ptr); \ + } \ + static ossl_inline int sk_##t1##_push(STACK_OF(t1) *sk, t2 *ptr) \ + { \ + return OPENSSL_sk_push((OPENSSL_STACK *)sk, (const void *)ptr); \ + } \ + static ossl_inline int sk_##t1##_unshift(STACK_OF(t1) *sk, t2 *ptr) \ + { \ + return OPENSSL_sk_unshift((OPENSSL_STACK *)sk, (const void *)ptr); \ + } \ + static ossl_inline t2 *sk_##t1##_pop(STACK_OF(t1) *sk) \ + { \ + return (t2 *)OPENSSL_sk_pop((OPENSSL_STACK *)sk); \ + } \ + static ossl_inline t2 *sk_##t1##_shift(STACK_OF(t1) *sk) \ + { \ + return (t2 *)OPENSSL_sk_shift((OPENSSL_STACK *)sk); \ + } \ + static ossl_inline void sk_##t1##_pop_free(STACK_OF(t1) *sk, sk_##t1##_freefunc freefunc) \ + { \ + OPENSSL_sk_pop_free((OPENSSL_STACK *)sk, (OPENSSL_sk_freefunc)freefunc); \ + } \ + static ossl_inline int sk_##t1##_insert(STACK_OF(t1) *sk, t2 *ptr, int idx) \ + { \ + return OPENSSL_sk_insert((OPENSSL_STACK *)sk, (const void *)ptr, idx); \ + } \ + static ossl_inline t2 *sk_##t1##_set(STACK_OF(t1) *sk, int idx, t2 *ptr) \ + { \ + return (t2 *)OPENSSL_sk_set((OPENSSL_STACK *)sk, idx, (const void *)ptr); \ + } \ + static ossl_inline int sk_##t1##_find(STACK_OF(t1) *sk, t2 *ptr) \ + { \ + return OPENSSL_sk_find((OPENSSL_STACK *)sk, (const void *)ptr); \ + } \ + static ossl_inline int sk_##t1##_find_ex(STACK_OF(t1) *sk, t2 *ptr) \ + { \ + return OPENSSL_sk_find_ex((OPENSSL_STACK *)sk, (const void *)ptr); \ + } \ + static ossl_inline void sk_##t1##_sort(STACK_OF(t1) *sk) \ + { \ + OPENSSL_sk_sort((OPENSSL_STACK *)sk); \ + } \ + static ossl_inline int sk_##t1##_is_sorted(const STACK_OF(t1) *sk) \ + { \ + return OPENSSL_sk_is_sorted((const OPENSSL_STACK *)sk); \ + } \ + static ossl_inline STACK_OF(t1) * sk_##t1##_dup(const STACK_OF(t1) *sk) \ + { \ + return (STACK_OF(t1) *)OPENSSL_sk_dup((const OPENSSL_STACK *)sk); \ + } \ + static ossl_inline STACK_OF(t1) *sk_##t1##_deep_copy(const STACK_OF(t1) *sk, \ + sk_##t1##_copyfunc copyfunc, \ + sk_##t1##_freefunc freefunc) \ + { \ + return (STACK_OF(t1) *)OPENSSL_sk_deep_copy((const OPENSSL_STACK *)sk, \ + (OPENSSL_sk_copyfunc)copyfunc, \ + (OPENSSL_sk_freefunc)freefunc); \ + } \ + static ossl_inline sk_##t1##_compfunc sk_##t1##_set_cmp_func(STACK_OF(t1) *sk, sk_##t1##_compfunc compare) \ + { \ + return (sk_##t1##_compfunc)OPENSSL_sk_set_cmp_func((OPENSSL_STACK *)sk, (OPENSSL_sk_compfunc)compare); \ + } + +# define DEFINE_SPECIAL_STACK_OF(t1, t2) SKM_DEFINE_STACK_OF(t1, t2, t2) +# define DEFINE_STACK_OF(t) SKM_DEFINE_STACK_OF(t, t, t) +# define DEFINE_SPECIAL_STACK_OF_CONST(t1, t2) \ + SKM_DEFINE_STACK_OF(t1, const t2, t2) +# define DEFINE_STACK_OF_CONST(t) SKM_DEFINE_STACK_OF(t, const t, t) + +/*- + * Strings are special: normally an lhash entry will point to a single + * (somewhat) mutable object. In the case of strings: + * + * a) Instead of a single char, there is an array of chars, NUL-terminated. + * b) The string may have be immutable. + * + * So, they need their own declarations. Especially important for + * type-checking tools, such as Deputy. + * + * In practice, however, it appears to be hard to have a const + * string. For now, I'm settling for dealing with the fact it is a + * string at all. + */ +typedef char *OPENSSL_STRING; +typedef const char *OPENSSL_CSTRING; + +/*- + * Confusingly, LHASH_OF(STRING) deals with char ** throughout, but + * STACK_OF(STRING) is really more like STACK_OF(char), only, as mentioned + * above, instead of a single char each entry is a NUL-terminated array of + * chars. So, we have to implement STRING specially for STACK_OF. This is + * dealt with in the autogenerated macros below. + */ +DEFINE_SPECIAL_STACK_OF(OPENSSL_STRING, char) +DEFINE_SPECIAL_STACK_OF_CONST(OPENSSL_CSTRING, char) + +/* + * Similarly, we sometimes use a block of characters, NOT nul-terminated. + * These should also be distinguished from "normal" stacks. + */ +typedef void *OPENSSL_BLOCK; +DEFINE_SPECIAL_STACK_OF(OPENSSL_BLOCK, void) + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/seed.h b/include/openssl/seed.h new file mode 100644 index 0000000..c2f5883 --- /dev/null +++ b/include/openssl/seed.h @@ -0,0 +1,96 @@ +/* + * Copyright 2007-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * Copyright (c) 2007 KISA(Korea Information Security Agency). All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Neither the name of author nor the names of its contributors may + * be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +#ifndef HEADER_SEED_H +# define HEADER_SEED_H + +# include + +# ifndef OPENSSL_NO_SEED +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* look whether we need 'long' to get 32 bits */ +# ifdef AES_LONG +# ifndef SEED_LONG +# define SEED_LONG 1 +# endif +# endif + +# include + +# define SEED_BLOCK_SIZE 16 +# define SEED_KEY_LENGTH 16 + +typedef struct seed_key_st { +# ifdef SEED_LONG + unsigned long data[32]; +# else + unsigned int data[32]; +# endif +} SEED_KEY_SCHEDULE; + +void SEED_set_key(const unsigned char rawkey[SEED_KEY_LENGTH], + SEED_KEY_SCHEDULE *ks); + +void SEED_encrypt(const unsigned char s[SEED_BLOCK_SIZE], + unsigned char d[SEED_BLOCK_SIZE], + const SEED_KEY_SCHEDULE *ks); +void SEED_decrypt(const unsigned char s[SEED_BLOCK_SIZE], + unsigned char d[SEED_BLOCK_SIZE], + const SEED_KEY_SCHEDULE *ks); + +void SEED_ecb_encrypt(const unsigned char *in, unsigned char *out, + const SEED_KEY_SCHEDULE *ks, int enc); +void SEED_cbc_encrypt(const unsigned char *in, unsigned char *out, size_t len, + const SEED_KEY_SCHEDULE *ks, + unsigned char ivec[SEED_BLOCK_SIZE], int enc); +void SEED_cfb128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const SEED_KEY_SCHEDULE *ks, + unsigned char ivec[SEED_BLOCK_SIZE], int *num, + int enc); +void SEED_ofb128_encrypt(const unsigned char *in, unsigned char *out, + size_t len, const SEED_KEY_SCHEDULE *ks, + unsigned char ivec[SEED_BLOCK_SIZE], int *num); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/sha.h b/include/openssl/sha.h new file mode 100644 index 0000000..d823414 --- /dev/null +++ b/include/openssl/sha.h @@ -0,0 +1,119 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SHA_H +# define HEADER_SHA_H + +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/*- + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + * ! SHA_LONG has to be at least 32 bits wide. ! + * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + */ +# define SHA_LONG unsigned int + +# define SHA_LBLOCK 16 +# define SHA_CBLOCK (SHA_LBLOCK*4)/* SHA treats input data as a + * contiguous array of 32 bit wide + * big-endian values. */ +# define SHA_LAST_BLOCK (SHA_CBLOCK-8) +# define SHA_DIGEST_LENGTH 20 + +typedef struct SHAstate_st { + SHA_LONG h0, h1, h2, h3, h4; + SHA_LONG Nl, Nh; + SHA_LONG data[SHA_LBLOCK]; + unsigned int num; +} SHA_CTX; + +int SHA1_Init(SHA_CTX *c); +int SHA1_Update(SHA_CTX *c, const void *data, size_t len); +int SHA1_Final(unsigned char *md, SHA_CTX *c); +unsigned char *SHA1(const unsigned char *d, size_t n, unsigned char *md); +void SHA1_Transform(SHA_CTX *c, const unsigned char *data); + +# define SHA256_CBLOCK (SHA_LBLOCK*4)/* SHA-256 treats input data as a + * contiguous array of 32 bit wide + * big-endian values. */ + +typedef struct SHA256state_st { + SHA_LONG h[8]; + SHA_LONG Nl, Nh; + SHA_LONG data[SHA_LBLOCK]; + unsigned int num, md_len; +} SHA256_CTX; + +int SHA224_Init(SHA256_CTX *c); +int SHA224_Update(SHA256_CTX *c, const void *data, size_t len); +int SHA224_Final(unsigned char *md, SHA256_CTX *c); +unsigned char *SHA224(const unsigned char *d, size_t n, unsigned char *md); +int SHA256_Init(SHA256_CTX *c); +int SHA256_Update(SHA256_CTX *c, const void *data, size_t len); +int SHA256_Final(unsigned char *md, SHA256_CTX *c); +unsigned char *SHA256(const unsigned char *d, size_t n, unsigned char *md); +void SHA256_Transform(SHA256_CTX *c, const unsigned char *data); + +# define SHA224_DIGEST_LENGTH 28 +# define SHA256_DIGEST_LENGTH 32 +# define SHA384_DIGEST_LENGTH 48 +# define SHA512_DIGEST_LENGTH 64 + +/* + * Unlike 32-bit digest algorithms, SHA-512 *relies* on SHA_LONG64 + * being exactly 64-bit wide. See Implementation Notes in sha512.c + * for further details. + */ +/* + * SHA-512 treats input data as a + * contiguous array of 64 bit + * wide big-endian values. + */ +# define SHA512_CBLOCK (SHA_LBLOCK*8) +# if (defined(_WIN32) || defined(_WIN64)) && !defined(__MINGW32__) +# define SHA_LONG64 unsigned __int64 +# define U64(C) C##UI64 +# elif defined(__arch64__) +# define SHA_LONG64 unsigned long +# define U64(C) C##UL +# else +# define SHA_LONG64 unsigned long long +# define U64(C) C##ULL +# endif + +typedef struct SHA512state_st { + SHA_LONG64 h[8]; + SHA_LONG64 Nl, Nh; + union { + SHA_LONG64 d[SHA_LBLOCK]; + unsigned char p[SHA512_CBLOCK]; + } u; + unsigned int num, md_len; +} SHA512_CTX; + +int SHA384_Init(SHA512_CTX *c); +int SHA384_Update(SHA512_CTX *c, const void *data, size_t len); +int SHA384_Final(unsigned char *md, SHA512_CTX *c); +unsigned char *SHA384(const unsigned char *d, size_t n, unsigned char *md); +int SHA512_Init(SHA512_CTX *c); +int SHA512_Update(SHA512_CTX *c, const void *data, size_t len); +int SHA512_Final(unsigned char *md, SHA512_CTX *c); +unsigned char *SHA512(const unsigned char *d, size_t n, unsigned char *md); +void SHA512_Transform(SHA512_CTX *c, const unsigned char *data); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/srp.h b/include/openssl/srp.h new file mode 100644 index 0000000..8ed1402 --- /dev/null +++ b/include/openssl/srp.h @@ -0,0 +1,135 @@ +/* + * Copyright 2004-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2004, EdelKey Project. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + * + * Originally written by Christophe Renou and Peter Sylvester, + * for the EdelKey project. + */ + +#ifndef HEADER_SRP_H +# define HEADER_SRP_H + +#include + +#ifndef OPENSSL_NO_SRP +# include +# include +# include +# include +# include + +# ifdef __cplusplus +extern "C" { +# endif + +typedef struct SRP_gN_cache_st { + char *b64_bn; + BIGNUM *bn; +} SRP_gN_cache; + + +DEFINE_STACK_OF(SRP_gN_cache) + +typedef struct SRP_user_pwd_st { + /* Owned by us. */ + char *id; + BIGNUM *s; + BIGNUM *v; + /* Not owned by us. */ + const BIGNUM *g; + const BIGNUM *N; + /* Owned by us. */ + char *info; +} SRP_user_pwd; + +void SRP_user_pwd_free(SRP_user_pwd *user_pwd); + +DEFINE_STACK_OF(SRP_user_pwd) + +typedef struct SRP_VBASE_st { + STACK_OF(SRP_user_pwd) *users_pwd; + STACK_OF(SRP_gN_cache) *gN_cache; +/* to simulate a user */ + char *seed_key; + const BIGNUM *default_g; + const BIGNUM *default_N; +} SRP_VBASE; + +/* + * Internal structure storing N and g pair + */ +typedef struct SRP_gN_st { + char *id; + const BIGNUM *g; + const BIGNUM *N; +} SRP_gN; + +DEFINE_STACK_OF(SRP_gN) + +SRP_VBASE *SRP_VBASE_new(char *seed_key); +void SRP_VBASE_free(SRP_VBASE *vb); +int SRP_VBASE_init(SRP_VBASE *vb, char *verifier_file); + +/* This method ignores the configured seed and fails for an unknown user. */ +DEPRECATEDIN_1_1_0(SRP_user_pwd *SRP_VBASE_get_by_user(SRP_VBASE *vb, char *username)) +/* NOTE: unlike in SRP_VBASE_get_by_user, caller owns the returned pointer.*/ +SRP_user_pwd *SRP_VBASE_get1_by_user(SRP_VBASE *vb, char *username); + +char *SRP_create_verifier(const char *user, const char *pass, char **salt, + char **verifier, const char *N, const char *g); +int SRP_create_verifier_BN(const char *user, const char *pass, BIGNUM **salt, + BIGNUM **verifier, const BIGNUM *N, + const BIGNUM *g); + +# define SRP_NO_ERROR 0 +# define SRP_ERR_VBASE_INCOMPLETE_FILE 1 +# define SRP_ERR_VBASE_BN_LIB 2 +# define SRP_ERR_OPEN_FILE 3 +# define SRP_ERR_MEMORY 4 + +# define DB_srptype 0 +# define DB_srpverifier 1 +# define DB_srpsalt 2 +# define DB_srpid 3 +# define DB_srpgN 4 +# define DB_srpinfo 5 +# undef DB_NUMBER +# define DB_NUMBER 6 + +# define DB_SRP_INDEX 'I' +# define DB_SRP_VALID 'V' +# define DB_SRP_REVOKED 'R' +# define DB_SRP_MODIF 'v' + +/* see srp.c */ +char *SRP_check_known_gN_param(const BIGNUM *g, const BIGNUM *N); +SRP_gN *SRP_get_default_gN(const char *id); + +/* server side .... */ +BIGNUM *SRP_Calc_server_key(const BIGNUM *A, const BIGNUM *v, const BIGNUM *u, + const BIGNUM *b, const BIGNUM *N); +BIGNUM *SRP_Calc_B(const BIGNUM *b, const BIGNUM *N, const BIGNUM *g, + const BIGNUM *v); +int SRP_Verify_A_mod_N(const BIGNUM *A, const BIGNUM *N); +BIGNUM *SRP_Calc_u(const BIGNUM *A, const BIGNUM *B, const BIGNUM *N); + +/* client side .... */ +BIGNUM *SRP_Calc_x(const BIGNUM *s, const char *user, const char *pass); +BIGNUM *SRP_Calc_A(const BIGNUM *a, const BIGNUM *N, const BIGNUM *g); +BIGNUM *SRP_Calc_client_key(const BIGNUM *N, const BIGNUM *B, const BIGNUM *g, + const BIGNUM *x, const BIGNUM *a, const BIGNUM *u); +int SRP_Verify_B_mod_N(const BIGNUM *B, const BIGNUM *N); + +# define SRP_MINIMAL_N 1024 + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/srtp.h b/include/openssl/srtp.h new file mode 100644 index 0000000..5b291f4 --- /dev/null +++ b/include/openssl/srtp.h @@ -0,0 +1,50 @@ +/* + * Copyright 2011-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +/* + * DTLS code by Eric Rescorla + * + * Copyright (C) 2006, Network Resonance, Inc. Copyright (C) 2011, RTFM, Inc. + */ + +#ifndef HEADER_D1_SRTP_H +# define HEADER_D1_SRTP_H + +# include + +#ifdef __cplusplus +extern "C" { +#endif + +# define SRTP_AES128_CM_SHA1_80 0x0001 +# define SRTP_AES128_CM_SHA1_32 0x0002 +# define SRTP_AES128_F8_SHA1_80 0x0003 +# define SRTP_AES128_F8_SHA1_32 0x0004 +# define SRTP_NULL_SHA1_80 0x0005 +# define SRTP_NULL_SHA1_32 0x0006 + +/* AEAD SRTP protection profiles from RFC 7714 */ +# define SRTP_AEAD_AES_128_GCM 0x0007 +# define SRTP_AEAD_AES_256_GCM 0x0008 + +# ifndef OPENSSL_NO_SRTP + +__owur int SSL_CTX_set_tlsext_use_srtp(SSL_CTX *ctx, const char *profiles); +__owur int SSL_set_tlsext_use_srtp(SSL *ssl, const char *profiles); + +__owur STACK_OF(SRTP_PROTECTION_PROFILE) *SSL_get_srtp_profiles(SSL *ssl); +__owur SRTP_PROTECTION_PROFILE *SSL_get_selected_srtp_profile(SSL *s); + +# endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/ssl.h b/include/openssl/ssl.h new file mode 100644 index 0000000..895f2c7 --- /dev/null +++ b/include/openssl/ssl.h @@ -0,0 +1,2413 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * Copyright 2005 Nokia. All rights reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SSL_H +# define HEADER_SSL_H + +# include +# include +# include +# include +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# include +# include +# endif +# include +# include +# include +# include + +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* OpenSSL version number for ASN.1 encoding of the session information */ +/*- + * Version 0 - initial version + * Version 1 - added the optional peer certificate + */ +# define SSL_SESSION_ASN1_VERSION 0x0001 + +# define SSL_MAX_SSL_SESSION_ID_LENGTH 32 +# define SSL_MAX_SID_CTX_LENGTH 32 + +# define SSL_MIN_RSA_MODULUS_LENGTH_IN_BYTES (512/8) +# define SSL_MAX_KEY_ARG_LENGTH 8 +# define SSL_MAX_MASTER_KEY_LENGTH 48 + +/* The maximum number of encrypt/decrypt pipelines we can support */ +# define SSL_MAX_PIPELINES 32 + +/* text strings for the ciphers */ + +/* These are used to specify which ciphers to use and not to use */ + +# define SSL_TXT_LOW "LOW" +# define SSL_TXT_MEDIUM "MEDIUM" +# define SSL_TXT_HIGH "HIGH" +# define SSL_TXT_FIPS "FIPS" + +# define SSL_TXT_aNULL "aNULL" +# define SSL_TXT_eNULL "eNULL" +# define SSL_TXT_NULL "NULL" + +# define SSL_TXT_kRSA "kRSA" +# define SSL_TXT_kDHr "kDHr"/* this cipher class has been removed */ +# define SSL_TXT_kDHd "kDHd"/* this cipher class has been removed */ +# define SSL_TXT_kDH "kDH"/* this cipher class has been removed */ +# define SSL_TXT_kEDH "kEDH"/* alias for kDHE */ +# define SSL_TXT_kDHE "kDHE" +# define SSL_TXT_kECDHr "kECDHr"/* this cipher class has been removed */ +# define SSL_TXT_kECDHe "kECDHe"/* this cipher class has been removed */ +# define SSL_TXT_kECDH "kECDH"/* this cipher class has been removed */ +# define SSL_TXT_kEECDH "kEECDH"/* alias for kECDHE */ +# define SSL_TXT_kECDHE "kECDHE" +# define SSL_TXT_kPSK "kPSK" +# define SSL_TXT_kRSAPSK "kRSAPSK" +# define SSL_TXT_kECDHEPSK "kECDHEPSK" +# define SSL_TXT_kDHEPSK "kDHEPSK" +# define SSL_TXT_kGOST "kGOST" +# define SSL_TXT_kSRP "kSRP" + +# define SSL_TXT_aRSA "aRSA" +# define SSL_TXT_aDSS "aDSS" +# define SSL_TXT_aDH "aDH"/* this cipher class has been removed */ +# define SSL_TXT_aECDH "aECDH"/* this cipher class has been removed */ +# define SSL_TXT_aECDSA "aECDSA" +# define SSL_TXT_aPSK "aPSK" +# define SSL_TXT_aGOST94 "aGOST94" +# define SSL_TXT_aGOST01 "aGOST01" +# define SSL_TXT_aGOST12 "aGOST12" +# define SSL_TXT_aGOST "aGOST" +# define SSL_TXT_aSRP "aSRP" + +# define SSL_TXT_DSS "DSS" +# define SSL_TXT_DH "DH" +# define SSL_TXT_DHE "DHE"/* same as "kDHE:-ADH" */ +# define SSL_TXT_EDH "EDH"/* alias for DHE */ +# define SSL_TXT_ADH "ADH" +# define SSL_TXT_RSA "RSA" +# define SSL_TXT_ECDH "ECDH" +# define SSL_TXT_EECDH "EECDH"/* alias for ECDHE" */ +# define SSL_TXT_ECDHE "ECDHE"/* same as "kECDHE:-AECDH" */ +# define SSL_TXT_AECDH "AECDH" +# define SSL_TXT_ECDSA "ECDSA" +# define SSL_TXT_PSK "PSK" +# define SSL_TXT_SRP "SRP" + +# define SSL_TXT_DES "DES" +# define SSL_TXT_3DES "3DES" +# define SSL_TXT_RC4 "RC4" +# define SSL_TXT_RC2 "RC2" +# define SSL_TXT_IDEA "IDEA" +# define SSL_TXT_SEED "SEED" +# define SSL_TXT_AES128 "AES128" +# define SSL_TXT_AES256 "AES256" +# define SSL_TXT_AES "AES" +# define SSL_TXT_AES_GCM "AESGCM" +# define SSL_TXT_AES_CCM "AESCCM" +# define SSL_TXT_AES_CCM_8 "AESCCM8" +# define SSL_TXT_CAMELLIA128 "CAMELLIA128" +# define SSL_TXT_CAMELLIA256 "CAMELLIA256" +# define SSL_TXT_CAMELLIA "CAMELLIA" +# define SSL_TXT_CHACHA20 "CHACHA20" +# define SSL_TXT_GOST "GOST89" +# define SSL_TXT_ARIA "ARIA" +# define SSL_TXT_ARIA_GCM "ARIAGCM" +# define SSL_TXT_ARIA128 "ARIA128" +# define SSL_TXT_ARIA256 "ARIA256" + +# define SSL_TXT_MD5 "MD5" +# define SSL_TXT_SHA1 "SHA1" +# define SSL_TXT_SHA "SHA"/* same as "SHA1" */ +# define SSL_TXT_GOST94 "GOST94" +# define SSL_TXT_GOST89MAC "GOST89MAC" +# define SSL_TXT_GOST12 "GOST12" +# define SSL_TXT_GOST89MAC12 "GOST89MAC12" +# define SSL_TXT_SHA256 "SHA256" +# define SSL_TXT_SHA384 "SHA384" + +# define SSL_TXT_SSLV3 "SSLv3" +# define SSL_TXT_TLSV1 "TLSv1" +# define SSL_TXT_TLSV1_1 "TLSv1.1" +# define SSL_TXT_TLSV1_2 "TLSv1.2" + +# define SSL_TXT_ALL "ALL" + +/*- + * COMPLEMENTOF* definitions. These identifiers are used to (de-select) + * ciphers normally not being used. + * Example: "RC4" will activate all ciphers using RC4 including ciphers + * without authentication, which would normally disabled by DEFAULT (due + * the "!ADH" being part of default). Therefore "RC4:!COMPLEMENTOFDEFAULT" + * will make sure that it is also disabled in the specific selection. + * COMPLEMENTOF* identifiers are portable between version, as adjustments + * to the default cipher setup will also be included here. + * + * COMPLEMENTOFDEFAULT does not experience the same special treatment that + * DEFAULT gets, as only selection is being done and no sorting as needed + * for DEFAULT. + */ +# define SSL_TXT_CMPALL "COMPLEMENTOFALL" +# define SSL_TXT_CMPDEF "COMPLEMENTOFDEFAULT" + +/* + * The following cipher list is used by default. It also is substituted when + * an application-defined cipher list string starts with 'DEFAULT'. + * This applies to ciphersuites for TLSv1.2 and below. + */ +# define SSL_DEFAULT_CIPHER_LIST "ALL:!COMPLEMENTOFDEFAULT:!eNULL" +/* This is the default set of TLSv1.3 ciphersuites */ +# if !defined(OPENSSL_NO_CHACHA) && !defined(OPENSSL_NO_POLY1305) +# define TLS_DEFAULT_CIPHERSUITES "TLS_AES_256_GCM_SHA384:" \ + "TLS_CHACHA20_POLY1305_SHA256:" \ + "TLS_AES_128_GCM_SHA256" +# else +# define TLS_DEFAULT_CIPHERSUITES "TLS_AES_256_GCM_SHA384:" \ + "TLS_AES_128_GCM_SHA256" +#endif +/* + * As of OpenSSL 1.0.0, ssl_create_cipher_list() in ssl/ssl_ciph.c always + * starts with a reasonable order, and all we have to do for DEFAULT is + * throwing out anonymous and unencrypted ciphersuites! (The latter are not + * actually enabled by ALL, but "ALL:RSA" would enable some of them.) + */ + +/* Used in SSL_set_shutdown()/SSL_get_shutdown(); */ +# define SSL_SENT_SHUTDOWN 1 +# define SSL_RECEIVED_SHUTDOWN 2 + +#ifdef __cplusplus +} +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +# define SSL_FILETYPE_ASN1 X509_FILETYPE_ASN1 +# define SSL_FILETYPE_PEM X509_FILETYPE_PEM + +/* + * This is needed to stop compilers complaining about the 'struct ssl_st *' + * function parameters used to prototype callbacks in SSL_CTX. + */ +typedef struct ssl_st *ssl_crock_st; +typedef struct tls_session_ticket_ext_st TLS_SESSION_TICKET_EXT; +typedef struct ssl_method_st SSL_METHOD; +typedef struct ssl_cipher_st SSL_CIPHER; +typedef struct ssl_session_st SSL_SESSION; +typedef struct tls_sigalgs_st TLS_SIGALGS; +typedef struct ssl_conf_ctx_st SSL_CONF_CTX; +typedef struct ssl_comp_st SSL_COMP; + +STACK_OF(SSL_CIPHER); +STACK_OF(SSL_COMP); + +/* SRTP protection profiles for use with the use_srtp extension (RFC 5764)*/ +typedef struct srtp_protection_profile_st { + const char *name; + unsigned long id; +} SRTP_PROTECTION_PROFILE; + +DEFINE_STACK_OF(SRTP_PROTECTION_PROFILE) + +typedef int (*tls_session_ticket_ext_cb_fn)(SSL *s, const unsigned char *data, + int len, void *arg); +typedef int (*tls_session_secret_cb_fn)(SSL *s, void *secret, int *secret_len, + STACK_OF(SSL_CIPHER) *peer_ciphers, + const SSL_CIPHER **cipher, void *arg); + +/* Extension context codes */ +/* This extension is only allowed in TLS */ +#define SSL_EXT_TLS_ONLY 0x0001 +/* This extension is only allowed in DTLS */ +#define SSL_EXT_DTLS_ONLY 0x0002 +/* Some extensions may be allowed in DTLS but we don't implement them for it */ +#define SSL_EXT_TLS_IMPLEMENTATION_ONLY 0x0004 +/* Most extensions are not defined for SSLv3 but EXT_TYPE_renegotiate is */ +#define SSL_EXT_SSL3_ALLOWED 0x0008 +/* Extension is only defined for TLS1.2 and below */ +#define SSL_EXT_TLS1_2_AND_BELOW_ONLY 0x0010 +/* Extension is only defined for TLS1.3 and above */ +#define SSL_EXT_TLS1_3_ONLY 0x0020 +/* Ignore this extension during parsing if we are resuming */ +#define SSL_EXT_IGNORE_ON_RESUMPTION 0x0040 +#define SSL_EXT_CLIENT_HELLO 0x0080 +/* Really means TLS1.2 or below */ +#define SSL_EXT_TLS1_2_SERVER_HELLO 0x0100 +#define SSL_EXT_TLS1_3_SERVER_HELLO 0x0200 +#define SSL_EXT_TLS1_3_ENCRYPTED_EXTENSIONS 0x0400 +#define SSL_EXT_TLS1_3_HELLO_RETRY_REQUEST 0x0800 +#define SSL_EXT_TLS1_3_CERTIFICATE 0x1000 +#define SSL_EXT_TLS1_3_NEW_SESSION_TICKET 0x2000 +#define SSL_EXT_TLS1_3_CERTIFICATE_REQUEST 0x4000 + +/* Typedefs for handling custom extensions */ + +typedef int (*custom_ext_add_cb)(SSL *s, unsigned int ext_type, + const unsigned char **out, size_t *outlen, + int *al, void *add_arg); + +typedef void (*custom_ext_free_cb)(SSL *s, unsigned int ext_type, + const unsigned char *out, void *add_arg); + +typedef int (*custom_ext_parse_cb)(SSL *s, unsigned int ext_type, + const unsigned char *in, size_t inlen, + int *al, void *parse_arg); + + +typedef int (*SSL_custom_ext_add_cb_ex)(SSL *s, unsigned int ext_type, + unsigned int context, + const unsigned char **out, + size_t *outlen, X509 *x, + size_t chainidx, + int *al, void *add_arg); + +typedef void (*SSL_custom_ext_free_cb_ex)(SSL *s, unsigned int ext_type, + unsigned int context, + const unsigned char *out, + void *add_arg); + +typedef int (*SSL_custom_ext_parse_cb_ex)(SSL *s, unsigned int ext_type, + unsigned int context, + const unsigned char *in, + size_t inlen, X509 *x, + size_t chainidx, + int *al, void *parse_arg); + +/* Typedef for verification callback */ +typedef int (*SSL_verify_cb)(int preverify_ok, X509_STORE_CTX *x509_ctx); + +/* + * Some values are reserved until OpenSSL 1.2.0 because they were previously + * included in SSL_OP_ALL in a 1.1.x release. + * + * Reserved value (until OpenSSL 1.2.0) 0x00000001U + * Reserved value (until OpenSSL 1.2.0) 0x00000002U + */ +/* Allow initial connection to servers that don't support RI */ +# define SSL_OP_LEGACY_SERVER_CONNECT 0x00000004U + +/* Reserved value (until OpenSSL 1.2.0) 0x00000008U */ +# define SSL_OP_TLSEXT_PADDING 0x00000010U +/* Reserved value (until OpenSSL 1.2.0) 0x00000020U */ +# define SSL_OP_SAFARI_ECDHE_ECDSA_BUG 0x00000040U +/* + * Reserved value (until OpenSSL 1.2.0) 0x00000080U + * Reserved value (until OpenSSL 1.2.0) 0x00000100U + * Reserved value (until OpenSSL 1.2.0) 0x00000200U + */ + +/* In TLSv1.3 allow a non-(ec)dhe based kex_mode */ +# define SSL_OP_ALLOW_NO_DHE_KEX 0x00000400U + +/* + * Disable SSL 3.0/TLS 1.0 CBC vulnerability workaround that was added in + * OpenSSL 0.9.6d. Usually (depending on the application protocol) the + * workaround is not needed. Unfortunately some broken SSL/TLS + * implementations cannot handle it at all, which is why we include it in + * SSL_OP_ALL. Added in 0.9.6e + */ +# define SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS 0x00000800U + +/* DTLS options */ +# define SSL_OP_NO_QUERY_MTU 0x00001000U +/* Turn on Cookie Exchange (on relevant for servers) */ +# define SSL_OP_COOKIE_EXCHANGE 0x00002000U +/* Don't use RFC4507 ticket extension */ +# define SSL_OP_NO_TICKET 0x00004000U +# ifndef OPENSSL_NO_DTLS1_METHOD +/* Use Cisco's "speshul" version of DTLS_BAD_VER + * (only with deprecated DTLSv1_client_method()) */ +# define SSL_OP_CISCO_ANYCONNECT 0x00008000U +# endif + +/* As server, disallow session resumption on renegotiation */ +# define SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION 0x00010000U +/* Don't use compression even if supported */ +# define SSL_OP_NO_COMPRESSION 0x00020000U +/* Permit unsafe legacy renegotiation */ +# define SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION 0x00040000U +/* Disable encrypt-then-mac */ +# define SSL_OP_NO_ENCRYPT_THEN_MAC 0x00080000U + +/* + * Enable TLSv1.3 Compatibility mode. This is on by default. A future version + * of OpenSSL may have this disabled by default. + */ +# define SSL_OP_ENABLE_MIDDLEBOX_COMPAT 0x00100000U + +/* Prioritize Chacha20Poly1305 when client does. + * Modifies SSL_OP_CIPHER_SERVER_PREFERENCE */ +# define SSL_OP_PRIORITIZE_CHACHA 0x00200000U + +/* + * Set on servers to choose the cipher according to the server's preferences + */ +# define SSL_OP_CIPHER_SERVER_PREFERENCE 0x00400000U +/* + * If set, a server will allow a client to issue a SSLv3.0 version number as + * latest version supported in the premaster secret, even when TLSv1.0 + * (version 3.1) was announced in the client hello. Normally this is + * forbidden to prevent version rollback attacks. + */ +# define SSL_OP_TLS_ROLLBACK_BUG 0x00800000U + +/* + * Switches off automatic TLSv1.3 anti-replay protection for early data. This + * is a server-side option only (no effect on the client). + */ +# define SSL_OP_NO_ANTI_REPLAY 0x01000000U + +# define SSL_OP_NO_SSLv3 0x02000000U +# define SSL_OP_NO_TLSv1 0x04000000U +# define SSL_OP_NO_TLSv1_2 0x08000000U +# define SSL_OP_NO_TLSv1_1 0x10000000U +# define SSL_OP_NO_TLSv1_3 0x20000000U + +# define SSL_OP_NO_DTLSv1 0x04000000U +# define SSL_OP_NO_DTLSv1_2 0x08000000U + +# define SSL_OP_NO_SSL_MASK (SSL_OP_NO_SSLv3|\ + SSL_OP_NO_TLSv1|SSL_OP_NO_TLSv1_1|SSL_OP_NO_TLSv1_2|SSL_OP_NO_TLSv1_3) +# define SSL_OP_NO_DTLS_MASK (SSL_OP_NO_DTLSv1|SSL_OP_NO_DTLSv1_2) + +/* Disallow all renegotiation */ +# define SSL_OP_NO_RENEGOTIATION 0x40000000U + +/* + * Make server add server-hello extension from early version of cryptopro + * draft, when GOST ciphersuite is negotiated. Required for interoperability + * with CryptoPro CSP 3.x + */ +# define SSL_OP_CRYPTOPRO_TLSEXT_BUG 0x80000000U + +/* + * SSL_OP_ALL: various bug workarounds that should be rather harmless. + * This used to be 0x000FFFFFL before 0.9.7. + * This used to be 0x80000BFFU before 1.1.1. + */ +# define SSL_OP_ALL (SSL_OP_CRYPTOPRO_TLSEXT_BUG|\ + SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS|\ + SSL_OP_LEGACY_SERVER_CONNECT|\ + SSL_OP_TLSEXT_PADDING|\ + SSL_OP_SAFARI_ECDHE_ECDSA_BUG) + +/* OBSOLETE OPTIONS: retained for compatibility */ + +/* Removed from OpenSSL 1.1.0. Was 0x00000001L */ +/* Related to removed SSLv2. */ +# define SSL_OP_MICROSOFT_SESS_ID_BUG 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x00000002L */ +/* Related to removed SSLv2. */ +# define SSL_OP_NETSCAPE_CHALLENGE_BUG 0x0 +/* Removed from OpenSSL 0.9.8q and 1.0.0c. Was 0x00000008L */ +/* Dead forever, see CVE-2010-4180 */ +# define SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG 0x0 +/* Removed from OpenSSL 1.0.1h and 1.0.2. Was 0x00000010L */ +/* Refers to ancient SSLREF and SSLv2. */ +# define SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x00000020 */ +# define SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER 0x0 +/* Removed from OpenSSL 0.9.7h and 0.9.8b. Was 0x00000040L */ +# define SSL_OP_MSIE_SSLV2_RSA_PADDING 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x00000080 */ +/* Ancient SSLeay version. */ +# define SSL_OP_SSLEAY_080_CLIENT_DH_BUG 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x00000100L */ +# define SSL_OP_TLS_D5_BUG 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x00000200L */ +# define SSL_OP_TLS_BLOCK_PADDING_BUG 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x00080000L */ +# define SSL_OP_SINGLE_ECDH_USE 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x00100000L */ +# define SSL_OP_SINGLE_DH_USE 0x0 +/* Removed from OpenSSL 1.0.1k and 1.0.2. Was 0x00200000L */ +# define SSL_OP_EPHEMERAL_RSA 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x01000000L */ +# define SSL_OP_NO_SSLv2 0x0 +/* Removed from OpenSSL 1.0.1. Was 0x08000000L */ +# define SSL_OP_PKCS1_CHECK_1 0x0 +/* Removed from OpenSSL 1.0.1. Was 0x10000000L */ +# define SSL_OP_PKCS1_CHECK_2 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x20000000L */ +# define SSL_OP_NETSCAPE_CA_DN_BUG 0x0 +/* Removed from OpenSSL 1.1.0. Was 0x40000000L */ +# define SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG 0x0 + +/* + * Allow SSL_write(..., n) to return r with 0 < r < n (i.e. report success + * when just a single record has been written): + */ +# define SSL_MODE_ENABLE_PARTIAL_WRITE 0x00000001U +/* + * Make it possible to retry SSL_write() with changed buffer location (buffer + * contents must stay the same!); this is not the default to avoid the + * misconception that non-blocking SSL_write() behaves like non-blocking + * write(): + */ +# define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER 0x00000002U +/* + * Never bother the application with retries if the transport is blocking: + */ +# define SSL_MODE_AUTO_RETRY 0x00000004U +/* Don't attempt to automatically build certificate chain */ +# define SSL_MODE_NO_AUTO_CHAIN 0x00000008U +/* + * Save RAM by releasing read and write buffers when they're empty. (SSL3 and + * TLS only.) Released buffers are freed. + */ +# define SSL_MODE_RELEASE_BUFFERS 0x00000010U +/* + * Send the current time in the Random fields of the ClientHello and + * ServerHello records for compatibility with hypothetical implementations + * that require it. + */ +# define SSL_MODE_SEND_CLIENTHELLO_TIME 0x00000020U +# define SSL_MODE_SEND_SERVERHELLO_TIME 0x00000040U +/* + * Send TLS_FALLBACK_SCSV in the ClientHello. To be set only by applications + * that reconnect with a downgraded protocol version; see + * draft-ietf-tls-downgrade-scsv-00 for details. DO NOT ENABLE THIS if your + * application attempts a normal handshake. Only use this in explicit + * fallback retries, following the guidance in + * draft-ietf-tls-downgrade-scsv-00. + */ +# define SSL_MODE_SEND_FALLBACK_SCSV 0x00000080U +/* + * Support Asynchronous operation + */ +# define SSL_MODE_ASYNC 0x00000100U + +/* Cert related flags */ +/* + * Many implementations ignore some aspects of the TLS standards such as + * enforcing certificate chain algorithms. When this is set we enforce them. + */ +# define SSL_CERT_FLAG_TLS_STRICT 0x00000001U + +/* Suite B modes, takes same values as certificate verify flags */ +# define SSL_CERT_FLAG_SUITEB_128_LOS_ONLY 0x10000 +/* Suite B 192 bit only mode */ +# define SSL_CERT_FLAG_SUITEB_192_LOS 0x20000 +/* Suite B 128 bit mode allowing 192 bit algorithms */ +# define SSL_CERT_FLAG_SUITEB_128_LOS 0x30000 + +/* Perform all sorts of protocol violations for testing purposes */ +# define SSL_CERT_FLAG_BROKEN_PROTOCOL 0x10000000 + +/* Flags for building certificate chains */ +/* Treat any existing certificates as untrusted CAs */ +# define SSL_BUILD_CHAIN_FLAG_UNTRUSTED 0x1 +/* Don't include root CA in chain */ +# define SSL_BUILD_CHAIN_FLAG_NO_ROOT 0x2 +/* Just check certificates already there */ +# define SSL_BUILD_CHAIN_FLAG_CHECK 0x4 +/* Ignore verification errors */ +# define SSL_BUILD_CHAIN_FLAG_IGNORE_ERROR 0x8 +/* Clear verification errors from queue */ +# define SSL_BUILD_CHAIN_FLAG_CLEAR_ERROR 0x10 + +/* Flags returned by SSL_check_chain */ +/* Certificate can be used with this session */ +# define CERT_PKEY_VALID 0x1 +/* Certificate can also be used for signing */ +# define CERT_PKEY_SIGN 0x2 +/* EE certificate signing algorithm OK */ +# define CERT_PKEY_EE_SIGNATURE 0x10 +/* CA signature algorithms OK */ +# define CERT_PKEY_CA_SIGNATURE 0x20 +/* EE certificate parameters OK */ +# define CERT_PKEY_EE_PARAM 0x40 +/* CA certificate parameters OK */ +# define CERT_PKEY_CA_PARAM 0x80 +/* Signing explicitly allowed as opposed to SHA1 fallback */ +# define CERT_PKEY_EXPLICIT_SIGN 0x100 +/* Client CA issuer names match (always set for server cert) */ +# define CERT_PKEY_ISSUER_NAME 0x200 +/* Cert type matches client types (always set for server cert) */ +# define CERT_PKEY_CERT_TYPE 0x400 +/* Cert chain suitable to Suite B */ +# define CERT_PKEY_SUITEB 0x800 + +# define SSL_CONF_FLAG_CMDLINE 0x1 +# define SSL_CONF_FLAG_FILE 0x2 +# define SSL_CONF_FLAG_CLIENT 0x4 +# define SSL_CONF_FLAG_SERVER 0x8 +# define SSL_CONF_FLAG_SHOW_ERRORS 0x10 +# define SSL_CONF_FLAG_CERTIFICATE 0x20 +# define SSL_CONF_FLAG_REQUIRE_PRIVATE 0x40 +/* Configuration value types */ +# define SSL_CONF_TYPE_UNKNOWN 0x0 +# define SSL_CONF_TYPE_STRING 0x1 +# define SSL_CONF_TYPE_FILE 0x2 +# define SSL_CONF_TYPE_DIR 0x3 +# define SSL_CONF_TYPE_NONE 0x4 + +/* Maximum length of the application-controlled segment of a a TLSv1.3 cookie */ +# define SSL_COOKIE_LENGTH 4096 + +/* + * Note: SSL[_CTX]_set_{options,mode} use |= op on the previous value, they + * cannot be used to clear bits. + */ + +unsigned long SSL_CTX_get_options(const SSL_CTX *ctx); +unsigned long SSL_get_options(const SSL *s); +unsigned long SSL_CTX_clear_options(SSL_CTX *ctx, unsigned long op); +unsigned long SSL_clear_options(SSL *s, unsigned long op); +unsigned long SSL_CTX_set_options(SSL_CTX *ctx, unsigned long op); +unsigned long SSL_set_options(SSL *s, unsigned long op); + +# define SSL_CTX_set_mode(ctx,op) \ + SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,(op),NULL) +# define SSL_CTX_clear_mode(ctx,op) \ + SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_MODE,(op),NULL) +# define SSL_CTX_get_mode(ctx) \ + SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,0,NULL) +# define SSL_clear_mode(ssl,op) \ + SSL_ctrl((ssl),SSL_CTRL_CLEAR_MODE,(op),NULL) +# define SSL_set_mode(ssl,op) \ + SSL_ctrl((ssl),SSL_CTRL_MODE,(op),NULL) +# define SSL_get_mode(ssl) \ + SSL_ctrl((ssl),SSL_CTRL_MODE,0,NULL) +# define SSL_set_mtu(ssl, mtu) \ + SSL_ctrl((ssl),SSL_CTRL_SET_MTU,(mtu),NULL) +# define DTLS_set_link_mtu(ssl, mtu) \ + SSL_ctrl((ssl),DTLS_CTRL_SET_LINK_MTU,(mtu),NULL) +# define DTLS_get_link_min_mtu(ssl) \ + SSL_ctrl((ssl),DTLS_CTRL_GET_LINK_MIN_MTU,0,NULL) + +# define SSL_get_secure_renegotiation_support(ssl) \ + SSL_ctrl((ssl), SSL_CTRL_GET_RI_SUPPORT, 0, NULL) + +# ifndef OPENSSL_NO_HEARTBEATS +# define SSL_heartbeat(ssl) \ + SSL_ctrl((ssl),SSL_CTRL_DTLS_EXT_SEND_HEARTBEAT,0,NULL) +# endif + +# define SSL_CTX_set_cert_flags(ctx,op) \ + SSL_CTX_ctrl((ctx),SSL_CTRL_CERT_FLAGS,(op),NULL) +# define SSL_set_cert_flags(s,op) \ + SSL_ctrl((s),SSL_CTRL_CERT_FLAGS,(op),NULL) +# define SSL_CTX_clear_cert_flags(ctx,op) \ + SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_CERT_FLAGS,(op),NULL) +# define SSL_clear_cert_flags(s,op) \ + SSL_ctrl((s),SSL_CTRL_CLEAR_CERT_FLAGS,(op),NULL) + +void SSL_CTX_set_msg_callback(SSL_CTX *ctx, + void (*cb) (int write_p, int version, + int content_type, const void *buf, + size_t len, SSL *ssl, void *arg)); +void SSL_set_msg_callback(SSL *ssl, + void (*cb) (int write_p, int version, + int content_type, const void *buf, + size_t len, SSL *ssl, void *arg)); +# define SSL_CTX_set_msg_callback_arg(ctx, arg) SSL_CTX_ctrl((ctx), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg)) +# define SSL_set_msg_callback_arg(ssl, arg) SSL_ctrl((ssl), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg)) + +# define SSL_get_extms_support(s) \ + SSL_ctrl((s),SSL_CTRL_GET_EXTMS_SUPPORT,0,NULL) + +# ifndef OPENSSL_NO_SRP + +/* see tls_srp.c */ +__owur int SSL_SRP_CTX_init(SSL *s); +__owur int SSL_CTX_SRP_CTX_init(SSL_CTX *ctx); +int SSL_SRP_CTX_free(SSL *ctx); +int SSL_CTX_SRP_CTX_free(SSL_CTX *ctx); +__owur int SSL_srp_server_param_with_username(SSL *s, int *ad); +__owur int SRP_Calc_A_param(SSL *s); + +# endif + +/* 100k max cert list */ +# define SSL_MAX_CERT_LIST_DEFAULT 1024*100 + +# define SSL_SESSION_CACHE_MAX_SIZE_DEFAULT (1024*20) + +/* + * This callback type is used inside SSL_CTX, SSL, and in the functions that + * set them. It is used to override the generation of SSL/TLS session IDs in + * a server. Return value should be zero on an error, non-zero to proceed. + * Also, callbacks should themselves check if the id they generate is unique + * otherwise the SSL handshake will fail with an error - callbacks can do + * this using the 'ssl' value they're passed by; + * SSL_has_matching_session_id(ssl, id, *id_len) The length value passed in + * is set at the maximum size the session ID can be. In SSLv3/TLSv1 it is 32 + * bytes. The callback can alter this length to be less if desired. It is + * also an error for the callback to set the size to zero. + */ +typedef int (*GEN_SESSION_CB) (SSL *ssl, unsigned char *id, + unsigned int *id_len); + +# define SSL_SESS_CACHE_OFF 0x0000 +# define SSL_SESS_CACHE_CLIENT 0x0001 +# define SSL_SESS_CACHE_SERVER 0x0002 +# define SSL_SESS_CACHE_BOTH (SSL_SESS_CACHE_CLIENT|SSL_SESS_CACHE_SERVER) +# define SSL_SESS_CACHE_NO_AUTO_CLEAR 0x0080 +/* enough comments already ... see SSL_CTX_set_session_cache_mode(3) */ +# define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP 0x0100 +# define SSL_SESS_CACHE_NO_INTERNAL_STORE 0x0200 +# define SSL_SESS_CACHE_NO_INTERNAL \ + (SSL_SESS_CACHE_NO_INTERNAL_LOOKUP|SSL_SESS_CACHE_NO_INTERNAL_STORE) + +LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx); +# define SSL_CTX_sess_number(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_NUMBER,0,NULL) +# define SSL_CTX_sess_connect(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT,0,NULL) +# define SSL_CTX_sess_connect_good(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_GOOD,0,NULL) +# define SSL_CTX_sess_connect_renegotiate(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_RENEGOTIATE,0,NULL) +# define SSL_CTX_sess_accept(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT,0,NULL) +# define SSL_CTX_sess_accept_renegotiate(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_RENEGOTIATE,0,NULL) +# define SSL_CTX_sess_accept_good(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_GOOD,0,NULL) +# define SSL_CTX_sess_hits(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_HIT,0,NULL) +# define SSL_CTX_sess_cb_hits(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CB_HIT,0,NULL) +# define SSL_CTX_sess_misses(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_MISSES,0,NULL) +# define SSL_CTX_sess_timeouts(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_TIMEOUTS,0,NULL) +# define SSL_CTX_sess_cache_full(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CACHE_FULL,0,NULL) + +void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx, + int (*new_session_cb) (struct ssl_st *ssl, + SSL_SESSION *sess)); +int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx)) (struct ssl_st *ssl, + SSL_SESSION *sess); +void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx, + void (*remove_session_cb) (struct ssl_ctx_st + *ctx, + SSL_SESSION *sess)); +void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx)) (struct ssl_ctx_st *ctx, + SSL_SESSION *sess); +void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx, + SSL_SESSION *(*get_session_cb) (struct ssl_st + *ssl, + const unsigned char + *data, int len, + int *copy)); +SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx)) (struct ssl_st *ssl, + const unsigned char *data, + int len, int *copy); +void SSL_CTX_set_info_callback(SSL_CTX *ctx, + void (*cb) (const SSL *ssl, int type, int val)); +void (*SSL_CTX_get_info_callback(SSL_CTX *ctx)) (const SSL *ssl, int type, + int val); +void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx, + int (*client_cert_cb) (SSL *ssl, X509 **x509, + EVP_PKEY **pkey)); +int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx)) (SSL *ssl, X509 **x509, + EVP_PKEY **pkey); +# ifndef OPENSSL_NO_ENGINE +__owur int SSL_CTX_set_client_cert_engine(SSL_CTX *ctx, ENGINE *e); +# endif +void SSL_CTX_set_cookie_generate_cb(SSL_CTX *ctx, + int (*app_gen_cookie_cb) (SSL *ssl, + unsigned char + *cookie, + unsigned int + *cookie_len)); +void SSL_CTX_set_cookie_verify_cb(SSL_CTX *ctx, + int (*app_verify_cookie_cb) (SSL *ssl, + const unsigned + char *cookie, + unsigned int + cookie_len)); + +void SSL_CTX_set_stateless_cookie_generate_cb( + SSL_CTX *ctx, + int (*gen_stateless_cookie_cb) (SSL *ssl, + unsigned char *cookie, + size_t *cookie_len)); +void SSL_CTX_set_stateless_cookie_verify_cb( + SSL_CTX *ctx, + int (*verify_stateless_cookie_cb) (SSL *ssl, + const unsigned char *cookie, + size_t cookie_len)); +# ifndef OPENSSL_NO_NEXTPROTONEG + +typedef int (*SSL_CTX_npn_advertised_cb_func)(SSL *ssl, + const unsigned char **out, + unsigned int *outlen, + void *arg); +void SSL_CTX_set_next_protos_advertised_cb(SSL_CTX *s, + SSL_CTX_npn_advertised_cb_func cb, + void *arg); +# define SSL_CTX_set_npn_advertised_cb SSL_CTX_set_next_protos_advertised_cb + +typedef int (*SSL_CTX_npn_select_cb_func)(SSL *s, + unsigned char **out, + unsigned char *outlen, + const unsigned char *in, + unsigned int inlen, + void *arg); +void SSL_CTX_set_next_proto_select_cb(SSL_CTX *s, + SSL_CTX_npn_select_cb_func cb, + void *arg); +# define SSL_CTX_set_npn_select_cb SSL_CTX_set_next_proto_select_cb + +void SSL_get0_next_proto_negotiated(const SSL *s, const unsigned char **data, + unsigned *len); +# define SSL_get0_npn_negotiated SSL_get0_next_proto_negotiated +# endif + +__owur int SSL_select_next_proto(unsigned char **out, unsigned char *outlen, + const unsigned char *in, unsigned int inlen, + const unsigned char *client, + unsigned int client_len); + +# define OPENSSL_NPN_UNSUPPORTED 0 +# define OPENSSL_NPN_NEGOTIATED 1 +# define OPENSSL_NPN_NO_OVERLAP 2 + +__owur int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char *protos, + unsigned int protos_len); +__owur int SSL_set_alpn_protos(SSL *ssl, const unsigned char *protos, + unsigned int protos_len); +typedef int (*SSL_CTX_alpn_select_cb_func)(SSL *ssl, + const unsigned char **out, + unsigned char *outlen, + const unsigned char *in, + unsigned int inlen, + void *arg); +void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx, + SSL_CTX_alpn_select_cb_func cb, + void *arg); +void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data, + unsigned int *len); + +# ifndef OPENSSL_NO_PSK +/* + * the maximum length of the buffer given to callbacks containing the + * resulting identity/psk + */ +# define PSK_MAX_IDENTITY_LEN 128 +# define PSK_MAX_PSK_LEN 256 +typedef unsigned int (*SSL_psk_client_cb_func)(SSL *ssl, + const char *hint, + char *identity, + unsigned int max_identity_len, + unsigned char *psk, + unsigned int max_psk_len); +void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx, SSL_psk_client_cb_func cb); +void SSL_set_psk_client_callback(SSL *ssl, SSL_psk_client_cb_func cb); + +typedef unsigned int (*SSL_psk_server_cb_func)(SSL *ssl, + const char *identity, + unsigned char *psk, + unsigned int max_psk_len); +void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx, SSL_psk_server_cb_func cb); +void SSL_set_psk_server_callback(SSL *ssl, SSL_psk_server_cb_func cb); + +__owur int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint); +__owur int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint); +const char *SSL_get_psk_identity_hint(const SSL *s); +const char *SSL_get_psk_identity(const SSL *s); +# endif + +typedef int (*SSL_psk_find_session_cb_func)(SSL *ssl, + const unsigned char *identity, + size_t identity_len, + SSL_SESSION **sess); +typedef int (*SSL_psk_use_session_cb_func)(SSL *ssl, const EVP_MD *md, + const unsigned char **id, + size_t *idlen, + SSL_SESSION **sess); + +void SSL_set_psk_find_session_callback(SSL *s, SSL_psk_find_session_cb_func cb); +void SSL_CTX_set_psk_find_session_callback(SSL_CTX *ctx, + SSL_psk_find_session_cb_func cb); +void SSL_set_psk_use_session_callback(SSL *s, SSL_psk_use_session_cb_func cb); +void SSL_CTX_set_psk_use_session_callback(SSL_CTX *ctx, + SSL_psk_use_session_cb_func cb); + +/* Register callbacks to handle custom TLS Extensions for client or server. */ + +__owur int SSL_CTX_has_client_custom_ext(const SSL_CTX *ctx, + unsigned int ext_type); + +__owur int SSL_CTX_add_client_custom_ext(SSL_CTX *ctx, + unsigned int ext_type, + custom_ext_add_cb add_cb, + custom_ext_free_cb free_cb, + void *add_arg, + custom_ext_parse_cb parse_cb, + void *parse_arg); + +__owur int SSL_CTX_add_server_custom_ext(SSL_CTX *ctx, + unsigned int ext_type, + custom_ext_add_cb add_cb, + custom_ext_free_cb free_cb, + void *add_arg, + custom_ext_parse_cb parse_cb, + void *parse_arg); + +__owur int SSL_CTX_add_custom_ext(SSL_CTX *ctx, unsigned int ext_type, + unsigned int context, + SSL_custom_ext_add_cb_ex add_cb, + SSL_custom_ext_free_cb_ex free_cb, + void *add_arg, + SSL_custom_ext_parse_cb_ex parse_cb, + void *parse_arg); + +__owur int SSL_extension_supported(unsigned int ext_type); + +# define SSL_NOTHING 1 +# define SSL_WRITING 2 +# define SSL_READING 3 +# define SSL_X509_LOOKUP 4 +# define SSL_ASYNC_PAUSED 5 +# define SSL_ASYNC_NO_JOBS 6 +# define SSL_CLIENT_HELLO_CB 7 + +/* These will only be used when doing non-blocking IO */ +# define SSL_want_nothing(s) (SSL_want(s) == SSL_NOTHING) +# define SSL_want_read(s) (SSL_want(s) == SSL_READING) +# define SSL_want_write(s) (SSL_want(s) == SSL_WRITING) +# define SSL_want_x509_lookup(s) (SSL_want(s) == SSL_X509_LOOKUP) +# define SSL_want_async(s) (SSL_want(s) == SSL_ASYNC_PAUSED) +# define SSL_want_async_job(s) (SSL_want(s) == SSL_ASYNC_NO_JOBS) +# define SSL_want_client_hello_cb(s) (SSL_want(s) == SSL_CLIENT_HELLO_CB) + +# define SSL_MAC_FLAG_READ_MAC_STREAM 1 +# define SSL_MAC_FLAG_WRITE_MAC_STREAM 2 + +/* + * A callback for logging out TLS key material. This callback should log out + * |line| followed by a newline. + */ +typedef void (*SSL_CTX_keylog_cb_func)(const SSL *ssl, const char *line); + +/* + * SSL_CTX_set_keylog_callback configures a callback to log key material. This + * is intended for debugging use with tools like Wireshark. The cb function + * should log line followed by a newline. + */ +void SSL_CTX_set_keylog_callback(SSL_CTX *ctx, SSL_CTX_keylog_cb_func cb); + +/* + * SSL_CTX_get_keylog_callback returns the callback configured by + * SSL_CTX_set_keylog_callback. + */ +SSL_CTX_keylog_cb_func SSL_CTX_get_keylog_callback(const SSL_CTX *ctx); + +int SSL_CTX_set_max_early_data(SSL_CTX *ctx, uint32_t max_early_data); +uint32_t SSL_CTX_get_max_early_data(const SSL_CTX *ctx); +int SSL_set_max_early_data(SSL *s, uint32_t max_early_data); +uint32_t SSL_get_max_early_data(const SSL *s); +int SSL_CTX_set_recv_max_early_data(SSL_CTX *ctx, uint32_t recv_max_early_data); +uint32_t SSL_CTX_get_recv_max_early_data(const SSL_CTX *ctx); +int SSL_set_recv_max_early_data(SSL *s, uint32_t recv_max_early_data); +uint32_t SSL_get_recv_max_early_data(const SSL *s); + +#ifdef __cplusplus +} +#endif + +# include +# include +# include /* This is mostly sslv3 with a few tweaks */ +# include /* Datagram TLS */ +# include /* Support for the use_srtp extension */ + +#ifdef __cplusplus +extern "C" { +#endif + +/* + * These need to be after the above set of includes due to a compiler bug + * in VisualStudio 2015 + */ +DEFINE_STACK_OF_CONST(SSL_CIPHER) +DEFINE_STACK_OF(SSL_COMP) + +/* compatibility */ +# define SSL_set_app_data(s,arg) (SSL_set_ex_data(s,0,(char *)(arg))) +# define SSL_get_app_data(s) (SSL_get_ex_data(s,0)) +# define SSL_SESSION_set_app_data(s,a) (SSL_SESSION_set_ex_data(s,0, \ + (char *)(a))) +# define SSL_SESSION_get_app_data(s) (SSL_SESSION_get_ex_data(s,0)) +# define SSL_CTX_get_app_data(ctx) (SSL_CTX_get_ex_data(ctx,0)) +# define SSL_CTX_set_app_data(ctx,arg) (SSL_CTX_set_ex_data(ctx,0, \ + (char *)(arg))) +DEPRECATEDIN_1_1_0(void SSL_set_debug(SSL *s, int debug)) + +/* TLSv1.3 KeyUpdate message types */ +/* -1 used so that this is an invalid value for the on-the-wire protocol */ +#define SSL_KEY_UPDATE_NONE -1 +/* Values as defined for the on-the-wire protocol */ +#define SSL_KEY_UPDATE_NOT_REQUESTED 0 +#define SSL_KEY_UPDATE_REQUESTED 1 + +/* + * The valid handshake states (one for each type message sent and one for each + * type of message received). There are also two "special" states: + * TLS = TLS or DTLS state + * DTLS = DTLS specific state + * CR/SR = Client Read/Server Read + * CW/SW = Client Write/Server Write + * + * The "special" states are: + * TLS_ST_BEFORE = No handshake has been initiated yet + * TLS_ST_OK = A handshake has been successfully completed + */ +typedef enum { + TLS_ST_BEFORE, + TLS_ST_OK, + DTLS_ST_CR_HELLO_VERIFY_REQUEST, + TLS_ST_CR_SRVR_HELLO, + TLS_ST_CR_CERT, + TLS_ST_CR_CERT_STATUS, + TLS_ST_CR_KEY_EXCH, + TLS_ST_CR_CERT_REQ, + TLS_ST_CR_SRVR_DONE, + TLS_ST_CR_SESSION_TICKET, + TLS_ST_CR_CHANGE, + TLS_ST_CR_FINISHED, + TLS_ST_CW_CLNT_HELLO, + TLS_ST_CW_CERT, + TLS_ST_CW_KEY_EXCH, + TLS_ST_CW_CERT_VRFY, + TLS_ST_CW_CHANGE, + TLS_ST_CW_NEXT_PROTO, + TLS_ST_CW_FINISHED, + TLS_ST_SW_HELLO_REQ, + TLS_ST_SR_CLNT_HELLO, + DTLS_ST_SW_HELLO_VERIFY_REQUEST, + TLS_ST_SW_SRVR_HELLO, + TLS_ST_SW_CERT, + TLS_ST_SW_KEY_EXCH, + TLS_ST_SW_CERT_REQ, + TLS_ST_SW_SRVR_DONE, + TLS_ST_SR_CERT, + TLS_ST_SR_KEY_EXCH, + TLS_ST_SR_CERT_VRFY, + TLS_ST_SR_NEXT_PROTO, + TLS_ST_SR_CHANGE, + TLS_ST_SR_FINISHED, + TLS_ST_SW_SESSION_TICKET, + TLS_ST_SW_CERT_STATUS, + TLS_ST_SW_CHANGE, + TLS_ST_SW_FINISHED, + TLS_ST_SW_ENCRYPTED_EXTENSIONS, + TLS_ST_CR_ENCRYPTED_EXTENSIONS, + TLS_ST_CR_CERT_VRFY, + TLS_ST_SW_CERT_VRFY, + TLS_ST_CR_HELLO_REQ, + TLS_ST_SW_KEY_UPDATE, + TLS_ST_CW_KEY_UPDATE, + TLS_ST_SR_KEY_UPDATE, + TLS_ST_CR_KEY_UPDATE, + TLS_ST_EARLY_DATA, + TLS_ST_PENDING_EARLY_DATA_END, + TLS_ST_CW_END_OF_EARLY_DATA, + TLS_ST_SR_END_OF_EARLY_DATA +} OSSL_HANDSHAKE_STATE; + +/* + * Most of the following state values are no longer used and are defined to be + * the closest equivalent value in the current state machine code. Not all + * defines have an equivalent and are set to a dummy value (-1). SSL_ST_CONNECT + * and SSL_ST_ACCEPT are still in use in the definition of SSL_CB_ACCEPT_LOOP, + * SSL_CB_ACCEPT_EXIT, SSL_CB_CONNECT_LOOP and SSL_CB_CONNECT_EXIT. + */ + +# define SSL_ST_CONNECT 0x1000 +# define SSL_ST_ACCEPT 0x2000 + +# define SSL_ST_MASK 0x0FFF + +# define SSL_CB_LOOP 0x01 +# define SSL_CB_EXIT 0x02 +# define SSL_CB_READ 0x04 +# define SSL_CB_WRITE 0x08 +# define SSL_CB_ALERT 0x4000/* used in callback */ +# define SSL_CB_READ_ALERT (SSL_CB_ALERT|SSL_CB_READ) +# define SSL_CB_WRITE_ALERT (SSL_CB_ALERT|SSL_CB_WRITE) +# define SSL_CB_ACCEPT_LOOP (SSL_ST_ACCEPT|SSL_CB_LOOP) +# define SSL_CB_ACCEPT_EXIT (SSL_ST_ACCEPT|SSL_CB_EXIT) +# define SSL_CB_CONNECT_LOOP (SSL_ST_CONNECT|SSL_CB_LOOP) +# define SSL_CB_CONNECT_EXIT (SSL_ST_CONNECT|SSL_CB_EXIT) +# define SSL_CB_HANDSHAKE_START 0x10 +# define SSL_CB_HANDSHAKE_DONE 0x20 + +/* Is the SSL_connection established? */ +# define SSL_in_connect_init(a) (SSL_in_init(a) && !SSL_is_server(a)) +# define SSL_in_accept_init(a) (SSL_in_init(a) && SSL_is_server(a)) +int SSL_in_init(const SSL *s); +int SSL_in_before(const SSL *s); +int SSL_is_init_finished(const SSL *s); + +/* + * The following 3 states are kept in ssl->rlayer.rstate when reads fail, you + * should not need these + */ +# define SSL_ST_READ_HEADER 0xF0 +# define SSL_ST_READ_BODY 0xF1 +# define SSL_ST_READ_DONE 0xF2 + +/*- + * Obtain latest Finished message + * -- that we sent (SSL_get_finished) + * -- that we expected from peer (SSL_get_peer_finished). + * Returns length (0 == no Finished so far), copies up to 'count' bytes. + */ +size_t SSL_get_finished(const SSL *s, void *buf, size_t count); +size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count); + +/* + * use either SSL_VERIFY_NONE or SSL_VERIFY_PEER, the last 3 options are + * 'ored' with SSL_VERIFY_PEER if they are desired + */ +# define SSL_VERIFY_NONE 0x00 +# define SSL_VERIFY_PEER 0x01 +# define SSL_VERIFY_FAIL_IF_NO_PEER_CERT 0x02 +# define SSL_VERIFY_CLIENT_ONCE 0x04 +# define SSL_VERIFY_POST_HANDSHAKE 0x08 + +# if OPENSSL_API_COMPAT < 0x10100000L +# define OpenSSL_add_ssl_algorithms() SSL_library_init() +# define SSLeay_add_ssl_algorithms() SSL_library_init() +# endif + +/* More backward compatibility */ +# define SSL_get_cipher(s) \ + SSL_CIPHER_get_name(SSL_get_current_cipher(s)) +# define SSL_get_cipher_bits(s,np) \ + SSL_CIPHER_get_bits(SSL_get_current_cipher(s),np) +# define SSL_get_cipher_version(s) \ + SSL_CIPHER_get_version(SSL_get_current_cipher(s)) +# define SSL_get_cipher_name(s) \ + SSL_CIPHER_get_name(SSL_get_current_cipher(s)) +# define SSL_get_time(a) SSL_SESSION_get_time(a) +# define SSL_set_time(a,b) SSL_SESSION_set_time((a),(b)) +# define SSL_get_timeout(a) SSL_SESSION_get_timeout(a) +# define SSL_set_timeout(a,b) SSL_SESSION_set_timeout((a),(b)) + +# define d2i_SSL_SESSION_bio(bp,s_id) ASN1_d2i_bio_of(SSL_SESSION,SSL_SESSION_new,d2i_SSL_SESSION,bp,s_id) +# define i2d_SSL_SESSION_bio(bp,s_id) ASN1_i2d_bio_of(SSL_SESSION,i2d_SSL_SESSION,bp,s_id) + +DECLARE_PEM_rw(SSL_SESSION, SSL_SESSION) +# define SSL_AD_REASON_OFFSET 1000/* offset to get SSL_R_... value + * from SSL_AD_... */ +/* These alert types are for SSLv3 and TLSv1 */ +# define SSL_AD_CLOSE_NOTIFY SSL3_AD_CLOSE_NOTIFY +/* fatal */ +# define SSL_AD_UNEXPECTED_MESSAGE SSL3_AD_UNEXPECTED_MESSAGE +/* fatal */ +# define SSL_AD_BAD_RECORD_MAC SSL3_AD_BAD_RECORD_MAC +# define SSL_AD_DECRYPTION_FAILED TLS1_AD_DECRYPTION_FAILED +# define SSL_AD_RECORD_OVERFLOW TLS1_AD_RECORD_OVERFLOW +/* fatal */ +# define SSL_AD_DECOMPRESSION_FAILURE SSL3_AD_DECOMPRESSION_FAILURE +/* fatal */ +# define SSL_AD_HANDSHAKE_FAILURE SSL3_AD_HANDSHAKE_FAILURE +/* Not for TLS */ +# define SSL_AD_NO_CERTIFICATE SSL3_AD_NO_CERTIFICATE +# define SSL_AD_BAD_CERTIFICATE SSL3_AD_BAD_CERTIFICATE +# define SSL_AD_UNSUPPORTED_CERTIFICATE SSL3_AD_UNSUPPORTED_CERTIFICATE +# define SSL_AD_CERTIFICATE_REVOKED SSL3_AD_CERTIFICATE_REVOKED +# define SSL_AD_CERTIFICATE_EXPIRED SSL3_AD_CERTIFICATE_EXPIRED +# define SSL_AD_CERTIFICATE_UNKNOWN SSL3_AD_CERTIFICATE_UNKNOWN +/* fatal */ +# define SSL_AD_ILLEGAL_PARAMETER SSL3_AD_ILLEGAL_PARAMETER +/* fatal */ +# define SSL_AD_UNKNOWN_CA TLS1_AD_UNKNOWN_CA +/* fatal */ +# define SSL_AD_ACCESS_DENIED TLS1_AD_ACCESS_DENIED +/* fatal */ +# define SSL_AD_DECODE_ERROR TLS1_AD_DECODE_ERROR +# define SSL_AD_DECRYPT_ERROR TLS1_AD_DECRYPT_ERROR +/* fatal */ +# define SSL_AD_EXPORT_RESTRICTION TLS1_AD_EXPORT_RESTRICTION +/* fatal */ +# define SSL_AD_PROTOCOL_VERSION TLS1_AD_PROTOCOL_VERSION +/* fatal */ +# define SSL_AD_INSUFFICIENT_SECURITY TLS1_AD_INSUFFICIENT_SECURITY +/* fatal */ +# define SSL_AD_INTERNAL_ERROR TLS1_AD_INTERNAL_ERROR +# define SSL_AD_USER_CANCELLED TLS1_AD_USER_CANCELLED +# define SSL_AD_NO_RENEGOTIATION TLS1_AD_NO_RENEGOTIATION +# define SSL_AD_MISSING_EXTENSION TLS13_AD_MISSING_EXTENSION +# define SSL_AD_CERTIFICATE_REQUIRED TLS13_AD_CERTIFICATE_REQUIRED +# define SSL_AD_UNSUPPORTED_EXTENSION TLS1_AD_UNSUPPORTED_EXTENSION +# define SSL_AD_CERTIFICATE_UNOBTAINABLE TLS1_AD_CERTIFICATE_UNOBTAINABLE +# define SSL_AD_UNRECOGNIZED_NAME TLS1_AD_UNRECOGNIZED_NAME +# define SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE +# define SSL_AD_BAD_CERTIFICATE_HASH_VALUE TLS1_AD_BAD_CERTIFICATE_HASH_VALUE +/* fatal */ +# define SSL_AD_UNKNOWN_PSK_IDENTITY TLS1_AD_UNKNOWN_PSK_IDENTITY +/* fatal */ +# define SSL_AD_INAPPROPRIATE_FALLBACK TLS1_AD_INAPPROPRIATE_FALLBACK +# define SSL_AD_NO_APPLICATION_PROTOCOL TLS1_AD_NO_APPLICATION_PROTOCOL +# define SSL_ERROR_NONE 0 +# define SSL_ERROR_SSL 1 +# define SSL_ERROR_WANT_READ 2 +# define SSL_ERROR_WANT_WRITE 3 +# define SSL_ERROR_WANT_X509_LOOKUP 4 +# define SSL_ERROR_SYSCALL 5/* look at error stack/return + * value/errno */ +# define SSL_ERROR_ZERO_RETURN 6 +# define SSL_ERROR_WANT_CONNECT 7 +# define SSL_ERROR_WANT_ACCEPT 8 +# define SSL_ERROR_WANT_ASYNC 9 +# define SSL_ERROR_WANT_ASYNC_JOB 10 +# define SSL_ERROR_WANT_CLIENT_HELLO_CB 11 +# define SSL_CTRL_SET_TMP_DH 3 +# define SSL_CTRL_SET_TMP_ECDH 4 +# define SSL_CTRL_SET_TMP_DH_CB 6 +# define SSL_CTRL_GET_CLIENT_CERT_REQUEST 9 +# define SSL_CTRL_GET_NUM_RENEGOTIATIONS 10 +# define SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS 11 +# define SSL_CTRL_GET_TOTAL_RENEGOTIATIONS 12 +# define SSL_CTRL_GET_FLAGS 13 +# define SSL_CTRL_EXTRA_CHAIN_CERT 14 +# define SSL_CTRL_SET_MSG_CALLBACK 15 +# define SSL_CTRL_SET_MSG_CALLBACK_ARG 16 +/* only applies to datagram connections */ +# define SSL_CTRL_SET_MTU 17 +/* Stats */ +# define SSL_CTRL_SESS_NUMBER 20 +# define SSL_CTRL_SESS_CONNECT 21 +# define SSL_CTRL_SESS_CONNECT_GOOD 22 +# define SSL_CTRL_SESS_CONNECT_RENEGOTIATE 23 +# define SSL_CTRL_SESS_ACCEPT 24 +# define SSL_CTRL_SESS_ACCEPT_GOOD 25 +# define SSL_CTRL_SESS_ACCEPT_RENEGOTIATE 26 +# define SSL_CTRL_SESS_HIT 27 +# define SSL_CTRL_SESS_CB_HIT 28 +# define SSL_CTRL_SESS_MISSES 29 +# define SSL_CTRL_SESS_TIMEOUTS 30 +# define SSL_CTRL_SESS_CACHE_FULL 31 +# define SSL_CTRL_MODE 33 +# define SSL_CTRL_GET_READ_AHEAD 40 +# define SSL_CTRL_SET_READ_AHEAD 41 +# define SSL_CTRL_SET_SESS_CACHE_SIZE 42 +# define SSL_CTRL_GET_SESS_CACHE_SIZE 43 +# define SSL_CTRL_SET_SESS_CACHE_MODE 44 +# define SSL_CTRL_GET_SESS_CACHE_MODE 45 +# define SSL_CTRL_GET_MAX_CERT_LIST 50 +# define SSL_CTRL_SET_MAX_CERT_LIST 51 +# define SSL_CTRL_SET_MAX_SEND_FRAGMENT 52 +/* see tls1.h for macros based on these */ +# define SSL_CTRL_SET_TLSEXT_SERVERNAME_CB 53 +# define SSL_CTRL_SET_TLSEXT_SERVERNAME_ARG 54 +# define SSL_CTRL_SET_TLSEXT_HOSTNAME 55 +# define SSL_CTRL_SET_TLSEXT_DEBUG_CB 56 +# define SSL_CTRL_SET_TLSEXT_DEBUG_ARG 57 +# define SSL_CTRL_GET_TLSEXT_TICKET_KEYS 58 +# define SSL_CTRL_SET_TLSEXT_TICKET_KEYS 59 +/*# define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT 60 */ +/*# define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB 61 */ +/*# define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB_ARG 62 */ +# define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB 63 +# define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB_ARG 64 +# define SSL_CTRL_SET_TLSEXT_STATUS_REQ_TYPE 65 +# define SSL_CTRL_GET_TLSEXT_STATUS_REQ_EXTS 66 +# define SSL_CTRL_SET_TLSEXT_STATUS_REQ_EXTS 67 +# define SSL_CTRL_GET_TLSEXT_STATUS_REQ_IDS 68 +# define SSL_CTRL_SET_TLSEXT_STATUS_REQ_IDS 69 +# define SSL_CTRL_GET_TLSEXT_STATUS_REQ_OCSP_RESP 70 +# define SSL_CTRL_SET_TLSEXT_STATUS_REQ_OCSP_RESP 71 +# define SSL_CTRL_SET_TLSEXT_TICKET_KEY_CB 72 +# define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME_CB 75 +# define SSL_CTRL_SET_SRP_VERIFY_PARAM_CB 76 +# define SSL_CTRL_SET_SRP_GIVE_CLIENT_PWD_CB 77 +# define SSL_CTRL_SET_SRP_ARG 78 +# define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME 79 +# define SSL_CTRL_SET_TLS_EXT_SRP_STRENGTH 80 +# define SSL_CTRL_SET_TLS_EXT_SRP_PASSWORD 81 +# ifndef OPENSSL_NO_HEARTBEATS +# define SSL_CTRL_DTLS_EXT_SEND_HEARTBEAT 85 +# define SSL_CTRL_GET_DTLS_EXT_HEARTBEAT_PENDING 86 +# define SSL_CTRL_SET_DTLS_EXT_HEARTBEAT_NO_REQUESTS 87 +# endif +# define DTLS_CTRL_GET_TIMEOUT 73 +# define DTLS_CTRL_HANDLE_TIMEOUT 74 +# define SSL_CTRL_GET_RI_SUPPORT 76 +# define SSL_CTRL_CLEAR_MODE 78 +# define SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB 79 +# define SSL_CTRL_GET_EXTRA_CHAIN_CERTS 82 +# define SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS 83 +# define SSL_CTRL_CHAIN 88 +# define SSL_CTRL_CHAIN_CERT 89 +# define SSL_CTRL_GET_GROUPS 90 +# define SSL_CTRL_SET_GROUPS 91 +# define SSL_CTRL_SET_GROUPS_LIST 92 +# define SSL_CTRL_GET_SHARED_GROUP 93 +# define SSL_CTRL_SET_SIGALGS 97 +# define SSL_CTRL_SET_SIGALGS_LIST 98 +# define SSL_CTRL_CERT_FLAGS 99 +# define SSL_CTRL_CLEAR_CERT_FLAGS 100 +# define SSL_CTRL_SET_CLIENT_SIGALGS 101 +# define SSL_CTRL_SET_CLIENT_SIGALGS_LIST 102 +# define SSL_CTRL_GET_CLIENT_CERT_TYPES 103 +# define SSL_CTRL_SET_CLIENT_CERT_TYPES 104 +# define SSL_CTRL_BUILD_CERT_CHAIN 105 +# define SSL_CTRL_SET_VERIFY_CERT_STORE 106 +# define SSL_CTRL_SET_CHAIN_CERT_STORE 107 +# define SSL_CTRL_GET_PEER_SIGNATURE_NID 108 +# define SSL_CTRL_GET_SERVER_TMP_KEY 109 +# define SSL_CTRL_GET_RAW_CIPHERLIST 110 +# define SSL_CTRL_GET_EC_POINT_FORMATS 111 +# define SSL_CTRL_GET_CHAIN_CERTS 115 +# define SSL_CTRL_SELECT_CURRENT_CERT 116 +# define SSL_CTRL_SET_CURRENT_CERT 117 +# define SSL_CTRL_SET_DH_AUTO 118 +# define DTLS_CTRL_SET_LINK_MTU 120 +# define DTLS_CTRL_GET_LINK_MIN_MTU 121 +# define SSL_CTRL_GET_EXTMS_SUPPORT 122 +# define SSL_CTRL_SET_MIN_PROTO_VERSION 123 +# define SSL_CTRL_SET_MAX_PROTO_VERSION 124 +# define SSL_CTRL_SET_SPLIT_SEND_FRAGMENT 125 +# define SSL_CTRL_SET_MAX_PIPELINES 126 +# define SSL_CTRL_GET_TLSEXT_STATUS_REQ_TYPE 127 +# define SSL_CTRL_GET_TLSEXT_STATUS_REQ_CB 128 +# define SSL_CTRL_GET_TLSEXT_STATUS_REQ_CB_ARG 129 +# define SSL_CTRL_GET_MIN_PROTO_VERSION 130 +# define SSL_CTRL_GET_MAX_PROTO_VERSION 131 +# define SSL_CERT_SET_FIRST 1 +# define SSL_CERT_SET_NEXT 2 +# define SSL_CERT_SET_SERVER 3 +# define DTLSv1_get_timeout(ssl, arg) \ + SSL_ctrl(ssl,DTLS_CTRL_GET_TIMEOUT,0, (void *)(arg)) +# define DTLSv1_handle_timeout(ssl) \ + SSL_ctrl(ssl,DTLS_CTRL_HANDLE_TIMEOUT,0, NULL) +# define SSL_num_renegotiations(ssl) \ + SSL_ctrl((ssl),SSL_CTRL_GET_NUM_RENEGOTIATIONS,0,NULL) +# define SSL_clear_num_renegotiations(ssl) \ + SSL_ctrl((ssl),SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS,0,NULL) +# define SSL_total_renegotiations(ssl) \ + SSL_ctrl((ssl),SSL_CTRL_GET_TOTAL_RENEGOTIATIONS,0,NULL) +# define SSL_CTX_set_tmp_dh(ctx,dh) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_DH,0,(char *)(dh)) +# define SSL_CTX_set_tmp_ecdh(ctx,ecdh) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_ECDH,0,(char *)(ecdh)) +# define SSL_CTX_set_dh_auto(ctx, onoff) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_DH_AUTO,onoff,NULL) +# define SSL_set_dh_auto(s, onoff) \ + SSL_ctrl(s,SSL_CTRL_SET_DH_AUTO,onoff,NULL) +# define SSL_set_tmp_dh(ssl,dh) \ + SSL_ctrl(ssl,SSL_CTRL_SET_TMP_DH,0,(char *)(dh)) +# define SSL_set_tmp_ecdh(ssl,ecdh) \ + SSL_ctrl(ssl,SSL_CTRL_SET_TMP_ECDH,0,(char *)(ecdh)) +# define SSL_CTX_add_extra_chain_cert(ctx,x509) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_EXTRA_CHAIN_CERT,0,(char *)(x509)) +# define SSL_CTX_get_extra_chain_certs(ctx,px509) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_EXTRA_CHAIN_CERTS,0,px509) +# define SSL_CTX_get_extra_chain_certs_only(ctx,px509) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_EXTRA_CHAIN_CERTS,1,px509) +# define SSL_CTX_clear_extra_chain_certs(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS,0,NULL) +# define SSL_CTX_set0_chain(ctx,sk) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,0,(char *)(sk)) +# define SSL_CTX_set1_chain(ctx,sk) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,1,(char *)(sk)) +# define SSL_CTX_add0_chain_cert(ctx,x509) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,0,(char *)(x509)) +# define SSL_CTX_add1_chain_cert(ctx,x509) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,1,(char *)(x509)) +# define SSL_CTX_get0_chain_certs(ctx,px509) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERTS,0,px509) +# define SSL_CTX_clear_chain_certs(ctx) \ + SSL_CTX_set0_chain(ctx,NULL) +# define SSL_CTX_build_cert_chain(ctx, flags) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL) +# define SSL_CTX_select_current_cert(ctx,x509) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)(x509)) +# define SSL_CTX_set_current_cert(ctx, op) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CURRENT_CERT, op, NULL) +# define SSL_CTX_set0_verify_cert_store(ctx,st) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)(st)) +# define SSL_CTX_set1_verify_cert_store(ctx,st) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)(st)) +# define SSL_CTX_set0_chain_cert_store(ctx,st) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)(st)) +# define SSL_CTX_set1_chain_cert_store(ctx,st) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)(st)) +# define SSL_set0_chain(ctx,sk) \ + SSL_ctrl(ctx,SSL_CTRL_CHAIN,0,(char *)(sk)) +# define SSL_set1_chain(ctx,sk) \ + SSL_ctrl(ctx,SSL_CTRL_CHAIN,1,(char *)(sk)) +# define SSL_add0_chain_cert(ctx,x509) \ + SSL_ctrl(ctx,SSL_CTRL_CHAIN_CERT,0,(char *)(x509)) +# define SSL_add1_chain_cert(ctx,x509) \ + SSL_ctrl(ctx,SSL_CTRL_CHAIN_CERT,1,(char *)(x509)) +# define SSL_get0_chain_certs(ctx,px509) \ + SSL_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERTS,0,px509) +# define SSL_clear_chain_certs(ctx) \ + SSL_set0_chain(ctx,NULL) +# define SSL_build_cert_chain(s, flags) \ + SSL_ctrl(s,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL) +# define SSL_select_current_cert(ctx,x509) \ + SSL_ctrl(ctx,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)(x509)) +# define SSL_set_current_cert(ctx,op) \ + SSL_ctrl(ctx,SSL_CTRL_SET_CURRENT_CERT, op, NULL) +# define SSL_set0_verify_cert_store(s,st) \ + SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)(st)) +# define SSL_set1_verify_cert_store(s,st) \ + SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)(st)) +# define SSL_set0_chain_cert_store(s,st) \ + SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)(st)) +# define SSL_set1_chain_cert_store(s,st) \ + SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)(st)) +# define SSL_get1_groups(ctx, s) \ + SSL_ctrl(ctx,SSL_CTRL_GET_GROUPS,0,(char *)(s)) +# define SSL_CTX_set1_groups(ctx, glist, glistlen) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_GROUPS,glistlen,(char *)(glist)) +# define SSL_CTX_set1_groups_list(ctx, s) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_GROUPS_LIST,0,(char *)(s)) +# define SSL_set1_groups(ctx, glist, glistlen) \ + SSL_ctrl(ctx,SSL_CTRL_SET_GROUPS,glistlen,(char *)(glist)) +# define SSL_set1_groups_list(ctx, s) \ + SSL_ctrl(ctx,SSL_CTRL_SET_GROUPS_LIST,0,(char *)(s)) +# define SSL_get_shared_group(s, n) \ + SSL_ctrl(s,SSL_CTRL_GET_SHARED_GROUP,n,NULL) +# define SSL_CTX_set1_sigalgs(ctx, slist, slistlen) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS,slistlen,(int *)(slist)) +# define SSL_CTX_set1_sigalgs_list(ctx, s) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)(s)) +# define SSL_set1_sigalgs(ctx, slist, slistlen) \ + SSL_ctrl(ctx,SSL_CTRL_SET_SIGALGS,slistlen,(int *)(slist)) +# define SSL_set1_sigalgs_list(ctx, s) \ + SSL_ctrl(ctx,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)(s)) +# define SSL_CTX_set1_client_sigalgs(ctx, slist, slistlen) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS,slistlen,(int *)(slist)) +# define SSL_CTX_set1_client_sigalgs_list(ctx, s) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)(s)) +# define SSL_set1_client_sigalgs(ctx, slist, slistlen) \ + SSL_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS,clistlen,(int *)(slist)) +# define SSL_set1_client_sigalgs_list(ctx, s) \ + SSL_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)(s)) +# define SSL_get0_certificate_types(s, clist) \ + SSL_ctrl(s, SSL_CTRL_GET_CLIENT_CERT_TYPES, 0, (char *)(clist)) +# define SSL_CTX_set1_client_certificate_types(ctx, clist, clistlen) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen, \ + (char *)(clist)) +# define SSL_set1_client_certificate_types(s, clist, clistlen) \ + SSL_ctrl(s,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen,(char *)(clist)) +# define SSL_get_peer_signature_nid(s, pn) \ + SSL_ctrl(s,SSL_CTRL_GET_PEER_SIGNATURE_NID,0,pn) +# define SSL_get_server_tmp_key(s, pk) \ + SSL_ctrl(s,SSL_CTRL_GET_SERVER_TMP_KEY,0,pk) +# define SSL_get0_raw_cipherlist(s, plst) \ + SSL_ctrl(s,SSL_CTRL_GET_RAW_CIPHERLIST,0,plst) +# define SSL_get0_ec_point_formats(s, plst) \ + SSL_ctrl(s,SSL_CTRL_GET_EC_POINT_FORMATS,0,plst) +# define SSL_CTX_set_min_proto_version(ctx, version) \ + SSL_CTX_ctrl(ctx, SSL_CTRL_SET_MIN_PROTO_VERSION, version, NULL) +# define SSL_CTX_set_max_proto_version(ctx, version) \ + SSL_CTX_ctrl(ctx, SSL_CTRL_SET_MAX_PROTO_VERSION, version, NULL) +# define SSL_CTX_get_min_proto_version(ctx) \ + SSL_CTX_ctrl(ctx, SSL_CTRL_GET_MIN_PROTO_VERSION, 0, NULL) +# define SSL_CTX_get_max_proto_version(ctx) \ + SSL_CTX_ctrl(ctx, SSL_CTRL_GET_MAX_PROTO_VERSION, 0, NULL) +# define SSL_set_min_proto_version(s, version) \ + SSL_ctrl(s, SSL_CTRL_SET_MIN_PROTO_VERSION, version, NULL) +# define SSL_set_max_proto_version(s, version) \ + SSL_ctrl(s, SSL_CTRL_SET_MAX_PROTO_VERSION, version, NULL) +# define SSL_get_min_proto_version(s) \ + SSL_ctrl(s, SSL_CTRL_GET_MIN_PROTO_VERSION, 0, NULL) +# define SSL_get_max_proto_version(s) \ + SSL_ctrl(s, SSL_CTRL_GET_MAX_PROTO_VERSION, 0, NULL) + +/* + * The following symbol names are old and obsolete. They are kept + * for compatibility reasons only and should not be used anymore. + */ +# define SSL_CTRL_GET_CURVES SSL_CTRL_GET_GROUPS +# define SSL_CTRL_SET_CURVES SSL_CTRL_SET_GROUPS +# define SSL_CTRL_SET_CURVES_LIST SSL_CTRL_SET_GROUPS_LIST +# define SSL_CTRL_GET_SHARED_CURVE SSL_CTRL_GET_SHARED_GROUP + +# define SSL_get1_curves SSL_get1_groups +# define SSL_CTX_set1_curves SSL_CTX_set1_groups +# define SSL_CTX_set1_curves_list SSL_CTX_set1_groups_list +# define SSL_set1_curves SSL_set1_groups +# define SSL_set1_curves_list SSL_set1_groups_list +# define SSL_get_shared_curve SSL_get_shared_group + + +# if OPENSSL_API_COMPAT < 0x10100000L +/* Provide some compatibility macros for removed functionality. */ +# define SSL_CTX_need_tmp_RSA(ctx) 0 +# define SSL_CTX_set_tmp_rsa(ctx,rsa) 1 +# define SSL_need_tmp_RSA(ssl) 0 +# define SSL_set_tmp_rsa(ssl,rsa) 1 +# define SSL_CTX_set_ecdh_auto(dummy, onoff) ((onoff) != 0) +# define SSL_set_ecdh_auto(dummy, onoff) ((onoff) != 0) +/* + * We "pretend" to call the callback to avoid warnings about unused static + * functions. + */ +# define SSL_CTX_set_tmp_rsa_callback(ctx, cb) while(0) (cb)(NULL, 0, 0) +# define SSL_set_tmp_rsa_callback(ssl, cb) while(0) (cb)(NULL, 0, 0) +# endif +__owur const BIO_METHOD *BIO_f_ssl(void); +__owur BIO *BIO_new_ssl(SSL_CTX *ctx, int client); +__owur BIO *BIO_new_ssl_connect(SSL_CTX *ctx); +__owur BIO *BIO_new_buffer_ssl_connect(SSL_CTX *ctx); +__owur int BIO_ssl_copy_session_id(BIO *to, BIO *from); +void BIO_ssl_shutdown(BIO *ssl_bio); + +__owur int SSL_CTX_set_cipher_list(SSL_CTX *, const char *str); +__owur SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth); +int SSL_CTX_up_ref(SSL_CTX *ctx); +void SSL_CTX_free(SSL_CTX *); +__owur long SSL_CTX_set_timeout(SSL_CTX *ctx, long t); +__owur long SSL_CTX_get_timeout(const SSL_CTX *ctx); +__owur X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *); +void SSL_CTX_set_cert_store(SSL_CTX *, X509_STORE *); +void SSL_CTX_set1_cert_store(SSL_CTX *, X509_STORE *); +__owur int SSL_want(const SSL *s); +__owur int SSL_clear(SSL *s); + +void SSL_CTX_flush_sessions(SSL_CTX *ctx, long tm); + +__owur const SSL_CIPHER *SSL_get_current_cipher(const SSL *s); +__owur const SSL_CIPHER *SSL_get_pending_cipher(const SSL *s); +__owur int SSL_CIPHER_get_bits(const SSL_CIPHER *c, int *alg_bits); +__owur const char *SSL_CIPHER_get_version(const SSL_CIPHER *c); +__owur const char *SSL_CIPHER_get_name(const SSL_CIPHER *c); +__owur const char *SSL_CIPHER_standard_name(const SSL_CIPHER *c); +__owur const char *OPENSSL_cipher_name(const char *rfc_name); +__owur uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *c); +__owur uint16_t SSL_CIPHER_get_protocol_id(const SSL_CIPHER *c); +__owur int SSL_CIPHER_get_kx_nid(const SSL_CIPHER *c); +__owur int SSL_CIPHER_get_auth_nid(const SSL_CIPHER *c); +__owur const EVP_MD *SSL_CIPHER_get_handshake_digest(const SSL_CIPHER *c); +__owur int SSL_CIPHER_is_aead(const SSL_CIPHER *c); + +__owur int SSL_get_fd(const SSL *s); +__owur int SSL_get_rfd(const SSL *s); +__owur int SSL_get_wfd(const SSL *s); +__owur const char *SSL_get_cipher_list(const SSL *s, int n); +__owur char *SSL_get_shared_ciphers(const SSL *s, char *buf, int size); +__owur int SSL_get_read_ahead(const SSL *s); +__owur int SSL_pending(const SSL *s); +__owur int SSL_has_pending(const SSL *s); +# ifndef OPENSSL_NO_SOCK +__owur int SSL_set_fd(SSL *s, int fd); +__owur int SSL_set_rfd(SSL *s, int fd); +__owur int SSL_set_wfd(SSL *s, int fd); +# endif +void SSL_set0_rbio(SSL *s, BIO *rbio); +void SSL_set0_wbio(SSL *s, BIO *wbio); +void SSL_set_bio(SSL *s, BIO *rbio, BIO *wbio); +__owur BIO *SSL_get_rbio(const SSL *s); +__owur BIO *SSL_get_wbio(const SSL *s); +__owur int SSL_set_cipher_list(SSL *s, const char *str); +__owur int SSL_CTX_set_ciphersuites(SSL_CTX *ctx, const char *str); +__owur int SSL_set_ciphersuites(SSL *s, const char *str); +void SSL_set_read_ahead(SSL *s, int yes); +__owur int SSL_get_verify_mode(const SSL *s); +__owur int SSL_get_verify_depth(const SSL *s); +__owur SSL_verify_cb SSL_get_verify_callback(const SSL *s); +void SSL_set_verify(SSL *s, int mode, SSL_verify_cb callback); +void SSL_set_verify_depth(SSL *s, int depth); +void SSL_set_cert_cb(SSL *s, int (*cb) (SSL *ssl, void *arg), void *arg); +# ifndef OPENSSL_NO_RSA +__owur int SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa); +__owur int SSL_use_RSAPrivateKey_ASN1(SSL *ssl, const unsigned char *d, + long len); +# endif +__owur int SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey); +__owur int SSL_use_PrivateKey_ASN1(int pk, SSL *ssl, const unsigned char *d, + long len); +__owur int SSL_use_certificate(SSL *ssl, X509 *x); +__owur int SSL_use_certificate_ASN1(SSL *ssl, const unsigned char *d, int len); +__owur int SSL_use_cert_and_key(SSL *ssl, X509 *x509, EVP_PKEY *privatekey, + STACK_OF(X509) *chain, int override); + + +/* serverinfo file format versions */ +# define SSL_SERVERINFOV1 1 +# define SSL_SERVERINFOV2 2 + +/* Set serverinfo data for the current active cert. */ +__owur int SSL_CTX_use_serverinfo(SSL_CTX *ctx, const unsigned char *serverinfo, + size_t serverinfo_length); +__owur int SSL_CTX_use_serverinfo_ex(SSL_CTX *ctx, unsigned int version, + const unsigned char *serverinfo, + size_t serverinfo_length); +__owur int SSL_CTX_use_serverinfo_file(SSL_CTX *ctx, const char *file); + +#ifndef OPENSSL_NO_RSA +__owur int SSL_use_RSAPrivateKey_file(SSL *ssl, const char *file, int type); +#endif + +__owur int SSL_use_PrivateKey_file(SSL *ssl, const char *file, int type); +__owur int SSL_use_certificate_file(SSL *ssl, const char *file, int type); + +#ifndef OPENSSL_NO_RSA +__owur int SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, const char *file, + int type); +#endif +__owur int SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file, + int type); +__owur int SSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file, + int type); +/* PEM type */ +__owur int SSL_CTX_use_certificate_chain_file(SSL_CTX *ctx, const char *file); +__owur int SSL_use_certificate_chain_file(SSL *ssl, const char *file); +__owur STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file); +__owur int SSL_add_file_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs, + const char *file); +int SSL_add_dir_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs, + const char *dir); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define SSL_load_error_strings() \ + OPENSSL_init_ssl(OPENSSL_INIT_LOAD_SSL_STRINGS \ + | OPENSSL_INIT_LOAD_CRYPTO_STRINGS, NULL) +# endif + +__owur const char *SSL_state_string(const SSL *s); +__owur const char *SSL_rstate_string(const SSL *s); +__owur const char *SSL_state_string_long(const SSL *s); +__owur const char *SSL_rstate_string_long(const SSL *s); +__owur long SSL_SESSION_get_time(const SSL_SESSION *s); +__owur long SSL_SESSION_set_time(SSL_SESSION *s, long t); +__owur long SSL_SESSION_get_timeout(const SSL_SESSION *s); +__owur long SSL_SESSION_set_timeout(SSL_SESSION *s, long t); +__owur int SSL_SESSION_get_protocol_version(const SSL_SESSION *s); +__owur int SSL_SESSION_set_protocol_version(SSL_SESSION *s, int version); + +__owur const char *SSL_SESSION_get0_hostname(const SSL_SESSION *s); +__owur int SSL_SESSION_set1_hostname(SSL_SESSION *s, const char *hostname); +void SSL_SESSION_get0_alpn_selected(const SSL_SESSION *s, + const unsigned char **alpn, + size_t *len); +__owur int SSL_SESSION_set1_alpn_selected(SSL_SESSION *s, + const unsigned char *alpn, + size_t len); +__owur const SSL_CIPHER *SSL_SESSION_get0_cipher(const SSL_SESSION *s); +__owur int SSL_SESSION_set_cipher(SSL_SESSION *s, const SSL_CIPHER *cipher); +__owur int SSL_SESSION_has_ticket(const SSL_SESSION *s); +__owur unsigned long SSL_SESSION_get_ticket_lifetime_hint(const SSL_SESSION *s); +void SSL_SESSION_get0_ticket(const SSL_SESSION *s, const unsigned char **tick, + size_t *len); +__owur uint32_t SSL_SESSION_get_max_early_data(const SSL_SESSION *s); +__owur int SSL_SESSION_set_max_early_data(SSL_SESSION *s, + uint32_t max_early_data); +__owur int SSL_copy_session_id(SSL *to, const SSL *from); +__owur X509 *SSL_SESSION_get0_peer(SSL_SESSION *s); +__owur int SSL_SESSION_set1_id_context(SSL_SESSION *s, + const unsigned char *sid_ctx, + unsigned int sid_ctx_len); +__owur int SSL_SESSION_set1_id(SSL_SESSION *s, const unsigned char *sid, + unsigned int sid_len); +__owur int SSL_SESSION_is_resumable(const SSL_SESSION *s); + +__owur SSL_SESSION *SSL_SESSION_new(void); +__owur SSL_SESSION *SSL_SESSION_dup(SSL_SESSION *src); +const unsigned char *SSL_SESSION_get_id(const SSL_SESSION *s, + unsigned int *len); +const unsigned char *SSL_SESSION_get0_id_context(const SSL_SESSION *s, + unsigned int *len); +__owur unsigned int SSL_SESSION_get_compress_id(const SSL_SESSION *s); +# ifndef OPENSSL_NO_STDIO +int SSL_SESSION_print_fp(FILE *fp, const SSL_SESSION *ses); +# endif +int SSL_SESSION_print(BIO *fp, const SSL_SESSION *ses); +int SSL_SESSION_print_keylog(BIO *bp, const SSL_SESSION *x); +int SSL_SESSION_up_ref(SSL_SESSION *ses); +void SSL_SESSION_free(SSL_SESSION *ses); +__owur int i2d_SSL_SESSION(SSL_SESSION *in, unsigned char **pp); +__owur int SSL_set_session(SSL *to, SSL_SESSION *session); +int SSL_CTX_add_session(SSL_CTX *ctx, SSL_SESSION *session); +int SSL_CTX_remove_session(SSL_CTX *ctx, SSL_SESSION *session); +__owur int SSL_CTX_set_generate_session_id(SSL_CTX *ctx, GEN_SESSION_CB cb); +__owur int SSL_set_generate_session_id(SSL *s, GEN_SESSION_CB cb); +__owur int SSL_has_matching_session_id(const SSL *s, + const unsigned char *id, + unsigned int id_len); +SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, const unsigned char **pp, + long length); + +# ifdef HEADER_X509_H +__owur X509 *SSL_get_peer_certificate(const SSL *s); +# endif + +__owur STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s); + +__owur int SSL_CTX_get_verify_mode(const SSL_CTX *ctx); +__owur int SSL_CTX_get_verify_depth(const SSL_CTX *ctx); +__owur SSL_verify_cb SSL_CTX_get_verify_callback(const SSL_CTX *ctx); +void SSL_CTX_set_verify(SSL_CTX *ctx, int mode, SSL_verify_cb callback); +void SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth); +void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx, + int (*cb) (X509_STORE_CTX *, void *), + void *arg); +void SSL_CTX_set_cert_cb(SSL_CTX *c, int (*cb) (SSL *ssl, void *arg), + void *arg); +# ifndef OPENSSL_NO_RSA +__owur int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa); +__owur int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, const unsigned char *d, + long len); +# endif +__owur int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey); +__owur int SSL_CTX_use_PrivateKey_ASN1(int pk, SSL_CTX *ctx, + const unsigned char *d, long len); +__owur int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x); +__owur int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len, + const unsigned char *d); +__owur int SSL_CTX_use_cert_and_key(SSL_CTX *ctx, X509 *x509, EVP_PKEY *privatekey, + STACK_OF(X509) *chain, int override); + +void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb); +void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u); +pem_password_cb *SSL_CTX_get_default_passwd_cb(SSL_CTX *ctx); +void *SSL_CTX_get_default_passwd_cb_userdata(SSL_CTX *ctx); +void SSL_set_default_passwd_cb(SSL *s, pem_password_cb *cb); +void SSL_set_default_passwd_cb_userdata(SSL *s, void *u); +pem_password_cb *SSL_get_default_passwd_cb(SSL *s); +void *SSL_get_default_passwd_cb_userdata(SSL *s); + +__owur int SSL_CTX_check_private_key(const SSL_CTX *ctx); +__owur int SSL_check_private_key(const SSL *ctx); + +__owur int SSL_CTX_set_session_id_context(SSL_CTX *ctx, + const unsigned char *sid_ctx, + unsigned int sid_ctx_len); + +SSL *SSL_new(SSL_CTX *ctx); +int SSL_up_ref(SSL *s); +int SSL_is_dtls(const SSL *s); +__owur int SSL_set_session_id_context(SSL *ssl, const unsigned char *sid_ctx, + unsigned int sid_ctx_len); + +__owur int SSL_CTX_set_purpose(SSL_CTX *ctx, int purpose); +__owur int SSL_set_purpose(SSL *ssl, int purpose); +__owur int SSL_CTX_set_trust(SSL_CTX *ctx, int trust); +__owur int SSL_set_trust(SSL *ssl, int trust); + +__owur int SSL_set1_host(SSL *s, const char *hostname); +__owur int SSL_add1_host(SSL *s, const char *hostname); +__owur const char *SSL_get0_peername(SSL *s); +void SSL_set_hostflags(SSL *s, unsigned int flags); + +__owur int SSL_CTX_dane_enable(SSL_CTX *ctx); +__owur int SSL_CTX_dane_mtype_set(SSL_CTX *ctx, const EVP_MD *md, + uint8_t mtype, uint8_t ord); +__owur int SSL_dane_enable(SSL *s, const char *basedomain); +__owur int SSL_dane_tlsa_add(SSL *s, uint8_t usage, uint8_t selector, + uint8_t mtype, unsigned const char *data, size_t dlen); +__owur int SSL_get0_dane_authority(SSL *s, X509 **mcert, EVP_PKEY **mspki); +__owur int SSL_get0_dane_tlsa(SSL *s, uint8_t *usage, uint8_t *selector, + uint8_t *mtype, unsigned const char **data, + size_t *dlen); +/* + * Bridge opacity barrier between libcrypt and libssl, also needed to support + * offline testing in test/danetest.c + */ +SSL_DANE *SSL_get0_dane(SSL *ssl); +/* + * DANE flags + */ +unsigned long SSL_CTX_dane_set_flags(SSL_CTX *ctx, unsigned long flags); +unsigned long SSL_CTX_dane_clear_flags(SSL_CTX *ctx, unsigned long flags); +unsigned long SSL_dane_set_flags(SSL *ssl, unsigned long flags); +unsigned long SSL_dane_clear_flags(SSL *ssl, unsigned long flags); + +__owur int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm); +__owur int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm); + +__owur X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx); +__owur X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl); + +# ifndef OPENSSL_NO_SRP +int SSL_CTX_set_srp_username(SSL_CTX *ctx, char *name); +int SSL_CTX_set_srp_password(SSL_CTX *ctx, char *password); +int SSL_CTX_set_srp_strength(SSL_CTX *ctx, int strength); +int SSL_CTX_set_srp_client_pwd_callback(SSL_CTX *ctx, + char *(*cb) (SSL *, void *)); +int SSL_CTX_set_srp_verify_param_callback(SSL_CTX *ctx, + int (*cb) (SSL *, void *)); +int SSL_CTX_set_srp_username_callback(SSL_CTX *ctx, + int (*cb) (SSL *, int *, void *)); +int SSL_CTX_set_srp_cb_arg(SSL_CTX *ctx, void *arg); + +int SSL_set_srp_server_param(SSL *s, const BIGNUM *N, const BIGNUM *g, + BIGNUM *sa, BIGNUM *v, char *info); +int SSL_set_srp_server_param_pw(SSL *s, const char *user, const char *pass, + const char *grp); + +__owur BIGNUM *SSL_get_srp_g(SSL *s); +__owur BIGNUM *SSL_get_srp_N(SSL *s); + +__owur char *SSL_get_srp_username(SSL *s); +__owur char *SSL_get_srp_userinfo(SSL *s); +# endif + +/* + * ClientHello callback and helpers. + */ + +# define SSL_CLIENT_HELLO_SUCCESS 1 +# define SSL_CLIENT_HELLO_ERROR 0 +# define SSL_CLIENT_HELLO_RETRY (-1) + +typedef int (*SSL_client_hello_cb_fn) (SSL *s, int *al, void *arg); +void SSL_CTX_set_client_hello_cb(SSL_CTX *c, SSL_client_hello_cb_fn cb, + void *arg); +int SSL_client_hello_isv2(SSL *s); +unsigned int SSL_client_hello_get0_legacy_version(SSL *s); +size_t SSL_client_hello_get0_random(SSL *s, const unsigned char **out); +size_t SSL_client_hello_get0_session_id(SSL *s, const unsigned char **out); +size_t SSL_client_hello_get0_ciphers(SSL *s, const unsigned char **out); +size_t SSL_client_hello_get0_compression_methods(SSL *s, + const unsigned char **out); +int SSL_client_hello_get1_extensions_present(SSL *s, int **out, size_t *outlen); +int SSL_client_hello_get0_ext(SSL *s, unsigned int type, + const unsigned char **out, size_t *outlen); + +void SSL_certs_clear(SSL *s); +void SSL_free(SSL *ssl); +# ifdef OSSL_ASYNC_FD +/* + * Windows application developer has to include windows.h to use these. + */ +__owur int SSL_waiting_for_async(SSL *s); +__owur int SSL_get_all_async_fds(SSL *s, OSSL_ASYNC_FD *fds, size_t *numfds); +__owur int SSL_get_changed_async_fds(SSL *s, OSSL_ASYNC_FD *addfd, + size_t *numaddfds, OSSL_ASYNC_FD *delfd, + size_t *numdelfds); +# endif +__owur int SSL_accept(SSL *ssl); +__owur int SSL_stateless(SSL *s); +__owur int SSL_connect(SSL *ssl); +__owur int SSL_read(SSL *ssl, void *buf, int num); +__owur int SSL_read_ex(SSL *ssl, void *buf, size_t num, size_t *readbytes); + +# define SSL_READ_EARLY_DATA_ERROR 0 +# define SSL_READ_EARLY_DATA_SUCCESS 1 +# define SSL_READ_EARLY_DATA_FINISH 2 + +__owur int SSL_read_early_data(SSL *s, void *buf, size_t num, + size_t *readbytes); +__owur int SSL_peek(SSL *ssl, void *buf, int num); +__owur int SSL_peek_ex(SSL *ssl, void *buf, size_t num, size_t *readbytes); +__owur int SSL_write(SSL *ssl, const void *buf, int num); +__owur int SSL_write_ex(SSL *s, const void *buf, size_t num, size_t *written); +__owur int SSL_write_early_data(SSL *s, const void *buf, size_t num, + size_t *written); +long SSL_ctrl(SSL *ssl, int cmd, long larg, void *parg); +long SSL_callback_ctrl(SSL *, int, void (*)(void)); +long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg); +long SSL_CTX_callback_ctrl(SSL_CTX *, int, void (*)(void)); + +# define SSL_EARLY_DATA_NOT_SENT 0 +# define SSL_EARLY_DATA_REJECTED 1 +# define SSL_EARLY_DATA_ACCEPTED 2 + +__owur int SSL_get_early_data_status(const SSL *s); + +__owur int SSL_get_error(const SSL *s, int ret_code); +__owur const char *SSL_get_version(const SSL *s); + +/* This sets the 'default' SSL version that SSL_new() will create */ +__owur int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth); + +# ifndef OPENSSL_NO_SSL3_METHOD +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *SSLv3_method(void)) /* SSLv3 */ +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *SSLv3_server_method(void)) +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *SSLv3_client_method(void)) +# endif + +#define SSLv23_method TLS_method +#define SSLv23_server_method TLS_server_method +#define SSLv23_client_method TLS_client_method + +/* Negotiate highest available SSL/TLS version */ +__owur const SSL_METHOD *TLS_method(void); +__owur const SSL_METHOD *TLS_server_method(void); +__owur const SSL_METHOD *TLS_client_method(void); + +# ifndef OPENSSL_NO_TLS1_METHOD +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_method(void)) /* TLSv1.0 */ +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_server_method(void)) +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_client_method(void)) +# endif + +# ifndef OPENSSL_NO_TLS1_1_METHOD +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_1_method(void)) /* TLSv1.1 */ +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_1_server_method(void)) +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_1_client_method(void)) +# endif + +# ifndef OPENSSL_NO_TLS1_2_METHOD +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_2_method(void)) /* TLSv1.2 */ +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_2_server_method(void)) +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *TLSv1_2_client_method(void)) +# endif + +# ifndef OPENSSL_NO_DTLS1_METHOD +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *DTLSv1_method(void)) /* DTLSv1.0 */ +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *DTLSv1_server_method(void)) +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *DTLSv1_client_method(void)) +# endif + +# ifndef OPENSSL_NO_DTLS1_2_METHOD +/* DTLSv1.2 */ +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *DTLSv1_2_method(void)) +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *DTLSv1_2_server_method(void)) +DEPRECATEDIN_1_1_0(__owur const SSL_METHOD *DTLSv1_2_client_method(void)) +# endif + +__owur const SSL_METHOD *DTLS_method(void); /* DTLS 1.0 and 1.2 */ +__owur const SSL_METHOD *DTLS_server_method(void); /* DTLS 1.0 and 1.2 */ +__owur const SSL_METHOD *DTLS_client_method(void); /* DTLS 1.0 and 1.2 */ + +__owur size_t DTLS_get_data_mtu(const SSL *s); + +__owur STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s); +__owur STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx); +__owur STACK_OF(SSL_CIPHER) *SSL_get_client_ciphers(const SSL *s); +__owur STACK_OF(SSL_CIPHER) *SSL_get1_supported_ciphers(SSL *s); + +__owur int SSL_do_handshake(SSL *s); +int SSL_key_update(SSL *s, int updatetype); +int SSL_get_key_update_type(SSL *s); +int SSL_renegotiate(SSL *s); +int SSL_renegotiate_abbreviated(SSL *s); +__owur int SSL_renegotiate_pending(SSL *s); +int SSL_shutdown(SSL *s); +__owur int SSL_verify_client_post_handshake(SSL *s); +void SSL_CTX_set_post_handshake_auth(SSL_CTX *ctx, int val); +void SSL_set_post_handshake_auth(SSL *s, int val); + +__owur const SSL_METHOD *SSL_CTX_get_ssl_method(SSL_CTX *ctx); +__owur const SSL_METHOD *SSL_get_ssl_method(SSL *s); +__owur int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method); +__owur const char *SSL_alert_type_string_long(int value); +__owur const char *SSL_alert_type_string(int value); +__owur const char *SSL_alert_desc_string_long(int value); +__owur const char *SSL_alert_desc_string(int value); + +void SSL_set0_CA_list(SSL *s, STACK_OF(X509_NAME) *name_list); +void SSL_CTX_set0_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *name_list); +__owur const STACK_OF(X509_NAME) *SSL_get0_CA_list(const SSL *s); +__owur const STACK_OF(X509_NAME) *SSL_CTX_get0_CA_list(const SSL_CTX *ctx); +__owur int SSL_add1_to_CA_list(SSL *ssl, const X509 *x); +__owur int SSL_CTX_add1_to_CA_list(SSL_CTX *ctx, const X509 *x); +__owur const STACK_OF(X509_NAME) *SSL_get0_peer_CA_list(const SSL *s); + +void SSL_set_client_CA_list(SSL *s, STACK_OF(X509_NAME) *name_list); +void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *name_list); +__owur STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s); +__owur STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(const SSL_CTX *s); +__owur int SSL_add_client_CA(SSL *ssl, X509 *x); +__owur int SSL_CTX_add_client_CA(SSL_CTX *ctx, X509 *x); + +void SSL_set_connect_state(SSL *s); +void SSL_set_accept_state(SSL *s); + +__owur long SSL_get_default_timeout(const SSL *s); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define SSL_library_init() OPENSSL_init_ssl(0, NULL) +# endif + +__owur char *SSL_CIPHER_description(const SSL_CIPHER *, char *buf, int size); +__owur STACK_OF(X509_NAME) *SSL_dup_CA_list(const STACK_OF(X509_NAME) *sk); + +__owur SSL *SSL_dup(SSL *ssl); + +__owur X509 *SSL_get_certificate(const SSL *ssl); +/* + * EVP_PKEY + */ +struct evp_pkey_st *SSL_get_privatekey(const SSL *ssl); + +__owur X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx); +__owur EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx); + +void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode); +__owur int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx); +void SSL_set_quiet_shutdown(SSL *ssl, int mode); +__owur int SSL_get_quiet_shutdown(const SSL *ssl); +void SSL_set_shutdown(SSL *ssl, int mode); +__owur int SSL_get_shutdown(const SSL *ssl); +__owur int SSL_version(const SSL *ssl); +__owur int SSL_client_version(const SSL *s); +__owur int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx); +__owur int SSL_CTX_set_default_verify_dir(SSL_CTX *ctx); +__owur int SSL_CTX_set_default_verify_file(SSL_CTX *ctx); +__owur int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile, + const char *CApath); +# define SSL_get0_session SSL_get_session/* just peek at pointer */ +__owur SSL_SESSION *SSL_get_session(const SSL *ssl); +__owur SSL_SESSION *SSL_get1_session(SSL *ssl); /* obtain a reference count */ +__owur SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl); +SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx); +void SSL_set_info_callback(SSL *ssl, + void (*cb) (const SSL *ssl, int type, int val)); +void (*SSL_get_info_callback(const SSL *ssl)) (const SSL *ssl, int type, + int val); +__owur OSSL_HANDSHAKE_STATE SSL_get_state(const SSL *ssl); + +void SSL_set_verify_result(SSL *ssl, long v); +__owur long SSL_get_verify_result(const SSL *ssl); +__owur STACK_OF(X509) *SSL_get0_verified_chain(const SSL *s); + +__owur size_t SSL_get_client_random(const SSL *ssl, unsigned char *out, + size_t outlen); +__owur size_t SSL_get_server_random(const SSL *ssl, unsigned char *out, + size_t outlen); +__owur size_t SSL_SESSION_get_master_key(const SSL_SESSION *sess, + unsigned char *out, size_t outlen); +__owur int SSL_SESSION_set1_master_key(SSL_SESSION *sess, + const unsigned char *in, size_t len); +uint8_t SSL_SESSION_get_max_fragment_length(const SSL_SESSION *sess); + +#define SSL_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL, l, p, newf, dupf, freef) +__owur int SSL_set_ex_data(SSL *ssl, int idx, void *data); +void *SSL_get_ex_data(const SSL *ssl, int idx); +#define SSL_SESSION_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL_SESSION, l, p, newf, dupf, freef) +__owur int SSL_SESSION_set_ex_data(SSL_SESSION *ss, int idx, void *data); +void *SSL_SESSION_get_ex_data(const SSL_SESSION *ss, int idx); +#define SSL_CTX_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL_CTX, l, p, newf, dupf, freef) +__owur int SSL_CTX_set_ex_data(SSL_CTX *ssl, int idx, void *data); +void *SSL_CTX_get_ex_data(const SSL_CTX *ssl, int idx); + +__owur int SSL_get_ex_data_X509_STORE_CTX_idx(void); + +# define SSL_CTX_sess_set_cache_size(ctx,t) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_SIZE,t,NULL) +# define SSL_CTX_sess_get_cache_size(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_SIZE,0,NULL) +# define SSL_CTX_set_session_cache_mode(ctx,m) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_MODE,m,NULL) +# define SSL_CTX_get_session_cache_mode(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_MODE,0,NULL) + +# define SSL_CTX_get_default_read_ahead(ctx) SSL_CTX_get_read_ahead(ctx) +# define SSL_CTX_set_default_read_ahead(ctx,m) SSL_CTX_set_read_ahead(ctx,m) +# define SSL_CTX_get_read_ahead(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_READ_AHEAD,0,NULL) +# define SSL_CTX_set_read_ahead(ctx,m) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_READ_AHEAD,m,NULL) +# define SSL_CTX_get_max_cert_list(ctx) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL) +# define SSL_CTX_set_max_cert_list(ctx,m) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL) +# define SSL_get_max_cert_list(ssl) \ + SSL_ctrl(ssl,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL) +# define SSL_set_max_cert_list(ssl,m) \ + SSL_ctrl(ssl,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL) + +# define SSL_CTX_set_max_send_fragment(ctx,m) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL) +# define SSL_set_max_send_fragment(ssl,m) \ + SSL_ctrl(ssl,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL) +# define SSL_CTX_set_split_send_fragment(ctx,m) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SPLIT_SEND_FRAGMENT,m,NULL) +# define SSL_set_split_send_fragment(ssl,m) \ + SSL_ctrl(ssl,SSL_CTRL_SET_SPLIT_SEND_FRAGMENT,m,NULL) +# define SSL_CTX_set_max_pipelines(ctx,m) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_PIPELINES,m,NULL) +# define SSL_set_max_pipelines(ssl,m) \ + SSL_ctrl(ssl,SSL_CTRL_SET_MAX_PIPELINES,m,NULL) + +void SSL_CTX_set_default_read_buffer_len(SSL_CTX *ctx, size_t len); +void SSL_set_default_read_buffer_len(SSL *s, size_t len); + +# ifndef OPENSSL_NO_DH +/* NB: the |keylength| is only applicable when is_export is true */ +void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx, + DH *(*dh) (SSL *ssl, int is_export, + int keylength)); +void SSL_set_tmp_dh_callback(SSL *ssl, + DH *(*dh) (SSL *ssl, int is_export, + int keylength)); +# endif + +__owur const COMP_METHOD *SSL_get_current_compression(SSL *s); +__owur const COMP_METHOD *SSL_get_current_expansion(SSL *s); +__owur const char *SSL_COMP_get_name(const COMP_METHOD *comp); +__owur const char *SSL_COMP_get0_name(const SSL_COMP *comp); +__owur int SSL_COMP_get_id(const SSL_COMP *comp); +STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void); +__owur STACK_OF(SSL_COMP) *SSL_COMP_set0_compression_methods(STACK_OF(SSL_COMP) + *meths); +# if OPENSSL_API_COMPAT < 0x10100000L +# define SSL_COMP_free_compression_methods() while(0) continue +# endif +__owur int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm); + +const SSL_CIPHER *SSL_CIPHER_find(SSL *ssl, const unsigned char *ptr); +int SSL_CIPHER_get_cipher_nid(const SSL_CIPHER *c); +int SSL_CIPHER_get_digest_nid(const SSL_CIPHER *c); +int SSL_bytes_to_cipher_list(SSL *s, const unsigned char *bytes, size_t len, + int isv2format, STACK_OF(SSL_CIPHER) **sk, + STACK_OF(SSL_CIPHER) **scsvs); + +/* TLS extensions functions */ +__owur int SSL_set_session_ticket_ext(SSL *s, void *ext_data, int ext_len); + +__owur int SSL_set_session_ticket_ext_cb(SSL *s, + tls_session_ticket_ext_cb_fn cb, + void *arg); + +/* Pre-shared secret session resumption functions */ +__owur int SSL_set_session_secret_cb(SSL *s, + tls_session_secret_cb_fn session_secret_cb, + void *arg); + +void SSL_CTX_set_not_resumable_session_callback(SSL_CTX *ctx, + int (*cb) (SSL *ssl, + int + is_forward_secure)); + +void SSL_set_not_resumable_session_callback(SSL *ssl, + int (*cb) (SSL *ssl, + int is_forward_secure)); + +void SSL_CTX_set_record_padding_callback(SSL_CTX *ctx, + size_t (*cb) (SSL *ssl, int type, + size_t len, void *arg)); +void SSL_CTX_set_record_padding_callback_arg(SSL_CTX *ctx, void *arg); +void *SSL_CTX_get_record_padding_callback_arg(SSL_CTX *ctx); +int SSL_CTX_set_block_padding(SSL_CTX *ctx, size_t block_size); + +void SSL_set_record_padding_callback(SSL *ssl, + size_t (*cb) (SSL *ssl, int type, + size_t len, void *arg)); +void SSL_set_record_padding_callback_arg(SSL *ssl, void *arg); +void *SSL_get_record_padding_callback_arg(SSL *ssl); +int SSL_set_block_padding(SSL *ssl, size_t block_size); + +int SSL_set_num_tickets(SSL *s, size_t num_tickets); +size_t SSL_get_num_tickets(SSL *s); +int SSL_CTX_set_num_tickets(SSL_CTX *ctx, size_t num_tickets); +size_t SSL_CTX_get_num_tickets(SSL_CTX *ctx); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define SSL_cache_hit(s) SSL_session_reused(s) +# endif + +__owur int SSL_session_reused(SSL *s); +__owur int SSL_is_server(const SSL *s); + +__owur __owur SSL_CONF_CTX *SSL_CONF_CTX_new(void); +int SSL_CONF_CTX_finish(SSL_CONF_CTX *cctx); +void SSL_CONF_CTX_free(SSL_CONF_CTX *cctx); +unsigned int SSL_CONF_CTX_set_flags(SSL_CONF_CTX *cctx, unsigned int flags); +__owur unsigned int SSL_CONF_CTX_clear_flags(SSL_CONF_CTX *cctx, + unsigned int flags); +__owur int SSL_CONF_CTX_set1_prefix(SSL_CONF_CTX *cctx, const char *pre); + +void SSL_CONF_CTX_set_ssl(SSL_CONF_CTX *cctx, SSL *ssl); +void SSL_CONF_CTX_set_ssl_ctx(SSL_CONF_CTX *cctx, SSL_CTX *ctx); + +__owur int SSL_CONF_cmd(SSL_CONF_CTX *cctx, const char *cmd, const char *value); +__owur int SSL_CONF_cmd_argv(SSL_CONF_CTX *cctx, int *pargc, char ***pargv); +__owur int SSL_CONF_cmd_value_type(SSL_CONF_CTX *cctx, const char *cmd); + +void SSL_add_ssl_module(void); +int SSL_config(SSL *s, const char *name); +int SSL_CTX_config(SSL_CTX *ctx, const char *name); + +# ifndef OPENSSL_NO_SSL_TRACE +void SSL_trace(int write_p, int version, int content_type, + const void *buf, size_t len, SSL *ssl, void *arg); +# endif + +# ifndef OPENSSL_NO_SOCK +int DTLSv1_listen(SSL *s, BIO_ADDR *client); +# endif + +# ifndef OPENSSL_NO_CT + +/* + * A callback for verifying that the received SCTs are sufficient. + * Expected to return 1 if they are sufficient, otherwise 0. + * May return a negative integer if an error occurs. + * A connection should be aborted if the SCTs are deemed insufficient. + */ +typedef int (*ssl_ct_validation_cb)(const CT_POLICY_EVAL_CTX *ctx, + const STACK_OF(SCT) *scts, void *arg); + +/* + * Sets a |callback| that is invoked upon receipt of ServerHelloDone to validate + * the received SCTs. + * If the callback returns a non-positive result, the connection is terminated. + * Call this function before beginning a handshake. + * If a NULL |callback| is provided, SCT validation is disabled. + * |arg| is arbitrary userdata that will be passed to the callback whenever it + * is invoked. Ownership of |arg| remains with the caller. + * + * NOTE: A side-effect of setting a CT callback is that an OCSP stapled response + * will be requested. + */ +int SSL_set_ct_validation_callback(SSL *s, ssl_ct_validation_cb callback, + void *arg); +int SSL_CTX_set_ct_validation_callback(SSL_CTX *ctx, + ssl_ct_validation_cb callback, + void *arg); +#define SSL_disable_ct(s) \ + ((void) SSL_set_validation_callback((s), NULL, NULL)) +#define SSL_CTX_disable_ct(ctx) \ + ((void) SSL_CTX_set_validation_callback((ctx), NULL, NULL)) + +/* + * The validation type enumerates the available behaviours of the built-in SSL + * CT validation callback selected via SSL_enable_ct() and SSL_CTX_enable_ct(). + * The underlying callback is a static function in libssl. + */ +enum { + SSL_CT_VALIDATION_PERMISSIVE = 0, + SSL_CT_VALIDATION_STRICT +}; + +/* + * Enable CT by setting up a callback that implements one of the built-in + * validation variants. The SSL_CT_VALIDATION_PERMISSIVE variant always + * continues the handshake, the application can make appropriate decisions at + * handshake completion. The SSL_CT_VALIDATION_STRICT variant requires at + * least one valid SCT, or else handshake termination will be requested. The + * handshake may continue anyway if SSL_VERIFY_NONE is in effect. + */ +int SSL_enable_ct(SSL *s, int validation_mode); +int SSL_CTX_enable_ct(SSL_CTX *ctx, int validation_mode); + +/* + * Report whether a non-NULL callback is enabled. + */ +int SSL_ct_is_enabled(const SSL *s); +int SSL_CTX_ct_is_enabled(const SSL_CTX *ctx); + +/* Gets the SCTs received from a connection */ +const STACK_OF(SCT) *SSL_get0_peer_scts(SSL *s); + +/* + * Loads the CT log list from the default location. + * If a CTLOG_STORE has previously been set using SSL_CTX_set_ctlog_store, + * the log information loaded from this file will be appended to the + * CTLOG_STORE. + * Returns 1 on success, 0 otherwise. + */ +int SSL_CTX_set_default_ctlog_list_file(SSL_CTX *ctx); + +/* + * Loads the CT log list from the specified file path. + * If a CTLOG_STORE has previously been set using SSL_CTX_set_ctlog_store, + * the log information loaded from this file will be appended to the + * CTLOG_STORE. + * Returns 1 on success, 0 otherwise. + */ +int SSL_CTX_set_ctlog_list_file(SSL_CTX *ctx, const char *path); + +/* + * Sets the CT log list used by all SSL connections created from this SSL_CTX. + * Ownership of the CTLOG_STORE is transferred to the SSL_CTX. + */ +void SSL_CTX_set0_ctlog_store(SSL_CTX *ctx, CTLOG_STORE *logs); + +/* + * Gets the CT log list used by all SSL connections created from this SSL_CTX. + * This will be NULL unless one of the following functions has been called: + * - SSL_CTX_set_default_ctlog_list_file + * - SSL_CTX_set_ctlog_list_file + * - SSL_CTX_set_ctlog_store + */ +const CTLOG_STORE *SSL_CTX_get0_ctlog_store(const SSL_CTX *ctx); + +# endif /* OPENSSL_NO_CT */ + +/* What the "other" parameter contains in security callback */ +/* Mask for type */ +# define SSL_SECOP_OTHER_TYPE 0xffff0000 +# define SSL_SECOP_OTHER_NONE 0 +# define SSL_SECOP_OTHER_CIPHER (1 << 16) +# define SSL_SECOP_OTHER_CURVE (2 << 16) +# define SSL_SECOP_OTHER_DH (3 << 16) +# define SSL_SECOP_OTHER_PKEY (4 << 16) +# define SSL_SECOP_OTHER_SIGALG (5 << 16) +# define SSL_SECOP_OTHER_CERT (6 << 16) + +/* Indicated operation refers to peer key or certificate */ +# define SSL_SECOP_PEER 0x1000 + +/* Values for "op" parameter in security callback */ + +/* Called to filter ciphers */ +/* Ciphers client supports */ +# define SSL_SECOP_CIPHER_SUPPORTED (1 | SSL_SECOP_OTHER_CIPHER) +/* Cipher shared by client/server */ +# define SSL_SECOP_CIPHER_SHARED (2 | SSL_SECOP_OTHER_CIPHER) +/* Sanity check of cipher server selects */ +# define SSL_SECOP_CIPHER_CHECK (3 | SSL_SECOP_OTHER_CIPHER) +/* Curves supported by client */ +# define SSL_SECOP_CURVE_SUPPORTED (4 | SSL_SECOP_OTHER_CURVE) +/* Curves shared by client/server */ +# define SSL_SECOP_CURVE_SHARED (5 | SSL_SECOP_OTHER_CURVE) +/* Sanity check of curve server selects */ +# define SSL_SECOP_CURVE_CHECK (6 | SSL_SECOP_OTHER_CURVE) +/* Temporary DH key */ +# define SSL_SECOP_TMP_DH (7 | SSL_SECOP_OTHER_PKEY) +/* SSL/TLS version */ +# define SSL_SECOP_VERSION (9 | SSL_SECOP_OTHER_NONE) +/* Session tickets */ +# define SSL_SECOP_TICKET (10 | SSL_SECOP_OTHER_NONE) +/* Supported signature algorithms sent to peer */ +# define SSL_SECOP_SIGALG_SUPPORTED (11 | SSL_SECOP_OTHER_SIGALG) +/* Shared signature algorithm */ +# define SSL_SECOP_SIGALG_SHARED (12 | SSL_SECOP_OTHER_SIGALG) +/* Sanity check signature algorithm allowed */ +# define SSL_SECOP_SIGALG_CHECK (13 | SSL_SECOP_OTHER_SIGALG) +/* Used to get mask of supported public key signature algorithms */ +# define SSL_SECOP_SIGALG_MASK (14 | SSL_SECOP_OTHER_SIGALG) +/* Use to see if compression is allowed */ +# define SSL_SECOP_COMPRESSION (15 | SSL_SECOP_OTHER_NONE) +/* EE key in certificate */ +# define SSL_SECOP_EE_KEY (16 | SSL_SECOP_OTHER_CERT) +/* CA key in certificate */ +# define SSL_SECOP_CA_KEY (17 | SSL_SECOP_OTHER_CERT) +/* CA digest algorithm in certificate */ +# define SSL_SECOP_CA_MD (18 | SSL_SECOP_OTHER_CERT) +/* Peer EE key in certificate */ +# define SSL_SECOP_PEER_EE_KEY (SSL_SECOP_EE_KEY | SSL_SECOP_PEER) +/* Peer CA key in certificate */ +# define SSL_SECOP_PEER_CA_KEY (SSL_SECOP_CA_KEY | SSL_SECOP_PEER) +/* Peer CA digest algorithm in certificate */ +# define SSL_SECOP_PEER_CA_MD (SSL_SECOP_CA_MD | SSL_SECOP_PEER) + +void SSL_set_security_level(SSL *s, int level); +__owur int SSL_get_security_level(const SSL *s); +void SSL_set_security_callback(SSL *s, + int (*cb) (const SSL *s, const SSL_CTX *ctx, + int op, int bits, int nid, + void *other, void *ex)); +int (*SSL_get_security_callback(const SSL *s)) (const SSL *s, + const SSL_CTX *ctx, int op, + int bits, int nid, void *other, + void *ex); +void SSL_set0_security_ex_data(SSL *s, void *ex); +__owur void *SSL_get0_security_ex_data(const SSL *s); + +void SSL_CTX_set_security_level(SSL_CTX *ctx, int level); +__owur int SSL_CTX_get_security_level(const SSL_CTX *ctx); +void SSL_CTX_set_security_callback(SSL_CTX *ctx, + int (*cb) (const SSL *s, const SSL_CTX *ctx, + int op, int bits, int nid, + void *other, void *ex)); +int (*SSL_CTX_get_security_callback(const SSL_CTX *ctx)) (const SSL *s, + const SSL_CTX *ctx, + int op, int bits, + int nid, + void *other, + void *ex); +void SSL_CTX_set0_security_ex_data(SSL_CTX *ctx, void *ex); +__owur void *SSL_CTX_get0_security_ex_data(const SSL_CTX *ctx); + +/* OPENSSL_INIT flag 0x010000 reserved for internal use */ +# define OPENSSL_INIT_NO_LOAD_SSL_STRINGS 0x00100000L +# define OPENSSL_INIT_LOAD_SSL_STRINGS 0x00200000L + +# define OPENSSL_INIT_SSL_DEFAULT \ + (OPENSSL_INIT_LOAD_SSL_STRINGS | OPENSSL_INIT_LOAD_CRYPTO_STRINGS) + +int OPENSSL_init_ssl(uint64_t opts, const OPENSSL_INIT_SETTINGS *settings); + +# ifndef OPENSSL_NO_UNIT_TEST +__owur const struct openssl_ssl_test_functions *SSL_test_functions(void); +# endif + +__owur int SSL_free_buffers(SSL *ssl); +__owur int SSL_alloc_buffers(SSL *ssl); + +/* Status codes passed to the decrypt session ticket callback. Some of these + * are for internal use only and are never passed to the callback. */ +typedef int SSL_TICKET_STATUS; + +/* Support for ticket appdata */ +/* fatal error, malloc failure */ +# define SSL_TICKET_FATAL_ERR_MALLOC 0 +/* fatal error, either from parsing or decrypting the ticket */ +# define SSL_TICKET_FATAL_ERR_OTHER 1 +/* No ticket present */ +# define SSL_TICKET_NONE 2 +/* Empty ticket present */ +# define SSL_TICKET_EMPTY 3 +/* the ticket couldn't be decrypted */ +# define SSL_TICKET_NO_DECRYPT 4 +/* a ticket was successfully decrypted */ +# define SSL_TICKET_SUCCESS 5 +/* same as above but the ticket needs to be renewed */ +# define SSL_TICKET_SUCCESS_RENEW 6 + +/* Return codes for the decrypt session ticket callback */ +typedef int SSL_TICKET_RETURN; + +/* An error occurred */ +#define SSL_TICKET_RETURN_ABORT 0 +/* Do not use the ticket, do not send a renewed ticket to the client */ +#define SSL_TICKET_RETURN_IGNORE 1 +/* Do not use the ticket, send a renewed ticket to the client */ +#define SSL_TICKET_RETURN_IGNORE_RENEW 2 +/* Use the ticket, do not send a renewed ticket to the client */ +#define SSL_TICKET_RETURN_USE 3 +/* Use the ticket, send a renewed ticket to the client */ +#define SSL_TICKET_RETURN_USE_RENEW 4 + +typedef int (*SSL_CTX_generate_session_ticket_fn)(SSL *s, void *arg); +typedef SSL_TICKET_RETURN (*SSL_CTX_decrypt_session_ticket_fn)(SSL *s, SSL_SESSION *ss, + const unsigned char *keyname, + size_t keyname_length, + SSL_TICKET_STATUS status, + void *arg); +int SSL_CTX_set_session_ticket_cb(SSL_CTX *ctx, + SSL_CTX_generate_session_ticket_fn gen_cb, + SSL_CTX_decrypt_session_ticket_fn dec_cb, + void *arg); +int SSL_SESSION_set1_ticket_appdata(SSL_SESSION *ss, const void *data, size_t len); +int SSL_SESSION_get0_ticket_appdata(SSL_SESSION *ss, void **data, size_t *len); + +extern const char SSL_version_str[]; + +typedef unsigned int (*DTLS_timer_cb)(SSL *s, unsigned int timer_us); + +void DTLS_set_timer_cb(SSL *s, DTLS_timer_cb cb); + + +typedef int (*SSL_allow_early_data_cb_fn)(SSL *s, void *arg); +void SSL_CTX_set_allow_early_data_cb(SSL_CTX *ctx, + SSL_allow_early_data_cb_fn cb, + void *arg); +void SSL_set_allow_early_data_cb(SSL *s, + SSL_allow_early_data_cb_fn cb, + void *arg); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/ssl2.h b/include/openssl/ssl2.h new file mode 100644 index 0000000..5321bd2 --- /dev/null +++ b/include/openssl/ssl2.h @@ -0,0 +1,24 @@ +/* + * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SSL2_H +# define HEADER_SSL2_H + +#ifdef __cplusplus +extern "C" { +#endif + +# define SSL2_VERSION 0x0002 + +# define SSL2_MT_CLIENT_HELLO 1 + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/ssl3.h b/include/openssl/ssl3.h new file mode 100644 index 0000000..607277d --- /dev/null +++ b/include/openssl/ssl3.h @@ -0,0 +1,339 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SSL3_H +# define HEADER_SSL3_H + +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* + * Signalling cipher suite value from RFC 5746 + * (TLS_EMPTY_RENEGOTIATION_INFO_SCSV) + */ +# define SSL3_CK_SCSV 0x030000FF + +/* + * Signalling cipher suite value from draft-ietf-tls-downgrade-scsv-00 + * (TLS_FALLBACK_SCSV) + */ +# define SSL3_CK_FALLBACK_SCSV 0x03005600 + +# define SSL3_CK_RSA_NULL_MD5 0x03000001 +# define SSL3_CK_RSA_NULL_SHA 0x03000002 +# define SSL3_CK_RSA_RC4_40_MD5 0x03000003 +# define SSL3_CK_RSA_RC4_128_MD5 0x03000004 +# define SSL3_CK_RSA_RC4_128_SHA 0x03000005 +# define SSL3_CK_RSA_RC2_40_MD5 0x03000006 +# define SSL3_CK_RSA_IDEA_128_SHA 0x03000007 +# define SSL3_CK_RSA_DES_40_CBC_SHA 0x03000008 +# define SSL3_CK_RSA_DES_64_CBC_SHA 0x03000009 +# define SSL3_CK_RSA_DES_192_CBC3_SHA 0x0300000A + +# define SSL3_CK_DH_DSS_DES_40_CBC_SHA 0x0300000B +# define SSL3_CK_DH_DSS_DES_64_CBC_SHA 0x0300000C +# define SSL3_CK_DH_DSS_DES_192_CBC3_SHA 0x0300000D +# define SSL3_CK_DH_RSA_DES_40_CBC_SHA 0x0300000E +# define SSL3_CK_DH_RSA_DES_64_CBC_SHA 0x0300000F +# define SSL3_CK_DH_RSA_DES_192_CBC3_SHA 0x03000010 + +# define SSL3_CK_DHE_DSS_DES_40_CBC_SHA 0x03000011 +# define SSL3_CK_EDH_DSS_DES_40_CBC_SHA SSL3_CK_DHE_DSS_DES_40_CBC_SHA +# define SSL3_CK_DHE_DSS_DES_64_CBC_SHA 0x03000012 +# define SSL3_CK_EDH_DSS_DES_64_CBC_SHA SSL3_CK_DHE_DSS_DES_64_CBC_SHA +# define SSL3_CK_DHE_DSS_DES_192_CBC3_SHA 0x03000013 +# define SSL3_CK_EDH_DSS_DES_192_CBC3_SHA SSL3_CK_DHE_DSS_DES_192_CBC3_SHA +# define SSL3_CK_DHE_RSA_DES_40_CBC_SHA 0x03000014 +# define SSL3_CK_EDH_RSA_DES_40_CBC_SHA SSL3_CK_DHE_RSA_DES_40_CBC_SHA +# define SSL3_CK_DHE_RSA_DES_64_CBC_SHA 0x03000015 +# define SSL3_CK_EDH_RSA_DES_64_CBC_SHA SSL3_CK_DHE_RSA_DES_64_CBC_SHA +# define SSL3_CK_DHE_RSA_DES_192_CBC3_SHA 0x03000016 +# define SSL3_CK_EDH_RSA_DES_192_CBC3_SHA SSL3_CK_DHE_RSA_DES_192_CBC3_SHA + +# define SSL3_CK_ADH_RC4_40_MD5 0x03000017 +# define SSL3_CK_ADH_RC4_128_MD5 0x03000018 +# define SSL3_CK_ADH_DES_40_CBC_SHA 0x03000019 +# define SSL3_CK_ADH_DES_64_CBC_SHA 0x0300001A +# define SSL3_CK_ADH_DES_192_CBC_SHA 0x0300001B + +/* a bundle of RFC standard cipher names, generated from ssl3_ciphers[] */ +# define SSL3_RFC_RSA_NULL_MD5 "TLS_RSA_WITH_NULL_MD5" +# define SSL3_RFC_RSA_NULL_SHA "TLS_RSA_WITH_NULL_SHA" +# define SSL3_RFC_RSA_DES_192_CBC3_SHA "TLS_RSA_WITH_3DES_EDE_CBC_SHA" +# define SSL3_RFC_DHE_DSS_DES_192_CBC3_SHA "TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA" +# define SSL3_RFC_DHE_RSA_DES_192_CBC3_SHA "TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA" +# define SSL3_RFC_ADH_DES_192_CBC_SHA "TLS_DH_anon_WITH_3DES_EDE_CBC_SHA" +# define SSL3_RFC_RSA_IDEA_128_SHA "TLS_RSA_WITH_IDEA_CBC_SHA" +# define SSL3_RFC_RSA_RC4_128_MD5 "TLS_RSA_WITH_RC4_128_MD5" +# define SSL3_RFC_RSA_RC4_128_SHA "TLS_RSA_WITH_RC4_128_SHA" +# define SSL3_RFC_ADH_RC4_128_MD5 "TLS_DH_anon_WITH_RC4_128_MD5" + +# define SSL3_TXT_RSA_NULL_MD5 "NULL-MD5" +# define SSL3_TXT_RSA_NULL_SHA "NULL-SHA" +# define SSL3_TXT_RSA_RC4_40_MD5 "EXP-RC4-MD5" +# define SSL3_TXT_RSA_RC4_128_MD5 "RC4-MD5" +# define SSL3_TXT_RSA_RC4_128_SHA "RC4-SHA" +# define SSL3_TXT_RSA_RC2_40_MD5 "EXP-RC2-CBC-MD5" +# define SSL3_TXT_RSA_IDEA_128_SHA "IDEA-CBC-SHA" +# define SSL3_TXT_RSA_DES_40_CBC_SHA "EXP-DES-CBC-SHA" +# define SSL3_TXT_RSA_DES_64_CBC_SHA "DES-CBC-SHA" +# define SSL3_TXT_RSA_DES_192_CBC3_SHA "DES-CBC3-SHA" + +# define SSL3_TXT_DH_DSS_DES_40_CBC_SHA "EXP-DH-DSS-DES-CBC-SHA" +# define SSL3_TXT_DH_DSS_DES_64_CBC_SHA "DH-DSS-DES-CBC-SHA" +# define SSL3_TXT_DH_DSS_DES_192_CBC3_SHA "DH-DSS-DES-CBC3-SHA" +# define SSL3_TXT_DH_RSA_DES_40_CBC_SHA "EXP-DH-RSA-DES-CBC-SHA" +# define SSL3_TXT_DH_RSA_DES_64_CBC_SHA "DH-RSA-DES-CBC-SHA" +# define SSL3_TXT_DH_RSA_DES_192_CBC3_SHA "DH-RSA-DES-CBC3-SHA" + +# define SSL3_TXT_DHE_DSS_DES_40_CBC_SHA "EXP-DHE-DSS-DES-CBC-SHA" +# define SSL3_TXT_DHE_DSS_DES_64_CBC_SHA "DHE-DSS-DES-CBC-SHA" +# define SSL3_TXT_DHE_DSS_DES_192_CBC3_SHA "DHE-DSS-DES-CBC3-SHA" +# define SSL3_TXT_DHE_RSA_DES_40_CBC_SHA "EXP-DHE-RSA-DES-CBC-SHA" +# define SSL3_TXT_DHE_RSA_DES_64_CBC_SHA "DHE-RSA-DES-CBC-SHA" +# define SSL3_TXT_DHE_RSA_DES_192_CBC3_SHA "DHE-RSA-DES-CBC3-SHA" + +/* + * This next block of six "EDH" labels is for backward compatibility with + * older versions of OpenSSL. New code should use the six "DHE" labels above + * instead: + */ +# define SSL3_TXT_EDH_DSS_DES_40_CBC_SHA "EXP-EDH-DSS-DES-CBC-SHA" +# define SSL3_TXT_EDH_DSS_DES_64_CBC_SHA "EDH-DSS-DES-CBC-SHA" +# define SSL3_TXT_EDH_DSS_DES_192_CBC3_SHA "EDH-DSS-DES-CBC3-SHA" +# define SSL3_TXT_EDH_RSA_DES_40_CBC_SHA "EXP-EDH-RSA-DES-CBC-SHA" +# define SSL3_TXT_EDH_RSA_DES_64_CBC_SHA "EDH-RSA-DES-CBC-SHA" +# define SSL3_TXT_EDH_RSA_DES_192_CBC3_SHA "EDH-RSA-DES-CBC3-SHA" + +# define SSL3_TXT_ADH_RC4_40_MD5 "EXP-ADH-RC4-MD5" +# define SSL3_TXT_ADH_RC4_128_MD5 "ADH-RC4-MD5" +# define SSL3_TXT_ADH_DES_40_CBC_SHA "EXP-ADH-DES-CBC-SHA" +# define SSL3_TXT_ADH_DES_64_CBC_SHA "ADH-DES-CBC-SHA" +# define SSL3_TXT_ADH_DES_192_CBC_SHA "ADH-DES-CBC3-SHA" + +# define SSL3_SSL_SESSION_ID_LENGTH 32 +# define SSL3_MAX_SSL_SESSION_ID_LENGTH 32 + +# define SSL3_MASTER_SECRET_SIZE 48 +# define SSL3_RANDOM_SIZE 32 +# define SSL3_SESSION_ID_SIZE 32 +# define SSL3_RT_HEADER_LENGTH 5 + +# define SSL3_HM_HEADER_LENGTH 4 + +# ifndef SSL3_ALIGN_PAYLOAD + /* + * Some will argue that this increases memory footprint, but it's not + * actually true. Point is that malloc has to return at least 64-bit aligned + * pointers, meaning that allocating 5 bytes wastes 3 bytes in either case. + * Suggested pre-gaping simply moves these wasted bytes from the end of + * allocated region to its front, but makes data payload aligned, which + * improves performance:-) + */ +# define SSL3_ALIGN_PAYLOAD 8 +# else +# if (SSL3_ALIGN_PAYLOAD&(SSL3_ALIGN_PAYLOAD-1))!=0 +# error "insane SSL3_ALIGN_PAYLOAD" +# undef SSL3_ALIGN_PAYLOAD +# endif +# endif + +/* + * This is the maximum MAC (digest) size used by the SSL library. Currently + * maximum of 20 is used by SHA1, but we reserve for future extension for + * 512-bit hashes. + */ + +# define SSL3_RT_MAX_MD_SIZE 64 + +/* + * Maximum block size used in all ciphersuites. Currently 16 for AES. + */ + +# define SSL_RT_MAX_CIPHER_BLOCK_SIZE 16 + +# define SSL3_RT_MAX_EXTRA (16384) + +/* Maximum plaintext length: defined by SSL/TLS standards */ +# define SSL3_RT_MAX_PLAIN_LENGTH 16384 +/* Maximum compression overhead: defined by SSL/TLS standards */ +# define SSL3_RT_MAX_COMPRESSED_OVERHEAD 1024 + +/* + * The standards give a maximum encryption overhead of 1024 bytes. In + * practice the value is lower than this. The overhead is the maximum number + * of padding bytes (256) plus the mac size. + */ +# define SSL3_RT_MAX_ENCRYPTED_OVERHEAD (256 + SSL3_RT_MAX_MD_SIZE) +# define SSL3_RT_MAX_TLS13_ENCRYPTED_OVERHEAD 256 + +/* + * OpenSSL currently only uses a padding length of at most one block so the + * send overhead is smaller. + */ + +# define SSL3_RT_SEND_MAX_ENCRYPTED_OVERHEAD \ + (SSL_RT_MAX_CIPHER_BLOCK_SIZE + SSL3_RT_MAX_MD_SIZE) + +/* If compression isn't used don't include the compression overhead */ + +# ifdef OPENSSL_NO_COMP +# define SSL3_RT_MAX_COMPRESSED_LENGTH SSL3_RT_MAX_PLAIN_LENGTH +# else +# define SSL3_RT_MAX_COMPRESSED_LENGTH \ + (SSL3_RT_MAX_PLAIN_LENGTH+SSL3_RT_MAX_COMPRESSED_OVERHEAD) +# endif +# define SSL3_RT_MAX_ENCRYPTED_LENGTH \ + (SSL3_RT_MAX_ENCRYPTED_OVERHEAD+SSL3_RT_MAX_COMPRESSED_LENGTH) +# define SSL3_RT_MAX_TLS13_ENCRYPTED_LENGTH \ + (SSL3_RT_MAX_PLAIN_LENGTH + SSL3_RT_MAX_TLS13_ENCRYPTED_OVERHEAD) +# define SSL3_RT_MAX_PACKET_SIZE \ + (SSL3_RT_MAX_ENCRYPTED_LENGTH+SSL3_RT_HEADER_LENGTH) + +# define SSL3_MD_CLIENT_FINISHED_CONST "\x43\x4C\x4E\x54" +# define SSL3_MD_SERVER_FINISHED_CONST "\x53\x52\x56\x52" + +# define SSL3_VERSION 0x0300 +# define SSL3_VERSION_MAJOR 0x03 +# define SSL3_VERSION_MINOR 0x00 + +# define SSL3_RT_CHANGE_CIPHER_SPEC 20 +# define SSL3_RT_ALERT 21 +# define SSL3_RT_HANDSHAKE 22 +# define SSL3_RT_APPLICATION_DATA 23 +# define DTLS1_RT_HEARTBEAT 24 + +/* Pseudo content types to indicate additional parameters */ +# define TLS1_RT_CRYPTO 0x1000 +# define TLS1_RT_CRYPTO_PREMASTER (TLS1_RT_CRYPTO | 0x1) +# define TLS1_RT_CRYPTO_CLIENT_RANDOM (TLS1_RT_CRYPTO | 0x2) +# define TLS1_RT_CRYPTO_SERVER_RANDOM (TLS1_RT_CRYPTO | 0x3) +# define TLS1_RT_CRYPTO_MASTER (TLS1_RT_CRYPTO | 0x4) + +# define TLS1_RT_CRYPTO_READ 0x0000 +# define TLS1_RT_CRYPTO_WRITE 0x0100 +# define TLS1_RT_CRYPTO_MAC (TLS1_RT_CRYPTO | 0x5) +# define TLS1_RT_CRYPTO_KEY (TLS1_RT_CRYPTO | 0x6) +# define TLS1_RT_CRYPTO_IV (TLS1_RT_CRYPTO | 0x7) +# define TLS1_RT_CRYPTO_FIXED_IV (TLS1_RT_CRYPTO | 0x8) + +/* Pseudo content types for SSL/TLS header info */ +# define SSL3_RT_HEADER 0x100 +# define SSL3_RT_INNER_CONTENT_TYPE 0x101 + +# define SSL3_AL_WARNING 1 +# define SSL3_AL_FATAL 2 + +# define SSL3_AD_CLOSE_NOTIFY 0 +# define SSL3_AD_UNEXPECTED_MESSAGE 10/* fatal */ +# define SSL3_AD_BAD_RECORD_MAC 20/* fatal */ +# define SSL3_AD_DECOMPRESSION_FAILURE 30/* fatal */ +# define SSL3_AD_HANDSHAKE_FAILURE 40/* fatal */ +# define SSL3_AD_NO_CERTIFICATE 41 +# define SSL3_AD_BAD_CERTIFICATE 42 +# define SSL3_AD_UNSUPPORTED_CERTIFICATE 43 +# define SSL3_AD_CERTIFICATE_REVOKED 44 +# define SSL3_AD_CERTIFICATE_EXPIRED 45 +# define SSL3_AD_CERTIFICATE_UNKNOWN 46 +# define SSL3_AD_ILLEGAL_PARAMETER 47/* fatal */ + +# define TLS1_HB_REQUEST 1 +# define TLS1_HB_RESPONSE 2 + + +# define SSL3_CT_RSA_SIGN 1 +# define SSL3_CT_DSS_SIGN 2 +# define SSL3_CT_RSA_FIXED_DH 3 +# define SSL3_CT_DSS_FIXED_DH 4 +# define SSL3_CT_RSA_EPHEMERAL_DH 5 +# define SSL3_CT_DSS_EPHEMERAL_DH 6 +# define SSL3_CT_FORTEZZA_DMS 20 +/* + * SSL3_CT_NUMBER is used to size arrays and it must be large enough to + * contain all of the cert types defined for *either* SSLv3 and TLSv1. + */ +# define SSL3_CT_NUMBER 10 + +# if defined(TLS_CT_NUMBER) +# if TLS_CT_NUMBER != SSL3_CT_NUMBER +# error "SSL/TLS CT_NUMBER values do not match" +# endif +# endif + +/* No longer used as of OpenSSL 1.1.1 */ +# define SSL3_FLAGS_NO_RENEGOTIATE_CIPHERS 0x0001 + +/* Removed from OpenSSL 1.1.0 */ +# define TLS1_FLAGS_TLS_PADDING_BUG 0x0 + +# define TLS1_FLAGS_SKIP_CERT_VERIFY 0x0010 + +/* Set if we encrypt then mac instead of usual mac then encrypt */ +# define TLS1_FLAGS_ENCRYPT_THEN_MAC_READ 0x0100 +# define TLS1_FLAGS_ENCRYPT_THEN_MAC TLS1_FLAGS_ENCRYPT_THEN_MAC_READ + +/* Set if extended master secret extension received from peer */ +# define TLS1_FLAGS_RECEIVED_EXTMS 0x0200 + +# define TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE 0x0400 + +# define TLS1_FLAGS_STATELESS 0x0800 + +# define SSL3_MT_HELLO_REQUEST 0 +# define SSL3_MT_CLIENT_HELLO 1 +# define SSL3_MT_SERVER_HELLO 2 +# define SSL3_MT_NEWSESSION_TICKET 4 +# define SSL3_MT_END_OF_EARLY_DATA 5 +# define SSL3_MT_ENCRYPTED_EXTENSIONS 8 +# define SSL3_MT_CERTIFICATE 11 +# define SSL3_MT_SERVER_KEY_EXCHANGE 12 +# define SSL3_MT_CERTIFICATE_REQUEST 13 +# define SSL3_MT_SERVER_DONE 14 +# define SSL3_MT_CERTIFICATE_VERIFY 15 +# define SSL3_MT_CLIENT_KEY_EXCHANGE 16 +# define SSL3_MT_FINISHED 20 +# define SSL3_MT_CERTIFICATE_URL 21 +# define SSL3_MT_CERTIFICATE_STATUS 22 +# define SSL3_MT_SUPPLEMENTAL_DATA 23 +# define SSL3_MT_KEY_UPDATE 24 +# ifndef OPENSSL_NO_NEXTPROTONEG +# define SSL3_MT_NEXT_PROTO 67 +# endif +# define SSL3_MT_MESSAGE_HASH 254 +# define DTLS1_MT_HELLO_VERIFY_REQUEST 3 + +/* Dummy message type for handling CCS like a normal handshake message */ +# define SSL3_MT_CHANGE_CIPHER_SPEC 0x0101 + +# define SSL3_MT_CCS 1 + +/* These are used when changing over to a new cipher */ +# define SSL3_CC_READ 0x001 +# define SSL3_CC_WRITE 0x002 +# define SSL3_CC_CLIENT 0x010 +# define SSL3_CC_SERVER 0x020 +# define SSL3_CC_EARLY 0x040 +# define SSL3_CC_HANDSHAKE 0x080 +# define SSL3_CC_APPLICATION 0x100 +# define SSL3_CHANGE_CIPHER_CLIENT_WRITE (SSL3_CC_CLIENT|SSL3_CC_WRITE) +# define SSL3_CHANGE_CIPHER_SERVER_READ (SSL3_CC_SERVER|SSL3_CC_READ) +# define SSL3_CHANGE_CIPHER_CLIENT_READ (SSL3_CC_CLIENT|SSL3_CC_READ) +# define SSL3_CHANGE_CIPHER_SERVER_WRITE (SSL3_CC_SERVER|SSL3_CC_WRITE) + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/sslerr.h b/include/openssl/sslerr.h new file mode 100644 index 0000000..87b295c --- /dev/null +++ b/include/openssl/sslerr.h @@ -0,0 +1,767 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SSLERR_H +# define HEADER_SSLERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_SSL_strings(void); + +/* + * SSL function codes. + */ +# define SSL_F_ADD_CLIENT_KEY_SHARE_EXT 438 +# define SSL_F_ADD_KEY_SHARE 512 +# define SSL_F_BYTES_TO_CIPHER_LIST 519 +# define SSL_F_CHECK_SUITEB_CIPHER_LIST 331 +# define SSL_F_CIPHERSUITE_CB 622 +# define SSL_F_CONSTRUCT_CA_NAMES 552 +# define SSL_F_CONSTRUCT_KEY_EXCHANGE_TBS 553 +# define SSL_F_CONSTRUCT_STATEFUL_TICKET 636 +# define SSL_F_CONSTRUCT_STATELESS_TICKET 637 +# define SSL_F_CREATE_SYNTHETIC_MESSAGE_HASH 539 +# define SSL_F_CREATE_TICKET_PREQUEL 638 +# define SSL_F_CT_MOVE_SCTS 345 +# define SSL_F_CT_STRICT 349 +# define SSL_F_CUSTOM_EXT_ADD 554 +# define SSL_F_CUSTOM_EXT_PARSE 555 +# define SSL_F_D2I_SSL_SESSION 103 +# define SSL_F_DANE_CTX_ENABLE 347 +# define SSL_F_DANE_MTYPE_SET 393 +# define SSL_F_DANE_TLSA_ADD 394 +# define SSL_F_DERIVE_SECRET_KEY_AND_IV 514 +# define SSL_F_DO_DTLS1_WRITE 245 +# define SSL_F_DO_SSL3_WRITE 104 +# define SSL_F_DTLS1_BUFFER_RECORD 247 +# define SSL_F_DTLS1_CHECK_TIMEOUT_NUM 318 +# define SSL_F_DTLS1_HEARTBEAT 305 +# define SSL_F_DTLS1_HM_FRAGMENT_NEW 623 +# define SSL_F_DTLS1_PREPROCESS_FRAGMENT 288 +# define SSL_F_DTLS1_PROCESS_BUFFERED_RECORDS 424 +# define SSL_F_DTLS1_PROCESS_RECORD 257 +# define SSL_F_DTLS1_READ_BYTES 258 +# define SSL_F_DTLS1_READ_FAILED 339 +# define SSL_F_DTLS1_RETRANSMIT_MESSAGE 390 +# define SSL_F_DTLS1_WRITE_APP_DATA_BYTES 268 +# define SSL_F_DTLS1_WRITE_BYTES 545 +# define SSL_F_DTLSV1_LISTEN 350 +# define SSL_F_DTLS_CONSTRUCT_CHANGE_CIPHER_SPEC 371 +# define SSL_F_DTLS_CONSTRUCT_HELLO_VERIFY_REQUEST 385 +# define SSL_F_DTLS_GET_REASSEMBLED_MESSAGE 370 +# define SSL_F_DTLS_PROCESS_HELLO_VERIFY 386 +# define SSL_F_DTLS_RECORD_LAYER_NEW 635 +# define SSL_F_DTLS_WAIT_FOR_DRY 592 +# define SSL_F_EARLY_DATA_COUNT_OK 532 +# define SSL_F_FINAL_EARLY_DATA 556 +# define SSL_F_FINAL_EC_PT_FORMATS 485 +# define SSL_F_FINAL_EMS 486 +# define SSL_F_FINAL_KEY_SHARE 503 +# define SSL_F_FINAL_MAXFRAGMENTLEN 557 +# define SSL_F_FINAL_RENEGOTIATE 483 +# define SSL_F_FINAL_SERVER_NAME 558 +# define SSL_F_FINAL_SIG_ALGS 497 +# define SSL_F_GET_CERT_VERIFY_TBS_DATA 588 +# define SSL_F_NSS_KEYLOG_INT 500 +# define SSL_F_OPENSSL_INIT_SSL 342 +# define SSL_F_OSSL_STATEM_CLIENT13_READ_TRANSITION 436 +# define SSL_F_OSSL_STATEM_CLIENT13_WRITE_TRANSITION 598 +# define SSL_F_OSSL_STATEM_CLIENT_CONSTRUCT_MESSAGE 430 +# define SSL_F_OSSL_STATEM_CLIENT_POST_PROCESS_MESSAGE 593 +# define SSL_F_OSSL_STATEM_CLIENT_PROCESS_MESSAGE 594 +# define SSL_F_OSSL_STATEM_CLIENT_READ_TRANSITION 417 +# define SSL_F_OSSL_STATEM_CLIENT_WRITE_TRANSITION 599 +# define SSL_F_OSSL_STATEM_SERVER13_READ_TRANSITION 437 +# define SSL_F_OSSL_STATEM_SERVER13_WRITE_TRANSITION 600 +# define SSL_F_OSSL_STATEM_SERVER_CONSTRUCT_MESSAGE 431 +# define SSL_F_OSSL_STATEM_SERVER_POST_PROCESS_MESSAGE 601 +# define SSL_F_OSSL_STATEM_SERVER_POST_WORK 602 +# define SSL_F_OSSL_STATEM_SERVER_PROCESS_MESSAGE 603 +# define SSL_F_OSSL_STATEM_SERVER_READ_TRANSITION 418 +# define SSL_F_OSSL_STATEM_SERVER_WRITE_TRANSITION 604 +# define SSL_F_PARSE_CA_NAMES 541 +# define SSL_F_PITEM_NEW 624 +# define SSL_F_PQUEUE_NEW 625 +# define SSL_F_PROCESS_KEY_SHARE_EXT 439 +# define SSL_F_READ_STATE_MACHINE 352 +# define SSL_F_SET_CLIENT_CIPHERSUITE 540 +# define SSL_F_SRP_GENERATE_CLIENT_MASTER_SECRET 595 +# define SSL_F_SRP_GENERATE_SERVER_MASTER_SECRET 589 +# define SSL_F_SRP_VERIFY_SERVER_PARAM 596 +# define SSL_F_SSL3_CHANGE_CIPHER_STATE 129 +# define SSL_F_SSL3_CHECK_CERT_AND_ALGORITHM 130 +# define SSL_F_SSL3_CTRL 213 +# define SSL_F_SSL3_CTX_CTRL 133 +# define SSL_F_SSL3_DIGEST_CACHED_RECORDS 293 +# define SSL_F_SSL3_DO_CHANGE_CIPHER_SPEC 292 +# define SSL_F_SSL3_ENC 608 +# define SSL_F_SSL3_FINAL_FINISH_MAC 285 +# define SSL_F_SSL3_FINISH_MAC 587 +# define SSL_F_SSL3_GENERATE_KEY_BLOCK 238 +# define SSL_F_SSL3_GENERATE_MASTER_SECRET 388 +# define SSL_F_SSL3_GET_RECORD 143 +# define SSL_F_SSL3_INIT_FINISHED_MAC 397 +# define SSL_F_SSL3_OUTPUT_CERT_CHAIN 147 +# define SSL_F_SSL3_READ_BYTES 148 +# define SSL_F_SSL3_READ_N 149 +# define SSL_F_SSL3_SETUP_KEY_BLOCK 157 +# define SSL_F_SSL3_SETUP_READ_BUFFER 156 +# define SSL_F_SSL3_SETUP_WRITE_BUFFER 291 +# define SSL_F_SSL3_WRITE_BYTES 158 +# define SSL_F_SSL3_WRITE_PENDING 159 +# define SSL_F_SSL_ADD_CERT_CHAIN 316 +# define SSL_F_SSL_ADD_CERT_TO_BUF 319 +# define SSL_F_SSL_ADD_CERT_TO_WPACKET 493 +# define SSL_F_SSL_ADD_CLIENTHELLO_RENEGOTIATE_EXT 298 +# define SSL_F_SSL_ADD_CLIENTHELLO_TLSEXT 277 +# define SSL_F_SSL_ADD_CLIENTHELLO_USE_SRTP_EXT 307 +# define SSL_F_SSL_ADD_DIR_CERT_SUBJECTS_TO_STACK 215 +# define SSL_F_SSL_ADD_FILE_CERT_SUBJECTS_TO_STACK 216 +# define SSL_F_SSL_ADD_SERVERHELLO_RENEGOTIATE_EXT 299 +# define SSL_F_SSL_ADD_SERVERHELLO_TLSEXT 278 +# define SSL_F_SSL_ADD_SERVERHELLO_USE_SRTP_EXT 308 +# define SSL_F_SSL_BAD_METHOD 160 +# define SSL_F_SSL_BUILD_CERT_CHAIN 332 +# define SSL_F_SSL_BYTES_TO_CIPHER_LIST 161 +# define SSL_F_SSL_CACHE_CIPHERLIST 520 +# define SSL_F_SSL_CERT_ADD0_CHAIN_CERT 346 +# define SSL_F_SSL_CERT_DUP 221 +# define SSL_F_SSL_CERT_NEW 162 +# define SSL_F_SSL_CERT_SET0_CHAIN 340 +# define SSL_F_SSL_CHECK_PRIVATE_KEY 163 +# define SSL_F_SSL_CHECK_SERVERHELLO_TLSEXT 280 +# define SSL_F_SSL_CHECK_SRP_EXT_CLIENTHELLO 606 +# define SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG 279 +# define SSL_F_SSL_CHOOSE_CLIENT_VERSION 607 +# define SSL_F_SSL_CIPHER_DESCRIPTION 626 +# define SSL_F_SSL_CIPHER_LIST_TO_BYTES 425 +# define SSL_F_SSL_CIPHER_PROCESS_RULESTR 230 +# define SSL_F_SSL_CIPHER_STRENGTH_SORT 231 +# define SSL_F_SSL_CLEAR 164 +# define SSL_F_SSL_CLIENT_HELLO_GET1_EXTENSIONS_PRESENT 627 +# define SSL_F_SSL_COMP_ADD_COMPRESSION_METHOD 165 +# define SSL_F_SSL_CONF_CMD 334 +# define SSL_F_SSL_CREATE_CIPHER_LIST 166 +# define SSL_F_SSL_CTRL 232 +# define SSL_F_SSL_CTX_CHECK_PRIVATE_KEY 168 +# define SSL_F_SSL_CTX_ENABLE_CT 398 +# define SSL_F_SSL_CTX_MAKE_PROFILES 309 +# define SSL_F_SSL_CTX_NEW 169 +# define SSL_F_SSL_CTX_SET_ALPN_PROTOS 343 +# define SSL_F_SSL_CTX_SET_CIPHER_LIST 269 +# define SSL_F_SSL_CTX_SET_CLIENT_CERT_ENGINE 290 +# define SSL_F_SSL_CTX_SET_CT_VALIDATION_CALLBACK 396 +# define SSL_F_SSL_CTX_SET_SESSION_ID_CONTEXT 219 +# define SSL_F_SSL_CTX_SET_SSL_VERSION 170 +# define SSL_F_SSL_CTX_SET_TLSEXT_MAX_FRAGMENT_LENGTH 551 +# define SSL_F_SSL_CTX_USE_CERTIFICATE 171 +# define SSL_F_SSL_CTX_USE_CERTIFICATE_ASN1 172 +# define SSL_F_SSL_CTX_USE_CERTIFICATE_FILE 173 +# define SSL_F_SSL_CTX_USE_PRIVATEKEY 174 +# define SSL_F_SSL_CTX_USE_PRIVATEKEY_ASN1 175 +# define SSL_F_SSL_CTX_USE_PRIVATEKEY_FILE 176 +# define SSL_F_SSL_CTX_USE_PSK_IDENTITY_HINT 272 +# define SSL_F_SSL_CTX_USE_RSAPRIVATEKEY 177 +# define SSL_F_SSL_CTX_USE_RSAPRIVATEKEY_ASN1 178 +# define SSL_F_SSL_CTX_USE_RSAPRIVATEKEY_FILE 179 +# define SSL_F_SSL_CTX_USE_SERVERINFO 336 +# define SSL_F_SSL_CTX_USE_SERVERINFO_EX 543 +# define SSL_F_SSL_CTX_USE_SERVERINFO_FILE 337 +# define SSL_F_SSL_DANE_DUP 403 +# define SSL_F_SSL_DANE_ENABLE 395 +# define SSL_F_SSL_DERIVE 590 +# define SSL_F_SSL_DO_CONFIG 391 +# define SSL_F_SSL_DO_HANDSHAKE 180 +# define SSL_F_SSL_DUP_CA_LIST 408 +# define SSL_F_SSL_ENABLE_CT 402 +# define SSL_F_SSL_GENERATE_PKEY_GROUP 559 +# define SSL_F_SSL_GENERATE_SESSION_ID 547 +# define SSL_F_SSL_GET_NEW_SESSION 181 +# define SSL_F_SSL_GET_PREV_SESSION 217 +# define SSL_F_SSL_GET_SERVER_CERT_INDEX 322 +# define SSL_F_SSL_GET_SIGN_PKEY 183 +# define SSL_F_SSL_HANDSHAKE_HASH 560 +# define SSL_F_SSL_INIT_WBIO_BUFFER 184 +# define SSL_F_SSL_KEY_UPDATE 515 +# define SSL_F_SSL_LOAD_CLIENT_CA_FILE 185 +# define SSL_F_SSL_LOG_MASTER_SECRET 498 +# define SSL_F_SSL_LOG_RSA_CLIENT_KEY_EXCHANGE 499 +# define SSL_F_SSL_MODULE_INIT 392 +# define SSL_F_SSL_NEW 186 +# define SSL_F_SSL_NEXT_PROTO_VALIDATE 565 +# define SSL_F_SSL_PARSE_CLIENTHELLO_RENEGOTIATE_EXT 300 +# define SSL_F_SSL_PARSE_CLIENTHELLO_TLSEXT 302 +# define SSL_F_SSL_PARSE_CLIENTHELLO_USE_SRTP_EXT 310 +# define SSL_F_SSL_PARSE_SERVERHELLO_RENEGOTIATE_EXT 301 +# define SSL_F_SSL_PARSE_SERVERHELLO_TLSEXT 303 +# define SSL_F_SSL_PARSE_SERVERHELLO_USE_SRTP_EXT 311 +# define SSL_F_SSL_PEEK 270 +# define SSL_F_SSL_PEEK_EX 432 +# define SSL_F_SSL_PEEK_INTERNAL 522 +# define SSL_F_SSL_READ 223 +# define SSL_F_SSL_READ_EARLY_DATA 529 +# define SSL_F_SSL_READ_EX 434 +# define SSL_F_SSL_READ_INTERNAL 523 +# define SSL_F_SSL_RENEGOTIATE 516 +# define SSL_F_SSL_RENEGOTIATE_ABBREVIATED 546 +# define SSL_F_SSL_SCAN_CLIENTHELLO_TLSEXT 320 +# define SSL_F_SSL_SCAN_SERVERHELLO_TLSEXT 321 +# define SSL_F_SSL_SESSION_DUP 348 +# define SSL_F_SSL_SESSION_NEW 189 +# define SSL_F_SSL_SESSION_PRINT_FP 190 +# define SSL_F_SSL_SESSION_SET1_ID 423 +# define SSL_F_SSL_SESSION_SET1_ID_CONTEXT 312 +# define SSL_F_SSL_SET_ALPN_PROTOS 344 +# define SSL_F_SSL_SET_CERT 191 +# define SSL_F_SSL_SET_CERT_AND_KEY 621 +# define SSL_F_SSL_SET_CIPHER_LIST 271 +# define SSL_F_SSL_SET_CT_VALIDATION_CALLBACK 399 +# define SSL_F_SSL_SET_FD 192 +# define SSL_F_SSL_SET_PKEY 193 +# define SSL_F_SSL_SET_RFD 194 +# define SSL_F_SSL_SET_SESSION 195 +# define SSL_F_SSL_SET_SESSION_ID_CONTEXT 218 +# define SSL_F_SSL_SET_SESSION_TICKET_EXT 294 +# define SSL_F_SSL_SET_TLSEXT_MAX_FRAGMENT_LENGTH 550 +# define SSL_F_SSL_SET_WFD 196 +# define SSL_F_SSL_SHUTDOWN 224 +# define SSL_F_SSL_SRP_CTX_INIT 313 +# define SSL_F_SSL_START_ASYNC_JOB 389 +# define SSL_F_SSL_UNDEFINED_FUNCTION 197 +# define SSL_F_SSL_UNDEFINED_VOID_FUNCTION 244 +# define SSL_F_SSL_USE_CERTIFICATE 198 +# define SSL_F_SSL_USE_CERTIFICATE_ASN1 199 +# define SSL_F_SSL_USE_CERTIFICATE_FILE 200 +# define SSL_F_SSL_USE_PRIVATEKEY 201 +# define SSL_F_SSL_USE_PRIVATEKEY_ASN1 202 +# define SSL_F_SSL_USE_PRIVATEKEY_FILE 203 +# define SSL_F_SSL_USE_PSK_IDENTITY_HINT 273 +# define SSL_F_SSL_USE_RSAPRIVATEKEY 204 +# define SSL_F_SSL_USE_RSAPRIVATEKEY_ASN1 205 +# define SSL_F_SSL_USE_RSAPRIVATEKEY_FILE 206 +# define SSL_F_SSL_VALIDATE_CT 400 +# define SSL_F_SSL_VERIFY_CERT_CHAIN 207 +# define SSL_F_SSL_VERIFY_CLIENT_POST_HANDSHAKE 616 +# define SSL_F_SSL_WRITE 208 +# define SSL_F_SSL_WRITE_EARLY_DATA 526 +# define SSL_F_SSL_WRITE_EARLY_FINISH 527 +# define SSL_F_SSL_WRITE_EX 433 +# define SSL_F_SSL_WRITE_INTERNAL 524 +# define SSL_F_STATE_MACHINE 353 +# define SSL_F_TLS12_CHECK_PEER_SIGALG 333 +# define SSL_F_TLS12_COPY_SIGALGS 533 +# define SSL_F_TLS13_CHANGE_CIPHER_STATE 440 +# define SSL_F_TLS13_ENC 609 +# define SSL_F_TLS13_FINAL_FINISH_MAC 605 +# define SSL_F_TLS13_GENERATE_SECRET 591 +# define SSL_F_TLS13_HKDF_EXPAND 561 +# define SSL_F_TLS13_RESTORE_HANDSHAKE_DIGEST_FOR_PHA 617 +# define SSL_F_TLS13_SAVE_HANDSHAKE_DIGEST_FOR_PHA 618 +# define SSL_F_TLS13_SETUP_KEY_BLOCK 441 +# define SSL_F_TLS1_CHANGE_CIPHER_STATE 209 +# define SSL_F_TLS1_CHECK_DUPLICATE_EXTENSIONS 341 +# define SSL_F_TLS1_ENC 401 +# define SSL_F_TLS1_EXPORT_KEYING_MATERIAL 314 +# define SSL_F_TLS1_GET_CURVELIST 338 +# define SSL_F_TLS1_PRF 284 +# define SSL_F_TLS1_SAVE_U16 628 +# define SSL_F_TLS1_SETUP_KEY_BLOCK 211 +# define SSL_F_TLS1_SET_GROUPS 629 +# define SSL_F_TLS1_SET_RAW_SIGALGS 630 +# define SSL_F_TLS1_SET_SERVER_SIGALGS 335 +# define SSL_F_TLS1_SET_SHARED_SIGALGS 631 +# define SSL_F_TLS1_SET_SIGALGS 632 +# define SSL_F_TLS_CHOOSE_SIGALG 513 +# define SSL_F_TLS_CLIENT_KEY_EXCHANGE_POST_WORK 354 +# define SSL_F_TLS_COLLECT_EXTENSIONS 435 +# define SSL_F_TLS_CONSTRUCT_CERTIFICATE_AUTHORITIES 542 +# define SSL_F_TLS_CONSTRUCT_CERTIFICATE_REQUEST 372 +# define SSL_F_TLS_CONSTRUCT_CERT_STATUS 429 +# define SSL_F_TLS_CONSTRUCT_CERT_STATUS_BODY 494 +# define SSL_F_TLS_CONSTRUCT_CERT_VERIFY 496 +# define SSL_F_TLS_CONSTRUCT_CHANGE_CIPHER_SPEC 427 +# define SSL_F_TLS_CONSTRUCT_CKE_DHE 404 +# define SSL_F_TLS_CONSTRUCT_CKE_ECDHE 405 +# define SSL_F_TLS_CONSTRUCT_CKE_GOST 406 +# define SSL_F_TLS_CONSTRUCT_CKE_PSK_PREAMBLE 407 +# define SSL_F_TLS_CONSTRUCT_CKE_RSA 409 +# define SSL_F_TLS_CONSTRUCT_CKE_SRP 410 +# define SSL_F_TLS_CONSTRUCT_CLIENT_CERTIFICATE 484 +# define SSL_F_TLS_CONSTRUCT_CLIENT_HELLO 487 +# define SSL_F_TLS_CONSTRUCT_CLIENT_KEY_EXCHANGE 488 +# define SSL_F_TLS_CONSTRUCT_CLIENT_VERIFY 489 +# define SSL_F_TLS_CONSTRUCT_CTOS_ALPN 466 +# define SSL_F_TLS_CONSTRUCT_CTOS_CERTIFICATE 355 +# define SSL_F_TLS_CONSTRUCT_CTOS_COOKIE 535 +# define SSL_F_TLS_CONSTRUCT_CTOS_EARLY_DATA 530 +# define SSL_F_TLS_CONSTRUCT_CTOS_EC_PT_FORMATS 467 +# define SSL_F_TLS_CONSTRUCT_CTOS_EMS 468 +# define SSL_F_TLS_CONSTRUCT_CTOS_ETM 469 +# define SSL_F_TLS_CONSTRUCT_CTOS_HELLO 356 +# define SSL_F_TLS_CONSTRUCT_CTOS_KEY_EXCHANGE 357 +# define SSL_F_TLS_CONSTRUCT_CTOS_KEY_SHARE 470 +# define SSL_F_TLS_CONSTRUCT_CTOS_MAXFRAGMENTLEN 549 +# define SSL_F_TLS_CONSTRUCT_CTOS_NPN 471 +# define SSL_F_TLS_CONSTRUCT_CTOS_PADDING 472 +# define SSL_F_TLS_CONSTRUCT_CTOS_POST_HANDSHAKE_AUTH 619 +# define SSL_F_TLS_CONSTRUCT_CTOS_PSK 501 +# define SSL_F_TLS_CONSTRUCT_CTOS_PSK_KEX_MODES 509 +# define SSL_F_TLS_CONSTRUCT_CTOS_RENEGOTIATE 473 +# define SSL_F_TLS_CONSTRUCT_CTOS_SCT 474 +# define SSL_F_TLS_CONSTRUCT_CTOS_SERVER_NAME 475 +# define SSL_F_TLS_CONSTRUCT_CTOS_SESSION_TICKET 476 +# define SSL_F_TLS_CONSTRUCT_CTOS_SIG_ALGS 477 +# define SSL_F_TLS_CONSTRUCT_CTOS_SRP 478 +# define SSL_F_TLS_CONSTRUCT_CTOS_STATUS_REQUEST 479 +# define SSL_F_TLS_CONSTRUCT_CTOS_SUPPORTED_GROUPS 480 +# define SSL_F_TLS_CONSTRUCT_CTOS_SUPPORTED_VERSIONS 481 +# define SSL_F_TLS_CONSTRUCT_CTOS_USE_SRTP 482 +# define SSL_F_TLS_CONSTRUCT_CTOS_VERIFY 358 +# define SSL_F_TLS_CONSTRUCT_ENCRYPTED_EXTENSIONS 443 +# define SSL_F_TLS_CONSTRUCT_END_OF_EARLY_DATA 536 +# define SSL_F_TLS_CONSTRUCT_EXTENSIONS 447 +# define SSL_F_TLS_CONSTRUCT_FINISHED 359 +# define SSL_F_TLS_CONSTRUCT_HELLO_REQUEST 373 +# define SSL_F_TLS_CONSTRUCT_HELLO_RETRY_REQUEST 510 +# define SSL_F_TLS_CONSTRUCT_KEY_UPDATE 517 +# define SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET 428 +# define SSL_F_TLS_CONSTRUCT_NEXT_PROTO 426 +# define SSL_F_TLS_CONSTRUCT_SERVER_CERTIFICATE 490 +# define SSL_F_TLS_CONSTRUCT_SERVER_HELLO 491 +# define SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE 492 +# define SSL_F_TLS_CONSTRUCT_STOC_ALPN 451 +# define SSL_F_TLS_CONSTRUCT_STOC_CERTIFICATE 374 +# define SSL_F_TLS_CONSTRUCT_STOC_COOKIE 613 +# define SSL_F_TLS_CONSTRUCT_STOC_CRYPTOPRO_BUG 452 +# define SSL_F_TLS_CONSTRUCT_STOC_DONE 375 +# define SSL_F_TLS_CONSTRUCT_STOC_EARLY_DATA 531 +# define SSL_F_TLS_CONSTRUCT_STOC_EARLY_DATA_INFO 525 +# define SSL_F_TLS_CONSTRUCT_STOC_EC_PT_FORMATS 453 +# define SSL_F_TLS_CONSTRUCT_STOC_EMS 454 +# define SSL_F_TLS_CONSTRUCT_STOC_ETM 455 +# define SSL_F_TLS_CONSTRUCT_STOC_HELLO 376 +# define SSL_F_TLS_CONSTRUCT_STOC_KEY_EXCHANGE 377 +# define SSL_F_TLS_CONSTRUCT_STOC_KEY_SHARE 456 +# define SSL_F_TLS_CONSTRUCT_STOC_MAXFRAGMENTLEN 548 +# define SSL_F_TLS_CONSTRUCT_STOC_NEXT_PROTO_NEG 457 +# define SSL_F_TLS_CONSTRUCT_STOC_PSK 504 +# define SSL_F_TLS_CONSTRUCT_STOC_RENEGOTIATE 458 +# define SSL_F_TLS_CONSTRUCT_STOC_SERVER_NAME 459 +# define SSL_F_TLS_CONSTRUCT_STOC_SESSION_TICKET 460 +# define SSL_F_TLS_CONSTRUCT_STOC_STATUS_REQUEST 461 +# define SSL_F_TLS_CONSTRUCT_STOC_SUPPORTED_GROUPS 544 +# define SSL_F_TLS_CONSTRUCT_STOC_SUPPORTED_VERSIONS 611 +# define SSL_F_TLS_CONSTRUCT_STOC_USE_SRTP 462 +# define SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO 521 +# define SSL_F_TLS_FINISH_HANDSHAKE 597 +# define SSL_F_TLS_GET_MESSAGE_BODY 351 +# define SSL_F_TLS_GET_MESSAGE_HEADER 387 +# define SSL_F_TLS_HANDLE_ALPN 562 +# define SSL_F_TLS_HANDLE_STATUS_REQUEST 563 +# define SSL_F_TLS_PARSE_CERTIFICATE_AUTHORITIES 566 +# define SSL_F_TLS_PARSE_CLIENTHELLO_TLSEXT 449 +# define SSL_F_TLS_PARSE_CTOS_ALPN 567 +# define SSL_F_TLS_PARSE_CTOS_COOKIE 614 +# define SSL_F_TLS_PARSE_CTOS_EARLY_DATA 568 +# define SSL_F_TLS_PARSE_CTOS_EC_PT_FORMATS 569 +# define SSL_F_TLS_PARSE_CTOS_EMS 570 +# define SSL_F_TLS_PARSE_CTOS_KEY_SHARE 463 +# define SSL_F_TLS_PARSE_CTOS_MAXFRAGMENTLEN 571 +# define SSL_F_TLS_PARSE_CTOS_POST_HANDSHAKE_AUTH 620 +# define SSL_F_TLS_PARSE_CTOS_PSK 505 +# define SSL_F_TLS_PARSE_CTOS_PSK_KEX_MODES 572 +# define SSL_F_TLS_PARSE_CTOS_RENEGOTIATE 464 +# define SSL_F_TLS_PARSE_CTOS_SERVER_NAME 573 +# define SSL_F_TLS_PARSE_CTOS_SESSION_TICKET 574 +# define SSL_F_TLS_PARSE_CTOS_SIG_ALGS 575 +# define SSL_F_TLS_PARSE_CTOS_SIG_ALGS_CERT 615 +# define SSL_F_TLS_PARSE_CTOS_SRP 576 +# define SSL_F_TLS_PARSE_CTOS_STATUS_REQUEST 577 +# define SSL_F_TLS_PARSE_CTOS_SUPPORTED_GROUPS 578 +# define SSL_F_TLS_PARSE_CTOS_USE_SRTP 465 +# define SSL_F_TLS_PARSE_STOC_ALPN 579 +# define SSL_F_TLS_PARSE_STOC_COOKIE 534 +# define SSL_F_TLS_PARSE_STOC_EARLY_DATA 538 +# define SSL_F_TLS_PARSE_STOC_EARLY_DATA_INFO 528 +# define SSL_F_TLS_PARSE_STOC_EC_PT_FORMATS 580 +# define SSL_F_TLS_PARSE_STOC_KEY_SHARE 445 +# define SSL_F_TLS_PARSE_STOC_MAXFRAGMENTLEN 581 +# define SSL_F_TLS_PARSE_STOC_NPN 582 +# define SSL_F_TLS_PARSE_STOC_PSK 502 +# define SSL_F_TLS_PARSE_STOC_RENEGOTIATE 448 +# define SSL_F_TLS_PARSE_STOC_SCT 564 +# define SSL_F_TLS_PARSE_STOC_SERVER_NAME 583 +# define SSL_F_TLS_PARSE_STOC_SESSION_TICKET 584 +# define SSL_F_TLS_PARSE_STOC_STATUS_REQUEST 585 +# define SSL_F_TLS_PARSE_STOC_SUPPORTED_VERSIONS 612 +# define SSL_F_TLS_PARSE_STOC_USE_SRTP 446 +# define SSL_F_TLS_POST_PROCESS_CLIENT_HELLO 378 +# define SSL_F_TLS_POST_PROCESS_CLIENT_KEY_EXCHANGE 384 +# define SSL_F_TLS_PREPARE_CLIENT_CERTIFICATE 360 +# define SSL_F_TLS_PROCESS_AS_HELLO_RETRY_REQUEST 610 +# define SSL_F_TLS_PROCESS_CERTIFICATE_REQUEST 361 +# define SSL_F_TLS_PROCESS_CERT_STATUS 362 +# define SSL_F_TLS_PROCESS_CERT_STATUS_BODY 495 +# define SSL_F_TLS_PROCESS_CERT_VERIFY 379 +# define SSL_F_TLS_PROCESS_CHANGE_CIPHER_SPEC 363 +# define SSL_F_TLS_PROCESS_CKE_DHE 411 +# define SSL_F_TLS_PROCESS_CKE_ECDHE 412 +# define SSL_F_TLS_PROCESS_CKE_GOST 413 +# define SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE 414 +# define SSL_F_TLS_PROCESS_CKE_RSA 415 +# define SSL_F_TLS_PROCESS_CKE_SRP 416 +# define SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE 380 +# define SSL_F_TLS_PROCESS_CLIENT_HELLO 381 +# define SSL_F_TLS_PROCESS_CLIENT_KEY_EXCHANGE 382 +# define SSL_F_TLS_PROCESS_ENCRYPTED_EXTENSIONS 444 +# define SSL_F_TLS_PROCESS_END_OF_EARLY_DATA 537 +# define SSL_F_TLS_PROCESS_FINISHED 364 +# define SSL_F_TLS_PROCESS_HELLO_REQ 507 +# define SSL_F_TLS_PROCESS_HELLO_RETRY_REQUEST 511 +# define SSL_F_TLS_PROCESS_INITIAL_SERVER_FLIGHT 442 +# define SSL_F_TLS_PROCESS_KEY_EXCHANGE 365 +# define SSL_F_TLS_PROCESS_KEY_UPDATE 518 +# define SSL_F_TLS_PROCESS_NEW_SESSION_TICKET 366 +# define SSL_F_TLS_PROCESS_NEXT_PROTO 383 +# define SSL_F_TLS_PROCESS_SERVER_CERTIFICATE 367 +# define SSL_F_TLS_PROCESS_SERVER_DONE 368 +# define SSL_F_TLS_PROCESS_SERVER_HELLO 369 +# define SSL_F_TLS_PROCESS_SKE_DHE 419 +# define SSL_F_TLS_PROCESS_SKE_ECDHE 420 +# define SSL_F_TLS_PROCESS_SKE_PSK_PREAMBLE 421 +# define SSL_F_TLS_PROCESS_SKE_SRP 422 +# define SSL_F_TLS_PSK_DO_BINDER 506 +# define SSL_F_TLS_SCAN_CLIENTHELLO_TLSEXT 450 +# define SSL_F_TLS_SETUP_HANDSHAKE 508 +# define SSL_F_USE_CERTIFICATE_CHAIN_FILE 220 +# define SSL_F_WPACKET_INTERN_INIT_LEN 633 +# define SSL_F_WPACKET_START_SUB_PACKET_LEN__ 634 +# define SSL_F_WRITE_STATE_MACHINE 586 + +/* + * SSL reason codes. + */ +# define SSL_R_APPLICATION_DATA_AFTER_CLOSE_NOTIFY 291 +# define SSL_R_APP_DATA_IN_HANDSHAKE 100 +# define SSL_R_ATTEMPT_TO_REUSE_SESSION_IN_DIFFERENT_CONTEXT 272 +# define SSL_R_AT_LEAST_TLS_1_0_NEEDED_IN_FIPS_MODE 143 +# define SSL_R_AT_LEAST_TLS_1_2_NEEDED_IN_SUITEB_MODE 158 +# define SSL_R_BAD_CHANGE_CIPHER_SPEC 103 +# define SSL_R_BAD_CIPHER 186 +# define SSL_R_BAD_DATA 390 +# define SSL_R_BAD_DATA_RETURNED_BY_CALLBACK 106 +# define SSL_R_BAD_DECOMPRESSION 107 +# define SSL_R_BAD_DH_VALUE 102 +# define SSL_R_BAD_DIGEST_LENGTH 111 +# define SSL_R_BAD_EARLY_DATA 233 +# define SSL_R_BAD_ECC_CERT 304 +# define SSL_R_BAD_ECPOINT 306 +# define SSL_R_BAD_EXTENSION 110 +# define SSL_R_BAD_HANDSHAKE_LENGTH 332 +# define SSL_R_BAD_HANDSHAKE_STATE 236 +# define SSL_R_BAD_HELLO_REQUEST 105 +# define SSL_R_BAD_HRR_VERSION 263 +# define SSL_R_BAD_KEY_SHARE 108 +# define SSL_R_BAD_KEY_UPDATE 122 +# define SSL_R_BAD_LEGACY_VERSION 292 +# define SSL_R_BAD_LENGTH 271 +# define SSL_R_BAD_PACKET 240 +# define SSL_R_BAD_PACKET_LENGTH 115 +# define SSL_R_BAD_PROTOCOL_VERSION_NUMBER 116 +# define SSL_R_BAD_PSK 219 +# define SSL_R_BAD_PSK_IDENTITY 114 +# define SSL_R_BAD_RECORD_TYPE 443 +# define SSL_R_BAD_RSA_ENCRYPT 119 +# define SSL_R_BAD_SIGNATURE 123 +# define SSL_R_BAD_SRP_A_LENGTH 347 +# define SSL_R_BAD_SRP_PARAMETERS 371 +# define SSL_R_BAD_SRTP_MKI_VALUE 352 +# define SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST 353 +# define SSL_R_BAD_SSL_FILETYPE 124 +# define SSL_R_BAD_VALUE 384 +# define SSL_R_BAD_WRITE_RETRY 127 +# define SSL_R_BINDER_DOES_NOT_VERIFY 253 +# define SSL_R_BIO_NOT_SET 128 +# define SSL_R_BLOCK_CIPHER_PAD_IS_WRONG 129 +# define SSL_R_BN_LIB 130 +# define SSL_R_CALLBACK_FAILED 234 +# define SSL_R_CANNOT_CHANGE_CIPHER 109 +# define SSL_R_CA_DN_LENGTH_MISMATCH 131 +# define SSL_R_CA_KEY_TOO_SMALL 397 +# define SSL_R_CA_MD_TOO_WEAK 398 +# define SSL_R_CCS_RECEIVED_EARLY 133 +# define SSL_R_CERTIFICATE_VERIFY_FAILED 134 +# define SSL_R_CERT_CB_ERROR 377 +# define SSL_R_CERT_LENGTH_MISMATCH 135 +# define SSL_R_CIPHERSUITE_DIGEST_HAS_CHANGED 218 +# define SSL_R_CIPHER_CODE_WRONG_LENGTH 137 +# define SSL_R_CIPHER_OR_HASH_UNAVAILABLE 138 +# define SSL_R_CLIENTHELLO_TLSEXT 226 +# define SSL_R_COMPRESSED_LENGTH_TOO_LONG 140 +# define SSL_R_COMPRESSION_DISABLED 343 +# define SSL_R_COMPRESSION_FAILURE 141 +# define SSL_R_COMPRESSION_ID_NOT_WITHIN_PRIVATE_RANGE 307 +# define SSL_R_COMPRESSION_LIBRARY_ERROR 142 +# define SSL_R_CONNECTION_TYPE_NOT_SET 144 +# define SSL_R_CONTEXT_NOT_DANE_ENABLED 167 +# define SSL_R_COOKIE_GEN_CALLBACK_FAILURE 400 +# define SSL_R_COOKIE_MISMATCH 308 +# define SSL_R_CUSTOM_EXT_HANDLER_ALREADY_INSTALLED 206 +# define SSL_R_DANE_ALREADY_ENABLED 172 +# define SSL_R_DANE_CANNOT_OVERRIDE_MTYPE_FULL 173 +# define SSL_R_DANE_NOT_ENABLED 175 +# define SSL_R_DANE_TLSA_BAD_CERTIFICATE 180 +# define SSL_R_DANE_TLSA_BAD_CERTIFICATE_USAGE 184 +# define SSL_R_DANE_TLSA_BAD_DATA_LENGTH 189 +# define SSL_R_DANE_TLSA_BAD_DIGEST_LENGTH 192 +# define SSL_R_DANE_TLSA_BAD_MATCHING_TYPE 200 +# define SSL_R_DANE_TLSA_BAD_PUBLIC_KEY 201 +# define SSL_R_DANE_TLSA_BAD_SELECTOR 202 +# define SSL_R_DANE_TLSA_NULL_DATA 203 +# define SSL_R_DATA_BETWEEN_CCS_AND_FINISHED 145 +# define SSL_R_DATA_LENGTH_TOO_LONG 146 +# define SSL_R_DECRYPTION_FAILED 147 +# define SSL_R_DECRYPTION_FAILED_OR_BAD_RECORD_MAC 281 +# define SSL_R_DH_KEY_TOO_SMALL 394 +# define SSL_R_DH_PUBLIC_VALUE_LENGTH_IS_WRONG 148 +# define SSL_R_DIGEST_CHECK_FAILED 149 +# define SSL_R_DTLS_MESSAGE_TOO_BIG 334 +# define SSL_R_DUPLICATE_COMPRESSION_ID 309 +# define SSL_R_ECC_CERT_NOT_FOR_SIGNING 318 +# define SSL_R_ECDH_REQUIRED_FOR_SUITEB_MODE 374 +# define SSL_R_EE_KEY_TOO_SMALL 399 +# define SSL_R_EMPTY_SRTP_PROTECTION_PROFILE_LIST 354 +# define SSL_R_ENCRYPTED_LENGTH_TOO_LONG 150 +# define SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST 151 +# define SSL_R_ERROR_SETTING_TLSA_BASE_DOMAIN 204 +# define SSL_R_EXCEEDS_MAX_FRAGMENT_SIZE 194 +# define SSL_R_EXCESSIVE_MESSAGE_SIZE 152 +# define SSL_R_EXTENSION_NOT_RECEIVED 279 +# define SSL_R_EXTRA_DATA_IN_MESSAGE 153 +# define SSL_R_EXT_LENGTH_MISMATCH 163 +# define SSL_R_FAILED_TO_INIT_ASYNC 405 +# define SSL_R_FRAGMENTED_CLIENT_HELLO 401 +# define SSL_R_GOT_A_FIN_BEFORE_A_CCS 154 +# define SSL_R_HTTPS_PROXY_REQUEST 155 +# define SSL_R_HTTP_REQUEST 156 +# define SSL_R_ILLEGAL_POINT_COMPRESSION 162 +# define SSL_R_ILLEGAL_SUITEB_DIGEST 380 +# define SSL_R_INAPPROPRIATE_FALLBACK 373 +# define SSL_R_INCONSISTENT_COMPRESSION 340 +# define SSL_R_INCONSISTENT_EARLY_DATA_ALPN 222 +# define SSL_R_INCONSISTENT_EARLY_DATA_SNI 231 +# define SSL_R_INCONSISTENT_EXTMS 104 +# define SSL_R_INSUFFICIENT_SECURITY 241 +# define SSL_R_INVALID_ALERT 205 +# define SSL_R_INVALID_CCS_MESSAGE 260 +# define SSL_R_INVALID_CERTIFICATE_OR_ALG 238 +# define SSL_R_INVALID_COMMAND 280 +# define SSL_R_INVALID_COMPRESSION_ALGORITHM 341 +# define SSL_R_INVALID_CONFIG 283 +# define SSL_R_INVALID_CONFIGURATION_NAME 113 +# define SSL_R_INVALID_CONTEXT 282 +# define SSL_R_INVALID_CT_VALIDATION_TYPE 212 +# define SSL_R_INVALID_KEY_UPDATE_TYPE 120 +# define SSL_R_INVALID_MAX_EARLY_DATA 174 +# define SSL_R_INVALID_NULL_CMD_NAME 385 +# define SSL_R_INVALID_SEQUENCE_NUMBER 402 +# define SSL_R_INVALID_SERVERINFO_DATA 388 +# define SSL_R_INVALID_SESSION_ID 999 +# define SSL_R_INVALID_SRP_USERNAME 357 +# define SSL_R_INVALID_STATUS_RESPONSE 328 +# define SSL_R_INVALID_TICKET_KEYS_LENGTH 325 +# define SSL_R_LENGTH_MISMATCH 159 +# define SSL_R_LENGTH_TOO_LONG 404 +# define SSL_R_LENGTH_TOO_SHORT 160 +# define SSL_R_LIBRARY_BUG 274 +# define SSL_R_LIBRARY_HAS_NO_CIPHERS 161 +# define SSL_R_MISSING_DSA_SIGNING_CERT 165 +# define SSL_R_MISSING_ECDSA_SIGNING_CERT 381 +# define SSL_R_MISSING_FATAL 256 +# define SSL_R_MISSING_PARAMETERS 290 +# define SSL_R_MISSING_RSA_CERTIFICATE 168 +# define SSL_R_MISSING_RSA_ENCRYPTING_CERT 169 +# define SSL_R_MISSING_RSA_SIGNING_CERT 170 +# define SSL_R_MISSING_SIGALGS_EXTENSION 112 +# define SSL_R_MISSING_SIGNING_CERT 221 +# define SSL_R_MISSING_SRP_PARAM 358 +# define SSL_R_MISSING_SUPPORTED_GROUPS_EXTENSION 209 +# define SSL_R_MISSING_TMP_DH_KEY 171 +# define SSL_R_MISSING_TMP_ECDH_KEY 311 +# define SSL_R_NOT_ON_RECORD_BOUNDARY 182 +# define SSL_R_NOT_REPLACING_CERTIFICATE 289 +# define SSL_R_NOT_SERVER 284 +# define SSL_R_NO_APPLICATION_PROTOCOL 235 +# define SSL_R_NO_CERTIFICATES_RETURNED 176 +# define SSL_R_NO_CERTIFICATE_ASSIGNED 177 +# define SSL_R_NO_CERTIFICATE_SET 179 +# define SSL_R_NO_CHANGE_FOLLOWING_HRR 214 +# define SSL_R_NO_CIPHERS_AVAILABLE 181 +# define SSL_R_NO_CIPHERS_SPECIFIED 183 +# define SSL_R_NO_CIPHER_MATCH 185 +# define SSL_R_NO_CLIENT_CERT_METHOD 331 +# define SSL_R_NO_COMPRESSION_SPECIFIED 187 +# define SSL_R_NO_COOKIE_CALLBACK_SET 287 +# define SSL_R_NO_GOST_CERTIFICATE_SENT_BY_PEER 330 +# define SSL_R_NO_METHOD_SPECIFIED 188 +# define SSL_R_NO_PEM_EXTENSIONS 389 +# define SSL_R_NO_PRIVATE_KEY_ASSIGNED 190 +# define SSL_R_NO_PROTOCOLS_AVAILABLE 191 +# define SSL_R_NO_RENEGOTIATION 339 +# define SSL_R_NO_REQUIRED_DIGEST 324 +# define SSL_R_NO_SHARED_CIPHER 193 +# define SSL_R_NO_SHARED_GROUPS 410 +# define SSL_R_NO_SHARED_SIGNATURE_ALGORITHMS 376 +# define SSL_R_NO_SRTP_PROFILES 359 +# define SSL_R_NO_SUITABLE_KEY_SHARE 101 +# define SSL_R_NO_SUITABLE_SIGNATURE_ALGORITHM 118 +# define SSL_R_NO_VALID_SCTS 216 +# define SSL_R_NO_VERIFY_COOKIE_CALLBACK 403 +# define SSL_R_NULL_SSL_CTX 195 +# define SSL_R_NULL_SSL_METHOD_PASSED 196 +# define SSL_R_OLD_SESSION_CIPHER_NOT_RETURNED 197 +# define SSL_R_OLD_SESSION_COMPRESSION_ALGORITHM_NOT_RETURNED 344 +# define SSL_R_OVERFLOW_ERROR 237 +# define SSL_R_PACKET_LENGTH_TOO_LONG 198 +# define SSL_R_PARSE_TLSEXT 227 +# define SSL_R_PATH_TOO_LONG 270 +# define SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE 199 +# define SSL_R_PEM_NAME_BAD_PREFIX 391 +# define SSL_R_PEM_NAME_TOO_SHORT 392 +# define SSL_R_PIPELINE_FAILURE 406 +# define SSL_R_POST_HANDSHAKE_AUTH_ENCODING_ERR 278 +# define SSL_R_PRIVATE_KEY_MISMATCH 288 +# define SSL_R_PROTOCOL_IS_SHUTDOWN 207 +# define SSL_R_PSK_IDENTITY_NOT_FOUND 223 +# define SSL_R_PSK_NO_CLIENT_CB 224 +# define SSL_R_PSK_NO_SERVER_CB 225 +# define SSL_R_READ_BIO_NOT_SET 211 +# define SSL_R_READ_TIMEOUT_EXPIRED 312 +# define SSL_R_RECORD_LENGTH_MISMATCH 213 +# define SSL_R_RECORD_TOO_SMALL 298 +# define SSL_R_RENEGOTIATE_EXT_TOO_LONG 335 +# define SSL_R_RENEGOTIATION_ENCODING_ERR 336 +# define SSL_R_RENEGOTIATION_MISMATCH 337 +# define SSL_R_REQUEST_PENDING 285 +# define SSL_R_REQUEST_SENT 286 +# define SSL_R_REQUIRED_CIPHER_MISSING 215 +# define SSL_R_REQUIRED_COMPRESSION_ALGORITHM_MISSING 342 +# define SSL_R_SCSV_RECEIVED_WHEN_RENEGOTIATING 345 +# define SSL_R_SCT_VERIFICATION_FAILED 208 +# define SSL_R_SERVERHELLO_TLSEXT 275 +# define SSL_R_SESSION_ID_CONTEXT_UNINITIALIZED 277 +# define SSL_R_SHUTDOWN_WHILE_IN_INIT 407 +# define SSL_R_SIGNATURE_ALGORITHMS_ERROR 360 +# define SSL_R_SIGNATURE_FOR_NON_SIGNING_CERTIFICATE 220 +# define SSL_R_SRP_A_CALC 361 +# define SSL_R_SRTP_COULD_NOT_ALLOCATE_PROFILES 362 +# define SSL_R_SRTP_PROTECTION_PROFILE_LIST_TOO_LONG 363 +# define SSL_R_SRTP_UNKNOWN_PROTECTION_PROFILE 364 +# define SSL_R_SSL3_EXT_INVALID_MAX_FRAGMENT_LENGTH 232 +# define SSL_R_SSL3_EXT_INVALID_SERVERNAME 319 +# define SSL_R_SSL3_EXT_INVALID_SERVERNAME_TYPE 320 +# define SSL_R_SSL3_SESSION_ID_TOO_LONG 300 +# define SSL_R_SSLV3_ALERT_BAD_CERTIFICATE 1042 +# define SSL_R_SSLV3_ALERT_BAD_RECORD_MAC 1020 +# define SSL_R_SSLV3_ALERT_CERTIFICATE_EXPIRED 1045 +# define SSL_R_SSLV3_ALERT_CERTIFICATE_REVOKED 1044 +# define SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN 1046 +# define SSL_R_SSLV3_ALERT_DECOMPRESSION_FAILURE 1030 +# define SSL_R_SSLV3_ALERT_HANDSHAKE_FAILURE 1040 +# define SSL_R_SSLV3_ALERT_ILLEGAL_PARAMETER 1047 +# define SSL_R_SSLV3_ALERT_NO_CERTIFICATE 1041 +# define SSL_R_SSLV3_ALERT_UNEXPECTED_MESSAGE 1010 +# define SSL_R_SSLV3_ALERT_UNSUPPORTED_CERTIFICATE 1043 +# define SSL_R_SSL_COMMAND_SECTION_EMPTY 117 +# define SSL_R_SSL_COMMAND_SECTION_NOT_FOUND 125 +# define SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION 228 +# define SSL_R_SSL_HANDSHAKE_FAILURE 229 +# define SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS 230 +# define SSL_R_SSL_NEGATIVE_LENGTH 372 +# define SSL_R_SSL_SECTION_EMPTY 126 +# define SSL_R_SSL_SECTION_NOT_FOUND 136 +# define SSL_R_SSL_SESSION_ID_CALLBACK_FAILED 301 +# define SSL_R_SSL_SESSION_ID_CONFLICT 302 +# define SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG 273 +# define SSL_R_SSL_SESSION_ID_HAS_BAD_LENGTH 303 +# define SSL_R_SSL_SESSION_ID_TOO_LONG 408 +# define SSL_R_SSL_SESSION_VERSION_MISMATCH 210 +# define SSL_R_STILL_IN_INIT 121 +# define SSL_R_TLSV13_ALERT_CERTIFICATE_REQUIRED 1116 +# define SSL_R_TLSV13_ALERT_MISSING_EXTENSION 1109 +# define SSL_R_TLSV1_ALERT_ACCESS_DENIED 1049 +# define SSL_R_TLSV1_ALERT_DECODE_ERROR 1050 +# define SSL_R_TLSV1_ALERT_DECRYPTION_FAILED 1021 +# define SSL_R_TLSV1_ALERT_DECRYPT_ERROR 1051 +# define SSL_R_TLSV1_ALERT_EXPORT_RESTRICTION 1060 +# define SSL_R_TLSV1_ALERT_INAPPROPRIATE_FALLBACK 1086 +# define SSL_R_TLSV1_ALERT_INSUFFICIENT_SECURITY 1071 +# define SSL_R_TLSV1_ALERT_INTERNAL_ERROR 1080 +# define SSL_R_TLSV1_ALERT_NO_RENEGOTIATION 1100 +# define SSL_R_TLSV1_ALERT_PROTOCOL_VERSION 1070 +# define SSL_R_TLSV1_ALERT_RECORD_OVERFLOW 1022 +# define SSL_R_TLSV1_ALERT_UNKNOWN_CA 1048 +# define SSL_R_TLSV1_ALERT_USER_CANCELLED 1090 +# define SSL_R_TLSV1_BAD_CERTIFICATE_HASH_VALUE 1114 +# define SSL_R_TLSV1_BAD_CERTIFICATE_STATUS_RESPONSE 1113 +# define SSL_R_TLSV1_CERTIFICATE_UNOBTAINABLE 1111 +# define SSL_R_TLSV1_UNRECOGNIZED_NAME 1112 +# define SSL_R_TLSV1_UNSUPPORTED_EXTENSION 1110 +# define SSL_R_TLS_HEARTBEAT_PEER_DOESNT_ACCEPT 365 +# define SSL_R_TLS_HEARTBEAT_PENDING 366 +# define SSL_R_TLS_ILLEGAL_EXPORTER_LABEL 367 +# define SSL_R_TLS_INVALID_ECPOINTFORMAT_LIST 157 +# define SSL_R_TOO_MANY_KEY_UPDATES 132 +# define SSL_R_TOO_MANY_WARN_ALERTS 409 +# define SSL_R_TOO_MUCH_EARLY_DATA 164 +# define SSL_R_UNABLE_TO_FIND_ECDH_PARAMETERS 314 +# define SSL_R_UNABLE_TO_FIND_PUBLIC_KEY_PARAMETERS 239 +# define SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES 242 +# define SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES 243 +# define SSL_R_UNEXPECTED_CCS_MESSAGE 262 +# define SSL_R_UNEXPECTED_END_OF_EARLY_DATA 178 +# define SSL_R_UNEXPECTED_MESSAGE 244 +# define SSL_R_UNEXPECTED_RECORD 245 +# define SSL_R_UNINITIALIZED 276 +# define SSL_R_UNKNOWN_ALERT_TYPE 246 +# define SSL_R_UNKNOWN_CERTIFICATE_TYPE 247 +# define SSL_R_UNKNOWN_CIPHER_RETURNED 248 +# define SSL_R_UNKNOWN_CIPHER_TYPE 249 +# define SSL_R_UNKNOWN_CMD_NAME 386 +# define SSL_R_UNKNOWN_COMMAND 139 +# define SSL_R_UNKNOWN_DIGEST 368 +# define SSL_R_UNKNOWN_KEY_EXCHANGE_TYPE 250 +# define SSL_R_UNKNOWN_PKEY_TYPE 251 +# define SSL_R_UNKNOWN_PROTOCOL 252 +# define SSL_R_UNKNOWN_SSL_VERSION 254 +# define SSL_R_UNKNOWN_STATE 255 +# define SSL_R_UNSAFE_LEGACY_RENEGOTIATION_DISABLED 338 +# define SSL_R_UNSOLICITED_EXTENSION 217 +# define SSL_R_UNSUPPORTED_COMPRESSION_ALGORITHM 257 +# define SSL_R_UNSUPPORTED_ELLIPTIC_CURVE 315 +# define SSL_R_UNSUPPORTED_PROTOCOL 258 +# define SSL_R_UNSUPPORTED_SSL_VERSION 259 +# define SSL_R_UNSUPPORTED_STATUS_TYPE 329 +# define SSL_R_USE_SRTP_NOT_NEGOTIATED 369 +# define SSL_R_VERSION_TOO_HIGH 166 +# define SSL_R_VERSION_TOO_LOW 396 +# define SSL_R_WRONG_CERTIFICATE_TYPE 383 +# define SSL_R_WRONG_CIPHER_RETURNED 261 +# define SSL_R_WRONG_CURVE 378 +# define SSL_R_WRONG_SIGNATURE_LENGTH 264 +# define SSL_R_WRONG_SIGNATURE_SIZE 265 +# define SSL_R_WRONG_SIGNATURE_TYPE 370 +# define SSL_R_WRONG_SSL_VERSION 266 +# define SSL_R_WRONG_VERSION_NUMBER 267 +# define SSL_R_X509_LIB 268 +# define SSL_R_X509_VERIFICATION_SETUP_PROBLEMS 269 + +#endif diff --git a/include/openssl/stack.h b/include/openssl/stack.h new file mode 100644 index 0000000..cfc0750 --- /dev/null +++ b/include/openssl/stack.h @@ -0,0 +1,83 @@ +/* + * Copyright 1995-2017 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_STACK_H +# define HEADER_STACK_H + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct stack_st OPENSSL_STACK; /* Use STACK_OF(...) instead */ + +typedef int (*OPENSSL_sk_compfunc)(const void *, const void *); +typedef void (*OPENSSL_sk_freefunc)(void *); +typedef void *(*OPENSSL_sk_copyfunc)(const void *); + +int OPENSSL_sk_num(const OPENSSL_STACK *); +void *OPENSSL_sk_value(const OPENSSL_STACK *, int); + +void *OPENSSL_sk_set(OPENSSL_STACK *st, int i, const void *data); + +OPENSSL_STACK *OPENSSL_sk_new(OPENSSL_sk_compfunc cmp); +OPENSSL_STACK *OPENSSL_sk_new_null(void); +OPENSSL_STACK *OPENSSL_sk_new_reserve(OPENSSL_sk_compfunc c, int n); +int OPENSSL_sk_reserve(OPENSSL_STACK *st, int n); +void OPENSSL_sk_free(OPENSSL_STACK *); +void OPENSSL_sk_pop_free(OPENSSL_STACK *st, void (*func) (void *)); +OPENSSL_STACK *OPENSSL_sk_deep_copy(const OPENSSL_STACK *, + OPENSSL_sk_copyfunc c, + OPENSSL_sk_freefunc f); +int OPENSSL_sk_insert(OPENSSL_STACK *sk, const void *data, int where); +void *OPENSSL_sk_delete(OPENSSL_STACK *st, int loc); +void *OPENSSL_sk_delete_ptr(OPENSSL_STACK *st, const void *p); +int OPENSSL_sk_find(OPENSSL_STACK *st, const void *data); +int OPENSSL_sk_find_ex(OPENSSL_STACK *st, const void *data); +int OPENSSL_sk_push(OPENSSL_STACK *st, const void *data); +int OPENSSL_sk_unshift(OPENSSL_STACK *st, const void *data); +void *OPENSSL_sk_shift(OPENSSL_STACK *st); +void *OPENSSL_sk_pop(OPENSSL_STACK *st); +void OPENSSL_sk_zero(OPENSSL_STACK *st); +OPENSSL_sk_compfunc OPENSSL_sk_set_cmp_func(OPENSSL_STACK *sk, + OPENSSL_sk_compfunc cmp); +OPENSSL_STACK *OPENSSL_sk_dup(const OPENSSL_STACK *st); +void OPENSSL_sk_sort(OPENSSL_STACK *st); +int OPENSSL_sk_is_sorted(const OPENSSL_STACK *st); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define _STACK OPENSSL_STACK +# define sk_num OPENSSL_sk_num +# define sk_value OPENSSL_sk_value +# define sk_set OPENSSL_sk_set +# define sk_new OPENSSL_sk_new +# define sk_new_null OPENSSL_sk_new_null +# define sk_free OPENSSL_sk_free +# define sk_pop_free OPENSSL_sk_pop_free +# define sk_deep_copy OPENSSL_sk_deep_copy +# define sk_insert OPENSSL_sk_insert +# define sk_delete OPENSSL_sk_delete +# define sk_delete_ptr OPENSSL_sk_delete_ptr +# define sk_find OPENSSL_sk_find +# define sk_find_ex OPENSSL_sk_find_ex +# define sk_push OPENSSL_sk_push +# define sk_unshift OPENSSL_sk_unshift +# define sk_shift OPENSSL_sk_shift +# define sk_pop OPENSSL_sk_pop +# define sk_zero OPENSSL_sk_zero +# define sk_set_cmp_func OPENSSL_sk_set_cmp_func +# define sk_dup OPENSSL_sk_dup +# define sk_sort OPENSSL_sk_sort +# define sk_is_sorted OPENSSL_sk_is_sorted +# endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/store.h b/include/openssl/store.h new file mode 100644 index 0000000..9f07db9 --- /dev/null +++ b/include/openssl/store.h @@ -0,0 +1,266 @@ +/* + * Copyright 2016-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OSSL_STORE_H +# define HEADER_OSSL_STORE_H + +# include +# include +# include +# include + +# ifdef __cplusplus +extern "C" { +# endif + +/*- + * The main OSSL_STORE functions. + * ------------------------------ + * + * These allow applications to open a channel to a resource with supported + * data (keys, certs, crls, ...), read the data a piece at a time and decide + * what to do with it, and finally close. + */ + +typedef struct ossl_store_ctx_st OSSL_STORE_CTX; + +/* + * Typedef for the OSSL_STORE_INFO post processing callback. This can be used + * to massage the given OSSL_STORE_INFO, or to drop it entirely (by returning + * NULL). + */ +typedef OSSL_STORE_INFO *(*OSSL_STORE_post_process_info_fn)(OSSL_STORE_INFO *, + void *); + +/* + * Open a channel given a URI. The given UI method will be used any time the + * loader needs extra input, for example when a password or pin is needed, and + * will be passed the same user data every time it's needed in this context. + * + * Returns a context reference which represents the channel to communicate + * through. + */ +OSSL_STORE_CTX *OSSL_STORE_open(const char *uri, const UI_METHOD *ui_method, + void *ui_data, + OSSL_STORE_post_process_info_fn post_process, + void *post_process_data); + +/* + * Control / fine tune the OSSL_STORE channel. |cmd| determines what is to be + * done, and depends on the underlying loader (use OSSL_STORE_get0_scheme to + * determine which loader is used), except for common commands (see below). + * Each command takes different arguments. + */ +int OSSL_STORE_ctrl(OSSL_STORE_CTX *ctx, int cmd, ... /* args */); +int OSSL_STORE_vctrl(OSSL_STORE_CTX *ctx, int cmd, va_list args); + +/* + * Common ctrl commands that different loaders may choose to support. + */ +/* int on = 0 or 1; STORE_ctrl(ctx, STORE_C_USE_SECMEM, &on); */ +# define OSSL_STORE_C_USE_SECMEM 1 +/* Where custom commands start */ +# define OSSL_STORE_C_CUSTOM_START 100 + +/* + * Read one data item (a key, a cert, a CRL) that is supported by the OSSL_STORE + * functionality, given a context. + * Returns a OSSL_STORE_INFO pointer, from which OpenSSL typed data can be + * extracted with OSSL_STORE_INFO_get0_PKEY(), OSSL_STORE_INFO_get0_CERT(), ... + * NULL is returned on error, which may include that the data found at the URI + * can't be figured out for certain or is ambiguous. + */ +OSSL_STORE_INFO *OSSL_STORE_load(OSSL_STORE_CTX *ctx); + +/* + * Check if end of data (end of file) is reached + * Returns 1 on end, 0 otherwise. + */ +int OSSL_STORE_eof(OSSL_STORE_CTX *ctx); + +/* + * Check if an error occured + * Returns 1 if it did, 0 otherwise. + */ +int OSSL_STORE_error(OSSL_STORE_CTX *ctx); + +/* + * Close the channel + * Returns 1 on success, 0 on error. + */ +int OSSL_STORE_close(OSSL_STORE_CTX *ctx); + + +/*- + * Extracting OpenSSL types from and creating new OSSL_STORE_INFOs + * --------------------------------------------------------------- + */ + +/* + * Types of data that can be ossl_stored in a OSSL_STORE_INFO. + * OSSL_STORE_INFO_NAME is typically found when getting a listing of + * available "files" / "tokens" / what have you. + */ +# define OSSL_STORE_INFO_NAME 1 /* char * */ +# define OSSL_STORE_INFO_PARAMS 2 /* EVP_PKEY * */ +# define OSSL_STORE_INFO_PKEY 3 /* EVP_PKEY * */ +# define OSSL_STORE_INFO_CERT 4 /* X509 * */ +# define OSSL_STORE_INFO_CRL 5 /* X509_CRL * */ + +/* + * Functions to generate OSSL_STORE_INFOs, one function for each type we + * support having in them, as well as a generic constructor. + * + * In all cases, ownership of the object is transfered to the OSSL_STORE_INFO + * and will therefore be freed when the OSSL_STORE_INFO is freed. + */ +OSSL_STORE_INFO *OSSL_STORE_INFO_new_NAME(char *name); +int OSSL_STORE_INFO_set0_NAME_description(OSSL_STORE_INFO *info, char *desc); +OSSL_STORE_INFO *OSSL_STORE_INFO_new_PARAMS(EVP_PKEY *params); +OSSL_STORE_INFO *OSSL_STORE_INFO_new_PKEY(EVP_PKEY *pkey); +OSSL_STORE_INFO *OSSL_STORE_INFO_new_CERT(X509 *x509); +OSSL_STORE_INFO *OSSL_STORE_INFO_new_CRL(X509_CRL *crl); + +/* + * Functions to try to extract data from a OSSL_STORE_INFO. + */ +int OSSL_STORE_INFO_get_type(const OSSL_STORE_INFO *info); +const char *OSSL_STORE_INFO_get0_NAME(const OSSL_STORE_INFO *info); +char *OSSL_STORE_INFO_get1_NAME(const OSSL_STORE_INFO *info); +const char *OSSL_STORE_INFO_get0_NAME_description(const OSSL_STORE_INFO *info); +char *OSSL_STORE_INFO_get1_NAME_description(const OSSL_STORE_INFO *info); +EVP_PKEY *OSSL_STORE_INFO_get0_PARAMS(const OSSL_STORE_INFO *info); +EVP_PKEY *OSSL_STORE_INFO_get1_PARAMS(const OSSL_STORE_INFO *info); +EVP_PKEY *OSSL_STORE_INFO_get0_PKEY(const OSSL_STORE_INFO *info); +EVP_PKEY *OSSL_STORE_INFO_get1_PKEY(const OSSL_STORE_INFO *info); +X509 *OSSL_STORE_INFO_get0_CERT(const OSSL_STORE_INFO *info); +X509 *OSSL_STORE_INFO_get1_CERT(const OSSL_STORE_INFO *info); +X509_CRL *OSSL_STORE_INFO_get0_CRL(const OSSL_STORE_INFO *info); +X509_CRL *OSSL_STORE_INFO_get1_CRL(const OSSL_STORE_INFO *info); + +const char *OSSL_STORE_INFO_type_string(int type); + +/* + * Free the OSSL_STORE_INFO + */ +void OSSL_STORE_INFO_free(OSSL_STORE_INFO *info); + + +/*- + * Functions to construct a search URI from a base URI and search criteria + * ----------------------------------------------------------------------- + */ + +/* OSSL_STORE search types */ +# define OSSL_STORE_SEARCH_BY_NAME 1 /* subject in certs, issuer in CRLs */ +# define OSSL_STORE_SEARCH_BY_ISSUER_SERIAL 2 +# define OSSL_STORE_SEARCH_BY_KEY_FINGERPRINT 3 +# define OSSL_STORE_SEARCH_BY_ALIAS 4 + +/* To check what search types the scheme handler supports */ +int OSSL_STORE_supports_search(OSSL_STORE_CTX *ctx, int search_type); + +/* Search term constructors */ +/* + * The input is considered to be owned by the caller, and must therefore + * remain present throughout the lifetime of the returned OSSL_STORE_SEARCH + */ +OSSL_STORE_SEARCH *OSSL_STORE_SEARCH_by_name(X509_NAME *name); +OSSL_STORE_SEARCH *OSSL_STORE_SEARCH_by_issuer_serial(X509_NAME *name, + const ASN1_INTEGER + *serial); +OSSL_STORE_SEARCH *OSSL_STORE_SEARCH_by_key_fingerprint(const EVP_MD *digest, + const unsigned char + *bytes, size_t len); +OSSL_STORE_SEARCH *OSSL_STORE_SEARCH_by_alias(const char *alias); + +/* Search term destructor */ +void OSSL_STORE_SEARCH_free(OSSL_STORE_SEARCH *search); + +/* Search term accessors */ +int OSSL_STORE_SEARCH_get_type(const OSSL_STORE_SEARCH *criterion); +X509_NAME *OSSL_STORE_SEARCH_get0_name(OSSL_STORE_SEARCH *criterion); +const ASN1_INTEGER *OSSL_STORE_SEARCH_get0_serial(const OSSL_STORE_SEARCH + *criterion); +const unsigned char *OSSL_STORE_SEARCH_get0_bytes(const OSSL_STORE_SEARCH + *criterion, size_t *length); +const char *OSSL_STORE_SEARCH_get0_string(const OSSL_STORE_SEARCH *criterion); +const EVP_MD *OSSL_STORE_SEARCH_get0_digest(const OSSL_STORE_SEARCH *criterion); + +/* + * Add search criterion and expected return type (which can be unspecified) + * to the loading channel. This MUST happen before the first OSSL_STORE_load(). + */ +int OSSL_STORE_expect(OSSL_STORE_CTX *ctx, int expected_type); +int OSSL_STORE_find(OSSL_STORE_CTX *ctx, OSSL_STORE_SEARCH *search); + + +/*- + * Function to register a loader for the given URI scheme. + * ------------------------------------------------------- + * + * The loader receives all the main components of an URI except for the + * scheme. + */ + +typedef struct ossl_store_loader_st OSSL_STORE_LOADER; +OSSL_STORE_LOADER *OSSL_STORE_LOADER_new(ENGINE *e, const char *scheme); +const ENGINE *OSSL_STORE_LOADER_get0_engine(const OSSL_STORE_LOADER *loader); +const char *OSSL_STORE_LOADER_get0_scheme(const OSSL_STORE_LOADER *loader); +/* struct ossl_store_loader_ctx_st is defined differently by each loader */ +typedef struct ossl_store_loader_ctx_st OSSL_STORE_LOADER_CTX; +typedef OSSL_STORE_LOADER_CTX *(*OSSL_STORE_open_fn)(const OSSL_STORE_LOADER + *loader, + const char *uri, + const UI_METHOD *ui_method, + void *ui_data); +int OSSL_STORE_LOADER_set_open(OSSL_STORE_LOADER *loader, + OSSL_STORE_open_fn open_function); +typedef int (*OSSL_STORE_ctrl_fn)(OSSL_STORE_LOADER_CTX *ctx, int cmd, + va_list args); +int OSSL_STORE_LOADER_set_ctrl(OSSL_STORE_LOADER *loader, + OSSL_STORE_ctrl_fn ctrl_function); +typedef int (*OSSL_STORE_expect_fn)(OSSL_STORE_LOADER_CTX *ctx, int expected); +int OSSL_STORE_LOADER_set_expect(OSSL_STORE_LOADER *loader, + OSSL_STORE_expect_fn expect_function); +typedef int (*OSSL_STORE_find_fn)(OSSL_STORE_LOADER_CTX *ctx, + OSSL_STORE_SEARCH *criteria); +int OSSL_STORE_LOADER_set_find(OSSL_STORE_LOADER *loader, + OSSL_STORE_find_fn find_function); +typedef OSSL_STORE_INFO *(*OSSL_STORE_load_fn)(OSSL_STORE_LOADER_CTX *ctx, + const UI_METHOD *ui_method, + void *ui_data); +int OSSL_STORE_LOADER_set_load(OSSL_STORE_LOADER *loader, + OSSL_STORE_load_fn load_function); +typedef int (*OSSL_STORE_eof_fn)(OSSL_STORE_LOADER_CTX *ctx); +int OSSL_STORE_LOADER_set_eof(OSSL_STORE_LOADER *loader, + OSSL_STORE_eof_fn eof_function); +typedef int (*OSSL_STORE_error_fn)(OSSL_STORE_LOADER_CTX *ctx); +int OSSL_STORE_LOADER_set_error(OSSL_STORE_LOADER *loader, + OSSL_STORE_error_fn error_function); +typedef int (*OSSL_STORE_close_fn)(OSSL_STORE_LOADER_CTX *ctx); +int OSSL_STORE_LOADER_set_close(OSSL_STORE_LOADER *loader, + OSSL_STORE_close_fn close_function); +void OSSL_STORE_LOADER_free(OSSL_STORE_LOADER *loader); + +int OSSL_STORE_register_loader(OSSL_STORE_LOADER *loader); +OSSL_STORE_LOADER *OSSL_STORE_unregister_loader(const char *scheme); + +/*- + * Functions to list STORE loaders + * ------------------------------- + */ +int OSSL_STORE_do_all_loaders(void (*do_function) (const OSSL_STORE_LOADER + *loader, void *do_arg), + void *do_arg); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/storeerr.h b/include/openssl/storeerr.h new file mode 100644 index 0000000..33d0ab7 --- /dev/null +++ b/include/openssl/storeerr.h @@ -0,0 +1,87 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_OSSL_STOREERR_H +# define HEADER_OSSL_STOREERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_OSSL_STORE_strings(void); + +/* + * OSSL_STORE function codes. + */ +# define OSSL_STORE_F_FILE_CTRL 129 +# define OSSL_STORE_F_FILE_FIND 138 +# define OSSL_STORE_F_FILE_GET_PASS 118 +# define OSSL_STORE_F_FILE_LOAD 119 +# define OSSL_STORE_F_FILE_LOAD_TRY_DECODE 124 +# define OSSL_STORE_F_FILE_NAME_TO_URI 126 +# define OSSL_STORE_F_FILE_OPEN 120 +# define OSSL_STORE_F_OSSL_STORE_ATTACH_PEM_BIO 127 +# define OSSL_STORE_F_OSSL_STORE_EXPECT 130 +# define OSSL_STORE_F_OSSL_STORE_FILE_ATTACH_PEM_BIO_INT 128 +# define OSSL_STORE_F_OSSL_STORE_FIND 131 +# define OSSL_STORE_F_OSSL_STORE_GET0_LOADER_INT 100 +# define OSSL_STORE_F_OSSL_STORE_INFO_GET1_CERT 101 +# define OSSL_STORE_F_OSSL_STORE_INFO_GET1_CRL 102 +# define OSSL_STORE_F_OSSL_STORE_INFO_GET1_NAME 103 +# define OSSL_STORE_F_OSSL_STORE_INFO_GET1_NAME_DESCRIPTION 135 +# define OSSL_STORE_F_OSSL_STORE_INFO_GET1_PARAMS 104 +# define OSSL_STORE_F_OSSL_STORE_INFO_GET1_PKEY 105 +# define OSSL_STORE_F_OSSL_STORE_INFO_NEW_CERT 106 +# define OSSL_STORE_F_OSSL_STORE_INFO_NEW_CRL 107 +# define OSSL_STORE_F_OSSL_STORE_INFO_NEW_EMBEDDED 123 +# define OSSL_STORE_F_OSSL_STORE_INFO_NEW_NAME 109 +# define OSSL_STORE_F_OSSL_STORE_INFO_NEW_PARAMS 110 +# define OSSL_STORE_F_OSSL_STORE_INFO_NEW_PKEY 111 +# define OSSL_STORE_F_OSSL_STORE_INFO_SET0_NAME_DESCRIPTION 134 +# define OSSL_STORE_F_OSSL_STORE_INIT_ONCE 112 +# define OSSL_STORE_F_OSSL_STORE_LOADER_NEW 113 +# define OSSL_STORE_F_OSSL_STORE_OPEN 114 +# define OSSL_STORE_F_OSSL_STORE_OPEN_INT 115 +# define OSSL_STORE_F_OSSL_STORE_REGISTER_LOADER_INT 117 +# define OSSL_STORE_F_OSSL_STORE_SEARCH_BY_ALIAS 132 +# define OSSL_STORE_F_OSSL_STORE_SEARCH_BY_ISSUER_SERIAL 133 +# define OSSL_STORE_F_OSSL_STORE_SEARCH_BY_KEY_FINGERPRINT 136 +# define OSSL_STORE_F_OSSL_STORE_SEARCH_BY_NAME 137 +# define OSSL_STORE_F_OSSL_STORE_UNREGISTER_LOADER_INT 116 +# define OSSL_STORE_F_TRY_DECODE_PARAMS 121 +# define OSSL_STORE_F_TRY_DECODE_PKCS12 122 +# define OSSL_STORE_F_TRY_DECODE_PKCS8ENCRYPTED 125 + +/* + * OSSL_STORE reason codes. + */ +# define OSSL_STORE_R_AMBIGUOUS_CONTENT_TYPE 107 +# define OSSL_STORE_R_BAD_PASSWORD_READ 115 +# define OSSL_STORE_R_ERROR_VERIFYING_PKCS12_MAC 113 +# define OSSL_STORE_R_FINGERPRINT_SIZE_DOES_NOT_MATCH_DIGEST 121 +# define OSSL_STORE_R_INVALID_SCHEME 106 +# define OSSL_STORE_R_IS_NOT_A 112 +# define OSSL_STORE_R_LOADER_INCOMPLETE 116 +# define OSSL_STORE_R_LOADING_STARTED 117 +# define OSSL_STORE_R_NOT_A_CERTIFICATE 100 +# define OSSL_STORE_R_NOT_A_CRL 101 +# define OSSL_STORE_R_NOT_A_KEY 102 +# define OSSL_STORE_R_NOT_A_NAME 103 +# define OSSL_STORE_R_NOT_PARAMETERS 104 +# define OSSL_STORE_R_PASSPHRASE_CALLBACK_ERROR 114 +# define OSSL_STORE_R_PATH_MUST_BE_ABSOLUTE 108 +# define OSSL_STORE_R_SEARCH_ONLY_SUPPORTED_FOR_DIRECTORIES 119 +# define OSSL_STORE_R_UI_PROCESS_INTERRUPTED_OR_CANCELLED 109 +# define OSSL_STORE_R_UNREGISTERED_SCHEME 105 +# define OSSL_STORE_R_UNSUPPORTED_CONTENT_TYPE 110 +# define OSSL_STORE_R_UNSUPPORTED_OPERATION 118 +# define OSSL_STORE_R_UNSUPPORTED_SEARCH_TYPE 120 +# define OSSL_STORE_R_URI_AUTHORITY_UNSUPPORTED 111 + +#endif diff --git a/include/openssl/symhacks.h b/include/openssl/symhacks.h new file mode 100644 index 0000000..57fedc4 --- /dev/null +++ b/include/openssl/symhacks.h @@ -0,0 +1,52 @@ +/* + * Copyright 1999-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_SYMHACKS_H +# define HEADER_SYMHACKS_H + +# include + +/* Case insensitive linking causes problems.... */ +# if defined(OPENSSL_SYS_VMS) +# undef ERR_load_CRYPTO_strings +# define ERR_load_CRYPTO_strings ERR_load_CRYPTOlib_strings +# undef OCSP_crlID_new +# define OCSP_crlID_new OCSP_crlID2_new + +# undef d2i_ECPARAMETERS +# define d2i_ECPARAMETERS d2i_UC_ECPARAMETERS +# undef i2d_ECPARAMETERS +# define i2d_ECPARAMETERS i2d_UC_ECPARAMETERS +# undef d2i_ECPKPARAMETERS +# define d2i_ECPKPARAMETERS d2i_UC_ECPKPARAMETERS +# undef i2d_ECPKPARAMETERS +# define i2d_ECPKPARAMETERS i2d_UC_ECPKPARAMETERS + +/* + * These functions do not seem to exist! However, I'm paranoid... Original + * command in x509v3.h: These functions are being redefined in another + * directory, and clash when the linker is case-insensitive, so let's hide + * them a little, by giving them an extra 'o' at the beginning of the name... + */ +# undef X509v3_cleanup_extensions +# define X509v3_cleanup_extensions oX509v3_cleanup_extensions +# undef X509v3_add_extension +# define X509v3_add_extension oX509v3_add_extension +# undef X509v3_add_netscape_extensions +# define X509v3_add_netscape_extensions oX509v3_add_netscape_extensions +# undef X509v3_add_standard_extensions +# define X509v3_add_standard_extensions oX509v3_add_standard_extensions + +/* This one clashes with CMS_data_create */ +# undef cms_Data_create +# define cms_Data_create priv_cms_Data_create + +# endif + +#endif /* ! defined HEADER_VMS_IDHACKS_H */ diff --git a/include/openssl/tls1.h b/include/openssl/tls1.h new file mode 100644 index 0000000..8f5da0c --- /dev/null +++ b/include/openssl/tls1.h @@ -0,0 +1,1236 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * Copyright 2005 Nokia. All rights reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_TLS1_H +# define HEADER_TLS1_H + +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* Default security level if not overridden at config time */ +# ifndef OPENSSL_TLS_SECURITY_LEVEL +# define OPENSSL_TLS_SECURITY_LEVEL 1 +# endif + +# define TLS1_VERSION 0x0301 +# define TLS1_1_VERSION 0x0302 +# define TLS1_2_VERSION 0x0303 +# define TLS1_3_VERSION 0x0304 +# define TLS_MAX_VERSION TLS1_3_VERSION + +/* Special value for method supporting multiple versions */ +# define TLS_ANY_VERSION 0x10000 + +# define TLS1_VERSION_MAJOR 0x03 +# define TLS1_VERSION_MINOR 0x01 + +# define TLS1_1_VERSION_MAJOR 0x03 +# define TLS1_1_VERSION_MINOR 0x02 + +# define TLS1_2_VERSION_MAJOR 0x03 +# define TLS1_2_VERSION_MINOR 0x03 + +# define TLS1_get_version(s) \ + ((SSL_version(s) >> 8) == TLS1_VERSION_MAJOR ? SSL_version(s) : 0) + +# define TLS1_get_client_version(s) \ + ((SSL_client_version(s) >> 8) == TLS1_VERSION_MAJOR ? SSL_client_version(s) : 0) + +# define TLS1_AD_DECRYPTION_FAILED 21 +# define TLS1_AD_RECORD_OVERFLOW 22 +# define TLS1_AD_UNKNOWN_CA 48/* fatal */ +# define TLS1_AD_ACCESS_DENIED 49/* fatal */ +# define TLS1_AD_DECODE_ERROR 50/* fatal */ +# define TLS1_AD_DECRYPT_ERROR 51 +# define TLS1_AD_EXPORT_RESTRICTION 60/* fatal */ +# define TLS1_AD_PROTOCOL_VERSION 70/* fatal */ +# define TLS1_AD_INSUFFICIENT_SECURITY 71/* fatal */ +# define TLS1_AD_INTERNAL_ERROR 80/* fatal */ +# define TLS1_AD_INAPPROPRIATE_FALLBACK 86/* fatal */ +# define TLS1_AD_USER_CANCELLED 90 +# define TLS1_AD_NO_RENEGOTIATION 100 +/* TLSv1.3 alerts */ +# define TLS13_AD_MISSING_EXTENSION 109 /* fatal */ +# define TLS13_AD_CERTIFICATE_REQUIRED 116 /* fatal */ +/* codes 110-114 are from RFC3546 */ +# define TLS1_AD_UNSUPPORTED_EXTENSION 110 +# define TLS1_AD_CERTIFICATE_UNOBTAINABLE 111 +# define TLS1_AD_UNRECOGNIZED_NAME 112 +# define TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE 113 +# define TLS1_AD_BAD_CERTIFICATE_HASH_VALUE 114 +# define TLS1_AD_UNKNOWN_PSK_IDENTITY 115/* fatal */ +# define TLS1_AD_NO_APPLICATION_PROTOCOL 120 /* fatal */ + +/* ExtensionType values from RFC3546 / RFC4366 / RFC6066 */ +# define TLSEXT_TYPE_server_name 0 +# define TLSEXT_TYPE_max_fragment_length 1 +# define TLSEXT_TYPE_client_certificate_url 2 +# define TLSEXT_TYPE_trusted_ca_keys 3 +# define TLSEXT_TYPE_truncated_hmac 4 +# define TLSEXT_TYPE_status_request 5 +/* ExtensionType values from RFC4681 */ +# define TLSEXT_TYPE_user_mapping 6 +/* ExtensionType values from RFC5878 */ +# define TLSEXT_TYPE_client_authz 7 +# define TLSEXT_TYPE_server_authz 8 +/* ExtensionType values from RFC6091 */ +# define TLSEXT_TYPE_cert_type 9 + +/* ExtensionType values from RFC4492 */ +/* + * Prior to TLSv1.3 the supported_groups extension was known as + * elliptic_curves + */ +# define TLSEXT_TYPE_supported_groups 10 +# define TLSEXT_TYPE_elliptic_curves TLSEXT_TYPE_supported_groups +# define TLSEXT_TYPE_ec_point_formats 11 + + +/* ExtensionType value from RFC5054 */ +# define TLSEXT_TYPE_srp 12 + +/* ExtensionType values from RFC5246 */ +# define TLSEXT_TYPE_signature_algorithms 13 + +/* ExtensionType value from RFC5764 */ +# define TLSEXT_TYPE_use_srtp 14 + +/* ExtensionType value from RFC5620 */ +# define TLSEXT_TYPE_heartbeat 15 + +/* ExtensionType value from RFC7301 */ +# define TLSEXT_TYPE_application_layer_protocol_negotiation 16 + +/* + * Extension type for Certificate Transparency + * https://tools.ietf.org/html/rfc6962#section-3.3.1 + */ +# define TLSEXT_TYPE_signed_certificate_timestamp 18 + +/* + * ExtensionType value for TLS padding extension. + * http://tools.ietf.org/html/draft-agl-tls-padding + */ +# define TLSEXT_TYPE_padding 21 + +/* ExtensionType value from RFC7366 */ +# define TLSEXT_TYPE_encrypt_then_mac 22 + +/* ExtensionType value from RFC7627 */ +# define TLSEXT_TYPE_extended_master_secret 23 + +/* ExtensionType value from RFC4507 */ +# define TLSEXT_TYPE_session_ticket 35 + +/* As defined for TLS1.3 */ +# define TLSEXT_TYPE_psk 41 +# define TLSEXT_TYPE_early_data 42 +# define TLSEXT_TYPE_supported_versions 43 +# define TLSEXT_TYPE_cookie 44 +# define TLSEXT_TYPE_psk_kex_modes 45 +# define TLSEXT_TYPE_certificate_authorities 47 +# define TLSEXT_TYPE_post_handshake_auth 49 +# define TLSEXT_TYPE_signature_algorithms_cert 50 +# define TLSEXT_TYPE_key_share 51 + +/* Temporary extension type */ +# define TLSEXT_TYPE_renegotiate 0xff01 + +# ifndef OPENSSL_NO_NEXTPROTONEG +/* This is not an IANA defined extension number */ +# define TLSEXT_TYPE_next_proto_neg 13172 +# endif + +/* NameType value from RFC3546 */ +# define TLSEXT_NAMETYPE_host_name 0 +/* status request value from RFC3546 */ +# define TLSEXT_STATUSTYPE_ocsp 1 + +/* ECPointFormat values from RFC4492 */ +# define TLSEXT_ECPOINTFORMAT_first 0 +# define TLSEXT_ECPOINTFORMAT_uncompressed 0 +# define TLSEXT_ECPOINTFORMAT_ansiX962_compressed_prime 1 +# define TLSEXT_ECPOINTFORMAT_ansiX962_compressed_char2 2 +# define TLSEXT_ECPOINTFORMAT_last 2 + +/* Signature and hash algorithms from RFC5246 */ +# define TLSEXT_signature_anonymous 0 +# define TLSEXT_signature_rsa 1 +# define TLSEXT_signature_dsa 2 +# define TLSEXT_signature_ecdsa 3 +# define TLSEXT_signature_gostr34102001 237 +# define TLSEXT_signature_gostr34102012_256 238 +# define TLSEXT_signature_gostr34102012_512 239 + +/* Total number of different signature algorithms */ +# define TLSEXT_signature_num 7 + +# define TLSEXT_hash_none 0 +# define TLSEXT_hash_md5 1 +# define TLSEXT_hash_sha1 2 +# define TLSEXT_hash_sha224 3 +# define TLSEXT_hash_sha256 4 +# define TLSEXT_hash_sha384 5 +# define TLSEXT_hash_sha512 6 +# define TLSEXT_hash_gostr3411 237 +# define TLSEXT_hash_gostr34112012_256 238 +# define TLSEXT_hash_gostr34112012_512 239 + +/* Total number of different digest algorithms */ + +# define TLSEXT_hash_num 10 + +/* Flag set for unrecognised algorithms */ +# define TLSEXT_nid_unknown 0x1000000 + +/* ECC curves */ + +# define TLSEXT_curve_P_256 23 +# define TLSEXT_curve_P_384 24 + +/* OpenSSL value to disable maximum fragment length extension */ +# define TLSEXT_max_fragment_length_DISABLED 0 +/* Allowed values for max fragment length extension */ +# define TLSEXT_max_fragment_length_512 1 +# define TLSEXT_max_fragment_length_1024 2 +# define TLSEXT_max_fragment_length_2048 3 +# define TLSEXT_max_fragment_length_4096 4 + +int SSL_CTX_set_tlsext_max_fragment_length(SSL_CTX *ctx, uint8_t mode); +int SSL_set_tlsext_max_fragment_length(SSL *ssl, uint8_t mode); + +# define TLSEXT_MAXLEN_host_name 255 + +__owur const char *SSL_get_servername(const SSL *s, const int type); +__owur int SSL_get_servername_type(const SSL *s); +/* + * SSL_export_keying_material exports a value derived from the master secret, + * as specified in RFC 5705. It writes |olen| bytes to |out| given a label and + * optional context. (Since a zero length context is allowed, the |use_context| + * flag controls whether a context is included.) It returns 1 on success and + * 0 or -1 otherwise. + */ +__owur int SSL_export_keying_material(SSL *s, unsigned char *out, size_t olen, + const char *label, size_t llen, + const unsigned char *context, + size_t contextlen, int use_context); + +/* + * SSL_export_keying_material_early exports a value derived from the + * early exporter master secret, as specified in + * https://tools.ietf.org/html/draft-ietf-tls-tls13-23. It writes + * |olen| bytes to |out| given a label and optional context. It + * returns 1 on success and 0 otherwise. + */ +__owur int SSL_export_keying_material_early(SSL *s, unsigned char *out, + size_t olen, const char *label, + size_t llen, + const unsigned char *context, + size_t contextlen); + +int SSL_get_peer_signature_type_nid(const SSL *s, int *pnid); + +int SSL_get_sigalgs(SSL *s, int idx, + int *psign, int *phash, int *psignandhash, + unsigned char *rsig, unsigned char *rhash); + +int SSL_get_shared_sigalgs(SSL *s, int idx, + int *psign, int *phash, int *psignandhash, + unsigned char *rsig, unsigned char *rhash); + +__owur int SSL_check_chain(SSL *s, X509 *x, EVP_PKEY *pk, STACK_OF(X509) *chain); + +# define SSL_set_tlsext_host_name(s,name) \ + SSL_ctrl(s,SSL_CTRL_SET_TLSEXT_HOSTNAME,TLSEXT_NAMETYPE_host_name,\ + (void *)name) + +# define SSL_set_tlsext_debug_callback(ssl, cb) \ + SSL_callback_ctrl(ssl,SSL_CTRL_SET_TLSEXT_DEBUG_CB,\ + (void (*)(void))cb) + +# define SSL_set_tlsext_debug_arg(ssl, arg) \ + SSL_ctrl(ssl,SSL_CTRL_SET_TLSEXT_DEBUG_ARG,0,arg) + +# define SSL_get_tlsext_status_type(ssl) \ + SSL_ctrl(ssl,SSL_CTRL_GET_TLSEXT_STATUS_REQ_TYPE,0,NULL) + +# define SSL_set_tlsext_status_type(ssl, type) \ + SSL_ctrl(ssl,SSL_CTRL_SET_TLSEXT_STATUS_REQ_TYPE,type,NULL) + +# define SSL_get_tlsext_status_exts(ssl, arg) \ + SSL_ctrl(ssl,SSL_CTRL_GET_TLSEXT_STATUS_REQ_EXTS,0,arg) + +# define SSL_set_tlsext_status_exts(ssl, arg) \ + SSL_ctrl(ssl,SSL_CTRL_SET_TLSEXT_STATUS_REQ_EXTS,0,arg) + +# define SSL_get_tlsext_status_ids(ssl, arg) \ + SSL_ctrl(ssl,SSL_CTRL_GET_TLSEXT_STATUS_REQ_IDS,0,arg) + +# define SSL_set_tlsext_status_ids(ssl, arg) \ + SSL_ctrl(ssl,SSL_CTRL_SET_TLSEXT_STATUS_REQ_IDS,0,arg) + +# define SSL_get_tlsext_status_ocsp_resp(ssl, arg) \ + SSL_ctrl(ssl,SSL_CTRL_GET_TLSEXT_STATUS_REQ_OCSP_RESP,0,arg) + +# define SSL_set_tlsext_status_ocsp_resp(ssl, arg, arglen) \ + SSL_ctrl(ssl,SSL_CTRL_SET_TLSEXT_STATUS_REQ_OCSP_RESP,arglen,arg) + +# define SSL_CTX_set_tlsext_servername_callback(ctx, cb) \ + SSL_CTX_callback_ctrl(ctx,SSL_CTRL_SET_TLSEXT_SERVERNAME_CB,\ + (void (*)(void))cb) + +# define SSL_TLSEXT_ERR_OK 0 +# define SSL_TLSEXT_ERR_ALERT_WARNING 1 +# define SSL_TLSEXT_ERR_ALERT_FATAL 2 +# define SSL_TLSEXT_ERR_NOACK 3 + +# define SSL_CTX_set_tlsext_servername_arg(ctx, arg) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TLSEXT_SERVERNAME_ARG,0,arg) + +# define SSL_CTX_get_tlsext_ticket_keys(ctx, keys, keylen) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_GET_TLSEXT_TICKET_KEYS,keylen,keys) +# define SSL_CTX_set_tlsext_ticket_keys(ctx, keys, keylen) \ + SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TLSEXT_TICKET_KEYS,keylen,keys) + +# define SSL_CTX_get_tlsext_status_cb(ssl, cb) \ + SSL_CTX_ctrl(ssl,SSL_CTRL_GET_TLSEXT_STATUS_REQ_CB,0,(void *)cb) +# define SSL_CTX_set_tlsext_status_cb(ssl, cb) \ + SSL_CTX_callback_ctrl(ssl,SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB,\ + (void (*)(void))cb) + +# define SSL_CTX_get_tlsext_status_arg(ssl, arg) \ + SSL_CTX_ctrl(ssl,SSL_CTRL_GET_TLSEXT_STATUS_REQ_CB_ARG,0,arg) +# define SSL_CTX_set_tlsext_status_arg(ssl, arg) \ + SSL_CTX_ctrl(ssl,SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB_ARG,0,arg) + +# define SSL_CTX_set_tlsext_status_type(ssl, type) \ + SSL_CTX_ctrl(ssl,SSL_CTRL_SET_TLSEXT_STATUS_REQ_TYPE,type,NULL) + +# define SSL_CTX_get_tlsext_status_type(ssl) \ + SSL_CTX_ctrl(ssl,SSL_CTRL_GET_TLSEXT_STATUS_REQ_TYPE,0,NULL) + +# define SSL_CTX_set_tlsext_ticket_key_cb(ssl, cb) \ + SSL_CTX_callback_ctrl(ssl,SSL_CTRL_SET_TLSEXT_TICKET_KEY_CB,\ + (void (*)(void))cb) + +# ifndef OPENSSL_NO_HEARTBEATS +# define SSL_DTLSEXT_HB_ENABLED 0x01 +# define SSL_DTLSEXT_HB_DONT_SEND_REQUESTS 0x02 +# define SSL_DTLSEXT_HB_DONT_RECV_REQUESTS 0x04 +# define SSL_get_dtlsext_heartbeat_pending(ssl) \ + SSL_ctrl(ssl,SSL_CTRL_GET_DTLS_EXT_HEARTBEAT_PENDING,0,NULL) +# define SSL_set_dtlsext_heartbeat_no_requests(ssl, arg) \ + SSL_ctrl(ssl,SSL_CTRL_SET_DTLS_EXT_HEARTBEAT_NO_REQUESTS,arg,NULL) + +# if OPENSSL_API_COMPAT < 0x10100000L +# define SSL_CTRL_TLS_EXT_SEND_HEARTBEAT \ + SSL_CTRL_DTLS_EXT_SEND_HEARTBEAT +# define SSL_CTRL_GET_TLS_EXT_HEARTBEAT_PENDING \ + SSL_CTRL_GET_DTLS_EXT_HEARTBEAT_PENDING +# define SSL_CTRL_SET_TLS_EXT_HEARTBEAT_NO_REQUESTS \ + SSL_CTRL_SET_DTLS_EXT_HEARTBEAT_NO_REQUESTS +# define SSL_TLSEXT_HB_ENABLED \ + SSL_DTLSEXT_HB_ENABLED +# define SSL_TLSEXT_HB_DONT_SEND_REQUESTS \ + SSL_DTLSEXT_HB_DONT_SEND_REQUESTS +# define SSL_TLSEXT_HB_DONT_RECV_REQUESTS \ + SSL_DTLSEXT_HB_DONT_RECV_REQUESTS +# define SSL_get_tlsext_heartbeat_pending(ssl) \ + SSL_get_dtlsext_heartbeat_pending(ssl) +# define SSL_set_tlsext_heartbeat_no_requests(ssl, arg) \ + SSL_set_dtlsext_heartbeat_no_requests(ssl,arg) +# endif +# endif + +/* PSK ciphersuites from 4279 */ +# define TLS1_CK_PSK_WITH_RC4_128_SHA 0x0300008A +# define TLS1_CK_PSK_WITH_3DES_EDE_CBC_SHA 0x0300008B +# define TLS1_CK_PSK_WITH_AES_128_CBC_SHA 0x0300008C +# define TLS1_CK_PSK_WITH_AES_256_CBC_SHA 0x0300008D +# define TLS1_CK_DHE_PSK_WITH_RC4_128_SHA 0x0300008E +# define TLS1_CK_DHE_PSK_WITH_3DES_EDE_CBC_SHA 0x0300008F +# define TLS1_CK_DHE_PSK_WITH_AES_128_CBC_SHA 0x03000090 +# define TLS1_CK_DHE_PSK_WITH_AES_256_CBC_SHA 0x03000091 +# define TLS1_CK_RSA_PSK_WITH_RC4_128_SHA 0x03000092 +# define TLS1_CK_RSA_PSK_WITH_3DES_EDE_CBC_SHA 0x03000093 +# define TLS1_CK_RSA_PSK_WITH_AES_128_CBC_SHA 0x03000094 +# define TLS1_CK_RSA_PSK_WITH_AES_256_CBC_SHA 0x03000095 + +/* PSK ciphersuites from 5487 */ +# define TLS1_CK_PSK_WITH_AES_128_GCM_SHA256 0x030000A8 +# define TLS1_CK_PSK_WITH_AES_256_GCM_SHA384 0x030000A9 +# define TLS1_CK_DHE_PSK_WITH_AES_128_GCM_SHA256 0x030000AA +# define TLS1_CK_DHE_PSK_WITH_AES_256_GCM_SHA384 0x030000AB +# define TLS1_CK_RSA_PSK_WITH_AES_128_GCM_SHA256 0x030000AC +# define TLS1_CK_RSA_PSK_WITH_AES_256_GCM_SHA384 0x030000AD +# define TLS1_CK_PSK_WITH_AES_128_CBC_SHA256 0x030000AE +# define TLS1_CK_PSK_WITH_AES_256_CBC_SHA384 0x030000AF +# define TLS1_CK_PSK_WITH_NULL_SHA256 0x030000B0 +# define TLS1_CK_PSK_WITH_NULL_SHA384 0x030000B1 +# define TLS1_CK_DHE_PSK_WITH_AES_128_CBC_SHA256 0x030000B2 +# define TLS1_CK_DHE_PSK_WITH_AES_256_CBC_SHA384 0x030000B3 +# define TLS1_CK_DHE_PSK_WITH_NULL_SHA256 0x030000B4 +# define TLS1_CK_DHE_PSK_WITH_NULL_SHA384 0x030000B5 +# define TLS1_CK_RSA_PSK_WITH_AES_128_CBC_SHA256 0x030000B6 +# define TLS1_CK_RSA_PSK_WITH_AES_256_CBC_SHA384 0x030000B7 +# define TLS1_CK_RSA_PSK_WITH_NULL_SHA256 0x030000B8 +# define TLS1_CK_RSA_PSK_WITH_NULL_SHA384 0x030000B9 + +/* NULL PSK ciphersuites from RFC4785 */ +# define TLS1_CK_PSK_WITH_NULL_SHA 0x0300002C +# define TLS1_CK_DHE_PSK_WITH_NULL_SHA 0x0300002D +# define TLS1_CK_RSA_PSK_WITH_NULL_SHA 0x0300002E + +/* AES ciphersuites from RFC3268 */ +# define TLS1_CK_RSA_WITH_AES_128_SHA 0x0300002F +# define TLS1_CK_DH_DSS_WITH_AES_128_SHA 0x03000030 +# define TLS1_CK_DH_RSA_WITH_AES_128_SHA 0x03000031 +# define TLS1_CK_DHE_DSS_WITH_AES_128_SHA 0x03000032 +# define TLS1_CK_DHE_RSA_WITH_AES_128_SHA 0x03000033 +# define TLS1_CK_ADH_WITH_AES_128_SHA 0x03000034 +# define TLS1_CK_RSA_WITH_AES_256_SHA 0x03000035 +# define TLS1_CK_DH_DSS_WITH_AES_256_SHA 0x03000036 +# define TLS1_CK_DH_RSA_WITH_AES_256_SHA 0x03000037 +# define TLS1_CK_DHE_DSS_WITH_AES_256_SHA 0x03000038 +# define TLS1_CK_DHE_RSA_WITH_AES_256_SHA 0x03000039 +# define TLS1_CK_ADH_WITH_AES_256_SHA 0x0300003A + +/* TLS v1.2 ciphersuites */ +# define TLS1_CK_RSA_WITH_NULL_SHA256 0x0300003B +# define TLS1_CK_RSA_WITH_AES_128_SHA256 0x0300003C +# define TLS1_CK_RSA_WITH_AES_256_SHA256 0x0300003D +# define TLS1_CK_DH_DSS_WITH_AES_128_SHA256 0x0300003E +# define TLS1_CK_DH_RSA_WITH_AES_128_SHA256 0x0300003F +# define TLS1_CK_DHE_DSS_WITH_AES_128_SHA256 0x03000040 + +/* Camellia ciphersuites from RFC4132 */ +# define TLS1_CK_RSA_WITH_CAMELLIA_128_CBC_SHA 0x03000041 +# define TLS1_CK_DH_DSS_WITH_CAMELLIA_128_CBC_SHA 0x03000042 +# define TLS1_CK_DH_RSA_WITH_CAMELLIA_128_CBC_SHA 0x03000043 +# define TLS1_CK_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA 0x03000044 +# define TLS1_CK_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x03000045 +# define TLS1_CK_ADH_WITH_CAMELLIA_128_CBC_SHA 0x03000046 + +/* TLS v1.2 ciphersuites */ +# define TLS1_CK_DHE_RSA_WITH_AES_128_SHA256 0x03000067 +# define TLS1_CK_DH_DSS_WITH_AES_256_SHA256 0x03000068 +# define TLS1_CK_DH_RSA_WITH_AES_256_SHA256 0x03000069 +# define TLS1_CK_DHE_DSS_WITH_AES_256_SHA256 0x0300006A +# define TLS1_CK_DHE_RSA_WITH_AES_256_SHA256 0x0300006B +# define TLS1_CK_ADH_WITH_AES_128_SHA256 0x0300006C +# define TLS1_CK_ADH_WITH_AES_256_SHA256 0x0300006D + +/* Camellia ciphersuites from RFC4132 */ +# define TLS1_CK_RSA_WITH_CAMELLIA_256_CBC_SHA 0x03000084 +# define TLS1_CK_DH_DSS_WITH_CAMELLIA_256_CBC_SHA 0x03000085 +# define TLS1_CK_DH_RSA_WITH_CAMELLIA_256_CBC_SHA 0x03000086 +# define TLS1_CK_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA 0x03000087 +# define TLS1_CK_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x03000088 +# define TLS1_CK_ADH_WITH_CAMELLIA_256_CBC_SHA 0x03000089 + +/* SEED ciphersuites from RFC4162 */ +# define TLS1_CK_RSA_WITH_SEED_SHA 0x03000096 +# define TLS1_CK_DH_DSS_WITH_SEED_SHA 0x03000097 +# define TLS1_CK_DH_RSA_WITH_SEED_SHA 0x03000098 +# define TLS1_CK_DHE_DSS_WITH_SEED_SHA 0x03000099 +# define TLS1_CK_DHE_RSA_WITH_SEED_SHA 0x0300009A +# define TLS1_CK_ADH_WITH_SEED_SHA 0x0300009B + +/* TLS v1.2 GCM ciphersuites from RFC5288 */ +# define TLS1_CK_RSA_WITH_AES_128_GCM_SHA256 0x0300009C +# define TLS1_CK_RSA_WITH_AES_256_GCM_SHA384 0x0300009D +# define TLS1_CK_DHE_RSA_WITH_AES_128_GCM_SHA256 0x0300009E +# define TLS1_CK_DHE_RSA_WITH_AES_256_GCM_SHA384 0x0300009F +# define TLS1_CK_DH_RSA_WITH_AES_128_GCM_SHA256 0x030000A0 +# define TLS1_CK_DH_RSA_WITH_AES_256_GCM_SHA384 0x030000A1 +# define TLS1_CK_DHE_DSS_WITH_AES_128_GCM_SHA256 0x030000A2 +# define TLS1_CK_DHE_DSS_WITH_AES_256_GCM_SHA384 0x030000A3 +# define TLS1_CK_DH_DSS_WITH_AES_128_GCM_SHA256 0x030000A4 +# define TLS1_CK_DH_DSS_WITH_AES_256_GCM_SHA384 0x030000A5 +# define TLS1_CK_ADH_WITH_AES_128_GCM_SHA256 0x030000A6 +# define TLS1_CK_ADH_WITH_AES_256_GCM_SHA384 0x030000A7 + +/* CCM ciphersuites from RFC6655 */ +# define TLS1_CK_RSA_WITH_AES_128_CCM 0x0300C09C +# define TLS1_CK_RSA_WITH_AES_256_CCM 0x0300C09D +# define TLS1_CK_DHE_RSA_WITH_AES_128_CCM 0x0300C09E +# define TLS1_CK_DHE_RSA_WITH_AES_256_CCM 0x0300C09F +# define TLS1_CK_RSA_WITH_AES_128_CCM_8 0x0300C0A0 +# define TLS1_CK_RSA_WITH_AES_256_CCM_8 0x0300C0A1 +# define TLS1_CK_DHE_RSA_WITH_AES_128_CCM_8 0x0300C0A2 +# define TLS1_CK_DHE_RSA_WITH_AES_256_CCM_8 0x0300C0A3 +# define TLS1_CK_PSK_WITH_AES_128_CCM 0x0300C0A4 +# define TLS1_CK_PSK_WITH_AES_256_CCM 0x0300C0A5 +# define TLS1_CK_DHE_PSK_WITH_AES_128_CCM 0x0300C0A6 +# define TLS1_CK_DHE_PSK_WITH_AES_256_CCM 0x0300C0A7 +# define TLS1_CK_PSK_WITH_AES_128_CCM_8 0x0300C0A8 +# define TLS1_CK_PSK_WITH_AES_256_CCM_8 0x0300C0A9 +# define TLS1_CK_DHE_PSK_WITH_AES_128_CCM_8 0x0300C0AA +# define TLS1_CK_DHE_PSK_WITH_AES_256_CCM_8 0x0300C0AB + +/* CCM ciphersuites from RFC7251 */ +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_128_CCM 0x0300C0AC +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_256_CCM 0x0300C0AD +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_128_CCM_8 0x0300C0AE +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_256_CCM_8 0x0300C0AF + +/* TLS 1.2 Camellia SHA-256 ciphersuites from RFC5932 */ +# define TLS1_CK_RSA_WITH_CAMELLIA_128_CBC_SHA256 0x030000BA +# define TLS1_CK_DH_DSS_WITH_CAMELLIA_128_CBC_SHA256 0x030000BB +# define TLS1_CK_DH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0x030000BC +# define TLS1_CK_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA256 0x030000BD +# define TLS1_CK_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0x030000BE +# define TLS1_CK_ADH_WITH_CAMELLIA_128_CBC_SHA256 0x030000BF + +# define TLS1_CK_RSA_WITH_CAMELLIA_256_CBC_SHA256 0x030000C0 +# define TLS1_CK_DH_DSS_WITH_CAMELLIA_256_CBC_SHA256 0x030000C1 +# define TLS1_CK_DH_RSA_WITH_CAMELLIA_256_CBC_SHA256 0x030000C2 +# define TLS1_CK_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA256 0x030000C3 +# define TLS1_CK_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0x030000C4 +# define TLS1_CK_ADH_WITH_CAMELLIA_256_CBC_SHA256 0x030000C5 + +/* ECC ciphersuites from RFC4492 */ +# define TLS1_CK_ECDH_ECDSA_WITH_NULL_SHA 0x0300C001 +# define TLS1_CK_ECDH_ECDSA_WITH_RC4_128_SHA 0x0300C002 +# define TLS1_CK_ECDH_ECDSA_WITH_DES_192_CBC3_SHA 0x0300C003 +# define TLS1_CK_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0x0300C004 +# define TLS1_CK_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0x0300C005 + +# define TLS1_CK_ECDHE_ECDSA_WITH_NULL_SHA 0x0300C006 +# define TLS1_CK_ECDHE_ECDSA_WITH_RC4_128_SHA 0x0300C007 +# define TLS1_CK_ECDHE_ECDSA_WITH_DES_192_CBC3_SHA 0x0300C008 +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0x0300C009 +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0x0300C00A + +# define TLS1_CK_ECDH_RSA_WITH_NULL_SHA 0x0300C00B +# define TLS1_CK_ECDH_RSA_WITH_RC4_128_SHA 0x0300C00C +# define TLS1_CK_ECDH_RSA_WITH_DES_192_CBC3_SHA 0x0300C00D +# define TLS1_CK_ECDH_RSA_WITH_AES_128_CBC_SHA 0x0300C00E +# define TLS1_CK_ECDH_RSA_WITH_AES_256_CBC_SHA 0x0300C00F + +# define TLS1_CK_ECDHE_RSA_WITH_NULL_SHA 0x0300C010 +# define TLS1_CK_ECDHE_RSA_WITH_RC4_128_SHA 0x0300C011 +# define TLS1_CK_ECDHE_RSA_WITH_DES_192_CBC3_SHA 0x0300C012 +# define TLS1_CK_ECDHE_RSA_WITH_AES_128_CBC_SHA 0x0300C013 +# define TLS1_CK_ECDHE_RSA_WITH_AES_256_CBC_SHA 0x0300C014 + +# define TLS1_CK_ECDH_anon_WITH_NULL_SHA 0x0300C015 +# define TLS1_CK_ECDH_anon_WITH_RC4_128_SHA 0x0300C016 +# define TLS1_CK_ECDH_anon_WITH_DES_192_CBC3_SHA 0x0300C017 +# define TLS1_CK_ECDH_anon_WITH_AES_128_CBC_SHA 0x0300C018 +# define TLS1_CK_ECDH_anon_WITH_AES_256_CBC_SHA 0x0300C019 + +/* SRP ciphersuites from RFC 5054 */ +# define TLS1_CK_SRP_SHA_WITH_3DES_EDE_CBC_SHA 0x0300C01A +# define TLS1_CK_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA 0x0300C01B +# define TLS1_CK_SRP_SHA_DSS_WITH_3DES_EDE_CBC_SHA 0x0300C01C +# define TLS1_CK_SRP_SHA_WITH_AES_128_CBC_SHA 0x0300C01D +# define TLS1_CK_SRP_SHA_RSA_WITH_AES_128_CBC_SHA 0x0300C01E +# define TLS1_CK_SRP_SHA_DSS_WITH_AES_128_CBC_SHA 0x0300C01F +# define TLS1_CK_SRP_SHA_WITH_AES_256_CBC_SHA 0x0300C020 +# define TLS1_CK_SRP_SHA_RSA_WITH_AES_256_CBC_SHA 0x0300C021 +# define TLS1_CK_SRP_SHA_DSS_WITH_AES_256_CBC_SHA 0x0300C022 + +/* ECDH HMAC based ciphersuites from RFC5289 */ +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_128_SHA256 0x0300C023 +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_256_SHA384 0x0300C024 +# define TLS1_CK_ECDH_ECDSA_WITH_AES_128_SHA256 0x0300C025 +# define TLS1_CK_ECDH_ECDSA_WITH_AES_256_SHA384 0x0300C026 +# define TLS1_CK_ECDHE_RSA_WITH_AES_128_SHA256 0x0300C027 +# define TLS1_CK_ECDHE_RSA_WITH_AES_256_SHA384 0x0300C028 +# define TLS1_CK_ECDH_RSA_WITH_AES_128_SHA256 0x0300C029 +# define TLS1_CK_ECDH_RSA_WITH_AES_256_SHA384 0x0300C02A + +/* ECDH GCM based ciphersuites from RFC5289 */ +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0x0300C02B +# define TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0x0300C02C +# define TLS1_CK_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0x0300C02D +# define TLS1_CK_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0x0300C02E +# define TLS1_CK_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0x0300C02F +# define TLS1_CK_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0x0300C030 +# define TLS1_CK_ECDH_RSA_WITH_AES_128_GCM_SHA256 0x0300C031 +# define TLS1_CK_ECDH_RSA_WITH_AES_256_GCM_SHA384 0x0300C032 + +/* ECDHE PSK ciphersuites from RFC5489 */ +# define TLS1_CK_ECDHE_PSK_WITH_RC4_128_SHA 0x0300C033 +# define TLS1_CK_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA 0x0300C034 +# define TLS1_CK_ECDHE_PSK_WITH_AES_128_CBC_SHA 0x0300C035 +# define TLS1_CK_ECDHE_PSK_WITH_AES_256_CBC_SHA 0x0300C036 + +# define TLS1_CK_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0x0300C037 +# define TLS1_CK_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0x0300C038 + +/* NULL PSK ciphersuites from RFC4785 */ +# define TLS1_CK_ECDHE_PSK_WITH_NULL_SHA 0x0300C039 +# define TLS1_CK_ECDHE_PSK_WITH_NULL_SHA256 0x0300C03A +# define TLS1_CK_ECDHE_PSK_WITH_NULL_SHA384 0x0300C03B + +/* Camellia-CBC ciphersuites from RFC6367 */ +# define TLS1_CK_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0x0300C072 +# define TLS1_CK_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0x0300C073 +# define TLS1_CK_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0x0300C074 +# define TLS1_CK_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0x0300C075 +# define TLS1_CK_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0x0300C076 +# define TLS1_CK_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0x0300C077 +# define TLS1_CK_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0x0300C078 +# define TLS1_CK_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0x0300C079 + +# define TLS1_CK_PSK_WITH_CAMELLIA_128_CBC_SHA256 0x0300C094 +# define TLS1_CK_PSK_WITH_CAMELLIA_256_CBC_SHA384 0x0300C095 +# define TLS1_CK_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0x0300C096 +# define TLS1_CK_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0x0300C097 +# define TLS1_CK_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0x0300C098 +# define TLS1_CK_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0x0300C099 +# define TLS1_CK_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0x0300C09A +# define TLS1_CK_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0x0300C09B + +/* draft-ietf-tls-chacha20-poly1305-03 */ +# define TLS1_CK_ECDHE_RSA_WITH_CHACHA20_POLY1305 0x0300CCA8 +# define TLS1_CK_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 0x0300CCA9 +# define TLS1_CK_DHE_RSA_WITH_CHACHA20_POLY1305 0x0300CCAA +# define TLS1_CK_PSK_WITH_CHACHA20_POLY1305 0x0300CCAB +# define TLS1_CK_ECDHE_PSK_WITH_CHACHA20_POLY1305 0x0300CCAC +# define TLS1_CK_DHE_PSK_WITH_CHACHA20_POLY1305 0x0300CCAD +# define TLS1_CK_RSA_PSK_WITH_CHACHA20_POLY1305 0x0300CCAE + +/* TLS v1.3 ciphersuites */ +# define TLS1_3_CK_AES_128_GCM_SHA256 0x03001301 +# define TLS1_3_CK_AES_256_GCM_SHA384 0x03001302 +# define TLS1_3_CK_CHACHA20_POLY1305_SHA256 0x03001303 +# define TLS1_3_CK_AES_128_CCM_SHA256 0x03001304 +# define TLS1_3_CK_AES_128_CCM_8_SHA256 0x03001305 + +/* Aria ciphersuites from RFC6209 */ +# define TLS1_CK_RSA_WITH_ARIA_128_GCM_SHA256 0x0300C050 +# define TLS1_CK_RSA_WITH_ARIA_256_GCM_SHA384 0x0300C051 +# define TLS1_CK_DHE_RSA_WITH_ARIA_128_GCM_SHA256 0x0300C052 +# define TLS1_CK_DHE_RSA_WITH_ARIA_256_GCM_SHA384 0x0300C053 +# define TLS1_CK_DH_RSA_WITH_ARIA_128_GCM_SHA256 0x0300C054 +# define TLS1_CK_DH_RSA_WITH_ARIA_256_GCM_SHA384 0x0300C055 +# define TLS1_CK_DHE_DSS_WITH_ARIA_128_GCM_SHA256 0x0300C056 +# define TLS1_CK_DHE_DSS_WITH_ARIA_256_GCM_SHA384 0x0300C057 +# define TLS1_CK_DH_DSS_WITH_ARIA_128_GCM_SHA256 0x0300C058 +# define TLS1_CK_DH_DSS_WITH_ARIA_256_GCM_SHA384 0x0300C059 +# define TLS1_CK_DH_anon_WITH_ARIA_128_GCM_SHA256 0x0300C05A +# define TLS1_CK_DH_anon_WITH_ARIA_256_GCM_SHA384 0x0300C05B +# define TLS1_CK_ECDHE_ECDSA_WITH_ARIA_128_GCM_SHA256 0x0300C05C +# define TLS1_CK_ECDHE_ECDSA_WITH_ARIA_256_GCM_SHA384 0x0300C05D +# define TLS1_CK_ECDH_ECDSA_WITH_ARIA_128_GCM_SHA256 0x0300C05E +# define TLS1_CK_ECDH_ECDSA_WITH_ARIA_256_GCM_SHA384 0x0300C05F +# define TLS1_CK_ECDHE_RSA_WITH_ARIA_128_GCM_SHA256 0x0300C060 +# define TLS1_CK_ECDHE_RSA_WITH_ARIA_256_GCM_SHA384 0x0300C061 +# define TLS1_CK_ECDH_RSA_WITH_ARIA_128_GCM_SHA256 0x0300C062 +# define TLS1_CK_ECDH_RSA_WITH_ARIA_256_GCM_SHA384 0x0300C063 +# define TLS1_CK_PSK_WITH_ARIA_128_GCM_SHA256 0x0300C06A +# define TLS1_CK_PSK_WITH_ARIA_256_GCM_SHA384 0x0300C06B +# define TLS1_CK_DHE_PSK_WITH_ARIA_128_GCM_SHA256 0x0300C06C +# define TLS1_CK_DHE_PSK_WITH_ARIA_256_GCM_SHA384 0x0300C06D +# define TLS1_CK_RSA_PSK_WITH_ARIA_128_GCM_SHA256 0x0300C06E +# define TLS1_CK_RSA_PSK_WITH_ARIA_256_GCM_SHA384 0x0300C06F + +/* a bundle of RFC standard cipher names, generated from ssl3_ciphers[] */ +# define TLS1_RFC_RSA_WITH_AES_128_SHA "TLS_RSA_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_DHE_DSS_WITH_AES_128_SHA "TLS_DHE_DSS_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_DHE_RSA_WITH_AES_128_SHA "TLS_DHE_RSA_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_ADH_WITH_AES_128_SHA "TLS_DH_anon_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_RSA_WITH_AES_256_SHA "TLS_RSA_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_DHE_DSS_WITH_AES_256_SHA "TLS_DHE_DSS_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_DHE_RSA_WITH_AES_256_SHA "TLS_DHE_RSA_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_ADH_WITH_AES_256_SHA "TLS_DH_anon_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_RSA_WITH_NULL_SHA256 "TLS_RSA_WITH_NULL_SHA256" +# define TLS1_RFC_RSA_WITH_AES_128_SHA256 "TLS_RSA_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_RSA_WITH_AES_256_SHA256 "TLS_RSA_WITH_AES_256_CBC_SHA256" +# define TLS1_RFC_DHE_DSS_WITH_AES_128_SHA256 "TLS_DHE_DSS_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_DHE_RSA_WITH_AES_128_SHA256 "TLS_DHE_RSA_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_DHE_DSS_WITH_AES_256_SHA256 "TLS_DHE_DSS_WITH_AES_256_CBC_SHA256" +# define TLS1_RFC_DHE_RSA_WITH_AES_256_SHA256 "TLS_DHE_RSA_WITH_AES_256_CBC_SHA256" +# define TLS1_RFC_ADH_WITH_AES_128_SHA256 "TLS_DH_anon_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_ADH_WITH_AES_256_SHA256 "TLS_DH_anon_WITH_AES_256_CBC_SHA256" +# define TLS1_RFC_RSA_WITH_AES_128_GCM_SHA256 "TLS_RSA_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_RSA_WITH_AES_256_GCM_SHA384 "TLS_RSA_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_DHE_RSA_WITH_AES_128_GCM_SHA256 "TLS_DHE_RSA_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_DHE_RSA_WITH_AES_256_GCM_SHA384 "TLS_DHE_RSA_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_DHE_DSS_WITH_AES_128_GCM_SHA256 "TLS_DHE_DSS_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_DHE_DSS_WITH_AES_256_GCM_SHA384 "TLS_DHE_DSS_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_ADH_WITH_AES_128_GCM_SHA256 "TLS_DH_anon_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_ADH_WITH_AES_256_GCM_SHA384 "TLS_DH_anon_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_RSA_WITH_AES_128_CCM "TLS_RSA_WITH_AES_128_CCM" +# define TLS1_RFC_RSA_WITH_AES_256_CCM "TLS_RSA_WITH_AES_256_CCM" +# define TLS1_RFC_DHE_RSA_WITH_AES_128_CCM "TLS_DHE_RSA_WITH_AES_128_CCM" +# define TLS1_RFC_DHE_RSA_WITH_AES_256_CCM "TLS_DHE_RSA_WITH_AES_256_CCM" +# define TLS1_RFC_RSA_WITH_AES_128_CCM_8 "TLS_RSA_WITH_AES_128_CCM_8" +# define TLS1_RFC_RSA_WITH_AES_256_CCM_8 "TLS_RSA_WITH_AES_256_CCM_8" +# define TLS1_RFC_DHE_RSA_WITH_AES_128_CCM_8 "TLS_DHE_RSA_WITH_AES_128_CCM_8" +# define TLS1_RFC_DHE_RSA_WITH_AES_256_CCM_8 "TLS_DHE_RSA_WITH_AES_256_CCM_8" +# define TLS1_RFC_PSK_WITH_AES_128_CCM "TLS_PSK_WITH_AES_128_CCM" +# define TLS1_RFC_PSK_WITH_AES_256_CCM "TLS_PSK_WITH_AES_256_CCM" +# define TLS1_RFC_DHE_PSK_WITH_AES_128_CCM "TLS_DHE_PSK_WITH_AES_128_CCM" +# define TLS1_RFC_DHE_PSK_WITH_AES_256_CCM "TLS_DHE_PSK_WITH_AES_256_CCM" +# define TLS1_RFC_PSK_WITH_AES_128_CCM_8 "TLS_PSK_WITH_AES_128_CCM_8" +# define TLS1_RFC_PSK_WITH_AES_256_CCM_8 "TLS_PSK_WITH_AES_256_CCM_8" +# define TLS1_RFC_DHE_PSK_WITH_AES_128_CCM_8 "TLS_PSK_DHE_WITH_AES_128_CCM_8" +# define TLS1_RFC_DHE_PSK_WITH_AES_256_CCM_8 "TLS_PSK_DHE_WITH_AES_256_CCM_8" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_128_CCM "TLS_ECDHE_ECDSA_WITH_AES_128_CCM" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_256_CCM "TLS_ECDHE_ECDSA_WITH_AES_256_CCM" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_128_CCM_8 "TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_256_CCM_8 "TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8" +# define TLS1_3_RFC_AES_128_GCM_SHA256 "TLS_AES_128_GCM_SHA256" +# define TLS1_3_RFC_AES_256_GCM_SHA384 "TLS_AES_256_GCM_SHA384" +# define TLS1_3_RFC_CHACHA20_POLY1305_SHA256 "TLS_CHACHA20_POLY1305_SHA256" +# define TLS1_3_RFC_AES_128_CCM_SHA256 "TLS_AES_128_CCM_SHA256" +# define TLS1_3_RFC_AES_128_CCM_8_SHA256 "TLS_AES_128_CCM_8_SHA256" +# define TLS1_RFC_ECDHE_ECDSA_WITH_NULL_SHA "TLS_ECDHE_ECDSA_WITH_NULL_SHA" +# define TLS1_RFC_ECDHE_ECDSA_WITH_DES_192_CBC3_SHA "TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_128_CBC_SHA "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_256_CBC_SHA "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_ECDHE_RSA_WITH_NULL_SHA "TLS_ECDHE_RSA_WITH_NULL_SHA" +# define TLS1_RFC_ECDHE_RSA_WITH_DES_192_CBC3_SHA "TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_ECDHE_RSA_WITH_AES_128_CBC_SHA "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_ECDHE_RSA_WITH_AES_256_CBC_SHA "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_ECDH_anon_WITH_NULL_SHA "TLS_ECDH_anon_WITH_NULL_SHA" +# define TLS1_RFC_ECDH_anon_WITH_DES_192_CBC3_SHA "TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_ECDH_anon_WITH_AES_128_CBC_SHA "TLS_ECDH_anon_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_ECDH_anon_WITH_AES_256_CBC_SHA "TLS_ECDH_anon_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_128_SHA256 "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_256_SHA384 "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384" +# define TLS1_RFC_ECDHE_RSA_WITH_AES_128_SHA256 "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_ECDHE_RSA_WITH_AES_256_SHA384 "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_ECDHE_RSA_WITH_AES_128_GCM_SHA256 "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_ECDHE_RSA_WITH_AES_256_GCM_SHA384 "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_PSK_WITH_NULL_SHA "TLS_PSK_WITH_NULL_SHA" +# define TLS1_RFC_DHE_PSK_WITH_NULL_SHA "TLS_DHE_PSK_WITH_NULL_SHA" +# define TLS1_RFC_RSA_PSK_WITH_NULL_SHA "TLS_RSA_PSK_WITH_NULL_SHA" +# define TLS1_RFC_PSK_WITH_3DES_EDE_CBC_SHA "TLS_PSK_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_PSK_WITH_AES_128_CBC_SHA "TLS_PSK_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_PSK_WITH_AES_256_CBC_SHA "TLS_PSK_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_DHE_PSK_WITH_3DES_EDE_CBC_SHA "TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_DHE_PSK_WITH_AES_128_CBC_SHA "TLS_DHE_PSK_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_DHE_PSK_WITH_AES_256_CBC_SHA "TLS_DHE_PSK_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_RSA_PSK_WITH_3DES_EDE_CBC_SHA "TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_RSA_PSK_WITH_AES_128_CBC_SHA "TLS_RSA_PSK_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_RSA_PSK_WITH_AES_256_CBC_SHA "TLS_RSA_PSK_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_PSK_WITH_AES_128_GCM_SHA256 "TLS_PSK_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_PSK_WITH_AES_256_GCM_SHA384 "TLS_PSK_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_DHE_PSK_WITH_AES_128_GCM_SHA256 "TLS_DHE_PSK_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_DHE_PSK_WITH_AES_256_GCM_SHA384 "TLS_DHE_PSK_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_RSA_PSK_WITH_AES_128_GCM_SHA256 "TLS_RSA_PSK_WITH_AES_128_GCM_SHA256" +# define TLS1_RFC_RSA_PSK_WITH_AES_256_GCM_SHA384 "TLS_RSA_PSK_WITH_AES_256_GCM_SHA384" +# define TLS1_RFC_PSK_WITH_AES_128_CBC_SHA256 "TLS_PSK_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_PSK_WITH_AES_256_CBC_SHA384 "TLS_PSK_WITH_AES_256_CBC_SHA384" +# define TLS1_RFC_PSK_WITH_NULL_SHA256 "TLS_PSK_WITH_NULL_SHA256" +# define TLS1_RFC_PSK_WITH_NULL_SHA384 "TLS_PSK_WITH_NULL_SHA384" +# define TLS1_RFC_DHE_PSK_WITH_AES_128_CBC_SHA256 "TLS_DHE_PSK_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_DHE_PSK_WITH_AES_256_CBC_SHA384 "TLS_DHE_PSK_WITH_AES_256_CBC_SHA384" +# define TLS1_RFC_DHE_PSK_WITH_NULL_SHA256 "TLS_DHE_PSK_WITH_NULL_SHA256" +# define TLS1_RFC_DHE_PSK_WITH_NULL_SHA384 "TLS_DHE_PSK_WITH_NULL_SHA384" +# define TLS1_RFC_RSA_PSK_WITH_AES_128_CBC_SHA256 "TLS_RSA_PSK_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_RSA_PSK_WITH_AES_256_CBC_SHA384 "TLS_RSA_PSK_WITH_AES_256_CBC_SHA384" +# define TLS1_RFC_RSA_PSK_WITH_NULL_SHA256 "TLS_RSA_PSK_WITH_NULL_SHA256" +# define TLS1_RFC_RSA_PSK_WITH_NULL_SHA384 "TLS_RSA_PSK_WITH_NULL_SHA384" +# define TLS1_RFC_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA "TLS_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_ECDHE_PSK_WITH_AES_128_CBC_SHA "TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_ECDHE_PSK_WITH_AES_256_CBC_SHA "TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_ECDHE_PSK_WITH_AES_128_CBC_SHA256 "TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256" +# define TLS1_RFC_ECDHE_PSK_WITH_AES_256_CBC_SHA384 "TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384" +# define TLS1_RFC_ECDHE_PSK_WITH_NULL_SHA "TLS_ECDHE_PSK_WITH_NULL_SHA" +# define TLS1_RFC_ECDHE_PSK_WITH_NULL_SHA256 "TLS_ECDHE_PSK_WITH_NULL_SHA256" +# define TLS1_RFC_ECDHE_PSK_WITH_NULL_SHA384 "TLS_ECDHE_PSK_WITH_NULL_SHA384" +# define TLS1_RFC_SRP_SHA_WITH_3DES_EDE_CBC_SHA "TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA "TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_SRP_SHA_DSS_WITH_3DES_EDE_CBC_SHA "TLS_SRP_SHA_DSS_WITH_3DES_EDE_CBC_SHA" +# define TLS1_RFC_SRP_SHA_WITH_AES_128_CBC_SHA "TLS_SRP_SHA_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_SRP_SHA_RSA_WITH_AES_128_CBC_SHA "TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_SRP_SHA_DSS_WITH_AES_128_CBC_SHA "TLS_SRP_SHA_DSS_WITH_AES_128_CBC_SHA" +# define TLS1_RFC_SRP_SHA_WITH_AES_256_CBC_SHA "TLS_SRP_SHA_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_SRP_SHA_RSA_WITH_AES_256_CBC_SHA "TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_SRP_SHA_DSS_WITH_AES_256_CBC_SHA "TLS_SRP_SHA_DSS_WITH_AES_256_CBC_SHA" +# define TLS1_RFC_DHE_RSA_WITH_CHACHA20_POLY1305 "TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256" +# define TLS1_RFC_ECDHE_RSA_WITH_CHACHA20_POLY1305 "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256" +# define TLS1_RFC_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256" +# define TLS1_RFC_PSK_WITH_CHACHA20_POLY1305 "TLS_PSK_WITH_CHACHA20_POLY1305_SHA256" +# define TLS1_RFC_ECDHE_PSK_WITH_CHACHA20_POLY1305 "TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256" +# define TLS1_RFC_DHE_PSK_WITH_CHACHA20_POLY1305 "TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256" +# define TLS1_RFC_RSA_PSK_WITH_CHACHA20_POLY1305 "TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256" +# define TLS1_RFC_RSA_WITH_CAMELLIA_128_CBC_SHA256 "TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA256 "TLS_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 "TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_ADH_WITH_CAMELLIA_128_CBC_SHA256 "TLS_DH_anon_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_RSA_WITH_CAMELLIA_256_CBC_SHA256 "TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256" +# define TLS1_RFC_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA256 "TLS_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA256" +# define TLS1_RFC_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 "TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256" +# define TLS1_RFC_ADH_WITH_CAMELLIA_256_CBC_SHA256 "TLS_DH_anon_WITH_CAMELLIA_256_CBC_SHA256" +# define TLS1_RFC_RSA_WITH_CAMELLIA_256_CBC_SHA "TLS_RSA_WITH_CAMELLIA_256_CBC_SHA" +# define TLS1_RFC_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA "TLS_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA" +# define TLS1_RFC_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA "TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA" +# define TLS1_RFC_ADH_WITH_CAMELLIA_256_CBC_SHA "TLS_DH_anon_WITH_CAMELLIA_256_CBC_SHA" +# define TLS1_RFC_RSA_WITH_CAMELLIA_128_CBC_SHA "TLS_RSA_WITH_CAMELLIA_128_CBC_SHA" +# define TLS1_RFC_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA "TLS_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA" +# define TLS1_RFC_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA "TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA" +# define TLS1_RFC_ADH_WITH_CAMELLIA_128_CBC_SHA "TLS_DH_anon_WITH_CAMELLIA_128_CBC_SHA" +# define TLS1_RFC_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 "TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 "TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384" +# define TLS1_RFC_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 "TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 "TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384" +# define TLS1_RFC_PSK_WITH_CAMELLIA_128_CBC_SHA256 "TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_PSK_WITH_CAMELLIA_256_CBC_SHA384 "TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384" +# define TLS1_RFC_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 "TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 "TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384" +# define TLS1_RFC_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 "TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 "TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384" +# define TLS1_RFC_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 "TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256" +# define TLS1_RFC_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 "TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384" +# define TLS1_RFC_RSA_WITH_SEED_SHA "TLS_RSA_WITH_SEED_CBC_SHA" +# define TLS1_RFC_DHE_DSS_WITH_SEED_SHA "TLS_DHE_DSS_WITH_SEED_CBC_SHA" +# define TLS1_RFC_DHE_RSA_WITH_SEED_SHA "TLS_DHE_RSA_WITH_SEED_CBC_SHA" +# define TLS1_RFC_ADH_WITH_SEED_SHA "TLS_DH_anon_WITH_SEED_CBC_SHA" +# define TLS1_RFC_ECDHE_PSK_WITH_RC4_128_SHA "TLS_ECDHE_PSK_WITH_RC4_128_SHA" +# define TLS1_RFC_ECDH_anon_WITH_RC4_128_SHA "TLS_ECDH_anon_WITH_RC4_128_SHA" +# define TLS1_RFC_ECDHE_ECDSA_WITH_RC4_128_SHA "TLS_ECDHE_ECDSA_WITH_RC4_128_SHA" +# define TLS1_RFC_ECDHE_RSA_WITH_RC4_128_SHA "TLS_ECDHE_RSA_WITH_RC4_128_SHA" +# define TLS1_RFC_PSK_WITH_RC4_128_SHA "TLS_PSK_WITH_RC4_128_SHA" +# define TLS1_RFC_RSA_PSK_WITH_RC4_128_SHA "TLS_RSA_PSK_WITH_RC4_128_SHA" +# define TLS1_RFC_DHE_PSK_WITH_RC4_128_SHA "TLS_DHE_PSK_WITH_RC4_128_SHA" +# define TLS1_RFC_RSA_WITH_ARIA_128_GCM_SHA256 "TLS_RSA_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_RSA_WITH_ARIA_256_GCM_SHA384 "TLS_RSA_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_DHE_RSA_WITH_ARIA_128_GCM_SHA256 "TLS_DHE_RSA_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_DHE_RSA_WITH_ARIA_256_GCM_SHA384 "TLS_DHE_RSA_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_DH_RSA_WITH_ARIA_128_GCM_SHA256 "TLS_DH_RSA_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_DH_RSA_WITH_ARIA_256_GCM_SHA384 "TLS_DH_RSA_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_DHE_DSS_WITH_ARIA_128_GCM_SHA256 "TLS_DHE_DSS_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_DHE_DSS_WITH_ARIA_256_GCM_SHA384 "TLS_DHE_DSS_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_DH_DSS_WITH_ARIA_128_GCM_SHA256 "TLS_DH_DSS_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_DH_DSS_WITH_ARIA_256_GCM_SHA384 "TLS_DH_DSS_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_DH_anon_WITH_ARIA_128_GCM_SHA256 "TLS_DH_anon_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_DH_anon_WITH_ARIA_256_GCM_SHA384 "TLS_DH_anon_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_ECDHE_ECDSA_WITH_ARIA_128_GCM_SHA256 "TLS_ECDHE_ECDSA_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_ECDHE_ECDSA_WITH_ARIA_256_GCM_SHA384 "TLS_ECDHE_ECDSA_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_ECDH_ECDSA_WITH_ARIA_128_GCM_SHA256 "TLS_ECDH_ECDSA_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_ECDH_ECDSA_WITH_ARIA_256_GCM_SHA384 "TLS_ECDH_ECDSA_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_ECDHE_RSA_WITH_ARIA_128_GCM_SHA256 "TLS_ECDHE_RSA_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_ECDHE_RSA_WITH_ARIA_256_GCM_SHA384 "TLS_ECDHE_RSA_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_ECDH_RSA_WITH_ARIA_128_GCM_SHA256 "TLS_ECDH_RSA_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_ECDH_RSA_WITH_ARIA_256_GCM_SHA384 "TLS_ECDH_RSA_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_PSK_WITH_ARIA_128_GCM_SHA256 "TLS_PSK_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_PSK_WITH_ARIA_256_GCM_SHA384 "TLS_PSK_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_DHE_PSK_WITH_ARIA_128_GCM_SHA256 "TLS_DHE_PSK_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_DHE_PSK_WITH_ARIA_256_GCM_SHA384 "TLS_DHE_PSK_WITH_ARIA_256_GCM_SHA384" +# define TLS1_RFC_RSA_PSK_WITH_ARIA_128_GCM_SHA256 "TLS_RSA_PSK_WITH_ARIA_128_GCM_SHA256" +# define TLS1_RFC_RSA_PSK_WITH_ARIA_256_GCM_SHA384 "TLS_RSA_PSK_WITH_ARIA_256_GCM_SHA384" + + +/* + * XXX Backward compatibility alert: Older versions of OpenSSL gave some DHE + * ciphers names with "EDH" instead of "DHE". Going forward, we should be + * using DHE everywhere, though we may indefinitely maintain aliases for + * users or configurations that used "EDH" + */ +# define TLS1_TXT_DHE_DSS_WITH_RC4_128_SHA "DHE-DSS-RC4-SHA" + +# define TLS1_TXT_PSK_WITH_NULL_SHA "PSK-NULL-SHA" +# define TLS1_TXT_DHE_PSK_WITH_NULL_SHA "DHE-PSK-NULL-SHA" +# define TLS1_TXT_RSA_PSK_WITH_NULL_SHA "RSA-PSK-NULL-SHA" + +/* AES ciphersuites from RFC3268 */ +# define TLS1_TXT_RSA_WITH_AES_128_SHA "AES128-SHA" +# define TLS1_TXT_DH_DSS_WITH_AES_128_SHA "DH-DSS-AES128-SHA" +# define TLS1_TXT_DH_RSA_WITH_AES_128_SHA "DH-RSA-AES128-SHA" +# define TLS1_TXT_DHE_DSS_WITH_AES_128_SHA "DHE-DSS-AES128-SHA" +# define TLS1_TXT_DHE_RSA_WITH_AES_128_SHA "DHE-RSA-AES128-SHA" +# define TLS1_TXT_ADH_WITH_AES_128_SHA "ADH-AES128-SHA" + +# define TLS1_TXT_RSA_WITH_AES_256_SHA "AES256-SHA" +# define TLS1_TXT_DH_DSS_WITH_AES_256_SHA "DH-DSS-AES256-SHA" +# define TLS1_TXT_DH_RSA_WITH_AES_256_SHA "DH-RSA-AES256-SHA" +# define TLS1_TXT_DHE_DSS_WITH_AES_256_SHA "DHE-DSS-AES256-SHA" +# define TLS1_TXT_DHE_RSA_WITH_AES_256_SHA "DHE-RSA-AES256-SHA" +# define TLS1_TXT_ADH_WITH_AES_256_SHA "ADH-AES256-SHA" + +/* ECC ciphersuites from RFC4492 */ +# define TLS1_TXT_ECDH_ECDSA_WITH_NULL_SHA "ECDH-ECDSA-NULL-SHA" +# define TLS1_TXT_ECDH_ECDSA_WITH_RC4_128_SHA "ECDH-ECDSA-RC4-SHA" +# define TLS1_TXT_ECDH_ECDSA_WITH_DES_192_CBC3_SHA "ECDH-ECDSA-DES-CBC3-SHA" +# define TLS1_TXT_ECDH_ECDSA_WITH_AES_128_CBC_SHA "ECDH-ECDSA-AES128-SHA" +# define TLS1_TXT_ECDH_ECDSA_WITH_AES_256_CBC_SHA "ECDH-ECDSA-AES256-SHA" + +# define TLS1_TXT_ECDHE_ECDSA_WITH_NULL_SHA "ECDHE-ECDSA-NULL-SHA" +# define TLS1_TXT_ECDHE_ECDSA_WITH_RC4_128_SHA "ECDHE-ECDSA-RC4-SHA" +# define TLS1_TXT_ECDHE_ECDSA_WITH_DES_192_CBC3_SHA "ECDHE-ECDSA-DES-CBC3-SHA" +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_CBC_SHA "ECDHE-ECDSA-AES128-SHA" +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_CBC_SHA "ECDHE-ECDSA-AES256-SHA" + +# define TLS1_TXT_ECDH_RSA_WITH_NULL_SHA "ECDH-RSA-NULL-SHA" +# define TLS1_TXT_ECDH_RSA_WITH_RC4_128_SHA "ECDH-RSA-RC4-SHA" +# define TLS1_TXT_ECDH_RSA_WITH_DES_192_CBC3_SHA "ECDH-RSA-DES-CBC3-SHA" +# define TLS1_TXT_ECDH_RSA_WITH_AES_128_CBC_SHA "ECDH-RSA-AES128-SHA" +# define TLS1_TXT_ECDH_RSA_WITH_AES_256_CBC_SHA "ECDH-RSA-AES256-SHA" + +# define TLS1_TXT_ECDHE_RSA_WITH_NULL_SHA "ECDHE-RSA-NULL-SHA" +# define TLS1_TXT_ECDHE_RSA_WITH_RC4_128_SHA "ECDHE-RSA-RC4-SHA" +# define TLS1_TXT_ECDHE_RSA_WITH_DES_192_CBC3_SHA "ECDHE-RSA-DES-CBC3-SHA" +# define TLS1_TXT_ECDHE_RSA_WITH_AES_128_CBC_SHA "ECDHE-RSA-AES128-SHA" +# define TLS1_TXT_ECDHE_RSA_WITH_AES_256_CBC_SHA "ECDHE-RSA-AES256-SHA" + +# define TLS1_TXT_ECDH_anon_WITH_NULL_SHA "AECDH-NULL-SHA" +# define TLS1_TXT_ECDH_anon_WITH_RC4_128_SHA "AECDH-RC4-SHA" +# define TLS1_TXT_ECDH_anon_WITH_DES_192_CBC3_SHA "AECDH-DES-CBC3-SHA" +# define TLS1_TXT_ECDH_anon_WITH_AES_128_CBC_SHA "AECDH-AES128-SHA" +# define TLS1_TXT_ECDH_anon_WITH_AES_256_CBC_SHA "AECDH-AES256-SHA" + +/* PSK ciphersuites from RFC 4279 */ +# define TLS1_TXT_PSK_WITH_RC4_128_SHA "PSK-RC4-SHA" +# define TLS1_TXT_PSK_WITH_3DES_EDE_CBC_SHA "PSK-3DES-EDE-CBC-SHA" +# define TLS1_TXT_PSK_WITH_AES_128_CBC_SHA "PSK-AES128-CBC-SHA" +# define TLS1_TXT_PSK_WITH_AES_256_CBC_SHA "PSK-AES256-CBC-SHA" + +# define TLS1_TXT_DHE_PSK_WITH_RC4_128_SHA "DHE-PSK-RC4-SHA" +# define TLS1_TXT_DHE_PSK_WITH_3DES_EDE_CBC_SHA "DHE-PSK-3DES-EDE-CBC-SHA" +# define TLS1_TXT_DHE_PSK_WITH_AES_128_CBC_SHA "DHE-PSK-AES128-CBC-SHA" +# define TLS1_TXT_DHE_PSK_WITH_AES_256_CBC_SHA "DHE-PSK-AES256-CBC-SHA" +# define TLS1_TXT_RSA_PSK_WITH_RC4_128_SHA "RSA-PSK-RC4-SHA" +# define TLS1_TXT_RSA_PSK_WITH_3DES_EDE_CBC_SHA "RSA-PSK-3DES-EDE-CBC-SHA" +# define TLS1_TXT_RSA_PSK_WITH_AES_128_CBC_SHA "RSA-PSK-AES128-CBC-SHA" +# define TLS1_TXT_RSA_PSK_WITH_AES_256_CBC_SHA "RSA-PSK-AES256-CBC-SHA" + +/* PSK ciphersuites from RFC 5487 */ +# define TLS1_TXT_PSK_WITH_AES_128_GCM_SHA256 "PSK-AES128-GCM-SHA256" +# define TLS1_TXT_PSK_WITH_AES_256_GCM_SHA384 "PSK-AES256-GCM-SHA384" +# define TLS1_TXT_DHE_PSK_WITH_AES_128_GCM_SHA256 "DHE-PSK-AES128-GCM-SHA256" +# define TLS1_TXT_DHE_PSK_WITH_AES_256_GCM_SHA384 "DHE-PSK-AES256-GCM-SHA384" +# define TLS1_TXT_RSA_PSK_WITH_AES_128_GCM_SHA256 "RSA-PSK-AES128-GCM-SHA256" +# define TLS1_TXT_RSA_PSK_WITH_AES_256_GCM_SHA384 "RSA-PSK-AES256-GCM-SHA384" + +# define TLS1_TXT_PSK_WITH_AES_128_CBC_SHA256 "PSK-AES128-CBC-SHA256" +# define TLS1_TXT_PSK_WITH_AES_256_CBC_SHA384 "PSK-AES256-CBC-SHA384" +# define TLS1_TXT_PSK_WITH_NULL_SHA256 "PSK-NULL-SHA256" +# define TLS1_TXT_PSK_WITH_NULL_SHA384 "PSK-NULL-SHA384" + +# define TLS1_TXT_DHE_PSK_WITH_AES_128_CBC_SHA256 "DHE-PSK-AES128-CBC-SHA256" +# define TLS1_TXT_DHE_PSK_WITH_AES_256_CBC_SHA384 "DHE-PSK-AES256-CBC-SHA384" +# define TLS1_TXT_DHE_PSK_WITH_NULL_SHA256 "DHE-PSK-NULL-SHA256" +# define TLS1_TXT_DHE_PSK_WITH_NULL_SHA384 "DHE-PSK-NULL-SHA384" + +# define TLS1_TXT_RSA_PSK_WITH_AES_128_CBC_SHA256 "RSA-PSK-AES128-CBC-SHA256" +# define TLS1_TXT_RSA_PSK_WITH_AES_256_CBC_SHA384 "RSA-PSK-AES256-CBC-SHA384" +# define TLS1_TXT_RSA_PSK_WITH_NULL_SHA256 "RSA-PSK-NULL-SHA256" +# define TLS1_TXT_RSA_PSK_WITH_NULL_SHA384 "RSA-PSK-NULL-SHA384" + +/* SRP ciphersuite from RFC 5054 */ +# define TLS1_TXT_SRP_SHA_WITH_3DES_EDE_CBC_SHA "SRP-3DES-EDE-CBC-SHA" +# define TLS1_TXT_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA "SRP-RSA-3DES-EDE-CBC-SHA" +# define TLS1_TXT_SRP_SHA_DSS_WITH_3DES_EDE_CBC_SHA "SRP-DSS-3DES-EDE-CBC-SHA" +# define TLS1_TXT_SRP_SHA_WITH_AES_128_CBC_SHA "SRP-AES-128-CBC-SHA" +# define TLS1_TXT_SRP_SHA_RSA_WITH_AES_128_CBC_SHA "SRP-RSA-AES-128-CBC-SHA" +# define TLS1_TXT_SRP_SHA_DSS_WITH_AES_128_CBC_SHA "SRP-DSS-AES-128-CBC-SHA" +# define TLS1_TXT_SRP_SHA_WITH_AES_256_CBC_SHA "SRP-AES-256-CBC-SHA" +# define TLS1_TXT_SRP_SHA_RSA_WITH_AES_256_CBC_SHA "SRP-RSA-AES-256-CBC-SHA" +# define TLS1_TXT_SRP_SHA_DSS_WITH_AES_256_CBC_SHA "SRP-DSS-AES-256-CBC-SHA" + +/* Camellia ciphersuites from RFC4132 */ +# define TLS1_TXT_RSA_WITH_CAMELLIA_128_CBC_SHA "CAMELLIA128-SHA" +# define TLS1_TXT_DH_DSS_WITH_CAMELLIA_128_CBC_SHA "DH-DSS-CAMELLIA128-SHA" +# define TLS1_TXT_DH_RSA_WITH_CAMELLIA_128_CBC_SHA "DH-RSA-CAMELLIA128-SHA" +# define TLS1_TXT_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA "DHE-DSS-CAMELLIA128-SHA" +# define TLS1_TXT_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA "DHE-RSA-CAMELLIA128-SHA" +# define TLS1_TXT_ADH_WITH_CAMELLIA_128_CBC_SHA "ADH-CAMELLIA128-SHA" + +# define TLS1_TXT_RSA_WITH_CAMELLIA_256_CBC_SHA "CAMELLIA256-SHA" +# define TLS1_TXT_DH_DSS_WITH_CAMELLIA_256_CBC_SHA "DH-DSS-CAMELLIA256-SHA" +# define TLS1_TXT_DH_RSA_WITH_CAMELLIA_256_CBC_SHA "DH-RSA-CAMELLIA256-SHA" +# define TLS1_TXT_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA "DHE-DSS-CAMELLIA256-SHA" +# define TLS1_TXT_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA "DHE-RSA-CAMELLIA256-SHA" +# define TLS1_TXT_ADH_WITH_CAMELLIA_256_CBC_SHA "ADH-CAMELLIA256-SHA" + +/* TLS 1.2 Camellia SHA-256 ciphersuites from RFC5932 */ +# define TLS1_TXT_RSA_WITH_CAMELLIA_128_CBC_SHA256 "CAMELLIA128-SHA256" +# define TLS1_TXT_DH_DSS_WITH_CAMELLIA_128_CBC_SHA256 "DH-DSS-CAMELLIA128-SHA256" +# define TLS1_TXT_DH_RSA_WITH_CAMELLIA_128_CBC_SHA256 "DH-RSA-CAMELLIA128-SHA256" +# define TLS1_TXT_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA256 "DHE-DSS-CAMELLIA128-SHA256" +# define TLS1_TXT_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 "DHE-RSA-CAMELLIA128-SHA256" +# define TLS1_TXT_ADH_WITH_CAMELLIA_128_CBC_SHA256 "ADH-CAMELLIA128-SHA256" + +# define TLS1_TXT_RSA_WITH_CAMELLIA_256_CBC_SHA256 "CAMELLIA256-SHA256" +# define TLS1_TXT_DH_DSS_WITH_CAMELLIA_256_CBC_SHA256 "DH-DSS-CAMELLIA256-SHA256" +# define TLS1_TXT_DH_RSA_WITH_CAMELLIA_256_CBC_SHA256 "DH-RSA-CAMELLIA256-SHA256" +# define TLS1_TXT_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA256 "DHE-DSS-CAMELLIA256-SHA256" +# define TLS1_TXT_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 "DHE-RSA-CAMELLIA256-SHA256" +# define TLS1_TXT_ADH_WITH_CAMELLIA_256_CBC_SHA256 "ADH-CAMELLIA256-SHA256" + +# define TLS1_TXT_PSK_WITH_CAMELLIA_128_CBC_SHA256 "PSK-CAMELLIA128-SHA256" +# define TLS1_TXT_PSK_WITH_CAMELLIA_256_CBC_SHA384 "PSK-CAMELLIA256-SHA384" +# define TLS1_TXT_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 "DHE-PSK-CAMELLIA128-SHA256" +# define TLS1_TXT_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 "DHE-PSK-CAMELLIA256-SHA384" +# define TLS1_TXT_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 "RSA-PSK-CAMELLIA128-SHA256" +# define TLS1_TXT_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 "RSA-PSK-CAMELLIA256-SHA384" +# define TLS1_TXT_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 "ECDHE-PSK-CAMELLIA128-SHA256" +# define TLS1_TXT_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 "ECDHE-PSK-CAMELLIA256-SHA384" + +/* SEED ciphersuites from RFC4162 */ +# define TLS1_TXT_RSA_WITH_SEED_SHA "SEED-SHA" +# define TLS1_TXT_DH_DSS_WITH_SEED_SHA "DH-DSS-SEED-SHA" +# define TLS1_TXT_DH_RSA_WITH_SEED_SHA "DH-RSA-SEED-SHA" +# define TLS1_TXT_DHE_DSS_WITH_SEED_SHA "DHE-DSS-SEED-SHA" +# define TLS1_TXT_DHE_RSA_WITH_SEED_SHA "DHE-RSA-SEED-SHA" +# define TLS1_TXT_ADH_WITH_SEED_SHA "ADH-SEED-SHA" + +/* TLS v1.2 ciphersuites */ +# define TLS1_TXT_RSA_WITH_NULL_SHA256 "NULL-SHA256" +# define TLS1_TXT_RSA_WITH_AES_128_SHA256 "AES128-SHA256" +# define TLS1_TXT_RSA_WITH_AES_256_SHA256 "AES256-SHA256" +# define TLS1_TXT_DH_DSS_WITH_AES_128_SHA256 "DH-DSS-AES128-SHA256" +# define TLS1_TXT_DH_RSA_WITH_AES_128_SHA256 "DH-RSA-AES128-SHA256" +# define TLS1_TXT_DHE_DSS_WITH_AES_128_SHA256 "DHE-DSS-AES128-SHA256" +# define TLS1_TXT_DHE_RSA_WITH_AES_128_SHA256 "DHE-RSA-AES128-SHA256" +# define TLS1_TXT_DH_DSS_WITH_AES_256_SHA256 "DH-DSS-AES256-SHA256" +# define TLS1_TXT_DH_RSA_WITH_AES_256_SHA256 "DH-RSA-AES256-SHA256" +# define TLS1_TXT_DHE_DSS_WITH_AES_256_SHA256 "DHE-DSS-AES256-SHA256" +# define TLS1_TXT_DHE_RSA_WITH_AES_256_SHA256 "DHE-RSA-AES256-SHA256" +# define TLS1_TXT_ADH_WITH_AES_128_SHA256 "ADH-AES128-SHA256" +# define TLS1_TXT_ADH_WITH_AES_256_SHA256 "ADH-AES256-SHA256" + +/* TLS v1.2 GCM ciphersuites from RFC5288 */ +# define TLS1_TXT_RSA_WITH_AES_128_GCM_SHA256 "AES128-GCM-SHA256" +# define TLS1_TXT_RSA_WITH_AES_256_GCM_SHA384 "AES256-GCM-SHA384" +# define TLS1_TXT_DHE_RSA_WITH_AES_128_GCM_SHA256 "DHE-RSA-AES128-GCM-SHA256" +# define TLS1_TXT_DHE_RSA_WITH_AES_256_GCM_SHA384 "DHE-RSA-AES256-GCM-SHA384" +# define TLS1_TXT_DH_RSA_WITH_AES_128_GCM_SHA256 "DH-RSA-AES128-GCM-SHA256" +# define TLS1_TXT_DH_RSA_WITH_AES_256_GCM_SHA384 "DH-RSA-AES256-GCM-SHA384" +# define TLS1_TXT_DHE_DSS_WITH_AES_128_GCM_SHA256 "DHE-DSS-AES128-GCM-SHA256" +# define TLS1_TXT_DHE_DSS_WITH_AES_256_GCM_SHA384 "DHE-DSS-AES256-GCM-SHA384" +# define TLS1_TXT_DH_DSS_WITH_AES_128_GCM_SHA256 "DH-DSS-AES128-GCM-SHA256" +# define TLS1_TXT_DH_DSS_WITH_AES_256_GCM_SHA384 "DH-DSS-AES256-GCM-SHA384" +# define TLS1_TXT_ADH_WITH_AES_128_GCM_SHA256 "ADH-AES128-GCM-SHA256" +# define TLS1_TXT_ADH_WITH_AES_256_GCM_SHA384 "ADH-AES256-GCM-SHA384" + +/* CCM ciphersuites from RFC6655 */ +# define TLS1_TXT_RSA_WITH_AES_128_CCM "AES128-CCM" +# define TLS1_TXT_RSA_WITH_AES_256_CCM "AES256-CCM" +# define TLS1_TXT_DHE_RSA_WITH_AES_128_CCM "DHE-RSA-AES128-CCM" +# define TLS1_TXT_DHE_RSA_WITH_AES_256_CCM "DHE-RSA-AES256-CCM" + +# define TLS1_TXT_RSA_WITH_AES_128_CCM_8 "AES128-CCM8" +# define TLS1_TXT_RSA_WITH_AES_256_CCM_8 "AES256-CCM8" +# define TLS1_TXT_DHE_RSA_WITH_AES_128_CCM_8 "DHE-RSA-AES128-CCM8" +# define TLS1_TXT_DHE_RSA_WITH_AES_256_CCM_8 "DHE-RSA-AES256-CCM8" + +# define TLS1_TXT_PSK_WITH_AES_128_CCM "PSK-AES128-CCM" +# define TLS1_TXT_PSK_WITH_AES_256_CCM "PSK-AES256-CCM" +# define TLS1_TXT_DHE_PSK_WITH_AES_128_CCM "DHE-PSK-AES128-CCM" +# define TLS1_TXT_DHE_PSK_WITH_AES_256_CCM "DHE-PSK-AES256-CCM" + +# define TLS1_TXT_PSK_WITH_AES_128_CCM_8 "PSK-AES128-CCM8" +# define TLS1_TXT_PSK_WITH_AES_256_CCM_8 "PSK-AES256-CCM8" +# define TLS1_TXT_DHE_PSK_WITH_AES_128_CCM_8 "DHE-PSK-AES128-CCM8" +# define TLS1_TXT_DHE_PSK_WITH_AES_256_CCM_8 "DHE-PSK-AES256-CCM8" + +/* CCM ciphersuites from RFC7251 */ +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_CCM "ECDHE-ECDSA-AES128-CCM" +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_CCM "ECDHE-ECDSA-AES256-CCM" +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_CCM_8 "ECDHE-ECDSA-AES128-CCM8" +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_CCM_8 "ECDHE-ECDSA-AES256-CCM8" + +/* ECDH HMAC based ciphersuites from RFC5289 */ +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_SHA256 "ECDHE-ECDSA-AES128-SHA256" +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_SHA384 "ECDHE-ECDSA-AES256-SHA384" +# define TLS1_TXT_ECDH_ECDSA_WITH_AES_128_SHA256 "ECDH-ECDSA-AES128-SHA256" +# define TLS1_TXT_ECDH_ECDSA_WITH_AES_256_SHA384 "ECDH-ECDSA-AES256-SHA384" +# define TLS1_TXT_ECDHE_RSA_WITH_AES_128_SHA256 "ECDHE-RSA-AES128-SHA256" +# define TLS1_TXT_ECDHE_RSA_WITH_AES_256_SHA384 "ECDHE-RSA-AES256-SHA384" +# define TLS1_TXT_ECDH_RSA_WITH_AES_128_SHA256 "ECDH-RSA-AES128-SHA256" +# define TLS1_TXT_ECDH_RSA_WITH_AES_256_SHA384 "ECDH-RSA-AES256-SHA384" + +/* ECDH GCM based ciphersuites from RFC5289 */ +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 "ECDHE-ECDSA-AES128-GCM-SHA256" +# define TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 "ECDHE-ECDSA-AES256-GCM-SHA384" +# define TLS1_TXT_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 "ECDH-ECDSA-AES128-GCM-SHA256" +# define TLS1_TXT_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 "ECDH-ECDSA-AES256-GCM-SHA384" +# define TLS1_TXT_ECDHE_RSA_WITH_AES_128_GCM_SHA256 "ECDHE-RSA-AES128-GCM-SHA256" +# define TLS1_TXT_ECDHE_RSA_WITH_AES_256_GCM_SHA384 "ECDHE-RSA-AES256-GCM-SHA384" +# define TLS1_TXT_ECDH_RSA_WITH_AES_128_GCM_SHA256 "ECDH-RSA-AES128-GCM-SHA256" +# define TLS1_TXT_ECDH_RSA_WITH_AES_256_GCM_SHA384 "ECDH-RSA-AES256-GCM-SHA384" + +/* TLS v1.2 PSK GCM ciphersuites from RFC5487 */ +# define TLS1_TXT_PSK_WITH_AES_128_GCM_SHA256 "PSK-AES128-GCM-SHA256" +# define TLS1_TXT_PSK_WITH_AES_256_GCM_SHA384 "PSK-AES256-GCM-SHA384" + +/* ECDHE PSK ciphersuites from RFC 5489 */ +# define TLS1_TXT_ECDHE_PSK_WITH_RC4_128_SHA "ECDHE-PSK-RC4-SHA" +# define TLS1_TXT_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA "ECDHE-PSK-3DES-EDE-CBC-SHA" +# define TLS1_TXT_ECDHE_PSK_WITH_AES_128_CBC_SHA "ECDHE-PSK-AES128-CBC-SHA" +# define TLS1_TXT_ECDHE_PSK_WITH_AES_256_CBC_SHA "ECDHE-PSK-AES256-CBC-SHA" + +# define TLS1_TXT_ECDHE_PSK_WITH_AES_128_CBC_SHA256 "ECDHE-PSK-AES128-CBC-SHA256" +# define TLS1_TXT_ECDHE_PSK_WITH_AES_256_CBC_SHA384 "ECDHE-PSK-AES256-CBC-SHA384" + +# define TLS1_TXT_ECDHE_PSK_WITH_NULL_SHA "ECDHE-PSK-NULL-SHA" +# define TLS1_TXT_ECDHE_PSK_WITH_NULL_SHA256 "ECDHE-PSK-NULL-SHA256" +# define TLS1_TXT_ECDHE_PSK_WITH_NULL_SHA384 "ECDHE-PSK-NULL-SHA384" + +/* Camellia-CBC ciphersuites from RFC6367 */ +# define TLS1_TXT_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 "ECDHE-ECDSA-CAMELLIA128-SHA256" +# define TLS1_TXT_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 "ECDHE-ECDSA-CAMELLIA256-SHA384" +# define TLS1_TXT_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 "ECDH-ECDSA-CAMELLIA128-SHA256" +# define TLS1_TXT_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 "ECDH-ECDSA-CAMELLIA256-SHA384" +# define TLS1_TXT_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 "ECDHE-RSA-CAMELLIA128-SHA256" +# define TLS1_TXT_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 "ECDHE-RSA-CAMELLIA256-SHA384" +# define TLS1_TXT_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 "ECDH-RSA-CAMELLIA128-SHA256" +# define TLS1_TXT_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 "ECDH-RSA-CAMELLIA256-SHA384" + +/* draft-ietf-tls-chacha20-poly1305-03 */ +# define TLS1_TXT_ECDHE_RSA_WITH_CHACHA20_POLY1305 "ECDHE-RSA-CHACHA20-POLY1305" +# define TLS1_TXT_ECDHE_ECDSA_WITH_CHACHA20_POLY1305 "ECDHE-ECDSA-CHACHA20-POLY1305" +# define TLS1_TXT_DHE_RSA_WITH_CHACHA20_POLY1305 "DHE-RSA-CHACHA20-POLY1305" +# define TLS1_TXT_PSK_WITH_CHACHA20_POLY1305 "PSK-CHACHA20-POLY1305" +# define TLS1_TXT_ECDHE_PSK_WITH_CHACHA20_POLY1305 "ECDHE-PSK-CHACHA20-POLY1305" +# define TLS1_TXT_DHE_PSK_WITH_CHACHA20_POLY1305 "DHE-PSK-CHACHA20-POLY1305" +# define TLS1_TXT_RSA_PSK_WITH_CHACHA20_POLY1305 "RSA-PSK-CHACHA20-POLY1305" + +/* Aria ciphersuites from RFC6209 */ +# define TLS1_TXT_RSA_WITH_ARIA_128_GCM_SHA256 "ARIA128-GCM-SHA256" +# define TLS1_TXT_RSA_WITH_ARIA_256_GCM_SHA384 "ARIA256-GCM-SHA384" +# define TLS1_TXT_DHE_RSA_WITH_ARIA_128_GCM_SHA256 "DHE-RSA-ARIA128-GCM-SHA256" +# define TLS1_TXT_DHE_RSA_WITH_ARIA_256_GCM_SHA384 "DHE-RSA-ARIA256-GCM-SHA384" +# define TLS1_TXT_DH_RSA_WITH_ARIA_128_GCM_SHA256 "DH-RSA-ARIA128-GCM-SHA256" +# define TLS1_TXT_DH_RSA_WITH_ARIA_256_GCM_SHA384 "DH-RSA-ARIA256-GCM-SHA384" +# define TLS1_TXT_DHE_DSS_WITH_ARIA_128_GCM_SHA256 "DHE-DSS-ARIA128-GCM-SHA256" +# define TLS1_TXT_DHE_DSS_WITH_ARIA_256_GCM_SHA384 "DHE-DSS-ARIA256-GCM-SHA384" +# define TLS1_TXT_DH_DSS_WITH_ARIA_128_GCM_SHA256 "DH-DSS-ARIA128-GCM-SHA256" +# define TLS1_TXT_DH_DSS_WITH_ARIA_256_GCM_SHA384 "DH-DSS-ARIA256-GCM-SHA384" +# define TLS1_TXT_DH_anon_WITH_ARIA_128_GCM_SHA256 "ADH-ARIA128-GCM-SHA256" +# define TLS1_TXT_DH_anon_WITH_ARIA_256_GCM_SHA384 "ADH-ARIA256-GCM-SHA384" +# define TLS1_TXT_ECDHE_ECDSA_WITH_ARIA_128_GCM_SHA256 "ECDHE-ECDSA-ARIA128-GCM-SHA256" +# define TLS1_TXT_ECDHE_ECDSA_WITH_ARIA_256_GCM_SHA384 "ECDHE-ECDSA-ARIA256-GCM-SHA384" +# define TLS1_TXT_ECDH_ECDSA_WITH_ARIA_128_GCM_SHA256 "ECDH-ECDSA-ARIA128-GCM-SHA256" +# define TLS1_TXT_ECDH_ECDSA_WITH_ARIA_256_GCM_SHA384 "ECDH-ECDSA-ARIA256-GCM-SHA384" +# define TLS1_TXT_ECDHE_RSA_WITH_ARIA_128_GCM_SHA256 "ECDHE-ARIA128-GCM-SHA256" +# define TLS1_TXT_ECDHE_RSA_WITH_ARIA_256_GCM_SHA384 "ECDHE-ARIA256-GCM-SHA384" +# define TLS1_TXT_ECDH_RSA_WITH_ARIA_128_GCM_SHA256 "ECDH-ARIA128-GCM-SHA256" +# define TLS1_TXT_ECDH_RSA_WITH_ARIA_256_GCM_SHA384 "ECDH-ARIA256-GCM-SHA384" +# define TLS1_TXT_PSK_WITH_ARIA_128_GCM_SHA256 "PSK-ARIA128-GCM-SHA256" +# define TLS1_TXT_PSK_WITH_ARIA_256_GCM_SHA384 "PSK-ARIA256-GCM-SHA384" +# define TLS1_TXT_DHE_PSK_WITH_ARIA_128_GCM_SHA256 "DHE-PSK-ARIA128-GCM-SHA256" +# define TLS1_TXT_DHE_PSK_WITH_ARIA_256_GCM_SHA384 "DHE-PSK-ARIA256-GCM-SHA384" +# define TLS1_TXT_RSA_PSK_WITH_ARIA_128_GCM_SHA256 "RSA-PSK-ARIA128-GCM-SHA256" +# define TLS1_TXT_RSA_PSK_WITH_ARIA_256_GCM_SHA384 "RSA-PSK-ARIA256-GCM-SHA384" + +# define TLS_CT_RSA_SIGN 1 +# define TLS_CT_DSS_SIGN 2 +# define TLS_CT_RSA_FIXED_DH 3 +# define TLS_CT_DSS_FIXED_DH 4 +# define TLS_CT_ECDSA_SIGN 64 +# define TLS_CT_RSA_FIXED_ECDH 65 +# define TLS_CT_ECDSA_FIXED_ECDH 66 +# define TLS_CT_GOST01_SIGN 22 +# define TLS_CT_GOST12_SIGN 238 +# define TLS_CT_GOST12_512_SIGN 239 + +/* + * when correcting this number, correct also SSL3_CT_NUMBER in ssl3.h (see + * comment there) + */ +# define TLS_CT_NUMBER 10 + +# if defined(SSL3_CT_NUMBER) +# if TLS_CT_NUMBER != SSL3_CT_NUMBER +# error "SSL/TLS CT_NUMBER values do not match" +# endif +# endif + +# define TLS1_FINISH_MAC_LENGTH 12 + +# define TLS_MD_MAX_CONST_SIZE 22 +# define TLS_MD_CLIENT_FINISH_CONST "client finished" +# define TLS_MD_CLIENT_FINISH_CONST_SIZE 15 +# define TLS_MD_SERVER_FINISH_CONST "server finished" +# define TLS_MD_SERVER_FINISH_CONST_SIZE 15 +# define TLS_MD_KEY_EXPANSION_CONST "key expansion" +# define TLS_MD_KEY_EXPANSION_CONST_SIZE 13 +# define TLS_MD_CLIENT_WRITE_KEY_CONST "client write key" +# define TLS_MD_CLIENT_WRITE_KEY_CONST_SIZE 16 +# define TLS_MD_SERVER_WRITE_KEY_CONST "server write key" +# define TLS_MD_SERVER_WRITE_KEY_CONST_SIZE 16 +# define TLS_MD_IV_BLOCK_CONST "IV block" +# define TLS_MD_IV_BLOCK_CONST_SIZE 8 +# define TLS_MD_MASTER_SECRET_CONST "master secret" +# define TLS_MD_MASTER_SECRET_CONST_SIZE 13 +# define TLS_MD_EXTENDED_MASTER_SECRET_CONST "extended master secret" +# define TLS_MD_EXTENDED_MASTER_SECRET_CONST_SIZE 22 + +# ifdef CHARSET_EBCDIC +# undef TLS_MD_CLIENT_FINISH_CONST +/* + * client finished + */ +# define TLS_MD_CLIENT_FINISH_CONST "\x63\x6c\x69\x65\x6e\x74\x20\x66\x69\x6e\x69\x73\x68\x65\x64" + +# undef TLS_MD_SERVER_FINISH_CONST +/* + * server finished + */ +# define TLS_MD_SERVER_FINISH_CONST "\x73\x65\x72\x76\x65\x72\x20\x66\x69\x6e\x69\x73\x68\x65\x64" + +# undef TLS_MD_SERVER_WRITE_KEY_CONST +/* + * server write key + */ +# define TLS_MD_SERVER_WRITE_KEY_CONST "\x73\x65\x72\x76\x65\x72\x20\x77\x72\x69\x74\x65\x20\x6b\x65\x79" + +# undef TLS_MD_KEY_EXPANSION_CONST +/* + * key expansion + */ +# define TLS_MD_KEY_EXPANSION_CONST "\x6b\x65\x79\x20\x65\x78\x70\x61\x6e\x73\x69\x6f\x6e" + +# undef TLS_MD_CLIENT_WRITE_KEY_CONST +/* + * client write key + */ +# define TLS_MD_CLIENT_WRITE_KEY_CONST "\x63\x6c\x69\x65\x6e\x74\x20\x77\x72\x69\x74\x65\x20\x6b\x65\x79" + +# undef TLS_MD_SERVER_WRITE_KEY_CONST +/* + * server write key + */ +# define TLS_MD_SERVER_WRITE_KEY_CONST "\x73\x65\x72\x76\x65\x72\x20\x77\x72\x69\x74\x65\x20\x6b\x65\x79" + +# undef TLS_MD_IV_BLOCK_CONST +/* + * IV block + */ +# define TLS_MD_IV_BLOCK_CONST "\x49\x56\x20\x62\x6c\x6f\x63\x6b" + +# undef TLS_MD_MASTER_SECRET_CONST +/* + * master secret + */ +# define TLS_MD_MASTER_SECRET_CONST "\x6d\x61\x73\x74\x65\x72\x20\x73\x65\x63\x72\x65\x74" +# undef TLS_MD_EXTENDED_MASTER_SECRET_CONST +/* + * extended master secret + */ +# define TLS_MD_EXTENDED_MASTER_SECRET_CONST "\x65\x78\x74\x65\x63\x64\x65\x64\x20\x6d\x61\x73\x74\x65\x72\x20\x73\x65\x63\x72\x65\x74" +# endif + +/* TLS Session Ticket extension struct */ +struct tls_session_ticket_ext_st { + unsigned short length; + void *data; +}; + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/ts.h b/include/openssl/ts.h new file mode 100644 index 0000000..1b0d101 --- /dev/null +++ b/include/openssl/ts.h @@ -0,0 +1,559 @@ +/* + * Copyright 2006-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_TS_H +# define HEADER_TS_H + +# include + +# ifndef OPENSSL_NO_TS +# include +# include +# include +# include +# include +# include +# include +# include +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +# include +# include + +typedef struct TS_msg_imprint_st TS_MSG_IMPRINT; +typedef struct TS_req_st TS_REQ; +typedef struct TS_accuracy_st TS_ACCURACY; +typedef struct TS_tst_info_st TS_TST_INFO; + +/* Possible values for status. */ +# define TS_STATUS_GRANTED 0 +# define TS_STATUS_GRANTED_WITH_MODS 1 +# define TS_STATUS_REJECTION 2 +# define TS_STATUS_WAITING 3 +# define TS_STATUS_REVOCATION_WARNING 4 +# define TS_STATUS_REVOCATION_NOTIFICATION 5 + +/* Possible values for failure_info. */ +# define TS_INFO_BAD_ALG 0 +# define TS_INFO_BAD_REQUEST 2 +# define TS_INFO_BAD_DATA_FORMAT 5 +# define TS_INFO_TIME_NOT_AVAILABLE 14 +# define TS_INFO_UNACCEPTED_POLICY 15 +# define TS_INFO_UNACCEPTED_EXTENSION 16 +# define TS_INFO_ADD_INFO_NOT_AVAILABLE 17 +# define TS_INFO_SYSTEM_FAILURE 25 + + +typedef struct TS_status_info_st TS_STATUS_INFO; +typedef struct ESS_issuer_serial ESS_ISSUER_SERIAL; +typedef struct ESS_cert_id ESS_CERT_ID; +typedef struct ESS_signing_cert ESS_SIGNING_CERT; + +DEFINE_STACK_OF(ESS_CERT_ID) + +typedef struct ESS_cert_id_v2_st ESS_CERT_ID_V2; +typedef struct ESS_signing_cert_v2_st ESS_SIGNING_CERT_V2; + +DEFINE_STACK_OF(ESS_CERT_ID_V2) + +typedef struct TS_resp_st TS_RESP; + +TS_REQ *TS_REQ_new(void); +void TS_REQ_free(TS_REQ *a); +int i2d_TS_REQ(const TS_REQ *a, unsigned char **pp); +TS_REQ *d2i_TS_REQ(TS_REQ **a, const unsigned char **pp, long length); + +TS_REQ *TS_REQ_dup(TS_REQ *a); + +#ifndef OPENSSL_NO_STDIO +TS_REQ *d2i_TS_REQ_fp(FILE *fp, TS_REQ **a); +int i2d_TS_REQ_fp(FILE *fp, TS_REQ *a); +#endif +TS_REQ *d2i_TS_REQ_bio(BIO *fp, TS_REQ **a); +int i2d_TS_REQ_bio(BIO *fp, TS_REQ *a); + +TS_MSG_IMPRINT *TS_MSG_IMPRINT_new(void); +void TS_MSG_IMPRINT_free(TS_MSG_IMPRINT *a); +int i2d_TS_MSG_IMPRINT(const TS_MSG_IMPRINT *a, unsigned char **pp); +TS_MSG_IMPRINT *d2i_TS_MSG_IMPRINT(TS_MSG_IMPRINT **a, + const unsigned char **pp, long length); + +TS_MSG_IMPRINT *TS_MSG_IMPRINT_dup(TS_MSG_IMPRINT *a); + +#ifndef OPENSSL_NO_STDIO +TS_MSG_IMPRINT *d2i_TS_MSG_IMPRINT_fp(FILE *fp, TS_MSG_IMPRINT **a); +int i2d_TS_MSG_IMPRINT_fp(FILE *fp, TS_MSG_IMPRINT *a); +#endif +TS_MSG_IMPRINT *d2i_TS_MSG_IMPRINT_bio(BIO *bio, TS_MSG_IMPRINT **a); +int i2d_TS_MSG_IMPRINT_bio(BIO *bio, TS_MSG_IMPRINT *a); + +TS_RESP *TS_RESP_new(void); +void TS_RESP_free(TS_RESP *a); +int i2d_TS_RESP(const TS_RESP *a, unsigned char **pp); +TS_RESP *d2i_TS_RESP(TS_RESP **a, const unsigned char **pp, long length); +TS_TST_INFO *PKCS7_to_TS_TST_INFO(PKCS7 *token); +TS_RESP *TS_RESP_dup(TS_RESP *a); + +#ifndef OPENSSL_NO_STDIO +TS_RESP *d2i_TS_RESP_fp(FILE *fp, TS_RESP **a); +int i2d_TS_RESP_fp(FILE *fp, TS_RESP *a); +#endif +TS_RESP *d2i_TS_RESP_bio(BIO *bio, TS_RESP **a); +int i2d_TS_RESP_bio(BIO *bio, TS_RESP *a); + +TS_STATUS_INFO *TS_STATUS_INFO_new(void); +void TS_STATUS_INFO_free(TS_STATUS_INFO *a); +int i2d_TS_STATUS_INFO(const TS_STATUS_INFO *a, unsigned char **pp); +TS_STATUS_INFO *d2i_TS_STATUS_INFO(TS_STATUS_INFO **a, + const unsigned char **pp, long length); +TS_STATUS_INFO *TS_STATUS_INFO_dup(TS_STATUS_INFO *a); + +TS_TST_INFO *TS_TST_INFO_new(void); +void TS_TST_INFO_free(TS_TST_INFO *a); +int i2d_TS_TST_INFO(const TS_TST_INFO *a, unsigned char **pp); +TS_TST_INFO *d2i_TS_TST_INFO(TS_TST_INFO **a, const unsigned char **pp, + long length); +TS_TST_INFO *TS_TST_INFO_dup(TS_TST_INFO *a); + +#ifndef OPENSSL_NO_STDIO +TS_TST_INFO *d2i_TS_TST_INFO_fp(FILE *fp, TS_TST_INFO **a); +int i2d_TS_TST_INFO_fp(FILE *fp, TS_TST_INFO *a); +#endif +TS_TST_INFO *d2i_TS_TST_INFO_bio(BIO *bio, TS_TST_INFO **a); +int i2d_TS_TST_INFO_bio(BIO *bio, TS_TST_INFO *a); + +TS_ACCURACY *TS_ACCURACY_new(void); +void TS_ACCURACY_free(TS_ACCURACY *a); +int i2d_TS_ACCURACY(const TS_ACCURACY *a, unsigned char **pp); +TS_ACCURACY *d2i_TS_ACCURACY(TS_ACCURACY **a, const unsigned char **pp, + long length); +TS_ACCURACY *TS_ACCURACY_dup(TS_ACCURACY *a); + +ESS_ISSUER_SERIAL *ESS_ISSUER_SERIAL_new(void); +void ESS_ISSUER_SERIAL_free(ESS_ISSUER_SERIAL *a); +int i2d_ESS_ISSUER_SERIAL(const ESS_ISSUER_SERIAL *a, unsigned char **pp); +ESS_ISSUER_SERIAL *d2i_ESS_ISSUER_SERIAL(ESS_ISSUER_SERIAL **a, + const unsigned char **pp, + long length); +ESS_ISSUER_SERIAL *ESS_ISSUER_SERIAL_dup(ESS_ISSUER_SERIAL *a); + +ESS_CERT_ID *ESS_CERT_ID_new(void); +void ESS_CERT_ID_free(ESS_CERT_ID *a); +int i2d_ESS_CERT_ID(const ESS_CERT_ID *a, unsigned char **pp); +ESS_CERT_ID *d2i_ESS_CERT_ID(ESS_CERT_ID **a, const unsigned char **pp, + long length); +ESS_CERT_ID *ESS_CERT_ID_dup(ESS_CERT_ID *a); + +ESS_SIGNING_CERT *ESS_SIGNING_CERT_new(void); +void ESS_SIGNING_CERT_free(ESS_SIGNING_CERT *a); +int i2d_ESS_SIGNING_CERT(const ESS_SIGNING_CERT *a, unsigned char **pp); +ESS_SIGNING_CERT *d2i_ESS_SIGNING_CERT(ESS_SIGNING_CERT **a, + const unsigned char **pp, long length); +ESS_SIGNING_CERT *ESS_SIGNING_CERT_dup(ESS_SIGNING_CERT *a); + +ESS_CERT_ID_V2 *ESS_CERT_ID_V2_new(void); +void ESS_CERT_ID_V2_free(ESS_CERT_ID_V2 *a); +int i2d_ESS_CERT_ID_V2(const ESS_CERT_ID_V2 *a, unsigned char **pp); +ESS_CERT_ID_V2 *d2i_ESS_CERT_ID_V2(ESS_CERT_ID_V2 **a, + const unsigned char **pp, long length); +ESS_CERT_ID_V2 *ESS_CERT_ID_V2_dup(ESS_CERT_ID_V2 *a); + +ESS_SIGNING_CERT_V2 *ESS_SIGNING_CERT_V2_new(void); +void ESS_SIGNING_CERT_V2_free(ESS_SIGNING_CERT_V2 *a); +int i2d_ESS_SIGNING_CERT_V2(const ESS_SIGNING_CERT_V2 *a, unsigned char **pp); +ESS_SIGNING_CERT_V2 *d2i_ESS_SIGNING_CERT_V2(ESS_SIGNING_CERT_V2 **a, + const unsigned char **pp, + long length); +ESS_SIGNING_CERT_V2 *ESS_SIGNING_CERT_V2_dup(ESS_SIGNING_CERT_V2 *a); + +int TS_REQ_set_version(TS_REQ *a, long version); +long TS_REQ_get_version(const TS_REQ *a); + +int TS_STATUS_INFO_set_status(TS_STATUS_INFO *a, int i); +const ASN1_INTEGER *TS_STATUS_INFO_get0_status(const TS_STATUS_INFO *a); + +const STACK_OF(ASN1_UTF8STRING) * +TS_STATUS_INFO_get0_text(const TS_STATUS_INFO *a); + +const ASN1_BIT_STRING * +TS_STATUS_INFO_get0_failure_info(const TS_STATUS_INFO *a); + +int TS_REQ_set_msg_imprint(TS_REQ *a, TS_MSG_IMPRINT *msg_imprint); +TS_MSG_IMPRINT *TS_REQ_get_msg_imprint(TS_REQ *a); + +int TS_MSG_IMPRINT_set_algo(TS_MSG_IMPRINT *a, X509_ALGOR *alg); +X509_ALGOR *TS_MSG_IMPRINT_get_algo(TS_MSG_IMPRINT *a); + +int TS_MSG_IMPRINT_set_msg(TS_MSG_IMPRINT *a, unsigned char *d, int len); +ASN1_OCTET_STRING *TS_MSG_IMPRINT_get_msg(TS_MSG_IMPRINT *a); + +int TS_REQ_set_policy_id(TS_REQ *a, const ASN1_OBJECT *policy); +ASN1_OBJECT *TS_REQ_get_policy_id(TS_REQ *a); + +int TS_REQ_set_nonce(TS_REQ *a, const ASN1_INTEGER *nonce); +const ASN1_INTEGER *TS_REQ_get_nonce(const TS_REQ *a); + +int TS_REQ_set_cert_req(TS_REQ *a, int cert_req); +int TS_REQ_get_cert_req(const TS_REQ *a); + +STACK_OF(X509_EXTENSION) *TS_REQ_get_exts(TS_REQ *a); +void TS_REQ_ext_free(TS_REQ *a); +int TS_REQ_get_ext_count(TS_REQ *a); +int TS_REQ_get_ext_by_NID(TS_REQ *a, int nid, int lastpos); +int TS_REQ_get_ext_by_OBJ(TS_REQ *a, const ASN1_OBJECT *obj, int lastpos); +int TS_REQ_get_ext_by_critical(TS_REQ *a, int crit, int lastpos); +X509_EXTENSION *TS_REQ_get_ext(TS_REQ *a, int loc); +X509_EXTENSION *TS_REQ_delete_ext(TS_REQ *a, int loc); +int TS_REQ_add_ext(TS_REQ *a, X509_EXTENSION *ex, int loc); +void *TS_REQ_get_ext_d2i(TS_REQ *a, int nid, int *crit, int *idx); + +/* Function declarations for TS_REQ defined in ts/ts_req_print.c */ + +int TS_REQ_print_bio(BIO *bio, TS_REQ *a); + +/* Function declarations for TS_RESP defined in ts/ts_resp_utils.c */ + +int TS_RESP_set_status_info(TS_RESP *a, TS_STATUS_INFO *info); +TS_STATUS_INFO *TS_RESP_get_status_info(TS_RESP *a); + +/* Caller loses ownership of PKCS7 and TS_TST_INFO objects. */ +void TS_RESP_set_tst_info(TS_RESP *a, PKCS7 *p7, TS_TST_INFO *tst_info); +PKCS7 *TS_RESP_get_token(TS_RESP *a); +TS_TST_INFO *TS_RESP_get_tst_info(TS_RESP *a); + +int TS_TST_INFO_set_version(TS_TST_INFO *a, long version); +long TS_TST_INFO_get_version(const TS_TST_INFO *a); + +int TS_TST_INFO_set_policy_id(TS_TST_INFO *a, ASN1_OBJECT *policy_id); +ASN1_OBJECT *TS_TST_INFO_get_policy_id(TS_TST_INFO *a); + +int TS_TST_INFO_set_msg_imprint(TS_TST_INFO *a, TS_MSG_IMPRINT *msg_imprint); +TS_MSG_IMPRINT *TS_TST_INFO_get_msg_imprint(TS_TST_INFO *a); + +int TS_TST_INFO_set_serial(TS_TST_INFO *a, const ASN1_INTEGER *serial); +const ASN1_INTEGER *TS_TST_INFO_get_serial(const TS_TST_INFO *a); + +int TS_TST_INFO_set_time(TS_TST_INFO *a, const ASN1_GENERALIZEDTIME *gtime); +const ASN1_GENERALIZEDTIME *TS_TST_INFO_get_time(const TS_TST_INFO *a); + +int TS_TST_INFO_set_accuracy(TS_TST_INFO *a, TS_ACCURACY *accuracy); +TS_ACCURACY *TS_TST_INFO_get_accuracy(TS_TST_INFO *a); + +int TS_ACCURACY_set_seconds(TS_ACCURACY *a, const ASN1_INTEGER *seconds); +const ASN1_INTEGER *TS_ACCURACY_get_seconds(const TS_ACCURACY *a); + +int TS_ACCURACY_set_millis(TS_ACCURACY *a, const ASN1_INTEGER *millis); +const ASN1_INTEGER *TS_ACCURACY_get_millis(const TS_ACCURACY *a); + +int TS_ACCURACY_set_micros(TS_ACCURACY *a, const ASN1_INTEGER *micros); +const ASN1_INTEGER *TS_ACCURACY_get_micros(const TS_ACCURACY *a); + +int TS_TST_INFO_set_ordering(TS_TST_INFO *a, int ordering); +int TS_TST_INFO_get_ordering(const TS_TST_INFO *a); + +int TS_TST_INFO_set_nonce(TS_TST_INFO *a, const ASN1_INTEGER *nonce); +const ASN1_INTEGER *TS_TST_INFO_get_nonce(const TS_TST_INFO *a); + +int TS_TST_INFO_set_tsa(TS_TST_INFO *a, GENERAL_NAME *tsa); +GENERAL_NAME *TS_TST_INFO_get_tsa(TS_TST_INFO *a); + +STACK_OF(X509_EXTENSION) *TS_TST_INFO_get_exts(TS_TST_INFO *a); +void TS_TST_INFO_ext_free(TS_TST_INFO *a); +int TS_TST_INFO_get_ext_count(TS_TST_INFO *a); +int TS_TST_INFO_get_ext_by_NID(TS_TST_INFO *a, int nid, int lastpos); +int TS_TST_INFO_get_ext_by_OBJ(TS_TST_INFO *a, const ASN1_OBJECT *obj, + int lastpos); +int TS_TST_INFO_get_ext_by_critical(TS_TST_INFO *a, int crit, int lastpos); +X509_EXTENSION *TS_TST_INFO_get_ext(TS_TST_INFO *a, int loc); +X509_EXTENSION *TS_TST_INFO_delete_ext(TS_TST_INFO *a, int loc); +int TS_TST_INFO_add_ext(TS_TST_INFO *a, X509_EXTENSION *ex, int loc); +void *TS_TST_INFO_get_ext_d2i(TS_TST_INFO *a, int nid, int *crit, int *idx); + +/* + * Declarations related to response generation, defined in ts/ts_resp_sign.c. + */ + +/* Optional flags for response generation. */ + +/* Don't include the TSA name in response. */ +# define TS_TSA_NAME 0x01 + +/* Set ordering to true in response. */ +# define TS_ORDERING 0x02 + +/* + * Include the signer certificate and the other specified certificates in + * the ESS signing certificate attribute beside the PKCS7 signed data. + * Only the signer certificates is included by default. + */ +# define TS_ESS_CERT_ID_CHAIN 0x04 + +/* Forward declaration. */ +struct TS_resp_ctx; + +/* This must return a unique number less than 160 bits long. */ +typedef ASN1_INTEGER *(*TS_serial_cb) (struct TS_resp_ctx *, void *); + +/* + * This must return the seconds and microseconds since Jan 1, 1970 in the sec + * and usec variables allocated by the caller. Return non-zero for success + * and zero for failure. + */ +typedef int (*TS_time_cb) (struct TS_resp_ctx *, void *, long *sec, + long *usec); + +/* + * This must process the given extension. It can modify the TS_TST_INFO + * object of the context. Return values: !0 (processed), 0 (error, it must + * set the status info/failure info of the response). + */ +typedef int (*TS_extension_cb) (struct TS_resp_ctx *, X509_EXTENSION *, + void *); + +typedef struct TS_resp_ctx TS_RESP_CTX; + +DEFINE_STACK_OF_CONST(EVP_MD) + +/* Creates a response context that can be used for generating responses. */ +TS_RESP_CTX *TS_RESP_CTX_new(void); +void TS_RESP_CTX_free(TS_RESP_CTX *ctx); + +/* This parameter must be set. */ +int TS_RESP_CTX_set_signer_cert(TS_RESP_CTX *ctx, X509 *signer); + +/* This parameter must be set. */ +int TS_RESP_CTX_set_signer_key(TS_RESP_CTX *ctx, EVP_PKEY *key); + +int TS_RESP_CTX_set_signer_digest(TS_RESP_CTX *ctx, + const EVP_MD *signer_digest); +int TS_RESP_CTX_set_ess_cert_id_digest(TS_RESP_CTX *ctx, const EVP_MD *md); + +/* This parameter must be set. */ +int TS_RESP_CTX_set_def_policy(TS_RESP_CTX *ctx, const ASN1_OBJECT *def_policy); + +/* No additional certs are included in the response by default. */ +int TS_RESP_CTX_set_certs(TS_RESP_CTX *ctx, STACK_OF(X509) *certs); + +/* + * Adds a new acceptable policy, only the default policy is accepted by + * default. + */ +int TS_RESP_CTX_add_policy(TS_RESP_CTX *ctx, const ASN1_OBJECT *policy); + +/* + * Adds a new acceptable message digest. Note that no message digests are + * accepted by default. The md argument is shared with the caller. + */ +int TS_RESP_CTX_add_md(TS_RESP_CTX *ctx, const EVP_MD *md); + +/* Accuracy is not included by default. */ +int TS_RESP_CTX_set_accuracy(TS_RESP_CTX *ctx, + int secs, int millis, int micros); + +/* + * Clock precision digits, i.e. the number of decimal digits: '0' means sec, + * '3' msec, '6' usec, and so on. Default is 0. + */ +int TS_RESP_CTX_set_clock_precision_digits(TS_RESP_CTX *ctx, + unsigned clock_precision_digits); +/* At most we accept usec precision. */ +# define TS_MAX_CLOCK_PRECISION_DIGITS 6 + +/* Maximum status message length */ +# define TS_MAX_STATUS_LENGTH (1024 * 1024) + +/* No flags are set by default. */ +void TS_RESP_CTX_add_flags(TS_RESP_CTX *ctx, int flags); + +/* Default callback always returns a constant. */ +void TS_RESP_CTX_set_serial_cb(TS_RESP_CTX *ctx, TS_serial_cb cb, void *data); + +/* Default callback uses the gettimeofday() and gmtime() system calls. */ +void TS_RESP_CTX_set_time_cb(TS_RESP_CTX *ctx, TS_time_cb cb, void *data); + +/* + * Default callback rejects all extensions. The extension callback is called + * when the TS_TST_INFO object is already set up and not signed yet. + */ +/* FIXME: extension handling is not tested yet. */ +void TS_RESP_CTX_set_extension_cb(TS_RESP_CTX *ctx, + TS_extension_cb cb, void *data); + +/* The following methods can be used in the callbacks. */ +int TS_RESP_CTX_set_status_info(TS_RESP_CTX *ctx, + int status, const char *text); + +/* Sets the status info only if it is still TS_STATUS_GRANTED. */ +int TS_RESP_CTX_set_status_info_cond(TS_RESP_CTX *ctx, + int status, const char *text); + +int TS_RESP_CTX_add_failure_info(TS_RESP_CTX *ctx, int failure); + +/* The get methods below can be used in the extension callback. */ +TS_REQ *TS_RESP_CTX_get_request(TS_RESP_CTX *ctx); + +TS_TST_INFO *TS_RESP_CTX_get_tst_info(TS_RESP_CTX *ctx); + +/* + * Creates the signed TS_TST_INFO and puts it in TS_RESP. + * In case of errors it sets the status info properly. + * Returns NULL only in case of memory allocation/fatal error. + */ +TS_RESP *TS_RESP_create_response(TS_RESP_CTX *ctx, BIO *req_bio); + +/* + * Declarations related to response verification, + * they are defined in ts/ts_resp_verify.c. + */ + +int TS_RESP_verify_signature(PKCS7 *token, STACK_OF(X509) *certs, + X509_STORE *store, X509 **signer_out); + +/* Context structure for the generic verify method. */ + +/* Verify the signer's certificate and the signature of the response. */ +# define TS_VFY_SIGNATURE (1u << 0) +/* Verify the version number of the response. */ +# define TS_VFY_VERSION (1u << 1) +/* Verify if the policy supplied by the user matches the policy of the TSA. */ +# define TS_VFY_POLICY (1u << 2) +/* + * Verify the message imprint provided by the user. This flag should not be + * specified with TS_VFY_DATA. + */ +# define TS_VFY_IMPRINT (1u << 3) +/* + * Verify the message imprint computed by the verify method from the user + * provided data and the MD algorithm of the response. This flag should not + * be specified with TS_VFY_IMPRINT. + */ +# define TS_VFY_DATA (1u << 4) +/* Verify the nonce value. */ +# define TS_VFY_NONCE (1u << 5) +/* Verify if the TSA name field matches the signer certificate. */ +# define TS_VFY_SIGNER (1u << 6) +/* Verify if the TSA name field equals to the user provided name. */ +# define TS_VFY_TSA_NAME (1u << 7) + +/* You can use the following convenience constants. */ +# define TS_VFY_ALL_IMPRINT (TS_VFY_SIGNATURE \ + | TS_VFY_VERSION \ + | TS_VFY_POLICY \ + | TS_VFY_IMPRINT \ + | TS_VFY_NONCE \ + | TS_VFY_SIGNER \ + | TS_VFY_TSA_NAME) +# define TS_VFY_ALL_DATA (TS_VFY_SIGNATURE \ + | TS_VFY_VERSION \ + | TS_VFY_POLICY \ + | TS_VFY_DATA \ + | TS_VFY_NONCE \ + | TS_VFY_SIGNER \ + | TS_VFY_TSA_NAME) + +typedef struct TS_verify_ctx TS_VERIFY_CTX; + +int TS_RESP_verify_response(TS_VERIFY_CTX *ctx, TS_RESP *response); +int TS_RESP_verify_token(TS_VERIFY_CTX *ctx, PKCS7 *token); + +/* + * Declarations related to response verification context, + */ +TS_VERIFY_CTX *TS_VERIFY_CTX_new(void); +void TS_VERIFY_CTX_init(TS_VERIFY_CTX *ctx); +void TS_VERIFY_CTX_free(TS_VERIFY_CTX *ctx); +void TS_VERIFY_CTX_cleanup(TS_VERIFY_CTX *ctx); +int TS_VERIFY_CTX_set_flags(TS_VERIFY_CTX *ctx, int f); +int TS_VERIFY_CTX_add_flags(TS_VERIFY_CTX *ctx, int f); +BIO *TS_VERIFY_CTX_set_data(TS_VERIFY_CTX *ctx, BIO *b); +unsigned char *TS_VERIFY_CTX_set_imprint(TS_VERIFY_CTX *ctx, + unsigned char *hexstr, long len); +X509_STORE *TS_VERIFY_CTX_set_store(TS_VERIFY_CTX *ctx, X509_STORE *s); +STACK_OF(X509) *TS_VERIFY_CTS_set_certs(TS_VERIFY_CTX *ctx, STACK_OF(X509) *certs); + +/*- + * If ctx is NULL, it allocates and returns a new object, otherwise + * it returns ctx. It initialises all the members as follows: + * flags = TS_VFY_ALL_IMPRINT & ~(TS_VFY_TSA_NAME | TS_VFY_SIGNATURE) + * certs = NULL + * store = NULL + * policy = policy from the request or NULL if absent (in this case + * TS_VFY_POLICY is cleared from flags as well) + * md_alg = MD algorithm from request + * imprint, imprint_len = imprint from request + * data = NULL + * nonce, nonce_len = nonce from the request or NULL if absent (in this case + * TS_VFY_NONCE is cleared from flags as well) + * tsa_name = NULL + * Important: after calling this method TS_VFY_SIGNATURE should be added! + */ +TS_VERIFY_CTX *TS_REQ_to_TS_VERIFY_CTX(TS_REQ *req, TS_VERIFY_CTX *ctx); + +/* Function declarations for TS_RESP defined in ts/ts_resp_print.c */ + +int TS_RESP_print_bio(BIO *bio, TS_RESP *a); +int TS_STATUS_INFO_print_bio(BIO *bio, TS_STATUS_INFO *a); +int TS_TST_INFO_print_bio(BIO *bio, TS_TST_INFO *a); + +/* Common utility functions defined in ts/ts_lib.c */ + +int TS_ASN1_INTEGER_print_bio(BIO *bio, const ASN1_INTEGER *num); +int TS_OBJ_print_bio(BIO *bio, const ASN1_OBJECT *obj); +int TS_ext_print_bio(BIO *bio, const STACK_OF(X509_EXTENSION) *extensions); +int TS_X509_ALGOR_print_bio(BIO *bio, const X509_ALGOR *alg); +int TS_MSG_IMPRINT_print_bio(BIO *bio, TS_MSG_IMPRINT *msg); + +/* + * Function declarations for handling configuration options, defined in + * ts/ts_conf.c + */ + +X509 *TS_CONF_load_cert(const char *file); +STACK_OF(X509) *TS_CONF_load_certs(const char *file); +EVP_PKEY *TS_CONF_load_key(const char *file, const char *pass); +const char *TS_CONF_get_tsa_section(CONF *conf, const char *section); +int TS_CONF_set_serial(CONF *conf, const char *section, TS_serial_cb cb, + TS_RESP_CTX *ctx); +#ifndef OPENSSL_NO_ENGINE +int TS_CONF_set_crypto_device(CONF *conf, const char *section, + const char *device); +int TS_CONF_set_default_engine(const char *name); +#endif +int TS_CONF_set_signer_cert(CONF *conf, const char *section, + const char *cert, TS_RESP_CTX *ctx); +int TS_CONF_set_certs(CONF *conf, const char *section, const char *certs, + TS_RESP_CTX *ctx); +int TS_CONF_set_signer_key(CONF *conf, const char *section, + const char *key, const char *pass, + TS_RESP_CTX *ctx); +int TS_CONF_set_signer_digest(CONF *conf, const char *section, + const char *md, TS_RESP_CTX *ctx); +int TS_CONF_set_def_policy(CONF *conf, const char *section, + const char *policy, TS_RESP_CTX *ctx); +int TS_CONF_set_policies(CONF *conf, const char *section, TS_RESP_CTX *ctx); +int TS_CONF_set_digests(CONF *conf, const char *section, TS_RESP_CTX *ctx); +int TS_CONF_set_accuracy(CONF *conf, const char *section, TS_RESP_CTX *ctx); +int TS_CONF_set_clock_precision_digits(CONF *conf, const char *section, + TS_RESP_CTX *ctx); +int TS_CONF_set_ordering(CONF *conf, const char *section, TS_RESP_CTX *ctx); +int TS_CONF_set_tsa_name(CONF *conf, const char *section, TS_RESP_CTX *ctx); +int TS_CONF_set_ess_cert_id_chain(CONF *conf, const char *section, + TS_RESP_CTX *ctx); +int TS_CONF_set_ess_cert_id_digest(CONF *conf, const char *section, + TS_RESP_CTX *ctx); + +# ifdef __cplusplus +} +# endif +# endif +#endif diff --git a/include/openssl/tserr.h b/include/openssl/tserr.h new file mode 100644 index 0000000..144ef41 --- /dev/null +++ b/include/openssl/tserr.h @@ -0,0 +1,128 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_TSERR_H +# define HEADER_TSERR_H + +# include + +# ifndef OPENSSL_NO_TS + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_TS_strings(void); + +/* + * TS function codes. + */ +# define TS_F_DEF_SERIAL_CB 110 +# define TS_F_DEF_TIME_CB 111 +# define TS_F_ESS_ADD_SIGNING_CERT 112 +# define TS_F_ESS_ADD_SIGNING_CERT_V2 147 +# define TS_F_ESS_CERT_ID_NEW_INIT 113 +# define TS_F_ESS_CERT_ID_V2_NEW_INIT 156 +# define TS_F_ESS_SIGNING_CERT_NEW_INIT 114 +# define TS_F_ESS_SIGNING_CERT_V2_NEW_INIT 157 +# define TS_F_INT_TS_RESP_VERIFY_TOKEN 149 +# define TS_F_PKCS7_TO_TS_TST_INFO 148 +# define TS_F_TS_ACCURACY_SET_MICROS 115 +# define TS_F_TS_ACCURACY_SET_MILLIS 116 +# define TS_F_TS_ACCURACY_SET_SECONDS 117 +# define TS_F_TS_CHECK_IMPRINTS 100 +# define TS_F_TS_CHECK_NONCES 101 +# define TS_F_TS_CHECK_POLICY 102 +# define TS_F_TS_CHECK_SIGNING_CERTS 103 +# define TS_F_TS_CHECK_STATUS_INFO 104 +# define TS_F_TS_COMPUTE_IMPRINT 145 +# define TS_F_TS_CONF_INVALID 151 +# define TS_F_TS_CONF_LOAD_CERT 153 +# define TS_F_TS_CONF_LOAD_CERTS 154 +# define TS_F_TS_CONF_LOAD_KEY 155 +# define TS_F_TS_CONF_LOOKUP_FAIL 152 +# define TS_F_TS_CONF_SET_DEFAULT_ENGINE 146 +# define TS_F_TS_GET_STATUS_TEXT 105 +# define TS_F_TS_MSG_IMPRINT_SET_ALGO 118 +# define TS_F_TS_REQ_SET_MSG_IMPRINT 119 +# define TS_F_TS_REQ_SET_NONCE 120 +# define TS_F_TS_REQ_SET_POLICY_ID 121 +# define TS_F_TS_RESP_CREATE_RESPONSE 122 +# define TS_F_TS_RESP_CREATE_TST_INFO 123 +# define TS_F_TS_RESP_CTX_ADD_FAILURE_INFO 124 +# define TS_F_TS_RESP_CTX_ADD_MD 125 +# define TS_F_TS_RESP_CTX_ADD_POLICY 126 +# define TS_F_TS_RESP_CTX_NEW 127 +# define TS_F_TS_RESP_CTX_SET_ACCURACY 128 +# define TS_F_TS_RESP_CTX_SET_CERTS 129 +# define TS_F_TS_RESP_CTX_SET_DEF_POLICY 130 +# define TS_F_TS_RESP_CTX_SET_SIGNER_CERT 131 +# define TS_F_TS_RESP_CTX_SET_STATUS_INFO 132 +# define TS_F_TS_RESP_GET_POLICY 133 +# define TS_F_TS_RESP_SET_GENTIME_WITH_PRECISION 134 +# define TS_F_TS_RESP_SET_STATUS_INFO 135 +# define TS_F_TS_RESP_SET_TST_INFO 150 +# define TS_F_TS_RESP_SIGN 136 +# define TS_F_TS_RESP_VERIFY_SIGNATURE 106 +# define TS_F_TS_TST_INFO_SET_ACCURACY 137 +# define TS_F_TS_TST_INFO_SET_MSG_IMPRINT 138 +# define TS_F_TS_TST_INFO_SET_NONCE 139 +# define TS_F_TS_TST_INFO_SET_POLICY_ID 140 +# define TS_F_TS_TST_INFO_SET_SERIAL 141 +# define TS_F_TS_TST_INFO_SET_TIME 142 +# define TS_F_TS_TST_INFO_SET_TSA 143 +# define TS_F_TS_VERIFY 108 +# define TS_F_TS_VERIFY_CERT 109 +# define TS_F_TS_VERIFY_CTX_NEW 144 + +/* + * TS reason codes. + */ +# define TS_R_BAD_PKCS7_TYPE 132 +# define TS_R_BAD_TYPE 133 +# define TS_R_CANNOT_LOAD_CERT 137 +# define TS_R_CANNOT_LOAD_KEY 138 +# define TS_R_CERTIFICATE_VERIFY_ERROR 100 +# define TS_R_COULD_NOT_SET_ENGINE 127 +# define TS_R_COULD_NOT_SET_TIME 115 +# define TS_R_DETACHED_CONTENT 134 +# define TS_R_ESS_ADD_SIGNING_CERT_ERROR 116 +# define TS_R_ESS_ADD_SIGNING_CERT_V2_ERROR 139 +# define TS_R_ESS_SIGNING_CERTIFICATE_ERROR 101 +# define TS_R_INVALID_NULL_POINTER 102 +# define TS_R_INVALID_SIGNER_CERTIFICATE_PURPOSE 117 +# define TS_R_MESSAGE_IMPRINT_MISMATCH 103 +# define TS_R_NONCE_MISMATCH 104 +# define TS_R_NONCE_NOT_RETURNED 105 +# define TS_R_NO_CONTENT 106 +# define TS_R_NO_TIME_STAMP_TOKEN 107 +# define TS_R_PKCS7_ADD_SIGNATURE_ERROR 118 +# define TS_R_PKCS7_ADD_SIGNED_ATTR_ERROR 119 +# define TS_R_PKCS7_TO_TS_TST_INFO_FAILED 129 +# define TS_R_POLICY_MISMATCH 108 +# define TS_R_PRIVATE_KEY_DOES_NOT_MATCH_CERTIFICATE 120 +# define TS_R_RESPONSE_SETUP_ERROR 121 +# define TS_R_SIGNATURE_FAILURE 109 +# define TS_R_THERE_MUST_BE_ONE_SIGNER 110 +# define TS_R_TIME_SYSCALL_ERROR 122 +# define TS_R_TOKEN_NOT_PRESENT 130 +# define TS_R_TOKEN_PRESENT 131 +# define TS_R_TSA_NAME_MISMATCH 111 +# define TS_R_TSA_UNTRUSTED 112 +# define TS_R_TST_INFO_SETUP_ERROR 123 +# define TS_R_TS_DATASIGN 124 +# define TS_R_UNACCEPTABLE_POLICY 125 +# define TS_R_UNSUPPORTED_MD_ALGORITHM 126 +# define TS_R_UNSUPPORTED_VERSION 113 +# define TS_R_VAR_BAD_VALUE 135 +# define TS_R_VAR_LOOKUP_FAILURE 136 +# define TS_R_WRONG_CONTENT_TYPE 114 + +# endif +#endif diff --git a/include/openssl/txt_db.h b/include/openssl/txt_db.h new file mode 100644 index 0000000..c26eb1c --- /dev/null +++ b/include/openssl/txt_db.h @@ -0,0 +1,57 @@ +/* + * Copyright 1995-2017 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_TXT_DB_H +# define HEADER_TXT_DB_H + +# include +# include +# include +# include + +# define DB_ERROR_OK 0 +# define DB_ERROR_MALLOC 1 +# define DB_ERROR_INDEX_CLASH 2 +# define DB_ERROR_INDEX_OUT_OF_RANGE 3 +# define DB_ERROR_NO_INDEX 4 +# define DB_ERROR_INSERT_INDEX_CLASH 5 +# define DB_ERROR_WRONG_NUM_FIELDS 6 + +#ifdef __cplusplus +extern "C" { +#endif + +typedef OPENSSL_STRING *OPENSSL_PSTRING; +DEFINE_SPECIAL_STACK_OF(OPENSSL_PSTRING, OPENSSL_STRING) + +typedef struct txt_db_st { + int num_fields; + STACK_OF(OPENSSL_PSTRING) *data; + LHASH_OF(OPENSSL_STRING) **index; + int (**qual) (OPENSSL_STRING *); + long error; + long arg1; + long arg2; + OPENSSL_STRING *arg_row; +} TXT_DB; + +TXT_DB *TXT_DB_read(BIO *in, int num); +long TXT_DB_write(BIO *out, TXT_DB *db); +int TXT_DB_create_index(TXT_DB *db, int field, int (*qual) (OPENSSL_STRING *), + OPENSSL_LH_HASHFUNC hash, OPENSSL_LH_COMPFUNC cmp); +void TXT_DB_free(TXT_DB *db); +OPENSSL_STRING *TXT_DB_get_by_index(TXT_DB *db, int idx, + OPENSSL_STRING *value); +int TXT_DB_insert(TXT_DB *db, OPENSSL_STRING *value); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/openssl/ui.h b/include/openssl/ui.h new file mode 100644 index 0000000..6d0f74f --- /dev/null +++ b/include/openssl/ui.h @@ -0,0 +1,368 @@ +/* + * Copyright 2001-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_UI_H +# define HEADER_UI_H + +# include + +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# endif +# include +# include +# include +# include + +/* For compatibility reasons, the macro OPENSSL_NO_UI is currently retained */ +# if OPENSSL_API_COMPAT < 0x10200000L +# ifdef OPENSSL_NO_UI_CONSOLE +# define OPENSSL_NO_UI +# endif +# endif + +# ifdef __cplusplus +extern "C" { +# endif + +/* + * All the following functions return -1 or NULL on error and in some cases + * (UI_process()) -2 if interrupted or in some other way cancelled. When + * everything is fine, they return 0, a positive value or a non-NULL pointer, + * all depending on their purpose. + */ + +/* Creators and destructor. */ +UI *UI_new(void); +UI *UI_new_method(const UI_METHOD *method); +void UI_free(UI *ui); + +/*- + The following functions are used to add strings to be printed and prompt + strings to prompt for data. The names are UI_{add,dup}__string + and UI_{add,dup}_input_boolean. + + UI_{add,dup}__string have the following meanings: + add add a text or prompt string. The pointers given to these + functions are used verbatim, no copying is done. + dup make a copy of the text or prompt string, then add the copy + to the collection of strings in the user interface. + + The function is a name for the functionality that the given + string shall be used for. It can be one of: + input use the string as data prompt. + verify use the string as verification prompt. This + is used to verify a previous input. + info use the string for informational output. + error use the string for error output. + Honestly, there's currently no difference between info and error for the + moment. + + UI_{add,dup}_input_boolean have the same semantics for "add" and "dup", + and are typically used when one wants to prompt for a yes/no response. + + All of the functions in this group take a UI and a prompt string. + The string input and verify addition functions also take a flag argument, + a buffer for the result to end up with, a minimum input size and a maximum + input size (the result buffer MUST be large enough to be able to contain + the maximum number of characters). Additionally, the verify addition + functions takes another buffer to compare the result against. + The boolean input functions take an action description string (which should + be safe to ignore if the expected user action is obvious, for example with + a dialog box with an OK button and a Cancel button), a string of acceptable + characters to mean OK and to mean Cancel. The two last strings are checked + to make sure they don't have common characters. Additionally, the same + flag argument as for the string input is taken, as well as a result buffer. + The result buffer is required to be at least one byte long. Depending on + the answer, the first character from the OK or the Cancel character strings + will be stored in the first byte of the result buffer. No NUL will be + added, so the result is *not* a string. + + On success, the all return an index of the added information. That index + is useful when retrieving results with UI_get0_result(). */ +int UI_add_input_string(UI *ui, const char *prompt, int flags, + char *result_buf, int minsize, int maxsize); +int UI_dup_input_string(UI *ui, const char *prompt, int flags, + char *result_buf, int minsize, int maxsize); +int UI_add_verify_string(UI *ui, const char *prompt, int flags, + char *result_buf, int minsize, int maxsize, + const char *test_buf); +int UI_dup_verify_string(UI *ui, const char *prompt, int flags, + char *result_buf, int minsize, int maxsize, + const char *test_buf); +int UI_add_input_boolean(UI *ui, const char *prompt, const char *action_desc, + const char *ok_chars, const char *cancel_chars, + int flags, char *result_buf); +int UI_dup_input_boolean(UI *ui, const char *prompt, const char *action_desc, + const char *ok_chars, const char *cancel_chars, + int flags, char *result_buf); +int UI_add_info_string(UI *ui, const char *text); +int UI_dup_info_string(UI *ui, const char *text); +int UI_add_error_string(UI *ui, const char *text); +int UI_dup_error_string(UI *ui, const char *text); + +/* These are the possible flags. They can be or'ed together. */ +/* Use to have echoing of input */ +# define UI_INPUT_FLAG_ECHO 0x01 +/* + * Use a default password. Where that password is found is completely up to + * the application, it might for example be in the user data set with + * UI_add_user_data(). It is not recommended to have more than one input in + * each UI being marked with this flag, or the application might get + * confused. + */ +# define UI_INPUT_FLAG_DEFAULT_PWD 0x02 + +/*- + * The user of these routines may want to define flags of their own. The core + * UI won't look at those, but will pass them on to the method routines. They + * must use higher bits so they don't get confused with the UI bits above. + * UI_INPUT_FLAG_USER_BASE tells which is the lowest bit to use. A good + * example of use is this: + * + * #define MY_UI_FLAG1 (0x01 << UI_INPUT_FLAG_USER_BASE) + * +*/ +# define UI_INPUT_FLAG_USER_BASE 16 + +/*- + * The following function helps construct a prompt. object_desc is a + * textual short description of the object, for example "pass phrase", + * and object_name is the name of the object (might be a card name or + * a file name. + * The returned string shall always be allocated on the heap with + * OPENSSL_malloc(), and need to be free'd with OPENSSL_free(). + * + * If the ui_method doesn't contain a pointer to a user-defined prompt + * constructor, a default string is built, looking like this: + * + * "Enter {object_desc} for {object_name}:" + * + * So, if object_desc has the value "pass phrase" and object_name has + * the value "foo.key", the resulting string is: + * + * "Enter pass phrase for foo.key:" +*/ +char *UI_construct_prompt(UI *ui_method, + const char *object_desc, const char *object_name); + +/* + * The following function is used to store a pointer to user-specific data. + * Any previous such pointer will be returned and replaced. + * + * For callback purposes, this function makes a lot more sense than using + * ex_data, since the latter requires that different parts of OpenSSL or + * applications share the same ex_data index. + * + * Note that the UI_OpenSSL() method completely ignores the user data. Other + * methods may not, however. + */ +void *UI_add_user_data(UI *ui, void *user_data); +/* + * Alternatively, this function is used to duplicate the user data. + * This uses the duplicator method function. The destroy function will + * be used to free the user data in this case. + */ +int UI_dup_user_data(UI *ui, void *user_data); +/* We need a user data retrieving function as well. */ +void *UI_get0_user_data(UI *ui); + +/* Return the result associated with a prompt given with the index i. */ +const char *UI_get0_result(UI *ui, int i); +int UI_get_result_length(UI *ui, int i); + +/* When all strings have been added, process the whole thing. */ +int UI_process(UI *ui); + +/* + * Give a user interface parameterised control commands. This can be used to + * send down an integer, a data pointer or a function pointer, as well as be + * used to get information from a UI. + */ +int UI_ctrl(UI *ui, int cmd, long i, void *p, void (*f) (void)); + +/* The commands */ +/* + * Use UI_CONTROL_PRINT_ERRORS with the value 1 to have UI_process print the + * OpenSSL error stack before printing any info or added error messages and + * before any prompting. + */ +# define UI_CTRL_PRINT_ERRORS 1 +/* + * Check if a UI_process() is possible to do again with the same instance of + * a user interface. This makes UI_ctrl() return 1 if it is redoable, and 0 + * if not. + */ +# define UI_CTRL_IS_REDOABLE 2 + +/* Some methods may use extra data */ +# define UI_set_app_data(s,arg) UI_set_ex_data(s,0,arg) +# define UI_get_app_data(s) UI_get_ex_data(s,0) + +# define UI_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_UI, l, p, newf, dupf, freef) +int UI_set_ex_data(UI *r, int idx, void *arg); +void *UI_get_ex_data(UI *r, int idx); + +/* Use specific methods instead of the built-in one */ +void UI_set_default_method(const UI_METHOD *meth); +const UI_METHOD *UI_get_default_method(void); +const UI_METHOD *UI_get_method(UI *ui); +const UI_METHOD *UI_set_method(UI *ui, const UI_METHOD *meth); + +# ifndef OPENSSL_NO_UI_CONSOLE + +/* The method with all the built-in thingies */ +UI_METHOD *UI_OpenSSL(void); + +# endif + +/* + * NULL method. Literally does nothing, but may serve as a placeholder + * to avoid internal default. + */ +const UI_METHOD *UI_null(void); + +/* ---------- For method writers ---------- */ +/*- + A method contains a number of functions that implement the low level + of the User Interface. The functions are: + + an opener This function starts a session, maybe by opening + a channel to a tty, or by opening a window. + a writer This function is called to write a given string, + maybe to the tty, maybe as a field label in a + window. + a flusher This function is called to flush everything that + has been output so far. It can be used to actually + display a dialog box after it has been built. + a reader This function is called to read a given prompt, + maybe from the tty, maybe from a field in a + window. Note that it's called with all string + structures, not only the prompt ones, so it must + check such things itself. + a closer This function closes the session, maybe by closing + the channel to the tty, or closing the window. + + All these functions are expected to return: + + 0 on error. + 1 on success. + -1 on out-of-band events, for example if some prompting has + been canceled (by pressing Ctrl-C, for example). This is + only checked when returned by the flusher or the reader. + + The way this is used, the opener is first called, then the writer for all + strings, then the flusher, then the reader for all strings and finally the + closer. Note that if you want to prompt from a terminal or other command + line interface, the best is to have the reader also write the prompts + instead of having the writer do it. If you want to prompt from a dialog + box, the writer can be used to build up the contents of the box, and the + flusher to actually display the box and run the event loop until all data + has been given, after which the reader only grabs the given data and puts + them back into the UI strings. + + All method functions take a UI as argument. Additionally, the writer and + the reader take a UI_STRING. +*/ + +/* + * The UI_STRING type is the data structure that contains all the needed info + * about a string or a prompt, including test data for a verification prompt. + */ +typedef struct ui_string_st UI_STRING; +DEFINE_STACK_OF(UI_STRING) + +/* + * The different types of strings that are currently supported. This is only + * needed by method authors. + */ +enum UI_string_types { + UIT_NONE = 0, + UIT_PROMPT, /* Prompt for a string */ + UIT_VERIFY, /* Prompt for a string and verify */ + UIT_BOOLEAN, /* Prompt for a yes/no response */ + UIT_INFO, /* Send info to the user */ + UIT_ERROR /* Send an error message to the user */ +}; + +/* Create and manipulate methods */ +UI_METHOD *UI_create_method(const char *name); +void UI_destroy_method(UI_METHOD *ui_method); +int UI_method_set_opener(UI_METHOD *method, int (*opener) (UI *ui)); +int UI_method_set_writer(UI_METHOD *method, + int (*writer) (UI *ui, UI_STRING *uis)); +int UI_method_set_flusher(UI_METHOD *method, int (*flusher) (UI *ui)); +int UI_method_set_reader(UI_METHOD *method, + int (*reader) (UI *ui, UI_STRING *uis)); +int UI_method_set_closer(UI_METHOD *method, int (*closer) (UI *ui)); +int UI_method_set_data_duplicator(UI_METHOD *method, + void *(*duplicator) (UI *ui, void *ui_data), + void (*destructor)(UI *ui, void *ui_data)); +int UI_method_set_prompt_constructor(UI_METHOD *method, + char *(*prompt_constructor) (UI *ui, + const char + *object_desc, + const char + *object_name)); +int UI_method_set_ex_data(UI_METHOD *method, int idx, void *data); +int (*UI_method_get_opener(const UI_METHOD *method)) (UI *); +int (*UI_method_get_writer(const UI_METHOD *method)) (UI *, UI_STRING *); +int (*UI_method_get_flusher(const UI_METHOD *method)) (UI *); +int (*UI_method_get_reader(const UI_METHOD *method)) (UI *, UI_STRING *); +int (*UI_method_get_closer(const UI_METHOD *method)) (UI *); +char *(*UI_method_get_prompt_constructor(const UI_METHOD *method)) + (UI *, const char *, const char *); +void *(*UI_method_get_data_duplicator(const UI_METHOD *method)) (UI *, void *); +void (*UI_method_get_data_destructor(const UI_METHOD *method)) (UI *, void *); +const void *UI_method_get_ex_data(const UI_METHOD *method, int idx); + +/* + * The following functions are helpers for method writers to access relevant + * data from a UI_STRING. + */ + +/* Return type of the UI_STRING */ +enum UI_string_types UI_get_string_type(UI_STRING *uis); +/* Return input flags of the UI_STRING */ +int UI_get_input_flags(UI_STRING *uis); +/* Return the actual string to output (the prompt, info or error) */ +const char *UI_get0_output_string(UI_STRING *uis); +/* + * Return the optional action string to output (the boolean prompt + * instruction) + */ +const char *UI_get0_action_string(UI_STRING *uis); +/* Return the result of a prompt */ +const char *UI_get0_result_string(UI_STRING *uis); +int UI_get_result_string_length(UI_STRING *uis); +/* + * Return the string to test the result against. Only useful with verifies. + */ +const char *UI_get0_test_string(UI_STRING *uis); +/* Return the required minimum size of the result */ +int UI_get_result_minsize(UI_STRING *uis); +/* Return the required maximum size of the result */ +int UI_get_result_maxsize(UI_STRING *uis); +/* Set the result of a UI_STRING. */ +int UI_set_result(UI *ui, UI_STRING *uis, const char *result); +int UI_set_result_ex(UI *ui, UI_STRING *uis, const char *result, int len); + +/* A couple of popular utility functions */ +int UI_UTIL_read_pw_string(char *buf, int length, const char *prompt, + int verify); +int UI_UTIL_read_pw(char *buf, char *buff, int size, const char *prompt, + int verify); +UI_METHOD *UI_UTIL_wrap_read_pem_callback(pem_password_cb *cb, int rwflag); + + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/uierr.h b/include/openssl/uierr.h new file mode 100644 index 0000000..72fd9a9 --- /dev/null +++ b/include/openssl/uierr.h @@ -0,0 +1,61 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_UIERR_H +# define HEADER_UIERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_UI_strings(void); + +/* + * UI function codes. + */ +# define UI_F_CLOSE_CONSOLE 115 +# define UI_F_ECHO_CONSOLE 116 +# define UI_F_GENERAL_ALLOCATE_BOOLEAN 108 +# define UI_F_GENERAL_ALLOCATE_PROMPT 109 +# define UI_F_NOECHO_CONSOLE 117 +# define UI_F_OPEN_CONSOLE 114 +# define UI_F_UI_CONSTRUCT_PROMPT 121 +# define UI_F_UI_CREATE_METHOD 112 +# define UI_F_UI_CTRL 111 +# define UI_F_UI_DUP_ERROR_STRING 101 +# define UI_F_UI_DUP_INFO_STRING 102 +# define UI_F_UI_DUP_INPUT_BOOLEAN 110 +# define UI_F_UI_DUP_INPUT_STRING 103 +# define UI_F_UI_DUP_USER_DATA 118 +# define UI_F_UI_DUP_VERIFY_STRING 106 +# define UI_F_UI_GET0_RESULT 107 +# define UI_F_UI_GET_RESULT_LENGTH 119 +# define UI_F_UI_NEW_METHOD 104 +# define UI_F_UI_PROCESS 113 +# define UI_F_UI_SET_RESULT 105 +# define UI_F_UI_SET_RESULT_EX 120 + +/* + * UI reason codes. + */ +# define UI_R_COMMON_OK_AND_CANCEL_CHARACTERS 104 +# define UI_R_INDEX_TOO_LARGE 102 +# define UI_R_INDEX_TOO_SMALL 103 +# define UI_R_NO_RESULT_BUFFER 105 +# define UI_R_PROCESSING_ERROR 107 +# define UI_R_RESULT_TOO_LARGE 100 +# define UI_R_RESULT_TOO_SMALL 101 +# define UI_R_SYSASSIGN_ERROR 109 +# define UI_R_SYSDASSGN_ERROR 110 +# define UI_R_SYSQIOW_ERROR 111 +# define UI_R_UNKNOWN_CONTROL_COMMAND 106 +# define UI_R_UNKNOWN_TTYGET_ERRNO_VALUE 108 +# define UI_R_USER_DATA_DUPLICATION_UNSUPPORTED 112 + +#endif diff --git a/include/openssl/whrlpool.h b/include/openssl/whrlpool.h new file mode 100644 index 0000000..cde6664 --- /dev/null +++ b/include/openssl/whrlpool.h @@ -0,0 +1,48 @@ +/* + * Copyright 2005-2016 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_WHRLPOOL_H +# define HEADER_WHRLPOOL_H + +#include + +# ifndef OPENSSL_NO_WHIRLPOOL +# include +# include +# ifdef __cplusplus +extern "C" { +# endif + +# define WHIRLPOOL_DIGEST_LENGTH (512/8) +# define WHIRLPOOL_BBLOCK 512 +# define WHIRLPOOL_COUNTER (256/8) + +typedef struct { + union { + unsigned char c[WHIRLPOOL_DIGEST_LENGTH]; + /* double q is here to ensure 64-bit alignment */ + double q[WHIRLPOOL_DIGEST_LENGTH / sizeof(double)]; + } H; + unsigned char data[WHIRLPOOL_BBLOCK / 8]; + unsigned int bitoff; + size_t bitlen[WHIRLPOOL_COUNTER / sizeof(size_t)]; +} WHIRLPOOL_CTX; + +int WHIRLPOOL_Init(WHIRLPOOL_CTX *c); +int WHIRLPOOL_Update(WHIRLPOOL_CTX *c, const void *inp, size_t bytes); +void WHIRLPOOL_BitUpdate(WHIRLPOOL_CTX *c, const void *inp, size_t bits); +int WHIRLPOOL_Final(unsigned char *md, WHIRLPOOL_CTX *c); +unsigned char *WHIRLPOOL(const void *inp, size_t bytes, unsigned char *md); + +# ifdef __cplusplus +} +# endif +# endif + +#endif diff --git a/include/openssl/x509.h b/include/openssl/x509.h new file mode 100644 index 0000000..07f22d7 --- /dev/null +++ b/include/openssl/x509.h @@ -0,0 +1,1047 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_X509_H +# define HEADER_X509_H + +# include +# include +# include +# include +# include +# include +# include +# include +# include + +# if OPENSSL_API_COMPAT < 0x10100000L +# include +# include +# include +# endif + +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + + +/* Flags for X509_get_signature_info() */ +/* Signature info is valid */ +# define X509_SIG_INFO_VALID 0x1 +/* Signature is suitable for TLS use */ +# define X509_SIG_INFO_TLS 0x2 + +# define X509_FILETYPE_PEM 1 +# define X509_FILETYPE_ASN1 2 +# define X509_FILETYPE_DEFAULT 3 + +# define X509v3_KU_DIGITAL_SIGNATURE 0x0080 +# define X509v3_KU_NON_REPUDIATION 0x0040 +# define X509v3_KU_KEY_ENCIPHERMENT 0x0020 +# define X509v3_KU_DATA_ENCIPHERMENT 0x0010 +# define X509v3_KU_KEY_AGREEMENT 0x0008 +# define X509v3_KU_KEY_CERT_SIGN 0x0004 +# define X509v3_KU_CRL_SIGN 0x0002 +# define X509v3_KU_ENCIPHER_ONLY 0x0001 +# define X509v3_KU_DECIPHER_ONLY 0x8000 +# define X509v3_KU_UNDEF 0xffff + +struct X509_algor_st { + ASN1_OBJECT *algorithm; + ASN1_TYPE *parameter; +} /* X509_ALGOR */ ; + +typedef STACK_OF(X509_ALGOR) X509_ALGORS; + +typedef struct X509_val_st { + ASN1_TIME *notBefore; + ASN1_TIME *notAfter; +} X509_VAL; + +typedef struct X509_sig_st X509_SIG; + +typedef struct X509_name_entry_st X509_NAME_ENTRY; + +DEFINE_STACK_OF(X509_NAME_ENTRY) + +DEFINE_STACK_OF(X509_NAME) + +# define X509_EX_V_NETSCAPE_HACK 0x8000 +# define X509_EX_V_INIT 0x0001 +typedef struct X509_extension_st X509_EXTENSION; + +typedef STACK_OF(X509_EXTENSION) X509_EXTENSIONS; + +DEFINE_STACK_OF(X509_EXTENSION) + +typedef struct x509_attributes_st X509_ATTRIBUTE; + +DEFINE_STACK_OF(X509_ATTRIBUTE) + +typedef struct X509_req_info_st X509_REQ_INFO; + +typedef struct X509_req_st X509_REQ; + +typedef struct x509_cert_aux_st X509_CERT_AUX; + +typedef struct x509_cinf_st X509_CINF; + +DEFINE_STACK_OF(X509) + +/* This is used for a table of trust checking functions */ + +typedef struct x509_trust_st { + int trust; + int flags; + int (*check_trust) (struct x509_trust_st *, X509 *, int); + char *name; + int arg1; + void *arg2; +} X509_TRUST; + +DEFINE_STACK_OF(X509_TRUST) + +/* standard trust ids */ + +# define X509_TRUST_DEFAULT 0 /* Only valid in purpose settings */ + +# define X509_TRUST_COMPAT 1 +# define X509_TRUST_SSL_CLIENT 2 +# define X509_TRUST_SSL_SERVER 3 +# define X509_TRUST_EMAIL 4 +# define X509_TRUST_OBJECT_SIGN 5 +# define X509_TRUST_OCSP_SIGN 6 +# define X509_TRUST_OCSP_REQUEST 7 +# define X509_TRUST_TSA 8 + +/* Keep these up to date! */ +# define X509_TRUST_MIN 1 +# define X509_TRUST_MAX 8 + +/* trust_flags values */ +# define X509_TRUST_DYNAMIC (1U << 0) +# define X509_TRUST_DYNAMIC_NAME (1U << 1) +/* No compat trust if self-signed, preempts "DO_SS" */ +# define X509_TRUST_NO_SS_COMPAT (1U << 2) +/* Compat trust if no explicit accepted trust EKUs */ +# define X509_TRUST_DO_SS_COMPAT (1U << 3) +/* Accept "anyEKU" as a wildcard trust OID */ +# define X509_TRUST_OK_ANY_EKU (1U << 4) + +/* check_trust return codes */ + +# define X509_TRUST_TRUSTED 1 +# define X509_TRUST_REJECTED 2 +# define X509_TRUST_UNTRUSTED 3 + +/* Flags for X509_print_ex() */ + +# define X509_FLAG_COMPAT 0 +# define X509_FLAG_NO_HEADER 1L +# define X509_FLAG_NO_VERSION (1L << 1) +# define X509_FLAG_NO_SERIAL (1L << 2) +# define X509_FLAG_NO_SIGNAME (1L << 3) +# define X509_FLAG_NO_ISSUER (1L << 4) +# define X509_FLAG_NO_VALIDITY (1L << 5) +# define X509_FLAG_NO_SUBJECT (1L << 6) +# define X509_FLAG_NO_PUBKEY (1L << 7) +# define X509_FLAG_NO_EXTENSIONS (1L << 8) +# define X509_FLAG_NO_SIGDUMP (1L << 9) +# define X509_FLAG_NO_AUX (1L << 10) +# define X509_FLAG_NO_ATTRIBUTES (1L << 11) +# define X509_FLAG_NO_IDS (1L << 12) + +/* Flags specific to X509_NAME_print_ex() */ + +/* The field separator information */ + +# define XN_FLAG_SEP_MASK (0xf << 16) + +# define XN_FLAG_COMPAT 0/* Traditional; use old X509_NAME_print */ +# define XN_FLAG_SEP_COMMA_PLUS (1 << 16)/* RFC2253 ,+ */ +# define XN_FLAG_SEP_CPLUS_SPC (2 << 16)/* ,+ spaced: more readable */ +# define XN_FLAG_SEP_SPLUS_SPC (3 << 16)/* ;+ spaced */ +# define XN_FLAG_SEP_MULTILINE (4 << 16)/* One line per field */ + +# define XN_FLAG_DN_REV (1 << 20)/* Reverse DN order */ + +/* How the field name is shown */ + +# define XN_FLAG_FN_MASK (0x3 << 21) + +# define XN_FLAG_FN_SN 0/* Object short name */ +# define XN_FLAG_FN_LN (1 << 21)/* Object long name */ +# define XN_FLAG_FN_OID (2 << 21)/* Always use OIDs */ +# define XN_FLAG_FN_NONE (3 << 21)/* No field names */ + +# define XN_FLAG_SPC_EQ (1 << 23)/* Put spaces round '=' */ + +/* + * This determines if we dump fields we don't recognise: RFC2253 requires + * this. + */ + +# define XN_FLAG_DUMP_UNKNOWN_FIELDS (1 << 24) + +# define XN_FLAG_FN_ALIGN (1 << 25)/* Align field names to 20 + * characters */ + +/* Complete set of RFC2253 flags */ + +# define XN_FLAG_RFC2253 (ASN1_STRFLGS_RFC2253 | \ + XN_FLAG_SEP_COMMA_PLUS | \ + XN_FLAG_DN_REV | \ + XN_FLAG_FN_SN | \ + XN_FLAG_DUMP_UNKNOWN_FIELDS) + +/* readable oneline form */ + +# define XN_FLAG_ONELINE (ASN1_STRFLGS_RFC2253 | \ + ASN1_STRFLGS_ESC_QUOTE | \ + XN_FLAG_SEP_CPLUS_SPC | \ + XN_FLAG_SPC_EQ | \ + XN_FLAG_FN_SN) + +/* readable multiline form */ + +# define XN_FLAG_MULTILINE (ASN1_STRFLGS_ESC_CTRL | \ + ASN1_STRFLGS_ESC_MSB | \ + XN_FLAG_SEP_MULTILINE | \ + XN_FLAG_SPC_EQ | \ + XN_FLAG_FN_LN | \ + XN_FLAG_FN_ALIGN) + +DEFINE_STACK_OF(X509_REVOKED) + +typedef struct X509_crl_info_st X509_CRL_INFO; + +DEFINE_STACK_OF(X509_CRL) + +typedef struct private_key_st { + int version; + /* The PKCS#8 data types */ + X509_ALGOR *enc_algor; + ASN1_OCTET_STRING *enc_pkey; /* encrypted pub key */ + /* When decrypted, the following will not be NULL */ + EVP_PKEY *dec_pkey; + /* used to encrypt and decrypt */ + int key_length; + char *key_data; + int key_free; /* true if we should auto free key_data */ + /* expanded version of 'enc_algor' */ + EVP_CIPHER_INFO cipher; +} X509_PKEY; + +typedef struct X509_info_st { + X509 *x509; + X509_CRL *crl; + X509_PKEY *x_pkey; + EVP_CIPHER_INFO enc_cipher; + int enc_len; + char *enc_data; +} X509_INFO; + +DEFINE_STACK_OF(X509_INFO) + +/* + * The next 2 structures and their 8 routines are used to manipulate Netscape's + * spki structures - useful if you are writing a CA web page + */ +typedef struct Netscape_spkac_st { + X509_PUBKEY *pubkey; + ASN1_IA5STRING *challenge; /* challenge sent in atlas >= PR2 */ +} NETSCAPE_SPKAC; + +typedef struct Netscape_spki_st { + NETSCAPE_SPKAC *spkac; /* signed public key and challenge */ + X509_ALGOR sig_algor; + ASN1_BIT_STRING *signature; +} NETSCAPE_SPKI; + +/* Netscape certificate sequence structure */ +typedef struct Netscape_certificate_sequence { + ASN1_OBJECT *type; + STACK_OF(X509) *certs; +} NETSCAPE_CERT_SEQUENCE; + +/*- Unused (and iv length is wrong) +typedef struct CBCParameter_st + { + unsigned char iv[8]; + } CBC_PARAM; +*/ + +/* Password based encryption structure */ + +typedef struct PBEPARAM_st { + ASN1_OCTET_STRING *salt; + ASN1_INTEGER *iter; +} PBEPARAM; + +/* Password based encryption V2 structures */ + +typedef struct PBE2PARAM_st { + X509_ALGOR *keyfunc; + X509_ALGOR *encryption; +} PBE2PARAM; + +typedef struct PBKDF2PARAM_st { +/* Usually OCTET STRING but could be anything */ + ASN1_TYPE *salt; + ASN1_INTEGER *iter; + ASN1_INTEGER *keylength; + X509_ALGOR *prf; +} PBKDF2PARAM; + +#ifndef OPENSSL_NO_SCRYPT +typedef struct SCRYPT_PARAMS_st { + ASN1_OCTET_STRING *salt; + ASN1_INTEGER *costParameter; + ASN1_INTEGER *blockSize; + ASN1_INTEGER *parallelizationParameter; + ASN1_INTEGER *keyLength; +} SCRYPT_PARAMS; +#endif + +#ifdef __cplusplus +} +#endif + +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +# define X509_EXT_PACK_UNKNOWN 1 +# define X509_EXT_PACK_STRING 2 + +# define X509_extract_key(x) X509_get_pubkey(x)/*****/ +# define X509_REQ_extract_key(a) X509_REQ_get_pubkey(a) +# define X509_name_cmp(a,b) X509_NAME_cmp((a),(b)) + +void X509_CRL_set_default_method(const X509_CRL_METHOD *meth); +X509_CRL_METHOD *X509_CRL_METHOD_new(int (*crl_init) (X509_CRL *crl), + int (*crl_free) (X509_CRL *crl), + int (*crl_lookup) (X509_CRL *crl, + X509_REVOKED **ret, + ASN1_INTEGER *ser, + X509_NAME *issuer), + int (*crl_verify) (X509_CRL *crl, + EVP_PKEY *pk)); +void X509_CRL_METHOD_free(X509_CRL_METHOD *m); + +void X509_CRL_set_meth_data(X509_CRL *crl, void *dat); +void *X509_CRL_get_meth_data(X509_CRL *crl); + +const char *X509_verify_cert_error_string(long n); + +int X509_verify(X509 *a, EVP_PKEY *r); + +int X509_REQ_verify(X509_REQ *a, EVP_PKEY *r); +int X509_CRL_verify(X509_CRL *a, EVP_PKEY *r); +int NETSCAPE_SPKI_verify(NETSCAPE_SPKI *a, EVP_PKEY *r); + +NETSCAPE_SPKI *NETSCAPE_SPKI_b64_decode(const char *str, int len); +char *NETSCAPE_SPKI_b64_encode(NETSCAPE_SPKI *x); +EVP_PKEY *NETSCAPE_SPKI_get_pubkey(NETSCAPE_SPKI *x); +int NETSCAPE_SPKI_set_pubkey(NETSCAPE_SPKI *x, EVP_PKEY *pkey); + +int NETSCAPE_SPKI_print(BIO *out, NETSCAPE_SPKI *spki); + +int X509_signature_dump(BIO *bp, const ASN1_STRING *sig, int indent); +int X509_signature_print(BIO *bp, const X509_ALGOR *alg, + const ASN1_STRING *sig); + +int X509_sign(X509 *x, EVP_PKEY *pkey, const EVP_MD *md); +int X509_sign_ctx(X509 *x, EVP_MD_CTX *ctx); +# ifndef OPENSSL_NO_OCSP +int X509_http_nbio(OCSP_REQ_CTX *rctx, X509 **pcert); +# endif +int X509_REQ_sign(X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md); +int X509_REQ_sign_ctx(X509_REQ *x, EVP_MD_CTX *ctx); +int X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md); +int X509_CRL_sign_ctx(X509_CRL *x, EVP_MD_CTX *ctx); +# ifndef OPENSSL_NO_OCSP +int X509_CRL_http_nbio(OCSP_REQ_CTX *rctx, X509_CRL **pcrl); +# endif +int NETSCAPE_SPKI_sign(NETSCAPE_SPKI *x, EVP_PKEY *pkey, const EVP_MD *md); + +int X509_pubkey_digest(const X509 *data, const EVP_MD *type, + unsigned char *md, unsigned int *len); +int X509_digest(const X509 *data, const EVP_MD *type, + unsigned char *md, unsigned int *len); +int X509_CRL_digest(const X509_CRL *data, const EVP_MD *type, + unsigned char *md, unsigned int *len); +int X509_REQ_digest(const X509_REQ *data, const EVP_MD *type, + unsigned char *md, unsigned int *len); +int X509_NAME_digest(const X509_NAME *data, const EVP_MD *type, + unsigned char *md, unsigned int *len); + +# ifndef OPENSSL_NO_STDIO +X509 *d2i_X509_fp(FILE *fp, X509 **x509); +int i2d_X509_fp(FILE *fp, X509 *x509); +X509_CRL *d2i_X509_CRL_fp(FILE *fp, X509_CRL **crl); +int i2d_X509_CRL_fp(FILE *fp, X509_CRL *crl); +X509_REQ *d2i_X509_REQ_fp(FILE *fp, X509_REQ **req); +int i2d_X509_REQ_fp(FILE *fp, X509_REQ *req); +# ifndef OPENSSL_NO_RSA +RSA *d2i_RSAPrivateKey_fp(FILE *fp, RSA **rsa); +int i2d_RSAPrivateKey_fp(FILE *fp, RSA *rsa); +RSA *d2i_RSAPublicKey_fp(FILE *fp, RSA **rsa); +int i2d_RSAPublicKey_fp(FILE *fp, RSA *rsa); +RSA *d2i_RSA_PUBKEY_fp(FILE *fp, RSA **rsa); +int i2d_RSA_PUBKEY_fp(FILE *fp, RSA *rsa); +# endif +# ifndef OPENSSL_NO_DSA +DSA *d2i_DSA_PUBKEY_fp(FILE *fp, DSA **dsa); +int i2d_DSA_PUBKEY_fp(FILE *fp, DSA *dsa); +DSA *d2i_DSAPrivateKey_fp(FILE *fp, DSA **dsa); +int i2d_DSAPrivateKey_fp(FILE *fp, DSA *dsa); +# endif +# ifndef OPENSSL_NO_EC +EC_KEY *d2i_EC_PUBKEY_fp(FILE *fp, EC_KEY **eckey); +int i2d_EC_PUBKEY_fp(FILE *fp, EC_KEY *eckey); +EC_KEY *d2i_ECPrivateKey_fp(FILE *fp, EC_KEY **eckey); +int i2d_ECPrivateKey_fp(FILE *fp, EC_KEY *eckey); +# endif +X509_SIG *d2i_PKCS8_fp(FILE *fp, X509_SIG **p8); +int i2d_PKCS8_fp(FILE *fp, X509_SIG *p8); +PKCS8_PRIV_KEY_INFO *d2i_PKCS8_PRIV_KEY_INFO_fp(FILE *fp, + PKCS8_PRIV_KEY_INFO **p8inf); +int i2d_PKCS8_PRIV_KEY_INFO_fp(FILE *fp, PKCS8_PRIV_KEY_INFO *p8inf); +int i2d_PKCS8PrivateKeyInfo_fp(FILE *fp, EVP_PKEY *key); +int i2d_PrivateKey_fp(FILE *fp, EVP_PKEY *pkey); +EVP_PKEY *d2i_PrivateKey_fp(FILE *fp, EVP_PKEY **a); +int i2d_PUBKEY_fp(FILE *fp, EVP_PKEY *pkey); +EVP_PKEY *d2i_PUBKEY_fp(FILE *fp, EVP_PKEY **a); +# endif + +X509 *d2i_X509_bio(BIO *bp, X509 **x509); +int i2d_X509_bio(BIO *bp, X509 *x509); +X509_CRL *d2i_X509_CRL_bio(BIO *bp, X509_CRL **crl); +int i2d_X509_CRL_bio(BIO *bp, X509_CRL *crl); +X509_REQ *d2i_X509_REQ_bio(BIO *bp, X509_REQ **req); +int i2d_X509_REQ_bio(BIO *bp, X509_REQ *req); +# ifndef OPENSSL_NO_RSA +RSA *d2i_RSAPrivateKey_bio(BIO *bp, RSA **rsa); +int i2d_RSAPrivateKey_bio(BIO *bp, RSA *rsa); +RSA *d2i_RSAPublicKey_bio(BIO *bp, RSA **rsa); +int i2d_RSAPublicKey_bio(BIO *bp, RSA *rsa); +RSA *d2i_RSA_PUBKEY_bio(BIO *bp, RSA **rsa); +int i2d_RSA_PUBKEY_bio(BIO *bp, RSA *rsa); +# endif +# ifndef OPENSSL_NO_DSA +DSA *d2i_DSA_PUBKEY_bio(BIO *bp, DSA **dsa); +int i2d_DSA_PUBKEY_bio(BIO *bp, DSA *dsa); +DSA *d2i_DSAPrivateKey_bio(BIO *bp, DSA **dsa); +int i2d_DSAPrivateKey_bio(BIO *bp, DSA *dsa); +# endif +# ifndef OPENSSL_NO_EC +EC_KEY *d2i_EC_PUBKEY_bio(BIO *bp, EC_KEY **eckey); +int i2d_EC_PUBKEY_bio(BIO *bp, EC_KEY *eckey); +EC_KEY *d2i_ECPrivateKey_bio(BIO *bp, EC_KEY **eckey); +int i2d_ECPrivateKey_bio(BIO *bp, EC_KEY *eckey); +# endif +X509_SIG *d2i_PKCS8_bio(BIO *bp, X509_SIG **p8); +int i2d_PKCS8_bio(BIO *bp, X509_SIG *p8); +PKCS8_PRIV_KEY_INFO *d2i_PKCS8_PRIV_KEY_INFO_bio(BIO *bp, + PKCS8_PRIV_KEY_INFO **p8inf); +int i2d_PKCS8_PRIV_KEY_INFO_bio(BIO *bp, PKCS8_PRIV_KEY_INFO *p8inf); +int i2d_PKCS8PrivateKeyInfo_bio(BIO *bp, EVP_PKEY *key); +int i2d_PrivateKey_bio(BIO *bp, EVP_PKEY *pkey); +EVP_PKEY *d2i_PrivateKey_bio(BIO *bp, EVP_PKEY **a); +int i2d_PUBKEY_bio(BIO *bp, EVP_PKEY *pkey); +EVP_PKEY *d2i_PUBKEY_bio(BIO *bp, EVP_PKEY **a); + +X509 *X509_dup(X509 *x509); +X509_ATTRIBUTE *X509_ATTRIBUTE_dup(X509_ATTRIBUTE *xa); +X509_EXTENSION *X509_EXTENSION_dup(X509_EXTENSION *ex); +X509_CRL *X509_CRL_dup(X509_CRL *crl); +X509_REVOKED *X509_REVOKED_dup(X509_REVOKED *rev); +X509_REQ *X509_REQ_dup(X509_REQ *req); +X509_ALGOR *X509_ALGOR_dup(X509_ALGOR *xn); +int X509_ALGOR_set0(X509_ALGOR *alg, ASN1_OBJECT *aobj, int ptype, + void *pval); +void X509_ALGOR_get0(const ASN1_OBJECT **paobj, int *pptype, + const void **ppval, const X509_ALGOR *algor); +void X509_ALGOR_set_md(X509_ALGOR *alg, const EVP_MD *md); +int X509_ALGOR_cmp(const X509_ALGOR *a, const X509_ALGOR *b); + +X509_NAME *X509_NAME_dup(X509_NAME *xn); +X509_NAME_ENTRY *X509_NAME_ENTRY_dup(X509_NAME_ENTRY *ne); + +int X509_cmp_time(const ASN1_TIME *s, time_t *t); +int X509_cmp_current_time(const ASN1_TIME *s); +ASN1_TIME *X509_time_adj(ASN1_TIME *s, long adj, time_t *t); +ASN1_TIME *X509_time_adj_ex(ASN1_TIME *s, + int offset_day, long offset_sec, time_t *t); +ASN1_TIME *X509_gmtime_adj(ASN1_TIME *s, long adj); + +const char *X509_get_default_cert_area(void); +const char *X509_get_default_cert_dir(void); +const char *X509_get_default_cert_file(void); +const char *X509_get_default_cert_dir_env(void); +const char *X509_get_default_cert_file_env(void); +const char *X509_get_default_private_dir(void); + +X509_REQ *X509_to_X509_REQ(X509 *x, EVP_PKEY *pkey, const EVP_MD *md); +X509 *X509_REQ_to_X509(X509_REQ *r, int days, EVP_PKEY *pkey); + +DECLARE_ASN1_FUNCTIONS(X509_ALGOR) +DECLARE_ASN1_ENCODE_FUNCTIONS(X509_ALGORS, X509_ALGORS, X509_ALGORS) +DECLARE_ASN1_FUNCTIONS(X509_VAL) + +DECLARE_ASN1_FUNCTIONS(X509_PUBKEY) + +int X509_PUBKEY_set(X509_PUBKEY **x, EVP_PKEY *pkey); +EVP_PKEY *X509_PUBKEY_get0(X509_PUBKEY *key); +EVP_PKEY *X509_PUBKEY_get(X509_PUBKEY *key); +int X509_get_pubkey_parameters(EVP_PKEY *pkey, STACK_OF(X509) *chain); +long X509_get_pathlen(X509 *x); +int i2d_PUBKEY(EVP_PKEY *a, unsigned char **pp); +EVP_PKEY *d2i_PUBKEY(EVP_PKEY **a, const unsigned char **pp, long length); +# ifndef OPENSSL_NO_RSA +int i2d_RSA_PUBKEY(RSA *a, unsigned char **pp); +RSA *d2i_RSA_PUBKEY(RSA **a, const unsigned char **pp, long length); +# endif +# ifndef OPENSSL_NO_DSA +int i2d_DSA_PUBKEY(DSA *a, unsigned char **pp); +DSA *d2i_DSA_PUBKEY(DSA **a, const unsigned char **pp, long length); +# endif +# ifndef OPENSSL_NO_EC +int i2d_EC_PUBKEY(EC_KEY *a, unsigned char **pp); +EC_KEY *d2i_EC_PUBKEY(EC_KEY **a, const unsigned char **pp, long length); +# endif + +DECLARE_ASN1_FUNCTIONS(X509_SIG) +void X509_SIG_get0(const X509_SIG *sig, const X509_ALGOR **palg, + const ASN1_OCTET_STRING **pdigest); +void X509_SIG_getm(X509_SIG *sig, X509_ALGOR **palg, + ASN1_OCTET_STRING **pdigest); + +DECLARE_ASN1_FUNCTIONS(X509_REQ_INFO) +DECLARE_ASN1_FUNCTIONS(X509_REQ) + +DECLARE_ASN1_FUNCTIONS(X509_ATTRIBUTE) +X509_ATTRIBUTE *X509_ATTRIBUTE_create(int nid, int atrtype, void *value); + +DECLARE_ASN1_FUNCTIONS(X509_EXTENSION) +DECLARE_ASN1_ENCODE_FUNCTIONS(X509_EXTENSIONS, X509_EXTENSIONS, X509_EXTENSIONS) + +DECLARE_ASN1_FUNCTIONS(X509_NAME_ENTRY) + +DECLARE_ASN1_FUNCTIONS(X509_NAME) + +int X509_NAME_set(X509_NAME **xn, X509_NAME *name); + +DECLARE_ASN1_FUNCTIONS(X509_CINF) + +DECLARE_ASN1_FUNCTIONS(X509) +DECLARE_ASN1_FUNCTIONS(X509_CERT_AUX) + +#define X509_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509, l, p, newf, dupf, freef) +int X509_set_ex_data(X509 *r, int idx, void *arg); +void *X509_get_ex_data(X509 *r, int idx); +int i2d_X509_AUX(X509 *a, unsigned char **pp); +X509 *d2i_X509_AUX(X509 **a, const unsigned char **pp, long length); + +int i2d_re_X509_tbs(X509 *x, unsigned char **pp); + +int X509_SIG_INFO_get(const X509_SIG_INFO *siginf, int *mdnid, int *pknid, + int *secbits, uint32_t *flags); +void X509_SIG_INFO_set(X509_SIG_INFO *siginf, int mdnid, int pknid, + int secbits, uint32_t flags); + +int X509_get_signature_info(X509 *x, int *mdnid, int *pknid, int *secbits, + uint32_t *flags); + +void X509_get0_signature(const ASN1_BIT_STRING **psig, + const X509_ALGOR **palg, const X509 *x); +int X509_get_signature_nid(const X509 *x); + +int X509_trusted(const X509 *x); +int X509_alias_set1(X509 *x, const unsigned char *name, int len); +int X509_keyid_set1(X509 *x, const unsigned char *id, int len); +unsigned char *X509_alias_get0(X509 *x, int *len); +unsigned char *X509_keyid_get0(X509 *x, int *len); +int (*X509_TRUST_set_default(int (*trust) (int, X509 *, int))) (int, X509 *, + int); +int X509_TRUST_set(int *t, int trust); +int X509_add1_trust_object(X509 *x, const ASN1_OBJECT *obj); +int X509_add1_reject_object(X509 *x, const ASN1_OBJECT *obj); +void X509_trust_clear(X509 *x); +void X509_reject_clear(X509 *x); + +STACK_OF(ASN1_OBJECT) *X509_get0_trust_objects(X509 *x); +STACK_OF(ASN1_OBJECT) *X509_get0_reject_objects(X509 *x); + +DECLARE_ASN1_FUNCTIONS(X509_REVOKED) +DECLARE_ASN1_FUNCTIONS(X509_CRL_INFO) +DECLARE_ASN1_FUNCTIONS(X509_CRL) + +int X509_CRL_add0_revoked(X509_CRL *crl, X509_REVOKED *rev); +int X509_CRL_get0_by_serial(X509_CRL *crl, + X509_REVOKED **ret, ASN1_INTEGER *serial); +int X509_CRL_get0_by_cert(X509_CRL *crl, X509_REVOKED **ret, X509 *x); + +X509_PKEY *X509_PKEY_new(void); +void X509_PKEY_free(X509_PKEY *a); + +DECLARE_ASN1_FUNCTIONS(NETSCAPE_SPKI) +DECLARE_ASN1_FUNCTIONS(NETSCAPE_SPKAC) +DECLARE_ASN1_FUNCTIONS(NETSCAPE_CERT_SEQUENCE) + +X509_INFO *X509_INFO_new(void); +void X509_INFO_free(X509_INFO *a); +char *X509_NAME_oneline(const X509_NAME *a, char *buf, int size); + +int ASN1_verify(i2d_of_void *i2d, X509_ALGOR *algor1, + ASN1_BIT_STRING *signature, char *data, EVP_PKEY *pkey); + +int ASN1_digest(i2d_of_void *i2d, const EVP_MD *type, char *data, + unsigned char *md, unsigned int *len); + +int ASN1_sign(i2d_of_void *i2d, X509_ALGOR *algor1, + X509_ALGOR *algor2, ASN1_BIT_STRING *signature, + char *data, EVP_PKEY *pkey, const EVP_MD *type); + +int ASN1_item_digest(const ASN1_ITEM *it, const EVP_MD *type, void *data, + unsigned char *md, unsigned int *len); + +int ASN1_item_verify(const ASN1_ITEM *it, X509_ALGOR *algor1, + ASN1_BIT_STRING *signature, void *data, EVP_PKEY *pkey); + +int ASN1_item_sign(const ASN1_ITEM *it, X509_ALGOR *algor1, + X509_ALGOR *algor2, ASN1_BIT_STRING *signature, void *data, + EVP_PKEY *pkey, const EVP_MD *type); +int ASN1_item_sign_ctx(const ASN1_ITEM *it, X509_ALGOR *algor1, + X509_ALGOR *algor2, ASN1_BIT_STRING *signature, + void *asn, EVP_MD_CTX *ctx); + +long X509_get_version(const X509 *x); +int X509_set_version(X509 *x, long version); +int X509_set_serialNumber(X509 *x, ASN1_INTEGER *serial); +ASN1_INTEGER *X509_get_serialNumber(X509 *x); +const ASN1_INTEGER *X509_get0_serialNumber(const X509 *x); +int X509_set_issuer_name(X509 *x, X509_NAME *name); +X509_NAME *X509_get_issuer_name(const X509 *a); +int X509_set_subject_name(X509 *x, X509_NAME *name); +X509_NAME *X509_get_subject_name(const X509 *a); +const ASN1_TIME * X509_get0_notBefore(const X509 *x); +ASN1_TIME *X509_getm_notBefore(const X509 *x); +int X509_set1_notBefore(X509 *x, const ASN1_TIME *tm); +const ASN1_TIME *X509_get0_notAfter(const X509 *x); +ASN1_TIME *X509_getm_notAfter(const X509 *x); +int X509_set1_notAfter(X509 *x, const ASN1_TIME *tm); +int X509_set_pubkey(X509 *x, EVP_PKEY *pkey); +int X509_up_ref(X509 *x); +int X509_get_signature_type(const X509 *x); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define X509_get_notBefore X509_getm_notBefore +# define X509_get_notAfter X509_getm_notAfter +# define X509_set_notBefore X509_set1_notBefore +# define X509_set_notAfter X509_set1_notAfter +#endif + + +/* + * This one is only used so that a binary form can output, as in + * i2d_X509_PUBKEY(X509_get_X509_PUBKEY(x), &buf) + */ +X509_PUBKEY *X509_get_X509_PUBKEY(const X509 *x); +const STACK_OF(X509_EXTENSION) *X509_get0_extensions(const X509 *x); +void X509_get0_uids(const X509 *x, const ASN1_BIT_STRING **piuid, + const ASN1_BIT_STRING **psuid); +const X509_ALGOR *X509_get0_tbs_sigalg(const X509 *x); + +EVP_PKEY *X509_get0_pubkey(const X509 *x); +EVP_PKEY *X509_get_pubkey(X509 *x); +ASN1_BIT_STRING *X509_get0_pubkey_bitstr(const X509 *x); +int X509_certificate_type(const X509 *x, const EVP_PKEY *pubkey); + +long X509_REQ_get_version(const X509_REQ *req); +int X509_REQ_set_version(X509_REQ *x, long version); +X509_NAME *X509_REQ_get_subject_name(const X509_REQ *req); +int X509_REQ_set_subject_name(X509_REQ *req, X509_NAME *name); +void X509_REQ_get0_signature(const X509_REQ *req, const ASN1_BIT_STRING **psig, + const X509_ALGOR **palg); +int X509_REQ_get_signature_nid(const X509_REQ *req); +int i2d_re_X509_REQ_tbs(X509_REQ *req, unsigned char **pp); +int X509_REQ_set_pubkey(X509_REQ *x, EVP_PKEY *pkey); +EVP_PKEY *X509_REQ_get_pubkey(X509_REQ *req); +EVP_PKEY *X509_REQ_get0_pubkey(X509_REQ *req); +X509_PUBKEY *X509_REQ_get_X509_PUBKEY(X509_REQ *req); +int X509_REQ_extension_nid(int nid); +int *X509_REQ_get_extension_nids(void); +void X509_REQ_set_extension_nids(int *nids); +STACK_OF(X509_EXTENSION) *X509_REQ_get_extensions(X509_REQ *req); +int X509_REQ_add_extensions_nid(X509_REQ *req, STACK_OF(X509_EXTENSION) *exts, + int nid); +int X509_REQ_add_extensions(X509_REQ *req, STACK_OF(X509_EXTENSION) *exts); +int X509_REQ_get_attr_count(const X509_REQ *req); +int X509_REQ_get_attr_by_NID(const X509_REQ *req, int nid, int lastpos); +int X509_REQ_get_attr_by_OBJ(const X509_REQ *req, const ASN1_OBJECT *obj, + int lastpos); +X509_ATTRIBUTE *X509_REQ_get_attr(const X509_REQ *req, int loc); +X509_ATTRIBUTE *X509_REQ_delete_attr(X509_REQ *req, int loc); +int X509_REQ_add1_attr(X509_REQ *req, X509_ATTRIBUTE *attr); +int X509_REQ_add1_attr_by_OBJ(X509_REQ *req, + const ASN1_OBJECT *obj, int type, + const unsigned char *bytes, int len); +int X509_REQ_add1_attr_by_NID(X509_REQ *req, + int nid, int type, + const unsigned char *bytes, int len); +int X509_REQ_add1_attr_by_txt(X509_REQ *req, + const char *attrname, int type, + const unsigned char *bytes, int len); + +int X509_CRL_set_version(X509_CRL *x, long version); +int X509_CRL_set_issuer_name(X509_CRL *x, X509_NAME *name); +int X509_CRL_set1_lastUpdate(X509_CRL *x, const ASN1_TIME *tm); +int X509_CRL_set1_nextUpdate(X509_CRL *x, const ASN1_TIME *tm); +int X509_CRL_sort(X509_CRL *crl); +int X509_CRL_up_ref(X509_CRL *crl); + +# if OPENSSL_API_COMPAT < 0x10100000L +# define X509_CRL_set_lastUpdate X509_CRL_set1_lastUpdate +# define X509_CRL_set_nextUpdate X509_CRL_set1_nextUpdate +#endif + +long X509_CRL_get_version(const X509_CRL *crl); +const ASN1_TIME *X509_CRL_get0_lastUpdate(const X509_CRL *crl); +const ASN1_TIME *X509_CRL_get0_nextUpdate(const X509_CRL *crl); +DEPRECATEDIN_1_1_0(ASN1_TIME *X509_CRL_get_lastUpdate(X509_CRL *crl)) +DEPRECATEDIN_1_1_0(ASN1_TIME *X509_CRL_get_nextUpdate(X509_CRL *crl)) +X509_NAME *X509_CRL_get_issuer(const X509_CRL *crl); +const STACK_OF(X509_EXTENSION) *X509_CRL_get0_extensions(const X509_CRL *crl); +STACK_OF(X509_REVOKED) *X509_CRL_get_REVOKED(X509_CRL *crl); +void X509_CRL_get0_signature(const X509_CRL *crl, const ASN1_BIT_STRING **psig, + const X509_ALGOR **palg); +int X509_CRL_get_signature_nid(const X509_CRL *crl); +int i2d_re_X509_CRL_tbs(X509_CRL *req, unsigned char **pp); + +const ASN1_INTEGER *X509_REVOKED_get0_serialNumber(const X509_REVOKED *x); +int X509_REVOKED_set_serialNumber(X509_REVOKED *x, ASN1_INTEGER *serial); +const ASN1_TIME *X509_REVOKED_get0_revocationDate(const X509_REVOKED *x); +int X509_REVOKED_set_revocationDate(X509_REVOKED *r, ASN1_TIME *tm); +const STACK_OF(X509_EXTENSION) * +X509_REVOKED_get0_extensions(const X509_REVOKED *r); + +X509_CRL *X509_CRL_diff(X509_CRL *base, X509_CRL *newer, + EVP_PKEY *skey, const EVP_MD *md, unsigned int flags); + +int X509_REQ_check_private_key(X509_REQ *x509, EVP_PKEY *pkey); + +int X509_check_private_key(const X509 *x509, const EVP_PKEY *pkey); +int X509_chain_check_suiteb(int *perror_depth, + X509 *x, STACK_OF(X509) *chain, + unsigned long flags); +int X509_CRL_check_suiteb(X509_CRL *crl, EVP_PKEY *pk, unsigned long flags); +STACK_OF(X509) *X509_chain_up_ref(STACK_OF(X509) *chain); + +int X509_issuer_and_serial_cmp(const X509 *a, const X509 *b); +unsigned long X509_issuer_and_serial_hash(X509 *a); + +int X509_issuer_name_cmp(const X509 *a, const X509 *b); +unsigned long X509_issuer_name_hash(X509 *a); + +int X509_subject_name_cmp(const X509 *a, const X509 *b); +unsigned long X509_subject_name_hash(X509 *x); + +# ifndef OPENSSL_NO_MD5 +unsigned long X509_issuer_name_hash_old(X509 *a); +unsigned long X509_subject_name_hash_old(X509 *x); +# endif + +int X509_cmp(const X509 *a, const X509 *b); +int X509_NAME_cmp(const X509_NAME *a, const X509_NAME *b); +unsigned long X509_NAME_hash(X509_NAME *x); +unsigned long X509_NAME_hash_old(X509_NAME *x); + +int X509_CRL_cmp(const X509_CRL *a, const X509_CRL *b); +int X509_CRL_match(const X509_CRL *a, const X509_CRL *b); +int X509_aux_print(BIO *out, X509 *x, int indent); +# ifndef OPENSSL_NO_STDIO +int X509_print_ex_fp(FILE *bp, X509 *x, unsigned long nmflag, + unsigned long cflag); +int X509_print_fp(FILE *bp, X509 *x); +int X509_CRL_print_fp(FILE *bp, X509_CRL *x); +int X509_REQ_print_fp(FILE *bp, X509_REQ *req); +int X509_NAME_print_ex_fp(FILE *fp, const X509_NAME *nm, int indent, + unsigned long flags); +# endif + +int X509_NAME_print(BIO *bp, const X509_NAME *name, int obase); +int X509_NAME_print_ex(BIO *out, const X509_NAME *nm, int indent, + unsigned long flags); +int X509_print_ex(BIO *bp, X509 *x, unsigned long nmflag, + unsigned long cflag); +int X509_print(BIO *bp, X509 *x); +int X509_ocspid_print(BIO *bp, X509 *x); +int X509_CRL_print_ex(BIO *out, X509_CRL *x, unsigned long nmflag); +int X509_CRL_print(BIO *bp, X509_CRL *x); +int X509_REQ_print_ex(BIO *bp, X509_REQ *x, unsigned long nmflag, + unsigned long cflag); +int X509_REQ_print(BIO *bp, X509_REQ *req); + +int X509_NAME_entry_count(const X509_NAME *name); +int X509_NAME_get_text_by_NID(X509_NAME *name, int nid, char *buf, int len); +int X509_NAME_get_text_by_OBJ(X509_NAME *name, const ASN1_OBJECT *obj, + char *buf, int len); + +/* + * NOTE: you should be passing -1, not 0 as lastpos. The functions that use + * lastpos, search after that position on. + */ +int X509_NAME_get_index_by_NID(X509_NAME *name, int nid, int lastpos); +int X509_NAME_get_index_by_OBJ(X509_NAME *name, const ASN1_OBJECT *obj, + int lastpos); +X509_NAME_ENTRY *X509_NAME_get_entry(const X509_NAME *name, int loc); +X509_NAME_ENTRY *X509_NAME_delete_entry(X509_NAME *name, int loc); +int X509_NAME_add_entry(X509_NAME *name, const X509_NAME_ENTRY *ne, + int loc, int set); +int X509_NAME_add_entry_by_OBJ(X509_NAME *name, const ASN1_OBJECT *obj, int type, + const unsigned char *bytes, int len, int loc, + int set); +int X509_NAME_add_entry_by_NID(X509_NAME *name, int nid, int type, + const unsigned char *bytes, int len, int loc, + int set); +X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_txt(X509_NAME_ENTRY **ne, + const char *field, int type, + const unsigned char *bytes, + int len); +X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid, + int type, + const unsigned char *bytes, + int len); +int X509_NAME_add_entry_by_txt(X509_NAME *name, const char *field, int type, + const unsigned char *bytes, int len, int loc, + int set); +X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne, + const ASN1_OBJECT *obj, int type, + const unsigned char *bytes, + int len); +int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne, const ASN1_OBJECT *obj); +int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type, + const unsigned char *bytes, int len); +ASN1_OBJECT *X509_NAME_ENTRY_get_object(const X509_NAME_ENTRY *ne); +ASN1_STRING * X509_NAME_ENTRY_get_data(const X509_NAME_ENTRY *ne); +int X509_NAME_ENTRY_set(const X509_NAME_ENTRY *ne); + +int X509_NAME_get0_der(X509_NAME *nm, const unsigned char **pder, + size_t *pderlen); + +int X509v3_get_ext_count(const STACK_OF(X509_EXTENSION) *x); +int X509v3_get_ext_by_NID(const STACK_OF(X509_EXTENSION) *x, + int nid, int lastpos); +int X509v3_get_ext_by_OBJ(const STACK_OF(X509_EXTENSION) *x, + const ASN1_OBJECT *obj, int lastpos); +int X509v3_get_ext_by_critical(const STACK_OF(X509_EXTENSION) *x, + int crit, int lastpos); +X509_EXTENSION *X509v3_get_ext(const STACK_OF(X509_EXTENSION) *x, int loc); +X509_EXTENSION *X509v3_delete_ext(STACK_OF(X509_EXTENSION) *x, int loc); +STACK_OF(X509_EXTENSION) *X509v3_add_ext(STACK_OF(X509_EXTENSION) **x, + X509_EXTENSION *ex, int loc); + +int X509_get_ext_count(const X509 *x); +int X509_get_ext_by_NID(const X509 *x, int nid, int lastpos); +int X509_get_ext_by_OBJ(const X509 *x, const ASN1_OBJECT *obj, int lastpos); +int X509_get_ext_by_critical(const X509 *x, int crit, int lastpos); +X509_EXTENSION *X509_get_ext(const X509 *x, int loc); +X509_EXTENSION *X509_delete_ext(X509 *x, int loc); +int X509_add_ext(X509 *x, X509_EXTENSION *ex, int loc); +void *X509_get_ext_d2i(const X509 *x, int nid, int *crit, int *idx); +int X509_add1_ext_i2d(X509 *x, int nid, void *value, int crit, + unsigned long flags); + +int X509_CRL_get_ext_count(const X509_CRL *x); +int X509_CRL_get_ext_by_NID(const X509_CRL *x, int nid, int lastpos); +int X509_CRL_get_ext_by_OBJ(const X509_CRL *x, const ASN1_OBJECT *obj, + int lastpos); +int X509_CRL_get_ext_by_critical(const X509_CRL *x, int crit, int lastpos); +X509_EXTENSION *X509_CRL_get_ext(const X509_CRL *x, int loc); +X509_EXTENSION *X509_CRL_delete_ext(X509_CRL *x, int loc); +int X509_CRL_add_ext(X509_CRL *x, X509_EXTENSION *ex, int loc); +void *X509_CRL_get_ext_d2i(const X509_CRL *x, int nid, int *crit, int *idx); +int X509_CRL_add1_ext_i2d(X509_CRL *x, int nid, void *value, int crit, + unsigned long flags); + +int X509_REVOKED_get_ext_count(const X509_REVOKED *x); +int X509_REVOKED_get_ext_by_NID(const X509_REVOKED *x, int nid, int lastpos); +int X509_REVOKED_get_ext_by_OBJ(const X509_REVOKED *x, const ASN1_OBJECT *obj, + int lastpos); +int X509_REVOKED_get_ext_by_critical(const X509_REVOKED *x, int crit, + int lastpos); +X509_EXTENSION *X509_REVOKED_get_ext(const X509_REVOKED *x, int loc); +X509_EXTENSION *X509_REVOKED_delete_ext(X509_REVOKED *x, int loc); +int X509_REVOKED_add_ext(X509_REVOKED *x, X509_EXTENSION *ex, int loc); +void *X509_REVOKED_get_ext_d2i(const X509_REVOKED *x, int nid, int *crit, + int *idx); +int X509_REVOKED_add1_ext_i2d(X509_REVOKED *x, int nid, void *value, int crit, + unsigned long flags); + +X509_EXTENSION *X509_EXTENSION_create_by_NID(X509_EXTENSION **ex, + int nid, int crit, + ASN1_OCTET_STRING *data); +X509_EXTENSION *X509_EXTENSION_create_by_OBJ(X509_EXTENSION **ex, + const ASN1_OBJECT *obj, int crit, + ASN1_OCTET_STRING *data); +int X509_EXTENSION_set_object(X509_EXTENSION *ex, const ASN1_OBJECT *obj); +int X509_EXTENSION_set_critical(X509_EXTENSION *ex, int crit); +int X509_EXTENSION_set_data(X509_EXTENSION *ex, ASN1_OCTET_STRING *data); +ASN1_OBJECT *X509_EXTENSION_get_object(X509_EXTENSION *ex); +ASN1_OCTET_STRING *X509_EXTENSION_get_data(X509_EXTENSION *ne); +int X509_EXTENSION_get_critical(const X509_EXTENSION *ex); + +int X509at_get_attr_count(const STACK_OF(X509_ATTRIBUTE) *x); +int X509at_get_attr_by_NID(const STACK_OF(X509_ATTRIBUTE) *x, int nid, + int lastpos); +int X509at_get_attr_by_OBJ(const STACK_OF(X509_ATTRIBUTE) *sk, + const ASN1_OBJECT *obj, int lastpos); +X509_ATTRIBUTE *X509at_get_attr(const STACK_OF(X509_ATTRIBUTE) *x, int loc); +X509_ATTRIBUTE *X509at_delete_attr(STACK_OF(X509_ATTRIBUTE) *x, int loc); +STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr(STACK_OF(X509_ATTRIBUTE) **x, + X509_ATTRIBUTE *attr); +STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_OBJ(STACK_OF(X509_ATTRIBUTE) + **x, const ASN1_OBJECT *obj, + int type, + const unsigned char *bytes, + int len); +STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_NID(STACK_OF(X509_ATTRIBUTE) + **x, int nid, int type, + const unsigned char *bytes, + int len); +STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_txt(STACK_OF(X509_ATTRIBUTE) + **x, const char *attrname, + int type, + const unsigned char *bytes, + int len); +void *X509at_get0_data_by_OBJ(STACK_OF(X509_ATTRIBUTE) *x, + const ASN1_OBJECT *obj, int lastpos, int type); +X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_NID(X509_ATTRIBUTE **attr, int nid, + int atrtype, const void *data, + int len); +X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_OBJ(X509_ATTRIBUTE **attr, + const ASN1_OBJECT *obj, + int atrtype, const void *data, + int len); +X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_txt(X509_ATTRIBUTE **attr, + const char *atrname, int type, + const unsigned char *bytes, + int len); +int X509_ATTRIBUTE_set1_object(X509_ATTRIBUTE *attr, const ASN1_OBJECT *obj); +int X509_ATTRIBUTE_set1_data(X509_ATTRIBUTE *attr, int attrtype, + const void *data, int len); +void *X509_ATTRIBUTE_get0_data(X509_ATTRIBUTE *attr, int idx, int atrtype, + void *data); +int X509_ATTRIBUTE_count(const X509_ATTRIBUTE *attr); +ASN1_OBJECT *X509_ATTRIBUTE_get0_object(X509_ATTRIBUTE *attr); +ASN1_TYPE *X509_ATTRIBUTE_get0_type(X509_ATTRIBUTE *attr, int idx); + +int EVP_PKEY_get_attr_count(const EVP_PKEY *key); +int EVP_PKEY_get_attr_by_NID(const EVP_PKEY *key, int nid, int lastpos); +int EVP_PKEY_get_attr_by_OBJ(const EVP_PKEY *key, const ASN1_OBJECT *obj, + int lastpos); +X509_ATTRIBUTE *EVP_PKEY_get_attr(const EVP_PKEY *key, int loc); +X509_ATTRIBUTE *EVP_PKEY_delete_attr(EVP_PKEY *key, int loc); +int EVP_PKEY_add1_attr(EVP_PKEY *key, X509_ATTRIBUTE *attr); +int EVP_PKEY_add1_attr_by_OBJ(EVP_PKEY *key, + const ASN1_OBJECT *obj, int type, + const unsigned char *bytes, int len); +int EVP_PKEY_add1_attr_by_NID(EVP_PKEY *key, + int nid, int type, + const unsigned char *bytes, int len); +int EVP_PKEY_add1_attr_by_txt(EVP_PKEY *key, + const char *attrname, int type, + const unsigned char *bytes, int len); + +int X509_verify_cert(X509_STORE_CTX *ctx); + +/* lookup a cert from a X509 STACK */ +X509 *X509_find_by_issuer_and_serial(STACK_OF(X509) *sk, X509_NAME *name, + ASN1_INTEGER *serial); +X509 *X509_find_by_subject(STACK_OF(X509) *sk, X509_NAME *name); + +DECLARE_ASN1_FUNCTIONS(PBEPARAM) +DECLARE_ASN1_FUNCTIONS(PBE2PARAM) +DECLARE_ASN1_FUNCTIONS(PBKDF2PARAM) +#ifndef OPENSSL_NO_SCRYPT +DECLARE_ASN1_FUNCTIONS(SCRYPT_PARAMS) +#endif + +int PKCS5_pbe_set0_algor(X509_ALGOR *algor, int alg, int iter, + const unsigned char *salt, int saltlen); + +X509_ALGOR *PKCS5_pbe_set(int alg, int iter, + const unsigned char *salt, int saltlen); +X509_ALGOR *PKCS5_pbe2_set(const EVP_CIPHER *cipher, int iter, + unsigned char *salt, int saltlen); +X509_ALGOR *PKCS5_pbe2_set_iv(const EVP_CIPHER *cipher, int iter, + unsigned char *salt, int saltlen, + unsigned char *aiv, int prf_nid); + +#ifndef OPENSSL_NO_SCRYPT +X509_ALGOR *PKCS5_pbe2_set_scrypt(const EVP_CIPHER *cipher, + const unsigned char *salt, int saltlen, + unsigned char *aiv, uint64_t N, uint64_t r, + uint64_t p); +#endif + +X509_ALGOR *PKCS5_pbkdf2_set(int iter, unsigned char *salt, int saltlen, + int prf_nid, int keylen); + +/* PKCS#8 utilities */ + +DECLARE_ASN1_FUNCTIONS(PKCS8_PRIV_KEY_INFO) + +EVP_PKEY *EVP_PKCS82PKEY(const PKCS8_PRIV_KEY_INFO *p8); +PKCS8_PRIV_KEY_INFO *EVP_PKEY2PKCS8(EVP_PKEY *pkey); + +int PKCS8_pkey_set0(PKCS8_PRIV_KEY_INFO *priv, ASN1_OBJECT *aobj, + int version, int ptype, void *pval, + unsigned char *penc, int penclen); +int PKCS8_pkey_get0(const ASN1_OBJECT **ppkalg, + const unsigned char **pk, int *ppklen, + const X509_ALGOR **pa, const PKCS8_PRIV_KEY_INFO *p8); + +const STACK_OF(X509_ATTRIBUTE) * +PKCS8_pkey_get0_attrs(const PKCS8_PRIV_KEY_INFO *p8); +int PKCS8_pkey_add1_attr_by_NID(PKCS8_PRIV_KEY_INFO *p8, int nid, int type, + const unsigned char *bytes, int len); + +int X509_PUBKEY_set0_param(X509_PUBKEY *pub, ASN1_OBJECT *aobj, + int ptype, void *pval, + unsigned char *penc, int penclen); +int X509_PUBKEY_get0_param(ASN1_OBJECT **ppkalg, + const unsigned char **pk, int *ppklen, + X509_ALGOR **pa, X509_PUBKEY *pub); + +int X509_check_trust(X509 *x, int id, int flags); +int X509_TRUST_get_count(void); +X509_TRUST *X509_TRUST_get0(int idx); +int X509_TRUST_get_by_id(int id); +int X509_TRUST_add(int id, int flags, int (*ck) (X509_TRUST *, X509 *, int), + const char *name, int arg1, void *arg2); +void X509_TRUST_cleanup(void); +int X509_TRUST_get_flags(const X509_TRUST *xp); +char *X509_TRUST_get0_name(const X509_TRUST *xp); +int X509_TRUST_get_trust(const X509_TRUST *xp); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/x509_vfy.h b/include/openssl/x509_vfy.h new file mode 100644 index 0000000..0ce72c5 --- /dev/null +++ b/include/openssl/x509_vfy.h @@ -0,0 +1,624 @@ +/* + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_X509_VFY_H +# define HEADER_X509_VFY_H + +/* + * Protect against recursion, x509.h and x509_vfy.h each include the other. + */ +# ifndef HEADER_X509_H +# include +# endif + +# include +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/*- +SSL_CTX -> X509_STORE + -> X509_LOOKUP + ->X509_LOOKUP_METHOD + -> X509_LOOKUP + ->X509_LOOKUP_METHOD + +SSL -> X509_STORE_CTX + ->X509_STORE + +The X509_STORE holds the tables etc for verification stuff. +A X509_STORE_CTX is used while validating a single certificate. +The X509_STORE has X509_LOOKUPs for looking up certs. +The X509_STORE then calls a function to actually verify the +certificate chain. +*/ + +typedef enum { + X509_LU_NONE = 0, + X509_LU_X509, X509_LU_CRL +} X509_LOOKUP_TYPE; + +#if OPENSSL_API_COMPAT < 0x10100000L +#define X509_LU_RETRY -1 +#define X509_LU_FAIL 0 +#endif + +DEFINE_STACK_OF(X509_LOOKUP) +DEFINE_STACK_OF(X509_OBJECT) +DEFINE_STACK_OF(X509_VERIFY_PARAM) + +int X509_STORE_set_depth(X509_STORE *store, int depth); + +typedef int (*X509_STORE_CTX_verify_cb)(int, X509_STORE_CTX *); +typedef int (*X509_STORE_CTX_verify_fn)(X509_STORE_CTX *); +typedef int (*X509_STORE_CTX_get_issuer_fn)(X509 **issuer, + X509_STORE_CTX *ctx, X509 *x); +typedef int (*X509_STORE_CTX_check_issued_fn)(X509_STORE_CTX *ctx, + X509 *x, X509 *issuer); +typedef int (*X509_STORE_CTX_check_revocation_fn)(X509_STORE_CTX *ctx); +typedef int (*X509_STORE_CTX_get_crl_fn)(X509_STORE_CTX *ctx, + X509_CRL **crl, X509 *x); +typedef int (*X509_STORE_CTX_check_crl_fn)(X509_STORE_CTX *ctx, X509_CRL *crl); +typedef int (*X509_STORE_CTX_cert_crl_fn)(X509_STORE_CTX *ctx, + X509_CRL *crl, X509 *x); +typedef int (*X509_STORE_CTX_check_policy_fn)(X509_STORE_CTX *ctx); +typedef STACK_OF(X509) *(*X509_STORE_CTX_lookup_certs_fn)(X509_STORE_CTX *ctx, + X509_NAME *nm); +typedef STACK_OF(X509_CRL) *(*X509_STORE_CTX_lookup_crls_fn)(X509_STORE_CTX *ctx, + X509_NAME *nm); +typedef int (*X509_STORE_CTX_cleanup_fn)(X509_STORE_CTX *ctx); + + +void X509_STORE_CTX_set_depth(X509_STORE_CTX *ctx, int depth); + +# define X509_STORE_CTX_set_app_data(ctx,data) \ + X509_STORE_CTX_set_ex_data(ctx,0,data) +# define X509_STORE_CTX_get_app_data(ctx) \ + X509_STORE_CTX_get_ex_data(ctx,0) + +# define X509_L_FILE_LOAD 1 +# define X509_L_ADD_DIR 2 + +# define X509_LOOKUP_load_file(x,name,type) \ + X509_LOOKUP_ctrl((x),X509_L_FILE_LOAD,(name),(long)(type),NULL) + +# define X509_LOOKUP_add_dir(x,name,type) \ + X509_LOOKUP_ctrl((x),X509_L_ADD_DIR,(name),(long)(type),NULL) + +# define X509_V_OK 0 +# define X509_V_ERR_UNSPECIFIED 1 +# define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT 2 +# define X509_V_ERR_UNABLE_TO_GET_CRL 3 +# define X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE 4 +# define X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE 5 +# define X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY 6 +# define X509_V_ERR_CERT_SIGNATURE_FAILURE 7 +# define X509_V_ERR_CRL_SIGNATURE_FAILURE 8 +# define X509_V_ERR_CERT_NOT_YET_VALID 9 +# define X509_V_ERR_CERT_HAS_EXPIRED 10 +# define X509_V_ERR_CRL_NOT_YET_VALID 11 +# define X509_V_ERR_CRL_HAS_EXPIRED 12 +# define X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD 13 +# define X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD 14 +# define X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD 15 +# define X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD 16 +# define X509_V_ERR_OUT_OF_MEM 17 +# define X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT 18 +# define X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN 19 +# define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY 20 +# define X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE 21 +# define X509_V_ERR_CERT_CHAIN_TOO_LONG 22 +# define X509_V_ERR_CERT_REVOKED 23 +# define X509_V_ERR_INVALID_CA 24 +# define X509_V_ERR_PATH_LENGTH_EXCEEDED 25 +# define X509_V_ERR_INVALID_PURPOSE 26 +# define X509_V_ERR_CERT_UNTRUSTED 27 +# define X509_V_ERR_CERT_REJECTED 28 +/* These are 'informational' when looking for issuer cert */ +# define X509_V_ERR_SUBJECT_ISSUER_MISMATCH 29 +# define X509_V_ERR_AKID_SKID_MISMATCH 30 +# define X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH 31 +# define X509_V_ERR_KEYUSAGE_NO_CERTSIGN 32 +# define X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER 33 +# define X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION 34 +# define X509_V_ERR_KEYUSAGE_NO_CRL_SIGN 35 +# define X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION 36 +# define X509_V_ERR_INVALID_NON_CA 37 +# define X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED 38 +# define X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE 39 +# define X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED 40 +# define X509_V_ERR_INVALID_EXTENSION 41 +# define X509_V_ERR_INVALID_POLICY_EXTENSION 42 +# define X509_V_ERR_NO_EXPLICIT_POLICY 43 +# define X509_V_ERR_DIFFERENT_CRL_SCOPE 44 +# define X509_V_ERR_UNSUPPORTED_EXTENSION_FEATURE 45 +# define X509_V_ERR_UNNESTED_RESOURCE 46 +# define X509_V_ERR_PERMITTED_VIOLATION 47 +# define X509_V_ERR_EXCLUDED_VIOLATION 48 +# define X509_V_ERR_SUBTREE_MINMAX 49 +/* The application is not happy */ +# define X509_V_ERR_APPLICATION_VERIFICATION 50 +# define X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE 51 +# define X509_V_ERR_UNSUPPORTED_CONSTRAINT_SYNTAX 52 +# define X509_V_ERR_UNSUPPORTED_NAME_SYNTAX 53 +# define X509_V_ERR_CRL_PATH_VALIDATION_ERROR 54 +/* Another issuer check debug option */ +# define X509_V_ERR_PATH_LOOP 55 +/* Suite B mode algorithm violation */ +# define X509_V_ERR_SUITE_B_INVALID_VERSION 56 +# define X509_V_ERR_SUITE_B_INVALID_ALGORITHM 57 +# define X509_V_ERR_SUITE_B_INVALID_CURVE 58 +# define X509_V_ERR_SUITE_B_INVALID_SIGNATURE_ALGORITHM 59 +# define X509_V_ERR_SUITE_B_LOS_NOT_ALLOWED 60 +# define X509_V_ERR_SUITE_B_CANNOT_SIGN_P_384_WITH_P_256 61 +/* Host, email and IP check errors */ +# define X509_V_ERR_HOSTNAME_MISMATCH 62 +# define X509_V_ERR_EMAIL_MISMATCH 63 +# define X509_V_ERR_IP_ADDRESS_MISMATCH 64 +/* DANE TLSA errors */ +# define X509_V_ERR_DANE_NO_MATCH 65 +/* security level errors */ +# define X509_V_ERR_EE_KEY_TOO_SMALL 66 +# define X509_V_ERR_CA_KEY_TOO_SMALL 67 +# define X509_V_ERR_CA_MD_TOO_WEAK 68 +/* Caller error */ +# define X509_V_ERR_INVALID_CALL 69 +/* Issuer lookup error */ +# define X509_V_ERR_STORE_LOOKUP 70 +/* Certificate transparency */ +# define X509_V_ERR_NO_VALID_SCTS 71 + +# define X509_V_ERR_PROXY_SUBJECT_NAME_VIOLATION 72 +/* OCSP status errors */ +# define X509_V_ERR_OCSP_VERIFY_NEEDED 73 /* Need OCSP verification */ +# define X509_V_ERR_OCSP_VERIFY_FAILED 74 /* Couldn't verify cert through OCSP */ +# define X509_V_ERR_OCSP_CERT_UNKNOWN 75 /* Certificate wasn't recognized by the OCSP responder */ + +/* Certificate verify flags */ + +# if OPENSSL_API_COMPAT < 0x10100000L +# define X509_V_FLAG_CB_ISSUER_CHECK 0x0 /* Deprecated */ +# endif +/* Use check time instead of current time */ +# define X509_V_FLAG_USE_CHECK_TIME 0x2 +/* Lookup CRLs */ +# define X509_V_FLAG_CRL_CHECK 0x4 +/* Lookup CRLs for whole chain */ +# define X509_V_FLAG_CRL_CHECK_ALL 0x8 +/* Ignore unhandled critical extensions */ +# define X509_V_FLAG_IGNORE_CRITICAL 0x10 +/* Disable workarounds for broken certificates */ +# define X509_V_FLAG_X509_STRICT 0x20 +/* Enable proxy certificate validation */ +# define X509_V_FLAG_ALLOW_PROXY_CERTS 0x40 +/* Enable policy checking */ +# define X509_V_FLAG_POLICY_CHECK 0x80 +/* Policy variable require-explicit-policy */ +# define X509_V_FLAG_EXPLICIT_POLICY 0x100 +/* Policy variable inhibit-any-policy */ +# define X509_V_FLAG_INHIBIT_ANY 0x200 +/* Policy variable inhibit-policy-mapping */ +# define X509_V_FLAG_INHIBIT_MAP 0x400 +/* Notify callback that policy is OK */ +# define X509_V_FLAG_NOTIFY_POLICY 0x800 +/* Extended CRL features such as indirect CRLs, alternate CRL signing keys */ +# define X509_V_FLAG_EXTENDED_CRL_SUPPORT 0x1000 +/* Delta CRL support */ +# define X509_V_FLAG_USE_DELTAS 0x2000 +/* Check self-signed CA signature */ +# define X509_V_FLAG_CHECK_SS_SIGNATURE 0x4000 +/* Use trusted store first */ +# define X509_V_FLAG_TRUSTED_FIRST 0x8000 +/* Suite B 128 bit only mode: not normally used */ +# define X509_V_FLAG_SUITEB_128_LOS_ONLY 0x10000 +/* Suite B 192 bit only mode */ +# define X509_V_FLAG_SUITEB_192_LOS 0x20000 +/* Suite B 128 bit mode allowing 192 bit algorithms */ +# define X509_V_FLAG_SUITEB_128_LOS 0x30000 +/* Allow partial chains if at least one certificate is in trusted store */ +# define X509_V_FLAG_PARTIAL_CHAIN 0x80000 +/* + * If the initial chain is not trusted, do not attempt to build an alternative + * chain. Alternate chain checking was introduced in 1.1.0. Setting this flag + * will force the behaviour to match that of previous versions. + */ +# define X509_V_FLAG_NO_ALT_CHAINS 0x100000 +/* Do not check certificate/CRL validity against current time */ +# define X509_V_FLAG_NO_CHECK_TIME 0x200000 + +# define X509_VP_FLAG_DEFAULT 0x1 +# define X509_VP_FLAG_OVERWRITE 0x2 +# define X509_VP_FLAG_RESET_FLAGS 0x4 +# define X509_VP_FLAG_LOCKED 0x8 +# define X509_VP_FLAG_ONCE 0x10 + +/* Internal use: mask of policy related options */ +# define X509_V_FLAG_POLICY_MASK (X509_V_FLAG_POLICY_CHECK \ + | X509_V_FLAG_EXPLICIT_POLICY \ + | X509_V_FLAG_INHIBIT_ANY \ + | X509_V_FLAG_INHIBIT_MAP) + +int X509_OBJECT_idx_by_subject(STACK_OF(X509_OBJECT) *h, X509_LOOKUP_TYPE type, + X509_NAME *name); +X509_OBJECT *X509_OBJECT_retrieve_by_subject(STACK_OF(X509_OBJECT) *h, + X509_LOOKUP_TYPE type, + X509_NAME *name); +X509_OBJECT *X509_OBJECT_retrieve_match(STACK_OF(X509_OBJECT) *h, + X509_OBJECT *x); +int X509_OBJECT_up_ref_count(X509_OBJECT *a); +X509_OBJECT *X509_OBJECT_new(void); +void X509_OBJECT_free(X509_OBJECT *a); +X509_LOOKUP_TYPE X509_OBJECT_get_type(const X509_OBJECT *a); +X509 *X509_OBJECT_get0_X509(const X509_OBJECT *a); +int X509_OBJECT_set1_X509(X509_OBJECT *a, X509 *obj); +X509_CRL *X509_OBJECT_get0_X509_CRL(X509_OBJECT *a); +int X509_OBJECT_set1_X509_CRL(X509_OBJECT *a, X509_CRL *obj); +X509_STORE *X509_STORE_new(void); +void X509_STORE_free(X509_STORE *v); +int X509_STORE_lock(X509_STORE *ctx); +int X509_STORE_unlock(X509_STORE *ctx); +int X509_STORE_up_ref(X509_STORE *v); +STACK_OF(X509_OBJECT) *X509_STORE_get0_objects(X509_STORE *v); + +STACK_OF(X509) *X509_STORE_CTX_get1_certs(X509_STORE_CTX *st, X509_NAME *nm); +STACK_OF(X509_CRL) *X509_STORE_CTX_get1_crls(X509_STORE_CTX *st, X509_NAME *nm); +int X509_STORE_set_flags(X509_STORE *ctx, unsigned long flags); +int X509_STORE_set_purpose(X509_STORE *ctx, int purpose); +int X509_STORE_set_trust(X509_STORE *ctx, int trust); +int X509_STORE_set1_param(X509_STORE *ctx, X509_VERIFY_PARAM *pm); +X509_VERIFY_PARAM *X509_STORE_get0_param(X509_STORE *ctx); + +void X509_STORE_set_verify(X509_STORE *ctx, X509_STORE_CTX_verify_fn verify); +#define X509_STORE_set_verify_func(ctx, func) \ + X509_STORE_set_verify((ctx),(func)) +void X509_STORE_CTX_set_verify(X509_STORE_CTX *ctx, + X509_STORE_CTX_verify_fn verify); +X509_STORE_CTX_verify_fn X509_STORE_get_verify(X509_STORE *ctx); +void X509_STORE_set_verify_cb(X509_STORE *ctx, + X509_STORE_CTX_verify_cb verify_cb); +# define X509_STORE_set_verify_cb_func(ctx,func) \ + X509_STORE_set_verify_cb((ctx),(func)) +X509_STORE_CTX_verify_cb X509_STORE_get_verify_cb(X509_STORE *ctx); +void X509_STORE_set_get_issuer(X509_STORE *ctx, + X509_STORE_CTX_get_issuer_fn get_issuer); +X509_STORE_CTX_get_issuer_fn X509_STORE_get_get_issuer(X509_STORE *ctx); +void X509_STORE_set_check_issued(X509_STORE *ctx, + X509_STORE_CTX_check_issued_fn check_issued); +X509_STORE_CTX_check_issued_fn X509_STORE_get_check_issued(X509_STORE *ctx); +void X509_STORE_set_check_revocation(X509_STORE *ctx, + X509_STORE_CTX_check_revocation_fn check_revocation); +X509_STORE_CTX_check_revocation_fn X509_STORE_get_check_revocation(X509_STORE *ctx); +void X509_STORE_set_get_crl(X509_STORE *ctx, + X509_STORE_CTX_get_crl_fn get_crl); +X509_STORE_CTX_get_crl_fn X509_STORE_get_get_crl(X509_STORE *ctx); +void X509_STORE_set_check_crl(X509_STORE *ctx, + X509_STORE_CTX_check_crl_fn check_crl); +X509_STORE_CTX_check_crl_fn X509_STORE_get_check_crl(X509_STORE *ctx); +void X509_STORE_set_cert_crl(X509_STORE *ctx, + X509_STORE_CTX_cert_crl_fn cert_crl); +X509_STORE_CTX_cert_crl_fn X509_STORE_get_cert_crl(X509_STORE *ctx); +void X509_STORE_set_check_policy(X509_STORE *ctx, + X509_STORE_CTX_check_policy_fn check_policy); +X509_STORE_CTX_check_policy_fn X509_STORE_get_check_policy(X509_STORE *ctx); +void X509_STORE_set_lookup_certs(X509_STORE *ctx, + X509_STORE_CTX_lookup_certs_fn lookup_certs); +X509_STORE_CTX_lookup_certs_fn X509_STORE_get_lookup_certs(X509_STORE *ctx); +void X509_STORE_set_lookup_crls(X509_STORE *ctx, + X509_STORE_CTX_lookup_crls_fn lookup_crls); +#define X509_STORE_set_lookup_crls_cb(ctx, func) \ + X509_STORE_set_lookup_crls((ctx), (func)) +X509_STORE_CTX_lookup_crls_fn X509_STORE_get_lookup_crls(X509_STORE *ctx); +void X509_STORE_set_cleanup(X509_STORE *ctx, + X509_STORE_CTX_cleanup_fn cleanup); +X509_STORE_CTX_cleanup_fn X509_STORE_get_cleanup(X509_STORE *ctx); + +#define X509_STORE_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509_STORE, l, p, newf, dupf, freef) +int X509_STORE_set_ex_data(X509_STORE *ctx, int idx, void *data); +void *X509_STORE_get_ex_data(X509_STORE *ctx, int idx); + +X509_STORE_CTX *X509_STORE_CTX_new(void); + +int X509_STORE_CTX_get1_issuer(X509 **issuer, X509_STORE_CTX *ctx, X509 *x); + +void X509_STORE_CTX_free(X509_STORE_CTX *ctx); +int X509_STORE_CTX_init(X509_STORE_CTX *ctx, X509_STORE *store, + X509 *x509, STACK_OF(X509) *chain); +void X509_STORE_CTX_set0_trusted_stack(X509_STORE_CTX *ctx, STACK_OF(X509) *sk); +void X509_STORE_CTX_cleanup(X509_STORE_CTX *ctx); + +X509_STORE *X509_STORE_CTX_get0_store(X509_STORE_CTX *ctx); +X509 *X509_STORE_CTX_get0_cert(X509_STORE_CTX *ctx); +STACK_OF(X509)* X509_STORE_CTX_get0_untrusted(X509_STORE_CTX *ctx); +void X509_STORE_CTX_set0_untrusted(X509_STORE_CTX *ctx, STACK_OF(X509) *sk); +void X509_STORE_CTX_set_verify_cb(X509_STORE_CTX *ctx, + X509_STORE_CTX_verify_cb verify); +X509_STORE_CTX_verify_cb X509_STORE_CTX_get_verify_cb(X509_STORE_CTX *ctx); +X509_STORE_CTX_verify_fn X509_STORE_CTX_get_verify(X509_STORE_CTX *ctx); +X509_STORE_CTX_get_issuer_fn X509_STORE_CTX_get_get_issuer(X509_STORE_CTX *ctx); +X509_STORE_CTX_check_issued_fn X509_STORE_CTX_get_check_issued(X509_STORE_CTX *ctx); +X509_STORE_CTX_check_revocation_fn X509_STORE_CTX_get_check_revocation(X509_STORE_CTX *ctx); +X509_STORE_CTX_get_crl_fn X509_STORE_CTX_get_get_crl(X509_STORE_CTX *ctx); +X509_STORE_CTX_check_crl_fn X509_STORE_CTX_get_check_crl(X509_STORE_CTX *ctx); +X509_STORE_CTX_cert_crl_fn X509_STORE_CTX_get_cert_crl(X509_STORE_CTX *ctx); +X509_STORE_CTX_check_policy_fn X509_STORE_CTX_get_check_policy(X509_STORE_CTX *ctx); +X509_STORE_CTX_lookup_certs_fn X509_STORE_CTX_get_lookup_certs(X509_STORE_CTX *ctx); +X509_STORE_CTX_lookup_crls_fn X509_STORE_CTX_get_lookup_crls(X509_STORE_CTX *ctx); +X509_STORE_CTX_cleanup_fn X509_STORE_CTX_get_cleanup(X509_STORE_CTX *ctx); + +#if OPENSSL_API_COMPAT < 0x10100000L +# define X509_STORE_CTX_get_chain X509_STORE_CTX_get0_chain +# define X509_STORE_CTX_set_chain X509_STORE_CTX_set0_untrusted +# define X509_STORE_CTX_trusted_stack X509_STORE_CTX_set0_trusted_stack +# define X509_STORE_get_by_subject X509_STORE_CTX_get_by_subject +# define X509_STORE_get1_cert X509_STORE_CTX_get1_certs +# define X509_STORE_get1_crl X509_STORE_CTX_get1_crls +#endif + +X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *v, X509_LOOKUP_METHOD *m); +X509_LOOKUP_METHOD *X509_LOOKUP_hash_dir(void); +X509_LOOKUP_METHOD *X509_LOOKUP_file(void); + +typedef int (*X509_LOOKUP_ctrl_fn)(X509_LOOKUP *ctx, int cmd, const char *argc, + long argl, char **ret); +typedef int (*X509_LOOKUP_get_by_subject_fn)(X509_LOOKUP *ctx, + X509_LOOKUP_TYPE type, + X509_NAME *name, + X509_OBJECT *ret); +typedef int (*X509_LOOKUP_get_by_issuer_serial_fn)(X509_LOOKUP *ctx, + X509_LOOKUP_TYPE type, + X509_NAME *name, + ASN1_INTEGER *serial, + X509_OBJECT *ret); +typedef int (*X509_LOOKUP_get_by_fingerprint_fn)(X509_LOOKUP *ctx, + X509_LOOKUP_TYPE type, + const unsigned char* bytes, + int len, + X509_OBJECT *ret); +typedef int (*X509_LOOKUP_get_by_alias_fn)(X509_LOOKUP *ctx, + X509_LOOKUP_TYPE type, + const char *str, + int len, + X509_OBJECT *ret); + +X509_LOOKUP_METHOD *X509_LOOKUP_meth_new(const char *name); +void X509_LOOKUP_meth_free(X509_LOOKUP_METHOD *method); + +int X509_LOOKUP_meth_set_new_item(X509_LOOKUP_METHOD *method, + int (*new_item) (X509_LOOKUP *ctx)); +int (*X509_LOOKUP_meth_get_new_item(const X509_LOOKUP_METHOD* method)) + (X509_LOOKUP *ctx); + +int X509_LOOKUP_meth_set_free(X509_LOOKUP_METHOD *method, + void (*free_fn) (X509_LOOKUP *ctx)); +void (*X509_LOOKUP_meth_get_free(const X509_LOOKUP_METHOD* method)) + (X509_LOOKUP *ctx); + +int X509_LOOKUP_meth_set_init(X509_LOOKUP_METHOD *method, + int (*init) (X509_LOOKUP *ctx)); +int (*X509_LOOKUP_meth_get_init(const X509_LOOKUP_METHOD* method)) + (X509_LOOKUP *ctx); + +int X509_LOOKUP_meth_set_shutdown(X509_LOOKUP_METHOD *method, + int (*shutdown) (X509_LOOKUP *ctx)); +int (*X509_LOOKUP_meth_get_shutdown(const X509_LOOKUP_METHOD* method)) + (X509_LOOKUP *ctx); + +int X509_LOOKUP_meth_set_ctrl(X509_LOOKUP_METHOD *method, + X509_LOOKUP_ctrl_fn ctrl_fn); +X509_LOOKUP_ctrl_fn X509_LOOKUP_meth_get_ctrl(const X509_LOOKUP_METHOD *method); + +int X509_LOOKUP_meth_set_get_by_subject(X509_LOOKUP_METHOD *method, + X509_LOOKUP_get_by_subject_fn fn); +X509_LOOKUP_get_by_subject_fn X509_LOOKUP_meth_get_get_by_subject( + const X509_LOOKUP_METHOD *method); + +int X509_LOOKUP_meth_set_get_by_issuer_serial(X509_LOOKUP_METHOD *method, + X509_LOOKUP_get_by_issuer_serial_fn fn); +X509_LOOKUP_get_by_issuer_serial_fn X509_LOOKUP_meth_get_get_by_issuer_serial( + const X509_LOOKUP_METHOD *method); + +int X509_LOOKUP_meth_set_get_by_fingerprint(X509_LOOKUP_METHOD *method, + X509_LOOKUP_get_by_fingerprint_fn fn); +X509_LOOKUP_get_by_fingerprint_fn X509_LOOKUP_meth_get_get_by_fingerprint( + const X509_LOOKUP_METHOD *method); + +int X509_LOOKUP_meth_set_get_by_alias(X509_LOOKUP_METHOD *method, + X509_LOOKUP_get_by_alias_fn fn); +X509_LOOKUP_get_by_alias_fn X509_LOOKUP_meth_get_get_by_alias( + const X509_LOOKUP_METHOD *method); + + +int X509_STORE_add_cert(X509_STORE *ctx, X509 *x); +int X509_STORE_add_crl(X509_STORE *ctx, X509_CRL *x); + +int X509_STORE_CTX_get_by_subject(X509_STORE_CTX *vs, X509_LOOKUP_TYPE type, + X509_NAME *name, X509_OBJECT *ret); +X509_OBJECT *X509_STORE_CTX_get_obj_by_subject(X509_STORE_CTX *vs, + X509_LOOKUP_TYPE type, + X509_NAME *name); + +int X509_LOOKUP_ctrl(X509_LOOKUP *ctx, int cmd, const char *argc, + long argl, char **ret); + +int X509_load_cert_file(X509_LOOKUP *ctx, const char *file, int type); +int X509_load_crl_file(X509_LOOKUP *ctx, const char *file, int type); +int X509_load_cert_crl_file(X509_LOOKUP *ctx, const char *file, int type); + +X509_LOOKUP *X509_LOOKUP_new(X509_LOOKUP_METHOD *method); +void X509_LOOKUP_free(X509_LOOKUP *ctx); +int X509_LOOKUP_init(X509_LOOKUP *ctx); +int X509_LOOKUP_by_subject(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type, + X509_NAME *name, X509_OBJECT *ret); +int X509_LOOKUP_by_issuer_serial(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type, + X509_NAME *name, ASN1_INTEGER *serial, + X509_OBJECT *ret); +int X509_LOOKUP_by_fingerprint(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type, + const unsigned char *bytes, int len, + X509_OBJECT *ret); +int X509_LOOKUP_by_alias(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type, + const char *str, int len, X509_OBJECT *ret); +int X509_LOOKUP_set_method_data(X509_LOOKUP *ctx, void *data); +void *X509_LOOKUP_get_method_data(const X509_LOOKUP *ctx); +X509_STORE *X509_LOOKUP_get_store(const X509_LOOKUP *ctx); +int X509_LOOKUP_shutdown(X509_LOOKUP *ctx); + +int X509_STORE_load_locations(X509_STORE *ctx, + const char *file, const char *dir); +int X509_STORE_set_default_paths(X509_STORE *ctx); + +#define X509_STORE_CTX_get_ex_new_index(l, p, newf, dupf, freef) \ + CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509_STORE_CTX, l, p, newf, dupf, freef) +int X509_STORE_CTX_set_ex_data(X509_STORE_CTX *ctx, int idx, void *data); +void *X509_STORE_CTX_get_ex_data(X509_STORE_CTX *ctx, int idx); +int X509_STORE_CTX_get_error(X509_STORE_CTX *ctx); +void X509_STORE_CTX_set_error(X509_STORE_CTX *ctx, int s); +int X509_STORE_CTX_get_error_depth(X509_STORE_CTX *ctx); +void X509_STORE_CTX_set_error_depth(X509_STORE_CTX *ctx, int depth); +X509 *X509_STORE_CTX_get_current_cert(X509_STORE_CTX *ctx); +void X509_STORE_CTX_set_current_cert(X509_STORE_CTX *ctx, X509 *x); +X509 *X509_STORE_CTX_get0_current_issuer(X509_STORE_CTX *ctx); +X509_CRL *X509_STORE_CTX_get0_current_crl(X509_STORE_CTX *ctx); +X509_STORE_CTX *X509_STORE_CTX_get0_parent_ctx(X509_STORE_CTX *ctx); +STACK_OF(X509) *X509_STORE_CTX_get0_chain(X509_STORE_CTX *ctx); +STACK_OF(X509) *X509_STORE_CTX_get1_chain(X509_STORE_CTX *ctx); +void X509_STORE_CTX_set_cert(X509_STORE_CTX *c, X509 *x); +void X509_STORE_CTX_set0_verified_chain(X509_STORE_CTX *c, STACK_OF(X509) *sk); +void X509_STORE_CTX_set0_crls(X509_STORE_CTX *c, STACK_OF(X509_CRL) *sk); +int X509_STORE_CTX_set_purpose(X509_STORE_CTX *ctx, int purpose); +int X509_STORE_CTX_set_trust(X509_STORE_CTX *ctx, int trust); +int X509_STORE_CTX_purpose_inherit(X509_STORE_CTX *ctx, int def_purpose, + int purpose, int trust); +void X509_STORE_CTX_set_flags(X509_STORE_CTX *ctx, unsigned long flags); +void X509_STORE_CTX_set_time(X509_STORE_CTX *ctx, unsigned long flags, + time_t t); + +X509_POLICY_TREE *X509_STORE_CTX_get0_policy_tree(X509_STORE_CTX *ctx); +int X509_STORE_CTX_get_explicit_policy(X509_STORE_CTX *ctx); +int X509_STORE_CTX_get_num_untrusted(X509_STORE_CTX *ctx); + +X509_VERIFY_PARAM *X509_STORE_CTX_get0_param(X509_STORE_CTX *ctx); +void X509_STORE_CTX_set0_param(X509_STORE_CTX *ctx, X509_VERIFY_PARAM *param); +int X509_STORE_CTX_set_default(X509_STORE_CTX *ctx, const char *name); + +/* + * Bridge opacity barrier between libcrypt and libssl, also needed to support + * offline testing in test/danetest.c + */ +void X509_STORE_CTX_set0_dane(X509_STORE_CTX *ctx, SSL_DANE *dane); +#define DANE_FLAG_NO_DANE_EE_NAMECHECKS (1L << 0) + +/* X509_VERIFY_PARAM functions */ + +X509_VERIFY_PARAM *X509_VERIFY_PARAM_new(void); +void X509_VERIFY_PARAM_free(X509_VERIFY_PARAM *param); +int X509_VERIFY_PARAM_inherit(X509_VERIFY_PARAM *to, + const X509_VERIFY_PARAM *from); +int X509_VERIFY_PARAM_set1(X509_VERIFY_PARAM *to, + const X509_VERIFY_PARAM *from); +int X509_VERIFY_PARAM_set1_name(X509_VERIFY_PARAM *param, const char *name); +int X509_VERIFY_PARAM_set_flags(X509_VERIFY_PARAM *param, + unsigned long flags); +int X509_VERIFY_PARAM_clear_flags(X509_VERIFY_PARAM *param, + unsigned long flags); +unsigned long X509_VERIFY_PARAM_get_flags(X509_VERIFY_PARAM *param); +int X509_VERIFY_PARAM_set_purpose(X509_VERIFY_PARAM *param, int purpose); +int X509_VERIFY_PARAM_set_trust(X509_VERIFY_PARAM *param, int trust); +void X509_VERIFY_PARAM_set_depth(X509_VERIFY_PARAM *param, int depth); +void X509_VERIFY_PARAM_set_auth_level(X509_VERIFY_PARAM *param, int auth_level); +time_t X509_VERIFY_PARAM_get_time(const X509_VERIFY_PARAM *param); +void X509_VERIFY_PARAM_set_time(X509_VERIFY_PARAM *param, time_t t); +int X509_VERIFY_PARAM_add0_policy(X509_VERIFY_PARAM *param, + ASN1_OBJECT *policy); +int X509_VERIFY_PARAM_set1_policies(X509_VERIFY_PARAM *param, + STACK_OF(ASN1_OBJECT) *policies); + +int X509_VERIFY_PARAM_set_inh_flags(X509_VERIFY_PARAM *param, + uint32_t flags); +uint32_t X509_VERIFY_PARAM_get_inh_flags(const X509_VERIFY_PARAM *param); + +int X509_VERIFY_PARAM_set1_host(X509_VERIFY_PARAM *param, + const char *name, size_t namelen); +int X509_VERIFY_PARAM_add1_host(X509_VERIFY_PARAM *param, + const char *name, size_t namelen); +void X509_VERIFY_PARAM_set_hostflags(X509_VERIFY_PARAM *param, + unsigned int flags); +unsigned int X509_VERIFY_PARAM_get_hostflags(const X509_VERIFY_PARAM *param); +char *X509_VERIFY_PARAM_get0_peername(X509_VERIFY_PARAM *); +void X509_VERIFY_PARAM_move_peername(X509_VERIFY_PARAM *, X509_VERIFY_PARAM *); +int X509_VERIFY_PARAM_set1_email(X509_VERIFY_PARAM *param, + const char *email, size_t emaillen); +int X509_VERIFY_PARAM_set1_ip(X509_VERIFY_PARAM *param, + const unsigned char *ip, size_t iplen); +int X509_VERIFY_PARAM_set1_ip_asc(X509_VERIFY_PARAM *param, + const char *ipasc); + +int X509_VERIFY_PARAM_get_depth(const X509_VERIFY_PARAM *param); +int X509_VERIFY_PARAM_get_auth_level(const X509_VERIFY_PARAM *param); +const char *X509_VERIFY_PARAM_get0_name(const X509_VERIFY_PARAM *param); + +int X509_VERIFY_PARAM_add0_table(X509_VERIFY_PARAM *param); +int X509_VERIFY_PARAM_get_count(void); +const X509_VERIFY_PARAM *X509_VERIFY_PARAM_get0(int id); +const X509_VERIFY_PARAM *X509_VERIFY_PARAM_lookup(const char *name); +void X509_VERIFY_PARAM_table_cleanup(void); + +/* Non positive return values are errors */ +#define X509_PCY_TREE_FAILURE -2 /* Failure to satisfy explicit policy */ +#define X509_PCY_TREE_INVALID -1 /* Inconsistent or invalid extensions */ +#define X509_PCY_TREE_INTERNAL 0 /* Internal error, most likely malloc */ + +/* + * Positive return values form a bit mask, all but the first are internal to + * the library and don't appear in results from X509_policy_check(). + */ +#define X509_PCY_TREE_VALID 1 /* The policy tree is valid */ +#define X509_PCY_TREE_EMPTY 2 /* The policy tree is empty */ +#define X509_PCY_TREE_EXPLICIT 4 /* Explicit policy required */ + +int X509_policy_check(X509_POLICY_TREE **ptree, int *pexplicit_policy, + STACK_OF(X509) *certs, + STACK_OF(ASN1_OBJECT) *policy_oids, unsigned int flags); + +void X509_policy_tree_free(X509_POLICY_TREE *tree); + +int X509_policy_tree_level_count(const X509_POLICY_TREE *tree); +X509_POLICY_LEVEL *X509_policy_tree_get0_level(const X509_POLICY_TREE *tree, + int i); + +STACK_OF(X509_POLICY_NODE) *X509_policy_tree_get0_policies(const + X509_POLICY_TREE + *tree); + +STACK_OF(X509_POLICY_NODE) *X509_policy_tree_get0_user_policies(const + X509_POLICY_TREE + *tree); + +int X509_policy_level_node_count(X509_POLICY_LEVEL *level); + +X509_POLICY_NODE *X509_policy_level_get0_node(X509_POLICY_LEVEL *level, + int i); + +const ASN1_OBJECT *X509_policy_node_get0_policy(const X509_POLICY_NODE *node); + +STACK_OF(POLICYQUALINFO) *X509_policy_node_get0_qualifiers(const + X509_POLICY_NODE + *node); +const X509_POLICY_NODE *X509_policy_node_get0_parent(const X509_POLICY_NODE + *node); + +#ifdef __cplusplus +} +#endif +#endif diff --git a/include/openssl/x509err.h b/include/openssl/x509err.h new file mode 100644 index 0000000..b1d6a87 --- /dev/null +++ b/include/openssl/x509err.h @@ -0,0 +1,125 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_X509ERR_H +# define HEADER_X509ERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_X509_strings(void); + +/* + * X509 function codes. + */ +# define X509_F_ADD_CERT_DIR 100 +# define X509_F_BUILD_CHAIN 106 +# define X509_F_BY_FILE_CTRL 101 +# define X509_F_CHECK_NAME_CONSTRAINTS 149 +# define X509_F_CHECK_POLICY 145 +# define X509_F_DANE_I2D 107 +# define X509_F_DIR_CTRL 102 +# define X509_F_GET_CERT_BY_SUBJECT 103 +# define X509_F_I2D_X509_AUX 151 +# define X509_F_LOOKUP_CERTS_SK 152 +# define X509_F_NETSCAPE_SPKI_B64_DECODE 129 +# define X509_F_NETSCAPE_SPKI_B64_ENCODE 130 +# define X509_F_NEW_DIR 153 +# define X509_F_X509AT_ADD1_ATTR 135 +# define X509_F_X509V3_ADD_EXT 104 +# define X509_F_X509_ATTRIBUTE_CREATE_BY_NID 136 +# define X509_F_X509_ATTRIBUTE_CREATE_BY_OBJ 137 +# define X509_F_X509_ATTRIBUTE_CREATE_BY_TXT 140 +# define X509_F_X509_ATTRIBUTE_GET0_DATA 139 +# define X509_F_X509_ATTRIBUTE_SET1_DATA 138 +# define X509_F_X509_CHECK_PRIVATE_KEY 128 +# define X509_F_X509_CRL_DIFF 105 +# define X509_F_X509_CRL_METHOD_NEW 154 +# define X509_F_X509_CRL_PRINT_FP 147 +# define X509_F_X509_EXTENSION_CREATE_BY_NID 108 +# define X509_F_X509_EXTENSION_CREATE_BY_OBJ 109 +# define X509_F_X509_GET_PUBKEY_PARAMETERS 110 +# define X509_F_X509_LOAD_CERT_CRL_FILE 132 +# define X509_F_X509_LOAD_CERT_FILE 111 +# define X509_F_X509_LOAD_CRL_FILE 112 +# define X509_F_X509_LOOKUP_METH_NEW 160 +# define X509_F_X509_LOOKUP_NEW 155 +# define X509_F_X509_NAME_ADD_ENTRY 113 +# define X509_F_X509_NAME_CANON 156 +# define X509_F_X509_NAME_ENTRY_CREATE_BY_NID 114 +# define X509_F_X509_NAME_ENTRY_CREATE_BY_TXT 131 +# define X509_F_X509_NAME_ENTRY_SET_OBJECT 115 +# define X509_F_X509_NAME_ONELINE 116 +# define X509_F_X509_NAME_PRINT 117 +# define X509_F_X509_OBJECT_NEW 150 +# define X509_F_X509_PRINT_EX_FP 118 +# define X509_F_X509_PUBKEY_DECODE 148 +# define X509_F_X509_PUBKEY_GET0 119 +# define X509_F_X509_PUBKEY_SET 120 +# define X509_F_X509_REQ_CHECK_PRIVATE_KEY 144 +# define X509_F_X509_REQ_PRINT_EX 121 +# define X509_F_X509_REQ_PRINT_FP 122 +# define X509_F_X509_REQ_TO_X509 123 +# define X509_F_X509_STORE_ADD_CERT 124 +# define X509_F_X509_STORE_ADD_CRL 125 +# define X509_F_X509_STORE_ADD_LOOKUP 157 +# define X509_F_X509_STORE_CTX_GET1_ISSUER 146 +# define X509_F_X509_STORE_CTX_INIT 143 +# define X509_F_X509_STORE_CTX_NEW 142 +# define X509_F_X509_STORE_CTX_PURPOSE_INHERIT 134 +# define X509_F_X509_STORE_NEW 158 +# define X509_F_X509_TO_X509_REQ 126 +# define X509_F_X509_TRUST_ADD 133 +# define X509_F_X509_TRUST_SET 141 +# define X509_F_X509_VERIFY_CERT 127 +# define X509_F_X509_VERIFY_PARAM_NEW 159 + +/* + * X509 reason codes. + */ +# define X509_R_AKID_MISMATCH 110 +# define X509_R_BAD_SELECTOR 133 +# define X509_R_BAD_X509_FILETYPE 100 +# define X509_R_BASE64_DECODE_ERROR 118 +# define X509_R_CANT_CHECK_DH_KEY 114 +# define X509_R_CERT_ALREADY_IN_HASH_TABLE 101 +# define X509_R_CRL_ALREADY_DELTA 127 +# define X509_R_CRL_VERIFY_FAILURE 131 +# define X509_R_IDP_MISMATCH 128 +# define X509_R_INVALID_DIRECTORY 113 +# define X509_R_INVALID_FIELD_NAME 119 +# define X509_R_INVALID_TRUST 123 +# define X509_R_ISSUER_MISMATCH 129 +# define X509_R_KEY_TYPE_MISMATCH 115 +# define X509_R_KEY_VALUES_MISMATCH 116 +# define X509_R_LOADING_CERT_DIR 103 +# define X509_R_LOADING_DEFAULTS 104 +# define X509_R_METHOD_NOT_SUPPORTED 124 +# define X509_R_NAME_TOO_LONG 134 +# define X509_R_NEWER_CRL_NOT_NEWER 132 +# define X509_R_NO_CERTIFICATE_FOUND 135 +# define X509_R_NO_CERTIFICATE_OR_CRL_FOUND 136 +# define X509_R_NO_CERT_SET_FOR_US_TO_VERIFY 105 +# define X509_R_NO_CRL_FOUND 137 +# define X509_R_NO_CRL_NUMBER 130 +# define X509_R_PUBLIC_KEY_DECODE_ERROR 125 +# define X509_R_PUBLIC_KEY_ENCODE_ERROR 126 +# define X509_R_SHOULD_RETRY 106 +# define X509_R_UNABLE_TO_FIND_PARAMETERS_IN_CHAIN 107 +# define X509_R_UNABLE_TO_GET_CERTS_PUBLIC_KEY 108 +# define X509_R_UNKNOWN_KEY_TYPE 117 +# define X509_R_UNKNOWN_NID 109 +# define X509_R_UNKNOWN_PURPOSE_ID 121 +# define X509_R_UNKNOWN_TRUST_ID 120 +# define X509_R_UNSUPPORTED_ALGORITHM 111 +# define X509_R_WRONG_LOOKUP_TYPE 112 +# define X509_R_WRONG_TYPE 122 + +#endif diff --git a/include/openssl/x509v3.h b/include/openssl/x509v3.h new file mode 100644 index 0000000..659b556 --- /dev/null +++ b/include/openssl/x509v3.h @@ -0,0 +1,935 @@ +/* + * Copyright 1999-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_X509V3_H +# define HEADER_X509V3_H + +# include +# include +# include +# include + +#ifdef __cplusplus +extern "C" { +#endif + +/* Forward reference */ +struct v3_ext_method; +struct v3_ext_ctx; + +/* Useful typedefs */ + +typedef void *(*X509V3_EXT_NEW)(void); +typedef void (*X509V3_EXT_FREE) (void *); +typedef void *(*X509V3_EXT_D2I)(void *, const unsigned char **, long); +typedef int (*X509V3_EXT_I2D) (void *, unsigned char **); +typedef STACK_OF(CONF_VALUE) * + (*X509V3_EXT_I2V) (const struct v3_ext_method *method, void *ext, + STACK_OF(CONF_VALUE) *extlist); +typedef void *(*X509V3_EXT_V2I)(const struct v3_ext_method *method, + struct v3_ext_ctx *ctx, + STACK_OF(CONF_VALUE) *values); +typedef char *(*X509V3_EXT_I2S)(const struct v3_ext_method *method, + void *ext); +typedef void *(*X509V3_EXT_S2I)(const struct v3_ext_method *method, + struct v3_ext_ctx *ctx, const char *str); +typedef int (*X509V3_EXT_I2R) (const struct v3_ext_method *method, void *ext, + BIO *out, int indent); +typedef void *(*X509V3_EXT_R2I)(const struct v3_ext_method *method, + struct v3_ext_ctx *ctx, const char *str); + +/* V3 extension structure */ + +struct v3_ext_method { + int ext_nid; + int ext_flags; +/* If this is set the following four fields are ignored */ + ASN1_ITEM_EXP *it; +/* Old style ASN1 calls */ + X509V3_EXT_NEW ext_new; + X509V3_EXT_FREE ext_free; + X509V3_EXT_D2I d2i; + X509V3_EXT_I2D i2d; +/* The following pair is used for string extensions */ + X509V3_EXT_I2S i2s; + X509V3_EXT_S2I s2i; +/* The following pair is used for multi-valued extensions */ + X509V3_EXT_I2V i2v; + X509V3_EXT_V2I v2i; +/* The following are used for raw extensions */ + X509V3_EXT_I2R i2r; + X509V3_EXT_R2I r2i; + void *usr_data; /* Any extension specific data */ +}; + +typedef struct X509V3_CONF_METHOD_st { + char *(*get_string) (void *db, const char *section, const char *value); + STACK_OF(CONF_VALUE) *(*get_section) (void *db, const char *section); + void (*free_string) (void *db, char *string); + void (*free_section) (void *db, STACK_OF(CONF_VALUE) *section); +} X509V3_CONF_METHOD; + +/* Context specific info */ +struct v3_ext_ctx { +# define CTX_TEST 0x1 +# define X509V3_CTX_REPLACE 0x2 + int flags; + X509 *issuer_cert; + X509 *subject_cert; + X509_REQ *subject_req; + X509_CRL *crl; + X509V3_CONF_METHOD *db_meth; + void *db; +/* Maybe more here */ +}; + +typedef struct v3_ext_method X509V3_EXT_METHOD; + +DEFINE_STACK_OF(X509V3_EXT_METHOD) + +/* ext_flags values */ +# define X509V3_EXT_DYNAMIC 0x1 +# define X509V3_EXT_CTX_DEP 0x2 +# define X509V3_EXT_MULTILINE 0x4 + +typedef BIT_STRING_BITNAME ENUMERATED_NAMES; + +typedef struct BASIC_CONSTRAINTS_st { + int ca; + ASN1_INTEGER *pathlen; +} BASIC_CONSTRAINTS; + +typedef struct PKEY_USAGE_PERIOD_st { + ASN1_GENERALIZEDTIME *notBefore; + ASN1_GENERALIZEDTIME *notAfter; +} PKEY_USAGE_PERIOD; + +typedef struct otherName_st { + ASN1_OBJECT *type_id; + ASN1_TYPE *value; +} OTHERNAME; + +typedef struct EDIPartyName_st { + ASN1_STRING *nameAssigner; + ASN1_STRING *partyName; +} EDIPARTYNAME; + +typedef struct GENERAL_NAME_st { +# define GEN_OTHERNAME 0 +# define GEN_EMAIL 1 +# define GEN_DNS 2 +# define GEN_X400 3 +# define GEN_DIRNAME 4 +# define GEN_EDIPARTY 5 +# define GEN_URI 6 +# define GEN_IPADD 7 +# define GEN_RID 8 + int type; + union { + char *ptr; + OTHERNAME *otherName; /* otherName */ + ASN1_IA5STRING *rfc822Name; + ASN1_IA5STRING *dNSName; + ASN1_TYPE *x400Address; + X509_NAME *directoryName; + EDIPARTYNAME *ediPartyName; + ASN1_IA5STRING *uniformResourceIdentifier; + ASN1_OCTET_STRING *iPAddress; + ASN1_OBJECT *registeredID; + /* Old names */ + ASN1_OCTET_STRING *ip; /* iPAddress */ + X509_NAME *dirn; /* dirn */ + ASN1_IA5STRING *ia5; /* rfc822Name, dNSName, + * uniformResourceIdentifier */ + ASN1_OBJECT *rid; /* registeredID */ + ASN1_TYPE *other; /* x400Address */ + } d; +} GENERAL_NAME; + +typedef struct ACCESS_DESCRIPTION_st { + ASN1_OBJECT *method; + GENERAL_NAME *location; +} ACCESS_DESCRIPTION; + +typedef STACK_OF(ACCESS_DESCRIPTION) AUTHORITY_INFO_ACCESS; + +typedef STACK_OF(ASN1_OBJECT) EXTENDED_KEY_USAGE; + +typedef STACK_OF(ASN1_INTEGER) TLS_FEATURE; + +DEFINE_STACK_OF(GENERAL_NAME) +typedef STACK_OF(GENERAL_NAME) GENERAL_NAMES; +DEFINE_STACK_OF(GENERAL_NAMES) + +DEFINE_STACK_OF(ACCESS_DESCRIPTION) + +typedef struct DIST_POINT_NAME_st { + int type; + union { + GENERAL_NAMES *fullname; + STACK_OF(X509_NAME_ENTRY) *relativename; + } name; +/* If relativename then this contains the full distribution point name */ + X509_NAME *dpname; +} DIST_POINT_NAME; +/* All existing reasons */ +# define CRLDP_ALL_REASONS 0x807f + +# define CRL_REASON_NONE -1 +# define CRL_REASON_UNSPECIFIED 0 +# define CRL_REASON_KEY_COMPROMISE 1 +# define CRL_REASON_CA_COMPROMISE 2 +# define CRL_REASON_AFFILIATION_CHANGED 3 +# define CRL_REASON_SUPERSEDED 4 +# define CRL_REASON_CESSATION_OF_OPERATION 5 +# define CRL_REASON_CERTIFICATE_HOLD 6 +# define CRL_REASON_REMOVE_FROM_CRL 8 +# define CRL_REASON_PRIVILEGE_WITHDRAWN 9 +# define CRL_REASON_AA_COMPROMISE 10 + +struct DIST_POINT_st { + DIST_POINT_NAME *distpoint; + ASN1_BIT_STRING *reasons; + GENERAL_NAMES *CRLissuer; + int dp_reasons; +}; + +typedef STACK_OF(DIST_POINT) CRL_DIST_POINTS; + +DEFINE_STACK_OF(DIST_POINT) + +struct AUTHORITY_KEYID_st { + ASN1_OCTET_STRING *keyid; + GENERAL_NAMES *issuer; + ASN1_INTEGER *serial; +}; + +/* Strong extranet structures */ + +typedef struct SXNET_ID_st { + ASN1_INTEGER *zone; + ASN1_OCTET_STRING *user; +} SXNETID; + +DEFINE_STACK_OF(SXNETID) + +typedef struct SXNET_st { + ASN1_INTEGER *version; + STACK_OF(SXNETID) *ids; +} SXNET; + +typedef struct NOTICEREF_st { + ASN1_STRING *organization; + STACK_OF(ASN1_INTEGER) *noticenos; +} NOTICEREF; + +typedef struct USERNOTICE_st { + NOTICEREF *noticeref; + ASN1_STRING *exptext; +} USERNOTICE; + +typedef struct POLICYQUALINFO_st { + ASN1_OBJECT *pqualid; + union { + ASN1_IA5STRING *cpsuri; + USERNOTICE *usernotice; + ASN1_TYPE *other; + } d; +} POLICYQUALINFO; + +DEFINE_STACK_OF(POLICYQUALINFO) + +typedef struct POLICYINFO_st { + ASN1_OBJECT *policyid; + STACK_OF(POLICYQUALINFO) *qualifiers; +} POLICYINFO; + +typedef STACK_OF(POLICYINFO) CERTIFICATEPOLICIES; + +DEFINE_STACK_OF(POLICYINFO) + +typedef struct POLICY_MAPPING_st { + ASN1_OBJECT *issuerDomainPolicy; + ASN1_OBJECT *subjectDomainPolicy; +} POLICY_MAPPING; + +DEFINE_STACK_OF(POLICY_MAPPING) + +typedef STACK_OF(POLICY_MAPPING) POLICY_MAPPINGS; + +typedef struct GENERAL_SUBTREE_st { + GENERAL_NAME *base; + ASN1_INTEGER *minimum; + ASN1_INTEGER *maximum; +} GENERAL_SUBTREE; + +DEFINE_STACK_OF(GENERAL_SUBTREE) + +struct NAME_CONSTRAINTS_st { + STACK_OF(GENERAL_SUBTREE) *permittedSubtrees; + STACK_OF(GENERAL_SUBTREE) *excludedSubtrees; +}; + +typedef struct POLICY_CONSTRAINTS_st { + ASN1_INTEGER *requireExplicitPolicy; + ASN1_INTEGER *inhibitPolicyMapping; +} POLICY_CONSTRAINTS; + +/* Proxy certificate structures, see RFC 3820 */ +typedef struct PROXY_POLICY_st { + ASN1_OBJECT *policyLanguage; + ASN1_OCTET_STRING *policy; +} PROXY_POLICY; + +typedef struct PROXY_CERT_INFO_EXTENSION_st { + ASN1_INTEGER *pcPathLengthConstraint; + PROXY_POLICY *proxyPolicy; +} PROXY_CERT_INFO_EXTENSION; + +DECLARE_ASN1_FUNCTIONS(PROXY_POLICY) +DECLARE_ASN1_FUNCTIONS(PROXY_CERT_INFO_EXTENSION) + +struct ISSUING_DIST_POINT_st { + DIST_POINT_NAME *distpoint; + int onlyuser; + int onlyCA; + ASN1_BIT_STRING *onlysomereasons; + int indirectCRL; + int onlyattr; +}; + +/* Values in idp_flags field */ +/* IDP present */ +# define IDP_PRESENT 0x1 +/* IDP values inconsistent */ +# define IDP_INVALID 0x2 +/* onlyuser true */ +# define IDP_ONLYUSER 0x4 +/* onlyCA true */ +# define IDP_ONLYCA 0x8 +/* onlyattr true */ +# define IDP_ONLYATTR 0x10 +/* indirectCRL true */ +# define IDP_INDIRECT 0x20 +/* onlysomereasons present */ +# define IDP_REASONS 0x40 + +# define X509V3_conf_err(val) ERR_add_error_data(6, \ + "section:", (val)->section, \ + ",name:", (val)->name, ",value:", (val)->value) + +# define X509V3_set_ctx_test(ctx) \ + X509V3_set_ctx(ctx, NULL, NULL, NULL, NULL, CTX_TEST) +# define X509V3_set_ctx_nodb(ctx) (ctx)->db = NULL; + +# define EXT_BITSTRING(nid, table) { nid, 0, ASN1_ITEM_ref(ASN1_BIT_STRING), \ + 0,0,0,0, \ + 0,0, \ + (X509V3_EXT_I2V)i2v_ASN1_BIT_STRING, \ + (X509V3_EXT_V2I)v2i_ASN1_BIT_STRING, \ + NULL, NULL, \ + table} + +# define EXT_IA5STRING(nid) { nid, 0, ASN1_ITEM_ref(ASN1_IA5STRING), \ + 0,0,0,0, \ + (X509V3_EXT_I2S)i2s_ASN1_IA5STRING, \ + (X509V3_EXT_S2I)s2i_ASN1_IA5STRING, \ + 0,0,0,0, \ + NULL} + +# define EXT_END { -1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0} + +/* X509_PURPOSE stuff */ + +# define EXFLAG_BCONS 0x1 +# define EXFLAG_KUSAGE 0x2 +# define EXFLAG_XKUSAGE 0x4 +# define EXFLAG_NSCERT 0x8 + +# define EXFLAG_CA 0x10 +/* Really self issued not necessarily self signed */ +# define EXFLAG_SI 0x20 +# define EXFLAG_V1 0x40 +# define EXFLAG_INVALID 0x80 +/* EXFLAG_SET is set to indicate that some values have been precomputed */ +# define EXFLAG_SET 0x100 +# define EXFLAG_CRITICAL 0x200 +# define EXFLAG_PROXY 0x400 + +# define EXFLAG_INVALID_POLICY 0x800 +# define EXFLAG_FRESHEST 0x1000 +/* Self signed */ +# define EXFLAG_SS 0x2000 + +# define KU_DIGITAL_SIGNATURE 0x0080 +# define KU_NON_REPUDIATION 0x0040 +# define KU_KEY_ENCIPHERMENT 0x0020 +# define KU_DATA_ENCIPHERMENT 0x0010 +# define KU_KEY_AGREEMENT 0x0008 +# define KU_KEY_CERT_SIGN 0x0004 +# define KU_CRL_SIGN 0x0002 +# define KU_ENCIPHER_ONLY 0x0001 +# define KU_DECIPHER_ONLY 0x8000 + +# define NS_SSL_CLIENT 0x80 +# define NS_SSL_SERVER 0x40 +# define NS_SMIME 0x20 +# define NS_OBJSIGN 0x10 +# define NS_SSL_CA 0x04 +# define NS_SMIME_CA 0x02 +# define NS_OBJSIGN_CA 0x01 +# define NS_ANY_CA (NS_SSL_CA|NS_SMIME_CA|NS_OBJSIGN_CA) + +# define XKU_SSL_SERVER 0x1 +# define XKU_SSL_CLIENT 0x2 +# define XKU_SMIME 0x4 +# define XKU_CODE_SIGN 0x8 +# define XKU_SGC 0x10 +# define XKU_OCSP_SIGN 0x20 +# define XKU_TIMESTAMP 0x40 +# define XKU_DVCS 0x80 +# define XKU_ANYEKU 0x100 + +# define X509_PURPOSE_DYNAMIC 0x1 +# define X509_PURPOSE_DYNAMIC_NAME 0x2 + +typedef struct x509_purpose_st { + int purpose; + int trust; /* Default trust ID */ + int flags; + int (*check_purpose) (const struct x509_purpose_st *, const X509 *, int); + char *name; + char *sname; + void *usr_data; +} X509_PURPOSE; + +# define X509_PURPOSE_SSL_CLIENT 1 +# define X509_PURPOSE_SSL_SERVER 2 +# define X509_PURPOSE_NS_SSL_SERVER 3 +# define X509_PURPOSE_SMIME_SIGN 4 +# define X509_PURPOSE_SMIME_ENCRYPT 5 +# define X509_PURPOSE_CRL_SIGN 6 +# define X509_PURPOSE_ANY 7 +# define X509_PURPOSE_OCSP_HELPER 8 +# define X509_PURPOSE_TIMESTAMP_SIGN 9 + +# define X509_PURPOSE_MIN 1 +# define X509_PURPOSE_MAX 9 + +/* Flags for X509V3_EXT_print() */ + +# define X509V3_EXT_UNKNOWN_MASK (0xfL << 16) +/* Return error for unknown extensions */ +# define X509V3_EXT_DEFAULT 0 +/* Print error for unknown extensions */ +# define X509V3_EXT_ERROR_UNKNOWN (1L << 16) +/* ASN1 parse unknown extensions */ +# define X509V3_EXT_PARSE_UNKNOWN (2L << 16) +/* BIO_dump unknown extensions */ +# define X509V3_EXT_DUMP_UNKNOWN (3L << 16) + +/* Flags for X509V3_add1_i2d */ + +# define X509V3_ADD_OP_MASK 0xfL +# define X509V3_ADD_DEFAULT 0L +# define X509V3_ADD_APPEND 1L +# define X509V3_ADD_REPLACE 2L +# define X509V3_ADD_REPLACE_EXISTING 3L +# define X509V3_ADD_KEEP_EXISTING 4L +# define X509V3_ADD_DELETE 5L +# define X509V3_ADD_SILENT 0x10 + +DEFINE_STACK_OF(X509_PURPOSE) + +DECLARE_ASN1_FUNCTIONS(BASIC_CONSTRAINTS) + +DECLARE_ASN1_FUNCTIONS(SXNET) +DECLARE_ASN1_FUNCTIONS(SXNETID) + +int SXNET_add_id_asc(SXNET **psx, const char *zone, const char *user, int userlen); +int SXNET_add_id_ulong(SXNET **psx, unsigned long lzone, const char *user, + int userlen); +int SXNET_add_id_INTEGER(SXNET **psx, ASN1_INTEGER *izone, const char *user, + int userlen); + +ASN1_OCTET_STRING *SXNET_get_id_asc(SXNET *sx, const char *zone); +ASN1_OCTET_STRING *SXNET_get_id_ulong(SXNET *sx, unsigned long lzone); +ASN1_OCTET_STRING *SXNET_get_id_INTEGER(SXNET *sx, ASN1_INTEGER *zone); + +DECLARE_ASN1_FUNCTIONS(AUTHORITY_KEYID) + +DECLARE_ASN1_FUNCTIONS(PKEY_USAGE_PERIOD) + +DECLARE_ASN1_FUNCTIONS(GENERAL_NAME) +GENERAL_NAME *GENERAL_NAME_dup(GENERAL_NAME *a); +int GENERAL_NAME_cmp(GENERAL_NAME *a, GENERAL_NAME *b); + +ASN1_BIT_STRING *v2i_ASN1_BIT_STRING(X509V3_EXT_METHOD *method, + X509V3_CTX *ctx, + STACK_OF(CONF_VALUE) *nval); +STACK_OF(CONF_VALUE) *i2v_ASN1_BIT_STRING(X509V3_EXT_METHOD *method, + ASN1_BIT_STRING *bits, + STACK_OF(CONF_VALUE) *extlist); +char *i2s_ASN1_IA5STRING(X509V3_EXT_METHOD *method, ASN1_IA5STRING *ia5); +ASN1_IA5STRING *s2i_ASN1_IA5STRING(X509V3_EXT_METHOD *method, + X509V3_CTX *ctx, const char *str); + +STACK_OF(CONF_VALUE) *i2v_GENERAL_NAME(X509V3_EXT_METHOD *method, + GENERAL_NAME *gen, + STACK_OF(CONF_VALUE) *ret); +int GENERAL_NAME_print(BIO *out, GENERAL_NAME *gen); + +DECLARE_ASN1_FUNCTIONS(GENERAL_NAMES) + +STACK_OF(CONF_VALUE) *i2v_GENERAL_NAMES(X509V3_EXT_METHOD *method, + GENERAL_NAMES *gen, + STACK_OF(CONF_VALUE) *extlist); +GENERAL_NAMES *v2i_GENERAL_NAMES(const X509V3_EXT_METHOD *method, + X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *nval); + +DECLARE_ASN1_FUNCTIONS(OTHERNAME) +DECLARE_ASN1_FUNCTIONS(EDIPARTYNAME) +int OTHERNAME_cmp(OTHERNAME *a, OTHERNAME *b); +void GENERAL_NAME_set0_value(GENERAL_NAME *a, int type, void *value); +void *GENERAL_NAME_get0_value(GENERAL_NAME *a, int *ptype); +int GENERAL_NAME_set0_othername(GENERAL_NAME *gen, + ASN1_OBJECT *oid, ASN1_TYPE *value); +int GENERAL_NAME_get0_otherName(GENERAL_NAME *gen, + ASN1_OBJECT **poid, ASN1_TYPE **pvalue); + +char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, + const ASN1_OCTET_STRING *ia5); +ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, + X509V3_CTX *ctx, const char *str); + +DECLARE_ASN1_FUNCTIONS(EXTENDED_KEY_USAGE) +int i2a_ACCESS_DESCRIPTION(BIO *bp, const ACCESS_DESCRIPTION *a); + +DECLARE_ASN1_ALLOC_FUNCTIONS(TLS_FEATURE) + +DECLARE_ASN1_FUNCTIONS(CERTIFICATEPOLICIES) +DECLARE_ASN1_FUNCTIONS(POLICYINFO) +DECLARE_ASN1_FUNCTIONS(POLICYQUALINFO) +DECLARE_ASN1_FUNCTIONS(USERNOTICE) +DECLARE_ASN1_FUNCTIONS(NOTICEREF) + +DECLARE_ASN1_FUNCTIONS(CRL_DIST_POINTS) +DECLARE_ASN1_FUNCTIONS(DIST_POINT) +DECLARE_ASN1_FUNCTIONS(DIST_POINT_NAME) +DECLARE_ASN1_FUNCTIONS(ISSUING_DIST_POINT) + +int DIST_POINT_set_dpname(DIST_POINT_NAME *dpn, X509_NAME *iname); + +int NAME_CONSTRAINTS_check(X509 *x, NAME_CONSTRAINTS *nc); +int NAME_CONSTRAINTS_check_CN(X509 *x, NAME_CONSTRAINTS *nc); + +DECLARE_ASN1_FUNCTIONS(ACCESS_DESCRIPTION) +DECLARE_ASN1_FUNCTIONS(AUTHORITY_INFO_ACCESS) + +DECLARE_ASN1_ITEM(POLICY_MAPPING) +DECLARE_ASN1_ALLOC_FUNCTIONS(POLICY_MAPPING) +DECLARE_ASN1_ITEM(POLICY_MAPPINGS) + +DECLARE_ASN1_ITEM(GENERAL_SUBTREE) +DECLARE_ASN1_ALLOC_FUNCTIONS(GENERAL_SUBTREE) + +DECLARE_ASN1_ITEM(NAME_CONSTRAINTS) +DECLARE_ASN1_ALLOC_FUNCTIONS(NAME_CONSTRAINTS) + +DECLARE_ASN1_ALLOC_FUNCTIONS(POLICY_CONSTRAINTS) +DECLARE_ASN1_ITEM(POLICY_CONSTRAINTS) + +GENERAL_NAME *a2i_GENERAL_NAME(GENERAL_NAME *out, + const X509V3_EXT_METHOD *method, + X509V3_CTX *ctx, int gen_type, + const char *value, int is_nc); + +# ifdef HEADER_CONF_H +GENERAL_NAME *v2i_GENERAL_NAME(const X509V3_EXT_METHOD *method, + X509V3_CTX *ctx, CONF_VALUE *cnf); +GENERAL_NAME *v2i_GENERAL_NAME_ex(GENERAL_NAME *out, + const X509V3_EXT_METHOD *method, + X509V3_CTX *ctx, CONF_VALUE *cnf, + int is_nc); +void X509V3_conf_free(CONF_VALUE *val); + +X509_EXTENSION *X509V3_EXT_nconf_nid(CONF *conf, X509V3_CTX *ctx, int ext_nid, + const char *value); +X509_EXTENSION *X509V3_EXT_nconf(CONF *conf, X509V3_CTX *ctx, const char *name, + const char *value); +int X509V3_EXT_add_nconf_sk(CONF *conf, X509V3_CTX *ctx, const char *section, + STACK_OF(X509_EXTENSION) **sk); +int X509V3_EXT_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section, + X509 *cert); +int X509V3_EXT_REQ_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section, + X509_REQ *req); +int X509V3_EXT_CRL_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section, + X509_CRL *crl); + +X509_EXTENSION *X509V3_EXT_conf_nid(LHASH_OF(CONF_VALUE) *conf, + X509V3_CTX *ctx, int ext_nid, + const char *value); +X509_EXTENSION *X509V3_EXT_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx, + const char *name, const char *value); +int X509V3_EXT_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx, + const char *section, X509 *cert); +int X509V3_EXT_REQ_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx, + const char *section, X509_REQ *req); +int X509V3_EXT_CRL_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx, + const char *section, X509_CRL *crl); + +int X509V3_add_value_bool_nf(const char *name, int asn1_bool, + STACK_OF(CONF_VALUE) **extlist); +int X509V3_get_value_bool(const CONF_VALUE *value, int *asn1_bool); +int X509V3_get_value_int(const CONF_VALUE *value, ASN1_INTEGER **aint); +void X509V3_set_nconf(X509V3_CTX *ctx, CONF *conf); +void X509V3_set_conf_lhash(X509V3_CTX *ctx, LHASH_OF(CONF_VALUE) *lhash); +# endif + +char *X509V3_get_string(X509V3_CTX *ctx, const char *name, const char *section); +STACK_OF(CONF_VALUE) *X509V3_get_section(X509V3_CTX *ctx, const char *section); +void X509V3_string_free(X509V3_CTX *ctx, char *str); +void X509V3_section_free(X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *section); +void X509V3_set_ctx(X509V3_CTX *ctx, X509 *issuer, X509 *subject, + X509_REQ *req, X509_CRL *crl, int flags); + +int X509V3_add_value(const char *name, const char *value, + STACK_OF(CONF_VALUE) **extlist); +int X509V3_add_value_uchar(const char *name, const unsigned char *value, + STACK_OF(CONF_VALUE) **extlist); +int X509V3_add_value_bool(const char *name, int asn1_bool, + STACK_OF(CONF_VALUE) **extlist); +int X509V3_add_value_int(const char *name, const ASN1_INTEGER *aint, + STACK_OF(CONF_VALUE) **extlist); +char *i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, const ASN1_INTEGER *aint); +ASN1_INTEGER *s2i_ASN1_INTEGER(X509V3_EXT_METHOD *meth, const char *value); +char *i2s_ASN1_ENUMERATED(X509V3_EXT_METHOD *meth, const ASN1_ENUMERATED *aint); +char *i2s_ASN1_ENUMERATED_TABLE(X509V3_EXT_METHOD *meth, + const ASN1_ENUMERATED *aint); +int X509V3_EXT_add(X509V3_EXT_METHOD *ext); +int X509V3_EXT_add_list(X509V3_EXT_METHOD *extlist); +int X509V3_EXT_add_alias(int nid_to, int nid_from); +void X509V3_EXT_cleanup(void); + +const X509V3_EXT_METHOD *X509V3_EXT_get(X509_EXTENSION *ext); +const X509V3_EXT_METHOD *X509V3_EXT_get_nid(int nid); +int X509V3_add_standard_extensions(void); +STACK_OF(CONF_VALUE) *X509V3_parse_list(const char *line); +void *X509V3_EXT_d2i(X509_EXTENSION *ext); +void *X509V3_get_d2i(const STACK_OF(X509_EXTENSION) *x, int nid, int *crit, + int *idx); + +X509_EXTENSION *X509V3_EXT_i2d(int ext_nid, int crit, void *ext_struc); +int X509V3_add1_i2d(STACK_OF(X509_EXTENSION) **x, int nid, void *value, + int crit, unsigned long flags); + +#if OPENSSL_API_COMPAT < 0x10100000L +/* The new declarations are in crypto.h, but the old ones were here. */ +# define hex_to_string OPENSSL_buf2hexstr +# define string_to_hex OPENSSL_hexstr2buf +#endif + +void X509V3_EXT_val_prn(BIO *out, STACK_OF(CONF_VALUE) *val, int indent, + int ml); +int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, unsigned long flag, + int indent); +#ifndef OPENSSL_NO_STDIO +int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent); +#endif +int X509V3_extensions_print(BIO *out, const char *title, + const STACK_OF(X509_EXTENSION) *exts, + unsigned long flag, int indent); + +int X509_check_ca(X509 *x); +int X509_check_purpose(X509 *x, int id, int ca); +int X509_supported_extension(X509_EXTENSION *ex); +int X509_PURPOSE_set(int *p, int purpose); +int X509_check_issued(X509 *issuer, X509 *subject); +int X509_check_akid(X509 *issuer, AUTHORITY_KEYID *akid); +void X509_set_proxy_flag(X509 *x); +void X509_set_proxy_pathlen(X509 *x, long l); +long X509_get_proxy_pathlen(X509 *x); + +uint32_t X509_get_extension_flags(X509 *x); +uint32_t X509_get_key_usage(X509 *x); +uint32_t X509_get_extended_key_usage(X509 *x); +const ASN1_OCTET_STRING *X509_get0_subject_key_id(X509 *x); +const ASN1_OCTET_STRING *X509_get0_authority_key_id(X509 *x); + +int X509_PURPOSE_get_count(void); +X509_PURPOSE *X509_PURPOSE_get0(int idx); +int X509_PURPOSE_get_by_sname(const char *sname); +int X509_PURPOSE_get_by_id(int id); +int X509_PURPOSE_add(int id, int trust, int flags, + int (*ck) (const X509_PURPOSE *, const X509 *, int), + const char *name, const char *sname, void *arg); +char *X509_PURPOSE_get0_name(const X509_PURPOSE *xp); +char *X509_PURPOSE_get0_sname(const X509_PURPOSE *xp); +int X509_PURPOSE_get_trust(const X509_PURPOSE *xp); +void X509_PURPOSE_cleanup(void); +int X509_PURPOSE_get_id(const X509_PURPOSE *); + +STACK_OF(OPENSSL_STRING) *X509_get1_email(X509 *x); +STACK_OF(OPENSSL_STRING) *X509_REQ_get1_email(X509_REQ *x); +void X509_email_free(STACK_OF(OPENSSL_STRING) *sk); +STACK_OF(OPENSSL_STRING) *X509_get1_ocsp(X509 *x); +/* Flags for X509_check_* functions */ + +/* + * Always check subject name for host match even if subject alt names present + */ +# define X509_CHECK_FLAG_ALWAYS_CHECK_SUBJECT 0x1 +/* Disable wildcard matching for dnsName fields and common name. */ +# define X509_CHECK_FLAG_NO_WILDCARDS 0x2 +/* Wildcards must not match a partial label. */ +# define X509_CHECK_FLAG_NO_PARTIAL_WILDCARDS 0x4 +/* Allow (non-partial) wildcards to match multiple labels. */ +# define X509_CHECK_FLAG_MULTI_LABEL_WILDCARDS 0x8 +/* Constraint verifier subdomain patterns to match a single labels. */ +# define X509_CHECK_FLAG_SINGLE_LABEL_SUBDOMAINS 0x10 +/* Never check the subject CN */ +# define X509_CHECK_FLAG_NEVER_CHECK_SUBJECT 0x20 +/* + * Match reference identifiers starting with "." to any sub-domain. + * This is a non-public flag, turned on implicitly when the subject + * reference identity is a DNS name. + */ +# define _X509_CHECK_FLAG_DOT_SUBDOMAINS 0x8000 + +int X509_check_host(X509 *x, const char *chk, size_t chklen, + unsigned int flags, char **peername); +int X509_check_email(X509 *x, const char *chk, size_t chklen, + unsigned int flags); +int X509_check_ip(X509 *x, const unsigned char *chk, size_t chklen, + unsigned int flags); +int X509_check_ip_asc(X509 *x, const char *ipasc, unsigned int flags); + +ASN1_OCTET_STRING *a2i_IPADDRESS(const char *ipasc); +ASN1_OCTET_STRING *a2i_IPADDRESS_NC(const char *ipasc); +int X509V3_NAME_from_section(X509_NAME *nm, STACK_OF(CONF_VALUE) *dn_sk, + unsigned long chtype); + +void X509_POLICY_NODE_print(BIO *out, X509_POLICY_NODE *node, int indent); +DEFINE_STACK_OF(X509_POLICY_NODE) + +#ifndef OPENSSL_NO_RFC3779 +typedef struct ASRange_st { + ASN1_INTEGER *min, *max; +} ASRange; + +# define ASIdOrRange_id 0 +# define ASIdOrRange_range 1 + +typedef struct ASIdOrRange_st { + int type; + union { + ASN1_INTEGER *id; + ASRange *range; + } u; +} ASIdOrRange; + +typedef STACK_OF(ASIdOrRange) ASIdOrRanges; +DEFINE_STACK_OF(ASIdOrRange) + +# define ASIdentifierChoice_inherit 0 +# define ASIdentifierChoice_asIdsOrRanges 1 + +typedef struct ASIdentifierChoice_st { + int type; + union { + ASN1_NULL *inherit; + ASIdOrRanges *asIdsOrRanges; + } u; +} ASIdentifierChoice; + +typedef struct ASIdentifiers_st { + ASIdentifierChoice *asnum, *rdi; +} ASIdentifiers; + +DECLARE_ASN1_FUNCTIONS(ASRange) +DECLARE_ASN1_FUNCTIONS(ASIdOrRange) +DECLARE_ASN1_FUNCTIONS(ASIdentifierChoice) +DECLARE_ASN1_FUNCTIONS(ASIdentifiers) + +typedef struct IPAddressRange_st { + ASN1_BIT_STRING *min, *max; +} IPAddressRange; + +# define IPAddressOrRange_addressPrefix 0 +# define IPAddressOrRange_addressRange 1 + +typedef struct IPAddressOrRange_st { + int type; + union { + ASN1_BIT_STRING *addressPrefix; + IPAddressRange *addressRange; + } u; +} IPAddressOrRange; + +typedef STACK_OF(IPAddressOrRange) IPAddressOrRanges; +DEFINE_STACK_OF(IPAddressOrRange) + +# define IPAddressChoice_inherit 0 +# define IPAddressChoice_addressesOrRanges 1 + +typedef struct IPAddressChoice_st { + int type; + union { + ASN1_NULL *inherit; + IPAddressOrRanges *addressesOrRanges; + } u; +} IPAddressChoice; + +typedef struct IPAddressFamily_st { + ASN1_OCTET_STRING *addressFamily; + IPAddressChoice *ipAddressChoice; +} IPAddressFamily; + +typedef STACK_OF(IPAddressFamily) IPAddrBlocks; +DEFINE_STACK_OF(IPAddressFamily) + +DECLARE_ASN1_FUNCTIONS(IPAddressRange) +DECLARE_ASN1_FUNCTIONS(IPAddressOrRange) +DECLARE_ASN1_FUNCTIONS(IPAddressChoice) +DECLARE_ASN1_FUNCTIONS(IPAddressFamily) + +/* + * API tag for elements of the ASIdentifer SEQUENCE. + */ +# define V3_ASID_ASNUM 0 +# define V3_ASID_RDI 1 + +/* + * AFI values, assigned by IANA. It'd be nice to make the AFI + * handling code totally generic, but there are too many little things + * that would need to be defined for other address families for it to + * be worth the trouble. + */ +# define IANA_AFI_IPV4 1 +# define IANA_AFI_IPV6 2 + +/* + * Utilities to construct and extract values from RFC3779 extensions, + * since some of the encodings (particularly for IP address prefixes + * and ranges) are a bit tedious to work with directly. + */ +int X509v3_asid_add_inherit(ASIdentifiers *asid, int which); +int X509v3_asid_add_id_or_range(ASIdentifiers *asid, int which, + ASN1_INTEGER *min, ASN1_INTEGER *max); +int X509v3_addr_add_inherit(IPAddrBlocks *addr, + const unsigned afi, const unsigned *safi); +int X509v3_addr_add_prefix(IPAddrBlocks *addr, + const unsigned afi, const unsigned *safi, + unsigned char *a, const int prefixlen); +int X509v3_addr_add_range(IPAddrBlocks *addr, + const unsigned afi, const unsigned *safi, + unsigned char *min, unsigned char *max); +unsigned X509v3_addr_get_afi(const IPAddressFamily *f); +int X509v3_addr_get_range(IPAddressOrRange *aor, const unsigned afi, + unsigned char *min, unsigned char *max, + const int length); + +/* + * Canonical forms. + */ +int X509v3_asid_is_canonical(ASIdentifiers *asid); +int X509v3_addr_is_canonical(IPAddrBlocks *addr); +int X509v3_asid_canonize(ASIdentifiers *asid); +int X509v3_addr_canonize(IPAddrBlocks *addr); + +/* + * Tests for inheritance and containment. + */ +int X509v3_asid_inherits(ASIdentifiers *asid); +int X509v3_addr_inherits(IPAddrBlocks *addr); +int X509v3_asid_subset(ASIdentifiers *a, ASIdentifiers *b); +int X509v3_addr_subset(IPAddrBlocks *a, IPAddrBlocks *b); + +/* + * Check whether RFC 3779 extensions nest properly in chains. + */ +int X509v3_asid_validate_path(X509_STORE_CTX *); +int X509v3_addr_validate_path(X509_STORE_CTX *); +int X509v3_asid_validate_resource_set(STACK_OF(X509) *chain, + ASIdentifiers *ext, + int allow_inheritance); +int X509v3_addr_validate_resource_set(STACK_OF(X509) *chain, + IPAddrBlocks *ext, int allow_inheritance); + +#endif /* OPENSSL_NO_RFC3779 */ + +DEFINE_STACK_OF(ASN1_STRING) + +/* + * Admission Syntax + */ +typedef struct NamingAuthority_st NAMING_AUTHORITY; +typedef struct ProfessionInfo_st PROFESSION_INFO; +typedef struct Admissions_st ADMISSIONS; +typedef struct AdmissionSyntax_st ADMISSION_SYNTAX; +DECLARE_ASN1_FUNCTIONS(NAMING_AUTHORITY) +DECLARE_ASN1_FUNCTIONS(PROFESSION_INFO) +DECLARE_ASN1_FUNCTIONS(ADMISSIONS) +DECLARE_ASN1_FUNCTIONS(ADMISSION_SYNTAX) +DEFINE_STACK_OF(ADMISSIONS) +DEFINE_STACK_OF(PROFESSION_INFO) +typedef STACK_OF(PROFESSION_INFO) PROFESSION_INFOS; + +const ASN1_OBJECT *NAMING_AUTHORITY_get0_authorityId( + const NAMING_AUTHORITY *n); +const ASN1_IA5STRING *NAMING_AUTHORITY_get0_authorityURL( + const NAMING_AUTHORITY *n); +const ASN1_STRING *NAMING_AUTHORITY_get0_authorityText( + const NAMING_AUTHORITY *n); +void NAMING_AUTHORITY_set0_authorityId(NAMING_AUTHORITY *n, + ASN1_OBJECT* namingAuthorityId); +void NAMING_AUTHORITY_set0_authorityURL(NAMING_AUTHORITY *n, + ASN1_IA5STRING* namingAuthorityUrl); +void NAMING_AUTHORITY_set0_authorityText(NAMING_AUTHORITY *n, + ASN1_STRING* namingAuthorityText); + +const GENERAL_NAME *ADMISSION_SYNTAX_get0_admissionAuthority( + const ADMISSION_SYNTAX *as); +void ADMISSION_SYNTAX_set0_admissionAuthority( + ADMISSION_SYNTAX *as, GENERAL_NAME *aa); +const STACK_OF(ADMISSIONS) *ADMISSION_SYNTAX_get0_contentsOfAdmissions( + const ADMISSION_SYNTAX *as); +void ADMISSION_SYNTAX_set0_contentsOfAdmissions( + ADMISSION_SYNTAX *as, STACK_OF(ADMISSIONS) *a); +const GENERAL_NAME *ADMISSIONS_get0_admissionAuthority(const ADMISSIONS *a); +void ADMISSIONS_set0_admissionAuthority(ADMISSIONS *a, GENERAL_NAME *aa); +const NAMING_AUTHORITY *ADMISSIONS_get0_namingAuthority(const ADMISSIONS *a); +void ADMISSIONS_set0_namingAuthority(ADMISSIONS *a, NAMING_AUTHORITY *na); +const PROFESSION_INFOS *ADMISSIONS_get0_professionInfos(const ADMISSIONS *a); +void ADMISSIONS_set0_professionInfos(ADMISSIONS *a, PROFESSION_INFOS *pi); +const ASN1_OCTET_STRING *PROFESSION_INFO_get0_addProfessionInfo( + const PROFESSION_INFO *pi); +void PROFESSION_INFO_set0_addProfessionInfo( + PROFESSION_INFO *pi, ASN1_OCTET_STRING *aos); +const NAMING_AUTHORITY *PROFESSION_INFO_get0_namingAuthority( + const PROFESSION_INFO *pi); +void PROFESSION_INFO_set0_namingAuthority( + PROFESSION_INFO *pi, NAMING_AUTHORITY *na); +const STACK_OF(ASN1_STRING) *PROFESSION_INFO_get0_professionItems( + const PROFESSION_INFO *pi); +void PROFESSION_INFO_set0_professionItems( + PROFESSION_INFO *pi, STACK_OF(ASN1_STRING) *as); +const STACK_OF(ASN1_OBJECT) *PROFESSION_INFO_get0_professionOIDs( + const PROFESSION_INFO *pi); +void PROFESSION_INFO_set0_professionOIDs( + PROFESSION_INFO *pi, STACK_OF(ASN1_OBJECT) *po); +const ASN1_PRINTABLESTRING *PROFESSION_INFO_get0_registrationNumber( + const PROFESSION_INFO *pi); +void PROFESSION_INFO_set0_registrationNumber( + PROFESSION_INFO *pi, ASN1_PRINTABLESTRING *rn); + +# ifdef __cplusplus +} +# endif +#endif diff --git a/include/openssl/x509v3err.h b/include/openssl/x509v3err.h new file mode 100644 index 0000000..6b3df12 --- /dev/null +++ b/include/openssl/x509v3err.h @@ -0,0 +1,158 @@ +/* + * Generated by util/mkerr.pl DO NOT EDIT + * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved. + * + * Licensed under the OpenSSL license (the "License"). You may not use + * this file except in compliance with the License. You can obtain a copy + * in the file LICENSE in the source distribution or at + * https://www.openssl.org/source/license.html + */ + +#ifndef HEADER_X509V3ERR_H +# define HEADER_X509V3ERR_H + +# ifdef __cplusplus +extern "C" +# endif +int ERR_load_X509V3_strings(void); + +/* + * X509V3 function codes. + */ +# define X509V3_F_A2I_GENERAL_NAME 164 +# define X509V3_F_ADDR_VALIDATE_PATH_INTERNAL 166 +# define X509V3_F_ASIDENTIFIERCHOICE_CANONIZE 161 +# define X509V3_F_ASIDENTIFIERCHOICE_IS_CANONICAL 162 +# define X509V3_F_BIGNUM_TO_STRING 167 +# define X509V3_F_COPY_EMAIL 122 +# define X509V3_F_COPY_ISSUER 123 +# define X509V3_F_DO_DIRNAME 144 +# define X509V3_F_DO_EXT_I2D 135 +# define X509V3_F_DO_EXT_NCONF 151 +# define X509V3_F_GNAMES_FROM_SECTNAME 156 +# define X509V3_F_I2S_ASN1_ENUMERATED 121 +# define X509V3_F_I2S_ASN1_IA5STRING 149 +# define X509V3_F_I2S_ASN1_INTEGER 120 +# define X509V3_F_I2V_AUTHORITY_INFO_ACCESS 138 +# define X509V3_F_LEVEL_ADD_NODE 168 +# define X509V3_F_NOTICE_SECTION 132 +# define X509V3_F_NREF_NOS 133 +# define X509V3_F_POLICY_CACHE_CREATE 169 +# define X509V3_F_POLICY_CACHE_NEW 170 +# define X509V3_F_POLICY_DATA_NEW 171 +# define X509V3_F_POLICY_SECTION 131 +# define X509V3_F_PROCESS_PCI_VALUE 150 +# define X509V3_F_R2I_CERTPOL 130 +# define X509V3_F_R2I_PCI 155 +# define X509V3_F_S2I_ASN1_IA5STRING 100 +# define X509V3_F_S2I_ASN1_INTEGER 108 +# define X509V3_F_S2I_ASN1_OCTET_STRING 112 +# define X509V3_F_S2I_SKEY_ID 115 +# define X509V3_F_SET_DIST_POINT_NAME 158 +# define X509V3_F_SXNET_ADD_ID_ASC 125 +# define X509V3_F_SXNET_ADD_ID_INTEGER 126 +# define X509V3_F_SXNET_ADD_ID_ULONG 127 +# define X509V3_F_SXNET_GET_ID_ASC 128 +# define X509V3_F_SXNET_GET_ID_ULONG 129 +# define X509V3_F_TREE_INIT 172 +# define X509V3_F_V2I_ASIDENTIFIERS 163 +# define X509V3_F_V2I_ASN1_BIT_STRING 101 +# define X509V3_F_V2I_AUTHORITY_INFO_ACCESS 139 +# define X509V3_F_V2I_AUTHORITY_KEYID 119 +# define X509V3_F_V2I_BASIC_CONSTRAINTS 102 +# define X509V3_F_V2I_CRLD 134 +# define X509V3_F_V2I_EXTENDED_KEY_USAGE 103 +# define X509V3_F_V2I_GENERAL_NAMES 118 +# define X509V3_F_V2I_GENERAL_NAME_EX 117 +# define X509V3_F_V2I_IDP 157 +# define X509V3_F_V2I_IPADDRBLOCKS 159 +# define X509V3_F_V2I_ISSUER_ALT 153 +# define X509V3_F_V2I_NAME_CONSTRAINTS 147 +# define X509V3_F_V2I_POLICY_CONSTRAINTS 146 +# define X509V3_F_V2I_POLICY_MAPPINGS 145 +# define X509V3_F_V2I_SUBJECT_ALT 154 +# define X509V3_F_V2I_TLS_FEATURE 165 +# define X509V3_F_V3_GENERIC_EXTENSION 116 +# define X509V3_F_X509V3_ADD1_I2D 140 +# define X509V3_F_X509V3_ADD_VALUE 105 +# define X509V3_F_X509V3_EXT_ADD 104 +# define X509V3_F_X509V3_EXT_ADD_ALIAS 106 +# define X509V3_F_X509V3_EXT_I2D 136 +# define X509V3_F_X509V3_EXT_NCONF 152 +# define X509V3_F_X509V3_GET_SECTION 142 +# define X509V3_F_X509V3_GET_STRING 143 +# define X509V3_F_X509V3_GET_VALUE_BOOL 110 +# define X509V3_F_X509V3_PARSE_LIST 109 +# define X509V3_F_X509_PURPOSE_ADD 137 +# define X509V3_F_X509_PURPOSE_SET 141 + +/* + * X509V3 reason codes. + */ +# define X509V3_R_BAD_IP_ADDRESS 118 +# define X509V3_R_BAD_OBJECT 119 +# define X509V3_R_BN_DEC2BN_ERROR 100 +# define X509V3_R_BN_TO_ASN1_INTEGER_ERROR 101 +# define X509V3_R_DIRNAME_ERROR 149 +# define X509V3_R_DISTPOINT_ALREADY_SET 160 +# define X509V3_R_DUPLICATE_ZONE_ID 133 +# define X509V3_R_ERROR_CONVERTING_ZONE 131 +# define X509V3_R_ERROR_CREATING_EXTENSION 144 +# define X509V3_R_ERROR_IN_EXTENSION 128 +# define X509V3_R_EXPECTED_A_SECTION_NAME 137 +# define X509V3_R_EXTENSION_EXISTS 145 +# define X509V3_R_EXTENSION_NAME_ERROR 115 +# define X509V3_R_EXTENSION_NOT_FOUND 102 +# define X509V3_R_EXTENSION_SETTING_NOT_SUPPORTED 103 +# define X509V3_R_EXTENSION_VALUE_ERROR 116 +# define X509V3_R_ILLEGAL_EMPTY_EXTENSION 151 +# define X509V3_R_INCORRECT_POLICY_SYNTAX_TAG 152 +# define X509V3_R_INVALID_ASNUMBER 162 +# define X509V3_R_INVALID_ASRANGE 163 +# define X509V3_R_INVALID_BOOLEAN_STRING 104 +# define X509V3_R_INVALID_EXTENSION_STRING 105 +# define X509V3_R_INVALID_INHERITANCE 165 +# define X509V3_R_INVALID_IPADDRESS 166 +# define X509V3_R_INVALID_MULTIPLE_RDNS 161 +# define X509V3_R_INVALID_NAME 106 +# define X509V3_R_INVALID_NULL_ARGUMENT 107 +# define X509V3_R_INVALID_NULL_NAME 108 +# define X509V3_R_INVALID_NULL_VALUE 109 +# define X509V3_R_INVALID_NUMBER 140 +# define X509V3_R_INVALID_NUMBERS 141 +# define X509V3_R_INVALID_OBJECT_IDENTIFIER 110 +# define X509V3_R_INVALID_OPTION 138 +# define X509V3_R_INVALID_POLICY_IDENTIFIER 134 +# define X509V3_R_INVALID_PROXY_POLICY_SETTING 153 +# define X509V3_R_INVALID_PURPOSE 146 +# define X509V3_R_INVALID_SAFI 164 +# define X509V3_R_INVALID_SECTION 135 +# define X509V3_R_INVALID_SYNTAX 143 +# define X509V3_R_ISSUER_DECODE_ERROR 126 +# define X509V3_R_MISSING_VALUE 124 +# define X509V3_R_NEED_ORGANIZATION_AND_NUMBERS 142 +# define X509V3_R_NO_CONFIG_DATABASE 136 +# define X509V3_R_NO_ISSUER_CERTIFICATE 121 +# define X509V3_R_NO_ISSUER_DETAILS 127 +# define X509V3_R_NO_POLICY_IDENTIFIER 139 +# define X509V3_R_NO_PROXY_CERT_POLICY_LANGUAGE_DEFINED 154 +# define X509V3_R_NO_PUBLIC_KEY 114 +# define X509V3_R_NO_SUBJECT_DETAILS 125 +# define X509V3_R_OPERATION_NOT_DEFINED 148 +# define X509V3_R_OTHERNAME_ERROR 147 +# define X509V3_R_POLICY_LANGUAGE_ALREADY_DEFINED 155 +# define X509V3_R_POLICY_PATH_LENGTH 156 +# define X509V3_R_POLICY_PATH_LENGTH_ALREADY_DEFINED 157 +# define X509V3_R_POLICY_WHEN_PROXY_LANGUAGE_REQUIRES_NO_POLICY 159 +# define X509V3_R_SECTION_NOT_FOUND 150 +# define X509V3_R_UNABLE_TO_GET_ISSUER_DETAILS 122 +# define X509V3_R_UNABLE_TO_GET_ISSUER_KEYID 123 +# define X509V3_R_UNKNOWN_BIT_STRING_ARGUMENT 111 +# define X509V3_R_UNKNOWN_EXTENSION 129 +# define X509V3_R_UNKNOWN_EXTENSION_NAME 130 +# define X509V3_R_UNKNOWN_OPTION 120 +# define X509V3_R_UNSUPPORTED_OPTION 117 +# define X509V3_R_UNSUPPORTED_TYPE 167 +# define X509V3_R_USER_TOO_LONG 132 + +#endif diff --git a/include/png/IDATDecoder.hpp b/include/png/IDATDecoder.hpp new file mode 100644 index 0000000..a2a5761 --- /dev/null +++ b/include/png/IDATDecoder.hpp @@ -0,0 +1,19 @@ +#ifndef IDATDECODER_HPP +#define IDATDECODER_HPP + +#include "include/array/GrowableObjectArray.hpp" +#include "include/array/GrowableByteArray.hpp" +#include "include/png/PNGChunkIDAT.hpp" +#include "include/png/PNGChunkIHDR.hpp" + +class IDATDecoder{ + + public: + + static unsigned char* decompressIDATChunks(GrowableObjectArray* idatchunks, unsigned long* resultLength); + + static unsigned char** decodeIDATChunks(GrowableObjectArray* idatchunks ,unsigned long* resultLength, PNGChunkIHDR* imgInfo); + +}; + +#endif // IDATDECODER_HPP diff --git a/include/png/PNGChunk.hpp b/include/png/PNGChunk.hpp new file mode 100644 index 0000000..888ca5d --- /dev/null +++ b/include/png/PNGChunk.hpp @@ -0,0 +1,48 @@ +#ifndef PNGCHUNK_HPP +#define PNGCHUNK_HPP + +#include "include/array/GrowableObjectArray.hpp" + +class PNGChunk{ + + protected: + + unsigned int chunkLength; + unsigned int chunkTypeInt; + unsigned char* chunkData; + unsigned int crc32; + + PNGChunk(unsigned int chunkLength ,unsigned int type, const unsigned char* chunkData, unsigned int crc32); + + public: + + static const char* CHUNKTYPE_IHDR; + static const char* CHUNKTYPE_PHYS; + static const char* CHUNKTYPE_TEXT; + static const char* CHUNKTYPE_ZTXT; + static const char* CHUNKTYPE_TRNS; + static const char* CHUNKTYPE_IDAT; + static const char* CHUNKTYPE_PLTE; + static const char* CHUNKTYPE_ITXT; + static const char* CHUNKTYPE_TIME; + static const char* CHUNKTYPE_IEND; + + static unsigned int chunkTypeToInt(const char* type); + + static GrowableObjectArray* readChunks(const unsigned char* pngdata, const char* type); + + unsigned int getChunkLength(); + + unsigned int getChunkType(); + + const unsigned char* getChunkData(); + + unsigned int getCRC32(); + + unsigned int isCRC32Matched(); + + ~PNGChunk(); + +}; + +#endif // PNGCHUNK_HPP diff --git a/include/png/PNGChunkIDAT.hpp b/include/png/PNGChunkIDAT.hpp new file mode 100644 index 0000000..212ed2b --- /dev/null +++ b/include/png/PNGChunkIDAT.hpp @@ -0,0 +1,14 @@ +#ifndef PNGCHUNKIDAT_HPP +#define PNGCHUNKIDAT_HPP + +#include "include/png/PNGChunk.hpp" + +class PNGChunkIDAT : public PNGChunk{ + + public: + + PNGChunkIDAT(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + +}; + +#endif // PNGCHUNKIDAT_HPP diff --git a/include/png/PNGChunkIHDR.hpp b/include/png/PNGChunkIHDR.hpp new file mode 100644 index 0000000..2472cd2 --- /dev/null +++ b/include/png/PNGChunkIHDR.hpp @@ -0,0 +1,61 @@ +#ifndef PNGCHUNKIDHR_HPP +#define PNGCHUNKIDHR_HPP + +#include "include/png/PNGChunk.hpp" + +class PNGChunkIHDR : public PNGChunk{ + + private: + + unsigned int imgHeight; + unsigned int imgWidth; + unsigned int imgColorType; + unsigned int imgBitDepth; + unsigned int imgCompressMethod; + unsigned int imgFilterMethod; + unsigned int imgInterlaceMethod; + + public: + + static const unsigned char IMG_COLORTYPE_GRAYSCALE; + static const unsigned char IMG_COLORTYPE_GRAYSCALE_CHANNEL; + static const unsigned char IMG_COLORTYPE_TRUECOLOR; + static const unsigned char IMG_COLORTYPE_TRUECOLOR_CHANNEL; + static const unsigned char IMG_COLORTYPE_INDEXEDCOLOR; + static const unsigned char IMG_COLORTYPE_INDEXEDCOLOR_CHANNEL; + static const unsigned char IMG_COLORTYPE_ALPHA_GRAYSCALE; + static const unsigned char IMG_COLORTYPE_ALPHA_GRAYSCALE_CHANNEL; + static const unsigned char IMG_COLORTYPE_ALPHA_TRUECOLOR; + static const unsigned char IMG_COLORTYPE_ALPHA_TRUECOLOR_CHANNEL; + + static const unsigned char IMG_COMPRESS_METHOD_DEFAULT; + + static const unsigned char IMG_SCAN_METHOD_SCANLINE; + static const unsigned char IMG_SCAN_METHOD_ADAM7; + + PNGChunkIHDR(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + + unsigned int getImageHeight(); + + unsigned int getImageWidth(); + + unsigned int getImageColorType(); + + unsigned int getImageBitBepth(); + + unsigned int getImageCompressMethod(); + + unsigned int getImageFilterMethod(); + + unsigned int getImageInterlaceMethod(); + + unsigned int getCRC32(); + + unsigned int getColorChannelCount(); + + unsigned int getBitsPerPixel(); + + +}; + +#endif // PNGCHUNKIDHR_HPP diff --git a/include/png/PNGChunkITXT.hpp b/include/png/PNGChunkITXT.hpp new file mode 100644 index 0000000..b29dd15 --- /dev/null +++ b/include/png/PNGChunkITXT.hpp @@ -0,0 +1,39 @@ +#ifndef PNGCHUNKITXT_HPP +#define PNGCHUNKITXT_HPP + +#include "include/png/PNGChunk.hpp" + +class PNGChunkITXT : public PNGChunk{ + + private: + + unsigned char* keyword=0; + unsigned char compressFlag; + unsigned char compressMethod; + unsigned char* label=0; + unsigned char* translatedKeyword=0; + unsigned char* content=0; + + + public: + + PNGChunkITXT(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + + unsigned char isCompressed(); + + unsigned char getCompressMethod(); + + const unsigned char* getKeyword(); + + const unsigned char* getLabel(); + + const unsigned char* getTranslatedKeyword(); + + const unsigned char* getText(); + + ~PNGChunkITXT(); + + +}; + +#endif // PNGCHUNKITXT_HPP diff --git a/include/png/PNGChunkPHYS.hpp b/include/png/PNGChunkPHYS.hpp new file mode 100644 index 0000000..110daca --- /dev/null +++ b/include/png/PNGChunkPHYS.hpp @@ -0,0 +1,28 @@ +#ifndef PNGCHUNKPHYS_H +#define PNGCHUNKPHYS_H +#include "include/png/PNGChunk.hpp" + +class PNGChunkPHYS : public PNGChunk{ + + private: + + unsigned int pixelsPerUnitX; + unsigned int pixelsPerUnitY; + unsigned int unitToken; + + public: + + static const unsigned char UNIT_METER=1; + static const unsigned char UNIT_UNKNOWN=0; + + PNGChunkPHYS(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + + unsigned int getPixelsPerUnitX(); + + unsigned int getPixelsPerUnitY(); + + unsigned int getUnit(); + +}; + +#endif // PNGCHUNKPHYS_H diff --git a/include/png/PNGChunkPLTE.hpp b/include/png/PNGChunkPLTE.hpp new file mode 100644 index 0000000..c3a0773 --- /dev/null +++ b/include/png/PNGChunkPLTE.hpp @@ -0,0 +1,13 @@ +#ifndef PNGCHUNKPLTE_H +#define PNGCHUNKPLTE_H +#include "include/png/PNGChunk.hpp" + +class PNGChunkPLTE : public PNGChunk{ + + public: + + PNGChunkPLTE(unsigned int chunkLength, unsigned int type, const unsigned char* chunkData, unsigned int crc32); + +}; + +#endif // PNGCHUNKPLTE_H diff --git a/include/png/PNGChunkTEXT.hpp b/include/png/PNGChunkTEXT.hpp new file mode 100644 index 0000000..2df4489 --- /dev/null +++ b/include/png/PNGChunkTEXT.hpp @@ -0,0 +1,25 @@ +#ifndef PNGCHUNKTEXT_H +#define PNGCHUNKTEXT_H + +#include "include/png/PNGChunk.hpp" + +class PNGChunkTEXT : public PNGChunk{ + + private: + + unsigned char* keyword=0; + unsigned char* text=0; + + public: + + PNGChunkTEXT(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + + const unsigned char* getKeyword(); + + const unsigned char* getText(); + + ~PNGChunkTEXT(); + +}; + +#endif // PNGCHUNKTEXT_H diff --git a/include/png/PNGChunkTIME.hpp b/include/png/PNGChunkTIME.hpp new file mode 100644 index 0000000..59ad897 --- /dev/null +++ b/include/png/PNGChunkTIME.hpp @@ -0,0 +1,40 @@ +#ifndef PNGCHUNKTIME_HPP +#define PNGCHUNKTIME_HPP + +#include "include/png/PNGChunk.hpp" + +class PNGChunkTIME : public PNGChunk{ + + private: + + unsigned short year; + unsigned char month; + unsigned char day; + unsigned char hour; + unsigned char minute; + unsigned char seconds; + unsigned char* timeString=0; + + public: + + PNGChunkTIME(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + + unsigned short getYear(); + + unsigned char getMonth(); + + unsigned char getDay(); + + unsigned char getHour(); + + unsigned char getMinute(); + + unsigned char getSecond(); + + const unsigned char* getTimeString(); + + ~PNGChunkTIME(); + +}; + +#endif // PNGCHUNKTIME_HPP diff --git a/include/png/PNGChunkTRNS.hpp b/include/png/PNGChunkTRNS.hpp new file mode 100644 index 0000000..220bf7d --- /dev/null +++ b/include/png/PNGChunkTRNS.hpp @@ -0,0 +1,13 @@ +#ifndef PNGCHUNKTRNS_H +#define PNGCHUNKTRNS_H +#include "include/png/PNGChunk.hpp" + +class PNGChunkTRNS : public PNGChunk{ + + public: + + PNGChunkTRNS(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + +}; + +#endif // PNGCHUNKTRNS_H diff --git a/include/png/PNGChunkZTXT.hpp b/include/png/PNGChunkZTXT.hpp new file mode 100644 index 0000000..d30b1c6 --- /dev/null +++ b/include/png/PNGChunkZTXT.hpp @@ -0,0 +1,25 @@ +#ifndef PNGCHUNKZTXT_HPP +#define PNGCHUNKZTXT_HPP + +#include "include/png/PNGChunk.hpp" + +class PNGChunkZTXT : public PNGChunk{ + + private: + + unsigned char* keyword=0; + unsigned char* content=0; + + public: + + PNGChunkZTXT(unsigned int chunkLength, unsigned int chunkType, const unsigned char* chunkData, unsigned int crc32); + + const unsigned char* getKeyword(); + + const unsigned char* getText(); + + ~PNGChunkZTXT(); + +}; + +#endif // PNGCHUNKZTXT_HPP diff --git a/include/png/UnfilterAverage.hpp b/include/png/UnfilterAverage.hpp new file mode 100644 index 0000000..181e265 --- /dev/null +++ b/include/png/UnfilterAverage.hpp @@ -0,0 +1,18 @@ +#ifndef UNFILTERAVERAGE_H +#define UNFILTERAVERAGE_H + +class UnfilterAverage{ + + private: + + unsigned int bytesPerPixel=0; + + public: + + UnfilterAverage(unsigned int bitsPerPixel); + + unsigned char* unfilter(unsigned char* upperLine,unsigned char* currentLine,unsigned int dataLength); + +}; + +#endif // UNFILTERAVERAGE_H diff --git a/include/png/UnfilterNone.hpp b/include/png/UnfilterNone.hpp new file mode 100644 index 0000000..4aabdc8 --- /dev/null +++ b/include/png/UnfilterNone.hpp @@ -0,0 +1,12 @@ +#ifndef UNFILTERNONE_H +#define UNFILTERNONE_H + +class UnfilterNone{ + + public: + + unsigned char* unfilter(unsigned char* currentLine, unsigned int dataLength); + +}; + +#endif // UNFILTERNONE_H diff --git a/include/png/UnfilterPaeth.hpp b/include/png/UnfilterPaeth.hpp new file mode 100644 index 0000000..51848be --- /dev/null +++ b/include/png/UnfilterPaeth.hpp @@ -0,0 +1,18 @@ +#ifndef UNFILTERPAETH_H +#define UNFILTERPAETH_H + +class UnfilterPaeth{ + + private: + + unsigned int bytesPerPixel=0; + + public: + + UnfilterPaeth(unsigned int bitsPerPixel); + + unsigned char* unfilter(unsigned char* upperLine, unsigned char* currentLine, unsigned int dataLength); + +}; + +#endif // UNFILTERPAETH_H diff --git a/include/png/UnfilterSub.hpp b/include/png/UnfilterSub.hpp new file mode 100644 index 0000000..ff4c2f5 --- /dev/null +++ b/include/png/UnfilterSub.hpp @@ -0,0 +1,18 @@ +#ifndef UNFILTERSUB_HPP +#define UNFILTERSUB_HPP + +class UnfilterSub{ + + public: + + UnfilterSub(unsigned int bitsPerPixel); + + unsigned char* unfilter(const unsigned char* currentLine, unsigned int dataLength); + + private: + + unsigned int bytesPerPixel; + +}; + +#endif // UNFILTERSUB_HPP diff --git a/include/png/UnfilterUp.hpp b/include/png/UnfilterUp.hpp new file mode 100644 index 0000000..2b724a5 --- /dev/null +++ b/include/png/UnfilterUp.hpp @@ -0,0 +1,12 @@ +#ifndef UNFILTERUP_H +#define UNFILTERUP_H + +class UnfilterUp{ + + public: + + unsigned char* unfilter(unsigned char* upperLine, unsigned char* currentLine, unsigned int dataLength); + +}; + +#endif // UNFILTERUP_H diff --git a/include/raknet/AutopatcherPatchContext.hpp b/include/raknet/AutopatcherPatchContext.hpp new file mode 100644 index 0000000..36f1091 --- /dev/null +++ b/include/raknet/AutopatcherPatchContext.hpp @@ -0,0 +1,28 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __AUTOPATCHER_PATCH_CONTEXT_H +#define __AUTOPATCHER_PATCH_CONTEXT_H + +enum PatchContext +{ + PC_HASH_1_WITH_PATCH, + PC_HASH_2_WITH_PATCH, + PC_WRITE_FILE, + PC_ERROR_FILE_WRITE_FAILURE, + PC_ERROR_PATCH_TARGET_MISSING, + PC_ERROR_PATCH_APPLICATION_FAILURE, + PC_ERROR_PATCH_RESULT_CHECKSUM_FAILURE, + PC_NOTICE_WILL_COPY_ON_RESTART, + PC_NOTICE_FILE_DOWNLOADED, + PC_NOTICE_FILE_DOWNLOADED_PATCH, +}; + +#endif diff --git a/include/raknet/AutopatcherRepositoryInterface.hpp b/include/raknet/AutopatcherRepositoryInterface.hpp new file mode 100644 index 0000000..d2783a4 --- /dev/null +++ b/include/raknet/AutopatcherRepositoryInterface.hpp @@ -0,0 +1,77 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// +/// \file AutopatcherRepositoryInterface.h +/// \brief An interface used by AutopatcherServer to get the data necessary to run an autopatcher. +/// + + +#ifndef __AUTOPATCHER_REPOSITORY_INTERFACE_H +#define __AUTOPATCHER_REPOSITORY_INTERFACE_H + +#include "IncrementalReadInterface.hpp" +#include "SimpleMutex.hpp" + +namespace RakNet +{ +/// Forward declarations +class FileList; +class BitStream; + +/// An interface used by AutopatcherServer to get the data necessary to run an autopatcher. This is up to you to implement for custom repository solutions. +class AutopatcherRepositoryInterface : public IncrementalReadInterface +{ +public: + /// Get list of files added and deleted since a certain date. This is used by AutopatcherServer and not usually explicitly called. + /// \param[in] applicationName A null terminated string identifying the application + /// \param[out] addedFiles A list of the current versions of filenames with hashes as their data that were created after \a sinceData + /// \param[out] deletedFiles A list of the current versions of filenames that were deleted after \a sinceData + /// \param[in] An input date, in whatever format your repository uses + /// \param[out] currentDate The current server date, in whatever format your repository uses + /// \return True on success, false on failure. + virtual bool GetChangelistSinceDate(const char *applicationName, FileList *addedOrModifiedFilesWithHashData, FileList *deletedFiles, double sinceDate)=0; + + /// Get patches (or files) for every file in input, assuming that input has a hash for each of those files. + /// \param[in] applicationName A null terminated string identifying the application + /// \param[in] input A list of files with SHA1_LENGTH byte hashes to get from the database. + /// \param[out] patchList You should return list of files with either the filedata or the patch. This is a subset of \a input. The context data for each file will be either PC_WRITE_FILE (to just write the file) or PC_HASH_WITH_PATCH (to patch). If PC_HASH_WITH_PATCH, then the file contains a SHA1_LENGTH byte patch followed by the hash. The datalength is patchlength + SHA1_LENGTH + /// \param[out] currentDate The current server date, in whatever format your repository uses + /// \return 1 on success, 0 on database failure, -1 on tried to download original unmodified file + virtual int GetPatches(const char *applicationName, FileList *input, bool allowDownloadOfOriginalUnmodifiedFiles, FileList *patchList)=0; + + /// For the most recent update, return files that were patched, added, or deleted. For files that were patched, return both the patch in \a patchedFiles and the current version in \a updatedFiles + /// \param[in,out] applicationName Name of the application to get patches for. If empty, uses the most recently updated application, and the string will be updated to reflect this name. + /// \param[out] patchedFiles A list of patched files with op PC_HASH_2_WITH_PATCH. It has 2 hashes, the priorHash and the currentHash. The currentHash is checked on the client after patching for patch success. The priorHash is checked in AutopatcherServer::OnGetPatch() to see if the client is able to hash with the version they currently have + /// \param[out] patchedFiles A list of new files. It contains the actual data in addition to the filename + /// \param[out] addedOrModifiedFileHashes A list of file hashes that were either modified or new. This is returned to the client when replying to ID_AUTOPATCHER_CREATION_LIST, which tells the client what files have changed on the server since a certain date + /// \param[out] deletedFiles A list of the current versions of filenames that were deleted in the most recent patch + /// \param[out] whenPatched time in seconds since epoch when patched. Use time() function to get this in C + /// \return true on success, false on failure + virtual bool GetMostRecentChangelistWithPatches( + RakNet::RakString &applicationName, + FileList *patchedFiles, + FileList *updatedFiles, + FileList *addedOrModifiedFileHashes, + FileList *deletedFiles, + double *priorRowPatchTime, + double *mostRecentRowPatchTime)=0; + + /// \return Whatever this function returns is sent from the AutopatcherServer to the AutopatcherClient when one of the above functions returns false. + virtual const char *GetLastError(void) const=0; + + /// \return Passed to FileListTransfer::Send() as the _chunkSize parameter. + virtual const int GetIncrementalReadChunkSize(void) const=0; +}; + +} // namespace RakNet + +#endif + diff --git a/include/raknet/Base64Encoder.hpp b/include/raknet/Base64Encoder.hpp new file mode 100644 index 0000000..cdc610f --- /dev/null +++ b/include/raknet/Base64Encoder.hpp @@ -0,0 +1,26 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __BASE_64_ENCODER_H +#define __BASE_64_ENCODER_H + +#include "Export.hpp" + +extern "C" { +/// \brief Returns how many bytes were written. +// outputData should be at least the size of inputData * 2 + 6 +int Base64Encoding(const unsigned char *inputData, int dataLength, char *outputData); +} + +extern "C" { +const char *Base64Map(void); +} + +#endif diff --git a/include/raknet/BitStream.hpp b/include/raknet/BitStream.hpp new file mode 100644 index 0000000..a7863be --- /dev/null +++ b/include/raknet/BitStream.hpp @@ -0,0 +1,2048 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file BitStream.h +/// \brief This class allows you to write and read native types as a string of bits. +/// \details BitStream is used extensively throughout RakNet and is designed to be used by users as well. +/// + + +#if defined(_MSC_VER) && _MSC_VER < 1299 // VC6 doesn't support template specialization +#include "BitStream_NoTemplate.hpp" +#else + +#ifndef __BITSTREAM_H +#define __BITSTREAM_H + +#include "RakMemoryOverride.hpp" +#include "RakNetDefines.hpp" +#include "Export.hpp" +#include "RakNetTypes.hpp" +#include "RakString.hpp" +#include "RakWString.hpp" +#include "RakAssert.hpp" +#include +#include + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +// MSWin uses _copysign, others use copysign... +#ifndef _WIN32 +#define _copysign copysign +#endif + +namespace RakNet +{ + /// This class allows you to write and read native types as a string of bits. BitStream is used extensively throughout RakNet and is designed to be used by users as well. + /// \sa BitStreamSample.txt + class RAK_DLL_EXPORT BitStream + { + + public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(BitStream) + + /// Default Constructor + BitStream(); + + /// \brief Create the bitstream, with some number of bytes to immediately allocate. + /// \details There is no benefit to calling this, unless you know exactly how many bytes you need and it is greater than BITSTREAM_STACK_ALLOCATION_SIZE. + /// In that case all it does is save you one or more realloc calls. + /// \param[in] initialBytesToAllocate the number of bytes to pre-allocate. + BitStream( const unsigned int initialBytesToAllocate ); + + /// \brief Initialize the BitStream, immediately setting the data it contains to a predefined pointer. + /// \details Set \a _copyData to true if you want to make an internal copy of the data you are passing. Set it to false to just save a pointer to the data. + /// You shouldn't call Write functions with \a _copyData as false, as this will write to unallocated memory + /// 99% of the time you will use this function to cast Packet::data to a bitstream for reading, in which case you should write something as follows: + /// \code + /// RakNet::BitStream bs(packet->data, packet->length, false); + /// \endcode + /// \param[in] _data An array of bytes. + /// \param[in] lengthInBytes Size of the \a _data. + /// \param[in] _copyData true or false to make a copy of \a _data or not. + BitStream( unsigned char* _data, const unsigned int lengthInBytes, bool _copyData ); + + // Destructor + ~BitStream(); + + /// Resets the bitstream for reuse. + void Reset( void ); + + /// \brief Bidirectional serialize/deserialize any integral type to/from a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutTemplateVar The value to write + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template + bool Serialize(bool writeToBitstream, templateType &inOutTemplateVar); + + /// \brief Bidirectional serialize/deserialize any integral type to/from a bitstream. + /// \details If the current value is different from the last value + /// the current value will be written. Otherwise, a single bit will be written + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutCurrentValue The current value to write + /// \param[in] lastValue The last value to compare against. Only used if \a writeToBitstream is true. + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template + bool SerializeDelta(bool writeToBitstream, templateType &inOutCurrentValue, const templateType &lastValue); + + /// \brief Bidirectional version of SerializeDelta when you don't know what the last value is, or there is no last value. + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutCurrentValue The current value to write + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template + bool SerializeDelta(bool writeToBitstream, templateType &inOutCurrentValue); + + /// \brief Bidirectional serialize/deserialize any integral type to/from a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutTemplateVar The value to write + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template + bool SerializeCompressed(bool writeToBitstream, templateType &inOutTemplateVar); + + /// \brief Bidirectional serialize/deserialize any integral type to/from a bitstream. + /// \details If the current value is different from the last value + /// the current value will be written. Otherwise, a single bit will be written + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutCurrentValue The current value to write + /// \param[in] lastValue The last value to compare against. Only used if \a writeToBitstream is true. + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template + bool SerializeCompressedDelta(bool writeToBitstream, templateType &inOutCurrentValue, const templateType &lastValue); + + /// \brief Save as SerializeCompressedDelta(templateType ¤tValue, const templateType &lastValue) when we have an unknown second parameter + /// \return true on data read. False on insufficient data in bitstream + template + bool SerializeCompressedDelta(bool writeToBitstream, templateType &inOutTemplateVar); + + /// \brief Bidirectional serialize/deserialize an array or casted stream or raw data. This does NOT do endian swapping. + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutByteArray a byte buffer + /// \param[in] numberOfBytes the size of \a input in bytes + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + bool Serialize(bool writeToBitstream, char* inOutByteArray, const unsigned int numberOfBytes ); + + /// \brief Serialize a float into 2 bytes, spanning the range between \a floatMin and \a floatMax + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutFloat The float to write + /// \param[in] floatMin Predetermined minimum value of f + /// \param[in] floatMax Predetermined maximum value of f + bool SerializeFloat16(bool writeToBitstream, float &inOutFloat, float floatMin, float floatMax); + + /// Serialize one type casted to another (smaller) type, to save bandwidth + /// serializationType should be uint8_t, uint16_t, uint24_t, or uint32_t + /// Example: int num=53; SerializeCasted(true, num); would use 1 byte to write what would otherwise be an integer (4 or 8 bytes) + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] value The value to serialize + template + bool SerializeCasted( bool writeToBitstream, sourceType &value ); + + /// Given the minimum and maximum values for an integer type, figure out the minimum number of bits to represent the range + /// Then serialize only those bits + /// \note A static is used so that the required number of bits for (maximum-minimum) is only calculated once. This does require that \a minimum and \maximum are fixed values for a given line of code for the life of the program + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] value Integer value to write, which should be between \a minimum and \a maximum + /// \param[in] minimum Minimum value of \a value + /// \param[in] maximum Maximum value of \a value + /// \param[in] allowOutsideRange If true, all sends will take an extra bit, however value can deviate from outside \a minimum and \a maximum. If false, will assert if the value deviates + template + bool SerializeBitsFromIntegerRange( bool writeToBitstream, templateType &value, const templateType minimum, const templateType maximum, bool allowOutsideRange=false ); + /// \param[in] requiredBits Primarily for internal use, called from above function() after calculating number of bits needed to represent maximum-minimum + template + bool SerializeBitsFromIntegerRange( bool writeToBitstream, templateType &value, const templateType minimum, const templateType maximum, const int requiredBits, bool allowOutsideRange=false ); + + /// \brief Bidirectional serialize/deserialize a normalized 3D vector, using (at most) 4 bytes + 3 bits instead of 12-24 bytes. + /// \details Will further compress y or z axis aligned vectors. + /// Accurate to 1/32767.5. + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template // templateType for this function must be a float or double + bool SerializeNormVector(bool writeToBitstream, templateType &x, templateType &y, templateType &z ); + + /// \brief Bidirectional serialize/deserialize a vector, using 10 bytes instead of 12. + /// \details Loses accuracy to about 3/10ths and only saves 2 bytes, so only use if accuracy is not important. + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template // templateType for this function must be a float or double + bool SerializeVector(bool writeToBitstream, templateType &x, templateType &y, templateType &z ); + + /// \brief Bidirectional serialize/deserialize a normalized quaternion in 6 bytes + 4 bits instead of 16 bytes. Slightly lossy. + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] w w + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + template // templateType for this function must be a float or double + bool SerializeNormQuat(bool writeToBitstream, templateType &w, templateType &x, templateType &y, templateType &z); + + /// \brief Bidirectional serialize/deserialize an orthogonal matrix by creating a quaternion, and writing 3 components of the quaternion in 2 bytes each. + /// \details Use 6 bytes instead of 36 + /// Lossy, although the result is renormalized + /// \return true on success, false on failure. + template // templateType for this function must be a float or double + bool SerializeOrthMatrix( + bool writeToBitstream, + templateType &m00, templateType &m01, templateType &m02, + templateType &m10, templateType &m11, templateType &m12, + templateType &m20, templateType &m21, templateType &m22 ); + + /// \brief Bidirectional serialize/deserialize numberToSerialize bits to/from the input. + /// \details Right aligned data means in the case of a partial byte, the bits are aligned + /// from the right (bit 0) rather than the left (as in the normal + /// internal representation) You would set this to true when + /// writing user data, and false when copying bitstream data, such + /// as writing one bitstream to another + /// \param[in] writeToBitstream true to write from your data to this bitstream. False to read from this bitstream and write to your data + /// \param[in] inOutByteArray The data + /// \param[in] numberOfBitsToSerialize The number of bits to write + /// \param[in] rightAlignedBits if true data will be right aligned + /// \return true if \a writeToBitstream is true. true if \a writeToBitstream is false and the read was successful. false if \a writeToBitstream is false and the read was not successful. + bool SerializeBits(bool writeToBitstream, unsigned char* inOutByteArray, const BitSize_t numberOfBitsToSerialize, const bool rightAlignedBits = true ); + + /// \brief Write any integral type to a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// \param[in] inTemplateVar The value to write + template + void Write(const templateType &inTemplateVar); + + /// \brief Write the dereferenced pointer to any integral type to a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// \param[in] inTemplateVar The value to write + template + void WritePtr(templateType *inTemplateVar); + + /// \brief Write any integral type to a bitstream. + /// \details If the current value is different from the last value + /// the current value will be written. Otherwise, a single bit will be written + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template + void WriteDelta(const templateType ¤tValue, const templateType &lastValue); + + /// \brief WriteDelta when you don't know what the last value is, or there is no last value. + /// \param[in] currentValue The current value to write + template + void WriteDelta(const templateType ¤tValue); + + /// \brief Write any integral type to a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// \param[in] inTemplateVar The value to write + template + void WriteCompressed(const templateType &inTemplateVar); + + /// \brief Write any integral type to a bitstream. + /// \details If the current value is different from the last value + /// the current value will be written. Otherwise, a single bit will be written + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template + void WriteCompressedDelta(const templateType ¤tValue, const templateType &lastValue); + + /// \brief Save as WriteCompressedDelta(const templateType ¤tValue, const templateType &lastValue) when we have an unknown second parameter + template + void WriteCompressedDelta(const templateType ¤tValue); + + /// \brief Read any integral type from a bitstream. + /// \details Define __BITSTREAM_NATIVE_END if you need endian swapping. + /// \param[in] outTemplateVar The value to read + /// \return true on success, false on failure. + template + bool Read(templateType &outTemplateVar); + + /// \brief Read any integral type from a bitstream. + /// \details If the written value differed from the value compared against in the write function, + /// var will be updated. Otherwise it will retain the current value. + /// ReadDelta is only valid from a previous call to WriteDelta + /// \param[in] outTemplateVar The value to read + /// \return true on success, false on failure. + template + bool ReadDelta(templateType &outTemplateVar); + + /// \brief Read any integral type from a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// \param[in] outTemplateVar The value to read + /// \return true on success, false on failure. + template + bool ReadCompressed(templateType &outTemplateVar); + + /// \brief Read any integral type from a bitstream. + /// \details If the written value differed from the value compared against in the write function, + /// var will be updated. Otherwise it will retain the current value. + /// the current value will be updated. + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// ReadCompressedDelta is only valid from a previous call to WriteDelta + /// \param[in] outTemplateVar The value to read + /// \return true on success, false on failure. + template + bool ReadCompressedDelta(templateType &outTemplateVar); + + /// \brief Read one bitstream to another. + /// \param[in] numberOfBits bits to read + /// \param bitStream the bitstream to read into from + /// \return true on success, false on failure. + bool Read( BitStream *bitStream, BitSize_t numberOfBits ); + bool Read( BitStream *bitStream ); + bool Read( BitStream &bitStream, BitSize_t numberOfBits ); + bool Read( BitStream &bitStream ); + + /// \brief Write an array or casted stream or raw data. This does NOT do endian swapping. + /// \param[in] inputByteArray a byte buffer + /// \param[in] numberOfBytes the size of \a input in bytes + void Write( const char* inputByteArray, const unsigned int numberOfBytes ); + + /// \brief Write one bitstream to another. + /// \param[in] numberOfBits bits to write + /// \param bitStream the bitstream to copy from + void Write( BitStream *bitStream, BitSize_t numberOfBits ); + void Write( BitStream *bitStream ); + void Write( BitStream &bitStream, BitSize_t numberOfBits ); + void Write( BitStream &bitStream );\ + + /// \brief Write a float into 2 bytes, spanning the range between \a floatMin and \a floatMax + /// \param[in] x The float to write + /// \param[in] floatMin Predetermined minimum value of f + /// \param[in] floatMax Predetermined maximum value of f + void WriteFloat16( float x, float floatMin, float floatMax ); + + /// Write one type serialized as another (smaller) type, to save bandwidth + /// serializationType should be uint8_t, uint16_t, uint24_t, or uint32_t + /// Example: int num=53; WriteCasted(num); would use 1 byte to write what would otherwise be an integer (4 or 8 bytes) + /// \param[in] value The value to write + template + void WriteCasted( const sourceType &value ); + + /// Given the minimum and maximum values for an integer type, figure out the minimum number of bits to represent the range + /// Then write only those bits + /// \note A static is used so that the required number of bits for (maximum-minimum) is only calculated once. This does require that \a minimum and \maximum are fixed values for a given line of code for the life of the program + /// \param[in] value Integer value to write, which should be between \a minimum and \a maximum + /// \param[in] minimum Minimum value of \a value + /// \param[in] maximum Maximum value of \a value + /// \param[in] allowOutsideRange If true, all sends will take an extra bit, however value can deviate from outside \a minimum and \a maximum. If false, will assert if the value deviates. This should match the corresponding value passed to Read(). + template + void WriteBitsFromIntegerRange( const templateType value, const templateType minimum, const templateType maximum, bool allowOutsideRange=false ); + /// \param[in] requiredBits Primarily for internal use, called from above function() after calculating number of bits needed to represent maximum-minimum + template + void WriteBitsFromIntegerRange( const templateType value, const templateType minimum, const templateType maximum, const int requiredBits, bool allowOutsideRange=false ); + + /// \brief Write a normalized 3D vector, using (at most) 4 bytes + 3 bits instead of 12-24 bytes. + /// \details Will further compress y or z axis aligned vectors. + /// Accurate to 1/32767.5. + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + template // templateType for this function must be a float or double + void WriteNormVector( templateType x, templateType y, templateType z ); + + /// \brief Write a vector, using 10 bytes instead of 12. + /// \details Loses accuracy to about 3/10ths and only saves 2 bytes, + /// so only use if accuracy is not important. + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + template // templateType for this function must be a float or double + void WriteVector( templateType x, templateType y, templateType z ); + + /// \brief Write a normalized quaternion in 6 bytes + 4 bits instead of 16 bytes. Slightly lossy. + /// \param[in] w w + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + template // templateType for this function must be a float or double + void WriteNormQuat( templateType w, templateType x, templateType y, templateType z); + + /// \brief Write an orthogonal matrix by creating a quaternion, and writing 3 components of the quaternion in 2 bytes each. + /// \details Use 6 bytes instead of 36 + /// Lossy, although the result is renormalized + template // templateType for this function must be a float or double + void WriteOrthMatrix( + templateType m00, templateType m01, templateType m02, + templateType m10, templateType m11, templateType m12, + templateType m20, templateType m21, templateType m22 ); + + /// \brief Read an array or casted stream of byte. + /// \details The array is raw data. There is no automatic endian conversion with this function + /// \param[in] output The result byte array. It should be larger than @em numberOfBytes. + /// \param[in] numberOfBytes The number of byte to read + /// \return true on success false if there is some missing bytes. + bool Read( char* output, const unsigned int numberOfBytes ); + + /// \brief Read a float into 2 bytes, spanning the range between \a floatMin and \a floatMax + /// \param[in] outFloat The float to read + /// \param[in] floatMin Predetermined minimum value of f + /// \param[in] floatMax Predetermined maximum value of f + bool ReadFloat16( float &outFloat, float floatMin, float floatMax ); + + /// Read one type serialized to another (smaller) type, to save bandwidth + /// serializationType should be uint8_t, uint16_t, uint24_t, or uint32_t + /// Example: int num; ReadCasted(num); would read 1 bytefrom the stream, and put the value in an integer + /// \param[in] value The value to write + template + bool ReadCasted( sourceType &value ); + + /// Given the minimum and maximum values for an integer type, figure out the minimum number of bits to represent the range + /// Then read only those bits + /// \note A static is used so that the required number of bits for (maximum-minimum) is only calculated once. This does require that \a minimum and \maximum are fixed values for a given line of code for the life of the program + /// \param[in] value Integer value to read, which should be between \a minimum and \a maximum + /// \param[in] minimum Minimum value of \a value + /// \param[in] maximum Maximum value of \a value + /// \param[in] allowOutsideRange If true, all sends will take an extra bit, however value can deviate from outside \a minimum and \a maximum. If false, will assert if the value deviates. This should match the corresponding value passed to Write(). + template + bool ReadBitsFromIntegerRange( templateType &value, const templateType minimum, const templateType maximum, bool allowOutsideRange=false ); + /// \param[in] requiredBits Primarily for internal use, called from above function() after calculating number of bits needed to represent maximum-minimum + template + bool ReadBitsFromIntegerRange( templateType &value, const templateType minimum, const templateType maximum, const int requiredBits, bool allowOutsideRange=false ); + + /// \brief Read a normalized 3D vector, using (at most) 4 bytes + 3 bits instead of 12-24 bytes. + /// \details Will further compress y or z axis aligned vectors. + /// Accurate to 1/32767.5. + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + /// \return true on success, false on failure. + template // templateType for this function must be a float or double + bool ReadNormVector( templateType &x, templateType &y, templateType &z ); + + /// \brief Read 3 floats or doubles, using 10 bytes, where those float or doubles comprise a vector. + /// \details Loses accuracy to about 3/10ths and only saves 2 bytes, + /// so only use if accuracy is not important. + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + /// \return true on success, false on failure. + template // templateType for this function must be a float or double + bool ReadVector( templateType &x, templateType &y, templateType &z ); + + /// \brief Read a normalized quaternion in 6 bytes + 4 bits instead of 16 bytes. + /// \param[in] w w + /// \param[in] x x + /// \param[in] y y + /// \param[in] z z + /// \return true on success, false on failure. + template // templateType for this function must be a float or double + bool ReadNormQuat( templateType &w, templateType &x, templateType &y, templateType &z); + + /// \brief Read an orthogonal matrix from a quaternion, reading 3 components of the quaternion in 2 bytes each and extrapolatig the 4th. + /// \details Use 6 bytes instead of 36 + /// Lossy, although the result is renormalized + /// \return true on success, false on failure. + template // templateType for this function must be a float or double + bool ReadOrthMatrix( + templateType &m00, templateType &m01, templateType &m02, + templateType &m10, templateType &m11, templateType &m12, + templateType &m20, templateType &m21, templateType &m22 ); + + /// \brief Sets the read pointer back to the beginning of your data. + void ResetReadPointer( void ); + + /// \brief Sets the write pointer back to the beginning of your data. + void ResetWritePointer( void ); + + /// \brief This is good to call when you are done with the stream to make + /// sure you didn't leave any data left over void + void AssertStreamEmpty( void ); + + /// \brief RAKNET_DEBUG_PRINTF the bits in the stream. Great for debugging. + void PrintBits( char *out ) const; + void PrintBits( void ) const; + void PrintHex( char *out ) const; + void PrintHex( void ) const; + + /// \brief Ignore data we don't intend to read + /// \param[in] numberOfBits The number of bits to ignore + void IgnoreBits( const BitSize_t numberOfBits ); + + /// \brief Ignore data we don't intend to read + /// \param[in] numberOfBits The number of bytes to ignore + void IgnoreBytes( const unsigned int numberOfBytes ); + + /// \brief Move the write pointer to a position on the array. + /// \param[in] offset the offset from the start of the array. + /// \attention + /// \details Dangerous if you don't know what you are doing! + /// For efficiency reasons you can only write mid-stream if your data is byte aligned. + void SetWriteOffset( const BitSize_t offset ); + + /// \brief Returns the length in bits of the stream + inline BitSize_t GetNumberOfBitsUsed( void ) const {return GetWriteOffset();} + inline BitSize_t GetWriteOffset( void ) const {return numberOfBitsUsed;} + + /// \brief Returns the length in bytes of the stream + inline BitSize_t GetNumberOfBytesUsed( void ) const {return BITS_TO_BYTES( numberOfBitsUsed );} + + /// \brief Returns the number of bits into the stream that we have read + inline BitSize_t GetReadOffset( void ) const {return readOffset;} + + /// \brief Sets the read bit index + void SetReadOffset( const BitSize_t newReadOffset ) {readOffset=newReadOffset;} + + /// \brief Returns the number of bits left in the stream that haven't been read + inline BitSize_t GetNumberOfUnreadBits( void ) const {return numberOfBitsUsed - readOffset;} + + /// \brief Makes a copy of the internal data for you \a _data will point to + /// the stream. Partial bytes are left aligned. + /// \param[out] _data The allocated copy of GetData() + /// \return The length in bits of the stream. + BitSize_t CopyData( unsigned char** _data ) const; + + /// \internal + /// Set the stream to some initial data. + void SetData( unsigned char *inByteArray ); + + /// Gets the data that BitStream is writing to / reading from. + /// Partial bytes are left aligned. + /// \return A pointer to the internal state + inline unsigned char* GetData( void ) const {return data;} + + /// \brief Write numberToWrite bits from the input source. + /// \details Right aligned data means in the case of a partial byte, the bits are aligned + /// from the right (bit 0) rather than the left (as in the normal + /// internal representation) You would set this to true when + /// writing user data, and false when copying bitstream data, such + /// as writing one bitstream to another. + /// \param[in] inByteArray The data + /// \param[in] numberOfBitsToWrite The number of bits to write + /// \param[in] rightAlignedBits if true data will be right aligned + void WriteBits( const unsigned char* inByteArray, BitSize_t numberOfBitsToWrite, const bool rightAlignedBits = true ); + + /// \brief Align the bitstream to the byte boundary and then write the + /// specified number of bits. + /// \details This is faster than WriteBits but + /// wastes the bits to do the alignment and requires you to call + /// ReadAlignedBits at the corresponding read position. + /// \param[in] inByteArray The data + /// \param[in] numberOfBytesToWrite The size of input. + void WriteAlignedBytes( const unsigned char *inByteArray, const unsigned int numberOfBytesToWrite ); + + // Endian swap bytes already in the bitstream + void EndianSwapBytes( int byteOffset, int length ); + + /// \brief Aligns the bitstream, writes inputLength, and writes input. Won't write beyond maxBytesToWrite + /// \param[in] inByteArray The data + /// \param[in] inputLength The size of input. + /// \param[in] maxBytesToWrite Max bytes to write + void WriteAlignedBytesSafe( const char *inByteArray, const unsigned int inputLength, const unsigned int maxBytesToWrite ); + + /// \brief Read bits, starting at the next aligned bits. + /// \details Note that the modulus 8 starting offset of the sequence must be the same as + /// was used with WriteBits. This will be a problem with packet + /// coalescence unless you byte align the coalesced packets. + /// \param[in] inOutByteArray The byte array larger than @em numberOfBytesToRead + /// \param[in] numberOfBytesToRead The number of byte to read from the internal state + /// \return true if there is enough byte. + bool ReadAlignedBytes( unsigned char *inOutByteArray, const unsigned int numberOfBytesToRead ); + + /// \brief Reads what was written by WriteAlignedBytesSafe. + /// \param[in] inOutByteArray The data + /// \param[in] maxBytesToRead Maximum number of bytes to read + /// \return true on success, false on failure. + bool ReadAlignedBytesSafe( char *inOutByteArray, int &inputLength, const int maxBytesToRead ); + bool ReadAlignedBytesSafe( char *inOutByteArray, unsigned int &inputLength, const unsigned int maxBytesToRead ); + + /// \brief Same as ReadAlignedBytesSafe() but allocates the memory for you using new, rather than assuming it is safe to write to + /// \param[in] outByteArray outByteArray will be deleted if it is not a pointer to 0 + /// \return true on success, false on failure. + bool ReadAlignedBytesSafeAlloc( char **outByteArray, int &inputLength, const unsigned int maxBytesToRead ); + bool ReadAlignedBytesSafeAlloc( char **outByteArray, unsigned int &inputLength, const unsigned int maxBytesToRead ); + + /// \brief Align the next write and/or read to a byte boundary. + /// \details This can be used to 'waste' bits to byte align for efficiency reasons It + /// can also be used to force coalesced bitstreams to start on byte + /// boundaries so so WriteAlignedBits and ReadAlignedBits both + /// calculate the same offset when aligning. + inline void AlignWriteToByteBoundary( void ) {numberOfBitsUsed += 8 - ( (( numberOfBitsUsed - 1 ) & 7) + 1 );} + + /// \brief Align the next write and/or read to a byte boundary. + /// \details This can be used to 'waste' bits to byte align for efficiency reasons It + /// can also be used to force coalesced bitstreams to start on byte + /// boundaries so so WriteAlignedBits and ReadAlignedBits both + /// calculate the same offset when aligning. + inline void AlignReadToByteBoundary( void ) {readOffset += 8 - ( (( readOffset - 1 ) & 7 ) + 1 );} + + /// \brief Read \a numberOfBitsToRead bits to the output source. + /// \details alignBitsToRight should be set to true to convert internal + /// bitstream data to userdata. It should be false if you used + /// WriteBits with rightAlignedBits false + /// \param[in] inOutByteArray The resulting bits array + /// \param[in] numberOfBitsToRead The number of bits to read + /// \param[in] alignBitsToRight if true bits will be right aligned. + /// \return true if there is enough bits to read + bool ReadBits( unsigned char *inOutByteArray, BitSize_t numberOfBitsToRead, const bool alignBitsToRight = true ); + + /// \brief Write a 0 + void Write0( void ); + + /// \brief Write a 1 + void Write1( void ); + + /// \brief Reads 1 bit and returns true if that bit is 1 and false if it is 0. + bool ReadBit( void ); + + /// \brief If we used the constructor version with copy data off, this + /// *makes sure it is set to on and the data pointed to is copied. + void AssertCopyData( void ); + + /// \brief Use this if you pass a pointer copy to the constructor + /// *(_copyData==false) and want to overallocate to prevent + /// reallocation. + void SetNumberOfBitsAllocated( const BitSize_t lengthInBits ); + + /// \brief Reallocates (if necessary) in preparation of writing numberOfBitsToWrite + void AddBitsAndReallocate( const BitSize_t numberOfBitsToWrite ); + + /// \internal + /// \return How many bits have been allocated internally + BitSize_t GetNumberOfBitsAllocated(void) const; + + /// \brief Read strings, non reference. + bool Read(char *varString); + bool Read(unsigned char *varString); + + /// Write zeros until the bitstream is filled up to \a bytes + void PadWithZeroToByteLength( unsigned int bytes ); + + /// Get the number of leading zeros for a number + /// \param[in] x Number to test + static int NumberOfLeadingZeroes( uint8_t x ); + static int NumberOfLeadingZeroes( uint16_t x ); + static int NumberOfLeadingZeroes( uint32_t x ); + static int NumberOfLeadingZeroes( uint64_t x ); + static int NumberOfLeadingZeroes( int8_t x ); + static int NumberOfLeadingZeroes( int16_t x ); + static int NumberOfLeadingZeroes( int32_t x ); + static int NumberOfLeadingZeroes( int64_t x ); + + /// \internal Unrolled inner loop, for when performance is critical + void WriteAlignedVar8(const char *inByteArray); + /// \internal Unrolled inner loop, for when performance is critical + bool ReadAlignedVar8(char *inOutByteArray); + /// \internal Unrolled inner loop, for when performance is critical + void WriteAlignedVar16(const char *inByteArray); + /// \internal Unrolled inner loop, for when performance is critical + bool ReadAlignedVar16(char *inOutByteArray); + /// \internal Unrolled inner loop, for when performance is critical + void WriteAlignedVar32(const char *inByteArray); + /// \internal Unrolled inner loop, for when performance is critical + bool ReadAlignedVar32(char *inOutByteArray); + + inline void Write(const char * const inStringVar) + { + RakString::Serialize(inStringVar, this); + } + inline void Write(const wchar_t * const inStringVar) + { + RakWString::Serialize(inStringVar, this); + } + inline void Write(const unsigned char * const inTemplateVar) + { + Write((const char*)inTemplateVar); + } + inline void Write(char * const inTemplateVar) + { + Write((const char*)inTemplateVar); + } + inline void Write(unsigned char * const inTemplateVar) + { + Write((const char*)inTemplateVar); + } + inline void WriteCompressed(const char * const inStringVar) + { + RakString::SerializeCompressed(inStringVar,this,0,false); + } + inline void WriteCompressed(const wchar_t * const inStringVar) + { + RakWString::Serialize(inStringVar,this); + } + inline void WriteCompressed(const unsigned char * const inTemplateVar) + { + WriteCompressed((const char*) inTemplateVar); + } + inline void WriteCompressed(char * const inTemplateVar) + { + WriteCompressed((const char*) inTemplateVar); + } + inline void WriteCompressed(unsigned char * const inTemplateVar) + { + WriteCompressed((const char*) inTemplateVar); + } + + /// ---- Member function template specialization declarations ---- + // Used for VC7 +#if defined(_MSC_VER) && _MSC_VER == 1300 + /// Write a bool to a bitstream. + /// \param[in] var The value to write + template <> + void Write(const bool &var); + + /// Write a systemAddress to a bitstream + /// \param[in] var The value to write + template <> + void Write(const SystemAddress &var); + + /// Write a uint24_t to a bitstream + /// \param[in] var The value to write + template <> + void Write(const uint24_t &var); + + /// Write a RakNetGUID to a bitsteam + /// \param[in] var The value to write + template <> + void Write(const RakNetGuid &var); + + /// Write a string to a bitstream + /// \param[in] var The value to write + template <> + void Write(const char* const &var); + template <> + void Write(const unsigned char* const &var); + template <> + void Write(char* const &var); + template <> + void Write(unsigned char* const &var); + template <> + void Write(const RakString &var); + template <> + void Write(const RakWString &var); + + /// \brief Write a systemAddress. + /// \details If the current value is different from the last value + /// the current value will be written. Otherwise, a single bit will be written + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template <> + void WriteDelta(const SystemAddress ¤tValue, const SystemAddress &lastValue); + + template <> + void WriteDelta(const uint24_t ¤tValue, const uint24_t &lastValue); + + template <> + void WriteDelta(const RakNetGUID ¤tValue, const RakNetGUID &lastValue); + + /// \brief Write a bool delta. + /// \details Same thing as just calling Write + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template <> + void WriteDelta(const bool ¤tValue, const bool &lastValue); + + template <> + void WriteCompressed(const SystemAddress &var); + + template <> + void WriteCompressed(const uint24_t &var); + + template <> + void WriteCompressed(const RakNetGUID &var); + + template <> + void WriteCompressed(const bool &var); + + /// For values between -1 and 1 + template <> + void WriteCompressed(const float &var); + + /// For values between -1 and 1 + template <> + void WriteCompressed(const double &var); + + /// Compressed string + template <> + void WriteCompressed(const char* var); + template <> + void WriteCompressed(const unsigned char* var); + template <> + void WriteCompressed(char* var); + template <> + void WriteCompressed(unsigned char* var); + template <> + void WriteCompressed(const RakString &var); + template <> + void WriteCompressed(const RakWString &var); + + /// \brief Write a bool delta. + /// \details Same thing as just calling Write + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template <> + void WriteCompressedDelta(const bool ¤tValue, const bool &lastValue); + + /// \brief Save as WriteCompressedDelta(bool currentValue, const templateType &lastValue) + /// when we have an unknown second bool + template <> + void WriteCompressedDelta(const bool ¤tValue); + + /// \brief Read a bool from a bitstream. + /// \param[in] var The value to read + /// \return true on success, false on failure. + template <> + bool Read(bool &var); + + /// \brief Read a systemAddress from a bitstream. + /// \param[in] var The value to read + /// \return true on success, false on failure. + template <> + bool Read(SystemAddress &var); + + template <> + bool Read(uint24_t &var); + + template <> + bool Read(RakNetGUID &var); + + /// \brief Read a String from a bitstream. + /// \param[in] var The value to read + /// \return true on success, false on failure. + template <> + bool Read(char *&var); + template <> + bool Read(wchar_t *&var); + template <> + bool Read(unsigned char *&var); + template <> + bool Read(RakString &var); + template <> + bool Read(RakWString &var); + + /// \brief Read a bool from a bitstream. + /// \param[in] var The value to read + /// \return true on success, false on failure. + template <> + bool ReadDelta(bool &var); + + template <> + bool ReadCompressed(SystemAddress &var); + + template <> + bool ReadCompressed(uint24_t &var); + + template <> + bool ReadCompressed(RakNetGUID &var); + + template <> + bool ReadCompressed(bool &var); + + template <> + bool ReadCompressed(float &var); + + /// For values between -1 and 1 + /// \return true on success, false on failure. + template <> + bool ReadCompressed(double &var); + + template <> + bool ReadCompressed(char* &var); + template <> + bool ReadCompressed(wchar_t* &var); + template <> + bool ReadCompressed(unsigned char *&var); + template <> + bool ReadCompressed(RakString &var); + template <> + bool ReadCompressed(RakWString &var); + + /// \brief Read a bool from a bitstream. + /// \param[in] var The value to read + /// \return true on success, false on failure. + template <> + bool ReadCompressedDelta(bool &var); +#endif + + inline static bool DoEndianSwap(void) { +#ifndef __BITSTREAM_NATIVE_END + return IsNetworkOrder()==false; +#else + return false; +#endif + } + inline static bool IsBigEndian(void) + { + return IsNetworkOrder(); + } + inline static bool IsNetworkOrder(void) {bool r = IsNetworkOrderInternal(); return r;} + // Not inline, won't compile on PC due to winsock include errors + static bool IsNetworkOrderInternal(void); + static void ReverseBytes(unsigned char *inByteArray, unsigned char *inOutByteArray, const unsigned int length); + static void ReverseBytesInPlace(unsigned char *inOutData,const unsigned int length); + + private: + + BitStream( const BitStream &invalid) { + (void) invalid; + RakAssert(0); + } + + BitStream& operator = ( const BitStream& invalid ) { + (void) invalid; + RakAssert(0); + static BitStream i; + return i; + } + + /// \brief Assume the input source points to a native type, compress and write it. + void WriteCompressed( const unsigned char* inByteArray, const unsigned int size, const bool unsignedData ); + + /// \brief Assume the input source points to a compressed native type. Decompress and read it. + bool ReadCompressed( unsigned char* inOutByteArray, const unsigned int size, const bool unsignedData ); + + + BitSize_t numberOfBitsUsed; + + BitSize_t numberOfBitsAllocated; + + BitSize_t readOffset; + + unsigned char *data; + + /// true if the internal buffer is copy of the data passed to the constructor + bool copyData; + + /// BitStreams that use less than BITSTREAM_STACK_ALLOCATION_SIZE use the stack, rather than the heap to store data. It switches over if BITSTREAM_STACK_ALLOCATION_SIZE is exceeded + unsigned char stackData[BITSTREAM_STACK_ALLOCATION_SIZE]; + }; + + template + inline bool BitStream::Serialize(bool writeToBitstream, templateType &inOutTemplateVar) + { + if (writeToBitstream) + Write(inOutTemplateVar); + else + return Read(inOutTemplateVar); + return true; + } + + template + inline bool BitStream::SerializeDelta(bool writeToBitstream, templateType &inOutCurrentValue, const templateType &lastValue) + { + if (writeToBitstream) + WriteDelta(inOutCurrentValue, lastValue); + else + return ReadDelta(inOutCurrentValue); + return true; + } + + template + inline bool BitStream::SerializeDelta(bool writeToBitstream, templateType &inOutCurrentValue) + { + if (writeToBitstream) + WriteDelta(inOutCurrentValue); + else + return ReadDelta(inOutCurrentValue); + return true; + } + + template + inline bool BitStream::SerializeCompressed(bool writeToBitstream, templateType &inOutTemplateVar) + { + if (writeToBitstream) + WriteCompressed(inOutTemplateVar); + else + return ReadCompressed(inOutTemplateVar); + return true; + } + + template + inline bool BitStream::SerializeCompressedDelta(bool writeToBitstream, templateType &inOutCurrentValue, const templateType &lastValue) + { + if (writeToBitstream) + WriteCompressedDelta(inOutCurrentValue,lastValue); + else + return ReadCompressedDelta(inOutCurrentValue); + return true; + } +//Stoppedhere + template + inline bool BitStream::SerializeCompressedDelta(bool writeToBitstream, templateType &inOutCurrentValue) + { + if (writeToBitstream) + WriteCompressedDelta(inOutCurrentValue); + else + return ReadCompressedDelta(inOutCurrentValue); + return true; + } + + inline bool BitStream::Serialize(bool writeToBitstream, char* inOutByteArray, const unsigned int numberOfBytes ) + { + if (writeToBitstream) + Write(inOutByteArray, numberOfBytes); + else + return Read(inOutByteArray, numberOfBytes); + return true; + } + + template + bool BitStream::SerializeCasted( bool writeToBitstream, sourceType &value ) + { + if (writeToBitstream) WriteCasted(value); + else return ReadCasted(value); + return true; + } + + template + bool BitStream::SerializeBitsFromIntegerRange( bool writeToBitstream, templateType &value, const templateType minimum, const templateType maximum, bool allowOutsideRange ) + { + int requiredBits=BYTES_TO_BITS(sizeof(templateType))-NumberOfLeadingZeroes(templateType(maximum-minimum)); + return SerializeBitsFromIntegerRange(writeToBitstream,value,minimum,maximum,requiredBits,allowOutsideRange); + } + template + bool BitStream::SerializeBitsFromIntegerRange( bool writeToBitstream, templateType &value, const templateType minimum, const templateType maximum, const int requiredBits, bool allowOutsideRange ) + { + if (writeToBitstream) WriteBitsFromIntegerRange(value,minimum,maximum,requiredBits,allowOutsideRange); + else return ReadBitsFromIntegerRange(value,minimum,maximum,requiredBits,allowOutsideRange); + return true; + } + + template + inline bool BitStream::SerializeNormVector(bool writeToBitstream, templateType &x, templateType &y, templateType &z ) + { + if (writeToBitstream) + WriteNormVector(x,y,z); + else + return ReadNormVector(x,y,z); + return true; + } + + template + inline bool BitStream::SerializeVector(bool writeToBitstream, templateType &x, templateType &y, templateType &z ) + { + if (writeToBitstream) + WriteVector(x,y,z); + else + return ReadVector(x,y,z); + return true; + } + + template + inline bool BitStream::SerializeNormQuat(bool writeToBitstream, templateType &w, templateType &x, templateType &y, templateType &z) + { + if (writeToBitstream) + WriteNormQuat(w,x,y,z); + else + return ReadNormQuat(w,x,y,z); + return true; + } + + template + inline bool BitStream::SerializeOrthMatrix( + bool writeToBitstream, + templateType &m00, templateType &m01, templateType &m02, + templateType &m10, templateType &m11, templateType &m12, + templateType &m20, templateType &m21, templateType &m22 ) + { + if (writeToBitstream) + WriteOrthMatrix(m00,m01,m02,m10,m11,m12,m20,m21,m22); + else + return ReadOrthMatrix(m00,m01,m02,m10,m11,m12,m20,m21,m22); + return true; + } + + inline bool BitStream::SerializeBits(bool writeToBitstream, unsigned char* inOutByteArray, const BitSize_t numberOfBitsToSerialize, const bool rightAlignedBits ) + { + if (writeToBitstream) + WriteBits(inOutByteArray,numberOfBitsToSerialize,rightAlignedBits); + else + return ReadBits(inOutByteArray,numberOfBitsToSerialize,rightAlignedBits); + return true; + } + + template + inline void BitStream::Write(const templateType &inTemplateVar) + { +#ifdef _MSC_VER +#pragma warning(disable:4127) // conditional expression is constant +#endif + if (sizeof(inTemplateVar)==1) + WriteBits( ( unsigned char* ) & inTemplateVar, sizeof( templateType ) * 8, true ); + else + { +#ifndef __BITSTREAM_NATIVE_END + if (DoEndianSwap()) + { + unsigned char output[sizeof(templateType)]; + ReverseBytes((unsigned char*)&inTemplateVar, output, sizeof(templateType)); + WriteBits( ( unsigned char* ) output, sizeof(templateType) * 8, true ); + } + else +#endif + WriteBits( ( unsigned char* ) & inTemplateVar, sizeof(templateType) * 8, true ); + } + } + + template + inline void BitStream::WritePtr(templateType *inTemplateVar) + { +#ifdef _MSC_VER +#pragma warning(disable:4127) // conditional expression is constant +#endif + if (sizeof(templateType)==1) + WriteBits( ( unsigned char* ) inTemplateVar, sizeof( templateType ) * 8, true ); + else + { +#ifndef __BITSTREAM_NATIVE_END + if (DoEndianSwap()) + { + unsigned char output[sizeof(templateType)]; + ReverseBytes((unsigned char*) inTemplateVar, output, sizeof(templateType)); + WriteBits( ( unsigned char* ) output, sizeof(templateType) * 8, true ); + } + else +#endif + WriteBits( ( unsigned char* ) inTemplateVar, sizeof(templateType) * 8, true ); + } + } + + /// \brief Write a bool to a bitstream. + /// \param[in] inTemplateVar The value to write + template <> + inline void BitStream::Write(const bool &inTemplateVar) + { + if ( inTemplateVar ) + Write1(); + else + Write0(); + } + + + /// \brief Write a systemAddress to a bitstream. + /// \param[in] inTemplateVar The value to write + template <> + inline void BitStream::Write(const SystemAddress &inTemplateVar) + { + Write(inTemplateVar.GetIPVersion()); + if (inTemplateVar.GetIPVersion()==4) + { + // Hide the address so routers don't modify it + SystemAddress var2=inTemplateVar; + uint32_t binaryAddress=~inTemplateVar.address.addr4.sin_addr.s_addr; + // Don't endian swap the address or port + WriteBits((unsigned char*)&binaryAddress, sizeof(binaryAddress)*8, true); + unsigned short p = var2.GetPortNetworkOrder(); + WriteBits((unsigned char*)&p, sizeof(unsigned short)*8, true); + } + else + { +#if RAKNET_SUPPORT_IPV6==1 + // Don't endian swap + WriteBits((const unsigned char*) &inTemplateVar.address.addr6, sizeof(inTemplateVar.address.addr6)*8, true); +#endif + } + } + + template <> + inline void BitStream::Write(const uint24_t &inTemplateVar) + { + AlignWriteToByteBoundary(); + AddBitsAndReallocate(3*8); + + if (IsBigEndian()==false) + { + data[( numberOfBitsUsed >> 3 ) + 0] = ((unsigned char *)&inTemplateVar.val)[0]; + data[( numberOfBitsUsed >> 3 ) + 1] = ((unsigned char *)&inTemplateVar.val)[1]; + data[( numberOfBitsUsed >> 3 ) + 2] = ((unsigned char *)&inTemplateVar.val)[2]; + } + else + { + data[( numberOfBitsUsed >> 3 ) + 0] = ((unsigned char *)&inTemplateVar.val)[3]; + data[( numberOfBitsUsed >> 3 ) + 1] = ((unsigned char *)&inTemplateVar.val)[2]; + data[( numberOfBitsUsed >> 3 ) + 2] = ((unsigned char *)&inTemplateVar.val)[1]; + } + + numberOfBitsUsed+=3*8; + } + + template <> + inline void BitStream::Write(const RakNetGUID &inTemplateVar) + { + Write(inTemplateVar.g); + } + + /// \brief Write a string to a bitstream. + /// \param[in] var The value to write + template <> + inline void BitStream::Write(const RakString &inTemplateVar) + { + inTemplateVar.Serialize(this); + } + template <> + inline void BitStream::Write(const RakWString &inTemplateVar) + { + inTemplateVar.Serialize(this); + } + template <> + inline void BitStream::Write(const char * const &inStringVar) + { + RakString::Serialize(inStringVar, this); + } + template <> + inline void BitStream::Write(const wchar_t * const &inStringVar) + { + RakWString::Serialize(inStringVar, this); + } + template <> + inline void BitStream::Write(const unsigned char * const &inTemplateVar) + { + Write((const char*)inTemplateVar); + } + template <> + inline void BitStream::Write(char * const &inTemplateVar) + { + Write((const char*)inTemplateVar); + } + template <> + inline void BitStream::Write(unsigned char * const &inTemplateVar) + { + Write((const char*)inTemplateVar); + } + + /// \brief Write any integral type to a bitstream. + /// \details If the current value is different from the last value + /// the current value will be written. Otherwise, a single bit will be written + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template + inline void BitStream::WriteDelta(const templateType ¤tValue, const templateType &lastValue) + { + if (currentValue==lastValue) + { + Write(false); + } + else + { + Write(true); + Write(currentValue); + } + } + + /// \brief Write a bool delta. Same thing as just calling Write + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template <> + inline void BitStream::WriteDelta(const bool ¤tValue, const bool &lastValue) + { + (void) lastValue; + + Write(currentValue); + } + + /// \brief WriteDelta when you don't know what the last value is, or there is no last value. + /// \param[in] currentValue The current value to write + template + inline void BitStream::WriteDelta(const templateType ¤tValue) + { + Write(true); + Write(currentValue); + } + + /// \brief Write any integral type to a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// \param[in] inTemplateVar The value to write + template + inline void BitStream::WriteCompressed(const templateType &inTemplateVar) + { +#ifdef _MSC_VER +#pragma warning(disable:4127) // conditional expression is constant +#endif + if (sizeof(inTemplateVar)==1) + WriteCompressed( ( unsigned char* ) & inTemplateVar, sizeof( templateType ) * 8, true ); + else + { +#ifndef __BITSTREAM_NATIVE_END +#ifdef _MSC_VER +#pragma warning(disable:4244) // '=' : conversion from 'unsigned long' to 'unsigned short', possible loss of data +#endif + + if (DoEndianSwap()) + { + unsigned char output[sizeof(templateType)]; + ReverseBytes((unsigned char*)&inTemplateVar, output, sizeof(templateType)); + WriteCompressed( ( unsigned char* ) output, sizeof(templateType) * 8, true ); + } + else +#endif + WriteCompressed( ( unsigned char* ) & inTemplateVar, sizeof(templateType) * 8, true ); + } + } + + template <> + inline void BitStream::WriteCompressed(const SystemAddress &inTemplateVar) + { + Write(inTemplateVar); + } + + template <> + inline void BitStream::WriteCompressed(const RakNetGUID &inTemplateVar) + { + Write(inTemplateVar); + } + + template <> + inline void BitStream::WriteCompressed(const uint24_t &var) + { + Write(var); + } + + template <> + inline void BitStream::WriteCompressed(const bool &inTemplateVar) + { + Write(inTemplateVar); + } + + /// For values between -1 and 1 + template <> + inline void BitStream::WriteCompressed(const float &inTemplateVar) + { + RakAssert(inTemplateVar > -1.01f && inTemplateVar < 1.01f); + float varCopy=inTemplateVar; + if (varCopy < -1.0f) + varCopy=-1.0f; + if (varCopy > 1.0f) + varCopy=1.0f; + Write((unsigned short)((varCopy+1.0f)*32767.5f)); + } + + /// For values between -1 and 1 + template <> + inline void BitStream::WriteCompressed(const double &inTemplateVar) + { + RakAssert(inTemplateVar > -1.01 && inTemplateVar < 1.01); + double varCopy=inTemplateVar; + if (varCopy < -1.0f) + varCopy=-1.0f; + if (varCopy > 1.0f) + varCopy=1.0f; + Write((uint32_t)((varCopy+1.0)*2147483648.0)); + } + + /// Compress the string + template <> + inline void BitStream::WriteCompressed(const RakString &inTemplateVar) + { + inTemplateVar.SerializeCompressed(this,0,false); + } + template <> + inline void BitStream::WriteCompressed(const RakWString &inTemplateVar) + { + inTemplateVar.Serialize(this); + } + template <> + inline void BitStream::WriteCompressed(const char * const &inStringVar) + { + RakString::SerializeCompressed(inStringVar,this,0,false); + } + template <> + inline void BitStream::WriteCompressed(const wchar_t * const &inStringVar) + { + RakWString::Serialize(inStringVar,this); + } + template <> + inline void BitStream::WriteCompressed(const unsigned char * const &inTemplateVar) + { + WriteCompressed((const char*) inTemplateVar); + } + template <> + inline void BitStream::WriteCompressed(char * const &inTemplateVar) + { + WriteCompressed((const char*) inTemplateVar); + } + template <> + inline void BitStream::WriteCompressed(unsigned char * const &inTemplateVar) + { + WriteCompressed((const char*) inTemplateVar); + } + + + /// \brief Write any integral type to a bitstream. + /// \details If the current value is different from the last value + /// the current value will be written. Otherwise, a single bit will be written + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template + inline void BitStream::WriteCompressedDelta(const templateType ¤tValue, const templateType &lastValue) + { + if (currentValue==lastValue) + { + Write(false); + } + else + { + Write(true); + WriteCompressed(currentValue); + } + } + + /// \brief Write a bool delta. Same thing as just calling Write + /// \param[in] currentValue The current value to write + /// \param[in] lastValue The last value to compare against + template <> + inline void BitStream::WriteCompressedDelta(const bool ¤tValue, const bool &lastValue) + { + (void) lastValue; + + Write(currentValue); + } + + /// \brief Save as WriteCompressedDelta(const templateType ¤tValue, const templateType &lastValue) + /// when we have an unknown second parameter + template + inline void BitStream::WriteCompressedDelta(const templateType ¤tValue) + { + Write(true); + WriteCompressed(currentValue); + } + + /// \brief Save as WriteCompressedDelta(bool currentValue, const templateType &lastValue) + /// when we have an unknown second bool + template <> + inline void BitStream::WriteCompressedDelta(const bool ¤tValue) + { + Write(currentValue); + } + + /// \brief Read any integral type from a bitstream. Define __BITSTREAM_NATIVE_END if you need endian swapping. + /// \param[in] outTemplateVar The value to read + template + inline bool BitStream::Read(templateType &outTemplateVar) + { +#ifdef _MSC_VER +#pragma warning(disable:4127) // conditional expression is constant +#endif + if (sizeof(outTemplateVar)==1) + return ReadBits( ( unsigned char* ) &outTemplateVar, sizeof(templateType) * 8, true ); + else + { +#ifndef __BITSTREAM_NATIVE_END +#ifdef _MSC_VER +#pragma warning(disable:4244) // '=' : conversion from 'unsigned long' to 'unsigned short', possible loss of data +#endif + if (DoEndianSwap()) + { + unsigned char output[sizeof(templateType)]; + if (ReadBits( ( unsigned char* ) output, sizeof(templateType) * 8, true )) + { + ReverseBytes(output, (unsigned char*)&outTemplateVar, sizeof(templateType)); + return true; + } + return false; + } + else +#endif + return ReadBits( ( unsigned char* ) & outTemplateVar, sizeof(templateType) * 8, true ); + } + } + + /// \brief Read a bool from a bitstream. + /// \param[in] outTemplateVar The value to read + template <> + inline bool BitStream::Read(bool &outTemplateVar) + { + if ( readOffset + 1 > numberOfBitsUsed ) + return false; + + if ( data[ readOffset >> 3 ] & ( 0x80 >> ( readOffset & 7 ) ) ) // Is it faster to just write it out here? + outTemplateVar = true; + else + outTemplateVar = false; + + // Has to be on a different line for Mac + readOffset++; + + return true; + } + + /// \brief Read a systemAddress from a bitstream. + /// \param[in] outTemplateVar The value to read + template <> + inline bool BitStream::Read(SystemAddress &outTemplateVar) + { + unsigned char ipVersion; + Read(ipVersion); + if (ipVersion==4) + { + outTemplateVar.address.addr4.sin_family=AF_INET; + // Read(var.binaryAddress); + // Don't endian swap the address or port + uint32_t binaryAddress; + ReadBits( ( unsigned char* ) & binaryAddress, sizeof(binaryAddress) * 8, true ); + // Unhide the IP address, done to prevent routers from changing it + outTemplateVar.address.addr4.sin_addr.s_addr=~binaryAddress; + bool b = ReadBits(( unsigned char* ) & outTemplateVar.address.addr4.sin_port, sizeof(outTemplateVar.address.addr4.sin_port) * 8, true); + outTemplateVar.debugPort=ntohs(outTemplateVar.address.addr4.sin_port); + return b; + } + else + { +#if RAKNET_SUPPORT_IPV6==1 + bool b = ReadBits((unsigned char*) &outTemplateVar.address.addr6, sizeof(outTemplateVar.address.addr6)*8, true); + outTemplateVar.debugPort=ntohs(outTemplateVar.address.addr6.sin6_port); + return b; +#else + return false; +#endif + } + } + + template <> + inline bool BitStream::Read(uint24_t &outTemplateVar) + { + AlignReadToByteBoundary(); + if ( readOffset + 3*8 > numberOfBitsUsed ) + return false; + + if (IsBigEndian()==false) + { + ((unsigned char *)&outTemplateVar.val)[0]=data[ (readOffset >> 3) + 0]; + ((unsigned char *)&outTemplateVar.val)[1]=data[ (readOffset >> 3) + 1]; + ((unsigned char *)&outTemplateVar.val)[2]=data[ (readOffset >> 3) + 2]; + ((unsigned char *)&outTemplateVar.val)[3]=0; + } + else + { + + ((unsigned char *)&outTemplateVar.val)[3]=data[ (readOffset >> 3) + 0]; + ((unsigned char *)&outTemplateVar.val)[2]=data[ (readOffset >> 3) + 1]; + ((unsigned char *)&outTemplateVar.val)[1]=data[ (readOffset >> 3) + 2]; + ((unsigned char *)&outTemplateVar.val)[0]=0; + } + + readOffset+=3*8; + return true; + } + + template <> + inline bool BitStream::Read(RakNetGUID &outTemplateVar) + { + return Read(outTemplateVar.g); + } + + + template <> + inline bool BitStream::Read(RakString &outTemplateVar) + { + return outTemplateVar.Deserialize(this); + } + template <> + inline bool BitStream::Read(RakWString &outTemplateVar) + { + return outTemplateVar.Deserialize(this); + } + template <> + inline bool BitStream::Read(char *&varString) + { + return RakString::Deserialize(varString,this); + } + template <> + inline bool BitStream::Read(wchar_t *&varString) + { + return RakWString::Deserialize(varString,this); + } + template <> + inline bool BitStream::Read(unsigned char *&varString) + { + return RakString::Deserialize((char*) varString,this); + } + + /// \brief Read any integral type from a bitstream. + /// \details If the written value differed from the value compared against in the write function, + /// var will be updated. Otherwise it will retain the current value. + /// ReadDelta is only valid from a previous call to WriteDelta + /// \param[in] outTemplateVar The value to read + template + inline bool BitStream::ReadDelta(templateType &outTemplateVar) + { + bool dataWritten; + bool success; + success=Read(dataWritten); + if (dataWritten) + success=Read(outTemplateVar); + return success; + } + + /// \brief Read a bool from a bitstream. + /// \param[in] outTemplateVar The value to read + template <> + inline bool BitStream::ReadDelta(bool &outTemplateVar) + { + return Read(outTemplateVar); + } + + /// \brief Read any integral type from a bitstream. + /// \details Undefine __BITSTREAM_NATIVE_END if you need endian swapping. + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// \param[in] outTemplateVar The value to read + template + inline bool BitStream::ReadCompressed(templateType &outTemplateVar) + { +#ifdef _MSC_VER +#pragma warning(disable:4127) // conditional expression is constant +#endif + if (sizeof(outTemplateVar)==1) + return ReadCompressed( ( unsigned char* ) &outTemplateVar, sizeof(templateType) * 8, true ); + else + { +#ifndef __BITSTREAM_NATIVE_END + if (DoEndianSwap()) + { + unsigned char output[sizeof(templateType)]; + if (ReadCompressed( ( unsigned char* ) output, sizeof(templateType) * 8, true )) + { + ReverseBytes(output, (unsigned char*)&outTemplateVar, sizeof(templateType)); + return true; + } + return false; + } + else +#endif + return ReadCompressed( ( unsigned char* ) & outTemplateVar, sizeof(templateType) * 8, true ); + } + } + + template <> + inline bool BitStream::ReadCompressed(SystemAddress &outTemplateVar) + { + return Read(outTemplateVar); + } + + template <> + inline bool BitStream::ReadCompressed(uint24_t &outTemplateVar) + { + return Read(outTemplateVar); + } + + template <> + inline bool BitStream::ReadCompressed(RakNetGUID &outTemplateVar) + { + return Read(outTemplateVar); + } + + template <> + inline bool BitStream::ReadCompressed(bool &outTemplateVar) + { + return Read(outTemplateVar); + } + + /// For values between -1 and 1 + template <> + inline bool BitStream::ReadCompressed(float &outTemplateVar) + { + unsigned short compressedFloat; + if (Read(compressedFloat)) + { + outTemplateVar = ((float)compressedFloat / 32767.5f - 1.0f); + return true; + } + return false; + } + + /// For values between -1 and 1 + template <> + inline bool BitStream::ReadCompressed(double &outTemplateVar) + { + uint32_t compressedFloat; + if (Read(compressedFloat)) + { + outTemplateVar = ((double)compressedFloat / 2147483648.0 - 1.0); + return true; + } + return false; + } + + /// For strings + template <> + inline bool BitStream::ReadCompressed(RakString &outTemplateVar) + { + return outTemplateVar.DeserializeCompressed(this,false); + } + template <> + inline bool BitStream::ReadCompressed(RakWString &outTemplateVar) + { + return outTemplateVar.Deserialize(this); + } + template <> + inline bool BitStream::ReadCompressed(char *&outTemplateVar) + { + return RakString::DeserializeCompressed(outTemplateVar,this,false); + } + template <> + inline bool BitStream::ReadCompressed(wchar_t *&outTemplateVar) + { + return RakWString::Deserialize(outTemplateVar,this); + } + template <> + inline bool BitStream::ReadCompressed(unsigned char *&outTemplateVar) + { + return RakString::DeserializeCompressed((char*) outTemplateVar,this,false); + } + + /// \brief Read any integral type from a bitstream. + /// \details If the written value differed from the value compared against in the write function, + /// var will be updated. Otherwise it will retain the current value. + /// the current value will be updated. + /// For floating point, this is lossy, using 2 bytes for a float and 4 for a double. The range must be between -1 and +1. + /// For non-floating point, this is lossless, but only has benefit if you use less than half the bits of the type + /// If you are not using __BITSTREAM_NATIVE_END the opposite is true for types larger than 1 byte + /// ReadCompressedDelta is only valid from a previous call to WriteDelta + /// \param[in] outTemplateVar The value to read + template + inline bool BitStream::ReadCompressedDelta(templateType &outTemplateVar) + { + bool dataWritten; + bool success; + success=Read(dataWritten); + if (dataWritten) + success=ReadCompressed(outTemplateVar); + return success; + } + + /// \brief Read a bool from a bitstream. + /// \param[in] outTemplateVar The value to read + template <> + inline bool BitStream::ReadCompressedDelta(bool &outTemplateVar) + { + return Read(outTemplateVar); + } + + template + void BitStream::WriteCasted( const sourceType &value ) + { + destinationType val = (destinationType) value; + Write(val); + } + + template + void BitStream::WriteBitsFromIntegerRange( const templateType value, const templateType minimum,const templateType maximum, bool allowOutsideRange ) + { + int requiredBits=BYTES_TO_BITS(sizeof(templateType))-NumberOfLeadingZeroes(templateType(maximum-minimum)); + WriteBitsFromIntegerRange(value,minimum,maximum,requiredBits,allowOutsideRange); + } + template + void BitStream::WriteBitsFromIntegerRange( const templateType value, const templateType minimum,const templateType maximum, const int requiredBits, bool allowOutsideRange ) + { + RakAssert(maximum>=minimum); + RakAssert(allowOutsideRange==true || (value>=minimum && value<=maximum)); + if (allowOutsideRange) + { + if (valuemaximum) + { + Write(true); + Write(value); + return; + } + Write(false); + } + templateType valueOffMin=value-minimum; + if (IsBigEndian()==true) + { + unsigned char output[sizeof(templateType)]; + ReverseBytes((unsigned char*)&valueOffMin, output, sizeof(templateType)); + WriteBits(output,requiredBits); + } + else + { + WriteBits((unsigned char*) &valueOffMin,requiredBits); + } + } + + template // templateType for this function must be a float or double + void BitStream::WriteNormVector( templateType x, templateType y, templateType z ) + { +#ifdef _DEBUG + RakAssert(x <= 1.01 && y <= 1.01 && z <= 1.01 && x >= -1.01 && y >= -1.01 && z >= -1.01); +#endif + + WriteFloat16((float)x,-1.0f,1.0f); + WriteFloat16((float)y,-1.0f,1.0f); + WriteFloat16((float)z,-1.0f,1.0f); + } + + template // templateType for this function must be a float or double + void BitStream::WriteVector( templateType x, templateType y, templateType z ) + { + templateType magnitude = sqrt(x * x + y * y + z * z); + Write((float)magnitude); + if (magnitude > 0.00001f) + { + WriteCompressed((float)(x/magnitude)); + WriteCompressed((float)(y/magnitude)); + WriteCompressed((float)(z/magnitude)); + // Write((unsigned short)((x/magnitude+1.0f)*32767.5f)); + // Write((unsigned short)((y/magnitude+1.0f)*32767.5f)); + // Write((unsigned short)((z/magnitude+1.0f)*32767.5f)); + } + } + + template // templateType for this function must be a float or double + void BitStream::WriteNormQuat( templateType w, templateType x, templateType y, templateType z) + { + Write((bool)(w<0.0)); + Write((bool)(x<0.0)); + Write((bool)(y<0.0)); + Write((bool)(z<0.0)); + Write((unsigned short)(fabs(x)*65535.0)); + Write((unsigned short)(fabs(y)*65535.0)); + Write((unsigned short)(fabs(z)*65535.0)); + // Leave out w and calculate it on the target + } + + template // templateType for this function must be a float or double + void BitStream::WriteOrthMatrix( + templateType m00, templateType m01, templateType m02, + templateType m10, templateType m11, templateType m12, + templateType m20, templateType m21, templateType m22 ) + { + + double qw; + double qx; + double qy; + double qz; + + // Convert matrix to quat + // http://www.euclideanspace.com/maths/geometry/rotations/conversions/matrixToQuaternion/ + float sum; + sum = 1 + m00 + m11 + m22; + if (sum < 0.0f) sum=0.0f; + qw = sqrt( sum ) / 2; + sum = 1 + m00 - m11 - m22; + if (sum < 0.0f) sum=0.0f; + qx = sqrt( sum ) / 2; + sum = 1 - m00 + m11 - m22; + if (sum < 0.0f) sum=0.0f; + qy = sqrt( sum ) / 2; + sum = 1 - m00 - m11 + m22; + if (sum < 0.0f) sum=0.0f; + qz = sqrt( sum ) / 2; + if (qw < 0.0) qw=0.0; + if (qx < 0.0) qx=0.0; + if (qy < 0.0) qy=0.0; + if (qz < 0.0) qz=0.0; + qx = _copysign( (double) qx, (double) (m21 - m12) ); + qy = _copysign( (double) qy, (double) (m02 - m20) ); + qz = _copysign( (double) qz, (double) (m10 - m01) ); + + WriteNormQuat(qw,qx,qy,qz); + } + + template + bool BitStream::ReadCasted( sourceType &value ) + { + serializationType val; + bool success = Read(val); + value=(sourceType) val; + return success; + } + + template + bool BitStream::ReadBitsFromIntegerRange( templateType &value, const templateType minimum, const templateType maximum, bool allowOutsideRange ) + { + int requiredBits=BYTES_TO_BITS(sizeof(templateType))-NumberOfLeadingZeroes(templateType(maximum-minimum)); + return ReadBitsFromIntegerRange(value,minimum,maximum,requiredBits,allowOutsideRange); + } + template + bool BitStream::ReadBitsFromIntegerRange( templateType &value, const templateType minimum, const templateType maximum, const int requiredBits, bool allowOutsideRange ) + { + RakAssert(maximum>=minimum); + if (allowOutsideRange) + { + bool isOutsideRange; + Read(isOutsideRange); + if (isOutsideRange) + return Read(value); + } + unsigned char output[sizeof(templateType)]; + memset(output,0,sizeof(output)); + bool success = ReadBits(output,requiredBits); + if (success) + { + if (IsBigEndian()==true) + ReverseBytesInPlace(output,sizeof(output)); + memcpy(&value,output,sizeof(output)); + + value+=minimum; + } + + return success; + } + + template // templateType for this function must be a float or double + bool BitStream::ReadNormVector( templateType &x, templateType &y, templateType &z ) + { + float xIn,yIn,zIn; + ReadFloat16(xIn,-1.0f,1.0f); + ReadFloat16(yIn,-1.0f,1.0f); + ReadFloat16(zIn,-1.0f,1.0f); + x=xIn; + y=yIn; + z=zIn; + return true; + } + + template // templateType for this function must be a float or double + bool BitStream::ReadVector( templateType &x, templateType &y, templateType &z ) + { + float magnitude; + //unsigned short sx,sy,sz; + if (!Read(magnitude)) + return false; + if (magnitude>0.00001f) + { + // Read(sx); + // Read(sy); + // if (!Read(sz)) + // return false; + // x=((float)sx / 32767.5f - 1.0f) * magnitude; + // y=((float)sy / 32767.5f - 1.0f) * magnitude; + // z=((float)sz / 32767.5f - 1.0f) * magnitude; + float cx=0.0f,cy=0.0f,cz=0.0f; + ReadCompressed(cx); + ReadCompressed(cy); + if (!ReadCompressed(cz)) + return false; + x=cx; + y=cy; + z=cz; + x*=magnitude; + y*=magnitude; + z*=magnitude; + } + else + { + x=0.0; + y=0.0; + z=0.0; + } + return true; + } + + template // templateType for this function must be a float or double + bool BitStream::ReadNormQuat( templateType &w, templateType &x, templateType &y, templateType &z) + { + bool cwNeg=false, cxNeg=false, cyNeg=false, czNeg=false; + unsigned short cx,cy,cz; + Read(cwNeg); + Read(cxNeg); + Read(cyNeg); + Read(czNeg); + Read(cx); + Read(cy); + if (!Read(cz)) + return false; + + // Calculate w from x,y,z + x=(templateType)(cx/65535.0); + y=(templateType)(cy/65535.0); + z=(templateType)(cz/65535.0); + if (cxNeg) x=-x; + if (cyNeg) y=-y; + if (czNeg) z=-z; + float difference = 1.0f - x*x - y*y - z*z; + if (difference < 0.0f) + difference=0.0f; + w = (templateType)(sqrt(difference)); + if (cwNeg) + w=-w; + + return true; + } + + template // templateType for this function must be a float or double + bool BitStream::ReadOrthMatrix( + templateType &m00, templateType &m01, templateType &m02, + templateType &m10, templateType &m11, templateType &m12, + templateType &m20, templateType &m21, templateType &m22 ) + { + float qw,qx,qy,qz; + if (!ReadNormQuat(qw,qx,qy,qz)) + return false; + + // Quat to orthogonal rotation matrix + // http://www.euclideanspace.com/maths/geometry/rotations/conversions/quaternionToMatrix/index.htm + double sqw = (double)qw*(double)qw; + double sqx = (double)qx*(double)qx; + double sqy = (double)qy*(double)qy; + double sqz = (double)qz*(double)qz; + m00 = (templateType)(sqx - sqy - sqz + sqw); // since sqw + sqx + sqy + sqz =1 + m11 = (templateType)(-sqx + sqy - sqz + sqw); + m22 = (templateType)(-sqx - sqy + sqz + sqw); + + double tmp1 = (double)qx*(double)qy; + double tmp2 = (double)qz*(double)qw; + m10 = (templateType)(2.0 * (tmp1 + tmp2)); + m01 = (templateType)(2.0 * (tmp1 - tmp2)); + + tmp1 = (double)qx*(double)qz; + tmp2 = (double)qy*(double)qw; + m20 =(templateType)(2.0 * (tmp1 - tmp2)); + m02 = (templateType)(2.0 * (tmp1 + tmp2)); + tmp1 = (double)qy*(double)qz; + tmp2 = (double)qx*(double)qw; + m21 = (templateType)(2.0 * (tmp1 + tmp2)); + m12 = (templateType)(2.0 * (tmp1 - tmp2)); + + return true; + } + + template + BitStream& operator<<(BitStream& out, templateType& c) + { + out.Write(c); + return out; + } + template + BitStream& operator>>(BitStream& in, templateType& c) + { + bool success = in.Read(c); + (void)success; + + RakAssert(success); + return in; + } + +} + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif + +#endif // VC6 diff --git a/include/raknet/CCRakNetSlidingWindow.hpp b/include/raknet/CCRakNetSlidingWindow.hpp new file mode 100644 index 0000000..36e5412 --- /dev/null +++ b/include/raknet/CCRakNetSlidingWindow.hpp @@ -0,0 +1,220 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/* +http://www.ssfnet.org/Exchange/tcp/tcpTutorialNotes.html + +cwnd=max bytes allowed on wire at once + +Start: +cwnd=mtu +ssthresh=unlimited + +Slow start: +On ack cwnd*=2 + +congestion avoidance: +On ack during new period +cwnd+=mtu*mtu/cwnd + +on loss or duplicate ack during period: +sshtresh=cwnd/2 +cwnd=MTU +This reenters slow start + +If cwnd < ssthresh, then use slow start +else use congestion avoidance + + +*/ + +#include "RakNetDefines.hpp" + +#if USE_SLIDING_WINDOW_CONGESTION_CONTROL==1 + +#ifndef __CONGESTION_CONTROL_SLIDING_WINDOW_H +#define __CONGESTION_CONTROL_SLIDING_WINDOW_H + +#include "NativeTypes.hpp" +#include "RakNetTime.hpp" +#include "RakNetTypes.hpp" +#include "DS_Queue.hpp" + +/// Sizeof an UDP header in byte +#define UDP_HEADER_SIZE 28 + +#define CC_DEBUG_PRINTF_1(x) +#define CC_DEBUG_PRINTF_2(x,y) +#define CC_DEBUG_PRINTF_3(x,y,z) +#define CC_DEBUG_PRINTF_4(x,y,z,a) +#define CC_DEBUG_PRINTF_5(x,y,z,a,b) +//#define CC_DEBUG_PRINTF_1(x) printf(x) +//#define CC_DEBUG_PRINTF_2(x,y) printf(x,y) +//#define CC_DEBUG_PRINTF_3(x,y,z) printf(x,y,z) +//#define CC_DEBUG_PRINTF_4(x,y,z,a) printf(x,y,z,a) +//#define CC_DEBUG_PRINTF_5(x,y,z,a,b) printf(x,y,z,a,b) + +/// Set to 4 if you are using the iPod Touch TG. See http://www.jenkinssoftware.com/forum/index.php?topic=2717.0 +#define CC_TIME_TYPE_BYTES 8 + +#if CC_TIME_TYPE_BYTES==8 +typedef RakNet::TimeUS CCTimeType; +#else +typedef RakNet::TimeMS CCTimeType; +#endif + +typedef RakNet::uint24_t DatagramSequenceNumberType; +typedef double BytesPerMicrosecond; +typedef double BytesPerSecond; +typedef double MicrosecondsPerByte; + +namespace RakNet +{ + +class CCRakNetSlidingWindow +{ + public: + + CCRakNetSlidingWindow(); + ~CCRakNetSlidingWindow(); + + /// Reset all variables to their initial states, for a new connection + void Init(CCTimeType curTime, uint32_t maxDatagramPayload); + + /// Update over time + void Update(CCTimeType curTime, bool hasDataToSendOrResend); + + int GetRetransmissionBandwidth(CCTimeType curTime, CCTimeType timeSinceLastTick, uint32_t unacknowledgedBytes, bool isContinuousSend); + int GetTransmissionBandwidth(CCTimeType curTime, CCTimeType timeSinceLastTick, uint32_t unacknowledgedBytes, bool isContinuousSend); + + /// Acks do not have to be sent immediately. Instead, they can be buffered up such that groups of acks are sent at a time + /// This reduces overall bandwidth usage + /// How long they can be buffered depends on the retransmit time of the sender + /// Should call once per update tick, and send if needed + bool ShouldSendACKs(CCTimeType curTime, CCTimeType estimatedTimeToNextTick); + + /// Every data packet sent must contain a sequence number + /// Call this function to get it. The sequence number is passed into OnGotPacketPair() + DatagramSequenceNumberType GetAndIncrementNextDatagramSequenceNumber(void); + DatagramSequenceNumberType GetNextDatagramSequenceNumber(void); + + /// Call this when you send packets + /// Every 15th and 16th packets should be sent as a packet pair if possible + /// When packets marked as a packet pair arrive, pass to OnGotPacketPair() + /// When any packets arrive, (additionally) pass to OnGotPacket + /// Packets should contain our system time, so we can pass rtt to OnNonDuplicateAck() + void OnSendBytes(CCTimeType curTime, uint32_t numBytes); + + /// Call this when you get a packet pair + void OnGotPacketPair(DatagramSequenceNumberType datagramSequenceNumber, uint32_t sizeInBytes, CCTimeType curTime); + + /// Call this when you get a packet (including packet pairs) + /// If the DatagramSequenceNumberType is out of order, skippedMessageCount will be non-zero + /// In that case, send a NAK for every sequence number up to that count + bool OnGotPacket(DatagramSequenceNumberType datagramSequenceNumber, bool isContinuousSend, CCTimeType curTime, uint32_t sizeInBytes, uint32_t *skippedMessageCount); + + /// Call when you get a NAK, with the sequence number of the lost message + /// Affects the congestion control + void OnResend(CCTimeType curTime, RakNet::TimeUS nextActionTime); + void OnNAK(CCTimeType curTime, DatagramSequenceNumberType nakSequenceNumber); + + /// Call this when an ACK arrives. + /// hasBAndAS are possibly written with the ack, see OnSendAck() + /// B and AS are used in the calculations in UpdateWindowSizeAndAckOnAckPerSyn + /// B and AS are updated at most once per SYN + void OnAck(CCTimeType curTime, CCTimeType rtt, bool hasBAndAS, BytesPerMicrosecond _B, BytesPerMicrosecond _AS, double totalUserDataBytesAcked, bool isContinuousSend, DatagramSequenceNumberType sequenceNumber ); + void OnDuplicateAck( CCTimeType curTime, DatagramSequenceNumberType sequenceNumber ); + + /// Call when you send an ack, to see if the ack should have the B and AS parameters transmitted + /// Call before calling OnSendAck() + void OnSendAckGetBAndAS(CCTimeType curTime, bool *hasBAndAS, BytesPerMicrosecond *_B, BytesPerMicrosecond *_AS); + + /// Call when we send an ack, to write B and AS if needed + /// B and AS are only written once per SYN, to prevent slow calculations + /// Also updates SND, the period between sends, since data is written out + /// Be sure to call OnSendAckGetBAndAS() before calling OnSendAck(), since whether you write it or not affects \a numBytes + void OnSendAck(CCTimeType curTime, uint32_t numBytes); + + /// Call when we send a NACK + /// Also updates SND, the period between sends, since data is written out + void OnSendNACK(CCTimeType curTime, uint32_t numBytes); + + /// Retransmission time out for the sender + /// If the time difference between when a message was last transmitted, and the current time is greater than RTO then packet is eligible for retransmission, pending congestion control + /// RTO = (RTT + 4 * RTTVar) + SYN + /// If we have been continuously sending for the last RTO, and no ACK or NAK at all, SND*=2; + /// This is per message, which is different from UDT, but RakNet supports packetloss with continuing data where UDT is only RELIABLE_ORDERED + /// Minimum value is 100 milliseconds + CCTimeType GetRTOForRetransmission(unsigned char timesSent) const; + + /// Set the maximum amount of data that can be sent in one datagram + /// Default to MAXIMUM_MTU_SIZE-UDP_HEADER_SIZE + void SetMTU(uint32_t bytes); + + /// Return what was set by SetMTU() + uint32_t GetMTU(void) const; + + /// Query for statistics + BytesPerMicrosecond GetLocalSendRate(void) const {return 0;} + BytesPerMicrosecond GetLocalReceiveRate(CCTimeType currentTime) const; + BytesPerMicrosecond GetRemoveReceiveRate(void) const {return 0;} + //BytesPerMicrosecond GetEstimatedBandwidth(void) const {return B;} + BytesPerMicrosecond GetEstimatedBandwidth(void) const {return GetLinkCapacityBytesPerSecond()*1000000.0;} + double GetLinkCapacityBytesPerSecond(void) const {return 0;} + + /// Query for statistics + double GetRTT(void) const; + + bool GetIsInSlowStart(void) const {return IsInSlowStart();} + uint32_t GetCWNDLimit(void) const {return (uint32_t) 0;} + + + /// Is a > b, accounting for variable overflow? + static bool GreaterThan(DatagramSequenceNumberType a, DatagramSequenceNumberType b); + /// Is a < b, accounting for variable overflow? + static bool LessThan(DatagramSequenceNumberType a, DatagramSequenceNumberType b); +// void SetTimeBetweenSendsLimit(unsigned int bitsPerSecond); + uint64_t GetBytesPerSecondLimitByCongestionControl(void) const; + + protected: + + // Maximum amount of bytes that the user can send, e.g. the size of one full datagram + uint32_t MAXIMUM_MTU_INCLUDING_UDP_HEADER; + + double cwnd; // max bytes on wire + double ssThresh; // Threshhold between slow start and congestion avoidance + + /// When we get an ack, if oldestUnsentAck==0, set it to the current time + /// When we send out acks, set oldestUnsentAck to 0 + CCTimeType oldestUnsentAck; + + CCTimeType GetSenderRTOForACK(void) const; + + /// Every outgoing datagram is assigned a sequence number, which increments by 1 every assignment + DatagramSequenceNumberType nextDatagramSequenceNumber; + DatagramSequenceNumberType nextCongestionControlBlock; + bool backoffThisBlock, speedUpThisBlock; + /// Track which datagram sequence numbers have arrived. + /// If a sequence number is skipped, send a NAK for all skipped messages + DatagramSequenceNumberType expectedNextSequenceNumber; + + bool _isContinuousSend; + + bool IsInSlowStart(void) const; + + double lastRtt, estimatedRTT, deviationRtt; + +}; + +} + +#endif + +#endif diff --git a/include/raknet/CCRakNetUDT.hpp b/include/raknet/CCRakNetUDT.hpp new file mode 100644 index 0000000..48035c7 --- /dev/null +++ b/include/raknet/CCRakNetUDT.hpp @@ -0,0 +1,404 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#include "RakNetDefines.hpp" + +#if USE_SLIDING_WINDOW_CONGESTION_CONTROL!=1 + +#ifndef __CONGESTION_CONTROL_UDT_H +#define __CONGESTION_CONTROL_UDT_H + +#include "NativeTypes.hpp" +#include "RakNetTime.hpp" +#include "RakNetTypes.hpp" +#include "DS_Queue.hpp" + +/// Set to 4 if you are using the iPod Touch TG. See http://www.jenkinssoftware.com/forum/index.php?topic=2717.0 +#define CC_TIME_TYPE_BYTES 8 + +namespace RakNet +{ + +#if CC_TIME_TYPE_BYTES==8 +typedef uint64_t CCTimeType; +#else +typedef uint32_t CCTimeType; +#endif + +typedef uint24_t DatagramSequenceNumberType; +typedef double BytesPerMicrosecond; +typedef double BytesPerSecond; +typedef double MicrosecondsPerByte; + +/// CC_RAKNET_UDT_PACKET_HISTORY_LENGTH should be a power of 2 for the writeIndex variables to wrap properly +#define CC_RAKNET_UDT_PACKET_HISTORY_LENGTH 64 +#define RTT_HISTORY_LENGTH 64 + +/// Sizeof an UDP header in byte +#define UDP_HEADER_SIZE 28 + +#define CC_DEBUG_PRINTF_1(x) +#define CC_DEBUG_PRINTF_2(x,y) +#define CC_DEBUG_PRINTF_3(x,y,z) +#define CC_DEBUG_PRINTF_4(x,y,z,a) +#define CC_DEBUG_PRINTF_5(x,y,z,a,b) +//#define CC_DEBUG_PRINTF_1(x) printf(x) +//#define CC_DEBUG_PRINTF_2(x,y) printf(x,y) +//#define CC_DEBUG_PRINTF_3(x,y,z) printf(x,y,z) +//#define CC_DEBUG_PRINTF_4(x,y,z,a) printf(x,y,z,a) +//#define CC_DEBUG_PRINTF_5(x,y,z,a,b) printf(x,y,z,a,b) + +/// \brief Encapsulates UDT congestion control, as used by RakNet +/// Requirements: +///
    +///
  1. Each datagram is no more than MAXIMUM_MTU_SIZE, after accounting for the UDP header +///
  2. Each datagram containing a user message has a sequence number which is set after calling OnSendBytes(). Set it by calling GetAndIncrementNextDatagramSequenceNumber() +///
  3. System is designed to be used from a single thread. +///
  4. Each packet should have a timeout time based on GetSenderRTOForACK(). If this time elapses, add the packet to the head of the send list for retransmission. +///
+/// +/// Recommended: +///
    +///
  1. Call sendto in its own thread. This takes a significant amount of time in high speed networks. +///
+/// +/// Algorithm: +///
    +///
  1. On a new connection, call Init() +///
  2. On a periodic interval (SYN time is the best) call Update(). Also call ShouldSendACKs(), and send buffered ACKS if it returns true. +///
  3. Call OnSendAck() when sending acks. +///
  4. When you want to send or resend data, call GetNumberOfBytesToSend(). It will return you enough bytes to keep you busy for \a estimatedTimeToNextTick. You can send more than this to fill out a datagram, or to send packet pairs +///
  5. Call OnSendBytes() when sending datagrams. +///
  6. When data arrives, record the sequence number and buffer an ACK for it, to be sent from Update() if ShouldSendACKs() returns true +///
  7. Every 16 packets that you send, send two of them back to back (a packet pair) as long as both packets are the same size. If you don't have two packets the same size, it is fine to defer this until you do. +///
  8. When you get a packet, call OnGotPacket(). If the packet is also either of a packet pair, call OnGotPacketPair() +///
  9. If you get a packet, and the sequence number is not 1 + the last sequence number, send a NAK. On the remote system, call OnNAK() and resend that message. +///
  10. If you get an ACK, remove that message from retransmission. Call OnNonDuplicateAck(). +///
  11. If a message is not ACKed for GetRTOForRetransmission(), resend it. +///
+class CCRakNetUDT +{ + public: + + CCRakNetUDT(); + ~CCRakNetUDT(); + + /// Reset all variables to their initial states, for a new connection + void Init(CCTimeType curTime, uint32_t maxDatagramPayload); + + /// Update over time + void Update(CCTimeType curTime, bool hasDataToSendOrResend); + + int GetRetransmissionBandwidth(CCTimeType curTime, CCTimeType timeSinceLastTick, uint32_t unacknowledgedBytes, bool isContinuousSend); + int GetTransmissionBandwidth(CCTimeType curTime, CCTimeType timeSinceLastTick, uint32_t unacknowledgedBytes, bool isContinuousSend); + + /// Acks do not have to be sent immediately. Instead, they can be buffered up such that groups of acks are sent at a time + /// This reduces overall bandwidth usage + /// How long they can be buffered depends on the retransmit time of the sender + /// Should call once per update tick, and send if needed + bool ShouldSendACKs(CCTimeType curTime, CCTimeType estimatedTimeToNextTick); + + /// Every data packet sent must contain a sequence number + /// Call this function to get it. The sequence number is passed into OnGotPacketPair() + DatagramSequenceNumberType GetAndIncrementNextDatagramSequenceNumber(void); + DatagramSequenceNumberType GetNextDatagramSequenceNumber(void); + + /// Call this when you send packets + /// Every 15th and 16th packets should be sent as a packet pair if possible + /// When packets marked as a packet pair arrive, pass to OnGotPacketPair() + /// When any packets arrive, (additionally) pass to OnGotPacket + /// Packets should contain our system time, so we can pass rtt to OnNonDuplicateAck() + void OnSendBytes(CCTimeType curTime, uint32_t numBytes); + + /// Call this when you get a packet pair + void OnGotPacketPair(DatagramSequenceNumberType datagramSequenceNumber, uint32_t sizeInBytes, CCTimeType curTime); + + /// Call this when you get a packet (including packet pairs) + /// If the DatagramSequenceNumberType is out of order, skippedMessageCount will be non-zero + /// In that case, send a NAK for every sequence number up to that count + bool OnGotPacket(DatagramSequenceNumberType datagramSequenceNumber, bool isContinuousSend, CCTimeType curTime, uint32_t sizeInBytes, uint32_t *skippedMessageCount); + + /// Call when you get a NAK, with the sequence number of the lost message + /// Affects the congestion control + void OnResend(CCTimeType curTime, RakNet::TimeUS nextActionTime); + void OnNAK(CCTimeType curTime, DatagramSequenceNumberType nakSequenceNumber); + + /// Call this when an ACK arrives. + /// hasBAndAS are possibly written with the ack, see OnSendAck() + /// B and AS are used in the calculations in UpdateWindowSizeAndAckOnAckPerSyn + /// B and AS are updated at most once per SYN + void OnAck(CCTimeType curTime, CCTimeType rtt, bool hasBAndAS, BytesPerMicrosecond _B, BytesPerMicrosecond _AS, double totalUserDataBytesAcked, bool isContinuousSend, DatagramSequenceNumberType sequenceNumber ); + void OnDuplicateAck( CCTimeType curTime, DatagramSequenceNumberType sequenceNumber ) {} + + /// Call when you send an ack, to see if the ack should have the B and AS parameters transmitted + /// Call before calling OnSendAck() + void OnSendAckGetBAndAS(CCTimeType curTime, bool *hasBAndAS, BytesPerMicrosecond *_B, BytesPerMicrosecond *_AS); + + /// Call when we send an ack, to write B and AS if needed + /// B and AS are only written once per SYN, to prevent slow calculations + /// Also updates SND, the period between sends, since data is written out + /// Be sure to call OnSendAckGetBAndAS() before calling OnSendAck(), since whether you write it or not affects \a numBytes + void OnSendAck(CCTimeType curTime, uint32_t numBytes); + + /// Call when we send a NACK + /// Also updates SND, the period between sends, since data is written out + void OnSendNACK(CCTimeType curTime, uint32_t numBytes); + + /// Retransmission time out for the sender + /// If the time difference between when a message was last transmitted, and the current time is greater than RTO then packet is eligible for retransmission, pending congestion control + /// RTO = (RTT + 4 * RTTVar) + SYN + /// If we have been continuously sending for the last RTO, and no ACK or NAK at all, SND*=2; + /// This is per message, which is different from UDT, but RakNet supports packetloss with continuing data where UDT is only RELIABLE_ORDERED + /// Minimum value is 100 milliseconds + CCTimeType GetRTOForRetransmission(unsigned char timesSent) const; + + /// Set the maximum amount of data that can be sent in one datagram + /// Default to MAXIMUM_MTU_SIZE-UDP_HEADER_SIZE + void SetMTU(uint32_t bytes); + + /// Return what was set by SetMTU() + uint32_t GetMTU(void) const; + + /// Query for statistics + BytesPerMicrosecond GetLocalSendRate(void) const {return 1.0 / SND;} + BytesPerMicrosecond GetLocalReceiveRate(CCTimeType currentTime) const; + BytesPerMicrosecond GetRemoveReceiveRate(void) const {return AS;} + //BytesPerMicrosecond GetEstimatedBandwidth(void) const {return B;} + BytesPerMicrosecond GetEstimatedBandwidth(void) const {return GetLinkCapacityBytesPerSecond()*1000000.0;} + double GetLinkCapacityBytesPerSecond(void) const {return estimatedLinkCapacityBytesPerSecond;}; + + /// Query for statistics + double GetRTT(void) const; + + bool GetIsInSlowStart(void) const {return isInSlowStart;} + uint32_t GetCWNDLimit(void) const {return (uint32_t) (CWND*MAXIMUM_MTU_INCLUDING_UDP_HEADER);} + + + /// Is a > b, accounting for variable overflow? + static bool GreaterThan(DatagramSequenceNumberType a, DatagramSequenceNumberType b); + /// Is a < b, accounting for variable overflow? + static bool LessThan(DatagramSequenceNumberType a, DatagramSequenceNumberType b); +// void SetTimeBetweenSendsLimit(unsigned int bitsPerSecond); + uint64_t GetBytesPerSecondLimitByCongestionControl(void) const; + + protected: + // --------------------------- PROTECTED VARIABLES --------------------------- + /// time interval between bytes, in microseconds. + /// Only used when slowStart==false + /// Increased over time as we continually get messages + /// Decreased on NAK and timeout + /// Starts at 0 (invalid) + MicrosecondsPerByte SND; + + /// Supportive window mechanism, controlling the maximum number of in-flight packets + /// Used both during and after slow-start, but primarily during slow-start + /// Starts at 2, which is also the low threshhold + /// Max is the socket receive buffer / MTU + /// CWND = AS * (RTT + SYN) + 16 + double CWND; + + /// When we do an update process on the SYN interval, nextSYNUpdate is set to the next time we should update + /// Normally this is nextSYNUpdate+=SYN, in order to update on a consistent schedule + /// However, if this would result in an immediate update yet again, it is set to SYN microseconds past the current time (in case the thread did not update for a long time) + CCTimeType nextSYNUpdate; + + + /// Index into packetPairRecieptHistory where we will next write + /// The history is always full (starting with default values) so no read index is needed + int packetPairRecieptHistoryWriteIndex; + + /// Sent to the sender by the receiver from packetPairRecieptHistory whenever a back to back packet arrives on the receiver + /// Updated by B = B * .875 + incomingB * .125 + //BytesPerMicrosecond B; + + /// Running round trip time (ping*2) + /// Only sender needs to know this + /// Initialized to UNSET + /// Set to rtt on first calculation + /// Updated gradually by RTT = RTT * 0.875 + rtt * 0.125 + double RTT; + + /// Round trip time variance + /// Only sender needs to know this + /// Initialized to UNSET + /// Set to rtt on first calculation + // double RTTVar; + /// Update: Use min/max, RTTVar follows current variance too closely resulting in packetloss + double minRTT, maxRTT; + + /// Used to calculate packet arrival rate (in UDT) but data arrival rate (in RakNet, where not all datagrams are the same size) + /// Filter is used to cull lowest half of values for bytesPerMicrosecond, to discount spikes and inactivity + /// Referred to in the documentation as AS, data arrival rate + /// AS is sent to the sender and calculated every 10th ack + /// Each node represents (curTime-lastPacketArrivalTime)/bytes + /// Used with ReceiverCalculateDataArrivalRate(); + BytesPerMicrosecond packetArrivalHistory[CC_RAKNET_UDT_PACKET_HISTORY_LENGTH]; + BytesPerMicrosecond packetArrivalHistoryContinuousGaps[CC_RAKNET_UDT_PACKET_HISTORY_LENGTH]; + unsigned char packetArrivalHistoryContinuousGapsIndex; + uint64_t continuousBytesReceived; + CCTimeType continuousBytesReceivedStartTime; + unsigned int packetArrivalHistoryWriteCount; + + /// Index into packetArrivalHistory where we will next write + /// The history is always full (starting with default values) so no read index is needed + int packetArrivalHistoryWriteIndex; + + /// Tracks the time the last packet that arrived, so BytesPerMicrosecond can be calculated for packetArrivalHistory when a new packet arrives + CCTimeType lastPacketArrivalTime; + + /// Data arrival rate from the sender to the receiver, as told to us by the receiver + /// Used to calculate initial sending rate when slow start stops + BytesPerMicrosecond AS; + + /// When the receiver last calculated and send B and AS, from packetArrivalHistory and packetPairRecieptHistory + /// Used to prevent it from being calculated and send too frequently, as they are slow operations + CCTimeType lastTransmitOfBAndAS; + + /// New connections start in slow start + /// During slow start, SND is not used, only CWND + /// Slow start ends when we get a NAK, or the maximum size of CWND is reached + /// SND is initialized to the inverse of the receiver's packet arrival rate when slow start ends + bool isInSlowStart; + + /// How many NAKs arrived this congestion period + /// Initialized to 1 when the congestion period starts + uint32_t NAKCount; + + /// How many NAKs do you get on average during a congestion period? + /// Starts at 1 + /// Used to generate a random number, DecRandom, between 1 and AvgNAKNum + uint32_t AvgNAKNum; + + /// How many times we have decremented SND this congestion period. Used to limit the number of decrements to 5 + uint32_t DecCount; + + /// Every DecInterval NAKs per congestion period, we decrease the send rate + uint32_t DecInterval; + + /// Every outgoing datagram is assigned a sequence number, which increments by 1 every assignment + DatagramSequenceNumberType nextDatagramSequenceNumber; + + /// If a packet is marked as a packet pair, lastPacketPairPacketArrivalTime is set to the time it arrives + /// This is used so when the 2nd packet of the pair arrives, we can calculate the time interval between the two + CCTimeType lastPacketPairPacketArrivalTime; + + /// If a packet is marked as a packet pair, lastPacketPairSequenceNumber is checked to see if the last packet we got + /// was the packet immediately before the one that arrived + /// If so, we can use lastPacketPairPacketArrivalTime to get the time between the two packets, and thus estimate the link capacity + /// Initialized to -1, so the first packet of a packet pair won't be treated as the second + DatagramSequenceNumberType lastPacketPairSequenceNumber; + + /// Used to cap UpdateWindowSizeAndAckOnAckPerSyn() to once speed increase per SYN + /// This is to prevent speeding up faster than congestion control can compensate for + CCTimeType lastUpdateWindowSizeAndAck; + + /// Every time SND is halved due to timeout, the RTO is increased + /// This is to prevent massive retransmissions to an unresponsive system + /// Reset on any data arriving + double ExpCount; + + /// Total number of user data bytes sent + /// Used to adjust the window size, on ACK, during slow start + uint64_t totalUserDataBytesSent; + + /// When we get an ack, if oldestUnsentAck==0, set it to the current time + /// When we send out acks, set oldestUnsentAck to 0 + CCTimeType oldestUnsentAck; + + // Maximum amount of bytes that the user can send, e.g. the size of one full datagram + uint32_t MAXIMUM_MTU_INCLUDING_UDP_HEADER; + + // Max window size + double CWND_MAX_THRESHOLD; + + /// Track which datagram sequence numbers have arrived. + /// If a sequence number is skipped, send a NAK for all skipped messages + DatagramSequenceNumberType expectedNextSequenceNumber; + + // How many times have we sent B and AS? Used to force it to send at least CC_RAKNET_UDT_PACKET_HISTORY_LENGTH times + // Otherwise, the default values in the array generate inaccuracy + uint32_t sendBAndASCount; + + /// Most recent values read into the corresponding lists + /// Used during the beginning of a connection, when the median filter is still inaccurate + BytesPerMicrosecond mostRecentPacketArrivalHistory; + + bool hasWrittenToPacketPairReceiptHistory; + +// uint32_t rttHistory[RTT_HISTORY_LENGTH]; +// uint32_t rttHistoryIndex; +// uint32_t rttHistoryWriteCount; +// uint32_t rttSum, rttLow; +// CCTimeType lastSndUpdateTime; + double estimatedLinkCapacityBytesPerSecond; + + // --------------------------- PROTECTED METHODS --------------------------- + /// Update nextSYNUpdate by SYN, or the same amount past the current time if no updates have occurred for a long time + void SetNextSYNUpdate(CCTimeType currentTime); + + /// Returns the rate of data arrival, based on packets arriving on the sender. + BytesPerMicrosecond ReceiverCalculateDataArrivalRate(CCTimeType curTime) const; + /// Returns the median of the data arrival rate + BytesPerMicrosecond ReceiverCalculateDataArrivalRateMedian(void) const; + + /// Calculates the median an array of BytesPerMicrosecond + static BytesPerMicrosecond CalculateListMedianRecursive(const BytesPerMicrosecond inputList[CC_RAKNET_UDT_PACKET_HISTORY_LENGTH], int inputListLength, int lessThanSum, int greaterThanSum); +// static uint32_t CalculateListMedianRecursive(const uint32_t inputList[RTT_HISTORY_LENGTH], int inputListLength, int lessThanSum, int greaterThanSum); + + /// Same as GetRTOForRetransmission, but does not factor in ExpCount + /// This is because the receiver does not know ExpCount for the sender, and even if it did, acks shouldn't be delayed for this reason + CCTimeType GetSenderRTOForACK(void) const; + + /// Stop slow start, and enter normal transfer rate + void EndSlowStart(void); + + /// Does the named conversion + inline double BytesPerMicrosecondToPacketsPerMillisecond(BytesPerMicrosecond in); + + /// Update the round trip time, from ACK or ACK2 + //void UpdateRTT(CCTimeType rtt); + + /// Update the corresponding variables pre-slow start + void UpdateWindowSizeAndAckOnAckPreSlowStart(double totalUserDataBytesAcked); + + /// Update the corresponding variables post-slow start + void UpdateWindowSizeAndAckOnAckPerSyn(CCTimeType curTime, CCTimeType rtt, bool isContinuousSend, DatagramSequenceNumberType sequenceNumber); + + + /// Sets halveSNDOnNoDataTime to the future, and also resets ExpCount, which is used to multiple the RTO on no data arriving at all + void ResetOnDataArrivalHalveSNDOnNoDataTime(CCTimeType curTime); + + // Init array + void InitPacketArrivalHistory(void); + + // Printf + void PrintLowBandwidthWarning(void); + + // Bug: SND can sometimes get super high - have seen 11693 + void CapMinSnd(const char *file, int line); + + void DecreaseTimeBetweenSends(void); + void IncreaseTimeBetweenSends(void); + + int bytesCanSendThisTick; + + CCTimeType lastRttOnIncreaseSendRate; + CCTimeType lastRtt; + + DatagramSequenceNumberType nextCongestionControlBlock; + bool hadPacketlossThisBlock; + DataStructures::Queue pingsLastInterval; +}; + +} + +#endif + +#endif diff --git a/include/raknet/CheckSum.hpp b/include/raknet/CheckSum.hpp new file mode 100644 index 0000000..75f0393 --- /dev/null +++ b/include/raknet/CheckSum.hpp @@ -0,0 +1,63 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// +/// \file CheckSum.cpp +/// \brief [Internal] CheckSum implementation from http://www.flounder.com/checksum.htm +/// + +#ifndef __CHECKSUM_H +#define __CHECKSUM_H + +#include "RakMemoryOverride.hpp" + +/// Generates and validates checksums +class CheckSum +{ + +public: + + /// Default constructor + + CheckSum() + { + Clear(); + } + + void Clear() + { + sum = 0; + r = 55665; + c1 = 52845; + c2 = 22719; + } + + void Add ( unsigned int w ); + + + void Add ( unsigned short w ); + + void Add ( unsigned char* b, unsigned int length ); + + void Add ( unsigned char b ); + + unsigned int Get () + { + return sum; + } + +protected: + unsigned short r; + unsigned short c1; + unsigned short c2; + unsigned int sum; +}; + +#endif diff --git a/include/raknet/CloudClient.hpp b/include/raknet/CloudClient.hpp new file mode 100644 index 0000000..6f065b9 --- /dev/null +++ b/include/raknet/CloudClient.hpp @@ -0,0 +1,171 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file CloudClient.h +/// \brief Queries CloudMemoryServer to download data that other clients have uploaded +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_CloudClient==1 + +#ifndef __CLOUD_CLIENT_H +#define __CLOUD_CLIENT_H + +#include "PluginInterface2.hpp" +#include "CloudCommon.hpp" +#include "RakMemoryOverride.hpp" +#include "DS_Hash.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +class CloudClientCallback; + +/// \defgroup CLOUD_GROUP CloudComputing +/// \brief Contains the CloudClient and CloudServer plugins +/// \details The CloudServer plugins operates on requests from the CloudClient plugin. The servers are in a fully connected mesh topology, which the clients are connected to any server. Clients can interact with each other by posting and subscribing to memory updates, without being directly connected or even knowing about each other. +/// \ingroup PLUGINS_GROUP + +/// \brief Performs Post() and Get() operations on CloudMemoryServer +/// \details A CloudClient is a computer connected to one or more servers in a cloud configuration. Operations by one CloudClient can be received and subscribed to by other instances of CloudClient, without those clients being connected, even on different servers. +/// \ingroup CLOUD_GROUP +class RAK_DLL_EXPORT CloudClient : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(CloudClient) + + CloudClient(); + virtual ~CloudClient(); + + /// \brief Set the default callbacks for OnGetReponse(), OnSubscriptionNotification(), and OnSubscriptionDataDeleted() + /// \details Pointers to CloudAllocator and CloudClientCallback can be stored by the system if desired. If a callback is not provided to OnGetReponse(), OnSubscriptionNotification(), OnSubscriptionDataDeleted(), the callback passed here will be used instead. + /// \param[in] _allocator An instance of CloudAllocator + /// \param[in] _callback An instance of CloudClientCallback + virtual void SetDefaultCallbacks(CloudAllocator *_allocator, CloudClientCallback *_callback); + + /// \brief Uploads data to the cloud + /// \details Data uploaded to the cloud will be stored by the server sent to, identified by \a systemIdentifier. + /// As long as you are connected to this server, the data will persist. Queries for that data by the Get() operation will + /// return the RakNetGUID and SystemAddress of the uploader, as well as the data itself. + /// Furthermore, if any clients are subscribed to the particular CloudKey passed, those clients will get update notices that the data has changed + /// Passing data with the same \a cloudKey more than once will overwrite the prior value. + /// This call will silently fail if CloudServer::SetMaxUploadBytesPerClient() is exceeded + /// \param[in] cloudKey Identifies the data being uploaded + /// \param[in] data A pointer to data to upload. This pointer does not need to persist past the call + /// \param[in] dataLengthBytes The length in bytes of \a data + /// \param[in] systemIdentifier A remote system running CloudServer that we are already connected to. + virtual void Post(CloudKey *cloudKey, const unsigned char *data, uint32_t dataLengthBytes, RakNetGUID systemIdentifier); + + /// \brief Releases one or more data previously uploaded with Post() + /// \details If a remote system has subscribed to one or more of the \a keys uploaded, they will get ID_CLOUD_SUBSCRIPTION_NOTIFICATION notifications containing the last value uploaded before deletions + /// \param[in] cloudKey Identifies the data to release. It is possible to remove uploads from multiple Post() calls at once. + /// \param[in] systemIdentifier A remote system running CloudServer that we are already connected to. + virtual void Release(DataStructures::List &keys, RakNetGUID systemIdentifier); + + /// \brief Gets data from the cloud + /// \details For a given query containing one or more keys, return data that matches those keys. + /// The values will be returned in the ID_CLOUD_GET_RESPONSE packet, which should be passed to OnGetReponse() and will invoke CloudClientCallback::OnGet() + /// CloudQuery::startingRowIndex is used to skip the first n values that would normally be returned.. + /// CloudQuery::maxRowsToReturn is used to limit the number of rows returned. The number of rows returned may also be limited by CloudServer::SetMaxBytesPerDownload(); + /// CloudQuery::subscribeToResults if set to true, will cause ID_CLOUD_SUBSCRIPTION_NOTIFICATION to be returned to us when any of the keys in the query are updated or are deleted. + /// ID_CLOUD_GET_RESPONSE will be returned even if subscribing to the result list. Only later updates will return ID_CLOUD_SUBSCRIPTION_NOTIFICATION. + /// Calling Get() with CloudQuery::subscribeToResults false, when you are already subscribed, does not remove the subscription. Use Unsubscribe() for this. + /// Resubscribing using the same CloudKey but a different or no \a specificSystems overwrites the subscribed systems for those keys. + /// \param[in] cloudQuery One or more keys, and optional parameters to perform with the Get + /// \param[in] systemIdentifier A remote system running CloudServer that we are already connected to. + /// \param[in] specificSystems It is possible to get or subscribe to updates only for specific uploading CloudClient instances. Pass the desired instances here. The overload that does not have the specificSystems parameter is treated as subscribing to all updates from all clients. + virtual bool Get(CloudQuery *cloudQuery, RakNetGUID systemIdentifier); + virtual bool Get(CloudQuery *cloudQuery, DataStructures::List &specificSystems, RakNetGUID systemIdentifier); + virtual bool Get(CloudQuery *cloudQuery, DataStructures::List &specificSystems, RakNetGUID systemIdentifier); + + /// \brief Unsubscribe from updates previously subscribed to using Get() with the CloudQuery::subscribeToResults set to true + /// The \a keys and \a specificSystems parameters are logically treated as AND when checking subscriptions on the server + /// The overload that does not take specificSystems unsubscribes to all passed keys, regardless of system + /// You cannot unsubscribe specific systems when previously subscribed to updates from any system. To do this, first Unsubscribe() from all systems, and call Get() with the \a specificSystems parameter explicilty listing the systems you want to subscribe to. + virtual void Unsubscribe(DataStructures::List &keys, RakNetGUID systemIdentifier); + virtual void Unsubscribe(DataStructures::List &keys, DataStructures::List &specificSystems, RakNetGUID systemIdentifier); + virtual void Unsubscribe(DataStructures::List &keys, DataStructures::List &specificSystems, RakNetGUID systemIdentifier); + + /// \brief Call this when you get ID_CLOUD_GET_RESPONSE + /// If \a callback or \a allocator are 0, the default callbacks passed to SetDefaultCallbacks() are used + /// \param[in] packet Packet structure returned from RakPeerInterface + /// \param[in] _callback Callback to be called from the function containing output parameters. If 0, default is used. + /// \param[in] _allocator Allocator to be used to allocate data. If 0, default is used. + virtual void OnGetReponse(Packet *packet, CloudClientCallback *_callback=0, CloudAllocator *_allocator=0); + + /// \brief Call this when you get ID_CLOUD_GET_RESPONSE + /// Different form of OnGetReponse that returns to a structure that you pass, instead of using a callback + /// You are responsible for deallocation with this form + /// If \a allocator is 0, the default callback passed to SetDefaultCallbacks() are used + /// \param[out] cloudQueryResult A pointer to a structure that will be filled out with data + /// \param[in] packet Packet structure returned from RakPeerInterface + /// \param[in] _allocator Allocator to be used to allocate data. If 0, default is used. + virtual void OnGetReponse(CloudQueryResult *cloudQueryResult, Packet *packet, CloudAllocator *_allocator=0); + + /// \brief Call this when you get ID_CLOUD_SUBSCRIPTION_NOTIFICATION + /// If \a callback or \a allocator are 0, the default callbacks passed to SetDefaultCallbacks() are used + /// \param[in] packet Packet structure returned from RakPeerInterface + /// \param[in] _callback Callback to be called from the function containing output parameters. If 0, default is used. + /// \param[in] _allocator Allocator to be used to allocate data. If 0, default is used. + virtual void OnSubscriptionNotification(Packet *packet, CloudClientCallback *_callback=0, CloudAllocator *_allocator=0); + + /// \brief Call this when you get ID_CLOUD_SUBSCRIPTION_NOTIFICATION + /// Different form of OnSubscriptionNotification that returns to a structure that you pass, instead of using a callback + /// You are responsible for deallocation with this form + /// If \a allocator is 0, the default callback passed to SetDefaultCallbacks() are used + /// \param[out] wasUpdated If true, the row was updated. If false, it was deleted. \a result will contain the last value just before deletion + /// \param[out] row A pointer to a structure that will be filled out with data + /// \param[in] packet Packet structure returned from RakPeerInterface + /// \param[in] _allocator Allocator to be used to allocate data. If 0, default is used. + virtual void OnSubscriptionNotification(bool *wasUpdated, CloudQueryRow *row, Packet *packet, CloudAllocator *_allocator=0); + + /// If you never specified an allocator, and used the non-callback form of OnGetReponse(), deallocate cloudQueryResult with this function + virtual void DeallocateWithDefaultAllocator(CloudQueryResult *cloudQueryResult); + + /// If you never specified an allocator, and used the non-callback form of OnSubscriptionNotification(), deallocate row with this function + virtual void DeallocateWithDefaultAllocator(CloudQueryRow *row); + +protected: + PluginReceiveResult OnReceive(Packet *packet); + + CloudClientCallback *callback; + CloudAllocator *allocator; + + CloudAllocator unsetDefaultAllocator; +}; + +/// \ingroup CLOUD_GROUP +/// Parses ID_CLOUD_GET_RESPONSE and ID_CLOUD_SUBSCRIPTION_NOTIFICATION in a convenient callback form +class RAK_DLL_EXPORT CloudClientCallback +{ +public: + CloudClientCallback() {} + virtual ~CloudClientCallback() {} + + /// \brief Called in response to ID_CLOUD_GET_RESPONSE + /// \param[out] result Contains the original query passed to Get(), and a list of rows returned. + /// \param[out] deallocateRowsAfterReturn CloudQueryResult::rowsReturned will be deallocated after the function returns by default. Set to false to not deallocate these pointers. The pointers are allocated through CloudAllocator. + virtual void OnGet(RakNet::CloudQueryResult *result, bool *deallocateRowsAfterReturn) {(void) result; (void) deallocateRowsAfterReturn;} + + /// \brief Called in response to ID_CLOUD_SUBSCRIPTION_NOTIFICATION + /// \param[out] result Contains the row updated + /// \param[out] wasUpdated If true, the row was updated. If false, it was deleted. \a result will contain the last value just before deletion + /// \param[out] deallocateRowAfterReturn \a result will be deallocated after the function returns by default. Set to false to not deallocate these pointers. The pointers are allocated through CloudAllocator. + virtual void OnSubscriptionNotification(RakNet::CloudQueryRow *result, bool wasUpdated, bool *deallocateRowAfterReturn) {(void) result; (void) wasUpdated; (void) deallocateRowAfterReturn;} +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/CloudCommon.hpp b/include/raknet/CloudCommon.hpp new file mode 100644 index 0000000..0cf8ffc --- /dev/null +++ b/include/raknet/CloudCommon.hpp @@ -0,0 +1,150 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_CloudClient==1 || _RAKNET_SUPPORT_CloudServer==1 + +#ifndef __CLOUD_COMMON_H +#define __CLOUD_COMMON_H + +#include "RakNetTypes.hpp" +#include "RakString.hpp" + +namespace RakNet +{ + +class BitStream; +struct CloudQueryRow; + +/// Allocates CloudQueryRow and the row data. Override to use derived classes or different allocators +/// \ingroup CLOUD_GROUP +class RAK_DLL_EXPORT CloudAllocator +{ +public: + CloudAllocator() {} + virtual ~CloudAllocator() {} + + /// \brief Allocate a row + virtual CloudQueryRow* AllocateCloudQueryRow(void); + /// \brief Free a row + virtual void DeallocateCloudQueryRow(CloudQueryRow *row); + /// \brief Allocate CloudQueryRow::data + virtual unsigned char *AllocateRowData(uint32_t bytesNeededForData); + /// \brief Free CloudQueryRow::data + virtual void DeallocateRowData(void *data); +}; + +/// Serves as a key to identify data uploaded to or queried from the server. +/// \ingroup CLOUD_GROUP +struct RAK_DLL_EXPORT CloudKey +{ + CloudKey() {} + CloudKey(RakNet::RakString _primaryKey, uint32_t _secondaryKey) : primaryKey(_primaryKey), secondaryKey(_secondaryKey) {} + ~CloudKey() {} + + /// Identifies the primary key. This is intended to be a major category, such as the name of the application + /// Must be non-empty + RakNet::RakString primaryKey; + + /// Identifies the secondary key. This is intended to be a subcategory enumeration, such as PLAYER_LIST or RUNNING_SCORES + uint32_t secondaryKey; + + /// \internal + void Serialize(bool writeToBitstream, BitStream *bitStream); +}; + +/// \internal +int CloudKeyComp(const CloudKey &key, const CloudKey &data); + +/// Data members used to query the cloud +/// \ingroup CLOUD_GROUP +struct RAK_DLL_EXPORT CloudQuery +{ + CloudQuery() {startingRowIndex=0; maxRowsToReturn=0; subscribeToResults=false;} + + /// List of keys to query. Must be at least of length 1. + /// This query is run on uploads from all clients, and those that match the combination of primaryKey and secondaryKey are potentially returned + /// If you pass more than one key at a time, the results are concatenated so if you need to differentiate between queries then send two different queries + DataStructures::List keys; + + /// If limiting the number of rows to return, this is the starting offset into the list. Has no effect unless maxRowsToReturn is > 0 + uint32_t startingRowIndex; + + /// Maximum number of rows to return. Actual number may still be less than this. Pass 0 to mean no-limit. + uint32_t maxRowsToReturn; + + /// If true, automatically get updates as the results returned to you change. Unsubscribe with CloudMemoryClient::Unsubscribe() + bool subscribeToResults; + + /// \internal + void Serialize(bool writeToBitstream, BitStream *bitStream); +}; + +/// \ingroup CLOUD_GROUP +struct RAK_DLL_EXPORT CloudQueryRow +{ + /// Key used to identify this data + CloudKey key; + + /// Data uploaded + unsigned char *data; + + /// Length of data uploaded + uint32_t length; + + /// System address of server that is holding this data, and the client is connected to + SystemAddress serverSystemAddress; + + /// System address of client that uploaded this data + SystemAddress clientSystemAddress; + + /// RakNetGUID of server that is holding this data, and the client is connected to + RakNetGUID serverGUID; + + /// RakNetGUID of client that uploaded this data + RakNetGUID clientGUID; + + /// \internal + void Serialize(bool writeToBitstream, BitStream *bitStream, CloudAllocator *allocator); +}; + +/// \ingroup CLOUD_GROUP +struct RAK_DLL_EXPORT CloudQueryResult +{ + /// Query originally passed to Download() + CloudQuery cloudQuery; + + /// Results returned from query. If there were multiple keys in CloudQuery::keys then see resultKeyIndices + DataStructures::List rowsReturned; + + /// If there were multiple keys in CloudQuery::keys, then each key is processed in order and the result concatenated to rowsReturned + /// The starting index of each query is written to resultKeyIndices + /// For example, if CloudQuery::keys had 4 keys, returning 3 rows, 0, rows, 5 rows, and 12 rows then + /// resultKeyIndices would be 0, 3, 3, 8 + DataStructures::List resultKeyIndices; + + /// Whatever was passed to CloudClient::Get() as CloudQuery::subscribeToResults + bool subscribeToResults; + + /// \internal + void Serialize(bool writeToBitstream, BitStream *bitStream, CloudAllocator *allocator); + /// \internal + void SerializeHeader(bool writeToBitstream, BitStream *bitStream); + /// \internal + void SerializeNumRows(bool writeToBitstream, uint32_t &numRows, BitStream *bitStream); + /// \internal + void SerializeCloudQueryRows(bool writeToBitstream, uint32_t &numRows, BitStream *bitStream, CloudAllocator *allocator); +}; + +} // Namespace RakNet + +#endif // __CLOUD_COMMON_H + +#endif // #if _RAKNET_SUPPORT_CloudClient==1 || _RAKNET_SUPPORT_CloudServer==1 diff --git a/include/raknet/CloudServer.hpp b/include/raknet/CloudServer.hpp new file mode 100644 index 0000000..81f7743 --- /dev/null +++ b/include/raknet/CloudServer.hpp @@ -0,0 +1,383 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file CloudServer.h +/// \brief Stores client data, and allows cross-server communication to retrieve this data +/// \details TODO +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_CloudServer==1 + +#ifndef __CLOUD_SERVER_H +#define __CLOUD_SERVER_H + +#include "PluginInterface2.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" +#include "RakString.hpp" +#include "DS_Hash.hpp" +#include "CloudCommon.hpp" +#include "DS_OrderedList.hpp" + +/// If the data is smaller than this value, an allocation is avoid. However, this value exists for every row +#define CLOUD_SERVER_DATA_STACK_SIZE 32 + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \brief Zero or more instances of CloudServerQueryFilter can be attached to CloudServer to restrict client queries +/// All attached instances of CloudServerQueryFilter on each corresponding operation, from all directly connected clients +/// If any attached instance returns false for a given operation, that operation is silently rejected +/// \ingroup CLOUD_GROUP +class RAK_DLL_EXPORT CloudServerQueryFilter +{ +public: + CloudServerQueryFilter() {} + virtual ~CloudServerQueryFilter() {} + + /// Called when a local client wants to post data + /// \return true to allow, false to reject + virtual bool OnPostRequest(RakNetGUID clientGuid, SystemAddress clientAddress, CloudKey key, uint32_t dataLength, const char *data)=0; + + /// Called when a local client wants to release data that it has previously uploaded + /// \return true to allow, false to reject + virtual bool OnReleaseRequest(RakNetGUID clientGuid, SystemAddress clientAddress, DataStructures::List &cloudKeys)=0; + + /// Called when a local client wants to query data + /// If you return false, the client will get no response at all + /// \return true to allow, false to reject + virtual bool OnGetRequest(RakNetGUID clientGuid, SystemAddress clientAddress, CloudQuery &query, DataStructures::List &specificSystems)=0; + + /// Called when a local client wants to stop getting updates for data + /// If you return false, the client will keep getting updates for that data + /// \return true to allow, false to reject + virtual bool OnUnsubscribeRequest(RakNetGUID clientGuid, SystemAddress clientAddress, DataStructures::List &cloudKeys, DataStructures::List &specificSystems)=0; +}; + +/// \brief Stores client data, and allows cross-server communication to retrieve this data +/// \ingroup CLOUD_GROUP +class RAK_DLL_EXPORT CloudServer : public PluginInterface2, CloudAllocator +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(CloudServer) + + CloudServer(); + virtual ~CloudServer(); + + /// \brief Max bytes a client can upload + /// Data in excess of this value is silently ignored + /// defaults to 0 (unlimited) + /// \param[in] bytes Max bytes a client can upload. 0 means unlimited. + void SetMaxUploadBytesPerClient(uint64_t bytes); + + /// \brief Max bytes returned by a download. If the number of bytes would exceed this amount, the returned list is truncated + /// However, if this would result in no rows downloaded, then one row will be returned. + /// \param[in] bytes Max bytes a client can download from a single Get(). 0 means unlimited. + void SetMaxBytesPerDownload(uint64_t bytes); + + /// \brief Add a server, which is assumed to be connected in a fully connected mesh to all other servers and also running the CloudServer plugin + /// The other system must also call AddServer before getting the subscription data, or it will be rejected. + /// Sending a message telling the other system to call AddServer(), followed by calling AddServer() locally, would be sufficient for this to work. + /// \note This sends subscription data to the other system, using RELIABLE_ORDERED on channel 0 + /// \param[in] systemIdentifier Identifier of the remote system + void AddServer(RakNetGUID systemIdentifier); + + /// \brief Removes a server added through AddServer() + /// \param[in] systemIdentifier Identifier of the remote system + void RemoveServer(RakNetGUID systemIdentifier); + + /// Return list of servers added with AddServer() + /// \param[out] remoteServers List of servers added + void GetRemoteServers(DataStructures::List &remoteServersOut); + + /// \brief Frees all memory. Does not remove query filters + void Clear(void); + + /// \brief Report the specified SystemAddress to client queries, rather than what RakPeer reads. + /// This is useful if you already know your public IP + /// This only applies to future updates, so call it before updating to apply to all queries + /// \param[in] forcedAddress The systmeAddress to return in queries. Use UNASSIGNED_SYSTEM_ADDRESS (default) to use what RakPeer returns + void ForceExternalSystemAddress(SystemAddress forcedAddress); + + /// \brief Adds a callback called on each query. If all filters returns true for an operation, the operation is allowed. + /// If the filter was already added, the function silently fails + /// \param[in] filter An externally allocated instance of CloudServerQueryFilter. The instance must remain valid until it is removed with RemoveQueryFilter() or RemoveAllQueryFilters() + void AddQueryFilter(CloudServerQueryFilter* filter); + + /// \brief Removes a callback added with AddQueryFilter() + /// The instance is not deleted, only unreferenced. It is up to the user to delete the instance, if necessary + /// \param[in] filter An externally allocated instance of CloudServerQueryFilter. The instance must remain valid until it is removed with RemoveQueryFilter() or RemoveAllQueryFilters() + void RemoveQueryFilter(CloudServerQueryFilter* filter); + + /// \brief Removes all instances of CloudServerQueryFilter added with AddQueryFilter(). + /// The instances are not deleted, only unreferenced. It is up to the user to delete the instances, if necessary + void RemoveAllQueryFilters(void); + +protected: + virtual void Update(void); + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnRakPeerShutdown(void); + + + virtual void OnPostRequest(Packet *packet); + virtual void OnReleaseRequest(Packet *packet); + virtual void OnGetRequest(Packet *packet); + virtual void OnUnsubscribeRequest(Packet *packet); + virtual void OnServerToServerGetRequest(Packet *packet); + virtual void OnServerToServerGetResponse(Packet *packet); + + uint64_t maxUploadBytesPerClient, maxBytesPerDowload; + + // ---------------------------------------------------------------------------- + // For a given data key, quickly look up one or all systems that have uploaded + // ---------------------------------------------------------------------------- + struct CloudData + { + CloudData() {} + ~CloudData() {if (allocatedData) rakFree_Ex(allocatedData, _FILE_AND_LINE_);} + bool IsUnused(void) const {return isUploaded==false && specificSubscribers.Size()==0;} + void Clear(void) {if (dataPtr==allocatedData) rakFree_Ex(allocatedData, _FILE_AND_LINE_); allocatedData=0; dataPtr=0; dataLengthBytes=0; isUploaded=false;} + + unsigned char stackData[CLOUD_SERVER_DATA_STACK_SIZE]; + unsigned char *allocatedData; // Uses allocatedData instead of stackData if length of data exceeds CLOUD_SERVER_DATA_STACK_SIZE + unsigned char *dataPtr; // Points to either stackData or allocatedData + uint32_t dataLengthBytes; + bool isUploaded; + + /// System address of server that is holding this data, and the client is connected to + SystemAddress serverSystemAddress; + + /// System address of client that uploaded this data + SystemAddress clientSystemAddress; + + /// RakNetGUID of server that is holding this data, and the client is connected to + RakNetGUID serverGUID; + + /// RakNetGUID of client that uploaded this data + RakNetGUID clientGUID; + + /// When the key data changes from this particular system, notify these subscribers + /// This list mutually exclusive with CloudDataList::nonSpecificSubscribers + DataStructures::OrderedList specificSubscribers; + }; + void WriteCloudQueryRowFromResultList(unsigned int i, DataStructures::List &cloudDataResultList, DataStructures::List &cloudKeyResultList, BitStream *bsOut); + void WriteCloudQueryRowFromResultList(DataStructures::List &cloudDataResultList, DataStructures::List &cloudKeyResultList, BitStream *bsOut); + + static int KeyDataPtrComp( const RakNetGUID &key, CloudData* const &data ); + struct CloudDataList + { + bool IsUnused(void) const {return keyData.Size()==0 && nonSpecificSubscribers.Size()==0;} + bool IsNotUploaded(void) const {return uploaderCount==0;} + bool RemoveSubscriber(RakNetGUID g) { + bool objectExists; + unsigned int index; + index = nonSpecificSubscribers.GetIndexFromKey(g, &objectExists); + if (objectExists) + { + subscriberCount--; + nonSpecificSubscribers.RemoveAtIndex(index); + return true; + } + return false; + } + + unsigned int uploaderCount, subscriberCount; + CloudKey key; + + // Data uploaded from or subscribed to for various systems + DataStructures::OrderedList keyData; + + /// When the key data changes from any system, notify these subscribers + /// This list mutually exclusive with CloudData::specificSubscribers + DataStructures::OrderedList nonSpecificSubscribers; + }; + + static int KeyDataListComp( const CloudKey &key, CloudDataList * const &data ); + DataStructures::OrderedList dataRepository; + + struct KeySubscriberID + { + CloudKey key; + DataStructures::OrderedList specificSystemsSubscribedTo; + }; + static int KeySubscriberIDComp(const CloudKey &key, KeySubscriberID * const &data ); + + // Remote systems + struct RemoteCloudClient + { + bool IsUnused(void) const {return uploadedKeys.Size()==0 && subscribedKeys.Size()==0;} + + DataStructures::OrderedList uploadedKeys; + DataStructures::OrderedList subscribedKeys; + uint64_t uploadedBytes; + }; + DataStructures::Hash remoteSystems; + + // For a given user, release all subscribed and uploaded keys + void ReleaseSystem(RakNetGUID clientAddress ); + + // For a given user, release a set of keys + void ReleaseKeys(RakNetGUID clientAddress, DataStructures::List &keys ); + + void NotifyClientSubscribersOfDataChange( CloudData *cloudData, CloudKey &key, DataStructures::OrderedList &subscribers, bool wasUpdated ); + void NotifyClientSubscribersOfDataChange( CloudQueryRow *row, DataStructures::OrderedList &subscribers, bool wasUpdated ); + void NotifyServerSubscribersOfDataChange( CloudData *cloudData, CloudKey &key, bool wasUpdated ); + + struct RemoteServer + { + RakNetGUID serverAddress; + // This server needs to know about these keys when they are updated or deleted + DataStructures::OrderedList subscribedKeys; + // This server has uploaded these keys, and needs to know about Get() requests + DataStructures::OrderedList uploadedKeys; + + // Just for processing + bool workingFlag; + + // If false, we don't know what keys they have yet, so send everything + bool gotSubscribedAndUploadedKeys; + }; + + static int RemoteServerComp(const RakNetGUID &key, RemoteServer* const &data ); + DataStructures::OrderedList remoteServers; + + struct BufferedGetResponseFromServer + { + void Clear(CloudAllocator *allocator); + + RakNetGUID serverAddress; + CloudQueryResult queryResult; + bool gotResult; + }; + + struct CloudQueryWithAddresses + { + // Inputs + CloudQuery cloudQuery; + DataStructures::List specificSystems; + + void Serialize(bool writeToBitstream, BitStream *bitStream); + }; + + static int BufferedGetResponseFromServerComp(const RakNetGUID &key, BufferedGetResponseFromServer* const &data ); + struct GetRequest + { + void Clear(CloudAllocator *allocator); + bool AllRemoteServersHaveResponded(void) const; + CloudQueryWithAddresses cloudQueryWithAddresses; + + // When request started. If takes too long for a response from another system, can abort remaining systems + RakNet::Time requestStartTime; + + // Assigned by server that gets the request to identify response. See nextGetRequestId + uint32_t requestId; + + RakNetGUID requestingClient; + + DataStructures::OrderedList remoteServerResponses; + }; + static int GetRequestComp(const uint32_t &key, GetRequest* const &data ); + DataStructures::OrderedList getRequests; + RakNet::Time nextGetRequestsCheck; + + uint32_t nextGetRequestId; + + void ProcessAndTransmitGetRequest(GetRequest *getRequest); + + void ProcessCloudQueryWithAddresses( + CloudServer::CloudQueryWithAddresses &cloudQueryWithAddresses, + DataStructures::List &cloudDataResultList, + DataStructures::List &cloudKeyResultList + ); + + void SendUploadedAndSubscribedKeysToServer( RakNetGUID systemAddress ); + void SendUploadedKeyToServers( CloudKey &cloudKey ); + void SendSubscribedKeyToServers( CloudKey &cloudKey ); + void RemoveUploadedKeyFromServers( CloudKey &cloudKey ); + void RemoveSubscribedKeyFromServers( CloudKey &cloudKey ); + + void OnSendUploadedAndSubscribedKeysToServer( Packet *packet ); + void OnSendUploadedKeyToServers( Packet *packet ); + void OnSendSubscribedKeyToServers( Packet *packet ); + void OnRemoveUploadedKeyFromServers( Packet *packet ); + void OnRemoveSubscribedKeyFromServers( Packet *packet ); + void OnServerDataChanged( Packet *packet ); + + void GetServersWithUploadedKeys( + DataStructures::List &keys, + DataStructures::List &remoteServersWithData + ); + + CloudServer::CloudDataList *GetOrAllocateCloudDataList(CloudKey key, bool *dataRepositoryExists, unsigned int &dataRepositoryIndex); + + void UnsubscribeFromKey(RemoteCloudClient *remoteCloudClient, RakNetGUID remoteCloudClientGuid, unsigned int keySubscriberIndex, CloudKey &cloudKey, DataStructures::List &specificSystems); + void RemoveSpecificSubscriber(RakNetGUID specificSubscriber, CloudDataList *cloudDataList, RakNetGUID remoteCloudClientGuid); + + DataStructures::List queryFilters; + + SystemAddress forceAddress; +}; + + +} // namespace RakNet + +#endif + + +// Key subscription +// +// A given system can subscribe to one or more keys. +// The subscription can be further be defined as only subscribing to keys uploaded by or changed by a given system. +// It is possible to subscribe to keys not yet uploaded, or uploaded to another system +// +// Operations: +// +// 1. SubscribeToKey() - Get() operation with subscription +// A. Add to key subscription list for the client, which contains a keyId / specificUploaderList pair +// B. Send to remote servers that for this key, they should send us updates +// C. (Done, get operation returns current values) +// +// 2. UpdateData() - Post() operation +// A. Find all subscribers to this data, for the uploading system. +// B. Send them the uploaded data +// C. Find all servers that subscribe to this data +// D. Send them the uploaded data +// +// 3. DeleteData() - Release() operation +// A. Find all subscribers to this data, for the deleting system. +// B. Inform them of the deletion +// C. Find all servers that subscribe to this data +// D. Inform them of the deletion +// +// 4. Unsubscribe() +// A. Find this subscriber, and remove their subscription +// B. If no one else is subscribing to this key for any system, notify remote servers we no longer need subscription updates +// +// Internal operations: +// +// 1. Find if any connected client has subscribed to a given key +// A. This is used add and remove our subscription for this key to remote servers +// +// 2. For a given key and updating address, find all connected clients that care +// A. First find connected clients that have subscribed to this key, regardless of address +// B. Then find connected clients that have subscribed to this key for this particular address +// +// 3. Find all remote servers that have subscribed to a given key +// A. This is so when the key is updated or deleted, we know who to send it to +// +// 4. For a given client (such as on disconnect), remove all records of their subscriptions + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/CommandParserInterface.hpp b/include/raknet/CommandParserInterface.hpp new file mode 100644 index 0000000..c601e71 --- /dev/null +++ b/include/raknet/CommandParserInterface.hpp @@ -0,0 +1,147 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file CommandParserInterface.h +/// \brief Contains CommandParserInterface , from which you derive custom command parsers +/// + + +#ifndef __COMMAND_PARSER_INTERFACE +#define __COMMAND_PARSER_INTERFACE + +#include "RakMemoryOverride.hpp" +#include "RakNetTypes.hpp" +#include "DS_OrderedList.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class TransportInterface; + +/// \internal +/// Contains the information related to one command registered with RegisterCommand() +/// Implemented so I can have an automatic help system via SendCommandList() +struct RAK_DLL_EXPORT RegisteredCommand +{ + const char *command; + const char *commandHelp; + unsigned char parameterCount; +}; + +/// List of commands registered with RegisterCommand() +int RAK_DLL_EXPORT RegisteredCommandComp( const char* const & key, const RegisteredCommand &data ); + +/// \brief The interface used by command parsers. +/// \details CommandParserInterface provides a set of functions and interfaces that plug into the ConsoleServer class. +/// Each CommandParserInterface works at the same time as other interfaces in the system. +class RAK_DLL_EXPORT CommandParserInterface +{ +public: + CommandParserInterface(); + virtual ~CommandParserInterface(); + + /// You are responsible for overriding this function and returning a static string, which will identifier your parser. + /// This should return a static string + /// \return The name that you return. + virtual const char *GetName(void) const=0; + + /// \brief A callback for when \a systemAddress has connected to us. + /// \param[in] systemAddress The player that has connected. + /// \param[in] transport The transport interface that sent us this information. Can be used to send messages to this or other players. + virtual void OnNewIncomingConnection(const SystemAddress &systemAddress, TransportInterface *transport); + + /// \brief A callback for when \a systemAddress has disconnected, either gracefully or forcefully + /// \param[in] systemAddress The player that has disconnected. + /// \param[in] transport The transport interface that sent us this information. + virtual void OnConnectionLost(const SystemAddress &systemAddress, TransportInterface *transport); + + /// \brief A callback for when you are expected to send a brief description of your parser to \a systemAddress + /// \param[in] transport The transport interface we can use to write to + /// \param[in] systemAddress The player that requested help. + virtual void SendHelp(TransportInterface *transport, const SystemAddress &systemAddress)=0; + + /// \brief Given \a command with parameters \a parameterList , do whatever processing you wish. + /// \param[in] command The command to process + /// \param[in] numParameters How many parameters were passed along with the command + /// \param[in] parameterList The list of parameters. parameterList[0] is the first parameter and so on. + /// \param[in] transport The transport interface we can use to write to + /// \param[in] systemAddress The player that sent this command. + /// \param[in] originalString The string that was actually sent over the network, in case you want to do your own parsing + virtual bool OnCommand(const char *command, unsigned numParameters, char **parameterList, TransportInterface *transport, const SystemAddress &systemAddress, const char *originalString)=0; + + /// \brief This is called every time transport interface is registered. + /// \details If you want to save a copy of the TransportInterface pointer + /// This is the place to do it + /// \param[in] transport The new TransportInterface + virtual void OnTransportChange(TransportInterface *transport); + + /// \internal + /// Scan commandList and return the associated array + /// \param[in] command The string to find + /// \param[out] rc Contains the result of this operation + /// \return True if we found the command, false otherwise + virtual bool GetRegisteredCommand(const char *command, RegisteredCommand *rc); + + /// \internal + /// Goes through str, replacing the delineating character with 0's. + /// \param[in] str The string sent by the transport interface + /// \param[in] delineator The character to scan for to use as a delineator + /// \param[in] delineatorToggle When encountered the delineator replacement is toggled on and off + /// \param[out] numParameters How many pointers were written to \a parameterList + /// \param[out] parameterList An array of pointers to characters. Will hold pointers to locations inside \a str + /// \param[in] parameterListLength How big the \a parameterList array is + static void ParseConsoleString(char *str, const char delineator, unsigned char delineatorToggle, unsigned *numParameters, char **parameterList, unsigned parameterListLength); + + /// \internal + /// Goes through the variable commandList and sends the command portion of each struct + /// \param[in] transport The transport interface we can use to write to + /// \param[in] systemAddress The player to write to + virtual void SendCommandList(TransportInterface *transport, const SystemAddress &systemAddress); + + static const unsigned char VARIABLE_NUMBER_OF_PARAMETERS; + + // Currently only takes static strings - doesn't make a copy of what you pass. + // parameterCount is the number of parameters that the sender has to include with the command. + // Pass 255 to parameterCount to indicate variable number of parameters + + /// Registers a command. + /// \param[in] parameterCount How many parameters your command requires. If you want to accept a variable number of commands, pass CommandParserInterface::VARIABLE_NUMBER_OF_PARAMETERS + /// \param[in] command A pointer to a STATIC string that has your command. I keep a copy of the pointer here so don't deallocate the string. + /// \param[in] commandHelp A pointer to a STATIC string that has the help information for your command. I keep a copy of the pointer here so don't deallocate the string. + virtual void RegisterCommand(unsigned char parameterCount, const char *command, const char *commandHelp); + + /// \brief Just writes a string to the remote system based on the result ( \a res ) of your operation + /// \details This is not necessary to call, but makes it easier to return results of function calls. + /// \param[in] res The result to write + /// \param[in] command The command that this result came from + /// \param[in] transport The transport interface that will be written to + /// \param[in] systemAddress The player this result will be sent to + virtual void ReturnResult(bool res, const char *command, TransportInterface *transport, const SystemAddress &systemAddress); + virtual void ReturnResult(char *res, const char *command, TransportInterface *transport, const SystemAddress &systemAddress); + virtual void ReturnResult(SystemAddress res, const char *command, TransportInterface *transport, const SystemAddress &systemAddress); + virtual void ReturnResult(int res, const char *command,TransportInterface *transport, const SystemAddress &systemAddress); + + /// \brief Just writes a string to the remote system when you are calling a function that has no return value. + /// \details This is not necessary to call, but makes it easier to return results of function calls. + /// \param[in] res The result to write + /// \param[in] command The command that this result came from + /// \param[in] transport The transport interface that will be written to + /// \param[in] systemAddress The player this result will be sent to + virtual void ReturnResult(const char *command,TransportInterface *transport, const SystemAddress &systemAddress); + +protected: + DataStructures::OrderedList commandList; +}; + +} // namespace RakNet + +#endif + diff --git a/include/raknet/ConnectionGraph2.hpp b/include/raknet/ConnectionGraph2.hpp new file mode 100644 index 0000000..f699c7c --- /dev/null +++ b/include/raknet/ConnectionGraph2.hpp @@ -0,0 +1,126 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file ConnectionGraph2.h +/// \brief Connection graph plugin, version 2. Tells new systems about existing and new connections +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_ConnectionGraph2==1 + +#ifndef __CONNECTION_GRAPH_2_H +#define __CONNECTION_GRAPH_2_H + +#include "RakMemoryOverride.hpp" +#include "RakNetTypes.hpp" +#include "PluginInterface2.hpp" +#include "DS_List.hpp" +#include "DS_WeightedGraph.hpp" +#include "GetTime.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \brief A one hop connection graph. +/// \details Sends ID_REMOTE_CONNECTION_LOST, ID_REMOTE_DISCONNECTION_NOTIFICATION, ID_REMOTE_NEW_INCOMING_CONNECTION
+/// All identifiers are followed by SystemAddress, then RakNetGUID +/// Also stores the list for you, which you can access with GetConnectionListForRemoteSystem +/// \ingroup CONNECTION_GRAPH_GROUP +class RAK_DLL_EXPORT ConnectionGraph2 : public PluginInterface2 +{ +public: + + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(ConnectionGraph2) + + ConnectionGraph2(); + ~ConnectionGraph2(); + + /// \brief Given a remote system identified by RakNetGUID, return the list of SystemAddresses and RakNetGUIDs they are connected to + /// \param[in] remoteSystemGuid Which system we are referring to. This only works for remote systems, not ourselves. + /// \param[out] saOut A preallocated array to hold the output list of SystemAddress. Can be 0 if you don't care. + /// \param[out] guidOut A preallocated array to hold the output list of RakNetGUID. Can be 0 if you don't care. + /// \param[in,out] outLength On input, the size of \a saOut and \a guidOut. On output, modified to reflect the number of elements actually written + /// \return True if \a remoteSystemGuid was found. Otherwise false, and \a saOut, \a guidOut remain unchanged. \a outLength will be set to 0. + bool GetConnectionListForRemoteSystem(RakNetGUID remoteSystemGuid, SystemAddress *saOut, RakNetGUID *guidOut, unsigned int *outLength); + + /// Returns if g1 is connected to g2 + bool ConnectionExists(RakNetGUID g1, RakNetGUID g2); + + /// Returns the average ping between two systems in the connection graph. Returns -1 if no connection exists between those systems + uint16_t GetPingBetweenSystems(RakNetGUID g1, RakNetGUID g2) const; + + /// Returns the system with the lowest average ping among all its connections. + /// If you need one system in the peer to peer group to relay data, have the FullyConnectedMesh2 host call this function after host migration, and use that system + RakNetGUID GetLowestAveragePingSystem(void) const; + + /// \brief If called with false, then new connections are only added to the connection graph when you call ProcessNewConnection(); + /// \details This is useful if you want to perform validation before connecting a system to a mesh, or if you want a submesh (for example a server cloud) + /// \param[in] b True to automatically call ProcessNewConnection() on any new connection, false to not do so. Defaults to true. + void SetAutoProcessNewConnections(bool b); + + /// \brief Returns value passed to SetAutoProcessNewConnections() + /// \return Value passed to SetAutoProcessNewConnections(), or the default of true if it was never called + bool GetAutoProcessNewConnections(void) const; + + /// \brief If you call SetAutoProcessNewConnections(false);, then you will need to manually call ProcessNewConnection() on new connections + /// \details On ID_NEW_INCOMING_CONNECTION or ID_CONNECTION_REQUEST_ACCEPTED, adds that system to the graph + /// Do not call ProcessNewConnection() manually otherwise + /// \param[in] The packet->SystemAddress member + /// \param[in] The packet->guid member + void AddParticipant(const SystemAddress &systemAddress, RakNetGUID rakNetGUID); + + /// Get the participants added with AddParticipant() + /// \param[out] participantList Participants added with AddParticipant(); + void GetParticipantList(DataStructures::OrderedList &participantList); + + /// \internal + struct SystemAddressAndGuid + { + SystemAddress systemAddress; + RakNetGUID guid; + uint16_t sendersPingToThatSystem; + }; + /// \internal + static int SystemAddressAndGuidComp( const SystemAddressAndGuid &key, const SystemAddressAndGuid &data ); + + /// \internal + struct RemoteSystem + { + DataStructures::OrderedList remoteConnections; + RakNetGUID guid; + }; + /// \internal + static int RemoteSystemComp( const RakNetGUID &key, RemoteSystem * const &data ); + +protected: + /// \internal + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + /// \internal + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + /// \internal + virtual PluginReceiveResult OnReceive(Packet *packet); + + // List of systems I am connected to, which in turn stores which systems they are connected to + DataStructures::OrderedList remoteSystems; + + bool autoProcessNewConnections; + +}; + +} // namespace RakNet + +#endif // #ifndef __CONNECTION_GRAPH_2_H + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/ConsoleServer.hpp b/include/raknet/ConsoleServer.hpp new file mode 100644 index 0000000..f9d9b6b --- /dev/null +++ b/include/raknet/ConsoleServer.hpp @@ -0,0 +1,84 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file ConsoleServer.h +/// \brief Contains ConsoleServer , used to plugin to your game to accept remote console-based connections +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_ConsoleServer==1 + +#ifndef __CONSOLE_SERVER_H +#define __CONSOLE_SERVER_H + +#include "RakMemoryOverride.hpp" +#include "DS_List.hpp" +#include "RakNetTypes.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class TransportInterface; +class CommandParserInterface; + + +/// \brief The main entry point for the server portion of your remote console application support. +/// \details ConsoleServer takes one TransportInterface and one or more CommandParserInterface (s) +/// The TransportInterface will be used to send data between the server and the client. The connecting client must support the +/// protocol used by your derivation of TransportInterface . TelnetTransport and RakNetTransport are two such derivations . +/// When a command is sent by a remote console, it will be processed by your implementations of CommandParserInterface +class RAK_DLL_EXPORT ConsoleServer +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(ConsoleServer) + + ConsoleServer(); + ~ConsoleServer(); + + /// \brief Call this with a derivation of TransportInterface so that the console server can send and receive commands + /// \param[in] transportInterface Your interface to use. + /// \param[in] port The port to host on. Telnet uses port 23 by default. RakNet can use whatever you want. + void SetTransportProvider(TransportInterface *transportInterface, unsigned short port); + + /// \brief Add an implementation of CommandParserInterface to the list of command parsers. + /// \param[in] commandParserInterface The command parser referred to + void AddCommandParser(CommandParserInterface *commandParserInterface); + + /// \brief Remove an implementation of CommandParserInterface previously added with AddCommandParser(). + /// \param[in] commandParserInterface The command parser referred to + void RemoveCommandParser(CommandParserInterface *commandParserInterface); + + /// \brief Call update to read packet sent from your TransportInterface. + /// You should do this fairly frequently. + void Update(void); + + /// \brief Sets a prompt to show when waiting for user input. + /// \details Pass an empty string to clear the prompt + /// Defaults to no prompt + /// \param[in] _prompt Null-terminated string of the prompt to use. If you want a newline, be sure to use /r/n + void SetPrompt(const char *_prompt); + +protected: + void ListParsers(SystemAddress systemAddress); + void ShowPrompt(SystemAddress systemAddress); + TransportInterface *transport; + DataStructures::List commandParserList; + char* password[256]; + char *prompt; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/DR_SHA1.hpp b/include/raknet/DR_SHA1.hpp new file mode 100644 index 0000000..71c3615 --- /dev/null +++ b/include/raknet/DR_SHA1.hpp @@ -0,0 +1,308 @@ +/* + 100% free public domain implementation of the SHA-1 algorithm + by Dominik Reichl + Web: http://www.dominik-reichl.de/ + + Version 2.1 - 2012-06-19 + - Deconstructor (resetting internal variables) is now only + implemented if SHA1_WIPE_VARIABLES is defined (which is the + default). + - Renamed inclusion guard to contain a GUID. + - Demo application is now using C++/STL objects and functions. + - Unicode build of the demo application now outputs the hashes of both + the ANSI and Unicode representations of strings. + - Various other demo application improvements. + + Version 2.0 - 2012-06-14 + - Added 'limits.h' include. + - Renamed inclusion guard and macros for compliancy (names beginning + with an underscore are reserved). + + Version 1.9 - 2011-11-10 + - Added Unicode test vectors. + - Improved support for hashing files using the HashFile method that + are larger than 4 GB. + - Improved file hashing performance (by using a larger buffer). + - Disabled unnecessary compiler warnings. + - Internal variables are now private. + + Version 1.8 - 2009-03-16 + - Converted project files to Visual Studio 2008 format. + - Added Unicode support for HashFile utility method. + - Added support for hashing files using the HashFile method that are + larger than 2 GB. + - HashFile now returns an error code instead of copying an error + message into the output buffer. + - GetHash now returns an error code and validates the input parameter. + - Added ReportHashStl STL utility method. + - Added REPORT_HEX_SHORT reporting mode. + - Improved Linux compatibility of test program. + + Version 1.7 - 2006-12-21 + - Fixed buffer underrun warning that appeared when compiling with + Borland C Builder (thanks to Rex Bloom and Tim Gallagher for the + patch). + - Breaking change: ReportHash writes the final hash to the start + of the buffer, i.e. it's not appending it to the string anymore. + - Made some function parameters const. + - Added Visual Studio 2005 project files to demo project. + + Version 1.6 - 2005-02-07 (thanks to Howard Kapustein for patches) + - You can set the endianness in your files, no need to modify the + header file of the CSHA1 class anymore. + - Aligned data support. + - Made support/compilation of the utility functions (ReportHash and + HashFile) optional (useful when bytes count, for example in embedded + environments). + + Version 1.5 - 2005-01-01 + - 64-bit compiler compatibility added. + - Made variable wiping optional (define SHA1_WIPE_VARIABLES). + - Removed unnecessary variable initializations. + - ROL32 improvement for the Microsoft compiler (using _rotl). + + Version 1.4 - 2004-07-22 + - CSHA1 now compiles fine with GCC 3.3 under Mac OS X (thanks to Larry + Hastings). + + Version 1.3 - 2003-08-17 + - Fixed a small memory bug and made a buffer array a class member to + ensure correct working when using multiple CSHA1 class instances at + one time. + + Version 1.2 - 2002-11-16 + - Borlands C++ compiler seems to have problems with string addition + using sprintf. Fixed the bug which caused the digest report function + not to work properly. CSHA1 is now Borland compatible. + + Version 1.1 - 2002-10-11 + - Removed two unnecessary header file includes and changed BOOL to + bool. Fixed some minor bugs in the web page contents. + + Version 1.0 - 2002-06-20 + - First official release. + + ================ Test Vectors ================ + + SHA1("abc" in ANSI) = + A9993E36 4706816A BA3E2571 7850C26C 9CD0D89D + SHA1("abc" in Unicode LE) = + 9F04F41A 84851416 2050E3D6 8C1A7ABB 441DC2B5 + + SHA1("abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq" + in ANSI) = + 84983E44 1C3BD26E BAAE4AA1 F95129E5 E54670F1 + SHA1("abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq" + in Unicode LE) = + 51D7D876 9AC72C40 9C5B0E3F 69C60ADC 9A039014 + + SHA1(A million repetitions of "a" in ANSI) = + 34AA973C D4C4DAA4 F61EEB2B DBAD2731 6534016F + SHA1(A million repetitions of "a" in Unicode LE) = + C4609560 A108A0C6 26AA7F2B 38A65566 739353C5 +*/ + +#ifndef SHA1_H_A545E61D43E9404E8D736869AB3CBFE7 +#define SHA1_H_A545E61D43E9404E8D736869AB3CBFE7 + +// KevinJ: +#include "RakMemoryOverride.hpp" +#include // Needed for file access + +#include // Needed for memset and memcpy + +#include // Needed for strcat and strcpy +#include "Export.hpp" +//#define MAX_FILE_READ_BUFFER 8000 +#define SHA1_LENGTH 20 + + + +#if !defined(SHA1_UTILITY_FUNCTIONS) && !defined(SHA1_NO_UTILITY_FUNCTIONS) +#define SHA1_UTILITY_FUNCTIONS +#endif + +#if !defined(SHA1_STL_FUNCTIONS) && !defined(SHA1_NO_STL_FUNCTIONS) +#define SHA1_STL_FUNCTIONS +#if !defined(SHA1_UTILITY_FUNCTIONS) +#error STL functions require SHA1_UTILITY_FUNCTIONS. +#endif +#endif + + +#include + +#include + +#ifdef SHA1_UTILITY_FUNCTIONS +#include +#include +#endif + +#ifdef SHA1_STL_FUNCTIONS +#include +#endif + +#ifdef _MSC_VER +#include +#endif + +// You can define the endian mode in your files without modifying the SHA-1 +// source files. Just #define SHA1_LITTLE_ENDIAN or #define SHA1_BIG_ENDIAN +// in your files, before including the DR_SHA1.h header file. If you don't +// define anything, the class defaults to little endian. +#if !defined(SHA1_LITTLE_ENDIAN) && !defined(SHA1_BIG_ENDIAN) +#define SHA1_LITTLE_ENDIAN +#endif + +// If you want variable wiping, #define SHA1_WIPE_VARIABLES, if not, +// #define SHA1_NO_WIPE_VARIABLES. If you don't define anything, it +// defaults to wiping. +#if !defined(SHA1_WIPE_VARIABLES) && !defined(SHA1_NO_WIPE_VARIABLES) +#define SHA1_WIPE_VARIABLES +#endif + +#if defined(SHA1_HAS_TCHAR) +#include +#else +#ifdef _MSC_VER +#include +#else +#ifndef TCHAR + + #ifdef _WIN32 + #include + #else + #define TCHAR char + #endif + +#endif + +#ifndef _T +#define _T(__x) (__x) +#define _tmain main +#define _tprintf printf +#define _getts gets +#define _tcslen strlen +#define _tfopen fopen +#define _tcscpy strcpy +#define _tcscat strcat +#define _sntprintf snprintf +#endif +#endif +#endif + +/////////////////////////////////////////////////////////////////////////// +// Define variable types + +#ifndef UINT_8 +#ifdef _MSC_VER // Compiling with Microsoft compiler +#define UINT_8 unsigned __int8 +#else // !_MSC_VER +#define UINT_8 unsigned char +#endif // _MSC_VER +#endif + +#ifndef UINT_32 +#ifdef _MSC_VER // Compiling with Microsoft compiler +#define UINT_32 unsigned __int32 +#else // !_MSC_VER +#if (ULONG_MAX == 0xFFFFFFFFUL) +#define UINT_32 unsigned long +#else +#define UINT_32 unsigned int +#endif +#endif // _MSC_VER +#endif // UINT_32 + +#ifndef INT_64 +#ifdef _MSC_VER // Compiling with Microsoft compiler +#define INT_64 __int64 +#else // !_MSC_VER +#define INT_64 long long +#endif // _MSC_VER +#endif // INT_64 + +#ifndef UINT_64 +#ifdef _MSC_VER // Compiling with Microsoft compiler +#define UINT_64 unsigned __int64 +#else // !_MSC_VER +#define UINT_64 unsigned long long +#endif // _MSC_VER +#endif // UINT_64 + +/////////////////////////////////////////////////////////////////////////// +// Declare SHA-1 workspace + +typedef union +{ + UINT_8 c[64]; + UINT_32 l[16]; +} SHA1_WORKSPACE_BLOCK; + +class RAK_DLL_EXPORT CSHA1 +{ +public: +#ifdef SHA1_UTILITY_FUNCTIONS + // Different formats for ReportHash(Stl) + enum REPORT_TYPE + { + REPORT_HEX = 0, + REPORT_DIGIT = 1, + REPORT_HEX_SHORT = 2 + }; +#endif + + // Constructor and destructor + CSHA1(); + +#ifdef SHA1_WIPE_VARIABLES + ~CSHA1(); +#endif + + void Reset(); + + // Hash in binary data and strings + void Update(const UINT_8* pbData, UINT_32 uLen); + +#ifdef SHA1_UTILITY_FUNCTIONS + // Hash in file contents + bool HashFile(const TCHAR* tszFileName); +#endif + + // Finalize hash; call it before using ReportHash(Stl) + void Final(); + +#ifdef SHA1_UTILITY_FUNCTIONS + bool ReportHash(TCHAR* tszReport, REPORT_TYPE rtReportType = REPORT_HEX) const; +#endif + +#ifdef SHA1_STL_FUNCTIONS + bool ReportHashStl(std::basic_string& strOut, REPORT_TYPE rtReportType = + REPORT_HEX) const; +#endif + + // Get the raw message digest (20 bytes) + bool GetHash(UINT_8* pbDest20) const; + +unsigned char * GetHash( void ) const; +// KevinJ: http://cseweb.ucsd.edu/~mihir/papers/hmac-cb.pdf + static void HMAC(unsigned char *sharedKey, int sharedKeyLength, unsigned char *data, int dataLength, unsigned char output[SHA1_LENGTH]); + +private: + // Private SHA-1 transformation + void Transform(UINT_32* pState, const UINT_8* pBuffer); + + // Member variables + UINT_32 m_state[5]; + UINT_32 m_count[2]; + UINT_32 m_reserved0[1]; // Memory alignment padding + UINT_8 m_buffer[64]; + UINT_8 m_digest[20]; + UINT_32 m_reserved1[3]; // Memory alignment padding + + UINT_8 m_workspace[64]; + SHA1_WORKSPACE_BLOCK* m_block; // SHA1 pointer to the byte array above +}; + +#endif // SHA1_H_A545E61D43E9404E8D736869AB3CBFE7 diff --git a/include/raknet/DS_BPlusTree.hpp b/include/raknet/DS_BPlusTree.hpp new file mode 100644 index 0000000..47bcbac --- /dev/null +++ b/include/raknet/DS_BPlusTree.hpp @@ -0,0 +1,1154 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_BPlusTree.h +/// + + +#ifndef __B_PLUS_TREE_CPP +#define __B_PLUS_TREE_CPP + +#include "DS_MemoryPool.hpp" +#include "DS_Queue.hpp" +#include +#include "Export.hpp" + +// Java +// http://www.seanster.com/BplusTree/BplusTree.html + +// Overview +// http://babbage.clarku.edu/~achou/cs160/B+Trees/B+Trees.htm + +// Deletion +// http://dbpubs.stanford.edu:8090/pub/1995-19 + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +#include "RakMemoryOverride.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + /// Used in the BPlusTree. Used for both leaf and index nodes. + /// Don't use a constructor or destructor, due to the memory pool I am using + template + struct RAK_DLL_EXPORT Page + { + // We use the same data structure for both leaf and index nodes. + // It uses a little more memory for index nodes but reduces + // memory fragmentation, allocations, and deallocations. + bool isLeaf; + + // Used for both leaf and index nodes. + // For a leaf it means the number of elements in data + // For an index it means the number of keys and is one less than the number of children pointers. + int size; + + // Used for both leaf and index nodes. + KeyType keys[order]; + + // Used only for leaf nodes. Data is the actual data, while next is the pointer to the next leaf (for B+) + DataType data[order]; + Page *next; + Page *previous; + + // Used only for index nodes. Pointers to the children of this node. + Page *children[order+1]; + }; + + /// A BPlus tree + /// Written with efficiency and speed in mind. + template + class RAK_DLL_EXPORT BPlusTree + { + public: + struct ReturnAction + { + KeyType key1; + KeyType key2; + enum + { + NO_ACTION, + REPLACE_KEY1_WITH_KEY2, + PUSH_KEY_TO_PARENT, + SET_BRANCH_KEY, + } action; // 0=none, 1=replace key1 with key2 + }; + + BPlusTree(); + ~BPlusTree(); + void SetPoolPageSize(int size); // Set the page size for the memory pool. Optionsl + bool Get(const KeyType key, DataType &out) const; + bool Delete(const KeyType key); + bool Delete(const KeyType key, DataType &out); + bool Insert(const KeyType key, const DataType &data); + void Clear(void); + unsigned Size(void) const; + bool IsEmpty(void) const; + Page *GetListHead(void) const; + DataType GetDataHead(void) const; + void PrintLeaves(void); + void ForEachLeaf(void (*func)(Page * leaf, int index)); + void ForEachData(void (*func)(DataType input, int index)); + void PrintGraph(void); + protected: + void ValidateTreeRecursive(Page *cur); + void DeleteFromPageAtIndex(const int index, Page *cur); + static void PrintLeaf(Page * leaf, int index); + void FreePages(void); + bool GetIndexOf(const KeyType key, Page *page, int *out) const; + void ShiftKeysLeft(Page *cur); + bool CanRotateLeft(Page *cur, int childIndex); + bool CanRotateRight(Page *cur, int childIndex); + void RotateRight(Page *cur, int childIndex, ReturnAction *returnAction); + void RotateLeft(Page *cur, int childIndex, ReturnAction *returnAction); + Page* InsertIntoNode(const KeyType key, const DataType &childData, int insertionIndex, Page *nodeData, Page *cur, ReturnAction* returnAction); + Page* InsertBranchDown(const KeyType key, const DataType &data,Page *cur, ReturnAction* returnAction, bool *success); + Page* GetLeafFromKey(const KeyType key) const; + bool FindDeleteRebalance(const KeyType key, Page *cur, bool *underflow, KeyType rightRootKey, ReturnAction *returnAction, DataType &out); + bool FixUnderflow(int branchIndex, Page *cur, KeyType rightRootKey, ReturnAction *returnAction); + void ShiftNodeLeft(Page *cur); + void ShiftNodeRight(Page *cur); + + MemoryPool > pagePool; + Page *root, *leftmostLeaf; + }; + + template + BPlusTree::BPlusTree () + { + RakAssert(order>1); + root=0; + leftmostLeaf=0; + } + template + BPlusTree::~BPlusTree () + { + Clear(); + } + template + void BPlusTree::SetPoolPageSize(int size) + { + pagePool.SetPageSize(size); + } + template + bool BPlusTree::Get(const KeyType key, DataType &out) const + { + if (root==0) + return false; + + Page* leaf = GetLeafFromKey(key); + int childIndex; + + if (GetIndexOf(key, leaf, &childIndex)) + { + out=leaf->data[childIndex]; + return true; + } + return false; + } + template + void BPlusTree::DeleteFromPageAtIndex(const int index, Page *cur) + { + int i; + for (i=index; i < cur->size-1; i++) + cur->keys[i]=cur->keys[i+1]; + if (cur->isLeaf) + { + for (i=index; i < cur->size-1; i++) + cur->data[i]=cur->data[i+1]; + } + else + { + for (i=index; i < cur->size-1; i++) + cur->children[i+1]=cur->children[i+2]; + } + cur->size--; + } + template + bool BPlusTree::Delete(const KeyType key) + { + DataType temp; + return Delete(key, temp); + } + template + bool BPlusTree::Delete(const KeyType key, DataType &out) + { + if (root==0) + return false; + + ReturnAction returnAction; + returnAction.action=ReturnAction::NO_ACTION; + int childIndex; + bool underflow=false; + if (root==leftmostLeaf) + { + if (GetIndexOf(key, root, &childIndex)==false) + return false; + out=root->data[childIndex]; + DeleteFromPageAtIndex(childIndex,root); + if (root->size==0) + { + pagePool.Release(root, _FILE_AND_LINE_); + root=0; + leftmostLeaf=0; + } + return true; + } + else if (FindDeleteRebalance(key, root, &underflow,root->keys[0], &returnAction, out)==false) + return false; + +// RakAssert(returnAction.action==ReturnAction::NO_ACTION); + + if (underflow && root->size==0) + { + // Move the root down. + Page *oldRoot=root; + root=root->children[0]; + pagePool.Release(oldRoot, _FILE_AND_LINE_); + // memset(oldRoot,0,sizeof(root)); + } + + return true; + } + template + bool BPlusTree::FindDeleteRebalance(const KeyType key, Page *cur, bool *underflow, KeyType rightRootKey, ReturnAction *returnAction, DataType &out) + { + // Get index of child to follow. + int branchIndex, childIndex; + if (GetIndexOf(key, cur, &childIndex)) + branchIndex=childIndex+1; + else + branchIndex=childIndex; + + // If child is not a leaf, call recursively + if (cur->children[branchIndex]->isLeaf==false) + { + if (branchIndexsize) + rightRootKey=cur->keys[branchIndex]; // Shift right to left + else + rightRootKey=cur->keys[branchIndex-1]; // Shift center to left + + if (FindDeleteRebalance(key, cur->children[branchIndex], underflow, rightRootKey, returnAction, out)==false) + return false; + + // Call again in case the root key changed + if (branchIndexsize) + rightRootKey=cur->keys[branchIndex]; // Shift right to left + else + rightRootKey=cur->keys[branchIndex-1]; // Shift center to left + + if (returnAction->action==ReturnAction::SET_BRANCH_KEY && branchIndex!=childIndex) + { + returnAction->action=ReturnAction::NO_ACTION; + cur->keys[childIndex]=returnAction->key1; + + if (branchIndexsize) + rightRootKey=cur->keys[branchIndex]; // Shift right to left + else + rightRootKey=cur->keys[branchIndex-1]; // Shift center to left + } + } + else + { + // If child is a leaf, get the index of the key. If the item is not found, cancel delete. + if (GetIndexOf(key, cur->children[branchIndex], &childIndex)==false) + return false; + + // Delete: + // Remove childIndex from the child at branchIndex + out=cur->children[branchIndex]->data[childIndex]; + DeleteFromPageAtIndex(childIndex, cur->children[branchIndex]); + + if (childIndex==0) + { + if (branchIndex>0) + cur->keys[branchIndex-1]=cur->children[branchIndex]->keys[0]; + + if (branchIndex==0) + { + returnAction->action=ReturnAction::SET_BRANCH_KEY; + returnAction->key1=cur->children[0]->keys[0]; + } + } + + if (cur->children[branchIndex]->size < order/2) + *underflow=true; + else + *underflow=false; + } + + // Fix underflow: + if (*underflow) + { + *underflow=FixUnderflow(branchIndex, cur, rightRootKey, returnAction); + } + + return true; + } + template + bool BPlusTree::FixUnderflow(int branchIndex, Page *cur, KeyType rightRootKey, ReturnAction *returnAction) + { + // Borrow from a neighbor that has excess. + Page *source; + Page *dest; + + if (branchIndex>0 && cur->children[branchIndex-1]->size > order/2) + { + dest=cur->children[branchIndex]; + source=cur->children[branchIndex-1]; + + // Left has excess + ShiftNodeRight(dest); + if (dest->isLeaf) + { + dest->keys[0]=source->keys[source->size-1]; + dest->data[0]=source->data[source->size-1]; + } + else + { + dest->children[0]=source->children[source->size]; + dest->keys[0]=cur->keys[branchIndex-1]; + } + // Update the parent key for the child (middle) + cur->keys[branchIndex-1]=source->keys[source->size-1]; + source->size--; + + // if (branchIndex==0) + // { + // returnAction->action=ReturnAction::SET_BRANCH_KEY; + // returnAction->key1=dest->keys[0]; + // } + + // No underflow + return false; + } + else if (branchIndexsize && cur->children[branchIndex+1]->size > order/2) + { + dest=cur->children[branchIndex]; + source=cur->children[branchIndex+1]; + + // Right has excess + if (dest->isLeaf) + { + dest->keys[dest->size]=source->keys[0]; + dest->data[dest->size]=source->data[0]; + + // The first key in the leaf after shifting is the parent key for the right branch + cur->keys[branchIndex]=source->keys[1]; + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + if (order<=3 && dest->size==0) + { + if (branchIndex==0) + { + returnAction->action=ReturnAction::SET_BRANCH_KEY; + returnAction->key1=dest->keys[0]; + } + else + cur->keys[branchIndex-1]=cur->children[branchIndex]->keys[0]; + } + } + else + { + if (returnAction->action==ReturnAction::NO_ACTION) + { + returnAction->action=ReturnAction::SET_BRANCH_KEY; + returnAction->key1=dest->keys[0]; + } + + dest->keys[dest->size]=rightRootKey; + dest->children[dest->size+1]=source->children[0]; + + // The shifted off key is the leftmost key for a node + cur->keys[branchIndex]=source->keys[0]; + } + + + dest->size++; + ShiftNodeLeft(source); + + //cur->keys[branchIndex]=source->keys[0]; + +// returnAction->action=ReturnAction::SET_BRANCH_KEY; +// returnAction->key1=dest->keys[dest->size-1]; + + // No underflow + return false; + } + else + { + int sourceIndex; + + // If no neighbors have excess, merge two branches. + // + // To merge two leaves, just copy the data and keys over. + // + // To merge two branches, copy the pointers and keys over, using rightRootKey as the key for the extra pointer + if (branchIndexsize) + { + // Merge right child to current child and delete right child. + dest=cur->children[branchIndex]; + source=cur->children[branchIndex+1]; + } + else + { + // Move current child to left and delete current child + dest=cur->children[branchIndex-1]; + source=cur->children[branchIndex]; + } + + // Merge + if (dest->isLeaf) + { + for (sourceIndex=0; sourceIndexsize; sourceIndex++) + { + dest->keys[dest->size]=source->keys[sourceIndex]; + dest->data[dest->size++]=source->data[sourceIndex]; + } + } + else + { + // We want the tree root key of the source, not the current. + dest->keys[dest->size]=rightRootKey; + dest->children[dest->size++ + 1]=source->children[0]; + for (sourceIndex=0; sourceIndexsize; sourceIndex++) + { + dest->keys[dest->size]=source->keys[sourceIndex]; + dest->children[dest->size++ + 1]=source->children[sourceIndex + 1]; + } + } + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + if (order<=3 && branchIndex>0 && cur->children[branchIndex]->isLeaf) // With order==2 it is possible to delete data[0], which is not possible with higher orders. + cur->keys[branchIndex-1]=cur->children[branchIndex]->keys[0]; + + if (branchIndexsize) + { + // Update the parent key, removing the source (right) + DeleteFromPageAtIndex(branchIndex, cur); + } + else + { + if (branchIndex>0) + { + // Update parent key, removing the source (current) + DeleteFromPageAtIndex(branchIndex-1, cur); + } + } + + if (branchIndex==0 && dest->isLeaf) + { + returnAction->action=ReturnAction::SET_BRANCH_KEY; + returnAction->key1=dest->keys[0]; + } + + if (source==leftmostLeaf) + leftmostLeaf=source->next; + + if (source->isLeaf) + { + if (source->previous) + source->previous->next=source->next; + if (source->next) + source->next->previous=source->previous; + } + + // Free the source node + pagePool.Release(source, _FILE_AND_LINE_); + // memset(source,0,sizeof(root)); + + // Return underflow or not of parent. + return cur->size < order/2; + } + } + template + void BPlusTree::ShiftNodeRight(Page *cur) + { + int i; + for (i=cur->size; i>0; i--) + cur->keys[i]=cur->keys[i-1]; + if (cur->isLeaf) + { + for (i=cur->size; i>0; i--) + cur->data[i]=cur->data[i-1]; + } + else + { + for (i=cur->size+1; i>0; i--) + cur->children[i]=cur->children[i-1]; + } + + cur->size++; + } + template + void BPlusTree::ShiftNodeLeft(Page *cur) + { + int i; + for (i=0; i < cur->size-1; i++) + cur->keys[i]=cur->keys[i+1]; + if (cur->isLeaf) + { + for (i=0; i < cur->size; i++) + cur->data[i]=cur->data[i+1]; + } + else + { + for (i=0; i < cur->size; i++) + cur->children[i]=cur->children[i+1]; + } + cur->size--; + } + template + Page* BPlusTree::InsertIntoNode(const KeyType key, const DataType &leafData, int insertionIndex, Page *nodeData, Page *cur, ReturnAction* returnAction) + { + int i; + if (cur->size < order) + { + for (i=cur->size; i > insertionIndex; i--) + cur->keys[i]=cur->keys[i-1]; + if (cur->isLeaf) + { + for (i=cur->size; i > insertionIndex; i--) + cur->data[i]=cur->data[i-1]; + } + else + { + for (i=cur->size+1; i > insertionIndex+1; i--) + cur->children[i]=cur->children[i-1]; + } + cur->keys[insertionIndex]=key; + if (cur->isLeaf) + cur->data[insertionIndex]=leafData; + else + cur->children[insertionIndex+1]=nodeData; + + cur->size++; + } + else + { + Page* newPage = pagePool.Allocate( _FILE_AND_LINE_ ); + newPage->isLeaf=cur->isLeaf; + if (cur->isLeaf) + { + newPage->next=cur->next; + if (cur->next) + cur->next->previous=newPage; + newPage->previous=cur; + cur->next=newPage; + } + + int destIndex, sourceIndex; + + if (insertionIndex>=(order+1)/2) + { + destIndex=0; + sourceIndex=order/2; + + for (; sourceIndex < insertionIndex; sourceIndex++, destIndex++) + { + newPage->keys[destIndex]=cur->keys[sourceIndex]; + } + newPage->keys[destIndex++]=key; + for (; sourceIndex < order; sourceIndex++, destIndex++) + { + newPage->keys[destIndex]=cur->keys[sourceIndex]; + } + + destIndex=0; + sourceIndex=order/2; + if (cur->isLeaf) + { + for (; sourceIndex < insertionIndex; sourceIndex++, destIndex++) + { + newPage->data[destIndex]=cur->data[sourceIndex]; + } + newPage->data[destIndex++]=leafData; + for (; sourceIndex < order; sourceIndex++, destIndex++) + { + newPage->data[destIndex]=cur->data[sourceIndex]; + } + } + else + { + + for (; sourceIndex < insertionIndex; sourceIndex++, destIndex++) + { + newPage->children[destIndex]=cur->children[sourceIndex+1]; + } + newPage->children[destIndex++]=nodeData; + + // sourceIndex+1 is sort of a hack but it works - because there is one extra child than keys + // skip past the last child for cur + for (; sourceIndex+1 < cur->size+1; sourceIndex++, destIndex++) + { + newPage->children[destIndex]=cur->children[sourceIndex+1]; + } + + // the first key is the middle key. Remove it from the page and push it to the parent + returnAction->action=ReturnAction::PUSH_KEY_TO_PARENT; + returnAction->key1=newPage->keys[0]; + for (int j=0; j < destIndex-1; j++) + newPage->keys[j]=newPage->keys[j+1]; + + } + cur->size=order/2; + } + else + { + destIndex=0; + sourceIndex=(order+1)/2-1; + for (; sourceIndex < order; sourceIndex++, destIndex++) + newPage->keys[destIndex]=cur->keys[sourceIndex]; + destIndex=0; + if (cur->isLeaf) + { + sourceIndex=(order+1)/2-1; + for (; sourceIndex < order; sourceIndex++, destIndex++) + newPage->data[destIndex]=cur->data[sourceIndex]; + } + else + { + sourceIndex=(order+1)/2; + for (; sourceIndex < order+1; sourceIndex++, destIndex++) + newPage->children[destIndex]=cur->children[sourceIndex]; + + // the first key is the middle key. Remove it from the page and push it to the parent + returnAction->action=ReturnAction::PUSH_KEY_TO_PARENT; + returnAction->key1=newPage->keys[0]; + for (int j=0; j < destIndex-1; j++) + newPage->keys[j]=newPage->keys[j+1]; + } + cur->size=(order+1)/2-1; + if (cur->size) + { + bool b = GetIndexOf(key, cur, &insertionIndex); + (void) b; + RakAssert(b==false); + } + else + insertionIndex=0; + InsertIntoNode(key, leafData, insertionIndex, nodeData, cur, returnAction); + } + + newPage->size=destIndex; + + return newPage; + } + + return 0; + } + + template + bool BPlusTree::CanRotateLeft(Page *cur, int childIndex) + { + return childIndex>0 && cur->children[childIndex-1]->size + void BPlusTree::RotateLeft(Page *cur, int childIndex, ReturnAction *returnAction) + { + Page *dest = cur->children[childIndex-1]; + Page *source = cur->children[childIndex]; + returnAction->key1=source->keys[0]; + dest->keys[dest->size]=source->keys[0]; + dest->data[dest->size]=source->data[0]; + dest->size++; + for (int i=0; i < source->size-1; i++) + { + source->keys[i]=source->keys[i+1]; + source->data[i]=source->data[i+1]; + } + source->size--; + cur->keys[childIndex-1]=source->keys[0]; + returnAction->key2=source->keys[0]; + } + + template + bool BPlusTree::CanRotateRight(Page *cur, int childIndex) + { + return childIndex < cur->size && cur->children[childIndex+1]->size + void BPlusTree::RotateRight(Page *cur, int childIndex, ReturnAction *returnAction) + { + Page *dest = cur->children[childIndex+1]; + Page *source = cur->children[childIndex]; + returnAction->key1=dest->keys[0]; + for (int i= dest->size; i > 0; i--) + { + dest->keys[i]=dest->keys[i-1]; + dest->data[i]=dest->data[i-1]; + } + dest->keys[0]=source->keys[source->size-1]; + dest->data[0]=source->data[source->size-1]; + dest->size++; + source->size--; + + cur->keys[childIndex]=dest->keys[0]; + returnAction->key2=dest->keys[0]; + } + template + Page* BPlusTree::GetLeafFromKey(const KeyType key) const + { + Page* cur = root; + int childIndex; + while (cur->isLeaf==false) + { + // When searching, if we match the exact key we go down the pointer after that index + if (GetIndexOf(key, cur, &childIndex)) + childIndex++; + cur = cur->children[childIndex]; + } + return cur; + } + + template + Page* BPlusTree::InsertBranchDown(const KeyType key, const DataType &data,Page *cur, ReturnAction *returnAction, bool *success) + { + int childIndex; + int branchIndex; + if (GetIndexOf(key, cur, &childIndex)) + branchIndex=childIndex+1; + else + branchIndex=childIndex; + Page* newPage; + if (cur->isLeaf==false) + { + if (cur->children[branchIndex]->isLeaf==true && cur->children[branchIndex]->size==order) + { + if (branchIndex==childIndex+1) + { + *success=false; + return 0; // Already exists + } + + if (CanRotateLeft(cur, branchIndex)) + { + returnAction->action=ReturnAction::REPLACE_KEY1_WITH_KEY2; + if (key > cur->children[branchIndex]->keys[0]) + { + RotateLeft(cur, branchIndex, returnAction); + + int insertionIndex; + GetIndexOf(key, cur->children[branchIndex], &insertionIndex); + InsertIntoNode(key, data, insertionIndex, 0, cur->children[branchIndex], 0); + } + else + { + // Move head element to left and replace it with key,data + Page* dest=cur->children[branchIndex-1]; + Page* source=cur->children[branchIndex]; + returnAction->key1=source->keys[0]; + returnAction->key2=key; + dest->keys[dest->size]=source->keys[0]; + dest->data[dest->size]=source->data[0]; + dest->size++; + source->keys[0]=key; + source->data[0]=data; + } + cur->keys[branchIndex-1]=cur->children[branchIndex]->keys[0]; + + return 0; + } + else if (CanRotateRight(cur, branchIndex)) + { + returnAction->action=ReturnAction::REPLACE_KEY1_WITH_KEY2; + + if (key < cur->children[branchIndex]->keys[cur->children[branchIndex]->size-1]) + { + RotateRight(cur, branchIndex, returnAction); + + int insertionIndex; + GetIndexOf(key, cur->children[branchIndex], &insertionIndex); + InsertIntoNode(key, data, insertionIndex, 0, cur->children[branchIndex], 0); + + } + else + { + // Insert to the head of the right leaf instead and change our key + returnAction->key1=cur->children[branchIndex+1]->keys[0]; + InsertIntoNode(key, data, 0, 0, cur->children[branchIndex+1], 0); + returnAction->key2=key; + } + cur->keys[branchIndex]=cur->children[branchIndex+1]->keys[0]; + return 0; + } + } + + newPage=InsertBranchDown(key,data,cur->children[branchIndex], returnAction, success); + if (returnAction->action==ReturnAction::REPLACE_KEY1_WITH_KEY2) + { + if (branchIndex>0 && cur->keys[branchIndex-1]==returnAction->key1) + cur->keys[branchIndex-1]=returnAction->key2; + } + if (newPage) + { + if (newPage->isLeaf==false) + { + RakAssert(returnAction->action==ReturnAction::PUSH_KEY_TO_PARENT); + newPage->size--; + return InsertIntoNode(returnAction->key1, data, branchIndex, newPage, cur, returnAction); + } + else + { + return InsertIntoNode(newPage->keys[0], data, branchIndex, newPage, cur, returnAction); + } + } + } + else + { + if (branchIndex==childIndex+1) + { + *success=false; + return 0; // Already exists + } + else + { + return InsertIntoNode(key, data, branchIndex, 0, cur, returnAction); + } + } + + return 0; + } + template + bool BPlusTree::Insert(const KeyType key, const DataType &data) + { + if (root==0) + { + // Allocate root and make root a leaf + root = pagePool.Allocate( _FILE_AND_LINE_ ); + root->isLeaf=true; + leftmostLeaf=root; + root->size=1; + root->keys[0]=key; + root->data[0]=data; + root->next=0; + root->previous=0; + } + else + { + bool success=true; + ReturnAction returnAction; + returnAction.action=ReturnAction::NO_ACTION; + Page* newPage = InsertBranchDown(key, data, root, &returnAction, &success); + if (success==false) + return false; + if (newPage) + { + KeyType newKey; + if (newPage->isLeaf==false) + { + // One key is pushed up through the stack. I store that at keys[0] but it has to be removed for the page to be correct + RakAssert(returnAction.action==ReturnAction::PUSH_KEY_TO_PARENT); + newKey=returnAction.key1; + newPage->size--; + } + else + newKey = newPage->keys[0]; + // propagate the root + Page* newRoot = pagePool.Allocate( _FILE_AND_LINE_ ); + newRoot->isLeaf=false; + newRoot->size=1; + newRoot->keys[0]=newKey; + newRoot->children[0]=root; + newRoot->children[1]=newPage; + root=newRoot; + } + } + + return true; + } + template + void BPlusTree::ShiftKeysLeft(Page *cur) + { + int i; + for (i=0; i < cur->size; i++) + cur->keys[i]=cur->keys[i+1]; + } + template + void BPlusTree::Clear(void) + { + if (root) + { + FreePages(); + leftmostLeaf=0; + root=0; + } + pagePool.Clear(_FILE_AND_LINE_); + } + template + unsigned BPlusTree::Size(void) const + { + unsigned int count=0; + DataStructures::Page *cur = GetListHead(); + while (cur) + { + count+=cur->size; + cur=cur->next; + } + return count; + } + template + bool BPlusTree::IsEmpty(void) const + { + return root==0; + } + template + bool BPlusTree::GetIndexOf(const KeyType key, Page *page, int *out) const + { + RakAssert(page->size>0); + int index, upperBound, lowerBound; + upperBound=page->size-1; + lowerBound=0; + index = page->size/2; + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + while (1) + { + if (key==page->keys[index]) + { + *out=index; + return true; + } + else if (keykeys[index]) + upperBound=index-1; + else + lowerBound=index+1; + + index=lowerBound+(upperBound-lowerBound)/2; + + if (lowerBound>upperBound) + { + *out=lowerBound; + return false; // No match + } + } + } + template + void BPlusTree::FreePages(void) + { + DataStructures::Queue *> queue; + DataStructures::Page *ptr; + int i; + queue.Push(root, _FILE_AND_LINE_ ); + while (queue.Size()) + { + ptr=queue.Pop(); + if (ptr->isLeaf==false) + { + for (i=0; i < ptr->size+1; i++) + queue.Push(ptr->children[i], _FILE_AND_LINE_ ); + } + pagePool.Release(ptr, _FILE_AND_LINE_); + // memset(ptr,0,sizeof(root)); + }; + } + template + Page *BPlusTree::GetListHead(void) const + { + return leftmostLeaf; + } + template + DataType BPlusTree::GetDataHead(void) const + { + return leftmostLeaf->data[0]; + } + template + void BPlusTree::ForEachLeaf(void (*func)(Page * leaf, int index)) + { + int count=0; + DataStructures::Page *cur = GetListHead(); + while (cur) + { + func(cur, count++); + cur=cur->next; + } + } + template + void BPlusTree::ForEachData(void (*func)(DataType input, int index)) + { + int count=0,i; + DataStructures::Page *cur = GetListHead(); + while (cur) + { + for (i=0; i < cur->size; i++) + func(cur->data[i], count++); + cur=cur->next; + } + } + template + void BPlusTree::PrintLeaf(Page * leaf, int index) + { + int i; + RAKNET_DEBUG_PRINTF("%i] SELF=%p\n", index+1, leaf); + for (i=0; i < leaf->size; i++) + RAKNET_DEBUG_PRINTF(" %i. %i\n", i+1, leaf->data[i]); + } + template + void BPlusTree::PrintLeaves(void) + { + ForEachLeaf(PrintLeaf); + } + + template + void BPlusTree::ValidateTreeRecursive(Page *cur) + { + RakAssert(cur==root || cur->size>=order/2); + + if (cur->children[0]->isLeaf) + { + RakAssert(cur->children[0]->keys[0] < cur->keys[0]); + for (int i=0; i < cur->size; i++) + { + RakAssert(cur->children[i+1]->keys[0]==cur->keys[i]); + } + } + else + { + for (int i=0; i < cur->size+1; i++) + ValidateTreeRecursive(cur->children[i]); + } + } + + template + void BPlusTree::PrintGraph(void) + { + DataStructures::Queue *> queue; + queue.Push(root,_FILE_AND_LINE_); + queue.Push(0,_FILE_AND_LINE_); + DataStructures::Page *ptr; + int i,j; + if (root) + { + RAKNET_DEBUG_PRINTF("%p(", root); + for (i=0; i < root->size; i++) + { + RAKNET_DEBUG_PRINTF("%i ", root->keys[i]); + } + RAKNET_DEBUG_PRINTF(") "); + RAKNET_DEBUG_PRINTF("\n"); + } + while (queue.Size()) + { + ptr=queue.Pop(); + if (ptr==0) + RAKNET_DEBUG_PRINTF("\n"); + else if (ptr->isLeaf==false) + { + for (i=0; i < ptr->size+1; i++) + { + RAKNET_DEBUG_PRINTF("%p(", ptr->children[i]); + //RAKNET_DEBUG_PRINTF("(", ptr->children[i]); + for (j=0; j < ptr->children[i]->size; j++) + RAKNET_DEBUG_PRINTF("%i ", ptr->children[i]->keys[j]); + RAKNET_DEBUG_PRINTF(") "); + queue.Push(ptr->children[i],_FILE_AND_LINE_); + } + queue.Push(0,_FILE_AND_LINE_); + RAKNET_DEBUG_PRINTF(" -- "); + } + } + RAKNET_DEBUG_PRINTF("\n"); + } +} +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif + +// Code to test this hellish data structure. +/* +#include "DS_BPlusTree.hpp" +#include + +// Handle underflow on root. If there is only one item left then I can go downwards. +// Make sure I keep the leftmost pointer valid by traversing it +// When I free a leaf, be sure to adjust the pointers around it. + +#include "Rand.hpp" + +void main(void) +{ + DataStructures::BPlusTree btree; + DataStructures::List haveList, removedList; + int temp; + int i, j, index; + int testSize; + bool b; + + for (testSize=0; testSize < 514; testSize++) + { + RAKNET_DEBUG_PRINTF("TestSize=%i\n", testSize); + + for (i=0; i < testSize; i++) + haveList.Insert(i); + + for (i=0; i < testSize; i++) + { + index=i+randomMT()%(testSize-i); + temp=haveList[index]; + haveList[index]=haveList[i]; + haveList[i]=temp; + } + + for (i=0; i + * + * OR + * + * AVLBalancedBinarySearchTree + * + * Use the AVL balanced tree if you want the tree to be balanced after every deletion and addition. This avoids the potential + * worst case scenario where ordered input to a binary search tree gives linear search time results. It's not needed + * if input will be evenly distributed, in which case the search time is O (log n). The search time for the AVL + * balanced binary tree is O (log n) irregardless of input. + * + * Has the following member functions + * unsigned int Height() - Returns the height of the tree at the optional specified starting index. Default is the root + * add(element) - adds an element to the BinarySearchTree + * bool del(element) - deletes the node containing element if the element is in the tree as defined by a comparison with the == operator. Returns true on success, false if the element is not found + * bool IsInelement) - returns true if element is in the tree as defined by a comparison with the == operator. Otherwise returns false + * DisplayInorder(array) - Fills an array with an inorder search of the elements in the tree. USER IS REPONSIBLE FOR ALLOCATING THE ARRAY!. + * DisplayPreorder(array) - Fills an array with an preorder search of the elements in the tree. USER IS REPONSIBLE FOR ALLOCATING THE ARRAY!. + * DisplayPostorder(array) - Fills an array with an postorder search of the elements in the tree. USER IS REPONSIBLE FOR ALLOCATING THE ARRAY!. + * DisplayBreadthFirstSearch(array) - Fills an array with a breadth first search of the elements in the tree. USER IS REPONSIBLE FOR ALLOCATING THE ARRAY!. + * clear - Destroys the tree. Same as calling the destructor + * unsigned int Height() - Returns the height of the tree + * unsigned int size() - returns the size of the BinarySearchTree + * GetPointerToNode(element) - returns a pointer to the comparision element in the tree, allowing for direct modification when necessary with complex data types. + * Be warned, it is possible to corrupt the tree if the element used for comparisons is modified. Returns NULL if the item is not found + * + * + * EXAMPLE + * @code + * BinarySearchTree A; + * A.Add(10); + * A.Add(15); + * A.Add(5); + * int* array = RakNet::OP_NEW(A.Size(), _FILE_AND_LINE_ ); + * A.DisplayInorder(array); + * array[0]; // returns 5 + * array[1]; // returns 10 + * array[2]; // returns 15 + * @endcode + * compress - reallocates memory to fit the number of elements. Best used when the number of elements decreases + * + * clear - empties the BinarySearchTree and returns storage + * The assignment and copy constructors are defined + * + * \note The template type must have the copy constructor and + * assignment operator defined and must work with >, <, and == All + * elements in the tree MUST be distinct The assignment operator is + * defined between BinarySearchTree and AVLBalancedBinarySearchTree + * as long as they are of the same template type. However, passing a + * BinarySearchTree to an AVLBalancedBinarySearchTree will lose its + * structure unless it happened to be AVL balanced to begin with + * Requires queue_linked_list.cpp for the breadth first search used + * in the copy constructor, overloaded assignment operator, and + * display_breadth_first_search. + * + * + */ + template + class RAK_DLL_EXPORT BinarySearchTree + { + + public: + + struct node + { + BinarySearchTreeType* item; + node* left; + node* right; + }; + + BinarySearchTree(); + virtual ~BinarySearchTree(); + BinarySearchTree( const BinarySearchTree& original_type ); + BinarySearchTree& operator= ( const BinarySearchTree& original_copy ); + unsigned int Size( void ); + void Clear( const char *file, unsigned int line ); + unsigned int Height( node* starting_node = 0 ); + node* Add ( const BinarySearchTreeType& input, const char *file, unsigned int line ); + node* Del( const BinarySearchTreeType& input, const char *file, unsigned int line ); + bool IsIn( const BinarySearchTreeType& input ); + void DisplayInorder( BinarySearchTreeType* return_array ); + void DisplayPreorder( BinarySearchTreeType* return_array ); + void DisplayPostorder( BinarySearchTreeType* return_array ); + void DisplayBreadthFirstSearch( BinarySearchTreeType* return_array ); + BinarySearchTreeType*& GetPointerToNode( const BinarySearchTreeType& element ); + + protected: + + node* root; + + enum Direction_Types + { + NOT_FOUND, LEFT, RIGHT, ROOT + } direction; + unsigned int HeightRecursive( node* current ); + unsigned int BinarySearchTree_size; + node*& Find( const BinarySearchTreeType& element, node** parent ); + node*& FindParent( const BinarySearchTreeType& element ); + void DisplayPostorderRecursive( node* current, BinarySearchTreeType* return_array, unsigned int& index ); + void FixTree( node* current ); + + }; + + /// An AVLBalancedBinarySearchTree is a binary tree that is always balanced + template + class RAK_DLL_EXPORT AVLBalancedBinarySearchTree : public BinarySearchTree + { + + public: + AVLBalancedBinarySearchTree() {} + virtual ~AVLBalancedBinarySearchTree(); + void Add ( const BinarySearchTreeType& input ); + void Del( const BinarySearchTreeType& input ); + BinarySearchTree& operator= ( BinarySearchTree& original_copy ) + { + return BinarySearchTree::operator= ( original_copy ); + } + + private: + void BalanceTree( typename BinarySearchTree::node* current, bool rotateOnce ); + void RotateRight( typename BinarySearchTree::node *C ); + void RotateLeft( typename BinarySearchTree::node* C ); + void DoubleRotateRight( typename BinarySearchTree::node *A ); + void DoubleRotateLeft( typename BinarySearchTree::node* A ); + bool RightHigher( typename BinarySearchTree::node* A ); + bool LeftHigher( typename BinarySearchTree::node* A ); + }; + + template + void AVLBalancedBinarySearchTree::BalanceTree( typename BinarySearchTree::node* current, bool rotateOnce ) + { + int left_height, right_height; + + while ( current ) + { + if ( current->left == 0 ) + left_height = 0; + else + left_height = Height( current->left ); + + if ( current->right == 0 ) + right_height = 0; + else + right_height = Height( current->right ); + + if ( right_height - left_height == 2 ) + { + if ( RightHigher( current->right ) ) + RotateLeft( current->right ); + else + DoubleRotateLeft( current ); + + if ( rotateOnce ) + break; + } + + else + if ( right_height - left_height == -2 ) + { + if ( LeftHigher( current->left ) ) + RotateRight( current->left ); + else + DoubleRotateRight( current ); + + if ( rotateOnce ) + break; + } + + if ( current == this->root ) + break; + + current = FindParent( *( current->item ) ); + + } + } + + template + void AVLBalancedBinarySearchTree::Add ( const BinarySearchTreeType& input ) + { + + typename BinarySearchTree::node * current = BinarySearchTree::Add ( input, _FILE_AND_LINE_ ); + BalanceTree( current, true ); + } + + template + void AVLBalancedBinarySearchTree::Del( const BinarySearchTreeType& input ) + { + typename BinarySearchTree::node * current = BinarySearchTree::Del( input, _FILE_AND_LINE_ ); + BalanceTree( current, false ); + + } + + template + bool AVLBalancedBinarySearchTree::RightHigher( typename BinarySearchTree::node *A ) + { + if ( A == 0 ) + return false; + + return Height( A->right ) > Height( A->left ); + } + + template + bool AVLBalancedBinarySearchTree::LeftHigher( typename BinarySearchTree::node *A ) + { + if ( A == 0 ) + return false; + + return Height( A->left ) > Height( A->right ); + } + + template + void AVLBalancedBinarySearchTree::RotateRight( typename BinarySearchTree::node *C ) + { + typename BinarySearchTree::node * A, *B, *D; + /* + RIGHT ROTATION + + A = parent(b) + b= parent(c) + c = node to rotate around + + A + | // Either direction + B + / \ + C + / \ + D + + TO + + A + | // Either Direction + C + / \ + B + / \ + D + + + + + */ + + B = FindParent( *( C->item ) ); + A = FindParent( *( B->item ) ); + D = C->right; + + if ( A ) + { + // Direction was set by the last find_parent call + + if ( this->direction == this->LEFT ) + A->left = C; + else + A->right = C; + } + + else + this->root = C; // If B has no parent parent then B must have been the root node + + B->left = D; + + C->right = B; + } + + template + void AVLBalancedBinarySearchTree::DoubleRotateRight( typename BinarySearchTree::node *A ) + { + // The left side of the left child must be higher for the tree to balance with a right rotation. If it isn't, rotate it left before the normal rotation so it is. + RotateLeft( A->left->right ); + RotateRight( A->left ); + } + + template + void AVLBalancedBinarySearchTree::RotateLeft( typename BinarySearchTree::node *C ) + { + typename BinarySearchTree::node * A, *B, *D; + /* + RIGHT ROTATION + + A = parent(b) + b= parent(c) + c = node to rotate around + + A + | // Either direction + B + / \ + C + / \ + D + + TO + + A + | // Either Direction + C + / \ + B + / \ + D + + + + + */ + + B = FindParent( *( C->item ) ); + A = FindParent( *( B->item ) ); + D = C->left; + + if ( A ) + { + // Direction was set by the last find_parent call + + if ( this->direction == this->LEFT ) + A->left = C; + else + A->right = C; + } + + else + this->root = C; // If B has no parent parent then B must have been the root node + + B->right = D; + + C->left = B; + } + + template + void AVLBalancedBinarySearchTree::DoubleRotateLeft( typename BinarySearchTree::node *A ) + { + // The left side of the right child must be higher for the tree to balance with a left rotation. If it isn't, rotate it right before the normal rotation so it is. + RotateRight( A->right->left ); + RotateLeft( A->right ); + } + + template + AVLBalancedBinarySearchTree::~AVLBalancedBinarySearchTree() + { + this->Clear(_FILE_AND_LINE_); + } + + template + unsigned int BinarySearchTree::Size( void ) + { + return BinarySearchTree_size; + } + + template + unsigned int BinarySearchTree::Height( typename BinarySearchTree::node* starting_node ) + { + if ( BinarySearchTree_size == 0 || starting_node == 0 ) + return 0; + else + return HeightRecursive( starting_node ); + } + + // Recursively return the height of a binary tree + template + unsigned int BinarySearchTree::HeightRecursive( typename BinarySearchTree::node* current ) + { + unsigned int left_height = 0, right_height = 0; + + if ( ( current->left == 0 ) && ( current->right == 0 ) ) + return 1; // Leaf + + if ( current->left != 0 ) + left_height = 1 + HeightRecursive( current->left ); + + if ( current->right != 0 ) + right_height = 1 + HeightRecursive( current->right ); + + if ( left_height > right_height ) + return left_height; + else + return right_height; + } + + template + BinarySearchTree::BinarySearchTree() + { + BinarySearchTree_size = 0; + root = 0; + } + + template + BinarySearchTree::~BinarySearchTree() + { + this->Clear(_FILE_AND_LINE_); + } + + template + BinarySearchTreeType*& BinarySearchTree::GetPointerToNode( const BinarySearchTreeType& element ) + { + static typename BinarySearchTree::node * tempnode; + static BinarySearchTreeType* dummyptr = 0; + tempnode = Find ( element, &tempnode ); + + if ( this->direction == this->NOT_FOUND ) + return dummyptr; + + return tempnode->item; + } + + template + typename BinarySearchTree::node*& BinarySearchTree::Find( const BinarySearchTreeType& element, typename BinarySearchTree::node** parent ) + { + static typename BinarySearchTree::node * current; + + current = this->root; + *parent = 0; + this->direction = this->ROOT; + + if ( BinarySearchTree_size == 0 ) + { + this->direction = this->NOT_FOUND; + return current = 0; + } + + // Check if the item is at the root + if ( element == *( current->item ) ) + { + this->direction = this->ROOT; + return current; + } + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + while ( true ) + { + // Move pointer + + if ( element < *( current->item ) ) + { + *parent = current; + this->direction = this->LEFT; + current = current->left; + } + + else + if ( element > *( current->item ) ) + { + *parent = current; + this->direction = this->RIGHT; + current = current->right; + } + + if ( current == 0 ) + break; + + // Check if new position holds the item + if ( element == *( current->item ) ) + { + return current; + } + } + + + this->direction = this->NOT_FOUND; + return current = 0; + } + + template + typename BinarySearchTree::node*& BinarySearchTree::FindParent( const BinarySearchTreeType& element ) + { + static typename BinarySearchTree::node * parent; + Find ( element, &parent ); + return parent; + } + + // Performs a series of value swaps starting with current to fix the tree if needed + template + void BinarySearchTree::FixTree( typename BinarySearchTree::node* current ) + { + BinarySearchTreeType temp; + + while ( 1 ) + { + if ( ( ( current->left ) != 0 ) && ( *( current->item ) < *( current->left->item ) ) ) + { + // Swap the current value with the one to the left + temp = *( current->left->item ); + *( current->left->item ) = *( current->item ); + *( current->item ) = temp; + current = current->left; + } + + else + if ( ( ( current->right ) != 0 ) && ( *( current->item ) > *( current->right->item ) ) ) + { + // Swap the current value with the one to the right + temp = *( current->right->item ); + *( current->right->item ) = *( current->item ); + *( current->item ) = temp; + current = current->right; + } + + else + break; // current points to the right place so quit + } + } + + template + typename BinarySearchTree::node* BinarySearchTree::Del( const BinarySearchTreeType& input, const char *file, unsigned int line ) + { + typename BinarySearchTree::node * node_to_delete, *current, *parent; + + if ( BinarySearchTree_size == 0 ) + return 0; + + if ( BinarySearchTree_size == 1 ) + { + Clear(file, line); + return 0; + } + + node_to_delete = Find( input, &parent ); + + if ( direction == NOT_FOUND ) + return 0; // Couldn't find the element + + current = node_to_delete; + + // Replace the deleted node with the appropriate value + if ( ( current->right ) == 0 && ( current->left ) == 0 ) // Leaf node, just remove it + { + + if ( parent ) + { + if ( direction == LEFT ) + parent->left = 0; + else + parent->right = 0; + } + + RakNet::OP_DELETE(node_to_delete->item, file, line); + RakNet::OP_DELETE(node_to_delete, file, line); + BinarySearchTree_size--; + return parent; + } + else + if ( ( current->right ) != 0 && ( current->left ) == 0 ) // Node has only one child, delete it and cause the parent to point to that child + { + + if ( parent ) + { + if ( direction == RIGHT ) + parent->right = current->right; + else + parent->left = current->right; + } + + else + root = current->right; // Without a parent this must be the root node + + RakNet::OP_DELETE(node_to_delete->item, file, line); + + RakNet::OP_DELETE(node_to_delete, file, line); + + BinarySearchTree_size--; + + return parent; + } + else + if ( ( current->right ) == 0 && ( current->left ) != 0 ) // Node has only one child, delete it and cause the parent to point to that child + { + + if ( parent ) + { + if ( direction == RIGHT ) + parent->right = current->left; + else + parent->left = current->left; + } + + else + root = current->left; // Without a parent this must be the root node + + RakNet::OP_DELETE(node_to_delete->item, file, line); + + RakNet::OP_DELETE(node_to_delete, file, line); + + BinarySearchTree_size--; + + return parent; + } + else // Go right, then as left as far as you can + { + parent = current; + direction = RIGHT; + current = current->right; // Must have a right branch because the if statements above indicated that it has 2 branches + + while ( current->left ) + { + direction = LEFT; + parent = current; + current = current->left; + } + + // Replace the value held by the node to RakNet::OP_DELETE(with the value pointed to by current, _FILE_AND_LINE_); + *( node_to_delete->item ) = *( current->item ); + + // Delete current. + // If it is a leaf node just delete it + if ( current->right == 0 ) + { + if ( direction == RIGHT ) + parent->right = 0; + else + parent->left = 0; + + RakNet::OP_DELETE(current->item, file, line); + + RakNet::OP_DELETE(current, file, line); + + BinarySearchTree_size--; + + return parent; + } + + else + { + // Skip this node and make its parent point to its right branch + + if ( direction == RIGHT ) + parent->right = current->right; + else + parent->left = current->right; + + RakNet::OP_DELETE(current->item, file, line); + + RakNet::OP_DELETE(current, file, line); + + BinarySearchTree_size--; + + return parent; + } + } + } + + template + typename BinarySearchTree::node* BinarySearchTree::Add ( const BinarySearchTreeType& input, const char *file, unsigned int line ) + { + typename BinarySearchTree::node * current; + + // Add the new element to the tree according to the following alogrithm: + // 1. If the current node is empty add the new leaf + // 2. If the element is less than the current node then go down the left branch + // 3. If the element is greater than the current node then go down the right branch + + if ( BinarySearchTree_size == 0 ) + { + BinarySearchTree_size = 1; + root = RakNet::OP_NEW( file, line ); + root->item = RakNet::OP_NEW( file, line ); + *( root->item ) = input; + root->left = 0; + root->right = 0; + + return root; + } + + else + { + // start at the root + current = root; + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + while ( true ) // This loop traverses the tree to find a spot for insertion + { + + if ( input < *( current->item ) ) + { + if ( current->left == 0 ) + { + current->left = RakNet::OP_NEW( file, line ); + current->left->item = RakNet::OP_NEW( file, line ); + current = current->left; + current->left = 0; + current->right = 0; + *( current->item ) = input; + + BinarySearchTree_size++; + return current; + } + + else + { + current = current->left; + } + } + + else + if ( input > *( current->item ) ) + { + if ( current->right == 0 ) + { + current->right = RakNet::OP_NEW( file, line ); + current->right->item = RakNet::OP_NEW( file, line ); + current = current->right; + current->left = 0; + current->right = 0; + *( current->item ) = input; + + BinarySearchTree_size++; + return current; + } + + else + { + current = current->right; + } + } + + else + return 0; // ((input == current->item) == true) which is not allowed since the tree only takes discrete values. Do nothing + } + } + } + + template + bool BinarySearchTree::IsIn( const BinarySearchTreeType& input ) + { + typename BinarySearchTree::node * parent; + find( input, &parent ); + + if ( direction != NOT_FOUND ) + return true; + else + return false; + } + + + template + void BinarySearchTree::DisplayInorder( BinarySearchTreeType* return_array ) + { + typename BinarySearchTree::node * current, *parent; + bool just_printed = false; + + unsigned int index = 0; + + current = root; + + if ( BinarySearchTree_size == 0 ) + return ; // Do nothing for an empty tree + + else + if ( BinarySearchTree_size == 1 ) + { + return_array[ 0 ] = *( root->item ); + return ; + } + + + direction = ROOT; // Reset the direction + + while ( index != BinarySearchTree_size ) + { + // direction is set by the find function and holds the direction of the parent to the last node visited. It is used to prevent revisiting nodes + + if ( ( current->left != 0 ) && ( direction != LEFT ) && ( direction != RIGHT ) ) + { + // Go left if the following 2 conditions are true + // I can go left + // I did not just move up from a right child + // I did not just move up from a left child + + current = current->left; + direction = ROOT; // Reset the direction + } + + else + if ( ( direction != RIGHT ) && ( just_printed == false ) ) + { + // Otherwise, print the current node if the following 3 conditions are true: + // I did not just move up from a right child + // I did not print this ndoe last cycle + + return_array[ index++ ] = *( current->item ); + just_printed = true; + } + + else + if ( ( current->right != 0 ) && ( direction != RIGHT ) ) + { + // Otherwise, go right if the following 2 conditions are true + // I did not just move up from a right child + // I can go right + + current = current->right; + direction = ROOT; // Reset the direction + just_printed = false; + } + + else + { + // Otherwise I've done everything I can. Move up the tree one node + parent = FindParent( *( current->item ) ); + current = parent; + just_printed = false; + } + } + } + + template + void BinarySearchTree::DisplayPreorder( BinarySearchTreeType* return_array ) + { + typename BinarySearchTree::node * current, *parent; + + unsigned int index = 0; + + current = root; + + if ( BinarySearchTree_size == 0 ) + return ; // Do nothing for an empty tree + + else + if ( BinarySearchTree_size == 1 ) + { + return_array[ 0 ] = *( root->item ); + return ; + } + + + direction = ROOT; // Reset the direction + return_array[ index++ ] = *( current->item ); + + while ( index != BinarySearchTree_size ) + { + // direction is set by the find function and holds the direction of the parent to the last node visited. It is used to prevent revisiting nodes + + if ( ( current->left != 0 ) && ( direction != LEFT ) && ( direction != RIGHT ) ) + { + + current = current->left; + direction = ROOT; + + // Everytime you move a node print it + return_array[ index++ ] = *( current->item ); + } + + else + if ( ( current->right != 0 ) && ( direction != RIGHT ) ) + { + current = current->right; + direction = ROOT; + + // Everytime you move a node print it + return_array[ index++ ] = *( current->item ); + } + + else + { + // Otherwise I've done everything I can. Move up the tree one node + parent = FindParent( *( current->item ) ); + current = parent; + } + } + } + + template + inline void BinarySearchTree::DisplayPostorder( BinarySearchTreeType* return_array ) + { + unsigned int index = 0; + + if ( BinarySearchTree_size == 0 ) + return ; // Do nothing for an empty tree + + else + if ( BinarySearchTree_size == 1 ) + { + return_array[ 0 ] = *( root->item ); + return ; + } + + DisplayPostorderRecursive( root, return_array, index ); + } + + + // Recursively do a postorder traversal + template + void BinarySearchTree::DisplayPostorderRecursive( typename BinarySearchTree::node* current, BinarySearchTreeType* return_array, unsigned int& index ) + { + if ( current->left != 0 ) + DisplayPostorderRecursive( current->left, return_array, index ); + + if ( current->right != 0 ) + DisplayPostorderRecursive( current->right, return_array, index ); + + return_array[ index++ ] = *( current->item ); + + } + + + template + void BinarySearchTree::DisplayBreadthFirstSearch( BinarySearchTreeType* return_array ) + { + typename BinarySearchTree::node * current; + unsigned int index = 0; + + // Display the tree using a breadth first search + // Put the children of the current node into the queue + // Pop the queue, put its children into the queue, repeat until queue is empty + + if ( BinarySearchTree_size == 0 ) + return ; // Do nothing for an empty tree + + else + if ( BinarySearchTree_size == 1 ) + { + return_array[ 0 ] = *( root->item ); + return ; + } + + else + { + DataStructures::QueueLinkedList tree_queue; + + // Add the root of the tree I am copying from + tree_queue.Push( root ); + + do + { + current = tree_queue.Pop(); + return_array[ index++ ] = *( current->item ); + + // Add the child or children of the tree I am copying from to the queue + + if ( current->left != 0 ) + tree_queue.Push( current->left ); + + if ( current->right != 0 ) + tree_queue.Push( current->right ); + + } + + while ( tree_queue.Size() > 0 ); + } + } + + + template + BinarySearchTree::BinarySearchTree( const BinarySearchTree& original_copy ) + { + typename BinarySearchTree::node * current; + // Copy the tree using a breadth first search + // Put the children of the current node into the queue + // Pop the queue, put its children into the queue, repeat until queue is empty + + // This is a copy of the constructor. A bug in Visual C++ made it so if I just put the constructor call here the variable assignments were ignored. + BinarySearchTree_size = 0; + root = 0; + + if ( original_copy.BinarySearchTree_size == 0 ) + { + BinarySearchTree_size = 0; + } + + else + { + DataStructures::QueueLinkedList tree_queue; + + // Add the root of the tree I am copying from + tree_queue.Push( original_copy.root ); + + do + { + current = tree_queue.Pop(); + + Add ( *( current->item ), _FILE_AND_LINE_ ) + + ; + + // Add the child or children of the tree I am copying from to the queue + if ( current->left != 0 ) + tree_queue.Push( current->left ); + + if ( current->right != 0 ) + tree_queue.Push( current->right ); + + } + + while ( tree_queue.Size() > 0 ); + } + } + + template + BinarySearchTree& BinarySearchTree::operator= ( const BinarySearchTree& original_copy ) + { + typename BinarySearchTree::node * current; + + if ( ( &original_copy ) == this ) + return *this; + + Clear( _FILE_AND_LINE_ ); // Remove the current tree + + // This is a copy of the constructor. A bug in Visual C++ made it so if I just put the constructor call here the variable assignments were ignored. + BinarySearchTree_size = 0; + + root = 0; + + + // Copy the tree using a breadth first search + // Put the children of the current node into the queue + // Pop the queue, put its children into the queue, repeat until queue is empty + if ( original_copy.BinarySearchTree_size == 0 ) + { + BinarySearchTree_size = 0; + } + + else + { + DataStructures::QueueLinkedList tree_queue; + + // Add the root of the tree I am copying from + tree_queue.Push( original_copy.root ); + + do + { + current = tree_queue.Pop(); + + Add ( *( current->item ), _FILE_AND_LINE_ ) + + ; + + // Add the child or children of the tree I am copying from to the queue + if ( current->left != 0 ) + tree_queue.Push( current->left ); + + if ( current->right != 0 ) + tree_queue.Push( current->right ); + + } + + while ( tree_queue.Size() > 0 ); + } + + return *this; + } + + template + inline void BinarySearchTree::Clear ( const char *file, unsigned int line ) + { + typename BinarySearchTree::node * current, *parent; + + current = root; + + while ( BinarySearchTree_size > 0 ) + { + if ( BinarySearchTree_size == 1 ) + { + RakNet::OP_DELETE(root->item, file, line); + RakNet::OP_DELETE(root, file, line); + root = 0; + BinarySearchTree_size = 0; + } + + else + { + if ( current->left != 0 ) + { + current = current->left; + } + + else + if ( current->right != 0 ) + { + current = current->right; + } + + else // leaf + { + // Not root node so must have a parent + parent = FindParent( *( current->item ) ); + + if ( ( parent->left ) == current ) + parent->left = 0; + else + parent->right = 0; + + RakNet::OP_DELETE(current->item, file, line); + + RakNet::OP_DELETE(current, file, line); + + current = parent; + + BinarySearchTree_size--; + } + } + } + } + +} // End namespace + +#endif + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif diff --git a/include/raknet/DS_BytePool.hpp b/include/raknet/DS_BytePool.hpp new file mode 100644 index 0000000..499dd3e --- /dev/null +++ b/include/raknet/DS_BytePool.hpp @@ -0,0 +1,54 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_BytePool.h +/// + + +#ifndef __BYTE_POOL_H +#define __BYTE_POOL_H + +#include "RakMemoryOverride.hpp" +#include "DS_MemoryPool.hpp" +#include "Export.hpp" +#include "SimpleMutex.hpp" +#include "RakAssert.hpp" + +// #define _DISABLE_BYTE_POOL +// #define _THREADSAFE_BYTE_POOL + +namespace DataStructures +{ + // Allocate some number of bytes from pools. Uses the heap if necessary. + class RAK_DLL_EXPORT BytePool + { + public: + BytePool(); + ~BytePool(); + // Should be at least 8 times bigger than 8192 + void SetPageSize(int size); + unsigned char* Allocate(int bytesWanted, const char *file, unsigned int line); + void Release(unsigned char *data, const char *file, unsigned int line); + void Clear(const char *file, unsigned int line); + protected: + MemoryPool pool128; + MemoryPool pool512; + MemoryPool pool2048; + MemoryPool pool8192; +#ifdef _THREADSAFE_BYTE_POOL + SimpleMutex mutex128; + SimpleMutex mutex512; + SimpleMutex mutex2048; + SimpleMutex mutex8192; +#endif + }; +} + +#endif diff --git a/include/raknet/DS_ByteQueue.hpp b/include/raknet/DS_ByteQueue.hpp new file mode 100644 index 0000000..54488e6 --- /dev/null +++ b/include/raknet/DS_ByteQueue.hpp @@ -0,0 +1,47 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_ByteQueue.h +/// \internal +/// \brief Byte queue +/// + + +#ifndef __BYTE_QUEUE_H +#define __BYTE_QUEUE_H + +#include "RakMemoryOverride.hpp" +#include "Export.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + class ByteQueue + { + public: + ByteQueue(); + ~ByteQueue(); + void WriteBytes(const char *in, unsigned length, const char *file, unsigned int line); + bool ReadBytes(char *out, unsigned maxLengthToRead, bool peek); + unsigned GetBytesWritten(void) const; + char* PeekContiguousBytes(unsigned int *outLength) const; + void IncrementReadOffset(unsigned length); + void DecrementReadOffset(unsigned length); + void Clear(const char *file, unsigned int line); + void Print(void); + + protected: + char *data; + unsigned readOffset, writeOffset, lengthAllocated; + }; +} + +#endif diff --git a/include/raknet/DS_Hash.hpp b/include/raknet/DS_Hash.hpp new file mode 100644 index 0000000..06a5112 --- /dev/null +++ b/include/raknet/DS_Hash.hpp @@ -0,0 +1,357 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \internal +/// \brief Hashing container +/// + + +#ifndef __HASH_H +#define __HASH_H + +#include "RakAssert.hpp" +#include // memmove +#include "Export.hpp" +#include "RakMemoryOverride.hpp" +#include "RakString.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + struct HashIndex + { + unsigned int primaryIndex; + unsigned int secondaryIndex; + bool IsInvalid(void) const {return primaryIndex==(unsigned int) -1;} + void SetInvalid(void) {primaryIndex=(unsigned int) -1; secondaryIndex=(unsigned int) -1;} + }; + + /// \brief Using a string as a identifier for a node, store an allocated pointer to that node + template + class RAK_DLL_EXPORT Hash + { + public: + /// Default constructor + Hash(); + + // Destructor + ~Hash(); + + void Push(key_type key, const data_type &input, const char *file, unsigned int line ); + data_type* Peek(key_type key ); + bool Pop(data_type& out, key_type key, const char *file, unsigned int line ); + bool RemoveAtIndex(HashIndex index, const char *file, unsigned int line ); + bool Remove(key_type key, const char *file, unsigned int line ); + HashIndex GetIndexOf(key_type key); + bool HasData(key_type key); + data_type& ItemAtIndex(const HashIndex &index); + key_type KeyAtIndex(const HashIndex &index); + void GetAsList(DataStructures::List &itemList,DataStructures::List &keyList,const char *file, unsigned int line) const; + unsigned int Size(void) const; + + /// \brief Clear the list + void Clear( const char *file, unsigned int line ); + + struct Node + { + Node(key_type strIn, const data_type &_data) {string=strIn; data=_data;} + key_type string; + data_type data; + // Next in the list for this key + Node *next; + }; + + protected: + void ClearIndex(unsigned int index,const char *file, unsigned int line); + Node **nodeList; + unsigned int size; + }; + + template + Hash::Hash() + { + nodeList=0; + size=0; + } + + template + Hash::~Hash() + { + Clear(_FILE_AND_LINE_); + } + + template + void Hash::Push(key_type key, const data_type &input, const char *file, unsigned int line ) + { + unsigned long hashIndex = (*hashFunction)(key) % HASH_SIZE; + if (nodeList==0) + { + nodeList=RakNet::OP_NEW_ARRAY(HASH_SIZE,file,line); + memset(nodeList,0,sizeof(Node *)*HASH_SIZE); + } + + Node *newNode=RakNet::OP_NEW_2(file,line,key,input); + newNode->next=nodeList[hashIndex]; + nodeList[hashIndex]=newNode; + + size++; + } + + template + data_type* Hash::Peek(key_type key ) + { + if (nodeList==0) + return 0; + + unsigned long hashIndex = (*hashFunction)(key) % HASH_SIZE; + Node *node = nodeList[hashIndex]; + while (node!=0) + { + if (node->string==key) + return &node->data; + node=node->next; + } + return 0; + } + + template + bool Hash::Pop(data_type& out, key_type key, const char *file, unsigned int line ) + { + if (nodeList==0) + return false; + + unsigned long hashIndex = (*hashFunction)(key) % HASH_SIZE; + Node *node = nodeList[hashIndex]; + if (node==0) + return false; + if (node->next==0) + { + // Only one item. + if (node->string==key) + { + // Delete last item + out=node->data; + ClearIndex(hashIndex,_FILE_AND_LINE_); + return true; + } + else + { + // Single item doesn't match + return false; + } + } + else if (node->string==key) + { + // First item does match, but more than one item + out=node->data; + nodeList[hashIndex]=node->next; + RakNet::OP_DELETE(node,file,line); + size--; + return true; + } + + Node *last=node; + node=node->next; + + while (node!=0) + { + // First item does not match, but subsequent item might + if (node->string==key) + { + out=node->data; + // Skip over subsequent item + last->next=node->next; + // Delete existing item + RakNet::OP_DELETE(node,file,line); + size--; + return true; + } + last=node; + node=node->next; + } + return false; + } + + template + bool Hash::RemoveAtIndex(HashIndex index, const char *file, unsigned int line ) + { + if (index.IsInvalid()) + return false; + + Node *node = nodeList[index.primaryIndex]; + if (node==0) + return false; + if (node->next==0) + { + // Delete last item + ClearIndex(index.primaryIndex,file,line); + return true; + } + else if (index.secondaryIndex==0) + { + // First item does match, but more than one item + nodeList[index.primaryIndex]=node->next; + RakNet::OP_DELETE(node,file,line); + size--; + return true; + } + + Node *last=node; + node=node->next; + --index.secondaryIndex; + + while (index.secondaryIndex!=0) + { + last=node; + node=node->next; + --index.secondaryIndex; + } + + // Skip over subsequent item + last->next=node->next; + // Delete existing item + RakNet::OP_DELETE(node,file,line); + size--; + return true; + } + + template + bool Hash::Remove(key_type key, const char *file, unsigned int line ) + { + return RemoveAtIndex(GetIndexOf(key),file,line); + } + + template + HashIndex Hash::GetIndexOf(key_type key) + { + if (nodeList==0) + { + HashIndex temp; + temp.SetInvalid(); + return temp; + } + HashIndex idx; + idx.primaryIndex=(*hashFunction)(key) % HASH_SIZE; + Node *node = nodeList[idx.primaryIndex]; + if (node==0) + { + idx.SetInvalid(); + return idx; + } + idx.secondaryIndex=0; + while (node!=0) + { + if (node->string==key) + { + return idx; + } + node=node->next; + idx.secondaryIndex++; + } + + idx.SetInvalid(); + return idx; + } + + template + bool Hash::HasData(key_type key) + { + return GetIndexOf(key).IsInvalid()==false; + } + + template + data_type& Hash::ItemAtIndex(const HashIndex &index) + { + Node *node = nodeList[index.primaryIndex]; + RakAssert(node); + unsigned int i; + for (i=0; i < index.secondaryIndex; i++) + { + node=node->next; + RakAssert(node); + } + return node->data; + } + + template + key_type Hash::KeyAtIndex(const HashIndex &index) + { + Node *node = nodeList[index.primaryIndex]; + RakAssert(node); + unsigned int i; + for (i=0; i < index.secondaryIndex; i++) + { + node=node->next; + RakAssert(node); + } + return node->string; + } + + template + void Hash::Clear(const char *file, unsigned int line) + { + if (nodeList) + { + unsigned int i; + for (i=0; i < HASH_SIZE; i++) + ClearIndex(i,file,line); + RakNet::OP_DELETE_ARRAY(nodeList,file,line); + nodeList=0; + size=0; + } + } + + template + void Hash::ClearIndex(unsigned int index,const char *file, unsigned int line) + { + Node *node = nodeList[index]; + Node *next; + while (node) + { + next=node->next; + RakNet::OP_DELETE(node,file,line); + node=next; + size--; + } + nodeList[index]=0; + } + + template + void Hash::GetAsList(DataStructures::List &itemList,DataStructures::List &keyList,const char *file, unsigned int line) const + { + if (nodeList==0) + return; + itemList.Clear(false,_FILE_AND_LINE_); + keyList.Clear(false,_FILE_AND_LINE_); + + Node *node; + unsigned int i; + for (i=0; i < HASH_SIZE; i++) + { + if (nodeList[i]) + { + node=nodeList[i]; + while (node) + { + itemList.Push(node->data,file,line); + keyList.Push(node->string,file,line); + node=node->next; + } + } + } + } + template + unsigned int Hash::Size(void) const + { + return size; + } +} +#endif diff --git a/include/raknet/DS_Heap.hpp b/include/raknet/DS_Heap.hpp new file mode 100644 index 0000000..aaa04a0 --- /dev/null +++ b/include/raknet/DS_Heap.hpp @@ -0,0 +1,305 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_Heap.h +/// \internal +/// \brief Heap (Also serves as a priority queue) +/// + + + +#ifndef __RAKNET_HEAP_H +#define __RAKNET_HEAP_H + +#include "RakMemoryOverride.hpp" +#include "DS_List.hpp" +#include "Export.hpp" +#include "RakAssert.hpp" + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + template + class RAK_DLL_EXPORT Heap + { + public: + struct HeapNode + { + HeapNode() {} + HeapNode(const weight_type &w, const data_type &d) : weight(w), data(d) {} + weight_type weight; // I'm assuming key is a native numerical type - float or int + data_type data; + }; + + Heap(); + ~Heap(); + void Push(const weight_type &weight, const data_type &data, const char *file, unsigned int line); + /// Call before calling PushSeries, for a new series of items + void StartSeries(void) {optimizeNextSeriesPush=false;} + /// If you are going to push a list of items, where the weights of the items on the list are in order and follow the heap order, PushSeries is faster than Push() + void PushSeries(const weight_type &weight, const data_type &data, const char *file, unsigned int line); + data_type Pop(const unsigned startingIndex); + data_type Peek(const unsigned startingIndex=0) const; + weight_type PeekWeight(const unsigned startingIndex=0) const; + void Clear(bool doNotDeallocateSmallBlocks, const char *file, unsigned int line); + data_type& operator[] ( const unsigned int position ) const; + unsigned Size(void) const; + + protected: + unsigned LeftChild(const unsigned i) const; + unsigned RightChild(const unsigned i) const; + unsigned Parent(const unsigned i) const; + void Swap(const unsigned i, const unsigned j); + DataStructures::List heap; + bool optimizeNextSeriesPush; + }; + + template + Heap::Heap() + { + optimizeNextSeriesPush=false; + } + + template + Heap::~Heap() + { + //Clear(true, _FILE_AND_LINE_); + } + + template + void Heap::PushSeries(const weight_type &weight, const data_type &data, const char *file, unsigned int line) + { + if (optimizeNextSeriesPush==false) + { + // If the weight of what we are inserting is greater than / less than in order of the heap of every sibling and sibling of parent, then can optimize next push + unsigned currentIndex = heap.Size(); + unsigned parentIndex; + if (currentIndex>0) + { + for (parentIndex = Parent(currentIndex); parentIndex < currentIndex; parentIndex++) + { +#ifdef _MSC_VER +#pragma warning(disable:4127) // conditional expression is constant +#endif + if (isMaxHeap) + { + // Every child is less than its parent + if (weight>heap[parentIndex].weight) + { + // Can't optimize + Push(weight,data,file,line); + return; + } + } + else + { + // Every child is greater than than its parent + if (weight + void Heap::Push(const weight_type &weight, const data_type &data, const char *file, unsigned int line) + { + unsigned currentIndex = heap.Size(); + unsigned parentIndex; + heap.Insert(HeapNode(weight, data), file, line); + while (currentIndex!=0) + { + parentIndex = Parent(currentIndex); +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + if (isMaxHeap) + { + if (heap[parentIndex].weight < weight) + { + Swap(currentIndex, parentIndex); + currentIndex=parentIndex; + } + else + break; + } + else + { + if (heap[parentIndex].weight > weight) + { + Swap(currentIndex, parentIndex); + currentIndex=parentIndex; + } + else + break; + } + } + } + + template + data_type Heap::Pop(const unsigned startingIndex) + { + // While we have children, swap out with the larger of the two children. + + // This line will assert on an empty heap + data_type returnValue=heap[startingIndex].data; + + // Move the last element to the head, and re-heapify + heap[startingIndex]=heap[heap.Size()-1]; + + unsigned currentIndex,leftChild,rightChild; + weight_type currentWeight; + currentIndex=startingIndex; + currentWeight=heap[startingIndex].weight; + heap.RemoveFromEnd(); + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + while (1) + { + leftChild=LeftChild(currentIndex); + rightChild=RightChild(currentIndex); + if (leftChild >= heap.Size()) + { + // Done + return returnValue; + } + if (rightChild >= heap.Size()) + { + // Only left node. + if ((isMaxHeap==true && currentWeight < heap[leftChild].weight) || + (isMaxHeap==false && currentWeight > heap[leftChild].weight)) + Swap(leftChild, currentIndex); + + return returnValue; + } + else + { + // Swap with the bigger/smaller of the two children and continue + if (isMaxHeap) + { + if (heap[leftChild].weight <= currentWeight && heap[rightChild].weight <= currentWeight) + return returnValue; + + if (heap[leftChild].weight > heap[rightChild].weight) + { + Swap(leftChild, currentIndex); + currentIndex=leftChild; + } + else + { + Swap(rightChild, currentIndex); + currentIndex=rightChild; + } + } + else + { + if (heap[leftChild].weight >= currentWeight && heap[rightChild].weight >= currentWeight) + return returnValue; + + if (heap[leftChild].weight < heap[rightChild].weight) + { + Swap(leftChild, currentIndex); + currentIndex=leftChild; + } + else + { + Swap(rightChild, currentIndex); + currentIndex=rightChild; + } + } + } + } + } + + template + inline data_type Heap::Peek(const unsigned startingIndex) const + { + return heap[startingIndex].data; + } + + template + inline weight_type Heap::PeekWeight(const unsigned startingIndex) const + { + return heap[startingIndex].weight; + } + + template + void Heap::Clear(bool doNotDeallocateSmallBlocks, const char *file, unsigned int line) + { + heap.Clear(doNotDeallocateSmallBlocks, file, line); + } + + template + inline data_type& Heap::operator[] ( const unsigned int position ) const + { + return heap[position].data; + } + template + unsigned Heap::Size(void) const + { + return heap.Size(); + } + + template + inline unsigned Heap::LeftChild(const unsigned i) const + { + return i*2+1; + } + + template + inline unsigned Heap::RightChild(const unsigned i) const + { + return i*2+2; + } + + template + inline unsigned Heap::Parent(const unsigned i) const + { +#ifdef _DEBUG + RakAssert(i!=0); +#endif + return (i-1)/2; + } + + template + void Heap::Swap(const unsigned i, const unsigned j) + { + HeapNode temp; + temp=heap[i]; + heap[i]=heap[j]; + heap[j]=temp; + } +} + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif diff --git a/include/raknet/DS_HuffmanEncodingTree.hpp b/include/raknet/DS_HuffmanEncodingTree.hpp new file mode 100644 index 0000000..db78ad6 --- /dev/null +++ b/include/raknet/DS_HuffmanEncodingTree.hpp @@ -0,0 +1,74 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_HuffmanEncodingTree.h +/// \brief \b [Internal] Generates a huffman encoding tree, used for string and global compression. +/// + + +#ifndef __HUFFMAN_ENCODING_TREE +#define __HUFFMAN_ENCODING_TREE + +#include "RakMemoryOverride.hpp" +#include "DS_HuffmanEncodingTreeNode.hpp" +#include "BitStream.hpp" +#include "Export.hpp" +#include "DS_LinkedList.hpp" + +namespace RakNet +{ + +/// This generates special cases of the huffman encoding tree using 8 bit keys with the additional condition that unused combinations of 8 bits are treated as a frequency of 1 +class RAK_DLL_EXPORT HuffmanEncodingTree +{ + +public: + HuffmanEncodingTree(); + ~HuffmanEncodingTree(); + + /// \brief Pass an array of bytes to array and a preallocated BitStream to receive the output. + /// \param [in] input Array of bytes to encode + /// \param [in] sizeInBytes size of \a input + /// \param [out] output The bitstream to write to + void EncodeArray( unsigned char *input, size_t sizeInBytes, RakNet::BitStream * output ); + + // \brief Decodes an array encoded by EncodeArray(). + unsigned DecodeArray( RakNet::BitStream * input, BitSize_t sizeInBits, size_t maxCharsToWrite, unsigned char *output ); + void DecodeArray( unsigned char *input, BitSize_t sizeInBits, RakNet::BitStream * output ); + + /// \brief Given a frequency table of 256 elements, all with a frequency of 1 or more, generate the tree. + void GenerateFromFrequencyTable( unsigned int frequencyTable[ 256 ] ); + + /// \brief Free the memory used by the tree. + void FreeMemory( void ); + +private: + + /// The root node of the tree + + HuffmanEncodingTreeNode *root; + + /// Used to hold bit encoding for one character + + + struct CharacterEncoding + { + unsigned char* encoding; + unsigned short bitLength; + }; + + CharacterEncoding encodingTable[ 256 ]; + + void InsertNodeIntoSortedList( HuffmanEncodingTreeNode * node, DataStructures::LinkedList *huffmanEncodingTreeNodeList ) const; +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/DS_HuffmanEncodingTreeFactory.hpp b/include/raknet/DS_HuffmanEncodingTreeFactory.hpp new file mode 100644 index 0000000..f70826e --- /dev/null +++ b/include/raknet/DS_HuffmanEncodingTreeFactory.hpp @@ -0,0 +1,64 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_HuffmanEncodingTreeFactory.h +/// \internal +/// \brief Creates instances of the class HuffmanEncodingTree +/// + + +#ifndef __HUFFMAN_ENCODING_TREE_FACTORY +#define __HUFFMAN_ENCODING_TREE_FACTORY + +#include "RakMemoryOverride.hpp" + +namespace RakNet { +/// Forward declarations +class HuffmanEncodingTree; + +/// \brief Creates instances of the class HuffmanEncodingTree +/// \details This class takes a frequency table and given that frequence table, will generate an instance of HuffmanEncodingTree +class HuffmanEncodingTreeFactory +{ +public: + /// Default constructor + HuffmanEncodingTreeFactory(); + + /// \brief Reset the frequency table. + /// \details You don't need to call this unless you want to reuse the class for a new tree + void Reset( void ); + + /// \brief Pass an array of bytes to this to add those elements to the frequency table. + /// \param[in] array the data to insert into the frequency table + /// \param[in] size the size of the data to insert + void AddToFrequencyTable( unsigned char *array, int size ); + + /// \brief Copies the frequency table to the array passed. Retrieve the frequency table. + /// \param[in] _frequency The frequency table used currently + void GetFrequencyTable( unsigned int _frequency[ 256 ] ); + + /// \brief Returns the frequency table as a pointer. + /// \return the address of the frenquency table + unsigned int * GetFrequencyTable( void ); + + /// \brief Generate a HuffmanEncodingTree. + /// \details You can also use GetFrequencyTable and GenerateFromFrequencyTable in the tree itself + /// \return The generated instance of HuffmanEncodingTree + HuffmanEncodingTree * GenerateTree( void ); + +private: + + /// Frequency table + unsigned int frequency[ 256 ]; +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/DS_HuffmanEncodingTreeNode.hpp b/include/raknet/DS_HuffmanEncodingTreeNode.hpp new file mode 100644 index 0000000..71e5261 --- /dev/null +++ b/include/raknet/DS_HuffmanEncodingTreeNode.hpp @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] A single node in the Huffman Encoding Tree. +/// + +#ifndef __HUFFMAN_ENCODING_TREE_NODE +#define __HUFFMAN_ENCODING_TREE_NODE + +struct HuffmanEncodingTreeNode +{ + unsigned char value; + unsigned weight; + HuffmanEncodingTreeNode *left; + HuffmanEncodingTreeNode *right; + HuffmanEncodingTreeNode *parent; +}; + +#endif diff --git a/include/raknet/DS_LinkedList.hpp b/include/raknet/DS_LinkedList.hpp new file mode 100644 index 0000000..2daf0c8 --- /dev/null +++ b/include/raknet/DS_LinkedList.hpp @@ -0,0 +1,1257 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_LinkedList.h +/// \internal +/// \brief Straightforward linked list data structure. +/// + + +#ifndef __LINKED_LIST_H +#define __LINKED_LIST_H + +#include "Export.hpp" +#include "RakMemoryOverride.hpp" + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + // Prototype to prevent error in CircularLinkedList class when a reference is made to a LinkedList class + template + class RAK_DLL_EXPORT LinkedList; + + /** + * \brief (Circular) Linked List ADT (Doubly Linked Pointer to Node Style) - + * + * \details + * Initilize with the following command + * LinkedList + * OR + * CircularLinkedList + * + * Has the following member functions + * - size: returns number of elements in the linked list + * - insert(item): inserts @em item at the current position in + * the LinkedList. + * - add(item): inserts @em item after the current position in + * the LinkedList. Does not increment the position + * - replace(item): replaces the element at the current position @em item. + * - peek: returns the element at the current position + * - pop: returns the element at the current position and deletes it + * - del: deletes the current element. Does nothing for an empty list. + * - clear: empties the LinkedList and returns storage + * - bool IsInitem): Does a linear search for @em item. Does not set + * the position to it, only returns true on item found, false otherwise + * - bool find(item): Does a linear search for @em item and sets the current + * position to point to it if and only if the item is found. Returns true + * on item found, false otherwise + * - sort: Sorts the elements of the list with a mergesort and sets the + * current pointer to the first element + * - concatenate(list L): This appends L to the current list + * - ++(prefix): moves the pointer one element up in the list and returns the + * appropriate copy of the element in the list + * - --(prefix): moves the pointer one element back in the list and returns + * the appropriate copy of the element in the list + * - beginning - moves the pointer to the start of the list. For circular + * linked lists this is first 'position' created. You should call this + * after the sort function to read the first value. + * - end - moves the pointer to the end of the list. For circular linked + * lists this is one less than the first 'position' created + * The assignment and copy constructor operators are defined + * + * \note + * 1. LinkedList and CircularLinkedList are exactly the same except LinkedList + * won't let you wrap around the root and lets you jump to two positions + * relative to the root/ + * 2. Postfix ++ and -- can be used but simply call the prefix versions. + * + * + * EXAMPLE: + * @code + * LinkedList A; // Creates a Linked List of integers called A + * CircularLinkedList B; // Creates a Circular Linked List of + * // integers called B + * + * A.Insert(20); // Adds 20 to A. A: 20 - current is 20 + * A.Insert(5); // Adds 5 to A. A: 5 20 - current is 5 + * A.Insert(1); // Adds 1 to A. A: 1 5 20 - current is 1 + * + * A.IsIn1); // returns true + * A.IsIn200); // returns false + * A.Find(5); // returns true and sets current to 5 + * A.Peek(); // returns 5 + * A.Find(1); // returns true and sets current to 1 + * + * (++A).Peek(); // Returns 5 + * A.Peek(); // Returns 5 + * + * A.Replace(10); // Replaces 5 with 10. + * A.Peek(); // Returns 10 + * + * A.Beginning(); // Current points to the beginning of the list at 1 + * + * (++A).Peek(); // Returns 5 + * A.Peek(); // Returns 10 + * + * A.Del(); // Deletes 10. Current points to the next element, which is 20 + * A.Peek(); // Returns 20 + * + * A.Beginning(); // Current points to the beginning of the list at 1 + * + * (++A).Peek(); // Returns 5 + * A.Peek(); // Returns 20 + * + * A.Clear(_FILE_AND_LINE_); // Deletes all nodes in A + * + * A.Insert(5); // A: 5 - current is 5 + * A.Insert(6); // A: 6 5 - current is 6 + * A.Insert(7); // A: 7 6 5 - current is 7 + * + * A.Clear(_FILE_AND_LINE_); + * B.Clear(_FILE_AND_LINE_); + * + * B.Add(10); + * B.Add(20); + * B.Add(30); + * B.Add(5); + * B.Add(2); + * B.Add(25); + * // Sorts the numbers in the list and sets the current pointer to the + * // first element + * B.sort(); + * + * // Postfix ++ just calls the prefix version and has no functional + * // difference. + * B.Peek(); // Returns 2 + * B++; + * B.Peek(); // Returns 5 + * B++; + * B.Peek(); // Returns 10 + * B++; + * B.Peek(); // Returns 20 + * B++; + * B.Peek(); // Returns 25 + * B++; + * B.Peek(); // Returns 30 + * @endcode + */ + template + + class CircularLinkedList + { + + public: + + struct node + { + CircularLinkedListType item; + + node* previous; + node* next; + }; + + CircularLinkedList(); + ~CircularLinkedList(); + CircularLinkedList( const CircularLinkedList& original_copy ); + // CircularLinkedList(LinkedList original_copy) {CircularLinkedList(original_copy);} // Converts linked list to circular type + bool operator= ( const CircularLinkedList& original_copy ); + CircularLinkedList& operator++(); // CircularLinkedList A; ++A; + CircularLinkedList& operator++( int ); // Circular_Linked List A; A++; + CircularLinkedList& operator--(); // CircularLinkedList A; --A; + CircularLinkedList& operator--( int ); // Circular_Linked List A; A--; + bool IsIn( const CircularLinkedListType& input ); + bool Find( const CircularLinkedListType& input ); + void Insert( const CircularLinkedListType& input ); + + CircularLinkedListType& Add ( const CircularLinkedListType& input ) + + ; // Adds after the current position + void Replace( const CircularLinkedListType& input ); + + void Del( void ); + + unsigned int Size( void ); + + CircularLinkedListType& Peek( void ); + + CircularLinkedListType Pop( void ); + + void Clear( void ); + + void Sort( void ); + + void Beginning( void ); + + void End( void ); + + void Concatenate( const CircularLinkedList& L ); + + protected: + unsigned int list_size; + + node *root; + + node *position; + + node* FindPointer( const CircularLinkedListType& input ); + + private: + CircularLinkedList Merge( CircularLinkedList L1, CircularLinkedList L2 ); + + CircularLinkedList Mergesort( const CircularLinkedList& L ); + }; + + template + + class LinkedList : public CircularLinkedList + { + + public: + LinkedList() + {} + + LinkedList( const LinkedList& original_copy ); + ~LinkedList(); + bool operator= ( const LinkedList& original_copy ); + LinkedList& operator++(); // LinkedList A; ++A; + LinkedList& operator++( int ); // Linked List A; A++; + LinkedList& operator--(); // LinkedList A; --A; + LinkedList& operator--( int ); // Linked List A; A--; + + private: + LinkedList Merge( LinkedList L1, LinkedList L2 ); + LinkedList Mergesort( const LinkedList& L ); + + }; + + + template + inline void CircularLinkedList::Beginning( void ) + { + if ( this->root ) + this->position = this->root; + } + + template + inline void CircularLinkedList::End( void ) + { + if ( this->root ) + this->position = this->root->previous; + } + + template + bool LinkedList::operator= ( const LinkedList& original_copy ) + { + typename LinkedList::node * original_copy_pointer, *last, *save_position; + + if ( ( &original_copy ) != this ) + { + + this->Clear(); + + + if ( original_copy.list_size == 0 ) + { + this->root = 0; + this->position = 0; + this->list_size = 0; + } + + else + if ( original_copy.list_size == 1 ) + { + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->root->next = this->root; + this->root->previous = this->root; + this->list_size = 1; + this->position = this->root; + // *(root->item)=*((original_copy.root)->item); + this->root->item = original_copy.root->item; + } + + else + { + // Setup the first part of the root node + original_copy_pointer = original_copy.root; + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->position = this->root; + // *(root->item)=*((original_copy.root)->item); + this->root->item = original_copy.root->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = this->position; + + do + { + + + // Save the current element + last = this->position; + + // Point to the next node in the source list + original_copy_pointer = original_copy_pointer->next; + + // Create a new node and point position to it + this->position = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // position->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + + // Copy the item to the new node + // *(position->item)=*(original_copy_pointer->item); + this->position->item = original_copy_pointer->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = this->position; + + + // Set the previous pointer for the new node + ( this->position->previous ) = last; + + // Set the next pointer for the old node to the new node + ( last->next ) = this->position; + + } + + while ( ( original_copy_pointer->next ) != ( original_copy.root ) ); + + // Complete the circle. Set the next pointer of the newest node to the root and the previous pointer of the root to the newest node + this->position->next = this->root; + + this->root->previous = this->position; + + this->list_size = original_copy.list_size; + + this->position = save_position; + } + } + + return true; + } + + + template + CircularLinkedList::CircularLinkedList() + { + this->root = 0; + this->position = 0; + this->list_size = 0; + } + + template + CircularLinkedList::~CircularLinkedList() + { + this->Clear(); + } + + template + LinkedList::~LinkedList() + { + this->Clear(); + } + + template + LinkedList::LinkedList( const LinkedList& original_copy ) + { + typename LinkedList::node * original_copy_pointer, *last, *save_position; + + if ( original_copy.list_size == 0 ) + { + this->root = 0; + this->position = 0; + this->list_size = 0; + return ; + } + + else + if ( original_copy.list_size == 1 ) + { + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->root->next = this->root; + this->root->previous = this->root; + this->list_size = 1; + this->position = this->root; + // *(root->item) = *((original_copy.root)->item); + this->root->item = original_copy.root->item; + } + + else + { + // Setup the first part of the root node + original_copy_pointer = original_copy.root; + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->position = this->root; + // *(root->item)=*((original_copy.root)->item); + this->root->item = original_copy.root->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = this->position; + + do + { + // Save the current element + last = this->position; + + // Point to the next node in the source list + original_copy_pointer = original_copy_pointer->next; + + // Create a new node and point position to it + this->position = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // position->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + + // Copy the item to the new node + // *(position->item)=*(original_copy_pointer->item); + this->position->item = original_copy_pointer->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = this->position; + + // Set the previous pointer for the new node + ( this->position->previous ) = last; + + // Set the next pointer for the old node to the new node + ( last->next ) = this->position; + + } + + while ( ( original_copy_pointer->next ) != ( original_copy.root ) ); + + // Complete the circle. Set the next pointer of the newest node to the root and the previous pointer of the root to the newest node + this->position->next = this->root; + + this->root->previous = this->position; + + this->list_size = original_copy.list_size; + + this->position = save_position; + } + } + +#ifdef _MSC_VER +#pragma warning( disable : 4701 ) // warning C4701: local variable may be used without having been initialized +#endif + template + CircularLinkedList::CircularLinkedList( const CircularLinkedList& original_copy ) + { + node * original_copy_pointer; + node *last; + node *save_position; + + if ( original_copy.list_size == 0 ) + { + this->root = 0; + this->position = 0; + this->list_size = 0; + return ; + } + + else + if ( original_copy.list_size == 1 ) + { + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->root->next = this->root; + this->root->previous = this->root; + this->list_size = 1; + this->position = this->root; + // *(root->item) = *((original_copy.root)->item); + this->root->item = original_copy.root->item; + } + + else + { + // Setup the first part of the root node + original_copy_pointer = original_copy.root; + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->position = this->root; + // *(root->item)=*((original_copy.root)->item); + this->root->item = original_copy.root->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = this->position; + + do + { + + + // Save the current element + last = this->position; + + // Point to the next node in the source list + original_copy_pointer = original_copy_pointer->next; + + // Create a new node and point position to it + this->position = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // position->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + + // Copy the item to the new node + // *(position->item)=*(original_copy_pointer->item); + this->position->item = original_copy_pointer->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = position; + + // Set the previous pointer for the new node + ( this->position->previous ) = last; + + // Set the next pointer for the old node to the new node + ( last->next ) = this->position; + + } + + while ( ( original_copy_pointer->next ) != ( original_copy.root ) ); + + // Complete the circle. Set the next pointer of the newest node to the root and the previous pointer of the root to the newest node + this->position->next = this->root; + + this->root->previous = position; + + this->list_size = original_copy.list_size; + + this->position = save_position; + } + } + +#ifdef _MSC_VER +#pragma warning( disable : 4701 ) // warning C4701: local variable may be used without having been initialized +#endif + template + bool CircularLinkedList::operator= ( const CircularLinkedList& original_copy ) + { + node * original_copy_pointer; + node *last; + node *save_position; + + if ( ( &original_copy ) != this ) + { + + this->Clear(); + + + if ( original_copy.list_size == 0 ) + { + this->root = 0; + this->position = 0; + this->list_size = 0; + } + + else + if ( original_copy.list_size == 1 ) + { + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->root->next = this->root; + this->root->previous = this->root; + this->list_size = 1; + this->position = this->root; + // *(root->item)=*((original_copy.root)->item); + this->root->item = original_copy.root->item; + } + + else + { + // Setup the first part of the root node + original_copy_pointer = original_copy.root; + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->position = this->root; + // *(root->item)=*((original_copy.root)->item); + this->root->item = original_copy.root->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = this->position; + + do + { + // Save the current element + last = this->position; + + // Point to the next node in the source list + original_copy_pointer = original_copy_pointer->next; + + // Create a new node and point position to it + this->position = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // position->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + + // Copy the item to the new node + // *(position->item)=*(original_copy_pointer->item); + this->position->item = original_copy_pointer->item; + + if ( original_copy_pointer == original_copy.position ) + save_position = this->position; + + // Set the previous pointer for the new node + ( this->position->previous ) = last; + + // Set the next pointer for the old node to the new node + ( last->next ) = this->position; + + } + + while ( ( original_copy_pointer->next ) != ( original_copy.root ) ); + + // Complete the circle. Set the next pointer of the newest node to the root and the previous pointer of the root to the newest node + this->position->next = this->root; + + this->root->previous = this->position; + + this->list_size = original_copy.list_size; + + this->position = save_position; + } + } + + return true; + } + + template + void CircularLinkedList::Insert( const CircularLinkedListType& input ) + { + node * new_node; + + if ( list_size == 0 ) + { + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + //*(root->item)=input; + this->root->item = input; + this->root->next = this->root; + this->root->previous = this->root; + this->list_size = 1; + this->position = this->root; + } + + else + if ( list_size == 1 ) + { + this->position = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // position->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->root->next = this->position; + this->root->previous = this->position; + this->position->previous = this->root; + this->position->next = this->root; + // *(position->item)=input; + this->position->item = input; + this->root = this->position; // Since we're inserting into a 1 element list the old root is now the second item + this->list_size = 2; + } + + else + { + /* + + B + | + A --- C + + position->previous=A + new_node=B + position=C + + Note that the order of the following statements is important */ + + new_node = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // new_node->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + + // *(new_node->item)=input; + new_node->item = input; + + // Point next of A to B + ( this->position->previous ) ->next = new_node; + + // Point last of B to A + new_node->previous = this->position->previous; + + // Point last of C to B + this->position->previous = new_node; + + // Point next of B to C + new_node->next = this->position; + + // Since the root pointer is bound to a node rather than an index this moves it back if you insert an element at the root + + if ( this->position == this->root ) + { + this->root = new_node; + this->position = this->root; + } + + // Increase the recorded size of the list by one + this->list_size++; + } + } + + template + CircularLinkedListType& CircularLinkedList::Add ( const CircularLinkedListType& input ) + { + node * new_node; + + if ( this->list_size == 0 ) + { + this->root = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // root->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // *(root->item)=input; + this->root->item = input; + this->root->next = this->root; + this->root->previous = this->root; + this->list_size = 1; + this->position = this->root; + // return *(position->item); + return this->position->item; + } + + else + if ( list_size == 1 ) + { + this->position = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // position->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + this->root->next = this->position; + this->root->previous = this->position; + this->position->previous = this->root; + this->position->next = this->root; + // *(position->item)=input; + this->position->item = input; + this->list_size = 2; + this->position = this->root; // Don't move the position from the root + // return *(position->item); + return this->position->item; + } + + else + { + /* + + B + | + A --- C + + new_node=B + position=A + position->next=C + + Note that the order of the following statements is important */ + + new_node = RakNet::OP_NEW( _FILE_AND_LINE_ ); + // new_node->item = RakNet::OP_NEW( _FILE_AND_LINE_ ); + + // *(new_node->item)=input; + new_node->item = input; + + // Point last of B to A + new_node->previous = this->position; + + // Point next of B to C + new_node->next = ( this->position->next ); + + // Point last of C to B + ( this->position->next ) ->previous = new_node; + + // Point next of A to B + ( this->position->next ) = new_node; + + // Increase the recorded size of the list by one + this->list_size++; + + // return *(new_node->item); + return new_node->item; + } + } + + template + inline void CircularLinkedList::Replace( const CircularLinkedListType& input ) + { + if ( this->list_size > 0 ) + // *(position->item)=input; + this->position->item = input; + } + + template + void CircularLinkedList::Del() + { + node * new_position; + + if ( this->list_size == 0 ) + return ; + + else + if ( this->list_size == 1 ) + { + // RakNet::OP_DELETE(root->item, _FILE_AND_LINE_); + RakNet::OP_DELETE(this->root, _FILE_AND_LINE_); + this->root = this->position = 0; + this->list_size = 0; + } + + else + { + ( this->position->previous ) ->next = this->position->next; + ( this->position->next ) ->previous = this->position->previous; + new_position = this->position->next; + + if ( this->position == this->root ) + this->root = new_position; + + // RakNet::OP_DELETE(position->item, _FILE_AND_LINE_); + RakNet::OP_DELETE(this->position, _FILE_AND_LINE_); + + this->position = new_position; + + this->list_size--; + } + } + + template + bool CircularLinkedList::IsIn(const CircularLinkedListType& input ) + { + node * return_value, *old_position; + + old_position = this->position; + + return_value = FindPointer( input ); + this->position = old_position; + + if ( return_value != 0 ) + return true; + else + return false; // Can't find the item don't do anything + } + + template + bool CircularLinkedList::Find( const CircularLinkedListType& input ) + { + node * return_value; + + return_value = FindPointer( input ); + + if ( return_value != 0 ) + { + this->position = return_value; + return true; + } + + else + return false; // Can't find the item don't do anything + } + + template + typename CircularLinkedList::node* CircularLinkedList::FindPointer( const CircularLinkedListType& input ) + { + node * current; + + if ( this->list_size == 0 ) + return 0; + + current = this->root; + + // Search for the item starting from the root node and incrementing the pointer after every check + // If you wind up pointing at the root again you looped around the list so didn't find the item, in which case return 0 + do + { + // if (*(current->item) == input) return current; + + if ( current->item == input ) + return current; + + current = current->next; + } + + while ( current != this->root ); + + return 0; + + } + + template + inline unsigned int CircularLinkedList::Size( void ) + { + return this->list_size; + } + + template + inline CircularLinkedListType& CircularLinkedList::Peek( void ) + { + // return *(position->item); + return this->position->item; + } + + template + CircularLinkedListType CircularLinkedList::Pop( void ) + { + CircularLinkedListType element; + element = Peek(); + Del(); + return CircularLinkedListType( element ); // return temporary + } + + // Prefix + template + CircularLinkedList& CircularLinkedList::operator++() + { + if ( this->list_size != 0 ) + position = position->next; + + return *this; + } + + /* + // Postfix + template + CircularLinkedList& CircularLinkedList::operator++(int) + { + CircularLinkedList before; + before=*this; + operator++(); + return before; + } + */ + + template + CircularLinkedList& CircularLinkedList::operator++( int ) + { + return this->operator++(); + } + + // Prefix + template + CircularLinkedList& CircularLinkedList::operator--() + { + if ( this->list_size != 0 ) + this->position = this->position->previous; + + return *this; + } + + /* + // Postfix + template + CircularLinkedList& CircularLinkedList::operator--(int) + { + CircularLinkedList before; + before=*this; + operator--(); + return before; + } + */ + + template + CircularLinkedList& CircularLinkedList::operator--( int ) + { + return this->operator--(); + } + + template + void CircularLinkedList::Clear( void ) + { + if ( this->list_size == 0 ){ + return ; + }else if ( this->list_size == 1 ) // {RakNet::OP_DELETE(root->item); RakNet::OP_DELETE(root, _FILE_AND_LINE_);} + { + RakNet::OP_DELETE(this->root, _FILE_AND_LINE_); + } + + else + { + node* current; + node* temp; + + current = this->root; + + do + { + temp = current; + current = current->next; + // RakNet::OP_DELETE(temp->item, _FILE_AND_LINE_); + RakNet::OP_DELETE(temp, _FILE_AND_LINE_); + } + + while ( current != this->root ); + } + + this->list_size = 0; + this->root = 0; + this->position = 0; + } + + template + inline void CircularLinkedList::Concatenate( const CircularLinkedList& L ) + { + unsigned int counter; + node* ptr; + + if ( L.list_size == 0 ) + return ; + + if ( this->list_size == 0 ) + * this = L; + + ptr = L.root; + + this->position = this->root->previous; + + // Cycle through each element in L and add it to the current list + for ( counter = 0; counter < L.list_size; counter++ ) + { + // Add item after the current item pointed to + // add(*(ptr->item)); + + Add ( ptr->item ); + + // Update pointers. Moving ptr keeps the current pointer at the end of the list since the add function does not move the pointer + ptr = ptr->next; + + this->position = this->position->next; + } + } + + template + inline void CircularLinkedList::Sort( void ) + { + if ( this->list_size <= 1 ) + return ; + + // Call equal operator to assign result of mergesort to current object + *this = Mergesort( *this ); + + this->position = this->root; + } + + template + CircularLinkedList CircularLinkedList::Mergesort( const CircularLinkedList& L ) + { + unsigned int counter; + node* location; + CircularLinkedList L1; + CircularLinkedList L2; + + location = L.root; + + // Split the list into two equal size sublists, L1 and L2 + + for ( counter = 0; counter < L.list_size / 2; counter++ ) + { + // L1.add (*(location->item)); + L1.Add ( location->item ); + location = location->next; + } + + for ( ;counter < L.list_size; counter++ ) + { + // L2.Add(*(location->item)); + L2.Add ( location->item ); + location = location->next; + } + + // Recursively sort the sublists + if ( L1.list_size > 1 ) + L1 = Mergesort( L1 ); + + if ( L2.list_size > 1 ) + L2 = Mergesort( L2 ); + + // Merge the two sublists + return Merge( L1, L2 ); + } + + template + CircularLinkedList CircularLinkedList::Merge( CircularLinkedList L1, CircularLinkedList L2 ) + { + CircularLinkedList X; + CircularLinkedListType element; + L1.position = L1.root; + L2.position = L2.root; + + // While neither list is empty + + while ( ( L1.list_size != 0 ) && ( L2.list_size != 0 ) ) + { + // Compare the first items of L1 and L2 + // Remove the smaller of the two items from the list + + if ( ( ( L1.root ) ->item ) < ( ( L2.root ) ->item ) ) + // if ((*((L1.root)->item)) < (*((L2.root)->item))) + { + // element = *((L1.root)->item); + element = ( L1.root ) ->item; + L1.Del(); + } + else + { + // element = *((L2.root)->item); + element = ( L2.root ) ->item; + L2.Del(); + } + + // Add this item to the end of X + X.Add( element ); + + X++; + } + + // Add the remaining list to X + if ( L1.list_size != 0 ) + X.Concatenate( L1 ); + else + X.Concatenate( L2 ); + + return X; + } + + template + LinkedList LinkedList::Mergesort( const LinkedList& L ) + { + unsigned int counter; + typename LinkedList::node* location; + LinkedList L1; + LinkedList L2; + + location = L.root; + + // Split the list into two equal size sublists, L1 and L2 + + for ( counter = 0; counter < L.LinkedList_size / 2; counter++ ) + { + // L1.add (*(location->item)); + L1.Add ( location->item ); + location = location->next; + } + + for ( ;counter < L.LinkedList_size; counter++ ) + { + // L2.Add(*(location->item)); + L2.Add ( location->item ); + location = location->next; + } + + // Recursively sort the sublists + if ( L1.list_size > 1 ) + L1 = Mergesort( L1 ); + + if ( L2.list_size > 1 ) + L2 = Mergesort( L2 ); + + // Merge the two sublists + return Merge( L1, L2 ); + } + + template + LinkedList LinkedList::Merge( LinkedList L1, LinkedList L2 ) + { + LinkedList X; + LinkedListType element; + L1.position = L1.root; + L2.position = L2.root; + + // While neither list is empty + + while ( ( L1.LinkedList_size != 0 ) && ( L2.LinkedList_size != 0 ) ) + { + // Compare the first items of L1 and L2 + // Remove the smaller of the two items from the list + + if ( ( ( L1.root ) ->item ) < ( ( L2.root ) ->item ) ) + // if ((*((L1.root)->item)) < (*((L2.root)->item))) + { + element = ( L1.root ) ->item; + // element = *((L1.root)->item); + L1.Del(); + } + else + { + element = ( L2.root ) ->item; + // element = *((L2.root)->item); + L2.Del(); + } + + // Add this item to the end of X + X.Add( element ); + } + + // Add the remaining list to X + if ( L1.LinkedList_size != 0 ) + X.concatenate( L1 ); + else + X.concatenate( L2 ); + + return X; + } + + + // Prefix + template + LinkedList& LinkedList::operator++() + { + if ( ( this->list_size != 0 ) && ( this->position->next != this->root ) ) + this->position = this->position->next; + + return *this; + } + + /* + // Postfix + template + LinkedList& LinkedList::operator++(int) + { + LinkedList before; + before=*this; + operator++(); + return before; + } + */ + // Postfix + template + LinkedList& LinkedList::operator++( int ) + { + return this->operator++(); + } + + // Prefix + template + LinkedList& LinkedList::operator--() + { + if ( ( this->list_size != 0 ) && ( this->position != this->root ) ) + this->position = this->position->previous; + + return *this; + } + + /* + // Postfix + template + LinkedList& LinkedList::operator--(int) + { + LinkedList before; + before=*this; + operator--(); + return before; + } + */ + + // Postfix + template + LinkedList& LinkedList::operator--( int ) + { + return this->operator--(); + } + +} // End namespace + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif diff --git a/include/raknet/DS_List.hpp b/include/raknet/DS_List.hpp new file mode 100644 index 0000000..1c53d5e --- /dev/null +++ b/include/raknet/DS_List.hpp @@ -0,0 +1,525 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_List.h +/// \internal +/// \brief Array based list. +/// \details Usually the Queue class is used instead, since it has all the same functionality and is only worse at random access. +/// + + +#ifndef __LIST_H +#define __LIST_H + +#include "RakAssert.hpp" +#include // memmove +#include "Export.hpp" +#include "RakMemoryOverride.hpp" + +/// Maximum unsigned long +static const unsigned int MAX_UNSIGNED_LONG = 4294967295U; + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + /// \brief Array based implementation of a list. + /// \note ONLY USE THIS FOR SHALLOW COPIES. I don't bother with operator= to improve performance. + template + class RAK_DLL_EXPORT List + { + public: + /// Default constructor + List(); + + // Destructor + ~List(); + + /// \brief Copy constructor. + /// \param[in] original_copy The list to duplicate + List( const List& original_copy ); + + /// \brief Assign one list to another. + List& operator= ( const List& original_copy ); + + /// \brief Access an element by its index in the array. + /// \param[in] position The index into the array. + /// \return The element at position \a position. + list_type& operator[] ( const unsigned int position ) const; + + /// \brief Access an element by its index in the array. + /// \param[in] position The index into the array. + /// \return The element at position \a position. + list_type& Get ( const unsigned int position ) const; + + /// \brief Push an element at the end of the stack. + /// \param[in] input The new element. + void Push(const list_type &input, const char *file, unsigned int line ); + + /// \brief Pop an element from the end of the stack. + /// \pre Size()>0 + /// \return The element at the end. + list_type& Pop(void); + + /// \brief Insert an element at position \a position in the list. + /// \param[in] input The new element. + /// \param[in] position The position of the new element. + void Insert( const list_type &input, const unsigned int position, const char *file, unsigned int line ); + + /// \brief Insert at the end of the list. + /// \param[in] input The new element. + void Insert( const list_type &input, const char *file, unsigned int line ); + + /// \brief Replace the value at \a position by \a input. + /// \details If the size of the list is less than @em position, it increase the capacity of + /// the list and fill slot with @em filler. + /// \param[in] input The element to replace at position @em position. + /// \param[in] filler The element use to fill new allocated capacity. + /// \param[in] position The position of input in the list. + void Replace( const list_type &input, const list_type filler, const unsigned int position, const char *file, unsigned int line ); + + /// \brief Replace the last element of the list by \a input. + /// \param[in] input The element used to replace the last element. + void Replace( const list_type &input ); + + /// \brief Delete the element at position \a position. + /// \param[in] position The index of the element to delete + void RemoveAtIndex( const unsigned int position ); + + /// \brief Delete the element at position \a position. + /// \note - swaps middle with end of list, only use if list order does not matter + /// \param[in] position The index of the element to delete + void RemoveAtIndexFast( const unsigned int position ); + + /// \brief Delete the element at the end of the list. + void RemoveFromEnd(const unsigned num=1); + + /// \brief Returns the index of the specified item or MAX_UNSIGNED_LONG if not found. + /// \param[in] input The element to check for + /// \return The index or position of @em input in the list. + /// \retval MAX_UNSIGNED_LONG The object is not in the list + /// \retval [Integer] The index of the element in the list + unsigned int GetIndexOf( const list_type &input ) const; + + /// \return The number of elements in the list + unsigned int Size( void ) const; + + /// \brief Clear the list + void Clear( bool doNotDeallocateSmallBlocks, const char *file, unsigned int line ); + + /// \brief Preallocate the list, so it needs fewer reallocations at runtime. + void Preallocate( unsigned countNeeded, const char *file, unsigned int line ); + + /// \brief Frees overallocated members, to use the minimum memory necessary. + /// \attention + /// This is a slow operation + void Compress( const char *file, unsigned int line ); + + private: + /// An array of user values + list_type* listArray; + + /// Number of elements in the list + unsigned int list_size; + + /// Size of \a array + unsigned int allocation_size; + }; + template + List::List() + { + allocation_size = 0; + listArray = 0; + list_size = 0; + } + + template + List::~List() + { + if (allocation_size>0) + RakNet::OP_DELETE_ARRAY(listArray, _FILE_AND_LINE_); + } + + + template + List::List( const List& original_copy ) + { + // Allocate memory for copy + + if ( original_copy.list_size == 0 ) + { + list_size = 0; + allocation_size = 0; + } + else + { + listArray = RakNet::OP_NEW_ARRAY( original_copy.list_size , _FILE_AND_LINE_ ); + + for ( unsigned int counter = 0; counter < original_copy.list_size; ++counter ) + listArray[ counter ] = original_copy.listArray[ counter ]; + + // Don't call constructors, assignment operators, etc. + //memcpy(listArray, original_copy.listArray, original_copy.list_size*sizeof(list_type)); + + list_size = allocation_size = original_copy.list_size; + } + } + + template + List& List::operator= ( const List& original_copy ) + { + if ( ( &original_copy ) != this ) + { + Clear( false, _FILE_AND_LINE_ ); + + // Allocate memory for copy + + if ( original_copy.list_size == 0 ) + { + list_size = 0; + allocation_size = 0; + } + + else + { + listArray = RakNet::OP_NEW_ARRAY( original_copy.list_size , _FILE_AND_LINE_ ); + + for ( unsigned int counter = 0; counter < original_copy.list_size; ++counter ) + listArray[ counter ] = original_copy.listArray[ counter ]; + // Don't call constructors, assignment operators, etc. + //memcpy(listArray, original_copy.listArray, original_copy.list_size*sizeof(list_type)); + + list_size = allocation_size = original_copy.list_size; + } + } + + return *this; + } + + + template + inline list_type& List::operator[] ( const unsigned int position ) const + { + #ifdef _DEBUG + if (position>=list_size) + { + RakAssert ( position < list_size ); + } + #endif + return listArray[ position ]; + } + + // Just here for debugging + template + inline list_type& List::Get ( const unsigned int position ) const + { + return listArray[ position ]; + } + + template + void List::Push(const list_type &input, const char *file, unsigned int line) + { + Insert(input, file, line); + } + + template + inline list_type& List::Pop(void) + { +#ifdef _DEBUG + RakAssert(list_size>0); +#endif + --list_size; + return listArray[list_size]; + } + + template + void List::Insert( const list_type &input, const unsigned int position, const char *file, unsigned int line ) + { +#ifdef _DEBUG + if (position>list_size) + { + RakAssert( position <= list_size ); + } +#endif + + // Reallocate list if necessary + if ( list_size == allocation_size ) + { + // allocate twice the currently allocated memory + list_type * new_array; + + if ( allocation_size == 0 ) + allocation_size = 16; + else + allocation_size *= 2; + + new_array = RakNet::OP_NEW_ARRAY( allocation_size , file, line ); + + // copy old array over + for ( unsigned int counter = 0; counter < list_size; ++counter ) + new_array[ counter ] = listArray[ counter ]; + + // Don't call constructors, assignment operators, etc. + //memcpy(new_array, listArray, list_size*sizeof(list_type)); + + // set old array to point to the newly allocated and twice as large array + RakNet::OP_DELETE_ARRAY(listArray, file, line); + + listArray = new_array; + } + + // Move the elements in the list to make room + for ( unsigned int counter = list_size; counter != position; counter-- ) + listArray[ counter ] = listArray[ counter - 1 ]; + + // Don't call constructors, assignment operators, etc. + //memmove(listArray+position+1, listArray+position, (list_size-position)*sizeof(list_type)); + + // Insert the new item at the correct spot + listArray[ position ] = input; + + ++list_size; + + } + + + template + void List::Insert( const list_type &input, const char *file, unsigned int line ) + { + // Reallocate list if necessary + + if ( list_size == allocation_size ) + { + // allocate twice the currently allocated memory + list_type * new_array; + + if ( allocation_size == 0 ) + allocation_size = 16; + else + allocation_size *= 2; + + new_array = RakNet::OP_NEW_ARRAY( allocation_size , file, line ); + + if (listArray) + { + // copy old array over + for ( unsigned int counter = 0; counter < list_size; ++counter ) + new_array[ counter ] = listArray[ counter ]; + + // Don't call constructors, assignment operators, etc. + //memcpy(new_array, listArray, list_size*sizeof(list_type)); + + // set old array to point to the newly allocated and twice as large array + RakNet::OP_DELETE_ARRAY(listArray, file, line); + } + + listArray = new_array; + } + + // Insert the new item at the correct spot + listArray[ list_size ] = input; + + ++list_size; + } + + template + inline void List::Replace( const list_type &input, const list_type filler, const unsigned int position, const char *file, unsigned int line ) + { + if ( ( list_size > 0 ) && ( position < list_size ) ) + { + // Direct replacement + listArray[ position ] = input; + } + else + { + if ( position >= allocation_size ) + { + // Reallocate the list to size position and fill in blanks with filler + list_type * new_array; + allocation_size = position + 1; + + new_array = RakNet::OP_NEW_ARRAY( allocation_size , file, line ); + + // copy old array over + + for ( unsigned int counter = 0; counter < list_size; ++counter ) + new_array[ counter ] = listArray[ counter ]; + + // Don't call constructors, assignment operators, etc. + //memcpy(new_array, listArray, list_size*sizeof(list_type)); + + // set old array to point to the newly allocated array + RakNet::OP_DELETE_ARRAY(listArray, file, line); + + listArray = new_array; + } + + // Fill in holes with filler + while ( list_size < position ) + listArray[ list_size++ ] = filler; + + // Fill in the last element with the new item + listArray[ list_size++ ] = input; + +#ifdef _DEBUG + + RakAssert( list_size == position + 1 ); + +#endif + + } + } + + template + inline void List::Replace( const list_type &input ) + { + if ( list_size > 0 ) + listArray[ list_size - 1 ] = input; + } + + template + void List::RemoveAtIndex( const unsigned int position ) + { +#ifdef _DEBUG + if (position >= list_size) + { + RakAssert( position < list_size ); + return; + } +#endif + + if ( position < list_size ) + { + // Compress the array + for ( unsigned int counter = position; counter < list_size - 1 ; ++counter ) + listArray[ counter ] = listArray[ counter + 1 ]; + // Don't call constructors, assignment operators, etc. + // memmove(listArray+position, listArray+position+1, (list_size-1-position) * sizeof(list_type)); + + RemoveFromEnd(); + } + } + + template + void List::RemoveAtIndexFast( const unsigned int position ) + { +#ifdef _DEBUG + if (position >= list_size) + { + RakAssert( position < list_size ); + return; + } +#endif + --list_size; + listArray[position]=listArray[list_size]; + } + + template + inline void List::RemoveFromEnd( const unsigned num ) + { + // Delete the last elements on the list. No compression needed +#ifdef _DEBUG + RakAssert(list_size>=num); +#endif + list_size-=num; + } + + template + unsigned int List::GetIndexOf( const list_type &input ) const + { + for ( unsigned int i = 0; i < list_size; ++i ) + if ( listArray[ i ] == input ) + return i; + + return MAX_UNSIGNED_LONG; + } + + template + inline unsigned int List::Size( void ) const + { + return list_size; + } + + template + void List::Clear( bool doNotDeallocateSmallBlocks, const char *file, unsigned int line ) + { + if ( allocation_size == 0 ) + return; + + if (allocation_size>512 || doNotDeallocateSmallBlocks==false) + { + RakNet::OP_DELETE_ARRAY(listArray, file, line); + allocation_size = 0; + listArray = 0; + } + list_size = 0; + } + + template + void List::Compress( const char *file, unsigned int line ) + { + list_type * new_array; + + if ( allocation_size == 0 ) + return ; + + new_array = RakNet::OP_NEW_ARRAY( allocation_size , file, line ); + + // copy old array over + for ( unsigned int counter = 0; counter < list_size; ++counter ) + new_array[ counter ] = listArray[ counter ]; + + // Don't call constructors, assignment operators, etc. + //memcpy(new_array, listArray, list_size*sizeof(list_type)); + + // set old array to point to the newly allocated array + RakNet::OP_DELETE_ARRAY(listArray, file, line); + + listArray = new_array; + } + + template + void List::Preallocate( unsigned countNeeded, const char *file, unsigned int line ) + { + unsigned amountToAllocate = allocation_size; + if (allocation_size==0) + amountToAllocate=16; + while (amountToAllocate < countNeeded) + amountToAllocate<<=1; + + if ( allocation_size < amountToAllocate) + { + // allocate twice the currently allocated memory + list_type * new_array; + + allocation_size=amountToAllocate; + + new_array = RakNet::OP_NEW_ARRAY< list_type >( allocation_size , file, line ); + + if (listArray) + { + // copy old array over + for ( unsigned int counter = 0; counter < list_size; ++counter ) + new_array[ counter ] = listArray[ counter ]; + + // Don't call constructors, assignment operators, etc. + //memcpy(new_array, listArray, list_size*sizeof(list_type)); + + // set old array to point to the newly allocated and twice as large array + RakNet::OP_DELETE_ARRAY(listArray, file, line); + } + + listArray = new_array; + } + } + +} // End namespace + +#endif diff --git a/include/raknet/DS_Map.hpp b/include/raknet/DS_Map.hpp new file mode 100644 index 0000000..755068b --- /dev/null +++ b/include/raknet/DS_Map.hpp @@ -0,0 +1,335 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_Map.h +/// \internal +/// \brief Map +/// + + +#ifndef __RAKNET_MAP_H +#define __RAKNET_MAP_H + +#include "DS_OrderedList.hpp" +#include "Export.hpp" +#include "RakMemoryOverride.hpp" +#include "RakAssert.hpp" + +// If I want to change this to a red-black tree, this is a good site: http://www.cs.auckland.ac.nz/software/AlgAnim/red_black.html +// This makes insertions and deletions faster. But then traversals are slow, while they are currently fast. + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + /// The default comparison has to be first so it can be called as a default parameter. + /// It then is followed by MapNode, followed by NodeComparisonFunc + template + int defaultMapKeyComparison(const key_type &a, const key_type &b) + { + if (a > + class RAK_DLL_EXPORT Map + { + public: + static void IMPLEMENT_DEFAULT_COMPARISON(void) {DataStructures::defaultMapKeyComparison(key_type(),key_type());} + + struct MapNode + { + MapNode() {} + MapNode(key_type _key, data_type _data) : mapNodeKey(_key), mapNodeData(_data) {} + MapNode& operator = ( const MapNode& input ) {mapNodeKey=input.mapNodeKey; mapNodeData=input.mapNodeData; return *this;} + MapNode( const MapNode & input) {mapNodeKey=input.mapNodeKey; mapNodeData=input.mapNodeData;} + key_type mapNodeKey; + data_type mapNodeData; + }; + + // Has to be a static because the comparison callback for DataStructures::OrderedList is a C function + static int NodeComparisonFunc(const key_type &a, const MapNode &b) + { +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + return key_comparison_func(a, b.mapNodeKey); + } + + Map(); + ~Map(); + Map( const Map& original_copy ); + Map& operator= ( const Map& original_copy ); + + data_type& Get(const key_type &key) const; + data_type Pop(const key_type &key); + // Add if needed + void Set(const key_type &key, const data_type &data); + // Must already exist + void SetExisting(const key_type &key, const data_type &data); + // Must add + void SetNew(const key_type &key, const data_type &data); + bool Has(const key_type &key) const; + bool Delete(const key_type &key); + data_type& operator[] ( const unsigned int position ) const; + key_type GetKeyAtIndex( const unsigned int position ) const; + unsigned GetIndexAtKey( const key_type &key ); + void RemoveAtIndex(const unsigned index); + void Clear(void); + unsigned Size(void) const; + + protected: + DataStructures::OrderedList< key_type,MapNode,&Map::NodeComparisonFunc > mapNodeList; + + void SaveLastSearch(const key_type &key, unsigned index) const; + bool HasSavedSearchResult(const key_type &key) const; + + unsigned lastSearchIndex; + key_type lastSearchKey; + bool lastSearchIndexValid; + }; + + template + Map::Map() + { + lastSearchIndexValid=false; + } + + template + Map::~Map() + { + Clear(); + } + + template + Map::Map( const Map& original_copy ) + { + mapNodeList=original_copy.mapNodeList; + lastSearchIndex=original_copy.lastSearchIndex; + lastSearchKey=original_copy.lastSearchKey; + lastSearchIndexValid=original_copy.lastSearchIndexValid; + } + + template + Map& Map::operator= ( const Map& original_copy ) + { + mapNodeList=original_copy.mapNodeList; + lastSearchIndex=original_copy.lastSearchIndex; + lastSearchKey=original_copy.lastSearchKey; + lastSearchIndexValid=original_copy.lastSearchIndexValid; + return *this; + } + + template + data_type& Map::Get(const key_type &key) const + { + if (HasSavedSearchResult(key)) + return mapNodeList[lastSearchIndex].mapNodeData; + + bool objectExists; + unsigned index; + index=mapNodeList.GetIndexFromKey(key, &objectExists); + RakAssert(objectExists); + SaveLastSearch(key,index); + return mapNodeList[index].mapNodeData; + } + + template + unsigned Map::GetIndexAtKey( const key_type &key ) + { + if (HasSavedSearchResult(key)) + return lastSearchIndex; + + bool objectExists; + unsigned index; + index=mapNodeList.GetIndexFromKey(key, &objectExists); + if (objectExists==false) + { + RakAssert(objectExists); + } + SaveLastSearch(key,index); + return index; + } + + template + void Map::RemoveAtIndex(const unsigned index) + { + mapNodeList.RemoveAtIndex(index); + lastSearchIndexValid=false; + } + + template + data_type Map::Pop(const key_type &key) + { + bool objectExists; + unsigned index; + if (HasSavedSearchResult(key)) + index=lastSearchIndex; + else + { + index=mapNodeList.GetIndexFromKey(key, &objectExists); + RakAssert(objectExists); + } + data_type tmp = mapNodeList[index].mapNodeData; + mapNodeList.RemoveAtIndex(index); + lastSearchIndexValid=false; + return tmp; + } + + template + void Map::Set(const key_type &key, const data_type &data) + { + bool objectExists; + unsigned index; + + if (HasSavedSearchResult(key)) + { + mapNodeList[lastSearchIndex].mapNodeData=data; + return; + } + + index=mapNodeList.GetIndexFromKey(key, &objectExists); + + if (objectExists) + { + SaveLastSearch(key,index); + mapNodeList[index].mapNodeData=data; + } + else + { + SaveLastSearch(key,mapNodeList.Insert(key,MapNode(key,data), true, _FILE_AND_LINE_)); + } + } + + template + void Map::SetExisting(const key_type &key, const data_type &data) + { + bool objectExists; + unsigned index; + + if (HasSavedSearchResult(key)) + { + index=lastSearchIndex; + } + else + { + index=mapNodeList.GetIndexFromKey(key, &objectExists); + RakAssert(objectExists); + SaveLastSearch(key,index); + } + + mapNodeList[index].mapNodeData=data; + } + + template + void Map::SetNew(const key_type &key, const data_type &data) + { +#ifdef _DEBUG + bool objectExists; + mapNodeList.GetIndexFromKey(key, &objectExists); + RakAssert(objectExists==false); +#endif + SaveLastSearch(key,mapNodeList.Insert(key,MapNode(key,data), true, _FILE_AND_LINE_)); + } + + template + bool Map::Has(const key_type &key) const + { + if (HasSavedSearchResult(key)) + return true; + + bool objectExists; + unsigned index; + index=mapNodeList.GetIndexFromKey(key, &objectExists); + if (objectExists) + SaveLastSearch(key,index); + return objectExists; + } + + template + bool Map::Delete(const key_type &key) + { + if (HasSavedSearchResult(key)) + { + lastSearchIndexValid=false; + mapNodeList.RemoveAtIndex(lastSearchIndex); + return true; + } + + bool objectExists; + unsigned index; + index=mapNodeList.GetIndexFromKey(key, &objectExists); + if (objectExists) + { + lastSearchIndexValid=false; + mapNodeList.RemoveAtIndex(index); + return true; + } + else + return false; + } + + template + void Map::Clear(void) + { + lastSearchIndexValid=false; + mapNodeList.Clear(false, _FILE_AND_LINE_); + } + + template + data_type& Map::operator[]( const unsigned int position ) const + { + return mapNodeList[position].mapNodeData; + } + + template + key_type Map::GetKeyAtIndex( const unsigned int position ) const + { + return mapNodeList[position].mapNodeKey; + } + + template + unsigned Map::Size(void) const + { + return mapNodeList.Size(); + } + + template + void Map::SaveLastSearch(const key_type &key, const unsigned index) const + { + (void) key; + (void) index; + + /* + lastSearchIndex=index; + lastSearchKey=key; + lastSearchIndexValid=true; + */ + } + + template + bool Map::HasSavedSearchResult(const key_type &key) const + { + (void) key; + + // Not threadsafe! + return false; + // return lastSearchIndexValid && key_comparison_func(key,lastSearchKey)==0; + } +} + +#endif diff --git a/include/raknet/DS_MemoryPool.hpp b/include/raknet/DS_MemoryPool.hpp new file mode 100644 index 0000000..9f5fe1e --- /dev/null +++ b/include/raknet/DS_MemoryPool.hpp @@ -0,0 +1,356 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_MemoryPool.h +/// + + +#ifndef __MEMORY_POOL_H +#define __MEMORY_POOL_H + +#ifndef __APPLE__ +// Use stdlib and not malloc for compatibility +#include +#endif +#include "RakAssert.hpp" +#include "Export.hpp" + +#include "RakMemoryOverride.hpp" + +// DS_MEMORY_POOL_MAX_FREE_PAGES must be > 1 +#define DS_MEMORY_POOL_MAX_FREE_PAGES 4 + +//#define _DISABLE_MEMORY_POOL + +namespace DataStructures +{ + /// Very fast memory pool for allocating and deallocating structures that don't have constructors or destructors. + /// Contains a list of pages, each of which has an array of the user structures + template + class RAK_DLL_EXPORT MemoryPool + { + public: + struct Page; + struct MemoryWithPage + { + MemoryBlockType userMemory; + Page *parentPage; + }; + struct Page + { + MemoryWithPage** availableStack; + int availableStackSize; + MemoryWithPage* block; + Page *next, *prev; + }; + + MemoryPool(); + ~MemoryPool(); + void SetPageSize(int size); // Defaults to 16384 bytes + MemoryBlockType *Allocate(const char *file, unsigned int line); + void Release(MemoryBlockType *m, const char *file, unsigned int line); + void Clear(const char *file, unsigned int line); + + int GetAvailablePagesSize(void) const {return availablePagesSize;} + int GetUnavailablePagesSize(void) const {return unavailablePagesSize;} + int GetMemoryPoolPageSize(void) const {return memoryPoolPageSize;} + protected: + int BlocksPerPage(void) const; + void AllocateFirst(void); + bool InitPage(Page *page, Page *prev, const char *file, unsigned int line); + + // availablePages contains pages which have room to give the user new blocks. We return these blocks from the head of the list + // unavailablePages are pages which are totally full, and from which we do not return new blocks. + // Pages move from the head of unavailablePages to the tail of availablePages, and from the head of availablePages to the tail of unavailablePages + Page *availablePages, *unavailablePages; + int availablePagesSize, unavailablePagesSize; + int memoryPoolPageSize; + }; + + template + MemoryPool::MemoryPool() + { +#ifndef _DISABLE_MEMORY_POOL + //AllocateFirst(); + availablePagesSize=0; + unavailablePagesSize=0; + memoryPoolPageSize=16384; +#endif + } + template + MemoryPool::~MemoryPool() + { +#ifndef _DISABLE_MEMORY_POOL + Clear(_FILE_AND_LINE_); +#endif + } + + template + void MemoryPool::SetPageSize(int size) + { + memoryPoolPageSize=size; + } + + template + MemoryBlockType* MemoryPool::Allocate(const char *file, unsigned int line) + { +#ifdef _DISABLE_MEMORY_POOL + return (MemoryBlockType*) rakMalloc_Ex(sizeof(MemoryBlockType), file, line); +#else + + if (availablePagesSize>0) + { + MemoryBlockType *retVal; + Page *curPage; + curPage=availablePages; + retVal = (MemoryBlockType*) curPage->availableStack[--(curPage->availableStackSize)]; + if (curPage->availableStackSize==0) + { + --availablePagesSize; + availablePages=curPage->next; + RakAssert(availablePagesSize==0 || availablePages->availableStackSize>0); + curPage->next->prev=curPage->prev; + curPage->prev->next=curPage->next; + + if (unavailablePagesSize++==0) + { + unavailablePages=curPage; + curPage->next=curPage; + curPage->prev=curPage; + } + else + { + curPage->next=unavailablePages; + curPage->prev=unavailablePages->prev; + unavailablePages->prev->next=curPage; + unavailablePages->prev=curPage; + } + } + + RakAssert(availablePagesSize==0 || availablePages->availableStackSize>0); + return retVal; + } + + availablePages = (Page *) rakMalloc_Ex(sizeof(Page), file, line); + if (availablePages==0) + return 0; + availablePagesSize=1; + if (InitPage(availablePages, availablePages, file, line)==false) + return 0; + // If this assert hits, we couldn't allocate even 1 block per page. Increase the page size + RakAssert(availablePages->availableStackSize>1); + + return (MemoryBlockType *) availablePages->availableStack[--availablePages->availableStackSize]; +#endif + } + template + void MemoryPool::Release(MemoryBlockType *m, const char *file, unsigned int line) + { +#ifdef _DISABLE_MEMORY_POOL + rakFree_Ex(m, file, line); + return; +#else + // Find the page this block is in and return it. + Page *curPage; + MemoryWithPage *memoryWithPage = (MemoryWithPage*)m; + curPage=memoryWithPage->parentPage; + + if (curPage->availableStackSize==0) + { + // The page is in the unavailable list so move it to the available list + curPage->availableStack[curPage->availableStackSize++]=memoryWithPage; + unavailablePagesSize--; + + // As this page is no longer totally empty, move it to the end of available pages + curPage->next->prev=curPage->prev; + curPage->prev->next=curPage->next; + + if (unavailablePagesSize>0 && curPage==unavailablePages) + unavailablePages=unavailablePages->next; + + if (availablePagesSize++==0) + { + availablePages=curPage; + curPage->next=curPage; + curPage->prev=curPage; + } + else + { + curPage->next=availablePages; + curPage->prev=availablePages->prev; + availablePages->prev->next=curPage; + availablePages->prev=curPage; + } + } + else + { + curPage->availableStack[curPage->availableStackSize++]=memoryWithPage; + + if (curPage->availableStackSize==BlocksPerPage() && + availablePagesSize>=DS_MEMORY_POOL_MAX_FREE_PAGES) + { + // After a certain point, just deallocate empty pages rather than keep them around + if (curPage==availablePages) + { + availablePages=curPage->next; + RakAssert(availablePages->availableStackSize>0); + } + curPage->prev->next=curPage->next; + curPage->next->prev=curPage->prev; + availablePagesSize--; + rakFree_Ex(curPage->availableStack, file, line ); + rakFree_Ex(curPage->block, file, line ); + rakFree_Ex(curPage, file, line ); + } + } +#endif + } + template + void MemoryPool::Clear(const char *file, unsigned int line) + { +#ifdef _DISABLE_MEMORY_POOL + return; +#else + Page *cur, *freed; + + if (availablePagesSize>0) + { + cur = availablePages; +#ifdef _MSC_VER +#pragma warning(disable:4127) // conditional expression is constant +#endif + while (true) + // do + { + rakFree_Ex(cur->availableStack, file, line ); + rakFree_Ex(cur->block, file, line ); + freed=cur; + cur=cur->next; + if (cur==availablePages) + { + rakFree_Ex(freed, file, line ); + break; + } + rakFree_Ex(freed, file, line ); + }// while(cur!=availablePages); + } + + if (unavailablePagesSize>0) + { + cur = unavailablePages; + while (1) + //do + { + rakFree_Ex(cur->availableStack, file, line ); + rakFree_Ex(cur->block, file, line ); + freed=cur; + cur=cur->next; + if (cur==unavailablePages) + { + rakFree_Ex(freed, file, line ); + break; + } + rakFree_Ex(freed, file, line ); + } // while(cur!=unavailablePages); + } + + availablePagesSize=0; + unavailablePagesSize=0; +#endif + } + template + int MemoryPool::BlocksPerPage(void) const + { + return memoryPoolPageSize / sizeof(MemoryWithPage); + } + template + bool MemoryPool::InitPage(Page *page, Page *prev, const char *file, unsigned int line) + { + int i=0; + const int bpp = BlocksPerPage(); + page->block=(MemoryWithPage*) rakMalloc_Ex(memoryPoolPageSize, file, line); + if (page->block==0) + return false; + page->availableStack=(MemoryWithPage**)rakMalloc_Ex(sizeof(MemoryWithPage*)*bpp, file, line); + if (page->availableStack==0) + { + rakFree_Ex(page->block, file, line ); + return false; + } + MemoryWithPage *curBlock = page->block; + MemoryWithPage **curStack = page->availableStack; + while (i < bpp) + { + curBlock->parentPage=page; + curStack[i]=curBlock++; + i++; + } + page->availableStackSize=bpp; + page->next=availablePages; + page->prev=prev; + return true; + } +} + +#endif + +/* +#include "DS_MemoryPool.hpp" +#include "DS_List.hpp" + +struct TestMemoryPool +{ + int allocationId; +}; + +int main(void) +{ + DataStructures::MemoryPool memoryPool; + DataStructures::List returnList; + + for (int i=0; i < 100000; i++) + returnList.Push(memoryPool.Allocate(_FILE_AND_LINE_), _FILE_AND_LINE_); + for (int i=0; i < returnList.Size(); i+=2) + { + memoryPool.Release(returnList[i], _FILE_AND_LINE_); + returnList.RemoveAtIndexFast(i); + } + for (int i=0; i < 100000; i++) + returnList.Push(memoryPool.Allocate(_FILE_AND_LINE_), _FILE_AND_LINE_); + while (returnList.Size()) + { + memoryPool.Release(returnList[returnList.Size()-1], _FILE_AND_LINE_); + returnList.RemoveAtIndex(returnList.Size()-1); + } + for (int i=0; i < 100000; i++) + returnList.Push(memoryPool.Allocate(_FILE_AND_LINE_), _FILE_AND_LINE_); + while (returnList.Size()) + { + memoryPool.Release(returnList[returnList.Size()-1], _FILE_AND_LINE_); + returnList.RemoveAtIndex(returnList.Size()-1); + } + for (int i=0; i < 100000; i++) + returnList.Push(memoryPool.Allocate(_FILE_AND_LINE_), _FILE_AND_LINE_); + for (int i=100000-1; i <= 0; i-=2) + { + memoryPool.Release(returnList[i], _FILE_AND_LINE_); + returnList.RemoveAtIndexFast(i); + } + for (int i=0; i < 100000; i++) + returnList.Push(memoryPool.Allocate(_FILE_AND_LINE_), _FILE_AND_LINE_); + while (returnList.Size()) + { + memoryPool.Release(returnList[returnList.Size()-1], _FILE_AND_LINE_); + returnList.RemoveAtIndex(returnList.Size()-1); + } + + return 0; +} +*/ diff --git a/include/raknet/DS_Multilist.hpp b/include/raknet/DS_Multilist.hpp new file mode 100644 index 0000000..f2c7be2 --- /dev/null +++ b/include/raknet/DS_Multilist.hpp @@ -0,0 +1,1650 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_Multilist.h +/// \internal +/// \brief ADT that can represent an unordered list, ordered list, stack, or queue with a common interface +/// + +#ifndef __MULTILIST_H +#define __MULTILIST_H + +#include "RakAssert.hpp" +#include // memmove +#include "Export.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" + + +#ifdef _MSC_VER +#pragma warning( push ) +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#pragma warning( disable : 4512 ) // warning C4512: assignment operator could not be generated +#endif + +/// What algorithm to use to store the data for the Multilist +enum MultilistType +{ + /// Removing from the middle of the list will swap the end of the list rather than shift the elements. Push and Pop operate on the tail. + ML_UNORDERED_LIST, + /// A normal list, with the list order preserved. Push and Pop operate on the tail. + ML_STACK, + /// A queue. Push and Pop operate on the head + ML_QUEUE, + /// A list that is always kept in order. Elements must be unique, and compare against each other consistently using <, ==, and > + ML_ORDERED_LIST, + /// A list whose type can change at runtime + ML_VARIABLE_DURING_RUNTIME +}; + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + /// Can be used with Multilist::ForEach + /// Assuming the Multilist holds pointers, will delete those pointers + template + void DeletePtr_RakNet(templateType &ptr, const char *file, unsigned int line ) {RakNet::OP_DELETE(ptr, file, line);} + + /// Can be used with Multilist::ForEach + /// Assuming the Multilist holds pointers, will delete those pointers + template + void DeletePtr(templateType &ptr) {delete ptr;} + + /// The following is invalid. + /// bool operator<( const MyClass *myClass, const int &inputKey ) {return myClass->value < inputKey;} + /// At least one type has to be a reference to a class + /// MLKeyRef is a helper class to turn a native type into a class, so you can compare that native type against a pointer to a different class + /// Used for he Multilist, when _DataType != _KeyType + template < class templateType > + class MLKeyRef + { + public: + MLKeyRef(const templateType& input) : val(input) {} + const templateType &Get(void) const {return val;} + bool operator<( const templateType &right ) {return val < right;} + bool operator>( const templateType &right ) {return val > right;} + bool operator==( const templateType &right ) {return val == right;} + protected: + const templateType &val; + }; + + /// For the Multilist, when _DataType != _KeyType, you must define the comparison operators between the key and the data + /// This is non-trivial due to the need to use MLKeyRef in case the type held is a pointer to a structure or class and the key type is not a class + /// For convenience, this macro will implement the comparison operators under the following conditions + /// 1. _DataType is a pointer to a class or structure + /// 2. The key is a member variable of _DataType + #define DEFINE_MULTILIST_PTR_TO_MEMBER_COMPARISONS( _CLASS_NAME_, _KEY_TYPE_, _MEMBER_VARIABLE_NAME_ ) \ + bool operator<( const DataStructures::MLKeyRef<_KEY_TYPE_> &inputKey, const _CLASS_NAME_ *cls ) {return inputKey.Get() < cls->_MEMBER_VARIABLE_NAME_;} \ + bool operator>( const DataStructures::MLKeyRef<_KEY_TYPE_> &inputKey, const _CLASS_NAME_ *cls ) {return inputKey.Get() > cls->_MEMBER_VARIABLE_NAME_;} \ + bool operator==( const DataStructures::MLKeyRef<_KEY_TYPE_> &inputKey, const _CLASS_NAME_ *cls ) {return inputKey.Get() == cls->_MEMBER_VARIABLE_NAME_;} + + typedef uint32_t DefaultIndexType; + + /// \brief The multilist, representing an abstract data type that generally holds lists. + /// \param[in] _MultilistType What type of list this is, \sa MultilistType + /// \param[in] _DataType What type of data this list holds. + /// \param[in] _KeyType If a function takes a key to sort on, what type of key this is. The comparison operator between _DataType and _KeyType must be defined + /// \param[in] _IndexType What variable type to use for indices + template + class RAK_DLL_EXPORT Multilist + { + public: + Multilist(); + ~Multilist(); + Multilist( const Multilist& source ); + Multilist& operator= ( const Multilist& source ); + _DataType& operator[] ( const _IndexType position ) const; + /// Unordered list, stack is LIFO + /// QUEUE is FIFO + /// Ordered list is inserted in order + void Push(const _DataType &d, const char *file=__FILE__, unsigned int line=__LINE__ ); + void Push(const _DataType &d, const _KeyType &key, const char *file=__FILE__, unsigned int line=__LINE__ ); + + /// \brief Gets or removes and gets an element from the list, according to the same rules as Push(). + /// Ordered list is LIFO for the purposes of Pop and Peek. + _DataType &Pop(const char *file=__FILE__, unsigned int line=__LINE__); + _DataType &Peek(void) const; + + /// \brief Same as Push(), except FIFO and LIFO are reversed. + /// Ordered list still inserts in order. + void PushOpposite(const _DataType &d, const char *file=__FILE__, unsigned int line=__LINE__ ); + void PushOpposite(const _DataType &d, const _KeyType &key, const char *file=__FILE__, unsigned int line=__LINE__ ); + + /// \brief Same as Pop() and Peek(), except FIFO and LIFO are reversed. + _DataType &PopOpposite(const char *file=__FILE__, unsigned int line=__LINE__); + _DataType &PeekOpposite(void) const; + + /// \brief Stack,Queue: Inserts at index indicated, elements are shifted. + /// Ordered list: Inserts, position is ignored + void InsertAtIndex(const _DataType &d, _IndexType index, const char *file=__FILE__, unsigned int line=__LINE__); + + /// \brief Unordered list, removes at index indicated, swaps last element with that element. + /// Otherwise, array is shifted left to overwrite removed element + /// \details Index[0] returns the same as Pop() for a queue. + /// Same as PopOpposite() for the list and ordered list + void RemoveAtIndex(_IndexType position, const char *file=__FILE__, unsigned int line=__LINE__); + + /// \brief Find the index of \a key, and remove at that index. + bool RemoveAtKey(_KeyType key, bool assertIfDoesNotExist, const char *file=__FILE__, unsigned int line=__LINE__); + + /// \brief Finds the index of \a key. Return -1 if the key is not found. + _IndexType GetIndexOf(_KeyType key) const; + + /// \brief Returns where in the list we should insert the item, to preserve list order. + /// Returns -1 if the item is already in the list + _IndexType GetInsertionIndex(_KeyType key) const; + + /// \brief Finds the index of \a key. Return 0 if the key is not found. Useful if _DataType is always non-zero pointers. + _DataType GetPtr(_KeyType key) const; + + /// \brief Iterate over the list, calling the function pointer on each element. + void ForEach(void (*func)(_DataType &item, const char *file, unsigned int line), const char *file, unsigned int line); + void ForEach(void (*func)(_DataType &item)); + + /// \brief Returns if the list is empty. + bool IsEmpty(void) const; + + /// \brief Returns the number of elements used in the list. + _IndexType GetSize(void) const; + + /// \brief Empties the list. The list is not deallocated if it is small, + /// unless \a deallocateSmallBlocks is true + void Clear( bool deallocateSmallBlocks=true, const char *file=__FILE__, unsigned int line=__LINE__ ); + + /// \brief Empties the list, first calling RakNet::OP_Delete on all items. + /// \details The list is not deallocated if it is small, unless \a deallocateSmallBlocks is true + void ClearPointers( bool deallocateSmallBlocks=true, const char *file=__FILE__, unsigned int line=__LINE__ ); + + /// \brief Empty one item from the list, first calling RakNet::OP_Delete on that item. + void ClearPointer( _KeyType key, const char *file=__FILE__, unsigned int line=__LINE__ ); + + /// \brief Reverses the elements in the list, and flips the sort order + /// returned by GetSortOrder() if IsSorted() returns true at the time the function is called + void ReverseList(void); + + /// \brief Reallocates the list to a larger size. + /// If \a size is smaller than the value returned by GetSize(), the call does nothing. + void Reallocate(_IndexType size, const char *file=__FILE__, unsigned int line=__LINE__); + + /// \brief Sorts the list unless it is an ordered list, in which it does nothing as the list is assumed to already be sorted. + /// \details However, if \a force is true, it will also resort the ordered list, useful if the comparison operator between _KeyType and _DataType would now return different results + /// Once the list is sorted, further operations to lookup by key will be log2(n) until the list is modified + void Sort(bool force); + + /// \brief Sets the list to be remembered as sorted. + /// \details Optimization if the source is sorted already + void TagSorted(void); + + /// \brief Defaults to ascending. + /// \details Used by Sort(), and by ML_ORDERED_LIST + void SetSortOrder(bool ascending); + + /// \brief Returns true if ascending. + bool GetSortOrder(void) const; + + /// \brief Returns true if the list is currently believed to be in a sorted state. + /// \details Doesn't actually check for sortedness, just if Sort() + /// was recently called, or MultilistType is ML_ORDERED_LIST + bool IsSorted(void) const; + + /// Returns what type of list this is + MultilistType GetMultilistType(void) const; + + /// \brief Changes what type of list this is. + /// \pre Template must be defined with ML_VARIABLE_DURING_RUNTIME for this to do anything + /// \param[in] mlType Any value of the enum MultilistType, except ML_VARIABLE_DURING_RUNTIME + void SetMultilistType(MultilistType newType); + + /// \brief Returns the intersection of two lists. + /// Intersection is items common to both lists. + static void FindIntersection( + Multilist& source1, + Multilist& source2, + Multilist& intersection, + Multilist& uniqueToSource1, + Multilist& uniqueToSource2); + + protected: + void ReallocateIfNeeded(const char *file, unsigned int line); + void DeallocateIfNeeded(const char *file, unsigned int line); + void ReallocToSize(_IndexType newAllocationSize, const char *file, unsigned int line); + void ReverseListInternal(void); + void InsertInOrderedList(const _DataType &d, const _KeyType &key); + _IndexType GetIndexFromKeyInSortedList(const _KeyType &key, bool *objectExists) const; + void InsertShiftArrayRight(const _DataType &d, _IndexType index); + void DeleteShiftArrayLeft(_IndexType index); + void QSortAscending(_IndexType left, _IndexType right); + void QSortDescending(_IndexType left, _IndexType right); + void CopySource( const Multilist& source ); + + /// An array of user values + _DataType* data; + + /// Number of elements in the list + _IndexType dataSize; + + /// Size of \a array + _IndexType allocationSize; + + /// Array index for the head of the queue + _IndexType queueHead; + + /// Array index for the tail of the queue + _IndexType queueTail; + + /// How many bytes the user chose to preallocate + /// Won't automatically deallocate below this + _IndexType preallocationSize; + + enum + { + ML_UNSORTED, + ML_SORTED_ASCENDING, + ML_SORTED_DESCENDING + } sortState; + + bool ascendingSort; + + // In case we are using the variable type multilist + MultilistType variableMultilistType; + }; + + template + Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Multilist() + { + data=0; + dataSize=0; + allocationSize=0; + ascendingSort=true; + sortState=ML_UNSORTED; + queueHead=0; + queueTail=0; + preallocationSize=0; + + if (_MultilistType==ML_ORDERED_LIST) + sortState=ML_SORTED_ASCENDING; + else + sortState=ML_UNSORTED; + + if (_MultilistType==ML_VARIABLE_DURING_RUNTIME) + variableMultilistType=ML_UNORDERED_LIST; + } + + template + Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::~Multilist() + { + if (data!=0) + RakNet::OP_DELETE_ARRAY(data, _FILE_AND_LINE_); + } + + template + Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Multilist( const Multilist& source ) + { + CopySource(source); + } + + template + Multilist<_MultilistType, _DataType, _KeyType, _IndexType>& Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::operator= ( const Multilist& source ) + { + Clear(true); + CopySource(source); + return *this; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::CopySource( const Multilist& source ) + { + dataSize=source.GetSize(); + ascendingSort=source.ascendingSort; + sortState=source.sortState; + queueHead=0; + queueTail=dataSize; + preallocationSize=source.preallocationSize; + variableMultilistType=source.variableMultilistType; + if (source.data==0) + { + data=0; + allocationSize=0; + } + else + { + allocationSize=dataSize; + data = RakNet::OP_NEW_ARRAY<_DataType>(dataSize,_FILE_AND_LINE_); + _IndexType i; + for (i=0; i < dataSize; i++) + data[i]=source[i]; + } + } + + template + _DataType& Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::operator[] ( const _IndexType position ) const + { + RakAssert(position= allocationSize ) + return data[ queueHead + position - allocationSize ]; + else + return data[ queueHead + position ]; + } + + return data[position]; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Push(const _DataType &d, const char *file, unsigned int line ) + { + Push(d,d,file,line); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Push(const _DataType &d, const _KeyType &key, const char *file, unsigned int line ) + { + ReallocateIfNeeded(file,line); + + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK) + { + data[dataSize]=d; + dataSize++; + } + else if (GetMultilistType()==ML_QUEUE) + { + data[queueTail++] = d; + + if ( queueTail == allocationSize ) + queueTail = 0; + dataSize++; + } + else + { + RakAssert(GetMultilistType()==ML_ORDERED_LIST); + InsertInOrderedList(d,key); + } + + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK || GetMultilistType()==ML_QUEUE) + { + // Break sort if no longer sorted + if (sortState!=ML_UNSORTED && dataSize>1) + { + if (ascendingSort) + { + if ( MLKeyRef<_KeyType>(key) < operator[](dataSize-2) ) + sortState=ML_UNSORTED; + } + else + { + if ( MLKeyRef<_KeyType>(key) > operator[](dataSize-2) ) + sortState=ML_UNSORTED; + } + + sortState=ML_UNSORTED; + } + } + } + + template + _DataType &Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Pop(const char *file, unsigned int line) + { + RakAssert(IsEmpty()==false); + DeallocateIfNeeded(file,line); + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK || GetMultilistType()==ML_ORDERED_LIST) + { + dataSize--; + return data[dataSize]; + } + else + { + RakAssert(GetMultilistType()==ML_QUEUE); + + if ( ++queueHead == allocationSize ) + queueHead = 0; + + if ( queueHead == 0 ) + return data[ allocationSize -1 ]; + + dataSize--; + return data[ queueHead -1 ]; + } + } + + template + _DataType &Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Peek(void) const + { + RakAssert(IsEmpty()==false); + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK || GetMultilistType()==ML_ORDERED_LIST) + { + return data[dataSize-1]; + } + else + { + RakAssert(GetMultilistType()==ML_QUEUE); + return data[ queueHead ]; + } + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::PushOpposite(const _DataType &d, const char *file, unsigned int line ) + { + PushOpposite(d,d,file,line); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::PushOpposite(const _DataType &d, const _KeyType &key, const char *file, unsigned int line ) + { + ReallocateIfNeeded(file,line); + + // Unordered list Push at back + if (GetMultilistType()==ML_UNORDERED_LIST) + { + data[dataSize]=d; + dataSize++; + } + else if (GetMultilistType()==ML_STACK) + { + // Stack push at front of the list, instead of back as normal + InsertAtIndex(d,0,file,line); + } + else if (GetMultilistType()==ML_QUEUE) + { + // Queue push at front of the list, instead of back as normal + InsertAtIndex(d,0,file,line); + } + else + { + RakAssert(GetMultilistType()==ML_ORDERED_LIST); + InsertInOrderedList(d,key); + } + + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK || GetMultilistType()==ML_QUEUE) + { + // Break sort if no longer sorted + if (sortState!=ML_UNSORTED && dataSize>1) + { + if (ascendingSort) + { + if ( MLKeyRef<_KeyType>(key) > operator[](1) ) + sortState=ML_UNSORTED; + } + else + { + if ( MLKeyRef<_KeyType>(key) < operator[](1) ) + sortState=ML_UNSORTED; + } + } + } + } + + template + _DataType &Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::PopOpposite(const char *file, unsigned int line) + { + RakAssert(IsEmpty()==false); + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK || GetMultilistType()==ML_ORDERED_LIST) + { + // Copy leftmost to end + ReallocateIfNeeded(file,line); + data[dataSize]=data[0]; + DeleteShiftArrayLeft(0); + --dataSize; + // Assuming still leaves at least one element past the end of the list allocated + DeallocateIfNeeded(file,line); + // Return end + return data[dataSize+1]; + } + else + { + RakAssert(GetMultilistType()==ML_QUEUE); + // Deallocate first, since we are returning off the existing list + DeallocateIfNeeded(file,line); + dataSize--; + + if (queueTail==0) + queueTail=allocationSize-1; + else + --queueTail; + + return data[queueTail]; + } + } + + template + _DataType &Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::PeekOpposite(void) const + { + RakAssert(IsEmpty()==false); + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK || GetMultilistType()==ML_ORDERED_LIST) + { + return data[0]; + } + else + { + RakAssert(GetMultilistType()==ML_QUEUE); + _IndexType priorIndex; + if (queueTail==0) + priorIndex=allocationSize-1; + else + priorIndex=queueTail-1; + + return data[priorIndex]; + } + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::InsertAtIndex(const _DataType &d, _IndexType index, const char *file, unsigned int line) + { + ReallocateIfNeeded(file,line); + + if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK || GetMultilistType()==ML_ORDERED_LIST) + { + if (index>=dataSize) + { + // insert at end + data[dataSize]=d; + + dataSize++; + } + else + { + // insert at index + InsertShiftArrayRight(d,index); + } + } + else + { + data[queueTail++] = d; + + if ( queueTail == allocationSize ) + queueTail = 0; + + ++dataSize; + + if (dataSize==1) + return; + + _IndexType writeIndex, readIndex, trueWriteIndex, trueReadIndex; + writeIndex=dataSize-1; + readIndex=writeIndex-1; + while (readIndex >= index) + { + if ( queueHead + writeIndex >= allocationSize ) + trueWriteIndex = queueHead + writeIndex - allocationSize; + else + trueWriteIndex = queueHead + writeIndex; + + if ( queueHead + readIndex >= allocationSize ) + trueReadIndex = queueHead + readIndex - allocationSize; + else + trueReadIndex = queueHead + readIndex; + + data[trueWriteIndex]=data[trueReadIndex]; + + if (readIndex==0) + break; + writeIndex--; + readIndex--; + } + + if ( queueHead + index >= allocationSize ) + trueWriteIndex = queueHead + index - allocationSize; + else + trueWriteIndex = queueHead + index; + + data[trueWriteIndex]=d; + } + + if (_MultilistType!=ML_ORDERED_LIST) + sortState=ML_UNSORTED; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::RemoveAtIndex(_IndexType position, const char *file, unsigned int line) + { + RakAssert(position < dataSize); + RakAssert(IsEmpty()==false); + + if (GetMultilistType()==ML_UNORDERED_LIST) + { + // Copy tail to current + data[position]=data[dataSize-1]; + } + else if (GetMultilistType()==ML_STACK || GetMultilistType()==ML_ORDERED_LIST) + { + DeleteShiftArrayLeft(position); + } + else + { + RakAssert(GetMultilistType()==ML_QUEUE); + + _IndexType index, next; + + if ( queueHead + position >= allocationSize ) + index = queueHead + position - allocationSize; + else + index = queueHead + position; + + next = index + 1; + + if ( next == allocationSize ) + next = 0; + + while ( next != queueTail ) + { + // Overwrite the previous element + data[ index ] = data[ next ]; + index = next; + //next = (next + 1) % allocationSize; + + if ( ++next == allocationSize ) + next = 0; + } + + // Move the queueTail back + if ( queueTail == 0 ) + queueTail = allocationSize - 1; + else + --queueTail; + } + + + dataSize--; + DeallocateIfNeeded(file,line); + } + + template + bool Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::RemoveAtKey(_KeyType key, bool assertIfDoesNotExist, const char *file, unsigned int line) + { + _IndexType index = GetIndexOf(key); + if (index==(_IndexType)-1) + { + RakAssert(assertIfDoesNotExist==false && "RemoveAtKey element not found"); + return false; + } + RemoveAtIndex(index,file,line); + return true; + } + + template + _IndexType Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::GetIndexOf(_KeyType key) const + { + _IndexType i; + if (IsSorted()) + { + bool objectExists; + i=GetIndexFromKeyInSortedList(key, &objectExists); + if (objectExists) + return i; + return (_IndexType)-1; + } + else if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK) + { + for (i=0; i < dataSize; i++) + { + if (MLKeyRef<_KeyType>(key)==data[i]) + return i; + } + return (_IndexType)-1; + } + else + { + RakAssert( GetMultilistType()==ML_QUEUE ); + + for (i=0; i < dataSize; i++) + { + if (MLKeyRef<_KeyType>(key)==operator[](i)) + return i; + } + return (_IndexType)-1; + } + } + + template + _IndexType Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::GetInsertionIndex(_KeyType key) const + { + _IndexType i; + if (IsSorted()) + { + bool objectExists; + i=GetIndexFromKeyInSortedList(key, &objectExists); + if (objectExists) + return (_IndexType)-1; + return i; + } + else if (GetMultilistType()==ML_UNORDERED_LIST || GetMultilistType()==ML_STACK) + { + for (i=0; i < dataSize; i++) + { + if (MLKeyRef<_KeyType>(key)==data[i]) + return (_IndexType)-1; + } + return dataSize; + } + else + { + RakAssert( GetMultilistType()==ML_QUEUE ); + + for (i=0; i < dataSize; i++) + { + if (MLKeyRef<_KeyType>(key)==operator[](i)) + return (_IndexType)-1; + } + return dataSize; + } + } + + template + _DataType Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::GetPtr(_KeyType key) const + { + _IndexType i = GetIndexOf(key); + if (i==(_IndexType)-1) + return 0; + return data[i]; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ForEach(void (*func)(_DataType &item, const char *file, unsigned int line), const char *file, unsigned int line) + { + _IndexType i; + for (i=0; i < dataSize; i++) + func(operator[](i), file, line); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ForEach(void (*func)(_DataType &item)) + { + _IndexType i; + for (i=0; i < dataSize; i++) + func(operator[](i)); + } + + template + bool Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::IsEmpty(void) const + { + return dataSize==0; + } + + template + _IndexType Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::GetSize(void) const + { + return dataSize; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Clear( bool deallocateSmallBlocks, const char *file, unsigned int line ) + { + dataSize=0; + if (GetMultilistType()==ML_ORDERED_LIST) + if (ascendingSort) + sortState=ML_SORTED_ASCENDING; + else + sortState=ML_SORTED_DESCENDING; + else + sortState=ML_UNSORTED; + queueHead=0; + queueTail=0; + + if (deallocateSmallBlocks && allocationSize < 128 && data) + { + RakNet::OP_DELETE_ARRAY(data,file,line); + data=0; + allocationSize=0; + } + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ClearPointers( bool deallocateSmallBlocks, const char *file, unsigned int line ) + { + _IndexType i; + for (i=0; i < dataSize; i++) + RakNet::OP_DELETE(operator[](i), file, line); + Clear(deallocateSmallBlocks, file, line); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ClearPointer( _KeyType key, const char *file, unsigned int line ) + { + _IndexType i; + i = GetIndexOf(key); + if (i!=-1) + { + RakNet::OP_DELETE(operator[](i), file, line); + RemoveAtIndex(i); + } + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ReverseList(void) + { + if (IsSorted()) + ascendingSort=!ascendingSort; + + ReverseListInternal(); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Reallocate(_IndexType size, const char *file, unsigned int line) + { + _IndexType newAllocationSize; + if (size < dataSize) + newAllocationSize=dataSize; + else + newAllocationSize=size; + preallocationSize=size; + ReallocToSize(newAllocationSize,file,line); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::Sort(bool force) + { + if (IsSorted() && force==false) + return; + + if (dataSize>1) + { + if (ascendingSort) + QSortAscending(0,dataSize-1); + else + QSortDescending(0,dataSize-1); + } + + TagSorted(); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::TagSorted(void) + { + if (ascendingSort) + sortState=ML_SORTED_ASCENDING; + else + sortState=ML_SORTED_DESCENDING; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::QSortAscending(_IndexType leftEdge, _IndexType rightEdge) + { + _DataType temp; + _IndexType left=leftEdge; + _IndexType right=rightEdge; + _IndexType pivotIndex=left++; + + while (left data[pivotIndex]) + { + --left; + + data[pivotIndex]=data[left]; + data[left]=temp; + } + else + { + data[pivotIndex]=data[left]; + data[left]=temp; + + --left; + } + + if (left!=leftEdge) + QSortAscending(leftEdge, left); + + if (right!=rightEdge) + QSortAscending(right, rightEdge); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::QSortDescending(_IndexType leftEdge, _IndexType rightEdge) + { + _DataType temp; + _IndexType left=leftEdge; + _IndexType right=rightEdge; + _IndexType pivotIndex=left++; + + while (left= data[pivotIndex]) + { + ++left; + } + else + { + temp=data[left]; + data[left]=data[right]; + data[right]=temp; + --right; + } + } + + temp=data[pivotIndex]; + + // Move pivot to center + if (data[left] < data[pivotIndex]) + { + --left; + + data[pivotIndex]=data[left]; + data[left]=temp; + } + else + { + data[pivotIndex]=data[left]; + data[left]=temp; + + --left; + } + + if (left!=leftEdge) + QSortDescending(leftEdge, left); + + if (right!=rightEdge) + QSortDescending(right, rightEdge); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::SetSortOrder(bool ascending) + { + if (ascendingSort!=ascending && IsSorted()) + { + ascendingSort=ascending; + // List is sorted, and the sort order has changed. So reverse the list + ReverseListInternal(); + } + else + ascendingSort=ascending; + } + + template + bool Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::GetSortOrder(void) const + { + return ascendingSort; + } + + template + bool Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::IsSorted(void) const + { + return GetMultilistType()==ML_ORDERED_LIST || sortState!=ML_UNSORTED; + } + + template + MultilistType Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::GetMultilistType(void) const + { + if (_MultilistType==ML_VARIABLE_DURING_RUNTIME) + return variableMultilistType; + return _MultilistType; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::SetMultilistType(MultilistType newType) + { + RakAssert(_MultilistType==ML_VARIABLE_DURING_RUNTIME); + switch (variableMultilistType) + { + case ML_UNORDERED_LIST: + switch (newType) + { + case ML_UNORDERED_LIST: + // No change + break; + case ML_STACK: + // Same data format + break; + case ML_QUEUE: + queueHead=0; + queueTail=dataSize; + break; + case ML_ORDERED_LIST: + Sort(false); + break; + } + break; + case ML_STACK: + switch (newType) + { + case ML_UNORDERED_LIST: + // Same data format + break; + case ML_STACK: + // No change + break; + case ML_QUEUE: + queueHead=0; + queueTail=dataSize; + break; + case ML_ORDERED_LIST: + Sort(false); + break; + } + break; + case ML_QUEUE: + switch (newType) + { + case ML_UNORDERED_LIST: + case ML_STACK: + case ML_ORDERED_LIST: + if (queueTail < queueHead) + { + // Realign data if wrapped + ReallocToSize(dataSize, _FILE_AND_LINE_); + } + else + { + // Else can just copy starting at head + _IndexType i; + for (i=0; i < dataSize; i++) + data[i]=operator[](i); + } + if (newType==ML_ORDERED_LIST) + Sort(false); + break; + case ML_QUEUE: + // No change + break; + } + break; + case ML_ORDERED_LIST: + switch (newType) + { + case ML_UNORDERED_LIST: + case ML_STACK: + case ML_QUEUE: + // Same data format + // Tag as sorted + if (ascendingSort) + sortState=ML_SORTED_ASCENDING; + else + sortState=ML_SORTED_DESCENDING; + if (newType==ML_QUEUE) + { + queueHead=0; + queueTail=dataSize; + } + break; + case ML_ORDERED_LIST: + // No change + break; + } + break; + } + + variableMultilistType=newType; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::FindIntersection( + Multilist& source1, + Multilist& source2, + Multilist& intersection, + Multilist& uniqueToSource1, + Multilist& uniqueToSource2) + { + _IndexType index1=0, index2=0; + source1.SetSortOrder(true); + source2.SetSortOrder(true); + source1.Sort(false); + source2.Sort(false); + intersection.Clear(true,_FILE_AND_LINE_); + uniqueToSource1.Clear(true,_FILE_AND_LINE_); + uniqueToSource2.Clear(true,_FILE_AND_LINE_); + + while (index1 < source1.GetSize() && index2 < source2.GetSize()) + { + if (source1[index1] + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ReallocateIfNeeded(const char *file, unsigned int line) + { + if (dataSize65536) + newAllocationSize=allocationSize+65536; + else + { + newAllocationSize=allocationSize<<1; // * 2 + // Protect against underflow + if (newAllocationSize < allocationSize) + newAllocationSize=allocationSize+65536; + } + + ReallocToSize(newAllocationSize,file,line); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::DeallocateIfNeeded(const char *file, unsigned int line) + { + if (allocationSize<512) + return; + if (dataSize >= allocationSize/3 ) + return; + if (dataSize <= preallocationSize ) + return; + + _IndexType newAllocationSize = dataSize<<1; // * 2 + + ReallocToSize(newAllocationSize,file,line); + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ReallocToSize(_IndexType newAllocationSize, const char *file, unsigned int line) + { + _DataType* newData = RakNet::OP_NEW_ARRAY<_DataType>(newAllocationSize,file,line); + _IndexType i; + for (i=0; i < dataSize; i++) + newData[i]=operator[](i); + if (dataSize>0) + { + RakNet::OP_DELETE_ARRAY(data,file,line); + if (GetMultilistType()==ML_QUEUE) + { + queueHead=0; + queueTail=dataSize; + } + } + data=newData; + allocationSize=newAllocationSize; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::ReverseListInternal(void) + { + _DataType temp; + _IndexType i; + for (i=0; i < dataSize/2; i++) + { + temp=operator[](i); + operator[](i)=operator[](dataSize-1-i); + operator[](dataSize-1-i)=temp; + } + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::InsertInOrderedList(const _DataType &d, const _KeyType &key) + { + RakAssert(GetMultilistType()==ML_ORDERED_LIST); + + bool objectExists; + _IndexType index; + index = GetIndexFromKeyInSortedList(key, &objectExists); + + // if (objectExists) + // { + // Ordered list only allows unique insertions + // RakAssert("Duplicate insertion into ordered list" && false); + // return; + // } + + if (index>=dataSize) + { + // insert at end + data[dataSize]=d; + dataSize++; + } + else + { + // insert at index + InsertShiftArrayRight(d,index); + } + } + + template + _IndexType Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::GetIndexFromKeyInSortedList(const _KeyType &key, bool *objectExists) const + { + RakAssert(IsSorted()); + _IndexType index, upperBound, lowerBound; + + if (dataSize==0) + { + *objectExists=false; + return 0; + } + + upperBound=dataSize-1; + lowerBound=0; + index = dataSize/2; + +#ifdef _MSC_VER + #pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + while (1) + { + if (MLKeyRef<_KeyType>(key) > operator[](index) ) + { + if (ascendingSort) + lowerBound=index+1; + else + upperBound=index-1; + } + else if (MLKeyRef<_KeyType>(key) < operator[](index) ) + { + if (ascendingSort) + upperBound=index-1; + else + lowerBound=index+1; + } + else + { + // == + *objectExists=true; + return index; + } + + index=lowerBound+(upperBound-lowerBound)/2; + + if (lowerBound>upperBound || upperBound==(_IndexType)-1) + { + *objectExists=false; + return lowerBound; // No match + } + } + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::InsertShiftArrayRight(const _DataType &d, _IndexType index) + { + RakAssert(_MultilistType!=ML_QUEUE); + + // Move the elements in the list to make room + _IndexType i; + for ( i = dataSize; i != index; i-- ) + data[ i ] = data[ i - 1 ]; + + // Insert the new item at the correct spot + data[ index ] = d; + + ++dataSize; + } + + template + void Multilist<_MultilistType, _DataType, _KeyType, _IndexType>::DeleteShiftArrayLeft( _IndexType index ) + { + RakAssert(index < dataSize); + RakAssert(_MultilistType!=ML_QUEUE); + + _IndexType i; + for ( i = index; i < dataSize-1; i++ ) + data[i]=data[i+1]; + } +}; + +/* +struct KeyAndValue +{ + int key; + short value; +}; + +DEFINE_MULTILIST_PTR_TO_MEMBER_COMPARISONS(KeyAndValue,int,key) + +void MultilistUnitTest(void) +{ + DataStructures::DefaultIndexType oldSize; + DataStructures::Multilist ml1; + ml1.Reallocate(64); + RakAssert(ml1.IsEmpty()); + ml1.Push(53); + RakAssert(ml1.Peek()==53); + RakAssert(ml1.IsEmpty()==false); + RakAssert(ml1.Pop()==53); + RakAssert(ml1.IsEmpty()==true); + for (int i=0; i < 512; i++) + ml1.Push(i); + RakAssert(ml1.GetIndexOf(200)==200); + RakAssert(ml1.PeekOpposite()==0); + RakAssert(ml1.PopOpposite()==0); + RakAssert(ml1.PeekOpposite()==1); + RakAssert(ml1.Peek()==511); + ml1.ReverseList(); + for (int i=0; i < 511; i++) + RakAssert(ml1[i]==511-i); + RakAssert(ml1.PeekOpposite()==511); + RakAssert(ml1.Peek()==1); + oldSize = ml1.GetSize(); + ml1.RemoveAtIndex(0); + RakAssert(ml1.GetSize()==oldSize-1); + RakAssert(ml1.PeekOpposite()==1); + ml1.Clear(_FILE_AND_LINE_); + RakAssert(ml1.IsEmpty()==true); + + ml1.Sort(true); + ml1.Clear(_FILE_AND_LINE_); + + ml1.Push(100); + ml1.Sort(true); + ml1.Clear(_FILE_AND_LINE_); + + ml1.Push(50); + ml1.Push(100); + ml1.Sort(true); + ml1.Clear(_FILE_AND_LINE_); + + ml1.Push(100); + ml1.Push(50); + ml1.Sort(true); + ml1.Clear(_FILE_AND_LINE_); + + ml1.Push(100); + ml1.Push(50); + ml1.Push(150); + ml1.Push(25); + ml1.Push(175); + ml1.Sort(true); + RakAssert(ml1[0]==25); + RakAssert(ml1[1]==50); + RakAssert(ml1[2]==100); + RakAssert(ml1[3]==150); + RakAssert(ml1[4]==175); + RakAssert(ml1.GetIndexOf(25)==0); + RakAssert(ml1.GetIndexOf(50)==1); + RakAssert(ml1.GetIndexOf(100)==2); + RakAssert(ml1.GetIndexOf(150)==3); + RakAssert(ml1.GetIndexOf(175)==4); + ml1.Clear(_FILE_AND_LINE_); + + ml1.Push(1); + ml1.Push(2); + ml1.Push(3); + ml1.Push(4); + ml1.Push(5); + ml1.Sort(true); + RakAssert(ml1[0]==1); + RakAssert(ml1[1]==2); + RakAssert(ml1[2]==3); + RakAssert(ml1[3]==4); + RakAssert(ml1[4]==5); + RakAssert(ml1.GetIndexOf(1)==0); + RakAssert(ml1.GetIndexOf(2)==1); + RakAssert(ml1.GetIndexOf(3)==2); + RakAssert(ml1.GetIndexOf(4)==3); + RakAssert(ml1.GetIndexOf(5)==4); + ml1.Clear(_FILE_AND_LINE_); + + ml1.Push(5); + ml1.Push(4); + ml1.Push(3); + ml1.Push(2); + ml1.Push(1); + ml1.Sort(true); + RakAssert(ml1[0]==1); + RakAssert(ml1[1]==2); + RakAssert(ml1[2]==3); + RakAssert(ml1[3]==4); + RakAssert(ml1[4]==5); + RakAssert(ml1.GetIndexOf(1)==0); + RakAssert(ml1.GetIndexOf(2)==1); + RakAssert(ml1.GetIndexOf(3)==2); + RakAssert(ml1.GetIndexOf(4)==3); + RakAssert(ml1.GetIndexOf(5)==4); + ml1.Sort(true); + RakAssert(ml1[0]==1); + RakAssert(ml1[1]==2); + RakAssert(ml1[2]==3); + RakAssert(ml1[3]==4); + RakAssert(ml1[4]==5); + RakAssert(ml1.GetIndexOf(1)==0); + RakAssert(ml1.GetIndexOf(2)==1); + RakAssert(ml1.GetIndexOf(3)==2); + RakAssert(ml1.GetIndexOf(4)==3); + RakAssert(ml1.GetIndexOf(5)==4); + ml1.Clear(_FILE_AND_LINE_); + + DataStructures::Multilist ml2; + ml2.Reallocate(64); + RakAssert(ml2.IsEmpty()); + ml2.Push(53); + RakAssert(ml2.Peek()==53); + RakAssert(ml2.IsEmpty()==false); + RakAssert(ml2.Pop()==53); + RakAssert(ml2.IsEmpty()==true); + for (int i=0; i < 512; i++) + ml2.Push(i); + RakAssert(ml2.GetIndexOf(200)==200); + RakAssert(ml2.PeekOpposite()==0); + RakAssert(ml2.PopOpposite()==0); + RakAssert(ml2.PeekOpposite()==1); + RakAssert(ml2.Peek()==511); + ml2.ReverseList(); + for (int i=0; i < 511; i++) + RakAssert(ml2[i]==511-i); + RakAssert(ml2.PeekOpposite()==511); + RakAssert(ml2.Peek()==1); + oldSize = ml2.GetSize(); + ml2.RemoveAtIndex(0); + RakAssert(ml2.GetSize()==oldSize-1); + RakAssert(ml2.Peek()==1); + RakAssert(ml2.PeekOpposite()==510); + ml2.Clear(_FILE_AND_LINE_); + RakAssert(ml2.IsEmpty()==true); + + DataStructures::Multilist ml3; + RakAssert(ml3.IsEmpty()); + ml3.Push(53); + RakAssert(ml3.Peek()==53); + RakAssert(ml3.IsEmpty()==false); + RakAssert(ml3.Pop()==53); + RakAssert(ml3.IsEmpty()==true); + for (int i=0; i < 512; i++) + ml3.Push(i); + RakAssert(ml3.GetIndexOf(200)==200); + RakAssert(ml3.PeekOpposite()==511); + RakAssert(ml3.PopOpposite()==511); + RakAssert(ml3.PeekOpposite()==510); + RakAssert(ml3.Peek()==0); + ml3.ReverseList(); + for (int i=0; i < 511; i++) + RakAssert(ml3[i]==511-1-i); + RakAssert(ml3.PeekOpposite()==0); + RakAssert(ml3.Peek()==510); + oldSize = ml3.GetSize(); + ml3.RemoveAtIndex(0); + RakAssert(ml3.GetSize()==oldSize-1); + RakAssert(ml3.Peek()==509); + RakAssert(ml3.PeekOpposite()==0); + ml3.Clear(_FILE_AND_LINE_); + RakAssert(ml3.IsEmpty()==true); + + ml3.PushOpposite(100); + ml3.PushOpposite(50); + ml3.PushOpposite(150); + ml3.PushOpposite(25); + ml3.PushOpposite(175); + ml3.Sort(true); + RakAssert(ml3[0]==25); + RakAssert(ml3[1]==50); + RakAssert(ml3[2]==100); + RakAssert(ml3[3]==150); + RakAssert(ml3[4]==175); + RakAssert(ml3.GetIndexOf(25)==0); + RakAssert(ml3.GetIndexOf(50)==1); + RakAssert(ml3.GetIndexOf(100)==2); + RakAssert(ml3.GetIndexOf(150)==3); + RakAssert(ml3.GetIndexOf(175)==4); + ml3.Clear(_FILE_AND_LINE_); + + ml3.PushOpposite(1); + ml3.PushOpposite(2); + ml3.PushOpposite(3); + ml3.PushOpposite(4); + ml3.PushOpposite(5); + ml3.Sort(true); + RakAssert(ml3[0]==1); + RakAssert(ml3[1]==2); + RakAssert(ml3[2]==3); + RakAssert(ml3[3]==4); + RakAssert(ml3[4]==5); + RakAssert(ml3.GetIndexOf(1)==0); + RakAssert(ml3.GetIndexOf(2)==1); + RakAssert(ml3.GetIndexOf(3)==2); + RakAssert(ml3.GetIndexOf(4)==3); + RakAssert(ml3.GetIndexOf(5)==4); + ml3.Clear(_FILE_AND_LINE_); + + ml3.PushOpposite(5); + ml3.PushOpposite(4); + ml3.PushOpposite(3); + ml3.PushOpposite(2); + ml3.PushOpposite(1); + ml3.Sort(true); + RakAssert(ml3[0]==1); + RakAssert(ml3[1]==2); + RakAssert(ml3[2]==3); + RakAssert(ml3[3]==4); + RakAssert(ml3[4]==5); + RakAssert(ml3.GetIndexOf(1)==0); + RakAssert(ml3.GetIndexOf(2)==1); + RakAssert(ml3.GetIndexOf(3)==2); + RakAssert(ml3.GetIndexOf(4)==3); + RakAssert(ml3.GetIndexOf(5)==4); + ml3.Sort(true); + RakAssert(ml3[0]==1); + RakAssert(ml3[1]==2); + RakAssert(ml3[2]==3); + RakAssert(ml3[3]==4); + RakAssert(ml3[4]==5); + RakAssert(ml3.GetIndexOf(1)==0); + RakAssert(ml3.GetIndexOf(2)==1); + RakAssert(ml3.GetIndexOf(3)==2); + RakAssert(ml3.GetIndexOf(4)==3); + RakAssert(ml3.GetIndexOf(5)==4); + + ml3.SetSortOrder(false); + ml3.Sort(false); + RakAssert(ml3[0]==5); + RakAssert(ml3[1]==4); + RakAssert(ml3[2]==3); + RakAssert(ml3[3]==2); + RakAssert(ml3[4]==1); + RakAssert(ml3.GetIndexOf(1)==4); + RakAssert(ml3.GetIndexOf(2)==3); + RakAssert(ml3.GetIndexOf(3)==2); + RakAssert(ml3.GetIndexOf(4)==1); + RakAssert(ml3.GetIndexOf(5)==0); + + ml3.Clear(_FILE_AND_LINE_); + + DataStructures::Multilist ml4; + ml4.Reallocate(64); + RakAssert(ml4.IsEmpty()); + ml4.Push(53); + RakAssert(ml4.Peek()==53); + RakAssert(ml4.IsEmpty()==false); + RakAssert(ml4.Pop()==53); + RakAssert(ml4.IsEmpty()==true); + for (int i=0; i < 512; i++) + ml4.Push(i); + RakAssert(ml4.GetIndexOf(200)==200); + RakAssert(ml4.PeekOpposite()==0); + RakAssert(ml4.PopOpposite()==0); + RakAssert(ml4.PeekOpposite()==1); + RakAssert(ml4.Peek()==511); + ml4.ReverseList(); + for (int i=0; i < 511; i++) + RakAssert(ml4[i]==511-i); + RakAssert(ml4.PeekOpposite()==511); + RakAssert(ml4.Peek()==1); + oldSize = ml4.GetSize(); + ml4.RemoveAtIndex(0); + RakAssert(ml4.GetSize()==oldSize-1); + RakAssert(ml4.Peek()==1); + RakAssert(ml4.PeekOpposite()==510); + ml4.Clear(_FILE_AND_LINE_); + RakAssert(ml4.IsEmpty()==true); + + DataStructures::Multilist ml5; + + for (int i=0; i < 16; i++) + { + KeyAndValue *kav = new KeyAndValue; + kav->key=i; + kav->value=i+100; + ml5.Push(kav,kav->key); + } + + RakAssert(ml5.GetIndexOf(0)==0); + RakAssert(ml5.GetIndexOf(5)==5); + RakAssert(ml5.GetIndexOf(15)==15); + RakAssert(ml5.GetIndexOf(16)==-1); + ml5.RemoveAtKey(0,true); + RakAssert(ml5.GetIndexOf(1)==0); + KeyAndValue *iPtr = ml5.GetPtr(5); + RakAssert(iPtr); + RakAssert(iPtr->value=105); + iPtr = ml5.GetPtr(1234); + RakAssert(iPtr==0); + ml5.ForEach(DataStructures::DeletePtr); + + + DataStructures::Multilist ml6; + ml6.Push(2); + ml6.Push(1); + ml6.Push(6); + ml6.Push(3); + RakAssert(ml6.Peek()==3); + ml6.SetMultilistType(ML_STACK); + RakAssert(ml6.Peek()==3); + ml6.SetMultilistType(ML_QUEUE); + RakAssert(ml6.Peek()==2); + ml6.SetMultilistType(ML_ORDERED_LIST); + RakAssert(ml6.Peek()=6); + ml6.SetMultilistType(ML_STACK); + RakAssert(ml6.Peek()==6); + ml6.SetMultilistType(ML_QUEUE); + RakAssert(ml6.Peek()==1); +} + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif +*/ + +#endif diff --git a/include/raknet/DS_OrderedChannelHeap.hpp b/include/raknet/DS_OrderedChannelHeap.hpp new file mode 100644 index 0000000..ba82d24 --- /dev/null +++ b/include/raknet/DS_OrderedChannelHeap.hpp @@ -0,0 +1,251 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_OrderedChannelHeap.h +/// \internal +/// \brief Ordered Channel Heap . This is a heap where you add to it on multiple ordered channels, with each channel having a different weight. +/// + + +#ifndef __RAKNET_ORDERED_CHANNEL_HEAP_H +#define __RAKNET_ORDERED_CHANNEL_HEAP_H + +#include "DS_Heap.hpp" +#include "DS_Map.hpp" +#include "DS_Queue.hpp" +#include "Export.hpp" +#include "RakAssert.hpp" +#include "Rand.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + template > + class RAK_DLL_EXPORT OrderedChannelHeap + { + public: + static void IMPLEMENT_DEFAULT_COMPARISON(void) {DataStructures::defaultMapKeyComparison(channel_key_type(),channel_key_type());} + + OrderedChannelHeap(); + ~OrderedChannelHeap(); + void Push(const channel_key_type &channelID, const heap_data_type &data); + void PushAtHead(const unsigned index, const channel_key_type &channelID, const heap_data_type &data); + heap_data_type Pop(const unsigned startingIndex=0); + heap_data_type Peek(const unsigned startingIndex) const; + void AddChannel(const channel_key_type &channelID, const double weight); + void RemoveChannel(channel_key_type channelID); + void Clear(void); + heap_data_type& operator[] ( const unsigned int position ) const; + unsigned ChannelSize(const channel_key_type &channelID); + unsigned Size(void) const; + + struct QueueAndWeight + { + DataStructures::Queue randResultQueue; + double weight; + bool signalDeletion; + }; + + struct HeapChannelAndData + { + HeapChannelAndData() {} + HeapChannelAndData(const channel_key_type &_channel, const heap_data_type &_data) : data(_data), channel(_channel) {} + heap_data_type data; + channel_key_type channel; + }; + + protected: + DataStructures::Map map; + DataStructures::Heap heap; + void GreatestRandResult(void); + }; + + template + OrderedChannelHeap::OrderedChannelHeap() + { + } + + template + OrderedChannelHeap::~OrderedChannelHeap() + { + Clear(); + } + + template + void OrderedChannelHeap::Push(const channel_key_type &channelID, const heap_data_type &data) + { + PushAtHead(MAX_UNSIGNED_LONG, channelID, data); + } + + template + void OrderedChannelHeap::GreatestRandResult(void) + { + double greatest; + unsigned i; + greatest=0.0; + for (i=0; i < map.Size(); i++) + { + if (map[i]->randResultQueue.Size() && map[i]->randResultQueue[0]>greatest) + greatest=map[i]->randResultQueue[0]; + } + return greatest; + } + + template + void OrderedChannelHeap::PushAtHead(const unsigned index, const channel_key_type &channelID, const heap_data_type &data) + { + // If an assert hits here then this is an unknown channel. Call AddChannel first. + QueueAndWeight *queueAndWeight=map.Get(channelID); + double maxRange, minRange, rnd; + if (queueAndWeight->randResultQueue.Size()==0) + { + // Set maxRange to the greatest random number waiting to be returned, rather than 1.0 necessarily + // This is so weights are scaled similarly among channels. For example, if the head weight for a used channel was .25 + // and then we added another channel, the new channel would need to choose between .25 and 0 + // If we chose between 1.0 and 0, it would be 1/.25 (4x) more likely to be at the head of the heap than it should be + maxRange=GreatestRandResult(); + if (maxRange==0.0) + maxRange=1.0; + minRange=0.0; + } + else if (index >= queueAndWeight->randResultQueue.Size()) + { + maxRange=queueAndWeight->randResultQueue[queueAndWeight->randResultQueue.Size()-1]*.99999999; + minRange=0.0; + } + else + { + if (index==0) + { + maxRange=GreatestRandResult(); + if (maxRange==queueAndWeight->randResultQueue[0]) + maxRange=1.0; + } + else if (index >= queueAndWeight->randResultQueue.Size()) + maxRange=queueAndWeight->randResultQueue[queueAndWeight->randResultQueue.Size()-1]*.99999999; + else + maxRange=queueAndWeight->randResultQueue[index-1]*.99999999; + + minRange=maxRange=queueAndWeight->randResultQueue[index]*1.00000001; + } + +#ifdef _DEBUG + RakAssert(maxRange!=0.0); +#endif + rnd=frandomMT() * (maxRange - minRange); + if (rnd==0.0) + rnd=maxRange/2.0; + + if (index >= queueAndWeight->randResultQueue.Size()) + queueAndWeight->randResultQueue.Push(rnd); + else + queueAndWeight->randResultQueue.PushAtHead(rnd, index); + + heap.Push(rnd*queueAndWeight->weight, HeapChannelAndData(channelID, data)); + } + + template + heap_data_type OrderedChannelHeap::Pop(const unsigned startingIndex) + { + RakAssert(startingIndex < heap.Size()); + + QueueAndWeight *queueAndWeight=map.Get(heap[startingIndex].channel); + if (startingIndex!=0) + { + // Ugly - have to count in the heap how many nodes have the same channel, so we know where to delete from in the queue + unsigned indiceCount=0; + unsigned i; + for (i=0; i < startingIndex; i++) + if (channel_key_comparison_func(heap[i].channel,heap[startingIndex].channel)==0) + indiceCount++; + queueAndWeight->randResultQueue.RemoveAtIndex(indiceCount); + } + else + { + // TODO - ordered channel heap uses progressively lower values as items are inserted. But this won't give relative ordering among channels. I have to renormalize after every pop. + queueAndWeight->randResultQueue.Pop(); + } + + // Try to remove the channel after every pop, because doing so is not valid while there are elements in the list. + if (queueAndWeight->signalDeletion) + RemoveChannel(heap[startingIndex].channel); + + return heap.Pop(startingIndex).data; + } + + template + heap_data_type OrderedChannelHeap::Peek(const unsigned startingIndex) const + { + HeapChannelAndData heapChannelAndData = heap.Peek(startingIndex); + return heapChannelAndData.data; + } + + template + void OrderedChannelHeap::AddChannel(const channel_key_type &channelID, const double weight) + { + QueueAndWeight *qaw = RakNet::OP_NEW( _FILE_AND_LINE_ ); + qaw->weight=weight; + qaw->signalDeletion=false; + map.SetNew(channelID, qaw); + } + + template + void OrderedChannelHeap::RemoveChannel(channel_key_type channelID) + { + if (map.Has(channelID)) + { + unsigned i; + i=map.GetIndexAtKey(channelID); + if (map[i]->randResultQueue.Size()==0) + { + RakNet::OP_DELETE(map[i], _FILE_AND_LINE_); + map.RemoveAtIndex(i); + } + else + { + // Signal this channel for deletion later, because the heap has nodes with this channel right now + map[i]->signalDeletion=true; + } + } + } + + template + unsigned OrderedChannelHeap::Size(void) const + { + return heap.Size(); + } + + template + heap_data_type& OrderedChannelHeap::operator[]( const unsigned int position ) const + { + return heap[position].data; + } + + + template + unsigned OrderedChannelHeap::ChannelSize(const channel_key_type &channelID) + { + QueueAndWeight *queueAndWeight=map.Get(channelID); + return queueAndWeight->randResultQueue.Size(); + } + + template + void OrderedChannelHeap::Clear(void) + { + unsigned i; + for (i=0; i < map.Size(); i++) + RakNet::OP_DELETE(map[i], _FILE_AND_LINE_); + map.Clear(_FILE_AND_LINE_); + heap.Clear(_FILE_AND_LINE_); + } +} + +#endif diff --git a/include/raknet/DS_OrderedList.hpp b/include/raknet/DS_OrderedList.hpp new file mode 100644 index 0000000..0aa1fa7 --- /dev/null +++ b/include/raknet/DS_OrderedList.hpp @@ -0,0 +1,286 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_OrderedList.h +/// \internal +/// \brief Quicksort ordered list. +/// + +#include "DS_List.hpp" +#include "RakMemoryOverride.hpp" +#include "Export.hpp" + +#ifndef __ORDERED_LIST_H +#define __ORDERED_LIST_H + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + template + int defaultOrderedListComparison(const key_type &a, const data_type &b) + { + if (a > + class RAK_DLL_EXPORT OrderedList + { + public: + static void IMPLEMENT_DEFAULT_COMPARISON(void) {DataStructures::defaultOrderedListComparison(key_type(),data_type());} + + OrderedList(); + ~OrderedList(); + OrderedList( const OrderedList& original_copy ); + OrderedList& operator= ( const OrderedList& original_copy ); + + /// comparisonFunction must take a key_type and a data_type and return <0, ==0, or >0 + /// If the data type has comparison operators already defined then you can just use defaultComparison + bool HasData(const key_type &key, int (*cf)(const key_type&, const data_type&)=default_comparison_function) const; + // GetIndexFromKey returns where the insert should go at the same time checks if it is there + unsigned GetIndexFromKey(const key_type &key, bool *objectExists, int (*cf)(const key_type&, const data_type&)=default_comparison_function) const; + data_type GetElementFromKey(const key_type &key, int (*cf)(const key_type&, const data_type&)=default_comparison_function) const; + bool GetElementFromKey(const key_type &key, data_type &element, int (*cf)(const key_type&, const data_type&)=default_comparison_function) const; + unsigned Insert(const key_type &key, const data_type &data, bool assertOnDuplicate, const char *file, unsigned int line, int (*cf)(const key_type&, const data_type&)=default_comparison_function); + unsigned Remove(const key_type &key, int (*cf)(const key_type&, const data_type&)=default_comparison_function); + unsigned RemoveIfExists(const key_type &key, int (*cf)(const key_type&, const data_type&)=default_comparison_function); + data_type& operator[] ( const unsigned int position ) const; + void RemoveAtIndex(const unsigned index); + void InsertAtIndex(const data_type &data, const unsigned index, const char *file, unsigned int line); + void InsertAtEnd(const data_type &data, const char *file, unsigned int line); + void RemoveFromEnd(const unsigned num=1); + void Clear(bool doNotDeallocate, const char *file, unsigned int line); + unsigned Size(void) const; + + protected: + DataStructures::List orderedList; + }; + + template + OrderedList::OrderedList() + { + } + + template + OrderedList::~OrderedList() + { + Clear(false, _FILE_AND_LINE_); + } + + template + OrderedList::OrderedList( const OrderedList& original_copy ) + { + orderedList=original_copy.orderedList; + } + + template + OrderedList& OrderedList::operator= ( const OrderedList& original_copy ) + { + orderedList=original_copy.orderedList; + return *this; + } + + template + bool OrderedList::HasData(const key_type &key, int (*cf)(const key_type&, const data_type&)) const + { + bool objectExists; + GetIndexFromKey(key, &objectExists, cf); + return objectExists; + } + + template + data_type OrderedList::GetElementFromKey(const key_type &key, int (*cf)(const key_type&, const data_type&)) const + { + bool objectExists; + unsigned index; + index = GetIndexFromKey(key, &objectExists, cf); + RakAssert(objectExists); + return orderedList[index]; + } + template + bool OrderedList::GetElementFromKey(const key_type &key, data_type &element, int (*cf)(const key_type&, const data_type&)) const + { + bool objectExists; + unsigned index; + index = GetIndexFromKey(key, &objectExists, cf); + if (objectExists) + element = orderedList[index]; + return objectExists; + } + template + unsigned OrderedList::GetIndexFromKey(const key_type &key, bool *objectExists, int (*cf)(const key_type&, const data_type&)) const + { + int index, upperBound, lowerBound; + int res; + + if (orderedList.Size()==0) + { + *objectExists=false; + return 0; + } + + upperBound=(int)orderedList.Size()-1; + lowerBound=0; + index = (int)orderedList.Size()/2; + +#ifdef _MSC_VER + #pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + while (1) + { + res = cf(key,orderedList[index]); + if (res==0) + { + *objectExists=true; + return (unsigned)index; + } + else if (res<0) + { + upperBound=index-1; + } + else// if (res>0) + { + + lowerBound=index+1; + } + + index=lowerBound+(upperBound-lowerBound)/2; + + if (lowerBound>upperBound) + { + *objectExists=false; + return (unsigned)lowerBound; // No match + } + + if (index < 0 || index >= (int) orderedList.Size()) + { + // This should never hit unless the comparison function was inconsistent + RakAssert(index && 0); + *objectExists=false; + return 0; + } + } + } + + template + unsigned OrderedList::Insert(const key_type &key, const data_type &data, bool assertOnDuplicate, const char *file, unsigned int line, int (*cf)(const key_type&, const data_type&)) + { + (void) assertOnDuplicate; + bool objectExists; + unsigned index; + index = GetIndexFromKey(key, &objectExists, cf); + + // Don't allow duplicate insertion. + if (objectExists) + { + // This is usually a bug! + RakAssert(assertOnDuplicate==false); + return (unsigned)-1; + } + + if (index>=orderedList.Size()) + { + orderedList.Insert(data, file, line); + return orderedList.Size()-1; + } + else + { + orderedList.Insert(data,index, file, line); + return index; + } + } + + template + unsigned OrderedList::Remove(const key_type &key, int (*cf)(const key_type&, const data_type&)) + { + bool objectExists; + unsigned index; + index = GetIndexFromKey(key, &objectExists, cf); + + // Can't find the element to remove if this assert hits + // RakAssert(objectExists==true); + if (objectExists==false) + { + RakAssert(objectExists==true); + return 0; + } + + orderedList.RemoveAtIndex(index); + return index; + } + + template + unsigned OrderedList::RemoveIfExists(const key_type &key, int (*cf)(const key_type&, const data_type&)) + { + bool objectExists; + unsigned index; + index = GetIndexFromKey(key, &objectExists, cf); + + // Can't find the element to remove if this assert hits + if (objectExists==false) + return 0; + + orderedList.RemoveAtIndex(index); + return index; + } + + template + void OrderedList::RemoveAtIndex(const unsigned index) + { + orderedList.RemoveAtIndex(index); + } + + template + void OrderedList::InsertAtIndex(const data_type &data, const unsigned index, const char *file, unsigned int line) + { + orderedList.Insert(data, index, file, line); + } + + template + void OrderedList::InsertAtEnd(const data_type &data, const char *file, unsigned int line) + { + orderedList.Insert(data, file, line); + } + + template + void OrderedList::RemoveFromEnd(const unsigned num) + { + orderedList.RemoveFromEnd(num); + } + + template + void OrderedList::Clear(bool doNotDeallocate, const char *file, unsigned int line) + { + orderedList.Clear(doNotDeallocate, file, line); + } + + template + data_type& OrderedList::operator[]( const unsigned int position ) const + { + return orderedList[position]; + } + + template + unsigned OrderedList::Size(void) const + { + return orderedList.Size(); + } +} + +#endif diff --git a/include/raknet/DS_Queue.hpp b/include/raknet/DS_Queue.hpp new file mode 100644 index 0000000..f623df7 --- /dev/null +++ b/include/raknet/DS_Queue.hpp @@ -0,0 +1,461 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_Queue.h +/// \internal +/// \brief A queue used by RakNet. +/// + + +#ifndef __QUEUE_H +#define __QUEUE_H + +// Template classes have to have all the code in the header file +#include "RakAssert.hpp" +#include "Export.hpp" +#include "RakMemoryOverride.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + /// \brief A queue implemented as an array with a read and write index. + template + class RAK_DLL_EXPORT Queue + { + public: + Queue(); + ~Queue(); + Queue( Queue& original_copy ); + bool operator= ( const Queue& original_copy ); + void Push( const queue_type& input, const char *file, unsigned int line ); + void PushAtHead( const queue_type& input, unsigned index, const char *file, unsigned int line ); + queue_type& operator[] ( unsigned int position ) const; // Not a normal thing you do with a queue but can be used for efficiency + void RemoveAtIndex( unsigned int position ); // Not a normal thing you do with a queue but can be used for efficiency + inline queue_type Peek( void ) const; + inline queue_type PeekTail( void ) const; + inline queue_type Pop( void ); + inline queue_type PopTail( void ); + // Debug: Set pointer to 0, for memory leak detection + inline queue_type PopDeref( void ); + inline unsigned int Size( void ) const; + inline bool IsEmpty(void) const; + inline unsigned int AllocationSize( void ) const; + inline void Clear( const char *file, unsigned int line ); + void Compress( const char *file, unsigned int line ); + bool Find ( const queue_type& q ); + void ClearAndForceAllocation( int size, const char *file, unsigned int line ); // Force a memory allocation to a certain larger size + + private: + queue_type* array; + unsigned int head; // Array index for the head of the queue + unsigned int tail; // Array index for the tail of the queue + unsigned int allocation_size; + }; + + + template + inline unsigned int Queue::Size( void ) const + { + if ( head <= tail ) + return tail -head; + else + return allocation_size -head + tail; + } + + template + inline bool Queue::IsEmpty(void) const + { + return head==tail; + } + + template + inline unsigned int Queue::AllocationSize( void ) const + { + return allocation_size; + } + + template + Queue::Queue() + { + //allocation_size = 16; + //array = RakNet::OP_NEW_ARRAY(allocation_size, _FILE_AND_LINE_ ); + allocation_size = 0; + array=0; + head = 0; + tail = 0; + } + + template + Queue::~Queue() + { + if (allocation_size>0) + RakNet::OP_DELETE_ARRAY(array, _FILE_AND_LINE_); + } + + template + inline queue_type Queue::Pop( void ) + { +#ifdef _DEBUG + RakAssert( head != tail); +#endif + //head=(head+1) % allocation_size; + + if ( ++head == allocation_size ) + head = 0; + + if ( head == 0 ) + return ( queue_type ) array[ allocation_size -1 ]; + + return ( queue_type ) array[ head -1 ]; + } + + template + inline queue_type Queue::PopTail( void ) + { +#ifdef _DEBUG + RakAssert( head != tail ); +#endif + if (tail!=0) + { + --tail; + return ( queue_type ) array[ tail ]; + } + else + { + tail=allocation_size-1; + return ( queue_type ) array[ tail ]; + } + } + + template + inline queue_type Queue::PopDeref( void ) + { + if ( ++head == allocation_size ) + head = 0; + + queue_type q; + if ( head == 0 ) + { + q=array[ allocation_size -1 ]; + array[ allocation_size -1 ]=0; + return q; + } + + q=array[ head -1 ]; + array[ head -1 ]=0; + return q; + } + + template + void Queue::PushAtHead( const queue_type& input, unsigned index, const char *file, unsigned int line ) + { + RakAssert(index <= Size()); + + // Just force a reallocation, will be overwritten + Push(input, file, line ); + + if (Size()==1) + return; + + unsigned writeIndex, readIndex, trueWriteIndex, trueReadIndex; + writeIndex=Size()-1; + readIndex=writeIndex-1; + while (readIndex >= index) + { + if ( head + writeIndex >= allocation_size ) + trueWriteIndex = head + writeIndex - allocation_size; + else + trueWriteIndex = head + writeIndex; + + if ( head + readIndex >= allocation_size ) + trueReadIndex = head + readIndex - allocation_size; + else + trueReadIndex = head + readIndex; + + array[trueWriteIndex]=array[trueReadIndex]; + + if (readIndex==0) + break; + writeIndex--; + readIndex--; + } + + if ( head + index >= allocation_size ) + trueWriteIndex = head + index - allocation_size; + else + trueWriteIndex = head + index; + + array[trueWriteIndex]=input; + } + + + template + inline queue_type Queue::Peek( void ) const + { +#ifdef _DEBUG + RakAssert( head != tail ); +#endif + + return ( queue_type ) array[ head ]; + } + + template + inline queue_type Queue::PeekTail( void ) const + { +#ifdef _DEBUG + RakAssert( head != tail ); +#endif + if (tail!=0) + return ( queue_type ) array[ tail-1 ]; + else + return ( queue_type ) array[ allocation_size-1 ]; + } + + template + void Queue::Push( const queue_type& input, const char *file, unsigned int line ) + { + if ( allocation_size == 0 ) + { + array = RakNet::OP_NEW_ARRAY(16, file, line ); + head = 0; + tail = 1; + array[ 0 ] = input; + allocation_size = 16; + return ; + } + + array[ tail++ ] = input; + + if ( tail == allocation_size ) + tail = 0; + + if ( tail == head ) + { + // unsigned int index=tail; + + // Need to allocate more memory. + queue_type * new_array; + new_array = RakNet::OP_NEW_ARRAY((int)allocation_size * 2, file, line ); +#ifdef _DEBUG + RakAssert( new_array ); +#endif + if (new_array==0) + return; + + for ( unsigned int counter = 0; counter < allocation_size; ++counter ) + new_array[ counter ] = array[ ( head + counter ) % ( allocation_size ) ]; + + head = 0; + + tail = allocation_size; + + allocation_size *= 2; + + // Delete the old array and move the pointer to the new array + RakNet::OP_DELETE_ARRAY(array, file, line); + + array = new_array; + } + + } + + template + Queue::Queue( Queue& original_copy ) + { + // Allocate memory for copy + + if ( original_copy.Size() == 0 ) + { + allocation_size = 0; + } + + else + { + array = RakNet::OP_NEW_ARRAY( original_copy.Size() + 1 , _FILE_AND_LINE_ ); + + for ( unsigned int counter = 0; counter < original_copy.Size(); ++counter ) + array[ counter ] = original_copy.array[ ( original_copy.head + counter ) % ( original_copy.allocation_size ) ]; + + head = 0; + + tail = original_copy.Size(); + + allocation_size = original_copy.Size() + 1; + } + } + + template + bool Queue::operator= ( const Queue& original_copy ) + { + if ( ( &original_copy ) == this ) + return false; + + Clear(_FILE_AND_LINE_); + + // Allocate memory for copy + if ( original_copy.Size() == 0 ) + { + allocation_size = 0; + } + + else + { + array = RakNet::OP_NEW_ARRAY( original_copy.Size() + 1 , _FILE_AND_LINE_ ); + + for ( unsigned int counter = 0; counter < original_copy.Size(); ++counter ) + array[ counter ] = original_copy.array[ ( original_copy.head + counter ) % ( original_copy.allocation_size ) ]; + + head = 0; + + tail = original_copy.Size(); + + allocation_size = original_copy.Size() + 1; + } + + return true; + } + + template + inline void Queue::Clear ( const char *file, unsigned int line ) + { + if ( allocation_size == 0 ) + return ; + + if (allocation_size > 32) + { + RakNet::OP_DELETE_ARRAY(array, file, line); + allocation_size = 0; + } + + head = 0; + tail = 0; + } + + template + void Queue::Compress ( const char *file, unsigned int line ) + { + queue_type* new_array; + unsigned int newAllocationSize; + if (allocation_size==0) + return; + + newAllocationSize=1; + while (newAllocationSize <= Size()) + newAllocationSize<<=1; // Must be a better way to do this but I'm too dumb to figure it out quickly :) + + new_array = RakNet::OP_NEW_ARRAY(newAllocationSize, file, line ); + + for (unsigned int counter=0; counter < Size(); ++counter) + new_array[counter] = array[(head + counter)%(allocation_size)]; + + tail=Size(); + allocation_size=newAllocationSize; + head=0; + + // Delete the old array and move the pointer to the new array + RakNet::OP_DELETE_ARRAY(array, file, line); + array=new_array; + } + + template + bool Queue::Find ( const queue_type &q ) + { + if ( allocation_size == 0 ) + return false; + + unsigned int counter = head; + + while ( counter != tail ) + { + if ( array[ counter ] == q ) + return true; + + counter = ( counter + 1 ) % allocation_size; + } + + return false; + } + + template + void Queue::ClearAndForceAllocation( int size, const char *file, unsigned int line ) + { + RakNet::OP_DELETE_ARRAY(array, file, line); + if (size>0) + array = RakNet::OP_NEW_ARRAY(size, file, line ); + else + array=0; + allocation_size = size; + head = 0; + tail = 0; + } + + template + inline queue_type& Queue::operator[] ( unsigned int position ) const + { +#ifdef _DEBUG + RakAssert( position < Size() ); +#endif + //return array[(head + position) % allocation_size]; + + if ( head + position >= allocation_size ) + return array[ head + position - allocation_size ]; + else + return array[ head + position ]; + } + + template + void Queue::RemoveAtIndex( unsigned int position ) + { +#ifdef _DEBUG + RakAssert( position < Size() ); + RakAssert( head != tail ); +#endif + + if ( head == tail || position >= Size() ) + return ; + + unsigned int index; + + unsigned int next; + + //index = (head + position) % allocation_size; + if ( head + position >= allocation_size ) + index = head + position - allocation_size; + else + index = head + position; + + //next = (index + 1) % allocation_size; + next = index + 1; + + if ( next == allocation_size ) + next = 0; + + while ( next != tail ) + { + // Overwrite the previous element + array[ index ] = array[ next ]; + index = next; + //next = (next + 1) % allocation_size; + + if ( ++next == allocation_size ) + next = 0; + } + + // Move the tail back + if ( tail == 0 ) + tail = allocation_size - 1; + else + --tail; + } +} // End namespace + +#endif + diff --git a/include/raknet/DS_QueueLinkedList.hpp b/include/raknet/DS_QueueLinkedList.hpp new file mode 100644 index 0000000..eea8f0c --- /dev/null +++ b/include/raknet/DS_QueueLinkedList.hpp @@ -0,0 +1,110 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_QueueLinkedList.h +/// \internal +/// \brief A queue implemented as a linked list. +/// + + +#ifndef __QUEUE_LINKED_LIST_H +#define __QUEUE_LINKED_LIST_H + +#include "DS_LinkedList.hpp" +#include "Export.hpp" +#include "RakMemoryOverride.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + /// \brief A queue implemented using a linked list. Rarely used. + template + class RAK_DLL_EXPORT QueueLinkedList + { + + public: + QueueLinkedList(); + QueueLinkedList( const QueueLinkedList& original_copy ); + bool operator= ( const QueueLinkedList& original_copy ); + QueueType Pop( void ); + QueueType& Peek( void ); + QueueType& EndPeek( void ); + void Push( const QueueType& input ); + unsigned int Size( void ); + void Clear( void ); + void Compress( void ); + + private: + LinkedList data; + }; + + template + QueueLinkedList::QueueLinkedList() + { + } + + template + inline unsigned int QueueLinkedList::Size() + { + return data.Size(); + } + + template + inline QueueType QueueLinkedList::Pop( void ) + { + data.Beginning(); + return ( QueueType ) data.Pop(); + } + + template + inline QueueType& QueueLinkedList::Peek( void ) + { + data.Beginning(); + return ( QueueType ) data.Peek(); + } + + template + inline QueueType& QueueLinkedList::EndPeek( void ) + { + data.End(); + return ( QueueType ) data.Peek(); + } + + template + void QueueLinkedList::Push( const QueueType& input ) + { + data.End(); + data.Add( input ); + } + + template + QueueLinkedList::QueueLinkedList( const QueueLinkedList& original_copy ) + { + data = original_copy.data; + } + + template + bool QueueLinkedList::operator= ( const QueueLinkedList& original_copy ) + { + if ( ( &original_copy ) == this ) + return false; + + data = original_copy.data; + } + + template + void QueueLinkedList::Clear ( void ) + { + data.Clear(); + } +} // End namespace + +#endif diff --git a/include/raknet/DS_RangeList.hpp b/include/raknet/DS_RangeList.hpp new file mode 100644 index 0000000..68143be --- /dev/null +++ b/include/raknet/DS_RangeList.hpp @@ -0,0 +1,243 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_RangeList.h +/// \internal +/// \brief A queue implemented as a linked list. +/// + + +#ifndef __RANGE_LIST_H +#define __RANGE_LIST_H + +#include "DS_OrderedList.hpp" +#include "BitStream.hpp" +#include "RakMemoryOverride.hpp" +#include "RakAssert.hpp" + +namespace DataStructures +{ + template + struct RangeNode + { + RangeNode() {} + ~RangeNode() {} + RangeNode(range_type min, range_type max) {minIndex=min; maxIndex=max;} + range_type minIndex; + range_type maxIndex; + }; + + + template + int RangeNodeComp(const range_type &a, const RangeNode &b) + { + if (a + class RAK_DLL_EXPORT RangeList + { + public: + RangeList(); + ~RangeList(); + void Insert(range_type index); + void Clear(void); + unsigned Size(void) const; + unsigned RangeSum(void) const; + RakNet::BitSize_t Serialize(RakNet::BitStream *in, RakNet::BitSize_t maxBits, bool clearSerialized); + bool Deserialize(RakNet::BitStream *out); + + DataStructures::OrderedList , RangeNodeComp > ranges; + }; + + template + RakNet::BitSize_t RangeList::Serialize(RakNet::BitStream *in, RakNet::BitSize_t maxBits, bool clearSerialized) + { + RakAssert(ranges.Size() < (unsigned short)-1); + RakNet::BitStream tempBS; + RakNet::BitSize_t bitsWritten; + unsigned short countWritten; + unsigned i; + countWritten=0; + bitsWritten=0; + for (i=0; i < ranges.Size(); i++) + { + if ((int)sizeof(unsigned short)*8+bitsWritten+(int)sizeof(range_type)*8*2+1>maxBits) + break; + unsigned char minEqualsMax; + if (ranges[i].minIndex==ranges[i].maxIndex) + minEqualsMax=1; + else + minEqualsMax=0; + tempBS.Write(minEqualsMax); // Use one byte, intead of one bit, for speed, as this is done a lot + tempBS.Write(ranges[i].minIndex); + bitsWritten+=sizeof(range_type)*8+8; + if (ranges[i].minIndex!=ranges[i].maxIndex) + { + tempBS.Write(ranges[i].maxIndex); + bitsWritten+=sizeof(range_type)*8; + } + countWritten++; + } + + in->AlignWriteToByteBoundary(); + RakNet::BitSize_t before=in->GetWriteOffset(); + in->Write(countWritten); + bitsWritten+=in->GetWriteOffset()-before; + // RAKNET_DEBUG_PRINTF("%i ", in->GetNumberOfBitsUsed()); + in->Write(&tempBS, tempBS.GetNumberOfBitsUsed()); + // RAKNET_DEBUG_PRINTF("%i %i \n", tempBS.GetNumberOfBitsUsed(),in->GetNumberOfBitsUsed()); + + if (clearSerialized && countWritten) + { + unsigned rangeSize=ranges.Size(); + for (i=0; i < rangeSize-countWritten; i++) + { + ranges[i]=ranges[i+countWritten]; + } + ranges.RemoveFromEnd(countWritten); + } + + return bitsWritten; + } + template + bool RangeList::Deserialize(RakNet::BitStream *out) + { + ranges.Clear(true, _FILE_AND_LINE_); + unsigned short count; + out->AlignReadToByteBoundary(); + out->Read(count); + unsigned short i; + range_type min,max; + unsigned char maxEqualToMin=0; + + for (i=0; i < count; i++) + { + out->Read(maxEqualToMin); + if (out->Read(min)==false) + return false; + if (maxEqualToMin==false) + { + if (out->Read(max)==false) + return false; + if (max(min,max), _FILE_AND_LINE_); + } + return true; + } + + template + RangeList::RangeList() + { + RangeNodeComp(0, RangeNode()); + } + + template + RangeList::~RangeList() + { + Clear(); + } + + template + void RangeList::Insert(range_type index) + { + if (ranges.Size()==0) + { + ranges.Insert(index, RangeNode(index, index), true, _FILE_AND_LINE_); + return; + } + + bool objectExists; + unsigned insertionIndex=ranges.GetIndexFromKey(index, &objectExists); + if (insertionIndex==ranges.Size()) + { + if (index == ranges[insertionIndex-1].maxIndex+(range_type)1) + ranges[insertionIndex-1].maxIndex++; + else if (index > ranges[insertionIndex-1].maxIndex+(range_type)1) + { + // Insert at end + ranges.Insert(index, RangeNode(index, index), true, _FILE_AND_LINE_); + } + + return; + } + + if (index < ranges[insertionIndex].minIndex-(range_type)1) + { + // Insert here + ranges.InsertAtIndex(RangeNode(index, index), insertionIndex, _FILE_AND_LINE_); + + return; + } + else if (index == ranges[insertionIndex].minIndex-(range_type)1) + { + // Decrease minIndex and join left + ranges[insertionIndex].minIndex--; + if (insertionIndex>0 && ranges[insertionIndex-1].maxIndex+(range_type)1==ranges[insertionIndex].minIndex) + { + ranges[insertionIndex-1].maxIndex=ranges[insertionIndex].maxIndex; + ranges.RemoveAtIndex(insertionIndex); + } + + return; + } + else if (index >= ranges[insertionIndex].minIndex && index <= ranges[insertionIndex].maxIndex) + { + // Already exists + return; + } + else if (index == ranges[insertionIndex].maxIndex+(range_type)1) + { + // Increase maxIndex and join right + ranges[insertionIndex].maxIndex++; + if (insertionIndex + void RangeList::Clear(void) + { + ranges.Clear(true, _FILE_AND_LINE_); + } + + template + unsigned RangeList::Size(void) const + { + return ranges.Size(); + } + + template + unsigned RangeList::RangeSum(void) const + { + unsigned sum=0,i; + for (i=0; i < ranges.Size(); i++) + sum+=ranges[i].maxIndex-ranges[i].minIndex+1; + return sum; + } + +} + +#endif diff --git a/include/raknet/DS_Table.hpp b/include/raknet/DS_Table.hpp new file mode 100644 index 0000000..72a64ef --- /dev/null +++ b/include/raknet/DS_Table.hpp @@ -0,0 +1,351 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_Table.h +/// + + +#ifndef __TABLE_H +#define __TABLE_H + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +#include "DS_List.hpp" +#include "DS_BPlusTree.hpp" +#include "RakMemoryOverride.hpp" +#include "Export.hpp" +#include "RakString.hpp" + +#define _TABLE_BPLUS_TREE_ORDER 16 +#define _TABLE_MAX_COLUMN_NAME_LENGTH 64 + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + + /// \brief Holds a set of columns, a set of rows, and rows times columns cells. + /// \details The table data structure is useful if you want to store a set of structures and perform queries on those structures.
+ /// This is a relatively simple and fast implementation of the types of tables commonly used in databases.
+ /// See TableSerializer to serialize data members of the table.
+ /// See LightweightDatabaseClient and LightweightDatabaseServer to transmit the table over the network. + class RAK_DLL_EXPORT Table + { + public: + + enum ColumnType + { + // Cell::i used + NUMERIC, + + // Cell::c used to hold a null terminated string. + STRING, + + // Cell::c holds data. Cell::i holds data length of c in bytes. + BINARY, + + // Cell::c holds data. Not deallocated. Set manually by assigning ptr. + POINTER, + }; + + + /// Holds the actual data in the table + // Note: If this structure is changed the struct in the swig files need to be changed as well + struct RAK_DLL_EXPORT Cell + { + Cell(); + ~Cell(); + Cell(double numericValue, char *charValue, void *ptr, ColumnType type); + void SetByType(double numericValue, char *charValue, void *ptr, ColumnType type); + void Clear(void); + + /// Numeric + void Set(int input); + void Set(unsigned int input); + void Set(double input); + + /// String + void Set(const char *input); + + /// Binary + void Set(const char *input, int inputLength); + + /// Pointer + void SetPtr(void* p); + + /// Numeric + void Get(int *output); + void Get(double *output); + + /// String + void Get(char *output); + + /// Binary + void Get(char *output, int *outputLength); + + RakNet::RakString ToString(ColumnType columnType); + + // assignment operator and copy constructor + Cell& operator = ( const Cell& input ); + Cell( const Cell & input); + + ColumnType EstimateColumnType(void) const; + + bool isEmpty; + double i; + char *c; + void *ptr; + }; + + /// Stores the name and type of the column + /// \internal + // Note: If this structure is changed the struct in the swig files need to be changed as well + struct RAK_DLL_EXPORT ColumnDescriptor + { + ColumnDescriptor(); + ~ColumnDescriptor(); + ColumnDescriptor(const char cn[_TABLE_MAX_COLUMN_NAME_LENGTH],ColumnType ct); + + char columnName[_TABLE_MAX_COLUMN_NAME_LENGTH]; + ColumnType columnType; + }; + + /// Stores the list of cells for this row, and a special flag used for internal sorting + // Note: If this structure is changed the struct in the swig files need to be changed as well + struct RAK_DLL_EXPORT Row + { + // list of cells + DataStructures::List cells; + + /// Numeric + void UpdateCell(unsigned columnIndex, double value); + + /// String + void UpdateCell(unsigned columnIndex, const char *str); + + /// Binary + void UpdateCell(unsigned columnIndex, int byteLength, const char *data); + }; + + // Operations to perform for cell comparison + enum FilterQueryType + { + QF_EQUAL, + QF_NOT_EQUAL, + QF_GREATER_THAN, + QF_GREATER_THAN_EQ, + QF_LESS_THAN, + QF_LESS_THAN_EQ, + QF_IS_EMPTY, + QF_NOT_EMPTY, + }; + + // Compare the cell value for a row at columnName to the cellValue using operation. + // Note: If this structure is changed the struct in the swig files need to be changed as well + struct RAK_DLL_EXPORT FilterQuery + { + FilterQuery(); + ~FilterQuery(); + FilterQuery(unsigned column, Cell *cell, FilterQueryType op); + + // If columnName is specified, columnIndex will be looked up using it. + char columnName[_TABLE_MAX_COLUMN_NAME_LENGTH]; + unsigned columnIndex; + Cell *cellValue; + FilterQueryType operation; + }; + + /// Increasing or decreasing sort order + enum SortQueryType + { + QS_INCREASING_ORDER, + QS_DECREASING_ORDER, + }; + + // Sort on increasing or decreasing order for a particular column + // Note: If this structure is changed the struct in the swig files need to be changed as well + struct RAK_DLL_EXPORT SortQuery + { + /// The index of the table column we are sorting on + unsigned columnIndex; + + /// See SortQueryType + SortQueryType operation; + }; + + // Constructor + Table(); + + // Destructor + ~Table(); + + /// \brief Adds a column to the table + /// \param[in] columnName The name of the column + /// \param[in] columnType What type of data this column will hold + /// \return The index of the new column + unsigned AddColumn(const char columnName[_TABLE_MAX_COLUMN_NAME_LENGTH], ColumnType columnType); + + /// \brief Removes a column by index + /// \param[in] columnIndex The index of the column to remove + void RemoveColumn(unsigned columnIndex); + + /// \brief Gets the index of a column by name + /// \details Column indices are stored in the order they are added. + /// \param[in] columnName The name of the column + /// \return The index of the column, or (unsigned)-1 if no such column + unsigned ColumnIndex(char columnName[_TABLE_MAX_COLUMN_NAME_LENGTH]) const; + unsigned ColumnIndex(const char *columnName) const; + + /// \brief Gives the string name of the column at a certain index + /// \param[in] index The index of the column + /// \return The name of the column, or 0 if an invalid index + char* ColumnName(unsigned index) const; + + /// \brief Returns the type of a column, referenced by index + /// \param[in] index The index of the column + /// \return The type of the column + ColumnType GetColumnType(unsigned index) const; + + /// Returns the number of columns + /// \return The number of columns in the table + unsigned GetColumnCount(void) const; + + /// Returns the number of rows + /// \return The number of rows in the table + unsigned GetRowCount(void) const; + + /// \brief Adds a row to the table + /// \details New rows are added with empty values for all cells. However, if you specify initialCelLValues you can specify initial values + /// It's up to you to ensure that the values in the specific cells match the type of data used by that row + /// rowId can be considered the primary key for the row. It is much faster to lookup a row by its rowId than by searching keys. + /// rowId must be unique + /// Rows are stored in sorted order in the table, using rowId as the sort key + /// \param[in] rowId The UNIQUE primary key for the row. This can never be changed. + /// \param[in] initialCellValues Initial values to give the row (optional) + /// \return The newly added row + Table::Row* AddRow(unsigned rowId); + Table::Row* AddRow(unsigned rowId, DataStructures::List &initialCellValues); + Table::Row* AddRow(unsigned rowId, DataStructures::List &initialCellValues, bool copyCells=false); + + /// \brief Removes a row specified by rowId. + /// \param[in] rowId The ID of the row + /// \return true if the row was deleted. False if not. + bool RemoveRow(unsigned rowId); + + /// \brief Removes all the rows with IDs that the specified table also has. + /// \param[in] tableContainingRowIDs The IDs of the rows + void RemoveRows(Table *tableContainingRowIDs); + + /// \brief Updates a particular cell in the table. + /// \note If you are going to update many cells of a particular row, it is more efficient to call GetRow and perform the operations on the row directly. + /// \note Row pointers do not change, so you can also write directly to the rows for more efficiency. + /// \param[in] rowId The ID of the row + /// \param[in] columnIndex The column of the cell + /// \param[in] value The data to set + bool UpdateCell(unsigned rowId, unsigned columnIndex, int value); + bool UpdateCell(unsigned rowId, unsigned columnIndex, char *str); + bool UpdateCell(unsigned rowId, unsigned columnIndex, int byteLength, char *data); + bool UpdateCellByIndex(unsigned rowIndex, unsigned columnIndex, int value); + bool UpdateCellByIndex(unsigned rowIndex, unsigned columnIndex, char *str); + bool UpdateCellByIndex(unsigned rowIndex, unsigned columnIndex, int byteLength, char *data); + + /// \brief Note this is much less efficient to call than GetRow, then working with the cells directly. + /// Numeric, string, binary + void GetCellValueByIndex(unsigned rowIndex, unsigned columnIndex, int *output); + void GetCellValueByIndex(unsigned rowIndex, unsigned columnIndex, char *output); + void GetCellValueByIndex(unsigned rowIndex, unsigned columnIndex, char *output, int *outputLength); + + /// \brief Gets a row. More efficient to do this and access Row::cells than to repeatedly call GetCell. + /// You can also update cells in rows from this function. + /// \param[in] rowId The ID of the row + /// \return The desired row, or 0 if no such row. + Row* GetRowByID(unsigned rowId) const; + + /// \brief Gets a row at a specific index. + /// rowIndex should be less than GetRowCount() + /// \param[in] rowIndex The index of the row + /// \param[out] key The ID of the row returned + /// \return The desired row, or 0 if no such row. + Row* GetRowByIndex(unsigned rowIndex, unsigned *key) const; + + /// \brief Queries the table, optionally returning only a subset of columns and rows. + /// \param[in] columnSubset An array of column indices. Only columns in this array are returned. Pass 0 for all columns + /// \param[in] numColumnSubset The number of elements in \a columnSubset + /// \param[in] inclusionFilters An array of FilterQuery. All filters must pass for the row to be returned. + /// \param[in] numInclusionFilters The number of elements in \a inclusionFilters + /// \param[in] rowIds An arrow of row IDs. Only these rows with these IDs are returned. Pass 0 for all rows. + /// \param[in] numRowIDs The number of elements in \a rowIds + /// \param[out] result The result of the query. If no rows are returned, the table will only have columns. + void QueryTable(unsigned *columnIndicesSubset, unsigned numColumnSubset, FilterQuery *inclusionFilters, unsigned numInclusionFilters, unsigned *rowIds, unsigned numRowIDs, Table *result); + + /// \brief Sorts the table by rows + /// \details You can sort the table in ascending or descending order on one or more columns + /// Columns have precedence in the order they appear in the \a sortQueries array + /// If a row cell on column n has the same value as a a different row on column n, then the row will be compared on column n+1 + /// \param[in] sortQueries A list of SortQuery structures, defining the sorts to perform on the table + /// \param[in] numColumnSubset The number of elements in \a numSortQueries + /// \param[out] out The address of an array of Rows, which will receive the sorted output. The array must be long enough to contain all returned rows, up to GetRowCount() + void SortTable(Table::SortQuery *sortQueries, unsigned numSortQueries, Table::Row** out); + + /// \brief Frees all memory in the table. + void Clear(void); + + /// \brief Prints out the names of all the columns. + /// \param[out] out A pointer to an array of bytes which will hold the output. + /// \param[in] outLength The size of the \a out array + /// \param[in] columnDelineator What character to print to delineate columns + void PrintColumnHeaders(char *out, int outLength, char columnDelineator) const; + + /// \brief Writes a text representation of the row to \a out. + /// \param[out] out A pointer to an array of bytes which will hold the output. + /// \param[in] outLength The size of the \a out array + /// \param[in] columnDelineator What character to print to delineate columns + /// \param[in] printDelineatorForBinary Binary output is not printed. True to still print the delineator. + /// \param[in] inputRow The row to print + void PrintRow(char *out, int outLength, char columnDelineator, bool printDelineatorForBinary, Table::Row* inputRow) const; + + /// \brief Direct access to make things easier. + const DataStructures::List& GetColumns(void) const; + + /// \brief Direct access to make things easier. + const DataStructures::BPlusTree& GetRows(void) const; + + /// \brief Get the head of a linked list containing all the row data. + DataStructures::Page * GetListHead(void); + + /// \brief Get the first free row id. + /// This could be made more efficient. + unsigned GetAvailableRowId(void) const; + + Table& operator = ( const Table& input ); + + protected: + Table::Row* AddRowColumns(unsigned rowId, Row *row, DataStructures::List columnIndices); + + void DeleteRow(Row *row); + + void QueryRow(DataStructures::List &inclusionFilterColumnIndices, DataStructures::List &columnIndicesToReturn, unsigned key, Table::Row* row, FilterQuery *inclusionFilters, Table *result); + + // 16 is arbitrary and is the order of the BPlus tree. Higher orders are better for searching while lower orders are better for + // Insertions and deletions. + DataStructures::BPlusTree rows; + + // Columns in the table. + DataStructures::List columns; + }; +} + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif diff --git a/include/raknet/DS_ThreadsafeAllocatingQueue.hpp b/include/raknet/DS_ThreadsafeAllocatingQueue.hpp new file mode 100644 index 0000000..e32f88c --- /dev/null +++ b/include/raknet/DS_ThreadsafeAllocatingQueue.hpp @@ -0,0 +1,184 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_ThreadsafeAllocatingQueue.h +/// \internal +/// A threadsafe queue, that also uses a memory pool for allocation + +#ifndef __THREADSAFE_ALLOCATING_QUEUE +#define __THREADSAFE_ALLOCATING_QUEUE + +#include "DS_Queue.hpp" +#include "SimpleMutex.hpp" +#include "DS_MemoryPool.hpp" + +// #if defined(new) +// #pragma push_macro("new") +// #undef new +// #define RMO_NEW_UNDEF_ALLOCATING_QUEUE +// #endif + +namespace DataStructures +{ + +template +class RAK_DLL_EXPORT ThreadsafeAllocatingQueue +{ +public: + // Queue operations + void Push(structureType *s); + structureType *PopInaccurate(void); + structureType *Pop(void); + void SetPageSize(int size); + bool IsEmpty(void); + structureType * operator[] ( unsigned int position ); + void RemoveAtIndex( unsigned int position ); + unsigned int Size( void ); + + // Memory pool operations + structureType *Allocate(const char *file, unsigned int line); + void Deallocate(structureType *s, const char *file, unsigned int line); + void Clear(const char *file, unsigned int line); +protected: + + mutable MemoryPool memoryPool; + RakNet::SimpleMutex memoryPoolMutex; + Queue queue; + RakNet::SimpleMutex queueMutex; +}; + +template +void ThreadsafeAllocatingQueue::Push(structureType *s) +{ + queueMutex.Lock(); + queue.Push(s, _FILE_AND_LINE_ ); + queueMutex.Unlock(); +} + +template +structureType *ThreadsafeAllocatingQueue::PopInaccurate(void) +{ + structureType *s; + if (queue.IsEmpty()) + return 0; + queueMutex.Lock(); + if (queue.IsEmpty()==false) + s=queue.Pop(); + else + s=0; + queueMutex.Unlock(); + return s; +} + +template +structureType *ThreadsafeAllocatingQueue::Pop(void) +{ + structureType *s; + queueMutex.Lock(); + if (queue.IsEmpty()) + { + queueMutex.Unlock(); + return 0; + } + s=queue.Pop(); + queueMutex.Unlock(); + return s; +} + +template +structureType *ThreadsafeAllocatingQueue::Allocate(const char *file, unsigned int line) +{ + structureType *s; + memoryPoolMutex.Lock(); + s=memoryPool.Allocate(file, line); + memoryPoolMutex.Unlock(); + // Call new operator, memoryPool doesn't do this + s = new ((void*)s) structureType; + return s; +} +template +void ThreadsafeAllocatingQueue::Deallocate(structureType *s, const char *file, unsigned int line) +{ + // Call delete operator, memory pool doesn't do this + s->~structureType(); + memoryPoolMutex.Lock(); + memoryPool.Release(s, file, line); + memoryPoolMutex.Unlock(); +} + +template +void ThreadsafeAllocatingQueue::Clear(const char *file, unsigned int line) +{ + memoryPoolMutex.Lock(); + for (unsigned int i=0; i < queue.Size(); i++) + { + queue[i]->~structureType(); + memoryPool.Release(queue[i], file, line); + } + queue.Clear(file, line); + memoryPoolMutex.Unlock(); + memoryPoolMutex.Lock(); + memoryPool.Clear(file, line); + memoryPoolMutex.Unlock(); +} + +template +void ThreadsafeAllocatingQueue::SetPageSize(int size) +{ + memoryPool.SetPageSize(size); +} + +template +bool ThreadsafeAllocatingQueue::IsEmpty(void) +{ + bool isEmpty; + queueMutex.Lock(); + isEmpty=queue.IsEmpty(); + queueMutex.Unlock(); + return isEmpty; +} + +template +structureType * ThreadsafeAllocatingQueue::operator[] ( unsigned int position ) +{ + structureType *s; + queueMutex.Lock(); + s=queue[position]; + queueMutex.Unlock(); + return s; +} + +template +void ThreadsafeAllocatingQueue::RemoveAtIndex( unsigned int position ) +{ + queueMutex.Lock(); + queue.RemoveAtIndex(position); + queueMutex.Unlock(); +} + +template +unsigned int ThreadsafeAllocatingQueue::Size( void ) +{ + unsigned int s; + queueMutex.Lock(); + s=queue.Size(); + queueMutex.Unlock(); + return s; +} + +} + + +// #if defined(RMO_NEW_UNDEF_ALLOCATING_QUEUE) +// #pragma pop_macro("new") +// #undef RMO_NEW_UNDEF_ALLOCATING_QUEUE +// #endif + +#endif diff --git a/include/raknet/DS_Tree.hpp b/include/raknet/DS_Tree.hpp new file mode 100644 index 0000000..bf950ce --- /dev/null +++ b/include/raknet/DS_Tree.hpp @@ -0,0 +1,106 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_Tree.h +/// \internal +/// \brief Just a regular tree +/// + + + +#ifndef __DS_TREE_H +#define __DS_TREE_H + +#include "Export.hpp" +#include "DS_List.hpp" +#include "DS_Queue.hpp" +#include "RakMemoryOverride.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + template + class RAK_DLL_EXPORT Tree + { + public: + Tree(); + Tree(TreeType &inputData); + ~Tree(); + void LevelOrderTraversal(DataStructures::List &output); + void AddChild(TreeType &newData); + void DeleteDecendants(void); + + TreeType data; + DataStructures::List children; + }; + + template + Tree::Tree() + { + + } + + template + Tree::Tree(TreeType &inputData) + { + data=inputData; + } + + template + Tree::~Tree() + { + DeleteDecendants(); + } + + template + void Tree::LevelOrderTraversal(DataStructures::List &output) + { + unsigned i; + Tree *node; + DataStructures::Queue*> queue; + + for (i=0; i < children.Size(); i++) + queue.Push(children[i]); + + while (queue.Size()) + { + node=queue.Pop(); + output.Insert(node, _FILE_AND_LINE_); + for (i=0; i < node->children.Size(); i++) + queue.Push(node->children[i]); + } + } + + template + void Tree::AddChild(TreeType &newData) + { + children.Insert(RakNet::OP_NEW(newData, _FILE_AND_LINE_)); + } + + template + void Tree::DeleteDecendants(void) + { + /* + DataStructures::List output; + LevelOrderTraversal(output); + unsigned i; + for (i=0; i < output.Size(); i++) + RakNet::OP_DELETE(output[i], _FILE_AND_LINE_); +*/ + + // Already recursive to do this + unsigned int i; + for (i=0; i < children.Size(); i++) + RakNet::OP_DELETE(children[i], _FILE_AND_LINE_); + } +} + +#endif diff --git a/include/raknet/DS_WeightedGraph.hpp b/include/raknet/DS_WeightedGraph.hpp new file mode 100644 index 0000000..73b6428 --- /dev/null +++ b/include/raknet/DS_WeightedGraph.hpp @@ -0,0 +1,544 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DS_WeightedGraph.h +/// \internal +/// \brief Weighted graph. +/// \details I'm assuming the indices are complex map types, rather than sequential numbers (which could be implemented much more efficiently). +/// + + +#ifndef __WEIGHTED_GRAPH_H +#define __WEIGHTED_GRAPH_H + +#include "DS_OrderedList.hpp" +#include "DS_Map.hpp" +#include "DS_Heap.hpp" +#include "DS_Queue.hpp" +#include "DS_Tree.hpp" +#include "RakAssert.hpp" +#include "RakMemoryOverride.hpp" +#ifdef _DEBUG +#include +#endif + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + template + class RAK_DLL_EXPORT WeightedGraph + { + public: + static void IMPLEMENT_DEFAULT_COMPARISON(void) {DataStructures::defaultMapKeyComparison(node_type(),node_type());} + + WeightedGraph(); + ~WeightedGraph(); + WeightedGraph( const WeightedGraph& original_copy ); + WeightedGraph& operator= ( const WeightedGraph& original_copy ); + void AddNode(const node_type &node); + void RemoveNode(const node_type &node); + void AddConnection(const node_type &node1, const node_type &node2, weight_type weight); + void RemoveConnection(const node_type &node1, const node_type &node2); + bool HasConnection(const node_type &node1, const node_type &node2); + void Print(void); + void Clear(void); + bool GetShortestPath(DataStructures::List &path, node_type startNode, node_type endNode, weight_type INFINITE_WEIGHT); + bool GetSpanningTree(DataStructures::Tree &outTree, DataStructures::List *inputNodes, node_type startNode, weight_type INFINITE_WEIGHT ); + unsigned GetNodeCount(void) const; + unsigned GetConnectionCount(unsigned nodeIndex) const; + void GetConnectionAtIndex(unsigned nodeIndex, unsigned connectionIndex, node_type &outNode, weight_type &outWeight) const; + node_type GetNodeAtIndex(unsigned nodeIndex) const; + + protected: + void ClearDijkstra(void); + void GenerateDisjktraMatrix(node_type startNode, weight_type INFINITE_WEIGHT); + + DataStructures::Map *> adjacencyLists; + + // All these variables are for path finding with Dijkstra + // 08/23/06 Won't compile as a DLL inside this struct + // struct + // { + bool isValidPath; + node_type rootNode; + DataStructures::OrderedList costMatrixIndices; + weight_type *costMatrix; + node_type *leastNodeArray; + // } dijkstra; + + struct NodeAndParent + { + DataStructures::Tree*node; + DataStructures::Tree*parent; + }; + }; + + template + WeightedGraph::WeightedGraph() + { + isValidPath=false; + costMatrix=0; + } + + template + WeightedGraph::~WeightedGraph() + { + Clear(); + } + + template + WeightedGraph::WeightedGraph( const WeightedGraph& original_copy ) + { + adjacencyLists=original_copy.adjacencyLists; + + isValidPath=original_copy.isValidPath; + if (isValidPath) + { + rootNode=original_copy.rootNode; + costMatrixIndices=original_copy.costMatrixIndices; + costMatrix = RakNet::OP_NEW_ARRAY(costMatrixIndices.Size() * costMatrixIndices.Size(), _FILE_AND_LINE_ ); + leastNodeArray = RakNet::OP_NEW_ARRAY(costMatrixIndices.Size(), _FILE_AND_LINE_ ); + memcpy(costMatrix, original_copy.costMatrix, costMatrixIndices.Size() * costMatrixIndices.Size() * sizeof(weight_type)); + memcpy(leastNodeArray, original_copy.leastNodeArray, costMatrixIndices.Size() * sizeof(weight_type)); + } + } + + template + WeightedGraph& WeightedGraph::operator=( const WeightedGraph& original_copy ) + { + adjacencyLists=original_copy.adjacencyLists; + + isValidPath=original_copy.isValidPath; + if (isValidPath) + { + rootNode=original_copy.rootNode; + costMatrixIndices=original_copy.costMatrixIndices; + costMatrix = RakNet::OP_NEW_ARRAY(costMatrixIndices.Size() * costMatrixIndices.Size(), _FILE_AND_LINE_ ); + leastNodeArray = RakNet::OP_NEW_ARRAY(costMatrixIndices.Size(), _FILE_AND_LINE_ ); + memcpy(costMatrix, original_copy.costMatrix, costMatrixIndices.Size() * costMatrixIndices.Size() * sizeof(weight_type)); + memcpy(leastNodeArray, original_copy.leastNodeArray, costMatrixIndices.Size() * sizeof(weight_type)); + } + + return *this; + } + + template + void WeightedGraph::AddNode(const node_type &node) + { + adjacencyLists.SetNew(node, RakNet::OP_NEW >( _FILE_AND_LINE_) ); + } + + template + void WeightedGraph::RemoveNode(const node_type &node) + { + unsigned i; + DataStructures::Queue removeNodeQueue; + + removeNodeQueue.Push(node, _FILE_AND_LINE_ ); + while (removeNodeQueue.Size()) + { + RakNet::OP_DELETE(adjacencyLists.Pop(removeNodeQueue.Pop()), _FILE_AND_LINE_); + + // Remove this node from all of the other lists as well + for (i=0; i < adjacencyLists.Size(); i++) + { + adjacencyLists[i]->Delete(node); + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + if (allow_unlinkedNodes==false && adjacencyLists[i]->Size()==0) + removeNodeQueue.Push(adjacencyLists.GetKeyAtIndex(i), _FILE_AND_LINE_ ); + } + } + + ClearDijkstra(); + } + + template + bool WeightedGraph::HasConnection(const node_type &node1, const node_type &node2) + { + if (node1==node2) + return false; + if (adjacencyLists.Has(node1)==false) + return false; + return adjacencyLists.Get(node1)->Has(node2); + } + + template + void WeightedGraph::AddConnection(const node_type &node1, const node_type &node2, weight_type weight) + { + if (node1==node2) + return; + + if (adjacencyLists.Has(node1)==false) + AddNode(node1); + adjacencyLists.Get(node1)->Set(node2, weight); + if (adjacencyLists.Has(node2)==false) + AddNode(node2); + adjacencyLists.Get(node2)->Set(node1, weight); + } + + template + void WeightedGraph::RemoveConnection(const node_type &node1, const node_type &node2) + { + adjacencyLists.Get(node2)->Delete(node1); + adjacencyLists.Get(node1)->Delete(node2); + +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + if (allow_unlinkedNodes==false) // If we do not allow _unlinked nodes, then if there are no connections, remove the node + { + if (adjacencyLists.Get(node1)->Size()==0) + RemoveNode(node1); // Will also remove node1 from the adjacency list of node2 + if (adjacencyLists.Has(node2) && adjacencyLists.Get(node2)->Size()==0) + RemoveNode(node2); + } + + ClearDijkstra(); + } + + template + void WeightedGraph::Clear(void) + { + unsigned i; + for (i=0; i < adjacencyLists.Size(); i++) + RakNet::OP_DELETE(adjacencyLists[i], _FILE_AND_LINE_); + adjacencyLists.Clear(); + + ClearDijkstra(); + } + + template + bool WeightedGraph::GetShortestPath(DataStructures::List &path, node_type startNode, node_type endNode, weight_type INFINITE_WEIGHT) + { + path.Clear(false, _FILE_AND_LINE_); + if (startNode==endNode) + { + path.Insert(startNode, _FILE_AND_LINE_); + path.Insert(endNode, _FILE_AND_LINE_); + return true; + } + + if (isValidPath==false || rootNode!=startNode) + { + ClearDijkstra(); + GenerateDisjktraMatrix(startNode, INFINITE_WEIGHT); + } + + // return the results + bool objectExists; + unsigned col,row; + weight_type currentWeight; + DataStructures::Queue outputQueue; + col=costMatrixIndices.GetIndexFromKey(endNode, &objectExists); + if (costMatrixIndices.Size()<2) + { + return false; + } + if (objectExists==false) + { + return false; + } + node_type vertex; + row=costMatrixIndices.Size()-2; + if (row==0) + { + path.Insert(startNode, _FILE_AND_LINE_); + path.Insert(endNode, _FILE_AND_LINE_); + return true; + } + currentWeight=costMatrix[row*adjacencyLists.Size() + col]; + if (currentWeight==INFINITE_WEIGHT) + { + // No path + return true; + } + vertex=endNode; + outputQueue.PushAtHead(vertex, 0, _FILE_AND_LINE_); + row--; +#ifdef _MSC_VER +#pragma warning( disable : 4127 ) // warning C4127: conditional expression is constant +#endif + while (1) + { + while (costMatrix[row*adjacencyLists.Size() + col] == currentWeight) + { + if (row==0) + { + path.Insert(startNode, _FILE_AND_LINE_); + for (col=0; outputQueue.Size(); col++) + path.Insert(outputQueue.Pop(), _FILE_AND_LINE_); + return true; + } + --row; + } + + vertex=leastNodeArray[row]; + outputQueue.PushAtHead(vertex, 0, _FILE_AND_LINE_); + if (row==0) + break; + col=costMatrixIndices.GetIndexFromKey(vertex, &objectExists); + currentWeight=costMatrix[row*adjacencyLists.Size() + col]; + } + + path.Insert(startNode, _FILE_AND_LINE_); + for (col=0; outputQueue.Size(); col++) + path.Insert(outputQueue.Pop(), _FILE_AND_LINE_); + return true; + } + + template + node_type WeightedGraph::GetNodeAtIndex(unsigned nodeIndex) const + { + return adjacencyLists.GetKeyAtIndex(nodeIndex); + } + + template + unsigned WeightedGraph::GetNodeCount(void) const + { + return adjacencyLists.Size(); + } + + template + unsigned WeightedGraph::GetConnectionCount(unsigned nodeIndex) const + { + return adjacencyLists[nodeIndex]->Size(); + } + + template + void WeightedGraph::GetConnectionAtIndex(unsigned nodeIndex, unsigned connectionIndex, node_type &outNode, weight_type &outWeight) const + { + outWeight=adjacencyLists[nodeIndex]->operator[](connectionIndex); + outNode=adjacencyLists[nodeIndex]->GetKeyAtIndex(connectionIndex); + } + + template + bool WeightedGraph::GetSpanningTree(DataStructures::Tree &outTree, DataStructures::List *inputNodes, node_type startNode, weight_type INFINITE_WEIGHT ) + { + // Find the shortest path from the start node to each of the input nodes. Add this path to a new WeightedGraph if the result is reachable + DataStructures::List path; + DataStructures::WeightedGraph outGraph; + bool res; + unsigned i,j; + for (i=0; i < inputNodes->Size(); i++) + { + res=GetShortestPath(path, startNode, (*inputNodes)[i], INFINITE_WEIGHT); + if (res && path.Size()>0) + { + for (j=0; j < path.Size()-1; j++) + { + // Don't bother looking up the weight + outGraph.AddConnection(path[j], path[j+1], INFINITE_WEIGHT); + } + } + } + + // Copy the graph to a tree. + DataStructures::Queue nodesToProcess; + DataStructures::Tree *current; + DataStructures::Map *adjacencyList; + node_type key; + NodeAndParent nap, nap2; + outTree.DeleteDecendants(); + outTree.data=startNode; + current=&outTree; + if (outGraph.adjacencyLists.Has(startNode)==false) + return false; + adjacencyList = outGraph.adjacencyLists.Get(startNode); + + for (i=0; i < adjacencyList->Size(); i++) + { + nap2.node=RakNet::OP_NEW >( _FILE_AND_LINE_ ); + nap2.node->data=adjacencyList->GetKeyAtIndex(i); + nap2.parent=current; + nodesToProcess.Push(nap2, _FILE_AND_LINE_ ); + current->children.Insert(nap2.node, _FILE_AND_LINE_); + } + + while (nodesToProcess.Size()) + { + nap=nodesToProcess.Pop(); + current=nap.node; + adjacencyList = outGraph.adjacencyLists.Get(nap.node->data); + + for (i=0; i < adjacencyList->Size(); i++) + { + key=adjacencyList->GetKeyAtIndex(i); + if (key!=nap.parent->data) + { + nap2.node=RakNet::OP_NEW >( _FILE_AND_LINE_ ); + nap2.node->data=key; + nap2.parent=current; + nodesToProcess.Push(nap2, _FILE_AND_LINE_ ); + current->children.Insert(nap2.node, _FILE_AND_LINE_); + } + } + } + + return true; + } + + template + void WeightedGraph::GenerateDisjktraMatrix(node_type startNode, weight_type INFINITE_WEIGHT) + { + if (adjacencyLists.Size()==0) + return; + + costMatrix = RakNet::OP_NEW_ARRAY(adjacencyLists.Size() * adjacencyLists.Size(), _FILE_AND_LINE_ ); + leastNodeArray = RakNet::OP_NEW_ARRAY(adjacencyLists.Size(), _FILE_AND_LINE_ ); + + node_type currentNode; + unsigned col, row, row2, openSetIndex; + node_type adjacentKey; + unsigned adjacentIndex; + weight_type edgeWeight, currentNodeWeight, adjacentNodeWeight; + DataStructures::Map *adjacencyList; + DataStructures::Heap minHeap; + DataStructures::Map openSet; + + for (col=0; col < adjacencyLists.Size(); col++) + { + // This should be already sorted, so it's a bit inefficient to do an insertion sort, but what the heck + costMatrixIndices.Insert(adjacencyLists.GetKeyAtIndex(col),adjacencyLists.GetKeyAtIndex(col), true, _FILE_AND_LINE_); + } + for (col=0; col < adjacencyLists.Size() * adjacencyLists.Size(); col++) + costMatrix[col]=INFINITE_WEIGHT; + currentNode=startNode; + row=0; + currentNodeWeight=0; + rootNode=startNode; + + // Clear the starting node column + if (adjacencyLists.Size()) + { + adjacentIndex=adjacencyLists.GetIndexAtKey(startNode); + for (row2=0; row2 < adjacencyLists.Size(); row2++) + costMatrix[row2*adjacencyLists.Size() + adjacentIndex]=0; + } + + while (row < adjacencyLists.Size()-1) + { + adjacencyList = adjacencyLists.Get(currentNode); + // Go through all connections from the current node. If the new weight is less than the current weight, then update that weight. + for (col=0; col < adjacencyList->Size(); col++) + { + edgeWeight=(*adjacencyList)[col]; + adjacentKey=adjacencyList->GetKeyAtIndex(col); + adjacentIndex=adjacencyLists.GetIndexAtKey(adjacentKey); + adjacentNodeWeight=costMatrix[row*adjacencyLists.Size() + adjacentIndex]; + + if (currentNodeWeight + edgeWeight < adjacentNodeWeight) + { + // Update the weight for the adjacent node + for (row2=row; row2 < adjacencyLists.Size(); row2++) + costMatrix[row2*adjacencyLists.Size() + adjacentIndex]=currentNodeWeight + edgeWeight; + openSet.Set(adjacentKey, currentNodeWeight + edgeWeight); + } + } + + // Find the lowest in the open set + minHeap.Clear(true,_FILE_AND_LINE_); + for (openSetIndex=0; openSetIndex < openSet.Size(); openSetIndex++) + minHeap.Push(openSet[openSetIndex], openSet.GetKeyAtIndex(openSetIndex),_FILE_AND_LINE_); + + /* + unsigned i,j; + for (i=0; i < adjacencyLists.Size()-1; i++) + { + for (j=0; j < adjacencyLists.Size(); j++) + { + RAKNET_DEBUG_PRINTF("%2i ", costMatrix[i*adjacencyLists.Size() + j]); + } + RAKNET_DEBUG_PRINTF("Node=%i", leastNodeArray[i]); + RAKNET_DEBUG_PRINTF("\n"); + } + */ + + if (minHeap.Size()==0) + { + // Unreachable nodes + isValidPath=true; + return; + } + + currentNodeWeight=minHeap.PeekWeight(0); + leastNodeArray[row]=minHeap.Pop(0); + currentNode=leastNodeArray[row]; + openSet.Delete(currentNode); + row++; + } + + /* +#ifdef _DEBUG + unsigned i,j; + for (i=0; i < adjacencyLists.Size()-1; i++) + { + for (j=0; j < adjacencyLists.Size(); j++) + { + RAKNET_DEBUG_PRINTF("%2i ", costMatrix[i*adjacencyLists.Size() + j]); + } + RAKNET_DEBUG_PRINTF("Node=%i", leastNodeArray[i]); + RAKNET_DEBUG_PRINTF("\n"); + } +#endif + */ + + isValidPath=true; + } + + template + void WeightedGraph::ClearDijkstra(void) + { + if (isValidPath) + { + isValidPath=false; + RakNet::OP_DELETE_ARRAY(costMatrix, _FILE_AND_LINE_); + RakNet::OP_DELETE_ARRAY(leastNodeArray, _FILE_AND_LINE_); + costMatrixIndices.Clear(false, _FILE_AND_LINE_); + } + } + + template + void WeightedGraph::Print(void) + { +#ifdef _DEBUG + unsigned i,j; + for (i=0; i < adjacencyLists.Size(); i++) + { + //RAKNET_DEBUG_PRINTF("%i connected to ", i); + RAKNET_DEBUG_PRINTF("%s connected to ", adjacencyLists.GetKeyAtIndex(i).systemAddress.ToString()); + + if (adjacencyLists[i]->Size()==0) + RAKNET_DEBUG_PRINTF(""); + else + { + for (j=0; j < adjacencyLists[i]->Size(); j++) + // RAKNET_DEBUG_PRINTF("%i (%.2f) ", adjacencyLists.GetIndexAtKey(adjacencyLists[i]->GetKeyAtIndex(j)), (float) adjacencyLists[i]->operator[](j) ); + RAKNET_DEBUG_PRINTF("%s (%.2f) ", adjacencyLists[i]->GetKeyAtIndex(j).systemAddress.ToString(), (float) adjacencyLists[i]->operator[](j) ); + } + + RAKNET_DEBUG_PRINTF("\n"); + } +#endif + } +} + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif diff --git a/include/raknet/DataCompressor.hpp b/include/raknet/DataCompressor.hpp new file mode 100644 index 0000000..d718330 --- /dev/null +++ b/include/raknet/DataCompressor.hpp @@ -0,0 +1,40 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DataCompressor.h +/// \brief DataCompressor does compression on a block of data. +/// \details Not very good compression, but it's small and fast so is something you can use per-message at runtime. +/// + + +#ifndef __DATA_COMPRESSOR_H +#define __DATA_COMPRESSOR_H + +#include "RakMemoryOverride.hpp" +#include "DS_HuffmanEncodingTree.hpp" +#include "Export.hpp" + +namespace RakNet +{ + +/// \brief Does compression on a block of data. Not very good compression, but it's small and fast so is something you can compute at runtime. +class RAK_DLL_EXPORT DataCompressor +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(DataCompressor) + + static void Compress( unsigned char *userData, unsigned sizeInBytes, RakNet::BitStream * output ); + static unsigned DecompressAndAllocate( RakNet::BitStream * input, unsigned char **output ); +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/DirectoryDeltaTransfer.hpp b/include/raknet/DirectoryDeltaTransfer.hpp new file mode 100644 index 0000000..06f2fc0 --- /dev/null +++ b/include/raknet/DirectoryDeltaTransfer.hpp @@ -0,0 +1,172 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DirectoryDeltaTransfer.h +/// \brief Simple class to send changes between directories. +/// \details In essence, a simple autopatcher that can be used for transmitting levels, skins, etc. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_DirectoryDeltaTransfer==1 && _RAKNET_SUPPORT_FileOperations==1 + +#ifndef __DIRECTORY_DELTA_TRANSFER_H +#define __DIRECTORY_DELTA_TRANSFER_H + +#include "RakMemoryOverride.hpp" +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "PluginInterface2.hpp" +#include "DS_Map.hpp" +#include "PacketPriority.hpp" + +/// \defgroup DIRECTORY_DELTA_TRANSFER_GROUP DirectoryDeltaTransfer +/// \brief Simple class to send changes between directories +/// \details +/// \ingroup PLUGINS_GROUP + +/// \brief Simple class to send changes between directories. In essence, a simple autopatcher that can be used for transmitting levels, skins, etc. +/// \details +/// \sa AutopatcherClient class for database driven patching, including binary deltas and search by date. +/// +/// To use, first set the path to your application. For example "C:/Games/MyRPG/"
+/// To allow other systems to download files, call AddUploadsFromSubdirectory, where the parameter is a path relative
+/// to the path to your application. This includes subdirectories.
+/// For example:
+/// SetApplicationDirectory("C:/Games/MyRPG/");
+/// AddUploadsFromSubdirectory("Mods/Skins/");
+/// would allow downloads from
+/// "C:/Games/MyRPG/Mods/Skins/*.*" as well as "C:/Games/MyRPG/Mods/Skins/Level1/*.*"
+/// It would NOT allow downloads from C:/Games/MyRPG/Levels, nor would it allow downloads from C:/Windows
+/// While pathToApplication can be anything you want, applicationSubdirectory must match either partially or fully between systems. +/// \ingroup DIRECTORY_DELTA_TRANSFER_GROUP + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +class FileList; +struct Packet; +struct InternalPacket; +struct DownloadRequest; +class FileListTransfer; +class FileListTransferCBInterface; +class FileListProgress; +class IncrementalReadInterface; + +class RAK_DLL_EXPORT DirectoryDeltaTransfer : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(DirectoryDeltaTransfer) + + // Constructor + DirectoryDeltaTransfer(); + + // Destructor + virtual ~DirectoryDeltaTransfer(); + + /// \brief This plugin has a dependency on the FileListTransfer plugin, which it uses to actually send the files. + /// \details So you need an instance of that plugin registered with RakPeerInterface, and a pointer to that interface should be passed here. + /// \param[in] flt A pointer to a registered instance of FileListTransfer + void SetFileListTransferPlugin(FileListTransfer *flt); + + /// \brief Set the local root directory to base all file uploads and downloads off of. + /// \param[in] pathToApplication This path will be prepended to \a applicationSubdirectory in AddUploadsFromSubdirectory to find the actual path on disk. + void SetApplicationDirectory(const char *pathToApplication); + + /// \brief What parameters to use for the RakPeerInterface::Send() call when uploading files. + /// \param[in] _priority See RakPeerInterface::Send() + /// \param[in] _orderingChannel See RakPeerInterface::Send() + void SetUploadSendParameters(PacketPriority _priority, char _orderingChannel); + + /// \brief Add all files in the specified subdirectory recursively. + /// \details \a subdir is appended to \a pathToApplication in SetApplicationDirectory(). + /// All files in the resultant directory and subdirectories are then hashed so that users can download them. + /// \pre You must call SetFileListTransferPlugin with a valid FileListTransfer plugin + /// \param[in] subdir Concatenated with pathToApplication to form the final path from which to allow uploads. + void AddUploadsFromSubdirectory(const char *subdir); + + /// \brief Downloads files from the matching parameter \a subdir in AddUploadsFromSubdirectory. + /// \details \a subdir must contain all starting characters in \a subdir in AddUploadsFromSubdirectory + /// Therefore, + /// AddUploadsFromSubdirectory("Levels/Level1/"); would allow you to download using DownloadFromSubdirectory("Levels/Level1/Textures/"... + /// but it would NOT allow you to download from DownloadFromSubdirectory("Levels/"... or DownloadFromSubdirectory("Levels/Level2/"... + /// \pre You must call SetFileListTransferPlugin with a valid FileListTransfer plugin + /// \note Blocking. Will block while hashes of the local files are generated + /// \param[in] subdir A directory passed to AddUploadsFromSubdirectory on the remote system. The passed dir can be more specific than the remote dir. + /// \param[in] outputSubdir The directory to write the output to. Usually this will match \a subdir but it can be different if you want. + /// \param[in] prependAppDirToOutputSubdir True to prepend outputSubdir with pathToApplication when determining the final output path. Usually you want this to be true. + /// \param[in] host The address of the remote system to send the message to. + /// \param[in] onFileCallback Callback to call per-file (optional). When fileIndex+1==setCount in the callback then the download is done + /// \param[in] _priority See RakPeerInterface::Send() + /// \param[in] _orderingChannel See RakPeerInterface::Send() + /// \param[in] cb Callback to get progress updates. Pass 0 to not use. + /// \return A set ID, identifying this download set. Returns 65535 on host unreachable. + unsigned short DownloadFromSubdirectory(const char *subdir, const char *outputSubdir, bool prependAppDirToOutputSubdir, SystemAddress host, FileListTransferCBInterface *onFileCallback, PacketPriority _priority, char _orderingChannel, FileListProgress *cb); + + /// \brief Downloads files from the matching parameter \a subdir in AddUploadsFromSubdirectory. + /// \details \a subdir must contain all starting characters in \a subdir in AddUploadsFromSubdirectory + /// Therefore, + /// AddUploadsFromSubdirectory("Levels/Level1/"); would allow you to download using DownloadFromSubdirectory("Levels/Level1/Textures/"... + /// but it would NOT allow you to download from DownloadFromSubdirectory("Levels/"... or DownloadFromSubdirectory("Levels/Level2/"... + /// \pre You must call SetFileListTransferPlugin with a valid FileListTransfer plugin + /// \note Nonblocking, but requires call to GenerateHashes() + /// \param[in] localFiles Hashes of local files already on the harddrive. Populate with GenerateHashes(), which you may wish to call from a thread + /// \param[in] subdir A directory passed to AddUploadsFromSubdirectory on the remote system. The passed dir can be more specific than the remote dir. + /// \param[in] outputSubdir The directory to write the output to. Usually this will match \a subdir but it can be different if you want. + /// \param[in] prependAppDirToOutputSubdir True to prepend outputSubdir with pathToApplication when determining the final output path. Usually you want this to be true. + /// \param[in] host The address of the remote system to send the message to. + /// \param[in] onFileCallback Callback to call per-file (optional). When fileIndex+1==setCount in the callback then the download is done + /// \param[in] _priority See RakPeerInterface::Send() + /// \param[in] _orderingChannel See RakPeerInterface::Send() + /// \param[in] cb Callback to get progress updates. Pass 0 to not use. + /// \return A set ID, identifying this download set. Returns 65535 on host unreachable. + unsigned short DownloadFromSubdirectory(FileList &localFiles, const char *subdir, const char *outputSubdir, bool prependAppDirToOutputSubdir, SystemAddress host, FileListTransferCBInterface *onFileCallback, PacketPriority _priority, char _orderingChannel, FileListProgress *cb); + + /// Hash files already on the harddrive, in preparation for a call to DownloadFromSubdirectory(). Passed to second version of DownloadFromSubdirectory() + /// This is slow, and it is exposed so you can call it from a thread before calling DownloadFromSubdirectory() + /// \param[out] localFiles List of hashed files populated from \a outputSubdir and \a prependAppDirToOutputSubdir + /// \param[in] outputSubdir The directory to write the output to. Usually this will match \a subdir but it can be different if you want. + /// \param[in] prependAppDirToOutputSubdir True to prepend outputSubdir with pathToApplication when determining the final output path. Usually you want this to be true. + void GenerateHashes(FileList &localFiles, const char *outputSubdir, bool prependAppDirToOutputSubdir); + + /// \brief Clear all allowed uploads previously set with AddUploadsFromSubdirectory + void ClearUploads(void); + + /// \brief Returns how many files are available for upload + /// \return How many files are available for upload + unsigned GetNumberOfFilesForUpload(void) const; + + /// \brief Normally, if a remote system requests files, those files are all loaded into memory and sent immediately. + /// \details This function allows the files to be read in incremental chunks, saving memory + /// \param[in] _incrementalReadInterface If a file in \a fileList has no data, filePullInterface will be used to read the file in chunks of size \a chunkSize + /// \param[in] _chunkSize How large of a block of a file to send at once + void SetDownloadRequestIncrementalReadInterface(IncrementalReadInterface *_incrementalReadInterface, unsigned int _chunkSize); + + /// \internal For plugin handling + virtual PluginReceiveResult OnReceive(Packet *packet); +protected: + void OnDownloadRequest(Packet *packet); + + char applicationDirectory[512]; + FileListTransfer *fileListTransfer; + FileList *availableUploads; + PacketPriority priority; + char orderingChannel; + IncrementalReadInterface *incrementalReadInterface; + unsigned int chunkSize; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/DynDNS.hpp b/include/raknet/DynDNS.hpp new file mode 100644 index 0000000..1cedc59 --- /dev/null +++ b/include/raknet/DynDNS.hpp @@ -0,0 +1,110 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file DynDNS.h +/// \brief Helper to class to update DynDNS +/// This can be used to determine what permissions are should be allowed to the other system +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_DynDNS==1 && _RAKNET_SUPPORT_TCPInterface==1 + +#ifndef __DYN_DNS_H +#define __DYN_DNS_H + +#include "RakString.hpp" + +namespace RakNet +{ + +class TCPInterface; + +enum DynDnsResultCode +{ + // ----- Success ----- + RC_SUCCESS, + RC_DNS_ALREADY_SET, // RakNet detects no action is needed + + // ----- Ignorable failure (treat same as success) ----- + RC_NO_CHANGE, // DynDNS detects no action is needed (treated as abuse though) + + // ----- User error ----- + RC_NOT_DONATOR, // You have to pay to do this + RC_NO_HOST, // This host does not exist at all + RC_BAD_AUTH, // You set the wrong password + RC_NOT_YOURS, // This is not your host + + // ----- Permanent failure ----- + RC_ABUSE, // Your host has been blocked, too many failures disable your account + RC_TCP_FAILED_TO_START, // TCP port already in use + RC_TCP_DID_NOT_CONNECT, // DynDNS down? + RC_UNKNOWN_RESULT, // DynDNS returned a result code that was not documented as of 12/4/2010 on http://www.dyndns.com/developers/specs/flow.pdf + RC_PARSING_FAILURE, // Can't read the result returned, format change? + RC_CONNECTION_LOST_WITHOUT_RESPONSE, // Lost the connection to DynDNS while communicating + RC_BAD_AGENT, // ??? + RC_BAD_SYS, // ??? + RC_DNS_ERROR, // ??? + RC_NOT_FQDN, // ??? + RC_NUM_HOST, // ??? + RC_911, // ??? + RC_DYNDNS_TIMEOUT // DynDNS did not respond +}; + +// Can only process one at a time with the current implementation +class RAK_DLL_EXPORT DynDNS +{ +public: + DynDNS(); + ~DynDNS(); + + // Pass 0 for newIPAddress to autodetect whatever you are uploading from + // usernameAndPassword should be in the format username:password + void UpdateHostIPAsynch(const char *dnsHost, const char *newIPAddress, const char *usernameAndPassword ); + void Update(void); + + // Output + bool IsRunning(void) const {return connectPhase!=CP_IDLE;} + bool IsCompleted(void) const {return connectPhase==CP_IDLE;} + RakNet::DynDnsResultCode GetCompletedResultCode(void) {return result;} + const char *GetCompletedDescription(void) const {return resultDescription;} + bool WasResultSuccessful(void) const {return result==RC_SUCCESS || result==RC_DNS_ALREADY_SET || result==RC_NO_CHANGE;} + char *GetMyPublicIP(void) const {return (char*) myIPStr;} // We get our public IP as part of the process. This is valid once completed + +protected: + void Stop(void); + void SetCompleted(RakNet::DynDnsResultCode _result, const char *_resultDescription) {Stop(); result=_result; resultDescription=_resultDescription;} + + enum ConnectPhase + { + CP_CONNECTING_TO_CHECKIP, + CP_WAITING_FOR_CHECKIP_RESPONSE, + CP_CONNECTING_TO_DYNDNS, + CP_WAITING_FOR_DYNDNS_RESPONSE, + CP_IDLE + }; + + TCPInterface *tcp; + RakNet::RakString getString; + SystemAddress serverAddress; + ConnectPhase connectPhase; + RakNet::RakString host; + RakNet::Time phaseTimeout; + SystemAddress checkIpAddress; + const char *resultDescription; + RakNet::DynDnsResultCode result; + char myIPStr[32]; +}; + +} // namespace RakNet + +#endif // __DYN_DNS_H + +#endif // _RAKNET_SUPPORT_DynDNS diff --git a/include/raknet/EmailSender.hpp b/include/raknet/EmailSender.hpp new file mode 100644 index 0000000..1a7b6f1 --- /dev/null +++ b/include/raknet/EmailSender.hpp @@ -0,0 +1,65 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file EmailSender.h +/// \brief Rudimentary class to send email from code. Don't expect anything fancy. +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_EmailSender==1 && _RAKNET_SUPPORT_TCPInterface==1 && _RAKNET_SUPPORT_FileOperations==1 + +#ifndef __EMAIL_SENDER_H +#define __EMAIL_SENDER_H + +#include "RakNetTypes.hpp" +#include "RakMemoryOverride.hpp" +#include "Export.hpp" +#include "Rand.hpp" +#include "TCPInterface.hpp" + +namespace RakNet +{ +/// Forward declarations +class FileList; +class TCPInterface; + +/// \brief Rudimentary class to send email from code. +class RAK_DLL_EXPORT EmailSender +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(EmailSender) + + /// \brief Sends an email. + /// \param[in] hostAddress The address of the email server. + /// \param[in] hostPort The port of the email server (usually 25) + /// \param[in] sender The email address you are sending from. + /// \param[in] recipient The email address you are sending to. + /// \param[in] senderName The email address you claim to be sending from + /// \param[in] recipientName The email address you claim to be sending to + /// \param[in] subject Email subject + /// \param[in] body Email body + /// \param[in] attachedFiles List of files to attach to the email. (Can be 0 to send none). + /// \param[in] doPrintf true to output SMTP info to console(for debugging?) + /// \param[in] password Used if the server uses AUTHENTICATE PLAIN over TLS (such as gmail) + /// \return 0 on success, otherwise a string indicating the error message + const char *Send(const char *hostAddress, unsigned short hostPort, const char *sender, const char *recipient, const char *senderName, const char *recipientName, const char *subject, const char *body, FileList *attachedFiles, bool doPrintf, const char *password); + +protected: + const char *GetResponse(TCPInterface *tcpInterface, const SystemAddress &emailServer, bool doPrintf); + RakNetRandom rakNetRandom; +}; + +} // namespace RakNet + +#endif + + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/EmptyHeader.hpp b/include/raknet/EmptyHeader.hpp new file mode 100644 index 0000000..293abfa --- /dev/null +++ b/include/raknet/EmptyHeader.hpp @@ -0,0 +1 @@ +// This is here to remove Missing #include header? in the Unreal Engine diff --git a/include/raknet/EpochTimeToString.hpp b/include/raknet/EpochTimeToString.hpp new file mode 100644 index 0000000..610204f --- /dev/null +++ b/include/raknet/EpochTimeToString.hpp @@ -0,0 +1,24 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + + +/// \file EpochTimeToString.h +/// + + +#ifndef __EPOCH_TIME_TO_STRING_H +#define __EPOCH_TIME_TO_STRING_H + +#include "Export.hpp" + +RAK_DLL_EXPORT char * EpochTimeToString(long long time); + +#endif + diff --git a/include/raknet/Export.hpp b/include/raknet/Export.hpp new file mode 100644 index 0000000..f883c95 --- /dev/null +++ b/include/raknet/Export.hpp @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#include "RakNetDefines.hpp" + +#if defined(_WIN32) && !(defined(__GNUC__) || defined(__GCCXML__)) && !defined(_RAKNET_LIB) && defined(_RAKNET_DLL) +#define RAK_DLL_EXPORT __declspec(dllexport) +#else +#define RAK_DLL_EXPORT +#endif + +#define STATIC_FACTORY_DECLARATIONS(x) static x* GetInstance(void); \ +static void DestroyInstance( x *i); + +#define STATIC_FACTORY_DEFINITIONS(x,y) x* x::GetInstance(void) {return RakNet::OP_NEW( _FILE_AND_LINE_ );} \ +void x::DestroyInstance( x *i) {RakNet::OP_DELETE(( y* ) i, _FILE_AND_LINE_);} diff --git a/include/raknet/FileList.hpp b/include/raknet/FileList.hpp new file mode 100644 index 0000000..c64a326 --- /dev/null +++ b/include/raknet/FileList.hpp @@ -0,0 +1,266 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file FileList.h +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_FileOperations==1 + +#ifndef __FILE_LIST +#define __FILE_LIST + +#include "Export.hpp" +#include "DS_List.hpp" +#include "RakMemoryOverride.hpp" +#include "RakNetTypes.hpp" +#include "FileListNodeContext.hpp" +#include "RakString.hpp" + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +namespace RakNet +{ + class BitStream; +} + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +class FileList; + + +/// Represents once instance of a file +struct FileListNode +{ + /// Name of the file + RakNet::RakString filename; + + /// Full path to the file, which may be different than filename + RakNet::RakString fullPathToFile; + + /// File data (may be null if not ready) + char *data; + + /// Length of \a data. May be greater than fileLength if prepended with a file hash + BitSize_t dataLengthBytes; + + /// Length of the file + unsigned fileLengthBytes; + + /// User specific data for whatever, describing this file. + FileListNodeContext context; + + /// If true, data and dataLengthBytes should be empty. This is just storing the filename + bool isAReference; +}; + +/// Callback interface set with FileList::SetCallback() in case you want progress notifications when FileList::AddFilesFromDirectory() is called +class RAK_DLL_EXPORT FileListProgress +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(FileListProgress) + + FileListProgress() {} + virtual ~FileListProgress() {} + + /// First callback called when FileList::AddFilesFromDirectory() starts + virtual void OnAddFilesFromDirectoryStarted(FileList *fileList, char *dir) { + (void) fileList; + (void) dir; + } + + /// Called for each directory, when that directory begins processing + virtual void OnDirectory(FileList *fileList, char *dir, unsigned int directoriesRemaining) { + (void) fileList; + (void) dir; + (void) directoriesRemaining; + } + + /// Called for each file, when that file begins processing + virtual void OnFile(FileList *fileList, char *dir, char *fileName, unsigned int fileSize) { + (void) fileList; + (void) dir; + (void) fileName; + (void) fileSize; + } + + /// \brief This function is called when we are sending a file to a remote system. + /// \param[in] fileName The name of the file being sent + /// \param[in] fileLengthBytes How long the file is + /// \param[in] offset The offset in bytes into the file that we are sending + /// \param[in] bytesBeingSent How many bytes we are sending this push + /// \param[in] done If this file is now done with this push + /// \param[in] targetSystem Who we are sending to + virtual void OnFilePush(const char *fileName, unsigned int fileLengthBytes, unsigned int offset, unsigned int bytesBeingSent, bool done, SystemAddress targetSystem, unsigned short setId) + { + (void) fileName; + (void) fileLengthBytes; + (void) offset; + (void) bytesBeingSent; + (void) done; + (void) targetSystem; + (void) setId; + } + + /// \brief This function is called when all files have been read and are being transferred to a remote system + virtual void OnFilePushesComplete( SystemAddress systemAddress, unsigned short setId ) + { + (void) systemAddress; + (void) setId; + } + + /// \brief This function is called when a send to a system was aborted (probably due to disconnection) + virtual void OnSendAborted( SystemAddress systemAddress ) + { + (void) systemAddress; + } +}; + +/// Implementation of FileListProgress to use RAKNET_DEBUG_PRINTF +class RAK_DLL_EXPORT FLP_Printf : public FileListProgress +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(FLP_Printf) + + FLP_Printf() {} + virtual ~FLP_Printf() {} + + /// First callback called when FileList::AddFilesFromDirectory() starts + virtual void OnAddFilesFromDirectoryStarted(FileList *fileList, char *dir); + + /// Called for each directory, when that directory begins processing + virtual void OnDirectory(FileList *fileList, char *dir, unsigned int directoriesRemaining); + + /// \brief This function is called when all files have been transferred to a particular remote system + virtual void OnFilePushesComplete( SystemAddress systemAddress, unsigned short setID ); + + /// \brief This function is called when a send to a system was aborted (probably due to disconnection) + virtual void OnSendAborted( SystemAddress systemAddress ); +}; + +class RAK_DLL_EXPORT FileList +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(FileList) + + FileList(); + ~FileList(); + /// \brief Add all the files at a given directory. + /// \param[in] applicationDirectory The first part of the path. This is not stored as part of the filename. Use \ as the path delineator. + /// \param[in] subDirectory The rest of the path to the file. This is stored as a prefix to the filename + /// \param[in] writeHash The first 4 bytes is a hash of the file, with the remainder the actual file data (should \a writeData be true) + /// \param[in] writeData Write the contents of each file + /// \param[in] recursive Whether or not to visit subdirectories + /// \param[in] context User defined byte to store with each file. Use for whatever you want. + void AddFilesFromDirectory(const char *applicationDirectory, const char *subDirectory, bool writeHash, bool writeData, bool recursive, FileListNodeContext context); + + /// Deallocate all memory + void Clear(void); + + /// Write all encoded data into a bitstream + void Serialize(RakNet::BitStream *outBitStream); + + /// Read all encoded data from a bitstream. Clear() is called before deserializing. + bool Deserialize(RakNet::BitStream *inBitStream); + + /// \brief Given the existing set of files, search applicationDirectory for the same files. + /// \details For each file that is missing or different, add that file to \a missingOrChangedFiles. Note: the file contents are not written, and only the hash if written if \a alwaysWriteHash is true + /// alwaysWriteHash and neverWriteHash are optimizations to avoid reading the file contents to generate the hash if not necessary because the file is missing or has different lengths anyway. + /// \param[in] applicationDirectory The first part of the path. This is not stored as part of the filename. Use \ as the path delineator. + /// \param[out] missingOrChangedFiles Output list written to + /// \param[in] alwaysWriteHash If true, and neverWriteHash is false, will hash the file content of the file on disk, and write that as the file data with a length of SHA1_LENGTH bytes. If false, if the file length is different, will only write the filename. + /// \param[in] neverWriteHash If true, will never write the hash, even if available. If false, will write the hash if the file lengths are the same and it was forced to do a comparison. + void ListMissingOrChangedFiles(const char *applicationDirectory, FileList *missingOrChangedFiles, bool alwaysWriteHash, bool neverWriteHash); + + /// \brief Return the files that need to be written to make \a input match this current FileList. + /// \details Specify dirSubset to only consider files that start with this path + /// specify remoteSubdir to assume that all filenames in input start with this path, so strip it off when comparing filenames. + /// \param[in] input Full list of files + /// \param[out] output Files that we need to match input + /// \param[in] dirSubset If the filename does not start with this path, just skip this file. + /// \param[in] remoteSubdir Remove this from the filenames of \a input when comparing to existing filenames. + void GetDeltaToCurrent(FileList *input, FileList *output, const char *dirSubset, const char *remoteSubdir); + + /// \brief Assuming FileList contains a list of filenames presumably without data, read the data for these filenames + /// \param[in] applicationDirectory Prepend this path to each filename. Trailing slash will be added if necessary. Use \ as the path delineator. + /// \param[in] writeFileData True to read and store the file data. The first SHA1_LENGTH bytes will contain the hash if \a writeFileHash is true + /// \param[in] writeFileHash True to read and store the hash of the file data. The first SHA1_LENGTH bytes will contain the hash if \a writeFileHash is true + /// \param[in] removeUnknownFiles If a file does not exist on disk but is in the file list, remove it from the file list? + void PopulateDataFromDisk(const char *applicationDirectory, bool writeFileData, bool writeFileHash, bool removeUnknownFiles); + + /// By default, GetDeltaToCurrent tags files as non-references, meaning they are assumed to be populated later + /// This tags all files as references, required for IncrementalReadInterface to process them incrementally + void FlagFilesAsReferences(void); + + /// \brief Write all files to disk, prefixing the paths with applicationDirectory + /// \param[in] applicationDirectory path prefix + void WriteDataToDisk(const char *applicationDirectory); + + /// \brief Add a file, given data already in memory. + /// \param[in] filename Name of a file, optionally prefixed with a partial or complete path. Use \ as the path delineator. + /// \param[in] fullPathToFile Full path to the file on disk + /// \param[in] data Contents to write + /// \param[in] dataLength length of the data, which may be greater than fileLength should you prefix extra data, such as the hash + /// \param[in] fileLength Length of the file + /// \param[in] context User defined byte to store with each file. Use for whatever you want. + /// \param[in] isAReference Means that this is just a reference to a file elsewhere - does not actually have any data + /// \param[in] takeDataPointer If true, do not allocate dataLength. Just take the pointer passed to the \a data parameter + void AddFile(const char *filename, const char *fullPathToFile, const char *data, const unsigned dataLength, const unsigned fileLength, FileListNodeContext context, bool isAReference=false, bool takeDataPointer=false); + + /// \brief Add a file, reading it from disk. + /// \param[in] filepath Complete path to the file, including the filename itself + /// \param[in] filename filename to store internally, anything you want, but usually either the complete path or a subset of the complete path. + /// \param[in] context User defined byte to store with each file. Use for whatever you want. + void AddFile(const char *filepath, const char *filename, FileListNodeContext context); + + /// \brief Delete all files stored in the file list. + /// \param[in] applicationDirectory Prefixed to the path to each filename. Use \ as the path delineator. + void DeleteFiles(const char *applicationDirectory); + + /// \brief Adds a callback to get progress reports about what the file list instances do. + /// \param[in] cb A pointer to an externally defined instance of FileListProgress. This pointer is held internally, so should remain valid as long as this class is valid. + void AddCallback(FileListProgress *cb); + + /// \brief Removes a callback + /// \param[in] cb A pointer to an externally defined instance of FileListProgress that was previously added with AddCallback() + void RemoveCallback(FileListProgress *cb); + + /// \brief Removes all callbacks + void ClearCallbacks(void); + + /// Returns all callbacks added with AddCallback() + /// \param[out] callbacks The list is set to the list of callbacks + void GetCallbacks(DataStructures::List &callbacks); + + // Here so you can read it, but don't modify it + DataStructures::List fileList; + + static bool FixEndingSlash(char *str); +protected: + DataStructures::List fileListProgressCallbacks; +}; + +} // namespace RakNet + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif + +#endif // _RAKNET_SUPPORT_FileOperations diff --git a/include/raknet/FileListNodeContext.hpp b/include/raknet/FileListNodeContext.hpp new file mode 100644 index 0000000..e68e7db --- /dev/null +++ b/include/raknet/FileListNodeContext.hpp @@ -0,0 +1,57 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file FileListNodeContext.h +/// + + +#ifndef __FILE_LIST_NODE_CONTEXT_H +#define __FILE_LIST_NODE_CONTEXT_H + +#include "BitStream.hpp" + +struct FileListNodeContext +{ + FileListNodeContext() {dataPtr=0; dataLength=0;} + FileListNodeContext(unsigned char o, uint32_t f1, uint32_t f2, uint32_t f3) : op(o), flnc_extraData1(f1), flnc_extraData2(f2), flnc_extraData3(f3) {dataPtr=0; dataLength=0;} + ~FileListNodeContext() {} + + unsigned char op; + uint32_t flnc_extraData1; + uint32_t flnc_extraData2; + uint32_t flnc_extraData3; + void *dataPtr; + unsigned int dataLength; +}; + +inline RakNet::BitStream& operator<<(RakNet::BitStream& out, FileListNodeContext& in) +{ + out.Write(in.op); + out.Write(in.flnc_extraData1); + out.Write(in.flnc_extraData2); + out.Write(in.flnc_extraData3); + return out; +} +inline RakNet::BitStream& operator>>(RakNet::BitStream& in, FileListNodeContext& out) +{ + in.Read(out.op); + bool success = in.Read(out.flnc_extraData1); + (void) success; + assert(success); + success = in.Read(out.flnc_extraData2); + (void) success; + assert(success); + success = in.Read(out.flnc_extraData3); + (void) success; + assert(success); + return in; +} + +#endif diff --git a/include/raknet/FileListTransfer.hpp b/include/raknet/FileListTransfer.hpp new file mode 100644 index 0000000..361f3ff --- /dev/null +++ b/include/raknet/FileListTransfer.hpp @@ -0,0 +1,185 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file FileListTransfer.h +/// \brief A plugin to provide a simple way to compress and incrementally send the files in the FileList structure. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_FileListTransfer==1 && _RAKNET_SUPPORT_FileOperations==1 + +#ifndef __FILE_LIST_TRANFER_H +#define __FILE_LIST_TRANFER_H + +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "PluginInterface2.hpp" +#include "DS_Map.hpp" +#include "RakNetTypes.hpp" +#include "PacketPriority.hpp" +#include "RakMemoryOverride.hpp" +#include "FileList.hpp" +#include "DS_Queue.hpp" +#include "SimpleMutex.hpp" +#include "ThreadPool.hpp" + +namespace RakNet +{ +/// Forward declarations +class IncrementalReadInterface; +class FileListTransferCBInterface; +class FileListProgress; +struct FileListReceiver; + +/// \defgroup FILE_LIST_TRANSFER_GROUP FileListTransfer +/// \brief A plugin to provide a simple way to compress and incrementally send the files in the FileList structure. +/// \details +/// \ingroup PLUGINS_GROUP + +/// \brief A plugin to provide a simple way to compress and incrementally send the files in the FileList structure. +/// \details Similar to the DirectoryDeltaTransfer plugin, except that it doesn't send deltas based on pre-existing files or actually write the files to disk. +/// +/// Usage: +/// Call SetupReceive to allow one file set to arrive. The value returned by FileListTransfer::SetupReceive()
+/// is the setID that is allowed.
+/// It's up to you to transmit this value to the other system, along with information indicating what kind of files you want to get.
+/// The other system should then prepare a FileList and call FileListTransfer::Send(), passing the return value of FileListTransfer::SetupReceive()
+/// as the \a setID parameter to FileListTransfer::Send() +/// \ingroup FILE_LIST_TRANSFER_GROUP +class RAK_DLL_EXPORT FileListTransfer : public PluginInterface2 +{ +public: + + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(FileListTransfer) + + FileListTransfer(); + virtual ~FileListTransfer(); + + /// \brief Optionally start worker threads when using _incrementalReadInterface for the Send() operation + /// \param[in] numThreads how many worker threads to start + /// \param[in] threadPriority Passed to the thread creation routine. Use THREAD_PRIORITY_NORMAL for Windows. For Linux based systems, you MUST pass something reasonable based on the thread priorities for your application. + void StartIncrementalReadThreads(int numThreads, int threadPriority=-99999); + + /// \brief Allows one corresponding Send() call from another system to arrive. + /// \param[in] handler The class to call on each file + /// \param[in] deleteHandler True to delete the handler when it is no longer needed. False to not do so. + /// \param[in] allowedSender Which system to allow files from. + /// \return A set ID value, which should be passed as the \a setID value to the Send() call on the other system. This value will be returned in the callback and is unique per file set. Returns 65535 on failure (not connected to sender) + unsigned short SetupReceive(FileListTransferCBInterface *handler, bool deleteHandler, SystemAddress allowedSender); + + /// \brief Send the FileList structure to another system, which must have previously called SetupReceive(). + /// \param[in] fileList A list of files. The data contained in FileList::data will be sent incrementally and compressed among all files in the set + /// \param[in] rakPeer The instance of RakNet to use to send the message. Pass 0 to use the instance the plugin is attached to + /// \param[in] recipient The address of the system to send to + /// \param[in] setID The return value of SetupReceive() which was previously called on \a recipient + /// \param[in] priority Passed to RakPeerInterface::Send() + /// \param[in] orderingChannel Passed to RakPeerInterface::Send() + /// \param[in] _incrementalReadInterface If a file in \a fileList has no data, _incrementalReadInterface will be used to read the file in chunks of size \a chunkSize + /// \param[in] _chunkSize How large of a block of a file to read/send at once. Large values use more memory but transfer slightly faster. + void Send(FileList *fileList, RakNet::RakPeerInterface *rakPeer, SystemAddress recipient, unsigned short setID, PacketPriority priority, char orderingChannel, IncrementalReadInterface *_incrementalReadInterface=0, unsigned int _chunkSize=262144*4*16); + + /// Return number of files waiting to go out to a particular address + unsigned int GetPendingFilesToAddress(SystemAddress recipient); + + /// \brief Stop a download. + void CancelReceive(unsigned short setId); + + /// \brief Remove all handlers associated with a particular system address. + void RemoveReceiver(SystemAddress systemAddress); + + /// \brief Is a handler passed to SetupReceive still running? + bool IsHandlerActive(unsigned short setId); + + /// \brief Adds a callback to get progress reports about what the file list instances do. + /// \param[in] cb A pointer to an externally defined instance of FileListProgress. This pointer is held internally, so should remain valid as long as this class is valid. + void AddCallback(FileListProgress *cb); + + /// \brief Removes a callback + /// \param[in] cb A pointer to an externally defined instance of FileListProgress that was previously added with AddCallback() + void RemoveCallback(FileListProgress *cb); + + /// \brief Removes all callbacks + void ClearCallbacks(void); + + /// Returns all callbacks added with AddCallback() + /// \param[out] callbacks The list is set to the list of callbacks + void GetCallbacks(DataStructures::List &callbacks); + + /// \internal For plugin handling + virtual PluginReceiveResult OnReceive(Packet *packet); + /// \internal For plugin handling + virtual void OnRakPeerShutdown(void); + /// \internal For plugin handling + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + /// \internal For plugin handling + virtual void Update(void); + +protected: + bool DecodeSetHeader(Packet *packet); + bool DecodeFile(Packet *packet, bool fullFile); + + void Clear(void); + + void OnReferencePush(Packet *packet, bool fullFile); + void OnReferencePushAck(Packet *packet); + void SendIRIToAddress(SystemAddress systemAddress, unsigned short setId); + + DataStructures::Map fileListReceivers; + unsigned short setId; + DataStructures::List fileListProgressCallbacks; + + struct FileToPush + { + FileListNode fileListNode; + PacketPriority packetPriority; + char orderingChannel; + unsigned int currentOffset; + ////unsigned short setID; + unsigned int setIndex; + IncrementalReadInterface *incrementalReadInterface; + unsigned int chunkSize; + }; + struct FileToPushRecipient + { + unsigned int refCount; + SimpleMutex refCountMutex; + void DeleteThis(void); + void AddRef(void); + void Deref(void); + + SystemAddress systemAddress; + unsigned short setId; + + //// SimpleMutex filesToPushMutex; + DataStructures::Queue filesToPush; + }; + DataStructures::List< FileToPushRecipient* > fileToPushRecipientList; + SimpleMutex fileToPushRecipientListMutex; + void RemoveFromList(FileToPushRecipient *ftpr); + + struct ThreadData + { + FileListTransfer *fileListTransfer; + SystemAddress systemAddress; + unsigned short setId; + }; + + ThreadPool threadPool; + + friend int SendIRIToAddressCB(FileListTransfer::ThreadData threadData, bool *returnOutput, void* perThreadData); +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/FileListTransferCBInterface.hpp b/include/raknet/FileListTransferCBInterface.hpp new file mode 100644 index 0000000..1de388e --- /dev/null +++ b/include/raknet/FileListTransferCBInterface.hpp @@ -0,0 +1,162 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file FileListTransferCBInterface.h +/// + + +#ifndef __FILE_LIST_TRANSFER_CALLBACK_INTERFACE_H +#define __FILE_LIST_TRANSFER_CALLBACK_INTERFACE_H + +#include "RakMemoryOverride.hpp" +#include "FileListNodeContext.hpp" + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +namespace RakNet +{ + +/// \brief Used by FileListTransfer plugin as a callback for when we get a file. +/// \details You get the last file when fileIndex==numberOfFilesInThisSet +/// \sa FileListTransfer +class FileListTransferCBInterface +{ +public: + // Note: If this structure is changed the struct in the swig files need to be changed as well + struct OnFileStruct + { + /// \brief The index into the set of files, from 0 to numberOfFilesInThisSet + unsigned fileIndex; + + /// \brief The name of the file + char fileName[512]; + + /// \brief The data pointed to by the file + char *fileData; + + /// \brief The amount of data to be downloaded for this file + BitSize_t byteLengthOfThisFile; + + /// \brief How many bytes of this file has been downloaded + BitSize_t bytesDownloadedForThisFile; + + /// \brief Files are transmitted in sets, where more than one set of files can be transmitted at the same time. + /// \details This is the identifier for the set, which is returned by FileListTransfer::SetupReceive + unsigned short setID; + + /// \brief The number of files that are in this set. + unsigned numberOfFilesInThisSet; + + /// \brief The total length of the transmitted files for this set, after being uncompressed + unsigned byteLengthOfThisSet; + + /// \brief The total length, in bytes, downloaded for this set. + unsigned bytesDownloadedForThisSet; + + /// \brief User data passed to one of the functions in the FileList class. + /// \details However, on error, this is instead changed to one of the enumerations in the PatchContext structure. + FileListNodeContext context; + + /// \brief Who sent this file + SystemAddress senderSystemAddress; + + /// \brief Who sent this file. Not valid when using TCP, only RakPeer (UDP) + RakNetGUID senderGuid; + }; + + // Note: If this structure is changed the struct in the swig files need to be changed as well + struct FileProgressStruct + { + /// \param[out] onFileStruct General information about this file, such as the filename and the first \a partLength bytes. You do NOT need to save this data yourself. The complete file will arrive normally. + OnFileStruct *onFileStruct; + /// \param[out] partCount The zero based index into partTotal. The percentage complete done of this file is 100 * (partCount+1)/partTotal + unsigned int partCount; + /// \param[out] partTotal The total number of parts this file was split into. Each part will be roughly the MTU size, minus the UDP header and RakNet headers + unsigned int partTotal; + /// \param[out] dataChunkLength How many bytes long firstDataChunk and iriDataChunk are + unsigned int dataChunkLength; + /// \param[out] firstDataChunk The first \a partLength of the final file. If you store identifying information about the file in the first \a partLength bytes, you can read them while the download is taking place. If this hasn't arrived yet, firstDataChunk will be 0 + char *firstDataChunk; + /// \param[out] iriDataChunk If the remote system is sending this file using IncrementalReadInterface, then this is the chunk we just downloaded. It will not exist in memory after this callback. You should either store this to disk, or in memory. If it is 0, then the file is smaller than one chunk, and will be held in memory automatically + char *iriDataChunk; + /// \param[out] iriWriteOffset Offset in bytes from the start of the file for the data pointed to by iriDataChunk + unsigned int iriWriteOffset; + /// \param[out] Who sent this file + SystemAddress senderSystemAddress; + /// \param[out] Who sent this file. Not valid when using TCP, only RakPeer (UDP) + RakNetGUID senderGuid; + /// \param[in] allocateIrIDataChunkAutomatically If true, then RakNet will hold iriDataChunk for you and return it in OnFile. Defaults to true + bool allocateIrIDataChunkAutomatically; + }; + + struct DownloadCompleteStruct + { + /// \brief Files are transmitted in sets, where more than one set of files can be transmitted at the same time. + /// \details This is the identifier for the set, which is returned by FileListTransfer::SetupReceive + unsigned short setID; + + /// \brief The number of files that are in this set. + unsigned numberOfFilesInThisSet; + + /// \brief The total length of the transmitted files for this set, after being uncompressed + unsigned byteLengthOfThisSet; + + /// \brief Who sent this file + SystemAddress senderSystemAddress; + + /// \brief Who sent this file. Not valid when using TCP, only RakPeer (UDP) + RakNetGUID senderGuid; + }; + + FileListTransferCBInterface() {} + virtual ~FileListTransferCBInterface() {} + + /// \brief Got a file. + /// \details This structure is only valid for the duration of this function call. + /// \return Return true to have RakNet delete the memory allocated to hold this file for this function call. + virtual bool OnFile(OnFileStruct *onFileStruct)=0; + + /// \brief Got part of a big file internally in RakNet + /// \details This is called in one of two circumstances: Either the transport layer is returning ID_PROGRESS_NOTIFICATION, or you got a block via IncrementalReadInterface + /// If the transport layer is returning ID_PROGRESS_NOTIFICATION (see RakPeer::SetSplitMessageProgressInterval()) then FileProgressStruct::iriDataChunk will be 0. + /// If this is a block via IncrementalReadInterface, then iriDataChunk will point to the block just downloaded. + /// If not using IncrementalReadInterface, then you only care about partCount and partTotal to tell how far the download has progressed. YOu can use firstDataChunk to read the first part of the file if desired. The file is usable when you get the OnFile callback. + /// If using IncrementalReadInterface and you let RakNet buffer the files in memory (default), then it is the same as above. The file is usable when you get the OnFile callback. + /// If using IncrementalReadInterface and you do not let RakNet buffer the files in memory, then set allocateIrIDataChunkAutomatically to false. Write the file to disk whenever you get OnFileProgress and iriDataChunk is not 0, and ignore OnFile. + virtual void OnFileProgress(FileProgressStruct *fps)=0; + + /// \brief Called while the handler is active by FileListTransfer + /// \details Return false when you are done with the class. + /// At that point OnDereference will be called and the class will no longer be maintained by the FileListTransfer plugin. + virtual bool Update(void) {return true;} + + /// \brief Called when the download is completed. + /// \details If you are finished with this class, return false. + /// At that point OnDereference will be called and the class will no longer be maintained by the FileListTransfer plugin. + /// Otherwise return true, and Update will continue to be called. + virtual bool OnDownloadComplete(DownloadCompleteStruct *dcs) {(void) dcs; return false;} + + /// \brief This function is called when this instance is about to be dereferenced by the FileListTransfer plugin. + /// \details Update will no longer be called. + /// It will will be deleted automatically if true was passed to FileListTransfer::SetupReceive::deleteHandler + /// Otherwise it is up to you to delete it yourself. + virtual void OnDereference(void) {} +}; + +} // namespace RakNet + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif + diff --git a/include/raknet/FileOperations.hpp b/include/raknet/FileOperations.hpp new file mode 100644 index 0000000..a677df1 --- /dev/null +++ b/include/raknet/FileOperations.hpp @@ -0,0 +1,32 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file FileOperations.h +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_FileOperations==1 + +#ifndef __FILE_OPERATIONS_H +#define __FILE_OPERATIONS_H + +#include "Export.hpp" + +bool RAK_DLL_EXPORT WriteFileWithDirectories( const char *path, char *data, unsigned dataLength ); +bool RAK_DLL_EXPORT IsSlash(unsigned char c); +void RAK_DLL_EXPORT AddSlash( char *input ); +void RAK_DLL_EXPORT QuoteIfSpaces(char *str); +bool RAK_DLL_EXPORT DirectoryExists(const char *directory); +unsigned int RAK_DLL_EXPORT GetFileLength(const char *path); + +#endif + +#endif // _RAKNET_SUPPORT_FileOperations diff --git a/include/raknet/FormatString.hpp b/include/raknet/FormatString.hpp new file mode 100644 index 0000000..8a2555f --- /dev/null +++ b/include/raknet/FormatString.hpp @@ -0,0 +1,30 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file FormatString.h +/// + + +#ifndef __FORMAT_STRING_H +#define __FORMAT_STRING_H + +#include "Export.hpp" + +extern "C" { +char * FormatString(const char *format, ...); +} +// Threadsafe +extern "C" { +char * FormatStringTS(char *output, const char *format, ...); +} + + +#endif + diff --git a/include/raknet/FullyConnectedMesh2.hpp b/include/raknet/FullyConnectedMesh2.hpp new file mode 100644 index 0000000..420e7dc --- /dev/null +++ b/include/raknet/FullyConnectedMesh2.hpp @@ -0,0 +1,424 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file FullyConnectedMesh2.h +/// \brief Fully connected mesh plugin, revision 2. +/// \details This will connect RakPeer to all connecting peers, and all peers the connecting peer knows about. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_FullyConnectedMesh2==1 + +#ifndef __FULLY_CONNECTED_MESH_2_H +#define __FULLY_CONNECTED_MESH_2_H + +#include "PluginInterface2.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" +#include "DS_List.hpp" +#include "RakString.hpp" +#include "BitStream.hpp" + +typedef int64_t FCM2Guid; + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \brief Fully connected mesh plugin, revision 2 +/// \details This will connect RakPeer to all connecting peers, and all peers the connecting peer knows about.
+/// It will also calculate which system has been running longest, to find out who should be host, if you need one system to act as a host +/// \pre You must also install the ConnectionGraph2 plugin in order to use SetConnectOnNewRemoteConnection() +/// \ingroup FULLY_CONNECTED_MESH_GROUP +class RAK_DLL_EXPORT FullyConnectedMesh2 : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(FullyConnectedMesh2) + + FullyConnectedMesh2(); + virtual ~FullyConnectedMesh2(); + + /// When the message ID_REMOTE_NEW_INCOMING_CONNECTION arrives, we try to connect to that system + /// If \a attemptConnection is false, you can manually connect to all systems listed in ID_REMOTE_NEW_INCOMING_CONNECTION with ConnectToRemoteNewIncomingConnections() + /// \note This will not work on any console. It will also not work if NAT punchthrough is needed. Generally, this should be false and you should connect manually. It is here for legacy reasons. + /// \param[in] attemptConnection If true, we try to connect to any systems we are notified about with ID_REMOTE_NEW_INCOMING_CONNECTION, which comes from the ConnectionGraph2 plugin. Defaults to true. + /// \param[in] pw The password to use to connect with. Only used if \a attemptConnection is true + void SetConnectOnNewRemoteConnection(bool attemptConnection, RakNet::RakString pw); + + /// \brief The connected host is whichever system we are connected to that has been running the longest. + /// \details Will return UNASSIGNED_RAKNET_GUID if we are not connected to anyone, or if we are connected and are calculating the host + /// If includeCalculating is true, will return the estimated calculated host as long as the calculation is nearly complete + /// includeCalculating should be true if you are taking action based on another system becoming host, because not all host calculations may complete at the exact same time + /// \sa ConnectionGraph2::GetLowestAveragePingSystem() . If you need one system in the peer to peer group to relay data, have the host call this function after host migration, and use that system + /// \return System address of whichever system is host. + RakNetGUID GetConnectedHost(void) const; + SystemAddress GetConnectedHostAddr(void) const; + + /// \return System address of whichever system is host. Always returns something, even though it may be our own system. + RakNetGUID GetHostSystem(void) const; + + /// \return If our system is host + bool IsHostSystem(void) const; + + /// Get the list of connected systems, from oldest connected to newest + /// This is also the order that the hosts will be chosen in + void GetHostOrder(DataStructures::List &hostList); + + /// \param[in] includeCalculating If true, and we are currently calculating a new host, return the new host if the calculation is nearly complete + /// \return If our system is host + bool IsConnectedHost(void) const; + + /// \brief Automatically add new connections to the fully connected mesh. + /// Each remote system that you want to check should be added as a participant, either through SetAutoparticipateConnections() or by calling this function + /// \details Defaults to true. + /// \param[in] b As stated + void SetAutoparticipateConnections(bool b); + + /// Clear our own host order, and recalculate as if we had just reconnected + /// Call this to reset the running time of the host just before joining/creating a game room for networking + void ResetHostCalculation(void); + + /// \brief if SetAutoparticipateConnections() is called with false, then you need to use AddParticipant before these systems will be added to the mesh + /// FullyConnectedMesh2 will track who is the who host among a fully connected mesh of participants + /// Each remote system that you want to check should be added as a participant, either through SetAutoparticipateConnections() or by calling this function + /// \param[in] participant The new participant + /// \param[in] userContext Static data to be passed around with each participant, which can be queried with GetParticipantData(). + /// \sa StartVerifiedJoin() + void AddParticipant(RakNetGUID rakNetGuid); + + /// Get the participants added with AddParticipant() + /// \param[out] participantList Participants added with AddParticipant(); + void GetParticipantList(DataStructures::List &participantList); + + /// \brief Returns if a participant is in the participant list + /// \param[in] RakNetGUID of the participant to query + /// \return True if in the list + bool HasParticipant(RakNetGUID participantGuid); + + /// \brief Reads userData written with SetMyContext() + /// \param[in] RakNetGUID of the participant to query + /// \param[out] userContext Pointer to BitStream to be written to + /// \return True if data was written + // bool GetParticipantContext(RakNetGUID participantGuid, BitStream *userContext); + + /// Set data for other systems to read with GetParticipantContext + /// \param[in] userContext Pointer to BitStream to be read from + // void SetMyContext(BitStream *userContext); + + /// Connect to all systems from ID_REMOTE_NEW_INCOMING_CONNECTION + /// You can call this if SetConnectOnNewRemoteConnection is false + /// \param[in] packet The packet containing ID_REMOTE_NEW_INCOMING_CONNECTION + /// \param[in] connectionPassword Password passed to RakPeerInterface::Connect() + /// \param[in] connectionPasswordLength Password length passed to RakPeerInterface::Connect() + void ConnectToRemoteNewIncomingConnections(Packet *packet); + + /// \brief Clear all memory and reset everything + void Clear(void); + + unsigned int GetParticipantCount(void) const; + void GetParticipantCount(unsigned int *participantListSize) const; + + /// In the simple case of forming a peer to peer mesh: + /// + /// 1. AddParticipant() is called on the host whenever you get a new connection + /// 2. The host sends all participants to the new client + /// 3. The client connects to the participant list + /// + /// However, the above steps assumes connections to all systems in the mesh always complete. + /// When there is a risk of failure, such as if relying on NATPunchthroughClient, you may not want to call AddParticipant() until are connections have completed to all other particpants + /// StartVerifiedJoin() can manage the overhead of the negotiation involved so the programmer only has to deal with overall success or failure + /// + /// Processing: + /// 1. Send the RakNetGUID and SystemAddress values of GetParticipantList() to the client with ID_FCM2_VERIFIED_JOIN_START + /// 2. The client, on ID_FCM2_VERIFIED_JOIN_START, can execute NatPunchthroughClient::OpenNAT() (optional), followed by RakPeerInterface::Connect() if punchthrough success, for each system returned from GetVerifiedJoinRequiredProcessingList() + /// 3. After all participants in step 2 have connected, failed to connect, or failed NatPunchthrough, the client automatically sends the results to the server. + /// 4. The server compares the results of the operations in step 2 with the values from GetParticpantList(). + /// 4A. If the client failed to connect to a current participant, return ID_FCM2_VERIFIED_JOIN_FAILED to the client. CloseConnection() is automatically called on the client for the failed participants. + /// 4B. If AddParticipant() was called between steps 1 and 4, go back to step 1, transmitting new participants. + /// 4C. If the client successfully connected to all participants, the server gets ID_FCM2_VERIFIED_JOIN_CAPABLE. The server programmer, on the same frame, should execute RespondOnVerifiedJoinCapable() to either accept or reject the client. + /// 5. If the client got ID_FCM2_VERIFIED_JOIN_ACCEPTED, AddParticipant() is automatically called for each system in the mesh. + /// 6. If the client got ID_FCM2_VERIFIED_JOIN_REJECTED, CloseConnection() is automatically called for each system in the mesh. The connection is NOT automatically closed to the original host that sent StartVerifiedJoin(). + /// 7. If the client's connection to the server was lost before getting ID_FCM2_VERIFIED_JOIN_ACCEPTED or ID_FCM2_VERIFIED_JOIN_REJECTED, return to the programmer ID_FCM2_VERIFIED_JOIN_FAILED and call RakPeerInterface::CloseConnection() + /// + /// \brief Notify the client of GetParticipantList() in order to connect to each of those systems until the mesh has been completed + /// \param[in] client The system to send ID_FCM2_VERIFIED_JOIN_START to + virtual void StartVerifiedJoin(RakNetGUID client); + + /// \brief On ID_FCM2_VERIFIED_JOIN_CAPABLE , accept or reject the new connection + /// \code + /// fullyConnectedMesh->RespondOnVerifiedJoinCapable(packet, true, 0); + /// \endcode + /// \param[in] packet The system that sent ID_FCM2_VERIFIED_JOIN_CAPABLE. Based on \accept, ID_FCM2_VERIFIED_JOIN_ACCEPTED or ID_FCM2_VERIFIED_JOIN_REJECTED will be sent in reply + /// \param[in] accept True to accept, and thereby automatically call AddParticipant() on all systems on the mesh. False to reject, and call CloseConnection() to all mesh systems on the target + /// \param[in] additionalData Any additional data you want to add to the ID_FCM2_VERIFIED_JOIN_ACCEPTED or ID_FCM2_VERIFIED_JOIN_REJECTED messages + /// \sa WriteVJCUserData() + virtual void RespondOnVerifiedJoinCapable(Packet *packet, bool accept, BitStream *additionalData); + + /// \brief On ID_FCM2_VERIFIED_JOIN_START, read the SystemAddress and RakNetGUID values of each system to connect to + /// \code + /// DataStructures::List addresses; + /// DataStructures::List guids; + /// fullyConnectedMesh->GetVerifiedJoinRequiredProcessingList(packet->guid, addresses, guids); + /// for (unsigned int i=0; i < addresses.Size(); i++) + /// rakPeer[i]->Connect(addresses[i].ToString(false), addresses[i].GetPort(), 0, 0); + /// \endcode + /// \param[in] host Which system sent ID_FCM2_VERIFIED_JOIN_START + /// \param[out] addresses SystemAddress values of systems to connect to. List has the same number and order as \a guids + /// \param[out] guids RakNetGUID values of systems to connect to. List has the same number and order as \a guids + /// \param[out] userData What was written with WriteVJSUserData + virtual void GetVerifiedJoinRequiredProcessingList(RakNetGUID host, + DataStructures::List &addresses, + DataStructures::List &guids, + DataStructures::List &userData); + + /// \brief On ID_FCM2_VERIFIED_JOIN_ACCEPTED, read additional data passed to RespondOnVerifiedJoinCapable() + /// \code + /// bool thisSystemAccepted; + /// DataStructures::List systemsAccepted; + /// RakNet::BitStream additionalData; + /// fullyConnectedMesh->GetVerifiedJoinAcceptedAdditionalData(packet, &thisSystemAccepted, systemsAccepted, &additionalData); + /// \endcode + /// \param[in] packet Packet containing the ID_FCM2_VERIFIED_JOIN_ACCEPTED message + /// \param[out] thisSystemAccepted If true, it was this instance of RakPeerInterface that was accepted. If false, this is notification for another system + /// \param[out] systemsAccepted Which system(s) were added with AddParticipant(). If \a thisSystemAccepted is false, this list will only have length 1 + /// \param[out] additionalData \a additionalData parameter passed to RespondOnVerifiedJoinCapable() + virtual void GetVerifiedJoinAcceptedAdditionalData(Packet *packet, bool *thisSystemAccepted, DataStructures::List &systemsAccepted, BitStream *additionalData); + + /// \brief On ID_FCM2_VERIFIED_JOIN_REJECTED, read additional data passed to RespondOnVerifiedJoinCapable() + /// \details This does not automatically close the connection. The following code will do so: + /// \code + /// rakPeer[i]->CloseConnection(packet->guid, true); + /// \endcode + /// \param[in] packet Packet containing the ID_FCM2_VERIFIED_JOIN_REJECTED message + /// \param[out] additionalData \a additionalData parameter passed to RespondOnVerifiedJoinCapable(). + virtual void GetVerifiedJoinRejectedAdditionalData(Packet *packet, BitStream *additionalData); + + /// Override to write data when ID_FCM2_VERIFIED_JOIN_CAPABLE is sent + virtual void WriteVJCUserData(RakNet::BitStream *bsOut) {(void) bsOut;} + + /// Use to read data written from WriteVJCUserData() + /// \code + /// RakNet::BitStream bsIn(packet->data,packet->length,false); + /// FullyConnectedMesh2::SkipToVJCUserData(&bsIn); + /// // Your code here + static void SkipToVJCUserData(RakNet::BitStream *bsIn); + + /// Write custom user data to be sent with ID_FCM2_VERIFIED_JOIN_START, per user + /// \param[out] bsOut Write your data here, if any. Has to match what is read by ReadVJSUserData + /// \param[in] userGuid The RakNetGuid of the user you are writing for + /// \param[in] userContext The data set with SetMyContext() for that system. May be empty. To properly write userContext, you will need to first write userContext->GetNumberOfBitsUsed(), followed by bsOut->Write(userContext); + //virtual void WriteVJSUserData(RakNet::BitStream *bsOut, RakNetGUID userGuid, BitStream *userContext) {(void) bsOut; (void) userGuid; (void) userContext;} + virtual void WriteVJSUserData(RakNet::BitStream *bsOut, RakNetGUID userGuid) {(void) bsOut; (void) userGuid;} + + /// \internal + RakNet::TimeUS GetElapsedRuntime(void); + + /// \internal + virtual PluginReceiveResult OnReceive(Packet *packet); + /// \internal + virtual void OnRakPeerStartup(void); + /// \internal + virtual void OnAttach(void); + /// \internal + virtual void OnRakPeerShutdown(void); + /// \internal + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + /// \internal + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + /// \internal + virtual void OnFailedConnectionAttempt(Packet *packet, PI2_FailedConnectionAttemptReason failedConnectionAttemptReason); + + /// \internal + struct FCM2Participant + { + FCM2Participant() {} + FCM2Participant(const FCM2Guid &_fcm2Guid, const RakNetGUID &_rakNetGuid) : fcm2Guid(_fcm2Guid), rakNetGuid(_rakNetGuid) {} + + // Low half is a random number. + // High half is the order we connected in (totalConnectionCount) + FCM2Guid fcm2Guid; + RakNetGUID rakNetGuid; + // BitStream userContext; + }; + + enum JoinInProgressState + { + JIPS_PROCESSING, + JIPS_FAILED, + JIPS_CONNECTED, + JIPS_UNNECESSARY, + }; + + struct VerifiedJoinInProgressMember + { + SystemAddress systemAddress; + RakNetGUID guid; + JoinInProgressState joinInProgressState; + BitStream *userData; + + bool workingFlag; + }; + + /// \internal + struct VerifiedJoinInProgress + { + RakNetGUID requester; + DataStructures::List vjipMembers; + //bool sentResults; + }; + + /// \internal for debugging + unsigned int GetTotalConnectionCount(void) const; + +protected: + void PushNewHost(const RakNetGUID &guid, RakNetGUID oldHost); + void SendOurFCMGuid(SystemAddress addr); + void SendFCMGuidRequest(RakNetGUID rakNetGuid); + void SendConnectionCountResponse(SystemAddress addr, unsigned int responseTotalConnectionCount); + void OnRequestFCMGuid(Packet *packet); + //void OnUpdateUserContext(Packet *packet); + void OnRespondConnectionCount(Packet *packet); + void OnInformFCMGuid(Packet *packet); + void OnUpdateMinTotalConnectionCount(Packet *packet); + void AssignOurFCMGuid(void); + void CalculateHost(RakNetGUID *rakNetGuid, FCM2Guid *fcm2Guid); + // bool AddParticipantInternal( RakNetGUID rakNetGuid, FCM2Guid theirFCMGuid, BitStream *userContext ); + bool AddParticipantInternal( RakNetGUID rakNetGuid, FCM2Guid theirFCMGuid ); + void CalculateAndPushHost(void); + bool ParticipantListComplete(void); + void IncrementTotalConnectionCount(unsigned int i); + PluginReceiveResult OnVerifiedJoinStart(Packet *packet); + PluginReceiveResult OnVerifiedJoinCapable(Packet *packet); + virtual void OnVerifiedJoinFailed(RakNetGUID hostGuid, bool callCloseConnection); + virtual void OnVerifiedJoinAccepted(Packet *packet); + virtual void OnVerifiedJoinRejected(Packet *packet); + unsigned int GetJoinsInProgressIndex(RakNetGUID requester) const; + void UpdateVerifiedJoinInProgressMember(const AddressOrGUID systemIdentifier, RakNetGUID guidToAssign, JoinInProgressState newState); + bool ProcessVerifiedJoinInProgressIfCompleted(VerifiedJoinInProgress *vjip); + void ReadVerifiedJoinInProgressMember(RakNet::BitStream *bsIn, VerifiedJoinInProgressMember *vjipm); + unsigned int GetVerifiedJoinInProgressMemberIndex(const AddressOrGUID systemIdentifier, VerifiedJoinInProgress *vjip); + void DecomposeJoinCapable(Packet *packet, VerifiedJoinInProgress *vjip); + void WriteVerifiedJoinCapable(RakNet::BitStream *bsOut, VerifiedJoinInProgress *vjip); + void CategorizeVJIP(VerifiedJoinInProgress *vjip, + DataStructures::List &participatingMembersOnClientSucceeded, + DataStructures::List &participatingMembersOnClientFailed, + DataStructures::List &participatingMembersNotOnClient, + DataStructures::List &clientMembersNotParticipatingSucceeded, + DataStructures::List &clientMembersNotParticipatingFailed); + + // Used to track how long RakNet has been running. This is so we know who has been running longest + RakNet::TimeUS startupTime; + + // Option for SetAutoparticipateConnections + bool autoParticipateConnections; + + // totalConnectionCount is roughly maintained across all systems, and increments by 1 each time a new system connects to the mesh + // It is always kept at the highest known value + // It is used as the high 4 bytes for new FCMGuids. This causes newer values of FCM2Guid to be higher than lower values. The lowest value is the host. + unsigned int totalConnectionCount; + + // Our own ourFCMGuid. Starts at unassigned (0). Assigned once we send ID_FCM2_REQUEST_FCMGUID and get back ID_FCM2_RESPOND_CONNECTION_COUNT + FCM2Guid ourFCMGuid; + + /// List of systems we know the FCM2Guid for + DataStructures::List fcm2ParticipantList; + + RakNetGUID lastPushedHost; + + // Optimization: Store last calculated host in these variables. + RakNetGUID hostRakNetGuid; + FCM2Guid hostFCM2Guid; + + RakNet::RakString connectionPassword; + bool connectOnNewRemoteConnections; + + DataStructures::List joinsInProgress; + BitStream myContext; +}; + +} // namespace RakNet + +/* +Startup() +ourFCMGuid=unknown +totalConnectionCount=0 +Set startupTime + +AddParticipant() +if (sender by guid is a participant) +return; +AddParticipantInternal(guid); +if (ourFCMGuid==unknown) +Send to that system a request for their fcmGuid, totalConnectionCount. Inform startupTime. +else +Send to that system a request for their fcmGuid. Inform total connection count, our fcmGuid + +OnRequestGuid() +if (sender by guid is not a participant) +{ + // They added us as a participant, but we didn't add them. This can be caused by lag where both participants are not added at the same time. + // It doesn't affect the outcome as long as we still process the data + AddParticipantInternal(guid); +} +if (ourFCMGuid==unknown) +{ + if (includedStartupTime) + { + // Nobody has a fcmGuid + + if (their startup time is greater than our startup time) + ReplyConnectionCount(1); + else + ReplyConnectionCount(2); + } + else + { + // They have a fcmGuid, we do not + + SetMaxTotalConnectionCount(remoteCount); + AssignTheirGuid() + GenerateOurGuid(); + SendOurGuid(all); + } +} +else +{ + if (includedStartupTime) + { + // We have a fcmGuid they do not + + ReplyConnectionCount(totalConnectionCount+1); + SendOurGuid(sender); + } + else + { + // We both have fcmGuids + + SetMaxTotalConnectionCount(remoteCount); + AssignTheirGuid(); + SendOurGuid(sender); + } +} + +OnReplyConnectionCount() +SetMaxTotalConnectionCount(remoteCount); +GenerateOurGuid(); +SendOurGuid(allParticipants); + +OnReceiveTheirGuid() +AssignTheirGuid() +*/ + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/GetTime.hpp b/include/raknet/GetTime.hpp new file mode 100644 index 0000000..98abf0b --- /dev/null +++ b/include/raknet/GetTime.hpp @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file GetTime.h +/// \brief Returns the value from QueryPerformanceCounter. This is the function RakNet uses to represent time. This time won't match the time returned by GetTimeCount(). See http://www.jenkinssoftware.com/forum/index.php?topic=2798.0 +/// + + +#ifndef __GET_TIME_H +#define __GET_TIME_H + +#include "Export.hpp" +#include "RakNetTime.hpp" // For RakNet::TimeMS + +namespace RakNet +{ + /// Same as GetTimeMS + /// Holds the time in either a 32 or 64 bit variable, depending on __GET_TIME_64BIT + RakNet::Time RAK_DLL_EXPORT GetTime( void ); + + /// Return the time as 32 bit + /// \note The maximum delta between returned calls is 1 second - however, RakNet calls this constantly anyway. See NormalizeTime() in the cpp. + RakNet::TimeMS RAK_DLL_EXPORT GetTimeMS( void ); + + /// Return the time as 64 bit + /// \note The maximum delta between returned calls is 1 second - however, RakNet calls this constantly anyway. See NormalizeTime() in the cpp. + RakNet::TimeUS RAK_DLL_EXPORT GetTimeUS( void ); + + /// a > b? + extern RAK_DLL_EXPORT bool GreaterThan(RakNet::Time a, RakNet::Time b); + /// a < b? + extern RAK_DLL_EXPORT bool LessThan(RakNet::Time a, RakNet::Time b); +} + +#endif diff --git a/include/raknet/Getche.hpp b/include/raknet/Getche.hpp new file mode 100644 index 0000000..af6c1c9 --- /dev/null +++ b/include/raknet/Getche.hpp @@ -0,0 +1,19 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#if defined(_WIN32) +#include /* getche() */ + +#else +#include +#include +#include +char getche(); +#endif diff --git a/include/raknet/Gets.hpp b/include/raknet/Gets.hpp new file mode 100644 index 0000000..bfe4d3d --- /dev/null +++ b/include/raknet/Gets.hpp @@ -0,0 +1,23 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __GETS__H_ +#define __GETS__H_ + +#ifdef __cplusplus +extern "C" { + +char * Gets ( char * str, int num ); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/raknet/GridSectorizer.hpp b/include/raknet/GridSectorizer.hpp new file mode 100644 index 0000000..f20f5ae --- /dev/null +++ b/include/raknet/GridSectorizer.hpp @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef _GRID_SECTORIZER_H +#define _GRID_SECTORIZER_H + +//#define _USE_ORDERED_LIST + +#include "RakMemoryOverride.hpp" + +#ifdef _USE_ORDERED_LIST +#include "DS_OrderedList.hpp" +#else +#include "DS_List.hpp" +#endif + +class GridSectorizer +{ +public: + GridSectorizer(); + ~GridSectorizer(); + + // _cellWidth, _cellHeight is the width and height of each cell in world units + // minX, minY, maxX, maxY are the world dimensions (can be changed to dynamically allocate later if needed) + void Init(const float _maxCellWidth, const float _maxCellHeight, const float minX, const float minY, const float maxX, const float maxY); + + // Adds a pointer to the grid with bounding rectangle dimensions + void AddEntry(void *entry, const float minX, const float minY, const float maxX, const float maxY); + +#ifdef _USE_ORDERED_LIST + + // Removes a pointer, as above + void RemoveEntry(void *entry, const float minX, const float minY, const float maxX, const float maxY); + + // Adds and removes in one pass, more efficient than calling both functions consecutively + void MoveEntry(void *entry, const float sourceMinX, const float sourceMinY, const float sourceMaxX, const float sourceMaxY, + const float destMinX, const float destMinY, const float destMaxX, const float destMaxY); + +#endif + + // Adds to intersectionList all entries in a certain radius + void GetEntries(DataStructures::List& intersectionList, const float minX, const float minY, const float maxX, const float maxY); + + void Clear(void); + +protected: + int WorldToCellX(const float input) const; + int WorldToCellY(const float input) const; + int WorldToCellXOffsetAndClamped(const float input) const; + int WorldToCellYOffsetAndClamped(const float input) const; + + // Returns true or false if a position crosses cells in the grid. If false, you don't need to move entries + bool PositionCrossesCells(const float originX, const float originY, const float destinationX, const float destinationY) const; + + float cellOriginX, cellOriginY; + float cellWidth, cellHeight; + float invCellWidth, invCellHeight; + float gridWidth, gridHeight; + int gridCellWidthCount, gridCellHeightCount; + + + // int gridWidth, gridHeight; + +#ifdef _USE_ORDERED_LIST + DataStructures::OrderedList* grid; +#else + DataStructures::List* grid; +#endif +}; + +#endif diff --git a/include/raknet/HTTPConnection.hpp b/include/raknet/HTTPConnection.hpp new file mode 100644 index 0000000..7dae877 --- /dev/null +++ b/include/raknet/HTTPConnection.hpp @@ -0,0 +1,175 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file HTTPConnection.h +/// \brief Contains HTTPConnection, used to communicate with web servers +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_HTTPConnection==1 && _RAKNET_SUPPORT_TCPInterface==1 + +#ifndef __HTTP_CONNECTION +#define __HTTP_CONNECTION + +#include "Export.hpp" +#include "RakString.hpp" +#include "RakMemoryOverride.hpp" +#include "RakNetTypes.hpp" +#include "DS_Queue.hpp" + +namespace RakNet +{ +/// Forward declarations +class TCPInterface; +struct SystemAddress; + +/// \brief Use HTTPConnection to communicate with a web server. +/// \details Start an instance of TCPInterface via the Start() command. +/// Instantiate a new instance of HTTPConnection, and associate TCPInterface with the class in the constructor. +/// Use Post() to send commands to the web server, and ProcessDataPacket() to update the connection with packets returned from TCPInterface that have the system address of the web server +/// This class will handle connecting and reconnecting as necessary. +/// +/// Note that only one Post() can be handled at a time. +/// \deprecated, use HTTPConnection2 +class RAK_DLL_EXPORT HTTPConnection +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(HTTPConnection) + + /// Returns a HTTP object associated with this tcp connection + HTTPConnection(); + virtual ~HTTPConnection(); + + /// \pre tcp should already be started + void Init(TCPInterface *_tcp, const char *host, unsigned short port=80); + + /// Submit data to the HTTP server + /// HTTP only allows one request at a time per connection + /// + /// \pre IsBusy()==false + /// \param path the path on the remote server you want to POST to. For example "index.html" + /// \param data A NULL terminated string to submit to the server + /// \param contentType "Content-Type:" passed to post. + void Post(const char *path, const char *data, const char *_contentType="application/x-www-form-urlencoded"); + + /// Get a file from a webserver + /// \param path the path on the remote server you want to GET from. For example "index.html" + void Get(const char *path); + + /// Is there a Read result ready? + bool HasRead(void) const; + + /// Get one result from the server + /// \pre HasResult must return true + RakNet::RakString Read(void); + + /// Call periodically to do time-based updates + void Update(void); + + /// Returns the address of the server we are connected to + SystemAddress GetServerAddress(void) const; + + /// Process an HTTP data packet returned from TCPInterface + /// Returns true when we have gotten all the data from the HTTP server. + /// If this returns true then it's safe to Post() another request + /// Deallocate the packet as usual via TCPInterface + /// \param packet NULL or a packet associated with our host and port + void ProcessTCPPacket(Packet *packet); + + /// Results of HTTP requests. Standard response codes are < 999 + /// ( define HTTP codes and our internal codes as needed ) + enum ResponseCodes { NoBody=1001, OK=200, Deleted=1002 }; + + HTTPConnection& operator=(const HTTPConnection& rhs){(void) rhs; return *this;} + + /// Encapsulates a raw HTTP response and response code + struct BadResponse + { + public: + BadResponse() {code=0;} + + BadResponse(const unsigned char *_data, int _code) + : data((const char *)_data), code(_code) {} + + BadResponse(const char *_data, int _code) + : data(_data), code(_code) {} + + operator int () const { return code; } + + RakNet::RakString data; + int code; // ResponseCodes + }; + + /// Queued events of failed exchanges with the HTTP server + bool HasBadResponse(int *code, RakNet::RakString *data); + + /// Returns false if the connection is not doing anything else + bool IsBusy(void) const; + + /// \internal + int GetState(void) const; + + struct OutgoingCommand + { + RakNet::RakString remotePath; + RakNet::RakString data; + RakNet::RakString contentType; + bool isPost; + }; + + DataStructures::Queue outgoingCommand; + OutgoingCommand currentProcessingCommand; + +private: + SystemAddress server; + TCPInterface *tcp; + RakNet::RakString host; + unsigned short port; + DataStructures::Queue badResponses; + + enum ConnectionState + { + CS_NONE, + CS_DISCONNECTING, + CS_CONNECTING, + CS_CONNECTED, + CS_PROCESSING, + } connectionState; + + RakNet::RakString incomingData; + DataStructures::Queue results; + + void CloseConnection(); + + /* + enum { RAK_HTTP_INITIAL, + RAK_HTTP_STARTING, + RAK_HTTP_CONNECTING, + RAK_HTTP_ESTABLISHED, + RAK_HTTP_REQUEST_SENT, + RAK_HTTP_IDLE } state; + + RakNet::RakString outgoing, incoming, path, contentType; + void Process(Packet *packet); // the workhorse + + // this helps check the various status lists in TCPInterface + typedef SystemAddress (TCPInterface::*StatusCheckFunction)(void); + bool InList(StatusCheckFunction func); + */ + +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/HTTPConnection2.hpp b/include/raknet/HTTPConnection2.hpp new file mode 100644 index 0000000..f03178e --- /dev/null +++ b/include/raknet/HTTPConnection2.hpp @@ -0,0 +1,124 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file HTTPConnection2.h +/// \brief Contains HTTPConnection2, used to communicate with web servers +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_HTTPConnection2==1 && _RAKNET_SUPPORT_TCPInterface==1 + +#ifndef __HTTP_CONNECTION_2 +#define __HTTP_CONNECTION_2 + +#include "Export.hpp" +#include "RakString.hpp" +#include "RakMemoryOverride.hpp" +#include "RakNetTypes.hpp" +#include "DS_List.hpp" +#include "DS_Queue.hpp" +#include "PluginInterface2.hpp" +#include "SimpleMutex.hpp" + +namespace RakNet +{ +/// Forward declarations +class TCPInterface; +struct SystemAddress; + +/// \brief Use HTTPConnection2 to communicate with a web server. +/// \details Start an instance of TCPInterface via the Start() command. +/// This class will handle connecting to transmit a request +class RAK_DLL_EXPORT HTTPConnection2 : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(HTTPConnection2) + + HTTPConnection2(); + virtual ~HTTPConnection2(); + + /// \brief Connect to, then transmit a request to a TCP based server + /// \param[in] tcp An instance of TCPInterface that previously had TCPInterface::Start() called + /// \param[in] stringToTransmit What string to transmit. See RakString::FormatForPOST(), RakString::FormatForGET(), RakString::FormatForDELETE() + /// \param[in] host The IP address to connect to + /// \param[in] port The port to connect to + /// \param[in] useSSL If to use SSL to connect. OPEN_SSL_CLIENT_SUPPORT must be defined to 1 in RakNetDefines.h or RakNetDefinesOverrides.h + /// \param[in] ipVersion 4 for IPV4, 6 for IPV6 + /// \param[in] useAddress Assume we are connected to this address and send to it, rather than do a lookup + /// \param[in] userData + /// \return false if host is not a valid IP address or domain name + bool TransmitRequest(const char* stringToTransmit, const char* host, unsigned short port=80, bool useSSL=false, int ipVersion=4, SystemAddress useAddress=UNASSIGNED_SYSTEM_ADDRESS, void *userData=0); + + /// \brief Check for and return a response from a prior call to TransmitRequest() + /// As TCP is stream based, you may get a webserver reply over several calls to TCPInterface::Receive() + /// HTTPConnection2 will store Packet::data and return the response to you either when the connection to the webserver is lost, or enough data has been received() + /// This will only potentially return true after a call to ProcessTCPPacket() or OnLostConnection() + /// \param[out] stringTransmitted The original string transmitted + /// \param[out] hostTransmitted The parameter of the same name passed to TransmitRequest() + /// \param[out] responseReceived The response, if any + /// \param[out] hostReceived The SystemAddress from ProcessTCPPacket() or OnLostConnection() + /// \param[out] contentOffset The offset from the start of responseReceived to the data body. Equivalent to searching for \r\n\r\n in responseReceived. + /// \param[out] userData Whatever you passed to TransmitRequest + /// \return true if there was a response. false if not. + bool GetResponse( RakString &stringTransmitted, RakString &hostTransmitted, RakString &responseReceived, SystemAddress &hostReceived, int &contentOffset, void **userData ); + bool GetResponse( RakString &stringTransmitted, RakString &hostTransmitted, RakString &responseReceived, SystemAddress &hostReceived, int &contentOffset ); + + /// \brief Return if any requests are pending + bool IsBusy(void) const; + + /// \brief Return if any requests are waiting to be read by the user + bool HasResponse(void) const; + + struct Request + { + RakString stringToTransmit; + RakString stringReceived; + RakString host; + SystemAddress hostEstimatedAddress; + SystemAddress hostCompletedAddress; + unsigned short port; + bool useSSL; + int contentOffset; + int contentLength; + int ipVersion; + void *userData; + bool chunked; + size_t thisChunkSize; + size_t bytesReadForThisChunk; + }; + + /// \internal + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + virtual void OnFailedConnectionAttempt(Packet *packet, PI2_FailedConnectionAttemptReason failedConnectionAttemptReason); + +protected: + + bool IsConnected(SystemAddress sa); + void SendRequest(Request *request); + void RemovePendingRequest(SystemAddress sa); + void SendNextPendingRequest(void); + void SendPendingRequestToConnectedSystem(SystemAddress sa); + + DataStructures::Queue pendingRequests; + DataStructures::List sentRequests; + DataStructures::List completedRequests; + + SimpleMutex pendingRequestsMutex, sentRequestsMutex, completedRequestsMutex; + +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/IncrementalReadInterface.hpp b/include/raknet/IncrementalReadInterface.hpp new file mode 100644 index 0000000..ba9a9e4 --- /dev/null +++ b/include/raknet/IncrementalReadInterface.hpp @@ -0,0 +1,38 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __INCREMENTAL_READ_INTERFACE_H +#define __INCREMENTAL_READ_INTERFACE_H + +#include "FileListNodeContext.hpp" +#include "Export.hpp" + +namespace RakNet +{ + +class RAK_DLL_EXPORT IncrementalReadInterface +{ +public: + IncrementalReadInterface() {} + virtual ~IncrementalReadInterface() {} + + /// Read part of a file into \a destination + /// Return the number of bytes written. Return 0 when file is done. + /// \param[in] filename Filename to read + /// \param[in] startReadBytes What offset from the start of the file to read from + /// \param[in] numBytesToRead How many bytes to read. This is also how many bytes have been allocated to preallocatedDestination + /// \param[out] preallocatedDestination Write your data here + /// \return The number of bytes read, or 0 if none + virtual unsigned int GetFilePart( const char *filename, unsigned int startReadBytes, unsigned int numBytesToRead, void *preallocatedDestination, FileListNodeContext context); +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/InternalPacket.hpp b/include/raknet/InternalPacket.hpp new file mode 100644 index 0000000..e6ae67a --- /dev/null +++ b/include/raknet/InternalPacket.hpp @@ -0,0 +1,130 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] A class which stores a user message, and all information associated with sending and receiving that message. +/// + +#ifndef __INTERNAL_PACKET_H +#define __INTERNAL_PACKET_H + +#include "PacketPriority.hpp" +#include "RakNetTypes.hpp" +#include "RakMemoryOverride.hpp" +#include "RakNetDefines.hpp" +#include "NativeTypes.hpp" +#include "RakNetDefines.hpp" +#if USE_SLIDING_WINDOW_CONGESTION_CONTROL!=1 +#include "CCRakNetUDT.hpp" +#else +#include "CCRakNetSlidingWindow.hpp" +#endif + +namespace RakNet { + +typedef uint16_t SplitPacketIdType; +typedef uint32_t SplitPacketIndexType; + +/// This is the counter used for holding packet numbers, so we can detect duplicate packets. It should be large enough that if the variables +/// Internally assumed to be 4 bytes, but written as 3 bytes in ReliabilityLayer::WriteToBitStreamFromInternalPacket +typedef uint24_t MessageNumberType; + +/// This is the counter used for holding ordered packet numbers, so we can detect out-of-order packets. It should be large enough that if the variables +/// were to wrap, the newly wrapped values would no longer be in use. Warning: Too large of a value wastes bandwidth! +typedef MessageNumberType OrderingIndexType; + +typedef RakNet::TimeUS RemoteSystemTimeType; + +struct InternalPacketFixedSizeTransmissionHeader +{ + /// A unique numerical identifier given to this user message. Used to identify reliable messages on the network + MessageNumberType reliableMessageNumber; + ///The ID used as identification for ordering messages. Also included in sequenced messages + OrderingIndexType orderingIndex; + // Used only with sequenced messages + OrderingIndexType sequencingIndex; + ///What ordering channel this packet is on, if the reliability type uses ordering channels + unsigned char orderingChannel; + ///The ID of the split packet, if we have split packets. This is the maximum number of split messages we can send simultaneously per connection. + SplitPacketIdType splitPacketId; + ///If this is a split packet, the index into the array of subsplit packets + SplitPacketIndexType splitPacketIndex; + ///The size of the array of subsplit packets + SplitPacketIndexType splitPacketCount;; + ///How many bits long the data is + BitSize_t dataBitLength; + ///What type of reliability algorithm to use with this packet + PacketReliability reliability; + // Not endian safe + // unsigned char priority : 3; + // unsigned char reliability : 5; +}; + +/// Used in InternalPacket when pointing to sharedDataBlock, rather than allocating itself +struct InternalPacketRefCountedData +{ + unsigned char *sharedDataBlock; + unsigned int refCount; +}; + +/// Holds a user message, and related information +/// Don't use a constructor or destructor, due to the memory pool I am using +struct InternalPacket : public InternalPacketFixedSizeTransmissionHeader +{ + /// Identifies the order in which this number was sent. Used locally + MessageNumberType messageInternalOrder; + /// Has this message number been assigned yet? We don't assign until the message is actually sent. + /// This fixes a bug where pre-determining message numbers and then sending a message on a different channel creates a huge gap. + /// This causes performance problems and causes those messages to timeout. + bool messageNumberAssigned; + /// Was this packet number used this update to track windowing drops or increases? Each packet number is only used once per update. +// bool allowWindowUpdate; + ///When this packet was created + RakNet::TimeUS creationTime; + ///The resendNext time to take action on this packet + RakNet::TimeUS nextActionTime; + // For debugging + RakNet::TimeUS retransmissionTime; + // Size of the header when encoded into a bitstream + BitSize_t headerLength; + /// Buffer is a pointer to the actual data, assuming this packet has data at all + unsigned char *data; + /// How to alloc and delete the data member + enum AllocationScheme + { + /// Data is allocated using rakMalloc. Just free it + NORMAL, + + /// data points to a larger block of data, where the larger block is reference counted. internalPacketRefCountedData is used in this case + REF_COUNTED, + + /// If allocation scheme is STACK, data points to stackData and should not be deallocated + /// This is only used when sending. Received packets are deallocated in RakPeer + STACK + } allocationScheme; + InternalPacketRefCountedData *refCountedData; + /// How many attempts we made at sending this message + unsigned char timesSent; + /// The priority level of this packet + PacketPriority priority; + /// If the reliability type requires a receipt, then return this number with it + uint32_t sendReceiptSerial; + + // Used for the resend queue + // Linked list implementation so I can remove from the list via a pointer, without finding it in the list + InternalPacket *resendPrev, *resendNext,*unreliablePrev,*unreliableNext; + + unsigned char stackData[128]; +}; + +} // namespace RakNet + +#endif + diff --git a/include/raknet/Itoa.hpp b/include/raknet/Itoa.hpp new file mode 100644 index 0000000..31f9773 --- /dev/null +++ b/include/raknet/Itoa.hpp @@ -0,0 +1,25 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAK_ITOA_H +#define __RAK_ITOA_H + +#ifdef __cplusplus +extern "C" { +#endif + +char* Itoa( int value, char* result, int base ); + +#ifdef __cplusplus +} +#endif + + +#endif diff --git a/include/raknet/Kbhit.hpp b/include/raknet/Kbhit.hpp new file mode 100644 index 0000000..44ffe4e --- /dev/null +++ b/include/raknet/Kbhit.hpp @@ -0,0 +1,84 @@ +/***************************************************************************** +kbhit() and getch() for Linux/UNIX +Chris Giese http://my.execpc.com/~geezer +Release date: ? +This code is public domain (no copyright). +You can do whatever you want with it. +*****************************************************************************/ +#if defined(_WIN32) +#include /* kbhit(), getch() */ + +#else +#include /* struct timeval, select() */ +/* ICANON, ECHO, TCSANOW, struct termios */ +#include /* tcgetattr(), tcsetattr() */ +#include /* atexit(), exit() */ +#include /* read() */ +#include /* printf() */ +#include /* memcpy */ + +static struct termios g_old_kbd_mode; +/***************************************************************************** +*****************************************************************************/ +static void cooked(void) +{ + tcsetattr(0, TCSANOW, &g_old_kbd_mode); +} +/***************************************************************************** +*****************************************************************************/ +static void raw(void) +{ + static char init; +/**/ + struct termios new_kbd_mode; + + if(init) + return; +/* put keyboard (stdin, actually) in raw, unbuffered mode */ + tcgetattr(0, &g_old_kbd_mode); + memcpy(&new_kbd_mode, &g_old_kbd_mode, sizeof(struct termios)); + new_kbd_mode.c_lflag &= ~(ICANON /*| ECHO */ ); + new_kbd_mode.c_cc[VTIME] = 0; + new_kbd_mode.c_cc[VMIN] = 1; + tcsetattr(0, TCSANOW, &new_kbd_mode); +/* when we exit, go back to normal, "cooked" mode */ + atexit(cooked); + + init = 1; +} +/***************************************************************************** +*****************************************************************************/ +static int kbhit(void) +{ + struct timeval timeout; + fd_set read_handles; + int status; + + raw(); +/* check stdin (fd 0) for activity */ + FD_ZERO(&read_handles); + FD_SET(0, &read_handles); + timeout.tv_sec = timeout.tv_usec = 0; + status = select(0 + 1, &read_handles, NULL, NULL, &timeout); + if(status < 0) + { + printf("select() failed in kbhit()\n"); + exit(1); + } + return status; +} +/***************************************************************************** +*****************************************************************************/ +static int getch(void) +{ + unsigned char temp; + + raw(); +/* stdin = fd 0 */ + if(read(0, &temp, 1) != 1) + return 0; + return temp; +} +#endif + + diff --git a/include/raknet/LinuxStrings.hpp b/include/raknet/LinuxStrings.hpp new file mode 100644 index 0000000..67f9829 --- /dev/null +++ b/include/raknet/LinuxStrings.hpp @@ -0,0 +1,40 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef _GCC_WIN_STRINGS +#define _GCC_WIN_STRINGS + +#if defined(__native_client__) + #ifndef _stricmp + int _stricmp(const char* s1, const char* s2); + #endif + int _strnicmp(const char* s1, const char* s2, size_t n); + char *_strlwr(char * str ); + #define _vsnprintf vsnprintf +#else + #if (defined(__GNUC__) || defined(__GCCXML__) || defined(__S3E__) ) && !defined(_WIN32) + #ifndef _stricmp + int _stricmp(const char* s1, const char* s2); + #endif + int _strnicmp(const char* s1, const char* s2, size_t n); + // http://www.jenkinssoftware.com/forum/index.php?topic=5010.msg20920#msg20920 + // #ifndef _vsnprintf + #define _vsnprintf vsnprintf + // #endif +#ifndef __APPLE__ + char *_strlwr(char * str ); //this won't compile on OSX for some reason +#endif + + + + #endif +#endif + +#endif // _GCC_WIN_STRINGS diff --git a/include/raknet/LocklessTypes.hpp b/include/raknet/LocklessTypes.hpp new file mode 100644 index 0000000..4b8104c --- /dev/null +++ b/include/raknet/LocklessTypes.hpp @@ -0,0 +1,50 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __LOCKLESS_TYPES_H +#define __LOCKLESS_TYPES_H + +#include "Export.hpp" +#include "NativeTypes.hpp" +#include "WindowsIncludes.hpp" +#if defined(ANDROID) || defined(__S3E__) || defined(__APPLE__) +// __sync_fetch_and_add not supported apparently +#include "SimpleMutex.hpp" +#endif + +namespace RakNet +{ + +class RAK_DLL_EXPORT LocklessUint32_t +{ +public: + LocklessUint32_t(); + explicit LocklessUint32_t(uint32_t initial); + // Returns variable value after changing it + uint32_t Increment(void); + // Returns variable value after changing it + uint32_t Decrement(void); + uint32_t GetValue(void) const {return value;} + +protected: +#ifdef _WIN32 + volatile LONG value; +#elif defined(ANDROID) || defined(__S3E__) || defined(__APPLE__) + // __sync_fetch_and_add not supported apparently + SimpleMutex mutex; + uint32_t value; +#else + volatile uint32_t value; +#endif +}; + +} + +#endif diff --git a/include/raknet/LogCommandParser.hpp b/include/raknet/LogCommandParser.hpp new file mode 100644 index 0000000..3239be4 --- /dev/null +++ b/include/raknet/LogCommandParser.hpp @@ -0,0 +1,127 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains LogCommandParser , Used to send logs to connected consoles +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_LogCommandParser==1 + +#ifndef __LOG_COMMAND_PARSER +#define __LOG_COMMAND_PARSER + +#include "CommandParserInterface.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \brief Adds the ability to send logging output to a remote console +class RAK_DLL_EXPORT LogCommandParser : public CommandParserInterface +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(LogCommandParser) + + LogCommandParser(); + ~LogCommandParser(); + + /// Given \a command with parameters \a parameterList , do whatever processing you wish. + /// \param[in] command The command to process + /// \param[in] numParameters How many parameters were passed along with the command + /// \param[in] parameterList The list of parameters. parameterList[0] is the first parameter and so on. + /// \param[in] transport The transport interface we can use to write to + /// \param[in] systemAddress The player that sent this command. + /// \param[in] originalString The string that was actually sent over the network, in case you want to do your own parsing + bool OnCommand(const char *command, unsigned numParameters, char **parameterList, TransportInterface *transport, const SystemAddress &systemAddress, const char *originalString); + + /// You are responsible for overriding this function and returning a static string, which will identifier your parser. + /// This should return a static string + /// \return The name that you return. + const char *GetName(void) const; + + /// A callback for when you are expected to send a brief description of your parser to \a systemAddress + /// \param[in] transport The transport interface we can use to write to + /// \param[in] systemAddress The player that requested help. + void SendHelp(TransportInterface *transport, const SystemAddress &systemAddress); + + /// All logs must be associated with a channel. This is a filter so that remote clients only get logs for a system they care about. + // If you call Log with a channel that is unknown, that channel will automatically be added + /// \param[in] channelName A persistent string naming the channel. Don't deallocate this string. + void AddChannel(const char *channelName); + + /// Write a log to a channel. + /// Logs are not buffered, so only remote consoles connected and subscribing at the time you write will get the output. + /// \param[in] format Same as RAKNET_DEBUG_PRINTF() + /// \param[in] ... Same as RAKNET_DEBUG_PRINTF() + void WriteLog(const char *channelName, const char *format, ...); + + /// A callback for when \a systemAddress has connected to us. + /// \param[in] systemAddress The player that has connected. + /// \param[in] transport The transport interface that sent us this information. Can be used to send messages to this or other players. + void OnNewIncomingConnection(const SystemAddress &systemAddress, TransportInterface *transport); + + /// A callback for when \a systemAddress has disconnected, either gracefully or forcefully + /// \param[in] systemAddress The player that has disconnected. + /// \param[in] transport The transport interface that sent us this information. + void OnConnectionLost(const SystemAddress &systemAddress, TransportInterface *transport); + + /// This is called every time transport interface is registered. If you want to save a copy of the TransportInterface pointer + /// This is the place to do it + /// \param[in] transport The new TransportInterface + void OnTransportChange(TransportInterface *transport); +protected: + /// Sends the currently active channels to the user + /// \param[in] systemAddress The player to send to + /// \param[in] transport The transport interface to use to send the channels + void PrintChannels(const SystemAddress &systemAddress, TransportInterface *transport) const; + + /// Unsubscribe a user from a channel (or from all channels) + /// \param[in] systemAddress The player to unsubscribe to + /// \param[in] channelName If 0, then unsubscribe from all channels. Otherwise unsubscribe from the named channel + unsigned Unsubscribe(const SystemAddress &systemAddress, const char *channelName); + + /// Subscribe a user to a channel (or to all channels) + /// \param[in] systemAddress The player to subscribe to + /// \param[in] channelName If 0, then subscribe from all channels. Otherwise subscribe to the named channel + unsigned Subscribe(const SystemAddress &systemAddress, const char *channelName); + + /// Given the name of a channel, return the index into channelNames where it is located + /// \param[in] channelName The name of the channel + unsigned GetChannelIndexFromName(const char *channelName); + + /// One of these structures is created per player + struct SystemAddressAndChannel + { + /// The ID of the player + SystemAddress systemAddress; + + /// Bitwise representations of the channels subscribed to. If bit 0 is set, then we subscribe to channelNames[0] and so on. + unsigned channels; + }; + + /// The list of remote users. Added to when users subscribe, removed when they disconnect or unsubscribe + DataStructures::List remoteUsers; + + /// Names of the channels at each bit, or 0 for an unused channel + const char *channelNames[32]; + + /// This is so I can save the current transport provider, solely so I can use it without having the user pass it to Log + TransportInterface *trans; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/MTUSize.hpp b/include/raknet/MTUSize.hpp new file mode 100644 index 0000000..a63ffa6 --- /dev/null +++ b/include/raknet/MTUSize.hpp @@ -0,0 +1,38 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] Defines the default maximum transfer unit. +/// + + +#ifndef MAXIMUM_MTU_SIZE + +/// \li \em 17914 16 Mbit/Sec Token Ring +/// \li \em 4464 4 Mbits/Sec Token Ring +/// \li \em 4352 FDDI +/// \li \em 1500. The largest Ethernet packet size \b recommended. This is the typical setting for non-PPPoE, non-VPN connections. The default value for NETGEAR routers, adapters and switches. +/// \li \em 1492. The size PPPoE prefers. +/// \li \em 1472. Maximum size to use for pinging. (Bigger packets are fragmented.) +/// \li \em 1468. The size DHCP prefers. +/// \li \em 1460. Usable by AOL if you don't have large email attachments, etc. +/// \li \em 1430. The size VPN and PPTP prefer. +/// \li \em 1400. Maximum size for AOL DSL. +/// \li \em 576. Typical value to connect to dial-up ISPs. +/// The largest value for an UDP datagram + + + +#define MAXIMUM_MTU_SIZE 1492 + + +#define MINIMUM_MTU_SIZE 400 + +#endif diff --git a/include/raknet/MessageFilter.hpp b/include/raknet/MessageFilter.hpp new file mode 100644 index 0000000..4a1eeb7 --- /dev/null +++ b/include/raknet/MessageFilter.hpp @@ -0,0 +1,198 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Message filter plugin. Assigns systems to FilterSets. Each FilterSet limits what messages are allowed. This is a security related plugin. +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_MessageFilter==1 + +#ifndef __MESSAGE_FILTER_PLUGIN_H +#define __MESSAGE_FILTER_PLUGIN_H + +#include "RakNetTypes.hpp" +#include "PluginInterface2.hpp" +#include "DS_OrderedList.hpp" +#include "DS_Hash.hpp" +#include "Export.hpp" + +/// MessageIdentifier (ID_*) values shoudln't go higher than this. Change it if you do. +#define MESSAGE_FILTER_MAX_MESSAGE_ID 256 + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \internal Has to be public so some of the shittier compilers can use it. +int RAK_DLL_EXPORT MessageFilterStrComp( char *const &key,char *const &data ); + +/// \internal Has to be public so some of the shittier compilers can use it. +struct FilterSet +{ + bool banOnFilterTimeExceed; + bool kickOnDisallowedMessage; + bool banOnDisallowedMessage; + RakNet::TimeMS disallowedMessageBanTimeMS; + RakNet::TimeMS timeExceedBanTimeMS; + RakNet::TimeMS maxMemberTimeMS; + void (*invalidMessageCallback)(RakPeerInterface *peer, AddressOrGUID systemAddress, int filterSetID, void *userData, unsigned char messageID); + void *disallowedCallbackUserData; + void (*timeoutCallback)(RakPeerInterface *peer, AddressOrGUID systemAddress, int filterSetID, void *userData); + void *timeoutUserData; + int filterSetID; + bool allowedIDs[MESSAGE_FILTER_MAX_MESSAGE_ID]; + DataStructures::OrderedList allowedRPC4; +}; + +/// \internal Has to be public so some of the shittier compilers can use it. +int RAK_DLL_EXPORT FilterSetComp( const int &key, FilterSet * const &data ); + +/// \internal Has to be public so some of the shittier compilers can use it. +struct FilteredSystem +{ + FilterSet *filter; + RakNet::TimeMS timeEnteredThisSet; +}; + +/// \defgroup MESSAGEFILTER_GROUP MessageFilter +/// \brief Remote incoming packets from unauthorized systems +/// \details +/// \ingroup PLUGINS_GROUP + +/// \brief Assigns systems to FilterSets. Each FilterSet limits what kinds of messages are allowed. +/// \details The MessageFilter plugin is used for security where you limit what systems can send what kind of messages.
+/// You implicitly define FilterSets, and add allowed message IDs to these FilterSets.
+/// You then add systems to these filters, such that those systems are limited to sending what the filters allows.
+/// You can automatically assign systems to a filter.
+/// You can automatically kick and possibly ban users that stay in a filter too long, or send the wrong message.
+/// Each system is a member of either zero or one filters.
+/// Add this plugin before any plugin you wish to filter (most likely just add this plugin before any other). +/// \ingroup MESSAGEFILTER_GROUP +class RAK_DLL_EXPORT MessageFilter : public PluginInterface2 +{ +public: + + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(MessageFilter) + + MessageFilter(); + virtual ~MessageFilter(); + + // -------------------------------------------------------------------------------------------- + // User functions + // -------------------------------------------------------------------------------------------- + + /// Automatically add all new systems to a particular filter + /// Defaults to -1 + /// \param[in] filterSetID Which filter to add new systems to. <0 for do not add. + void SetAutoAddNewConnectionsToFilter(int filterSetID); + + /// Allow a range of message IDs + /// Always allowed by default: ID_CONNECTION_REQUEST_ACCEPTED through ID_DOWNLOAD_PROGRESS + /// Usually you specify a range to make it easier to add new enumerations without having to constantly refer back to this function. + /// \param[in] allow True to allow this message ID, false to disallow. By default, all messageIDs except the noted types are disallowed. This includes messages from other plugins! + /// \param[in] messageIDStart The first ID_* message to allow in the range. Inclusive. + /// \param[in] messageIDEnd The last ID_* message to allow in the range. Inclusive. + /// \param[in] filterSetID A user defined ID to represent a filter set. If no filter with this ID exists, one will be created with default settings. + void SetAllowMessageID(bool allow, int messageIDStart, int messageIDEnd,int filterSetID); + + /// Allow a specific RPC4 call + /// \pre MessageFilter must be attached before RPC4 + /// \param[in] uniqueID Identifier passed to RegisterFunction() + /// \param[in] filterSetID A user defined ID to represent a filter set. If no filter with this ID exists, one will be created with default settings. + void SetAllowRPC4(bool allow, const char* uniqueID, int filterSetID); + + /// What action to take on a disallowed message. You can kick or not. You can add them to the ban list for some time + /// By default no action is taken. The message is simply ignored. + /// param[in] 0 for permanent ban, >0 for ban time in milliseconds. + /// \param[in] kickOnDisallowed kick the system that sent a disallowed message. + /// \param[in] banOnDisallowed ban the system that sent a disallowed message. See \a banTimeMS for the ban duration + /// \param[in] banTimeMS Passed to the milliseconds parameter of RakPeer::AddToBanList. + /// \param[in] filterSetID A user defined ID to represent a filter set. If no filter with this ID exists, one will be created with default settings. + void SetActionOnDisallowedMessage(bool kickOnDisallowed, bool banOnDisallowed, RakNet::TimeMS banTimeMS, int filterSetID); + + /// Set a user callback to be called on an invalid message for a particular filterSet + /// \param[in] filterSetID A user defined ID to represent a filter set. If no filter with this ID exists, one will be created with default settings. + /// \param[in] userData A pointer passed with the callback + /// \param[in] invalidMessageCallback A pointer to a C function to be called back with the specified parameters. + void SetDisallowedMessageCallback(int filterSetID, void *userData, void (*invalidMessageCallback)(RakPeerInterface *peer, AddressOrGUID addressOrGUID, int filterSetID, void *userData, unsigned char messageID)); + + /// Set a user callback to be called when a user is disconnected due to SetFilterMaxTime + /// \param[in] filterSetID A user defined ID to represent a filter set. If no filter with this ID exists, one will be created with default settings. + /// \param[in] userData A pointer passed with the callback + /// \param[in] invalidMessageCallback A pointer to a C function to be called back with the specified parameters. + void SetTimeoutCallback(int filterSetID, void *userData, void (*invalidMessageCallback)(RakPeerInterface *peer, AddressOrGUID addressOrGUID, int filterSetID, void *userData)); + + /// Limit how long a connection can stay in a particular filterSetID. After this time, the connection is kicked and possibly banned. + /// By default there is no limit to how long a connection can stay in a particular filter set. + /// \param[in] allowedTimeMS How many milliseconds to allow a connection to stay in this filter set. + /// \param[in] banOnExceed True or false to ban the system, or not, when \a allowedTimeMS is exceeded + /// \param[in] banTimeMS Passed to the milliseconds parameter of RakPeer::AddToBanList. + /// \param[in] filterSetID A user defined ID to represent a filter set. If no filter with this ID exists, one will be created with default settings. + void SetFilterMaxTime(int allowedTimeMS, bool banOnExceed, RakNet::TimeMS banTimeMS, int filterSetID); + + /// Get the filterSetID a system is using. Returns -1 for none. + /// \param[in] addressOrGUID The system we are referring to + int GetSystemFilterSet(AddressOrGUID addressOrGUID); + + /// Assign a system to a filter set. + /// Systems are automatically added to filter sets (or not) based on SetAutoAddNewConnectionsToFilter() + /// This function is used to change the filter set a system is using, to add it to a new filter set, or to remove it from all existin filter sets. + /// \param[in] addressOrGUID The system we are referring to + /// \param[in] filterSetID A user defined ID to represent a filter set. If no filter with this ID exists, one will be created with default settings. If -1, the system will be removed from all filter sets. + void SetSystemFilterSet(AddressOrGUID addressOrGUID, int filterSetID); + + /// Returns the number of systems subscribed to a particular filter set + /// Using anything other than -1 for \a filterSetID is slow, so you should store the returned value. + /// \param[in] filterSetID The filter set to limit to. Use -1 for none (just returns the total number of filter systems in that case). + unsigned GetSystemCount(int filterSetID) const; + + /// Returns the total number of filter sets. + /// \return The total number of filter sets. + unsigned GetFilterSetCount(void) const; + + /// Returns the ID of a filter set, by index + /// \param[in] An index between 0 and GetFilterSetCount()-1 inclusive + int GetFilterSetIDByIndex(unsigned index); + + /// Delete a FilterSet. All systems formerly subscribed to this filter are now unrestricted. + /// \param[in] filterSetID The ID of the filter set to delete. + void DeleteFilterSet(int filterSetID); + + // -------------------------------------------------------------------------------------------- + // Packet handling functions + // -------------------------------------------------------------------------------------------- + virtual void Update(void); + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + +protected: + + void Clear(void); + void DeallocateFilterSet(FilterSet *filterSet); + FilterSet* GetFilterSetByID(int filterSetID); + void OnInvalidMessage(FilterSet *filterSet, AddressOrGUID systemAddress, unsigned char messageID); + + DataStructures::OrderedList filterList; + // Change to guid + DataStructures::Hash systemList; + + int autoAddNewConnectionsToFilter; + RakNet::Time whenLastTimeoutCheck; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/MessageIdentifiers.hpp b/include/raknet/MessageIdentifiers.hpp new file mode 100644 index 0000000..67c21ea --- /dev/null +++ b/include/raknet/MessageIdentifiers.hpp @@ -0,0 +1,437 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief All the message identifiers used by RakNet. Message identifiers comprise the first byte of any message. +/// + + +#ifndef __MESSAGE_IDENTIFIERS_H +#define __MESSAGE_IDENTIFIERS_H + +#if defined(RAKNET_USE_CUSTOM_PACKET_IDS) +#include "CustomPacketIdentifiers.hpp" +#else + +enum OutOfBandIdentifiers +{ + ID_NAT_ESTABLISH_UNIDIRECTIONAL, + ID_NAT_ESTABLISH_BIDIRECTIONAL, + ID_NAT_TYPE_DETECT, + ID_ROUTER_2_REPLY_TO_SENDER_PORT, + ID_ROUTER_2_REPLY_TO_SPECIFIED_PORT, + ID_ROUTER_2_MINI_PUNCH_REPLY, + ID_ROUTER_2_MINI_PUNCH_REPLY_BOUNCE, + ID_XBOX_360_VOICE, + ID_XBOX_360_GET_NETWORK_ROOM, + ID_XBOX_360_RETURN_NETWORK_ROOM, + ID_NAT_PING, + ID_NAT_PONG, +}; + +/// You should not edit the file MessageIdentifiers.h as it is a part of RakNet static library +/// To define your own message id, define an enum following the code example that follows. +/// +/// \code +/// enum { +/// ID_MYPROJECT_MSG_1 = ID_USER_PACKET_ENUM, +/// ID_MYPROJECT_MSG_2, +/// ... +/// }; +/// \endcode +/// +/// \note All these enumerations should be casted to (unsigned char) before writing them to RakNet::BitStream +enum DefaultMessageIDTypes +{ + // + // RESERVED TYPES - DO NOT CHANGE THESE + // All types from RakPeer + // + /// These types are never returned to the user. + /// Ping from a connected system. Update timestamps (internal use only) + ID_CONNECTED_PING, + /// Ping from an unconnected system. Reply but do not update timestamps. (internal use only) + ID_UNCONNECTED_PING, + /// Ping from an unconnected system. Only reply if we have open connections. Do not update timestamps. (internal use only) + ID_UNCONNECTED_PING_OPEN_CONNECTIONS, + /// Pong from a connected system. Update timestamps (internal use only) + ID_CONNECTED_PONG, + /// A reliable packet to detect lost connections (internal use only) + ID_DETECT_LOST_CONNECTIONS, + /// C2S: Initial query: Header(1), OfflineMesageID(16), Protocol number(1), Pad(toMTU), sent with no fragment set. + /// If protocol fails on server, returns ID_INCOMPATIBLE_PROTOCOL_VERSION to client + ID_OPEN_CONNECTION_REQUEST_1, + /// S2C: Header(1), OfflineMesageID(16), server GUID(8), HasSecurity(1), Cookie(4, if HasSecurity) + /// , public key (if do security is true), MTU(2). If public key fails on client, returns ID_PUBLIC_KEY_MISMATCH + ID_OPEN_CONNECTION_REPLY_1, + /// C2S: Header(1), OfflineMesageID(16), Cookie(4, if HasSecurity is true on the server), clientSupportsSecurity(1 bit), + /// handshakeChallenge (if has security on both server and client), remoteBindingAddress(6), MTU(2), client GUID(8) + /// Connection slot allocated if cookie is valid, server is not full, GUID and IP not already in use. + ID_OPEN_CONNECTION_REQUEST_2, + /// S2C: Header(1), OfflineMesageID(16), server GUID(8), mtu(2), doSecurity(1 bit), handshakeAnswer (if do security is true) + ID_OPEN_CONNECTION_REPLY_2, + /// C2S: Header(1), GUID(8), Timestamp, HasSecurity(1), Proof(32) + ID_CONNECTION_REQUEST, + /// RakPeer - Remote system requires secure connections, pass a public key to RakPeerInterface::Connect() + ID_REMOTE_SYSTEM_REQUIRES_PUBLIC_KEY, + /// RakPeer - We passed a public key to RakPeerInterface::Connect(), but the other system did not have security turned on + ID_OUR_SYSTEM_REQUIRES_SECURITY, + /// RakPeer - Wrong public key passed to RakPeerInterface::Connect() + ID_PUBLIC_KEY_MISMATCH, + /// RakPeer - Same as ID_ADVERTISE_SYSTEM, but intended for internal use rather than being passed to the user. + /// Second byte indicates type. Used currently for NAT punchthrough for receiver port advertisement. See ID_NAT_ADVERTISE_RECIPIENT_PORT + ID_OUT_OF_BAND_INTERNAL, + /// If RakPeerInterface::Send() is called where PacketReliability contains _WITH_ACK_RECEIPT, then on a later call to + /// RakPeerInterface::Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS. The message will be 5 bytes long, + /// and bytes 1-4 inclusive will contain a number in native order containing a number that identifies this message. + /// This number will be returned by RakPeerInterface::Send() or RakPeerInterface::SendList(). ID_SND_RECEIPT_ACKED means that + /// the message arrived + ID_SND_RECEIPT_ACKED, + /// If RakPeerInterface::Send() is called where PacketReliability contains UNRELIABLE_WITH_ACK_RECEIPT, then on a later call to + /// RakPeerInterface::Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS. The message will be 5 bytes long, + /// and bytes 1-4 inclusive will contain a number in native order containing a number that identifies this message. This number + /// will be returned by RakPeerInterface::Send() or RakPeerInterface::SendList(). ID_SND_RECEIPT_LOSS means that an ack for the + /// message did not arrive (it may or may not have been delivered, probably not). On disconnect or shutdown, you will not get + /// ID_SND_RECEIPT_LOSS for unsent messages, you should consider those messages as all lost. + ID_SND_RECEIPT_LOSS, + + + // + // USER TYPES - DO NOT CHANGE THESE + // + + /// RakPeer - In a client/server environment, our connection request to the server has been accepted. + ID_CONNECTION_REQUEST_ACCEPTED, + /// RakPeer - Sent to the player when a connection request cannot be completed due to inability to connect. + ID_CONNECTION_ATTEMPT_FAILED, + /// RakPeer - Sent a connect request to a system we are currently connected to. + ID_ALREADY_CONNECTED, + /// RakPeer - A remote system has successfully connected. + ID_NEW_INCOMING_CONNECTION, + /// RakPeer - The system we attempted to connect to is not accepting new connections. + ID_NO_FREE_INCOMING_CONNECTIONS, + /// RakPeer - The system specified in Packet::systemAddress has disconnected from us. For the client, this would mean the + /// server has shutdown. + ID_DISCONNECTION_NOTIFICATION, + /// RakPeer - Reliable packets cannot be delivered to the system specified in Packet::systemAddress. The connection to that + /// system has been closed. + ID_CONNECTION_LOST, + /// RakPeer - We are banned from the system we attempted to connect to. + ID_CONNECTION_BANNED, + /// RakPeer - The remote system is using a password and has refused our connection because we did not set the correct password. + ID_INVALID_PASSWORD, + // RAKNET_PROTOCOL_VERSION in RakNetVersion.h does not match on the remote system what we have on our system + // This means the two systems cannot communicate. + // The 2nd byte of the message contains the value of RAKNET_PROTOCOL_VERSION for the remote system + ID_INCOMPATIBLE_PROTOCOL_VERSION, + // Means that this IP address connected recently, and can't connect again as a security measure. See + /// RakPeer::SetLimitIPConnectionFrequency() + ID_IP_RECENTLY_CONNECTED, + /// RakPeer - The sizeof(RakNetTime) bytes following this byte represent a value which is automatically modified by the difference + /// in system times between the sender and the recipient. Requires that you call SetOccasionalPing. + ID_TIMESTAMP, + /// RakPeer - Pong from an unconnected system. First byte is ID_UNCONNECTED_PONG, second sizeof(RakNet::TimeMS) bytes is the ping, + /// following bytes is system specific enumeration data. + /// Read using bitstreams + ID_UNCONNECTED_PONG, + /// RakPeer - Inform a remote system of our IP/Port. On the recipient, all data past ID_ADVERTISE_SYSTEM is whatever was passed to + /// the data parameter + ID_ADVERTISE_SYSTEM, + // RakPeer - Downloading a large message. Format is ID_DOWNLOAD_PROGRESS (MessageID), partCount (unsigned int), + /// partTotal (unsigned int), + /// partLength (unsigned int), first part data (length <= MAX_MTU_SIZE). See the three parameters partCount, partTotal + /// and partLength in OnFileProgress in FileListTransferCBInterface.h + ID_DOWNLOAD_PROGRESS, + + /// ConnectionGraph2 plugin - In a client/server environment, a client other than ourselves has disconnected gracefully. + /// Packet::systemAddress is modified to reflect the systemAddress of this client. + ID_REMOTE_DISCONNECTION_NOTIFICATION, + /// ConnectionGraph2 plugin - In a client/server environment, a client other than ourselves has been forcefully dropped. + /// Packet::systemAddress is modified to reflect the systemAddress of this client. + ID_REMOTE_CONNECTION_LOST, + /// ConnectionGraph2 plugin: Bytes 1-4 = count. for (count items) contains {SystemAddress, RakNetGUID, 2 byte ping} + ID_REMOTE_NEW_INCOMING_CONNECTION, + + /// FileListTransfer plugin - Setup data + ID_FILE_LIST_TRANSFER_HEADER, + /// FileListTransfer plugin - A file + ID_FILE_LIST_TRANSFER_FILE, + // Ack for reference push, to send more of the file + ID_FILE_LIST_REFERENCE_PUSH_ACK, + + /// DirectoryDeltaTransfer plugin - Request from a remote system for a download of a directory + ID_DDT_DOWNLOAD_REQUEST, + + /// RakNetTransport plugin - Transport provider message, used for remote console + ID_TRANSPORT_STRING, + + /// ReplicaManager plugin - Create an object + ID_REPLICA_MANAGER_CONSTRUCTION, + /// ReplicaManager plugin - Changed scope of an object + ID_REPLICA_MANAGER_SCOPE_CHANGE, + /// ReplicaManager plugin - Serialized data of an object + ID_REPLICA_MANAGER_SERIALIZE, + /// ReplicaManager plugin - New connection, about to send all world objects + ID_REPLICA_MANAGER_DOWNLOAD_STARTED, + /// ReplicaManager plugin - Finished downloading all serialized objects + ID_REPLICA_MANAGER_DOWNLOAD_COMPLETE, + + /// RakVoice plugin - Open a communication channel + ID_RAKVOICE_OPEN_CHANNEL_REQUEST, + /// RakVoice plugin - Communication channel accepted + ID_RAKVOICE_OPEN_CHANNEL_REPLY, + /// RakVoice plugin - Close a communication channel + ID_RAKVOICE_CLOSE_CHANNEL, + /// RakVoice plugin - Voice data + ID_RAKVOICE_DATA, + + /// Autopatcher plugin - Get a list of files that have changed since a certain date + ID_AUTOPATCHER_GET_CHANGELIST_SINCE_DATE, + /// Autopatcher plugin - A list of files to create + ID_AUTOPATCHER_CREATION_LIST, + /// Autopatcher plugin - A list of files to delete + ID_AUTOPATCHER_DELETION_LIST, + /// Autopatcher plugin - A list of files to get patches for + ID_AUTOPATCHER_GET_PATCH, + /// Autopatcher plugin - A list of patches for a list of files + ID_AUTOPATCHER_PATCH_LIST, + /// Autopatcher plugin - Returned to the user: An error from the database repository for the autopatcher. + ID_AUTOPATCHER_REPOSITORY_FATAL_ERROR, + /// Autopatcher plugin - Returned to the user: The server does not allow downloading unmodified game files. + ID_AUTOPATCHER_CANNOT_DOWNLOAD_ORIGINAL_UNMODIFIED_FILES, + /// Autopatcher plugin - Finished getting all files from the autopatcher + ID_AUTOPATCHER_FINISHED_INTERNAL, + ID_AUTOPATCHER_FINISHED, + /// Autopatcher plugin - Returned to the user: You must restart the application to finish patching. + ID_AUTOPATCHER_RESTART_APPLICATION, + + /// NATPunchthrough plugin: internal + ID_NAT_PUNCHTHROUGH_REQUEST, + /// NATPunchthrough plugin: internal + //ID_NAT_GROUP_PUNCHTHROUGH_REQUEST, + /// NATPunchthrough plugin: internal + //ID_NAT_GROUP_PUNCHTHROUGH_REPLY, + /// NATPunchthrough plugin: internal + ID_NAT_CONNECT_AT_TIME, + /// NATPunchthrough plugin: internal + ID_NAT_GET_MOST_RECENT_PORT, + /// NATPunchthrough plugin: internal + ID_NAT_CLIENT_READY, + /// NATPunchthrough plugin: internal + //ID_NAT_GROUP_PUNCHTHROUGH_FAILURE_NOTIFICATION, + + /// NATPunchthrough plugin: Destination system is not connected to the server. Bytes starting at offset 1 contains the + /// RakNetGUID destination field of NatPunchthroughClient::OpenNAT(). + ID_NAT_TARGET_NOT_CONNECTED, + /// NATPunchthrough plugin: Destination system is not responding to ID_NAT_GET_MOST_RECENT_PORT. Possibly the plugin is not installed. + /// Bytes starting at offset 1 contains the RakNetGUID destination field of NatPunchthroughClient::OpenNAT(). + ID_NAT_TARGET_UNRESPONSIVE, + /// NATPunchthrough plugin: The server lost the connection to the destination system while setting up punchthrough. + /// Possibly the plugin is not installed. Bytes starting at offset 1 contains the RakNetGUID destination + /// field of NatPunchthroughClient::OpenNAT(). + ID_NAT_CONNECTION_TO_TARGET_LOST, + /// NATPunchthrough plugin: This punchthrough is already in progress. Possibly the plugin is not installed. + /// Bytes starting at offset 1 contains the RakNetGUID destination field of NatPunchthroughClient::OpenNAT(). + ID_NAT_ALREADY_IN_PROGRESS, + /// NATPunchthrough plugin: This message is generated on the local system, and does not come from the network. + /// packet::guid contains the destination field of NatPunchthroughClient::OpenNAT(). Byte 1 contains 1 if you are the sender, 0 if not + ID_NAT_PUNCHTHROUGH_FAILED, + /// NATPunchthrough plugin: Punchthrough succeeded. See packet::systemAddress and packet::guid. Byte 1 contains 1 if you are the sender, + /// 0 if not. You can now use RakPeer::Connect() or other calls to communicate with this system. + ID_NAT_PUNCHTHROUGH_SUCCEEDED, + + /// ReadyEvent plugin - Set the ready state for a particular system + /// First 4 bytes after the message contains the id + ID_READY_EVENT_SET, + /// ReadyEvent plugin - Unset the ready state for a particular system + /// First 4 bytes after the message contains the id + ID_READY_EVENT_UNSET, + /// All systems are in state ID_READY_EVENT_SET + /// First 4 bytes after the message contains the id + ID_READY_EVENT_ALL_SET, + /// \internal, do not process in your game + /// ReadyEvent plugin - Request of ready event state - used for pulling data when newly connecting + ID_READY_EVENT_QUERY, + + /// Lobby packets. Second byte indicates type. + ID_LOBBY_GENERAL, + + // RPC3, RPC4 error + ID_RPC_REMOTE_ERROR, + /// Plugin based replacement for RPC system + ID_RPC_PLUGIN, + + /// FileListTransfer transferring large files in chunks that are read only when needed, to save memory + ID_FILE_LIST_REFERENCE_PUSH, + /// Force the ready event to all set + ID_READY_EVENT_FORCE_ALL_SET, + + /// Rooms function + ID_ROOMS_EXECUTE_FUNC, + ID_ROOMS_LOGON_STATUS, + ID_ROOMS_HANDLE_CHANGE, + + /// Lobby2 message + ID_LOBBY2_SEND_MESSAGE, + ID_LOBBY2_SERVER_ERROR, + + /// Informs user of a new host GUID. Packet::Guid contains this new host RakNetGuid. The old host can be read out using BitStream->Read(RakNetGuid) starting on byte 1 + /// This is not returned until connected to a remote system + /// If the oldHost is UNASSIGNED_RAKNET_GUID, then this is the first time the host has been determined + ID_FCM2_NEW_HOST, + /// \internal For FullyConnectedMesh2 plugin + ID_FCM2_REQUEST_FCMGUID, + /// \internal For FullyConnectedMesh2 plugin + ID_FCM2_RESPOND_CONNECTION_COUNT, + /// \internal For FullyConnectedMesh2 plugin + ID_FCM2_INFORM_FCMGUID, + /// \internal For FullyConnectedMesh2 plugin + ID_FCM2_UPDATE_MIN_TOTAL_CONNECTION_COUNT, + /// A remote system (not necessarily the host) called FullyConnectedMesh2::StartVerifiedJoin() with our system as the client + /// Use FullyConnectedMesh2::GetVerifiedJoinRequiredProcessingList() to read systems + /// For each system, attempt NatPunchthroughClient::OpenNAT() and/or RakPeerInterface::Connect() + /// When this has been done for all systems, the remote system will automatically be informed of the results + /// \note Only the designated client gets this message + /// \note You won't get this message if you are already connected to all target systems + /// \note If you fail to connect to a system, this does not automatically mean you will get ID_FCM2_VERIFIED_JOIN_FAILED as that system may have been shutting down from the host too + /// \sa FullyConnectedMesh2::StartVerifiedJoin() + ID_FCM2_VERIFIED_JOIN_START, + /// \internal The client has completed processing for all systems designated in ID_FCM2_VERIFIED_JOIN_START + ID_FCM2_VERIFIED_JOIN_CAPABLE, + /// Client failed to connect to a required systems notified via FullyConnectedMesh2::StartVerifiedJoin() + /// RakPeerInterface::CloseConnection() was automatically called for all systems connected due to ID_FCM2_VERIFIED_JOIN_START + /// Programmer should inform the player via the UI that they cannot join this session, and to choose a different session + /// \note Server normally sends us this message, however if connection to the server was lost, message will be returned locally + /// \note Only the designated client gets this message + ID_FCM2_VERIFIED_JOIN_FAILED, + /// The system that called StartVerifiedJoin() got ID_FCM2_VERIFIED_JOIN_CAPABLE from the client and then called RespondOnVerifiedJoinCapable() with true + /// AddParticipant() has automatically been called for this system + /// Use GetVerifiedJoinAcceptedAdditionalData() to read any additional data passed to RespondOnVerifiedJoinCapable() + /// \note All systems in the mesh get this message + /// \sa RespondOnVerifiedJoinCapable() + ID_FCM2_VERIFIED_JOIN_ACCEPTED, + /// The system that called StartVerifiedJoin() got ID_FCM2_VERIFIED_JOIN_CAPABLE from the client and then called RespondOnVerifiedJoinCapable() with false + /// CloseConnection() has been automatically called for each system connected to since ID_FCM2_VERIFIED_JOIN_START. + /// The connection is NOT automatically closed to the original host that sent StartVerifiedJoin() + /// Use GetVerifiedJoinRejectedAdditionalData() to read any additional data passed to RespondOnVerifiedJoinCapable() + /// \note Only the designated client gets this message + /// \sa RespondOnVerifiedJoinCapable() + ID_FCM2_VERIFIED_JOIN_REJECTED, + + /// UDP proxy messages. Second byte indicates type. + ID_UDP_PROXY_GENERAL, + + /// SQLite3Plugin - execute + ID_SQLite3_EXEC, + /// SQLite3Plugin - Remote database is unknown + ID_SQLite3_UNKNOWN_DB, + /// Events happening with SQLiteClientLoggerPlugin + ID_SQLLITE_LOGGER, + + /// Sent to NatTypeDetectionServer + ID_NAT_TYPE_DETECTION_REQUEST, + /// Sent to NatTypeDetectionClient. Byte 1 contains the type of NAT detected. + ID_NAT_TYPE_DETECTION_RESULT, + + /// Used by the router2 plugin + ID_ROUTER_2_INTERNAL, + /// No path is available or can be established to the remote system + /// Packet::guid contains the endpoint guid that we were trying to reach + ID_ROUTER_2_FORWARDING_NO_PATH, + /// \brief You can now call connect, ping, or other operations to the destination system. + /// + /// Connect as follows: + /// + /// RakNet::BitStream bs(packet->data, packet->length, false); + /// bs.IgnoreBytes(sizeof(MessageID)); + /// RakNetGUID endpointGuid; + /// bs.Read(endpointGuid); + /// unsigned short sourceToDestPort; + /// bs.Read(sourceToDestPort); + /// char ipAddressString[32]; + /// packet->systemAddress.ToString(false, ipAddressString); + /// rakPeerInterface->Connect(ipAddressString, sourceToDestPort, 0,0); + ID_ROUTER_2_FORWARDING_ESTABLISHED, + /// The IP address for a forwarded connection has changed + /// Read endpointGuid and port as per ID_ROUTER_2_FORWARDING_ESTABLISHED + ID_ROUTER_2_REROUTED, + + /// \internal Used by the team balancer plugin + ID_TEAM_BALANCER_INTERNAL, + /// Cannot switch to the desired team because it is full. However, if someone on that team leaves, you will + /// get ID_TEAM_BALANCER_TEAM_ASSIGNED later. + /// For TeamBalancer: Byte 1 contains the team you requested to join. Following bytes contain NetworkID of which member + ID_TEAM_BALANCER_REQUESTED_TEAM_FULL, + /// Cannot switch to the desired team because all teams are locked. However, if someone on that team leaves, + /// you will get ID_TEAM_BALANCER_SET_TEAM later. + /// For TeamBalancer: Byte 1 contains the team you requested to join. + ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED, + ID_TEAM_BALANCER_TEAM_REQUESTED_CANCELLED, + /// Team balancer plugin informing you of your team. Byte 1 contains the team you requested to join. Following bytes contain NetworkID of which member. + ID_TEAM_BALANCER_TEAM_ASSIGNED, + + /// Gamebryo Lightspeed integration + ID_LIGHTSPEED_INTEGRATION, + + /// XBOX integration + ID_XBOX_LOBBY, + + /// The password we used to challenge the other system passed, meaning the other system has called TwoWayAuthentication::AddPassword() with the same password we passed to TwoWayAuthentication::Challenge() + /// You can read the identifier used to challenge as follows: + /// RakNet::BitStream bs(packet->data, packet->length, false); bs.IgnoreBytes(sizeof(RakNet::MessageID)); RakNet::RakString password; bs.Read(password); + ID_TWO_WAY_AUTHENTICATION_INCOMING_CHALLENGE_SUCCESS, + ID_TWO_WAY_AUTHENTICATION_OUTGOING_CHALLENGE_SUCCESS, + /// A remote system sent us a challenge using TwoWayAuthentication::Challenge(), and the challenge failed. + /// If the other system must pass the challenge to stay connected, you should call RakPeer::CloseConnection() to terminate the connection to the other system. + ID_TWO_WAY_AUTHENTICATION_INCOMING_CHALLENGE_FAILURE, + /// The other system did not add the password we used to TwoWayAuthentication::AddPassword() + /// You can read the identifier used to challenge as follows: + /// RakNet::BitStream bs(packet->data, packet->length, false); bs.IgnoreBytes(sizeof(MessageID)); RakNet::RakString password; bs.Read(password); + ID_TWO_WAY_AUTHENTICATION_OUTGOING_CHALLENGE_FAILURE, + /// The other system did not respond within a timeout threshhold. Either the other system is not running the plugin or the other system was blocking on some operation for a long time. + /// You can read the identifier used to challenge as follows: + /// RakNet::BitStream bs(packet->data, packet->length, false); bs.IgnoreBytes(sizeof(MessageID)); RakNet::RakString password; bs.Read(password); + ID_TWO_WAY_AUTHENTICATION_OUTGOING_CHALLENGE_TIMEOUT, + /// \internal + ID_TWO_WAY_AUTHENTICATION_NEGOTIATION, + + /// CloudClient / CloudServer + ID_CLOUD_POST_REQUEST, + ID_CLOUD_RELEASE_REQUEST, + ID_CLOUD_GET_REQUEST, + ID_CLOUD_GET_RESPONSE, + ID_CLOUD_UNSUBSCRIBE_REQUEST, + ID_CLOUD_SERVER_TO_SERVER_COMMAND, + ID_CLOUD_SUBSCRIPTION_NOTIFICATION, + + // LibVoice + ID_LIB_VOICE, + + ID_RELAY_PLUGIN, + ID_NAT_REQUEST_BOUND_ADDRESSES, + ID_NAT_RESPOND_BOUND_ADDRESSES, + ID_FCM2_UPDATE_USER_CONTEXT, + ID_RESERVED_3, + ID_RESERVED_4, + ID_RESERVED_5, + ID_RESERVED_6, + ID_RESERVED_7, + ID_RESERVED_8, + ID_RESERVED_9, + + // For the user to use. Start your first enumeration at this value. + ID_USER_PACKET_ENUM + //------------------------------------------------------------------------------------------------------------- + +}; + +#endif // RAKNET_USE_CUSTOM_PACKET_IDS + +#endif diff --git a/include/raknet/NatPunchthroughClient.hpp b/include/raknet/NatPunchthroughClient.hpp new file mode 100644 index 0000000..4bcc701 --- /dev/null +++ b/include/raknet/NatPunchthroughClient.hpp @@ -0,0 +1,306 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains the NAT-punchthrough plugin for the client. +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_NatPunchthroughClient==1 + +#ifndef __NAT_PUNCHTHROUGH_CLIENT_H +#define __NAT_PUNCHTHROUGH_CLIENT_H + +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "PluginInterface2.hpp" +#include "PacketPriority.hpp" +#include "SocketIncludes.hpp" +#include "DS_List.hpp" +#include "RakString.hpp" +#include "DS_Queue.hpp" + +// Trendnet TEW-632BRP sometimes starts at port 1024 and increments sequentially. +// Zonnet zsr1134we. Replies go out on the net, but are always absorbed by the remote router?? +// Dlink ebr2310 to Trendnet ok +// Trendnet TEW-652BRP to Trendnet 632BRP OK +// Trendnet TEW-632BRP to Trendnet 632BRP OK +// Buffalo WHR-HP-G54 OK +// Netgear WGR614 ok + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +struct Packet; +#if _RAKNET_SUPPORT_PacketLogger==1 +class PacketLogger; +#endif + +/// \ingroup NAT_PUNCHTHROUGH_GROUP +struct RAK_DLL_EXPORT PunchthroughConfiguration +{ + /// internal: (15 ms * 2 tries + 30 wait) * 5 ports * 8 players = 2.4 seconds + /// external: (50 ms * 8 sends + 200 wait) * 2 port * 8 players = 9.6 seconds + /// Total: 8 seconds + PunchthroughConfiguration() { + TIME_BETWEEN_PUNCH_ATTEMPTS_INTERNAL=15; + TIME_BETWEEN_PUNCH_ATTEMPTS_EXTERNAL=50; + UDP_SENDS_PER_PORT_INTERNAL=2; + UDP_SENDS_PER_PORT_EXTERNAL=8; + INTERNAL_IP_WAIT_AFTER_ATTEMPTS=30; + MAXIMUM_NUMBER_OF_INTERNAL_IDS_TO_CHECK=5; /// set to 0 to not do lan connects + MAX_PREDICTIVE_PORT_RANGE=2; + EXTERNAL_IP_WAIT_BETWEEN_PORTS=200; + EXTERNAL_IP_WAIT_AFTER_FIRST_TTL=100; + EXTERNAL_IP_WAIT_AFTER_ALL_ATTEMPTS=EXTERNAL_IP_WAIT_BETWEEN_PORTS; + retryOnFailure=false; + } + + /// How much time between each UDP send + RakNet::Time TIME_BETWEEN_PUNCH_ATTEMPTS_INTERNAL; + RakNet::Time TIME_BETWEEN_PUNCH_ATTEMPTS_EXTERNAL; + + /// How many tries for one port before giving up and going to the next port + int UDP_SENDS_PER_PORT_INTERNAL; + int UDP_SENDS_PER_PORT_EXTERNAL; + + /// After giving up on one internal port, how long to wait before trying the next port + int INTERNAL_IP_WAIT_AFTER_ATTEMPTS; + + /// How many external ports to try past the last known starting port + int MAX_PREDICTIVE_PORT_RANGE; + + /// After sending TTL, how long to wait until first punch attempt + int EXTERNAL_IP_WAIT_AFTER_FIRST_TTL; + + /// After giving up on one external port, how long to wait before trying the next port + int EXTERNAL_IP_WAIT_BETWEEN_PORTS; + + /// After trying all external ports, how long to wait before returning ID_NAT_PUNCHTHROUGH_FAILED + int EXTERNAL_IP_WAIT_AFTER_ALL_ATTEMPTS; + + /// Maximum number of internal IP address to try to connect to. + /// Cannot be greater than MAXIMUM_NUMBER_OF_INTERNAL_IDS + /// Should be high enough to try all internal IP addresses on the majority of computers + int MAXIMUM_NUMBER_OF_INTERNAL_IDS_TO_CHECK; + + /// If the first punchthrough attempt fails, try again + /// This sometimes works because the remote router was looking for an incoming message on a higher numbered port before responding to a lower numbered port from the other system + bool retryOnFailure; +}; + +/// \ingroup NAT_PUNCHTHROUGH_GROUP +struct RAK_DLL_EXPORT NatPunchthroughDebugInterface +{ + NatPunchthroughDebugInterface() {} + virtual ~NatPunchthroughDebugInterface() {} + virtual void OnClientMessage(const char *msg)=0; +}; + +/// \ingroup NAT_PUNCHTHROUGH_GROUP +struct RAK_DLL_EXPORT NatPunchthroughDebugInterface_Printf : public NatPunchthroughDebugInterface +{ + virtual void OnClientMessage(const char *msg); +}; + +#if _RAKNET_SUPPORT_PacketLogger==1 +/// \ingroup NAT_PUNCHTHROUGH_GROUP +struct RAK_DLL_EXPORT NatPunchthroughDebugInterface_PacketLogger : public NatPunchthroughDebugInterface +{ + // Set to non-zero to write to the packetlogger! + PacketLogger *pl; + + NatPunchthroughDebugInterface_PacketLogger() {pl=0;} + ~NatPunchthroughDebugInterface_PacketLogger() {} + virtual void OnClientMessage(const char *msg); +}; +#endif + +/// \brief Client code for NATPunchthrough +/// \details Maintain connection to NatPunchthroughServer to process incoming connection attempts through NatPunchthroughClient
+/// Client will send datagrams to port to estimate next port
+/// Will simultaneously connect with another client once ports are estimated. +/// \sa NatTypeDetectionClient +/// See also http://www.jenkinssoftware.com/raknet/manual/natpunchthrough.html +/// \ingroup NAT_PUNCHTHROUGH_GROUP +class RAK_DLL_EXPORT NatPunchthroughClient : public PluginInterface2 +{ +public: + + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(NatPunchthroughClient) + + NatPunchthroughClient(); + ~NatPunchthroughClient(); + + /// If the instance of RakPeer running NATPunchthroughServer was bound to two IP addresses, then you can call FindRouterPortStride() + /// This will determine the stride that your router uses when assigning ports, if your router is full-cone + /// This function is also called automatically when you call OpenNAT - however, calling it earlier when you are connected to the facilitator will speed up the process + /// \param[in] destination The system to punch. Must already be connected to \a facilitator + void FindRouterPortStride(const SystemAddress &facilitator); + + /// Punchthrough a NAT. Doesn't connect, just tries to setup the routing table + /// \param[in] destination The system to punch. Must already be connected to \a facilitator + /// \param[in] facilitator A system we are already connected to running the NatPunchthroughServer plugin + /// \sa OpenNATGroup() + /// You will get ID_NAT_PUNCHTHROUGH_SUCCEEDED on success + /// You will get ID_NAT_TARGET_NOT_CONNECTED, ID_NAT_TARGET_UNRESPONSIVE, ID_NAT_CONNECTION_TO_TARGET_LOST, ID_NAT_ALREADY_IN_PROGRESS, or ID_NAT_PUNCHTHROUGH_FAILED on failures of various types + /// However, if you lose connection to the facilitator, you may not necessarily get above + bool OpenNAT(RakNetGUID destination, const SystemAddress &facilitator); + + /* + /// \deprecated See FullyConnectedMesh2::StartVerifiedJoin() which is more flexible + /// Same as calling OpenNAT for a list of systems, but reply is delayed until all systems pass. + /// This is useful for peer to peer games where you want to connect to every system in the remote session, not just one particular system + /// \note For cloud computing, all systems in the group must be connected to the same facilitator since we're only specifying one + /// You will get ID_NAT_GROUP_PUNCH_SUCCEEDED on success + /// You will get ID_NAT_TARGET_NOT_CONNECTED, ID_NAT_ALREADY_IN_PROGRESS, or ID_NAT_GROUP_PUNCH_FAILED on failures of various types + /// However, if you lose connection to the facilitator, you may not necessarily get above + bool OpenNATGroup(DataStructures::List destinationSystems, const SystemAddress &facilitator); + */ + + /// Modify the system configuration if desired + /// Don't modify the variables in the structure while punchthrough is in progress + PunchthroughConfiguration* GetPunchthroughConfiguration(void); + + /// Sets a callback to be called with debug messages + /// \param[in] i Pointer to an interface. The pointer is stored, so don't delete it while in progress. Pass 0 to clear. + void SetDebugInterface(NatPunchthroughDebugInterface *i); + + /// Get the port mappings you should pass to UPNP (for miniupnpc-1.6.20120410, for the function UPNP_AddPortMapping) + void GetUPNPPortMappings(char *externalPort, char *internalPort, const SystemAddress &natPunchthroughServerAddress); + + /// \internal For plugin handling + virtual void Update(void); + + /// \internal For plugin handling + virtual PluginReceiveResult OnReceive(Packet *packet); + + /// \internal For plugin handling + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + + /// \internal For plugin handling + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + + virtual void OnAttach(void); + virtual void OnDetach(void); + virtual void OnRakPeerShutdown(void); + void Clear(void); + + struct SendPing + { + RakNet::Time nextActionTime; + SystemAddress targetAddress; + SystemAddress facilitator; + SystemAddress internalIds[MAXIMUM_NUMBER_OF_INTERNAL_IDS]; + RakNetGUID targetGuid; + bool weAreSender; + int attemptCount; + int retryCount; + int punchingFixedPortAttempts; // only used for TestMode::PUNCHING_FIXED_PORT + uint16_t sessionId; + bool sentTTL; + // Give priority to internal IP addresses because if we are on a LAN, we don't want to try to connect through the internet + enum TestMode + { + TESTING_INTERNAL_IPS, + WAITING_FOR_INTERNAL_IPS_RESPONSE, + //SEND_WITH_TTL, + TESTING_EXTERNAL_IPS_FACILITATOR_PORT_TO_FACILITATOR_PORT, + TESTING_EXTERNAL_IPS_1024_TO_FACILITATOR_PORT, + TESTING_EXTERNAL_IPS_FACILITATOR_PORT_TO_1024, + TESTING_EXTERNAL_IPS_1024_TO_1024, + WAITING_AFTER_ALL_ATTEMPTS, + + // The trendnet remaps the remote port to 1024. + // If you continue punching on a different port for the same IP it bans you and the communication becomes unidirectioal + PUNCHING_FIXED_PORT, + + // try port 1024-1028 + } testMode; + } sp; + +protected: + unsigned short mostRecentExternalPort; + //void OnNatGroupPunchthroughRequest(Packet *packet); + void OnFailureNotification(Packet *packet); + //void OnNatGroupPunchthroughReply(Packet *packet); + void OnGetMostRecentPort(Packet *packet); + void OnConnectAtTime(Packet *packet); + unsigned int GetPendingOpenNATIndex(RakNetGUID destination, const SystemAddress &facilitator); + void SendPunchthrough(RakNetGUID destination, const SystemAddress &facilitator); + void QueueOpenNAT(RakNetGUID destination, const SystemAddress &facilitator); + void SendQueuedOpenNAT(void); + void SendTTL(const SystemAddress &sa); + void SendOutOfBand(SystemAddress sa, MessageID oobId); + void OnPunchthroughFailure(void); + void OnReadyForNextPunchthrough(void); + void PushFailure(void); + bool RemoveFromFailureQueue(void); + void PushSuccess(void); + + PunchthroughConfiguration pc; + NatPunchthroughDebugInterface *natPunchthroughDebugInterface; + + // The first time we fail a NAT attempt, we add it to failedAttemptList and try again, since sometimes trying again later fixes the problem + // The second time we fail, we return ID_NAT_PUNCHTHROUGH_FAILED + struct AddrAndGuid + { + SystemAddress addr; + RakNetGUID guid; + }; + DataStructures::List failedAttemptList; + + struct DSTAndFac + { + RakNetGUID destination; + SystemAddress facilitator; + }; + DataStructures::Queue queuedOpenNat; + + void IncrementExternalAttemptCount(RakNet::Time time, RakNet::Time delta); + unsigned short portStride; + enum + { + HAS_PORT_STRIDE, + UNKNOWN_PORT_STRIDE, + CALCULATING_PORT_STRIDE, + INCAPABLE_PORT_STRIDE + } hasPortStride; + RakNet::Time portStrideCalTimeout; + + /* + struct TimeAndGuid + { + RakNet::Time time; + RakNetGUID guid; + }; + DataStructures::List groupRequestsInProgress; + + struct GroupPunchRequest + { + SystemAddress facilitator; + DataStructures::List pendingList; + DataStructures::List passedListGuid; + DataStructures::List passedListAddress; + DataStructures::List failedList; + DataStructures::List ignoredList; + }; + DataStructures::List groupPunchRequests; + void UpdateGroupPunchOnNatResult(SystemAddress facilitator, RakNetGUID targetSystem, SystemAddress targetSystemAddress, int result); // 0=failed, 1=success, 2=ignore + */ +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/NatPunchthroughServer.hpp b/include/raknet/NatPunchthroughServer.hpp new file mode 100644 index 0000000..c529c09 --- /dev/null +++ b/include/raknet/NatPunchthroughServer.hpp @@ -0,0 +1,156 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains the NAT-punchthrough plugin for the server. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_NatPunchthroughServer==1 + +#ifndef __NAT_PUNCHTHROUGH_SERVER_H +#define __NAT_PUNCHTHROUGH_SERVER_H + +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "PluginInterface2.hpp" +#include "PacketPriority.hpp" +#include "SocketIncludes.hpp" +#include "DS_OrderedList.hpp" +#include "RakString.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +struct Packet; +#if _RAKNET_SUPPORT_PacketLogger==1 +class PacketLogger; +#endif + +/// \defgroup NAT_PUNCHTHROUGH_GROUP NatPunchthrough +/// \brief Connect systems despite both systems being behind a router +/// \details +/// \ingroup PLUGINS_GROUP + +/// \ingroup NAT_PUNCHTHROUGH_GROUP +struct RAK_DLL_EXPORT NatPunchthroughServerDebugInterface +{ + NatPunchthroughServerDebugInterface() {} + virtual ~NatPunchthroughServerDebugInterface() {} + virtual void OnServerMessage(const char *msg)=0; +}; + +/// \ingroup NAT_PUNCHTHROUGH_GROUP +struct RAK_DLL_EXPORT NatPunchthroughServerDebugInterface_Printf : public NatPunchthroughServerDebugInterface +{ + virtual void OnServerMessage(const char *msg); +}; + +#if _RAKNET_SUPPORT_PacketLogger==1 +/// \ingroup NAT_PUNCHTHROUGH_GROUP +struct RAK_DLL_EXPORT NatPunchthroughServerDebugInterface_PacketLogger : public NatPunchthroughServerDebugInterface +{ + // Set to non-zero to write to the packetlogger! + PacketLogger *pl; + + NatPunchthroughServerDebugInterface_PacketLogger() {pl=0;} + ~NatPunchthroughServerDebugInterface_PacketLogger() {} + virtual void OnServerMessage(const char *msg); +}; +#endif + +/// \brief Server code for NATPunchthrough +/// \details Maintain connection to NatPunchthroughServer to process incoming connection attempts through NatPunchthroughClient
+/// Server maintains two sockets clients can connect to so as to estimate the next port choice
+/// Server tells other client about port estimate, current public port to the server, and a time to start connection attempts +/// \sa NatTypeDetectionClient +/// See also http://www.jenkinssoftware.com/raknet/manual/natpunchthrough.html +/// \ingroup NAT_PUNCHTHROUGH_GROUP +class RAK_DLL_EXPORT NatPunchthroughServer : public PluginInterface2 +{ +public: + + STATIC_FACTORY_DECLARATIONS(NatPunchthroughServer) + + // Constructor + NatPunchthroughServer(); + + // Destructor + virtual ~NatPunchthroughServer(); + + /// Sets a callback to be called with debug messages + /// \param[in] i Pointer to an interface. The pointer is stored, so don't delete it while in progress. Pass 0 to clear. + void SetDebugInterface(NatPunchthroughServerDebugInterface *i); + + /// \internal For plugin handling + virtual void Update(void); + + /// \internal For plugin handling + virtual PluginReceiveResult OnReceive(Packet *packet); + + /// \internal For plugin handling + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + + // Each connected user has a ready state. Ready means ready for nat punchthrough. + struct User; + struct ConnectionAttempt + { + ConnectionAttempt() {sender=0; recipient=0; startTime=0; attemptPhase=NAT_ATTEMPT_PHASE_NOT_STARTED;} + User *sender, *recipient; + uint16_t sessionId; + RakNet::Time startTime; + enum + { + NAT_ATTEMPT_PHASE_NOT_STARTED, + NAT_ATTEMPT_PHASE_GETTING_RECENT_PORTS, + } attemptPhase; + }; + struct User + { + RakNetGUID guid; + SystemAddress systemAddress; + unsigned short mostRecentPort; + bool isReady; + DataStructures::OrderedList groupPunchthroughRequests; + + DataStructures::List connectionAttempts; + bool HasConnectionAttemptToUser(User *user); + void DerefConnectionAttempt(ConnectionAttempt *ca); + void DeleteConnectionAttempt(ConnectionAttempt *ca); + void LogConnectionAttempts(RakNet::RakString &rs); + }; + RakNet::Time lastUpdate; + static int NatPunchthroughUserComp( const RakNetGUID &key, User * const &data ); +protected: + void OnNATPunchthroughRequest(Packet *packet); + DataStructures::OrderedList users; + + void OnGetMostRecentPort(Packet *packet); + void OnClientReady(Packet *packet); + + void SendTimestamps(void); + void StartPendingPunchthrough(void); + void StartPunchthroughForUser(User*user); + uint16_t sessionId; + NatPunchthroughServerDebugInterface *natPunchthroughServerDebugInterface; + + SystemAddress boundAddresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS]; + unsigned char boundAddressCount; + +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/NatTypeDetectionClient.hpp b/include/raknet/NatTypeDetectionClient.hpp new file mode 100644 index 0000000..b5a7df2 --- /dev/null +++ b/include/raknet/NatTypeDetectionClient.hpp @@ -0,0 +1,97 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains the NAT-type detection code for the client +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_NatTypeDetectionClient==1 + +#ifndef __NAT_TYPE_DETECTION_CLIENT_H +#define __NAT_TYPE_DETECTION_CLIENT_H + +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "PluginInterface2.hpp" +#include "PacketPriority.hpp" +#include "SocketIncludes.hpp" +#include "DS_OrderedList.hpp" +#include "RakString.hpp" +#include "NatTypeDetectionCommon.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +struct Packet; + + /// \brief Client code for NatTypeDetection + /// \details See NatTypeDetectionServer.h for algorithm + /// To use, just connect to the server, and call DetectNAT + /// You will get back ID_NAT_TYPE_DETECTION_RESULT with one of the enumerated values of NATTypeDetectionResult found in NATTypeDetectionCommon.h + /// See also http://www.jenkinssoftware.com/raknet/manual/natpunchthrough.html + /// \sa NatPunchthroughClient + /// \sa NatTypeDetectionServer + /// \ingroup NAT_TYPE_DETECTION_GROUP + class RAK_DLL_EXPORT NatTypeDetectionClient : public PluginInterface2, public RNS2EventHandler + { + public: + + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(NatTypeDetectionClient) + + // Constructor + NatTypeDetectionClient(); + + // Destructor + virtual ~NatTypeDetectionClient(); + + /// Send the message to the server to detect the nat type + /// Server must be running NatTypeDetectionServer + /// We must already be connected to the server + /// \param[in] serverAddress address of the server + void DetectNATType(SystemAddress _serverAddress); + + /// \internal For plugin handling + virtual void Update(void); + + /// \internal For plugin handling + virtual PluginReceiveResult OnReceive(Packet *packet); + + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnRakPeerShutdown(void); + virtual void OnDetach(void); + + virtual void OnRNS2Recv(RNS2RecvStruct *recvStruct); + virtual void DeallocRNS2RecvStruct(RNS2RecvStruct *s, const char *file, unsigned int line); + virtual RNS2RecvStruct *AllocRNS2RecvStruct(const char *file, unsigned int line); + protected: + DataStructures::Queue bufferedPackets; + SimpleMutex bufferedPacketsMutex; + + RakNetSocket2* c2; + //unsigned short c2Port; + void Shutdown(void); + void OnCompletion(NATTypeDetectionResult result); + bool IsInProgress(void) const; + + void OnTestPortRestricted(Packet *packet); + SystemAddress serverAddress; + }; + + +} + + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/NatTypeDetectionCommon.hpp b/include/raknet/NatTypeDetectionCommon.hpp new file mode 100644 index 0000000..09d7305 --- /dev/null +++ b/include/raknet/NatTypeDetectionCommon.hpp @@ -0,0 +1,79 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \defgroup NAT_TYPE_DETECTION_GROUP NatTypeDetection +/// \brief Use a remote server with multiple IP addresses to determine what type of NAT your router is using +/// \details +/// \ingroup PLUGINS_GROUP + +#ifndef __NAT_TYPE_DETECTION_COMMON_H +#define __NAT_TYPE_DETECTION_COMMON_H + +#include "NativeFeatureIncludes.hpp" + +#if _RAKNET_SUPPORT_NatTypeDetectionServer==1 || _RAKNET_SUPPORT_NatTypeDetectionClient==1 + +#include "SocketIncludes.hpp" +#include "RakNetTypes.hpp" +#include "RakNetSocket2.hpp" + +namespace RakNet +{ + + /// All possible types of NATs (except NAT_TYPE_COUNT, which is an internal value) + enum NATTypeDetectionResult + { + /// Works with anyone + NAT_TYPE_NONE, + /// Accepts any datagrams to a port that has been previously used. Will accept the first datagram from the remote peer. + NAT_TYPE_FULL_CONE, + /// Accepts datagrams to a port as long as the datagram source IP address is a system we have already sent to. Will accept the first datagram if both systems send simultaneously. Otherwise, will accept the first datagram after we have sent one datagram. + NAT_TYPE_ADDRESS_RESTRICTED, + /// Same as address-restricted cone NAT, but we had to send to both the correct remote IP address and correct remote port. The same source address and port to a different destination uses the same mapping. + NAT_TYPE_PORT_RESTRICTED, + /// A different port is chosen for every remote destination. The same source address and port to a different destination uses a different mapping. Since the port will be different, the first external punchthrough attempt will fail. For this to work it requires port-prediction (MAX_PREDICTIVE_PORT_RANGE>1) and that the router chooses ports sequentially. + NAT_TYPE_SYMMETRIC, + /// Hasn't been determined. NATTypeDetectionClient does not use this, but other plugins might + NAT_TYPE_UNKNOWN, + /// In progress. NATTypeDetectionClient does not use this, but other plugins might + NAT_TYPE_DETECTION_IN_PROGRESS, + /// Didn't bother figuring it out, as we support UPNP, so it is equivalent to NAT_TYPE_NONE. NATTypeDetectionClient does not use this, but other plugins might + NAT_TYPE_SUPPORTS_UPNP, + /// \internal Must be last + NAT_TYPE_COUNT + }; + + /// \return Can one system with NATTypeDetectionResult \a type1 connect to \a type2 + bool RAK_DLL_EXPORT CanConnect(NATTypeDetectionResult type1, NATTypeDetectionResult type2); + + /// Return a technical string representin the enumeration + RAK_DLL_EXPORT const char * NATTypeDetectionResultToString(NATTypeDetectionResult type); + + /// Return a friendly string representing the enumeration + /// None and relaxed can connect to anything + /// Moderate can connect to moderate or less + /// Strict can connect to relaxed or less + RAK_DLL_EXPORT const char * NATTypeDetectionResultToStringFriendly(NATTypeDetectionResult type); + + /// \internal + RAK_DLL_EXPORT RakNetSocket2* CreateNonblockingBoundSocket(const char *bindAddr +#ifdef __native_client__ + ,_PP_Instance_ chromeInstance +#endif + , RNS2EventHandler *eventHandler + ); + + /// \internal + //int NatTypeRecvFrom(char *data, RakNetSocket2* socket, SystemAddress &sender, RNS2EventHandler *eventHandler); +} + +#endif // #if _RAKNET_SUPPORT_NatTypeDetectionServer==1 || _RAKNET_SUPPORT_NatTypeDetectionClient==1 + +#endif diff --git a/include/raknet/NatTypeDetectionServer.hpp b/include/raknet/NatTypeDetectionServer.hpp new file mode 100644 index 0000000..71c8c44 --- /dev/null +++ b/include/raknet/NatTypeDetectionServer.hpp @@ -0,0 +1,137 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains the NAT-type detection code for the server +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_NatTypeDetectionServer==1 + +#ifndef __NAT_TYPE_DETECTION_SERVER_H +#define __NAT_TYPE_DETECTION_SERVER_H + +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "PluginInterface2.hpp" +#include "PacketPriority.hpp" +#include "SocketIncludes.hpp" +#include "DS_OrderedList.hpp" +#include "RakString.hpp" +#include "NatTypeDetectionCommon.hpp" + + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +struct Packet; + +/// \brief Server code for NatTypeDetection +/// \details +/// Sends to a remote system on certain ports and addresses to determine what type of router, if any, that client is behind +/// Requires that the server have 4 external IP addresses +///
    +///
  1. Server has 1 instance of RakNet. Server has four external ip addresses S1 to S4. Five ports are used in total P1 to P5. RakNet is bound to S1P1. Sockets are bound to S1P2, S2P3, S3P4, S4P5 +///
  2. Client with one port using RakNet (C1). Another port not using anything (C2). +///
  3. C1 connects to S1P1 for normal communication. +///
  4. S4P5 sends to C2. If arrived, no NAT. Done. (If didn't arrive, S4P5 potentially banned, do not use again). +///
  5. S2P3 sends to C1 (Different address, different port, to previously used port on client). If received, Full-cone nat. Done. (If didn't arrive, S2P3 potentially banned, do not use again). +///
  6. S1P2 sends to C1 (Same address, different port, to previously used port on client). If received, address-restricted cone nat. Done. +///
  7. Server via RakNet connection tells C1 to send to to S3P4. If address of C1 as seen by S3P4 is the same as the address of C1 as seen by S1P1 (RakNet connection), then port-restricted cone nat. Done +///
  8. Else symmetric nat. Done. +///
+/// See also http://www.jenkinssoftware.com/raknet/manual/natpunchthrough.html +/// \sa NatPunchthroughServer +/// \sa NatTypeDetectionClient +/// \ingroup NAT_TYPE_DETECTION_GROUP +class RAK_DLL_EXPORT NatTypeDetectionServer : public PluginInterface2, public RNS2EventHandler +{ +public: + + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(NatTypeDetectionServer) + + // Constructor + NatTypeDetectionServer(); + + // Destructor + virtual ~NatTypeDetectionServer(); + + /// Start the system, binding to 3 external IPs not already in useS + /// \param[in] nonRakNetIP2 First unused external IP + /// \param[in] nonRakNetIP3 Second unused external IP + /// \param[in] nonRakNetIP4 Third unused external IP + void Startup( + const char *nonRakNetIP2, + const char *nonRakNetIP3, + const char *nonRakNetIP4 +#ifdef __native_client__ + ,_PP_Instance_ chromeInstance +#endif + ); + + // Releases the sockets created in Startup(); + void Shutdown(void); + + /// \internal For plugin handling + virtual void Update(void); + + /// \internal For plugin handling + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + + enum NATDetectionState + { + STATE_NONE, + STATE_TESTING_NONE_1, + STATE_TESTING_NONE_2, + STATE_TESTING_FULL_CONE_1, + STATE_TESTING_FULL_CONE_2, + STATE_TESTING_ADDRESS_RESTRICTED_1, + STATE_TESTING_ADDRESS_RESTRICTED_2, + STATE_TESTING_PORT_RESTRICTED_1, + STATE_TESTING_PORT_RESTRICTED_2, + STATE_DONE, + }; + + struct NATDetectionAttempt + { + SystemAddress systemAddress; + NATDetectionState detectionState; + RakNet::TimeMS nextStateTime; + RakNet::TimeMS timeBetweenAttempts; + unsigned short c2Port; + RakNetGUID guid; + }; + + virtual void OnRNS2Recv(RNS2RecvStruct *recvStruct); + virtual void DeallocRNS2RecvStruct(RNS2RecvStruct *s, const char *file, unsigned int line); + virtual RNS2RecvStruct *AllocRNS2RecvStruct(const char *file, unsigned int line); +protected: + DataStructures::Queue bufferedPackets; + SimpleMutex bufferedPacketsMutex; + + void OnDetectionRequest(Packet *packet); + DataStructures::List natDetectionAttempts; + unsigned int GetDetectionAttemptIndex(const SystemAddress &sa); + unsigned int GetDetectionAttemptIndex(RakNetGUID guid); + + // s1p1 is rakpeer itself + RakNetSocket2 *s1p2,*s2p3,*s3p4,*s4p5; + //unsigned short s1p2Port, s2p3Port, s3p4Port, s4p5Port; + char s3p4Address[64]; +}; +} + + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/NativeFeatureIncludes.hpp b/include/raknet/NativeFeatureIncludes.hpp new file mode 100644 index 0000000..1f61989 --- /dev/null +++ b/include/raknet/NativeFeatureIncludes.hpp @@ -0,0 +1,206 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +// If you want to change these defines, put them in NativeFeatureIncludesOverrides so your changes are not lost when updating RakNet +// The user should not edit this file +#include "NativeFeatureIncludesOverrides.hpp" + +#ifndef __NATIVE_FEATURE_INCLDUES_H +#define __NATIVE_FEATURE_INCLDUES_H + +// Uncomment below defines, and paste to NativeFeatureIncludesOverrides.h, to exclude plugins that you do not want to build into the static library, or DLL +// These are not all the plugins, only those that are in the core library +// Other plugins are located in DependentExtensions +// #define _RAKNET_SUPPORT_ConnectionGraph2 0 +// #define _RAKNET_SUPPORT_DirectoryDeltaTransfer 0 +// #define _RAKNET_SUPPORT_FileListTransfer 0 +// #define _RAKNET_SUPPORT_FullyConnectedMesh2 0 +// #define _RAKNET_SUPPORT_MessageFilter 0 +// #define _RAKNET_SUPPORT_NatPunchthroughClient 0 +// #define _RAKNET_SUPPORT_NatPunchthroughServer 0 +// #define _RAKNET_SUPPORT_NatTypeDetectionClient 0 +// #define _RAKNET_SUPPORT_NatTypeDetectionServer 0 +// #define _RAKNET_SUPPORT_PacketLogger 0 +// #define _RAKNET_SUPPORT_ReadyEvent 0 +// #define _RAKNET_SUPPORT_ReplicaManager3 0 +// #define _RAKNET_SUPPORT_Router2 0 +// #define _RAKNET_SUPPORT_RPC4Plugin 0 +// #define _RAKNET_SUPPORT_TeamBalancer 0 +// #define _RAKNET_SUPPORT_TeamManager 0 +// #define _RAKNET_SUPPORT_UDPProxyClient 0 +// #define _RAKNET_SUPPORT_UDPProxyCoordinator 0 +// #define _RAKNET_SUPPORT_UDPProxyServer 0 +// #define _RAKNET_SUPPORT_ConsoleServer 0 +// #define _RAKNET_SUPPORT_RakNetTransport 0 +// #define _RAKNET_SUPPORT_TelnetTransport 0 +// #define _RAKNET_SUPPORT_TCPInterface 0 +// #define _RAKNET_SUPPORT_LogCommandParser 0 +// #define _RAKNET_SUPPORT_RakNetCommandParser 0 +// #define _RAKNET_SUPPORT_EmailSender 0 +// #define _RAKNET_SUPPORT_HTTPConnection 0 +// #define _RAKNET_SUPPORT_HTTPConnection2 0 +// #define _RAKNET_SUPPORT_PacketizedTCP 0 +// #define _RAKNET_SUPPORT_TwoWayAuthentication 0 + +// SET DEFAULTS IF UNDEFINED +#ifndef LIBCAT_SECURITY +#define LIBCAT_SECURITY 0 +#endif +#ifndef _RAKNET_SUPPORT_ConnectionGraph2 +#define _RAKNET_SUPPORT_ConnectionGraph2 1 +#endif +#ifndef _RAKNET_SUPPORT_DirectoryDeltaTransfer +#define _RAKNET_SUPPORT_DirectoryDeltaTransfer 1 +#endif +#ifndef _RAKNET_SUPPORT_FileListTransfer +#define _RAKNET_SUPPORT_FileListTransfer 1 +#endif +#ifndef _RAKNET_SUPPORT_FullyConnectedMesh +#define _RAKNET_SUPPORT_FullyConnectedMesh 1 +#endif +#ifndef _RAKNET_SUPPORT_FullyConnectedMesh2 +#define _RAKNET_SUPPORT_FullyConnectedMesh2 1 +#endif +#ifndef _RAKNET_SUPPORT_MessageFilter +#define _RAKNET_SUPPORT_MessageFilter 1 +#endif +#ifndef _RAKNET_SUPPORT_NatPunchthroughClient +#define _RAKNET_SUPPORT_NatPunchthroughClient 1 +#endif +#ifndef _RAKNET_SUPPORT_NatPunchthroughServer +#define _RAKNET_SUPPORT_NatPunchthroughServer 1 +#endif +#ifndef _RAKNET_SUPPORT_NatTypeDetectionClient +#define _RAKNET_SUPPORT_NatTypeDetectionClient 1 +#endif +#ifndef _RAKNET_SUPPORT_NatTypeDetectionServer +#define _RAKNET_SUPPORT_NatTypeDetectionServer 1 +#endif +#ifndef _RAKNET_SUPPORT_PacketLogger +#define _RAKNET_SUPPORT_PacketLogger 1 +#endif +#ifndef _RAKNET_SUPPORT_ReadyEvent +#define _RAKNET_SUPPORT_ReadyEvent 1 +#endif +#ifndef _RAKNET_SUPPORT_ReplicaManager3 +#define _RAKNET_SUPPORT_ReplicaManager3 1 +#endif +#ifndef _RAKNET_SUPPORT_Router2 +#define _RAKNET_SUPPORT_Router2 1 +#endif +#ifndef _RAKNET_SUPPORT_RPC4Plugin +#define _RAKNET_SUPPORT_RPC4Plugin 1 +#endif +#ifndef _RAKNET_SUPPORT_TeamBalancer +#define _RAKNET_SUPPORT_TeamBalancer 1 +#endif +#ifndef _RAKNET_SUPPORT_TeamManager +#define _RAKNET_SUPPORT_TeamManager 1 +#endif +#ifndef _RAKNET_SUPPORT_UDPProxyClient +#define _RAKNET_SUPPORT_UDPProxyClient 1 +#endif +#ifndef _RAKNET_SUPPORT_UDPProxyCoordinator +#define _RAKNET_SUPPORT_UDPProxyCoordinator 1 +#endif +#ifndef _RAKNET_SUPPORT_UDPProxyServer +#define _RAKNET_SUPPORT_UDPProxyServer 1 +#endif +#ifndef _RAKNET_SUPPORT_ConsoleServer +#define _RAKNET_SUPPORT_ConsoleServer 1 +#endif +#ifndef _RAKNET_SUPPORT_RakNetTransport +#define _RAKNET_SUPPORT_RakNetTransport 1 +#endif +#ifndef _RAKNET_SUPPORT_TelnetTransport +#define _RAKNET_SUPPORT_TelnetTransport 1 +#endif +#ifndef _RAKNET_SUPPORT_TCPInterface +#define _RAKNET_SUPPORT_TCPInterface 1 +#endif +#ifndef _RAKNET_SUPPORT_LogCommandParser +#define _RAKNET_SUPPORT_LogCommandParser 1 +#endif +#ifndef _RAKNET_SUPPORT_RakNetCommandParser +#define _RAKNET_SUPPORT_RakNetCommandParser 1 +#endif +#ifndef _RAKNET_SUPPORT_EmailSender +#define _RAKNET_SUPPORT_EmailSender 1 +#endif +#ifndef _RAKNET_SUPPORT_HTTPConnection +#define _RAKNET_SUPPORT_HTTPConnection 1 +#endif +#ifndef _RAKNET_SUPPORT_HTTPConnection2 +#define _RAKNET_SUPPORT_HTTPConnection2 1 +#endif +#ifndef _RAKNET_SUPPORT_PacketizedTCP +#define _RAKNET_SUPPORT_PacketizedTCP 1 +#endif +#ifndef _RAKNET_SUPPORT_TwoWayAuthentication +#define _RAKNET_SUPPORT_TwoWayAuthentication 1 +#endif +#ifndef _RAKNET_SUPPORT_CloudClient +#define _RAKNET_SUPPORT_CloudClient 1 +#endif +#ifndef _RAKNET_SUPPORT_CloudServer +#define _RAKNET_SUPPORT_CloudServer 1 +#endif +#ifndef _RAKNET_SUPPORT_DynDNS +#define _RAKNET_SUPPORT_DynDNS 1 +#endif +#ifndef _RAKNET_SUPPORT_Rackspace +#define _RAKNET_SUPPORT_Rackspace 1 +#endif +#ifndef _RAKNET_SUPPORT_FileOperations +#define _RAKNET_SUPPORT_FileOperations 1 +#endif +#ifndef _RAKNET_SUPPORT_UDPForwarder +#define _RAKNET_SUPPORT_UDPForwarder 1 +#endif +#ifndef _RAKNET_SUPPORT_StatisticsHistory +#define _RAKNET_SUPPORT_StatisticsHistory 1 +#endif +#ifndef _RAKNET_SUPPORT_LibVoice +#define _RAKNET_SUPPORT_LibVoice 0 +#endif +#ifndef _RAKNET_SUPPORT_RelayPlugin +#define _RAKNET_SUPPORT_RelayPlugin 1 +#endif + +// Take care of dependencies +#if _RAKNET_SUPPORT_DirectoryDeltaTransfer==1 +#undef _RAKNET_SUPPORT_FileListTransfer +#define _RAKNET_SUPPORT_FileListTransfer 1 +#endif +#if _RAKNET_SUPPORT_FullyConnectedMesh2==1 +#undef _RAKNET_SUPPORT_ConnectionGraph2 +#define _RAKNET_SUPPORT_ConnectionGraph2 1 +#endif +#if _RAKNET_SUPPORT_TelnetTransport==1 +#undef _RAKNET_SUPPORT_PacketizedTCP +#define _RAKNET_SUPPORT_PacketizedTCP 1 +#endif +#if _RAKNET_SUPPORT_PacketizedTCP==1 || _RAKNET_SUPPORT_EmailSender==1 || _RAKNET_SUPPORT_HTTPConnection==1 +#undef _RAKNET_SUPPORT_TCPInterface +#define _RAKNET_SUPPORT_TCPInterface 1 +#endif + + + + + + + + + + + + +#endif // __NATIVE_FEATURE_INCLDUES_H diff --git a/include/raknet/NativeFeatureIncludesOverrides.hpp b/include/raknet/NativeFeatureIncludesOverrides.hpp new file mode 100644 index 0000000..345d5ff --- /dev/null +++ b/include/raknet/NativeFeatureIncludesOverrides.hpp @@ -0,0 +1,19 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +// USER EDITABLE FILE +// See NativeFeatureIncludes.h + +#ifndef __NATIVE_FEATURE_INCLDUES_OVERRIDES_H +#define __NATIVE_FEATURE_INCLDUES_OVERRIDES_H + +//#define LIBCAT_SECURITY 1 + +#endif diff --git a/include/raknet/NativeTypes.hpp b/include/raknet/NativeTypes.hpp new file mode 100644 index 0000000..f1aa478 --- /dev/null +++ b/include/raknet/NativeTypes.hpp @@ -0,0 +1,33 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __NATIVE_TYPES_H +#define __NATIVE_TYPES_H + +#if defined(__GNUC__) || defined(__GCCXML__) || defined(__SNC__) || defined(__S3E__) +#include +#elif !defined(_STDINT_H) && !defined(_SN_STDINT_H) && !defined(_SYS_STDINT_H_) && !defined(_STDINT) && !defined(_MACHTYPES_H_) && !defined(_STDINT_H_) + typedef unsigned char uint8_t; + typedef unsigned short uint16_t; + typedef unsigned __int32 uint32_t; + typedef signed char int8_t; + typedef signed short int16_t; + typedef __int32 int32_t; + #if defined(_MSC_VER) && _MSC_VER < 1300 + typedef unsigned __int64 uint64_t; + typedef signed __int64 int64_t; + #else + typedef unsigned long long int uint64_t; + typedef signed long long int64_t; + #endif +#endif + + +#endif diff --git a/include/raknet/NetworkIDManager.hpp b/include/raknet/NetworkIDManager.hpp new file mode 100644 index 0000000..f59e7cc --- /dev/null +++ b/include/raknet/NetworkIDManager.hpp @@ -0,0 +1,80 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// + + +#ifndef __NETWORK_ID_MANAGER_H +#define __NETWORK_ID_MANAGER_H + +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "RakMemoryOverride.hpp" +#include "NetworkIDObject.hpp" +#include "Rand.hpp" + +namespace RakNet +{ + +/// Increase this value if you plan to have many persistent objects +/// This value must match on all systems +#define NETWORK_ID_MANAGER_HASH_LENGTH 1024 + +/// This class is simply used to generate a unique number for a group of instances of NetworkIDObject +/// An instance of this class is required to use the ObjectID to pointer lookup system +/// You should have one instance of this class per game instance. +/// Call SetIsNetworkIDAuthority before using any functions of this class, or of NetworkIDObject +class RAK_DLL_EXPORT NetworkIDManager +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(NetworkIDManager) + + NetworkIDManager(); + virtual ~NetworkIDManager(void); + + /// Returns the parent object, or this instance if you don't use a parent. + /// Supports NetworkIDObject anywhere in the inheritance hierarchy + /// \pre You must first call SetNetworkIDManager before using this function + template + returnType GET_OBJECT_FROM_ID(NetworkID x) { + NetworkIDObject *nio = GET_BASE_OBJECT_FROM_ID(x); + if (nio==0) + return 0; + if (nio->GetParent()) + return (returnType) nio->GetParent(); + return (returnType) nio; + } + + // Stop tracking all NetworkID objects + void Clear(void); + + /// \internal + NetworkIDObject *GET_BASE_OBJECT_FROM_ID(NetworkID x); + +protected: + /// \internal + void TrackNetworkIDObject(NetworkIDObject *networkIdObject); + void StopTrackingNetworkIDObject(NetworkIDObject *networkIdObject); + + friend class NetworkIDObject; + + NetworkIDObject *networkIdHash[NETWORK_ID_MANAGER_HASH_LENGTH]; + unsigned int NetworkIDToHashIndex(NetworkID networkId); + uint64_t startingOffset; + /// \internal + NetworkID GetNewNetworkID(void); + +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/NetworkIDObject.hpp b/include/raknet/NetworkIDObject.hpp new file mode 100644 index 0000000..306cc63 --- /dev/null +++ b/include/raknet/NetworkIDObject.hpp @@ -0,0 +1,89 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief A class you can derive from to make it easier to represent every networked object with an integer. This way you can refer to objects over the network. +/// + + +#if !defined(__NETWORK_ID_GENERATOR) +#define __NETWORK_ID_GENERATOR + +#include "RakNetTypes.hpp" +#include "RakMemoryOverride.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class NetworkIDManager; + +typedef uint32_t NetworkIDType; + +/// \brief Unique shared ids for each object instance +/// \details A class you can derive from to make it easier to represent every networked object with an integer. This way you can refer to objects over the network. +/// One system should return true for IsNetworkIDAuthority() and the rest should return false. When an object needs to be created, have the the one system create the object. +/// Then have that system send a message to all other systems, and include the value returned from GetNetworkID() in that packet. All other systems should then create the same +/// class of object, and call SetNetworkID() on that class with the NetworkID in the packet. +/// \see the manual for more information on this. +class RAK_DLL_EXPORT NetworkIDObject +{ +public: + // Constructor. NetworkIDs, if IsNetworkIDAuthority() is true, are created here. + NetworkIDObject(); + + // Destructor. Used NetworkIDs, if any, are freed here. + virtual ~NetworkIDObject(); + + /// Sets the manager class from which to request unique network IDs + /// Unlike previous versions, the NetworkIDObject relies on a manager class to provide IDs, rather than using statics, + /// So you can have more than one set of IDs on the same system. + virtual void SetNetworkIDManager( NetworkIDManager *manager); + + /// Returns what was passed to SetNetworkIDManager + virtual NetworkIDManager * GetNetworkIDManager( void ) const; + + /// Returns the NetworkID that you can use to refer to this object over the network. + /// \pre You must first call SetNetworkIDManager before using this function + /// \retval UNASSIGNED_NETWORK_ID UNASSIGNED_NETWORK_ID is returned IsNetworkIDAuthority() is false and SetNetworkID() was not previously called. This is also returned if you call this function in the constructor. + /// \retval 0-65534 Any other value is a valid NetworkID. NetworkIDs start at 0 and go to 65534, wrapping at that point. + virtual NetworkID GetNetworkID( void ); + + /// Sets the NetworkID for this instance. Usually this is called by the clients and determined from the servers. However, if you save multiplayer games you would likely use + /// This on load as well. + virtual void SetNetworkID( NetworkID id ); + + /// Your class does not have to derive from NetworkIDObject, although that is the easiest way to implement this. + /// If you want this to be a member object of another class, rather than inherit, then call SetParent() with a pointer to the parent class instance. + /// GET_OBJECT_FROM_ID will then return the parent rather than this instance. + virtual void SetParent( void *_parent ); + + /// Return what was passed to SetParent + /// \return The value passed to SetParent, or 0 if it was never called. + virtual void* GetParent( void ) const; + +protected: + + /// The network ID of this object + // networkID is assigned when networkIDManager is set. + NetworkID networkID; + NetworkIDManager *networkIDManager; + + /// The parent set by SetParent() + void *parent; + + /// \internal, used by NetworkIDManager + friend class NetworkIDManager; + NetworkIDObject *nextInstanceForNetworkIDManager; +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/PS3Includes.hpp b/include/raknet/PS3Includes.hpp new file mode 100644 index 0000000..1d60d89 --- /dev/null +++ b/include/raknet/PS3Includes.hpp @@ -0,0 +1,75 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/include/raknet/PS4Includes.hpp b/include/raknet/PS4Includes.hpp new file mode 100644 index 0000000..db9976f --- /dev/null +++ b/include/raknet/PS4Includes.hpp @@ -0,0 +1,46 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/include/raknet/PacketConsoleLogger.hpp b/include/raknet/PacketConsoleLogger.hpp new file mode 100644 index 0000000..990a6cd --- /dev/null +++ b/include/raknet/PacketConsoleLogger.hpp @@ -0,0 +1,45 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief This will write all incoming and outgoing network messages to the log command parser, which can be accessed through Telnet +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_LogCommandParser==1 && _RAKNET_SUPPORT_PacketLogger==1 + +#ifndef __PACKET_CONSOLE_LOGGER_H_ +#define __PACKET_CONSOLE_LOGGER_H_ + +#include "PacketLogger.hpp" + +namespace RakNet +{ +/// Forward declarations +class LogCommandParser; + +/// \ingroup PACKETLOGGER_GROUP +/// \brief Packetlogger that logs to a remote command console +class RAK_DLL_EXPORT PacketConsoleLogger : public PacketLogger +{ +public: + PacketConsoleLogger(); + // Writes to the command parser used for logging, which is accessed through a secondary communication layer (such as Telnet or RakNet) - See ConsoleServer.h + virtual void SetLogCommandParser(LogCommandParser *lcp); + virtual void WriteLog(const char *str); +protected: + LogCommandParser *logCommandParser; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/PacketFileLogger.hpp b/include/raknet/PacketFileLogger.hpp new file mode 100644 index 0000000..f2ff923 --- /dev/null +++ b/include/raknet/PacketFileLogger.hpp @@ -0,0 +1,45 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief This will write all incoming and outgoing network messages to a file +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_PacketLogger==1 + +#ifndef __PACKET_FILE_LOGGER_H_ +#define __PACKET_FILE_LOGGER_H_ + +#include "PacketLogger.hpp" +#include + +namespace RakNet +{ + +/// \ingroup PACKETLOGGER_GROUP +/// \brief Packetlogger that outputs to a file +class RAK_DLL_EXPORT PacketFileLogger : public PacketLogger +{ +public: + PacketFileLogger(); + virtual ~PacketFileLogger(); + void StartLog(const char *filenamePrefix); + virtual void WriteLog(const char *str); +protected: + FILE *packetLogFile; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/PacketLogger.hpp b/include/raknet/PacketLogger.hpp new file mode 100644 index 0000000..2a319c3 --- /dev/null +++ b/include/raknet/PacketLogger.hpp @@ -0,0 +1,109 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief This will write all incoming and outgoing network messages to the local console screen. See derived functions for other outputs +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_PacketLogger==1 + +#ifndef __PACKET_LOGGER_H +#define __PACKET_LOGGER_H + +#include "RakNetTypes.hpp" +#include "PluginInterface2.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \defgroup PACKETLOGGER_GROUP PacketLogger +/// \brief Print out incoming messages to a target destination +/// \details +/// \ingroup PLUGINS_GROUP + +/// \brief Writes incoming and outgoing messages to the screen. +/// This will write all incoming and outgoing messages to the console window, or to a file if you override it and give it this functionality. +/// \ingroup PACKETLOGGER_GROUP +class RAK_DLL_EXPORT PacketLogger : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(PacketLogger) + + PacketLogger(); + virtual ~PacketLogger(); + + // Translate the supplied parameters into an output line - overloaded version that takes a MessageIdentifier + // and translates it into a string (numeric or textual representation based on printId); this calls the + // second version which takes a const char* argument for the messageIdentifier + virtual void FormatLine(char* into, const char* dir, const char* type, unsigned int reliableMessageNumber, unsigned int frame + , unsigned char messageIdentifier, const BitSize_t bitLen, unsigned long long time, const SystemAddress& local, const SystemAddress& remote, + unsigned int splitPacketId, unsigned int splitPacketIndex, unsigned int splitPacketCount, unsigned int orderingIndex); + virtual void FormatLine(char* into, const char* dir, const char* type, unsigned int reliableMessageNumber, unsigned int frame + , const char* idToPrint, const BitSize_t bitLen, unsigned long long time, const SystemAddress& local, const SystemAddress& remote, + unsigned int splitPacketId, unsigned int splitPacketIndex, unsigned int splitPacketCount, unsigned int orderingIndex); + + /// Events on low level sends and receives. These functions may be called from different threads at the same time. + virtual void OnDirectSocketSend(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress); + virtual void OnDirectSocketReceive(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress); + virtual void OnReliabilityLayerNotification(const char *errorMessage, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress, bool isError); + virtual void OnInternalPacket(InternalPacket *internalPacket, unsigned frameNumber, SystemAddress remoteSystemAddress, RakNet::TimeMS time, int isSend); + virtual void OnAck(unsigned int messageNumber, SystemAddress remoteSystemAddress, RakNet::TimeMS time); + virtual void OnPushBackPacket(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress); + + /// Logs out a header for all the data + virtual void LogHeader(void); + + /// Override this to log strings to wherever. Log should be threadsafe + virtual void WriteLog(const char *str); + + // Write informational messages + virtual void WriteMiscellaneous(const char *type, const char *msg); + + + // Set to true to print ID_* instead of numbers + virtual void SetPrintID(bool print); + // Print or hide acks (clears up the screen not to print them but is worse for debugging) + virtual void SetPrintAcks(bool print); + + /// Prepend this string to output logs. + virtual void SetPrefix(const char *_prefix); + + /// Append this string to output logs. (newline is useful here) + virtual void SetSuffix(const char *_suffix); + static const char* BaseIDTOString(unsigned char Id); + + /// Log the direct sends and receives or not. Default true + void SetLogDirectMessages(bool send); +protected: + + virtual bool UsesReliabilityLayer(void) const {return true;} + const char* IDTOString(unsigned char Id); + virtual void AddToLog(const char *str); + // Users should override this + virtual const char* UserIDTOString(unsigned char Id); + void GetLocalTime(char buffer[128]); + bool logDirectMessages; + + bool printId, printAcks; + char prefix[256]; + char suffix[256]; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/PacketOutputWindowLogger.hpp b/include/raknet/PacketOutputWindowLogger.hpp new file mode 100644 index 0000000..c066d80 --- /dev/null +++ b/include/raknet/PacketOutputWindowLogger.hpp @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief This will write all incoming and outgoing network messages to a file +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_PacketLogger==1 + +#ifndef __PACKET_OUTPUT_WINDOW_LOGGER_H_ +#define __PACKET_OUTPUT_WINDOW_LOGGER_H_ + +#include "PacketLogger.hpp" + +namespace RakNet +{ + +/// \ingroup PACKETLOGGER_GROUP +/// \brief Packetlogger that outputs to the output window in the debugger. Windows only. +class RAK_DLL_EXPORT PacketOutputWindowLogger : public PacketLogger +{ +public: + PacketOutputWindowLogger(); + virtual ~PacketOutputWindowLogger(); + virtual void WriteLog(const char *str); +protected: +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/PacketPool.hpp b/include/raknet/PacketPool.hpp new file mode 100644 index 0000000..b534cac --- /dev/null +++ b/include/raknet/PacketPool.hpp @@ -0,0 +1 @@ +// REMOVEME \ No newline at end of file diff --git a/include/raknet/PacketPriority.hpp b/include/raknet/PacketPriority.hpp new file mode 100644 index 0000000..973c304 --- /dev/null +++ b/include/raknet/PacketPriority.hpp @@ -0,0 +1,87 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief This file contains enumerations for packet priority and reliability enumerations. +/// + + + +#ifndef __PACKET_PRIORITY_H +#define __PACKET_PRIORITY_H + +/// These enumerations are used to describe when packets are delivered. +enum PacketPriority +{ + /// The highest possible priority. These message trigger sends immediately, and are generally not buffered or aggregated into a single datagram. + IMMEDIATE_PRIORITY, + + /// For every 2 IMMEDIATE_PRIORITY messages, 1 HIGH_PRIORITY will be sent. + /// Messages at this priority and lower are buffered to be sent in groups at 10 millisecond intervals to reduce UDP overhead and better measure congestion control. + HIGH_PRIORITY, + + /// For every 2 HIGH_PRIORITY messages, 1 MEDIUM_PRIORITY will be sent. + /// Messages at this priority and lower are buffered to be sent in groups at 10 millisecond intervals to reduce UDP overhead and better measure congestion control. + MEDIUM_PRIORITY, + + /// For every 2 MEDIUM_PRIORITY messages, 1 LOW_PRIORITY will be sent. + /// Messages at this priority and lower are buffered to be sent in groups at 10 millisecond intervals to reduce UDP overhead and better measure congestion control. + LOW_PRIORITY, + + /// \internal + NUMBER_OF_PRIORITIES +}; + +/// These enumerations are used to describe how packets are delivered. +/// \note Note to self: I write this with 3 bits in the stream. If I add more remember to change that +/// \note In ReliabilityLayer::WriteToBitStreamFromInternalPacket I assume there are 5 major types +/// \note Do not reorder, I check on >= UNRELIABLE_WITH_ACK_RECEIPT +enum PacketReliability +{ + /// Same as regular UDP, except that it will also discard duplicate datagrams. RakNet adds (6 to 17) + 21 bits of overhead, 16 of which is used to detect duplicate packets and 6 to 17 of which is used for message length. + UNRELIABLE, + + /// Regular UDP with a sequence counter. Out of order messages will be discarded. + /// Sequenced and ordered messages sent on the same channel will arrive in the order sent. + UNRELIABLE_SEQUENCED, + + /// The message is sent reliably, but not necessarily in any order. Same overhead as UNRELIABLE. + RELIABLE, + + /// This message is reliable and will arrive in the order you sent it. Messages will be delayed while waiting for out of order messages. Same overhead as UNRELIABLE_SEQUENCED. + /// Sequenced and ordered messages sent on the same channel will arrive in the order sent. + RELIABLE_ORDERED, + + /// This message is reliable and will arrive in the sequence you sent it. Out or order messages will be dropped. Same overhead as UNRELIABLE_SEQUENCED. + /// Sequenced and ordered messages sent on the same channel will arrive in the order sent. + RELIABLE_SEQUENCED, + + /// Same as UNRELIABLE, however the user will get either ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS based on the result of sending this message when calling RakPeerInterface::Receive(). Bytes 1-4 will contain the number returned from the Send() function. On disconnect or shutdown, all messages not previously acked should be considered lost. + UNRELIABLE_WITH_ACK_RECEIPT, + + /// Same as UNRELIABLE_SEQUENCED, however the user will get either ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS based on the result of sending this message when calling RakPeerInterface::Receive(). Bytes 1-4 will contain the number returned from the Send() function. On disconnect or shutdown, all messages not previously acked should be considered lost. + /// 05/04/10 You can't have sequenced and ack receipts, because you don't know if the other system discarded the message, meaning you don't know if the message was processed + // UNRELIABLE_SEQUENCED_WITH_ACK_RECEIPT, + + /// Same as RELIABLE. The user will also get ID_SND_RECEIPT_ACKED after the message is delivered when calling RakPeerInterface::Receive(). ID_SND_RECEIPT_ACKED is returned when the message arrives, not necessarily the order when it was sent. Bytes 1-4 will contain the number returned from the Send() function. On disconnect or shutdown, all messages not previously acked should be considered lost. This does not return ID_SND_RECEIPT_LOSS. + RELIABLE_WITH_ACK_RECEIPT, + + /// Same as RELIABLE_ORDERED_ACK_RECEIPT. The user will also get ID_SND_RECEIPT_ACKED after the message is delivered when calling RakPeerInterface::Receive(). ID_SND_RECEIPT_ACKED is returned when the message arrives, not necessarily the order when it was sent. Bytes 1-4 will contain the number returned from the Send() function. On disconnect or shutdown, all messages not previously acked should be considered lost. This does not return ID_SND_RECEIPT_LOSS. + RELIABLE_ORDERED_WITH_ACK_RECEIPT, + + /// Same as RELIABLE_SEQUENCED. The user will also get ID_SND_RECEIPT_ACKED after the message is delivered when calling RakPeerInterface::Receive(). Bytes 1-4 will contain the number returned from the Send() function. On disconnect or shutdown, all messages not previously acked should be considered lost. + /// 05/04/10 You can't have sequenced and ack receipts, because you don't know if the other system discarded the message, meaning you don't know if the message was processed + // RELIABLE_SEQUENCED_WITH_ACK_RECEIPT, + + /// \internal + NUMBER_OF_RELIABILITIES +}; + +#endif diff --git a/include/raknet/PacketizedTCP.hpp b/include/raknet/PacketizedTCP.hpp new file mode 100644 index 0000000..623b37c --- /dev/null +++ b/include/raknet/PacketizedTCP.hpp @@ -0,0 +1,86 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief A simple TCP based server allowing sends and receives. Can be connected by any TCP client, including telnet. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_PacketizedTCP==1 && _RAKNET_SUPPORT_TCPInterface==1 + +#ifndef __PACKETIZED_TCP +#define __PACKETIZED_TCP + +#include "TCPInterface.hpp" +#include "DS_ByteQueue.hpp" +#include "DS_Map.hpp" + +namespace RakNet +{ + +class RAK_DLL_EXPORT PacketizedTCP : public TCPInterface +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(PacketizedTCP) + + PacketizedTCP(); + virtual ~PacketizedTCP(); + + /// Stops the TCP server + void Stop(void); + + /// Sends a byte stream + void Send( const char *data, unsigned length, const SystemAddress &systemAddress, bool broadcast ); + + // Sends a concatenated list of byte streams + bool SendList( const char **data, const unsigned int *lengths, const int numParameters, const SystemAddress &systemAddress, bool broadcast ); + + /// Returns data received + Packet* Receive( void ); + + /// Disconnects a player/address + void CloseConnection( SystemAddress systemAddress ); + + /// Has a previous call to connect succeeded? + /// \return UNASSIGNED_SYSTEM_ADDRESS = no. Anything else means yes. + SystemAddress HasCompletedConnectionAttempt(void); + + /// Has a previous call to connect failed? + /// \return UNASSIGNED_SYSTEM_ADDRESS = no. Anything else means yes. + SystemAddress HasFailedConnectionAttempt(void); + + /// Queued events of new incoming connections + SystemAddress HasNewIncomingConnection(void); + + /// Queued events of lost connections + SystemAddress HasLostConnection(void); + +protected: + void ClearAllConnections(void); + void RemoveFromConnectionList(const SystemAddress &sa); + void AddToConnectionList(const SystemAddress &sa); + void PushNotificationsToQueues(void); + Packet *ReturnOutgoingPacket(void); + + // A single TCP recieve may generate multiple split packets. They are stored in the waitingPackets list until Receive is called + DataStructures::Queue waitingPackets; + DataStructures::Map connections; + + // Mirrors single producer / consumer, but processes them in Receive() before returning to user + DataStructures::Queue _newIncomingConnections, _lostConnections, _failedConnectionAttempts, _completedConnectionAttempts; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/PluginInterface2.hpp b/include/raknet/PluginInterface2.hpp new file mode 100644 index 0000000..a6e7f2e --- /dev/null +++ b/include/raknet/PluginInterface2.hpp @@ -0,0 +1,211 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b RakNet's plugin functionality system, version 2. You can derive from this to create your own plugins. +/// + + +#ifndef __PLUGIN_INTERFACE_2_H +#define __PLUGIN_INTERFACE_2_H + +#include "NativeFeatureIncludes.hpp" +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "PacketPriority.hpp" + +namespace RakNet { + +/// Forward declarations +class RakPeerInterface; +class TCPInterface; +struct Packet; +struct InternalPacket; + +/// \defgroup PLUGIN_INTERFACE_GROUP PluginInterface2 + +/// \defgroup PLUGINS_GROUP Plugins +/// \ingroup PLUGIN_INTERFACE_GROUP + +/// For each message that arrives on an instance of RakPeer, the plugins get an opportunity to process them first. This enumeration represents what to do with the message +/// \ingroup PLUGIN_INTERFACE_GROUP +enum PluginReceiveResult +{ + /// The plugin used this message and it shouldn't be given to the user. + RR_STOP_PROCESSING_AND_DEALLOCATE=0, + + /// This message will be processed by other plugins, and at last by the user. + RR_CONTINUE_PROCESSING, + + /// The plugin is going to hold on to this message. Do not deallocate it but do not pass it to other plugins either. + RR_STOP_PROCESSING +}; + +/// Reasons why a connection was lost +/// \ingroup PLUGIN_INTERFACE_GROUP +enum PI2_LostConnectionReason +{ + /// Called RakPeer::CloseConnection() + LCR_CLOSED_BY_USER, + + /// Got ID_DISCONNECTION_NOTIFICATION + LCR_DISCONNECTION_NOTIFICATION, + + /// GOT ID_CONNECTION_LOST + LCR_CONNECTION_LOST +}; + +/// Returns why a connection attempt failed +/// \ingroup PLUGIN_INTERFACE_GROUP +enum PI2_FailedConnectionAttemptReason +{ + FCAR_CONNECTION_ATTEMPT_FAILED, + FCAR_ALREADY_CONNECTED, + FCAR_NO_FREE_INCOMING_CONNECTIONS, + FCAR_SECURITY_PUBLIC_KEY_MISMATCH, + FCAR_CONNECTION_BANNED, + FCAR_INVALID_PASSWORD, + FCAR_INCOMPATIBLE_PROTOCOL, + FCAR_IP_RECENTLY_CONNECTED, + FCAR_REMOTE_SYSTEM_REQUIRES_PUBLIC_KEY, + FCAR_OUR_SYSTEM_REQUIRES_SECURITY, + FCAR_PUBLIC_KEY_MISMATCH +}; + +/// RakNet's plugin system. Each plugin processes the following events: +/// -Connection attempts +/// -The result of connection attempts +/// -Each incoming message +/// -Updates over time, when RakPeer::Receive() is called +/// +/// \ingroup PLUGIN_INTERFACE_GROUP +class RAK_DLL_EXPORT PluginInterface2 +{ +public: + PluginInterface2(); + virtual ~PluginInterface2(); + + /// Called when the interface is attached + virtual void OnAttach(void) {} + + /// Called when the interface is detached + virtual void OnDetach(void) {} + + /// Update is called every time a packet is checked for . + virtual void Update(void) {} + + /// OnReceive is called for every packet. + /// \param[in] packet the packet that is being returned to the user + /// \return True to allow the game and other plugins to get this message, false to absorb it + virtual PluginReceiveResult OnReceive(Packet *packet) {(void) packet; return RR_CONTINUE_PROCESSING;} + + /// Called when RakPeer is initialized + virtual void OnRakPeerStartup(void) {} + + /// Called when RakPeer is shutdown + virtual void OnRakPeerShutdown(void) {} + + /// Called when a connection is dropped because the user called RakPeer::CloseConnection() for a particular system + /// \param[in] systemAddress The system whose connection was closed + /// \param[in] rakNetGuid The guid of the specified system + /// \param[in] lostConnectionReason How the connection was closed: manually, connection lost, or notification of disconnection + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ){(void) systemAddress; (void) rakNetGUID; (void) lostConnectionReason;} + + /// Called when we got a new connection + /// \param[in] systemAddress Address of the new connection + /// \param[in] rakNetGuid The guid of the specified system + /// \param[in] isIncoming If true, this is ID_NEW_INCOMING_CONNECTION, or the equivalent + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming) {(void) systemAddress; (void) rakNetGUID; (void) isIncoming;} + + /// Called when a connection attempt fails + /// \param[in] packet Packet to be returned to the user + /// \param[in] failedConnectionReason Why the connection failed + virtual void OnFailedConnectionAttempt(Packet *packet, PI2_FailedConnectionAttemptReason failedConnectionAttemptReason) {(void) packet; (void) failedConnectionAttemptReason;} + + /// Queried when attached to RakPeer + /// Return true to call OnDirectSocketSend(), OnDirectSocketReceive(), OnReliabilityLayerNotification(), OnInternalPacket(), and OnAck() + /// If true, then you cannot call RakPeer::AttachPlugin() or RakPeer::DetachPlugin() for this plugin, while RakPeer is active + virtual bool UsesReliabilityLayer(void) const {return false;} + + /// Called on a send to the socket, per datagram, that does not go through the reliability layer + /// \pre To be called, UsesReliabilityLayer() must return true + /// \param[in] data The data being sent + /// \param[in] bitsUsed How many bits long \a data is + /// \param[in] remoteSystemAddress Which system this message is being sent to + virtual void OnDirectSocketSend(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress) {(void) data; (void) bitsUsed; (void) remoteSystemAddress;} + + /// Called on a receive from the socket, per datagram, that does not go through the reliability layer + /// \pre To be called, UsesReliabilityLayer() must return true + /// \param[in] data The data being sent + /// \param[in] bitsUsed How many bits long \a data is + /// \param[in] remoteSystemAddress Which system this message is being sent to + virtual void OnDirectSocketReceive(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress) {(void) data; (void) bitsUsed; (void) remoteSystemAddress;} + + /// Called when the reliability layer rejects a send or receive + /// \pre To be called, UsesReliabilityLayer() must return true + /// \param[in] bitsUsed How many bits long \a data is + /// \param[in] remoteSystemAddress Which system this message is being sent to + virtual void OnReliabilityLayerNotification(const char *errorMessage, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress, bool isError) {(void) errorMessage; (void) bitsUsed; (void) remoteSystemAddress; (void) isError;} + + /// Called on a send or receive of a message within the reliability layer + /// \pre To be called, UsesReliabilityLayer() must return true + /// \param[in] internalPacket The user message, along with all send data. + /// \param[in] frameNumber The number of frames sent or received so far for this player depending on \a isSend . Indicates the frame of this user message. + /// \param[in] remoteSystemAddress The player we sent or got this packet from + /// \param[in] time The current time as returned by RakNet::GetTimeMS() + /// \param[in] isSend Is this callback representing a send event or receive event? + virtual void OnInternalPacket(InternalPacket *internalPacket, unsigned frameNumber, SystemAddress remoteSystemAddress, RakNet::TimeMS time, int isSend) {(void) internalPacket; (void) frameNumber; (void) remoteSystemAddress; (void) time; (void) isSend;} + + /// Called when we get an ack for a message we reliably sent + /// \pre To be called, UsesReliabilityLayer() must return true + /// \param[in] messageNumber The numerical identifier for which message this is + /// \param[in] remoteSystemAddress The player we sent or got this packet from + /// \param[in] time The current time as returned by RakNet::GetTimeMS() + virtual void OnAck(unsigned int messageNumber, SystemAddress remoteSystemAddress, RakNet::TimeMS time) {(void) messageNumber; (void) remoteSystemAddress; (void) time;} + + /// System called RakPeerInterface::PushBackPacket + /// \param[in] data The data being sent + /// \param[in] bitsUsed How many bits long \a data is + /// \param[in] remoteSystemAddress The player we sent or got this packet from + virtual void OnPushBackPacket(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress) {(void) data; (void) bitsUsed; (void) remoteSystemAddress;} + + RakPeerInterface *GetRakPeerInterface(void) const {return rakPeerInterface;} + + RakNetGUID GetMyGUIDUnified(void) const; + + /// \internal + void SetRakPeerInterface( RakPeerInterface *ptr ); + +#if _RAKNET_SUPPORT_TCPInterface==1 + /// \internal + void SetTCPInterface( TCPInterface *ptr ); +#endif + +protected: + // Send through either rakPeerInterface or tcpInterface, whichever is available + void SendUnified( const RakNet::BitStream * bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast ); + void SendUnified( const char * data, const int length, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast ); + bool SendListUnified( const char **data, const int *lengths, const int numParameters, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast ); + + Packet *AllocatePacketUnified(unsigned dataSize); + void PushBackPacketUnified(Packet *packet, bool pushAtHead); + void DeallocPacketUnified(Packet *packet); + + // Filled automatically in when attached + RakPeerInterface *rakPeerInterface; +#if _RAKNET_SUPPORT_TCPInterface==1 + TCPInterface *tcpInterface; +#endif +}; + +} // namespace RakNet + +#endif + diff --git a/include/raknet/RPC4Plugin.hpp b/include/raknet/RPC4Plugin.hpp new file mode 100644 index 0000000..21a4511 --- /dev/null +++ b/include/raknet/RPC4Plugin.hpp @@ -0,0 +1,244 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Remote procedure call, supporting C functions only. No external dependencies required. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_RPC4Plugin==1 + +#ifndef __RPC_4_PLUGIN_H +#define __RPC_4_PLUGIN_H + +#include "PluginInterface2.hpp" +#include "PacketPriority.hpp" +#include "RakNetTypes.hpp" +#include "BitStream.hpp" +#include "RakString.hpp" +#include "NetworkIDObject.hpp" +#include "DS_Hash.hpp" +#include "DS_OrderedList.hpp" + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +/// \defgroup RPC_PLUGIN_GROUP RPC +/// \brief Remote procedure calls, without external dependencies. +/// \details This should not be used at the same time as RPC3. This is a less functional version of RPC3, and is here for users that do not want the Boost dependency of RPC3. +/// \ingroup PLUGINS_GROUP + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; +class NetworkIDManager; + + /// \brief Error codes returned by a remote system as to why an RPC function call cannot execute + /// \details Error code follows packet ID ID_RPC_REMOTE_ERROR, that is packet->data[1]
+ /// Name of the function will be appended starting at packet->data[2] + /// \ingroup RPC_PLUGIN_GROUP + enum RPCErrorCodes + { + /// Named function was not registered with RegisterFunction(). Check your spelling. + RPC_ERROR_FUNCTION_NOT_REGISTERED, + }; + + /// \brief Instantiate this class globally if you want to register a function with RPC4 at the global space + class RAK_DLL_EXPORT RPC4GlobalRegistration + { + public: + /// \brief Queue a call to RPC4::RegisterFunction() globally. Actual call occurs once RPC4 is attached to an instance of RakPeer or TCPInterface. + RPC4GlobalRegistration(const char* uniqueID, void ( *functionPointer ) ( RakNet::BitStream *userData, Packet *packet )); + + /// \brief Queue a call to RPC4::RegisterSlot() globally. Actual call occurs once RPC4 is attached to an instance of RakPeer or TCPInterface. + RPC4GlobalRegistration(const char* uniqueID, void ( *functionPointer ) ( RakNet::BitStream *userData, Packet *packet ), int callPriority); + + /// \brief Queue a call to RPC4::RegisterBlockingFunction() globally. Actual call occurs once RPC4 is attached to an instance of RakPeer or TCPInterface. + RPC4GlobalRegistration(const char* uniqueID, void ( *functionPointer ) ( RakNet::BitStream *userData, RakNet::BitStream *returnData, Packet *packet )); + + /// \brief Queue a call to RPC4::RegisterLocalCallback() globally. Actual call occurs once RPC4 is attached to an instance of RakPeer or TCPInterface. + RPC4GlobalRegistration(const char* uniqueID, MessageID messageId); + }; + + /// \brief The RPC4 plugin is just an association between a C function pointer and a string. + /// \details It is for users that want to use RPC, but do not want to use boost. + /// You do not have the automatic serialization or other features of RPC3, and C++ member calls are not supported. + /// \note You cannot use RPC4 at the same time as RPC3Plugin + /// \ingroup RPC_PLUGIN_GROUP + class RAK_DLL_EXPORT RPC4 : public PluginInterface2 + { + public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(RPC4) + + // Constructor + RPC4(); + + // Destructor + virtual ~RPC4(); + + /// \deprecated Use RegisterSlot + /// \brief Register a function pointer to be callable from a remote system + /// \details The hash of the function name will be stored as an association with the function pointer + /// When a call is made to call this function from the \a Call() or CallLoopback() function, the function pointer will be invoked with the passed bitStream to Call() and the actual Packet that RakNet got. + /// \sa RegisterPacketCallback() + /// \param[in] uniqueID Identifier to be associated with \a functionPointer. If this identifier is already in use, the call will return false. + /// \param[in] functionPointer C function pointer to be called + /// \return True if the hash of uniqueID is not in use, false otherwise. + bool RegisterFunction(const char* uniqueID, void ( *functionPointer ) ( RakNet::BitStream *userData, Packet *packet )); + + /// Register a slot, which is a function pointer to one or more implementations that supports this function signature + /// When a signal occurs, all slots with the same identifier are called. + /// \param[in] sharedIdentifier A string to identify the slot. Recommended to be the same as the name of the function. + /// \param[in] functionPtr Pointer to the function. For C, just pass the name of the function. For C++, use ARPC_REGISTER_CPP_FUNCTION + /// \param[in] callPriority Slots are called by order of the highest callPriority first. For slots with the same priority, they are called in the order they are registered + void RegisterSlot(const char *sharedIdentifier, void ( *functionPointer ) ( RakNet::BitStream *userData, Packet *packet ), int callPriority); + + /// \brief Same as \a RegisterFunction, but is called with CallBlocking() instead of Call() and returns a value to the caller + bool RegisterBlockingFunction(const char* uniqueID, void ( *functionPointer ) ( RakNet::BitStream *userData, RakNet::BitStream *returnData, Packet *packet )); + + /// \deprecated Use RegisterSlot and invoke on self only when the packet you want arrives + /// When a RakNet Packet with the specified identifier is returned, execute CallLoopback() on a function previously registered with RegisterFunction() + /// For example, you could call "OnClosedConnection" whenever you get ID_DISCONNECTION_NOTIFICATION or ID_CONNECTION_LOST + /// \param[in] uniqueID Identifier passed to RegisterFunction() + /// \param[in] messageId What RakNet packet ID to call on, for example ID_DISCONNECTION_NOTIFICATION or ID_CONNECTION_LOST + void RegisterLocalCallback(const char* uniqueID, MessageID messageId); + + /// \brief Unregister a function pointer previously registered with RegisterFunction() + /// \param[in] Identifier originally passed to RegisterFunction() + /// \return True if the hash of uniqueID was in use, and hence removed. false otherwise. + bool UnregisterFunction(const char* uniqueID); + + /// \brief Same as UnregisterFunction, except for a blocking function + bool UnregisterBlockingFunction(const char* uniqueID); + + /// Remove the association created with RegisterPacketCallback() + /// \param[in] uniqueID Identifier passed as uniqueID to RegisterLocalCallback() + /// \param[in] messageId Identifier passed as messageId to RegisterLocalCallback() + /// \return True if the combination of uniqueID and messageId was in use, and hence removed + bool UnregisterLocalCallback(const char* uniqueID, MessageID messageId); + + /// Remove the association created with RegisterSlot() + /// \param[in] sharedIdentifier Identifier passed as sharedIdentifier to RegisterSlot() + bool UnregisterSlot(const char* sharedIdentifier); + + /// \deprecated Use RegisterSlot() and Signal() with your own RakNetGUID as the send target + /// Send to the attached instance of RakPeer. See RakPeerInterface::SendLoopback() + /// \param[in] Identifier originally passed to RegisterFunction() on the local system + /// \param[in] bitStream bitStream encoded data to send to the function callback + void CallLoopback( const char* uniqueID, RakNet::BitStream * bitStream ); + + /// \deprecated, use Signal() + /// Send to the specified remote instance of RakPeer. + /// \param[in] uniqueID Identifier originally passed to RegisterFunction() on the remote system(s) + /// \param[in] bitStream bitStream encoded data to send to the function callback + /// \param[in] priority See RakPeerInterface::Send() + /// \param[in] reliability See RakPeerInterface::Send() + /// \param[in] orderingChannel See RakPeerInterface::Send() + /// \param[in] systemIdentifier See RakPeerInterface::Send() + /// \param[in] broadcast See RakPeerInterface::Send() + void Call( const char* uniqueID, RakNet::BitStream * bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast ); + + /// \brief Same as call, but don't return until the remote system replies. + /// Broadcasting parameter does not exist, this can only call one remote system + /// \note This function does not return until the remote system responds, disconnects, or was never connected to begin with + /// \param[in] Identifier originally passed to RegisterBlockingFunction() on the remote system(s) + /// \param[in] bitStream bitStream encoded data to send to the function callback + /// \param[in] priority See RakPeerInterface::Send() + /// \param[in] reliability See RakPeerInterface::Send() + /// \param[in] orderingChannel See RakPeerInterface::Send() + /// \param[in] systemIdentifier See RakPeerInterface::Send() + /// \param[out] returnData Written to by the function registered with RegisterBlockingFunction. + /// \return true if successfully called. False on disconnect, function not registered, or not connected to begin with + bool CallBlocking( const char* uniqueID, RakNet::BitStream * bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, RakNet::BitStream *returnData ); + + /// Calls zero or more functions identified by sharedIdentifier registered with RegisterSlot() + /// \param[in] sharedIdentifier parameter of the same name passed to RegisterSlot() on the remote system + /// \param[in] bitStream bitStream encoded data to send to the function callback + /// \param[in] priority See RakPeerInterface::Send() + /// \param[in] reliability See RakPeerInterface::Send() + /// \param[in] orderingChannel See RakPeerInterface::Send() + /// \param[in] systemIdentifier See RakPeerInterface::Send() + /// \param[in] broadcast See RakPeerInterface::Send() + /// \param[in] invokeLocal If true, also sends to self. + void Signal(const char *sharedIdentifier, RakNet::BitStream * bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, bool invokeLocal); + + /// If called while processing a slot, no further slots for the currently executing signal will be executed + void InterruptSignal(void); + + /// \internal + struct LocalCallback + { + MessageID messageId; + DataStructures::OrderedList functions; + }; + static int LocalCallbackComp(const MessageID &key, LocalCallback* const &data ); + + /// \internal + // Callable object, along with priority to call relative to other objects + struct LocalSlotObject + { + LocalSlotObject() {} + LocalSlotObject(unsigned int _registrationCount,int _callPriority, void ( *_functionPointer ) ( RakNet::BitStream *userData, Packet *packet )) + {registrationCount=_registrationCount;callPriority=_callPriority;functionPointer=_functionPointer;} + ~LocalSlotObject() {} + + // Used so slots are called in the order they are registered + unsigned int registrationCount; + int callPriority; + void ( *functionPointer ) ( RakNet::BitStream *userData, Packet *packet ); + }; + + static int LocalSlotObjectComp( const LocalSlotObject &key, const LocalSlotObject &data ); + + /// \internal + struct LocalSlot + { + DataStructures::OrderedList slotObjects; + }; + DataStructures::Hash localSlots; + + protected: + + // -------------------------------------------------------------------------------------------- + // Packet handling functions + // -------------------------------------------------------------------------------------------- + virtual void OnAttach(void); + virtual PluginReceiveResult OnReceive(Packet *packet); + + DataStructures::Hash registeredNonblockingFunctions; + DataStructures::Hash registeredBlockingFunctions; + DataStructures::OrderedList localCallbacks; + + RakNet::BitStream blockingReturnValue; + bool gotBlockingReturnValue; + + DataStructures::HashIndex GetLocalSlotIndex(const char *sharedIdentifier); + + /// Used so slots are called in the order they are registered + unsigned int nextSlotRegistrationCount; + + bool interruptSignal; + + void InvokeSignal(DataStructures::HashIndex functionIndex, RakNet::BitStream *serializedParameters, Packet *packet); + }; + +} // End namespace + +#endif + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/Rackspace.hpp b/include/raknet/Rackspace.hpp new file mode 100644 index 0000000..54ba0cc --- /dev/null +++ b/include/raknet/Rackspace.hpp @@ -0,0 +1,413 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file Rackspace.h +/// \brief Helper to class to manage Rackspace servers +/// + + +#include "NativeFeatureIncludes.hpp" + +#if _RAKNET_SUPPORT_Rackspace==1 && _RAKNET_SUPPORT_TCPInterface==1 + +#include "Export.hpp" +#include "DS_List.hpp" +#include "RakNetTypes.hpp" +#include "DS_Queue.hpp" +#include "RakString.hpp" + +#ifndef __RACKSPACE_H +#define __RACKSPACE_H + +namespace RakNet +{ + + class TCPInterface; + struct Packet; + + /// \brief Result codes for Rackspace commands + /// /sa Rackspace::EventTypeToString() + enum RackspaceEventType + { + RET_Success_200, + RET_Success_201, + RET_Success_202, + RET_Success_203, + RET_Success_204, + RET_Cloud_Servers_Fault_500, + RET_Service_Unavailable_503, + RET_Unauthorized_401, + RET_Bad_Request_400, + RET_Over_Limit_413, + RET_Bad_Media_Type_415, + RET_Item_Not_Found_404, + RET_Build_In_Progress_409, + RET_Resize_Not_Allowed_403, + RET_Connection_Closed_Without_Reponse, + RET_Unknown_Failure, + }; + + /// \internal + enum RackspaceOperationType + { + RO_CONNECT_AND_AUTHENTICATE, + RO_LIST_SERVERS, + RO_LIST_SERVERS_WITH_DETAILS, + RO_CREATE_SERVER, + RO_GET_SERVER_DETAILS, + RO_UPDATE_SERVER_NAME_OR_PASSWORD, + RO_DELETE_SERVER, + RO_LIST_SERVER_ADDRESSES, + RO_SHARE_SERVER_ADDRESS, + RO_DELETE_SERVER_ADDRESS, + RO_REBOOT_SERVER, + RO_REBUILD_SERVER, + RO_RESIZE_SERVER, + RO_CONFIRM_RESIZED_SERVER, + RO_REVERT_RESIZED_SERVER, + RO_LIST_FLAVORS, + RO_GET_FLAVOR_DETAILS, + RO_LIST_IMAGES, + RO_CREATE_IMAGE, + RO_GET_IMAGE_DETAILS, + RO_DELETE_IMAGE, + RO_LIST_SHARED_IP_GROUPS, + RO_LIST_SHARED_IP_GROUPS_WITH_DETAILS, + RO_CREATE_SHARED_IP_GROUP, + RO_GET_SHARED_IP_GROUP_DETAILS, + RO_DELETE_SHARED_IP_GROUP, + + RO_NONE, + }; + + /// \brief Callback interface to receive the results of operations + class RAK_DLL_EXPORT Rackspace2EventCallback + { + public: + Rackspace2EventCallback() {} + virtual ~Rackspace2EventCallback() {} + virtual void OnAuthenticationResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnListServersResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnListServersWithDetailsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnCreateServerResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnGetServerDetails(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnUpdateServerNameOrPassword(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnDeleteServer(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnListServerAddresses(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnShareServerAddress(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnDeleteServerAddress(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnRebootServer(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnRebuildServer(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnResizeServer(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnConfirmResizedServer(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnRevertResizedServer(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnListFlavorsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnGetFlavorDetailsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnListImagesResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnCreateImageResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnGetImageDetailsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnDeleteImageResult(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnListSharedIPGroups(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnListSharedIPGroupsWithDetails(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnCreateSharedIPGroup(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnGetSharedIPGroupDetails(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + virtual void OnDeleteSharedIPGroup(RackspaceEventType eventType, const char *htmlAdditionalInfo)=0; + + virtual void OnConnectionAttemptFailure(RackspaceOperationType operationType, const char *url)=0; + }; + + /// \brief Callback interface to receive the results of operations, with a default result + class RAK_DLL_EXPORT RackspaceEventCallback_Default : public Rackspace2EventCallback + { + public: + virtual void ExecuteDefault(const char *callbackName, RackspaceEventType eventType, const char *htmlAdditionalInfo) {(void) callbackName; (void) eventType; (void) htmlAdditionalInfo;} + + virtual void OnAuthenticationResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnAuthenticationResult", eventType, htmlAdditionalInfo);} + virtual void OnListServersResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnListServersResult", eventType, htmlAdditionalInfo);} + virtual void OnListServersWithDetailsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnListServersWithDetailsResult", eventType, htmlAdditionalInfo);} + virtual void OnCreateServerResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnCreateServerResult", eventType, htmlAdditionalInfo);} + virtual void OnGetServerDetails(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnGetServerDetails", eventType, htmlAdditionalInfo);} + virtual void OnUpdateServerNameOrPassword(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnUpdateServerNameOrPassword", eventType, htmlAdditionalInfo);} + virtual void OnDeleteServer(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnDeleteServer", eventType, htmlAdditionalInfo);} + virtual void OnListServerAddresses(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnListServerAddresses", eventType, htmlAdditionalInfo);} + virtual void OnShareServerAddress(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnShareServerAddress", eventType, htmlAdditionalInfo);} + virtual void OnDeleteServerAddress(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnDeleteServerAddress", eventType, htmlAdditionalInfo);} + virtual void OnRebootServer(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnRebootServer", eventType, htmlAdditionalInfo);} + virtual void OnRebuildServer(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnRebuildServer", eventType, htmlAdditionalInfo);} + virtual void OnResizeServer(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnResizeServer", eventType, htmlAdditionalInfo);} + virtual void OnConfirmResizedServer(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnConfirmResizedServer", eventType, htmlAdditionalInfo);} + virtual void OnRevertResizedServer(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnRevertResizedServer", eventType, htmlAdditionalInfo);} + virtual void OnListFlavorsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnListFlavorsResult", eventType, htmlAdditionalInfo);} + virtual void OnGetFlavorDetailsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnGetFlavorDetailsResult", eventType, htmlAdditionalInfo);} + virtual void OnListImagesResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnListImagesResult", eventType, htmlAdditionalInfo);} + virtual void OnCreateImageResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnCreateImageResult", eventType, htmlAdditionalInfo);} + virtual void OnGetImageDetailsResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnGetImageDetailsResult", eventType, htmlAdditionalInfo);} + virtual void OnDeleteImageResult(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnDeleteImageResult", eventType, htmlAdditionalInfo);} + virtual void OnListSharedIPGroups(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnListSharedIPGroups", eventType, htmlAdditionalInfo);} + virtual void OnListSharedIPGroupsWithDetails(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnListSharedIPGroupsWithDetails", eventType, htmlAdditionalInfo);} + virtual void OnCreateSharedIPGroup(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnCreateSharedIPGroup", eventType, htmlAdditionalInfo);} + virtual void OnGetSharedIPGroupDetails(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnGetSharedIPGroupDetails", eventType, htmlAdditionalInfo);} + virtual void OnDeleteSharedIPGroup(RackspaceEventType eventType, const char *htmlAdditionalInfo) {ExecuteDefault("OnDeleteSharedIPGroup", eventType, htmlAdditionalInfo);} + + virtual void OnConnectionAttemptFailure(RackspaceOperationType operationType, const char *url) {(void) operationType; (void) url;} + }; + + /// \brief Code that uses the TCPInterface class to communicate with the Rackspace API servers + /// \pre Compile RakNet with OPEN_SSL_CLIENT_SUPPORT set to 1 + /// \pre Packets returned from TCPInterface::OnReceive() must be passed to Rackspace::OnReceive() + /// \pre Packets returned from TCPInterface::HasLostConnection() must be passed to Rackspace::OnClosedConnection() + class RAK_DLL_EXPORT Rackspace + { + public: + Rackspace(); + ~Rackspace(); + + /// \brief Authenticate with Rackspace servers, required before executing any commands. + /// \details All requests to authenticate and operate against Cloud Servers are performed using SSL over HTTP (HTTPS) on TCP port 443. + /// Times out after 24 hours - if you get RET_Authenticate_Unauthorized in the RackspaceEventCallback callback, call again + /// \sa RackspaceEventCallback::OnAuthenticationResult() + /// \param[in] _tcpInterface An instance of TCPInterface, build with OPEN_SSL_CLIENT_SUPPORT 1 and already started + /// \param[in] _authenticationURL See http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf . US-based accounts authenticate through auth.api.rackspacecloud.com. UK-based accounts authenticate through lon.auth.api.rackspacecloud.com + /// \param[in] _rackspaceCloudUsername Username you registered with Rackspace on their website + /// \param[in] _apiAccessKey Obtain your API access key from the Rackspace Cloud Control Panel in the Your Account API Access section. + /// \return The address of the authentication server, or UNASSIGNED_SYSTEM_ADDRESS if the connection attempt failed + SystemAddress Authenticate(TCPInterface *_tcpInterface, const char *_authenticationURL, const char *_rackspaceCloudUsername, const char *_apiAccessKey); + + /// \brief Get a list of running servers + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnListServersResult() + void ListServers(void); + + /// \brief Get a list of running servers, with extended details on each server + /// \sa GetServerDetails() + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnListServersWithDetailsResult() + void ListServersWithDetails(void); + + /// \brief Create a server + /// \details Create a server with a given image (harddrive contents) and flavor (hardware configuration) + /// Get the available images with ListImages() + /// Get the available flavors with ListFlavors() + /// It is possible to configure the server in more detail. See the XML schema at http://docs.rackspacecloud.com/servers/api/v1.0 + /// You can execute such a custom command by calling AddOperation() manually. See the implementation of CreateServer for how to do so. + /// The server takes a while to build. Call GetServerDetails() to get the current build status. Server id to pass to GetServerDetails() is returned in the field + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnCreateServerResult() + /// \param[in] name Name of the server. Only alphanumeric characters, periods, and hyphens are valid. Server Name cannot start or end with a period or hyphen. + /// \param[in] imageId Which image (harddrive contents, including OS) to use + /// \param[in] flavorId Which flavor (hardware config) to use, primarily how much memory is available. + void CreateServer(RakNet::RakString name, RakNet::RakString imageId, RakNet::RakString flavorId); + + /// \brief Get details on a particular server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnGetServerDetailsResult() + /// \param[in] serverId Which server to get details on. You can call ListServers() to get the list of active servers. + void GetServerDetails(RakNet::RakString serverId); + + /// \brief Changes the name or password for a server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnUpdateServerNameOrPasswordResult() + /// \param[in] serverId Which server to get details on. You can call ListServers() to get the list of active servers. + /// \param[in] newName The new server name. Leave blank to leave unchanged. Only alphanumeric characters, periods, and hyphens are valid. Server Name cannot start or end with a period or hyphen. + /// \param[in] newPassword The new server password. Leave blank to leave unchanged. + void UpdateServerNameOrPassword(RakNet::RakString serverId, RakNet::RakString newName, RakNet::RakString newPassword); + + /// \brief Deletes a server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnDeleteServerResult() + /// \param[in] serverId Which server to get details on. You can call ListServers() to get the list of active servers. + void DeleteServer(RakNet::RakString serverId); + + /// \brief Lists the IP addresses available to a server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnListServerAddressesResult() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + void ListServerAddresses(RakNet::RakString serverId); + + /// \brief Shares an IP address with a server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnShareServerAddressResult() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + /// \param[in] ipAddress Which IP address. You can call ListServerAddresses() to get the list of addresses for the specified server + void ShareServerAddress(RakNet::RakString serverId, RakNet::RakString ipAddress); + + /// \brief Stops sharing an IP address with a server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnDeleteServerAddressResult() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + /// \param[in] ipAddress Which IP address. You can call ListServerAddresses() to get the list of addresses for the specified server + void DeleteServerAddress(RakNet::RakString serverId, RakNet::RakString ipAddress); + + /// \brief Reboots a server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnRebootServerResult() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + /// \param[in] rebootType Should be either "HARD" or "SOFT" + void RebootServer(RakNet::RakString serverId, RakNet::RakString rebootType); + + /// \brief Rebuilds a server with a different image (harddrive contents) + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnRebuildServerResult() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + /// \param[in] imageId Which image (harddrive contents, including OS) to use + void RebuildServer(RakNet::RakString serverId, RakNet::RakString imageId); + + /// \brief Changes the hardware configuration of a server. This does not take effect until you call ConfirmResizedServer() + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnResizeServerResult() + /// \sa RevertResizedServer() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + /// \param[in] flavorId Which flavor (hardware config) to use, primarily how much memory is available. + void ResizeServer(RakNet::RakString serverId, RakNet::RakString flavorId); + + /// \brief Confirm a resize for the specified server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnConfirmResizedServerResult() + /// \sa ResizeServer() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + void ConfirmResizedServer(RakNet::RakString serverId); + + /// \brief Reverts a resize for the specified server + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnRevertResizedServerResult() + /// \sa ResizeServer() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + void RevertResizedServer(RakNet::RakString serverId); + + /// \brief List all flavors (hardware configs, primarily memory) + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnListFlavorsResult() + void ListFlavors(void); + + /// \brief Get extended details about a specific flavor + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnGetFlavorDetailsResult() + /// \sa ListFlavors() + /// \param[in] flavorId Which flavor (hardware config) + void GetFlavorDetails(RakNet::RakString flavorId); + + /// \brief List all images (software configs, including operating systems), which includes images you create yourself + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnListImagesResult() + /// \sa CreateImage() + void ListImages(void); + + /// \brief Images a running server. This essentially copies the harddrive, and lets you start a server with the same harddrive contents later + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnCreateImageResult() + /// \sa ListImages() + /// \param[in] serverId Which server to operate on. You can call ListServers() to get the list of active servers. + /// \param[in] imageName What to call this image + void CreateImage(RakNet::RakString serverId, RakNet::RakString imageName); + + /// \brief Get extended details about a particular image + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnGetImageDetailsResult() + /// \sa ListImages() + /// \param[in] imageId Which image + void GetImageDetails(RakNet::RakString imageId); + + /// \brief Delete a custom image created with CreateImage() + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnDeleteImageResult() + /// \sa ListImages() + /// \param[in] imageId Which image + void DeleteImage(RakNet::RakString imageId); + + /// \brief List IP groups + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnListSharedIPGroupsResult() + void ListSharedIPGroups(void); + + /// \brief List IP groups with extended details + /// \sa http://docs.rackspacecloud.com/servers/api/v1.0/cs-devguide-20110112.pdf + /// \sa RackspaceEventCallback::OnListSharedIPGroupsWithDetailsResult() + void ListSharedIPGroupsWithDetails(void); + + // I don't know what this does + void CreateSharedIPGroup(RakNet::RakString name, RakNet::RakString optionalServerId); + // I don't know what this does + void GetSharedIPGroupDetails(RakNet::RakString groupId); + // I don't know what this does + void DeleteSharedIPGroup(RakNet::RakString groupId); + + /// \brief Adds a callback to the list of callbacks to be called when any of the above functions finish executing + /// The callbacks are called in the order they are added + void AddEventCallback(Rackspace2EventCallback *callback); + /// \brief Removes a callback from the list of callbacks to be called when any of the above functions finish executing + /// The callbacks are called in the order they are added + void RemoveEventCallback(Rackspace2EventCallback *callback); + /// \brief Removes all callbacks + void ClearEventCallbacks(void); + + /// Call this anytime TCPInterface returns a packet + void OnReceive(Packet *packet); + + /// Call this when TCPInterface returns something other than UNASSIGNED_SYSTEM_ADDRESS from HasLostConnection() + void OnClosedConnection(SystemAddress systemAddress); + + /// String representation of each RackspaceEventType + static const char * EventTypeToString(RackspaceEventType eventType); + + /// \brief Mostly for internal use, but you can use it to execute an operation with more complex xml if desired + /// See the Rackspace.cpp on how to use it + void AddOperation(RackspaceOperationType type, RakNet::RakString httpCommand, RakNet::RakString operation, RakNet::RakString xml); + protected: + + DataStructures::List eventCallbacks; + + struct RackspaceOperation + { + RackspaceOperationType type; + // RakNet::RakString stringInfo; + SystemAddress connectionAddress; + bool isPendingAuthentication; + RakNet::RakString incomingStream; + RakNet::RakString httpCommand; + RakNet::RakString operation; + RakNet::RakString xml; + }; + + TCPInterface *tcpInterface; + + // RackspaceOperationType currentOperation; + // DataStructures::Queue nextOperationQueue; + + DataStructures::List operations; + bool HasOperationOfType(RackspaceOperationType t); + unsigned int GetOperationOfTypeIndex(RackspaceOperationType t); + + RakNet::RakString serverManagementURL; + RakNet::RakString serverManagementDomain; + RakNet::RakString serverManagementPath; + RakNet::RakString storageURL; + RakNet::RakString storageDomain; + RakNet::RakString storagePath; + RakNet::RakString cdnManagementURL; + RakNet::RakString cdnManagementDomain; + RakNet::RakString cdnManagementPath; + + RakNet::RakString storageToken; + RakNet::RakString authToken; + RakNet::RakString rackspaceCloudUsername; + RakNet::RakString apiAccessKey; + + bool ExecuteOperation(RackspaceOperation &ro); + void ReadLine(const char *data, const char *stringStart, RakNet::RakString &output); + bool ConnectToServerManagementDomain(RackspaceOperation &ro); + + + }; + +} // namespace RakNet + +#endif // __RACKSPACE_API_H + +#endif // _RAKNET_SUPPORT_Rackspace diff --git a/include/raknet/RakAlloca.hpp b/include/raknet/RakAlloca.hpp new file mode 100644 index 0000000..62a199e --- /dev/null +++ b/include/raknet/RakAlloca.hpp @@ -0,0 +1,26 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#if defined(__FreeBSD__) +#include + + + + +#elif defined ( __APPLE__ ) || defined ( __APPLE_CC__ ) +#include +#include +#elif defined(_WIN32) +#include +#else +#include +// Alloca needed on Ubuntu apparently +#include +#endif diff --git a/include/raknet/RakAssert.hpp b/include/raknet/RakAssert.hpp new file mode 100644 index 0000000..b50fea5 --- /dev/null +++ b/include/raknet/RakAssert.hpp @@ -0,0 +1,12 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#include +#include "RakNetDefines.hpp" diff --git a/include/raknet/RakMemoryOverride.hpp b/include/raknet/RakMemoryOverride.hpp new file mode 100644 index 0000000..ca1ce18 --- /dev/null +++ b/include/raknet/RakMemoryOverride.hpp @@ -0,0 +1,244 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief If _USE_RAK_MEMORY_OVERRIDE is defined, memory allocations go through rakMalloc, rakRealloc, and rakFree +/// + + + +#ifndef __RAK_MEMORY_H +#define __RAK_MEMORY_H + +#include "Export.hpp" +#include "RakNetDefines.hpp" +#include + + + + + + + +#include "RakAlloca.hpp" + +// #if _USE_RAK_MEMORY_OVERRIDE==1 +// #if defined(new) +// #pragma push_macro("new") +// #undef new +// #define RMO_NEW_UNDEF +// #endif +// #endif + + +// These pointers are statically and globally defined in RakMemoryOverride.cpp +// Change them to point to your own allocators if you want. +// Use the functions for a DLL, or just reassign the variable if using source +extern RAK_DLL_EXPORT void * (*rakMalloc) (size_t size); +extern RAK_DLL_EXPORT void * (*rakRealloc) (void *p, size_t size); +extern RAK_DLL_EXPORT void (*rakFree) (void *p); +extern RAK_DLL_EXPORT void * (*rakMalloc_Ex) (size_t size, const char *file, unsigned int line); +extern RAK_DLL_EXPORT void * (*rakRealloc_Ex) (void *p, size_t size, const char *file, unsigned int line); +extern RAK_DLL_EXPORT void (*rakFree_Ex) (void *p, const char *file, unsigned int line); +extern RAK_DLL_EXPORT void (*notifyOutOfMemory) (const char *file, const long line); +extern RAK_DLL_EXPORT void * (*dlMallocMMap) (size_t size); +extern RAK_DLL_EXPORT void * (*dlMallocDirectMMap) (size_t size); +extern RAK_DLL_EXPORT int (*dlMallocMUnmap) (void* ptr, size_t size); + +// Change to a user defined allocation function +void RAK_DLL_EXPORT SetMalloc( void* (*userFunction)(size_t size) ); +void RAK_DLL_EXPORT SetRealloc( void* (*userFunction)(void *p, size_t size) ); +void RAK_DLL_EXPORT SetFree( void (*userFunction)(void *p) ); +void RAK_DLL_EXPORT SetMalloc_Ex( void* (*userFunction)(size_t size, const char *file, unsigned int line) ); +void RAK_DLL_EXPORT SetRealloc_Ex( void* (*userFunction)(void *p, size_t size, const char *file, unsigned int line) ); +void RAK_DLL_EXPORT SetFree_Ex( void (*userFunction)(void *p, const char *file, unsigned int line) ); +// Change to a user defined out of memory function +void RAK_DLL_EXPORT SetNotifyOutOfMemory( void (*userFunction)(const char *file, const long line) ); +void RAK_DLL_EXPORT SetDLMallocMMap( void* (*userFunction)(size_t size) ); +void RAK_DLL_EXPORT SetDLMallocDirectMMap( void* (*userFunction)(size_t size) ); +void RAK_DLL_EXPORT SetDLMallocMUnmap( int (*userFunction)(void* ptr, size_t size) ); + +extern RAK_DLL_EXPORT void * (*GetMalloc()) (size_t size); +extern RAK_DLL_EXPORT void * (*GetRealloc()) (void *p, size_t size); +extern RAK_DLL_EXPORT void (*GetFree()) (void *p); +extern RAK_DLL_EXPORT void * (*GetMalloc_Ex()) (size_t size, const char *file, unsigned int line); +extern RAK_DLL_EXPORT void * (*GetRealloc_Ex()) (void *p, size_t size, const char *file, unsigned int line); +extern RAK_DLL_EXPORT void (*GetFree_Ex()) (void *p, const char *file, unsigned int line); +extern RAK_DLL_EXPORT void *(*GetDLMallocMMap())(size_t size); +extern RAK_DLL_EXPORT void *(*GetDLMallocDirectMMap())(size_t size); +extern RAK_DLL_EXPORT int (*GetDLMallocMUnmap())(void* ptr, size_t size); + +namespace RakNet +{ + + template + RAK_DLL_EXPORT Type* OP_NEW(const char *file, unsigned int line) + { +#if _USE_RAK_MEMORY_OVERRIDE==1 + char *buffer = (char *) (GetMalloc_Ex())(sizeof(Type), file, line); + Type *t = new (buffer) Type; + return t; +#else + (void) file; + (void) line; + return new Type; +#endif + } + + template + RAK_DLL_EXPORT Type* OP_NEW_1(const char *file, unsigned int line, const P1 &p1) + { +#if _USE_RAK_MEMORY_OVERRIDE==1 + char *buffer = (char *) (GetMalloc_Ex())(sizeof(Type), file, line); + Type *t = new (buffer) Type(p1); + return t; +#else + (void) file; + (void) line; + return new Type(p1); +#endif + } + + template + RAK_DLL_EXPORT Type* OP_NEW_2(const char *file, unsigned int line, const P1 &p1, const P2 &p2) + { +#if _USE_RAK_MEMORY_OVERRIDE==1 + char *buffer = (char *) (GetMalloc_Ex())(sizeof(Type), file, line); + Type *t = new (buffer) Type(p1, p2); + return t; +#else + (void) file; + (void) line; + return new Type(p1, p2); +#endif + } + + template + RAK_DLL_EXPORT Type* OP_NEW_3(const char *file, unsigned int line, const P1 &p1, const P2 &p2, const P3 &p3) + { +#if _USE_RAK_MEMORY_OVERRIDE==1 + char *buffer = (char *) (GetMalloc_Ex())(sizeof(Type), file, line); + Type *t = new (buffer) Type(p1, p2, p3); + return t; +#else + (void) file; + (void) line; + return new Type(p1, p2, p3); +#endif + } + + template + RAK_DLL_EXPORT Type* OP_NEW_4(const char *file, unsigned int line, const P1 &p1, const P2 &p2, const P3 &p3, const P4 &p4) + { +#if _USE_RAK_MEMORY_OVERRIDE==1 + char *buffer = (char *) (GetMalloc_Ex())(sizeof(Type), file, line); + Type *t = new (buffer) Type(p1, p2, p3, p4); + return t; +#else + (void) file; + (void) line; + return new Type(p1, p2, p3, p4); +#endif + } + + + template + RAK_DLL_EXPORT Type* OP_NEW_ARRAY(const int count, const char *file, unsigned int line) + { + if (count==0) + return 0; + +#if _USE_RAK_MEMORY_OVERRIDE==1 +// Type *t; + char *buffer = (char *) (GetMalloc_Ex())(sizeof(int)+sizeof(Type)*count, file, line); + ((int*)buffer)[0]=count; + for (int i=0; i + RAK_DLL_EXPORT void OP_DELETE(Type *buff, const char *file, unsigned int line) + { +#if _USE_RAK_MEMORY_OVERRIDE==1 + if (buff==0) return; + buff->~Type(); + (GetFree_Ex())((char*)buff, file, line ); +#else + (void) file; + (void) line; + delete buff; +#endif + + } + + template + RAK_DLL_EXPORT void OP_DELETE_ARRAY(Type *buff, const char *file, unsigned int line) + { +#if _USE_RAK_MEMORY_OVERRIDE==1 + if (buff==0) + return; + + int count = ((int*)((char*)buff-sizeof(int)))[0]; + Type *t; + for (int i=0; i~Type(); + } + (GetFree_Ex())((char*)buff-sizeof(int), file, line ); +#else + (void) file; + (void) line; + delete [] buff; +#endif + + } + + void RAK_DLL_EXPORT * _RakMalloc (size_t size); + void RAK_DLL_EXPORT * _RakRealloc (void *p, size_t size); + void RAK_DLL_EXPORT _RakFree (void *p); + void RAK_DLL_EXPORT * _RakMalloc_Ex (size_t size, const char *file, unsigned int line); + void RAK_DLL_EXPORT * _RakRealloc_Ex (void *p, size_t size, const char *file, unsigned int line); + void RAK_DLL_EXPORT _RakFree_Ex (void *p, const char *file, unsigned int line); + void RAK_DLL_EXPORT * _DLMallocMMap (size_t size); + void RAK_DLL_EXPORT * _DLMallocDirectMMap (size_t size); + int RAK_DLL_EXPORT _DLMallocMUnmap (void *p, size_t size); + +} + +// Call to make RakNet allocate a large block of memory, and do all subsequent allocations in that memory block +// Initial and reallocations will be done through whatever function is pointed to by yourMMapFunction, and yourDirectMMapFunction (default is malloc) +// Allocations will be freed through whatever function is pointed to by yourMUnmapFunction (default free) +void UseRaknetFixedHeap(size_t initialCapacity, + void * (*yourMMapFunction) (size_t size) = RakNet::_DLMallocMMap, + void * (*yourDirectMMapFunction) (size_t size) = RakNet::_DLMallocDirectMMap, + int (*yourMUnmapFunction) (void *p, size_t size) = RakNet::_DLMallocMUnmap); + +// Free memory allocated from UseRaknetFixedHeap +void FreeRakNetFixedHeap(void); + +// #if _USE_RAK_MEMORY_OVERRIDE==1 +// #if defined(RMO_NEW_UNDEF) +// #pragma pop_macro("new") +// #undef RMO_NEW_UNDEF +// #endif +// #endif + +#endif diff --git a/include/raknet/RakNetCommandParser.hpp b/include/raknet/RakNetCommandParser.hpp new file mode 100644 index 0000000..c95aa22 --- /dev/null +++ b/include/raknet/RakNetCommandParser.hpp @@ -0,0 +1,70 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains RakNetCommandParser , used to send commands to an instance of RakPeer +/// + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_RakNetCommandParser==1 + +#ifndef __RAKNET_COMMAND_PARSER +#define __RAKNET_COMMAND_PARSER + +#include "CommandParserInterface.hpp" +#include "Export.hpp" + +namespace RakNet +{ +class RakPeerInterface; + +/// \brief This allows a console client to call most of the functions in RakPeer +class RAK_DLL_EXPORT RakNetCommandParser : public CommandParserInterface +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(RakNetCommandParser) + + RakNetCommandParser(); + ~RakNetCommandParser(); + + /// Given \a command with parameters \a parameterList , do whatever processing you wish. + /// \param[in] command The command to process + /// \param[in] numParameters How many parameters were passed along with the command + /// \param[in] parameterList The list of parameters. parameterList[0] is the first parameter and so on. + /// \param[in] transport The transport interface we can use to write to + /// \param[in] systemAddress The player that sent this command. + /// \param[in] originalString The string that was actually sent over the network, in case you want to do your own parsing + bool OnCommand(const char *command, unsigned numParameters, char **parameterList, TransportInterface *transport, const SystemAddress &systemAddress, const char *originalString); + + /// You are responsible for overriding this function and returning a static string, which will identifier your parser. + /// This should return a static string + /// \return The name that you return. + const char *GetName(void) const; + + /// A callback for when you are expected to send a brief description of your parser to \a systemAddress + /// \param[in] transport The transport interface we can use to write to + /// \param[in] systemAddress The player that requested help. + void SendHelp(TransportInterface *transport, const SystemAddress &systemAddress); + + /// Records the instance of RakPeer to perform the desired commands on + /// \param[in] rakPeer The RakPeer instance, or a derived class (e.g. RakPeer or RakPeer) + void SetRakPeerInterface(RakNet::RakPeerInterface *rakPeer); +protected: + + /// Which instance of RakPeer we are working on. Set from SetRakPeerInterface() + RakPeerInterface *peer; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/RakNetDefines.hpp b/include/raknet/RakNetDefines.hpp new file mode 100644 index 0000000..e45aa01 --- /dev/null +++ b/include/raknet/RakNetDefines.hpp @@ -0,0 +1,195 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAKNET_DEFINES_H +#define __RAKNET_DEFINES_H + +// If you want to change these defines, put them in RakNetDefinesOverrides so your changes are not lost when updating RakNet +// The user should not edit this file +#include "RakNetDefinesOverrides.hpp" + +/// Define __GET_TIME_64BIT to have RakNet::TimeMS use a 64, rather than 32 bit value. A 32 bit value will overflow after about 5 weeks. +/// However, this doubles the bandwidth use for sending times, so don't do it unless you have a reason to. +/// Comment out if you are using the iPod Touch TG. See http://www.jenkinssoftware.com/forum/index.php?topic=2717.0 +/// This must be the same on all systems, or they won't connect +#ifndef __GET_TIME_64BIT +#define __GET_TIME_64BIT 1 +#endif + +// Define _FILE_AND_LINE_ to "",0 if you want to strip out file and line info for memory tracking from the EXE +#ifndef _FILE_AND_LINE_ +#define _FILE_AND_LINE_ __FILE__,__LINE__ +#endif + +/// Define __BITSTREAM_NATIVE_END to NOT support endian swapping in the BitStream class. This is faster and is what you should use +/// unless you actually plan to have different endianness systems connect to each other +/// Enabled by default. +// #define __BITSTREAM_NATIVE_END + +/// Maximum (stack) size to use with _alloca before using new and delete instead. +#ifndef MAX_ALLOCA_STACK_ALLOCATION +#define MAX_ALLOCA_STACK_ALLOCATION 1048576 +#endif + +// Use WaitForSingleObject instead of sleep. +// Defining it plays nicer with other systems, and uses less CPU, but gives worse RakNet performance +// Undefining it uses more CPU time, but is more responsive and faster. +#ifndef _WIN32_WCE +#define USE_WAIT_FOR_MULTIPLE_EVENTS +#endif + +/// Uncomment to use RakMemoryOverride for custom memory tracking +/// See RakMemoryOverride.h. +#ifndef _USE_RAK_MEMORY_OVERRIDE +#define _USE_RAK_MEMORY_OVERRIDE 0 +#endif + +/// If defined, OpenSSL is enabled for the class TCPInterface +/// This is necessary to use the SendEmail class with Google POP servers +/// Note that OpenSSL carries its own license restrictions that you should be aware of. If you don't agree, don't enable this define +/// This also requires that you enable header search paths to DependentExtensions\openssl-1.0.0d +// #define OPEN_SSL_CLIENT_SUPPORT +#ifndef OPEN_SSL_CLIENT_SUPPORT +#define OPEN_SSL_CLIENT_SUPPORT 0 +#endif + +/// Threshold at which to do a malloc / free rather than pushing data onto a fixed stack for the bitstream class +/// Arbitrary size, just picking something likely to be larger than most packets +#ifndef BITSTREAM_STACK_ALLOCATION_SIZE +#define BITSTREAM_STACK_ALLOCATION_SIZE 256 +#endif + +// Redefine if you want to disable or change the target for debug RAKNET_DEBUG_PRINTF +#ifndef RAKNET_DEBUG_PRINTF +#define RAKNET_DEBUG_PRINTF printf +#endif + +// Maximum number of local IP addresses supported +#ifndef MAXIMUM_NUMBER_OF_INTERNAL_IDS +#define MAXIMUM_NUMBER_OF_INTERNAL_IDS 10 +#endif + +#ifndef RakAssert + + + +#if defined(__native_client__) +#define RakAssert(x) +#else +#if defined(_DEBUG) +#define RakAssert(x) assert(x); +#else +#define RakAssert(x) +#endif +#endif +#endif + +/// This controls the amount of memory used per connection. +/// This many datagrams are tracked by datagramNumber. If more than this many datagrams are sent, then an ack for an older datagram would be ignored +/// This results in an unnecessary resend in that case +#ifndef DATAGRAM_MESSAGE_ID_ARRAY_LENGTH +#define DATAGRAM_MESSAGE_ID_ARRAY_LENGTH 512 +#endif + +/// This is the maximum number of reliable user messages that can be on the wire at a time +/// If this is too low, then high ping connections with a large throughput will be underutilized +/// This will be evident because RakNetStatistics::messagesInSend buffer will increase over time, yet at the same time the outgoing bandwidth per second is less than your connection supports +#ifndef RESEND_BUFFER_ARRAY_LENGTH +#define RESEND_BUFFER_ARRAY_LENGTH 512 +#define RESEND_BUFFER_ARRAY_MASK 511 +#endif + +/// Uncomment if you want to link in the DLMalloc library to use with RakMemoryOverride +// #define _LINK_DL_MALLOC + +#ifndef GET_TIME_SPIKE_LIMIT +/// Workaround for http://support.microsoft.com/kb/274323 +/// If two calls between RakNet::GetTime() happen farther apart than this time in microseconds, this delta will be returned instead +/// Note: This will cause ID_TIMESTAMP to be temporarily inaccurate if you set a breakpoint that pauses the UpdateNetworkLoop() thread in RakPeer +/// Define in RakNetDefinesOverrides.h to enable (non-zero) or disable (0) +#define GET_TIME_SPIKE_LIMIT 0 +#endif + +// Use sliding window congestion control instead of ping based congestion control +#ifndef USE_SLIDING_WINDOW_CONGESTION_CONTROL +#define USE_SLIDING_WINDOW_CONGESTION_CONTROL 1 +#endif + +// When a large message is arriving, preallocate the memory for the entire block +// This results in large messages not taking up time to reassembly with memcpy, but is vulnerable to attackers causing the host to run out of memory +#ifndef PREALLOCATE_LARGE_MESSAGES +#define PREALLOCATE_LARGE_MESSAGES 0 +#endif + +#ifndef RAKNET_SUPPORT_IPV6 +#define RAKNET_SUPPORT_IPV6 0 +#endif + + + + + + + + + + + +#ifndef RAKSTRING_TYPE +#if defined(_UNICODE) +#define RAKSTRING_TYPE RakWString +#define RAKSTRING_TYPE_IS_UNICODE 1 +#else +#define RAKSTRING_TYPE RakString +#define RAKSTRING_TYPE_IS_UNICODE 0 +#endif +#endif + +#ifndef RPC4_GLOBAL_REGISTRATION_MAX_FUNCTIONS +#define RPC4_GLOBAL_REGISTRATION_MAX_FUNCTIONS 48 +#endif + +#ifndef RPC4_GLOBAL_REGISTRATION_MAX_FUNCTION_NAME_LENGTH +#define RPC4_GLOBAL_REGISTRATION_MAX_FUNCTION_NAME_LENGTH 48 +#endif + +#ifndef XBOX_BYPASS_SECURITY +#define XBOX_BYPASS_SECURITY 1 +#endif + +// Controls how many allocations occur at once for the memory pool of incoming datagrams waiting to be transferred between the recvfrom thread and the main update thread +// Has large effect on memory usage, per instance of RakPeer. Approximately MAXIMUM_MTU_SIZE*BUFFERED_PACKETS_PAGE_SIZE bytes, once after calling RakPeer::Startup() +#ifndef BUFFERED_PACKETS_PAGE_SIZE +#define BUFFERED_PACKETS_PAGE_SIZE 8 +#endif + +// Controls how many allocations occur at once for the memory pool of incoming or outgoing datagrams. +// Has small effect on memory usage per connection. Uses about 256 bytes*INTERNAL_PACKET_PAGE_SIZE per connection +#ifndef INTERNAL_PACKET_PAGE_SIZE +#define INTERNAL_PACKET_PAGE_SIZE 8 +#endif + +// If defined to 1, the user is responsible for calling RakPeer::RunUpdateCycle and RakPeer::RunRecvfrom +#ifndef RAKPEER_USER_THREADED +#define RAKPEER_USER_THREADED 0 +#endif + +#ifndef USE_ALLOCA +#define USE_ALLOCA 1 +#endif + + + + + + +//#define USE_THREADED_SEND + +#endif // __RAKNET_DEFINES_H diff --git a/include/raknet/RakNetDefinesOverrides.hpp b/include/raknet/RakNetDefinesOverrides.hpp new file mode 100644 index 0000000..00ad529 --- /dev/null +++ b/include/raknet/RakNetDefinesOverrides.hpp @@ -0,0 +1,12 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +// USER EDITABLE FILE + diff --git a/include/raknet/RakNetSmartPtr.hpp b/include/raknet/RakNetSmartPtr.hpp new file mode 100644 index 0000000..a4b123d --- /dev/null +++ b/include/raknet/RakNetSmartPtr.hpp @@ -0,0 +1,183 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAKNET_SMART_PTR_H +#define __RAKNET_SMART_PTR_H + +// From http://www.codeproject.com/KB/cpp/SmartPointers.aspx +// with bugs fixed + +#include "RakMemoryOverride.hpp" +#include "Export.hpp" + +//static int allocCount=0; +//static int deallocCount=0; + +namespace RakNet +{ + +class RAK_DLL_EXPORT ReferenceCounter +{ +private: + int refCount; + +public: + ReferenceCounter() {refCount=0;} + ~ReferenceCounter() {} + void AddRef() {refCount++;} + int Release() {return --refCount;} + int GetRefCount(void) const {return refCount;} +}; + +template < typename T > class RAK_DLL_EXPORT RakNetSmartPtr +{ +private: + T* ptr; // pointer + ReferenceCounter* reference; // Reference refCount + +public: + RakNetSmartPtr() : ptr(0), reference(0) + { + // Do not allocate by default, wasteful if we just have a list of preallocated and unassigend smart pointers + } + + RakNetSmartPtr(T* pValue) : ptr(pValue) + { + reference = RakNet::OP_NEW(_FILE_AND_LINE_); + reference->AddRef(); + +// allocCount+=2; +// printf("allocCount=%i deallocCount=%i Line=%i\n",allocCount, deallocCount, __LINE__); + } + + RakNetSmartPtr(const RakNetSmartPtr& sp) : ptr(sp.ptr), reference(sp.reference) + { + if (reference) + reference->AddRef(); + } + + ~RakNetSmartPtr() + { + if(reference && reference->Release() == 0) + { + RakNet::OP_DELETE(ptr, _FILE_AND_LINE_); + RakNet::OP_DELETE(reference, _FILE_AND_LINE_); + +// deallocCount+=2; +// printf("allocCount=%i deallocCount=%i Line=%i\n",allocCount, deallocCount, __LINE__); + } + } + + bool IsNull(void) const + { + return ptr==0; + } + + void SetNull(void) + { + if(reference && reference->Release() == 0) + { + RakNet::OP_DELETE(ptr, _FILE_AND_LINE_); + RakNet::OP_DELETE(reference, _FILE_AND_LINE_); + +// deallocCount+=2; +// printf("allocCount=%i deallocCount=%i Line=%i\n",allocCount, deallocCount, __LINE__); + } + ptr=0; + reference=0; + } + + bool IsUnique(void) const + { + return reference->GetRefCount()==1; + } + + // Allow you to change the values of the internal contents of the pointer, without changing what is pointed to by other instances of the smart pointer + void Clone(bool copyContents) + { + if (IsUnique()==false) + { + reference->Release(); + + reference = RakNet::OP_NEW(_FILE_AND_LINE_); + reference->AddRef(); + T* oldPtr=ptr; + ptr=RakNet::OP_NEW(_FILE_AND_LINE_); + if (copyContents) + *ptr=*oldPtr; + } + } + + int GetRefCount(void) const + { + return reference->GetRefCount(); + } + + T& operator* () + { + return *ptr; + } + + const T& operator* () const + { + return *ptr; + } + + T* operator-> () + { + return ptr; + } + + const T* operator-> () const + { + return ptr; + } + + bool operator == (const RakNetSmartPtr& sp) + { + return ptr == sp.ptr; + } + bool operator<( const RakNetSmartPtr &right ) {return ptr < right.ptr;} + bool operator>( const RakNetSmartPtr &right ) {return ptr > right.ptr;} + + bool operator != (const RakNetSmartPtr& sp) + { + return ptr != sp.ptr; + } + + RakNetSmartPtr& operator = (const RakNetSmartPtr& sp) + { + // Assignment operator + + if (this != &sp) // Avoid self assignment + { + if(reference && reference->Release() == 0) + { + RakNet::OP_DELETE(ptr, _FILE_AND_LINE_); + RakNet::OP_DELETE(reference, _FILE_AND_LINE_); + +// deallocCount+=2; +// printf("allocCount=%i deallocCount=%i Line=%i\n",allocCount, deallocCount, __LINE__); + } + + ptr = sp.ptr; + reference = sp.reference; + if (reference) + reference->AddRef(); + } + return *this; + } + + +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/RakNetSocket.hpp b/include/raknet/RakNetSocket.hpp new file mode 100644 index 0000000..a98cb01 --- /dev/null +++ b/include/raknet/RakNetSocket.hpp @@ -0,0 +1,194 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/* +#ifndef __RAKNET_SOCKET_H +#define __RAKNET_SOCKET_H + +#include "RakNetTypes.hpp" +#include "RakNetDefines.hpp" +#include "Export.hpp" +#include "SocketIncludes.hpp" +#include "RakAssert.hpp" +#include "SocketDefines.hpp" +#include "MTUSize.hpp" + +namespace RakNet +{ + +struct RAK_DLL_EXPORT RakNetSocket +{ +public: + RakNetSocket(); + ~RakNetSocket(); + +// void Accept( +// struct sockaddr *addr, +// int *addrlen); + + inline int Connect( + const struct sockaddr *name, + int namelen) {return connect__(s,name,namelen);} + + static RakNetSocket* Create +#ifdef __native_client__ + (_PP_Instance_ _chromeInstance); +#else + (int af, + int type, + int protocol); +#endif + + int Bind( + const struct sockaddr *addr, + int namelen); + + inline int GetSockName( + struct sockaddr *name, + socklen_t * namelen) {return getsockname__(s,name,namelen);} + + inline int GetSockOpt ( + int level, + int optname, + char * optval, + socklen_t *optlen) {return getsockopt__(s,level,optname,optval,optlen);} + + + int IOCTLSocket( + long cmd, + unsigned long *argp); + + int Listen ( + int backlog); + + inline int Recv( + char * buf, + int len, + int flags) {return recv__(s,buf,len,flags);} + + inline int RecvFrom( + char * buf, + int len, + int flags, + struct sockaddr * from, + socklen_t * fromlen) {return recvfrom__(s,buf,len,flags,from,fromlen);} + +// inline int Select( +// int nfds, +// fd_set *readfds, +// fd_set *writefds, +// fd_set *exceptfds, +// struct timeval *timeout) {return select__(nfds,readfds,writefds,exceptfds,timeout);} + + inline int Send( + const char * buf, + int len, + int flags) {return send__(s,buf,len,flags);} + + inline int SendTo( + const char * buf, + int len, + int flags, + const struct sockaddr *to, + int tolen) {return sendto__(s,buf,len,flags,to,tolen);} + + #ifdef _WIN32 + #elif defined(_PS3) || defined(__PS3__) || defined(SN_TARGET_PS3) || defined(_PS4) || defined(SN_TARGET_PSP2) + #else + inline int Fcntl(int cmd, int arg) {return fcntl(s,cmd,arg);} + #endif + + +#if defined(_WIN32) && !defined(WINDOWS_STORE_RT) + inline int _WSASendTo( + LPWSABUF lpBuffers, + DWORD dwBufferCount, + LPDWORD lpNumberOfBytesSent, + DWORD dwFlags, + const struct sockaddr FAR * lpTo, + int iTolen, + LPWSAOVERLAPPED lpOverlapped, + LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine + ) + { return WSASendTo(s,lpBuffers,dwBufferCount,lpNumberOfBytesSent,dwFlags,lpTo,iTolen,lpOverlapped,lpCompletionRoutine);} + +#endif + + int SetSockOpt( + int level, + int optname, + const char * optval, + int optlen); + + int Shutdown( + int how); + + + inline void SetRemotePortRakNetWasStartedOn(unsigned short i) {remotePortRakNetWasStartedOn_PS3_PSP2=i;} + inline void SetUserConnectionSocketIndex(unsigned int i) {userConnectionSocketIndex=i;} + inline void SetBoundAddress(SystemAddress i) {boundAddress=i;} + inline void SetSocketFamily(unsigned short i) {socketFamily=i;} + inline void SetBlockingSocket(bool i) {blockingSocket=i;} + inline void SetExtraSocketOptions(unsigned int i) {extraSocketOptions=i;} + inline void SetChromeInstance(_PP_Instance_ i) {chromeInstance=i;} + inline void SetBoundAddressToLoopback(unsigned char ipVersion) {boundAddress.SetToLoopback(ipVersion);} + + inline SystemAddress GetBoundAddress(void) const {return boundAddress;} + inline unsigned short GetRemotePortRakNetWasStartedOn(void) const {return remotePortRakNetWasStartedOn_PS3_PSP2;} + inline bool GetBlockingSocket(void) {return blockingSocket;} + inline unsigned int GetExtraSocketOptions(void) const {return extraSocketOptions;} + inline unsigned short GetSocketFamily(void) const {return socketFamily;} + inline _PP_Instance_ GetChromeInstance(void) const {return chromeInstance;} + inline unsigned int GetUserConnectionSocketIndex(void) const { + RakAssert(userConnectionSocketIndex!=(unsigned int)-1); + return userConnectionSocketIndex;} + + +#ifdef __native_client__ + // Flag indicating if a SendTo is currently in progress + bool sendInProgress; + + // Data for next queued packet to send, if nextSendSize > 0 + char nextSendBuffer[MAXIMUM_MTU_SIZE]; + + // Size of next queued packet to send, or 0 if no queued packet + int nextSendSize; + + // Destination address of queued packet + PP_NetAddress_Private nextSendAddr; +#endif + + __UDPSOCKET__ s; + +protected: + +#if defined (_WIN32) && defined(USE_WAIT_FOR_MULTIPLE_EVENTS) + void* recvEvent; +#endif + + #if defined(_PS3) || defined(__PS3__) || defined(SN_TARGET_PS3) || defined(_PS4) || defined(SN_TARGET_PSP2) + /// PS3: Set for the PS3, when using signaling. + /// PS3: Connect with the port returned by signaling. Set this to whatever port RakNet was actually started on + /// PSP2: Set non-zero to use SCE_NET_SOCK_DGRAM_P2P. This should be done for ad-hoc or with + #endif + + unsigned short remotePortRakNetWasStartedOn_PS3_PSP2; + unsigned int userConnectionSocketIndex; + SystemAddress boundAddress; + unsigned short socketFamily; + bool blockingSocket; + unsigned int extraSocketOptions; + _PP_Instance_ chromeInstance; +}; + +} // namespace RakNet + +#endif +*/ diff --git a/include/raknet/RakNetSocket2.hpp b/include/raknet/RakNetSocket2.hpp new file mode 100644 index 0000000..983ff41 --- /dev/null +++ b/include/raknet/RakNetSocket2.hpp @@ -0,0 +1,453 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAKNET_SOCKET_2_H +#define __RAKNET_SOCKET_2_H + +#include "RakNetTypes.hpp" +#include "MTUSize.hpp" +#include "LocklessTypes.hpp" +#include "RakThread.hpp" +#include "DS_ThreadsafeAllocatingQueue.hpp" +#include "Export.hpp" + +// For CFSocket +// https://developer.apple.com/library/mac/#documentation/CoreFOundation/Reference/CFSocketRef/Reference/reference.html +// Reason: http://sourceforge.net/p/open-dis/discussion/683284/thread/0929d6a0 +#if defined(__APPLE__) +#import +#include +#include +#endif + +// #define TEST_NATIVE_CLIENT_ON_WINDOWS + +#ifdef TEST_NATIVE_CLIENT_ON_WINDOWS +#define __native_client__ +typedef int PP_Resource; +#endif + +namespace RakNet +{ + +class RakNetSocket2; +struct RNS2_BerkleyBindParameters; +struct RNS2_SendParameters; +typedef int RNS2Socket; + +enum RNS2BindResult +{ + BR_SUCCESS, + BR_REQUIRES_RAKNET_SUPPORT_IPV6_DEFINE, + BR_FAILED_TO_BIND_SOCKET, + BR_FAILED_SEND_TEST, +}; + +typedef int RNS2SendResult; + +enum RNS2Type +{ + RNS2T_WINDOWS_STORE_8, + RNS2T_PS3, + RNS2T_PS4, + RNS2T_CHROME, + RNS2T_VITA, + RNS2T_XBOX_360, + RNS2T_XBOX_720, + RNS2T_WINDOWS, + RNS2T_LINUX +}; + +struct RNS2_SendParameters +{ + RNS2_SendParameters() {ttl=0;} + char *data; + int length; + SystemAddress systemAddress; + int ttl; +}; + +struct RNS2RecvStruct +{ + + + + char data[MAXIMUM_MTU_SIZE]; + + int bytesRead; + SystemAddress systemAddress; + RakNet::TimeUS timeRead; + RakNetSocket2 *socket; +}; + +class RakNetSocket2Allocator +{ +public: + static RakNetSocket2* AllocRNS2(void); + static void DeallocRNS2(RakNetSocket2 *s); +}; + +class RAK_DLL_EXPORT RNS2EventHandler +{ +public: + RNS2EventHandler() {} + virtual ~RNS2EventHandler() {} + + // bufferedPackets.Push(recvFromStruct); + // quitAndDataEvents.SetEvent(); + virtual void OnRNS2Recv(RNS2RecvStruct *recvStruct)=0; + virtual void DeallocRNS2RecvStruct(RNS2RecvStruct *s, const char *file, unsigned int line)=0; + virtual RNS2RecvStruct *AllocRNS2RecvStruct(const char *file, unsigned int line)=0; + + // recvFromStruct=bufferedPackets.Allocate( _FILE_AND_LINE_ ); + // DataStructures::ThreadsafeAllocatingQueue bufferedPackets; +}; + +class RakNetSocket2 +{ +public: + RakNetSocket2(); + virtual ~RakNetSocket2(); + + // In order for the handler to trigger, some platforms must call PollRecvFrom, some platforms this create an internal thread. + void SetRecvEventHandler(RNS2EventHandler *_eventHandler); + virtual RNS2SendResult Send( RNS2_SendParameters *sendParameters, const char *file, unsigned int line )=0; + RNS2Type GetSocketType(void) const; + void SetSocketType(RNS2Type t); + bool IsBerkleySocket(void) const; + SystemAddress GetBoundAddress(void) const; + unsigned int GetUserConnectionSocketIndex(void) const; + void SetUserConnectionSocketIndex(unsigned int i); + RNS2EventHandler * GetEventHandler(void) const; + + // ----------- STATICS ------------ + static void GetMyIP( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); + static void DomainNameToIP( const char *domainName, char ip[65] ); + +protected: + RNS2EventHandler *eventHandler; + RNS2Type socketType; + SystemAddress boundAddress; + unsigned int userConnectionSocketIndex; +}; + +#if defined(WINDOWS_STORE_RT) + +ref class ListenerContext; + +// #include +//#include +#include "DS_List.hpp" +class RNS2_WindowsStore8 : public RakNetSocket2 +{ +public: + RNS2_WindowsStore8(); + ~RNS2_WindowsStore8(); + + virtual RNS2SendResult Send( RNS2_SendParameters *sendParameters, const char *file, unsigned int line ); + RNS2BindResult Bind( Platform::String ^localServiceName ); + // ----------- STATICS ------------ + static void GetMyIP( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); + static void DomainNameToIP( const char *domainName, char ip[65] ); + + static int WinRTInet_Addr(const char * cp); + + static int WinRTSetSockOpt(Windows::Networking::Sockets::DatagramSocket ^s, + int level, + int optname, + const char * optval, + socklen_t optlen); + + static int WinRTIOCTLSocket(Windows::Networking::Sockets::DatagramSocket ^s, + long cmd, + unsigned long *argp); + + static int WinRTGetSockName(Windows::Networking::Sockets::DatagramSocket ^s, + struct sockaddr *name, + socklen_t* namelen); + + static RNS2_WindowsStore8 *GetRNS2FromDatagramSocket(Windows::Networking::Sockets::DatagramSocket^ s); +protected: + static DataStructures::List rns2List; + static SimpleMutex rns2ListMutex; + + Windows::Networking::Sockets::DatagramSocket^ listener; + // Platform::Collections::Map ^outputStreamMap; + // Platform::Collections::Map^ m; + //std::map<> m; + ListenerContext^ listenerContext; +}; +#elif defined(__native_client__) +struct NativeClientBindParameters +{ + _PP_Instance_ nativeClientInstance; + unsigned short port; + const char *forceHostAddress; + bool is_ipv6; + RNS2EventHandler *eventHandler; +}; +class RNS2_NativeClient; +struct RNS2_SendParameters_NativeClient : public RNS2_SendParameters +{ + RNS2_NativeClient *socket2; +}; +class RNS2_NativeClient : public RakNetSocket2 +{ +public: + RNS2_NativeClient(); + virtual ~RNS2_NativeClient(); + RNS2BindResult Bind( NativeClientBindParameters *bindParameters, const char *file, unsigned int line ); + RNS2SendResult Send( RNS2_SendParameters *sendParameters, const char *file, unsigned int line ); + const NativeClientBindParameters *GetBindings(void) const; + + // ----------- STATICS ------------ + static bool IsPortInUse(unsigned short port, const char *hostAddress, unsigned short addressFamily, int type ); + static void GetMyIP( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); + + // RNS2_NativeClient doesn't automatically call recvfrom in a thread - user must call Update() from the main thread + // This causes buffered sends to send, until send is asynch pending + // It causes recvfrom events to trigger the callback, and push a message to the event handler + // + // Example: + // + // DataStructures::List< RakNet::RakNetSocket2* > sockets; + // rakPeerInterface->GetSockets(sockets); + // for (unsigned int i=0; i < sockets.Size(); i++) + // { + // ((RNS2_NativeClient*)sockets[i])->Update(); + // } + + void Update(void); +protected: + void ProcessBufferedSend(void); + static void SendImmediate(RNS2_SendParameters_NativeClient *sp); + static void DeallocSP(RNS2_SendParameters_NativeClient *sp); + static RNS2_SendParameters_NativeClient* CloneSP(RNS2_SendParameters *sp, RNS2_NativeClient *socket2, const char *file, unsigned int line); + static void onRecvFrom(void* pData, int32_t dataSize); + void IssueReceiveCall(void); + static void onSocketBound(void* pData, int32_t dataSize); + static void onSendTo(void* pData, int32_t dataSize); + void BufferSend( RNS2_SendParameters *sendParameters, const char *file, unsigned int line ); + PP_Resource rns2Socket; + NativeClientBindParameters binding; + bool sendInProgress; + SimpleMutex sendInProgressMutex; + + enum BindState + { + BS_UNBOUND, + BS_IN_PROGRESS, + BS_BOUND, + BS_FAILED + } bindState; + DataStructures::Queue bufferedSends; + SimpleMutex bufferedSendsMutex; +}; +#else // defined(WINDOWS_STORE_RT) + +struct RNS2_BerkleyBindParameters +{ + // Input parameters + unsigned short port; + char *hostAddress; + unsigned short addressFamily; // AF_INET or AF_INET6 + int type; // SOCK_DGRAM + int protocol; // 0 + bool nonBlockingSocket; + int setBroadcast; + int setIPHdrIncl; + int doNotFragment; + int pollingThreadPriority; + RNS2EventHandler *eventHandler; + unsigned short remotePortRakNetWasStartedOn_PS3_PS4_PSP2; +}; + +// Every platform except Windows Store 8 can use the Berkley sockets interface +class IRNS2_Berkley : public RakNetSocket2 +{ +public: + // ----------- STATICS ------------ + // For addressFamily, use AF_INET + // For type, use SOCK_DGRAM + static bool IsPortInUse(unsigned short port, const char *hostAddress, unsigned short addressFamily, int type ); + + // ----------- MEMBERS ------------ + virtual RNS2BindResult Bind( RNS2_BerkleyBindParameters *bindParameters, const char *file, unsigned int line )=0; +}; +// Every platform that uses Berkley sockets, except native client, can compile some common functions +class RNS2_Berkley : public IRNS2_Berkley +{ +public: + RNS2_Berkley(); + virtual ~RNS2_Berkley(); + int CreateRecvPollingThread(int threadPriority); + void SignalStopRecvPollingThread(void); + void BlockOnStopRecvPollingThread(void); + const RNS2_BerkleyBindParameters *GetBindings(void) const; + RNS2Socket GetSocket(void) const; + void SetDoNotFragment( int opt ); + +protected: + // Used by other classes + RNS2BindResult BindShared( RNS2_BerkleyBindParameters *bindParameters, const char *file, unsigned int line ); + RNS2BindResult BindSharedIPV4( RNS2_BerkleyBindParameters *bindParameters, const char *file, unsigned int line ); + RNS2BindResult BindSharedIPV4And6( RNS2_BerkleyBindParameters *bindParameters, const char *file, unsigned int line ); + + static void GetSystemAddressIPV4 ( RNS2Socket rns2Socket, SystemAddress *systemAddressOut ); + static void GetSystemAddressIPV4And6 ( RNS2Socket rns2Socket, SystemAddress *systemAddressOut ); + + // Internal + void SetNonBlockingSocket(unsigned long nonblocking); + void SetSocketOptions(void); + void SetBroadcastSocket(int broadcast); + void SetIPHdrIncl(int ipHdrIncl); + void RecvFromBlocking(RNS2RecvStruct *recvFromStruct); + void RecvFromBlockingIPV4(RNS2RecvStruct *recvFromStruct); + void RecvFromBlockingIPV4And6(RNS2RecvStruct *recvFromStruct); + + RNS2Socket rns2Socket; + RNS2_BerkleyBindParameters binding; + + unsigned RecvFromLoopInt(void); + RakNet::LocklessUint32_t isRecvFromLoopThreadActive; + volatile bool endThreads; + // Constructor not called! + +#if defined(__APPLE__) + // http://sourceforge.net/p/open-dis/discussion/683284/thread/0929d6a0 + CFSocketRef _cfSocket; +#endif + + static RAK_THREAD_DECLARATION(RecvFromLoop); +}; + + + + + + + + + + + + + + + + + +#if defined(_WIN32) || defined(__GNUC__) || defined(__GCCXML__) || defined(__S3E__) +class RNS2_Windows_Linux_360 +{ +public: +protected: + static RNS2SendResult Send_Windows_Linux_360NoVDP( RNS2Socket rns2Socket, RNS2_SendParameters *sendParameters, const char *file, unsigned int line ); +}; +#endif + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +#if defined(_WIN32) + +class RAK_DLL_EXPORT SocketLayerOverride +{ +public: + SocketLayerOverride() {} + virtual ~SocketLayerOverride() {} + + /// Called when SendTo would otherwise occur. + virtual int RakNetSendTo( const char *data, int length, const SystemAddress &systemAddress )=0; + + /// Called when RecvFrom would otherwise occur. Return number of bytes read. Write data into dataOut + // Return -1 to use RakNet's normal recvfrom, 0 to abort RakNet's normal recvfrom, and positive to return data + virtual int RakNetRecvFrom( char dataOut[ MAXIMUM_MTU_SIZE ], SystemAddress *senderOut, bool calledFromMainThread )=0; +}; + +class RNS2_Windows : public RNS2_Berkley, public RNS2_Windows_Linux_360 +{ +public: + RNS2_Windows(); + virtual ~RNS2_Windows(); + RNS2BindResult Bind( RNS2_BerkleyBindParameters *bindParameters, const char *file, unsigned int line ); + RNS2SendResult Send( RNS2_SendParameters *sendParameters, const char *file, unsigned int line ); + void SetSocketLayerOverride(SocketLayerOverride *_slo); + SocketLayerOverride* GetSocketLayerOverride(void); + // ----------- STATICS ------------ + static void GetMyIP( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); +protected: + static void GetMyIPIPV4( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); + static void GetMyIPIPV4And6( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); + SocketLayerOverride *slo; +}; + +#else +class RNS2_Linux : public RNS2_Berkley, public RNS2_Windows_Linux_360 +{ +public: + RNS2BindResult Bind( RNS2_BerkleyBindParameters *bindParameters, const char *file, unsigned int line ); + RNS2SendResult Send( RNS2_SendParameters *sendParameters, const char *file, unsigned int line ); + + // ----------- STATICS ------------ + static void GetMyIP( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); +protected: + static void GetMyIPIPV4( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); + static void GetMyIPIPV4And6( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); +}; + +#endif // Linux + +#endif // #elif !defined(WINDOWS_STORE_RT) + +} // namespace RakNet + +#endif // __RAKNET_SOCKET_2_H diff --git a/include/raknet/RakNetStatistics.hpp b/include/raknet/RakNetStatistics.hpp new file mode 100644 index 0000000..c2b400b --- /dev/null +++ b/include/raknet/RakNetStatistics.hpp @@ -0,0 +1,133 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief A structure that holds all statistical data returned by RakNet. +/// + + + +#ifndef __RAK_NET_STATISTICS_H +#define __RAK_NET_STATISTICS_H + +#include "PacketPriority.hpp" +#include "Export.hpp" +#include "RakNetTypes.hpp" + +namespace RakNet +{ + +enum RNSPerSecondMetrics +{ + /// How many bytes per pushed via a call to RakPeerInterface::Send() + USER_MESSAGE_BYTES_PUSHED, + + /// How many user message bytes were sent via a call to RakPeerInterface::Send(). This is less than or equal to USER_MESSAGE_BYTES_PUSHED. + /// A message would be pushed, but not yet sent, due to congestion control + USER_MESSAGE_BYTES_SENT, + + /// How many user message bytes were resent. A message is resent if it is marked as reliable, and either the message didn't arrive or the message ack didn't arrive. + USER_MESSAGE_BYTES_RESENT, + + /// How many user message bytes were received, and returned to the user successfully. + USER_MESSAGE_BYTES_RECEIVED_PROCESSED, + + /// How many user message bytes were received, but ignored due to data format errors. This will usually be 0. + USER_MESSAGE_BYTES_RECEIVED_IGNORED, + + /// How many actual bytes were sent, including per-message and per-datagram overhead, and reliable message acks + ACTUAL_BYTES_SENT, + + /// How many actual bytes were received, including overead and acks. + ACTUAL_BYTES_RECEIVED, + + /// \internal + RNS_PER_SECOND_METRICS_COUNT +}; + +/// \brief Network Statisics Usage +/// +/// Store Statistics information related to network usage +struct RAK_DLL_EXPORT RakNetStatistics +{ + /// For each type in RNSPerSecondMetrics, what is the value over the last 1 second? + uint64_t valueOverLastSecond[RNS_PER_SECOND_METRICS_COUNT]; + + /// For each type in RNSPerSecondMetrics, what is the total value over the lifetime of the connection? + uint64_t runningTotal[RNS_PER_SECOND_METRICS_COUNT]; + + /// When did the connection start? + /// \sa RakNet::GetTimeUS() + RakNet::TimeUS connectionStartTime; + + /// Is our current send rate throttled by congestion control? + /// This value should be true if you send more data per second than your bandwidth capacity + bool isLimitedByCongestionControl; + + /// If \a isLimitedByCongestionControl is true, what is the limit, in bytes per second? + uint64_t BPSLimitByCongestionControl; + + /// Is our current send rate throttled by a call to RakPeer::SetPerConnectionOutgoingBandwidthLimit()? + bool isLimitedByOutgoingBandwidthLimit; + + /// If \a isLimitedByOutgoingBandwidthLimit is true, what is the limit, in bytes per second? + uint64_t BPSLimitByOutgoingBandwidthLimit; + + /// For each priority level, how many messages are waiting to be sent out? + unsigned int messageInSendBuffer[NUMBER_OF_PRIORITIES]; + + /// For each priority level, how many bytes are waiting to be sent out? + double bytesInSendBuffer[NUMBER_OF_PRIORITIES]; + + /// How many messages are waiting in the resend buffer? This includes messages waiting for an ack, so should normally be a small value + /// If the value is rising over time, you are exceeding the bandwidth capacity. See BPSLimitByCongestionControl + unsigned int messagesInResendBuffer; + + /// How many bytes are waiting in the resend buffer. See also messagesInResendBuffer + uint64_t bytesInResendBuffer; + + /// Over the last second, what was our packetloss? This number will range from 0.0 (for none) to 1.0 (for 100%) + float packetlossLastSecond; + + /// What is the average total packetloss over the lifetime of the connection? + float packetlossTotal; + + RakNetStatistics& operator +=(const RakNetStatistics& other) + { + unsigned i; + for (i=0; i < NUMBER_OF_PRIORITIES; i++) + { + messageInSendBuffer[i]+=other.messageInSendBuffer[i]; + bytesInSendBuffer[i]+=other.bytesInSendBuffer[i]; + } + + for (i=0; i < RNS_PER_SECOND_METRICS_COUNT; i++) + { + valueOverLastSecond[i]+=other.valueOverLastSecond[i]; + runningTotal[i]+=other.runningTotal[i]; + } + + return *this; + } +}; + +/// Verbosity level currently supports 0 (low), 1 (medium), 2 (high) +/// \param[in] s The Statistical information to format out +/// \param[in] buffer The buffer containing a formated report +/// \param[in] verbosityLevel +/// 0 low +/// 1 medium +/// 2 high +/// 3 debugging congestion control +void RAK_DLL_EXPORT StatisticsToString( RakNetStatistics *s, char *buffer, int verbosityLevel ); + +} // namespace RakNet + +#endif diff --git a/include/raknet/RakNetTime.hpp b/include/raknet/RakNetTime.hpp new file mode 100644 index 0000000..df5aca7 --- /dev/null +++ b/include/raknet/RakNetTime.hpp @@ -0,0 +1,33 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAKNET_TIME_H +#define __RAKNET_TIME_H + +#include "NativeTypes.hpp" +#include "RakNetDefines.hpp" + +namespace RakNet { + +// Define __GET_TIME_64BIT if you want to use large types for GetTime (takes more bandwidth when you transmit time though!) +// You would want to do this if your system is going to run long enough to overflow the millisecond counter (over a month) +#if __GET_TIME_64BIT==1 +typedef uint64_t Time; +typedef uint32_t TimeMS; +typedef uint64_t TimeUS; +#else +typedef uint32_t Time; +typedef uint32_t TimeMS; +typedef uint64_t TimeUS; +#endif + +} // namespace RakNet + +#endif diff --git a/include/raknet/RakNetTransport2.hpp b/include/raknet/RakNetTransport2.hpp new file mode 100644 index 0000000..0f1f541 --- /dev/null +++ b/include/raknet/RakNetTransport2.hpp @@ -0,0 +1,110 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains RakNetTransportCommandParser and RakNetTransport used to provide a secure console connection. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_TelnetTransport==1 + +#ifndef __RAKNET_TRANSPORT_2 +#define __RAKNET_TRANSPORT_2 + +#include "TransportInterface.hpp" +#include "DS_Queue.hpp" +#include "CommandParserInterface.hpp" +#include "PluginInterface2.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class BitStream; +class RakPeerInterface; +class RakNetTransport; + +/// \defgroup RAKNET_TRANSPORT_GROUP RakNetTransport +/// \brief UDP based transport implementation for the ConsoleServer +/// \details +/// \ingroup PLUGINS_GROUP + +/// \brief Use RakNetTransport if you need a secure connection between the client and the console server. +/// \details RakNetTransport automatically initializes security for the system. Use the project CommandConsoleClient to connect +/// To the ConsoleServer if you use RakNetTransport +/// \ingroup RAKNET_TRANSPORT_GROUP +class RAK_DLL_EXPORT RakNetTransport2 : public TransportInterface, public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(RakNetTransport2) + + RakNetTransport2(); + virtual ~RakNetTransport2(); + + /// Start the transport provider on the indicated port. + /// \param[in] port The port to start the transport provider on + /// \param[in] serverMode If true, you should allow incoming connections (I don't actually use this anywhere) + /// \return Return true on success, false on failure. + bool Start(unsigned short port, bool serverMode); + + /// Stop the transport provider. You can clear memory and shutdown threads here. + void Stop(void); + + /// Send a null-terminated string to \a systemAddress + /// If your transport method requires particular formatting of the outgoing data (e.g. you don't just send strings) you can do it here + /// and parse it out in Receive(). + /// \param[in] systemAddress The player to send the string to + /// \param[in] data format specifier - same as RAKNET_DEBUG_PRINTF + /// \param[in] ... format specification arguments - same as RAKNET_DEBUG_PRINTF + void Send( SystemAddress systemAddress, const char *data, ... ); + + /// Disconnect \a systemAddress . The binary address and port defines the SystemAddress structure. + /// \param[in] systemAddress The player/address to disconnect + void CloseConnection( SystemAddress systemAddress ); + + /// Return a string. The string should be allocated and written to Packet::data . + /// The byte length should be written to Packet::length . The player/address should be written to Packet::systemAddress + /// If your transport protocol adds special formatting to the data stream you should parse it out before returning it in the packet + /// and thus only return a string in Packet::data + /// \return The packet structure containing the result of Receive, or 0 if no data is available + Packet* Receive( void ); + + /// Deallocate the Packet structure returned by Receive + /// \param[in] The packet to deallocate + void DeallocatePacket( Packet *packet ); + + /// If a new system connects to you, you should queue that event and return the systemAddress/address of that player in this function. + /// \return The SystemAddress/address of the system + SystemAddress HasNewIncomingConnection(void); + + /// If a system loses the connection, you should queue that event and return the systemAddress/address of that player in this function. + /// \return The SystemAddress/address of the system + SystemAddress HasLostConnection(void); + + virtual CommandParserInterface* GetCommandParser(void) {return 0;} + + /// \internal + virtual PluginReceiveResult OnReceive(Packet *packet); + /// \internal + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + /// \internal + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); +protected: + DataStructures::Queue newConnections, lostConnections; + DataStructures::Queue packetQueue; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/RakNetTypes.hpp b/include/raknet/RakNetTypes.hpp new file mode 100644 index 0000000..7db2ce3 --- /dev/null +++ b/include/raknet/RakNetTypes.hpp @@ -0,0 +1,507 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Types used by RakNet, most of which involve user code. +/// + + +#ifndef __NETWORK_TYPES_H +#define __NETWORK_TYPES_H + + + + + +#include "RakNetDefines.hpp" +#include "NativeTypes.hpp" +#include "RakNetTime.hpp" +#include "Export.hpp" +#include "WindowsIncludes.hpp" +#include "XBox360Includes.hpp" +#include "SocketIncludes.hpp" + + + + + +namespace RakNet { +/// Forward declarations +class RakPeerInterface; +class BitStream; +struct Packet; + +enum StartupResult +{ + RAKNET_STARTED, + RAKNET_ALREADY_STARTED, + INVALID_SOCKET_DESCRIPTORS, + INVALID_MAX_CONNECTIONS, + SOCKET_FAMILY_NOT_SUPPORTED, + SOCKET_PORT_ALREADY_IN_USE, + SOCKET_FAILED_TO_BIND, + SOCKET_FAILED_TEST_SEND, + PORT_CANNOT_BE_ZERO, + FAILED_TO_CREATE_NETWORK_THREAD, + COULD_NOT_GENERATE_GUID, + STARTUP_OTHER_FAILURE +}; + + +enum ConnectionAttemptResult +{ + CONNECTION_ATTEMPT_STARTED, + INVALID_PARAMETER, + CANNOT_RESOLVE_DOMAIN_NAME, + ALREADY_CONNECTED_TO_ENDPOINT, + CONNECTION_ATTEMPT_ALREADY_IN_PROGRESS, + SECURITY_INITIALIZATION_FAILED +}; + +/// Returned from RakPeerInterface::GetConnectionState() +enum ConnectionState +{ + /// Connect() was called, but the process hasn't started yet + IS_PENDING, + /// Processing the connection attempt + IS_CONNECTING, + /// Is connected and able to communicate + IS_CONNECTED, + /// Was connected, but will disconnect as soon as the remaining messages are delivered + IS_DISCONNECTING, + /// A connection attempt failed and will be aborted + IS_SILENTLY_DISCONNECTING, + /// No longer connected + IS_DISCONNECTED, + /// Was never connected, or else was disconnected long enough ago that the entry has been discarded + IS_NOT_CONNECTED +}; + +/// Given a number of bits, return how many bytes are needed to represent that. +#define BITS_TO_BYTES(x) (((x)+7)>>3) +#define BYTES_TO_BITS(x) ((x)<<3) + +/// \sa NetworkIDObject.h +typedef unsigned char UniqueIDType; +typedef unsigned short SystemIndex; +typedef unsigned char RPCIndex; +const int MAX_RPC_MAP_SIZE=((RPCIndex)-1)-1; +const int UNDEFINED_RPC_INDEX=((RPCIndex)-1); + +/// First byte of a network message +typedef unsigned char MessageID; + +typedef uint32_t BitSize_t; + +#if defined(_MSC_VER) && _MSC_VER > 0 +#define PRINTF_64_BIT_MODIFIER "I64" +#else +#define PRINTF_64_BIT_MODIFIER "ll" +#endif + +/// Used with the PublicKey structure +enum PublicKeyMode +{ + /// The connection is insecure. You can also just pass 0 for the pointer to PublicKey in RakPeerInterface::Connect() + PKM_INSECURE_CONNECTION, + + /// Accept whatever public key the server gives us. This is vulnerable to man in the middle, but does not require + /// distribution of the public key in advance of connecting. + PKM_ACCEPT_ANY_PUBLIC_KEY, + + /// Use a known remote server public key. PublicKey::remoteServerPublicKey must be non-zero. + /// This is the recommended mode for secure connections. + PKM_USE_KNOWN_PUBLIC_KEY, + + /// Use a known remote server public key AND provide a public key for the connecting client. + /// PublicKey::remoteServerPublicKey, myPublicKey and myPrivateKey must be all be non-zero. + /// The server must cooperate for this mode to work. + /// I recommend not using this mode except for server-to-server communication as it significantly increases the CPU requirements during connections for both sides. + /// Furthermore, when it is used, a connection password should be used as well to avoid DoS attacks. + PKM_USE_TWO_WAY_AUTHENTICATION +}; + +/// Passed to RakPeerInterface::Connect() +struct RAK_DLL_EXPORT PublicKey +{ + /// How to interpret the public key, see above + PublicKeyMode publicKeyMode; + + /// Pointer to a public key of length cat::EasyHandshake::PUBLIC_KEY_BYTES. See the Encryption sample. + char *remoteServerPublicKey; + + /// (Optional) Pointer to a public key of length cat::EasyHandshake::PUBLIC_KEY_BYTES + char *myPublicKey; + + /// (Optional) Pointer to a private key of length cat::EasyHandshake::PRIVATE_KEY_BYTES + char *myPrivateKey; +}; + +/// Describes the local socket to use for RakPeer::Startup +struct RAK_DLL_EXPORT SocketDescriptor +{ + SocketDescriptor(); + SocketDescriptor(unsigned short _port, const char *_hostAddress); + + /// The local port to bind to. Pass 0 to have the OS autoassign a port. + unsigned short port; + + /// The local network card address to bind to, such as "127.0.0.1". Pass an empty string to use INADDR_ANY. + char hostAddress[32]; + + /// IP version: For IPV4, use AF_INET (default). For IPV6, use AF_INET6. To autoselect, use AF_UNSPEC. + /// IPV6 is the newer internet protocol. Instead of addresses such as natpunch.jenkinssoftware.com, you may have an address such as fe80::7c:31f7:fec4:27de%14. + /// Encoding takes 16 bytes instead of 4, so IPV6 is less efficient for bandwidth. + /// On the positive side, NAT Punchthrough is not needed and should not be used with IPV6 because there are enough addresses that routers do not need to create address mappings. + /// RakPeer::Startup() will fail if this IP version is not supported. + /// \pre RAKNET_SUPPORT_IPV6 must be set to 1 in RakNetDefines.h for AF_INET6 + short socketFamily; + + + + + + + + + + unsigned short remotePortRakNetWasStartedOn_PS3_PSP2; + + // Required for Google chrome + _PP_Instance_ chromeInstance; + + // Set to true to use a blocking socket (default, do not change unless you have a reason to) + bool blockingSocket; + + /// XBOX only: set IPPROTO_VDP if you want to use VDP. If enabled, this socket does not support broadcast to 255.255.255.255 + unsigned int extraSocketOptions; +}; + +extern bool NonNumericHostString( const char *host ); + +/// \brief Network address for a system +/// \details Corresponds to a network address
+/// This is not necessarily a unique identifier. For example, if a system has both LAN and internet connections, the system may be identified by either one, depending on who is communicating
+/// Therefore, you should not transmit the SystemAddress over the network and expect it to identify a system, or use it to connect to that system, except in the case where that system is not behind a NAT (such as with a dedciated server) +/// Use RakNetGUID for a unique per-instance of RakPeer to identify systems +struct RAK_DLL_EXPORT SystemAddress +{ + /// Constructors + SystemAddress(); + SystemAddress(const char *str); + SystemAddress(const char *str, unsigned short port); + + + + + + + + + + + /// SystemAddress, with RAKNET_SUPPORT_IPV6 defined, holds both an sockaddr_in6 and a sockaddr_in + union// In6OrIn4 + { +#if RAKNET_SUPPORT_IPV6==1 + struct sockaddr_storage sa_stor; + sockaddr_in6 addr6; +#endif + + sockaddr_in addr4; + } address; + + /// This is not used internally, but holds a copy of the port held in the address union, so for debugging it's easier to check what port is being held + unsigned short debugPort; + + /// \internal Return the size to write to a bitStream + static int size(void); + + /// Hash the system address + static unsigned long ToInteger( const SystemAddress &sa ); + + /// Return the IP version, either IPV4 or IPV6 + /// \return Either 4 or 6 + unsigned char GetIPVersion(void) const; + + /// \internal Returns either IPPROTO_IP or IPPROTO_IPV6 + /// \sa GetIPVersion + unsigned int GetIPPROTO(void) const; + + /// Call SetToLoopback(), with whatever IP version is currently held. Defaults to IPV4 + void SetToLoopback(void); + + /// Call SetToLoopback() with a specific IP version + /// \param[in] ipVersion Either 4 for IPV4 or 6 for IPV6 + void SetToLoopback(unsigned char ipVersion); + + /// \return If was set to 127.0.0.1 or ::1 + bool IsLoopback(void) const; + + // Return the systemAddress as a string in the format | + // Returns a static string + // NOT THREADSAFE + // portDelineator should not be '.', ':', '%', '-', '/', a number, or a-f + const char *ToString(bool writePort=true, char portDelineator='|') const; + + // Return the systemAddress as a string in the format | + // dest must be large enough to hold the output + // portDelineator should not be '.', ':', '%', '-', '/', a number, or a-f + // THREADSAFE + void ToString(bool writePort, char *dest, char portDelineator='|') const; + + /// Set the system address from a printable IP string, for example "192.0.2.1" or "2001:db8:63b3:1::3490" + /// You can write the port as well, using the portDelineator, for example "192.0.2.1|1234" + /// \param[in] str A printable IP string, for example "192.0.2.1" or "2001:db8:63b3:1::3490". Pass 0 for \a str to set to UNASSIGNED_SYSTEM_ADDRESS + /// \param[in] portDelineator if \a str contains a port, delineate the port with this character. portDelineator should not be '.', ':', '%', '-', '/', a number, or a-f + /// \param[in] ipVersion Only used if str is a pre-defined address in the wrong format, such as 127.0.0.1 but you want ip version 6, so you can pass 6 here to do the conversion + /// \note The current port is unchanged if a port is not specified in \a str + /// \return True on success, false on ipVersion does not match type of passed string + bool FromString(const char *str, char portDelineator='|', int ipVersion=0); + + /// Same as FromString(), but you explicitly set a port at the same time + bool FromStringExplicitPort(const char *str, unsigned short port, int ipVersion=0); + + /// Copy the port from another SystemAddress structure + void CopyPort( const SystemAddress& right ); + + /// Returns if two system addresses have the same IP (port is not checked) + bool EqualsExcludingPort( const SystemAddress& right ) const; + + /// Returns the port in host order (this is what you normally use) + unsigned short GetPort(void) const; + + /// \internal Returns the port in network order + unsigned short GetPortNetworkOrder(void) const; + + /// Sets the port. The port value should be in host order (this is what you normally use) + /// Renamed from SetPort because of winspool.h http://edn.embarcadero.com/article/21494 + void SetPortHostOrder(unsigned short s); + + /// \internal Sets the port. The port value should already be in network order. + void SetPortNetworkOrder(unsigned short s); + + /// Old version, for crap platforms that don't support newer socket functions + bool SetBinaryAddress(const char *str, char portDelineator=':'); + /// Old version, for crap platforms that don't support newer socket functions + void ToString_Old(bool writePort, char *dest, char portDelineator=':') const; + + /// \internal sockaddr_in6 requires extra data beyond just the IP and port. Copy that extra data from an existing SystemAddress that already has it + void FixForIPVersion(const SystemAddress &boundAddressToSocket); + + bool IsLANAddress(void); + + SystemAddress& operator = ( const SystemAddress& input ); + bool operator==( const SystemAddress& right ) const; + bool operator!=( const SystemAddress& right ) const; + bool operator > ( const SystemAddress& right ) const; + bool operator < ( const SystemAddress& right ) const; + + /// \internal Used internally for fast lookup. Optional (use -1 to do regular lookup). Don't transmit this. + SystemIndex systemIndex; + + private: + +#if RAKNET_SUPPORT_IPV6==1 + void ToString_New(bool writePort, char *dest, char portDelineator) const; +#endif +}; + +/// Uniquely identifies an instance of RakPeer. Use RakPeer::GetGuidFromSystemAddress() and RakPeer::GetSystemAddressFromGuid() to go between SystemAddress and RakNetGUID +/// Use RakPeer::GetGuidFromSystemAddress(UNASSIGNED_SYSTEM_ADDRESS) to get your own GUID +struct RAK_DLL_EXPORT RakNetGUID +{ + RakNetGUID(); + explicit RakNetGUID(uint64_t _g) {g=_g; systemIndex=(SystemIndex)-1;} +// uint32_t g[6]; + uint64_t g; + + // Return the GUID as a string + // Returns a static string + // NOT THREADSAFE + const char *ToString(void) const; + + // Return the GUID as a string + // dest must be large enough to hold the output + // THREADSAFE + void ToString(char *dest) const; + + bool FromString(const char *source); + + static unsigned long ToUint32( const RakNetGUID &g ); + + RakNetGUID& operator = ( const RakNetGUID& input ) + { + g=input.g; + systemIndex=input.systemIndex; + return *this; + } + + // Used internally for fast lookup. Optional (use -1 to do regular lookup). Don't transmit this. + SystemIndex systemIndex; + static int size() {return (int) sizeof(uint64_t);} + + bool operator==( const RakNetGUID& right ) const; + bool operator!=( const RakNetGUID& right ) const; + bool operator > ( const RakNetGUID& right ) const; + bool operator < ( const RakNetGUID& right ) const; +}; + +/// Index of an invalid SystemAddress +//const SystemAddress UNASSIGNED_SYSTEM_ADDRESS = +//{ +// 0xFFFFFFFF, 0xFFFF +//}; +#ifndef SWIG +const SystemAddress UNASSIGNED_SYSTEM_ADDRESS; +const RakNetGUID UNASSIGNED_RAKNET_GUID((uint64_t)-1); +#endif +//{ +// {0xFFFFFFFF,0xFFFFFFFF,0xFFFFFFFF,0xFFFFFFFF,0xFFFFFFFF,0xFFFFFFFF} +// 0xFFFFFFFFFFFFFFFF +//}; + + +struct RAK_DLL_EXPORT AddressOrGUID +{ + RakNetGUID rakNetGuid; + SystemAddress systemAddress; + + SystemIndex GetSystemIndex(void) const {if (rakNetGuid!=UNASSIGNED_RAKNET_GUID) return rakNetGuid.systemIndex; else return systemAddress.systemIndex;} + bool IsUndefined(void) const {return rakNetGuid==UNASSIGNED_RAKNET_GUID && systemAddress==UNASSIGNED_SYSTEM_ADDRESS;} + void SetUndefined(void) {rakNetGuid=UNASSIGNED_RAKNET_GUID; systemAddress=UNASSIGNED_SYSTEM_ADDRESS;} + static unsigned long ToInteger( const AddressOrGUID &aog ); + const char *ToString(bool writePort=true) const; + void ToString(bool writePort, char *dest) const; + + AddressOrGUID() {} + AddressOrGUID( const AddressOrGUID& input ) + { + rakNetGuid=input.rakNetGuid; + systemAddress=input.systemAddress; + } + AddressOrGUID( const SystemAddress& input ) + { + rakNetGuid=UNASSIGNED_RAKNET_GUID; + systemAddress=input; + } + AddressOrGUID( Packet *packet ); + AddressOrGUID( const RakNetGUID& input ) + { + rakNetGuid=input; + systemAddress=UNASSIGNED_SYSTEM_ADDRESS; + } + AddressOrGUID& operator = ( const AddressOrGUID& input ) + { + rakNetGuid=input.rakNetGuid; + systemAddress=input.systemAddress; + return *this; + } + + AddressOrGUID& operator = ( const SystemAddress& input ) + { + rakNetGuid=UNASSIGNED_RAKNET_GUID; + systemAddress=input; + return *this; + } + + AddressOrGUID& operator = ( const RakNetGUID& input ) + { + rakNetGuid=input; + systemAddress=UNASSIGNED_SYSTEM_ADDRESS; + return *this; + } + + inline bool operator==( const AddressOrGUID& right ) const {return (rakNetGuid!=UNASSIGNED_RAKNET_GUID && rakNetGuid==right.rakNetGuid) || (systemAddress!=UNASSIGNED_SYSTEM_ADDRESS && systemAddress==right.systemAddress);} +}; + +typedef uint64_t NetworkID; + +/// This represents a user message from another system. +struct Packet +{ + /// The system that send this packet. + SystemAddress systemAddress; + + /// A unique identifier for the system that sent this packet, regardless of IP address (internal / external / remote system) + /// Only valid once a connection has been established (ID_CONNECTION_REQUEST_ACCEPTED, or ID_NEW_INCOMING_CONNECTION) + /// Until that time, will be UNASSIGNED_RAKNET_GUID + RakNetGUID guid; + + /// The length of the data in bytes + unsigned int length; + + /// The length of the data in bits + BitSize_t bitSize; + + /// The data from the sender + unsigned char* data; + + /// @internal + /// Indicates whether to delete the data, or to simply delete the packet. + bool deleteData; + + /// @internal + /// If true, this message is meant for the user, not for the plugins, so do not process it through plugins + bool wasGeneratedLocally; +}; + +/// Index of an unassigned player +const SystemIndex UNASSIGNED_PLAYER_INDEX = 65535; + +/// Unassigned object ID +const NetworkID UNASSIGNED_NETWORK_ID = (uint64_t) -1; + +const int PING_TIMES_ARRAY_SIZE = 5; + +struct RAK_DLL_EXPORT uint24_t +{ + uint32_t val; + + uint24_t() {} + inline operator uint32_t() { return val; } + inline operator uint32_t() const { return val; } + + inline uint24_t(const uint24_t& a) {val=a.val;} + inline uint24_t operator++() {++val; val&=0x00FFFFFF; return *this;} + inline uint24_t operator--() {--val; val&=0x00FFFFFF; return *this;} + inline uint24_t operator++(int) {uint24_t temp(val); ++val; val&=0x00FFFFFF; return temp;} + inline uint24_t operator--(int) {uint24_t temp(val); --val; val&=0x00FFFFFF; return temp;} + inline uint24_t operator&(const uint24_t& a) {return uint24_t(val&a.val);} + inline uint24_t& operator=(const uint24_t& a) { val=a.val; return *this; } + inline uint24_t& operator+=(const uint24_t& a) { val+=a.val; val&=0x00FFFFFF; return *this; } + inline uint24_t& operator-=(const uint24_t& a) { val-=a.val; val&=0x00FFFFFF; return *this; } + inline bool operator==( const uint24_t& right ) const {return val==right.val;} + inline bool operator!=( const uint24_t& right ) const {return val!=right.val;} + inline bool operator > ( const uint24_t& right ) const {return val>right.val;} + inline bool operator < ( const uint24_t& right ) const {return val ( const uint32_t& right ) const {return val>(right&0x00FFFFFF);} + inline bool operator < ( const uint32_t& right ) const {return val<(right&0x00FFFFFF);} + inline const uint24_t operator+( const uint32_t &other ) const { return uint24_t(val+other); } + inline const uint24_t operator-( const uint32_t &other ) const { return uint24_t(val-other); } + inline const uint24_t operator/( const uint32_t &other ) const { return uint24_t(val/other); } + inline const uint24_t operator*( const uint32_t &other ) const { return uint24_t(val*other); } +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/RakNetVersion.hpp b/include/raknet/RakNetVersion.hpp new file mode 100644 index 0000000..359a52b --- /dev/null +++ b/include/raknet/RakNetVersion.hpp @@ -0,0 +1,19 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#define RAKNET_VERSION "4.081" +#define RAKNET_VERSION_NUMBER 4.081 +#define RAKNET_VERSION_NUMBER_INT 4081 + +#define RAKNET_DATE "5/28/2014" + +// What compatible protocol version RakNet is using. When this value changes, it indicates this version of RakNet cannot connection to an older version. +// ID_INCOMPATIBLE_PROTOCOL_VERSION will be returned on connection attempt in this case +#define RAKNET_PROTOCOL_VERSION 6 diff --git a/include/raknet/RakPeer.hpp b/include/raknet/RakPeer.hpp new file mode 100644 index 0000000..ab4766c --- /dev/null +++ b/include/raknet/RakPeer.hpp @@ -0,0 +1,1034 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Declares RakPeer class. +/// + + +// TODO - RakNet 4 - Add network simulator +// TODO - RakNet 4 - Enable disabling flow control per connections + +#ifndef __RAK_PEER_H +#define __RAK_PEER_H + +#include "ReliabilityLayer.hpp" +#include "RakPeerInterface.hpp" +#include "BitStream.hpp" +#include "SingleProducerConsumer.hpp" +#include "SimpleMutex.hpp" +#include "DS_OrderedList.hpp" +#include "Export.hpp" +#include "RakString.hpp" +#include "RakThread.hpp" +//#include "RakNetSocket.hpp" +#include "RakNetSmartPtr.hpp" +#include "DS_ThreadsafeAllocatingQueue.hpp" +#include "SignaledEvent.hpp" +#include "NativeFeatureIncludes.hpp" +#include "SecureHandshake.hpp" +#include "LocklessTypes.hpp" +#include "DS_Queue.hpp" + +namespace RakNet { +/// Forward declarations +class HuffmanEncodingTree; +class PluginInterface2; + +// Sucks but this struct has to be outside the class. Inside and DevCPP won't let you refer to the struct as RakPeer::RemoteSystemIndex while GCC +// forces you to do RakPeer::RemoteSystemIndex +struct RemoteSystemIndex{unsigned index; RemoteSystemIndex *next;}; +//int RAK_DLL_EXPORT SystemAddressAndIndexComp( const SystemAddress &key, const RemoteSystemIndex &data ); // GCC requires RakPeer::RemoteSystemIndex or it won't compile + +///\brief Main interface for network communications. +/// \details It implements most of RakNet's functionality and is the primary interface for RakNet. +/// +/// Inherits RakPeerInterface. +/// +/// See the individual functions for what the class can do. +/// +class RAK_DLL_EXPORT RakPeer : public RakPeerInterface, public RNS2EventHandler +{ +public: + ///Constructor + RakPeer(); + + ///Destructor + virtual ~RakPeer(); + + // --------------------------------------------------------------------------------------------Major Low Level Functions - Functions needed by most users-------------------------------------------------------------------------------------------- + /// \brief Starts the network threads and opens the listen port. + /// \details You must call this before calling Connect(). + /// \pre On the PS3, call Startup() after Client_Login() + /// \note Multiple calls while already active are ignored. To call this function again with different settings, you must first call Shutdown(). + /// \note Call SetMaximumIncomingConnections if you want to accept incoming connections. + /// \param[in] maxConnections Maximum number of connections between this instance of RakPeer and another instance of RakPeer. Required so that the network can preallocate and for thread safety. A pure client would set this to 1. A pure server would set it to the number of allowed clients.A hybrid would set it to the sum of both types of connections. + /// \param[in] localPort The port to listen for connections on. On linux the system may be set up so thast ports under 1024 are restricted for everything but the root user. Use a higher port for maximum compatibility. + /// \param[in] socketDescriptors An array of SocketDescriptor structures to force RakNet to listen on a particular IP address or port (or both). Each SocketDescriptor will represent one unique socket. Do not pass redundant structures. To listen on a specific port, you can pass SocketDescriptor(myPort,0); such as for a server. For a client, it is usually OK to just pass SocketDescriptor(); However, on the XBOX be sure to use IPPROTO_VDP + /// \param[in] socketDescriptorCount The size of the \a socketDescriptors array. Pass 1 if you are not sure what to pass. + /// \param[in] threadPriority Passed to the thread creation routine. Use THREAD_PRIORITY_NORMAL for Windows. For Linux based systems, you MUST pass something reasonable based on the thread priorities for your application. + /// \return RAKNET_STARTED on success, otherwise appropriate failure enumeration. + StartupResult Startup( unsigned int maxConnections, SocketDescriptor *socketDescriptors, unsigned socketDescriptorCount, int threadPriority=-99999 ); + + /// If you accept connections, you must call this or else security will not be enabled for incoming connections. + /// This feature requires more round trips, bandwidth, and CPU time for the connection handshake + /// x64 builds require under 25% of the CPU time of other builds + /// See the Encryption sample for example usage + /// \pre Must be called while offline + /// \pre LIBCAT_SECURITY must be defined to 1 in NativeFeatureIncludes.h for this function to have any effect + /// \param[in] publicKey A pointer to the public key for accepting new connections + /// \param[in] privateKey A pointer to the private key for accepting new connections + /// \param[in] bRequireClientKey: Should be set to false for most servers. Allows the server to accept a public key from connecting clients as a proof of identity but eats twice as much CPU time as a normal connection + bool InitializeSecurity( const char *publicKey, const char *privateKey, bool bRequireClientKey = false ); + + /// Disables security for incoming connections. + /// \note Must be called while offline + void DisableSecurity( void ); + + /// \brief This is useful if you have a fixed-address internal server behind a LAN. + /// + /// Secure connections are determined by the recipient of an incoming connection. This has no effect if called on the system attempting to connect. + /// \note If secure connections are on, do not use secure connections for a specific IP address. + /// \param[in] ip IP address to add. * wildcards are supported. + void AddToSecurityExceptionList(const char *ip); + + /// \brief Remove a specific connection previously added via AddToSecurityExceptionList. + /// \param[in] ip IP address to remove. Pass 0 to remove all IP addresses. * wildcards are supported. + void RemoveFromSecurityExceptionList(const char *ip); + + /// \brief Checks to see if a given IP is in the security exception list. + /// \param[in] IP address to check. + /// \return True if the IP address is found in security exception list, else returns false. + bool IsInSecurityExceptionList(const char *ip); + + /// \brief Sets the maximum number of incoming connections allowed. + /// \details If the number of incoming connections is less than the number of players currently connected, + /// no more players will be allowed to connect. If this is greater than the maximum number of peers allowed, + /// it will be reduced to the maximum number of peers allowed. + /// + /// Defaults to 0, meaning by default, nobody can connect to you + /// \param[in] numberAllowed Maximum number of incoming connections allowed. + void SetMaximumIncomingConnections( unsigned short numberAllowed ); + + /// \brief Returns the value passed to SetMaximumIncomingConnections(). + /// \return Maximum number of incoming connections, which is always <= maxConnections + unsigned int GetMaximumIncomingConnections( void ) const; + + /// \brief Returns how many open connections exist at this time. + /// \return Number of open connections. + unsigned short NumberOfConnections(void) const; + + /// \brief Sets the password for the incoming connections. + /// \details The password must match in the call to Connect (defaults to none). + /// Pass 0 to passwordData to specify no password. + /// This is a way to set a low level password for all incoming connections. To selectively reject connections, implement your own scheme using CloseConnection() to remove unwanted connections. + /// \param[in] passwordData A data block that incoming connections must match. This can be just a password, or can be a stream of data. Specify 0 for no password data + /// \param[in] passwordDataLength The length in bytes of passwordData + void SetIncomingPassword( const char* passwordData, int passwordDataLength ); + + /// \brief Gets the password passed to SetIncomingPassword + /// \param[out] passwordData Should point to a block large enough to hold the password data you passed to SetIncomingPassword() + /// \param[in,out] passwordDataLength Maximum size of the passwordData array. Modified to hold the number of bytes actually written. + void GetIncomingPassword( char* passwordData, int *passwordDataLength ); + + /// \brief Connect to the specified host (ip or domain name) and server port. + /// \details Calling Connect and not calling SetMaximumIncomingConnections acts as a dedicated client. + /// Calling both acts as a true peer. + /// + /// This is a non-blocking connection. + /// + /// The connection is successful when GetConnectionState() returns IS_CONNECTED or Receive() gets a message with the type identifier ID_CONNECTION_REQUEST_ACCEPTED. + /// If the connection is not successful, such as a rejected connection or no response then neither of these things will happen. + /// \pre Requires that you first call Startup(). + /// \param[in] host Either a dotted IP address or a domain name. + /// \param[in] remotePort Port to connect to on the remote machine. + /// \param[in] passwordData A data block that must match the data block on the server passed to SetIncomingPassword(). This can be a string or can be a stream of data. Use 0 for no password. + /// \param[in] passwordDataLength The length in bytes of passwordData. + /// \param[in] publicKey The public key the server is using. If 0, the server is not using security. If non-zero, the publicKeyMode member determines how to connect + /// \param[in] connectionSocketIndex Index into the array of socket descriptors passed to socketDescriptors in RakPeer::Startup() to determine the one to send on. + /// \param[in] sendConnectionAttemptCount Number of datagrams to send to the other system to try to connect. + /// \param[in] timeBetweenSendConnectionAttemptsMS Time to elapse before a datagram is sent to the other system to try to connect. After sendConnectionAttemptCount number of attempts, ID_CONNECTION_ATTEMPT_FAILED is returned. Under low bandwidth conditions with multiple simultaneous outgoing connections, this value should be raised to 1000 or higher, or else the MTU detection can overrun the available bandwidth. + /// \param[in] timeoutTime Time to elapse before dropping the connection if a reliable message could not be sent. 0 to use the default value from SetTimeoutTime(UNASSIGNED_SYSTEM_ADDRESS); + /// \return CONNECTION_ATTEMPT_STARTED on successful initiation. Otherwise, an appropriate enumeration indicating failure. + /// \note CONNECTION_ATTEMPT_STARTED does not mean you are already connected! + /// \note It is possible to immediately get back ID_CONNECTION_ATTEMPT_FAILED if you exceed the maxConnections parameter passed to Startup(). This could happen if you call CloseConnection() with sendDisconnectionNotificaiton true, then immediately call Connect() before the connection has closed. + ConnectionAttemptResult Connect( const char* host, unsigned short remotePort, const char *passwordData, int passwordDataLength, PublicKey *publicKey=0, unsigned connectionSocketIndex=0, unsigned sendConnectionAttemptCount=6, unsigned timeBetweenSendConnectionAttemptsMS=1000, RakNet::TimeMS timeoutTime=0 ); + + /// \brief Connect to the specified host (ip or domain name) and server port. + /// \param[in] host Either a dotted IP address or a domain name. + /// \param[in] remotePort Which port to connect to on the remote machine. + /// \param[in] passwordData A data block that must match the data block on the server passed to SetIncomingPassword(). This can be a string or can be a stream of data. Use 0 for no password. + /// \param[in] passwordDataLength The length in bytes of passwordData. + /// \param[in] socket A bound socket returned by another instance of RakPeerInterface. + /// \param[in] sendConnectionAttemptCount Number of datagrams to send to the other system to try to connect. + /// \param[in] timeBetweenSendConnectionAttemptsMS Time to elapse before a datagram is sent to the other system to try to connect. After sendConnectionAttemptCount number of attempts, ID_CONNECTION_ATTEMPT_FAILED is returned.. Under low bandwidth conditions with multiple simultaneous outgoing connections, this value should be raised to 1000 or higher, or else the MTU detection can overrun the available bandwidth. + /// \param[in] timeoutTime Time to elapse before dropping the connection if a reliable message could not be sent. 0 to use the default from SetTimeoutTime(UNASSIGNED_SYSTEM_ADDRESS); + /// \return CONNECTION_ATTEMPT_STARTED on successful initiation. Otherwise, an appropriate enumeration indicating failure. + /// \note CONNECTION_ATTEMPT_STARTED does not mean you are already connected! + virtual ConnectionAttemptResult ConnectWithSocket(const char* host, unsigned short remotePort, const char *passwordData, int passwordDataLength, RakNetSocket2* socket, PublicKey *publicKey=0, unsigned sendConnectionAttemptCount=6, unsigned timeBetweenSendConnectionAttemptsMS=1000, RakNet::TimeMS timeoutTime=0); + + /* /// \brief Connect to the specified network ID (Platform specific console function) + /// \details Does built-in NAT traversal + /// \param[in] networkServiceId Network ID structure for the online service + /// \param[in] passwordData A data block that must match the data block on the server passed to SetIncomingPassword(). This can be a string or can be a stream of data. Use 0 for no password. + /// \param[in] passwordDataLength The length in bytes of passwordData. + //bool Console2LobbyConnect( void *networkServiceId, const char *passwordData, int passwordDataLength );*/ + + /// \brief Stops the network threads and closes all connections. + /// \param[in] blockDuration Wait time(milli seconds) for all remaining messages to go out, including ID_DISCONNECTION_NOTIFICATION. If 0, it doesn't wait at all. + /// \param[in] orderingChannel Channel on which ID_DISCONNECTION_NOTIFICATION will be sent, if blockDuration > 0. + /// \param[in] disconnectionNotificationPriority Priority of sending ID_DISCONNECTION_NOTIFICATION. + /// If set to 0, the disconnection notification won't be sent. + void Shutdown( unsigned int blockDuration, unsigned char orderingChannel=0, PacketPriority disconnectionNotificationPriority=LOW_PRIORITY ); + + /// \brief Returns true if the network thread is running. + /// \return True if the network thread is running, False otherwise + bool IsActive( void ) const; + + /// \brief Fills the array remoteSystems with the SystemAddress of all the systems we are connected to. + /// \param[out] remoteSystems An array of SystemAddress structures, to be filled with the SystemAddresss of the systems we are connected to. Pass 0 to remoteSystems to get the number of systems we are connected to. + /// \param[in, out] numberOfSystems As input, the size of remoteSystems array. As output, the number of elements put into the array. + bool GetConnectionList( SystemAddress *remoteSystems, unsigned short *numberOfSystems ) const; + + /// Returns the next uint32_t that Send() will return + /// \note If using RakPeer from multiple threads, this may not be accurate for your thread. Use IncrementNextSendReceipt() in that case. + /// \return The next uint32_t that Send() or SendList will return + virtual uint32_t GetNextSendReceipt(void); + + /// Returns the next uint32_t that Send() will return, and increments the value by one + /// \note If using RakPeer from multiple threads, pass this to forceReceipt in the send function + /// \return The next uint32_t that Send() or SendList will return + virtual uint32_t IncrementNextSendReceipt(void); + + /// \brief Sends a block of data to the specified system that you are connected to. + /// \note This function only works while connected. + /// \note The first byte should be a message identifier starting at ID_USER_PACKET_ENUM. + /// \param[in] data Block of data to send. + /// \param[in] length Size in bytes of the data to send. + /// \param[in] priority Priority level to send on. See PacketPriority.h + /// \param[in] reliability How reliably to send this data. See PacketPriority.h + /// \param[in] orderingChannel When using ordered or sequenced messages, the channel to order these on. Messages are only ordered relative to other messages on the same stream. + /// \param[in] systemIdentifier Who to send this packet to, or in the case of broadcasting who not to send it to. Pass either a SystemAddress structure or a RakNetGUID structure. Use UNASSIGNED_SYSTEM_ADDRESS or to specify none + /// \param[in] broadcast True to send this packet to all connected systems. If true, then systemAddress specifies who not to send the packet to. + /// \param[in] forceReceipt If 0, will automatically determine the receipt number to return. If non-zero, will return what you give it. + /// \return 0 on bad input. Otherwise a number that identifies this message. If \a reliability is a type that returns a receipt, on a later call to Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS with bytes 1-4 inclusive containing this number + uint32_t Send( const char *data, const int length, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, uint32_t forceReceiptNumber=0 ); + + /// \brief "Send" to yourself rather than a remote system. + /// \details The message will be processed through the plugins and returned to the game as usual. + /// This function works anytime + /// \note The first byte should be a message identifier starting at ID_USER_PACKET_ENUM + /// \param[in] data Block of data to send. + /// \param[in] length Size in bytes of the data to send. + void SendLoopback( const char *data, const int length ); + + /// \brief Sends a block of data to the specified system that you are connected to. + /// + /// Same as the above version, but takes a BitStream as input. + /// \param[in] bitStream Bitstream to send + /// \param[in] priority Priority level to send on. See PacketPriority.h + /// \param[in] reliability How reliably to send this data. See PacketPriority.h + /// \param[in] orderingChannel Channel to order the messages on, when using ordered or sequenced messages. Messages are only ordered relative to other messages on the same stream. + /// \param[in] systemIdentifier System Address or RakNetGUID to send this packet to, or in the case of broadcasting, the address not to send it to. Use UNASSIGNED_SYSTEM_ADDRESS to specify none. + /// \param[in] broadcast True to send this packet to all connected systems. If true, then systemAddress specifies who not to send the packet to. + /// \param[in] forceReceipt If 0, will automatically determine the receipt number to return. If non-zero, will return what you give it. + /// \return 0 on bad input. Otherwise a number that identifies this message. If \a reliability is a type that returns a receipt, on a later call to Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS with bytes 1-4 inclusive containing this number + /// \note COMMON MISTAKE: When writing the first byte, bitStream->Write((unsigned char) ID_MY_TYPE) be sure it is casted to a byte, and you are not writing a 4 byte enumeration. + uint32_t Send( const RakNet::BitStream * bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, uint32_t forceReceiptNumber=0 ); + + /// \brief Sends multiple blocks of data, concatenating them automatically. + /// + /// This is equivalent to: + /// RakNet::BitStream bs; + /// bs.WriteAlignedBytes(block1, blockLength1); + /// bs.WriteAlignedBytes(block2, blockLength2); + /// bs.WriteAlignedBytes(block3, blockLength3); + /// Send(&bs, ...) + /// + /// This function only works when connected. + /// \param[in] data An array of pointers to blocks of data + /// \param[in] lengths An array of integers indicating the length of each block of data + /// \param[in] numParameters Length of the arrays data and lengths + /// \param[in] priority Priority level to send on. See PacketPriority.h + /// \param[in] reliability How reliably to send this data. See PacketPriority.h + /// \param[in] orderingChannel Channel to order the messages on, when using ordered or sequenced messages. Messages are only ordered relative to other messages on the same stream. + /// \param[in] systemIdentifier System Address or RakNetGUID to send this packet to, or in the case of broadcasting, the address not to send it to. Use UNASSIGNED_SYSTEM_ADDRESS to specify none. + /// \param[in] broadcast True to send this packet to all connected systems. If true, then systemAddress specifies who not to send the packet to. + /// \param[in] forceReceipt If 0, will automatically determine the receipt number to return. If non-zero, will return what you give it. + /// \return 0 on bad input. Otherwise a number that identifies this message. If \a reliability is a type that returns a receipt, on a later call to Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS with bytes 1-4 inclusive containing this number + uint32_t SendList( const char **data, const int *lengths, const int numParameters, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, uint32_t forceReceiptNumber=0 ); + + /// \brief Gets a message from the incoming message queue. + /// \details Use DeallocatePacket() to deallocate the message after you are done with it. + /// User-thread functions, such as RPC calls and the plugin function PluginInterface::Update occur here. + /// \return 0 if no packets are waiting to be handled, otherwise a pointer to a packet. + /// \note COMMON MISTAKE: Be sure to call this in a loop, once per game tick, until it returns 0. If you only process one packet per game tick they will buffer up. + /// \sa RakNetTypes.h contains struct Packet. + Packet* Receive( void ); + + /// \brief Call this to deallocate a message returned by Receive() when you are done handling it. + /// \param[in] packet Message to deallocate. + void DeallocatePacket( Packet *packet ); + + /// \brief Return the total number of connections we are allowed. + /// \return Total number of connections allowed. + unsigned int GetMaximumNumberOfPeers( void ) const; + + // -------------------------------------------------------------------------------------------- Connection Management Functions-------------------------------------------------------------------------------------------- + /// \brief Close the connection to another host (if we initiated the connection it will disconnect, if they did it will kick them out). + /// \details This method closes the connection irrespective of who initiated the connection. + /// \param[in] target Which system to close the connection to. + /// \param[in] sendDisconnectionNotification True to send ID_DISCONNECTION_NOTIFICATION to the recipient. False to close it silently. + /// \param[in] channel Which ordering channel to send the disconnection notification on, if any + /// \param[in] disconnectionNotificationPriority Priority to send ID_DISCONNECTION_NOTIFICATION on. + void CloseConnection( const AddressOrGUID target, bool sendDisconnectionNotification, unsigned char orderingChannel=0, PacketPriority disconnectionNotificationPriority=LOW_PRIORITY ); + + /// \brief Cancel a pending connection attempt. + /// \details If we are already connected, the connection stays open + /// \param[in] target Target system to cancel. + void CancelConnectionAttempt( const SystemAddress target ); + /// Returns if a system is connected, disconnected, connecting in progress, or various other states + /// \param[in] systemIdentifier The system we are referring to + /// \note This locks a mutex, do not call too frequently during connection attempts or the attempt will take longer and possibly even timeout + /// \return What state the remote system is in + ConnectionState GetConnectionState(const AddressOrGUID systemIdentifier); + + /// \brief Given \a systemAddress, returns its index into remoteSystemList. + /// \details Values range from 0 to the maximum number of players allowed - 1. + /// This includes systems which were formerly connected, but are now not connected. + /// \param[in] systemAddress The SystemAddress we are referring to + /// \return The index of this SystemAddress or -1 on system not found. + int GetIndexFromSystemAddress( const SystemAddress systemAddress ) const; + + /// \brief Given \a index into remoteSystemList, will return a SystemAddress. + /// This function is only useful for looping through all systems. + /// + /// \param[in] index Index should range between 0 and the maximum number of players allowed - 1. + /// \return The SystemAddress structure corresponding to \a index in remoteSystemList. + SystemAddress GetSystemAddressFromIndex( unsigned int index ); + + /// \brief Same as GetSystemAddressFromIndex but returns RakNetGUID + /// \param[in] index Index should range between 0 and the maximum number of players allowed - 1. + /// \return The RakNetGUID + RakNetGUID GetGUIDFromIndex( unsigned int index ); + + /// \brief Same as calling GetSystemAddressFromIndex and GetGUIDFromIndex for all systems, but more efficient + /// Indices match each other, so \a addresses[0] and \a guids[0] refer to the same system + /// \param[out] addresses All system addresses. Size of the list is the number of connections. Size of the \a addresses list will match the size of the \a guids list. + /// \param[out] guids All guids. Size of the list is the number of connections. Size of the list will match the size of the \a addresses list. + void GetSystemList(DataStructures::List &addresses, DataStructures::List &guids) const; + + /// \brief Bans an IP from connecting. + /// \details Banned IPs persist between connections but are not saved on shutdown nor loaded on startup. + /// \param[in] IP Dotted IP address. You can use * for a wildcard address, such as 128.0.0. * will ban all IP addresses starting with 128.0.0. + /// \param[in] milliseconds Gives time in milli seconds for a temporary ban of the IP address. Use 0 for a permanent ban. + void AddToBanList( const char *IP, RakNet::TimeMS milliseconds=0 ); + + /// \brief Allows a previously banned IP to connect. + /// param[in] Dotted IP address. You can use * as a wildcard. An IP such as 128.0.0.* will ban all IP addresses starting with 128.0.0. + void RemoveFromBanList( const char *IP ); + + /// \brief Allows all previously banned IPs to connect. + void ClearBanList( void ); + + /// \brief Returns true or false indicating if a particular IP is banned. + /// \param[in] IP Dotted IP address. + /// \return True if IP matches any IPs in the ban list, accounting for any wildcards. False otherwise. + bool IsBanned( const char *IP ); + + /// \brief Enable or disable allowing frequent connections from the same IP adderss + /// \details This is a security measure which is disabled by default, but can be set to true to prevent attackers from using up all connection slots. + /// \param[in] b True to limit connections from the same ip to at most 1 per 100 milliseconds. + void SetLimitIPConnectionFrequency(bool b); + + // --------------------------------------------------------------------------------------------Pinging Functions - Functions dealing with the automatic ping mechanism-------------------------------------------------------------------------------------------- + /// Send a ping to the specified connected system. + /// \pre The sender and recipient must already be started via a successful call to Startup() + /// \param[in] target Which system to ping + void Ping( const SystemAddress target ); + + /// \brief Send a ping to the specified unconnected system. + /// \details The remote system, if it is Initialized, will respond with ID_PONG followed by sizeof(RakNet::TimeMS) containing the system time the ping was sent. Default is 4 bytes - See __GET_TIME_64BIT in RakNetTypes.h + /// System should reply with ID_PONG if it is active + /// \param[in] host Either a dotted IP address or a domain name. Can be 255.255.255.255 for LAN broadcast. + /// \param[in] remotePort Which port to connect to on the remote machine. + /// \param[in] onlyReplyOnAcceptingConnections Only request a reply if the remote system is accepting connections + /// \param[in] connectionSocketIndex Index into the array of socket descriptors passed to socketDescriptors in RakPeer::Startup() to send on. + /// \return true on success, false on failure (unknown hostname) + bool Ping( const char* host, unsigned short remotePort, bool onlyReplyOnAcceptingConnections, unsigned connectionSocketIndex=0 ); + + /// \brief Returns the average of all ping times read for the specific system or -1 if none read yet + /// \param[in] systemAddress Which system we are referring to + /// \return The ping time for this system, or -1 + int GetAveragePing( const AddressOrGUID systemIdentifier ); + + /// \brief Returns the last ping time read for the specific system or -1 if none read yet. + /// \param[in] systemAddress Which system we are referring to + /// \return The last ping time for this system, or -1. + int GetLastPing( const AddressOrGUID systemIdentifier ) const; + + /// \brief Returns the lowest ping time read or -1 if none read yet. + /// \param[in] systemIdentifier Which system we are referring to + /// \return The lowest ping time for this system, or -1. + int GetLowestPing( const AddressOrGUID systemIdentifier ) const; + + /// Ping the remote systems every so often, or not. Can be called anytime. + /// By default this is true. Recommended to leave on, because congestion control uses it to determine how often to resend lost packets. + /// It would be true by default to prevent timestamp drift, since in the event of a clock spike, the timestamp deltas would no longer be accurate + /// \param[in] doPing True to start occasional pings. False to stop them. + void SetOccasionalPing( bool doPing ); + + /// Return the clock difference between your system and the specified system + /// Subtract GetClockDifferential() from a time returned by the remote system to get that time relative to your own system + /// Returns 0 if the system is unknown + /// \param[in] systemIdentifier Which system we are referring to + RakNet::Time GetClockDifferential( const AddressOrGUID systemIdentifier ); + + // --------------------------------------------------------------------------------------------Static Data Functions - Functions dealing with API defined synchronized memory-------------------------------------------------------------------------------------------- + /// \brief Sets the data to send along with a LAN server discovery or offline ping reply. + /// \param[in] data Block of data to send, or 0 for none + /// \param[in] length Length of the data in bytes, or 0 for none + /// \note \a length should be under 400 bytes, as a security measure against flood attacks + /// \sa Ping.cpp + void SetOfflinePingResponse( const char *data, const unsigned int length ); + + /// \brief Returns pointers to a copy of the \a data passed to SetOfflinePingResponse. + /// \param[out] data A pointer to a copy of the data passed to SetOfflinePingResponse() + /// \param[out] length A pointer filled in with the length parameter passed to SetOfflinePingResponse() + /// \sa SetOfflinePingResponse + void GetOfflinePingResponse( char **data, unsigned int *length ); + + //--------------------------------------------------------------------------------------------Network Functions - Functions dealing with the network in general-------------------------------------------------------------------------------------------- + /// \brief Returns the unique address identifier that represents you or another system on the the network + /// \note Not supported by the XBOX + /// \param[in] systemAddress Use UNASSIGNED_SYSTEM_ADDRESS to get your behind-LAN address. Use a connected system to get their behind-LAN address. This does not return the port. + /// \param[in] index When you have multiple internal IDs, which index to return? Currently limited to MAXIMUM_NUMBER_OF_INTERNAL_IDS (so the maximum value of this variable is MAXIMUM_NUMBER_OF_INTERNAL_IDS-1) + /// \return Identifier of your system internally, which may not be how other systems see if you if you are behind a NAT or proxy. + SystemAddress GetInternalID( const SystemAddress systemAddress=UNASSIGNED_SYSTEM_ADDRESS, const int index=0 ) const; + + /// \brief Sets your internal IP address, for platforms that do not support reading it, or to override a value + /// \param[in] systemAddress. The address to set. Use SystemAddress::FromString() if you want to use a dotted string + /// \param[in] index When you have multiple internal IDs, which index to set? + void SetInternalID(SystemAddress systemAddress, int index=0); + + /// \brief Returns the unique address identifier that represents the target on the the network and is based on the target's external IP / port. + /// \param[in] target The SystemAddress of the remote system. Usually the same for all systems, unless you have two or more network cards. + SystemAddress GetExternalID( const SystemAddress target ) const; + + /// Return my own GUID + const RakNetGUID GetMyGUID(void) const; + + /// Return the address bound to a socket at the specified index + SystemAddress GetMyBoundAddress(const int socketIndex=0); + + /// \brief Given a connected system address, this method gives the unique GUID representing that instance of RakPeer. + /// This will be the same on all systems connected to that instance of RakPeer, even if the external system addresses are different. + /// Complexity is O(log2(n)). + /// If \a input is UNASSIGNED_SYSTEM_ADDRESS, will return your own GUID + /// \pre Call Startup() first, or the function will return UNASSIGNED_RAKNET_GUID + /// \param[in] input The system address of the target system we are connected to. + const RakNetGUID& GetGuidFromSystemAddress( const SystemAddress input ) const; + + /// \brief Gives the system address of a connected system, given its GUID. + /// The GUID will be the same on all systems connected to that instance of RakPeer, even if the external system addresses are different. + /// Currently O(log(n)), but this may be improved in the future + /// If \a input is UNASSIGNED_RAKNET_GUID, UNASSIGNED_SYSTEM_ADDRESS is returned. + /// \param[in] input The RakNetGUID of the target system. + SystemAddress GetSystemAddressFromGuid( const RakNetGUID input ) const; + + /// Given the SystemAddress of a connected system, get the public key they provided as an identity + /// Returns false if system address was not found or client public key is not known + /// \param[in] input The RakNetGUID of the system + /// \param[in] client_public_key The connected client's public key is copied to this address. Buffer must be cat::EasyHandshake::PUBLIC_KEY_BYTES bytes in length. + bool GetClientPublicKeyFromSystemAddress( const SystemAddress input, char *client_public_key ) const; + + /// \brief Set the time, in MS, to use before considering ourselves disconnected after not being able to deliver a reliable message. + + /// Set the time, in MS, to use before considering ourselves disconnected after not being able to deliver a reliable message. + /// Default time is 10,000 or 10 seconds in release and 30,000 or 30 seconds in debug. + /// Do not set different values for different computers that are connected to each other, or you won't be able to reconnect after ID_CONNECTION_LOST + /// \param[in] timeMS Time, in MS + /// \param[in] target SystemAddress structure of the target system. Pass UNASSIGNED_SYSTEM_ADDRESS for all systems. + void SetTimeoutTime( RakNet::TimeMS timeMS, const SystemAddress target ); + + /// \brief Returns the Timeout time for the given system. + /// \param[in] target Target system to get the TimeoutTime for. Pass UNASSIGNED_SYSTEM_ADDRESS to get the default value. + /// \return Timeout time for a given system. + RakNet::TimeMS GetTimeoutTime( const SystemAddress target ); + + /// \brief Returns the current MTU size + /// \param[in] target Which system to get MTU for. UNASSIGNED_SYSTEM_ADDRESS to get the default + /// \return The current MTU size of the target system. + int GetMTUSize( const SystemAddress target ) const; + + /// \brief Returns the number of IP addresses this system has internally. + /// \details Get the actual addresses from GetLocalIP() + unsigned GetNumberOfAddresses( void ); + + /// Returns an IP address at index 0 to GetNumberOfAddresses-1 in ipList array. + /// \param[in] index index into the list of IP addresses + /// \return The local IP address at this index + const char* GetLocalIP( unsigned int index ); + + /// Is this a local IP? + /// Checks if this ip is in the ipList array. + /// \param[in] An IP address to check, excluding the port. + /// \return True if this is one of the IP addresses returned by GetLocalIP + bool IsLocalIP( const char *ip ); + + /// \brief Allow or disallow connection responses from any IP. + /// \details Normally this should be false, but may be necessary when connecting to servers with multiple IP addresses. + /// \param[in] allow - True to allow this behavior, false to not allow. Defaults to false. Value persists between connections. + void AllowConnectionResponseIPMigration( bool allow ); + + /// \brief Sends a one byte message ID_ADVERTISE_SYSTEM to the remote unconnected system. + /// This will send our external IP outside the LAN along with some user data to the remote system. + /// \pre The sender and recipient must already be started via a successful call to Initialize + /// \param[in] host Either a dotted IP address or a domain name + /// \param[in] remotePort Which port to connect to on the remote machine. + /// \param[in] data Optional data to append to the packet. + /// \param[in] dataLength Length of data in bytes. Use 0 if no data. + /// \param[in] connectionSocketIndex Index into the array of socket descriptors passed to socketDescriptors in RakPeer::Startup() to send on. + /// \return False if IsActive()==false or the host is unresolvable. True otherwise. + bool AdvertiseSystem( const char *host, unsigned short remotePort, const char *data, int dataLength, unsigned connectionSocketIndex=0 ); + + /// \brief Controls how often to return ID_DOWNLOAD_PROGRESS for large message downloads. + /// \details ID_DOWNLOAD_PROGRESS is returned to indicate a new partial message chunk, roughly the MTU size, has arrived. + /// As it can be slow or cumbersome to get this notification for every chunk, you can set the interval at which it is returned. + /// Defaults to 0 (never return this notification). + /// \param[in] interval How many messages to use as an interval before a download progress notification is returned. + void SetSplitMessageProgressInterval(int interval); + + /// \brief Returns what was passed to SetSplitMessageProgressInterval(). + /// \return Number of messages to be recieved before a download progress notification is returned. Default to 0. + int GetSplitMessageProgressInterval(void) const; + + /// \brief Set how long to wait before giving up on sending an unreliable message. + /// Useful if the network is clogged up. + /// Set to 0 or less to never timeout. Defaults to 0. + /// \param[in] timeoutMS How many ms to wait before simply not sending an unreliable message. + void SetUnreliableTimeout(RakNet::TimeMS timeoutMS); + + /// \brief Send a message to a host, with the IP socket option TTL set to 3. + /// \details This message will not reach the host, but will open the router. + /// \param[in] host The address of the remote host in dotted notation. + /// \param[in] remotePort The port number to send to. + /// \param[in] ttl Max hops of datagram, set to 3 + /// \param[in] connectionSocketIndex userConnectionSocketIndex. + /// \remarks Used for NAT-Punchthrough + void SendTTL( const char* host, unsigned short remotePort, int ttl, unsigned connectionSocketIndex=0 ); + + // -------------------------------------------------------------------------------------------- Plugin Functions-------------------------------------------------------------------------------------------- + /// \brief Attaches a Plugin interface to an instance of the base class (RakPeer or PacketizedTCP) to run code automatically on message receipt in the Receive call. + /// If the plugin returns false from PluginInterface::UsesReliabilityLayer(), which is the case for all plugins except PacketLogger, you can call AttachPlugin() and DetachPlugin() for this plugin while RakPeer is active. + /// \param[in] messageHandler Pointer to the plugin to attach. + void AttachPlugin( PluginInterface2 *plugin ); + + /// \brief Detaches a Plugin interface from the instance of the base class (RakPeer or PacketizedTCP) it is attached to. + /// \details This method disables the plugin code from running automatically on base class's updates or message receipt. + /// If the plugin returns false from PluginInterface::UsesReliabilityLayer(), which is the case for all plugins except PacketLogger, you can call AttachPlugin() and DetachPlugin() for this plugin while RakPeer is active. + /// \param[in] messageHandler Pointer to a plugin to detach. + void DetachPlugin( PluginInterface2 *messageHandler ); + + // --------------------------------------------------------------------------------------------Miscellaneous Functions-------------------------------------------------------------------------------------------- + /// \brief Puts a message back in the receive queue in case you don't want to deal with it immediately. + /// \param[in] packet The pointer to the packet you want to push back. + /// \param[in] pushAtHead True to push the packet at the start of the queue so that the next receive call returns it. False to push it at the end of the queue. + /// \note Setting pushAtHead to false end makes the packets out of order. + void PushBackPacket( Packet *packet, bool pushAtHead ); + + /// \internal + /// \brief For a given system identified by \a guid, change the SystemAddress to send to. + /// \param[in] guid The connection we are referring to + /// \param[in] systemAddress The new address to send to + void ChangeSystemAddress(RakNetGUID guid, const SystemAddress &systemAddress); + + /// \brief Returns a packet for you to write to if you want to create a Packet for some reason. + /// You can add it to the receive buffer with PushBackPacket + /// \param[in] dataSize How many bytes to allocate for the buffer + /// \return A packet. + Packet* AllocatePacket(unsigned dataSize); + + /// \brief Get the socket used with a particular active connection. + /// The smart pointer reference counts the RakNetSocket object, so the socket will remain active as long as the smart pointer does, even if RakNet were to shutdown or close the connection. + /// \note This sends a query to the thread and blocks on the return value for up to one second. In practice it should only take a millisecond or so. + /// \param[in] target Which system. + /// \return A smart pointer object containing the socket information about the target. Be sure to check IsNull() which is returned if the update thread is unresponsive, shutting down, or if this system is not connected. + virtual RakNetSocket2* GetSocket( const SystemAddress target ); + + /// \brief Gets all sockets in use. + /// \note This sends a query to the thread and blocks on the return value for up to one second. In practice it should only take a millisecond or so. + /// \param[out] sockets List of RakNetSocket structures in use. + virtual void GetSockets( DataStructures::List &sockets ); + virtual void ReleaseSockets( DataStructures::List &sockets ); + + /// \internal + virtual void WriteOutOfBandHeader(RakNet::BitStream *bitStream); + + /// If you need code to run in the same thread as RakNet's update thread, this function can be used for that + /// \param[in] _userUpdateThreadPtr C callback function + /// \param[in] _userUpdateThreadData Passed to C callback function + virtual void SetUserUpdateThread(void (*_userUpdateThreadPtr)(RakPeerInterface *, void *), void *_userUpdateThreadData); + + /// Set a C callback to be called whenever a datagram arrives + /// Return true from the callback to have RakPeer handle the datagram. Return false and RakPeer will ignore the datagram. + /// This can be used to filter incoming datagrams by system, or to share a recvfrom socket with RakPeer + /// RNS2RecvStruct will only remain valid for the duration of the call + virtual void SetIncomingDatagramEventHandler( bool (*_incomingDatagramEventHandler)(RNS2RecvStruct *) ); + + // --------------------------------------------------------------------------------------------Network Simulator Functions-------------------------------------------------------------------------------------------- + /// Adds simulated ping and packet loss to the outgoing data flow. + /// To simulate bi-directional ping and packet loss, you should call this on both the sender and the recipient, with half the total ping and packetloss value on each. + /// You can exclude network simulator code with the _RELEASE #define to decrease code size + /// \deprecated Use http://www.jenkinssoftware.com/forum/index.php?topic=1671.0 instead. + /// \note Doesn't work past version 3.6201 + /// \param[in] packetloss Chance to lose a packet. Ranges from 0 to 1. + /// \param[in] minExtraPing The minimum time to delay sends. + /// \param[in] extraPingVariance The additional random time to delay sends. + virtual void ApplyNetworkSimulator( float packetloss, unsigned short minExtraPing, unsigned short extraPingVariance); + + /// Limits how much outgoing bandwidth can be sent per-connection. + /// This limit does not apply to the sum of all connections! + /// Exceeding the limit queues up outgoing traffic + /// \param[in] maxBitsPerSecond Maximum bits per second to send. Use 0 for unlimited (default). Once set, it takes effect immedately and persists until called again. + virtual void SetPerConnectionOutgoingBandwidthLimit( unsigned maxBitsPerSecond ); + + /// Returns if you previously called ApplyNetworkSimulator + /// \return If you previously called ApplyNetworkSimulator + virtual bool IsNetworkSimulatorActive( void ); + + // --------------------------------------------------------------------------------------------Statistical Functions - Functions dealing with API performance-------------------------------------------------------------------------------------------- + + /// \brief Returns a structure containing a large set of network statistics for the specified system. + /// You can map this data to a string using the C style StatisticsToString() function + /// \param[in] systemAddress Which connected system to get statistics for. + /// \param[in] rns If you supply this structure,the network statistics will be written to it. Otherwise the method uses a static struct to write the data, which is not threadsafe. + /// \return 0 if the specified system can't be found. Otherwise a pointer to the struct containing the specified system's network statistics. + /// \sa RakNetStatistics.h + RakNetStatistics * GetStatistics( const SystemAddress systemAddress, RakNetStatistics *rns=0 ); + /// \brief Returns the network statistics of the system at the given index in the remoteSystemList. + /// \return True if the index is less than the maximum number of peers allowed and the system is active. False otherwise. + bool GetStatistics( const unsigned int index, RakNetStatistics *rns ); + /// \brief Returns the list of systems, and statistics for each of those systems + /// Each system has one entry in each of the lists, in the same order + /// \param[out] addresses SystemAddress for each connected system + /// \param[out] guids RakNetGUID for each connected system + /// \param[out] statistics Calculated RakNetStatistics for each connected system + virtual void GetStatisticsList(DataStructures::List &addresses, DataStructures::List &guids, DataStructures::List &statistics); + + /// \Returns how many messages are waiting when you call Receive() + virtual unsigned int GetReceiveBufferSize(void); + + // --------------------------------------------------------------------------------------------EVERYTHING AFTER THIS COMMENT IS FOR INTERNAL USE ONLY-------------------------------------------------------------------------------------------- + + + /// \internal + // Call manually if RAKPEER_USER_THREADED==1 at least every 30 milliseconds. + // updateBitStream should be: + // BitStream updateBitStream( MAXIMUM_MTU_SIZE + // #if LIBCAT_SECURITY==1 + // + cat::AuthenticatedEncryption::OVERHEAD_BYTES + // #endif + // ); + bool RunUpdateCycle( BitStream &updateBitStream ); + + /// \internal + // Call manually if RAKPEER_USER_THREADED==1 at least every 30 milliseconds. + // Call in a loop until returns false if the socket is non-blocking + // remotePortRakNetWasStartedOn_PS3 and extraSocketOptions are from SocketDescriptor when the socket was created + // bool RunRecvFromOnce( RakNetSocket *s ); + + /// \internal + bool SendOutOfBand(const char *host, unsigned short remotePort, const char *data, BitSize_t dataLength, unsigned connectionSocketIndex=0 ); + + // static Packet *AllocPacket(unsigned dataSize, const char *file, unsigned int line); + + /// \internal + /// \brief Holds the clock differences between systems, along with the ping + struct PingAndClockDifferential + { + unsigned short pingTime; + RakNet::Time clockDifferential; + }; + + /// \internal + /// \brief All the information representing a connected system + struct RemoteSystemStruct + { + bool isActive; // Is this structure in use? + SystemAddress systemAddress; /// Their external IP on the internet + SystemAddress myExternalSystemAddress; /// Your external IP on the internet, from their perspective + SystemAddress theirInternalSystemAddress[MAXIMUM_NUMBER_OF_INTERNAL_IDS]; /// Their internal IP, behind the LAN + ReliabilityLayer reliabilityLayer; /// The reliability layer associated with this player + bool weInitiatedTheConnection; /// True if we started this connection via Connect. False if someone else connected to us. + PingAndClockDifferential pingAndClockDifferential[ PING_TIMES_ARRAY_SIZE ]; /// last x ping times and calculated clock differentials with it + RakNet::Time pingAndClockDifferentialWriteIndex; /// The index we are writing into the pingAndClockDifferential circular buffer + unsigned short lowestPing; ///The lowest ping value encountered + RakNet::Time nextPingTime; /// When to next ping this player + RakNet::Time lastReliableSend; /// When did the last reliable send occur. Reliable sends must occur at least once every timeoutTime/2 units to notice disconnects + RakNet::Time connectionTime; /// connection time, if active. +// int connectionSocketIndex; // index into connectionSockets to send back on. + RakNetGUID guid; + int MTUSize; + // Reference counted socket to send back on + RakNetSocket2* rakNetSocket; + SystemIndex remoteSystemIndex; + +#if LIBCAT_SECURITY==1 + // Cached answer used internally by RakPeer to prevent DoS attacks based on the connexion handshake + char answer[cat::EasyHandshake::ANSWER_BYTES]; + + // If the server has bRequireClientKey = true, then this is set to the validated public key of the connected client + // Valid after connectMode reaches HANDLING_CONNECTION_REQUEST + char client_public_key[cat::EasyHandshake::PUBLIC_KEY_BYTES]; +#endif + + enum ConnectMode {NO_ACTION, DISCONNECT_ASAP, DISCONNECT_ASAP_SILENTLY, DISCONNECT_ON_NO_ACK, REQUESTED_CONNECTION, HANDLING_CONNECTION_REQUEST, UNVERIFIED_SENDER, CONNECTED} connectMode; + }; + + // DS_APR + //void ProcessChromePacket(RakNetSocket2 *s, const char *buffer, int dataSize, const SystemAddress& recvFromAddress, RakNet::TimeUS timeRead); + // /DS_APR +protected: + + friend RAK_THREAD_DECLARATION(UpdateNetworkLoop); + //friend RAK_THREAD_DECLARATION(RecvFromLoop); + friend RAK_THREAD_DECLARATION(UDTConnect); + + friend bool ProcessOfflineNetworkPacket( SystemAddress systemAddress, const char *data, const int length, RakPeer *rakPeer, RakNetSocket2* rakNetSocket, bool *isOfflineMessage, RakNet::TimeUS timeRead ); + friend void ProcessNetworkPacket( const SystemAddress systemAddress, const char *data, const int length, RakPeer *rakPeer, RakNet::TimeUS timeRead, BitStream &updateBitStream ); + friend void ProcessNetworkPacket( const SystemAddress systemAddress, const char *data, const int length, RakPeer *rakPeer, RakNetSocket2* rakNetSocket, RakNet::TimeUS timeRead, BitStream &updateBitStream ); + + int GetIndexFromSystemAddress( const SystemAddress systemAddress, bool calledFromNetworkThread ) const; + int GetIndexFromGuid( const RakNetGUID guid ); + + //void RemoveFromRequestedConnectionsList( const SystemAddress systemAddress ); + // Two versions needed because some buggy compilers strip the last parameter if unused, and crashes + ConnectionAttemptResult SendConnectionRequest( const char* host, unsigned short remotePort, const char *passwordData, int passwordDataLength, PublicKey *publicKey, unsigned connectionSocketIndex, unsigned int extraData, unsigned sendConnectionAttemptCount, unsigned timeBetweenSendConnectionAttemptsMS, RakNet::TimeMS timeoutTime, RakNetSocket2* socket ); + ConnectionAttemptResult SendConnectionRequest( const char* host, unsigned short remotePort, const char *passwordData, int passwordDataLength, PublicKey *publicKey, unsigned connectionSocketIndex, unsigned int extraData, unsigned sendConnectionAttemptCount, unsigned timeBetweenSendConnectionAttemptsMS, RakNet::TimeMS timeoutTime ); + ///Get the reliability layer associated with a systemAddress. + /// \param[in] systemAddress The player identifier + /// \return 0 if none + RemoteSystemStruct *GetRemoteSystemFromSystemAddress( const SystemAddress systemAddress, bool calledFromNetworkThread, bool onlyActive ) const; + RakPeer::RemoteSystemStruct *GetRemoteSystem( const AddressOrGUID systemIdentifier, bool calledFromNetworkThread, bool onlyActive ) const; + void ValidateRemoteSystemLookup(void) const; + RemoteSystemStruct *GetRemoteSystemFromGUID( const RakNetGUID guid, bool onlyActive ) const; + ///Parse out a connection request packet + void ParseConnectionRequestPacket( RakPeer::RemoteSystemStruct *remoteSystem, const SystemAddress &systemAddress, const char *data, int byteSize); + void OnConnectionRequest( RakPeer::RemoteSystemStruct *remoteSystem, RakNet::Time incomingTimestamp ); + ///Send a reliable disconnect packet to this player and disconnect them when it is delivered + void NotifyAndFlagForShutdown( const SystemAddress systemAddress, bool performImmediate, unsigned char orderingChannel, PacketPriority disconnectionNotificationPriority ); + ///Returns how many remote systems initiated a connection to us + unsigned int GetNumberOfRemoteInitiatedConnections( void ) const; + /// \brief Get a free remote system from the list and assign our systemAddress to it. + /// \note Should only be called from the update thread - not the user thread. + /// \param[in] systemAddress systemAddress to be assigned + /// \param[in] connectionMode connection mode of the RemoteSystem. + /// \param[in] rakNetSocket + /// \param[in] thisIPConnectedRecently Is this IP connected recently? set to False; + /// \param[in] bindingAddress Address to be binded with the remote system + /// \param[in] incomingMTU MTU for the remote system + RemoteSystemStruct * AssignSystemAddressToRemoteSystemList( const SystemAddress systemAddress, RemoteSystemStruct::ConnectMode connectionMode, RakNetSocket2* incomingRakNetSocket, bool *thisIPConnectedRecently, SystemAddress bindingAddress, int incomingMTU, RakNetGUID guid, bool useSecurity ); + /// \brief Adjust the timestamp of the incoming packet to be relative to this system. + /// \param[in] data Data in the incoming packet. + /// \param[in] systemAddress Sender of the incoming packet. + void ShiftIncomingTimestamp( unsigned char *data, const SystemAddress &systemAddress ) const; + /// Get the most accurate clock differential for a certain player. + /// \param[in] systemAddress The player with whose clock the time difference is calculated. + /// \returns The clock differential for a certain player. + RakNet::Time GetBestClockDifferential( const SystemAddress systemAddress ) const; + + bool IsLoopbackAddress(const AddressOrGUID &systemIdentifier, bool matchPort) const; + SystemAddress GetLoopbackAddress(void) const; + + ///Set this to true to terminate the Peer thread execution + volatile bool endThreads; + ///true if the peer thread is active. + volatile bool isMainLoopThreadActive; + + // RakNet::LocklessUint32_t isRecvFromLoopThreadActive; + + + bool occasionalPing; /// Do we occasionally ping the other systems?*/ + ///Store the maximum number of peers allowed to connect + unsigned int maximumNumberOfPeers; + //05/02/06 Just using maximumNumberOfPeers instead + ///Store the maximum number of peers able to connect, including reserved connection slots for pings, etc. + //unsigned short remoteSystemListSize; + ///Store the maximum incoming connection allowed + unsigned int maximumIncomingConnections; + RakNet::BitStream offlinePingResponse; + ///Local Player ID + // SystemAddress mySystemAddress[MAXIMUM_NUMBER_OF_INTERNAL_IDS]; + char incomingPassword[256]; + unsigned char incomingPasswordLength; + + /// This is an array of pointers to RemoteSystemStruct + /// This allows us to preallocate the list when starting, so we don't have to allocate or delete at runtime. + /// Another benefit is that is lets us add and remove active players simply by setting systemAddress + /// and moving elements in the list by copying pointers variables without affecting running threads, even if they are in the reliability layer + RemoteSystemStruct* remoteSystemList; + /// activeSystemList holds a list of pointers and is preallocated to be the same size as remoteSystemList. It is updated only by the network thread, but read by both threads + /// When the isActive member of RemoteSystemStruct is set to true or false, that system is added to this list of pointers + /// Threadsafe because RemoteSystemStruct is preallocated, and the list is only added to, not removed from + RemoteSystemStruct** activeSystemList; + unsigned int activeSystemListSize; + + // Use a hash, with binaryAddress plus port mod length as the index + RemoteSystemIndex **remoteSystemLookup; + unsigned int RemoteSystemLookupHashIndex(const SystemAddress &sa) const; + void ReferenceRemoteSystem(const SystemAddress &sa, unsigned int remoteSystemListIndex); + void DereferenceRemoteSystem(const SystemAddress &sa); + RemoteSystemStruct* GetRemoteSystem(const SystemAddress &sa) const; + unsigned int GetRemoteSystemIndex(const SystemAddress &sa) const; + void ClearRemoteSystemLookup(void); + DataStructures::MemoryPool remoteSystemIndexPool; + + void AddToActiveSystemList(unsigned int remoteSystemListIndex); + void RemoveFromActiveSystemList(const SystemAddress &sa); + +// unsigned int LookupIndexUsingHashIndex(const SystemAddress &sa) const; +// unsigned int RemoteSystemListIndexUsingHashIndex(const SystemAddress &sa) const; +// unsigned int FirstFreeRemoteSystemLookupIndex(const SystemAddress &sa) const; + + enum + { + // Only put these mutexes in user thread functions! + requestedConnectionList_Mutex, + offlinePingResponse_Mutex, + NUMBER_OF_RAKPEER_MUTEXES + }; + SimpleMutex rakPeerMutexes[ NUMBER_OF_RAKPEER_MUTEXES ]; + ///RunUpdateCycle is not thread safe but we don't need to mutex calls. Just skip calls if it is running already + + bool updateCycleIsRunning; + ///The list of people we have tried to connect to recently + + //DataStructures::Queue requestedConnectionsList; + ///Data that both the client and the server needs + + unsigned int bytesSentPerSecond, bytesReceivedPerSecond; + // bool isSocketLayerBlocking; + // bool continualPing,isRecvfromThreadActive,isMainLoopThreadActive, endThreads, isSocketLayerBlocking; + unsigned int validationInteger; + SimpleMutex incomingQueueMutex, banListMutex; //,synchronizedMemoryQueueMutex, automaticVariableSynchronizationMutex; + //DataStructures::Queue incomingpacketSingleProducerConsumer; //, synchronizedMemorypacketSingleProducerConsumer; + // BitStream enumerationData; + + struct BanStruct + { + char *IP; + RakNet::TimeMS timeout; // 0 for none + }; + + struct RequestedConnectionStruct + { + SystemAddress systemAddress; + RakNet::Time nextRequestTime; + unsigned char requestsMade; + char *data; + unsigned short dataLength; + char outgoingPassword[256]; + unsigned char outgoingPasswordLength; + unsigned socketIndex; + unsigned int extraData; + unsigned sendConnectionAttemptCount; + unsigned timeBetweenSendConnectionAttemptsMS; + RakNet::TimeMS timeoutTime; + PublicKeyMode publicKeyMode; + RakNetSocket2* socket; + enum {CONNECT=1, /*PING=2, PING_OPEN_CONNECTIONS=4,*/ /*ADVERTISE_SYSTEM=2*/} actionToTake; + +#if LIBCAT_SECURITY==1 + char handshakeChallenge[cat::EasyHandshake::CHALLENGE_BYTES]; + cat::ClientEasyHandshake *client_handshake; + char remote_public_key[cat::EasyHandshake::PUBLIC_KEY_BYTES]; +// char remote_challenge[cat::EasyHandshake::CHALLENGE_BYTES]; + // char random[16]; +#endif + }; +#if LIBCAT_SECURITY==1 + bool GenerateConnectionRequestChallenge(RequestedConnectionStruct *rcs,PublicKey *publicKey); +#endif + + //DataStructures::List* > automaticVariableSynchronizationList; + DataStructures::List banList; + // Threadsafe, and not thread safe + DataStructures::List pluginListTS, pluginListNTS; + + DataStructures::Queue requestedConnectionQueue; + SimpleMutex requestedConnectionQueueMutex; + + // void RunMutexedUpdateCycle(void); + + struct BufferedCommandStruct + { + BitSize_t numberOfBitsToSend; + PacketPriority priority; + PacketReliability reliability; + char orderingChannel; + AddressOrGUID systemIdentifier; + bool broadcast; + RemoteSystemStruct::ConnectMode connectionMode; + NetworkID networkID; + bool blockingCommand; // Only used for RPC + char *data; + bool haveRakNetCloseSocket; + unsigned connectionSocketIndex; + unsigned short remotePortRakNetWasStartedOn_PS3; + unsigned int extraSocketOptions; + RakNetSocket2* socket; + unsigned short port; + uint32_t receipt; + enum {BCS_SEND, BCS_CLOSE_CONNECTION, BCS_GET_SOCKET, BCS_CHANGE_SYSTEM_ADDRESS,/* BCS_USE_USER_SOCKET, BCS_REBIND_SOCKET_ADDRESS, BCS_RPC, BCS_RPC_SHIFT,*/ BCS_DO_NOTHING} command; + }; + + // Single producer single consumer queue using a linked list + //BufferedCommandStruct* bufferedCommandReadIndex, bufferedCommandWriteIndex; + + DataStructures::ThreadsafeAllocatingQueue bufferedCommands; + + + // DataStructures::ThreadsafeAllocatingQueue bufferedPackets; + + DataStructures::Queue bufferedPacketsFreePool; + RakNet::SimpleMutex bufferedPacketsFreePoolMutex; + DataStructures::Queue bufferedPacketsQueue; + RakNet::SimpleMutex bufferedPacketsQueueMutex; + + virtual void DeallocRNS2RecvStruct(RNS2RecvStruct *s, const char *file, unsigned int line); + virtual RNS2RecvStruct *AllocRNS2RecvStruct(const char *file, unsigned int line); + void SetupBufferedPackets(void); + void PushBufferedPacket(RNS2RecvStruct * p); + RNS2RecvStruct *PopBufferedPacket(void); + + struct SocketQueryOutput + { + SocketQueryOutput() {} + ~SocketQueryOutput() {} + DataStructures::List sockets; + }; + + DataStructures::ThreadsafeAllocatingQueue socketQueryOutput; + + + bool AllowIncomingConnections(void) const; + + void PingInternal( const SystemAddress target, bool performImmediate, PacketReliability reliability ); + // This stores the user send calls to be handled by the update thread. This way we don't have thread contention over systemAddresss + void CloseConnectionInternal( const AddressOrGUID& systemIdentifier, bool sendDisconnectionNotification, bool performImmediate, unsigned char orderingChannel, PacketPriority disconnectionNotificationPriority ); + void SendBuffered( const char *data, BitSize_t numberOfBitsToSend, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, RemoteSystemStruct::ConnectMode connectionMode, uint32_t receipt ); + void SendBufferedList( const char **data, const int *lengths, const int numParameters, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, RemoteSystemStruct::ConnectMode connectionMode, uint32_t receipt ); + bool SendImmediate( char *data, BitSize_t numberOfBitsToSend, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, bool useCallerDataAllocation, RakNet::TimeUS currentTime, uint32_t receipt ); + //bool HandleBufferedRPC(BufferedCommandStruct *bcs, RakNet::TimeMS time); + void ClearBufferedCommands(void); + void ClearBufferedPackets(void); + void ClearSocketQueryOutput(void); + void ClearRequestedConnectionList(void); + void AddPacketToProducer(RakNet::Packet *p); + unsigned int GenerateSeedFromGuid(void); + RakNet::Time GetClockDifferentialInt(RemoteSystemStruct *remoteSystem) const; + SimpleMutex securityExceptionMutex; + + //DataStructures::AVLBalancedBinarySearchTree rpcTree; + int defaultMTUSize; + bool trackFrequencyTable; + + // Smart pointer so I can return the object to the user + DataStructures::List socketList; + void DerefAllSockets(void); + unsigned int GetRakNetSocketFromUserConnectionSocketIndex(unsigned int userIndex) const; + // Used for RPC replies + RakNet::BitStream *replyFromTargetBS; + SystemAddress replyFromTargetPlayer; + bool replyFromTargetBroadcast; + + RakNet::TimeMS defaultTimeoutTime; + + // Generate and store a unique GUID + void GenerateGUID(void); + unsigned int GetSystemIndexFromGuid( const RakNetGUID input ) const; + RakNetGUID myGuid; + + unsigned maxOutgoingBPS; + + // Nobody would use the internet simulator in a final build. +#ifdef _DEBUG + double _packetloss; + unsigned short _minExtraPing, _extraPingVariance; +#endif + + ///How long it has been since things were updated by a call to receiveUpdate thread uses this to determine how long to sleep for + //unsigned int lastUserUpdateCycle; + /// True to allow connection accepted packets from anyone. False to only allow these packets from servers we requested a connection to. + bool allowConnectionResponseIPMigration; + + SystemAddress firstExternalID; + int splitMessageProgressInterval; + RakNet::TimeMS unreliableTimeout; + + bool (*incomingDatagramEventHandler)(RNS2RecvStruct *); + + // Systems in this list will not go through the secure connection process, even when secure connections are turned on. Wildcards are accepted. + DataStructures::List securityExceptionList; + + SystemAddress ipList[ MAXIMUM_NUMBER_OF_INTERNAL_IDS ]; + + bool allowInternalRouting; + + void (*userUpdateThreadPtr)(RakPeerInterface *, void *); + void *userUpdateThreadData; + + + SignaledEvent quitAndDataEvents; + bool limitConnectionFrequencyFromTheSameIP; + + SimpleMutex packetAllocationPoolMutex; + DataStructures::MemoryPool packetAllocationPool; + + SimpleMutex packetReturnMutex; + DataStructures::Queue packetReturnQueue; + Packet *AllocPacket(unsigned dataSize, const char *file, unsigned int line); + Packet *AllocPacket(unsigned dataSize, unsigned char *data, const char *file, unsigned int line); + + /// This is used to return a number to the user when they call Send identifying the message + /// This number will be returned back with ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS and is only returned + /// with the reliability types that contain RECEIPT in the name + SimpleMutex sendReceiptSerialMutex; + uint32_t sendReceiptSerial; + void ResetSendReceipt(void); + void OnConnectedPong(RakNet::Time sendPingTime, RakNet::Time sendPongTime, RemoteSystemStruct *remoteSystem); + void CallPluginCallbacks(DataStructures::List &pluginList, Packet *packet); + +#if LIBCAT_SECURITY==1 + // Encryption and security + bool _using_security, _require_client_public_key; + char my_public_key[cat::EasyHandshake::PUBLIC_KEY_BYTES]; + cat::ServerEasyHandshake *_server_handshake; + cat::CookieJar *_cookie_jar; + bool InitializeClientSecurity(RequestedConnectionStruct *rcs, const char *public_key); +#endif + + + + + + + virtual void OnRNS2Recv(RNS2RecvStruct *recvStruct); + void FillIPList(void); +} +// #if defined(SN_TARGET_PSP2) +// __attribute__((aligned(8))) +// #endif +; + +} // namespace RakNet + +#endif diff --git a/include/raknet/RakPeerInterface.hpp b/include/raknet/RakPeerInterface.hpp new file mode 100644 index 0000000..895b71f --- /dev/null +++ b/include/raknet/RakPeerInterface.hpp @@ -0,0 +1,616 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief An interface for RakPeer. Simply contains all user functions as pure virtuals. +/// + + + +#ifndef __RAK_PEER_INTERFACE_H +#define __RAK_PEER_INTERFACE_H + +#include "PacketPriority.hpp" +#include "RakNetTypes.hpp" +#include "RakMemoryOverride.hpp" +#include "Export.hpp" +#include "DS_List.hpp" +#include "RakNetSmartPtr.hpp" +#include "RakNetSocket2.hpp" + +namespace RakNet +{ +// Forward declarations +class BitStream; +class PluginInterface2; +struct RPCMap; +struct RakNetStatistics; +struct RakNetBandwidth; +class RouterInterface; +class NetworkIDManager; + +/// The primary interface for RakNet, RakPeer contains all major functions for the library. +/// See the individual functions for what the class can do. +/// \brief The main interface for network communications +class RAK_DLL_EXPORT RakPeerInterface +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(RakPeerInterface) + + ///Destructor + virtual ~RakPeerInterface() {} + + // --------------------------------------------------------------------------------------------Major Low Level Functions - Functions needed by most users-------------------------------------------------------------------------------------------- + /// \brief Starts the network threads, opens the listen port. + /// \details You must call this before calling Connect(). + /// \pre On the PS3, call Startup() after Client_Login() + /// \pre On Android, add the necessary permission to your application's androidmanifest.xml: + /// Multiple calls while already active are ignored. To call this function again with different settings, you must first call Shutdown(). + /// \note Call SetMaximumIncomingConnections if you want to accept incoming connections + /// \param[in] maxConnections The maximum number of connections between this instance of RakPeer and another instance of RakPeer. Required so the network can preallocate and for thread safety. A pure client would set this to 1. A pure server would set it to the number of allowed clients.- A hybrid would set it to the sum of both types of connections + /// \param[in] localPort The port to listen for connections on. On linux the system may be set up so thast ports under 1024 are restricted for everything but the root user. Use a higher port for maximum compatibility. + /// \param[in] socketDescriptors An array of SocketDescriptor structures to force RakNet to listen on a particular IP address or port (or both). Each SocketDescriptor will represent one unique socket. Do not pass redundant structures. To listen on a specific port, you can pass SocketDescriptor(myPort,0); such as for a server. For a client, it is usually OK to just pass SocketDescriptor(); However, on the XBOX be sure to use IPPROTO_VDP + /// \param[in] socketDescriptorCount The size of the \a socketDescriptors array. Pass 1 if you are not sure what to pass. + /// \param[in] threadPriority Passed to the thread creation routine. Use THREAD_PRIORITY_NORMAL for Windows. For Linux based systems, you MUST pass something reasonable based on the thread priorities for your application. + /// \return RAKNET_STARTED on success, otherwise appropriate failure enumeration. + virtual StartupResult Startup( unsigned int maxConnections, SocketDescriptor *socketDescriptors, unsigned socketDescriptorCount, int threadPriority=-99999 )=0; + + /// If you accept connections, you must call this or else security will not be enabled for incoming connections. + /// This feature requires more round trips, bandwidth, and CPU time for the connection handshake + /// x64 builds require under 25% of the CPU time of other builds + /// See the Encryption sample for example usage + /// \pre Must be called while offline + /// \pre LIBCAT_SECURITY must be defined to 1 in NativeFeatureIncludes.h for this function to have any effect + /// \param[in] publicKey A pointer to the public key for accepting new connections + /// \param[in] privateKey A pointer to the private key for accepting new connections + /// \param[in] bRequireClientKey: Should be set to false for most servers. Allows the server to accept a public key from connecting clients as a proof of identity but eats twice as much CPU time as a normal connection + virtual bool InitializeSecurity( const char *publicKey, const char *privateKey, bool bRequireClientKey = false )=0; + + /// Disables security for incoming connections. + /// \note Must be called while offline + virtual void DisableSecurity( void )=0; + + /// If secure connections are on, do not use secure connections for a specific IP address. + /// This is useful if you have a fixed-address internal server behind a LAN. + /// \note Secure connections are determined by the recipient of an incoming connection. This has no effect if called on the system attempting to connect. + /// \param[in] ip IP address to add. * wildcards are supported. + virtual void AddToSecurityExceptionList(const char *ip)=0; + + /// Remove a specific connection previously added via AddToSecurityExceptionList + /// \param[in] ip IP address to remove. Pass 0 to remove all IP addresses. * wildcards are supported. + virtual void RemoveFromSecurityExceptionList(const char *ip)=0; + + /// Checks to see if a given IP is in the security exception list + /// \param[in] IP address to check. + virtual bool IsInSecurityExceptionList(const char *ip)=0; + + /// Sets how many incoming connections are allowed. If this is less than the number of players currently connected, + /// no more players will be allowed to connect. If this is greater than the maximum number of peers allowed, + /// it will be reduced to the maximum number of peers allowed. + /// Defaults to 0, meaning by default, nobody can connect to you + /// \param[in] numberAllowed Maximum number of incoming connections allowed. + virtual void SetMaximumIncomingConnections( unsigned short numberAllowed )=0; + + /// Returns the value passed to SetMaximumIncomingConnections() + /// \return the maximum number of incoming connections, which is always <= maxConnections + virtual unsigned int GetMaximumIncomingConnections( void ) const=0; + + /// Returns how many open connections there are at this time + /// \return the number of open connections + virtual unsigned short NumberOfConnections(void) const=0; + + /// Sets the password incoming connections must match in the call to Connect (defaults to none). Pass 0 to passwordData to specify no password + /// This is a way to set a low level password for all incoming connections. To selectively reject connections, implement your own scheme using CloseConnection() to remove unwanted connections + /// \param[in] passwordData A data block that incoming connections must match. This can be just a password, or can be a stream of data. Specify 0 for no password data + /// \param[in] passwordDataLength The length in bytes of passwordData + virtual void SetIncomingPassword( const char* passwordData, int passwordDataLength )=0; + + /// Gets the password passed to SetIncomingPassword + /// \param[out] passwordData Should point to a block large enough to hold the password data you passed to SetIncomingPassword() + /// \param[in,out] passwordDataLength Maximum size of the array passwordData. Modified to hold the number of bytes actually written + virtual void GetIncomingPassword( char* passwordData, int *passwordDataLength )=0; + + /// \brief Connect to the specified host (ip or domain name) and server port. + /// Calling Connect and not calling SetMaximumIncomingConnections acts as a dedicated client. + /// Calling both acts as a true peer. This is a non-blocking connection. + /// You know the connection is successful when GetConnectionState() returns IS_CONNECTED or Receive() gets a message with the type identifier ID_CONNECTION_REQUEST_ACCEPTED. + /// If the connection is not successful, such as a rejected connection or no response then neither of these things will happen. + /// \pre Requires that you first call Startup() + /// \param[in] host Either a dotted IP address or a domain name + /// \param[in] remotePort Which port to connect to on the remote machine. + /// \param[in] passwordData A data block that must match the data block on the server passed to SetIncomingPassword. This can be a string or can be a stream of data. Use 0 for no password. + /// \param[in] passwordDataLength The length in bytes of passwordData + /// \param[in] publicKey The public key the server is using. If 0, the server is not using security. If non-zero, the publicKeyMode member determines how to connect + /// \param[in] connectionSocketIndex Index into the array of socket descriptors passed to socketDescriptors in RakPeer::Startup() to send on. + /// \param[in] sendConnectionAttemptCount How many datagrams to send to the other system to try to connect. + /// \param[in] timeBetweenSendConnectionAttemptsMS Time to elapse before a datagram is sent to the other system to try to connect. After sendConnectionAttemptCount number of attempts, ID_CONNECTION_ATTEMPT_FAILED is returned. Under low bandwidth conditions with multiple simultaneous outgoing connections, this value should be raised to 1000 or higher, or else the MTU detection can overrun the available bandwidth. + /// \param[in] timeoutTime How long to keep the connection alive before dropping it on unable to send a reliable message. 0 to use the default from SetTimeoutTime(UNASSIGNED_SYSTEM_ADDRESS); + /// \return CONNECTION_ATTEMPT_STARTED on successful initiation. Otherwise, an appropriate enumeration indicating failure. + /// \note CONNECTION_ATTEMPT_STARTED does not mean you are already connected! + /// \note It is possible to immediately get back ID_CONNECTION_ATTEMPT_FAILED if you exceed the maxConnections parameter passed to Startup(). This could happen if you call CloseConnection() with sendDisconnectionNotificaiton true, then immediately call Connect() before the connection has closed. + virtual ConnectionAttemptResult Connect( const char* host, unsigned short remotePort, const char *passwordData, int passwordDataLength, PublicKey *publicKey=0, unsigned connectionSocketIndex=0, unsigned sendConnectionAttemptCount=12, unsigned timeBetweenSendConnectionAttemptsMS=500, RakNet::TimeMS timeoutTime=0 )=0; + + /// \brief Connect to the specified host (ip or domain name) and server port, using a shared socket from another instance of RakNet + /// \param[in] host Either a dotted IP address or a domain name + /// \param[in] remotePort Which port to connect to on the remote machine. + /// \param[in] passwordData A data block that must match the data block on the server passed to SetIncomingPassword. This can be a string or can be a stream of data. Use 0 for no password. + /// \param[in] passwordDataLength The length in bytes of passwordData + /// \param[in] socket A bound socket returned by another instance of RakPeerInterface + /// \param[in] sendConnectionAttemptCount How many datagrams to send to the other system to try to connect. + /// \param[in] timeBetweenSendConnectionAttemptsMS Time to elapse before a datagram is sent to the other system to try to connect. After sendConnectionAttemptCount number of attempts, ID_CONNECTION_ATTEMPT_FAILED is returned. Under low bandwidth conditions with multiple simultaneous outgoing connections, this value should be raised to 1000 or higher, or else the MTU detection can overrun the available bandwidth. + /// \param[in] timeoutTime How long to keep the connection alive before dropping it on unable to send a reliable message. 0 to use the default from SetTimeoutTime(UNASSIGNED_SYSTEM_ADDRESS); + /// \return CONNECTION_ATTEMPT_STARTED on successful initiation. Otherwise, an appropriate enumeration indicating failure. + /// \note CONNECTION_ATTEMPT_STARTED does not mean you are already connected! + virtual ConnectionAttemptResult ConnectWithSocket(const char* host, unsigned short remotePort, const char *passwordData, int passwordDataLength, RakNetSocket2* socket, PublicKey *publicKey=0, unsigned sendConnectionAttemptCount=12, unsigned timeBetweenSendConnectionAttemptsMS=500, RakNet::TimeMS timeoutTime=0)=0; + + /// \brief Connect to the specified network ID (Platform specific console function) + /// \details Does built-in NAt traversal + /// \param[in] passwordData A data block that must match the data block on the server passed to SetIncomingPassword. This can be a string or can be a stream of data. Use 0 for no password. + /// \param[in] passwordDataLength The length in bytes of passwordData + //virtual bool Console2LobbyConnect( void *networkServiceId, const char *passwordData, int passwordDataLength )=0; + + /// \brief Stops the network threads and closes all connections. + /// \param[in] blockDuration How long, in milliseconds, you should wait for all remaining messages to go out, including ID_DISCONNECTION_NOTIFICATION. If 0, it doesn't wait at all. + /// \param[in] orderingChannel If blockDuration > 0, ID_DISCONNECTION_NOTIFICATION will be sent on this channel + /// \param[in] disconnectionNotificationPriority Priority to send ID_DISCONNECTION_NOTIFICATION on. + /// If you set it to 0 then the disconnection notification won't be sent + virtual void Shutdown( unsigned int blockDuration, unsigned char orderingChannel=0, PacketPriority disconnectionNotificationPriority=LOW_PRIORITY )=0; + + /// Returns if the network thread is running + /// \return true if the network thread is running, false otherwise + virtual bool IsActive( void ) const=0; + + /// Fills the array remoteSystems with the SystemAddress of all the systems we are connected to + /// \param[out] remoteSystems An array of SystemAddress structures to be filled with the SystemAddresss of the systems we are connected to. Pass 0 to remoteSystems to only get the number of systems we are connected to + /// \param[in, out] numberOfSystems As input, the size of remoteSystems array. As output, the number of elements put into the array + virtual bool GetConnectionList( SystemAddress *remoteSystems, unsigned short *numberOfSystems ) const=0; + + /// Returns the next uint32_t that Send() will return + /// \note If using RakPeer from multiple threads, this may not be accurate for your thread. Use IncrementNextSendReceipt() in that case. + /// \return The next uint32_t that Send() or SendList will return + virtual uint32_t GetNextSendReceipt(void)=0; + + /// Returns the next uint32_t that Send() will return, and increments the value by one + /// \note If using RakPeer from multiple threads, pass this to forceReceipt in the send function + /// \return The next uint32_t that Send() or SendList will return + virtual uint32_t IncrementNextSendReceipt(void)=0; + + /// Sends a block of data to the specified system that you are connected to. + /// This function only works while connected + /// The first byte should be a message identifier starting at ID_USER_PACKET_ENUM + /// \param[in] data The block of data to send + /// \param[in] length The size in bytes of the data to send + /// \param[in] priority What priority level to send on. See PacketPriority.h + /// \param[in] reliability How reliability to send this data. See PacketPriority.h + /// \param[in] orderingChannel When using ordered or sequenced messages, what channel to order these on. Messages are only ordered relative to other messages on the same stream + /// \param[in] systemIdentifier Who to send this packet to, or in the case of broadcasting who not to send it to. Pass either a SystemAddress structure or a RakNetGUID structure. Use UNASSIGNED_SYSTEM_ADDRESS or to specify none + /// \param[in] broadcast True to send this packet to all connected systems. If true, then systemAddress specifies who not to send the packet to. + /// \param[in] forceReceipt If 0, will automatically determine the receipt number to return. If non-zero, will return what you give it. + /// \return 0 on bad input. Otherwise a number that identifies this message. If \a reliability is a type that returns a receipt, on a later call to Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS with bytes 1-4 inclusive containing this number + virtual uint32_t Send( const char *data, const int length, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, uint32_t forceReceiptNumber=0 )=0; + + /// "Send" to yourself rather than a remote system. The message will be processed through the plugins and returned to the game as usual + /// This function works anytime + /// The first byte should be a message identifier starting at ID_USER_PACKET_ENUM + /// \param[in] data The block of data to send + /// \param[in] length The size in bytes of the data to send + virtual void SendLoopback( const char *data, const int length )=0; + + /// Sends a block of data to the specified system that you are connected to. Same as the above version, but takes a BitStream as input. + /// \param[in] bitStream The bitstream to send + /// \param[in] priority What priority level to send on. See PacketPriority.h + /// \param[in] reliability How reliability to send this data. See PacketPriority.h + /// \param[in] orderingChannel When using ordered or sequenced messages, what channel to order these on. Messages are only ordered relative to other messages on the same stream + /// \param[in] systemIdentifier Who to send this packet to, or in the case of broadcasting who not to send it to. Pass either a SystemAddress structure or a RakNetGUID structure. Use UNASSIGNED_SYSTEM_ADDRESS or to specify none + /// \param[in] broadcast True to send this packet to all connected systems. If true, then systemAddress specifies who not to send the packet to. + /// \param[in] forceReceipt If 0, will automatically determine the receipt number to return. If non-zero, will return what you give it. + /// \return 0 on bad input. Otherwise a number that identifies this message. If \a reliability is a type that returns a receipt, on a later call to Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS with bytes 1-4 inclusive containing this number + /// \note COMMON MISTAKE: When writing the first byte, bitStream->Write((unsigned char) ID_MY_TYPE) be sure it is casted to a byte, and you are not writing a 4 byte enumeration. + virtual uint32_t Send( const RakNet::BitStream * bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, uint32_t forceReceiptNumber=0 )=0; + + /// Sends multiple blocks of data, concatenating them automatically. + /// + /// This is equivalent to: + /// RakNet::BitStream bs; + /// bs.WriteAlignedBytes(block1, blockLength1); + /// bs.WriteAlignedBytes(block2, blockLength2); + /// bs.WriteAlignedBytes(block3, blockLength3); + /// Send(&bs, ...) + /// + /// This function only works while connected + /// \param[in] data An array of pointers to blocks of data + /// \param[in] lengths An array of integers indicating the length of each block of data + /// \param[in] numParameters Length of the arrays data and lengths + /// \param[in] priority What priority level to send on. See PacketPriority.h + /// \param[in] reliability How reliability to send this data. See PacketPriority.h + /// \param[in] orderingChannel When using ordered or sequenced messages, what channel to order these on. Messages are only ordered relative to other messages on the same stream + /// \param[in] systemIdentifier Who to send this packet to, or in the case of broadcasting who not to send it to. Pass either a SystemAddress structure or a RakNetGUID structure. Use UNASSIGNED_SYSTEM_ADDRESS or to specify none + /// \param[in] broadcast True to send this packet to all connected systems. If true, then systemAddress specifies who not to send the packet to. + /// \param[in] forceReceipt If 0, will automatically determine the receipt number to return. If non-zero, will return what you give it. + /// \return 0 on bad input. Otherwise a number that identifies this message. If \a reliability is a type that returns a receipt, on a later call to Receive() you will get ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS with bytes 1-4 inclusive containing this number + virtual uint32_t SendList( const char **data, const int *lengths, const int numParameters, PacketPriority priority, PacketReliability reliability, char orderingChannel, const AddressOrGUID systemIdentifier, bool broadcast, uint32_t forceReceiptNumber=0 )=0; + + /// Gets a message from the incoming message queue. + /// Use DeallocatePacket() to deallocate the message after you are done with it. + /// User-thread functions, such as RPC calls and the plugin function PluginInterface::Update occur here. + /// \return 0 if no packets are waiting to be handled, otherwise a pointer to a packet. + /// \note COMMON MISTAKE: Be sure to call this in a loop, once per game tick, until it returns 0. If you only process one packet per game tick they will buffer up. + /// sa RakNetTypes.h contains struct Packet + virtual Packet* Receive( void )=0; + + /// Call this to deallocate a message returned by Receive() when you are done handling it. + /// \param[in] packet The message to deallocate. + virtual void DeallocatePacket( Packet *packet )=0; + + /// Return the total number of connections we are allowed + virtual unsigned int GetMaximumNumberOfPeers( void ) const=0; + + // -------------------------------------------------------------------------------------------- Connection Management Functions-------------------------------------------------------------------------------------------- + /// Close the connection to another host (if we initiated the connection it will disconnect, if they did it will kick them out). + /// \param[in] target Which system to close the connection to. + /// \param[in] sendDisconnectionNotification True to send ID_DISCONNECTION_NOTIFICATION to the recipient. False to close it silently. + /// \param[in] channel Which ordering channel to send the disconnection notification on, if any + /// \param[in] disconnectionNotificationPriority Priority to send ID_DISCONNECTION_NOTIFICATION on. + virtual void CloseConnection( const AddressOrGUID target, bool sendDisconnectionNotification, unsigned char orderingChannel=0, PacketPriority disconnectionNotificationPriority=LOW_PRIORITY )=0; + + /// Returns if a system is connected, disconnected, connecting in progress, or various other states + /// \param[in] systemIdentifier The system we are referring to + /// \note This locks a mutex, do not call too frequently during connection attempts or the attempt will take longer and possibly even timeout + /// \return What state the remote system is in + virtual ConnectionState GetConnectionState(const AddressOrGUID systemIdentifier)=0; + + /// Cancel a pending connection attempt + /// If we are already connected, the connection stays open + /// \param[in] target Which system to cancel + virtual void CancelConnectionAttempt( const SystemAddress target )=0; + + /// Given a systemAddress, returns an index from 0 to the maximum number of players allowed - 1. + /// \param[in] systemAddress The SystemAddress we are referring to + /// \return The index of this SystemAddress or -1 on system not found. + virtual int GetIndexFromSystemAddress( const SystemAddress systemAddress ) const=0; + + /// This function is only useful for looping through all systems + /// Given an index, will return a SystemAddress. + /// \param[in] index Index should range between 0 and the maximum number of players allowed - 1. + /// \return The SystemAddress + virtual SystemAddress GetSystemAddressFromIndex( unsigned int index )=0; + + /// Same as GetSystemAddressFromIndex but returns RakNetGUID + /// \param[in] index Index should range between 0 and the maximum number of players allowed - 1. + /// \return The RakNetGUID + virtual RakNetGUID GetGUIDFromIndex( unsigned int index )=0; + + /// Same as calling GetSystemAddressFromIndex and GetGUIDFromIndex for all systems, but more efficient + /// Indices match each other, so \a addresses[0] and \a guids[0] refer to the same system + /// \param[out] addresses All system addresses. Size of the list is the number of connections. Size of the list will match the size of the \a guids list. + /// \param[out] guids All guids. Size of the list is the number of connections. Size of the list will match the size of the \a addresses list. + virtual void GetSystemList(DataStructures::List &addresses, DataStructures::List &guids) const=0; + + /// Bans an IP from connecting. Banned IPs persist between connections but are not saved on shutdown nor loaded on startup. + /// param[in] IP Dotted IP address. Can use * as a wildcard, such as 128.0.0.* will ban all IP addresses starting with 128.0.0 + /// \param[in] milliseconds how many ms for a temporary ban. Use 0 for a permanent ban + virtual void AddToBanList( const char *IP, RakNet::TimeMS milliseconds=0 )=0; + + /// Allows a previously banned IP to connect. + /// param[in] Dotted IP address. Can use * as a wildcard, such as 128.0.0.* will banAll IP addresses starting with 128.0.0 + virtual void RemoveFromBanList( const char *IP )=0; + + /// Allows all previously banned IPs to connect. + virtual void ClearBanList( void )=0; + + /// Returns true or false indicating if a particular IP is banned. + /// \param[in] IP - Dotted IP address. + /// \return true if IP matches any IPs in the ban list, accounting for any wildcards. False otherwise. + virtual bool IsBanned( const char *IP )=0; + + /// Enable or disable allowing frequent connections from the same IP adderss + /// This is a security measure which is disabled by default, but can be set to true to prevent attackers from using up all connection slots + /// \param[in] b True to limit connections from the same ip to at most 1 per 100 milliseconds. + virtual void SetLimitIPConnectionFrequency(bool b)=0; + + // --------------------------------------------------------------------------------------------Pinging Functions - Functions dealing with the automatic ping mechanism-------------------------------------------------------------------------------------------- + /// Send a ping to the specified connected system. + /// \pre The sender and recipient must already be started via a successful call to Startup() + /// \param[in] target Which system to ping + virtual void Ping( const SystemAddress target )=0; + + /// Send a ping to the specified unconnected system. The remote system, if it is Initialized, will respond with ID_PONG followed by sizeof(RakNet::TimeMS) containing the system time the ping was sent.(Default is 4 bytes - See __GET_TIME_64BIT in RakNetTypes.h + /// System should reply with ID_PONG if it is active + /// \param[in] host Either a dotted IP address or a domain name. Can be 255.255.255.255 for LAN broadcast. + /// \param[in] remotePort Which port to connect to on the remote machine. + /// \param[in] onlyReplyOnAcceptingConnections Only request a reply if the remote system is accepting connections + /// \param[in] connectionSocketIndex Index into the array of socket descriptors passed to socketDescriptors in RakPeer::Startup() to send on. + /// \return true on success, false on failure (unknown hostname) + virtual bool Ping( const char* host, unsigned short remotePort, bool onlyReplyOnAcceptingConnections, unsigned connectionSocketIndex=0 )=0; + + /// Returns the average of all ping times read for the specific system or -1 if none read yet + /// \param[in] systemAddress Which system we are referring to + /// \return The ping time for this system, or -1 + virtual int GetAveragePing( const AddressOrGUID systemIdentifier )=0; + + /// Returns the last ping time read for the specific system or -1 if none read yet + /// \param[in] systemAddress Which system we are referring to + /// \return The last ping time for this system, or -1 + virtual int GetLastPing( const AddressOrGUID systemIdentifier ) const=0; + + /// Returns the lowest ping time read or -1 if none read yet + /// \param[in] systemAddress Which system we are referring to + /// \return The lowest ping time for this system, or -1 + virtual int GetLowestPing( const AddressOrGUID systemIdentifier ) const=0; + + /// Ping the remote systems every so often, or not. Can be called anytime. + /// By default this is true. Recommended to leave on, because congestion control uses it to determine how often to resend lost packets. + /// It would be true by default to prevent timestamp drift, since in the event of a clock spike, the timestamp deltas would no longer be accurate + /// \param[in] doPing True to start occasional pings. False to stop them. + virtual void SetOccasionalPing( bool doPing )=0; + + /// Return the clock difference between your system and the specified system + /// Subtract GetClockDifferential() from a time returned by the remote system to get that time relative to your own system + /// Returns 0 if the system is unknown + /// \param[in] systemIdentifier Which system we are referring to + virtual RakNet::Time GetClockDifferential( const AddressOrGUID systemIdentifier )=0; + + // --------------------------------------------------------------------------------------------Static Data Functions - Functions dealing with API defined synchronized memory-------------------------------------------------------------------------------------------- + /// Sets the data to send along with a LAN server discovery or offline ping reply. + /// \a length should be under 400 bytes, as a security measure against flood attacks + /// \param[in] data a block of data to store, or 0 for none + /// \param[in] length The length of data in bytes, or 0 for none + /// \sa Ping.cpp + virtual void SetOfflinePingResponse( const char *data, const unsigned int length )=0; + + /// Returns pointers to a copy of the data passed to SetOfflinePingResponse + /// \param[out] data A pointer to a copy of the data passed to \a SetOfflinePingResponse() + /// \param[out] length A pointer filled in with the length parameter passed to SetOfflinePingResponse() + /// \sa SetOfflinePingResponse + virtual void GetOfflinePingResponse( char **data, unsigned int *length )=0; + + //--------------------------------------------------------------------------------------------Network Functions - Functions dealing with the network in general-------------------------------------------------------------------------------------------- + /// Return the unique address identifier that represents you or another system on the the network and is based on your local IP / port. + /// \note Not supported by the XBOX + /// \param[in] systemAddress Use UNASSIGNED_SYSTEM_ADDRESS to get your behind-LAN address. Use a connected system to get their behind-LAN address + /// \param[in] index When you have multiple internal IDs, which index to return? Currently limited to MAXIMUM_NUMBER_OF_INTERNAL_IDS (so the maximum value of this variable is MAXIMUM_NUMBER_OF_INTERNAL_IDS-1) + /// \return the identifier of your system internally, which may not be how other systems see if you if you are behind a NAT or proxy + virtual SystemAddress GetInternalID( const SystemAddress systemAddress=UNASSIGNED_SYSTEM_ADDRESS, const int index=0 ) const=0; + + /// \brief Sets your internal IP address, for platforms that do not support reading it, or to override a value + /// \param[in] systemAddress. The address to set. Use SystemAddress::FromString() if you want to use a dotted string + /// \param[in] index When you have multiple internal IDs, which index to set? + virtual void SetInternalID(SystemAddress systemAddress, int index=0)=0; + + /// Return the unique address identifier that represents you on the the network and is based on your externalIP / port + /// (the IP / port the specified player uses to communicate with you) + /// \param[in] target Which remote system you are referring to for your external ID. Usually the same for all systems, unless you have two or more network cards. + virtual SystemAddress GetExternalID( const SystemAddress target ) const=0; + + /// Return my own GUID + virtual const RakNetGUID GetMyGUID(void) const=0; + + /// Return the address bound to a socket at the specified index + virtual SystemAddress GetMyBoundAddress(const int socketIndex=0)=0; + + /// Get a random number (to generate a GUID) + static uint64_t Get64BitUniqueRandomNumber(void); + + /// Given a connected system, give us the unique GUID representing that instance of RakPeer. + /// This will be the same on all systems connected to that instance of RakPeer, even if the external system addresses are different + /// Currently O(log(n)), but this may be improved in the future. If you use this frequently, you may want to cache the value as it won't change. + /// Returns UNASSIGNED_RAKNET_GUID if system address can't be found. + /// If \a input is UNASSIGNED_SYSTEM_ADDRESS, will return your own GUID + /// \pre Call Startup() first, or the function will return UNASSIGNED_RAKNET_GUID + /// \param[in] input The system address of the system we are connected to + virtual const RakNetGUID& GetGuidFromSystemAddress( const SystemAddress input ) const=0; + + /// Given the GUID of a connected system, give us the system address of that system. + /// The GUID will be the same on all systems connected to that instance of RakPeer, even if the external system addresses are different + /// Currently O(log(n)), but this may be improved in the future. If you use this frequently, you may want to cache the value as it won't change. + /// If \a input is UNASSIGNED_RAKNET_GUID, will return UNASSIGNED_SYSTEM_ADDRESS + /// \param[in] input The RakNetGUID of the system we are checking to see if we are connected to + virtual SystemAddress GetSystemAddressFromGuid( const RakNetGUID input ) const=0; + + /// Given the SystemAddress of a connected system, get the public key they provided as an identity + /// Returns false if system address was not found or client public key is not known + /// \param[in] input The RakNetGUID of the system + /// \param[in] client_public_key The connected client's public key is copied to this address. Buffer must be cat::EasyHandshake::PUBLIC_KEY_BYTES bytes in length. + virtual bool GetClientPublicKeyFromSystemAddress( const SystemAddress input, char *client_public_key ) const=0; + + /// Set the time, in MS, to use before considering ourselves disconnected after not being able to deliver a reliable message. + /// Default time is 10,000 or 10 seconds in release and 30,000 or 30 seconds in debug. + /// Do not set different values for different computers that are connected to each other, or you won't be able to reconnect after ID_CONNECTION_LOST + /// \param[in] timeMS Time, in MS + /// \param[in] target Which system to do this for. Pass UNASSIGNED_SYSTEM_ADDRESS for all systems. + virtual void SetTimeoutTime( RakNet::TimeMS timeMS, const SystemAddress target )=0; + + /// \param[in] target Which system to do this for. Pass UNASSIGNED_SYSTEM_ADDRESS to get the default value + /// \return timeoutTime for a given system. + virtual RakNet::TimeMS GetTimeoutTime( const SystemAddress target )=0; + + /// Returns the current MTU size + /// \param[in] target Which system to get this for. UNASSIGNED_SYSTEM_ADDRESS to get the default + /// \return The current MTU size + virtual int GetMTUSize( const SystemAddress target ) const=0; + + /// Returns the number of IP addresses this system has internally. Get the actual addresses from GetLocalIP() + virtual unsigned GetNumberOfAddresses( void )=0; + + /// Returns an IP address at index 0 to GetNumberOfAddresses-1 + /// \param[in] index index into the list of IP addresses + /// \return The local IP address at this index + virtual const char* GetLocalIP( unsigned int index )=0; + + /// Is this a local IP? + /// \param[in] An IP address to check, excluding the port + /// \return True if this is one of the IP addresses returned by GetLocalIP + virtual bool IsLocalIP( const char *ip )=0; + + /// Allow or disallow connection responses from any IP. Normally this should be false, but may be necessary + /// when connecting to servers with multiple IP addresses. + /// \param[in] allow - True to allow this behavior, false to not allow. Defaults to false. Value persists between connections + virtual void AllowConnectionResponseIPMigration( bool allow )=0; + + /// Sends a one byte message ID_ADVERTISE_SYSTEM to the remote unconnected system. + /// This will tell the remote system our external IP outside the LAN along with some user data. + /// \pre The sender and recipient must already be started via a successful call to Initialize + /// \param[in] host Either a dotted IP address or a domain name + /// \param[in] remotePort Which port to connect to on the remote machine. + /// \param[in] data Optional data to append to the packet. + /// \param[in] dataLength length of data in bytes. Use 0 if no data. + /// \param[in] connectionSocketIndex Index into the array of socket descriptors passed to socketDescriptors in RakPeer::Startup() to send on. + /// \return false if IsActive()==false or the host is unresolvable. True otherwise + virtual bool AdvertiseSystem( const char *host, unsigned short remotePort, const char *data, int dataLength, unsigned connectionSocketIndex=0 )=0; + + /// Controls how often to return ID_DOWNLOAD_PROGRESS for large message downloads. + /// ID_DOWNLOAD_PROGRESS is returned to indicate a new partial message chunk, roughly the MTU size, has arrived + /// As it can be slow or cumbersome to get this notification for every chunk, you can set the interval at which it is returned. + /// Defaults to 0 (never return this notification) + /// \param[in] interval How many messages to use as an interval + virtual void SetSplitMessageProgressInterval(int interval)=0; + + /// Returns what was passed to SetSplitMessageProgressInterval() + /// \return What was passed to SetSplitMessageProgressInterval(). Default to 0. + virtual int GetSplitMessageProgressInterval(void) const=0; + + /// Set how long to wait before giving up on sending an unreliable message + /// Useful if the network is clogged up. + /// Set to 0 or less to never timeout. Defaults to 0. + /// \param[in] timeoutMS How many ms to wait before simply not sending an unreliable message. + virtual void SetUnreliableTimeout(RakNet::TimeMS timeoutMS)=0; + + /// Send a message to host, with the IP socket option TTL set to 3 + /// This message will not reach the host, but will open the router. + /// Used for NAT-Punchthrough + virtual void SendTTL( const char* host, unsigned short remotePort, int ttl, unsigned connectionSocketIndex=0 )=0; + + // -------------------------------------------------------------------------------------------- Plugin Functions-------------------------------------------------------------------------------------------- + /// \brief Attaches a Plugin interface to an instance of the base class (RakPeer or PacketizedTCP) to run code automatically on message receipt in the Receive call. + /// If the plugin returns false from PluginInterface::UsesReliabilityLayer(), which is the case for all plugins except PacketLogger, you can call AttachPlugin() and DetachPlugin() for this plugin while RakPeer is active. + /// \param[in] messageHandler Pointer to the plugin to attach. + virtual void AttachPlugin( PluginInterface2 *plugin )=0; + + /// \brief Detaches a Plugin interface from the instance of the base class (RakPeer or PacketizedTCP) it is attached to. + /// \details This method disables the plugin code from running automatically on base class's updates or message receipt. + /// If the plugin returns false from PluginInterface::UsesReliabilityLayer(), which is the case for all plugins except PacketLogger, you can call AttachPlugin() and DetachPlugin() for this plugin while RakPeer is active. + /// \param[in] messageHandler Pointer to a plugin to detach. + virtual void DetachPlugin( PluginInterface2 *messageHandler )=0; + + // --------------------------------------------------------------------------------------------Miscellaneous Functions-------------------------------------------------------------------------------------------- + /// Put a message back at the end of the receive queue in case you don't want to deal with it immediately + /// \param[in] packet The packet you want to push back. + /// \param[in] pushAtHead True to push the packet so that the next receive call returns it. False to push it at the end of the queue (obviously pushing it at the end makes the packets out of order) + virtual void PushBackPacket( Packet *packet, bool pushAtHead )=0; + + /// \internal + /// \brief For a given system identified by \a guid, change the SystemAddress to send to. + /// \param[in] guid The connection we are referring to + /// \param[in] systemAddress The new address to send to + virtual void ChangeSystemAddress(RakNetGUID guid, const SystemAddress &systemAddress)=0; + + /// \returns a packet for you to write to if you want to create a Packet for some reason. + /// You can add it to the receive buffer with PushBackPacket + /// \param[in] dataSize How many bytes to allocate for the buffer + /// \return A packet you can write to + virtual Packet* AllocatePacket(unsigned dataSize)=0; + + /// Get the socket used with a particular active connection + /// The smart pointer reference counts the RakNetSocket2 object, so the socket will remain active as long as the smart pointer does, even if RakNet were to shutdown or close the connection. + /// \note This sends a query to the thread and blocks on the return value for up to one second. In practice it should only take a millisecond or so. + /// \param[in] target Which system + /// \return A smart pointer object containing the socket information about the socket. Be sure to check IsNull() which is returned if the update thread is unresponsive, shutting down, or if this system is not connected + virtual RakNetSocket2* GetSocket( const SystemAddress target )=0; + + /// Get all sockets in use + /// \note This sends a query to the thread and blocks on the return value for up to one second. In practice it should only take a millisecond or so. + /// \param[out] sockets List of RakNetSocket2 structures in use. Sockets will not be closed until \a sockets goes out of scope + virtual void GetSockets( DataStructures::List &sockets )=0; + virtual void ReleaseSockets( DataStructures::List &sockets )=0; + + virtual void WriteOutOfBandHeader(RakNet::BitStream *bitStream)=0; + + /// If you need code to run in the same thread as RakNet's update thread, this function can be used for that + /// \param[in] _userUpdateThreadPtr C callback function + /// \param[in] _userUpdateThreadData Passed to C callback function + virtual void SetUserUpdateThread(void (*_userUpdateThreadPtr)(RakPeerInterface *, void *), void *_userUpdateThreadData)=0; + + /// Set a C callback to be called whenever a datagram arrives + /// Return true from the callback to have RakPeer handle the datagram. Return false and RakPeer will ignore the datagram. + /// This can be used to filter incoming datagrams by system, or to share a recvfrom socket with RakPeer + /// RNS2RecvStruct will only remain valid for the duration of the call + /// If the incoming datagram is not from your game at all, it is a RakNet packet. + /// If the incoming datagram has an IP address that matches a known address from your game, then check the first byte of data. + /// For RakNet connected systems, the first bit is always 1. So for your own game packets, make sure the first bit is always 0. + virtual void SetIncomingDatagramEventHandler( bool (*_incomingDatagramEventHandler)(RNS2RecvStruct *) )=0; + + // --------------------------------------------------------------------------------------------Network Simulator Functions-------------------------------------------------------------------------------------------- + /// Adds simulated ping and packet loss to the outgoing data flow. + /// To simulate bi-directional ping and packet loss, you should call this on both the sender and the recipient, with half the total ping and packetloss value on each. + /// You can exclude network simulator code with the _RELEASE #define to decrease code size + /// \deprecated Use http://www.jenkinssoftware.com/forum/index.php?topic=1671.0 instead. + /// \note Doesn't work past version 3.6201 + /// \param[in] packetloss Chance to lose a packet. Ranges from 0 to 1. + /// \param[in] minExtraPing The minimum time to delay sends. + /// \param[in] extraPingVariance The additional random time to delay sends. + virtual void ApplyNetworkSimulator( float packetloss, unsigned short minExtraPing, unsigned short extraPingVariance)=0; + + /// Limits how much outgoing bandwidth can be sent per-connection. + /// This limit does not apply to the sum of all connections! + /// Exceeding the limit queues up outgoing traffic + /// \param[in] maxBitsPerSecond Maximum bits per second to send. Use 0 for unlimited (default). Once set, it takes effect immedately and persists until called again. + virtual void SetPerConnectionOutgoingBandwidthLimit( unsigned maxBitsPerSecond )=0; + + /// Returns if you previously called ApplyNetworkSimulator + /// \return If you previously called ApplyNetworkSimulator + virtual bool IsNetworkSimulatorActive( void )=0; + + // --------------------------------------------------------------------------------------------Statistical Functions - Functions dealing with API performance-------------------------------------------------------------------------------------------- + + /// Returns a structure containing a large set of network statistics for the specified system. + /// You can map this data to a string using the C style StatisticsToString() function + /// \param[in] systemAddress: Which connected system to get statistics for + /// \param[in] rns If you supply this structure, it will be written to it. Otherwise it will use a static struct, which is not threadsafe + /// \return 0 on can't find the specified system. A pointer to a set of data otherwise. + /// \sa RakNetStatistics.h + virtual RakNetStatistics * GetStatistics( const SystemAddress systemAddress, RakNetStatistics *rns=0 )=0; + /// \brief Returns the network statistics of the system at the given index in the remoteSystemList. + /// \return True if the index is less than the maximum number of peers allowed and the system is active. False otherwise. + virtual bool GetStatistics( const unsigned int index, RakNetStatistics *rns )=0; + /// \brief Returns the list of systems, and statistics for each of those systems + /// Each system has one entry in each of the lists, in the same order + /// \param[out] addresses SystemAddress for each connected system + /// \param[out] guids RakNetGUID for each connected system + /// \param[out] statistics Calculated RakNetStatistics for each connected system + virtual void GetStatisticsList(DataStructures::List &addresses, DataStructures::List &guids, DataStructures::List &statistics)=0; + + /// \Returns how many messages are waiting when you call Receive() + virtual unsigned int GetReceiveBufferSize(void)=0; + + // --------------------------------------------------------------------------------------------EVERYTHING AFTER THIS COMMENT IS FOR INTERNAL USE ONLY-------------------------------------------------------------------------------------------- + + /// \internal + // Call manually if RAKPEER_USER_THREADED==1 at least every 30 milliseconds. + // updateBitStream should be: + // BitStream updateBitStream( MAXIMUM_MTU_SIZE + // #if LIBCAT_SECURITY==1 + // + cat::AuthenticatedEncryption::OVERHEAD_BYTES + // #endif + // ); + virtual bool RunUpdateCycle( BitStream &updateBitStream )=0; + + /// \internal + virtual bool SendOutOfBand(const char *host, unsigned short remotePort, const char *data, BitSize_t dataLength, unsigned connectionSocketIndex=0 )=0; + +} +// #if defined(SN_TARGET_PSP2) +// __attribute__((aligned(8))) +// #endif +; + +} // namespace RakNet + +#endif diff --git a/include/raknet/RakSleep.hpp b/include/raknet/RakSleep.hpp new file mode 100644 index 0000000..5d6e8ea --- /dev/null +++ b/include/raknet/RakSleep.hpp @@ -0,0 +1,18 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAK_SLEEP_H +#define __RAK_SLEEP_H + +#include "Export.hpp" + +void RAK_DLL_EXPORT RakSleep(unsigned int ms); + +#endif diff --git a/include/raknet/RakString.hpp b/include/raknet/RakString.hpp new file mode 100644 index 0000000..c856689 --- /dev/null +++ b/include/raknet/RakString.hpp @@ -0,0 +1,354 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAK_STRING_H +#define __RAK_STRING_H + +#include "Export.hpp" +#include "DS_List.hpp" +#include "RakNetTypes.hpp" // int64_t +#include +#include "stdarg.h" + + +#ifdef _WIN32 + + + +#include "WindowsIncludes.hpp" +#endif + +namespace RakNet +{ +/// Forward declarations +class SimpleMutex; +class BitStream; + +/// \brief String class +/// \details Has the following improvements over std::string +/// -Reference counting: Suitable to store in lists +/// -Variadic assignment operator +/// -Doesn't cause linker errors +class RAK_DLL_EXPORT RakString +{ +public: + // Constructors + RakString(); + RakString(char input); + RakString(unsigned char input); + RakString(const unsigned char *format, ...); + RakString(const char *format, ...); + ~RakString(); + RakString( const RakString & rhs); + + /// Implicit return of const char* + operator const char* () const {return sharedString->c_str;} + + /// Same as std::string::c_str + const char *C_String(void) const {return sharedString->c_str;} + + // Lets you modify the string. Do not make the string longer - however, you can make it shorter, or change the contents. + // Pointer is only valid in the scope of RakString itself + char *C_StringUnsafe(void) {Clone(); return sharedString->c_str;} + + /// Assigment operators + RakString& operator = ( const RakString& rhs ); + RakString& operator = ( const char *str ); + RakString& operator = ( char *str ); + RakString& operator = ( const unsigned char *str ); + RakString& operator = ( char unsigned *str ); + RakString& operator = ( const char c ); + + /// Concatenation + RakString& operator +=( const RakString& rhs); + RakString& operator += ( const char *str ); + RakString& operator += ( char *str ); + RakString& operator += ( const unsigned char *str ); + RakString& operator += ( char unsigned *str ); + RakString& operator += ( const char c ); + + /// Character index. Do not use to change the string however. + unsigned char operator[] ( const unsigned int position ) const; + +#ifdef _WIN32 + // Return as Wide char + // Deallocate with DeallocWideChar + WCHAR * ToWideChar(void); + void DeallocWideChar(WCHAR * w); + + void FromWideChar(const wchar_t *source); + static RakNet::RakString FromWideChar_S(const wchar_t *source); +#endif + + /// String class find replacement + /// Searches the string for the content specified in stringToFind and returns the position of the first occurrence in the string. + /// Search only includes characters on or after position pos, ignoring any possible occurrences in previous locations. + /// \param[in] stringToFind The string to find inside of this object's string + /// \param[in] pos The position in the string to start the search + /// \return Returns the position of the first occurrence in the string. + size_t Find(const char *stringToFind,size_t pos = 0 ); + + /// Equality + bool operator==(const RakString &rhs) const; + bool operator==(const char *str) const; + bool operator==(char *str) const; + + // Comparison + bool operator < ( const RakString& right ) const; + bool operator <= ( const RakString& right ) const; + bool operator > ( const RakString& right ) const; + bool operator >= ( const RakString& right ) const; + + /// Inequality + bool operator!=(const RakString &rhs) const; + bool operator!=(const char *str) const; + bool operator!=(char *str) const; + + /// Change all characters to lowercase + const char * ToLower(void); + + /// Change all characters to uppercase + const char * ToUpper(void); + + /// Set the value of the string + void Set(const char *format, ...); + + /// Sets a copy of a substring of str as the new content. The substring is the portion of str + /// that begins at the character position pos and takes up to n characters + /// (it takes less than n if the end of str is reached before). + /// \param[in] str The string to copy in + /// \param[in] pos The position on str to start the copy + /// \param[in] n How many chars to copy + /// \return Returns the string, note that the current string is set to that value as well + RakString Assign(const char *str,size_t pos, size_t n ); + + /// Returns if the string is empty. Also, C_String() would return "" + bool IsEmpty(void) const; + + /// Returns the length of the string + size_t GetLength(void) const; + size_t GetLengthUTF8(void) const; + + /// Replace character(s) in starting at index, for count, with c + void Replace(unsigned index, unsigned count, unsigned char c); + + /// Replace character at index with c + void SetChar( unsigned index, unsigned char c ); + + /// Replace character at index with string s + void SetChar( unsigned index, RakNet::RakString s ); + + /// Make sure string is no longer than \a length + void Truncate(unsigned int length); + void TruncateUTF8(unsigned int length); + + // Gets the substring starting at index for count characters + RakString SubStr(unsigned int index, unsigned int count) const; + + /// Erase characters out of the string at index for count + void Erase(unsigned int index, unsigned int count); + + /// Set the first instance of c with a NULL terminator + void TerminateAtFirstCharacter(char c); + /// Set the last instance of c with a NULL terminator + void TerminateAtLastCharacter(char c); + + void StartAfterFirstCharacter(char c); + void StartAfterLastCharacter(char c); + + /// Returns how many occurances there are of \a c in the string + int GetCharacterCount(char c); + + /// Remove all instances of c + void RemoveCharacter(char c); + + /// Create a RakString with a value, without doing printf style parsing + /// Equivalent to assignment operator + static RakNet::RakString NonVariadic(const char *str); + + /// Hash the string into an unsigned int + static unsigned long ToInteger(const char *str); + static unsigned long ToInteger(const RakString &rs); + + /// \brief Read an integer out of a substring + /// \param[in] str The string + /// \param[in] pos The position on str where the integer starts + /// \param[in] n How many chars to copy + static int ReadIntFromSubstring(const char *str, size_t pos, size_t n); + + // Like strncat, but for a fixed length + void AppendBytes(const char *bytes, unsigned int count); + + /// Compare strings (case sensitive) + int StrCmp(const RakString &rhs) const; + + /// Compare strings (case sensitive), up to num characters + int StrNCmp(const RakString &rhs, size_t num) const; + + /// Compare strings (not case sensitive) + int StrICmp(const RakString &rhs) const; + + /// Clear the string + void Clear(void); + + /// Print the string to the screen + void Printf(void); + + /// Print the string to a file + void FPrintf(FILE *fp); + + /// Does the given IP address match the IP address encoded into this string, accounting for wildcards? + bool IPAddressMatch(const char *IP); + + /// Does the string contain non-printable characters other than spaces? + bool ContainsNonprintableExceptSpaces(void) const; + + /// Is this a valid email address? + bool IsEmailAddress(void) const; + + /// URL Encode the string. See http://www.codeguru.com/cpp/cpp/cpp_mfc/article.php/c4029/ + RakNet::RakString& URLEncode(void); + + /// URL decode the string + RakNet::RakString& URLDecode(void); + + /// https://servers.api.rackspacecloud.com/v1.0 to https://, servers.api.rackspacecloud.com, /v1.0 + void SplitURI(RakNet::RakString &header, RakNet::RakString &domain, RakNet::RakString &path); + + /// Scan for quote, double quote, and backslash and prepend with backslash + RakNet::RakString& SQLEscape(void); + + /// Format as a POST command that can be sent to a webserver + /// \param[in] uri For example, masterserver2.raknet.com/testServer + /// \param[in] contentType For example, text/plain; charset=UTF-8 + /// \param[in] body Body of the post + /// \return Formatted string + static RakNet::RakString FormatForPOST(const char* uri, const char* contentType, const char* body, const char* extraHeaders=""); + static RakNet::RakString FormatForPUT(const char* uri, const char* contentType, const char* body, const char* extraHeaders=""); + + /// Format as a GET command that can be sent to a webserver + /// \param[in] uri For example, masterserver2.raknet.com/testServer?__gameId=comprehensivePCGame + /// \return Formatted string + static RakNet::RakString FormatForGET(const char* uri, const char* extraHeaders=""); + + /// Format as a DELETE command that can be sent to a webserver + /// \param[in] uri For example, masterserver2.raknet.com/testServer?__gameId=comprehensivePCGame&__rowId=1 + /// \return Formatted string + static RakNet::RakString FormatForDELETE(const char* uri, const char* extraHeaders=""); + + /// Fix to be a file path, ending with / + RakNet::RakString& MakeFilePath(void); + + /// RakString uses a freeList of old no-longer used strings + /// Call this function to clear this memory on shutdown + static void FreeMemory(void); + /// \internal + static void FreeMemoryNoMutex(void); + + /// Serialize to a bitstream, uncompressed (slightly faster) + /// \param[out] bs Bitstream to serialize to + void Serialize(BitStream *bs) const; + + /// Static version of the Serialize function + static void Serialize(const char *str, BitStream *bs); + + /// Serialize to a bitstream, compressed (better bandwidth usage) + /// \param[out] bs Bitstream to serialize to + /// \param[in] languageId languageId to pass to the StringCompressor class + /// \param[in] writeLanguageId encode the languageId variable in the stream. If false, 0 is assumed, and DeserializeCompressed will not look for this variable in the stream (saves bandwidth) + /// \pre StringCompressor::AddReference must have been called to instantiate the class (Happens automatically from RakPeer::Startup()) + void SerializeCompressed(BitStream *bs, uint8_t languageId=0, bool writeLanguageId=false) const; + + /// Static version of the SerializeCompressed function + static void SerializeCompressed(const char *str, BitStream *bs, uint8_t languageId=0, bool writeLanguageId=false); + + /// Deserialize what was written by Serialize + /// \param[in] bs Bitstream to serialize from + /// \return true if the deserialization was successful + bool Deserialize(BitStream *bs); + + /// Static version of the Deserialize() function + static bool Deserialize(char *str, BitStream *bs); + + /// Deserialize compressed string, written by SerializeCompressed + /// \param[in] bs Bitstream to serialize from + /// \param[in] readLanguageId If true, looks for the variable langaugeId in the data stream. Must match what was passed to SerializeCompressed + /// \return true if the deserialization was successful + /// \pre StringCompressor::AddReference must have been called to instantiate the class (Happens automatically from RakPeer::Startup()) + bool DeserializeCompressed(BitStream *bs, bool readLanguageId=false); + + /// Static version of the DeserializeCompressed() function + static bool DeserializeCompressed(char *str, BitStream *bs, bool readLanguageId=false); + + static const char *ToString(int64_t i); + static const char *ToString(uint64_t i); + + /// \internal + static size_t GetSizeToAllocate(size_t bytes) + { + const size_t smallStringSize = 128-sizeof(unsigned int)-sizeof(size_t)-sizeof(char*)*2; + if (bytes<=smallStringSize) + return smallStringSize; + else + return bytes*2; + } + + /// \internal + struct SharedString + { + SimpleMutex *refCountMutex; + unsigned int refCount; + size_t bytesUsed; + char *bigString; + char *c_str; + char smallString[128-sizeof(unsigned int)-sizeof(size_t)-sizeof(char*)*2]; + }; + + /// \internal + RakString( SharedString *_sharedString ); + + /// \internal + SharedString *sharedString; + +// static SimpleMutex poolMutex; +// static DataStructures::MemoryPool pool; + /// \internal + static SharedString emptyString; + + //static SharedString *sharedStringFreeList; + //static unsigned int sharedStringFreeListAllocationCount; + /// \internal + /// List of free objects to reduce memory reallocations + static DataStructures::List freeList; + + static int RakStringComp( RakString const &key, RakString const &data ); + + static void LockMutex(void); + static void UnlockMutex(void); + +protected: + static RakNet::RakString FormatForPUTOrPost(const char* type, const char* uri, const char* contentType, const char* body, const char* extraHeaders); + void Allocate(size_t len); + void Assign(const char *str); + void Assign(const char *str, va_list ap); + + void Clone(void); + void Free(void); + unsigned char ToLower(unsigned char c); + unsigned char ToUpper(unsigned char c); + void Realloc(SharedString *sharedString, size_t bytes); +}; + +} + +const RakNet::RakString RAK_DLL_EXPORT operator+(const RakNet::RakString &lhs, const RakNet::RakString &rhs); + + +#endif diff --git a/include/raknet/RakThread.hpp b/include/raknet/RakThread.hpp new file mode 100644 index 0000000..3387dbe --- /dev/null +++ b/include/raknet/RakThread.hpp @@ -0,0 +1,106 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAK_THREAD_H +#define __RAK_THREAD_H + +#if defined(_WIN32_WCE) +#include "WindowsIncludes.hpp" +#endif + + + + + +#include "Export.hpp" + + + + + + +#if defined(WINDOWS_PHONE_8) || defined(WINDOWS_STORE_RT) +#include "../DependentExtensions/WinPhone8/ThreadEmulation.hpp" +using namespace ThreadEmulation; +#endif + +namespace RakNet +{ +/// To define a thread, use RAK_THREAD_DECLARATION(functionName); +#if defined(_WIN32_WCE) || defined(WINDOWS_PHONE_8) || defined(WINDOWS_STORE_RT) +#define RAK_THREAD_DECLARATION(functionName) DWORD WINAPI functionName(LPVOID arguments) + + +#elif defined(_WIN32) +#define RAK_THREAD_DECLARATION(functionName) unsigned __stdcall functionName( void* arguments ) + + +#else +#define RAK_THREAD_DECLARATION(functionName) void* functionName( void* arguments ) +#endif + +class RAK_DLL_EXPORT RakThread +{ +public: + + + + + /// Create a thread, simplified to be cross platform without all the extra junk + /// To then start that thread, call RakCreateThread(functionName, arguments); + /// \param[in] start_address Function you want to call + /// \param[in] arglist Arguments to pass to the function + /// \return 0=success. >0 = error code + + /* + nice value Win32 Priority + -20 to -16 THREAD_PRIORITY_HIGHEST + -15 to -6 THREAD_PRIORITY_ABOVE_NORMAL + -5 to +4 THREAD_PRIORITY_NORMAL + +5 to +14 THREAD_PRIORITY_BELOW_NORMAL + +15 to +19 THREAD_PRIORITY_LOWEST + */ +#if defined(_WIN32_WCE) || defined(WINDOWS_PHONE_8) || defined(WINDOWS_STORE_RT) + static int Create( LPTHREAD_START_ROUTINE start_address, void *arglist, int priority=0); + + +#elif defined(_WIN32) + static int Create( unsigned __stdcall start_address( void* ), void *arglist, int priority=0); + + + +#else + static int Create( void* start_address( void* ), void *arglist, int priority=0); +#endif + + + + + + + + + + + + + + + + + + + + +}; + +} + +#endif diff --git a/include/raknet/RakWString.hpp b/include/raknet/RakWString.hpp new file mode 100644 index 0000000..29380f0 --- /dev/null +++ b/include/raknet/RakWString.hpp @@ -0,0 +1,123 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __RAK_W_STRING_H +#define __RAK_W_STRING_H + +#include "Export.hpp" +#include "RakNetTypes.hpp" // int64_t +#include "RakString.hpp" + +#ifdef _WIN32 + + + +#include "WindowsIncludes.hpp" +#endif + +namespace RakNet +{ + /// \brief String class for Unicode + class RAK_DLL_EXPORT RakWString + { + public: + // Constructors + RakWString(); + RakWString( const RakString &right ); + RakWString( const wchar_t *input ); + RakWString( const RakWString & right); + RakWString( const char *input ); + ~RakWString(); + + /// Implicit return of wchar_t* + operator wchar_t* () const {if (c_str) return c_str; return (wchar_t*) L"";} + + /// Same as std::string::c_str + const wchar_t* C_String(void) const {if (c_str) return c_str; return (const wchar_t*) L"";} + + /// Assignment operators + RakWString& operator = ( const RakWString& right ); + RakWString& operator = ( const RakString& right ); + RakWString& operator = ( const wchar_t * const str ); + RakWString& operator = ( wchar_t *str ); + RakWString& operator = ( const char * const str ); + RakWString& operator = ( char *str ); + + /// Concatenation + RakWString& operator +=( const RakWString& right); + RakWString& operator += ( const wchar_t * const right ); + RakWString& operator += ( wchar_t *right ); + + /// Equality + bool operator==(const RakWString &right) const; + + // Comparison + bool operator < ( const RakWString& right ) const; + bool operator <= ( const RakWString& right ) const; + bool operator > ( const RakWString& right ) const; + bool operator >= ( const RakWString& right ) const; + + /// Inequality + bool operator!=(const RakWString &right) const; + + /// Set the value of the string + void Set( wchar_t *str ); + + /// Returns if the string is empty. Also, C_String() would return "" + bool IsEmpty(void) const; + + /// Returns the length of the string + size_t GetLength(void) const; + + /// Has the string into an unsigned int + static unsigned long ToInteger(const RakWString &rs); + + /// Compare strings (case sensitive) + int StrCmp(const RakWString &right) const; + + /// Compare strings (not case sensitive) + int StrICmp(const RakWString &right) const; + + /// Clear the string + void Clear(void); + + /// Print the string to the screen + void Printf(void); + + /// Print the string to a file + void FPrintf(FILE *fp); + + /// Serialize to a bitstream, uncompressed (slightly faster) + /// \param[out] bs Bitstream to serialize to + void Serialize(BitStream *bs) const; + + /// Static version of the Serialize function + static void Serialize(const wchar_t * const str, BitStream *bs); + + /// Deserialize what was written by Serialize + /// \param[in] bs Bitstream to serialize from + /// \return true if the deserialization was successful + bool Deserialize(BitStream *bs); + + /// Static version of the Deserialize() function + static bool Deserialize(wchar_t *str, BitStream *bs); + + + protected: + wchar_t* c_str; + size_t c_strCharLength; + }; + +} + +const RakNet::RakWString RAK_DLL_EXPORT operator+(const RakNet::RakWString &lhs, const RakNet::RakWString &rhs); + + +#endif diff --git a/include/raknet/Rand.hpp b/include/raknet/Rand.hpp new file mode 100644 index 0000000..884e0ec --- /dev/null +++ b/include/raknet/Rand.hpp @@ -0,0 +1,67 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] Random number generator +/// + + + +#ifndef __RAND_H +#define __RAND_H + +#include "Export.hpp" + +/// Initialise seed for Random Generator +/// \note not threadSafe, use an instance of RakNetRandom if necessary per thread +/// \param[in] seed The seed value for the random number generator. +extern void RAK_DLL_EXPORT seedMT( unsigned int seed ); + +/// \internal +/// \note not threadSafe, use an instance of RakNetRandom if necessary per thread +extern unsigned int RAK_DLL_EXPORT reloadMT( void ); + +/// Gets a random unsigned int +/// \note not threadSafe, use an instance of RakNetRandom if necessary per thread +/// \return an integer random value. +extern unsigned int RAK_DLL_EXPORT randomMT( void ); + +/// Gets a random float +/// \note not threadSafe, use an instance of RakNetRandom if necessary per thread +/// \return 0 to 1.0f, inclusive +extern float RAK_DLL_EXPORT frandomMT( void ); + +/// Randomizes a buffer +/// \note not threadSafe, use an instance of RakNetRandom if necessary per thread +extern void RAK_DLL_EXPORT fillBufferMT( void *buffer, unsigned int bytes ); + +namespace RakNet { + +// Same thing as above functions, but not global +class RAK_DLL_EXPORT RakNetRandom +{ +public: + RakNetRandom(); + ~RakNetRandom(); + void SeedMT( unsigned int seed ); + unsigned int ReloadMT( void ); + unsigned int RandomMT( void ); + float FrandomMT( void ); + void FillBufferMT( void *buffer, unsigned int bytes ); + +protected: + unsigned int state[ 624 + 1 ]; + unsigned int *next; + int left; +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/RandSync.hpp b/include/raknet/RandSync.hpp new file mode 100644 index 0000000..2a0c77a --- /dev/null +++ b/include/raknet/RandSync.hpp @@ -0,0 +1,58 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] Random number generator +/// + + + +#ifndef __RAND_SYNC_H +#define __RAND_SYNC_H + +#include "Export.hpp" +#include "Rand.hpp" +#include "DS_Queue.hpp" +#include "NativeTypes.hpp" + +namespace RakNet { + +class BitStream; + +class RAK_DLL_EXPORT RakNetRandomSync +{ +public: + RakNetRandomSync(); + virtual ~RakNetRandomSync(); + void SeedMT( uint32_t _seed ); + void SeedMT( uint32_t _seed, uint32_t skipValues ); + float FrandomMT( void ); + unsigned int RandomMT( void ); + uint32_t GetSeed( void ) const; + uint32_t GetCallCount( void ) const; + void SetCallCount( uint32_t i ); + + virtual void SerializeConstruction(RakNet::BitStream *constructionBitstream); + virtual bool DeserializeConstruction(RakNet::BitStream *constructionBitstream); + virtual void Serialize(RakNet::BitStream *outputBitstream); + virtual void Deserialize(RakNet::BitStream *outputBitstream); + +protected: + void Skip( uint32_t count ); + DataStructures::Queue usedValues; + uint32_t seed; + uint32_t callCount; + uint32_t usedValueBufferCount; + RakNetRandom rnr; +}; +} // namespace RakNet + + +#endif diff --git a/include/raknet/ReadyEvent.hpp b/include/raknet/ReadyEvent.hpp new file mode 100644 index 0000000..e4cb243 --- /dev/null +++ b/include/raknet/ReadyEvent.hpp @@ -0,0 +1,242 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Ready event plugin. This enables a set of systems to create a signal event, set this signal as ready or unready, and to trigger the event when all systems are ready +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_ReadyEvent==1 + +#ifndef __READY_EVENT_H +#define __READY_EVENT_H + +#include "PluginInterface2.hpp" +#include "DS_OrderedList.hpp" + +namespace RakNet { + +class RakPeerInterface; + +/// \defgroup READY_EVENT_GROUP ReadyEvent +/// \brief Peer to peer synchronized ready and unready events +/// \details +/// \ingroup PLUGINS_GROUP + +/// \ingroup READY_EVENT_GROUP +/// Returns the status of a remote system when querying with ReadyEvent::GetReadyStatus +enum ReadyEventSystemStatus +{ + /// ----------- Normal states --------------- + /// The remote system is not in the wait list, and we have never gotten a ready or complete message from it. + /// This is the default state for valid events + RES_NOT_WAITING, + /// We are waiting for this remote system to call SetEvent(thisEvent,true). + RES_WAITING, + /// The remote system called SetEvent(thisEvent,true), but it still waiting for other systems before completing the ReadyEvent. + RES_READY, + /// The remote system called SetEvent(thisEvent,true), and is no longer waiting for any other systems. + /// This remote system has completed the ReadyEvent + RES_ALL_READY, + + /// Error code, we couldn't look up the system because the event was unknown + RES_UNKNOWN_EVENT, +}; + +/// \brief Peer to peer synchronized ready and unready events +/// \details For peer to peer networks in a fully connected mesh.
+/// Solves the problem of how to tell if all peers, relative to all other peers, are in a certain ready state.
+/// For example, if A is connected to B and C, A may see that B and C are ready, but does not know if B is ready to C, or vice-versa.
+/// This plugin uses two stages to solve that problem, first, everyone I know about is ready. Second, everyone I know about is ready to everyone they know about.
+/// The user will get ID_READY_EVENT_SET and ID_READY_EVENT_UNSET as the signal flag is set or unset
+/// The user will get ID_READY_EVENT_ALL_SET when all systems are done waiting for all other systems, in which case the event is considered complete, and no longer tracked.
+/// \sa FullyConnectedMesh2 +/// \ingroup READY_EVENT_GROUP +class ReadyEvent : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(ReadyEvent) + + // Constructor + ReadyEvent(); + + // Destructor + virtual ~ReadyEvent(); + + // -------------------------------------------------------------------------------------------- + // User functions + // -------------------------------------------------------------------------------------------- + /// Sets or updates the initial ready state for our local system. + /// If eventId is an unknown event the event is created. + /// If eventId was previously used and you want to reuse it, call DeleteEvent first, or else you will keep the same event signals from before + /// Systems previously or later added through AddToWaitList() with the same \a eventId when isReady=true will get ID_READY_EVENT_SET + /// Systems previously added through AddToWaitList with the same \a eventId will get ID_READY_EVENT_UNSET + /// For both ID_READY_EVENT_SET and ID_READY_EVENT_UNSET, eventId is encoded in bytes 1 through 1+sizeof(int) + /// \param[in] eventId A user-defined identifier to wait on. This can be a sequence counter, an event identifier, or anything else you want. + /// \param[in] isReady True to signal we are ready to proceed with this event, false to unsignal + /// \return False if event status is ID_READY_EVENT_FORCE_ALL_SET, or if we are setting to a status we are already in (no change). Otherwise true + bool SetEvent(int eventId, bool isReady); + + /// When systems can call SetEvent() with isReady==false, it is possible for one system to return true from IsEventCompleted() while the other systems return false + /// This can occur if a system SetEvent() with isReady==false while the completion message is still being transmitted. + /// If your game has the situation where some action should be taken on all systems when IsEventCompleted() is true for any system, then call ForceCompletion() when the action begins. + /// This will force all systems to return true from IsEventCompleted(). + /// \param[in] eventId A user-defined identifier to immediately set as completed + void ForceCompletion(int eventId); + + /// Deletes an event. We will no longer wait for this event, and any systems that we know have set the event will be forgotten. + /// Call this to clear memory when events are completed and you know you will never need them again. + /// \param[in] eventId A user-defined identifier + /// \return True on success. False (failure) on unknown eventId + bool DeleteEvent(int eventId); + + /// Returns what was passed to SetEvent() + /// \return The value of isReady passed to SetEvent(). Also returns false on unknown event. + bool IsEventSet(int eventId); + + /// Returns if the event is about to be ready and we are negotiating the final packets. + /// This will usually only be true for a very short time, after which IsEventCompleted should return true. + /// While this is true you cannot add to the wait list, or SetEvent() isReady to false anymore. + /// \param[in] eventId A user-defined identifier + /// \return True if any other system has completed processing. Will always be true if IsEventCompleted() is true + bool IsEventCompletionProcessing(int eventId) const; + + /// Returns if the wait list is a subset of the completion list. + /// Call this after all systems you want to wait for have been added with AddToWaitList + /// If you are waiting for a specific number of systems (such as players later connecting), also check GetRemoteWaitListSize(eventId) to be equal to 1 less than the total number of participants. + /// \param[in] eventId A user-defined identifier + /// \return True on completion. False (failure) on unknown eventId, or the set is not completed. + bool IsEventCompleted(int eventId) const; + + /// Returns if this is a known event. + /// Events may be known even if we never ourselves referenced them with SetEvent, because other systems created them via ID_READY_EVENT_SET. + /// \param[in] eventId A user-defined identifier + /// \return true if we have this event, false otherwise + bool HasEvent(int eventId); + + /// Returns the total number of events stored in the system. + /// \return The total number of events stored in the system. + unsigned GetEventListSize(void) const; + + /// Returns the event ID stored at a particular index. EventIDs are stored sorted from least to greatest. + /// \param[in] index Index into the array, from 0 to GetEventListSize() + /// \return The event ID stored at a particular index + int GetEventAtIndex(unsigned index) const; + + /// Adds a system to wait for to signal an event before considering the event complete and returning ID_READY_EVENT_ALL_SET. + /// As we add systems, if this event was previously set to true with SetEvent, these systems will get ID_READY_EVENT_SET. + /// As these systems disconnect (directly or indirectly through the router) they are removed. + /// \note If the event completion process has already started, you cannot add more systems, as this would cause the completion process to fail + /// \param[in] eventId A user-defined number previously passed to SetEvent that has not yet completed + /// \param[in] guid An address to wait for event replies from. Pass UNASSIGNED_SYSTEM_ADDRESS for all currently connected systems. Until all systems in this list have called SetEvent with this ID and true, and have this system in the list, we won't get ID_READY_EVENT_COMPLETE + /// \return True on success, false on unknown eventId (this should be considered an error) + bool AddToWaitList(int eventId, RakNetGUID guid); + + /// Removes systems from the wait list, which should have been previously added with AddToWaitList + /// \note Systems that directly or indirectly disconnect from us are automatically removed from the wait list + /// \param[in] guid The system to remove from the wait list. Pass UNASSIGNED_RAKNET_GUID for all currently connected systems. + /// \return True on success, false on unknown eventId (this should be considered an error) + bool RemoveFromWaitList(int eventId, RakNetGUID guid); + + /// Returns if a particular system is waiting on a particular event. + /// \param[in] eventId A user-defined identifier + /// \param[in] guid The system we are checking up on + /// \return True if this system is waiting on this event, false otherwise. + bool IsInWaitList(int eventId, RakNetGUID guid); + + /// Returns the total number of systems we are waiting on for this event. + /// Does not include yourself + /// \param[in] eventId A user-defined identifier + /// \return The total number of systems we are waiting on for this event. + unsigned GetRemoteWaitListSize(int eventId) const; + + /// Returns the system address of a system at a particular index, for this event. + /// \param[in] eventId A user-defined identifier + /// \param[in] index Index into the array, from 0 to GetWaitListSize() + /// \return The system address of a system at a particular index, for this event. + RakNetGUID GetFromWaitListAtIndex(int eventId, unsigned index) const; + + /// For a remote system, find out what their ready status is (waiting, signaled, complete). + /// \param[in] eventId A user-defined identifier + /// \param[in] guid Which system we are checking up on + /// \return The status of this system, for this particular event. \sa ReadyEventSystemStatus + ReadyEventSystemStatus GetReadyStatus(int eventId, RakNetGUID guid); + + /// This channel will be used for all RakPeer::Send calls + /// \param[in] newChannel The channel to use for internal RakPeer::Send calls from this system. Defaults to 0. + void SetSendChannel(unsigned char newChannel); + + // ---------------------------- ALL INTERNAL AFTER HERE ---------------------------- + /// \internal + /// Status of a remote system + struct RemoteSystem + { + MessageID lastSentStatus, lastReceivedStatus; + RakNetGUID rakNetGuid; + }; + static int RemoteSystemCompByGuid( const RakNetGUID &key, const RemoteSystem &data ); + /// \internal + /// An event, with a set of systems we are waiting for, a set of systems that are signaled, and a set of systems with completed events + struct ReadyEventNode + { + int eventId; // Sorted on this + MessageID eventStatus; + DataStructures::OrderedList systemList; + }; + static int ReadyEventNodeComp( const int &key, ReadyEvent::ReadyEventNode * const &data ); + + +protected: + // -------------------------------------------------------------------------------------------- + // Packet handling functions + // -------------------------------------------------------------------------------------------- + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnRakPeerShutdown(void); + + void Clear(void); + /* + bool AnyWaitersCompleted(unsigned eventIndex) const; + bool AllWaitersCompleted(unsigned eventIndex) const; + bool AllWaitersReady(unsigned eventIndex) const; + void SendAllReady(unsigned eventId, RakNetGUID guid); + void BroadcastAllReady(unsigned eventIndex); + void SendReadyStateQuery(unsigned eventId, RakNetGUID guid); + void BroadcastReadyUpdate(unsigned eventIndex); + bool AddToWaitListInternal(unsigned eventIndex, RakNetGUID guid); + bool IsLocked(unsigned eventIndex) const; + bool IsAllReadyByIndex(unsigned eventIndex) const; + */ + + void SendReadyStateQuery(unsigned eventId, RakNetGUID guid); + void SendReadyUpdate(unsigned eventIndex, unsigned systemIndex, bool forceIfNotDefault); + void BroadcastReadyUpdate(unsigned eventIndex, bool forceIfNotDefault); + void RemoveFromAllLists(RakNetGUID guid); + void OnReadyEventQuery(Packet *packet); + void PushCompletionPacket(unsigned eventId); + bool AddToWaitListInternal(unsigned eventIndex, RakNetGUID guid); + void OnReadyEventForceAllSet(Packet *packet); + void OnReadyEventPacketUpdate(Packet *packet); + void UpdateReadyStatus(unsigned eventIndex); + bool IsEventCompletedByIndex(unsigned eventIndex) const; + unsigned CreateNewEvent(int eventId, bool isReady); + bool SetEventByIndex(int eventIndex, bool isReady); + + DataStructures::OrderedList readyEventNodeList; + unsigned char channel; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/RefCountedObj.hpp b/include/raknet/RefCountedObj.hpp new file mode 100644 index 0000000..7bedd09 --- /dev/null +++ b/include/raknet/RefCountedObj.hpp @@ -0,0 +1,33 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b Reference counted object. Very simple class for quick and dirty uses. +/// + + + +#ifndef __REF_COUNTED_OBJ_H +#define __REF_COUNTED_OBJ_H + +#include "RakMemoryOverride.hpp" + +/// World's simplest class :) +class RefCountedObj +{ + public: + RefCountedObj() {refCount=1;} + virtual ~RefCountedObj() {} + void AddRef(void) {refCount++;} + void Deref(void) {if (--refCount==0) RakNet::OP_DELETE(this, _FILE_AND_LINE_);} + int refCount; +}; + +#endif diff --git a/include/raknet/RelayPlugin.hpp b/include/raknet/RelayPlugin.hpp new file mode 100644 index 0000000..4de271f --- /dev/null +++ b/include/raknet/RelayPlugin.hpp @@ -0,0 +1,166 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains the class RelayPlugin +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_RelayPlugin==1 + +#ifndef __RELAY_PLUGIN_H +#define __RELAY_PLUGIN_H + +#include "PluginInterface2.hpp" +#include "RakString.hpp" +#include "DS_Hash.hpp" + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +/// \defgroup RELAY_PLUGIN_GROUP RelayPlugin +/// \brief A simple class to relay messages from one system to another through an intermediary +/// \ingroup PLUGINS_GROUP + +namespace RakNet +{ + +/// Forward declarations +class RakPeerInterface; + +enum RelayPluginEnums +{ + // Server handled messages + RPE_MESSAGE_TO_SERVER_FROM_CLIENT, + RPE_ADD_CLIENT_REQUEST_FROM_CLIENT, + RPE_REMOVE_CLIENT_REQUEST_FROM_CLIENT, + RPE_GROUP_MESSAGE_FROM_CLIENT, + RPE_JOIN_GROUP_REQUEST_FROM_CLIENT, + RPE_LEAVE_GROUP_REQUEST_FROM_CLIENT, + RPE_GET_GROUP_LIST_REQUEST_FROM_CLIENT, + // Client handled messages + RPE_MESSAGE_TO_CLIENT_FROM_SERVER, + RPE_ADD_CLIENT_NOT_ALLOWED, + RPE_ADD_CLIENT_TARGET_NOT_CONNECTED, + RPE_ADD_CLIENT_NAME_ALREADY_IN_USE, + RPE_ADD_CLIENT_SUCCESS, + RPE_USER_ENTERED_ROOM, + RPE_USER_LEFT_ROOM, + RPE_GROUP_MSG_FROM_SERVER, + RPE_GET_GROUP_LIST_REPLY_FROM_SERVER, + RPE_JOIN_GROUP_SUCCESS, + RPE_JOIN_GROUP_FAILURE, +}; + +/// \brief A simple class to relay messages from one system to another, identifying remote systems by a string. +/// \ingroup RELAY_PLUGIN_GROUP +class RAK_DLL_EXPORT RelayPlugin : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(RelayPlugin) + + /// Constructor + RelayPlugin(); + + /// Destructor + virtual ~RelayPlugin(); + + /// \brief Forward messages from any system, to the system specified by the combination of key and guid. The sending system only needs to know the key. + /// \param[in] key A string to identify the target's RakNetGUID. This is so the sending system does not need to know the RakNetGUID of the target system. The key should be unique among all guids added. If the key is not unique, only one system will be sent to (at random). + /// \param[in] guid The RakNetGuid of the system to send to. If this system disconnects, it is removed from the internal hash + /// \return RPE_ADD_CLIENT_TARGET_NOT_CONNECTED, RPE_ADD_CLIENT_NAME_ALREADY_IN_USE, or RPE_ADD_CLIENT_OK + RelayPluginEnums AddParticipantOnServer(const RakString &key, const RakNetGUID &guid); + + /// \brief Remove a chat participant + void RemoveParticipantOnServer(const RakNetGUID &guid); + + /// \brief If true, then if the client calls AddParticipantRequestFromClient(), the server will call AddParticipantOnServer() automatically + /// Defaults to false + /// \param[in] accept true to accept, false to not. + void SetAcceptAddParticipantRequests(bool accept); + + /// \brief Request from the client for the server to call AddParticipantOnServer() + /// \pre The server must have called SetAcceptAddParticipantRequests(true) or the request will be ignored + /// \param[in] key A string to identify out system. Passed to \a key on AddParticipantOnServer() + /// \param[in] relayPluginServerGuid the RakNetGUID of the system running RelayPlugin + void AddParticipantRequestFromClient(const RakString &key, const RakNetGUID &relayPluginServerGuid); + + /// \brief Remove yourself as a participant + void RemoveParticipantRequestFromClient(const RakNetGUID &relayPluginServerGuid); + + /// \brief Request that the server relay \a bitStream to the system designated by \a key + /// \param[in] relayPluginServerGuid the RakNetGUID of the system running RelayPlugin + /// \param[in] destinationGuid The key value passed to AddParticipant() earlier on the server. If this was not done, the server will not relay the message (it will be silently discarded). + /// \param[in] bitStream The data to relay + /// \param[in] priority See the parameter of the same name in RakPeerInterface::Send() + /// \param[in] reliability See the parameter of the same name in RakPeerInterface::Send() + /// \param[in] orderingChannel See the parameter of the same name in RakPeerInterface::Send() + void SendToParticipant(const RakNetGUID &relayPluginServerGuid, const RakString &destinationGuid, BitStream *bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel); + + void SendGroupMessage(const RakNetGUID &relayPluginServerGuid, BitStream *bitStream, PacketPriority priority, PacketReliability reliability, char orderingChannel); + void JoinGroupRequest(const RakNetGUID &relayPluginServerGuid, RakString groupName); + void LeaveGroup(const RakNetGUID &relayPluginServerGuid); + void GetGroupList(const RakNetGUID &relayPluginServerGuid); + + /// \internal + virtual PluginReceiveResult OnReceive(Packet *packet); + /// \internal + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + + struct StrAndGuidAndRoom + { + RakString str; + RakNetGUID guid; + RakString currentRoom; + }; + + struct StrAndGuid + { + RakString str; + RakNetGUID guid; + }; + + struct RP_Group + { + RakString roomName; + DataStructures::List usersInRoom; + }; + +protected: + + RelayPlugin::RP_Group* JoinGroup(RakNetGUID userGuid, RakString roomName); + RelayPlugin::RP_Group* JoinGroup(RP_Group* room, StrAndGuidAndRoom **strAndGuidSender); + void LeaveGroup(StrAndGuidAndRoom **strAndGuidSender); + void NotifyUsersInRoom(RP_Group *room, int msg, const RakString& message); + void SendMessageToRoom(StrAndGuidAndRoom **strAndGuidSender, BitStream* message); + void SendChatRoomsList(RakNetGUID target); + void OnGroupMessageFromClient(Packet *packet); + void OnJoinGroupRequestFromClient(Packet *packet); + void OnLeaveGroupRequestFromClient(Packet *packet); + + DataStructures::Hash strToGuidHash; + DataStructures::Hash guidToStrHash; + DataStructures::List chatRooms; + bool acceptAddParticipantRequests; + +}; + +} // End namespace + +#endif + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/ReliabilityLayer.hpp b/include/raknet/ReliabilityLayer.hpp new file mode 100644 index 0000000..651f673 --- /dev/null +++ b/include/raknet/ReliabilityLayer.hpp @@ -0,0 +1,596 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] Datagram reliable, ordered, unordered and sequenced sends. Flow control. Message splitting, reassembly, and coalescence. +/// + + +#ifndef __RELIABILITY_LAYER_H +#define __RELIABILITY_LAYER_H + +#include "RakMemoryOverride.hpp" +#include "MTUSize.hpp" +#include "DS_LinkedList.hpp" +#include "DS_List.hpp" +#include "SocketLayer.hpp" +#include "PacketPriority.hpp" +#include "DS_Queue.hpp" +#include "BitStream.hpp" +#include "InternalPacket.hpp" +#include "RakNetStatistics.hpp" +#include "DR_SHA1.hpp" +#include "DS_OrderedList.hpp" +#include "DS_RangeList.hpp" +#include "DS_BPlusTree.hpp" +#include "DS_MemoryPool.hpp" +#include "RakNetDefines.hpp" +#include "DS_Heap.hpp" +#include "BitStream.hpp" +#include "NativeFeatureIncludes.hpp" +#include "SecureHandshake.hpp" +#include "PluginInterface2.hpp" +#include "Rand.hpp" +#include "RakNetSocket2.hpp" + +#if USE_SLIDING_WINDOW_CONGESTION_CONTROL!=1 +#include "CCRakNetUDT.hpp" +#define INCLUDE_TIMESTAMP_WITH_DATAGRAMS 1 +#else +#include "CCRakNetSlidingWindow.hpp" +#define INCLUDE_TIMESTAMP_WITH_DATAGRAMS 0 +#endif + +/// Number of ordered streams available. You can use up to 32 ordered streams +#define NUMBER_OF_ORDERED_STREAMS 32 // 2^5 + +#define RESEND_TREE_ORDER 32 + +namespace RakNet { + + /// Forward declarations +class PluginInterface2; +class RakNetRandom; +typedef uint64_t reliabilityHeapWeightType; + +// int SplitPacketIndexComp( SplitPacketIndexType const &key, InternalPacket* const &data ); +struct SplitPacketChannel// +{ + CCTimeType lastUpdateTime; + + DataStructures::List splitPacketList; + +#if PREALLOCATE_LARGE_MESSAGES==1 + InternalPacket *returnedPacket; + bool gotFirstPacket; + unsigned int stride; + unsigned int splitPacketsArrived; +#else + // This is here for progress notifications, since progress notifications return the first packet data, if available + InternalPacket *firstPacket; +#endif + +}; +int RAK_DLL_EXPORT SplitPacketChannelComp( SplitPacketIdType const &key, SplitPacketChannel* const &data ); + +// Helper class +struct BPSTracker +{ + BPSTracker(); + ~BPSTracker(); + void Reset(const char *file, unsigned int line); + inline void Push1(CCTimeType time, uint64_t value1) {dataQueue.Push(TimeAndValue2(time,value1),_FILE_AND_LINE_); total1+=value1; lastSec1+=value1;} +// void Push2(RakNet::TimeUS time, uint64_t value1, uint64_t value2); + inline uint64_t GetBPS1(CCTimeType time) {(void) time; return lastSec1;} + inline uint64_t GetBPS1Threadsafe(CCTimeType time) {(void) time; return lastSec1;} +// uint64_t GetBPS2(RakNetTimeUS time); +// void GetBPS1And2(RakNetTimeUS time, uint64_t &out1, uint64_t &out2); + uint64_t GetTotal1(void) const; +// uint64_t GetTotal2(void) const; + + struct TimeAndValue2 + { + TimeAndValue2(); + ~TimeAndValue2(); + TimeAndValue2(CCTimeType t, uint64_t v1); + // TimeAndValue2(RakNet::TimeUS t, uint64_t v1, uint64_t v2); + // uint64_t value1, value2; + uint64_t value1; + CCTimeType time; + }; + + uint64_t total1, lastSec1; +// uint64_t total2, lastSec2; + DataStructures::Queue dataQueue; + void ClearExpired1(CCTimeType time); +// void ClearExpired2(RakNet::TimeUS time); +}; + +/// Datagram reliable, ordered, unordered and sequenced sends. Flow control. Message splitting, reassembly, and coalescence. +class ReliabilityLayer// +{ +public: + + // Constructor + ReliabilityLayer(); + + // Destructor + ~ReliabilityLayer(); + + /// Resets the layer for reuse + void Reset( bool resetVariables, int MTUSize, bool _useSecurity ); + + /// Set the time, in MS, to use before considering ourselves disconnected after not being able to deliver a reliable packet + /// Default time is 10,000 or 10 seconds in release and 30,000 or 30 seconds in debug. + /// \param[in] time Time, in MS + void SetTimeoutTime( RakNet::TimeMS time ); + + /// Returns the value passed to SetTimeoutTime. or the default if it was never called + /// \param[out] the value passed to SetTimeoutTime + RakNet::TimeMS GetTimeoutTime(void); + + /// Packets are read directly from the socket layer and skip the reliability layer because unconnected players do not use the reliability layer + /// This function takes packet data after a player has been confirmed as connected. + /// \param[in] buffer The socket data + /// \param[in] length The length of the socket data + /// \param[in] systemAddress The player that this data is from + /// \param[in] messageHandlerList A list of registered plugins + /// \param[in] MTUSize maximum datagram size + /// \retval true Success + /// \retval false Modified packet + bool HandleSocketReceiveFromConnectedPlayer( + const char *buffer, unsigned int length, SystemAddress &systemAddress, DataStructures::List &messageHandlerList, int MTUSize, + RakNetSocket2 *s, RakNetRandom *rnr, CCTimeType timeRead, BitStream &updateBitStream); + + /// This allocates bytes and writes a user-level message to those bytes. + /// \param[out] data The message + /// \return Returns number of BITS put into the buffer + BitSize_t Receive( unsigned char**data ); + + /// Puts data on the send queue + /// \param[in] data The data to send + /// \param[in] numberOfBitsToSend The length of \a data in bits + /// \param[in] priority The priority level for the send + /// \param[in] reliability The reliability type for the send + /// \param[in] orderingChannel 0 to 31. Specifies what channel to use, for relational ordering and sequencing of packets. + /// \param[in] makeDataCopy If true \a data will be copied. Otherwise, only a pointer will be stored. + /// \param[in] MTUSize maximum datagram size + /// \param[in] currentTime Current time, as per RakNet::GetTimeMS() + /// \param[in] receipt This number will be returned back with ID_SND_RECEIPT_ACKED or ID_SND_RECEIPT_LOSS and is only returned with the reliability types that contain RECEIPT in the name + /// \return True or false for success or failure. + bool Send( char *data, BitSize_t numberOfBitsToSend, PacketPriority priority, PacketReliability reliability, unsigned char orderingChannel, bool makeDataCopy, int MTUSize, CCTimeType currentTime, uint32_t receipt ); + + /// Call once per game cycle. Handles internal lists and actually does the send. + /// \param[in] s the communication end point + /// \param[in] systemAddress The Unique Player Identifier who shouldhave sent some packets + /// \param[in] MTUSize maximum datagram size + /// \param[in] time current system time + /// \param[in] maxBitsPerSecond if non-zero, enforces that outgoing bandwidth does not exceed this amount + /// \param[in] messageHandlerList A list of registered plugins + void Update( RakNetSocket2 *s, SystemAddress &systemAddress, int MTUSize, CCTimeType time, + unsigned bitsPerSecondLimit, + DataStructures::List &messageHandlerList, + RakNetRandom *rnr, BitStream &updateBitStream); + + /// Were you ever unable to deliver a packet despite retries? + /// \return true means the connection has been lost. Otherwise not. + bool IsDeadConnection( void ) const; + + /// Causes IsDeadConnection to return true + void KillConnection(void); + + /// Get Statistics + /// \return A pointer to a static struct, filled out with current statistical information. + RakNetStatistics * GetStatistics( RakNetStatistics *rns ); + + ///Are we waiting for any data to be sent out or be processed by the player? + bool IsOutgoingDataWaiting(void); + bool AreAcksWaiting(void); + + // Set outgoing lag and packet loss properties + void ApplyNetworkSimulator( double _maxSendBPS, RakNet::TimeMS _minExtraPing, RakNet::TimeMS _extraPingVariance ); + + /// Returns if you previously called ApplyNetworkSimulator + /// \return If you previously called ApplyNetworkSimulator + bool IsNetworkSimulatorActive( void ); + + void SetSplitMessageProgressInterval(int interval); + void SetUnreliableTimeout(RakNet::TimeMS timeoutMS); + /// Has a lot of time passed since the last ack + bool AckTimeout(RakNet::Time curTime); + CCTimeType GetNextSendTime(void) const; + CCTimeType GetTimeBetweenPackets(void) const; +#if INCLUDE_TIMESTAMP_WITH_DATAGRAMS==1 + CCTimeType GetAckPing(void) const; +#endif + RakNet::TimeMS GetTimeLastDatagramArrived(void) const {return timeLastDatagramArrived;} + + // If true, will update time between packets quickly based on ping calculations + //void SetDoFastThroughputReactions(bool fast); + + // Encoded as numMessages[unsigned int], message1BitLength[unsigned int], message1Data (aligned), ... + //void GetUndeliveredMessages(RakNet::BitStream *messages, int MTUSize); + +private: + /// Send the contents of a bitstream to the socket + /// \param[in] s The socket used for sending data + /// \param[in] systemAddress The address and port to send to + /// \param[in] bitStream The data to send. + void SendBitStream( RakNetSocket2 *s, SystemAddress &systemAddress, RakNet::BitStream *bitStream, RakNetRandom *rnr, CCTimeType currentTime); + + ///Parse an internalPacket and create a bitstream to represent this data + /// \return Returns number of bits used + BitSize_t WriteToBitStreamFromInternalPacket( RakNet::BitStream *bitStream, const InternalPacket *const internalPacket, CCTimeType curTime ); + + + /// Parse a bitstream and create an internal packet to represent this data + InternalPacket* CreateInternalPacketFromBitStream( RakNet::BitStream *bitStream, CCTimeType time ); + + /// Does what the function name says + unsigned RemovePacketFromResendListAndDeleteOlderReliableSequenced( const MessageNumberType messageNumber, CCTimeType time, DataStructures::List &messageHandlerList, const SystemAddress &systemAddress ); + + /// Acknowledge receipt of the packet with the specified messageNumber + void SendAcknowledgementPacket( const DatagramSequenceNumberType messageNumber, CCTimeType time); + + /// This will return true if we should not send at this time + bool IsSendThrottled( int MTUSize ); + + /// We lost a packet + void UpdateWindowFromPacketloss( CCTimeType time ); + + /// Increase the window size + void UpdateWindowFromAck( CCTimeType time ); + + /// Parse an internalPacket and figure out how many header bits would be written. Returns that number + BitSize_t GetMaxMessageHeaderLengthBits( void ); + BitSize_t GetMessageHeaderLengthBits( const InternalPacket *const internalPacket ); + + /// Get the SHA1 code + void GetSHA1( unsigned char * const buffer, unsigned int nbytes, char code[ SHA1_LENGTH ] ); + + /// Check the SHA1 code + bool CheckSHA1( char code[ SHA1_LENGTH ], unsigned char * const buffer, unsigned int nbytes ); + + /// Search the specified list for sequenced packets on the specified ordering channel, optionally skipping those with splitPacketId, and delete them +// void DeleteSequencedPacketsInList( unsigned char orderingChannel, DataStructures::List&theList, int splitPacketId = -1 ); + + /// Search the specified list for sequenced packets with a value less than orderingIndex and delete them +// void DeleteSequencedPacketsInList( unsigned char orderingChannel, DataStructures::Queue&theList ); + + /// Returns true if newPacketOrderingIndex is older than the waitingForPacketOrderingIndex + bool IsOlderOrderedPacket( OrderingIndexType newPacketOrderingIndex, OrderingIndexType waitingForPacketOrderingIndex ); + + /// Split the passed packet into chunks under MTU_SIZE bytes (including headers) and save those new chunks + void SplitPacket( InternalPacket *internalPacket ); + + /// Insert a packet into the split packet list + void InsertIntoSplitPacketList( InternalPacket * internalPacket, CCTimeType time ); + + /// Take all split chunks with the specified splitPacketId and try to reconstruct a packet. If we can, allocate and return it. Otherwise return 0 + InternalPacket * BuildPacketFromSplitPacketList( SplitPacketIdType splitPacketId, CCTimeType time, + RakNetSocket2 *s, SystemAddress &systemAddress, RakNetRandom *rnr, BitStream &updateBitStream); + InternalPacket * BuildPacketFromSplitPacketList( SplitPacketChannel *splitPacketChannel, CCTimeType time ); + + /// Delete any unreliable split packets that have long since expired + //void DeleteOldUnreliableSplitPackets( CCTimeType time ); + + /// Creates a copy of the specified internal packet with data copied from the original starting at dataByteOffset for dataByteLength bytes. + /// Does not copy any split data parameters as that information is always generated does not have any reason to be copied + InternalPacket * CreateInternalPacketCopy( InternalPacket *original, int dataByteOffset, int dataByteLength, CCTimeType time ); + + /// Get the specified ordering list + // DataStructures::LinkedList *GetOrderingListAtOrderingStream( unsigned char orderingChannel ); + + /// Add the internal packet to the ordering list in order based on order index + // void AddToOrderingList( InternalPacket * internalPacket ); + + /// Inserts a packet into the resend list in order + void InsertPacketIntoResendList( InternalPacket *internalPacket, CCTimeType time, bool firstResend, bool modifyUnacknowledgedBytes ); + + /// Memory handling + void FreeMemory( bool freeAllImmediately ); + + /// Memory handling + void FreeThreadSafeMemory( void ); + + // Initialize the variables + void InitializeVariables( void ); + + /// Given the current time, is this time so old that we should consider it a timeout? + bool IsExpiredTime(unsigned int input, CCTimeType currentTime) const; + + // Make it so we don't do resends within a minimum threshold of time + void UpdateNextActionTime(void); + + + /// Does this packet number represent a packet that was skipped (out of order?) + //unsigned int IsReceivedPacketHole(unsigned int input, RakNet::TimeMS currentTime) const; + + /// Skip an element in the received packets list + //unsigned int MakeReceivedPacketHole(unsigned int input) const; + + /// How many elements are waiting to be resent? + unsigned int GetResendListDataSize(void) const; + + /// Update all memory which is not threadsafe + void UpdateThreadedMemory(void); + + void CalculateHistogramAckSize(void); + + // Used ONLY for RELIABLE_ORDERED + // RELIABLE_SEQUENCED just returns the newest one + // DataStructures::List*> orderingList; + DataStructures::Queue outputQueue; + int splitMessageProgressInterval; + CCTimeType unreliableTimeout; + + struct MessageNumberNode + { + DatagramSequenceNumberType messageNumber; + MessageNumberNode *next; + }; + struct DatagramHistoryNode + { + DatagramHistoryNode() {} + DatagramHistoryNode(MessageNumberNode *_head, CCTimeType ts + ) : + head(_head), timeSent(ts) + {} + MessageNumberNode *head; + CCTimeType timeSent; + }; + // Queue length is programmatically restricted to DATAGRAM_MESSAGE_ID_ARRAY_LENGTH + // This is essentially an O(1) lookup to get a DatagramHistoryNode given an index + // datagramHistory holds a linked list of MessageNumberNode. Each MessageNumberNode refers to one element in resendList which can be cleared on an ack. + DataStructures::Queue datagramHistory; + DataStructures::MemoryPool datagramHistoryMessagePool; + + struct UnreliableWithAckReceiptNode + { + UnreliableWithAckReceiptNode() {} + UnreliableWithAckReceiptNode(DatagramSequenceNumberType _datagramNumber, uint32_t _sendReceiptSerial, RakNet::TimeUS _nextActionTime) : + datagramNumber(_datagramNumber), sendReceiptSerial(_sendReceiptSerial), nextActionTime(_nextActionTime) + {} + DatagramSequenceNumberType datagramNumber; + uint32_t sendReceiptSerial; + RakNet::TimeUS nextActionTime; + }; + DataStructures::List unreliableWithAckReceiptHistory; + + void RemoveFromDatagramHistory(DatagramSequenceNumberType index); + MessageNumberNode* GetMessageNumberNodeByDatagramIndex(DatagramSequenceNumberType index, CCTimeType *timeSent); + void AddFirstToDatagramHistory(DatagramSequenceNumberType datagramNumber, CCTimeType timeSent); + MessageNumberNode* AddFirstToDatagramHistory(DatagramSequenceNumberType datagramNumber, DatagramSequenceNumberType messageNumber, CCTimeType timeSent); + MessageNumberNode* AddSubsequentToDatagramHistory(MessageNumberNode *messageNumberNode, DatagramSequenceNumberType messageNumber); + DatagramSequenceNumberType datagramHistoryPopCount; + + DataStructures::MemoryPool internalPacketPool; + // DataStructures::BPlusTree resendTree; + InternalPacket *resendBuffer[RESEND_BUFFER_ARRAY_LENGTH]; + InternalPacket *resendLinkedListHead; + InternalPacket *unreliableLinkedListHead; + void RemoveFromUnreliableLinkedList(InternalPacket *internalPacket); + void AddToUnreliableLinkedList(InternalPacket *internalPacket); +// unsigned int numPacketsOnResendBuffer; + //unsigned int blockWindowIncreaseUntilTime; + // DataStructures::RangeList acknowlegements; + // Resend list is a tree of packets we need to resend + + // Set to the current time when the resend queue is no longer empty + // Set to zero when it becomes empty + // Set to the current time if it is not zero, and we get incoming data + // If the current time - timeResendQueueNonEmpty is greater than a threshold, we are disconnected +// CCTimeType timeResendQueueNonEmpty; + RakNet::TimeMS timeLastDatagramArrived; + + + // If we backoff due to packetloss, don't remeasure until all waiting resends have gone out or else we overcount +// bool packetlossThisSample; +// int backoffThisSample; +// unsigned packetlossThisSampleResendCount; +// CCTimeType lastPacketlossTime; + + //DataStructures::Queue sendPacketSet[ NUMBER_OF_PRIORITIES ]; + DataStructures::Heap outgoingPacketBuffer; + reliabilityHeapWeightType outgoingPacketBufferNextWeights[NUMBER_OF_PRIORITIES]; + void InitHeapWeights(void); + reliabilityHeapWeightType GetNextWeight(int priorityLevel); +// unsigned int messageInSendBuffer[NUMBER_OF_PRIORITIES]; +// double bytesInSendBuffer[NUMBER_OF_PRIORITIES]; + + + DataStructures::OrderedList splitPacketChannelList; + + MessageNumberType sendReliableMessageNumberIndex; + MessageNumberType internalOrderIndex; + //unsigned int windowSize; + //RakNet::BitStream updateBitStream; + bool deadConnection, cheater; + SplitPacketIdType splitPacketId; + RakNet::TimeMS timeoutTime; // How long to wait in MS before timing someone out + //int MAX_AVERAGE_PACKETS_PER_SECOND; // Name says it all +// int RECEIVED_PACKET_LOG_LENGTH, requestedReceivedPacketLogLength; // How big the receivedPackets array is +// unsigned int *receivedPackets; + RakNetStatistics statistics; + + // Algorithm for blending ordered and sequenced on the same channel: + // 1. Each ordered message transmits OrderingIndexType orderedWriteIndex. There are NUMBER_OF_ORDERED_STREAMS independent values of these. The value + // starts at 0. Every time an ordered message is sent, the value increments by 1 + // 2. Each sequenced message contains the current value of orderedWriteIndex for that channel, and additionally OrderingIndexType sequencedWriteIndex. + // sequencedWriteIndex resets to 0 every time orderedWriteIndex increments. It increments by 1 every time a sequenced message is sent. + // 3. The receiver maintains the next expected value for the orderedWriteIndex, stored in orderedReadIndex. + // 4. As messages arrive: + // If a message has the current ordering index, and is sequenced, and is < the current highest sequence value, discard + // If a message has the current ordering index, and is sequenced, and is >= the current highest sequence value, return immediately + // If a message has a greater ordering index, and is sequenced or ordered, buffer it + // If a message has the current ordering index, and is ordered, buffer, then push off messages from buffer + // 5. Pushing off messages from buffer: + // Messages in buffer are put in a minheap. The value of each node is calculated such that messages are returned: + // A. (lowest ordering index, lowest sequence index) + // B. (lowest ordering index, no sequence index) + // Messages are pushed off until the heap is empty, or the next message to be returned does not preserve the ordered index + // For an empty heap, the heap weight should start at the lowest value based on the next expected ordering index, to avoid variable overflow + + // Sender increments this by 1 for every ordered message sent + OrderingIndexType orderedWriteIndex[NUMBER_OF_ORDERED_STREAMS]; + // Sender increments by 1 for every sequenced message sent. Resets to 0 when an ordered message is sent + OrderingIndexType sequencedWriteIndex[NUMBER_OF_ORDERED_STREAMS]; + // Next expected index for ordered messages. + OrderingIndexType orderedReadIndex[NUMBER_OF_ORDERED_STREAMS]; + // Highest value received for sequencedWriteIndex for the current value of orderedReadIndex on the same channel. + OrderingIndexType highestSequencedReadIndex[NUMBER_OF_ORDERED_STREAMS]; + DataStructures::Heap orderingHeaps[NUMBER_OF_ORDERED_STREAMS]; + OrderingIndexType heapIndexOffsets[NUMBER_OF_ORDERED_STREAMS]; + + + + + + + +// CCTimeType histogramStart; +// unsigned histogramBitsSent; + + + /// Memory-efficient receivedPackets algorithm: + /// receivedPacketsBaseIndex is the packet number we are expecting + /// Everything under receivedPacketsBaseIndex is a packet we already got + /// Everything over receivedPacketsBaseIndex is stored in hasReceivedPacketQueue + /// It stores the time to stop waiting for a particular packet number, where the packet number is receivedPacketsBaseIndex + the index into the queue + /// If 0, we got got that packet. Otherwise, the time to give up waiting for that packet. + /// If we get a packet number where (receivedPacketsBaseIndex-packetNumber) is less than half the range of receivedPacketsBaseIndex then it is a duplicate + /// Otherwise, it is a duplicate packet (and ignore it). + // DataStructures::Queue hasReceivedPacketQueue; + DataStructures::Queue hasReceivedPacketQueue; + DatagramSequenceNumberType receivedPacketsBaseIndex; + bool resetReceivedPackets; + + CCTimeType lastUpdateTime; + CCTimeType timeBetweenPackets, nextSendTime; +#if INCLUDE_TIMESTAMP_WITH_DATAGRAMS==1 + CCTimeType ackPing; +#endif +// CCTimeType ackPingSamples[ACK_PING_SAMPLES_SIZE]; // Must be range of unsigned char to wrap ackPingIndex properly + CCTimeType ackPingSum; + unsigned char ackPingIndex; + //CCTimeType nextLowestPingReset; + RemoteSystemTimeType remoteSystemTime; +// bool continuousSend; +// CCTimeType lastTimeBetweenPacketsIncrease,lastTimeBetweenPacketsDecrease; + // Limit changes in throughput to once per ping - otherwise even if lag starts we don't know about it + // In the meantime the connection is flooded and overrun. + CCTimeType nextAllowedThroughputSample; + bool bandwidthExceededStatistic; + + // If Update::maxBitsPerSecond > 0, then throughputCapCountdown is used as a timer to prevent sends for some amount of time after each send, depending on + // the amount of data sent + long long throughputCapCountdown; + + unsigned receivePacketCount; + +#ifdef _DEBUG + struct DataAndTime// + { + RakNetSocket2 *s; + char data[ MAXIMUM_MTU_SIZE ]; + unsigned int length; + RakNet::TimeMS sendTime; + // SystemAddress systemAddress; + unsigned short remotePortRakNetWasStartedOn_PS3; + unsigned int extraSocketOptions; + }; + DataStructures::Queue delayList; + + // Internet simulator + double packetloss; + RakNet::TimeMS minExtraPing, extraPingVariance; +#endif + + CCTimeType elapsedTimeSinceLastUpdate; + + CCTimeType nextAckTimeToSend; + + +#if USE_SLIDING_WINDOW_CONGESTION_CONTROL==1 + RakNet::CCRakNetSlidingWindow congestionManager; +#else + RakNet::CCRakNetUDT congestionManager; +#endif + + + uint32_t unacknowledgedBytes; + + bool ResendBufferOverflow(void) const; + void ValidateResendList(void) const; + void ResetPacketsAndDatagrams(void); + void PushPacket(CCTimeType time, InternalPacket *internalPacket, bool isReliable); + void PushDatagram(void); + bool TagMostRecentPushAsSecondOfPacketPair(void); + void ClearPacketsAndDatagrams(void); + void MoveToListHead(InternalPacket *internalPacket); + void RemoveFromList(InternalPacket *internalPacket, bool modifyUnacknowledgedBytes); + void AddToListTail(InternalPacket *internalPacket, bool modifyUnacknowledgedBytes); + void PopListHead(bool modifyUnacknowledgedBytes); + bool IsResendQueueEmpty(void) const; + void SortSplitPacketList(DataStructures::List &data, unsigned int leftEdge, unsigned int rightEdge) const; + void SendACKs(RakNetSocket2 *s, SystemAddress &systemAddress, CCTimeType time, RakNetRandom *rnr, BitStream &updateBitStream); + + DataStructures::List packetsToSendThisUpdate; + DataStructures::List packetsToDeallocThisUpdate; + // boundary is in packetsToSendThisUpdate, inclusive + DataStructures::List packetsToSendThisUpdateDatagramBoundaries; + DataStructures::List datagramsToSendThisUpdateIsPair; + DataStructures::List datagramSizesInBytes; + BitSize_t datagramSizeSoFar; + BitSize_t allDatagramSizesSoFar; + double totalUserDataBytesAcked; + CCTimeType timeOfLastContinualSend; + CCTimeType timeToNextUnreliableCull; + + // This doesn't need to be a member, but I do it to avoid reallocations + DataStructures::RangeList incomingAcks; + + // Every 16 datagrams, we make sure the 17th datagram goes out the same update tick, and is the same size as the 16th + int countdownToNextPacketPair; + InternalPacket* AllocateFromInternalPacketPool(void); + void ReleaseToInternalPacketPool(InternalPacket *ip); + + DataStructures::RangeList acknowlegements; + DataStructures::RangeList NAKs; + bool remoteSystemNeedsBAndAS; + + unsigned int GetMaxDatagramSizeExcludingMessageHeaderBytes(void); + BitSize_t GetMaxDatagramSizeExcludingMessageHeaderBits(void); + + // ourOffset refers to a section within externallyAllocatedPtr. Do not deallocate externallyAllocatedPtr until all references are lost + void AllocInternalPacketData(InternalPacket *internalPacket, InternalPacketRefCountedData **refCounter, unsigned char *externallyAllocatedPtr, unsigned char *ourOffset); + // Set the data pointer to externallyAllocatedPtr, do not allocate + void AllocInternalPacketData(InternalPacket *internalPacket, unsigned char *externallyAllocatedPtr); + // Allocate new + void AllocInternalPacketData(InternalPacket *internalPacket, unsigned int numBytes, bool allowStack, const char *file, unsigned int line); + void FreeInternalPacketData(InternalPacket *internalPacket, const char *file, unsigned int line); + DataStructures::MemoryPool refCountedDataPool; + + BPSTracker bpsMetrics[RNS_PER_SECOND_METRICS_COUNT]; + CCTimeType lastBpsClear; + +#if LIBCAT_SECURITY==1 +public: + cat::AuthenticatedEncryption* GetAuthenticatedEncryption(void) { return &auth_enc; } + +protected: + cat::AuthenticatedEncryption auth_enc; + bool useSecurity; +#endif // LIBCAT_SECURITY +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/ReplicaEnums.hpp b/include/raknet/ReplicaEnums.hpp new file mode 100644 index 0000000..1cd771a --- /dev/null +++ b/include/raknet/ReplicaEnums.hpp @@ -0,0 +1,51 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains enumerations used by the ReplicaManager system. This file is a lightweight header, so you can include it without worrying about linking in lots of other crap +/// + + + +#ifndef __REPLICA_ENUMS_H +#define __REPLICA_ENUMS_H + +/// Replica interface flags, used to enable and disable function calls on the Replica object +/// Passed to ReplicaManager::EnableReplicaInterfaces and ReplicaManager::DisableReplicaInterfaces +enum +{ + REPLICA_RECEIVE_DESTRUCTION=1<<0, + REPLICA_RECEIVE_SERIALIZE=1<<1, + REPLICA_RECEIVE_SCOPE_CHANGE=1<<2, + REPLICA_SEND_CONSTRUCTION=1<<3, + REPLICA_SEND_DESTRUCTION=1<<4, + REPLICA_SEND_SCOPE_CHANGE=1<<5, + REPLICA_SEND_SERIALIZE=1<<6, + REPLICA_SET_ALL = 0xFF // Allow all of the above +}; + +enum ReplicaReturnResult +{ + /// This means call the function again later, with the same parameters + REPLICA_PROCESS_LATER, + /// This means we are done processing (the normal result to return) + REPLICA_PROCESSING_DONE, + /// This means cancel the processing - don't send any network messages and don't change the current state. + REPLICA_CANCEL_PROCESS, + /// Same as REPLICA_PROCESSING_DONE, where a message is sent, but does not clear the send bit. + /// Useful for multi-part sends with different reliability levels. + /// Only currently used by Replica::Serialize + REPLICA_PROCESS_AGAIN, + /// Only returned from the Replica::SendConstruction interface, means act as if the other system had this object but don't actually + /// Send a construction packet. This way you will still send scope and serialize packets to that system + REPLICA_PROCESS_IMPLICIT +}; + +#endif diff --git a/include/raknet/ReplicaManager3.hpp b/include/raknet/ReplicaManager3.hpp new file mode 100644 index 0000000..67d694b --- /dev/null +++ b/include/raknet/ReplicaManager3.hpp @@ -0,0 +1,1137 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains the third iteration of the ReplicaManager class. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_ReplicaManager3==1 + +#ifndef __REPLICA_MANAGER_3 +#define __REPLICA_MANAGER_3 + +#include "RakNetTypes.hpp" +#include "RakNetTime.hpp" +#include "BitStream.hpp" +#include "PacketPriority.hpp" +#include "PluginInterface2.hpp" +#include "NetworkIDObject.hpp" +#include "DS_OrderedList.hpp" +#include "DS_Queue.hpp" + +/// \defgroup REPLICA_MANAGER_GROUP3 ReplicaManager3 +/// \brief Third implementation of object replication +/// \details +/// \ingroup PLUGINS_GROUP + +namespace RakNet +{ +class Connection_RM3; +class Replica3; + +/// \ingroup REPLICA_MANAGER_GROUP3 +/// Used for multiple worlds. World 0 is created automatically by default +typedef uint8_t WorldId; + + +/// \internal +/// \ingroup REPLICA_MANAGER_GROUP3 +struct PRO +{ + /// Passed to RakPeerInterface::Send(). Defaults to ReplicaManager3::SetDefaultPacketPriority(). + PacketPriority priority; + + /// Passed to RakPeerInterface::Send(). Defaults to ReplicaManager3::SetDefaultPacketReliability(). + PacketReliability reliability; + + /// Passed to RakPeerInterface::Send(). Defaults to ReplicaManager3::SetDefaultOrderingChannel(). + char orderingChannel; + + /// Passed to RakPeerInterface::Send(). Defaults to 0. + uint32_t sendReceipt; + + bool operator==( const PRO& right ) const; + bool operator!=( const PRO& right ) const; +}; + + +/// \brief System to help automate game object construction, destruction, and serialization +/// \details ReplicaManager3 tracks your game objects and automates the networking for replicating them across the network
+/// As objects are created, destroyed, or serialized differently, those changes are pushed out to other systems.
+/// To use:
+///
    +///
  1. Derive from Connection_RM3 and implement Connection_RM3::AllocReplica(). This is a factory function where given a user-supplied identifier for a class (such as name) return an instance of that class. Should be able to return any networked object in your game. +///
  2. Derive from ReplicaManager3 and implement AllocConnection() and DeallocConnection() to return the class you created in step 1. +///
  3. Derive your networked game objects from Replica3. All pure virtuals have to be implemented, however defaults are provided for Replica3::QueryConstruction(), Replica3::QueryRemoteConstruction(), and Replica3::QuerySerialization() depending on your network architecture. +///
  4. When a new game object is created on the local system, pass it to ReplicaManager3::Reference(). +///
  5. When a game object is destroyed on the local system, and you want other systems to know about it, call Replica3::BroadcastDestruction() +///
+///
+/// At this point, all new connections will automatically download, get construction messages, get destruction messages, and update serialization automatically. +/// \ingroup REPLICA_MANAGER_GROUP3 +class RAK_DLL_EXPORT ReplicaManager3 : public PluginInterface2 +{ +public: + ReplicaManager3(); + virtual ~ReplicaManager3(); + + /// \brief Implement to return a game specific derivation of Connection_RM3 + /// \details The connection object represents a remote system connected to you that is using the ReplicaManager3 system.
+ /// It has functions to perform operations per-connection.
+ /// AllocConnection() and DeallocConnection() are factory functions to create and destroy instances of the connection object.
+ /// It is used if autoCreate is true via SetAutoManageConnections() (true by default). Otherwise, the function is not called, and you will have to call PushConnection() manually
+ /// \note If you do not want a new network connection to immediately download game objects, SetAutoManageConnections() and PushConnection() are how you do this. + /// \sa SetAutoManageConnections() + /// \param[in] systemAddress Address of the system you are adding + /// \param[in] rakNetGUID GUID of the system you are adding. See Packet::rakNetGUID or RakPeerInterface::GetGUIDFromSystemAddress() + /// \return The new connection instance. + virtual Connection_RM3* AllocConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID) const=0; + + /// \brief Implement to destroy a class instanced returned by AllocConnection() + /// \details Most likely just implement as {delete connection;}
+ /// It is used if autoDestroy is true via SetAutoManageConnections() (true by default). Otherwise, the function is not called and you would then be responsible for deleting your own connection objects. + /// \param[in] connection The pointer instance to delete + virtual void DeallocConnection(Connection_RM3 *connection) const=0; + + /// \brief Enable or disable automatically assigning connections to new instances of Connection_RM3 + /// \details ReplicaManager3 can automatically create and/or destroy Connection_RM3 as systems connect or disconnect from RakPeerInterface.
+ /// By default this is on, to make the system easier to learn and setup.
+ /// If you don't want all connections to take part in the game, or you want to delay when a connection downloads the game, set \a autoCreate to false.
+ /// If you want to delay deleting a connection that has dropped, set \a autoDestroy to false. If you do this, then you must call PopConnection() to remove that connection from being internally tracked. You'll also have to delete the connection instance on your own.
+ /// \param[in] autoCreate Automatically call ReplicaManager3::AllocConnection() for each new connection. Defaults to true. Also see AutoCreateConnectionList() + /// \param[in] autoDestroy Automatically call ReplicaManager3::DeallocConnection() for each dropped connection. Defaults to true. + void SetAutoManageConnections(bool autoCreate, bool autoDestroy); + + /// \return What was passed to the autoCreate parameter of SetAutoManageConnections() + bool GetAutoCreateConnections(void) const; + + /// \return What was passed to the autoDestroy parameter of SetAutoManageConnections() + bool GetAutoDestroyConnections(void) const; + + /// \brief Call AllocConnection() and PushConnection() for each connection in \a participantList + /// \param[in] participantListIn The list of connections to allocate + /// \param[in] participantListOut The connections allocated, if any + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void AutoCreateConnectionList( + DataStructures::List &participantListIn, + DataStructures::List &participantListOut, + WorldId worldId=0); + + /// \brief Track a new Connection_RM3 instance + /// \details If \a autoCreate is false for SetAutoManageConnections(), then you need this function to add new instances of Connection_RM3 yourself.
+ /// You don't need to track this pointer yourself, you can get it with GetConnectionAtIndex(), GetConnectionByGUID(), or GetConnectionBySystemAddress().
+ /// \param[in] newConnection The new connection instance to track. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + bool PushConnection(RakNet::Connection_RM3 *newConnection, WorldId worldId=0); + + /// \brief Stop tracking a connection + /// \details On call, for each replica returned by GetReplicasCreatedByGuid(), QueryActionOnPopConnection() will be called. Depending on the return value, this may delete the corresponding replica.
+ /// If autoDestroy is true in the call to SetAutoManageConnections() (true by default) then this is called automatically when the connection is lost. In that case, the returned connection instance is deleted.
+ /// \param[in] guid of the connection to get. Passed to ReplicaManager3::AllocConnection() originally. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + RakNet::Connection_RM3 * PopConnection(RakNetGUID guid, WorldId worldId=0); + + /// \brief Adds a replicated object to the system. + /// \details Anytime you create a new object that derives from Replica3, and you want ReplicaManager3 to use it, pass it to Reference().
+ /// Remote systems already connected will potentially download this object the next time ReplicaManager3::Update() is called, which happens every time you call RakPeerInterface::Receive().
+ /// You can also call ReplicaManager3::Update() manually to send referenced objects right away + /// \param[in] replica3 The object to start tracking + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void Reference(RakNet::Replica3 *replica3, WorldId worldId=0); + + /// \brief Removes a replicated object from the system. + /// \details The object is not deallocated, it is up to the caller to do so.
+ /// This is called automatically from the destructor of Replica3, so you don't need to call it manually unless you want to stop tracking an object before it is destroyed. + /// \param[in] replica3 The object to stop tracking + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void Dereference(RakNet::Replica3 *replica3, WorldId worldId=0); + + /// \brief Removes multiple replicated objects from the system. + /// \details Same as Dereference(), but for a list of objects.
+ /// Useful with the lists returned by GetReplicasCreatedByGuid(), GetReplicasCreatedByMe(), or GetReferencedReplicaList().
+ /// \param[in] replicaListIn List of objects + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void DereferenceList(DataStructures::List &replicaListIn, WorldId worldId=0); + + /// \brief Returns all objects originally created by a particular system + /// \details Originally created is defined as the value of Replica3::creatingSystemGUID, which is automatically assigned in ReplicaManager3::Reference().
+ /// You do not have to be directly connected to that system to get the objects originally created by that system.
+ /// \param[in] guid GUID of the system we are referring to. Originally passed as the \a guid parameter to ReplicaManager3::AllocConnection() + /// \param[out] List of Replica3 instances to be returned + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void GetReplicasCreatedByGuid(RakNetGUID guid, DataStructures::List &replicaListOut, WorldId worldId=0); + + /// \brief Returns all objects originally created by your system + /// \details Calls GetReplicasCreatedByGuid() for your own system guid. + /// \param[out] List of Replica3 instances to be returned + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void GetReplicasCreatedByMe(DataStructures::List &replicaListOut, WorldId worldId=0); + + /// \brief Returns the entire list of Replicas that we know about. + /// \details This is all Replica3 instances passed to Reference, as well as instances we downloaded and created via Connection_RM3::AllocReference() + /// \param[out] List of Replica3 instances to be returned + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void GetReferencedReplicaList(DataStructures::List &replicaListOut, WorldId worldId=0); + + /// \brief Returns the number of replicas known about + /// \details Returns the size of the list that would be returned by GetReferencedReplicaList() + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \return How many replica objects are in the list of replica objects + unsigned GetReplicaCount(WorldId worldId=0) const; + + /// \brief Returns a replica by index + /// \details Returns one of the items in the list that would be returned by GetReferencedReplicaList() + /// \param[in] index An index, from 0 to GetReplicaCount()-1. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \return A Replica3 instance + Replica3 *GetReplicaAtIndex(unsigned index, WorldId worldId=0); + + /// \brief Returns the number of connections + /// \details Returns the number of connections added with ReplicaManager3::PushConnection(), minus the number removed with ReplicaManager3::PopConnection() + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \return The number of registered connections + unsigned int GetConnectionCount(WorldId worldId=0) const; + + /// \brief Returns a connection pointer previously added with PushConnection() + /// \param[in] index An index, from 0 to GetConnectionCount()-1. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \return A Connection_RM3 pointer + Connection_RM3* GetConnectionAtIndex(unsigned index, WorldId worldId=0) const; + + /// \brief Returns a connection pointer previously added with PushConnection() + /// \param[in] sa The system address of the connection to return + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \return A Connection_RM3 pointer, or 0 if not found + Connection_RM3* GetConnectionBySystemAddress(const SystemAddress &sa, WorldId worldId=0) const; + + /// \brief Returns a connection pointer previously added with PushConnection.() + /// \param[in] guid The guid of the connection to return + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \return A Connection_RM3 pointer, or 0 if not found + Connection_RM3* GetConnectionByGUID(RakNetGUID guid, WorldId worldId=0) const; + + /// \param[in] Default ordering channel to use for object creation, destruction, and serializations + void SetDefaultOrderingChannel(char def); + + /// \param[in] Default packet priority to use for object creation, destruction, and serializations + void SetDefaultPacketPriority(PacketPriority def); + + /// \param[in] Default packet reliability to use for object creation, destruction, and serializations + void SetDefaultPacketReliability(PacketReliability def); + + /// \details Every \a intervalMS milliseconds, Connection_RM3::OnAutoserializeInterval() will be called.
+ /// Defaults to 30.
+ /// Pass with <0 to disable. Pass 0 to Serialize() every time RakPeer::Recieve() is called
+ /// If you want to control the update interval with more granularity, use the return values from Replica3::Serialize().
+ /// \param[in] intervalMS How frequently to autoserialize all objects. This controls the maximum number of game object updates per second. + void SetAutoSerializeInterval(RakNet::Time intervalMS); + + /// \brief Return the connections that we think have an instance of the specified Replica3 instance + /// \details This can be wrong, for example if that system locally deleted the outside the scope of ReplicaManager3, if QueryRemoteConstruction() returned false, or if DeserializeConstruction() returned false. + /// \param[in] replica The replica to check against. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \param[out] connectionsThatHaveConstructedThisReplica Populated with connection instances that we believe have \a replica allocated + void GetConnectionsThatHaveReplicaConstructed(Replica3 *replica, DataStructures::List &connectionsThatHaveConstructedThisReplica, WorldId worldId=0); + + /// \brief Returns if GetDownloadWasCompleted() returns true for all connections + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + /// \return True when all downloads have been completed + bool GetAllConnectionDownloadsCompleted(WorldId worldId=0) const; + + /// \brief ReplicaManager3 can support multiple worlds, where each world has a separate NetworkIDManager, list of connections, replicas, etc + /// A world with id 0 is created automatically. If you want multiple worlds, use this function, and ReplicaManager3::SetNetworkIDManager() to have a different NetworkIDManager instance per world + /// \param[in] worldId A unique identifier for this world. User-defined + void AddWorld(WorldId worldId); + + /// \brief Deallocate a world added with AddWorld, or the default world with id 0 + /// Deallocating a world will also stop tracking and updating all connections and replicas associated with that world. + /// \param[in] worldId A \a worldId value previously added with AddWorld() + void RemoveWorld(WorldId worldId); + + /// \brief Get one of the WorldId values added with AddWorld() + /// \details WorldId 0 is created by default. Worlds will not necessarily be in the order added with AddWorld(). Edit RemoveWorld() changing RemoveAtIndexFast() to RemoveAtIndex() to preserve order. + /// \param[in] index A value between 0 and GetWorldCount()-1 + /// \return One of the WorldId values added with AddWorld() + WorldId GetWorldIdAtIndex(unsigned int index); + + /// \brief Returns the number of world id specifiers in memory, added with AddWorld() and removed with RemoveWorld() + /// \return The number of worlds added + unsigned int GetWorldCount(void) const; + + /// \details Sets the networkIDManager instance that this plugin relys upon.
+ /// Uses whatever instance is attached to RakPeerInterface if unset.
+ /// To support multiple worlds, you should set it to a different manager for each instance of the plugin + /// \param[in] _networkIDManager The externally allocated NetworkIDManager instance for this plugin to use. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void SetNetworkIDManager(NetworkIDManager *_networkIDManager, WorldId worldId=0); + + /// Returns what was passed to SetNetworkIDManager(), or the instance on RakPeerInterface if unset. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + NetworkIDManager *GetNetworkIDManager(WorldId worldId=0) const; + + /// \details Send a network command to destroy one or more Replica3 instances + /// Usually you won't need this, but use Replica3::BroadcastDestruction() instead. + /// The objects are unaffected locally + /// \param[in] replicaList List of Replica3 objects to tell other systems to destroy. + /// \param[in] exclusionAddress Which system to not send to. UNASSIGNED_SYSTEM_ADDRESS to send to all. + /// \param[in] worldId Used for multiple worlds. World 0 is created automatically by default. See AddWorld() + void BroadcastDestructionList(DataStructures::List &replicaListSource, const SystemAddress &exclusionAddress, WorldId worldId=0); + + /// \internal + /// \details Tell other systems that have this replica to destroy this replica.
+ /// You shouldn't need to call this, as it happens in the Replica3 destructor + void BroadcastDestruction(Replica3 *replica, const SystemAddress &exclusionAddress); + + /// \internal + /// \details Frees internal lists.
+ /// \param[in] deleteWorlds True to also delete the worlds added with AddWorld() + /// Externally allocated pointers are not deallocated + void Clear(bool deleteWorlds=false); + + /// \internal + PRO GetDefaultSendParameters(void) const; + + /// Call interfaces, send data + virtual void Update(void); + + /// \internal + struct RM3World + { + RM3World(); + void Clear(ReplicaManager3 *replicaManager3); + + DataStructures::List connectionList; + DataStructures::List userReplicaList; + WorldId worldId; + NetworkIDManager *networkIDManager; + }; +protected: + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + virtual void OnRakPeerShutdown(void); + virtual void OnDetach(void); + + PluginReceiveResult OnConstruction(Packet *packet, unsigned char *packetData, int packetDataLength, RakNetGUID senderGuid, unsigned char packetDataOffset, WorldId worldId); + PluginReceiveResult OnSerialize(Packet *packet, unsigned char *packetData, int packetDataLength, RakNetGUID senderGuid, RakNet::Time timestamp, unsigned char packetDataOffset, WorldId worldId); + PluginReceiveResult OnDownloadStarted(Packet *packet, unsigned char *packetData, int packetDataLength, RakNetGUID senderGuid, unsigned char packetDataOffset, WorldId worldId); + PluginReceiveResult OnDownloadComplete(Packet *packet, unsigned char *packetData, int packetDataLength, RakNetGUID senderGuid, unsigned char packetDataOffset, WorldId worldId); + + void DeallocReplicaNoBroadcastDestruction(RakNet::Connection_RM3 *connection, RakNet::Replica3 *replica3); + RakNet::Connection_RM3 * PopConnection(unsigned int index, WorldId worldId); + Replica3* GetReplicaByNetworkID(NetworkID networkId, WorldId worldId); + unsigned int ReferenceInternal(RakNet::Replica3 *replica3, WorldId worldId); + + PRO defaultSendParameters; + RakNet::Time autoSerializeInterval; + RakNet::Time lastAutoSerializeOccurance; + bool autoCreateConnections, autoDestroyConnections; + Replica3 *currentlyDeallocatingReplica; + // Set on the first call to ReferenceInternal(), and should never be changed after that + // Used to lookup in Replica3LSRComp. I don't want to rely on GetNetworkID() in case it changes at runtime + uint32_t nextReferenceIndex; + + // For O(1) lookup + RM3World *worldsArray[255]; + // For fast traversal + DataStructures::List worldsList; + + friend class Connection_RM3; +}; + +static const int RM3_NUM_OUTPUT_BITSTREAM_CHANNELS=16; + +/// \ingroup REPLICA_MANAGER_GROUP3 +struct LastSerializationResultBS +{ + RakNet::BitStream bitStream[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS]; + bool indicesToSend[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS]; +}; + +/// Represents the serialized data for an object the last time it was sent. Used by Connection_RM3::OnAutoserializeInterval() and Connection_RM3::SendSerializeIfChanged() +/// \ingroup REPLICA_MANAGER_GROUP3 +struct LastSerializationResult +{ + LastSerializationResult(); + ~LastSerializationResult(); + + /// The replica instance we serialized + /// \note replica MUST be the first member of this struct because I cast from replica to LastSerializationResult in Update() + RakNet::Replica3 *replica; + //bool neverSerialize; +// bool isConstructed; + RakNet::Time whenLastSerialized; + + void AllocBS(void); + LastSerializationResultBS* lastSerializationResultBS; +}; + +/// Parameters passed to Replica3::Serialize() +/// \ingroup REPLICA_MANAGER_GROUP3 +struct SerializeParameters +{ + /// Write your output for serialization here + /// If nothing is written, the serialization will not occur + /// Write to any or all of the NUM_OUTPUT_BITSTREAM_CHANNELS channels available. Channels can hold independent data + RakNet::BitStream outputBitstream[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS]; + + /// Last bitstream we sent for this replica to this system. + /// Read, but DO NOT MODIFY + RakNet::BitStream* lastSentBitstream[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS]; + + /// Set to non-zero to transmit a timestamp with this message. + /// Defaults to 0 + /// Use RakNet::GetTime() for this + RakNet::Time messageTimestamp; + + /// Passed to RakPeerInterface::Send(). Defaults to ReplicaManager3::SetDefaultPacketPriority(). + /// Passed to RakPeerInterface::Send(). Defaults to ReplicaManager3::SetDefaultPacketReliability(). + /// Passed to RakPeerInterface::Send(). Defaults to ReplicaManager3::SetDefaultOrderingChannel(). + PRO pro[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS]; + + /// Passed to RakPeerInterface::Send(). + RakNet::Connection_RM3 *destinationConnection; + + /// For prior serializations this tick, for the same connection, how many bits have we written so far? + /// Use this to limit how many objects you send to update per-tick if desired + BitSize_t bitsWrittenSoFar; + + /// When this object was last serialized to the connection + /// 0 means never + RakNet::Time whenLastSerialized; + + /// Current time, in milliseconds. + /// curTime - whenLastSerialized is how long it has been since this object was last sent + RakNet::Time curTime; +}; + +/// \ingroup REPLICA_MANAGER_GROUP3 +struct DeserializeParameters +{ + RakNet::BitStream serializationBitstream[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS]; + bool bitstreamWrittenTo[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS]; + RakNet::Time timeStamp; + RakNet::Connection_RM3 *sourceConnection; +}; + +/// \ingroup REPLICA_MANAGER_GROUP3 +enum SendSerializeIfChangedResult +{ + SSICR_SENT_DATA, + SSICR_DID_NOT_SEND_DATA, + SSICR_NEVER_SERIALIZE, +}; + +/// \brief Each remote system is represented by Connection_RM3. Used to allocate Replica3 and track which instances have been allocated +/// \details Important function: AllocReplica() - must be overridden to create an object given an identifier for that object, which you define for all objects in your game +/// \ingroup REPLICA_MANAGER_GROUP3 +class RAK_DLL_EXPORT Connection_RM3 +{ +public: + + Connection_RM3(const SystemAddress &_systemAddress, RakNetGUID _guid); + virtual ~Connection_RM3(); + + /// \brief Class factory to create a Replica3 instance, given a user-defined identifier + /// \details Identifier is returned by Replica3::WriteAllocationID() for what type of class to create.
+ /// This is called when you download a replica from another system.
+ /// See Replica3::Dealloc for the corresponding destruction message.
+ /// Return 0 if unable to create the intended object. Note, in that case the other system will still think we have the object and will try to serialize object updates to us. Generally, you should not send objects the other system cannot create.
+ /// \sa Replica3::WriteAllocationID(). + /// Sample implementation:
+ /// {RakNet::RakString typeName; allocationIdBitstream->Read(typeName); if (typeName=="Soldier") return new Soldier; return 0;}
+ /// \param[in] allocationIdBitstream user-defined bitstream uniquely identifying a game object type + /// \param[in] replicaManager3 Instance of ReplicaManager3 that controls this connection + /// \return The new replica instance + virtual Replica3 *AllocReplica(RakNet::BitStream *allocationIdBitstream, ReplicaManager3 *replicaManager3)=0; + + /// \brief Get list of all replicas that are constructed for this connection + /// \param[out] objectsTheyDoHave Destination list. Returned in sorted ascending order, sorted on the value of the Replica3 pointer. + virtual void GetConstructedReplicas(DataStructures::List &objectsTheyDoHave); + + /// Returns true if we think this remote connection has this replica constructed + /// \param[in] replica3 Which replica we are querying + /// \return True if constructed, false othewise + bool HasReplicaConstructed(RakNet::Replica3 *replica); + + /// When a new connection connects, before sending any objects, SerializeOnDownloadStarted() is called + /// \param[out] bitStream Passed to DeserializeOnDownloadStarted() + virtual void SerializeOnDownloadStarted(RakNet::BitStream *bitStream) {(void) bitStream;} + + /// Receives whatever was written in SerializeOnDownloadStarted() + /// \param[in] bitStream Written in SerializeOnDownloadStarted() + virtual void DeserializeOnDownloadStarted(RakNet::BitStream *bitStream) {(void) bitStream;} + + /// When a new connection connects, after constructing and serialization all objects, SerializeOnDownloadComplete() is called + /// \param[out] bitStream Passed to DeserializeOnDownloadComplete() + virtual void SerializeOnDownloadComplete(RakNet::BitStream *bitStream) {(void) bitStream;} + + /// Receives whatever was written in DeserializeOnDownloadComplete() + /// \param[in] bitStream Written in SerializeOnDownloadComplete() + virtual void DeserializeOnDownloadComplete(RakNet::BitStream *bitStream) {(void) bitStream;} + + /// \return The system address passed to the constructor of this object + SystemAddress GetSystemAddress(void) const {return systemAddress;} + + /// \return Returns the RakNetGUID passed to the constructor of this object + RakNetGUID GetRakNetGUID(void) const {return guid;} + + /// \return True if ID_REPLICA_MANAGER_DOWNLOAD_COMPLETE arrived for this connection + bool GetDownloadWasCompleted(void) const {return gotDownloadComplete;} + + /// List of enumerations for how to get the list of valid objects for other systems + enum ConstructionMode + { + /// For every object that does not exist on the remote system, call Replica3::QueryConstruction() every tick. + /// Do not call Replica3::QueryDestruction() + /// Do not call Connection_RM3::QueryReplicaList() + QUERY_REPLICA_FOR_CONSTRUCTION, + + /// For every object that does not exist on the remote system, call Replica3::QueryConstruction() every tick. Based on the call, the object may be sent to the other system. + /// For every object that does exist on the remote system, call Replica3::QueryDestruction() every tick. Based on the call, the object may be deleted on the other system. + /// Do not call Connection_RM3::QueryReplicaList() + QUERY_REPLICA_FOR_CONSTRUCTION_AND_DESTRUCTION, + + /// Do not call Replica3::QueryConstruction() or Replica3::QueryDestruction() + /// Call Connection_RM3::QueryReplicaList() to determine which objects exist on remote systems + /// This can be faster than QUERY_REPLICA_FOR_CONSTRUCTION and QUERY_REPLICA_FOR_CONSTRUCTION_AND_DESTRUCTION for large worlds + /// See GridSectorizer.h under /Source for code that can help with this + QUERY_CONNECTION_FOR_REPLICA_LIST + }; + + /// \brief Return whether or not downloads to our system should all be processed the same tick (call to RakPeer::Receive() ) + /// \details Normally the system will send ID_REPLICA_MANAGER_DOWNLOAD_STARTED, ID_REPLICA_MANAGER_CONSTRUCTION for all downloaded objects, + /// ID_REPLICA_MANAGER_SERIALIZE for each downloaded object, and lastly ID_REPLICA_MANAGER_DOWNLOAD_COMPLETE. + /// This enables the application to show a downloading splash screen on ID_REPLICA_MANAGER_DOWNLOAD_STARTED, a progress bar, and to close the splash screen and activate all objects on ID_REPLICA_MANAGER_DOWNLOAD_COMPLETE + /// However, if the application was not set up for this then it would result in incomplete objects spread out over time, and cause problems + /// If you return true from QueryGroupDownloadMessages(), then these messages will be returned all in one tick, returned only when the download is complete + /// \note ID_REPLICA_MANAGER_DOWNLOAD_STARTED calls the callback DeserializeOnDownloadStarted() + /// \note ID_REPLICA_MANAGER_DOWNLOAD_COMPLETE calls the callback DeserializeOnDownloadComplete() + virtual bool QueryGroupDownloadMessages(void) const {return false;} + + /// \brief Queries how to get the list of objects that exist on remote systems + /// \details The default of calling QueryConstruction for every known object is easy to use, but not efficient, especially for large worlds where many objects are outside of the player's circle of influence.
+ /// QueryDestruction is also not necessarily useful or efficient, as object destruction tends to happen in known cases, and can be accomplished by calling Replica3::BroadcastDestruction() + /// QueryConstructionMode() allows you to specify more efficient algorithms than the default when overriden. + /// \return How to get the list of objects that exist on the remote system. You should always return the same value for a given connection + virtual ConstructionMode QueryConstructionMode(void) const {return QUERY_REPLICA_FOR_CONSTRUCTION_AND_DESTRUCTION;} + + /// \brief Callback used when QueryConstructionMode() returns QUERY_CONNECTION_FOR_REPLICA_LIST + /// \details This advantage of this callback is if that there are many objects that a particular connection does not have, then we do not have to iterate through those + /// objects calling QueryConstruction() for each of them.
+ ///
+ /// See GridSectorizer in the Source directory as a method to find all objects within a certain radius in a fast way.
+ ///
+ /// \param[out] newReplicasToCreate Anything in this list will be created on the remote system + /// \param[out] existingReplicasToDestroy Anything in this list will be destroyed on the remote system + virtual void QueryReplicaList( + DataStructures::List &newReplicasToCreate, + DataStructures::List &existingReplicasToDestroy) {(void) newReplicasToCreate; (void) existingReplicasToDestroy;} + + /// \brief Override which replicas to serialize and in what order for a connection for a ReplicaManager3::Update() cycle + /// \details By default, Connection_RM3 will iterate through queryToSerializeReplicaList and call QuerySerialization() on each Replica in that list + /// queryToSerializeReplicaList is populated in the order in which ReplicaManager3::Reference() is called for those objects. + /// If you write to to \a replicasToSerialize and return true, you can control in what order and for which replicas to call QuerySerialization() + /// Example use case: + /// We have more data to send then the bandwidth supports, so want to prioritize sends. For example enemies shooting are more important than animation effects + /// When QuerySerializationList(), sort objects by priority, and write the list to \a replicasToSerialize, optionally skipping objects with a lower serialization frequency + /// If you hit your bandwidth limit when checking SerializeParameters::bitsWrittenSoFar, you can return RM3SR_DO_NOT_SERIALIZE for all remaining items + /// \note Only replicas written to replicasToSerialize are transmitted. Even if you returned RM3SR_SERIALIZED_ALWAYS a prior ReplicaManager3::Update() cycle, the replica will not be transmitted if it is not in replicasToSerialize + /// \note If you do not know what objects are candidates for serialization, you can use queryToSerializeReplicaList as a source for your filtering or sorting operations + /// \param[in] replicasToSerialize List of replicas to call QuerySerialization() on + /// \return Return true to use replicasToSerialize (replicasToSerialize may be empty if desired). Otherwise return false. + virtual bool QuerySerializationList(DataStructures::List &replicasToSerialize) {(void) replicasToSerialize; return false;} + + /// \internal This is used internally - however, you can also call it manually to send a data update for a remote replica.
+ /// \brief Sends over a serialization update for \a replica.
+ /// NetworkID::GetNetworkID() is written automatically, serializationData is the object data.
+ /// \param[in] replica Which replica to serialize + /// \param[in] serializationData Serialized object data + /// \param[in] timestamp 0 means no timestamp. Otherwise message is prepended with ID_TIMESTAMP + /// \param[in] sendParameters Parameters on how to send + /// \param[in] rakPeer Instance of RakPeerInterface to send on + /// \param[in] worldId Which world, see ReplicaManager3::AddWorld() + /// \param[in] curTime The current time + virtual SendSerializeIfChangedResult SendSerialize(RakNet::Replica3 *replica, bool indicesToSend[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS], RakNet::BitStream serializationData[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS], RakNet::Time timestamp, PRO sendParameters[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS], RakNet::RakPeerInterface *rakPeer, unsigned char worldId, RakNet::Time curTime); + + /// \internal + /// \details Calls Connection_RM3::SendSerialize() if Replica3::Serialize() returns a different result than what is contained in \a lastSerializationResult.
+ /// Used by autoserialization in Connection_RM3::OnAutoserializeInterval() + /// \param[in] lsr Item in the queryToSerializeReplicaList + /// \param[in] sp Controlling parameters over the serialization + /// \param[in] rakPeer Instance of RakPeerInterface to send on + /// \param[in] worldId Which world, see ReplicaManager3::AddWorld() + /// \param[in] curTime The current time + virtual SendSerializeIfChangedResult SendSerializeIfChanged(LastSerializationResult *lsr, SerializeParameters *sp, RakNet::RakPeerInterface *rakPeer, unsigned char worldId, ReplicaManager3 *replicaManager, RakNet::Time curTime); + + /// \internal + /// \brief Given a list of objects that were created and destroyed, serialize and send them to another system. + /// \param[in] newObjects Objects to serialize construction + /// \param[in] deletedObjects Objects to serialize destruction + /// \param[in] sendParameters Controlling parameters over the serialization + /// \param[in] rakPeer Instance of RakPeerInterface to send on + /// \param[in] worldId Which world, see ReplicaManager3::AddWorld() + /// \param[in] replicaManager3 ReplicaManager3 instance + virtual void SendConstruction(DataStructures::List &newObjects, DataStructures::List &deletedObjects, PRO sendParameters, RakNet::RakPeerInterface *rakPeer, unsigned char worldId, ReplicaManager3 *replicaManager3); + + /// \internal + void SendValidation(RakNet::RakPeerInterface *rakPeer, WorldId worldId); + + /// \internal + void AutoConstructByQuery(ReplicaManager3 *replicaManager3, WorldId worldId); + + + // Internal - does the other system have this connection too? Validated means we can now use it + bool isValidated; + // Internal - Used to see if we should send download started + bool isFirstConstruction; + + static int Replica3LSRComp( Replica3 * const &replica3, LastSerializationResult * const &data ); + + // Internal + void ClearDownloadGroup(RakPeerInterface *rakPeerInterface); +protected: + + SystemAddress systemAddress; + RakNetGUID guid; + + /* + Operations: + + Locally reference a new replica: + Add to queryToConstructReplicaList for all objects + + Add all objects to queryToConstructReplicaList + + Download: + Add to constructedReplicaList for connection that send the object to us + Add to queryToSerializeReplicaList for connection that send the object to us + Add to queryToConstructReplicaList for all other connections + + Never construct for this connection: + Remove from queryToConstructReplicaList + + Construct to this connection + Remove from queryToConstructReplicaList + Add to constructedReplicaList for this connection + Add to queryToSerializeReplicaList for this connection + + Serialize: + Iterate through queryToSerializeReplicaList + + Never serialize for this connection + Remove from queryToSerializeReplicaList + + Reference (this system has this object already) + Remove from queryToConstructReplicaList + Add to constructedReplicaList for this connection + Add to queryToSerializeReplicaList for this connection + + Downloaded an existing object + if replica is in queryToConstructReplicaList, OnConstructToThisConnection() + else ignore + + Send destruction from query + Remove from queryToDestructReplicaList + Remove from queryToSerializeReplicaList + Remove from constructedReplicaList + Add to queryToConstructReplicaList + + Do not query destruction again + Remove from queryToDestructReplicaList + */ + void OnLocalReference(Replica3* replica3, ReplicaManager3 *replicaManager); + void OnDereference(Replica3* replica3, ReplicaManager3 *replicaManager); + void OnDownloadFromThisSystem(Replica3* replica3, ReplicaManager3 *replicaManager); + void OnDownloadFromOtherSystem(Replica3* replica3, ReplicaManager3 *replicaManager); + void OnNeverConstruct(unsigned int queryToConstructIdx, ReplicaManager3 *replicaManager); + void OnConstructToThisConnection(unsigned int queryToConstructIdx, ReplicaManager3 *replicaManager); + void OnConstructToThisConnection(Replica3 *replica, ReplicaManager3 *replicaManager); + void OnNeverSerialize(LastSerializationResult *lsr, ReplicaManager3 *replicaManager); + void OnReplicaAlreadyExists(unsigned int queryToConstructIdx, ReplicaManager3 *replicaManager); + void OnDownloadExisting(Replica3* replica3, ReplicaManager3 *replicaManager); + void OnSendDestructionFromQuery(unsigned int queryToDestructIdx, ReplicaManager3 *replicaManager); + void OnDoNotQueryDestruction(unsigned int queryToDestructIdx, ReplicaManager3 *replicaManager); + void ValidateLists(ReplicaManager3 *replicaManager) const; + void SendSerializeHeader(RakNet::Replica3 *replica, RakNet::Time timestamp, RakNet::BitStream *bs, WorldId worldId); + + // The list of objects that our local system and this remote system both have + // Either we sent this object to them, or they sent this object to us + // A given Replica can be either in queryToConstructReplicaList or constructedReplicaList but not both at the same time + DataStructures::OrderedList constructedReplicaList; + + // Objects that we have, but this system does not, and we will query each tick to see if it should be sent to them + // If we do send it to them, the replica is moved to constructedReplicaList + // A given Replica can be either in queryToConstructReplicaList or constructedReplicaList but not both at the same time + DataStructures::List queryToConstructReplicaList; + + // Objects that this system has constructed are added at the same time to queryToSerializeReplicaList + // This list is used to serialize all objects that this system has to this connection + DataStructures::List queryToSerializeReplicaList; + + // Objects that are constructed on this system are also queried if they should be destroyed to this system + DataStructures::List queryToDestructReplicaList; + + // Working lists + DataStructures::List constructedReplicasCulled, destroyedReplicasCulled; + + // This is used if QueryGroupDownloadMessages() returns true when ID_REPLICA_MANAGER_DOWNLOAD_STARTED arrives + // Packets will be gathered and not returned until ID_REPLICA_MANAGER_DOWNLOAD_COMPLETE arrives + bool groupConstructionAndSerialize; + DataStructures::Queue downloadGroup; + + // Stores if we got download complete for this connection + bool gotDownloadComplete; + + friend class ReplicaManager3; +private: + Connection_RM3() {}; + + ConstructionMode constructionMode; +}; + +/// \brief Return codes for Connection_RM3::GetConstructionState() and Replica3::QueryConstruction() +/// \details Indicates what state the object should be in for the remote system +/// \ingroup REPLICA_MANAGER_GROUP3 +enum RM3ConstructionState +{ + /// This object should exist on the remote system. Send a construction message if necessary + /// If the NetworkID is already in use, it will not do anything + /// If it is not in use, it will create the object, and then call DeserializeConstruction + RM3CS_SEND_CONSTRUCTION, + + /// This object should exist on the remote system. + /// The other system already has the object, and the object will never be deleted. + /// This is true of objects that are loaded with the level, for example. + /// Treat it as if it existed, without sending a construction message. + /// Will call Serialize() and SerializeConstructionExisting() to the object on the remote system + RM3CS_ALREADY_EXISTS_REMOTELY, + + /// Same as RM3CS_ALREADY_EXISTS_REMOTELY but does not call SerializeConstructionExisting() + RM3CS_ALREADY_EXISTS_REMOTELY_DO_NOT_CONSTRUCT, + + /// This object will never be sent to the target system + /// This object will never be serialized from this system to the target system + RM3CS_NEVER_CONSTRUCT, + + /// Don't do anything this tick. Will query again next tick + RM3CS_NO_ACTION, + + /// Max enum + RM3CS_MAX, +}; + +/// If this object already exists for this system, should it be removed? +/// \ingroup REPLICA_MANAGER_GROUP3 +enum RM3DestructionState +{ + /// This object should not exist on the remote system. Send a destruction message if necessary. + RM3DS_SEND_DESTRUCTION, + + /// This object will never be destroyed by a per-tick query. Don't call again + RM3DS_DO_NOT_QUERY_DESTRUCTION, + + /// Don't do anything this tick. Will query again next tick + RM3DS_NO_ACTION, + + /// Max enum + RM3DS_MAX, +}; + +/// Return codes when constructing an object +/// \ingroup REPLICA_MANAGER_GROUP3 +enum RM3SerializationResult +{ + /// This object serializes identically no matter who we send to + /// We also send it to every connection (broadcast). + /// Efficient for memory, speed, and bandwidth but only if the object is always broadcast identically. + RM3SR_BROADCAST_IDENTICALLY, + + /// Same as RM3SR_BROADCAST_IDENTICALLY, but assume the object needs to be serialized, do not check with a memcmp + /// Assume the object changed, and serialize it + /// Use this if you know exactly when your object needs to change. Can be faster than RM3SR_BROADCAST_IDENTICALLY. + /// An example of this is if every member variable has an accessor, changing a member sets a flag, and you check that flag in Replica3::QuerySerialization() + /// The opposite of this is RM3SR_DO_NOT_SERIALIZE, in case the object did not change + RM3SR_BROADCAST_IDENTICALLY_FORCE_SERIALIZATION, + + /// Either this object serializes differently depending on who we send to or we send it to some systems and not others. + /// Inefficient for memory and speed, but efficient for bandwidth + /// However, if you don't know what to return, return this + RM3SR_SERIALIZED_UNIQUELY, + + /// Do not compare against last sent value. Just send even if the data is the same as the last tick + /// If the data is always changing anyway, or you want to send unreliably, this is a good method of serialization + /// Can send unique data per connection if desired. If same data is sent to all connections, use RM3SR_SERIALIZED_ALWAYS_IDENTICALLY for even better performance + /// Efficient for memory and speed, but not necessarily bandwidth + RM3SR_SERIALIZED_ALWAYS, + + /// \deprecated, use RM3SR_BROADCAST_IDENTICALLY_FORCE_SERIALIZATION + RM3SR_SERIALIZED_ALWAYS_IDENTICALLY, + + /// Do not serialize this object this tick, for this connection. Will query again next autoserialize timer + RM3SR_DO_NOT_SERIALIZE, + + /// Never serialize this object for this connection + /// Useful for objects that are downloaded, and never change again + /// Efficient + RM3SR_NEVER_SERIALIZE_FOR_THIS_CONNECTION, + + /// Max enum + RM3SR_MAX, +}; + +/// First pass at topology to see if an object should be serialized +/// \ingroup REPLICA_MANAGER_GROUP3 +enum RM3QuerySerializationResult +{ + /// Call Serialize() to see if this object should be serializable for this connection + RM3QSR_CALL_SERIALIZE, + /// Do not call Serialize() this tick to see if this object should be serializable for this connection + RM3QSR_DO_NOT_CALL_SERIALIZE, + /// Never call Serialize() for this object and connection. This system will not serialize this object for this topology + RM3QSR_NEVER_CALL_SERIALIZE, + /// Max enum + RM3QSR_MAX, +}; + +/// \ingroup REPLICA_MANAGER_GROUP3 +enum RM3ActionOnPopConnection +{ + RM3AOPC_DO_NOTHING, + RM3AOPC_DELETE_REPLICA, + RM3AOPC_DELETE_REPLICA_AND_BROADCAST_DESTRUCTION, + RM3AOPC_MAX, +}; + +/// \ingroup REPLICA_MANAGER_GROUP3 +/// Used for Replica3::QueryConstruction_PeerToPeer() and Replica3::QuerySerialization_PeerToPeer() to describe how the object replicates between hosts +enum Replica3P2PMode +{ + /// The Replica3 instance is constructed and serialized by one system only. + /// Example: Your avatar. No other player serializes or can create your avatar. + R3P2PM_SINGLE_OWNER, + /// The Replica3 instance is constructed and/or serialized by different systems + /// This system is currently in charge of construction and/or serialization + /// Example: A pickup. When an avatar holds it, that avatar controls it. When it is on the ground, the host controls it. + R3P2PM_MULTI_OWNER_CURRENTLY_AUTHORITATIVE, + /// The Replica3 instance is constructed and/or serialized by different systems + /// Another system is in charge of construction and/or serialization, but this system may be in charge at a later time + /// Example: A pickup held by another player. That player sends creation of that object to new connections, and serializes it until it is dropped. + R3P2PM_MULTI_OWNER_NOT_CURRENTLY_AUTHORITATIVE, + /// The Replica3 instance is a static object (already exists on the remote system). + /// This system is currently in charge of construction and/or serialization + R3P2PM_STATIC_OBJECT_CURRENTLY_AUTHORITATIVE, + /// The Replica3 instance is a static object (already exists on the remote system). + /// Another system is in charge of construction and/or serialization, but this system may be in charge at a later time + R3P2PM_STATIC_OBJECT_NOT_CURRENTLY_AUTHORITATIVE, + +}; + +/// \brief Base class for your replicated objects for the ReplicaManager3 system. +/// \details To use, derive your class, or a member of your class, from Replica3.
+/// \ingroup REPLICA_MANAGER_GROUP3 +class RAK_DLL_EXPORT Replica3 : public NetworkIDObject +{ +public: + Replica3(); + + /// Before deleting a local instance of Replica3, call Replica3::BroadcastDestruction() for the deletion notification to go out on the network. + /// It is not necessary to call ReplicaManager3::Dereference(), as this happens automatically in the destructor + virtual ~Replica3(); + + /// \brief Write a unique identifer that can be read on a remote system to create an object of this same class. + /// \details The value written to \a allocationIdBitstream will be passed to Connection_RM3::AllocReplica().
+ /// Sample implementation:
+ /// {allocationIdBitstream->Write(RakNet::RakString("Soldier");}
+ /// \param[out] allocationIdBitstream Bitstream for the user to write to, to identify this class + virtual void WriteAllocationID(RakNet::Connection_RM3 *destinationConnection, RakNet::BitStream *allocationIdBitstream) const=0; + + /// \brief Ask if this object, which does not exist on \a destinationConnection should (now) be sent to that system. + /// \details If ReplicaManager3::QueryConstructionMode() returns QUERY_CONNECTION_FOR_REPLICA_LIST or QUERY_REPLICA_FOR_CONSTRUCTION_AND_DESTRUCTION (default), + /// then QueyrConstruction() is called once per tick from ReplicaManager3::Update() to determine if an object should exist on a given system.
+ /// Based on the return value, a network message may be sent to the other system to create the object.
+ /// If QueryConstructionMode() is overriden to return QUERY_CONNECTION_FOR_REPLICA_LIST, this function is unused.
+ /// \note Defaults are provided: QueryConstruction_PeerToPeer(), QueryConstruction_ServerConstruction(), QueryConstruction_ClientConstruction(). Return one of these functions for a working default for the relevant topology. + /// \param[in] destinationConnection Which system we will send to + /// \param[in] replicaManager3 Plugin instance for this Replica3 + /// \return What action to take + virtual RM3ConstructionState QueryConstruction(RakNet::Connection_RM3 *destinationConnection, ReplicaManager3 *replicaManager3)=0; + + /// \brief Ask if this object, which does exist on \a destinationConnection should be removed from the remote system + /// \details If ReplicaManager3::QueryConstructionMode() returns QUERY_REPLICA_FOR_CONSTRUCTION_AND_DESTRUCTION (default), + /// then QueryDestruction() is called once per tick from ReplicaManager3::Update() to determine if an object that exists on a remote system should be destroyed for a given system.
+ /// Based on the return value, a network message may be sent to the other system to destroy the object.
+ /// Note that you can also destroy objects with BroadcastDestruction(), so this function is not useful unless you plan to delete objects for only a particular connection.
+ /// If QueryConstructionMode() is overriden to return QUERY_CONNECTION_FOR_REPLICA_LIST, this function is unused.
+ /// \param[in] destinationConnection Which system we will send to + /// \param[in] replicaManager3 Plugin instance for this Replica3 + /// \return What action to take. Only RM3CS_SEND_DESTRUCTION does anything at this time. + virtual RM3DestructionState QueryDestruction(RakNet::Connection_RM3 *destinationConnection, ReplicaManager3 *replicaManager3) {(void) destinationConnection; (void) replicaManager3; return RM3DS_DO_NOT_QUERY_DESTRUCTION;} + + /// \brief We're about to call DeserializeConstruction() on this Replica3. If QueryRemoteConstruction() returns false, this object is deleted instead. + /// \details By default, QueryRemoteConstruction_ServerConstruction() does not allow clients to create objects. The client will get Replica3::DeserializeConstructionRequestRejected().
+ /// If you want the client to be able to potentially create objects for client/server, override accordingly.
+ /// Other variants of QueryRemoteConstruction_* just return true. + /// \note Defaults are provided: QueryRemoteConstruction_PeerToPeer(), QueryRemoteConstruction_ServerConstruction(), QueryRemoteConstruction_ClientConstruction(). Return one of these functions for a working default for the relevant topology. + /// \param[in] sourceConnection Which system sent us the object creation request message. + /// \return True to allow the object to pass onto DeserializeConstruction() (where it may also be rejected), false to immediately reject the remote construction request + virtual bool QueryRemoteConstruction(RakNet::Connection_RM3 *sourceConnection)=0; + + /// \brief We got a message from a connection to destroy this replica + /// Return true to automatically relay the destruction message to all our other connections + /// For a client in client/server, it does not matter what this funtion returns + /// For a server in client/server, this should normally return true + /// For a peer in peer to peer, you can normally return false since the original destroying peer would have told all other peers about the destruction + /// If a system gets a destruction command for an object that was already destroyed, the destruction message is ignored + virtual bool QueryRelayDestruction(Connection_RM3 *sourceConnection) const {(void) sourceConnection; return true;} + + /// \brief Write data to be sent only when the object is constructed on a remote system. + /// \details SerializeConstruction is used to write out data that you need to create this object in the context of your game, such as health, score, name. Use it for data you only need to send when the object is created.
+ /// After SerializeConstruction() is called, Serialize() will be called immediately thereafter. However, they are sent in different messages, so Serialize() may arrive a later frame than SerializeConstruction() + /// For that reason, the object should be valid after a call to DeserializeConstruction() for at least a short time.
+ /// \note The object's NetworkID and allocation id are handled by the system automatically, you do not need to write these values to \a constructionBitstream + /// \param[out] constructionBitstream Destination bitstream to write your data to + /// \param[in] destinationConnection System that will receive this network message. + virtual void SerializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection)=0; + + /// \brief Read data written by Replica3::SerializeConstruction() + /// \details Reads whatever data was written to \a constructionBitstream in Replica3::SerializeConstruction() + /// \param[out] constructionBitstream Bitstream written to in Replica3::SerializeConstruction() + /// \param[in] sourceConnection System that sent us this network message. + /// \return true to accept construction of the object. false to reject, in which case the object will be deleted via Replica3::DeallocReplica() + virtual bool DeserializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection)=0; + + /// Same as SerializeConstruction(), but for an object that already exists on the remote system. + /// Used if you return RM3CS_ALREADY_EXISTS_REMOTELY from QueryConstruction + virtual void SerializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection) {(void) constructionBitstream; (void) destinationConnection;}; + + /// Same as DeserializeConstruction(), but for an object that already exists on the remote system. + /// Used if you return RM3CS_ALREADY_EXISTS_REMOTELY from QueryConstruction + virtual void DeserializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection) {(void) constructionBitstream; (void) sourceConnection;}; + + /// \brief Write extra data to send with the object deletion event, if desired + /// \details Replica3::SerializeDestruction() will be called to write any object destruction specific data you want to send with this event. + /// \a destructionBitstream can be read in DeserializeDestruction() + /// \param[out] destructionBitstream Bitstream for you to write to + /// \param[in] destinationConnection System that will receive this network message. + virtual void SerializeDestruction(RakNet::BitStream *destructionBitstream, RakNet::Connection_RM3 *destinationConnection)=0; + + /// \brief Read data written by Replica3::SerializeDestruction() + /// \details Return true to delete the object. BroadcastDestruction() will be called automatically, followed by ReplicaManager3::Dereference.
+ /// Return false to not delete it. If you delete it at a later point, you are responsible for calling BroadcastDestruction() yourself. + virtual bool DeserializeDestruction(RakNet::BitStream *destructionBitstream, RakNet::Connection_RM3 *sourceConnection)=0; + + /// \brief The system is asking what to do with this replica when the connection is dropped + /// \details Return QueryActionOnPopConnection_Client, QueryActionOnPopConnection_Server, or QueryActionOnPopConnection_PeerToPeer + virtual RakNet::RM3ActionOnPopConnection QueryActionOnPopConnection(RakNet::Connection_RM3 *droppedConnection) const=0; + + /// Notification called for each of our replicas when a connection is popped + virtual void OnPoppedConnection(RakNet::Connection_RM3 *droppedConnection) {(void) droppedConnection;} + + /// \brief Override with {delete this;} + /// \details + ///
    + ///
  1. Got a remote message to delete this object which passed DeserializeDestruction(), OR + ///
  2. ReplicaManager3::SetAutoManageConnections() was called autoDestroy true (which is the default setting), and a remote system that owns this object disconnected) OR + /// <\OL> + ///
    + /// Override with {delete this;} to actually delete the object (and any other processing you wish).
    + /// If you don't want to delete the object, just do nothing, however, the system will not know this. You may wish to call Dereference() if the object should no longer be networked, but remain in memory. You are responsible for deleting it yoruself later.
    + /// destructionBitstream may be 0 if the object was deleted locally + virtual void DeallocReplica(RakNet::Connection_RM3 *sourceConnection)=0; + + /// \brief Implement with QuerySerialization_ClientSerializable(), QuerySerialization_ServerSerializable(), or QuerySerialization_PeerToPeer() + /// \details QuerySerialization() is a first pass query to check if a given object should serializable to a given system. The intent is that the user implements with one of the defaults for client, server, or peer to peer.
    + /// Without this function, a careless implementation would serialize an object anytime it changed to all systems. This would give you feedback loops as the sender gets the same message back from the recipient it just sent to.
    + /// If more than one system can serialize the same object then you will need to override to return true, and control the serialization result from Replica3::Serialize(). Be careful not to send back the same data to the system that just sent to you! + /// \return True to allow calling Replica3::Serialize() for this connection, false to not call. + virtual RakNet::RM3QuerySerializationResult QuerySerialization(RakNet::Connection_RM3 *destinationConnection)=0; + + /// \brief Called for each replica owned by the user, once per Serialization tick, before Serialize() is called. + /// If you want to do some kind of operation on the Replica objects that you own, just before Serialization(), then overload this function + virtual void OnUserReplicaPreSerializeTick(void) {} + + /// \brief Serialize our class to a bitstream + /// \details User should implement this function to write the contents of this class to SerializationParamters::serializationBitstream.
    + /// If data only needs to be written once, you can write it to SerializeConstruction() instead for efficiency.
    + /// Transmitted over the network if it changed from the last time we called Serialize().
    + /// Called every time the time interval to ReplicaManager3::SetAutoSerializeInterval() elapses and ReplicaManager3::Update is subsequently called. + /// \param[in/out] serializeParameters Parameters controlling the serialization, including destination bitstream to write to + /// \return Whether to serialize, and if so, how to optimize the results + virtual RM3SerializationResult Serialize(RakNet::SerializeParameters *serializeParameters)=0; + + /// \brief Called when the class is actually transmitted via Serialize() + /// \details Use to track how much bandwidth this class it taking + virtual void OnSerializeTransmission(RakNet::BitStream *bitStream, RakNet::Connection_RM3 *destinationConnection, BitSize_t bitsPerChannel[RM3_NUM_OUTPUT_BITSTREAM_CHANNELS], RakNet::Time curTime) {(void) bitStream; (void) destinationConnection; (void) bitsPerChannel; (void) curTime;} + + /// \brief Read what was written in Serialize() + /// \details Reads the contents of the class from SerializationParamters::serializationBitstream.
    + /// Called whenever Serialize() is called with different data from the last send. + /// \param[in] serializationBitstream Bitstream passed to Serialize() + /// \param[in] timeStamp 0 if unused, else contains the time the message originated on the remote system + /// \param[in] sourceConnection Which system sent to us + virtual void Deserialize(RakNet::DeserializeParameters *deserializeParameters)=0; + + /// \brief Called after SerializeConstruction completes for all objects in a given update tick.
    + /// Writes to PostDeserializeConstruction(), which is called after all objects are created for a given Construction tick(). + /// Override to send data to PostDeserializeConstruction(), such as the NetworkID of other objects to resolve pointers to + virtual void PostSerializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection) {(void) constructionBitstream; (void) destinationConnection;} + + /// Called after DeserializeConstruction completes for all objects in a given update tick.
    + /// This is used to resolve dependency chains, where two objects would refer to each other in DeserializeConstruction, yet one had not been constructed yet + /// In PostDeserializeConstruction(), you know that all objects have already been created, so can resolve NetworkIDs to pointers safely. + /// You can also use it to trigger some sort of event when you know the object has completed deserialization. + /// \param[in] constructionBitstream BitStream written in PostSerializeConstruction() + /// \param[in] sourceConnection System that sent us this network message. + virtual void PostDeserializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection) {(void) constructionBitstream; (void) sourceConnection;} + + /// Same as PostSerializeConstruction(), but for objects that returned RM3CS_ALREADY_EXISTS_REMOTELY from QueryConstruction + virtual void PostSerializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection) {(void) constructionBitstream; (void) destinationConnection;} + + /// Same as PostDeserializeConstruction(), but for objects that returned RM3CS_ALREADY_EXISTS_REMOTELY from QueryConstruction + virtual void PostDeserializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection) {(void) constructionBitstream; (void) sourceConnection;} + + /// Called after DeserializeDestruction completes for the object successfully, but obviously before the object is deleted.
    + /// Override to trigger some sort of event when you know the object has completed destruction. + /// \param[in] sourceConnection System that sent us this network message. + virtual void PreDestruction(RakNet::Connection_RM3 *sourceConnection) {(void) sourceConnection;} + + /// \brief Default call for QueryConstruction(). + /// \details Both the client and the server is allowed to create this object. The network topology is client/server + /// \param[in] destinationConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] isThisTheServer True if this system is the server, false if not. + virtual RM3ConstructionState QueryConstruction_ClientConstruction(RakNet::Connection_RM3 *destinationConnection, bool isThisTheServer); + + /// Default call for QueryRemoteConstruction(). + /// \details Both the client and the server is allowed to create this object. The network topology is client/server + /// The code means on the client or the server, allow creation of Replica3 instances + /// \param[in] sourceConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] isThisTheServer True if this system is the server, false if not. + virtual bool QueryRemoteConstruction_ClientConstruction(RakNet::Connection_RM3 *sourceConnection, bool isThisTheServer); + + /// \brief Default call for QueryConstruction(). + /// \details Only the server is allowed to create this object. The network topology is client/server + /// \param[in] destinationConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] isThisTheServer True if this system is the server, false if not. + virtual RM3ConstructionState QueryConstruction_ServerConstruction(RakNet::Connection_RM3 *destinationConnection, bool isThisTheServer); + + /// \brief Default call for QueryRemoteConstruction(). Allow the server to create this object, but not the client. + /// \details Only the server is allowed to create this object. The network topology is client/server + /// The code means if this is the server, and I got a command to create a Replica3 to ignore it. If this is the client, to allow it. + /// \param[in] sourceConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] isThisTheServer True if this system is the server, false if not. + virtual bool QueryRemoteConstruction_ServerConstruction(RakNet::Connection_RM3 *sourceConnection, bool isThisTheServer); + + /// \brief Default call for QueryConstruction(). + /// \details All clients are allowed to create all objects. The object is not relayed when remotely created + /// \param[in] destinationConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] p2pMode If controlled only by this system ever, pass R3P2PM_SINGLE_OWNER. Otherwise pass R3P2PM_MULTI_OWNER_CURRENTLY_AUTHORITATIVE or R3P2PM_MULTI_OWNER_NOT_CURRENTLY_AUTHORITATIVE + virtual RM3ConstructionState QueryConstruction_PeerToPeer(RakNet::Connection_RM3 *destinationConnection, Replica3P2PMode p2pMode=R3P2PM_SINGLE_OWNER); + /// \brief Default call for QueryRemoteConstruction(). + /// \details All clients are allowed to create all objects. The object is not relayed when remotely created + /// \param[in] sourceConnection destinationConnection parameter passed to QueryConstruction() + virtual bool QueryRemoteConstruction_PeerToPeer(RakNet::Connection_RM3 *sourceConnection); + + /// \brief Default call for QuerySerialization(). + /// \details Use if the values you are serializing are generated by the client that owns the object. The serialization will be relayed through the server to the other clients. + /// \param[in] destinationConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] isThisTheServer True if this system is the server, false if not. + virtual RakNet::RM3QuerySerializationResult QuerySerialization_ClientSerializable(RakNet::Connection_RM3 *destinationConnection, bool isThisTheServer); + /// \brief Default call for QuerySerialization(). + /// \details Use if the values you are serializing are generated only by the server. The serialization will be sent to all clients, but the clients will not send back to the server. + /// \param[in] destinationConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] isThisTheServer True if this system is the server, false if not. + virtual RakNet::RM3QuerySerializationResult QuerySerialization_ServerSerializable(RakNet::Connection_RM3 *destinationConnection, bool isThisTheServer); + /// \brief Default call for QuerySerialization(). + /// \details Use if the values you are serializing are on a peer to peer network. The peer that owns the object will send to all. Remote peers will not send. + /// \param[in] destinationConnection destinationConnection parameter passed to QueryConstruction() + /// \param[in] p2pMode If controlled only by this system ever, pass R3P2PM_SINGLE_OWNER. Otherwise pass R3P2PM_MULTI_OWNER_CURRENTLY_AUTHORITATIVE or R3P2PM_MULTI_OWNER_NOT_CURRENTLY_AUTHORITATIVE + virtual RakNet::RM3QuerySerializationResult QuerySerialization_PeerToPeer(RakNet::Connection_RM3 *destinationConnection, Replica3P2PMode p2pMode=R3P2PM_SINGLE_OWNER); + + /// Default: If we are a client, and the connection is lost, delete the server's objects + virtual RM3ActionOnPopConnection QueryActionOnPopConnection_Client(RakNet::Connection_RM3 *droppedConnection) const; + /// Default: If we are a server, and the connection is lost, delete the client's objects and broadcast the destruction + virtual RM3ActionOnPopConnection QueryActionOnPopConnection_Server(RakNet::Connection_RM3 *droppedConnection) const; + /// Default: If we are a peer, and the connection is lost, delete the peer's objects + virtual RM3ActionOnPopConnection QueryActionOnPopConnection_PeerToPeer(RakNet::Connection_RM3 *droppedConnection) const; + + /// Call to send a network message to delete this object on other systems.
    + /// Call it before deleting the object + virtual void BroadcastDestruction(void); + + /// creatingSystemGUID is set the first time Reference() is called, or if we get the object from another system + /// \return System that originally created this object + RakNetGUID GetCreatingSystemGUID(void) const; + + /// \return If ReplicaManager3::Reference() was called on this object. + bool WasReferenced(void) const {return replicaManager!=0;} + + /// GUID of the system that first called Reference() on this object. + /// Transmitted automatically when the object is constructed + RakNetGUID creatingSystemGUID; + /// GUID of the system that caused the item to send a deletion command over the network + RakNetGUID deletingSystemGUID; + + /// \internal + /// ReplicaManager3 plugin associated with this object + ReplicaManager3 *replicaManager; + + LastSerializationResultBS lastSentSerialization; + bool forceSendUntilNextUpdate; + LastSerializationResult *lsr; + uint32_t referenceIndex; +}; + +/// \brief Use Replica3 through composition instead of inheritance by containing an instance of this templated class +/// Calls to parent class for all functions +/// Parent class must still define and functions though! +/// \pre Parent class must call SetCompositeOwner() on this object +template +class RAK_DLL_EXPORT Replica3Composite : public Replica3 +{ +protected: + parent_type *r3CompositeOwner; +public: + void SetCompositeOwner(parent_type *p) {r3CompositeOwner=p;} + parent_type* GetCompositeOwner(void) const {return r3CompositeOwner;}; + virtual void WriteAllocationID(RakNet::Connection_RM3 *destinationConnection, RakNet::BitStream *allocationIdBitstream) const {r3CompositeOwner->WriteAllocationID(destinationConnection, allocationIdBitstream);} + virtual RakNet::RM3ConstructionState QueryConstruction(RakNet::Connection_RM3 *destinationConnection, RakNet::ReplicaManager3 *replicaManager3) {return r3CompositeOwner->QueryConstruction(destinationConnection, replicaManager3);} + virtual RakNet::RM3DestructionState QueryDestruction(RakNet::Connection_RM3 *destinationConnection, RakNet::ReplicaManager3 *replicaManager3) {return r3CompositeOwner->QueryDestruction(destinationConnection, replicaManager3);} + virtual bool QueryRemoteConstruction(RakNet::Connection_RM3 *sourceConnection) {return r3CompositeOwner->QueryRemoteConstruction(sourceConnection);} + virtual bool QueryRelayDestruction(RakNet::Connection_RM3 *sourceConnection) const {return r3CompositeOwner->QueryRelayDestruction(sourceConnection);} + virtual void SerializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection) {r3CompositeOwner->SerializeConstruction(constructionBitstream, destinationConnection);} + virtual bool DeserializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection) {return r3CompositeOwner->DeserializeConstruction(constructionBitstream, sourceConnection);} + virtual void SerializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection) {r3CompositeOwner->SerializeConstructionExisting(constructionBitstream, destinationConnection);} + virtual void DeserializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection) {r3CompositeOwner->DeserializeConstructionExisting(constructionBitstream, sourceConnection);} + virtual void SerializeDestruction(RakNet::BitStream *destructionBitstream, RakNet::Connection_RM3 *destinationConnection) {r3CompositeOwner->SerializeDestruction(destructionBitstream, destinationConnection);} + virtual bool DeserializeDestruction(RakNet::BitStream *destructionBitstream, RakNet::Connection_RM3 *sourceConnection) {return r3CompositeOwner->DeserializeDestruction(destructionBitstream, sourceConnection);} + virtual RakNet::RM3ActionOnPopConnection QueryActionOnPopConnection(RakNet::Connection_RM3 *droppedConnection) const {return r3CompositeOwner->QueryActionOnPopConnection(droppedConnection);} + virtual void OnPoppedConnection(RakNet::Connection_RM3 *droppedConnection) {r3CompositeOwner->OnPoppedConnection(droppedConnection);} + virtual void DeallocReplica(RakNet::Connection_RM3 *sourceConnection) {r3CompositeOwner->DeallocReplica(sourceConnection);} + virtual RakNet::RM3QuerySerializationResult QuerySerialization(RakNet::Connection_RM3 *destinationConnection) {return r3CompositeOwner->QuerySerialization(destinationConnection);} + virtual void OnUserReplicaPreSerializeTick(void) {r3CompositeOwner->OnUserReplicaPreSerializeTick();} + virtual RakNet::RM3SerializationResult Serialize(RakNet::SerializeParameters *serializeParameters) {return r3CompositeOwner->Serialize(serializeParameters);} + virtual void OnSerializeTransmission(RakNet::BitStream *bitStream, RakNet::Connection_RM3 *destinationConnection, RakNet::BitSize_t bitsPerChannel[RakNet::RM3_NUM_OUTPUT_BITSTREAM_CHANNELS], RakNet::Time curTime) {r3CompositeOwner->OnSerializeTransmission(bitStream, destinationConnection, bitsPerChannel, curTime);} + virtual void Deserialize(RakNet::DeserializeParameters *deserializeParameters) {r3CompositeOwner->Deserialize(deserializeParameters);} + virtual void PostSerializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection) {r3CompositeOwner->PostSerializeConstruction(constructionBitstream, destinationConnection);} + virtual void PostDeserializeConstruction(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection) {r3CompositeOwner->PostDeserializeConstruction(constructionBitstream, sourceConnection);} + virtual void PostSerializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *destinationConnection) {r3CompositeOwner->PostSerializeConstructionExisting(constructionBitstream, destinationConnection);} + virtual void PostDeserializeConstructionExisting(RakNet::BitStream *constructionBitstream, RakNet::Connection_RM3 *sourceConnection) {r3CompositeOwner->PostDeserializeConstructionExisting(constructionBitstream, sourceConnection);} + virtual void PreDestruction(RakNet::Connection_RM3 *sourceConnection) {r3CompositeOwner->PreDestruction(sourceConnection);} +}; + +} // namespace RakNet + + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/Router2.hpp b/include/raknet/Router2.hpp new file mode 100644 index 0000000..2fa9987 --- /dev/null +++ b/include/raknet/Router2.hpp @@ -0,0 +1,203 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Router2 plugin. Allows you to connect to a system by routing packets through another system that is connected to both you and the destination. Useful for getting around NATs. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_Router2==1 && _RAKNET_SUPPORT_UDPForwarder==1 + +#ifndef __ROUTER_2_PLUGIN_H +#define __ROUTER_2_PLUGIN_H + +#include "RakNetTypes.hpp" +#include "PluginInterface2.hpp" +#include "PacketPriority.hpp" +#include "Export.hpp" +#include "UDPForwarder.hpp" +#include "MessageIdentifiers.hpp" +#include "DS_List.hpp" +#include "SimpleMutex.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +struct Router2DebugInterface +{ + Router2DebugInterface() {} + virtual ~Router2DebugInterface() {} + virtual void ShowFailure(const char *message); + virtual void ShowDiagnostic(const char *message); +}; + +/// \defgroup ROUTER_2_GROUP Router2 +/// \brief Part of the NAT punchthrough solution, allowing you to connect to systems by routing through a shared connection. +/// \details Router2 routes datagrams between two systems that are not directly connected by using the bandwidth of a third system, to which the other two systems were connected +/// It is of benefit when a fully connected mesh topology is desired, but could not be completely established due to routers and/or firewalls +/// As the system address of a remote system will be the system address of the intermediary, it is necessary to use the RakNetGUID object to refer to systems, including with other plugins +/// \ingroup PLUGINS_GROUP + +/// \ingroup ROUTER_2_GROUP +/// \brief Class interface for the Router2 system +/// \details +class RAK_DLL_EXPORT Router2 : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(Router2) + + Router2(); + virtual ~Router2(); + + /// Sets the socket family to use, either IPV4 or IPV6 + /// \param[in] socketFamily For IPV4, use AF_INET (default). For IPV6, use AF_INET6. To autoselect, use AF_UNSPEC. + void SetSocketFamily(unsigned short _socketFamily); + + /// \brief Query all connected systems to connect through them to a third system. + /// System will return ID_ROUTER_2_FORWARDING_NO_PATH if unable to connect. + /// Else you will get ID_ROUTER_2_FORWARDING_ESTABLISHED + /// + /// On ID_ROUTER_2_FORWARDING_ESTABLISHED, EstablishRouting as follows: + /// + /// RakNet::BitStream bs(packet->data, packet->length, false); + /// bs.IgnoreBytes(sizeof(MessageID)); + /// RakNetGUID endpointGuid; + /// bs.Read(endpointGuid); + /// unsigned short sourceToDestPort; + /// bs.Read(sourceToDestPort); + /// char ipAddressString[32]; + /// packet->systemAddress.ToString(false, ipAddressString); + /// rakPeerInterface->EstablishRouting(ipAddressString, sourceToDestPort, 0,0); + /// + /// \note The SystemAddress for a connection should not be used - always use RakNetGuid as the address can change at any time. + /// When the address changes, you will get ID_ROUTER_2_REROUTED + void EstablishRouting(RakNetGUID endpointGuid); + + /// Set the maximum number of bidirectional connections this system will support + /// Defaults to 0 + void SetMaximumForwardingRequests(int max); + + /// For testing and debugging + void SetDebugInterface(Router2DebugInterface *_debugInterface); + + /// Get the pointer passed to SetDebugInterface() + Router2DebugInterface *GetDebugInterface(void) const; + + // -------------------------------------------------------------------------------------------- + // Packet handling functions + // -------------------------------------------------------------------------------------------- + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void Update(void); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnFailedConnectionAttempt(Packet *packet, PI2_FailedConnectionAttemptReason failedConnectionAttemptReason); + virtual void OnRakPeerShutdown(void); + + + enum Router2RequestStates + { + R2RS_REQUEST_STATE_QUERY_FORWARDING, + REQUEST_STATE_REQUEST_FORWARDING, + }; + + struct ConnectionRequestSystem + { + RakNetGUID guid; + int pingToEndpoint; + unsigned short usedForwardingEntries; + }; + + struct ConnnectRequest + { + ConnnectRequest(); + ~ConnnectRequest(); + + DataStructures::List connectionRequestSystems; + SimpleMutex connectionRequestSystemsMutex; + Router2RequestStates requestState; + RakNet::TimeMS pingTimeout; + RakNetGUID endpointGuid; + RakNetGUID lastRequestedForwardingSystem; + bool returnConnectionLostOnFailure; + unsigned int GetGuidIndex(RakNetGUID guid); + }; + + unsigned int GetConnectionRequestIndex(RakNetGUID endpointGuid); + + struct MiniPunchRequest + { + RakNetGUID endpointGuid; + SystemAddress endpointAddress; + bool gotReplyFromEndpoint; + RakNetGUID sourceGuid; + SystemAddress sourceAddress; + bool gotReplyFromSource; + RakNet::TimeMS timeout; + RakNet::TimeMS nextAction; + unsigned short forwardingPort; + __UDPSOCKET__ forwardingSocket; + }; + + struct ForwardedConnection + { + RakNetGUID endpointGuid; + RakNetGUID intermediaryGuid; + SystemAddress intermediaryAddress; + bool returnConnectionLostOnFailure; + bool weInitiatedForwarding; + }; + +protected: + + bool UpdateForwarding(ConnnectRequest* connectionRequest); + void RemoveConnectionRequest(unsigned int connectionRequestIndex); + void RequestForwarding(ConnnectRequest* connectionRequest); + void OnQueryForwarding(Packet *packet); + void OnQueryForwardingReply(Packet *packet); + void OnRequestForwarding(Packet *packet); + void OnRerouted(Packet *packet); + void OnMiniPunchReply(Packet *packet); + void OnMiniPunchReplyBounce(Packet *packet); + bool OnForwardingSuccess(Packet *packet); + int GetLargestPingAmongConnectedSystems(void) const; + void ReturnToUser(MessageID messageId, RakNetGUID endpointGuid, const SystemAddress &systemAddress, bool wasGeneratedLocally); + bool ConnectInternal(RakNetGUID endpointGuid, bool returnConnectionLostOnFailure); + + UDPForwarder *udpForwarder; + int maximumForwardingRequests; + SimpleMutex connectionRequestsMutex, miniPunchesInProgressMutex, forwardedConnectionListMutex; + DataStructures::List connectionRequests; + DataStructures::List miniPunchesInProgress; + // Forwarding we have initiated + DataStructures::List forwardedConnectionList; + + void ClearConnectionRequests(void); + void ClearMinipunches(void); + void ClearForwardedConnections(void); + void ClearAll(void); + int ReturnFailureOnCannotForward(RakNetGUID sourceGuid, RakNetGUID endpointGuid); + void SendFailureOnCannotForward(RakNetGUID sourceGuid, RakNetGUID endpointGuid); + void SendForwardingSuccess(MessageID messageId, RakNetGUID sourceGuid, RakNetGUID endpointGuid, unsigned short sourceToDstPort); + void SendOOBFromRakNetPort(OutOfBandIdentifiers oob, BitStream *extraData, SystemAddress sa); + void SendOOBFromSpecifiedSocket(OutOfBandIdentifiers oob, SystemAddress sa, __UDPSOCKET__ socket); + void SendOOBMessages(MiniPunchRequest *mpr); + + Router2DebugInterface *debugInterface; + unsigned short socketFamily; +}; + +} + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/SecureHandshake.hpp b/include/raknet/SecureHandshake.hpp new file mode 100644 index 0000000..8a5dfcf --- /dev/null +++ b/include/raknet/SecureHandshake.hpp @@ -0,0 +1,34 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// + + +#ifndef SECURE_HANDSHAKE_H +#define SECURE_HANDSHAKE_H + +#include "NativeFeatureIncludes.hpp" + +#if LIBCAT_SECURITY==1 + +// If building a RakNet DLL, be sure to tweak the CAT_EXPORT macro meaning +#if !defined(_RAKNET_LIB) && defined(_RAKNET_DLL) +# define CAT_BUILD_DLL +#else +# define CAT_NEUTER_EXPORT +#endif + +// Include DependentExtensions in your path to include this +#include "cat/AllTunnel.hpp" + +#endif // LIBCAT_SECURITY + +#endif // SECURE_HANDSHAKE_H diff --git a/include/raknet/SendToThread.hpp b/include/raknet/SendToThread.hpp new file mode 100644 index 0000000..5df911d --- /dev/null +++ b/include/raknet/SendToThread.hpp @@ -0,0 +1,57 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __SENDTO_THREAD +#define __SENDTO_THREAD + +#include "RakNetDefines.hpp" + +#ifdef USE_THREADED_SEND + +#include "InternalPacket.hpp" +#include "SocketLayer.hpp" +#include "DS_ThreadsafeAllocatingQueue.hpp" +#include "ThreadPool.hpp" + +namespace RakNet +{ +class SendToThread +{ +public: + SendToThread(); + ~SendToThread(); + + struct SendToThreadBlock + { + SOCKET s; + SystemAddress systemAddress; + unsigned short remotePortRakNetWasStartedOn_PS3; + unsigned int extraSocketOptions; + char data[MAXIMUM_MTU_SIZE]; + unsigned short dataWriteOffset; + }; + + static SendToThreadBlock* AllocateBlock(void); + static void ProcessBlock(SendToThreadBlock* threadedSend); + + static void AddRef(void); + static void Deref(void); + static DataStructures::ThreadsafeAllocatingQueue objectQueue; +protected: + static int refCount; + static ThreadPool threadPool; + +}; +} + + +#endif + +#endif diff --git a/include/raknet/SignaledEvent.hpp b/include/raknet/SignaledEvent.hpp new file mode 100644 index 0000000..0d46199 --- /dev/null +++ b/include/raknet/SignaledEvent.hpp @@ -0,0 +1,69 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __SIGNALED_EVENT_H +#define __SIGNALED_EVENT_H + + + +#if defined(_WIN32) +#include "WindowsIncludes.hpp" + + + +#else + #include + #include + #include "SimpleMutex.hpp" + + + + +#endif + +#include "Export.hpp" + +namespace RakNet +{ + +class RAK_DLL_EXPORT SignaledEvent +{ +public: + SignaledEvent(); + ~SignaledEvent(); + + void InitEvent(void); + void CloseEvent(void); + void SetEvent(void); + void WaitOnEvent(int timeoutMs); + +protected: +#ifdef _WIN32 + HANDLE eventList; + + + + + +#else + SimpleMutex isSignaledMutex; + bool isSignaled; +#if !defined(ANDROID) + pthread_condattr_t condAttr; +#endif + pthread_cond_t eventList; + pthread_mutex_t hMutex; + pthread_mutexattr_t mutexAttr; +#endif +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/SimpleMutex.hpp b/include/raknet/SimpleMutex.hpp new file mode 100644 index 0000000..5b99e68 --- /dev/null +++ b/include/raknet/SimpleMutex.hpp @@ -0,0 +1,78 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] Encapsulates a mutex +/// + + + +#ifndef __SIMPLE_MUTEX_H +#define __SIMPLE_MUTEX_H + +#include "RakMemoryOverride.hpp" + + +#if defined(_WIN32) +#include "WindowsIncludes.hpp" + + +#else +#include +#include +#endif +#include "Export.hpp" + +namespace RakNet +{ + +/// \brief An easy to use mutex. +/// +/// I wrote this because the version that comes with Windows is too complicated and requires too much code to use. +/// @remark Previously I used this everywhere, and in fact for a year or two RakNet was totally threadsafe. While doing profiling, I saw that this function was incredibly slow compared to the blazing performance of everything else, so switched to single producer / consumer everywhere. Now the user thread of RakNet is not threadsafe, but it's 100X faster than before. +class RAK_DLL_EXPORT SimpleMutex +{ +public: + + // Constructor + SimpleMutex(); + + // Destructor + ~SimpleMutex(); + + // Locks the mutex. Slow! + void Lock(void); + + // Unlocks the mutex. + void Unlock(void); + + + + + + + +private: + void Init(void); +#ifdef _WIN32 + CRITICAL_SECTION criticalSection; /// Docs say this is faster than a mutex for single process access + + +#else + pthread_mutex_t hMutex; +#endif + // Not threadsafe + // bool isInitialized; +}; + +} // namespace RakNet + +#endif + diff --git a/include/raknet/SimpleTCPServer.hpp b/include/raknet/SimpleTCPServer.hpp new file mode 100644 index 0000000..1181cd0 --- /dev/null +++ b/include/raknet/SimpleTCPServer.hpp @@ -0,0 +1 @@ +// Eraseme \ No newline at end of file diff --git a/include/raknet/SingleProducerConsumer.hpp b/include/raknet/SingleProducerConsumer.hpp new file mode 100644 index 0000000..6dde659 --- /dev/null +++ b/include/raknet/SingleProducerConsumer.hpp @@ -0,0 +1,267 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b [Internal] Passes queued data between threads using a circular buffer with read and write pointers +/// + + + +#ifndef __SINGLE_PRODUCER_CONSUMER_H +#define __SINGLE_PRODUCER_CONSUMER_H + +#include "RakAssert.hpp" + +static const int MINIMUM_LIST_SIZE=8; + +#include "RakMemoryOverride.hpp" +#include "Export.hpp" + +/// The namespace DataStructures was only added to avoid compiler errors for commonly named data structures +/// As these data structures are stand-alone, you can use them outside of RakNet for your own projects if you wish. +namespace DataStructures +{ + /// \brief A single producer consumer implementation without critical sections. + template + class RAK_DLL_EXPORT SingleProducerConsumer + { + public: + // Constructor + SingleProducerConsumer(); + + // Destructor + ~SingleProducerConsumer(); + + /// WriteLock must be immediately followed by WriteUnlock. These two functions must be called in the same thread. + /// \return A pointer to a block of data you can write to. + SingleProducerConsumerType* WriteLock(void); + + /// Call if you don't want to write to a block of data from WriteLock() after all. + /// Cancelling locks cancels all locks back up to the data passed. So if you lock twice and cancel using the first lock, the second lock is ignored + /// \param[in] cancelToLocation Which WriteLock() to cancel. + void CancelWriteLock(SingleProducerConsumerType* cancelToLocation); + + /// Call when you are done writing to a block of memory returned by WriteLock() + void WriteUnlock(void); + + /// ReadLock must be immediately followed by ReadUnlock. These two functions must be called in the same thread. + /// \retval 0 No data is availble to read + /// \retval Non-zero The data previously written to, in another thread, by WriteLock followed by WriteUnlock. + SingleProducerConsumerType* ReadLock(void); + + // Cancelling locks cancels all locks back up to the data passed. So if you lock twice and cancel using the first lock, the second lock is ignored + /// param[in] Which ReadLock() to cancel. + void CancelReadLock(SingleProducerConsumerType* cancelToLocation); + + /// Signals that we are done reading the the data from the least recent call of ReadLock. + /// At this point that pointer is no longer valid, and should no longer be read. + void ReadUnlock(void); + + /// Clear is not thread-safe and none of the lock or unlock functions should be called while it is running. + void Clear(void); + + /// This function will estimate how many elements are waiting to be read. It's threadsafe enough that the value returned is stable, but not threadsafe enough to give accurate results. + /// \return An ESTIMATE of how many data elements are waiting to be read + int Size(void) const; + + /// Make sure that the pointer we done reading for the call to ReadUnlock is the right pointer. + /// param[in] A previous pointer returned by ReadLock() + bool CheckReadUnlockOrder(const SingleProducerConsumerType* data) const; + + /// Returns if ReadUnlock was called before ReadLock + /// \return If the read is locked + bool ReadIsLocked(void) const; + + private: + struct DataPlusPtr + { + DataPlusPtr () {readyToRead=false;} + SingleProducerConsumerType object; + + // Ready to read is so we can use an equality boolean comparison, in case the writePointer var is trashed while context switching. + volatile bool readyToRead; + volatile DataPlusPtr *next; + }; + volatile DataPlusPtr *readAheadPointer; + volatile DataPlusPtr *writeAheadPointer; + volatile DataPlusPtr *readPointer; + volatile DataPlusPtr *writePointer; + unsigned readCount, writeCount; + }; + + template + SingleProducerConsumer::SingleProducerConsumer() + { + // Preallocate + readPointer = RakNet::OP_NEW( _FILE_AND_LINE_ ); + writePointer=readPointer; + readPointer->next = RakNet::OP_NEW( _FILE_AND_LINE_ ); + int listSize; +#ifdef _DEBUG + RakAssert(MINIMUM_LIST_SIZE>=3); +#endif + for (listSize=2; listSize < MINIMUM_LIST_SIZE; listSize++) + { + readPointer=readPointer->next; + readPointer->next = RakNet::OP_NEW( _FILE_AND_LINE_ ); + } + readPointer->next->next=writePointer; // last to next = start + readPointer=writePointer; + readAheadPointer=readPointer; + writeAheadPointer=writePointer; + readCount=writeCount=0; + } + + template + SingleProducerConsumer::~SingleProducerConsumer() + { + volatile DataPlusPtr *next; + readPointer=writeAheadPointer->next; + while (readPointer!=writeAheadPointer) + { + next=readPointer->next; + RakNet::OP_DELETE((char*) readPointer, _FILE_AND_LINE_); + readPointer=next; + } + RakNet::OP_DELETE((char*) readPointer, _FILE_AND_LINE_); + } + + template + SingleProducerConsumerType* SingleProducerConsumer::WriteLock( void ) + { + if (writeAheadPointer->next==readPointer || + writeAheadPointer->next->readyToRead==true) + { + volatile DataPlusPtr *originalNext=writeAheadPointer->next; + writeAheadPointer->next=RakNet::OP_NEW(_FILE_AND_LINE_); + RakAssert(writeAheadPointer->next); + writeAheadPointer->next->next=originalNext; + } + + volatile DataPlusPtr *last; + last=writeAheadPointer; + writeAheadPointer=writeAheadPointer->next; + + return (SingleProducerConsumerType*) last; + } + + template + void SingleProducerConsumer::CancelWriteLock( SingleProducerConsumerType* cancelToLocation ) + { + writeAheadPointer=(DataPlusPtr *)cancelToLocation; + } + + template + void SingleProducerConsumer::WriteUnlock( void ) + { + // DataPlusPtr *dataContainer = (DataPlusPtr *)structure; + +#ifdef _DEBUG + RakAssert(writePointer->next!=readPointer); + RakAssert(writePointer!=writeAheadPointer); +#endif + + writeCount++; + // User is done with the data, allow send by updating the write pointer + writePointer->readyToRead=true; + writePointer=writePointer->next; + } + + template + SingleProducerConsumerType* SingleProducerConsumer::ReadLock( void ) + { + if (readAheadPointer==writePointer || + readAheadPointer->readyToRead==false) + { + return 0; + } + + volatile DataPlusPtr *last; + last=readAheadPointer; + readAheadPointer=readAheadPointer->next; + return (SingleProducerConsumerType*)last; + } + + template + void SingleProducerConsumer::CancelReadLock( SingleProducerConsumerType* cancelToLocation ) + { +#ifdef _DEBUG + RakAssert(readPointer!=writePointer); +#endif + readAheadPointer=(DataPlusPtr *)cancelToLocation; + } + + template + void SingleProducerConsumer::ReadUnlock( void ) + { +#ifdef _DEBUG + RakAssert(readAheadPointer!=readPointer); // If hits, then called ReadUnlock before ReadLock + RakAssert(readPointer!=writePointer); // If hits, then called ReadUnlock when Read returns 0 +#endif + readCount++; + + // Allow writes to this memory block + readPointer->readyToRead=false; + readPointer=readPointer->next; + } + + template + void SingleProducerConsumer::Clear( void ) + { + // Shrink the list down to MINIMUM_LIST_SIZE elements + volatile DataPlusPtr *next; + writePointer=readPointer->next; + + int listSize=1; + next=readPointer->next; + while (next!=readPointer) + { + listSize++; + next=next->next; + } + + while (listSize-- > MINIMUM_LIST_SIZE) + { + next=writePointer->next; +#ifdef _DEBUG + RakAssert(writePointer!=readPointer); +#endif + RakNet::OP_DELETE((char*) writePointer, _FILE_AND_LINE_); + writePointer=next; + } + + readPointer->next=writePointer; + writePointer=readPointer; + readAheadPointer=readPointer; + writeAheadPointer=writePointer; + readCount=writeCount=0; + } + + template + int SingleProducerConsumer::Size( void ) const + { + return writeCount-readCount; + } + + template + bool SingleProducerConsumer::CheckReadUnlockOrder(const SingleProducerConsumerType* data) const + { + return const_cast(&readPointer->object) == data; + } + + + template + bool SingleProducerConsumer::ReadIsLocked(void) const + { + return readAheadPointer!=readPointer; + } +} + +#endif diff --git a/include/raknet/SocketDefines.hpp b/include/raknet/SocketDefines.hpp new file mode 100644 index 0000000..ab975ed --- /dev/null +++ b/include/raknet/SocketDefines.hpp @@ -0,0 +1,122 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __SOCKET_DEFINES_H +#define __SOCKET_DEFINES_H + +/// Internal + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +#if defined(WINDOWS_STORE_RT) + #include "WinRTSocketAdapter.hpp" + #define accept__ WinRTAccept + #define connect__ WinRTConnect + #define closesocket__ WinRTClose + #define socket__ WinRTCreateDatagramSocket + #define bind__ WinRTBind + #define getsockname__ RNS2_WindowsStore8::WinRTGetSockName + #define getsockopt__ WinRTGetSockOpt + #define inet_addr__ RNS2_WindowsStore8::WinRTInet_Addr + #define ioctlsocket__ RNS2_WindowsStore8::WinRTIOCTLSocket + #define listen__ WinRTListen + #define recv__ WinRTRecv + #define recvfrom__ WinRTRecvFrom + #define select__ WinRTSelect + #define send__ WinRTSend + #define sendto__ WinRTSendTo + #define setsockopt__ RNS2_WindowsStore8::WinRTSetSockOpt + #define shutdown__ WinRTShutdown + #define WSASendTo__ WinRTSendTo +#else + + + + + + + #if defined(_WIN32) + #define closesocket__ closesocket + #define select__ select + #elif defined(__native_client__) + // namespace RakNet { void CloseSocket(SOCKET s); } + // #define closesocket__ RakNet::CloseSocket + #define select__ select + #else + #define closesocket__ close + #define select__ select + #endif + #define accept__ accept + #define connect__ connect + + + + #define socket__ socket + + #define bind__ bind + #define getsockname__ getsockname + #define getsockopt__ getsockopt + + + + #define inet_addr__ inet_addr + + #define ioctlsocket__ ioctlsocket + #define listen__ listen + #define recv__ recv + #define recvfrom__ recvfrom + + + + #define sendto__ sendto + + #define send__ send + + + + #define setsockopt__ setsockopt + + #define shutdown__ shutdown + #define WSASendTo__ WSASendTo +#endif + +#endif diff --git a/include/raknet/SocketIncludes.hpp b/include/raknet/SocketIncludes.hpp new file mode 100644 index 0000000..cddcc3c --- /dev/null +++ b/include/raknet/SocketIncludes.hpp @@ -0,0 +1,98 @@ +#ifndef RAKNET_SOCKETINCLUDES_H +#define RAKNET_SOCKETINCLUDES_H + +// All this crap just to include type SOCKET + +#ifdef __native_client__ +#define _PP_Instance_ PP_Instance +#else +#define _PP_Instance_ int +#endif + + + + + + + + + + + + + + + + + + + + +#if defined(WINDOWS_STORE_RT) + #include + #include "WinRTSockAddr.hpp" + typedef Windows::Networking::Sockets::DatagramSocket^ __UDPSOCKET__; + typedef Windows::Networking::Sockets::StreamSocket^ __TCPSOCKET__; + typedef unsigned int socklen_t; + #define FORMAT_MESSAGE_ALLOCATE_BUFFER 0 + #define FIONBIO 0 + #define LocalFree(x) + // using Windows.Networking; + // using Windows.Networking.Sockets; + // See http://msdn.microsoft.com/en-us/library/windows/apps/windows.networking.sockets.datagramsocketcontrol +#elif defined(_WIN32) + // IP_DONTFRAGMENT is different between winsock 1 and winsock 2. Therefore, Winsock2.h must be linked againt Ws2_32.lib + // winsock.h must be linked against WSock32.lib. If these two are mixed up the flag won't work correctly + // WinRT: http://msdn.microsoft.com/en-us/library/windows/apps/windows.networking.sockets + // Sample code: http://stackoverflow.com/questions/10290945/correct-use-of-udp-datagramsocket + #include + typedef SOCKET __UDPSOCKET__; + typedef SOCKET __TCPSOCKET__; + typedef int socklen_t; +#else + #define closesocket close + #include + #include + #include + #include + #include + #include + #include + + #ifdef __native_client__ + #include "ppapi/cpp/private/net_address_private.hpp" + #include "ppapi/c/pp_bool.hpp" + #include "ppapi/c/pp_errors.hpp" + #include "ppapi/cpp/completion_callback.hpp" + #include "ppapi/cpp/instance_handle.hpp" + #include "ppapi/cpp/module.hpp" + #include "ppapi/cpp/module_impl.hpp" + #include "ppapi/c/pp_errors.hpp" + #include "ppapi/c/pp_module.hpp" + #include "ppapi/c/pp_var.hpp" + #include "ppapi/c/pp_resource.hpp" + #include "ppapi/c/ppb.hpp" + #include "ppapi/c/ppb_instance.hpp" + #include "ppapi/c/ppb_messaging.hpp" + #include "ppapi/c/ppb_var.hpp" + #include "ppapi/c/ppp.hpp" + #include "ppapi/c/ppb_core.hpp" + #include "ppapi/c/ppp_instance.hpp" + #include "ppapi/c/ppp_messaging.hpp" + #include "ppapi/c/pp_input_event.hpp" + #include "ppapi/c/pp_completion_callback.hpp" + //UDP specific - the 'private' folder was copied from the chromium src/ppapi/c headers folder + #include "ppapi/c/private/ppb_udp_socket_private.hpp" + #include "ppapi/cpp/private/net_address_private.hpp" + typedef PP_Resource __UDPSOCKET__; + typedef PP_Resource __TCPSOCKET__; + #else + //#include "RakMemoryOverride.hpp" + /// Unix/Linux uses ints for sockets + typedef int __UDPSOCKET__; + typedef int __TCPSOCKET__; +#endif + +#endif + +#endif // RAKNET_SOCKETINCLUDES_H diff --git a/include/raknet/SocketLayer.hpp b/include/raknet/SocketLayer.hpp new file mode 100644 index 0000000..fcefafa --- /dev/null +++ b/include/raknet/SocketLayer.hpp @@ -0,0 +1,197 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief SocketLayer class implementation +/// + + + + +#ifndef __SOCKET_LAYER_H +#define __SOCKET_LAYER_H + +#include "RakMemoryOverride.hpp" +#include "RakNetTypes.hpp" +#include "RakNetSmartPtr.hpp" +//#include "RakNetSocket.hpp" +#include "Export.hpp" +#include "MTUSize.hpp" +#include "RakString.hpp" + +//#include "ClientContextStruct.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeer; + +/* +class RAK_DLL_EXPORT SocketLayerOverride +{ +public: + SocketLayerOverride() {} + virtual ~SocketLayerOverride() {} + + /// Called when SendTo would otherwise occur. + virtual int RakNetSendTo( const char *data, int length, const SystemAddress &systemAddress )=0; + + /// Called when RecvFrom would otherwise occur. Return number of bytes read. Write data into dataOut + // Return -1 to use RakNet's normal recvfrom, 0 to abort RakNet's normal recvfrom, and positive to return data + virtual int RakNetRecvFrom( char dataOut[ MAXIMUM_MTU_SIZE ], SystemAddress *senderOut, bool calledFromMainThread )=0; +}; +*/ + +// A platform independent implementation of Berkeley sockets, with settings used by RakNet +class RAK_DLL_EXPORT SocketLayer +{ + +public: + + /// Default Constructor + SocketLayer(); + + // Destructor + ~SocketLayer(); + + /* + /// Creates a bound socket to listen for incoming connections on the specified port + /// \param[in] port the port number + /// \param[in] blockingSocket + /// \return A new socket used for accepting clients + static RakNetSocket* CreateBoundSocket( RakPeer *peer, unsigned short port, bool blockingSocket, const char *forceHostAddress, unsigned int sleepOn10048, unsigned int extraSocketOptions, unsigned short socketFamily, _PP_Instance_ chromeInstance ); +#if defined(WINDOWS_STORE_RT) + static RakNetSocket* CreateWindowsStore8Socket( RakPeer *peer, unsigned short port, bool blockingSocket, const char *forceHostAddress, unsigned int sleepOn10048, unsigned int extraSocketOptions, _PP_Instance_ chromeInstance ); +#endif + static RakNetSocket* CreateBoundSocket_IPV4( RakPeer *peer, unsigned short port, bool blockingSocket, const char *forceHostAddress, unsigned int sleepOn10048, unsigned int extraSocketOptions, _PP_Instance_ chromeInstance ); + #if RAKNET_SUPPORT_IPV6==1 + static RakNetSocket* CreateBoundSocket_SupportIPV4And6( RakPeer *peer, unsigned short port, bool blockingSocket, const char *forceHostAddress, unsigned int sleepOn10048, unsigned int extraSocketOptions, unsigned short socketFamily, _PP_Instance_ chromeInstance ); + #endif + static RakNetSocket* CreateBoundSocket_PS3Lobby( unsigned short port, bool blockingSocket, const char *forceHostAddress, unsigned short socketFamily ); + static RakNetSocket* CreateBoundSocket_PSP2( unsigned short port, bool blockingSocket, const char *forceHostAddress, unsigned short socketFamily ); + */ + + /* +#ifndef WINDOWS_STORE_RT + /// Returns if this specified port is in use, for UDP + /// \param[in] port the port number + /// \return If this port is already in use + //static bool IsPortInUse_Old(unsigned short port, const char *hostAddress); + //static bool IsPortInUse(unsigned short port, const char *hostAddress, unsigned short socketFamily ); + static bool IsSocketFamilySupported(const char *hostAddress, unsigned short socketFamily); +#endif + */ + +// static const char* DomainNameToIP_Old( const char *domainName ); +// static const char* DomainNameToIP( const char *domainName ); + + /// Write \a data of length \a length to \a writeSocket + /// \param[in] writeSocket The socket to write to + /// \param[in] data The data to write + /// \param[in] length The length of \a data + // static void Write( RakNetSocket*writeSocket, const char* data, const int length ); + + /// Read data from a socket + /// \param[in] s the socket + /// \param[in] rakPeer The instance of rakPeer containing the recvFrom C callback + /// \param[in] errorCode An error code if an error occured . + /// \param[in] connectionSocketIndex Which of the sockets in RakPeer we are using + /// \return Returns true if you successfully read data, false on error. +// static void RecvFromBlocking_IPV4( RakNetSocket *s, RakPeer *rakPeer, char *dataOut, int *bytesReadOut, SystemAddress *systemAddressOut, RakNet::TimeUS *timeRead ); +// #if RAKNET_SUPPORT_IPV6==1 +// static void RecvFromBlockingIPV4And6( RakNetSocket *s, RakPeer *rakPeer, char *dataOut, int *bytesReadOut, SystemAddress *systemAddressOut, RakNet::TimeUS *timeRead ); +// #endif +// static void RecvFromBlocking( RakNetSocket *s, RakPeer *rakPeer, char *dataOut, int *bytesReadOut, SystemAddress *systemAddressOut, RakNet::TimeUS *timeRead ); +#if defined(WINDOWS_STORE_RT) +// static void RecvFromBlocking_WindowsStore8( RakNetSocket *s, RakPeer *rakPeer, char *dataOut, int *bytesReadOut, SystemAddress *systemAddressOut, RakNet::TimeUS *timeRead ); +#endif + + /// Given a socket and IP, retrieves the subnet mask, on linux the socket is unused + /// \param[in] inSock the socket + /// \param[in] inIpString The ip of the interface you wish to retrieve the subnet mask from + /// \return Returns the ip dotted subnet mask if successful, otherwise returns empty string ("") + static RakNet::RakString GetSubNetForSocketAndIp(__UDPSOCKET__ inSock, RakNet::RakString inIpString); + + + /// Sets the socket flags to nonblocking + /// \param[in] listenSocket the socket to set +// static void SetNonBlocking( RakNetSocket* listenSocket); + + + /// Retrieve all local IP address in a string format. + /// \param[in] s The socket whose port we are referring to + /// \param[in] ipList An array of ip address in dotted notation. + static void GetMyIP( SystemAddress addresses[MAXIMUM_NUMBER_OF_INTERNAL_IDS] ); + + + /// Call sendto (UDP obviously) + /// \param[in] s the socket + /// \param[in] data The byte buffer to send + /// \param[in] length The length of the \a data in bytes + /// \param[in] ip The address of the remote host in dotted notation. + /// \param[in] port The port number to send to. + /// \return 0 on success, nonzero on failure. +// static int SendTo( UDPSOCKET s, const char *data, int length, const char ip[ 16 ], unsigned short port, unsigned short remotePortRakNetWasStartedOn_PS3, unsigned int extraSocketOptions, const char *file, const long line ); + + /// Call sendto' (UDP obviously) + /// It won't reach the recipient, except on a LAN + /// However, this is good for opening routers / firewalls + /// \param[in] s the socket + /// \param[in] data The byte buffer to send + /// \param[in] length The length of the \a data in bytes + /// \param[in] ip The address of the remote host in dotted notation. + /// \param[in] port The port number to send to. + /// \param[in] ttl Max hops of datagram + /// \return 0 on success, nonzero on failure. +// static int SendToTTL( RakNetSocket *s, const char *data, int length, SystemAddress &systemAddress, int ttl ); + + /// Call sendto (UDP obviously) + /// \param[in] s the socket + /// \param[in] data The byte buffer to send + /// \param[in] length The length of the \a data in bytes + /// \param[in] binaryAddress The address of the remote host in binary format. + /// \param[in] port The port number to send to. + /// \return 0 on success, nonzero on failure. +// static int SendTo( RakNetSocket *s, const char *data, int length, SystemAddress systemAddress, const char *file, const long line ); + +// static unsigned short GetLocalPort(RakNetSocket *s); + static unsigned short GetLocalPort( __UDPSOCKET__ s); +// static void GetSystemAddress_Old ( RakNetSocket *s, SystemAddress *systemAddressOut ); + static void GetSystemAddress_Old ( __UDPSOCKET__ s, SystemAddress *systemAddressOut ); +// static void GetSystemAddress ( RakNetSocket *s, SystemAddress *systemAddressOut ); + static void GetSystemAddress ( __UDPSOCKET__ s, SystemAddress *systemAddressOut ); + +// static void SetSocketLayerOverride(SocketLayerOverride *_slo); +// static SocketLayerOverride* GetSocketLayerOverride(void) {return slo;} + +// static int SendTo_PS3Lobby( RakNetSocket *s, const char *data, int length, const SystemAddress &systemAddress ); +// static int SendTo_PSP2( RakNetSocket *s, const char *data, int length, const SystemAddress &systemAddress ); +// static int SendTo_360( RakNetSocket *s, const char *data, int length, const char *voiceData, int voiceLength, const SystemAddress &systemAddress ); +// static int SendTo_PC( RakNetSocket *s, const char *data, int length, const SystemAddress &systemAddress, const char *file, const long line ); +// #if defined(WINDOWS_STORE_RT) +// static int SendTo_WindowsStore8( RakNetSocket *s, const char *data, int length, const SystemAddress &systemAddress, const char *file, const long line ); +// #endif +// +// static void SetDoNotFragment( RakNetSocket* listenSocket, int opt ); +// static void SetSocketOptions( RakNetSocket* listenSocket, bool blockingSocket, bool setBroadcast); + static void SetSocketOptions( __UDPSOCKET__ listenSocket, bool blockingSocket, bool setBroadcast); + + + // AF_INET (default). For IPV6, use AF_INET6. To autoselect, use AF_UNSPEC. + static bool GetFirstBindableIP(char firstBindable[128], int ipProto); + +private: + +// static SocketLayerOverride *slo; +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/StatisticsHistory.hpp b/include/raknet/StatisticsHistory.hpp new file mode 100644 index 0000000..73d19da --- /dev/null +++ b/include/raknet/StatisticsHistory.hpp @@ -0,0 +1,235 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file StatisticsHistory.h +/// \brief Input numerical values over time. Get sum, average, highest, lowest, standard deviation on recent or all-time values + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_StatisticsHistory==1 + +#ifndef __STATISTICS_HISTORY_H +#define __STATISTICS_HISTORY_H + +#include "PluginInterface2.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" +#include "DS_List.hpp" +#include "RakNetTypes.hpp" +#include "DS_OrderedList.hpp" +#include "RakString.hpp" +#include "DS_Queue.hpp" +#include "DS_Hash.hpp" +#include + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +// Type used to track values. If needed, change to double and recompile +typedef double SHValueType; +#define SH_TYPE_MAX DBL_MAX + +/// \brief Input numerical values over time. Get sum, average, highest, lowest, standard deviation on recent or all-time values +class RAK_DLL_EXPORT StatisticsHistory +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(StatisticsHistory) + + enum SHErrorCode + { + SH_OK, + SH_UKNOWN_OBJECT, + SH_UKNOWN_KEY, + SH_INVALID_PARAMETER, + }; + + enum SHSortOperation + { + SH_DO_NOT_SORT, + + SH_SORT_BY_RECENT_SUM_ASCENDING, + SH_SORT_BY_RECENT_SUM_DESCENDING, + SH_SORT_BY_LONG_TERM_SUM_ASCENDING, + SH_SORT_BY_LONG_TERM_SUM_DESCENDING, + SH_SORT_BY_RECENT_SUM_OF_SQUARES_ASCENDING, + SH_SORT_BY_RECENT_SUM_OF_SQUARES_DESCENDING, + SH_SORT_BY_RECENT_AVERAGE_ASCENDING, + SH_SORT_BY_RECENT_AVERAGE_DESCENDING, + SH_SORT_BY_LONG_TERM_AVERAGE_ASCENDING, + SH_SORT_BY_LONG_TERM_AVERAGE_DESCENDING, + SH_SORT_BY_RECENT_HIGHEST_ASCENDING, + SH_SORT_BY_RECENT_HIGHEST_DESCENDING, + SH_SORT_BY_RECENT_LOWEST_ASCENDING, + SH_SORT_BY_RECENT_LOWEST_DESCENDING, + SH_SORT_BY_LONG_TERM_HIGHEST_ASCENDING, + SH_SORT_BY_LONG_TERM_HIGHEST_DESCENDING, + SH_SORT_BY_LONG_TERM_LOWEST_ASCENDING, + SH_SORT_BY_LONG_TERM_LOWEST_DESCENDING, + }; + + enum SHDataCategory + { + /// Insert values from one set into the other set, in time order + /// Values at the same time end up in the final set twice + /// Use when you have additional data points to add to a graph + DC_DISCRETE, + + /// Add values from one set to values from the other set, at corresponding times + /// If value at time t does not exist in the other set, linearly extrapolate value for other set based on nearest two data points + /// longTerm* values are unknown using this method + /// Use to add two graphs together + DC_CONTINUOUS + }; + + struct TimeAndValue; + struct TimeAndValueQueue; + + struct TrackedObjectData + { + TrackedObjectData(); + TrackedObjectData(uint64_t _objectId, int _objectType, void *_userData); + uint64_t objectId; + int objectType; + void *userData; + }; + + StatisticsHistory(); + virtual ~StatisticsHistory(); + void SetDefaultTimeToTrack(Time defaultTimeToTrack); + Time GetDefaultTimeToTrack(void) const; + bool AddObject(TrackedObjectData tod); + bool RemoveObject(uint64_t objectId, void **userData); + void RemoveObjectAtIndex(unsigned int index); + void Clear(void); + unsigned int GetObjectCount(void) const; + StatisticsHistory::TrackedObjectData * GetObjectAtIndex(unsigned int index) const; + unsigned int GetObjectIndex(uint64_t objectId) const; + bool AddValueByObjectID(uint64_t objectId, RakString key, SHValueType val, Time curTime, bool combineEqualTimes); + void AddValueByIndex(unsigned int index, RakString key, SHValueType val, Time curTime, bool combineEqualTimes); + SHErrorCode GetHistoryForKey(uint64_t objectId, RakString key, TimeAndValueQueue **values, Time curTime) const; + bool GetHistorySorted(uint64_t objectId, SHSortOperation sortType, DataStructures::List &values) const; + void MergeAllObjectsOnKey(RakString key, TimeAndValueQueue *tavqOutput, SHDataCategory dataCategory) const; + void GetUniqueKeyList(DataStructures::List &keys); + + struct TimeAndValue + { + Time time; + SHValueType val; + }; + + struct TimeAndValueQueue + { + TimeAndValueQueue(); + ~TimeAndValueQueue(); + + DataStructures::Queue values; + + Time timeToTrackValues; + RakString key; + + SHValueType recentSum; + SHValueType recentSumOfSquares; + SHValueType longTermSum; + SHValueType longTermCount; + SHValueType longTermLowest; + SHValueType longTermHighest; + + void SetTimeToTrackValues(Time t); + Time GetTimeToTrackValues(void) const; + SHValueType GetRecentSum(void) const; + SHValueType GetRecentSumOfSquares(void) const; + SHValueType GetLongTermSum(void) const; + SHValueType GetRecentAverage(void) const; + SHValueType GetRecentLowest(void) const; + SHValueType GetRecentHighest(void) const; + SHValueType GetRecentStandardDeviation(void) const; + SHValueType GetLongTermAverage(void) const; + SHValueType GetLongTermLowest(void) const; + SHValueType GetLongTermHighest(void) const; + SHValueType GetSumSinceTime(Time t) const; + Time GetTimeRange(void) const; + + // Merge two sets to output + static void MergeSets( const TimeAndValueQueue *lhs, SHDataCategory lhsDataCategory, const TimeAndValueQueue *rhs, SHDataCategory rhsDataCategory, TimeAndValueQueue *output ); + + // Shrink or expand a sample set to the approximate number given + // DC_DISCRETE will produce a histogram (sum) while DC_CONTINUOUS will produce an average + void ResizeSampleSet( int approximateSamples, DataStructures::Queue &blendedSamples, SHDataCategory dataCategory, Time timeClipStart=0, Time timeClipEnd=0 ); + + // Clear out all values + void Clear(void); + + TimeAndValueQueue& operator = ( const TimeAndValueQueue& input ); + + /// \internal + void CullExpiredValues(Time curTime); + /// \internal + static SHValueType Interpolate(TimeAndValue t1, TimeAndValue t2, Time time); + /// \internal + SHValueType sortValue; + }; + +protected: + struct TrackedObject; +public: + static int TrackedObjectComp( const uint64_t &key, TrackedObject* const &data ); +protected: + + struct TrackedObject + { + TrackedObject(); + ~TrackedObject(); + TrackedObjectData trackedObjectData; + DataStructures::Hash dataQueues; + }; + + DataStructures::OrderedList objects; + + Time timeToTrack; +}; + +/// \brief Input numerical values over time. Get sum, average, highest, lowest, standard deviation on recent or all-time values +/// \ingroup PLUGINS_GROUP +class RAK_DLL_EXPORT StatisticsHistoryPlugin : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(StatisticsHistoryPlugin) + + StatisticsHistory statistics; + + StatisticsHistoryPlugin(); + virtual ~StatisticsHistoryPlugin(); + void SetTrackConnections(bool _addNewConnections, int newConnectionsObjectType, bool _removeLostConnections); + +protected: + virtual void Update(void); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + + // Too slow +// virtual bool UsesReliabilityLayer(void) const {return true;} +// virtual void OnDirectSocketSend(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress); +// virtual void OnDirectSocketReceive(const char *data, const BitSize_t bitsUsed, SystemAddress remoteSystemAddress); + + + bool addNewConnections; + bool removeLostConnections; + int newConnectionsObjectType; +}; + +} // namespace RakNet + +#endif // __STATISTICS_HISTORY_H + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/StringCompressor.hpp b/include/raknet/StringCompressor.hpp new file mode 100644 index 0000000..b77f6fe --- /dev/null +++ b/include/raknet/StringCompressor.hpp @@ -0,0 +1,113 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief \b Compresses/Decompresses ASCII strings and writes/reads them to BitStream class instances. You can use this to easily serialize and deserialize your own strings. +/// + + + +#ifndef __STRING_COMPRESSOR_H +#define __STRING_COMPRESSOR_H + +#include "Export.hpp" +#include "DS_Map.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" + +#ifdef _STD_STRING_COMPRESSOR +#include +#endif + +/// Forward declaration +namespace RakNet +{ + class BitStream; + class RakString; +}; + + +namespace RakNet +{ +/// Forward declarations +class HuffmanEncodingTree; + +/// \brief Writes and reads strings to and from bitstreams. +/// +/// Only works with ASCII strings. The default compression is for English. +/// You can call GenerateTreeFromStrings to compress and decompress other languages efficiently as well. +class RAK_DLL_EXPORT StringCompressor +{ +public: + + // Destructor + ~StringCompressor(); + + /// static function because only static functions can access static members + /// The RakPeer constructor adds a reference to this class, so don't call this until an instance of RakPeer exists, or unless you call AddReference yourself. + /// \return the unique instance of the StringCompressor + static StringCompressor* Instance(void); + + /// Given an array of strings, such as a chat log, generate the optimal encoding tree for it. + /// This function is optional and if it is not called a default tree will be used instead. + /// \param[in] input An array of bytes which should point to text. + /// \param[in] inputLength Length of \a input + /// \param[in] languageID An identifier for the language / string table to generate the tree for. English is automatically created with ID 0 in the constructor. + void GenerateTreeFromStrings( unsigned char *input, unsigned inputLength, uint8_t languageId ); + + /// Writes input to output, compressed. Takes care of the null terminator for you. + /// \param[in] input Pointer to an ASCII string + /// \param[in] maxCharsToWrite The max number of bytes to write of \a input. Use 0 to mean no limit. + /// \param[out] output The bitstream to write the compressed string to + /// \param[in] languageID Which language to use + void EncodeString( const char *input, int maxCharsToWrite, RakNet::BitStream *output, uint8_t languageId=0 ); + + /// Writes input to output, uncompressed. Takes care of the null terminator for you. + /// \param[out] output A block of bytes to receive the output + /// \param[in] maxCharsToWrite Size, in bytes, of \a output . A NULL terminator will always be appended to the output string. If the maxCharsToWrite is not large enough, the string will be truncated. + /// \param[in] input The bitstream containing the compressed string + /// \param[in] languageID Which language to use + bool DecodeString( char *output, int maxCharsToWrite, RakNet::BitStream *input, uint8_t languageId=0 ); + +#ifdef _CSTRING_COMPRESSOR + void EncodeString( const CString &input, int maxCharsToWrite, RakNet::BitStream *output, uint8_t languageId=0 ); + bool DecodeString( CString &output, int maxCharsToWrite, RakNet::BitStream *input, uint8_t languageId=0 ); +#endif + +#ifdef _STD_STRING_COMPRESSOR + void EncodeString( const std::string &input, int maxCharsToWrite, RakNet::BitStream *output, uint8_t languageId=0 ); + bool DecodeString( std::string *output, int maxCharsToWrite, RakNet::BitStream *input, uint8_t languageId=0 ); +#endif + + void EncodeString( const RakNet::RakString *input, int maxCharsToWrite, RakNet::BitStream *output, uint8_t languageId=0 ); + bool DecodeString( RakNet::RakString *output, int maxCharsToWrite, RakNet::BitStream *input, uint8_t languageId=0 ); + + /// Used so I can allocate and deallocate this singleton at runtime + static void AddReference(void); + + /// Used so I can allocate and deallocate this singleton at runtime + static void RemoveReference(void); + + StringCompressor(); + +private: + + /// Singleton instance + static StringCompressor *instance; + + /// Pointer to the huffman encoding trees. + DataStructures::Map huffmanEncodingTrees; + + static int referenceCount; +}; + +} // namespace RakNet + +#endif diff --git a/include/raknet/StringTable.hpp b/include/raknet/StringTable.hpp new file mode 100644 index 0000000..9960340 --- /dev/null +++ b/include/raknet/StringTable.hpp @@ -0,0 +1,104 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief A simple class to encode and decode known strings based on a lookup table. Similar to the StringCompressor class. +/// + + + +#ifndef __STRING_TABLE_H +#define __STRING_TABLE_H + +#include "DS_OrderedList.hpp" +#include "Export.hpp" +#include "RakMemoryOverride.hpp" + +/// Forward declaration +namespace RakNet +{ + class BitStream; +}; + +/// StringTableType should be the smallest type possible, or else it defeats the purpose of the StringTable class, which is to save bandwidth. +typedef unsigned char StringTableType; + +/// The string plus a bool telling us if this string was copied or not. +struct StrAndBool +{ + char *str; + bool b; +}; + +namespace RakNet +{ + int RAK_DLL_EXPORT StrAndBoolComp( char *const &key, const StrAndBool &data ); + + /// \details This is an even more efficient alternative to StringCompressor in that it writes a single byte from a lookup table and only does compression.
    + /// if the string does not already exist in the table.
    + /// All string tables must match on all systems - hence you must add all the strings in the same order on all systems.
    + /// Furthermore, this must be done before sending packets that use this class, since the strings are ordered for fast lookup. Adding after that time would mess up all the indices so don't do it.
    + /// Don't use this class to write strings which were not previously registered with AddString, since you just waste bandwidth then. Use StringCompressor instead. + /// \brief Writes a string index, instead of the whole string + class RAK_DLL_EXPORT StringTable + { + public: + + // Destructor + ~StringTable(); + + /// static function because only static functions can access static members + /// The RakPeer constructor adds a reference to this class, so don't call this until an instance of RakPeer exists, or unless you call AddReference yourself. + /// \return the unique instance of the StringTable + static StringTable* Instance(void); + + /// Add a string to the string table. + /// \param[in] str The string to add to the string table + /// \param[in] copyString true to make a copy of the passed string (takes more memory), false to not do so (if your string is in static memory). + void AddString(const char *str, bool copyString); + + /// Writes input to output, compressed. Takes care of the null terminator for you. + /// Relies on the StringCompressor class, which is automatically reference counted in the constructor and destructor in RakPeer. You can call the reference counting functions yourself if you wish too. + /// \param[in] input Pointer to an ASCII string + /// \param[in] maxCharsToWrite The size of \a input + /// \param[out] output The bitstream to write the compressed string to + void EncodeString( const char *input, int maxCharsToWrite, RakNet::BitStream *output ); + + /// Writes input to output, uncompressed. Takes care of the null terminator for you. + /// Relies on the StringCompressor class, which is automatically reference counted in the constructor and destructor in RakPeer. You can call the reference counting functions yourself if you wish too. + /// \param[out] output A block of bytes to receive the output + /// \param[in] maxCharsToWrite Size, in bytes, of \a output . A NULL terminator will always be appended to the output string. If the maxCharsToWrite is not large enough, the string will be truncated. + /// \param[in] input The bitstream containing the compressed string + bool DecodeString( char *output, int maxCharsToWrite, RakNet::BitStream *input ); + + /// Used so I can allocate and deallocate this singleton at runtime + static void AddReference(void); + + /// Used so I can allocate and deallocate this singleton at runtime + static void RemoveReference(void); + + /// Private Constructor + StringTable(); + + protected: + /// Called when you mess up and send a string using this class that was not registered with AddString + /// \param[in] maxCharsToWrite Size, in bytes, of \a output . A NULL terminator will always be appended to the output string. If the maxCharsToWrite is not large enough, the string will be truncated. + void LogStringNotFound(const char *strName); + + /// Singleton instance + static StringTable *instance; + static int referenceCount; + + DataStructures::OrderedList orderedStringList; + }; +} + + +#endif diff --git a/include/raknet/SuperFastHash.hpp b/include/raknet/SuperFastHash.hpp new file mode 100644 index 0000000..d473756 --- /dev/null +++ b/include/raknet/SuperFastHash.hpp @@ -0,0 +1,27 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __SUPER_FAST_HASH_H +#define __SUPER_FAST_HASH_H + +#include +#include "NativeTypes.hpp" + +// From http://www.azillionmonkeys.com/qed/hash.html +// Author of main code is Paul Hsieh +// I just added some convenience functions +// Also note http://burtleburtle.net/bob/hash/doobs.html, which shows that this is 20% faster than the one on that page but has more collisions + +uint32_t SuperFastHash (const char * data, int length); +uint32_t SuperFastHashIncremental (const char * data, int len, unsigned int lastHash ); +uint32_t SuperFastHashFile (const char * filename); +uint32_t SuperFastHashFilePtr (FILE *fp); + +#endif diff --git a/include/raknet/TCPInterface.hpp b/include/raknet/TCPInterface.hpp new file mode 100644 index 0000000..c1cdd45 --- /dev/null +++ b/include/raknet/TCPInterface.hpp @@ -0,0 +1,263 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief A simple TCP based server allowing sends and receives. Can be connected by any TCP client, including telnet. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_TCPInterface==1 + +#ifndef __SIMPLE_TCP_SERVER +#define __SIMPLE_TCP_SERVER + +#include "RakMemoryOverride.hpp" +#include "DS_List.hpp" +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "RakThread.hpp" +#include "DS_Queue.hpp" +#include "SimpleMutex.hpp" +#include "RakNetDefines.hpp" +#include "SocketIncludes.hpp" +#include "DS_ByteQueue.hpp" +#include "DS_ThreadsafeAllocatingQueue.hpp" +#include "LocklessTypes.hpp" +#include "PluginInterface2.hpp" + +#if OPEN_SSL_CLIENT_SUPPORT==1 +#include +#include +#include +#include +#include +#endif + +namespace RakNet +{ +/// Forward declarations +struct RemoteClient; + +/// \internal +/// \brief As the name says, a simple multithreaded TCP server. Used by TelnetTransport +class RAK_DLL_EXPORT TCPInterface +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(TCPInterface) + + TCPInterface(); + virtual ~TCPInterface(); + + // TODO - add socketdescriptor + /// Starts the TCP server on the indicated port + /// \param[in] port Which port to listen on. + /// \param[in] maxIncomingConnections Max incoming connections we will accept + /// \param[in] maxConnections Max total connections, which should be >= maxIncomingConnections + /// \param[in] threadPriority Passed to the thread creation routine. Use THREAD_PRIORITY_NORMAL for Windows. For Linux based systems, you MUST pass something reasonable based on the thread priorities for your application. + /// \param[in] socketFamily IP version: For IPV4, use AF_INET (default). For IPV6, use AF_INET6. To autoselect, use AF_UNSPEC. + bool Start(unsigned short port, unsigned short maxIncomingConnections, unsigned short maxConnections=0, int _threadPriority=-99999, unsigned short socketFamily=AF_INET, const char *bindAddress=0); + + /// Stops the TCP server + void Stop(void); + + /// Connect to the specified host on the specified port + SystemAddress Connect(const char* host, unsigned short remotePort, bool block=true, unsigned short socketFamily=AF_INET, const char *bindAddress=0); + +#if OPEN_SSL_CLIENT_SUPPORT==1 + /// Start SSL on an existing connection, notified with HasCompletedConnectionAttempt + void StartSSLClient(SystemAddress systemAddress); + + /// Was SSL started on this socket? + bool IsSSLActive(SystemAddress systemAddress); +#endif + + /// Sends a byte stream + virtual void Send( const char *data, unsigned int length, const SystemAddress &systemAddress, bool broadcast ); + + // Sends a concatenated list of byte streams + virtual bool SendList( const char **data, const unsigned int *lengths, const int numParameters, const SystemAddress &systemAddress, bool broadcast ); + + // Get how many bytes are waiting to be sent. If too many, you may want to skip sending + unsigned int GetOutgoingDataBufferSize(SystemAddress systemAddress) const; + + /// Returns if Receive() will return data + /// Do not use on PacketizedTCP + virtual bool ReceiveHasPackets( void ); + + /// Returns data received + virtual Packet* Receive( void ); + + /// Disconnects a player/address + void CloseConnection( SystemAddress systemAddress ); + + /// Deallocates a packet returned by Receive + void DeallocatePacket( Packet *packet ); + + /// Fills the array remoteSystems with the SystemAddress of all the systems we are connected to + /// \param[out] remoteSystems An array of SystemAddress structures to be filled with the SystemAddresss of the systems we are connected to. Pass 0 to remoteSystems to only get the number of systems we are connected to + /// \param[in, out] numberOfSystems As input, the size of remoteSystems array. As output, the number of elements put into the array + void GetConnectionList( SystemAddress *remoteSystems, unsigned short *numberOfSystems ) const; + + /// Returns just the number of connections we have + unsigned short GetConnectionCount(void) const; + + /// Has a previous call to connect succeeded? + /// \return UNASSIGNED_SYSTEM_ADDRESS = no. Anything else means yes. + SystemAddress HasCompletedConnectionAttempt(void); + + /// Has a previous call to connect failed? + /// \return UNASSIGNED_SYSTEM_ADDRESS = no. Anything else means yes. + SystemAddress HasFailedConnectionAttempt(void); + + /// Queued events of new incoming connections + SystemAddress HasNewIncomingConnection(void); + + /// Queued events of lost connections + SystemAddress HasLostConnection(void); + + /// Return an allocated but empty packet, for custom use + Packet* AllocatePacket(unsigned dataSize); + + // Push a packet back to the queue + virtual void PushBackPacket( Packet *packet, bool pushAtHead ); + + /// Returns if Start() was called successfully + bool WasStarted(void) const; + + void AttachPlugin( PluginInterface2 *plugin ); + void DetachPlugin( PluginInterface2 *plugin ); +protected: + + Packet* ReceiveInt( void ); + +#if defined(WINDOWS_STORE_RT) + bool CreateListenSocket_WinStore8(unsigned short port, unsigned short maxIncomingConnections, unsigned short socketFamily, const char *hostAddress); +#else + bool CreateListenSocket(unsigned short port, unsigned short maxIncomingConnections, unsigned short socketFamily, const char *hostAddress); +#endif + + // Plugins + DataStructures::List messageHandlerList; + + RakNet::LocklessUint32_t isStarted, threadRunning; + __TCPSOCKET__ listenSocket; + + DataStructures::Queue headPush, tailPush; + RemoteClient* remoteClients; + int remoteClientsLength; + + // Assuming remoteClients is only used by one thread! + // DataStructures::List remoteClients; + // Use this thread-safe queue to add to remoteClients + // DataStructures::Queue remoteClientsInsertionQueue; + // SimpleMutex remoteClientsInsertionQueueMutex; + + /* + struct OutgoingMessage + { + unsigned char* data; + SystemAddress systemAddress; + bool broadcast; + unsigned int length; + }; + */ +// DataStructures::SingleProducerConsumer outgoingMessages; +// DataStructures::SingleProducerConsumer incomingMessages; +// DataStructures::SingleProducerConsumer newIncomingConnections, lostConnections, requestedCloseConnections; +// DataStructures::SingleProducerConsumer newRemoteClients; +// DataStructures::ThreadsafeAllocatingQueue outgoingMessages; + DataStructures::ThreadsafeAllocatingQueue incomingMessages; + DataStructures::ThreadsafeAllocatingQueue newIncomingConnections, lostConnections, requestedCloseConnections; + DataStructures::ThreadsafeAllocatingQueue newRemoteClients; + SimpleMutex completedConnectionAttemptMutex, failedConnectionAttemptMutex; + DataStructures::Queue completedConnectionAttempts, failedConnectionAttempts; + + int threadPriority; + + DataStructures::List<__TCPSOCKET__> blockingSocketList; + SimpleMutex blockingSocketListMutex; + + + + + + friend RAK_THREAD_DECLARATION(UpdateTCPInterfaceLoop); + friend RAK_THREAD_DECLARATION(ConnectionAttemptLoop); + +// void DeleteRemoteClient(RemoteClient *remoteClient, fd_set *exceptionFD); +// void InsertRemoteClient(RemoteClient* remoteClient); + __TCPSOCKET__ SocketConnect(const char* host, unsigned short remotePort, unsigned short socketFamily, const char *bindAddress); + + struct ThisPtrPlusSysAddr + { + TCPInterface *tcpInterface; + SystemAddress systemAddress; + bool useSSL; + char bindAddress[64]; + unsigned short socketFamily; + }; + +#if OPEN_SSL_CLIENT_SUPPORT==1 + SSL_CTX* ctx; + SSL_METHOD *meth; + DataStructures::ThreadsafeAllocatingQueue startSSL; + DataStructures::List activeSSLConnections; + SimpleMutex sharedSslMutex; +#endif +}; + +/// Stores information about a remote client. +struct RemoteClient +{ + RemoteClient() { +#if OPEN_SSL_CLIENT_SUPPORT==1 + ssl=0; +#endif + isActive=false; +#if !defined(WINDOWS_STORE_RT) + socket=0; +#endif + } + __TCPSOCKET__ socket; + SystemAddress systemAddress; + DataStructures::ByteQueue outgoingData; + bool isActive; + SimpleMutex outgoingDataMutex; + SimpleMutex isActiveMutex; + +#if OPEN_SSL_CLIENT_SUPPORT==1 + SSL* ssl; + bool InitSSL(SSL_CTX* ctx, SSL_METHOD *meth); + void DisconnectSSL(void); + void FreeSSL(void); + int Send(const char *data, unsigned int length); + int Recv(char *data, const int dataSize); +#else + int Send(const char *data, unsigned int length); + int Recv(char *data, const int dataSize); +#endif + void Reset(void) + { + outgoingDataMutex.Lock(); + outgoingData.Clear(_FILE_AND_LINE_); + outgoingDataMutex.Unlock(); + } + void SetActive(bool a); + void SendOrBuffer(const char **data, const unsigned int *lengths, const int numParameters); +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* + diff --git a/include/raknet/TableSerializer.hpp b/include/raknet/TableSerializer.hpp new file mode 100644 index 0000000..ba2f67f --- /dev/null +++ b/include/raknet/TableSerializer.hpp @@ -0,0 +1,218 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __TABLE_SERIALIZER_H +#define __TABLE_SERIALIZER_H + +#include "RakMemoryOverride.hpp" +#include "DS_Table.hpp" +#include "Export.hpp" + +namespace RakNet +{ + class BitStream; +} + +namespace RakNet +{ + +class RAK_DLL_EXPORT TableSerializer +{ +public: + static void SerializeTable(DataStructures::Table *in, RakNet::BitStream *out); + static bool DeserializeTable(unsigned char *serializedTable, unsigned int dataLength, DataStructures::Table *out); + static bool DeserializeTable(RakNet::BitStream *in, DataStructures::Table *out); + static void SerializeColumns(DataStructures::Table *in, RakNet::BitStream *out); + static void SerializeColumns(DataStructures::Table *in, RakNet::BitStream *out, DataStructures::List &skipColumnIndices); + static bool DeserializeColumns(RakNet::BitStream *in, DataStructures::Table *out); + static void SerializeRow(DataStructures::Table::Row *in, unsigned keyIn, const DataStructures::List &columns, RakNet::BitStream *out); + static void SerializeRow(DataStructures::Table::Row *in, unsigned keyIn, const DataStructures::List &columns, RakNet::BitStream *out, DataStructures::List &skipColumnIndices); + static bool DeserializeRow(RakNet::BitStream *in, DataStructures::Table *out); + static void SerializeCell(RakNet::BitStream *out, DataStructures::Table::Cell *cell, DataStructures::Table::ColumnType columnType); + static bool DeserializeCell(RakNet::BitStream *in, DataStructures::Table::Cell *cell, DataStructures::Table::ColumnType columnType); + static void SerializeFilterQuery(RakNet::BitStream *in, DataStructures::Table::FilterQuery *query); + // Note that this allocates query->cell->c! + static bool DeserializeFilterQuery(RakNet::BitStream *out, DataStructures::Table::FilterQuery *query); + static void SerializeFilterQueryList(RakNet::BitStream *in, DataStructures::Table::FilterQuery *query, unsigned int numQueries, unsigned int maxQueries); + // Note that this allocates queries, cells, and query->cell->c!. Use DeallocateQueryList to free. + static bool DeserializeFilterQueryList(RakNet::BitStream *out, DataStructures::Table::FilterQuery **query, unsigned int *numQueries, unsigned int maxQueries, int allocateExtraQueries=0); + static void DeallocateQueryList(DataStructures::Table::FilterQuery *query, unsigned int numQueries); +}; + +} // namespace RakNet + +#endif + +// Test code for the table +/* +#include "LightweightDatabaseServer.hpp" +#include "LightweightDatabaseClient.hpp" +#include "TableSerializer.hpp" +#include "BitStream.hpp" +#include "StringCompressor.hpp" +#include "DS_Table.hpp" +void main(void) +{ + DataStructures::Table table; + DataStructures::Table::Row *row; + unsigned int dummydata=12345; + + // Add columns Name (string), IP (binary), score (int), and players (int). + table.AddColumn("Name", DataStructures::Table::STRING); + table.AddColumn("IP", DataStructures::Table::BINARY); + table.AddColumn("Score", DataStructures::Table::NUMERIC); + table.AddColumn("Players", DataStructures::Table::NUMERIC); + table.AddColumn("Empty Test Column", DataStructures::Table::STRING); + RakAssert(table.GetColumnCount()==5); + row=table.AddRow(0); + RakAssert(row); + row->UpdateCell(0,"Kevin Jenkins"); + row->UpdateCell(1,sizeof(dummydata), (char*)&dummydata); + row->UpdateCell(2,5); + row->UpdateCell(3,10); + //row->UpdateCell(4,"should be unique"); + + row=table.AddRow(1); + row->UpdateCell(0,"Kevin Jenkins"); + row->UpdateCell(1,sizeof(dummydata), (char*)&dummydata); + row->UpdateCell(2,5); + row->UpdateCell(3,15); + + row=table.AddRow(2); + row->UpdateCell(0,"Kevin Jenkins"); + row->UpdateCell(1,sizeof(dummydata), (char*)&dummydata); + row->UpdateCell(2,5); + row->UpdateCell(3,20); + + row=table.AddRow(3); + RakAssert(row); + row->UpdateCell(0,"Kevin Jenkins"); + row->UpdateCell(1,sizeof(dummydata), (char*)&dummydata); + row->UpdateCell(2,15); + row->UpdateCell(3,5); + row->UpdateCell(4,"col index 4"); + + row=table.AddRow(4); + RakAssert(row); + row->UpdateCell(0,"Kevin Jenkins"); + row->UpdateCell(1,sizeof(dummydata), (char*)&dummydata); + //row->UpdateCell(2,25); + row->UpdateCell(3,30); + //row->UpdateCell(4,"should be unique"); + + row=table.AddRow(5); + RakAssert(row); + row->UpdateCell(0,"Kevin Jenkins"); + row->UpdateCell(1,sizeof(dummydata), (char*)&dummydata); + //row->UpdateCell(2,25); + row->UpdateCell(3,5); + //row->UpdateCell(4,"should be unique"); + + row=table.AddRow(6); + RakAssert(row); + row->UpdateCell(0,"Kevin Jenkins"); + row->UpdateCell(1,sizeof(dummydata), (char*)&dummydata); + row->UpdateCell(2,35); + //row->UpdateCell(3,40); + //row->UpdateCell(4,"should be unique"); + + row=table.AddRow(7); + RakAssert(row); + row->UpdateCell(0,"Bob Jenkins"); + + row=table.AddRow(8); + RakAssert(row); + row->UpdateCell(0,"Zack Jenkins"); + + // Test multi-column sorting + DataStructures::Table::Row *rows[30]; + DataStructures::Table::SortQuery queries[4]; + queries[0].columnIndex=0; + queries[0].operation=DataStructures::Table::QS_INCREASING_ORDER; + queries[1].columnIndex=1; + queries[1].operation=DataStructures::Table::QS_INCREASING_ORDER; + queries[2].columnIndex=2; + queries[2].operation=DataStructures::Table::QS_INCREASING_ORDER; + queries[3].columnIndex=3; + queries[3].operation=DataStructures::Table::QS_DECREASING_ORDER; + table.SortTable(queries, 4, rows); + unsigned i; + char out[256]; + RAKNET_DEBUG_PRINTF("Sort: Ascending except for column index 3\n"); + for (i=0; i < table.GetRowCount(); i++) + { + table.PrintRow(out,256,',',true, rows[i]); + RAKNET_DEBUG_PRINTF("%s\n", out); + } + + // Test query: + // Don't return column 3, and swap columns 0 and 2 + unsigned columnsToReturn[4]; + columnsToReturn[0]=2; + columnsToReturn[1]=1; + columnsToReturn[2]=0; + columnsToReturn[3]=4; + DataStructures::Table resultsTable; + table.QueryTable(columnsToReturn,4,0,0,&resultsTable); + RAKNET_DEBUG_PRINTF("Query: Don't return column 3, and swap columns 0 and 2:\n"); + for (i=0; i < resultsTable.GetRowCount(); i++) + { + resultsTable.PrintRow(out,256,',',true, resultsTable.GetRowByIndex(i)); + RAKNET_DEBUG_PRINTF("%s\n", out); + } + + // Test filter: + // Only return rows with column index 4 empty + DataStructures::Table::FilterQuery inclusionFilters[3]; + inclusionFilters[0].columnIndex=4; + inclusionFilters[0].operation=DataStructures::Table::QF_IS_EMPTY; + // inclusionFilters[0].cellValue; // Unused for IS_EMPTY + table.QueryTable(0,0,inclusionFilters,1,&resultsTable); + RAKNET_DEBUG_PRINTF("Filter: Only return rows with column index 4 empty:\n"); + for (i=0; i < resultsTable.GetRowCount(); i++) + { + resultsTable.PrintRow(out,256,',',true, resultsTable.GetRowByIndex(i)); + RAKNET_DEBUG_PRINTF("%s\n", out); + } + + // Column 5 empty and column 0 == Kevin Jenkins + inclusionFilters[0].columnIndex=4; + inclusionFilters[0].operation=DataStructures::Table::QF_IS_EMPTY; + inclusionFilters[1].columnIndex=0; + inclusionFilters[1].operation=DataStructures::Table::QF_EQUAL; + inclusionFilters[1].cellValue.Set("Kevin Jenkins"); + table.QueryTable(0,0,inclusionFilters,2,&resultsTable); + RAKNET_DEBUG_PRINTF("Filter: Column 5 empty and column 0 == Kevin Jenkins:\n"); + for (i=0; i < resultsTable.GetRowCount(); i++) + { + resultsTable.PrintRow(out,256,',',true, resultsTable.GetRowByIndex(i)); + RAKNET_DEBUG_PRINTF("%s\n", out); + } + + RakNet::BitStream bs; + RAKNET_DEBUG_PRINTF("PreSerialize:\n"); + for (i=0; i < table.GetRowCount(); i++) + { + table.PrintRow(out,256,',',true, table.GetRowByIndex(i)); + RAKNET_DEBUG_PRINTF("%s\n", out); + } + StringCompressor::AddReference(); + TableSerializer::Serialize(&table, &bs); + TableSerializer::Deserialize(&bs, &table); + StringCompressor::RemoveReference(); + RAKNET_DEBUG_PRINTF("PostDeserialize:\n"); + for (i=0; i < table.GetRowCount(); i++) + { + table.PrintRow(out,256,',',true, table.GetRowByIndex(i)); + RAKNET_DEBUG_PRINTF("%s\n", out); + } + int a=5; +} +*/ diff --git a/include/raknet/TeamBalancer.hpp b/include/raknet/TeamBalancer.hpp new file mode 100644 index 0000000..95a0b58 --- /dev/null +++ b/include/raknet/TeamBalancer.hpp @@ -0,0 +1,206 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file TeamBalancer.h +/// \brief Set and network team selection (supports peer to peer or client/server) +/// \details Automatically handles transmission and resolution of team selection, including team switching and balancing +/// \deprecated Use TeamManager intead +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_TeamBalancer==1 + +#ifndef __TEAM_BALANCER_H +#define __TEAM_BALANCER_H + +#include "PluginInterface2.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" +#include "DS_List.hpp" +#include "RakString.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \defgroup TEAM_BALANCER_GROUP TeamBalancer +/// \brief Set and network team selection (supports peer to peer or client/server) +/// \details Automatically handles transmission and resolution of team selection, including team switching and balancing +/// \deprecated Use TeamManager intead +/// \ingroup PLUGINS_GROUP + +/// 0...254 for your team number identifiers. 255 is reserved as undefined. +/// \deprecated Use TeamManager intead +/// \ingroup TEAM_BALANCER_GROUP +typedef unsigned char TeamId; + +#define UNASSIGNED_TEAM_ID 255 + +/// \brief Set and network team selection (supports peer to peer or client/server) +/// \details Automatically handles transmission and resolution of team selection, including team switching and balancing.
    +/// Usage: TODO +/// \deprecated Use TeamManager intead +/// \ingroup TEAM_BALANCER_GROUP +class RAK_DLL_EXPORT TeamBalancer : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(TeamBalancer) + + TeamBalancer(); + virtual ~TeamBalancer(); + + /// \brief Set the limit to the number of players on the specified team + /// \details SetTeamSizeLimit() must be called on the host, so the host can enforce the maximum number of players on each team. + /// SetTeamSizeLimit() can be called on all systems if desired - for example, in a P2P environment you may wish to call it on all systems in advanced in case you become host. + /// \param[in] team Which team to set the limit for + /// \param[in] limit The maximum number of people on this team + void SetTeamSizeLimit(TeamId team, unsigned short limit); + + enum DefaultAssigmentAlgorithm + { + /// Among all the teams, join the team with the smallest number of players + SMALLEST_TEAM, + /// Join the team with the lowest index that has open slots. + FILL_IN_ORDER + }; + /// \brief Determine how players' teams will be set when they call RequestAnyTeam() + /// \details Based on the specified enumeration, a player will join a team automatically + /// Defaults to SMALLEST_TEAM + /// This function is only used by the host + /// \param[in] daa Enumeration describing the algorithm to use + void SetDefaultAssignmentAlgorithm(DefaultAssigmentAlgorithm daa); + + /// \brief By default, teams can be unbalanced up to the team size limit defined by SetTeamSizeLimits() + /// \details If SetForceEvenTeams(true) is called on the host, then teams cannot be unbalanced by more than 1 player + /// If teams are uneven at the time that SetForceEvenTeams(true) is called, players at randomly will be switched, and will be notified of ID_TEAM_BALANCER_TEAM_ASSIGNED + /// If players disconnect from the host such that teams would not be even, and teams are not locked, then a player from the largest team is randomly moved to even the teams. + /// Defaults to false + /// \note SetLockTeams(true) takes priority over SetForceEvenTeams(), so if teams are currently locked, this function will have no effect until teams become unlocked. + /// \param[in] force True to force even teams. False to allow teams to not be evenly matched + void SetForceEvenTeams(bool force); + + /// \brief If set, calls to RequestSpecificTeam() and RequestAnyTeam() will return the team you are currently on. + /// \details However, if those functions are called and you do not have a team, then you will be assigned to a default team according to SetDefaultAssignmentAlgorithm() and possibly SetForceEvenTeams(true) + /// If \a lock is false, and SetForceEvenTeams() was called with \a force as true, and teams are currently uneven, they will be made even, and those players randomly moved will get ID_TEAM_BALANCER_TEAM_ASSIGNED + /// Defaults to false + /// \param[in] lock True to lock teams, false to unlock + void SetLockTeams(bool lock); + + /// Set your requested team. UNASSIGNED_TEAM_ID means no team. + /// After enough time for network communication, ID_TEAM_BALANCER_SET_TEAM will be returned with your current team, or + /// If team switch is not possible, ID_TEAM_BALANCER_REQUESTED_TEAM_CHANGE_PENDING or ID_TEAM_BALANCER_TEAMS_LOCKED will be returned. + /// In the case of ID_TEAM_BALANCER_REQUESTED_TEAM_CHANGE_PENDING the request will stay in memory. ID_TEAM_BALANCER_SET_TEAM will be returned when someone on the desired team leaves or wants to switch to your team. + /// If SetLockTeams(true) is called while you have a request pending, you will get ID_TEAM_BALANCER_TEAMS_LOCKED + /// \pre Call SetTeamSizeLimits() on the host and call SetHostGuid() on this system. If the host is not running the TeamBalancer plugin or did not have SetTeamSizeLimits() called, then you will not get any response. + /// \param[in] memberId If there is more than one player per computer, this number identifies that player. Use any consistent value, such as UNASSIGNED_NETWORK_ID if there is only one player. + /// \param[in] desiredTeam An index representing your team number. The index should range from 0 to one less than the size of the list passed to SetTeamSizeLimits() on the host. You can also pass UNASSIGNED_TEAM_ID to not be on any team (such as if spectating) + void RequestSpecificTeam(NetworkID memberId, TeamId desiredTeam); + + /// If ID_TEAM_BALANCER_REQUESTED_TEAM_CHANGE_PENDING is returned after a call to RequestSpecificTeam(), the request will stay in memory on the host and execute when available, or until the teams become locked. + /// You can cancel the request by calling CancelRequestSpecificTeam(), in which case you will stay on your existing team. + /// \note Due to latency, even after calling CancelRequestSpecificTeam() you may still get ID_TEAM_BALANCER_SET_TEAM if the packet was already in transmission. + /// \param[in] memberId If there is more than one player per computer, this number identifies that player. Use any consistent value, such as UNASSIGNED_NETWORK_ID if there is only one player. + void CancelRequestSpecificTeam(NetworkID memberId); + + /// Allow host to pick your team, based on whatever algorithm it uses for default team assignments. + /// This only has an effect if you are not currently on a team (GetMyTeam() returns UNASSIGNED_TEAM_ID) + /// \pre Call SetTeamSizeLimits() on the host and call SetHostGuid() on this system + /// \param[in] memberId If there is more than one player per computer, this number identifies that player. Use any consistent value, such as UNASSIGNED_NETWORK_ID if there is only one player. + void RequestAnyTeam(NetworkID memberId); + + /// Returns your team. + /// As your team changes, you are notified through the ID_TEAM_BALANCER_TEAM_ASSIGNED packet in byte 1. + /// Returns UNASSIGNED_TEAM_ID initially + /// \pre For this to return anything other than UNASSIGNED_TEAM_ID, connect to a properly initialized host and RequestSpecificTeam() or RequestAnyTeam() first + /// \param[in] memberId If there is more than one player per computer, this number identifies that player. Use any consistent value, such as UNASSIGNED_NETWORK_ID if there is only one player. + /// \return UNASSIGNED_TEAM_ID for no team. Otherwise, the index should range from 0 to one less than the size of the list passed to SetTeamSizeLimits() on the host + TeamId GetMyTeam(NetworkID memberId) const; + + /// If you called RequestSpecificTeam() or RequestAnyTeam() with a value for \a memberId that + /// Has since been deleted, call DeleteMember(). to notify this plugin of that event. + /// Not necessary with only one team member per system + /// \param[in] memberId If there is more than one player per computer, this number identifies that player. Use any consistent value, such as UNASSIGNED_NETWORK_ID if there is only one player. + void DeleteMember(NetworkID memberId); + + struct TeamMember + { + RakNetGUID memberGuid; + NetworkID memberId; + TeamId currentTeam; + TeamId requestedTeam; + }; + struct MyTeamMembers + { + NetworkID memberId; + TeamId currentTeam; + TeamId requestedTeam; + }; + +protected: + + /// \internal + virtual PluginReceiveResult OnReceive(Packet *packet); + /// \internal + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + /// \internal + void OnAttach(void); + + void OnStatusUpdateToNewHost(Packet *packet); + void OnCancelTeamRequest(Packet *packet); + void OnRequestAnyTeam(Packet *packet); + void OnRequestSpecificTeam(Packet *packet); + + RakNetGUID hostGuid; + DefaultAssigmentAlgorithm defaultAssigmentAlgorithm; + bool forceTeamsToBeEven; + bool lockTeams; + // So if we lose the connection while processing, we request the same info of the new host + DataStructures::List myTeamMembers; + + DataStructures::List teamLimits; + DataStructures::List teamMemberCounts; + DataStructures::List teamMembers; + unsigned int GetMemberIndex(NetworkID memberId, RakNetGUID guid) const; + unsigned int AddTeamMember(const TeamMember &tm); // Returns index of new member + void RemoveTeamMember(unsigned int index); + void EvenTeams(void); + unsigned int GetMemberIndexToSwitchTeams(const DataStructures::List &sourceTeamNumbers, TeamId targetTeamNumber); + void GetOverpopulatedTeams(DataStructures::List &overpopulatedTeams, int maxTeamSize); + void SwitchMemberTeam(unsigned int teamMemberIndex, TeamId destinationTeam); + void NotifyTeamAssigment(unsigned int teamMemberIndex); + bool WeAreHost(void) const; + PluginReceiveResult OnTeamAssigned(Packet *packet); + PluginReceiveResult OnRequestedTeamChangePending(Packet *packet); + PluginReceiveResult OnTeamsLocked(Packet *packet); + void GetMinMaxTeamMembers(int &minMembersOnASingleTeam, int &maxMembersOnASingleTeam); + TeamId GetNextDefaultTeam(void); // Accounting for team balancing and team limits, get the team a player should be placed on + bool TeamWouldBeOverpopulatedOnAddition(TeamId teamId, unsigned int teamMemberSize); // Accounting for team balancing and team limits, would this team be overpopulated if a member was added to it? + bool TeamWouldBeUnderpopulatedOnLeave(TeamId teamId, unsigned int teamMemberSize); + TeamId GetSmallestNonFullTeam(void) const; + TeamId GetFirstNonFullTeam(void) const; + void MoveMemberThatWantsToJoinTeam(TeamId teamId); + TeamId MoveMemberThatWantsToJoinTeamInternal(TeamId teamId); + void NotifyTeamsLocked(RakNetGUID target, TeamId requestedTeam); + void NotifyTeamSwitchPending(RakNetGUID target, TeamId requestedTeam, NetworkID memberId); + void NotifyNoTeam(NetworkID memberId, RakNetGUID target); + void SwapTeamMembersByRequest(unsigned int memberIndex1, unsigned int memberIndex2); + void RemoveByGuid(RakNetGUID rakNetGUID); + bool TeamsWouldBeEvenOnSwitch(TeamId t1, TeamId t2); + +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/TeamManager.hpp b/include/raknet/TeamManager.hpp new file mode 100644 index 0000000..45c8809 --- /dev/null +++ b/include/raknet/TeamManager.hpp @@ -0,0 +1,757 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +// TODO: optimize the list of teams and team members to be O(1). Store in hashes, use linked lists to get ordered traversal + +/// \file TeamManager.h +/// \brief Automates networking and list management for teams +/// \details TeamManager provides support for teams. A team is a list of team members. +/// Teams contain properties including the number of team members per team, whether or not tagged teams must have equal numbers of members, and if a team is locked or not to certain entry conditions +/// Team members contain properties including which teams they are on and which teams they want to join if a team is not immediately joinable +/// Advanced functionality includes the ability for a team member to be on multiple teams simultaneously, the ability to swap teams with other members, and the ability to resize the number of members supported per team +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_TeamManager==1 + +#ifndef __TEAM_MANAGER_H +#define __TEAM_MANAGER_H + +#include "PluginInterface2.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" +#include "DS_List.hpp" +#include "RakNetTypes.hpp" +#include "DS_Hash.hpp" +#include "DS_OrderedList.hpp" + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \defgroup TEAM_MANAGER_GROUP TeamManager +/// \brief Automates networking and list management for teams +/// \details When used with ReplicaManager3 and FullyConnectedMesh2, provides a complete solution to managing a distributed list of teams and team member objects with support for host migration. +/// \ingroup PLUGINS_GROUP + +/// \ingroup TEAM_MANAGER_GROUP +/// \brief A subcategory of not being on a team. For example, 0 may mean no team for a player, while 1 may mean no team for a spectator. Defined by the user. +typedef unsigned char NoTeamId; + +/// \ingroup TEAM_MANAGER_GROUP +/// Used for multiple worlds. +typedef uint8_t WorldId; + +/// \ingroup TEAM_MANAGER_GROUP +/// Maximum number of members on one team. Use 65535 for unlimited. +typedef uint16_t TeamMemberLimit; + +/// Allow members to join this team when they specify TeamSelection::JOIN_ANY_AVAILABLE_TEAM +#define ALLOW_JOIN_ANY_AVAILABLE_TEAM (1<<0) +/// Allow members to join this team when they specify TeamSelection::JOIN_SPECIFIC_TEAM +#define ALLOW_JOIN_SPECIFIC_TEAM (1<<1) +/// Allow the host to put members on this team when rebalancing with TM_World::SetBalanceTeams() +#define ALLOW_JOIN_REBALANCING (1<<2) + +// Bitwise combination of ALLOW_JOIN_ANY_AVAILABLE_TEAM, ALLOW_JOIN_SPECIFIC_TEAM, ALLOW_JOIN_REBALANCING +typedef uint8_t JoinPermissions; + +// Forward declarations +class TM_Team; +class TM_TeamMember; +class TM_World; +class TeamManager; + +/// \ingroup TEAM_MANAGER_GROUP +enum JoinTeamType +{ + /// Attempt to join the first available team. + JOIN_ANY_AVAILABLE_TEAM, + /// Attempt to join a specific team, previously added with TM_World::ReferenceTeam() + JOIN_SPECIFIC_TEAM, + /// No team. Always succeeds. + JOIN_NO_TEAM +}; + +/// \ingroup TEAM_MANAGER_GROUP +enum TMTopology +{ + // Each system will send all messages to all participants + TM_PEER_TO_PEER, + + // The host will relay incoming messages to all participants + TM_CLIENT_SERVER, +}; + +/// \brief Parameter to TM_World::ReferenceTeamMember() +/// \details Use TeamSelection::AnyAvailable(), TeamSelection::SpecificTeam(), or TeamSelection::NoTeam() +/// \ingroup TEAM_MANAGER_GROUP +struct TeamSelection +{ + TeamSelection(); + TeamSelection(JoinTeamType itt); + TeamSelection(JoinTeamType itt, TM_Team *param); + TeamSelection(JoinTeamType itt, NoTeamId param); + JoinTeamType joinTeamType; + + union + { + TM_Team *specificTeamToJoin; + NoTeamId noTeamSubcategory; + } teamParameter; + + /// \brief Join any team that has available slots and is tagged with ALLOW_JOIN_ANY_AVAILABLE_TEAM + /// \details ID_TEAM_BALANCER_TEAM_ASSIGNED, ID_TEAM_BALANCER_REQUESTED_TEAM_FULL, or ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED will be returned to all systems. + static TeamSelection AnyAvailable(void); + /// \brief Join a specific team if it has available slots, and is tagged with JOIN_SPECIFIC_TEAMS + /// \details ID_TEAM_BALANCER_TEAM_ASSIGNED, ID_TEAM_BALANCER_REQUESTED_TEAM_FULL, or ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED will be returned to all systems. + /// \param[in] specificTeamToJoin Which team to attempt to join. + static TeamSelection SpecificTeam(TM_Team *specificTeamToJoin); + /// \brief Do not join a team, or leave all current teams. + /// \details This always succeeds. ID_TEAM_BALANCER_TEAM_ASSIGNED will be returned to all systems. + /// \param[in] noTeamSubcategory Even when not on a team, you can internally identify a subcategory of not being on a team, such as AI or spectator. + static TeamSelection NoTeam(NoTeamId noTeamSubcategory); +}; + +/// \brief A member of one or more teams. +/// \details Contains data and operations on data to manage which team your game's team members are on. +/// Best used as a composite member of your "User" or "Player" class(es). +/// When using with ReplicaManager3, call TM_TeamMember::ReferenceTeamMember() in Replica3::DeserializeConstruction() and TM_TeamMember::DeserializeConstruction() in Replica3::PostDeserializeConstruction() +/// There is otherwise no need to manually serialize the class, as operations are networked internally. +/// \ingroup TEAM_MANAGER_GROUP +class RAK_DLL_EXPORT TM_TeamMember +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(TM_TeamMember) + + TM_TeamMember(); + virtual ~TM_TeamMember(); + + /// \brief Request to join any team, a specific team, or to leave all teams + /// \details Function will return false on invalid operations, such as joining a team you are already on. + /// Will also fail with TeamSelection::JOIN_ANY_AVAILABLE_TEAM if you are currently on a team. + /// On success, every system will get ID_TEAM_BALANCER_TEAM_ASSIGNED. Use TeamManager::DecomposeTeamAssigned() to get details of which team member the message refers to. + /// On failure, all systems will get ID_TEAM_BALANCER_REQUESTED_TEAM_FULL or ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED. Use TeamManager::DecomposeTeamFull() and TeamManager::DecomposeTeamLocked() to get details of which team member the message refers to. + /// \note Joining a specific team with this function may result in being on more than one team at once, even if you call the function while locally only on one team. If your game depends on only being on one team at a team, use RequestTeamSwitch() instead with the parameter teamToLeave set to 0 + /// \param[in] TeamSelection::AnyAvailable(), TeamSelection::SpecificTeam(), or TeamSelection::NoTeam() + /// \return false On invalid or unnecessary operation. Otherwise returns true + bool RequestTeam(TeamSelection teamSelection); + + /// \brief Similar to RequestTeam with TeamSelection::SpecificTeam(), but leave a team simultaneously when the desired team is joinable + /// \param[in] teamToJoin Which team to join + /// \param[in] teamToLeave If 0, means leave all current teams. Otherwise, leave the specified team. + /// \return false On invalid or unnecessary operation. Otherwise returns true + bool RequestTeamSwitch(TM_Team *teamToJoin, TM_Team *teamToLeave); + + /// \brief Returns the first requested team in the list of requested teams, if you have a requested team at all. + /// \return TeamSelection::SpecificTeam(), TeamSelection::NoTeam(), or TeamSelection::AnyAvailable() + TeamSelection GetRequestedTeam(void) const; + + /// \brief Returns pending calls to RequestTeam() when using TeamSelection::JOIN_SPECIFIC_TEAM + /// \param[out] All pending requested teams + void GetRequestedSpecificTeams(DataStructures::List &requestedTeams) const; + + /// \brief Returns if the specified team is in the list of pending requested teams + /// \param[in] The team we are checking + /// \return Did we request to join this specific team? + bool HasRequestedTeam(TM_Team *team) const; + + /// \brief Returns the index of \a team in the requested teams list + /// \param[in] The team we are checking + /// \return -1 if we did not requested to join this team. Otherwise the index. + unsigned int GetRequestedTeamIndex(TM_Team *team) const; + + /// \return The number of teams that would be returned by a call to GetRequestedSpecificTeams() + unsigned int GetRequestedTeamCount(void) const; + + /// \brief Cancels a request to join a specific team. + /// \details Useful if you got ID_TEAM_BALANCER_REQUESTED_TEAM_FULL or ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED and changed your mind about joining the team. + /// \note This is not guaranteed to work due to latency. To clarify, If the host switches your team at the same time you call CancelRequestTeam() you may still get ID_TEAM_BALANCER_TEAM_ASSIGNED for the team you tried to cancel. + /// \param[in] specificTeamToCancel Which team to no longer join. Use 0 for all. + /// \return false On invalid or unnecessary operation. Otherwise returns true + bool CancelTeamRequest(TM_Team *specificTeamToCancel); + + /// \brief Leave a team + /// \details Leaves a team that you are on. Always succeeds provided you are on that team + /// Generates ID_TEAM_BALANCER_TEAM_ASSIGNED on all systems on success. + /// If you leave the last team you are on, \a noTeamSubcategory is set as well. + /// \param[in] team Which team to leave + /// \param[in] _noTeamSubcategory If the team member has been removed from all teams, which subcategory of NoTeamId to set them to + /// \return false On invalid or unnecessary operation. Otherwise returns true + bool LeaveTeam(TM_Team* team, NoTeamId _noTeamSubcategory); + + /// \brief Leave all teams + /// \Details Leaves all teams you are on, and sets \a noTeamSubcategory + /// \note This is the same as and just calls RequestTeam(TeamSelection::NoTeam(noTeamSubcategory)); + /// \return false On invalid or unnecessary operation. Otherwise returns true + bool LeaveAllTeams(NoTeamId noTeamSubcategory); + + /// \return Get the first team we are on, or 0 if we are not on a team. + TM_Team* GetCurrentTeam(void) const; + + /// \return How many teams we are on + unsigned int GetCurrentTeamCount(void) const; + + /// \return Returns one of the teams in the current team list, up to GetCurrentTeamCount() + TM_Team* GetCurrentTeamByIndex(unsigned int index); + + /// \param[out] Get all teams we are on, as a list + void GetCurrentTeams(DataStructures::List &_teams) const; + + /// For each team member, when you get ID_TEAM_BALANCER_TEAM_ASSIGNED for that member, the team list is saved. + /// Use this function to get that list, for example to determine which teams we just left or joined + /// \param[out] _teams The previous list of teams we were on + void GetLastTeams(DataStructures::List &_teams) const; + + /// \param[in] The team we are checking + /// \return Are we on this team? + bool IsOnTeam(TM_Team *team) const; + + /// \return The teamMemberID parameter passed to TM_World::ReferenceTeamMember() + NetworkID GetNetworkID(void) const; + + /// \return The TM_World instance that was used when calling TM_World::ReferenceTeamMember() + TM_World* GetTM_World(void) const; + + /// \brief Serializes the current state of this object + /// \details To replicate a TM_TeamMember on another system, first instantiate the object using your own code, or a system such as ReplicaManager3. + /// Next, call SerializeConstruction() from whichever system owns the team member + /// Last, call DeserializeConstruction() on the newly created TM_TeamMember + /// \note You must instantiate and deserialize all TM_Team instances that the team member refers to before calling DesrializeConstruction(). ReplicaManager3::PostSerializeConstruction() and ReplicaManager3::PostDeserializeConstruction() will ensure this. + /// \param[out] constructionBitstream This object serialized to a BitStream + void SerializeConstruction(BitStream *constructionBitstream); + + /// \brief Deserializes the current state of this object + /// \details See SerializeConstruction for more details() + /// \note DeserializeConstruction also calls ReferenceTeamMember on the passed \a teamManager instance, there is no need to do so yourself + /// \param[in] teamManager TeamManager instance + /// \param[in] constructionBitstream This object serialized to a BitStream + bool DeserializeConstruction(TeamManager *teamManager, BitStream *constructionBitstream); + + /// \param[in] o Stores a void* for your own use. If using composition, this is useful to store a pointer to the containing object. + void SetOwner(void *o); + + /// \return Whatever was passed to SetOwner() + void *GetOwner(void) const; + + /// \return If not on a team, returns the current NoTeamId value + NoTeamId GetNoTeamId(void) const; + + /// Return world->GetTeamMemberIndex(this) + unsigned int GetWorldIndex(void) const; + + /// \internal + static unsigned long ToUint32( const NetworkID &g ); + + /// \internal + struct RequestedTeam + { + RakNet::Time whenRequested; + unsigned int requestIndex; + TM_Team *requested; + bool isTeamSwitch; + TM_Team *teamToLeave; + }; + +protected: + NetworkID networkId; + TM_World* world; + // Teams we are a member of. We can be on more than one team, but not on the same team more than once + DataStructures::List teams; + // If teams is empty, which subcategory of noTeam we are on + NoTeamId noTeamSubcategory; + // Teams we have requested to join. Mutually exclusive with teams we are already on. Cannot request the same team more than once. + DataStructures::List teamsRequested; + // If teamsRequested is not empty, we want to join a specific team + // If teamsRequested is empty, then joinTeamType is either JOIN_NO_TEAM or JOIN_ANY_AVAILABLE_TEAM + JoinTeamType joinTeamType; + // Set by StoreLastTeams() + DataStructures::List lastTeams; + RakNet::Time whenJoinAnyRequested; + unsigned int joinAnyRequestIndex; + void *owner; + + // Remove from all requested and current teams. + void UpdateListsToNoTeam(NoTeamId nti); + bool JoinAnyTeamCheck(void) const; + bool JoinSpecificTeamCheck(TM_Team *specificTeamToJoin, bool ignoreRequested) const; + bool SwitchSpecificTeamCheck(TM_Team *teamToJoin, TM_Team *teamToLeave, bool ignoreRequested) const; + bool LeaveTeamCheck(TM_Team *team) const; + void UpdateTeamsRequestedToAny(void); + void UpdateTeamsRequestedToNone(void); + void AddToRequestedTeams(TM_Team *teamToJoin); + void AddToRequestedTeams(TM_Team *teamToJoin, TM_Team *teamToLeave); + bool RemoveFromRequestedTeams(TM_Team *team); + void AddToTeamList(TM_Team *team); + void RemoveFromSpecificTeamInternal(TM_Team *team); + void RemoveFromAllTeamsInternal(void); + void StoreLastTeams(void); + + friend class TM_World; + friend class TM_Team; + friend class TeamManager; +}; + +/// \brief A team, containing a list of TM_TeamMember instances +/// \details Contains lists of TM_TeamMember instances +/// Best used as a composite member of your "Team" or "PlayerList" class(es). +/// When using with ReplicaManager3, call TM_Team::ReferenceTeam() in Replica3::DeserializeConstruction() and TM_Team::DeserializeConstruction() in Replica3::PostDeserializeConstruction() +/// There is otherwise no need to manually serialize the class, as operations are networked internally. +/// \ingroup TEAM_MANAGER_GROUP +class RAK_DLL_EXPORT TM_Team +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(TM_Team) + + TM_Team(); + virtual ~TM_Team(); + + /// \brief Set the maximum number of members that can join this team. + /// Defaults to 65535 + /// Setting the limit lower than the existing number of members kicks members out, and assigns noTeamSubcategory to them if they have no other team to go to + /// Setting the limit higher allows members to join in. If a member has a pending request to join this team, they join automatically and ID_TEAM_BALANCER_TEAM_ASSIGNED will be returned for those members. + /// \param[in] _teamMemberLimit The new limit + /// \param[in] noTeamSubcategory Which noTeamSubcategory to assign to members that now have no team. + /// \return false On invalid or unnecessary operation. Otherwise returns true + bool SetMemberLimit(TeamMemberLimit _teamMemberLimit, NoTeamId noTeamSubcategory); + + /// \return If team balancing is on, the most members that can be on this team that would not either unbalance it or exceed the value passed to SetMemberLimit(). If team balancing is off, the same as GetMemberLimitSetting() + TeamMemberLimit GetMemberLimit(void) const; + + /// \return What was passed to SetMemberLimit() or the default + TeamMemberLimit GetMemberLimitSetting(void) const; + + /// \brief Who can join this team under what conditions, while the team is not full + /// To not allow new joins, pass 0 + /// To allow all new joins under any circumstances, bitwise-OR all permission defines. + /// For an invite-only team, use ALLOW_JOIN_SPECIFIC_TEAM only and only allow the requester to call TM_TeamMember::RequestTeam() upon invitiation through your game code. + /// Defaults to allow all + /// \param[in] _joinPermissions Bitwise combination of ALLOW_JOIN_ANY_AVAILABLE_TEAM, ALLOW_JOIN_SPECIFIC_TEAM, ALLOW_JOIN_REBALANCING + /// \return false On invalid or unnecessary operation. Otherwise returns true + bool SetJoinPermissions(JoinPermissions _joinPermissions); + + /// \return Whatever was passed to SetJoinPermissions(), or the default. + JoinPermissions GetJoinPermissions(void) const; + + /// \brief Removes a member from a team he or she is on + /// \details Identical to teamMember->LeaveTeam(this, noTeamSubcategory); See TeamMember::LeaveTeam() for details. + /// \param[in] teamMember Which team member to remove + /// \param[in] noTeamSubcategory If the team member has been removed from all teams, which subcategory of NoTeamId to set them to + void LeaveTeam(TM_TeamMember* teamMember, NoTeamId noTeamSubcategory); + + /// \return What was passed as the \a applyBalancing parameter TM_World::ReferenceTeam() when this team was added. + bool GetBalancingApplies(void) const; + + /// \param[out] All team members of this team + void GetTeamMembers(DataStructures::List &_teamMembers) const; + + /// \return The number of team members on this team + unsigned int GetTeamMembersCount(void) const; + + /// \return A team member on this team. Members are stored in the order they are added + /// \param[in] index A value between 0 and GetTeamMembersCount() + TM_TeamMember *GetTeamMemberByIndex(unsigned int index) const; + + /// \return The teamID parameter passed to TM_World::ReferenceTeam() + NetworkID GetNetworkID(void) const; + + /// \return The TM_World instance that was used when calling TM_World::ReferenceTeamMember() + TM_World* GetTM_World(void) const; + + /// \brief Used by the host to serialize the initial state of this object to a new system + /// \details On the host, when sending existing objects to a new system, call SerializeConstruction() on each of those objects to serialize creation state. + /// Creating the actual Team and TeamMember objects should be handled by your game code, or a system such as ReplicaManager3 + void SerializeConstruction(BitStream *constructionBitstream); + + /// \brief Used by non-host systems to read the bitStream written by SerializeConstruction() + /// \details On non-host systems, after creating existing objects, call DeserializeConstruction() to read and setup that object + /// Creating the actual Team and TeamMember objects should be handled by your game code, or a system such as ReplicaManager3 + bool DeserializeConstruction(TeamManager *teamManager, BitStream *constructionBitstream); + + /// \param[in] o Stores a void* for your own use. If using composition, this is useful to store a pointer to the containing object. + void SetOwner(void *o); + + /// \return Whatever was passed to SetOwner() + void *GetOwner(void) const; + + /// Return world->GetTeamIndex(this) + unsigned int GetWorldIndex(void) const; + + /// \internal + static unsigned long ToUint32( const NetworkID &g ); + +protected: + NetworkID ID; + TM_World* world; + // Which members are on this team. The same member cannot be on the same team more than once + DataStructures::List teamMembers; + // Permissions on who can join this team + JoinPermissions joinPermissions; + // Whether or not to consider this team when balancing teams + bool balancingApplies; + TeamMemberLimit teamMemberLimit; + void *owner; + + // Remove input from list teamMembers + void RemoveFromTeamMemberList(TM_TeamMember *teamMember); + + // Find the member index that wants to join the indicated team, is only on one team, and wants to leave that team + unsigned int GetMemberWithRequestedSingleTeamSwitch(TM_Team *team); + + + friend class TM_World; + friend class TM_TeamMember; + friend class TeamManager; +}; + +/// \brief Stores a list of teams which may be enforcing a balanced number of members +/// \details Each TM_World instance is independent of other TM_World world instances. This enables you to host multiple games on a single computer. +/// Not currently supported to have the same TM_Team or TM_TeamMember in more than one world at a time, but easily added on request. +/// \ingroup TEAM_MANAGER_GROUP +class TM_World +{ +public: + TM_World(); + virtual ~TM_World(); + + /// \return Returns the plugin that created this TM_World instance + TeamManager *GetTeamManager(void) const; + + /// \brief Add a new system to send team and team member updates to. + /// \param[in] rakNetGUID GUID of the system you are adding. See Packet::rakNetGUID or RakPeerInterface::GetGUIDFromSystemAddress() + void AddParticipant(RakNetGUID rakNetGUID); + + /// \brief Remove a system that was previously added with AddParticipant() + /// \details Systems that disconnect are removed automatically + /// \param[in] rakNetGUID GUID of the system you are removing. See Packet::rakNetGUID or RakPeerInterface::GetGUIDFromSystemAddress() + void RemoveParticipant(RakNetGUID rakNetGUID); + + /// \brief If true, all new connections are added to this world using AddParticipant() + /// \details Defaults to true + /// \param[in] autoAdd Setting to set + void SetAutoManageConnections(bool autoAdd); + + /// Get the participants added with AddParticipant() + /// \param[out] participantList Participants added with AddParticipant(); + void GetParticipantList(DataStructures::List &participantList); + + /// \brief Register a TM_Team object with this system. + /// \details Your game should contain instances of TM_Team, for example by using composition with your game's Team or PlayerList class + /// Tell TeamManager about these instances using ReferenceTeam(). + /// \note The destrutor of TM_Team calls DereferenceTeam() automatically. + /// \param[in] team The instance you are registering + /// \param[in] networkId Identifies this instance. This value is independent of values used by NetworkIDManager. You can use the same value as the object that contains this instance. + /// \param[in] applyBalancing Whether or not to include this team for balancing when calling SetBalanceTeams(). + void ReferenceTeam(TM_Team *team, NetworkID networkId, bool applyBalancing); + + /// \brief Unregisters the associated TM_Team object with this system. + /// Call when a TM_Team instance is no longer needed + /// \param[in] team Which team instance to unregister + /// \param[in] noTeamSubcategory All players on this team are kicked off. If these players then have no team, they are set to this no team category. + void DereferenceTeam(TM_Team *team, NoTeamId noTeamSubcategory); + + /// \return Number of teams uniquely added with ReferenceTeam() + unsigned int GetTeamCount(void) const; + + /// \param[in] index A value between 0 and GetTeamCount() + /// \return Returns whatever was passed to \a team in the function ReferenceTeam() in the order it was called. + TM_Team *GetTeamByIndex(unsigned int index) const; + + /// \param[in] teamId Value passed to ReferenceTeam() + /// \return Returns whatever was passed to \a team in the function ReferenceTeam() with this NetworkID. + TM_Team *GetTeamByNetworkID(NetworkID teamId); + + /// \brief Inverse of GetTeamByIndex() + /// \param[in] team Which taem + /// \return The index of the specified team, or -1 if not found + unsigned int GetTeamIndex(const TM_Team *team) const; + + /// \brief Register a TM_TeamMember object with this system. + /// \details Your game should contain instances of TM_TeamMember, for example by using composition with your game's User or Player classes + /// Tell TeamManager about these instances using ReferenceTeamMember(). + /// \note The destrutor of TM_TeamMember calls DereferenceTeamMember() automatically. + /// \param[in] teamMember The instance you are registering + /// \param[in] networkId Identifies this instance. This value is independent of values used by NetworkIDManager. You can use the same value as the object that contains this instance + void ReferenceTeamMember(TM_TeamMember *teamMember, NetworkID networkId); + + /// \brief Unregisters the associated TM_TeamMember object with this system. + /// Call when a TM_TeamMember instance is no longer needed + /// \note This is called by the destructor of TM_TeamMember automatically, so you do not normally need to call this function + void DereferenceTeamMember(TM_TeamMember *teamMember); + + /// \return Number of team members uniquely added with ReferenceTeamMember() + unsigned int GetTeamMemberCount(void) const; + + /// \param[in] index A value between 0 and GetTeamMemberCount() + /// \return Returns whatever was passed to \a team in the function ReferenceTeamMember() in the order it was called. + TM_TeamMember *GetTeamMemberByIndex(unsigned int index) const; + + /// \param[in] index A value between 0 and GetTeamMemberCount() + /// \return Returns whatever was passed to \a teamMemberID in the function ReferenceTeamMember() in the order it was called. + NetworkID GetTeamMemberIDByIndex(unsigned int index) const; + + /// \param[in] teamId Value passed to ReferenceTeamMember() + /// \return Returns Returns whatever was passed to \a team in the function ReferenceTeamMember() with this NetworkID + TM_TeamMember *GetTeamMemberByNetworkID(NetworkID teamMemberId); + + /// \brief Inverse of GetTeamMemberByIndex() + /// \param[in] team Which team member + /// \return The index of the specified team member, or -1 if not found + unsigned int GetTeamMemberIndex(const TM_TeamMember *teamMember) const; + + /// \brief Force or stop forcing teams to be balanced. + /// \details For each team added with ReferenceTeam() and \a applyBalancing set to true, players on unbalanced teams will be redistributed + /// While active, players can only join balanced teams if doing so would not cause that team to become unbalanced. + /// If a player on the desired team also wants to switch, then both players will switch simultaneously. Otherwise, ID_TEAM_BALANCER_REQUESTED_TEAM_FULL will be returned to the requester and switching will occur when possible. + /// If balanceTeams is true and later set to false, players waiting on ID_TEAM_BALANCER_REQUESTED_TEAM_FULL will be able to join the desired team immediately provided it is not full. + /// \param[in] balanceTeams Whether to activate or deactivate team balancing. + /// \param[in] noTeamSubcategory If a player is kicked off a team and is no longer on any team, his or her noTeamSubcategory is set to this value + bool SetBalanceTeams(bool balanceTeams, NoTeamId noTeamSubcategory); + + /// \return \a balanceTeams parameter of SetBalanceTeams(), or the default + bool GetBalanceTeams(void) const; + + /// \brief Set the host that will perform balancing calculations and send notifications + /// \details Operations that can cause conflicts due to latency, such as joining teams, are operated on by the host. The result is sent to all systems added with AddParticipant() + /// For a client/server game, call SetHost() with the server's RakNetGUID value on all systems (including the server itself). If you call TeamManager::SetTopology(TM_CLIENT_SERVER), the server will also relay messages between participants. + /// For a peer to peer game, call SetHost() on the same peer when host migration occurs. Use TeamManager::SetTopology(TM_PEER_TO_PEER) in this case. + /// \note If using FullyConnectedMesh2, SetHost() is called automatically when ID_FCM2_NEW_HOST is returned. + /// \param[in] _hostGuid The host, which is the system that will serialize and resolve team disputes and calculate team balancing. + void SetHost(RakNetGUID _hostGuid); + + /// \return Returns the current host, or UNASSIGNED_RAKNET_GUID if unknown + RakNetGUID GetHost(void) const; + + /// \return The \a worldId passed to TeamManagr::AddWorld() + WorldId GetWorldId(void) const; + + /// \brief Clear all memory and reset everything. + /// \details It is up to the user to deallocate pointers passed to ReferenceTeamMember() or ReferenceTeam(), if so desired. + void Clear(void); + + /// \internal + struct JoinRequestHelper + { + RakNet::Time whenRequestMade; + unsigned int teamMemberIndex; + unsigned int indexIntoTeamsRequested; + unsigned int requestIndex; + }; + /// \internal + static int JoinRequestHelperComp(const TM_World::JoinRequestHelper &key, const TM_World::JoinRequestHelper &data); + +protected: + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + + // Teams with too many members have those members go to other teams. + void EnforceTeamBalance(NoTeamId noTeamSubcategory); + void KickExcessMembers(NoTeamId noTeamSubcategory); + void FillRequestedSlots(void); + unsigned int GetAvailableTeamIndexWithFewestMembers(TeamMemberLimit secondaryLimit, JoinPermissions joinPermissions); + + void GetSortedJoinRequests(DataStructures::OrderedList &joinRequests); + + + // Send a message to all participants + void BroadcastToParticipants(RakNet::BitStream *bsOut, RakNetGUID exclusionGuid); + void BroadcastToParticipants(unsigned char *data, const int length, RakNetGUID exclusionGuid); + + // 1. If can join a team: + // A. teamMember->UpdateTeamsRequestedToNone(); + // B. teamMember->AddToTeamList() + // C. Return new team + // 2. Else return 0 + TM_Team* JoinAnyTeam(TM_TeamMember *teamMember, int *resultCode); + + int JoinSpecificTeam(TM_TeamMember *teamMember, TM_Team *team, bool isTeamSwitch, TM_Team *teamToLeave, DataStructures::List &teamsWeAreLeaving); + + TeamMemberLimit GetBalancedTeamLimit(void) const; + + // For fast lookup. Shares pointers with list teams + DataStructures::Hash teamsHash; + // For fast lookup. Shares pointers with list teamMembers + DataStructures::Hash teamMembersHash; + + TeamManager *teamManager; + DataStructures::List participants; + DataStructures::List teams; + DataStructures::List teamMembers; + bool balanceTeamsIsActive; + RakNetGUID hostGuid; + WorldId worldId; + bool autoAddParticipants; + int teamRequestIndex; + + friend class TeamManager; + friend class TM_TeamMember; + friend class TM_Team; +}; + +/// \brief Automates networking and list management for teams +/// \details TeamManager provides support for teams. A team is a list of team members. +/// Teams contain properties including the number of team members per team, whether or not tagged teams must have equal numbers of members, and if a team is locked or not to certain entry conditions +/// Team members contain properties including which teams they are on and which teams they want to join if a team is not immediately joinable +/// Advanced functionality includes the ability for a team member to be on multiple teams simultaneously, the ability to swap teams with other members, and the ability to resize the number of members supported per team +/// The architecture is designed for easy integration with ReplicaManager3 +/// +/// Usage:
    +/// 1. Define your game classes to represent teams and team members. Your game classes should hold game-specific information such as team name and color.
    +/// 2. Have those game classes contain a corresponding TM_Team or TM_TeamMember instance. Operations on teams will be performed by those instances. Use SetOwner() to refer to the parent object when using composition.
    +/// 3. Call TeamManager::SetTopology() for client/server or peer to peer.
    +/// 4. Call AddWorld() to instantiate a TM_World object which will contain references to your TM_TeamMember and TM_Team instances.
    +/// 5. When you instantiate a TM_TeamMember or TM_Team object, call ReferenceTeam() and ReferenceTeamMember() for each corresponding object
    +/// 6. When sending world state to a new connection, for example in ReplicaManager3::SerializeConstruction(), call TM_SerializeConstruction() on the corresponding TM_TeamMember and TM_Team objects. TM_Team instances on the new connection must be created before TM_TeamMember instances.
    +/// 7. Call TM_DeserializeConstruction() on your new corresponding TM_TeamMember and TM_Team instances.
    +/// 8. Execute team operations. ID_TEAM_BALANCER_REQUESTED_TEAM_FULL, ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED, ID_TEAM_BALANCER_TEAM_REQUESTED_CANCELLED, and ID_TEAM_BALANCER_TEAM_ASSIGNED are returned to all systems when the corresponding event occurs for a team member.
    +/// 9. As the peer to peer session host changes, call SetHost() (Not necessary if using FullyConnectedMesh2). If using client/server, you must set the host
    +/// \note This replaces TeamBalancer. You cannot use TeamBalancer and TeamManager at the same time. +/// \ingroup TEAM_MANAGER_GROUP +class RAK_DLL_EXPORT TeamManager : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(TeamManager) + + TeamManager(); + virtual ~TeamManager(); + + /// \brief Allocate a world to hold a list of teams and players for that team. + /// Use the returned TM_World object for actual team functionality. + /// \note The world is tracked by TeamManager and deallocated by calling Clear() + /// \param[in] worldId Arbitrary user-defined id of the world to create. Each world instance must have a unique id. + TM_World* AddWorld(WorldId worldId); + + /// \brief Deallocate a world created with AddWorld() + /// \param[in] worldId The world to deallocate + void RemoveWorld(WorldId worldId); + + /// \return Returns the number of worlds created with AddWorld() + unsigned int GetWorldCount(void) const; + + /// \param[in] index A value beteween 0 and GetWorldCount()-1 inclusive. + /// \return Returns a world created with AddWorld() + TM_World* GetWorldAtIndex(unsigned int index) const; + + /// \param[in] worldId \a worldId value passed to AddWorld() + /// \return Returns a world created with AddWorld(), or 0 if no such \a worldId + TM_World* GetWorldWithId(WorldId worldId) const; + + /// \brief When auto managing connections, call TM_World::AddParticipant() on all worlds for all new connections automatically + /// Defaults to true + /// \note You probably want this set to false if using multiple worlds + /// \param[in] autoAdd Automatically call TM_World::AddParticipant() all worlds each new connection. Defaults to true. + void SetAutoManageConnections(bool autoAdd); + + /// \brief If \a _topology is set to TM_CLIENT_SERVER, the host will relay messages to participants. + /// \details If topology is set to TM_PEER_TO_PEER, the host assumes the original message source was connected to all other participants and does not relay messages. + /// \note If TM_PEER_TO_PEER, this plugin will listen for ID_FCM2_NEW_HOST and call SetHost() on all worlds automatically + /// \note Defaults to TM_PEER_TO_PEER + /// \param[in] _topology Topology to use + void SetTopology(TMTopology _topology); + + /// \brief When you get ID_TEAM_BALANCER_REQUESTED_TEAM_FULL, pass the packet to this function to read out parameters + /// \param[in] A packet where packet->data[0]==ID_TEAM_BALANCER_REQUESTED_TEAM_FULL + /// \return true on success, false on read error + void DecomposeTeamFull(Packet *packet, + TM_World **world, TM_TeamMember **teamMember, TM_Team **team, + uint16_t ¤tMembers, uint16_t &memberLimitIncludingBalancing, bool &balancingIsActive, JoinPermissions &joinPermissions); + + /// \brief When you get ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED, pass the packet to this function to read out parameters + /// \param[in] A packet where packet->data[0]==ID_TEAM_BALANCER_REQUESTED_TEAM_LOCKED + /// \return true on success, false on read error + void DecomposeTeamLocked(Packet *packet, + TM_World **world, TM_TeamMember **teamMember, TM_Team **team, + uint16_t ¤tMembers, uint16_t &memberLimitIncludingBalancing, bool &balancingIsActive, JoinPermissions &joinPermissions); + + /// \brief Clear all memory and reset everything. + /// \details Deallocates TM_World instances. It is up to the user to deallocate pointers passed to ReferenceTeamMember() or ReferenceTeam(), if so desired. + void Clear(void); + + /// \brief Reads out the world and teamMember from ID_TEAM_BALANCER_TEAM_ASSIGNED + /// \note You can get the current and prior team list from the teamMember itself + /// \param[in] A packet where packet->data[0]==ID_TEAM_BALANCER_TEAM_ASSIGNED + /// \param[out] world Set to the world this \a teamMember is on. 0 on bad lookup. + /// \param[out] teamMember Set to the teamMember affected. 0 on bad lookup. + void DecodeTeamAssigned(Packet *packet, TM_World **world, TM_TeamMember **teamMember); + + // \brief Reads out the world and teamMember from ID_TEAM_BALANCER_TEAM_REQUESTED_CANCELLED + /// \note You can get the requested team list from the teamMember itself + /// \param[in] A packet where packet->data[0]==ID_TEAM_BALANCER_TEAM_REQUESTED_CANCELLED + /// \param[out] world Set to the world this \a teamMember is on. 0 on bad lookup. + /// \param[out] teamMember Set to the teamMember affected. 0 on bad lookup. + /// \param[out] teamCancelled Set to the team that was cancelled. 0 for all teams. + void DecodeTeamCancelled(Packet *packet, TM_World **world, TM_TeamMember **teamMember, TM_Team **teamCancelled); + +protected: + + virtual void Update(void); + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnNewConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, bool isIncoming); + void Send( const RakNet::BitStream * bitStream, const AddressOrGUID systemIdentifier, bool broadcast ); + + void EncodeTeamFullOrLocked(RakNet::BitStream *bitStream, TM_TeamMember *teamMember, TM_Team *team); + void DecomposeTeamFullOrLocked(RakNet::BitStream *bsIn, TM_World **world, TM_TeamMember **teamMember, TM_Team **team, + uint16_t ¤tMembers, uint16_t &memberLimitIncludingBalancing, bool &balancingIsActive, JoinPermissions &joinPermissions); + void ProcessTeamAssigned(RakNet::BitStream *bsIn); + + void EncodeTeamAssigned(RakNet::BitStream *bitStream, TM_TeamMember *teamMember); + void RemoveFromTeamsRequestedAndAddTeam(TM_TeamMember *teamMember, TM_Team *team, bool isTeamSwitch, TM_Team *teamToLeave); + + void PushTeamAssigned(TM_TeamMember *teamMember); + void PushBitStream(RakNet::BitStream *bitStream); + void OnUpdateListsToNoTeam(Packet *packet, TM_World *world); + void OnUpdateTeamsRequestedToAny(Packet *packet, TM_World *world); + void OnJoinAnyTeam(Packet *packet, TM_World *world); + void OnJoinRequestedTeam(Packet *packet, TM_World *world); + void OnUpdateTeamsRequestedToNoneAndAddTeam(Packet *packet, TM_World *world); + void OnRemoveFromTeamsRequestedAndAddTeam(Packet *packet, TM_World *world); + void OnAddToRequestedTeams(Packet *packet, TM_World *world); + bool OnRemoveFromRequestedTeams(Packet *packet, TM_World *world); + void OnLeaveTeam(Packet *packet, TM_World *world); + void OnSetMemberLimit(Packet *packet, TM_World *world); + void OnSetJoinPermissions(Packet *packet, TM_World *world); + void OnSetBalanceTeams(Packet *packet, TM_World *world); + void OnSetBalanceTeamsInitial(Packet *packet, TM_World *world); + + + void EncodeTeamFull(RakNet::BitStream *bitStream, TM_TeamMember *teamMember, TM_Team *team); + void EncodeTeamLocked(RakNet::BitStream *bitStream, TM_TeamMember *teamMember, TM_Team *team); + + /// \brief When you get ID_TEAM_BALANCER_TEAM_ASSIGNED, pass the packet to this function to read out parameters + /// \param[in] A packet where packet->data[0]==ID_TEAM_BALANCER_TEAM_ASSIGNED + /// \return true on success, false on read error + void DecodeTeamAssigned(RakNet::BitStream *bsIn, TM_World **world, TM_TeamMember **teamMember, NoTeamId &noTeamSubcategory, + JoinTeamType &joinTeamType, DataStructures::List &newTeam, + DataStructures::List &teamsLeft, DataStructures::List &teamsJoined); + + // O(1) lookup for a given world. If I need more worlds, change this to a hash or ordered list + TM_World *worldsArray[255]; + // All allocated worlds for linear traversal + DataStructures::List worldsList; + bool autoAddParticipants; + TMTopology topology; + + friend class TM_TeamMember; + friend class TM_World; + friend class TM_Team; +}; + +} // namespace RakNet + +#endif // __TEAM_MANAGER_H + +#endif // _RAKNET_SUPPORT_* + diff --git a/include/raknet/TelnetTransport.hpp b/include/raknet/TelnetTransport.hpp new file mode 100644 index 0000000..279e7ba --- /dev/null +++ b/include/raknet/TelnetTransport.hpp @@ -0,0 +1,80 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains TelnetTransport , used to supports the telnet transport protocol. Insecure +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_TelnetTransport==1 && _RAKNET_SUPPORT_TCPInterface==1 + +#ifndef __TELNET_TRANSPORT +#define __TELNET_TRANSPORT + +#include "TransportInterface.hpp" +#include "DS_List.hpp" +#include "Export.hpp" + +namespace RakNet +{ +/// Forward declarations +class TCPInterface; +struct TelnetClient; + +/// \brief Use TelnetTransport to easily allow windows telnet to connect to your ConsoleServer +/// \details To run Windows telnet, go to your start menu, click run, and in the edit box type "telnet " where is the ip address.
    +/// of your ConsoleServer (most likely the same IP as your game).
    +/// This implementation always echos commands. +class RAK_DLL_EXPORT TelnetTransport : public TransportInterface +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(TelnetTransport) + + TelnetTransport(); + virtual ~TelnetTransport(); + bool Start(unsigned short port, bool serverMode); + void Stop(void); + void Send( SystemAddress systemAddress, const char *data, ... ); + void CloseConnection( SystemAddress systemAddress ); + Packet* Receive( void ); + void DeallocatePacket( Packet *packet ); + SystemAddress HasNewIncomingConnection(void); + SystemAddress HasLostConnection(void); + CommandParserInterface* GetCommandParser(void); + void SetSendSuffix(const char *suffix); + void SetSendPrefix(const char *prefix); +protected: + + struct TelnetClient + { + SystemAddress systemAddress; + char textInput[REMOTE_MAX_TEXT_INPUT]; + char lastSentTextInput[REMOTE_MAX_TEXT_INPUT]; + unsigned cursorPosition; + }; + + TCPInterface *tcpInterface; + void AutoAllocate(void); + bool ReassembleLine(TelnetTransport::TelnetClient* telnetClient, unsigned char c); + + // Crap this sucks but because windows telnet won't send line at a time, I have to reconstruct the lines at the server per player + DataStructures::List remoteClients; + + char *sendSuffix, *sendPrefix; + +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/ThreadPool.hpp b/include/raknet/ThreadPool.hpp new file mode 100644 index 0000000..368c3a6 --- /dev/null +++ b/include/raknet/ThreadPool.hpp @@ -0,0 +1,633 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __THREAD_POOL_H +#define __THREAD_POOL_H + +#include "RakMemoryOverride.hpp" +#include "DS_Queue.hpp" +#include "SimpleMutex.hpp" +#include "Export.hpp" +#include "RakThread.hpp" +#include "SignaledEvent.hpp" + +#ifdef _MSC_VER +#pragma warning( push ) +#endif + +class ThreadDataInterface +{ +public: + ThreadDataInterface() {} + virtual ~ThreadDataInterface() {} + + virtual void* PerThreadFactory(void *context)=0; + virtual void PerThreadDestructor(void* factoryResult, void *context)=0; +}; +/// A simple class to create worker threads that processes a queue of functions with data. +/// This class does not allocate or deallocate memory. It is up to the user to handle memory management. +/// InputType and OutputType are stored directly in a queue. For large structures, if you plan to delete from the middle of the queue, +/// you might wish to store pointers rather than the structures themselves so the array can shift efficiently. +template +struct RAK_DLL_EXPORT ThreadPool +{ + ThreadPool(); + ~ThreadPool(); + + /// Start the specified number of threads. + /// \param[in] numThreads The number of threads to start + /// \param[in] stackSize 0 for default (except on consoles). + /// \param[in] _perThreadInit User callback to return data stored per thread. Pass 0 if not needed. + /// \param[in] _perThreadDeinit User callback to destroy data stored per thread, created by _perThreadInit. Pass 0 if not needed. + /// \return True on success, false on failure. + bool StartThreads(int numThreads, int stackSize, void* (*_perThreadInit)()=0, void (*_perThreadDeinit)(void*)=0); + + // Alternate form of _perThreadDataFactory, _perThreadDataDestructor + void SetThreadDataInterface(ThreadDataInterface *tdi, void *context); + + /// Stops all threads + void StopThreads(void); + + /// Adds a function to a queue with data to pass to that function. This function will be called from the thread + /// Memory management is your responsibility! This class does not allocate or deallocate memory. + /// The best way to deallocate \a inputData is in userCallback. If you call EndThreads such that callbacks were not called, you + /// can iterate through the inputQueue and deallocate all pending input data there + /// The best way to deallocate output is as it is returned to you from GetOutput. Similarly, if you end the threads such that + /// not all output was returned, you can iterate through outputQueue and deallocate it there. + /// \param[in] workerThreadCallback The function to call from the thread + /// \param[in] inputData The parameter to pass to \a userCallback + void AddInput(OutputType (*workerThreadCallback)(InputType, bool *returnOutput, void* perThreadData), InputType inputData); + + /// Adds to the output queue + /// Use it if you want to inject output into the same queue that the system uses. Normally you would not use this. Consider it a convenience function. + /// \param[in] outputData The output to inject + void AddOutput(OutputType outputData); + + /// Returns true if output from GetOutput is waiting. + /// \return true if output is waiting, false otherwise + bool HasOutput(void); + + /// Inaccurate but fast version of HasOutput. If this returns true, you should still check HasOutput for the real value. + /// \return true if output is probably waiting, false otherwise + bool HasOutputFast(void); + + /// Returns true if input from GetInput is waiting. + /// \return true if input is waiting, false otherwise + bool HasInput(void); + + /// Inaccurate but fast version of HasInput. If this returns true, you should still check HasInput for the real value. + /// \return true if input is probably waiting, false otherwise + bool HasInputFast(void); + + /// Gets the output of a call to \a userCallback + /// HasOutput must return true before you call this function. Otherwise it will assert. + /// \return The output of \a userCallback. If you have different output signatures, it is up to you to encode the data to indicate this + OutputType GetOutput(void); + + /// Clears internal buffers + void Clear(void); + + /// Lock the input buffer before calling the functions InputSize, InputAtIndex, and RemoveInputAtIndex + /// It is only necessary to lock the input or output while the threads are running + void LockInput(void); + + /// Unlock the input buffer after you are done with the functions InputSize, GetInputAtIndex, and RemoveInputAtIndex + void UnlockInput(void); + + /// Length of the input queue + unsigned InputSize(void); + + /// Get the input at a specified index + InputType GetInputAtIndex(unsigned index); + + /// Remove input from a specific index. This does NOT do memory deallocation - it only removes the item from the queue + void RemoveInputAtIndex(unsigned index); + + /// Lock the output buffer before calling the functions OutputSize, OutputAtIndex, and RemoveOutputAtIndex + /// It is only necessary to lock the input or output while the threads are running + void LockOutput(void); + + /// Unlock the output buffer after you are done with the functions OutputSize, GetOutputAtIndex, and RemoveOutputAtIndex + void UnlockOutput(void); + + /// Length of the output queue + unsigned OutputSize(void); + + /// Get the output at a specified index + OutputType GetOutputAtIndex(unsigned index); + + /// Remove output from a specific index. This does NOT do memory deallocation - it only removes the item from the queue + void RemoveOutputAtIndex(unsigned index); + + /// Removes all items from the input queue + void ClearInput(void); + + /// Removes all items from the output queue + void ClearOutput(void); + + /// Are any of the threads working, or is input or output available? + bool IsWorking(void); + + /// The number of currently active threads. + int NumThreadsWorking(void); + + /// Did we call Start? + bool WasStarted(void); + + // Block until all threads are stopped. + bool Pause(void); + + // Continue running + void Resume(void); + +protected: + // It is valid to cancel input before it is processed. To do so, lock the inputQueue with inputQueueMutex, + // Scan the list, and remove the item you don't want. + RakNet::SimpleMutex inputQueueMutex, outputQueueMutex, workingThreadCountMutex, runThreadsMutex; + + void* (*perThreadDataFactory)(); + void (*perThreadDataDestructor)(void*); + + // inputFunctionQueue & inputQueue are paired arrays so if you delete from one at a particular index you must delete from the other + // at the same index + DataStructures::Queue inputFunctionQueue; + DataStructures::Queue inputQueue; + DataStructures::Queue outputQueue; + + ThreadDataInterface *threadDataInterface; + void *tdiContext; + + + template + friend RAK_THREAD_DECLARATION(WorkerThread); + + /* +#ifdef _WIN32 + friend unsigned __stdcall WorkerThread( LPVOID arguments ); +#else + friend void* WorkerThread( void* arguments ); +#endif + */ + + /// \internal + bool runThreads; + /// \internal + int numThreadsRunning; + /// \internal + int numThreadsWorking; + /// \internal + RakNet::SimpleMutex numThreadsRunningMutex; + + RakNet::SignaledEvent quitAndIncomingDataEvents; + +// #if defined(SN_TARGET_PSP2) +// RakNet::RakThread::UltUlThreadRuntime *runtime; +// #endif +}; + +#include "ThreadPool.hpp" +#include "RakSleep.hpp" +#ifdef _WIN32 + +#else +#include +#endif + +#ifdef _MSC_VER +#pragma warning(disable:4127) +#pragma warning( disable : 4701 ) // potentially uninitialized local variable 'inputData' used +#endif + +template +RAK_THREAD_DECLARATION(WorkerThread) +/* +#ifdef _WIN32 +unsigned __stdcall WorkerThread( LPVOID arguments ) +#else +void* WorkerThread( void* arguments ) +#endif +*/ +{ + + + + ThreadPool *threadPool = (ThreadPool*) arguments; + + + bool returnOutput; + ThreadOutputType (*userCallback)(ThreadInputType, bool *, void*); + ThreadInputType inputData; + ThreadOutputType callbackOutput; + + userCallback=0; + + void *perThreadData; + if (threadPool->perThreadDataFactory) + perThreadData=threadPool->perThreadDataFactory(); + else if (threadPool->threadDataInterface) + perThreadData=threadPool->threadDataInterface->PerThreadFactory(threadPool->tdiContext); + else + perThreadData=0; + + // Increase numThreadsRunning + threadPool->numThreadsRunningMutex.Lock(); + ++threadPool->numThreadsRunning; + threadPool->numThreadsRunningMutex.Unlock(); + + while (1) + { +//#ifdef _WIN32 + if (userCallback==0) + { + threadPool->quitAndIncomingDataEvents.WaitOnEvent(1000); + } +// #else +// if (userCallback==0) +// RakSleep(30); +// #endif + + threadPool->runThreadsMutex.Lock(); + if (threadPool->runThreads==false) + { + threadPool->runThreadsMutex.Unlock(); + break; + } + threadPool->runThreadsMutex.Unlock(); + + threadPool->workingThreadCountMutex.Lock(); + ++threadPool->numThreadsWorking; + threadPool->workingThreadCountMutex.Unlock(); + + // Read input data + userCallback=0; + threadPool->inputQueueMutex.Lock(); + if (threadPool->inputFunctionQueue.Size()) + { + userCallback=threadPool->inputFunctionQueue.Pop(); + inputData=threadPool->inputQueue.Pop(); + } + threadPool->inputQueueMutex.Unlock(); + + if (userCallback) + { + callbackOutput=userCallback(inputData, &returnOutput,perThreadData); + if (returnOutput) + { + threadPool->outputQueueMutex.Lock(); + threadPool->outputQueue.Push(callbackOutput, _FILE_AND_LINE_ ); + threadPool->outputQueueMutex.Unlock(); + } + } + + threadPool->workingThreadCountMutex.Lock(); + --threadPool->numThreadsWorking; + threadPool->workingThreadCountMutex.Unlock(); + } + + // Decrease numThreadsRunning + threadPool->numThreadsRunningMutex.Lock(); + --threadPool->numThreadsRunning; + threadPool->numThreadsRunningMutex.Unlock(); + + if (threadPool->perThreadDataDestructor) + threadPool->perThreadDataDestructor(perThreadData); + else if (threadPool->threadDataInterface) + threadPool->threadDataInterface->PerThreadDestructor(perThreadData, threadPool->tdiContext); + + + + + return 0; + +} +template +ThreadPool::ThreadPool() +{ + runThreads=false; + numThreadsRunning=0; + threadDataInterface=0; + tdiContext=0; + numThreadsWorking=0; + +} +template +ThreadPool::~ThreadPool() +{ + StopThreads(); + Clear(); +} +template +bool ThreadPool::StartThreads(int numThreads, int stackSize, void* (*_perThreadDataFactory)(), void (*_perThreadDataDestructor)(void *)) +{ + (void) stackSize; + +// #if defined(SN_TARGET_PSP2) +// runtime = RakNet::RakThread::AllocRuntime(numThreads); +// #endif + + runThreadsMutex.Lock(); + if (runThreads==true) + { + // Already running + runThreadsMutex.Unlock(); + return false; + } + runThreadsMutex.Unlock(); + + quitAndIncomingDataEvents.InitEvent(); + + perThreadDataFactory=_perThreadDataFactory; + perThreadDataDestructor=_perThreadDataDestructor; + + runThreadsMutex.Lock(); + runThreads=true; + runThreadsMutex.Unlock(); + + numThreadsWorking=0; + unsigned threadId = 0; + (void) threadId; + int i; + for (i=0; i < numThreads; i++) + { + int errorCode; + + + + + errorCode = RakNet::RakThread::Create(WorkerThread, this); + + if (errorCode!=0) + { + StopThreads(); + return false; + } + } + // Wait for number of threads running to increase to numThreads + bool done=false; + while (done==false) + { + RakSleep(50); + numThreadsRunningMutex.Lock(); + if (numThreadsRunning==numThreads) + done=true; + numThreadsRunningMutex.Unlock(); + } + + return true; +} +template +void ThreadPool::SetThreadDataInterface(ThreadDataInterface *tdi, void *context) +{ + threadDataInterface=tdi; + tdiContext=context; +} +template +void ThreadPool::StopThreads(void) +{ + runThreadsMutex.Lock(); + if (runThreads==false) + { + runThreadsMutex.Unlock(); + return; + } + + runThreads=false; + runThreadsMutex.Unlock(); + + // Wait for number of threads running to decrease to 0 + bool done=false; + while (done==false) + { + quitAndIncomingDataEvents.SetEvent(); + + RakSleep(50); + numThreadsRunningMutex.Lock(); + if (numThreadsRunning==0) + done=true; + numThreadsRunningMutex.Unlock(); + } + + quitAndIncomingDataEvents.CloseEvent(); + +// #if defined(SN_TARGET_PSP2) +// RakNet::RakThread::DeallocRuntime(runtime); +// runtime=0; +// #endif + +} +template +void ThreadPool::AddInput(OutputType (*workerThreadCallback)(InputType, bool *returnOutput, void* perThreadData), InputType inputData) +{ + inputQueueMutex.Lock(); + inputQueue.Push(inputData, _FILE_AND_LINE_ ); + inputFunctionQueue.Push(workerThreadCallback, _FILE_AND_LINE_ ); + inputQueueMutex.Unlock(); + + quitAndIncomingDataEvents.SetEvent(); +} +template +void ThreadPool::AddOutput(OutputType outputData) +{ + outputQueueMutex.Lock(); + outputQueue.Push(outputData, _FILE_AND_LINE_ ); + outputQueueMutex.Unlock(); +} +template +bool ThreadPool::HasOutputFast(void) +{ + return outputQueue.IsEmpty()==false; +} +template +bool ThreadPool::HasOutput(void) +{ + bool res; + outputQueueMutex.Lock(); + res=outputQueue.IsEmpty()==false; + outputQueueMutex.Unlock(); + return res; +} +template +bool ThreadPool::HasInputFast(void) +{ + return inputQueue.IsEmpty()==false; +} +template +bool ThreadPool::HasInput(void) +{ + bool res; + inputQueueMutex.Lock(); + res=inputQueue.IsEmpty()==false; + inputQueueMutex.Unlock(); + return res; +} +template +OutputType ThreadPool::GetOutput(void) +{ + // Real output check + OutputType output; + outputQueueMutex.Lock(); + output=outputQueue.Pop(); + outputQueueMutex.Unlock(); + return output; +} +template +void ThreadPool::Clear(void) +{ + runThreadsMutex.Lock(); + if (runThreads) + { + runThreadsMutex.Unlock(); + inputQueueMutex.Lock(); + inputFunctionQueue.Clear(_FILE_AND_LINE_); + inputQueue.Clear(_FILE_AND_LINE_); + inputQueueMutex.Unlock(); + + outputQueueMutex.Lock(); + outputQueue.Clear(_FILE_AND_LINE_); + outputQueueMutex.Unlock(); + } + else + { + inputFunctionQueue.Clear(_FILE_AND_LINE_); + inputQueue.Clear(_FILE_AND_LINE_); + outputQueue.Clear(_FILE_AND_LINE_); + } +} +template +void ThreadPool::LockInput(void) +{ + inputQueueMutex.Lock(); +} +template +void ThreadPool::UnlockInput(void) +{ + inputQueueMutex.Unlock(); +} +template +unsigned ThreadPool::InputSize(void) +{ + return inputQueue.Size(); +} +template +InputType ThreadPool::GetInputAtIndex(unsigned index) +{ + return inputQueue[index]; +} +template +void ThreadPool::RemoveInputAtIndex(unsigned index) +{ + inputQueue.RemoveAtIndex(index); + inputFunctionQueue.RemoveAtIndex(index); +} +template +void ThreadPool::LockOutput(void) +{ + outputQueueMutex.Lock(); +} +template +void ThreadPool::UnlockOutput(void) +{ + outputQueueMutex.Unlock(); +} +template +unsigned ThreadPool::OutputSize(void) +{ + return outputQueue.Size(); +} +template +OutputType ThreadPool::GetOutputAtIndex(unsigned index) +{ + return outputQueue[index]; +} +template +void ThreadPool::RemoveOutputAtIndex(unsigned index) +{ + outputQueue.RemoveAtIndex(index); +} +template +void ThreadPool::ClearInput(void) +{ + inputQueue.Clear(_FILE_AND_LINE_); + inputFunctionQueue.Clear(_FILE_AND_LINE_); +} + +template +void ThreadPool::ClearOutput(void) +{ + outputQueue.Clear(_FILE_AND_LINE_); +} +template +bool ThreadPool::IsWorking(void) +{ + bool isWorking; +// workingThreadCountMutex.Lock(); +// isWorking=numThreadsWorking!=0; +// workingThreadCountMutex.Unlock(); + +// if (isWorking) +// return true; + + // Bug fix: Originally the order of these two was reversed. + // It's possible with the thread timing that working could have been false, then it picks up the data in the other thread, then it checks + // here and sees there is no data. So it thinks the thread is not working when it was. + if (HasOutputFast() && HasOutput()) + return true; + + if (HasInputFast() && HasInput()) + return true; + + // Need to check is working again, in case the thread was between the first and second checks + workingThreadCountMutex.Lock(); + isWorking=numThreadsWorking!=0; + workingThreadCountMutex.Unlock(); + + return isWorking; +} + +template +int ThreadPool::NumThreadsWorking(void) +{ + return numThreadsWorking; +} + +template +bool ThreadPool::WasStarted(void) +{ + bool b; + runThreadsMutex.Lock(); + b = runThreads; + runThreadsMutex.Unlock(); + return b; +} +template +bool ThreadPool::Pause(void) +{ + if (WasStarted()==false) + return false; + + workingThreadCountMutex.Lock(); + while (numThreadsWorking>0) + { + RakSleep(30); + } + return true; +} +template +void ThreadPool::Resume(void) +{ + workingThreadCountMutex.Unlock(); +} + +#ifdef _MSC_VER +#pragma warning( pop ) +#endif + +#endif + diff --git a/include/raknet/ThreadsafePacketLogger.hpp b/include/raknet/ThreadsafePacketLogger.hpp new file mode 100644 index 0000000..cf3f511 --- /dev/null +++ b/include/raknet/ThreadsafePacketLogger.hpp @@ -0,0 +1,48 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Derivation of the packet logger to defer the call to WriteLog until the user thread. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_PacketLogger==1 + +#ifndef __THREADSAFE_PACKET_LOGGER_H +#define __THREADSAFE_PACKET_LOGGER_H + +#include "PacketLogger.hpp" +#include "SingleProducerConsumer.hpp" + +namespace RakNet +{ + +/// \ingroup PACKETLOGGER_GROUP +/// \brief Same as PacketLogger, but writes output in the user thread. +class RAK_DLL_EXPORT ThreadsafePacketLogger : public PacketLogger +{ +public: + ThreadsafePacketLogger(); + virtual ~ThreadsafePacketLogger(); + + virtual void Update(void); + +protected: + virtual void AddToLog(const char *str); + + DataStructures::SingleProducerConsumer logMessages; +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/TransportInterface.hpp b/include/raknet/TransportInterface.hpp new file mode 100644 index 0000000..f1d1a53 --- /dev/null +++ b/include/raknet/TransportInterface.hpp @@ -0,0 +1,91 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Contains TransportInterface from which you can derive custom transport providers for ConsoleServer. +/// + + + +#ifndef __TRANSPORT_INTERFACE_H +#define __TRANSPORT_INTERFACE_H + +#include "RakNetTypes.hpp" +#include "Export.hpp" +#include "RakMemoryOverride.hpp" + +#define REMOTE_MAX_TEXT_INPUT 2048 + +namespace RakNet +{ + +class CommandParserInterface; + + +/// \brief Defines an interface that is used to send and receive null-terminated strings. +/// \details In practice this is only used by the CommandParser system for for servers. +class RAK_DLL_EXPORT TransportInterface +{ +public: + TransportInterface() {} + virtual ~TransportInterface() {} + + /// Start the transport provider on the indicated port. + /// \param[in] port The port to start the transport provider on + /// \param[in] serverMode If true, you should allow incoming connections (I don't actually use this anywhere) + /// \return Return true on success, false on failure. + virtual bool Start(unsigned short port, bool serverMode)=0; + + /// Stop the transport provider. You can clear memory and shutdown threads here. + virtual void Stop(void)=0; + + /// Send a null-terminated string to \a systemAddress + /// If your transport method requires particular formatting of the outgoing data (e.g. you don't just send strings) you can do it here + /// and parse it out in Receive(). + /// \param[in] systemAddress The player to send the string to + /// \param[in] data format specifier - same as RAKNET_DEBUG_PRINTF + /// \param[in] ... format specification arguments - same as RAKNET_DEBUG_PRINTF + virtual void Send( SystemAddress systemAddress, const char *data, ... )=0; + + /// Disconnect \a systemAddress . The binary address and port defines the SystemAddress structure. + /// \param[in] systemAddress The player/address to disconnect + virtual void CloseConnection( SystemAddress systemAddress )=0; + + /// Return a string. The string should be allocated and written to Packet::data . + /// The byte length should be written to Packet::length . The player/address should be written to Packet::systemAddress + /// If your transport protocol adds special formatting to the data stream you should parse it out before returning it in the packet + /// and thus only return a string in Packet::data + /// \return The packet structure containing the result of Receive, or 0 if no data is available + virtual Packet* Receive( void )=0; + + /// Deallocate the Packet structure returned by Receive + /// \param[in] The packet to deallocate + virtual void DeallocatePacket( Packet *packet )=0; + + /// If a new system connects to you, you should queue that event and return the systemAddress/address of that player in this function. + /// \return The SystemAddress/address of the system + virtual SystemAddress HasNewIncomingConnection(void)=0; + + /// If a system loses the connection, you should queue that event and return the systemAddress/address of that player in this function. + /// \return The SystemAddress/address of the system + virtual SystemAddress HasLostConnection(void)=0; + + /// Your transport provider can itself have command parsers if the transport layer has user-modifiable features + /// For example, your transport layer may have a password which you want remote users to be able to set or you may want + /// to allow remote users to turn on or off command echo + /// \return 0 if you do not need a command parser - otherwise the desired derivation of CommandParserInterface + virtual CommandParserInterface* GetCommandParser(void)=0; +protected: +}; + +} // namespace RakNet + +#endif + diff --git a/include/raknet/TwoWayAuthentication.hpp b/include/raknet/TwoWayAuthentication.hpp new file mode 100644 index 0000000..7a5401d --- /dev/null +++ b/include/raknet/TwoWayAuthentication.hpp @@ -0,0 +1,154 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file TwoWayAuthentication.h +/// \brief Implements two way authentication +/// \details Given two systems, each of whom known a common password, verify the password without transmitting it +/// This can be used to determine what permissions are should be allowed to the other system +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_TwoWayAuthentication==1 + +#ifndef __TWO_WAY_AUTHENTICATION_H +#define __TWO_WAY_AUTHENTICATION_H + +// How often to change the nonce. +#define NONCE_TIMEOUT_MS 10000 +// How often to check for ID_TWO_WAY_AUTHENTICATION_OUTGOING_CHALLENGE_TIMEOUT, and the minimum timeout time. Maximum is double this value. +#define CHALLENGE_MINIMUM_TIMEOUT 3000 + +#if LIBCAT_SECURITY==1 +// From CPP FILE: +// static const int HASH_BITS = 256; +// static const int HASH_BYTES = HASH_BITS / 8; +// static const int STRENGTHENING_FACTOR = 1000; +#define TWO_WAY_AUTHENTICATION_NONCE_LENGTH 32 +#define HASHED_NONCE_AND_PW_LENGTH 32 +#else +#include "DR_SHA1.hpp" +#define TWO_WAY_AUTHENTICATION_NONCE_LENGTH 20 +#define HASHED_NONCE_AND_PW_LENGTH SHA1_LENGTH +#endif + +#include "PluginInterface2.hpp" +#include "RakMemoryOverride.hpp" +#include "NativeTypes.hpp" +#include "RakString.hpp" +#include "DS_Hash.hpp" +#include "DS_Queue.hpp" + +typedef int64_t FCM2Guid; + +namespace RakNet +{ +/// Forward declarations +class RakPeerInterface; + +/// \brief Implements two way authentication +/// \details Given two systems, each of whom known a common password / identifier pair, verify the password without transmitting it +/// This can be used to determine what permissions are should be allowed to the other system +/// If the other system should not send any data until authentication passes, you can use the MessageFilter plugin for this. Call MessageFilter::SetAllowMessageID() including ID_TWO_WAY_AUTHENTICATION_NEGOTIATION when doing so. Also attach MessageFilter first in the list of plugins +/// \note If other systems challenges us, and fails, you will get ID_TWO_WAY_AUTHENTICATION_INCOMING_CHALLENGE_FAILED. +/// \ingroup PLUGINS_GROUP +class RAK_DLL_EXPORT TwoWayAuthentication : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(TwoWayAuthentication) + + TwoWayAuthentication(); + virtual ~TwoWayAuthentication(); + + /// \brief Adds a password to the list of passwords the system will accept + /// \details Each password, which is secret and not transmitted, is identified by \a identifier. + /// \a identifier is transmitted in plaintext with the request. It is only needed because the system supports multiple password. + /// It is used to only hash against once password on the remote system, rather than having to hash against every known password. + /// \param[in] identifier A unique identifier representing this password. This is transmitted in plaintext and should be considered insecure + /// \param[in] password The password to add + /// \return True on success, false on identifier==password, either identifier or password is blank, or identifier is already in use + bool AddPassword(RakNet::RakString identifier, RakNet::RakString password); + + /// \brief Challenge another system for the specified identifier + /// \details After calling Challenge, you will get back ID_TWO_WAY_AUTHENTICATION_SUCCESS, ID_TWO_WAY_AUTHENTICATION_OUTGOING_CHALLENGE_TIMEOUT, or ID_TWO_WAY_AUTHENTICATION_OUTGOING_CHALLENGE_FAILED + /// ID_TWO_WAY_AUTHENTICATION_SUCCESS will be returned if and only if the other system has called AddPassword() with the same identifier\password pair as this system. + /// \param[in] identifier A unique identifier representing this password. This is transmitted in plaintext and should be considered insecure + /// \return True on success, false on remote system not connected, or identifier not previously added with AddPassword() + bool Challenge(RakNet::RakString identifier, AddressOrGUID remoteSystem); + + /// \brief Free all memory + void Clear(void); + + /// \internal + virtual void Update(void); + /// \internal + virtual PluginReceiveResult OnReceive(Packet *packet); + /// \internal + virtual void OnRakPeerShutdown(void); + /// \internal + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + + /// \internal + struct PendingChallenge + { + RakNet::RakString identifier; + AddressOrGUID remoteSystem; + RakNet::Time time; + bool sentHash; + }; + + DataStructures::Queue outgoingChallenges; + + /// \internal + struct NonceAndRemoteSystemRequest + { + char nonce[TWO_WAY_AUTHENTICATION_NONCE_LENGTH]; + RakNet::AddressOrGUID remoteSystem; + unsigned short requestId; + RakNet::Time whenGenerated; + }; + /// \internal + struct RAK_DLL_EXPORT NonceGenerator + { + NonceGenerator(); + ~NonceGenerator(); + void GetNonce(char nonce[TWO_WAY_AUTHENTICATION_NONCE_LENGTH], unsigned short *requestId, RakNet::AddressOrGUID remoteSystem); + void GenerateNonce(char nonce[TWO_WAY_AUTHENTICATION_NONCE_LENGTH]); + bool GetNonceById(char nonce[TWO_WAY_AUTHENTICATION_NONCE_LENGTH], unsigned short requestId, RakNet::AddressOrGUID remoteSystem, bool popIfFound); + void Clear(void); + void ClearByAddress(RakNet::AddressOrGUID remoteSystem); + void Update(RakNet::Time curTime); + + DataStructures::List generatedNonces; + unsigned short nextRequestId; + }; + +protected: + void PushToUser(MessageID messageId, RakNet::RakString password, RakNet::AddressOrGUID remoteSystem); + // Key is identifier, data is password + DataStructures::Hash passwords; + + RakNet::Time whenLastTimeoutCheck; + + NonceGenerator nonceGenerator; + + void OnNonceRequest(Packet *packet); + void OnNonceReply(Packet *packet); + PluginReceiveResult OnHashedNonceAndPassword(Packet *packet); + void OnPasswordResult(Packet *packet); + void Hash(char thierNonce[TWO_WAY_AUTHENTICATION_NONCE_LENGTH], RakNet::RakString password, char out[HASHED_NONCE_AND_PW_LENGTH]); +}; + +} // namespace RakNet + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/UDPForwarder.hpp b/include/raknet/UDPForwarder.hpp new file mode 100644 index 0000000..27ba1cc --- /dev/null +++ b/include/raknet/UDPForwarder.hpp @@ -0,0 +1,159 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Forwards UDP datagrams. Independent of RakNet's protocol. +/// + + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_UDPForwarder==1 + +#ifndef __UDP_FORWARDER_H +#define __UDP_FORWARDER_H + +#include "Export.hpp" +#include "RakNetTypes.hpp" +#include "SocketIncludes.hpp" +#include "UDPProxyCommon.hpp" +#include "SimpleMutex.hpp" +#include "RakString.hpp" +#include "RakThread.hpp" +#include "DS_Queue.hpp" +#include "DS_OrderedList.hpp" +#include "LocklessTypes.hpp" +#include "DS_ThreadsafeAllocatingQueue.hpp" + +namespace RakNet +{ + +enum UDPForwarderResult +{ + UDPFORWARDER_FORWARDING_ALREADY_EXISTS, + UDPFORWARDER_NO_SOCKETS, + UDPFORWARDER_BIND_FAILED, + UDPFORWARDER_INVALID_PARAMETERS, + UDPFORWARDER_NOT_RUNNING, + UDPFORWARDER_SUCCESS, + UDPFORWARDER_RESULT_COUNT +}; + +/// \brief Forwards UDP datagrams. Independent of RakNet's protocol. +/// \ingroup NAT_PUNCHTHROUGH_GROUP +class RAK_DLL_EXPORT UDPForwarder +{ +public: + UDPForwarder(); + virtual ~UDPForwarder(); + + /// Starts the system. + /// Required to call before StartForwarding + void Startup(void); + + /// Stops the system, and frees all sockets + void Shutdown(void); + + /// Sets the maximum number of forwarding entries allowed + /// Set according to your available bandwidth and the estimated average bandwidth per forwarded address. + /// \param[in] maxEntries The maximum number of simultaneous forwarding entries. Defaults to 64 (32 connections) + void SetMaxForwardEntries(unsigned short maxEntries); + + /// \return The \a maxEntries parameter passed to SetMaxForwardEntries(), or the default if it was never called + int GetMaxForwardEntries(void) const; + + /// \return How many entries have been used + int GetUsedForwardEntries(void) const; + + /// Forwards datagrams from source to destination, and vice-versa + /// Does nothing if this forward entry already exists via a previous call + /// \pre Call Startup() + /// \note RakNet's protocol will ensure a message is sent at least every 15 seconds, so if routing RakNet messages, it is a reasonable value for timeoutOnNoDataMS, plus an some extra seconds for latency + /// \param[in] source The source IP and port + /// \param[in] destination Where to forward to (and vice-versa) + /// \param[in] timeoutOnNoDataMS If no messages are forwarded for this many MS, then automatically remove this entry. + /// \param[in] forceHostAddress Force binding on a particular address. 0 to use any. + /// \param[in] socketFamily IP version: For IPV4, use AF_INET (default). For IPV6, use AF_INET6. To autoselect, use AF_UNSPEC. + /// \param[out] forwardingPort New opened port for forwarding + /// \param[out] forwardingSocket New opened socket for forwarding + /// \return UDPForwarderResult + UDPForwarderResult StartForwarding( + SystemAddress source, SystemAddress destination, RakNet::TimeMS timeoutOnNoDataMS, + const char *forceHostAddress, unsigned short socketFamily, + unsigned short *forwardingPort, __UDPSOCKET__ *forwardingSocket); + + /// No longer forward datagrams from source to destination + /// \param[in] source The source IP and port + /// \param[in] destination Where to forward to + void StopForwarding(SystemAddress source, SystemAddress destination); + + + struct ForwardEntry + { + ForwardEntry(); + ~ForwardEntry(); + SystemAddress addr1Unconfirmed, addr2Unconfirmed, addr1Confirmed, addr2Confirmed; + RakNet::TimeMS timeLastDatagramForwarded; + __UDPSOCKET__ socket; + RakNet::TimeMS timeoutOnNoDataMS; + short socketFamily; + }; + + +protected: + friend RAK_THREAD_DECLARATION(UpdateUDPForwarderGlobal); + + void UpdateUDPForwarder(void); + void RecvFrom(RakNet::TimeMS curTime, ForwardEntry *forwardEntry); + + struct StartForwardingInputStruct + { + SystemAddress source; + SystemAddress destination; + RakNet::TimeMS timeoutOnNoDataMS; + RakString forceHostAddress; + unsigned short socketFamily; + unsigned int inputId; + }; + + DataStructures::ThreadsafeAllocatingQueue startForwardingInput; + + struct StartForwardingOutputStruct + { + unsigned short forwardingPort; + __UDPSOCKET__ forwardingSocket; + UDPForwarderResult result; + unsigned int inputId; + }; + DataStructures::Queue startForwardingOutput; + SimpleMutex startForwardingOutputMutex; + + struct StopForwardingStruct + { + SystemAddress source; + SystemAddress destination; + }; + DataStructures::ThreadsafeAllocatingQueue stopForwardingCommands; + unsigned int nextInputId; + + // New entries are added to forwardListNotUpdated + DataStructures::List forwardListNotUpdated; +// SimpleMutex forwardListNotUpdatedMutex; + + unsigned short maxForwardEntries; + RakNet::LocklessUint32_t isRunning, threadRunning; + +}; + +} // End namespace + +#endif + +#endif // #if _RAKNET_SUPPORT_UDPForwarder==1 diff --git a/include/raknet/UDPProxyClient.hpp b/include/raknet/UDPProxyClient.hpp new file mode 100644 index 0000000..0be30e2 --- /dev/null +++ b/include/raknet/UDPProxyClient.hpp @@ -0,0 +1,181 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief A RakNet plugin performing networking to communicate with UDPProxyCoordinator. Ultimately used to tell UDPProxyServer to forward UDP packets. + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_UDPProxyClient==1 + +#ifndef __UDP_PROXY_CLIENT_H +#define __UDP_PROXY_CLIENT_H + +#include "Export.hpp" +#include "RakNetTypes.hpp" +#include "PluginInterface2.hpp" +#include "DS_List.hpp" + +/// \defgroup UDP_PROXY_GROUP UDPProxy +/// \brief Forwards UDP datagrams from one system to another. Protocol independent +/// \details Used when NatPunchthroughClient fails +/// \ingroup PLUGINS_GROUP + +namespace RakNet +{ +class UDPProxyClient; + +/// Callback to handle results of calling UDPProxyClient::RequestForwarding() +/// \ingroup UDP_PROXY_GROUP +struct UDPProxyClientResultHandler +{ + UDPProxyClientResultHandler() {} + virtual ~UDPProxyClientResultHandler() {} + + /// Called when our forwarding request was completed. We can now connect to \a targetAddress by using \a proxyAddress instead + /// \param[out] proxyIPAddress IP Address of the proxy server, which will forward messages to targetAddress + /// \param[out] proxyPort Remote port to use on the proxy server, which will forward messages to targetAddress + /// \param[out] proxyCoordinator \a proxyCoordinator parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] sourceAddress \a sourceAddress parameter passed to UDPProxyClient::RequestForwarding. If it was UNASSIGNED_SYSTEM_ADDRESS, it is now our external IP address. + /// \param[out] targetAddress \a targetAddress parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] targetGuid \a targetGuid parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] proxyClient The plugin that is calling this callback + virtual void OnForwardingSuccess(const char *proxyIPAddress, unsigned short proxyPort, + SystemAddress proxyCoordinator, SystemAddress sourceAddress, SystemAddress targetAddress, RakNetGUID targetGuid, RakNet::UDPProxyClient *proxyClientPlugin)=0; + + /// Called when another system has setup forwarding, with our system as the target address. + /// Plugin automatically sends a datagram to proxyIPAddress before this callback, to open our router if necessary. + /// \param[out] proxyIPAddress IP Address of the proxy server, which will forward messages to targetAddress + /// \param[out] proxyPort Remote port to use on the proxy server, which will forward messages to targetAddress + /// \param[out] proxyCoordinator \a proxyCoordinator parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] sourceAddress \a sourceAddress parameter passed to UDPProxyClient::RequestForwarding. This is originating source IP address of the remote system that will be sending to us. + /// \param[out] targetAddress \a targetAddress parameter originally passed to UDPProxyClient::RequestForwarding. This is our external IP address. + /// \param[out] targetGuid \a targetGuid parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] proxyClient The plugin that is calling this callback + virtual void OnForwardingNotification(const char *proxyIPAddress, unsigned short proxyPort, + SystemAddress proxyCoordinator, SystemAddress sourceAddress, SystemAddress targetAddress, RakNetGUID targetGuid, RakNet::UDPProxyClient *proxyClientPlugin)=0; + + /// Called when our forwarding request failed, because no UDPProxyServers are connected to UDPProxyCoordinator + /// \param[out] proxyCoordinator \a proxyCoordinator parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] sourceAddress \a sourceAddress parameter passed to UDPProxyClient::RequestForwarding. If it was UNASSIGNED_SYSTEM_ADDRESS, it is now our external IP address. + /// \param[out] targetAddress \a targetAddress parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] targetGuid \a targetGuid parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] proxyClient The plugin that is calling this callback + virtual void OnNoServersOnline(SystemAddress proxyCoordinator, SystemAddress sourceAddress, SystemAddress targetAddress, RakNetGUID targetGuid, RakNet::UDPProxyClient *proxyClientPlugin)=0; + + /// Called when our forwarding request failed, because no UDPProxyServers are connected to UDPProxyCoordinator + /// \param[out] proxyCoordinator \a proxyCoordinator parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] sourceAddress \a sourceAddress parameter passed to UDPProxyClient::RequestForwarding. If it was UNASSIGNED_SYSTEM_ADDRESS, it is now our external IP address. + /// \param[out] targetAddress \a targetAddress parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] targetGuid \a targetGuid parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] proxyClient The plugin that is calling this callback + virtual void OnRecipientNotConnected(SystemAddress proxyCoordinator, SystemAddress sourceAddress, SystemAddress targetAddress, RakNetGUID targetGuid, RakNet::UDPProxyClient *proxyClientPlugin)=0; + + /// Called when our forwarding request failed, because all UDPProxyServers that are connected to UDPProxyCoordinator are at their capacity + /// Either add more servers, or increase capacity via UDPForwarder::SetMaxForwardEntries() + /// \param[out] proxyCoordinator \a proxyCoordinator parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] sourceAddress \a sourceAddress parameter passed to UDPProxyClient::RequestForwarding. If it was UNASSIGNED_SYSTEM_ADDRESS, it is now our external IP address. + /// \param[out] targetAddress \a targetAddress parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] targetGuid \a targetGuid parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] proxyClient The plugin that is calling this callback + virtual void OnAllServersBusy(SystemAddress proxyCoordinator, SystemAddress sourceAddress, SystemAddress targetAddress, RakNetGUID targetGuid, RakNet::UDPProxyClient *proxyClientPlugin)=0; + + /// Called when our forwarding request is already in progress on the \a proxyCoordinator. + /// This can be ignored, but indicates an unneeded second request + /// \param[out] proxyIPAddress IP Address of the proxy server, which is forwarding messages to targetAddress + /// \param[out] proxyPort Remote port to use on the proxy server, which is forwarding messages to targetAddress + /// \param[out] proxyCoordinator \a proxyCoordinator parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] sourceAddress \a sourceAddress parameter passed to UDPProxyClient::RequestForwarding. If it was UNASSIGNED_SYSTEM_ADDRESS, it is now our external IP address. + /// \param[out] targetAddress \a targetAddress parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] targetGuid \a targetGuid parameter originally passed to UDPProxyClient::RequestForwarding + /// \param[out] proxyClient The plugin that is calling this callback + virtual void OnForwardingInProgress(const char *proxyIPAddress, unsigned short proxyPort, SystemAddress proxyCoordinator, SystemAddress sourceAddress, SystemAddress targetAddress, RakNetGUID targetGuid, RakNet::UDPProxyClient *proxyClientPlugin)=0; +}; + + +/// \brief Communicates with UDPProxyCoordinator, in order to find a UDPProxyServer to forward our datagrams. +/// \details When NAT Punchthrough fails, it is possible to use a non-NAT system to forward messages from us to the recipient, and vice-versa.
    +/// The class to forward messages is UDPForwarder, and it is triggered over the network via the UDPProxyServer plugin.
    +/// The UDPProxyClient connects to UDPProxyCoordinator to get a list of servers running UDPProxyServer, and the coordinator will relay our forwarding request +/// \sa NatPunchthroughServer +/// \sa NatPunchthroughClient +/// \ingroup UDP_PROXY_GROUP +class RAK_DLL_EXPORT UDPProxyClient : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(UDPProxyClient) + + UDPProxyClient(); + ~UDPProxyClient(); + + /// Receives the results of calling RequestForwarding() + /// Set before calling RequestForwarding or you won't know what happened + /// \param[in] resultHandler + void SetResultHandler(UDPProxyClientResultHandler *rh); + + /// Sends a request to proxyCoordinator to find a server and have that server setup UDPForwarder::StartForwarding() on our address to \a targetAddressAsSeenFromCoordinator + /// The forwarded datagrams can be from any UDP source, not just RakNet + /// \pre Must be connected to \a proxyCoordinator + /// \pre Systems running UDPProxyServer must be connected to \a proxyCoordinator and logged in via UDPProxyCoordinator::LoginServer() or UDPProxyServer::LoginToCoordinator() + /// \note May still fail, if all proxy servers have no open connections. + /// \note RakNet's protocol will ensure a message is sent at least every 5 seconds, so if routing RakNet messages, it is a reasonable value for timeoutOnNoDataMS, plus an extra few seconds for latency. + /// \param[in] proxyCoordinator System we are connected to that is running the UDPProxyCoordinator plugin + /// \param[in] sourceAddress External IP address of the system we want to forward messages from. This does not have to be our own system. To specify our own system, you can pass UNASSIGNED_SYSTEM_ADDRESS which the coordinator will treat as our external IP address. + /// \param[in] targetAddressAsSeenFromCoordinator External IP address of the system we want to forward messages to. If this system is connected to UDPProxyCoordinator at this address using RakNet, that system will ping the server and thus open the router for incoming communication. In any other case, you are responsible for doing your own network communication to have that system ping the server. See also targetGuid in the other version of RequestForwarding(), to avoid the need to know the IP address to the coordinator of the destination. + /// \param[in] timeoutOnNoData If no data is sent by the forwarded systems, how long before removing the forward entry from UDPForwarder? UDP_FORWARDER_MAXIMUM_TIMEOUT is the maximum value. Recommended 10 seconds. + /// \param[in] serverSelectionBitstream If you want to send data to UDPProxyCoordinator::GetBestServer(), write it here + /// \return true if the request was sent, false if we are not connected to proxyCoordinator + bool RequestForwarding(SystemAddress proxyCoordinator, SystemAddress sourceAddress, SystemAddress targetAddressAsSeenFromCoordinator, RakNet::TimeMS timeoutOnNoDataMS, RakNet::BitStream *serverSelectionBitstream=0); + + /// Same as above, but specify the target with a GUID, in case you don't know what its address is to the coordinator + /// If requesting forwarding to a RakNet enabled system, then it is easier to use targetGuid instead of targetAddressAsSeenFromCoordinator + bool RequestForwarding(SystemAddress proxyCoordinator, SystemAddress sourceAddress, RakNetGUID targetGuid, RakNet::TimeMS timeoutOnNoDataMS, RakNet::BitStream *serverSelectionBitstream=0); + + /// \internal + virtual void Update(void); + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnRakPeerShutdown(void); + + struct ServerWithPing + { + unsigned short ping; + SystemAddress serverAddress; + }; + struct SenderAndTargetAddress + { + SystemAddress senderClientAddress; + SystemAddress targetClientAddress; + }; + struct PingServerGroup + { + SenderAndTargetAddress sata; + RakNet::TimeMS startPingTime; + SystemAddress coordinatorAddressForPings; + //DataStructures::Multilist serversToPing; + DataStructures::List serversToPing; + bool AreAllServersPinged(void) const; + void SendPingedServersToCoordinator(RakPeerInterface *rakPeerInterface); + }; + //DataStructures::Multilist pingServerGroups; + DataStructures::List pingServerGroups; +protected: + + void OnPingServers(Packet *packet); + void Clear(void); + UDPProxyClientResultHandler *resultHandler; + +}; + +} // End namespace + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/UDPProxyCommon.hpp b/include/raknet/UDPProxyCommon.hpp new file mode 100644 index 0000000..c9a0b49 --- /dev/null +++ b/include/raknet/UDPProxyCommon.hpp @@ -0,0 +1,67 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __UDP_PROXY_COMMON_H +#define __UDP_PROXY_COMMON_H + +// System flow: +/* +UDPProxyClient: End user +UDPProxyServer: open server, to route messages from end users that can't connect to each other using UDPForwarder class. +UDPProxyCoordinator: Server somewhere, connected to by RakNet, to maintain a list of UDPProxyServer + +UDPProxyServer + On startup, log into UDPProxyCoordinator and register self + +UDPProxyClient + Wish to open route to X + Send message to UDPProxyCoordinator containing X, desired timeout + Wait for success or failure + +UDPProxyCoordinator: +* Get openRouteRequest + If no servers registered, return failure + Add entry to memory + chooseBestUDPProxyServer() (overridable, chooses at random by default) + Query this server to StartForwarding(). Return success or failure + If failure, choose another server from the remaining list. If none remaining, return failure. Else return success. +* Disconnect: + If disconnected system is pending client on openRouteRequest, delete that request + If disconnected system is UDPProxyServer, remove from list. For each pending client for this server, choose from remaining servers. +* Login: + Add to UDPProxyServer list, validating password if set +*/ + +// Stored in the second byte after ID_UDP_PROXY_GENERAL +// Otherwise MessageIdentifiers.h is too cluttered and will hit the limit on enumerations in a single byte +enum UDPProxyMessages +{ + ID_UDP_PROXY_FORWARDING_SUCCEEDED, + ID_UDP_PROXY_FORWARDING_NOTIFICATION, + ID_UDP_PROXY_NO_SERVERS_ONLINE, + ID_UDP_PROXY_RECIPIENT_GUID_NOT_CONNECTED_TO_COORDINATOR, + ID_UDP_PROXY_ALL_SERVERS_BUSY, + ID_UDP_PROXY_IN_PROGRESS, + ID_UDP_PROXY_FORWARDING_REQUEST_FROM_CLIENT_TO_COORDINATOR, + ID_UDP_PROXY_PING_SERVERS_FROM_COORDINATOR_TO_CLIENT, + ID_UDP_PROXY_PING_SERVERS_REPLY_FROM_CLIENT_TO_COORDINATOR, + ID_UDP_PROXY_FORWARDING_REQUEST_FROM_COORDINATOR_TO_SERVER, + ID_UDP_PROXY_FORWARDING_REPLY_FROM_SERVER_TO_COORDINATOR, + ID_UDP_PROXY_LOGIN_REQUEST_FROM_SERVER_TO_COORDINATOR, + ID_UDP_PROXY_LOGIN_SUCCESS_FROM_COORDINATOR_TO_SERVER, + ID_UDP_PROXY_ALREADY_LOGGED_IN_FROM_COORDINATOR_TO_SERVER, + ID_UDP_PROXY_NO_PASSWORD_SET_FROM_COORDINATOR_TO_SERVER, + ID_UDP_PROXY_WRONG_PASSWORD_FROM_COORDINATOR_TO_SERVER +}; + + +#define UDP_FORWARDER_MAXIMUM_TIMEOUT (60000 * 10) + +#endif diff --git a/include/raknet/UDPProxyCoordinator.hpp b/include/raknet/UDPProxyCoordinator.hpp new file mode 100644 index 0000000..d0f2cde --- /dev/null +++ b/include/raknet/UDPProxyCoordinator.hpp @@ -0,0 +1,117 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief Essentially maintains a list of servers running UDPProxyServer, and some state management for UDPProxyClient to find a free server to forward datagrams +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_UDPProxyCoordinator==1 && _RAKNET_SUPPORT_UDPForwarder==1 + +#ifndef __UDP_PROXY_COORDINATOR_H +#define __UDP_PROXY_COORDINATOR_H + +#include "Export.hpp" +#include "RakNetTypes.hpp" +#include "PluginInterface2.hpp" +#include "RakString.hpp" +#include "BitStream.hpp" +#include "DS_Queue.hpp" +#include "DS_OrderedList.hpp" + +namespace RakNet +{ + /// When NAT Punchthrough fails, it is possible to use a non-NAT system to forward messages from us to the recipient, and vice-versa + /// The class to forward messages is UDPForwarder, and it is triggered over the network via the UDPProxyServer plugin. + /// The UDPProxyClient connects to UDPProxyCoordinator to get a list of servers running UDPProxyServer, and the coordinator will relay our forwarding request + /// \brief Middleman between UDPProxyServer and UDPProxyClient, maintaining a list of UDPProxyServer, and managing state for clients to find an available forwarding server. + /// \ingroup NAT_PUNCHTHROUGH_GROUP + class RAK_DLL_EXPORT UDPProxyCoordinator : public PluginInterface2 + { + public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(UDPProxyCoordinator) + + UDPProxyCoordinator(); + virtual ~UDPProxyCoordinator(); + + /// For UDPProxyServers logging in remotely, they must pass a password to UDPProxyServer::LoginToCoordinator(). It must match the password set here. + /// If no password is set, they cannot login remotely. + /// By default, no password is set + void SetRemoteLoginPassword(RakNet::RakString password); + + /// \internal + virtual void Update(void); + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + + struct SenderAndTargetAddress + { + SystemAddress senderClientAddress; + RakNetGUID senderClientGuid; + SystemAddress targetClientAddress; + RakNetGUID targetClientGuid; + }; + + struct ServerWithPing + { + unsigned short ping; + SystemAddress serverAddress; + }; + + struct ForwardingRequest + { + RakNet::TimeMS timeoutOnNoDataMS; + RakNet::TimeMS timeoutAfterSuccess; + SenderAndTargetAddress sata; + SystemAddress requestingAddress; // Which system originally sent the network message to start forwarding + SystemAddress currentlyAttemptedServerAddress; + DataStructures::Queue remainingServersToTry; + RakNet::BitStream serverSelectionBitstream; + + DataStructures::List sourceServerPings, targetServerPings; + RakNet::TimeMS timeRequestedPings; + // Order based on sourceServerPings and targetServerPings + void OrderRemainingServersToTry(void); + + }; + protected: + + static int ServerWithPingComp( const unsigned short &key, const UDPProxyCoordinator::ServerWithPing &data ); + static int ForwardingRequestComp( const SenderAndTargetAddress &key, ForwardingRequest* const &data); + + void OnForwardingRequestFromClientToCoordinator(Packet *packet); + void OnLoginRequestFromServerToCoordinator(Packet *packet); + void OnForwardingReplyFromServerToCoordinator(Packet *packet); + void OnPingServersReplyFromClientToCoordinator(Packet *packet); + void TryNextServer(SenderAndTargetAddress sata, ForwardingRequest *fw); + void SendAllBusy(SystemAddress senderClientAddress, SystemAddress targetClientAddress, RakNetGUID targetClientGuid, SystemAddress requestingAddress); + void Clear(void); + + void SendForwardingRequest(SystemAddress sourceAddress, SystemAddress targetAddress, SystemAddress serverAddress, RakNet::TimeMS timeoutOnNoDataMS); + + // Logged in servers + //DataStructures::Multilist serverList; + DataStructures::List serverList; + + // Forwarding requests in progress + //DataStructures::Multilist forwardingRequestList; + DataStructures::OrderedList forwardingRequestList; + + RakNet::RakString remoteLoginPassword; + + }; + +} // End namespace + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/UDPProxyServer.hpp b/include/raknet/UDPProxyServer.hpp new file mode 100644 index 0000000..f68fb0c --- /dev/null +++ b/include/raknet/UDPProxyServer.hpp @@ -0,0 +1,126 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +/// \file +/// \brief A RakNet plugin performing networking to communicate with UDPProxyServer. It allows UDPProxyServer to control our instance of UDPForwarder. +/// + + +#include "NativeFeatureIncludes.hpp" +#if _RAKNET_SUPPORT_UDPProxyServer==1 && _RAKNET_SUPPORT_UDPForwarder==1 + +#ifndef __UDP_PROXY_SERVER_H +#define __UDP_PROXY_SERVER_H + +#include "Export.hpp" +#include "RakNetTypes.hpp" +#include "PluginInterface2.hpp" +#include "UDPForwarder.hpp" +#include "RakString.hpp" + +namespace RakNet +{ +class UDPProxyServer; + +/// Callback to handle results of calling UDPProxyServer::LoginToCoordinator() +/// \ingroup UDP_PROXY_GROUP +struct UDPProxyServerResultHandler +{ + UDPProxyServerResultHandler() {} + virtual ~UDPProxyServerResultHandler() {} + + /// Called when our login succeeds + /// \param[out] usedPassword The password we passed to UDPProxyServer::LoginToCoordinator() + /// \param[out] proxyServer The plugin calling this callback + virtual void OnLoginSuccess(RakNet::RakString usedPassword, RakNet::UDPProxyServer *proxyServerPlugin)=0; + + /// We are already logged in. + /// This login failed, but the system is operational as if it succeeded + /// \param[out] usedPassword The password we passed to UDPProxyServer::LoginToCoordinator() + /// \param[out] proxyServer The plugin calling this callback + virtual void OnAlreadyLoggedIn(RakNet::RakString usedPassword, RakNet::UDPProxyServer *proxyServerPlugin)=0; + + /// The coordinator operator forgot to call UDPProxyCoordinator::SetRemoteLoginPassword() + /// \param[out] usedPassword The password we passed to UDPProxyServer::LoginToCoordinator() + /// \param[out] proxyServer The plugin calling this callback + virtual void OnNoPasswordSet(RakNet::RakString usedPassword, RakNet::UDPProxyServer *proxyServerPlugin)=0; + + /// The coordinator operator set a different password in UDPProxyCoordinator::SetRemoteLoginPassword() than what we passed + /// \param[out] usedPassword The password we passed to UDPProxyServer::LoginToCoordinator() + /// \param[out] proxyServer The plugin calling this callback + virtual void OnWrongPassword(RakNet::RakString usedPassword, RakNet::UDPProxyServer *proxyServerPlugin)=0; +}; + +/// \brief UDPProxyServer to control our instance of UDPForwarder +/// \details When NAT Punchthrough fails, it is possible to use a non-NAT system to forward messages from us to the recipient, and vice-versa.
    +/// The class to forward messages is UDPForwarder, and it is triggered over the network via the UDPProxyServer plugin.
    +/// The UDPProxyServer connects to UDPProxyServer to get a list of servers running UDPProxyServer, and the coordinator will relay our forwarding request. +/// \ingroup UDP_PROXY_GROUP +class RAK_DLL_EXPORT UDPProxyServer : public PluginInterface2 +{ +public: + // GetInstance() and DestroyInstance(instance*) + STATIC_FACTORY_DECLARATIONS(UDPProxyServer) + + UDPProxyServer(); + ~UDPProxyServer(); + + /// Sets the socket family to use, either IPV4 or IPV6 + /// \param[in] socketFamily For IPV4, use AF_INET (default). For IPV6, use AF_INET6. To autoselect, use AF_UNSPEC. + void SetSocketFamily(unsigned short _socketFamily); + + /// Receives the results of calling LoginToCoordinator() + /// Set before calling LoginToCoordinator or you won't know what happened + /// \param[in] resultHandler + void SetResultHandler(UDPProxyServerResultHandler *rh); + + /// Before the coordinator will register the UDPProxyServer, you must login + /// \pre Must be connected to the coordinator + /// \pre Coordinator must have set a password with UDPProxyCoordinator::SetRemoteLoginPassword() + /// \returns false if already logged in, or logging in. Returns true otherwise + bool LoginToCoordinator(RakNet::RakString password, SystemAddress coordinatorAddress); + + /// \brief The server IP reported to the client is the IP address from the server to the coordinator. + /// If the server and coordinator are on the same LAN, you need to call SetServerPublicIP() to tell the client what address to connect to + /// \param[in] ip IP address to report in UDPProxyClientResultHandler::OnForwardingSuccess() and UDPProxyClientResultHandler::OnForwardingNotification() as proxyIPAddress + void SetServerPublicIP(RakString ip); + + /// Operative class that performs the forwarding + /// Exposed so you can call UDPForwarder::SetMaxForwardEntries() if you want to change away from the default + /// UDPForwarder::Startup(), UDPForwarder::Shutdown(), and UDPForwarder::Update() are called automatically by the plugin + UDPForwarder udpForwarder; + + virtual void OnAttach(void); + virtual void OnDetach(void); + + /// \internal + virtual void Update(void); + virtual PluginReceiveResult OnReceive(Packet *packet); + virtual void OnClosedConnection(const SystemAddress &systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason ); + virtual void OnRakPeerStartup(void); + virtual void OnRakPeerShutdown(void); + +protected: + void OnForwardingRequestFromCoordinatorToServer(Packet *packet); + + DataStructures::OrderedList loggingInCoordinators; + DataStructures::OrderedList loggedInCoordinators; + + UDPProxyServerResultHandler *resultHandler; + unsigned short socketFamily; + RakString serverPublicIp; + +}; + +} // End namespace + +#endif + +#endif // _RAKNET_SUPPORT_* diff --git a/include/raknet/VariableDeltaSerializer.hpp b/include/raknet/VariableDeltaSerializer.hpp new file mode 100644 index 0000000..d448d6b --- /dev/null +++ b/include/raknet/VariableDeltaSerializer.hpp @@ -0,0 +1,267 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __VARIABLE_DELTA_SERIALIZER_H +#define __VARIABLE_DELTA_SERIALIZER_H + +#include "VariableListDeltaTracker.hpp" +#include "DS_MemoryPool.hpp" +#include "NativeTypes.hpp" +#include "BitStream.hpp" +#include "PacketPriority.hpp" +#include "DS_OrderedList.hpp" + +namespace RakNet +{ + +/// \brief Class to compare memory values of variables in a current state to a prior state +/// Results of the comparisons will be written to a bitStream, such that only changed variables get written
    +/// Can be used with ReplicaManager3 to Serialize a Replica3 per-variable, rather than comparing the entire object against itself
    +/// Usage:
    +///
    +/// 1. Call BeginUnreliableAckedSerialize(), BeginUniqueSerialize(), or BeginIdenticalSerialize(). In the case of Replica3, this would be in the Serialize() call
    +/// 2. For each variable of the type in step 1, call Serialize(). The same variables must be serialized every tick()
    +/// 3. Call EndSerialize()
    +/// 4. Repeat step 1 for each of the other categories of how to send varaibles
    +///
    +/// On the receiver:
    +///
    +/// 1. Call BeginDeserialize(). In the case of Replica3, this would be in the Deserialize() call
    +/// 2. Call DeserializeVariable() for each variable, in the same order as was Serialized()
    +/// 3. Call EndSerialize()
    +/// \sa The ReplicaManager3 sample +class RAK_DLL_EXPORT VariableDeltaSerializer +{ +protected: + struct RemoteSystemVariableHistory; + struct ChangedVariablesList; + +public: + VariableDeltaSerializer(); + ~VariableDeltaSerializer(); + + struct SerializationContext + { + SerializationContext(); + ~SerializationContext(); + + RakNetGUID guid; + BitStream *bitStream; + uint32_t rakPeerSendReceipt; + RemoteSystemVariableHistory *variableHistory; + RemoteSystemVariableHistory *variableHistoryIdentical; + RemoteSystemVariableHistory *variableHistoryUnique; + ChangedVariablesList *changedVariables; + uint32_t sendReceipt; + PacketReliability serializationMode; + bool anyVariablesWritten; + bool newSystemSend; // Force send all, do not record + }; + + struct DeserializationContext + { + BitStream *bitStream; + }; + + /// \brief Call before doing one or more SerializeVariable calls when the data will be sent UNRELIABLE_WITH_ACK_RECEIPT + /// The last value of each variable will be saved per remote system. Additionally, a history of \a _sendReceipts is stored to determine what to resend on packetloss. + /// When variables are lost, they will be flagged dirty and always resent to the system that lost it + /// Disadvantages: Every variable for every remote system is copied internally, in addition to a history list of what variables changed for which \a _sendReceipt. Very memory and CPU intensive for multiple connections. + /// Advantages: When data needs to be resent by RakNet, RakNet can only resend the value it currently has. This allows the application to control the resend, sending the most recent value of the variable. The end result is that bandwidth is used more efficiently because old data is never sent. + /// \pre Upon getting ID_SND_RECEIPT_LOSS or ID_SND_RECEIPT_ACKED call OnMessageReceipt() + /// \pre AddRemoteSystemVariableHistory() and RemoveRemoteSystemVariableHistory() must be called for new and lost connections + /// \param[in] context Holds the context of this group of serialize calls. This can be a stack object just passed to the function. + /// \param[in] _guid Which system we are sending to + /// \param[in] _bitSteam Which bitStream to write to + /// \param[in] _sendReceipt Returned from RakPeer::IncrementNextSendReceipt() and passed to the Send() or SendLists() function. Identifies this update for ID_SND_RECEIPT_LOSS and ID_SND_RECEIPT_ACKED + void BeginUnreliableAckedSerialize(SerializationContext *context, RakNetGUID _guid, BitStream *_bitStream, uint32_t _sendReceipt); + + /// \brief Call before doing one or more SerializeVariable calls for data that may be sent differently to every remote system (such as an invisibility flag that only teammates can see) + /// The last value of each variable will be saved per remote system. + /// Unlike BeginUnreliableAckedSerialize(), send receipts are not necessary + /// Disadvantages: Every variable for every remote system is copied internally. Very memory and CPU intensive for multiple connections. + /// Advantages: When data is sent differently depending on the recipient, this system can make things easier to use and is as efficient as it can be. + /// \pre AddRemoteSystemVariableHistory() and RemoveRemoteSystemVariableHistory() must be called for new and lost connections + /// \param[in] context Holds the context of this group of serialize calls. This can be a stack object just passed to the function. + /// \param[in] _guid Which system we are sending to + /// \param[in] _bitSteam Which bitStream to write to + void BeginUniqueSerialize(SerializationContext *context, RakNetGUID _guid, BitStream *_bitStream); + + /// \brief Call before doing one or more SerializeVariable calls for data that is sent with the same value to every remote system (such as health, position, etc.) + /// This is the most common type of serialization, and also the most efficient + /// Disadvantages: A copy of every variable still needs to be held, although only once + /// Advantages: After the first serialization, the last serialized bitStream will be used for subsequent sends + /// \pre Call OnPreSerializeTick() before doing any calls to BeginIdenticalSerialize() for each of your objects, once per game tick + /// \param[in] context Holds the context of this group of serialize calls. This can be a stack object just passed to the function. + /// \param[in] _isFirstSerializeToThisSystem Pass true if this is the first time ever serializing to this system (the initial download). This way all variables will be written, rather than checking against prior sent values. + /// \param[in] _bitSteam Which bitStream to write to + void BeginIdenticalSerialize(SerializationContext *context, bool _isFirstSerializeToThisSystem, BitStream *_bitStream); + + /// \brief Call after BeginUnreliableAckedSerialize(), BeginUniqueSerialize(), or BeginIdenticalSerialize(), then after calling SerializeVariable() one or more times + /// \param[in] context Same context pointer passed to BeginUnreliableAckedSerialize(), BeginUniqueSerialize(), or BeginIdenticalSerialize() + void EndSerialize(SerializationContext *context); + + /// \brief Call when you receive the BitStream written by SerializeVariable(), before calling DeserializeVariable() + /// \param[in] context Holds the context of this group of deserialize calls. This can be a stack object just passed to the function. + /// \param[in] _bitStream Pass the bitStream originally passed to and written to by serialize calls + void BeginDeserialize(DeserializationContext *context, BitStream *_bitStream); + + /// \param[in] context Same context pointer passed to BeginDeserialize() + void EndDeserialize(DeserializationContext *context); + + /// BeginUnreliableAckedSerialize() and BeginUniqueSerialize() require knowledge of when connections are added and dropped + /// Call AddRemoteSystemVariableHistory() and RemoveRemoteSystemVariableHistory() to notify the system of these events + /// \param[in] _guid Which system we are sending to + void AddRemoteSystemVariableHistory(RakNetGUID guid); + + /// BeginUnreliableAckedSerialize() and BeginUniqueSerialize() require knowledge of when connections are added and dropped + /// Call AddRemoteSystemVariableHistory() and RemoveRemoteSystemVariableHistory() to notify the system of these events + /// \param[in] _guid Which system we are sending to + void RemoveRemoteSystemVariableHistory(RakNetGUID guid); + + /// BeginIdenticalSerialize() requires knowledge of when serialization has started for an object across multiple systems + /// This way it can setup the flag to do new comparisons against the last sent values, rather than just resending the last sent bitStream + /// For Replica3, overload and call this from Replica3::OnUserReplicaPreSerializeTick() + void OnPreSerializeTick(void); + + /// Call when getting ID_SND_RECEIPT_LOSS or ID_SND_RECEIPT_ACKED for a particular system + /// Example: + /// + /// uint32_t msgNumber; + /// memcpy(&msgNumber, packet->data+1, 4); + /// DataStructures::List replicaListOut; + /// replicaManager.GetReplicasCreatedByMe(replicaListOut); + /// unsigned int idx; + /// for (idx=0; idx < replicaListOut.GetSize(); idx++) + /// { + /// ((SampleReplica*)replicaListOut[idx])->NotifyReplicaOfMessageDeliveryStatus(packet->guid,msgNumber, packet->data[0]==ID_SND_RECEIPT_ACKED); + /// } + /// + /// \param[in] guid Which system we are sending to + /// \param[in] receiptId Encoded in bytes 1-4 inclusive of ID_SND_RECEIPT_LOSS and ID_SND_RECEIPT_ACKED + /// \param[in] messageArrived True for ID_SND_RECEIPT_ACKED, false otherwise + void OnMessageReceipt(RakNetGUID guid, uint32_t receiptId, bool messageArrived); + + /// Call to Serialize a variable + /// Will write to the bitSteam passed to \a context true, variableValue if the variable has changed or has never been written. Otherwise will write false. + /// \pre You have called BeginUnreliableAckedSerialize(), BeginUniqueSerialize(), or BeginIdenticalSerialize() + /// \pre Will also require calling OnPreSerializeTick() if using BeginIdenticalSerialize() + /// \note Be sure to call EndSerialize() after finishing all serializations + /// \param[in] context Same context pointer passed to BeginUnreliableAckedSerialize(), BeginUniqueSerialize(), or BeginIdenticalSerialize() + /// \param[in] variable A variable to write to the bitStream passed to \a context + template + void SerializeVariable(SerializationContext *context, const VarType &variable) + { + if (context->newSystemSend) + { + if (context->variableHistory->variableListDeltaTracker.IsPastEndOfList()==false) + { + // previously sent data to another system + context->bitStream->Write(true); + context->bitStream->Write(variable); + context->anyVariablesWritten=true; + } + else + { + // never sent data to another system + context->variableHistory->variableListDeltaTracker.WriteVarToBitstream(variable, context->bitStream); + context->anyVariablesWritten=true; + } + } + else if (context->serializationMode==UNRELIABLE_WITH_ACK_RECEIPT) + { + context->anyVariablesWritten|= + context->variableHistory->variableListDeltaTracker.WriteVarToBitstream(variable, context->bitStream, context->changedVariables->bitField, context->changedVariables->bitWriteIndex++); + } + else + { + if (context->variableHistoryIdentical) + { + // Identical serialization to a number of systems + if (didComparisonThisTick==false) + context->anyVariablesWritten|= + context->variableHistory->variableListDeltaTracker.WriteVarToBitstream(variable, context->bitStream); + // Else bitstream is written to at the end + } + else + { + // Per-system serialization + context->anyVariablesWritten|= + context->variableHistory->variableListDeltaTracker.WriteVarToBitstream(variable, context->bitStream); + } + } + } + + /// Call to deserialize into a variable + /// \pre You have called BeginDeserialize() + /// \note Be sure to call EndDeserialize() after finishing all deserializations + /// \param[in] context Same context pointer passed to BeginDeserialize() + /// \param[in] variable A variable to write to the bitStream passed to \a context + template + bool DeserializeVariable(DeserializationContext *context, VarType &variable) + { + return VariableListDeltaTracker::ReadVarFromBitstream(variable, context->bitStream); + } + + + +protected: + + // For a given send receipt from RakPeer::Send() track which variables we updated + // That way if that send does not arrive (ID_SND_RECEIPT_LOSS) we can mark those variables as dirty to resend them with current values + struct ChangedVariablesList + { + uint32_t sendReceipt; + unsigned short bitWriteIndex; + unsigned char bitField[56]; + }; + + // static int Replica2ObjectComp( const uint32_t &key, ChangedVariablesList* const &data ); + + static int UpdatedVariablesListPtrComp( const uint32_t &key, ChangedVariablesList* const &data ); + + // For each remote system, track the last values of variables we sent to them, and the history of what values changed per call to Send() + // Every serialize if a variable changes from its last value, send it out again + // Also if a send does not arrive (ID_SND_RECEIPT_LOSS) we use updatedVariablesHistory to mark those variables as dirty, to resend them unreliably with the current values + struct RemoteSystemVariableHistory + { + RakNetGUID guid; + VariableListDeltaTracker variableListDeltaTracker; + DataStructures::OrderedList updatedVariablesHistory; + }; + /// A list of RemoteSystemVariableHistory indexed by guid, one per connection that we serialize to + /// List is added to when SerializeConstruction is called, and removed from when SerializeDestruction is called, or when a given connection is dropped + DataStructures::List remoteSystemVariableHistoryList; + + // Because the ChangedVariablesList is created every serialize and destroyed every receipt I use a pool to avoid fragmentation + DataStructures::MemoryPool updatedVariablesMemoryPool; + + bool didComparisonThisTick; + RakNet::BitStream identicalSerializationBs; + + void FreeVarsAssociatedWithReceipt(RakNetGUID guid, uint32_t receiptId); + void DirtyAndFreeVarsAssociatedWithReceipt(RakNetGUID guid, uint32_t receiptId); + unsigned int GetVarsWrittenPerRemoteSystemListIndex(RakNetGUID guid); + void RemoveRemoteSystemVariableHistory(void); + + RemoteSystemVariableHistory* GetRemoteSystemVariableHistory(RakNetGUID guid); + + ChangedVariablesList *AllocChangedVariablesList(void); + void FreeChangedVariablesList(ChangedVariablesList *changedVariables); + void StoreChangedVariablesList(RemoteSystemVariableHistory *variableHistory, ChangedVariablesList *changedVariables, uint32_t sendReceipt); + + RemoteSystemVariableHistory *StartVariableHistoryWrite(RakNetGUID guid); + unsigned int GetRemoteSystemHistoryListIndex(RakNetGUID guid); + +}; + +} + +#endif diff --git a/include/raknet/VariableListDeltaTracker.hpp b/include/raknet/VariableListDeltaTracker.hpp new file mode 100644 index 0000000..7074c73 --- /dev/null +++ b/include/raknet/VariableListDeltaTracker.hpp @@ -0,0 +1,146 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#include "NativeTypes.hpp" +#include "DS_List.hpp" +#include "RakMemoryOverride.hpp" +#include "BitStream.hpp" + +#ifndef __VARIABLE_LIST_DELTA_TRACKER +#define __VARIABLE_LIST_DELTA_TRACKER + +namespace RakNet +{ +/// Class to write a series of variables, copy the contents to memory, and return if the newly written value is different than what was last written +/// Can also encode the reads, writes, and results directly to/from a bitstream +class VariableListDeltaTracker +{ +public: + VariableListDeltaTracker(); + ~VariableListDeltaTracker(); + + // Call before using a series of WriteVar + void StartWrite(void); + + bool IsPastEndOfList(void) const {return nextWriteIndex>=variableList.Size();} + + /// Records the passed value of the variable to memory, and returns true if the value is different from the write before that (or if it is the first write) + /// \pre Call StartWrite() before doing the first of a series of calls to WriteVar or other functions that call WriteVar + /// \note Variables must be of the same type, written in the same order, each time + template + bool WriteVar(const VarType &varData) + { + RakNet::BitStream temp; + temp.Write(varData); + if (nextWriteIndex>=variableList.Size()) + { + variableList.Push(VariableLastValueNode(temp.GetData(),temp.GetNumberOfBytesUsed()),_FILE_AND_LINE_); + nextWriteIndex++; + return true; // Different because it's new + } + + if (temp.GetNumberOfBytesUsed()!=variableList[nextWriteIndex].byteLength) + { + variableList[nextWriteIndex].lastData=(char*) rakRealloc_Ex(variableList[nextWriteIndex].lastData, temp.GetNumberOfBytesUsed(),_FILE_AND_LINE_); + variableList[nextWriteIndex].byteLength=temp.GetNumberOfBytesUsed(); + memcpy(variableList[nextWriteIndex].lastData,temp.GetData(),temp.GetNumberOfBytesUsed()); + nextWriteIndex++; + variableList[nextWriteIndex].isDirty=false; + return true; // Different because the serialized size is different + } + if (variableList[nextWriteIndex].isDirty==false && memcmp(temp.GetData(),variableList[nextWriteIndex].lastData, variableList[nextWriteIndex].byteLength)==0) + { + nextWriteIndex++; + return false; // Same because not dirty and memcmp is the same + } + + variableList[nextWriteIndex].isDirty=false; + memcpy(variableList[nextWriteIndex].lastData,temp.GetData(),temp.GetNumberOfBytesUsed()); + nextWriteIndex++; + return true; // Different because dirty or memcmp was different + } + /// Calls WriteVar. If the variable has changed, writes true, and writes the variable. Otherwise writes false. + template + bool WriteVarToBitstream(const VarType &varData, RakNet::BitStream *bitStream) + { + bool wasDifferent = WriteVar(varData); + bitStream->Write(wasDifferent); + if (wasDifferent) + { + bitStream->Write(varData); + return true; + } + return false; + } + /// Calls WriteVarToBitstream(). Additionally, adds the boolean result of WriteVar() to boolean bit array + template + bool WriteVarToBitstream(const VarType &varData, RakNet::BitStream *bitStream, unsigned char *bArray, unsigned short writeOffset) + { + if (WriteVarToBitstream(varData,bitStream)==true) + { + BitSize_t numberOfBitsMod8 = writeOffset & 7; + + if ( numberOfBitsMod8 == 0 ) + bArray[ writeOffset >> 3 ] = 0x80; + else + bArray[ writeOffset >> 3 ] |= 0x80 >> ( numberOfBitsMod8 ); // Set the bit to 1 + + return true; + } + else + { + if ( ( writeOffset & 7 ) == 0 ) + bArray[ writeOffset >> 3 ] = 0; + + return false; + } + } + + /// Paired with a call to WriteVarToBitstream(), will read a variable if it had changed. Otherwise the values remains the same. + template + static bool ReadVarFromBitstream(VarType &varData, RakNet::BitStream *bitStream) + { + bool wasWritten; + if (bitStream->Read(wasWritten)==false) + return false; + if (wasWritten) + { + if (bitStream->Read(varData)==false) + return false; + } + return wasWritten; + } + + /// Variables flagged dirty will cause WriteVar() to return true, even if the variable had not otherwise changed + /// This updates all the variables in the list, where in each index \a varsWritten is true, so will the variable at the corresponding index be flagged dirty + void FlagDirtyFromBitArray(unsigned char *bArray); + + /// \internal + struct VariableLastValueNode + { + VariableLastValueNode(); + VariableLastValueNode(const unsigned char *data, int _byteLength); + ~VariableLastValueNode(); + char *lastData; + unsigned int byteLength; + bool isDirty; + }; + +protected: + /// \internal + DataStructures::List variableList; + /// \internal + unsigned int nextWriteIndex; +}; + + +} + +#endif diff --git a/include/raknet/VariadicSQLParser.hpp b/include/raknet/VariadicSQLParser.hpp new file mode 100644 index 0000000..6900d0d --- /dev/null +++ b/include/raknet/VariadicSQLParser.hpp @@ -0,0 +1,34 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __VARIADIC_SQL_PARSER_H +#define __VARIADIC_SQL_PARSER_H + +#include "DS_List.hpp" + +#include + +namespace VariadicSQLParser +{ + struct IndexAndType + { + unsigned int strIndex; + unsigned int typeMappingIndex; + }; + const char* GetTypeMappingAtIndex(int i); + void GetTypeMappingIndices( const char *format, DataStructures::List &indices ); + // Given an SQL string with variadic arguments, allocate argumentBinary and argumentLengths, and hold the parameters in binary format + // Last 2 parameters are out parameters + void ExtractArguments( va_list argptr, const DataStructures::List &indices, char ***argumentBinary, int **argumentLengths ); + void FreeArguments(const DataStructures::List &indices, char **argumentBinary, int *argumentLengths); +} + + +#endif diff --git a/include/raknet/VitaIncludes.hpp b/include/raknet/VitaIncludes.hpp new file mode 100644 index 0000000..f6993a1 --- /dev/null +++ b/include/raknet/VitaIncludes.hpp @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/include/raknet/WSAStartupSingleton.hpp b/include/raknet/WSAStartupSingleton.hpp new file mode 100644 index 0000000..168d463 --- /dev/null +++ b/include/raknet/WSAStartupSingleton.hpp @@ -0,0 +1,26 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __WSA_STARTUP_SINGLETON_H +#define __WSA_STARTUP_SINGLETON_H + +class WSAStartupSingleton +{ +public: + WSAStartupSingleton(); + ~WSAStartupSingleton(); + static void AddRef(void); + static void Deref(void); + +protected: + static int refCount; +}; + +#endif diff --git a/include/raknet/WindowsIncludes.hpp b/include/raknet/WindowsIncludes.hpp new file mode 100644 index 0000000..6363335 --- /dev/null +++ b/include/raknet/WindowsIncludes.hpp @@ -0,0 +1,29 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#if defined (WINDOWS_STORE_RT) +#include +#include +#elif defined (_WIN32) +#include +#include +#include + +// Must always include Winsock2.h before windows.h +// or else: +// winsock2.h(99) : error C2011: 'fd_set' : 'struct' type redefinition +// winsock2.h(134) : warning C4005: 'FD_SET' : macro redefinition +// winsock.h(83) : see previous definition of 'FD_SET' +// winsock2.h(143) : error C2011: 'timeval' : 'struct' type redefinition +// winsock2.h(199) : error C2011: 'hostent' : 'struct' type redefinition +// winsock2.h(212) : error C2011: 'netent' : 'struct' type redefinition +// winsock2.h(219) : error C2011: 'servent' : 'struct' type redefinition + +#endif diff --git a/include/raknet/XBox360Includes.hpp b/include/raknet/XBox360Includes.hpp new file mode 100644 index 0000000..bd70cd1 --- /dev/null +++ b/include/raknet/XBox360Includes.hpp @@ -0,0 +1,57 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/include/raknet/_FindFirst.hpp b/include/raknet/_FindFirst.hpp new file mode 100644 index 0000000..b29fa13 --- /dev/null +++ b/include/raknet/_FindFirst.hpp @@ -0,0 +1,56 @@ +/// +/// Original file by the_viking, fixed by Rmulo Fernandes +/// Should emulate windows finddata structure +/// + +#ifndef GCC_FINDFIRST_H +#define GCC_FINDFIRST_H + +#if (defined(__GNUC__) || defined(__ARMCC_VERSION) || defined(__GCCXML__) || defined(__S3E__) ) && !defined(__WIN32) + +#include + +#include "RakString.hpp" + +#define _A_NORMAL 0x00 // Normal file +#define _A_RDONLY 0x01 // Read-only file +#define _A_HIDDEN 0x02 // Hidden file +#define _A_SYSTEM 0x04 // System file +#define _A_VOLID 0x08 // Volume ID +#define _A_SUBDIR 0x10 // Subdirectory +#define _A_ARCH 0x20 // File changed since last archive +#define FA_NORMAL 0x00 // Synonym of _A_NORMAL +#define FA_RDONLY 0x01 // Synonym of _A_RDONLY +#define FA_HIDDEN 0x02 // Synonym of _A_HIDDEN +#define FA_SYSTEM 0x04 // Synonym of _A_SYSTEM +#define FA_LABEL 0x08 // Synonym of _A_VOLID +#define FA_DIREC 0x10 // Synonym of _A_SUBDIR +#define FA_ARCH 0x20 // Synonym of _A_ARCH + + +const unsigned STRING_BUFFER_SIZE = 512; + +typedef struct _finddata_t +{ + char name[STRING_BUFFER_SIZE]; + int attrib; + unsigned long size; +} _finddata; + +/** + * Hold information about the current search + */ +typedef struct _findinfo_t +{ + DIR* openedDir; + RakNet::RakString filter; + RakNet::RakString dirName; +} _findinfo; + +long _findfirst(const char *name, _finddata_t *f); +int _findnext(long h, _finddata_t *f); +int _findclose(long h); + +#endif +#endif + diff --git a/include/raknet/gettimeofday.hpp b/include/raknet/gettimeofday.hpp new file mode 100644 index 0000000..29ddc5a --- /dev/null +++ b/include/raknet/gettimeofday.hpp @@ -0,0 +1,74 @@ +/* + * Copyright (c) 2014, Oculus VR, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#ifndef __GET_TIME_OF_DAY_H +#define __GET_TIME_OF_DAY_H + +#if defined(_WIN32) && !defined(__GNUC__) &&!defined(__GCCXML__) +#include < time.h > +struct timezone +{ + int tz_minuteswest; /* minutes W of Greenwich */ + int tz_dsttime; /* type of dst correction */ +}; + +#if defined(WINDOWS_STORE_RT) +struct timeval { + long tv_sec; + long tv_usec; +}; +#endif + +int gettimeofday(struct timeval *tv, struct timezone *tz); + + +#else + + + + +#include + +#include + +// Uncomment this if you need to +/* +// http://www.halcode.com/archives/2008/08/26/retrieving-system-time-gettimeofday/ +struct timezone +{ + int tz_minuteswest; + int tz_dsttime; +}; + +#ifdef __cplusplus + +void GetSystemTimeAsFileTime(FILETIME*); + +inline int gettimeofday(struct timeval* p, void* tz ) +{ + union { + long long ns100; // time since 1 Jan 1601 in 100ns units + FILETIME ft; + } now; + + GetSystemTimeAsFileTime( &(now.ft) ); + p->tv_usec=(long)((now.ns100 / 10LL) % 1000000LL ); + p->tv_sec= (long)((now.ns100-(116444736000000000LL))/10000000LL); + return 0; +} + +#else + int gettimeofday(struct timeval* p, void* tz ); +#endif +*/ + +#endif + +#endif diff --git a/include/utils/BitReader.hpp b/include/utils/BitReader.hpp new file mode 100644 index 0000000..5743f40 --- /dev/null +++ b/include/utils/BitReader.hpp @@ -0,0 +1,48 @@ +#ifndef BYTEREADER_HPP +#define BYTEREADER_HPP + +class BitReader{ + + public: + + BitReader(const char* dataArray, unsigned int arrayLength); + + ~BitReader(); + + unsigned char getBitsFromArray(unsigned int count); + + char* getFixedDepthBitsFromArray(unsigned int bitDepth, unsigned count); + + unsigned long long int getBitIndex(); + + unsigned int getBitIndexOfCurrentByte(); + + unsigned int getByteIndex(); + + void setBitIndex(unsigned long long int index); + + void setBitIndexOfCurrentByte(unsigned int index); + + void setByteIndex(unsigned int); + + unsigned int isEOA(); + + static unsigned char getBitsFromByte(unsigned char byte, unsigned int count); + + static unsigned char getBitsFromByte(unsigned char byte, unsigned int index, unsigned int count); + + private: + + unsigned int page; + + unsigned int currentBitCursor; + + unsigned int arrlen=0; + + char* array; + + BitReader(void); + +}; + +#endif // BYTEREADER_HPP diff --git a/include/utils/CRC.hpp b/include/utils/CRC.hpp new file mode 100644 index 0000000..38f1ba6 --- /dev/null +++ b/include/utils/CRC.hpp @@ -0,0 +1,30 @@ +#ifndef CRC_HPP +#define CRC_HPP + +class CRC{ + + private: + + static const unsigned int CRC32_POLYNOMIAL; + + static const unsigned int CRC32_POLYNOMIAL_DRF; + + unsigned int* crc32_table=0; + + public: + + static const unsigned int CRC_MODE_DEFAULT; + + static const unsigned int CRC_MODE_DRF; + + unsigned int update_crc32(const unsigned char* data, unsigned int dataLength, unsigned int old_crc32); + + unsigned int getCRC32(const unsigned char* data, unsigned int dataLength); + + CRC(unsigned int mode=CRC::CRC_MODE_DEFAULT); + + ~CRC(); + +}; + +#endif diff --git a/include/utils/EndianUtils.hpp b/include/utils/EndianUtils.hpp new file mode 100644 index 0000000..d70e7be --- /dev/null +++ b/include/utils/EndianUtils.hpp @@ -0,0 +1,30 @@ +#ifndef ENDIANUTILS_HPP +#define ENDIANUTILS_HPP + +class EndianUtils{ + + private: + + EndianUtils(); + + public: + + static unsigned int isLittleEndian(); + + static unsigned long long reverseBytes(unsigned long long arg, unsigned int dataSize); + + static unsigned long long reverseBytes(unsigned long long arg); + + static unsigned int reverseBytes(unsigned int arg); + + static unsigned short reverseBytes(unsigned short arg); + + static unsigned long long toNativeEndian(unsigned long long arg); + + static unsigned int toNativeEndian(unsigned int arg); + + static unsigned short toNativeEndian(unsigned short arg); + +}; + +#endif diff --git a/include/utils/FileReader.hpp b/include/utils/FileReader.hpp new file mode 100644 index 0000000..2b9fa06 --- /dev/null +++ b/include/utils/FileReader.hpp @@ -0,0 +1,33 @@ +#ifndef FILEREADER_HPP +#define FILEREADER_HPP + +#include + +class FileReader{ + + private: + + FILE* fd; + unsigned int length; + + public: + + FileReader(const char* path); + + void readFully(char* buffer, unsigned int length); + + unsigned int read(char* buffer, unsigned int count); + + unsigned int isEOF(); + + void reset(); + + void seekTo(unsigned int index); + + unsigned int getFileLength(); + + ~FileReader(); + +}; + +#endif // FILEREADER_H diff --git a/include/utils/FileWriter.hpp b/include/utils/FileWriter.hpp new file mode 100644 index 0000000..6402df8 --- /dev/null +++ b/include/utils/FileWriter.hpp @@ -0,0 +1,28 @@ +#ifndef FILEWRITER_HPP +#define FILEWRITER_HPP + +#include + +class FileWriter{ + + private: + + FILE* fd; + + public: + + FileWriter(const char* path); + + void write(const char* data, unsigned int length); + + void reset(); + + void seekTo(unsigned int length); + + unsigned int getCurrentFileSize(); + + ~FileWriter(); + +}; + +#endif // FILEWRITER_H diff --git a/include/utils/GzipUtils.hpp b/include/utils/GzipUtils.hpp new file mode 100644 index 0000000..d9cf512 --- /dev/null +++ b/include/utils/GzipUtils.hpp @@ -0,0 +1,17 @@ +#ifndef GZIPUTILS_HPP +#define GZIPUTILS_HPP + +class GzipUtils{ + + public: + + static unsigned char* compressData(const unsigned char* data, unsigned long dataLength, unsigned long* resultLength); + + static unsigned char* decompressData(const unsigned char* data, unsigned long dataLength, unsigned long* resultLength); + + static int decompressData(const unsigned char* data, unsigned long dataLength, unsigned char* resultBuffer, unsigned long resultBufferSize, unsigned long* resultLength); + + +}; + +#endif // GZIPUTILS_HPP diff --git a/include/utils/HeaderChecker.hpp b/include/utils/HeaderChecker.hpp new file mode 100644 index 0000000..8d003cf --- /dev/null +++ b/include/utils/HeaderChecker.hpp @@ -0,0 +1,25 @@ +#ifndef HEADERCHECKER_HPP +#define HEADERCHECKER_HPP + +class HeaderChecker{ + + private: + + HeaderChecker(); + + public: + + static const unsigned int HEADER_DRF_LENGTH=4; + + static const unsigned char HEADER_DRF[HEADER_DRF_LENGTH]; + + static const unsigned int HEADER_PNG_LENGTH=8; + + static const unsigned char HEADER_PNG[HEADER_PNG_LENGTH]; + + static unsigned char checkHeader(const unsigned char* srcHeader, unsigned int srcHeaderLength, const unsigned char* dstHeader); + +}; + + +#endif // HEADERCHECKER_HPP diff --git a/include/utils/Integer.hpp b/include/utils/Integer.hpp new file mode 100644 index 0000000..2e80a74 --- /dev/null +++ b/include/utils/Integer.hpp @@ -0,0 +1,35 @@ +#ifndef INTEGER_HPP +#define INTEGER_HPP + +#define INTEGER_MAX_LENGTH 20 +#define HEX_MAX_LENGTH 18 + +class Integer{ + + private: + + Integer(); + + public: + + static const char hexChars[17]; + + static int getIntegerLength(const long long int arg); + + static long long int parseInteger(const char* str); + + static long long int parseHex(const char* str); + + static char* toString(const long long int arg); + + static int toString(const long long int arg, char* buffer, const unsigned int buffer_size); + + static char* toHexString(const unsigned long long arg); + + static char* toHexString(const unsigned long long int arg, unsigned int format); + + static int toHexString(const unsigned long long int arg, const unsigned int format, char* buffer, const unsigned int bufferSize); + +}; + +#endif // INTEGER_HPP diff --git a/include/utils/LineReader.hpp b/include/utils/LineReader.hpp new file mode 100644 index 0000000..bcab8b3 --- /dev/null +++ b/include/utils/LineReader.hpp @@ -0,0 +1,28 @@ +#ifndef LINEREADER_HPP +#define LINEREADER_HPP + +#include + +class LineReader{ + + private: + + FILE* fileHandle; + + public: + + LineReader(const char* filePath); + + static char* getLine(const char* data, const unsigned int data_length, const unsigned int lineNum, unsigned int withLineBreak); + + static char* getLine(const char* data, const unsigned int data_length, const unsigned int lineNum); + + unsigned char* getLine(unsigned int lineNum, unsigned int withLineBreak); + + unsigned char* getLine(unsigned int lineNum); + + ~LineReader(); + +}; + +#endif diff --git a/include/utils/Obfuscator.hpp b/include/utils/Obfuscator.hpp new file mode 100644 index 0000000..d3a0497 --- /dev/null +++ b/include/utils/Obfuscator.hpp @@ -0,0 +1,19 @@ +#ifndef OBFUSCATOR_HPP +#define OBFUSCATOR_HPP + +class Obfuscator{ + + public: + + static unsigned char* encode(unsigned char* data, unsigned int dataLength, unsigned int* resultLength); + + static unsigned char* decode(unsigned char* data, unsigned int dataLength, unsigned int* resultLength); + + private: + + Obfuscator(); + + +}; + +#endif diff --git a/include/utils/ZLibUtils.hpp b/include/utils/ZLibUtils.hpp new file mode 100644 index 0000000..a711a5c --- /dev/null +++ b/include/utils/ZLibUtils.hpp @@ -0,0 +1,20 @@ +#ifndef ZLIBUTILS_HPP +#define ZLIBUTILS_HPP + +class ZLibUtils{ + + private: + + ZLibUtils(); + + public: + + static unsigned char* compressData(const unsigned char* data, unsigned long dataLength, unsigned long* resultLength); + + static unsigned char* decompressData(const unsigned char* data, unsigned long dataLength, unsigned long* resultLength); + + static int decompressData(const unsigned char* data, unsigned long dataLength, unsigned char* resultBuffer, unsigned long resultBufferSize, unsigned long* resultLength); + +}; + +#endif // ZLIBUTILS_H diff --git a/include/zlib/crc32.h b/include/zlib/crc32.h new file mode 100644 index 0000000..9e0c778 --- /dev/null +++ b/include/zlib/crc32.h @@ -0,0 +1,441 @@ +/* crc32.h -- tables for rapid CRC calculation + * Generated automatically by crc32.c + */ + +local const z_crc_t FAR crc_table[TBLS][256] = +{ + { + 0x00000000UL, 0x77073096UL, 0xee0e612cUL, 0x990951baUL, 0x076dc419UL, + 0x706af48fUL, 0xe963a535UL, 0x9e6495a3UL, 0x0edb8832UL, 0x79dcb8a4UL, + 0xe0d5e91eUL, 0x97d2d988UL, 0x09b64c2bUL, 0x7eb17cbdUL, 0xe7b82d07UL, + 0x90bf1d91UL, 0x1db71064UL, 0x6ab020f2UL, 0xf3b97148UL, 0x84be41deUL, + 0x1adad47dUL, 0x6ddde4ebUL, 0xf4d4b551UL, 0x83d385c7UL, 0x136c9856UL, + 0x646ba8c0UL, 0xfd62f97aUL, 0x8a65c9ecUL, 0x14015c4fUL, 0x63066cd9UL, + 0xfa0f3d63UL, 0x8d080df5UL, 0x3b6e20c8UL, 0x4c69105eUL, 0xd56041e4UL, + 0xa2677172UL, 0x3c03e4d1UL, 0x4b04d447UL, 0xd20d85fdUL, 0xa50ab56bUL, + 0x35b5a8faUL, 0x42b2986cUL, 0xdbbbc9d6UL, 0xacbcf940UL, 0x32d86ce3UL, + 0x45df5c75UL, 0xdcd60dcfUL, 0xabd13d59UL, 0x26d930acUL, 0x51de003aUL, + 0xc8d75180UL, 0xbfd06116UL, 0x21b4f4b5UL, 0x56b3c423UL, 0xcfba9599UL, + 0xb8bda50fUL, 0x2802b89eUL, 0x5f058808UL, 0xc60cd9b2UL, 0xb10be924UL, + 0x2f6f7c87UL, 0x58684c11UL, 0xc1611dabUL, 0xb6662d3dUL, 0x76dc4190UL, + 0x01db7106UL, 0x98d220bcUL, 0xefd5102aUL, 0x71b18589UL, 0x06b6b51fUL, + 0x9fbfe4a5UL, 0xe8b8d433UL, 0x7807c9a2UL, 0x0f00f934UL, 0x9609a88eUL, + 0xe10e9818UL, 0x7f6a0dbbUL, 0x086d3d2dUL, 0x91646c97UL, 0xe6635c01UL, + 0x6b6b51f4UL, 0x1c6c6162UL, 0x856530d8UL, 0xf262004eUL, 0x6c0695edUL, + 0x1b01a57bUL, 0x8208f4c1UL, 0xf50fc457UL, 0x65b0d9c6UL, 0x12b7e950UL, + 0x8bbeb8eaUL, 0xfcb9887cUL, 0x62dd1ddfUL, 0x15da2d49UL, 0x8cd37cf3UL, + 0xfbd44c65UL, 0x4db26158UL, 0x3ab551ceUL, 0xa3bc0074UL, 0xd4bb30e2UL, + 0x4adfa541UL, 0x3dd895d7UL, 0xa4d1c46dUL, 0xd3d6f4fbUL, 0x4369e96aUL, + 0x346ed9fcUL, 0xad678846UL, 0xda60b8d0UL, 0x44042d73UL, 0x33031de5UL, + 0xaa0a4c5fUL, 0xdd0d7cc9UL, 0x5005713cUL, 0x270241aaUL, 0xbe0b1010UL, + 0xc90c2086UL, 0x5768b525UL, 0x206f85b3UL, 0xb966d409UL, 0xce61e49fUL, + 0x5edef90eUL, 0x29d9c998UL, 0xb0d09822UL, 0xc7d7a8b4UL, 0x59b33d17UL, + 0x2eb40d81UL, 0xb7bd5c3bUL, 0xc0ba6cadUL, 0xedb88320UL, 0x9abfb3b6UL, + 0x03b6e20cUL, 0x74b1d29aUL, 0xead54739UL, 0x9dd277afUL, 0x04db2615UL, + 0x73dc1683UL, 0xe3630b12UL, 0x94643b84UL, 0x0d6d6a3eUL, 0x7a6a5aa8UL, + 0xe40ecf0bUL, 0x9309ff9dUL, 0x0a00ae27UL, 0x7d079eb1UL, 0xf00f9344UL, + 0x8708a3d2UL, 0x1e01f268UL, 0x6906c2feUL, 0xf762575dUL, 0x806567cbUL, + 0x196c3671UL, 0x6e6b06e7UL, 0xfed41b76UL, 0x89d32be0UL, 0x10da7a5aUL, + 0x67dd4accUL, 0xf9b9df6fUL, 0x8ebeeff9UL, 0x17b7be43UL, 0x60b08ed5UL, + 0xd6d6a3e8UL, 0xa1d1937eUL, 0x38d8c2c4UL, 0x4fdff252UL, 0xd1bb67f1UL, + 0xa6bc5767UL, 0x3fb506ddUL, 0x48b2364bUL, 0xd80d2bdaUL, 0xaf0a1b4cUL, + 0x36034af6UL, 0x41047a60UL, 0xdf60efc3UL, 0xa867df55UL, 0x316e8eefUL, + 0x4669be79UL, 0xcb61b38cUL, 0xbc66831aUL, 0x256fd2a0UL, 0x5268e236UL, + 0xcc0c7795UL, 0xbb0b4703UL, 0x220216b9UL, 0x5505262fUL, 0xc5ba3bbeUL, + 0xb2bd0b28UL, 0x2bb45a92UL, 0x5cb36a04UL, 0xc2d7ffa7UL, 0xb5d0cf31UL, + 0x2cd99e8bUL, 0x5bdeae1dUL, 0x9b64c2b0UL, 0xec63f226UL, 0x756aa39cUL, + 0x026d930aUL, 0x9c0906a9UL, 0xeb0e363fUL, 0x72076785UL, 0x05005713UL, + 0x95bf4a82UL, 0xe2b87a14UL, 0x7bb12baeUL, 0x0cb61b38UL, 0x92d28e9bUL, + 0xe5d5be0dUL, 0x7cdcefb7UL, 0x0bdbdf21UL, 0x86d3d2d4UL, 0xf1d4e242UL, + 0x68ddb3f8UL, 0x1fda836eUL, 0x81be16cdUL, 0xf6b9265bUL, 0x6fb077e1UL, + 0x18b74777UL, 0x88085ae6UL, 0xff0f6a70UL, 0x66063bcaUL, 0x11010b5cUL, + 0x8f659effUL, 0xf862ae69UL, 0x616bffd3UL, 0x166ccf45UL, 0xa00ae278UL, + 0xd70dd2eeUL, 0x4e048354UL, 0x3903b3c2UL, 0xa7672661UL, 0xd06016f7UL, + 0x4969474dUL, 0x3e6e77dbUL, 0xaed16a4aUL, 0xd9d65adcUL, 0x40df0b66UL, + 0x37d83bf0UL, 0xa9bcae53UL, 0xdebb9ec5UL, 0x47b2cf7fUL, 0x30b5ffe9UL, + 0xbdbdf21cUL, 0xcabac28aUL, 0x53b39330UL, 0x24b4a3a6UL, 0xbad03605UL, + 0xcdd70693UL, 0x54de5729UL, 0x23d967bfUL, 0xb3667a2eUL, 0xc4614ab8UL, + 0x5d681b02UL, 0x2a6f2b94UL, 0xb40bbe37UL, 0xc30c8ea1UL, 0x5a05df1bUL, + 0x2d02ef8dUL +#ifdef BYFOUR + }, + { + 0x00000000UL, 0x191b3141UL, 0x32366282UL, 0x2b2d53c3UL, 0x646cc504UL, + 0x7d77f445UL, 0x565aa786UL, 0x4f4196c7UL, 0xc8d98a08UL, 0xd1c2bb49UL, + 0xfaefe88aUL, 0xe3f4d9cbUL, 0xacb54f0cUL, 0xb5ae7e4dUL, 0x9e832d8eUL, + 0x87981ccfUL, 0x4ac21251UL, 0x53d92310UL, 0x78f470d3UL, 0x61ef4192UL, + 0x2eaed755UL, 0x37b5e614UL, 0x1c98b5d7UL, 0x05838496UL, 0x821b9859UL, + 0x9b00a918UL, 0xb02dfadbUL, 0xa936cb9aUL, 0xe6775d5dUL, 0xff6c6c1cUL, + 0xd4413fdfUL, 0xcd5a0e9eUL, 0x958424a2UL, 0x8c9f15e3UL, 0xa7b24620UL, + 0xbea97761UL, 0xf1e8e1a6UL, 0xe8f3d0e7UL, 0xc3de8324UL, 0xdac5b265UL, + 0x5d5daeaaUL, 0x44469febUL, 0x6f6bcc28UL, 0x7670fd69UL, 0x39316baeUL, + 0x202a5aefUL, 0x0b07092cUL, 0x121c386dUL, 0xdf4636f3UL, 0xc65d07b2UL, + 0xed705471UL, 0xf46b6530UL, 0xbb2af3f7UL, 0xa231c2b6UL, 0x891c9175UL, + 0x9007a034UL, 0x179fbcfbUL, 0x0e848dbaUL, 0x25a9de79UL, 0x3cb2ef38UL, + 0x73f379ffUL, 0x6ae848beUL, 0x41c51b7dUL, 0x58de2a3cUL, 0xf0794f05UL, + 0xe9627e44UL, 0xc24f2d87UL, 0xdb541cc6UL, 0x94158a01UL, 0x8d0ebb40UL, + 0xa623e883UL, 0xbf38d9c2UL, 0x38a0c50dUL, 0x21bbf44cUL, 0x0a96a78fUL, + 0x138d96ceUL, 0x5ccc0009UL, 0x45d73148UL, 0x6efa628bUL, 0x77e153caUL, + 0xbabb5d54UL, 0xa3a06c15UL, 0x888d3fd6UL, 0x91960e97UL, 0xded79850UL, + 0xc7cca911UL, 0xece1fad2UL, 0xf5facb93UL, 0x7262d75cUL, 0x6b79e61dUL, + 0x4054b5deUL, 0x594f849fUL, 0x160e1258UL, 0x0f152319UL, 0x243870daUL, + 0x3d23419bUL, 0x65fd6ba7UL, 0x7ce65ae6UL, 0x57cb0925UL, 0x4ed03864UL, + 0x0191aea3UL, 0x188a9fe2UL, 0x33a7cc21UL, 0x2abcfd60UL, 0xad24e1afUL, + 0xb43fd0eeUL, 0x9f12832dUL, 0x8609b26cUL, 0xc94824abUL, 0xd05315eaUL, + 0xfb7e4629UL, 0xe2657768UL, 0x2f3f79f6UL, 0x362448b7UL, 0x1d091b74UL, + 0x04122a35UL, 0x4b53bcf2UL, 0x52488db3UL, 0x7965de70UL, 0x607eef31UL, + 0xe7e6f3feUL, 0xfefdc2bfUL, 0xd5d0917cUL, 0xcccba03dUL, 0x838a36faUL, + 0x9a9107bbUL, 0xb1bc5478UL, 0xa8a76539UL, 0x3b83984bUL, 0x2298a90aUL, + 0x09b5fac9UL, 0x10aecb88UL, 0x5fef5d4fUL, 0x46f46c0eUL, 0x6dd93fcdUL, + 0x74c20e8cUL, 0xf35a1243UL, 0xea412302UL, 0xc16c70c1UL, 0xd8774180UL, + 0x9736d747UL, 0x8e2de606UL, 0xa500b5c5UL, 0xbc1b8484UL, 0x71418a1aUL, + 0x685abb5bUL, 0x4377e898UL, 0x5a6cd9d9UL, 0x152d4f1eUL, 0x0c367e5fUL, + 0x271b2d9cUL, 0x3e001cddUL, 0xb9980012UL, 0xa0833153UL, 0x8bae6290UL, + 0x92b553d1UL, 0xddf4c516UL, 0xc4eff457UL, 0xefc2a794UL, 0xf6d996d5UL, + 0xae07bce9UL, 0xb71c8da8UL, 0x9c31de6bUL, 0x852aef2aUL, 0xca6b79edUL, + 0xd37048acUL, 0xf85d1b6fUL, 0xe1462a2eUL, 0x66de36e1UL, 0x7fc507a0UL, + 0x54e85463UL, 0x4df36522UL, 0x02b2f3e5UL, 0x1ba9c2a4UL, 0x30849167UL, + 0x299fa026UL, 0xe4c5aeb8UL, 0xfdde9ff9UL, 0xd6f3cc3aUL, 0xcfe8fd7bUL, + 0x80a96bbcUL, 0x99b25afdUL, 0xb29f093eUL, 0xab84387fUL, 0x2c1c24b0UL, + 0x350715f1UL, 0x1e2a4632UL, 0x07317773UL, 0x4870e1b4UL, 0x516bd0f5UL, + 0x7a468336UL, 0x635db277UL, 0xcbfad74eUL, 0xd2e1e60fUL, 0xf9ccb5ccUL, + 0xe0d7848dUL, 0xaf96124aUL, 0xb68d230bUL, 0x9da070c8UL, 0x84bb4189UL, + 0x03235d46UL, 0x1a386c07UL, 0x31153fc4UL, 0x280e0e85UL, 0x674f9842UL, + 0x7e54a903UL, 0x5579fac0UL, 0x4c62cb81UL, 0x8138c51fUL, 0x9823f45eUL, + 0xb30ea79dUL, 0xaa1596dcUL, 0xe554001bUL, 0xfc4f315aUL, 0xd7626299UL, + 0xce7953d8UL, 0x49e14f17UL, 0x50fa7e56UL, 0x7bd72d95UL, 0x62cc1cd4UL, + 0x2d8d8a13UL, 0x3496bb52UL, 0x1fbbe891UL, 0x06a0d9d0UL, 0x5e7ef3ecUL, + 0x4765c2adUL, 0x6c48916eUL, 0x7553a02fUL, 0x3a1236e8UL, 0x230907a9UL, + 0x0824546aUL, 0x113f652bUL, 0x96a779e4UL, 0x8fbc48a5UL, 0xa4911b66UL, + 0xbd8a2a27UL, 0xf2cbbce0UL, 0xebd08da1UL, 0xc0fdde62UL, 0xd9e6ef23UL, + 0x14bce1bdUL, 0x0da7d0fcUL, 0x268a833fUL, 0x3f91b27eUL, 0x70d024b9UL, + 0x69cb15f8UL, 0x42e6463bUL, 0x5bfd777aUL, 0xdc656bb5UL, 0xc57e5af4UL, + 0xee530937UL, 0xf7483876UL, 0xb809aeb1UL, 0xa1129ff0UL, 0x8a3fcc33UL, + 0x9324fd72UL + }, + { + 0x00000000UL, 0x01c26a37UL, 0x0384d46eUL, 0x0246be59UL, 0x0709a8dcUL, + 0x06cbc2ebUL, 0x048d7cb2UL, 0x054f1685UL, 0x0e1351b8UL, 0x0fd13b8fUL, + 0x0d9785d6UL, 0x0c55efe1UL, 0x091af964UL, 0x08d89353UL, 0x0a9e2d0aUL, + 0x0b5c473dUL, 0x1c26a370UL, 0x1de4c947UL, 0x1fa2771eUL, 0x1e601d29UL, + 0x1b2f0bacUL, 0x1aed619bUL, 0x18abdfc2UL, 0x1969b5f5UL, 0x1235f2c8UL, + 0x13f798ffUL, 0x11b126a6UL, 0x10734c91UL, 0x153c5a14UL, 0x14fe3023UL, + 0x16b88e7aUL, 0x177ae44dUL, 0x384d46e0UL, 0x398f2cd7UL, 0x3bc9928eUL, + 0x3a0bf8b9UL, 0x3f44ee3cUL, 0x3e86840bUL, 0x3cc03a52UL, 0x3d025065UL, + 0x365e1758UL, 0x379c7d6fUL, 0x35dac336UL, 0x3418a901UL, 0x3157bf84UL, + 0x3095d5b3UL, 0x32d36beaUL, 0x331101ddUL, 0x246be590UL, 0x25a98fa7UL, + 0x27ef31feUL, 0x262d5bc9UL, 0x23624d4cUL, 0x22a0277bUL, 0x20e69922UL, + 0x2124f315UL, 0x2a78b428UL, 0x2bbade1fUL, 0x29fc6046UL, 0x283e0a71UL, + 0x2d711cf4UL, 0x2cb376c3UL, 0x2ef5c89aUL, 0x2f37a2adUL, 0x709a8dc0UL, + 0x7158e7f7UL, 0x731e59aeUL, 0x72dc3399UL, 0x7793251cUL, 0x76514f2bUL, + 0x7417f172UL, 0x75d59b45UL, 0x7e89dc78UL, 0x7f4bb64fUL, 0x7d0d0816UL, + 0x7ccf6221UL, 0x798074a4UL, 0x78421e93UL, 0x7a04a0caUL, 0x7bc6cafdUL, + 0x6cbc2eb0UL, 0x6d7e4487UL, 0x6f38fadeUL, 0x6efa90e9UL, 0x6bb5866cUL, + 0x6a77ec5bUL, 0x68315202UL, 0x69f33835UL, 0x62af7f08UL, 0x636d153fUL, + 0x612bab66UL, 0x60e9c151UL, 0x65a6d7d4UL, 0x6464bde3UL, 0x662203baUL, + 0x67e0698dUL, 0x48d7cb20UL, 0x4915a117UL, 0x4b531f4eUL, 0x4a917579UL, + 0x4fde63fcUL, 0x4e1c09cbUL, 0x4c5ab792UL, 0x4d98dda5UL, 0x46c49a98UL, + 0x4706f0afUL, 0x45404ef6UL, 0x448224c1UL, 0x41cd3244UL, 0x400f5873UL, + 0x4249e62aUL, 0x438b8c1dUL, 0x54f16850UL, 0x55330267UL, 0x5775bc3eUL, + 0x56b7d609UL, 0x53f8c08cUL, 0x523aaabbUL, 0x507c14e2UL, 0x51be7ed5UL, + 0x5ae239e8UL, 0x5b2053dfUL, 0x5966ed86UL, 0x58a487b1UL, 0x5deb9134UL, + 0x5c29fb03UL, 0x5e6f455aUL, 0x5fad2f6dUL, 0xe1351b80UL, 0xe0f771b7UL, + 0xe2b1cfeeUL, 0xe373a5d9UL, 0xe63cb35cUL, 0xe7fed96bUL, 0xe5b86732UL, + 0xe47a0d05UL, 0xef264a38UL, 0xeee4200fUL, 0xeca29e56UL, 0xed60f461UL, + 0xe82fe2e4UL, 0xe9ed88d3UL, 0xebab368aUL, 0xea695cbdUL, 0xfd13b8f0UL, + 0xfcd1d2c7UL, 0xfe976c9eUL, 0xff5506a9UL, 0xfa1a102cUL, 0xfbd87a1bUL, + 0xf99ec442UL, 0xf85cae75UL, 0xf300e948UL, 0xf2c2837fUL, 0xf0843d26UL, + 0xf1465711UL, 0xf4094194UL, 0xf5cb2ba3UL, 0xf78d95faUL, 0xf64fffcdUL, + 0xd9785d60UL, 0xd8ba3757UL, 0xdafc890eUL, 0xdb3ee339UL, 0xde71f5bcUL, + 0xdfb39f8bUL, 0xddf521d2UL, 0xdc374be5UL, 0xd76b0cd8UL, 0xd6a966efUL, + 0xd4efd8b6UL, 0xd52db281UL, 0xd062a404UL, 0xd1a0ce33UL, 0xd3e6706aUL, + 0xd2241a5dUL, 0xc55efe10UL, 0xc49c9427UL, 0xc6da2a7eUL, 0xc7184049UL, + 0xc25756ccUL, 0xc3953cfbUL, 0xc1d382a2UL, 0xc011e895UL, 0xcb4dafa8UL, + 0xca8fc59fUL, 0xc8c97bc6UL, 0xc90b11f1UL, 0xcc440774UL, 0xcd866d43UL, + 0xcfc0d31aUL, 0xce02b92dUL, 0x91af9640UL, 0x906dfc77UL, 0x922b422eUL, + 0x93e92819UL, 0x96a63e9cUL, 0x976454abUL, 0x9522eaf2UL, 0x94e080c5UL, + 0x9fbcc7f8UL, 0x9e7eadcfUL, 0x9c381396UL, 0x9dfa79a1UL, 0x98b56f24UL, + 0x99770513UL, 0x9b31bb4aUL, 0x9af3d17dUL, 0x8d893530UL, 0x8c4b5f07UL, + 0x8e0de15eUL, 0x8fcf8b69UL, 0x8a809decUL, 0x8b42f7dbUL, 0x89044982UL, + 0x88c623b5UL, 0x839a6488UL, 0x82580ebfUL, 0x801eb0e6UL, 0x81dcdad1UL, + 0x8493cc54UL, 0x8551a663UL, 0x8717183aUL, 0x86d5720dUL, 0xa9e2d0a0UL, + 0xa820ba97UL, 0xaa6604ceUL, 0xaba46ef9UL, 0xaeeb787cUL, 0xaf29124bUL, + 0xad6fac12UL, 0xacadc625UL, 0xa7f18118UL, 0xa633eb2fUL, 0xa4755576UL, + 0xa5b73f41UL, 0xa0f829c4UL, 0xa13a43f3UL, 0xa37cfdaaUL, 0xa2be979dUL, + 0xb5c473d0UL, 0xb40619e7UL, 0xb640a7beUL, 0xb782cd89UL, 0xb2cddb0cUL, + 0xb30fb13bUL, 0xb1490f62UL, 0xb08b6555UL, 0xbbd72268UL, 0xba15485fUL, + 0xb853f606UL, 0xb9919c31UL, 0xbcde8ab4UL, 0xbd1ce083UL, 0xbf5a5edaUL, + 0xbe9834edUL + }, + { + 0x00000000UL, 0xb8bc6765UL, 0xaa09c88bUL, 0x12b5afeeUL, 0x8f629757UL, + 0x37def032UL, 0x256b5fdcUL, 0x9dd738b9UL, 0xc5b428efUL, 0x7d084f8aUL, + 0x6fbde064UL, 0xd7018701UL, 0x4ad6bfb8UL, 0xf26ad8ddUL, 0xe0df7733UL, + 0x58631056UL, 0x5019579fUL, 0xe8a530faUL, 0xfa109f14UL, 0x42acf871UL, + 0xdf7bc0c8UL, 0x67c7a7adUL, 0x75720843UL, 0xcdce6f26UL, 0x95ad7f70UL, + 0x2d111815UL, 0x3fa4b7fbUL, 0x8718d09eUL, 0x1acfe827UL, 0xa2738f42UL, + 0xb0c620acUL, 0x087a47c9UL, 0xa032af3eUL, 0x188ec85bUL, 0x0a3b67b5UL, + 0xb28700d0UL, 0x2f503869UL, 0x97ec5f0cUL, 0x8559f0e2UL, 0x3de59787UL, + 0x658687d1UL, 0xdd3ae0b4UL, 0xcf8f4f5aUL, 0x7733283fUL, 0xeae41086UL, + 0x525877e3UL, 0x40edd80dUL, 0xf851bf68UL, 0xf02bf8a1UL, 0x48979fc4UL, + 0x5a22302aUL, 0xe29e574fUL, 0x7f496ff6UL, 0xc7f50893UL, 0xd540a77dUL, + 0x6dfcc018UL, 0x359fd04eUL, 0x8d23b72bUL, 0x9f9618c5UL, 0x272a7fa0UL, + 0xbafd4719UL, 0x0241207cUL, 0x10f48f92UL, 0xa848e8f7UL, 0x9b14583dUL, + 0x23a83f58UL, 0x311d90b6UL, 0x89a1f7d3UL, 0x1476cf6aUL, 0xaccaa80fUL, + 0xbe7f07e1UL, 0x06c36084UL, 0x5ea070d2UL, 0xe61c17b7UL, 0xf4a9b859UL, + 0x4c15df3cUL, 0xd1c2e785UL, 0x697e80e0UL, 0x7bcb2f0eUL, 0xc377486bUL, + 0xcb0d0fa2UL, 0x73b168c7UL, 0x6104c729UL, 0xd9b8a04cUL, 0x446f98f5UL, + 0xfcd3ff90UL, 0xee66507eUL, 0x56da371bUL, 0x0eb9274dUL, 0xb6054028UL, + 0xa4b0efc6UL, 0x1c0c88a3UL, 0x81dbb01aUL, 0x3967d77fUL, 0x2bd27891UL, + 0x936e1ff4UL, 0x3b26f703UL, 0x839a9066UL, 0x912f3f88UL, 0x299358edUL, + 0xb4446054UL, 0x0cf80731UL, 0x1e4da8dfUL, 0xa6f1cfbaUL, 0xfe92dfecUL, + 0x462eb889UL, 0x549b1767UL, 0xec277002UL, 0x71f048bbUL, 0xc94c2fdeUL, + 0xdbf98030UL, 0x6345e755UL, 0x6b3fa09cUL, 0xd383c7f9UL, 0xc1366817UL, + 0x798a0f72UL, 0xe45d37cbUL, 0x5ce150aeUL, 0x4e54ff40UL, 0xf6e89825UL, + 0xae8b8873UL, 0x1637ef16UL, 0x048240f8UL, 0xbc3e279dUL, 0x21e91f24UL, + 0x99557841UL, 0x8be0d7afUL, 0x335cb0caUL, 0xed59b63bUL, 0x55e5d15eUL, + 0x47507eb0UL, 0xffec19d5UL, 0x623b216cUL, 0xda874609UL, 0xc832e9e7UL, + 0x708e8e82UL, 0x28ed9ed4UL, 0x9051f9b1UL, 0x82e4565fUL, 0x3a58313aUL, + 0xa78f0983UL, 0x1f336ee6UL, 0x0d86c108UL, 0xb53aa66dUL, 0xbd40e1a4UL, + 0x05fc86c1UL, 0x1749292fUL, 0xaff54e4aUL, 0x322276f3UL, 0x8a9e1196UL, + 0x982bbe78UL, 0x2097d91dUL, 0x78f4c94bUL, 0xc048ae2eUL, 0xd2fd01c0UL, + 0x6a4166a5UL, 0xf7965e1cUL, 0x4f2a3979UL, 0x5d9f9697UL, 0xe523f1f2UL, + 0x4d6b1905UL, 0xf5d77e60UL, 0xe762d18eUL, 0x5fdeb6ebUL, 0xc2098e52UL, + 0x7ab5e937UL, 0x680046d9UL, 0xd0bc21bcUL, 0x88df31eaUL, 0x3063568fUL, + 0x22d6f961UL, 0x9a6a9e04UL, 0x07bda6bdUL, 0xbf01c1d8UL, 0xadb46e36UL, + 0x15080953UL, 0x1d724e9aUL, 0xa5ce29ffUL, 0xb77b8611UL, 0x0fc7e174UL, + 0x9210d9cdUL, 0x2aacbea8UL, 0x38191146UL, 0x80a57623UL, 0xd8c66675UL, + 0x607a0110UL, 0x72cfaefeUL, 0xca73c99bUL, 0x57a4f122UL, 0xef189647UL, + 0xfdad39a9UL, 0x45115eccUL, 0x764dee06UL, 0xcef18963UL, 0xdc44268dUL, + 0x64f841e8UL, 0xf92f7951UL, 0x41931e34UL, 0x5326b1daUL, 0xeb9ad6bfUL, + 0xb3f9c6e9UL, 0x0b45a18cUL, 0x19f00e62UL, 0xa14c6907UL, 0x3c9b51beUL, + 0x842736dbUL, 0x96929935UL, 0x2e2efe50UL, 0x2654b999UL, 0x9ee8defcUL, + 0x8c5d7112UL, 0x34e11677UL, 0xa9362eceUL, 0x118a49abUL, 0x033fe645UL, + 0xbb838120UL, 0xe3e09176UL, 0x5b5cf613UL, 0x49e959fdUL, 0xf1553e98UL, + 0x6c820621UL, 0xd43e6144UL, 0xc68bceaaUL, 0x7e37a9cfUL, 0xd67f4138UL, + 0x6ec3265dUL, 0x7c7689b3UL, 0xc4caeed6UL, 0x591dd66fUL, 0xe1a1b10aUL, + 0xf3141ee4UL, 0x4ba87981UL, 0x13cb69d7UL, 0xab770eb2UL, 0xb9c2a15cUL, + 0x017ec639UL, 0x9ca9fe80UL, 0x241599e5UL, 0x36a0360bUL, 0x8e1c516eUL, + 0x866616a7UL, 0x3eda71c2UL, 0x2c6fde2cUL, 0x94d3b949UL, 0x090481f0UL, + 0xb1b8e695UL, 0xa30d497bUL, 0x1bb12e1eUL, 0x43d23e48UL, 0xfb6e592dUL, + 0xe9dbf6c3UL, 0x516791a6UL, 0xccb0a91fUL, 0x740cce7aUL, 0x66b96194UL, + 0xde0506f1UL + }, + { + 0x00000000UL, 0x96300777UL, 0x2c610eeeUL, 0xba510999UL, 0x19c46d07UL, + 0x8ff46a70UL, 0x35a563e9UL, 0xa395649eUL, 0x3288db0eUL, 0xa4b8dc79UL, + 0x1ee9d5e0UL, 0x88d9d297UL, 0x2b4cb609UL, 0xbd7cb17eUL, 0x072db8e7UL, + 0x911dbf90UL, 0x6410b71dUL, 0xf220b06aUL, 0x4871b9f3UL, 0xde41be84UL, + 0x7dd4da1aUL, 0xebe4dd6dUL, 0x51b5d4f4UL, 0xc785d383UL, 0x56986c13UL, + 0xc0a86b64UL, 0x7af962fdUL, 0xecc9658aUL, 0x4f5c0114UL, 0xd96c0663UL, + 0x633d0ffaUL, 0xf50d088dUL, 0xc8206e3bUL, 0x5e10694cUL, 0xe44160d5UL, + 0x727167a2UL, 0xd1e4033cUL, 0x47d4044bUL, 0xfd850dd2UL, 0x6bb50aa5UL, + 0xfaa8b535UL, 0x6c98b242UL, 0xd6c9bbdbUL, 0x40f9bcacUL, 0xe36cd832UL, + 0x755cdf45UL, 0xcf0dd6dcUL, 0x593dd1abUL, 0xac30d926UL, 0x3a00de51UL, + 0x8051d7c8UL, 0x1661d0bfUL, 0xb5f4b421UL, 0x23c4b356UL, 0x9995bacfUL, + 0x0fa5bdb8UL, 0x9eb80228UL, 0x0888055fUL, 0xb2d90cc6UL, 0x24e90bb1UL, + 0x877c6f2fUL, 0x114c6858UL, 0xab1d61c1UL, 0x3d2d66b6UL, 0x9041dc76UL, + 0x0671db01UL, 0xbc20d298UL, 0x2a10d5efUL, 0x8985b171UL, 0x1fb5b606UL, + 0xa5e4bf9fUL, 0x33d4b8e8UL, 0xa2c90778UL, 0x34f9000fUL, 0x8ea80996UL, + 0x18980ee1UL, 0xbb0d6a7fUL, 0x2d3d6d08UL, 0x976c6491UL, 0x015c63e6UL, + 0xf4516b6bUL, 0x62616c1cUL, 0xd8306585UL, 0x4e0062f2UL, 0xed95066cUL, + 0x7ba5011bUL, 0xc1f40882UL, 0x57c40ff5UL, 0xc6d9b065UL, 0x50e9b712UL, + 0xeab8be8bUL, 0x7c88b9fcUL, 0xdf1ddd62UL, 0x492dda15UL, 0xf37cd38cUL, + 0x654cd4fbUL, 0x5861b24dUL, 0xce51b53aUL, 0x7400bca3UL, 0xe230bbd4UL, + 0x41a5df4aUL, 0xd795d83dUL, 0x6dc4d1a4UL, 0xfbf4d6d3UL, 0x6ae96943UL, + 0xfcd96e34UL, 0x468867adUL, 0xd0b860daUL, 0x732d0444UL, 0xe51d0333UL, + 0x5f4c0aaaUL, 0xc97c0dddUL, 0x3c710550UL, 0xaa410227UL, 0x10100bbeUL, + 0x86200cc9UL, 0x25b56857UL, 0xb3856f20UL, 0x09d466b9UL, 0x9fe461ceUL, + 0x0ef9de5eUL, 0x98c9d929UL, 0x2298d0b0UL, 0xb4a8d7c7UL, 0x173db359UL, + 0x810db42eUL, 0x3b5cbdb7UL, 0xad6cbac0UL, 0x2083b8edUL, 0xb6b3bf9aUL, + 0x0ce2b603UL, 0x9ad2b174UL, 0x3947d5eaUL, 0xaf77d29dUL, 0x1526db04UL, + 0x8316dc73UL, 0x120b63e3UL, 0x843b6494UL, 0x3e6a6d0dUL, 0xa85a6a7aUL, + 0x0bcf0ee4UL, 0x9dff0993UL, 0x27ae000aUL, 0xb19e077dUL, 0x44930ff0UL, + 0xd2a30887UL, 0x68f2011eUL, 0xfec20669UL, 0x5d5762f7UL, 0xcb676580UL, + 0x71366c19UL, 0xe7066b6eUL, 0x761bd4feUL, 0xe02bd389UL, 0x5a7ada10UL, + 0xcc4add67UL, 0x6fdfb9f9UL, 0xf9efbe8eUL, 0x43beb717UL, 0xd58eb060UL, + 0xe8a3d6d6UL, 0x7e93d1a1UL, 0xc4c2d838UL, 0x52f2df4fUL, 0xf167bbd1UL, + 0x6757bca6UL, 0xdd06b53fUL, 0x4b36b248UL, 0xda2b0dd8UL, 0x4c1b0aafUL, + 0xf64a0336UL, 0x607a0441UL, 0xc3ef60dfUL, 0x55df67a8UL, 0xef8e6e31UL, + 0x79be6946UL, 0x8cb361cbUL, 0x1a8366bcUL, 0xa0d26f25UL, 0x36e26852UL, + 0x95770cccUL, 0x03470bbbUL, 0xb9160222UL, 0x2f260555UL, 0xbe3bbac5UL, + 0x280bbdb2UL, 0x925ab42bUL, 0x046ab35cUL, 0xa7ffd7c2UL, 0x31cfd0b5UL, + 0x8b9ed92cUL, 0x1daede5bUL, 0xb0c2649bUL, 0x26f263ecUL, 0x9ca36a75UL, + 0x0a936d02UL, 0xa906099cUL, 0x3f360eebUL, 0x85670772UL, 0x13570005UL, + 0x824abf95UL, 0x147ab8e2UL, 0xae2bb17bUL, 0x381bb60cUL, 0x9b8ed292UL, + 0x0dbed5e5UL, 0xb7efdc7cUL, 0x21dfdb0bUL, 0xd4d2d386UL, 0x42e2d4f1UL, + 0xf8b3dd68UL, 0x6e83da1fUL, 0xcd16be81UL, 0x5b26b9f6UL, 0xe177b06fUL, + 0x7747b718UL, 0xe65a0888UL, 0x706a0fffUL, 0xca3b0666UL, 0x5c0b0111UL, + 0xff9e658fUL, 0x69ae62f8UL, 0xd3ff6b61UL, 0x45cf6c16UL, 0x78e20aa0UL, + 0xeed20dd7UL, 0x5483044eUL, 0xc2b30339UL, 0x612667a7UL, 0xf71660d0UL, + 0x4d476949UL, 0xdb776e3eUL, 0x4a6ad1aeUL, 0xdc5ad6d9UL, 0x660bdf40UL, + 0xf03bd837UL, 0x53aebca9UL, 0xc59ebbdeUL, 0x7fcfb247UL, 0xe9ffb530UL, + 0x1cf2bdbdUL, 0x8ac2bacaUL, 0x3093b353UL, 0xa6a3b424UL, 0x0536d0baUL, + 0x9306d7cdUL, 0x2957de54UL, 0xbf67d923UL, 0x2e7a66b3UL, 0xb84a61c4UL, + 0x021b685dUL, 0x942b6f2aUL, 0x37be0bb4UL, 0xa18e0cc3UL, 0x1bdf055aUL, + 0x8def022dUL + }, + { + 0x00000000UL, 0x41311b19UL, 0x82623632UL, 0xc3532d2bUL, 0x04c56c64UL, + 0x45f4777dUL, 0x86a75a56UL, 0xc796414fUL, 0x088ad9c8UL, 0x49bbc2d1UL, + 0x8ae8effaUL, 0xcbd9f4e3UL, 0x0c4fb5acUL, 0x4d7eaeb5UL, 0x8e2d839eUL, + 0xcf1c9887UL, 0x5112c24aUL, 0x1023d953UL, 0xd370f478UL, 0x9241ef61UL, + 0x55d7ae2eUL, 0x14e6b537UL, 0xd7b5981cUL, 0x96848305UL, 0x59981b82UL, + 0x18a9009bUL, 0xdbfa2db0UL, 0x9acb36a9UL, 0x5d5d77e6UL, 0x1c6c6cffUL, + 0xdf3f41d4UL, 0x9e0e5acdUL, 0xa2248495UL, 0xe3159f8cUL, 0x2046b2a7UL, + 0x6177a9beUL, 0xa6e1e8f1UL, 0xe7d0f3e8UL, 0x2483dec3UL, 0x65b2c5daUL, + 0xaaae5d5dUL, 0xeb9f4644UL, 0x28cc6b6fUL, 0x69fd7076UL, 0xae6b3139UL, + 0xef5a2a20UL, 0x2c09070bUL, 0x6d381c12UL, 0xf33646dfUL, 0xb2075dc6UL, + 0x715470edUL, 0x30656bf4UL, 0xf7f32abbUL, 0xb6c231a2UL, 0x75911c89UL, + 0x34a00790UL, 0xfbbc9f17UL, 0xba8d840eUL, 0x79dea925UL, 0x38efb23cUL, + 0xff79f373UL, 0xbe48e86aUL, 0x7d1bc541UL, 0x3c2ade58UL, 0x054f79f0UL, + 0x447e62e9UL, 0x872d4fc2UL, 0xc61c54dbUL, 0x018a1594UL, 0x40bb0e8dUL, + 0x83e823a6UL, 0xc2d938bfUL, 0x0dc5a038UL, 0x4cf4bb21UL, 0x8fa7960aUL, + 0xce968d13UL, 0x0900cc5cUL, 0x4831d745UL, 0x8b62fa6eUL, 0xca53e177UL, + 0x545dbbbaUL, 0x156ca0a3UL, 0xd63f8d88UL, 0x970e9691UL, 0x5098d7deUL, + 0x11a9ccc7UL, 0xd2fae1ecUL, 0x93cbfaf5UL, 0x5cd76272UL, 0x1de6796bUL, + 0xdeb55440UL, 0x9f844f59UL, 0x58120e16UL, 0x1923150fUL, 0xda703824UL, + 0x9b41233dUL, 0xa76bfd65UL, 0xe65ae67cUL, 0x2509cb57UL, 0x6438d04eUL, + 0xa3ae9101UL, 0xe29f8a18UL, 0x21cca733UL, 0x60fdbc2aUL, 0xafe124adUL, + 0xeed03fb4UL, 0x2d83129fUL, 0x6cb20986UL, 0xab2448c9UL, 0xea1553d0UL, + 0x29467efbUL, 0x687765e2UL, 0xf6793f2fUL, 0xb7482436UL, 0x741b091dUL, + 0x352a1204UL, 0xf2bc534bUL, 0xb38d4852UL, 0x70de6579UL, 0x31ef7e60UL, + 0xfef3e6e7UL, 0xbfc2fdfeUL, 0x7c91d0d5UL, 0x3da0cbccUL, 0xfa368a83UL, + 0xbb07919aUL, 0x7854bcb1UL, 0x3965a7a8UL, 0x4b98833bUL, 0x0aa99822UL, + 0xc9fab509UL, 0x88cbae10UL, 0x4f5def5fUL, 0x0e6cf446UL, 0xcd3fd96dUL, + 0x8c0ec274UL, 0x43125af3UL, 0x022341eaUL, 0xc1706cc1UL, 0x804177d8UL, + 0x47d73697UL, 0x06e62d8eUL, 0xc5b500a5UL, 0x84841bbcUL, 0x1a8a4171UL, + 0x5bbb5a68UL, 0x98e87743UL, 0xd9d96c5aUL, 0x1e4f2d15UL, 0x5f7e360cUL, + 0x9c2d1b27UL, 0xdd1c003eUL, 0x120098b9UL, 0x533183a0UL, 0x9062ae8bUL, + 0xd153b592UL, 0x16c5f4ddUL, 0x57f4efc4UL, 0x94a7c2efUL, 0xd596d9f6UL, + 0xe9bc07aeUL, 0xa88d1cb7UL, 0x6bde319cUL, 0x2aef2a85UL, 0xed796bcaUL, + 0xac4870d3UL, 0x6f1b5df8UL, 0x2e2a46e1UL, 0xe136de66UL, 0xa007c57fUL, + 0x6354e854UL, 0x2265f34dUL, 0xe5f3b202UL, 0xa4c2a91bUL, 0x67918430UL, + 0x26a09f29UL, 0xb8aec5e4UL, 0xf99fdefdUL, 0x3accf3d6UL, 0x7bfde8cfUL, + 0xbc6ba980UL, 0xfd5ab299UL, 0x3e099fb2UL, 0x7f3884abUL, 0xb0241c2cUL, + 0xf1150735UL, 0x32462a1eUL, 0x73773107UL, 0xb4e17048UL, 0xf5d06b51UL, + 0x3683467aUL, 0x77b25d63UL, 0x4ed7facbUL, 0x0fe6e1d2UL, 0xccb5ccf9UL, + 0x8d84d7e0UL, 0x4a1296afUL, 0x0b238db6UL, 0xc870a09dUL, 0x8941bb84UL, + 0x465d2303UL, 0x076c381aUL, 0xc43f1531UL, 0x850e0e28UL, 0x42984f67UL, + 0x03a9547eUL, 0xc0fa7955UL, 0x81cb624cUL, 0x1fc53881UL, 0x5ef42398UL, + 0x9da70eb3UL, 0xdc9615aaUL, 0x1b0054e5UL, 0x5a314ffcUL, 0x996262d7UL, + 0xd85379ceUL, 0x174fe149UL, 0x567efa50UL, 0x952dd77bUL, 0xd41ccc62UL, + 0x138a8d2dUL, 0x52bb9634UL, 0x91e8bb1fUL, 0xd0d9a006UL, 0xecf37e5eUL, + 0xadc26547UL, 0x6e91486cUL, 0x2fa05375UL, 0xe836123aUL, 0xa9070923UL, + 0x6a542408UL, 0x2b653f11UL, 0xe479a796UL, 0xa548bc8fUL, 0x661b91a4UL, + 0x272a8abdUL, 0xe0bccbf2UL, 0xa18dd0ebUL, 0x62defdc0UL, 0x23efe6d9UL, + 0xbde1bc14UL, 0xfcd0a70dUL, 0x3f838a26UL, 0x7eb2913fUL, 0xb924d070UL, + 0xf815cb69UL, 0x3b46e642UL, 0x7a77fd5bUL, 0xb56b65dcUL, 0xf45a7ec5UL, + 0x370953eeUL, 0x763848f7UL, 0xb1ae09b8UL, 0xf09f12a1UL, 0x33cc3f8aUL, + 0x72fd2493UL + }, + { + 0x00000000UL, 0x376ac201UL, 0x6ed48403UL, 0x59be4602UL, 0xdca80907UL, + 0xebc2cb06UL, 0xb27c8d04UL, 0x85164f05UL, 0xb851130eUL, 0x8f3bd10fUL, + 0xd685970dUL, 0xe1ef550cUL, 0x64f91a09UL, 0x5393d808UL, 0x0a2d9e0aUL, + 0x3d475c0bUL, 0x70a3261cUL, 0x47c9e41dUL, 0x1e77a21fUL, 0x291d601eUL, + 0xac0b2f1bUL, 0x9b61ed1aUL, 0xc2dfab18UL, 0xf5b56919UL, 0xc8f23512UL, + 0xff98f713UL, 0xa626b111UL, 0x914c7310UL, 0x145a3c15UL, 0x2330fe14UL, + 0x7a8eb816UL, 0x4de47a17UL, 0xe0464d38UL, 0xd72c8f39UL, 0x8e92c93bUL, + 0xb9f80b3aUL, 0x3cee443fUL, 0x0b84863eUL, 0x523ac03cUL, 0x6550023dUL, + 0x58175e36UL, 0x6f7d9c37UL, 0x36c3da35UL, 0x01a91834UL, 0x84bf5731UL, + 0xb3d59530UL, 0xea6bd332UL, 0xdd011133UL, 0x90e56b24UL, 0xa78fa925UL, + 0xfe31ef27UL, 0xc95b2d26UL, 0x4c4d6223UL, 0x7b27a022UL, 0x2299e620UL, + 0x15f32421UL, 0x28b4782aUL, 0x1fdeba2bUL, 0x4660fc29UL, 0x710a3e28UL, + 0xf41c712dUL, 0xc376b32cUL, 0x9ac8f52eUL, 0xada2372fUL, 0xc08d9a70UL, + 0xf7e75871UL, 0xae591e73UL, 0x9933dc72UL, 0x1c259377UL, 0x2b4f5176UL, + 0x72f11774UL, 0x459bd575UL, 0x78dc897eUL, 0x4fb64b7fUL, 0x16080d7dUL, + 0x2162cf7cUL, 0xa4748079UL, 0x931e4278UL, 0xcaa0047aUL, 0xfdcac67bUL, + 0xb02ebc6cUL, 0x87447e6dUL, 0xdefa386fUL, 0xe990fa6eUL, 0x6c86b56bUL, + 0x5bec776aUL, 0x02523168UL, 0x3538f369UL, 0x087faf62UL, 0x3f156d63UL, + 0x66ab2b61UL, 0x51c1e960UL, 0xd4d7a665UL, 0xe3bd6464UL, 0xba032266UL, + 0x8d69e067UL, 0x20cbd748UL, 0x17a11549UL, 0x4e1f534bUL, 0x7975914aUL, + 0xfc63de4fUL, 0xcb091c4eUL, 0x92b75a4cUL, 0xa5dd984dUL, 0x989ac446UL, + 0xaff00647UL, 0xf64e4045UL, 0xc1248244UL, 0x4432cd41UL, 0x73580f40UL, + 0x2ae64942UL, 0x1d8c8b43UL, 0x5068f154UL, 0x67023355UL, 0x3ebc7557UL, + 0x09d6b756UL, 0x8cc0f853UL, 0xbbaa3a52UL, 0xe2147c50UL, 0xd57ebe51UL, + 0xe839e25aUL, 0xdf53205bUL, 0x86ed6659UL, 0xb187a458UL, 0x3491eb5dUL, + 0x03fb295cUL, 0x5a456f5eUL, 0x6d2fad5fUL, 0x801b35e1UL, 0xb771f7e0UL, + 0xeecfb1e2UL, 0xd9a573e3UL, 0x5cb33ce6UL, 0x6bd9fee7UL, 0x3267b8e5UL, + 0x050d7ae4UL, 0x384a26efUL, 0x0f20e4eeUL, 0x569ea2ecUL, 0x61f460edUL, + 0xe4e22fe8UL, 0xd388ede9UL, 0x8a36abebUL, 0xbd5c69eaUL, 0xf0b813fdUL, + 0xc7d2d1fcUL, 0x9e6c97feUL, 0xa90655ffUL, 0x2c101afaUL, 0x1b7ad8fbUL, + 0x42c49ef9UL, 0x75ae5cf8UL, 0x48e900f3UL, 0x7f83c2f2UL, 0x263d84f0UL, + 0x115746f1UL, 0x944109f4UL, 0xa32bcbf5UL, 0xfa958df7UL, 0xcdff4ff6UL, + 0x605d78d9UL, 0x5737bad8UL, 0x0e89fcdaUL, 0x39e33edbUL, 0xbcf571deUL, + 0x8b9fb3dfUL, 0xd221f5ddUL, 0xe54b37dcUL, 0xd80c6bd7UL, 0xef66a9d6UL, + 0xb6d8efd4UL, 0x81b22dd5UL, 0x04a462d0UL, 0x33cea0d1UL, 0x6a70e6d3UL, + 0x5d1a24d2UL, 0x10fe5ec5UL, 0x27949cc4UL, 0x7e2adac6UL, 0x494018c7UL, + 0xcc5657c2UL, 0xfb3c95c3UL, 0xa282d3c1UL, 0x95e811c0UL, 0xa8af4dcbUL, + 0x9fc58fcaUL, 0xc67bc9c8UL, 0xf1110bc9UL, 0x740744ccUL, 0x436d86cdUL, + 0x1ad3c0cfUL, 0x2db902ceUL, 0x4096af91UL, 0x77fc6d90UL, 0x2e422b92UL, + 0x1928e993UL, 0x9c3ea696UL, 0xab546497UL, 0xf2ea2295UL, 0xc580e094UL, + 0xf8c7bc9fUL, 0xcfad7e9eUL, 0x9613389cUL, 0xa179fa9dUL, 0x246fb598UL, + 0x13057799UL, 0x4abb319bUL, 0x7dd1f39aUL, 0x3035898dUL, 0x075f4b8cUL, + 0x5ee10d8eUL, 0x698bcf8fUL, 0xec9d808aUL, 0xdbf7428bUL, 0x82490489UL, + 0xb523c688UL, 0x88649a83UL, 0xbf0e5882UL, 0xe6b01e80UL, 0xd1dadc81UL, + 0x54cc9384UL, 0x63a65185UL, 0x3a181787UL, 0x0d72d586UL, 0xa0d0e2a9UL, + 0x97ba20a8UL, 0xce0466aaUL, 0xf96ea4abUL, 0x7c78ebaeUL, 0x4b1229afUL, + 0x12ac6fadUL, 0x25c6adacUL, 0x1881f1a7UL, 0x2feb33a6UL, 0x765575a4UL, + 0x413fb7a5UL, 0xc429f8a0UL, 0xf3433aa1UL, 0xaafd7ca3UL, 0x9d97bea2UL, + 0xd073c4b5UL, 0xe71906b4UL, 0xbea740b6UL, 0x89cd82b7UL, 0x0cdbcdb2UL, + 0x3bb10fb3UL, 0x620f49b1UL, 0x55658bb0UL, 0x6822d7bbUL, 0x5f4815baUL, + 0x06f653b8UL, 0x319c91b9UL, 0xb48adebcUL, 0x83e01cbdUL, 0xda5e5abfUL, + 0xed3498beUL + }, + { + 0x00000000UL, 0x6567bcb8UL, 0x8bc809aaUL, 0xeeafb512UL, 0x5797628fUL, + 0x32f0de37UL, 0xdc5f6b25UL, 0xb938d79dUL, 0xef28b4c5UL, 0x8a4f087dUL, + 0x64e0bd6fUL, 0x018701d7UL, 0xb8bfd64aUL, 0xddd86af2UL, 0x3377dfe0UL, + 0x56106358UL, 0x9f571950UL, 0xfa30a5e8UL, 0x149f10faUL, 0x71f8ac42UL, + 0xc8c07bdfUL, 0xada7c767UL, 0x43087275UL, 0x266fcecdUL, 0x707fad95UL, + 0x1518112dUL, 0xfbb7a43fUL, 0x9ed01887UL, 0x27e8cf1aUL, 0x428f73a2UL, + 0xac20c6b0UL, 0xc9477a08UL, 0x3eaf32a0UL, 0x5bc88e18UL, 0xb5673b0aUL, + 0xd00087b2UL, 0x6938502fUL, 0x0c5fec97UL, 0xe2f05985UL, 0x8797e53dUL, + 0xd1878665UL, 0xb4e03addUL, 0x5a4f8fcfUL, 0x3f283377UL, 0x8610e4eaUL, + 0xe3775852UL, 0x0dd8ed40UL, 0x68bf51f8UL, 0xa1f82bf0UL, 0xc49f9748UL, + 0x2a30225aUL, 0x4f579ee2UL, 0xf66f497fUL, 0x9308f5c7UL, 0x7da740d5UL, + 0x18c0fc6dUL, 0x4ed09f35UL, 0x2bb7238dUL, 0xc518969fUL, 0xa07f2a27UL, + 0x1947fdbaUL, 0x7c204102UL, 0x928ff410UL, 0xf7e848a8UL, 0x3d58149bUL, + 0x583fa823UL, 0xb6901d31UL, 0xd3f7a189UL, 0x6acf7614UL, 0x0fa8caacUL, + 0xe1077fbeUL, 0x8460c306UL, 0xd270a05eUL, 0xb7171ce6UL, 0x59b8a9f4UL, + 0x3cdf154cUL, 0x85e7c2d1UL, 0xe0807e69UL, 0x0e2fcb7bUL, 0x6b4877c3UL, + 0xa20f0dcbUL, 0xc768b173UL, 0x29c70461UL, 0x4ca0b8d9UL, 0xf5986f44UL, + 0x90ffd3fcUL, 0x7e5066eeUL, 0x1b37da56UL, 0x4d27b90eUL, 0x284005b6UL, + 0xc6efb0a4UL, 0xa3880c1cUL, 0x1ab0db81UL, 0x7fd76739UL, 0x9178d22bUL, + 0xf41f6e93UL, 0x03f7263bUL, 0x66909a83UL, 0x883f2f91UL, 0xed589329UL, + 0x546044b4UL, 0x3107f80cUL, 0xdfa84d1eUL, 0xbacff1a6UL, 0xecdf92feUL, + 0x89b82e46UL, 0x67179b54UL, 0x027027ecUL, 0xbb48f071UL, 0xde2f4cc9UL, + 0x3080f9dbUL, 0x55e74563UL, 0x9ca03f6bUL, 0xf9c783d3UL, 0x176836c1UL, + 0x720f8a79UL, 0xcb375de4UL, 0xae50e15cUL, 0x40ff544eUL, 0x2598e8f6UL, + 0x73888baeUL, 0x16ef3716UL, 0xf8408204UL, 0x9d273ebcUL, 0x241fe921UL, + 0x41785599UL, 0xafd7e08bUL, 0xcab05c33UL, 0x3bb659edUL, 0x5ed1e555UL, + 0xb07e5047UL, 0xd519ecffUL, 0x6c213b62UL, 0x094687daUL, 0xe7e932c8UL, + 0x828e8e70UL, 0xd49eed28UL, 0xb1f95190UL, 0x5f56e482UL, 0x3a31583aUL, + 0x83098fa7UL, 0xe66e331fUL, 0x08c1860dUL, 0x6da63ab5UL, 0xa4e140bdUL, + 0xc186fc05UL, 0x2f294917UL, 0x4a4ef5afUL, 0xf3762232UL, 0x96119e8aUL, + 0x78be2b98UL, 0x1dd99720UL, 0x4bc9f478UL, 0x2eae48c0UL, 0xc001fdd2UL, + 0xa566416aUL, 0x1c5e96f7UL, 0x79392a4fUL, 0x97969f5dUL, 0xf2f123e5UL, + 0x05196b4dUL, 0x607ed7f5UL, 0x8ed162e7UL, 0xebb6de5fUL, 0x528e09c2UL, + 0x37e9b57aUL, 0xd9460068UL, 0xbc21bcd0UL, 0xea31df88UL, 0x8f566330UL, + 0x61f9d622UL, 0x049e6a9aUL, 0xbda6bd07UL, 0xd8c101bfUL, 0x366eb4adUL, + 0x53090815UL, 0x9a4e721dUL, 0xff29cea5UL, 0x11867bb7UL, 0x74e1c70fUL, + 0xcdd91092UL, 0xa8beac2aUL, 0x46111938UL, 0x2376a580UL, 0x7566c6d8UL, + 0x10017a60UL, 0xfeaecf72UL, 0x9bc973caUL, 0x22f1a457UL, 0x479618efUL, + 0xa939adfdUL, 0xcc5e1145UL, 0x06ee4d76UL, 0x6389f1ceUL, 0x8d2644dcUL, + 0xe841f864UL, 0x51792ff9UL, 0x341e9341UL, 0xdab12653UL, 0xbfd69aebUL, + 0xe9c6f9b3UL, 0x8ca1450bUL, 0x620ef019UL, 0x07694ca1UL, 0xbe519b3cUL, + 0xdb362784UL, 0x35999296UL, 0x50fe2e2eUL, 0x99b95426UL, 0xfcdee89eUL, + 0x12715d8cUL, 0x7716e134UL, 0xce2e36a9UL, 0xab498a11UL, 0x45e63f03UL, + 0x208183bbUL, 0x7691e0e3UL, 0x13f65c5bUL, 0xfd59e949UL, 0x983e55f1UL, + 0x2106826cUL, 0x44613ed4UL, 0xaace8bc6UL, 0xcfa9377eUL, 0x38417fd6UL, + 0x5d26c36eUL, 0xb389767cUL, 0xd6eecac4UL, 0x6fd61d59UL, 0x0ab1a1e1UL, + 0xe41e14f3UL, 0x8179a84bUL, 0xd769cb13UL, 0xb20e77abUL, 0x5ca1c2b9UL, + 0x39c67e01UL, 0x80fea99cUL, 0xe5991524UL, 0x0b36a036UL, 0x6e511c8eUL, + 0xa7166686UL, 0xc271da3eUL, 0x2cde6f2cUL, 0x49b9d394UL, 0xf0810409UL, + 0x95e6b8b1UL, 0x7b490da3UL, 0x1e2eb11bUL, 0x483ed243UL, 0x2d596efbUL, + 0xc3f6dbe9UL, 0xa6916751UL, 0x1fa9b0ccUL, 0x7ace0c74UL, 0x9461b966UL, + 0xf10605deUL +#endif + } +}; diff --git a/include/zlib/deflate.h b/include/zlib/deflate.h new file mode 100644 index 0000000..122ba6a --- /dev/null +++ b/include/zlib/deflate.h @@ -0,0 +1,349 @@ +/* deflate.h -- internal compression state + * Copyright (C) 1995-2016 Jean-loup Gailly + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +/* WARNING: this file should *not* be used by applications. It is + part of the implementation of the compression library and is + subject to change. Applications should only use zlib.h. + */ + +/* @(#) $Id$ */ + +#ifndef DEFLATE_H +#define DEFLATE_H + +#include "include/zlib/zutil.h" + +/* define NO_GZIP when compiling if you want to disable gzip header and + trailer creation by deflate(). NO_GZIP would be used to avoid linking in + the crc code when it is not needed. For shared libraries, gzip encoding + should be left enabled. */ +#ifndef NO_GZIP +# define GZIP +#endif + +/* =========================================================================== + * Internal compression state. + */ + +#define LENGTH_CODES 29 +/* number of length codes, not counting the special END_BLOCK code */ + +#define LITERALS 256 +/* number of literal bytes 0..255 */ + +#define L_CODES (LITERALS+1+LENGTH_CODES) +/* number of Literal or Length codes, including the END_BLOCK code */ + +#define D_CODES 30 +/* number of distance codes */ + +#define BL_CODES 19 +/* number of codes used to transfer the bit lengths */ + +#define HEAP_SIZE (2*L_CODES+1) +/* maximum heap size */ + +#define MAX_BITS 15 +/* All codes must not exceed MAX_BITS bits */ + +#define Buf_size 16 +/* size of bit buffer in bi_buf */ + +#define INIT_STATE 42 /* zlib header -> BUSY_STATE */ +#ifdef GZIP +# define GZIP_STATE 57 /* gzip header -> BUSY_STATE | EXTRA_STATE */ +#endif +#define EXTRA_STATE 69 /* gzip extra block -> NAME_STATE */ +#define NAME_STATE 73 /* gzip file name -> COMMENT_STATE */ +#define COMMENT_STATE 91 /* gzip comment -> HCRC_STATE */ +#define HCRC_STATE 103 /* gzip header CRC -> BUSY_STATE */ +#define BUSY_STATE 113 /* deflate -> FINISH_STATE */ +#define FINISH_STATE 666 /* stream complete */ +/* Stream status */ + + +/* Data structure describing a single value and its code string. */ +typedef struct ct_data_s { + union { + ush freq; /* frequency count */ + ush code; /* bit string */ + } fc; + union { + ush dad; /* father node in Huffman tree */ + ush len; /* length of bit string */ + } dl; +} FAR ct_data; + +#define Freq fc.freq +#define Code fc.code +#define Dad dl.dad +#define Len dl.len + +typedef struct static_tree_desc_s static_tree_desc; + +typedef struct tree_desc_s { + ct_data *dyn_tree; /* the dynamic tree */ + int max_code; /* largest code with non zero frequency */ + const static_tree_desc *stat_desc; /* the corresponding static tree */ +} FAR tree_desc; + +typedef ush Pos; +typedef Pos FAR Posf; +typedef unsigned IPos; + +/* A Pos is an index in the character window. We use short instead of int to + * save space in the various tables. IPos is used only for parameter passing. + */ + +typedef struct internal_state { + z_streamp strm; /* pointer back to this zlib stream */ + int status; /* as the name implies */ + Bytef *pending_buf; /* output still pending */ + ulg pending_buf_size; /* size of pending_buf */ + Bytef *pending_out; /* next pending byte to output to the stream */ + ulg pending; /* nb of bytes in the pending buffer */ + int wrap; /* bit 0 true for zlib, bit 1 true for gzip */ + gz_headerp gzhead; /* gzip header information to write */ + ulg gzindex; /* where in extra, name, or comment */ + Byte method; /* can only be DEFLATED */ + int last_flush; /* value of flush param for previous deflate call */ + + /* used by deflate.c: */ + + uInt w_size; /* LZ77 window size (32K by default) */ + uInt w_bits; /* log2(w_size) (8..16) */ + uInt w_mask; /* w_size - 1 */ + + Bytef *window; + /* Sliding window. Input bytes are read into the second half of the window, + * and move to the first half later to keep a dictionary of at least wSize + * bytes. With this organization, matches are limited to a distance of + * wSize-MAX_MATCH bytes, but this ensures that IO is always + * performed with a length multiple of the block size. Also, it limits + * the window size to 64K, which is quite useful on MSDOS. + * To do: use the user input buffer as sliding window. + */ + + ulg window_size; + /* Actual size of window: 2*wSize, except when the user input buffer + * is directly used as sliding window. + */ + + Posf *prev; + /* Link to older string with same hash index. To limit the size of this + * array to 64K, this link is maintained only for the last 32K strings. + * An index in this array is thus a window index modulo 32K. + */ + + Posf *head; /* Heads of the hash chains or NIL. */ + + uInt ins_h; /* hash index of string to be inserted */ + uInt hash_size; /* number of elements in hash table */ + uInt hash_bits; /* log2(hash_size) */ + uInt hash_mask; /* hash_size-1 */ + + uInt hash_shift; + /* Number of bits by which ins_h must be shifted at each input + * step. It must be such that after MIN_MATCH steps, the oldest + * byte no longer takes part in the hash key, that is: + * hash_shift * MIN_MATCH >= hash_bits + */ + + long block_start; + /* Window position at the beginning of the current output block. Gets + * negative when the window is moved backwards. + */ + + uInt match_length; /* length of best match */ + IPos prev_match; /* previous match */ + int match_available; /* set if previous match exists */ + uInt strstart; /* start of string to insert */ + uInt match_start; /* start of matching string */ + uInt lookahead; /* number of valid bytes ahead in window */ + + uInt prev_length; + /* Length of the best match at previous step. Matches not greater than this + * are discarded. This is used in the lazy match evaluation. + */ + + uInt max_chain_length; + /* To speed up deflation, hash chains are never searched beyond this + * length. A higher limit improves compression ratio but degrades the + * speed. + */ + + uInt max_lazy_match; + /* Attempt to find a better match only when the current match is strictly + * smaller than this value. This mechanism is used only for compression + * levels >= 4. + */ +# define max_insert_length max_lazy_match + /* Insert new strings in the hash table only if the match length is not + * greater than this length. This saves time but degrades compression. + * max_insert_length is used only for compression levels <= 3. + */ + + int level; /* compression level (1..9) */ + int strategy; /* favor or force Huffman coding*/ + + uInt good_match; + /* Use a faster search when the previous match is longer than this */ + + int nice_match; /* Stop searching when current match exceeds this */ + + /* used by trees.c: */ + /* Didn't use ct_data typedef below to suppress compiler warning */ + struct ct_data_s dyn_ltree[HEAP_SIZE]; /* literal and length tree */ + struct ct_data_s dyn_dtree[2*D_CODES+1]; /* distance tree */ + struct ct_data_s bl_tree[2*BL_CODES+1]; /* Huffman tree for bit lengths */ + + struct tree_desc_s l_desc; /* desc. for literal tree */ + struct tree_desc_s d_desc; /* desc. for distance tree */ + struct tree_desc_s bl_desc; /* desc. for bit length tree */ + + ush bl_count[MAX_BITS+1]; + /* number of codes at each bit length for an optimal tree */ + + int heap[2*L_CODES+1]; /* heap used to build the Huffman trees */ + int heap_len; /* number of elements in the heap */ + int heap_max; /* element of largest frequency */ + /* The sons of heap[n] are heap[2*n] and heap[2*n+1]. heap[0] is not used. + * The same heap array is used to build all trees. + */ + + uch depth[2*L_CODES+1]; + /* Depth of each subtree used as tie breaker for trees of equal frequency + */ + + uchf *l_buf; /* buffer for literals or lengths */ + + uInt lit_bufsize; + /* Size of match buffer for literals/lengths. There are 4 reasons for + * limiting lit_bufsize to 64K: + * - frequencies can be kept in 16 bit counters + * - if compression is not successful for the first block, all input + * data is still in the window so we can still emit a stored block even + * when input comes from standard input. (This can also be done for + * all blocks if lit_bufsize is not greater than 32K.) + * - if compression is not successful for a file smaller than 64K, we can + * even emit a stored file instead of a stored block (saving 5 bytes). + * This is applicable only for zip (not gzip or zlib). + * - creating new Huffman trees less frequently may not provide fast + * adaptation to changes in the input data statistics. (Take for + * example a binary file with poorly compressible code followed by + * a highly compressible string table.) Smaller buffer sizes give + * fast adaptation but have of course the overhead of transmitting + * trees more frequently. + * - I can't count above 4 + */ + + uInt last_lit; /* running index in l_buf */ + + ushf *d_buf; + /* Buffer for distances. To simplify the code, d_buf and l_buf have + * the same number of elements. To use different lengths, an extra flag + * array would be necessary. + */ + + ulg opt_len; /* bit length of current block with optimal trees */ + ulg static_len; /* bit length of current block with static trees */ + uInt matches; /* number of string matches in current block */ + uInt insert; /* bytes at end of window left to insert */ + +#ifdef ZLIB_DEBUG + ulg compressed_len; /* total bit length of compressed file mod 2^32 */ + ulg bits_sent; /* bit length of compressed data sent mod 2^32 */ +#endif + + ush bi_buf; + /* Output buffer. bits are inserted starting at the bottom (least + * significant bits). + */ + int bi_valid; + /* Number of valid bits in bi_buf. All bits above the last valid bit + * are always zero. + */ + + ulg high_water; + /* High water mark offset in window for initialized bytes -- bytes above + * this are set to zero in order to avoid memory check warnings when + * longest match routines access bytes past the input. This is then + * updated to the new high water mark. + */ + +} FAR deflate_state; + +/* Output a byte on the stream. + * IN assertion: there is enough room in pending_buf. + */ +#define put_byte(s, c) {s->pending_buf[s->pending++] = (Bytef)(c);} + + +#define MIN_LOOKAHEAD (MAX_MATCH+MIN_MATCH+1) +/* Minimum amount of lookahead, except at the end of the input file. + * See deflate.c for comments about the MIN_MATCH+1. + */ + +#define MAX_DIST(s) ((s)->w_size-MIN_LOOKAHEAD) +/* In order to simplify the code, particularly on 16 bit machines, match + * distances are limited to MAX_DIST instead of WSIZE. + */ + +#define WIN_INIT MAX_MATCH +/* Number of bytes after end of data in window to initialize in order to avoid + memory checker errors from longest match routines */ + + /* in trees.c */ +void ZLIB_INTERNAL _tr_init OF((deflate_state *s)); +int ZLIB_INTERNAL _tr_tally OF((deflate_state *s, unsigned dist, unsigned lc)); +void ZLIB_INTERNAL _tr_flush_block OF((deflate_state *s, charf *buf, + ulg stored_len, int last)); +void ZLIB_INTERNAL _tr_flush_bits OF((deflate_state *s)); +void ZLIB_INTERNAL _tr_align OF((deflate_state *s)); +void ZLIB_INTERNAL _tr_stored_block OF((deflate_state *s, charf *buf, + ulg stored_len, int last)); + +#define d_code(dist) \ + ((dist) < 256 ? _dist_code[dist] : _dist_code[256+((dist)>>7)]) +/* Mapping from a distance to a distance code. dist is the distance - 1 and + * must not have side effects. _dist_code[256] and _dist_code[257] are never + * used. + */ + +#ifndef ZLIB_DEBUG +/* Inline versions of _tr_tally for speed: */ + +#if defined(GEN_TREES_H) || !defined(STDC) + extern uch ZLIB_INTERNAL _length_code[]; + extern uch ZLIB_INTERNAL _dist_code[]; +#else + extern const uch ZLIB_INTERNAL _length_code[]; + extern const uch ZLIB_INTERNAL _dist_code[]; +#endif + +# define _tr_tally_lit(s, c, flush) \ + { uch cc = (c); \ + s->d_buf[s->last_lit] = 0; \ + s->l_buf[s->last_lit++] = cc; \ + s->dyn_ltree[cc].Freq++; \ + flush = (s->last_lit == s->lit_bufsize-1); \ + } +# define _tr_tally_dist(s, distance, length, flush) \ + { uch len = (uch)(length); \ + ush dist = (ush)(distance); \ + s->d_buf[s->last_lit] = dist; \ + s->l_buf[s->last_lit++] = len; \ + dist--; \ + s->dyn_ltree[_length_code[len]+LITERALS+1].Freq++; \ + s->dyn_dtree[d_code(dist)].Freq++; \ + flush = (s->last_lit == s->lit_bufsize-1); \ + } +#else +# define _tr_tally_lit(s, c, flush) flush = _tr_tally(s, 0, c) +# define _tr_tally_dist(s, distance, length, flush) \ + flush = _tr_tally(s, distance, length) +#endif + +#endif /* DEFLATE_H */ diff --git a/include/zlib/gzguts.h b/include/zlib/gzguts.h new file mode 100644 index 0000000..e701306 --- /dev/null +++ b/include/zlib/gzguts.h @@ -0,0 +1,218 @@ +/* gzguts.h -- zlib internal header definitions for gz* operations + * Copyright (C) 2004, 2005, 2010, 2011, 2012, 2013, 2016 Mark Adler + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +#ifdef _LARGEFILE64_SOURCE +# ifndef _LARGEFILE_SOURCE +# define _LARGEFILE_SOURCE 1 +# endif +# ifdef _FILE_OFFSET_BITS +# undef _FILE_OFFSET_BITS +# endif +#endif + +#ifdef HAVE_HIDDEN +# define ZLIB_INTERNAL __attribute__((visibility ("hidden"))) +#else +# define ZLIB_INTERNAL +#endif + +#include +#include "include/zlib/zlib.h" +#ifdef STDC +# include +# include +# include +#endif + +#ifndef _POSIX_SOURCE +# define _POSIX_SOURCE +#endif +#include + +#ifdef _WIN32 +# include +#endif + +#if defined(__TURBOC__) || defined(_MSC_VER) || defined(_WIN32) +# include +#endif + +#if defined(_WIN32) || defined(__CYGWIN__) +# define WIDECHAR +#endif + +#ifdef WINAPI_FAMILY +# define open _open +# define read _read +# define write _write +# define close _close +#endif + +#ifdef NO_DEFLATE /* for compatibility with old definition */ +# define NO_GZCOMPRESS +#endif + +#if defined(STDC99) || (defined(__TURBOC__) && __TURBOC__ >= 0x550) +# ifndef HAVE_VSNPRINTF +# define HAVE_VSNPRINTF +# endif +#endif + +#if defined(__CYGWIN__) +# ifndef HAVE_VSNPRINTF +# define HAVE_VSNPRINTF +# endif +#endif + +#if defined(MSDOS) && defined(__BORLANDC__) && (BORLANDC > 0x410) +# ifndef HAVE_VSNPRINTF +# define HAVE_VSNPRINTF +# endif +#endif + +#ifndef HAVE_VSNPRINTF +# ifdef MSDOS +/* vsnprintf may exist on some MS-DOS compilers (DJGPP?), + but for now we just assume it doesn't. */ +# define NO_vsnprintf +# endif +# ifdef __TURBOC__ +# define NO_vsnprintf +# endif +# ifdef WIN32 +/* In Win32, vsnprintf is available as the "non-ANSI" _vsnprintf. */ +# if !defined(vsnprintf) && !defined(NO_vsnprintf) +# if !defined(_MSC_VER) || ( defined(_MSC_VER) && _MSC_VER < 1500 ) +# define vsnprintf _vsnprintf +# endif +# endif +# endif +# ifdef __SASC +# define NO_vsnprintf +# endif +# ifdef VMS +# define NO_vsnprintf +# endif +# ifdef __OS400__ +# define NO_vsnprintf +# endif +# ifdef __MVS__ +# define NO_vsnprintf +# endif +#endif + +/* unlike snprintf (which is required in C99), _snprintf does not guarantee + null termination of the result -- however this is only used in gzlib.c where + the result is assured to fit in the space provided */ +#if defined(_MSC_VER) && _MSC_VER < 1900 +# define snprintf _snprintf +#endif + +#ifndef local +# define local static +#endif +/* since "static" is used to mean two completely different things in C, we + define "local" for the non-static meaning of "static", for readability + (compile with -Dlocal if your debugger can't find static symbols) */ + +/* gz* functions always use library allocation functions */ +#ifndef STDC + extern voidp malloc OF((uInt size)); + extern void free OF((voidpf ptr)); +#endif + +/* get errno and strerror definition */ +#if defined UNDER_CE +# include +# define zstrerror() gz_strwinerror((DWORD)GetLastError()) +#else +# ifndef NO_STRERROR +# include +# define zstrerror() strerror(errno) +# else +# define zstrerror() "stdio error (consult errno)" +# endif +#endif + +/* provide prototypes for these when building zlib without LFS */ +#if !defined(_LARGEFILE64_SOURCE) || _LFS64_LARGEFILE-0 == 0 + ZEXTERN gzFile ZEXPORT gzopen64 OF((const char *, const char *)); + ZEXTERN z_off64_t ZEXPORT gzseek64 OF((gzFile, z_off64_t, int)); + ZEXTERN z_off64_t ZEXPORT gztell64 OF((gzFile)); + ZEXTERN z_off64_t ZEXPORT gzoffset64 OF((gzFile)); +#endif + +/* default memLevel */ +#if MAX_MEM_LEVEL >= 8 +# define DEF_MEM_LEVEL 8 +#else +# define DEF_MEM_LEVEL MAX_MEM_LEVEL +#endif + +/* default i/o buffer size -- double this for output when reading (this and + twice this must be able to fit in an unsigned type) */ +#define GZBUFSIZE 8192 + +/* gzip modes, also provide a little integrity check on the passed structure */ +#define GZ_NONE 0 +#define GZ_READ 7247 +#define GZ_WRITE 31153 +#define GZ_APPEND 1 /* mode set to GZ_WRITE after the file is opened */ + +/* values for gz_state how */ +#define LOOK 0 /* look for a gzip header */ +#define COPY 1 /* copy input directly */ +#define GZIP 2 /* decompress a gzip stream */ + +/* internal gzip file state data structure */ +typedef struct { + /* exposed contents for gzgetc() macro */ + struct gzFile_s x; /* "x" for exposed */ + /* x.have: number of bytes available at x.next */ + /* x.next: next output data to deliver or write */ + /* x.pos: current position in uncompressed data */ + /* used for both reading and writing */ + int mode; /* see gzip modes above */ + int fd; /* file descriptor */ + char *path; /* path or fd for error messages */ + unsigned size; /* buffer size, zero if not allocated yet */ + unsigned want; /* requested buffer size, default is GZBUFSIZE */ + unsigned char *in; /* input buffer (double-sized when writing) */ + unsigned char *out; /* output buffer (double-sized when reading) */ + int direct; /* 0 if processing gzip, 1 if transparent */ + /* just for reading */ + int how; /* 0: get header, 1: copy, 2: decompress */ + z_off64_t start; /* where the gzip data started, for rewinding */ + int eof; /* true if end of input file reached */ + int past; /* true if read requested past end */ + /* just for writing */ + int level; /* compression level */ + int strategy; /* compression strategy */ + /* seek request */ + z_off64_t skip; /* amount to skip (already rewound if backwards) */ + int seek; /* true if seek request pending */ + /* error information */ + int err; /* error code */ + char *msg; /* error message */ + /* zlib inflate or deflate stream */ + z_stream strm; /* stream structure in-place (not a pointer) */ +} gz_state; +typedef gz_state FAR *gz_statep; + +/* shared functions */ +void ZLIB_INTERNAL gz_error OF((gz_statep, int, const char *)); +#if defined UNDER_CE +char ZLIB_INTERNAL *gz_strwinerror OF((DWORD error)); +#endif + +/* GT_OFF(x), where x is an unsigned value, is true if x > maximum z_off64_t + value -- needed when comparing unsigned to z_off64_t, which is signed + (possible z_off64_t types off_t, off64_t, and long are all signed) */ +#ifdef INT_MAX +# define GT_OFF(x) (sizeof(int) == sizeof(z_off64_t) && (x) > INT_MAX) +#else +unsigned ZLIB_INTERNAL gz_intmax OF((void)); +# define GT_OFF(x) (sizeof(int) == sizeof(z_off64_t) && (x) > gz_intmax()) +#endif diff --git a/include/zlib/inffast.h b/include/zlib/inffast.h new file mode 100644 index 0000000..e5c1aa4 --- /dev/null +++ b/include/zlib/inffast.h @@ -0,0 +1,11 @@ +/* inffast.h -- header to use inffast.c + * Copyright (C) 1995-2003, 2010 Mark Adler + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +/* WARNING: this file should *not* be used by applications. It is + part of the implementation of the compression library and is + subject to change. Applications should only use zlib.h. + */ + +void ZLIB_INTERNAL inflate_fast OF((z_streamp strm, unsigned start)); diff --git a/include/zlib/inffixed.h b/include/zlib/inffixed.h new file mode 100644 index 0000000..d628327 --- /dev/null +++ b/include/zlib/inffixed.h @@ -0,0 +1,94 @@ + /* inffixed.h -- table for decoding fixed codes + * Generated automatically by makefixed(). + */ + + /* WARNING: this file should *not* be used by applications. + It is part of the implementation of this library and is + subject to change. Applications should only use zlib.h. + */ + + static const code lenfix[512] = { + {96,7,0},{0,8,80},{0,8,16},{20,8,115},{18,7,31},{0,8,112},{0,8,48}, + {0,9,192},{16,7,10},{0,8,96},{0,8,32},{0,9,160},{0,8,0},{0,8,128}, + {0,8,64},{0,9,224},{16,7,6},{0,8,88},{0,8,24},{0,9,144},{19,7,59}, + {0,8,120},{0,8,56},{0,9,208},{17,7,17},{0,8,104},{0,8,40},{0,9,176}, + {0,8,8},{0,8,136},{0,8,72},{0,9,240},{16,7,4},{0,8,84},{0,8,20}, + {21,8,227},{19,7,43},{0,8,116},{0,8,52},{0,9,200},{17,7,13},{0,8,100}, + {0,8,36},{0,9,168},{0,8,4},{0,8,132},{0,8,68},{0,9,232},{16,7,8}, + {0,8,92},{0,8,28},{0,9,152},{20,7,83},{0,8,124},{0,8,60},{0,9,216}, + {18,7,23},{0,8,108},{0,8,44},{0,9,184},{0,8,12},{0,8,140},{0,8,76}, + {0,9,248},{16,7,3},{0,8,82},{0,8,18},{21,8,163},{19,7,35},{0,8,114}, + {0,8,50},{0,9,196},{17,7,11},{0,8,98},{0,8,34},{0,9,164},{0,8,2}, + {0,8,130},{0,8,66},{0,9,228},{16,7,7},{0,8,90},{0,8,26},{0,9,148}, + {20,7,67},{0,8,122},{0,8,58},{0,9,212},{18,7,19},{0,8,106},{0,8,42}, + {0,9,180},{0,8,10},{0,8,138},{0,8,74},{0,9,244},{16,7,5},{0,8,86}, + {0,8,22},{64,8,0},{19,7,51},{0,8,118},{0,8,54},{0,9,204},{17,7,15}, + {0,8,102},{0,8,38},{0,9,172},{0,8,6},{0,8,134},{0,8,70},{0,9,236}, + {16,7,9},{0,8,94},{0,8,30},{0,9,156},{20,7,99},{0,8,126},{0,8,62}, + {0,9,220},{18,7,27},{0,8,110},{0,8,46},{0,9,188},{0,8,14},{0,8,142}, + {0,8,78},{0,9,252},{96,7,0},{0,8,81},{0,8,17},{21,8,131},{18,7,31}, + {0,8,113},{0,8,49},{0,9,194},{16,7,10},{0,8,97},{0,8,33},{0,9,162}, + {0,8,1},{0,8,129},{0,8,65},{0,9,226},{16,7,6},{0,8,89},{0,8,25}, + {0,9,146},{19,7,59},{0,8,121},{0,8,57},{0,9,210},{17,7,17},{0,8,105}, + {0,8,41},{0,9,178},{0,8,9},{0,8,137},{0,8,73},{0,9,242},{16,7,4}, + {0,8,85},{0,8,21},{16,8,258},{19,7,43},{0,8,117},{0,8,53},{0,9,202}, + {17,7,13},{0,8,101},{0,8,37},{0,9,170},{0,8,5},{0,8,133},{0,8,69}, + {0,9,234},{16,7,8},{0,8,93},{0,8,29},{0,9,154},{20,7,83},{0,8,125}, + {0,8,61},{0,9,218},{18,7,23},{0,8,109},{0,8,45},{0,9,186},{0,8,13}, + {0,8,141},{0,8,77},{0,9,250},{16,7,3},{0,8,83},{0,8,19},{21,8,195}, + {19,7,35},{0,8,115},{0,8,51},{0,9,198},{17,7,11},{0,8,99},{0,8,35}, + {0,9,166},{0,8,3},{0,8,131},{0,8,67},{0,9,230},{16,7,7},{0,8,91}, + {0,8,27},{0,9,150},{20,7,67},{0,8,123},{0,8,59},{0,9,214},{18,7,19}, + {0,8,107},{0,8,43},{0,9,182},{0,8,11},{0,8,139},{0,8,75},{0,9,246}, + {16,7,5},{0,8,87},{0,8,23},{64,8,0},{19,7,51},{0,8,119},{0,8,55}, + {0,9,206},{17,7,15},{0,8,103},{0,8,39},{0,9,174},{0,8,7},{0,8,135}, + {0,8,71},{0,9,238},{16,7,9},{0,8,95},{0,8,31},{0,9,158},{20,7,99}, + {0,8,127},{0,8,63},{0,9,222},{18,7,27},{0,8,111},{0,8,47},{0,9,190}, + {0,8,15},{0,8,143},{0,8,79},{0,9,254},{96,7,0},{0,8,80},{0,8,16}, + {20,8,115},{18,7,31},{0,8,112},{0,8,48},{0,9,193},{16,7,10},{0,8,96}, + {0,8,32},{0,9,161},{0,8,0},{0,8,128},{0,8,64},{0,9,225},{16,7,6}, + {0,8,88},{0,8,24},{0,9,145},{19,7,59},{0,8,120},{0,8,56},{0,9,209}, + {17,7,17},{0,8,104},{0,8,40},{0,9,177},{0,8,8},{0,8,136},{0,8,72}, + {0,9,241},{16,7,4},{0,8,84},{0,8,20},{21,8,227},{19,7,43},{0,8,116}, + {0,8,52},{0,9,201},{17,7,13},{0,8,100},{0,8,36},{0,9,169},{0,8,4}, + {0,8,132},{0,8,68},{0,9,233},{16,7,8},{0,8,92},{0,8,28},{0,9,153}, + {20,7,83},{0,8,124},{0,8,60},{0,9,217},{18,7,23},{0,8,108},{0,8,44}, + {0,9,185},{0,8,12},{0,8,140},{0,8,76},{0,9,249},{16,7,3},{0,8,82}, + {0,8,18},{21,8,163},{19,7,35},{0,8,114},{0,8,50},{0,9,197},{17,7,11}, + {0,8,98},{0,8,34},{0,9,165},{0,8,2},{0,8,130},{0,8,66},{0,9,229}, + {16,7,7},{0,8,90},{0,8,26},{0,9,149},{20,7,67},{0,8,122},{0,8,58}, + {0,9,213},{18,7,19},{0,8,106},{0,8,42},{0,9,181},{0,8,10},{0,8,138}, + {0,8,74},{0,9,245},{16,7,5},{0,8,86},{0,8,22},{64,8,0},{19,7,51}, + {0,8,118},{0,8,54},{0,9,205},{17,7,15},{0,8,102},{0,8,38},{0,9,173}, + {0,8,6},{0,8,134},{0,8,70},{0,9,237},{16,7,9},{0,8,94},{0,8,30}, + {0,9,157},{20,7,99},{0,8,126},{0,8,62},{0,9,221},{18,7,27},{0,8,110}, + {0,8,46},{0,9,189},{0,8,14},{0,8,142},{0,8,78},{0,9,253},{96,7,0}, + {0,8,81},{0,8,17},{21,8,131},{18,7,31},{0,8,113},{0,8,49},{0,9,195}, + {16,7,10},{0,8,97},{0,8,33},{0,9,163},{0,8,1},{0,8,129},{0,8,65}, + {0,9,227},{16,7,6},{0,8,89},{0,8,25},{0,9,147},{19,7,59},{0,8,121}, + {0,8,57},{0,9,211},{17,7,17},{0,8,105},{0,8,41},{0,9,179},{0,8,9}, + {0,8,137},{0,8,73},{0,9,243},{16,7,4},{0,8,85},{0,8,21},{16,8,258}, + {19,7,43},{0,8,117},{0,8,53},{0,9,203},{17,7,13},{0,8,101},{0,8,37}, + {0,9,171},{0,8,5},{0,8,133},{0,8,69},{0,9,235},{16,7,8},{0,8,93}, + {0,8,29},{0,9,155},{20,7,83},{0,8,125},{0,8,61},{0,9,219},{18,7,23}, + {0,8,109},{0,8,45},{0,9,187},{0,8,13},{0,8,141},{0,8,77},{0,9,251}, + {16,7,3},{0,8,83},{0,8,19},{21,8,195},{19,7,35},{0,8,115},{0,8,51}, + {0,9,199},{17,7,11},{0,8,99},{0,8,35},{0,9,167},{0,8,3},{0,8,131}, + {0,8,67},{0,9,231},{16,7,7},{0,8,91},{0,8,27},{0,9,151},{20,7,67}, + {0,8,123},{0,8,59},{0,9,215},{18,7,19},{0,8,107},{0,8,43},{0,9,183}, + {0,8,11},{0,8,139},{0,8,75},{0,9,247},{16,7,5},{0,8,87},{0,8,23}, + {64,8,0},{19,7,51},{0,8,119},{0,8,55},{0,9,207},{17,7,15},{0,8,103}, + {0,8,39},{0,9,175},{0,8,7},{0,8,135},{0,8,71},{0,9,239},{16,7,9}, + {0,8,95},{0,8,31},{0,9,159},{20,7,99},{0,8,127},{0,8,63},{0,9,223}, + {18,7,27},{0,8,111},{0,8,47},{0,9,191},{0,8,15},{0,8,143},{0,8,79}, + {0,9,255} + }; + + static const code distfix[32] = { + {16,5,1},{23,5,257},{19,5,17},{27,5,4097},{17,5,5},{25,5,1025}, + {21,5,65},{29,5,16385},{16,5,3},{24,5,513},{20,5,33},{28,5,8193}, + {18,5,9},{26,5,2049},{22,5,129},{64,5,0},{16,5,2},{23,5,385}, + {19,5,25},{27,5,6145},{17,5,7},{25,5,1537},{21,5,97},{29,5,24577}, + {16,5,4},{24,5,769},{20,5,49},{28,5,12289},{18,5,13},{26,5,3073}, + {22,5,193},{64,5,0} + }; diff --git a/include/zlib/inflate.h b/include/zlib/inflate.h new file mode 100644 index 0000000..a46cce6 --- /dev/null +++ b/include/zlib/inflate.h @@ -0,0 +1,125 @@ +/* inflate.h -- internal inflate state definition + * Copyright (C) 1995-2016 Mark Adler + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +/* WARNING: this file should *not* be used by applications. It is + part of the implementation of the compression library and is + subject to change. Applications should only use zlib.h. + */ + +/* define NO_GZIP when compiling if you want to disable gzip header and + trailer decoding by inflate(). NO_GZIP would be used to avoid linking in + the crc code when it is not needed. For shared libraries, gzip decoding + should be left enabled. */ +#ifndef NO_GZIP +# define GUNZIP +#endif + +/* Possible inflate modes between inflate() calls */ +typedef enum { + HEAD = 16180, /* i: waiting for magic header */ + FLAGS, /* i: waiting for method and flags (gzip) */ + TIME, /* i: waiting for modification time (gzip) */ + OS, /* i: waiting for extra flags and operating system (gzip) */ + EXLEN, /* i: waiting for extra length (gzip) */ + EXTRA, /* i: waiting for extra bytes (gzip) */ + NAME, /* i: waiting for end of file name (gzip) */ + COMMENT, /* i: waiting for end of comment (gzip) */ + HCRC, /* i: waiting for header crc (gzip) */ + DICTID, /* i: waiting for dictionary check value */ + DICT, /* waiting for inflateSetDictionary() call */ + TYPE, /* i: waiting for type bits, including last-flag bit */ + TYPEDO, /* i: same, but skip check to exit inflate on new block */ + STORED, /* i: waiting for stored size (length and complement) */ + COPY_, /* i/o: same as COPY below, but only first time in */ + COPY, /* i/o: waiting for input or output to copy stored block */ + TABLE, /* i: waiting for dynamic block table lengths */ + LENLENS, /* i: waiting for code length code lengths */ + CODELENS, /* i: waiting for length/lit and distance code lengths */ + LEN_, /* i: same as LEN below, but only first time in */ + LEN, /* i: waiting for length/lit/eob code */ + LENEXT, /* i: waiting for length extra bits */ + DIST, /* i: waiting for distance code */ + DISTEXT, /* i: waiting for distance extra bits */ + MATCH, /* o: waiting for output space to copy string */ + LIT, /* o: waiting for output space to write literal */ + CHECK, /* i: waiting for 32-bit check value */ + LENGTH, /* i: waiting for 32-bit length (gzip) */ + DONE, /* finished check, done -- remain here until reset */ + BAD, /* got a data error -- remain here until reset */ + MEM, /* got an inflate() memory error -- remain here until reset */ + SYNC /* looking for synchronization bytes to restart inflate() */ +} inflate_mode; + +/* + State transitions between above modes - + + (most modes can go to BAD or MEM on error -- not shown for clarity) + + Process header: + HEAD -> (gzip) or (zlib) or (raw) + (gzip) -> FLAGS -> TIME -> OS -> EXLEN -> EXTRA -> NAME -> COMMENT -> + HCRC -> TYPE + (zlib) -> DICTID or TYPE + DICTID -> DICT -> TYPE + (raw) -> TYPEDO + Read deflate blocks: + TYPE -> TYPEDO -> STORED or TABLE or LEN_ or CHECK + STORED -> COPY_ -> COPY -> TYPE + TABLE -> LENLENS -> CODELENS -> LEN_ + LEN_ -> LEN + Read deflate codes in fixed or dynamic block: + LEN -> LENEXT or LIT or TYPE + LENEXT -> DIST -> DISTEXT -> MATCH -> LEN + LIT -> LEN + Process trailer: + CHECK -> LENGTH -> DONE + */ + +/* State maintained between inflate() calls -- approximately 7K bytes, not + including the allocated sliding window, which is up to 32K bytes. */ +struct inflate_state { + z_streamp strm; /* pointer back to this zlib stream */ + inflate_mode mode; /* current inflate mode */ + int last; /* true if processing last block */ + int wrap; /* bit 0 true for zlib, bit 1 true for gzip, + bit 2 true to validate check value */ + int havedict; /* true if dictionary provided */ + int flags; /* gzip header method and flags (0 if zlib) */ + unsigned dmax; /* zlib header max distance (INFLATE_STRICT) */ + unsigned long check; /* protected copy of check value */ + unsigned long total; /* protected copy of output count */ + gz_headerp head; /* where to save gzip header information */ + /* sliding window */ + unsigned wbits; /* log base 2 of requested window size */ + unsigned wsize; /* window size or zero if not using window */ + unsigned whave; /* valid bytes in the window */ + unsigned wnext; /* window write index */ + unsigned char FAR *window; /* allocated sliding window, if needed */ + /* bit accumulator */ + unsigned long hold; /* input bit accumulator */ + unsigned bits; /* number of bits in "in" */ + /* for string and stored block copying */ + unsigned length; /* literal or length of data to copy */ + unsigned offset; /* distance back to copy string from */ + /* for table and code decoding */ + unsigned extra; /* extra bits needed */ + /* fixed and dynamic code tables */ + code const FAR *lencode; /* starting table for length/literal codes */ + code const FAR *distcode; /* starting table for distance codes */ + unsigned lenbits; /* index bits for lencode */ + unsigned distbits; /* index bits for distcode */ + /* dynamic table building */ + unsigned ncode; /* number of code length code lengths */ + unsigned nlen; /* number of length code lengths */ + unsigned ndist; /* number of distance code lengths */ + unsigned have; /* number of code lengths in lens[] */ + code FAR *next; /* next available space in codes[] */ + unsigned short lens[320]; /* temporary storage for code lengths */ + unsigned short work[288]; /* work area for code table building */ + code codes[ENOUGH]; /* space for code tables */ + int sane; /* if false, allow invalid distance too far */ + int back; /* bits back of last unprocessed length/lit */ + unsigned was; /* initial length of match */ +}; diff --git a/include/zlib/inftrees.h b/include/zlib/inftrees.h new file mode 100644 index 0000000..baa53a0 --- /dev/null +++ b/include/zlib/inftrees.h @@ -0,0 +1,62 @@ +/* inftrees.h -- header to use inftrees.c + * Copyright (C) 1995-2005, 2010 Mark Adler + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +/* WARNING: this file should *not* be used by applications. It is + part of the implementation of the compression library and is + subject to change. Applications should only use zlib.h. + */ + +/* Structure for decoding tables. Each entry provides either the + information needed to do the operation requested by the code that + indexed that table entry, or it provides a pointer to another + table that indexes more bits of the code. op indicates whether + the entry is a pointer to another table, a literal, a length or + distance, an end-of-block, or an invalid code. For a table + pointer, the low four bits of op is the number of index bits of + that table. For a length or distance, the low four bits of op + is the number of extra bits to get after the code. bits is + the number of bits in this code or part of the code to drop off + of the bit buffer. val is the actual byte to output in the case + of a literal, the base length or distance, or the offset from + the current table to the next table. Each entry is four bytes. */ +typedef struct { + unsigned char op; /* operation, extra bits, table bits */ + unsigned char bits; /* bits in this part of the code */ + unsigned short val; /* offset in table or code value */ +} code; + +/* op values as set by inflate_table(): + 00000000 - literal + 0000tttt - table link, tttt != 0 is the number of table index bits + 0001eeee - length or distance, eeee is the number of extra bits + 01100000 - end of block + 01000000 - invalid code + */ + +/* Maximum size of the dynamic table. The maximum number of code structures is + 1444, which is the sum of 852 for literal/length codes and 592 for distance + codes. These values were found by exhaustive searches using the program + examples/enough.c found in the zlib distribtution. The arguments to that + program are the number of symbols, the initial root table size, and the + maximum bit length of a code. "enough 286 9 15" for literal/length codes + returns returns 852, and "enough 30 6 15" for distance codes returns 592. + The initial root table size (9 or 6) is found in the fifth argument of the + inflate_table() calls in inflate.c and infback.c. If the root table size is + changed, then these maximum sizes would be need to be recalculated and + updated. */ +#define ENOUGH_LENS 852 +#define ENOUGH_DISTS 592 +#define ENOUGH (ENOUGH_LENS+ENOUGH_DISTS) + +/* Type of code to build for inflate_table() */ +typedef enum { + CODES, + LENS, + DISTS +} codetype; + +int ZLIB_INTERNAL inflate_table OF((codetype type, unsigned short FAR *lens, + unsigned codes, code FAR * FAR *table, + unsigned FAR *bits, unsigned short FAR *work)); diff --git a/include/zlib/trees.h b/include/zlib/trees.h new file mode 100644 index 0000000..d35639d --- /dev/null +++ b/include/zlib/trees.h @@ -0,0 +1,128 @@ +/* header created automatically with -DGEN_TREES_H */ + +local const ct_data static_ltree[L_CODES+2] = { +{{ 12},{ 8}}, {{140},{ 8}}, {{ 76},{ 8}}, {{204},{ 8}}, {{ 44},{ 8}}, +{{172},{ 8}}, {{108},{ 8}}, {{236},{ 8}}, {{ 28},{ 8}}, {{156},{ 8}}, +{{ 92},{ 8}}, {{220},{ 8}}, {{ 60},{ 8}}, {{188},{ 8}}, {{124},{ 8}}, +{{252},{ 8}}, {{ 2},{ 8}}, {{130},{ 8}}, {{ 66},{ 8}}, {{194},{ 8}}, +{{ 34},{ 8}}, {{162},{ 8}}, {{ 98},{ 8}}, {{226},{ 8}}, {{ 18},{ 8}}, +{{146},{ 8}}, {{ 82},{ 8}}, {{210},{ 8}}, {{ 50},{ 8}}, {{178},{ 8}}, +{{114},{ 8}}, {{242},{ 8}}, {{ 10},{ 8}}, {{138},{ 8}}, {{ 74},{ 8}}, +{{202},{ 8}}, {{ 42},{ 8}}, {{170},{ 8}}, {{106},{ 8}}, {{234},{ 8}}, +{{ 26},{ 8}}, {{154},{ 8}}, {{ 90},{ 8}}, {{218},{ 8}}, {{ 58},{ 8}}, +{{186},{ 8}}, {{122},{ 8}}, {{250},{ 8}}, {{ 6},{ 8}}, {{134},{ 8}}, +{{ 70},{ 8}}, {{198},{ 8}}, {{ 38},{ 8}}, {{166},{ 8}}, {{102},{ 8}}, +{{230},{ 8}}, {{ 22},{ 8}}, {{150},{ 8}}, {{ 86},{ 8}}, {{214},{ 8}}, +{{ 54},{ 8}}, {{182},{ 8}}, {{118},{ 8}}, {{246},{ 8}}, {{ 14},{ 8}}, +{{142},{ 8}}, {{ 78},{ 8}}, {{206},{ 8}}, {{ 46},{ 8}}, {{174},{ 8}}, +{{110},{ 8}}, {{238},{ 8}}, {{ 30},{ 8}}, {{158},{ 8}}, {{ 94},{ 8}}, +{{222},{ 8}}, {{ 62},{ 8}}, {{190},{ 8}}, {{126},{ 8}}, {{254},{ 8}}, +{{ 1},{ 8}}, {{129},{ 8}}, {{ 65},{ 8}}, {{193},{ 8}}, {{ 33},{ 8}}, +{{161},{ 8}}, {{ 97},{ 8}}, {{225},{ 8}}, {{ 17},{ 8}}, {{145},{ 8}}, +{{ 81},{ 8}}, {{209},{ 8}}, {{ 49},{ 8}}, {{177},{ 8}}, {{113},{ 8}}, +{{241},{ 8}}, {{ 9},{ 8}}, {{137},{ 8}}, {{ 73},{ 8}}, {{201},{ 8}}, +{{ 41},{ 8}}, {{169},{ 8}}, {{105},{ 8}}, {{233},{ 8}}, {{ 25},{ 8}}, +{{153},{ 8}}, {{ 89},{ 8}}, {{217},{ 8}}, {{ 57},{ 8}}, {{185},{ 8}}, +{{121},{ 8}}, {{249},{ 8}}, {{ 5},{ 8}}, {{133},{ 8}}, {{ 69},{ 8}}, +{{197},{ 8}}, {{ 37},{ 8}}, {{165},{ 8}}, {{101},{ 8}}, {{229},{ 8}}, +{{ 21},{ 8}}, {{149},{ 8}}, {{ 85},{ 8}}, {{213},{ 8}}, {{ 53},{ 8}}, +{{181},{ 8}}, {{117},{ 8}}, {{245},{ 8}}, {{ 13},{ 8}}, {{141},{ 8}}, +{{ 77},{ 8}}, {{205},{ 8}}, {{ 45},{ 8}}, {{173},{ 8}}, {{109},{ 8}}, +{{237},{ 8}}, {{ 29},{ 8}}, {{157},{ 8}}, {{ 93},{ 8}}, {{221},{ 8}}, +{{ 61},{ 8}}, {{189},{ 8}}, {{125},{ 8}}, {{253},{ 8}}, {{ 19},{ 9}}, +{{275},{ 9}}, {{147},{ 9}}, {{403},{ 9}}, {{ 83},{ 9}}, {{339},{ 9}}, +{{211},{ 9}}, {{467},{ 9}}, {{ 51},{ 9}}, {{307},{ 9}}, {{179},{ 9}}, +{{435},{ 9}}, {{115},{ 9}}, {{371},{ 9}}, {{243},{ 9}}, {{499},{ 9}}, +{{ 11},{ 9}}, {{267},{ 9}}, {{139},{ 9}}, {{395},{ 9}}, {{ 75},{ 9}}, +{{331},{ 9}}, {{203},{ 9}}, {{459},{ 9}}, {{ 43},{ 9}}, {{299},{ 9}}, +{{171},{ 9}}, {{427},{ 9}}, {{107},{ 9}}, {{363},{ 9}}, {{235},{ 9}}, +{{491},{ 9}}, {{ 27},{ 9}}, {{283},{ 9}}, {{155},{ 9}}, {{411},{ 9}}, +{{ 91},{ 9}}, {{347},{ 9}}, {{219},{ 9}}, {{475},{ 9}}, {{ 59},{ 9}}, +{{315},{ 9}}, {{187},{ 9}}, {{443},{ 9}}, {{123},{ 9}}, {{379},{ 9}}, +{{251},{ 9}}, {{507},{ 9}}, {{ 7},{ 9}}, {{263},{ 9}}, {{135},{ 9}}, +{{391},{ 9}}, {{ 71},{ 9}}, {{327},{ 9}}, {{199},{ 9}}, {{455},{ 9}}, +{{ 39},{ 9}}, {{295},{ 9}}, {{167},{ 9}}, {{423},{ 9}}, {{103},{ 9}}, +{{359},{ 9}}, {{231},{ 9}}, {{487},{ 9}}, {{ 23},{ 9}}, {{279},{ 9}}, +{{151},{ 9}}, {{407},{ 9}}, {{ 87},{ 9}}, {{343},{ 9}}, {{215},{ 9}}, +{{471},{ 9}}, {{ 55},{ 9}}, {{311},{ 9}}, {{183},{ 9}}, {{439},{ 9}}, +{{119},{ 9}}, {{375},{ 9}}, {{247},{ 9}}, {{503},{ 9}}, {{ 15},{ 9}}, +{{271},{ 9}}, {{143},{ 9}}, {{399},{ 9}}, {{ 79},{ 9}}, {{335},{ 9}}, +{{207},{ 9}}, {{463},{ 9}}, {{ 47},{ 9}}, {{303},{ 9}}, {{175},{ 9}}, +{{431},{ 9}}, {{111},{ 9}}, {{367},{ 9}}, {{239},{ 9}}, {{495},{ 9}}, +{{ 31},{ 9}}, {{287},{ 9}}, {{159},{ 9}}, {{415},{ 9}}, {{ 95},{ 9}}, +{{351},{ 9}}, {{223},{ 9}}, {{479},{ 9}}, {{ 63},{ 9}}, {{319},{ 9}}, +{{191},{ 9}}, {{447},{ 9}}, {{127},{ 9}}, {{383},{ 9}}, {{255},{ 9}}, +{{511},{ 9}}, {{ 0},{ 7}}, {{ 64},{ 7}}, {{ 32},{ 7}}, {{ 96},{ 7}}, +{{ 16},{ 7}}, {{ 80},{ 7}}, {{ 48},{ 7}}, {{112},{ 7}}, {{ 8},{ 7}}, +{{ 72},{ 7}}, {{ 40},{ 7}}, {{104},{ 7}}, {{ 24},{ 7}}, {{ 88},{ 7}}, +{{ 56},{ 7}}, {{120},{ 7}}, {{ 4},{ 7}}, {{ 68},{ 7}}, {{ 36},{ 7}}, +{{100},{ 7}}, {{ 20},{ 7}}, {{ 84},{ 7}}, {{ 52},{ 7}}, {{116},{ 7}}, +{{ 3},{ 8}}, {{131},{ 8}}, {{ 67},{ 8}}, {{195},{ 8}}, {{ 35},{ 8}}, +{{163},{ 8}}, {{ 99},{ 8}}, {{227},{ 8}} +}; + +local const ct_data static_dtree[D_CODES] = { +{{ 0},{ 5}}, {{16},{ 5}}, {{ 8},{ 5}}, {{24},{ 5}}, {{ 4},{ 5}}, +{{20},{ 5}}, {{12},{ 5}}, {{28},{ 5}}, {{ 2},{ 5}}, {{18},{ 5}}, +{{10},{ 5}}, {{26},{ 5}}, {{ 6},{ 5}}, {{22},{ 5}}, {{14},{ 5}}, +{{30},{ 5}}, {{ 1},{ 5}}, {{17},{ 5}}, {{ 9},{ 5}}, {{25},{ 5}}, +{{ 5},{ 5}}, {{21},{ 5}}, {{13},{ 5}}, {{29},{ 5}}, {{ 3},{ 5}}, +{{19},{ 5}}, {{11},{ 5}}, {{27},{ 5}}, {{ 7},{ 5}}, {{23},{ 5}} +}; + +const uch ZLIB_INTERNAL _dist_code[DIST_CODE_LEN] = { + 0, 1, 2, 3, 4, 4, 5, 5, 6, 6, 6, 6, 7, 7, 7, 7, 8, 8, 8, 8, + 8, 8, 8, 8, 9, 9, 9, 9, 9, 9, 9, 9, 10, 10, 10, 10, 10, 10, 10, 10, +10, 10, 10, 10, 10, 10, 10, 10, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, 11, +11, 11, 11, 11, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, +12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 12, 13, 13, 13, 13, +13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, 13, +13, 13, 13, 13, 13, 13, 13, 13, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, +14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, +14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, +14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 14, 15, 15, 15, 15, 15, 15, 15, 15, +15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, +15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, +15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 15, 0, 0, 16, 17, +18, 18, 19, 19, 20, 20, 20, 20, 21, 21, 21, 21, 22, 22, 22, 22, 22, 22, 22, 22, +23, 23, 23, 23, 23, 23, 23, 23, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, +24, 24, 24, 24, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, +26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, +26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 27, 27, 27, 27, 27, 27, 27, 27, +27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, +27, 27, 27, 27, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, +28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, +28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28, +28, 28, 28, 28, 28, 28, 28, 28, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, +29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, +29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, +29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29, 29 +}; + +const uch ZLIB_INTERNAL _length_code[MAX_MATCH-MIN_MATCH+1]= { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 8, 9, 9, 10, 10, 11, 11, 12, 12, 12, 12, +13, 13, 13, 13, 14, 14, 14, 14, 15, 15, 15, 15, 16, 16, 16, 16, 16, 16, 16, 16, +17, 17, 17, 17, 17, 17, 17, 17, 18, 18, 18, 18, 18, 18, 18, 18, 19, 19, 19, 19, +19, 19, 19, 19, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, 20, +21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 21, 22, 22, 22, 22, +22, 22, 22, 22, 22, 22, 22, 22, 22, 22, 22, 22, 23, 23, 23, 23, 23, 23, 23, 23, +23, 23, 23, 23, 23, 23, 23, 23, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, +24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, 24, +25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, +25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 25, 26, 26, 26, 26, 26, 26, 26, 26, +26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, 26, +26, 26, 26, 26, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, +27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 27, 28 +}; + +local const int base_length[LENGTH_CODES] = { +0, 1, 2, 3, 4, 5, 6, 7, 8, 10, 12, 14, 16, 20, 24, 28, 32, 40, 48, 56, +64, 80, 96, 112, 128, 160, 192, 224, 0 +}; + +local const int base_dist[D_CODES] = { + 0, 1, 2, 3, 4, 6, 8, 12, 16, 24, + 32, 48, 64, 96, 128, 192, 256, 384, 512, 768, + 1024, 1536, 2048, 3072, 4096, 6144, 8192, 12288, 16384, 24576 +}; + diff --git a/include/zlib/zconf.h b/include/zlib/zconf.h new file mode 100644 index 0000000..5e1d68a --- /dev/null +++ b/include/zlib/zconf.h @@ -0,0 +1,534 @@ +/* zconf.h -- configuration of the zlib compression library + * Copyright (C) 1995-2016 Jean-loup Gailly, Mark Adler + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +/* @(#) $Id$ */ + +#ifndef ZCONF_H +#define ZCONF_H + +/* + * If you *really* need a unique prefix for all types and library functions, + * compile with -DZ_PREFIX. The "standard" zlib should be compiled without it. + * Even better than compiling with -DZ_PREFIX would be to use configure to set + * this permanently in zconf.h using "./configure --zprefix". + */ +#ifdef Z_PREFIX /* may be set to #if 1 by ./configure */ +# define Z_PREFIX_SET + +/* all linked symbols and init macros */ +# define _dist_code z__dist_code +# define _length_code z__length_code +# define _tr_align z__tr_align +# define _tr_flush_bits z__tr_flush_bits +# define _tr_flush_block z__tr_flush_block +# define _tr_init z__tr_init +# define _tr_stored_block z__tr_stored_block +# define _tr_tally z__tr_tally +# define adler32 z_adler32 +# define adler32_combine z_adler32_combine +# define adler32_combine64 z_adler32_combine64 +# define adler32_z z_adler32_z +# ifndef Z_SOLO +# define compress z_compress +# define compress2 z_compress2 +# define compressBound z_compressBound +# endif +# define crc32 z_crc32 +# define crc32_combine z_crc32_combine +# define crc32_combine64 z_crc32_combine64 +# define crc32_z z_crc32_z +# define deflate z_deflate +# define deflateBound z_deflateBound +# define deflateCopy z_deflateCopy +# define deflateEnd z_deflateEnd +# define deflateGetDictionary z_deflateGetDictionary +# define deflateInit z_deflateInit +# define deflateInit2 z_deflateInit2 +# define deflateInit2_ z_deflateInit2_ +# define deflateInit_ z_deflateInit_ +# define deflateParams z_deflateParams +# define deflatePending z_deflatePending +# define deflatePrime z_deflatePrime +# define deflateReset z_deflateReset +# define deflateResetKeep z_deflateResetKeep +# define deflateSetDictionary z_deflateSetDictionary +# define deflateSetHeader z_deflateSetHeader +# define deflateTune z_deflateTune +# define deflate_copyright z_deflate_copyright +# define get_crc_table z_get_crc_table +# ifndef Z_SOLO +# define gz_error z_gz_error +# define gz_intmax z_gz_intmax +# define gz_strwinerror z_gz_strwinerror +# define gzbuffer z_gzbuffer +# define gzclearerr z_gzclearerr +# define gzclose z_gzclose +# define gzclose_r z_gzclose_r +# define gzclose_w z_gzclose_w +# define gzdirect z_gzdirect +# define gzdopen z_gzdopen +# define gzeof z_gzeof +# define gzerror z_gzerror +# define gzflush z_gzflush +# define gzfread z_gzfread +# define gzfwrite z_gzfwrite +# define gzgetc z_gzgetc +# define gzgetc_ z_gzgetc_ +# define gzgets z_gzgets +# define gzoffset z_gzoffset +# define gzoffset64 z_gzoffset64 +# define gzopen z_gzopen +# define gzopen64 z_gzopen64 +# ifdef _WIN32 +# define gzopen_w z_gzopen_w +# endif +# define gzprintf z_gzprintf +# define gzputc z_gzputc +# define gzputs z_gzputs +# define gzread z_gzread +# define gzrewind z_gzrewind +# define gzseek z_gzseek +# define gzseek64 z_gzseek64 +# define gzsetparams z_gzsetparams +# define gztell z_gztell +# define gztell64 z_gztell64 +# define gzungetc z_gzungetc +# define gzvprintf z_gzvprintf +# define gzwrite z_gzwrite +# endif +# define inflate z_inflate +# define inflateBack z_inflateBack +# define inflateBackEnd z_inflateBackEnd +# define inflateBackInit z_inflateBackInit +# define inflateBackInit_ z_inflateBackInit_ +# define inflateCodesUsed z_inflateCodesUsed +# define inflateCopy z_inflateCopy +# define inflateEnd z_inflateEnd +# define inflateGetDictionary z_inflateGetDictionary +# define inflateGetHeader z_inflateGetHeader +# define inflateInit z_inflateInit +# define inflateInit2 z_inflateInit2 +# define inflateInit2_ z_inflateInit2_ +# define inflateInit_ z_inflateInit_ +# define inflateMark z_inflateMark +# define inflatePrime z_inflatePrime +# define inflateReset z_inflateReset +# define inflateReset2 z_inflateReset2 +# define inflateResetKeep z_inflateResetKeep +# define inflateSetDictionary z_inflateSetDictionary +# define inflateSync z_inflateSync +# define inflateSyncPoint z_inflateSyncPoint +# define inflateUndermine z_inflateUndermine +# define inflateValidate z_inflateValidate +# define inflate_copyright z_inflate_copyright +# define inflate_fast z_inflate_fast +# define inflate_table z_inflate_table +# ifndef Z_SOLO +# define uncompress z_uncompress +# define uncompress2 z_uncompress2 +# endif +# define zError z_zError +# ifndef Z_SOLO +# define zcalloc z_zcalloc +# define zcfree z_zcfree +# endif +# define zlibCompileFlags z_zlibCompileFlags +# define zlibVersion z_zlibVersion + +/* all zlib typedefs in zlib.h and zconf.h */ +# define Byte z_Byte +# define Bytef z_Bytef +# define alloc_func z_alloc_func +# define charf z_charf +# define free_func z_free_func +# ifndef Z_SOLO +# define gzFile z_gzFile +# endif +# define gz_header z_gz_header +# define gz_headerp z_gz_headerp +# define in_func z_in_func +# define intf z_intf +# define out_func z_out_func +# define uInt z_uInt +# define uIntf z_uIntf +# define uLong z_uLong +# define uLongf z_uLongf +# define voidp z_voidp +# define voidpc z_voidpc +# define voidpf z_voidpf + +/* all zlib structs in zlib.h and zconf.h */ +# define gz_header_s z_gz_header_s +# define internal_state z_internal_state + +#endif + +#if defined(__MSDOS__) && !defined(MSDOS) +# define MSDOS +#endif +#if (defined(OS_2) || defined(__OS2__)) && !defined(OS2) +# define OS2 +#endif +#if defined(_WINDOWS) && !defined(WINDOWS) +# define WINDOWS +#endif +#if defined(_WIN32) || defined(_WIN32_WCE) || defined(__WIN32__) +# ifndef WIN32 +# define WIN32 +# endif +#endif +#if (defined(MSDOS) || defined(OS2) || defined(WINDOWS)) && !defined(WIN32) +# if !defined(__GNUC__) && !defined(__FLAT__) && !defined(__386__) +# ifndef SYS16BIT +# define SYS16BIT +# endif +# endif +#endif + +/* + * Compile with -DMAXSEG_64K if the alloc function cannot allocate more + * than 64k bytes at a time (needed on systems with 16-bit int). + */ +#ifdef SYS16BIT +# define MAXSEG_64K +#endif +#ifdef MSDOS +# define UNALIGNED_OK +#endif + +#ifdef __STDC_VERSION__ +# ifndef STDC +# define STDC +# endif +# if __STDC_VERSION__ >= 199901L +# ifndef STDC99 +# define STDC99 +# endif +# endif +#endif +#if !defined(STDC) && (defined(__STDC__) || defined(__cplusplus)) +# define STDC +#endif +#if !defined(STDC) && (defined(__GNUC__) || defined(__BORLANDC__)) +# define STDC +#endif +#if !defined(STDC) && (defined(MSDOS) || defined(WINDOWS) || defined(WIN32)) +# define STDC +#endif +#if !defined(STDC) && (defined(OS2) || defined(__HOS_AIX__)) +# define STDC +#endif + +#if defined(__OS400__) && !defined(STDC) /* iSeries (formerly AS/400). */ +# define STDC +#endif + +#ifndef STDC +# ifndef const /* cannot use !defined(STDC) && !defined(const) on Mac */ +# define const /* note: need a more gentle solution here */ +# endif +#endif + +#if defined(ZLIB_CONST) && !defined(z_const) +# define z_const const +#else +# define z_const +#endif + +#ifdef Z_SOLO + typedef unsigned long z_size_t; +#else +# define z_longlong long long +# if defined(NO_SIZE_T) + typedef unsigned NO_SIZE_T z_size_t; +# elif defined(STDC) +# include + typedef size_t z_size_t; +# else + typedef unsigned long z_size_t; +# endif +# undef z_longlong +#endif + +/* Maximum value for memLevel in deflateInit2 */ +#ifndef MAX_MEM_LEVEL +# ifdef MAXSEG_64K +# define MAX_MEM_LEVEL 8 +# else +# define MAX_MEM_LEVEL 9 +# endif +#endif + +/* Maximum value for windowBits in deflateInit2 and inflateInit2. + * WARNING: reducing MAX_WBITS makes minigzip unable to extract .gz files + * created by gzip. (Files created by minigzip can still be extracted by + * gzip.) + */ +#ifndef MAX_WBITS +# define MAX_WBITS 15 /* 32K LZ77 window */ +#endif + +/* The memory requirements for deflate are (in bytes): + (1 << (windowBits+2)) + (1 << (memLevel+9)) + that is: 128K for windowBits=15 + 128K for memLevel = 8 (default values) + plus a few kilobytes for small objects. For example, if you want to reduce + the default memory requirements from 256K to 128K, compile with + make CFLAGS="-O -DMAX_WBITS=14 -DMAX_MEM_LEVEL=7" + Of course this will generally degrade compression (there's no free lunch). + + The memory requirements for inflate are (in bytes) 1 << windowBits + that is, 32K for windowBits=15 (default value) plus about 7 kilobytes + for small objects. +*/ + + /* Type declarations */ + +#ifndef OF /* function prototypes */ +# ifdef STDC +# define OF(args) args +# else +# define OF(args) () +# endif +#endif + +#ifndef Z_ARG /* function prototypes for stdarg */ +# if defined(STDC) || defined(Z_HAVE_STDARG_H) +# define Z_ARG(args) args +# else +# define Z_ARG(args) () +# endif +#endif + +/* The following definitions for FAR are needed only for MSDOS mixed + * model programming (small or medium model with some far allocations). + * This was tested only with MSC; for other MSDOS compilers you may have + * to define NO_MEMCPY in zutil.h. If you don't need the mixed model, + * just define FAR to be empty. + */ +#ifdef SYS16BIT +# if defined(M_I86SM) || defined(M_I86MM) + /* MSC small or medium model */ +# define SMALL_MEDIUM +# ifdef _MSC_VER +# define FAR _far +# else +# define FAR far +# endif +# endif +# if (defined(__SMALL__) || defined(__MEDIUM__)) + /* Turbo C small or medium model */ +# define SMALL_MEDIUM +# ifdef __BORLANDC__ +# define FAR _far +# else +# define FAR far +# endif +# endif +#endif + +#if defined(WINDOWS) || defined(WIN32) + /* If building or using zlib as a DLL, define ZLIB_DLL. + * This is not mandatory, but it offers a little performance increase. + */ +# ifdef ZLIB_DLL +# if defined(WIN32) && (!defined(__BORLANDC__) || (__BORLANDC__ >= 0x500)) +# ifdef ZLIB_INTERNAL +# define ZEXTERN extern __declspec(dllexport) +# else +# define ZEXTERN extern __declspec(dllimport) +# endif +# endif +# endif /* ZLIB_DLL */ + /* If building or using zlib with the WINAPI/WINAPIV calling convention, + * define ZLIB_WINAPI. + * Caution: the standard ZLIB1.DLL is NOT compiled using ZLIB_WINAPI. + */ +# ifdef ZLIB_WINAPI +# ifdef FAR +# undef FAR +# endif +# include + /* No need for _export, use ZLIB.DEF instead. */ + /* For complete Windows compatibility, use WINAPI, not __stdcall. */ +# define ZEXPORT WINAPI +# ifdef WIN32 +# define ZEXPORTVA WINAPIV +# else +# define ZEXPORTVA FAR CDECL +# endif +# endif +#endif + +#if defined (__BEOS__) +# ifdef ZLIB_DLL +# ifdef ZLIB_INTERNAL +# define ZEXPORT __declspec(dllexport) +# define ZEXPORTVA __declspec(dllexport) +# else +# define ZEXPORT __declspec(dllimport) +# define ZEXPORTVA __declspec(dllimport) +# endif +# endif +#endif + +#ifndef ZEXTERN +# define ZEXTERN extern +#endif +#ifndef ZEXPORT +# define ZEXPORT +#endif +#ifndef ZEXPORTVA +# define ZEXPORTVA +#endif + +#ifndef FAR +# define FAR +#endif + +#if !defined(__MACTYPES__) +typedef unsigned char Byte; /* 8 bits */ +#endif +typedef unsigned int uInt; /* 16 bits or more */ +typedef unsigned long uLong; /* 32 bits or more */ + +#ifdef SMALL_MEDIUM + /* Borland C/C++ and some old MSC versions ignore FAR inside typedef */ +# define Bytef Byte FAR +#else + typedef Byte FAR Bytef; +#endif +typedef char FAR charf; +typedef int FAR intf; +typedef uInt FAR uIntf; +typedef uLong FAR uLongf; + +#ifdef STDC + typedef void const *voidpc; + typedef void FAR *voidpf; + typedef void *voidp; +#else + typedef Byte const *voidpc; + typedef Byte FAR *voidpf; + typedef Byte *voidp; +#endif + +#if !defined(Z_U4) && !defined(Z_SOLO) && defined(STDC) +# include +# if (UINT_MAX == 0xffffffffUL) +# define Z_U4 unsigned +# elif (ULONG_MAX == 0xffffffffUL) +# define Z_U4 unsigned long +# elif (USHRT_MAX == 0xffffffffUL) +# define Z_U4 unsigned short +# endif +#endif + +#ifdef Z_U4 + typedef Z_U4 z_crc_t; +#else + typedef unsigned long z_crc_t; +#endif + +#ifdef HAVE_UNISTD_H /* may be set to #if 1 by ./configure */ +# define Z_HAVE_UNISTD_H +#endif + +#ifdef HAVE_STDARG_H /* may be set to #if 1 by ./configure */ +# define Z_HAVE_STDARG_H +#endif + +#ifdef STDC +# ifndef Z_SOLO +# include /* for off_t */ +# endif +#endif + +#if defined(STDC) || defined(Z_HAVE_STDARG_H) +# ifndef Z_SOLO +# include /* for va_list */ +# endif +#endif + +#ifdef _WIN32 +# ifndef Z_SOLO +# include /* for wchar_t */ +# endif +#endif + +/* a little trick to accommodate both "#define _LARGEFILE64_SOURCE" and + * "#define _LARGEFILE64_SOURCE 1" as requesting 64-bit operations, (even + * though the former does not conform to the LFS document), but considering + * both "#undef _LARGEFILE64_SOURCE" and "#define _LARGEFILE64_SOURCE 0" as + * equivalently requesting no 64-bit operations + */ +#if defined(_LARGEFILE64_SOURCE) && -_LARGEFILE64_SOURCE - -1 == 1 +# undef _LARGEFILE64_SOURCE +#endif + +#if defined(__WATCOMC__) && !defined(Z_HAVE_UNISTD_H) +# define Z_HAVE_UNISTD_H +#endif +#ifndef Z_SOLO +# if defined(Z_HAVE_UNISTD_H) || defined(_LARGEFILE64_SOURCE) +# include /* for SEEK_*, off_t, and _LFS64_LARGEFILE */ +# ifdef VMS +# include /* for off_t */ +# endif +# ifndef z_off_t +# define z_off_t off_t +# endif +# endif +#endif + +#if defined(_LFS64_LARGEFILE) && _LFS64_LARGEFILE-0 +# define Z_LFS64 +#endif + +#if defined(_LARGEFILE64_SOURCE) && defined(Z_LFS64) +# define Z_LARGE64 +#endif + +#if defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS-0 == 64 && defined(Z_LFS64) +# define Z_WANT64 +#endif + +#if !defined(SEEK_SET) && !defined(Z_SOLO) +# define SEEK_SET 0 /* Seek from beginning of file. */ +# define SEEK_CUR 1 /* Seek from current position. */ +# define SEEK_END 2 /* Set file pointer to EOF plus "offset" */ +#endif + +#ifndef z_off_t +# define z_off_t long +#endif + +#if !defined(_WIN32) && defined(Z_LARGE64) +# define z_off64_t off64_t +#else +# if defined(_WIN32) && !defined(__GNUC__) && !defined(Z_SOLO) +# define z_off64_t __int64 +# else +# define z_off64_t z_off_t +# endif +#endif + +/* MVS linker does not support external names larger than 8 bytes */ +#if defined(__MVS__) + #pragma map(deflateInit_,"DEIN") + #pragma map(deflateInit2_,"DEIN2") + #pragma map(deflateEnd,"DEEND") + #pragma map(deflateBound,"DEBND") + #pragma map(inflateInit_,"ININ") + #pragma map(inflateInit2_,"ININ2") + #pragma map(inflateEnd,"INEND") + #pragma map(inflateSync,"INSY") + #pragma map(inflateSetDictionary,"INSEDI") + #pragma map(compressBound,"CMBND") + #pragma map(inflate_table,"INTABL") + #pragma map(inflate_fast,"INFA") + #pragma map(inflate_copyright,"INCOPY") +#endif + +#endif /* ZCONF_H */ diff --git a/include/zlib/zlib.h b/include/zlib/zlib.h new file mode 100644 index 0000000..f09cdaf --- /dev/null +++ b/include/zlib/zlib.h @@ -0,0 +1,1912 @@ +/* zlib.h -- interface of the 'zlib' general purpose compression library + version 1.2.11, January 15th, 2017 + + Copyright (C) 1995-2017 Jean-loup Gailly and Mark Adler + + This software is provided 'as-is', without any express or implied + warranty. In no event will the authors be held liable for any damages + arising from the use of this software. + + Permission is granted to anyone to use this software for any purpose, + including commercial applications, and to alter it and redistribute it + freely, subject to the following restrictions: + + 1. The origin of this software must not be misrepresented; you must not + claim that you wrote the original software. If you use this software + in a product, an acknowledgment in the product documentation would be + appreciated but is not required. + 2. Altered source versions must be plainly marked as such, and must not be + misrepresented as being the original software. + 3. This notice may not be removed or altered from any source distribution. + + Jean-loup Gailly Mark Adler + jloup@gzip.org madler@alumni.caltech.edu + + + The data format used by the zlib library is described by RFCs (Request for + Comments) 1950 to 1952 in the files http://tools.ietf.org/html/rfc1950 + (zlib format), rfc1951 (deflate format) and rfc1952 (gzip format). +*/ + +#ifndef ZLIB_H +#define ZLIB_H + +#include "zconf.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#define ZLIB_VERSION "1.2.11" +#define ZLIB_VERNUM 0x12b0 +#define ZLIB_VER_MAJOR 1 +#define ZLIB_VER_MINOR 2 +#define ZLIB_VER_REVISION 11 +#define ZLIB_VER_SUBREVISION 0 + +/* + The 'zlib' compression library provides in-memory compression and + decompression functions, including integrity checks of the uncompressed data. + This version of the library supports only one compression method (deflation) + but other algorithms will be added later and will have the same stream + interface. + + Compression can be done in a single step if the buffers are large enough, + or can be done by repeated calls of the compression function. In the latter + case, the application must provide more input and/or consume the output + (providing more output space) before each call. + + The compressed data format used by default by the in-memory functions is + the zlib format, which is a zlib wrapper documented in RFC 1950, wrapped + around a deflate stream, which is itself documented in RFC 1951. + + The library also supports reading and writing files in gzip (.gz) format + with an interface similar to that of stdio using the functions that start + with "gz". The gzip format is different from the zlib format. gzip is a + gzip wrapper, documented in RFC 1952, wrapped around a deflate stream. + + This library can optionally read and write gzip and raw deflate streams in + memory as well. + + The zlib format was designed to be compact and fast for use in memory + and on communications channels. The gzip format was designed for single- + file compression on file systems, has a larger header than zlib to maintain + directory information, and uses a different, slower check method than zlib. + + The library does not install any signal handler. The decoder checks + the consistency of the compressed data, so the library should never crash + even in the case of corrupted input. +*/ + +typedef voidpf (*alloc_func) OF((voidpf opaque, uInt items, uInt size)); +typedef void (*free_func) OF((voidpf opaque, voidpf address)); + +struct internal_state; + +typedef struct z_stream_s { + z_const Bytef *next_in; /* next input byte */ + uInt avail_in; /* number of bytes available at next_in */ + uLong total_in; /* total number of input bytes read so far */ + + Bytef *next_out; /* next output byte will go here */ + uInt avail_out; /* remaining free space at next_out */ + uLong total_out; /* total number of bytes output so far */ + + z_const char *msg; /* last error message, NULL if no error */ + struct internal_state FAR *state; /* not visible by applications */ + + alloc_func zalloc; /* used to allocate the internal state */ + free_func zfree; /* used to free the internal state */ + voidpf opaque; /* private data object passed to zalloc and zfree */ + + int data_type; /* best guess about the data type: binary or text + for deflate, or the decoding state for inflate */ + uLong adler; /* Adler-32 or CRC-32 value of the uncompressed data */ + uLong reserved; /* reserved for future use */ +} z_stream; + +typedef z_stream FAR *z_streamp; + +/* + gzip header information passed to and from zlib routines. See RFC 1952 + for more details on the meanings of these fields. +*/ +typedef struct gz_header_s { + int text; /* true if compressed data believed to be text */ + uLong time; /* modification time */ + int xflags; /* extra flags (not used when writing a gzip file) */ + int os; /* operating system */ + Bytef *extra; /* pointer to extra field or Z_NULL if none */ + uInt extra_len; /* extra field length (valid if extra != Z_NULL) */ + uInt extra_max; /* space at extra (only when reading header) */ + Bytef *name; /* pointer to zero-terminated file name or Z_NULL */ + uInt name_max; /* space at name (only when reading header) */ + Bytef *comment; /* pointer to zero-terminated comment or Z_NULL */ + uInt comm_max; /* space at comment (only when reading header) */ + int hcrc; /* true if there was or will be a header crc */ + int done; /* true when done reading gzip header (not used + when writing a gzip file) */ +} gz_header; + +typedef gz_header FAR *gz_headerp; + +/* + The application must update next_in and avail_in when avail_in has dropped + to zero. It must update next_out and avail_out when avail_out has dropped + to zero. The application must initialize zalloc, zfree and opaque before + calling the init function. All other fields are set by the compression + library and must not be updated by the application. + + The opaque value provided by the application will be passed as the first + parameter for calls of zalloc and zfree. This can be useful for custom + memory management. The compression library attaches no meaning to the + opaque value. + + zalloc must return Z_NULL if there is not enough memory for the object. + If zlib is used in a multi-threaded application, zalloc and zfree must be + thread safe. In that case, zlib is thread-safe. When zalloc and zfree are + Z_NULL on entry to the initialization function, they are set to internal + routines that use the standard library functions malloc() and free(). + + On 16-bit systems, the functions zalloc and zfree must be able to allocate + exactly 65536 bytes, but will not be required to allocate more than this if + the symbol MAXSEG_64K is defined (see zconf.h). WARNING: On MSDOS, pointers + returned by zalloc for objects of exactly 65536 bytes *must* have their + offset normalized to zero. The default allocation function provided by this + library ensures this (see zutil.c). To reduce memory requirements and avoid + any allocation of 64K objects, at the expense of compression ratio, compile + the library with -DMAX_WBITS=14 (see zconf.h). + + The fields total_in and total_out can be used for statistics or progress + reports. After compression, total_in holds the total size of the + uncompressed data and may be saved for use by the decompressor (particularly + if the decompressor wants to decompress everything in a single step). +*/ + + /* constants */ + +#define Z_NO_FLUSH 0 +#define Z_PARTIAL_FLUSH 1 +#define Z_SYNC_FLUSH 2 +#define Z_FULL_FLUSH 3 +#define Z_FINISH 4 +#define Z_BLOCK 5 +#define Z_TREES 6 +/* Allowed flush values; see deflate() and inflate() below for details */ + +#define Z_OK 0 +#define Z_STREAM_END 1 +#define Z_NEED_DICT 2 +#define Z_ERRNO (-1) +#define Z_STREAM_ERROR (-2) +#define Z_DATA_ERROR (-3) +#define Z_MEM_ERROR (-4) +#define Z_BUF_ERROR (-5) +#define Z_VERSION_ERROR (-6) +/* Return codes for the compression/decompression functions. Negative values + * are errors, positive values are used for special but normal events. + */ + +#define Z_NO_COMPRESSION 0 +#define Z_BEST_SPEED 1 +#define Z_BEST_COMPRESSION 9 +#define Z_DEFAULT_COMPRESSION (-1) +/* compression levels */ + +#define Z_FILTERED 1 +#define Z_HUFFMAN_ONLY 2 +#define Z_RLE 3 +#define Z_FIXED 4 +#define Z_DEFAULT_STRATEGY 0 +/* compression strategy; see deflateInit2() below for details */ + +#define Z_BINARY 0 +#define Z_TEXT 1 +#define Z_ASCII Z_TEXT /* for compatibility with 1.2.2 and earlier */ +#define Z_UNKNOWN 2 +/* Possible values of the data_type field for deflate() */ + +#define Z_DEFLATED 8 +/* The deflate compression method (the only one supported in this version) */ + +#define Z_NULL 0 /* for initializing zalloc, zfree, opaque */ + +#define zlib_version zlibVersion() +/* for compatibility with versions < 1.0.2 */ + + + /* basic functions */ + +ZEXTERN const char * ZEXPORT zlibVersion OF((void)); +/* The application can compare zlibVersion and ZLIB_VERSION for consistency. + If the first character differs, the library code actually used is not + compatible with the zlib.h header file used by the application. This check + is automatically made by deflateInit and inflateInit. + */ + +/* +ZEXTERN int ZEXPORT deflateInit OF((z_streamp strm, int level)); + + Initializes the internal stream state for compression. The fields + zalloc, zfree and opaque must be initialized before by the caller. If + zalloc and zfree are set to Z_NULL, deflateInit updates them to use default + allocation functions. + + The compression level must be Z_DEFAULT_COMPRESSION, or between 0 and 9: + 1 gives best speed, 9 gives best compression, 0 gives no compression at all + (the input data is simply copied a block at a time). Z_DEFAULT_COMPRESSION + requests a default compromise between speed and compression (currently + equivalent to level 6). + + deflateInit returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_STREAM_ERROR if level is not a valid compression level, or + Z_VERSION_ERROR if the zlib library version (zlib_version) is incompatible + with the version assumed by the caller (ZLIB_VERSION). msg is set to null + if there is no error message. deflateInit does not perform any compression: + this will be done by deflate(). +*/ + + +ZEXTERN int ZEXPORT deflate OF((z_streamp strm, int flush)); +/* + deflate compresses as much data as possible, and stops when the input + buffer becomes empty or the output buffer becomes full. It may introduce + some output latency (reading input without producing any output) except when + forced to flush. + + The detailed semantics are as follows. deflate performs one or both of the + following actions: + + - Compress more input starting at next_in and update next_in and avail_in + accordingly. If not all input can be processed (because there is not + enough room in the output buffer), next_in and avail_in are updated and + processing will resume at this point for the next call of deflate(). + + - Generate more output starting at next_out and update next_out and avail_out + accordingly. This action is forced if the parameter flush is non zero. + Forcing flush frequently degrades the compression ratio, so this parameter + should be set only when necessary. Some output may be provided even if + flush is zero. + + Before the call of deflate(), the application should ensure that at least + one of the actions is possible, by providing more input and/or consuming more + output, and updating avail_in or avail_out accordingly; avail_out should + never be zero before the call. The application can consume the compressed + output when it wants, for example when the output buffer is full (avail_out + == 0), or after each call of deflate(). If deflate returns Z_OK and with + zero avail_out, it must be called again after making room in the output + buffer because there might be more output pending. See deflatePending(), + which can be used if desired to determine whether or not there is more ouput + in that case. + + Normally the parameter flush is set to Z_NO_FLUSH, which allows deflate to + decide how much data to accumulate before producing output, in order to + maximize compression. + + If the parameter flush is set to Z_SYNC_FLUSH, all pending output is + flushed to the output buffer and the output is aligned on a byte boundary, so + that the decompressor can get all input data available so far. (In + particular avail_in is zero after the call if enough output space has been + provided before the call.) Flushing may degrade compression for some + compression algorithms and so it should be used only when necessary. This + completes the current deflate block and follows it with an empty stored block + that is three bits plus filler bits to the next byte, followed by four bytes + (00 00 ff ff). + + If flush is set to Z_PARTIAL_FLUSH, all pending output is flushed to the + output buffer, but the output is not aligned to a byte boundary. All of the + input data so far will be available to the decompressor, as for Z_SYNC_FLUSH. + This completes the current deflate block and follows it with an empty fixed + codes block that is 10 bits long. This assures that enough bytes are output + in order for the decompressor to finish the block before the empty fixed + codes block. + + If flush is set to Z_BLOCK, a deflate block is completed and emitted, as + for Z_SYNC_FLUSH, but the output is not aligned on a byte boundary, and up to + seven bits of the current block are held to be written as the next byte after + the next deflate block is completed. In this case, the decompressor may not + be provided enough bits at this point in order to complete decompression of + the data provided so far to the compressor. It may need to wait for the next + block to be emitted. This is for advanced applications that need to control + the emission of deflate blocks. + + If flush is set to Z_FULL_FLUSH, all output is flushed as with + Z_SYNC_FLUSH, and the compression state is reset so that decompression can + restart from this point if previous compressed data has been damaged or if + random access is desired. Using Z_FULL_FLUSH too often can seriously degrade + compression. + + If deflate returns with avail_out == 0, this function must be called again + with the same value of the flush parameter and more output space (updated + avail_out), until the flush is complete (deflate returns with non-zero + avail_out). In the case of a Z_FULL_FLUSH or Z_SYNC_FLUSH, make sure that + avail_out is greater than six to avoid repeated flush markers due to + avail_out == 0 on return. + + If the parameter flush is set to Z_FINISH, pending input is processed, + pending output is flushed and deflate returns with Z_STREAM_END if there was + enough output space. If deflate returns with Z_OK or Z_BUF_ERROR, this + function must be called again with Z_FINISH and more output space (updated + avail_out) but no more input data, until it returns with Z_STREAM_END or an + error. After deflate has returned Z_STREAM_END, the only possible operations + on the stream are deflateReset or deflateEnd. + + Z_FINISH can be used in the first deflate call after deflateInit if all the + compression is to be done in a single step. In order to complete in one + call, avail_out must be at least the value returned by deflateBound (see + below). Then deflate is guaranteed to return Z_STREAM_END. If not enough + output space is provided, deflate will not return Z_STREAM_END, and it must + be called again as described above. + + deflate() sets strm->adler to the Adler-32 checksum of all input read + so far (that is, total_in bytes). If a gzip stream is being generated, then + strm->adler will be the CRC-32 checksum of the input read so far. (See + deflateInit2 below.) + + deflate() may update strm->data_type if it can make a good guess about + the input data type (Z_BINARY or Z_TEXT). If in doubt, the data is + considered binary. This field is only for information purposes and does not + affect the compression algorithm in any manner. + + deflate() returns Z_OK if some progress has been made (more input + processed or more output produced), Z_STREAM_END if all input has been + consumed and all output has been produced (only when flush is set to + Z_FINISH), Z_STREAM_ERROR if the stream state was inconsistent (for example + if next_in or next_out was Z_NULL or the state was inadvertently written over + by the application), or Z_BUF_ERROR if no progress is possible (for example + avail_in or avail_out was zero). Note that Z_BUF_ERROR is not fatal, and + deflate() can be called again with more input and more output space to + continue compressing. +*/ + + +ZEXTERN int ZEXPORT deflateEnd OF((z_streamp strm)); +/* + All dynamically allocated data structures for this stream are freed. + This function discards any unprocessed input and does not flush any pending + output. + + deflateEnd returns Z_OK if success, Z_STREAM_ERROR if the + stream state was inconsistent, Z_DATA_ERROR if the stream was freed + prematurely (some input or output was discarded). In the error case, msg + may be set but then points to a static string (which must not be + deallocated). +*/ + + +/* +ZEXTERN int ZEXPORT inflateInit OF((z_streamp strm)); + + Initializes the internal stream state for decompression. The fields + next_in, avail_in, zalloc, zfree and opaque must be initialized before by + the caller. In the current version of inflate, the provided input is not + read or consumed. The allocation of a sliding window will be deferred to + the first call of inflate (if the decompression does not complete on the + first call). If zalloc and zfree are set to Z_NULL, inflateInit updates + them to use default allocation functions. + + inflateInit returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_VERSION_ERROR if the zlib library version is incompatible with the + version assumed by the caller, or Z_STREAM_ERROR if the parameters are + invalid, such as a null pointer to the structure. msg is set to null if + there is no error message. inflateInit does not perform any decompression. + Actual decompression will be done by inflate(). So next_in, and avail_in, + next_out, and avail_out are unused and unchanged. The current + implementation of inflateInit() does not process any header information -- + that is deferred until inflate() is called. +*/ + + +ZEXTERN int ZEXPORT inflate OF((z_streamp strm, int flush)); +/* + inflate decompresses as much data as possible, and stops when the input + buffer becomes empty or the output buffer becomes full. It may introduce + some output latency (reading input without producing any output) except when + forced to flush. + + The detailed semantics are as follows. inflate performs one or both of the + following actions: + + - Decompress more input starting at next_in and update next_in and avail_in + accordingly. If not all input can be processed (because there is not + enough room in the output buffer), then next_in and avail_in are updated + accordingly, and processing will resume at this point for the next call of + inflate(). + + - Generate more output starting at next_out and update next_out and avail_out + accordingly. inflate() provides as much output as possible, until there is + no more input data or no more space in the output buffer (see below about + the flush parameter). + + Before the call of inflate(), the application should ensure that at least + one of the actions is possible, by providing more input and/or consuming more + output, and updating the next_* and avail_* values accordingly. If the + caller of inflate() does not provide both available input and available + output space, it is possible that there will be no progress made. The + application can consume the uncompressed output when it wants, for example + when the output buffer is full (avail_out == 0), or after each call of + inflate(). If inflate returns Z_OK and with zero avail_out, it must be + called again after making room in the output buffer because there might be + more output pending. + + The flush parameter of inflate() can be Z_NO_FLUSH, Z_SYNC_FLUSH, Z_FINISH, + Z_BLOCK, or Z_TREES. Z_SYNC_FLUSH requests that inflate() flush as much + output as possible to the output buffer. Z_BLOCK requests that inflate() + stop if and when it gets to the next deflate block boundary. When decoding + the zlib or gzip format, this will cause inflate() to return immediately + after the header and before the first block. When doing a raw inflate, + inflate() will go ahead and process the first block, and will return when it + gets to the end of that block, or when it runs out of data. + + The Z_BLOCK option assists in appending to or combining deflate streams. + To assist in this, on return inflate() always sets strm->data_type to the + number of unused bits in the last byte taken from strm->next_in, plus 64 if + inflate() is currently decoding the last block in the deflate stream, plus + 128 if inflate() returned immediately after decoding an end-of-block code or + decoding the complete header up to just before the first byte of the deflate + stream. The end-of-block will not be indicated until all of the uncompressed + data from that block has been written to strm->next_out. The number of + unused bits may in general be greater than seven, except when bit 7 of + data_type is set, in which case the number of unused bits will be less than + eight. data_type is set as noted here every time inflate() returns for all + flush options, and so can be used to determine the amount of currently + consumed input in bits. + + The Z_TREES option behaves as Z_BLOCK does, but it also returns when the + end of each deflate block header is reached, before any actual data in that + block is decoded. This allows the caller to determine the length of the + deflate block header for later use in random access within a deflate block. + 256 is added to the value of strm->data_type when inflate() returns + immediately after reaching the end of the deflate block header. + + inflate() should normally be called until it returns Z_STREAM_END or an + error. However if all decompression is to be performed in a single step (a + single call of inflate), the parameter flush should be set to Z_FINISH. In + this case all pending input is processed and all pending output is flushed; + avail_out must be large enough to hold all of the uncompressed data for the + operation to complete. (The size of the uncompressed data may have been + saved by the compressor for this purpose.) The use of Z_FINISH is not + required to perform an inflation in one step. However it may be used to + inform inflate that a faster approach can be used for the single inflate() + call. Z_FINISH also informs inflate to not maintain a sliding window if the + stream completes, which reduces inflate's memory footprint. If the stream + does not complete, either because not all of the stream is provided or not + enough output space is provided, then a sliding window will be allocated and + inflate() can be called again to continue the operation as if Z_NO_FLUSH had + been used. + + In this implementation, inflate() always flushes as much output as + possible to the output buffer, and always uses the faster approach on the + first call. So the effects of the flush parameter in this implementation are + on the return value of inflate() as noted below, when inflate() returns early + when Z_BLOCK or Z_TREES is used, and when inflate() avoids the allocation of + memory for a sliding window when Z_FINISH is used. + + If a preset dictionary is needed after this call (see inflateSetDictionary + below), inflate sets strm->adler to the Adler-32 checksum of the dictionary + chosen by the compressor and returns Z_NEED_DICT; otherwise it sets + strm->adler to the Adler-32 checksum of all output produced so far (that is, + total_out bytes) and returns Z_OK, Z_STREAM_END or an error code as described + below. At the end of the stream, inflate() checks that its computed Adler-32 + checksum is equal to that saved by the compressor and returns Z_STREAM_END + only if the checksum is correct. + + inflate() can decompress and check either zlib-wrapped or gzip-wrapped + deflate data. The header type is detected automatically, if requested when + initializing with inflateInit2(). Any information contained in the gzip + header is not retained unless inflateGetHeader() is used. When processing + gzip-wrapped deflate data, strm->adler32 is set to the CRC-32 of the output + produced so far. The CRC-32 is checked against the gzip trailer, as is the + uncompressed length, modulo 2^32. + + inflate() returns Z_OK if some progress has been made (more input processed + or more output produced), Z_STREAM_END if the end of the compressed data has + been reached and all uncompressed output has been produced, Z_NEED_DICT if a + preset dictionary is needed at this point, Z_DATA_ERROR if the input data was + corrupted (input stream not conforming to the zlib format or incorrect check + value, in which case strm->msg points to a string with a more specific + error), Z_STREAM_ERROR if the stream structure was inconsistent (for example + next_in or next_out was Z_NULL, or the state was inadvertently written over + by the application), Z_MEM_ERROR if there was not enough memory, Z_BUF_ERROR + if no progress was possible or if there was not enough room in the output + buffer when Z_FINISH is used. Note that Z_BUF_ERROR is not fatal, and + inflate() can be called again with more input and more output space to + continue decompressing. If Z_DATA_ERROR is returned, the application may + then call inflateSync() to look for a good compression block if a partial + recovery of the data is to be attempted. +*/ + + +ZEXTERN int ZEXPORT inflateEnd OF((z_streamp strm)); +/* + All dynamically allocated data structures for this stream are freed. + This function discards any unprocessed input and does not flush any pending + output. + + inflateEnd returns Z_OK if success, or Z_STREAM_ERROR if the stream state + was inconsistent. +*/ + + + /* Advanced functions */ + +/* + The following functions are needed only in some special applications. +*/ + +/* +ZEXTERN int ZEXPORT deflateInit2 OF((z_streamp strm, + int level, + int method, + int windowBits, + int memLevel, + int strategy)); + + This is another version of deflateInit with more compression options. The + fields next_in, zalloc, zfree and opaque must be initialized before by the + caller. + + The method parameter is the compression method. It must be Z_DEFLATED in + this version of the library. + + The windowBits parameter is the base two logarithm of the window size + (the size of the history buffer). It should be in the range 8..15 for this + version of the library. Larger values of this parameter result in better + compression at the expense of memory usage. The default value is 15 if + deflateInit is used instead. + + For the current implementation of deflate(), a windowBits value of 8 (a + window size of 256 bytes) is not supported. As a result, a request for 8 + will result in 9 (a 512-byte window). In that case, providing 8 to + inflateInit2() will result in an error when the zlib header with 9 is + checked against the initialization of inflate(). The remedy is to not use 8 + with deflateInit2() with this initialization, or at least in that case use 9 + with inflateInit2(). + + windowBits can also be -8..-15 for raw deflate. In this case, -windowBits + determines the window size. deflate() will then generate raw deflate data + with no zlib header or trailer, and will not compute a check value. + + windowBits can also be greater than 15 for optional gzip encoding. Add + 16 to windowBits to write a simple gzip header and trailer around the + compressed data instead of a zlib wrapper. The gzip header will have no + file name, no extra data, no comment, no modification time (set to zero), no + header crc, and the operating system will be set to the appropriate value, + if the operating system was determined at compile time. If a gzip stream is + being written, strm->adler is a CRC-32 instead of an Adler-32. + + For raw deflate or gzip encoding, a request for a 256-byte window is + rejected as invalid, since only the zlib header provides a means of + transmitting the window size to the decompressor. + + The memLevel parameter specifies how much memory should be allocated + for the internal compression state. memLevel=1 uses minimum memory but is + slow and reduces compression ratio; memLevel=9 uses maximum memory for + optimal speed. The default value is 8. See zconf.h for total memory usage + as a function of windowBits and memLevel. + + The strategy parameter is used to tune the compression algorithm. Use the + value Z_DEFAULT_STRATEGY for normal data, Z_FILTERED for data produced by a + filter (or predictor), Z_HUFFMAN_ONLY to force Huffman encoding only (no + string match), or Z_RLE to limit match distances to one (run-length + encoding). Filtered data consists mostly of small values with a somewhat + random distribution. In this case, the compression algorithm is tuned to + compress them better. The effect of Z_FILTERED is to force more Huffman + coding and less string matching; it is somewhat intermediate between + Z_DEFAULT_STRATEGY and Z_HUFFMAN_ONLY. Z_RLE is designed to be almost as + fast as Z_HUFFMAN_ONLY, but give better compression for PNG image data. The + strategy parameter only affects the compression ratio but not the + correctness of the compressed output even if it is not set appropriately. + Z_FIXED prevents the use of dynamic Huffman codes, allowing for a simpler + decoder for special applications. + + deflateInit2 returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_STREAM_ERROR if any parameter is invalid (such as an invalid + method), or Z_VERSION_ERROR if the zlib library version (zlib_version) is + incompatible with the version assumed by the caller (ZLIB_VERSION). msg is + set to null if there is no error message. deflateInit2 does not perform any + compression: this will be done by deflate(). +*/ + +ZEXTERN int ZEXPORT deflateSetDictionary OF((z_streamp strm, + const Bytef *dictionary, + uInt dictLength)); +/* + Initializes the compression dictionary from the given byte sequence + without producing any compressed output. When using the zlib format, this + function must be called immediately after deflateInit, deflateInit2 or + deflateReset, and before any call of deflate. When doing raw deflate, this + function must be called either before any call of deflate, or immediately + after the completion of a deflate block, i.e. after all input has been + consumed and all output has been delivered when using any of the flush + options Z_BLOCK, Z_PARTIAL_FLUSH, Z_SYNC_FLUSH, or Z_FULL_FLUSH. The + compressor and decompressor must use exactly the same dictionary (see + inflateSetDictionary). + + The dictionary should consist of strings (byte sequences) that are likely + to be encountered later in the data to be compressed, with the most commonly + used strings preferably put towards the end of the dictionary. Using a + dictionary is most useful when the data to be compressed is short and can be + predicted with good accuracy; the data can then be compressed better than + with the default empty dictionary. + + Depending on the size of the compression data structures selected by + deflateInit or deflateInit2, a part of the dictionary may in effect be + discarded, for example if the dictionary is larger than the window size + provided in deflateInit or deflateInit2. Thus the strings most likely to be + useful should be put at the end of the dictionary, not at the front. In + addition, the current implementation of deflate will use at most the window + size minus 262 bytes of the provided dictionary. + + Upon return of this function, strm->adler is set to the Adler-32 value + of the dictionary; the decompressor may later use this value to determine + which dictionary has been used by the compressor. (The Adler-32 value + applies to the whole dictionary even if only a subset of the dictionary is + actually used by the compressor.) If a raw deflate was requested, then the + Adler-32 value is not computed and strm->adler is not set. + + deflateSetDictionary returns Z_OK if success, or Z_STREAM_ERROR if a + parameter is invalid (e.g. dictionary being Z_NULL) or the stream state is + inconsistent (for example if deflate has already been called for this stream + or if not at a block boundary for raw deflate). deflateSetDictionary does + not perform any compression: this will be done by deflate(). +*/ + +ZEXTERN int ZEXPORT deflateGetDictionary OF((z_streamp strm, + Bytef *dictionary, + uInt *dictLength)); +/* + Returns the sliding dictionary being maintained by deflate. dictLength is + set to the number of bytes in the dictionary, and that many bytes are copied + to dictionary. dictionary must have enough space, where 32768 bytes is + always enough. If deflateGetDictionary() is called with dictionary equal to + Z_NULL, then only the dictionary length is returned, and nothing is copied. + Similary, if dictLength is Z_NULL, then it is not set. + + deflateGetDictionary() may return a length less than the window size, even + when more than the window size in input has been provided. It may return up + to 258 bytes less in that case, due to how zlib's implementation of deflate + manages the sliding window and lookahead for matches, where matches can be + up to 258 bytes long. If the application needs the last window-size bytes of + input, then that would need to be saved by the application outside of zlib. + + deflateGetDictionary returns Z_OK on success, or Z_STREAM_ERROR if the + stream state is inconsistent. +*/ + +ZEXTERN int ZEXPORT deflateCopy OF((z_streamp dest, + z_streamp source)); +/* + Sets the destination stream as a complete copy of the source stream. + + This function can be useful when several compression strategies will be + tried, for example when there are several ways of pre-processing the input + data with a filter. The streams that will be discarded should then be freed + by calling deflateEnd. Note that deflateCopy duplicates the internal + compression state which can be quite large, so this strategy is slow and can + consume lots of memory. + + deflateCopy returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_STREAM_ERROR if the source stream state was inconsistent + (such as zalloc being Z_NULL). msg is left unchanged in both source and + destination. +*/ + +ZEXTERN int ZEXPORT deflateReset OF((z_streamp strm)); +/* + This function is equivalent to deflateEnd followed by deflateInit, but + does not free and reallocate the internal compression state. The stream + will leave the compression level and any other attributes that may have been + set unchanged. + + deflateReset returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent (such as zalloc or state being Z_NULL). +*/ + +ZEXTERN int ZEXPORT deflateParams OF((z_streamp strm, + int level, + int strategy)); +/* + Dynamically update the compression level and compression strategy. The + interpretation of level and strategy is as in deflateInit2(). This can be + used to switch between compression and straight copy of the input data, or + to switch to a different kind of input data requiring a different strategy. + If the compression approach (which is a function of the level) or the + strategy is changed, and if any input has been consumed in a previous + deflate() call, then the input available so far is compressed with the old + level and strategy using deflate(strm, Z_BLOCK). There are three approaches + for the compression levels 0, 1..3, and 4..9 respectively. The new level + and strategy will take effect at the next call of deflate(). + + If a deflate(strm, Z_BLOCK) is performed by deflateParams(), and it does + not have enough output space to complete, then the parameter change will not + take effect. In this case, deflateParams() can be called again with the + same parameters and more output space to try again. + + In order to assure a change in the parameters on the first try, the + deflate stream should be flushed using deflate() with Z_BLOCK or other flush + request until strm.avail_out is not zero, before calling deflateParams(). + Then no more input data should be provided before the deflateParams() call. + If this is done, the old level and strategy will be applied to the data + compressed before deflateParams(), and the new level and strategy will be + applied to the the data compressed after deflateParams(). + + deflateParams returns Z_OK on success, Z_STREAM_ERROR if the source stream + state was inconsistent or if a parameter was invalid, or Z_BUF_ERROR if + there was not enough output space to complete the compression of the + available input data before a change in the strategy or approach. Note that + in the case of a Z_BUF_ERROR, the parameters are not changed. A return + value of Z_BUF_ERROR is not fatal, in which case deflateParams() can be + retried with more output space. +*/ + +ZEXTERN int ZEXPORT deflateTune OF((z_streamp strm, + int good_length, + int max_lazy, + int nice_length, + int max_chain)); +/* + Fine tune deflate's internal compression parameters. This should only be + used by someone who understands the algorithm used by zlib's deflate for + searching for the best matching string, and even then only by the most + fanatic optimizer trying to squeeze out the last compressed bit for their + specific input data. Read the deflate.c source code for the meaning of the + max_lazy, good_length, nice_length, and max_chain parameters. + + deflateTune() can be called after deflateInit() or deflateInit2(), and + returns Z_OK on success, or Z_STREAM_ERROR for an invalid deflate stream. + */ + +ZEXTERN uLong ZEXPORT deflateBound OF((z_streamp strm, + uLong sourceLen)); +/* + deflateBound() returns an upper bound on the compressed size after + deflation of sourceLen bytes. It must be called after deflateInit() or + deflateInit2(), and after deflateSetHeader(), if used. This would be used + to allocate an output buffer for deflation in a single pass, and so would be + called before deflate(). If that first deflate() call is provided the + sourceLen input bytes, an output buffer allocated to the size returned by + deflateBound(), and the flush value Z_FINISH, then deflate() is guaranteed + to return Z_STREAM_END. Note that it is possible for the compressed size to + be larger than the value returned by deflateBound() if flush options other + than Z_FINISH or Z_NO_FLUSH are used. +*/ + +ZEXTERN int ZEXPORT deflatePending OF((z_streamp strm, + unsigned *pending, + int *bits)); +/* + deflatePending() returns the number of bytes and bits of output that have + been generated, but not yet provided in the available output. The bytes not + provided would be due to the available output space having being consumed. + The number of bits of output not provided are between 0 and 7, where they + await more bits to join them in order to fill out a full byte. If pending + or bits are Z_NULL, then those values are not set. + + deflatePending returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. + */ + +ZEXTERN int ZEXPORT deflatePrime OF((z_streamp strm, + int bits, + int value)); +/* + deflatePrime() inserts bits in the deflate output stream. The intent + is that this function is used to start off the deflate output with the bits + leftover from a previous deflate stream when appending to it. As such, this + function can only be used for raw deflate, and must be used before the first + deflate() call after a deflateInit2() or deflateReset(). bits must be less + than or equal to 16, and that many of the least significant bits of value + will be inserted in the output. + + deflatePrime returns Z_OK if success, Z_BUF_ERROR if there was not enough + room in the internal buffer to insert the bits, or Z_STREAM_ERROR if the + source stream state was inconsistent. +*/ + +ZEXTERN int ZEXPORT deflateSetHeader OF((z_streamp strm, + gz_headerp head)); +/* + deflateSetHeader() provides gzip header information for when a gzip + stream is requested by deflateInit2(). deflateSetHeader() may be called + after deflateInit2() or deflateReset() and before the first call of + deflate(). The text, time, os, extra field, name, and comment information + in the provided gz_header structure are written to the gzip header (xflag is + ignored -- the extra flags are set according to the compression level). The + caller must assure that, if not Z_NULL, name and comment are terminated with + a zero byte, and that if extra is not Z_NULL, that extra_len bytes are + available there. If hcrc is true, a gzip header crc is included. Note that + the current versions of the command-line version of gzip (up through version + 1.3.x) do not support header crc's, and will report that it is a "multi-part + gzip file" and give up. + + If deflateSetHeader is not used, the default gzip header has text false, + the time set to zero, and os set to 255, with no extra, name, or comment + fields. The gzip header is returned to the default state by deflateReset(). + + deflateSetHeader returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. +*/ + +/* +ZEXTERN int ZEXPORT inflateInit2 OF((z_streamp strm, + int windowBits)); + + This is another version of inflateInit with an extra parameter. The + fields next_in, avail_in, zalloc, zfree and opaque must be initialized + before by the caller. + + The windowBits parameter is the base two logarithm of the maximum window + size (the size of the history buffer). It should be in the range 8..15 for + this version of the library. The default value is 15 if inflateInit is used + instead. windowBits must be greater than or equal to the windowBits value + provided to deflateInit2() while compressing, or it must be equal to 15 if + deflateInit2() was not used. If a compressed stream with a larger window + size is given as input, inflate() will return with the error code + Z_DATA_ERROR instead of trying to allocate a larger window. + + windowBits can also be zero to request that inflate use the window size in + the zlib header of the compressed stream. + + windowBits can also be -8..-15 for raw inflate. In this case, -windowBits + determines the window size. inflate() will then process raw deflate data, + not looking for a zlib or gzip header, not generating a check value, and not + looking for any check values for comparison at the end of the stream. This + is for use with other formats that use the deflate compressed data format + such as zip. Those formats provide their own check values. If a custom + format is developed using the raw deflate format for compressed data, it is + recommended that a check value such as an Adler-32 or a CRC-32 be applied to + the uncompressed data as is done in the zlib, gzip, and zip formats. For + most applications, the zlib format should be used as is. Note that comments + above on the use in deflateInit2() applies to the magnitude of windowBits. + + windowBits can also be greater than 15 for optional gzip decoding. Add + 32 to windowBits to enable zlib and gzip decoding with automatic header + detection, or add 16 to decode only the gzip format (the zlib format will + return a Z_DATA_ERROR). If a gzip stream is being decoded, strm->adler is a + CRC-32 instead of an Adler-32. Unlike the gunzip utility and gzread() (see + below), inflate() will not automatically decode concatenated gzip streams. + inflate() will return Z_STREAM_END at the end of the gzip stream. The state + would need to be reset to continue decoding a subsequent gzip stream. + + inflateInit2 returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_VERSION_ERROR if the zlib library version is incompatible with the + version assumed by the caller, or Z_STREAM_ERROR if the parameters are + invalid, such as a null pointer to the structure. msg is set to null if + there is no error message. inflateInit2 does not perform any decompression + apart from possibly reading the zlib header if present: actual decompression + will be done by inflate(). (So next_in and avail_in may be modified, but + next_out and avail_out are unused and unchanged.) The current implementation + of inflateInit2() does not process any header information -- that is + deferred until inflate() is called. +*/ + +ZEXTERN int ZEXPORT inflateSetDictionary OF((z_streamp strm, + const Bytef *dictionary, + uInt dictLength)); +/* + Initializes the decompression dictionary from the given uncompressed byte + sequence. This function must be called immediately after a call of inflate, + if that call returned Z_NEED_DICT. The dictionary chosen by the compressor + can be determined from the Adler-32 value returned by that call of inflate. + The compressor and decompressor must use exactly the same dictionary (see + deflateSetDictionary). For raw inflate, this function can be called at any + time to set the dictionary. If the provided dictionary is smaller than the + window and there is already data in the window, then the provided dictionary + will amend what's there. The application must insure that the dictionary + that was used for compression is provided. + + inflateSetDictionary returns Z_OK if success, Z_STREAM_ERROR if a + parameter is invalid (e.g. dictionary being Z_NULL) or the stream state is + inconsistent, Z_DATA_ERROR if the given dictionary doesn't match the + expected one (incorrect Adler-32 value). inflateSetDictionary does not + perform any decompression: this will be done by subsequent calls of + inflate(). +*/ + +ZEXTERN int ZEXPORT inflateGetDictionary OF((z_streamp strm, + Bytef *dictionary, + uInt *dictLength)); +/* + Returns the sliding dictionary being maintained by inflate. dictLength is + set to the number of bytes in the dictionary, and that many bytes are copied + to dictionary. dictionary must have enough space, where 32768 bytes is + always enough. If inflateGetDictionary() is called with dictionary equal to + Z_NULL, then only the dictionary length is returned, and nothing is copied. + Similary, if dictLength is Z_NULL, then it is not set. + + inflateGetDictionary returns Z_OK on success, or Z_STREAM_ERROR if the + stream state is inconsistent. +*/ + +ZEXTERN int ZEXPORT inflateSync OF((z_streamp strm)); +/* + Skips invalid compressed data until a possible full flush point (see above + for the description of deflate with Z_FULL_FLUSH) can be found, or until all + available input is skipped. No output is provided. + + inflateSync searches for a 00 00 FF FF pattern in the compressed data. + All full flush points have this pattern, but not all occurrences of this + pattern are full flush points. + + inflateSync returns Z_OK if a possible full flush point has been found, + Z_BUF_ERROR if no more input was provided, Z_DATA_ERROR if no flush point + has been found, or Z_STREAM_ERROR if the stream structure was inconsistent. + In the success case, the application may save the current current value of + total_in which indicates where valid compressed data was found. In the + error case, the application may repeatedly call inflateSync, providing more + input each time, until success or end of the input data. +*/ + +ZEXTERN int ZEXPORT inflateCopy OF((z_streamp dest, + z_streamp source)); +/* + Sets the destination stream as a complete copy of the source stream. + + This function can be useful when randomly accessing a large stream. The + first pass through the stream can periodically record the inflate state, + allowing restarting inflate at those points when randomly accessing the + stream. + + inflateCopy returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_STREAM_ERROR if the source stream state was inconsistent + (such as zalloc being Z_NULL). msg is left unchanged in both source and + destination. +*/ + +ZEXTERN int ZEXPORT inflateReset OF((z_streamp strm)); +/* + This function is equivalent to inflateEnd followed by inflateInit, + but does not free and reallocate the internal decompression state. The + stream will keep attributes that may have been set by inflateInit2. + + inflateReset returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent (such as zalloc or state being Z_NULL). +*/ + +ZEXTERN int ZEXPORT inflateReset2 OF((z_streamp strm, + int windowBits)); +/* + This function is the same as inflateReset, but it also permits changing + the wrap and window size requests. The windowBits parameter is interpreted + the same as it is for inflateInit2. If the window size is changed, then the + memory allocated for the window is freed, and the window will be reallocated + by inflate() if needed. + + inflateReset2 returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent (such as zalloc or state being Z_NULL), or if + the windowBits parameter is invalid. +*/ + +ZEXTERN int ZEXPORT inflatePrime OF((z_streamp strm, + int bits, + int value)); +/* + This function inserts bits in the inflate input stream. The intent is + that this function is used to start inflating at a bit position in the + middle of a byte. The provided bits will be used before any bytes are used + from next_in. This function should only be used with raw inflate, and + should be used before the first inflate() call after inflateInit2() or + inflateReset(). bits must be less than or equal to 16, and that many of the + least significant bits of value will be inserted in the input. + + If bits is negative, then the input stream bit buffer is emptied. Then + inflatePrime() can be called again to put bits in the buffer. This is used + to clear out bits leftover after feeding inflate a block description prior + to feeding inflate codes. + + inflatePrime returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. +*/ + +ZEXTERN long ZEXPORT inflateMark OF((z_streamp strm)); +/* + This function returns two values, one in the lower 16 bits of the return + value, and the other in the remaining upper bits, obtained by shifting the + return value down 16 bits. If the upper value is -1 and the lower value is + zero, then inflate() is currently decoding information outside of a block. + If the upper value is -1 and the lower value is non-zero, then inflate is in + the middle of a stored block, with the lower value equaling the number of + bytes from the input remaining to copy. If the upper value is not -1, then + it is the number of bits back from the current bit position in the input of + the code (literal or length/distance pair) currently being processed. In + that case the lower value is the number of bytes already emitted for that + code. + + A code is being processed if inflate is waiting for more input to complete + decoding of the code, or if it has completed decoding but is waiting for + more output space to write the literal or match data. + + inflateMark() is used to mark locations in the input data for random + access, which may be at bit positions, and to note those cases where the + output of a code may span boundaries of random access blocks. The current + location in the input stream can be determined from avail_in and data_type + as noted in the description for the Z_BLOCK flush parameter for inflate. + + inflateMark returns the value noted above, or -65536 if the provided + source stream state was inconsistent. +*/ + +ZEXTERN int ZEXPORT inflateGetHeader OF((z_streamp strm, + gz_headerp head)); +/* + inflateGetHeader() requests that gzip header information be stored in the + provided gz_header structure. inflateGetHeader() may be called after + inflateInit2() or inflateReset(), and before the first call of inflate(). + As inflate() processes the gzip stream, head->done is zero until the header + is completed, at which time head->done is set to one. If a zlib stream is + being decoded, then head->done is set to -1 to indicate that there will be + no gzip header information forthcoming. Note that Z_BLOCK or Z_TREES can be + used to force inflate() to return immediately after header processing is + complete and before any actual data is decompressed. + + The text, time, xflags, and os fields are filled in with the gzip header + contents. hcrc is set to true if there is a header CRC. (The header CRC + was valid if done is set to one.) If extra is not Z_NULL, then extra_max + contains the maximum number of bytes to write to extra. Once done is true, + extra_len contains the actual extra field length, and extra contains the + extra field, or that field truncated if extra_max is less than extra_len. + If name is not Z_NULL, then up to name_max characters are written there, + terminated with a zero unless the length is greater than name_max. If + comment is not Z_NULL, then up to comm_max characters are written there, + terminated with a zero unless the length is greater than comm_max. When any + of extra, name, or comment are not Z_NULL and the respective field is not + present in the header, then that field is set to Z_NULL to signal its + absence. This allows the use of deflateSetHeader() with the returned + structure to duplicate the header. However if those fields are set to + allocated memory, then the application will need to save those pointers + elsewhere so that they can be eventually freed. + + If inflateGetHeader is not used, then the header information is simply + discarded. The header is always checked for validity, including the header + CRC if present. inflateReset() will reset the process to discard the header + information. The application would need to call inflateGetHeader() again to + retrieve the header from the next gzip stream. + + inflateGetHeader returns Z_OK if success, or Z_STREAM_ERROR if the source + stream state was inconsistent. +*/ + +/* +ZEXTERN int ZEXPORT inflateBackInit OF((z_streamp strm, int windowBits, + unsigned char FAR *window)); + + Initialize the internal stream state for decompression using inflateBack() + calls. The fields zalloc, zfree and opaque in strm must be initialized + before the call. If zalloc and zfree are Z_NULL, then the default library- + derived memory allocation routines are used. windowBits is the base two + logarithm of the window size, in the range 8..15. window is a caller + supplied buffer of that size. Except for special applications where it is + assured that deflate was used with small window sizes, windowBits must be 15 + and a 32K byte window must be supplied to be able to decompress general + deflate streams. + + See inflateBack() for the usage of these routines. + + inflateBackInit will return Z_OK on success, Z_STREAM_ERROR if any of + the parameters are invalid, Z_MEM_ERROR if the internal state could not be + allocated, or Z_VERSION_ERROR if the version of the library does not match + the version of the header file. +*/ + +typedef unsigned (*in_func) OF((void FAR *, + z_const unsigned char FAR * FAR *)); +typedef int (*out_func) OF((void FAR *, unsigned char FAR *, unsigned)); + +ZEXTERN int ZEXPORT inflateBack OF((z_streamp strm, + in_func in, void FAR *in_desc, + out_func out, void FAR *out_desc)); +/* + inflateBack() does a raw inflate with a single call using a call-back + interface for input and output. This is potentially more efficient than + inflate() for file i/o applications, in that it avoids copying between the + output and the sliding window by simply making the window itself the output + buffer. inflate() can be faster on modern CPUs when used with large + buffers. inflateBack() trusts the application to not change the output + buffer passed by the output function, at least until inflateBack() returns. + + inflateBackInit() must be called first to allocate the internal state + and to initialize the state with the user-provided window buffer. + inflateBack() may then be used multiple times to inflate a complete, raw + deflate stream with each call. inflateBackEnd() is then called to free the + allocated state. + + A raw deflate stream is one with no zlib or gzip header or trailer. + This routine would normally be used in a utility that reads zip or gzip + files and writes out uncompressed files. The utility would decode the + header and process the trailer on its own, hence this routine expects only + the raw deflate stream to decompress. This is different from the default + behavior of inflate(), which expects a zlib header and trailer around the + deflate stream. + + inflateBack() uses two subroutines supplied by the caller that are then + called by inflateBack() for input and output. inflateBack() calls those + routines until it reads a complete deflate stream and writes out all of the + uncompressed data, or until it encounters an error. The function's + parameters and return types are defined above in the in_func and out_func + typedefs. inflateBack() will call in(in_desc, &buf) which should return the + number of bytes of provided input, and a pointer to that input in buf. If + there is no input available, in() must return zero -- buf is ignored in that + case -- and inflateBack() will return a buffer error. inflateBack() will + call out(out_desc, buf, len) to write the uncompressed data buf[0..len-1]. + out() should return zero on success, or non-zero on failure. If out() + returns non-zero, inflateBack() will return with an error. Neither in() nor + out() are permitted to change the contents of the window provided to + inflateBackInit(), which is also the buffer that out() uses to write from. + The length written by out() will be at most the window size. Any non-zero + amount of input may be provided by in(). + + For convenience, inflateBack() can be provided input on the first call by + setting strm->next_in and strm->avail_in. If that input is exhausted, then + in() will be called. Therefore strm->next_in must be initialized before + calling inflateBack(). If strm->next_in is Z_NULL, then in() will be called + immediately for input. If strm->next_in is not Z_NULL, then strm->avail_in + must also be initialized, and then if strm->avail_in is not zero, input will + initially be taken from strm->next_in[0 .. strm->avail_in - 1]. + + The in_desc and out_desc parameters of inflateBack() is passed as the + first parameter of in() and out() respectively when they are called. These + descriptors can be optionally used to pass any information that the caller- + supplied in() and out() functions need to do their job. + + On return, inflateBack() will set strm->next_in and strm->avail_in to + pass back any unused input that was provided by the last in() call. The + return values of inflateBack() can be Z_STREAM_END on success, Z_BUF_ERROR + if in() or out() returned an error, Z_DATA_ERROR if there was a format error + in the deflate stream (in which case strm->msg is set to indicate the nature + of the error), or Z_STREAM_ERROR if the stream was not properly initialized. + In the case of Z_BUF_ERROR, an input or output error can be distinguished + using strm->next_in which will be Z_NULL only if in() returned an error. If + strm->next_in is not Z_NULL, then the Z_BUF_ERROR was due to out() returning + non-zero. (in() will always be called before out(), so strm->next_in is + assured to be defined if out() returns non-zero.) Note that inflateBack() + cannot return Z_OK. +*/ + +ZEXTERN int ZEXPORT inflateBackEnd OF((z_streamp strm)); +/* + All memory allocated by inflateBackInit() is freed. + + inflateBackEnd() returns Z_OK on success, or Z_STREAM_ERROR if the stream + state was inconsistent. +*/ + +ZEXTERN uLong ZEXPORT zlibCompileFlags OF((void)); +/* Return flags indicating compile-time options. + + Type sizes, two bits each, 00 = 16 bits, 01 = 32, 10 = 64, 11 = other: + 1.0: size of uInt + 3.2: size of uLong + 5.4: size of voidpf (pointer) + 7.6: size of z_off_t + + Compiler, assembler, and debug options: + 8: ZLIB_DEBUG + 9: ASMV or ASMINF -- use ASM code + 10: ZLIB_WINAPI -- exported functions use the WINAPI calling convention + 11: 0 (reserved) + + One-time table building (smaller code, but not thread-safe if true): + 12: BUILDFIXED -- build static block decoding tables when needed + 13: DYNAMIC_CRC_TABLE -- build CRC calculation tables when needed + 14,15: 0 (reserved) + + Library content (indicates missing functionality): + 16: NO_GZCOMPRESS -- gz* functions cannot compress (to avoid linking + deflate code when not needed) + 17: NO_GZIP -- deflate can't write gzip streams, and inflate can't detect + and decode gzip streams (to avoid linking crc code) + 18-19: 0 (reserved) + + Operation variations (changes in library functionality): + 20: PKZIP_BUG_WORKAROUND -- slightly more permissive inflate + 21: FASTEST -- deflate algorithm with only one, lowest compression level + 22,23: 0 (reserved) + + The sprintf variant used by gzprintf (zero is best): + 24: 0 = vs*, 1 = s* -- 1 means limited to 20 arguments after the format + 25: 0 = *nprintf, 1 = *printf -- 1 means gzprintf() not secure! + 26: 0 = returns value, 1 = void -- 1 means inferred string length returned + + Remainder: + 27-31: 0 (reserved) + */ + +#ifndef Z_SOLO + + /* utility functions */ + +/* + The following utility functions are implemented on top of the basic + stream-oriented functions. To simplify the interface, some default options + are assumed (compression level and memory usage, standard memory allocation + functions). The source code of these utility functions can be modified if + you need special options. +*/ + +ZEXTERN int ZEXPORT compress OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong sourceLen)); +/* + Compresses the source buffer into the destination buffer. sourceLen is + the byte length of the source buffer. Upon entry, destLen is the total size + of the destination buffer, which must be at least the value returned by + compressBound(sourceLen). Upon exit, destLen is the actual size of the + compressed data. compress() is equivalent to compress2() with a level + parameter of Z_DEFAULT_COMPRESSION. + + compress returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_BUF_ERROR if there was not enough room in the output + buffer. +*/ + +ZEXTERN int ZEXPORT compress2 OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong sourceLen, + int level)); +/* + Compresses the source buffer into the destination buffer. The level + parameter has the same meaning as in deflateInit. sourceLen is the byte + length of the source buffer. Upon entry, destLen is the total size of the + destination buffer, which must be at least the value returned by + compressBound(sourceLen). Upon exit, destLen is the actual size of the + compressed data. + + compress2 returns Z_OK if success, Z_MEM_ERROR if there was not enough + memory, Z_BUF_ERROR if there was not enough room in the output buffer, + Z_STREAM_ERROR if the level parameter is invalid. +*/ + +ZEXTERN uLong ZEXPORT compressBound OF((uLong sourceLen)); +/* + compressBound() returns an upper bound on the compressed size after + compress() or compress2() on sourceLen bytes. It would be used before a + compress() or compress2() call to allocate the destination buffer. +*/ + +ZEXTERN int ZEXPORT uncompress OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong sourceLen)); +/* + Decompresses the source buffer into the destination buffer. sourceLen is + the byte length of the source buffer. Upon entry, destLen is the total size + of the destination buffer, which must be large enough to hold the entire + uncompressed data. (The size of the uncompressed data must have been saved + previously by the compressor and transmitted to the decompressor by some + mechanism outside the scope of this compression library.) Upon exit, destLen + is the actual size of the uncompressed data. + + uncompress returns Z_OK if success, Z_MEM_ERROR if there was not + enough memory, Z_BUF_ERROR if there was not enough room in the output + buffer, or Z_DATA_ERROR if the input data was corrupted or incomplete. In + the case where there is not enough room, uncompress() will fill the output + buffer with the uncompressed data up to that point. +*/ + +ZEXTERN int ZEXPORT uncompress2 OF((Bytef *dest, uLongf *destLen, + const Bytef *source, uLong *sourceLen)); +/* + Same as uncompress, except that sourceLen is a pointer, where the + length of the source is *sourceLen. On return, *sourceLen is the number of + source bytes consumed. +*/ + + /* gzip file access functions */ + +/* + This library supports reading and writing files in gzip (.gz) format with + an interface similar to that of stdio, using the functions that start with + "gz". The gzip format is different from the zlib format. gzip is a gzip + wrapper, documented in RFC 1952, wrapped around a deflate stream. +*/ + +typedef struct gzFile_s *gzFile; /* semi-opaque gzip file descriptor */ + +/* +ZEXTERN gzFile ZEXPORT gzopen OF((const char *path, const char *mode)); + + Opens a gzip (.gz) file for reading or writing. The mode parameter is as + in fopen ("rb" or "wb") but can also include a compression level ("wb9") or + a strategy: 'f' for filtered data as in "wb6f", 'h' for Huffman-only + compression as in "wb1h", 'R' for run-length encoding as in "wb1R", or 'F' + for fixed code compression as in "wb9F". (See the description of + deflateInit2 for more information about the strategy parameter.) 'T' will + request transparent writing or appending with no compression and not using + the gzip format. + + "a" can be used instead of "w" to request that the gzip stream that will + be written be appended to the file. "+" will result in an error, since + reading and writing to the same gzip file is not supported. The addition of + "x" when writing will create the file exclusively, which fails if the file + already exists. On systems that support it, the addition of "e" when + reading or writing will set the flag to close the file on an execve() call. + + These functions, as well as gzip, will read and decode a sequence of gzip + streams in a file. The append function of gzopen() can be used to create + such a file. (Also see gzflush() for another way to do this.) When + appending, gzopen does not test whether the file begins with a gzip stream, + nor does it look for the end of the gzip streams to begin appending. gzopen + will simply append a gzip stream to the existing file. + + gzopen can be used to read a file which is not in gzip format; in this + case gzread will directly read from the file without decompression. When + reading, this will be detected automatically by looking for the magic two- + byte gzip header. + + gzopen returns NULL if the file could not be opened, if there was + insufficient memory to allocate the gzFile state, or if an invalid mode was + specified (an 'r', 'w', or 'a' was not provided, or '+' was provided). + errno can be checked to determine if the reason gzopen failed was that the + file could not be opened. +*/ + +ZEXTERN gzFile ZEXPORT gzdopen OF((int fd, const char *mode)); +/* + gzdopen associates a gzFile with the file descriptor fd. File descriptors + are obtained from calls like open, dup, creat, pipe or fileno (if the file + has been previously opened with fopen). The mode parameter is as in gzopen. + + The next call of gzclose on the returned gzFile will also close the file + descriptor fd, just like fclose(fdopen(fd, mode)) closes the file descriptor + fd. If you want to keep fd open, use fd = dup(fd_keep); gz = gzdopen(fd, + mode);. The duplicated descriptor should be saved to avoid a leak, since + gzdopen does not close fd if it fails. If you are using fileno() to get the + file descriptor from a FILE *, then you will have to use dup() to avoid + double-close()ing the file descriptor. Both gzclose() and fclose() will + close the associated file descriptor, so they need to have different file + descriptors. + + gzdopen returns NULL if there was insufficient memory to allocate the + gzFile state, if an invalid mode was specified (an 'r', 'w', or 'a' was not + provided, or '+' was provided), or if fd is -1. The file descriptor is not + used until the next gz* read, write, seek, or close operation, so gzdopen + will not detect if fd is invalid (unless fd is -1). +*/ + +ZEXTERN int ZEXPORT gzbuffer OF((gzFile file, unsigned size)); +/* + Set the internal buffer size used by this library's functions. The + default buffer size is 8192 bytes. This function must be called after + gzopen() or gzdopen(), and before any other calls that read or write the + file. The buffer memory allocation is always deferred to the first read or + write. Three times that size in buffer space is allocated. A larger buffer + size of, for example, 64K or 128K bytes will noticeably increase the speed + of decompression (reading). + + The new buffer size also affects the maximum length for gzprintf(). + + gzbuffer() returns 0 on success, or -1 on failure, such as being called + too late. +*/ + +ZEXTERN int ZEXPORT gzsetparams OF((gzFile file, int level, int strategy)); +/* + Dynamically update the compression level or strategy. See the description + of deflateInit2 for the meaning of these parameters. Previously provided + data is flushed before the parameter change. + + gzsetparams returns Z_OK if success, Z_STREAM_ERROR if the file was not + opened for writing, Z_ERRNO if there is an error writing the flushed data, + or Z_MEM_ERROR if there is a memory allocation error. +*/ + +ZEXTERN int ZEXPORT gzread OF((gzFile file, voidp buf, unsigned len)); +/* + Reads the given number of uncompressed bytes from the compressed file. If + the input file is not in gzip format, gzread copies the given number of + bytes into the buffer directly from the file. + + After reaching the end of a gzip stream in the input, gzread will continue + to read, looking for another gzip stream. Any number of gzip streams may be + concatenated in the input file, and will all be decompressed by gzread(). + If something other than a gzip stream is encountered after a gzip stream, + that remaining trailing garbage is ignored (and no error is returned). + + gzread can be used to read a gzip file that is being concurrently written. + Upon reaching the end of the input, gzread will return with the available + data. If the error code returned by gzerror is Z_OK or Z_BUF_ERROR, then + gzclearerr can be used to clear the end of file indicator in order to permit + gzread to be tried again. Z_OK indicates that a gzip stream was completed + on the last gzread. Z_BUF_ERROR indicates that the input file ended in the + middle of a gzip stream. Note that gzread does not return -1 in the event + of an incomplete gzip stream. This error is deferred until gzclose(), which + will return Z_BUF_ERROR if the last gzread ended in the middle of a gzip + stream. Alternatively, gzerror can be used before gzclose to detect this + case. + + gzread returns the number of uncompressed bytes actually read, less than + len for end of file, or -1 for error. If len is too large to fit in an int, + then nothing is read, -1 is returned, and the error state is set to + Z_STREAM_ERROR. +*/ + +ZEXTERN z_size_t ZEXPORT gzfread OF((voidp buf, z_size_t size, z_size_t nitems, + gzFile file)); +/* + Read up to nitems items of size size from file to buf, otherwise operating + as gzread() does. This duplicates the interface of stdio's fread(), with + size_t request and return types. If the library defines size_t, then + z_size_t is identical to size_t. If not, then z_size_t is an unsigned + integer type that can contain a pointer. + + gzfread() returns the number of full items read of size size, or zero if + the end of the file was reached and a full item could not be read, or if + there was an error. gzerror() must be consulted if zero is returned in + order to determine if there was an error. If the multiplication of size and + nitems overflows, i.e. the product does not fit in a z_size_t, then nothing + is read, zero is returned, and the error state is set to Z_STREAM_ERROR. + + In the event that the end of file is reached and only a partial item is + available at the end, i.e. the remaining uncompressed data length is not a + multiple of size, then the final partial item is nevetheless read into buf + and the end-of-file flag is set. The length of the partial item read is not + provided, but could be inferred from the result of gztell(). This behavior + is the same as the behavior of fread() implementations in common libraries, + but it prevents the direct use of gzfread() to read a concurrently written + file, reseting and retrying on end-of-file, when size is not 1. +*/ + +ZEXTERN int ZEXPORT gzwrite OF((gzFile file, + voidpc buf, unsigned len)); +/* + Writes the given number of uncompressed bytes into the compressed file. + gzwrite returns the number of uncompressed bytes written or 0 in case of + error. +*/ + +ZEXTERN z_size_t ZEXPORT gzfwrite OF((voidpc buf, z_size_t size, + z_size_t nitems, gzFile file)); +/* + gzfwrite() writes nitems items of size size from buf to file, duplicating + the interface of stdio's fwrite(), with size_t request and return types. If + the library defines size_t, then z_size_t is identical to size_t. If not, + then z_size_t is an unsigned integer type that can contain a pointer. + + gzfwrite() returns the number of full items written of size size, or zero + if there was an error. If the multiplication of size and nitems overflows, + i.e. the product does not fit in a z_size_t, then nothing is written, zero + is returned, and the error state is set to Z_STREAM_ERROR. +*/ + +ZEXTERN int ZEXPORTVA gzprintf Z_ARG((gzFile file, const char *format, ...)); +/* + Converts, formats, and writes the arguments to the compressed file under + control of the format string, as in fprintf. gzprintf returns the number of + uncompressed bytes actually written, or a negative zlib error code in case + of error. The number of uncompressed bytes written is limited to 8191, or + one less than the buffer size given to gzbuffer(). The caller should assure + that this limit is not exceeded. If it is exceeded, then gzprintf() will + return an error (0) with nothing written. In this case, there may also be a + buffer overflow with unpredictable consequences, which is possible only if + zlib was compiled with the insecure functions sprintf() or vsprintf() + because the secure snprintf() or vsnprintf() functions were not available. + This can be determined using zlibCompileFlags(). +*/ + +ZEXTERN int ZEXPORT gzputs OF((gzFile file, const char *s)); +/* + Writes the given null-terminated string to the compressed file, excluding + the terminating null character. + + gzputs returns the number of characters written, or -1 in case of error. +*/ + +ZEXTERN char * ZEXPORT gzgets OF((gzFile file, char *buf, int len)); +/* + Reads bytes from the compressed file until len-1 characters are read, or a + newline character is read and transferred to buf, or an end-of-file + condition is encountered. If any characters are read or if len == 1, the + string is terminated with a null character. If no characters are read due + to an end-of-file or len < 1, then the buffer is left untouched. + + gzgets returns buf which is a null-terminated string, or it returns NULL + for end-of-file or in case of error. If there was an error, the contents at + buf are indeterminate. +*/ + +ZEXTERN int ZEXPORT gzputc OF((gzFile file, int c)); +/* + Writes c, converted to an unsigned char, into the compressed file. gzputc + returns the value that was written, or -1 in case of error. +*/ + +ZEXTERN int ZEXPORT gzgetc OF((gzFile file)); +/* + Reads one byte from the compressed file. gzgetc returns this byte or -1 + in case of end of file or error. This is implemented as a macro for speed. + As such, it does not do all of the checking the other functions do. I.e. + it does not check to see if file is NULL, nor whether the structure file + points to has been clobbered or not. +*/ + +ZEXTERN int ZEXPORT gzungetc OF((int c, gzFile file)); +/* + Push one character back onto the stream to be read as the first character + on the next read. At least one character of push-back is allowed. + gzungetc() returns the character pushed, or -1 on failure. gzungetc() will + fail if c is -1, and may fail if a character has been pushed but not read + yet. If gzungetc is used immediately after gzopen or gzdopen, at least the + output buffer size of pushed characters is allowed. (See gzbuffer above.) + The pushed character will be discarded if the stream is repositioned with + gzseek() or gzrewind(). +*/ + +ZEXTERN int ZEXPORT gzflush OF((gzFile file, int flush)); +/* + Flushes all pending output into the compressed file. The parameter flush + is as in the deflate() function. The return value is the zlib error number + (see function gzerror below). gzflush is only permitted when writing. + + If the flush parameter is Z_FINISH, the remaining data is written and the + gzip stream is completed in the output. If gzwrite() is called again, a new + gzip stream will be started in the output. gzread() is able to read such + concatenated gzip streams. + + gzflush should be called only when strictly necessary because it will + degrade compression if called too often. +*/ + +/* +ZEXTERN z_off_t ZEXPORT gzseek OF((gzFile file, + z_off_t offset, int whence)); + + Sets the starting position for the next gzread or gzwrite on the given + compressed file. The offset represents a number of bytes in the + uncompressed data stream. The whence parameter is defined as in lseek(2); + the value SEEK_END is not supported. + + If the file is opened for reading, this function is emulated but can be + extremely slow. If the file is opened for writing, only forward seeks are + supported; gzseek then compresses a sequence of zeroes up to the new + starting position. + + gzseek returns the resulting offset location as measured in bytes from + the beginning of the uncompressed stream, or -1 in case of error, in + particular if the file is opened for writing and the new starting position + would be before the current position. +*/ + +ZEXTERN int ZEXPORT gzrewind OF((gzFile file)); +/* + Rewinds the given file. This function is supported only for reading. + + gzrewind(file) is equivalent to (int)gzseek(file, 0L, SEEK_SET) +*/ + +/* +ZEXTERN z_off_t ZEXPORT gztell OF((gzFile file)); + + Returns the starting position for the next gzread or gzwrite on the given + compressed file. This position represents a number of bytes in the + uncompressed data stream, and is zero when starting, even if appending or + reading a gzip stream from the middle of a file using gzdopen(). + + gztell(file) is equivalent to gzseek(file, 0L, SEEK_CUR) +*/ + +/* +ZEXTERN z_off_t ZEXPORT gzoffset OF((gzFile file)); + + Returns the current offset in the file being read or written. This offset + includes the count of bytes that precede the gzip stream, for example when + appending or when using gzdopen() for reading. When reading, the offset + does not include as yet unused buffered input. This information can be used + for a progress indicator. On error, gzoffset() returns -1. +*/ + +ZEXTERN int ZEXPORT gzeof OF((gzFile file)); +/* + Returns true (1) if the end-of-file indicator has been set while reading, + false (0) otherwise. Note that the end-of-file indicator is set only if the + read tried to go past the end of the input, but came up short. Therefore, + just like feof(), gzeof() may return false even if there is no more data to + read, in the event that the last read request was for the exact number of + bytes remaining in the input file. This will happen if the input file size + is an exact multiple of the buffer size. + + If gzeof() returns true, then the read functions will return no more data, + unless the end-of-file indicator is reset by gzclearerr() and the input file + has grown since the previous end of file was detected. +*/ + +ZEXTERN int ZEXPORT gzdirect OF((gzFile file)); +/* + Returns true (1) if file is being copied directly while reading, or false + (0) if file is a gzip stream being decompressed. + + If the input file is empty, gzdirect() will return true, since the input + does not contain a gzip stream. + + If gzdirect() is used immediately after gzopen() or gzdopen() it will + cause buffers to be allocated to allow reading the file to determine if it + is a gzip file. Therefore if gzbuffer() is used, it should be called before + gzdirect(). + + When writing, gzdirect() returns true (1) if transparent writing was + requested ("wT" for the gzopen() mode), or false (0) otherwise. (Note: + gzdirect() is not needed when writing. Transparent writing must be + explicitly requested, so the application already knows the answer. When + linking statically, using gzdirect() will include all of the zlib code for + gzip file reading and decompression, which may not be desired.) +*/ + +ZEXTERN int ZEXPORT gzclose OF((gzFile file)); +/* + Flushes all pending output if necessary, closes the compressed file and + deallocates the (de)compression state. Note that once file is closed, you + cannot call gzerror with file, since its structures have been deallocated. + gzclose must not be called more than once on the same file, just as free + must not be called more than once on the same allocation. + + gzclose will return Z_STREAM_ERROR if file is not valid, Z_ERRNO on a + file operation error, Z_MEM_ERROR if out of memory, Z_BUF_ERROR if the + last read ended in the middle of a gzip stream, or Z_OK on success. +*/ + +ZEXTERN int ZEXPORT gzclose_r OF((gzFile file)); +ZEXTERN int ZEXPORT gzclose_w OF((gzFile file)); +/* + Same as gzclose(), but gzclose_r() is only for use when reading, and + gzclose_w() is only for use when writing or appending. The advantage to + using these instead of gzclose() is that they avoid linking in zlib + compression or decompression code that is not used when only reading or only + writing respectively. If gzclose() is used, then both compression and + decompression code will be included the application when linking to a static + zlib library. +*/ + +ZEXTERN const char * ZEXPORT gzerror OF((gzFile file, int *errnum)); +/* + Returns the error message for the last error which occurred on the given + compressed file. errnum is set to zlib error number. If an error occurred + in the file system and not in the compression library, errnum is set to + Z_ERRNO and the application may consult errno to get the exact error code. + + The application must not modify the returned string. Future calls to + this function may invalidate the previously returned string. If file is + closed, then the string previously returned by gzerror will no longer be + available. + + gzerror() should be used to distinguish errors from end-of-file for those + functions above that do not distinguish those cases in their return values. +*/ + +ZEXTERN void ZEXPORT gzclearerr OF((gzFile file)); +/* + Clears the error and end-of-file flags for file. This is analogous to the + clearerr() function in stdio. This is useful for continuing to read a gzip + file that is being written concurrently. +*/ + +#endif /* !Z_SOLO */ + + /* checksum functions */ + +/* + These functions are not related to compression but are exported + anyway because they might be useful in applications using the compression + library. +*/ + +ZEXTERN uLong ZEXPORT adler32 OF((uLong adler, const Bytef *buf, uInt len)); +/* + Update a running Adler-32 checksum with the bytes buf[0..len-1] and + return the updated checksum. If buf is Z_NULL, this function returns the + required initial value for the checksum. + + An Adler-32 checksum is almost as reliable as a CRC-32 but can be computed + much faster. + + Usage example: + + uLong adler = adler32(0L, Z_NULL, 0); + + while (read_buffer(buffer, length) != EOF) { + adler = adler32(adler, buffer, length); + } + if (adler != original_adler) error(); +*/ + +ZEXTERN uLong ZEXPORT adler32_z OF((uLong adler, const Bytef *buf, + z_size_t len)); +/* + Same as adler32(), but with a size_t length. +*/ + +/* +ZEXTERN uLong ZEXPORT adler32_combine OF((uLong adler1, uLong adler2, + z_off_t len2)); + + Combine two Adler-32 checksums into one. For two sequences of bytes, seq1 + and seq2 with lengths len1 and len2, Adler-32 checksums were calculated for + each, adler1 and adler2. adler32_combine() returns the Adler-32 checksum of + seq1 and seq2 concatenated, requiring only adler1, adler2, and len2. Note + that the z_off_t type (like off_t) is a signed integer. If len2 is + negative, the result has no meaning or utility. +*/ + +ZEXTERN uLong ZEXPORT crc32 OF((uLong crc, const Bytef *buf, uInt len)); +/* + Update a running CRC-32 with the bytes buf[0..len-1] and return the + updated CRC-32. If buf is Z_NULL, this function returns the required + initial value for the crc. Pre- and post-conditioning (one's complement) is + performed within this function so it shouldn't be done by the application. + + Usage example: + + uLong crc = crc32(0L, Z_NULL, 0); + + while (read_buffer(buffer, length) != EOF) { + crc = crc32(crc, buffer, length); + } + if (crc != original_crc) error(); +*/ + +ZEXTERN uLong ZEXPORT crc32_z OF((uLong adler, const Bytef *buf, + z_size_t len)); +/* + Same as crc32(), but with a size_t length. +*/ + +/* +ZEXTERN uLong ZEXPORT crc32_combine OF((uLong crc1, uLong crc2, z_off_t len2)); + + Combine two CRC-32 check values into one. For two sequences of bytes, + seq1 and seq2 with lengths len1 and len2, CRC-32 check values were + calculated for each, crc1 and crc2. crc32_combine() returns the CRC-32 + check value of seq1 and seq2 concatenated, requiring only crc1, crc2, and + len2. +*/ + + + /* various hacks, don't look :) */ + +/* deflateInit and inflateInit are macros to allow checking the zlib version + * and the compiler's view of z_stream: + */ +ZEXTERN int ZEXPORT deflateInit_ OF((z_streamp strm, int level, + const char *version, int stream_size)); +ZEXTERN int ZEXPORT inflateInit_ OF((z_streamp strm, + const char *version, int stream_size)); +ZEXTERN int ZEXPORT deflateInit2_ OF((z_streamp strm, int level, int method, + int windowBits, int memLevel, + int strategy, const char *version, + int stream_size)); +ZEXTERN int ZEXPORT inflateInit2_ OF((z_streamp strm, int windowBits, + const char *version, int stream_size)); +ZEXTERN int ZEXPORT inflateBackInit_ OF((z_streamp strm, int windowBits, + unsigned char FAR *window, + const char *version, + int stream_size)); +#ifdef Z_PREFIX_SET +# define z_deflateInit(strm, level) \ + deflateInit_((strm), (level), ZLIB_VERSION, (int)sizeof(z_stream)) +# define z_inflateInit(strm) \ + inflateInit_((strm), ZLIB_VERSION, (int)sizeof(z_stream)) +# define z_deflateInit2(strm, level, method, windowBits, memLevel, strategy) \ + deflateInit2_((strm),(level),(method),(windowBits),(memLevel),\ + (strategy), ZLIB_VERSION, (int)sizeof(z_stream)) +# define z_inflateInit2(strm, windowBits) \ + inflateInit2_((strm), (windowBits), ZLIB_VERSION, \ + (int)sizeof(z_stream)) +# define z_inflateBackInit(strm, windowBits, window) \ + inflateBackInit_((strm), (windowBits), (window), \ + ZLIB_VERSION, (int)sizeof(z_stream)) +#else +# define deflateInit(strm, level) \ + deflateInit_((strm), (level), ZLIB_VERSION, (int)sizeof(z_stream)) +# define inflateInit(strm) \ + inflateInit_((strm), ZLIB_VERSION, (int)sizeof(z_stream)) +# define deflateInit2(strm, level, method, windowBits, memLevel, strategy) \ + deflateInit2_((strm),(level),(method),(windowBits),(memLevel),\ + (strategy), ZLIB_VERSION, (int)sizeof(z_stream)) +# define inflateInit2(strm, windowBits) \ + inflateInit2_((strm), (windowBits), ZLIB_VERSION, \ + (int)sizeof(z_stream)) +# define inflateBackInit(strm, windowBits, window) \ + inflateBackInit_((strm), (windowBits), (window), \ + ZLIB_VERSION, (int)sizeof(z_stream)) +#endif + +#ifndef Z_SOLO + +/* gzgetc() macro and its supporting function and exposed data structure. Note + * that the real internal state is much larger than the exposed structure. + * This abbreviated structure exposes just enough for the gzgetc() macro. The + * user should not mess with these exposed elements, since their names or + * behavior could change in the future, perhaps even capriciously. They can + * only be used by the gzgetc() macro. You have been warned. + */ +struct gzFile_s { + unsigned have; + unsigned char *next; + z_off64_t pos; +}; +ZEXTERN int ZEXPORT gzgetc_ OF((gzFile file)); /* backward compatibility */ +#ifdef Z_PREFIX_SET +# undef z_gzgetc +# define z_gzgetc(g) \ + ((g)->have ? ((g)->have--, (g)->pos++, *((g)->next)++) : (gzgetc)(g)) +#else +# define gzgetc(g) \ + ((g)->have ? ((g)->have--, (g)->pos++, *((g)->next)++) : (gzgetc)(g)) +#endif + +/* provide 64-bit offset functions if _LARGEFILE64_SOURCE defined, and/or + * change the regular functions to 64 bits if _FILE_OFFSET_BITS is 64 (if + * both are true, the application gets the *64 functions, and the regular + * functions are changed to 64 bits) -- in case these are set on systems + * without large file support, _LFS64_LARGEFILE must also be true + */ +#ifdef Z_LARGE64 + ZEXTERN gzFile ZEXPORT gzopen64 OF((const char *, const char *)); + ZEXTERN z_off64_t ZEXPORT gzseek64 OF((gzFile, z_off64_t, int)); + ZEXTERN z_off64_t ZEXPORT gztell64 OF((gzFile)); + ZEXTERN z_off64_t ZEXPORT gzoffset64 OF((gzFile)); + ZEXTERN uLong ZEXPORT adler32_combine64 OF((uLong, uLong, z_off64_t)); + ZEXTERN uLong ZEXPORT crc32_combine64 OF((uLong, uLong, z_off64_t)); +#endif + +#if !defined(ZLIB_INTERNAL) && defined(Z_WANT64) +# ifdef Z_PREFIX_SET +# define z_gzopen z_gzopen64 +# define z_gzseek z_gzseek64 +# define z_gztell z_gztell64 +# define z_gzoffset z_gzoffset64 +# define z_adler32_combine z_adler32_combine64 +# define z_crc32_combine z_crc32_combine64 +# else +# define gzopen gzopen64 +# define gzseek gzseek64 +# define gztell gztell64 +# define gzoffset gzoffset64 +# define adler32_combine adler32_combine64 +# define crc32_combine crc32_combine64 +# endif +# ifndef Z_LARGE64 + ZEXTERN gzFile ZEXPORT gzopen64 OF((const char *, const char *)); + ZEXTERN z_off_t ZEXPORT gzseek64 OF((gzFile, z_off_t, int)); + ZEXTERN z_off_t ZEXPORT gztell64 OF((gzFile)); + ZEXTERN z_off_t ZEXPORT gzoffset64 OF((gzFile)); + ZEXTERN uLong ZEXPORT adler32_combine64 OF((uLong, uLong, z_off_t)); + ZEXTERN uLong ZEXPORT crc32_combine64 OF((uLong, uLong, z_off_t)); +# endif +#else + ZEXTERN gzFile ZEXPORT gzopen OF((const char *, const char *)); + ZEXTERN z_off_t ZEXPORT gzseek OF((gzFile, z_off_t, int)); + ZEXTERN z_off_t ZEXPORT gztell OF((gzFile)); + ZEXTERN z_off_t ZEXPORT gzoffset OF((gzFile)); + ZEXTERN uLong ZEXPORT adler32_combine OF((uLong, uLong, z_off_t)); + ZEXTERN uLong ZEXPORT crc32_combine OF((uLong, uLong, z_off_t)); +#endif + +#else /* Z_SOLO */ + + ZEXTERN uLong ZEXPORT adler32_combine OF((uLong, uLong, z_off_t)); + ZEXTERN uLong ZEXPORT crc32_combine OF((uLong, uLong, z_off_t)); + +#endif /* !Z_SOLO */ + +/* undocumented functions */ +ZEXTERN const char * ZEXPORT zError OF((int)); +ZEXTERN int ZEXPORT inflateSyncPoint OF((z_streamp)); +ZEXTERN const z_crc_t FAR * ZEXPORT get_crc_table OF((void)); +ZEXTERN int ZEXPORT inflateUndermine OF((z_streamp, int)); +ZEXTERN int ZEXPORT inflateValidate OF((z_streamp, int)); +ZEXTERN unsigned long ZEXPORT inflateCodesUsed OF ((z_streamp)); +ZEXTERN int ZEXPORT inflateResetKeep OF((z_streamp)); +ZEXTERN int ZEXPORT deflateResetKeep OF((z_streamp)); +#if (defined(_WIN32) || defined(__CYGWIN__)) && !defined(Z_SOLO) +ZEXTERN gzFile ZEXPORT gzopen_w OF((const wchar_t *path, + const char *mode)); +#endif +#if defined(STDC) || defined(Z_HAVE_STDARG_H) +# ifndef Z_SOLO +ZEXTERN int ZEXPORTVA gzvprintf Z_ARG((gzFile file, + const char *format, + va_list va)); +# endif +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* ZLIB_H */ diff --git a/include/zlib/zutil.h b/include/zlib/zutil.h new file mode 100644 index 0000000..b079ea6 --- /dev/null +++ b/include/zlib/zutil.h @@ -0,0 +1,271 @@ +/* zutil.h -- internal interface and configuration of the compression library + * Copyright (C) 1995-2016 Jean-loup Gailly, Mark Adler + * For conditions of distribution and use, see copyright notice in zlib.h + */ + +/* WARNING: this file should *not* be used by applications. It is + part of the implementation of the compression library and is + subject to change. Applications should only use zlib.h. + */ + +/* @(#) $Id$ */ + +#ifndef ZUTIL_H +#define ZUTIL_H + +#ifdef HAVE_HIDDEN +# define ZLIB_INTERNAL __attribute__((visibility ("hidden"))) +#else +# define ZLIB_INTERNAL +#endif + +#include "zlib.h" + +#if defined(STDC) && !defined(Z_SOLO) +# if !(defined(_WIN32_WCE) && defined(_MSC_VER)) +# include +# endif +# include +# include +#endif + +#ifdef Z_SOLO + typedef long ptrdiff_t; /* guess -- will be caught if guess is wrong */ +#endif + +#ifndef local +# define local static +#endif +/* since "static" is used to mean two completely different things in C, we + define "local" for the non-static meaning of "static", for readability + (compile with -Dlocal if your debugger can't find static symbols) */ + +typedef unsigned char uch; +typedef uch FAR uchf; +typedef unsigned short ush; +typedef ush FAR ushf; +typedef unsigned long ulg; + +extern z_const char * const z_errmsg[10]; /* indexed by 2-zlib_error */ +/* (size given to avoid silly warnings with Visual C++) */ + +#define ERR_MSG(err) z_errmsg[Z_NEED_DICT-(err)] + +#define ERR_RETURN(strm,err) \ + return (strm->msg = ERR_MSG(err), (err)) +/* To be used only when the state is known to be valid */ + + /* common constants */ + +#ifndef DEF_WBITS +# define DEF_WBITS MAX_WBITS +#endif +/* default windowBits for decompression. MAX_WBITS is for compression only */ + +#if MAX_MEM_LEVEL >= 8 +# define DEF_MEM_LEVEL 8 +#else +# define DEF_MEM_LEVEL MAX_MEM_LEVEL +#endif +/* default memLevel */ + +#define STORED_BLOCK 0 +#define STATIC_TREES 1 +#define DYN_TREES 2 +/* The three kinds of block type */ + +#define MIN_MATCH 3 +#define MAX_MATCH 258 +/* The minimum and maximum match lengths */ + +#define PRESET_DICT 0x20 /* preset dictionary flag in zlib header */ + + /* target dependencies */ + +#if defined(MSDOS) || (defined(WINDOWS) && !defined(WIN32)) +# define OS_CODE 0x00 +# ifndef Z_SOLO +# if defined(__TURBOC__) || defined(__BORLANDC__) +# if (__STDC__ == 1) && (defined(__LARGE__) || defined(__COMPACT__)) + /* Allow compilation with ANSI keywords only enabled */ + void _Cdecl farfree( void *block ); + void *_Cdecl farmalloc( unsigned long nbytes ); +# else +# include +# endif +# else /* MSC or DJGPP */ +# include +# endif +# endif +#endif + +#ifdef AMIGA +# define OS_CODE 1 +#endif + +#if defined(VAXC) || defined(VMS) +# define OS_CODE 2 +# define F_OPEN(name, mode) \ + fopen((name), (mode), "mbc=60", "ctx=stm", "rfm=fix", "mrs=512") +#endif + +#ifdef __370__ +# if __TARGET_LIB__ < 0x20000000 +# define OS_CODE 4 +# elif __TARGET_LIB__ < 0x40000000 +# define OS_CODE 11 +# else +# define OS_CODE 8 +# endif +#endif + +#if defined(ATARI) || defined(atarist) +# define OS_CODE 5 +#endif + +#ifdef OS2 +# define OS_CODE 6 +# if defined(M_I86) && !defined(Z_SOLO) +# include +# endif +#endif + +#if defined(MACOS) || defined(TARGET_OS_MAC) +# define OS_CODE 7 +# ifndef Z_SOLO +# if defined(__MWERKS__) && __dest_os != __be_os && __dest_os != __win32_os +# include /* for fdopen */ +# else +# ifndef fdopen +# define fdopen(fd,mode) NULL /* No fdopen() */ +# endif +# endif +# endif +#endif + +#ifdef __acorn +# define OS_CODE 13 +#endif + +#if defined(WIN32) && !defined(__CYGWIN__) +# define OS_CODE 10 +#endif + +#ifdef _BEOS_ +# define OS_CODE 16 +#endif + +#ifdef __TOS_OS400__ +# define OS_CODE 18 +#endif + +#ifdef __APPLE__ +# define OS_CODE 19 +#endif + +#if defined(_BEOS_) || defined(RISCOS) +# define fdopen(fd,mode) NULL /* No fdopen() */ +#endif + +#if (defined(_MSC_VER) && (_MSC_VER > 600)) && !defined __INTERIX +# if defined(_WIN32_WCE) +# define fdopen(fd,mode) NULL /* No fdopen() */ +# ifndef _PTRDIFF_T_DEFINED + typedef int ptrdiff_t; +# define _PTRDIFF_T_DEFINED +# endif +# else +# define fdopen(fd,type) _fdopen(fd,type) +# endif +#endif + +#if defined(__BORLANDC__) && !defined(MSDOS) + #pragma warn -8004 + #pragma warn -8008 + #pragma warn -8066 +#endif + +/* provide prototypes for these when building zlib without LFS */ +#if !defined(_WIN32) && \ + (!defined(_LARGEFILE64_SOURCE) || _LFS64_LARGEFILE-0 == 0) + ZEXTERN uLong ZEXPORT adler32_combine64 OF((uLong, uLong, z_off_t)); + ZEXTERN uLong ZEXPORT crc32_combine64 OF((uLong, uLong, z_off_t)); +#endif + + /* common defaults */ + +#ifndef OS_CODE +# define OS_CODE 3 /* assume Unix */ +#endif + +#ifndef F_OPEN +# define F_OPEN(name, mode) fopen((name), (mode)) +#endif + + /* functions */ + +#if defined(pyr) || defined(Z_SOLO) +# define NO_MEMCPY +#endif +#if defined(SMALL_MEDIUM) && !defined(_MSC_VER) && !defined(__SC__) + /* Use our own functions for small and medium model with MSC <= 5.0. + * You may have to use the same strategy for Borland C (untested). + * The __SC__ check is for Symantec. + */ +# define NO_MEMCPY +#endif +#if defined(STDC) && !defined(HAVE_MEMCPY) && !defined(NO_MEMCPY) +# define HAVE_MEMCPY +#endif +#ifdef HAVE_MEMCPY +# ifdef SMALL_MEDIUM /* MSDOS small or medium model */ +# define zmemcpy _fmemcpy +# define zmemcmp _fmemcmp +# define zmemzero(dest, len) _fmemset(dest, 0, len) +# else +# define zmemcpy memcpy +# define zmemcmp memcmp +# define zmemzero(dest, len) memset(dest, 0, len) +# endif +#else + void ZLIB_INTERNAL zmemcpy OF((Bytef* dest, const Bytef* source, uInt len)); + int ZLIB_INTERNAL zmemcmp OF((const Bytef* s1, const Bytef* s2, uInt len)); + void ZLIB_INTERNAL zmemzero OF((Bytef* dest, uInt len)); +#endif + +/* Diagnostic functions */ +#ifdef ZLIB_DEBUG +# include + extern int ZLIB_INTERNAL z_verbose; + extern void ZLIB_INTERNAL z_error OF((char *m)); +# define Assert(cond,msg) {if(!(cond)) z_error(msg);} +# define Trace(x) {if (z_verbose>=0) fprintf x ;} +# define Tracev(x) {if (z_verbose>0) fprintf x ;} +# define Tracevv(x) {if (z_verbose>1) fprintf x ;} +# define Tracec(c,x) {if (z_verbose>0 && (c)) fprintf x ;} +# define Tracecv(c,x) {if (z_verbose>1 && (c)) fprintf x ;} +#else +# define Assert(cond,msg) +# define Trace(x) +# define Tracev(x) +# define Tracevv(x) +# define Tracec(c,x) +# define Tracecv(c,x) +#endif + +#ifndef Z_SOLO + voidpf ZLIB_INTERNAL zcalloc OF((voidpf opaque, unsigned items, + unsigned size)); + void ZLIB_INTERNAL zcfree OF((voidpf opaque, voidpf ptr)); +#endif + +#define ZALLOC(strm, items, size) \ + (*((strm)->zalloc))((strm)->opaque, (items), (size)) +#define ZFREE(strm, addr) (*((strm)->zfree))((strm)->opaque, (voidpf)(addr)) +#define TRY_FREE(s, p) {if (p) ZFREE(s, p);} + +/* Reverse the bytes in a 32-bit value */ +#define ZSWAP32(q) ((((q) >> 24) & 0xff) + (((q) >> 8) & 0xff00) + \ + (((q) & 0xff00) << 8) + (((q) & 0xff) << 24)) + +#endif /* ZUTIL_H */ diff --git a/libs/libcrypto64.a b/libs/libcrypto64.a new file mode 100644 index 0000000000000000000000000000000000000000..a997e64771e1721f54cde7f94c6f89c65ceb55db GIT binary patch literal 4323838 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�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%0A2Qtxj_eKJ{CUM}|9bjb3%AE{Wp6%zYS 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

    @2U3Z$uR0n%Fg07z?X2%d{tYsUgo9`p$ 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

    5njvyW&phKAjhD>4C98sFmwlC9)Q0v{=%3C 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�U^ZA`bNHly1M)p4Nh`<3sTscRpcI=iVh`22W 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�`E7~}d8ZH1 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

    B5# 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¥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%0AuTG0U#J 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�^C2Ur=|nmA??+GXY~5gnVkKd6{;=D6o{&4`mj%NeJ8s;_069inxhi<6j=9EU zS9-3u9O|mXlct>FTa{QUe~wE=>JAd@Ir-<~klBD*cP82vJJ`&EISNePMsER`5AqWB50+=R`a9^IGoTpDUAJVMN;@fgXB(g%MSI zdZt;=k&(-Fo7wktDoX_Do_${9 zUgCuP+Sb@ny>$1-!Ihw#d?qAc_y9D~GD@VI=LO}dnK1tIfUzo*a8QLK#GP-{?6v3T zsm9y3Rs<(`$393zmVT9dFH6Ol$=Xc9D$n);Dw&nPd7TGhI51zDonvY2yaAI<)vq*Ka{>KU7y*#gQJAvuX#K7z)QXz=1BD03HX4|nX?Kczvjnqc3e3S@X?jr_S9DMs^pMlL~#gI*M+MMcB4}eYesj44iSy7B7MJaNWOTQFje3eQ%Zn?u)f|NVa zaakG_o8qV{$34SgDM!^fE=#Vut#uSjvBqkq!)7^Zw&ON9Y@VYQI4+1-64zj}%Y!AI z(vx_D5iJ}_N0g!NocX7kI!Y|XmBi&Cx536d@sPV=O9hapVPiTy8IZAt05Z`6Cx1AnJEk!e`}GA$*7sy z{+1#ee#1)+4SHg1oHb9gCtc!lBf~tzX9;t&L1HnhpZP`z*%U&4>=63%YuJ2!bwk<- z#t~B}eVvRw_9(nAN6Xx(9*5&&E+)Di3!88XTO)R033W}_&D~>2ols zlXR1ZoDu4>W$q$uxg-5+?QIHN6lyS|2i>Irfr_=*6Xg&qKj|5nnV7AE{VFkN;$O zVMN?oBYJVH=kL%D!MTX)#j*an8*&`)pwX5FdV58C)g;0DeaOG)UfgJt2Kq;nVs9^^ z7gq~8tH(qZdA&GaD@}TBKD+FCKB=c;`|>fFModwCvX3ETrfyE$VopTHX6L@Sb-GKs zwrU4b`=(m3?F44cpvBluhrStSo3qbimJl)D6r-}h6eIQ;JIAsbvU73JyZgDBifX6! zWFLaeG_=lrGIu$jozzz>+dh5MdAvqv7vn>dlzaF#7;Yt*uX5RWH@-PBwzFLZnL}`~ z2qbY$!^L`(wK~VS$k%TqHhponX;Jc`8Y)@Ld>=4j-sl!2=X>yP5SMl?OLIK-5!`hh zV=E}O9OAOu^1FoklEc0ZO50%kA8X6&$Dp+J^du;j@_6jmxF?1BBko5CHGungp+4)V z66C>=f-zUvX6HZGQWcH@AzW>jQBK=s%s*Wds2J@^F%8OP3Ke7MN+lhawToglwBa%a zuWrGVKmA}WAXC3JQcg{!c`_Y?jR3zFGW1_$ME+ddlL3VN-#UY6<-k@F4RdO+w#>~U zq5tXO0lgP88m?I8>=?C*hFdO7L9m+f*OcT$r7PTWVZH}VxaGpISYkZmuN}4J!ZH{( zUo_C3S}tERGR!f}!!6Du+j99u2q}b+zl0Dk2dqB_GlRugq&$S28A3R-E9h!g2wC6| zrs5jdOdCPh{{$9p*;$DT=bSXTaZYo6U5x+VC0EMcd@ajNT_b}pF*Z*Ocka~~mkA81 zXu*b{8&R=Mvxp$%Cokg#!Ki6VBkaJBm?lEKM!_`lUb9}^==wdyJJtN5mK~dbeqDBy z651a}%}KUrvUBDxYBFl+y|rhioO;TXq!_N@VHu3Yt{XM@UU`*h%(Ff7Cl+a#Q*b3C z+B3o|x~14onY(P6A7%|xY+57QGtCfcw?8c7AgVpn1>T<^SH|iRhBc?iMYLzyO&UZ{ z8+N`HXO5Ol(vub6q%DU`RS_ngP,`%nBv|Zh5!zkVTZG?*ki?pGn3ewh;r*+nr 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

    g>aAy%jX|FGaSk?2!8VmlOXpa-i3bO30Q6u!n)Y zn-^d@`*a{3c$v&#f6*!)hfaAX4jVoAKwJ3oy!Rvqo>Djg@TY)PLsv{(%X^UDSt-fD z^xr!r7MF=HiGoh@=7i*O%-c#2a-k5U=l#$`;1e&Z%D#ZB3oe&0w~PxK_4h!A(nCwp z8RY`JR|0gieVOt6qC`Jm5l!QMXkgV7zs$HSNuvKR^yY`LQNnm!G+YxZnDR9oAi9=s z6n1@Vh9i7^SP(yhz-sm2Ja~SLOt|lSV?bGky@r&n+P)cjN zvlb#saP%yMJ8x)t{#s6^3l%SBm_s6GsWWf%WMIF(YyZ1HHJ>Ze+=t7;b*p3gb*#OS z&%_3=ti+o&>v(xXk-u*Dp!4$BR`<7@wz}6l$C>MNEFNQ>4%b$QJbBHiMBF-YdoSTXDd-sFE+MD{=nz2{8CPc< zZ4VwQ($4_#_L1*>35cbFS*AdT3!*jdBLvar_K|}2LP-@1nhT`dMaH!mVyl{_ z#mDb~juA9*qAxwb(EALv0jb`##V+c-o|YGY(mCKBfVw-l0G(c^?$gG7+qmx;x81mRp+0GBNg$1lZEnh?3{?VYE^C3b z46;DlHg~9%ZXeK5lIBlCsx5MG$~=E<0ooHTot?R_ps6M;G{h@HrL39igLO|)(xgSk z@yx4~rK5g%{U|rfP?<@2MX5ApsKTV(Q zjYxy#`*w6|cg{U<9B)1epP{<>U&&dY@Orr5E`H=#;4sN*zgcw4%cO1 z6(I%RGC2l!Ys*F0)O_?~Ut-`0W0z%FMZhOZu;_7DYkk}No+XRXDiYA0J&R!;8qEwD zoGIg@cH<={5##G-V%;BVOv1HpARHE9xUEA<+oe2W-JOck#?aZ-{(9ROX3r^`nUpPP zV|Wg4+y*N3uKgRJ);=2>qza(aR{`S8C z@I`6+C_s{6D?kYWN@r4v;F0EGg#R{%e*icQaDoQdi`Ozgz+qqsa23I5*d7-AA4C5$ znZEZieRKO>%+H*`M4rXeooxXZXuwYu?Us9op{-DPA>ChELv=d}yQx6MFWC_WP)oe#KBK zuiUJuB~}(wtMA$ZFLM;a_#%|b*Ray~CyF6)^ig{70@%~i3IxTw$5eb0Z1vEwKfwXR zLn_d+ROm*kUO$Dog4VhlsLIUAOJ zvwHB1>F|Mc$e<{OIJDm=4$fER5-#w0&OD5&s%HDx<8E-u_R{9zDvVchiGcv7*u;;r zh(}yG0zcmMQd_rAkZ)u+4oQYthU-Uen@jcJViefVag|nJSoY9O0{Y*Q&ccGnHkui8A$a10>GUlIgLMn8_D8X2-2HaIRft(6r1Qj zQ`#=uQsd3)91!lFpAU~zK2^_J^BH_$z8 z9$JZ$kj_RJ<(x7gmsJ5GkfLFsVrcx>z7rq23k@*1%BQ+EoyyYZOP{ZHt=eKmG1{7h zy2{(NjX|x(J$y8c+W;asHep8LS@AoQ!VT~uAQ9dUy2O5jLQYN5W&a=xsL!` zkaGm!g5(kl7+9U?=fjs{PW$<)-?wveqW`ZbzTgrqK#FT{VJG@GgGW}q$oWcqY@(Fn z=sFy5+d`A^ejE}MoDJkZI2(!n&#GRkYUq57l?*P4YiEu2LWElD&qIJTbdv)+_DwD= zImXR(z1$^6PeLe2b1%{?XK1bz>7-R~Z~rp{!vwzv;1f+Wj^vm|_pG9ZJiVwP&$Fih z3hC!(03HD*IPBd1z_54t(cN=HE4)-yoHT`8y1u(5S>AS82YSd_mYkIIrhu%H+njxLFv!A05X*6s`f@xxqz$#-o{$;zb|fXEQLO%kH` zLXCiRE~lRioM>(gJt|)y%cCG^-G0h6%@%+TbM%tM{vs*A?G}ou;YFg59MbqgB9kVPY zgYK^h*9kY=A7uNWbGw6gtpm6;WV_zEdEs-r#ktv{!tJZhJz1UJ51pI0ZEk$E;C5L@ z2U8_04Ef9Cs3iJd=OXsg*W}zT7;lMlclTfla(8z#1~i~M97`cBX=0~*4?3egbbL2; zwb!@lLP43XtJ<(!N*C7vqK2&T)6-txlWD<4eKkrnysgfO|NA-dKjhr*;634hUmmmz z!_6;`zc_bf-EPR4KiS!~e{N3O{y1&+4EIU?VcUwGuTE2OOyQWp&i2Y)9ACmNpNS|m zt|`biOWrYmf|D`>_>H#JPeB-LBg>aIc}0i9tu6HLF)2s*z?6gq)Oj! zdbOt44#XDLe6Po(*BSZZp68&mXd zLq`~TkD)R{)rKxK#CJUnrQHyF5S072AwKSuW5=f=jyzMu*)fWKYiPTn=L~T*ZPhyp zNP9wPQC0gtQYJkcNXw7+1NG4jq(0c!lSGN+dt9GWr8k-MYsRtX;t<04f$V6*nlA zzQa(Fp&3A$-zwwI0n$*|hoN4IB`v=%18E%J1=8@=8}|^9hW8wh z*2#aGbP{e5>f-<)?XNf*NW+_D(z(Vh0MeW{18KQjVdz_?cb_5J@XPU0WR2S1bmw==P);6KpeGp`rIK&OLDM5hnTRs* z9U-dI5@W83F)JdB4D^hRDE@3jhjDx}#(Y13We5kw&b~ zjF)ijWAeZL+=_^_2;+5ejm_H3;v&YW{XnJUt2Sg9ebG<&8~f*m1UD@y~C33+}< zvx5=8GP*UC3LA&2T&PPfG+4HEW__)8Pl-7h&)nK^7PwtUm5kQbv9sdM@4rI7S=4Hb zOGsdtMi)C~#~F+W;giyRo%`h$C~}cx>0h%oO`VRA8g5PHJRQNy@x8SaXn){qEs|_! z2I=(|ZDf*WGo+>+XRonH}qaTaO;6)8*ob_rPt% zWj_No^ZF^GAXd2Fk{-CFVq8fh!GAyYspx?VZ)5eW-2{bU=$*Q^Y95J$=!IrbP?E$x z!{vc)ZX7i{mK7U+B(Q3!9*l$(va=zyf>(|^Z(X=Ypc+lF#q$Op&CE{YZ*tY(gmiWS zEz#^zHFO$Ub@N~|MR0Ld7R~ezO8YE`zWXtxci(leT0+|(!6-a-KU|gcu)Yp>+{~TT zkSy%sgjQ!+m$?`%^4XWRF{OxLK9|)wRa|J;PSZpTEaH^iy#!}e+3X(aK`fRsx*ur>QIe#_b}eMT*+tO^w0t{Xpj0{Xsl%~aa3o29t1bb;E(@%7V-<(b1H|f-yoOZWI%<7pOOf^v_5p z2IipIv-HXBw*==W-FHvXF!JDKnu4IwP0M9(de}&cJW?Ji+C=}w5R~`*>(xa6hkycq zr^8bUOa+H4`zseE2F?dHT8ux`jPf;05ZcHx*+xM!@j`nTzdrtKNowG49RL3ra?5Mj1F_bFUFhM{E1(OPT z*5#B0;tLXcUpjkwy62~*Bir4rhB**2G0=g^4*^!v8igH?lf@HfJB)r&YI^8?8LE%z z(kH934`KW})*Y+%?LD9mxeQs>=@}a`RVc-Dwv7fcU={1W^w7ehG6|gqa59HsxcY5S z#*$sg1xleBSMw?mNJMg59(qYQ%Rony%bg<~svLZhVU-ZE62?&*Kh>-borNA^|Ab{= zCW~63t1ZV$hTiXM(nGMFgIm6Dw*twA2@kPe;fK{TO-i>0NeGSN)<{{D8#2H4D?;cF zkU2==-nfTWgewbB#U%)T)OPl-$m|RW1|>dY`%O`+PMSWLb3&(?3{Lq)=49MSr$}08 z24)?e3K(brGaIe|U^5~p09%(%R9XK-Tkm}|bOF;$I6;`Yfz#vXH1h@6pwM2vzMa#0 zZZH?eyUZ!f>@8X9+mScA6!j)Oh)m7tEa({>ytZ)8(!!qKpeFrxmn(FIEjUcw!<)Le zpk$A_$(`tTADOTjx1&kUIs|3+=g7!im&5t`4EN&`OD5FibxKQhmtxic|COf@SVv>) zyGs$=1=vflbK)Vtz6>G`#14W(v0_ z&V`0t33R-0=NqD}2A;8eS#j$GL7xZ5HvW9?8$cYbpYJ^e#M>Cs3^Yd&?Rc;yB;R{4 zkftRCq-kk4jusk}`){E4ijS`Vv3BHpv`lu2pq~P9TyehlFCfjwUZ_2q53U=fC<&zP zmotI14fk{)^-&L``DLrBBCZt1_Jn-z$3Q7T&jFPSIvh3eG(pusn)5|Kn)6QpX_{{Z z(lp-(q-mx_aZNK@H#LrVKpM)0KyxMJr9c|WN+1p8vp^Lhy&b4h5EA9`#^F(#HvqZv zwEd0Optis5FNoKta{O1sYg47ujXTg#(xgSkv7V`4)=c$VVjOFTN?8X~$~-8SGQ`}d zG;Lh9p&FAeG;Wchi%nW*T%(~DleQVxX((gTrN%8Y)N9gy<5n2D-lW6E-C*cOlaAA( zm~(f+iz0k*%k$8dg6n&%jrRtYo#==H>t8a$oDWw?gkc%wtL~4DZ3D9eZ%J? z_=$Nuv(YWw>d32VEQ5n%%`LX{zrn4==yaHFKDOE=1yHOam9qmnk;YB2JBxrRk z(MDaTN+LYlLf!4n&IW|Hte1qIJH68!W5GU zHbErRkjrTurghqd3o93>9g5IY5fKONw2>(io%Icu2mU3N!2CvNEdh&qVb#3KT1{p;V)fx@0=tP#F?VBe>T$e3j;h^5ZOueqCvY@7-d|`QQeJ3^TTwPTQBu;TITsSwQ!%PH-s0n=dlnf{V~1xTpNbB1$rkTuiU0$XOF;G zE&T=lYoTaT4?O~<{N4(-LclcizU{)}qc~LvyB`akC5le8@S{COEKzL8q|<{_w$ZoW z-svBu?IqFwdj{uo4ci9(lvu&{(f3|nn7Kq6OFFgfhz&}vv3<_EYmQ-Stu`=8`{aul zj=t?`v}(X`Guo8?3VX#8>6~@Te(pCS`2o2WocCT{+;cOHn4!_* z(1HdVSR7w49gCm)O{!=j9B4v3Azk$hy^^Tj4I_!WMn+G9vb0^5uVG{8+9mk27SSYf z8g3C)i?MsaOY^W`v^x38&Y4rOREs!0curwu_MyS5g6eF4(PjkB(cAd+^7>AimKgXj zUKTJtrhv9lYB1b?@1VsL1ONRd=Q$YnKM$I0Ue{)B-_*Qha~lfOZ)K{25s9iflY8z1 zD5#oqdO^?k$_Fb8%VFBO=Nq!%eLez`;*^$kG_~G}_u7i=*1oOzrDXxhwwxYky)OjYE3yjHDD4T2e(H;jU!E0Bvsj4B8B<6Dv0{KV)5_J7zFc zV{#9!gNmY5qMvOh!OE9O8Gjn_~R{}tA*TwRo^9t<0**-TT_sVdmW z;H81ESkwb&z$Z$uyziN0V&LN-{i_Jap&D(=#s#(ZP7&!GS1lt^kqa6JcTEgnwE%KLDF0 zu07_lZ(J_Fl!iKTdu(vdMjOy1UEcRlAuj0YTJL0r#`aI> z;d-&7>;gr#MH4-y7a`@Sf!YaD&9?CL&;_`}F*W4AdD$JVNKrD0kG&7UGm~s=u+r&? zWDpUFkJ9Hy-z9ehZ}5x)R&dNEL$VV69Bd(%>?3HpuO7VGF4-yWeuc{H=bP8-SD?nW zcP)w6xL)`0uh%o|dOgFxUN1#Jk~IH%<$z9HuUfZp)s8O00u0T=$ie9MfvkLy;}r7f zmEvyirvlg2MhOg+X8AR15t5z2YShQFG`fLPyuCgG%hCfQEWH(bApx0leA_0s z*4QPe+fY^iz!SLUG6c8w1NgHWXcbS=5T4ZTo-=wd6t(_Idg_A}hAIh9_|eQ8Y11H$!#36*my3wypf z4;}Jn%FD&P>~Xjcv8x6~*<~^$dTg+C2CSYlCAp%0vep5NsA-8EbN?!e3aSR%iqf36 zhI>NKk$x59K!t%Zq@fSjDAw#q;Woe=!+jGM!6L>iLZmss}sq?!XH* zJ$UAHOna4+iW1K5#Epz6td;lLdPE2H!k+nkf56a!)8Nz>9dz#c5$P<-Du`EN;j*m9~4NaL}EkisU3ORP(65!pC??DFv~Bt=kO%m>GG8L zSSvh^a_J5CzAQH^s|HN}K#(5sHTrwpINkZDyd#k78%Df5z9T*=f|Ka(-xg1H14H^) z5R$}%j}K?te`t*R_oWCl)+5Mo(*_SS&03qUO3G{?c0<`F_U#`H*}Lbwo8OLMD{G%I zY~}A_j!qp?&W*=&3bX~k4#&|wwV!SWjvk(vd|7#;y_Ae6yd4O~bnN-kJE{G($H1+< zZtQn@mq?rOPu+Zv#r|$V|83m8K-zQm6Cmwf`Ylird%pKi{2wA{3Ua92dx7}rnlGc9 z4;A!1a2f|&lr;|aX&xrh-vS*XXzvMr59;MWhYR;1AocNIKt~Ao86XYsyFf<@_amTU zL7b<~ciepMS3ugAx;MUI)W^YwxHgc6ywniK#Iuz0z0U#75X3c?)Gz0os1LS>9xKvk zfi%DQ_>?$QxWj>zJJq;qAU@LbJ$^#HN6>1TK)&QxGhm8BZaW5J7E?kGIcO;PdO&j+WAT7zefwVO4 z1JaUw6i7>Q7Or5;`2~jl2T1+i4y1m+1*CrO2XeK2ihma70%;1~52UGD45az}6p+U8 zW1u6YgnkQDEa)#l+E4rf&{4v@1Gj7Skpj{>R0DLfNSlGQ4t)qnLlmyyWI9?mdv5XbXFe!l4zdUc89$tOg zP|a-&g|&?OByl_==p)eI;*k~WMsz#l-Ew=iIFY0v0nBEw}@khG(>50!78HwpU5n;x*^7f~Q4&!(w z#&9(t-Tc@Oj4|=P<5W!Nycp9QW8!_sD`GmIk1^6zDoONHNV_W0G;=Ifl-Yw9jcmTJ zWQ3t{ictTlgU6xQsx#AdoOBOK2aWW!NN=LE$JXjPKeeCp3VFlTE+x~sMdt2y=}ltinD$^TzDjyWT^Exqb{+25!*rIAGnfV= z%XoM9=n~n1u{m9YS-Zx@=q($g({I7Tv(K#z78(e;7^PD(a7vG(1R3~fW#?E9$1dN_ zp03UgSZNTE7GbUQALrhdn0?LUFo@=NY()DTHIAvq^l2-5}rewisUT%M+GoH!T!+Np6>d~TxkS_C*HX< zK&+T*<WS=mrtSl*8VBPQD zee_L&Z=B)hBrnrCJis`&=vKT_apPNX@~v1wAT%zC@$eh$dc2c|H}(*QpNW+9^A8Wl z5%*X;1WwTlJ%g#T759~X=uJUhxxEd0%Bvf*$Fb4nRTM?9CMC^Wp|RR(As#E^vR{!F z?y<7u;1sOA%9UWZ(Pz40|8(Bl)3Ts4EX-pHLMk-&eUvK0K~KtSx&0N0`%Xej56tOr zK#LYu4b^7ma#3xRlvI(z7tMAKrg3-GE*KwdIey zmWy=XhcFWS^xO#eD(gpZ2f7zAJlv0A`OQecm|+eeutFU-pXk35Z7I2-@&nw3npn9I z3JAF{2w5lEj1zj|7U|MV!dG~1m!2O?ZoxqO%Iqe1E|!e?rWYkTS^fHL(z&XQW+W1y zyx-1QaDLuEc(=T<@TMbuX5q||od|`>^XdAz%P@^2oqZUV2df%(WUfvR9>C72!!g)i ztx394&Lq=$SczdvI(rG5f@KobI+00-%etON(sM5HGB~?hE^K{z1m%Yl$Jc)~Ctv#H z+GaSy?V&a!D;!wnZa;eK!TySi-jBL@IH%ySgiGkmkWo%J-&@TlPrrGUE3^kD7a=}StRc?Rs~-ltZjoz?4gD2p)4<$7E;Qk{ z#-mrzpVlBpUWR$$l_}}=_wXEtu+DgxmhcznmrSgi(3w|*aM&_;TD%nx!SmKBTOs~g zwESLy7wf~R~3n9<->)CitcW1jJC;r{>JErb# z#=mmRK>mG_b$xfXuHDpst+01De)c}RnOpB}2KGi<^N&M(hhfk6K8=6gdGbBp^%Z>$ zNZSF~cES5kzV|be{s!nM;a)P1bLZ6WR3P=swuqxe??{uL0Hl6vjAKug`eh%K`sJAO zW5h4}fmHelAoY8{aSs_{d%yZ+d%ybS*S`AYSH7Y{fK+cL5Ffkw9>;yFw9OFh)u|r8 z+O;iy6A()--+KnANYG0_Y=_GCIIl@VNdmn`xKbe1qa7;syUg^mhByXFWBVFViTGu| zfQGlh(8Gpk4^CV3xdyHJ{TGnth*qk!h4w%oZAYbTDn38*y>sxdsj3Ik)PE4@2$AB? z+XuVO?om_#H=k8%T}L_I+Z0ivQl?iqKEV_vP0BcxW1UjO^r~OxTDe(<%1nB)aVbL; zCQTbxZK%ei3yoW3h)+q4x6ZgmLoFt4Gp^H6#-vM)TV|-&qzr{GN_pOD{4;NP@{+}` zJ=i@$Jyov6P^Y1#hI$RrCX4#u{mO+0#GaEpSw%y+7Su_W9O4CXdd9IW$ms#G{Tq75 z#oL^NcLJ!|#!nV*Y%3nCMVGQ9_CoBUgQH#*JTC#mxoUM0Wp-U#uHFdK4j0QH z(76^2-;x66qagTP4H(|*_{J14w}Gic-jxY|r6X|Ui|QjDB0yo2h3rVVNp`lxcTidU|lmrn;zWg-$9yJT`2@_*au8{H&Wt*!KvJw@Z z455~hC{#00W--dQ5GBfE+fy=KUH=8eTFt4iv?_7cUx`g zoD=7qkmSa;+C$}XIsG`#+azd=w%UDR9{{)C3-WcBXiJST zJEQ-rN{RfJQ{W0FLW{0eYUKwAG zvGF#?*&*+l#rM)+;~T(Z&^s+xZ#Lgsf{l95K(9JiZ%*_HOugrzcYdy3>C9O{X!_=n zkKqw@F})M`LTnqun+ClP#PrJe3T+$pilCRt)tgxwi+2|EmdEsF@ukc*hF1Z-6*0Yd zybGcC@m#&*OCtr%@EW0aQ%rAGiA4%Py$tle9Md~7rq>U>)wz1JN@999KyPhK@Az0b z-wM6;F}>L_y*r`zNK9`|Om98(w&d!aFjHD5{X8?jk3sLZF})Ka6_9$*K=0X@-kex| zpM&1>xq7pYkJXoa-ZOA-;bzyz>=R@4Wg7IR#PsIy<=i%=uLye6a`jG(*ZWz}J1C}i zLM(k1&?}DVVS&)l#&{P(Z)UDuSxKxuH$v~^96gx-DXWG7Etq@zX*JCTp}CpCSF!(K zZ=!AdV}rT$=KLG_ix3t<=K$lBgasgJb5X%5S#t3OYe2IFo*w)ZELzt*jQIbP;Y~yI zZ)W=bo$zAkhhOEpbADb!e^=#6uWx4l|DEt+`R5H}ck=%l`n$?My}p_G|98TR<^R3A zng7?&-&OwU_07!xZinah0cU?17{jUPzwh-alt3>DFTN6I-S6r!j7zHWQ3h7t@NA6AcjL1o)Y8f|EnL*Cf~~YXRLfb9H|PgegAn4{asyu^!jFAf4d#tf8hFyl`o%F z!KL=v<@*}?yDDFLeKX7V-wN+_J)dum6v~@_|M~aBkDb5Qc;4);{;tm7Za+_6`(}st{Wm#%|4w+jTiP;N0UKUrYau z$iw3V!9^IQ|qnPP?}i$I?A9GY&X~ zV;lBqz@0eWgq`ENR^j+(>_xzwIe03@_|Kp|j-SImi#j+yggphk8ON8g(~6RZxt{Z} z^IUQE=*`#{Q6I;DVXvdkRD_3}eflLhUW`2hT!-Tw*p~sX#_<*G{nST$@;TVArw)$a z!hQqr2#(KUzX^B;jtB0e<7|^SwqyS~_)Z)-XX8%lTY>9vydL{D;9(r^!M=m~IPSAA%9;8&UW(mA-Fl;A`4GzgZT}CI z02}D9!JaRc4^{~}4F8`ORDpk$&Iej0+yeZ6K@dkdsdOdK7lr#0{%;lZ6a1_6X&{yU z1Be>=-odDMDm@NJrIkSHmm^wLy4<9+>Z^WvO{nxwrEl=oyp#*`$95(lj58 zI_}~H`il6d1ak43bh$}C3FP86>AgU=X}mx#UX%XWq<;tcg6Po_gNqmFc8wRv#cNVp zwN)vt*}8a5dN0sdHC`YWuSq%fQl)Vs9km?l!soqIIs+R@QGWZ10x5V#lK(`9wnw={ByGaZ1 zB>9p^X9217RG@DQM~e+w28|}=N}Ve02GTOP#iVxteMkI00HpE$#iXy8bU!?iT)aRo zUZ6WQULY5*Nolb`rQJX-UX$Jd^j(b?$i-{YS4_Geo^l%Ru|Qh(rvTk0erd5m%k=#~ z-xH4OX=?hu1H`9tzPAZTlq$ytM#n-mV7Hyxj?;q1+3^Pcf{p z3gqg&N&jrpzXQ2?k7u^}Jr3v|@mmR`>FY4*a+7`%NYnQXAXo2!ejt7~0l9h)bgyu< z3gL1I^h4ne1Jd+Wm~_5L7XWGct~KdOpb_!=B_K`TPfYr>N&f+)={pMV3>xq8K=+B? zG?4nun)DMUy$wkHK4#LVf$kT-zXQ@V=kMc(ybq8{-wvc{exFI_1FaLkO+Xs&$4q*& zNxuuE@jeWs=loYdTBh58?vPMk0@5;lAKqg$Z}WlHYaBo>4wK$&((eLk9KSZ{pMf3_ zzmxEuqki85q#>UQq|)<%)NjV5%YinC-##EMms?GGhe^K!q~-E!ll~cKqsEK(DHku0 zix)_x=K*QFQ1-6GuH)Mk;qvwPY}N7Y${}E<$0xQ*ryGX>NKTqGX_0ZohGv+w#JE|8 z%1nB)aVbL;CQTbxZK%ei3yoW3=wg%B8P{m2#iVV5`m%9eo?mnLm8JEnz__V~3QaoAxao%Y^`(B3#_=mm>u#}0XBbyv zXqHLKj62y-%A^&>r43b^w8prFh8CIhV&m!zHJY@=xHdzbCe0YP)X*}M_8Ql3XoX3y zH*VO_4JN(OxSI^EGU=_x-Dc?PCS7gZorcz!^d93z46QfmCgUD5wArMO8MnpIQzqSN z+%tx@ne;~q1# z#iUOex7E-yCdJK6o~x)-*!b*L#Am!B-g_1CtwquOhVC;oV(5p4crRBUd;?X)H(Et} zYgWX&zaqZrE8??35x+VV@#{puUU51&_2cSHrw|)X^td`FI31kUadpmdIyhzH>a;r@ zoQ`pI2AvKHe_WlfIUN-BxH=Cz9TelZI)8CGDA;jzrm|qLy$$<#<$RRWdHXJO&Tu-@ zcA?YcboSeY&VM-_P8}LAJ-*$kckDvveizR4UFgtGC^t+i8aJ*9tQ6SZiG95E9OiW1 zwF{kjPUpZ~=v?V^-n|Q*VW)G@E_7~pItTAU=K-ga+=b3>oX#P;&|zN}w?nayRX*`q z$?Q2Ap%>fUv{}iaIcRvKB0WE`ID8Pdv00!m2EGE0;hD>PBuvcP1|7b`MYjWZGr-0h z_jt3CY5$cQZ&e!6iH_mLsmz&pLyqB< ztIWq8!|PO;uQ`TSr84Us!)s6(wncK|6{k!dGmVYcmoi0;;nk$fY{&50Q6}veUMb34 z;+Ui{U5?>ZpgJFM%%R5I!eAgytxOD#r00f+4n?=cn6)wH$1&!q7_&XbycA(Dyl0H`Ol9?# z%`dToV$88I=HwW2W{g=BW0u62t6~g$+@tBaCC03dG55xphhog*G3F03=5G<^UvP!y z%RA^>TjgwdjHcoks~icZvyUyIpNjO-&ibzUCEdB+R5-q@a_%^xGQM$z47GA@jjm33 z7S=4xNvxBfRl_tjWtzHT>C)h9cA+6DUr;`F(&-&_Z)~CSxr>ak+U}w-7nJWhYrG1_ z_Re&TFJ;0Yt?60Z*4i*eu{q!4%6)V3|p|f zkO%R+rqV7HEG4Y=LAA96#OWa3@nms65{q42kw_wJG>$Puj3PpZWAHEiaQI;^5_(*K zu*0Nb?l3Uah1d>?jZ?3Jxn$RAH+Paa9n|lDq43nK=_H$p;U*9Q|RDX8ZG*<_$cSR=foA{sUjUO z%s9n-1aApJ8ls%#z&+lqR736{<`_BlLs6a}|MyZuYx*pTpr()UY#dkUeERijY_H=; zo!?Lm%JEKx(0wUK`hPDq?#$UkeT)JcPsXCP*NpM}gBo3cF|0&Ss!u=%QMe(7MWnkUkV zc2PJ~8mHXsX~lOsIF@GUHjE1!#IJZnwq<;7+_NM4G z{0i#izB8H%RAeaz9CP9bRdI$8ax#24-Q(T~ohuqTE@!qO=s{a(=sD*tharqjMROh8 z9Mp%OBT0e(s-X_Q8G^C7TNecmPGR3S7UFo__Sj~XmK~pzEm%9F1}$`K^JM35xc!?< z4fYx6wJve(=IA&@n_*2|xDA|oV{Iv~W+c4U)L1&?dZ`z(&`FN%&&v>RcuS43b_N@R zIWlRnOCLJ4J<$ubtuu@|G+z%xuh;3NMQ`l2Gj_Os7W(6ce55dsu=s9o#~yobBZCzN zGJA745)CO8!;q2(V@Ipd_O8;Qy_0Bp6&xr#EL-;HLJ*WLs;y3Rfgu=&bMVzOtjM zG0D4)Fjy6)yS1a;lv+EIawkbP*SEIybTxSmt(`4RUCGvNsI;|tvc5~Qp`#rhGg#v# z*{PK{iN#{Prlp-t4Y_P`aa+gYut+Xs>Z_y$NkIgej*eto2NsQKZAa+ct=*ZX_DoWR z9+Vl1b0QmE-A%g6r-|slyQQNm<1K0J?q<6CA%~AT^TJ*@Qd4;mUJg^H`6S+vhzBxxI9U_ev)L3l2niY7Os?s2>m?t zv}^G+HTo&*Y47go>_n15X)$|Y%B2%$CqlE}8akGAcC@2_y1hnSzK&HzwkGFhzX!Kw z=VpHax67RS7D9@!#v*-Ol|n=f(&yk$>H} zmpb=G=k9gx-#GVG&iz;CzS_Ab@xsFPA?Hpy_lKQ(rgOJCce!(az_~duk=y0YeX(=5 zIrj&gdx>)|b?#-({c-2UsAkE}mz=x9xxeGwoz8uab6@A&To;ww2c7##=k9WD&fDR( z+_@*=W-->b7`Ob!Zd~8I^`Czh+uQ_qb=P~k;?&~SOj}bslyV4a$O8itkIRCmp@c9N z-`wdncGMyscThzzxDspKg$ae$nTx5=d3jkU?*Rd<)c_=s9gQL(c0Rd=l)~D2ENUf& zGRet;U3n; z0hWF{y|ul*P5cCT7Gx<@SB_VC36=G>m;~`3rObOk2f_N46OTW_LUvZmRv_-_zPnJ} zMZP-5j|lTb;T;=DU-e52SN{MZQ(T z`;sr;tnSsmyHow&>$`i^{UhJKL)}|^x2NGh>$`_l{tw^1O5L1qEL+WFNza~qY2sF= z?tOiCr@9aJ-M#8A_1(kjPWkSXx)=EFRqCd_T-jEuyUTZvsQaV7d$YPZJ59FDn%-5u zyHN9Ym+u}?`3B#;TFZ~)>15lg^5=c`h{`#uO*eIO4Pw~})qS+@PO6)8-(*{@;hpBY zOH_V=?@p=v1HQXP-CVo)^=xl+?k`^pIetJ_;btdfzRY>&2!ecBgF?Aka4QGkF>yNk zMNt9Vd~2QP73027A9-Gxp|qhzhFT0QHMGLejfQSBw8qdTLt6}OGqlrC0bZOnEz=DZ z8!9uDHnhl4iy^MPt)Z+ibfcl$46QM=$78!9uDHpCH;>Z8TbQbQ{Y-Dv1GLu(9eGPK3eHbXlN6`)GE^cgBPRAz|tBUNva zp%z0+4XrSAqoLajtueI8&=y164DB?;tJ0;74g;0G0cxKg+skDZ@Y%7njD8N|fA)9~-#hybyLzfs{4IzmVO!r!NiXH1>Yw<&M! zI&LfyOk@leQ!z15uko;!HdZPlxyY+Q*`>oOg6BF06$IhDFD553-&lV{NMnS-yR+Zp z%LY)|mzTFHzJ=(Lo!#;l09@PL)82s33n$`BN;f{sa=lY4zUHR{>H@6g*IdSvHi=ez zg87XSr6=V%PP$F#)`d?a7GJE#yWODY2Cx+JZ)S*&;M1?y`aujcq=tZd= zh!dK0qpHq@-doZpk<*6Ii+FBw?FW)H{IP8yx9uVY{y?7o&^A`v1?xC%Y%Ju(g$>z4 zcw^g$?~R2wwvG4^=y47wH&%DG5r3k%{XdE~LvKy4-if8YiX1843cdSt^-4?lh_j92 z9nkYf^H{v4$44TTU~tZU5eskj2^JUt#f8w@nxhw4U-84wZh{(?F0IP`GM&A?s1UJo zsl{x6Q4+8kR57WI{YAY{o5LEbvyW6~|MK@QC;n&TK(Bu!v+QoZb_n~z-@ja*_@DdBd!O(s6Zbw^ zIq+y=fa|NI``+s%`X?iVkS*El6Y1=z3qR3+EADTROmf~xHImYc!0*QSLkxdFBo=RC zpq=ZOBIKSstDTwKboSz+MU|zG!tUA@R{cpg}Q$!c4eGSUA$E^yzF-@x+~&|Ox6vTIA@1m6e`iGhz% zW9SBPrBT3(Ui~H7#mp1a|Btr?bifFxX+;wVAXJ1%CKl_Z!6eEwj;7Y0+SZ<;$DZ0#+dplsC!)3C zBH*PK(JEd}rIpr0-h1{0>A&{;&hPua{mW!Od%f#j?|Sd|_myjD zqn(!u^W@=f$nqrPWJSFbtoeIXRvl%PyRw`F(b_7v(MCHDBGZP+GN7|zawXV&F}yyN zom?L6__2h$dr0wW9tvMCsxv*-x9=Pgz4e%5Xz6{Rr zYFCTuqn~d6zadU~enE~@7{1ZShCl7-vXmZ%szBU^LzgtgbcQaj<#(T=r{gREZlrm{JC zI?=P8^nx@^uO@olE@ILxChruQWcyOf)@=keaPuqDL)A;}O|tp(QBZWN<19fRjduR{ zgMk6PW7qQ~eSb0pIrrfTf7N61%10rg>dkzdFNgG@WP#}iA`u7=GxsZ`A#qSw=3Kt{ zAgx!kjL1%|%n$q(JS?Z&7TSS2arzNcP@-}<{(i>Ea-6Fc(Bl13{zJh z$&$QNy7fg#TCLCERUK)?6~B6+ZvF;vd*v^^yAHbL_W>E!nk zP3N1@Tco({+!5_q$Q;*o?t$stH8GLsIa-@tAMN10R4R9EMSK-|=IePKMJoHg6P|jd z_mu4W>Fhh8CbGR^kjyTuh#_)l2G>Xh0vjj^j@1W$PGvfeeH4s4I1#SgFmvUyB&a=2`poip?1nmHg;&KE?oZ zm6SepBFBOAa3TkHU=1n0CSR88yiO zO_?xHjk({zA()tn4Se%#OW$dhk&^vJMD{EBbfoYW=#mjbBO|5_t=yxrthuyqNU!o` zLwxW}}6@buzckNj{Ta3kJdMtwa7_#Yi3qU?X>(*WT|;a4VSic$MAITK6KPw}nj zd7#gU=_!a&`m8LH1X8#=#N00DJqMcjOKt!Ndk=%+FYZ3(P&*p%h2;cYJ(>|s*NL&F{)GwkeW6F zsp+?X#*66#KpZtFi~J5qCBF)EqR{$**zG8j^C4L+l|}YI`&nsw1F`c`7O4QL7Bm4! zrJMnz{^eM#(&~+Nh0!}FfnjrF?G`^>SRI4q<*Kg=UAdRDmNVTVm-4xJi zg185HqM(I98q?PRscYXg^gIw->}8QxfX)!~0T9O*$|CzC55xtX=H!a9$TT3;iX&bL zF})RNlAskp8sa|!nk=-x8DH6Om+x~xNijVhNcrMGHA0&Pq~XUizs?dGYFLMM8<1*n z5760S`Y2FJ&|iUS1s#msdyb%UfmGh*hG3xkMd42u!K&_&l(E=P;j1)KZlJS@?KNBH~k zpXHiIaYwf3^I|(6Y3&GAP(~sK<2lXYVVye|k2~Ya!IHsvu5;v!+y&3K93D27i^&O( z0c<@gM`f!n-vqK!w@`&o3OmBN8EpxitLr zIy{V16tZ|;a43|gl-C^!<4Y-J`tt48Jk+5uE)<^NP#E$GQw}8(i8+)DLzJcfg)_~p z>>&b=YpW%|Llf2``nWvb3Q@ivqWmmC!4M>7!VBf}26$+?IYfCiMEOgIQii%mA6LUq zg(!!GDC0wvM2K>Jh%z@sSrVe$7^29TB%&fU&>7i11*mbjpP_om{DOxk<1^F^fpFZZ*fv43SY%ZdW6 zgX?J#h#sLZZakC1NbyX3u~9%|G>EAzkYK*?uhsBhtJ~b#GG7b_TQuS=Etx#+^K~=M z^Hz$Q^8#e4EM20%gF1&of`p)lN%5u4B9{k?Pb7DTE)Mn)S6%(a zbHCIeD*@@AsLhZP*XGW>ykX(2mW)ma39V`2+*wPUZ|ElAA3Z?=WF-SWIN=o9HTt$f6jsx zyV-b!<5xeQGX^#$v7>iLD*IICd`w|1=deSn>G7)Gwu$@1uHQdD4Bzf3Mti=5)UOOn zP1u-yy!FqirWf1Sl%$&;PnEn|Tk>{x)B4g8iS;G26qh3|Yty;fl0^H~vepbl-|{;+ z9(`obw)aOwJ2nHiy}x&~<1v8TBn+XwixHKfB|K+4GWK`<n5KEgdZoYm|?u!F*eSNy* z*JFRve_-^1(ur_%8kia(4_wb{p7AI~2S zzIom7Ykp4=-$C&ae8XOXvlVS|MS;s(oFxgxx$H#pNhj0_5!b7_6(!u1@9HoQJ`PsBA3pFk=E~67z^jj?KCb?!i2bk=Ino`o!3E zwN1~avO2toA-S_bN!g#OH7$>;-n zK?X-4P0Uwba4xmHBr$VsqW!~?>;K%t2K&71P@h3i-%8Q+`6=0TgN!0yRCE*>*32ej?E|yq0sd8#v~k&Thno#WSNFH?R=M-CwZ+axnUhl*g$;F6xjdL}*1j7J+AA zQ}$7$!R5@&PLh~Y(a0oQn|+(t4ND1@&b183&}lk5r=oI7c00%%`^13qUSbC`uA||` zvUOC+8>n6DpT)@hE}hL_0JdvCsDr?C2e~<$(+OFLp1Jrhqx6==WTX2r}Y*?c6jgmE_q$tq+vA-F>5um%*7qaKnPeZ$ ze^n+i;t`8Y+%%m+8M8rpODvMIzfI+q3{P#CG#nBzJ9C!2qaEylMjt5Y;Pee3i@@jc zMiyO(S3(lHqfd52wDUJ=b`@o`uN~n|uB1xVww-ojwDT?)w_Q^*F53Cc03#|BorOvC zu=5M)D`;M_)}=GnzNc2O@|?2wbd6+2qFv3fDjS(XMTwguqMb6qh{D-KcZ1ib^1W&` zq;hWb4V32T0Kw^8MQKg+fpHay^<@<*1iI2Hl0qt51IO3aEFV`P;!~Y3)#k>PMLX`J z3yxOs$St$*-F96Bp}?ttRQsc-6jbNV-b8lY^;aiz@d1{tZ`Zc>meiDNb0!J;56`~% z^arV?&8d=icC0OlJ}{!SboJIUmQZ_cOiXxr`H<_+h(3`1jO)9rHzj&5gKn#s(k+pn zjyU%x^8Tnd>m?N*$~LD)Nz6=KvX&(V+YMG?Tn=ef1FQJ*l^BmjKa2F$^F_L6Mzs4k z&#nYZ|Mxui5d@(U%mw1H7(K}LG!iJk=@hIGlFN*kR&K%&=R{w@$z`JCVC z4MnXEfHl#x1ZF{B@NN!&sO6s%#$_SKibBR8gR$r=9d9Gf{zlflte@h}B|2+ZUS+~? zr_7vnAc-Ch$+23`jlK~G^Jo&F?K}6%%uD=|V@*{%=*`=pLQS@B6@5`twaro6iz_#^ zB_8B?yQ?BGN_`u(tkvzw>{g_Kdar0rG{}wfHJtf+-L3SK6SlYB1Z8f6I|(lBq;if* zL$O`}vEbE`m|493B+TT=RH$+#Cv1&&P9|4w^tVI?eC?A_674(^riq@bpyq?3W^T0U zh~Ja$FE$w;pokm_){7?Kc0cSC{T?2|}9Z*^HQDr1pT}Q6p*XPJ-aHI9#oze}H zrIHX3qThjJCo=Yoc5cH0hEVK9JAchJ9fQW;|AA?;Yfi<)Wa*rWbhL9VzVqM4zoO}R z*&8wg+I43|4AnkLKg>Q);bi&k6~jT`>aKFU;lnzp#`g@qqaDxTzndoAG|!gn`pjos zG6EKU)_k(9eh=rDsvT9EA#~uksiy6i z7GM6*5cFN9j!N`gNKu8Uc|)}0Ao$B!nu6shYPItvq~E$|hupi?{%{5FuYqOtRJ7v< z5(My+8$hsS)6UUbs^O#rg!p+1a(4Cwn)NYGTHPz0#9vjDUmhB@q%e;zxH z<_0oe0(E`IFPUa1+$T1p9e2Z-^&Jw<@Ibz6-&FhRvfK>=AAR)Edz%m2bYvTzOde6i z4gi~W5acxMSHE8V!?rf0gyfo3?))LCX!7ywn#dY$Z?(Trig-(n&8Nnq)2P$^u1C?V zlNADat`OM%uCo?IbcB+%Sjy7DcE;R`9Oo$7c_UPycwlnVcg{-h$HkT7|?M9bV3?xPJ=R^ zLY(rHWn_hO!8dTbd?C9qj!;hVmC9;Bqo}$y3O_OJ&jqt2cVEIz^el!TN&o)pO5#4h z7t~5S{T76wy8?xaJy7@zbr*Zwm;zt^U$G`itf}<;Q~0K!T@d(#qt zJtBC(l^yv~NsNE)-z5rju`i^=pq^rA}NfHc71}mbqm9mN@b%Cy~ zm3iI1_Tfdo9%%a;^SM}$sK9oxVk)_#}1_+PD4{)hWXI#Artr){)sd zV4ptG@JRFw@GJYGILhYCJFv#)!im{6EG;L$!FCkek7ypY`>ob3a9T>lVy)Bl-j z+Mq2sl&7d5OHl@D*A|A~ZvS(6=bPE}(&tGvp=Hg=*U?*j;4+l5 z(#w}$dN@hAs+-*GNHhE8z3iu{W{0mA(e4;LJ_EFCdzxRq1?3awA5|JN9ZQtpd_PD!%r zYpx%~>3l6hcV0L7nL)Hn+y%dlG!euhDv}=t3AEn^`&L{fV1iYb1&-|pRvBL*|L+mL zMf9^cQ2l<0$_J|mHSKGB7G|11F?EMCjTcq^M&~Y)#A>hpgL}o2awg4T%4o+=eu{P+?ek6kaH`$yj4zmzRArnOzY;Z_ zZ?<+i@nU6^7?`V{XC9OIb{0hk18h8xRA5Zsli zm{FR60a;T`&tc#d4Jhni_&HZ|v!tl0dW>2?UB`ECrkb{3P%hQ<7`BUmYQA7er#d!a z-;I+~y6&&&^_WuGp^h)^ms%g+DVL*bAB<~aQN3Gya&je=eO#2ljD=%QTMZI8sjkTS zvIF7E4w1!b0sbf#M#c9_3xaNFD^4by(phwzcH}psnZ`uLr59Fc%z>)mLgNPx>kP2w zw@VuFe9h*7-`D&$KWU-yvA)ji$qJ)$9~4d&noJYs=Z*LX)WNAPjmP{I&`rnhf?1Sa zJIC{yNXkC}-JOhJg&Y~VA=#g&t?YNSQQJe{)b7~M*S`-&DG#_~$zS%lapjsiX0C7C zw4YCygo2t*HQ6F@ko51mviYQsZ69B-tM)M!Y(rq9JVC&WLAU@Sg!;z)Wzd$g)h8>w zV6>(^YxO~z%ji}5>VJQGdD$DwVGXGijo;zS203=AvTv{v%{DRS$fO`4J(XzRhEeF- zrJwb*&Uu~$DLw#^z$?wsivvy^Tv?*itAAO&XLhu zWIi`1+^IW+e+qile}N6`z@Viy*!kCiO@F^dV<6GCbRZV(d>pX0y{}}-*zFiSjNY;e z-&K#Hu8=e;Ex?c9u~d5x`zMiT$98;q^>HqPVIKq-iraVk4*ipaMCZw1K}?XIigt1p zcAz|P8(y>)C=S#~27j20w%xLIOizL4og){apf*gx?hDR;20pg_Oz!ko;l_hH(Cv?> zPLRF8-Ya^`*Q6;R>88Fqpv>63( zx}p*LN%1Wn%iji7k(Az|id<&wPb{s6!i25%2ls(VAdz)kp!UjXx^KW<^pRflus#c` ztZF6AI98ps((!4vdn}C)^z5p!*sP%u)hV#~iiVI0cC>X9A>R7BZB1j;r;~cTw@@F9nM;fZ=V~`nlK}{e4)$l;(ph8#Qn_ zu8go?Fb<;AKI-I`T#fy~k3|mDwe{cvZQWqpjKUrs5L3UsXvZn2FY}Y3FG^At-0T!h z!M-_^Tqt68(rYMmFjd0>ynic|%q-QG4u-l}kaGNPE8db|Q2dmlz)GfI$f74(8tqsu zW?G&yV`hg-o{e_g3uqqVKU@{)Y!FH_QVkfIF3b0 z*)^?)wp}w2YaNPi-@w>+vYViN3W21~Z5px__C^kijGR5Z za#-Wg<~{1ldWRs1mz3`rDZjgL?-uB?tLvMg-CE-IZM$%r^41iQSE!@N-#0A3tRzx) z1Kjt&XX6`}Fb*4ES~;Y#q?uvdfV|A75$_|AWXgdn@n*Lx2F$%rry(hf1CHbUI)0on zWF`CX9>|-(y?FDS6t?Q)cn?QIU@34p-diBB8+a?;Jt*1lB|qMCKBYI>H{<;@HlJ)H z58hw@4Bo&i@SarxcYvGm{sDe$qOHXHHT+mpZ0Gw(?1%y8`&#^Bz%`3-g-8sGAmy0I zSo8cPICk>XNWlg_u7+%iOsSoG?BsM!Vw#}yrlxTU>Qq_XT9b@SN+ge+@%g%%NFCN} z9yH)lyr%aC!#f~^7 zHof-jsn`^mOw33i^6*$->8CG%mEeW08&FF30?YU9gs3A*UjOK>#-BsVSp3Q&T&St& zS|Bd(EQ{O2M(3!8aP{c;TA}qZ?Doe0#%CS*NhfL?o`@EKviPe05o3Emw|NW;P-(}6dLzI z=$^V?1F7U~K&t(DWs%6q!q*OTilDoIss;TDh}&SwA{?MoyWD@McHalmU41;iLwEJ< zXXrE_wZU0GwZXemS;mw_ZUQ=85N|M5z5{@Cf8Q9R@r<=Ih3|Z$U1GE^8m$#b?RFTg z+xS)(?OvljYP83J)b2}0d(HUXGTQq^GWl0y1O1TS2^ZrJl^F-de zKy`u+j7B2o3t9=J`uzgvIH7F-I$F?XAeFaQxy$z*Lo0yP#^XR58t(yVX*K|)rP)Df zO=xMB0n#$88%W*#0gy_09;iy(eFaGEegLF)V`zt{-HAYIcRG;Ty$eXw_^0;M9hha2 z&j5`VdB+;M5J>G_45VSd&}c1&?gpAJcAo^&Qspf}`=G0;QVs!9DW?D(BR0-9(=^Zw zpodL`KXb%9X_D>k?8KeExXc6>9)Qt)t z)p@MZCK&AuAeA@UXqOq^bw;}Z==0*EZyD__qx}#_<7lm!ZZy;PfVAWq0MdMU5c)?N zrsn`@?ztRDHN62ywLj%hmo^bdHK;S%1x8zFv@4BvAJCYM z4Hg15s9mFN1k$j2(P*z2?QNs&Fxq}GSKeVjYWD=ARU7Rbqn&58CZpW|q-p#%qrD8& z5Mdkh1E5AhLl1LZiy1n@(8Y$nZ0H+??l<&|p|=fv>Tp-`NkFs2wR4Pi5zuU*U1qdS zL*F%Y(GjkcIY1hhEkLUMoo0HMnf}6PtBm%v(VjEfTSj{qNW&S+_no-h7f4+@(r8B; z?PQ}RfYk1EqtzSjP$UeEg|UWGK$^mC8sfGx5D;>cu%0T63>hhnpivq@U;?4(h?0 zX{L=vn`3CcnJzS1v!RTcE;ZVoN4Onf4lOouQ3p`lQh|8G6=Ci=Qf@BROEQ2MtSkN+L0wE@9*VKoKdUUgSaI z!^0AjV_zO+A}AaI^C+xi;-!AdMWApr%;T903dh7e%5|WugdXS`A`SClJgf*%7~