Commit 1fa7ee1238cd50d0e3e2c36496043fb42a227945
1 parent
70139ef9
提交 _GLIBCXX_USE_CXX11_ABI=0 编译的websocketpp
Showing
360 changed files
with
70299 additions
and
0 deletions
Too many changes.
To preserve performance only 100 of 360 files are displayed.
3rdparty/websocketpp-0.8.2/.gitattributes
0 → 100644
| 1 | +# Lineendings | |
| 2 | +*.sln eol=crlf | |
| 3 | +*.vcproj eol=crlf | |
| 4 | +*.vcxproj* eol=crlf | |
| 5 | + | |
| 6 | +# Whitespace rules | |
| 7 | +# strict (no trailing, no tabs) | |
| 8 | +*.cpp whitespace=trailing-space,space-before-tab,tab-in-indent,cr-at-eol | |
| 9 | +*.hpp whitespace=trailing-space,space-before-tab,tab-in-indent,cr-at-eol | |
| 10 | +*.c whitespace=trailing-space,space-before-tab,tab-in-indent,cr-at-eol | |
| 11 | +*.h whitespace=trailing-space,space-before-tab,tab-in-indent,cr-at-eol | |
| 12 | + | |
| 13 | +# normal (no trailing) | |
| 14 | +*.sql whitespace=trailing-space,space-before-tab,cr-at-eol | |
| 15 | +*.txt whitespace=trailing-space,space-before-tab,cr-at-eol | |
| 16 | + | |
| 17 | +# special files which must ignore whitespace | |
| 18 | +*.patch whitespace=-trailing-space | ... | ... |
3rdparty/websocketpp-0.8.2/.gitignore
0 → 100644
| 1 | +# make .git* files visible to git | |
| 2 | +!.gitignore | |
| 3 | +!.gitattributes | |
| 4 | + | |
| 5 | +.DS_Store | |
| 6 | + | |
| 7 | +#vim stuff | |
| 8 | +*~ | |
| 9 | +*.swp | |
| 10 | + | |
| 11 | +*.o | |
| 12 | +*.so | |
| 13 | +*.so.? | |
| 14 | +*.so.?.?.? | |
| 15 | +*.a | |
| 16 | +*.dylib | |
| 17 | +lib/* | |
| 18 | + | |
| 19 | +# CMake | |
| 20 | +*.cmake | |
| 21 | +*.dir | |
| 22 | +CMakeFiles | |
| 23 | +INSTALL.* | |
| 24 | +ZERO_CHECK.* | |
| 25 | +CMakeCache.txt | |
| 26 | +install_manifest.txt | |
| 27 | + | |
| 28 | +# Windows/Visual Studio | |
| 29 | +*.vcproj* | |
| 30 | +*.sln | |
| 31 | +*.suo | |
| 32 | +*.ncb | |
| 33 | +*/Debug/* | |
| 34 | +*/*/Debug/* | |
| 35 | +bin/Debug | |
| 36 | +*/Release/* | |
| 37 | +*/*/Release/* | |
| 38 | +*/RelWithDebInfo/* | |
| 39 | +*/*/RelWithDebInfo/* | |
| 40 | + | |
| 41 | +# explicitly allow this path with /debug/ in it | |
| 42 | +!websocketpp/transport/debug/* | |
| 43 | + | |
| 44 | +objs_shared/ | |
| 45 | +objs_static/ | |
| 46 | + | |
| 47 | +examples/chat_server/chat_server | |
| 48 | +examples/echo_server/echo_server | |
| 49 | +examples/chat_client/chat_client | |
| 50 | +examples/echo_client/echo_client | |
| 51 | +test/basic/tests | |
| 52 | +libwebsocketpp.dylib.0.1.0 | |
| 53 | + | |
| 54 | +websocketpp.xcodeproj/xcuserdata/* | |
| 55 | +websocketpp.xcodeproj/project.xcworkspace/xcuserdata/* | |
| 56 | +policy_based_notes.hpp | |
| 57 | + | |
| 58 | +examples/echo_server_tls/echo_server_tls | |
| 59 | + | |
| 60 | +examples/fuzzing_client/fuzzing_client | |
| 61 | + | |
| 62 | +examples/stress_client/stress_client | |
| 63 | + | |
| 64 | +examples/broadcast_server_tls/broadcast_server | |
| 65 | + | |
| 66 | +test/basic/perf | |
| 67 | + | |
| 68 | +examples/echo_server_tls/echo_server_tls | |
| 69 | + | |
| 70 | +examples/concurrent_server/concurrent_server | |
| 71 | + | |
| 72 | +examples/fuzzing_server_tls/fuzzing_server | |
| 73 | + | |
| 74 | +examples/wsperf/wsperf | |
| 75 | + | |
| 76 | +.sconsign.dblite | |
| 77 | + | |
| 78 | +build/ | |
| 79 | +doxygen/ | |
| 80 | +examples/wsperf/wsperf_client | |
| 81 | + | |
| 82 | +*.out | |
| 83 | + | |
| 84 | +*.log | |
| 85 | +*.opensdf | |
| 86 | +*.sdf | |
| 87 | +*.vcxproj | |
| 88 | +*.vcxproj.filters | |
| 89 | +*.user | |
| 90 | +install | |
| 91 | +Makefile | |
| 92 | +bin | |
| 93 | + | |
| 94 | +Testing/Temporary/CTestCostData.txt | ... | ... |
3rdparty/websocketpp-0.8.2/.travis.yml
0 → 100644
| 1 | +language: cpp | |
| 2 | +compiler: | |
| 3 | + - gcc | |
| 4 | +before_install: | |
| 5 | + #- sudo apt-get install libboost-chrono1.48-dev libboost-regex1.48-dev libboost-system1.48-dev libboost-thread1.48-dev libboost-test1.48-dev libboost-random1.48-dev -y | |
| 6 | + - sudo add-apt-repository -y ppa:boost-latest/ppa && sudo apt-get update -q && sudo apt-get install -y libboost-chrono1.55-dev libboost-random1.55-dev libboost-regex1.55-dev libboost-system1.55-dev libboost-thread1.55-dev libboost-test1.55-dev | |
| 7 | +env: | |
| 8 | + global: | |
| 9 | + - BOOST_INCLUDES=/usr/include | |
| 10 | + - BOOST_LIBS=/usr/lib/x86_64-linux-gnu | |
| 11 | +script: scons -j 2 && scons test | |
| 12 | +branches: | |
| 13 | + only: | |
| 14 | + - master | |
| 15 | + - develop | |
| 16 | +notifications: | |
| 17 | + recipients: | |
| 18 | + - travis@zaphoyd.com | |
| 19 | + email: | |
| 20 | + on_success: change | |
| 21 | + on_failure: always | ... | ... |
3rdparty/websocketpp-0.8.2/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +############ Setup project and cmake | |
| 3 | +# Minimum cmake requirement. We should require a quite recent | |
| 4 | +# cmake for the dependency find macros etc. to be up to date. | |
| 5 | +cmake_minimum_required (VERSION 2.8.8) | |
| 6 | + | |
| 7 | +############ Paths | |
| 8 | + | |
| 9 | +set (WEBSOCKETPP_ROOT ${CMAKE_CURRENT_SOURCE_DIR}) | |
| 10 | +set (WEBSOCKETPP_INCLUDE ${WEBSOCKETPP_ROOT}/websocketpp) | |
| 11 | +set (WEBSOCKETPP_BUILD_ROOT ${CMAKE_CURRENT_BINARY_DIR}) | |
| 12 | +set (WEBSOCKETPP_BIN ${WEBSOCKETPP_BUILD_ROOT}/bin) | |
| 13 | +set (WEBSOCKETPP_LIB ${WEBSOCKETPP_BUILD_ROOT}/lib) | |
| 14 | + | |
| 15 | +add_definitions(-D_GLIBCXX_USE_CXX11_ABI=0) | |
| 16 | + | |
| 17 | +# CMake install step prefix. I assume linux users want the prefix to | |
| 18 | +# be the default /usr or /usr/local so this is only adjusted on Windows. | |
| 19 | +# This must be set prior to any call to project or it will not be read correctly. | |
| 20 | +# - Windows: Build the INSTALL project in your solution file. | |
| 21 | +# - Linux/OSX: make install. | |
| 22 | +if (WIN32) | |
| 23 | + set (CMAKE_INSTALL_PREFIX "${WEBSOCKETPP_ROOT}/install" CACHE PATH "") | |
| 24 | +endif () | |
| 25 | + | |
| 26 | +############ Project name and version | |
| 27 | +set (WEBSOCKETPP_MAJOR_VERSION 0) | |
| 28 | +set (WEBSOCKETPP_MINOR_VERSION 8) | |
| 29 | +set (WEBSOCKETPP_PATCH_VERSION 2) | |
| 30 | +set (WEBSOCKETPP_VERSION ${WEBSOCKETPP_MAJOR_VERSION}.${WEBSOCKETPP_MINOR_VERSION}.${WEBSOCKETPP_PATCH_VERSION}) | |
| 31 | + | |
| 32 | +if(POLICY CMP0048) | |
| 33 | + cmake_policy(GET CMP0048 _version_policy) | |
| 34 | +endif() | |
| 35 | + | |
| 36 | +if(_version_allowed STREQUAL NEW) | |
| 37 | + project (websocketpp VERSION ${WEBSOCKETPP_VERSION}) | |
| 38 | +else() | |
| 39 | + project (websocketpp) | |
| 40 | +endif() | |
| 41 | + | |
| 42 | +set_property(GLOBAL PROPERTY USE_FOLDERS ON) | |
| 43 | + | |
| 44 | +set(INSTALL_INCLUDE_DIR include CACHE PATH "Installation directory for header files") | |
| 45 | +if (WIN32 AND NOT CYGWIN) | |
| 46 | + set (DEF_INSTALL_CMAKE_DIR cmake) | |
| 47 | +else () | |
| 48 | + set (DEF_INSTALL_CMAKE_DIR lib/cmake/websocketpp) | |
| 49 | +endif () | |
| 50 | +set (INSTALL_CMAKE_DIR ${DEF_INSTALL_CMAKE_DIR} CACHE PATH "Installation directory for CMake files") | |
| 51 | + | |
| 52 | +# Make relative paths absolute (needed later on) | |
| 53 | +foreach (p INCLUDE CMAKE) | |
| 54 | + set (var INSTALL_${p}_DIR) | |
| 55 | + if (NOT IS_ABSOLUTE "${${var}}") | |
| 56 | + set (${var} "${CMAKE_INSTALL_PREFIX}/${${var}}") | |
| 57 | + endif () | |
| 58 | +endforeach () | |
| 59 | + | |
| 60 | +# Set CMake library search policy | |
| 61 | +if (COMMAND cmake_policy) | |
| 62 | + cmake_policy (SET CMP0003 NEW) | |
| 63 | + cmake_policy (SET CMP0005 NEW) | |
| 64 | +endif () | |
| 65 | + | |
| 66 | +# Disable unnecessary build types | |
| 67 | +set (CMAKE_CONFIGURATION_TYPES "Release;RelWithDebInfo;Debug" CACHE STRING "Configurations" FORCE) | |
| 68 | + | |
| 69 | +# Include our cmake macros | |
| 70 | +set (CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} ${CMAKE_CURRENT_SOURCE_DIR}/cmake) | |
| 71 | +include (CMakeHelpers) | |
| 72 | + | |
| 73 | + | |
| 74 | +############ Build customization | |
| 75 | + | |
| 76 | +# Override from command line "CMake -D<OPTION>=TRUE/FALSE/0/1/ON/OFF" | |
| 77 | +option (ENABLE_CPP11 "Build websocketpp with CPP11 features enabled." TRUE) | |
| 78 | +option (BUILD_EXAMPLES "Build websocketpp examples." FALSE) | |
| 79 | +option (BUILD_TESTS "Build websocketpp tests." FALSE) | |
| 80 | + | |
| 81 | +if (BUILD_TESTS OR BUILD_EXAMPLES) | |
| 82 | + | |
| 83 | + enable_testing () | |
| 84 | + | |
| 85 | + ############ Compiler specific setup | |
| 86 | + | |
| 87 | + set (WEBSOCKETPP_PLATFORM_LIBS "") | |
| 88 | + set (WEBSOCKETPP_PLATFORM_TLS_LIBS "") | |
| 89 | + set (WEBSOCKETPP_BOOST_LIBS "") | |
| 90 | + | |
| 91 | + # VC9 and C++11 reasoning | |
| 92 | + if (ENABLE_CPP11 AND MSVC AND MSVC90) | |
| 93 | + message("* Detected Visual Studio 9 2008, disabling C++11 support.") | |
| 94 | + set (ENABLE_CPP11 FALSE) | |
| 95 | + endif () | |
| 96 | + | |
| 97 | + # Detect clang. Not officially reported by cmake. | |
| 98 | + execute_process(COMMAND "${CMAKE_CXX_COMPILER}" "-v" ERROR_VARIABLE CXX_VER_STDERR) | |
| 99 | + if ("${CXX_VER_STDERR}" MATCHES ".*clang.*") | |
| 100 | + set (CMAKE_COMPILER_IS_CLANGXX 1) | |
| 101 | + endif () | |
| 102 | + | |
| 103 | + # C++11 defines | |
| 104 | + if (ENABLE_CPP11) | |
| 105 | + if (MSVC) | |
| 106 | + add_definitions (-D_WEBSOCKETPP_CPP11_FUNCTIONAL_) | |
| 107 | + add_definitions (-D_WEBSOCKETPP_CPP11_SYSTEM_ERROR_) | |
| 108 | + add_definitions (-D_WEBSOCKETPP_CPP11_RANDOM_DEVICE_) | |
| 109 | + add_definitions (-D_WEBSOCKETPP_CPP11_MEMORY_) | |
| 110 | + else() | |
| 111 | + add_definitions (-D_WEBSOCKETPP_CPP11_STL_) | |
| 112 | + endif() | |
| 113 | + endif () | |
| 114 | + | |
| 115 | + # Visual studio | |
| 116 | + if (MSVC) | |
| 117 | + set (WEBSOCKETPP_BOOST_LIBS system thread) | |
| 118 | + set (CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /GL /Gy /GF /Ox /Ob2 /Ot /Oi /MP /arch:SSE2 /fp:fast") | |
| 119 | + set (CMAKE_SHARED_LINKER_FLAGS_RELEASE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE} /LTCG /INCREMENTAL:NO /OPT:REF /OPT:ICF") | |
| 120 | + add_definitions (/W3 /wd4996 /wd4995 /wd4355) | |
| 121 | + add_definitions (-DUNICODE -D_UNICODE) | |
| 122 | + add_definitions (-D_CRT_SECURE_NO_WARNINGS -D_SCL_SECURE_NO_WARNINGS) | |
| 123 | + add_definitions (-DNOMINMAX) | |
| 124 | + endif () | |
| 125 | + | |
| 126 | + # g++ | |
| 127 | + if (CMAKE_COMPILER_IS_GNUCXX) | |
| 128 | + if (NOT APPLE) | |
| 129 | + set (WEBSOCKETPP_PLATFORM_LIBS pthread rt) | |
| 130 | + else() | |
| 131 | + set (WEBSOCKETPP_PLATFORM_LIBS pthread) | |
| 132 | + endif() | |
| 133 | + set (WEBSOCKETPP_PLATFORM_TLS_LIBS ssl crypto) | |
| 134 | + set (WEBSOCKETPP_BOOST_LIBS system thread) | |
| 135 | + set (CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++0x") | |
| 136 | + if (NOT APPLE) | |
| 137 | + add_definitions (-DNDEBUG -Wall -Wcast-align) # todo: should we use CMAKE_C_FLAGS for these? | |
| 138 | + endif () | |
| 139 | + | |
| 140 | + # Try to detect version. Note: Not tested! | |
| 141 | + execute_process (COMMAND ${CMAKE_CXX_COMPILER} "-dumpversion" OUTPUT_VARIABLE GCC_VERSION) | |
| 142 | + if ("${GCC_VERSION}" STRGREATER "4.4.0") | |
| 143 | + message("* C++11 support partially enabled due to GCC version ${GCC_VERSION}") | |
| 144 | + set (WEBSOCKETPP_BOOST_LIBS system thread) | |
| 145 | + endif () | |
| 146 | + endif () | |
| 147 | + | |
| 148 | + # clang | |
| 149 | + if (CMAKE_COMPILER_IS_CLANGXX) | |
| 150 | + if (NOT APPLE) | |
| 151 | + set (WEBSOCKETPP_PLATFORM_LIBS pthread rt) | |
| 152 | + else() | |
| 153 | + set (WEBSOCKETPP_PLATFORM_LIBS pthread) | |
| 154 | + endif() | |
| 155 | + set (WEBSOCKETPP_PLATFORM_TLS_LIBS ssl crypto) | |
| 156 | + set (WEBSOCKETPP_BOOST_LIBS system thread) | |
| 157 | + set (CMAKE_CXX_FLAGS ${CMAKE_CXX_FLAGS} "-std=c++0x -stdlib=libc++") # todo: is libc++ really needed here? | |
| 158 | + if (NOT APPLE) | |
| 159 | + add_definitions (-DNDEBUG -Wall -Wno-padded) # todo: should we use CMAKE_C_FLAGS for these? | |
| 160 | + endif () | |
| 161 | + endif () | |
| 162 | + | |
| 163 | + # OSX, can override above. | |
| 164 | + if (APPLE) | |
| 165 | + add_definitions (-DNDEBUG -Wall) | |
| 166 | + endif () | |
| 167 | + | |
| 168 | + if (BUILD_EXAMPLES) | |
| 169 | + list (APPEND WEBSOCKETPP_BOOST_LIBS random) | |
| 170 | + endif() | |
| 171 | + | |
| 172 | + if (BUILD_TESTS) | |
| 173 | + list (APPEND WEBSOCKETPP_BOOST_LIBS unit_test_framework) | |
| 174 | + endif() | |
| 175 | + | |
| 176 | + ############ Dependencies | |
| 177 | + | |
| 178 | + # Set BOOST_ROOT env variable or pass with cmake -DBOOST_ROOT=path. | |
| 179 | + # BOOST_ROOT can also be defined by a previous run from cmake cache. | |
| 180 | + if (NOT "$ENV{BOOST_ROOT_CPP11}" STREQUAL "") | |
| 181 | + # Scons documentation for BOOST_ROOT_CPP11: | |
| 182 | + # "look for optional second boostroot compiled with clang's libc++ STL library | |
| 183 | + # this prevents warnings/errors when linking code built with two different | |
| 184 | + # incompatible STL libraries." | |
| 185 | + file (TO_CMAKE_PATH "$ENV{BOOST_ROOT_CPP11}" BOOST_ROOT) | |
| 186 | + set (BOOST_ROOT ${BOOST_ROOT} CACHE PATH "BOOST_ROOT dependency path" FORCE) | |
| 187 | + endif () | |
| 188 | + if ("${BOOST_ROOT}" STREQUAL "") | |
| 189 | + file (TO_CMAKE_PATH "$ENV{BOOST_ROOT}" BOOST_ROOT) | |
| 190 | + # Cache BOOST_ROOT for runs that do not define $ENV{BOOST_ROOT}. | |
| 191 | + set (BOOST_ROOT ${BOOST_ROOT} CACHE PATH "BOOST_ROOT dependency path" FORCE) | |
| 192 | + endif () | |
| 193 | + | |
| 194 | + message ("* Configuring Boost") | |
| 195 | + message (STATUS "-- Using BOOST_ROOT") | |
| 196 | + message (STATUS " " ${BOOST_ROOT}) | |
| 197 | + | |
| 198 | + if (MSVC) | |
| 199 | + set (Boost_USE_MULTITHREADED TRUE) | |
| 200 | + set (Boost_USE_STATIC_LIBS TRUE) | |
| 201 | + else () | |
| 202 | + set (Boost_USE_MULTITHREADED FALSE) | |
| 203 | + set (Boost_USE_STATIC_LIBS FALSE) | |
| 204 | + endif () | |
| 205 | + | |
| 206 | + if (BOOST_STATIC) | |
| 207 | + set (Boost_USE_STATIC_LIBS TRUE) | |
| 208 | + endif () | |
| 209 | + | |
| 210 | + if (NOT Boost_USE_STATIC_LIBS) | |
| 211 | + add_definitions (-DBOOST_TEST_DYN_LINK) | |
| 212 | + endif () | |
| 213 | + | |
| 214 | + set (Boost_FIND_REQUIRED TRUE) | |
| 215 | + set (Boost_FIND_QUIETLY TRUE) | |
| 216 | + set (Boost_DEBUG FALSE) | |
| 217 | + set (Boost_USE_MULTITHREADED TRUE) | |
| 218 | + set (Boost_ADDITIONAL_VERSIONS "1.39.0" "1.40.0" "1.41.0" "1.42.0" "1.43.0" "1.44.0" "1.46.1") # todo: someone who knows better spesify these! | |
| 219 | + | |
| 220 | + find_package (Boost 1.39.0 COMPONENTS "${WEBSOCKETPP_BOOST_LIBS}") | |
| 221 | + | |
| 222 | + if (Boost_FOUND) | |
| 223 | + # Boost is a project wide global dependency. | |
| 224 | + include_directories (${Boost_INCLUDE_DIRS}) | |
| 225 | + link_directories (${Boost_LIBRARY_DIRS}) | |
| 226 | + | |
| 227 | + # Pretty print status | |
| 228 | + message (STATUS "-- Include Directories") | |
| 229 | + foreach (include_dir ${Boost_INCLUDE_DIRS}) | |
| 230 | + message (STATUS " " ${include_dir}) | |
| 231 | + endforeach () | |
| 232 | + message (STATUS "-- Library Directories") | |
| 233 | + foreach (library_dir ${Boost_LIBRARY_DIRS}) | |
| 234 | + message (STATUS " " ${library_dir}) | |
| 235 | + endforeach () | |
| 236 | + message (STATUS "-- Libraries") | |
| 237 | + foreach (boost_lib ${Boost_LIBRARIES}) | |
| 238 | + message (STATUS " " ${boost_lib}) | |
| 239 | + endforeach () | |
| 240 | + message ("") | |
| 241 | + else () | |
| 242 | + message (FATAL_ERROR "Failed to find required dependency: boost") | |
| 243 | + endif () | |
| 244 | + | |
| 245 | + find_package(OpenSSL) | |
| 246 | + find_package(ZLIB) | |
| 247 | +endif() | |
| 248 | + | |
| 249 | +############ Add projects | |
| 250 | + | |
| 251 | +# Add main library | |
| 252 | +add_subdirectory (websocketpp) | |
| 253 | + | |
| 254 | +# Add examples | |
| 255 | +if (BUILD_EXAMPLES) | |
| 256 | + include_subdirs ("examples") | |
| 257 | +endif () | |
| 258 | + | |
| 259 | +# Add tests | |
| 260 | +if (BUILD_TESTS) | |
| 261 | + include_subdirs ("test") | |
| 262 | +endif () | |
| 263 | + | |
| 264 | +print_used_build_config() | |
| 265 | + | |
| 266 | +export (PACKAGE websocketpp) | |
| 267 | + | |
| 268 | +include(CMakePackageConfigHelpers) | |
| 269 | +configure_package_config_file(websocketpp-config.cmake.in | |
| 270 | + "${PROJECT_BINARY_DIR}${CMAKE_FILES_DIRECTORY}/websocketpp-config.cmake" | |
| 271 | + PATH_VARS INSTALL_INCLUDE_DIR | |
| 272 | + INSTALL_DESTINATION "${INSTALL_CMAKE_DIR}" | |
| 273 | + NO_CHECK_REQUIRED_COMPONENTS_MACRO | |
| 274 | +) | |
| 275 | +write_basic_package_version_file("${PROJECT_BINARY_DIR}${CMAKE_FILES_DIRECTORY}/websocketpp-configVersion.cmake" | |
| 276 | + VERSION ${WEBSOCKETPP_VERSION} | |
| 277 | + COMPATIBILITY ExactVersion) | |
| 278 | + | |
| 279 | +# Install the websocketpp-config.cmake and websocketpp-configVersion.cmake | |
| 280 | +install (FILES | |
| 281 | + "${PROJECT_BINARY_DIR}${CMAKE_FILES_DIRECTORY}/websocketpp-config.cmake" | |
| 282 | + "${PROJECT_BINARY_DIR}${CMAKE_FILES_DIRECTORY}/websocketpp-configVersion.cmake" | |
| 283 | + DESTINATION "${INSTALL_CMAKE_DIR}" COMPONENT dev) | |
| 284 | + | ... | ... |
3rdparty/websocketpp-0.8.2/COPYING
0 → 100644
| 1 | +Main Library: | |
| 2 | + | |
| 3 | +Copyright (c) 2014, Peter Thorson. All rights reserved. | |
| 4 | + | |
| 5 | +Redistribution and use in source and binary forms, with or without | |
| 6 | +modification, are permitted provided that the following conditions are met: | |
| 7 | + * Redistributions of source code must retain the above copyright | |
| 8 | + notice, this list of conditions and the following disclaimer. | |
| 9 | + * Redistributions in binary form must reproduce the above copyright | |
| 10 | + notice, this list of conditions and the following disclaimer in the | |
| 11 | + documentation and/or other materials provided with the distribution. | |
| 12 | + * Neither the name of the WebSocket++ Project nor the | |
| 13 | + names of its contributors may be used to endorse or promote products | |
| 14 | + derived from this software without specific prior written permission. | |
| 15 | + | |
| 16 | +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 17 | +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 18 | +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 19 | +ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 20 | +DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 21 | +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 22 | +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 23 | +ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 24 | +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 25 | +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 26 | + | |
| 27 | +Bundled Libraries: | |
| 28 | + | |
| 29 | +****** Base 64 Library (base64/base64.hpp) ****** | |
| 30 | +base64.hpp is a repackaging of the base64.cpp and base64.h files into a | |
| 31 | +single header suitable for use as a header only library. This conversion was | |
| 32 | +done by Peter Thorson (webmaster@zaphoyd.com) in 2012. All modifications to | |
| 33 | +the code are redistributed under the same license as the original, which is | |
| 34 | +listed below. | |
| 35 | + | |
| 36 | +base64.cpp and base64.h | |
| 37 | + | |
| 38 | +Copyright (C) 2004-2008 René Nyffenegger | |
| 39 | + | |
| 40 | +This source code is provided 'as-is', without any express or implied | |
| 41 | +warranty. In no event will the author be held liable for any damages | |
| 42 | +arising from the use of this software. | |
| 43 | + | |
| 44 | +Permission is granted to anyone to use this software for any purpose, | |
| 45 | +including commercial applications, and to alter it and redistribute it | |
| 46 | +freely, subject to the following restrictions: | |
| 47 | + | |
| 48 | +1. The origin of this source code must not be misrepresented; you must not | |
| 49 | + claim that you wrote the original source code. If you use this source code | |
| 50 | + in a product, an acknowledgment in the product documentation would be | |
| 51 | + appreciated but is not required. | |
| 52 | + | |
| 53 | +2. Altered source versions must be plainly marked as such, and must not be | |
| 54 | + misrepresented as being the original source code. | |
| 55 | + | |
| 56 | +3. This notice may not be removed or altered from any source distribution. | |
| 57 | + | |
| 58 | +René Nyffenegger rene.nyffenegger@adp-gmbh.ch | |
| 59 | + | |
| 60 | +****** SHA1 Library (sha1/sha1.hpp) ****** | |
| 61 | +sha1.hpp is a repackaging of the sha1.cpp and sha1.h files from the shallsha1 | |
| 62 | +library (http://code.google.com/p/smallsha1/) into a single header suitable for | |
| 63 | +use as a header only library. This conversion was done by Peter Thorson | |
| 64 | +(webmaster@zaphoyd.com) in 2013. All modifications to the code are redistributed | |
| 65 | +under the same license as the original, which is listed below. | |
| 66 | + | |
| 67 | + Copyright (c) 2011, Micael Hildenborg | |
| 68 | + All rights reserved. | |
| 69 | + | |
| 70 | + Redistribution and use in source and binary forms, with or without | |
| 71 | + modification, are permitted provided that the following conditions are met: | |
| 72 | + * Redistributions of source code must retain the above copyright | |
| 73 | + notice, this list of conditions and the following disclaimer. | |
| 74 | + * Redistributions in binary form must reproduce the above copyright | |
| 75 | + notice, this list of conditions and the following disclaimer in the | |
| 76 | + documentation and/or other materials provided with the distribution. | |
| 77 | + * Neither the name of Micael Hildenborg nor the | |
| 78 | + names of its contributors may be used to endorse or promote products | |
| 79 | + derived from this software without specific prior written permission. | |
| 80 | + | |
| 81 | + THIS SOFTWARE IS PROVIDED BY Micael Hildenborg ''AS IS'' AND ANY | |
| 82 | + EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED | |
| 83 | + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE | |
| 84 | + DISCLAIMED. IN NO EVENT SHALL Micael Hildenborg BE LIABLE FOR ANY | |
| 85 | + DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 86 | + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 87 | + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 88 | + ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 89 | + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 90 | + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 91 | + | |
| 92 | +****** MD5 Library (common/md5.hpp) ****** | |
| 93 | +md5.hpp is a reformulation of the md5.h and md5.c code from | |
| 94 | +http://www.opensource.apple.com/source/cups/cups-59/cups/md5.c to allow it to | |
| 95 | +function as a component of a header only library. This conversion was done by | |
| 96 | +Peter Thorson (webmaster@zaphoyd.com) in 2012 for the WebSocket++ project. The | |
| 97 | +changes are released under the same license as the original (listed below) | |
| 98 | + | |
| 99 | +Copyright (C) 1999, 2002 Aladdin Enterprises. All rights reserved. | |
| 100 | + | |
| 101 | +This software is provided 'as-is', without any express or implied | |
| 102 | +warranty. In no event will the authors be held liable for any damages | |
| 103 | +arising from the use of this software. | |
| 104 | + | |
| 105 | +Permission is granted to anyone to use this software for any purpose, | |
| 106 | +including commercial applications, and to alter it and redistribute it | |
| 107 | +freely, subject to the following restrictions: | |
| 108 | + | |
| 109 | +1. The origin of this software must not be misrepresented; you must not | |
| 110 | + claim that you wrote the original software. If you use this software | |
| 111 | + in a product, an acknowledgment in the product documentation would be | |
| 112 | + appreciated but is not required. | |
| 113 | +2. Altered source versions must be plainly marked as such, and must not be | |
| 114 | + misrepresented as being the original software. | |
| 115 | +3. This notice may not be removed or altered from any source distribution. | |
| 116 | + | |
| 117 | +L. Peter Deutsch | |
| 118 | +ghost@aladdin.com | |
| 119 | + | |
| 120 | +****** UTF8 Validation logic (utf8_validation.hpp) ****** | |
| 121 | +utf8_validation.hpp is adapted from code originally written by Bjoern Hoehrmann | |
| 122 | +<bjoern@hoehrmann.de>. See http://bjoern.hoehrmann.de/utf-8/decoder/dfa/ for | |
| 123 | +details. | |
| 124 | + | |
| 125 | +The original license: | |
| 126 | + | |
| 127 | +Copyright (c) 2008-2009 Bjoern Hoehrmann <bjoern@hoehrmann.de> | |
| 128 | + | |
| 129 | +Permission is hereby granted, free of charge, to any person obtaining a copy | |
| 130 | +of this software and associated documentation files (the "Software"), to deal | |
| 131 | +in the Software without restriction, including without limitation the rights | |
| 132 | +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
| 133 | +copies of the Software, and to permit persons to whom the Software is | |
| 134 | +furnished to do so, subject to the following conditions: | |
| 135 | + | |
| 136 | +The above copyright notice and this permission notice shall be included in | |
| 137 | +all copies or substantial portions of the Software. | |
| 138 | + | |
| 139 | +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
| 140 | +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
| 141 | +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
| 142 | +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
| 143 | +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
| 144 | +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | |
| 145 | +SOFTWARE. | ... | ... |
3rdparty/websocketpp-0.8.2/Doxyfile
0 → 100644
| 1 | +# Doxyfile 1.8.8 | |
| 2 | + | |
| 3 | +# This file describes the settings to be used by the documentation system | |
| 4 | +# doxygen (www.doxygen.org) for a project. | |
| 5 | +# | |
| 6 | +# All text after a double hash (##) is considered a comment and is placed in | |
| 7 | +# front of the TAG it is preceding. | |
| 8 | +# | |
| 9 | +# All text after a single hash (#) is considered a comment and will be ignored. | |
| 10 | +# The format is: | |
| 11 | +# TAG = value [value, ...] | |
| 12 | +# For lists, items can also be appended using: | |
| 13 | +# TAG += value [value, ...] | |
| 14 | +# Values that contain spaces should be placed between quotes (\" \"). | |
| 15 | + | |
| 16 | +#--------------------------------------------------------------------------- | |
| 17 | +# Project related configuration options | |
| 18 | +#--------------------------------------------------------------------------- | |
| 19 | + | |
| 20 | +# This tag specifies the encoding used for all characters in the config file | |
| 21 | +# that follow. The default is UTF-8 which is also the encoding used for all text | |
| 22 | +# before the first occurrence of this tag. Doxygen uses libiconv (or the iconv | |
| 23 | +# built into libc) for the transcoding. See http://www.gnu.org/software/libiconv | |
| 24 | +# for the list of possible encodings. | |
| 25 | +# The default value is: UTF-8. | |
| 26 | + | |
| 27 | +DOXYFILE_ENCODING = UTF-8 | |
| 28 | + | |
| 29 | +# The PROJECT_NAME tag is a single word (or a sequence of words surrounded by | |
| 30 | +# double-quotes, unless you are using Doxywizard) that should identify the | |
| 31 | +# project for which the documentation is generated. This name is used in the | |
| 32 | +# title of most generated pages and in a few other places. | |
| 33 | +# The default value is: My Project. | |
| 34 | + | |
| 35 | +PROJECT_NAME = WebSocket++ | |
| 36 | + | |
| 37 | +# The PROJECT_NUMBER tag can be used to enter a project or revision number. This | |
| 38 | +# could be handy for archiving the generated documentation or if some version | |
| 39 | +# control system is used. | |
| 40 | + | |
| 41 | +PROJECT_NUMBER = 0.8.2 | |
| 42 | + | |
| 43 | +# Using the PROJECT_BRIEF tag one can provide an optional one line description | |
| 44 | +# for a project that appears at the top of each page and should give viewer a | |
| 45 | +# quick idea about the purpose of the project. Keep the description short. | |
| 46 | + | |
| 47 | +PROJECT_BRIEF = "C++ websocket client/server library" | |
| 48 | + | |
| 49 | +# With the PROJECT_LOGO tag one can specify an logo or icon that is included in | |
| 50 | +# the documentation. The maximum height of the logo should not exceed 55 pixels | |
| 51 | +# and the maximum width should not exceed 200 pixels. Doxygen will copy the logo | |
| 52 | +# to the output directory. | |
| 53 | + | |
| 54 | +PROJECT_LOGO = | |
| 55 | + | |
| 56 | +# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path | |
| 57 | +# into which the generated documentation will be written. If a relative path is | |
| 58 | +# entered, it will be relative to the location where doxygen was started. If | |
| 59 | +# left blank the current directory will be used. | |
| 60 | + | |
| 61 | +OUTPUT_DIRECTORY = doxygen | |
| 62 | + | |
| 63 | +# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 4096 sub- | |
| 64 | +# directories (in 2 levels) under the output directory of each output format and | |
| 65 | +# will distribute the generated files over these directories. Enabling this | |
| 66 | +# option can be useful when feeding doxygen a huge amount of source files, where | |
| 67 | +# putting all generated files in the same directory would otherwise causes | |
| 68 | +# performance problems for the file system. | |
| 69 | +# The default value is: NO. | |
| 70 | + | |
| 71 | +CREATE_SUBDIRS = NO | |
| 72 | + | |
| 73 | +# If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII | |
| 74 | +# characters to appear in the names of generated files. If set to NO, non-ASCII | |
| 75 | +# characters will be escaped, for example _xE3_x81_x84 will be used for Unicode | |
| 76 | +# U+3044. | |
| 77 | +# The default value is: NO. | |
| 78 | + | |
| 79 | +ALLOW_UNICODE_NAMES = NO | |
| 80 | + | |
| 81 | +# The OUTPUT_LANGUAGE tag is used to specify the language in which all | |
| 82 | +# documentation generated by doxygen is written. Doxygen will use this | |
| 83 | +# information to generate all constant output in the proper language. | |
| 84 | +# Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese, | |
| 85 | +# Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States), | |
| 86 | +# Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian, | |
| 87 | +# Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages), | |
| 88 | +# Korean, Korean-en (Korean with English messages), Latvian, Lithuanian, | |
| 89 | +# Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian, | |
| 90 | +# Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish, | |
| 91 | +# Ukrainian and Vietnamese. | |
| 92 | +# The default value is: English. | |
| 93 | + | |
| 94 | +OUTPUT_LANGUAGE = English | |
| 95 | + | |
| 96 | +# If the BRIEF_MEMBER_DESC tag is set to YES doxygen will include brief member | |
| 97 | +# descriptions after the members that are listed in the file and class | |
| 98 | +# documentation (similar to Javadoc). Set to NO to disable this. | |
| 99 | +# The default value is: YES. | |
| 100 | + | |
| 101 | +BRIEF_MEMBER_DESC = YES | |
| 102 | + | |
| 103 | +# If the REPEAT_BRIEF tag is set to YES doxygen will prepend the brief | |
| 104 | +# description of a member or function before the detailed description | |
| 105 | +# | |
| 106 | +# Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the | |
| 107 | +# brief descriptions will be completely suppressed. | |
| 108 | +# The default value is: YES. | |
| 109 | + | |
| 110 | +REPEAT_BRIEF = YES | |
| 111 | + | |
| 112 | +# This tag implements a quasi-intelligent brief description abbreviator that is | |
| 113 | +# used to form the text in various listings. Each string in this list, if found | |
| 114 | +# as the leading text of the brief description, will be stripped from the text | |
| 115 | +# and the result, after processing the whole list, is used as the annotated | |
| 116 | +# text. Otherwise, the brief description is used as-is. If left blank, the | |
| 117 | +# following values are used ($name is automatically replaced with the name of | |
| 118 | +# the entity):The $name class, The $name widget, The $name file, is, provides, | |
| 119 | +# specifies, contains, represents, a, an and the. | |
| 120 | + | |
| 121 | +ABBREVIATE_BRIEF = | |
| 122 | + | |
| 123 | +# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then | |
| 124 | +# doxygen will generate a detailed section even if there is only a brief | |
| 125 | +# description. | |
| 126 | +# The default value is: NO. | |
| 127 | + | |
| 128 | +ALWAYS_DETAILED_SEC = NO | |
| 129 | + | |
| 130 | +# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all | |
| 131 | +# inherited members of a class in the documentation of that class as if those | |
| 132 | +# members were ordinary class members. Constructors, destructors and assignment | |
| 133 | +# operators of the base classes will not be shown. | |
| 134 | +# The default value is: NO. | |
| 135 | + | |
| 136 | +INLINE_INHERITED_MEMB = NO | |
| 137 | + | |
| 138 | +# If the FULL_PATH_NAMES tag is set to YES doxygen will prepend the full path | |
| 139 | +# before files name in the file list and in the header files. If set to NO the | |
| 140 | +# shortest path that makes the file name unique will be used | |
| 141 | +# The default value is: YES. | |
| 142 | + | |
| 143 | +FULL_PATH_NAMES = YES | |
| 144 | + | |
| 145 | +# The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path. | |
| 146 | +# Stripping is only done if one of the specified strings matches the left-hand | |
| 147 | +# part of the path. The tag can be used to show relative paths in the file list. | |
| 148 | +# If left blank the directory from which doxygen is run is used as the path to | |
| 149 | +# strip. | |
| 150 | +# | |
| 151 | +# Note that you can specify absolute paths here, but also relative paths, which | |
| 152 | +# will be relative from the directory where doxygen is started. | |
| 153 | +# This tag requires that the tag FULL_PATH_NAMES is set to YES. | |
| 154 | + | |
| 155 | +STRIP_FROM_PATH = | |
| 156 | + | |
| 157 | +# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the | |
| 158 | +# path mentioned in the documentation of a class, which tells the reader which | |
| 159 | +# header file to include in order to use a class. If left blank only the name of | |
| 160 | +# the header file containing the class definition is used. Otherwise one should | |
| 161 | +# specify the list of include paths that are normally passed to the compiler | |
| 162 | +# using the -I flag. | |
| 163 | + | |
| 164 | +STRIP_FROM_INC_PATH = | |
| 165 | + | |
| 166 | +# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but | |
| 167 | +# less readable) file names. This can be useful is your file systems doesn't | |
| 168 | +# support long names like on DOS, Mac, or CD-ROM. | |
| 169 | +# The default value is: NO. | |
| 170 | + | |
| 171 | +SHORT_NAMES = NO | |
| 172 | + | |
| 173 | +# If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the | |
| 174 | +# first line (until the first dot) of a Javadoc-style comment as the brief | |
| 175 | +# description. If set to NO, the Javadoc-style will behave just like regular Qt- | |
| 176 | +# style comments (thus requiring an explicit @brief command for a brief | |
| 177 | +# description.) | |
| 178 | +# The default value is: NO. | |
| 179 | + | |
| 180 | +JAVADOC_AUTOBRIEF = NO | |
| 181 | + | |
| 182 | +# If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first | |
| 183 | +# line (until the first dot) of a Qt-style comment as the brief description. If | |
| 184 | +# set to NO, the Qt-style will behave just like regular Qt-style comments (thus | |
| 185 | +# requiring an explicit \brief command for a brief description.) | |
| 186 | +# The default value is: NO. | |
| 187 | + | |
| 188 | +QT_AUTOBRIEF = NO | |
| 189 | + | |
| 190 | +# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a | |
| 191 | +# multi-line C++ special comment block (i.e. a block of //! or /// comments) as | |
| 192 | +# a brief description. This used to be the default behavior. The new default is | |
| 193 | +# to treat a multi-line C++ comment block as a detailed description. Set this | |
| 194 | +# tag to YES if you prefer the old behavior instead. | |
| 195 | +# | |
| 196 | +# Note that setting this tag to YES also means that rational rose comments are | |
| 197 | +# not recognized any more. | |
| 198 | +# The default value is: NO. | |
| 199 | + | |
| 200 | +MULTILINE_CPP_IS_BRIEF = NO | |
| 201 | + | |
| 202 | +# If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the | |
| 203 | +# documentation from any documented member that it re-implements. | |
| 204 | +# The default value is: YES. | |
| 205 | + | |
| 206 | +INHERIT_DOCS = YES | |
| 207 | + | |
| 208 | +# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce a | |
| 209 | +# new page for each member. If set to NO, the documentation of a member will be | |
| 210 | +# part of the file/class/namespace that contains it. | |
| 211 | +# The default value is: NO. | |
| 212 | + | |
| 213 | +SEPARATE_MEMBER_PAGES = NO | |
| 214 | + | |
| 215 | +# The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen | |
| 216 | +# uses this value to replace tabs by spaces in code fragments. | |
| 217 | +# Minimum value: 1, maximum value: 16, default value: 4. | |
| 218 | + | |
| 219 | +TAB_SIZE = 4 | |
| 220 | + | |
| 221 | +# This tag can be used to specify a number of aliases that act as commands in | |
| 222 | +# the documentation. An alias has the form: | |
| 223 | +# name=value | |
| 224 | +# For example adding | |
| 225 | +# "sideeffect=@par Side Effects:\n" | |
| 226 | +# will allow you to put the command \sideeffect (or @sideeffect) in the | |
| 227 | +# documentation, which will result in a user-defined paragraph with heading | |
| 228 | +# "Side Effects:". You can put \n's in the value part of an alias to insert | |
| 229 | +# newlines. | |
| 230 | + | |
| 231 | +ALIASES = | |
| 232 | + | |
| 233 | +# This tag can be used to specify a number of word-keyword mappings (TCL only). | |
| 234 | +# A mapping has the form "name=value". For example adding "class=itcl::class" | |
| 235 | +# will allow you to use the command class in the itcl::class meaning. | |
| 236 | + | |
| 237 | +TCL_SUBST = | |
| 238 | + | |
| 239 | +# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources | |
| 240 | +# only. Doxygen will then generate output that is more tailored for C. For | |
| 241 | +# instance, some of the names that are used will be different. The list of all | |
| 242 | +# members will be omitted, etc. | |
| 243 | +# The default value is: NO. | |
| 244 | + | |
| 245 | +OPTIMIZE_OUTPUT_FOR_C = NO | |
| 246 | + | |
| 247 | +# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or | |
| 248 | +# Python sources only. Doxygen will then generate output that is more tailored | |
| 249 | +# for that language. For instance, namespaces will be presented as packages, | |
| 250 | +# qualified scopes will look different, etc. | |
| 251 | +# The default value is: NO. | |
| 252 | + | |
| 253 | +OPTIMIZE_OUTPUT_JAVA = NO | |
| 254 | + | |
| 255 | +# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran | |
| 256 | +# sources. Doxygen will then generate output that is tailored for Fortran. | |
| 257 | +# The default value is: NO. | |
| 258 | + | |
| 259 | +OPTIMIZE_FOR_FORTRAN = NO | |
| 260 | + | |
| 261 | +# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL | |
| 262 | +# sources. Doxygen will then generate output that is tailored for VHDL. | |
| 263 | +# The default value is: NO. | |
| 264 | + | |
| 265 | +OPTIMIZE_OUTPUT_VHDL = NO | |
| 266 | + | |
| 267 | +# Doxygen selects the parser to use depending on the extension of the files it | |
| 268 | +# parses. With this tag you can assign which parser to use for a given | |
| 269 | +# extension. Doxygen has a built-in mapping, but you can override or extend it | |
| 270 | +# using this tag. The format is ext=language, where ext is a file extension, and | |
| 271 | +# language is one of the parsers supported by doxygen: IDL, Java, Javascript, | |
| 272 | +# C#, C, C++, D, PHP, Objective-C, Python, Fortran (fixed format Fortran: | |
| 273 | +# FortranFixed, free formatted Fortran: FortranFree, unknown formatted Fortran: | |
| 274 | +# Fortran. In the later case the parser tries to guess whether the code is fixed | |
| 275 | +# or free formatted code, this is the default for Fortran type files), VHDL. For | |
| 276 | +# instance to make doxygen treat .inc files as Fortran files (default is PHP), | |
| 277 | +# and .f files as C (default is Fortran), use: inc=Fortran f=C. | |
| 278 | +# | |
| 279 | +# Note For files without extension you can use no_extension as a placeholder. | |
| 280 | +# | |
| 281 | +# Note that for custom extensions you also need to set FILE_PATTERNS otherwise | |
| 282 | +# the files are not read by doxygen. | |
| 283 | + | |
| 284 | +EXTENSION_MAPPING = | |
| 285 | + | |
| 286 | +# If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments | |
| 287 | +# according to the Markdown format, which allows for more readable | |
| 288 | +# documentation. See http://daringfireball.net/projects/markdown/ for details. | |
| 289 | +# The output of markdown processing is further processed by doxygen, so you can | |
| 290 | +# mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in | |
| 291 | +# case of backward compatibilities issues. | |
| 292 | +# The default value is: YES. | |
| 293 | + | |
| 294 | +MARKDOWN_SUPPORT = YES | |
| 295 | + | |
| 296 | +# When enabled doxygen tries to link words that correspond to documented | |
| 297 | +# classes, or namespaces to their corresponding documentation. Such a link can | |
| 298 | +# be prevented in individual cases by by putting a % sign in front of the word | |
| 299 | +# or globally by setting AUTOLINK_SUPPORT to NO. | |
| 300 | +# The default value is: YES. | |
| 301 | + | |
| 302 | +AUTOLINK_SUPPORT = YES | |
| 303 | + | |
| 304 | +# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want | |
| 305 | +# to include (a tag file for) the STL sources as input, then you should set this | |
| 306 | +# tag to YES in order to let doxygen match functions declarations and | |
| 307 | +# definitions whose arguments contain STL classes (e.g. func(std::string); | |
| 308 | +# versus func(std::string) {}). This also make the inheritance and collaboration | |
| 309 | +# diagrams that involve STL classes more complete and accurate. | |
| 310 | +# The default value is: NO. | |
| 311 | + | |
| 312 | +BUILTIN_STL_SUPPORT = YES | |
| 313 | + | |
| 314 | +# If you use Microsoft's C++/CLI language, you should set this option to YES to | |
| 315 | +# enable parsing support. | |
| 316 | +# The default value is: NO. | |
| 317 | + | |
| 318 | +CPP_CLI_SUPPORT = NO | |
| 319 | + | |
| 320 | +# Set the SIP_SUPPORT tag to YES if your project consists of sip (see: | |
| 321 | +# http://www.riverbankcomputing.co.uk/software/sip/intro) sources only. Doxygen | |
| 322 | +# will parse them like normal C++ but will assume all classes use public instead | |
| 323 | +# of private inheritance when no explicit protection keyword is present. | |
| 324 | +# The default value is: NO. | |
| 325 | + | |
| 326 | +SIP_SUPPORT = NO | |
| 327 | + | |
| 328 | +# For Microsoft's IDL there are propget and propput attributes to indicate | |
| 329 | +# getter and setter methods for a property. Setting this option to YES will make | |
| 330 | +# doxygen to replace the get and set methods by a property in the documentation. | |
| 331 | +# This will only work if the methods are indeed getting or setting a simple | |
| 332 | +# type. If this is not the case, or you want to show the methods anyway, you | |
| 333 | +# should set this option to NO. | |
| 334 | +# The default value is: YES. | |
| 335 | + | |
| 336 | +IDL_PROPERTY_SUPPORT = YES | |
| 337 | + | |
| 338 | +# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC | |
| 339 | +# tag is set to YES, then doxygen will reuse the documentation of the first | |
| 340 | +# member in the group (if any) for the other members of the group. By default | |
| 341 | +# all members of a group must be documented explicitly. | |
| 342 | +# The default value is: NO. | |
| 343 | + | |
| 344 | +DISTRIBUTE_GROUP_DOC = NO | |
| 345 | + | |
| 346 | +# Set the SUBGROUPING tag to YES to allow class member groups of the same type | |
| 347 | +# (for instance a group of public functions) to be put as a subgroup of that | |
| 348 | +# type (e.g. under the Public Functions section). Set it to NO to prevent | |
| 349 | +# subgrouping. Alternatively, this can be done per class using the | |
| 350 | +# \nosubgrouping command. | |
| 351 | +# The default value is: YES. | |
| 352 | + | |
| 353 | +SUBGROUPING = YES | |
| 354 | + | |
| 355 | +# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions | |
| 356 | +# are shown inside the group in which they are included (e.g. using \ingroup) | |
| 357 | +# instead of on a separate page (for HTML and Man pages) or section (for LaTeX | |
| 358 | +# and RTF). | |
| 359 | +# | |
| 360 | +# Note that this feature does not work in combination with | |
| 361 | +# SEPARATE_MEMBER_PAGES. | |
| 362 | +# The default value is: NO. | |
| 363 | + | |
| 364 | +INLINE_GROUPED_CLASSES = NO | |
| 365 | + | |
| 366 | +# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions | |
| 367 | +# with only public data fields or simple typedef fields will be shown inline in | |
| 368 | +# the documentation of the scope in which they are defined (i.e. file, | |
| 369 | +# namespace, or group documentation), provided this scope is documented. If set | |
| 370 | +# to NO, structs, classes, and unions are shown on a separate page (for HTML and | |
| 371 | +# Man pages) or section (for LaTeX and RTF). | |
| 372 | +# The default value is: NO. | |
| 373 | + | |
| 374 | +INLINE_SIMPLE_STRUCTS = NO | |
| 375 | + | |
| 376 | +# When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or | |
| 377 | +# enum is documented as struct, union, or enum with the name of the typedef. So | |
| 378 | +# typedef struct TypeS {} TypeT, will appear in the documentation as a struct | |
| 379 | +# with name TypeT. When disabled the typedef will appear as a member of a file, | |
| 380 | +# namespace, or class. And the struct will be named TypeS. This can typically be | |
| 381 | +# useful for C code in case the coding convention dictates that all compound | |
| 382 | +# types are typedef'ed and only the typedef is referenced, never the tag name. | |
| 383 | +# The default value is: NO. | |
| 384 | + | |
| 385 | +TYPEDEF_HIDES_STRUCT = NO | |
| 386 | + | |
| 387 | +# The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This | |
| 388 | +# cache is used to resolve symbols given their name and scope. Since this can be | |
| 389 | +# an expensive process and often the same symbol appears multiple times in the | |
| 390 | +# code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small | |
| 391 | +# doxygen will become slower. If the cache is too large, memory is wasted. The | |
| 392 | +# cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range | |
| 393 | +# is 0..9, the default is 0, corresponding to a cache size of 2^16=65536 | |
| 394 | +# symbols. At the end of a run doxygen will report the cache usage and suggest | |
| 395 | +# the optimal cache size from a speed point of view. | |
| 396 | +# Minimum value: 0, maximum value: 9, default value: 0. | |
| 397 | + | |
| 398 | +LOOKUP_CACHE_SIZE = 0 | |
| 399 | + | |
| 400 | +#--------------------------------------------------------------------------- | |
| 401 | +# Build related configuration options | |
| 402 | +#--------------------------------------------------------------------------- | |
| 403 | + | |
| 404 | +# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in | |
| 405 | +# documentation are documented, even if no documentation was available. Private | |
| 406 | +# class members and static file members will be hidden unless the | |
| 407 | +# EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES. | |
| 408 | +# Note: This will also disable the warnings about undocumented members that are | |
| 409 | +# normally produced when WARNINGS is set to YES. | |
| 410 | +# The default value is: NO. | |
| 411 | + | |
| 412 | +EXTRACT_ALL = NO | |
| 413 | + | |
| 414 | +# If the EXTRACT_PRIVATE tag is set to YES all private members of a class will | |
| 415 | +# be included in the documentation. | |
| 416 | +# The default value is: NO. | |
| 417 | + | |
| 418 | +EXTRACT_PRIVATE = NO | |
| 419 | + | |
| 420 | +# If the EXTRACT_PACKAGE tag is set to YES all members with package or internal | |
| 421 | +# scope will be included in the documentation. | |
| 422 | +# The default value is: NO. | |
| 423 | + | |
| 424 | +EXTRACT_PACKAGE = NO | |
| 425 | + | |
| 426 | +# If the EXTRACT_STATIC tag is set to YES all static members of a file will be | |
| 427 | +# included in the documentation. | |
| 428 | +# The default value is: NO. | |
| 429 | + | |
| 430 | +EXTRACT_STATIC = YES | |
| 431 | + | |
| 432 | +# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) defined | |
| 433 | +# locally in source files will be included in the documentation. If set to NO | |
| 434 | +# only classes defined in header files are included. Does not have any effect | |
| 435 | +# for Java sources. | |
| 436 | +# The default value is: YES. | |
| 437 | + | |
| 438 | +EXTRACT_LOCAL_CLASSES = YES | |
| 439 | + | |
| 440 | +# This flag is only useful for Objective-C code. When set to YES local methods, | |
| 441 | +# which are defined in the implementation section but not in the interface are | |
| 442 | +# included in the documentation. If set to NO only methods in the interface are | |
| 443 | +# included. | |
| 444 | +# The default value is: NO. | |
| 445 | + | |
| 446 | +EXTRACT_LOCAL_METHODS = NO | |
| 447 | + | |
| 448 | +# If this flag is set to YES, the members of anonymous namespaces will be | |
| 449 | +# extracted and appear in the documentation as a namespace called | |
| 450 | +# 'anonymous_namespace{file}', where file will be replaced with the base name of | |
| 451 | +# the file that contains the anonymous namespace. By default anonymous namespace | |
| 452 | +# are hidden. | |
| 453 | +# The default value is: NO. | |
| 454 | + | |
| 455 | +EXTRACT_ANON_NSPACES = NO | |
| 456 | + | |
| 457 | +# If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all | |
| 458 | +# undocumented members inside documented classes or files. If set to NO these | |
| 459 | +# members will be included in the various overviews, but no documentation | |
| 460 | +# section is generated. This option has no effect if EXTRACT_ALL is enabled. | |
| 461 | +# The default value is: NO. | |
| 462 | + | |
| 463 | +HIDE_UNDOC_MEMBERS = NO | |
| 464 | + | |
| 465 | +# If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all | |
| 466 | +# undocumented classes that are normally visible in the class hierarchy. If set | |
| 467 | +# to NO these classes will be included in the various overviews. This option has | |
| 468 | +# no effect if EXTRACT_ALL is enabled. | |
| 469 | +# The default value is: NO. | |
| 470 | + | |
| 471 | +HIDE_UNDOC_CLASSES = NO | |
| 472 | + | |
| 473 | +# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend | |
| 474 | +# (class|struct|union) declarations. If set to NO these declarations will be | |
| 475 | +# included in the documentation. | |
| 476 | +# The default value is: NO. | |
| 477 | + | |
| 478 | +HIDE_FRIEND_COMPOUNDS = NO | |
| 479 | + | |
| 480 | +# If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any | |
| 481 | +# documentation blocks found inside the body of a function. If set to NO these | |
| 482 | +# blocks will be appended to the function's detailed documentation block. | |
| 483 | +# The default value is: NO. | |
| 484 | + | |
| 485 | +HIDE_IN_BODY_DOCS = NO | |
| 486 | + | |
| 487 | +# The INTERNAL_DOCS tag determines if documentation that is typed after a | |
| 488 | +# \internal command is included. If the tag is set to NO then the documentation | |
| 489 | +# will be excluded. Set it to YES to include the internal documentation. | |
| 490 | +# The default value is: NO. | |
| 491 | + | |
| 492 | +INTERNAL_DOCS = NO | |
| 493 | + | |
| 494 | +# If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file | |
| 495 | +# names in lower-case letters. If set to YES upper-case letters are also | |
| 496 | +# allowed. This is useful if you have classes or files whose names only differ | |
| 497 | +# in case and if your file system supports case sensitive file names. Windows | |
| 498 | +# and Mac users are advised to set this option to NO. | |
| 499 | +# The default value is: system dependent. | |
| 500 | + | |
| 501 | +CASE_SENSE_NAMES = NO | |
| 502 | + | |
| 503 | +# If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with | |
| 504 | +# their full class and namespace scopes in the documentation. If set to YES the | |
| 505 | +# scope will be hidden. | |
| 506 | +# The default value is: NO. | |
| 507 | + | |
| 508 | +HIDE_SCOPE_NAMES = NO | |
| 509 | + | |
| 510 | +# If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of | |
| 511 | +# the files that are included by a file in the documentation of that file. | |
| 512 | +# The default value is: YES. | |
| 513 | + | |
| 514 | +SHOW_INCLUDE_FILES = YES | |
| 515 | + | |
| 516 | +# If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each | |
| 517 | +# grouped member an include statement to the documentation, telling the reader | |
| 518 | +# which file to include in order to use the member. | |
| 519 | +# The default value is: NO. | |
| 520 | + | |
| 521 | +SHOW_GROUPED_MEMB_INC = NO | |
| 522 | + | |
| 523 | +# If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include | |
| 524 | +# files with double quotes in the documentation rather than with sharp brackets. | |
| 525 | +# The default value is: NO. | |
| 526 | + | |
| 527 | +FORCE_LOCAL_INCLUDES = NO | |
| 528 | + | |
| 529 | +# If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the | |
| 530 | +# documentation for inline members. | |
| 531 | +# The default value is: YES. | |
| 532 | + | |
| 533 | +INLINE_INFO = YES | |
| 534 | + | |
| 535 | +# If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the | |
| 536 | +# (detailed) documentation of file and class members alphabetically by member | |
| 537 | +# name. If set to NO the members will appear in declaration order. | |
| 538 | +# The default value is: YES. | |
| 539 | + | |
| 540 | +SORT_MEMBER_DOCS = YES | |
| 541 | + | |
| 542 | +# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief | |
| 543 | +# descriptions of file, namespace and class members alphabetically by member | |
| 544 | +# name. If set to NO the members will appear in declaration order. Note that | |
| 545 | +# this will also influence the order of the classes in the class list. | |
| 546 | +# The default value is: NO. | |
| 547 | + | |
| 548 | +SORT_BRIEF_DOCS = NO | |
| 549 | + | |
| 550 | +# If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the | |
| 551 | +# (brief and detailed) documentation of class members so that constructors and | |
| 552 | +# destructors are listed first. If set to NO the constructors will appear in the | |
| 553 | +# respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS. | |
| 554 | +# Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief | |
| 555 | +# member documentation. | |
| 556 | +# Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting | |
| 557 | +# detailed member documentation. | |
| 558 | +# The default value is: NO. | |
| 559 | + | |
| 560 | +SORT_MEMBERS_CTORS_1ST = NO | |
| 561 | + | |
| 562 | +# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy | |
| 563 | +# of group names into alphabetical order. If set to NO the group names will | |
| 564 | +# appear in their defined order. | |
| 565 | +# The default value is: NO. | |
| 566 | + | |
| 567 | +SORT_GROUP_NAMES = NO | |
| 568 | + | |
| 569 | +# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by | |
| 570 | +# fully-qualified names, including namespaces. If set to NO, the class list will | |
| 571 | +# be sorted only by class name, not including the namespace part. | |
| 572 | +# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. | |
| 573 | +# Note: This option applies only to the class list, not to the alphabetical | |
| 574 | +# list. | |
| 575 | +# The default value is: NO. | |
| 576 | + | |
| 577 | +SORT_BY_SCOPE_NAME = NO | |
| 578 | + | |
| 579 | +# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper | |
| 580 | +# type resolution of all parameters of a function it will reject a match between | |
| 581 | +# the prototype and the implementation of a member function even if there is | |
| 582 | +# only one candidate or it is obvious which candidate to choose by doing a | |
| 583 | +# simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still | |
| 584 | +# accept a match between prototype and implementation in such cases. | |
| 585 | +# The default value is: NO. | |
| 586 | + | |
| 587 | +STRICT_PROTO_MATCHING = NO | |
| 588 | + | |
| 589 | +# The GENERATE_TODOLIST tag can be used to enable ( YES) or disable ( NO) the | |
| 590 | +# todo list. This list is created by putting \todo commands in the | |
| 591 | +# documentation. | |
| 592 | +# The default value is: YES. | |
| 593 | + | |
| 594 | +GENERATE_TODOLIST = YES | |
| 595 | + | |
| 596 | +# The GENERATE_TESTLIST tag can be used to enable ( YES) or disable ( NO) the | |
| 597 | +# test list. This list is created by putting \test commands in the | |
| 598 | +# documentation. | |
| 599 | +# The default value is: YES. | |
| 600 | + | |
| 601 | +GENERATE_TESTLIST = YES | |
| 602 | + | |
| 603 | +# The GENERATE_BUGLIST tag can be used to enable ( YES) or disable ( NO) the bug | |
| 604 | +# list. This list is created by putting \bug commands in the documentation. | |
| 605 | +# The default value is: YES. | |
| 606 | + | |
| 607 | +GENERATE_BUGLIST = YES | |
| 608 | + | |
| 609 | +# The GENERATE_DEPRECATEDLIST tag can be used to enable ( YES) or disable ( NO) | |
| 610 | +# the deprecated list. This list is created by putting \deprecated commands in | |
| 611 | +# the documentation. | |
| 612 | +# The default value is: YES. | |
| 613 | + | |
| 614 | +GENERATE_DEPRECATEDLIST= YES | |
| 615 | + | |
| 616 | +# The ENABLED_SECTIONS tag can be used to enable conditional documentation | |
| 617 | +# sections, marked by \if <section_label> ... \endif and \cond <section_label> | |
| 618 | +# ... \endcond blocks. | |
| 619 | + | |
| 620 | +ENABLED_SECTIONS = | |
| 621 | + | |
| 622 | +# The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the | |
| 623 | +# initial value of a variable or macro / define can have for it to appear in the | |
| 624 | +# documentation. If the initializer consists of more lines than specified here | |
| 625 | +# it will be hidden. Use a value of 0 to hide initializers completely. The | |
| 626 | +# appearance of the value of individual variables and macros / defines can be | |
| 627 | +# controlled using \showinitializer or \hideinitializer command in the | |
| 628 | +# documentation regardless of this setting. | |
| 629 | +# Minimum value: 0, maximum value: 10000, default value: 30. | |
| 630 | + | |
| 631 | +MAX_INITIALIZER_LINES = 30 | |
| 632 | + | |
| 633 | +# Set the SHOW_USED_FILES tag to NO to disable the list of files generated at | |
| 634 | +# the bottom of the documentation of classes and structs. If set to YES the list | |
| 635 | +# will mention the files that were used to generate the documentation. | |
| 636 | +# The default value is: YES. | |
| 637 | + | |
| 638 | +SHOW_USED_FILES = YES | |
| 639 | + | |
| 640 | +# Set the SHOW_FILES tag to NO to disable the generation of the Files page. This | |
| 641 | +# will remove the Files entry from the Quick Index and from the Folder Tree View | |
| 642 | +# (if specified). | |
| 643 | +# The default value is: YES. | |
| 644 | + | |
| 645 | +SHOW_FILES = YES | |
| 646 | + | |
| 647 | +# Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces | |
| 648 | +# page. This will remove the Namespaces entry from the Quick Index and from the | |
| 649 | +# Folder Tree View (if specified). | |
| 650 | +# The default value is: YES. | |
| 651 | + | |
| 652 | +SHOW_NAMESPACES = YES | |
| 653 | + | |
| 654 | +# The FILE_VERSION_FILTER tag can be used to specify a program or script that | |
| 655 | +# doxygen should invoke to get the current version for each file (typically from | |
| 656 | +# the version control system). Doxygen will invoke the program by executing (via | |
| 657 | +# popen()) the command command input-file, where command is the value of the | |
| 658 | +# FILE_VERSION_FILTER tag, and input-file is the name of an input file provided | |
| 659 | +# by doxygen. Whatever the program writes to standard output is used as the file | |
| 660 | +# version. For an example see the documentation. | |
| 661 | + | |
| 662 | +FILE_VERSION_FILTER = | |
| 663 | + | |
| 664 | +# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed | |
| 665 | +# by doxygen. The layout file controls the global structure of the generated | |
| 666 | +# output files in an output format independent way. To create the layout file | |
| 667 | +# that represents doxygen's defaults, run doxygen with the -l option. You can | |
| 668 | +# optionally specify a file name after the option, if omitted DoxygenLayout.xml | |
| 669 | +# will be used as the name of the layout file. | |
| 670 | +# | |
| 671 | +# Note that if you run doxygen from a directory containing a file called | |
| 672 | +# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE | |
| 673 | +# tag is left empty. | |
| 674 | + | |
| 675 | +LAYOUT_FILE = | |
| 676 | + | |
| 677 | +# The CITE_BIB_FILES tag can be used to specify one or more bib files containing | |
| 678 | +# the reference definitions. This must be a list of .bib files. The .bib | |
| 679 | +# extension is automatically appended if omitted. This requires the bibtex tool | |
| 680 | +# to be installed. See also http://en.wikipedia.org/wiki/BibTeX for more info. | |
| 681 | +# For LaTeX the style of the bibliography can be controlled using | |
| 682 | +# LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the | |
| 683 | +# search path. See also \cite for info how to create references. | |
| 684 | + | |
| 685 | +CITE_BIB_FILES = | |
| 686 | + | |
| 687 | +#--------------------------------------------------------------------------- | |
| 688 | +# Configuration options related to warning and progress messages | |
| 689 | +#--------------------------------------------------------------------------- | |
| 690 | + | |
| 691 | +# The QUIET tag can be used to turn on/off the messages that are generated to | |
| 692 | +# standard output by doxygen. If QUIET is set to YES this implies that the | |
| 693 | +# messages are off. | |
| 694 | +# The default value is: NO. | |
| 695 | + | |
| 696 | +QUIET = NO | |
| 697 | + | |
| 698 | +# The WARNINGS tag can be used to turn on/off the warning messages that are | |
| 699 | +# generated to standard error ( stderr) by doxygen. If WARNINGS is set to YES | |
| 700 | +# this implies that the warnings are on. | |
| 701 | +# | |
| 702 | +# Tip: Turn warnings on while writing the documentation. | |
| 703 | +# The default value is: YES. | |
| 704 | + | |
| 705 | +WARNINGS = YES | |
| 706 | + | |
| 707 | +# If the WARN_IF_UNDOCUMENTED tag is set to YES, then doxygen will generate | |
| 708 | +# warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag | |
| 709 | +# will automatically be disabled. | |
| 710 | +# The default value is: YES. | |
| 711 | + | |
| 712 | +WARN_IF_UNDOCUMENTED = YES | |
| 713 | + | |
| 714 | +# If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for | |
| 715 | +# potential errors in the documentation, such as not documenting some parameters | |
| 716 | +# in a documented function, or documenting parameters that don't exist or using | |
| 717 | +# markup commands wrongly. | |
| 718 | +# The default value is: YES. | |
| 719 | + | |
| 720 | +WARN_IF_DOC_ERROR = YES | |
| 721 | + | |
| 722 | +# This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that | |
| 723 | +# are documented, but have no documentation for their parameters or return | |
| 724 | +# value. If set to NO doxygen will only warn about wrong or incomplete parameter | |
| 725 | +# documentation, but not about the absence of documentation. | |
| 726 | +# The default value is: NO. | |
| 727 | + | |
| 728 | +WARN_NO_PARAMDOC = NO | |
| 729 | + | |
| 730 | +# The WARN_FORMAT tag determines the format of the warning messages that doxygen | |
| 731 | +# can produce. The string should contain the $file, $line, and $text tags, which | |
| 732 | +# will be replaced by the file and line number from which the warning originated | |
| 733 | +# and the warning text. Optionally the format may contain $version, which will | |
| 734 | +# be replaced by the version of the file (if it could be obtained via | |
| 735 | +# FILE_VERSION_FILTER) | |
| 736 | +# The default value is: $file:$line: $text. | |
| 737 | + | |
| 738 | +WARN_FORMAT = "$file:$line: $text" | |
| 739 | + | |
| 740 | +# The WARN_LOGFILE tag can be used to specify a file to which warning and error | |
| 741 | +# messages should be written. If left blank the output is written to standard | |
| 742 | +# error (stderr). | |
| 743 | + | |
| 744 | +WARN_LOGFILE = | |
| 745 | + | |
| 746 | +#--------------------------------------------------------------------------- | |
| 747 | +# Configuration options related to the input files | |
| 748 | +#--------------------------------------------------------------------------- | |
| 749 | + | |
| 750 | +# The INPUT tag is used to specify the files and/or directories that contain | |
| 751 | +# documented source files. You may enter file names like myfile.cpp or | |
| 752 | +# directories like /usr/src/myproject. Separate the files or directories with | |
| 753 | +# spaces. | |
| 754 | +# Note: If this tag is empty the current directory is searched. | |
| 755 | + | |
| 756 | +INPUT = readme.md \ | |
| 757 | + changelog.md \ | |
| 758 | + roadmap.md \ | |
| 759 | + websocketpp \ | |
| 760 | + tutorials \ | |
| 761 | + docs | |
| 762 | + | |
| 763 | +# This tag can be used to specify the character encoding of the source files | |
| 764 | +# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses | |
| 765 | +# libiconv (or the iconv built into libc) for the transcoding. See the libiconv | |
| 766 | +# documentation (see: http://www.gnu.org/software/libiconv) for the list of | |
| 767 | +# possible encodings. | |
| 768 | +# The default value is: UTF-8. | |
| 769 | + | |
| 770 | +INPUT_ENCODING = UTF-8 | |
| 771 | + | |
| 772 | +# If the value of the INPUT tag contains directories, you can use the | |
| 773 | +# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and | |
| 774 | +# *.h) to filter out the source-files in the directories. If left blank the | |
| 775 | +# following patterns are tested:*.c, *.cc, *.cxx, *.cpp, *.c++, *.java, *.ii, | |
| 776 | +# *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, *.hh, *.hxx, *.hpp, | |
| 777 | +# *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, *.m, *.markdown, | |
| 778 | +# *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf, | |
| 779 | +# *.qsf, *.as and *.js. | |
| 780 | + | |
| 781 | +FILE_PATTERNS = | |
| 782 | + | |
| 783 | +# The RECURSIVE tag can be used to specify whether or not subdirectories should | |
| 784 | +# be searched for input files as well. | |
| 785 | +# The default value is: NO. | |
| 786 | + | |
| 787 | +RECURSIVE = YES | |
| 788 | + | |
| 789 | +# The EXCLUDE tag can be used to specify files and/or directories that should be | |
| 790 | +# excluded from the INPUT source files. This way you can easily exclude a | |
| 791 | +# subdirectory from a directory tree whose root is specified with the INPUT tag. | |
| 792 | +# | |
| 793 | +# Note that relative paths are relative to the directory from which doxygen is | |
| 794 | +# run. | |
| 795 | + | |
| 796 | +EXCLUDE = build | |
| 797 | + | |
| 798 | +# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or | |
| 799 | +# directories that are symbolic links (a Unix file system feature) are excluded | |
| 800 | +# from the input. | |
| 801 | +# The default value is: NO. | |
| 802 | + | |
| 803 | +EXCLUDE_SYMLINKS = NO | |
| 804 | + | |
| 805 | +# If the value of the INPUT tag contains directories, you can use the | |
| 806 | +# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude | |
| 807 | +# certain files from those directories. | |
| 808 | +# | |
| 809 | +# Note that the wildcards are matched against the file with absolute path, so to | |
| 810 | +# exclude all test directories for example use the pattern */test/* | |
| 811 | + | |
| 812 | +EXCLUDE_PATTERNS = | |
| 813 | + | |
| 814 | +# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names | |
| 815 | +# (namespaces, classes, functions, etc.) that should be excluded from the | |
| 816 | +# output. The symbol name can be a fully qualified name, a word, or if the | |
| 817 | +# wildcard * is used, a substring. Examples: ANamespace, AClass, | |
| 818 | +# AClass::ANamespace, ANamespace::*Test | |
| 819 | +# | |
| 820 | +# Note that the wildcards are matched against the file with absolute path, so to | |
| 821 | +# exclude all test directories use the pattern */test/* | |
| 822 | + | |
| 823 | +EXCLUDE_SYMBOLS = | |
| 824 | + | |
| 825 | +# The EXAMPLE_PATH tag can be used to specify one or more files or directories | |
| 826 | +# that contain example code fragments that are included (see the \include | |
| 827 | +# command). | |
| 828 | + | |
| 829 | +EXAMPLE_PATH = | |
| 830 | + | |
| 831 | +# If the value of the EXAMPLE_PATH tag contains directories, you can use the | |
| 832 | +# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and | |
| 833 | +# *.h) to filter out the source-files in the directories. If left blank all | |
| 834 | +# files are included. | |
| 835 | + | |
| 836 | +EXAMPLE_PATTERNS = | |
| 837 | + | |
| 838 | +# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be | |
| 839 | +# searched for input files to be used with the \include or \dontinclude commands | |
| 840 | +# irrespective of the value of the RECURSIVE tag. | |
| 841 | +# The default value is: NO. | |
| 842 | + | |
| 843 | +EXAMPLE_RECURSIVE = NO | |
| 844 | + | |
| 845 | +# The IMAGE_PATH tag can be used to specify one or more files or directories | |
| 846 | +# that contain images that are to be included in the documentation (see the | |
| 847 | +# \image command). | |
| 848 | + | |
| 849 | +IMAGE_PATH = | |
| 850 | + | |
| 851 | +# The INPUT_FILTER tag can be used to specify a program that doxygen should | |
| 852 | +# invoke to filter for each input file. Doxygen will invoke the filter program | |
| 853 | +# by executing (via popen()) the command: | |
| 854 | +# | |
| 855 | +# <filter> <input-file> | |
| 856 | +# | |
| 857 | +# where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the | |
| 858 | +# name of an input file. Doxygen will then use the output that the filter | |
| 859 | +# program writes to standard output. If FILTER_PATTERNS is specified, this tag | |
| 860 | +# will be ignored. | |
| 861 | +# | |
| 862 | +# Note that the filter must not add or remove lines; it is applied before the | |
| 863 | +# code is scanned, but not when the output code is generated. If lines are added | |
| 864 | +# or removed, the anchors will not be placed correctly. | |
| 865 | + | |
| 866 | +INPUT_FILTER = | |
| 867 | + | |
| 868 | +# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern | |
| 869 | +# basis. Doxygen will compare the file name with each pattern and apply the | |
| 870 | +# filter if there is a match. The filters are a list of the form: pattern=filter | |
| 871 | +# (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how | |
| 872 | +# filters are used. If the FILTER_PATTERNS tag is empty or if none of the | |
| 873 | +# patterns match the file name, INPUT_FILTER is applied. | |
| 874 | + | |
| 875 | +FILTER_PATTERNS = | |
| 876 | + | |
| 877 | +# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using | |
| 878 | +# INPUT_FILTER ) will also be used to filter the input files that are used for | |
| 879 | +# producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES). | |
| 880 | +# The default value is: NO. | |
| 881 | + | |
| 882 | +FILTER_SOURCE_FILES = NO | |
| 883 | + | |
| 884 | +# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file | |
| 885 | +# pattern. A pattern will override the setting for FILTER_PATTERN (if any) and | |
| 886 | +# it is also possible to disable source filtering for a specific pattern using | |
| 887 | +# *.ext= (so without naming a filter). | |
| 888 | +# This tag requires that the tag FILTER_SOURCE_FILES is set to YES. | |
| 889 | + | |
| 890 | +FILTER_SOURCE_PATTERNS = | |
| 891 | + | |
| 892 | +# If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that | |
| 893 | +# is part of the input, its contents will be placed on the main page | |
| 894 | +# (index.html). This can be useful if you have a project on for instance GitHub | |
| 895 | +# and want to reuse the introduction page also for the doxygen output. | |
| 896 | + | |
| 897 | +USE_MDFILE_AS_MAINPAGE = | |
| 898 | + | |
| 899 | +#--------------------------------------------------------------------------- | |
| 900 | +# Configuration options related to source browsing | |
| 901 | +#--------------------------------------------------------------------------- | |
| 902 | + | |
| 903 | +# If the SOURCE_BROWSER tag is set to YES then a list of source files will be | |
| 904 | +# generated. Documented entities will be cross-referenced with these sources. | |
| 905 | +# | |
| 906 | +# Note: To get rid of all source code in the generated output, make sure that | |
| 907 | +# also VERBATIM_HEADERS is set to NO. | |
| 908 | +# The default value is: NO. | |
| 909 | + | |
| 910 | +SOURCE_BROWSER = YES | |
| 911 | + | |
| 912 | +# Setting the INLINE_SOURCES tag to YES will include the body of functions, | |
| 913 | +# classes and enums directly into the documentation. | |
| 914 | +# The default value is: NO. | |
| 915 | + | |
| 916 | +INLINE_SOURCES = NO | |
| 917 | + | |
| 918 | +# Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any | |
| 919 | +# special comment blocks from generated source code fragments. Normal C, C++ and | |
| 920 | +# Fortran comments will always remain visible. | |
| 921 | +# The default value is: YES. | |
| 922 | + | |
| 923 | +STRIP_CODE_COMMENTS = YES | |
| 924 | + | |
| 925 | +# If the REFERENCED_BY_RELATION tag is set to YES then for each documented | |
| 926 | +# function all documented functions referencing it will be listed. | |
| 927 | +# The default value is: NO. | |
| 928 | + | |
| 929 | +REFERENCED_BY_RELATION = NO | |
| 930 | + | |
| 931 | +# If the REFERENCES_RELATION tag is set to YES then for each documented function | |
| 932 | +# all documented entities called/used by that function will be listed. | |
| 933 | +# The default value is: NO. | |
| 934 | + | |
| 935 | +REFERENCES_RELATION = NO | |
| 936 | + | |
| 937 | +# If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set | |
| 938 | +# to YES, then the hyperlinks from functions in REFERENCES_RELATION and | |
| 939 | +# REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will | |
| 940 | +# link to the documentation. | |
| 941 | +# The default value is: YES. | |
| 942 | + | |
| 943 | +REFERENCES_LINK_SOURCE = YES | |
| 944 | + | |
| 945 | +# If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the | |
| 946 | +# source code will show a tooltip with additional information such as prototype, | |
| 947 | +# brief description and links to the definition and documentation. Since this | |
| 948 | +# will make the HTML file larger and loading of large files a bit slower, you | |
| 949 | +# can opt to disable this feature. | |
| 950 | +# The default value is: YES. | |
| 951 | +# This tag requires that the tag SOURCE_BROWSER is set to YES. | |
| 952 | + | |
| 953 | +SOURCE_TOOLTIPS = YES | |
| 954 | + | |
| 955 | +# If the USE_HTAGS tag is set to YES then the references to source code will | |
| 956 | +# point to the HTML generated by the htags(1) tool instead of doxygen built-in | |
| 957 | +# source browser. The htags tool is part of GNU's global source tagging system | |
| 958 | +# (see http://www.gnu.org/software/global/global.html). You will need version | |
| 959 | +# 4.8.6 or higher. | |
| 960 | +# | |
| 961 | +# To use it do the following: | |
| 962 | +# - Install the latest version of global | |
| 963 | +# - Enable SOURCE_BROWSER and USE_HTAGS in the config file | |
| 964 | +# - Make sure the INPUT points to the root of the source tree | |
| 965 | +# - Run doxygen as normal | |
| 966 | +# | |
| 967 | +# Doxygen will invoke htags (and that will in turn invoke gtags), so these | |
| 968 | +# tools must be available from the command line (i.e. in the search path). | |
| 969 | +# | |
| 970 | +# The result: instead of the source browser generated by doxygen, the links to | |
| 971 | +# source code will now point to the output of htags. | |
| 972 | +# The default value is: NO. | |
| 973 | +# This tag requires that the tag SOURCE_BROWSER is set to YES. | |
| 974 | + | |
| 975 | +USE_HTAGS = NO | |
| 976 | + | |
| 977 | +# If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a | |
| 978 | +# verbatim copy of the header file for each class for which an include is | |
| 979 | +# specified. Set to NO to disable this. | |
| 980 | +# See also: Section \class. | |
| 981 | +# The default value is: YES. | |
| 982 | + | |
| 983 | +VERBATIM_HEADERS = YES | |
| 984 | + | |
| 985 | +# If the CLANG_ASSISTED_PARSING tag is set to YES, then doxygen will use the | |
| 986 | +# clang parser (see: http://clang.llvm.org/) for more accurate parsing at the | |
| 987 | +# cost of reduced performance. This can be particularly helpful with template | |
| 988 | +# rich C++ code for which doxygen's built-in parser lacks the necessary type | |
| 989 | +# information. | |
| 990 | +# Note: The availability of this option depends on whether or not doxygen was | |
| 991 | +# compiled with the --with-libclang option. | |
| 992 | +# The default value is: NO. | |
| 993 | + | |
| 994 | +CLANG_ASSISTED_PARSING = YES | |
| 995 | + | |
| 996 | +# If clang assisted parsing is enabled you can provide the compiler with command | |
| 997 | +# line options that you would normally use when invoking the compiler. Note that | |
| 998 | +# the include paths will already be set by doxygen for the files and directories | |
| 999 | +# specified with INPUT and INCLUDE_PATH. | |
| 1000 | +# This tag requires that the tag CLANG_ASSISTED_PARSING is set to YES. | |
| 1001 | + | |
| 1002 | +CLANG_OPTIONS = | |
| 1003 | + | |
| 1004 | +#--------------------------------------------------------------------------- | |
| 1005 | +# Configuration options related to the alphabetical class index | |
| 1006 | +#--------------------------------------------------------------------------- | |
| 1007 | + | |
| 1008 | +# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all | |
| 1009 | +# compounds will be generated. Enable this if the project contains a lot of | |
| 1010 | +# classes, structs, unions or interfaces. | |
| 1011 | +# The default value is: YES. | |
| 1012 | + | |
| 1013 | +ALPHABETICAL_INDEX = YES | |
| 1014 | + | |
| 1015 | +# The COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns in | |
| 1016 | +# which the alphabetical index list will be split. | |
| 1017 | +# Minimum value: 1, maximum value: 20, default value: 5. | |
| 1018 | +# This tag requires that the tag ALPHABETICAL_INDEX is set to YES. | |
| 1019 | + | |
| 1020 | +COLS_IN_ALPHA_INDEX = 5 | |
| 1021 | + | |
| 1022 | +# In case all classes in a project start with a common prefix, all classes will | |
| 1023 | +# be put under the same header in the alphabetical index. The IGNORE_PREFIX tag | |
| 1024 | +# can be used to specify a prefix (or a list of prefixes) that should be ignored | |
| 1025 | +# while generating the index headers. | |
| 1026 | +# This tag requires that the tag ALPHABETICAL_INDEX is set to YES. | |
| 1027 | + | |
| 1028 | +IGNORE_PREFIX = | |
| 1029 | + | |
| 1030 | +#--------------------------------------------------------------------------- | |
| 1031 | +# Configuration options related to the HTML output | |
| 1032 | +#--------------------------------------------------------------------------- | |
| 1033 | + | |
| 1034 | +# If the GENERATE_HTML tag is set to YES doxygen will generate HTML output | |
| 1035 | +# The default value is: YES. | |
| 1036 | + | |
| 1037 | +GENERATE_HTML = YES | |
| 1038 | + | |
| 1039 | +# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a | |
| 1040 | +# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of | |
| 1041 | +# it. | |
| 1042 | +# The default directory is: html. | |
| 1043 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1044 | + | |
| 1045 | +HTML_OUTPUT = html | |
| 1046 | + | |
| 1047 | +# The HTML_FILE_EXTENSION tag can be used to specify the file extension for each | |
| 1048 | +# generated HTML page (for example: .htm, .php, .asp). | |
| 1049 | +# The default value is: .html. | |
| 1050 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1051 | + | |
| 1052 | +HTML_FILE_EXTENSION = .html | |
| 1053 | + | |
| 1054 | +# The HTML_HEADER tag can be used to specify a user-defined HTML header file for | |
| 1055 | +# each generated HTML page. If the tag is left blank doxygen will generate a | |
| 1056 | +# standard header. | |
| 1057 | +# | |
| 1058 | +# To get valid HTML the header file that includes any scripts and style sheets | |
| 1059 | +# that doxygen needs, which is dependent on the configuration options used (e.g. | |
| 1060 | +# the setting GENERATE_TREEVIEW). It is highly recommended to start with a | |
| 1061 | +# default header using | |
| 1062 | +# doxygen -w html new_header.html new_footer.html new_stylesheet.css | |
| 1063 | +# YourConfigFile | |
| 1064 | +# and then modify the file new_header.html. See also section "Doxygen usage" | |
| 1065 | +# for information on how to generate the default header that doxygen normally | |
| 1066 | +# uses. | |
| 1067 | +# Note: The header is subject to change so you typically have to regenerate the | |
| 1068 | +# default header when upgrading to a newer version of doxygen. For a description | |
| 1069 | +# of the possible markers and block names see the documentation. | |
| 1070 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1071 | + | |
| 1072 | +HTML_HEADER = | |
| 1073 | + | |
| 1074 | +# The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each | |
| 1075 | +# generated HTML page. If the tag is left blank doxygen will generate a standard | |
| 1076 | +# footer. See HTML_HEADER for more information on how to generate a default | |
| 1077 | +# footer and what special commands can be used inside the footer. See also | |
| 1078 | +# section "Doxygen usage" for information on how to generate the default footer | |
| 1079 | +# that doxygen normally uses. | |
| 1080 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1081 | + | |
| 1082 | +HTML_FOOTER = | |
| 1083 | + | |
| 1084 | +# The HTML_STYLESHEET tag can be used to specify a user-defined cascading style | |
| 1085 | +# sheet that is used by each HTML page. It can be used to fine-tune the look of | |
| 1086 | +# the HTML output. If left blank doxygen will generate a default style sheet. | |
| 1087 | +# See also section "Doxygen usage" for information on how to generate the style | |
| 1088 | +# sheet that doxygen normally uses. | |
| 1089 | +# Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as | |
| 1090 | +# it is more robust and this tag (HTML_STYLESHEET) will in the future become | |
| 1091 | +# obsolete. | |
| 1092 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1093 | + | |
| 1094 | +HTML_STYLESHEET = | |
| 1095 | + | |
| 1096 | +# The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined | |
| 1097 | +# cascading style sheets that are included after the standard style sheets | |
| 1098 | +# created by doxygen. Using this option one can overrule certain style aspects. | |
| 1099 | +# This is preferred over using HTML_STYLESHEET since it does not replace the | |
| 1100 | +# standard style sheet and is therefor more robust against future updates. | |
| 1101 | +# Doxygen will copy the style sheet files to the output directory. | |
| 1102 | +# Note: The order of the extra stylesheet files is of importance (e.g. the last | |
| 1103 | +# stylesheet in the list overrules the setting of the previous ones in the | |
| 1104 | +# list). For an example see the documentation. | |
| 1105 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1106 | + | |
| 1107 | +HTML_EXTRA_STYLESHEET = docs/manual.css | |
| 1108 | + | |
| 1109 | +# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or | |
| 1110 | +# other source files which should be copied to the HTML output directory. Note | |
| 1111 | +# that these files will be copied to the base HTML output directory. Use the | |
| 1112 | +# $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these | |
| 1113 | +# files. In the HTML_STYLESHEET file, use the file name only. Also note that the | |
| 1114 | +# files will be copied as-is; there are no commands or markers available. | |
| 1115 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1116 | + | |
| 1117 | +HTML_EXTRA_FILES = | |
| 1118 | + | |
| 1119 | +# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen | |
| 1120 | +# will adjust the colors in the stylesheet and background images according to | |
| 1121 | +# this color. Hue is specified as an angle on a colorwheel, see | |
| 1122 | +# http://en.wikipedia.org/wiki/Hue for more information. For instance the value | |
| 1123 | +# 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300 | |
| 1124 | +# purple, and 360 is red again. | |
| 1125 | +# Minimum value: 0, maximum value: 359, default value: 220. | |
| 1126 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1127 | + | |
| 1128 | +HTML_COLORSTYLE_HUE = 236 | |
| 1129 | + | |
| 1130 | +# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors | |
| 1131 | +# in the HTML output. For a value of 0 the output will use grayscales only. A | |
| 1132 | +# value of 255 will produce the most vivid colors. | |
| 1133 | +# Minimum value: 0, maximum value: 255, default value: 100. | |
| 1134 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1135 | + | |
| 1136 | +HTML_COLORSTYLE_SAT = 0 | |
| 1137 | + | |
| 1138 | +# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the | |
| 1139 | +# luminance component of the colors in the HTML output. Values below 100 | |
| 1140 | +# gradually make the output lighter, whereas values above 100 make the output | |
| 1141 | +# darker. The value divided by 100 is the actual gamma applied, so 80 represents | |
| 1142 | +# a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not | |
| 1143 | +# change the gamma. | |
| 1144 | +# Minimum value: 40, maximum value: 240, default value: 80. | |
| 1145 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1146 | + | |
| 1147 | +HTML_COLORSTYLE_GAMMA = 148 | |
| 1148 | + | |
| 1149 | +# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML | |
| 1150 | +# page will contain the date and time when the page was generated. Setting this | |
| 1151 | +# to NO can help when comparing the output of multiple runs. | |
| 1152 | +# The default value is: YES. | |
| 1153 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1154 | + | |
| 1155 | +HTML_TIMESTAMP = NO | |
| 1156 | + | |
| 1157 | +# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML | |
| 1158 | +# documentation will contain sections that can be hidden and shown after the | |
| 1159 | +# page has loaded. | |
| 1160 | +# The default value is: NO. | |
| 1161 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1162 | + | |
| 1163 | +HTML_DYNAMIC_SECTIONS = NO | |
| 1164 | + | |
| 1165 | +# With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries | |
| 1166 | +# shown in the various tree structured indices initially; the user can expand | |
| 1167 | +# and collapse entries dynamically later on. Doxygen will expand the tree to | |
| 1168 | +# such a level that at most the specified number of entries are visible (unless | |
| 1169 | +# a fully collapsed tree already exceeds this amount). So setting the number of | |
| 1170 | +# entries 1 will produce a full collapsed tree by default. 0 is a special value | |
| 1171 | +# representing an infinite number of entries and will result in a full expanded | |
| 1172 | +# tree by default. | |
| 1173 | +# Minimum value: 0, maximum value: 9999, default value: 100. | |
| 1174 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1175 | + | |
| 1176 | +HTML_INDEX_NUM_ENTRIES = 100 | |
| 1177 | + | |
| 1178 | +# If the GENERATE_DOCSET tag is set to YES, additional index files will be | |
| 1179 | +# generated that can be used as input for Apple's Xcode 3 integrated development | |
| 1180 | +# environment (see: http://developer.apple.com/tools/xcode/), introduced with | |
| 1181 | +# OSX 10.5 (Leopard). To create a documentation set, doxygen will generate a | |
| 1182 | +# Makefile in the HTML output directory. Running make will produce the docset in | |
| 1183 | +# that directory and running make install will install the docset in | |
| 1184 | +# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at | |
| 1185 | +# startup. See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html | |
| 1186 | +# for more information. | |
| 1187 | +# The default value is: NO. | |
| 1188 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1189 | + | |
| 1190 | +GENERATE_DOCSET = NO | |
| 1191 | + | |
| 1192 | +# This tag determines the name of the docset feed. A documentation feed provides | |
| 1193 | +# an umbrella under which multiple documentation sets from a single provider | |
| 1194 | +# (such as a company or product suite) can be grouped. | |
| 1195 | +# The default value is: Doxygen generated docs. | |
| 1196 | +# This tag requires that the tag GENERATE_DOCSET is set to YES. | |
| 1197 | + | |
| 1198 | +DOCSET_FEEDNAME = "Doxygen generated docs" | |
| 1199 | + | |
| 1200 | +# This tag specifies a string that should uniquely identify the documentation | |
| 1201 | +# set bundle. This should be a reverse domain-name style string, e.g. | |
| 1202 | +# com.mycompany.MyDocSet. Doxygen will append .docset to the name. | |
| 1203 | +# The default value is: org.doxygen.Project. | |
| 1204 | +# This tag requires that the tag GENERATE_DOCSET is set to YES. | |
| 1205 | + | |
| 1206 | +DOCSET_BUNDLE_ID = org.doxygen.Project | |
| 1207 | + | |
| 1208 | +# The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify | |
| 1209 | +# the documentation publisher. This should be a reverse domain-name style | |
| 1210 | +# string, e.g. com.mycompany.MyDocSet.documentation. | |
| 1211 | +# The default value is: org.doxygen.Publisher. | |
| 1212 | +# This tag requires that the tag GENERATE_DOCSET is set to YES. | |
| 1213 | + | |
| 1214 | +DOCSET_PUBLISHER_ID = org.doxygen.Publisher | |
| 1215 | + | |
| 1216 | +# The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher. | |
| 1217 | +# The default value is: Publisher. | |
| 1218 | +# This tag requires that the tag GENERATE_DOCSET is set to YES. | |
| 1219 | + | |
| 1220 | +DOCSET_PUBLISHER_NAME = Publisher | |
| 1221 | + | |
| 1222 | +# If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three | |
| 1223 | +# additional HTML index files: index.hhp, index.hhc, and index.hhk. The | |
| 1224 | +# index.hhp is a project file that can be read by Microsoft's HTML Help Workshop | |
| 1225 | +# (see: http://www.microsoft.com/en-us/download/details.aspx?id=21138) on | |
| 1226 | +# Windows. | |
| 1227 | +# | |
| 1228 | +# The HTML Help Workshop contains a compiler that can convert all HTML output | |
| 1229 | +# generated by doxygen into a single compiled HTML file (.chm). Compiled HTML | |
| 1230 | +# files are now used as the Windows 98 help format, and will replace the old | |
| 1231 | +# Windows help format (.hlp) on all Windows platforms in the future. Compressed | |
| 1232 | +# HTML files also contain an index, a table of contents, and you can search for | |
| 1233 | +# words in the documentation. The HTML workshop also contains a viewer for | |
| 1234 | +# compressed HTML files. | |
| 1235 | +# The default value is: NO. | |
| 1236 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1237 | + | |
| 1238 | +GENERATE_HTMLHELP = NO | |
| 1239 | + | |
| 1240 | +# The CHM_FILE tag can be used to specify the file name of the resulting .chm | |
| 1241 | +# file. You can add a path in front of the file if the result should not be | |
| 1242 | +# written to the html output directory. | |
| 1243 | +# This tag requires that the tag GENERATE_HTMLHELP is set to YES. | |
| 1244 | + | |
| 1245 | +CHM_FILE = | |
| 1246 | + | |
| 1247 | +# The HHC_LOCATION tag can be used to specify the location (absolute path | |
| 1248 | +# including file name) of the HTML help compiler ( hhc.exe). If non-empty | |
| 1249 | +# doxygen will try to run the HTML help compiler on the generated index.hhp. | |
| 1250 | +# The file has to be specified with full path. | |
| 1251 | +# This tag requires that the tag GENERATE_HTMLHELP is set to YES. | |
| 1252 | + | |
| 1253 | +HHC_LOCATION = | |
| 1254 | + | |
| 1255 | +# The GENERATE_CHI flag controls if a separate .chi index file is generated ( | |
| 1256 | +# YES) or that it should be included in the master .chm file ( NO). | |
| 1257 | +# The default value is: NO. | |
| 1258 | +# This tag requires that the tag GENERATE_HTMLHELP is set to YES. | |
| 1259 | + | |
| 1260 | +GENERATE_CHI = NO | |
| 1261 | + | |
| 1262 | +# The CHM_INDEX_ENCODING is used to encode HtmlHelp index ( hhk), content ( hhc) | |
| 1263 | +# and project file content. | |
| 1264 | +# This tag requires that the tag GENERATE_HTMLHELP is set to YES. | |
| 1265 | + | |
| 1266 | +CHM_INDEX_ENCODING = | |
| 1267 | + | |
| 1268 | +# The BINARY_TOC flag controls whether a binary table of contents is generated ( | |
| 1269 | +# YES) or a normal table of contents ( NO) in the .chm file. Furthermore it | |
| 1270 | +# enables the Previous and Next buttons. | |
| 1271 | +# The default value is: NO. | |
| 1272 | +# This tag requires that the tag GENERATE_HTMLHELP is set to YES. | |
| 1273 | + | |
| 1274 | +BINARY_TOC = NO | |
| 1275 | + | |
| 1276 | +# The TOC_EXPAND flag can be set to YES to add extra items for group members to | |
| 1277 | +# the table of contents of the HTML help documentation and to the tree view. | |
| 1278 | +# The default value is: NO. | |
| 1279 | +# This tag requires that the tag GENERATE_HTMLHELP is set to YES. | |
| 1280 | + | |
| 1281 | +TOC_EXPAND = NO | |
| 1282 | + | |
| 1283 | +# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and | |
| 1284 | +# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that | |
| 1285 | +# can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help | |
| 1286 | +# (.qch) of the generated HTML documentation. | |
| 1287 | +# The default value is: NO. | |
| 1288 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1289 | + | |
| 1290 | +GENERATE_QHP = NO | |
| 1291 | + | |
| 1292 | +# If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify | |
| 1293 | +# the file name of the resulting .qch file. The path specified is relative to | |
| 1294 | +# the HTML output folder. | |
| 1295 | +# This tag requires that the tag GENERATE_QHP is set to YES. | |
| 1296 | + | |
| 1297 | +QCH_FILE = | |
| 1298 | + | |
| 1299 | +# The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help | |
| 1300 | +# Project output. For more information please see Qt Help Project / Namespace | |
| 1301 | +# (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#namespace). | |
| 1302 | +# The default value is: org.doxygen.Project. | |
| 1303 | +# This tag requires that the tag GENERATE_QHP is set to YES. | |
| 1304 | + | |
| 1305 | +QHP_NAMESPACE = org.doxygen.Project | |
| 1306 | + | |
| 1307 | +# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt | |
| 1308 | +# Help Project output. For more information please see Qt Help Project / Virtual | |
| 1309 | +# Folders (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#virtual- | |
| 1310 | +# folders). | |
| 1311 | +# The default value is: doc. | |
| 1312 | +# This tag requires that the tag GENERATE_QHP is set to YES. | |
| 1313 | + | |
| 1314 | +QHP_VIRTUAL_FOLDER = doc | |
| 1315 | + | |
| 1316 | +# If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom | |
| 1317 | +# filter to add. For more information please see Qt Help Project / Custom | |
| 1318 | +# Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom- | |
| 1319 | +# filters). | |
| 1320 | +# This tag requires that the tag GENERATE_QHP is set to YES. | |
| 1321 | + | |
| 1322 | +QHP_CUST_FILTER_NAME = | |
| 1323 | + | |
| 1324 | +# The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the | |
| 1325 | +# custom filter to add. For more information please see Qt Help Project / Custom | |
| 1326 | +# Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom- | |
| 1327 | +# filters). | |
| 1328 | +# This tag requires that the tag GENERATE_QHP is set to YES. | |
| 1329 | + | |
| 1330 | +QHP_CUST_FILTER_ATTRS = | |
| 1331 | + | |
| 1332 | +# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this | |
| 1333 | +# project's filter section matches. Qt Help Project / Filter Attributes (see: | |
| 1334 | +# http://qt-project.org/doc/qt-4.8/qthelpproject.html#filter-attributes). | |
| 1335 | +# This tag requires that the tag GENERATE_QHP is set to YES. | |
| 1336 | + | |
| 1337 | +QHP_SECT_FILTER_ATTRS = | |
| 1338 | + | |
| 1339 | +# The QHG_LOCATION tag can be used to specify the location of Qt's | |
| 1340 | +# qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the | |
| 1341 | +# generated .qhp file. | |
| 1342 | +# This tag requires that the tag GENERATE_QHP is set to YES. | |
| 1343 | + | |
| 1344 | +QHG_LOCATION = | |
| 1345 | + | |
| 1346 | +# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be | |
| 1347 | +# generated, together with the HTML files, they form an Eclipse help plugin. To | |
| 1348 | +# install this plugin and make it available under the help contents menu in | |
| 1349 | +# Eclipse, the contents of the directory containing the HTML and XML files needs | |
| 1350 | +# to be copied into the plugins directory of eclipse. The name of the directory | |
| 1351 | +# within the plugins directory should be the same as the ECLIPSE_DOC_ID value. | |
| 1352 | +# After copying Eclipse needs to be restarted before the help appears. | |
| 1353 | +# The default value is: NO. | |
| 1354 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1355 | + | |
| 1356 | +GENERATE_ECLIPSEHELP = NO | |
| 1357 | + | |
| 1358 | +# A unique identifier for the Eclipse help plugin. When installing the plugin | |
| 1359 | +# the directory name containing the HTML and XML files should also have this | |
| 1360 | +# name. Each documentation set should have its own identifier. | |
| 1361 | +# The default value is: org.doxygen.Project. | |
| 1362 | +# This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES. | |
| 1363 | + | |
| 1364 | +ECLIPSE_DOC_ID = org.doxygen.Project | |
| 1365 | + | |
| 1366 | +# If you want full control over the layout of the generated HTML pages it might | |
| 1367 | +# be necessary to disable the index and replace it with your own. The | |
| 1368 | +# DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top | |
| 1369 | +# of each HTML page. A value of NO enables the index and the value YES disables | |
| 1370 | +# it. Since the tabs in the index contain the same information as the navigation | |
| 1371 | +# tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES. | |
| 1372 | +# The default value is: NO. | |
| 1373 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1374 | + | |
| 1375 | +DISABLE_INDEX = NO | |
| 1376 | + | |
| 1377 | +# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index | |
| 1378 | +# structure should be generated to display hierarchical information. If the tag | |
| 1379 | +# value is set to YES, a side panel will be generated containing a tree-like | |
| 1380 | +# index structure (just like the one that is generated for HTML Help). For this | |
| 1381 | +# to work a browser that supports JavaScript, DHTML, CSS and frames is required | |
| 1382 | +# (i.e. any modern browser). Windows users are probably better off using the | |
| 1383 | +# HTML help feature. Via custom stylesheets (see HTML_EXTRA_STYLESHEET) one can | |
| 1384 | +# further fine-tune the look of the index. As an example, the default style | |
| 1385 | +# sheet generated by doxygen has an example that shows how to put an image at | |
| 1386 | +# the root of the tree instead of the PROJECT_NAME. Since the tree basically has | |
| 1387 | +# the same information as the tab index, you could consider setting | |
| 1388 | +# DISABLE_INDEX to YES when enabling this option. | |
| 1389 | +# The default value is: NO. | |
| 1390 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1391 | + | |
| 1392 | +GENERATE_TREEVIEW = NO | |
| 1393 | + | |
| 1394 | +# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that | |
| 1395 | +# doxygen will group on one line in the generated HTML documentation. | |
| 1396 | +# | |
| 1397 | +# Note that a value of 0 will completely suppress the enum values from appearing | |
| 1398 | +# in the overview section. | |
| 1399 | +# Minimum value: 0, maximum value: 20, default value: 4. | |
| 1400 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1401 | + | |
| 1402 | +ENUM_VALUES_PER_LINE = 4 | |
| 1403 | + | |
| 1404 | +# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used | |
| 1405 | +# to set the initial width (in pixels) of the frame in which the tree is shown. | |
| 1406 | +# Minimum value: 0, maximum value: 1500, default value: 250. | |
| 1407 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1408 | + | |
| 1409 | +TREEVIEW_WIDTH = 250 | |
| 1410 | + | |
| 1411 | +# When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open links to | |
| 1412 | +# external symbols imported via tag files in a separate window. | |
| 1413 | +# The default value is: NO. | |
| 1414 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1415 | + | |
| 1416 | +EXT_LINKS_IN_WINDOW = NO | |
| 1417 | + | |
| 1418 | +# Use this tag to change the font size of LaTeX formulas included as images in | |
| 1419 | +# the HTML documentation. When you change the font size after a successful | |
| 1420 | +# doxygen run you need to manually remove any form_*.png images from the HTML | |
| 1421 | +# output directory to force them to be regenerated. | |
| 1422 | +# Minimum value: 8, maximum value: 50, default value: 10. | |
| 1423 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1424 | + | |
| 1425 | +FORMULA_FONTSIZE = 10 | |
| 1426 | + | |
| 1427 | +# Use the FORMULA_TRANPARENT tag to determine whether or not the images | |
| 1428 | +# generated for formulas are transparent PNGs. Transparent PNGs are not | |
| 1429 | +# supported properly for IE 6.0, but are supported on all modern browsers. | |
| 1430 | +# | |
| 1431 | +# Note that when changing this option you need to delete any form_*.png files in | |
| 1432 | +# the HTML output directory before the changes have effect. | |
| 1433 | +# The default value is: YES. | |
| 1434 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1435 | + | |
| 1436 | +FORMULA_TRANSPARENT = YES | |
| 1437 | + | |
| 1438 | +# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see | |
| 1439 | +# http://www.mathjax.org) which uses client side Javascript for the rendering | |
| 1440 | +# instead of using prerendered bitmaps. Use this if you do not have LaTeX | |
| 1441 | +# installed or if you want to formulas look prettier in the HTML output. When | |
| 1442 | +# enabled you may also need to install MathJax separately and configure the path | |
| 1443 | +# to it using the MATHJAX_RELPATH option. | |
| 1444 | +# The default value is: NO. | |
| 1445 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1446 | + | |
| 1447 | +USE_MATHJAX = NO | |
| 1448 | + | |
| 1449 | +# When MathJax is enabled you can set the default output format to be used for | |
| 1450 | +# the MathJax output. See the MathJax site (see: | |
| 1451 | +# http://docs.mathjax.org/en/latest/output.html) for more details. | |
| 1452 | +# Possible values are: HTML-CSS (which is slower, but has the best | |
| 1453 | +# compatibility), NativeMML (i.e. MathML) and SVG. | |
| 1454 | +# The default value is: HTML-CSS. | |
| 1455 | +# This tag requires that the tag USE_MATHJAX is set to YES. | |
| 1456 | + | |
| 1457 | +MATHJAX_FORMAT = HTML-CSS | |
| 1458 | + | |
| 1459 | +# When MathJax is enabled you need to specify the location relative to the HTML | |
| 1460 | +# output directory using the MATHJAX_RELPATH option. The destination directory | |
| 1461 | +# should contain the MathJax.js script. For instance, if the mathjax directory | |
| 1462 | +# is located at the same level as the HTML output directory, then | |
| 1463 | +# MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax | |
| 1464 | +# Content Delivery Network so you can quickly see the result without installing | |
| 1465 | +# MathJax. However, it is strongly recommended to install a local copy of | |
| 1466 | +# MathJax from http://www.mathjax.org before deployment. | |
| 1467 | +# The default value is: http://cdn.mathjax.org/mathjax/latest. | |
| 1468 | +# This tag requires that the tag USE_MATHJAX is set to YES. | |
| 1469 | + | |
| 1470 | +MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest | |
| 1471 | + | |
| 1472 | +# The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax | |
| 1473 | +# extension names that should be enabled during MathJax rendering. For example | |
| 1474 | +# MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols | |
| 1475 | +# This tag requires that the tag USE_MATHJAX is set to YES. | |
| 1476 | + | |
| 1477 | +MATHJAX_EXTENSIONS = | |
| 1478 | + | |
| 1479 | +# The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces | |
| 1480 | +# of code that will be used on startup of the MathJax code. See the MathJax site | |
| 1481 | +# (see: http://docs.mathjax.org/en/latest/output.html) for more details. For an | |
| 1482 | +# example see the documentation. | |
| 1483 | +# This tag requires that the tag USE_MATHJAX is set to YES. | |
| 1484 | + | |
| 1485 | +MATHJAX_CODEFILE = | |
| 1486 | + | |
| 1487 | +# When the SEARCHENGINE tag is enabled doxygen will generate a search box for | |
| 1488 | +# the HTML output. The underlying search engine uses javascript and DHTML and | |
| 1489 | +# should work on any modern browser. Note that when using HTML help | |
| 1490 | +# (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET) | |
| 1491 | +# there is already a search function so this one should typically be disabled. | |
| 1492 | +# For large projects the javascript based search engine can be slow, then | |
| 1493 | +# enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to | |
| 1494 | +# search using the keyboard; to jump to the search box use <access key> + S | |
| 1495 | +# (what the <access key> is depends on the OS and browser, but it is typically | |
| 1496 | +# <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down | |
| 1497 | +# key> to jump into the search results window, the results can be navigated | |
| 1498 | +# using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel | |
| 1499 | +# the search. The filter options can be selected when the cursor is inside the | |
| 1500 | +# search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys> | |
| 1501 | +# to select a filter and <Enter> or <escape> to activate or cancel the filter | |
| 1502 | +# option. | |
| 1503 | +# The default value is: YES. | |
| 1504 | +# This tag requires that the tag GENERATE_HTML is set to YES. | |
| 1505 | + | |
| 1506 | +SEARCHENGINE = YES | |
| 1507 | + | |
| 1508 | +# When the SERVER_BASED_SEARCH tag is enabled the search engine will be | |
| 1509 | +# implemented using a web server instead of a web client using Javascript. There | |
| 1510 | +# are two flavors of web server based searching depending on the EXTERNAL_SEARCH | |
| 1511 | +# setting. When disabled, doxygen will generate a PHP script for searching and | |
| 1512 | +# an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing | |
| 1513 | +# and searching needs to be provided by external tools. See the section | |
| 1514 | +# "External Indexing and Searching" for details. | |
| 1515 | +# The default value is: NO. | |
| 1516 | +# This tag requires that the tag SEARCHENGINE is set to YES. | |
| 1517 | + | |
| 1518 | +SERVER_BASED_SEARCH = NO | |
| 1519 | + | |
| 1520 | +# When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP | |
| 1521 | +# script for searching. Instead the search results are written to an XML file | |
| 1522 | +# which needs to be processed by an external indexer. Doxygen will invoke an | |
| 1523 | +# external search engine pointed to by the SEARCHENGINE_URL option to obtain the | |
| 1524 | +# search results. | |
| 1525 | +# | |
| 1526 | +# Doxygen ships with an example indexer ( doxyindexer) and search engine | |
| 1527 | +# (doxysearch.cgi) which are based on the open source search engine library | |
| 1528 | +# Xapian (see: http://xapian.org/). | |
| 1529 | +# | |
| 1530 | +# See the section "External Indexing and Searching" for details. | |
| 1531 | +# The default value is: NO. | |
| 1532 | +# This tag requires that the tag SEARCHENGINE is set to YES. | |
| 1533 | + | |
| 1534 | +EXTERNAL_SEARCH = NO | |
| 1535 | + | |
| 1536 | +# The SEARCHENGINE_URL should point to a search engine hosted by a web server | |
| 1537 | +# which will return the search results when EXTERNAL_SEARCH is enabled. | |
| 1538 | +# | |
| 1539 | +# Doxygen ships with an example indexer ( doxyindexer) and search engine | |
| 1540 | +# (doxysearch.cgi) which are based on the open source search engine library | |
| 1541 | +# Xapian (see: http://xapian.org/). See the section "External Indexing and | |
| 1542 | +# Searching" for details. | |
| 1543 | +# This tag requires that the tag SEARCHENGINE is set to YES. | |
| 1544 | + | |
| 1545 | +SEARCHENGINE_URL = | |
| 1546 | + | |
| 1547 | +# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed | |
| 1548 | +# search data is written to a file for indexing by an external tool. With the | |
| 1549 | +# SEARCHDATA_FILE tag the name of this file can be specified. | |
| 1550 | +# The default file is: searchdata.xml. | |
| 1551 | +# This tag requires that the tag SEARCHENGINE is set to YES. | |
| 1552 | + | |
| 1553 | +SEARCHDATA_FILE = searchdata.xml | |
| 1554 | + | |
| 1555 | +# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the | |
| 1556 | +# EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is | |
| 1557 | +# useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple | |
| 1558 | +# projects and redirect the results back to the right project. | |
| 1559 | +# This tag requires that the tag SEARCHENGINE is set to YES. | |
| 1560 | + | |
| 1561 | +EXTERNAL_SEARCH_ID = | |
| 1562 | + | |
| 1563 | +# The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen | |
| 1564 | +# projects other than the one defined by this configuration file, but that are | |
| 1565 | +# all added to the same external search index. Each project needs to have a | |
| 1566 | +# unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of | |
| 1567 | +# to a relative location where the documentation can be found. The format is: | |
| 1568 | +# EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ... | |
| 1569 | +# This tag requires that the tag SEARCHENGINE is set to YES. | |
| 1570 | + | |
| 1571 | +EXTRA_SEARCH_MAPPINGS = | |
| 1572 | + | |
| 1573 | +#--------------------------------------------------------------------------- | |
| 1574 | +# Configuration options related to the LaTeX output | |
| 1575 | +#--------------------------------------------------------------------------- | |
| 1576 | + | |
| 1577 | +# If the GENERATE_LATEX tag is set to YES doxygen will generate LaTeX output. | |
| 1578 | +# The default value is: YES. | |
| 1579 | + | |
| 1580 | +GENERATE_LATEX = YES | |
| 1581 | + | |
| 1582 | +# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a | |
| 1583 | +# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of | |
| 1584 | +# it. | |
| 1585 | +# The default directory is: latex. | |
| 1586 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1587 | + | |
| 1588 | +LATEX_OUTPUT = latex | |
| 1589 | + | |
| 1590 | +# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be | |
| 1591 | +# invoked. | |
| 1592 | +# | |
| 1593 | +# Note that when enabling USE_PDFLATEX this option is only used for generating | |
| 1594 | +# bitmaps for formulas in the HTML output, but not in the Makefile that is | |
| 1595 | +# written to the output directory. | |
| 1596 | +# The default file is: latex. | |
| 1597 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1598 | + | |
| 1599 | +LATEX_CMD_NAME = latex | |
| 1600 | + | |
| 1601 | +# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate | |
| 1602 | +# index for LaTeX. | |
| 1603 | +# The default file is: makeindex. | |
| 1604 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1605 | + | |
| 1606 | +MAKEINDEX_CMD_NAME = makeindex | |
| 1607 | + | |
| 1608 | +# If the COMPACT_LATEX tag is set to YES doxygen generates more compact LaTeX | |
| 1609 | +# documents. This may be useful for small projects and may help to save some | |
| 1610 | +# trees in general. | |
| 1611 | +# The default value is: NO. | |
| 1612 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1613 | + | |
| 1614 | +COMPACT_LATEX = NO | |
| 1615 | + | |
| 1616 | +# The PAPER_TYPE tag can be used to set the paper type that is used by the | |
| 1617 | +# printer. | |
| 1618 | +# Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x | |
| 1619 | +# 14 inches) and executive (7.25 x 10.5 inches). | |
| 1620 | +# The default value is: a4. | |
| 1621 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1622 | + | |
| 1623 | +PAPER_TYPE = a4 | |
| 1624 | + | |
| 1625 | +# The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names | |
| 1626 | +# that should be included in the LaTeX output. To get the times font for | |
| 1627 | +# instance you can specify | |
| 1628 | +# EXTRA_PACKAGES=times | |
| 1629 | +# If left blank no extra packages will be included. | |
| 1630 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1631 | + | |
| 1632 | +EXTRA_PACKAGES = | |
| 1633 | + | |
| 1634 | +# The LATEX_HEADER tag can be used to specify a personal LaTeX header for the | |
| 1635 | +# generated LaTeX document. The header should contain everything until the first | |
| 1636 | +# chapter. If it is left blank doxygen will generate a standard header. See | |
| 1637 | +# section "Doxygen usage" for information on how to let doxygen write the | |
| 1638 | +# default header to a separate file. | |
| 1639 | +# | |
| 1640 | +# Note: Only use a user-defined header if you know what you are doing! The | |
| 1641 | +# following commands have a special meaning inside the header: $title, | |
| 1642 | +# $datetime, $date, $doxygenversion, $projectname, $projectnumber, | |
| 1643 | +# $projectbrief, $projectlogo. Doxygen will replace $title with the empy string, | |
| 1644 | +# for the replacement values of the other commands the user is refered to | |
| 1645 | +# HTML_HEADER. | |
| 1646 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1647 | + | |
| 1648 | +LATEX_HEADER = | |
| 1649 | + | |
| 1650 | +# The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the | |
| 1651 | +# generated LaTeX document. The footer should contain everything after the last | |
| 1652 | +# chapter. If it is left blank doxygen will generate a standard footer. See | |
| 1653 | +# LATEX_HEADER for more information on how to generate a default footer and what | |
| 1654 | +# special commands can be used inside the footer. | |
| 1655 | +# | |
| 1656 | +# Note: Only use a user-defined footer if you know what you are doing! | |
| 1657 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1658 | + | |
| 1659 | +LATEX_FOOTER = | |
| 1660 | + | |
| 1661 | +# The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or | |
| 1662 | +# other source files which should be copied to the LATEX_OUTPUT output | |
| 1663 | +# directory. Note that the files will be copied as-is; there are no commands or | |
| 1664 | +# markers available. | |
| 1665 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1666 | + | |
| 1667 | +LATEX_EXTRA_FILES = | |
| 1668 | + | |
| 1669 | +# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is | |
| 1670 | +# prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will | |
| 1671 | +# contain links (just like the HTML output) instead of page references. This | |
| 1672 | +# makes the output suitable for online browsing using a PDF viewer. | |
| 1673 | +# The default value is: YES. | |
| 1674 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1675 | + | |
| 1676 | +PDF_HYPERLINKS = YES | |
| 1677 | + | |
| 1678 | +# If the USE_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate | |
| 1679 | +# the PDF file directly from the LaTeX files. Set this option to YES to get a | |
| 1680 | +# higher quality PDF documentation. | |
| 1681 | +# The default value is: YES. | |
| 1682 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1683 | + | |
| 1684 | +USE_PDFLATEX = YES | |
| 1685 | + | |
| 1686 | +# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode | |
| 1687 | +# command to the generated LaTeX files. This will instruct LaTeX to keep running | |
| 1688 | +# if errors occur, instead of asking the user for help. This option is also used | |
| 1689 | +# when generating formulas in HTML. | |
| 1690 | +# The default value is: NO. | |
| 1691 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1692 | + | |
| 1693 | +LATEX_BATCHMODE = NO | |
| 1694 | + | |
| 1695 | +# If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the | |
| 1696 | +# index chapters (such as File Index, Compound Index, etc.) in the output. | |
| 1697 | +# The default value is: NO. | |
| 1698 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1699 | + | |
| 1700 | +LATEX_HIDE_INDICES = NO | |
| 1701 | + | |
| 1702 | +# If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source | |
| 1703 | +# code with syntax highlighting in the LaTeX output. | |
| 1704 | +# | |
| 1705 | +# Note that which sources are shown also depends on other settings such as | |
| 1706 | +# SOURCE_BROWSER. | |
| 1707 | +# The default value is: NO. | |
| 1708 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1709 | + | |
| 1710 | +LATEX_SOURCE_CODE = NO | |
| 1711 | + | |
| 1712 | +# The LATEX_BIB_STYLE tag can be used to specify the style to use for the | |
| 1713 | +# bibliography, e.g. plainnat, or ieeetr. See | |
| 1714 | +# http://en.wikipedia.org/wiki/BibTeX and \cite for more info. | |
| 1715 | +# The default value is: plain. | |
| 1716 | +# This tag requires that the tag GENERATE_LATEX is set to YES. | |
| 1717 | + | |
| 1718 | +LATEX_BIB_STYLE = plain | |
| 1719 | + | |
| 1720 | +#--------------------------------------------------------------------------- | |
| 1721 | +# Configuration options related to the RTF output | |
| 1722 | +#--------------------------------------------------------------------------- | |
| 1723 | + | |
| 1724 | +# If the GENERATE_RTF tag is set to YES doxygen will generate RTF output. The | |
| 1725 | +# RTF output is optimized for Word 97 and may not look too pretty with other RTF | |
| 1726 | +# readers/editors. | |
| 1727 | +# The default value is: NO. | |
| 1728 | + | |
| 1729 | +GENERATE_RTF = NO | |
| 1730 | + | |
| 1731 | +# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a | |
| 1732 | +# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of | |
| 1733 | +# it. | |
| 1734 | +# The default directory is: rtf. | |
| 1735 | +# This tag requires that the tag GENERATE_RTF is set to YES. | |
| 1736 | + | |
| 1737 | +RTF_OUTPUT = rtf | |
| 1738 | + | |
| 1739 | +# If the COMPACT_RTF tag is set to YES doxygen generates more compact RTF | |
| 1740 | +# documents. This may be useful for small projects and may help to save some | |
| 1741 | +# trees in general. | |
| 1742 | +# The default value is: NO. | |
| 1743 | +# This tag requires that the tag GENERATE_RTF is set to YES. | |
| 1744 | + | |
| 1745 | +COMPACT_RTF = NO | |
| 1746 | + | |
| 1747 | +# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will | |
| 1748 | +# contain hyperlink fields. The RTF file will contain links (just like the HTML | |
| 1749 | +# output) instead of page references. This makes the output suitable for online | |
| 1750 | +# browsing using Word or some other Word compatible readers that support those | |
| 1751 | +# fields. | |
| 1752 | +# | |
| 1753 | +# Note: WordPad (write) and others do not support links. | |
| 1754 | +# The default value is: NO. | |
| 1755 | +# This tag requires that the tag GENERATE_RTF is set to YES. | |
| 1756 | + | |
| 1757 | +RTF_HYPERLINKS = NO | |
| 1758 | + | |
| 1759 | +# Load stylesheet definitions from file. Syntax is similar to doxygen's config | |
| 1760 | +# file, i.e. a series of assignments. You only have to provide replacements, | |
| 1761 | +# missing definitions are set to their default value. | |
| 1762 | +# | |
| 1763 | +# See also section "Doxygen usage" for information on how to generate the | |
| 1764 | +# default style sheet that doxygen normally uses. | |
| 1765 | +# This tag requires that the tag GENERATE_RTF is set to YES. | |
| 1766 | + | |
| 1767 | +RTF_STYLESHEET_FILE = | |
| 1768 | + | |
| 1769 | +# Set optional variables used in the generation of an RTF document. Syntax is | |
| 1770 | +# similar to doxygen's config file. A template extensions file can be generated | |
| 1771 | +# using doxygen -e rtf extensionFile. | |
| 1772 | +# This tag requires that the tag GENERATE_RTF is set to YES. | |
| 1773 | + | |
| 1774 | +RTF_EXTENSIONS_FILE = | |
| 1775 | + | |
| 1776 | +#--------------------------------------------------------------------------- | |
| 1777 | +# Configuration options related to the man page output | |
| 1778 | +#--------------------------------------------------------------------------- | |
| 1779 | + | |
| 1780 | +# If the GENERATE_MAN tag is set to YES doxygen will generate man pages for | |
| 1781 | +# classes and files. | |
| 1782 | +# The default value is: NO. | |
| 1783 | + | |
| 1784 | +GENERATE_MAN = NO | |
| 1785 | + | |
| 1786 | +# The MAN_OUTPUT tag is used to specify where the man pages will be put. If a | |
| 1787 | +# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of | |
| 1788 | +# it. A directory man3 will be created inside the directory specified by | |
| 1789 | +# MAN_OUTPUT. | |
| 1790 | +# The default directory is: man. | |
| 1791 | +# This tag requires that the tag GENERATE_MAN is set to YES. | |
| 1792 | + | |
| 1793 | +MAN_OUTPUT = man | |
| 1794 | + | |
| 1795 | +# The MAN_EXTENSION tag determines the extension that is added to the generated | |
| 1796 | +# man pages. In case the manual section does not start with a number, the number | |
| 1797 | +# 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is | |
| 1798 | +# optional. | |
| 1799 | +# The default value is: .3. | |
| 1800 | +# This tag requires that the tag GENERATE_MAN is set to YES. | |
| 1801 | + | |
| 1802 | +MAN_EXTENSION = .3 | |
| 1803 | + | |
| 1804 | +# The MAN_SUBDIR tag determines the name of the directory created within | |
| 1805 | +# MAN_OUTPUT in which the man pages are placed. If defaults to man followed by | |
| 1806 | +# MAN_EXTENSION with the initial . removed. | |
| 1807 | +# This tag requires that the tag GENERATE_MAN is set to YES. | |
| 1808 | + | |
| 1809 | +MAN_SUBDIR = | |
| 1810 | + | |
| 1811 | +# If the MAN_LINKS tag is set to YES and doxygen generates man output, then it | |
| 1812 | +# will generate one additional man file for each entity documented in the real | |
| 1813 | +# man page(s). These additional files only source the real man page, but without | |
| 1814 | +# them the man command would be unable to find the correct page. | |
| 1815 | +# The default value is: NO. | |
| 1816 | +# This tag requires that the tag GENERATE_MAN is set to YES. | |
| 1817 | + | |
| 1818 | +MAN_LINKS = NO | |
| 1819 | + | |
| 1820 | +#--------------------------------------------------------------------------- | |
| 1821 | +# Configuration options related to the XML output | |
| 1822 | +#--------------------------------------------------------------------------- | |
| 1823 | + | |
| 1824 | +# If the GENERATE_XML tag is set to YES doxygen will generate an XML file that | |
| 1825 | +# captures the structure of the code including all documentation. | |
| 1826 | +# The default value is: NO. | |
| 1827 | + | |
| 1828 | +GENERATE_XML = NO | |
| 1829 | + | |
| 1830 | +# The XML_OUTPUT tag is used to specify where the XML pages will be put. If a | |
| 1831 | +# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of | |
| 1832 | +# it. | |
| 1833 | +# The default directory is: xml. | |
| 1834 | +# This tag requires that the tag GENERATE_XML is set to YES. | |
| 1835 | + | |
| 1836 | +XML_OUTPUT = xml | |
| 1837 | + | |
| 1838 | +# If the XML_PROGRAMLISTING tag is set to YES doxygen will dump the program | |
| 1839 | +# listings (including syntax highlighting and cross-referencing information) to | |
| 1840 | +# the XML output. Note that enabling this will significantly increase the size | |
| 1841 | +# of the XML output. | |
| 1842 | +# The default value is: YES. | |
| 1843 | +# This tag requires that the tag GENERATE_XML is set to YES. | |
| 1844 | + | |
| 1845 | +XML_PROGRAMLISTING = YES | |
| 1846 | + | |
| 1847 | +#--------------------------------------------------------------------------- | |
| 1848 | +# Configuration options related to the DOCBOOK output | |
| 1849 | +#--------------------------------------------------------------------------- | |
| 1850 | + | |
| 1851 | +# If the GENERATE_DOCBOOK tag is set to YES doxygen will generate Docbook files | |
| 1852 | +# that can be used to generate PDF. | |
| 1853 | +# The default value is: NO. | |
| 1854 | + | |
| 1855 | +GENERATE_DOCBOOK = NO | |
| 1856 | + | |
| 1857 | +# The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put. | |
| 1858 | +# If a relative path is entered the value of OUTPUT_DIRECTORY will be put in | |
| 1859 | +# front of it. | |
| 1860 | +# The default directory is: docbook. | |
| 1861 | +# This tag requires that the tag GENERATE_DOCBOOK is set to YES. | |
| 1862 | + | |
| 1863 | +DOCBOOK_OUTPUT = docbook | |
| 1864 | + | |
| 1865 | +# If the DOCBOOK_PROGRAMLISTING tag is set to YES doxygen will include the | |
| 1866 | +# program listings (including syntax highlighting and cross-referencing | |
| 1867 | +# information) to the DOCBOOK output. Note that enabling this will significantly | |
| 1868 | +# increase the size of the DOCBOOK output. | |
| 1869 | +# The default value is: NO. | |
| 1870 | +# This tag requires that the tag GENERATE_DOCBOOK is set to YES. | |
| 1871 | + | |
| 1872 | +DOCBOOK_PROGRAMLISTING = NO | |
| 1873 | + | |
| 1874 | +#--------------------------------------------------------------------------- | |
| 1875 | +# Configuration options for the AutoGen Definitions output | |
| 1876 | +#--------------------------------------------------------------------------- | |
| 1877 | + | |
| 1878 | +# If the GENERATE_AUTOGEN_DEF tag is set to YES doxygen will generate an AutoGen | |
| 1879 | +# Definitions (see http://autogen.sf.net) file that captures the structure of | |
| 1880 | +# the code including all documentation. Note that this feature is still | |
| 1881 | +# experimental and incomplete at the moment. | |
| 1882 | +# The default value is: NO. | |
| 1883 | + | |
| 1884 | +GENERATE_AUTOGEN_DEF = NO | |
| 1885 | + | |
| 1886 | +#--------------------------------------------------------------------------- | |
| 1887 | +# Configuration options related to the Perl module output | |
| 1888 | +#--------------------------------------------------------------------------- | |
| 1889 | + | |
| 1890 | +# If the GENERATE_PERLMOD tag is set to YES doxygen will generate a Perl module | |
| 1891 | +# file that captures the structure of the code including all documentation. | |
| 1892 | +# | |
| 1893 | +# Note that this feature is still experimental and incomplete at the moment. | |
| 1894 | +# The default value is: NO. | |
| 1895 | + | |
| 1896 | +GENERATE_PERLMOD = NO | |
| 1897 | + | |
| 1898 | +# If the PERLMOD_LATEX tag is set to YES doxygen will generate the necessary | |
| 1899 | +# Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI | |
| 1900 | +# output from the Perl module output. | |
| 1901 | +# The default value is: NO. | |
| 1902 | +# This tag requires that the tag GENERATE_PERLMOD is set to YES. | |
| 1903 | + | |
| 1904 | +PERLMOD_LATEX = NO | |
| 1905 | + | |
| 1906 | +# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be nicely | |
| 1907 | +# formatted so it can be parsed by a human reader. This is useful if you want to | |
| 1908 | +# understand what is going on. On the other hand, if this tag is set to NO the | |
| 1909 | +# size of the Perl module output will be much smaller and Perl will parse it | |
| 1910 | +# just the same. | |
| 1911 | +# The default value is: YES. | |
| 1912 | +# This tag requires that the tag GENERATE_PERLMOD is set to YES. | |
| 1913 | + | |
| 1914 | +PERLMOD_PRETTY = YES | |
| 1915 | + | |
| 1916 | +# The names of the make variables in the generated doxyrules.make file are | |
| 1917 | +# prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful | |
| 1918 | +# so different doxyrules.make files included by the same Makefile don't | |
| 1919 | +# overwrite each other's variables. | |
| 1920 | +# This tag requires that the tag GENERATE_PERLMOD is set to YES. | |
| 1921 | + | |
| 1922 | +PERLMOD_MAKEVAR_PREFIX = | |
| 1923 | + | |
| 1924 | +#--------------------------------------------------------------------------- | |
| 1925 | +# Configuration options related to the preprocessor | |
| 1926 | +#--------------------------------------------------------------------------- | |
| 1927 | + | |
| 1928 | +# If the ENABLE_PREPROCESSING tag is set to YES doxygen will evaluate all | |
| 1929 | +# C-preprocessor directives found in the sources and include files. | |
| 1930 | +# The default value is: YES. | |
| 1931 | + | |
| 1932 | +ENABLE_PREPROCESSING = YES | |
| 1933 | + | |
| 1934 | +# If the MACRO_EXPANSION tag is set to YES doxygen will expand all macro names | |
| 1935 | +# in the source code. If set to NO only conditional compilation will be | |
| 1936 | +# performed. Macro expansion can be done in a controlled way by setting | |
| 1937 | +# EXPAND_ONLY_PREDEF to YES. | |
| 1938 | +# The default value is: NO. | |
| 1939 | +# This tag requires that the tag ENABLE_PREPROCESSING is set to YES. | |
| 1940 | + | |
| 1941 | +MACRO_EXPANSION = NO | |
| 1942 | + | |
| 1943 | +# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then | |
| 1944 | +# the macro expansion is limited to the macros specified with the PREDEFINED and | |
| 1945 | +# EXPAND_AS_DEFINED tags. | |
| 1946 | +# The default value is: NO. | |
| 1947 | +# This tag requires that the tag ENABLE_PREPROCESSING is set to YES. | |
| 1948 | + | |
| 1949 | +EXPAND_ONLY_PREDEF = NO | |
| 1950 | + | |
| 1951 | +# If the SEARCH_INCLUDES tag is set to YES the includes files in the | |
| 1952 | +# INCLUDE_PATH will be searched if a #include is found. | |
| 1953 | +# The default value is: YES. | |
| 1954 | +# This tag requires that the tag ENABLE_PREPROCESSING is set to YES. | |
| 1955 | + | |
| 1956 | +SEARCH_INCLUDES = YES | |
| 1957 | + | |
| 1958 | +# The INCLUDE_PATH tag can be used to specify one or more directories that | |
| 1959 | +# contain include files that are not input files but should be processed by the | |
| 1960 | +# preprocessor. | |
| 1961 | +# This tag requires that the tag SEARCH_INCLUDES is set to YES. | |
| 1962 | + | |
| 1963 | +INCLUDE_PATH = | |
| 1964 | + | |
| 1965 | +# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard | |
| 1966 | +# patterns (like *.h and *.hpp) to filter out the header-files in the | |
| 1967 | +# directories. If left blank, the patterns specified with FILE_PATTERNS will be | |
| 1968 | +# used. | |
| 1969 | +# This tag requires that the tag ENABLE_PREPROCESSING is set to YES. | |
| 1970 | + | |
| 1971 | +INCLUDE_FILE_PATTERNS = | |
| 1972 | + | |
| 1973 | +# The PREDEFINED tag can be used to specify one or more macro names that are | |
| 1974 | +# defined before the preprocessor is started (similar to the -D option of e.g. | |
| 1975 | +# gcc). The argument of the tag is a list of macros of the form: name or | |
| 1976 | +# name=definition (no spaces). If the definition and the "=" are omitted, "=1" | |
| 1977 | +# is assumed. To prevent a macro definition from being undefined via #undef or | |
| 1978 | +# recursively expanded use the := operator instead of the = operator. | |
| 1979 | +# This tag requires that the tag ENABLE_PREPROCESSING is set to YES. | |
| 1980 | + | |
| 1981 | +PREDEFINED = | |
| 1982 | + | |
| 1983 | +# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this | |
| 1984 | +# tag can be used to specify a list of macro names that should be expanded. The | |
| 1985 | +# macro definition that is found in the sources will be used. Use the PREDEFINED | |
| 1986 | +# tag if you want to use a different macro definition that overrules the | |
| 1987 | +# definition found in the source code. | |
| 1988 | +# This tag requires that the tag ENABLE_PREPROCESSING is set to YES. | |
| 1989 | + | |
| 1990 | +EXPAND_AS_DEFINED = | |
| 1991 | + | |
| 1992 | +# If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will | |
| 1993 | +# remove all references to function-like macros that are alone on a line, have | |
| 1994 | +# an all uppercase name, and do not end with a semicolon. Such function macros | |
| 1995 | +# are typically used for boiler-plate code, and will confuse the parser if not | |
| 1996 | +# removed. | |
| 1997 | +# The default value is: YES. | |
| 1998 | +# This tag requires that the tag ENABLE_PREPROCESSING is set to YES. | |
| 1999 | + | |
| 2000 | +SKIP_FUNCTION_MACROS = YES | |
| 2001 | + | |
| 2002 | +#--------------------------------------------------------------------------- | |
| 2003 | +# Configuration options related to external references | |
| 2004 | +#--------------------------------------------------------------------------- | |
| 2005 | + | |
| 2006 | +# The TAGFILES tag can be used to specify one or more tag files. For each tag | |
| 2007 | +# file the location of the external documentation should be added. The format of | |
| 2008 | +# a tag file without this location is as follows: | |
| 2009 | +# TAGFILES = file1 file2 ... | |
| 2010 | +# Adding location for the tag files is done as follows: | |
| 2011 | +# TAGFILES = file1=loc1 "file2 = loc2" ... | |
| 2012 | +# where loc1 and loc2 can be relative or absolute paths or URLs. See the | |
| 2013 | +# section "Linking to external documentation" for more information about the use | |
| 2014 | +# of tag files. | |
| 2015 | +# Note: Each tag file must have a unique name (where the name does NOT include | |
| 2016 | +# the path). If a tag file is not located in the directory in which doxygen is | |
| 2017 | +# run, you must also specify the path to the tagfile here. | |
| 2018 | + | |
| 2019 | +TAGFILES = | |
| 2020 | + | |
| 2021 | +# When a file name is specified after GENERATE_TAGFILE, doxygen will create a | |
| 2022 | +# tag file that is based on the input files it reads. See section "Linking to | |
| 2023 | +# external documentation" for more information about the usage of tag files. | |
| 2024 | + | |
| 2025 | +GENERATE_TAGFILE = | |
| 2026 | + | |
| 2027 | +# If the ALLEXTERNALS tag is set to YES all external class will be listed in the | |
| 2028 | +# class index. If set to NO only the inherited external classes will be listed. | |
| 2029 | +# The default value is: NO. | |
| 2030 | + | |
| 2031 | +ALLEXTERNALS = NO | |
| 2032 | + | |
| 2033 | +# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed in | |
| 2034 | +# the modules index. If set to NO, only the current project's groups will be | |
| 2035 | +# listed. | |
| 2036 | +# The default value is: YES. | |
| 2037 | + | |
| 2038 | +EXTERNAL_GROUPS = YES | |
| 2039 | + | |
| 2040 | +# If the EXTERNAL_PAGES tag is set to YES all external pages will be listed in | |
| 2041 | +# the related pages index. If set to NO, only the current project's pages will | |
| 2042 | +# be listed. | |
| 2043 | +# The default value is: YES. | |
| 2044 | + | |
| 2045 | +EXTERNAL_PAGES = YES | |
| 2046 | + | |
| 2047 | +# The PERL_PATH should be the absolute path and name of the perl script | |
| 2048 | +# interpreter (i.e. the result of 'which perl'). | |
| 2049 | +# The default file (with absolute path) is: /usr/bin/perl. | |
| 2050 | + | |
| 2051 | +PERL_PATH = /usr/bin/perl | |
| 2052 | + | |
| 2053 | +#--------------------------------------------------------------------------- | |
| 2054 | +# Configuration options related to the dot tool | |
| 2055 | +#--------------------------------------------------------------------------- | |
| 2056 | + | |
| 2057 | +# If the CLASS_DIAGRAMS tag is set to YES doxygen will generate a class diagram | |
| 2058 | +# (in HTML and LaTeX) for classes with base or super classes. Setting the tag to | |
| 2059 | +# NO turns the diagrams off. Note that this option also works with HAVE_DOT | |
| 2060 | +# disabled, but it is recommended to install and use dot, since it yields more | |
| 2061 | +# powerful graphs. | |
| 2062 | +# The default value is: YES. | |
| 2063 | + | |
| 2064 | +CLASS_DIAGRAMS = YES | |
| 2065 | + | |
| 2066 | +# You can define message sequence charts within doxygen comments using the \msc | |
| 2067 | +# command. Doxygen will then run the mscgen tool (see: | |
| 2068 | +# http://www.mcternan.me.uk/mscgen/)) to produce the chart and insert it in the | |
| 2069 | +# documentation. The MSCGEN_PATH tag allows you to specify the directory where | |
| 2070 | +# the mscgen tool resides. If left empty the tool is assumed to be found in the | |
| 2071 | +# default search path. | |
| 2072 | + | |
| 2073 | +MSCGEN_PATH = | |
| 2074 | + | |
| 2075 | +# You can include diagrams made with dia in doxygen documentation. Doxygen will | |
| 2076 | +# then run dia to produce the diagram and insert it in the documentation. The | |
| 2077 | +# DIA_PATH tag allows you to specify the directory where the dia binary resides. | |
| 2078 | +# If left empty dia is assumed to be found in the default search path. | |
| 2079 | + | |
| 2080 | +DIA_PATH = | |
| 2081 | + | |
| 2082 | +# If set to YES, the inheritance and collaboration graphs will hide inheritance | |
| 2083 | +# and usage relations if the target is undocumented or is not a class. | |
| 2084 | +# The default value is: YES. | |
| 2085 | + | |
| 2086 | +HIDE_UNDOC_RELATIONS = YES | |
| 2087 | + | |
| 2088 | +# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is | |
| 2089 | +# available from the path. This tool is part of Graphviz (see: | |
| 2090 | +# http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent | |
| 2091 | +# Bell Labs. The other options in this section have no effect if this option is | |
| 2092 | +# set to NO | |
| 2093 | +# The default value is: NO. | |
| 2094 | + | |
| 2095 | +HAVE_DOT = NO | |
| 2096 | + | |
| 2097 | +# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed | |
| 2098 | +# to run in parallel. When set to 0 doxygen will base this on the number of | |
| 2099 | +# processors available in the system. You can set it explicitly to a value | |
| 2100 | +# larger than 0 to get control over the balance between CPU load and processing | |
| 2101 | +# speed. | |
| 2102 | +# Minimum value: 0, maximum value: 32, default value: 0. | |
| 2103 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2104 | + | |
| 2105 | +DOT_NUM_THREADS = 0 | |
| 2106 | + | |
| 2107 | +# When you want a differently looking font in the dot files that doxygen | |
| 2108 | +# generates you can specify the font name using DOT_FONTNAME. You need to make | |
| 2109 | +# sure dot is able to find the font, which can be done by putting it in a | |
| 2110 | +# standard location or by setting the DOTFONTPATH environment variable or by | |
| 2111 | +# setting DOT_FONTPATH to the directory containing the font. | |
| 2112 | +# The default value is: Helvetica. | |
| 2113 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2114 | + | |
| 2115 | +DOT_FONTNAME = Helvetica | |
| 2116 | + | |
| 2117 | +# The DOT_FONTSIZE tag can be used to set the size (in points) of the font of | |
| 2118 | +# dot graphs. | |
| 2119 | +# Minimum value: 4, maximum value: 24, default value: 10. | |
| 2120 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2121 | + | |
| 2122 | +DOT_FONTSIZE = 10 | |
| 2123 | + | |
| 2124 | +# By default doxygen will tell dot to use the default font as specified with | |
| 2125 | +# DOT_FONTNAME. If you specify a different font using DOT_FONTNAME you can set | |
| 2126 | +# the path where dot can find it using this tag. | |
| 2127 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2128 | + | |
| 2129 | +DOT_FONTPATH = | |
| 2130 | + | |
| 2131 | +# If the CLASS_GRAPH tag is set to YES then doxygen will generate a graph for | |
| 2132 | +# each documented class showing the direct and indirect inheritance relations. | |
| 2133 | +# Setting this tag to YES will force the CLASS_DIAGRAMS tag to NO. | |
| 2134 | +# The default value is: YES. | |
| 2135 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2136 | + | |
| 2137 | +CLASS_GRAPH = YES | |
| 2138 | + | |
| 2139 | +# If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a | |
| 2140 | +# graph for each documented class showing the direct and indirect implementation | |
| 2141 | +# dependencies (inheritance, containment, and class references variables) of the | |
| 2142 | +# class with other documented classes. | |
| 2143 | +# The default value is: YES. | |
| 2144 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2145 | + | |
| 2146 | +COLLABORATION_GRAPH = YES | |
| 2147 | + | |
| 2148 | +# If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for | |
| 2149 | +# groups, showing the direct groups dependencies. | |
| 2150 | +# The default value is: YES. | |
| 2151 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2152 | + | |
| 2153 | +GROUP_GRAPHS = YES | |
| 2154 | + | |
| 2155 | +# If the UML_LOOK tag is set to YES doxygen will generate inheritance and | |
| 2156 | +# collaboration diagrams in a style similar to the OMG's Unified Modeling | |
| 2157 | +# Language. | |
| 2158 | +# The default value is: NO. | |
| 2159 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2160 | + | |
| 2161 | +UML_LOOK = NO | |
| 2162 | + | |
| 2163 | +# If the UML_LOOK tag is enabled, the fields and methods are shown inside the | |
| 2164 | +# class node. If there are many fields or methods and many nodes the graph may | |
| 2165 | +# become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the | |
| 2166 | +# number of items for each type to make the size more manageable. Set this to 0 | |
| 2167 | +# for no limit. Note that the threshold may be exceeded by 50% before the limit | |
| 2168 | +# is enforced. So when you set the threshold to 10, up to 15 fields may appear, | |
| 2169 | +# but if the number exceeds 15, the total amount of fields shown is limited to | |
| 2170 | +# 10. | |
| 2171 | +# Minimum value: 0, maximum value: 100, default value: 10. | |
| 2172 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2173 | + | |
| 2174 | +UML_LIMIT_NUM_FIELDS = 10 | |
| 2175 | + | |
| 2176 | +# If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and | |
| 2177 | +# collaboration graphs will show the relations between templates and their | |
| 2178 | +# instances. | |
| 2179 | +# The default value is: NO. | |
| 2180 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2181 | + | |
| 2182 | +TEMPLATE_RELATIONS = NO | |
| 2183 | + | |
| 2184 | +# If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to | |
| 2185 | +# YES then doxygen will generate a graph for each documented file showing the | |
| 2186 | +# direct and indirect include dependencies of the file with other documented | |
| 2187 | +# files. | |
| 2188 | +# The default value is: YES. | |
| 2189 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2190 | + | |
| 2191 | +INCLUDE_GRAPH = YES | |
| 2192 | + | |
| 2193 | +# If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are | |
| 2194 | +# set to YES then doxygen will generate a graph for each documented file showing | |
| 2195 | +# the direct and indirect include dependencies of the file with other documented | |
| 2196 | +# files. | |
| 2197 | +# The default value is: YES. | |
| 2198 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2199 | + | |
| 2200 | +INCLUDED_BY_GRAPH = YES | |
| 2201 | + | |
| 2202 | +# If the CALL_GRAPH tag is set to YES then doxygen will generate a call | |
| 2203 | +# dependency graph for every global function or class method. | |
| 2204 | +# | |
| 2205 | +# Note that enabling this option will significantly increase the time of a run. | |
| 2206 | +# So in most cases it will be better to enable call graphs for selected | |
| 2207 | +# functions only using the \callgraph command. | |
| 2208 | +# The default value is: NO. | |
| 2209 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2210 | + | |
| 2211 | +CALL_GRAPH = NO | |
| 2212 | + | |
| 2213 | +# If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller | |
| 2214 | +# dependency graph for every global function or class method. | |
| 2215 | +# | |
| 2216 | +# Note that enabling this option will significantly increase the time of a run. | |
| 2217 | +# So in most cases it will be better to enable caller graphs for selected | |
| 2218 | +# functions only using the \callergraph command. | |
| 2219 | +# The default value is: NO. | |
| 2220 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2221 | + | |
| 2222 | +CALLER_GRAPH = NO | |
| 2223 | + | |
| 2224 | +# If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical | |
| 2225 | +# hierarchy of all classes instead of a textual one. | |
| 2226 | +# The default value is: YES. | |
| 2227 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2228 | + | |
| 2229 | +GRAPHICAL_HIERARCHY = YES | |
| 2230 | + | |
| 2231 | +# If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the | |
| 2232 | +# dependencies a directory has on other directories in a graphical way. The | |
| 2233 | +# dependency relations are determined by the #include relations between the | |
| 2234 | +# files in the directories. | |
| 2235 | +# The default value is: YES. | |
| 2236 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2237 | + | |
| 2238 | +DIRECTORY_GRAPH = YES | |
| 2239 | + | |
| 2240 | +# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images | |
| 2241 | +# generated by dot. | |
| 2242 | +# Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order | |
| 2243 | +# to make the SVG files visible in IE 9+ (other browsers do not have this | |
| 2244 | +# requirement). | |
| 2245 | +# Possible values are: png, jpg, gif and svg. | |
| 2246 | +# The default value is: png. | |
| 2247 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2248 | + | |
| 2249 | +DOT_IMAGE_FORMAT = png | |
| 2250 | + | |
| 2251 | +# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to | |
| 2252 | +# enable generation of interactive SVG images that allow zooming and panning. | |
| 2253 | +# | |
| 2254 | +# Note that this requires a modern browser other than Internet Explorer. Tested | |
| 2255 | +# and working are Firefox, Chrome, Safari, and Opera. | |
| 2256 | +# Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make | |
| 2257 | +# the SVG files visible. Older versions of IE do not have SVG support. | |
| 2258 | +# The default value is: NO. | |
| 2259 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2260 | + | |
| 2261 | +INTERACTIVE_SVG = NO | |
| 2262 | + | |
| 2263 | +# The DOT_PATH tag can be used to specify the path where the dot tool can be | |
| 2264 | +# found. If left blank, it is assumed the dot tool can be found in the path. | |
| 2265 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2266 | + | |
| 2267 | +DOT_PATH = | |
| 2268 | + | |
| 2269 | +# The DOTFILE_DIRS tag can be used to specify one or more directories that | |
| 2270 | +# contain dot files that are included in the documentation (see the \dotfile | |
| 2271 | +# command). | |
| 2272 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2273 | + | |
| 2274 | +DOTFILE_DIRS = | |
| 2275 | + | |
| 2276 | +# The MSCFILE_DIRS tag can be used to specify one or more directories that | |
| 2277 | +# contain msc files that are included in the documentation (see the \mscfile | |
| 2278 | +# command). | |
| 2279 | + | |
| 2280 | +MSCFILE_DIRS = | |
| 2281 | + | |
| 2282 | +# The DIAFILE_DIRS tag can be used to specify one or more directories that | |
| 2283 | +# contain dia files that are included in the documentation (see the \diafile | |
| 2284 | +# command). | |
| 2285 | + | |
| 2286 | +DIAFILE_DIRS = | |
| 2287 | + | |
| 2288 | +# When using plantuml, the PLANTUML_JAR_PATH tag should be used to specify the | |
| 2289 | +# path where java can find the plantuml.jar file. If left blank, it is assumed | |
| 2290 | +# PlantUML is not used or called during a preprocessing step. Doxygen will | |
| 2291 | +# generate a warning when it encounters a \startuml command in this case and | |
| 2292 | +# will not generate output for the diagram. | |
| 2293 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2294 | + | |
| 2295 | +PLANTUML_JAR_PATH = | |
| 2296 | + | |
| 2297 | +# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes | |
| 2298 | +# that will be shown in the graph. If the number of nodes in a graph becomes | |
| 2299 | +# larger than this value, doxygen will truncate the graph, which is visualized | |
| 2300 | +# by representing a node as a red box. Note that doxygen if the number of direct | |
| 2301 | +# children of the root node in a graph is already larger than | |
| 2302 | +# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that | |
| 2303 | +# the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH. | |
| 2304 | +# Minimum value: 0, maximum value: 10000, default value: 50. | |
| 2305 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2306 | + | |
| 2307 | +DOT_GRAPH_MAX_NODES = 50 | |
| 2308 | + | |
| 2309 | +# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs | |
| 2310 | +# generated by dot. A depth value of 3 means that only nodes reachable from the | |
| 2311 | +# root by following a path via at most 3 edges will be shown. Nodes that lay | |
| 2312 | +# further from the root node will be omitted. Note that setting this option to 1 | |
| 2313 | +# or 2 may greatly reduce the computation time needed for large code bases. Also | |
| 2314 | +# note that the size of a graph can be further restricted by | |
| 2315 | +# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction. | |
| 2316 | +# Minimum value: 0, maximum value: 1000, default value: 0. | |
| 2317 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2318 | + | |
| 2319 | +MAX_DOT_GRAPH_DEPTH = 0 | |
| 2320 | + | |
| 2321 | +# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent | |
| 2322 | +# background. This is disabled by default, because dot on Windows does not seem | |
| 2323 | +# to support this out of the box. | |
| 2324 | +# | |
| 2325 | +# Warning: Depending on the platform used, enabling this option may lead to | |
| 2326 | +# badly anti-aliased labels on the edges of a graph (i.e. they become hard to | |
| 2327 | +# read). | |
| 2328 | +# The default value is: NO. | |
| 2329 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2330 | + | |
| 2331 | +DOT_TRANSPARENT = NO | |
| 2332 | + | |
| 2333 | +# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output | |
| 2334 | +# files in one run (i.e. multiple -o and -T options on the command line). This | |
| 2335 | +# makes dot run faster, but since only newer versions of dot (>1.8.10) support | |
| 2336 | +# this, this feature is disabled by default. | |
| 2337 | +# The default value is: NO. | |
| 2338 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2339 | + | |
| 2340 | +DOT_MULTI_TARGETS = NO | |
| 2341 | + | |
| 2342 | +# If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page | |
| 2343 | +# explaining the meaning of the various boxes and arrows in the dot generated | |
| 2344 | +# graphs. | |
| 2345 | +# The default value is: YES. | |
| 2346 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2347 | + | |
| 2348 | +GENERATE_LEGEND = YES | |
| 2349 | + | |
| 2350 | +# If the DOT_CLEANUP tag is set to YES doxygen will remove the intermediate dot | |
| 2351 | +# files that are used to generate the various graphs. | |
| 2352 | +# The default value is: YES. | |
| 2353 | +# This tag requires that the tag HAVE_DOT is set to YES. | |
| 2354 | + | |
| 2355 | +DOT_CLEANUP = YES | ... | ... |
3rdparty/websocketpp-0.8.2/SConstruct
0 → 100644
| 1 | +import os, sys, commands | |
| 2 | +env = Environment(ENV = os.environ) | |
| 3 | + | |
| 4 | +# figure out a better way to configure this | |
| 5 | +if os.environ.has_key('CXX'): | |
| 6 | + env['CXX'] = os.environ['CXX'] | |
| 7 | + | |
| 8 | +if os.environ.has_key('DEBUG'): | |
| 9 | + env['DEBUG'] = os.environ['DEBUG'] | |
| 10 | + | |
| 11 | +if os.environ.has_key('CXXFLAGS'): | |
| 12 | + #env['CXXFLAGS'] = os.environ['CXXFLAGS'] | |
| 13 | + env.Append(CXXFLAGS = os.environ['CXXFLAGS']) | |
| 14 | + | |
| 15 | +if os.environ.has_key('LINKFLAGS'): | |
| 16 | + #env['LDFLAGS'] = os.environ['LDFLAGS'] | |
| 17 | + env.Append(LINKFLAGS = os.environ['LINKFLAGS']) | |
| 18 | + | |
| 19 | +## Boost | |
| 20 | +## | |
| 21 | +## Note: You need to either set BOOSTROOT to the root of a stock Boost distribution | |
| 22 | +## or set BOOST_INCLUDES and BOOST_LIBS if Boost comes with your OS distro e.g. and | |
| 23 | +## needs BOOST_INCLUDES=/usr/include/boost and BOOST_LIBS=/usr/lib like Ubuntu. | |
| 24 | +## | |
| 25 | +if os.environ.has_key('BOOSTROOT'): | |
| 26 | + os.environ['BOOST_ROOT'] = os.environ['BOOSTROOT'] | |
| 27 | + | |
| 28 | +if os.environ.has_key('BOOST_ROOT'): | |
| 29 | + env['BOOST_INCLUDES'] = os.environ['BOOST_ROOT'] | |
| 30 | + env['BOOST_LIBS'] = os.path.join(os.environ['BOOST_ROOT'], 'stage', 'lib') | |
| 31 | +elif os.environ.has_key('BOOST_INCLUDES') and os.environ.has_key('BOOST_LIBS'): | |
| 32 | + env['BOOST_INCLUDES'] = os.environ['BOOST_INCLUDES'] | |
| 33 | + env['BOOST_LIBS'] = os.environ['BOOST_LIBS'] | |
| 34 | +else: | |
| 35 | + raise SCons.Errors.UserError, "Neither BOOST_ROOT, nor BOOST_INCLUDES + BOOST_LIBS was set!" | |
| 36 | + | |
| 37 | +## Custom OpenSSL | |
| 38 | +if os.environ.has_key('OPENSSL_PATH'): | |
| 39 | + env.Append(CPPPATH = os.path.join(os.environ['OPENSSL_PATH'], 'include')) | |
| 40 | + env.Append(LIBPATH = os.environ['OPENSSL_PATH']) | |
| 41 | + | |
| 42 | +if os.environ.has_key('WSPP_ENABLE_CPP11'): | |
| 43 | + env['WSPP_ENABLE_CPP11'] = True | |
| 44 | +else: | |
| 45 | + env['WSPP_ENABLE_CPP11'] = False | |
| 46 | + | |
| 47 | +boost_linkshared = False | |
| 48 | + | |
| 49 | +def boostlibs(libnames,localenv): | |
| 50 | + if localenv['PLATFORM'].startswith('win'): | |
| 51 | + # Win/VC++ supports autolinking. nothing to do. | |
| 52 | + # http://www.boost.org/doc/libs/1_49_0/more/getting_started/windows.html#auto-linking | |
| 53 | + return [] | |
| 54 | + else: | |
| 55 | + libs = [] | |
| 56 | + prefix = localenv['SHLIBPREFIX'] if boost_linkshared else localenv['LIBPREFIX'] | |
| 57 | + suffix = localenv['SHLIBSUFFIX'] if boost_linkshared else localenv['LIBSUFFIX'] | |
| 58 | + for name in libnames: | |
| 59 | + lib = File(os.path.join(localenv['BOOST_LIBS'], '%sboost_%s%s' % (prefix, name, suffix))) | |
| 60 | + libs.append(lib) | |
| 61 | + return libs | |
| 62 | + | |
| 63 | +if env['PLATFORM'].startswith('win'): | |
| 64 | + env.Append(CPPDEFINES = ['WIN32', | |
| 65 | + 'NDEBUG', | |
| 66 | + 'WIN32_LEAN_AND_MEAN', | |
| 67 | + '_WIN32_WINNT=0x0600', | |
| 68 | + '_CONSOLE', | |
| 69 | + 'BOOST_TEST_DYN_LINK', | |
| 70 | + 'NOMINMAX', | |
| 71 | + '_WEBSOCKETPP_CPP11_MEMORY_', | |
| 72 | + '_WEBSOCKETPP_CPP11_FUNCTIONAL_']) | |
| 73 | + arch_flags = '/arch:SSE2' | |
| 74 | + opt_flags = '/Ox /Oi /fp:fast' | |
| 75 | + warn_flags = '/W3 /wd4996 /wd4995 /wd4355' | |
| 76 | + env['CCFLAGS'] = '%s /EHsc /GR /GS- /MD /nologo %s %s' % (warn_flags, arch_flags, opt_flags) | |
| 77 | + env['LINKFLAGS'] = '/INCREMENTAL:NO /MANIFEST /NOLOGO /OPT:REF /OPT:ICF /MACHINE:X86' | |
| 78 | +elif env['PLATFORM'] == 'posix': | |
| 79 | + if env.has_key('DEBUG'): | |
| 80 | + env.Append(CCFLAGS = ['-g', '-O0']) | |
| 81 | + else: | |
| 82 | + env.Append(CPPDEFINES = ['NDEBUG']) | |
| 83 | + env.Append(CCFLAGS = ['-O1', '-fomit-frame-pointer']) | |
| 84 | + env.Append(CCFLAGS = ['-Wall']) | |
| 85 | + #env['LINKFLAGS'] = '' | |
| 86 | +elif env['PLATFORM'] == 'darwin': | |
| 87 | + if not os.environ.has_key('CXX'): | |
| 88 | + env['CXX'] = "clang++" | |
| 89 | + if env.has_key('DEBUG'): | |
| 90 | + env.Append(CCFLAGS = ['-g', '-O0']) | |
| 91 | + else: | |
| 92 | + env.Append(CPPDEFINES = ['NDEBUG']) | |
| 93 | + env.Append(CCFLAGS = ['-O1', '-fomit-frame-pointer']) | |
| 94 | + env.Append(CCFLAGS = ['-Wall']) | |
| 95 | + #env['LINKFLAGS'] = '' | |
| 96 | + | |
| 97 | +if env['PLATFORM'].startswith('win'): | |
| 98 | + #env['LIBPATH'] = env['BOOST_LIBS'] | |
| 99 | + pass | |
| 100 | +else: | |
| 101 | + env.Append(LIBPATH = ['/usr/lib', '/usr/local/lib']) | |
| 102 | + | |
| 103 | +# Compiler specific warning flags | |
| 104 | +if env['CXX'].startswith('g++'): | |
| 105 | + #env.Append(CCFLAGS = ['-Wconversion']) | |
| 106 | + env.Append(CCFLAGS = ['-Wcast-align']) | |
| 107 | + env.Append(CCFLAGS = ['-Wshadow']) | |
| 108 | + env.Append(CCFLAGS = ['-Wunused-parameter']) | |
| 109 | +elif env['CXX'].startswith('clang++'): | |
| 110 | + #env.Append(CCFLAGS = ['-Wcast-align']) | |
| 111 | + #env.Append(CCFLAGS = ['-Wglobal-constructors']) | |
| 112 | + #env.Append(CCFLAGS = ['-Wconversion']) | |
| 113 | + env.Append(CCFLAGS = ['-Wno-padded']) | |
| 114 | + env.Append(CCFLAGS = ['-Wshadow']) | |
| 115 | + env.Append(CCFLAGS = ['-Wunused-parameter']) | |
| 116 | + | |
| 117 | + env.Append(CCFLAGS = ['-Wsometimes-uninitialized']) | |
| 118 | + env.Append(CCFLAGS = ['-Wuninitialized']) | |
| 119 | + | |
| 120 | + #env.Append(CCFLAGS = ['-Weverything']) | |
| 121 | + #env.Append(CCFLAGS = ['-Wno-documentation']) | |
| 122 | + #env.Append(CCFLAGS = ['-Wno-weak-vtables']) | |
| 123 | + #env.Append(CCFLAGS = ['-Wno-global-constructors']) | |
| 124 | + #env.Append(CCFLAGS = ['-Wno-sign-conversion']) | |
| 125 | + #env.Append(CCFLAGS = ['-Wno-exit-time-destructors']) | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + # Wpadded | |
| 131 | + # Wsign-conversion | |
| 132 | + # | |
| 133 | + | |
| 134 | +platform_libs = [] | |
| 135 | +tls_libs = [] | |
| 136 | + | |
| 137 | +tls_build = False | |
| 138 | + | |
| 139 | +if env['PLATFORM'] == 'posix': | |
| 140 | + platform_libs = ['pthread', 'rt'] | |
| 141 | + tls_libs = ['ssl', 'crypto'] | |
| 142 | + tls_build = True | |
| 143 | +elif env['PLATFORM'] == 'darwin': | |
| 144 | + tls_libs = ['ssl', 'crypto'] | |
| 145 | + tls_build = True | |
| 146 | +elif env['PLATFORM'].startswith('win'): | |
| 147 | + # Win/VC++ supports autolinking. nothing to do. | |
| 148 | + pass | |
| 149 | + | |
| 150 | +## Append WebSocket++ path | |
| 151 | +env.Append(CPPPATH = ['#']) | |
| 152 | + | |
| 153 | +##### Set up C++11 environment | |
| 154 | +polyfill_libs = [] # boost libraries used as drop in replacements for incomplete | |
| 155 | + # C++11 STL implementations | |
| 156 | +env_cpp11 = env.Clone () | |
| 157 | + | |
| 158 | +if env_cpp11['CXX'].startswith('g++'): | |
| 159 | + # TODO: check g++ version | |
| 160 | + GCC_VERSION = commands.getoutput(env_cpp11['CXX'] + ' -dumpversion') | |
| 161 | + | |
| 162 | + if GCC_VERSION > "4.4.0": | |
| 163 | + print "C++11 build environment partially enabled" | |
| 164 | + env_cpp11.Append(WSPP_CPP11_ENABLED = "true",CXXFLAGS = ['-std=c++0x'],TOOLSET = ['g++'],CPPDEFINES = ['_WEBSOCKETPP_CPP11_STL_']) | |
| 165 | + else: | |
| 166 | + print "C++11 build environment is not supported on this version of G++" | |
| 167 | +elif env_cpp11['CXX'].startswith('clang++'): | |
| 168 | + print "C++11 build environment enabled" | |
| 169 | + env.Append(CXXFLANGS = ['-stdlib=libc++'],LINKFLAGS=['-stdlib=libc++']) | |
| 170 | + env_cpp11.Append(WSPP_CPP11_ENABLED = "true",CXXFLAGS = ['-std=c++0x','-stdlib=libc++'],LINKFLAGS = ['-stdlib=libc++'],TOOLSET = ['clang++'],CPPDEFINES = ['_WEBSOCKETPP_CPP11_STL_']) | |
| 171 | + | |
| 172 | + # look for optional second boostroot compiled with clang's libc++ STL library | |
| 173 | + # this prevents warnings/errors when linking code built with two different | |
| 174 | + # incompatible STL libraries. | |
| 175 | + if os.environ.has_key('BOOST_ROOT_CPP11'): | |
| 176 | + env_cpp11['BOOST_INCLUDES'] = os.environ['BOOST_ROOT_CPP11'] | |
| 177 | + env_cpp11['BOOST_LIBS'] = os.path.join(os.environ['BOOST_ROOT_CPP11'], 'stage', 'lib') | |
| 178 | + elif os.environ.has_key('BOOST_INCLUDES_CPP11') and os.environ.has_key('BOOST_LIBS_CPP11'): | |
| 179 | + env_cpp11['BOOST_INCLUDES'] = os.environ['BOOST_INCLUDES_CPP11'] | |
| 180 | + env_cpp11['BOOST_LIBS'] = os.environ['BOOST_LIBS_CPP11'] | |
| 181 | +else: | |
| 182 | + print "C++11 build environment disabled" | |
| 183 | + | |
| 184 | +# if the build system is known to allow the isystem modifier for library include | |
| 185 | +# values then use it for the boost libraries. Otherwise just add them to the | |
| 186 | +# regular CPPPATH values. | |
| 187 | +if env['CXX'].startswith('g++') or env['CXX'].startswith('clang'): | |
| 188 | + env.Append(CPPFLAGS = '-isystem ' + env['BOOST_INCLUDES']) | |
| 189 | +else: | |
| 190 | + env.Append(CPPPATH = [env['BOOST_INCLUDES']]) | |
| 191 | +env.Append(LIBPATH = [env['BOOST_LIBS']]) | |
| 192 | + | |
| 193 | +# if the build system is known to allow the isystem modifier for library include | |
| 194 | +# values then use it for the boost libraries. Otherwise just add them to the | |
| 195 | +# regular CPPPATH values. | |
| 196 | +if env_cpp11['CXX'].startswith('g++') or env_cpp11['CXX'].startswith('clang'): | |
| 197 | + env_cpp11.Append(CPPFLAGS = '-isystem ' + env_cpp11['BOOST_INCLUDES']) | |
| 198 | +else: | |
| 199 | + env_cpp11.Append(CPPPATH = [env_cpp11['BOOST_INCLUDES']]) | |
| 200 | +env_cpp11.Append(LIBPATH = [env_cpp11['BOOST_LIBS']]) | |
| 201 | + | |
| 202 | +releasedir = 'build/release/' | |
| 203 | +debugdir = 'build/debug/' | |
| 204 | +testdir = 'build/test/' | |
| 205 | +builddir = releasedir | |
| 206 | + | |
| 207 | +Export('env') | |
| 208 | +Export('env_cpp11') | |
| 209 | +Export('platform_libs') | |
| 210 | +Export('boostlibs') | |
| 211 | +Export('tls_libs') | |
| 212 | +Export('polyfill_libs') | |
| 213 | + | |
| 214 | +## END OF CONFIG !! | |
| 215 | + | |
| 216 | +## TARGETS: | |
| 217 | + | |
| 218 | +if not env['PLATFORM'].startswith('win'): | |
| 219 | + # Unit tests, add test folders with SConscript files to to_test list. | |
| 220 | + to_test = ['utility','http','logger','random','processors','message_buffer','extension','transport/iostream','transport/asio','roles','endpoint','connection','transport'] #,'http','processors','connection' | |
| 221 | + | |
| 222 | + for t in to_test: | |
| 223 | + new_tests = SConscript('#/test/'+t+'/SConscript',variant_dir = testdir + t, duplicate = 0) | |
| 224 | + for a in new_tests: | |
| 225 | + new_alias = Alias('test', [a], a.abspath) | |
| 226 | + AlwaysBuild(new_alias) | |
| 227 | + | |
| 228 | +# Main test application | |
| 229 | +#main = SConscript('#/examples/dev/SConscript',variant_dir = builddir + 'dev',duplicate = 0) | |
| 230 | + | |
| 231 | +# echo_server | |
| 232 | +echo_server = SConscript('#/examples/echo_server/SConscript',variant_dir = builddir + 'echo_server',duplicate = 0) | |
| 233 | + | |
| 234 | +# echo_client | |
| 235 | +echo_client = SConscript('#/examples/echo_client/SConscript',variant_dir = builddir + 'echo_client',duplicate = 0) | |
| 236 | + | |
| 237 | +# print_client | |
| 238 | +print_client = SConscript('#/examples/print_client/SConscript',variant_dir = builddir + 'print_client',duplicate = 0) | |
| 239 | + | |
| 240 | +# echo_server_tls | |
| 241 | +if tls_build: | |
| 242 | + echo_server_tls = SConscript('#/examples/echo_server_tls/SConscript',variant_dir = builddir + 'echo_server_tls',duplicate = 0) | |
| 243 | + echo_server_both = SConscript('#/examples/echo_server_both/SConscript',variant_dir = builddir + 'echo_server_both',duplicate = 0) | |
| 244 | + print_client_tls = SConscript('#/examples/print_client_tls/SConscript',variant_dir = builddir + 'print_client_tls',duplicate = 0) | |
| 245 | + | |
| 246 | +# broadcast_server | |
| 247 | +broadcast_server = SConscript('#/examples/broadcast_server/SConscript',variant_dir = builddir + 'broadcast_server',duplicate = 0) | |
| 248 | + | |
| 249 | +# testee_server | |
| 250 | +testee_server = SConscript('#/examples/testee_server/SConscript',variant_dir = builddir + 'testee_server',duplicate = 0) | |
| 251 | + | |
| 252 | +# testee_client | |
| 253 | +testee_client = SConscript('#/examples/testee_client/SConscript',variant_dir = builddir + 'testee_client',duplicate = 0) | |
| 254 | + | |
| 255 | +# scratch_client | |
| 256 | +scratch_client = SConscript('#/examples/scratch_client/SConscript',variant_dir = builddir + 'scratch_client',duplicate = 0) | |
| 257 | + | |
| 258 | +# scratch_server | |
| 259 | +scratch_server = SConscript('#/examples/scratch_server/SConscript',variant_dir = builddir + 'scratch_server',duplicate = 0) | |
| 260 | + | |
| 261 | + | |
| 262 | +# debug_client | |
| 263 | +debug_client = SConscript('#/examples/debug_client/SConscript',variant_dir = builddir + 'debug_client',duplicate = 0) | |
| 264 | + | |
| 265 | +# debug_server | |
| 266 | +debug_server = SConscript('#/examples/debug_server/SConscript',variant_dir = builddir + 'debug_server',duplicate = 0) | |
| 267 | + | |
| 268 | +# subprotocol_server | |
| 269 | +subprotocol_server = SConscript('#/examples/subprotocol_server/SConscript',variant_dir = builddir + 'subprotocol_server',duplicate = 0) | |
| 270 | + | |
| 271 | +# telemetry_server | |
| 272 | +telemetry_server = SConscript('#/examples/telemetry_server/SConscript',variant_dir = builddir + 'telemetry_server',duplicate = 0) | |
| 273 | + | |
| 274 | +# external_io_service | |
| 275 | +external_io_service = SConscript('#/examples/external_io_service/SConscript',variant_dir = builddir + 'external_io_service',duplicate = 0) | |
| 276 | + | |
| 277 | +if not env['PLATFORM'].startswith('win'): | |
| 278 | + # iostream_server | |
| 279 | + iostream_server = SConscript('#/examples/iostream_server/SConscript',variant_dir = builddir + 'iostream_server',duplicate = 0) | |
| 280 | + | |
| 281 | + # telemetry_client | |
| 282 | + telemetry_client = SConscript('#/examples/telemetry_client/SConscript',variant_dir = builddir + 'telemetry_client',duplicate = 0) | |
| 283 | + | |
| 284 | + # print_server | |
| 285 | + print_server = SConscript('#/examples/print_server/SConscript',variant_dir = builddir + 'print_server',duplicate = 0) | ... | ... |
3rdparty/websocketpp-0.8.2/changelog.md
0 → 100644
| 1 | +HEAD | |
| 2 | + | |
| 3 | +0.8.2 - 2020-04-19 | |
| 4 | +- Examples: Update print_client_tls example to remove use of deprecated | |
| 5 | + OpenSSL functions. | |
| 6 | +- Compatibility: Removes the use of make_shared in a number of cases where | |
| 7 | + it would be incompatible with newer versions of ASIO. Thank you Stefan | |
| 8 | + Floeren for the patch. #810 #814 #862 #843 #794 #808 | |
| 9 | +- CMake: Update cmake installer to better handle dependencies when using | |
| 10 | + g++ on MacOS. Thank you Luca Palano for reporting and a patch. #831 | |
| 11 | +- CMake: Update cmake installer to use a variable for the include directory | |
| 12 | + improving the ability of the install to be customized. THank you Schrijvers | |
| 13 | + Luc and Gianfranco Costamanga for reporting and a patch. #842 | |
| 14 | + | |
| 15 | +0.8.1 - 2018-07-16 | |
| 16 | +Note: This release does not change library behavior. It only corrects issues | |
| 17 | +in the installer and test system. | |
| 18 | +- Test Suite: Adjust test suite to match behavior introduced in 0.8.0. Thank | |
| 19 | + you Gianfranco Costamagna for reporting and a patch. #731 | |
| 20 | +- CMake: Update cmake installer to only install library files globally. | |
| 21 | + Thank you Gianfraco Costamanga for reporting and a patch. #732 | |
| 22 | + | |
| 23 | +0.8.0 - 2018-07-12 | |
| 24 | +- Examples: Add `print_client` example. This demonstrates a minimal non-TLS | |
| 25 | + client that connects to a server and prints out the messages it receives. | |
| 26 | +- Examples: Add `print_client_tls` example. This demonstrates a minimal TLS | |
| 27 | + client, including basic support via Asio+OpenSSL for certificate chain | |
| 28 | + and hostname verification. | |
| 29 | +- Feature: Add getter for all headers to the HTTP parsers. This allows a | |
| 30 | + wrapping library to enumerate all headers to send upstream. Thank you Jupp | |
| 31 | + Müller for reporting and an initial pull request. | |
| 32 | +- Improvement: Move the `socket_init_handler` to execute as a part of `init_asio` | |
| 33 | + rather than connection `pre_init`. This allows setting of socket options prior | |
| 34 | + to the bind/listen/accept system calls. Thank you ChristianRobl3D for | |
| 35 | + reporting #530. | |
| 36 | +- Improvement: Timers in transport integration tests should only fail if their | |
| 37 | + own test times out, rather than any test. #643 Thank you Alex Korotkin for | |
| 38 | + reporting and a patch. | |
| 39 | +- Improvement: Preserve transport layer error codes in more cases, particularly | |
| 40 | + during calls to `endpoint::listen`. #652 Thank you vadz for reporting and | |
| 41 | + patches. | |
| 42 | +- Compatibility: Make sure the chrono library used by Boost/Asio is in sync | |
| 43 | + with what the websocketpp is using. Thank you Flow86 for reporting and a | |
| 44 | + patch. | |
| 45 | +- Compatibility: Update `telemetry_client` to use a slightly more cross platform | |
| 46 | + method of sleeping. Should work on windows now. Thank you Meir Yanovich for | |
| 47 | + reporting. | |
| 48 | +- Compatibility: Updated permessage-deflate support to reflect that the zlib | |
| 49 | + library does not actually support a sliding window size of 256 bits. | |
| 50 | + WebSocket++ will no longer negotiate 256 bit deflate windows. If the user | |
| 51 | + of the library tries to request a 256 bit window a 512 bit window will be | |
| 52 | + specified instead (This was the previous behavior). #596 #653 Thank you | |
| 53 | + Vinnie Falco and Gianfranco Costamagna for reporting. | |
| 54 | +- Compatibility: Better error handling and logging in cases where extension | |
| 55 | + requests parse correctly but negotiation fails. | |
| 56 | +- Compatibility: Removed custom handling of `SSL_R_SHORT_READ` error condition. | |
| 57 | + This error code no longer exists in modern versions of OpenSSL and causes | |
| 58 | + a build error. It wasn't being used for anything particularly important | |
| 59 | + (slightly improving error reporting) and there isn't a great replacement. | |
| 60 | + #599 Thank you Gianfranco Costamagna for reporting. | |
| 61 | +- Compatibility: Add missing `<stdint>` headers. Fixes issues with g++ 5.4.0. | |
| 62 | + #638 Thank you Alex Korotkin for reporting and a patch. | |
| 63 | +- Compatibility: Remove the use of `std::auto_ptr` and `std::binary_function` | |
| 64 | + from builds with C++11 or later. These features are deprecated and were | |
| 65 | + removed entirely in C++17. This change allows building WebSocket++ on | |
| 66 | + C++17 compilers. #592 Thank you Michal Fojtak for reporting and a patch | |
| 67 | +- Compatibility: Add 1014 close code and adds missing descriptions for codes | |
| 68 | + 1012 and 1013. #589 Thank you jbwdevries and ronneke1996 for reporting and | |
| 69 | + patches. | |
| 70 | +- Compatibility: Add hooks to support `mingw-std-threads` C++11 thread and mutex | |
| 71 | + polyfill library as an alternative to Boost. #608 Thank you Peter Taylor for | |
| 72 | + reporting and an initial patch. | |
| 73 | +- Compatibility: Changed the handshake connection token to 'Upgrade' from | |
| 74 | + 'upgrade'. Technically this header is supposed to be processed case | |
| 75 | + insensitively. In practice, there are browsers (such as Edge) that don't do | |
| 76 | + this and they tend to use the uppercase value used as an example in RFC6455. | |
| 77 | + Thank you Johann Bauer for reporting and a patch. #727 | |
| 78 | +- Bug: Store loggers in shared pointers to avoid crashes related to connections | |
| 79 | + trying to write logs entries after their respective endpoint has been | |
| 80 | + deallocated. Thank you Thalhammer for reporting and Jupp Müller for the | |
| 81 | + patch. #539 #501 | |
| 82 | +- Bug: Change default listen backlog from 0 to `socket_base::max_connections`. | |
| 83 | + #549. Thank you derwassi and zwelab for reporting and na1pir for providing | |
| 84 | + access to hardware to debug the issue. | |
| 85 | +- Bug: Fix a crash in the accept loop when `get_connection` fails. #551 Thank you | |
| 86 | + Walter Gray for a patch. | |
| 87 | +- Bug/Documentation: Fix incorrect example code that used | |
| 88 | + `websocketpp::lib::error_code` instead of `websocketpp::exception`. Thank you | |
| 89 | + heretic13 for reporting | |
| 90 | +- Bug: Fix uninitialized shared pointer in Asio transport test suite. #647 | |
| 91 | + Thank you Alex Korotkin for reporting and a patch. | |
| 92 | +- Bug: Fix a thread safety issue in the permessage-deflate extension that | |
| 93 | + caused message corruption when sending compressed messages from a different | |
| 94 | + thread than the main I/O thread. #615 Thank you KyleNyenhuis and Pieter De | |
| 95 | + Gendt for reporting and a patch. | |
| 96 | +- Bug: Fix an undefined behavior issue performing a 64 bit wide shift on a 64 | |
| 97 | + bit value. #636 Thank you Gregor Jasny for reporting and a patch | |
| 98 | +- Bug: Fix some compile issues with ASIO_STANDALONE. #662 #665 Thank you | |
| 99 | + chronoxor and Guillaume Egles for reporting and patches. | |
| 100 | + | |
| 101 | +0.7.0 - 2016-02-22 | |
| 102 | +- MINOR BREAKING SOCKET POLICY CHANGE: Asio transport socket policy method | |
| 103 | + `cancel_socket` will now return `lib::asio::error_code` instead of `void`. | |
| 104 | + Custom Asio transport socket policies will need to be updated accordingly. | |
| 105 | + This does not affect anyone using the bundled socket policies. | |
| 106 | +- Feature: Basic support for the permessage-deflate extension. #344 | |
| 107 | +- Feature: Allow accessing the local endpoint when using the Asio transport. | |
| 108 | + This allows inspection of the address and port in cases where they are chosen | |
| 109 | + by the operating system rather than the user. Thank you Andreas Weis and | |
| 110 | + Muzahid Hussain for reporting and related code. #458 | |
| 111 | +- Feature: Add support for subprotocols in Hybi00. Thank you Lukas Obermann | |
| 112 | + for reporting and a patch. #518 | |
| 113 | +- Feature: Adds `tcp_pre_bind handler` to Asio transport. This allows setting | |
| 114 | + arbitrary socket options after the listen acceptor has been created but before | |
| 115 | + the socket bind has been performed. #634 #439 Thank you Gregor Jasny for | |
| 116 | + the patch. | |
| 117 | +- Improvement: Better automatic std::chrono feature detection for Visual Studio | |
| 118 | +- Improvement: Major refactoring to bundled CMake build system. CMake can now be | |
| 119 | + used to build all of the examples and the test suite. Thank you Thijs Wenker | |
| 120 | + for a significant portion of this code. #378, #435, #449 | |
| 121 | +- Improvement: In build environments where `lib::error_code` and | |
| 122 | + `lib::asio::error_code` match (such as using `boost::asio` with | |
| 123 | + `boost::system_error` or standalone asio with `std::system_error`, transport | |
| 124 | + errors are passed through natively rather than being reported as a translated | |
| 125 | + `pass_through` error type. | |
| 126 | +- Improvement: Add a `get_transport_error` method to Asio transport connections | |
| 127 | + to allow retrieving a machine readable native transport error. | |
| 128 | +- Improvement: Add `connection::get_response`, `connection::get_response_code`, | |
| 129 | + and `connection::get_response_msg` methods to allow accessing additional | |
| 130 | + information about the HTTP responses that WebSocket++ sends. #465 Thank you | |
| 131 | + Flow86 for reporting. | |
| 132 | +- Improvement: Removes use of empty strings ("") in favor of `string::clear()` | |
| 133 | + and `string::empty()`. This avoids generating unnecessary temporary objects. | |
| 134 | + #468 Thank you Vladislav Yaroslavlev for reporting and a patch. | |
| 135 | +- Documentation: Adds an example demonstrating the use of external `io_service` | |
| 136 | +- Documentation: Adds a simple `echo_client` example. | |
| 137 | +- Documentation: Begins migration of the web based user manual into Doxygen. | |
| 138 | +- Bug: Fix memory leak when `init_asio` produces an error. #454 Thank you Mark | |
| 139 | + Grimes for reporting and fixing. | |
| 140 | +- Bug: Fix crash when processing a specially crafted HTTP header. Thank you Eli | |
| 141 | + Fidler for reporting, test cases, and a patch. #456 | |
| 142 | +- Bug: Fix an issue where standalone Asio builds that use TLS would not compile | |
| 143 | + due to lingering boost code. #448 Thank you mjsp for reporting | |
| 144 | +- Bug: Fix an issue where canceling a socket could throw an exception on some | |
| 145 | + older Windows XP platforms. It now prints an appropriate set of log messages | |
| 146 | + instead. Thank you Thijs Wenker for reporting and researching solutions. #460 | |
| 147 | +- Bug: Fix an issue where deferred HTTP connections that start sending a very | |
| 148 | + long response before their HTTP handler ends would result in a second set of | |
| 149 | + HTTP headers being injected into the output. Thank you Kevin Smith for | |
| 150 | + reporting and providing test case details. #443 | |
| 151 | +- Bug: Fix an issue where the wrong type of strand was being created. Thank you | |
| 152 | + Bastien Brunnenstein for reporting and a patch. #462 | |
| 153 | +- Bug: Fix an issue where TLS includes were broken for Asio Standalone builds. | |
| 154 | + Thank you giachi and Bastien Brunnenstein for reporting. #491 | |
| 155 | +- Bug: Remove the use of cached read and write handlers in the Asio transport. | |
| 156 | + This feature caused memory leaks when the `io_service` the connection was | |
| 157 | + running on was abruptly stopped. There isn't a clean and safe way of using | |
| 158 | + this optimization without global state and the associated locks. The locks | |
| 159 | + perform worse. Thank you Xavier Gibert for reporting, test cases, and code. | |
| 160 | + Fixes #490. | |
| 161 | +- Bug: Fix a heap buffer overflow when checking very short URIs. Thank you | |
| 162 | + Xavier Gibert for reporting and a patch #524 | |
| 163 | +- Compatibility: Fixes a number of build & config issues on Visual Studio 2015 | |
| 164 | +- Compatibility: Removes non-standards compliant masking behavior. #395, #469 | |
| 165 | +- Compatibility: Replace deprecated use of `auto_ptr` on systems where | |
| 166 | + `unique_ptr` is available. | |
| 167 | + | |
| 168 | +0.6.0 - 2015-06-02 | |
| 169 | +- MINOR BREAKING TRANSPORT POLICY CHANGE: Custom transport policies will now be | |
| 170 | + required to include a new method `void set_uri(uri_ptr u)`. An implementation | |
| 171 | + is not required. The stub transport policy includes an example stub method | |
| 172 | + that can be added to any existing custom transport policy to fulfill this | |
| 173 | + requirement. This does not affect anyone using the bundled transports or | |
| 174 | + configs. | |
| 175 | +- MINOR BREAKING SOCKET POLICY CHANGE: Custom asio transport socket policies | |
| 176 | + will now be required to include a new method `void set_uri(uri_ptr u)`. Like | |
| 177 | + with the transport layer, an implementation is not required. This does not | |
| 178 | + affect anyone using the bundled socket policies. | |
| 179 | +- MINOR BREAKING DEPENDENCY CHANGE: When using Boost versions greater than or | |
| 180 | + equal to 1.49 in C++03 mode, `libboost-chrono` is needed now instead of | |
| 181 | + `libboost-date_time`. Users with C++11 compilers or using Boost versions 1.48 | |
| 182 | + and earlier are not affected. Note: This change affects the bundled unit test | |
| 183 | + suite. | |
| 184 | +- Feature: WebSocket++ Asio transport policy can now be used with the standalone | |
| 185 | + version of Asio (1.8.0+) when a C++11 compiler and standard library are | |
| 186 | + present. This means that it is possible now to use WebSocket++'s Asio | |
| 187 | + transport entirely without Boost. Thank you Robert Seiler for proof of concept | |
| 188 | + code that was used as a guide for this implementation. Fixes #324 | |
| 189 | +- Feature: Adds a vectored/scatter-gather write handler to the iostream | |
| 190 | + transport. | |
| 191 | +- Feature: Adds the ability to defer sending an HTTP response until sometime | |
| 192 | + after the `http_handler` is run. This allows processing of long running http | |
| 193 | + handlers to defer their response until it is ready without blocking the | |
| 194 | + network thread. references #425 | |
| 195 | +- Improvement: `echo_server_tls` has been update to demonstrate how to configure | |
| 196 | + it for Mozilla's recommended intermediate and modern TLS security profiles. | |
| 197 | +- Improvement: `endpoint::set_timer` now uses a steady clock provided by | |
| 198 | + `boost::chrono` or `std::chrono` where available instead of the non-monotonic | |
| 199 | + system clock. Thank you breyed for reporting. fixes #241 | |
| 200 | +- Improvement: Outgoing TLS connections to servers using the SNI extension to | |
| 201 | + choose a certificate will now work. Thank you moozzyk for reporting. | |
| 202 | + Fixes #400 | |
| 203 | +- Improvement: Removes an unnecessary mutex lock in `get_con_from_hdl`. | |
| 204 | +- Cleanup: Asio transport policy has been refactored to remove many Boost | |
| 205 | + dependencies. On C++03 compilers the `boost::noncopyable` dependency has been | |
| 206 | + removed and the `boost::date_time` dependency has been replaced with the newer | |
| 207 | + `boost::chrono` when possible. On C++11 compilers the `boost::aligned_storage` | |
| 208 | + and `boost::date_time` dependencies are gone, replaced with equivalent C++11 | |
| 209 | + standard library features. | |
| 210 | +- Bug: Fixes a potential dangling pointer and inconsistent error message | |
| 211 | + handling in `websocketpp::exception`. #432 Thank you Tom Swirly for the fix. | |
| 212 | + | |
| 213 | +0.5.1 - 2015-02-27 | |
| 214 | +- Bug: Fixes an issue where some frame data was counted against the max header | |
| 215 | + size limit, resulting in connections that included a lot of frame data | |
| 216 | + immediately after the opening handshake to fail. | |
| 217 | +- Bug: Fix a typo in the name of the set method for `max_http_body_size`. #406 | |
| 218 | + Thank you jplatte for reporting. | |
| 219 | + | |
| 220 | +0.5.0 - 2015-01-22 | |
| 221 | +- BREAKING UTILITY CHANGE: Deprecated methods `http::parser::parse_headers`, | |
| 222 | + `http::response::parse_complete`, and `http::request::parse_complete` have | |
| 223 | + been removed. | |
| 224 | +- Security: Disabled SSLv3 in example servers. | |
| 225 | +- Feature: Adds basic support for accessing HTTP request bodies in the http | |
| 226 | + handler. #181 | |
| 227 | +- Feature: Adds the ability to register a shutdown handler when using the | |
| 228 | + iostream transport. This provides a clean interface for triggering the shut | |
| 229 | + down of external sockets and other cleanup without hooking in to higher level | |
| 230 | + WebSocket handlers. | |
| 231 | +- Feature: Adds the ability to register a write handler when using the iostream | |
| 232 | + transport. This handler can be used to handle transport output in place of | |
| 233 | + registering an ostream to write to. | |
| 234 | +- Feature: Adds a new logging policy that outputs to syslog. #386 Thank you Tom | |
| 235 | + Hughes for submitting the initial version of this policy. | |
| 236 | +- Improvement: Message payload logging now prints text for text messages rather | |
| 237 | + than binary. | |
| 238 | +- Improvement: Overhaul of handshake state machine. Should make it impossible | |
| 239 | + for exceptions to bubble out of transport methods like `io_service::run`. | |
| 240 | +- Improvement: Overhaul of handshake error reporting. Fail handler error codes | |
| 241 | + will be more detailed and precise. Adds new [fail] and [http] logging channels | |
| 242 | + that log failed websocket connections and successful HTTP connections | |
| 243 | + respectively. A new aggregate channel package, `alevel::access_core`, allows | |
| 244 | + enabling connect, disconnect, fail, and http together. Successful HTTP | |
| 245 | + connections will no longer trigger a fail handler. | |
| 246 | +- Improvement: Ability to terminate connection during an http handler to cleanly | |
| 247 | + suppress the default outgoing HTTP response. | |
| 248 | +- Documentation: Add Sending & Receiving Messages step to chapter one of the | |
| 249 | + `utility_client` tutorial. Update `utility_client` example to match. | |
| 250 | +- Cleanup: Removes unused files & STL includes. Adds required STL includes. | |
| 251 | + Normalizes include order. | |
| 252 | +- Bug: Fixes a fatal state error when a handshake response is completed | |
| 253 | + immediately after that handshake times out. #389 | |
| 254 | +- Bug: MinGW fixes; C++11 feature detection, localtime use. #393 Thank you | |
| 255 | + Schebb for reporting, code, and testing. | |
| 256 | +- Bug: Fixes an issue where `websocketpp::exception::what()` could return an out | |
| 257 | + of scope pointer. #397 Thank you fabioang for reporting. | |
| 258 | +- Bug: Fixes an issue where endpoints were not reset properly after a call to | |
| 259 | + `endpoint::listen` failed. #390 Thank you wyyqyl for reporting. | |
| 260 | + | |
| 261 | +0.4.0 - 2014-11-04 | |
| 262 | +- BREAKING API CHANGE: All WebSocket++ methods now throw an exception of type | |
| 263 | + `websocketpp::exception` which derives from `std::exception`. This normalizes | |
| 264 | + all exception types under the standard exception hierarchy and allows | |
| 265 | + WebSocket++ exceptions to be caught in the same statement as others. The error | |
| 266 | + code that was previously thrown is wrapped in the exception object and can be | |
| 267 | + accessed via the `websocketpp::exception::code()` method. | |
| 268 | +- BREAKING API CHANGE: Custom logging policies have some new required | |
| 269 | + constructors that take generic config settings rather than pointers to | |
| 270 | + std::ostreams. This allows writing logging policies that do not involve the | |
| 271 | + use of std::ostream. This does not affect anyone using the built in logging | |
| 272 | + policies. | |
| 273 | +- BREAKING UTILITY CHANGE: `websocketpp::lib::net::htonll` and | |
| 274 | + `websocketpp::lib::net::ntohll` have been prefixed with an underscore to avoid | |
| 275 | + conflicts with similarly named macros in some operating systems. If you are | |
| 276 | + using the WebSocket++ provided 64 bit host/network byte order functions you | |
| 277 | + will need to switch to the prefixed versions. | |
| 278 | +- BREAKING UTILITY CHANGE: The signature of `base64_encode` has changed from | |
| 279 | + `websocketpp::base64_encode(unsigned char const *, unsigned int)` to | |
| 280 | + `websocketpp::base64_encode(unsigned char const *, size_t)`. | |
| 281 | +- BREAKING UTILITY CHANGE: The signature of `sha1::calc` has changed from | |
| 282 | + `websocketpp::sha1::calc(void const *, int, unsigned char *)` to | |
| 283 | + `websocketpp::sha1::calc(void const *, size_t, unsigned char *)` | |
| 284 | +- Feature: Adds incomplete `minimal_server` and `minimal_client` configs that | |
| 285 | + can be used to build custom configs without pulling in the dependencies of | |
| 286 | + `core` or `core_client`. These configs will offer a stable base config to | |
| 287 | + future-proof custom configs. | |
| 288 | +- Improvement: Core library no longer has std::iostream as a dependency. | |
| 289 | + std::iostream is still required for the optional iostream logging policy and | |
| 290 | + iostream transport. | |
| 291 | +- Bug: C++11 Chrono support was being incorrectly detected by the `boost_config` | |
| 292 | + header. Thank you Max Dmitrichenko for reporting and a patch. | |
| 293 | +- Bug: use of `std::put_time` is now guarded by a unique flag rather than a | |
| 294 | + chrono library flag. Thank you Max Dmitrichenko for reporting. | |
| 295 | +- Bug: Fixes non-thread safe use of std::localtime. #347 #383 | |
| 296 | +- Compatibility: Adjust usage of std::min to be more compatible with systems | |
| 297 | + that define a min(...) macro. | |
| 298 | +- Compatibility: Removes unused parameters from all library, test, and example | |
| 299 | + code. This assists with those developing with -Werror and -Wunused-parameter | |
| 300 | + #376 | |
| 301 | +- Compatibility: Renames ntohll and htonll methods to avoid conflicts with | |
| 302 | + platform specific macros. #358 #381, #382 Thank you logotype, unphased, | |
| 303 | + svendjo | |
| 304 | +- Cleanup: Removes unused functions, fixes variable shadow warnings, normalizes | |
| 305 | + all whitespace in library, examples, and tests to 4 spaces. #376 | |
| 306 | + | |
| 307 | +0.3.0 - 2014-08-10 | |
| 308 | +- Feature: Adds `start_perpetual` and `stop_perpetual` methods to asio transport | |
| 309 | + These may be used to replace manually managed `asio::io_service::work` objects | |
| 310 | +- Feature: Allow setting pong and handshake timeouts at runtime. | |
| 311 | +- Feature: Allows changing the listen backlog queue length. | |
| 312 | +- Feature: Split tcp init into pre and post init. | |
| 313 | +- Feature: Adds URI method to extract query string from URI. Thank you Banaan | |
| 314 | + for code. #298 | |
| 315 | +- Feature: Adds a compile time switch to asio transport config to disable | |
| 316 | + certain multithreading features (some locks, asio strands) | |
| 317 | +- Feature: Adds the ability to pause reading on a connection. Paused connections | |
| 318 | + will not read more data from their socket, allowing TCP flow control to work | |
| 319 | + without blocking the main thread. | |
| 320 | +- Feature: Adds the ability to specify whether or not to use the `SO_REUSEADDR` | |
| 321 | + TCP socket option. The default for this value has been changed from `true` to | |
| 322 | + `false`. | |
| 323 | +- Feature: Adds the ability to specify a maximum message size. | |
| 324 | +- Feature: Adds `close::status::get_string(...)` method to look up a human | |
| 325 | + readable string given a close code value. | |
| 326 | +- Feature: Adds `connection::read_all(...)` method to iostream transport as a | |
| 327 | + convenience method for reading all data into the connection buffer without the | |
| 328 | + end user needing to manually loop on `read_some`. | |
| 329 | +- Improvement: Open, close, and pong timeouts can be disabled entirely by | |
| 330 | + setting their duration to 0. | |
| 331 | +- Improvement: Numerous performance improvements. Including: tuned default | |
| 332 | + buffer sizes based on profiling, caching of handler binding for async | |
| 333 | + reads/writes, non-malloc allocators for read/write handlers, disabling of a | |
| 334 | + number of questionably useful range sanity checks in tight inner loops. | |
| 335 | +- Improvement: Cleaned up the handling of TLS related errors. TLS errors will | |
| 336 | + now be reported with more detail on the info channel rather than all being | |
| 337 | + `tls_short_read` or `pass_through`. In addition, many cases where a TLS short | |
| 338 | + read was in fact expected are no longer classified as errors. Expected TLS | |
| 339 | + short reads and quasi-expected socket shutdown related errors will no longer | |
| 340 | + be reported as unclean WebSocket shutdowns to the application. Information | |
| 341 | + about them will remain in the info error channel for debugging purposes. | |
| 342 | +- Improvement: `start_accept` and `listen` errors are now reported to the caller | |
| 343 | + either via an exception or an ec parameter. | |
| 344 | +- Improvement: Outgoing writes are now batched for improved message throughput | |
| 345 | + and reduced system call and TCP frame overhead. | |
| 346 | +- Bug: Fix some cases of calls to empty lib::function objects. | |
| 347 | +- Bug: Fix memory leak of connection objects due to cached handlers holding on to | |
| 348 | + reference counted pointers. #310 Thank you otaras for reporting. | |
| 349 | +- Bug: Fix issue with const endpoint accessors (such as `get_user_agent`) not | |
| 350 | + compiling due to non-const mutex use. #292 Thank you logofive for reporting. | |
| 351 | +- Bug: Fix handler allocation crash with multithreaded `io_service`. | |
| 352 | +- Bug: Fixes incorrect whitespace handling in header parsing. #301 Thank you | |
| 353 | + Wolfram Schroers for reporting | |
| 354 | +- Bug: Fix a crash when parsing empty HTTP headers. Thank you Thingol for | |
| 355 | + reporting. | |
| 356 | +- Bug: Fix a crash following use of the `stop_listening` function. Thank you | |
| 357 | + Thingol for reporting. | |
| 358 | +- Bug: Fix use of variable names that shadow function parameters. The library | |
| 359 | + should compile cleanly with -Wshadow now. Thank you giszo for reporting. #318 | |
| 360 | +- Bug: Fix an issue where `set_open_handshake_timeout` was ignored by server | |
| 361 | + code. Thank you Robin Rowe for reporting. | |
| 362 | +- Bug: Fix an issue where custom timeout values weren't being propagated from | |
| 363 | + endpoints to new connections. | |
| 364 | +- Bug: Fix a number of memory leaks related to server connection failures. #323 | |
| 365 | + #333 #334 #335 Thank you droppy and aydany for reporting and patches. | |
| 366 | + reporting. | |
| 367 | +- Compatibility: Fix compile time conflict with Visual Studio's MIN/MAX macros. | |
| 368 | + Thank you Robin Rowe for reporting. | |
| 369 | +- Documentation: Examples and test suite build system now defaults to clang on | |
| 370 | + OS X | |
| 371 | + | |
| 372 | +0.3.0-alpha4 - 2013-10-11 | |
| 373 | +- HTTP requests ending normally are no longer logged as errors. Thank you Banaan | |
| 374 | + for reporting. #294 | |
| 375 | +- Eliminates spurious expired timers in certain error conditions. Thank you | |
| 376 | + Banaan for reporting. #295 | |
| 377 | +- Consolidates all bundled library licenses into the COPYING file. #294 | |
| 378 | +- Updates bundled sha1 library to one with a cleaner interface and more | |
| 379 | + straight-forward license. Thank you lotodore for reporting and Evgeni Golov | |
| 380 | + for reviewing. #294 | |
| 381 | +- Re-introduces strands to asio transport, allowing `io_service` thread pools to | |
| 382 | + be used (with some limitations). | |
| 383 | +- Removes endpoint code that kept track of a connection list that was never used | |
| 384 | + anywhere. Removes a lock and reduces connection creation/deletion complexity | |
| 385 | + from O(log n) to O(1) in the number of connections. | |
| 386 | +- A number of internal changes to transport APIs | |
| 387 | +- Deprecates iostream transport `readsome` in favor of `read_some` which is more | |
| 388 | + consistent with the naming of the rest of the library. | |
| 389 | +- Adds preliminary signaling to iostream transport of eof and fatal transport | |
| 390 | + errors | |
| 391 | +- Updates transport code to use shared pointers rather than raw pointers to | |
| 392 | + prevent asio from retaining pointers to connection methods after the | |
| 393 | + connection goes out of scope. #293 Thank you otaras for reporting. | |
| 394 | +- Fixes an issue where custom headers couldn't be set for client connections | |
| 395 | + Thank you Jerry Win and Wolfram Schroers for reporting. | |
| 396 | +- Fixes a compile error on visual studio when using interrupts. Thank you Javier | |
| 397 | + Rey Neira for reporting this. | |
| 398 | +- Adds new 1012 and 1013 close codes per IANA registry | |
| 399 | +- Add `set_remote_endpoint` method to iostream transport. | |
| 400 | +- Add `set_secure` method to iostream transport. | |
| 401 | +- Fix typo in .gitattributes file. Thank you jstarasov for reporting this. #280 | |
| 402 | +- Add missing locale include. Thank you Toninoso for reporting this. #281 | |
| 403 | +- Refactors `asio_transport` endpoint and adds full documentation and exception | |
| 404 | + free varients of all methods. | |
| 405 | +- Removes `asio_transport` endpoint method cancel(). Use `stop_listen()` instead | |
| 406 | +- Wrap internal `io_service` `run_one()` method | |
| 407 | +- Suppress error when trying to shut down a connection that was already closed | |
| 408 | + | |
| 409 | +0.3.0-alpha3 - 2013-07-16 | |
| 410 | +- Minor refactor to bundled sha1 library | |
| 411 | +- HTTP header comparisons are now case insensitive. #220, #275 | |
| 412 | +- Refactors URI to be exception free and not use regular expressions. This | |
| 413 | + eliminates the dependency on boost or C++11 regex libraries allowing native | |
| 414 | + C++11 usage on GCC 4.4 and higher and significantly reduces staticly built | |
| 415 | + binary sizes. | |
| 416 | +- Updates handling of Server and User-Agent headers to better handle custom | |
| 417 | + settings and allow suppression of these headers for security purposes. | |
| 418 | +- Fix issue where pong timeout handler always fired. Thank you Steven Klassen | |
| 419 | + for reporting this bug. | |
| 420 | +- Add ping and pong endpoint wrapper methods | |
| 421 | +- Add `get_request()` pass through method to connection to allow calling methods | |
| 422 | + specific to the HTTP policy in use. | |
| 423 | +- Fix issue compile error with `WEBSOCKETPP_STRICT_MASKING` enabled and another | |
| 424 | + issue where `WEBSOCKETPP_STRICT_MASKING` was not applied to incoming messages. | |
| 425 | + Thank you Petter Norby for reporting and testing these bugs. #264 | |
| 426 | +- Add additional macro guards for use with boost_config. Thank you breyed | |
| 427 | + for testing and code. #261 | |
| 428 | + | |
| 429 | +0.3.0-alpha2 - 2013-06-09 | |
| 430 | +- Fix a regression that caused servers being sent two close frames in a row | |
| 431 | + to end a connection uncleanly. #259 | |
| 432 | +- Fix a regression that caused spurious frames following a legitimate close | |
| 433 | + frames to erroneously trigger handlers. #258 | |
| 434 | +- Change default HTTP response error code when no http_handler is defined from | |
| 435 | + 500/Internal Server Error to 426/Upgrade Required | |
| 436 | +- Remove timezone from logger timestamp to work around issues with the Windows | |
| 437 | + implementation of strftime. Thank you breyed for testing and code. #257 | |
| 438 | +- Switch integer literals to char literals to improve VCPP compatibility. | |
| 439 | + Thank you breyed for testing and code. #257 | |
| 440 | +- Add MSVCPP warning suppression for the bundled SHA1 library. Thank you breyed | |
| 441 | + for testing and code. #257 | |
| 442 | + | |
| 443 | +0.3.0-alpha1 - 2013-06-09 | |
| 444 | +- Initial Release | ... | ... |
3rdparty/websocketpp-0.8.2/docs/config.dox
0 → 100644
| 1 | +/** \page reference.config Config Reference | |
| 2 | + | |
| 3 | +WebSocket++ uses a config template parameter to supply a number of compile type policy types and default numerical values for buffer sizes, timeouts, security behavior, etc. Swapping policies allows changing certain core library behavior designed to be pluggable. | |
| 4 | + | |
| 5 | +A custom config can be made standalone or can subclass one of the bundled configs and just override a few things. | |
| 6 | + | |
| 7 | +__Example__ | |
| 8 | +``` | |
| 9 | +// some config options may require additional includes or dependencies. | |
| 10 | +// syslog logging policy, for example, requires <syslog.h>, | |
| 11 | +// the permessage deflate settings require zlib. | |
| 12 | +#include <websocketpp/logger/syslog.hpp> | |
| 13 | +#include <websocketpp/extensions/permessage_deflate/enabled.hpp> | |
| 14 | + | |
| 15 | +// Custom server config based on bundled asio config | |
| 16 | +struct custom_server_config : public websocketpp::config::asio { | |
| 17 | + // Replace default stream logger with a syslog logger | |
| 18 | + typedef websocketpp::log::syslog<concurrency_type, websocketpp::log::elevel> elog_type; | |
| 19 | + typedef websocketpp::log::syslog<concurrency_type, websocketpp::log::alevel> alog_type; | |
| 20 | + | |
| 21 | + // Reduce read buffer size to optimize for small messages | |
| 22 | + static const size_t connection_read_buffer_size = 1024; | |
| 23 | + | |
| 24 | + // enable permessage_compress extension | |
| 25 | + struct permessage_deflate_config {}; | |
| 26 | + | |
| 27 | + typedef websocketpp::extensions::permessage_deflate::enabled | |
| 28 | + <permessage_deflate_config> permessage_deflate_type; | |
| 29 | +}; | |
| 30 | + | |
| 31 | +typedef websocketpp::server<custom_server_config> server_endpoint_type; | |
| 32 | +``` | |
| 33 | + | |
| 34 | +Core Config Options | |
| 35 | +------------------- | |
| 36 | + | |
| 37 | +### Policies | |
| 38 | + | |
| 39 | +Policies are classes used to allow clean swapping of behavior without changing the core library | |
| 40 | + | |
| 41 | +| Typedef Name | Effect | | |
| 42 | +| ------------------------- | -------------------------------------- | | |
| 43 | +| concurrency_type | Concurrency policy | | |
| 44 | +| elog_type | Error logger type | | |
| 45 | +| alog_type | Access logger type | | |
| 46 | +| request_type | HTTP request type | | |
| 47 | +| response_type | HTTP response type | | |
| 48 | +| message_type | Type to deliver recieved messages | | |
| 49 | +| con_msg_manager_type | Connection level message manager | | |
| 50 | +| endpoint_msg_manager_type | Endpoint level message manager | | |
| 51 | +| rng_type | Random Number Generation policy | | |
| 52 | +| transport_type | Transport policy to use | | |
| 53 | +| endpoint_base | User overridable Endpoint base class | | |
| 54 | +| connection_base | User overridable Connection base class | | |
| 55 | + | |
| 56 | +### Timeouts Values | |
| 57 | + | |
| 58 | +These represent the length of time (in ms) before the given operation is aborted | |
| 59 | + | |
| 60 | +| Field | Type | Default | Operation | | |
| 61 | +| ----------------------- | ---- | ------- | --------------------------- | | |
| 62 | +| timeout_open_handshake | long | 5000 | Opening handshake | | |
| 63 | +| timeout_close_handshake | long | 5000 | Closing handshake | | |
| 64 | +| timeout_pong | long | 5000 | No pong recieved after ping | | |
| 65 | + | |
| 66 | +### Performance tuning | |
| 67 | + | |
| 68 | +| Field | Type | Default | Meaning | | |
| 69 | +| --------------------------- | ------ | -------- | ------------------------------------------------------------------ | | |
| 70 | +| connection_read_buffer_size | size_t | 16384 | Size of the per-connection read buffer | | |
| 71 | +| enable_multithreading | bool | true | Disabling may reduce locking overhead for single threaded programs | | |
| 72 | + | |
| 73 | +#### Connection Read Buffer | |
| 74 | + | |
| 75 | +Each connection has an internal buffer of this size. A larger value will result in fewer trips through the library and less CPU overhead at the expense of increased memory usage per connection. | |
| 76 | + | |
| 77 | +If your application primarily deals in very large messages you may want to try setting this value higher. | |
| 78 | + | |
| 79 | +If your application has a lot of connections or primarily deals in small messages you may want to try setting this smaller. | |
| 80 | + | |
| 81 | +### Security settings | |
| 82 | + | |
| 83 | +| Field | Type | Default | Effect | | |
| 84 | +| ---------------------- | ------ | ------- | -------------------------------------- | | |
| 85 | +| drop_on_protocol_error | bool | false | Omit close handshake on protocol error | | |
| 86 | +| silent_close | bool | false | Don't return close codes or reasons | | |
| 87 | +| max_message_size | size_t | 32MB | WebSocket max message size limit | | |
| 88 | +| max_http_body_size | size_t | 32MB | HTTP Parser's max body size limit | | |
| 89 | + | |
| 90 | +#### Drop on protocol error | |
| 91 | +Drop connections on protocol error rather than sending a close frame. Off by default. This may result in legitimate messages near the error being dropped as well. It may free up resources otherwise spent dealing with misbehaving clients. | |
| 92 | + | |
| 93 | +#### Silent Close | |
| 94 | +Silence close suppresses the return of detailed connection close information during the closing handshake. This information is useful for debugging and presenting useful errors to end users but may be undesirable for security reasons in some production environments. Close reasons could be used by an attacker to confirm that the endpoint is out of resources or be used to identify the WebSocket implementation in use. | |
| 95 | + | |
| 96 | +Note: this will suppress *all* close codes, including those explicitly sent by local applications. | |
| 97 | + | |
| 98 | +#### Max message size | |
| 99 | +Default value for the processor's maximum message size. Maximum message size determines the point at which the library will drop a connection with the message_too_big protocol error. | |
| 100 | + | |
| 101 | +#### Max HTTP header size | |
| 102 | +Maximum body size determines the point at which the library will abort reading an HTTP message body and return the 413/request entity too large error. | |
| 103 | + | |
| 104 | +Transport Config Options | |
| 105 | +------------------------ | |
| 106 | + | |
| 107 | +### Policies | |
| 108 | + | |
| 109 | +Policies are classes used to allow clean swapping of behavior without changing the core library | |
| 110 | + | |
| 111 | +| Typedef Name | Effect | | |
| 112 | +| ---------------- | ------------------ | | |
| 113 | +| concurrency_type | Concurrency Policy | | |
| 114 | +| elog_type | Error logger type | | |
| 115 | +| alog_type | Access logger type | | |
| 116 | +| request_type | HTTP request type | | |
| 117 | +| response_type | HTTP response type | | |
| 118 | + | |
| 119 | +### Timeouts Values | |
| 120 | + | |
| 121 | +These represent the length of time (in ms) before the given operation is aborted | |
| 122 | + | |
| 123 | +| Field | Type | Default | Operation | | |
| 124 | +| ------------------------ | ---- | ------- | --------------------------------------------- | | |
| 125 | +| timeout_socket_pre_init | long | 5000 | Transport dependent | | |
| 126 | +| timeout_proxy | long | 5000 | Proxy handshake | | |
| 127 | +| timeout_socket_post_init | long | 5000 | Transport dependent (commonly: TLS handshake) | | |
| 128 | +| timeout_dns_resolve | long | 5000 | DNS resolution | | |
| 129 | +| timeout_connect | long | 5000 | TCP Connect | | |
| 130 | +| timeout_socket_shutdown | long | 5000 | Socket shutdown | | |
| 131 | + | |
| 132 | +### Performance tuning | |
| 133 | + | |
| 134 | +| Field | Type | Default | Meaning | | |
| 135 | +| --------------------------- | ------ | -------- | ------------------------------------------------------------------ | | |
| 136 | +| enable_multithreading | bool | true | Disabling may reduce locking overhead for single threaded programs | | |
| 137 | + | |
| 138 | +*/ | ... | ... |
3rdparty/websocketpp-0.8.2/docs/faq.dox
0 → 100644
| 1 | +/** \page faq FAQ | |
| 2 | + | |
| 3 | +## General Library Usage | |
| 4 | + | |
| 5 | +### Can a handler be changed after a connection is established? Can one be removed? | |
| 6 | +Yes, but not globally. | |
| 7 | + | |
| 8 | +Handlers assigned to endpoints will be automatically copied to the connections created by that endpoint. Changing a handler on an endpoint will only affect future connections. | |
| 9 | + | |
| 10 | +Once a particular connection is created, it's handlers can be changed individually by calling the `set_*_handler` methods. Once changed, all future events of that type for that connection will use the new handler. | |
| 11 | + | |
| 12 | +To remove a handler that was previously set, call the set method with `nullptr` or `NULL`. | |
| 13 | + | |
| 14 | +### Can I reject or conditionally accept a connection | |
| 15 | +Yes. The `validate` handler is called after the initial handshake has been recieved but before WebSocket++ has responded. This gives you the opportunity to inspect the incoming connection request, its headers, origin, subprotocols, and the remote endpoint IP. Return `true` from the validate handler to accept the connection and `false` to reject it. | |
| 16 | + | |
| 17 | +To set a custom HTTP error message for your rejection, use `websocketpp::connection::set_status` and (optionally) `websocketpp::connection::set_body()` to set the HTTP status code and error message body text. If you do not set body text a message will be generated automatically based on the status code. | |
| 18 | + | |
| 19 | +### How do I negotiate subprotocols? | |
| 20 | +WebSocket connections may offer a particular subprotocol they want to use. The WebSocket protocol does not define the meaning or interpretation of the subprotocol. This interpretation is left up to the individual application endpoints. | |
| 21 | + | |
| 22 | +WebSocket++ servers can read the requested subprotocols during the `validate` handler by calling `websocketpp::connection::get_requested_subprotocols`. The list is ordered by client priority. You may optionally choose one of these subprotocols with `websocketpp::connection::select_subprotocol`. The handshake will then complete and let the client know which one was chosen. If you do not choose any, the "blank"/empty/none subprotocol will be used. | |
| 23 | + | |
| 24 | +WebSocket++ clients can add a subprotocol to an outgoing connection by calling `websocketpp::connection::add_subprotocol` before calling `websocketpp::client::connect`. The order of adding will be interpreted as the order of preference. | |
| 25 | + | |
| 26 | +In both caases, after the connection has been established, the selected subprotocol is available via the `websocketpp::connection::get_subprotocol` method. | |
| 27 | + | |
| 28 | +Note: some browsers will allow the connection to continue if they requested a subprotocol and your server doesn't select one. Others will reject the connection. | |
| 29 | + | |
| 30 | +### How do I cleanly exit an Asio transport based program | |
| 31 | + | |
| 32 | +The Asio transport based clients and servers use the Asio library's underlying `io_service` to handle asyncronous networking operations. The standard behavior of the io_service is to run until there are no async operations left and then return. WebSocket++, when using the Asio transport, behaves like a standard Asio application. If you want your WebSocket++/Asio based program to stop network operations and cleanly close all sockets you will want to do the following: | |
| 33 | + | |
| 34 | +- For servers, call `websocketpp::transport::asio::endpoint::stop_listening` to initiate the closing of the server listening socket. | |
| 35 | +- For clients, if you have engaged perpetual mode with `websocketpp::transport::asio::endpoint::start_perpetual`, disable it with `websocketpp::transport::asio::endpoint::stop_perpetual`. | |
| 36 | +- For both, run `websocketpp::endpoint::close` or `websocketpp::connection::close` on all currently outstanding connections. This will initiate the WebSocket closing handshake for these connections | |
| 37 | +- Wait. Asio is asyncronous. When the calls to the above methods (stop_listening, close, etc) complete the server *will still be listening*, the connections *will still be active* until the io_service gets around to asyncronously processing the socket and WebSocket protocol closing handshakes. The `io_service::run` method will exit cleanly and automatically when all operations are complete. | |
| 38 | + | |
| 39 | +__WARNING__: Asio's `io_service` has a method called `stop`. WebSocket++ wraps this method as `websocketpp::transport::asio::endpoint::stop`. While this operation has a benign sounding name, it is a powerful and destructive operation that should only be used in special cases. If you are using `io_service::stop` or `endpoint::stop` without a very good reason your program is likely broken and may exhibit erratic behavior. Specifically, `io_service::stop` stops the processing of events entirely. This does not give current operations (such as socket closing handshakes) the opportunity to finish. It will leave your sockets in a dangling state that may invoke operating system level timeouts or other errors. | |
| 40 | + | |
| 41 | +__Special cases__: | |
| 42 | +- If your client uses the `start_perpetual` method it will prevent the io_service from exiting even if it has nothing to do. This is useful if you want a client endpoint to idle in the background to allow new connections to be formed on demand rather than generating a new endpoint for each. | |
| 43 | +- If you are using an external io_service and/or are placing non-WebSocket++ operations on the `io_service` those operations may keep the `io_service` open even after all WebSocket++ operations have completed. | |
| 44 | +- If you are using `poll`/`poll_one`/`run_one` or otherwise manually driving the `io_service` event loop you may need to adjust usage to make sure you are correctly recognizing the "done with work" and "not done but idling / `io_service::work`" cases. | |
| 45 | + | |
| 46 | +### Is there a way to check the validity of a `connection_hdl`? | |
| 47 | + | |
| 48 | +Sometimes, not generally though, because there isn’t a way to check if a TCP connection is valid. | |
| 49 | + | |
| 50 | +You can try upgrading your hdl to a full connection_ptr using `websocketpp::endpoint::get_con_from_hdl`. If this fails, the hdl is definitely invalid. If it succeeds it may or may not be. The only way to tell definitively is to try and send something (either a message or a ping). | |
| 51 | + | |
| 52 | +If you handle errors from methods like send, ping, close, etc correctly then you shouldn’t have to worry about accidentally sending to dead connections. The send/ping/pong/close methods will set or throw a specific error in the case that you tried to send something but the connection was closed/gone/etc. | |
| 53 | + | |
| 54 | +### How do I fix the "address is in use" error when trying to restart my server? | |
| 55 | + | |
| 56 | +Normally, for security purposes, operating systems prevent programs from listening on sockets created by other programs. When your program crashes and restarts, the new instance is a different program from the perspective of the operating system. As such it can’t listen on the socket address/port that the previous program was using until after a timeout occurs to make sure the old program was done with it. | |
| 57 | + | |
| 58 | +The first step for handling this is to make sure that you provide a method (signal handler, admin websocket message, etc) to perform a clean server shutdown. There is a question elsewhere in this FAQ that describes the steps necessary for this. | |
| 59 | + | |
| 60 | +The clean close strategy won't help in the case of crashes or other abnormal closures. An option to consider for these cases is the use of the SO_REUSEADDR socket option. This instructs the OS to not request an exclusive lock on the socket. This means that after your program crashes the replacement you start can immediately listen on that address/port combo again. | |
| 61 | + | |
| 62 | +__Please note__: how this works exactly depends on your operating system. Additionally, not exclusively locking your listening socket could allow hijacking by other programs if you are running in a shared resource environment. For development this is generally no problem. For a production environment, think carefully about the security model. `websocketpp::transport::asio::endpoint::set_reuse_addr` is the method to do this. You must specify this setting before calling `websocketpp::transport::asio::endpoint::listen`. | |
| 63 | + | |
| 64 | +### How do I send and recieve binary messages? | |
| 65 | + | |
| 66 | +When supported by the remote endpoint, WebSocket++ allows reading and sending messages in the two formats specified in RFC6455, UTF8 text and binary. WebSocket++ performs UTF8 validation on all outgoing text messages to ensure that they meet the specification. Binary messages do not have any additional processing and their interpretation is left entirely to the library user. | |
| 67 | + | |
| 68 | +To determine the type of an incoming message, use `websocketpp::message_buffer::message::get_opcode`. The relevant return values are `websocketpp::frame::opcode::text` and `websocketpp::frame::opcode::binary`. There is no difference in how payloads are retrieved between these modes, only in how WebSocket++ validated the contents and how the library user is to interpret the data. | |
| 69 | + | |
| 70 | +To specify the type of an outgoing message, use the frame opcode values listed above as the second op parameter for `websocketpp::connection::send`. There are two relevant overloads of send. One that takes a `std::string` and defaults to op=text. The other that takes a `void const *` and a `size_t` length and defaults to op=binary. Note: You can send binary messages via the string overload and text messages via the void * overload. In the case that you are manually building a message buffer rather than using the automatic send member functions, you can pass the opcode in as a parameter to the message buffer constructor or user the `websocketpp::message_buffer::message::set_opcode` member function to set or re-set it later. | |
| 71 | + | |
| 72 | +## Dependency Management | |
| 73 | + | |
| 74 | +### Can WebSocket++ be used without Boost? | |
| 75 | +Yes. WebSocket++ only uses Boost features as polyfills for C++11 language features and libraries. If you have a C++11 compiler and standard library you can use WebSocket++ without Boost. In most cases setting your build environment to use the C++11 (or later) language dialect is sufficient to enable this mode of use. | |
| 76 | + | |
| 77 | +With less common compilers (and sometimes very recently release compilers) there may be specific issues with certain libraries that aren't automatically detected by the library. For these situations there are additional defines available to fine tune which C++11 libraries and features are used. TODO: more details about them. | |
| 78 | + | |
| 79 | +For the iostream/raw transport the C++11 standard library is sufficient. For the Asio based transports, there is no C++11 library that provides the networking capabilaties that Asio does. As such even with a C++11 build system, you will need a standalone copy of Asio to use if Boost Asio is not available. | |
| 80 | + | |
| 81 | +MinGW users who want to avoid Boost should also consult the nearby question about MinGW compatibility. | |
| 82 | + | |
| 83 | +### Can WebSocket++ be used with standalone Asio | |
| 84 | +Yes. The process is the same as used with standalone Asio itself. Define `ASIO_STANDALONE` before including Asio or WebSocket++ headers. You will need to download a copy of the Asio headers separately (http://www.think-async.com) and make sure they are in your build system's include path. | |
| 85 | + | |
| 86 | +### Can WebSocket++ be used without TLS or OpenSSL? | |
| 87 | +Yes. When using the iostream/raw transport, there are no TLS features and OpenSSL is not required. When using the Asio transport TLS features are optional. You only need OpenSSL if you want to use TLS. You can only make or recieve encrypted connections (https/wss) if you have enabled TLS features. | |
| 88 | + | |
| 89 | +Whether an Asio endpoint uses TLS or not is determined by its config template parameter. The default bundled `websocketpp::config::asio` and `websocketpp::config::asio_client` configs do not support TLS, the `websocketpp::config::asio_tls` and `websocketpp::config::asio_tls_client` do. | |
| 90 | + | |
| 91 | +The `<websocketpp/config/asio.hpp>` and `<websocketpp/config/asio_client.hpp>` headers will include both the TLS and non-TLS varients of their respective configs and require the presence of OpenSSL. The `<websocketpp/config/asio_no_tls.hpp>` and `<websocketpp/config/asio_no_tls_client.hpp>` headers will include only the non-TLS configs and do not require OpenSSL. | |
| 92 | + | |
| 93 | +### Build issues with TLS on recent versions of OS X | |
| 94 | +Mac OS X ships a severely outdated version of the OpenSSL library. To securely use TLS with WebSocket++ on OS X you will need to install a modern version of OpenSSL via homebrew or compiling from source. | |
| 95 | + | |
| 96 | +### Can WebSocket++ be used with MinGW | |
| 97 | +Generally, yes. Note that in C++11 mode MinGW does not currently support the C++11 STL `<thread>` library. WebSocket++ requires a thread/mutex library. Options include Boost thread (the default when a compatible C++11 `<thread>` can't be found) or `mingw-std-threads` (https://github.com/meganz/mingw-std-threads) by including those headers and defining `_WEBSOCKETPP_MINGW_THREAD_`. | |
| 98 | + | |
| 99 | +## Compression | |
| 100 | + | |
| 101 | +### How do I use permessage-deflate in version 0.6.0-permessagedeflate and 0.7.0? | |
| 102 | + | |
| 103 | +These versions of the library require a custom config to use the permessage-deflate extension. Here is a minimal example of such a custom config. You can also integrate these lines into an existing custom config. | |
| 104 | + | |
| 105 | +Note that in these versions there is no fine grained control over which connections are compressed or not. Clients will request compression with the default settings and use it if the server supports it. Servers will accept whatever parameters clients request. | |
| 106 | + | |
| 107 | +Outgoing messages by default will be compressed if compression was auto-negotiated during the handshake. There is an option to force a specific message to be sent uncompressed even if compression was negotiated. This may be useful for sending data that you know to be compressed already (images, zip files, etc). | |
| 108 | + | |
| 109 | + | |
| 110 | +__Server Example__ | |
| 111 | +``` | |
| 112 | +#include <websocketpp/extensions/permessage_deflate/enabled.hpp> | |
| 113 | + | |
| 114 | +struct deflate_server_config : public websocketpp::config::asio { | |
| 115 | + // ... additional custom config if you need it for other things | |
| 116 | + | |
| 117 | + /// permessage_compress extension | |
| 118 | + struct permessage_deflate_config {}; | |
| 119 | + | |
| 120 | + typedef websocketpp::extensions::permessage_deflate::enabled | |
| 121 | + <permessage_deflate_config> permessage_deflate_type; | |
| 122 | +}; | |
| 123 | + | |
| 124 | +typedef websocketpp::server<deflate_server_config> server_endpoint_type; | |
| 125 | +``` | |
| 126 | + | |
| 127 | +__Client Example__ | |
| 128 | +``` | |
| 129 | +#include <websocketpp/extensions/permessage_deflate/enabled.hpp> | |
| 130 | + | |
| 131 | +struct deflate_client_config : public websocketpp::config::asio_client { | |
| 132 | + // ... additional custom config if you need it for other things | |
| 133 | + | |
| 134 | + /// permessage_compress extension | |
| 135 | + struct permessage_deflate_config {}; | |
| 136 | + | |
| 137 | + typedef websocketpp::extensions::permessage_deflate::enabled | |
| 138 | + <permessage_deflate_config> permessage_deflate_type; | |
| 139 | +}; | |
| 140 | + | |
| 141 | +typedef websocketpp::client<deflate_client_config> client_endpoint_type; | |
| 142 | +``` | |
| 143 | + | |
| 144 | +## Security | |
| 145 | + | |
| 146 | +### Is it possible to terminate a malicious connection quickly, without tying up resources performing clean close steps, | |
| 147 | + | |
| 148 | +Yes. The library will automatically detect and terminate connections that violate the WebSocket protocol. In cases where the library believes the remote endpoint to be malicious or sufficiently broken to be unlikely to understand or process the closing handshake, it will be omited. | |
| 149 | + | |
| 150 | +If your application detects conditions above the protocol level that you believe to be malicious, for example, if you recognize an IP from a known denial of service attack, you can close the connection with two different levels of urgency. Use the standard `websocketpp::endpoint::close` or `websocketpp::connection::close` methods with one of the following special close codes: | |
| 151 | +- `websocketpp::close::status::omit_handshake`: Omits the closing handshake, but cleanly closes the TCP connection. | |
| 152 | +- `websocketpp::close::status::force_tcp_drop`: Forcibly drop the TCP connection. | |
| 153 | + | |
| 154 | +Please note that usage of these disconnect methods results in a violation of the WebSocket protocol and may have negative reprocusions for the remote endpoint with respect to network timeouts. Please use caution when using them. | |
| 155 | + | |
| 156 | +## Build Issues | |
| 157 | + | |
| 158 | +### Getting compile errors related to `std::chrono`, `boost::chrono`, `waitable_timer`, or `steady_clock` | |
| 159 | + | |
| 160 | +Your build system may be confused about whether it is supposed to be using `boost::chrono` or `std::chrono`. Boost automatically detects this setup on some compilers but not others. Defining `BOOST_ASIO_HAS_STD_CHRONO` can help. See http://www.boost.org/doc/libs/1_60_0/doc/html/boost_asio/overview/cpp2011/chrono.html for more details. | |
| 161 | + | |
| 162 | +*/ | ... | ... |
3rdparty/websocketpp-0.8.2/docs/getting_started.dox
0 → 100644
| 1 | +/** \page getting_started Getting Started | |
| 2 | + | |
| 3 | +WebSocket++ code is available on github at https://github.com/zaphoyd/websocketpp | |
| 4 | +The official project homepage lives at http://www.zaphoyd.com/websocketpp | |
| 5 | + | |
| 6 | +The git repository is organized into several directories: | |
| 7 | + | |
| 8 | +- **docs**: This documentation | |
| 9 | +- **examples**: Example programs that demonstrate how to build basic versions of some commonly used patterns for WebSocket clients and servers. | |
| 10 | +- **test**: Unit tests that confirm that the code you have works properly and help detect platform specific issues. | |
| 11 | +- **tutorials**: Detailed walkthroughs of a select set of the example programs. | |
| 12 | +- **websocketpp**: All of the library code and default configuration files. | |
| 13 | + | |
| 14 | +WebSocket++ is a header only library. You can start using it by including the websocketpp source directory in your project's include path and including the appropriate WebSocket++ headers in your program. You may also need to include and/or link to appropriate Boost/system libraries. TODO: More information: Building a program with WebSocket++, Walkthroughs of the example programs | |
| 15 | + | |
| 16 | +WebSocket++ includes cmake and scons scripts for building the examples and unit tests. Neither system is needed unless you want to build tests or examples in an automated fashion. | |
| 17 | + | |
| 18 | +__Usage questions__ should be posted to the project mailing list at http://groups.google.com/group/websocketpp/ or the IRC channel (\#websocketpp on freenode). | |
| 19 | + | |
| 20 | +__Bugs and issues__ should be posted to the project GitHub issues queue: https://github.com/zaphoyd/websocketpp/issues. | |
| 21 | + | |
| 22 | +__Pull requests__ on GitHub are welcome. Please make them against the `develop` branch. | |
| 23 | + | |
| 24 | +WebSocket++ is written and maintained by Peter Thorson. You can contact me via GitHub messaging, IRC, or via email at websocket@zaphoyd.com. | |
| 25 | + | |
| 26 | +*/ | |
| 27 | + | ... | ... |
3rdparty/websocketpp-0.8.2/docs/handlers.dox
0 → 100644
| 1 | +/** \page reference.handlers Handler Reference | |
| 2 | + | |
| 3 | +Handlers allow WebSocket++ programs to receive notifications about events | |
| 4 | +that happen in relation to their connections. Some handlers also behave as | |
| 5 | +hooks that give the program a chance to modify state or adjust settings before | |
| 6 | +the connection continues. | |
| 7 | + | |
| 8 | +Handlers are registered by calling the appropriate `set_*_handler` method on either an | |
| 9 | +endpoint or connection. The * refers to the name of the handler (as | |
| 10 | +specified in the signature field below). For example, to set the open handler, | |
| 11 | +call `set_open_handler(...)`. | |
| 12 | + | |
| 13 | +Setting handlers on an endpoint will result in them being copied as the default | |
| 14 | +handler to all new connections created by that endpoint. Changing an endpoint's | |
| 15 | +handlers will not affect connections that are already in progress. This includes | |
| 16 | +connections that are in the listening state. As such, it is important to set any | |
| 17 | +endpoint handlers before you call `endpoint::start_accept` or else the handlers | |
| 18 | +will not be attached to your first connection. | |
| 19 | + | |
| 20 | +Setting handlers on a connection will result in the handler being changed for | |
| 21 | +that connection only, starting at the next time that handler is called. This can | |
| 22 | +be used to change the handler during a connection. | |
| 23 | + | |
| 24 | +Connection Handlers | |
| 25 | +------------------- | |
| 26 | + | |
| 27 | +These handlers will be called at most once per connection in the order specified below. | |
| 28 | + | |
| 29 | +### Socket Init Handler | |
| 30 | + | |
| 31 | +| Event | Signature | Availability | | |
| 32 | +| --------------------- | ----------------------------------------------------- | -------------------- | | |
| 33 | +| Socket initialization | `socket_init(connection_hdl, asio::ip::tcp::socket&)` | 0.3.0 Asio Transport | | |
| 34 | + | |
| 35 | +This hook is triggered after the socket has been initialized but before a connection is established. | |
| 36 | +It allows setting arbitrary socket options before connections are sent/recieved. | |
| 37 | + | |
| 38 | +### TCP Pre-init Handler | |
| 39 | + | |
| 40 | +| Event | Signature | Availability | | |
| 41 | +| ----------------------------- | ------------------------------ | -------------------- | | |
| 42 | +| TCP established, no data sent | `tcp_pre_init(connection_hdl)` | 0.3.0 Asio Transport | | |
| 43 | + | |
| 44 | +This hook is triggered after the TCP connection is established, but before any pre-WebSocket-handshake | |
| 45 | +operations have been run. Common pre-handshake operations include TLS handshakes and proxy connections. | |
| 46 | + | |
| 47 | +### TCP Post-init Handler | |
| 48 | + | |
| 49 | +| Event | Signature | Availability | | |
| 50 | +| ----------------------- | ------------------------------------------ | ----------------------------- | | |
| 51 | +| Request for TLS context | `tls_context_ptr tls_init(connection_hdl)` | 0.3.0 Asio Transport with TLS | | |
| 52 | + | |
| 53 | +This hook is triggered before the TLS handshake to request the TLS context to use. You must | |
| 54 | +return a pointer to a configured TLS conext to continue. This provides the opportuinity to | |
| 55 | +set up the TLS settings, certificates, etc. | |
| 56 | + | |
| 57 | +### Validate Handler | |
| 58 | + | |
| 59 | +| Event | Signature | Availability | | |
| 60 | +| ------------------------------------- | ------------------------------- | ---------------------------- | | |
| 61 | +| Hook to accept or reject a connection | `bool validate(connection_hdl)` | 0.3.0 Core, Server role only | | |
| 62 | + | |
| 63 | +This hook is triggered for servers during the opening handshake after the request has been | |
| 64 | +processed but before the response has been sent. It gives a program the opportunity to inspect | |
| 65 | +headers and other connection details and either accept or reject the connection. Validate happens | |
| 66 | +before the open or fail handler. | |
| 67 | + | |
| 68 | +Return true to accept the connection, false to reject. If no validate handler is registered, | |
| 69 | +all connections will be accepted. | |
| 70 | + | |
| 71 | +### Open Connection Handler | |
| 72 | + | |
| 73 | +| Event | Signature | Availability | | |
| 74 | +| ------------------------- | ---------------------- | ------------ | | |
| 75 | +| Successful new connection | `open(connection_hdl)` | 0.3.0 Core | | |
| 76 | + | |
| 77 | +Either open or fail will be called for each connection. Never both. All | |
| 78 | +connections that begin with an open handler call will also have a matching | |
| 79 | +close handler call when the connection ends. | |
| 80 | + | |
| 81 | +### Fail Connection Handler | |
| 82 | + | |
| 83 | +| Event | Signature | Availability | | |
| 84 | +| ----------------------------------- | ---------------------- | ------------ | | |
| 85 | +| Connection failed (before opening) | `fail(connection_hdl)` | 0.3.0 Core | | |
| 86 | + | |
| 87 | +Either open or fail will be called for each connection. Never both. Connections | |
| 88 | +that fail will never have a close handler called. | |
| 89 | + | |
| 90 | +### Close Connection Handler | |
| 91 | + | |
| 92 | +| Event | Signature | Availability | | |
| 93 | +| --------------------------------- | ----------------------- | ------------ | | |
| 94 | +| Connection closed (after opening) | `close(connection_hdl)` | 0.3.0 Core | | |
| 95 | + | |
| 96 | +Close will be called exactly once for every connection that open was called for. | |
| 97 | +Close is not called for failed connections. | |
| 98 | + | |
| 99 | +Message Handlers | |
| 100 | +---------------- | |
| 101 | + | |
| 102 | +These handers are called in response to incoming messages or message like events. They only will be called while the connection is in the open state. | |
| 103 | + | |
| 104 | +### Message Handler | |
| 105 | + | |
| 106 | +| Event | Signature | Availability | | |
| 107 | +| --------------------- | -------------------------------------- | ------------ | | |
| 108 | +| Data message recieved | `message(connection_hdl, message_ptr)` | 0.3.0 Core | | |
| 109 | + | |
| 110 | +Applies to all non-control messages, including both text and binary opcodes. The | |
| 111 | +`message_ptr` type and its API depends on your endpoint type and its config. | |
| 112 | + | |
| 113 | +### Ping Handler | |
| 114 | + | |
| 115 | +| Event | Signature | Availability | | |
| 116 | +| ------------- | ---------------------------------------- | ------------ | | |
| 117 | +| Ping recieved | `bool ping(connection_hdl, std::string)` | 0.3.0 Core | | |
| 118 | + | |
| 119 | +Second (string) argument is the binary ping payload. Handler return value | |
| 120 | +indicates whether or not to respond to the ping with a pong. If no ping handler | |
| 121 | +is set, WebSocket++ will respond with a pong containing the same binary data as | |
| 122 | +the ping (Per requirements in RFC6455). | |
| 123 | + | |
| 124 | +### Pong Handler | |
| 125 | + | |
| 126 | +| Event | Signature | Availability | | |
| 127 | +| ------------- | ----------------------------------- | ------------ | | |
| 128 | +| Pong recieved | `pong(connection_hdl, std::string)` | 0.3.0 Core | | |
| 129 | + | |
| 130 | +Second (string) argument is the binary pong payload. | |
| 131 | + | |
| 132 | +### Pong Timeout Handler | |
| 133 | + | |
| 134 | +| Event | Signature | Availability | | |
| 135 | +| ---------------------------------- | ------------------------------------------- | ---------------------------------------- | | |
| 136 | +| Timed out while waiting for a pong | `pong_timeout(connection_hdl, std::string)` | 0.3.0 Core, transport with timer support | | |
| 137 | + | |
| 138 | +Triggered if there is no response to a ping after the configured duration. The second | |
| 139 | +(string) argument is the binary payload of the unanswered ping. | |
| 140 | + | |
| 141 | +### HTTP Handler | |
| 142 | + | |
| 143 | +| Event | Signature | Availability | | |
| 144 | +| --------------------- | --------------------- | ---------------------------- | | |
| 145 | +| HTTP request recieved | `http(connection_hdl` | 0.3.0 Core, Server role only | | |
| 146 | + | |
| 147 | +Called when HTTP requests that are not WebSocket handshake upgrade requests are | |
| 148 | +recieved. Allows responding to regular HTTP requests. If no handler is registered | |
| 149 | +a 426/Upgrade Required error is returned. | |
| 150 | + | |
| 151 | +### Interrupt Handler | |
| 152 | + | |
| 153 | +| Event | Signature | Availability | | |
| 154 | +| ----------------------------------- | --------------------------- | ------------ | | |
| 155 | +| Connection was manually interrupted | `interrupt(connection_hdl)` | 0.3.0 Core | | |
| 156 | + | |
| 157 | +Interrupt events can be triggered by calling `endpoint::interrupt` or `connection::interrupt`. | |
| 158 | +Interrupt is similar to a timer event with duration zero but with lower overhead. It is useful | |
| 159 | +for single threaded programs to allow breaking up a very long handler into multiple parts and | |
| 160 | +for multi threaded programs as a way for worker threads to signale to the main/network thread | |
| 161 | +that an event is ready. | |
| 162 | + | |
| 163 | +todo: write low and high watermark handlers | |
| 164 | + | |
| 165 | +*/ | ... | ... |
3rdparty/websocketpp-0.8.2/docs/logging.dox
0 → 100644
| 1 | +/** \page reference.logging Logging Reference | |
| 2 | + | |
| 3 | +WebSocket++ has the capability of logging events during the lifetime of the connections that it processes. Each endpoint has two independent logging interfaces that are used by all connections created by that endpoint. The first is an access interface that allows logging routine events in the life of a connection (such as connect/disconnect and receipt of messages). The other is an error interface that allows logging non-routine problems or errors. Each interface has a number of different named channels that can be toggled on and off independently. | |
| 4 | + | |
| 5 | +Exactly how these logs are processed and where they are written to depends on which logging policy is in use. Several logging policies are included by default and you can write your own policy if you need something more specialized. Selecting a policy is done via the \subpage reference.config "endpoint config". | |
| 6 | + | |
| 7 | +Common functionality (all policies) | |
| 8 | +----------------------------------- | |
| 9 | + | |
| 10 | +### Logging Channels | |
| 11 | + | |
| 12 | +Each logging interface is divided into 32 named channels. Log messages are written to a specific interface on a specific channel. Which log messages are actually printed is determined by which channels are enabled or not. Channels can be enabled or disabled either at compile time or at runtime. | |
| 13 | + | |
| 14 | +### Enabling and Disabling Channels | |
| 15 | + | |
| 16 | +Channels disabled at compile time are removed from the code entirely (assuming correct compiler optimization settings) and are not available for runtime enabling or disabling. To disable channels at compile time, use the `alog_level` and `elog_level` values within your \subpage reference.config "endpoint config". Channels not disabled at compile time can be enabled or disabled at runtime using the `websocketpp::endpoint::set_access_channels()`, `websocketpp::endpoint::clear_access_channels()`, `websocketpp::endpoint::set_error_channels()`, and `websocketpp::endpoint::clear_error_channels()` methods. | |
| 17 | + | |
| 18 | +The set and clear functions act only on the channels specified. `set_access_channels(log::alevel::connect)` will enable logging of new connections. Following this with `set_access_channels(log::alevel::disconnect)` will enable logging of disconnections in addition to connections. Use `clear*` functions to disable a specific channel. Channels may be combined using bitwise operations to create aggregate packages of channels that may be set or cleared at once. Default packages include `websocketpp::log::alevel::all`, `websocketpp::log::elevel::all`, `websocketpp::log::alevel::none`, `websocketpp::log::elevel::none`. These represent all possible access/error channels and no access/error channels respectively. For convenience, setting none is aliased to clearing all. | |
| 19 | + | |
| 20 | +### Examples | |
| 21 | + | |
| 22 | +__Disable all__ | |
| 23 | + | |
| 24 | +`clear_access_channels(log::alevel::all)` | |
| 25 | + | |
| 26 | +__Disable all (alternative method)__ | |
| 27 | + | |
| 28 | +`set_access_channels(log::alevel::none)` | |
| 29 | + | |
| 30 | +__Multiple channels at once__ | |
| 31 | + | |
| 32 | +`log::alevel::message_payload | log::alevel::message_payload` | |
| 33 | + | |
| 34 | +__All except one__ | |
| 35 | + | |
| 36 | +`log::alevel::all ^ log::alevel::message_payload` | |
| 37 | + | |
| 38 | +__Default settings__ | |
| 39 | + | |
| 40 | +By default, only debug/development logging is disabled. | |
| 41 | + | |
| 42 | +### Access to underlying loggers | |
| 43 | + | |
| 44 | +Logging interfaces may be directly accessed via their associated endpoint or connection using get_alog() and get_elog(). This allows access to methods specific to the chosen logging policy. | |
| 45 | + | |
| 46 | +Basic Logging (Default Policy) | |
| 47 | +------------------------------ | |
| 48 | + | |
| 49 | +The basic logging policy (`websocketpp::log::basic`) writes logs to a std::ostream. By default, access logs are written to stdout and error logs are written to stderr. Each logging interface may be optionally redirected to an arbitrary C++ stream (including file streams) using the `websocketpp::log::basic::set_ostream()` method. | |
| 50 | + | |
| 51 | +Syslog Logging | |
| 52 | +-------------- | |
| 53 | + | |
| 54 | +The syslog logging policy (`websocketpp::log::syslog`) logs to POSIX syslog. It is included in the header `<websocketpp/logger/syslog.hpp>`. It requires a system with `<syslog.h>`. | |
| 55 | + | |
| 56 | +Stub Logging | |
| 57 | +------------ | |
| 58 | + | |
| 59 | +The stub logging policy (`websocketpp::log::stub`) implements the logging policy interface but ignores all input and provides no output. It can be used to stub out the logging system in tests or to completely disable and remove nearly all logging related code. | |
| 60 | + | |
| 61 | +The stub logger also provides documentation for the minimal required interface to build a custom logging policy. | |
| 62 | + | |
| 63 | +Log level reference | |
| 64 | +------------------- | |
| 65 | + | |
| 66 | +### Error Logging Levels | |
| 67 | + | |
| 68 | +Each of these channels is in the namespace `websocketpp::log::elevel` | |
| 69 | + | |
| 70 | +| Level | Description | | |
| 71 | +| ------- | -------------------------------------------------------------------------------------------------------------------------- | | |
| 72 | +| none | Special aggregate value representing "no levels" | | |
| 73 | +| devel | Low level debugging information (warning: very chatty). Requires debug or custom config. | | |
| 74 | +| library | Information about unusual system states or other minor internal library problems, less chatty than devel. | | |
| 75 | +| info | Information about minor configuration problems or additional information about other warnings. | | |
| 76 | +| warn | Information about important problems not severe enough to terminate connections. | | |
| 77 | +| rerror | Recoverable error. Recovery may mean cleanly closing the connection with an appropriate error code to the remote endpoint. | | |
| 78 | +| fatal | Unrecoverable error. This error will trigger immediate unclean termination of the connection or endpoint. | | |
| 79 | +| all | Special aggregate value representing "all levels" | | |
| 80 | + | |
| 81 | +### Access Logging Levels | |
| 82 | + | |
| 83 | +Each of these channels is in the namespace `websocketpp::log::alevel` | |
| 84 | + | |
| 85 | +| Level | Description | | |
| 86 | +| --------------- | -------------------------------------------------------------------------------------------------- | | |
| 87 | +| none | Special aggregate value representing "no levels" | | |
| 88 | +| connect | One line for each new connection that includes a host of information including: the remote address, websocket version, requested resource, http code, remote user agent | | |
| 89 | +| disconnect | One line for each connection that is closed. Includes closing codes and reasons | | |
| 90 | +| control | One line per control message | | |
| 91 | +| frame_header | One line per frame, includes the full frame header | | |
| 92 | +| frame_payload | One line per frame, includes the full message payload (warning: lots of output for large messages) | | |
| 93 | +| message_header | Reserved | | |
| 94 | +| message_payload | Reserved | | |
| 95 | +| endpoint | Reserved | | |
| 96 | +| debug_handshake | Extra information about opening handshakes | | |
| 97 | +| debug_close | Extra information about closing handshakes | | |
| 98 | +| devel | Development messages (warning: very chatty). Requires debug or custom config. | | |
| 99 | +| app | Special channel for application specific logs. Not used by the library. | | |
| 100 | +| all | Special aggregate value representing "all levels" | | |
| 101 | + | |
| 102 | +*/ | ... | ... |
3rdparty/websocketpp-0.8.2/docs/manual.css
0 → 100644
| 1 | +.tabs, .tabs2, .tabs3, .navpath ul { | |
| 2 | + background-image: none; | |
| 3 | + background-color: #333; | |
| 4 | + border: none; | |
| 5 | + border-bottom: 1px solid #575757; | |
| 6 | +} | |
| 7 | + | |
| 8 | +.tablist li, .navpath li { | |
| 9 | + background-image: none; | |
| 10 | + background-color: #333; | |
| 11 | +} | |
| 12 | + | |
| 13 | +.tablist a, .navpath li.navelem a { | |
| 14 | + color: #ccc; | |
| 15 | + text-shadow: 0px 1px 1px black; | |
| 16 | +} | |
| 17 | + | |
| 18 | +.tablist a:hover, .navpath li.navelem a:hover { | |
| 19 | + background-image: none; | |
| 20 | + background-color: #444; | |
| 21 | + color: #ccc; | |
| 22 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/docs/manual.dox
0 → 100644
| 1 | +/** \mainpage | |
| 2 | + | |
| 3 | +WebSocket++ is a C++ library that can be used to implement WebSocket functionality. The goals of the project are to provide a WebSocket implementation that is portable, flexible, lightweight, low level, and high performance. | |
| 4 | + | |
| 5 | +WebSocket++ does not intend to be used alone as a web application framework or full featured web services platform. As such the components, examples, and performance tuning are geared towards operation as a WebSocket client or server. There are some minimal convenience features that stray from this (for example the ability to respond to HTTP requests other than WebSocket Upgrades) but these are not the focus of the project. In particular WebSocket++ does not intend to implement any non-WebSocket related fallback options (ajax / long polling / comet / etc). | |
| 6 | + | |
| 7 | +In order to remain compact and improve portability, the WebSocket++ project strives to reduce or eliminate external dependencies where possible and appropriate. WebSocket++ core has no dependencies other than the C++11 standard library. For non-C++11 compilers the Boost libraries provide drop in polyfills for the C++11 functionality used. | |
| 8 | + | |
| 9 | +WebSocket++ implements a pluggable data transport component. The default component allows reduced functionality by using STL iostream or raw byte shuffling via reading and writing char buffers. This component has no non-STL dependencies and can be used in a C++11 environment without Boost. Also included is an Asio based transport component that provides full featured network client/server functionality. This component requires either Boost Asio or a C++11 compiler and standalone Asio. As an advanced option, WebSocket++ supports custom transport layers if you want to provide your own using another library. | |
| 10 | + | |
| 11 | +In order to accommodate the wide variety of use cases WebSocket++ has collected, the library is built in a way that most of the major components are loosely coupled and can be swapped out and replaced. WebSocket++ will attempt to track the future development of the WebSocket protocol and any extensions as they are developed. | |
| 12 | + | |
| 13 | +- \subpage getting_started "Getting Started" | |
| 14 | +- \subpage faq "FAQ" | |
| 15 | +- \subpage tutorials "Tutorials" | |
| 16 | +- \subpage md_changelog "Change Log / Version History" | |
| 17 | +- Reference | |
| 18 | + - \subpage reference.handlers "Handler Reference" | |
| 19 | + - \subpage reference.config "Config Reference" | |
| 20 | + - \subpage reference.logging "Logging Reference" | |
| 21 | + | |
| 22 | +*/ | |
| 23 | + | ... | ... |
3rdparty/websocketpp-0.8.2/docs/simple_broadcast_server.cpp
0 → 100644
| 1 | +#include <set> | |
| 2 | + | |
| 3 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 4 | +#include <websocketpp/server.hpp> | |
| 5 | + | |
| 6 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 7 | + | |
| 8 | +using websocketpp::connection_hdl; | |
| 9 | +using websocketpp::lib::placeholders::_1; | |
| 10 | +using websocketpp::lib::placeholders::_2; | |
| 11 | +using websocketpp::lib::bind; | |
| 12 | + | |
| 13 | +class broadcast_server { | |
| 14 | +public: | |
| 15 | + broadcast_server() { | |
| 16 | + m_server.init_asio(); | |
| 17 | + | |
| 18 | + m_server.set_open_handler(bind(&broadcast_server::on_open,this,::_1)); | |
| 19 | + m_server.set_close_handler(bind(&broadcast_server::on_close,this,::_1)); | |
| 20 | + m_server.set_message_handler(bind(&broadcast_server::on_message,this,::_1,::_2)); | |
| 21 | + } | |
| 22 | + | |
| 23 | + void on_open(connection_hdl hdl) { | |
| 24 | + m_connections.insert(hdl); | |
| 25 | + } | |
| 26 | + | |
| 27 | + void on_close(connection_hdl hdl) { | |
| 28 | + m_connections.erase(hdl); | |
| 29 | + } | |
| 30 | + | |
| 31 | + void on_message(connection_hdl hdl, server::message_ptr msg) { | |
| 32 | + for (auto it : m_connections) { | |
| 33 | + m_server.send(it,msg); | |
| 34 | + } | |
| 35 | + } | |
| 36 | + | |
| 37 | + void run(uint16_t port) { | |
| 38 | + m_server.listen(port); | |
| 39 | + m_server.start_accept(); | |
| 40 | + m_server.run(); | |
| 41 | + } | |
| 42 | +private: | |
| 43 | + typedef std::set<connection_hdl,std::owner_less<connection_hdl>> con_list; | |
| 44 | + | |
| 45 | + server m_server; | |
| 46 | + con_list m_connections; | |
| 47 | +}; | |
| 48 | + | |
| 49 | +int main() { | |
| 50 | + broadcast_server server; | |
| 51 | + server.run(9002); | |
| 52 | +} | |
| 0 | 53 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/docs/simple_count_server_thread.cpp
0 → 100644
| 1 | +#include <functional> | |
| 2 | +#include <mutex> | |
| 3 | +#include <set> | |
| 4 | +#include <thread> | |
| 5 | + | |
| 6 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 7 | +#include <websocketpp/server.hpp> | |
| 8 | + | |
| 9 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 10 | + | |
| 11 | +using websocketpp::connection_hdl; | |
| 12 | + | |
| 13 | +class count_server { | |
| 14 | +public: | |
| 15 | + count_server() : m_count(0) { | |
| 16 | + m_server.init_asio(); | |
| 17 | + | |
| 18 | + m_server.set_open_handler(bind(&count_server::on_open,this,_1)); | |
| 19 | + m_server.set_close_handler(bind(&count_server::on_close,this,_1)); | |
| 20 | + } | |
| 21 | + | |
| 22 | + void on_open(connection_hdl hdl) { | |
| 23 | + std::lock_guard<std::mutex> lock(m_mutex); | |
| 24 | + m_connections.insert(hdl); | |
| 25 | + } | |
| 26 | + | |
| 27 | + void on_close(connection_hdl hdl) { | |
| 28 | + std::lock_guard<std::mutex> lock(m_mutex); | |
| 29 | + m_connections.erase(hdl); | |
| 30 | + } | |
| 31 | + | |
| 32 | + void count() { | |
| 33 | + while (1) { | |
| 34 | + sleep(1); | |
| 35 | + m_count++; | |
| 36 | + | |
| 37 | + std::stringstream ss; | |
| 38 | + ss << m_count; | |
| 39 | + | |
| 40 | + std::lock_guard<std::mutex> lock(m_mutex); | |
| 41 | + for (auto it : m_connections) { | |
| 42 | + m_server.send(it,ss.str(),websocketpp::frame::opcode::text); | |
| 43 | + } | |
| 44 | + } | |
| 45 | + } | |
| 46 | + | |
| 47 | + void run(uint16_t port) { | |
| 48 | + m_server.listen(port); | |
| 49 | + m_server.start_accept(); | |
| 50 | + m_server.run(); | |
| 51 | + } | |
| 52 | +private: | |
| 53 | + typedef std::set<connection_hdl,std::owner_less<connection_hdl>> con_list; | |
| 54 | + | |
| 55 | + int m_count; | |
| 56 | + server m_server; | |
| 57 | + con_list m_connections; | |
| 58 | + std::mutex m_mutex; | |
| 59 | +}; | |
| 60 | + | |
| 61 | +int main() { | |
| 62 | + count_server server; | |
| 63 | + std::thread t(std::bind(&count_server::count,&server)); | |
| 64 | + server.run(9002); | |
| 65 | +} | |
| 0 | 66 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/docs/tutorials.dox
0 → 100644
| 1 | +/** \page tutorials Tutorials | |
| 2 | + | |
| 3 | +These tutorials are works in progress, some are more complete than others. | |
| 4 | + | |
| 5 | +- \subpage md_tutorials_utility_client_utility_client | |
| 6 | +- \subpage md_tutorials_utility_server_utility_server | |
| 7 | +- \subpage md_tutorials_broadcast_tutorial_broadcast_tutorial | |
| 8 | +- \subpage md_tutorials_chat_tutorial_chat_tutorial | |
| 9 | + | |
| 10 | +*/ | ... | ... |
3rdparty/websocketpp-0.8.2/examples/associative_storage/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (associative_storage) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/associative_storage/associative_storage.cpp
0 → 100644
| 1 | +#include <iostream> | |
| 2 | +#include <map> | |
| 3 | +#include <exception> | |
| 4 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 5 | +#include <websocketpp/server.hpp> | |
| 6 | + | |
| 7 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 8 | + | |
| 9 | +using websocketpp::connection_hdl; | |
| 10 | +using websocketpp::lib::placeholders::_1; | |
| 11 | +using websocketpp::lib::placeholders::_2; | |
| 12 | +using websocketpp::lib::bind; | |
| 13 | + | |
| 14 | +struct connection_data { | |
| 15 | + int sessionid; | |
| 16 | + std::string name; | |
| 17 | +}; | |
| 18 | + | |
| 19 | +class print_server { | |
| 20 | +public: | |
| 21 | + print_server() : m_next_sessionid(1) { | |
| 22 | + m_server.init_asio(); | |
| 23 | + | |
| 24 | + m_server.set_open_handler(bind(&print_server::on_open,this,::_1)); | |
| 25 | + m_server.set_close_handler(bind(&print_server::on_close,this,::_1)); | |
| 26 | + m_server.set_message_handler(bind(&print_server::on_message,this,::_1,::_2)); | |
| 27 | + } | |
| 28 | + | |
| 29 | + void on_open(connection_hdl hdl) { | |
| 30 | + connection_data data; | |
| 31 | + | |
| 32 | + data.sessionid = m_next_sessionid++; | |
| 33 | + data.name.clear(); | |
| 34 | + | |
| 35 | + m_connections[hdl] = data; | |
| 36 | + } | |
| 37 | + | |
| 38 | + void on_close(connection_hdl hdl) { | |
| 39 | + connection_data& data = get_data_from_hdl(hdl); | |
| 40 | + | |
| 41 | + std::cout << "Closing connection " << data.name | |
| 42 | + << " with sessionid " << data.sessionid << std::endl; | |
| 43 | + | |
| 44 | + m_connections.erase(hdl); | |
| 45 | + } | |
| 46 | + | |
| 47 | + void on_message(connection_hdl hdl, server::message_ptr msg) { | |
| 48 | + connection_data& data = get_data_from_hdl(hdl); | |
| 49 | + | |
| 50 | + if (data.name.empty()) { | |
| 51 | + data.name = msg->get_payload(); | |
| 52 | + std::cout << "Setting name of connection with sessionid " | |
| 53 | + << data.sessionid << " to " << data.name << std::endl; | |
| 54 | + } else { | |
| 55 | + std::cout << "Got a message from connection " << data.name | |
| 56 | + << " with sessionid " << data.sessionid << std::endl; | |
| 57 | + } | |
| 58 | + } | |
| 59 | + | |
| 60 | + connection_data& get_data_from_hdl(connection_hdl hdl) { | |
| 61 | + auto it = m_connections.find(hdl); | |
| 62 | + | |
| 63 | + if (it == m_connections.end()) { | |
| 64 | + // this connection is not in the list. This really shouldn't happen | |
| 65 | + // and probably means something else is wrong. | |
| 66 | + throw std::invalid_argument("No data available for session"); | |
| 67 | + } | |
| 68 | + | |
| 69 | + return it->second; | |
| 70 | + } | |
| 71 | + | |
| 72 | + void run(uint16_t port) { | |
| 73 | + m_server.listen(port); | |
| 74 | + m_server.start_accept(); | |
| 75 | + m_server.run(); | |
| 76 | + } | |
| 77 | +private: | |
| 78 | + typedef std::map<connection_hdl,connection_data,std::owner_less<connection_hdl>> con_list; | |
| 79 | + | |
| 80 | + int m_next_sessionid; | |
| 81 | + server m_server; | |
| 82 | + con_list m_connections; | |
| 83 | +}; | |
| 84 | + | |
| 85 | +int main() { | |
| 86 | + print_server server; | |
| 87 | + server.run(9002); | |
| 88 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/broadcast_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (broadcast_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/broadcast_server/SConscript
0 → 100644
| 1 | +## Broadcast Server example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('broadcast_server', ["broadcast_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system','thread'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('broadcast_server', ["broadcast_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/broadcast_server/broadcast_server.cpp
0 → 100644
| 1 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 2 | + | |
| 3 | +#include <websocketpp/server.hpp> | |
| 4 | + | |
| 5 | +#include <iostream> | |
| 6 | +#include <set> | |
| 7 | + | |
| 8 | +/*#include <boost/thread.hpp> | |
| 9 | +#include <boost/thread/mutex.hpp> | |
| 10 | +#include <boost/thread/condition_variable.hpp>*/ | |
| 11 | +#include <websocketpp/common/thread.hpp> | |
| 12 | + | |
| 13 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 14 | + | |
| 15 | +using websocketpp::connection_hdl; | |
| 16 | +using websocketpp::lib::placeholders::_1; | |
| 17 | +using websocketpp::lib::placeholders::_2; | |
| 18 | +using websocketpp::lib::bind; | |
| 19 | + | |
| 20 | +using websocketpp::lib::thread; | |
| 21 | +using websocketpp::lib::mutex; | |
| 22 | +using websocketpp::lib::lock_guard; | |
| 23 | +using websocketpp::lib::unique_lock; | |
| 24 | +using websocketpp::lib::condition_variable; | |
| 25 | + | |
| 26 | +/* on_open insert connection_hdl into channel | |
| 27 | + * on_close remove connection_hdl from channel | |
| 28 | + * on_message queue send to all channels | |
| 29 | + */ | |
| 30 | + | |
| 31 | +enum action_type { | |
| 32 | + SUBSCRIBE, | |
| 33 | + UNSUBSCRIBE, | |
| 34 | + MESSAGE | |
| 35 | +}; | |
| 36 | + | |
| 37 | +struct action { | |
| 38 | + action(action_type t, connection_hdl h) : type(t), hdl(h) {} | |
| 39 | + action(action_type t, connection_hdl h, server::message_ptr m) | |
| 40 | + : type(t), hdl(h), msg(m) {} | |
| 41 | + | |
| 42 | + action_type type; | |
| 43 | + websocketpp::connection_hdl hdl; | |
| 44 | + server::message_ptr msg; | |
| 45 | +}; | |
| 46 | + | |
| 47 | +class broadcast_server { | |
| 48 | +public: | |
| 49 | + broadcast_server() { | |
| 50 | + // Initialize Asio Transport | |
| 51 | + m_server.init_asio(); | |
| 52 | + | |
| 53 | + // Register handler callbacks | |
| 54 | + m_server.set_open_handler(bind(&broadcast_server::on_open,this,::_1)); | |
| 55 | + m_server.set_close_handler(bind(&broadcast_server::on_close,this,::_1)); | |
| 56 | + m_server.set_message_handler(bind(&broadcast_server::on_message,this,::_1,::_2)); | |
| 57 | + } | |
| 58 | + | |
| 59 | + void run(uint16_t port) { | |
| 60 | + // listen on specified port | |
| 61 | + m_server.listen(port); | |
| 62 | + | |
| 63 | + // Start the server accept loop | |
| 64 | + m_server.start_accept(); | |
| 65 | + | |
| 66 | + // Start the ASIO io_service run loop | |
| 67 | + try { | |
| 68 | + m_server.run(); | |
| 69 | + } catch (const std::exception & e) { | |
| 70 | + std::cout << e.what() << std::endl; | |
| 71 | + } | |
| 72 | + } | |
| 73 | + | |
| 74 | + void on_open(connection_hdl hdl) { | |
| 75 | + { | |
| 76 | + lock_guard<mutex> guard(m_action_lock); | |
| 77 | + //std::cout << "on_open" << std::endl; | |
| 78 | + m_actions.push(action(SUBSCRIBE,hdl)); | |
| 79 | + } | |
| 80 | + m_action_cond.notify_one(); | |
| 81 | + } | |
| 82 | + | |
| 83 | + void on_close(connection_hdl hdl) { | |
| 84 | + { | |
| 85 | + lock_guard<mutex> guard(m_action_lock); | |
| 86 | + //std::cout << "on_close" << std::endl; | |
| 87 | + m_actions.push(action(UNSUBSCRIBE,hdl)); | |
| 88 | + } | |
| 89 | + m_action_cond.notify_one(); | |
| 90 | + } | |
| 91 | + | |
| 92 | + void on_message(connection_hdl hdl, server::message_ptr msg) { | |
| 93 | + // queue message up for sending by processing thread | |
| 94 | + { | |
| 95 | + lock_guard<mutex> guard(m_action_lock); | |
| 96 | + //std::cout << "on_message" << std::endl; | |
| 97 | + m_actions.push(action(MESSAGE,hdl,msg)); | |
| 98 | + } | |
| 99 | + m_action_cond.notify_one(); | |
| 100 | + } | |
| 101 | + | |
| 102 | + void process_messages() { | |
| 103 | + while(1) { | |
| 104 | + unique_lock<mutex> lock(m_action_lock); | |
| 105 | + | |
| 106 | + while(m_actions.empty()) { | |
| 107 | + m_action_cond.wait(lock); | |
| 108 | + } | |
| 109 | + | |
| 110 | + action a = m_actions.front(); | |
| 111 | + m_actions.pop(); | |
| 112 | + | |
| 113 | + lock.unlock(); | |
| 114 | + | |
| 115 | + if (a.type == SUBSCRIBE) { | |
| 116 | + lock_guard<mutex> guard(m_connection_lock); | |
| 117 | + m_connections.insert(a.hdl); | |
| 118 | + } else if (a.type == UNSUBSCRIBE) { | |
| 119 | + lock_guard<mutex> guard(m_connection_lock); | |
| 120 | + m_connections.erase(a.hdl); | |
| 121 | + } else if (a.type == MESSAGE) { | |
| 122 | + lock_guard<mutex> guard(m_connection_lock); | |
| 123 | + | |
| 124 | + con_list::iterator it; | |
| 125 | + for (it = m_connections.begin(); it != m_connections.end(); ++it) { | |
| 126 | + m_server.send(*it,a.msg); | |
| 127 | + } | |
| 128 | + } else { | |
| 129 | + // undefined. | |
| 130 | + } | |
| 131 | + } | |
| 132 | + } | |
| 133 | +private: | |
| 134 | + typedef std::set<connection_hdl,std::owner_less<connection_hdl> > con_list; | |
| 135 | + | |
| 136 | + server m_server; | |
| 137 | + con_list m_connections; | |
| 138 | + std::queue<action> m_actions; | |
| 139 | + | |
| 140 | + mutex m_action_lock; | |
| 141 | + mutex m_connection_lock; | |
| 142 | + condition_variable m_action_cond; | |
| 143 | +}; | |
| 144 | + | |
| 145 | +int main() { | |
| 146 | + try { | |
| 147 | + broadcast_server server_instance; | |
| 148 | + | |
| 149 | + // Start a thread to run the processing loop | |
| 150 | + thread t(bind(&broadcast_server::process_messages,&server_instance)); | |
| 151 | + | |
| 152 | + // Run the asio loop with the main thread | |
| 153 | + server_instance.run(9002); | |
| 154 | + | |
| 155 | + t.join(); | |
| 156 | + | |
| 157 | + } catch (websocketpp::exception const & e) { | |
| 158 | + std::cout << e.what() << std::endl; | |
| 159 | + } | |
| 160 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/debug_client/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +if (OPENSSL_FOUND) | |
| 6 | + | |
| 7 | +init_target (debug_client) | |
| 8 | + | |
| 9 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 10 | + | |
| 11 | +link_boost () | |
| 12 | +link_openssl() | |
| 13 | +final_target () | |
| 14 | + | |
| 15 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | |
| 16 | + | |
| 17 | +endif() | |
| 0 | 18 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/examples/debug_client/SConscript
0 → 100644
| 1 | +## Debug client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | +Import('tls_libs') | |
| 10 | + | |
| 11 | +env = env.Clone () | |
| 12 | +env_cpp11 = env_cpp11.Clone () | |
| 13 | + | |
| 14 | +prgs = [] | |
| 15 | + | |
| 16 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 17 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 18 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 19 | + prgs += env_cpp11.Program('debug_client', ["debug_client.cpp"], LIBS = ALL_LIBS) | |
| 20 | +else: | |
| 21 | + ALL_LIBS = boostlibs(['system','random'],env) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 22 | + prgs += env.Program('debug_client', ["debug_client.cpp"], LIBS = ALL_LIBS) | |
| 23 | + | |
| 24 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/debug_client/debug_client.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2014, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + */ | |
| 26 | + | |
| 27 | +/** ====== WARNING ======== | |
| 28 | + * This example is presently used as a scratch space. It may or may not be broken | |
| 29 | + * at any given time. | |
| 30 | + */ | |
| 31 | + | |
| 32 | +#include <websocketpp/config/asio_client.hpp> | |
| 33 | + | |
| 34 | +#include <websocketpp/client.hpp> | |
| 35 | + | |
| 36 | +#include <iostream> | |
| 37 | +#include <chrono> | |
| 38 | + | |
| 39 | +typedef websocketpp::client<websocketpp::config::asio_client> client; | |
| 40 | + | |
| 41 | +using websocketpp::lib::placeholders::_1; | |
| 42 | +using websocketpp::lib::placeholders::_2; | |
| 43 | +using websocketpp::lib::bind; | |
| 44 | + | |
| 45 | +// pull out the type of messages sent by our config | |
| 46 | +typedef websocketpp::config::asio_tls_client::message_type::ptr message_ptr; | |
| 47 | +typedef websocketpp::lib::shared_ptr<boost::asio::ssl::context> context_ptr; | |
| 48 | +typedef client::connection_ptr connection_ptr; | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | +class perftest { | |
| 53 | +public: | |
| 54 | + typedef perftest type; | |
| 55 | + typedef std::chrono::duration<int,std::micro> dur_type; | |
| 56 | + | |
| 57 | + perftest () { | |
| 58 | + m_endpoint.set_access_channels(websocketpp::log::alevel::all); | |
| 59 | + m_endpoint.set_error_channels(websocketpp::log::elevel::all); | |
| 60 | + | |
| 61 | + // Initialize ASIO | |
| 62 | + m_endpoint.init_asio(); | |
| 63 | + | |
| 64 | + // Register our handlers | |
| 65 | + m_endpoint.set_socket_init_handler(bind(&type::on_socket_init,this,::_1)); | |
| 66 | + //m_endpoint.set_tls_init_handler(bind(&type::on_tls_init,this,::_1)); | |
| 67 | + m_endpoint.set_message_handler(bind(&type::on_message,this,::_1,::_2)); | |
| 68 | + m_endpoint.set_open_handler(bind(&type::on_open,this,::_1)); | |
| 69 | + m_endpoint.set_close_handler(bind(&type::on_close,this,::_1)); | |
| 70 | + m_endpoint.set_fail_handler(bind(&type::on_fail,this,::_1)); | |
| 71 | + } | |
| 72 | + | |
| 73 | + void start(std::string uri) { | |
| 74 | + websocketpp::lib::error_code ec; | |
| 75 | + client::connection_ptr con = m_endpoint.get_connection(uri, ec); | |
| 76 | + | |
| 77 | + if (ec) { | |
| 78 | + m_endpoint.get_alog().write(websocketpp::log::alevel::app,ec.message()); | |
| 79 | + return; | |
| 80 | + } | |
| 81 | + | |
| 82 | + //con->set_proxy("http://humupdates.uchicago.edu:8443"); | |
| 83 | + | |
| 84 | + m_endpoint.connect(con); | |
| 85 | + | |
| 86 | + // Start the ASIO io_service run loop | |
| 87 | + m_start = std::chrono::high_resolution_clock::now(); | |
| 88 | + m_endpoint.run(); | |
| 89 | + } | |
| 90 | + | |
| 91 | + void on_socket_init(websocketpp::connection_hdl) { | |
| 92 | + m_socket_init = std::chrono::high_resolution_clock::now(); | |
| 93 | + } | |
| 94 | + | |
| 95 | + context_ptr on_tls_init(websocketpp::connection_hdl) { | |
| 96 | + m_tls_init = std::chrono::high_resolution_clock::now(); | |
| 97 | + context_ptr ctx = websocketpp::lib::make_shared<boost::asio::ssl::context>(boost::asio::ssl::context::tlsv1); | |
| 98 | + | |
| 99 | + try { | |
| 100 | + ctx->set_options(boost::asio::ssl::context::default_workarounds | | |
| 101 | + boost::asio::ssl::context::no_sslv2 | | |
| 102 | + boost::asio::ssl::context::no_sslv3 | | |
| 103 | + boost::asio::ssl::context::single_dh_use); | |
| 104 | + } catch (std::exception& e) { | |
| 105 | + std::cout << e.what() << std::endl; | |
| 106 | + } | |
| 107 | + return ctx; | |
| 108 | + } | |
| 109 | + | |
| 110 | + void on_fail(websocketpp::connection_hdl hdl) { | |
| 111 | + client::connection_ptr con = m_endpoint.get_con_from_hdl(hdl); | |
| 112 | + | |
| 113 | + std::cout << "Fail handler" << std::endl; | |
| 114 | + std::cout << con->get_state() << std::endl; | |
| 115 | + std::cout << con->get_local_close_code() << std::endl; | |
| 116 | + std::cout << con->get_local_close_reason() << std::endl; | |
| 117 | + std::cout << con->get_remote_close_code() << std::endl; | |
| 118 | + std::cout << con->get_remote_close_reason() << std::endl; | |
| 119 | + std::cout << con->get_ec() << " - " << con->get_ec().message() << std::endl; | |
| 120 | + } | |
| 121 | + | |
| 122 | + void on_open(websocketpp::connection_hdl hdl) { | |
| 123 | + m_open = std::chrono::high_resolution_clock::now(); | |
| 124 | + m_endpoint.send(hdl, "", websocketpp::frame::opcode::text); | |
| 125 | + } | |
| 126 | + void on_message(websocketpp::connection_hdl hdl, message_ptr) { | |
| 127 | + m_message = std::chrono::high_resolution_clock::now(); | |
| 128 | + m_endpoint.close(hdl,websocketpp::close::status::going_away,""); | |
| 129 | + } | |
| 130 | + void on_close(websocketpp::connection_hdl) { | |
| 131 | + m_close = std::chrono::high_resolution_clock::now(); | |
| 132 | + | |
| 133 | + std::cout << "Socket Init: " << std::chrono::duration_cast<dur_type>(m_socket_init-m_start).count() << std::endl; | |
| 134 | + std::cout << "TLS Init: " << std::chrono::duration_cast<dur_type>(m_tls_init-m_start).count() << std::endl; | |
| 135 | + std::cout << "Open: " << std::chrono::duration_cast<dur_type>(m_open-m_start).count() << std::endl; | |
| 136 | + std::cout << "Message: " << std::chrono::duration_cast<dur_type>(m_message-m_start).count() << std::endl; | |
| 137 | + std::cout << "Close: " << std::chrono::duration_cast<dur_type>(m_close-m_start).count() << std::endl; | |
| 138 | + } | |
| 139 | +private: | |
| 140 | + client m_endpoint; | |
| 141 | + | |
| 142 | + std::chrono::high_resolution_clock::time_point m_start; | |
| 143 | + std::chrono::high_resolution_clock::time_point m_socket_init; | |
| 144 | + std::chrono::high_resolution_clock::time_point m_tls_init; | |
| 145 | + std::chrono::high_resolution_clock::time_point m_open; | |
| 146 | + std::chrono::high_resolution_clock::time_point m_message; | |
| 147 | + std::chrono::high_resolution_clock::time_point m_close; | |
| 148 | +}; | |
| 149 | + | |
| 150 | +int main(int argc, char* argv[]) { | |
| 151 | + std::string uri = "wss://echo.websocket.org"; | |
| 152 | + | |
| 153 | + if (argc == 2) { | |
| 154 | + uri = argv[1]; | |
| 155 | + } | |
| 156 | + | |
| 157 | + try { | |
| 158 | + perftest endpoint; | |
| 159 | + endpoint.start(uri); | |
| 160 | + } catch (websocketpp::exception const & e) { | |
| 161 | + std::cout << e.what() << std::endl; | |
| 162 | + } catch (std::exception const & e) { | |
| 163 | + std::cout << e.what() << std::endl; | |
| 164 | + } catch (...) { | |
| 165 | + std::cout << "other exception" << std::endl; | |
| 166 | + } | |
| 167 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/debug_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (debug_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/debug_server/SConscript
0 → 100644
| 1 | +## Debug server example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('debug_server', ["debug_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('debug_server', ["debug_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/debug_server/debug_server.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2014, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + */ | |
| 26 | + | |
| 27 | +/** ====== WARNING ======== | |
| 28 | + * This example is presently used as a scratch space. It may or may not be broken | |
| 29 | + * at any given time. | |
| 30 | + */ | |
| 31 | + | |
| 32 | +#include <websocketpp/config/debug_asio_no_tls.hpp> | |
| 33 | + | |
| 34 | +// Custom logger | |
| 35 | +#include <websocketpp/logger/syslog.hpp> | |
| 36 | + | |
| 37 | +#include <websocketpp/server.hpp> | |
| 38 | + | |
| 39 | +#include <iostream> | |
| 40 | + | |
| 41 | +//////////////////////////////////////////////////////////////////////////////// | |
| 42 | +///////////////// Custom Config for debugging custom policies ////////////////// | |
| 43 | +//////////////////////////////////////////////////////////////////////////////// | |
| 44 | + | |
| 45 | +struct debug_custom : public websocketpp::config::debug_asio { | |
| 46 | + typedef debug_custom type; | |
| 47 | + typedef debug_asio base; | |
| 48 | + | |
| 49 | + typedef base::concurrency_type concurrency_type; | |
| 50 | + | |
| 51 | + typedef base::request_type request_type; | |
| 52 | + typedef base::response_type response_type; | |
| 53 | + | |
| 54 | + typedef base::message_type message_type; | |
| 55 | + typedef base::con_msg_manager_type con_msg_manager_type; | |
| 56 | + typedef base::endpoint_msg_manager_type endpoint_msg_manager_type; | |
| 57 | + | |
| 58 | + /// Custom Logging policies | |
| 59 | + /*typedef websocketpp::log::syslog<concurrency_type, | |
| 60 | + websocketpp::log::elevel> elog_type; | |
| 61 | + typedef websocketpp::log::syslog<concurrency_type, | |
| 62 | + websocketpp::log::alevel> alog_type; | |
| 63 | + */ | |
| 64 | + typedef base::alog_type alog_type; | |
| 65 | + typedef base::elog_type elog_type; | |
| 66 | + | |
| 67 | + typedef base::rng_type rng_type; | |
| 68 | + | |
| 69 | + struct transport_config : public base::transport_config { | |
| 70 | + typedef type::concurrency_type concurrency_type; | |
| 71 | + typedef type::alog_type alog_type; | |
| 72 | + typedef type::elog_type elog_type; | |
| 73 | + typedef type::request_type request_type; | |
| 74 | + typedef type::response_type response_type; | |
| 75 | + typedef websocketpp::transport::asio::basic_socket::endpoint | |
| 76 | + socket_type; | |
| 77 | + }; | |
| 78 | + | |
| 79 | + typedef websocketpp::transport::asio::endpoint<transport_config> | |
| 80 | + transport_type; | |
| 81 | + | |
| 82 | + static const long timeout_open_handshake = 0; | |
| 83 | +}; | |
| 84 | + | |
| 85 | +//////////////////////////////////////////////////////////////////////////////// | |
| 86 | + | |
| 87 | +typedef websocketpp::server<debug_custom> server; | |
| 88 | + | |
| 89 | +using websocketpp::lib::placeholders::_1; | |
| 90 | +using websocketpp::lib::placeholders::_2; | |
| 91 | +using websocketpp::lib::bind; | |
| 92 | + | |
| 93 | +// pull out the type of messages sent by our config | |
| 94 | +typedef server::message_ptr message_ptr; | |
| 95 | + | |
| 96 | +bool validate(server *, websocketpp::connection_hdl) { | |
| 97 | + //sleep(6); | |
| 98 | + return true; | |
| 99 | +} | |
| 100 | + | |
| 101 | +void on_http(server* s, websocketpp::connection_hdl hdl) { | |
| 102 | + server::connection_ptr con = s->get_con_from_hdl(hdl); | |
| 103 | + | |
| 104 | + std::string res = con->get_request_body(); | |
| 105 | + | |
| 106 | + std::stringstream ss; | |
| 107 | + ss << "got HTTP request with " << res.size() << " bytes of body data."; | |
| 108 | + | |
| 109 | + con->set_body(ss.str()); | |
| 110 | + con->set_status(websocketpp::http::status_code::ok); | |
| 111 | +} | |
| 112 | + | |
| 113 | +void on_fail(server* s, websocketpp::connection_hdl hdl) { | |
| 114 | + server::connection_ptr con = s->get_con_from_hdl(hdl); | |
| 115 | + | |
| 116 | + std::cout << "Fail handler: " << con->get_ec() << " " << con->get_ec().message() << std::endl; | |
| 117 | +} | |
| 118 | + | |
| 119 | +void on_close(websocketpp::connection_hdl) { | |
| 120 | + std::cout << "Close handler" << std::endl; | |
| 121 | +} | |
| 122 | + | |
| 123 | +// Define a callback to handle incoming messages | |
| 124 | +void on_message(server* s, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 125 | + std::cout << "on_message called with hdl: " << hdl.lock().get() | |
| 126 | + << " and message: " << msg->get_payload() | |
| 127 | + << std::endl; | |
| 128 | + | |
| 129 | + try { | |
| 130 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 131 | + } catch (websocketpp::exception const & e) { | |
| 132 | + std::cout << "Echo failed because: " | |
| 133 | + << "(" << e.what() << ")" << std::endl; | |
| 134 | + } | |
| 135 | +} | |
| 136 | + | |
| 137 | +int main() { | |
| 138 | + // Create a server endpoint | |
| 139 | + server echo_server; | |
| 140 | + | |
| 141 | + try { | |
| 142 | + // Set logging settings | |
| 143 | + echo_server.set_access_channels(websocketpp::log::alevel::all); | |
| 144 | + echo_server.clear_access_channels(websocketpp::log::alevel::frame_payload); | |
| 145 | + | |
| 146 | + // Initialize ASIO | |
| 147 | + echo_server.init_asio(); | |
| 148 | + echo_server.set_reuse_addr(true); | |
| 149 | + | |
| 150 | + // Register our message handler | |
| 151 | + echo_server.set_message_handler(bind(&on_message,&echo_server,::_1,::_2)); | |
| 152 | + | |
| 153 | + echo_server.set_http_handler(bind(&on_http,&echo_server,::_1)); | |
| 154 | + echo_server.set_fail_handler(bind(&on_fail,&echo_server,::_1)); | |
| 155 | + echo_server.set_close_handler(&on_close); | |
| 156 | + | |
| 157 | + echo_server.set_validate_handler(bind(&validate,&echo_server,::_1)); | |
| 158 | + | |
| 159 | + // Listen on port 9012 | |
| 160 | + echo_server.listen(9012); | |
| 161 | + | |
| 162 | + // Start the server accept loop | |
| 163 | + echo_server.start_accept(); | |
| 164 | + | |
| 165 | + // Start the ASIO io_service run loop | |
| 166 | + echo_server.run(); | |
| 167 | + } catch (websocketpp::exception const & e) { | |
| 168 | + std::cout << e.what() << std::endl; | |
| 169 | + } catch (const std::exception & e) { | |
| 170 | + std::cout << e.what() << std::endl; | |
| 171 | + } catch (...) { | |
| 172 | + std::cout << "other exception" << std::endl; | |
| 173 | + } | |
| 174 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/dev/CMakeLists.txt
0 → 100644
3rdparty/websocketpp-0.8.2/examples/dev/SConscript
0 → 100644
| 1 | +## Main development example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env_cpp11 = env_cpp11.Clone () | |
| 11 | + | |
| 12 | +prgs = [] | |
| 13 | + | |
| 14 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 15 | + BOOST_LIBS_CPP11 = boostlibs(['unit_test_framework','system','timer','chrono'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 16 | + prgs += env_cpp11.Program('main', ["main.cpp"], LIBS = BOOST_LIBS_CPP11) | |
| 17 | + | |
| 18 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/dev/main.cpp
0 → 100644
| 1 | +//#ifndef _WEBSOCKETPP_CPP11_STL_ | |
| 2 | +// #define _WEBSOCKETPP_CPP11_STL_ | |
| 3 | +//#endif | |
| 4 | + | |
| 5 | +#include <random> | |
| 6 | +#include <boost/timer/timer.hpp> | |
| 7 | + | |
| 8 | +#include <websocketpp/config/core.hpp> | |
| 9 | + | |
| 10 | +//#include <websocketpp/security/none.hpp> | |
| 11 | + | |
| 12 | +//#include <websocketpp/concurrency/none.hpp> | |
| 13 | +//#include <websocketpp/concurrency/stl.hpp> | |
| 14 | + | |
| 15 | +//#include <websocketpp/transport/iostream.hpp> | |
| 16 | +#include <websocketpp/server.hpp> | |
| 17 | + | |
| 18 | +#include <iostream> | |
| 19 | +#include <sstream> | |
| 20 | + | |
| 21 | +//typedef websocketpp::concurrency::stl concurrency; | |
| 22 | +//typedef websocketpp::transport::iostream<concurrency> transport; | |
| 23 | +//typedef websocketpp::server<concurrency,transport> server; | |
| 24 | +typedef websocketpp::server<websocketpp::config::core> server; | |
| 25 | + | |
| 26 | +/*class handler : public server::handler { | |
| 27 | + bool validate(connection_ptr con) { | |
| 28 | + std::cout << "handler validate" << std::endl; | |
| 29 | + if (con->get_origin() != "http://www.example.com") { | |
| 30 | + con->set_status(websocketpp::http::status_code::FORBIDDEN); | |
| 31 | + return false; | |
| 32 | + } | |
| 33 | + return true; | |
| 34 | + } | |
| 35 | + | |
| 36 | + void http(connection_ptr con) { | |
| 37 | + std::cout << "handler http" << std::endl; | |
| 38 | + } | |
| 39 | + | |
| 40 | + void on_load(connection_ptr con, ptr old_handler) { | |
| 41 | + std::cout << "handler on_load" << std::endl; | |
| 42 | + } | |
| 43 | + void on_unload(connection_ptr con, ptr new_handler) { | |
| 44 | + std::cout << "handler on_unload" << std::endl; | |
| 45 | + } | |
| 46 | + | |
| 47 | + void on_open(connection_ptr con) { | |
| 48 | + std::cout << "handler on_open" << std::endl; | |
| 49 | + } | |
| 50 | + void on_fail(connection_ptr con) { | |
| 51 | + std::cout << "handler on_fail" << std::endl; | |
| 52 | + } | |
| 53 | + | |
| 54 | + void on_message(connection_ptr con, message_ptr msg) { | |
| 55 | + std::cout << "handler on_message" << std::endl; | |
| 56 | + | |
| 57 | + | |
| 58 | + } | |
| 59 | + | |
| 60 | + void on_close(connection_ptr con) { | |
| 61 | + std::cout << "handler on_close" << std::endl; | |
| 62 | + } | |
| 63 | +};*/ | |
| 64 | + | |
| 65 | +int main() { | |
| 66 | + typedef websocketpp::message_buffer::message<websocketpp::message_buffer::alloc::con_msg_manager> | |
| 67 | + message_type; | |
| 68 | + typedef websocketpp::message_buffer::alloc::con_msg_manager<message_type> | |
| 69 | + con_msg_man_type; | |
| 70 | + | |
| 71 | + con_msg_man_type::ptr manager = websocketpp::lib::make_shared<con_msg_man_type>(); | |
| 72 | + | |
| 73 | + size_t foo = 1024; | |
| 74 | + | |
| 75 | + message_type::ptr input = manager->get_message(websocketpp::frame::opcode::TEXT,foo); | |
| 76 | + message_type::ptr output = manager->get_message(websocketpp::frame::opcode::TEXT,foo); | |
| 77 | + websocketpp::frame::masking_key_type key; | |
| 78 | + | |
| 79 | + std::random_device dev; | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + key.i = 0x12345678; | |
| 84 | + | |
| 85 | + double m = 18094238402394.0824923; | |
| 86 | + | |
| 87 | + /*std::cout << "Some Math" << std::endl; | |
| 88 | + { | |
| 89 | + boost::timer::auto_cpu_timer t; | |
| 90 | + | |
| 91 | + for (int i = 0; i < foo; i++) { | |
| 92 | + m /= 1.001; | |
| 93 | + } | |
| 94 | + | |
| 95 | + }*/ | |
| 96 | + | |
| 97 | + std::cout << m << std::endl; | |
| 98 | + | |
| 99 | + std::cout << "Random Gen" << std::endl; | |
| 100 | + { | |
| 101 | + boost::timer::auto_cpu_timer t; | |
| 102 | + | |
| 103 | + input->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 104 | + output->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 105 | + } | |
| 106 | + | |
| 107 | + std::cout << "Out of place accelerated" << std::endl; | |
| 108 | + { | |
| 109 | + boost::timer::auto_cpu_timer t; | |
| 110 | + | |
| 111 | + websocketpp::frame::word_mask_exact(reinterpret_cast<uint8_t*>(const_cast<char*>(input->get_raw_payload().data())), reinterpret_cast<uint8_t*>(const_cast<char*>(output->get_raw_payload().data())), foo, key); | |
| 112 | + } | |
| 113 | + | |
| 114 | + std::cout << websocketpp::utility::to_hex(input->get_payload().c_str(),20) << std::endl; | |
| 115 | + std::cout << websocketpp::utility::to_hex(output->get_payload().c_str(),20) << std::endl; | |
| 116 | + | |
| 117 | + input->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 118 | + output->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 119 | + | |
| 120 | + std::cout << "In place accelerated" << std::endl; | |
| 121 | + { | |
| 122 | + boost::timer::auto_cpu_timer t; | |
| 123 | + | |
| 124 | + websocketpp::frame::word_mask_exact(reinterpret_cast<uint8_t*>(const_cast<char*>(input->get_raw_payload().data())), reinterpret_cast<uint8_t*>(const_cast<char*>(input->get_raw_payload().data())), foo, key); | |
| 125 | + } | |
| 126 | + | |
| 127 | + std::cout << websocketpp::utility::to_hex(input->get_payload().c_str(),20) << std::endl; | |
| 128 | + std::cout << websocketpp::utility::to_hex(output->get_payload().c_str(),20) << std::endl; | |
| 129 | + | |
| 130 | + input->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 131 | + output->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 132 | + std::cout << "Out of place byte by byte" << std::endl; | |
| 133 | + { | |
| 134 | + boost::timer::auto_cpu_timer t; | |
| 135 | + | |
| 136 | + websocketpp::frame::byte_mask(input->get_raw_payload().begin(), input->get_raw_payload().end(), output->get_raw_payload().begin(), key); | |
| 137 | + } | |
| 138 | + | |
| 139 | + std::cout << websocketpp::utility::to_hex(input->get_payload().c_str(),20) << std::endl; | |
| 140 | + std::cout << websocketpp::utility::to_hex(output->get_payload().c_str(),20) << std::endl; | |
| 141 | + | |
| 142 | + input->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 143 | + output->get_raw_payload().replace(0,foo,foo,'\0'); | |
| 144 | + std::cout << "In place byte by byte" << std::endl; | |
| 145 | + { | |
| 146 | + boost::timer::auto_cpu_timer t; | |
| 147 | + | |
| 148 | + websocketpp::frame::byte_mask(input->get_raw_payload().begin(), input->get_raw_payload().end(), input->get_raw_payload().begin(), key); | |
| 149 | + } | |
| 150 | + | |
| 151 | + std::cout << websocketpp::utility::to_hex(input->get_payload().c_str(),20) << std::endl; | |
| 152 | + std::cout << websocketpp::utility::to_hex(output->get_payload().c_str(),20) << std::endl; | |
| 153 | + | |
| 154 | + input->get_raw_payload().replace(0,foo,foo,'a'); | |
| 155 | + output->get_raw_payload().replace(0,foo,foo,'b'); | |
| 156 | + std::cout << "Copy" << std::endl; | |
| 157 | + { | |
| 158 | + boost::timer::auto_cpu_timer t; | |
| 159 | + | |
| 160 | + std::copy(input->get_raw_payload().begin(), input->get_raw_payload().end(), output->get_raw_payload().begin()); | |
| 161 | + } | |
| 162 | + | |
| 163 | + std::cout << websocketpp::utility::to_hex(input->get_payload().c_str(),20) << std::endl; | |
| 164 | + std::cout << websocketpp::utility::to_hex(output->get_payload().c_str(),20) << std::endl; | |
| 165 | + | |
| 166 | + /*server::handler::ptr h(new handler()); | |
| 167 | + | |
| 168 | + server test_server(h); | |
| 169 | + server::connection_ptr con; | |
| 170 | + | |
| 171 | + std::stringstream output; | |
| 172 | + | |
| 173 | + test_server.register_ostream(&output); | |
| 174 | + | |
| 175 | + con = test_server.get_connection(); | |
| 176 | + | |
| 177 | + con->start(); | |
| 178 | + | |
| 179 | + //foo.handle_accept(con,true); | |
| 180 | + | |
| 181 | + std::stringstream input; | |
| 182 | + input << "GET / HTTP/1.1\r\nHost: www.example.com\r\nConnection: Upgrade\r\nUpgrade: websocket\r\nSec-WebSocket-Version: 13\r\nSec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\r\nOrigin: http://www.example.com\r\n\r\n"; | |
| 183 | + //input << "GET / HTTP/1.1\r\nHost: www.example.com\r\n\r\n"; | |
| 184 | + input >> *con; | |
| 185 | + | |
| 186 | + std::stringstream input2; | |
| 187 | + input2 << "messageabc2"; | |
| 188 | + input2 >> *con; | |
| 189 | + | |
| 190 | + std::stringstream input3; | |
| 191 | + input3 << "messageabc3"; | |
| 192 | + input3 >> *con; | |
| 193 | + | |
| 194 | + std::stringstream input4; | |
| 195 | + input4 << "close"; | |
| 196 | + input4 >> *con; | |
| 197 | + | |
| 198 | + std::cout << "connection output:" << std::endl; | |
| 199 | + std::cout << output.str() << std::endl;*/ | |
| 200 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_client/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (echo_client) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_client/SConscript
0 → 100644
| 1 | +## echo_client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + ['z'] | |
| 18 | + prgs += env_cpp11.Program('echo_client', ["echo_client.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system','random'],env) + [platform_libs] + [polyfill_libs] + ['z'] | |
| 21 | + prgs += env.Program('echo_client', ["echo_client.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_client/echo_client.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2016, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + * | |
| 26 | + */ | |
| 27 | + | |
| 28 | +#include <websocketpp/config/asio_no_tls_client.hpp> | |
| 29 | +#include <websocketpp/client.hpp> | |
| 30 | + | |
| 31 | +#include <iostream> | |
| 32 | + | |
| 33 | +typedef websocketpp::client<websocketpp::config::asio_client> client; | |
| 34 | + | |
| 35 | +using websocketpp::lib::placeholders::_1; | |
| 36 | +using websocketpp::lib::placeholders::_2; | |
| 37 | +using websocketpp::lib::bind; | |
| 38 | + | |
| 39 | +// pull out the type of messages sent by our config | |
| 40 | +typedef websocketpp::config::asio_client::message_type::ptr message_ptr; | |
| 41 | + | |
| 42 | +// This message handler will be invoked once for each incoming message. It | |
| 43 | +// prints the message and then sends a copy of the message back to the server. | |
| 44 | +void on_message(client* c, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 45 | + std::cout << "on_message called with hdl: " << hdl.lock().get() | |
| 46 | + << " and message: " << msg->get_payload() | |
| 47 | + << std::endl; | |
| 48 | + | |
| 49 | + | |
| 50 | + websocketpp::lib::error_code ec; | |
| 51 | + | |
| 52 | + c->send(hdl, msg->get_payload(), msg->get_opcode(), ec); | |
| 53 | + if (ec) { | |
| 54 | + std::cout << "Echo failed because: " << ec.message() << std::endl; | |
| 55 | + } | |
| 56 | +} | |
| 57 | + | |
| 58 | +int main(int argc, char* argv[]) { | |
| 59 | + // Create a client endpoint | |
| 60 | + client c; | |
| 61 | + | |
| 62 | + std::string uri = "ws://localhost:9002"; | |
| 63 | + | |
| 64 | + if (argc == 2) { | |
| 65 | + uri = argv[1]; | |
| 66 | + } | |
| 67 | + | |
| 68 | + try { | |
| 69 | + // Set logging to be pretty verbose (everything except message payloads) | |
| 70 | + c.set_access_channels(websocketpp::log::alevel::all); | |
| 71 | + c.clear_access_channels(websocketpp::log::alevel::frame_payload); | |
| 72 | + | |
| 73 | + // Initialize ASIO | |
| 74 | + c.init_asio(); | |
| 75 | + | |
| 76 | + // Register our message handler | |
| 77 | + c.set_message_handler(bind(&on_message,&c,::_1,::_2)); | |
| 78 | + | |
| 79 | + websocketpp::lib::error_code ec; | |
| 80 | + client::connection_ptr con = c.get_connection(uri, ec); | |
| 81 | + if (ec) { | |
| 82 | + std::cout << "could not create connection because: " << ec.message() << std::endl; | |
| 83 | + return 0; | |
| 84 | + } | |
| 85 | + | |
| 86 | + // Note that connect here only requests a connection. No network messages are | |
| 87 | + // exchanged until the event loop starts running in the next line. | |
| 88 | + c.connect(con); | |
| 89 | + | |
| 90 | + // Start the ASIO io_service run loop | |
| 91 | + // this will cause a single connection to be made to the server. c.run() | |
| 92 | + // will exit when this connection is closed. | |
| 93 | + c.run(); | |
| 94 | + } catch (websocketpp::exception const & e) { | |
| 95 | + std::cout << e.what() << std::endl; | |
| 96 | + } | |
| 97 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (echo_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server/SConscript
0 → 100644
| 1 | +## Main development example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('echo_server', ["echo_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('echo_server', ["echo_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server/echo_handler.hpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2012, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + * | |
| 26 | + */ | |
| 27 | + | |
| 28 | +#ifndef WEBSOCKETPP_ECHO_SERVER_HANDLER_HPP | |
| 29 | +#define WEBSOCKETPP_ECHO_SERVER_HANDLER_HPP | |
| 30 | + | |
| 31 | +class echo_handler : public server::handler { | |
| 32 | + void on_message(connection_ptr con, std::string msg) { | |
| 33 | + con->write(msg); | |
| 34 | + } | |
| 35 | +}; | |
| 36 | + | |
| 37 | +#endif // WEBSOCKETPP_ECHO_SERVER_HANDLER_HPP | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server/echo_server.cpp
0 → 100644
| 1 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 2 | + | |
| 3 | +#include <websocketpp/server.hpp> | |
| 4 | + | |
| 5 | +#include <iostream> | |
| 6 | + | |
| 7 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 8 | + | |
| 9 | +using websocketpp::lib::placeholders::_1; | |
| 10 | +using websocketpp::lib::placeholders::_2; | |
| 11 | +using websocketpp::lib::bind; | |
| 12 | + | |
| 13 | +// pull out the type of messages sent by our config | |
| 14 | +typedef server::message_ptr message_ptr; | |
| 15 | + | |
| 16 | +// Define a callback to handle incoming messages | |
| 17 | +void on_message(server* s, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 18 | + std::cout << "on_message called with hdl: " << hdl.lock().get() | |
| 19 | + << " and message: " << msg->get_payload() | |
| 20 | + << std::endl; | |
| 21 | + | |
| 22 | + // check for a special command to instruct the server to stop listening so | |
| 23 | + // it can be cleanly exited. | |
| 24 | + if (msg->get_payload() == "stop-listening") { | |
| 25 | + s->stop_listening(); | |
| 26 | + return; | |
| 27 | + } | |
| 28 | + | |
| 29 | + try { | |
| 30 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 31 | + } catch (websocketpp::exception const & e) { | |
| 32 | + std::cout << "Echo failed because: " | |
| 33 | + << "(" << e.what() << ")" << std::endl; | |
| 34 | + } | |
| 35 | +} | |
| 36 | + | |
| 37 | +int main() { | |
| 38 | + // Create a server endpoint | |
| 39 | + server echo_server; | |
| 40 | + | |
| 41 | + try { | |
| 42 | + // Set logging settings | |
| 43 | + echo_server.set_access_channels(websocketpp::log::alevel::all); | |
| 44 | + echo_server.clear_access_channels(websocketpp::log::alevel::frame_payload); | |
| 45 | + | |
| 46 | + // Initialize Asio | |
| 47 | + echo_server.init_asio(); | |
| 48 | + | |
| 49 | + // Register our message handler | |
| 50 | + echo_server.set_message_handler(bind(&on_message,&echo_server,::_1,::_2)); | |
| 51 | + | |
| 52 | + // Listen on port 9002 | |
| 53 | + echo_server.listen(9002); | |
| 54 | + | |
| 55 | + // Start the server accept loop | |
| 56 | + echo_server.start_accept(); | |
| 57 | + | |
| 58 | + // Start the ASIO io_service run loop | |
| 59 | + echo_server.run(); | |
| 60 | + } catch (websocketpp::exception const & e) { | |
| 61 | + std::cout << e.what() << std::endl; | |
| 62 | + } catch (...) { | |
| 63 | + std::cout << "other exception" << std::endl; | |
| 64 | + } | |
| 65 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_both/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | + | |
| 6 | +if (OPENSSL_FOUND) | |
| 7 | + | |
| 8 | +init_target (echo_server_both) | |
| 9 | + | |
| 10 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 11 | + | |
| 12 | +link_boost () | |
| 13 | +link_openssl() | |
| 14 | +final_target () | |
| 15 | + | |
| 16 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | |
| 17 | + | |
| 18 | +endif() | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_both/SConscript
0 → 100644
| 1 | +## Combo plain+tls echo server | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | +Import('tls_libs') | |
| 10 | + | |
| 11 | +env = env.Clone () | |
| 12 | +env_cpp11 = env_cpp11.Clone () | |
| 13 | + | |
| 14 | +prgs = [] | |
| 15 | + | |
| 16 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 17 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 18 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 19 | + prgs += env_cpp11.Program('echo_server_both', ["echo_server_both.cpp"], LIBS = ALL_LIBS) | |
| 20 | +else: | |
| 21 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 22 | + prgs += env.Program('echo_server_both', ["echo_server_both.cpp"], LIBS = ALL_LIBS) | |
| 23 | + | |
| 24 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_both/echo_server_both.cpp
0 → 100644
| 1 | +#include <websocketpp/config/asio.hpp> | |
| 2 | +#include <websocketpp/server.hpp> | |
| 3 | + | |
| 4 | +#include <iostream> | |
| 5 | + | |
| 6 | +// define types for two different server endpoints, one for each config we are | |
| 7 | +// using | |
| 8 | +typedef websocketpp::server<websocketpp::config::asio> server_plain; | |
| 9 | +typedef websocketpp::server<websocketpp::config::asio_tls> server_tls; | |
| 10 | + | |
| 11 | +// alias some of the bind related functions as they are a bit long | |
| 12 | +using websocketpp::lib::placeholders::_1; | |
| 13 | +using websocketpp::lib::placeholders::_2; | |
| 14 | +using websocketpp::lib::bind; | |
| 15 | + | |
| 16 | +// type of the ssl context pointer is long so alias it | |
| 17 | +typedef websocketpp::lib::shared_ptr<boost::asio::ssl::context> context_ptr; | |
| 18 | + | |
| 19 | +// The shared on_message handler takes a template parameter so the function can | |
| 20 | +// resolve any endpoint dependent types like message_ptr or connection_ptr | |
| 21 | +template <typename EndpointType> | |
| 22 | +void on_message(EndpointType* s, websocketpp::connection_hdl hdl, | |
| 23 | + typename EndpointType::message_ptr msg) | |
| 24 | +{ | |
| 25 | + std::cout << "on_message called with hdl: " << hdl.lock().get() | |
| 26 | + << " and message: " << msg->get_payload() | |
| 27 | + << std::endl; | |
| 28 | + | |
| 29 | + try { | |
| 30 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 31 | + } catch (websocketpp::exception const & e) { | |
| 32 | + std::cout << "Echo failed because: " | |
| 33 | + << "(" << e.what() << ")" << std::endl; | |
| 34 | + } | |
| 35 | +} | |
| 36 | + | |
| 37 | +// No change to TLS init methods from echo_server_tls | |
| 38 | +std::string get_password() { | |
| 39 | + return "test"; | |
| 40 | +} | |
| 41 | + | |
| 42 | +context_ptr on_tls_init(websocketpp::connection_hdl hdl) { | |
| 43 | + std::cout << "on_tls_init called with hdl: " << hdl.lock().get() << std::endl; | |
| 44 | + context_ptr ctx(new boost::asio::ssl::context(boost::asio::ssl::context::tlsv1)); | |
| 45 | + | |
| 46 | + try { | |
| 47 | + ctx->set_options(boost::asio::ssl::context::default_workarounds | | |
| 48 | + boost::asio::ssl::context::no_sslv2 | | |
| 49 | + boost::asio::ssl::context::no_sslv3 | | |
| 50 | + boost::asio::ssl::context::single_dh_use); | |
| 51 | + ctx->set_password_callback(bind(&get_password)); | |
| 52 | + ctx->use_certificate_chain_file("server.pem"); | |
| 53 | + ctx->use_private_key_file("server.pem", boost::asio::ssl::context::pem); | |
| 54 | + } catch (std::exception& e) { | |
| 55 | + std::cout << e.what() << std::endl; | |
| 56 | + } | |
| 57 | + return ctx; | |
| 58 | +} | |
| 59 | + | |
| 60 | +int main() { | |
| 61 | + // set up an external io_service to run both endpoints on. This is not | |
| 62 | + // strictly necessary, but simplifies thread management a bit. | |
| 63 | + boost::asio::io_service ios; | |
| 64 | + | |
| 65 | + // set up plain endpoint | |
| 66 | + server_plain endpoint_plain; | |
| 67 | + // initialize asio with our external io_service rather than an internal one | |
| 68 | + endpoint_plain.init_asio(&ios); | |
| 69 | + endpoint_plain.set_message_handler( | |
| 70 | + bind(&on_message<server_plain>,&endpoint_plain,::_1,::_2)); | |
| 71 | + endpoint_plain.listen(80); | |
| 72 | + endpoint_plain.start_accept(); | |
| 73 | + | |
| 74 | + // set up tls endpoint | |
| 75 | + server_tls endpoint_tls; | |
| 76 | + endpoint_tls.init_asio(&ios); | |
| 77 | + endpoint_tls.set_message_handler( | |
| 78 | + bind(&on_message<server_tls>,&endpoint_tls,::_1,::_2)); | |
| 79 | + // TLS endpoint has an extra handler for the tls init | |
| 80 | + endpoint_tls.set_tls_init_handler(bind(&on_tls_init,::_1)); | |
| 81 | + // tls endpoint listens on a different port | |
| 82 | + endpoint_tls.listen(443); | |
| 83 | + endpoint_tls.start_accept(); | |
| 84 | + | |
| 85 | + // Start the ASIO io_service run loop running both endpoints | |
| 86 | + ios.run(); | |
| 87 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_both/server.pem
0 → 100644
| 1 | +-----BEGIN RSA PRIVATE KEY----- | |
| 2 | +Proc-Type: 4,ENCRYPTED | |
| 3 | +DEK-Info: DES-EDE3-CBC,A0ED66EF872A48A9 | |
| 4 | + | |
| 5 | +gXuvKojXzApVhhPVNdRliiajbC4PtwQG5c8TA7JADLgwOR7o9t6KtXEr37bDRpvB | |
| 6 | +9aO9P+SJaK5OOp3XKPGthOdqv+tvCRTlmzmC8GjPLBX389DWT2xoGu7JkGwDtdSm | |
| 7 | +rnF49Rlp5bfjpACk5xKNiKeDo1CWfeEJzw9Kto0g+5eMaEdors64oPzjXs3geA2g | |
| 8 | +TxCJSHv9qSX6++pCLKKCUTbyzidAxV/Zb0AAubt5V40QKqX4HhSwwstFnTaX3tlb | |
| 9 | +3QOdY+y04VIkM6d7qN5W8M7NzRkMpZ1qBpQcUMpkhQcRzWP2wub5AAff9D2GntRd | |
| 10 | +4Dz1vn3u41U3Okdr0CNj+iH7byCzuokoAhk6ZQEN6WB+GTpGgfBXdtUZrfpb0MKm | |
| 11 | +UNYP5AF2AmUqJRXhViTDVtu/V2tHF3LGuNT+W2Dz+spFZEq0byEO0N858eR0dikc | |
| 12 | +6jOASvNQbSwD0+mkgBC1gXKKU3ngj2gpJUwljeACdWFd8N2egrZfyI05CmX7vPNC | |
| 13 | +NXbs7k2buWNdjP4/D8IM+HDVidWzQa/kG/qokXKqllem9Egg37lUucwnP3cX2/Hw | |
| 14 | +U2mfaBWzeZtqc+GqRp08rYIql+Reai3sUYlQMnNk01prVY47UQb+dxuqjaxGV5Xx | |
| 15 | +Xkx0s2mfQnNRjL4S7Hjhqelufi6GpkCQ2EGsPpA+6K1ztZ0ame9Q2BE1SXeM/6vU | |
| 16 | +rxT5nRrCxueyXAyQSGcqMX9//gSeK8WWBqG/c1IAMVDa0NWrJeOJhSziE+ta3B0m | |
| 17 | +bHAPBY6vh0iB3lLdRlbUOPbC6R1TpxMOs+6Vbs2+OTifFpvOVymEoZq/nroyg68P | |
| 18 | +vn5uCKogwWA7o8EArf/UTlIwWJmH9bgILdZKld4wMel2HQg16RDzm+mEXAJi52a/ | |
| 19 | +FC+fgfphdxltmUJ+rqOyR4AHULjaTWUQqTIB6sdlzgmES1nXAiE71zX//KFqomar | |
| 20 | +O60SPPk3C1bs0x5DsvmGJa8SIfDhyd+D7NPyqwEKqrZsaotYGklNkfqxa6pa8mrc | |
| 21 | +ejxquW1PK4FvBk26+osu5a90Jih0PcQM7DUMMr2WHdTiMSXWAiK2ToYF8Itt25Qv | |
| 22 | +Cd0CsSYw9CJkXNr1u1+mObheaY9QYOmztnSJLy4ZO2JsMhqNwuAueIcwmhXOREq7 | |
| 23 | +kzlnGMgJcuSeAS/OBNj8Zgx0c7QQ0kzc+YmnOCsqoMtPsu/CsXJ4iJiM3Tki/2jT | |
| 24 | +bywrTiQwE6R3a/87GREOREX+WLicZBWX3k9/4tBL5XSe1p5wPpuIRQUDvAGNfNHP | |
| 25 | +JN7kujDF4SehilF1qtvCygAwvxHFDj+EwhXKNDKJzoZZIM15rAk3k92n2j6nz1qH | |
| 26 | +a3xOU05yydOlO6F6w51I1QoDddmkzCRNB0TeO3D6rekHsCK1aDWmC+qRcm2ZFtVz | |
| 27 | +sY6fdZN2NEmMQokIh9Opi1f8CSYSizPESMzdu2SF0xVO9n/IGIkn1ksK04O2BZo0 | |
| 28 | +X3LBPHLfCRsQNY1eF17bj07fYU2oPZKs/XzJiwxkqK6LFvpeAVaYrtg9fqRO/UVe | |
| 29 | +QhUIj3BL550ocEpa15xLehLrmwzYiW5zwGjSHQ4EgZluGLCwyKGTh4QswEJRA9Rt | |
| 30 | +-----END RSA PRIVATE KEY----- | |
| 31 | +-----BEGIN CERTIFICATE----- | |
| 32 | +MIIE0DCCA7igAwIBAgIJAM5MuKJezXq0MA0GCSqGSIb3DQEBBQUAMIGgMQswCQYD | |
| 33 | +VQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28xGDAW | |
| 34 | +BgNVBAoTD1phcGhveWQgU3R1ZGlvczEUMBIGA1UECxMLV2ViU29ja2V0KysxFjAU | |
| 35 | +BgNVBAMTDVBldGVyIFRob3Jzb24xJDAiBgkqhkiG9w0BCQEWFXdlYm1hc3RlckB6 | |
| 36 | +YXBob3lkLmNvbTAeFw0xMTExMTUyMTIwMDZaFw0xMjExMTQyMTIwMDZaMIGgMQsw | |
| 37 | +CQYDVQQGEwJVUzERMA8GA1UECBMISWxsaW5vaXMxEDAOBgNVBAcTB0NoaWNhZ28x | |
| 38 | +GDAWBgNVBAoTD1phcGhveWQgU3R1ZGlvczEUMBIGA1UECxMLV2ViU29ja2V0Kysx | |
| 39 | +FjAUBgNVBAMTDVBldGVyIFRob3Jzb24xJDAiBgkqhkiG9w0BCQEWFXdlYm1hc3Rl | |
| 40 | +ckB6YXBob3lkLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANR0 | |
| 41 | +tdwAnIB8I9qRZ7QbzEWY95RpM7GIn0u/9oH90PzdHiE0rXSkKT+yw3XUzH0iw5t0 | |
| 42 | +5dEwSC+srSP5Vm4cA6kXc94agVVaPW89tGcdP4fHptCruSrzQsDXELCPl5UUvMpA | |
| 43 | +YUcGisdXYPN/EeOoqb9wKWxoW5mREsyyeWWS89fYN5qU/d0QpbSvEWghqLbL/ZS2 | |
| 44 | +hOlXT9LufOeA+vHiV1/T/h5xC7ecIH02YDQw1EnqxbPmkLPcWThztLS9FiufNDRM | |
| 45 | +Rhcoaj2b9VDHvDwdbeA0T5v5qNdG34LaapYOelxzQMOtM0f9Dgqehodyxl2qm9mR | |
| 46 | +lq432dlOEzDnVCPNHwECAwEAAaOCAQkwggEFMB0GA1UdDgQWBBTTPKfNMnKOykhv | |
| 47 | ++vKS7vql5JsMyzCB1QYDVR0jBIHNMIHKgBTTPKfNMnKOykhv+vKS7vql5JsMy6GB | |
| 48 | +pqSBozCBoDELMAkGA1UEBhMCVVMxETAPBgNVBAgTCElsbGlub2lzMRAwDgYDVQQH | |
| 49 | +EwdDaGljYWdvMRgwFgYDVQQKEw9aYXBob3lkIFN0dWRpb3MxFDASBgNVBAsTC1dl | |
| 50 | +YlNvY2tldCsrMRYwFAYDVQQDEw1QZXRlciBUaG9yc29uMSQwIgYJKoZIhvcNAQkB | |
| 51 | +FhV3ZWJtYXN0ZXJAemFwaG95ZC5jb22CCQDOTLiiXs16tDAMBgNVHRMEBTADAQH/ | |
| 52 | +MA0GCSqGSIb3DQEBBQUAA4IBAQB+SH0s/hrv5VYqgX6SNLzxdSLvCVsUkCdTpxwY | |
| 53 | +wOJ84XmYcXDMhKDtZqLtOtN6pfEwVusFlC9mkieuunztCnWNmsSG83RuljJPjFSi | |
| 54 | +1d4Id4bKEQkQ4cfnjoHKivRrViWLnxuNnLzC6tpyGH/35kKWhhr6T58AXerFgVw3 | |
| 55 | +mHvLPTr1DuhdAZA0ZuvuseVAFFAjI3RetSySwHJE3ak8KswDVfLi6E3XxMVsIWTS | |
| 56 | +/iFsC2WwoZQlljya2V/kRYIhu+uCdqJ01wunn2BvmURPSgr4GTBF0FQ9JGpNbXxM | |
| 57 | +TAU7oQJgyFc5sCcuEgPTO0dWVQTvdZVgay4tkmduKDRkmJBF | |
| 58 | +-----END CERTIFICATE----- | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_tls/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | + | |
| 6 | +if (OPENSSL_FOUND) | |
| 7 | + | |
| 8 | +init_target (echo_server_tls) | |
| 9 | + | |
| 10 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 11 | + | |
| 12 | +link_boost () | |
| 13 | +link_openssl() | |
| 14 | +final_target () | |
| 15 | + | |
| 16 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | |
| 17 | + | |
| 18 | +endif() | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_tls/SConscript
0 → 100644
| 1 | +## Main development example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | +Import('tls_libs') | |
| 10 | + | |
| 11 | +env = env.Clone () | |
| 12 | +env_cpp11 = env_cpp11.Clone () | |
| 13 | + | |
| 14 | +prgs = [] | |
| 15 | + | |
| 16 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 17 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 18 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 19 | + prgs += env_cpp11.Program('echo_server_tls', ["echo_server_tls.cpp"], LIBS = ALL_LIBS) | |
| 20 | +else: | |
| 21 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 22 | + prgs += env.Program('echo_server_tls', ["echo_server_tls.cpp"], LIBS = ALL_LIBS) | |
| 23 | + | |
| 24 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_tls/dh.pem
0 → 100644
| 1 | +-----BEGIN DH PARAMETERS----- | |
| 2 | +MIIBCAKCAQEAqxMGKZB8YNV8WQnbJWwwwmifc+PfVRtd1FN5v5aQSsf6dpjX3Zlh | |
| 3 | +N1NmgecsQyg4u2EWe4Umta10QzCgYaxf6QdTCg7iprLzFNw7IvWYbQ6du12NMGDr | |
| 4 | +hmwA6KQKwbTgPL6mSlSlcK2wTP2FzxDTNffFu10cB/6Fj4kdQjPG0c1Koz/z7OOq | |
| 5 | +BuDElJLClS8rjp3z1xvrc7gX95dFa2KaKgOAYDkpe8tfHRhHfJeIVS/whH9hzx6r | |
| 6 | +OBg+E5K9JyvayrUoKgPeptRKCqo8A4YevtMLpRxMup0nMUgAIv6+BGTwPAFpwgl/ | |
| 7 | +8UIVcvjh1v95PwGDM/Q8yvIBJznBYk/e2wIBAg== | |
| 8 | +-----END DH PARAMETERS----- | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_tls/echo_server_tls.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2015, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + * | |
| 26 | + */ | |
| 27 | + | |
| 28 | + /** | |
| 29 | + * NOTES | |
| 30 | + * | |
| 31 | + * This example uses a number of standard classes through the websocketpp::lib | |
| 32 | + * namespace. This is to allow easy switching between Boost, the C++11 STL, and | |
| 33 | + * the standalone Asio library. Your program need not use these namespaces if | |
| 34 | + * you do not need this sort of flexibility. | |
| 35 | + */ | |
| 36 | + | |
| 37 | +#include <websocketpp/config/asio.hpp> | |
| 38 | + | |
| 39 | +#include <websocketpp/server.hpp> | |
| 40 | + | |
| 41 | +#include <iostream> | |
| 42 | + | |
| 43 | +typedef websocketpp::server<websocketpp::config::asio_tls> server; | |
| 44 | + | |
| 45 | +using websocketpp::lib::placeholders::_1; | |
| 46 | +using websocketpp::lib::placeholders::_2; | |
| 47 | +using websocketpp::lib::bind; | |
| 48 | + | |
| 49 | +// pull out the type of messages sent by our config | |
| 50 | +typedef websocketpp::config::asio::message_type::ptr message_ptr; | |
| 51 | +typedef websocketpp::lib::shared_ptr<websocketpp::lib::asio::ssl::context> context_ptr; | |
| 52 | + | |
| 53 | +void on_message(server* s, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 54 | + std::cout << "on_message called with hdl: " << hdl.lock().get() | |
| 55 | + << " and message: " << msg->get_payload() | |
| 56 | + << std::endl; | |
| 57 | + | |
| 58 | + try { | |
| 59 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 60 | + } catch (websocketpp::exception const & e) { | |
| 61 | + std::cout << "Echo failed because: " | |
| 62 | + << "(" << e.what() << ")" << std::endl; | |
| 63 | + } | |
| 64 | +} | |
| 65 | + | |
| 66 | +void on_http(server* s, websocketpp::connection_hdl hdl) { | |
| 67 | + server::connection_ptr con = s->get_con_from_hdl(hdl); | |
| 68 | + | |
| 69 | + con->set_body("Hello World!"); | |
| 70 | + con->set_status(websocketpp::http::status_code::ok); | |
| 71 | +} | |
| 72 | + | |
| 73 | +std::string get_password() { | |
| 74 | + return "test"; | |
| 75 | +} | |
| 76 | + | |
| 77 | +// See https://wiki.mozilla.org/Security/Server_Side_TLS for more details about | |
| 78 | +// the TLS modes. The code below demonstrates how to implement both the modern | |
| 79 | +enum tls_mode { | |
| 80 | + MOZILLA_INTERMEDIATE = 1, | |
| 81 | + MOZILLA_MODERN = 2 | |
| 82 | +}; | |
| 83 | + | |
| 84 | +context_ptr on_tls_init(tls_mode mode, websocketpp::connection_hdl hdl) { | |
| 85 | + namespace asio = websocketpp::lib::asio; | |
| 86 | + | |
| 87 | + std::cout << "on_tls_init called with hdl: " << hdl.lock().get() << std::endl; | |
| 88 | + std::cout << "using TLS mode: " << (mode == MOZILLA_MODERN ? "Mozilla Modern" : "Mozilla Intermediate") << std::endl; | |
| 89 | + | |
| 90 | + context_ptr ctx = websocketpp::lib::make_shared<asio::ssl::context>(asio::ssl::context::sslv23); | |
| 91 | + | |
| 92 | + try { | |
| 93 | + if (mode == MOZILLA_MODERN) { | |
| 94 | + // Modern disables TLSv1 | |
| 95 | + ctx->set_options(asio::ssl::context::default_workarounds | | |
| 96 | + asio::ssl::context::no_sslv2 | | |
| 97 | + asio::ssl::context::no_sslv3 | | |
| 98 | + asio::ssl::context::no_tlsv1 | | |
| 99 | + asio::ssl::context::single_dh_use); | |
| 100 | + } else { | |
| 101 | + ctx->set_options(asio::ssl::context::default_workarounds | | |
| 102 | + asio::ssl::context::no_sslv2 | | |
| 103 | + asio::ssl::context::no_sslv3 | | |
| 104 | + asio::ssl::context::single_dh_use); | |
| 105 | + } | |
| 106 | + ctx->set_password_callback(bind(&get_password)); | |
| 107 | + ctx->use_certificate_chain_file("server.pem"); | |
| 108 | + ctx->use_private_key_file("server.pem", asio::ssl::context::pem); | |
| 109 | + | |
| 110 | + // Example method of generating this file: | |
| 111 | + // `openssl dhparam -out dh.pem 2048` | |
| 112 | + // Mozilla Intermediate suggests 1024 as the minimum size to use | |
| 113 | + // Mozilla Modern suggests 2048 as the minimum size to use. | |
| 114 | + ctx->use_tmp_dh_file("dh.pem"); | |
| 115 | + | |
| 116 | + std::string ciphers; | |
| 117 | + | |
| 118 | + if (mode == MOZILLA_MODERN) { | |
| 119 | + ciphers = "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!3DES:!MD5:!PSK"; | |
| 120 | + } else { | |
| 121 | + ciphers = "ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA"; | |
| 122 | + } | |
| 123 | + | |
| 124 | + if (SSL_CTX_set_cipher_list(ctx->native_handle() , ciphers.c_str()) != 1) { | |
| 125 | + std::cout << "Error setting cipher list" << std::endl; | |
| 126 | + } | |
| 127 | + } catch (std::exception& e) { | |
| 128 | + std::cout << "Exception: " << e.what() << std::endl; | |
| 129 | + } | |
| 130 | + return ctx; | |
| 131 | +} | |
| 132 | + | |
| 133 | +int main() { | |
| 134 | + // Create a server endpoint | |
| 135 | + server echo_server; | |
| 136 | + | |
| 137 | + // Initialize ASIO | |
| 138 | + echo_server.init_asio(); | |
| 139 | + | |
| 140 | + // Register our message handler | |
| 141 | + echo_server.set_message_handler(bind(&on_message,&echo_server,::_1,::_2)); | |
| 142 | + echo_server.set_http_handler(bind(&on_http,&echo_server,::_1)); | |
| 143 | + echo_server.set_tls_init_handler(bind(&on_tls_init,MOZILLA_INTERMEDIATE,::_1)); | |
| 144 | + | |
| 145 | + // Listen on port 9002 | |
| 146 | + echo_server.listen(9002); | |
| 147 | + | |
| 148 | + // Start the server accept loop | |
| 149 | + echo_server.start_accept(); | |
| 150 | + | |
| 151 | + // Start the ASIO io_service run loop | |
| 152 | + echo_server.run(); | |
| 153 | + | |
| 154 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/echo_server_tls/server.pem
0 → 100644
| 1 | +-----BEGIN PRIVATE KEY----- | |
| 2 | +MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQDMYjHlTUeUGSys | |
| 3 | +Fz5PZcvgS3gojBlEAOu2gXFQDcJ7kq6dJ4jKsPaH1Q5jAtEDkU/el8otzfacOgyp | |
| 4 | +2ZxioRimpmcORWGU0bKJcenh4ZQ1oK1CQObjeYk1YgE7H8/sBetSdtL4n1rB8LIz | |
| 5 | +AV/k6kwSZFu3/lSmc6g09H4efSKGKVBcVOjBamcvFGVH4KhM2NyL+ffeV5H2Ucxk | |
| 6 | +ipyhpr4uxEoC3EV60sQxloqZb+upBM0LS4kVvaYMcn39XkUx3Z8FwN5+hFGwsWda | |
| 7 | +tU8zDxEuRMrZxG7mwDXLBGehtQvoJIVMQbOuwBQcgAbsVyy1dxV3aczbLX0iGEuG | |
| 8 | +eBhdFE+BAgMBAAECggEAQaPn0nUXYAEVz89HO8i9ybNzS9Jy6txA18SK1+MTawyY | |
| 9 | +9/AShsZ+5vEORc5JwpOQyzSEwmE7qsEaABLbnvGOMTeQMY0m4dzXMj1bmCgSqYaJ | |
| 10 | +HpYpkTUfU/2913dIF81u3nU7HI5RX6gmEyuF2MdG10FUE6ujFDJg+2DqgHA//kYD | |
| 11 | +hkXFinVS2PuZs8d5xdzpF0aCIWTuOc+Fgsyhdm/lZRIzFdID45YUVuPIN2uh+GkM | |
| 12 | +ENp/r1x7dPlDRqiL1ufP0mTQGs26S5kQSF8W0BClkOIOgmrhSON4+Vqhqx+ki/7w | |
| 13 | +RY+7mmgdvt0uzYT+Lk2cDw4f89Rsh7rR1EieBpQ2YQKBgQDq6zAHWfweJmkugT0w | |
| 14 | +HzI0UKfcOdzlJBwMu6tSgSHU99dnXlTwQY8sG7vtfRekokoo7XY4JsSk1n6E9OVy | |
| 15 | +4UKuEvU1+llDGxtvHxEEGOAgwB8wxMuY4uNYgDVhTlUzr2ERcet7FOIGzxEWzSsg | |
| 16 | +5vgnTQfyMzAh5/6k8CsHVI4u2wKBgQDeuYVCgg555lcc5rvTFxfU15d3fweSd78+ | |
| 17 | +akgIBaXAlFbxI+5znGPmKG/ii4N2XObC8B568fA2nIxw6M1xgbKyvvmN3ECYiqWv | |
| 18 | +bx8x6Vg5Slg0vJr+DrPgvIKbOWEEKF/cfpTeeVLP0gUBT63mA3qezuRx1r0JJr7A | |
| 19 | +k9a4Td9j0wKBgDmRQMfMaVgKGaRnz1LHkkn3qerx0wvj+Wu1YZpqQpwp0ANovm/R | |
| 20 | +4P/yG+9qxCx4CKxW5K2F8pJibcavLLsmMGzwAF8l5lHnhqWIe2cBoYrlCb+tuibR | |
| 21 | +Et1RLcOWqpJr2+GmhQo4Z9s7SvjHdlYtw4n9+oCDwrvMWj6ZDDJTqjQZAoGAEhRt | |
| 22 | +RODZ2/texvHT/Wa6gISfvwuIydL+q0plXoFW2zMve5O3H5tqYJyXuIQqv8j60og7 | |
| 23 | +cS+CmGxM2j2Lr9MfdnMaPvHKLJfUq1ER7zNJ/hyS3HUS/9yhrXSgBYm63mOIpJWB | |
| 24 | +8C1ZE5Ww4lJdg3Z01b9lu/f6kGucwHU/0OZBZBECgYAQ+dl2kKKd+lQ9O/LVz7oD | |
| 25 | +goQMPYF+QZcEhY4vlYKkWVtR2A0CiY6XeTi6vO/qVUt/ht+UO3XIJFOjGV1VyORQ | |
| 26 | +Bhibfstxl5s59jGlns5y5QqcRKzCiX74BKG0xQUtHgga7Od6L+GJKbJAPBfncYwW | |
| 27 | +U7Tfwwi0WbbgQoy5Xr/5gg== | |
| 28 | +-----END PRIVATE KEY----- | |
| 29 | +-----BEGIN CERTIFICATE----- | |
| 30 | +MIIFBTCCAu2gAwIBAgICEAEwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNVBAYTAlVT | |
| 31 | +MQswCQYDVQQIDAJJTDEUMBIGA1UECgwLV2ViU29ja2V0KysxKjAoBgNVBAsMIVdl | |
| 32 | +YlNvY2tldCsrIENlcnRpZmljYXRlIEF1dGhvcml0eTEkMCIGA1UEAwwbV2ViU29j | |
| 33 | +a2V0KysgSW50ZXJtZWRpYXRlIENBMB4XDTE2MDYwODEyNDUxMloXDTI2MDYwNjEy | |
| 34 | +NDUxMlowfjELMAkGA1UEBhMCVVMxCzAJBgNVBAgMAklMMRAwDgYDVQQHDAdDaGlj | |
| 35 | +YWdvMRQwEgYDVQQKDAtXZWJTb2NrZXQrKzEgMB4GA1UECwwXV2ViU29ja2V0Kysg | |
| 36 | +VExTIEV4YW1wbGUxGDAWBgNVBAMMD3dlYnNvY2tldHBwLm9yZzCCASIwDQYJKoZI | |
| 37 | +hvcNAQEBBQADggEPADCCAQoCggEBAMxiMeVNR5QZLKwXPk9ly+BLeCiMGUQA67aB | |
| 38 | +cVANwnuSrp0niMqw9ofVDmMC0QORT96Xyi3N9pw6DKnZnGKhGKamZw5FYZTRsolx | |
| 39 | +6eHhlDWgrUJA5uN5iTViATsfz+wF61J20vifWsHwsjMBX+TqTBJkW7f+VKZzqDT0 | |
| 40 | +fh59IoYpUFxU6MFqZy8UZUfgqEzY3Iv5995XkfZRzGSKnKGmvi7ESgLcRXrSxDGW | |
| 41 | +iplv66kEzQtLiRW9pgxyff1eRTHdnwXA3n6EUbCxZ1q1TzMPES5EytnEbubANcsE | |
| 42 | +Z6G1C+gkhUxBs67AFByABuxXLLV3FXdpzNstfSIYS4Z4GF0UT4ECAwEAAaOBhzCB | |
| 43 | +hDALBgNVHQ8EBAMCBDAwEwYDVR0lBAwwCgYIKwYBBQUHAwEwYAYDVR0RBFkwV4IP | |
| 44 | +d2Vic29ja2V0cHAub3JnghN3d3cud2Vic29ja2V0cHAub3Jnghl1dGlsaXRpZXMu | |
| 45 | +d2Vic29ja2V0cHAub3JnghRkb2NzLndlYnNvY2tldHBwLm9yZzANBgkqhkiG9w0B | |
| 46 | +AQsFAAOCAgEAelJvIWFikBU3HVoP0icuoezTHGqABPLCeooTC/GELq7lHCFEjiqW | |
| 47 | +p96Zc3vrk+0Z0tkYy3E0fpuzPtlTUhBzO3fMF41FpB5ix3W/tH9YJvrozlIuDD1I | |
| 48 | +IEusxomeeiMRbyYpX/gkSOO74ylCzMEQVzleMNdpzpeXOg0Kp5z2JNShdEoT7eMR | |
| 49 | +qkJQJjMdL6QeXUqWNvX1Zqb8v6VeWGWjuu/cl374P8D8bjn89VwZQ5HFqoLOhI5v | |
| 50 | +XEYsMViZWwLSMcfWTU2Rdi0RxUZQVciLP/3GQROR1/0/e1J1kd7GsRWQMZcU20Vy | |
| 51 | +jXBVAiWhW1bgd0XOrrFILsAmnBtinEJiE+h5UC4ksZtwWf9x1IhXGlpb9bmD4+Ud | |
| 52 | +93wmqytPXBFL6wwlj4IYjjy0gU6xP6h7nwhHXnBlwFWGDpe8Cco9qgyJxJxBTtj9 | |
| 53 | +MbBv+BSLXJoniDASdk6RIqCjPWZtWbQ7j5mIKV0bdJQZpBX553QOy8AoIpJE32An | |
| 54 | +FzR0SSCHOCgSAbqtM8CvLO6mquEJunmwKQx6xfos5N6ee+D+JtUFTw04TrjZUzFs | |
| 55 | +Z7v3SN/N4Hd13iTBDSu4XY/tJYICvTRLYNrzQRh/XEVbEEVxXhL8rxNn5aL1pqrV | |
| 56 | +yEnvHXrnSXWxTif1K+hS2HfTkQ6d1GjglvmwkoBqBHuRH0OJ1VguTqM= | |
| 57 | +-----END CERTIFICATE----- | ... | ... |
3rdparty/websocketpp-0.8.2/examples/enriched_storage/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (enriched_storage) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/enriched_storage/enriched_storage.cpp
0 → 100644
| 1 | +#include <iostream> | |
| 2 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 3 | +#include <websocketpp/server.hpp> | |
| 4 | + | |
| 5 | +struct connection_data { | |
| 6 | + int sessionid; | |
| 7 | + std::string name; | |
| 8 | +}; | |
| 9 | + | |
| 10 | +struct custom_config : public websocketpp::config::asio { | |
| 11 | + // pull default settings from our core config | |
| 12 | + typedef websocketpp::config::asio core; | |
| 13 | + | |
| 14 | + typedef core::concurrency_type concurrency_type; | |
| 15 | + typedef core::request_type request_type; | |
| 16 | + typedef core::response_type response_type; | |
| 17 | + typedef core::message_type message_type; | |
| 18 | + typedef core::con_msg_manager_type con_msg_manager_type; | |
| 19 | + typedef core::endpoint_msg_manager_type endpoint_msg_manager_type; | |
| 20 | + typedef core::alog_type alog_type; | |
| 21 | + typedef core::elog_type elog_type; | |
| 22 | + typedef core::rng_type rng_type; | |
| 23 | + typedef core::transport_type transport_type; | |
| 24 | + typedef core::endpoint_base endpoint_base; | |
| 25 | + | |
| 26 | + // Set a custom connection_base class | |
| 27 | + typedef connection_data connection_base; | |
| 28 | +}; | |
| 29 | + | |
| 30 | +typedef websocketpp::server<custom_config> server; | |
| 31 | +typedef server::connection_ptr connection_ptr; | |
| 32 | + | |
| 33 | +using websocketpp::connection_hdl; | |
| 34 | +using websocketpp::lib::placeholders::_1; | |
| 35 | +using websocketpp::lib::placeholders::_2; | |
| 36 | +using websocketpp::lib::bind; | |
| 37 | + | |
| 38 | +class print_server { | |
| 39 | +public: | |
| 40 | + print_server() : m_next_sessionid(1) { | |
| 41 | + m_server.init_asio(); | |
| 42 | + | |
| 43 | + m_server.set_open_handler(bind(&print_server::on_open,this,::_1)); | |
| 44 | + m_server.set_close_handler(bind(&print_server::on_close,this,::_1)); | |
| 45 | + m_server.set_message_handler(bind(&print_server::on_message,this,::_1,::_2)); | |
| 46 | + } | |
| 47 | + | |
| 48 | + void on_open(connection_hdl hdl) { | |
| 49 | + connection_ptr con = m_server.get_con_from_hdl(hdl); | |
| 50 | + | |
| 51 | + con->sessionid = m_next_sessionid++; | |
| 52 | + } | |
| 53 | + | |
| 54 | + void on_close(connection_hdl hdl) { | |
| 55 | + connection_ptr con = m_server.get_con_from_hdl(hdl); | |
| 56 | + | |
| 57 | + std::cout << "Closing connection " << con->name | |
| 58 | + << " with sessionid " << con->sessionid << std::endl; | |
| 59 | + } | |
| 60 | + | |
| 61 | + void on_message(connection_hdl hdl, server::message_ptr msg) { | |
| 62 | + connection_ptr con = m_server.get_con_from_hdl(hdl); | |
| 63 | + | |
| 64 | + if (con->name.empty()) { | |
| 65 | + con->name = msg->get_payload(); | |
| 66 | + std::cout << "Setting name of connection with sessionid " | |
| 67 | + << con->sessionid << " to " << con->name << std::endl; | |
| 68 | + } else { | |
| 69 | + std::cout << "Got a message from connection " << con->name | |
| 70 | + << " with sessionid " << con->sessionid << std::endl; | |
| 71 | + } | |
| 72 | + } | |
| 73 | + | |
| 74 | + void run(uint16_t port) { | |
| 75 | + m_server.listen(port); | |
| 76 | + m_server.start_accept(); | |
| 77 | + m_server.run(); | |
| 78 | + } | |
| 79 | +private: | |
| 80 | + int m_next_sessionid; | |
| 81 | + server m_server; | |
| 82 | +}; | |
| 83 | + | |
| 84 | +int main() { | |
| 85 | + print_server server; | |
| 86 | + server.run(9002); | |
| 87 | +} | |
| 0 | 88 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/examples/external_io_service/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (external_io_service) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/external_io_service/SConscript
0 → 100644
| 1 | +## Main development example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('external_io_service', ["external_io_service.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('external_io_service', ["external_io_service.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/external_io_service/external_io_service.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2015, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + */ | |
| 26 | + | |
| 27 | +#include "tcp_echo_server.hpp" | |
| 28 | + | |
| 29 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 30 | +#include <websocketpp/server.hpp> | |
| 31 | + | |
| 32 | +#include <iostream> | |
| 33 | + | |
| 34 | +using websocketpp::lib::placeholders::_1; | |
| 35 | +using websocketpp::lib::placeholders::_2; | |
| 36 | +using websocketpp::lib::bind; | |
| 37 | + | |
| 38 | +typedef websocketpp::server<websocketpp::config::asio> ws_echo_server; | |
| 39 | + | |
| 40 | +// Define a callback to handle incoming messages | |
| 41 | +void on_message(ws_echo_server* s, websocketpp::connection_hdl hdl, ws_echo_server::message_ptr msg) { | |
| 42 | + std::cout << "on_message called with hdl: " << hdl.lock().get() | |
| 43 | + << " and message: " << msg->get_payload() | |
| 44 | + << std::endl; | |
| 45 | + | |
| 46 | + // check for a special command to instruct the server to stop listening so | |
| 47 | + // it can be cleanly exited. | |
| 48 | + if (msg->get_payload() == "stop-listening") { | |
| 49 | + s->stop_listening(); | |
| 50 | + return; | |
| 51 | + } | |
| 52 | + | |
| 53 | + try { | |
| 54 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 55 | + } catch (websocketpp::exception const & e) { | |
| 56 | + std::cout << "Echo failed because: " | |
| 57 | + << "(" << e.what() << ")" << std::endl; | |
| 58 | + } | |
| 59 | +} | |
| 60 | + | |
| 61 | +int main() { | |
| 62 | + asio::io_service service; | |
| 63 | + | |
| 64 | + // Add a TCP echo server on port 9003 | |
| 65 | + tcp_echo_server custom_http_server(service, 9003); | |
| 66 | + | |
| 67 | + // Add a WebSocket echo server on port 9002 | |
| 68 | + ws_echo_server ws_server; | |
| 69 | + ws_server.set_access_channels(websocketpp::log::alevel::all); | |
| 70 | + ws_server.clear_access_channels(websocketpp::log::alevel::frame_payload); | |
| 71 | + | |
| 72 | + // The only difference in this code between an internal and external | |
| 73 | + // io_service is the different constructor to init_asio | |
| 74 | + ws_server.init_asio(&service); | |
| 75 | + | |
| 76 | + // Register our message handler | |
| 77 | + ws_server.set_message_handler(bind(&on_message,&ws_server,::_1,::_2)); | |
| 78 | + ws_server.listen(9002); | |
| 79 | + ws_server.start_accept(); | |
| 80 | + | |
| 81 | + // TODO: add a timer? | |
| 82 | + | |
| 83 | + // Start the Asio io_service run loop for all | |
| 84 | + service.run(); | |
| 85 | +} | |
| 0 | 86 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/examples/external_io_service/tcp_echo_server.hpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2015, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + */ | |
| 26 | + | |
| 27 | +/** | |
| 28 | + * TCP Echo Server | |
| 29 | + * | |
| 30 | + * This file defines a simple TCP Echo Server. It is adapted from the Asio | |
| 31 | + * example: cpp03/echo/async_tcp_echo_server.cpp | |
| 32 | + */ | |
| 33 | + | |
| 34 | +#include <websocketpp/common/asio.hpp> | |
| 35 | +#include <websocketpp/common/memory.hpp> | |
| 36 | +#include <websocketpp/common/functional.hpp> | |
| 37 | + | |
| 38 | +using websocketpp::lib::placeholders::_1; | |
| 39 | +using websocketpp::lib::placeholders::_2; | |
| 40 | +using websocketpp::lib::bind; | |
| 41 | + | |
| 42 | +namespace asio = websocketpp::lib::asio; | |
| 43 | + | |
| 44 | +struct tcp_echo_session : websocketpp::lib::enable_shared_from_this<tcp_echo_session> { | |
| 45 | + typedef websocketpp::lib::shared_ptr<tcp_echo_session> ptr; | |
| 46 | + | |
| 47 | + tcp_echo_session(asio::io_service & service) : m_socket(service) {} | |
| 48 | + | |
| 49 | + void start() { | |
| 50 | + m_socket.async_read_some(asio::buffer(m_buffer, sizeof(m_buffer)), | |
| 51 | + websocketpp::lib::bind( | |
| 52 | + &tcp_echo_session::handle_read, shared_from_this(), _1, _2)); | |
| 53 | + } | |
| 54 | + | |
| 55 | + void handle_read(const asio::error_code & ec, size_t transferred) { | |
| 56 | + if (!ec) { | |
| 57 | + asio::async_write(m_socket, | |
| 58 | + asio::buffer(m_buffer, transferred), | |
| 59 | + bind(&tcp_echo_session::handle_write, shared_from_this(), _1)); | |
| 60 | + } | |
| 61 | + } | |
| 62 | + | |
| 63 | + void handle_write(const asio::error_code & ec) { | |
| 64 | + if (!ec) { | |
| 65 | + m_socket.async_read_some(asio::buffer(m_buffer, sizeof(m_buffer)), | |
| 66 | + bind(&tcp_echo_session::handle_read, shared_from_this(), _1, _2)); | |
| 67 | + } | |
| 68 | + } | |
| 69 | + | |
| 70 | + asio::ip::tcp::socket m_socket; | |
| 71 | + char m_buffer[1024]; | |
| 72 | +}; | |
| 73 | + | |
| 74 | +struct tcp_echo_server { | |
| 75 | + tcp_echo_server(asio::io_service & service, short port) | |
| 76 | + : m_service(service) | |
| 77 | + , m_acceptor(service, asio::ip::tcp::endpoint(asio::ip::tcp::v6(), port)) | |
| 78 | + { | |
| 79 | + this->start_accept(); | |
| 80 | + } | |
| 81 | + | |
| 82 | + void start_accept() { | |
| 83 | + tcp_echo_session::ptr new_session(new tcp_echo_session(m_service)); | |
| 84 | + m_acceptor.async_accept(new_session->m_socket, | |
| 85 | + bind(&tcp_echo_server::handle_accept, this, new_session, _1)); | |
| 86 | + } | |
| 87 | + | |
| 88 | + void handle_accept(tcp_echo_session::ptr new_session, const asio::error_code & ec) { | |
| 89 | + if (!ec) { | |
| 90 | + new_session->start(); | |
| 91 | + } | |
| 92 | + start_accept(); | |
| 93 | + } | |
| 94 | + | |
| 95 | + asio::io_service & m_service; | |
| 96 | + asio::ip::tcp::acceptor m_acceptor; | |
| 97 | +}; | ... | ... |
3rdparty/websocketpp-0.8.2/examples/handler_switch/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (handler_switch) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/handler_switch/handler_switch.cpp
0 → 100644
| 1 | +#include <iostream> | |
| 2 | + | |
| 3 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 4 | +#include <websocketpp/server.hpp> | |
| 5 | + | |
| 6 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 7 | + | |
| 8 | +using websocketpp::connection_hdl; | |
| 9 | +using websocketpp::lib::placeholders::_1; | |
| 10 | +using websocketpp::lib::placeholders::_2; | |
| 11 | +using websocketpp::lib::bind; | |
| 12 | +using websocketpp::lib::ref; | |
| 13 | + | |
| 14 | +void custom_on_msg(server & s, connection_hdl hdl, server::message_ptr msg) { | |
| 15 | + std::cout << "Message sent to custom handler" << std::endl; | |
| 16 | +} | |
| 17 | + | |
| 18 | +void default_on_msg(server & s, connection_hdl hdl, server::message_ptr msg) { | |
| 19 | + std::cout << "Message sent to default handler" << std::endl; | |
| 20 | + | |
| 21 | + if (msg->get_payload() == "upgrade") { | |
| 22 | + // Upgrade our connection_hdl to a full connection_ptr | |
| 23 | + server::connection_ptr con = s.get_con_from_hdl(hdl); | |
| 24 | + | |
| 25 | + // Change the on message handler for this connection only to | |
| 26 | + // custom_on_mesage | |
| 27 | + con->set_message_handler(bind(&custom_on_msg,ref(s),::_1,::_2)); | |
| 28 | + std::cout << "Upgrading connection to custom handler" << std::endl; | |
| 29 | + } | |
| 30 | +} | |
| 31 | + | |
| 32 | +int main() { | |
| 33 | + server s; | |
| 34 | + | |
| 35 | + s.set_message_handler(bind(&default_on_msg,ref(s),::_1,::_2)); | |
| 36 | + | |
| 37 | + s.init_asio(); | |
| 38 | + s.listen(9002); | |
| 39 | + s.start_accept(); | |
| 40 | + | |
| 41 | + s.run(); | |
| 42 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/iostream_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (iostream_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/iostream_server/SConscript
0 → 100644
| 1 | +## iostream server example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('iostream_server', ["iostream_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('iostream_server', ["iostream_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/iostream_server/iostream_server.cpp
0 → 100644
| 1 | +#include <websocketpp/config/core.hpp> | |
| 2 | + | |
| 3 | +#include <websocketpp/server.hpp> | |
| 4 | + | |
| 5 | +#include <iostream> | |
| 6 | +#include <fstream> | |
| 7 | + | |
| 8 | +typedef websocketpp::server<websocketpp::config::core> server; | |
| 9 | + | |
| 10 | +using websocketpp::lib::placeholders::_1; | |
| 11 | +using websocketpp::lib::placeholders::_2; | |
| 12 | +using websocketpp::lib::bind; | |
| 13 | + | |
| 14 | +// pull out the type of messages sent by our config | |
| 15 | +typedef server::message_ptr message_ptr; | |
| 16 | + | |
| 17 | +// Define a callback to handle incoming messages | |
| 18 | +void on_message(server* s, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 19 | + if (msg->get_opcode() == websocketpp::frame::opcode::text) { | |
| 20 | + s->get_alog().write(websocketpp::log::alevel::app, | |
| 21 | + "Text Message Received: "+msg->get_payload()); | |
| 22 | + } else { | |
| 23 | + s->get_alog().write(websocketpp::log::alevel::app, | |
| 24 | + "Binary Message Received: "+websocketpp::utility::to_hex(msg->get_payload())); | |
| 25 | + } | |
| 26 | + | |
| 27 | + try { | |
| 28 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 29 | + } catch (websocketpp::exception const & e) { | |
| 30 | + s->get_alog().write(websocketpp::log::alevel::app, | |
| 31 | + std::string("Echo Failed: ")+e.what()); | |
| 32 | + } | |
| 33 | +} | |
| 34 | + | |
| 35 | +int main() { | |
| 36 | + server s; | |
| 37 | + std::ofstream log; | |
| 38 | + | |
| 39 | + try { | |
| 40 | + // set up access channels to only log interesting things | |
| 41 | + s.clear_access_channels(websocketpp::log::alevel::all); | |
| 42 | + s.set_access_channels(websocketpp::log::alevel::connect); | |
| 43 | + s.set_access_channels(websocketpp::log::alevel::disconnect); | |
| 44 | + s.set_access_channels(websocketpp::log::alevel::app); | |
| 45 | + | |
| 46 | + // Log to a file rather than stdout, as we are using stdout for real | |
| 47 | + // output | |
| 48 | + log.open("output.log"); | |
| 49 | + s.get_alog().set_ostream(&log); | |
| 50 | + s.get_elog().set_ostream(&log); | |
| 51 | + | |
| 52 | + // print all output to stdout | |
| 53 | + s.register_ostream(&std::cout); | |
| 54 | + | |
| 55 | + // Register our message handler | |
| 56 | + s.set_message_handler(bind(&on_message,&s,::_1,::_2)); | |
| 57 | + | |
| 58 | + server::connection_ptr con = s.get_connection(); | |
| 59 | + | |
| 60 | + con->start(); | |
| 61 | + | |
| 62 | + // C++ iostream's don't support the idea of asynchronous i/o. As such | |
| 63 | + // there are two input strategies demonstrated here. Buffered I/O will | |
| 64 | + // read from stdin in chunks until EOF. This works very well for | |
| 65 | + // replaying canned connections as would be done in automated testing. | |
| 66 | + // | |
| 67 | + // If the server is being used live however, assuming input is being | |
| 68 | + // piped from elsewhere in realtime, this strategy will result in small | |
| 69 | + // messages being buffered forever. The non-buffered strategy below | |
| 70 | + // reads characters from stdin one at a time. This is inefficient and | |
| 71 | + // for more serious uses should be replaced with a platform specific | |
| 72 | + // asyncronous i/o technique like select, poll, IOCP, etc | |
| 73 | + bool buffered_io = false; | |
| 74 | + | |
| 75 | + if (buffered_io) { | |
| 76 | + std::cin >> *con; | |
| 77 | + con->eof(); | |
| 78 | + } else { | |
| 79 | + char a; | |
| 80 | + while(std::cin.get(a)) { | |
| 81 | + con->read_some(&a,1); | |
| 82 | + } | |
| 83 | + con->eof(); | |
| 84 | + } | |
| 85 | + } catch (websocketpp::exception const & e) { | |
| 86 | + std::cout << e.what() << std::endl; | |
| 87 | + } | |
| 88 | + log.close(); | |
| 89 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_client/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (print_client) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_client/SConscript
0 → 100644
| 1 | +## Print client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('print_client', ["print_client.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('print_client', ["print_client.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_client/print_client.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2016, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + * | |
| 26 | + */ | |
| 27 | + | |
| 28 | +#include <websocketpp/config/asio_no_tls_client.hpp> | |
| 29 | +#include <websocketpp/client.hpp> | |
| 30 | + | |
| 31 | +#include <iostream> | |
| 32 | + | |
| 33 | +typedef websocketpp::client<websocketpp::config::asio_client> client; | |
| 34 | + | |
| 35 | +void on_message(websocketpp::connection_hdl, client::message_ptr msg) { | |
| 36 | + std::cout << msg->get_payload() << std::endl; | |
| 37 | +} | |
| 38 | + | |
| 39 | +int main(int argc, char* argv[]) { | |
| 40 | + client c; | |
| 41 | + | |
| 42 | + std::string uri = "ws://localhost:9002"; | |
| 43 | + | |
| 44 | + if (argc == 2) { | |
| 45 | + uri = argv[1]; | |
| 46 | + } | |
| 47 | + | |
| 48 | + try { | |
| 49 | + // Set logging to be pretty verbose (everything except message payloads) | |
| 50 | + c.set_access_channels(websocketpp::log::alevel::all); | |
| 51 | + c.clear_access_channels(websocketpp::log::alevel::frame_payload); | |
| 52 | + c.set_error_channels(websocketpp::log::elevel::all); | |
| 53 | + | |
| 54 | + // Initialize ASIO | |
| 55 | + c.init_asio(); | |
| 56 | + | |
| 57 | + // Register our message handler | |
| 58 | + c.set_message_handler(&on_message); | |
| 59 | + | |
| 60 | + websocketpp::lib::error_code ec; | |
| 61 | + client::connection_ptr con = c.get_connection(uri, ec); | |
| 62 | + if (ec) { | |
| 63 | + std::cout << "could not create connection because: " << ec.message() << std::endl; | |
| 64 | + return 0; | |
| 65 | + } | |
| 66 | + | |
| 67 | + // Note that connect here only requests a connection. No network messages are | |
| 68 | + // exchanged until the event loop starts running in the next line. | |
| 69 | + c.connect(con); | |
| 70 | + | |
| 71 | + // Start the ASIO io_service run loop | |
| 72 | + // this will cause a single connection to be made to the server. c.run() | |
| 73 | + // will exit when this connection is closed. | |
| 74 | + c.run(); | |
| 75 | + } catch (websocketpp::exception const & e) { | |
| 76 | + std::cout << e.what() << std::endl; | |
| 77 | + } | |
| 78 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_client_tls/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +if (OPENSSL_FOUND) | |
| 6 | + | |
| 7 | +init_target (print_client_tls) | |
| 8 | + | |
| 9 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 10 | + | |
| 11 | +link_boost () | |
| 12 | +link_openssl() | |
| 13 | +final_target () | |
| 14 | + | |
| 15 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | |
| 16 | + | |
| 17 | +endif() | |
| 0 | 18 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_client_tls/SConscript
0 → 100644
| 1 | +## Print client tls example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | +Import('tls_libs') | |
| 10 | + | |
| 11 | +env = env.Clone () | |
| 12 | +env_cpp11 = env_cpp11.Clone () | |
| 13 | + | |
| 14 | +prgs = [] | |
| 15 | + | |
| 16 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 17 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 18 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 19 | + prgs += env_cpp11.Program('print_client_tls', ["print_client_tls.cpp"], LIBS = ALL_LIBS) | |
| 20 | +else: | |
| 21 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 22 | + prgs += env.Program('print_client_tls', ["print_client_tls.cpp"], LIBS = ALL_LIBS) | |
| 23 | + | |
| 24 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_client_tls/ca-chain.cert.pem
0 → 100644
| 1 | +-----BEGIN CERTIFICATE----- | |
| 2 | +MIIFxTCCA62gAwIBAgICEAAwDQYJKoZIhvcNAQELBQAwYDELMAkGA1UEBhMCVVMx | |
| 3 | +CzAJBgNVBAgMAklMMRAwDgYDVQQHDAdDaGljYWdvMRQwEgYDVQQKDAtXZWJTb2Nr | |
| 4 | +ZXQrKzEcMBoGA1UEAwwTV2ViU29ja2V0KysgUm9vdCBDQTAeFw0xNjA1MjUxMzU4 | |
| 5 | +MjdaFw0yNjA1MjMxMzU4MjdaMIGCMQswCQYDVQQGEwJVUzELMAkGA1UECAwCSUwx | |
| 6 | +FDASBgNVBAoMC1dlYlNvY2tldCsrMSowKAYDVQQLDCFXZWJTb2NrZXQrKyBDZXJ0 | |
| 7 | +aWZpY2F0ZSBBdXRob3JpdHkxJDAiBgNVBAMMG1dlYlNvY2tldCsrIEludGVybWVk | |
| 8 | +aWF0ZSBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMNaFAzlx0KJ | |
| 9 | +gG15yRHI3xn9+B1woHG4uuOr124Sk1JllPcO3enusgIYTMl0FiYYW9CsyPoe4L0P | |
| 10 | +wflbz20vDDjxmXG+NPgjuYmnPaq7q2JXYz+cShv9+o60EIwEIe+EWk1ZQs9YSdQ0 | |
| 11 | +r4UOxGVq6eEuWJi8Wh02cbnxdjwvrk7lTMFVY+z5EX8cCj6Tbrd0lyIf/0X8OkOb | |
| 12 | +q2HOqqzTgT2apBCWCEW6grW6rtMOoDx93BOZDBEGz39sJ5i8AQ8XIdYCdUcOMdJU | |
| 13 | +SCAw/MMyFTHXhv8hJdG5GcDSfc7woB9xRUf8UHuCH0nYkTb260TWvyDCYJy001ko | |
| 14 | +SWoRbh2hVgPqQ9FTDMzMTY8T8C5u3BRfGN5PHuSPhwfHv/p1g4uPnltDBe4CNtOs | |
| 15 | +wu8w1wbrr3uI7qETnqOzbXlcT7o4rCrrRQqLbNOssf2mMH+Phq6dINjXpZjiAhO0 | |
| 16 | +SURtBMmQdAZcQkGStzFitEkb2Py5LEIxQ068i8RCowTyD9+/jbO1fZyxJ4X8TDUe | |
| 17 | +Xx48xWnu0i4f8/9ldnWLwX9h3ilaZVsr7buNYJoMlz+v73TQoWKSybJ2SMe/Cddj | |
| 18 | +OZCy5r1UakuZhX6n1ScD/hbO8FEfmQRpAywYajyU4dZ9XMbf5bo6OAUqlJ2f4yYh | |
| 19 | +VAy5mi1JHfD5PiJN90j79GXXvtBTJc4hAgMBAAGjZjBkMB0GA1UdDgQWBBTKMn5O | |
| 20 | +3NUPpztL1bAz8UCsOBLpkjAfBgNVHSMEGDAWgBTNBBKZQN694xplMGyMruXFv27o | |
| 21 | +eTASBgNVHRMBAf8ECDAGAQH/AgEAMA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0B | |
| 22 | +AQsFAAOCAgEAyNkZUEAdP73th4/RLu0d2foMiIqKlcvw3JsW0tto3MT5lvQ5UugH | |
| 23 | +OwluhWhnMLE0KsknQd7/p4ZwyZugWAYjGcDydp0GDIDfNBBEOQkOAL23KkYiRFqt | |
| 24 | +VPBTZi9S7P2MJLY0j94liIg94nikhz/0q7JxxWFlvSHUjwZxXrbFjfZRPOS1vIq/ | |
| 25 | +/VK2QjUsdIXE3NOPYfQwd9FpG2YS8ZcMeipwNYVAs2FBEeWzGH1j6i2hP8FFBDYP | |
| 26 | +0LTvJYOJvlCeyIvPBjKk9461/Z4CPJcKtKC59onQmiqSK/Juak/bpPoY7jJ228KG | |
| 27 | +bEBzClIEHgbDiBewFTHbyOWhW2ySRLOGsPeqKDSbm4J1N5rfKnrSQB9PfOmWoRfJ | |
| 28 | +vqPlXFSlpdgD4j/WnEumpvt78fT+cn+AkRG8tE5DQrCWZTK47TSWn902Fm0A19Rl | |
| 29 | +pSbE9qsulXurOqEuOOayrzcUmbZ/jkU+wj+/tN4Gl8K98WbjcXvwz0sRL3SgRRrI | |
| 30 | +awUdaGWKQHrTJNEOTisepUAuHVDmvuQz0j/Ru+PbB9K3GcKY6X6+o1c2JBC1V6KX | |
| 31 | +aHHZQ+xPm+VEa1pG/QVHGpt2AbGUQlXwDYtOIRwEhO27tFbH8Q68s2cMLYjsF5gd | |
| 32 | +MWuMYCPkFv10/V2f2lAIPSEzw2pldIGERcb4VG4xuD0qU+HH/aAID7k= | |
| 33 | +-----END CERTIFICATE----- | |
| 34 | +-----BEGIN CERTIFICATE----- | |
| 35 | +MIIFpjCCA46gAwIBAgIJAL42eqbfw976MA0GCSqGSIb3DQEBCwUAMGAxCzAJBgNV | |
| 36 | +BAYTAlVTMQswCQYDVQQIDAJJTDEQMA4GA1UEBwwHQ2hpY2FnbzEUMBIGA1UECgwL | |
| 37 | +V2ViU29ja2V0KysxHDAaBgNVBAMME1dlYlNvY2tldCsrIFJvb3QgQ0EwHhcNMTYw | |
| 38 | +NTI1MTM1MTUzWhcNMzYwNTIwMTM1MTUzWjBgMQswCQYDVQQGEwJVUzELMAkGA1UE | |
| 39 | +CAwCSUwxEDAOBgNVBAcMB0NoaWNhZ28xFDASBgNVBAoMC1dlYlNvY2tldCsrMRww | |
| 40 | +GgYDVQQDDBNXZWJTb2NrZXQrKyBSb290IENBMIICIjANBgkqhkiG9w0BAQEFAAOC | |
| 41 | +Ag8AMIICCgKCAgEA4QjJ0v5yri+pAN67I/XPz88D8oIczCW96CIuwc44aDC9Kptb | |
| 42 | +9iY8xwbGCyQsFZ/1IQ74QfnXZSwq8EwedcBIdcyHdBu6qtNkCVKeDIZAMBef6Hx+ | |
| 43 | +tWSe1op3sDbUlT8NHiTxZCZWk/2/yIi8yPzQTi4y1vF04vvrQS5RFomCz17kdyOa | |
| 44 | +NdxO5p+I4afdoVKtzA1aHoBqdTe7vzM3eww4AxKfgIEDdIuOGDiglI/b/frlwiOi | |
| 45 | +SfTOsPzu52TOPW2d1Ad5BG4GuMpnTUOVnc8j18w9LdeXO0J10oVyCmwiPuzFCcDB | |
| 46 | +g1xvVr5TXzIZ5J+qlso7+mUfZGH+nxOT7Tc78o1EvX6JbfQAI2PrpcksmJfFnN4l | |
| 47 | +4XnXDW/eKl8AlLUr/cW5axAfql4QHJoBCZcfYldQpMoL5R1ikLtY53cOJpycFoWm | |
| 48 | +1IEfkLBZ4C1old+KoaErG0+Aur8/kwAJGMnmMvZqGZ5pgXtVipOLy5TKuS6ZKO8g | |
| 49 | +MRzalaF/naiu3pF+/sctaqkAPvOr65WrANNGxTQ93ePdyuT6sOEUKXxaXcTtAOOM | |
| 50 | +5FCgX8dPxkOACxTrxppvb+bYmYL9GIuYDGYxSRu3Fm+04eXIh+uCqcuWPQuRPc5t | |
| 51 | +VXvk/M0fPaJvKfP6lRAoE5Dp4qPRvL6tRVtOXfP6d+O+yGnxRoLKAW7ejoMCAwEA | |
| 52 | +AaNjMGEwHQYDVR0OBBYEFM0EEplA3r3jGmUwbIyu5cW/buh5MB8GA1UdIwQYMBaA | |
| 53 | +FM0EEplA3r3jGmUwbIyu5cW/buh5MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/ | |
| 54 | +BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQAQ4eY4LhW795wl9XuDVg2vOFTYmIS0 | |
| 55 | +OxrunFX4f3RjddbIbXzYmQ0cJ8pJ5l7eGYcg/DYQRY4Tk6LjXMs9VhIU10akqLS4 | |
| 56 | +qGE+Bmp3Jhu5NxZbKkY+k+kTAA1LYxFCjGjSV0v5QNLFULDAmGer2zWwU5DcDwwq | |
| 57 | +8yWyBuI974UyE/49/TeckfqwBrb90LL2lFEwoL86XZK2IZMPyMBC/S1X5P/Kc15Q | |
| 58 | +d8lwOPS5AirFkkrzs/px+mRia5U1uWKIPRLq9Medvjf8HR8SFWq9eRtkxiLaWyRv | |
| 59 | +HBVyVRKCubCZR8psVLK/zrF+Bc+Hr9aAi3TuqTKjIOI7hrq5oJcJpebZDNoBIqoj | |
| 60 | +kab13WcRwG+BQvuK1CEkd1aq8Nh2GX6Reb2Zv82/WntgP1a0sztbIGgrUBYQryb5 | |
| 61 | +HF79v4e2byY613SiQ3lz+g/AWxaZsYH80/Zl+hEwEtU4fFz34Jcv9Kvda1JpknBT | |
| 62 | +Fi63ugfoNeNriO02AReMmDvuBG3X8RF1UQyBoTU3uZuW7X26MizEjiVCK9qaOLED | |
| 63 | +WDSEoyKLe4JKd387CVlsCY8K/6fBlFTI/hJhggDz8pZFj3n2irUI44kjgOmoxOrW | |
| 64 | +JY2jgY89AEMN9yOKkyQGara8pF9IJxTQ7jurYnWcUbompWeybJRwvWN0h+tGV+bd | |
| 65 | +l/aq/5LwL3fVpg== | |
| 66 | +-----END CERTIFICATE----- | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_client_tls/print_client_tls.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2016, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + * | |
| 26 | + */ | |
| 27 | + | |
| 28 | +#include <websocketpp/config/asio_client.hpp> | |
| 29 | +#include <websocketpp/client.hpp> | |
| 30 | + | |
| 31 | +#include <iostream> | |
| 32 | + | |
| 33 | +typedef websocketpp::client<websocketpp::config::asio_tls_client> client; | |
| 34 | +typedef websocketpp::lib::shared_ptr<websocketpp::lib::asio::ssl::context> context_ptr; | |
| 35 | + | |
| 36 | +using websocketpp::lib::placeholders::_1; | |
| 37 | +using websocketpp::lib::placeholders::_2; | |
| 38 | +using websocketpp::lib::bind; | |
| 39 | + | |
| 40 | +void on_message(websocketpp::connection_hdl, client::message_ptr msg) { | |
| 41 | + std::cout << msg->get_payload() << std::endl; | |
| 42 | +} | |
| 43 | + | |
| 44 | +/// Verify that one of the subject alternative names matches the given hostname | |
| 45 | +bool verify_subject_alternative_name(const char * hostname, X509 * cert) { | |
| 46 | + STACK_OF(GENERAL_NAME) * san_names = NULL; | |
| 47 | + | |
| 48 | + san_names = (STACK_OF(GENERAL_NAME) *) X509_get_ext_d2i(cert, NID_subject_alt_name, NULL, NULL); | |
| 49 | + if (san_names == NULL) { | |
| 50 | + return false; | |
| 51 | + } | |
| 52 | + | |
| 53 | + int san_names_count = sk_GENERAL_NAME_num(san_names); | |
| 54 | + | |
| 55 | + bool result = false; | |
| 56 | + | |
| 57 | + for (int i = 0; i < san_names_count; i++) { | |
| 58 | + const GENERAL_NAME * current_name = sk_GENERAL_NAME_value(san_names, i); | |
| 59 | + | |
| 60 | + if (current_name->type != GEN_DNS) { | |
| 61 | + continue; | |
| 62 | + } | |
| 63 | + | |
| 64 | + char const * dns_name = (char const *) ASN1_STRING_get0_data(current_name->d.dNSName); | |
| 65 | + | |
| 66 | + // Make sure there isn't an embedded NUL character in the DNS name | |
| 67 | + if (ASN1_STRING_length(current_name->d.dNSName) != strlen(dns_name)) { | |
| 68 | + break; | |
| 69 | + } | |
| 70 | + // Compare expected hostname with the CN | |
| 71 | + result = (strcasecmp(hostname, dns_name) == 0); | |
| 72 | + } | |
| 73 | + sk_GENERAL_NAME_pop_free(san_names, GENERAL_NAME_free); | |
| 74 | + | |
| 75 | + return result; | |
| 76 | +} | |
| 77 | + | |
| 78 | +/// Verify that the certificate common name matches the given hostname | |
| 79 | +bool verify_common_name(char const * hostname, X509 * cert) { | |
| 80 | + // Find the position of the CN field in the Subject field of the certificate | |
| 81 | + int common_name_loc = X509_NAME_get_index_by_NID(X509_get_subject_name(cert), NID_commonName, -1); | |
| 82 | + if (common_name_loc < 0) { | |
| 83 | + return false; | |
| 84 | + } | |
| 85 | + | |
| 86 | + // Extract the CN field | |
| 87 | + X509_NAME_ENTRY * common_name_entry = X509_NAME_get_entry(X509_get_subject_name(cert), common_name_loc); | |
| 88 | + if (common_name_entry == NULL) { | |
| 89 | + return false; | |
| 90 | + } | |
| 91 | + | |
| 92 | + // Convert the CN field to a C string | |
| 93 | + ASN1_STRING * common_name_asn1 = X509_NAME_ENTRY_get_data(common_name_entry); | |
| 94 | + if (common_name_asn1 == NULL) { | |
| 95 | + return false; | |
| 96 | + } | |
| 97 | + | |
| 98 | + char const * common_name_str = (char const *) ASN1_STRING_get0_data(common_name_asn1); | |
| 99 | + | |
| 100 | + // Make sure there isn't an embedded NUL character in the CN | |
| 101 | + if (ASN1_STRING_length(common_name_asn1) != strlen(common_name_str)) { | |
| 102 | + return false; | |
| 103 | + } | |
| 104 | + | |
| 105 | + // Compare expected hostname with the CN | |
| 106 | + return (strcasecmp(hostname, common_name_str) == 0); | |
| 107 | +} | |
| 108 | + | |
| 109 | +/** | |
| 110 | + * This code is derived from examples and documentation found ato00po | |
| 111 | + * http://www.boost.org/doc/libs/1_61_0/doc/html/boost_asio/example/cpp03/ssl/client.cpp | |
| 112 | + * and | |
| 113 | + * https://github.com/iSECPartners/ssl-conservatory | |
| 114 | + */ | |
| 115 | +bool verify_certificate(const char * hostname, bool preverified, boost::asio::ssl::verify_context& ctx) { | |
| 116 | + // The verify callback can be used to check whether the certificate that is | |
| 117 | + // being presented is valid for the peer. For example, RFC 2818 describes | |
| 118 | + // the steps involved in doing this for HTTPS. Consult the OpenSSL | |
| 119 | + // documentation for more details. Note that the callback is called once | |
| 120 | + // for each certificate in the certificate chain, starting from the root | |
| 121 | + // certificate authority. | |
| 122 | + | |
| 123 | + // Retrieve the depth of the current cert in the chain. 0 indicates the | |
| 124 | + // actual server cert, upon which we will perform extra validation | |
| 125 | + // (specifically, ensuring that the hostname matches. For other certs we | |
| 126 | + // will use the 'preverified' flag from Asio, which incorporates a number of | |
| 127 | + // non-implementation specific OpenSSL checking, such as the formatting of | |
| 128 | + // certs and the trusted status based on the CA certs we imported earlier. | |
| 129 | + int depth = X509_STORE_CTX_get_error_depth(ctx.native_handle()); | |
| 130 | + | |
| 131 | + // if we are on the final cert and everything else checks out, ensure that | |
| 132 | + // the hostname is present on the list of SANs or the common name (CN). | |
| 133 | + if (depth == 0 && preverified) { | |
| 134 | + X509* cert = X509_STORE_CTX_get_current_cert(ctx.native_handle()); | |
| 135 | + | |
| 136 | + if (verify_subject_alternative_name(hostname, cert)) { | |
| 137 | + return true; | |
| 138 | + } else if (verify_common_name(hostname, cert)) { | |
| 139 | + return true; | |
| 140 | + } else { | |
| 141 | + return false; | |
| 142 | + } | |
| 143 | + } | |
| 144 | + | |
| 145 | + return preverified; | |
| 146 | +} | |
| 147 | + | |
| 148 | +/// TLS Initialization handler | |
| 149 | +/** | |
| 150 | + * WebSocket++ core and the Asio Transport do not handle TLS context creation | |
| 151 | + * and setup. This callback is provided so that the end user can set up their | |
| 152 | + * TLS context using whatever settings make sense for their application. | |
| 153 | + * | |
| 154 | + * As Asio and OpenSSL do not provide great documentation for the very common | |
| 155 | + * case of connect and actually perform basic verification of server certs this | |
| 156 | + * example includes a basic implementation (using Asio and OpenSSL) of the | |
| 157 | + * following reasonable default settings and verification steps: | |
| 158 | + * | |
| 159 | + * - Disable SSLv2 and SSLv3 | |
| 160 | + * - Load trusted CA certificates and verify the server cert is trusted. | |
| 161 | + * - Verify that the hostname matches either the common name or one of the | |
| 162 | + * subject alternative names on the certificate. | |
| 163 | + * | |
| 164 | + * This is not meant to be an exhaustive reference implimentation of a perfect | |
| 165 | + * TLS client, but rather a reasonable starting point for building a secure | |
| 166 | + * TLS encrypted WebSocket client. | |
| 167 | + * | |
| 168 | + * If any TLS, Asio, or OpenSSL experts feel that these settings are poor | |
| 169 | + * defaults or there are critically missing steps please open a GitHub issue | |
| 170 | + * or drop a line on the project mailing list. | |
| 171 | + * | |
| 172 | + * Note the bundled CA cert ca-chain.cert.pem is the CA cert that signed the | |
| 173 | + * cert bundled with echo_server_tls. You can use print_client_tls with this | |
| 174 | + * CA cert to connect to echo_server_tls as long as you use /etc/hosts or | |
| 175 | + * something equivilent to spoof one of the names on that cert | |
| 176 | + * (websocketpp.org, for example). | |
| 177 | + */ | |
| 178 | +context_ptr on_tls_init(const char * hostname, websocketpp::connection_hdl) { | |
| 179 | + context_ptr ctx = websocketpp::lib::make_shared<boost::asio::ssl::context>(boost::asio::ssl::context::sslv23); | |
| 180 | + | |
| 181 | + try { | |
| 182 | + ctx->set_options(boost::asio::ssl::context::default_workarounds | | |
| 183 | + boost::asio::ssl::context::no_sslv2 | | |
| 184 | + boost::asio::ssl::context::no_sslv3 | | |
| 185 | + boost::asio::ssl::context::single_dh_use); | |
| 186 | + | |
| 187 | + | |
| 188 | + ctx->set_verify_mode(boost::asio::ssl::verify_peer); | |
| 189 | + ctx->set_verify_callback(bind(&verify_certificate, hostname, ::_1, ::_2)); | |
| 190 | + | |
| 191 | + // Here we load the CA certificates of all CA's that this client trusts. | |
| 192 | + ctx->load_verify_file("ca-chain.cert.pem"); | |
| 193 | + } catch (std::exception& e) { | |
| 194 | + std::cout << e.what() << std::endl; | |
| 195 | + } | |
| 196 | + return ctx; | |
| 197 | +} | |
| 198 | + | |
| 199 | +int main(int argc, char* argv[]) { | |
| 200 | + client c; | |
| 201 | + | |
| 202 | + std::string hostname = "localhost"; | |
| 203 | + std::string port = "9002"; | |
| 204 | + | |
| 205 | + | |
| 206 | + if (argc == 3) { | |
| 207 | + hostname = argv[1]; | |
| 208 | + port = argv[2]; | |
| 209 | + } else { | |
| 210 | + std::cout << "Usage: print_server_tls <hostname> <port>" << std::endl; | |
| 211 | + return 1; | |
| 212 | + } | |
| 213 | + | |
| 214 | + std::string uri = "wss://" + hostname + ":" + port; | |
| 215 | + | |
| 216 | + try { | |
| 217 | + // Set logging to be pretty verbose (everything except message payloads) | |
| 218 | + c.set_access_channels(websocketpp::log::alevel::all); | |
| 219 | + c.clear_access_channels(websocketpp::log::alevel::frame_payload); | |
| 220 | + c.set_error_channels(websocketpp::log::elevel::all); | |
| 221 | + | |
| 222 | + // Initialize ASIO | |
| 223 | + c.init_asio(); | |
| 224 | + | |
| 225 | + // Register our message handler | |
| 226 | + c.set_message_handler(&on_message); | |
| 227 | + c.set_tls_init_handler(bind(&on_tls_init, hostname.c_str(), ::_1)); | |
| 228 | + | |
| 229 | + websocketpp::lib::error_code ec; | |
| 230 | + client::connection_ptr con = c.get_connection(uri, ec); | |
| 231 | + if (ec) { | |
| 232 | + std::cout << "could not create connection because: " << ec.message() << std::endl; | |
| 233 | + return 0; | |
| 234 | + } | |
| 235 | + | |
| 236 | + // Note that connect here only requests a connection. No network messages are | |
| 237 | + // exchanged until the event loop starts running in the next line. | |
| 238 | + c.connect(con); | |
| 239 | + | |
| 240 | + c.get_alog().write(websocketpp::log::alevel::app, "Connecting to " + uri); | |
| 241 | + | |
| 242 | + // Start the ASIO io_service run loop | |
| 243 | + // this will cause a single connection to be made to the server. c.run() | |
| 244 | + // will exit when this connection is closed. | |
| 245 | + c.run(); | |
| 246 | + } catch (websocketpp::exception const & e) { | |
| 247 | + std::cout << e.what() << std::endl; | |
| 248 | + } | |
| 249 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (print_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_server/SConscript
0 → 100644
| 1 | +## Print server example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('print_server', ["print_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('print_server', ["print_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/print_server/print_server.cpp
0 → 100644
| 1 | +#include <iostream> | |
| 2 | + | |
| 3 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 4 | +#include <websocketpp/server.hpp> | |
| 5 | + | |
| 6 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 7 | + | |
| 8 | +void on_message(websocketpp::connection_hdl, server::message_ptr msg) { | |
| 9 | + std::cout << msg->get_payload() << std::endl; | |
| 10 | +} | |
| 11 | + | |
| 12 | +int main() { | |
| 13 | + server print_server; | |
| 14 | + | |
| 15 | + print_server.set_message_handler(&on_message); | |
| 16 | + print_server.set_access_channels(websocketpp::log::alevel::all); | |
| 17 | + print_server.set_error_channels(websocketpp::log::elevel::all); | |
| 18 | + | |
| 19 | + print_server.init_asio(); | |
| 20 | + print_server.listen(9002); | |
| 21 | + print_server.start_accept(); | |
| 22 | + | |
| 23 | + print_server.run(); | |
| 24 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/scratch_client/SConscript
0 → 100644
| 1 | +## Scratch client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | +Import('tls_libs') | |
| 10 | + | |
| 11 | +env = env.Clone () | |
| 12 | +env_cpp11 = env_cpp11.Clone () | |
| 13 | + | |
| 14 | +prgs = [] | |
| 15 | + | |
| 16 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 17 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 18 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + [tls_libs] | |
| 19 | + prgs += env_cpp11.Program('scratch_client', ["scratch_client.cpp"], LIBS = ALL_LIBS) | |
| 20 | +else: | |
| 21 | + ALL_LIBS = boostlibs(['system','random'],env) + [platform_libs] + [polyfill_libs] | |
| 22 | + prgs += env.Program('utility_client', ["utility_client.cpp"], LIBS = ALL_LIBS) | |
| 23 | + | |
| 24 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/scratch_client/scratch_client.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2014, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + */ | |
| 26 | + | |
| 27 | +// **NOTE:** This file is a snapshot of the WebSocket++ utility client tutorial. | |
| 28 | +// Additional related material can be found in the tutorials/utility_client | |
| 29 | +// directory of the WebSocket++ repository. | |
| 30 | + | |
| 31 | +#include <websocketpp/config/asio_no_tls_client.hpp> | |
| 32 | +#include <websocketpp/client.hpp> | |
| 33 | + | |
| 34 | +#include <websocketpp/common/thread.hpp> | |
| 35 | +#include <websocketpp/common/memory.hpp> | |
| 36 | + | |
| 37 | +#include <cstdlib> | |
| 38 | +#include <iostream> | |
| 39 | +#include <map> | |
| 40 | +#include <string> | |
| 41 | +#include <sstream> | |
| 42 | + | |
| 43 | +typedef websocketpp::client<websocketpp::config::asio_client> client; | |
| 44 | + | |
| 45 | +class connection_metadata { | |
| 46 | +public: | |
| 47 | + typedef websocketpp::lib::shared_ptr<connection_metadata> ptr; | |
| 48 | + | |
| 49 | + connection_metadata(int id, websocketpp::connection_hdl hdl, std::string uri) | |
| 50 | + : m_id(id) | |
| 51 | + , m_hdl(hdl) | |
| 52 | + , m_status("Connecting") | |
| 53 | + , m_uri(uri) | |
| 54 | + , m_server("N/A") | |
| 55 | + {} | |
| 56 | + | |
| 57 | + void on_open(client * c, websocketpp::connection_hdl hdl) { | |
| 58 | + m_status = "Open"; | |
| 59 | + | |
| 60 | + client::connection_ptr con = c->get_con_from_hdl(hdl); | |
| 61 | + m_server = con->get_response_header("Server"); | |
| 62 | + } | |
| 63 | + | |
| 64 | + void on_fail(client * c, websocketpp::connection_hdl hdl) { | |
| 65 | + m_status = "Failed"; | |
| 66 | + | |
| 67 | + client::connection_ptr con = c->get_con_from_hdl(hdl); | |
| 68 | + m_server = con->get_response_header("Server"); | |
| 69 | + m_error_reason = con->get_ec().message(); | |
| 70 | + } | |
| 71 | + | |
| 72 | + void on_close(client * c, websocketpp::connection_hdl hdl) { | |
| 73 | + m_status = "Closed"; | |
| 74 | + client::connection_ptr con = c->get_con_from_hdl(hdl); | |
| 75 | + std::stringstream s; | |
| 76 | + s << "close code: " << con->get_remote_close_code() << " (" | |
| 77 | + << websocketpp::close::status::get_string(con->get_remote_close_code()) | |
| 78 | + << "), close reason: " << con->get_remote_close_reason(); | |
| 79 | + m_error_reason = s.str(); | |
| 80 | + } | |
| 81 | + | |
| 82 | + websocketpp::connection_hdl get_hdl() const { | |
| 83 | + return m_hdl; | |
| 84 | + } | |
| 85 | + | |
| 86 | + int get_id() const { | |
| 87 | + return m_id; | |
| 88 | + } | |
| 89 | + | |
| 90 | + std::string get_status() const { | |
| 91 | + return m_status; | |
| 92 | + } | |
| 93 | + | |
| 94 | + friend std::ostream & operator<< (std::ostream & out, connection_metadata const & data); | |
| 95 | +private: | |
| 96 | + int m_id; | |
| 97 | + websocketpp::connection_hdl m_hdl; | |
| 98 | + std::string m_status; | |
| 99 | + std::string m_uri; | |
| 100 | + std::string m_server; | |
| 101 | + std::string m_error_reason; | |
| 102 | +}; | |
| 103 | + | |
| 104 | +std::ostream & operator<< (std::ostream & out, connection_metadata const & data) { | |
| 105 | + out << "> URI: " << data.m_uri << "\n" | |
| 106 | + << "> Status: " << data.m_status << "\n" | |
| 107 | + << "> Remote Server: " << (data.m_server.empty() ? "None Specified" : data.m_server) << "\n" | |
| 108 | + << "> Error/close reason: " << (data.m_error_reason.empty() ? "N/A" : data.m_error_reason); | |
| 109 | + | |
| 110 | + return out; | |
| 111 | +} | |
| 112 | + | |
| 113 | +class websocket_endpoint { | |
| 114 | +public: | |
| 115 | + websocket_endpoint () : m_next_id(0) { | |
| 116 | + m_endpoint.clear_access_channels(websocketpp::log::alevel::all); | |
| 117 | + m_endpoint.clear_error_channels(websocketpp::log::elevel::all); | |
| 118 | + | |
| 119 | + m_endpoint.init_asio(); | |
| 120 | + m_endpoint.start_perpetual(); | |
| 121 | + | |
| 122 | + m_thread.reset(new websocketpp::lib::thread(&client::run, &m_endpoint)); | |
| 123 | + } | |
| 124 | + | |
| 125 | + ~websocket_endpoint() { | |
| 126 | + m_endpoint.stop_perpetual(); | |
| 127 | + | |
| 128 | + for (con_list::const_iterator it = m_connection_list.begin(); it != m_connection_list.end(); ++it) { | |
| 129 | + if (it->second->get_status() != "Open") { | |
| 130 | + // Only close open connections | |
| 131 | + continue; | |
| 132 | + } | |
| 133 | + | |
| 134 | + std::cout << "> Closing connection " << it->second->get_id() << std::endl; | |
| 135 | + | |
| 136 | + websocketpp::lib::error_code ec; | |
| 137 | + m_endpoint.close(it->second->get_hdl(), websocketpp::close::status::going_away, "", ec); | |
| 138 | + if (ec) { | |
| 139 | + std::cout << "> Error closing connection " << it->second->get_id() << ": " | |
| 140 | + << ec.message() << std::endl; | |
| 141 | + } | |
| 142 | + } | |
| 143 | + | |
| 144 | + m_thread->join(); | |
| 145 | + } | |
| 146 | + | |
| 147 | + int connect(std::string const & uri) { | |
| 148 | + websocketpp::lib::error_code ec; | |
| 149 | + | |
| 150 | + client::connection_ptr con = m_endpoint.get_connection(uri, ec); | |
| 151 | + | |
| 152 | + if (ec) { | |
| 153 | + std::cout << "> Connect initialization error: " << ec.message() << std::endl; | |
| 154 | + return -1; | |
| 155 | + } | |
| 156 | + | |
| 157 | + int new_id = m_next_id++; | |
| 158 | + connection_metadata::ptr metadata_ptr(new connection_metadata(new_id, con->get_handle(), uri)); | |
| 159 | + m_connection_list[new_id] = metadata_ptr; | |
| 160 | + | |
| 161 | + con->set_open_handler(websocketpp::lib::bind( | |
| 162 | + &connection_metadata::on_open, | |
| 163 | + metadata_ptr, | |
| 164 | + &m_endpoint, | |
| 165 | + websocketpp::lib::placeholders::_1 | |
| 166 | + )); | |
| 167 | + con->set_fail_handler(websocketpp::lib::bind( | |
| 168 | + &connection_metadata::on_fail, | |
| 169 | + metadata_ptr, | |
| 170 | + &m_endpoint, | |
| 171 | + websocketpp::lib::placeholders::_1 | |
| 172 | + )); | |
| 173 | + con->set_close_handler(websocketpp::lib::bind( | |
| 174 | + &connection_metadata::on_close, | |
| 175 | + metadata_ptr, | |
| 176 | + &m_endpoint, | |
| 177 | + websocketpp::lib::placeholders::_1 | |
| 178 | + )); | |
| 179 | + | |
| 180 | + m_endpoint.connect(con); | |
| 181 | + | |
| 182 | + return new_id; | |
| 183 | + } | |
| 184 | + | |
| 185 | + void close(int id, websocketpp::close::status::value code, std::string reason) { | |
| 186 | + websocketpp::lib::error_code ec; | |
| 187 | + | |
| 188 | + con_list::iterator metadata_it = m_connection_list.find(id); | |
| 189 | + if (metadata_it == m_connection_list.end()) { | |
| 190 | + std::cout << "> No connection found with id " << id << std::endl; | |
| 191 | + return; | |
| 192 | + } | |
| 193 | + | |
| 194 | + m_endpoint.close(metadata_it->second->get_hdl(), code, reason, ec); | |
| 195 | + if (ec) { | |
| 196 | + std::cout << "> Error initiating close: " << ec.message() << std::endl; | |
| 197 | + } | |
| 198 | + } | |
| 199 | + | |
| 200 | + connection_metadata::ptr get_metadata(int id) const { | |
| 201 | + con_list::const_iterator metadata_it = m_connection_list.find(id); | |
| 202 | + if (metadata_it == m_connection_list.end()) { | |
| 203 | + return connection_metadata::ptr(); | |
| 204 | + } else { | |
| 205 | + return metadata_it->second; | |
| 206 | + } | |
| 207 | + } | |
| 208 | +private: | |
| 209 | + typedef std::map<int,connection_metadata::ptr> con_list; | |
| 210 | + | |
| 211 | + client m_endpoint; | |
| 212 | + websocketpp::lib::shared_ptr<websocketpp::lib::thread> m_thread; | |
| 213 | + | |
| 214 | + con_list m_connection_list; | |
| 215 | + int m_next_id; | |
| 216 | +}; | |
| 217 | + | |
| 218 | +int main() { | |
| 219 | + bool done = false; | |
| 220 | + std::string input; | |
| 221 | + websocket_endpoint endpoint; | |
| 222 | + | |
| 223 | + while (!done) { | |
| 224 | + std::cout << "Enter Command: "; | |
| 225 | + std::getline(std::cin, input); | |
| 226 | + | |
| 227 | + if (input == "quit") { | |
| 228 | + done = true; | |
| 229 | + } else if (input == "help") { | |
| 230 | + std::cout | |
| 231 | + << "\nCommand List:\n" | |
| 232 | + << "connect <ws uri>\n" | |
| 233 | + << "close <connection id> [<close code:default=1000>] [<close reason>]\n" | |
| 234 | + << "show <connection id>\n" | |
| 235 | + << "help: Display this help text\n" | |
| 236 | + << "quit: Exit the program\n" | |
| 237 | + << std::endl; | |
| 238 | + } else if (input.substr(0,7) == "connect") { | |
| 239 | + int id = endpoint.connect(input.substr(8)); | |
| 240 | + if (id != -1) { | |
| 241 | + std::cout << "> Created connection with id " << id << std::endl; | |
| 242 | + } | |
| 243 | + } else if (input.substr(0,5) == "close") { | |
| 244 | + std::stringstream ss(input); | |
| 245 | + | |
| 246 | + std::string cmd; | |
| 247 | + int id; | |
| 248 | + int close_code = websocketpp::close::status::normal; | |
| 249 | + std::string reason; | |
| 250 | + | |
| 251 | + ss >> cmd >> id >> close_code; | |
| 252 | + std::getline(ss,reason); | |
| 253 | + | |
| 254 | + endpoint.close(id, close_code, reason); | |
| 255 | + } else if (input.substr(0,4) == "show") { | |
| 256 | + int id = atoi(input.substr(5).c_str()); | |
| 257 | + | |
| 258 | + connection_metadata::ptr metadata = endpoint.get_metadata(id); | |
| 259 | + if (metadata) { | |
| 260 | + std::cout << *metadata << std::endl; | |
| 261 | + } else { | |
| 262 | + std::cout << "> Unknown connection id " << id << std::endl; | |
| 263 | + } | |
| 264 | + } else { | |
| 265 | + std::cout << "> Unrecognized Command" << std::endl; | |
| 266 | + } | |
| 267 | + } | |
| 268 | + | |
| 269 | + return 0; | |
| 270 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/scratch_server/SConscript
0 → 100644
| 1 | +## Scratch server example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | +Import('tls_libs') | |
| 10 | + | |
| 11 | +env = env.Clone () | |
| 12 | +env_cpp11 = env_cpp11.Clone () | |
| 13 | + | |
| 14 | +prgs = [] | |
| 15 | + | |
| 16 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 17 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 18 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + [tls_libs] + ['z'] | |
| 19 | + prgs += env_cpp11.Program('scratch_server', ["scratch_server.cpp"], LIBS = ALL_LIBS) | |
| 20 | +else: | |
| 21 | + ALL_LIBS = boostlibs(['system','regex','random'],env) + [platform_libs] + [polyfill_libs] + [tls_libs] + ['z'] | |
| 22 | + prgs += env.Program('scratch_server', ["scratch_server.cpp"], LIBS = ALL_LIBS) | |
| 23 | + | |
| 24 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/scratch_server/scratch_server.cpp
0 → 100644
| 1 | +/** | |
| 2 | + * This example is presently used as a scratch space. It may or may not be broken | |
| 3 | + * at any given time. | |
| 4 | + */ | |
| 5 | + | |
| 6 | +#include <iostream> | |
| 7 | + | |
| 8 | +#include <websocketpp/config/debug_asio_no_tls.hpp> | |
| 9 | +#include <websocketpp/server.hpp> | |
| 10 | + | |
| 11 | +#include <websocketpp/extensions/permessage_deflate/enabled.hpp> | |
| 12 | + | |
| 13 | +struct deflate_config : public websocketpp::config::debug_core { | |
| 14 | + typedef deflate_config type; | |
| 15 | + typedef debug_core base; | |
| 16 | + | |
| 17 | + typedef base::concurrency_type concurrency_type; | |
| 18 | + | |
| 19 | + typedef base::request_type request_type; | |
| 20 | + typedef base::response_type response_type; | |
| 21 | + | |
| 22 | + typedef base::message_type message_type; | |
| 23 | + typedef base::con_msg_manager_type con_msg_manager_type; | |
| 24 | + typedef base::endpoint_msg_manager_type endpoint_msg_manager_type; | |
| 25 | + | |
| 26 | + typedef base::alog_type alog_type; | |
| 27 | + typedef base::elog_type elog_type; | |
| 28 | + | |
| 29 | + typedef base::rng_type rng_type; | |
| 30 | + | |
| 31 | + struct transport_config : public base::transport_config { | |
| 32 | + typedef type::concurrency_type concurrency_type; | |
| 33 | + typedef type::alog_type alog_type; | |
| 34 | + typedef type::elog_type elog_type; | |
| 35 | + typedef type::request_type request_type; | |
| 36 | + typedef type::response_type response_type; | |
| 37 | + typedef websocketpp::transport::asio::basic_socket::endpoint | |
| 38 | + socket_type; | |
| 39 | + }; | |
| 40 | + | |
| 41 | + typedef websocketpp::transport::asio::endpoint<transport_config> | |
| 42 | + transport_type; | |
| 43 | + | |
| 44 | + /// permessage_compress extension | |
| 45 | + struct permessage_deflate_config {}; | |
| 46 | + | |
| 47 | + typedef websocketpp::extensions::permessage_deflate::enabled | |
| 48 | + <permessage_deflate_config> permessage_deflate_type; | |
| 49 | +}; | |
| 50 | + | |
| 51 | +typedef websocketpp::server<deflate_config> server; | |
| 52 | + | |
| 53 | +typedef server::message_ptr message_ptr; | |
| 54 | + | |
| 55 | +// Define a callback to handle incoming messages | |
| 56 | +void on_message(server* s, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 57 | + /*std::cout << "on_message called with hdl: " << hdl.lock().get() | |
| 58 | + << " and message (" << msg->get_payload().size() << "): " << msg->get_payload() | |
| 59 | + << std::endl; | |
| 60 | + */ | |
| 61 | + try { | |
| 62 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 63 | + } catch (websocketpp::exception const & e) { | |
| 64 | + std::cout << "Echo failed because: " | |
| 65 | + << "(" << e.what() << ")" << std::endl; | |
| 66 | + } | |
| 67 | +} | |
| 68 | + | |
| 69 | +int main(int argc, char * argv[]) { | |
| 70 | + // Create a server endpoint | |
| 71 | + server echo_server; | |
| 72 | + | |
| 73 | + try { | |
| 74 | + // Set logging settings | |
| 75 | + if (argc > 1 && std::string(argv[1]) == "-d") { | |
| 76 | + echo_server.set_access_channels(websocketpp::log::alevel::all); | |
| 77 | + echo_server.set_error_channels(websocketpp::log::elevel::all); | |
| 78 | + } else { | |
| 79 | + echo_server.set_access_channels(websocketpp::log::alevel::none); | |
| 80 | + echo_server.set_error_channels(websocketpp::log::elevel::none); | |
| 81 | + } | |
| 82 | + | |
| 83 | + // Initialize ASIO | |
| 84 | + echo_server.init_asio(); | |
| 85 | + | |
| 86 | + // Register our message handler | |
| 87 | + using websocketpp::lib::placeholders::_1; | |
| 88 | + using websocketpp::lib::placeholders::_2; | |
| 89 | + echo_server.set_message_handler(bind(&on_message,&echo_server,_1,_2)); | |
| 90 | + | |
| 91 | + // Listen on port 9002 | |
| 92 | + echo_server.listen(9002); | |
| 93 | + | |
| 94 | + // Start the server accept loop | |
| 95 | + echo_server.start_accept(); | |
| 96 | + | |
| 97 | + // Start the ASIO io_service run loop | |
| 98 | + echo_server.run(); | |
| 99 | + } catch (websocketpp::exception const & e) { | |
| 100 | + std::cout << e.what() << std::endl; | |
| 101 | + } catch (const std::exception & e) { | |
| 102 | + std::cout << e.what() << std::endl; | |
| 103 | + } catch (...) { | |
| 104 | + std::cout << "other exception" << std::endl; | |
| 105 | + } | |
| 106 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/simple_broadcast_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (simple_broadcast_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/simple_broadcast_server/simple_broadcast_server.cpp
0 → 100644
| 1 | +#include <set> | |
| 2 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 3 | +#include <websocketpp/server.hpp> | |
| 4 | + | |
| 5 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 6 | + | |
| 7 | +using websocketpp::connection_hdl; | |
| 8 | +using websocketpp::lib::placeholders::_1; | |
| 9 | +using websocketpp::lib::placeholders::_2; | |
| 10 | +using websocketpp::lib::bind; | |
| 11 | + | |
| 12 | +class broadcast_server { | |
| 13 | +public: | |
| 14 | + broadcast_server() { | |
| 15 | + m_server.init_asio(); | |
| 16 | + | |
| 17 | + m_server.set_open_handler(bind(&broadcast_server::on_open,this,::_1)); | |
| 18 | + m_server.set_close_handler(bind(&broadcast_server::on_close,this,::_1)); | |
| 19 | + m_server.set_message_handler(bind(&broadcast_server::on_message,this,::_1,::_2)); | |
| 20 | + } | |
| 21 | + | |
| 22 | + void on_open(connection_hdl hdl) { | |
| 23 | + m_connections.insert(hdl); | |
| 24 | + } | |
| 25 | + | |
| 26 | + void on_close(connection_hdl hdl) { | |
| 27 | + m_connections.erase(hdl); | |
| 28 | + } | |
| 29 | + | |
| 30 | + void on_message(connection_hdl hdl, server::message_ptr msg) { | |
| 31 | + for (auto it : m_connections) { | |
| 32 | + m_server.send(it,msg); | |
| 33 | + } | |
| 34 | + } | |
| 35 | + | |
| 36 | + void run(uint16_t port) { | |
| 37 | + m_server.listen(port); | |
| 38 | + m_server.start_accept(); | |
| 39 | + m_server.run(); | |
| 40 | + } | |
| 41 | +private: | |
| 42 | + typedef std::set<connection_hdl,std::owner_less<connection_hdl>> con_list; | |
| 43 | + | |
| 44 | + server m_server; | |
| 45 | + con_list m_connections; | |
| 46 | +}; | |
| 47 | + | |
| 48 | +int main() { | |
| 49 | + broadcast_server server; | |
| 50 | + server.run(9002); | |
| 51 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/sip_client/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (sip_client) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/sip_client/README.txt
0 → 100644
| 1 | + | |
| 2 | + | |
| 3 | +Checkout the project from git | |
| 4 | + | |
| 5 | +At the top level, run cmake: | |
| 6 | + | |
| 7 | + cmake -G 'Unix Makefiles' \ | |
| 8 | + -D BUILD_EXAMPLES=ON \ | |
| 9 | + -D WEBSOCKETPP_ROOT=/tmp/cm1 \ | |
| 10 | + -D ENABLE_CPP11=OFF . | |
| 11 | + | |
| 12 | +and then make the example: | |
| 13 | + | |
| 14 | + make -C examples/sip_client | |
| 15 | + | |
| 16 | +Now run it: | |
| 17 | + | |
| 18 | + bin/sip_client ws://ws-server:80 | |
| 19 | + | |
| 20 | +It has been tested against the repro SIP proxy from reSIProcate | |
| 21 | + | |
| 22 | + http://www.resiprocate.org/WebRTC_and_SIP_Over_WebSockets | ... | ... |
3rdparty/websocketpp-0.8.2/examples/sip_client/SConscript
0 → 100644
| 1 | +## SIP client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('sip_client', ["sip_client.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system','random'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('sip_client', ["sip_client.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/sip_client/sip_client.cpp
0 → 100644
| 1 | +#include <condition_variable> | |
| 2 | + | |
| 3 | +#include <websocketpp/config/asio_no_tls_client.hpp> | |
| 4 | + | |
| 5 | +#include <websocketpp/client.hpp> | |
| 6 | + | |
| 7 | +#include <iostream> | |
| 8 | + | |
| 9 | +#include <boost/thread/thread.hpp> | |
| 10 | + | |
| 11 | +typedef websocketpp::client<websocketpp::config::asio_client> client; | |
| 12 | + | |
| 13 | +using websocketpp::lib::placeholders::_1; | |
| 14 | +using websocketpp::lib::placeholders::_2; | |
| 15 | +using websocketpp::lib::bind; | |
| 16 | + | |
| 17 | +// pull out the type of messages sent by our config | |
| 18 | +typedef websocketpp::config::asio_client::message_type::ptr message_ptr; | |
| 19 | + | |
| 20 | +// Create a server endpoint | |
| 21 | +client sip_client; | |
| 22 | + | |
| 23 | + | |
| 24 | +bool received; | |
| 25 | + | |
| 26 | +void on_open(client* c, websocketpp::connection_hdl hdl) { | |
| 27 | + // now it is safe to use the connection | |
| 28 | + std::cout << "connection ready" << std::endl; | |
| 29 | + | |
| 30 | + received=false; | |
| 31 | + // Send a SIP OPTIONS message to the server: | |
| 32 | + std::string SIP_msg="OPTIONS sip:carol@chicago.com SIP/2.0\r\nVia: SIP/2.0/WS df7jal23ls0d.invalid;rport;branch=z9hG4bKhjhs8ass877\r\nMax-Forwards: 70\r\nTo: <sip:carol@chicago.com>\r\nFrom: Alice <sip:alice@atlanta.com>;tag=1928301774\r\nCall-ID: a84b4c76e66710\r\nCSeq: 63104 OPTIONS\r\nContact: <sip:alice@pc33.atlanta.com>\r\nAccept: application/sdp\r\nContent-Length: 0\r\n\r\n"; | |
| 33 | + sip_client.send(hdl, SIP_msg.c_str(), websocketpp::frame::opcode::text); | |
| 34 | +} | |
| 35 | + | |
| 36 | +void on_message(client* c, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 37 | + client::connection_ptr con = sip_client.get_con_from_hdl(hdl); | |
| 38 | + | |
| 39 | + std::cout << "Received a reply:" << std::endl; | |
| 40 | + fwrite(msg->get_payload().c_str(), msg->get_payload().size(), 1, stdout); | |
| 41 | + received=true; | |
| 42 | +} | |
| 43 | + | |
| 44 | +int main(int argc, char* argv[]) { | |
| 45 | + | |
| 46 | + std::string uri = "ws://localhost:9001"; | |
| 47 | + | |
| 48 | + if (argc == 2) { | |
| 49 | + uri = argv[1]; | |
| 50 | + } | |
| 51 | + | |
| 52 | + try { | |
| 53 | + // We expect there to be a lot of errors, so suppress them | |
| 54 | + sip_client.clear_access_channels(websocketpp::log::alevel::all); | |
| 55 | + sip_client.clear_error_channels(websocketpp::log::elevel::all); | |
| 56 | + | |
| 57 | + // Initialize ASIO | |
| 58 | + sip_client.init_asio(); | |
| 59 | + | |
| 60 | + // Register our handlers | |
| 61 | + sip_client.set_open_handler(bind(&on_open,&sip_client,::_1)); | |
| 62 | + sip_client.set_message_handler(bind(&on_message,&sip_client,::_1,::_2)); | |
| 63 | + | |
| 64 | + websocketpp::lib::error_code ec; | |
| 65 | + client::connection_ptr con = sip_client.get_connection(uri, ec); | |
| 66 | + | |
| 67 | + // Specify the SIP subprotocol: | |
| 68 | + con->add_subprotocol("sip"); | |
| 69 | + | |
| 70 | + sip_client.connect(con); | |
| 71 | + | |
| 72 | + // Start the ASIO io_service run loop | |
| 73 | + sip_client.run(); | |
| 74 | + | |
| 75 | + while(!received) { | |
| 76 | + boost::this_thread::sleep(boost::posix_time::milliseconds(100)); | |
| 77 | + } | |
| 78 | + | |
| 79 | + std::cout << "done" << std::endl; | |
| 80 | + | |
| 81 | + } catch (websocketpp::exception const & e) { | |
| 82 | + std::cout << e.what() << std::endl; | |
| 83 | + } | |
| 84 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/subprotocol_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (subprotocol_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/subprotocol_server/SConscript
0 → 100644
| 1 | +## Main development example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('subprotocol_server', ["subprotocol_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('subprotocol_server', ["subprotocol_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/subprotocol_server/subprotocol_server.cpp
0 → 100644
| 1 | +#include <iostream> | |
| 2 | + | |
| 3 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 4 | +#include <websocketpp/server.hpp> | |
| 5 | + | |
| 6 | +typedef websocketpp::server<websocketpp::config::asio> server; | |
| 7 | + | |
| 8 | +using websocketpp::connection_hdl; | |
| 9 | +using websocketpp::lib::placeholders::_1; | |
| 10 | +using websocketpp::lib::placeholders::_2; | |
| 11 | +using websocketpp::lib::bind; | |
| 12 | +using websocketpp::lib::ref; | |
| 13 | + | |
| 14 | + | |
| 15 | +bool validate(server & s, connection_hdl hdl) { | |
| 16 | + server::connection_ptr con = s.get_con_from_hdl(hdl); | |
| 17 | + | |
| 18 | + std::cout << "Cache-Control: " << con->get_request_header("Cache-Control") << std::endl; | |
| 19 | + | |
| 20 | + const std::vector<std::string> & subp_requests = con->get_requested_subprotocols(); | |
| 21 | + std::vector<std::string>::const_iterator it; | |
| 22 | + | |
| 23 | + for (it = subp_requests.begin(); it != subp_requests.end(); ++it) { | |
| 24 | + std::cout << "Requested: " << *it << std::endl; | |
| 25 | + } | |
| 26 | + | |
| 27 | + if (subp_requests.size() > 0) { | |
| 28 | + con->select_subprotocol(subp_requests[0]); | |
| 29 | + } | |
| 30 | + | |
| 31 | + return true; | |
| 32 | +} | |
| 33 | + | |
| 34 | +int main() { | |
| 35 | + try { | |
| 36 | + server s; | |
| 37 | + | |
| 38 | + s.set_validate_handler(bind(&validate,ref(s),::_1)); | |
| 39 | + | |
| 40 | + s.init_asio(); | |
| 41 | + s.listen(9005); | |
| 42 | + s.start_accept(); | |
| 43 | + | |
| 44 | + s.run(); | |
| 45 | + } catch (websocketpp::exception const & e) { | |
| 46 | + std::cout << e.what() << std::endl; | |
| 47 | + } | |
| 48 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/telemetry_client/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (telemetry_client) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/telemetry_client/SConscript
0 → 100644
| 1 | +## Telemetry client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('telemetry_client', ["telemetry_client.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system','random'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('telemetry_client', ["telemetry_client.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/telemetry_client/telemetry_client.cpp
0 → 100644
| 1 | +#include <websocketpp/config/asio_no_tls_client.hpp> | |
| 2 | +#include <websocketpp/client.hpp> | |
| 3 | + | |
| 4 | +// This header pulls in the WebSocket++ abstracted thread support that will | |
| 5 | +// select between boost::thread and std::thread based on how the build system | |
| 6 | +// is configured. | |
| 7 | +#include <websocketpp/common/thread.hpp> | |
| 8 | + | |
| 9 | +/** | |
| 10 | + * Define a semi-cross platform helper method that waits/sleeps for a bit. | |
| 11 | + */ | |
| 12 | +void wait_a_bit() { | |
| 13 | +#ifdef WIN32 | |
| 14 | + Sleep(1000); | |
| 15 | +#else | |
| 16 | + sleep(1); | |
| 17 | +#endif | |
| 18 | +} | |
| 19 | + | |
| 20 | +/** | |
| 21 | + * The telemetry client connects to a WebSocket server and sends a message every | |
| 22 | + * second containing an integer count. This example can be used as the basis for | |
| 23 | + * programs where a client connects and pushes data for logging, stress/load | |
| 24 | + * testing, etc. | |
| 25 | + */ | |
| 26 | +class telemetry_client { | |
| 27 | +public: | |
| 28 | + typedef websocketpp::client<websocketpp::config::asio_client> client; | |
| 29 | + typedef websocketpp::lib::lock_guard<websocketpp::lib::mutex> scoped_lock; | |
| 30 | + | |
| 31 | + telemetry_client() : m_open(false),m_done(false) { | |
| 32 | + // set up access channels to only log interesting things | |
| 33 | + m_client.clear_access_channels(websocketpp::log::alevel::all); | |
| 34 | + m_client.set_access_channels(websocketpp::log::alevel::connect); | |
| 35 | + m_client.set_access_channels(websocketpp::log::alevel::disconnect); | |
| 36 | + m_client.set_access_channels(websocketpp::log::alevel::app); | |
| 37 | + | |
| 38 | + // Initialize the Asio transport policy | |
| 39 | + m_client.init_asio(); | |
| 40 | + | |
| 41 | + // Bind the handlers we are using | |
| 42 | + using websocketpp::lib::placeholders::_1; | |
| 43 | + using websocketpp::lib::bind; | |
| 44 | + m_client.set_open_handler(bind(&telemetry_client::on_open,this,_1)); | |
| 45 | + m_client.set_close_handler(bind(&telemetry_client::on_close,this,_1)); | |
| 46 | + m_client.set_fail_handler(bind(&telemetry_client::on_fail,this,_1)); | |
| 47 | + } | |
| 48 | + | |
| 49 | + // This method will block until the connection is complete | |
| 50 | + void run(const std::string & uri) { | |
| 51 | + // Create a new connection to the given URI | |
| 52 | + websocketpp::lib::error_code ec; | |
| 53 | + client::connection_ptr con = m_client.get_connection(uri, ec); | |
| 54 | + if (ec) { | |
| 55 | + m_client.get_alog().write(websocketpp::log::alevel::app, | |
| 56 | + "Get Connection Error: "+ec.message()); | |
| 57 | + return; | |
| 58 | + } | |
| 59 | + | |
| 60 | + // Grab a handle for this connection so we can talk to it in a thread | |
| 61 | + // safe manor after the event loop starts. | |
| 62 | + m_hdl = con->get_handle(); | |
| 63 | + | |
| 64 | + // Queue the connection. No DNS queries or network connections will be | |
| 65 | + // made until the io_service event loop is run. | |
| 66 | + m_client.connect(con); | |
| 67 | + | |
| 68 | + // Create a thread to run the ASIO io_service event loop | |
| 69 | + websocketpp::lib::thread asio_thread(&client::run, &m_client); | |
| 70 | + | |
| 71 | + // Create a thread to run the telemetry loop | |
| 72 | + websocketpp::lib::thread telemetry_thread(&telemetry_client::telemetry_loop,this); | |
| 73 | + | |
| 74 | + asio_thread.join(); | |
| 75 | + telemetry_thread.join(); | |
| 76 | + } | |
| 77 | + | |
| 78 | + // The open handler will signal that we are ready to start sending telemetry | |
| 79 | + void on_open(websocketpp::connection_hdl) { | |
| 80 | + m_client.get_alog().write(websocketpp::log::alevel::app, | |
| 81 | + "Connection opened, starting telemetry!"); | |
| 82 | + | |
| 83 | + scoped_lock guard(m_lock); | |
| 84 | + m_open = true; | |
| 85 | + } | |
| 86 | + | |
| 87 | + // The close handler will signal that we should stop sending telemetry | |
| 88 | + void on_close(websocketpp::connection_hdl) { | |
| 89 | + m_client.get_alog().write(websocketpp::log::alevel::app, | |
| 90 | + "Connection closed, stopping telemetry!"); | |
| 91 | + | |
| 92 | + scoped_lock guard(m_lock); | |
| 93 | + m_done = true; | |
| 94 | + } | |
| 95 | + | |
| 96 | + // The fail handler will signal that we should stop sending telemetry | |
| 97 | + void on_fail(websocketpp::connection_hdl) { | |
| 98 | + m_client.get_alog().write(websocketpp::log::alevel::app, | |
| 99 | + "Connection failed, stopping telemetry!"); | |
| 100 | + | |
| 101 | + scoped_lock guard(m_lock); | |
| 102 | + m_done = true; | |
| 103 | + } | |
| 104 | + | |
| 105 | + void telemetry_loop() { | |
| 106 | + uint64_t count = 0; | |
| 107 | + std::stringstream val; | |
| 108 | + websocketpp::lib::error_code ec; | |
| 109 | + | |
| 110 | + while(1) { | |
| 111 | + bool wait = false; | |
| 112 | + | |
| 113 | + { | |
| 114 | + scoped_lock guard(m_lock); | |
| 115 | + // If the connection has been closed, stop generating telemetry | |
| 116 | + if (m_done) {break;} | |
| 117 | + | |
| 118 | + // If the connection hasn't been opened yet wait a bit and retry | |
| 119 | + if (!m_open) { | |
| 120 | + wait = true; | |
| 121 | + } | |
| 122 | + } | |
| 123 | + | |
| 124 | + if (wait) { | |
| 125 | + wait_a_bit(); | |
| 126 | + continue; | |
| 127 | + } | |
| 128 | + | |
| 129 | + val.str(""); | |
| 130 | + val << "count is " << count++; | |
| 131 | + | |
| 132 | + m_client.get_alog().write(websocketpp::log::alevel::app, val.str()); | |
| 133 | + m_client.send(m_hdl,val.str(),websocketpp::frame::opcode::text,ec); | |
| 134 | + | |
| 135 | + // The most likely error that we will get is that the connection is | |
| 136 | + // not in the right state. Usually this means we tried to send a | |
| 137 | + // message to a connection that was closed or in the process of | |
| 138 | + // closing. While many errors here can be easily recovered from, | |
| 139 | + // in this simple example, we'll stop the telemetry loop. | |
| 140 | + if (ec) { | |
| 141 | + m_client.get_alog().write(websocketpp::log::alevel::app, | |
| 142 | + "Send Error: "+ec.message()); | |
| 143 | + break; | |
| 144 | + } | |
| 145 | + | |
| 146 | + wait_a_bit(); | |
| 147 | + } | |
| 148 | + } | |
| 149 | +private: | |
| 150 | + client m_client; | |
| 151 | + websocketpp::connection_hdl m_hdl; | |
| 152 | + websocketpp::lib::mutex m_lock; | |
| 153 | + bool m_open; | |
| 154 | + bool m_done; | |
| 155 | +}; | |
| 156 | + | |
| 157 | +int main(int argc, char* argv[]) { | |
| 158 | + telemetry_client c; | |
| 159 | + | |
| 160 | + std::string uri = "ws://localhost:9002"; | |
| 161 | + | |
| 162 | + if (argc == 2) { | |
| 163 | + uri = argv[1]; | |
| 164 | + } | |
| 165 | + | |
| 166 | + c.run(uri); | |
| 167 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/telemetry_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (telemetry_server) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | ... | ... |
3rdparty/websocketpp-0.8.2/examples/telemetry_server/SConscript
0 → 100644
| 1 | +## Main development example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('telemetry_server', ["telemetry_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('telemetry_server', ["telemetry_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/telemetry_server/index.html
0 → 100644
| 1 | +<!doctype html> | |
| 2 | +<html> | |
| 3 | +<head> | |
| 4 | +<title>WebSocket++ Telemetry Client</title> | |
| 5 | +</head> | |
| 6 | +<body> | |
| 7 | + | |
| 8 | +<script type="text/javascript"> | |
| 9 | +var ws; | |
| 10 | +var url; | |
| 11 | + | |
| 12 | +function connect() { | |
| 13 | + url = document.getElementById("server_url").value; | |
| 14 | + | |
| 15 | + if ("WebSocket" in window) { | |
| 16 | + ws = new WebSocket(url); | |
| 17 | + } else if ("MozWebSocket" in window) { | |
| 18 | + ws = new MozWebSocket(url); | |
| 19 | + } else { | |
| 20 | + document.getElementById("messages").innerHTML += "This Browser does not support WebSockets<br />"; | |
| 21 | + return; | |
| 22 | + } | |
| 23 | + ws.onopen = function(e) { | |
| 24 | + document.getElementById("messages").innerHTML += "Client: A connection to "+ws.url+" has been opened.<br />"; | |
| 25 | + | |
| 26 | + document.getElementById("server_url").disabled = true; | |
| 27 | + document.getElementById("toggle_connect").innerHTML = "Disconnect"; | |
| 28 | + }; | |
| 29 | + | |
| 30 | + ws.onerror = function(e) { | |
| 31 | + document.getElementById("messages").innerHTML += "Client: An error occured, see console log for more details.<br />"; | |
| 32 | + console.log(e); | |
| 33 | + }; | |
| 34 | + | |
| 35 | + ws.onclose = function(e) { | |
| 36 | + document.getElementById("messages").innerHTML += "Client: The connection to "+url+" was closed. ["+e.code+(e.reason != "" ? ","+e.reason : "")+"]<br />"; | |
| 37 | + cleanup_disconnect(); | |
| 38 | + }; | |
| 39 | + | |
| 40 | + ws.onmessage = function(e) { | |
| 41 | + document.getElementById("messages").innerHTML += "Server: "+e.data+"<br />"; | |
| 42 | + }; | |
| 43 | +} | |
| 44 | + | |
| 45 | +function disconnect() { | |
| 46 | + ws.close(); | |
| 47 | + cleanup_disconnect(); | |
| 48 | +} | |
| 49 | + | |
| 50 | +function cleanup_disconnect() { | |
| 51 | + document.getElementById("server_url").disabled = false; | |
| 52 | + document.getElementById("toggle_connect").innerHTML = "Connect"; | |
| 53 | +} | |
| 54 | + | |
| 55 | +function toggle_connect() { | |
| 56 | + if (document.getElementById("server_url").disabled === false) { | |
| 57 | + connect(); | |
| 58 | + } else { | |
| 59 | + disconnect(); | |
| 60 | + } | |
| 61 | +} | |
| 62 | +</script> | |
| 63 | + | |
| 64 | +<style> | |
| 65 | +body,html { | |
| 66 | + margin: 0px; | |
| 67 | + padding: 0px; | |
| 68 | +} | |
| 69 | +#controls { | |
| 70 | + float:right; | |
| 71 | + background-color: #999; | |
| 72 | +} | |
| 73 | + | |
| 74 | +</style> | |
| 75 | + | |
| 76 | +<div id="controls"> | |
| 77 | + <div id="server"> | |
| 78 | + <input type="text" name="server_url" id="server_url" value="ws://localhost:9002" /><br /> | |
| 79 | + <button id="toggle_connect" onclick="toggle_connect();">Connect</button> | |
| 80 | + </div> | |
| 81 | +</div> | |
| 82 | +<div id="messages"></div> | |
| 83 | + | |
| 84 | +</body> | |
| 85 | +</html> | ... | ... |
3rdparty/websocketpp-0.8.2/examples/telemetry_server/telemetry_server.cpp
0 → 100644
| 1 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 2 | + | |
| 3 | +#include <websocketpp/server.hpp> | |
| 4 | + | |
| 5 | +#include <fstream> | |
| 6 | +#include <iostream> | |
| 7 | +#include <set> | |
| 8 | +#include <streambuf> | |
| 9 | +#include <string> | |
| 10 | + | |
| 11 | +/** | |
| 12 | + * The telemetry server accepts connections and sends a message every second to | |
| 13 | + * each client containing an integer count. This example can be used as the | |
| 14 | + * basis for programs that expose a stream of telemetry data for logging, | |
| 15 | + * dashboards, etc. | |
| 16 | + * | |
| 17 | + * This example uses the timer based concurrency method and is self contained | |
| 18 | + * and singled threaded. Refer to telemetry client for an example of a similar | |
| 19 | + * telemetry setup using threads rather than timers. | |
| 20 | + * | |
| 21 | + * This example also includes an example simple HTTP server that serves a web | |
| 22 | + * dashboard displaying the count. This simple design is suitable for use | |
| 23 | + * delivering a small number of files to a small number of clients. It is ideal | |
| 24 | + * for cases like embedded dashboards that don't want the complexity of an extra | |
| 25 | + * HTTP server to serve static files. | |
| 26 | + * | |
| 27 | + * This design *will* fall over under high traffic or DoS conditions. In such | |
| 28 | + * cases you are much better off proxying to a real HTTP server for the http | |
| 29 | + * requests. | |
| 30 | + */ | |
| 31 | +class telemetry_server { | |
| 32 | +public: | |
| 33 | + typedef websocketpp::connection_hdl connection_hdl; | |
| 34 | + typedef websocketpp::server<websocketpp::config::asio> server; | |
| 35 | + | |
| 36 | + telemetry_server() : m_count(0) { | |
| 37 | + // set up access channels to only log interesting things | |
| 38 | + m_endpoint.clear_access_channels(websocketpp::log::alevel::all); | |
| 39 | + m_endpoint.set_access_channels(websocketpp::log::alevel::access_core); | |
| 40 | + m_endpoint.set_access_channels(websocketpp::log::alevel::app); | |
| 41 | + | |
| 42 | + // Initialize the Asio transport policy | |
| 43 | + m_endpoint.init_asio(); | |
| 44 | + | |
| 45 | + // Bind the handlers we are using | |
| 46 | + using websocketpp::lib::placeholders::_1; | |
| 47 | + using websocketpp::lib::bind; | |
| 48 | + m_endpoint.set_open_handler(bind(&telemetry_server::on_open,this,_1)); | |
| 49 | + m_endpoint.set_close_handler(bind(&telemetry_server::on_close,this,_1)); | |
| 50 | + m_endpoint.set_http_handler(bind(&telemetry_server::on_http,this,_1)); | |
| 51 | + } | |
| 52 | + | |
| 53 | + void run(std::string docroot, uint16_t port) { | |
| 54 | + std::stringstream ss; | |
| 55 | + ss << "Running telemetry server on port "<< port <<" using docroot=" << docroot; | |
| 56 | + m_endpoint.get_alog().write(websocketpp::log::alevel::app,ss.str()); | |
| 57 | + | |
| 58 | + m_docroot = docroot; | |
| 59 | + | |
| 60 | + // listen on specified port | |
| 61 | + m_endpoint.listen(port); | |
| 62 | + | |
| 63 | + // Start the server accept loop | |
| 64 | + m_endpoint.start_accept(); | |
| 65 | + | |
| 66 | + // Set the initial timer to start telemetry | |
| 67 | + set_timer(); | |
| 68 | + | |
| 69 | + // Start the ASIO io_service run loop | |
| 70 | + try { | |
| 71 | + m_endpoint.run(); | |
| 72 | + } catch (websocketpp::exception const & e) { | |
| 73 | + std::cout << e.what() << std::endl; | |
| 74 | + } | |
| 75 | + } | |
| 76 | + | |
| 77 | + void set_timer() { | |
| 78 | + m_timer = m_endpoint.set_timer( | |
| 79 | + 1000, | |
| 80 | + websocketpp::lib::bind( | |
| 81 | + &telemetry_server::on_timer, | |
| 82 | + this, | |
| 83 | + websocketpp::lib::placeholders::_1 | |
| 84 | + ) | |
| 85 | + ); | |
| 86 | + } | |
| 87 | + | |
| 88 | + void on_timer(websocketpp::lib::error_code const & ec) { | |
| 89 | + if (ec) { | |
| 90 | + // there was an error, stop telemetry | |
| 91 | + m_endpoint.get_alog().write(websocketpp::log::alevel::app, | |
| 92 | + "Timer Error: "+ec.message()); | |
| 93 | + return; | |
| 94 | + } | |
| 95 | + | |
| 96 | + std::stringstream val; | |
| 97 | + val << "count is " << m_count++; | |
| 98 | + | |
| 99 | + // Broadcast count to all connections | |
| 100 | + con_list::iterator it; | |
| 101 | + for (it = m_connections.begin(); it != m_connections.end(); ++it) { | |
| 102 | + m_endpoint.send(*it,val.str(),websocketpp::frame::opcode::text); | |
| 103 | + } | |
| 104 | + | |
| 105 | + // set timer for next telemetry check | |
| 106 | + set_timer(); | |
| 107 | + } | |
| 108 | + | |
| 109 | + void on_http(connection_hdl hdl) { | |
| 110 | + // Upgrade our connection handle to a full connection_ptr | |
| 111 | + server::connection_ptr con = m_endpoint.get_con_from_hdl(hdl); | |
| 112 | + | |
| 113 | + std::ifstream file; | |
| 114 | + std::string filename = con->get_resource(); | |
| 115 | + std::string response; | |
| 116 | + | |
| 117 | + m_endpoint.get_alog().write(websocketpp::log::alevel::app, | |
| 118 | + "http request1: "+filename); | |
| 119 | + | |
| 120 | + if (filename == "/") { | |
| 121 | + filename = m_docroot+"index.html"; | |
| 122 | + } else { | |
| 123 | + filename = m_docroot+filename.substr(1); | |
| 124 | + } | |
| 125 | + | |
| 126 | + m_endpoint.get_alog().write(websocketpp::log::alevel::app, | |
| 127 | + "http request2: "+filename); | |
| 128 | + | |
| 129 | + file.open(filename.c_str(), std::ios::in); | |
| 130 | + if (!file) { | |
| 131 | + // 404 error | |
| 132 | + std::stringstream ss; | |
| 133 | + | |
| 134 | + ss << "<!doctype html><html><head>" | |
| 135 | + << "<title>Error 404 (Resource not found)</title><body>" | |
| 136 | + << "<h1>Error 404</h1>" | |
| 137 | + << "<p>The requested URL " << filename << " was not found on this server.</p>" | |
| 138 | + << "</body></head></html>"; | |
| 139 | + | |
| 140 | + con->set_body(ss.str()); | |
| 141 | + con->set_status(websocketpp::http::status_code::not_found); | |
| 142 | + return; | |
| 143 | + } | |
| 144 | + | |
| 145 | + file.seekg(0, std::ios::end); | |
| 146 | + response.reserve(file.tellg()); | |
| 147 | + file.seekg(0, std::ios::beg); | |
| 148 | + | |
| 149 | + response.assign((std::istreambuf_iterator<char>(file)), | |
| 150 | + std::istreambuf_iterator<char>()); | |
| 151 | + | |
| 152 | + con->set_body(response); | |
| 153 | + con->set_status(websocketpp::http::status_code::ok); | |
| 154 | + } | |
| 155 | + | |
| 156 | + void on_open(connection_hdl hdl) { | |
| 157 | + m_connections.insert(hdl); | |
| 158 | + } | |
| 159 | + | |
| 160 | + void on_close(connection_hdl hdl) { | |
| 161 | + m_connections.erase(hdl); | |
| 162 | + } | |
| 163 | +private: | |
| 164 | + typedef std::set<connection_hdl,std::owner_less<connection_hdl>> con_list; | |
| 165 | + | |
| 166 | + server m_endpoint; | |
| 167 | + con_list m_connections; | |
| 168 | + server::timer_ptr m_timer; | |
| 169 | + | |
| 170 | + std::string m_docroot; | |
| 171 | + | |
| 172 | + // Telemetry data | |
| 173 | + uint64_t m_count; | |
| 174 | +}; | |
| 175 | + | |
| 176 | +int main(int argc, char* argv[]) { | |
| 177 | + telemetry_server s; | |
| 178 | + | |
| 179 | + std::string docroot; | |
| 180 | + uint16_t port = 9002; | |
| 181 | + | |
| 182 | + if (argc == 1) { | |
| 183 | + std::cout << "Usage: telemetry_server [documentroot] [port]" << std::endl; | |
| 184 | + return 1; | |
| 185 | + } | |
| 186 | + | |
| 187 | + if (argc >= 2) { | |
| 188 | + docroot = std::string(argv[1]); | |
| 189 | + } | |
| 190 | + | |
| 191 | + if (argc >= 3) { | |
| 192 | + int i = atoi(argv[2]); | |
| 193 | + if (i <= 0 || i > 65535) { | |
| 194 | + std::cout << "invalid port" << std::endl; | |
| 195 | + return 1; | |
| 196 | + } | |
| 197 | + | |
| 198 | + port = uint16_t(i); | |
| 199 | + } | |
| 200 | + | |
| 201 | + s.run(docroot, port); | |
| 202 | + return 0; | |
| 203 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/testee_client/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +if (ZLIB_FOUND) | |
| 6 | + | |
| 7 | +init_target (testee_client) | |
| 8 | + | |
| 9 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 10 | + | |
| 11 | +link_boost () | |
| 12 | +link_zlib() | |
| 13 | +final_target () | |
| 14 | + | |
| 15 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | |
| 16 | + | |
| 17 | +endif() | |
| 0 | 18 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/examples/testee_client/SConscript
0 → 100644
| 1 | +## Autobahn test client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + ['z'] | |
| 18 | + prgs += env_cpp11.Program('testee_client', ["testee_client.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system','random'],env) + [platform_libs] + [polyfill_libs] + ['z'] | |
| 21 | + prgs += env.Program('testee_client', ["testee_client.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/testee_client/testee_client.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2015, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + * | |
| 26 | + */ | |
| 27 | + | |
| 28 | +#include <websocketpp/config/asio_no_tls_client.hpp> | |
| 29 | +#include <websocketpp/client.hpp> | |
| 30 | +#include <websocketpp/extensions/permessage_deflate/enabled.hpp> | |
| 31 | + | |
| 32 | +#include <iostream> | |
| 33 | + | |
| 34 | +struct deflate_config : public websocketpp::config::asio_client { | |
| 35 | + typedef deflate_config type; | |
| 36 | + typedef asio_client base; | |
| 37 | + | |
| 38 | + typedef base::concurrency_type concurrency_type; | |
| 39 | + | |
| 40 | + typedef base::request_type request_type; | |
| 41 | + typedef base::response_type response_type; | |
| 42 | + | |
| 43 | + typedef base::message_type message_type; | |
| 44 | + typedef base::con_msg_manager_type con_msg_manager_type; | |
| 45 | + typedef base::endpoint_msg_manager_type endpoint_msg_manager_type; | |
| 46 | + | |
| 47 | + typedef base::alog_type alog_type; | |
| 48 | + typedef base::elog_type elog_type; | |
| 49 | + | |
| 50 | + typedef base::rng_type rng_type; | |
| 51 | + | |
| 52 | + struct transport_config : public base::transport_config { | |
| 53 | + typedef type::concurrency_type concurrency_type; | |
| 54 | + typedef type::alog_type alog_type; | |
| 55 | + typedef type::elog_type elog_type; | |
| 56 | + typedef type::request_type request_type; | |
| 57 | + typedef type::response_type response_type; | |
| 58 | + typedef websocketpp::transport::asio::basic_socket::endpoint | |
| 59 | + socket_type; | |
| 60 | + }; | |
| 61 | + | |
| 62 | + typedef websocketpp::transport::asio::endpoint<transport_config> | |
| 63 | + transport_type; | |
| 64 | + | |
| 65 | + /// permessage_compress extension | |
| 66 | + struct permessage_deflate_config {}; | |
| 67 | + | |
| 68 | + typedef websocketpp::extensions::permessage_deflate::enabled | |
| 69 | + <permessage_deflate_config> permessage_deflate_type; | |
| 70 | +}; | |
| 71 | + | |
| 72 | +typedef websocketpp::client<deflate_config> client; | |
| 73 | + | |
| 74 | +using websocketpp::lib::placeholders::_1; | |
| 75 | +using websocketpp::lib::placeholders::_2; | |
| 76 | +using websocketpp::lib::bind; | |
| 77 | + | |
| 78 | +// pull out the type of messages sent by our config | |
| 79 | +typedef websocketpp::config::asio_client::message_type::ptr message_ptr; | |
| 80 | + | |
| 81 | +int case_count = 0; | |
| 82 | + | |
| 83 | +void on_message(client* c, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 84 | + client::connection_ptr con = c->get_con_from_hdl(hdl); | |
| 85 | + | |
| 86 | + if (con->get_resource() == "/getCaseCount") { | |
| 87 | + std::cout << "Detected " << msg->get_payload() << " test cases." | |
| 88 | + << std::endl; | |
| 89 | + case_count = atoi(msg->get_payload().c_str()); | |
| 90 | + } else { | |
| 91 | + c->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 92 | + } | |
| 93 | +} | |
| 94 | + | |
| 95 | +int main(int argc, char* argv[]) { | |
| 96 | + // Create a server endpoint | |
| 97 | + client c; | |
| 98 | + | |
| 99 | + std::string uri = "ws://localhost:9001"; | |
| 100 | + | |
| 101 | + if (argc == 2) { | |
| 102 | + uri = argv[1]; | |
| 103 | + } | |
| 104 | + | |
| 105 | + try { | |
| 106 | + // We expect there to be a lot of errors, so suppress them | |
| 107 | + c.clear_access_channels(websocketpp::log::alevel::all); | |
| 108 | + c.clear_error_channels(websocketpp::log::elevel::all); | |
| 109 | + | |
| 110 | + // Initialize ASIO | |
| 111 | + c.init_asio(); | |
| 112 | + | |
| 113 | + // Register our handlers | |
| 114 | + c.set_message_handler(bind(&on_message,&c,::_1,::_2)); | |
| 115 | + | |
| 116 | + websocketpp::lib::error_code ec; | |
| 117 | + client::connection_ptr con = c.get_connection(uri+"/getCaseCount", ec); | |
| 118 | + c.connect(con); | |
| 119 | + | |
| 120 | + // Start the ASIO io_service run loop | |
| 121 | + c.run(); | |
| 122 | + | |
| 123 | + std::cout << "case count: " << case_count << std::endl; | |
| 124 | + | |
| 125 | + for (int i = 1; i <= case_count; i++) { | |
| 126 | + c.reset(); | |
| 127 | + | |
| 128 | + std::stringstream url; | |
| 129 | + | |
| 130 | + url << uri << "/runCase?case=" << i << "&agent=" | |
| 131 | + << websocketpp::user_agent; | |
| 132 | + | |
| 133 | + con = c.get_connection(url.str(), ec); | |
| 134 | + | |
| 135 | + c.connect(con); | |
| 136 | + | |
| 137 | + c.run(); | |
| 138 | + } | |
| 139 | + | |
| 140 | + std::cout << "done" << std::endl; | |
| 141 | + | |
| 142 | + } catch (websocketpp::exception const & e) { | |
| 143 | + std::cout << e.what() << std::endl; | |
| 144 | + } | |
| 145 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/testee_server/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +if (ZLIB_FOUND) | |
| 6 | + | |
| 7 | +init_target (testee_server) | |
| 8 | + | |
| 9 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 10 | + | |
| 11 | +link_boost () | |
| 12 | +link_zlib() | |
| 13 | +final_target () | |
| 14 | + | |
| 15 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | |
| 16 | + | |
| 17 | +endif() | |
| 0 | 18 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/examples/testee_server/SConscript
0 → 100644
| 1 | +## Autobahn Testee Server | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] + ['z'] | |
| 18 | + prgs += env_cpp11.Program('testee_server', ["testee_server.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system'],env) + [platform_libs] + [polyfill_libs] + ['z'] | |
| 21 | + prgs += env.Program('testee_server', ["testee_server.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | ... | ... |
3rdparty/websocketpp-0.8.2/examples/testee_server/testee_server.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2015, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + * | |
| 26 | + */ | |
| 27 | + | |
| 28 | +#include <websocketpp/config/asio_no_tls.hpp> | |
| 29 | +#include <websocketpp/server.hpp> | |
| 30 | +#include <websocketpp/extensions/permessage_deflate/enabled.hpp> | |
| 31 | +#include <iostream> | |
| 32 | + | |
| 33 | +struct testee_config : public websocketpp::config::asio { | |
| 34 | + // pull default settings from our core config | |
| 35 | + typedef websocketpp::config::asio core; | |
| 36 | + | |
| 37 | + typedef core::concurrency_type concurrency_type; | |
| 38 | + typedef core::request_type request_type; | |
| 39 | + typedef core::response_type response_type; | |
| 40 | + typedef core::message_type message_type; | |
| 41 | + typedef core::con_msg_manager_type con_msg_manager_type; | |
| 42 | + typedef core::endpoint_msg_manager_type endpoint_msg_manager_type; | |
| 43 | + | |
| 44 | + typedef core::alog_type alog_type; | |
| 45 | + typedef core::elog_type elog_type; | |
| 46 | + typedef core::rng_type rng_type; | |
| 47 | + typedef core::endpoint_base endpoint_base; | |
| 48 | + | |
| 49 | + static bool const enable_multithreading = true; | |
| 50 | + | |
| 51 | + struct transport_config : public core::transport_config { | |
| 52 | + typedef core::concurrency_type concurrency_type; | |
| 53 | + typedef core::elog_type elog_type; | |
| 54 | + typedef core::alog_type alog_type; | |
| 55 | + typedef core::request_type request_type; | |
| 56 | + typedef core::response_type response_type; | |
| 57 | + | |
| 58 | + static bool const enable_multithreading = true; | |
| 59 | + }; | |
| 60 | + | |
| 61 | + typedef websocketpp::transport::asio::endpoint<transport_config> | |
| 62 | + transport_type; | |
| 63 | + | |
| 64 | + static const websocketpp::log::level elog_level = | |
| 65 | + websocketpp::log::elevel::none; | |
| 66 | + static const websocketpp::log::level alog_level = | |
| 67 | + websocketpp::log::alevel::none; | |
| 68 | + | |
| 69 | + /// permessage_compress extension | |
| 70 | + struct permessage_deflate_config {}; | |
| 71 | + | |
| 72 | + typedef websocketpp::extensions::permessage_deflate::enabled | |
| 73 | + <permessage_deflate_config> permessage_deflate_type; | |
| 74 | +}; | |
| 75 | + | |
| 76 | +typedef websocketpp::server<testee_config> server; | |
| 77 | + | |
| 78 | +using websocketpp::lib::placeholders::_1; | |
| 79 | +using websocketpp::lib::placeholders::_2; | |
| 80 | +using websocketpp::lib::bind; | |
| 81 | + | |
| 82 | +// pull out the type of messages sent by our config | |
| 83 | +typedef server::message_ptr message_ptr; | |
| 84 | + | |
| 85 | +// Define a callback to handle incoming messages | |
| 86 | +void on_message(server* s, websocketpp::connection_hdl hdl, message_ptr msg) { | |
| 87 | + s->send(hdl, msg->get_payload(), msg->get_opcode()); | |
| 88 | +} | |
| 89 | + | |
| 90 | +void on_socket_init(websocketpp::connection_hdl, boost::asio::ip::tcp::socket & s) { | |
| 91 | + boost::asio::ip::tcp::no_delay option(true); | |
| 92 | + s.set_option(option); | |
| 93 | +} | |
| 94 | + | |
| 95 | +int main(int argc, char * argv[]) { | |
| 96 | + // Create a server endpoint | |
| 97 | + server testee_server; | |
| 98 | + | |
| 99 | + short port = 9002; | |
| 100 | + size_t num_threads = 1; | |
| 101 | + | |
| 102 | + if (argc == 3) { | |
| 103 | + port = atoi(argv[1]); | |
| 104 | + num_threads = atoi(argv[2]); | |
| 105 | + } | |
| 106 | + | |
| 107 | + try { | |
| 108 | + // Total silence | |
| 109 | + testee_server.clear_access_channels(websocketpp::log::alevel::all); | |
| 110 | + testee_server.clear_error_channels(websocketpp::log::alevel::all); | |
| 111 | + | |
| 112 | + // Initialize ASIO | |
| 113 | + testee_server.init_asio(); | |
| 114 | + testee_server.set_reuse_addr(true); | |
| 115 | + | |
| 116 | + // Register our message handler | |
| 117 | + testee_server.set_message_handler(bind(&on_message,&testee_server,::_1,::_2)); | |
| 118 | + testee_server.set_socket_init_handler(bind(&on_socket_init,::_1,::_2)); | |
| 119 | + | |
| 120 | + // Listen on specified port with extended listen backlog | |
| 121 | + testee_server.set_listen_backlog(8192); | |
| 122 | + testee_server.listen(port); | |
| 123 | + | |
| 124 | + // Start the server accept loop | |
| 125 | + testee_server.start_accept(); | |
| 126 | + | |
| 127 | + // Start the ASIO io_service run loop | |
| 128 | + if (num_threads == 1) { | |
| 129 | + testee_server.run(); | |
| 130 | + } else { | |
| 131 | + typedef websocketpp::lib::shared_ptr<websocketpp::lib::thread> thread_ptr; | |
| 132 | + std::vector<thread_ptr> ts; | |
| 133 | + for (size_t i = 0; i < num_threads; i++) { | |
| 134 | + ts.push_back(websocketpp::lib::make_shared<websocketpp::lib::thread>(&server::run, &testee_server)); | |
| 135 | + } | |
| 136 | + | |
| 137 | + for (size_t i = 0; i < num_threads; i++) { | |
| 138 | + ts[i]->join(); | |
| 139 | + } | |
| 140 | + } | |
| 141 | + | |
| 142 | + } catch (websocketpp::exception const & e) { | |
| 143 | + std::cout << "exception: " << e.what() << std::endl; | |
| 144 | + } | |
| 145 | +} | ... | ... |
3rdparty/websocketpp-0.8.2/examples/utility_client/CMakeLists.txt
0 → 100644
| 1 | + | |
| 2 | +file (GLOB SOURCE_FILES *.cpp) | |
| 3 | +file (GLOB HEADER_FILES *.hpp) | |
| 4 | + | |
| 5 | +init_target (utility_client) | |
| 6 | + | |
| 7 | +build_executable (${TARGET_NAME} ${SOURCE_FILES} ${HEADER_FILES}) | |
| 8 | + | |
| 9 | +link_boost () | |
| 10 | +final_target () | |
| 11 | + | |
| 12 | +set_target_properties(${TARGET_NAME} PROPERTIES FOLDER "examples") | |
| 13 | + | ... | ... |
3rdparty/websocketpp-0.8.2/examples/utility_client/SConscript
0 → 100644
| 1 | +## Utility client example | |
| 2 | +## | |
| 3 | + | |
| 4 | +Import('env') | |
| 5 | +Import('env_cpp11') | |
| 6 | +Import('boostlibs') | |
| 7 | +Import('platform_libs') | |
| 8 | +Import('polyfill_libs') | |
| 9 | + | |
| 10 | +env = env.Clone () | |
| 11 | +env_cpp11 = env_cpp11.Clone () | |
| 12 | + | |
| 13 | +prgs = [] | |
| 14 | + | |
| 15 | +# if a C++11 environment is available build using that, otherwise use boost | |
| 16 | +if env_cpp11.has_key('WSPP_CPP11_ENABLED'): | |
| 17 | + ALL_LIBS = boostlibs(['system'],env_cpp11) + [platform_libs] + [polyfill_libs] | |
| 18 | + prgs += env_cpp11.Program('utility_client', ["utility_client.cpp"], LIBS = ALL_LIBS) | |
| 19 | +else: | |
| 20 | + ALL_LIBS = boostlibs(['system','random'],env) + [platform_libs] + [polyfill_libs] | |
| 21 | + prgs += env.Program('utility_client', ["utility_client.cpp"], LIBS = ALL_LIBS) | |
| 22 | + | |
| 23 | +Return('prgs') | |
| 0 | 24 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/examples/utility_client/utility_client.cpp
0 → 100644
| 1 | +/* | |
| 2 | + * Copyright (c) 2014, Peter Thorson. All rights reserved. | |
| 3 | + * | |
| 4 | + * Redistribution and use in source and binary forms, with or without | |
| 5 | + * modification, are permitted provided that the following conditions are met: | |
| 6 | + * * Redistributions of source code must retain the above copyright | |
| 7 | + * notice, this list of conditions and the following disclaimer. | |
| 8 | + * * Redistributions in binary form must reproduce the above copyright | |
| 9 | + * notice, this list of conditions and the following disclaimer in the | |
| 10 | + * documentation and/or other materials provided with the distribution. | |
| 11 | + * * Neither the name of the WebSocket++ Project nor the | |
| 12 | + * names of its contributors may be used to endorse or promote products | |
| 13 | + * derived from this software without specific prior written permission. | |
| 14 | + * | |
| 15 | + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" | |
| 16 | + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
| 17 | + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
| 18 | + * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY | |
| 19 | + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
| 20 | + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
| 21 | + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |
| 22 | + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 23 | + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | |
| 24 | + * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 25 | + */ | |
| 26 | + | |
| 27 | +// **NOTE:** This file is a snapshot of the WebSocket++ utility client tutorial. | |
| 28 | +// Additional related material can be found in the tutorials/utility_client | |
| 29 | +// directory of the WebSocket++ repository. | |
| 30 | + | |
| 31 | +#include <websocketpp/config/asio_no_tls_client.hpp> | |
| 32 | +#include <websocketpp/client.hpp> | |
| 33 | + | |
| 34 | +#include <websocketpp/common/thread.hpp> | |
| 35 | +#include <websocketpp/common/memory.hpp> | |
| 36 | + | |
| 37 | +#include <cstdlib> | |
| 38 | +#include <iostream> | |
| 39 | +#include <map> | |
| 40 | +#include <string> | |
| 41 | +#include <sstream> | |
| 42 | + | |
| 43 | +typedef websocketpp::client<websocketpp::config::asio_client> client; | |
| 44 | + | |
| 45 | +class connection_metadata { | |
| 46 | +public: | |
| 47 | + typedef websocketpp::lib::shared_ptr<connection_metadata> ptr; | |
| 48 | + | |
| 49 | + connection_metadata(int id, websocketpp::connection_hdl hdl, std::string uri) | |
| 50 | + : m_id(id) | |
| 51 | + , m_hdl(hdl) | |
| 52 | + , m_status("Connecting") | |
| 53 | + , m_uri(uri) | |
| 54 | + , m_server("N/A") | |
| 55 | + {} | |
| 56 | + | |
| 57 | + void on_open(client * c, websocketpp::connection_hdl hdl) { | |
| 58 | + m_status = "Open"; | |
| 59 | + | |
| 60 | + client::connection_ptr con = c->get_con_from_hdl(hdl); | |
| 61 | + m_server = con->get_response_header("Server"); | |
| 62 | + } | |
| 63 | + | |
| 64 | + void on_fail(client * c, websocketpp::connection_hdl hdl) { | |
| 65 | + m_status = "Failed"; | |
| 66 | + | |
| 67 | + client::connection_ptr con = c->get_con_from_hdl(hdl); | |
| 68 | + m_server = con->get_response_header("Server"); | |
| 69 | + m_error_reason = con->get_ec().message(); | |
| 70 | + } | |
| 71 | + | |
| 72 | + void on_close(client * c, websocketpp::connection_hdl hdl) { | |
| 73 | + m_status = "Closed"; | |
| 74 | + client::connection_ptr con = c->get_con_from_hdl(hdl); | |
| 75 | + std::stringstream s; | |
| 76 | + s << "close code: " << con->get_remote_close_code() << " (" | |
| 77 | + << websocketpp::close::status::get_string(con->get_remote_close_code()) | |
| 78 | + << "), close reason: " << con->get_remote_close_reason(); | |
| 79 | + m_error_reason = s.str(); | |
| 80 | + } | |
| 81 | + | |
| 82 | + void on_message(websocketpp::connection_hdl, client::message_ptr msg) { | |
| 83 | + if (msg->get_opcode() == websocketpp::frame::opcode::text) { | |
| 84 | + m_messages.push_back("<< " + msg->get_payload()); | |
| 85 | + } else { | |
| 86 | + m_messages.push_back("<< " + websocketpp::utility::to_hex(msg->get_payload())); | |
| 87 | + } | |
| 88 | + } | |
| 89 | + | |
| 90 | + websocketpp::connection_hdl get_hdl() const { | |
| 91 | + return m_hdl; | |
| 92 | + } | |
| 93 | + | |
| 94 | + int get_id() const { | |
| 95 | + return m_id; | |
| 96 | + } | |
| 97 | + | |
| 98 | + std::string get_status() const { | |
| 99 | + return m_status; | |
| 100 | + } | |
| 101 | + | |
| 102 | + void record_sent_message(std::string message) { | |
| 103 | + m_messages.push_back(">> " + message); | |
| 104 | + } | |
| 105 | + | |
| 106 | + friend std::ostream & operator<< (std::ostream & out, connection_metadata const & data); | |
| 107 | +private: | |
| 108 | + int m_id; | |
| 109 | + websocketpp::connection_hdl m_hdl; | |
| 110 | + std::string m_status; | |
| 111 | + std::string m_uri; | |
| 112 | + std::string m_server; | |
| 113 | + std::string m_error_reason; | |
| 114 | + std::vector<std::string> m_messages; | |
| 115 | +}; | |
| 116 | + | |
| 117 | +std::ostream & operator<< (std::ostream & out, connection_metadata const & data) { | |
| 118 | + out << "> URI: " << data.m_uri << "\n" | |
| 119 | + << "> Status: " << data.m_status << "\n" | |
| 120 | + << "> Remote Server: " << (data.m_server.empty() ? "None Specified" : data.m_server) << "\n" | |
| 121 | + << "> Error/close reason: " << (data.m_error_reason.empty() ? "N/A" : data.m_error_reason) << "\n"; | |
| 122 | + out << "> Messages Processed: (" << data.m_messages.size() << ") \n"; | |
| 123 | + | |
| 124 | + std::vector<std::string>::const_iterator it; | |
| 125 | + for (it = data.m_messages.begin(); it != data.m_messages.end(); ++it) { | |
| 126 | + out << *it << "\n"; | |
| 127 | + } | |
| 128 | + | |
| 129 | + return out; | |
| 130 | +} | |
| 131 | + | |
| 132 | +class websocket_endpoint { | |
| 133 | +public: | |
| 134 | + websocket_endpoint () : m_next_id(0) { | |
| 135 | + m_endpoint.clear_access_channels(websocketpp::log::alevel::all); | |
| 136 | + m_endpoint.clear_error_channels(websocketpp::log::elevel::all); | |
| 137 | + | |
| 138 | + m_endpoint.init_asio(); | |
| 139 | + m_endpoint.start_perpetual(); | |
| 140 | + | |
| 141 | + m_thread = websocketpp::lib::make_shared<websocketpp::lib::thread>(&client::run, &m_endpoint); | |
| 142 | + } | |
| 143 | + | |
| 144 | + ~websocket_endpoint() { | |
| 145 | + m_endpoint.stop_perpetual(); | |
| 146 | + | |
| 147 | + for (con_list::const_iterator it = m_connection_list.begin(); it != m_connection_list.end(); ++it) { | |
| 148 | + if (it->second->get_status() != "Open") { | |
| 149 | + // Only close open connections | |
| 150 | + continue; | |
| 151 | + } | |
| 152 | + | |
| 153 | + std::cout << "> Closing connection " << it->second->get_id() << std::endl; | |
| 154 | + | |
| 155 | + websocketpp::lib::error_code ec; | |
| 156 | + m_endpoint.close(it->second->get_hdl(), websocketpp::close::status::going_away, "", ec); | |
| 157 | + if (ec) { | |
| 158 | + std::cout << "> Error closing connection " << it->second->get_id() << ": " | |
| 159 | + << ec.message() << std::endl; | |
| 160 | + } | |
| 161 | + } | |
| 162 | + | |
| 163 | + m_thread->join(); | |
| 164 | + } | |
| 165 | + | |
| 166 | + int connect(std::string const & uri) { | |
| 167 | + websocketpp::lib::error_code ec; | |
| 168 | + | |
| 169 | + client::connection_ptr con = m_endpoint.get_connection(uri, ec); | |
| 170 | + | |
| 171 | + if (ec) { | |
| 172 | + std::cout << "> Connect initialization error: " << ec.message() << std::endl; | |
| 173 | + return -1; | |
| 174 | + } | |
| 175 | + | |
| 176 | + int new_id = m_next_id++; | |
| 177 | + connection_metadata::ptr metadata_ptr = websocketpp::lib::make_shared<connection_metadata>(new_id, con->get_handle(), uri); | |
| 178 | + m_connection_list[new_id] = metadata_ptr; | |
| 179 | + | |
| 180 | + con->set_open_handler(websocketpp::lib::bind( | |
| 181 | + &connection_metadata::on_open, | |
| 182 | + metadata_ptr, | |
| 183 | + &m_endpoint, | |
| 184 | + websocketpp::lib::placeholders::_1 | |
| 185 | + )); | |
| 186 | + con->set_fail_handler(websocketpp::lib::bind( | |
| 187 | + &connection_metadata::on_fail, | |
| 188 | + metadata_ptr, | |
| 189 | + &m_endpoint, | |
| 190 | + websocketpp::lib::placeholders::_1 | |
| 191 | + )); | |
| 192 | + con->set_close_handler(websocketpp::lib::bind( | |
| 193 | + &connection_metadata::on_close, | |
| 194 | + metadata_ptr, | |
| 195 | + &m_endpoint, | |
| 196 | + websocketpp::lib::placeholders::_1 | |
| 197 | + )); | |
| 198 | + con->set_message_handler(websocketpp::lib::bind( | |
| 199 | + &connection_metadata::on_message, | |
| 200 | + metadata_ptr, | |
| 201 | + websocketpp::lib::placeholders::_1, | |
| 202 | + websocketpp::lib::placeholders::_2 | |
| 203 | + )); | |
| 204 | + | |
| 205 | + m_endpoint.connect(con); | |
| 206 | + | |
| 207 | + return new_id; | |
| 208 | + } | |
| 209 | + | |
| 210 | + void close(int id, websocketpp::close::status::value code, std::string reason) { | |
| 211 | + websocketpp::lib::error_code ec; | |
| 212 | + | |
| 213 | + con_list::iterator metadata_it = m_connection_list.find(id); | |
| 214 | + if (metadata_it == m_connection_list.end()) { | |
| 215 | + std::cout << "> No connection found with id " << id << std::endl; | |
| 216 | + return; | |
| 217 | + } | |
| 218 | + | |
| 219 | + m_endpoint.close(metadata_it->second->get_hdl(), code, reason, ec); | |
| 220 | + if (ec) { | |
| 221 | + std::cout << "> Error initiating close: " << ec.message() << std::endl; | |
| 222 | + } | |
| 223 | + } | |
| 224 | + | |
| 225 | + void send(int id, std::string message) { | |
| 226 | + websocketpp::lib::error_code ec; | |
| 227 | + | |
| 228 | + con_list::iterator metadata_it = m_connection_list.find(id); | |
| 229 | + if (metadata_it == m_connection_list.end()) { | |
| 230 | + std::cout << "> No connection found with id " << id << std::endl; | |
| 231 | + return; | |
| 232 | + } | |
| 233 | + | |
| 234 | + m_endpoint.send(metadata_it->second->get_hdl(), message, websocketpp::frame::opcode::text, ec); | |
| 235 | + if (ec) { | |
| 236 | + std::cout << "> Error sending message: " << ec.message() << std::endl; | |
| 237 | + return; | |
| 238 | + } | |
| 239 | + | |
| 240 | + metadata_it->second->record_sent_message(message); | |
| 241 | + } | |
| 242 | + | |
| 243 | + connection_metadata::ptr get_metadata(int id) const { | |
| 244 | + con_list::const_iterator metadata_it = m_connection_list.find(id); | |
| 245 | + if (metadata_it == m_connection_list.end()) { | |
| 246 | + return connection_metadata::ptr(); | |
| 247 | + } else { | |
| 248 | + return metadata_it->second; | |
| 249 | + } | |
| 250 | + } | |
| 251 | +private: | |
| 252 | + typedef std::map<int,connection_metadata::ptr> con_list; | |
| 253 | + | |
| 254 | + client m_endpoint; | |
| 255 | + websocketpp::lib::shared_ptr<websocketpp::lib::thread> m_thread; | |
| 256 | + | |
| 257 | + con_list m_connection_list; | |
| 258 | + int m_next_id; | |
| 259 | +}; | |
| 260 | + | |
| 261 | +int main() { | |
| 262 | + bool done = false; | |
| 263 | + std::string input; | |
| 264 | + websocket_endpoint endpoint; | |
| 265 | + | |
| 266 | + while (!done) { | |
| 267 | + std::cout << "Enter Command: "; | |
| 268 | + std::getline(std::cin, input); | |
| 269 | + | |
| 270 | + if (input == "quit") { | |
| 271 | + done = true; | |
| 272 | + } else if (input == "help") { | |
| 273 | + std::cout | |
| 274 | + << "\nCommand List:\n" | |
| 275 | + << "connect <ws uri>\n" | |
| 276 | + << "send <connection id> <message>\n" | |
| 277 | + << "close <connection id> [<close code:default=1000>] [<close reason>]\n" | |
| 278 | + << "show <connection id>\n" | |
| 279 | + << "help: Display this help text\n" | |
| 280 | + << "quit: Exit the program\n" | |
| 281 | + << std::endl; | |
| 282 | + } else if (input.substr(0,7) == "connect") { | |
| 283 | + int id = endpoint.connect(input.substr(8)); | |
| 284 | + if (id != -1) { | |
| 285 | + std::cout << "> Created connection with id " << id << std::endl; | |
| 286 | + } | |
| 287 | + } else if (input.substr(0,4) == "send") { | |
| 288 | + std::stringstream ss(input); | |
| 289 | + | |
| 290 | + std::string cmd; | |
| 291 | + int id; | |
| 292 | + std::string message; | |
| 293 | + | |
| 294 | + ss >> cmd >> id; | |
| 295 | + std::getline(ss,message); | |
| 296 | + | |
| 297 | + endpoint.send(id, message); | |
| 298 | + } else if (input.substr(0,5) == "close") { | |
| 299 | + std::stringstream ss(input); | |
| 300 | + | |
| 301 | + std::string cmd; | |
| 302 | + int id; | |
| 303 | + int close_code = websocketpp::close::status::normal; | |
| 304 | + std::string reason; | |
| 305 | + | |
| 306 | + ss >> cmd >> id >> close_code; | |
| 307 | + std::getline(ss,reason); | |
| 308 | + | |
| 309 | + endpoint.close(id, close_code, reason); | |
| 310 | + } else if (input.substr(0,4) == "show") { | |
| 311 | + int id = atoi(input.substr(5).c_str()); | |
| 312 | + | |
| 313 | + connection_metadata::ptr metadata = endpoint.get_metadata(id); | |
| 314 | + if (metadata) { | |
| 315 | + std::cout << *metadata << std::endl; | |
| 316 | + } else { | |
| 317 | + std::cout << "> Unknown connection id " << id << std::endl; | |
| 318 | + } | |
| 319 | + } else { | |
| 320 | + std::cout << "> Unrecognized Command" << std::endl; | |
| 321 | + } | |
| 322 | + } | |
| 323 | + | |
| 324 | + return 0; | |
| 325 | +} | |
| 0 | 326 | \ No newline at end of file | ... | ... |
3rdparty/websocketpp-0.8.2/readme.md
0 → 100644
| 1 | +WebSocket++ (0.8.2) | |
| 2 | +========================== | |
| 3 | + | |
| 4 | +WebSocket++ is a header only C++ library that implements RFC6455 The WebSocket | |
| 5 | +Protocol. It allows integrating WebSocket client and server functionality into | |
| 6 | +C++ programs. It uses interchangeable network transport modules including one | |
| 7 | +based on raw char buffers, one based on C++ iostreams, and one based on Asio | |
| 8 | +(either via Boost or standalone). End users can write additional transport | |
| 9 | +policies to support other networking or event libraries as needed. | |
| 10 | + | |
| 11 | +Major Features | |
| 12 | +============== | |
| 13 | +* Full support for RFC6455 | |
| 14 | +* Partial support for Hixie 76 / Hybi 00, 07-17 draft specs (server only) | |
| 15 | +* Message/event based interface | |
| 16 | +* Supports secure WebSockets (TLS), IPv6, and explicit proxies. | |
| 17 | +* Flexible dependency management (C++11 Standard Library or Boost) | |
| 18 | +* Interchangeable network transport modules (raw, iostream, Asio, or custom) | |
| 19 | +* Portable/cross platform (Posix/Windows, 32/64bit, Intel/ARM/PPC) | |
| 20 | +* Thread-safe | |
| 21 | + | |
| 22 | +Get Involved | |
| 23 | +============ | |
| 24 | + | |
| 25 | +[](https://travis-ci.org/zaphoyd/websocketpp) | |
| 26 | + | |
| 27 | +**Project Website** | |
| 28 | +http://www.zaphoyd.com/websocketpp/ | |
| 29 | + | |
| 30 | +**User Manual** | |
| 31 | +http://docs.websocketpp.org/ | |
| 32 | + | |
| 33 | +**GitHub Repository** | |
| 34 | +https://github.com/zaphoyd/websocketpp/ | |
| 35 | + | |
| 36 | +GitHub pull requests should be submitted to the `develop` branch. | |
| 37 | + | |
| 38 | +**Announcements Mailing List** | |
| 39 | +http://groups.google.com/group/websocketpp-announcements/ | |
| 40 | + | |
| 41 | +**IRC Channel** | |
| 42 | + #websocketpp (freenode) | |
| 43 | + | |
| 44 | +**Discussion / Development / Support Mailing List / Forum** | |
| 45 | +http://groups.google.com/group/websocketpp/ | |
| 46 | + | |
| 47 | +Author | |
| 48 | +====== | |
| 49 | +Peter Thorson - websocketpp@zaphoyd.com | ... | ... |
3rdparty/websocketpp-0.8.2/release/include/websocketpp/base64/base64.hpp
0 → 100644
| 1 | +/* | |
| 2 | + ****** | |
| 3 | + base64.hpp is a repackaging of the base64.cpp and base64.h files into a | |
| 4 | + single header suitable for use as a header only library. This conversion was | |
| 5 | + done by Peter Thorson (webmaster@zaphoyd.com) in 2012. All modifications to | |
| 6 | + the code are redistributed under the same license as the original, which is | |
| 7 | + listed below. | |
| 8 | + ****** | |
| 9 | + | |
| 10 | + base64.cpp and base64.h | |
| 11 | + | |
| 12 | + Copyright (C) 2004-2008 René Nyffenegger | |
| 13 | + | |
| 14 | + This source code is provided 'as-is', without any express or implied | |
| 15 | + warranty. In no event will the author be held liable for any damages | |
| 16 | + arising from the use of this software. | |
| 17 | + | |
| 18 | + Permission is granted to anyone to use this software for any purpose, | |
| 19 | + including commercial applications, and to alter it and redistribute it | |
| 20 | + freely, subject to the following restrictions: | |
| 21 | + | |
| 22 | + 1. The origin of this source code must not be misrepresented; you must not | |
| 23 | + claim that you wrote the original source code. If you use this source code | |
| 24 | + in a product, an acknowledgment in the product documentation would be | |
| 25 | + appreciated but is not required. | |
| 26 | + | |
| 27 | + 2. Altered source versions must be plainly marked as such, and must not be | |
| 28 | + misrepresented as being the original source code. | |
| 29 | + | |
| 30 | + 3. This notice may not be removed or altered from any source distribution. | |
| 31 | + | |
| 32 | + René Nyffenegger rene.nyffenegger@adp-gmbh.ch | |
| 33 | + | |
| 34 | +*/ | |
| 35 | + | |
| 36 | +#ifndef _BASE64_HPP_ | |
| 37 | +#define _BASE64_HPP_ | |
| 38 | + | |
| 39 | +#include <string> | |
| 40 | + | |
| 41 | +namespace websocketpp { | |
| 42 | + | |
| 43 | +static std::string const base64_chars = | |
| 44 | + "ABCDEFGHIJKLMNOPQRSTUVWXYZ" | |
| 45 | + "abcdefghijklmnopqrstuvwxyz" | |
| 46 | + "0123456789+/"; | |
| 47 | + | |
| 48 | +/// Test whether a character is a valid base64 character | |
| 49 | +/** | |
| 50 | + * @param c The character to test | |
| 51 | + * @return true if c is a valid base64 character | |
| 52 | + */ | |
| 53 | +static inline bool is_base64(unsigned char c) { | |
| 54 | + return (c == 43 || // + | |
| 55 | + (c >= 47 && c <= 57) || // /-9 | |
| 56 | + (c >= 65 && c <= 90) || // A-Z | |
| 57 | + (c >= 97 && c <= 122)); // a-z | |
| 58 | +} | |
| 59 | + | |
| 60 | +/// Encode a char buffer into a base64 string | |
| 61 | +/** | |
| 62 | + * @param input The input data | |
| 63 | + * @param len The length of input in bytes | |
| 64 | + * @return A base64 encoded string representing input | |
| 65 | + */ | |
| 66 | +inline std::string base64_encode(unsigned char const * input, size_t len) { | |
| 67 | + std::string ret; | |
| 68 | + int i = 0; | |
| 69 | + int j = 0; | |
| 70 | + unsigned char char_array_3[3]; | |
| 71 | + unsigned char char_array_4[4]; | |
| 72 | + | |
| 73 | + while (len--) { | |
| 74 | + char_array_3[i++] = *(input++); | |
| 75 | + if (i == 3) { | |
| 76 | + char_array_4[0] = (char_array_3[0] & 0xfc) >> 2; | |
| 77 | + char_array_4[1] = ((char_array_3[0] & 0x03) << 4) + | |
| 78 | + ((char_array_3[1] & 0xf0) >> 4); | |
| 79 | + char_array_4[2] = ((char_array_3[1] & 0x0f) << 2) + | |
| 80 | + ((char_array_3[2] & 0xc0) >> 6); | |
| 81 | + char_array_4[3] = char_array_3[2] & 0x3f; | |
| 82 | + | |
| 83 | + for(i = 0; (i <4) ; i++) { | |
| 84 | + ret += base64_chars[char_array_4[i]]; | |
| 85 | + } | |
| 86 | + i = 0; | |
| 87 | + } | |
| 88 | + } | |
| 89 | + | |
| 90 | + if (i) { | |
| 91 | + for(j = i; j < 3; j++) { | |
| 92 | + char_array_3[j] = '\0'; | |
| 93 | + } | |
| 94 | + | |
| 95 | + char_array_4[0] = (char_array_3[0] & 0xfc) >> 2; | |
| 96 | + char_array_4[1] = ((char_array_3[0] & 0x03) << 4) + | |
| 97 | + ((char_array_3[1] & 0xf0) >> 4); | |
| 98 | + char_array_4[2] = ((char_array_3[1] & 0x0f) << 2) + | |
| 99 | + ((char_array_3[2] & 0xc0) >> 6); | |
| 100 | + char_array_4[3] = char_array_3[2] & 0x3f; | |
| 101 | + | |
| 102 | + for (j = 0; (j < i + 1); j++) { | |
| 103 | + ret += base64_chars[char_array_4[j]]; | |
| 104 | + } | |
| 105 | + | |
| 106 | + while((i++ < 3)) { | |
| 107 | + ret += '='; | |
| 108 | + } | |
| 109 | + } | |
| 110 | + | |
| 111 | + return ret; | |
| 112 | +} | |
| 113 | + | |
| 114 | +/// Encode a string into a base64 string | |
| 115 | +/** | |
| 116 | + * @param input The input data | |
| 117 | + * @return A base64 encoded string representing input | |
| 118 | + */ | |
| 119 | +inline std::string base64_encode(std::string const & input) { | |
| 120 | + return base64_encode( | |
| 121 | + reinterpret_cast<const unsigned char *>(input.data()), | |
| 122 | + input.size() | |
| 123 | + ); | |
| 124 | +} | |
| 125 | + | |
| 126 | +/// Decode a base64 encoded string into a string of raw bytes | |
| 127 | +/** | |
| 128 | + * @param input The base64 encoded input data | |
| 129 | + * @return A string representing the decoded raw bytes | |
| 130 | + */ | |
| 131 | +inline std::string base64_decode(std::string const & input) { | |
| 132 | + size_t in_len = input.size(); | |
| 133 | + int i = 0; | |
| 134 | + int j = 0; | |
| 135 | + int in_ = 0; | |
| 136 | + unsigned char char_array_4[4], char_array_3[3]; | |
| 137 | + std::string ret; | |
| 138 | + | |
| 139 | + while (in_len-- && ( input[in_] != '=') && is_base64(input[in_])) { | |
| 140 | + char_array_4[i++] = input[in_]; in_++; | |
| 141 | + if (i ==4) { | |
| 142 | + for (i = 0; i <4; i++) { | |
| 143 | + char_array_4[i] = static_cast<unsigned char>(base64_chars.find(char_array_4[i])); | |
| 144 | + } | |
| 145 | + | |
| 146 | + char_array_3[0] = (char_array_4[0] << 2) + ((char_array_4[1] & 0x30) >> 4); | |
| 147 | + char_array_3[1] = ((char_array_4[1] & 0xf) << 4) + ((char_array_4[2] & 0x3c) >> 2); | |
| 148 | + char_array_3[2] = ((char_array_4[2] & 0x3) << 6) + char_array_4[3]; | |
| 149 | + | |
| 150 | + for (i = 0; (i < 3); i++) { | |
| 151 | + ret += char_array_3[i]; | |
| 152 | + } | |
| 153 | + i = 0; | |
| 154 | + } | |
| 155 | + } | |
| 156 | + | |
| 157 | + if (i) { | |
| 158 | + for (j = i; j <4; j++) | |
| 159 | + char_array_4[j] = 0; | |
| 160 | + | |
| 161 | + for (j = 0; j <4; j++) | |
| 162 | + char_array_4[j] = static_cast<unsigned char>(base64_chars.find(char_array_4[j])); | |
| 163 | + | |
| 164 | + char_array_3[0] = (char_array_4[0] << 2) + ((char_array_4[1] & 0x30) >> 4); | |
| 165 | + char_array_3[1] = ((char_array_4[1] & 0xf) << 4) + ((char_array_4[2] & 0x3c) >> 2); | |
| 166 | + char_array_3[2] = ((char_array_4[2] & 0x3) << 6) + char_array_4[3]; | |
| 167 | + | |
| 168 | + for (j = 0; (j < i - 1); j++) { | |
| 169 | + ret += static_cast<std::string::value_type>(char_array_3[j]); | |
| 170 | + } | |
| 171 | + } | |
| 172 | + | |
| 173 | + return ret; | |
| 174 | +} | |
| 175 | + | |
| 176 | +} // namespace websocketpp | |
| 177 | + | |
| 178 | +#endif // _BASE64_HPP_ | ... | ... |