blob: fed8704f6b051f7bfb52db0cae93480bb8362fa4 [file] [log] [blame]
Joakim Soderberg08e434e2013-02-01 14:52:53 +01001cmake_minimum_required(VERSION 2.6)
2
3project(libwebsockets)
4
5set(PACKAGE "libwebsockets")
Joakim Soderbergb37827b2013-02-22 09:28:08 +08006set(CPACK_PACKAGE_NAME "${PACKAGE}")
7set(CPACK_PACKAGE_VERSION_MAJOR "1")
Andy Green19c1a992013-03-10 06:59:01 +08008set(CPACK_PACKAGE_VERSION_MINOR "3")
Joakim Soderbergb37827b2013-02-22 09:28:08 +08009set(CPACK_PACKAGE_VERSION "${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}")
10set(CPACK_PACKAGE_VENDOR "andy@warmcat.com")
11set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "${PACKAGE} ${PACKAGE_VERSION}")
Andy Green19c1a992013-03-10 06:59:01 +080012set(SOVERSION "4.0.0")
Joakim Soderbergb37827b2013-02-22 09:28:08 +080013set(CPACK_SOURCE_GENERATOR "TGZ")
14set(CPACK_SOURCE_PACKAGE_FILE_NAME "${CPACK_PACKAGE_NAME}-${CPACK_PACKAGE_VERSION}")
15set(VERSION "${CPACK_PACKAGE_VERSION}")
Joakim Soderberg08e434e2013-02-01 14:52:53 +010016
Joakim Soderbergb37827b2013-02-22 09:28:08 +080017set(LWS_LIBRARY_VERSION ${CPACK_PACKAGE_VERSION})
Edwin van den Oetelaard6bf73c2013-02-18 20:20:05 +080018set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${PROJECT_SOURCE_DIR}/cmake/")
Joakim Soderberg4c531232013-02-06 15:26:58 +090019
Andy Green5b479ac2013-03-30 10:30:03 +080020message(STATUS "CMAKE_TOOLCHAIN_FILE='${CMAKE_TOOLCHAIN_FILE}'")
21
Joakim Soderberg4c531232013-02-06 15:26:58 +090022# Try to find the current Git hash.
23find_package(Git)
24if(GIT_EXECUTABLE)
25 execute_process(
26 COMMAND "${GIT_EXECUTABLE}" log -n 1 --pretty=%h
27 OUTPUT_VARIABLE GIT_HASH
28 OUTPUT_STRIP_TRAILING_WHITESPACE
29 )
30
31 set(LWS_BUILD_HASH ${GIT_HASH})
32 message("Git commit hash: ${LWS_BUILD_HASH}")
33endif()
34
Joakim Soderbergadd39262013-02-06 15:25:26 +090035option(WITH_SSL "Include SSL support (default OpenSSL, CyaSSL if USE_CYASSL is set)" ON)
Joakim Soderberg4c531232013-02-06 15:26:58 +090036option(USE_EXTERNAL_ZLIB "Search the system for ZLib instead of using the included one (on Windows)" OFF)
Joakim Soderberg7df99082013-02-07 20:24:19 +080037option(USE_CYASSL "Use CyaSSL replacement for OpenSSL. When settings this, you also need to specify CYASSL_LIB and CYASSL_INCLUDE_DIRS" OFF)
Joakim Soderbergfcec61c2013-02-22 09:28:02 +080038option(WITHOUT_BUILTIN_GETIFADDRS "Don't use BSD getifaddrs implementation from libwebsockets if it is missing (this will result in a compilation error) ... Default is your libc provides it. On some systems such as uclibc it doesn't exist." OFF)
Joakim Soderbergadd39262013-02-06 15:25:26 +090039option(WITHOUT_CLIENT "Don't build the client part of the library" OFF)
40option(WITHOUT_SERVER "Don't build the server part of the library" OFF)
Joakim Soderberg7eadd582013-02-22 09:28:04 +080041#option(WITH_LIBCRYPTO "Use libcrypto MD5 and SHA1 implementations" ON)
Joakim Soderbergb37827b2013-02-22 09:28:08 +080042option(LINK_TESTAPPS_DYNAMIC "Link the test apps to the shared version of the library. Default is to link statically" OFF)
Joakim Soderberg7eadd582013-02-22 09:28:04 +080043option(WITHOUT_TESTAPPS "Don't build the libwebsocket-test-apps" OFF)
44option(WITHOUT_TEST_SERVER "Don't build the test server" OFF)
45option(WITHOUT_TEST_SERVER_EXTPOLL "Don't build the test server version that uses external poll" OFF)
46option(WITHOUT_TEST_PING "Don't build the ping test application" OFF)
47option(WITHOUT_TEST_CLIENT "Don't build the client test application" OFF)
48option(WITHOUT_TEST_FRAGGLE "Don't build the ping test application" OFF)
Joakim Soderbergadd39262013-02-06 15:25:26 +090049option(WITHOUT_DEBUG "Don't compile debug related code" OFF)
Joakim Soderbergd2edfec2013-02-06 15:27:27 +090050option(WITHOUT_EXTENSIONS "Don't compile with extensions" OFF)
51option(WITH_LATENCY "Build latency measuring code into the library" OFF)
52option(WITHOUT_DAEMONIZE "Don't build the daemonization api" OFF)
Joakim Soderbergadd39262013-02-06 15:25:26 +090053
Joakim Soderberg7eadd582013-02-22 09:28:04 +080054if (WITHOUT_CLIENT AND WITHOUT_SERVER)
55 message(FATAL_ERROR "Makes no sense to compile without both client or server.")
56endif()
57
Joakim Soderbergb37827b2013-02-22 09:28:08 +080058# The base dir where the test-apps look for the SSL certs.
Joakim Soderbergd2edfec2013-02-06 15:27:27 +090059set(SSL_CERT_DIR CACHE STRING "")
60set(SSL_CLIENT_CERT_DIR CACHE STRING "")
61
62if ("${SSL_CERT_DIR}" STREQUAL "")
Joakim Soderbergb37827b2013-02-22 09:28:08 +080063 set(SSL_CERT_DIR "../share")
Joakim Soderbergd2edfec2013-02-06 15:27:27 +090064endif()
65
66if ("${SSL_CLIENT_CERT_DIR}" STREQUAL "")
Joakim Söderberg6ac97092013-02-19 10:14:37 +080067 if (WIN32)
68 set(LWS_OPENSSL_CLIENT_CERTS ".")
69 else()
70 set(LWS_OPENSSL_CLIENT_CERTS "/etc/pki/tls/certs/")
71 endif()
Joakim Soderbergd2edfec2013-02-06 15:27:27 +090072else()
73 set(LWS_OPENSSL_CLIENT_CERTS "${SSL_CLIENT_CERT_DIR}")
74endif()
75
76set(CYASSL_LIB CACHE STRING "")
77set(CYASSL_INCLUDE_DIRS CACHE STRING "")
Joakim Soderberg08e434e2013-02-01 14:52:53 +010078
Joakim Soderbergadd39262013-02-06 15:25:26 +090079if (USE_CYASSL)
Joakim Soderbergd2edfec2013-02-06 15:27:27 +090080 if ("${CYASSL_LIB}" STREQUAL "" OR "${CYASSL_INCLUDE_DIRS}" STREQUAL "")
Joakim Soderberge9a42112013-02-06 15:29:59 +090081 message(FATAL_ERROR "You must set CYASSL_LIB and CYASSL_INCLUDE_DIRS when USE_CYASSL is turned on")
Joakim Soderbergadd39262013-02-06 15:25:26 +090082 endif()
83endif()
84
Joakim Soderbergd2edfec2013-02-06 15:27:27 +090085if (WITHOUT_EXTENSIONS)
86 set(LWS_NO_EXTENSIONS 1)
87endif()
88
89if (WITH_SSL)
90 set(LWS_OPENSSL_SUPPORT 1)
91endif()
92
93if (WITH_LATENCY)
94 set(LWS_LATENCY 1)
95endif()
96
97if (WITHOUT_DAEMONIZE)
98 set(LWS_NO_DAEMONIZE 1)
99endif()
100
Joakim Soderberge9a42112013-02-06 15:29:59 +0900101if (WITHOUT_SERVER)
102 set(LWS_NO_SERVER 1)
103endif()
104
105if (WITHOUT_CLIENT)
106 set(LWS_NO_CLIENT 1)
107endif()
108
Joakim Söderberg51197c02013-02-22 09:28:13 +0800109if (WITHOUT_DEBUG)
110 set(_DEBUG 0)
111else()
112 set(_DEBUG 1)
113endif()
114
Joakim Soderbergd2edfec2013-02-06 15:27:27 +0900115if (MINGW)
116 set(LWS_MINGW_SUPPORT 1)
117endif()
118
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100119include_directories(${PROJECT_BINARY_DIR})
120
Joakim Soderberg4f4a38b2013-02-06 15:28:07 +0900121include(CheckCSourceCompiles)
122
123# Check for different inline keyword versions.
124foreach(KEYWORD "inline" "__inline__" "__inline")
125 set(CMAKE_REQUIRED_DEFINITIONS "-DKEYWORD=${KEYWORD}")
126 CHECK_C_SOURCE_COMPILES(
127 "
128 #include <stdio.h>
129 KEYWORD void a() {}
130 int main(int argc, char **argv) { a(); return 0; }
131 " HAVE_${KEYWORD})
132endforeach()
133
134if (NOT HAVE_inline)
135 if (HAVE___inline__)
136 set(inline __inline__)
137 elseif(HAVE___inline)
138 set(inline __inline)
139 endif()
140endif()
141
Joakim Soderberg4c531232013-02-06 15:26:58 +0900142# Put the libaries and binaries that get built into directories at the
143# top of the build tree rather than in hard-to-find leaf directories.
144SET(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin)
145SET(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib)
146SET(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib)
147
thinkskid34bae12013-04-16 19:48:05 +0800148# Put absolute path of dynamic libraries into the object code. Some
149# architectures, notably Mac OS X, need this.
150SET(CMAKE_INSTALL_NAME_DIR ${CMAKE_INSTALL_PREFIX}/lib${LIB_SUFFIX})
151
Joakim Soderberg4c531232013-02-06 15:26:58 +0900152# So we can include the CMake generated config file only when
153# building with CMAKE.
154add_definitions(-DCMAKE_BUILD)
155
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100156include(CheckFunctionExists)
157include(CheckIncludeFile)
158include(CheckIncludeFiles)
159include(CheckLibraryExists)
160
161CHECK_FUNCTION_EXISTS(bzero HAVE_BZERO)
162CHECK_FUNCTION_EXISTS(fork HAVE_FORK)
163CHECK_FUNCTION_EXISTS(malloc HAVE_MALLOC)
164CHECK_FUNCTION_EXISTS(memset HAVE_MEMSET)
165CHECK_FUNCTION_EXISTS(realloc HAVE_REALLOC)
166CHECK_FUNCTION_EXISTS(socket HAVE_SOCKET)
167CHECK_FUNCTION_EXISTS(strerror HAVE_STRERROR)
168CHECK_FUNCTION_EXISTS(vfork HAVE_VFORK)
169CHECK_FUNCTION_EXISTS(getifaddrs HAVE_GETIFADDRS)
170
Joakim Soderbergfcec61c2013-02-22 09:28:02 +0800171if (NOT HAVE_GETIFADDRS)
172 if (WITHOUT_BUILTIN_GETIFADDRS)
173 message(FATAL_ERROR "No getifaddrs was found on the system. Turn off the WITHOUT_BUILTIN_GETIFADDRS compile option to use the supplied BSD version.")
Joakim Soderbergd2edfec2013-02-06 15:27:27 +0900174 endif()
Joakim Soderbergfcec61c2013-02-22 09:28:02 +0800175
Joakim Soderbergd2edfec2013-02-06 15:27:27 +0900176 set(LWS_BUILTIN_GETIFADDRS 1)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900177endif()
178
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100179CHECK_INCLUDE_FILE(dlfcn.h HAVE_DLFCN_H)
180CHECK_INCLUDE_FILE(fcntl.h HAVE_FCNTL_H)
181CHECK_INCLUDE_FILE(inttypes.h HAVE_INTTYPES_H)
182CHECK_INCLUDE_FILE(memory.h HAVE_MEMORY_H)
183CHECK_INCLUDE_FILE(netinet/in.h HAVE_NETINET_IN_H)
184CHECK_INCLUDE_FILE(stdint.h HAVE_STDINT_H)
185CHECK_INCLUDE_FILE(stdlib.h HAVE_STDLIB_H)
186CHECK_INCLUDE_FILE(strings.h HAVE_STRINGS_H)
187CHECK_INCLUDE_FILE(string.h HAVE_STRING_H)
188CHECK_INCLUDE_FILE(sys/prctl.h HAVE_SYS_PRCTL_H)
189CHECK_INCLUDE_FILE(sys/socket.h HAVE_SYS_SOCKET_H)
190CHECK_INCLUDE_FILE(sys/stat.h HAVE_SYS_STAT_H)
191CHECK_INCLUDE_FILE(sys/types.h HAVE_SYS_TYPES_H)
192CHECK_INCLUDE_FILE(unistd.h HAVE_UNISTD_H)
193CHECK_INCLUDE_FILE(vfork.h HAVE_VFORK_H)
194CHECK_INCLUDE_FILE(zlib.h HAVE_ZLIB_H)
195
196# TODO: These can be tested if they actually work also...
197set(HAVE_WORKING_FORK HAVE_FORK)
198set(HAVE_WORKING_VFORK HAVE_VFORK)
199
200CHECK_INCLUDE_FILES("stdlib.h;stdarg.h;string.h;float.h" STDC_HEADERS)
201
202if (NOT HAVE_SYS_TYPES_H)
203 set(pid_t int)
204 set(size_t "unsigned int")
205endif()
206
207if (NOT HAVE_MALLOC)
208 set(malloc rpl_malloc)
209endif()
210
211if (NOT HAVE_REALLOC)
212 set(realloc rpl_realloc)
213endif()
214
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100215# Generate the config.h that includes all the compilation settings.
216configure_file(
217 ${PROJECT_SOURCE_DIR}/config.h.cmake
Joakim Soderberg4c531232013-02-06 15:26:58 +0900218 ${PROJECT_BINARY_DIR}/lws_config.h)
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100219
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100220if (MSVC)
221 # Turn off stupid microsoft security warnings.
222 add_definitions(-D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE)
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800223endif(MSVC)
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100224
Joakim Soderberg4c531232013-02-06 15:26:58 +0900225include_directories(${PROJECT_SOURCE_DIR}/lib)
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100226
Joakim Soderbergadd39262013-02-06 15:25:26 +0900227# Group headers and sources.
228# Some IDEs use this for nicer file structure.
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100229set(HDR_PRIVATE
Joakim Soderbergadd39262013-02-06 15:25:26 +0900230 lib/private-libwebsockets.h
Joakim Soderberg4c531232013-02-06 15:26:58 +0900231 ${PROJECT_BINARY_DIR}/lws_config.h
232 )
Joakim Soderbergadd39262013-02-06 15:25:26 +0900233
234set(HDR_PUBLIC
Edwin van den Oetelaard75076e2013-02-20 02:08:51 +0800235 ${PROJECT_SOURCE_DIR}/lib/libwebsockets.h
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100236 )
237
238set(SOURCES
239 lib/base64-decode.c
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100240 lib/handshake.c
241 lib/libwebsockets.c
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100242 lib/output.c
243 lib/parsers.c
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100244 lib/sha-1.c
245 )
246
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800247if (NOT WITHOUT_CLIENT)
248 list(APPEND SOURCES
249 lib/client.c
250 lib/client-handshake.c
251 lib/client-parser.c
252 )
253endif()
254
255if (NOT WITHOUT_SERVER)
256 list(APPEND SOURCES
257 lib/server.c
258 lib/server-handshake.c
259 )
260endif()
261
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800262if (NOT WITHOUT_EXTENSIONS)
263 list(APPEND HDR_PRIVATE
264 lib/extension-deflate-frame.h
265 lib/extension-deflate-stream.h
266 )
267
268 list(APPEND SOURCES
269 lib/extension.c
270 lib/extension-deflate-frame.c
271 lib/extension-deflate-stream.c
272 )
273endif()
274
Joakim Soderbergadd39262013-02-06 15:25:26 +0900275# Add helper files for Windows.
276if (WIN32)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900277 set(WIN32_HELPERS_PATH win32port/win32helpers)
Joakim Soderbergadd39262013-02-06 15:25:26 +0900278
Andy Greena8334942013-03-09 09:16:41 +0800279 list(APPEND HDR_PUBLIC
Joakim Soderbergadd39262013-02-06 15:25:26 +0900280 ${WIN32_HELPERS_PATH}/websock-w32.h
281 ${WIN32_HELPERS_PATH}/gettimeofday.h
282 )
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800283 if (MINGW)
284 list(APPEND SOURCES
285 ${WIN32_HELPERS_PATH}/gettimeofday.c
286 )
287 else(MINGW)
288 list(APPEND SOURCES
289 ${WIN32_HELPERS_PATH}/websock-w32.c
290 ${WIN32_HELPERS_PATH}/gettimeofday.c
291 )
292 endif(MINGW)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900293 include_directories(${WIN32_HELPERS_PATH})
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800294else(WIN32)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900295 # Unix.
Joakim Soderbergd2edfec2013-02-06 15:27:27 +0900296 if (NOT WITHOUT_DAEMONIZE)
297 list(APPEND SOURCES
298 lib/daemonize.c
299 )
300 endif()
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800301endif(WIN32)
Joakim Soderbergadd39262013-02-06 15:25:26 +0900302
303if (UNIX)
Joakim Soderbergfcec61c2013-02-22 09:28:02 +0800304 if (NOT HAVE_GETIFADDRS)
Joakim Soderbergadd39262013-02-06 15:25:26 +0900305 list(APPEND HDR_PRIVATE lib/getifaddrs.h)
306 list(APPEND SOURCES lib/getifaddrs.c)
307 endif()
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800308endif(UNIX)
Joakim Soderbergadd39262013-02-06 15:25:26 +0900309
Andy Greenda3f6ff2013-03-16 12:32:59 +0800310
Joakim Soderbergc2012e42013-03-23 08:55:02 +0800311if (CMAKE_COMPILER_IS_GNUCC OR CMAKE_COMPILER_IS_GNUCXX)
Erland Isaksson578a24d2013-09-18 09:00:52 +0800312 set( CMAKE_C_FLAGS "-Wall -Werror -O4 -fvisibility=hidden ${CMAKE_C_FLAGS}" )
Joakim Soderbergc2012e42013-03-23 08:55:02 +0800313endif ()
Andy Greenda3f6ff2013-03-16 12:32:59 +0800314
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100315source_group("Headers Private" FILES ${HDR_PRIVATE})
316source_group("Headers Public" FILES ${HDR_PUBLIC})
317source_group("Sources" FILES ${SOURCES})
318
Joakim Soderbergadd39262013-02-06 15:25:26 +0900319#
320# Create the lib.
321#
Joakim Söderberg68e8d732013-02-06 15:27:39 +0900322add_library(websockets STATIC
Joakim Soderbergadd39262013-02-06 15:25:26 +0900323 ${HDR_PRIVATE}
324 ${HDR_PUBLIC}
325 ${SOURCES})
Joakim Soderberg08483532013-02-13 09:29:17 +0800326add_library(websockets_shared SHARED
327 ${HDR_PRIVATE}
328 ${HDR_PUBLIC}
329 ${SOURCES})
330
Joakim Soderberg08483532013-02-13 09:29:17 +0800331if (WIN32)
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800332 # On Windows libs have the same file ending (.lib)
333 # for both static and shared libraries, so we
334 # need a unique name for the static one.
Joakim Soderberg08483532013-02-13 09:29:17 +0800335 set_target_properties(websockets
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800336 PROPERTIES
Joakim Soderberg08483532013-02-13 09:29:17 +0800337 OUTPUT_NAME websockets_static)
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800338
339 # Compile as DLL (export function declarations)
340 set_property(
341 TARGET websockets_shared
342 PROPERTY COMPILE_DEFINITIONS
343 LWS_DLL
344 LWS_INTERNAL
345 )
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800346endif(WIN32)
Joakim Soderberg08483532013-02-13 09:29:17 +0800347
348# We want the shared lib to be named "libwebsockets"
349# not "libwebsocket_shared".
350set_target_properties(websockets_shared
351 PROPERTIES
352 OUTPUT_NAME websockets)
Joakim Soderbergf83585f2013-02-13 09:29:09 +0800353
354# Set the so version of the lib.
Andy Green19c1a992013-03-10 06:59:01 +0800355# Equivalent to LDFLAGS=-version-info x:x:x
Joakim Soderbergf83585f2013-02-13 09:29:09 +0800356if(CMAKE_COMPILER_IS_GNUCC OR CMAKE_COMPILER_IS_GNUCXX)
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800357 foreach(lib websockets websockets_shared)
358 set_target_properties(${lib}
359 PROPERTIES
360 SOVERSION ${SOVERSION})
361 endforeach()
Joakim Soderbergf83585f2013-02-13 09:29:09 +0800362endif()
Joakim Soderbergadd39262013-02-06 15:25:26 +0900363
Joakim Soderberg08483532013-02-13 09:29:17 +0800364set(LIB_LIST)
365
Joakim Soderbergadd39262013-02-06 15:25:26 +0900366#
367# Find libraries.
368#
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100369
370#
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800371# ZLIB (Only needed for deflate extensions).
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100372#
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800373if (NOT WITHOUT_EXTENSIONS)
374 if (WIN32 AND NOT USE_EXTERNAL_ZLIB)
375 message("Using included Zlib version")
Joakim Soderberg4c531232013-02-06 15:26:58 +0900376
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800377 # Compile ZLib if needed.
378 set(WIN32_ZLIB_PATH "win32port/zlib")
379 set(ZLIB_SRCS
380 ${WIN32_ZLIB_PATH}/adler32.c
381 ${WIN32_ZLIB_PATH}/compress.c
382 ${WIN32_ZLIB_PATH}/crc32.c
383 ${WIN32_ZLIB_PATH}/deflate.c
384 ${WIN32_ZLIB_PATH}/gzclose.c
385 ${WIN32_ZLIB_PATH}/gzio.c
386 ${WIN32_ZLIB_PATH}/gzlib.c
387 ${WIN32_ZLIB_PATH}/gzread.c
388 ${WIN32_ZLIB_PATH}/gzwrite.c
389 ${WIN32_ZLIB_PATH}/infback.c
390 ${WIN32_ZLIB_PATH}/inffast.c
391 ${WIN32_ZLIB_PATH}/inflate.c
392 ${WIN32_ZLIB_PATH}/inftrees.c
393 ${WIN32_ZLIB_PATH}/trees.c
394 ${WIN32_ZLIB_PATH}/uncompr.c
395 ${WIN32_ZLIB_PATH}/zutil.c
396 )
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100397
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800398 # Create the library.
399 add_library(ZLIB STATIC ${ZLIB_SRCS})
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100400
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800401 # Set the same variables as find_package would.
402 set(ZLIB_INCLUDE_DIRS ${WIN32_ZLIB_PATH})
403 get_property(ZLIB_LIBRARIES TARGET ZLIB PROPERTY LOCATION)
404 set(ZLIB_FOUND 1)
405 else()
406 find_package(ZLIB REQUIRED)
407 endif()
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100408
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800409 # Make sure ZLib is compiled before the libs.
410 foreach (lib websockets websockets_shared)
411 add_dependencies(${lib} ZLIB)
412 endforeach()
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800413
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800414 message("ZLib include dirs: ${ZLIB_INCLUDE_DIRS}")
415 message("ZLib libraries: ${ZLIB_LIBRARIES}")
416 include_directories(${ZLIB_INCLUDE_DIRS})
417 list(APPEND LIB_LIST ${ZLIB_LIBRARIES})
418endif(NOT WITHOUT_EXTENSIONS)
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100419
420#
421# OpenSSL
422#
423if (WITH_SSL)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900424 message("Compiling with SSL support")
425
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100426 if (USE_CYASSL)
427 # Use CyaSSL as OpenSSL replacement.
Joakim Söderbergcb4156d2013-02-06 15:30:56 +0900428 # TODO: Add a find_package command for this also.
429 message("CyaSSL include dir: ${CYASSL_INCLUDE_DIRS}")
430 message("CyaSSL libraries: ${CYASSL_LIB}")
431
Joakim Soderberg7df99082013-02-07 20:24:19 +0800432 # Additional to the root directory we need to include
433 # the cyassl/ subdirectory which contains the OpenSSL
434 # compatability layer headers.
435 foreach(inc ${CYASSL_INCLUDE_DIRS})
436 include_directories(${inc} ${inc}/cyassl)
437 endforeach()
438
Joakim Soderberg9c037c02013-03-23 08:55:28 +0800439 list(APPEND LIB_LIST ${CYASSL_LIB})
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100440 else()
441 # TODO: Add support for STATIC also.
442 find_package(OpenSSL REQUIRED)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900443
Joakim Söderbergcb4156d2013-02-06 15:30:56 +0900444 message("OpenSSL include dir: ${OPENSSL_INCLUDE_DIR}")
445 message("OpenSSL libraries: ${OPENSSL_LIBRARIES}")
Joakim Soderbergadd39262013-02-06 15:25:26 +0900446
Joakim Söderbergcb4156d2013-02-06 15:30:56 +0900447 include_directories(${OPENSSL_INCLUDE_DIR})
Joakim Soderberg08483532013-02-13 09:29:17 +0800448 list(APPEND LIB_LIST ${OPENSSL_LIBRARIES})
Joakim Söderbergcb4156d2013-02-06 15:30:56 +0900449 endif()
Joakim Soderberg4c531232013-02-06 15:26:58 +0900450endif(WITH_SSL)
451
452#
453# Platform specific libs.
454#
455if (WIN32)
Joakim Soderberg08483532013-02-13 09:29:17 +0800456 list(APPEND LIB_LIST ws2_32.lib)
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100457endif()
458
Joakim Soderberg4c531232013-02-06 15:26:58 +0900459if (UNIX)
Joakim Soderberg08483532013-02-13 09:29:17 +0800460 list(APPEND LIB_LIST m)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900461endif()
Joakim Soderberg08e434e2013-02-01 14:52:53 +0100462
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800463# Setup the linking for all libs.
464foreach (lib websockets websockets_shared)
465 target_link_libraries(${lib} ${LIB_LIST})
466endforeach()
Joakim Soderberg08483532013-02-13 09:29:17 +0800467
Joakim Soderberg4c531232013-02-06 15:26:58 +0900468#
469# Test applications
470#
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800471set(TEST_APP_LIST)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900472if (NOT WITHOUT_TESTAPPS)
473 #
474 # Helper function for adding a test app.
475 #
Joakim Soderberg11a8cda2013-02-22 09:28:06 +0800476 macro(create_test_app TEST_NAME MAIN_SRC WIN32_SRCS WIN32_HDRS)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900477
Joakim Soderberg4c531232013-02-06 15:26:58 +0900478 set(TEST_SRCS ${MAIN_SRC})
479 set(TEST_HDR)
480
481 if (WIN32)
482 list(APPEND TEST_SRCS
483 ${WIN32_HELPERS_PATH}/getopt.c
484 ${WIN32_HELPERS_PATH}/getopt_long.c
485 ${WIN32_HELPERS_PATH}/gettimeofday.c
486 ${WIN32_SRCS})
487
488 list(APPEND TEST_HDR
489 ${WIN32_HELPERS_PATH}/getopt.h
490 ${WIN32_HELPERS_PATH}/gettimeofday.h
491 ${WIN32_HDRS})
492 endif(WIN32)
493
Joakim Soderberg08483532013-02-13 09:29:17 +0800494 source_group("Headers Private" FILES ${TEST_HDR})
Joakim Soderberg4c531232013-02-06 15:26:58 +0900495 source_group("Sources" FILES ${TEST_SRCS})
496 add_executable(${TEST_NAME} ${TEST_SRCS} ${TEST_HDR})
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800497
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800498 if (LINK_TESTAPPS_DYNAMIC)
499 target_link_libraries(${TEST_NAME} websockets_shared)
500 add_dependencies(${TEST_NAME} websockets_shared)
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800501 else(LINK_TESTAPPS_DYNAMIC)
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800502 target_link_libraries(${TEST_NAME} websockets)
503 add_dependencies(${TEST_NAME} websockets)
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800504 endif(LINK_TESTAPPS_DYNAMIC)
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800505
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800506 # Set test app specific defines.
507 set_property(TARGET ${TEST_NAME}
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800508 PROPERTY COMPILE_DEFINITIONS
Andy Green63b3b952013-03-09 12:51:43 +0800509 INSTALL_DATADIR="${CMAKE_INSTALL_PREFIX}/share"
Joakim Soderbergd2edfec2013-02-06 15:27:27 +0900510 )
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800511
512 # Prefix the binary names with libwebsockets.
513 set_target_properties(${TEST_NAME}
514 PROPERTIES
515 OUTPUT_NAME libwebsockets-${TEST_NAME})
516
517 # Add to the list of tests.
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800518 list(APPEND TEST_APP_LIST ${TEST_NAME})
Joakim Soderberg11a8cda2013-02-22 09:28:06 +0800519 endmacro()
Joakim Soderberg4c531232013-02-06 15:26:58 +0900520
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800521 if (WITH_SSL AND NOT USE_CYASSL)
522 message("Searching for OpenSSL executable and dlls")
523 find_package(OpenSSLbins)
524 message("OpenSSL executable: ${OPENSSL_EXECUTABLE}")
525 endif()
526
Joakim Soderberg4c531232013-02-06 15:26:58 +0900527 if (NOT WITHOUT_SERVER)
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800528 #
529 # test-server
530 #
531 if (NOT WITHOUT_TEST_SERVER)
532 create_test_app(test-server
533 "test-server/test-server.c"
534 ""
535 "${WIN32_HELPERS_PATH}/netdb.h;${WIN32_HELPERS_PATH}/strings.h;${WIN32_HELPERS_PATH}/unistd.h;${WIN32_HELPERS_PATH}/websock-w32.h")
536 endif()
Joakim Soderberg4c531232013-02-06 15:26:58 +0900537
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800538 #
539 # test-server-extpoll
540 #
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800541 if (NOT WITHOUT_TEST_SERVER_EXTPOLL)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800542 create_test_app(test-server-extpoll
543 "test-server/test-server.c"
544 "win32port/win32helpers/websock-w32.c"
545 "${WIN32_HELPERS_PATH}/netdb.h;${WIN32_HELPERS_PATH}/strings.h;${WIN32_HELPERS_PATH}/unistd.h;${WIN32_HELPERS_PATH}/websock-w32.h")
546 # Set defines for this executable only.
547 set_property(
548 TARGET test-server-extpoll
549 PROPERTY COMPILE_DEFINITIONS
550 EXTERNAL_POLL
Andy Green63b3b952013-03-09 12:51:43 +0800551 INSTALL_DATADIR="${CMAKE_INSTALL_PREFIX}/share"
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800552 )
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800553
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800554 # We need to link against winsock code.
555 if (WIN32)
556 target_link_libraries(test-server-extpoll ws2_32.lib)
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800557 endif(WIN32)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800558 endif()
559
560 # Data files for running the test server.
561 set(TEST_SERVER_DATA
Joakim Soderbergc7ed2be2013-02-22 09:28:17 +0800562 ${PROJECT_SOURCE_DIR}/test-server/favicon.ico
563 ${PROJECT_SOURCE_DIR}/test-server/leaf.jpg
564 ${PROJECT_SOURCE_DIR}/test-server/libwebsockets.org-logo.png
565 ${PROJECT_SOURCE_DIR}/test-server/test.html)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800566
567 # Generate self-signed SSL certs for the test-server.
568 if (WITH_SSL AND OPENSSL_EXECUTABLE)
Joakim Soderberg20aedc82013-02-22 09:28:11 +0800569 message("Generating SSL Certificates for the test-server...")
570
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800571 set(TEST_SERVER_SSL_KEY ${PROJECT_BINARY_DIR}/libwebsockets-test-server.key.pem)
572 set(TEST_SERVER_SSL_CERT ${PROJECT_BINARY_DIR}/libwebsockets-test-server.pem)
573
574 if (WIN32)
575 file(WRITE ${PROJECT_BINARY_DIR}/openssl_input.txt
576 "GB\n"
577 "Erewhon\n"
578 "All around\n"
579 "libwebsockets-test\n"
580 "localhost\n"
Joakim Soderberg20aedc82013-02-22 09:28:11 +0800581 "none@invalid.org\n\n"
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800582 )
Joakim Soderberg20aedc82013-02-22 09:28:11 +0800583
584 # The "type" command is a bit picky with paths.
585 file(TO_NATIVE_PATH "${PROJECT_BINARY_DIR}/openssl_input.txt" OPENSSL_INPUT_WIN_PATH)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800586
587 execute_process(
Joakim Soderberg20aedc82013-02-22 09:28:11 +0800588 COMMAND cmd /c type "${OPENSSL_INPUT_WIN_PATH}"
589 COMMAND "${OPENSSL_EXECUTABLE}" req -new -newkey rsa:1024 -days 10000 -nodes -x509 -keyout "${TEST_SERVER_SSL_KEY}" -out "${TEST_SERVER_SSL_CERT}"
590 RESULT_VARIABLE OPENSSL_RETURN_CODE)
591
Joakim Soderbergc7ed2be2013-02-22 09:28:17 +0800592 message("\n")
593
Joakim Soderberg20aedc82013-02-22 09:28:11 +0800594 if (OPENSSL_RETURN_CODE)
595 message("!!! Failed to generate SSL certificate:\n${OPENSSL_RETURN_CODE} !!!")
596 endif()
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800597 else()
598 execute_process(
599 COMMAND printf "GB\\nErewhon\\nAll around\\nlibwebsockets-test\\n\\nlocalhost\\nnone@invalid.org\\n"
600 COMMAND ${OPENSSL_EXECUTABLE}
601 req -new -newkey rsa:1024 -days 10000 -nodes -x509 -keyout ${TEST_SERVER_SSL_KEY} -out ${TEST_SERVER_SSL_CERT}
602 )
603 endif()
604
605 list(APPEND TEST_SERVER_DATA
606 ${TEST_SERVER_SSL_KEY}
607 ${TEST_SERVER_SSL_CERT})
Joakim Soderbergf272cb02013-02-13 09:29:26 +0800608 endif()
Joakim Soderbergc7ed2be2013-02-22 09:28:17 +0800609
610 # Copy the file needed to run the server so that the test apps can
611 # reach them from their default output location
612 foreach (TEST_FILE ${TEST_SERVER_DATA})
613 add_custom_command(TARGET test-server
614 POST_BUILD
615 COMMAND ${CMAKE_COMMAND} -E make_directory "$<TARGET_FILE_DIR:test-server>/../share/libwebsockets-test-server"
616 COMMAND ${CMAKE_COMMAND} -E copy ${TEST_FILE} "$<TARGET_FILE_DIR:test-server>/../share/libwebsockets-test-server" VERBATIM)
617 endforeach()
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800618 endif(NOT WITHOUT_SERVER)
Joakim Söderberg68e8d732013-02-06 15:27:39 +0900619
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800620 if (NOT WITHOUT_CLIENT)
621 #
622 # test-client
623 #
624 if (NOT WITHOUT_TEST_CLIENT)
625 create_test_app(test-client
626 "test-server/test-client.c"
627 ""
628 "")
629 endif()
Joakim Soderberg4c531232013-02-06 15:26:58 +0900630
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800631 #
632 # test-fraggle
633 #
634 if (NOT WITHOUT_TEST_FRAGGLE)
635 create_test_app(test-fraggle
636 "test-server/test-fraggle.c"
637 ""
638 "${WIN32_HELPERS_PATH}/unistd.h;${WIN32_HELPERS_PATH}/sys/time.h")
639 endif()
640
641 #
642 # test-ping
643 #
644 if (NOT WITHOUT_TEST_PING)
645 create_test_app(test-ping
646 "test-server/test-ping.c"
647 ""
648 "${WIN32_HELPERS_PATH}/unistd.h;${WIN32_HELPERS_PATH}/sys/time.h")
649 endif()
Andy Green27696f22013-03-10 08:09:25 +0800650 #
651 # test-echo
652 #
653 if (NOT WITHOUT_TEST_ECHO)
654 create_test_app(test-echo
655 "test-server/test-echo.c"
656 ""
657 "${WIN32_HELPERS_PATH}/unistd.h;${WIN32_HELPERS_PATH}/sys/time.h")
658 endif()
659
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800660 endif(NOT WITHOUT_CLIENT)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900661
662 #
663 # Copy OpenSSL dlls to the output directory on Windows.
664 # (Otherwise we'll get an error when trying to run)
665 #
666 if (WIN32 AND WITH_SSL AND NOT USE_CYASSL)
Joakim Soderberg4c531232013-02-06 15:26:58 +0900667 if(OPENSSL_BIN_FOUND)
Joakim Soderberg20aedc82013-02-22 09:28:11 +0800668 message("OpenSSL dlls found:")
669 message(" Libeay: ${LIBEAY_BIN}")
670 message(" SSLeay: ${SSLEAY_BIN}")
Joakim Soderberg4c531232013-02-06 15:26:58 +0900671
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800672 foreach(TARGET_BIN ${TEST_APP_LIST})
Joakim Soderberg4c531232013-02-06 15:26:58 +0900673 add_custom_command(TARGET ${TARGET_BIN}
674 POST_BUILD
675 COMMAND ${CMAKE_COMMAND} -E copy ${LIBEAY_BIN} $<TARGET_FILE_DIR:${TARGET_BIN}> VERBATIM)
676
677 add_custom_command(TARGET ${TARGET_BIN}
678 POST_BUILD
679 COMMAND ${CMAKE_COMMAND} -E copy ${SSLEAY_BIN} $<TARGET_FILE_DIR:${TARGET_BIN}> VERBATIM)
680 endforeach()
681 endif()
682 endif()
683endif(NOT WITHOUT_TESTAPPS)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800684
685if (UNIX)
686 # Generate documentation.
687 # TODO: Fix this on Windows.
688 message("Generating API documentation")
689 file(GLOB C_FILES ${PROJECT_SOURCE_DIR}/lib/*.c)
Joakim Söderberg455e4512013-02-19 10:14:54 +0800690 execute_process(COMMAND ${CMAKE_COMMAND} -E make_directory ${PROJECT_BINARY_DIR}/doc/)
691
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800692 execute_process(
693 COMMAND ${PROJECT_SOURCE_DIR}/scripts/kernel-doc -html ${C_FILES} ${HDR_PUBLIC}
694 OUTPUT_FILE ${PROJECT_BINARY_DIR}/doc/libwebsockets-api-doc.html
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800695 ERROR_QUIET)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800696
697 execute_process(
698 COMMAND ${PROJECT_SOURCE_DIR}/scripts/kernel-doc -text ${C_FILES} ${HDR_PUBLIC}
699 OUTPUT_FILE ${PROJECT_BINARY_DIR}/doc/libwebsockets-api-doc.txt
Joakim Soderberg7eadd582013-02-22 09:28:04 +0800700 ERROR_QUIET)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800701
702# Generate and install pkgconfig.
703# (This is not indented, because the tabs will be part of the output)
704file(WRITE ${PROJECT_BINARY_DIR}/libwebsockets.pc
thinkskidd93a0c2013-04-12 10:31:46 +0800705"prefix="${CMAKE_INSTALL_PREFIX}"
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800706exec_prefix=\${prefix}
Andy Green975423c2013-02-26 11:58:45 +0800707libdir=\${exec_prefix}/lib${LIB_SUFFIX}
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800708includedir=\${prefix}/include
709
710Name: libwebsockets
711Description: Websockets server and client library
712Version: ${PACKAGE_VERSION}
713
714Libs: -L\${libdir} -lwebsockets
715Cflags: -I\${includedir}"
716)
717
718 install(FILES ${PROJECT_BINARY_DIR}/libwebsockets.pc
Andy Greenc8c16622013-03-10 08:10:19 +0800719 DESTINATION lib${LIB_SUFFIX}/pkgconfig)
Edwin van den Oetelaar15a38a72013-03-10 06:53:57 +0800720endif(UNIX)
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800721
722# Install headers.
723install(FILES ${HDR_PUBLIC}
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800724 DESTINATION include
725 COMPONENT headers)
726set(CPACK_COMPONENT_HEADERS_DISPLAY_NAME "Header files")
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800727
728# Install libs.
729install(TARGETS websockets websockets_shared
Andy Green975423c2013-02-26 11:58:45 +0800730 LIBRARY DESTINATION lib${LIB_SUFFIX}
731 ARCHIVE DESTINATION lib${LIB_SUFFIX}
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800732 COMPONENT libraries)
733set(CPACK_COMPONENT_LIBRARIES_DISPLAY_NAME "Libraries")
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800734
735# Install test apps.
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800736if (NOT WITHOUT_TESTAPPS)
737 install(TARGETS test-client ${TEST_APP_LIST}
738 RUNTIME DESTINATION bin
739 COMPONENT examples)
740 set(CPACK_COMPONENT_EXAMPLES_DISPLAY_NAME "Example Install")
Joakim Söderberg6ac97092013-02-19 10:14:37 +0800741endif()
742
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800743# Programs shared files used by the test-server.
744if (NOT WITHOUT_TESTAPPS AND NOT WITHOUT_SERVER)
745 install(FILES ${TEST_SERVER_DATA}
746 DESTINATION share/libwebsockets-test-server
747 COMPONENT examples)
748endif()
749
Andy Green2aab3f92013-03-10 08:11:48 +0800750# build subdir is not part of sources
751set(CPACK_SOURCE_IGNORE_FILES $(CPACK_SOURCE_IGNORE_FILES) ".git" "build" "tgz" "tar.gz")
752
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800753# Most people are more used to "make dist" compared to "make package_source"
754add_custom_target(dist COMMAND ${CMAKE_MAKE_PROGRAM} package_source)
755
Tomas Cejkaefda1772013-04-11 08:13:13 +0800756INCLUDE(UseRPMTools)
757IF(RPMTools_FOUND)
758 RPMTools_ADD_RPM_TARGETS(libwebsockets libwebsockets.spec)
759ENDIF(RPMTools_FOUND)
760
Joakim Soderbergb37827b2013-02-22 09:28:08 +0800761# This must always be last!
762include(CPack)